chenmingxuan/EP-Hub-Skill
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
39ed5a1bc25fca306f0852890da03b3257c46311
EP-Hub-Skill/.agents/skills/dingtalk-chat/references/chat/message-query.md
T
chenmingxuan 0c8fa2653e first commit
2026-09-02 11:44:52 +08:00

7.3 KiB
Raw Blame History

message-query：消息读取、搜索与查询

返回入口：DingTalk Chat Skill

用于浏览或导出指定会话、按条件搜索消息、按消息 ID 读取详情、查看 @我、话题回复、 Favorite、Pin 和 reaction。只读任务优先使用 Shortcut；只有 Shortcut 未发布所需底层字段、 原始响应或手工 continuation 时才读取精确原子 leaf Schema。

入口选择

用户终点 唯一推荐入口
浏览或导出一个指定群聊/单聊 dws chat +chat-messages
发送者、关键词、@对象或消息类型是主要条件 dws chat +search-msg
已知消息 IDs 读取详情 dws chat +messages-mget
查看 @我的消息 dws chat +at-me
查看 Favorite dws chat +flag-list
已知话题主消息或 thread/topic ID 读取回复 dws chat +thread-replies

+chat-messages 是指定会话的粗粒度读取；+search-msg 是目标条件明确的单/跨会话检索。 不要先读完整会话再补跑搜索，也不要把群名或姓名直接填入只接受稳定 ID 的参数。

指定会话读取

群聊 --group 可传群名或 openConversationId；也可用 --chat-query 显式解析群名、 用 --conversation-id 显式传稳定 ID。单聊使用 --user 或 --open-dingtalk-id。

dws chat +chat-messages --group <群名或openConversationId> --format json
dws chat +chat-messages --group <openConversationId> --page-all --page-limit 50 --format json

可附带非必填的 --sender-query <姓名>：未传时返回全部消息；唯一解析出 userId/openDingTalkId 后，按消息 senderId 筛选同一次读取结果，覆盖最终 messages/count 并返回 resolvedFilters。解析失败、不完整或存在歧义时抑制未过滤消息， 返回 sender_resolution_failed，不得把全量消息当作发送者筛选结果。

--sender 是姓名、userId 或 openDingTalkId 的混合入口。通讯录无法确认输入类型时，可按 原值 userId 精确过滤并交付命中消息，但结果必须保留 identity_unverified，不得把字符串命中 升级为已验证身份，也不得据此作完整否定结论。

dws chat +chat-messages --group "项目群" --sender-query "测试用户甲" --page-all --format json

时间范围使用公开可选的 --start、--end、--order asc|desc，兼容别名为 --start-time/--end-time/--sort。范围为 [start,end)；仅开始时间表示到本次执行当前时间； 仅结束时间只支持 desc，asc 必须提供开始时间。旧 --time/--direction 只用于兼容的 单边界模式，不能与范围模式混用。

dws chat +chat-messages --group <openConversationId> \
  --start "2026-08-01T00:00:00+08:00" --end "2026-08-02T00:00:00+08:00" \
  --order asc --page-all --format json

完整读取后只需消息字段可判断的子集时，在同一次调用中使用全局 --jq，保留根信封并 同步改写 messages/count；不得丢失 complete、hasMore、failures 等 ledger。 发送者姓名仍使用 --sender-query 解析稳定身份，不用 --jq 比较展示名。

dws chat +chat-messages --group "项目群" --page-all --format json \
  --jq '. as $root | [.messages[] | select((.reactions // []) | length > 0)] as $matched | $root | .messages = $matched | .count = ($matched | length)'

要求导出时用 --output <工作目录内相对.json> 原子写入；需要资源时在读取命令上加 --download-resources，不要让 Agent 先输出全量 JSON 再手工遍历资源引用。

多维度搜索

  • 关键词使用公开 --query。
  • 已知稳定会话 ID 使用 --group / --groups；稳定发送者 ID 使用 --senders。
  • 只有群名时使用 --chat-query，由 CLI 唯一解析会话。
  • 只有发送者姓名时使用 --sender-query，由 CLI 唯一解析人员。
  • 不传会话过滤时搜索全部会话；默认时间范围为最近 7 天。
  • --page-all 只翻完当前时间范围内的游标页；精确范围使用成对的 --start/--end。
  • --order 只稳定排列已经取得的结果；未全量或 complete=false 时不得称为完整范围全局排序。
dws chat +search-msg --chat-query "项目群" --sender-query "测试用户甲" --page-all --format json
dws chat +search-msg --chat-query "项目群" --query "发布计划" --page-all --format json
dws chat +search-msg --sender-query "测试用户甲" --page-all --format json

需要 Shortcut 未发布的原始过滤字段或响应时，才评估 message search-advanced。它支持 发送者、@对象、多个会话、消息类型、会话类型、机器人消息和时间范围，但不是默认入口。 至少提供一种真实过滤条件，完整遍历只有 --page-all 会触发。

其他查询

已知消息、@我与话题回复

  • +messages-mget --msg-ids <id...>：最多 50 条；结果可直接用于回复、转发、撤回和资源下载。
  • +at-me [--group <群名或ID>] --page-all：群内或跨全部会话查看 @我的消息。
  • +thread-replies --message-id <rootMessageId>：自动只读解析 conversation/thread。
  • +thread-replies --group <cid> --thread-id <threadId>：显式稳定上下文。

话题回复默认 desc；asc 必须与 --page-all 一起使用。自动续页使用下层毫秒级 nextCursor，不得使用只有秒精度的展示时间手工拼 continuation。检查 complete、 hasMore、stopReason 和 failures。

Favorite、Pin 与 reaction 查询

任务 入口
Favorite 列表 +flag-list；要求全部时加 --page-all，页大小 1–30
消息 Pin 列表 message list-pin-msg --open-conversation-id <cid>
批量 reaction/文字回应 message list-emotion-replies --msg-ids <id...>
已读/未读状态 message read-status --group <cid> --message-id <id>

Favorite、消息 Pin、消息 Top 和会话 Top 是不同对象。写入或取消这些状态读取 message-actions.md，这里只负责查询。

原子 fallback

原子命令 仅用于
message list 指定会话原始响应或显式手工 continuation
message list-all 时间范围内全部会话的原始分页响应
message list-by-sender 已有稳定发送者 ID 且需要底层原始响应
message list-mentions / list-focused @我或特别关注的原始列表
message search / search-advanced Shortcut 未发布的真实过滤字段
message list-by-ids 已知消息 ID 的原始详情响应

Typed chat message 自动翻页只由 --page-all 触发；只传 --page-limit、--max-items 或 --page-delay 仍是单页。非第一页失败时保留 partial 结果、失败页和 continuation，不能 把 partial result 表述成完整成功。

完成与错误

  • 查询必须检查 complete、hasMore、stopReason、failures 和下载 ledger。
  • 发送者/群名零命中或多候选时停止，不选择第一项。
  • unknown flag 时读取精确 leaf Help，修正后最多重试一次。
  • 子消息优先使用自己的 messageId；只在缺会话 ID 时继承父消息的 conversationId。
  • 查到真实消息后需要写操作时，使用 message-actions.md 中的稳定 ID 规则。
Reference in New Issue View Git Blame Copy Permalink