SuperAPI AI 工具集

dingtalk-event

前端与建站

查看项目

更新于 10-15 21:10

技能介绍

用途:本技能负责钉钉个人实时事件监听,覆盖 IM 消息、OA 审批、VoIP 通话邀请、待办、互动卡片回调与好友事件。发送/历史消息、审批处理、待办操作属于其他技能。

主要能力:常用入口为 dws event +listen-im,支持 --kind at-me、sender、group、all-direct、all-group 等;消息事件包括 message、reaction、read、recall。群生命周期、审批、VoIP、待办、好友与卡片事件使用 dws event consume 配合具体 EventKey,并可用 dws event list --category oa|todo|contact|card 查看目录。状态与停止用 dws event status、dws event stop <subscribe_id>。

使用方式:执行前须完整读取 dingtalk-shared。sender 只能传 --user、--open-dingtalk-id 或 --user-query 之一,group 只能传 --chat-id 或 --chat-query 之一;姓名或群名必须唯一解析。有界任务用 --max-events N 或 --duration 10m,正常消费使用 --flatten 与 NDJSON,等待 ready 而非 sleep。回退时用 dws event schema <event_key> --flatten 查询字段。

限制:at-me、all-direct、all-group 仅支持 message 且不接受目标;--query 仅在纯 message 监听可用。OA 七个 EventKey 用 ruleType=all、filterRule={};Todo 三个 EventKey 仅接受 --role-types creator,executor,participant。订阅保护状态存于 ~/.dws/events/open/personal_stream/<identity_hash>/,紧急恢复只删 personal_subscription_attempts.json,勿删 lock 文件。认证、重试与排障详见各 reference。具体字段差异与敏感输出边界以官方参考为准,本资料未完整给出。