github/dingtalk-workspace-cli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
10d93f310ebabff53da3c25e2b14d2d3efbde672
dingtalk-workspace-cli/internal/cli/schema_hints/selection/chat.json
T

3576 lines
186 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-agent-selection/chat",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"chat.add_custom_group_role": {
"agent_summary": "在群聊中创建自定义角色",
"use_when": [
"需要新增可分配给群成员的业务角色时"
],
"avoid_when": [
"设置系统管理员角色时使用 chat group set-admin"
],
"examples": [
"dws chat group-role add --group <openConversationId> --name \"值班负责人\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.add_custom_group_role",
"cobra-help:dws chat group-role add",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.add_emoji_reaction": {
"agent_summary": "给指定消息添加表情回应",
"use_when": [
"需要对已有消息添加一个 emoji reaction 时"
],
"avoid_when": [
"发送文本消息或文字表情时不要使用"
],
"examples": [
"dws chat message add-emoji --conversation-id <openConversationId> --msg-id <openMessageId> --emoji \"赞\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.add_emoji_reaction",
"cobra-help:dws chat message add-emoji",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.add_group_member": {
"agent_summary": "向指定群聊添加成员",
"use_when": [
"已知群 ID 和成员 ID，需要邀请成员入群时"
],
"avoid_when": [
"添加机器人时使用 chat group members add-bot"
],
"examples": [
"dws chat group members add --id <openConversationId> --users userId1,userId2"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.add_group_member",
"cobra-help:dws chat group members add",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.add_message_favorite": {
"agent_summary": "将指定会话中的一条消息加入当前用户的收藏。",
"use_when": [
"用户明确要收藏一条已知消息，且已取得消息 ID 与所属会话 ID 时。"
],
"avoid_when": [
"需要给消息添加表情、置顶消息或发送新消息时不要使用；本命令只修改当前用户的收藏状态。"
],
"examples": [
"dws chat message add-favorite --open-message-id MSG_ID --open-conversation-id CONVERSATION_ID"
],
"reviewed": true,
"review_reason": "依据新增的真实 Cobra leaf、消息收藏实现和 chat 产品参考补齐 reviewed Agent 选择语义；不改变执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.add_message_favorite",
"cobra-help:dws chat message add-favorite --help",
"skills/mono/references/products/chat.md"
]
},
"chat.add_robot_to_group": {
"agent_summary": "把企业机器人拉进我有管理权限的群",
"use_when": [
"需要把已有企业机器人加入指定群"
],
"avoid_when": [
"添加普通成员时使用 chat group members add",
"移除群内机器人时使用 chat group members remove-bot"
],
"examples": [
"dws chat group members add-bot --robot-code <robot-code> --id <openconversation_id>"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.add_robot_to_group",
"cobra-help:dws chat group members add-bot",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md",
"live-dws-schema:bot.add_robot_to_group"
]
},
"chat.add_text_emotion": {
"agent_summary": "给指定消息添加已定义的文字表情",
"use_when": [
"已有文字表情定义并要附加到消息时"
],
"avoid_when": [
"需要先创建文字表情资源时使用 chat message create-text-emotion"
],
"examples": [
"dws chat message add-text-emotion --conversation-id <openConversationId> --msg-id <openMessageId> --emotion-id <emotionId> --emotion-name \"赞\" --text \"nice\" --background-id im_bg_5"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.add_text_emotion",
"cobra-help:dws chat message add-text-emotion",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.combine_forward_messages": {
"agent_summary": "把多条消息合并转发到目标会话",
"use_when": [
"需要保留多条源消息并作为合集转发时"
],
"avoid_when": [
"只转发单条消息时使用 chat message forward"
],
"examples": [
"dws chat message combine-forward --src-conversation-id <srcConversationId> --msg-ids <id1>,<id2> --dest-conversation-id <destConversationId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.combine_forward_messages",
"cobra-help:dws chat message combine-forward",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.create_and_send_card": {
"agent_summary": "创建并向群聊或单聊发送互动卡片",
"use_when": [
"需要卡片式交互且已准备接收会话或用户时"
],
"avoid_when": [
"只发送普通文本时使用 send 或 send-by-bot"
],
"examples": [
"dws chat message send-card --group <openConversationId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.create_and_send_card",
"cobra-help:dws chat message send-card",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.create_group_conversation": {
"agent_summary": "使用底层字段创建群聊并可指定群名与初始成员",
"use_when": [
"只有需要 +chat-create 尚未发布的 thread 等底层创建字段，并已取得稳定成员 ID 时使用"
],
"avoid_when": [
"普通内部/外部群创建或成员姓名需要唯一解析时使用 +chat-create",
"已有群只需加人时使用 chat group members add",
"只是搜索已有群时使用 chat search"
],
"examples": [
"dws chat group create --name \"Q1 项目冲刺群\" --users userId1,userId2,userId3"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.create_group_conversation",
"cobra-help:dws chat group create",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md",
"live-dws-schema:chat.create_group_conversation"
]
},
"chat.create_smart_conv_category": {
"agent_summary": "按名称、成员或关键词创建智能会话分组",
"use_when": [
"需要自动归集符合条件的会话时"
],
"avoid_when": [
"只需查看现有分组或手工管理会话时不要使用"
],
"examples": [
"dws chat category create-smart --name \"项目群\" --keywords \"项目,交付\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.create_smart_conv_category",
"cobra-help:dws chat category create-smart",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.create_text_emotion": {
"agent_summary": "创建可用于消息回应的文字表情",
"use_when": [
"需要定义新的文字表情资源时"
],
"avoid_when": [
"已有 emotionId 并要回应消息时使用 chat message add-text-emotion"
],
"examples": [
"dws chat message create-text-emotion --emotion-name \"赞\" --text \"nice\" --background-id im_bg_5"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.create_text_emotion",
"cobra-help:dws chat message create-text-emotion",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.dismiss_group": {
"agent_summary": "永久解散指定群聊（不可恢复，仅群主）",
"use_when": [
"群主明确要求永久解散整个群，而不是自己退出",
"已确认 openConversationId，且用户接受群与历史消息一并消失"
],
"avoid_when": [
"当前用户只想自己离开群时使用 chat group quit",
"仍需保留群供他人继续使用时不要解散",
"目标群未确认或用户未明确同意不可恢复后果时不要执行"
],
"examples": [
"dws chat group dismiss --group <openConversationId>"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.dismiss_group",
"cobra-help:dws chat group dismiss",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md",
"live-dws-schema:chat.dismiss_group",
"helper:internal/helpers/chat.go#dismiss --yes"
]
},
"chat.download_media": {
"agent_summary": "下载消息中的媒体资源到本地",
"use_when": [
"已知消息、会话和资源 ID，需要保存媒体文件时"
],
"avoid_when": [
"只查看文本消息内容时使用对应消息查询命令"
],
"examples": [
"dws chat message download-media --type mediaId --resource-id <mediaId> --message-id <openMessageId> --open-conversation-id <openConversationId> --output ."
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.download_media",
"cobra-help:dws chat message download-media",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.forward_message": {
"agent_summary": "把一条已有消息转发到另一个会话",
"use_when": [
"已知源消息与源、目标会话 ID 时"
],
"avoid_when": [
"合并转发多条消息时使用 chat message combine-forward"
],
"examples": [
"dws chat message forward --src-conversation-id <srcConversationId> --msg-id <openMessageId> --dest-conversation-id <destConversationId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.forward_message",
"cobra-help:dws chat message forward",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.forward_topic": {
"agent_summary": "把一个话题消息转发到目标会话",
"use_when": [
"需要转发话题圈中的主题及上下文时"
],
"avoid_when": [
"普通单条消息转发使用 chat message forward"
],
"examples": [
"dws chat message forward-topic --src-msg-id <openMessageId> --src-conversation-id <srcConversationId> --src-thread-id <threadId> --dest-conversation-id <destConversationId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.forward_topic",
"cobra-help:dws chat message forward-topic",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.get_conv_info_by_group_id": {
"agent_summary": "把数字群号解析为群聊信息",
"use_when": [
"用户只提供数字群号且需要 openConversationId 时"
],
"avoid_when": [
"已经持有 openConversationId 时直接使用目标命令"
],
"examples": [
"dws chat group get-by-group-id --group-id 12345678"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.get_conv_info_by_group_id",
"cobra-help:dws chat group get-by-group-id",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.get_conversation_info": {
"agent_summary": "获取群聊或单聊会话的详细信息",
"use_when": [
"已知群 ID 或用户标识并需要解析会话详情时"
],
"avoid_when": [
"按群名查找会话时使用 chat search"
],
"examples": [
"dws chat conversation-info --group <openConversationId> --format json"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.get_conversation_info",
"cobra-help:dws chat conversation-info",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.get_group_invite_url": {
"agent_summary": "获取指定群聊的邀请链接",
"use_when": [
"需要生成群邀请链接或设置有效期时"
],
"avoid_when": [
"需要直接添加已知成员时使用 chat group members add"
],
"examples": [
"dws chat group invite-url --group <openConversationId> --expires-seconds 86400"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.get_group_invite_url",
"cobra-help:dws chat group invite-url",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.list_conversation_message_v2": {
"agent_summary": "分页读取指定会话消息及其引用上下文",
"use_when": [
"需要 +chat-messages 未投影的原始响应字段或显式手工 continuation 时使用"
],
"avoid_when": [
"普通指定会话浏览、稳定消息投影或资源下载使用 +chat-messages",
"跨全部会话按时间查询时使用 chat message list-all"
],
"examples": [
"dws chat message list --group <openConversationId> --time \"2026-07-01 00:00:00\" --limit 50"
],
"reviewed": true,
"review_reason": "复核 dws-wukong 2026-07-14 读取能力同步：指定会话查询应保留 quotedMessage，并覆盖被引用的合并转发与图片内容；不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_conversation_message_v2",
"cobra-help:dws chat message list",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.list_conversations_by_category": {
"agent_summary": "列出指定会话分组中的会话",
"use_when": [
"已知分组 ID 并需要查看其中会话时"
],
"avoid_when": [
"只需列出分组本身时使用 chat category list"
],
"examples": [
"dws chat category list-conversations --category-id 123"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_conversations_by_category",
"cobra-help:dws chat category list-conversations",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.list_custom_group_roles": {
"agent_summary": "列出群聊中的自定义角色",
"use_when": [
"需要取得角色 ID 或查看角色定义时"
],
"avoid_when": [
"查询某个成员已分配角色时使用 chat group-role query-user"
],
"examples": [
"dws chat group-role list --group <openConversationId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_custom_group_roles",
"cobra-help:dws chat group-role list",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.list_group_bots": {
"agent_summary": "列出群内机器人",
"use_when": [
"需要查看某群已安装哪些机器人或提取 openBotId"
],
"avoid_when": [
"搜索企业内机器人目录时使用 chat bot find"
],
"examples": [
"dws chat group bots --group <openConversationId>"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_group_bots",
"cobra-help:dws chat group bots",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md",
"live-dws-schema:bot.list_group_bots"
]
},
"chat.list_individual_chat_message": {
"agent_summary": "读取与指定用户的单聊消息记录",
"use_when": [
"用户明确要求查看和某人的一对一聊天时"
],
"avoid_when": [
"跨群聊按发送者查询时使用 chat message list-by-sender"
],
"examples": [
"dws chat message list-direct --user <userId> --time \"2026-07-01 00:00:00\" --direction newer --limit 50"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_individual_chat_message",
"cobra-help:dws chat message list-direct",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.list_message_favorites": {
"agent_summary": "分页查询当前用户收藏的消息列表。",
"use_when": [
"需要查看当前用户已经收藏的消息，或使用 nextCursor 继续翻页时。"
],
"avoid_when": [
"需要搜索普通聊天记录、置顶消息或修改收藏状态时不要使用。"
],
"examples": [
"dws chat message list-favorites --cursor 0 --size 20"
],
"reviewed": true,
"review_reason": "依据新增的真实 Cobra leaf、数字游标分页契约和 chat 产品参考补齐 reviewed Agent 选择语义与示例。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_message_favorites",
"cobra-help:dws chat message list-favorites --help",
"skills/mono/references/products/chat.md"
]
},
"chat.list_messages_by_ids": {
"agent_summary": "按消息 ID 批量获取消息详情",
"use_when": [
"已经持有一组 msgId 并需要精确取回消息时"
],
"avoid_when": [
"只有关键词或时间范围时使用 search 或 list 命令"
],
"examples": [
"dws chat message list-by-ids --msg-ids msgId1,msgId2"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_messages_by_ids",
"cobra-help:dws chat message list-by-ids",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.list_owned_or_admin_groups": {
"agent_summary": "列出当前用户创建或管理的群聊",
"use_when": [
"需要按群主或管理员角色盘点群聊时"
],
"avoid_when": [
"按名称搜索任意可见群时使用 chat search"
],
"examples": [
"dws chat group list-my-groups --role OWNER --limit 100"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_owned_or_admin_groups",
"cobra-help:dws chat group list-my-groups",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.list_pin_messages": {
"agent_summary": "列出指定会话中的置顶消息",
"use_when": [
"需要查看群聊当前置顶的消息时"
],
"avoid_when": [
"设置或取消置顶时使用 set-pin-msg 或 unset-pin-msg"
],
"examples": [
"dws chat message list-pin-msg --open-conversation-id <openConversationId> --size 50"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_pin_messages",
"cobra-help:dws chat message list-pin-msg",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.list_special_focus_messages": {
"agent_summary": "列出当前用户特别关注的消息",
"use_when": [
"需要查看特别关注或重点消息列表时"
],
"avoid_when": [
"普通未读消息或提及消息使用对应专用命令"
],
"examples": [
"dws chat message list-focused --limit 50"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_special_focus_messages",
"cobra-help:dws chat message list-focused",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.list_top_conversations": {
"agent_summary": "以原始响应列出当前用户置顶的会话",
"use_when": [
"需要 +conversation-list-top 未投影的底层原始响应字段时使用"
],
"avoid_when": [
"普通查看置顶会话清单或按群聊/单聊过滤时使用 +conversation-list-top",
"设置或取消某个会话置顶时使用 chat set-top"
],
"examples": [
"dws chat list-top-conversations --limit 100"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_top_conversations",
"cobra-help:dws chat list-top-conversations",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.list_topic_replies": {
"agent_summary": "分页读取指定话题的回复",
"use_when": [
"已知话题 ID 并需要查看回复串时"
],
"avoid_when": [
"读取普通会话消息时使用 chat message list"
],
"examples": [
"dws chat message list-topic-replies --group <openConversationId> --topic-id <topicId> --limit 50"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_topic_replies",
"cobra-help:dws chat message list-topic-replies",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.list_user_define_conv_categories": {
"agent_summary": "列出当前用户的自定义会话分组",
"use_when": [
"需要取得分组 ID 或浏览分组配置时"
],
"avoid_when": [
"需要查看某个分组内会话时使用 chat category list-conversations"
],
"examples": [
"dws chat category list"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.list_user_define_conv_categories",
"cobra-help:dws chat category list",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.query_custom_user_roles": {
"agent_summary": "查询指定群成员的自定义角色",
"use_when": [
"需要核对某个成员在群内的业务角色时"
],
"avoid_when": [
"列出全部角色定义时使用 chat group-role list"
],
"examples": [
"dws chat group-role query-user --group <openConversationId> --user <userId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.query_custom_user_roles",
"cobra-help:dws chat group-role query-user",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.query_message_send_status": {
"agent_summary": "查询异步消息发送任务的状态",
"use_when": [
"发送命令返回 openTaskId 后需要确认投递结果时"
],
"avoid_when": [
"没有 openTaskId 或只需查消息内容时不要使用"
],
"examples": [
"dws chat message query-send-status --open-task-id <openTaskId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.query_message_send_status",
"cobra-help:dws chat message query-send-status",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.query_msg_read_status": {
"agent_summary": "查询指定消息的已读状态和人员",
"use_when": [
"已知会话 ID 与消息 ID，需要核对阅读情况时"
],
"avoid_when": [
"查看哪些会话未读时使用 chat message list-unread-conversations"
],
"examples": [
"dws chat message read-status --conversation-id <openConversationId> --message-id <openMessageId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.query_msg_read_status",
"cobra-help:dws chat message read-status",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.quit_group": {
"agent_summary": "当前用户退出群聊，群本身保留",
"use_when": [
"用户只要自己离开某个群，不需要解散群"
],
"avoid_when": [
"需要永久解散整个群时使用 chat group dismiss",
"需要踢出其他成员时使用 chat group members remove"
],
"examples": [
"dws chat group quit --group <openConversationId>"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.quit_group",
"cobra-help:dws chat group quit",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md",
"live-dws-schema:chat.quit_group"
]
},
"chat.recall_message": {
"agent_summary": "撤回当前用户已发送的单条消息",
"use_when": [
"已知会话与消息 ID，需要撤回自己发出的那条消息"
],
"avoid_when": [
"撤回机器人消息时使用 chat message recall-by-bot",
"消息 ID 未确认时先用消息查询/搜索拿到 openMessageId"
],
"examples": [
"dws chat message recall --conversation-id <openConversationId> --msg-id <openMessageId>"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.recall_message",
"cobra-help:dws chat message recall",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md",
"live-dws-schema:chat.recall_message"
]
},
"chat.recall_robot_message": {
"agent_summary": "撤回指定机器人发送的消息",
"use_when": [
"持有 robotCode 和发送结果 key，需要撤回机器人消息时"
],
"avoid_when": [
"个人身份消息撤回使用 chat message recall"
],
"examples": [
"dws chat message recall-by-bot --robot-code <robotCode> --group <openConversationId> --keys <processQueryKey>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.recall_robot_message",
"cobra-help:dws chat message recall-by-bot",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.remove_custom_group_role": {
"agent_summary": "删除群聊中的自定义角色",
"use_when": [
"明确要移除整个自定义角色定义时"
],
"avoid_when": [
"只取消某个成员的角色时使用 chat group-role remove-user"
],
"examples": [
"dws chat group-role remove --group <openConversationId> --role-id <openRoleId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.remove_custom_group_role",
"cobra-help:dws chat group-role remove",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.remove_custom_user_roles": {
"agent_summary": "取消指定成员的一个或多个自定义角色",
"use_when": [
"需要保留角色定义但解除成员角色时"
],
"avoid_when": [
"删除角色定义本身时使用 chat group-role remove"
],
"examples": [
"dws chat group-role remove-user --group <openConversationId> --user <userId> --role-ids roleId1,roleId2"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.remove_custom_user_roles",
"cobra-help:dws chat group-role remove-user",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.remove_emoji_reaction": {
"agent_summary": "移除指定消息上的表情回应",
"use_when": [
"需要取消此前添加的 emoji reaction 时"
],
"avoid_when": [
"移除文字表情时使用 chat message remove-text-emotion"
],
"examples": [
"dws chat message remove-emoji --conversation-id <openConversationId> --msg-id <openMessageId> --emoji \"赞\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.remove_emoji_reaction",
"cobra-help:dws chat message remove-emoji",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.remove_group_member": {
"agent_summary": "从指定群聊移除成员",
"use_when": [
"群管理员明确要移除一个或多个普通成员时"
],
"avoid_when": [
"移除机器人时使用 chat group members remove-bot"
],
"examples": [
"dws chat group members remove --id <openConversationId> --users userId1,userId2"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.remove_group_member",
"cobra-help:dws chat group members remove",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.remove_message_favorite": {
"agent_summary": "取消当前用户对指定消息的收藏标记，不删除原消息。",
"use_when": [
"用户明确要从个人收藏中移除一条已知消息时。"
],
"avoid_when": [
"需要撤回或删除原消息、移除表情回应或取消消息置顶时不要使用。"
],
"examples": [
"dws chat message remove-favorite --open-message-id MSG_ID --open-conversation-id CONVERSATION_ID"
],
"reviewed": true,
"review_reason": "依据新增的真实 Cobra leaf、取消收藏实现和 chat 产品参考补齐 reviewed Agent 选择语义；明确其不会删除原消息。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.remove_message_favorite",
"cobra-help:dws chat message remove-favorite --help",
"skills/mono/references/products/chat.md"
]
},
"chat.remove_robot_in_group": {
"agent_summary": "从群内移除指定机器人",
"use_when": [
"需要把某个机器人踢出指定群"
],
"avoid_when": [
"移除普通成员时使用 chat group members remove",
"解散整个群时使用 chat group dismiss"
],
"examples": [
"dws chat group members remove-bot --id <openConversationId> --bot-id <openBotId>"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.remove_robot_in_group",
"cobra-help:dws chat group members remove-bot",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md",
"live-dws-schema:bot.remove_robot_in_group"
]
},
"chat.remove_text_emotion": {
"agent_summary": "移除指定消息上的文字表情回应",
"use_when": [
"需要取消已添加的文字表情时"
],
"avoid_when": [
"移除普通 emoji reaction 时使用 chat message remove-emoji"
],
"examples": [
"dws chat message remove-text-emotion --conversation-id <openConversationId> --msg-id <openMessageId> --emotion-id <emotionId> --emotion-name \"赞\" --text \"nice\" --background-id im_bg_5"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.remove_text_emotion",
"cobra-help:dws chat message remove-text-emotion",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.reply_personal_message": {
"agent_summary": "使用底层引用字段发送个人回复",
"use_when": [
"只有 +messages-reply 未发布必需的底层引用字段，且 Runtime confirmation 已对齐时使用"
],
"avoid_when": [
"普通纯文本引用回复使用 +messages-reply",
"无需引用上下文的普通消息使用 chat message send"
],
"examples": [
"dws chat message reply --conversation-id <openConversationId> --ref-msg-id <openMessageId> --ref-sender <openDingTalkId> --text \"收到\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.reply_personal_message",
"cobra-help:dws chat message reply",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.search_at_me_message": {
"agent_summary": "查询指定时间范围内提及当前用户的消息",
"use_when": [
"需要找出 @我的消息和待关注事项时"
],
"avoid_when": [
"查询全部消息时使用 chat message list-all"
],
"examples": [
"dws chat message list-mentions --start \"2026-07-01T00:00:00+08:00\" --end \"2026-07-02T00:00:00+08:00\" --limit 50"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.search_at_me_message",
"cobra-help:dws chat message list-mentions",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.search_bots": {
"agent_summary": "按关键词搜索企业机器人并拿到 openDingTalkId",
"use_when": [
"要找可用机器人并提取 openDingTalkId（例如后续单聊机器人）"
],
"avoid_when": [
"只查我创建的机器人时使用 chat bot search",
"已有 robot-code 直接发消息时不要先搜"
],
"examples": [
"dws chat bot find --query \"日报\""
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.search_bots",
"cobra-help:dws chat bot find",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md",
"live-dws-schema:bot.search_bots",
"interface_ref:bot.search_bots"
]
},
"chat.search_common_groups": {
"agent_summary": "查询指定人员共同所在的群聊",
"use_when": [
"需要找两人或多人共同群聊时"
],
"avoid_when": [
"按群名称搜索时使用 chat search"
],
"examples": [
"dws chat search-common --nicks \"张三,李四\" --match-mode all --limit 20"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.search_common_groups",
"cobra-help:dws chat search-common",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.search_groups": {
"agent_summary": "按关键词搜索群聊并拿到 openConversationId",
"use_when": [
"只知道群名关键词，需要定位群并提取 openConversationId"
],
"avoid_when": [
"已有群号时用 chat group get-by-group-id",
"查我创建/管理的群用 chat group list-my-groups",
"查与某人的共同群用 chat search-common"
],
"examples": [
"dws chat search --query \"项目冲刺\"",
"dws chat search --query \"项目冲刺\" --limit 20 --cursor 0"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.search_groups",
"cobra-help:dws chat search",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md",
"live-dws-schema:chat.search_groups"
]
},
"chat.search_messages": {
"agent_summary": "使用底层原始过滤字段搜索消息",
"use_when": [
"需要 +search-msg 尚未发布的原始过滤字段或原始响应时使用"
],
"avoid_when": [
"普通跨会话关键词、发送者、@、会话或消息类型组合搜索使用 +search-msg",
"只需拉取某会话时间线时使用 chat message list",
"只需某人发给我的消息时使用 chat message list-by-sender"
],
"examples": [
"dws chat message search-advanced --query \"周报\" --start \"2026-04-01T00:00:00+08:00\" --end \"2026-04-15T00:00:00+08:00\""
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.search_messages",
"cobra-help:dws chat message search-advanced",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md",
"live-dws-schema:chat.search_messages"
]
},
"chat.search_messages_by_keyword": {
"agent_summary": "使用底层简单查询接口按关键词和时间范围搜索消息",
"use_when": [
"只有 +search-msg 无法表达且明确需要底层简单搜索接口原始响应时使用"
],
"avoid_when": [
"普通关键词搜索和全量翻页使用 +search-msg",
"需要多会话、发送者或 @维度组合时使用 search-advanced"
],
"examples": [
"dws chat message search --query \"发布计划\" --start \"2026-07-01T00:00:00+08:00\" --end \"2026-07-10T00:00:00+08:00\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.search_messages_by_keyword",
"cobra-help:dws chat message search",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.search_messages_by_sender": {
"agent_summary": "按发送者和时间范围查询消息",
"use_when": [
"需要查某人发送过的消息且不限定单聊时"
],
"avoid_when": [
"明确查询与某人的单聊记录时使用 chat message list-direct"
],
"examples": [
"dws chat message list-by-sender --sender-user-id <userId> --start \"2026-07-01T00:00:00+08:00\" --end \"2026-07-02T00:00:00+08:00\" --limit 50"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.search_messages_by_sender",
"cobra-help:dws chat message list-by-sender",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.search_messages_by_time_range": {
"agent_summary": "按时间范围搜索跨会话消息并保留权益指引",
"use_when": [
"需要汇总一段时间内所有可见会话消息时"
],
"avoid_when": [
"已指定单个会话时优先使用 chat message list"
],
"examples": [
"dws chat message list-all --start \"2026-07-01 00:00:00\" --end \"2026-07-02 00:00:00\" --limit 50"
],
"reviewed": true,
"review_reason": "复核 dws-wukong 2026-07-14 搜索能力同步：跨会话消息搜索遇到权益限制时应向用户展示服务端指引，而不是解释为空结果；不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.search_messages_by_time_range",
"cobra-help:dws chat message list-all",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.search_my_robots": {
"agent_summary": "搜索我创建的企业机器人并提取 robot-code",
"use_when": [
"需要我自己创建的机器人及其 robot-code"
],
"avoid_when": [
"搜索全部可用企业机器人时使用 chat bot find"
],
"examples": [
"dws chat bot search --page 1 --size 10 --name \"日报\""
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.search_my_robots",
"cobra-help:dws chat bot search",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md",
"live-dws-schema:bot.search_my_robots"
]
},
"chat.send_message_by_custom_robot": {
"agent_summary": "使用底层 Webhook 接口向群发送消息",
"use_when": [
"只有 +messages-send 未发布必需的 Webhook 底层字段，且 Runtime confirmation 已对齐时使用"
],
"avoid_when": [
"普通 Webhook 文本、Markdown 和 @发送使用 +messages-send --as webhook",
"使用企业机器人 robot-code 发消息时用 chat message send-by-bot",
"以个人身份发消息时用 chat message send"
],
"examples": [
"dws chat message send-by-webhook --token <webhook-token> --title \"告警\" --text \"CPU 超 90%\" --at-all"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.send_message_by_custom_robot",
"cobra-help:dws chat message send-by-webhook",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md",
"live-dws-schema:bot.send_message_by_custom_robot"
]
},
"chat.send_personal_message": {
"agent_summary": "使用当前用户底层消息类型或原始响应发送群聊或单聊消息",
"use_when": [
"只有 +messages-send 未发布的位置、名片等底层消息类型，且 Runtime confirmation 已对齐时使用"
],
"avoid_when": [
"按姓名发送简单文本使用 +dm，按群名发送简单文本使用 +send-to-group",
"已知 ID、文件、复杂 @ 或幂等发送使用 +messages-send",
"机器人身份或 Webhook 发送应使用对应命令"
],
"examples": [
"dws chat message send --group <openConversationId> \"项目已更新\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.send_personal_message",
"cobra-help:dws chat message send",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.send_robot_message": {
"agent_summary": "使用底层机器人接口发送群消息或批量单聊",
"use_when": [
"只有 +messages-send 未发布必需的机器人底层字段，且 Runtime confirmation 已对齐时使用"
],
"avoid_when": [
"普通 robotCode 文本、Markdown、群聊、批量单聊或 @发送使用 +messages-send --as bot",
"个人身份发送或自定义 Webhook 告警不要使用"
],
"examples": [
"dws chat message send-by-bot --robot-code <robotCode> --group <openConversationId> --title \"日报\" --text \"今日进展\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.send_robot_message",
"cobra-help:dws chat message send-by-bot",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.set_custom_user_roles": {
"agent_summary": "为指定群成员设置自定义角色",
"use_when": [
"需要把一个或多个已有角色分配给成员时"
],
"avoid_when": [
"创建新角色定义时使用 chat group-role add"
],
"examples": [
"dws chat group-role set-user --group <openConversationId> --user <userId> --role-ids roleId1,roleId2"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.set_custom_user_roles",
"cobra-help:dws chat group-role set-user",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.set_group_member_mute_list": {
"agent_summary": "禁言或解除禁言指定群成员",
"use_when": [
"需要按成员设置禁言时长或解除禁言时"
],
"avoid_when": [
"需要全员禁言时使用 chat group-mute"
],
"examples": [
"dws chat group-mute-member --group <openConversationId> --users userId1,userId2 --mute-time 3600000"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.set_group_member_mute_list",
"cobra-help:dws chat group-mute-member",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.set_group_mute": {
"agent_summary": "开启或关闭群聊全员禁言",
"use_when": [
"需要控制整个群的发言权限时"
],
"avoid_when": [
"只禁言指定成员时使用 chat group-mute-member"
],
"examples": [
"dws chat group-mute --group <openConversationId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.set_group_mute",
"cobra-help:dws chat group-mute",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.set_pin_message": {
"agent_summary": "把指定消息设为会话置顶消息",
"use_when": [
"需要在会话中置顶一条已知消息时"
],
"avoid_when": [
"取消置顶使用 chat message unset-pin-msg"
],
"examples": [
"dws chat message set-pin-msg --open-conversation-id <openConversationId> --msg-id <openMessageId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.set_pin_message",
"cobra-help:dws chat message set-pin-msg",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.set_top_conversation": {
"agent_summary": "设置或取消指定会话置顶",
"use_when": [
"需要改变某个会话在列表中的置顶状态时"
],
"avoid_when": [
"只查看置顶清单时使用 chat list-top-conversations"
],
"examples": [
"dws chat set-top --conversation-id <openConversationId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.set_top_conversation",
"cobra-help:dws chat set-top",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.transfer_group_owner": {
"agent_summary": "把群主身份转让给指定群成员",
"use_when": [
"现群主明确指定新群主时"
],
"avoid_when": [
"只是授予管理员权限时使用 chat group set-admin"
],
"examples": [
"dws chat group transfer-owner --group <openConversationId> --new-owner <openDingTalkId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.transfer_group_owner",
"cobra-help:dws chat group transfer-owner",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.unread_message_conversation_list": {
"agent_summary": "列出当前用户存在未读消息的会话",
"use_when": [
"需要定位哪些会话还有未读内容时"
],
"avoid_when": [
"查询某条消息的已读人员时使用 chat message read-status"
],
"examples": [
"dws chat message list-unread-conversations --count 50"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.unread_message_conversation_list",
"cobra-help:dws chat message list-unread-conversations",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.unset_pin_message": {
"agent_summary": "取消指定消息的会话置顶",
"use_when": [
"需要移除一条已知置顶消息时"
],
"avoid_when": [
"新增置顶使用 chat message set-pin-msg"
],
"examples": [
"dws chat message unset-pin-msg --open-conversation-id <openConversationId> --msg-id <openMessageId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.unset_pin_message",
"cobra-help:dws chat message unset-pin-msg",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.update_conv_member_roles": {
"agent_summary": "设置或取消群管理员角色",
"use_when": [
"需要变更指定成员的群管理员身份时"
],
"avoid_when": [
"自定义业务角色应使用 chat group-role 系列命令"
],
"examples": [
"dws chat group set-admin --group <openConversationId> --users userId1,userId2"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.update_conv_member_roles",
"cobra-help:dws chat group set-admin",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.update_custom_group_role": {
"agent_summary": "更新群聊自定义角色的名称",
"use_when": [
"已知角色 ID 并需要重命名该角色时"
],
"avoid_when": [
"需要变更成员角色分配时使用 set-user 或 remove-user"
],
"examples": [
"dws chat group-role update --group <openConversationId> --role-id <openRoleId> --name \"新名称\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.update_custom_group_role",
"cobra-help:dws chat group-role update",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.update_group_icon": {
"agent_summary": "使用真实媒体 ID 更新群头像",
"use_when": [
"已有上传后的头像 mediaId 并要修改群头像时"
],
"avoid_when": [
"没有真实可用 mediaId 时先完成媒体上传"
],
"examples": [
"dws chat group update-icon --group <openConversationId> --icon-media-id @mediaId"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.update_group_icon",
"cobra-help:dws chat group update-icon",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.update_group_name": {
"agent_summary": "修改指定群聊的名称",
"use_when": [
"需要给已有群聊重命名时"
],
"avoid_when": [
"只修改个人可见备注时不要使用群名称更新"
],
"examples": [
"dws chat group rename --id <openConversationId> --name \"新群名\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.update_group_name",
"cobra-help:dws chat group rename",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.update_group_settings": {
"agent_summary": "更新指定群聊的一项设置开关",
"use_when": [
"需要调整 searchable、入群验证或群权限等设置时"
],
"avoid_when": [
"全员禁言和成员禁言使用专门的 mute 命令"
],
"examples": [
"dws chat group update-settings --group <openConversationId> --setting-key searchable --status 1"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.update_group_settings",
"cobra-help:dws chat group update-settings",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.update_notification_off": {
"agent_summary": "开启或关闭指定会话的免打扰",
"use_when": [
"用户明确要静音或恢复某个会话通知时"
],
"avoid_when": [
"群成员禁言属于发言权限，应使用 group-mute 命令"
],
"examples": [
"dws chat mute --conversation-id <openConversationId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.update_notification_off",
"cobra-help:dws chat mute",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.update_show_history_msg_option": {
"agent_summary": "设置新成员可见的群历史消息范围",
"use_when": [
"需要调整新成员入群后的历史消息可见性时"
],
"avoid_when": [
"普通消息查询或群设置的其他开关不要使用"
],
"examples": [
"dws chat group set-history --group <openConversationId> --option RECENT_100"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.update_show_history_msg_option",
"cobra-help:dws chat group set-history",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.update_streaming_card": {
"agent_summary": "更新已发送流式卡片的内容和状态",
"use_when": [
"已有 bizId 并需要追加内容或结束流式输出时"
],
"avoid_when": [
"创建新卡片时使用 chat message send-card"
],
"examples": [
"dws chat message update-card --biz-id <bizId> --content \"处理完成\" --flow-status 2"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.update_streaming_card",
"cobra-help:dws chat message update-card",
"skills/mono/SKILL.md",
"skills/mono/references/products/chat.md"
]
},
"chat.edit_message": {
"agent_summary": "编辑当前用户已发送消息的 Markdown 内容",
"use_when": [
"已有会话 openConversationId 和消息 openMessageId，需要更正已发送消息的标题、正文或 @ 信息"
],
"avoid_when": [
"发送新消息应使用 chat message send；撤回消息应使用 chat message recall"
],
"examples": [
"dws chat message edit --conversation-id <openConversationId> --msg-id <openMessageId> --text \"更新后的内容\""
],
"reviewed": true,
"review_reason": "依据新增 Cobra leaf、消息内容构造逻辑和 Wukong 对齐实现审阅编辑消息的选择边界与可执行参数组合。",
"source_refs": [
"CommandRegistry:canonical_path=chat.edit_message",
"cobra-help:dws chat message edit",
"Wukong-parity:3306c3307",
"live-dws-schema:chat.edit_message#FAILED"
]
},
"chat.get_conv_categories_info": {
"agent_summary": "按分组 ID 批量获取自定义会话分组详情",
"use_when": [
"已经有一个或多个会话分组 categoryId，需要批量读取分组信息"
],
"avoid_when": [
"不知道 categoryId 时先用 chat category list；按会话反查所属分组应使用 chat category list-by-conv"
],
"examples": [
"dws chat category batch-info --category-ids 123,456"
],
"reviewed": true,
"review_reason": "依据新增 Cobra leaf、整数列表解析和 Wukong 对齐实现审阅批量分组详情的选择边界与示例。",
"source_refs": [
"CommandRegistry:canonical_path=chat.get_conv_categories_info",
"cobra-help:dws chat category batch-info",
"Wukong-parity:3306c3307",
"live-dws-schema:chat.get_conv_categories_info#FAILED"
]
},
"chat.list_conv_categories_by_conv": {
"agent_summary": "查询指定会话所属的自定义会话分组",
"use_when": [
"已有会话 openConversationId，需要反查该会话被放入了哪些自定义分组"
],
"avoid_when": [
"列出全部自定义分组应使用 chat category list；按 categoryId 查详情应使用 chat category batch-info"
],
"examples": [
"dws chat category list-by-conv --group <openConversationId>"
],
"reviewed": true,
"review_reason": "依据新增 Cobra leaf、会话定位别名和 Wukong 对齐实现审阅按会话反查分组的选择边界与示例。",
"source_refs": [
"CommandRegistry:canonical_path=chat.list_conv_categories_by_conv",
"cobra-help:dws chat category list-by-conv",
"Wukong-parity:3306c3307",
"live-dws-schema:chat.list_conv_categories_by_conv#FAILED"
]
},
"chat.update_group_nick": {
"agent_summary": "设置或清除当前用户在指定群内的昵称",
"use_when": [
"用户要求修改自己的群昵称，或明确要求清除群昵称"
],
"avoid_when": [
"修改群名称应使用 chat group rename；修改其他成员信息不应使用本命令"
],
"examples": [
"dws chat group update-nick --group <openConversationId> --nick \"项目昵称\"",
"dws chat group update-nick --group <openConversationId>"
],
"reviewed": true,
"review_reason": "依据现有 Cobra leaf的新清除语义和 Wukong 对齐实现审阅设置与省略 --nick 清除两种结果。",
"source_refs": [
"CommandRegistry:canonical_path=chat.update_group_nick",
"cobra-help:dws chat group update-nick",
"Wukong-parity:3306c3307",
"live-dws-schema:chat.update_group_nick#FAILED"
]
},
"chat.upgrade_group_to_external": {
"agent_summary": "不可逆地把已有普通群升级为外部群",
"use_when": [
"群主明确要求保留现有会话并升级为可跨组织协作的外部群，且已确认不可逆影响"
],
"avoid_when": [
"新建外部群应使用 chat group create --type EXTERNAL；未确认群主身份和不可逆影响时不要执行"
],
"examples": [
"dws chat group upgrade-to-external --group <openConversationId>"
],
"reviewed": true,
"review_reason": "依据新增 Cobra leaf、不可逆确认门禁和 Wukong 对齐实现审阅普通群升级外部群的严格选择边界与无 --yes 合约示例。",
"source_refs": [
"CommandRegistry:canonical_path=chat.upgrade_group_to_external",
"cobra-help:dws chat group upgrade-to-external",
"Wukong-parity:3306c3307",
"live-dws-schema:chat.upgrade_group_to_external#FAILED"
]
},
"chat.shortcut_bot_search": {
"agent_summary": "搜索当前用户自己创建的机器人",
"use_when": [
"当你要管理或复用自己创建的机器人（比如查到其 robotCode 以便让它进群或发消息）时使用；按机器人名称模糊搜索，只返回当前用户名下创建的机器人列表。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +bot-search --page 1 --name \"日报\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_bot_search",
"cobra-help:dws chat +bot-search",
"ShortcutRegistry:chat +bot-search"
]
},
"chat.shortcut_bot_find": {
"agent_summary": "搜索全部可用机器人（含他人/官方，返回 openDingTalkId 可发单聊）",
"use_when": [
"当你想找到平台上任意可用机器人（含他人创建或官方助手，例如某个日报/审批机器人）以便与其发起单聊时使用；输入关键词，返回含 openDingTalkId 的机器人列表。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +bot-find --query \"日报\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_bot_find",
"cobra-help:dws chat +bot-find",
"ShortcutRegistry:chat +bot-find"
]
},
"chat.shortcut_conversation_info": {
"agent_summary": "获取会话信息（群聊传 --group，单聊传 --open-dingtalk-id）",
"use_when": [
"当你已有群 openConversationId 或单聊对方 openDingTalkId、需要查看该会话的名称/类型/成员数等基础信息时使用；只读，群聊传 --group、单聊传 --open-dingtalk-id 二选一。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +conversation-info --group <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_conversation_info",
"cobra-help:dws chat +conversation-info",
"ShortcutRegistry:chat +conversation-info"
]
},
"chat.shortcut_conversation_clear_all_red_point": {
"agent_summary": "清除所有会话红点（全部已读）",
"use_when": [
"当你想一键把全部会话标记为已读、清空所有红点时使用；会实际清除当前用户所有会话的红点，无需任何参数。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +conversation-clear-all-red-point"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_conversation_clear_all_red_point",
"cobra-help:dws chat +conversation-clear-all-red-point",
"ShortcutRegistry:chat +conversation-clear-all-red-point"
]
},
"chat.shortcut_conversation_list": {
"agent_summary": "分页或一键全量获取当前用户的会话列表（单聊+群聊）",
"use_when": [
"当你想遍历当前用户的所有会话（单聊+群聊）做统计、清理或批量处理时使用；默认读取一页，明确要求全部时使用 --page-all，CLI 会按服务端每页上限自动翻页并公开完整性 ledger；可用 --exclude-muted 排除已免打扰会话。"
],
"avoid_when": [
"只查看置顶会话时使用 +conversation-list-top；不要用原子 list-all-conversations 加超出服务端上限的 --limit 冒充全量。"
],
"examples": [
"dws chat +conversation-list --page-all --limit 100"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_conversation_list",
"cobra-help:dws chat +conversation-list",
"ShortcutRegistry:chat +conversation-list"
]
},
"chat.shortcut_conversation_list_top": {
"agent_summary": "拉取置顶会话列表，可只看群聊或单聊",
"use_when": [
"当你只想查看被置顶的那些会话时使用；只读分页返回置顶会话列表，并把下层 singleChat 规范化为 conversationType=group|direct。可用 --type group 只看群聊、--type direct 只看单聊，或用 --exclude-muted 排除已免打扰会话。"
],
"avoid_when": [
"用户要查看群内被 Pin 的消息而不是侧边栏置顶会话时，改用 +messages-list-pin"
],
"examples": [
"dws chat +conversation-list-top --type group --limit 1000",
"dws chat +conversation-list-top --type direct --limit 1000"
],
"reviewed": true,
"review_reason": "Reviewed after live testing list_top_conversations: singleChat is present on every tested row and is normalized locally to group/direct without adding a lower-service parameter.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_conversation_list_top",
"cobra-help:dws chat +conversation-list-top",
"ShortcutRegistry:chat +conversation-list-top"
]
},
"chat.shortcut_category_list": {
"agent_summary": "获取用户自定义会话分组",
"use_when": [
"当你想查看当前用户自建了哪些会话分组（如'工作群''项目群'）时使用；只读返回分组列表及其 categoryId，供后续按分组拉会话或增删。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +category-list"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_category_list",
"cobra-help:dws chat +category-list",
"ShortcutRegistry:chat +category-list"
]
},
"chat.shortcut_category_create": {
"agent_summary": "创建用户自定义会话分组",
"use_when": [
"当你想新建一个会话分组来归类会话时使用；会实际创建分组并返回其 ID，需传最多 15 个字符的分组名称 --title。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +category-create --title \"工作群\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_category_create",
"cobra-help:dws chat +category-create",
"ShortcutRegistry:chat +category-create"
]
},
"chat.shortcut_category_delete": {
"agent_summary": "删除用户自定义会话分组",
"use_when": [
"当你想删除某个自定义会话分组时使用；会实际删除分组（不影响其中会话本身），不可逆，需传 categoryId。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +category-delete --category-id <分组ID>"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_category_delete",
"cobra-help:dws chat +category-delete",
"ShortcutRegistry:chat +category-delete"
]
},
"chat.shortcut_category_rename": {
"agent_summary": "更新用户自定义会话分组的名称",
"use_when": [
"当你想重命名已有的自定义会话分组时使用；会实际更新分组名称，需传 categoryId 和最多 15 个字符的新名称 --title。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +category-rename --category-id <分组ID> --title \"新名称\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_category_rename",
"cobra-help:dws chat +category-rename",
"ShortcutRegistry:chat +category-rename"
]
},
"chat.shortcut_chat_search": {
"agent_summary": "按关键词搜索群聊",
"use_when": [
"当你只记得群名称关键词、需要拿到群 openConversationId 以便发消息或管理该群时使用；按群名模糊搜索，只读分页返回匹配的群列表。"
],
"avoid_when": [
"发送、读取、成员、邀请链接或机器人命令已接受自然群名时直接使用对应 Shortcut，不要先手工搜索并抄 ID。"
],
"examples": [
"dws chat +chat-search --query \"项目冲刺\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_search",
"cobra-help:dws chat +chat-search",
"ShortcutRegistry:chat +chat-search"
]
},
"chat.shortcut_chat_invite_url": {
"agent_summary": "获取群邀请链接",
"use_when": [
"当你想拿到一条群邀请链接分享给别人加群时使用；--group 可传群 openConversationId 或群名，也可显式用 --chat-query 按群名唯一解析；多命中会安全停止。可用 --expires-seconds 设置有效期（0 表示永久）。"
],
"avoid_when": [
"用户要把邀请卡片直接发到另一个会话时使用 share-invite；不要先尝试 +chat-list 或不存在的搜索入口。"
],
"examples": [
"dws chat +chat-invite-url --chat-query \"项目群\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_invite_url",
"cobra-help:dws chat +chat-invite-url",
"ShortcutRegistry:chat +chat-invite-url"
]
},
"chat.shortcut_chat_dismiss": {
"agent_summary": "解散群聊（不可逆，需群主权限）",
"use_when": [
"当你要彻底解散一个群时使用；会实际销毁群聊，不可逆且需群主权限，仅需传群 openConversationId，操作前务必确认。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-dismiss --group <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_dismiss",
"cobra-help:dws chat +chat-dismiss",
"ShortcutRegistry:chat +chat-dismiss"
]
},
"chat.shortcut_chat_set_history": {
"agent_summary": "设置新成员入群可查看历史消息范围",
"use_when": [
"当你想控制新成员入群后能看到多少历史消息时使用；会实际修改群配置，需传群 openConversationId 和范围（FORBIDDEN 不可见 / RECENT_100 最近100条 / ALL 全部）。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-set-history --group <openConversationId> --option RECENT_100"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_set_history",
"cobra-help:dws chat +chat-set-history",
"ShortcutRegistry:chat +chat-set-history"
]
},
"chat.shortcut_chat_update_nick": {
"agent_summary": "设置当前用户在群内的群昵称",
"use_when": [
"当你想设置当前用户在某个群里显示的群昵称时使用；会实际更新本人在该群的昵称，需传群 openConversationId 和昵称。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-update-nick --group <openConversationId> --nick \"我的群昵称\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_update_nick",
"cobra-help:dws chat +chat-update-nick",
"ShortcutRegistry:chat +chat-update-nick"
]
},
"chat.shortcut_chat_update_alias": {
"agent_summary": "设置群备注（仅自己可见）",
"use_when": [
"当你想给某个群设置仅自己可见的备注名以便区分同名群时使用；会实际保存本人对该群的备注，需传群 openConversationId 和备注标题。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-update-alias --group <openConversationId> --alias-title \"项目A群\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_update_alias",
"cobra-help:dws chat +chat-update-alias",
"ShortcutRegistry:chat +chat-update-alias"
]
},
"chat.shortcut_chat_list_mine": {
"agent_summary": "拉取我创建/管理的群",
"use_when": [
"当你想查看自己作为群主或管理员在管理哪些群时使用；只读分页返回，可用 --role OWNER/ADMIN 按角色过滤。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-list-mine --role OWNER"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_list_mine",
"cobra-help:dws chat +chat-list-mine",
"ShortcutRegistry:chat +chat-list-mine"
]
},
"chat.shortcut_chat_list_all": {
"agent_summary": "分页拉取我加入的所有群列表",
"use_when": [
"当你想遍历当前用户加入的所有群做统计或批量操作时使用；只读分页返回全部已加入的群列表。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-list-all --limit 50"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_list_all",
"cobra-help:dws chat +chat-list-all",
"ShortcutRegistry:chat +chat-list-all"
]
},
"chat.shortcut_chat_list_join_requests": {
"agent_summary": "分页拉取入群验证记录",
"use_when": [
"当你作为群主/管理员想查看待处理的入群申请时使用；只读分页返回入群验证记录（含 recordId、申请人与邀请人 ID），供后续用 chat-audit-join 审批。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-list-join-requests --limit 30"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_list_join_requests",
"cobra-help:dws chat +chat-list-join-requests",
"ShortcutRegistry:chat +chat-list-join-requests"
]
},
"chat.shortcut_chat_bots": {
"agent_summary": "查看群内所有机器人",
"use_when": [
"当你想查看某个群里已添加了哪些机器人时使用；--group 可传群 openConversationId 或群名，也可显式用 --chat-query 按群名唯一解析；多命中会安全停止。只读返回机器人列表（含 openBotId，供后续移除）。"
],
"avoid_when": [
"用户要搜索当前账号可用或创建的机器人而非群内机器人时，使用 bot find/search；不要先走 chat group search + group bots 原子链。"
],
"examples": [
"dws chat +chat-bots --group \"项目群\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_bots",
"cobra-help:dws chat +chat-bots",
"ShortcutRegistry:chat +chat-bots"
]
},
"chat.shortcut_chat_set_admin": {
"agent_summary": "设置 / 取消群管理员",
"use_when": [
"当你想把某些成员设为或取消群管理员时使用；会实际变更成员角色，需传群 openConversationId 和成员 userId/openDingTalkId 列表，加 --off 取消管理员。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-set-admin --group <openConversationId> --users userId1,userId2"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_set_admin",
"cobra-help:dws chat +chat-set-admin",
"ShortcutRegistry:chat +chat-set-admin"
]
},
"chat.shortcut_chat_mute": {
"agent_summary": "全员禁言 / 取消全员禁言",
"use_when": [
"当你想对整个群开启或取消全员禁言时使用；会实际切换群的全员禁言状态，需传群 openConversationId，加 --off 取消禁言。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-mute --group <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_mute",
"cobra-help:dws chat +chat-mute",
"ShortcutRegistry:chat +chat-mute"
]
},
"chat.shortcut_chat_role_list": {
"agent_summary": "拉取会话的群身份列表",
"use_when": [
"当你想查看某群自定义的群身份（如'班长''值日'）都有哪些时使用；需传群 openConversationId，只读返回群身份列表及 openRoleId。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-role-list --group <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_role_list",
"cobra-help:dws chat +chat-role-list",
"ShortcutRegistry:chat +chat-role-list"
]
},
"chat.shortcut_chat_role_add": {
"agent_summary": "添加群身份",
"use_when": [
"当你想在群里新增一个自定义群身份/头衔时使用；会实际创建群身份，需传群 openConversationId 和身份名称。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-role-add --group <openConversationId> --name \"管理员\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_role_add",
"cobra-help:dws chat +chat-role-add",
"ShortcutRegistry:chat +chat-role-add"
]
},
"chat.shortcut_chat_role_update": {
"agent_summary": "更新群身份名称",
"use_when": [
"当你想重命名已有的群身份时使用；会实际更新身份名称，需传群 openConversationId、身份 openRoleId 和新名称。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-role-update --group <openConversationId> --role-id <openRoleId> --name \"新名称\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_role_update",
"cobra-help:dws chat +chat-role-update",
"ShortcutRegistry:chat +chat-role-update"
]
},
"chat.shortcut_chat_role_set_user": {
"agent_summary": "设置用户的群身份（覆盖该用户的全部群身份）",
"use_when": [
"当你想为某成员整体设定其在群内的身份时使用；会实际改写该用户的群身份集合（覆盖其原有全部身份），需传群、用户和 openRoleId 列表（传空则清除全部）。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-role-set-user --group <openConversationId> --user <userId> --role-ids roleId1,roleId2"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_role_set_user",
"cobra-help:dws chat +chat-role-set-user",
"ShortcutRegistry:chat +chat-role-set-user"
]
},
"chat.shortcut_chat_role_query_user": {
"agent_summary": "查询群成员的群身份",
"use_when": [
"当你想查看某个群成员当前拥有哪些群身份时使用；只读，需传群 openConversationId 和用户 userId 或 openDingTalkId。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +chat-role-query-user --group <openConversationId> --user <userId>"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_role_query_user",
"cobra-help:dws chat +chat-role-query-user",
"ShortcutRegistry:chat +chat-role-query-user"
]
},
"chat.shortcut_chat_create": {
"agent_summary": "按成员和可选群主全量预检后创建一个钉钉群聊",
"use_when": [
"当你要创建钉钉群聊时使用；成员可传稳定 ID 或 --member-query 姓名，群主默认当前用户，也可用 --owner-open-dingtalk-id 或 --owner-query 明确指定。所有自然身份会在唯一解析并去重后才执行一次创建，任一零命中或多命中都会整体停止。"
],
"avoid_when": [
"需要群 description、初始机器人、幂等查重或 Lark public/private 可见性时不要使用；这些语义当前没有可靠底层能力"
],
"examples": [
"dws chat +chat-create --name \"项目冲刺群\" --users <userId1>,<userId2>",
"dws chat +chat-create --name \"合作群\" --member-query \"张三,李四\" --type EXTERNAL"
],
"reviewed": true,
"review_reason": "Agent-authored from the executable all-or-nothing member/owner resolver, stable-ID de-duplication, explicit ownerOpenDingTalkId mapping, current-owner fallback, single-write boundary, dry-run parity, and deliberately unsupported description/initial-bot/visibility fields.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_create",
"cobra-help:dws chat +chat-create",
"ShortcutRegistry:chat +chat-create"
]
},
"chat.shortcut_chat_members_list": {
"agent_summary": "列出群成员并把用户与机器人分桶（支持群名语义解析）",
"use_when": [
"当你要完整查看一个群的参与者，并需要区分真人用户和机器人时使用；--group 可传群名或 openConversationId，也可用 --conversation-id 显式传稳定 ID、用 --chat-query 显式按群名解析。默认同时返回 users/bots 两个桶，也可用 --member-types 只取 user 或 bot；用户桶自动翻页并按稳定 ID 去重，结果用 buckets、complete、hasMore、nextCursor 和 failures 证明完整性；--page-limit 保证有界。机器人桶按下层全量列表投影。"
],
"avoid_when": [
"只需要按群名列出真人用户时可用较小入口 +group-members；不要把 complete=false 或 partial=true 的结果称为完整成员列表"
],
"examples": [
"dws chat +chat-members-list --group \"项目冲刺\"",
"dws chat +chat-members-list --conversation-id <openConversationId> --member-types user,bot"
],
"reviewed": true,
"review_reason": "Agent-authored from full user pagination, stable-ID de-duplication, separate all-bot projection, deterministic group resolution, typed bucket completeness, and partial failure facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_members_list",
"cobra-help:dws chat +chat-members-list",
"ShortcutRegistry:chat +chat-members-list"
]
},
"chat.shortcut_chat_messages": {
"agent_summary": "按会话 ID、群名或姓名读取消息，支持有界全量分页与原子 JSON 导出",
"use_when": [
"当你想快速看一个群聊或单聊里的消息（谁在什么时间说了什么），而不想拿到大段原始消息字段时使用；群聊的 --group 可传群名或 openConversationId，也可用 --chat-query 显式按群名解析、用 --conversation-id 显式传稳定 ID；单聊可传 --user、--open-dingtalk-id 或 --user-query，所有目标参数互斥且必须选一个。自然目标只在唯一解析后读取，多候选会返回结构化 candidates。省略 --time 时默认从当前时间向前读取最近消息；也可指定时间边界并用 --direction newer/older 控制方向。全量读取用 --page-all，并由 --page-limit/--max-results 保持有界；结果公开 complete、hasMore、nextPage、stopReason、截断和逐页失败，不能把部分结果称为完整。--output 把同一 ledger 原子写为工作目录内 JSON。默认只读；--download-resources 使用工作目录内安全路径、默认不覆盖和原子落盘。"
],
"avoid_when": [
"要跨多个会话按关键词、发送者或消息类型检索时使用 +search-msg；已有一批精确消息 ID 时使用 +messages-mget"
],
"examples": [
"dws chat +chat-messages --group <openConversationId> --direction older --page-all --page-limit 50",
"dws chat +chat-messages --open-dingtalk-id <openDingTalkId> --page-all --output ./exports/messages.json"
],
"reviewed": true,
"review_reason": "Agent-authored from stable-ID/natural-target routing, bounded all-page collection, message-ID de-duplication, fail-closed continuation, im.message-list.v1 completeness facts, atomic JSON export, and the optional safe resource workflow.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_messages",
"cobra-help:dws chat +chat-messages",
"ShortcutRegistry:chat +chat-messages"
]
},
"chat.shortcut_messages_reply": {
"agent_summary": "引用回复一条已有消息，并返回可继续查询或撤回的发送上下文",
"use_when": [
"当你要以当前用户身份对一条已有消息发送纯文本引用回复时使用；传会话和原消息 ID，CLI 会先读取原发送者，也可显式传 --ref-sender。成功结果在保留下层响应的同时增量返回 messageId（下层提供时）、conversationId、threadId（适用时）、deliveryStatus、idempotencyKey 和 referencedMessage 来源上下文。"
],
"avoid_when": [
"要在话题 Thread 内新增回复、用 bot 身份回复、发送富媒体或卡片时不要使用；当前入口只实现普通引用回复，不猜测不存在的 Thread writer"
],
"examples": [
"dws chat +messages-reply --conversation-id <openConversationId> --message-id <openMessageId> --text \"收到\" --idempotency-key <key>"
],
"reviewed": true,
"review_reason": "Agent-authored from the verified pre-write sender lookup, plain-text quote contract, dry-run no-write behavior, optional idempotency, additive continuation DTO, and explicit exclusion of unverified Thread writing.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_reply",
"cobra-help:dws chat +messages-reply",
"ShortcutRegistry:chat +messages-reply"
]
},
"chat.shortcut_messages_send": {
"agent_summary": "按身份和目标统一发送消息，Bot 多群返回逐目标 ledger",
"use_when": [
"当你需要文件、复杂 @、幂等，或选择 current-user、bot、webhook 身份发送消息时使用；current-user 可直接传稳定 ID，也可用 --user-query/--chat-query 在 CLI 内唯一解析自然目标，dry-run 与真实执行使用同一解析链。Bot 可用 --groups/--groups-file 向最多 100 个稳定群 ID 发送文本或 Markdown，去重后返回 im.batch-write.v1 逐目标 ledger；webhook 目标由 token 所在群决定。文件上传和已有 mediaId 图片仅 current-user 支持，bot/webhook 不支持富媒体。"
],
"avoid_when": [
"只需按姓名或群名发送简单文本时分别使用 +dm 或 +send-to-group；bot/webhook 不支持自然目标或富媒体，卡片使用 +messages-send-card，当前没有 thread writer"
],
"examples": [
"dws chat +messages-send --as user --chat-id <openConversationId> --markdown \"## 周报\" --idempotency-key <key>",
"dws chat +messages-send --as bot --robot-code <robotCode> --groups <openConversationId1>,<openConversationId2> --text \"请提交周报\""
],
"reviewed": true,
"review_reason": "Agent-authored from the typed identity/content matrix, structured user/chat resolution, native current-user file flow, bot multi-group safe file input and im.batch-write.v1 per-target ledger, and fail-closed rejection of unsupported bot/webhook natural targets or rich media.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_send",
"cobra-help:dws chat +messages-send",
"ShortcutRegistry:chat +messages-send"
]
},
"chat.shortcut_messages_send_by_webhook": {
"agent_summary": "兼容旧入口的自定义机器人 Webhook 群消息发送",
"use_when": [
"只有既有自动化明确依赖 +messages-send-by-webhook 兼容路径、暂时不能迁移统一身份入口时使用"
],
"avoid_when": [
"新的 Webhook 文本、Markdown 和 @发送使用 +messages-send --as webhook",
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +messages-send-by-webhook --token <token> --title \"告警\" --text \"CPU 超 90%\" --at-all"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_send_by_webhook",
"cobra-help:dws chat +messages-send-by-webhook",
"ShortcutRegistry:chat +messages-send-by-webhook"
]
},
"chat.shortcut_messages_send_card": {
"agent_summary": "创建流式卡片，可在同一次调用中写入内容并结束",
"use_when": [
"当你要发送一张流式文本卡片时使用；群 openConversationId、单聊 userId、单聊 openDingTalkId 严格三选一，分别使用 --group、--receiver、--receiver-open-dingtalk-id。--receiver 始终按 userId 通过通讯录关键词搜索做精确匹配，即使值以 D/d 开头也不会猜成 openDingTalkId；已有 openDingTalkId 时必须用显式参数直传。userId 包括在 --dry-run 时也会先解析。只传目标时创建卡片并返回 bizId，供后续 messages-update-card 流式更新；同时传 --content 时会自动串联创建和更新，默认以 flowStatus=3 完成。当前只支持 streaming text，不支持 Card JSON 组件或 action callback。"
],
"avoid_when": [
"已有 bizId、只需要追加或更新现有卡片内容时使用 +messages-update-card；需要 Card JSON 组件或 action callback 时停止，当前没有底层能力"
],
"examples": [
"dws chat +messages-send-card --group <openConversationId> --content \"任务已完成\"",
"dws chat +messages-send-card --receiver <userId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the verified create-only and create-then-update lifecycle, live-compatible contact search with exact userId matching, explicit userId/openDingTalkId routing, two-action dry-run, bizId extraction, and partial-failure reporting.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_send_card",
"cobra-help:dws chat +messages-send-card",
"ShortcutRegistry:chat +messages-send-card"
]
},
"chat.shortcut_messages_list_direct": {
"agent_summary": "拉取单聊会话消息",
"use_when": [
"当你想按时间拉取与某人单聊的历史消息时使用；只读，需传对方 userId 或 openDingTalkId 及起始时间，--forward 控制翻页方向。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +messages-list-direct --user <userId> --time \"2025-03-01 00:00:00\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_list_direct",
"cobra-help:dws chat +messages-list-direct",
"ShortcutRegistry:chat +messages-list-direct"
]
},
"chat.shortcut_messages_list_unread_conversations": {
"agent_summary": "获取有未读消息的会话列表",
"use_when": [
"当你想快速定位哪些会话还有未读消息时使用；只读返回有未读的会话列表，可用 --exclude-muted 排除已免打扰会话。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +messages-list-unread-conversations --count 20"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_list_unread_conversations",
"cobra-help:dws chat +messages-list-unread-conversations",
"ShortcutRegistry:chat +messages-list-unread-conversations"
]
},
"chat.shortcut_messages_mget": {
"agent_summary": "根据消息 ID 批量查询消息（最多 50 条）",
"use_when": [
"当你已有一批消息 openMsgId、需要批量取回完整详情、reaction 和可执行资源引用时使用；一次最多 50 条。--download-resources 可把所有可识别 mediaId/fileId 安全下载到工作目录内，并逐资源返回成功/失败 ledger；本地下载路径受限于工作目录、默认不覆盖同名文件，按既有安全下载约定无需交互确认。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +messages-mget --msg-ids msgId1,msgId2"
],
"reviewed": true,
"review_reason": "Reviewed against the built-in Shortcut, executable Cobra flags, safe relative-path download contract, and per-resource failure ledger; this selection update advertises the new optional resource workflow without changing its runtime safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_mget",
"cobra-help:dws chat +messages-mget",
"ShortcutRegistry:chat +messages-mget"
]
},
"chat.shortcut_messages_query_send_status": {
"agent_summary": "查询消息发送状态",
"use_when": [
"当你发消息后拿到 openTaskId、想确认这条消息是否发送成功时使用；只读返回发送状态，需传 --open-task-id。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +messages-query-send-status --open-task-id <openTaskId>"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_query_send_status",
"cobra-help:dws chat +messages-query-send-status",
"ShortcutRegistry:chat +messages-query-send-status"
]
},
"chat.shortcut_messages_read_status": {
"agent_summary": "查询消息的已读/未读状态",
"use_when": [
"当你想知道自己发出的某条消息有哪些人已读/未读时使用；只读，需传会话 openConversationId 和该消息 openMessageId，可指定目标成员列表。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +messages-read-status --conversation-id <openConversationId> --message-id <openMessageId>"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_read_status",
"cobra-help:dws chat +messages-read-status",
"ShortcutRegistry:chat +messages-read-status"
]
},
"chat.shortcut_messages_update_card": {
"agent_summary": "流式更新卡片内容（最后一次 --flow-status 应为 3）",
"use_when": [
"当你要向已发送的流式文本卡片持续追加/更新内容时使用；会实际更新卡片，需传 send-card 返回的 bizId、新内容及 flowStatus 1-5（最后一次应为 3 表示完成）。当前不支持 Card JSON 组件或 action callback。"
],
"avoid_when": [
"需要 Card JSON 组件、action callback 或范围外 flowStatus 时不要使用；当前没有等价底层能力"
],
"examples": [
"dws chat +messages-update-card --biz-id <bizId> --content \"内容\" --flow-status 3"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_update_card",
"cobra-help:dws chat +messages-update-card",
"ShortcutRegistry:chat +messages-update-card"
]
},
"chat.shortcut_messages_list_pin": {
"agent_summary": "拉取会话中钉住的消息列表",
"use_when": [
"当你想查看某会话里当前钉住的消息有哪些时使用；只读分页返回，需传会话 openConversationId。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +messages-list-pin --open-conversation-id <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_list_pin",
"cobra-help:dws chat +messages-list-pin",
"ShortcutRegistry:chat +messages-list-pin"
]
},
"chat.shortcut_at_me": {
"agent_summary": "查最近 @我 的消息（自动算时间窗，投影发送人/时间/内容/会话）",
"use_when": [
"当你想快速看回最近谁在群里或单聊里 @了你、但不想手动把起止时间换算成毫秒、也不想记 list-mentions 的一堆参数时使用；内部按本地时区算出「最近 N 天」（默认 7 天，可用 --days 调整回溯天数）的时间窗，搜索这段时间内 @我 的消息，再在本地把每条消息投影成发送人、时间、内容、所在会话四个关键字段。默认只读且不会发送、撤回或标记任何消息；--download-resources 使用工作目录内安全路径、默认不覆盖和原子落盘，按既有安全下载约定无需交互确认。"
],
"avoid_when": [
"按发送者、关键词或消息类型搜索时使用 +search-msg；不要拉取全部消息后本地猜测 @。"
],
"examples": [
"dws chat +at-me",
"dws chat +at-me --chat-query \"项目群\" --days 30"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_at_me",
"cobra-help:dws chat +at-me",
"ShortcutRegistry:chat +at-me"
]
},
"chat.shortcut_broadcast": {
"agent_summary": "按姓名逐一给多个人群发同一条单聊消息（自动解析 userId、逐个发送）",
"use_when": [
"当你想把同一条通知一次性单聊发给多位同事、但只知道他们的姓名不想逐个查 userId 时使用；内部把姓名列表逐个解析成唯一用户后，用 openDingTalkId 对每个人单独发一条单聊消息，并汇总成功/失败人数。某个姓名匹配不到人或匹配到多人时，会跳过该人并在结尾报出，不影响其他人收到消息。会真实发出多条消息。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +broadcast --to \"张三,李四,王五\" --text \"今晚 8 点上线，请留意\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_broadcast",
"cobra-help:dws chat +broadcast",
"ShortcutRegistry:chat +broadcast"
]
},
"chat.shortcut_dm": {
"agent_summary": "按姓名直接给某人发单聊消息（自动解析唯一 openDingTalkId）",
"use_when": [
"当你只知道对方姓名、想直接发一条单聊消息而不想先查 userId 时使用；内部先按姓名搜通讯录解析出唯一用户，并用其 openDingTalkId 发送，姓名匹配到多人时会列出候选让你区分。会真实发出消息。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +dm --to 张三 --text \"周报发我一下\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_dm",
"cobra-help:dws chat +dm",
"ShortcutRegistry:chat +dm"
]
},
"chat.shortcut_group_members": {
"agent_summary": "按群名唯一解析后全量列出用户成员并公开分页完整性",
"use_when": [
"当你只知道群的名字、想看看这个群里有哪些成员，而不想先手动查群 ID 时使用；内部先按群名搜索群聊解析出唯一 openConversationId，再拉取该群的成员列表。群名匹配到多个群时会列出候选让你区分、绝不自行假定。用户成员会自动翻页、稳定 ID 去重，并公开 complete/hasMore/nextCursor；--page-limit 保证有界。只读，不改动任何数据。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +group-members --group 项目冲刺"
],
"reviewed": true,
"review_reason": "Agent-authored from full paginated member collection, stable-ID de-duplication, explicit page-limit continuation and fail-closed group-name resolution.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_group_members",
"cobra-help:dws chat +group-members",
"ShortcutRegistry:chat +group-members"
]
},
"chat.shortcut_my_groups": {
"agent_summary": "列出我加入的群，可按类型过滤并投影关键字段",
"use_when": [
"当你想快速看一眼自己都加入了哪些群、以及每个群的会话ID、名称、群主和人数，而不想翻分页或盯着原始返回时使用；内部分页拉取你加入的群列表，把每个群防御式地投影成 会话id / 名称 / 群主 / 人数 / 类型 等关键字段，输出成干净的结果。可选 --type 在本地按群类型过滤（底层接口本身不带类型参数，故为客户端过滤）。这是只读操作，不会改动任何群或成员关系。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +my-groups",
"dws chat +my-groups --type group"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_my_groups",
"cobra-help:dws chat +my-groups",
"ShortcutRegistry:chat +my-groups"
]
},
"chat.shortcut_search_msg": {
"agent_summary": "按 ID、群名、姓名和内容等条件跨会话搜索消息，可全量翻页并批量富化",
"use_when": [
"当你要按关键词、发送者、@对象、会话、消息类型或机器人来源组合搜索 IM 消息时使用；会话可传稳定 ID 或 --chat-query，发送者可传稳定 ID 或 --sender-query，多个自然目标会先做全量解析，任一零命中/多命中都会在搜索前返回结构化失败。默认查询近 7 天，也可指定精确起止时间。--page-all 会连续拉取游标页，默认再按消息 ID 分批富化详情；任何续页或富化失败都会保留已取得结果并返回逐项失败 ledger，绝不把截断结果标成完整。--download-resources 使用安全本地路径、默认不覆盖和原子落盘。"
],
"avoid_when": [
"只想读取一个已知会话的连续历史时使用 +chat-messages；已有精确消息 ID 时使用 +messages-mget"
],
"examples": [
"dws chat +search-msg --query \"周报\" --senders <openDingTalkId> --days 3 --page-all",
"dws chat +search-msg --group <openConversationId> --message-type file --download-resources --output-dir ./downloads"
],
"reviewed": true,
"review_reason": "Agent-authored from the verified all-or-nothing natural group/sender resolution, stable-ID filter mapping, cursor pagination, batched mget enrichment, completeness ledger, and shared safe resource workflow.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_search_msg",
"cobra-help:dws chat +search-msg",
"ShortcutRegistry:chat +search-msg"
]
},
"chat.shortcut_send_to_group": {
"agent_summary": "按群名或 openConversationId 直接给群发消息",
"use_when": [
"当你有群名或 openConversationId、想直接往该群发送简单文本或 Markdown 时使用；稳定 ID 不进入搜索，群名则必须唯一解析，零命中或多候选都会在发送前停止。会真实发出群消息。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +send-to-group --group 项目冲刺 --text \"今天 5 点前提交进度\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_send_to_group",
"cobra-help:dws chat +send-to-group",
"ShortcutRegistry:chat +send-to-group"
]
},
"chat.shortcut_thread_replies": {
"agent_summary": "拉取某条话题消息的全部回复并投影出发言人/文本/时间",
"use_when": [
"当你已经拿到某个群里一条「话题消息」的 threadId/topicId、想快速看这条话题下的全部回复（谁在什么时间回复了什么），而不想拿到一大坨原始消息字段时使用；内部按 --group（群会话 ID）和 --thread-id（兼容 --topic-id）拉取该话题的回复列表，可选 --time 指定起始时间、--limit 指定每页条数，再在本地投影出每条回复的发言人、文本和回复时间。默认只读且不会发送或修改任何消息；--download-resources 使用工作目录内安全路径、默认不覆盖和原子落盘，按既有安全下载约定无需交互确认。"
],
"avoid_when": [
"要回复 Thread 或发送新回复时不要使用此读取入口；当前没有经过验证的 thread writer Shortcut"
],
"examples": [
"dws chat +thread-replies --group <openConversationId> --thread-id <threadId>",
"dws chat +thread-replies --group <openConversationId> --topic-id <topicId> --download-resources --output-dir ./downloads"
],
"reviewed": true,
"review_reason": "Agent-authored from the verified thread/topic alias, lower list_topic_replies mapping, stable projection, group-context fallback, and optional safe resource workflow.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_thread_replies",
"cobra-help:dws chat +thread-replies",
"ShortcutRegistry:chat +thread-replies"
]
},
"chat.shortcut_unread_chats": {
"agent_summary": "列出我有未读消息的会话（投影会话名/未读数/会话ID）",
"use_when": [
"当你想快速看清自己当前有哪些会话还有未读消息、方便逐个处理时使用；内部调用未读会话列表接口，可用 --count 控制返回的会话条数（不传则用服务端默认值），用 --exclude-muted 排除你已设置免打扰的会话；再在本地把每个会话投影成会话名、未读数和会话 ID 三个关键字段。这是纯只读操作，只做列表与本地投影，不会把任何会话标记为已读或未读；若没有未读会话则返回空列表。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws chat +unread-chats",
"dws chat +unread-chats --count 20"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_unread_chats",
"cobra-help:dws chat +unread-chats",
"ShortcutRegistry:chat +unread-chats"
]
},
"chat.update_text_emotion": {
"agent_summary": "把消息上已有的文字表情原地替换为新的文字表情",
"use_when": [
"需要更新消息的状态文字或表情，并避免先移除再添加造成闪烁和两次网络调用时"
],
"avoid_when": [
"消息上还没有文字表情时使用 chat message add-text-emotion",
"只需清除文字表情时使用 chat message remove-text-emotion"
],
"examples": [
"dws chat message update-text-emotion --conversation-id <openConversationId> --msg-id <openMessageId> --old-emotion-id <oldEmotionId> --emotion-id <emotionId> --emotion-name \"处理中\" --text \"处理中 2 分钟\" --background-id im_bg_5"
],
"reviewed": true,
"review_reason": "依据 issue #85 的原地状态更新场景、Wukong 30f13f02 的真实 Cobra/MCP 映射和开源实现复核；选择语义不改变执行、安全或参数事实。",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.update_text_emotion",
"cobra-help:dws chat message update-text-emotion",
"dws-wukong:d6831318",
"dws-wukong:bcf56ccf",
"dws-wukong:30f13f02",
"github:hugozhu/dingtalk-opencode-tag#85",
"live-dws-schema:im.update_text_emotion#FAILED_NOT_AUTHENTICATED"
]
},
"chat.get_group_mute_config": {
"agent_summary": "查询群用户禁言配置（禁言黑名单/全员禁言白名单）",
"use_when": [
"用户说 看下群里谁被禁言/禁言配置"
],
"avoid_when": [
"设置全员禁言用 chat group-mute；禁言个人用 chat group-mute-member"
],
"examples": [
"dws chat group get-mute-config --group <openConversationId> --format json"
],
"reviewed": true,
"review_reason": "人工审阅：对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植；不改变命令身份、参数契约或接口绑定。",
"source_refs": [
"CommandRegistry:canonical_path=chat.get_group_mute_config",
"cobra-help:dws chat group get-mute-config",
"wukong-develop:wukong/products"
]
},
"chat.batch_query_group_chat_settings": {
"agent_summary": "批量查询当前用户自己的群会话设置（置顶/免打扰/群昵称/群备注）",
"use_when": [
"用户说 看下这些群我的置顶和免打扰设置"
],
"avoid_when": [
"管理员级群功能开关用 chat group update-settings"
],
"examples": [
"dws chat group user-settings query --groups cid1,cid2 --format json"
],
"reviewed": true,
"review_reason": "人工审阅：对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植；不改变命令身份、参数契约或接口绑定。",
"source_refs": [
"CommandRegistry:canonical_path=chat.batch_query_group_chat_settings",
"cobra-help:dws chat group user-settings query",
"wukong-develop:wukong/products"
]
},
"chat.batch_update_group_chat_settings": {
"agent_summary": "批量更新当前用户自己的群会话设置（置顶/免打扰/群昵称/群备注）",
"use_when": [
"用户说 把这些群都设为免打扰/置顶"
],
"avoid_when": [
"单个群昵称优先 chat group update-nick"
],
"examples": [
"dws chat group user-settings set --items '[{\"openConversationId\":\"cid1\",\"top\":true,\"mute\":false}]' --format json"
],
"reviewed": true,
"review_reason": "人工审阅：对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植；不改变命令身份、参数契约或接口绑定。",
"source_refs": [
"CommandRegistry:canonical_path=chat.batch_update_group_chat_settings",
"cobra-help:dws chat group user-settings set",
"wukong-develop:wukong/products"
]
},
"chat.shortcut_category_add_conversation": {
"agent_summary": "将会话移动到指定的自定义分组中",
"use_when": [
"当你想把某个会话归入一个或多个自定义分组时使用；会实际把会话加入指定分组，需传会话 openConversationId 和目标分组 ID 列表。"
],
"avoid_when": [
"要新建、改名或删除分组时分别使用 +category-create、+category-rename、+category-delete；要移出分组使用 +category-remove-conversation"
],
"examples": [
"dws chat +category-add-conversation --group <openConversationId> --category-ids 123,456"
],
"reviewed": true,
"review_reason": "Agent-authored from the executable category membership write, stable conversation/category identifiers, sibling category routes, and confirmed Runtime boundary.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_category_add_conversation",
"cobra-help:dws chat +category-add-conversation",
"ShortcutRegistry:chat +category-add-conversation"
]
},
"chat.shortcut_category_list_conversations": {
"agent_summary": "拉取指定自定义会话分组下的会话",
"use_when": [
"当你想查看某个自定义会话分组里都归入了哪些会话时使用；只读，需传 categoryId，可用 --exclude-muted 排除已免打扰会话。"
],
"avoid_when": [
"只想列出分组本身使用 +category-list；要按多个会话 ID 精确检查分组项使用 +feed-group-query-item"
],
"examples": [
"dws chat +category-list-conversations --category-id <categoryId>",
"dws chat +category-list-conversations --category-id <categoryId> --exclude-muted"
],
"reviewed": true,
"review_reason": "Agent-authored from the read-only category contents projection and reviewed sibling routing for category list versus exact item lookup.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_category_list_conversations",
"cobra-help:dws chat +category-list-conversations",
"ShortcutRegistry:chat +category-list-conversations"
]
},
"chat.shortcut_category_remove_conversation": {
"agent_summary": "将会话从指定的自定义分组中移出",
"use_when": [
"当你想把某个会话从指定自定义分组中移出时使用；会实际从分组移除该会话（不删除会话本身），需传会话 openConversationId 和分组 ID 列表。"
],
"avoid_when": [
"要把会话加入分组使用 +category-add-conversation；要删除整个分组使用 +category-delete；本命令不会删除或隐藏会话"
],
"examples": [
"dws chat +category-remove-conversation --group <openConversationId> --category-ids 123,456"
],
"reviewed": true,
"review_reason": "Agent-authored from the executable category membership removal, non-deletion boundary, sibling category routes, and confirmed Runtime gate.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_category_remove_conversation",
"cobra-help:dws chat +category-remove-conversation",
"ShortcutRegistry:chat +category-remove-conversation"
]
},
"chat.shortcut_chat_add_bot": {
"agent_summary": "将机器人添加到群中",
"use_when": [
"当你想把某个机器人添加进群（比如让日报机器人进群播报）时使用；会实际把机器人加入群聊，需传机器人 robotCode 和群 openConversationId。"
],
"avoid_when": [
"只是发送机器人消息使用 +messages-send-by-bot；查看群机器人使用 +chat-bots；移除机器人使用 +chat-remove-bot"
],
"examples": [
"dws chat +chat-add-bot --robot-code <robotCode> --id <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the confirmed bot-membership write and explicit routing among bot discovery, send, add and remove operations.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_add_bot",
"cobra-help:dws chat +chat-add-bot",
"ShortcutRegistry:chat +chat-add-bot"
]
},
"chat.shortcut_chat_audit_join": {
"agent_summary": "审批入群验证（通过/拒绝/删除/忽略/拉黑）",
"use_when": [
"当你要处理某条入群申请时使用；会实际执行通过/拒绝/删除/忽略/拉黑动作，需传群 openConversationId、recordId、申请人与邀请人 userId 及 status。"
],
"avoid_when": [
"先查看申请使用 +chat-list-join-requests；普通添加成员或群权限调整不要使用入群审批命令"
],
"examples": [
"dws chat +chat-audit-join --group <openConversationId> --record-id 123 --applicant <userId> --inviter <userId> --status AuditApprove"
],
"reviewed": true,
"review_reason": "Agent-authored from the reviewed audit disposition enum, request actor tuple, confirmed moderation boundary, and list-before-act route.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_audit_join",
"cobra-help:dws chat +chat-audit-join",
"ShortcutRegistry:chat +chat-audit-join"
]
},
"chat.shortcut_chat_get_by_id": {
"agent_summary": "根据群号获取群聊信息",
"use_when": [
"当你只知道群号（数字）、需要换取群 openConversationId 及群信息时使用；只读，需传 --group-id。"
],
"avoid_when": [
"只有群名时使用 +chat-search 或支持自然群名解析的 Golden Route；已经有 openConversationId 时无需再次按群号查询"
],
"examples": [
"dws chat +chat-get-by-id --group-id 12345678"
],
"reviewed": true,
"review_reason": "Agent-authored from the numeric group-number lookup, stable identity outcome, and routing distinction from name search and direct openConversationId use.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_get_by_id",
"cobra-help:dws chat +chat-get-by-id",
"ShortcutRegistry:chat +chat-get-by-id"
]
},
"chat.shortcut_chat_members_get": {
"agent_summary": "根据成员 openDingTalkId 批量查询群成员详情",
"use_when": [
"当你已有若干成员的 openDingTalkId、需要批量获取他们在该群内的详情（群昵称、角色等）时使用；只读，需传群 openConversationId 和成员 openDingTalkId 列表。"
],
"avoid_when": [
"要完整遍历群成员并区分用户和机器人使用 +chat-members-list；只有姓名或 userId 时先走对应解析链"
],
"examples": [
"dws chat +chat-members-get --id <openConversationId> --users <openDingTalkId1>,<openDingTalkId2>"
],
"reviewed": true,
"review_reason": "Agent-authored from the stable-ID batch member lookup and explicit routing against complete paginated member listing.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_members_get",
"cobra-help:dws chat +chat-members-get",
"ShortcutRegistry:chat +chat-members-get"
]
},
"chat.shortcut_chat_mute_member": {
"agent_summary": "指定群成员禁言 / 取消禁言",
"use_when": [
"当你想只禁言或解禁群里的指定成员时使用；会实际把成员加入或移出禁言名单，需传群 openConversationId 和成员列表，禁言时还需 --mute-time（毫秒）。"
],
"avoid_when": [
"要开启全员禁言使用群级 mute 命令；只调整当前用户的会话免打扰使用 +conversation-mute"
],
"examples": [
"dws chat +chat-mute-member --group <openConversationId> --users <userId> --mute-time 3600000",
"dws chat +chat-mute-member --group <openConversationId> --users <userId> --off"
],
"reviewed": true,
"review_reason": "Agent-authored from member identity resolution, mute duration/off modes, confirmed moderation boundary, and distinction from group mute and notification mute.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_mute_member",
"cobra-help:dws chat +chat-mute-member",
"ShortcutRegistry:chat +chat-mute-member"
]
},
"chat.shortcut_chat_quit": {
"agent_summary": "退出群聊",
"use_when": [
"当你想让当前用户主动退出某个群时使用；会实际退群，需传群 openConversationId。"
],
"avoid_when": [
"要解散整个群使用 +chat-dismiss；要移除其他成员使用成员管理命令；退出前需要处理群主转让时先使用 +chat-transfer-owner"
],
"examples": [
"dws chat +chat-quit --group <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the current-user leave boundary, ownership prerequisite risk, and routing distinction from group dismissal or member removal.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_quit",
"cobra-help:dws chat +chat-quit",
"ShortcutRegistry:chat +chat-quit"
]
},
"chat.shortcut_chat_remove_bot": {
"agent_summary": "从群内移除机器人",
"use_when": [
"当你想把某个机器人从群里移除时使用；会实际移除机器人，不可逆，需传群 openConversationId 和机器人 openBotId。"
],
"avoid_when": [
"只是暂停机器人发送或查看机器人列表不要移除；添加机器人使用 +chat-add-bot"
],
"examples": [
"dws chat +chat-remove-bot --id <openConversationId> --bot-id <openBotId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the high-risk bot removal, stable bot/group identities, irreversible membership outcome, and add/list sibling routes.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_remove_bot",
"cobra-help:dws chat +chat-remove-bot",
"ShortcutRegistry:chat +chat-remove-bot"
]
},
"chat.shortcut_chat_role_remove": {
"agent_summary": "删除群身份",
"use_when": [
"当你想删除某个自定义群身份时使用；会实际删除群身份，不可逆，需传群 openConversationId 和身份 openRoleId。"
],
"avoid_when": [
"只从某个成员移除身份使用 +chat-role-remove-user；修改身份使用 +chat-role-update；先查看身份使用 +chat-role-list"
],
"examples": [
"dws chat +chat-role-remove --group <openConversationId> --role-id <openRoleId>"
],
"reviewed": true,
"review_reason": "Agent-authored from permanent role deletion, high-risk confirmation, and explicit routing against member assignment removal and role update.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_role_remove",
"cobra-help:dws chat +chat-role-remove",
"ShortcutRegistry:chat +chat-role-remove"
]
},
"chat.shortcut_chat_role_remove_user": {
"agent_summary": "移除用户的指定群身份",
"use_when": [
"当你只想撤销某成员的部分群身份、保留其余时使用；会实际移除指定的群身份，需传群、用户和要移除的 openRoleId 列表。"
],
"avoid_when": [
"要删除身份定义使用 +chat-role-remove；完全重设成员身份可评估 +chat-role-set-user；新增身份使用 +chat-role-add"
],
"examples": [
"dws chat +chat-role-remove-user --group <openConversationId> --user <userId> --role-ids <openRoleId>"
],
"reviewed": true,
"review_reason": "Agent-authored from partial role-assignment removal and its distinction from deleting the role definition or replacing a member's role set.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_role_remove_user",
"cobra-help:dws chat +chat-role-remove-user",
"ShortcutRegistry:chat +chat-role-remove-user"
]
},
"chat.shortcut_chat_transfer_owner": {
"agent_summary": "转让群主",
"use_when": [
"当你要把群主身份转让给他人时使用；会实际变更群主（自己不再是群主），需传群 openConversationId 和新群主的 userId 或 openDingTalkId。"
],
"avoid_when": [
"只需要设置管理员使用 +chat-set-admin；当前用户要退群但仍是群主时先转让再使用 +chat-quit"
],
"examples": [
"dws chat +chat-transfer-owner --group <openConversationId> --new-owner <openDingTalkId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the ownership handoff impact, explicit new-owner identity, confirmation boundary, and administrator/quit sibling routes.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_transfer_owner",
"cobra-help:dws chat +chat-transfer-owner",
"ShortcutRegistry:chat +chat-transfer-owner"
]
},
"chat.shortcut_chat_update": {
"agent_summary": "更新群名称（仅名称，不支持 description）",
"use_when": [
"当你只需要修改群名称时使用；--group 可传群名或 openConversationId，群名必须唯一解析后才会写入。修改群 description、个人备注、群昵称或其他群设置时不要使用。"
],
"avoid_when": [
"修改群头像使用 +chat-update-icon，群设置使用 +chat-update-settings，个人群备注或群昵称使用 +chat-update-alias/+chat-update-nick"
],
"examples": [
"dws chat +chat-update --group <openConversationId> --name \"新群名\"",
"dws chat +chat-update --group \"唯一群名\" --name \"新群名\""
],
"reviewed": true,
"review_reason": "Agent-authored from the name-only update, deterministic natural target resolution, confirmation boundary, and explicit routing to icon/settings/personal-name siblings.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_update",
"cobra-help:dws chat +chat-update",
"ShortcutRegistry:chat +chat-update"
]
},
"chat.shortcut_chat_update_icon": {
"agent_summary": "更新群头像",
"use_when": [
"当你想更换群头像时使用；会实际更新群头像，需传群 openConversationId 和已上传头像的 mediaId（以 @ 开头）。"
],
"avoid_when": [
"本地图片尚未上传时先走支持的上传流程；修改群名称或开关分别使用 +chat-update、+chat-update-settings"
],
"examples": [
"dws chat +chat-update-icon --group <openConversationId> --icon-media-id <mediaId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the uploaded-media boundary, confirmed icon update, and distinction from name/settings changes.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_update_icon",
"cobra-help:dws chat +chat-update-icon",
"ShortcutRegistry:chat +chat-update-icon"
]
},
"chat.shortcut_chat_update_settings": {
"agent_summary": "更新群设置（settingKey + status）",
"use_when": [
"当你想调整群的某项开关设置（如是否可被搜索 searchable、是否仅管理员可@所有人 onlyAdminCanAtAll）时使用；会实际修改群设置，需传 settingKey 和 status（0关/1开）。"
],
"avoid_when": [
"当前用户自己的置顶、免打扰、群昵称或备注使用会话用户设置；群名称、头像分别使用 +chat-update、+chat-update-icon"
],
"examples": [
"dws chat +chat-update-settings --group <openConversationId> --setting-key searchable --status 1"
],
"reviewed": true,
"review_reason": "Agent-authored from the reviewed setting enum/status contract, group-level scope, confirmation gate, and distinction from personal conversation settings.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_chat_update_settings",
"cobra-help:dws chat +chat-update-settings",
"ShortcutRegistry:chat +chat-update-settings"
]
},
"chat.shortcut_conversation_clear_messages": {
"agent_summary": "清空当前用户指定会话的聊天记录（仅本人视角，不可逆）",
"use_when": [
"当你要清空自己在某个会话里的聊天记录时使用；仅影响本人视角，但会实际删除且不可逆，需传 openConversationId，务必谨慎操作。"
],
"avoid_when": [
"只是隐藏会话使用 +conversation-hide；清除未读红点使用 +conversation-clear-red-point；撤回单条自己发送的消息使用 +messages-recall"
],
"examples": [
"dws chat +conversation-clear-messages --conversation-id <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the high-risk irreversible current-user history deletion and two-stage confirmation rule; the example intentionally omits --yes.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_conversation_clear_messages",
"cobra-help:dws chat +conversation-clear-messages",
"ShortcutRegistry:chat +conversation-clear-messages"
]
},
"chat.shortcut_conversation_clear_red_point": {
"agent_summary": "清除会话红点",
"use_when": [
"当你想消除某个会话上的未读红点（小圆点）时使用；会实际清除该会话红点，需传 openConversationId。"
],
"avoid_when": [
"需要精确推进消息已读位置使用 +conversation-mark-read；要保留提醒使用 +conversation-mark-unread；清空记录不要使用本命令"
],
"examples": [
"dws chat +conversation-clear-red-point --conversation-id <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the red-point-only state change, confirmed Runtime boundary, and distinction from read-position and destructive history operations.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_conversation_clear_red_point",
"cobra-help:dws chat +conversation-clear-red-point",
"ShortcutRegistry:chat +conversation-clear-red-point"
]
},
"chat.shortcut_conversation_hide": {
"agent_summary": "会话列表中隐藏会话（收到新消息会重新出现）",
"use_when": [
"当你想把某个会话从会话列表中暂时隐藏、让列表更清爽时使用；会实际隐藏该会话（收到新消息会自动重新出现），需传 openConversationId。"
],
"avoid_when": [
"不想接收提醒使用 +conversation-mute；只清除红点使用 +conversation-clear-red-point；永久清空本人记录使用 +conversation-clear-messages"
],
"examples": [
"dws chat +conversation-hide --conversation-id <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored from temporary list hiding semantics and routing against mute, red-point clearing, and irreversible history deletion.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_conversation_hide",
"cobra-help:dws chat +conversation-hide",
"ShortcutRegistry:chat +conversation-hide"
]
},
"chat.shortcut_conversation_mark_read": {
"agent_summary": "标记消息已读（该消息及之前的消息都标记为已读）",
"use_when": [
"当你想把某会话中某条消息及其之前的所有消息都标记为已读时使用；会实际更新已读位置，需传 openConversationId 和该消息 openMessageId。"
],
"avoid_when": [
"只想清除红点使用 +conversation-clear-red-point；要提醒自己稍后处理使用 +conversation-mark-unread"
],
"examples": [
"dws chat +conversation-mark-read --conversation-id <openConversationId> --message-id <openMessageId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the exact read-position update and sibling routing for red-point clearing and mark-unread.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_conversation_mark_read",
"cobra-help:dws chat +conversation-mark-read",
"ShortcutRegistry:chat +conversation-mark-read"
]
},
"chat.shortcut_conversation_mark_unread": {
"agent_summary": "标记会话为未读",
"use_when": [
"当你想把某个已读会话重新标记为未读（提醒自己稍后再处理）时使用；会实际改变该会话的未读状态，需传 openConversationId。"
],
"avoid_when": [
"要推进到精确消息的已读位置使用 +conversation-mark-read；只清除红点使用 +conversation-clear-red-point"
],
"examples": [
"dws chat +conversation-mark-unread --conversation-id <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the reminder-oriented unread state change and explicit distinction from mark-read and red-point clearing.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_conversation_mark_unread",
"cobra-help:dws chat +conversation-mark-unread",
"ShortcutRegistry:chat +conversation-mark-unread"
]
},
"chat.shortcut_conversation_mute": {
"agent_summary": "会话消息免打扰（支持单聊/群聊）",
"use_when": [
"当你想对某个会话开启或关闭消息免打扰时使用；会实际更改该会话的免打扰设置，需传 openConversationId，加 --off 表示关闭免打扰。"
],
"avoid_when": [
"要禁言群成员使用 +chat-mute-member；要调整群级全员禁言使用群管理命令；置顶状态使用 +conversation-set-top"
],
"examples": [
"dws chat +conversation-mute --conversation-id <openConversationId>",
"dws chat +conversation-mute --conversation-id <openConversationId> --off"
],
"reviewed": true,
"review_reason": "Agent-authored from current-user notification scope, on/off semantics, and routing distinction from member moderation and conversation top state.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_conversation_mute",
"cobra-help:dws chat +conversation-mute",
"ShortcutRegistry:chat +conversation-mute"
]
},
"chat.shortcut_conversation_set_top": {
"agent_summary": "批量会话置顶 / 取消置顶（最多 10 个）",
"use_when": [
"当你想把一个或多个单聊/群聊置顶到会话列表顶部、或取消置顶时使用；支持 1-10 个 openConversationId，逐项执行并返回成功/失败 ledger，某一项失败不阻断其余项。"
],
"avoid_when": [
"要置顶会话里的某条消息使用 +messages-set-top；Pin 消息使用 +messages-set-pin；Favorite 消息使用 +flag-create"
],
"examples": [
"dws chat +conversation-set-top --conversation-id <openConversationId>",
"dws chat +conversation-set-top --conversation-ids <cid1>,<cid2> --off"
],
"reviewed": true,
"review_reason": "Agent-authored from the bounded conversation batch ledger and explicit separation among conversation top, message top, message Pin and Favorite.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_conversation_set_top",
"cobra-help:dws chat +conversation-set-top",
"ShortcutRegistry:chat +conversation-set-top"
]
},
"chat.shortcut_feed_group_query_item": {
"agent_summary": "在会话分组结果中按会话 ID 精确查询多项",
"use_when": [
"当你已知一个钉钉会话分组 ID 和若干 openConversationId、想精确取回这些分组项时使用；先读取该分组，再按 ID 本地过滤并返回未找到清单。若下层表明结果仍有后续页但未提供可执行游标，本命令会把缺失项标为 unresolved 并返回失败 ledger，不会误报 notFound。它不提供 Lark deleted_items 或服务端多 ID 查询语义。"
],
"avoid_when": [
"要浏览分组全部会话使用 +category-list-conversations；要查询 Lark feed-layer deleted_items 或服务端多 ID 语义不要使用"
],
"examples": [
"dws chat +feed-group-query-item --category-id <categoryId> --conversation-ids <openConversationId1>,<openConversationId2>"
],
"reviewed": true,
"review_reason": "Agent-authored from exact local filtering, fail-closed pagination ledger, and explicit DingTalk category boundary rather than Lark feed semantics.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_feed_group_query_item",
"cobra-help:dws chat +feed-group-query-item",
"ShortcutRegistry:chat +feed-group-query-item"
]
},
"chat.shortcut_flag_cancel": {
"agent_summary": "取消收藏一条或多条消息（最多 10 条）",
"use_when": [
"当你要移除当前用户对同一会话中一条或多条消息的个人收藏标记时使用；逐项返回成功/失败 ledger，只影响 message favorite，不删除原消息，也不会修改 Pin 或会话置顶。"
],
"avoid_when": [
"取消消息 Pin 使用 +messages-unset-pin；取消消息置顶使用 +messages-unset-top；本命令不会删除或撤回消息"
],
"examples": [
"dws chat +flag-cancel --message-id <openMessageId> --conversation-id <openConversationId>",
"dws chat +flag-cancel --message-ids <id1>,<id2> --conversation-id <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the bounded message Favorite batch ledger and explicit separation from Pin, message Top, deletion and recall.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_flag_cancel",
"cobra-help:dws chat +flag-cancel",
"ShortcutRegistry:chat +flag-cancel"
]
},
"chat.shortcut_flag_create": {
"agent_summary": "收藏一条或多条消息（最多 10 条）",
"use_when": [
"当你要把同一会话中的一条或多条消息加入当前用户的个人收藏时使用；逐项返回成功/失败 ledger。这是消息 favorite，不是消息 Pin、会话置顶或 feed-layer thread flag。"
],
"avoid_when": [
"要让群成员共同看到固定消息使用 +messages-set-pin 或 +messages-set-top；要收藏文件到 Drive 不使用消息 Favorite"
],
"examples": [
"dws chat +flag-create --message-id <openMessageId> --conversation-id <openConversationId>",
"dws chat +flag-create --message-ids <id1>,<id2> --conversation-id <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the bounded personal Favorite batch ledger and routing distinction from shared Pin, message Top and Drive storage.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_flag_create",
"cobra-help:dws chat +flag-create",
"ShortcutRegistry:chat +flag-create"
]
},
"chat.shortcut_flag_list": {
"agent_summary": "分页查询当前用户收藏的消息",
"use_when": [
"当你要查看当前用户的 DingTalk message favorite 列表时使用；返回下层分页结果，不把 message favorite 与 Pin、会话置顶或 Lark feed-layer thread flag 混为一谈。"
],
"avoid_when": [
"查询 Pin 消息使用 +messages-list-pin；会话置顶使用 +conversation-list-top；不要把 Favorite 当成 Lark feed-layer thread flag"
],
"examples": [
"dws chat +flag-list --cursor 0 --size 20"
],
"reviewed": true,
"review_reason": "Agent-authored from read-only Favorite pagination and the reviewed distinction from Pin, conversation Top and Lark feed flags.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_flag_list",
"cobra-help:dws chat +flag-list",
"ShortcutRegistry:chat +flag-list"
]
},
"chat.shortcut_messages_add_emoji": {
"agent_summary": "对消息添加 emoji 表情回应",
"use_when": [
"当你想给某条消息点一个 emoji 表情回应时使用；会实际添加表情回应，需传会话 openConversationId、消息 openMsgId 和表情名称。"
],
"avoid_when": [
"取消回应使用 +messages-remove-emoji；自定义文字表情使用 +messages-create-text-emotion 和 +messages-add-text-emotion"
],
"examples": [
"dws chat +messages-add-emoji --conversation-id <openConversationId> --msg-id <openMessageId> --emoji \"赞\""
],
"reviewed": true,
"review_reason": "Agent-authored from the standard emoji reaction write and routing distinction from removal and custom text-emotion workflows.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_add_emoji",
"cobra-help:dws chat +messages-add-emoji",
"ShortcutRegistry:chat +messages-add-emoji"
]
},
"chat.shortcut_messages_add_text_emotion": {
"agent_summary": "对消息添加文字表情回应",
"use_when": [
"当你想给某条消息添加自定义文字表情回应时使用；会实际添加文字表情，需传会话、消息 openMsgId 及由 create-text-emotion 得到的 emotionId 等参数。"
],
"avoid_when": [
"尚无 emotionId 时先创建；普通 emoji 使用 +messages-add-emoji；移除文字表情使用 +messages-remove-text-emotion"
],
"examples": [
"dws chat +messages-add-text-emotion --conversation-id <openConversationId> --msg-id <openMessageId> --emotion-id <emotionId> --emotion-name \"赞\" --text \"nice\" --background-id im_bg_5"
],
"reviewed": true,
"review_reason": "Agent-authored from the create-before-add text-emotion workflow, complete identity payload, and sibling reaction routes.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_add_text_emotion",
"cobra-help:dws chat +messages-add-text-emotion",
"ShortcutRegistry:chat +messages-add-text-emotion"
]
},
"chat.shortcut_messages_batch_recall_by_bot": {
"agent_summary": "机器人撤回单聊消息",
"use_when": [
"当你要批量撤回机器人此前发出的单聊消息时使用；会实际撤回机器人单聊消息，需传 robotCode 和发送时返回的 processQueryKey 列表。"
],
"avoid_when": [
"机器人群消息撤回使用 +messages-recall-by-bot；当前用户消息撤回使用 +messages-recall；没有 processQueryKey 时不能按消息 ID 猜测"
],
"examples": [
"dws chat +messages-batch-recall-by-bot --robot-code <robotCode> --keys <key1>,<key2>"
],
"reviewed": true,
"review_reason": "Agent-authored from bot direct-message process-key recall and explicit routing against bot group recall and current-user recall.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_batch_recall_by_bot",
"cobra-help:dws chat +messages-batch-recall-by-bot",
"ShortcutRegistry:chat +messages-batch-recall-by-bot"
]
},
"chat.shortcut_messages_batch_send_by_bot": {
"agent_summary": "机器人批量向用户发送单聊 Markdown 消息",
"use_when": [
"当你要用机器人给多个人分别发单聊 Markdown 消息（如批量提醒交周报）时使用；会实际批量发送单聊消息，需传 robotCode、接收人列表（userId 或 openDingTalkId）及标题正文。"
],
"avoid_when": [
"机器人群发使用 +messages-send-by-bot；需要 current-user、Webhook、文件或复杂身份矩阵使用 +messages-send"
],
"examples": [
"dws chat +messages-batch-send-by-bot --robot-code <robotCode> --users <userId1>,<userId2> --title \"提醒\" --text \"请提交周报\""
],
"reviewed": true,
"review_reason": "Agent-authored from bot direct-message recipient constraints, Markdown payload boundary, and routing against group and unified send commands.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_batch_send_by_bot",
"cobra-help:dws chat +messages-batch-send-by-bot",
"ShortcutRegistry:chat +messages-batch-send-by-bot"
]
},
"chat.shortcut_messages_combine_forward": {
"agent_summary": "合并转发多条消息",
"use_when": [
"当你想把多条消息合并成一条转发到目标会话时使用；会实际合并转发，需传源会话、源消息 openMessageId 列表和目标会话 openConversationId。"
],
"avoid_when": [
"只转发一条消息使用 +messages-forward；转发话题线程使用 +messages-forward-topic；跨源会话消息不能混在一次合并转发"
],
"examples": [
"dws chat +messages-combine-forward --src-conversation-id <sourceCid> --msg-ids <messageId1>,<messageId2> --dest-conversation-id <destinationCid>"
],
"reviewed": true,
"review_reason": "Agent-authored from same-source multi-message combination, stable destination identity, and single/topic forward sibling routing.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_combine_forward",
"cobra-help:dws chat +messages-combine-forward",
"ShortcutRegistry:chat +messages-combine-forward"
]
},
"chat.shortcut_messages_create_text_emotion": {
"agent_summary": "创建文字表情（获取 emotionId）",
"use_when": [
"当你要先创建一个文字表情模板（拿到 emotionId 供 add-text-emotion 使用）时使用；会实际创建文字表情，需传表情名称和文字内容。"
],
"avoid_when": [
"已有 emotionId 时直接使用 +messages-add-text-emotion；普通 emoji 不需要创建文字表情模板"
],
"examples": [
"dws chat +messages-create-text-emotion --emotion-name \"赞\" --text \"nice\"",
"dws chat +messages-create-text-emotion --emotion-name \"处理中\" --text \"稍后回复\" --background-id im_bg_5"
],
"reviewed": true,
"review_reason": "Agent-authored from the template-creation outcome, returned emotionId dependency, and separation from adding/removing reactions on a message.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_create_text_emotion",
"cobra-help:dws chat +messages-create-text-emotion",
"ShortcutRegistry:chat +messages-create-text-emotion"
]
},
"chat.shortcut_messages_forward": {
"agent_summary": "转发单条消息",
"use_when": [
"当你想把一条消息转发到另一个会话时使用；会实际转发消息，需传源会话 openConversationId、源消息 openMessageId 和目标会话 openConversationId。"
],
"avoid_when": [
"合并转发多条消息使用 +messages-combine-forward；话题线程消息使用 +messages-forward-topic；只复制文本内容可重新发送"
],
"examples": [
"dws chat +messages-forward --src-conversation-id <sourceCid> --msg-id <openMessageId> --dest-conversation-id <destinationCid>"
],
"reviewed": true,
"review_reason": "Agent-authored from the stable source-message-destination tuple and explicit routing to combined or topic forwarding.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_forward",
"cobra-help:dws chat +messages-forward",
"ShortcutRegistry:chat +messages-forward"
]
},
"chat.shortcut_messages_forward_topic": {
"agent_summary": "转发话题消息到目标会话",
"use_when": [
"当你要把某条群话题消息转发到目标会话时使用；会实际转发话题消息，需传源消息、源会话、话题 threadId 和目标会话 openConversationId。"
],
"avoid_when": [
"普通单条消息使用 +messages-forward；合并多条普通消息使用 +messages-combine-forward；本命令不是 thread writer"
],
"examples": [
"dws chat +messages-forward-topic --src-msg-id <openMessageId> --src-conversation-id <sourceCid> --src-thread-id <threadId> --dest-conversation-id <destinationCid>"
],
"reviewed": true,
"review_reason": "Agent-authored from the required topic identity tuple and routing distinction from ordinary forwarding and unsupported thread writing.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_forward_topic",
"cobra-help:dws chat +messages-forward-topic",
"ShortcutRegistry:chat +messages-forward-topic"
]
},
"chat.shortcut_messages_list": {
"agent_summary": "拉取群聊会话消息",
"use_when": [
"当你想按时间拉取某个群的历史聊天记录（做回顾或分析）时使用；只读，需传群 openConversationId 和起始时间，--forward 控制往新还是往旧方向翻。"
],
"avoid_when": [
"要统一读取群聊或单聊并支持有界全量分页、原子导出和资源下载使用 +chat-messages；跨会话检索使用 +search-msg"
],
"examples": [
"dws chat +messages-list --group <openConversationId> --time \"2025-03-01 00:00:00\"",
"dws chat +messages-list --group <openConversationId> --time \"2025-03-01 00:00:00\" --forward --limit 50"
],
"reviewed": true,
"review_reason": "Agent-authored from the group-only time-bound history read and routing distinction from the unified paginated history and cross-conversation search routes.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_list",
"cobra-help:dws chat +messages-list",
"ShortcutRegistry:chat +messages-list"
]
},
"chat.shortcut_messages_recall": {
"agent_summary": "撤回当前用户发送的消息",
"use_when": [
"当你想撤回当前用户刚发出的某条消息时使用；会实际撤回消息。推荐同时传会话 openConversationId 和消息 openMessageId；若只传一个消息 ID，CLI 会先只读查询消息详情并补齐会话 ID。兼容 --message-id/--message-ids 的单值写法。"
],
"avoid_when": [
"机器人消息分别使用 +messages-recall-by-bot 或 +messages-batch-recall-by-bot；清空本人会话记录使用 +conversation-clear-messages"
],
"examples": [
"dws chat +messages-recall --conversation-id <openConversationId> --msg-id <openMessageId>",
"dws chat +messages-recall --msg-id <openMessageId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the current-user recall identity tuple, read-only completion fallback, confirmed write boundary, and bot/history-deletion sibling routes.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_recall",
"cobra-help:dws chat +messages-recall",
"ShortcutRegistry:chat +messages-recall"
]
},
"chat.shortcut_messages_recall_by_bot": {
"agent_summary": "机器人撤回群消息",
"use_when": [
"当你要撤回机器人此前发到群里的消息时使用；会实际撤回机器人群消息，需传 robotCode、群 openConversationId 和发送时返回的 processQueryKey 列表。"
],
"avoid_when": [
"机器人单聊消息撤回使用 +messages-batch-recall-by-bot；当前用户消息撤回使用 +messages-recall"
],
"examples": [
"dws chat +messages-recall-by-bot --robot-code <robotCode> --group <openConversationId> --keys <key1>,<key2>"
],
"reviewed": true,
"review_reason": "Agent-authored from bot group-message process-key recall and explicit routing against bot direct-message and current-user recall.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_recall_by_bot",
"cobra-help:dws chat +messages-recall-by-bot",
"ShortcutRegistry:chat +messages-recall-by-bot"
]
},
"chat.shortcut_messages_remove_emoji": {
"agent_summary": "移除消息的 emoji 表情回应",
"use_when": [
"当你想取消此前给某条消息添加的 emoji 表情回应时使用；会实际移除表情回应，需传会话 openConversationId、消息 openMsgId 和表情名称。"
],
"avoid_when": [
"添加回应使用 +messages-add-emoji；自定义文字表情移除使用 +messages-remove-text-emotion"
],
"examples": [
"dws chat +messages-remove-emoji --conversation-id <openConversationId> --msg-id <openMessageId> --emoji \"赞\""
],
"reviewed": true,
"review_reason": "Agent-authored from the standard emoji reaction removal and routing distinction from add and custom text-emotion operations.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_remove_emoji",
"cobra-help:dws chat +messages-remove-emoji",
"ShortcutRegistry:chat +messages-remove-emoji"
]
},
"chat.shortcut_messages_remove_text_emotion": {
"agent_summary": "移除消息的文字表情回应",
"use_when": [
"当你想移除此前给某条消息添加的文字表情回应时使用；会实际移除文字表情，需传会话、消息 openMsgId 及对应的表情参数。"
],
"avoid_when": [
"普通 emoji 使用 +messages-remove-emoji；要替换文字表情可使用原地 update-text-emotion；添加使用 +messages-add-text-emotion"
],
"examples": [
"dws chat +messages-remove-text-emotion --conversation-id <openConversationId> --msg-id <openMessageId> --emotion-id <emotionId> --emotion-name \"赞\" --text \"nice\" --background-id im_bg_5"
],
"reviewed": true,
"review_reason": "Agent-authored from exact text-emotion removal identity and routing against ordinary emoji, add and in-place update operations.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_remove_text_emotion",
"cobra-help:dws chat +messages-remove-text-emotion",
"ShortcutRegistry:chat +messages-remove-text-emotion"
]
},
"chat.shortcut_messages_resource_download": {
"agent_summary": "安全下载消息资源（图片/视频/语音/文件）到本地",
"use_when": [
"当你需要拿到消息里的实际图片、视频、语音或钉盘文件，而不只是资源 ID 时使用；mediaId 用消息和会话身份换取下载地址，fileId 复用钉盘下载能力，再安全写入工作目录内的相对路径。默认不覆盖已有文件，只有显式传 --overwrite 才覆盖；下载采用整文件临时落盘后原子发布，不支持 Range 断点续传。按既有安全本地下载约定无需交互确认。"
],
"avoid_when": [
"只需要临时下载链接使用 +messages-resource-url；需要 Range 断点续传或写到绝对路径时不要使用本命令"
],
"examples": [
"dws chat +messages-resource-download --resource-id <mediaId> --message-id <openMessageId> --open-conversation-id <openConversationId> --output ./downloads/",
"dws chat +messages-resource-download --type fileId --resource-id <fileId> --output ./downloads/"
],
"reviewed": true,
"review_reason": "Agent-authored from media/file identity routing, trusted HTTPS and redirect validation, portable workspace containment, atomic no-clobber publication, and URL-only sibling route.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_resource_download",
"cobra-help:dws chat +messages-resource-download",
"ShortcutRegistry:chat +messages-resource-download"
]
},
"chat.shortcut_messages_resource_url": {
"agent_summary": "获取消息资源（图片/视频/语音）下载链接",
"use_when": [
"当你想下载消息里的图片/视频/语音等资源时使用；只读换取临时下载链接，需传资源 mediaId、消息 openMessageId 和会话 openConversationId。"
],
"avoid_when": [
"需要安全下载并原子写入工作目录使用 +messages-resource-download；钉盘 fileId 下载也优先使用下载命令"
],
"examples": [
"dws chat +messages-resource-url --type mediaId --resource-id <mediaId> --message-id <openMessageId> --open-conversation-id <openConversationId>"
],
"reviewed": true,
"review_reason": "Agent-authored from the context-bound temporary URL read and routing distinction from the safe local download workflow.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_resource_url",
"cobra-help:dws chat +messages-resource-url",
"ShortcutRegistry:chat +messages-resource-url"
]
},
"chat.shortcut_messages_send_by_bot": {
"agent_summary": "机器人向群聊发送 Markdown 消息",
"use_when": [
"当你要用机器人向某群推送 Markdown 消息（如日报、告警播报）时使用；会实际以机器人身份发群消息，需传 robotCode、群 openConversationId、标题与正文，可 @人或 @所有人。"
],
"avoid_when": [
"机器人批量单聊使用 +messages-batch-send-by-bot；多群 ledger、current-user、Webhook、文件或自然目标使用 +messages-send"
],
"examples": [
"dws chat +messages-send-by-bot --robot-code <robotCode> --group <openConversationId> --title \"日报\" --text \"## 今日完成\""
],
"reviewed": true,
"review_reason": "Agent-authored from bot group Markdown and @ boundaries, confirmed send, and routing against bot direct batch and unified multi-identity send.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_send_by_bot",
"cobra-help:dws chat +messages-send-by-bot",
"ShortcutRegistry:chat +messages-send-by-bot"
]
},
"chat.shortcut_messages_set_pin": {
"agent_summary": "钉住消息（Pin）",
"use_when": [
"当你想把某条消息钉在会话中（Pin）以便成员随时查看时使用；会实际钉住消息，需传会话 openConversationId 和消息 openMessageId。"
],
"avoid_when": [
"要把消息显示在会话顶部使用 +messages-set-top；当前用户个人收藏使用 +flag-create；会话列表置顶使用 +conversation-set-top"
],
"examples": [
"dws chat +messages-set-pin --open-conversation-id <openConversationId> --msg-id <openMessageId>"
],
"reviewed": true,
"review_reason": "Agent-authored from message Pin state and explicit separation from message Top, personal Favorite and conversation Top.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_set_pin",
"cobra-help:dws chat +messages-set-pin",
"ShortcutRegistry:chat +messages-set-pin"
]
},
"chat.shortcut_messages_set_top": {
"agent_summary": "置顶消息",
"use_when": [
"当你想把某条消息置顶到会话顶部时使用；会实际置顶消息，需传会话 openConversationId 和消息 openMessageId。"
],
"avoid_when": [
"要加入消息 Pin 区域使用 +messages-set-pin；个人收藏使用 +flag-create；置顶整个会话使用 +conversation-set-top"
],
"examples": [
"dws chat +messages-set-top --open-conversation-id <openConversationId> --msg-id <openMessageId>"
],
"reviewed": true,
"review_reason": "Agent-authored from message Top state and explicit separation from Pin, Favorite and conversation-list Top.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_set_top",
"cobra-help:dws chat +messages-set-top",
"ShortcutRegistry:chat +messages-set-top"
]
},
"chat.shortcut_messages_unset_pin": {
"agent_summary": "取消钉住消息（Unpin）",
"use_when": [
"当你想取消此前钉住的消息时使用；会实际取消 Pin，需传会话 openConversationId 和消息 openMessageId。"
],
"avoid_when": [
"取消消息 Top 使用 +messages-unset-top；取消个人收藏使用 +flag-cancel；本命令不会删除或撤回消息"
],
"examples": [
"dws chat +messages-unset-pin --open-conversation-id <openConversationId> --msg-id <openMessageId>"
],
"reviewed": true,
"review_reason": "Agent-authored from clearing message Pin state and routing distinction from message Top, Favorite and deletion/recall.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_unset_pin",
"cobra-help:dws chat +messages-unset-pin",
"ShortcutRegistry:chat +messages-unset-pin"
]
},
"chat.shortcut_messages_unset_top": {
"agent_summary": "取消置顶消息",
"use_when": [
"当你想取消此前置顶的消息时使用；会实际取消置顶，需传会话 openConversationId 和消息 openMessageId。"
],
"avoid_when": [
"取消消息 Pin 使用 +messages-unset-pin；取消会话列表置顶使用 +conversation-set-top --off；取消收藏使用 +flag-cancel"
],
"examples": [
"dws chat +messages-unset-top --open-conversation-id <openConversationId> --msg-id <openMessageId>"
],
"reviewed": true,
"review_reason": "Agent-authored from clearing message Top state and routing distinction from Pin, conversation Top and personal Favorite.",
"source_refs": [
"internal/cli/schema_command_registry/products/chat.json#chat.shortcut_messages_unset_top",
"cobra-help:dws chat +messages-unset-top",
"ShortcutRegistry:chat +messages-unset-top"
]
}
},
"products": {
"chat": {
"agent_summary": "管理钉钉会话、群聊、群成员、机器人、消息检索与发送",
"use_when": [
"请求涉及群聊管理、聊天记录、消息发送、会话设置或群机器人"
],
"avoid_when": [
"邮件用 mail；开放平台应用/机器人建号发布用 dev；企业语义找人优先 aisearch person"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry/registry.json",
"skills/mono/references/products/chat.md",
"CommandRegistry:product=chat",
"Skill:skills/mono/references/products/chat.md",
"live-dws-schema:product-batch-2026-07-14"
]
}
}
}
Reference in New Issue View Git Blame Copy Permalink