技能介绍

解决什么问题

企业微信的「智能机器人」（aibot）和常见的群机器人 webhook 不是一回事：它没有 URL 可 POST，消息要主动发出去，就必须走 WebSocket 长连接 并完成 bot_id/secret 鉴权，还必须指定目标会话 ID。换句话说，脚本里拿不到一个地址就能随便发消息，缺少一个能把长连接、鉴权和会话寻址封装起来的接入层。这个技能补上的就是这一层：让 agent 或定时任务用几行命令完成一次主动推送。

如何工作

技能提供两条脚本路径：

scripts/send.js：已知目标会话时直接推送。群聊填 WECOM_CHAT_ID 为群 chatid，单聊填对方 userid。
scripts/capture.js：不知道会话 ID 时先监听。在目标会话触发一次事件（群里 @ 机器人，或单聊里发条消息），脚本捕获 chatid / userid 后实时返回，并默认回推一条消息验证通道；也可设 WECOM_DISABLE_ECHO=1 只打印 ID 不发送。

消息正文来自命令行参数、WECOM_MSG 或 WECOM_MSG_FILE，优先级前者更高；格式由 WECOM_MSG_TYPE 控制，默认 markdown。连接网关为 wss://openws.work.weixin.qq.com，SDK 建连后自动执行 aibot_subscribe 鉴权，成功后触发 authenticated 事件。SDK 已打包在 node_modules/ 里，脚本通过相对路径加载。

适用边界与注意点

凭证只通过环境变量传入，不要写进脚本、配置文件或聊天记录。
捕获到的会话 ID 属于敏感信息，只在运行时打印到控制台，不落盘、不写记忆；需要复用时由用户当场记录，之后改用 send.js。
errcode 非 0 或收不到消息，通常是 WECOM_CHAT_ID 类型填错——群聊填群 chatid 而非群名，单聊填对方 userid 而非机器人自己。先用 capture.js 拿到准确 ID。
鉴权失败先检查 WECOM_BOT_ID / WECOM_BOT_SECRET 是否完整、有无多余空格；authenticated 一直不触发，确认网络能连通 wss 网关（需出网）。
监听默认 60 秒超时（可调 WECOM_CAPTURE_TIMEOUT），触发不了就重跑，无需改配置。