珊瑚上下文底座 necigit/Coral-Context

Coral Context

一句话：给智能体用的任务 / 证据 / 上下文底座——先定向，再执行；结论必须有证据，上下文有预算、可审计。

适合：需要跨会话接续、角色隔离、证据链和上下文预算的智能体工程。

不适合：只想给聊天加「长期记忆 / 向量检索」插件的场景；那不是本项目。也不会把聊天记录或 Worker 的完成声明自动写成 Truth。

Coral-Memory 的新一代任务、证据与上下文底座。旧版 Coral-Memory 已过时；本项目采用独立架构，不自动迁入私人记忆，不承诺与旧插件直接兼容。

| 层 | 目录 | 职责 |
| 底座 | coral-core/ | 事件、Context v2、Gate/RGB、角色、证据、Active Truth |
| 宿主绑定 | coral-context-bundle/ | 把 Coral MCP 和 context policy 接入 profile / scoped preset |
| 可选适配 | extras/coral-balance/ | Windows 桌面 API 余额入口，与核心分离 |

Python 3.11+，核心仅依赖标准库和带 FTS5 的 SQLite。Windows 宿主适配基于 dsh 0.2.1-rc.2。作者：Mr. Code Muggle (@Ne)，MIT。

快速开始

python -m unittest discover -s coral-core/tests -v
python coral-core/examples/p0_demo.py
python coral-context-bundle/install.py --dsh-dir "<DSH安装目录>" --profile coral-context

桌面用户安装独立的 Coral Context 预设，可选余额入口：

python coral-context-bundle/install.py --dsh-dir "<DSH安装目录>" --profile desktop --desktop-preset --balance

重启宿主后选择 Coral Context。新预设沿用宿主 Standard 的工具和内置压缩，只增加固定 AGENT MCP 与上下文策略。已有默认预设不变。余额凭据由本机宿主读取；不得把凭据文件加入仓库。参见 安装与回退。

当前能力与边界

- Gate 路由 SINGLE / RGB / MULTI_PROPOSAL / EXPERIMENT / HUMAN；规划、执行和独立验证使用固定身份。
- Worker report 不等于 PASS。证据、验收项和独立 Verifier 通过后才能晋级。
- 原始事件、blob、状态历史 append-only；Project State 与 Active Truth 负责当前状态。
- Context v2 先给 brief，默认 12K 预算；只把 fixed_prefix + context 作为模型材料，selection/trace 留作审计。
- 工程记忆包 coral-package/v1：按工程生成 trunk / areas / identities，package.json 保存每个文件的 sha256 和事件指针；默认只读主干，细节按需回查。
- SQLite FTS5 提供统一搜索 ABI。OBSERVER 可按事件游标监督与引用来源，无权改 Truth 或裁决。

当前交付 P0 底座与宿主绑定，不是完整自主多角色产品。真实 RGB 模型闭环、Session 压缩增量接管、精确 provider token meter、Memory Compiler 与 Skill 晋级仍需后续实现。内置 compaction 尚未被替换。余额后端与模块注册已实测，真实账户余额后端已验证，前端视觉仍需重启用户宿主验收。

与已有工作的关系

红蓝对攻、裁判和评审不是本项目的首创。多智能体辩论（Du et al.）、Constitutional AI 的自我批评（Bai et al.）、自动化红队（Perez et al.）、辩论加裁判（Irving et al.）、LLM-as-a-Judge（Zheng et al.）以及 AutoGen、MetaGPT、ChatDev 等角色框架，都已经覆盖了这些模式。本项目不主张新的辩论算法；区别在工程约束：

- 角色权限由 MCP 工具目录强制，不靠提示词；
- Green 必须逐条处理 Red 攻击，否则 decide 拒绝；
- PASS 必须有逐验收项证据和独立 Verifier，Worker 的 report 不会自动变成 Truth；
- Gate 按显式风险事实路由，不依赖模型自评；
- 结果是 append-only 事件账本和预算内的 coral-context/v2，可跨会话回放与审计。

先读 架构、API、模式取舍 和 DS 接手。验证记录 仅包含脱敏后的测试结论。