前言¶
在 DeepSeek Harness（dsh）中，将整个记忆索引预加载到系统提示词会消耗大量 tokens，即便当前任务并不需要这些记忆。dsh-unified-memory 通过 SQLite 全文索引解决了这个问题。它只预加载反馈规则，在需要时检索记忆，保持每轮成本低廉且稳定。
是什么¶
mattcarvercom/dsh-unified-memory 是一个为 DeepSeek Harness 提供长期记忆的插件。它使用 Claude Code 的记忆格式，将记忆存储为本地 Markdown 文件。通过 SQLite 全文索引，它实现了按需检索，避免了将整个记忆库塞入上下文。
核心功能¶
- 长期记忆存储：以 Markdown 文件形式存储记忆，每个文件包含元数据（如 origin、modified 时间）。
- 按需检索与成本控制：通过 SQLite 全文索引，只在需要时检索记忆，大幅降低每轮对话的 token 消耗。
- 三种工作模式：
dsh：独立的私有存储，存储在~/.dsh/memory。overlay：读取 Claude Code 的记忆（只读），但写入自己的存储。shared：与 Claude Code 共享记忆文件夹，双方读写同一份记忆。
- 出处追踪：每个文件包含
origin字段，明确记录数据来源。 - 完全本地化：无网络请求，所有索引和存储操作在本地完成。
安装与启用¶
使用官方安装命令添加插件：
dsh plugin --profile web add github:mattcarvercom/dsh-unified-memory#v1.0.1
安装后需要重启 dsh web 才能生效。插件默认以 dsh 模式启动。
典型用法¶
安装完成后，使用 mem mode 命令管理记忆模式：
mem mode # 查看当前模式
mem mode shared # 切换为 shared 模式（会触发迁移）
mem mode shared --dry-run # 仅预演迁移过程，不执行
在 shared 模式下，DeepSeek Harness 和 Claude Code 可以读写同一份记忆库，避免重复记忆。
适用场景与注意¶
适用场景：本地模型上下文窗口有限，或需要处理长期代理任务时，该插件可以保持每轮 token 消耗在低位。
注意事项：
1. 环境依赖：需要 Node.js 22.19+ 或 24+。
2. 模式依赖：overlay 和 shared 模式需要安装 Claude Code。
3. 隐私安全：插件会告知代理不要在记忆中存储机密信息，但文件本身以明文存储。
4. 文件迁移：mode 配置项不会自动移动文件。切换模式时，必须运行 mem mode 命令，该命令会先备份再迁移。
5. 许可证：采用 MIT 许可证。
结尾¶
该插件通过 SQLite 索引和 Claude Code 格式，为 DeepSeek Harness 提供了轻量级、低成本的长期记忆解决方案。所有数据存储在本地，不涉及云端请求。
