dsh-explain：DeepSeek Harness 的本地优先学习模式 DSH plugin

dsh-explain 是 DeepSeek Harness（DSH）的本地优先学习模式插件（DSH plugin），由 yuezengwu 维护，采用 MIT 协议，最近更新于 2026-08。它解决的核心问题是：DSH 能完成复杂工作，但结果本身未必能教会用户其中的概念、权衡与常见陷阱。该插件将多个工作会话中的有用材料汇聚成一条私有的、本地优先的学习线程，持续根据用户的知识水平、偏好与学习进度调整讲解内容。核心能力包括：跨会话全局学习线程、按来源讲解、私有的全局 ExplainContext、压缩机制以及可诊断的设置界面。

dsh-explain 这个 DSH plugin 支持哪些核心特性？

dsh-explain 在 $DSH_HOME 中维护唯一一条本地学习线程，工作会话、恢复与分叉不会复制其状态。每个顶级来源会话最多有一个待反馈的讲解，未关闭前该来源不能生成新的讲解，其他来源可独立继续。用户可通过 /explain <学习请求> 请求讲解，用 /explain on、/explain off 和 /explain status 管理该功能。手动讲解、自主讲解、改写与压缩共享一个全局调度器，同一时刻最多运行一个辅助模型请求。自主评估默认每滚动 24 小时 50 次请求，使用量在重启后保留，失败与重试计入，手动讲解、改写与压缩不计入。

dsh-explain 的 ExplainContext 和压缩机制如何工作？

私有的全局 ExplainContext 汇总对话偏好、知识水平与学习进度，仅发送给辅助模型，绝不注入主代理。辅助历史在新增结构化观察或关闭的讲解保持 30 分钟未触碰后压缩，或在请求将超过所选模型上下文窗口 50% 之前压缩，用户可见历史永不删除。主模型不知道 Explain 的存在，Explain 不写入主会话日志、不修改主模型上下文、不阻塞主回合。学习历史、活动来源状态、压缩检查点与 ExplainContext 存储在 $DSH_HOME/dsh-explain/v1/thread.sqlite，启用与模型设置使用 $DSH_HOME/settings.yaml。

dsh-explain 的学习线程如何集成到 DSH 界面？

学习线程出现在第一方 conversation.view 插槽中，作为 Learning 标签页；配置与诊断使用第一方 settings.section，无需外部 UI 宿主。Learning 标签页按会话作用域，但每个标签页读取相同的全局客户端存储与类型化 Remote，因此所有工作会话显示同一条学习线程。设置页面控制辅助模型、启用状态与滚动自主请求预算，并报告路由、预算恢复、上下文压力与最近一次压缩。若来源仍存在于当前会话清单中，其讲解可直接打开；已删除的来源仍可读但标记为不可用。P0 不自动切换视图，空 Hero 会话不显示视图标签页，工作会话编辑器在 Learning 视图打开时仍可用。

dsh-explain 怎么安装？

安装 dsh-explain 作为 DSH plugin，使用以下命令：

dsh plugin --profile web add github:yuezengwu/dsh-explain

安装后，在会话编辑器中输入 /explain 相关命令即可使用。该插件不捆绑也不要求 better-sidebar，无外部 UI 依赖。

dsh-explain 兼容哪些 DeepSeek Harness 版本和平台？

dsh-explain 已通过 DSH 0.1.0-rc.6 的验收门槛，M6 完全在 Explain 中实现，无需其他插件打补丁或运行时依赖。它使用 TypeScript 编写，依赖多个官方 DSH 包，如 @deepseek-ai/dsh-api-gateway、@deepseek-ai/dsh-client-ui-slots、@deepseek-ai/dsh-llm 等，确保与 DeepSeek Harness 生态紧密集成。

查看更多 DSH 插件，访问 dsh-plugin.org