前言¶
用智能体协作开发时，一个常见的麻烦是：这次会话里定下的技术选型、约束和踩过的坑，下次会话就丢了。要么每次重新解释一遍，要么让模型自己往记忆文件里写——后者的风险是没有校验，模型写入的内容可能早已和当前代码对不上。
dsh-project-memory 针对的就是这个问题：把持久性的决策、约束、约定、经验教训和事实变成版本化的项目记录，但模型只能提案，能否入库由人决定。DeepSeek Harness（DSH）的理念是「一切皆插件」，这个插件就是沿这个思路对记忆能力的扩展。
这是什么¶
dsh-project-memory 的定位一句话可以说清：为 DeepSeek Harness 提供「有证据支撑、需人工批准」的项目记忆（Evidence-backed, human-approved project memory）。作者是 luoyuejun9，MIT © 2026 许可证，插件版本 0.1.0，面向 Harness 0.1.0-rc.6。需要说明的是，DeepSeek Harness 目前处于开发者预览阶段，随着 Harness API 演进，插件可能需要跟进更新。
核心设计¶
人工审批是硬边界¶
模型工具无法批准或归档记忆。插件向模型暴露的工具中，搜索、读取、校验都是只读的，只有一个写受限的提案工具。候选记忆提升为已批准记忆的唯一途径，是人执行 /memory approve。
证据可校验¶
每条记忆附带证据引用，记录项目相对路径、精确行范围、可选符号和 SHA-256 哈希。源码片段本身不会复制进记忆，记忆里存的是「哪个文件、哪几行、当时的哈希是多少」。源码变更后执行 /memory validate，会逐条报告证据状态是 verified、stale 还是 missing。
冲突处理¶
存在冲突的活动记忆时，需要通过 supersedes 声明替代关系，或用显式的 --keep-both 同时保留，不允许含糊地并存。
本地、确定性¶
搜索是确定性的本地搜索，没有 embeddings，不依赖云数据库或后台服务。已批准条目是 Git 友好的 JSON。
安装与启用¶
dsh plugin --profile web add dsh-project-memory
安装完成后需要重启所选的 Harness profile。
环境要求：Node >=22.19。peer 依赖为 @deepseek-ai/dsh-agent、@deepseek-ai/dsh-commands、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-tools（0.1.0-rc.6），以及 @deepseek-ai/cordis（4.0.1）。
命令与典型流程¶
插件提供的命令：
/memory capture [note]
/memory candidates
/memory approve <candidate-id> [--keep-both]
/memory reject <candidate-id> [reason]
/memory search <query>
/memory show <memory-id>
/memory validate [memory-id]
/memory archive <memory-id>
/memory timeline
日常流程大致是：
1、会话里出现值得沉淀的决策或教训时，用 /memory capture [note] 提交一条候选记忆。
2、/memory candidates 查看候选列表。
3、人工审查后，/memory approve <candidate-id> 批准，或 /memory reject <candidate-id> [reason] 拒绝并注明原因；有冲突时按上面的规则选择 supersedes 或 --keep-both。
后续维护：/memory search <query> 检索，/memory show <memory-id> 查看详情，/memory validate 在源码变更后校验证据状态，/memory archive <memory-id> 归档，/memory timeline 查看时间线。
存储与团队共享¶
存储路径：
.dsh/project.json
.dsh/memory/index.json
.dsh/memory/entries/memory_*.json
.dsh/memory/candidates/candidate_*.json
团队需要共享记忆时，把 .dsh/project.json、.dsh/memory/index.json 和 .dsh/memory/entries/ 提交进仓库即可；候选文件在审查通过前可以只留在本地。
适用场景与注意¶
适合的场景：长期演进的项目需要跨会话保留决策和约束；团队希望用 Git 共享一份经过人工把关的记忆；对记忆内容要求可追溯到源码、且不希望引入 embeddings 或云服务的环境。
几点注意：
1、DeepSeek Harness 还是开发者预览版，本插件面向 0.1.0-rc.6，Harness API 变动后插件可能需要更新。
2、插件以当前 dsh 进程的权限运行，安装前建议先阅读源码和许可证（MIT）。仓库里给出了开发命令，可在本地执行 npm install、npm run check、npm pack --dry-run 做验证。
结尾¶
dsh-project-memory 把「记忆」拆成了两步：模型负责提案并引用证据，人负责批准，SHA-256 校验负责发现过期。对于在意记忆可靠性的 DSH 用户，值得一看。
- GitHub：https://github.com/luoyuejun9/dsh-project-memory
- 插件目录页：https://www.skillhub.cn/plugins/luoyuejun9/dsh-project-memory
目录页是社区维护的独立站点，与 DeepSeek、幻方没有官方从属关系。
