DeepSeek Harness 插件：localsummer/dsh-group-chat

在 DSH 的開發場景中，多個 AI 角色協作或模擬羣組對話時，通常需要頻繁切換主會話或手動管理上下文。localsummer/dsh-group-chat 插件提供了一個多模型角色羣組對話面板。它允許將不同的 provider 和 model 綁定到羣組內的角色上，並在羣內共享對話記錄。

該插件由 localSummer 維護，基於 MIT 許可證開源。

安裝與啓用¶

安裝前需確保環境滿足要求：dsh >= 0.2.0-rc.2，Node 版本需在 ^22.19.0 或 >=24 之間。

執行安裝命令：

    dsh plugin --profile web add github:localSummer/dsh-group-chat#main

也可以使用本地路徑開發：

    dsh plugin --profile web add link:$(pwd)

*注：本地路徑安裝後修改源碼需重建產物，通常需要重啓 `dsh web`。*

安裝完成後，必須重啓 dsh web（或 dsh --profile web）以加載插件。
確認掛載成功。運行以下命令查看配置：

    dsh --profile web --dump-config

在輸出中應能看到 `# == @roaming-ai/dsh-group-chat` 層，且包含 `id: group-chat`。

核心功能¶

羣組與會話管理¶

羣組管理：支持新建、重命名和刪除羣組。刪除操作需確認，且系統至少保留一個羣組。左欄提供搜索框，可按羣組名或會話名過濾。
會話目錄樹：每個羣組下包含多個會話，以“羣組 → 會話”的樹形結構展示。會話行名稱前有狀態點：進行中、等待確認（命令閘門）、已完成、已出錯。打開會話會清空“輸出完畢”標記。

角色與對話¶

角色-模型綁定：羣組內每個角色可綁定不同的 provider/model。配置項包括人設、標識色、Temperature、深度思考開關及推理級別。角色配置通過右側滑出抽屜進行。
羣內共享對話：所有消息對全羣共享。發言以“【角色名】內容”形式注入每個角色的上下文（最近 40 條原文），並流式顯示。
會話標題與主題：每輪結束後，後臺會用默認模型生成標題（格式：類別 emoji + 對象｜目標）和一句話摘要。手動改名或改主題後，該字段不再自動修改。
約束備忘：超過 40 條窗口後，舊消息後臺摺疊爲“已定 / 否決 / 未決”卡片，作爲結論備忘插入消息流折點。
多輪對話：發送前通過 chips 選擇本輪參與角色。發送後按順序自動多輪（1–10 輪），輪數有動畫展示。發送過程中下方顯示發言計劃進度軌道。

消息交互與渲染¶

渲染：支持 DSH 同款 Markdown 渲染（標題、列表、表格、代碼塊、公式）。開啓“深度思考”的角色發言帶有可摺疊行，流式時實時跟隨。
操作：用戶/角色消息懸停可複製、表情回應（膠囊常駐、點擊取消）。角色消息操作組末尾顯示總耗時。發言失敗會保留失敗卡，支持重試（原地覆蓋同一條）。
圖片輸入：支持上傳、粘貼截圖或拖拽圖片（PNG/JPEG/WebP/GIF）。文本框上方顯示縮略圖，發送後在氣泡外展示。圖片走 DSH 的 durable attachment 通道，僅存儲引用，不佔用羣聊存儲空間。
@點名：輸入 @ 彈出成員候選。@ 後繼續鍵入可在羣工作區檢索文件，插入 @path 芯片。

工作臺與工具¶

三區工作臺：左欄爲導航（搜索+目錄樹），中欄爲會話流（含色環頭像、模型徽章、絕對時鐘），右欄爲上下文（角色卡+工作區目錄）。左右欄可經接縫鈕收起。
羣組工作區目錄：每個羣組可指定一個目錄（羣級、全會話共享）。角色發言時自動讀取根下一層文本文件（白名單擴展名，最多 20 個，單文件 16k/總量 48k）注入系統提示詞的“共享資料”塊。
工具執行：設置工作區後，角色可調用 read_file / list_dir。權限檔位分爲三檔：
1. 僅可查看（默認）
2. 工作區內修改
3. 完全權限
  工作區內修改檔需逐條確認 shell 命令，完全權限檔免確認執行。

卸載¶

dsh plugin --profile web remove @roaming-ai/dsh-group-chat

卸載後，dsh web 需重啓。插件會話數據保留在 ~/.dsh/storages/group-chat/ 目錄中，卸載操作不會刪除這些數據。

數據存儲¶

數據存儲在 ~/.dsh/storages/group-chat/。目錄結構包含：
* ledger.json：羣組與會話的索引清單。
* <group-id>/：羣組專屬數據，包含 workspaceDir、roles.json 及 sessions/ 目錄。
* 會話文件爲自包含結構，支持原子寫入與損壞恢復。圖片附件僅存儲 durable 引用，實際文件存儲在 harness attachment 服務中。