前言¶
在 DeepSeek Harness(DSH)里做长期协作时,模型往往只在单次会话内保留上下文;换会话或新开窗口后,项目约定、偏好和踩过的坑需要重新说明。社区里也有各自实现的「记忆」方案,目录结构和注入方式并不统一。若你已经在 Claude Code 里用文件型自动记忆,或希望 DSH 与 Claude Code 共用同一套 MEMORY.md 索引,下面介绍维护者 jayhchen 发布的记忆类插件 dsh-cc-auto-memory(npm 包名同插件 id,当前版本 0.1.2,MIT 许可证)。
这是什么¶
dsh-cc-auto-memory 把 Claude Code 原生的 auto memory 机制移植为 DSH 轻量插件:持久化、基于磁盘文件,不注册专用 memory 工具,而是依赖模型在会话里使用普通的 read / write / edit 管理记忆文件。磁盘格式与 Claude Code 一致;在 claude 存储模式下可与 Claude Code 共用同一记忆目录,双向互通。
工作机制¶
每个会话开始时,宿主会向系统提示词注入两类内容:记忆使用说明(含记忆目录路径),以及 MEMORY.md 索引的前 200 行或 25 KB(二者以配置为准)。模型据此读写记忆;每次对记忆文件的 write / edit 之后,宿主会维护 modified 时间戳并 enforce 索引大小限制,下一次会话再注入更新后的索引,形成循环。
按项目划分记忆目录:以 git 仓库根目录解析项目(不在仓库内则用当前工作目录);路径 slug 中 / 会替换为 -,每个仓库一份独立记忆。目录内典型结构为:
MEMORY.md:索引,一行对应一条记忆<topic>.md:每条记忆一个文件
子 agent 会话不会注入主会话的记忆,行为与 Claude Code 一致。机制细节可参考 Claude Code 官方 auto memory 文档。
存储模式与设置页¶
插件在 Settings → Auto Memory 提供只读查看面板;创建、修改、删除仍由会话中的 agent 通过文件工具完成。
- Storage mode:两张模式卡片(DSH 独立目录 / 复用 Claude)加「Apply switch」。切换仅对新会话生效。
-dsh(默认):$DSH_HOME/projects/<slug>/memory/
-claude:~/.claude/projects/<slug>/memory/(尊重CLAUDE_CONFIG_DIR),与 Claude Code 共享同一记忆。
在 claude 模式下,模型对 ~/.claude/ 的写入可能落在会话工作区外,会按会话沙箱策略触发审批,属预期行为。
-
Project list:按当前模式过滤——
dsh只显示$DSH_HOME下项目,claude只显示~/.claude下项目。 -
Memory table:点击任意行可在浮层中查看原始文件内容(纯文本,不渲染 Markdown);Esc 或点击遮罩关闭。
配置¶
可在用户层覆盖 cordis.patch.yml:
| 字段 | 默认值 | 说明 |
|---|---|---|
mode |
dsh |
存储模式:dsh / claude |
claudeConfigDir |
'' |
claude 模式下 Claude Code 配置根;空则使用 $CLAUDE_CONFIG_DIR 或 ~/.claude |
maxIndexLines |
200 |
读取 MEMORY.md 的行数上限 |
maxIndexBytes |
25600 |
读取 MEMORY.md 的字节上限 |
安装与启用¶
DSH 生态采用「一切皆插件」;插件可在社区目录站点检索,该站点为独立社区资源,与 DeepSeek / 幻方无官方从属关系。
Web 环境(CLI)安装:
dsh plugin --profile web add dsh-cc-auto-memory
Desktop:打开应用内 Plugins 页,搜索 dsh-cc-auto-memory 安装。
运行环境要求 Node.js >= 20(见 package.json engines)。插件以当前 DSH 进程权限运行,安装前建议阅读 GitHub 仓库 源码与 MIT 许可证。
典型用法¶
安装并启用后,无需单独调用 memory API:在新会话中,系统提示已包含记忆说明与 MEMORY.md 片段。你可以在对话中让模型「把某条约定写入记忆」或「更新某 topic 文件」,模型会使用 read / write / edit 操作记忆目录;你可在 Settings → Auto Memory 只读核对内容。
若希望与本地 Claude Code 共用记忆,将 mode 设为 claude(或在设置页切换并 Apply),再开新会话;两端的 MEMORY.md 与 topic 文件格式相同,可直接互认。
适用场景与注意¶
- 适合:需要在 DSH 中长期保留项目级事实、偏好与决策记录;已在 Claude Code 使用 auto memory、希望 DSH 侧无缝续用或双端同步的开发者。
- 注意:索引注入有行数与字节上限,条目过多时需依赖
MEMORY.md索引设计与拆分 topic 文件;子 agent 无主会话记忆注入;claude模式下的跨目录写入可能触发审批。
结尾¶
dsh-cc-auto-memory 把 Claude Code 的文件型自动记忆搬到 DSH:会话启动注入索引、普通文件工具维护、可选与 Claude Code 共目录。更多信息见社区目录页 jayhchen/dsh-cc-auto-memory 与 GitHub jayhchen/dsh-cc-auto-memory。