企业微信机器人桥接michaelcode-wang/dsh-wecom

dsh-wecom

企业微信（WeCom）智能机器人桥接插件：通过 aibot WebSocket 网关，让 DeepSeek Harness 的智能体变成能在企业微信里双向对话的助手。无需公网地址、无需自建应用回调，只需智能机器人的 bot_id + secret。

协议移植自 Hermes Agent 的 plugins/platforms/wecom/adapter.py（aibot_subscribe 认证 → aibot_msg_callback 收消息 → aibot_respond_msg / aibot_send_msg 回复）。

特性

- 企业微信智能机器人 WebSocket 长连接（wss://openws.work.weixin.qq.com），断线自动退避重连
- 每个聊天一个独立 agent 会话，多轮上下文保留，空闲自动回收
- 白名单访问控制（allowedUserIds）
- markdown 回复 + 超长消息自动分片（默认 4000 字符）
- 聊天命令：/help、/reset、/status

安装

从 npm（推荐）
dsh plugin --profile im add dsh-wecom

或从 GitHub
dsh plugin --profile im add github:michaelcode-wang/dsh-wecom

前置条件

1. 企业微信智能机器人：在企业微信后台创建一个「智能机器人」，拿到 bot_id 和 secret。
2. im profile 需要 preset roster：独立 im profile（dsh-base + 本插件）没有 web 层，而 preset roster（agent-presets）默认由 dsh-web-app 提供。若要让 agent 挂载某个 preset，需在 im profile 的 cordis.patch.yml 里手动插入 roster（见下方完整示例）。

配置

在 $DSH_HOME/profiles/im/cordis.patch.yml 中：

1) 插入 preset roster（im profile 无 web 层，需手动补）
- insert:
- id: agent-presets
name: '@deepseek-ai/dsh-agent-presets'
config:
default: taibai          # 默认 preset；可按需改成你自己的 preset

2) 启用本插件
- id: dsh-wecom
disabled: false
config:
botId: '你的机器人ID'
secret: '你的机器人密钥'
allowedUserIds: ['你的企业微信userid']
agent:
preset: taibai             # 每个企业微信聊天对应的 agent preset

启动：dsh --profile im（建议配 launchd / systemd 常驻）。

配置项

| 键 | 默认 | 说明 |
|---|---|---|
| enabled | true | 总开关 |
| botId | '' | 企业微信智能机器人 ID |
| secret | '' | 企业微信智能机器人密钥（只写） |
| websocketUrl | wss://openws.work.weixin.qq.com | WebSocket 网关地址 |
| allowedUserIds | [] | 允许对话的 userid 白名单；留空=所有人 |
| agent.preset | taibai | 挂载的 agent preset |
| agent.cwd | '' | agent 工作目录（默认进程 cwd） |
| agent.provider / agent.model | '' | 模型覆盖；留空=部署默认 |
| agent.maxMessageLength | 4000 | 单条外发消息最大字符数 |
| agent.idleTimeoutMs | 1800000 | 聊天空闲多久后释放 agent（0=永不） |

安全

- 务必配置 allowedUserIds 白名单——留空意味着任何人都能驱动你的智能体执行主机工具。
- secret 标记为 role('secret')，不会回显到浏览器。