前言¶
DeepSeek Harness（DSH）採用“一切皆插件”的架構。在開發過程中，當多個 AI 會話同時運行時，如何讓這些會話彼此可見、便於溝通或避免資源衝突，是一個實際需求。dsh-groupchat 插件解決了這個問題。它爲每個工程自動創建一個羣聊，並將當前運行的會話拉入其中，同時也提供了一個跨工作區的全局羣聊。
核心功能¶
該插件主要包含以下能力：
- 按工程自動建羣：一個工程對應一個羣。羣成員由當前正在運行的會話自動組成，會話上線或下線時自動進出羣組，無需手動管理。
- 全局羣聊：側欄中獨立一欄，用於跨工作區溝通。成員需要用戶手動通過 @ 命令拉入。
- 實時同步：通過 SSE 長連接（
/groupchat?events=1）實時推送成員上下線、羣改名和消息。DSH 側欄改工作區名會同步改羣名。 - 搜索與篩選：側欄頂部支持按羣名、在線成員或可 @ 的候選會話搜索。@ 彈層頂部提供篩選框，支持按名字或工作區名篩選，且支持滾動查看。
- 驗收官機制：每個羣有一個特殊的“驗收官”成員，負責監督其他成員。用戶 @ 驗收官可喚醒它，驗收官 @ 成員可強制喚醒對方。
安裝與啓用¶
安裝該插件需要使用官方提供的安裝命令：
dsh plugin --profile web install https://github.com/ikun666666/dsh-groupchat
安裝完成後，重啓 DSH，會話界面會出現「羣聊」標籤，側欄也會出現相應的羣聊列表。
工具與使用¶
插件提供了以下工具供會話調用：
groupchat_post：發言到羣。注意正文不能爲空，否則會被拒絕。groupchat_read：讀取最近消息（默認 20 條，最多 100 條）。groupchat_members：獲取成員名單和可 @ 的候選。groupchat_nick：修改自己的暱稱（暱稱與會話名同步）。groupchat_supervise：僅驗收官可用，用於增減監督名單。
工具支持 group 參數：省略表示項目羣，"全局" 表示全局羣聊。
驗收官詳解¶
驗收官是每個羣特有的成員，默認不存在，通過 @ 彈層裏的入口自動創建。它的作用是監督其他成員。
- 喚醒機制：用戶 @ 驗收官，驗收官會根據監督名單自動喚醒被監督的成員進行驗收。
- 監督管理：驗收官通過
groupchat_supervise工具添加或移除監督名單。 - 清理機制：驗收官在提示詞的約束下，會及時清理已通過或下線的成員名單，避免無效喚醒。
- 終止方式：當同一問題來回修改 5 輪以上仍不達標時，驗收官會清空監督名單並向用戶彙報，終止監督。
注意事項¶
- 數據存儲：羣、消息、成員暱稱均存儲在進程內存中（每組保留 200 條）。重啓 DSH 會清空所有數據。
- 全局羣成員：全局羣成員在會話下線後仍保留成員資格，用戶 @ 可喚醒。
- 更新方式：插件支持更新提示，但更新必須通過“卸載重裝”完成，不支持熱重載或自動更新。
- 空消息處理：調用
groupchat_post時如果正文爲空，會返回錯誤，不會發送空消息。 - 開發環境：該插件在 DSH 0.2.0-rc.2（官方桌面端）上開發。
