dsh-daoing-memory
> 面向 DeepSeek Harness（DSH）的自进化记忆系统 —— 挣得式经验、日记/事实语义记忆、关心事项追踪，以及只增不删的审计账本。
没有记忆的 agent，每个会话都从零开始。dsh-daoing-memory 为 DSH agent 提供一套持久、能自我进化的记忆，而且这份记忆是靠*使用*一点点“挣”来的：它记日记、从中提炼关于用户的持久事实与未了心事、沉淀经过验证的经验、在需要时召回相关内容、发现错了就修订，并把每一次变更都记进可审计的账本。
整套设计围绕四个字 —— 生 · 用 · 修 · 记。
---
为什么做
市面上大多数“记忆”方案，要么把原始对话一股脑灌进向量库，要么让模型随意往一个键值块里写东西。两者在实践中都会失败：前者让信号淹没在噪声里，后者让一次幻觉污染此后所有会话。
dsh-daoing-memory 采取了不同的立场：
- 记忆必须靠挣。 一条经验以低信任的*候选*身份诞生，只有在真实使用中被反复证实后才晋升。没有任何东西能靠“钦定”直接获得高信任。
- 两种截然不同的记忆。 *语义记忆*（关于用户的持久事实 + 他们在意的未了心事）与*经验记忆*（带生命周期的 how-to 知识）分离，二者的写入、召回与治理方式各不相同。
- 每次写入都可审计。 只增不删的账本记录每一次变更，记忆漂移或被投毒时可被察觉、可被归因、可被回滚。
- 人始终在回路中。 浏览器工作台让你阅读、纠正、晋升、删除记忆——记忆是人机共享的资产，而非黑盒。
功能一览
| 模块 | 提供能力 |
|---|---|
| 日记（记） | memory_fact —— 追加原始会话笔记，是一切提炼的原料。 |
| 提炼（生） | memory_extract —— 把日记蒸馏成持久事实（9 类以用户为中心的类别，自动去重并累积佐证）与关心事项（todo / 思考 / 想法 / 问题 / 决定 / 承诺，均带背景场景）。 |
| 经验生命周期（生·用·修） | memory_ingest、memory_report、memory_revise、memory_refine、memory_verify —— 经验以候选身份诞生，靠上报使用挣得信任，错了就修订，并能干净回滚。 |
| 召回（用） | memory_recall —— 在共享经验库上做关键词/情境相关性匹配，支持可选的 context 范围限定。 |
| 审计 | memory_ledger、memory_verify —— 查询只增不删的账本并校验完整性。 |
| 整合 | memory_consolidate —— 周期性的压实与库内清理。 |
| 画像注入 | 把一份精简画像快照（头部事实 + 未了心事）注入系统提示词，让 agent *无需发问就了解用户*。 |
| 工作台 UI | 浏览器面板（事实日记 / 经验 / 账本 / 人工运维），可手动检视与治理记忆。 |
| 提炼 skill | 随包附带 memory-extraction skill，教会 agent *何时、如何*提炼出高质量记忆。 |
安装
支持两种 DSH 环境 —— 源码启动的 DSH 与官方命令安装的 DSH；也支持两种安装渠道（npm 包名，或 git/GitHub 地址）。完整的安装/卸载/skill 放置矩阵见 [docs/INSTALL.zh-CN.md](./docs/INSTALL.zh-CN.md)。
官方安装版 DSH 的快速上手：
# 从 npm（发布后）
dsh plugin --profile web add dsh-daoing-memory
# 或直接从 GitHub
dsh plugin --profile web add github:daoing/dsh-daoing-memory
# 把提炼 skill 放到 DSH 加载 skill 的目录
node node_modules/dsh-daoing-memory/scripts/install-skill.mjs然后重启 DSH。记忆工具即对 agent 可用，画像快照开始注入，网页左侧边栏底部（设置入口旁）出现记忆监控按钮，点击即打开 Memory 工作台。
使用
安装后，agent 获得一组 memory_* 工具。典型流程：
1. 会话进行中，agent 用 memory_fact 追加原始笔记。 2. 到自然停点，运行 memory_extract 提炼事实与关心事项（由 memory-extraction skill 引导）。 3. 之后的会话里，memory_recall 召回相关经验；系统提示词中已自带一份精简画像快照。 4. 某条经验被证实有用就 memory_report；发现错了就 memory_revise。 5. 你也可以在 Memory 工作台里手动检视与治理一切。
使用细节见 [docs/INSTALL.zh-CN.md](./docs/INSTALL.zh-CN.md)；当前已实现的范围见 [docs/STATUS.zh-CN.md](./docs/STATUS.zh-CN.md)。
设计
架构、信任/挣得模型、数据 schema、防投毒边界，见 [docs/DESIGN.zh-CN.md](./docs/DESIGN.zh-CN.md)。实现现状与扩展方向见 [docs/STATUS.zh-CN.md](./docs/STATUS.zh-CN.md)。
目录结构
dsh-daoing-memory/
├── lib/ # 预构建产物（host + 浏览器 bundle + typert）
├── src/ # TypeScript 源码（供参考与迭代）
├── skill/ # 随包附带的 memory-extraction skill（独立 .md）
├── cordis.patch.yml # 把插件接进 DSH 的 profile patch
├── scripts/ # prepare 与 install-skill 辅助脚本
└── docs/ # INSTALL · DESIGN · STATUS · BUILDING · FAQ · MIGRATION构建与发布
本仓库直接携带构建产物（lib/），因此安装它无需 DSH monorepo 工具链。包如何产出、如何发布到 npm、如何上架 DSH 插件市场，见 [docs/BUILDING.zh-CN.md](./docs/BUILDING.zh-CN.md)。
许可
[MIT](./LICENSE) © daoing