前言¶
在 DeepSeek Harness 里做长周期项目时，架构决定、进度、踩过的坑和下一步往往分散在多轮会话里。仅靠当前上下文很难稳定找回这些内容；把整段历史塞进 prompt 也不现实。下面介绍社区插件 dsh-missher-memory（仓库 Missher12/Missher-DSH-Memory）：按项目保存、人工审核后再检索的长期记忆，并通过 Agent 的 memory_search 工具显式查询。它不修改 Harness 核心，也不复制或改写已有 legacy 数据库。
这是什么¶
维护者为 Missher12，分类为「记忆」。npm 包名为 dsh-missher-memory，当前资料中的源码版本为 0.3.1，许可证 MIT。插件面向 Cordis 提供项目级记忆能力，并附带 DeepSeek Harness 适配层；独立安装，不是桌面应用本体。桌面端入口与其他插件见 Missher-DeepseekHarness-Desktop 主页链接。
资料中的验证基线为官方 DeepSeek Harness 0.1.5-rc.2 与 Cordis 4.0.2；文档说明不能据此承诺当前桌面全部版本均已验收，其他宿主版本需自行对照 INSTALL.md 做兼容确认。
核心功能¶
以下行为均来自仓库 README，仅列已明确写出的能力。
项目绑定与审核¶
- 记忆按项目作用域隔离；项目记忆与个人偏好分 scope，项目检索不能读到其他项目，个人检索也不读外部项目库。
- 工作目录（cwd）只会在内存里产生绑定候选；持久化状态保存不可逆的项目 key、basename、短 hash 以及加密的外部会话标识，不存绝对 cwd。
- 首次绑定需人在「设置 → 项目记忆」里核对来源列表（仅有条数与时间范围，无正文），再确认绑定或把另一 worktree 候选挂到已有项目。legacy 库没有可信 project id，插件不会用 cwd、文本相似度或时间自动归类来源；选错来源会把历史记到错误项目。
- 新绑定项目默认开启候选采集与自动召回，二者可独立开关；待审核候选不会自动变成已审核记忆。会话结束产生审核候选，须在用户显式绑定项目之后。
检索¶
memory_search只通过当前会话已确认的项目绑定，搜索外部记忆与已审核的插件记忆；每条结果带 source、时间与稳定引用。- 查询按字面文本理解，不是 FTS 操作符；结果受条数与 UTF-8 字节上限约束。
- 缺失、损坏或不安全的数据库会返回稳定状态，fail open，不阻塞 Harness 启动或会话。
召回与整理¶
- 自动召回（对新绑定项目默认开启）把已审核 atom、可逆 capsule 以及可选 legacy 行贡献给 Desktop Brain Hub；Hub 是唯一追加带来源标注可见召回消息的组件。Brain 为可选，只控制 Harness 侧自动召回。
- 超过七天、未 pin 的完全重复已审核 atom 会自动合并；来源归档而非删除，回滚 capsule 可精确恢复来源与 FTS 行。
安装与启用¶
环境¶
- 官方 DeepSeek Harness
0.1.5-rc.2，dsh在 PATH 中。 - Node：
^22.19.0或>=24.0.0。 - 资料写明本包在 Cordis
4.0.2上验证；Python、原生构建、Brain、legacy 库均非必需。
安装步骤¶
- 若使用桌面端，先从 桌面端主页 安装应用并完成模型配置；本仓库为可选插件。
- 阅读 通用安装指南 与本插件说明，核对宿主与插件版本。桌面用「插件 → 添加插件」；Web/CLI 使用各自 profile，勿混用安装位置。
- DSH Market 可搜
dsh-missher-memory，确认仓库为Missher12/dsh-missher-memory并核对列表版本；若市场仍显示0.3.0-cordis.0，使用下面固定0.3.1命令。
Web profile 一行安装命令（资料原文）：
dsh plugin --profile web add https://github.com/Missher12/Missher-DSH-Memory/releases/download/v0.3.1/dsh-missher-memory-0.3.1.tgz
离线安装时，将 URL 换成本地 .tgz 路径即可。Release 包 SHA-256 为 5bde1f688d6791954d890e2b958775abbdaffe06532464c6b23de362cb06ed49（176873 字节）。
- 安装后执行
dsh --profile web --dump-config，确认配置中出现dsh-missher-memory与missher-memory；用同一webprofile 重启 Harness。 - 按宿主提示启用并重新加载，进入「设置 → 项目记忆」。新装不需要
vectors.db；绑定会初始化$DSH_HOME/missher-memory/state.db。更新前保留配置与数据，不要同时启用旧包名与新包名。
典型用法¶
首次绑定¶
- 在目标项目下打开顶层会话，使设置页出现 basename 与短 hash 候选。
- 审阅来源列表，只勾选属于该项目的来源。
- 确认新绑定，或把候选链到已有项目。
- 绑定完成后，用
memory_search验证；新绑定且尚无记忆时，应得到status: "ready"与空results，说明工具已真正调用而非误读本地缓存。若返回project-unbound，需完成绑定；若无该工具，检查 profile 与宿主服务。
显式搜索¶
模型或用户可调用（示例来自 README）：
memory_search({ query: "packaged smoke", scope: "project", limit: 5 })
scope 取 project 或 personal。完整采集、审核与检索验收流程见 INSTALL.md。
适用场景与注意¶
适合谁： 需要在同一代码库或多 worktree 上长期协作、希望把「已确认的决定与经验」从会话里沉淀下来、并在后续 Agent 回合里按项目检索的 DSH 用户。
权限与安全： 插件以当前 dsh 进程权限运行；安装前应阅读源码与 MIT 许可证，并理解数据落在 $DSH_HOME/missher-memory/。反馈问题勿上传 API Key、真实会话、Cookie 或学习库；附版本与复现步骤即可。
生态说明： DeepSeek Harness 社区插件目录（如 SkillHub 条目）为独立站点，与 DeepSeek / 幻方无官方从属关系；Git 仓库更新不会自动替换本机已装插件。
平台： Core 为纯 JavaScript；CI 对 canonical .tgz 在 macOS Intel/Apple Silicon、Windows x64、Linux x64 做校验。文档未宣称 Windows ARM / Linux ARM；包内无平台专属数据库或原生 addon。
结尾¶
dsh-missher-memory 把长项目的记忆收拢到「按项目、先审核、再搜索」的路径上：设置里完成绑定与来源核对，Agent 用 memory_search 按 scope 查询，自动召回与重复合并则在文档描述的边界内运行。进一步了解可打开 SkillHub 目录页 与 GitHub 仓库（中文说明见 README.zh.md）。
