前言¶

在 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