dsh-daoing-memory

面向 DeepSeek Harness（DSH）的自进化记忆系统 —— 挣得式经验、日记/事实语义记忆、关心事项追踪，以及只增不删的审计账本。

English →

没有记忆的 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。

官方安装版 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/STATUS.zh-CN.md。

设计

架构、信任/挣得模型、数据 schema、防投毒边界，见 docs/DESIGN.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。

许可

MIT © daoing