核心用法
本技能封装了钉钉开放平台的核心API能力，提供四大功能模块：
1. 用户搜索 - 通过姓名关键词检索企业内部用户，获取UserId用于后续消息推送
2. 单聊消息 - 机器人向指定用户发送私聊消息，支持文本内容推送
3. 群聊消息 - 机器人向指定群会话发送消息，需提前获取openConversationId
4. 机器人查询 - 列出群内已配置的机器人，便于获取robotCode进行消息发送
使用前需配置环境变量 DINGTALK_APP_KEY 和 DINGTALK_APP_SECRET，所有脚本基于Node.js/TypeScript实现，返回统一JSON格式响应。
显著优点
- 官方API直连：直接调用钉钉开放平台接口，非第三方中转，数据合规有保障
- 功能聚焦：针对企业高频场景（用户检索、消息推送）做垂直封装
- 统一错误处理：标准化的错误码体系（MISSING_CREDENTIALS、AUTH_FAILED等），便于排查问题
- 调试友好：支持
--debug参数，方便开发阶段问题定位
潜在局限
- 权限依赖重：需预先在钉钉开发者后台创建应用并申请API权限，配置门槛较高
- 会话ID获取成本：群消息需提前获取
openConversationId，该流程未在本技能内封装 - 消息类型单一：当前仅支持文本消息，不支持卡片、Markdown等富媒体格式
- 频次限制：受钉钉开放平台API流控限制，高频场景需自行实现退避策略
适合人群
- 企业内部开发者搭建自动化通知系统（如CI/CD告警、审批提醒）
- 已有钉钉应用权限，需快速集成消息推送能力的团队
- 熟悉Node.js生态，具备基础钉钉开放平台配置经验的技术人员
常规风险
- 凭证泄露风险：APP_SECRET以环境变量形式管理，需确保CI/CD流水线及本地环境安全
- 消息滥发风险：机器人消息能力可能被用于高频骚扰，需建立发送频率管控机制
- 权限扩散风险：应用权限变更可能影响功能可用性，需关注钉钉开放平台政策更新