前言¶
DSH（DeepSeek Harness）生態遵循「一切皆插件」的理念，其中 dsh-chat 負責會議室協議，dsh-weave 負責跨機消息傳輸。在搭建跨機協作的「多 agent 會議室」時，上游 dsh-weave 版本 0.1.0-rc.14 存在四個底層缺陷，導致羣聊不可用或功能受限。huahua-dsh-chatroom 插件旨在爲這些缺陷提供適配修復、機制研究、排障報告及維護路線圖，讓開發者能夠通過一條命令復現修復並持續演進。
這是什麼¶
這是一個由 azure5100 維護的 DSH 插件，定位爲 dsh-chat / dsh-weave 跨機羣聊的適配修復與運維文檔集。它通過提供四合一冪等補丁腳本、DSH 插件集成、可視化全景圖以及完整的機制研究文檔，解決了跨機會議室內聯調與運維中的具體問題。
核心功能¶
該插件主要包含以下能力：
- 跨機羣聊與文件傳輸：基於
dsh-chat和dsh-weave實現跨機羣聊，並實現了跨機文件傳輸功能（R1 里程碑），支持附件引用協議與雙向文件互傳。 - dsh-weave 適配修復：針對
dsh-weave0.1.0-rc.14的四個缺陷提供修復方案：- Fix1：修復未注入
dshBridge服務時的異常拋出。 - Fix2：修復 UDP 端口隨機漂移問題，固定綁定端口
64605。 - Fix3 & Fix4：修復歷史消息拉取時的幀限制問題，將響應上限從 64KB/4KB 提升至 4MB。
- Fix1：修復未注入
- 四合一冪等補丁腳本：提供
patch-weave.ps1，支持一鍵應用所有修復，具備冪等性（重複執行自動跳過）和語法校驗功能。 - DSH 插件集成：提供
dsh.bundle格式的插件包，支持自動守護補丁狀態，並提供 Agent 工具與 Host RPC 接口。 - 機制研究與文檔：包含機制研究文檔、排障證據鏈（集成報告、復盤報告、專項報告）以及單文件可視化全景圖。
安裝與啓用¶
使用前需確保已安裝 DSH 及其依賴的三件套（dsh-chat, dsh-weave, dsh-bridge），且 Node.js 版本不低於 22.19.0。
安裝插件¶
通過官方插件目錄安裝：
dsh plugin --profile web add github:azure5100/huahua-dsh-chatroom
啓用與配置¶
安裝完成後，插件會自動檢查並應用 dsh-weave 的修復補丁。如果目標版本未打補丁，插件會自動備份並應用 Fix1–Fix4，隨後提示重啓 DSH Web Profile 以使配置生效。
典型用法¶
安裝並重啓後，可以使用以下工具與接口：
- 查詢補丁狀態
查看當前環境是否已應用 Fix1–Fix4。
chatroom_patch_status
- 手動應用補丁
如果環境發生變化（如手動升級了依賴），可手動觸發補丁應用。
chatroom_patch_apply
- 訪問 Host RPC
通過 HTTP 接口查詢狀態或補丁信息。
curl http://localhost:端口號/dsh-chatroom status
curl http://localhost:端口號/dsh-chatroom patch
適用場景與注意¶
- 適用場景：需要進行跨機 DSH 羣聊的開發者、運維人員，以及需要排查和修復
dsh-weave跨機傳輸問題的團隊。 - 版本兼容性：插件依賴的目標
dsh-weave版本爲0.1.0-rc.14。插件以 MIT 許可證發佈。 - 依賴與衝突：
- 插件依賴
@deepseek-ai/cordis,@deepseek-ai/dsh-tools,@deepseek-ai/dsh-typert-protocol,@deepseek-ai/schemastery。 - 插件的 Loader 行 ID 爲
dsh-chatroom-kit，需確保該 ID 在項目中唯一，避免與dsh-chat、dsh-weave、dsh-bridge衝突。
- 插件依賴
- 代碼合規：插件提供了完整的上游核心代碼快照（
upstream-patched/），並明確標註了 MIT 歸屬與修改說明，允許開發者查看全部代碼。
總結¶
huahua-dsh-chatroom 是一套針對 DSH 跨機羣聊環境的補丁與運維工具集。它解決了上游 dsh-weave 的關鍵缺陷，提供了從手動腳本到自動插件的一體化解決方案，並輔以詳盡的機制研究與文檔。對於希望在 DSH 生態中構建穩定跨機協作環境的開發者，這是一個可以直接落地的參考實現。
