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