zhao999/dsh-plugin-wecom-bot

README 摘要

dsh-plugin-wecom-bot DeepSeek Harness（DSH）插件：通过企业微信「智能机器人」 长连接 收发消息， 把发给机器人的文本当作任务下发给 DSH agent 执行，并把结果回传到企业微信。 - 零公网依赖 ：长连接模式由插件主动连出到企业微信网关（WebSocket）， 不需要公网 URL、不需要消息加解密、不需要可信 IP 白名单。 - 仅一个运行时依赖 （ ws ）：Node 内置 WebSocket 不带 ALPN 扩展， 会被企业微信网关 400 拒绝（详见「常见问题」），因此使用 ws 库。 - 支持 私聊 与 群聊 @机器人 ，多轮上下文（per-user 会话）或一次性任务（per-message）。 工作原理 协议实现基于官方文档 《智能机器人长连接》， 并与 cc-connect、 CowAgent 两个开源实现交叉验证。 一、企业微信后台：创建智能机器人 1. 登录 企业微信管理后台。 2. 进入 应用管理 → 智能机器人 → 创建智能机器人 。 3. 填写名称、头像等信息，创建完成后记录两个凭证： ⚠️ Secret 只显示一次 ，请立即保存。 4. 把机器人添加到会话：创建后在企业微信 App 里搜索该机器人，即可直接 私聊 ； 也可以把它拉进群聊，群成员 @机器人 发任务。 二、安装插件 在插件源码目录（本目录）执行： 这会用 pnpm 把插件装进 /.dsh/profiles/web ，并把 dsh-plugin-wecom-bot 追加到该 profile 的 dsh.profile.bundles （bundle 层）。重启 dsh web 生效。 本机没有 pnpm 时可用 corepack 启用，或在工作区内安装： npm install --prefix .tools/pnpm pnpm --cache .npm-cache ， 然后把 .tools/pnpm/node modules/.bin 加入 PATH。 三、配置凭证 两种方式任选其一： 方式 A：环境变量（默认，推荐） 方式 B：profile patch 覆盖 （ /.dsh/profiles/web/cordis.patch.yml ）： patch 覆盖的是整行 config ，覆盖时如需保留其他选项要一并写全 （完整选项见下表）。 未配置时插件保持空闲、仅打印提示，不影响 dsh web 启动。 四、启动验证 日志里应出现： 然后在企业微信里私聊机器人发一条消息，例如： 机器人先回复「✅ 已收到任务，agent 处理中…」，agent 跑完后回传最终结果。 五、bot 工作区命令 企业微信里给机器人发以下命令可以 查看/切换工作区 （决定 agent 在哪个 目录干活；每个企业微信成员独立记住自己的目录，多轮会话有效）…

分类