Files
EP-Hub-Skill/.agents/skills/dingtalk-event/references/event-im-output.md
T
2026-09-02 11:44:52 +08:00

2.1 KiB
Raw Blame History

IM 事件输出与 Chat 交接

Agent 默认使用 --flatten -f ndjson,顶层直接读取字段,不再 fromjson。消息接收常见字段:

字段 语义
type / event_id / timestamp 事件类型、去重 ID、时间
subscribe_id 个人订阅与本地输出隔离键
message_id / conversation_id 稳定消息与会话 ID
sender / sender_open_dingtalk_id 展示名与稳定发送人开放 ID
content / create_time / event_time 正文及时间
quoted_message 可选引用原消息
forward_messages 可选合并转发子消息数组

引用和转发子消息字段为 message_idconversation_idsendersender_open_dingtalk_idcontentcreate_time。按结构识别转发,不匹配本地化摘要。

动作事件通用字段之外:已读提供 reader_open_dingtalk_id/read_time,撤回提供 recaller_open_dingtalk_id/recall_timereaction 提供 operator_open_dingtalk_id/reaction_name/reaction_text/operation_type/operation_time

成员加入/退出提供 conversation_idoperator_open_dingtalk_idmembers[]event_time;成员稳定 ID 是 members[].open_dingtalk_id。群标题变化和群解散仅保守承诺 基础路由字段及 payload,不得猜未由真实样本确认的键。

事件驱动回复的精确 ID 映射

event field exact chat target
conversation_id dws chat +messages-send --as user --group <conversation_id>
sender_open_dingtalk_id dws chat +messages-send --as user --open-dingtalk-id <sender_open_dingtalk_id>

在上述命令后追加真实 --text/--markdown 和必要 confirmation。禁止使用 sender 再做 --user-query,也禁止把单聊发送人 ID 当成群 ID。交接 marker 由 policy 逐字验证。

媒体事件正文可能只是描述。优先按真实消息 ID/会话 ID 使用 Chat 消息读取命令加 --download-resources;只有精确 lower fallback 才用 chat message download-media