前言¶
DeepSeek Harness (DSH) 采用插件化架构，但在记忆管理上常面临上下文窗口限制、缺乏长期上下文持久化以及工具调用繁琐的问题。dsh-memory 插件旨在解决这些问题，为当前工作区提供长期记忆能力。它对标 Qoder / WorkBuddy / ZCode 的记忆交互，提供索引式简报、轮末相关召回、版本链管理以及按需读写的能力。
核心功能¶
工作区长期记忆¶
记忆以当前工作区为单位落库。系统会为每个工作区生成一个带 8 位 hash 的目录名，确保同名目录不会互相污染。
索引式简报（默认）¶
会话开始时，最重要的记忆以一行一条的索引形式注入系统提示（如 📌 [类别] 标题 #标签 (id)）。相比全文注入，这种方式能降低 60-70% 的 token 消耗，模型可按需通过工具获取全文。
轮末相关召回¶
轮次结束后，系统会根据当轮用户消息做本地检索，将命中的记忆在下一轮以「相关召回」块注入。这属于纯本地计算，不产生额外的模型开销。
memory 工具¶
提供以下命令：save（保存）、search（搜索）、list（列表）、get（获取）、update（更新）、forget（遗忘）、stats（统计）。
版本链与自动提炼¶
支持版本链机制（supersedes），推翻旧记忆时归档不删除，支持一键回滚。轮次结束可自动提炼记忆，支持 captureMode: draft 模式，将提炼结果放入待审队列，批准后生效。
记忆管理面板¶
在 DSH 设置 → 记忆中，可查看记忆库、时间线、健康体检和审批队列。
安装与启用¶
插件不支持 dsh plugin --profile desktop 安装，必须使用 PowerShell 脚本。安装前建议备份 profile 文件。
cd <克隆下来的 dsh-memory 目录>
pwsh -File install.ps1
安装完成后需手动重启 DSH 桌面端。脚本会自动处理垫片、profile 清单和 junction 挂载。
典型用法¶
保存记忆¶
使用 memory 工具保存：
memory save [title] [content]
搜索记忆¶
memory search [query]
草稿审批¶
在配置中开启 captureMode: draft，提炼结果会进入待审队列，在设置面板批准。
数据存储与配置¶
存储路径¶
记忆数据默认存储在 ~/.dsh/storages/dsh-memory/。工作区目录结构为 workspaces/<目录名>-<hash>/memories.json。
仓库镜像¶
记忆默认不落在仓库里，防止外泄。如需在仓库中保留副本，可在设置中开启 mirror 模式，系统会在工作区生成 .dsh-memory/MEMORY.md。
依赖配置注意¶
安装时需确保依赖键、bundles 项、cordis.patch.yml 的 name、客户端模块 id 均为同一个真包名（@bangbang-03/dsh-memory）。如果配置不一致，设置面板里的界面可能整块消失。
维护者与许可¶
该插件由 BangBang-03 维护，采用 MIT 许可证。更多细节可参考 GitHub 仓库。
