01
对话记忆很难被队友检查、纠正或治理为共享知识。
Doco 使用场景
人能检查和修复的 Agent memory
当记忆必须保持人类可读、能引用稳定块、有版本，并可由人与 Agent 安全共同维护时，用 Doco 保存持久 Agent memory。不要用文档工作区替代模型状态或临时草稿上下文。
真实失败模式
没有证据的记忆会变成传闻
答案听起来像是记得，但来源可能已改变、消失，甚至从未存在。持久记忆需要所有者、地址与新鲜度边界。
02
向量命中可能像答案，却无法证明当前哪个段落支持它。
03
Agent 重写整个 memory 文件时，可能静默覆盖更新的人类修正。
操作循环
通过持续维护的文档记忆
- 01
浏览知识树，找到真正拥有该事实的文档；默认不要创建重复 memory。
- 02
搜索并围绕命中的稳定块读取，同时保留文档版本和引用。
- 03
基于证据回答；若 coverage 不完整或派生层 stale，明确披露，而不是用记忆补空白。
- 04
收到维护请求时，在记录版本下修改最小块，写后重读，并报告变化。
Doco 保存持续维护的外部知识。会话状态、隐藏思维链、临时计划与秘密应放在其他系统。
能力地图
系统必须提供什么
| 维度 | 真实需求 | Doco 如何处理 |
|---|---|---|
| 权威事实源 | 人与 Agent 共用的一份维护对象 | 协作文档是权威；摘要和概念仍是派生层 |
| 检索 | 只找相关段落，而不是加载全部 | 树、目录、结构化全文搜索与 token-budget 读取 |
| 证据 | 稳定来源地址与新鲜度信号 | 文档 URI、稳定块 ID、源/索引版本、完整性 |
| 写入 | 窄范围、可审查的维护操作 | 块 patch、插入、批次、评论、关系与摘要工具 |
| 并发 | 拒绝陈旧编辑，而不是 last-write-wins | If-Match/base_version、409 重读、串行写入和快照 |
| 可迁移性 | 导出与自托管，避免记忆被锁定 | Markdown/ZIP/原生导出与 MIT 自托管 |
适合
政策、决策、runbook、项目背景、研究笔记，以及人必须审查而 Agent 会使用和维护的知识。
不适合
隐藏模型记忆、高频事件日志、原始遥测、临时推理、凭据，或权威源本来就在代码/事务数据库中的事实。