dsh-study-coach：DSH 的學習教練插件

前言¶

DeepSeek Harness（DSH）支持通過插件擴展能力。dsh-study-coach 專注於自學場景。它將一門課程拆解爲知識地圖，逐單元記錄掌握度，安排每日任務，並提供一個學生可見進度的網頁面板。

它是什麼¶

該插件由 Ame-Choo 開發，提供兩套能力：

• 對話能力：提供 21 個 study_* 工具和「學習教練」agent 預設。這些工具僅在「學習教練」模式的作用域內可見。
• 網頁面板：掛載在 DSH Web 服務器上的 /study 路徑，包含八頁內容。

插件倉庫只包含代碼，不包含學習數據。數據默認存儲在本地。

核心功能¶

1. 知識地圖：支持大類/模塊/最小單元三層結構。畫布支持拖拽和縮放（Ctrl/Cmd + 滾輪）。每個單元掛載了網課和練習材料。
2. 掌握度記錄：支持六檔（沒接觸過/見過/能跟做/能獨立做/熟練穩定/能講明白）。必須掛證據（如哪次自評、哪道題、哪張照片）。證據不等於分數，是可追溯的記錄。
3. Web 面板：路徑 /study。包含今日任務、知識地圖、資料圖譜、檔案、資料、工具、對話八頁。面板頂部有體檢卡，提示當前最該動哪兒。
4. 輔助工具：每日任務排程、錯題本、記憶卡（艾賓浩斯）。

安裝與啓用¶

插件通過 npm 安裝。

pnpm add dsh-study-coach

先決條件：
* DSH >= 0.2.0-rc.1
* Node >= 22.13.0

安裝後必須重啓 DSH 才能生效。

典型用法¶

1. 在 DSH 裏開一個「學習教練」模式的會話。
2. 說清學什麼、要掌握到什麼程度、每天能學多少分鐘、最晚什麼時候。
3. 把材料丟給它，說一句「讀一遍」。它會登記、通讀、畫地圖。
4. 在面板上查看今天要做什麼，做完跟教練說一聲。

數據與維護¶

• 存儲位置：默認存放在 ~/.dsh/study-coach/。
• 環境變量：可通過設置 DSH_STUDY_ROOT 環境變量修改數據根目錄。
• 數據獨立性：數據獨立於代碼，卸載、升級、重裝不會丟失。

注意事項¶

• 作用域：工具只掛在「學習教練」模式的作用域裏，其他會話看不見。
• 面板訪問：面板裏點「打開」，不在已登記材料範圍內回 404，已登記但盤上找不到回 410。
• 證據要求：掌握度檔案每條判斷必須掛證據。

生態¶

該插件遵循 MIT 協議。可通過 GitHub 獲取源碼。