DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。對於開發者而言，從零構建一個插件涉及腳手架搭建、調試、環境驗證等多個環節，流程較爲碎片化。dsh-thunderforge 旨在將這些環節整合到一個單一 Bundle 中，提供一站式的開發支持。
核心能力¶
該插件包含五大核心模塊：
- thunderforge-capture：負責 LLM 載荷捕獲。通過透明代理、密鑰掩碼、密鑰輪轉以及
index.jsonl索引流，提供數據採集能力。 - thunderforge-skills：構建四層知識庫，包括入口索引、架構標準、坑點手冊以及畫像自適應表達。
- thunderforge-scaffold：提供對話式腳手架功能。包含三類零依賴模板，生成的骨架自帶冒煙測試，可直接驗證。
- thunderforge-debugger：實現雙數據源軌跡瀑布。將會話日誌與 capture 載荷按毫秒級對齊，便於調試。
- thunderforge-profile：提供 profile 管理與一鍵 dev preset 功能。該功能只新建環境，絕不觸碰既有配置。
安裝與啓用¶
通過官方 CLI 進行安裝：
dsh plugin --profile <profile名> add dsh-thunderforge
安裝完成後，需要重啓對應的應用（profile 在啓動時組合；如果是 Web 界面，需重啓 dsh web）以使插件生效。可以通過以下命令驗證是否加載成功：
dsh --profile <profile名> --dump-config
若需移除，可隨時執行：
dsh plugin --profile <profile名> remove dsh-thunderforge
典型用法¶
使用 dsh-thunderforge 可以串聯起完整的開發與調試流程：創建 → 開發 → 調試 → 環境驗證 → 發佈。
- 生成腳手架：通過對話式工具調用
thunderforge_scaffold，即可獲得帶有調試埋點與冒煙測試的插件骨架。 - 一鍵開發環境：生成一個 dev preset，將待測插件安裝進該隔離 profile 中，保證開發環境純淨。
示例對話指令：
dsh --profile <你的profile> 調用 thunderforge_scaffold ...
生成開發預設示例：
# 對話指令
幫我生成一個 dev preset，短名 demo
注意事項¶
- 層序提示：若將
dsh-thunderforge裝入已有的 profile，請務必將其放在該 profile 的package.json文件中dsh.profile.bundles數組的最前面（優先級高於@deepseek-ai/dsh-base）。這是capture模塊生效的關鍵。 - 上游協議：插件集成了多個上游組件（如
dsh-plugin-dev-skills、dsh-plugin-guide等）。對上游組件的權利主張始終以各上游協議原文爲準。特別是 Apache-2.0 組件，按協議要求需在文件級保留原協議與 NOTICE。
總結¶
dsh-thunderforge 提供了一套完整的 DSH 插件開發工具鏈，通過統一的 Bundle 解決了開發、調試與驗證的割裂問題。適合需要快速構建、調試和驗證 DeepSeek Harness 插件的開發者。
