dingtalk-event

name	dingtalk-event
description	钉钉个人 IM 事件长连接监听、订阅与消费，覆盖消息接收、全部单聊/群消息、指定发送人、已读、撤回、表情回应和群生命周期，输出 NDJSON 到 stdout。Use when 用户提到 监听个人消息事件、监听所有单聊或群消息、被@消息、监听单聊或群消息、监听某人发送的消息、监听消息已读、监听消息撤回、监听消息贴表情或表情回应、监听群成员加入、监听群成员退出、监听群改名或群解散、实时接收钉钉事件、用事件驱动 Agent。命令前缀：dws event。

钉钉个人 IM 事件

只使用 dws event consume 建立个人消息事件长连接。用户要求实时监听、订阅、自动回复或驱动 Agent 时，不要写轮询脚本，不要用消息历史查询模拟事件。

运行方式

• bus 后台进程持有对钉钉的个人 Stream 长连；consume 从 bus 读事件、按 NDJSON 打到 stdout。consume 只读，不发消息（回复用 dws chat message send）。
• 没有 bus 时 consume 自动拉起；通常只跑 consume。
• 一个组织一个 bus，可同时跑；同组织内多个 consume 共享一个 bus。
• 非默认组织加全局 --profile <corpId 或 profile 名>；漏传会退回默认 profile 而失败。

Core commands

Command	Purpose
dws event list	查看当前个人事件目录；不要把它当能力菜单主动展示
dws event schema <event_key> --flatten	查看 Agent 使用的顶层业务字段 schema，默认 JSON
dws event consume <event_key> [event_key...] --flatten [flags]	阻塞消费一个或多个兼容事件；事件写到 stdout，推荐 -f ndjson
dws event status --event <event_key>	查看个人订阅、personal bus 和本地 consume
dws event stop <subscribe_id> --dry-run / --yes	先预览，再确认取消个人订阅并停止对应本地消费
dws event stop --all --dry-run / --yes	先预览，再确认清理当前身份下本地记录的全部个人订阅

区分两个 schema：dws event schema <event_key> 查事件输出字段；dws schema "event consume" 查 consume 命令入参（统一内嵌 ToolSpec，含 parameters + 位置参数）。 是 reviewed command identity 的 provenance； 是 ， 因同时编排远端订阅控制面与本地 bus 而是 ，不要把 identity 与实现机制混为一谈。