前言¶
在 DSH（DeepSeek Harness）裏用 AI 學一門技術，常見流程是：第一輪對話生成一份看起來完整的計劃，幾輪之後模型仍像在講第一章，而你其實已經問過「學到哪了」。根因往往是學習狀態綁在聊天上下文裏，換會話、換模型或斷線重連後沒有統一續點。
dsh-skill-learning-coach（npm 包名同名）是 wanlte 維護的 DSH 插件，SkillHub 分類爲「記憶」。它把路線與進度落到工作區 JSON，用「撤掉提示後的獨立產出」判斷某節是否學會，並把卡殼點只追加存檔，下次開場先引用。路線在原生設置卡里改，不靠 AI 在對話裏「凍結一份計劃」。
這是什麼¶
一句話：會記住你卡在哪的 DSH 學習陪練——路線圖在設置裏維護，狀態在磁盤上，學會了 由你不看資料也能做出來的事說了算，而不是模型一句誇獎。
插件由三塊組成：
| 塊 | 職責 |
|---|---|
| 設置卡 | 改學習路線與學習方法；設置 → 側邊欄一級「學習路線」 |
| host 半 | 經 /learning-coach/api 讀寫工作區狀態 |
| skill bundle | AI 按真實進度帶練；每輪只讀當前節點 |
適合：有明確目標（求職、考試、轉行、興趣）但容易「看完就忘」、需要跨會話續學的人。不適合：只要靜態計劃表，或希望 AI 一口氣講完整門課的人。
許可證 MIT；當前 npm 版本 0.2.3（以 package.json 與 npm 徽章爲準）。GitHub 倉庫星標約爲 1（目錄頁數據，可能變動）。
它解決什麼¶
下面是與「常見 AI 家教」對照後的核心設計，均來自倉庫 README：
- 狀態外置：
<工作區>/learning/framework.json爲唯一真源；換會話、換模型、斷線重連從同一文件續。 - 無提示產出纔算過：AI 先撤提示，由你獨立做出
mastery描述的動作；若仍要答案則標gap，該節重學。 - 卡殼檔案只追加：
misconceptions只追加、不由 AI 清空；下次開場必須引用。 - 按目的定達標：
purpose區分工作 / 考試 / 興趣 / 轉行，達標動作形態不同（可運行產物或限時真題等）。 - 資料優先：先讀你手上的教材、課件、鏈接；學習頁只寫讀哪幾段、讀到什麼算夠、自測與達標動作，原理歸來源。
- 節小到能收口：單節約 15–25 分鐘，便於在無提示產出場景下堅持。
節點 status 狀態機：pending → 問完 assumed-known → 說沒懂 gap → 出學習頁 drafted → 無提示產出 done。
安裝與啓用¶
桌面版與網頁版按平臺選擇 --profile；沒有本地 dsh 時可用 npx。
# 桌面版 / 網頁版，按平臺換 --profile
pnpm dsh plugin --profile desktop add dsh-skill-learning-coach
pnpm dsh plugin --profile web add dsh-skill-learning-coach
# 沒有本地 dsh 命令時
npx @deepseek-ai/dsh plugin add dsh-skill-learning-coach
裝好後重啓 DSH：host 半與客戶端 bundle 需重啓才加載；之後若只改 skills/ 下 Markdown，不必重啓。
驗證：設置側邊欄應出現與「模型」同列的一級項「學習路線」。沒有該項則說明未正確加載。
開發插件本體時可用本地鏈接（路徑按你本機倉庫位置替換）：
pnpm dsh plugin --profile desktop add link:F:/work/dsh-skill/dsh-skill-learning-coach
倉庫公開時 README 亦提到可用 github:wanlte/dsh-skill-learning-coach 直裝，但安裝側需放行構建腳本並本地構建一次；日常用 npm 安裝通常更快。
卸載：
pnpm dsh plugin --profile desktop remove dsh-skill-learning-coach
卸載不會刪除工作區裏的 learning/framework.json 與講義，需自行清理。
權限說明：插件以當前 DSH 進程權限運行，安裝前建議閱讀 GitHub 源碼 與 MIT 許可證，確認讀寫工作區路徑的行爲符合你的安全預期。
典型用法¶
第一次：在對話中說「我想學 X」。流程會給出編號選項，回數字即可——包括目的（1 求職 / 2 考試 / 3 興趣 / 4 轉行，並補充崗位或考試名與期限）、現狀、過去一週真實學習分鐘數、手頭資料等。隨後生成知識框架並落盤，輸出 learning/路線圖.html，再按框架逐塊提問。默認假設你已懂；若某點沒懂，只標紅該節點。
之後每次：說「繼續學」。只讀當前節點，先引用上次卡殼，給行動清單，再按所選學習方法帶練：你先做 → 卡住時給階梯提示（方向 → 半個步驟 → 答案）→ 撤掉提示，要求獨立產出該節的 mastery。
一節收口：彙報路線位置、本頁學習頁路徑、下一節第一個動作，並提醒可開新會話；狀態在盤上，斷了能續。
設置卡里可改目的與每週真實時間；對路線樹增刪、選爲當前、標沒懂；編輯每節資料與達標標準；在 8 張學習方法卡中單選或自定義。AI 在會話裏落盤後，設置卡約 3 秒內自行刷新。
狀態文件與產物¶
工作區 learning/ 下三類產物（路徑均相對於當前會話工作區）：
| 路徑 | 作用 |
|---|---|
learning/framework.json |
目的、每週分鐘、方法、當前節、整棵框架樹 |
learning/講義/<YYYY-MM-DD>-<節點標題>.md |
單次一頁：資料索引 + 自測，不批量生成 |
learning/路線圖.html |
離線快照：進度、當前節點、達標動作與資料位置；框架變化後重生成 |
framework.json 中 mastery 須是可驗證動作（「讀完某章」「理解某概念」不得落盤）。materials[].locator 須細到能一步翻到章節、頁碼或段落；materials[].enough 須寫清讀到什麼程度算夠。寫盤走原子寫（.tmp 再 rename）；半截 JSON 會報明確錯誤，不靜默重置。
學習方法內置 8 張卡：費曼技巧、主動回憶、間隔重複、交錯練習、番茄鍾 + 刻意練習、SQ3R 精讀、康奈爾筆記、自定義。間隔重複的複習日由 AI 按固定表計算（達標當日 +1 / +3 / +7 / +14 / +30 天），無後臺調度進程。
有意不做的能力¶
README 明確列出不包含：錯題本與掌握度打分、批量生成整套講義、多學習者檔案、聯網抓取需登錄或付費資料、本地服務與賬號雲同步等。設置卡是編輯入口，HTML 路線圖是同一份數據的離線視圖。
結尾¶
若你希望 DSH 裏的學習不是「每輪重放一整段計劃」，而是路線可編輯、進度可遷移、學會了 有可驗證動作，dsh-skill-learning-coach 把這三件事拆到設置卡、host 路由與 skill bundle，狀態落在 framework.json。
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/wanlte/dsh-skill-learning-coach
- GitHub：https://github.com/wanlte/dsh-skill-learning-coach
- 英文說明：README.en.md
