前言¶
在长期运行的项目中,架构决策、历史尝试、失败方案以及下一步计划往往容易被遗忘或分散在对话历史中。dsh-missher-memory 旨在解决这一问题,它为 DeepSeek Harness 提供了经过审查的项目范围记忆功能,确保智能体能够可靠地回溯上下文。
插件介绍¶
dsh-missher-memory 是一个独立安装的 DeepSeek Harness 插件包,由开发者 Missher12 维护。其核心价值在于通过“审查”机制,恢复架构、决策、进度、失败尝试及后续步骤,从而辅助开发者在长对话中保持连贯性。
核心功能¶
该插件包含以下核心能力:
- 项目级记忆审查:对项目范围内的记忆进行结构化管理和审查。
- 上下文恢复:支持恢复架构设计、决策记录、项目进度、过往失败方案及后续步骤。
- 索引检索:提供高效的记忆索引检索功能。
- 数据合并策略:支持可逆的重复项合并,避免记忆冗余。
- 自动与手动检索:支持自动记忆检索,也提供候选审查与审批工作流,确保记忆的准确性。
安装与配置¶
前置要求¶
安装前请确保环境满足以下依赖版本:
- DeepSeek Harness: 0.1.5-rc.2
- Cordis: 4.0.2
- Node.js: ^22.19.0 或 >=24.0.0
安装步骤¶
使用官方提供的安装命令将插件添加到当前 web 配置文件中:
dsh plugin --profile web add https://github.com/Missher12/dsh-missher-memory/releases/download/v0.3.1/dsh-missher-memory-0.3.1.tgz
安装完成后,运行以下命令确认插件已生效:
dsh --profile web --dump-config
使用示例¶
安装并绑定项目后,可以在会话中调用 memory_search 工具进行检索。以下是一个典型的调用示例:
memory_search({ query: "packaged smoke", scope: "project", limit: 5 })
参数说明:
* query: 检索的文本内容。
* scope: 记忆范围,可选 project(项目记忆)或 personal(个人记忆)。
* limit: 返回结果的数量限制。
注意事项与适用场景¶
- 数据存储位置:插件数据存储在
$DSH_HOME/missher-memory/目录下,主要由state.db文件管理。 - 数据库兼容性:插件不会修改 DeepSeek Harness 核心代码,也不会复制或修改现有的遗留数据库。
- 平台支持:目前仅对 macOS (Intel/Apple Silicon)、Windows x64 和 Linux x64 进行了验证。Windows ARM 和 Linux ARM 平台暂未支持。
- 运行机制:插件以当前 DSH 进程权限运行,不涉及 Python 或原生构建(除非特定组件依赖)。
该插件适合需要长期维护复杂项目、希望智能体能准确引用历史决策和架构方案的深度开发场景。
结尾¶
dsh-missher-memory 通过人工审查与自动检索的结合,为 DeepSeek Harness 提供了可靠的项目记忆层。其开源特性(MIT 许可证)允许开发者自由查看源码与配置细节。更多细节可查阅 GitHub 仓库 或 DSH 社区目录。