Dingtalk Chat

群聊/消息

<!-- DWS_RUNTIME_CONTRACT_START -->

最小 DWS 执行契约

• 只用 dws；结构化读取加 --format json，按真实返回判断。
• 已知命令直调；参数/约束/安全不明查 leaf 窄 Schema。Schema 不可用才读已知 leaf Help 一次；unknown flag 用同 leaf Help 修正一次。unknown command 不查 Help：优先错误中的明确 suggestion，其次已加载 Skill/reference 中的明确兼容入口；均无则报漂移并停，禁全 Catalog。低频 reference 不默认 Help，禁 root/parent/product Help。发现后必须执行或说明阻塞。
• 不猜命令/flag/字段/ID/账号/业务事实；ID 来自真实返回。目标零命中/多候选/类型不明先消歧；仅可选时间/展示范围用契约默认，缺必需信息即停。
• 解析/读/写同一 profile，ID 不跨组织。多账号只用唯一 isOrgCurrent=true；否则用户指定，禁止选择第一项、最近登录或最近使用账号。
• 不输出/记录 token、refresh token、appSecret、webhook token；已注入认证时不索要。
• 写须符合明确意图；确认以最终 Runtime gate/Schema 为准，确认后才加 --yes。
• 写后验证结果，不凭退出码宣称成功。退出须最终答复，区分完成、部分、阻塞、待确认、失败；保留已有数据及 complete/hasMore/stopReason/failures。
• 时间戳按会话时区展示，必要时保留原值。
• 认证/权限/profile/confirmation/未知错误只读 dingtalk-shared 对应 reference，禁连续猜替代命令。 <!-- DWS_RUNTIME_CONTRACT_END -->

对象与路由边界

• openConversationId 是会话，messageId/openMessageId 是消息，openTaskId 是发送任务，不可混用。
• 会话分组/分类走 category，群聊/聊天群走 chat group；会话列表无正文，总结/统计读消息。Pin/Top/Favorite 不是分类。

<!-- VISIBLE_SHORTCUTS_START -->

Shortcut 发现（Shortcut-first）

按 Golden Route/reference 选 Shortcut；仅缺底层字段用 atomic，低频走 reference/Catalog。

参数查 dws schema --cli-path "chat <leaf>" --compact --jq '{cli_path,parameters,constraints,confirmation}' -f json；仅需且已发布 result 时查 outcomes/pagination，字段级再查 data_schema；缺失不以 Help/样例推断。Schema 不可用才读一次已知 leaf Help；unknown flag 用同 leaf Help 修正一次。unknown command 禁 Help：错误 suggestion → 已加载 Skill/reference 明确入口；均无则报漂移。禁全 Catalog/root/parent/product Help；低频 reference 不默认 Help。 <!-- VISIBLE_SHORTCUTS_END -->

Golden Route

次级：Thread +thread-replies；<!-- dws-intent: chat.conversation.list-top -->置顶 dws chat +conversation-list-top；上传 conversation-file upload；IM 事件走 dingtalk-event。

关键结果语义

• 查询保留范围、数量、完整性、停止原因、失败/下载 ledger；不完整不得称成功。消息仅 --page-all 翻页，达预算返回有界 partial。
• 子消息用自身 messageId；缺 CID 才继承父 conversationId。写操作沿真实结果传 ID。

写生命周期

• 钉钉回复任务：接入方默认先发 A2UI 占位、执行中更新；主动发送默认完整投递。按占位与流式执行。
• 多步骤写先校验目标、限制、内容、确认，再沿稳定 ID 串行执行并验证；不截断或换目标。临时资源保留 ID/阶段，失败仅做已授权清理。

上下文预算

• Skill/Reference/leaf Schema/Help 各读一次；Schema 已给参数禁 Help。总结/统计/检索默认 --no-reactions，资源下载仅显式 opt-in。
• 用 --fields/--jq/limit/compact 预览，禁 head 截 JSON；大正文落文件，保留 ID、正文证据、下步字段、完整性和失败项。

按需加载

任务≤1个

错误最短路径

1. 零命中/多候选：停止写并消歧，禁默认第一项。
2. 参数/确认及未知 flag/command：按上方最小 DWS 执行契约处理，禁全 Catalog。
3. 仅 retryable=true 按原命令重试一次；API/internal/MCP、写后不一致或无重试性即停，不换 Shortcut/atomic。保留 Trace ID、已完成/待清理项并最终答复；confirmation_required 等用户确认，不补 --yes。