前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的 Cordis 架構。一個 DSH Web Profile 的最終結構，通常由插件、Group、cordis.patch.yml 和運行時 Loader 狀態共同決定。直接閱讀 YAML 時，不一定能快速回答：當前實際加載了哪些插件、插件在哪個 Group、哪些節點處於什麼狀態、一次配置覆蓋最終會形成怎樣的 Patch。
dsh-plugin-visual-composer 是一個運行在 DeepSeek Harness Web 界面中的社區插件。它把當前 Profile 的 Cordis 插件樹轉換爲可視化畫布，用於查看插件樹、添加草稿、調整覆蓋，並在保存前審閱脫敏後的變更。
這是什麼¶
下面介紹的 dsh-plugin-visual-composer 由 VanillaCreamer 維護，許可證爲 MIT。它是獨立社區原型，不是 DeepSeek AI 官方插件。
已覈實資料給出的版本信息爲：
- 包版本：
0.1.0 - 當前驗證的 DeepSeek Harness 版本：
0.1.0-rc.6 - Node.js：
^22.19.0或>=24.0.0 - 運行目標：DSH Web Profile
DeepSeek Harness 目前仍處於 Developer Preview，插件接口可能在後續 RC 版本中變化。
核心功能¶
查看當前 Profile 的真實插件樹¶
插件讀取當前 DSH Web Profile 的真實 Loader 樹，並展示嵌套 Group、插件狀態、模塊名、Entry ID、注入信息與配置。也可以按 ID、模塊名或 Label 過濾插件樹。
添加和編排草稿節點¶
可以從左側 Palette 添加插件或 Group 草稿，並將 Composer 管理的綠色節點拖入 Root 或任意 Group。對現有 Entry，可以創建 disabled 和完整 config 覆蓋。
保存前審閱脫敏 Diff¶
保存前會展示脫敏後的 Composer 管理塊 Diff。插件使用預覽簽名保證“審閱的草稿”和“實際寫入的草稿”一致，並通過樂觀 Revision、防併發覆蓋和原子替換寫入配置。
熱更新、備份與回滾¶
HMR 可用時，插件會等待根 Include 事務真正提交後再報告成功；HMR 拒絕或超時時，會自動恢復修改前文件。插件還會自動創建輪換備份，並支持在 Web UI 中一鍵回滾最近備份。
敏感配置保護¶
插件會對憑據、認證字段、!!js 表達式及敏感配置進行脫敏和編輯保護。已覈實資料說明，敏感配置不會直接下發到瀏覽器，包括 API Key、Token、Secret、Password、Authorization、Cookie、Credential、密鑰、認證 URL、!!js 表達式等。
安裝與啓用¶
安裝 Release tarball¶
從本倉庫 Releases 下載 dsh-plugin-visual-composer-0.1.0.tgz，然後安裝到 Web Profile：
dsh plugin --profile web add ./dsh-plugin-visual-composer-0.1.0.tgz
啓動 DSH Web：
dsh --profile web
從源碼構建¶
git clone https://github.com/VanillaCreamer/dsh-plugin-visual-composer.git
cd dsh-plugin-visual-composer
npm ci
npm run pack
構建後執行安裝和啓動：
dsh plugin --profile web add ./dsh-plugin-visual-composer-0.1.0.tgz
dsh --profile web
卸載¶
dsh plugin --profile web remove dsh-plugin-visual-composer
注意：卸載不會主動刪除歷史備份，也不會移除已寫入的 Composer 管理塊。
典型用法¶
- 打開 DSH Web。
- 進入
設置 → 插件 → Visual Composer。 - 在左側 Palette 添加已安裝模塊或 Group。
- 將綠色草稿節點拖到 Root 或目標 Group。
- 選中節點後，調整禁用狀態或配置覆蓋。
- 預覽變更，閱讀脫敏後的 Diff。
- 確認並保存。
- HMR 可用時，等待事務提交成功。
如果需要安裝第三方插件包，示例命令爲：
dsh plugin --profile web add <包名或本地路徑>
適用場景與注意¶
適合在 DSH Web 中維護當前 Profile 的 Cordis 插件樹，尤其是需要查看 Group 嵌套、Entry 狀態、配置覆蓋、備份回滾等操作的開發者。
使用它時需要注意：
- 該插件被設計爲僅限本機的高權限配置界面。
- 它會運行在 DSH 中，並可以修改當前 Profile 的插件配置；安裝前應檢查源碼、許可證和權限邊界。
- API 要求 TCP 對端爲 loopback，Host 爲
localhost、127.0.0.0/8或[::1]，Origin 一致，POST 攜帶 CSRF Token，並限制請求體大小。 - 插件僅維護
cordis.patch.yml中有明確標記的區域，保留其他文本與註釋。 config覆蓋是完整替換，不是深度合併；提交前需要確認完整配置。- DeepSeek Harness 目前仍處於 Developer Preview，插件接口可能在後續 RC 版本中變化。
結尾¶
dsh-plugin-visual-composer 的價值，在於把 DSH Web Profile 的 Cordis 插件樹從“讀 YAML”變成“查看畫布、審閱 Diff、安全保存和回滾”。
已覈實資料未提供可確認的社區目錄頁 URL，本文不將其作爲有效鏈接。倉庫地址爲：
- GitHub：https://github.com/VanillaCreamer/dsh-plugin-visual-composer
