DeepSeek Harness 提供了插件化的扩展能力。在 Agent 开发中,普通聊天记录无法可靠地告知模型哪些步骤在何种条件下有效,也无法记录谁批准了哪些操作。向量搜索能找到相似文本,但相似度本身不足以授权重用一个流程。
dsh-experience-map 旨在解决上述问题。它将已完成的会话证据转化为结构化、版本化的 Experience,在重用前检查其适用性,并请求用户批准具体的重用计划。
核心功能¶
该插件提供以下能力:
- Evidence-governed experience memory:以证据为基础的经验记忆机制,确保每一条经验都有据可查。
- Reuses successful solutions:复用历史上成功的解决方案,避免重复探索。
- Checks Experience applicability:在提议重用前,检查 Experience 是否仍适用于当前环境。
- SQLite-based durable records:使用 SQLite 存储持久化的 Experience 记录。
- Markdown projections:通过 Markdown 格式提供可读的视图。
- Browser-free Host operation:支持无浏览器的主机操作模式。
- Opt-in management CLI:提供可选的管理 CLI 工具,用于批量操作。
- Local dense-retrieval adapter support:支持本地密集检索适配器。
安装与启用¶
本插件通过 npm 发布,包名为 dsh-experience-map。
环境要求:
* DeepSeek Harness: 0.1.5-rc.2
* Node.js: ^22.19.0 或 >=24.0.0
依赖说明:
* npm 包不打包 Transformers.js 或模型权重,也不会自动下载模型。
* 仅在需要模型提议 Candidate 时,才需要配置 LLM provider。
* 仅在显式启用 dense-retrieval adapter 时,才需要安装 @huggingface/transformers。
典型用法¶
- 手动保存经验:完成一个有实际产出的任务后,打开对话的
Experience标签页。系统会列出零个或多个建议,此时决定是否将建议保存为持久化的 Experience。 - 无头操作:使用管理 CLI 对 Experience 进行批量管理或查询。
注意事项¶
- 本插件以插件形式集成到 DeepSeek Harness 中,在当前 DSH 进程权限下运行。安装前应检查源码与许可证。
- Dense retrieval 适配器为显式启用功能,非默认开启。