会话与消息
dsh-explain
yuezengwu/dsh-explain · ★ 12
本地优先学习模式:跨会话全局学习线程、按来源讲解。
查看 manifest 检查详情
安装
dsh plugin --profile web add github:yuezengwu/dsh-explainGitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试
安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗
项目说明
dsh-explain 是 DeepSeek Harness 的学习模式插件。它把已完成工作中的有用概念整理成结构化讲解,安排轻量复习,并让你查看、修正它对你的认识。
主 Agent 保持不变。Explain 使用独立的模型调用、调度器、学习上下文和本地 SQLite 数据库。
看见完整学习闭环

这段 28 秒预览运行在真实组装的 DSH Web 0.1.2-rc.1 上,使用确定性、无隐私数据的样例环境。可以观看高清 MP4,或阅读录制约束。
| 捕获 Capture | 复习 Review | 校正 Adapt |
|---|---|---|
把已完成回答或选中文字变成可编辑的 /explain 草稿,绝不自动提交。 |
通过回忆、应用、辨析三类问题复习到期概念。 | 查看讲解偏好与 Topic 熟悉度,并修正或忘记一次推断。 |
快速开始
main 已适配 DSH 0.2.1-rc.5、0.2.2-rc.1、0.2.2-rc.2、0.2.2-rc.3、0.2.2-rc.4 与 0.2.2-alpha.3,保留全部三十一个既有宿主,包括 0.2.1-rc.4 与 0.2.2-alpha.2。尚未发布新的 Explain 标签,最新发布版 v0.3.1 的支持范围仍截至 DSH 0.1.6-alpha.2。精确源码提交与证据见兼容约定。
2026-11-18 核对:CLI npm latest=0.2.2-rc.1、next=0.2.2-rc.4、alpha=0.2.2-alpha.3。明确固定已验证的默认版(Node.js >=24.9):
npx @deepseek-ai/dsh@0.2.2-rc.1 plugin --profile web add github:yuezengwu/dsh-explain#main
npx @deepseek-ai/dsh@0.2.2-rc.1 --profile web
已验证的默认版需要 Node.js >=24.9。rc.5 继续作为固定回退版本:
npx @deepseek-ai/dsh@0.2.1-rc.5 plugin --profile web add github:yuezengwu/dsh-explain#main
npx @deepseek-ai/dsh@0.2.1-rc.5 --profile web
已验证的 npm next 固定为 rc.4,需要 Node.js >=24.9:
npx @deepseek-ai/dsh@0.2.2-rc.4 plugin --profile web add github:yuezengwu/dsh-explain#main
npx @deepseek-ai/dsh@0.2.2-rc.4 --profile web
先前验证的 0.2.2-rc.2、0.2.2-rc.3 与 0.2.1-rc.4 继续支持,需要时将两处 CLI 版本一起替换为所选固定版本。使用已发布标签时,继续搭配 DSH 0.1.6-alpha.2 和 github:yuezengwu/dsh-explain#v0.3.1。
已验证的 alpha 需要 Node.js 24.9 或更高版本,命令同样固定版本:
npx @deepseek-ai/dsh@0.2.2-alpha.3 plugin --profile web add github:yuezengwu/dsh-explain#main
npx @deepseek-ai/dsh@0.2.2-alpha.3 --profile web
启动后进入「设置 → 学习」,选择辅助模型的 provider 和 model,启用学习模式并保存。Explain 只观察此后完成的顶层工作回合,不补扫已有历史。
Git 仓库插件会在安装时构建。如果 pnpm 要求批准构建,请按提示把 dsh-explain 加入该 profile 的 pnpm-workspace.yaml,然后重新执行安装命令。自动化运行不应打开浏览器时,可在启动 DSH 时加上 --no-open。
v0.3.1 新增 DSH 0.1.6-alpha.2 支持,保留八个已验证的旧宿主。修复新版 Session API 下的来源跳转和 Explain 快捷入口,并覆盖插件实时停用/启用。既有学习数据继续兼容(SQLite schema 4、backup v3)。
从正在做的工作开始学习
| 入口 | 行为 |
|---|---|
/explain <学习请求> |
使用当前会话的受限来源上下文主动请求一次讲解。 |
| 解释选中文字 | 从可见选区创建可编辑的 /explain --selection … 草稿。 |
| 学习这个回答 | 创建绑定到精确 assistant 完成回合的可编辑草稿。 |
| 自主判断 | 合格工作回合结束后,在配置额度内生成一条值得学习的讲解。 |
/review |
在「学习」Tab 开始或继续一轮本地复习。 |
每张学习卡回答三个实际问题:是什么?为什么在这里重要?常见坑是什么? 选择「懂了」关闭卡片,或选择「没懂」换一种讲法。
复习,然后校正模型
标记「懂了」的概念会进入本地间隔复习计划。「学习 → 今日复习」每轮选择最多三个到期概念;每个概念独立从回忆推进到应用、辨析,答对后进阶,答错后继续练习当前题型。辅助模型把答案评为「掌握 / 模糊 / 遗忘」,再按确定性间隔安排下次复习。模糊或遗忘的概念重新视为学习中,允许补充讲解;该概念存在活跃讲解时暂不安排测验。
「学习 → 学习概况」公开显示讲解长度、结构、示例、术语和 Topic 熟悉度判断,并附带信心与来源回链。你可以修正推断、忘记判断或设置显式偏好。优先级固定且可见:显式偏好 → 用户修正 → 模型推断。
多个工作会话,一条学习线程
- 每个
$DSH_HOME只有一条 Explain 学习线程;resume 和 fork 不会复制它。 - 每个来源会话至多有一条等待反馈的讲解。
- 一个全局调度器串行处理讲解、复习、自主判断、重讲和压缩。
- 自主判断使用持久化的滚动 24 小时额度,可在设置中调整。
- 即使来源会话之后被删除,基于有界来源摘要的重讲仍然可用。
本地优先
| 数据 | 行为 |
|---|---|
| 学习线程 | 持久化到 $DSH_HOME/dsh-explain/v1/thread.sqlite。 |
| 开关与模型设置 | DSH 0.1.7 保存到当前 profile patch,旧宿主仍使用 $DSH_HOME/settings.yaml。首次迁移只导入 Explain 自己的字段,保留新版显式设置与原文件,不迁移存储路径。 |
| 来源材料 | 只保留有界 capsule;重讲最多持久化 2,000 字符的受限摘要。 |
| 全局学习上下文 | 与有界来源文本一起发送给所选辅助 provider;本地存储不等于离线推理,不进入主 Agent。 |
| 导出 | 版本化备份排除私有来源摘要,并过滤公开文本中常见的凭证和路径格式;自由文本仍可能包含隐私,分享前需检查。 |
| 清除 | 输入 CLEAR 后原子删除学习内容,同时保留运行设置和当前额度窗口。 |
Explain 只使用 DSH 第一方 conversation、composer、assistant action 和 settings 扩展点,不要求修改 DSH 或其他插件。
兼容性与验证
| 检查 | 当前结果 |
|---|---|
| DSH 兼容 | 0.2.1-rc.5 / 0.2.2-rc.1 / 0.2.2-rc.2 / 0.2.2-rc.3 / 0.2.2-rc.4 发布包;0.1.2-rc.1、0.1.3-alpha.1、0.1.3-alpha.2、0.1.5-alpha.1、0.1.5-alpha.2、0.1.5-rc.1、0.1.5-rc.2、0.1.5-rc.3、0.1.6-alpha.1、0.1.6-alpha.2、0.1.7-alpha.1、0.1.7-alpha.2、0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2、0.2.1-alpha.1、0.2.1-alpha.2、0.2.1-alpha.3、0.2.1-alpha.4、0.2.1-alpha.5、0.2.1-rc.1、0.2.1-rc.2、0.2.1-rc.3、0.2.1-rc.4、0.2.1-rc.5、0.2.2-alpha.2、0.2.2-alpha.3、0.2.2-rc.1, 0.2.2-rc.2、0.2.2-rc.3、0.2.2-rc.4 组装源码 |
| 单元与集成 | 三十二个源码版本各 108 项测试 |
| DSH Web 组装验收 | 7 个共有场景;0.1.7、0.2.0 和 0.2.1 增加旧设置迁移与重启恢复 |
| Explain 自有快捷入口 | 3 个 M6 场景验证卸载、移除及重装;实时停用与重新启用另在 0.1.6-alpha.2 执行 |
| 生产包 | frozen install、构建与实际 pack |
| 真实辅助模型 | DSH 0.1.6-alpha.1 + deepseek-flash:讲解、重讲、偏好修正、正反答案复习、精确回答命令、导出与清空 |
完整覆盖见验收矩阵,当前模型路由、样例、截图与验收范围见 2026-09-15 真实模型验收。DSH 仍处于开发者预览阶段;Explain 跟随当前公开 API 版本线,不保留更早私有预览包的兼容层。
本地开发
默认开发安装使用已发布的 0.2.2-rc.4 API 包,并仅针对已复现版本补齐遗漏的 store 运行依赖。组装 Web 测试支持上表三十二个版本中任一已构建的 DSH 源码 checkout;现有 Demo 录制仍使用 0.1.2-rc.1:
pnpm install
DSH_SOURCE_DIR=/absolute/path/to/dsh pnpm dsh:link
DSH_SOURCE_DIR=/absolute/path/to/dsh pnpm dsh:link:check
pnpm typecheck
pnpm test
DSH_SOURCE_DIR=/absolute/path/to/dsh pnpm test:web
DSH_SOURCE_DIR=/absolute/path/to/dsh pnpm test:m6
pnpm build
手工开发时直接安装当前 checkout:
dsh plugin --profile web add /absolute/path/to/dsh-explain
dsh --profile web --dump-config
dsh --profile web
文档
| 文档 | 内容 |
|---|---|
| Demo 制作 | 分镜、隐私约束、复现命令、素材与绘图来源。 |
| 产品需求 | 用户模型、范围、策略和验收标准。 |
| 技术架构 | 持久化、调度、RPC、UI 集成和失败行为。 |
| 整体审查与优化建议 | 代码证据、验证边界和按优先级排列的后续工作。 |
| 来源队列规模验证 | 修改前后合成测量、原始样本与候选生命周期约束。 |
| 验收矩阵 | 自动化与真实流程证据。 |
| 迭代计划 | 已完成里程碑与后续顺序。 |