3.5 KiB
话题与话题圈
返回入口：DingTalk Chat Skill
话题（Thread）是一条主消息及其回复线，可以位于普通群或话题圈中，使用 openConvThreadId 标识；承载话题的父群使用 openConversationId。命令沿用拆分前 chat group / chat message 的参数名称。只有需要新建话题圈时才使用 create-group，已有群中的话题可直接使用其余 chat thread 命令。
入口选择
| 用户终点 | 推荐入口 |
|---|---|
| 已有稳定成员 ID 创建话题圈 | dws chat thread create-group --name <名称> --users <userId,...> |
| 发布新话题 | dws chat thread send --conversation-id <openConversationId> |
| 浏览话题主消息 | dws chat thread list --conversation-id <openConversationId> |
| 向具体话题直接追加回复 | dws chat thread reply --conversation-id <openConvThreadId> |
| 分页读取一个话题的回复 | dws chat thread list-replies --conversation-id <openConversationId> --topic-id <openConvThreadId> |
| 转发整条话题 | dws chat thread forward --src-msg-id <openMessageId> --src-conversation-id <openConversationId> --src-thread-id <openConvThreadId> --dest-conversation-id <openConversationId> |
| 撤回话题中的一条消息 | dws chat thread recall-message --conversation-id <openConversationId> --message-id <openMessageId> |
| 添加或移除 emoji | dws chat thread add-emoji / remove-emoji |
| 查询 Thread 消息的表情回复 | dws chat thread list-emotion-replies --msg-ids <openMessageId,...> |
| 添加、移除或更新文字表情 | dws chat thread add-text-emotion / remove-text-emotion / update-text-emotion |
发布、回复与读取
thread send 的 --conversation-id 是承载话题的会话 openConversationId，用于发布新的顶层话题。
thread reply 沿用原发送命令的 --conversation-id，但这里传 Thread 子会话的 openConvThreadId。它直接追加回复，不使用消息引用回复，也不创建新的顶层 Thread。
已有父会话 openConversationId 和 Thread openConvThreadId 且只需读取一页时，使用 thread list-replies --conversation-id ... --topic-id ...。需要按主消息自动解析、全量翻页、排序或下载资源时，使用 +thread-replies Shortcut。
用户需要逐条查看、列出或概括具体回复内容时，使用 thread list-replies；只浏览话题主消息时使用 thread list。需要自动读取全部页面、排序或下载资源时，使用 +thread-replies Shortcut。
整条 Thread 可转发到普通群；当前不支持从话题圈向另一个话题圈转发整条 Thread。
消息操作
撤回、emoji 和文字表情命令沿用对应 chat message 命令的主参数。Runtime 会先读取消息并校验其属于 Thread，再执行操作；批量查询会逐条校验 --msg-ids。文字表情的 emotionId、backgroundId、名称和文字使用 chat message create-text-emotion 返回的实际值；移除时使用已添加的值，更新时用 --old-emotion-id 传当前值、其余表情参数传新值。
完成与错误
- 创建话题圈返回真实群会话结果，不额外制造
openTopicId字段。 - 发布和回复沿用异步发送结果；
openTaskId是任务 ID，后续消息操作需要从发送状态或消息查询中取得真实消息 ID。 - Thread 主消息和回复均保留
openConvThreadId，父容器继续使用openConversationId。 - 标识缺失、类型不明或消息不属于 Thread 时停止，不猜 ID。