返回目录

dsh-channels

精选清单收录维护状态: 活跃

wsz987/dsh-channels

把微信 / QQ / 钉钉 / 飞书 / Telegram 接入 DeepSeek Harness:统一配置、扫码授权,直接在各 IM 与 Agent 对话;支持图片与文件收发,Agent 可读取 PDF、DOCX、XLSX 和文本内容。

前往 GitHub
$ npx @deepseek-ai/dsh plugin --profile web add -w @wsz987/dsh-channels@latest

15

星标

3

Fork

TypeScript

语言

MIT

许可证

2026-08-13

创建于

2026-09-11

最近推送

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;微信不需要凭据,扫码登录即可

安装步骤

  1. 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

  2. 02

    确认 bundle 已合并进 profile:`npx @deepseek-ai/dsh --profile web --dump-config`

    $ npx @deepseek-ai/dsh --profile web --dump-config

  3. 03

    启动 Harness Web:`npx @deepseek-ai/dsh web`

    $ npx @deepseek-ai/dsh web

  4. 04

    在 Harness Web 打开“设置 → 渠道”,配置或登录需要使用的渠道,再完成“安全访问”设置

  5. 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 适配原生运行时

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 或各消息平台的官方项目。
2026-08-132026-09-11v0.5.1

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`。未识别的斜杠指令只会提示“未知命令”,不会发给模型;部分指令在群聊里不可用。

08数据与来源

  • 作者声明github.com8401caaa340c…

    将微信、QQ、钉钉、飞书和 Telegram 接入 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)

  • 作者声明github.com8401caaa340c…

    接入后,在 Harness Web“设置 → 渠道”面板统一配置与扫码授权,并在各平台对话框中直接与 Agent 对话(图片来源:[docs/ScreenShot](./docs/ScreenShot)):

  • 作者声明github.com8401caaa340c…

    npx @deepseek-ai/dsh plugin --profile web add -w @wsz987/dsh-channels@latest

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-14。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。