dsh-memory

面向 DeepSeek Harness 的类 Codex 记忆插件。每个会话都拥有一份持久化、自动注入的记忆：蒸馏后的全局记忆摘要随每次提示词注入；智能体通过专用工具读写、搜索记忆；每轮对话结束后自动蒸馏为会话级 rollout 摘要，并定期重新合并进全局记忆文件。

工作原理

$DSH_HOME/memories/
├── memory_summary.md           蒸馏版、带版本号、有字节上限的全局记忆 —— 注入每个提示词
├── raw_memories.md             工具写入的追加式原始条目（带日期）
├── rollout_summaries/<sid>.md  每会话的轮次摘要（自动）
├── journal.jsonl               变更日志（合并游标消费）
├── summary_history/<v>.<ts>.md 保留的摘要历史版本（可回滚）
├── archive/raw-YYYY-MM.md      超出字节预算后被归档的旧 raw 条目
├── scopes/ws-<hash>/...         按工作区隔离的记忆库（开启 scopedMemory 后）
├── scopes/project-<hash>/...    按 git 根隔离的项目记忆库（开启 scopedMemory 后）
└── state.json                  版本 + journal/rollout 游标进度

• 注入 —— 通过 systemPrompt.context 在每次提示词组装时重读 memory_summary.md，因此 memory_add 写入后下一步立即生效。
• 工具 —— memory_read / memory_add / memory_update / memory_delete / memory_search / memory_review / memory_merge / memory_export / memory_import / memory_stats / memory_browse / memory_history / memory_rollback / memory_sync（见下表）。
• 自动记忆 —— 根代理每轮结束后，用默认模型把新增对话蒸馏成 rollout 摘要；累计 consolidateEvery 份后重新合并对应作用域摘要（原子写入、版本号递增）。开启 scopedMemory 后，rollout 与合并按会话的工作区或项目作用域路由。所有 LLM 调用带超时，绝不阻塞轮次。
• 种子导入 —— 首次运行时从 $DSH_HOME/AGENTS.md（Codex 同步的全局记忆）导入初始摘要，不修改原文件。

当前版本：0.2.11 —— 发布历史见 CHANGELOG.md。

安装

一键路径使用 scripts/sync-install.ps1（见下文「部署 / 更新」）；手动路径如下。两种方式之后都需要重启 DeepSeek Harness。

1. 将包复制到 profile 的外部插件目录：

   Copy-Item -Recurse ...\dsh-memory "$env:USERPROFILE\.dsh\profiles\web\node_modules\@dsh-external\dsh-memory"
   

2. 在 ~/.dsh/profiles/web/cordis.patch.yml 中追加 loader 行（必须是 insert 条目——独立的 - id: 行只用于覆盖已存在的 bundle 条目，不会挂载新插件）：

   - insert:
       - id: dsh-memory
         name: '@dsh-external/dsh-memory'
         config:
           maxBytes: 8000
           autoSummarize: true
   

3. 重启 DeepSeek Harness。插件以 dsh-memory 挂载，设置命名空间为 memory。

或者，在任何平台（含 Linux/macOS）通过 DSH CLI 从 GitHub 安装——CLI 会自动挂载 bundle，无需手写 cordis.patch.yml 行：

dsh plugin --profile web add 'github:haitang1/dsh-memory#f3c8de4'

建议钉住 commit（f3c8de4 即 v0.2.7 发布提交）；省略 #<sha> 后缀则安装默认分支。安装后需重启 DeepSeek Harness。

配置

Web 设置页卡片（见下文）可在线编辑全部配置项；各键亦可通过 loader 配置或 settings.yaml 的 memory: 段覆盖。

工具

独立 MCP 服务器

bin/dsh-memory-mcp.mjs 通过 stdio JSON-RPC（MCP）暴露同一套 Markdown 记忆库，不依赖 DeepSeek Harness 运行时。环境变量：DSH_MEMORY_DIR（默认 ~/.dsh/memories）、DSH_MEMORY_REDACT=1（默认）。作用域参数：global（默认）、workspace/project（需 cwd）。

提供 9 个工具，存储语义与 DSH 工具一致：memory_read、memory_add、memory_update、memory_delete、memory_search、memory_stats、memory_history、memory_merge、memory_review。客户端配置示例见 examples/mcp-config.json。

部署 / 更新

scripts/sync-install.ps1 把运行时文件复制到 DSH profile 外部插件目录并校验 SHA-256；不触碰记忆数据、不重启 DSH，同步后需重启。用法：

powershell -ExecutionPolicy Bypass -File scripts/sync-install.ps1 -DryRun
powershell -ExecutionPolicy Bypass -File scripts/sync-install.ps1 -Backup

脚本

Web 设置页

插件自带 Web 客户端 bundle，会自动在插件配置页（设置 → 插件 → 插件配置）注册「记忆 (dsh-memory)」卡片，无需额外步骤。卡片可编辑全部配置项（按 通用 / 自动摘要与合并 / 作用域 / 安全与嵌入 分组），通过插件自己的同源端点（/_dsh/memory/settings，由 host 半部分注册）读写配置。卡片文案为中英双语，跟随 DSH 的语言设置自动切换；embeddingApiKey 以掩码显示，memoryDir 更改需重启 DSH 生效。

自 DSH 0.1.0-rc.7 起：settings.plugin.item 改为 keyed 槽位，插件配置页按设置命名空间派发卡片 —— 卡片以 key: 'memory' 注册（即插件自己的设置命名空间）；同时 rc.7 移除了 dsh-host-apiproxy 的硬编码设置白名单（WEB_SETTINGS_NAMESPACES），通用 Web 设置 API 直接服务全部已注册命名空间，因此旧版 patch-web-settings.ps1 已不适用。本插件已针对 DSH 0.1.2-rc.1 验证（该版本移除了 settingsNamespace 辅助导出、设置命名空间改为裸字符串，并用 Surface 层 snapshotEvents/deriveMessages 替换了 Session.events），并将 peerDependencies 收紧到 dsh-* ^0.1.2-rc.1 / cordis ^4.0.1，以与实际验证过的 harness 对齐。

自动记忆与 auto-memory 技能

记忆的持续更新由两层互补机制保证（都不需要手动调用工具）：

1. 宿主管线（全自动） —— 根代理每轮结束后自动把该轮对话蒸馏为 rollout 摘要（由 summarizeDebounceMs 防抖），并定期合并进注入的全局摘要。摘要模型按 summarizeProvider/summarizeModel → 当前选择的代理模型 → agent-default-model 设置命名空间的顺序解析；memory_stats 会报告 summarizeSkipCounts / lastSummarizeSkip，被跳过的蒸馏可观测。自 0.2.3 起蒸馏同时读取 user/message 与 assistant/message 文本（此前助手回复被静默丢弃）、用户设置启动即生效（而非首次在线编辑后才生效）、内部蒸馏/合并调用关闭推理（避免撞输出上限）。已于 2026-08-16 端到端实测：回合 → rollout 文件 → 合并，全局摘要 v1 → v2。
2. auto-memory 技能（代理主动） —— 插件注册一个运行时技能，指导代理主动识别关键信息（偏好、决策、约定、修复、事实），用 memory_add 写入（带 tags 与去重），在任务依赖历史时用 memory_search / memory_read 主动检索，并修正过时条目。重启后该技能会出现在每个会话的技能目录中。

范围

记忆存储于三个作用域：

• global —— 所有会话共享（类 Codex 的默认）；
• workspace —— 按工作目录隔离（ws-<hash>），scopedMemory: true 时启用；
• project —— 按最近 git 根隔离（project-<hash>），scopedMemory: true 时启用。

工具接受 scope 参数（global | workspace | project）；项目作用域解析会话的 cwd。各作用域的写权限可用 readOnlyScopes 限制。

开发与测试

npm test 运行 65 项测试（node:test）：

• test/store.test.js —— 存储语义、journal、历史、归档、作用域；
• test/automation.test.js —— auto-memory 技能定义、模型路由回退链、extractMessageText（user/assistant 事件结构）；
• test/browser.test.js —— 交互式 HTML 浏览器的快照渲染；
• test/web-settings.test.js —— 设置端点生命周期（GET/POST、403/409、体积限制），以及 VM 沙箱加载客户端 bundle 断言 settings.plugin.item 卡片注册；
• test/embedding.integration.test.js —— fake /embeddings 服务 + 本地哈希向量；
• test/mcp.integration.test.js —— 真实 MCP 子进程往返；
• test/host-wiring.test.js —— 守卫 lib/index.js 的宿主对接面：裸字符串设置命名空间、settingsNamespace 辅助导出缺失、Surface 层 snapshotEvents（而非 Session.events）、llm 服务经 inject(['llm']) 等待（而非启动时 ctx.get）、14 个工具清单、agent/turn-stopping、systemPrompt.context 钩子、auto-memory 技能，以及经 fake cordis ctx 的 apply() 冒烟（零依赖 CI 中跳过）。

架构与机制说明见 docs/DESIGN.md；部署状态见 docs/STATUS.md。

License

MIT