MIT 开源的 DSH 插件 bundle,把微信、QQ、钉钉、飞书和 Telegram 接到 DeepSeek Harness:统一配置、扫码或 Bot 授权、附件内容提取,并在每个聊天里都能用宿主官方的斜杠指令。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-14
许可证
MIT
01它能帮你完成什么?
不用打开 Harness 窗口,直接在平时用的即时通讯里跟 DSH agent 对话
同一个 agent 可以从微信、QQ、钉钉、飞书和 Telegram 访问,全部在“设置 → 渠道”一个面板里配置与扫码授权
希望在手机和桌面上一直开着的聊天软件里拿到 DeepSeek Harness 回答的人
在聊天里直接把截图、PDF、表格和文档丢给 agent
支持视觉的模型直接识别图片,PDF / DOCX / XLSX 与文本附件会被提取内容供 agent 读取(入站单文件上限 100 MiB)
在聊天里收文件、希望 agent 就地处理的分析与客服人员
在聊天窗口里控制正在跑的 DSH 会话
宿主的官方斜杠指令在任何渠道会话里都能用——`/stop`、`/new`、`/help`、`/status`、`/version`、`/models`、`/model`、`/mirror` 和 `/bind`
在手机上发起长任务、需要在不开 Harness 界面的情况下查看、中止或重绑会话的用户
02如何接入 DeepSeek Harness?
前置条件
- `npx @deepseek-ai/dsh` 能跑起来,且 Harness Web 的普通会话能正常对话
- DeepSeek Harness `0.1.5-rc.2` 与 Node `22.19+`(README 指向 docs/compatibility-matrix.md 的版本对照表)
- 各渠道的平台凭据——QQ 的 AppID / AppSecret、钉钉的 clientId / clientSecret、飞书的 AppId / AppSecret,或 Telegram 的 Bot Token;微信不需要凭据,扫码登录即可
安装步骤
- 01
安装稳定版 bundle:`npx @deepseek-ai/dsh plugin --profile web add -w @wsz987/dsh-channels@latest`
$ npx @deepseek-ai/dsh plugin --profile web add -w @wsz987/dsh-channels@latest
- 02
确认 bundle 已合并进 profile:`npx @deepseek-ai/dsh --profile web --dump-config`
$ npx @deepseek-ai/dsh --profile web --dump-config
- 03
启动 Harness Web:`npx @deepseek-ai/dsh web`
$ npx @deepseek-ai/dsh web
- 04
在 Harness Web 打开“设置 → 渠道”,配置或登录需要使用的渠道,再完成“安全访问”设置
- 05
安装、更新和卸载都要保留 `-w` 参数;升级时先升 Harness,再更新插件
验证接入成功
- `npx @deepseek-ai/dsh --profile web --dump-config` 的输出里能看到该 bundle 已合并进 profile
- 在“设置 → 渠道 → 安全访问”确认谁能通过 Bot 使用本机 agent——没确认之前,渠道可能显示已连接,但消息进不了 agent
回滚
- `npx @deepseek-ai/dsh plugin --profile web remove -w @wsz987/dsh-channels`
03DSH 适配与能力边界
DSH 插件 bundle:用 `dsh plugin --profile web add -w` 装进 profile,在 Harness Web 的“设置 → 渠道”面板里统一配置与扫码授权
五个渠道适配器共用一个面板
每个平台的凭据或扫码登录(微信无需凭据;QQ、钉钉、飞书、Telegram 需要应用凭据或 Bot Token)→每个渠道账号一条活动会话,支持文本、图片与文件(微信只支持入站文件),QQ / 钉钉 / 飞书 / Telegram 支持流式回复
微信扫码后凭据自动持久化启动 Telegram Bot 时会调用 `deleteWebhook` 移除该 Bot 已配置的 webhook入站访问控制
“设置 → 渠道 → 安全访问”里的设置:识别我的账号、按群白名单,或显式开启“所有群组”→一份允许驱动本机 agent 的账号与群名单;不在名单里的消息进不到 agent
群聊默认关闭,允许的群要逐个手动添加附件内容提取
在渠道会话里发送的图片、PDF / DOCX / XLSX / 文本附件(入站单文件上限 100 MiB)→图片直接交给支持视觉的模型,文档则提取文本供 agent 读取
音频与视频只做降级处理,不是完整支持聊天内的官方斜杠指令
在任意渠道会话里输入的斜杠指令→由宿主命令系统执行——`/stop`、`/new`、`/help`、`/status`、`/version`、`/models`、`/model`、`/mirror`、`/bind`;未识别的指令直接提示“未知命令”,不会发给模型
`/stop` 会不等渠道排队消息,直接取消当前 agent`/model` 还会把当前模型写进 Harness 的全局默认模型,供后续新会话使用按渠道账号隔离工作区
`$DSH_HOME/profiles/web/cordis.patch.yml` 里的 `workspace.mode` 配置→默认按“渠道 / 账号”自动隔离各会话的文件;也可以改成 `host-cwd` 或 `disabled`
要改隔离方式只能编辑这个 patch 文件
04适合谁?何时不该用?
适合
- 希望在手机和桌面上一直开着的聊天软件里拿到 DeepSeek Harness 回答的人
- 在聊天里收文件、希望 agent 就地处理的分析与客服人员
- 在手机上发起长任务、需要在不开 Harness 界面的情况下查看、中止或重绑会话的用户
不适合
- 需要 DeepSeek Harness `0.1.5-rc.2` 与 Node `22.19+`;插件必须与 Harness 版本匹配,所以升级要先升 Harness 再更新插件,并且安装、更新、卸载都要保留 `-w` 参数。
- 不在安全访问白名单里的人发的消息进不到 agent,而此时渠道仍可能显示已连接;群聊默认关闭。渠道会话通常用 `Workspace Write`,只有确需访问 Workspace 外文件且信任当前任务时才启用 `Full access`。
- 各渠道能力不一致:微信只读入站文件(不能发文件、没有流式回复),音频和视频在所有渠道都只是降级处理。Telegram 需要 Bot API 10.2+ 且只支持长轮询,启动时会移除该 Bot 已有的 webhook,所以同一个 Bot 不能同时给别的 webhook 消费者用。
- 项目迭代很快,README 要求升级前备份数据;它是社区维护的渠道扩展,不是 DeepSeek Harness 或各消息平台的官方项目。
05兼容性、维护与安全提示
- 需要 DeepSeek Harness `0.1.5-rc.2` 与 Node `22.19+`;插件必须与 Harness 版本匹配,所以升级要先升 Harness 再更新插件,并且安装、更新、卸载都要保留 `-w` 参数。
- 不在安全访问白名单里的人发的消息进不到 agent,而此时渠道仍可能显示已连接;群聊默认关闭。渠道会话通常用 `Workspace Write`,只有确需访问 Workspace 外文件且信任当前任务时才启用 `Full access`。
- 各渠道能力不一致:微信只读入站文件(不能发文件、没有流式回复),音频和视频在所有渠道都只是降级处理。Telegram 需要 Bot API 10.2+ 且只支持长轮询,启动时会移除该 Bot 已有的 webhook,所以同一个 Bot 不能同时给别的 webhook 消费者用。
- 项目迭代很快,README 要求升级前备份数据;它是社区维护的渠道扩展,不是 DeepSeek Harness 或各消息平台的官方项目。
MIT · 仅有 README 证据,最新版本 v0.5.1,未做安全审计
06常见问题
在 DeepSeek Harness 里怎么装 dsh-channels?
执行 `npx @deepseek-ai/dsh plugin --profile web add -w @wsz987/dsh-channels@latest`,用 `npx @deepseek-ai/dsh --profile web --dump-config` 确认已合并,再用 `npx @deepseek-ai/dsh web` 启动 Harness Web。安装、更新、卸载都要保留 `-w` 参数。
它要求哪些版本,升级顺序是什么?
README 写明需要 DeepSeek Harness `0.1.5-rc.2` 与 Node `22.19+`,仓库里有兼容矩阵。插件必须与 Harness 匹配,所以先升 Harness(`npm i -g @deepseek-ai/dsh@next`)再更新插件:同一版本线用 `update`,跨版本线用 `add` 重装。
为什么渠道显示已连接,agent 却不回消息?
安全访问还没确认。到“设置 → 渠道 → 安全访问”确认谁能通过 Bot 使用本机 agent——插件不会把“能给 Bot 发消息的人”当成已授权用户。微信自动使用当前扫码账号;钉钉 / 飞书 / Telegram 要点“识别我的账号”并私聊 Bot 发一次识别指令;QQ 私聊仅创建者可用,群聊要单独配置。
能通过渠道发什么?
所有渠道都能发文本、都能收发图片,QQ / 钉钉 / 飞书 / Telegram 还能收发文件。支持视觉的模型直接读图片,PDF / DOCX / XLSX 与文本附件会提取内容供 agent 读取,入站单文件上限 100 MiB;微信只读入站文件,音频与视频是降级处理,微信也没有流式回复。
能在聊天里控制正在跑的会话吗?
可以。宿主的官方命令系统会在任意渠道会话里解析斜杠指令:`/stop` 会不等排队消息直接取消当前 agent,另外还有 `/new`、`/help`、`/status`、`/version`、`/models`、`/model`、`/mirror`、`/bind`。未识别的斜杠指令只会提示“未知命令”,不会发给模型;部分指令在群聊里不可用。
07相关的 DSH 工作流
dsh-im
作者 xmanrui
通过扫码或机器人凭据把IM机器人接入DeepSeek Harness(支持飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord和WhatsApp)。 Connect IM bots to DeepSeek Harness via QR code or credentials (9 channels).
dsh-aurabot-qq
作者 aureth-labs
让 DeepSeek Harness 里的 AI 以「大肥鱼」住进 QQ:会聊天、发表情、发语音、记事、发空间、刷 B 站、唱歌。功能都是模块,能开关、能自己写,还能从模块市场装更多(SnowLuma / OneBot v11)。
dsh-qqbot
作者 tencent-connect
让 QQ Bot 接入 DeepSeek Harness(dsh)的官方插件
dsh-wechat
作者 xcisxc29
DeepSeek Harness 微信频道
08数据与来源
将微信、QQ、钉钉、飞书和 Telegram 接入 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
接入后,在 Harness Web“设置 → 渠道”面板统一配置与扫码授权,并在各平台对话框中直接与 Agent 对话(图片来源:[docs/ScreenShot](./docs/ScreenShot)):
npx @deepseek-ai/dsh plugin --profile web add -w @wsz987/dsh-channels@latest
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-14。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
