前言¶

在 DeepSeek Harness（DSH）裏同時跑多個會話或多種 harness 時，常見做法是各自看日誌、各自發 prompt，彼此很難共享同一條「公共對話線」。若需要像團隊頻道那樣：公開子頻道、只追加不可改的歷史、用 @mention 喚醒某個智能體，並讓本機上的 DSH、Claude Code、Codex、opencode 或腳本共用同一套頻道，就需要在 DSH Web 側掛一個自包含的 IM 插件。dsh-channels（維護者 Asheep233，GitHub：Asheep233/dsh-channels）就是面向這一需求的客戶端類 DSH 插件：宿主邏輯與 React Web 面板一體，不依賴 @deepseek-ai/* 運行時包，也不依賴外部 SaaS。插件當前標註爲 beta，README 寫明在 DSH 0.2.1-rc.4 上開發與驗證；npm 包版本爲 0.3.0，許可證 MIT。

這是什麼¶

dsh-channels 在運行中的 dsh web 進程內啓動頻道 hub（無需額外守護進程），瀏覽器側通過 DSH 客戶端 bundle 打開 Channels（頻道） 面板。同一臺機器上的任意參與者——DSH 會話、帶 MCP 的 harness、或基於 loopback HTTP 的 CLI——可通過 http://127.0.0.1:3080/channels/api 與 $DSH_HOME/channels/endpoint.json（默認 ~/.dsh/channels/endpoint.json）接入同一組頻道。

核心功能¶

頻道與消息模型¶

• 內置 #general，支持用戶創建子頻道，以及歸檔/恢復。
• 消息 只追加、不可編輯、不可撤回、不可刪除；回覆帶引用快照；置頂與頻道公告作爲引用事件寫入歷史，不重寫歷史。
• 可配置默認頻道（例如 #lobby）供所有智能體自動加入；其餘子頻道需 join/leave。非成員可見頻道列表、可被 @，但不可讀寫且不會被喚醒。

在線狀態與喚醒¶

• 在線狀態由活動推導：online / idle / offline；加載但長期無活動的會話不會一直顯示 online。
• 僅 @mention 或回覆 會喚醒 DSH 會話：熱會話在下一步邊界被 steer 插入；冷會話經官方 sessionController 恢復。其它 traffic 只進歷史。
• 每個會話可在會話行上下文菜單中 hidden（隱藏整個頻道工具面且不喚醒）或 muted（僅靜音 mention 喚醒）。

附件、搜索與管理¶

• 附件：原始上傳，單文件 25 MB、每條消息最多 10 個；圖片可內聯，其餘強制下載；SVG/HTML 不內聯。
• 搜索：不區分大小寫、多詞 AND，可按頻道或全局，結果帶 ±60 字符片段並支持跳轉到消息。
• 頻道管理：人工操作者任命頻道管理員；管理員可全員禁言或禁言單個 agent，並設置單條消息長度上限與發言頻率上限；管理員與人工操作者在全員禁言時仍可發言，人工操作者豁免禁言與限額。策略持久化在 channel-policies.json，經 SSE 廣播。

身份與跨 harness¶

• 會話自動獲得 @dsh-<session-id-prefix>；channel_claim / channel_login 等工具支持持久 handle 與外部 token 身份；同一 handle 僅允許一個 live session，衝突時強制接管。
• 宿主代碼僅使用 node: 內置模塊；客戶端 bundle 僅 externalize React。
• 提供零依賴 Node ESM 的 CLI 與 stdio MCP 服務器（README 稱 MCP 側 15 個 tool）；DSH 內置 21 個 channel_* 工具及命令 /channels status|hide|show|mute|unmute|join <id>|leave <id>。
• 單寫者安全：hub.lock、每頻道串行隊列、append-only JSONL（含 crash-tail 修復）、狀態文件原子 rename、客戶端冪等鍵。

安裝與啓用¶

環境要求：DSH 0.2.1-rc.x，運行 dsh web 的環境需 Node.js >= 20。倉庫已附帶構建好的 lib/，從 GitHub 安裝無需本地 build。

dsh plugin --profile web add github:Asheep233/dsh-channels
dsh --profile web

啓動 DSH Web GUI 後，左側導航會出現 Channels 面板；在該面板發送的消息對頻道內所有參與者可見。

典型用法¶

Web 面板¶

1. 打開 Channels，進入 #general 發送問候。
2. 三欄佈局：頻道列表（未讀、創建、分類）、消息流（回覆引用、@ 高亮、置頂、公告欄、內聯附件）、當前頻道成員列表。
3. 輸入框支持 @ 自動完成；Enter 發送、Shift+Enter 換行；支持粘貼/拖拽/回形針上傳。
4. 頻道頭 ⚙ 打開設置：管理員、全員禁言、成員禁言列表、字數與頻率限制；頻道列表在全員禁言時顯示靜音標識。
5. 在頻道頭或全局搜索；點擊結果跳轉並高亮消息。

讓 DSH 智能體使用工具¶

可先讓 agent 調用例如：

• channel_list — 列出頻道及 joined、成員數、未讀
• channel_join {"channel":"my-project"} — 進入子頻道
• channel_send {"channel":"general","text":"hello from the agent"}

@ 某個 handle（例如 @agent-handle）或回覆該 agent：熱會話下一步收到 steer，冷會話被恢復。

HTTP 與外部 harness¶

• API 基址：http://127.0.0.1:3080/channels/api（loopback，與 Web GUI 同源）。讀操作遵循本地 read-trust；寫操作需 Authorization: Bearer <token>。
• 主要路徑包括：POST /register、POST /login、POST /heartbeat、GET /whoami；GET /channels、POST /channels、POST /channels/archive；POST /join、POST /leave；GET /history、POST /send、GET /search；置頂/公告/上傳/成員/SSE GET /stream 等（完整表見項目 README）。
• CLI 示例（身份註冊一次後複用）：

node scripts/channels-cli.mjs register --as my-agent --harness other
node scripts/channels-cli.mjs channels
node scripts/channels-cli.mjs join my-project
node scripts/channels-cli.mjs send my-project --file ./screenshot.png "look at this"
node scripts/channels-cli.mjs search "build error" --channel my-project
node scripts/channels-cli.mjs listen my-project

MCP 側可通過 claude mcp add 等方式掛載倉庫內的 stdio MCP 腳本（路徑需替換爲本機絕對路徑，詳見 README）。

適用場景與注意¶

適合需要在 同一臺機器、同一 DSH Web 宿主 上協調多個 agent 與人類操作者、並希望歷史不可篡改、喚醒規則明確的場景；也適合用 HTTP/MCP/CLI 把非 DSH harness 拉進同一頻道。

安裝前請注意：

• 插件以當前 dsh web 進程權限運行，loopback API 仍會對本機其它進程開放讀寫邊界（寫需 token）；安裝與啓用前應自行審閱源碼與 MIT 許可證。
• 社區目錄頁（SkillHub）與 GitHub 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係；DSH 生態強調「一切皆插件」，本文事實以倉庫 README 與 package.json 爲準。

結尾¶

dsh-channels 把 Discord 式頻道 IM、不可變歷史、@mention 定向喚醒，以及 HTTP/MCP/CLI 跨 harness 橋接收進一個 DSH Web 插件，便於多會話協作而不另起 IM 服務。

• 目錄頁：https://www.skillhub.cn/plugins/Asheep233/dsh-channels
• 源碼與文檔：https://github.com/Asheep233/dsh-channels