shaobeichen/dsh-im-bridge--packages-im-wecom ↗★ 1
dsh-im-wecom
企业微信渠道适配器，支持回调 URL、消息加解密、应用消息收发及文件交付。
AI 分析
核心用途是作为企业微信渠道适配器接入 DSH。适合需要通过企业微信收发消息的用户。必要条件是必须配置公网 HTTPS 回调 URL，且审批需走文本降级指令。
安裝
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:shaobeichen/dsh-im-bridge#9e5f1f6118c747193a639f78aa5ee1cf1c4105a1&path:packages/im-wecom說明文件
閱讀完整 README ↗dsh-im-wecom（企业微信适配器）
企业微信渠道适配器：回调 URL + 消息加解密（官方 @wecom/crypto）+ 应用消息收发 + 文件交付。
✅ 实现完成（本地 HTTP 服务器 + 官方加解密全链路测试 11/11）。 ⚠️ 企微无长连接/轮询——必须公网回调 URL（ngrok/cloudflared/caddy 穿透到本地 8787 端口）， 且应用消息没有交互按钮——审批走文本降级
/approve yes|no。 完整配置步骤见docs/wecom-setup.md。
- 依赖：
inject: ['im']（需dsh-im核心）；@wecom/crypto（官方加解密） - 密钥（全部
env:引用）：WECOM_CORP_ID/WECOM_AGENT_ID/WECOM_SECRETWECOM_CALLBACK_TOKEN/WECOM_ENCODING_AES_KEY
- 运行器：
node demo/wecom-real.mjs --mode demo - 测试：
node --test "packages/im-wecom/test/*.test.js"（契约 + 加解密 + HTTP 回调 + 出站）
平台四件事（对照 docs/wecom-setup.md）
| # | 事项 | 企微情况 |
|---|---|---|
| 1 | 凭证 | 管理后台自建应用：CorpID / AgentId / Secret |
| 2 | 权限/作用域 | 应用天然有收发消息能力；需配「企业可信IP」否则报 60020 |
| 3 | 订阅方式 | 仅回调 URL（公网 HTTPS）+ 消息加解密；无长连接 |
| 4 | 发布生效 | 应用可见范围包含用户即可；改回调 URL 立即生效 |
实现说明
- 接收：本地 HTTP 服务器
/wecom；GET=URL 验证（解密 echostr），POST=消息回调 （验签 sha1(sort(token,ts,nonce,Encrypt)) + AES-CBC 解密 XML → ImMessage）；5 秒内响应 success - 验签：GET 用 echostr、POST 用 body 的 Encrypt 值参与签名（企微规则，易踩坑）
- 发送：
/cgi-bin/message/send应用消息（touser=userid）；access_token 缓存 2h - 文件（
/log全量交付）：/cgi-bin/media/upload→ file 消息 - 审批降级（FR-6.2）：企微应用消息无按钮，
send()遇到 buttons 时在文本里附上 带真实审批 id 的/approve yes|no提示 - 可观测三件套：status.connected + lastEventAt 心跳 + 出站错误带 errcode/errmsg