前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”，社區開發者可以通過組合不同的技能來實現複雜的工作流。dsh-project-based-learning 是其中一個專門面向教學場景的技能組合。它的設計目的是解決 AI 輔導中常見的兩個問題：一是知識傳授與學科內容混在一起，導致難以通用；二是隻講理論不實踐，或者只讓學員看示例而不動手。這個插件將教學協議與學科知識分離，旨在提供一個通用的“項目制教學教練”框架。
核心功能¶
該插件主要提供以下能力：
- 項目制教學教練：圍繞學習者想要完成的作品組織教學，而不是先甩出一堆知識點。
- 教學法與學科內容分離：教學邏輯位於
SKILL.md，學科知識位於可替換的領域導航中。這意味着你可以更換領域包（如從 Unity Shader 換到 Python 數據處理），而無需修改教學協議。 - 先教學，後實踐：陌生知識先講最小必要機制，讓學員理解後再回到真實項目中進行操作。
- 就地解釋：新概念、內置函數在首次使用處進行解釋，避免長篇大論的逐行翻譯或一次性灌輸整門學科。
- 狀態管理與遷移支持：支持記錄學習進度（
state.json），使用五檔描述性狀態（從“尚未接觸”到“已遷移到新任務”）。插件包含狀態校驗腳本和從舊版本遷移到新版本的有損遷移腳本。 - 零依賴，無構建步驟：插件不依賴複雜的構建環境，直接運行。
- 可替換領域導航：隨包提供 Unity Shader 和 Unity C# 的導航示例，這些是可刪除或替換的附加材料。
安裝與啓用¶
在終端中執行以下命令即可安裝。如果當前 profile 不是 web，請替換爲實際使用的 profile 名稱：
dsh plugin --profile web add dsh-project-based-learning
安裝完成後，需要重啓 DeepSeek Harness 才能加載新的技能。確認安裝成功的標誌是調用技能後，正文首行顯示“# 項目制教學教練 2.0”。技能是運行時註冊的，不會複製文件到本地技能目錄。
典型用法¶
安裝並啓用插件後，在 DSH 會話中直接輸入指令即可開始教學。
教學模式示例：
教學模式：我完全沒學過 <主題>，請評估我的水平
插件會自動選擇合適的教學車道（如快速教學、單次帶練或持續課程）。它會先判斷你的水平缺口，然後先講授當前必要的最小機制，再儘快帶你做出一個可觀察的結果，而不是先甩出一組診斷題。
適用場景與注意¶
適用場景：
- 需要從零開始學習新技能，但希望立刻動手實踐的學習者。
- 希望讓 AI 教練專注於“如何教”和“如何引導”，而不是直接代寫代碼的團隊。
注意事項：
- 不是題庫或刷題工具：領域導航只提供粗略依賴與門檻概念，不含診斷題庫或固定課時。
- 不是代寫工具：插件不會自動授權修改代碼或代寫項目。
- 第三方插件：本項目由社區開發者 Kirisame1969 維護，不是 DeepSeek 官方插件。
- 有損遷移：狀態遷移腳本會將舊數據壓縮爲 now/next/later，但不會保留數字能力等級，需要人工複覈。
- 環境依賴：插件依賴 Node.js 環境。
結尾¶
dsh-project-based-learning 提供了一套可執行的教學協議，將“講過”與“掌握”區分開來，強調實踐證據。對於希望構建自動化教學流程的開發者來說，這是一個將教學法與具體業務邏輯解耦的實用工具。更多細節和源碼可參考 GitHub 倉庫。
