DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。隨着社區插件數量增加，管理這些插件——包括查找、閱讀介紹、獲取安裝命令——變得較爲繁瑣。DSH 插件盒子是一個安裝在 Harness 網頁客戶端內的插件，它充當了一個插件市場。
該插件通過連接社區維護的 Oh-My-DSH 目錄，在 Web 界面中展示 GitHub 上的插件，提供中文簡介、按 star 排序、分類過濾和搜索功能，並允許用戶一鍵複製官方安裝命令。
功能概覽¶
DSH 插件盒子提供以下核心能力：
- 瀏覽與搜索：展示 GitHub 上的社區插件，支持按插件名、作者、倉庫全名、中文簡介或英文描述進行搜索。
- 信息呈現：提供中文簡介、許可證信息，並按 GitHub star 數從高到低排序。
- 目錄管理：從 Oh-My-DSH 拉取最新插件清單，支持分類過濾。
- 安裝輔助：點擊即可複製官方安裝命令，不直接執行安裝。
- 本地緩存：刷新後的目錄數據會保存在瀏覽器的 localStorage 中，重啓客戶端後依然可用。
安裝¶
在終端執行以下命令安裝插件盒子。必須指定 --profile web 參數，因爲該插件運行在網頁客戶端環境中。
dsh plugin --profile web add github:boyuan623-coder/deepseek_harness_plugin_box
如果是從 Harness 源碼目錄啓動，請使用：
pnpm dsh plugin --profile web add github:boyuan623-coder/deepseek_harness_plugin_box
安裝完成後，必須完全退出並重新打開 DeepSeek Harness 的網頁客戶端（或桌面客戶端），才能在界面中看到插件盒子。
使用方法¶
打開面板¶
安裝成功後，可以通過以下兩種方式打開插件盒子面板：
- 側欄入口：點擊左側欄底部或設置按鈕附近的「插件盒子」（摺疊狀態下爲藍鯨盒子圖標）。
- 設置入口：打開「設置」→ 左側選擇「插件」→ 頂部點擊「插件盒子」。
面板頂部會顯示當前收錄的插件數量及最後一次刷新目錄的時間。
瀏覽與篩選¶
- 排序：列表默認按 GitHub star 數從高到低排列。
- 搜索：在搜索框輸入關鍵詞，可匹配插件名、作者、倉庫全名、中文簡介及英文描述。
- 分類：點擊分類芯片可過濾當前列表，點擊「全部」顯示完整清單。
安裝社區插件¶
插件盒子只負責複製命令，不會在你的機器上直接安裝插件。
- 在插件卡片上點擊 「+ 複製安裝命令」。
- 將複製的命令粘貼到終端執行。
- 命令格式通常爲
dsh plugin --profile web add github:<作者>/<倉庫>。 - 執行完命令後，完全退出並重新打開客戶端，新插件纔會生效。
如果對方插件倉庫是 TypeScript 源碼，且需要本地構建，可能會遇到 pnpm 10 拒絕執行 prepare 腳本的問題。此時需在對應 profile 的 pnpm-workspace.yaml 中配置 allowBuilds，允許該包的構建腳本運行。
刷新目錄¶
點擊面板右上角的 「刷新目錄」，插件會向 Oh-My-DSH 拉取最新的 plugins.json。
刷新操作會執行以下邏輯：
1. 過濾出 type = 插件 的倉庫。
2. 更新已有插件的 star 數、簡介和許可證信息；若新簡介爲空，保留原有的中文簡介。
3. 將新出現的插件追加到列表中，不會清空現有列表。
4. 將合併後的目錄寫入瀏覽器的 localStorage（鍵名 dsh.plugin-box.catalog.v1）。
刷新需要聯網，且失敗時面板會提示原因，原有列表不會被刪除。
安全與注意事項¶
- 代碼運行環境：插件盒子本身不託管代碼，也不修改社區插件的源碼。你通過終端執行
dsh plugin add後，插件的代碼會在你的機器上運行。 - 權限與信任：安裝任何第三方插件前，請務必在 GitHub 上查看 README 和源碼。目錄數據來自 Oh-My-DSH，僅供參考，不構成官方認證。
- 緩存清理：卸載插件盒子不會自動清除緩存的目錄。如需重置目錄爲初始狀態，可在瀏覽器開發者工具中刪除
dsh.plugin-box.catalog.v1。
維護與構建¶
如果你是維護者，需要更新插件盒子內置的目錄數據，可以執行構建腳本：
node scripts/build.mjs
構建過程支持通過環境變量指定數據源：
OH_MY_DSH_PLUGINS：指向 Oh-My-DSH 的data/plugins.jsonPLUGIN_BOX_JSON：指向帶有中文簡介的清單文件
更多細節可參考 GitHub 倉庫。
