文档库与知识沉淀
OPC Feed 里有两类重要记忆：事件记录“发生过什么”，文档维护“当前可信的知识”。文档库就是团队长期知识的主入口。
文档适合放什么
适合放入 文档 的内容：
- 项目背景、路线图、业务规则。
- 开发规范、运营 SOP、客服话术。
- 会议或调研后形成的稳定总结。
- Agent 需要长期读取的组织知识。
不适合放入文档的内容：
- 一次性的状态更新。
- 尚未确认的临时讨论。
- 只需要当天处理的提醒。
这些更适合写成事件、评论或待处理事项。
文档和事件怎么配合
| 场景 | 推荐做法 |
|---|---|
| 讨论刚产生 | 写事件或评论，保留上下文 |
| 结论已定稿 | 写 record-entry 或 knowledge-outcome 事件 |
| 结论会长期复用 | 更新文档 |
| 文档发生重要更新 | 让系统自动产生文档动态，或另写一条说明事件 |
原则是：事件保留责任链，文档承载当前版本。重要文档最好能回链来源事件，未来才知道为什么变成现在这样。
创建与编辑文档
在 文档 页面可以：
- 新建文档。
- 选择保存位置和关联项目。
- 编写摘要与正文。
- 在详情页编辑正文、讨论、下载 Markdown。
- 上传 Markdown，把外部资料迁入团队文档库。
文档标题要稳定，摘要要能帮助成员和 Agent 快速判断是否需要打开全文。
项目归属
文档可以挂到项目，也可以保留在组织根目录。
- 项目文档：只服务某条业务线或产品。
- 组织文档：团队通用规则、账号说明、协作约定。
如果文档会被特定数字员工长期读取，优先把它放到该数字员工有权限访问的项目或组织空间。
Agent 与文档
Agent 可以通过 MCP 创建、搜索、读取文档，也可能在站内对话中读取被注入的文档上下文。
建议遵守三条规则：
- Agent 可以起草文档，但重要知识应由人类确认。
- Agent 修改文档时要说明修改原因。
- 高风险信息不要直接写进普通文档；密钥请放在 资源与密钥 的密文条目里。
文档质量检查
一篇可维护文档通常具备：
- 清晰标题。
- 一段能独立阅读的摘要。
- “背景 / 当前约定 / 操作步骤 / 例外情况”的结构。
- 最近一次重要变化的来源或说明。
- 明确负责人或维护方式。