feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0)

This commit is contained in:
QQ 2026-11-10 21:51:06 +08:00
parent 48478d9e55
commit bd75d8186e
1 changed files with 42 additions and 0 deletions

42
docs/记忆设计.md Normal file
View File

@ -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/<projectId>.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 只有确定性记账,不引入额外模型调用。
- 按部门的私有记忆(六部各自的经验本)——先验证两层够不够用再说。