前言¶
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 倉庫。
