前言¶
DSH 生態強調“一切皆插件”。在實際使用 DeepSeek Harness Web profile 時，第三方插件通常會通過 dsh plugin 安裝到某個 profile。插件裝好後，如果只是想臨時開啓或關閉它，手動維護 cordis.patch.yml 並不方便。
下面介紹 HamSamMike/dsh-mod-manager。它是一個面向 DeepSeek Harness Web profile 的第三方插件管理器，用於在設置頁集中啓用或禁用已安裝的插件。
這是什麼¶
dsh-mod-manager 是一個第三方插件管理器。它的核心職責是發現、啓用與禁用第三方插件，不會替你安裝或卸載其它插件。
它面向 DeepSeek Harness Web profile，在 Harness 設置頁中集中顯示已安裝插件的狀態，並支持通過頁面開關插件。修改後通常通過 Harness patch watcher 熱更新，通常無需重啓 dsh web。
項目許可證爲 MIT。
核心功能¶
dsh-mod-manager 提供以下已覈實的能力：
- 在 Harness 設置頁集中顯示第三方插件狀態。
- 自動發現通過
dsh plugin --profile … add …安裝到 profile 的第三方 bundle。 - 一鍵啓用或禁用插件，無需卸載插件包。
- 修改後通過 Harness patch watcher 熱更新，通常無需重啓
dsh web。 - 自動排除 Harness 核心 bundle 和管理器自身。
- 保留
config.mods，用於自定義名稱或補充無法自動關聯的插件行。 - 保留
cordis.patch.yml中與受管插件無關的用戶配置。 - 兼容空文件、純註釋文件和
[]空補丁數組。
安裝與啓用¶
先確認環境：
- 目標環境是 DeepSeek Harness Web profile。
- Node.js 版本爲
^22.19.0或>=24.0.0。 peerDependencies包含@deepseek-ai/cordis ^4.0.1與react ^18.2.0。- 需要管理的第三方插件已經安裝到同一個 profile。
從 GitHub 安裝：
dsh plugin --profile web add github:HamSamMike/dsh-mod-manager
安裝完成後重啓一次 Harness：
dsh web
也可以檢查插件是否已經進入最終組合配置：
dsh --profile web --dump-config
典型用法¶
以一個第三方插件 dsh-pet 爲例，先把它安裝到同一個 profile：
dsh plugin --profile web add dsh-pet
新安裝 bundle 後需要重啓一次 dsh web，它纔會進入 Loader，之後便會自動出現在管理器中。
打開 http://localhost:3080，進入 設置 → 模組管理，點擊目標插件右側的 開啓 或 關閉。
經過上面的步驟，頁面切換會通過 Harness patch watcher 熱更新，通常無需再次重啓 dsh web。
自動發現與配置¶
管理器會自動發現通過 dsh plugin --profile … add … 安裝到 profile 的第三方 bundle。
它會自動排除 Harness 核心 bundle 和管理器自身，同時保留 cordis.patch.yml 中與受管插件無關的用戶配置。
如果插件無法被自動關聯，或者需要自定義名稱，可以保留 config.mods。config.mods 用於自定義名稱，或補充無法自動關聯的插件行。
切換接口只接受當前自動發現或 config.mods 明確登記的 Loader 行 ID。
也可以在目標 profile 自己的 cordis.patch.yml 中覆蓋管理器配置，而不修改本倉庫。
重啓邊界¶
修改管理器自身配置或安裝新的 bundle 後，需要重啓一次 dsh web。之後通過頁面啓用或禁用插件時，不需要重啓。
新安裝 bundle 後需要重啓一次 dsh web 纔會進入 Loader；之後便會自動出現在管理器中。
安全邊界¶
- 只讀寫目標 profile 的
cordis.patch.yml。 - 自動發現範圍只來自目標 profile 明確登記的
dsh.profile.bundles，不會掃描任意node_modules。 - 不掃描插件目錄，不修改插件源碼，也不刪除已安裝的插件包。
- 兼容空文件、純註釋文件和
[]空補丁數組。
適用場景與注意¶
適合已經在 DeepSeek Harness Web profile 中使用第三方插件、希望減少手動編輯 cordis.patch.yml 的開發者。
由於插件以當前 dsh 進程權限運行，安裝前應先檢查源碼與許可證。項目許可證爲 MIT。
鏈接¶
GitHub：https://github.com/HamSamMike/dsh-mod-manager
目錄頁（來自項目線索）：https://www.skillhub.cn/plugins/HamSamMike/dsh-mod-manager
社區目錄爲獨立站點，並非官方應用商店。
