跳到主要内容

Graphiti-ready Context Contract

状态：Draft / 预备接入契约 最后更新：2026-05-11 用途：为后续动态知识图谱层准备稳定输入，不在当前仓库中运行 Graphiti 服务

1. 当前边界​

当前仓库不部署 Graphiti，不要求本地模型，不要求图数据库，也不要求团队成员运行后台服务。

本目录只定义未来可以被 Graphiti 或类似时间化知识图谱系统消费的事件契约。正式事实源仍是仓库 Markdown。

2. 输入事件来源​

允许进入动态上下文图谱的事件应来自稳定文档或协同对象：

  • baseline/、registry/、projects/ 中的正式定义变更；
  • packets/ 中的 sync / escalation / task 状态变化；
  • source/ 与 references/ 中材料被吸收、搁置、升级或标记为反例；
  • Program Controller 的低上下文 handoff；
  • 评测 case library、run、report 的稳定结论。

不进入：

  • 临时聊天记录；
  • 未审阅的中间稿；
  • 本地 Agent 运行缓存；
  • 自动图谱缓存；
  • open-cowork 内部执行过程日志。

3. 文件​

  • event-schema.json：Graphiti-ready 事件结构；
  • seed-events.jsonl：当前仓库可用的种子事件示例。

这些文件是接口契约和示例，不是运行时数据源。