前言¶

在 DeepSeek Harness（DSH）裏學一門主題，常見做法是直接開聊、讓模型逐段講解。難點在於：前置知識是否齊全、學到哪一步、哪些點需要複習，往往要靠你自己記在筆記裏，和對話進度也容易脫節。

dsh-talent-tree 是社區維護者 a961282799-crypto 發佈的工作流類插件（npm 包名 dsh-talent-tree，當前版本 0.5.0，MIT 許可證）。它把一句學習目標拆成帶前置關係的天賦樹，並通過講解或小測記錄掌握程度；節點按銅、銀、金三檔點亮，進度跨對話保存在本地 JSON 中。下面介紹定位、安裝與典型用法。

這是什麼¶

插件全稱對應倉庫 a961282799-crypto/dsh-talent-tree，在 SkillHub 目錄中歸類爲工作流。一句話定位：DeepSeek Harness 插件，把想學的知識拆成遊戲式天賦樹，學會一個點亮一個。

Host 端通過 techtree_plan、techtree_record、techtree_view 三個工具與模型協作；前端提供左側欄「天賦樹」、對話右側邊欄視圖、可平移縮放的樹圖，以及 composer 下方的進度徽章。全局掌握程度寫在 ~/.dsh/techtree/knowledge.json（若設置了 DSH_HOME，則在 $DSH_HOME/techtree/）。

核心功能¶

天賦樹生成與節點信息¶

對用戶說出學習目標（例如「我想學會拉格朗日中值定理」）後，模型調用 techtree_plan(goal_id, nodes[]) 生成或擴展樹。每個知識點帶有：

• 鉤子（hook）：一句最能勾起興趣的公式、想法或問題（如中值定理相關的勻速直觀）。
• 白話說明：只使用當前層級已學內容解釋，符號在詳情卡「符號說明」中有對應解釋。
• 類型與外形：概念、定理、方法、證明思路、技能、目標等類型在畫布上有不同卡片形狀與圖例。

公式由模型寫成 LaTeX（$…$），與聊天區共用 KaTeX；導出 PNG 時轉爲 Unicode 顯示。

學習路線、檢驗與點亮¶

• 綠色「推薦」標籤標出當前最宜學習的節點；可「按路線學」或「跳級挑戰」綜合題。
• 掌握程度經 techtree_record(node_id, level 0-3, weak?, evidence) 記錄，須寫明證據；level 對應未掌握到金（會用）等等級。
• 節點狀態包括：鎖定的未解鎖、可學的藍框、銅銀金獎章、需加固的橙色標記、久未複習的提醒（銅 3 天、銀 7 天、金 21 天）。

界面與數據同步¶

• 左側欄「天賦樹」：列出所有學習目標，選中後右側顯示完整樹；數據從後臺 knowledge.json 讀取，約每 15 秒及切回窗口時刷新。
• 對話內：輸入框下進度徽章或右側引導頁「學習天賦樹」打開當前對話的樹；工具結果中的 meta 含天賦樹快照，經 techtree 會話投影推給前端，與對話記錄一致。
• 今日待複習：彙總久未複習與答題暴露的薄弱點，可在對話中逐項考覈。
• 導出：右上角可將整樹（含鉤子）存爲 PNG 並複製到剪貼板。

對模型的影響（README 說明）¶

系統提示詞增加固定教學規則（約 750 token）；三個工具的 schema 會註冊。天賦樹正文出現在工具結果中，不進入系統提示詞。插件無第三方依賴。

安裝與啓用¶

環境要求：DeepSeek Harness 0.2.1 及以上、0.3.0 以下（桌面版或網頁版均可）。

在 DSH 中新開對話，任選下列方式之一，讓 AI 通過 plugin_manager 的 install_bundle 安裝：

從 npm 安裝（推薦）

用 plugin_manager 的 install_bundle 安裝 dsh-talent-tree

從 GitHub 安裝

用 plugin_manager 的 install_bundle 安裝 github:a961282799-crypto/dsh-talent-tree

從本地文件夾安裝（開發改代碼時；路徑須爲從盤符開始的完整路徑，示例爲 Windows 風格）

用 plugin_manager 的 install_bundle 安裝 C:\路徑\到\dsh-talent-tree

命令行用戶也可執行：

dsh plugin --profile <profile> add dsh-talent-tree

安裝後 DSH 會自動重啓後臺。左側欄出現「天賦樹」、右側引導頁出現「學習天賦樹」即表示安裝成功；若未出現，完全退出桌面版再打開。

從舊包名 dsh-plugin-techtree / dsh-skilltree 升級時：先用 remove_bundle 卸載舊包，再安裝 dsh-talent-tree；進度路徑仍爲 ~/.dsh/techtree/knowledge.json，工具名不變。

換存儲位置可在 profile 的 cordis.patch.yml 中覆蓋（桌面版默認 ~/.dsh/profiles/desktop/cordis.patch.yml）：

- insert:
    - id: techtree
      name: dsh-talent-tree
      config:
        dataFile: /絕對路徑/knowledge.json

典型用法¶

1. 打開左側欄「天賦樹」，在頂部輸入學習目標（如「拉格朗日中值定理」），點「生成」。會新建對話並預填提示詞，自行發送後即可由模型生成樹。
2. 在樹上點節點的「開始學習」「檢驗我」，或右上角「繼續學習」，會在新對話中繼續（左側欄發起時需自己點發送）；在當前對話右側邊欄的操作會把提示詞發進當前對話。
3. 學完或答對後，由模型調用 techtree_record 點亮節點；跨對話已學節點會從 knowledge.json 複用狀態。在新對話中可說「打開我的拉格朗日中值定理天賦樹」，模型通過 techtree_view 傳入 goal_id 拉回進度。
4. 查看推薦點、按路線學習、跳級挑戰、今日待複習與 PNG 導出，均可在右側樹圖界面完成；平移、滾輪縮放、方向鍵與「適應窗口」等操作見 README「操作天賦樹」一節。

測試插件邏輯可在克隆後的倉庫中執行 npm test（需 Node 22+），與終端用戶安裝 DSH 插件無必然關係。

適用場景與注意¶

適合：有明確學習目標、希望看到前置依賴結構、並用對話講解或小測沉澱掌握程度的 DSH 用戶；數學或理工科主題較能發揮 LaTeX 與符號說明能力。

已知限制（來自 README）：

• 生成天賦樹後側邊欄不會自動彈出，需點進度徽章或從引導頁打開。
• 從左側欄發起學習會新建對話並填好提示詞，需手動發送。
• 在另一對話點亮的節點，當前對話要等下一次 techtree 工具調用或點「刷新」才更新。
• 界面文案主要爲中文與英文。

安全與權限：插件以當前 DSH 進程權限運行，會讀寫本機 knowledge.json 並通過桌面版登錄校驗暴露 GET /api/techtree/library。安裝前應查看 GitHub 源碼 與 MIT 許可證，確認符合你的使用環境。SkillHub 爲社區目錄站點，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-talent-tree 把「學什麼、先學什麼、學到哪一檔」收進一張可交互的天賦樹，並與 DSH 工具、側邊欄和本地知識地圖對齊。目錄頁：https://www.skillhub.cn/plugins/a961282799-crypto/dsh-talent-tree；源碼與完整說明：https://github.com/a961282799-crypto/dsh-talent-tree。