前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在开发具备教学能力的智能体时，开发者往往需要处理复杂的交互流程，比如如何在不打断正常对话的前提下提供学习辅助。wsnxxxs/deepseek-harness-interactive-learning 插件为此提供了解决方案。
是什么¶
@dsh-portable/interactive-learning 为 DeepSeek Harness 增加了一个由用户显式选择的 learning Agent preset 和原生学习活动。它通过声明式协议和非阻塞流程，让智能体在默认对话流中提供教学支持，包括语义可视化、反思暂停和细粒度的教学状态管理。
核心功能¶
- 用户显式选择的 learning Agent preset：支持 Standard、Code、Minimal 等多种预设，工具 schema 和 standing prompt 保持不变。
- Learn intent 与首轮路由：系统会区分“建立理解”和普通任务。
what is X、ELI5、flashcards、study guide 等请求属于 learn intent，会被路由至学习路径。 - 非阻塞学习流程：默认路径仍是普通对话，仅在操控参数能帮助理解时调用
learning_visual。移除了旧的 Question → Reveal 双工具结构，避免模型回合在等待用户期间一直处于运行状态。 - Reflective Pause：通过
dsh-learning/checkpoint@1实现。每个 session 最多一个 pending checkpoint，仅在回答会改变下一教学动作时使用。 - 多种语义可视化类型：通过
dsh-learning/visual@4支持 plot、node_link、scene_2d、relation、formula_steps、study_map、recall_deck、data_table、state_transition、sequence_buffer、sequence_diagram、code_trace、field_2d、causal_loop 等类型。 - Session-scoped LearnerState：维护教学状态，包括当前目标、已展示的先验、误解或缺口、支架需求、急迫/卡住证据、评估语境以及有界 failed-move 历史。
- 设计系统与可访问性：所有学习界面共用一套设计令牌，面向键盘与辅助技术提供支持。
安装与启用¶
该包在 package.json 中标记为 private。安装方式主要通过提供的二进制文件 dsh-learning-preset 进行。若需从源码构建，可执行以下命令：
pnpm install
pnpm run build
pnpm run test
pnpm run check
pnpm run test:package:purity
pnpm run test:package
pnpm run pack:check
典型用法¶
- 默认路径与可视化：默认路径仍是普通对话，仅在操控参数能帮助理解时调用
learning_visual。工具调用所在位置会显示正在准备的视觉标题，而不是笼统的等待提示。 - Learn Intent 路由：系统会先区分“建立理解”和普通任务。
what is X、ELI5、flashcards、study guide 等请求属于 learn intent，会被路由至学习路径。 - Reflective Pause：通过
dsh-learning/checkpoint@1实现非阻塞的 reflective pause。卡片标题显示认知动作（如预测、解释、对比），而不是内部机制标签。
适用场景与注意¶
- 适用场景：需要智能体具备解释概念、提供学习路径、生成 flashcards 或进行结构化调试诊断的场景。
- 注意：
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证（资料中未找到明确的许可证信息）。
- 每个 session 最多一个 pending checkpoint。
- 刷新和 resume 会 fold 同一日志。
- 旧 Question -> Reveal 双工具结构已被移除。
短结尾¶
该插件为 DeepSeek Harness 生态提供了原生、非阻塞的教学能力。通过 dsh-learning/visual@4 和 dsh-learning/checkpoint@1，开发者可以构建更精细的交互式教学流程。更多细节可查看插件目录或GitHub 仓库。
