深鲸记忆 · dsh-memory-doctor

跨会话记忆的管家：用量体检、重复合并、备份恢复、记忆包迁移。本地明文、零依赖、不上传任何数据。

它解决什么

现在大多数记忆插件都在解决「记住」。但用久了真正的问题变成：

• 记忆越写越满（运行时记忆有硬上限），到点就被动归档
• 同一条记了两遍、内容差不多但措辞不同
• 「临时/进度」类内容混进长期记忆，占着预算
• 换电脑、团队协作时，记忆带不走

本插件补的就是这三件事，不改你现有的记忆文件格式（~/.mnemon/runtime/ 下的 MEMORY.md / USER.md）， 所以它可以和现有记忆插件共存。

它自己就是热记忆（不是配件）

每轮对话都会把 MEMORY.md（项目/环境记忆）和 USER.md（用户画像）注入 system prompt， 并附带「记忆维护协议」——所以 Agent 真的会记住，而且知道什么时候该写、写去哪、别重复写。

• 注入预算默认 6000 字符，超了截断并提示归档（不会把上下文吃光）
• 记忆是明文 Markdown（~/.mnemon/runtime/），你自己随时能看、能改、能带走
• Agent 用自带的写文件工具维护记忆，不需要额外工具调用

与别的记忆插件共存 / 替换

本插件默认会自动让位：如果检测到 profile 里装着 dsh-mnemon 等其他记忆插件， 就不做每轮注入（只提供体检 / 瘦身 / 记忆包），避免两份记忆打架。

• 共存（推荐先这样）：保留 mnemon 注入，本插件只当「记忆管家」——体检、归档、导出；
• 替换：在插件面板停用（不必卸载）别的记忆插件，重启后本插件自动接管注入（判断只看已启用的 bundles）；
• 强制开关：MEMORY_DOCTOR_INJECT=0 关、=1 开（优先级最高），或写 ~/.mnemon/doctor.json：{ "inject": true } / { "inject": false }。

记忆文件是同一份（~/.mnemon/runtime/MEMORY.md、USER.md），所以替换时内容不用迁移。

功能

功能	说明
写记忆工具	Agent 可调用 memory 工具：read / append / replace / remove / search / stats；写入经宿主进程、绕开文件沙箱，自动去重、写前备份、超上限拒绝
概览	系统状态卡片（记忆引擎 / 运行时记忆 / 归档 / 记忆包）、存储域（根路径+三个子存储）、记忆来源与共存状态、用量趋势图、最近写入
体检	用量百分比、条目数、重复/近重复、低信息量、临时进度类，一次说清
瘦身	按勾选归档到 archived/（先备份、只移动、不删除，可回滚）
文档（只读）	浏览 ~/.mnemon/documents/ 里的项目文档（只读，不修改）
对比上次	与上一次体检对比：新增 / 移除的记忆条目
记忆包	一键导出 ~/.mnemon/记忆包-日期-xxxx/（含 manifest.json、文档、git 版本），可换机/团队共享/留档

安装

dsh plugin add dsh-memory-doctor

• 面板安装需要本机有 pnpm（DSH 的安装器依赖它）
• 没有 pnpm 也行：下载仓库 → 把整个文件夹放进 dsh-home/plugins/ → 重启 DeepWhale Desktop
• 装好后侧栏出现「记忆体检」图标；命令 /memory 可用

测试

bash tests/run.sh    # 28 项：拆条目/体检/瘦身备份回滚/记忆包导出导入/注入开关

使用

• 面板：侧栏「深鲸记忆」图标（大脑图标）→ 概览 / 运行时记忆 / 记忆包 / 归档 / 设置 五个页签
• 命令：/memory → 一句话看健康度

安全

• 只读写 ~/.mnemon/；不做删除（归档 + 备份）
• 不联网、不上传；无遥测

未知边界

• 目前瘦身只处理 MEMORY.md（USER.md 是人格画像，建议人工编辑）
• 记忆包导入为追加合并，不与现有条目冲突时才加

---

更新记录

• 0.4.0：新增 memory 工具（Agent 写记忆不再依赖文件沙箱）；文档页只读浏览；概览新增「与上次体检对比」；注入判断只看已启用的 bundles（停用但不卸载也会自动接管）；51 项测试。
• 0.3.0：面板升级为「仪表盘」结构：系统状态 + 存储域 + 记忆来源 + 用量趋势（历史快照）；运行时记忆改双栏（列表 + 条目详情侧栏）；新增「设置」页（注入开关、路径复制、导出诊断报告、版本与仓库入口）；服务端新增 /api/config、/api/report、诊断与历史快照。
• 0.2.0：面板重做（对齐宿主「记忆系统」的信息架构：状态卡片 + 页签 + 分组 + 搜索筛选 + 批量归档）；新增归档列表与一键恢复；侧栏改名「深鲸记忆」、图标改大脑；服务端补 /api/archive、/api/restore。
• 0.1.3：注入开关改为「自动让位 + doctor.json + 环境变量」三级，和别的记忆插件共存不再重复注入；补 28 项回归测试；清理仓库。
• 0.1.2：MEMORY_DOCTOR_INJECT 开关 + 热记忆注入。
• 0.1.0：热记忆注入 + 体检 / 瘦身 / 记忆包。