技能介绍

解决什么问题

把钉钉、飞书和企业微信群机器人的 webhook 和原生接口揉进同一个 CLI，最麻烦的不是收发本身，而是三套能力边界和地址体系互不兼容：钉钉不能用邮箱直发，飞书依赖 open_id 或绑定邮箱，企业微信还要在群里找 webhook。人一多，发错群、漏发、无法撤回，或者机器人不在群里导致功能静默缺失，都是常见事故。@user_2a52e6b3/smart-message-plus 想解决的是：用一个入口，按别名或平台原生标识把消息送到正确对象，并在发大群前加一道可配置的审批闸门。

怎么工作

核心流程是：解析收件人，选择 provider，渲染消息，执行安全门控，再按平台能力组装 payload。收件人支持三级解析：联系人别名、平台原生标识、以及解析失败后给出的别名维护提示。别名可以让同一个 张三 对应钉钉 userId 和飞书邮箱或 openid，减少跨平台维护成本。消息形态覆盖文本、Markdown、图片、文件、卡片、@人和@所有人；钉钉支持原生 Markdown，飞书走卡片 larkmd 渲染，企业微信 webhook 模式支持文本、MD、图片、文件、news 卡片和 @人。

安全门控按人数分级：50 人以内直接发送，51-100 人需 --force-send，超过 100 人要通知管理员并使用 --approve-code。审核码一次性、30 分钟有效，且绑定收件人和消息内容，内容一旦变化就作废。部门广播可从钉钉或飞书通讯录 API 取组织架构，也可以在 config.json 中配置 org_lookup.mode=custom 接自己的查询服务。日志写到 broadcast_log.jsonl，凭证文件保持 600 权限并原子写入，HTTP 请求统一设置 timeout，对 429/5xx 做退避重试。

适用边界

零第三方依赖，只要求 Python ≥ 3.9 标准库。企业微信当前只实现了 webhook 模式：一个 webhook 对应一个群，--chat-id 可以传群别名、完整 URL 或裸 key；这个模式没有 IP 白名单限制，适合托管容器和云环境，但不支持单聊、通讯录查人、建群、撤回和部门广播。wecom-app 全能力模式已预留账号字段，需要企业自有出口 IP 才能使用。钉钉普通群不能通过 API 自动加入机器人，所以 --create-group 会先建群并给出手动补加机器人的步骤；补加前不支持按钮卡片和撤回。飞书建群时机器人可以自动入群。

必须留意消息内容红线：--msg 的内容只能由用户明确提供，AI 或 Agent 不能代拟、补全或润色后直接发送；唯一例外是用户明确授权、且收件人仅为本人的自测场景。