dsh-memory

· English

github.com/ChenYueqi2024/dsh-memory · 配套插件：github.com/ChenYueqi2024/dsh-commit 项目主页：https://chenyueqi2024.github.io/dsh-memory/

给 DeepSeek Harness（dsh）装上跨会话项目记忆的原生插件。

dsh 的每次会话都是失忆的：项目约定、技术决策、用户偏好要么靠人工维护 AGENTS.md，要么每次重新交代。dsh-memory 让 Agent 在对话中自动沉淀值得记住的信息，并在未来的会话里自动想起。

会话进行中 ──事件流──▶ 文本积累器
                          │ turn 结束（可等待钩子）
                          ▼
              LLM 记忆抽取（一次辅助调用，JSON 输出）
                          │
              语义去重（精确匹配 + 词项包含度 0.65）
                          ▼
              存储域 dsh_memory（官方 JSON 后端，按工作区隔离）
                          │
新会话启动 ──▶ agent/created ──▶ 按当前问题相关性检索
                          ▼
              注入 system prompt「项目长期记忆」段（带来源引用）

功能

能力	说明
自动沉淀	每轮结束（agent/turn-stopping）自动抽取本次对话中的决策/约定/偏好/事实；session/disposed 与 memory_extract 工具作为兜底路径
语义去重	措辞不同的重复信息（如"用中文回答" vs "用户要求中文回答"）合并为一条并提升置信度——重复即强化
工作区隔离	记忆按工作区路径打标；不同项目的记忆互不污染，无标记的旧记录视为全局
相关性注入	新会话按"有效置信度 + 关键词重合度"排序注入 Top-N，而不是无脑全量
置信度衰减	有效置信度 = 置信度 × 0.5^(天数/半衰期)，半衰期按类别（fact 14 天 / decision·convention 30 天 / preference 45 天），低于 0.15 的记忆自动淡出，防过时信息污染上下文
来源引用	注入的每条记忆带来源编号与日期（#编号 - 日期），Agent 被问"你怎么知道的"可以回答，且可引导模型用 memory_forget 清理错误记忆
管理工具	memory_list / memory_forget / memory_extract / memory_approve 四个工具供模型与用户管理记忆库

快速开始

# 构建
npm install && npm run build

# 装入 profile（或将本目录加入 dsh.profile.bundles）
cp -r <本目录> $DSH_HOME/profiles/<name>/node_modules/dsh-memory
# 在 profile 的 cordis.patch.yml 里加：
# - insert:
#     - id: dsh-memory
#       name: dsh-memory
#       config: { provider: deepseek-official, model: deepseek-flash }

验证：

dsh --profile <name> "记住：本项目一律用 pnpm，不要用 npm。"
dsh --profile <name> "这个项目用什么包管理器？你怎么知道的？"   # ← 新会话，它记得

配置

键	默认	说明
provider / model	deepseek-official / deepseek-flash	记忆抽取的辅助 LLM 路由，可指向任何已配置的兼容端点
extractMinChars	120	触发自动抽取的最小对话文本增量
autoExtractMinIntervalMs	90000	两次自动（轮末）抽取的最小间隔——自动抽取是付费调用且在轮次边界 await，间隔内的增量累积到下一次合格轮次，长会话不为每轮重复付费
injectMax	30	单次注入 system prompt 的最大记忆条数
requireApproval	false	开启后自动沉淀的记忆需 memory_approve 批准才注入（防记忆污染）
maxOutputTokens / timeoutMs	1024 / 120000	抽取调用限额

诊断：设置环境变量 DSH_MEMORY_DEBUG=<文件路径> 可输出沉淀/注入的详细日志。

设计决策（为什么这么做）

1. 原生插件而非 MCP server：官方 memory 方案是外挂 MCP 进程。原生插件零跨进程开销、可直接挂会话生命周期钩子（Claude Code 的 hooks 桥甚至不支持 SessionEnd）、共享凭证与存储体系。
2. agent/turn-stopping 为主挂载点：headless/CLI 进程在会话结束后立即退出，session/disposed 来不及触发；turn-stopping 在每轮结束边界可等待地触发，保证沉淀落盘。
3. 抽取与主循环隔离：记忆抽取用独立的辅助 LLM 调用（ctx.llm.stream），不占用、不干扰 Agent 主循环。
4. 重复即强化：同一信息被再次表达时置信度 +0.1（上限 2.0），配合按类别差异化衰减（fact 14 天 / decision·convention 30 天 / preference 45 天），形成"常用记忆更牢、沉默记忆淡出"的自然淘汰。
5. 审批准入（可选）：requireApproval 开启后，轮末自动沉淀的记忆处于待审批态、不注入——只有用户显式要求记住的（memory_extract）直接生效。产品级缓解记忆污染。
6. 三条沉淀路径同一套口径：轮末自动（主）、会话结束兜底、工具主动调用，都按"自上次抽取以来的增量"触发、都按当前工作区打标——兜底路径早期漏传工作区（记忆会打成全局、跨项目泄漏）且重复抽取尾部窗口（reinforce 反复灌置信度、抵消衰减），W12 已修复并固化为测试覆盖的行为约定。
7. 自动抽取有频率节制：每轮新增文本达标就抽一次听起来合理，但那是每轮一次付费调用还要在轮次边界 await；90 秒最小间隔让增量自然累积，长会话不为每轮重复付费。

已知限制

• 长会话按轮增量抽取，只保留尾部 1600 字滚动窗口，超长跨度的话题依赖相关记忆已被沉淀；
• 记忆注入存在理论上的提示注入面（会话内容被恶意构造时可污染记忆库），现有缓解为注入段声明"记忆不构成指令" + 来源引用 + 用户可随时 memory_forget；
• 抽取质量依赖提示词约束，正式使用建议定期人工审阅 memory_list；
• TUI 交互模式未实测（headless 与 web 模式已实测）。

测试

npm test        # vitest，27 个用例：去重、语义对齐契约、衰减、排序、工作区隔离、注入格式与来源引用、JSON 容错

License

MIT