dsh-crwu-workbench 0.0.10

package/skills/dws/dingtalk-chat/references/chat/message-query.md

@@ -0,0 +1,135 @@
+# message-query：消息读取、搜索与查询
+
+> 返回入口：[DingTalk Chat Skill](../../SKILL.md)
+
+用于浏览或导出指定会话、按条件搜索消息、按消息 ID 读取详情、查看 @我、话题回复、
+Favorite、Pin 和 reaction。只读任务优先使用 Shortcut；只有 Shortcut 未发布所需底层字段、
+原始响应或手工 continuation 时才读取精确原子 leaf Schema。
+
+## 入口选择
+
+| 用户终点 | 唯一推荐入口 |
+|---|---|
+| <!-- dws-intent: chat.read.conversation -->浏览或导出一个指定群聊/单聊 | `dws chat +chat-messages` |
+| <!-- dws-intent: chat.search.filtered -->发送者、关键词、@对象或消息类型是主要条件 | `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`。
+
+```bash
+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`，不得把字符串命中
+升级为已验证身份，也不得据此作完整否定结论。
+
+```bash
+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` 只用于兼容的
+单边界模式，不能与范围模式混用。
+
+```bash
+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` 比较展示名。
+
+```bash
+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` 时不得称为完整范围全局排序。
+
+```bash
+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](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](message-actions.md) 中的稳定 ID 规则。

package/skills/dws/dingtalk-chat/references/chat/thread.md

@@ -0,0 +1,46 @@
+# 话题与话题圈
+
+> 返回入口：[DingTalk Chat Skill](../../SKILL.md)
+
+话题（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>` |
+| 将普通群中的已有消息升级为 Thread | `dws chat thread promote --conversation-id <openConversationId> --message-id <openMessageId>` |
+| 浏览话题主消息 | `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 promote` 用于把普通群中一条已经存在的消息升级为 Thread 根消息；它同时需要消息所属普通群的 `openConversationId` 和该消息的 `openMessageId`，成功后返回新的 `openConvThreadId`。单聊消息不能升级；若要发送全新的 Thread，继续使用 `thread send`。
+
+`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。

package/skills/dws/dingtalk-chat/references/chat-emoji-list.md

@@ -0,0 +1,216 @@
+# 钉钉默认表情列表（emoji 回应可用）
+
+> 本文件列出钉钉支持的所有用户可见默认表情（showType=1），共 199 个。
+>
+> **来源与维护合同（reviewed snapshot）**：表格来自钉钉默认表情 catalog 的 showType=1
+> 人工复核快照；当前 lower interface 没有可靠的“列出默认 emoji”命令，因此本文件不是从
+> Runtime 或旧 Catalog 反向生成。更新时必须取得新的官方/真实客户端 catalog，核对
+> emotionId、中文 name、en_US、showType 和总数，说明来源与复核日期，再整体替换表格；禁止
+> 根据用户输入或单次 reaction 响应增补。生成策略为 **non-generated reviewed reference**，
+> Schema/Skill 生成器不得机械重写它。最后复核：2026-08-03。
+>
+> 使用规则：
+> - 用户描述的表情命中下表中的 `name` → 使用 `chat message add-emoji --emoji <name>` 贴 emoji 回应
+> - 用户描述的表情未命中下表 → 先 `chat message create-text-emotion` 创建文字表情获取 emotionId，再 `chat message add-text-emotion` 贴文字表情回应
+
+| # | emotionId | name | en_US |
+|---|-----------|------|-------|
+| 1 | emotion_001 | 微笑 | Smile |
+| 2 | emotion_099 | 可爱 | Lovely |
+| 3 | emotion_002 | 憨笑 | Wow |
+| 4 | emotion_003 | 色 | Yum |
+| 5 | emotion_004 | 发呆 | Dazed |
+| 6 | emotion_005 | 老板 | Boss |
+| 7 | emotion_036 | 傻笑 | Oops |
+| 8 | emotion_006 | 流泪 | Sob |
+| 9 | emotion_007 | 害羞 | Shy |
+| 10 | emotion_008 | 闭嘴 | Silence |
+| 11 | emotion_009 | 睡 | Sleepy |
+| 12 | emotion_010 | 大哭 | Cry |
+| 13 | emotion_011 | 尴尬 | Awkward |
+| 14 | emotion_080 | 感谢 | Thanks |
+| 15 | emotion_204 | 拒绝 | SayNo |
+| 16 | emotion_078 | 赞 | Like |
+| 17 | emotion_024 | 鼓掌 | Clap |
+| 18 | emotion_105 | 打招呼 | Hi |
+| 19 | emotion_159 | 666 | 666 |
+| 20 | emotion_079 | 抱拳 | Salute |
+| 21 | emotion_025 | 握手 | Shake |
+| 22 | emotion_023 | OK | OK |
+| 23 | emotion_033 | 胜利 | Peace |
+| 24 | emotion_142 | 向左 | Left |
+| 25 | emotion_143 | 向右 | Right |
+| 26 | emotion_144 | 向上 | Up |
+| 27 | emotion_145 | 向下 | Down |
+| 28 | emotion_185 | 来呀 | Come |
+| 29 | emotion_155 | 一点点 | ALittle |
+| 30 | emotion_179 | 捏住 | Pinch |
+| 31 | emotion_140 | 比心 | FingerHeart |
+| 32 | emotion_106 | 送花花 | Flower |
+| 33 | emotion_178 | 加油干 | MakeEffort |
+| 34 | emotion_013 | 调皮 | Tongueout |
+| 35 | emotion_014 | 大笑 | Laugh |
+| 36 | emotion_015 | 惊讶 | Scowl |
+| 37 | emotion_016 | 流汗 | Sweat |
+| 38 | emotion_017 | 奋斗 | Fight |
+| 39 | emotion_018 | 口罩 | Mask |
+| 40 | emotion_019 | 生病 | Sick |
+| 41 | emotion_020 | 吐 | Barf |
+| 42 | emotion_021 | 难过 | Bummed |
+| 43 | emotion_022 | 抓狂 | Crazy |
+| 44 | emotion_026 | 右哼哼 | Humph |
+| 45 | emotion_027 | 太阳 | Sunny |
+| 46 | emotion_028 | 月亮 | Moon |
+| 47 | emotion_029 | 强 | Thumbsup |
+| 48 | emotion_030 | 弱 | Thumbsdown |
+| 49 | emotion_031 | 彩带 | Tada |
+| 50 | emotion_032 | 蛋糕 | Cake |
+| 51 | emotion_034 | 骷髅 | Skull |
+| 52 | emotion_035 | 撇嘴 | Pout |
+| 53 | emotion_037 | 鄙视 | Dislike |
+| 54 | emotion_038 | 嘘 | Shhh |
+| 55 | emotion_040 | 思考 | Hmm… |
+| 56 | emotion_041 | 亲亲 | Kiss |
+| 57 | emotion_042 | 无奈 | Disappointed |
+| 58 | emotion_043 | 感冒 | Pollution |
+| 59 | emotion_044 | 对不起 | Sorry |
+| 60 | emotion_045 | 再见 | Wave |
+| 61 | emotion_046 | 投降 | GiveUp |
+| 62 | emotion_047 | 哼 | Grumpy |
+| 63 | emotion_048 | 欠扁 | FaceSlap |
+| 64 | emotion_049 | 拜托 | Please |
+| 65 | emotion_050 | 可怜 | Aww… |
+| 66 | emotion_051 | 舒服 | Relax |
+| 67 | emotion_052 | 爱意 | Romantic |
+| 68 | emotion_054 | 财迷 | MoneyMoney |
+| 69 | emotion_055 | 迷惑 | Puzzled |
+| 70 | emotion_056 | 委屈 | Worried |
+| 71 | emotion_057 | 灵感 | Idea |
+| 72 | emotion_058 | 天使 | Angel |
+| 73 | emotion_059 | 鬼脸 | SillyFace |
+| 74 | emotion_060 | 凄凉 | Phew |
+| 75 | emotion_061 | 郁闷 | Tired |
+| 76 | emotion_063 | 坏笑 | Trick |
+| 77 | emotion_064 | 算账 | SoMuch |
+| 78 | emotion_206 | PK | PK |
+| 79 | emotion_066 | 忍者 | Sneaky |
+| 80 | emotion_039 | 衰 | Grr |
+| 81 | emotion_067 | 炸弹 | Uh-Oh |
+| 82 | emotion_081 | 笑哭 | LaughAndCry |
+| 83 | emotion_082 | 嘿嘿 | Smirk |
+| 84 | emotion_083 | 捂脸哭 | Facepalm |
+| 85 | emotion_084 | 抠鼻 | NosePick |
+| 86 | emotion_085 | 流鼻血 | BloodyNose |
+| 87 | emotion_090 | 呲牙 | Grin |
+| 88 | emotion_091 | 吃瓜 | EatingMelon |
+| 89 | emotion_092 | 彩虹 | Rainbow |
+| 90 | emotion_098 | 耶 | Yeah |
+| 91 | emotion_012 | 发怒 | Steamed |
+| 92 | emotion_100 | 捂眼睛 | CannotLook |
+| 93 | emotion_101 | 推眼镜 | PushGlasses |
+| 94 | emotion_102 | 暗中观察 | Peep |
+| 95 | emotion_103 | 脑暴 | Brainstorming |
+| 96 | emotion_112 | 冷笑 | Distressed |
+| 97 | emotion_208 | 热 | HotFace |
+| 98 | emotion_113 | 开心 | Happy |
+| 99 | emotion_114 | 惊喜 | Surprised |
+| 100 | emotion_115 | 回头 | LookBack |
+| 101 | emotion_116 | 白眼 | RollEyes |
+| 102 | emotion_117 | 一团乱麻 | Overwhelmed |
+| 103 | emotion_149 | 黑眼圈 | DarkCircle |
+| 104 | emotion_225 | 裂开 | Broken |
+| 105 | emotion_156 | 恭喜 | Congrats |
+| 106 | emotion_160 | 费解 | Confuse |
+| 107 | emotion_167 | 收到 | RogerThat |
+| 108 | emotion_186 | 快来 | ComeOn |
+| 109 | emotion_086 | 敲打 | Hammer |
+| 110 | emotion_176 | 捧脸 | HoldFace |
+| 111 | emotion_194 | Get | Get |
+| 112 | emotion_207 | 客服 | CustomerService |
+| 113 | emotion_210 | AR | AR |
+| 114 | emotion_221 | 小蜜蜂 | Bee |
+| 115 | emotion_211 | 虎虎生威 | MajesticTiger |
+| 116 | emotion_222 | 兔飞猛进 | Rabbit |
+| 117 | emotion_226 | 龙头老大 | Dragon Face |
+| 118 | emotion_236 | 蛇来运转 | Good luck |
+| 119 | emotion_238 | 马上来财 | Wealth is coming |
+| 120 | emotion_093 | 专注 | Concentrate |
+| 121 | emotion_166 | 忙疯了 | CrazyBusy |
+| 122 | emotion_187 | 等一等 | Wait |
+| 123 | emotion_227 | 一脸苦笑 | Wry Smile |
+| 124 | emotion_228 | 王之蔑视 | Unamused |
+| 125 | emotion_229 | 洪荒之力 | Amazing |
+| 126 | emotion_234 | 向左看 | Thinking |
+| 127 | emotion_235 | 向右看 | Pondering |
+| 128 | emotion_230 | YYDS | YYDS |
+| 129 | emotion_231 | 这边请 | ThisWayPlease |
+| 130 | emotion_232 | 弹射下班 | OffDuty |
+| 131 | emotion_233 | 退退退 | Back |
+| 132 | emotion_188 | 在吗 | Hello? |
+| 133 | emotion_189 | 让人头大 | Hard |
+| 134 | emotion_089 | 摊手 | Smugshrug |
+| 135 | emotion_088 | 抱抱 | Hug |
+| 136 | emotion_158 | 举手 | RaiseHand |
+| 137 | emotion_177 | 开车 | Driving |
+| 138 | emotion_191 | 抱大腿 | Follow |
+| 139 | emotion_087 | 跪了 | YouWin |
+| 140 | emotion_162 | 鞠躬 | Bow |
+| 141 | emotion_180 | 选我 | PickMe |
+| 142 | emotion_209 | 元气满满 | FullOfVitality |
+| 143 | emotion_168 | 会议 | Meeting |
+| 144 | emotion_095 | 猫咪 | Kitty |
+| 145 | emotion_094 | 二哈 | Doggy |
+| 146 | emotion_097 | 狗子 | Puppy |
+| 147 | emotion_111 | 三多 | SanDuo |
+| 148 | emotion_153 | 承让 | LetMeWin |
+| 149 | emotion_154 | 撒花 | Celebration |
+| 150 | emotion_070 | 礼物 | Present |
+| 151 | emotion_104 | 生日快乐 | Birthday |
+| 152 | emotion_071 | 爱心 | Love |
+| 153 | emotion_072 | 心碎 | BrokenHeart |
+| 154 | emotion_073 | 嘴唇 | Lips |
+| 155 | emotion_074 | 鲜花 | Rose |
+| 156 | emotion_075 | 残花 | Wilted |
+| 157 | emotion_077 | 干杯 | Cheers |
+| 158 | emotion_151 | 咖啡 | Coffee |
+| 159 | emotion_152 | 奶茶 | MilkTea |
+| 160 | emotion_202 | 茶 | Tea |
+| 161 | emotion_218 | OKR | OKR |
+| 162 | emotion_109 | KPI | KPI |
+| 163 | emotion_108 | 100分 | 100 |
+| 164 | emotion_110 | 对勾 | Check |
+| 165 | emotion_192 | 打叉 | Wrong |
+| 166 | emotion_174 | 气泡 | Bubble |
+| 167 | emotion_157 | 加一 | PlusOne |
+| 168 | emotion_193 | Done | Done |
+| 169 | emotion_146 | 钉子 | Staple |
+| 170 | emotion_076 | 出差 | BusinessTrip |
+| 171 | emotion_181 | 高铁 | HighSpeedTrain |
+| 172 | emotion_184 | 火箭 | Rocket |
+| 173 | emotion_068 | 邮件 | Mail |
+| 174 | emotion_163 | 文档 | Document |
+| 175 | emotion_164 | 演示 | Presentation |
+| 176 | emotion_165 | 表格 | Sheet |
+| 177 | emotion_213 | 废纸篓 | Wastebasket |
+| 178 | emotion_237 | 手机 | MobilePhone |
+| 179 | emotion_203 | 时间 | Time |
+| 180 | emotion_217 | 静音 | mute |
+| 181 | emotion_201 | 公文包 | Briefcase |
+| 182 | emotion_214 | 地球 | Earth |
+| 183 | emotion_215 | 碳减排 | CarbonReduction |
+| 184 | emotion_216 | 回收标志 | RecyclingSymbol |
+| 185 | emotion_205 | 幼苗 | Seedling |
+| 186 | emotion_096 | 红包 | RedPacket |
+| 187 | emotion_150 | 锦鲤 | LuckyDog |
+| 188 | emotion_148 | 福 | Luck |
+| 189 | emotion_198 | 灯笼 | Lantern |
+| 190 | emotion_199 | 爆竹 | Firecrackers |
+| 191 | emotion_197 | 烟花 | Fireworks |
+| 192 | emotion_195 | 恭喜发财 | Prosperity |
+| 193 | emotion_161 | 月饼 | MoonCake |
+| 194 | emotion_173 | 鸡腿 | ChickenLeg |
+| 195 | emotion_169 | 休假 | Vacation |
+| 196 | emotion_175 | 火 | Hot |
+| 197 | emotion_223 | 点赞 | LikeHeartAndTripleSix |
+| 198 | emotion_196 | 平安健康 | Peace&Health |
+| 199 | emotion_200 | 定胜 | Victory |

package/skills/dws/dingtalk-chat/references/chat.md

@@ -0,0 +1,140 @@
+# Chat 低频原子能力索引
+
+> 返回入口：[DingTalk Chat Skill](../SKILL.md)
+
+本文件只用于根 Skill 和精确 task reference 都未覆盖的低频底层能力。普通发送、读取、搜索、
+建群、引用回复和查看置顶会话必须回到根 Skill 的 Golden Route，不在这里重新选路。
+
+## 使用边界
+
+1. 先确认任务确实需要 Shortcut 未发布的底层字段、原始响应或运维控制；
+2. 读取精确原子 leaf Schema/Help，不加载产品级 Catalog 猜参数；
+3. 自然目标仍必须唯一解析，禁止选择搜索结果第一项；
+4. 原子写 leaf 的 confirmation 若与对应 Golden Shortcut 不一致，停止并报告交付漂移；
+5. 后续 ID 只使用当前 profile 的真实返回，不跨组织复用；
+6. 完成后保留原始结果、partial failure 和可继续编排的稳定 ID。
+
+## 高频任务返回表
+
+| 用户终点 | 返回入口 |
+|---|---|
+| 姓名/群名简单发送、文件、Bot、Webhook、复杂 @ | 根 Skill Golden Route |
+| 消息读取、条件搜索、@我、Favorite/reaction 查询和批量详情 | [message-query](chat/message-query.md) |
+| 编辑、撤回、引用、转发、reaction/Pin/Top/Favorite 写入 | [message-actions](chat/message-actions.md) |
+| 位置、名片、资源下载和特殊媒体 fallback | [message-media](chat/message-media.md) |
+| 群列表、群搜索、成员读取、Bot 列表和邀请链接 | [group-discovery](chat/group-discovery.md) |
+| 建群、改群、成员写入、管理员、禁言、公告和群设置 | [group-admin](chat/group-admin.md) |
+| 跨步骤消息/群组合流程 | [消息任务级流程](01-messaging.md) |
+| Bot 搜索、进群和撤回 | [chat-bot](chat/chat-bot.md) |
+| 会话置顶、状态和分组 | [chat-conversation](chat/chat-conversation.md) |
+| 话题与话题圈的创建、发布、浏览、回复、互动和整条转发 | [thread](chat/thread.md) |
+| 相邻低频意图仍需消歧 | [intent-guide](intent-guide.md) |
+
+## 消息底层能力
+
+| 原子命令 | 仅用于 |
+|---|---|
+| `chat message send` | `+messages-send` 尚未发布的位置、名片等真实底层消息类型 |
+| `chat message list` | 需要原始响应或显式手工 continuation；普通浏览使用 `+chat-messages` |
+| `chat message list-all` | 指定时间范围的原始全会话分页接口 |
+| `chat message list-by-sender` | 需要原始按发送者响应；普通组合搜索使用 `+search-msg` |
+| `chat message list-mentions` / `list-focused` | 精确的 @我或特别关注原始列表 |
+| `chat message search` / `search-advanced` | `+search-msg` 未发布的底层过滤字段或原始响应 |
+| `chat message query-send-status` | 使用真实 `openTaskId` 查询用户消息投递任务 |
+| `chat message recall` / `edit` | 撤回或编辑已知消息 |
+| `chat message read-status` | 查询已知消息的已读/未读状态 |
+| `chat message reply` | `+messages-reply` 未发布的底层引用字段，且安全门禁已对齐 |
+| `chat message forward` / `combine-forward` | Shortcut 未覆盖的精确转发字段 |
+| `chat message download-media` | Shortcut 无法消费的已知底层 mediaId/fileId 引用 |
+
+消息对象管理：
+
+| 原子命令 | 对象 |
+|---|---|
+| `message set-pin-msg` / `unset-pin-msg` / `list-pin-msg` | 消息 Pin |
+| `message set-top-msg` / `unset-top-msg` | 会话内消息 Top |
+| `message add-favorite` / `remove-favorite` / `list-favorites` | 当前用户 Favorite |
+| `message add-emoji` / `remove-emoji` | 默认 emoji reaction |
+| `message create-text-emotion` / `add-text-emotion` / `update-text-emotion` / `remove-text-emotion` | 文字表情 |
+| `message list-emotion-replies` | 批量 reaction/文字回应 |
+| `emotion list` / `send` / `favorite` | 当前用户个人收藏表情列表、发送和新增 |
+
+Favorite、消息 Pin、消息 Top 与会话 Top 是四种对象，不能互换。
+个人收藏表情与消息 reaction/文字回应不同；发送收藏表情使用 `chat emotion send`，给已有消息贴表情使用 `chat message add-emoji` 或 `chat message add-text-emotion`。
+
+## 群与成员底层能力
+
+| 原子命令 | 用途 |
+|---|---|
+| `chat search` / `search-common` | 群管理前解析唯一群、查询共同群 |
+| `chat group get-by-group-id` | 数字群号转 `openConversationId` |
+| `chat group create` | `+chat-create` 尚未发布的真实底层创建字段；显式群主已由 Shortcut 覆盖 |
+| `chat group members` / `members list-by-ids` | 群成员分页和精确详情 |
+| `chat group members add` / `remove` | 添加/移除已知成员 ID |
+| `chat group members add-bot` / `remove-bot` / `group bots` | 机器人进群、移除和列表 |
+| `chat group rename` / `update-icon` | 群名和群头像 |
+| `chat group transfer-owner` / `set-admin` | 群主和管理员 |
+| `chat group upgrade-to-external` | 普通群升级外部群；不可逆 |
+| `chat group invite-url` / `share-invite` | 群邀请链接及分享 |
+| `chat group update-settings` / `user-settings query|set` | 管理员群开关或当前用户群偏好 |
+| `chat group update-nick` / `update-alias` | 当前用户群昵称和群备注 |
+| `chat group set-history` | 新成员历史消息可见范围 |
+| `chat group-mute` / `group-mute-member` | 全员或指定成员禁言 |
+| `chat group notice create|edit|get|list` | 群公告 |
+| `chat group list-my-groups` / `list-all` | 当前用户相关群列表 |
+| `chat group list-join-validations` / `audit-join-validation` | 入群审批 |
+| `chat group-role *` | 群身份定义与成员分配 |
+
+退出、解散群、踢人、转让群主、升级外部群、禁言、管理员和公告写入都属于高影响操作；
+必须以最终 Runtime gate/Schema 为准确认对象与影响。
+
+## Bot 与 Webhook 底层能力
+
+| 原子命令 | 用途 |
+|---|---|
+| `chat bot search` | 搜索当前用户创建的机器人并取得 `robotCode` |
+| `chat bot find` | 搜索可用机器人并取得机器人 `openDingTalkId` |
+| `chat message send-by-bot` | `+messages-send --as bot` 未发布的真实底层字段，包括机器人群聊引用回复的 `--reply` / `--ref-sender` |
+| `chat message recall-by-bot` | 使用 `processQueryKey` 撤回机器人消息 |
+| `chat message send-by-webhook` | `+messages-send --as webhook` 未发布的真实底层字段 |
+
+新发送流程统一使用 `+messages-send`。不得因看见 bot/webhook 原子命令就绕开统一身份能力矩阵。
+
+## 会话状态与分组
+
+| 原子命令 | 用途 |
+|---|---|
+| `chat conversation-info` | 已知稳定用户/群 ID 的会话详情 |
+| `chat list-all-conversations` | 全部会话原始分页列表 |
+| `chat list-top-conversations` | 需要原始响应时的置顶会话 fallback；普通查看使用 `+conversation-list-top` |
+| `chat set-top` | 设置/取消整个会话置顶 |
+| `chat mute` / `hide` / `mute-at-all` / `mute-red-envelope` | 会话通知与可见状态 |
+| `chat mark-unread` / `mark-read` | 会话未读或消息已读状态 |
+| `chat clear-red-point` / `clear-all-red-point` | 清除会话红点 |
+| `chat clear-messages` | 清空当前用户视角的会话记录 |
+| `chat category *` | 自定义/智能会话分组 |
+
+消息 Top 使用 `message set-top-msg`，整个会话 Top 使用 `chat set-top`，查看置顶会话使用
+`+conversation-list-top`。
+
+## 稳定 ID 传递
+
+| 来源 | 只可用于 |
+|---|---|
+| 唯一群解析 / `+chat-create` | 当前 profile 下的 `openConversationId` |
+| 唯一人员解析 | 当前 profile 下的 `userId` / `openDingTalkId` |
+| `+messages-send` | `openTaskId` 查询投递状态；它不是消息 ID |
+| `+chat-messages` / `+search-msg` / `+messages-mget` | 回复、转发、撤回、资源操作使用的真实消息/会话/thread ID |
+| `chat bot search` | `robotCode`；不能当机器人 `openDingTalkId` |
+| `chat message send-by-bot` | `processQueryKey` 用于机器人撤回；群聊引用回复还需消息查询返回的 `openMessageId` 与原发送者 `openDingTalkId` |
+
+显式稳定 ID 当前不携带可验证的 profile provenance；调用方必须保证来源，不得宣称所有
+跨 profile 误用都会在本地写入前被拦截。
+
+## 故障处理
+
+- `unknown command` / `unknown flag`：读取精确 leaf Help，最多修正一次；
+- confirmation 或参数约束不清：读取精确 leaf Schema，以最终 Runtime gate 为准；
+- 自然目标零命中/多候选：停止并展示候选，不选择第一项；
+- 权限、认证或 profile：按 `dingtalk-shared` 对应 reference 分流；
+- partial result：保留已完成项、失败 ledger、continuation 和真实错误，不换同义原子命令重试。

package/skills/dws/dingtalk-chat/references/contracts.md

@@ -0,0 +1,70 @@
+# IM 稳定契约与能力边界
+
+本页只记录需要跨命令复用的 Runtime 契约。下面四个 marker 区块由
+`check-multi-im-skill-chain.sh` 对照 Go typed descriptor 逐字校验；修改能力时先改 Runtime、
+测试与 descriptor，再同步本页。命令参数仍以精确 leaf Schema 为准。
+
+## 消息结果 `im.message-list.v1`
+
+`+chat-messages`、`+search-msg`、`+messages-mget` 及相关消息读取使用同一兼容版本。
+字段可能为空，但不能换名猜测；全量任务必须结合完整性 ledger 判断。
+
+<!-- DWS_MESSAGE_RESULT_CONTRACT_START -->
+- `version`: `im.message-list.v1`
+- `message_fields`: `messageId`, `conversationId`, `threadId`, `sender`, `senderId`, `senderType`, `messageType`, `text`, `createTime`, `updateTime`, `reactions`, `quotedMessage`, `forwarded`, `resourceRefs`
+- `envelope_fields`: `contractVersion`, `messages`, `count`, `resolvedFilters`, `queryRange`, `pagesFetched`, `paginationKnown`, `complete`, `hasMore`, `nextPage`, `stopReason`, `truncated`, `truncatedByPageLimit`, `truncatedByResultLimit`, `failedCount`, `failures`, `partial`, `scope`, `resourceDownloads`
+<!-- DWS_MESSAGE_RESULT_CONTRACT_END -->
+
+当 `complete=false` 时不能称为全量成功。`nextPage` 只能来自真实 lower boundary；
+`failedCount/failures`、`partial`、总 `truncated` 和两个原因字段必须原样保留。
+当 Runtime 解析并应用自然发送者条件时，`resolvedFilters.senders[]` 保留原查询及选中的
+`userId/openDingTalkId`。消息展示名可以与通讯录姓名不同；只能用稳定 `senderId` 与解析结果关联，
+不得重新做姓名字符串比较。
+
+当查询声明时间范围或顺序时，`queryRange` 保留规范化的 `startTime`、`endTime`、`order` 与
+`semantics=[start,end)`。排序只覆盖本次实际取得的 `messages`；`complete=false` 时不得把它描述为完整范围的全局排序。
+
+## `+messages-send` 身份矩阵
+
+<!-- DWS_IDENTITY_CAPABILITY_CONTRACT_START -->
+| identity | targets | content types | natural targets | mention targets | idempotency keys | batch ledger |
+|---|---|---|---|---|---:|---:|
+| `user` | `group`<br>`direct-user`<br>`direct-open-dingtalk-id` | `text`<br>`markdown`<br>`image-media-id`<br>`file`<br>`audio-as-file`<br>`video-as-file` | `chat-query`<br>`user-query` | `open-dingtalk-id`<br>`all` | `true` | `false` |
+| `bot` | `group`<br>`groups`<br>`direct-users`<br>`direct-open-dingtalk-ids` | `text`<br>`markdown` | — | `user-id`<br>`open-dingtalk-id`<br>`all` | `false` | `true` |
+| `webhook` | `token-owned-group` | `text`<br>`markdown` | — | `user-id`<br>`mobile`<br>`all` | `false` | `false` |
+<!-- DWS_IDENTITY_CAPABILITY_CONTRACT_END -->
+
+Bot 多群用 `--groups` 或 `--groups-file`，Runtime 去重后输出
+`im.batch-write.v1` 逐目标 ledger。Bot/Webhook 不支持的内容类型会在写前失败，不能降级为
+另一身份或偷偷改成纯文本。
+
+## 流式卡片
+
+<!-- DWS_CARD_WORKFLOW_CONTRACT_START -->
+- `version`: `im.streaming-card.v1`
+- `targets`: `group`, `direct-user`, `direct-open-dingtalk-id`
+- `content_types`: `streaming-text`
+- `flow_statuses`: `1=processing`, `2=typing`, `3=completed`, `4=executing`, `5=error`
+- `callback_supported`: `false`
+<!-- DWS_CARD_WORKFLOW_CONTRACT_END -->
+
+发送目标与状态范围由 Runtime 校验。当前不是 Lark Card JSON 编译器，也不消费按钮 callback；
+具体创建和更新流程见 `card/` 下的精确 reference。
+
+## 正向能力与负向边界
+
+<!-- DWS_CAPABILITY_BOUNDARY_CONTRACT_START -->
+| capability | supported | current route / boundary |
+|---|---:|---|
+| `thread-write` | `false` | quote reply with +messages-reply; thread reading with +thread-replies |
+| `bot-rich-media` | `false` | bot text/markdown, or current-user file/image send |
+| `card-action-callback` | `false` | streaming text card create/update only |
+| `resource-resume` | `false` | atomic whole-file download with explicit retry |
+| `group-member-full-pagination` | `true` | +chat-members-list or +group-members |
+| `group-owner-selection` | `true` | +chat-create owner flags |
+<!-- DWS_CAPABILITY_BOUNDARY_CONTRACT_END -->
+
+`supported=false` 是执行门禁，不是待猜测字段。只有 lower interface、Runtime、测试、Schema 和
+此页同时升级后，才能改变对外承诺。
+
+话题圈会话仍禁止引用消息回复；向 Thread 追加回复使用 `chat thread reply --conversation-id <openConvThreadId>`。