前言¶
在 DeepSeek Harness（DSH）中，普通 Session 结束后，Agent 很容易遗忘用户偏好、项目约束和已验证的经验。dsh-memory 解决了这个问题，融合了 Claude Code 的 Auto Memory 与 Codex 的 Session 记忆整理思路，为 DSH 提供简单、透明、上下文友好的长期记忆。
核心能力¶
- 本地 Markdown 存储：权威记忆保存在本机
$DSH_HOME/memory目录，用户可自行阅读和备份。 - Global / Workspace 隔离：Global 保存跨项目偏好，项目事实仅进入当前 Workspace，避免信息污染。
- 渐进披露：Agent 先接收 Global 记忆与当前 Workspace 的索引，详细内容按需通过 DSH 文件工具读取。
- 安全写入：检测到并发修改时拒绝直接覆盖，防止数据丢失。
- Session 整理：筛选已结束且稳定的 Session，由独立整理 Agent 提炼记忆。
- 可观察性：记录整理结果，可选 Debug 日志（不记录对话正文或 API key）。
- 双语界面：Memory 页面跟随 DSH Web 的 locale 自动切换。
安装与启用¶
- 执行安装命令：
dsh plugin --profile web add @hr98w/dsh-memory
- 安装完成后，完全重启
dsh web以加载插件。
使用方式¶
- 保存项目约定：在测试 Workspace 中告诉 Agent：“记住，这个项目的发布检查代号是松果，每次发布前先提醒我检查回滚方案。”
- 查询约定：新建同一 Workspace 的 Session，询问：“这个项目发布前有什么约定？”
- 配置整理模型：在设置页面选择 Session 整理使用的模型。
- 管理跨项目偏好：在全局记忆中保存跨项目的通用偏好。
注意事项¶
- 重启生效：安装或更新后必须完全重启
dsh web才能生效，刷新页面无效。 - 并发限制：并发保护限于同一个 MemoryStore 实例，建议由一个 DSH 进程负责同一
$DSH_HOME的记忆写入。 - 数据隐私：Debug 默认关闭，不记录对话证据、记忆正文或 API key。Web 管理接口只允许本机访问。
- 本地优先：权威记忆保存在本机，但不代表所有模型处理都离线完成。
- 插件生态：DSH 理念是“一切皆插件”，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
总结¶
dsh-memory 通过本地存储与渐进披露机制，解决了 Agent 长期记忆的问题。其开源 MIT 许可证允许自由使用与修改。
