DeepSeek Harness (DSH) 采用插件化架构。在构建长对话或多轮 Agent 任务时，传统的会话模式存在上下文窗口限制，模型难以有效利用历史信息。dsh-prime-memory 插件旨在解决这一问题，通过分层蒸馏机制，在后台自动捕获对话、沉淀记忆，并在模型生成前注入相关内容。
插件定位¶
dsh-prime-memory 是 DeepSeek Harness 的分层蒸馏记忆插件，由 drscrewdriver 维护，基于 MIT License 开源。它解决的是智能体开发中“短期记忆丢失”的问题，让模型能够在多轮交互中记住关键事实和场景。
核心功能¶
插件的核心流程在后台自动完成，对用户对话层透明：
- 分层蒸馏管道：对话经历 L0 原始捕获 → L1 原子记忆 → L2 场景整合 → L3 画像蒸馏 四个层级。
- 自动注入：在模型进行每一步推理前，插件会根据相关性检索记忆，将其注入上下文。
- 成本看板：设置页的“记忆”标签下提供“成本”Tab，按模型分色显示趋势折线，展示层级 × 时间窗口的 Token 消耗表格，支持按模型累计统计。
- 记忆工具：提供
memory_search、conversation_search、memory_read_scene等工具，模型可主动调用读取场景块。 - 会话档位：提供“日常”、“工作”、“智能”、“关闭”四种会话级记忆档位，以及“只写不读”模式。
安装与启用¶
安装前请确保 Node 版本满足 ≥ 22.16。
使用官方 CLI 安装（推荐）：
npx -y @deepseek-ai/dsh plugin --profile web add dsh-prime-memory
如果当前 Agent 具备终端执行能力，可发送以下指令让其自动安装：
请为 DeepSeek Harness 的 web Profile 安装 dsh-prime-memory 插件。
只执行下面两条命令，不要修改其他 Profile：
dsh plugin --profile web add dsh-prime-memory
dsh --profile web --dump-config
确认输出中出现 dsh-prime-memory 后告诉我安装结果。
不要替我关闭或重启正在运行的 DSH；安装完成后提醒我手动重启 DSH Web Host。
安装成功后，重启 DeepSeek Harness。在 Web Host 界面中，输入栏会出现“记忆”档位；设置页会出现“记忆”页面。
使用与工作流¶
安装并重启后，插件会自动接管会话。
- 记忆注入展示：当模型需要历史记忆时，界面会在用户消息上方显示“上下文注入 · memory”行，用户可点开查看具体注入内容。
- 工具调用：模型会根据需要调用
memory_read_scene等工具读取场景块，或使用搜索工具。 - 去重与时效：插件在同会话内对记忆进行去重，避免重复注入。召回排序引入时效加权机制（基于
recall.decayHalfLifeDays配置），确保较新的记忆优先。
配置与模式¶
- 会话档位：输入栏右侧的“记忆·自动” pill 可切换档位。默认为“智能”档，支持“日常”、“工作”及“关闭”。
- 只写不读：在悬浮板中可开启“只写不读”模式。开启后，插件继续捕获和蒸馏记忆，但不向当前会话注入任何内容（召回注入、工具指南等均停止），适合调试或敏感会话。
卸载与数据¶
如需卸载：
dsh plugin --profile web remove dsh-prime-memory
卸载后需重启 DSH。注意，数据文件保留在 ~/.dsh/memory/ 目录下（包含 conversations/, records/, scenes/ 和 memory.db），如需彻底清理可手动删除该目录。
注意事项¶
- 插件记账失败仅告警，不会阻塞蒸馏流程。
- 插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证。
- 数据存储为 SQLite 格式。
dsh-prime-memory 为 DSH 提供了长期记忆能力，适合需要处理长对话或复杂 Agent 任务的场景。
