前言¶

DeepSeek Harness（DSH）是能在本机读写文件、执行命令、跑长任务的编码 agent。常见用法是坐在电脑前开客户端对话；一旦人离开键盘，就没有一个顺手、稳定的「入口」把一句话丢给同一套 agent。

社区插件 dsh-plugin-im-bridge（维护者 eighteentang）做的是：把 QQ、微信等 IM 机器人接成 DSH 的对话入口——在手机上给机器人发消息，消息进电脑上的 DSH，由专用会话里的 agent 处理，结果再回到手机。下面介绍它是什么、支持哪些平台、怎么装、怎么试第一条消息，以及权限与安全上必须知道的事。

这是什么¶

dsh-plugin-im-bridge 是 DSH 的客户端类插件：在 DSH 客户端内增加 IM 传输层与专用会话，不替代 DSH 本身。凭据保存在本机 ~/.dsh/.credentials.yaml（记录名 im-bridge/bot），QQ 的 AppSecret 等不会回显在设置页。

架构上，队列、专用会话、会话面板、权限预设、回复分派是平台无关的内核；QQ（WebSocket 长连接）、微信（HTTP 长轮询）等各自实现传输层。设置页对每个平台会标注完成度，未做完的能力不会假装可用。

支持的平台与能力¶

能做什么（README 中的场景）：远程派活、随手查文件/目录/代码、发起长任务后离开再回看、双向对话（追问与进度）；QQ 支持图文/语音/文件收发（单文件 ≤ 5 MB）；微信支持收图片（解密）与语音（取自带转写），出站媒体待做。附件落在 <桌面>/im-bridge-media/<平台>/<日期>/，路径会拼进发给 agent 的消息。每个 IM 平台各有一条独立专用会话，与电脑上其它会话互不干扰。

安装与启用¶

前提：已安装 DSH 并能正常登录、对话。

在 DSH 界面安装（推荐）¶

1. 打开侧边栏 插件 页，点 添加插件。
2. 在「包名或地址」填完整 GitHub 地址（不能只填 dsh-plugin-im-bridge，该插件未发布到 npm）：

github:eighteentang/dsh-plugin-im-bridge#v1.2.7

3. 确认安装后重启 DSH 客户端。

GitHub 地址不经过 npm 安装源，需本机能访问 github.com 或已配置代理。界面安装的插件暂不支持自动更新，升级需卸载后改用新的 #vX.Y.Z 重装。

命令行安装¶

dsh plugin --profile <你的profile名> add github:eighteentang/dsh-plugin-im-bridge#v1.2.7

<你的profile名> 对应 ~/.dsh/profiles/ 下的目录名；装错 profile 会导致当前客户端看不到插件。推荐固定标签 #v1.2.7，不写标签则装 main 最新提交。

验证：重启后应有 设置 → 连接 IM，以及侧边栏企鹅图标（QQ 会话面板）。可用 dsh plugin --profile <名字> list 或查看 ~/.dsh/profiles/<profile名>/package.json 里 dsh-plugin-im-bridge 字段确认版本。

微信用户版本注意：请用 v1.2.2 或更新；v1.2.1 及更早发微信回复缺 client_id，往往只有第一条能显示。

凭据与连接¶

打开 设置 → 连接 IM，按平台展开「配置/测试」，保存后点「保存并测试连接」。

路线 A（微信）：手机微信 8.0.70+，且在「我 → 设置 → 插件」能看到 微信 ClawBot；连接时扫码，bot_token 存本机，重启客户端一般不用重扫。

路线 B（QQ）：在 https://q.qq.com 创建机器人，从「开发设置」取 AppID、AppSecret；在「沙箱配置 → 消息列表单聊」把自己的 QQ 号加入白名单（未加则收不到消息且不报错）。插件默认走 QQ 沙箱（家用宽带无固定公网 IP 时正式环境需 IP 白名单，通常不可用）。

连接状态可看设置页或本机接口（仅 127.0.0.1）：

curl http://127.0.0.1:8799/im-bridge/status

返回 "connected": true 且 "bot" 为机器人名即表示正常。

典型用法¶

第一条消息：QQ 用已加白名单的号私聊机器人；微信直接给「微信 ClawBot」发消息。例如：

帮我看看 D 盘有哪些文件

正常时会列目录并把结果回到手机。

带附件：在聊天里直接发图/语音/文件，无需特殊命令；可对 agent 说「看看我刚发的那张图……」，agent 通过本地路径读取。

模型配置：专用会话默认用 DSH 的默认模型；若回复提示没有 API key，可在 profile 的 cordis.patch.yml 中为 im-bridge 指定，例如：

- id: im-bridge
  name: dsh-plugin-im-bridge
  config:
    agentProvider: deepseek-account
    agentModel: deepseek-flash

其它可选配置项包括 agentReasoningEffort、workspace、sandbox（仅 QQ）、permissionPreset（默认 danger-full-access）、agentSessionId（仅应在个人 patch 中覆盖以换新会话上下文）。修改后需重启客户端。

适用场景与注意¶

适合谁：需要在通勤、外出时用 IM 触发本机 DSH agent，且能接受自行配置 QQ 机器人或微信 ClawBot 的开发者。

权限与安全（必读）：插件以当前 DSH 进程权限在本机运行；默认 permissionPreset: danger-full-access，能私聊机器人的人即可在电脑上执行命令（无人值守时桌面审批框在手机上不可见）。安装前应阅读 GitHub 仓库 源码与 MIT 许可证，按自身环境收紧权限或限制可发消息的人。

排查无回复：QQ 优先查沙箱白名单与连接状态；微信查已连接且版本 ≥ v1.2.2；若提示没有工具或没有 API key，对照 README 的「已知问题」与模型配置节。

DSH 生态强调「一切皆插件」；SkillHub 目录页 是社区收录站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-plugin-im-bridge 把 IM 变成 DSH 的远程对话入口：内核统一、传输层按平台扩展，QQ 与微信已可完整对接 agent。安装时使用资料中的地址 github:eighteentang/dsh-plugin-im-bridge#v1.2.7，配好凭据并理解默认高权限后再用于日常派活。

• 目录页：https://www.skillhub.cn/plugins/eighteentang/dsh-plugin-im-bridge
• 源码与文档：https://github.com/eighteentang/dsh-plugin-im-bridge