前言¶
DeepSeek Harness（DSH）是「一切皆插件」的智能体开发框架。很多记忆插件解决的是「记住」的问题，但实际使用中会出现记忆膨胀、内容重复、临时信息占满长期记忆预算、跨设备/团队协作时记忆带不走等问题。dsh-memory-doctor 插件从「管理」视角补齐这些短板，它不改动现有的记忆文件格式，可与其它记忆插件共存。
插件定位¶
dsh-memory-doctor 是一个记忆管理插件，由 feely0208 维护，分类为「记忆」。它提供跨会话热记忆注入、记忆体检、瘦身归档、记忆包导出与恢复等能力，所有数据以明文 Markdown 存储在本地 ~/.mnemon/runtime/，零依赖、不上传。
核心功能¶
1. 跨会话热记忆注入¶
每轮对话都会把 MEMORY.md（项目/环境记忆）和 USER.md（用户画像）注入到 system prompt，并附带「记忆维护协议」，使 Agent 知道何时写入、写入何处、避免重复。
- 默认注入预算 6000 字符，超限截断并提示归档
- 记忆文件为明文 Markdown，可随时查看、编辑
- Agent 通过内置的
memory工具维护记忆，无需额外工具调用
2. 记忆工具¶
Agent 可调用 memory 工具，支持以下操作：
read：读取记忆append：追加内容replace：替换内容remove：删除条目search：搜索记忆stats：统计信息
写入操作会经过宿主进程，绕开文件沙箱，自动去重、写前备份、超上限拒绝。
3. 会话回复存入记忆¶
每条助手回复旁有「大脑」按钮，预览后可一键存入 MEMORY.md 或 USER.md，同样支持自动去重与备份。
4. 记忆概览¶
面板提供系统状态卡片，包含：
- 记忆引擎状态
- 运行时记忆（根路径 + 三个子存储域）
- 归档与记忆包列表
- 记忆来源与共存状态
- 用量趋势图
- 最近写入记录
5. 记忆体检¶
体检功能给出当前记忆的健康度：
- 用量百分比
- 条目数
- 重复/近重复条目
- 低信息量条目
- 临时进度类内容
6. 瘦身与归档¶
瘦身操作会按勾选项将条目归档到 archived/ 目录：
- 操作前自动备份
- 仅移动文件，不删除
- 可从归档列表中一键恢复
7. 记忆包¶
支持一键导出为「记忆包」，目录结构包含：
- manifest.json
- 文档
- git 版本信息
记忆包可用于换机、团队共享或长期留档。导入为追加合并模式，仅在内容不冲突时才会添加。
8. 文档浏览（只读）¶
可浏览 ~/.mnemon/documents/ 里的项目文档，仅读模式，不修改。
9. 与其它记忆插件的共存策略¶
插件默认会自动让位：如果检测到 profile 中已启用其他记忆插件，则不进行每轮注入（只提供体检、归档、导出）。
- 共存：保留对方的注入，本插件仅作为「记忆管家」
- 替换：在插件面板停用对方（不必卸载），重启后本插件接管注入（判断只看已启用的 bundles）
- 强制开关：通过环境变量
MEMORY_DOCTOR_INJECT=0关闭、=1打开；或在~/.mnemon/doctor.json中配置{"inject": true/false}
10. 测试¶
仓库提供测试脚本，共 28 项测试，覆盖拆条目、体检、瘦身备份回滚、记忆包导出导入、注入开关等场景。
安装¶
通过 DSH 面板安装：
dsh plugin add dsh-memory-doctor
安装前提：
- 面板安装需要本机有 pnpm（DSH 安装器依赖）
- 无 pnpm 也可手动安装：下载仓库，将整个文件夹放入 dsh-home/plugins/，重启 DeepWhale Desktop
安装完成后，侧栏会出现「记忆体检」图标（大脑图标），命令 /memory 可用。
使用方式¶
- 面板使用：侧栏「深鲸记忆」图标 → 概览 / 运行时记忆 / 记忆包 / 归档 / 设置 五个页签
- 命令使用：输入
/memory，可快速查看记忆健康度
安全与边界¶
- 仅读写
~/.mnemon/目录，不做删除操作（归档 + 备份） - 不联网、不上传任何数据，无遥测
- 目前瘦身仅处理
MEMORY.md（USER.md为人格画像，建议人工编辑） - 记忆包导入为追加合并，不与现有条目冲突时才添加
适用场景¶
适合需要精细管理记忆生命周期、希望避免重复写入、需要跨会话保持上下文、或需在团队/设备间共享记忆的用户。安装前建议检查源码与许可证。
总结¶
dsh-memory-doctor 在 DeepSeek Harness 中提供了一套从写入、注入到体检、归档、迁移的完整记忆管理流程。它以明文本地存储、零依赖、不上传为安全基础，通过工具与面板相结合的方式，帮助开发者更好地控制智能体的记忆预算与内容质量。
- 插件目录：https://www.skillhub.cn/plugins/feely0208/dsh-memory-doctor
- GitHub：https://github.com/feely0208/dsh-memory-doctor
