前言¶
DeepSeek Harness(DSH)採用「一切皆插件」的擴展方式:裝得多了以後,客戶端設置裏往往是一長串平鋪列表。你想刪掉幾個不用的,卻看不出各自幹什麼、不敢刪,也不知道哪些其實早已閒置。社區裏也有 dsh-modpack 一類整合包,側重「打包帶走」;日常維護仍缺一個集中視圖。
插件工坊(倉庫名 dsh-plugin-studio,維護者 KERBALMans)是面向 DSH 桌面客戶端的插件,在瀏覽器裏提供單獨工作區,同時管理已安裝的插件和技能:三級自動分類、批量刪除(含重啓提示)、AI 大白話講解、最後使用時間、v1.0.8 起新增的「最近運行」檔位,以及一鍵打成 .tgz 分享。分類爲客戶端插件,當前 README 與 Release 對齊的版本爲 v1.0.8(2026-11-02 發佈)。
這是什麼¶
一句話:一個頁面管好 Harness 的插件和技能——分類 → 看懂 → 看使用記錄 → 批量刪,必要時再打包。
它是 dsh-modpack 的下一代定位:整合包負責帶走環境,工坊負責平時怎麼管。運行環境要求 Node ≥ 20、DeepSeek Harness ≥ 0.2.0-rc.1,許可證 MIT。倉庫在 GitHub 上當前星標爲 1(以目錄頁/倉庫頁爲準)。
核心功能¶
下面按 README 中「六個功能」歸納,只寫資料裏已說明的能力。
三級自動分類¶
每個插件和技能歸入 一級(大類)→ 二級(能力域)→ 三級(條目本身) 的樹形結構。一級共 8 類(實現於 lib/classify.js 的 FAMILIES):界面與交互 ui、工具與執行 tools、網絡與數據 net、模型與推理 model、會話與工作區 session、運維與診斷 ops、系統與內核 core、其它與待確認 other。other 是有歸屬的歸檔並附帶 evidence,不是「判斷失敗」。
分類採用加權評分,而非「第一條規則命中就定案」:作者聲明(PURPOSE)、代碼裏實際調用的服務(CAPABILITY,如 pluginManager、llm、tools)、以及環境性證據(AMBIENT)共同參與;同分時按更具體的類別優先,ui 排在最後。
複選框批量刪除與重啓提示¶
行首複選框支持多選,底部出現操作條;刪除前確認並列出將刪除的條目。刪除走宿主 pluginManager.removeBundle(),不是手刪目錄。返回的 application 爲 restart-required 時會說明原因(如無熱重載、包路徑變更、宿主模塊等)。官方底座、只讀或來源不明的行會鎖死複選框並給出不可刪原因。刪除串行執行,避免併發改寫 profile 依賴與 patch。
AI 大白話分析¶
點行內「講解」時,結合包內代碼(入口、dsh.bundle.patch、slots/tools 註冊等)、作者描述與 locale,以及按包名校驗後的 GitHub README 片段(緩存 7 天),輸出人話字段:what(幫你做什麼)、remove(刪了會怎樣)、why(依據)。提示詞要求先說用途再說刪除影響,避免堆術語。
最後使用時間¶
數據來自會話日誌(優先 sessionQuery,否則讀 ~/.dsh/sessions/**/session.v4.jsonl.zstd)。只有會話裏出現匹配該插件工具的 tool/call 纔算「最後使用」;僅在對話中被提到則單獨次要展示,不混入使用時間。多幀 zstd 日誌由 lib/usage.js 逐幀解壓處理。
v1.0.8:「最近運行」檔位¶
部分插件長期在後臺運行但不會出現工具調用(如壁紙、媒體透鏡、內建瀏覽器),會話側可能只剩「從沒用過」。v1.0.8 讀取宿主 <DSH_HOME>/logs/desktop-next-*.jsonl 最近 3 個文件,按 fields.pluginId 取最近活動時間;對同一 runId 丟棄啓動後 120 秒內的噪聲日誌;觀測結果寫入 usage-ledger.json,避免日誌輪轉導致時間倒退。展示優先級:最後使用 > 最近運行 > 常駐運行 > 從沒用過;懸停說明「只說明它跑過,不代表你調用了它」。資料記載掃描 3 個日誌文件約 77 ms。
技能管理與一鍵打包¶
第二個 Tab 管理技能,能力與插件頁對等:三級分類、搜索篩選、批量刪除、一鍵打包。技能從宿主配置的多個根目錄掃描(詳見倉庫 lib/skills.js)。打包生成 .tgz,便於分享或上傳;破壞性操作在資料中強調帶確認與 dryRun 設計(與 modpack 場景一致)。
安裝與啓用¶
先做兩件事:把 DeepSeek Harness 桌面客戶端 更新到支持插件市場的版本;確認本機 Node ≥ 20。
再在客戶端內安裝:
- 打開 Settings → Plugin Studio,一鍵安裝並啓用。
或從 Release 安裝文件包:
- 在 GitHub Releases 下載
dsh-plugin-studio-1.0.8.tgz,在客戶端中選擇從文件安裝。
資料未給出 dsh plugin add github:... 類 CLI 命令,以上兩種方式爲準。
典型用法¶
安裝並啓用後,在設置中進入插件工坊面板(README 截圖中爲三級樹 + 複選框 + 最後使用/操作列)。
- 理清清單:用樹形分類和搜索縮小範圍,區分長期不用與仍在用的條目。
- 不敢刪時先講:對單行點「講解」,看 AI 輸出的
what/remove再決定。 - 看活躍度:結合「最後使用」與 v1.0.8 的「最近運行」,避免誤刪後臺常跑但無 tool call 的插件。
- 批量清理:勾選多行後刪除,按提示決定是否重啓 Harness。
- 遷移環境:在插件或技能 Tab 使用一鍵打包,得到
.tgz後在目標機器按 DSH 方式安裝(上傳指引見倉庫docs/UPLOAD-GUIDE.md)。
需要自動化或二次集成時,README 還提供 HTTP 接口、數據存放路徑等章節,可在 GitHub 文檔中繼續查閱。
適用場景與注意¶
適合誰:本地已安裝較多 DSH 插件或技能、需要在刪除前理解用途、或需要定期整理與打包的 Harness 用戶與插件作者。
權限與安全:插件在當前 DSH 進程權限下運行,會讀取本機 profile、會話日誌、宿主運行日誌並調用刪除與 AI 分析等能力。安裝前應閱讀 源碼與 LICENSE,確認可接受 MIT 條款與數據訪問範圍。
生態說明:社區插件目錄(如 SkillHub 上的條目頁)爲獨立站點,與 DeepSeek / 幻方無官方從屬關係,不宜寫成「官方應用商店」。
CI 在 Windows / macOS / Linux 與 Node 20 / 22 / 24 上跑 9 組測試(smoke、analyse、routes、actions、ai 等),可作爲質量參考,但不替代你本機環境下的自行驗證。
結尾¶
插件工坊把「平鋪長列表」收成可分類、可解釋、可依據使用記錄決策、可批量刪除並打包的一條工作流;v1.0.8 用宿主運行日誌補上了「最近運行」,減少誤刪後臺插件的風險。
- 目錄頁:https://www.skillhub.cn/plugins/KERBALMans/dsh-plugin-studio
- 倉庫:https://github.com/KERBALMans/dsh-plugin-studio