前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”，其社區生態獨立於 DeepSeek 官方。在實際使用中，開發者往往需要手動逐個安裝和配置社區插件，流程繁瑣且容易出錯。dsh-bundles 旨在解決這一問題，提供按人設分類的標準化工具集，支持一鍵安裝、預覽與安全卸載。
插件介紹¶
名稱：dsh-bundles
倉庫：lm20230311/dsh-bundles
定位：DeepSeek Harness 的精選人設插件包。
維護者：LM20230311。
解決痛點：手動管理多個插件的依賴關係與版本衝突，提供經過篩選的、按角色（如開發者、設計師）分組的插件組合。
核心功能¶
- 人設插件包：內置 6 個精選工具包，涵蓋開發者、創作者、設計師、學生、研究人員及趣味場景，並包含 29 個社區插件。
- 一鍵工作流：支持卡片式預覽、一鍵安裝、安全卸載及實時安裝進度查看。
- 插件詳情：可查看每個插件的安裝來源、倉庫鏈接及市場元數據。
- 安全恢復：安裝時會跳過已安裝的包，保留預存在的共享包；若安裝失敗，系統會自動回滾到之前的狀態。
- 共享目錄：提供經過驗證的社區插件目錄，確保插件來源可靠。
安裝與啓用¶
通過官方命令行安裝插件：
dsh plugin --profile web add dshbundles
安裝完成後，需要重啓 dsh web，然後打開 Settings → Plugin Bundles 即可使用。
典型用法¶
安裝特定人設包¶
npx -y dshbundles@latest install developer --profile web
安全卸載包¶
npx -y dshbundles@latest uninstall developer --profile web
接管遺留安裝¶
如果某個安裝未在 UI 中被管理，或需要將手動安裝的包納入統一管理，可以使用接管命令：
npx -y dshbundles@latest adopt developer --profile web
查看安裝狀態¶
# 列出所有包
npx -y dshbundles@latest list --profile web
# 查看特定包的狀態
npx -y dshbundles@latest status developer --profile web
源碼測試安裝¶
在發佈前，若需測試源碼，可以使用以下命令：
dsh plugin --profile web add --allow-build=dshbundles github:LM20230311/dsh-bundles#main
適用場景與注意¶
適用場景：需要快速搭建特定工作流（如全棧開發、UI 設計）的開發者，或希望批量管理插件的 DSH 用戶。
注意事項：
* 插件以當前 DSH 進程的權限運行。在安裝前，務必檢查源碼與許可證，確保符合安全規範。
* 安裝操作會在目標配置文件中寫入一份所有權賬本，路徑爲 .dsh-bundles/state。
* 卸載操作僅移除該包獨家安裝的插件，不會刪除預存在的包或被其他包引用的共享插件。
* 默認 pnpm 命令超時時間爲 3 分鐘，網絡較慢時可設置環境變量 DSHBUNDLES_PNPM_TIMEOUT_MS 調整。
* 安裝後需重啓 dsh web 並在設置中刷新插件列表。
總結¶
dsh-bundles 通過標準化的管理流程，降低了接入 DeepSeek Harness 生態的門檻。它不僅提供了精選的插件組合，還通過安全機制保障了依賴管理的穩定性。項目主頁與插件市場目錄位於 dshbundles.com。
