diff --git a/docs/记忆设计.md b/docs/记忆设计.md new file mode 100644 index 0000000..5bc8a29 --- /dev/null +++ b/docs/记忆设计.md @@ -0,0 +1,42 @@ +# 三省六部记忆设计(v1,0.10.0) + +思路借鉴 DS Bot 的分层记忆(Bot 记忆 + 群记忆),但落在原生架构上、 +按本项目一贯的隔离与记账规矩实现。不基于 DS Bot 构建(见 TODO.md 的否决记录)。 + +## 两层 + +| 层 | 文件 | 记什么 | 谁能读 | +|---|---|---|---| +| 长期记忆 | `~/.dsh/sansheng-liubu/memory/long-term.md` | 用户偏好、长期有效的经验 | 所有项目的派发 | +| 项目记忆 | `~/.dsh/sansheng-liubu/memory/projects/.md` | 这个项目发生过什么、结论是什么 | 仅本项目的派发 | + +项目之间互不可见。DS Bot 上游「Main Bot 可读写任意 Bot 记忆」的弱隔离 +(归档分支 docs/p0 的 M-03 边界记录)不学。 + +## 怎么读(召回) + +派发(dispatchTask)时,服务层把两层记忆的摘录并进上下文包的 excerpts: +项目记忆在前(上限 3000 字)、长期记忆在后(上限 2000 字),超长截断并注明。 +摘录随上下文包落账,事后可查「当时到底把哪段记忆发给了部门」。 +记忆读失败不拦派发——记忆是参考资料,不是业务前置条件。 + +## 怎么写 + +1. **成果自动记账**:新成果汇报落账后,服务层往项目记忆追加一行 + 「<部门> 汇报成果(任务「<标题>」):<摘要>」,带日期小节。 + 重复汇报(幂等命中)不重复记;写失败不影响成果本身。 +2. **接口读写**:POST `/sansheng/workbench/memory/get|put|append` + (scope = long-term | project;project 需带 projectId 且项目必须存在)。 +3. **手工编辑**:文件就是 Markdown,用户可直接打开改;程序写走 + 临时文件 + rename,不写半截。 + +## 上限与整理 + +单个记忆文件上限 64K 字符:写满会明确报错,要求先整理再写—— +记忆要短而精,不是聊天记录的倾倒场。聊天正文仍由 DSH 会话保存,账本与记忆都不复制。 + +## 本版没做(后续) + +- 工作台面板里的记忆查看/编辑界面(先用接口与文件)。 +- 由模型自动提炼记忆(把流水账总结成条目)——v1 只有确定性记账,不引入额外模型调用。 +- 按部门的私有记忆(六部各自的经验本)——先验证两层够不够用再说。