{ "version": 1, "source_hash": "sha256:a2ad77f7d8c0816a0e553a5ee5306c6ca0f2139edb83207c35eefecd2411f72f", "surface_hash": "sha256:75c63f35d9b15dfb4df09136bfd250906751cfeb7f14bce08cf092097859baad", "catalog": { "agent_metadata": { "products_with_metadata": 20, "source": "embedded-skill-metadata", "source_hash": "sha256:b0788dd79d817258e2fd5869e4b32eff5ab81b6d20f34e7eb131446670402003", "surface_hash": "sha256:75c63f35d9b15dfb4df09136bfd250906751cfeb7f14bce08cf092097859baad", "surface_products": 20, "surface_tools": 538, "tools_with_agent_summary": 538, "tools_with_metadata": 538, "unmatched_skill_tools": 162, "version": 1 }, "count": 20, "interface_metadata": { "coverage": { "aliased_tools": 178, "matched_tools": 419, "missing_services": [ "notify" ], "snapshot_services": 53, "source_services": 54, "source_tools": 969, "surface_scope": "source_revision", "surface_tools": 504, "unmatched_tools": 85 }, "source": "mcp-tools-list+cli-registry", "source_hash": "sha256:17251f74a4f76142457cc0e87251ecb86c1e3bda0cdf2edc02f351589716ecbc", "source_revision": "4574f7022c32cf4c033e9b7b4156e2fec815fed8", "tool_count": 419, "version": 1 }, "kind": "schema", "level": "catalog", "products": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/SKILL.md", "skills/mono/schema-hints/catalog-completeness.json" ], "agent_summary": "企业内智能搜人，支持按姓名、部门、职位、技能、职责、手机号或工号定位人员", "agent_summary_source": "dws-command-surface-review", "description": "AI 搜问", "id": "aisearch", "name": "AI 搜问", "runtime": true, "tool_count": 3, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "企业内找人搜索工具，支持按姓名、部门、职位、技能、工作职责等多维度搜索企业内人员。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“企业内找人搜索工具，支持按姓名、部门、职位、技能、工作职责等多维度搜索企业内人员。”" ], "canonical_path": "aisearch.enterprise_person_search", "cli_name": "person", "cli_path": "aisearch person", "confirmation": "not_required", "description": "企业内找人搜索工具，支持按姓名、部门、职位、技能、工作职责等多维度搜索企业内人员。\\n\\n**适用场景示例**：\\n- 找一下负责智能化的人\\n- 帮我找产品经理\\n- 技术部有哪些人\\n- 张三的领导是谁\\n- 李四手下有哪些人\\n- 帮我找下王芳\\n- 谁在做大模型相关的工作\\n- 公司有哪些架构师\\n- 市场部的同事有谁\\n- 有没有会Java的同事\\n- 研发部的负责人是谁\\n- 帮我找一下跟智能客服有关的人\\n- 做设计的同事有谁\\n- 谁是技术总监\\n- 张三在哪个部门\\n\\n", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "enterprise_person_search", "primary_cli_path": "aisearch person", "reviewed": false, "risk": "low", "title": "enterprise_person_search", "use_when": [ "13800138000是谁/查手机号；按手机号搜人", "222020这个工号是谁/查工号；按工号搜人", "五道的上级是谁/谁负责XX/XX的下属有谁；AI语义搜人", "找一下张三/搜同事/找人；AI搜人(首选)", "搜人/找人/谁负责/上级是谁/哪个部门的人" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "企业内部知识搜索工具。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“企业内部知识搜索工具。”" ], "canonical_path": "aisearch.search_enterprise", "cli_name": "enterprise", "cli_path": "aisearch enterprise", "confirmation": "not_required", "description": "企业内部知识搜索工具。用于检索企业内部的文档、消息、日程、会议纪要、工作日志、多维表、企业百科等知识内容，基于关键词语义匹配返回相关资料。支持自然语言时间表达式（如\"最近\"、\"上周\"、\"本季度\"）。适用场景：查找某个主题的资料、搜索包含特定关键词的文档、了解某项目/产品相关信息、准备汇报材料等内容检索需求。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "search_enterprise", "primary_cli_path": "aisearch enterprise", "reviewed": false, "risk": "low", "title": "search_enterprise", "use_when": [ "搜一下智能化方案/最近 OKR 相关邮件/最近发版相关消息；搜企业知识内容", "搜资料/找方案/查文档/搜企业知识/项目相关内容/工作总结/周报总结", "最近/本周/今天 + XX相关消息/文档/邮件有哪些" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "业内部行为记录搜索工具。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“业内部行为记录搜索工具。”" ], "canonical_path": "aisearch.search_enterprise_behavior", "cli_name": "behavior", "cli_path": "aisearch behavior", "confirmation": "not_required", "description": "业内部行为记录搜索工具。用于检索用户的操作行为记录，如文档的发送、创建、分享、编辑等历史操作，支持按人员、动作类型进行精确查询。适用场景：\"我给某人发过什么\"、\"我创建过哪些文档\"、\"某人发给我的消息\"、\"我分享过的资料\"等行为追溯需求。与知识搜索的区别：本工具关注\"谁对什么做了什么\"，而非内容本身。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "search_enterprise_behavior", "primary_cli_path": "aisearch behavior", "reviewed": false, "risk": "low", "title": "search_enterprise_behavior", "use_when": [ "我发给某人的消息/邮件/文档/今天我干了什么；搜行为记录", "我发过/谁发给我/创建过/分享过/收到过/今天我干了什么" ] } ], "use_when": [ "找人/搜人/谁负责 XX/某事项的负责人/某项目的人/团队成员/上级/下级/按工号找人/按手机号找人" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json", "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "AI 表格操作", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "avoid_when": [ "创建一个电子表格；创建表格文档", "帮我写个项目周报；创建钉钉文档", "帮我记一下明天要做的事；创建个人待办", "帮我读一下表格 A1:D10 的数据；读取单元格数据" ], "description": "AI 表格操作", "id": "aitable", "name": "AI 表格操作", "runtime": true, "tool_count": 114, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "开启或关闭指定 Base 的高级权限总开关。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除指定 Base 下的自定义角色;”请改用 dws aitable advperm role-delete", "要“在指定 Base 下创建自定义角色;”请改用 dws aitable advperm role-create", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm enable" ], "canonical_path": "aitable.advperm_disable", "cli_name": "disable", "cli_path": "aitable advperm disable", "confirmation": "user_required", "description": "开启或关闭指定 Base 的高级权限总开关。必填 baseId、enabled(true=开启,false=关闭)。\r\n返回切换后的状态 {baseId, enabled};只有显式开启后,后续 list_roles / get_role 等角色配置才会真正生效。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "set_advanced_permission" }, "metadata_source": "embedded-mcp-metadata", "name": "advperm_disable", "primary_cli_path": "aitable advperm disable", "reviewed": false, "risk": "high", "title": "set_advanced_permission", "use_when": [ "开启或关闭指定 Base 的高级权限总开关。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "开启或关闭指定 Base 的高级权限总开关。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除指定 Base 下的自定义角色;”请改用 dws aitable advperm role-delete", "要“在指定 Base 下创建自定义角色;”请改用 dws aitable advperm role-create", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm disable" ], "canonical_path": "aitable.advperm_enable", "cli_name": "enable", "cli_path": "aitable advperm enable", "confirmation": "not_required", "description": "开启或关闭指定 Base 的高级权限总开关。必填 baseId、enabled(true=开启,false=关闭)。\r\n返回切换后的状态 {baseId, enabled};只有显式开启后,后续 list_roles / get_role 等角色配置才会真正生效。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "set_advanced_permission" }, "metadata_source": "embedded-mcp-metadata", "name": "advperm_enable", "primary_cli_path": "aitable advperm enable", "reviewed": false, "risk": "medium", "title": "set_advanced_permission", "use_when": [ "1. 确保高级权限已开" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在指定 Base 下创建自定义角色;", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除指定 Base 下的自定义角色;”请改用 dws aitable advperm role-delete", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm disable", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm enable" ], "canonical_path": "aitable.advperm_role_create", "cli_name": "role-create", "cli_path": "aitable advperm role-create", "confirmation": "not_required", "description": "在指定 Base 下创建自定义角色;系统角色无法通过本工具创建。必填 baseId、name;可选 roleType、flowType、subRoles。\r\nsubRoles[].authLevel 取值:manage / edit-own / edit-custom-field / edit-field-range / read / none。\r\n返回新建角色的完整配置(同 get_role 出参格式)。\r\n自动兜底:caller 可以传稀疏 subRoles(只列关心的资源),或 subRoles 留空。MCP 会自动枚举 Base 下所有 sheet/dashboard,caller 未列的资源补 authLevel=none + bizType 对应默认 config;caller 列了但 config=null 的 sheet/dashboard 也填默认 config(避免前端 JSON.parse null 白屏)。app(bizType=3)需 caller 显式传,不自动枚举。\r\n约束:name 建议 ≤ 30 字;roleType 禁止以 system_ 开头(保留给系统角色);调用者 uid 必须是该 Base 的管理员,否则 UNAUTHORIZED。\r\n失败码:ILLEGAL_ARGUMENT / UNAUTHORIZED / SERVER_ERROR。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "create_role" }, "metadata_source": "embedded-mcp-metadata", "name": "advperm_role_create", "primary_cli_path": "aitable advperm role-create", "reviewed": false, "risk": "medium", "title": "create_role", "use_when": [ "3. 创建角色 + 指定 sheet 子角色 authLevel=read", "仅指定 name，子角色由服务端按默认（none）填充", "创建时即指定 sub-roles（推荐——避免再走一次 role-update）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除指定 Base 下的自定义角色;", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建自定义角色;”请改用 dws aitable advperm role-create", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm disable", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm enable" ], "canonical_path": "aitable.advperm_role_delete", "cli_name": "role-delete", "cli_path": "aitable advperm role-delete", "confirmation": "user_required", "description": "删除指定 Base 下的自定义角色;系统角色禁止删除,下游会返回业务错误。必填 baseId、roleId。\r\n返回被删除的 roleId。删除操作不可逆。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "delete_role" }, "metadata_source": "embedded-mcp-metadata", "name": "advperm_role_delete", "primary_cli_path": "aitable advperm role-delete", "reviewed": false, "risk": "high", "title": "delete_role", "use_when": [ "删除指定 Base 下的自定义角色;" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取指定 Base 下单个角色的完整配置,含 subRoles 与字段/行级权限。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建自定义角色;”请改用 dws aitable advperm role-create", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm disable", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm enable" ], "canonical_path": "aitable.advperm_role_get", "cli_name": "role-get", "cli_path": "aitable advperm role-get", "confirmation": "not_required", "description": "获取指定 Base 下单个角色的完整配置,含 subRoles 与字段/行级权限。\r\n\r\n参数:必填 baseId、roleId。\r\n\r\n返回 {roleId, name, roleType, flowType, isSystem, subRoles:[{targetId, targetType, authLevel, appId, config}]}。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_role" }, "metadata_source": "embedded-mcp-metadata", "name": "advperm_role_get", "primary_cli_path": "aitable advperm role-get", "reviewed": false, "risk": "low", "title": "get_role", "use_when": [ "获取指定 Base 下单个角色的完整配置,含 subRoles 与字段/行级权限。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出指定 Base 下的全部角色,含系统角色与自定义角色,并标注 isSystem 与默认角色信息。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建自定义角色;”请改用 dws aitable advperm role-create", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm disable", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm enable" ], "canonical_path": "aitable.advperm_role_list", "cli_name": "role-list", "cli_path": "aitable advperm role-list", "confirmation": "not_required", "description": "列出指定 Base 下的全部角色,含系统角色与自定义角色,并标注 isSystem 与默认角色信息。\r\n\r\n参数:必填 baseId。\r\n\r\n返回 {enabled, defaultRole:{mode, roleId}, roles:[{roleId, name, roleType, flowType, isSystem, subRoles}]}。\r\n\r\n不返回角色成员列表;若需要添加/移除角色成员,请使用其他专用工具。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "list_roles" }, "metadata_source": "embedded-mcp-metadata", "name": "advperm_role_list", "primary_cli_path": "aitable advperm role-list", "reviewed": false, "risk": "low", "title": "list_roles", "use_when": [ "列出指定 Base 下的全部角色,含系统角色与自定义角色,并标注 isSystem 与默认角色信息。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "增量更新自定义角色配置。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建自定义角色;”请改用 dws aitable advperm role-create", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm disable", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm enable" ], "canonical_path": "aitable.advperm_role_update", "cli_name": "role-update", "cli_path": "aitable advperm role-update", "confirmation": "not_required", "description": "增量更新自定义角色配置。必填 baseId、roleId;可选 name、roleType、flowType、subRoles。\r\nsubRoles 行为:不传=完全不动现有 subRoles;传入则按 (targetId, targetType) 与现有 subRoles 合并——入参中的 sub 整体替换该 sub,入参未提及的 sub 保留不变。MCP 已在内部做 get→merge,caller 无需先调 get_role。\r\n自动兜底:caller 传非空 subRoles 时,MCP 会对其中 sheet/dashboard 项里 config=null 的自动填默认 config(避免前端崩),不会额外枚举 Base 资源(与 create 不同,patch 保持\"只动调用方列的项\"语义)。\r\n系统角色禁止更新。\r\n约束:roleType 禁止以 system_ 开头;调用者 uid 必须是该 Base 的管理员,否则 UNAUTHORIZED。\r\n失败码:ILLEGAL_ARGUMENT / UNAUTHORIZED / SERVER_ERROR。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "patch_role" }, "metadata_source": "embedded-mcp-metadata", "name": "advperm_role_update", "primary_cli_path": "aitable advperm role-update", "reviewed": false, "risk": "medium", "title": "patch_role", "use_when": [ "只传 sub-roles，name 等其他字段保持不变（PATCH 语义）", "只改 sheet 子角色 authLevel，name 不传保持不变", "只改名" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "申请 attachment 字段 OSS 直传地址（不直接上传）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“申请 attachment 字段 OSS 直传地址（不直接上传）”所述变更时不要使用" ], "canonical_path": "aitable.attachment_upload", "cli_name": "upload", "cli_path": "aitable attachment upload", "confirmation": "not_required", "description": "为单个 attachment 字段文件申请带容量校验的 OSS 直传地址。\r\n该工具仅适用于“需要先上传本地文件，再将其写入 attachment 字段”的场景，不是通用文件上传入口，也不适用于后续导入类任务上传。\r\n如果已经有可直接下载的在线文件 URL，不要先下载文件再调用本工具；可直接在 create_records / update_records 的 attachment 字段中传入 [{\"url\":\"https://...\"}]，由服务端自动代拉外链并转存为内部附件。\r\n该工具只负责准备上传，不直接接收文件二进制内容；实际文件字节流应由客户端在 MCP 外上传到返回的 uploadUrl。\r\n上传文件时，向 uploadUrl 发起的 PUT 请求必须携带 Content-Type header，且其值必须是该文件的具体 MIME type。\r\n上传成功后，请在 create_records / update_records 的 attachment 字段中写入 [{\"fileToken\":\"...\"}]。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "prepare_attachment_upload" }, "metadata_source": "embedded-mcp-metadata", "name": "attachment_upload", "primary_cli_path": "aitable attachment upload", "risk": "medium", "title": "准备附件上传", "use_when": [ "1. 获取上传凭证" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制元数据还是只是复制表的结构不复制数据，三个参数都是必填的,如果用户传的是链接的话则需要根据实际去调用文档的DWS去获取dentryuuid信息，并且传入", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“获取 Base 资源目录（tables、dashboards s”请改用 dws aitable base get" ], "canonical_path": "aitable.base_copy", "cli_name": "copy", "cli_path": "aitable base copy", "confirmation": "not_required", "description": "复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制元数据还是只是复制表的结构不复制数据，三个参数都是必填的,如果用户传的是链接的话则需要根据实际去调用文档的DWS去获取dentryuuid信息，并且传入", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "copy_base" }, "metadata_source": "embedded-mcp-metadata", "name": "base_copy", "primary_cli_path": "aitable base copy", "reviewed": false, "risk": "medium", "title": "copy_base", "use_when": [ "复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制元数据还是只是复制表的结构不复制数据，三个参数都是必填的,如果用户传的是链接的话则需要根据实际去调用文档的DWS去获取dentryuuid信息，并且传入" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建 AI 表格 Base", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy", "要“获取 Base 资源目录（tables、dashboards s”请改用 dws aitable base get" ], "canonical_path": "aitable.base_create", "cli_name": "create", "cli_path": "aitable base create", "confirmation": "not_required", "description": "创建一个新的 AI 表格 Base。当前仅要求 baseName，服务端按默认模板创建并返回 baseId/baseName，如果需要创建的特定的文件夹路径下，则需要传递folderId，这个是知识库节点的ID，调用文档的相关服务可以获取", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_base" }, "metadata_source": "embedded-mcp-metadata", "name": "base_create", "primary_cli_path": "aitable base create", "risk": "medium", "title": "创建 AI 表格", "use_when": [ "表格/多维表/AI表格；创建" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除 Base（高风险、不可逆）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy", "要“获取 Base 资源目录（tables、dashboards s”请改用 dws aitable base get" ], "canonical_path": "aitable.base_delete", "cli_name": "delete", "cli_path": "aitable base delete", "confirmation": "user_required", "description": "删除指定 Base（高风险、不可逆）。成功后应无法通过 get_base/search_bases 读取到该 Base", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_base" }, "metadata_source": "embedded-mcp-metadata", "name": "base_delete", "primary_cli_path": "aitable base delete", "risk": "high", "title": "删除 AI 表格", "use_when": [ "表格/多维表/AI表格；删除" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取 Base 资源目录（tables、dashboards summary）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy" ], "canonical_path": "aitable.base_get", "cli_name": "get", "cli_path": "aitable base get", "confirmation": "not_required", "description": "获取指定 Base 的资源目录级信息，返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。\r\n这是当前 Base 级目录入口：后续如需 tableId 或 dashboardId，优先从这里读取；table 详情再调用 get_tables，dashboard 详情再调用 get_dashboard", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_base" }, "metadata_source": "embedded-mcp-metadata", "name": "base_get", "primary_cli_path": "aitable base get", "risk": "low", "title": "获取 AI 表格信息", "use_when": [ "2. 获取 Base 信息 — 提取 tableId", "表格/多维表/AI表格；详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据 baseId、tableId 和 recordId 获取主键文档对应的文档信息，会返回对应的文档的dentryuuid，然后利用该uuid去获取文档的内容以及做其他操作", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy" ], "canonical_path": "aitable.base_get_primary_doc_id", "cli_name": "get-primary-doc-id", "cli_path": "aitable base get-primary-doc-id", "confirmation": "not_required", "description": "根据 baseId、tableId 和 recordId 获取主键文档对应的文档信息，会返回对应的文档的dentryuuid，然后利用该uuid去获取文档的内容以及做其他操作", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_base_primary_doc_id" }, "metadata_source": "embedded-mcp-metadata", "name": "base_get_primary_doc_id", "primary_cli_path": "aitable base get-primary-doc-id", "reviewed": false, "risk": "low", "title": "获取AI表格中主键即文档字段的文档ID", "use_when": [ "根据 baseId、tableId 和 recordId 获取主键文档对应的文档信息，会返回对应的文档的dentryuuid，然后利用该uuid去获取文档的内容以及做其他操作" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取 AI 表格列表（最近访问）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy" ], "canonical_path": "aitable.base_list", "cli_name": "list", "cli_path": "aitable base list", "confirmation": "not_required", "description": "列出当前用户可访问的 AI 表格 Base。默认返回最近访问结果，支持分页游标续取。返回 baseId 与 baseName，后续可直接用于 get_base。\r\nAI 表格访问地址可按 baseId 拼接为：https://docs.dingtalk.com/i/nodes/{baseId}", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "list_bases" }, "metadata_source": "embedded-mcp-metadata", "name": "base_list", "primary_cli_path": "aitable base list", "risk": "low", "title": "获取 AI 表格列表", "use_when": [ "获取 AI 表格列表（最近访问）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "按名称关键词搜索 AI 表格 Base。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy" ], "canonical_path": "aitable.base_search", "cli_name": "search", "cli_path": "aitable base search", "confirmation": "not_required", "description": "按名称关键词搜索 AI 表格 Base。返回 baseId/baseName，结果按相关性排序。返回的 baseId 可直接用于 get_base 等后续工具。\r\nAI 表格访问地址可按 baseId 拼接为：https://docs.dingtalk.com/i/nodes/{baseId}", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "search_bases" }, "metadata_source": "embedded-mcp-metadata", "name": "base_search", "primary_cli_path": "aitable base search", "reviewed": false, "risk": "low", "title": "搜索 AI 表格", "use_when": [ "1. 搜索/列出 Base — 提取 baseId", "表格/多维表/AI表格；查看/查找/列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新 Base 名称 / 备注", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy" ], "canonical_path": "aitable.base_update", "cli_name": "update", "cli_path": "aitable base update", "confirmation": "not_required", "description": "更新 Base 名称（可选备注）。当前不支持修改主题、封面等扩展属性", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_base" }, "metadata_source": "embedded-mcp-metadata", "name": "base_update", "primary_cli_path": "aitable base update", "risk": "medium", "title": "更新 AI 表格", "use_when": [ "表格/多维表/AI表格；修改" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在 dashboard 下创建 chart（需 --config 与 --layout）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 chart（同步删除其 dashboard 布局项；不可逆”请改用 dws aitable chart delete", "要“更新 chart 配置 / 布局”请改用 dws aitable chart update", "要“获取 chart 详细信息（widget.config + 布局”请改用 dws aitable chart get" ], "canonical_path": "aitable.chart_create", "cli_name": "create", "cli_path": "aitable chart create", "confirmation": "not_required", "description": "在指定 dashboard 下创建 chart。调用前必须先调用 get_dashboard_widgets_example 了解 config 入参结构和要求。返回新创建的 chart 详情。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_chart" }, "metadata_source": "embedded-mcp-metadata", "name": "chart_create", "primary_cli_path": "aitable chart create", "risk": "medium", "title": "更新图表", "use_when": [ "在 dashboard 下创建 chart（需 --config 与 --layout）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除 chart（同步删除其 dashboard 布局项；不可逆）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“在 dashboard 下创建 chart（需 --config”请改用 dws aitable chart create", "要“更新 chart 配置 / 布局”请改用 dws aitable chart update", "要“获取 chart 详细信息（widget.config + 布局”请改用 dws aitable chart get" ], "canonical_path": "aitable.chart_delete", "cli_name": "delete", "cli_path": "aitable chart delete", "confirmation": "user_required", "description": "删除指定 chart，并同步删除其在 dashboard 中对应的布局项。删除操作不可逆。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_chart" }, "metadata_source": "embedded-mcp-metadata", "name": "chart_delete", "primary_cli_path": "aitable chart delete", "risk": "high", "title": "删除图表", "use_when": [ "删除 chart（同步删除其 dashboard 布局项；不可逆）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取 chart 详细信息（widget.config + 布局）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 chart（同步删除其 dashboard 布局项；不可逆”请改用 dws aitable chart delete", "要“在 dashboard 下创建 chart（需 --config”请改用 dws aitable chart create", "要“更新 chart 配置 / 布局”请改用 dws aitable chart update" ], "canonical_path": "aitable.chart_get", "cli_name": "get", "cli_path": "aitable chart get", "confirmation": "not_required", "description": "获取指定 chart 的详细信息。返回所属 dashboardId、chartName、chartType、widget.config 以及布局项。返回的 config 中 sheet 为该图表引用的数据表 tableId，view 为视图 viewId。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_chart" }, "metadata_source": "embedded-mcp-metadata", "name": "chart_get", "primary_cli_path": "aitable chart get", "risk": "low", "title": "获取图表信息", "use_when": [ "2) 先拿 dashboard，再拿 chart 详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取 chart 分享配置", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“更新 chart 分享开关与类型”请改用 dws aitable chart share update" ], "canonical_path": "aitable.chart_share_get", "cli_name": "get", "cli_path": "aitable chart share get", "confirmation": "not_required", "description": "查询指定 chart 的当前分享配置。返回分享是否已开启（enabled）、分享类型（shareType：PUBLIC / ORG）、分享链接（shareUrl）等信息。若分享尚未开启，enabled 为 false，shareUrl 为 null。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_chart_share" }, "metadata_source": "embedded-mcp-metadata", "name": "chart_share_get", "primary_cli_path": "aitable chart share get", "risk": "low", "title": "获取图表的分享配置", "use_when": [ "获取 chart 分享配置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新 chart 分享开关与类型", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“获取 chart 分享配置”请改用 dws aitable chart share get" ], "canonical_path": "aitable.chart_share_update", "cli_name": "update", "cli_path": "aitable chart share update", "confirmation": "not_required", "description": "用于开启或关闭指定 chart 的分享，并设置分享类型。\\nenabled=true 时开启分享；enabled=false 时关闭分享（shareType 此时无意义）。\\nshareType 支持两种：PUBLIC（任何人均可访问）、ORG（仅限当前组织成员访问）。\\n返回更新后的分享配置，包括 shareUrl（可直接发送给他人）。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_chart_share" }, "metadata_source": "embedded-mcp-metadata", "name": "chart_share_update", "primary_cli_path": "aitable chart share update", "risk": "medium", "title": "更新图表分享配置（开启或关闭或更新配置）", "use_when": [ "更新 chart 分享开关与类型" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新 chart 配置 / 布局", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 chart（同步删除其 dashboard 布局项；不可逆”请改用 dws aitable chart delete", "要“在 dashboard 下创建 chart（需 --config”请改用 dws aitable chart create", "要“获取 chart 详细信息（widget.config + 布局”请改用 dws aitable chart get" ], "canonical_path": "aitable.chart_update", "cli_name": "update", "cli_path": "aitable chart update", "confirmation": "not_required", "description": "更新指定 chart 的配置或布局。调用前必须先调用 get_dashboard_widgets_example 了解 config 入参结构和要求。返回更新后的 chart 详情。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_chart" }, "metadata_source": "embedded-mcp-metadata", "name": "chart_update", "primary_cli_path": "aitable chart update", "risk": "medium", "title": "更新图表", "use_when": [ "更新 chart 配置 / 布局" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "返回所有图表类型的 widget config 示例（JSONC）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 chart（同步删除其 dashboard 布局项；不可逆”请改用 dws aitable chart delete", "要“在 dashboard 下创建 chart（需 --config”请改用 dws aitable chart create", "要“获取 chart 详细信息（widget.config + 布局”请改用 dws aitable chart get" ], "canonical_path": "aitable.chart_widgets_example", "cli_name": "widgets-example", "cli_path": "aitable chart widgets-example", "confirmation": "not_required", "description": "返回所有图表类型的 widget config 示例（JSONC 格式，含注释说明每个字段的含义和约束，请直接阅读理解）。可作为 create_chart / update_chart 的 config 参数结构参考，根据目标图表类型选取对应示例。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_dashboard_widgets_example" }, "metadata_source": "embedded-mcp-metadata", "name": "chart_widgets_example", "primary_cli_path": "aitable chart widgets-example", "risk": "low", "title": "获取图表配置示例", "use_when": [ "1) 先看配置模板（JSONC）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建 AI 表格（dws aitable base create 的别名）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建 AI 表格（dws aitable base create 的别名）”所述变更时不要使用" ], "canonical_path": "aitable.create", "cli_name": "create", "cli_path": "aitable create", "confirmation": "not_required", "description": "创建一个新的 AI 表格 Base。\n这是 dws aitable base create 的便捷别名,两个命令完全等价。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_base" }, "name": "create", "primary_cli_path": "aitable create", "reviewed": true, "risk": "medium", "title": "创建 AI 表格（dws aitable base create 的别名）", "use_when": [ "创建 AI 表格（dws aitable base create 的别名）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 dashboard（级联删除其下 chart；不可逆）”请改用 dws aitable dashboard delete", "要“在指定 Base 下创建 dashboard”请改用 dws aitable dashboard create", "要“返回 dashboard config 结构示例（JSONC）”请改用 dws aitable dashboard config-example" ], "canonical_path": "aitable.dashboard_arrange", "cli_name": "arrange", "cli_path": "aitable dashboard arrange", "confirmation": "not_required", "description": "自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排。根据仪表盘的网格列数（schemaVersion 为 2 时为 48 列，其他情况为 12 列），自动将 y 坐标相近的图表归为同一行，统一同行图表高度，按比例缩放宽度使每行精确填满全列，紧凑排列消除行间空隙，消除底部参差不齐。返回对齐后的完整布局信息。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "align_dashboard" }, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_arrange", "primary_cli_path": "aitable dashboard arrange", "reviewed": false, "risk": "medium", "title": "自动对齐仪表盘布局", "use_when": [ "自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "返回 dashboard config 结构示例（JSONC）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 dashboard（级联删除其下 chart；不可逆）”请改用 dws aitable dashboard delete", "要“在指定 Base 下创建 dashboard”请改用 dws aitable dashboard create", "要“自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排”请改用 dws aitable dashboard arrange" ], "canonical_path": "aitable.dashboard_config_example", "cli_name": "config-example", "cli_path": "aitable dashboard config-example", "confirmation": "not_required", "description": "返回 dashboard config 的完整结构示例（JSONC 格式，含注释说明每个字段的含义和约束，请直接阅读理解）。可作为 create_dashboard / update_dashboard 的 config 参数结构参考。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_dashboard_config_example" }, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_config_example", "primary_cli_path": "aitable dashboard config-example", "risk": "low", "title": "获取仪表盘配置示例", "use_when": [ "1) 先看配置模板（JSONC）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在指定 Base 下创建 dashboard。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 dashboard（级联删除其下 chart；不可逆）”请改用 dws aitable dashboard delete", "要“自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排”请改用 dws aitable dashboard arrange", "要“返回 dashboard config 结构示例（JSONC）”请改用 dws aitable dashboard config-example" ], "canonical_path": "aitable.dashboard_create", "cli_name": "create", "cli_path": "aitable dashboard create", "confirmation": "not_required", "description": "在指定 Base 下创建 dashboard。调用前必须先调用 get_dashboard_config_example 了解 config 入参结构和要求。返回新创建的 dashboard 详情。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_dashboard" }, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_create", "primary_cli_path": "aitable dashboard create", "reviewed": false, "risk": "medium", "title": "创建仪表盘", "use_when": [ "在指定 Base 下创建 dashboard。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除 dashboard（级联删除其下 chart；不可逆）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建 dashboard”请改用 dws aitable dashboard create", "要“自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排”请改用 dws aitable dashboard arrange", "要“返回 dashboard config 结构示例（JSONC）”请改用 dws aitable dashboard config-example" ], "canonical_path": "aitable.dashboard_delete", "cli_name": "delete", "cli_path": "aitable dashboard delete", "confirmation": "user_required", "description": "删除指定 dashboard，会级联删除该 dashboard 下的所有 chart；删除操作不可逆。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_dashboard" }, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_delete", "primary_cli_path": "aitable dashboard delete", "risk": "high", "title": "删除仪表盘", "use_when": [ "删除 dashboard（级联删除其下 chart；不可逆）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取 dashboard 详情（含 charts summary）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建 dashboard”请改用 dws aitable dashboard create", "要“自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排”请改用 dws aitable dashboard arrange", "要“返回 dashboard config 结构示例（JSONC）”请改用 dws aitable dashboard config-example" ], "canonical_path": "aitable.dashboard_get", "cli_name": "get", "cli_path": "aitable dashboard get", "confirmation": "not_required", "description": "获取指定 dashboard 的详细信息。\\r\\n返回 dashboardName、filters、layout，以及该 dashboard 下的 charts summary（chartId、chartName、chartType）。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_dashboard" }, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_get", "primary_cli_path": "aitable dashboard get", "risk": "low", "title": "获取仪表盘信息", "use_when": [ "2) 先拿 dashboard，再拿 chart 详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取 dashboard 分享配置", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“更新 dashboard 分享开关与类型”请改用 dws aitable dashboard share update" ], "canonical_path": "aitable.dashboard_share_get", "cli_name": "get", "cli_path": "aitable dashboard share get", "confirmation": "not_required", "description": "查询指定 dashboard 的当前分享配置。返回分享是否已开启（enabled）、分享类型（shareType：PUBLIC / ORG）、分享链接（shareUrl）等信息。若分享尚未开启，enabled 为 false，shareUrl 为 null。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_dashboard_share" }, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_share_get", "primary_cli_path": "aitable dashboard share get", "risk": "low", "title": "查询仪表盘分享配置", "use_when": [ "获取 dashboard 分享配置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新 dashboard 分享开关与类型", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“获取 dashboard 分享配置”请改用 dws aitable dashboard share get" ], "canonical_path": "aitable.dashboard_share_update", "cli_name": "update", "cli_path": "aitable dashboard share update", "confirmation": "not_required", "description": "用于开启或关闭指定 dashboard 的分享，并设置分享类型。enabled=true 时开启分享；enabled=false 时关闭分享（shareType 此时无意义）。shareType 支持两种：PUBLIC（任何人均可访问）、ORG（仅限当前组织成员访问）。返回更新后的分享配置，包括 shareUrl（可直接发送给他人）。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_dashboard_share" }, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_share_update", "primary_cli_path": "aitable dashboard share update", "risk": "medium", "title": "设置仪表盘分享配置（开启或关闭或更新配置）", "use_when": [ "更新 dashboard 分享开关与类型" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新指定 dashboard 的配置。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建 dashboard”请改用 dws aitable dashboard create", "要“自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排”请改用 dws aitable dashboard arrange", "要“返回 dashboard config 结构示例（JSONC）”请改用 dws aitable dashboard config-example" ], "canonical_path": "aitable.dashboard_update", "cli_name": "update", "cli_path": "aitable dashboard update", "confirmation": "not_required", "description": "更新指定 dashboard 的配置。调用前必须先调用 get_dashboard_config_example 了解 config 入参结构和要求。返回更新后的 dashboard 详情。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_dashboard" }, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_update", "primary_cli_path": "aitable dashboard update", "reviewed": false, "risk": "medium", "title": "更新仪表盘", "use_when": [ "更新指定 dashboard 的配置。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "导出数据（不传 --task-id 创建新任务并等待，传入 --task-id 继续等待）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“导出数据（不传 --task-id 创建新任务并等待，传入 --task-id 继续等待）”" ], "canonical_path": "aitable.export_data", "cli_name": "data", "cli_path": "aitable export data", "confirmation": "not_required", "description": "导出 AI 表格数据的统一入口。\r\n不传 taskId 时，会根据 scope / format 创建一个新的导出任务，并在 timeoutMs 时间内同步等待结果；若在等待窗口内完成，则直接返回 downloadUrl 和 fileName。\r\n传入 taskId 时，不会重新创建任务，而是继续等待该任务；若仍未完成，则继续返回同一个 taskId，供下一次调用继续等待。\r\n当前稳定支持的 scope：all、table、view；暂不开放按字段导出。\r\n当前稳定支持的 format：excel、attachment、excel_and_attachment、excel_with_inline_images。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "export_data" }, "metadata_source": "embedded-mcp-metadata", "name": "export_data", "primary_cli_path": "aitable export data", "risk": "low", "title": "导出数据", "use_when": [ "第一步：创建任务（按 scope 传必要参数）", "第一步：创建任务（按 scope 传必要参数）——注意：不要加 --format json！", "第二步：拿 taskId 继续轮询，直到返回 downloadUrl", "续等导出：拿到 downloadUrl 后再 curl 下载（见下方警告）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在已有表格中批量新增字段。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除字段（不可逆，禁止删除主字段与最后一个字段）”请改用 dws aitable field delete", "要“批量获取字段详细信息（含完整配置）”请改用 dws aitable field get", "要“批量获取指定字段的详细信息，包括 fieldId、名称、类型、d”请改用 dws aitable field list" ], "canonical_path": "aitable.field_create", "cli_name": "create", "cli_path": "aitable field create", "confirmation": "not_required", "description": "在已有表格中批量新增字段。适用于建表后补充一批字段，或一次性添加多个关联、流转等复杂类型字段。单次最多创建 15 个字段；若超过该数量，请拆分多次调用。允许部分成功，返回结果会逐项说明每个字段是否创建成功；失败项会返回 reason 说明失败原因。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_fields" }, "metadata_source": "embedded-mcp-metadata", "name": "field_create", "primary_cli_path": "aitable field create", "reviewed": false, "risk": "medium", "title": "create_fields", "use_when": [ "字段/列/column；添加", "或者使用批量创建模式:" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除字段（不可逆，禁止删除主字段与最后一个字段）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“在已有表格中批量新增字段”请改用 dws aitable field create", "要“批量获取字段详细信息（含完整配置）”请改用 dws aitable field get", "要“批量获取指定字段的详细信息，包括 fieldId、名称、类型、d”请改用 dws aitable field list" ], "canonical_path": "aitable.field_delete", "cli_name": "delete", "cli_path": "aitable field delete", "confirmation": "user_required", "description": "删除指定 Table 中的一个字段（Field），删除操作不可逆。禁止删除主字段，且禁止删除最后一个字段\r\n\r\n此操作不可逆，会永久删除字段及其所有数据。\r\n必须提供准确的 baseId、tableId 和 fieldId，不得使用名称代替 ID。\r\n若字段不存在或无权限，将返回错误。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_field" }, "metadata_source": "embedded-mcp-metadata", "name": "field_delete", "primary_cli_path": "aitable field delete", "risk": "high", "title": "删除字段", "use_when": [ "字段/列/column；删除" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量获取字段详细信息（含完整配置）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除字段（不可逆，禁止删除主字段与最后一个字段）”请改用 dws aitable field delete", "要“在已有表格中批量新增字段”请改用 dws aitable field create", "要“批量获取指定字段的详细信息，包括 fieldId、名称、类型、d”请改用 dws aitable field list" ], "canonical_path": "aitable.field_get", "cli_name": "get", "cli_path": "aitable field get", "confirmation": "not_required", "description": "批量获取指定字段的详细信息，包括 fieldId、名称、类型、description 以及类型相关完整配置（如格式化、选项、AI 配置等）。\r\n传 fieldIds 时单次最多获取 10 个字段；若需更多字段，请拆分多次调用。\r\n适用于在 get_tables 拿到字段目录后，按需展开少量字段的完整配置，避免大 options 字段放大 get_tables 返回值。\r\nAI 字段的返回结果中，config 仅包含字段物理配置，aiConfig 作为同级字段单独返回，结构与 create_fields 写入参数一致。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_fields" }, "metadata_source": "embedded-mcp-metadata", "name": "field_get", "primary_cli_path": "aitable field get", "risk": "low", "title": "获取字段详情", "use_when": [ "字段/列/column；查看" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量获取指定字段的详细信息，包括 fieldId、名称、类型、description 以及类型相关完整配置（如格式化、选项、AI 配置等）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除字段（不可逆，禁止删除主字段与最后一个字段）”请改用 dws aitable field delete", "要“在已有表格中批量新增字段”请改用 dws aitable field create", "要“批量获取字段详细信息（含完整配置）”请改用 dws aitable field get" ], "canonical_path": "aitable.field_list", "cli_name": "list", "cli_path": "aitable field list", "confirmation": "not_required", "description": "批量获取指定字段的详细信息，包括 fieldId、名称、类型、description 以及类型相关完整配置（如格式化、选项、AI 配置等）。\r\n传 fieldIds 时单次最多获取 10 个字段；若需更多字段，请拆分多次调用。\r\n适用于在 get_tables 拿到字段目录后，按需展开少量字段的完整配置，避免大 options 字段放大 get_tables 返回值。\r\nAI 字段的返回结果中，config 仅包含字段物理配置，aiConfig 作为同级字段单独返回，结构与 create_fields 写入参数一致。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_fields" }, "metadata_source": "embedded-mcp-metadata", "name": "field_list", "primary_cli_path": "aitable field list", "reviewed": false, "risk": "low", "title": "获取字段详情", "use_when": [ "批量获取指定字段的详细信息，包括 fieldId、名称、类型、description 以及类型相关完整配置（如格式化、选项、AI 配置等）。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "搜索指定单选/多选字段的 options 列表，支持按关键词模糊匹配（大小写不敏感、contains 模式）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除字段（不可逆，禁止删除主字段与最后一个字段）”请改用 dws aitable field delete", "要“在已有表格中批量新增字段”请改用 dws aitable field create", "要“批量获取字段详细信息（含完整配置）”请改用 dws aitable field get" ], "canonical_path": "aitable.field_search_options", "cli_name": "search-options", "cli_path": "aitable field search-options", "confirmation": "not_required", "description": "搜索指定单选/多选字段的 options 列表，支持按关键词模糊匹配（大小写不敏感、contains 模式）。\r\n目标字段必须是 singleSelect 或 multipleSelect 类型，否则返回错误。\r\n不传 keyword 时返回该字段全部 options。\r\n适用于 options 较多时按关键词缩小范围，避免通过 get_fields 拉取完整字段配置。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "search_field_options" }, "metadata_source": "embedded-mcp-metadata", "name": "field_search_options", "primary_cli_path": "aitable field search-options", "reviewed": false, "risk": "low", "title": "搜索字段选项", "use_when": [ "搜索指定单选/多选字段的 options 列表，支持按关键词模糊匹配（大小写不敏感、contains 模式）。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新字段名称 / 配置 / AI 配置（至少传一项）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除字段（不可逆，禁止删除主字段与最后一个字段）”请改用 dws aitable field delete", "要“在已有表格中批量新增字段”请改用 dws aitable field create", "要“批量获取字段详细信息（含完整配置）”请改用 dws aitable field get" ], "canonical_path": "aitable.field_update", "cli_name": "update", "cli_path": "aitable field update", "confirmation": "not_required", "description": "更新指定字段的名称或配置。不可变更字段类型（type 不可修改）。\r\nnewFieldName、config、aiConfig 至少传入一项", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_field" }, "metadata_source": "embedded-mcp-metadata", "name": "field_update", "primary_cli_path": "aitable field update", "risk": "medium", "title": "更新字段", "use_when": [ "字段/列/column；修改" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在指定数据表下创建一个新的表单视图（FormDesigner 类型）", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要在指定数据表下创建一个新的表单视图（FormDesigner 类型）时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_create", "cli_name": "create", "cli_path": "aitable form create", "confirmation": "not_required", "description": "在指定数据表下创建一个新的表单视图（FormDesigner 类型）。\n等价于 view create --view-type FormDesigner，但走 form 命令组对齐表单工作流。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "form_create", "primary_cli_path": "aitable form create", "reviewed": false, "risk": "medium", "title": "创建表单视图", "use_when": [ "1) 创建表单 → 取返回的 data.viewId 作为 VIEW_ID" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除指定数据表下的表单视图（不可逆）", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要删除指定数据表下的表单视图（不可逆）时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_delete", "cli_name": "delete", "cli_path": "aitable form delete", "confirmation": "user_required", "description": "删除指定数据表下的表单视图（不可逆）。\n调用前建议先通过 form list 确认目标视图。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "form_delete", "primary_cli_path": "aitable form delete", "reviewed": false, "risk": "high", "title": "删除表单", "use_when": [ "删除指定数据表下的表单视图（不可逆）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "切换表单视图中某个字段的隐藏/显示状态", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要切换表单视图中某个字段的隐藏/显示状态时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_field_hide", "cli_name": "hide", "cli_path": "aitable form field hide", "confirmation": "not_required", "description": "切换表单视图中某个字段的隐藏/显示状态。\n--hidden true：在表单中隐藏该字段（填写者不可见）\n--hidden false：显示该字段", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "form_field_hide", "primary_cli_path": "aitable form field hide", "reviewed": false, "risk": "low", "title": "切换表单字段隐藏", "use_when": [ "5) 隐藏不需要的题目" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出指定表单视图当前可见的字段及其配置", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要列出指定表单视图当前可见的字段及其配置时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_field_list", "cli_name": "list", "cli_path": "aitable form field list", "confirmation": "not_required", "description": "列出指定表单视图当前可见的字段及其配置。\n返回每个字段的 fieldId、name、type、required、hidden、description。\n注意：hidden=true 的字段不会出现在此返回（它们在表单中已隐藏）；如需查看全部字段请用 field get。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "form_field_list", "primary_cli_path": "aitable form field list", "reviewed": false, "risk": "low", "title": "列出表单字段", "use_when": [ "3) 查看表单字段配置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新表单视图中某个字段的必填状态或描述", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要更新表单视图中某个字段的必填状态或描述时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_field_update", "cli_name": "update", "cli_path": "aitable form field update", "confirmation": "not_required", "description": "更新表单视图中某个字段的必填状态或描述。\n--required 或 --field-description 至少传入一项。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "form_field_update", "primary_cli_path": "aitable form field update", "reviewed": false, "risk": "medium", "title": "更新表单字段", "use_when": [ "4) 设置题目必填（FIELD_ID 来自步骤 2）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "按 viewId 获取单个表单视图的元信息（name/title/createdAt/shareFormUuid）", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要按 viewId 获取单个表单视图的元信息（name/title/createdAt/shareFormUuid）时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_get", "cli_name": "get", "cli_path": "aitable form get", "confirmation": "not_required", "description": "按 viewId 获取单个表单视图的元信息（name/title/createdAt/shareFormUuid）。\n内部拉取 list_form_views 后在客户端按 viewId 精确筛出单条（服务端的 viewIds\n过滤参数当前不生效，会返回全表所有表单，故在此侧过滤）。data 即命中的表单对象。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "form_get", "primary_cli_path": "aitable form get", "reviewed": false, "risk": "low", "title": "获取单个表单视图详情", "use_when": [ "2) 查看单个表单详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出指定数据表下的所有表单视图", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要列出指定数据表下的所有表单视图时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_list", "cli_name": "list", "cli_path": "aitable form list", "confirmation": "not_required", "description": "列出指定数据表下的所有表单视图。每个表单视图返回 viewId、name、title、createdAt（shareFormUuid 不在此返回，需 form share get 单独获取）。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "form_list", "primary_cli_path": "aitable form list", "reviewed": false, "risk": "low", "title": "列出表单视图", "use_when": [ "1) 列出数据表下的表单视图" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在数据表中创建字段，即向表单添加题目", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要在数据表中创建字段，即向表单添加题目时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_questions_create", "cli_name": "create", "cli_path": "aitable form questions create", "confirmation": "not_required", "description": "在数据表中创建字段，即向表单添加题目。\n入参与 `field create` 完全一致：可用 --fields 批量创建，或 --name + --type 单题模式。\n若需将题目设为必填，创建后请用 form field update --required true 单独设置。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "form_questions_create", "primary_cli_path": "aitable form questions create", "reviewed": false, "risk": "medium", "title": "向表单添加题目（等价于 field create）", "use_when": [ "2) 添加题目 → 取返回的 data.results[].fieldId 作为 FIELD_ID" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除指定字段（即表单题目）", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要删除指定字段（即表单题目）时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_questions_delete", "cli_name": "delete", "cli_path": "aitable form questions delete", "confirmation": "user_required", "description": "删除指定字段（即表单题目）。**不可逆**。\n入参与 `field delete` 完全一致：必须传 --field-id；目前 MCP 不支持批量删除，需多次调用。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "form_questions_delete", "primary_cli_path": "aitable form questions delete", "reviewed": false, "risk": "high", "title": "从表单删除题目（等价于 field delete，不可逆）", "use_when": [ "删除指定字段（即表单题目）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "读取指定视图当前的分享表单配置", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要读取指定视图当前的分享表单配置时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_share_get", "cli_name": "get", "cli_path": "aitable form share get", "confirmation": "not_required", "description": "读取指定视图当前的分享表单配置。\n返回 enabled（是否开启）、status、shareFormUuid、formName 等信息。\n若该视图尚未开启分享表单，enabled=false、status=0。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "form_share_get", "primary_cli_path": "aitable form share get", "reviewed": false, "risk": "low", "title": "获取表单分享配置", "use_when": [ "4) 查看分享配置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "开启或关闭指定视图的分享表单", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要开启或关闭指定视图的分享表单时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_share_update", "cli_name": "update", "cli_path": "aitable form share update", "confirmation": "not_required", "description": "开启或关闭指定视图的分享表单。\n--enabled true 表示开启分享，--enabled false 表示关闭分享。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "form_share_update", "primary_cli_path": "aitable form share update", "reviewed": false, "risk": "medium", "title": "开启/关闭分享表单", "use_when": [ "6) 开启分享（注意：开启后需 UI 刷新页面才会看到分享面板）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新表单整体配置（标题、描述）", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要更新表单整体配置（标题、描述）时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_update", "cli_name": "update", "cli_path": "aitable form update", "confirmation": "not_required", "description": "更新表单整体配置（标题、描述）。\n--title（或其等价别名 --name）和 --description 至少传入一项。\n--title 与 --name 完全等价；同时传入时以 --title 优先。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "form_update", "primary_cli_path": "aitable form update", "reviewed": false, "risk": "medium", "title": "更新表单配置", "use_when": [ "3) 配置表单标题与描述" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "触发导入并等待结果；每个 Sheet 新建为独立表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“申请导入文件 OSS 直传地址，返回 uploadUrl 与 i”请改用 dws aitable import upload" ], "canonical_path": "aitable.import_data", "cli_name": "data", "cli_path": "aitable import data", "confirmation": "not_required", "description": "将已通过 prepare_import_upload 上传完成的文件导入 AI 表格。支持两种模式：\r\n1. 新建表导入（默认）：不传 tableId，文件中的每个工作表新建为独立的数据表。导入成功时返回新增数据表的 tableIds。\r\n2. 追加导入：传入 tableId，数据追加到该已有数据表的末尾，不会新建表。可通过 fieldMapping 指定文件列名与目标表字段的映射关系；不传 fieldMapping 则按列名自动匹配。多 Sheet 文件可通过 srcSheetName 指定源 Sheet。\r\n工具内部会等待导入完成，大多数情况下一次调用即可拿到最终结果。若在 timeout 内未完成，再次传入相同 importId 继续等待，无需重新提交任务，也不要重新上传同一文件。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "import_data" }, "metadata_source": "embedded-mcp-metadata", "name": "import_data", "primary_cli_path": "aitable import data", "risk": "medium", "title": "导入数据", "use_when": [ "第 3 步（替代）：追加到已有表", "第 3 步：触发导入（新建表模式）", "续等导入" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "申请导入文件 OSS 直传地址，返回 uploadUrl 与 importId", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“触发导入并等待结果；每个 Sheet 新建为独立表”请改用 dws aitable import data" ], "canonical_path": "aitable.import_upload", "cli_name": "upload", "cli_path": "aitable import upload", "confirmation": "not_required", "description": "为导入任务申请 OSS 直传地址。返回 uploadUrl 和 importId。\r\n客户端应通过 HTTP PUT 将原始文件字节流上传至 uploadUrl；除非 uploadUrl 对应的存储服务明确要求，否则不要额外附带 Content-Type 等自定义请求头。上传完成后将 importId 传入 import_data 即可触发导入，无需再传其他参数。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "prepare_import_upload" }, "metadata_source": "embedded-mcp-metadata", "name": "import_upload", "primary_cli_path": "aitable import upload", "risk": "medium", "title": "准备导入文件上传", "use_when": [ "第 1 步：申请上传凭证" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取指定 Base 的资源目录级信息，返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定 Base 的资源目录级信息，返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。”" ], "canonical_path": "aitable.info", "cli_name": "info", "cli_path": "aitable info", "confirmation": "not_required", "description": "获取指定 Base 的资源目录级信息，返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。\r\n这是当前 Base 级目录入口：后续如需 tableId 或 dashboardId，优先从这里读取；table 详情再调用 get_tables，dashboard 详情再调用 get_dashboard", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_base" }, "metadata_source": "embedded-mcp-metadata", "name": "info", "primary_cli_path": "aitable info", "reviewed": false, "risk": "low", "title": "获取 AI 表格信息", "use_when": [ "获取指定 Base 的资源目录级信息，返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出当前用户可访问的 AI 表格 Base。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出当前用户可访问的 AI 表格 Base。”" ], "canonical_path": "aitable.list", "cli_name": "list", "cli_path": "aitable list", "confirmation": "not_required", "description": "列出当前用户可访问的 AI 表格 Base。默认返回最近访问结果，支持分页游标续取。返回 baseId 与 baseName，后续可直接用于 get_base。\r\nAI 表格访问地址可按 baseId 拼接为：https://docs.dingtalk.com/i/nodes/{baseId}", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "list_bases" }, "metadata_source": "embedded-mcp-metadata", "name": "list", "primary_cli_path": "aitable list", "reviewed": false, "risk": "low", "title": "获取 AI 表格列表", "use_when": [ "列出当前用户可访问的 AI 表格 Base。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询记录（支持按 ID 取或 filters/sort/分页遍历）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "aitable record list" ], "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询指定表格中的记录，支持两种模式： 按 ID 取：传入 rec”请改用 dws aitable record get" ], "canonical_path": "aitable.query_records", "cli_name": "query", "cli_path": "aitable record query", "confirmation": "not_required", "description": "查询 AI 表格记录。默认返回单页；传 --all 时自动翻页累计全部记录。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "query_records" }, "metadata_source": "embedded-mcp-metadata", "name": "query_records", "primary_cli_path": "aitable record query", "risk": "low", "title": "query_records", "use_when": [ "4. 查询记录", "从上次断点继续", "关键词搜索", "按 ID 查询", "无限制（拉完为止）", "游标分页", "示例：基础条件查询模板（可改内部 operator 为 contain 等）", "记录/行/数据/row；查看/搜索", "默认（最多 50 页 = 5000 条）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将同一份 cells JSON 批量应用到多条记录上", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要将同一份 cells JSON 批量应用到多条记录上时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.record_batch_update", "cli_name": "batch-update", "cli_path": "aitable record batch-update", "confirmation": "not_required", "description": "将同一份 cells JSON 批量应用到多条记录上。适合\"统一标记完成 / 统一改负责人 / 统一清空某字段\"等场景。\n\n与 record update 的区别：\n - record update 每条记录可有不同 cells，参数是 records JSON 数组\n - record batch-update 所有记录共享同一份 cells（CLI 客户端展开后调用相同 MCP 工具）\n\n单次最多 100 条；超出请拆分多次调用。\ncells 写入格式与 record update / record create 相同（详见 record create --help）。\n只读字段（formula / filterUp / lookup / 系统字段）不能写入。\n\nCLI 行为：客户端把 --record-ids 拆开后构造 [{recordId, cells}, ...] 调用 update_records；\n当前服务端尚未提供 broadcast patch 工具，所以本命令是纯语义包装，不省网络体积，仅省 LLM 构造 prompt 的 token。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "record_batch_update", "primary_cli_path": "aitable record batch-update", "reviewed": false, "risk": "medium", "title": "批量更新记录（同一 cells 应用到多条 recordId）", "use_when": [ "将同一份 cells JSON 批量应用到多条记录上" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量新增记录（单次最多 100 条）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“查询指定表格中的记录，支持两种模式： 按 ID 取：传入 rec”请改用 dws aitable record get", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_create", "cli_name": "create", "cli_path": "aitable record create", "confirmation": "not_required", "description": "在指定表格中批量新增记录", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_records" }, "metadata_source": "embedded-mcp-metadata", "name": "record_create", "primary_cli_path": "aitable record create", "risk": "medium", "title": "新增记录", "use_when": [ "5. 新增记录 (cells 用 fieldId 作 key)", "再用 fieldId 写入记录", "单条", "多条", "步骤 2: 在 record create/update 中使用 fileToken 写入", "步骤 2: 在 record create/update 中使用 fileToken 写入附件字段", "记录/行/数据/row；添加/写入" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量删除记录（不可逆，单次最多 100 条）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询指定表格中的记录，支持两种模式： 按 ID 取：传入 rec”请改用 dws aitable record get", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_delete", "cli_name": "delete", "cli_path": "aitable record delete", "confirmation": "user_required", "description": "在指定 Table 中批量删除记录（不可逆，数据将永久丢失）。\r\n单次最多删除 100 条；超出请拆分多次调用。\r\n调用前建议先通过 query_records 确认目标记录 ID 与内容，避免误删。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_records" }, "metadata_source": "embedded-mcp-metadata", "name": "record_delete", "primary_cli_path": "aitable record delete", "risk": "high", "title": "删除行记录", "use_when": [ "记录/行/数据/row；删除" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询指定表格中的记录，支持两种模式： 按 ID 取：传入 recordIds（单次最多 100 个），直接获取指定记录。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_get", "cli_name": "get", "cli_path": "aitable record get", "confirmation": "not_required", "description": "查询指定表格中的记录，支持两种模式：\r\n- 按 ID 取：传入 recordIds（单次最多 100 个），直接获取指定记录。\r\n- 条件查：通过 filters 过滤、sort 排序、cursor 分页遍历全表。\r\n两种模式均可通过 fieldIds（单次最多 100 个）限制返回字段以节省 token。\r\n如果需要获取计算、查找引用等字段则必须传fieldIds的列ID或者列名称才会返回", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "query_records" }, "metadata_source": "embedded-mcp-metadata", "name": "record_get", "primary_cli_path": "aitable record get", "reviewed": false, "risk": "low", "title": "query_records", "use_when": [ "记录/行/数据/row；已知 recordId 反查字段值" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询指定行记录的变更历史列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_history_list", "cli_name": "history-list", "cli_path": "aitable record history-list", "confirmation": "not_required", "description": "查询指定行记录的变更历史列表。返回该记录的字段变更、操作人（unionId）、操作时间等信息。\r\n操作人已完成身份脱敏，仅透出 unionId。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "query_record_history" }, "metadata_source": "embedded-mcp-metadata", "name": "record_history_list", "primary_cli_path": "aitable record history-list", "reviewed": false, "risk": "low", "title": "查询行记录变更历史", "use_when": [ "第 1 页（最新 20 条）", "第 2 页" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "为指定记录创建主键文档（幂等：若该记录已有主键文档则直接返回已有文档的 nodeId）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_primary_doc_create", "cli_name": "primary-doc-create", "cli_path": "aitable record primary-doc-create", "confirmation": "not_required", "description": "为指定记录创建主键文档（幂等：若该记录已有主键文档则直接返回已有文档的 nodeId）。\\n必填 baseId、tableId、fieldId、recordId。\\n返回创建或已存在的主键文档 nodeId，可直接用于钉钉文档 MCP 的 nodeId 参数。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "create_primary_doc" }, "metadata_source": "embedded-mcp-metadata", "name": "record_primary_doc_create", "primary_cli_path": "aitable record primary-doc-create", "reviewed": false, "risk": "medium", "title": "创建主键文档", "use_when": [ "2. 为某条记录创建主键文档" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询指定记录的主键文档信息。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_primary_doc_get", "cli_name": "primary-doc-get", "cli_path": "aitable record primary-doc-get", "confirmation": "not_required", "description": "查询指定记录的主键文档信息。根据 baseId、tableId、recordId 返回该记录关联的主键文档 nodeId。若记录尚未创建主键文档，nodeId 为 null。返回的 nodeId 可直接用于钉钉文档 MCP 的 nodeId 参数。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_primary_doc" }, "metadata_source": "embedded-mcp-metadata", "name": "record_primary_doc_get", "primary_cli_path": "aitable record primary-doc-get", "reviewed": false, "risk": "low", "title": "查询主键文档信息", "use_when": [ "查询指定记录的主键文档信息。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询指定表格中\"完全没填用户字段\"的空行。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_query_empty", "cli_name": "query-empty", "cli_path": "aitable record query-empty", "confirmation": "not_required", "description": "查询指定表格中\"完全没填用户字段\"的空行。\r\n- 按表内顺序扫描一页（limit 默认 100，最大 100），内存中过滤出空行返回。\r\n- 空行定义：除系统字段（recordId / 创建人 / 创建时间 / 修改人 / 修改时间）外，\r\n 所有 cell 都是 null、空字符串、空集合或空 Map。\r\n- cursor 行为同 query_records：若返回的 nextCursor 非空，需要把它传回继续翻页。\r\n- 注意：本页 records 为空数组不代表全表无空行；只有当 nextCursor 也为空时才表示扫完全表。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "query_empty_records" }, "metadata_source": "embedded-mcp-metadata", "name": "record_query_empty", "primary_cli_path": "aitable record query-empty", "reviewed": false, "risk": "low", "title": "查询空行", "use_when": [ "查询指定表格中\"完全没填用户字段\"的空行。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取指定行记录的分享链接，可用于将记录分享给他人。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_share_url", "cli_name": "share-url", "cli_path": "aitable record share-url", "confirmation": "not_required", "description": "获取指定行记录的分享链接，可用于将记录分享给他人。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_record_share_url" }, "metadata_source": "embedded-mcp-metadata", "name": "record_share_url", "primary_cli_path": "aitable record share-url", "reviewed": false, "risk": "low", "title": "get_record_share_url", "use_when": [ "一次拿一条记录的链接", "带视图上下文（链接打开时落在指定视图）", "批量拿，配合 jq 过滤出 url" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量更新记录（单次最多 100 条）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_update", "cli_name": "update", "cli_path": "aitable record update", "confirmation": "not_required", "description": "批量更新指定记录的字段值，只需传入需修改的字段，未传入的字段保持原值", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_records" }, "metadata_source": "embedded-mcp-metadata", "name": "record_update", "primary_cli_path": "aitable record update", "risk": "medium", "title": "更新记录", "use_when": [ "3. 写入记录", "记录/行/数据/row；修改/更新" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量创建或更新记录（Upsert 语义）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_upsert", "cli_name": "upsert", "cli_path": "aitable record upsert", "confirmation": "not_required", "description": "批量创建或更新记录（Upsert 语义）。传入一批记录，带 recordId 的走更新逻辑，不带 recordId 的走创建逻辑，服务端自动拆分并分别执行。\r\n单次请求的记录总数（创建 + 更新）不得超过 100 条。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "record_upsert" }, "metadata_source": "embedded-mcp-metadata", "name": "record_upsert", "primary_cli_path": "aitable record upsert", "reviewed": false, "risk": "medium", "title": "record_upsert", "use_when": [ "1) 全部新建：所有项都不带 recordId", "2) 全部更新：所有项都带 recordId", "3) 混合：第 1 条更新（带 recordId），第 2 条创建（不带）", "4) 长 JSON 用文件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "按名称关键词搜索 AI 表格 Base。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“按名称关键词搜索 AI 表格 Base。”" ], "canonical_path": "aitable.search", "cli_name": "search", "cli_path": "aitable search", "confirmation": "not_required", "description": "按名称关键词搜索 AI 表格 Base。返回 baseId/baseName，结果按相关性排序。返回的 baseId 可直接用于 get_base 等后续工具。\r\nAI 表格访问地址可按 baseId 拼接为：https://docs.dingtalk.com/i/nodes/{baseId}", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "search_bases" }, "metadata_source": "embedded-mcp-metadata", "name": "search", "primary_cli_path": "aitable search", "reviewed": false, "risk": "low", "title": "搜索 AI 表格", "use_when": [ "按名称关键词搜索 AI 表格 Base。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在指定 Base 下创建分区(用于在导航树中组织 table / dashboard,类似文件夹)。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于”请改用 dws aitable section list-empty", "要“列出指定 Base 当前版本下的全部 nsheet 节点,包括分”请改用 dws aitable section list-nodes", "要“删除指定分区”请改用 dws aitable section delete" ], "canonical_path": "aitable.section_create", "cli_name": "create", "cli_path": "aitable section create", "confirmation": "not_required", "description": "在指定 Base 下创建分区(用于在导航树中组织 table / dashboard,类似文件夹)。\r\n\r\n必填:\r\n- baseId\r\n- name\r\n\r\n可选:\r\n- parentSectionId:不传或空字符串表示创建在 Base 根目录下\r\n- index:0-based,不传则追加到末尾\r\n\r\n返回新建分区的 sectionId 与 name。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "create_section" }, "metadata_source": "embedded-mcp-metadata", "name": "section_create", "primary_cli_path": "aitable section create", "reviewed": false, "risk": "medium", "title": "创建分组", "use_when": [ "在指定 Base 下创建分区(用于在导航树中组织 table / dashboard,类似文件夹)。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除指定分区。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于”请改用 dws aitable section list-empty", "要“列出指定 Base 当前版本下的全部 nsheet 节点,包括分”请改用 dws aitable section list-nodes", "要“在指定 Base 下创建分区(用于在导航树中组织 table /”请改用 dws aitable section create" ], "canonical_path": "aitable.section_delete", "cli_name": "delete", "cli_path": "aitable section delete", "confirmation": "user_required", "description": "删除指定分区。\r\n\r\n必填 baseId、sectionId。\r\n\r\n注意删除操作不可逆;若分区下仍有 table / dashboard,下游会按既有规则处理。\r\n\r\n返回被删除的 sectionId。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "delete_section" }, "metadata_source": "embedded-mcp-metadata", "name": "section_delete", "primary_cli_path": "aitable section delete", "reviewed": false, "risk": "high", "title": "删除分组", "use_when": [ "删除指定分区。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于清理或诊断导航树。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 当前版本下的全部 nsheet 节点,包括分”请改用 dws aitable section list-nodes", "要“删除指定分区”请改用 dws aitable section delete", "要“在指定 Base 下创建分区(用于在导航树中组织 table /”请改用 dws aitable section create" ], "canonical_path": "aitable.section_list_empty", "cli_name": "list-empty", "cli_path": "aitable section list-empty", "confirmation": "not_required", "description": "列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于清理或诊断导航树。\r\n\r\n必填 baseId。\r\n\r\n返回按 name 升序排列的 [{sectionId, name, parentSectionId}] 列表与总数;parentSectionId 为空串表示该分区在 Base 根目录下。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "list_empty_sections" }, "metadata_source": "embedded-mcp-metadata", "name": "section_list_empty", "primary_cli_path": "aitable section list-empty", "reviewed": false, "risk": "low", "title": "查询空分组", "use_when": [ "列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于清理或诊断导航树。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出指定 Base 当前版本下的全部 nsheet 节点,包括分区、AI 表格、表单视图、仪表盘、文档、查询视图等。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于”请改用 dws aitable section list-empty", "要“删除指定分区”请改用 dws aitable section delete", "要“在指定 Base 下创建分区(用于在导航树中组织 table /”请改用 dws aitable section create" ], "canonical_path": "aitable.section_list_nodes", "cli_name": "list-nodes", "cli_path": "aitable section list-nodes", "confirmation": "not_required", "description": "列出指定 Base 当前版本下的全部 nsheet 节点,包括分区、AI 表格、表单视图、仪表盘、文档、查询视图等。\r\n\r\n必填 baseId。\r\n\r\n返回按 name 升序排列的 [{nodeId, nodeType, parentSectionId, name}] 列表与总数;parentSectionId 为空串表示该节点在 Base 根目录下。\r\n\r\n适合在 move_nsheet_node、reorder_section 等操作前用来定位节点 ID 与父级关系。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "list_nsheet_nodes" }, "metadata_source": "embedded-mcp-metadata", "name": "section_list_nodes", "primary_cli_path": "aitable section list-nodes", "reviewed": false, "risk": "low", "title": "查询AI表格节点", "use_when": [ "列出指定 Base 当前版本下的全部 nsheet 节点,包括分区、AI 表格、表单视图、仪表盘、文档、查询视图等。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "把任意 nsheet 节点(分区 / 多维表 / 表单视图 / 仪表盘 / 文档 / 查询视图)移动到目标分区下,可选同时调整全局位置。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于”请改用 dws aitable section list-empty", "要“删除指定分区”请改用 dws aitable section delete", "要“在指定 Base 下创建分区(用于在导航树中组织 table /”请改用 dws aitable section create" ], "canonical_path": "aitable.section_move_node", "cli_name": "move-node", "cli_path": "aitable section move-node", "confirmation": "not_required", "description": "把任意 nsheet 节点(分区 / 多维表 / 表单视图 / 仪表盘 / 文档 / 查询视图)移动到目标分区下,可选同时调整全局位置。\r\n\r\n必填:\r\n- baseId\r\n- nodeId\r\n- newParentSectionId:传空字符串表示移动到 Base 根目录\r\n\r\n可选:\r\n- targetIndex:0-based 全局下标;对分区节点会先 move 再调 reorder,中间步骤失败时会返回 MOVE_OK_REORDER_FAILED,可用 reorder_section 重试\r\n\r\n服务端会自动识别节点类型,调用方无需区分分区与非分区。\r\n\r\n返回被移动节点的 id、type、目标父级与下标。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "move_nsheet_node" }, "metadata_source": "embedded-mcp-metadata", "name": "section_move_node", "primary_cli_path": "aitable section move-node", "reviewed": false, "risk": "medium", "title": "移动AI表格节点", "use_when": [ "把任意 nsheet 节点(分区 / 多维表 / 表单视图 / 仪表盘 / 文档 / 查询视图)移动到目标分区下,可选同时调整全局位置。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "重命名指定分区。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于”请改用 dws aitable section list-empty", "要“删除指定分区”请改用 dws aitable section delete", "要“在指定 Base 下创建分区(用于在导航树中组织 table /”请改用 dws aitable section create" ], "canonical_path": "aitable.section_rename", "cli_name": "rename", "cli_path": "aitable section rename", "confirmation": "not_required", "description": "重命名指定分区。\r\n\r\n必填 baseId、sectionId、newName。\r\n\r\n返回重命名后的 sectionId 与新的 name。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "rename_section" }, "metadata_source": "embedded-mcp-metadata", "name": "section_rename", "primary_cli_path": "aitable section rename", "reviewed": false, "risk": "medium", "title": "重命名分组", "use_when": [ "重命名指定分区。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在当前父分区下调整分区的展示顺序。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于”请改用 dws aitable section list-empty", "要“删除指定分区”请改用 dws aitable section delete", "要“在指定 Base 下创建分区(用于在导航树中组织 table /”请改用 dws aitable section create" ], "canonical_path": "aitable.section_reorder", "cli_name": "reorder", "cli_path": "aitable section reorder", "confirmation": "not_required", "description": "在当前父分区下调整分区的展示顺序。\r\n\r\n必填 baseId、sectionId、targetIndex(0-based)。\r\n\r\n返回被调整的 sectionId。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "reorder_section" }, "metadata_source": "embedded-mcp-metadata", "name": "section_reorder", "primary_cli_path": "aitable section reorder", "reviewed": false, "risk": "medium", "title": "调整分组顺序", "use_when": [ "在当前父分区下调整分区的展示顺序。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建数据表并附带初始字段（最多 15 个）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除数据表（不可逆，高风险）”请改用 dws aitable table delete", "要“批量获取指定 Tables（数据表）的表级信息、字段目录与视图目”请改用 dws aitable table list", "要“批量获取数据表目录与字段、视图 summary”请改用 dws aitable table get" ], "canonical_path": "aitable.table_create", "cli_name": "create", "cli_path": "aitable table create", "confirmation": "not_required", "description": "在指定 Base 中新建表格，并可在创建时附带初始化一批基础字段。\r\n建表时单次最多附带 15 个字段；若 fields 为空，服务会自动补一个名为“标题”的 primaryDoc 首列。\r\n若 tableName 与当前 Base 下已有表重名，服务会自动续号为“原名 1 / 原名 2 ...”，并在 summary 中返回当前表名。\r\n如需添加更多字段，或在已有表中增加字段，请使用 create_fields。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_table" }, "metadata_source": "embedded-mcp-metadata", "name": "table_create", "primary_cli_path": "aitable table create", "risk": "medium", "title": "创建数据表", "use_when": [ "数据表/子表/table；创建" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除数据表（不可逆，高风险）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建数据表并附带初始字段（最多 15 个）”请改用 dws aitable table create", "要“批量获取指定 Tables（数据表）的表级信息、字段目录与视图目”请改用 dws aitable table list", "要“批量获取数据表目录与字段、视图 summary”请改用 dws aitable table get" ], "canonical_path": "aitable.table_delete", "cli_name": "delete", "cli_path": "aitable table delete", "confirmation": "user_required", "description": "删除指定 tableId 的数据表（不可逆，数据将永久丢失），该操作为高风险写入。\r\n调用前请先通过 get_base / get_tables 确认目标表 ID 与名称。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_table" }, "metadata_source": "embedded-mcp-metadata", "name": "table_delete", "primary_cli_path": "aitable table delete", "risk": "high", "title": "删除数据表", "use_when": [ "数据表/子表/table；删除" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量获取数据表目录与字段、视图 summary", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建数据表并附带初始字段（最多 15 个）”请改用 dws aitable table create", "要“删除数据表（不可逆，高风险）”请改用 dws aitable table delete", "要“批量获取指定 Tables（数据表）的表级信息、字段目录与视图目”请改用 dws aitable table list" ], "canonical_path": "aitable.table_get", "cli_name": "get", "cli_path": "aitable table get", "confirmation": "not_required", "description": "批量获取指定 Tables（数据表）的表级信息、字段目录与视图目录。\r\n会返回 tables 列表；每个 table 直接包含 tableId、tableName、description、fields、views；字段列表仅包含 fieldId、fieldName、type、description；views 仅包含 viewId、viewName、type。\r\n若需读取字段的完整配置，请再调用 get_fields。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_tables" }, "metadata_source": "embedded-mcp-metadata", "name": "table_get", "primary_cli_path": "aitable table get", "risk": "low", "title": "获取数据表", "use_when": [ "1. 查询表结构，拿到 primaryDoc 字段的 fieldId", "2. 拿目标 sheet 的 tableId", "3. 获取表结构 — 提取 fieldId", "先获取 fieldId", "数据表/子表/table；查看" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量获取指定 Tables（数据表）的表级信息、字段目录与视图目录。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建数据表并附带初始字段（最多 15 个）”请改用 dws aitable table create", "要“删除数据表（不可逆，高风险）”请改用 dws aitable table delete", "要“批量获取数据表目录与字段、视图 summary”请改用 dws aitable table get" ], "canonical_path": "aitable.table_list", "cli_name": "list", "cli_path": "aitable table list", "confirmation": "not_required", "description": "批量获取指定 Tables（数据表）的表级信息、字段目录与视图目录。\r\n会返回 tables 列表；每个 table 直接包含 tableId、tableName、description、fields、views；字段列表仅包含 fieldId、fieldName、type、description；views 仅包含 viewId、viewName、type。\r\n若需读取字段的完整配置，请再调用 get_fields。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_tables" }, "metadata_source": "embedded-mcp-metadata", "name": "table_list", "primary_cli_path": "aitable table list", "reviewed": false, "risk": "low", "title": "获取数据表", "use_when": [ "批量获取指定 Tables（数据表）的表级信息、字段目录与视图目录。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "重命名数据表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建数据表并附带初始字段（最多 15 个）”请改用 dws aitable table create", "要“删除数据表（不可逆，高风险）”请改用 dws aitable table delete", "要“批量获取数据表目录与字段、视图 summary”请改用 dws aitable table get" ], "canonical_path": "aitable.table_update", "cli_name": "update", "cli_path": "aitable table update", "confirmation": "not_required", "description": "重命名指定 Table（数据表）。若新名称不符合命名要求、与同一 Base 下其他表重名或无权限，将返回错误。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_table" }, "metadata_source": "embedded-mcp-metadata", "name": "table_update", "primary_cli_path": "aitable table update", "risk": "medium", "title": "update_table", "use_when": [ "数据表/子表/table；重命名", "用户说\"恢复成默认（记录）\" → 传 ji_lu", "用户说\"把这张表的行叫'任务'吧\" → 传 task", "用户说\"换成项目\" → 传 project" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "按关键词搜索 AI 表格模板（不传返回热门模板）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“按关键词搜索 AI 表格模板（不传返回热门模板）”" ], "canonical_path": "aitable.template_search", "cli_name": "search", "cli_path": "aitable template search", "confirmation": "not_required", "description": "按名称关键词搜索 AI 表格模板，支持分页。\r\n返回每个模板的 templateId、name、description，以及分页信息 hasMore / nextCursor。\r\n返回的 templateId 可直接用于 create_base。\r\n模板预览链接可通过 https://docs.dingtalk.com/table/template/{templateId} 拼接得到", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "search_templates" }, "metadata_source": "embedded-mcp-metadata", "name": "template_search", "primary_cli_path": "aitable template search", "risk": "low", "title": "搜索模板", "use_when": [ "模板" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建视图（Grid/FormDesigner/Gantt/Calendar/Kanban/Gallery）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除视图（不可逆；禁止删除最后一个视图或锁定视图）”请改用 dws aitable view delete", "要“复制指定视图(View),生成一个与源视图结构一致的新视图(包含”请改用 dws aitable view duplicate", "要“获取指定数据表（Table）中的视图（View）完整信息，包括列”请改用 dws aitable view list" ], "canonical_path": "aitable.view_create", "cli_name": "create", "cli_path": "aitable view create", "confirmation": "not_required", "description": "在指定数据表（Table）下创建一个新视图（View）。\r\n当前稳定支持的 viewType：Grid、FormDesigner、Gantt、Calendar、Kanban、Gallery。\r\n若未传 viewName，则会按视图类型自动生成不重名名称。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_create", "primary_cli_path": "aitable view create", "risk": "medium", "title": "创建视图", "use_when": [ "第 1 步：创建 Gantt 视图" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除视图（不可逆；禁止删除最后一个视图或锁定视图）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建视图（Grid/FormDesigner/Gantt/Cal”请改用 dws aitable view create", "要“复制指定视图(View),生成一个与源视图结构一致的新视图(包含”请改用 dws aitable view duplicate", "要“获取指定数据表（Table）中的视图（View）完整信息，包括列”请改用 dws aitable view list" ], "canonical_path": "aitable.view_delete", "cli_name": "delete", "cli_path": "aitable view delete", "confirmation": "user_required", "description": "删除指定视图（View）。该操作不可逆。\r\n已知保护：禁止删除数据表中的最后一个视图；锁定视图不允许删除。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_delete", "primary_cli_path": "aitable view delete", "risk": "high", "title": "删除视图", "use_when": [ "删除视图（不可逆；禁止删除最后一个视图或锁定视图）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "复制指定视图(View),生成一个与源视图结构一致的新视图(包含列顺序、筛选、排序、分组、自定义配置等)。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建视图（Grid/FormDesigner/Gantt/Cal”请改用 dws aitable view create", "要“删除视图（不可逆；禁止删除最后一个视图或锁定视图）”请改用 dws aitable view delete", "要“获取指定数据表（Table）中的视图（View）完整信息，包括列”请改用 dws aitable view list" ], "canonical_path": "aitable.view_duplicate", "cli_name": "duplicate", "cli_path": "aitable view duplicate", "confirmation": "not_required", "description": "复制指定视图(View),生成一个与源视图结构一致的新视图(包含列顺序、筛选、排序、分组、自定义配置等)。\r\n\r\n通过 baseId / tableId / sourceViewId 三元组定位源视图;未传 newViewName 时自动生成\"原视图名 (副本)\"风格的不重名名称。\r\n\r\n表单视图复制时会重置分享态,不会带过源视图的分享配置。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "duplicate_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_duplicate", "primary_cli_path": "aitable view duplicate", "reviewed": false, "risk": "medium", "title": "复制视图", "use_when": [ "显式命名", "系统自动命名（一般是 \"原视图名 (副本)\"）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询视图的聚合统计（汇总行）", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的条件填色规则”请改用 dws aitable view get fill-color-rule" ], "canonical_path": "aitable.view_get_aggregate", "cli_name": "aggregate", "cli_path": "aitable view get aggregate", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "metadata_source": "embedded-mcp-metadata", "name": "view_get_aggregate", "primary_cli_path": "aitable view get aggregate", "reviewed": true, "risk": "low", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询视图的卡片视图样式", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的条件填色规则”请改用 dws aitable view get fill-color-rule", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_card", "cli_name": "card", "cli_path": "aitable view get card", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "metadata_source": "embedded-mcp-metadata", "name": "view_get_card", "primary_cli_path": "aitable view get card", "reviewed": true, "risk": "low", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询视图的各列列宽", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的条件填色规则”请改用 dws aitable view get fill-color-rule", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_field_widths", "cli_name": "field-widths", "cli_path": "aitable view get field-widths", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "metadata_source": "embedded-mcp-metadata", "name": "view_get_field_widths", "primary_cli_path": "aitable view get field-widths", "reviewed": true, "risk": "low", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询视图的条件填色规则", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_fill_color_rule", "cli_name": "fill-color-rule", "cli_path": "aitable view get fill-color-rule", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "metadata_source": "embedded-mcp-metadata", "name": "view_get_fill_color_rule", "primary_cli_path": "aitable view get fill-color-rule", "reviewed": true, "risk": "low", "title": "get_views", "use_when": [ "3) 查询当前规则", "看实际生效的 conditionalFormats" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询视图的筛选条件", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_filter", "cli_name": "filter", "cli_path": "aitable view get filter", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "metadata_source": "embedded-mcp-metadata", "name": "view_get_filter", "primary_cli_path": "aitable view get filter", "reviewed": true, "risk": "low", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询指定视图(View)当前的冻结列数(左侧固定列)。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_frozen_cols", "cli_name": "frozen-cols", "cli_path": "aitable view get frozen-cols", "confirmation": "not_required", "description": "查询指定视图(View)当前的冻结列数(左侧固定列)。\r\n\r\n通过 baseId / tableId / viewId 三元组定位目标视图。\r\n\r\n视图未显式设置时返回 null(前端实际显示会回落到默认 1),由调用方根据业务约定决定如何兜底。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_frozen_columns_of_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_get_frozen_cols", "primary_cli_path": "aitable view get frozen-cols", "reviewed": false, "risk": "low", "title": "获取视图冻结列数", "use_when": [ "查询当前冻结列数" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询视图的分组", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_group", "cli_name": "group", "cli_path": "aitable view get group", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "metadata_source": "embedded-mcp-metadata", "name": "view_get_group", "primary_cli_path": "aitable view get group", "reviewed": true, "risk": "low", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询指定视图(View)当前的锁定状态。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_lock", "cli_name": "lock", "cli_path": "aitable view get lock", "confirmation": "not_required", "description": "查询指定视图(View)当前的锁定状态。\r\n\r\n通过 baseId / tableId / viewId 三元组定位目标视图,返回 locked 字段(true 表示已锁定)。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_view_lock_status" }, "metadata_source": "embedded-mcp-metadata", "name": "view_get_lock", "primary_cli_path": "aitable view get lock", "reviewed": false, "risk": "low", "title": "获取视图锁定状态", "use_when": [ "查询当前是否锁定" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询指定视图(View)当前的单元格行高,单位为像素。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_row_height", "cli_name": "row-height", "cli_path": "aitable view get row-height", "confirmation": "not_required", "description": "查询指定视图(View)当前的单元格行高,单位为像素。\r\n\r\n通过 baseId / tableId / viewId 三元组定位目标视图。\r\n\r\n视图未显式设置时返回 null(前端实际显示会回落到默认 32px),由调用方根据业务约定决定如何兜底。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_cell_height_of_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_get_row_height", "primary_cli_path": "aitable view get row-height", "reviewed": false, "risk": "low", "title": "获取视图行高", "use_when": [ "查询当前行高" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询视图的排序规则", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_sort", "cli_name": "sort", "cli_path": "aitable view get sort", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "metadata_source": "embedded-mcp-metadata", "name": "view_get_sort", "primary_cli_path": "aitable view get sort", "reviewed": true, "risk": "low", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询视图的时间条（甘特/时间轴）", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_timebar", "cli_name": "timebar", "cli_path": "aitable view get timebar", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "metadata_source": "embedded-mcp-metadata", "name": "view_get_timebar", "primary_cli_path": "aitable view get timebar", "reviewed": true, "risk": "low", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询视图的可见字段及顺序", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_visible_fields", "cli_name": "visible-fields", "cli_path": "aitable view get visible-fields", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "metadata_source": "embedded-mcp-metadata", "name": "view_get_visible_fields", "primary_cli_path": "aitable view get visible-fields", "reviewed": true, "risk": "low", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建视图（Grid/FormDesigner/Gantt/Cal”请改用 dws aitable view create", "要“删除视图（不可逆；禁止删除最后一个视图或锁定视图）”请改用 dws aitable view delete", "要“复制指定视图(View),生成一个与源视图结构一致的新视图(包含”请改用 dws aitable view duplicate" ], "canonical_path": "aitable.view_list", "cli_name": "list", "cli_path": "aitable view list", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "metadata_source": "embedded-mcp-metadata", "name": "view_list", "primary_cli_path": "aitable view list", "reviewed": false, "risk": "low", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "锁定或解锁指定视图(View)。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建视图（Grid/FormDesigner/Gantt/Cal”请改用 dws aitable view create", "要“删除视图（不可逆；禁止删除最后一个视图或锁定视图）”请改用 dws aitable view delete", "要“复制指定视图(View),生成一个与源视图结构一致的新视图(包含”请改用 dws aitable view duplicate" ], "canonical_path": "aitable.view_lock", "cli_name": "lock", "cli_path": "aitable view lock", "confirmation": "not_required", "description": "锁定或解锁指定视图(View)。\r\n\r\n- lock:锁定后视图不再允许被修改或删除\r\n- unlock:解锁后恢复可编辑状态\r\n\r\n操作幂等:对已锁定视图再次 lock 或对未锁定视图再次 unlock 不会报错。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "lock_or_unlock_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_lock", "primary_cli_path": "aitable view lock", "reviewed": false, "risk": "medium", "title": "锁定或解锁视图", "use_when": [ "4) 锁定视图，防止他人改坏", "解锁", "锁定（默认）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新视图的聚合统计（汇总行）", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“设置指定表格视图（Grid View）的条件填色规则（全量覆盖）”请改用 dws aitable view update fill-color-rule" ], "canonical_path": "aitable.view_update_aggregate", "cli_name": "aggregate", "cli_path": "aitable view update aggregate", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_update_aggregate", "primary_cli_path": "aitable view update aggregate", "reviewed": true, "risk": "medium", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新视图的卡片视图样式", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate", "要“设置指定表格视图（Grid View）的条件填色规则（全量覆盖）”请改用 dws aitable view update fill-color-rule" ], "canonical_path": "aitable.view_update_card", "cli_name": "card", "cli_path": "aitable view update card", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_update_card", "primary_cli_path": "aitable view update card", "reviewed": true, "risk": "medium", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新视图的各列列宽", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate", "要“设置指定表格视图（Grid View）的条件填色规则（全量覆盖）”请改用 dws aitable view update fill-color-rule" ], "canonical_path": "aitable.view_update_field_widths", "cli_name": "field-widths", "cli_path": "aitable view update field-widths", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_update_field_widths", "primary_cli_path": "aitable view update field-widths", "reviewed": true, "risk": "medium", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "设置指定表格视图（Grid View）的条件填色规则（全量覆盖）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_fill_color_rule", "cli_name": "fill-color-rule", "cli_path": "aitable view update fill-color-rule", "confirmation": "not_required", "description": "设置指定表格视图（Grid View）的条件填色规则（全量覆盖）。传空数组 [] 表示清空当前视图的填色规则。单次最多设置 40 条规则；超出会被拒绝。注意：每条规则的 filters 数组只能有 1 条（filters[0]）。如需多条件，请拆成多条规则。仅支持 Grid 视图；锁定视图不允许修改。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "set_view_fill_color_rule" }, "metadata_source": "embedded-mcp-metadata", "name": "view_update_fill_color_rule", "primary_cli_path": "aitable view update fill-color-rule", "reviewed": false, "risk": "medium", "title": "设置视图填色规则", "use_when": [ "1) 给金额字段 \u003e 100 的单元格上 firstLine5 色", "2) 清空所有规则", "3) 金额 \u003e 100 的单元格上色" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新视图的筛选条件", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_filter", "cli_name": "filter", "cli_path": "aitable view update filter", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_update_filter", "primary_cli_path": "aitable view update filter", "reviewed": true, "risk": "medium", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "设置指定视图(View)的冻结列数(左侧固定列),默认 1。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_frozen_cols", "cli_name": "frozen-cols", "cli_path": "aitable view update frozen-cols", "confirmation": "not_required", "description": "设置指定视图(View)的冻结列数(左侧固定列),默认 1。\r\n\r\n通过 baseId / tableId / viewId 三元组定位目标视图。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "set_frozen_columns_of_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_update_frozen_cols", "primary_cli_path": "aitable view update frozen-cols", "reviewed": false, "risk": "medium", "title": "设置视图冻结列数", "use_when": [ "1) 关键字段冻结，避免横向滚动看不到", "冻结从首列起 1 列", "取消冻结" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新视图的分组", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_group", "cli_name": "group", "cli_path": "aitable view update group", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_update_group", "primary_cli_path": "aitable view update group", "reviewed": true, "risk": "medium", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "重命名视图（修改视图名称）", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_name", "cli_name": "name", "cli_path": "aitable view update name", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_update_name", "primary_cli_path": "aitable view update name", "reviewed": true, "risk": "medium", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "设置指定视图(View)的单元格高度(行高),单位为像素,默认 32。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_row_height", "cli_name": "row-height", "cli_path": "aitable view update row-height", "confirmation": "not_required", "description": "设置指定视图(View)的单元格高度(行高),单位为像素,默认 32。\r\n\r\n通过 baseId / tableId / viewId 三元组定位目标视图。\r\n\r\n工具层不做范围或枚举校验,超出下游允许范围的取值由下游回填错误。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "set_cell_height_of_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_update_row_height", "primary_cli_path": "aitable view update row-height", "reviewed": false, "risk": "medium", "title": "set_cell_height_of_view", "use_when": [ "2) 加大行高让数据更易读", "设置行高 — 推荐档位 32 / 56 / 88 / 128" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新视图的排序规则", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_sort", "cli_name": "sort", "cli_path": "aitable view update sort", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_update_sort", "primary_cli_path": "aitable view update sort", "reviewed": true, "risk": "medium", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新视图的时间条（甘特/时间轴）", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_timebar", "cli_name": "timebar", "cli_path": "aitable view update timebar", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_update_timebar", "primary_cli_path": "aitable view update timebar", "reviewed": true, "risk": "medium", "title": "update_view", "use_when": [ "第 2 步（必须）：绑定日期字段，否则视图为空" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新视图的可见字段及顺序", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_visible_fields", "cli_name": "visible-fields", "cli_path": "aitable view update visible-fields", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "metadata_source": "embedded-mcp-metadata", "name": "view_update_visible_fields", "primary_cli_path": "aitable view update visible-fields", "reviewed": true, "risk": "medium", "title": "update_view", "use_when": [ "传回全量列表解除隐藏", "只保留首列和 fldA，其余字段被隐藏" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "禁用指定 Base 中的自动化工作流。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 中的自动化工作流，直接返回下游 search”请改用 dws aitable workflow list", "要“启用指定 Base 中的自动化工作流”请改用 dws aitable workflow enable", "要“获取指定 Base 中某个自动化工作流的详细信息，直接返回下游”请改用 dws aitable workflow get" ], "canonical_path": "aitable.workflow_disable", "cli_name": "disable", "cli_path": "aitable workflow disable", "confirmation": "user_required", "description": "禁用指定 Base 中的自动化工作流。禁用后工作流将不再自动触发执行。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "disable_workflow" }, "metadata_source": "embedded-mcp-metadata", "name": "workflow_disable", "primary_cli_path": "aitable workflow disable", "reviewed": false, "risk": "high", "title": "禁用自动化工作流", "use_when": [ "2. 禁用" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "启用指定 Base 中的自动化工作流。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 中的自动化工作流，直接返回下游 search”请改用 dws aitable workflow list", "要“禁用指定 Base 中的自动化工作流”请改用 dws aitable workflow disable", "要“获取指定 Base 中某个自动化工作流的详细信息，直接返回下游”请改用 dws aitable workflow get" ], "canonical_path": "aitable.workflow_enable", "cli_name": "enable", "cli_path": "aitable workflow enable", "confirmation": "not_required", "description": "启用指定 Base 中的自动化工作流。启用后工作流将按配置的触发条件自动执行。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "enable_workflow" }, "metadata_source": "embedded-mcp-metadata", "name": "workflow_enable", "primary_cli_path": "aitable workflow enable", "reviewed": false, "risk": "medium", "title": "启用自动化工作流", "use_when": [ "3. 调试做完后重启" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取指定 Base 中某个自动化工作流的详细信息，直接返回下游 getFlowDetail 的详情结构。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 中的自动化工作流，直接返回下游 search”请改用 dws aitable workflow list", "要“启用指定 Base 中的自动化工作流”请改用 dws aitable workflow enable", "要“禁用指定 Base 中的自动化工作流”请改用 dws aitable workflow disable" ], "canonical_path": "aitable.workflow_get", "cli_name": "get", "cli_path": "aitable workflow get", "confirmation": "not_required", "description": "获取指定 Base 中某个自动化工作流的详细信息，直接返回下游 getFlowDetail 的详情结构。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_workflow" }, "metadata_source": "embedded-mcp-metadata", "name": "workflow_get", "primary_cli_path": "aitable workflow get", "reviewed": false, "risk": "low", "title": "获取自动化工作流", "use_when": [ "1. 留底当前状态" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出指定 Base 中的自动化工作流，直接返回下游 searchFlows 的响应结构。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“启用指定 Base 中的自动化工作流”请改用 dws aitable workflow enable", "要“禁用指定 Base 中的自动化工作流”请改用 dws aitable workflow disable", "要“获取指定 Base 中某个自动化工作流的详细信息，直接返回下游”请改用 dws aitable workflow get" ], "canonical_path": "aitable.workflow_list", "cli_name": "list", "cli_path": "aitable workflow list", "confirmation": "not_required", "description": "列出指定 Base 中的自动化工作流，直接返回下游 searchFlows 的响应结构。支持分页，limit 默认 20，最大 100；offset 默认 0。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "list_workflows" }, "metadata_source": "embedded-mcp-metadata", "name": "workflow_list", "primary_cli_path": "aitable workflow list", "reviewed": false, "risk": "low", "title": "列出自动化工作流", "use_when": [ "4. 确认 status=RUNNING" ] } ], "use_when": [ "帮我建一个项目跟踪表；创建数据表格", "表格/多维表/AI表格/记录/数据/视图/图表/仪表盘" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.attendance.prod.json", "skills/mono/SKILL.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "考勤打卡 / 排班 / 统计", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "description": "考勤打卡 / 排班 / 统计", "id": "attendance", "name": "考勤打卡 / 排班 / 统计", "runtime": true, "tool_count": 38, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询单个补卡规则详情", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "不知道补卡规则ID时先用 attendance adjustment search", "查询加班规则详情时使用 attendance overtime get", "查询补卡审批单记录时使用 attendance approve list" ], "canonical_path": "attendance.adjustment_get", "cli_name": "get", "cli_path": "attendance adjustment get", "confirmation": "not_required", "description": "调用 MCP 工具 get_adjustment_rule_detail，根据补卡规则主键 ID 查询对应的补卡规则详情。\n--adjustment-id 必填。注意：已被删除或被更新覆盖的补卡规则无法查询到。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "adjustment_get", "primary_cli_path": "attendance adjustment get", "reviewed": true, "risk": "low", "title": "根据补卡规则主键 ID 查询补卡规则详情", "use_when": [ "已取得补卡规则ID，需要查看规则详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询补卡规则列表", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "已知道补卡规则ID并要看详情时使用 attendance adjustment get", "查询加班规则时使用 attendance overtime search", "查询员工打卡/考勤记录时使用 attendance record get 或 attendance check record" ], "canonical_path": "attendance.adjustment_search", "cli_name": "search", "cli_path": "attendance adjustment search", "confirmation": "not_required", "description": "根据用户权限查询补卡规则列表，入参封装在 ATRuleQueryParam 对象中。\n --query 补卡规则名称关键字，模糊搜索（可选）\n --page 页码（从 1 开始，默认 1）（必填）\n --limit 每页条数（200 以内，默认 20）（必填）", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "adjustment_search", "primary_cli_path": "attendance adjustment search", "reviewed": true, "risk": "low", "title": "查询当前用户可管理的补卡规则列表", "use_when": [ "需要查看有哪些补卡规则或筛选补卡规则" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询考勤相关审批单记录", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查询假期余额时使用 attendance vacation balance", "查询实际打卡记录时使用 attendance record get 或 attendance check record", "需要获取可提交审批的模板/跳转链接时使用 attendance approve templates" ], "canonical_path": "attendance.approve_list", "cli_name": "list", "cli_path": "attendance approve list", "confirmation": "not_required", "description": "查询指定用户的考勤业务审批单记录（补卡 / 加班 / 请假 / 出差外出）。\n审批类型 --types 支持以下关键词（多个用英文逗号分隔）：\n - overtime / 加班 → bizType=1\n - trip / travel / business_trip / business-trip / 出差 / 外出 → bizType=2（出差与外出在查询接口合并为同一类，不再细分）\n - leave / 请假 → bizType=3\n - patch / repair-check / repair_check / 补卡 → bizType=4\n说明：\n - 服务端查询接口 bizType=2 同时覆盖出差与外出，传入 trip / travel / 出差 / 外出 任一别名都会返回这两类合并的记录；\n - 如需在提交入口区分外出（TRAVEL）与出差（OUT），请改用 dws attendance approve templates --type travel|out；\n - 返回每条记录含：用户 ID、审批标签、审批子类型、审批类型、生效时间、时长、时长单位、流程实例 ID。", "effect": "read", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "approve_list", "primary_cli_path": "attendance approve list", "reviewed": true, "risk": "medium", "title": "查询用户审批单（补卡/加班/请假/出差外出）", "use_when": [ "查询补卡、加班、请假、出差外出等考勤审批记录" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询考勤审批模板和提交入口", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查看已存在审批单记录时使用 attendance approve list", "查询考勤记录/统计时使用 attendance record get 或 attendance summary", "配置考勤规则时使用 attendance group/globalsetting/class 相关命令" ], "canonical_path": "attendance.approve_templates", "cli_name": "templates", "cli_path": "attendance approve templates", "confirmation": "not_required", "description": "当用户需要提交补卡、请假、加班、外出、出差时，查询对应考勤审批表单模板，返回审批提交跳转链接。\n审批类型支持：repair-check/patch/补卡、leave/请假、overtime/加班、travel/外出、out/trip/出差，也支持直接传 REPAIR_CHECK、LEAVE、OVERTIME、TRAVEL、OUT。\n向用户展示提交入口时，不要直接裸露 submitUrl，应使用 Markdown 可点击链接格式：[表单名称](submitUrl)。", "effect": "read", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "approve_templates", "primary_cli_path": "attendance approve templates", "reviewed": true, "risk": "medium", "title": "查询补卡/请假/加班/外出/出差审批提交链接", "use_when": [ "用户要发起补卡、请假、加班、外出或出差审批前查询可用模板" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量查询员工班次信息", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查询实际排班记录时使用 attendance schedule get", "查询班次定义/班次ID时使用 attendance class search 或 attendance class get", "查询考勤组与规则时使用 attendance rules" ], "canonical_path": "attendance.batch_get_employee_shifts", "cli_name": "list", "cli_path": "attendance shift list", "confirmation": "not_required", "description": "批量查询多个员工在指定日期的考勤班次信息，返回每条记录包含：用户 ID（userId）、工作日期（workDate，毫秒时间戳）、打卡类型（checkType，如 OnDuty 表示上班）、计划打卡时间（planCheckTime，毫秒时间戳）以及是否为休息日（isRest，\"Y\"/\"N\"）。结果基于组织考勤配置生成，仅返回调用者有权限查看的员工数据，适用于排班核对、考勤预览等场景。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "attendance", "rpc_name": "batch_get_employee_shifts" }, "metadata_source": "embedded-mcp-metadata", "name": "batch_get_employee_shifts", "primary_cli_path": "attendance shift list", "reviewed": true, "risk": "low", "title": "batch_get_employee_shifts", "use_when": [ "按员工和日期范围查询班次/排班班次" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "管理员修正员工打卡结果", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "只查询打卡记录时使用 attendance check record/check result", "未获得用户明确确认时不要修改打卡结果", "查询考勤统计时使用 attendance summary" ], "canonical_path": "attendance.boss_check", "cli_name": "boss-check", "cli_path": "attendance boss-check", "confirmation": "user_required", "description": "调用 MCP 工具 boss_check 修改员工打卡记录。管理员可修改打卡时间、打卡结果等信息。\n\n参数说明：\n --plan-id 排班ID（与 --result-id 二选一）\n 来源：通过 dws attendance schedule get 获取，返回结果的 id 字段\n 示例：id: 948964045503 表示某天下班打卡的排班记录ID\n\n --result-id 打卡结果ID（与 --plan-id 二选一，优先使用）\n 来源：暂不支持（record get 未返回此字段），建议使用 --plan-id\n\n --time 新打卡时间，格式 yyyy-MM-dd HH:mm（可选）\n --result 打卡结果：Normal/TimesResultA/TimesResultB/TimesResultC/TimesResultD/TimesResultE/TimesResultF（可选）\n --absent-min 缺勤时长（分钟），当 result 为异常状态时需传值（可选）\n --remark 备注，最长500字符（可选）\n --user-say-yes 用户已确认，跳过交互式确认提示\n\n打卡结果枚举值：\n Normal 正常\n TimesResultA 迟到\n TimesResultB 早退\n TimesResultC 缺卡\n TimesResultD 迟到+早退\n TimesResultE 缺卡+早退\n TimesResultF 迟到+缺卡\n\n获取 planId 步骤：\n 1. 查询排班记录：dws attendance schedule get --userIdList USER_ID --workDateBegin DATE --workDateEnd DATE\n 2. 从返回结果中找到对应打卡类型（OnDuty=上班，OffDuty=下班）的 id 字段\n 3. 使用该 id 作为 --plan-id 参数", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "boss_check", "primary_cli_path": "attendance boss-check", "reviewed": true, "risk": "high", "title": "BOSS 改签打卡记录", "use_when": [ "管理员确认需要人工修正员工打卡记录或打卡结果" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询打卡记录", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改打卡结果时使用 attendance boss-check", "查询考勤统计摘要时使用 attendance summary", "查询考勤详情时使用 attendance record get" ], "canonical_path": "attendance.check_record", "cli_name": "record", "cli_path": "attendance check record", "confirmation": "not_required", "description": "查询指定用户的打卡流水记录。\n返回每条记录含：用户 ID、实际打卡时间、打卡地址、打卡经纬度、\n打卡类型（OnDuty/OffDuty）、定位方式（Map/Wifi/etc）。\n时间跨度不超过 1 个月。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "check_record", "primary_cli_path": "attendance check record", "reviewed": true, "risk": "low", "title": "查询打卡流水", "use_when": [ "查询员工打卡流水或打卡记录" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询打卡结果", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改打卡结果时使用 attendance boss-check", "查询原始打卡流水时使用 attendance check record", "查询统计摘要时使用 attendance summary" ], "canonical_path": "attendance.check_result", "cli_name": "result", "cli_path": "attendance check result", "confirmation": "not_required", "description": "查询指定用户的打卡结果记录。\n返回每条记录含：用户 ID、工作日期、时间结果（Normal/Late/Early/Absenteeism/NotSigned）、\n位置结果、计划打卡时间、实际打卡时间、打卡流水 ID。\n时间跨度不超过 1 个月，最多 100 人。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "check_result", "primary_cli_path": "attendance check result", "reviewed": true, "risk": "low", "title": "查询打卡结果", "use_when": [ "查询员工打卡结果或考勤结果" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询打卡流水记录", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改打卡记录时使用 attendance boss-check", "查询班次/排班时使用 attendance shift list 或 schedule get", "查询考勤汇总时使用 attendance summary" ], "canonical_path": "attendance.checkin_records", "cli_name": "records", "cli_path": "attendance checkin records", "confirmation": "not_required", "description": "查询指定员工在一段时间内的签到记录。\n权限说明：\n - Boss / 超级管理员 / 超级子管理员：可查看全公司员工\n - 子管理员：可查看管理范围内的员工及自己\n - 部门主管：可查看所管理部门的员工及自己\n - 普通员工：只能查询自己\n\n日期格式：yyyy-MM-dd HH:mm:ss（如 2026-04-01 09:00:00）", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "checkin_records", "primary_cli_path": "attendance checkin records", "reviewed": true, "risk": "low", "title": "查询指定员工的签到记录", "use_when": [ "查询员工打卡流水、定位或打卡时间记录" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建班次定义", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改已有班次时使用 attendance class update", "导入员工排班时使用 attendance schedule import", "查询已有班次时使用 attendance class search/get" ], "canonical_path": "attendance.class_create", "cli_name": "create", "cli_path": "attendance class create", "confirmation": "not_required", "description": "调用 MCP 工具 create_class_setting，创建一个新的班次。\n--name 和 --sections 必填，其余参数可选。由于保存班次耗时较久，指令需要带上 --timeout 10\n--yes 需要用户二次确认之后才允许带入，参考attendance.md中对于创建班次的说明\n\n常用 flag：\n --name 班次名称（必填）\n --owner 班次负责人 userId（可选）\n --class-vo 完整 TopAtClassVO JSON 字符串（可选，用于传入复杂结构）\n\n当使用 --class-vo 传入完整 JSON 时，--name 和 --owner 仍可覆写 JSON 中的同名字段。\ncheckTime 字段统一使用 \"HH:mm\" 格式（如 \"09:00\"），CLI 自动转换为服务端所需的时间戳。\n\n--class-vo JSON 可用字段说明：\n\n name string 班次名称（必填）\n owner string 班次负责人 userId\n sections []object 班次上下班时间段（必填），支持多段上下班，每段包含 times 数组：\n - times []object 每段有且只能有两个对象（上班+下班），每个对象字段：\n checkType string 打卡类型：OnDuty（上班）/ OffDuty（下班）（必填）\n checkTime string 打卡时间，格式 \"HH:mm\"（必填，如 \"09:00\"、\"17:30\"）\n across number 是否跨天：0（不跨天）/ 1（跨天）（必填）\n freeCheck bool 是否免打卡\n beginMin number 允许最早提前打卡时间（分钟，-1 表示不限制）\n endMin number 允许最晚打卡时间（分钟，-1 表示不限制）\n setting object 班次其他配置：\n - seriousLateMinutes number 晚到多少分钟记为严重迟到\n - absenteeismLateMinutes number 晚到多少分钟记为旷工迟到\n - attendDays number 本班次记为多少天出勤（支持两位小数）\n - topRestTimeList []object 班次休息时间（仅 sections 只有一段上下班时可用，最多 3 段休息时间）：\n checkType string 休息类型：OnDuty（开始休息）/ OffDuty（结束休息）\n checkTime string 休息时间，格式 \"HH:mm\"（如 \"12:00\"、\"13:00\"）\n across number 是否跨天：0/1", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "class_create", "primary_cli_path": "attendance class create", "reviewed": true, "risk": "medium", "title": "创建班次", "use_when": [ "需要新增一个班次/上下班时间规则" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询单个班次定义详情", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "不知道班次ID时先用 attendance class search", "修改班次定义时使用 attendance class update", "查询员工排班记录时使用 attendance schedule get" ], "canonical_path": "attendance.class_get", "cli_name": "get", "cli_path": "attendance class get", "confirmation": "not_required", "description": "调用 MCP 工具 get_class_detail，根据班次 ID 查询该班次的详细信息。--class-id 必填。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "class_get", "primary_cli_path": "attendance class get", "reviewed": true, "risk": "low", "title": "根据班次 ID 查询班次详情", "use_when": [ "已取得班次ID，需要查看班次配置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询班次定义列表", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "创建或修改班次定义时使用 attendance class create/update", "已知道班次ID并要看详情时使用 attendance class get", "查询员工排班记录时使用 attendance schedule get" ], "canonical_path": "attendance.class_search", "cli_name": "search", "cli_path": "attendance class search", "confirmation": "not_required", "description": "查询当前用户有权管理的班次列表（班次定义），支持按名称搜索和类型过滤。\n所有参数均为可选项：\n --page 页码（从 1 开始，默认 1）\n --limit 每页条数（最大 200，默认 20）\n --query 班次名称关键字，模糊搜索\n --filter-type 班次类型：ALL（全部班次）/ MINE_OWN（我负责的），默认 ALL", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "class_search", "primary_cli_path": "attendance class search", "reviewed": true, "risk": "low", "title": "查询当前用户可管理的所有班次详情", "use_when": [ "搜索或列出可用班次/班次ID" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新班次定义", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "创建新班次时使用 attendance class create", "查询班次详情时使用 attendance class get", "调整员工排班时使用 attendance schedule import" ], "canonical_path": "attendance.class_update", "cli_name": "update", "cli_path": "attendance class update", "confirmation": "not_required", "description": "调用 MCP 工具 update_class_setting，更新一个已有的班次。\n--class-id 必填；其余参数均可选，仅需对要修改的字段进行赋値，未传的字段会自动从已有配置补充。由于保存班次耗时较久，指令需要带上 --timeout 10\n--yes 需要用户二次确认之后才允许带入，参考attendance.md中对于更新班次的说明\n\n常用 flag：\n --class-id 班次 ID（必填）\n --name 班次名称（可选，不传则保持原值）\n --owner 班次负责人 userId（可选，不传则保持原值）\n --class-vo 完整 TopAtClassVO JSON 字符串（可选，用于传入复杂结构）\n\n当使用 --class-vo 传入完整 JSON 时，--name 和 --owner 仍可覆写 JSON 中的同名字段。\ncheckTime 字段统一使用 \"HH:mm\" 格式（如 \"09:00\"），CLI 自动转换为服务端所需的时间戳。\n\n--class-vo JSON 可用字段说明：\n\n name string 班次名称（可选，不传则保持原值）\n owner string 班次负责人 userId（可选，不传则保持原值）\n sections []object 班次上下班时间段（可选，不传则保持原值），支持多段上下班，每段包含 times 数组：\n - times []object 每段有且只能有两个对象（上班+下班），每个对象字段：\n checkType string 打卡类型：OnDuty（上班）/ OffDuty（下班）（必填）\n checkTime string 打卡时间，格式 \"HH:mm\"（必填，如 \"09:00\"、\"17:30\"）\n across number 是否跨天：0（不跨天）/ 1（跨天）（必填）\n freeCheck bool 是否免打卡\n beginMin number 允许最早提前打卡时间（分钟，-1 表示不限制）\n endMin number 允许最晚打卡时间（分钟，-1 表示不限制）\n setting object 班次其他配置：\n - seriousLateMinutes number 晚到多少分钟记为严重迟到\n - absenteeismLateMinutes number 晚到多少分钟记为旷工迟到\n - attendDays number 本班次记为多少天出勤（支持两位小数）\n - topRestTimeList []object 班次休息时间（仅 sections 只有一段上下班时可用，最多 3 段休息时间）：\n checkType string 休息类型：OnDuty（开始休息）/ OffDuty（结束休息）\n checkTime string 休息时间，格式 \"HH:mm\"（如 \"12:00\"、\"13:00\"）\n across number 是否跨天：0/1", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "class_update", "primary_cli_path": "attendance class update", "reviewed": true, "risk": "medium", "title": "更新班次", "use_when": [ "需要修改已有班次的名称、上下班时间或规则" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询个人考勤统计摘要", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查看单条考勤明细时使用 attendance record get", "查看原始打卡记录时使用 attendance check record", "查看排班时使用 attendance schedule get" ], "canonical_path": "attendance.get_attendance_summary", "cli_name": "summary", "cli_path": "attendance summary", "confirmation": "not_required", "description": "获取考勤统计摘要", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "attendance", "rpc_name": "get_attendance_summary" }, "metadata_source": "embedded-mcp-metadata", "name": "get_attendance_summary", "primary_cli_path": "attendance summary", "reviewed": true, "risk": "low", "title": "get_attendance_summary", "use_when": [ "查看员工考勤统计、出勤/异常/请假等摘要" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询个人考勤详情", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改打卡结果时使用 attendance boss-check", "查询打卡流水/原始打卡记录时使用 attendance check record 或 checkin records", "查询考勤统计汇总时使用 attendance summary" ], "canonical_path": "attendance.get_user_attendance_record", "cli_name": "get", "cli_path": "attendance record get", "confirmation": "not_required", "description": "查询指定用户在某一天的考勤详情，包括实际打卡记录（如上班/下班时间、是否正常打卡）、当日所排班次、所属考勤组信息、是否为休息日、出勤工时（如 \"0Hours\"）、加班时长等。返回数据受组织权限和隐私策略限制，仅当调用者有权限查看该用户考勤信息时才返回有效内容。适用于员工自助查询、HR 核对出勤或审批关联场景。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "attendance", "rpc_name": "get_user_attendance_record" }, "metadata_source": "embedded-mcp-metadata", "name": "get_user_attendance_record", "primary_cli_path": "attendance record get", "reviewed": true, "risk": "low", "title": "查询指定用户某一天的考勤详情", "use_when": [ "查询某个员工某天或时间段的考勤明细" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询企业全局考勤设置", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改全局设置时使用 attendance globalsetting save", "查看个人设置时使用 attendance selfsetting get", "查看考勤组规则时使用 attendance group get/rules" ], "canonical_path": "attendance.globalsetting_get", "cli_name": "get", "cli_path": "attendance globalsetting get", "confirmation": "not_required", "description": "查询全局规则设置，仅管理员可以调用。\n\n入参字段:\n --setting-scene 查询设置项，枚举值包括 checkRemind、fastCheck、checkResultNotify、lackRemind、personalAttendStatNotify、bossAttendStatNotify\n --scope 必填，必须明确输入 企业、全公司 或 所有人，用于确认本次查询面向全局范围\n\n说明：corpId 和 opUserId 由当前登录上下文自动补齐，不需要通过 CLI 入参传入。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "globalsetting_get", "primary_cli_path": "attendance globalsetting get", "reviewed": true, "risk": "low", "title": "查询全局规则设置（仅管理员）", "use_when": [ "管理员查看企业级打卡提醒、极速打卡等全局设置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新企业全局考勤设置", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改个人设置时使用 attendance selfsetting save", "修改考勤组配置时使用 attendance group update", "只查看全局设置时使用 attendance globalsetting get" ], "canonical_path": "attendance.globalsetting_save", "cli_name": "save", "cli_path": "attendance globalsetting save", "confirmation": "user_required", "description": "更新保存全局规则设置，仅管理员可以调用。\n\n入参字段:\n --setting-scene 必填，枚举值包括 checkRemind、fastCheck、checkResultNotify、lackRemind、personalAttendStatNotify、bossAttendStatNotify\n --scope 必填，必须明确输入 企业、全公司 或 所有人，用于确认本次更新面向全局范围\n\n按 settingScene 传入对应设置字段，且至少传一个字段：\n checkRemind:\n --check-remind-corp\n --check-remind-pc-corp\n fastCheck:\n --fast-check-corp\n checkResultNotify:\n --enable-check-cert-push\n lackRemind:\n --lack-remind-corp\n personalAttendStatNotify:\n --enable-personal-daily-report\n --enable-personal-weekly-report\n --enable-personal-weekly-report-card\n --enable-personal-monthly-report\n bossAttendStatNotify:\n --boss-daily-report-type\n --boss-weekly-report-type\n --boss-monthly-report-type\n\n说明：corpId 和 opUserId 由当前登录上下文自动补齐，不需要通过 CLI 入参传入。\n返回 ServiceResult，result 为 boolean，表示保存是否成功。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "globalsetting_save", "primary_cli_path": "attendance globalsetting save", "reviewed": true, "risk": "high", "title": "更新保存全局规则设置（仅管理员）", "use_when": [ "管理员需要修改企业级打卡提醒、极速打卡等全局设置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建考勤组", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "仅修改成员时使用 attendance group update-members", "修改已有考勤组时使用 attendance group update", "查询已有考勤组时使用 attendance group search/get" ], "canonical_path": "attendance.group_create", "cli_name": "create", "cli_path": "attendance group create", "confirmation": "user_required", "description": "调用 MCP 工具 create_group_setting，创建一个新的考勤组。\n--name 和 --type 必填，其余参数可选（未传字段使用默认值）。由于创建考勤组耗时较久，指令需要带上 --timeout 10\n--yes 需要用户二次确认之后才允许带入，参考attendance.md中对于创建考勤组的说明\n\n常用 flag：\n --name 考勤组名称（必填）\n --type 考勤组类型：FIXED（固定班制）/ TURN（排班制）/ NONE（自由工时）（必填，显式校验）\n --owner 考勤组主负责人 userId（可选）\n --group-vo 完整 groupVO JSON 字符串（可选，用于传入复杂子对象，会与 --name/--type/--owner 合并）\n\n当使用 --group-vo 传入完整 JSON 时，--name、--type、--owner 仍可覆写 JSON 中的同名字段。\n\n【无条件必填字段】\n name string 考勤组名称\n type string 考勤组类型：FIXED / TURN / NONE\n\n【条件必填字段（type=FIXED 固定班制时）】\n workDayClassList []number 工作日班次列表，不能为空。\n 一共7个值，分别代表周日到周六每天的班次id，为0表示当天休息。\n 例如 [0,1279240003,0,0,0,0,0] 表示周一的班次id为1279240003，其余日子都是休息\n defaultClassId number 默认班次 ID，不能为 null\n\n条件必填字段通过 --group-vo JSON 传入，CLI 在 --type=FIXED 时会显式校验这些字段。\n\n--group-vo 可用字段说明（与更新考勤组一致，均可选，只需包含要设置的字段）：\n\n【基础信息】\n id number 考勤组id（创建时禁止传入，由服务端分配）\n name string 考勤组名称（必填）\n type string 考勤组类型：FIXED（固定班制）/ TURN（排班制）/ NONE（自由工时）（必填）\n owner string 考勤组主负责人 userId\n managerList []string 考勤组子负责人 userId 列表\n skipHolidays bool 节假日自动排休（只有固定班制和自由工时考勤组生效）\n defaultGroup bool 是否默认考勤组\n classIds []number 所选班次 id 列表(只有固定班制和排班制才有班次，自由工时没有)\n\n【打卡范围与定位】\n trimDistance number 定位允许微调距离（米）\n enablePositionOfGps bool 打卡是否允许开启 GPS 定位\n enablePositionOfWifi bool 是否开启 wifi 定位\n enablePositionOfBle bool 是否启用蓝牙定位\n\n positions []object 考勤打卡地址列表（地址定位打卡用），每项字段：\n - title string 地址标题\n - address string 地址详情（完整地址文本）\n - latitude number 纬度\n - longitude number 经度\n - offset number 该地址允许的打卡范围，单位米\n\n wifis []object 打卡方式中的 wifi 详情列表，每项字段：\n - ssid string wifi 的 ssid（wifi名称）\n - macAddr string wifi 的 macAddr（MAC 地址）\n - groupId number 考勤组id\n\n bleDeviceVOList []object 已选择的蓝牙设备列表，每项字段：\n - name string 设备名称\n - deviceUid number 设备 uid\n - sn string 设备 sn 序列号\n - productType string 对外的设备类型\n - devServId number 内部设备类型\n\n【外勤打卡设置】\n enableOutsideCheck bool 是否可以外勤打卡\n enableOutsideCameraCheck bool 是否开启外勤打卡必须拍照\n enableOutsideRemark bool 是否开启外勤打卡必须填写备注\n enableOutsideApply bool 是否开启外勤打卡必须审批\n forbidHideOutSideAddress bool 禁止隐藏外勤打卡地址的功能，false表示允许用户隐藏外勤打卡地址\n enableOutSideUpdateNormalCheck bool 下班时间：允许外勤卡更新内勤卡\n enableOnDutyNormalUpdateOutsideCheck bool 上班时间：允许内勤卡更新外勤卡\n outsideCheckApproveMode string 外勤打卡需审批执行模式：\n NO_NEED_APPROVE（无需审批）\n APPROVE_FIRST（先审批后打卡）\n CHECK_FIRST（先打卡后审批）\n APPROVE_EVERYTIME（每次打卡都需要审批）\n outSideCheckApplyType number 外勤审批范围：1（全天外勤打卡）/ 2（上班外勤打卡）/ 3（下班外勤打卡）\n\n【打卡方式】\n enableCameraCheck bool 是否开启拍照打卡\n openCameraCheck bool 是否开启拍照打卡（与 enableCameraCheck 含义相同）\n openFaceCheck bool 是否开启人脸打卡\n enableFaceStrictMode bool 是否开启人脸严格模式（强制活体检测）\n enableFaceBeauty bool 是否开启美颜\n onlyMachineCheck bool 只允许考勤机打卡\n permitMaxBeaconCount number 允许绑定的智点设备数量\n disableCheckWhenRest bool 休息日打卡需审批（只在固定班制和排班制生效，true表示打卡需要提交审批单）\n\n\n【固定班制设置（FIXED）】\n defaultClassId number 固定班制的默认班次 id（type=FIXED 时必填）\n workDayClassList []number 固定班制的工作日班次 id 列表，一共7个值，分别代表周日到周六每天的班次id，为0表示当天休息，例如[0,1279240003,0,0,0,0,0]表示周一的班次id为1279240003，其余日子都是休息\n\n【排班制设置（TURN）】\n disableCheckWithoutSchedule bool 未排班时员工可打卡（true=未排班时禁止打卡）\n enableEmpSelectClass bool 未排班时，员工可选班次打卡\n enableScheduleAutoMatch bool 未排班时，系统自动匹配班次\n ----以下是排班制设置排班周期的，非必要，不是所有排班制考勤组都需要设置，不设置就是按照classIds中的班次由管理员自行排班-----\n cycleDays number 排班循环天数，支持大小周（14天）\n startCycleDate number 用户设置的大小周开始时间（时间戳，毫秒）\n cycleScheduleList []object 循环排班设置列表，每项字段：\n - cycleName string 周期名字（如\"第一周\"）\n - groupId number 考勤组 id\n - isValid string 是否有效：Y（有效）/ N（无效）\n - itemList []object 排班设置列表，每项字段：\n - classId number 班次 id\n - className string 班次名称\n - isValid string 是否有效（Y/N）\n\n【自由工时设置（NONE）】\n workDays []number 自由工时的工作日，如 [1,2,3,4,5] 表示周一到周五（1=周一，7=周日）\n freeCheckDayStartMinOffset number 自由打卡每日开始时间，距离 0 点的分钟数（如 480 表示 08:00 开始）\n freeCheckCoreTime number 自由工时考勤组的打卡最短工作时长（分钟）\n freeCheckDemandWorkMinutes number 自由工时考勤组要求的打卡时长（分钟）\n\n freeCheckSettingVO object 自由工时打卡设置，包含字段：\n - freeCheckType string 自由工时打卡类型：\n CYCLE（上下班交替打卡）\n MAX_TIME_UPDATE（最大时间打卡，第一次为上班，后续均为下班卡）\n - freeWorkDayLackSwitch bool 自由工时打卡规则：工作日没打卡记为缺卡（true=记缺卡）\n - freeOnDutyLackMinOffset number 自由工时打卡规则：上班缺卡生成时间偏移分钟数\n - freeOffDutyLackMinOffset number 自由工时打卡规则：下班缺卡生成时间偏移分钟数\n - delimitOffsetMinutesBetweenDays number 自由工时前后两天的分割线（距 0 点分钟数，超过此时间则归属第二天）\n - freeCheckGapVO object 自由工时/休息日打卡间隔设置：\n - onOffCheckGapMinutes number 上班打卡后，多久才可以打下班卡（分钟）\n - offOnCheckGapMinutes number 下班打卡后，多久才可以打上班卡（分钟）\n\n freeGroupSpecialDayVO object 自由工时考勤组特殊日期设置，包含字段：\n - specialOnDutyDays []number 特殊需要打卡日期的时间戳列表（毫秒，原本休息日需额外打卡的日期）\n - specialOffDutyDays []number 特殊无需打卡日期的时间戳列表（毫秒，原本工作日可免打卡的日期）", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "group_create", "primary_cli_path": "attendance group create", "reviewed": true, "risk": "high", "title": "创建考勤组", "use_when": [ "需要新建一个考勤组并配置规则" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询考勤组指定字段子集", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "不知道考勤组ID时先用 attendance group search", "需要修改成员时使用 attendance group update-members", "需要完整考勤组配置时使用 attendance group get" ], "canonical_path": "attendance.group_filtered_get", "cli_name": "filtered-get", "cli_path": "attendance group filtered-get", "confirmation": "not_required", "description": "调用 MCP 工具 get_group_filtered_detail，根据考勤组 ID 仅返回关心的字段子集，\n强烈建议在仅需查询成员信息、打卡地址、蓝牙、Wifi 时使用，节省查询成本。\n--group-id 必填；四个过滤字段均可选（不传则默认 false，即不查询该字段）。\n --member 是否查询考勤组成员信息\n --position 是否查询打卡地址\n --wifi 是否查询打卡 Wifi\n --bles 是否查询打卡蓝牙", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "group_filtered_get", "primary_cli_path": "attendance group filtered-get", "reviewed": true, "risk": "low", "title": "根据考勤组 ID 按需查询成员/打卡地址/蓝牙/Wifi 信息", "use_when": [ "只需要考勤组成员、打卡地址、蓝牙等部分字段，减少返回体积" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询考勤组完整详情", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "不知道考勤组ID时先用 attendance group search", "修改考勤组配置时使用 attendance group update", "只需要成员/地址等子集时使用 attendance group filtered-get" ], "canonical_path": "attendance.group_get", "cli_name": "get", "cli_path": "attendance group get", "confirmation": "not_required", "description": "调用 MCP 工具 get_group_detail，根据考勤组 ID 查询该考勤组的全量信息。\n--group-id 必填。如果只需查询成员、打卡地址、蓝牙、Wifi 子集，请使用 group filtered-get 以节省查询成本。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "group_get", "primary_cli_path": "attendance group get", "reviewed": true, "risk": "low", "title": "根据考勤组 ID 查询考勤组全量信息", "use_when": [ "已取得考勤组ID，需要查看完整配置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询考勤组列表", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "创建/修改考勤组时使用 attendance group create/update", "只需要部分字段时使用 attendance group filtered-get", "已知道考勤组ID并要看详情时使用 attendance group get" ], "canonical_path": "attendance.group_search", "cli_name": "search", "cli_path": "attendance group search", "confirmation": "not_required", "description": "根据当前用户的权限和筛选条件获取考勤组简要信息。\n入参 ATGroupSearchParam 对象（至少填写一个子字段）和 PageQuery 对象（两个子字段必填）均不能为空。\n --query 考勤组名称关键字，模糊搜索\n --type 考勤组类型：FIXED（固定班制）/ TURN（排班制）/ NONE（自由工时）\n --query-position 是否查询地理定位和 Wifi 名称（默认 false）\n --query-ble 是否查询蓝牙设备列表（默认 false）\n --page 页码（从 1 开始，默认 1）\n --limit 每页条数（200 以内，默认 20）", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "group_search", "primary_cli_path": "attendance group search", "reviewed": true, "risk": "low", "title": "查询当前用户可管理的考勤组列表", "use_when": [ "按权限或条件查看考勤组简要信息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新考勤组配置", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "创建新考勤组时使用 attendance group create", "只调整成员时使用 attendance group update-members", "查询考勤组详情时使用 attendance group get" ], "canonical_path": "attendance.group_update", "cli_name": "update", "cli_path": "attendance group update", "confirmation": "user_required", "description": "调用 MCP 工具 update_group_setting，更新考勤组配置信息。\n--group-id 必填；其余参数均可选，仅需对要修改的字段进行赋値，未传的字段会自动从已有配置补充。由于保存考勤组耗时较久，指令需要带上--timeout 10\n--yes 需要用户二次确认之后才允许带入，参考attendance.md中对于更新考勤组配置的说明\n\n常用简单字段可直接用 flag 传入；复杂子对象（如打卡地址、wifi、蓝牙设备、循环排班等）请用 --group-vo JSON 字符串传入完整 groupVO 对象覆写。\n\n常用 flag：\n --name 考勤组名称\n --type 考勤组类型：FIXED（固定班制）/ TURN（排班制）/ NONE（自由工时）\n --owner 考勤组主负责人 userId\n --classIds []number 所选班次 id 列表\n --enable-outside-check 是否允许外勤打卡 (true/false)\n --group-vo 完整 groupVO JSON 字符串（用于修改复杂子对象，会与其他 flag 合并，重复字段以 flag 为准）\n\n--group-vo 可用字段说明（均可选，只需包含要修改的字段）：\n\n【基础信息】\n id number 考勤组id，不随更新变化\n name string 考勤组名称\n type string 考勤组类型：FIXED（固定班制）/ TURN（排班制）/ NONE（自由工时）\n owner string 考勤组主负责人 userId\n managerList []string 考勤组子负责人 userId 列表\n skipHolidays bool 节假日自动排休（只有固定班制和自由工时考勤组生效）\n defaultGroup bool 是否默认考勤组\n classIds []number 所选班次 id 列表(只有固定班制和排班制才有班次，自由工时没有)\n\n【打卡范围与定位】\n trimDistance number 定位允许微调距离（米）\n enablePositionOfGps bool 打卡是否允许开启 GPS 定位\n enablePositionOfWifi bool 是否开启 wifi 定位\n enablePositionOfBle bool 是否启用蓝牙定位\n\n positions []object 考勤打卡地址列表（地址定位打卡用），每项字段：\n - title string 地址标题\n - address string 地址详情（完整地址文本）\n - latitude number 纬度\n - longitude number 经度\n - offset number 该地址允许的打卡范围，单位米\n\n wifis []object 打卡方式中的 wifi 详情列表，每项字段：\n - ssid string wifi 的 ssid（wifi名称）\n - macAddr string wifi 的 macAddr（MAC 地址）\n - groupId number 考勤组id\n\n bleDeviceVOList []object 已选择的蓝牙设备列表，每项字段：\n - name string 设备名称\n - deviceUid number 设备 uid\n - sn string 设备 sn 序列号\n - productType string 对外的设备类型\n - devServId number 内部设备类型\n\n【外勤打卡设置】\n enableOutsideCheck bool 是否可以外勤打卡\n enableOutsideCameraCheck bool 是否开启外勤打卡必须拍照\n enableOutsideRemark bool 是否开启外勤打卡必须填写备注\n enableOutsideApply bool 是否开启外勤打卡必须审批\n forbidHideOutSideAddress bool 禁止隐藏外勤打卡地址的功能，false表示允许用户隐藏外勤打卡地址\n enableOutSideUpdateNormalCheck bool 下班时间：允许外勤卡更新内勤卡\n enableOnDutyNormalUpdateOutsideCheck bool 上班时间：允许内勤卡更新外勤卡\n outsideCheckApproveMode string 外勤打卡需审批执行模式：\n NO_NEED_APPROVE（无需审批）\n APPROVE_FIRST（先审批后打卡）\n CHECK_FIRST（先打卡后审批）\n APPROVE_EVERYTIME（每次打卡都需要审批）\n outSideCheckApplyType number 外勤审批范围：1（全天外勤打卡）/ 2（上班外勤打卡）/ 3（下班外勤打卡）\n\n【打卡方式】\n enableCameraCheck bool 是否开启拍照打卡\n openCameraCheck bool 是否开启拍照打卡（与 enableCameraCheck 含义相同）\n openFaceCheck bool 是否开启人脸打卡\n enableFaceStrictMode bool 是否开启人脸严格模式（强制活体检测）\n enableFaceBeauty bool 是否开启美颜\n onlyMachineCheck bool 只允许考勤机打卡\n permitMaxBeaconCount number 允许绑定的智点设备数量\n disableCheckWhenRest bool 休息日打卡需审批（只在固定班制和排班制生效，true表示打卡需要提交审批单）\n\n\n【固定班制设置（FIXED）】\n defaultClassId number 固定班制的默认班次 id\n workDayClassList []number 固定班制的工作日班次 id 列表，一共7个值，分别代表周日到周六每天的班次id，为0表示当天休息，例如[0,1279240003,0,0,0,0,0]表示周一的班次id为1279240003，其余日子都是休息\n\n【排班制设置（TURN）】\n disableCheckWithoutSchedule bool 未排班时员工可打卡（true=未排班时禁止打卡）\n enableEmpSelectClass bool 未排班时，员工可选班次打卡\n enableScheduleAutoMatch bool 未排班时，系统自动匹配班次\n ----以下是排班制设置排班周期的，非必要，不是所有排班制考勤组都需要设置，不设置就是按照classIds中的班次由管理员自行排班-----\n cycleDays number 排班循环天数，支持大小周（14天）\n startCycleDate number 用户设置的大小周开始时间（时间戳，毫秒）\n cycleScheduleList []object 循环排班设置列表，每项字段：\n - cycleName string 周期名字（如\"第一周\"）\n - groupId number 考勤组 id\n - isValid string 是否有效：Y（有效）/ N（无效）\n - itemList []object 排班设置列表，每项字段：\n - classId number 班次 id\n - className string 班次名称\n - isValid string 是否有效（Y/N）\n\n【自由工时设置（NONE）】\n workDays []number 自由工时的工作日，如 [1,2,3,4,5] 表示周一到周五（1=周一，7=周日）\n freeCheckDayStartMinOffset number 自由打卡每日开始时间，距离 0 点的分钟数（如 480 表示 08:00 开始）\n freeCheckCoreTime number 自由工时考勤组的打卡最短工作时长（分钟）\n freeCheckDemandWorkMinutes number 自由工时考勤组要求的打卡时长（分钟）\n\n freeCheckSettingVO object 自由工时打卡设置，包含字段：\n - freeCheckType string 自由工时打卡类型：\n CYCLE（上下班交替打卡）\n MAX_TIME_UPDATE（最大时间打卡，第一次为上班，后续均为下班卡）\n - freeWorkDayLackSwitch bool 自由工时打卡规则：工作日没打卡记为缺卡（true=记缺卡）\n - freeOnDutyLackMinOffset number 自由工时打卡规则：上班缺卡生成时间偏移分钟数\n - freeOffDutyLackMinOffset number 自由工时打卡规则：下班缺卡生成时间偏移分钟数\n - delimitOffsetMinutesBetweenDays number 自由工时前后两天的分割线（距 0 点分钟数，超过此时间则归属第二天）\n - freeCheckGapVO object 自由工时/休息日打卡间隔设置：\n - onOffCheckGapMinutes number 上班打卡后，多久才可以打下班卡（分钟）\n - offOnCheckGapMinutes number 下班打卡后，多久才可以打上班卡（分钟）\n\n freeGroupSpecialDayVO object 自由工时考勤组特殊日期设置，包含字段：\n - specialOnDutyDays []number 特殊需要打卡日期的时间戳列表（毫秒，原本休息日需额外打卡的日期）\n - specialOffDutyDays []number 特殊无需打卡日期的时间戳列表（毫秒，原本工作日可免打卡的日期）", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "group_update", "primary_cli_path": "attendance group update", "reviewed": true, "risk": "high", "title": "更新考勤组配置（仅修改需要变更的字段）", "use_when": [ "需要修改已有考勤组的规则、班次、位置或范围" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "增删考勤组成员", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改考勤组规则配置时使用 attendance group update", "创建新考勤组时使用 attendance group create", "只查询成员信息时使用 attendance group filtered-get 或 group get" ], "canonical_path": "attendance.group_update_members", "cli_name": "update-members", "cli_path": "attendance group update-members", "confirmation": "user_required", "description": "调用 MCP 工具 update_group_member，对指定考勤组的成员进行增删操作。\n--group-id 必填；所有成员/部门参数均可选，但至少需要传一个变更项。由于保存考勤组耗时较久，指令需要带上--timeout 10\n每次调用各参数最多传 20 个 ID。\n--yes 需要用户二次确认之后才允许带入，参考attendance.md中对于更新考勤组成员的说明\n --add-users 添加考勤人员 userId 列表，逗号分隔\n --remove-users 删除考勤人员 userId 列表，逗号分隔\n --add-extra-users 添加无需考勤的人员 userId 列表，逗号分隔\n --remove-extra-users 删除无需考勤的成员 userId 列表，逗号分隔\n --add-depts 添加考勤部门 ID 列表，逗号分隔，若要添加全公司，根部门id为-1\n --remove-depts 删除考勤部门 ID 列表，逗号分隔，全公司根部门id为-1", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "group_update_members", "primary_cli_path": "attendance group update-members", "reviewed": true, "risk": "high", "title": "更新考勤组成员（添加/删除考勤人员、部门、无需考勤人员）", "use_when": [ "需要向考勤组添加或移除成员" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询单个加班规则详情", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "不知道加班规则ID时先用 attendance overtime search", "查询员工班次时使用 attendance shift list", "查询补卡规则详情时使用 attendance adjustment get" ], "canonical_path": "attendance.overtime_get", "cli_name": "get", "cli_path": "attendance overtime get", "confirmation": "not_required", "description": "调用 MCP 工具 get_overtime_rule_detail，根据加班规则主键 ID 查询对应的加班规则详情。\n--overtime-id 必填。已被删除或更新覆盖的加班规则也可以查到。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "overtime_get", "primary_cli_path": "attendance overtime get", "reviewed": true, "risk": "low", "title": "根据加班规则主键 ID 查询加班规则详情", "use_when": [ "已取得加班规则ID，需要查看规则详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询加班规则列表", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "已知道加班规则ID并要看详情时使用 attendance overtime get", "查询加班审批单记录时使用 attendance approve list", "查询补卡规则时使用 attendance adjustment search" ], "canonical_path": "attendance.overtime_search", "cli_name": "search", "cli_path": "attendance overtime search", "confirmation": "not_required", "description": "根据用户权限查询加班规则列表，入参封装在 ATRuleQueryParam 对象中。\n --query 加班规则名称关键字，模糊搜索（可选）\n --page 页码（从 1 开始，默认 1）（必填）\n --limit 每页条数（200 以内，默认 20）（必填）", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "overtime_search", "primary_cli_path": "attendance overtime search", "reviewed": true, "risk": "low", "title": "查询当前用户可管理的加班规则列表", "use_when": [ "需要查看可用加班规则或筛选加班规则" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询考勤组与考勤规则", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "需要全局或个人设置时使用 globalsetting/selfsetting get", "需要考勤组完整详情时使用 attendance group get", "需要补卡/加班规则时使用 attendance adjustment/overtime search" ], "canonical_path": "attendance.query_attendance_group_or_rules", "cli_name": "rules", "cli_path": "attendance rules", "confirmation": "not_required", "description": "查询考勤组/考勤规则：\"我属于哪个考勤组\"\"我们的打卡范围是什么\"\"弹性工时是怎么算的\"", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "attendance", "rpc_name": "query_attendance_group_or_rules" }, "metadata_source": "embedded-mcp-metadata", "name": "query_attendance_group_or_rules", "primary_cli_path": "attendance rules", "reviewed": true, "risk": "low", "title": "query_attendance_group_or_rules", "use_when": [ "需要查看当前可见的考勤组和规则概览" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询可查看的考勤报表字段", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查询个人考勤明细时使用 attendance record get", "查询假期数据时使用 attendance report query-leave", "查询报表数据时使用 attendance report query-data" ], "canonical_path": "attendance.report_columns", "cli_name": "columns", "cli_path": "attendance report columns", "confirmation": "not_required", "description": "根据操作者的列权限，过滤并返回其有权查看的考勤字段列表。\n操作者必须是管理员，否则返回权限错误。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "report_columns", "primary_cli_path": "attendance report columns", "reviewed": true, "risk": "low", "title": "获取企业考勤字段列表", "use_when": [ "查看操作者有权限查询的考勤报表字段" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询考勤报表数据", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查询个人单日明细时使用 attendance record get", "查询假期数据时使用 attendance report query-leave", "查询可用字段时先用 attendance report columns" ], "canonical_path": "attendance.report_query_data", "cli_name": "query-data", "cli_path": "attendance report query-data", "confirmation": "not_required", "description": "根据字段查询考勤数据，含列权限过滤和用户查看权限校验。\n--columns 为字段 ID 列表（逗号分隔），可通过 dws attendance report columns 获取。\n--users 最多 20 人，传入userId，--start 到 --end 不超过 32 天。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "report_query_data", "primary_cli_path": "attendance report query-data", "reviewed": true, "risk": "low", "title": "根据字段查询考勤数据", "use_when": [ "按字段查询考勤报表数据并进行权限过滤" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询假期报表数据", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查询假期余额变更记录时使用 attendance vacation records", "查询假期余额时使用 attendance vacation balance", "查询通用考勤报表时使用 attendance report query-data" ], "canonical_path": "attendance.report_query_leave", "cli_name": "query-leave", "cli_path": "attendance report query-leave", "confirmation": "not_required", "description": "查询用户假期数据，含用户查看权限校验。\n--leave-names 为假期类型名称列表（逗号分隔），不传则查询所有假期类型。\n--users 最多 20 人，传入userId，--start 到 --end 不超过 32 天。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "report_query_leave", "primary_cli_path": "attendance report query-leave", "reviewed": true, "risk": "low", "title": "查询用户假期数据", "use_when": [ "查询用户假期/请假相关报表数据" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询员工排班记录", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "导入或修改排班时使用 attendance schedule import", "批量查询员工班次结果时使用 attendance shift list", "查询班次定义时使用 attendance class get/search" ], "canonical_path": "attendance.schedule_get", "cli_name": "get", "cli_path": "attendance schedule get", "confirmation": "not_required", "description": "获取指定用户在一段时间内的排班记录。\n返回每条记录包含 userId、classId、workDate、className、checkBeginTime、checkEndTime 等字段。\n\n日期格式支持：\n - YYYY-MM-DD（如 2026-04-01）\n - YYYY-MM-DD HH:mm:ss（如 2026-04-01 09:00:00）\n\n示例：\n dws attendance schedule get --users user001,user002 --start 2026-04-01 --end 2026-04-30", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "schedule_get", "primary_cli_path": "attendance schedule get", "reviewed": true, "risk": "low", "title": "获取指定用户的排班记录", "use_when": [ "查询指定员工在日期范围内的排班记录" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "导入排班制考勤组排班记录", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "不确定 groupId/classId/workDate 时先查询考勤组和班次", "仅查看排班时使用 attendance schedule get 或 attendance shift list", "查询班次定义时使用 attendance class search/get" ], "canonical_path": "attendance.schedule_import", "cli_name": "import", "cli_path": "attendance schedule import", "confirmation": "user_required", "description": "为排班制考勤组导入排班记录。传入 JSON 数组格式排班数据，\n每条记录必填字段：\n - userId: 用户ID（必填）\n - workDate: 排班日期，格式 yyyy-MM-dd HH:mm:ss（必填）\n - classId: 班次ID（必填）\n - isRest: 是否为排休，取值 Y/N（必填）\n\n示例：\n dws attendance schedule import --groupId 123456 \\\n --scheduleVOS '[{\"userId\":\"user001\",\"workDate\":\"2026-04-22 09:00:00\",\"classId\":123,\"isRest\":\"N\"}]' \\\n --user-say-yes", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "schedule_import", "primary_cli_path": "attendance schedule import", "reviewed": true, "risk": "high", "title": "导入排班记录到排班制考勤组", "use_when": [ "需要批量导入或覆盖排班记录" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询个人考勤设置", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改个人设置时使用 attendance selfsetting save", "查询个人考勤记录时使用 attendance record get", "查询企业全局设置时使用 attendance globalsetting get" ], "canonical_path": "attendance.selfsetting_get", "cli_name": "get", "cli_path": "attendance selfsetting get", "confirmation": "not_required", "description": "查询个人规则设置，包括打卡提醒、极速打卡、打卡结果通知、缺卡提醒、个人考勤统计通知、团队考勤统计通知等设置项。\n\n入参字段:\n --setting-scene 查询设置项，枚举值包括：\n checkRemind（打卡提醒）\n fastCheck（极速打卡）\n checkResultNotify（打卡结果通知）\n lackRemind（缺卡提醒）\n personalAttendStatNotify（个人考勤统计通知）\n bossAttendStatNotify（团队考勤统计通知）\n --user 必填，查询用户 ID，对应 MCP 参数 userId\n\n说明：corpId 和 opUserId 由当前登录上下文自动补齐，不需要通过 CLI 入参传入。\n\n出参字段说明:\n 顶层返回 ServiceResult:\n success 请求是否成功\n code 请求结果码\n message 请求结果说明\n result 个人规则设置结果；服务端可能根据 --setting-scene 仅返回对应设置项相关字段\n\n result 通用字段:\n corpId 企业 ID\n userId 用户 ID\n\n settingScene=checkRemind（打卡提醒）相关字段:\n checkRemindSetting DING 提醒渠道设置\n checkRemindSetting.onDutyRemind 上班打卡提醒设置，包含 openRemind、remindMinutes(负数标识几分钟前提醒，正数几分钟后提醒)\n checkRemindSetting.offDutyRemind 下班打卡提醒设置，包含 openRemind、remindMinutes(负数标识几分钟前提醒，正数几分钟后提醒)\n checkRemindUserOnDuty 工作通知渠道：用户个人上班打卡提醒开关\n checkRemindUserOffDuty 工作通知渠道：用户个人下班打卡提醒开关\n enableOndutyCheckRemindOfPc PC 端弹窗渠道：上班打卡提醒开关\n enableOffdutyCheckRemindOfPc PC 端弹窗渠道：下班打卡提醒开关\n\n settingScene=fastCheck（极速打卡）相关字段:\n ondutyCheckType 上班打卡方式：1 提醒打卡，2 不提醒且不自动打卡，3 自动打卡\n ondutyRemindStartMin 上班打卡提醒开始时间，单位：分钟\n ondutyRemindEndMin 上班打卡提醒结束时间，单位：分钟\n fastCheckLateNeedConfirm 迟到时是否需要二次确认\n offdutyCheckType 下班打卡方式：1 提醒打卡，2 不提醒且不自动打卡，3 自动打卡\n offdutyRemindStartMin 下班打卡提醒开始时间，单位：分钟\n offdutyRemindEndMin 下班打卡提醒结束时间，单位：分钟\n canUpdateOffDuty 是否允许用户更新下班打卡设置\n voiceRemindSwitch 极速打卡提示音开关\n vibrationRemindSwitch 极速打卡震动提醒开关\n\n settingScene=checkResultNotify（打卡结果通知）相关字段:\n checkResultMsg 打卡结果通知开关：0 关闭，1 开启\n\n settingScene=lackRemind（缺卡提醒）相关字段:\n lackSendTodoMsg 待办提醒开关：0 关闭，null 或 1 开启\n lackRemindUser 工作通知渠道：用户个人缺卡提醒开关：0 关闭，null 或 1 开启\n\n settingScene=personalAttendStatNotify（个人考勤统计通知）相关字段:\n personDailyReportSwitch 日报推送开关：0 关闭，1 开启\n personWeekReportType 周报通知渠道：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮\n personMonthReportType 月报通知渠道：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮\n\n settingScene=bossAttendStatNotify（团队考勤统计通知）相关字段:\n bossPushStartMin 日报推送开始时间，单位：分钟；-1 表示关闭日报推送\n bossWeekReportType 周报通知渠道：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮\n bossMonthReportType 月报通知渠道：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "selfsetting_get", "primary_cli_path": "attendance selfsetting get", "reviewed": true, "risk": "low", "title": "查询个人规则设置", "use_when": [ "查看某个员工的个人打卡提醒、极速打卡、结果通知等设置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新个人考勤设置", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改企业全局设置时使用 attendance globalsetting save", "只查看个人设置时使用 attendance selfsetting get", "查询考勤记录时使用 attendance record get" ], "canonical_path": "attendance.selfsetting_save", "cli_name": "save", "cli_path": "attendance selfsetting save", "confirmation": "user_required", "description": "更新保存个人规则设置，包括打卡提醒、极速打卡、打卡结果通知、缺卡提醒、个人考勤统计通知、团队考勤统计通知等设置项。\n\n入参字段:\n --setting-scene 必填，枚举值包括 checkRemind、fastCheck、checkResultNotify、lackRemind、personalAttendStatNotify、bossAttendStatNotify\n --user 必填，更新用户 ID，对应 MCP 参数 userId\n\n按 settingScene 传入对应设置字段，且至少传一个字段：\n checkRemind:\n --check-remind-setting\n --check-remind-user-on-duty\n --check-remind-user-off-duty\n --enable-onduty-check-remind-of-pc\n --enable-offduty-check-remind-of-pc\n fastCheck:\n --onduty-check-type\n --offduty-check-type\n --onduty-remind-start-min\n --onduty-remind-end-min\n --offduty-remind-start-min\n --offduty-remind-end-min\n --fast-check-late-need-confirm\n --can-update-off-duty\n --voice-remind-switch\n --vibration-remind-switch\n checkResultNotify:\n --check-result-msg\n lackRemind:\n --lack-send-todo-msg\n --lack-remind-user\n personalAttendStatNotify:\n --person-daily-report-switch\n --person-week-report-type\n --person-month-report-type\n bossAttendStatNotify:\n --boss-push-start-min\n --boss-week-report-type\n --boss-month-report-type\n\n说明：corpId 和 opUserId 由当前登录上下文自动补齐，不需要通过 CLI 入参传入。\n返回 ServiceResult，包含 success、code、message、result；result 为 boolean，表示保存是否成功。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "selfsetting_save", "primary_cli_path": "attendance selfsetting save", "reviewed": true, "risk": "high", "title": "更新保存个人规则设置", "use_when": [ "需要修改员工个人打卡提醒、极速打卡或结果通知设置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询员工假期余额", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改余额时使用 attendance vacation save-balance", "查询假期余额变更明细时使用 attendance vacation records", "查询假期类型时使用 attendance vacation types" ], "canonical_path": "attendance.vacation_balance", "cli_name": "balance", "cli_path": "attendance vacation balance", "confirmation": "not_required", "description": "调用 MCP 工具 get_leave_balance_quota 查询指定员工的假期余额。\n例如：查询某员工年假还剩多少、病假额度等。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "vacation_balance", "primary_cli_path": "attendance vacation balance", "reviewed": true, "risk": "low", "title": "查询指定员工假期余额", "use_when": [ "查询指定员工的年假、调休等假期余额" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询假期余额变更记录", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改余额时使用 attendance vacation save-balance", "只看当前余额时使用 attendance vacation balance", "查询假期类型时使用 attendance vacation types" ], "canonical_path": "attendance.vacation_records", "cli_name": "records", "cli_path": "attendance vacation records", "confirmation": "not_required", "description": "调用 MCP 工具 get_leave_balance_records 查询指定员工的假期余额变更记录。\n例如：查询某员工年假变更历史、请假扣减记录等。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "vacation_records", "primary_cli_path": "attendance vacation records", "reviewed": true, "risk": "low", "title": "查询指定员工假期余额变更记录", "use_when": [ "查询员工假期余额的增减流水或变更历史" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "调整员工假期余额", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改假期类型/规则时使用 attendance vacation update-type", "只查询余额时使用 attendance vacation balance", "查询变更流水时使用 attendance vacation records" ], "canonical_path": "attendance.vacation_save_balance", "cli_name": "save-balance", "cli_path": "attendance vacation save-balance", "confirmation": "user_required", "description": "调用 MCP 工具 update_leave_balance 设置指定员工的假期余额数量。\n\n重要说明：这是设置（SET）接口，传入的值会替换当前余额，而不是增加（ADD）。\n\n参数说明：\n --target 目标员工工号（必填）\n --leave-code 假期编码（必填）\n --num 余额数量（必填，如8天传8，7.5天传7.5）\n --reason 变更原因（必填，最长100字符）\n --start 有效期开始日期 YYYY-MM-DD\n --end 有效期结束日期 YYYY-MM-DD\n --user-say-yes 用户已确认，跳过交互式确认提示（Agent 调用时传 true 前必须完成用户二次确认）\n\n注意：\n - 余额数量在传递给 MCP 时会自动乘以100（如8天传800，7.5天传750）\n - 此接口为 SET 操作：传入值会直接设置为新的余额，而非累加到现有余额", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "vacation_save_balance", "primary_cli_path": "attendance vacation save-balance", "reviewed": true, "risk": "high", "title": "设置员工假期余额", "use_when": [ "管理员需要修改指定员工的假期余额数量" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询可用假期类型", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改假期余额时使用 attendance vacation save-balance", "修改假期规则时使用 attendance vacation update-type", "查询员工假期余额时使用 attendance vacation balance" ], "canonical_path": "attendance.vacation_types", "cli_name": "types", "cli_path": "attendance vacation types", "confirmation": "not_required", "description": "调用 MCP 工具 get_leave_types 查询当前用户可用的假期规则列表。\n例如：年假、事假、病假等假期类型及对应规则。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "vacation_types", "primary_cli_path": "attendance vacation types", "reviewed": true, "risk": "low", "title": "查询当前用户假期规则列表", "use_when": [ "查看当前用户可用的假期规则/假期类型列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新假期类型规则", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "只查询假期类型时使用 attendance vacation types", "查询假期报表时使用 attendance report query-leave", "调整员工假期余额时使用 attendance vacation save-balance" ], "canonical_path": "attendance.vacation_update_type", "cli_name": "update-type", "cli_path": "attendance vacation update-type", "confirmation": "user_required", "description": "调用 MCP 工具 save_leave_type 更新已有假期规则。\n--leave-code 必填，指定要更新的假期规则编码。\n其他字段均为可选，仅需传入要修改的字段。\n\n参数说明：\n --leave-code 假期编码（必填）\n --name 假期名称（可选）\n --unit 假期单位：day/halfDay/hour（可选）\n --paid 是否带薪假期（可选）\n --per-hours 一天折算小时数（可选）\n --when-can-leave 新员工请假规则：entry/formal（可选）\n --visibility-rules 适用范围规则 JSON 数组（可选）\n --user-say-yes 用户已确认，跳过交互式确认提示（Agent 调用时传 true 前必须完成用户二次确认）\n\n--visibility-rules 适用范围语义（HSF 反序列化约定，必读）：\n - 不传：不修改原有可见范围。\n - 改为指定范围：传 [{\"type\":\"staff|dept|label|employee_type\",\"visible\":[\"id1\",\"id2\"]}, ...]，\n 每条规则 type 和 visible 都必须非空。\n - 改为全公司可见（哨兵约定）：必须显式传 [{\"type\":\"dept\",\"visible\":[\"-1\"]}]，\n 服务端识别后会落库为空可见范围（即全公司）。\n - 反例（CLI 会拦截报错，避免被服务端静默忽略）：\n * 空数组 []、[{}]、[{\"type\":\"dept\",\"visible\":[]}] 等被视为未传，不会生效为全公司可见；\n * 若要清空可见范围，必须显式传哨兵值 [\"-1\"]。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "vacation_update_type", "primary_cli_path": "attendance vacation update-type", "reviewed": true, "risk": "high", "title": "更新假期规则", "use_when": [ "管理员需要修改已有假期规则或假期类型配置" ] } ], "use_when": [ "考勤/打卡/排班" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.calendar.prod.json", "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "日历日程 / 会议室 / 闲忙查询", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "avoid_when": [ "明早 9 点提醒我提交周报；创建个人待办，但需先声明 reminder 边界" ], "description": "日历日程 / 会议室 / 闲忙", "id": "calendar", "name": "日历日程 / 会议室 / 闲忙", "runtime": true, "tool_count": 20, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "为日程添加附件。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“为日程添加附件。”所述变更时不要使用" ], "canonical_path": "calendar.add_attachments", "cli_name": "add", "cli_path": "calendar attachment add", "confirmation": "not_required", "description": "为日程添加附件。请先使用钉盘功能上传附件，得到文件id", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "add_attachments", "primary_cli_path": "calendar attachment add", "reviewed": false, "risk": "medium", "title": "添加日程附件", "use_when": [ "把附件挂到指定日程", "日程附件/给会议加文件/上传日程材料；添加" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "添加参与者", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“查看参与者”请改用 dws calendar attendee list", "要“移除参与者”请改用 dws calendar attendee delete" ], "canonical_path": "calendar.add_calendar_participant", "cli_name": "add", "cli_path": "calendar attendee add", "confirmation": "not_required", "description": "向已存在的指定日程添加参与者，支持批量添加多人，可设置参与者类型和通知方式", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "add_calendar_participant" }, "metadata_source": "embedded-mcp-metadata", "name": "add_calendar_participant", "primary_cli_path": "calendar attendee add", "risk": "medium", "title": "添加日程参与人", "use_when": [ "参会人/与会者；邀请/添加", "添加参会人（必须用 Step 1 返回的 eventId）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "预定会议室", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“会议室分组列表”请改用 dws calendar room list-groups", "要“查询 [startTime, endTime] 时间段内所有可用”请改用 dws calendar room search", "要“移除会议室”请改用 dws calendar room delete" ], "canonical_path": "calendar.add_meeting_room", "cli_name": "add", "cli_path": "calendar room add", "confirmation": "not_required", "description": "为日程(event)添加 会议室，完成会议室的预定", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "add_meeting_room" }, "metadata_source": "embedded-mcp-metadata", "name": "add_meeting_room", "primary_cli_path": "calendar room add", "risk": "medium", "title": "添加会议室", "use_when": [ "会议室/订会议室；给已有日程订会议室", "预定会议室" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除日程”请改用 dws calendar event delete", "要“查询当前用户指定日历本下的日程列表，按起止时间检索”请改用 dws calendar event list", "要“获取日程详情”请改用 dws calendar event get" ], "canonical_path": "calendar.create_calendar_event", "cli_name": "create", "cli_path": "calendar event create", "confirmation": "not_required", "description": "创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_calendar_event", "primary_cli_path": "calendar event create", "reviewed": false, "risk": "medium", "title": "创建日程", "use_when": [ "会议室/订会议室；创建新日程并订会议室", "创建日程 — 提取 eventId", "创建日程时直接指定参会人 + 会议室", "日程/会议/约会/日历；创建/约/给自己留时间块/个人日程", "给自己留一个明天下午的时间块/建个个人日程；创建个人日程" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除日程", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能”请改用 dws calendar event create", "要“查询当前用户指定日历本下的日程列表，按起止时间检索”请改用 dws calendar event list", "要“获取日程详情”请改用 dws calendar event get" ], "canonical_path": "calendar.delete_calendar_event", "cli_name": "delete", "cli_path": "calendar event delete", "confirmation": "user_required", "description": "删除指定日程，组织者删除将通知所有参与者，参与者删除仅从自己日历移除", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "delete_calendar_event" }, "metadata_source": "embedded-mcp-metadata", "name": "delete_calendar_event", "primary_cli_path": "calendar event delete", "risk": "high", "title": "删除指定日程", "use_when": [ "日程/会议/约会/日历；取消/删除" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "移除会议室", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“会议室分组列表”请改用 dws calendar room list-groups", "要“查询 [startTime, endTime] 时间段内所有可用”请改用 dws calendar room search", "要“预定会议室”请改用 dws calendar room add" ], "canonical_path": "calendar.delete_meeting_room", "cli_name": "delete", "cli_path": "calendar room delete", "confirmation": "user_required", "description": "移除日程中预约的会议室。\r\n1. 从日程中移除该会议室\r\n2. 释放该会议室预定记录", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "delete_meeting_room" }, "metadata_source": "embedded-mcp-metadata", "name": "delete_meeting_room", "primary_cli_path": "calendar room delete", "risk": "high", "title": "移除日程中的会议室", "use_when": [ "会议室/订会议室；取消预定" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据日历id查询指定日历的信息。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“搜索当前用户拥有的日历本，支持按日历本名模糊搜索”请改用 dws calendar book search", "要“查询用户的所有日历，其中id = \"primary\"为主日历（n”请改用 dws calendar book list" ], "canonical_path": "calendar.get_calendar", "cli_name": "get", "cli_path": "calendar book get", "confirmation": "not_required", "description": "根据日历id查询指定日历的信息。用户主日历本id固定为 \"primary\"", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_calendar", "primary_cli_path": "calendar book get", "reviewed": false, "risk": "low", "title": "查询指定日历信息", "use_when": [ "我有几个日历/查所有日历/别人共享给我的日历/他人共享给我的日历本；查指定日历本" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取日程详情", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能”请改用 dws calendar event create", "要“删除日程”请改用 dws calendar event delete", "要“查询当前用户指定日历本下的日程列表，按起止时间检索”请改用 dws calendar event list" ], "canonical_path": "calendar.get_calendar_detail", "cli_name": "get", "cli_path": "calendar event get", "confirmation": "not_required", "description": "根据eventId查询指定日程的明细。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "get_calendar_detail" }, "metadata_source": "embedded-mcp-metadata", "name": "get_calendar_detail", "primary_cli_path": "calendar event get", "risk": "low", "title": "查询日程详情", "use_when": [ "日程/会议/约会/日历；详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查看参与者", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加参与者”请改用 dws calendar attendee add", "要“移除参与者”请改用 dws calendar attendee delete" ], "canonical_path": "calendar.get_calendar_participants", "cli_name": "list", "cli_path": "calendar attendee list", "confirmation": "not_required", "description": "获取指定日程的所有参与者列表及其状态信息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "get_calendar_participants" }, "metadata_source": "embedded-mcp-metadata", "name": "get_calendar_participants", "primary_cli_path": "calendar attendee list", "risk": "low", "title": "获取日程参与人", "use_when": [ "参会人/与会者；查看" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "调用本接口，获取用户主日历的访问控制列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“调用本接口，获取用户主日历的访问控制列表。”" ], "canonical_path": "calendar.list_acls", "cli_name": "list", "cli_path": "calendar acl list", "confirmation": "not_required", "description": "调用本接口，获取用户主日历的访问控制列表。可查询用户的日历共享情况", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_acls", "primary_cli_path": "calendar acl list", "reviewed": false, "risk": "low", "title": "查询日历访问权限列表", "use_when": [ "我的日历共享给了谁/谁能看我日历/日历权限/取消共享/把日历分享给xxx；查看我共享出去的情况（即谁有权访问我的日历）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询当前用户指定日历本下的日程列表，按起止时间检索。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能”请改用 dws calendar event create", "要“删除日程”请改用 dws calendar event delete", "要“获取日程详情”请改用 dws calendar event get" ], "canonical_path": "calendar.list_calendar_events", "cli_name": "list", "cli_path": "calendar event list", "confirmation": "not_required", "description": "查询当前用户指定日历本下的日程列表，按起止时间检索。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_calendar_events", "primary_cli_path": "calendar event list", "reviewed": false, "risk": "low", "title": "查询当前用户日程列表", "use_when": [ "日程/会议/约会/日历；查看" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询用户的所有日历，其中id = \"primary\"为主日历（name = \"我的日历\"），为固定值。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“搜索当前用户拥有的日历本，支持按日历本名模糊搜索”请改用 dws calendar book search", "要“根据日历id查询指定日历的信息”请改用 dws calendar book get" ], "canonical_path": "calendar.list_calendars", "cli_name": "list", "cli_path": "calendar book list", "confirmation": "not_required", "description": "查询用户的所有日历，其中id = \"primary\"为主日历（name = \"我的日历\"），为固定值。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_calendars", "primary_cli_path": "calendar book list", "reviewed": false, "risk": "low", "title": "查询用户日历列表", "use_when": [ "我有几个日历/查所有日历/别人共享给我的日历/他人共享给我的日历本；列表", "查下xxx的日程安排；查询是否有共享关系" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "会议室分组列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询 [startTime, endTime] 时间段内所有可用”请改用 dws calendar room search", "要“移除会议室”请改用 dws calendar room delete", "要“预定会议室”请改用 dws calendar room add" ], "canonical_path": "calendar.list_meeting_room_groups", "cli_name": "list-groups", "cli_path": "calendar room list-groups", "confirmation": "not_required", "description": "分页查询当前企业下的会议室分组列表，返回每个分组的名称（groupName）、唯一 ID（groupId）及其父分组 ID（parentId，0 表示根分组）。结果按组织架构权限过滤，仅包含调用者有权限查看的分组。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "list_meeting_room_groups" }, "metadata_source": "embedded-mcp-metadata", "name": "list_meeting_room_groups", "primary_cli_path": "calendar room list-groups", "risk": "low", "title": "查询会议室分组列表", "use_when": [ "会议室/订会议室；分组" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据参会人推荐可用时间", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能”请改用 dws calendar event create", "要“删除日程”请改用 dws calendar event delete", "要“获取日程详情”请改用 dws calendar event get" ], "canonical_path": "calendar.list_suggested_event_times", "cli_name": "suggest", "cli_path": "calendar event suggest", "confirmation": "not_required", "description": "可根据参会人员的信息，推荐日程时间。用于日程时间未确定，解决会议时间协调问题。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "list_suggested_event_times" }, "metadata_source": "embedded-mcp-metadata", "name": "list_suggested_event_times", "primary_cli_path": "calendar event suggest", "risk": "low", "title": "建议日程时间", "use_when": [ "日程/会议/约会/日历；推荐时间/什么时候有空/协调时间" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询 [startTime, endTime] 时间段内所有可用的会议室。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“会议室分组列表”请改用 dws calendar room list-groups", "要“移除会议室”请改用 dws calendar room delete", "要“预定会议室”请改用 dws calendar room add" ], "canonical_path": "calendar.query_available_meeting_room", "cli_name": "search", "cli_path": "calendar room search", "confirmation": "not_required", "description": "查询 [startTime, endTime] 时间段内所有可用的会议室。要求整个时间段内都空闲且当前用户可预定。适用于有明确时间段要求的查询。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "query_available_meeting_room", "primary_cli_path": "calendar room search", "reviewed": false, "risk": "low", "title": "查询空闲会议室", "use_when": [ "会议室/订会议室；哪个空闲", "会议室/订会议室；按名找会议室（如「永澄亭」「永澄亭会议室」「约西湖厅」）", "搜索空闲会议室", "搜索空闲会议室，记下 roomId" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询用户闲忙状态", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询用户闲忙状态”" ], "canonical_path": "calendar.query_busy_status", "cli_name": "search", "cli_path": "calendar busy search", "confirmation": "not_required", "description": "可查询指定用户或者会议室在给定时间范围内的闲忙状态，返回已占用时间段的信息（注意只有时间信息）。结果受组织可见性策略控制：仅当调用者有权限查看该用户日历时方可获取有效数据。适用于安排会议前快速确认他人可用时间，或者查看指定会议室的预订状态。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "query_busy_status" }, "metadata_source": "embedded-mcp-metadata", "name": "query_busy_status", "primary_cli_path": "calendar busy search", "risk": "low", "title": "获取用户闲忙信息", "use_when": [ "同时查用户 + 会议室", "有空吗/忙不忙/闲忙；查询会议室闲忙", "有空吗/忙不忙/闲忙；查询用户闲忙", "有空吗/忙不忙/闲忙；用户 + 会议室一起查", "查会议室闲忙", "查用户闲忙" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "移除参与者", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“查看参与者”请改用 dws calendar attendee list", "要“添加参与者”请改用 dws calendar attendee add" ], "canonical_path": "calendar.remove_calendar_participant", "cli_name": "delete", "cli_path": "calendar attendee delete", "confirmation": "user_required", "description": "从已存在的指定日程中移除参与者，支持批量移除多人", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "remove_calendar_participant" }, "metadata_source": "embedded-mcp-metadata", "name": "remove_calendar_participant", "primary_cli_path": "calendar attendee delete", "risk": "high", "title": "删除日程参与人", "use_when": [ "参会人/与会者；移除" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "作为日程参会人，设置自己的响应状态（接受、拒绝、暂定）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能”请改用 dws calendar event create", "要“删除日程”请改用 dws calendar event delete", "要“获取日程详情”请改用 dws calendar event get" ], "canonical_path": "calendar.respond", "cli_name": "respond", "cli_path": "calendar event respond", "confirmation": "not_required", "description": "作为日程参会人，设置自己的响应状态（接受、拒绝、暂定）。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "respond", "primary_cli_path": "calendar event respond", "reviewed": false, "risk": "medium", "title": "响应日程", "use_when": [ "日程/会议/约会/日历；接受/拒绝/暂定日程" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "搜索当前用户拥有的日历本，支持按日历本名模糊搜索。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询用户的所有日历，其中id = \"primary\"为主日历（n”请改用 dws calendar book list", "要“根据日历id查询指定日历的信息”请改用 dws calendar book get" ], "canonical_path": "calendar.search_calendar", "cli_name": "search", "cli_path": "calendar book search", "confirmation": "not_required", "description": "搜索当前用户拥有的日历本，支持按日历本名模糊搜索。获取全部日历请使用list_calendars", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "search_calendar", "primary_cli_path": "calendar book search", "reviewed": false, "risk": "low", "title": "搜索日历本列表", "use_when": [ "我有几个日历/查所有日历/别人共享给我的日历/他人共享给我的日历本；按名称搜索日历本" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "修改现有日程的信息，支持更新标题、时间、地点等任意字段，需要组织者权限。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能”请改用 dws calendar event create", "要“删除日程”请改用 dws calendar event delete", "要“获取日程详情”请改用 dws calendar event get" ], "canonical_path": "calendar.update_calendar_event", "cli_name": "update", "cli_path": "calendar event update", "confirmation": "not_required", "description": "修改现有日程的信息，支持更新标题、时间、地点等任意字段，需要组织者权限。（修改参与人需要使用给日程添加参与人或给日程删除参与人工具）", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_calendar_event", "primary_cli_path": "calendar event update", "reviewed": false, "risk": "medium", "title": "修改日程", "use_when": [ "日程/会议/约会/日历；修改/改时间/改描述" ] } ], "use_when": [ "帮我建一个明天下午的日程；日历日程", "日程/日历/会议室/约会/时间建议" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json", "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "群聊 / 消息 / 机器人", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "avoid_when": [ "我发给某人的消息/邮件/文档/今天我干了什么；搜行为记录" ], "description": "群聊 / 消息 / 机器人", "id": "chat", "name": "群聊 / 消息 / 机器人", "runtime": true, "tool_count": 70, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "添加群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除群身份”请改用 dws chat group-role remove", "要“拉取会话的群身份”请改用 dws chat group-role list", "要“根据用户提供的群和成员为在群里查询成员的群身份”请改用 dws chat group-role query-user" ], "canonical_path": "chat.add_custom_group_role", "cli_name": "add", "cli_path": "chat group-role add", "confirmation": "not_required", "description": "添加群身份", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "add_custom_group_role" }, "metadata_source": "embedded-mcp-metadata", "name": "add_custom_group_role", "primary_cli_path": "chat group-role add", "reviewed": false, "risk": "medium", "use_when": [ "创建/添加群身份" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "消息添加 emoji 回应", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建并推送流式卡片”请改用 dws chat message send-card", "要“合并转发消息”请改用 dws chat message combine-forward", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.add_emoji_reaction", "cli_name": "add-emoji", "cli_path": "chat message add-emoji", "confirmation": "not_required", "description": "消息添加 emoji 回应", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "add_emoji_reaction" }, "metadata_source": "embedded-mcp-metadata", "name": "add_emoji_reaction", "primary_cli_path": "chat message add-emoji", "reviewed": false, "risk": "medium", "use_when": [ "emoji回应/表情回应/给消息加表情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "向群中添加成员", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“从群中移除成员”请改用 dws chat group members remove", "要“将机器人添加到群中”请改用 dws chat group members add-bot", "要“查看群成员列表”请改用 dws chat group members list" ], "canonical_path": "chat.add_group_member", "cli_name": "add", "cli_path": "chat group members add", "confirmation": "not_required", "description": "添加群成员", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "add_group_member" }, "metadata_source": "embedded-mcp-metadata", "name": "add_group_member", "primary_cli_path": "chat group members add", "risk": "medium", "title": "add_group_member", "use_when": [ "把张三拉进群；添加群成员", "拉人进群/加群成员" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将机器人添加到群中", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“从群中移除成员”请改用 dws chat group members remove", "要“向群中添加成员”请改用 dws chat group members add", "要“查看群成员列表”请改用 dws chat group members list" ], "canonical_path": "chat.add_robot_to_group", "cli_name": "add-bot", "cli_path": "chat group members add-bot", "confirmation": "not_required", "description": "将自定义机器人添加到当前用户有管理权限的群聊中。如果没有权限则会报错", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "bot", "rpc_name": "add_robot_to_group" }, "metadata_source": "embedded-mcp-metadata", "name": "add_robot_to_group", "primary_cli_path": "chat group members add-bot", "risk": "medium", "title": "将企业机器人添加我有权限的群中", "use_when": [ "加机器人到群", "邀请机器人进群" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "添加文字表情", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建并推送流式卡片”请改用 dws chat message send-card", "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji" ], "canonical_path": "chat.add_text_emotion", "cli_name": "add-text-emotion", "cli_path": "chat message add-text-emotion", "confirmation": "not_required", "description": "添加文字表情", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "add_text_emotion" }, "metadata_source": "embedded-mcp-metadata", "name": "add_text_emotion", "primary_cli_path": "chat message add-text-emotion", "reviewed": false, "risk": "medium", "use_when": [ "文字表情回应/添加文字表情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "合并转发消息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建并推送流式卡片”请改用 dws chat message send-card", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.combine_forward_messages", "cli_name": "combine-forward", "cli_path": "chat message combine-forward", "confirmation": "not_required", "description": "合并转发消息", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "combine_forward_messages" }, "metadata_source": "embedded-mcp-metadata", "name": "combine_forward_messages", "primary_cli_path": "chat message combine-forward", "reviewed": false, "risk": "medium", "use_when": [ "合并转发/批量转发/合并转发多条消息", "合并转发/批量转发/合并转发多条消息；合并转发多条消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建并推送流式卡片", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.create_and_send_card", "cli_name": "send-card", "cli_path": "chat message send-card", "confirmation": "not_required", "description": "创建并推送流式卡片", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "create_and_send_card" }, "metadata_source": "embedded-mcp-metadata", "name": "create_and_send_card", "primary_cli_path": "chat message send-card", "reviewed": false, "risk": "medium", "title": "create_and_send_card", "use_when": [ "发卡片消息/推送流式卡片；创建并推送流式卡片" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建一个群聊，支持指定群名称、初始成员列表等参数。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“获取群邀请链接”请改用 dws chat group invite-url", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.create_group_conversation", "cli_name": "create", "cli_path": "chat group create", "confirmation": "not_required", "description": "创建一个群聊，支持指定群名称、初始成员列表等参数。可选择内部群/外部群/普通群/内部话题圈/外部话题圈/普通话题圈。默认为内部群。当选择内部群时如果所选成员非组织内成员会创建失败，创建成功后会返回。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "create_group_conversation" }, "metadata_source": "embedded-mcp-metadata", "name": "create_group_conversation", "primary_cli_path": "chat group create", "reviewed": false, "risk": "medium", "title": "create_group_conversation", "use_when": [ "帮我建一个项目群；创建群聊", "建群/创建群聊" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建按群名称关键词或群成员自动匹配会话的智能分组", "agent_summary_source": "agent-selection-contract-v1", "availability": "available", "avoid_when": [ "只需要普通静态会话分组，或不希望根据关键词和成员自动匹配会话时不要使用" ], "canonical_path": "chat.create_smart_conv_category", "cli_name": "create-smart", "cli_path": "chat category create-smart", "confirmation": "not_required", "description": "创建智能会话分组，可指定群名称关键词和群内成员 openDingTalkId 作为匹配规则。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "create_smart_conv_category" }, "name": "create_smart_conv_category", "primary_cli_path": "chat category create-smart", "reviewed": true, "risk": "medium", "title": "创建智能会话分组", "use_when": [ "需要按群名称关键词或群成员自动归类会话时创建智能会话分组" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建文字表情", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.create_text_emotion", "cli_name": "create-text-emotion", "cli_path": "chat message create-text-emotion", "confirmation": "not_required", "description": "创建文字表情", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "create_text_emotion" }, "metadata_source": "embedded-mcp-metadata", "name": "create_text_emotion", "primary_cli_path": "chat message create-text-emotion", "reviewed": false, "risk": "medium", "use_when": [ "创建文字表情/新建文字表情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "解散群聊", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“获取群邀请链接”请改用 dws chat group invite-url" ], "canonical_path": "chat.dismiss_group", "cli_name": "dismiss", "cli_path": "chat group dismiss", "confirmation": "not_required", "description": "解散群聊", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "dismiss_group" }, "metadata_source": "embedded-mcp-metadata", "name": "dismiss_group", "primary_cli_path": "chat group dismiss", "reviewed": false, "risk": "medium", "use_when": [ "解散群/解散群聊", "解散群/解散群聊；解散群聊" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "下载聊天消息中的图片/视频/语音等资源到本地文件", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.download_media", "cli_name": "download-media", "cli_path": "chat message download-media", "confirmation": "not_required", "description": "下载聊天消息中的图片、视频、语音等资源到本地文件。\n\n流程:\n 1. 根据 resourceType + resource-id + message-id + open-conversation-id 向服务端获取下载 URL\n 2. HTTP GET 下载文件到本地\n\n--output 指定本地保存路径，可以是文件路径或目录。\n如果指定目录，文件名从下载 URL 中自动推断。默认保存到当前目录。", "effect": "read", "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "name": "download_media", "primary_cli_path": "chat message download-media", "reviewed": true, "risk": "low", "title": "下载消息中的资源（图片/视频/语音等）到本地", "use_when": [ "下载聊天消息中的图片/视频/语音等资源到本地文件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "单条消息转发", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.forward_message", "cli_name": "forward", "cli_path": "chat message forward", "confirmation": "not_required", "description": "单条消息转发", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "forward_message" }, "metadata_source": "embedded-mcp-metadata", "name": "forward_message", "primary_cli_path": "chat message forward", "reviewed": false, "risk": "medium", "use_when": [ "转发消息/把消息转到另一个群；转发单条消息", "转发消息/转发一条消息/把消息转发到另一个群" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "转发某个话题到其他会话", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.forward_topic", "cli_name": "forward-topic", "cli_path": "chat message forward-topic", "confirmation": "not_required", "description": "转发某个话题到其他会话", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "forward_topic" }, "metadata_source": "embedded-mcp-metadata", "name": "forward_topic", "primary_cli_path": "chat message forward-topic", "reviewed": false, "risk": "medium", "use_when": [ "转发话题/转发话题消息", "转发话题/转发话题消息/话题转发到另一个群；转发话题消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据群号获取群聊信息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“获取群邀请链接”请改用 dws chat group invite-url", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.get_conv_info_by_group_id", "cli_name": "get-by-group-id", "cli_path": "chat group get-by-group-id", "confirmation": "not_required", "description": "根据群号获取群聊信息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "get_conv_info_by_group_id" }, "metadata_source": "embedded-mcp-metadata", "name": "get_conv_info_by_group_id", "primary_cli_path": "chat group get-by-group-id", "reviewed": false, "risk": "low", "use_when": [ "根据群号查群信息/群号查群/群号转openConversationId", "根据群号查群信息/群号转openConversationId；群号查群聊信息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取会话的基础信息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取会话的基础信息”" ], "canonical_path": "chat.get_conversation_info", "cli_name": "conversation-info", "cli_path": "chat conversation-info", "confirmation": "not_required", "description": "获取会话的基础信息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_conversation_info", "primary_cli_path": "chat conversation-info", "reviewed": false, "risk": "low", "title": "get_conversation_info", "use_when": [ "获取会话的基础信息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取群邀请链接", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.get_group_invite_url", "cli_name": "invite-url", "cli_path": "chat group invite-url", "confirmation": "not_required", "description": "获取群邀请链接", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "get_group_invite_url" }, "metadata_source": "embedded-mcp-metadata", "name": "get_group_invite_url", "primary_cli_path": "chat group invite-url", "reviewed": false, "risk": "low", "use_when": [ "群邀请链接/入群链接/加群链接" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拉取指定群聊的会话消息内容", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.list_conversation_message_v2", "cli_name": "list", "cli_path": "chat message list", "confirmation": "not_required", "description": "拉取指定群聊的会话消息内容", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_conversation_message_v2", "primary_cli_path": "chat message list", "reviewed": false, "risk": "low", "title": "list_conversation_message_v2", "use_when": [ "2. 拉取群消息", "和某人的单聊聊天记录/拉某人单聊历史", "拉取一下上周项目群的聊天记录；拉取会话消息", "拉取和张三的单聊记录；拉取单聊消息", "拉取和某人的单聊记录/单聊消息", "某个群的聊天记录", "聊天记录/会话消息/拉取会话" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拉取用户指定自定义会话分组下的会话", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“获取用户自定义会话分组”请改用 dws chat category list" ], "canonical_path": "chat.list_conversations_by_category", "cli_name": "list-conversations", "cli_path": "chat category list-conversations", "confirmation": "not_required", "description": "拉取用户指定自定义会话分组下的会话", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "list_conversations_by_category" }, "metadata_source": "embedded-mcp-metadata", "name": "list_conversations_by_category", "primary_cli_path": "chat category list-conversations", "reviewed": false, "risk": "low", "title": "list_conversations_by_category", "use_when": [ "某个分组下有哪些会话；分组下会话列表", "某个分组下的会话/分组会话列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拉取会话的群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除群身份”请改用 dws chat group-role remove", "要“根据用户提供的群和成员为在群里查询成员的群身份”请改用 dws chat group-role query-user", "要“添加群身份”请改用 dws chat group-role add" ], "canonical_path": "chat.list_custom_group_roles", "cli_name": "list", "cli_path": "chat group-role list", "confirmation": "not_required", "description": "拉取会话的群身份", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "list_custom_group_roles" }, "metadata_source": "embedded-mcp-metadata", "name": "list_custom_group_roles", "primary_cli_path": "chat group-role list", "reviewed": false, "risk": "low", "use_when": [ "查看群身份/群的自定义身份列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取群内所有机器人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.list_group_bots", "cli_name": "bots", "cli_path": "chat group bots", "confirmation": "not_required", "description": "获取群内所有机器人", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "bot", "rpc_name": "list_group_bots" }, "metadata_source": "embedded-mcp-metadata", "name": "list_group_bots", "primary_cli_path": "chat group bots", "reviewed": false, "risk": "low", "title": "list_group_bots", "use_when": [ "群机器人列表/群里有哪些机器人/查看群机器人", "群里有哪些机器人/查看群机器人/列出群机器人；查看群内机器人列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拉取指定用户的单聊会话消息内容", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.list_individual_chat_message", "cli_name": "list-direct", "cli_path": "chat message list-direct", "confirmation": "not_required", "description": "拉取指定用户的单聊会话消息内容", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_individual_chat_message", "primary_cli_path": "chat message list-direct", "reviewed": false, "risk": "low", "title": "list_individual_chat_message", "use_when": [ "拉取指定用户的单聊会话消息内容" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量查消息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.list_messages_by_ids", "cli_name": "list-by-ids", "cli_path": "chat message list-by-ids", "confirmation": "not_required", "description": "批量查消息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "list_messages_by_ids" }, "metadata_source": "embedded-mcp-metadata", "name": "list_messages_by_ids", "primary_cli_path": "chat message list-by-ids", "reviewed": false, "risk": "low", "use_when": [ "批量查消息/按ID查消息/根据消息ID查" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拉取我创建/管理的群", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.list_owned_or_admin_groups", "cli_name": "list-my-groups", "cli_path": "chat group list-my-groups", "confirmation": "not_required", "description": "拉取我创建/管理的群", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "list_owned_or_admin_groups" }, "metadata_source": "embedded-mcp-metadata", "name": "list_owned_or_admin_groups", "primary_cli_path": "chat group list-my-groups", "reviewed": false, "risk": "low", "use_when": [ "我创建的群/我管理的群/我是群主的群/我当管理员的群", "我创建的群/我管理的群/我是群主的群/我当管理员的群；拉取我创建/管理的群" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拉取会话中钉住的(pin)消息列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.list_pin_messages", "cli_name": "list-pin-msg", "cli_path": "chat message list-pin-msg", "confirmation": "not_required", "description": "拉取会话中钉住的(pin)消息列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "list_pin_messages" }, "metadata_source": "embedded-mcp-metadata", "name": "list_pin_messages", "primary_cli_path": "chat message list-pin-msg", "reviewed": false, "risk": "low", "title": "拉取会话中钉住的消息列表", "use_when": [ "查看钉住的消息/Pin列表/钉住消息列表；拉取钉住消息列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拉取特别关注人的消息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.list_special_focus_messages", "cli_name": "list-focused", "cli_path": "chat message list-focused", "confirmation": "not_required", "description": "拉特别关注人的消息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "list_special_focus_messages" }, "metadata_source": "embedded-mcp-metadata", "name": "list_special_focus_messages", "primary_cli_path": "chat message list-focused", "risk": "low", "title": "list_special_focus_messages", "use_when": [ "我特别关注的人最近发了什么消息/关注的人最近聊了啥/星标联系人最近的动态", "特别关注人的消息/关注的人的消息/星标联系人的消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拉取用户的置顶会话", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "所有会话/全部会话列表/我的会话；分页获取全部会话", "置顶会话/取消置顶；设置/取消会话置顶" ], "canonical_path": "chat.list_top_conversations", "cli_name": "list-top-conversations", "cli_path": "chat list-top-conversations", "confirmation": "not_required", "description": "拉取用户的置顶会话", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_top_conversations", "primary_cli_path": "chat list-top-conversations", "reviewed": false, "risk": "low", "title": "list_top_conversations", "use_when": [ "置顶会话/置顶消息", "置顶会话/置顶消息/我的置顶/查看置顶" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拉取群话题回复消息列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.list_topic_replies", "cli_name": "list-topic-replies", "cli_path": "chat message list-topic-replies", "confirmation": "not_required", "description": "针对话题群中的单个话题，分页拉取话题的回复消息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "list_topic_replies" }, "metadata_source": "embedded-mcp-metadata", "name": "list_topic_replies", "primary_cli_path": "chat message list-topic-replies", "risk": "low", "title": "list_topic_replies", "use_when": [ "群里某条话题的回复", "话题回复/群话题消息回复/拉取话题回复" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取用户自定义会话分组", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“拉取用户指定自定义会话分组下的会话”请改用 dws chat category list-conversations" ], "canonical_path": "chat.list_user_define_conv_categories", "cli_name": "list", "cli_path": "chat category list", "confirmation": "not_required", "description": "获取用户自定义会话分组", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "list_user_define_conv_categories" }, "metadata_source": "embedded-mcp-metadata", "name": "list_user_define_conv_categories", "primary_cli_path": "chat category list", "reviewed": false, "risk": "low", "use_when": [ "查看会话分组/自定义分组", "查看会话分组/自定义分组；获取会话分组" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据用户提供的群和成员为在群里查询成员的群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除群身份”请改用 dws chat group-role remove", "要“拉取会话的群身份”请改用 dws chat group-role list", "要“添加群身份”请改用 dws chat group-role add" ], "canonical_path": "chat.query_custom_user_roles", "cli_name": "query-user", "cli_path": "chat group-role query-user", "confirmation": "not_required", "description": "根据用户提供的群和成员为在群里查询成员的群身份", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "query_custom_user_roles" }, "metadata_source": "embedded-mcp-metadata", "name": "query_custom_user_roles", "primary_cli_path": "chat group-role query-user", "reviewed": false, "risk": "low", "title": "查询群成员的群身份", "use_when": [ "查询某人的群身份/某人在群里有什么身份" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询以当前用户的身份发送的消息的发送状态", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.query_message_send_status", "cli_name": "query-send-status", "cli_path": "chat message query-send-status", "confirmation": "not_required", "description": "查询以当前用户的身份发送的消息的发送状态", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "query_message_send_status" }, "metadata_source": "embedded-mcp-metadata", "name": "query_message_send_status", "primary_cli_path": "chat message query-send-status", "reviewed": false, "risk": "low", "use_when": [ "查询消息发送状态/消息发没发成功/消息状态", "消息发没发成功/查询消息发送状态；查询消息发送状态" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询消息的已读/未读状态", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.query_msg_read_status", "cli_name": "read-status", "cli_path": "chat message read-status", "confirmation": "not_required", "description": "查询消息的已读/未读状态", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "query_msg_read_status" }, "metadata_source": "embedded-mcp-metadata", "name": "query_msg_read_status", "primary_cli_path": "chat message read-status", "reviewed": false, "risk": "low", "use_when": [ "消息已读未读/谁看了消息/查读状态/消息读取状态", "谁看了这条消息/消息已读未读/查读状态；查询消息已读状态" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "用户退群", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.quit_group", "cli_name": "quit", "cli_path": "chat group quit", "confirmation": "not_required", "description": "用户退群", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "quit_group" }, "metadata_source": "embedded-mcp-metadata", "name": "quit_group", "primary_cli_path": "chat group quit", "reviewed": false, "risk": "medium", "use_when": [ "退群/退出群聊/离开群；退出群聊" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "撤回用户发送的消息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.recall_message", "cli_name": "recall", "cli_path": "chat message recall", "confirmation": "user_required", "description": "撤回用户发送的消息", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "recall_message" }, "metadata_source": "embedded-mcp-metadata", "name": "recall_message", "primary_cli_path": "chat message recall", "reviewed": false, "risk": "high", "use_when": [ "撤回我发的消息/撤回消息", "撤回我发的消息/撤回消息；撤回个人消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "机器人撤回消息（--group 群聊 / 不传为单聊）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.recall_robot_message", "cli_name": "recall-by-bot", "cli_path": "chat message recall-by-bot", "confirmation": "user_required", "description": "群聊：传 --group 与 --keys；单聊：仅传 --keys。--keys 为发送时返回的 processQueryKey 列表，逗号分隔。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "name": "recall_robot_message", "primary_cli_path": "chat message recall-by-bot", "reviewed": true, "risk": "high", "title": "机器人撤回消息（--group 群聊 / 不传为单聊）", "use_when": [ "撤回机器人发的消息/机器人撤回消息", "机器人撤回消息（--group 群聊 / 不传为单聊）", "用同一个 robot-code + processQueryKey 撤回" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“拉取会话的群身份”请改用 dws chat group-role list", "要“根据用户提供的群和成员为在群里查询成员的群身份”请改用 dws chat group-role query-user", "要“添加群身份”请改用 dws chat group-role add" ], "canonical_path": "chat.remove_custom_group_role", "cli_name": "remove", "cli_path": "chat group-role remove", "confirmation": "user_required", "description": "删除群身份", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "remove_custom_group_role" }, "metadata_source": "embedded-mcp-metadata", "name": "remove_custom_group_role", "primary_cli_path": "chat group-role remove", "reviewed": false, "risk": "high", "use_when": [ "删除群身份" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "移除用户的群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“拉取会话的群身份”请改用 dws chat group-role list", "要“根据用户提供的群和成员为在群里查询成员的群身份”请改用 dws chat group-role query-user", "要“添加群身份”请改用 dws chat group-role add" ], "canonical_path": "chat.remove_custom_user_roles", "cli_name": "remove-user", "cli_path": "chat group-role remove-user", "confirmation": "user_required", "description": "移除用户的群身份", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "remove_custom_user_roles" }, "metadata_source": "embedded-mcp-metadata", "name": "remove_custom_user_roles", "primary_cli_path": "chat group-role remove-user", "reviewed": false, "risk": "high", "use_when": [ "移除某人的群身份/撤销群身份" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "消息删除emoji回应", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.remove_emoji_reaction", "cli_name": "remove-emoji", "cli_path": "chat message remove-emoji", "confirmation": "not_required", "description": "消息删除emoji回应", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "remove_emoji_reaction" }, "metadata_source": "embedded-mcp-metadata", "name": "remove_emoji_reaction", "primary_cli_path": "chat message remove-emoji", "reviewed": false, "risk": "medium", "use_when": [ "取消emoji回应/移除表情回应" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "从群中移除成员", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“向群中添加成员”请改用 dws chat group members add", "要“将机器人添加到群中”请改用 dws chat group members add-bot", "要“查看群成员列表”请改用 dws chat group members list" ], "canonical_path": "chat.remove_group_member", "cli_name": "remove", "cli_path": "chat group members remove", "confirmation": "user_required", "description": "移除群成员", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "remove_group_member" }, "metadata_source": "embedded-mcp-metadata", "name": "remove_group_member", "primary_cli_path": "chat group members remove", "risk": "high", "title": "remove_group_member", "use_when": [ "踢人/移除群成员" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "从群内移除机器人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“向群中添加成员”请改用 dws chat group members add", "要“将机器人添加到群中”请改用 dws chat group members add-bot", "要“查看群成员列表”请改用 dws chat group members list" ], "canonical_path": "chat.remove_robot_in_group", "cli_name": "remove-bot", "cli_path": "chat group members remove-bot", "confirmation": "user_required", "description": "从群内移除机器人", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "bot", "rpc_name": "remove_robot_in_group" }, "metadata_source": "embedded-mcp-metadata", "name": "remove_robot_in_group", "primary_cli_path": "chat group members remove-bot", "reviewed": false, "risk": "high", "title": "remove_robot_in_group", "use_when": [ "从群里移除机器人/踢出机器人", "从群里移除机器人/踢机器人；移除群内机器人" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除文字表情", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.remove_text_emotion", "cli_name": "remove-text-emotion", "cli_path": "chat message remove-text-emotion", "confirmation": "not_required", "description": "删除文字表情", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "remove_text_emotion" }, "metadata_source": "embedded-mcp-metadata", "name": "remove_text_emotion", "primary_cli_path": "chat message remove-text-emotion", "reviewed": false, "risk": "medium", "use_when": [ "取消文字表情回应/移除文字表情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "以当前用户身份引用一条已有消息并回复", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.reply_personal_message", "cli_name": "reply", "cli_path": "chat message reply", "confirmation": "not_required", "description": "以用户身份发消息，支持多种消息类型", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "send_personal_message" }, "metadata_source": "embedded-mcp-metadata", "name": "reply_personal_message", "prerequisites": [ "已取得会话 ID、原消息 ID 和原消息发送者 openDingTalkId" ], "primary_cli_path": "chat message reply", "reviewed": true, "risk": "medium", "tips": [ "发送前确认引用消息、接收会话和回复内容" ], "title": "send_personal_message", "use_when": [ "引用回复/回复消息/引用消息回复", "引用消息回复/回复那条消息；引用回复消息", "需要保留被回复消息的引用关系" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拉取 @我 的消息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.search_at_me_message", "cli_name": "list-mentions", "cli_path": "chat message list-mentions", "confirmation": "not_required", "description": "搜索at自己的消息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "search_at_me_message" }, "metadata_source": "embedded-mcp-metadata", "name": "search_at_me_message", "primary_cli_path": "chat message list-mentions", "risk": "low", "title": "search_at_me_message", "use_when": [ "@我的消息/at我的/提及我的", "@我的消息/提及我的", "谁@了我/查看提及我的消息；查询@我的消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "搜索机器人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“搜索我创建的机器人”请改用 dws chat bot search" ], "canonical_path": "chat.search_bots", "cli_name": "find", "cli_path": "chat bot find", "confirmation": "not_required", "description": "搜索机器人", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "bot", "rpc_name": "search_bots" }, "metadata_source": "embedded-mcp-metadata", "name": "search_bots", "primary_cli_path": "chat bot find", "reviewed": false, "risk": "low", "title": "search_bots", "use_when": [ "搜索机器人 — 提取 openDingTalkId（必须用 find，search 没有此字段）", "搜索机器人/找机器人/查机器人/帮我找XXX机器人", "搜索机器人/找机器人/查机器人/帮我找XXX机器人；搜索全部可用机器人", "给机器人发单聊/给机器人发消息/跟机器人聊天", "给机器人发单聊/给机器人发消息/跟机器人聊天；给机器人发单聊消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "搜索共同群（指定昵称列表，查询共同所在的群聊）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“搜索共同群（指定昵称列表，查询共同所在的群聊）”" ], "canonical_path": "chat.search_common_groups", "cli_name": "search-common", "cli_path": "chat search-common", "confirmation": "not_required", "description": "通过人员名称搜索共同群聊", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "search_common_groups" }, "metadata_source": "embedded-mcp-metadata", "name": "search_common_groups", "primary_cli_path": "chat search-common", "risk": "low", "title": "search_common_groups", "use_when": [ "我和XX的共同群/我们都在哪些群/查共同群", "我和某人的共同群", "我和风雷的共同群/我们都在哪些群；搜索共同群" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据名称搜索会话列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "我创建的群/我管理的群/我是群主的群/我当管理员的群；拉取我创建/管理的群", "我和风雷的共同群/我们都在哪些群；搜索共同群", "搜一下消息里的changefree链接；消息搜索", "根据群号查群信息/群号转openConversationId；群号查群聊信息" ], "canonical_path": "chat.search_groups", "cli_name": "search", "cli_path": "chat search", "confirmation": "not_required", "description": "根据群名称关键词，搜索符合条件的群，返回群的openconversion_id、群名称等信息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "search_groups_by_keyword" }, "metadata_source": "embedded-mcp-metadata", "name": "search_groups", "primary_cli_path": "chat search", "risk": "low", "title": "search_groups_by_keyword", "use_when": [ "1. 搜索群 — 提取 openconversation_id", "搜索群/找群" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "搜索消息，支持多种维度：时间范围、关键词、发送者、at我的、at指定用户、会话", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.search_messages", "cli_name": "search-advanced", "cli_path": "chat message search-advanced", "confirmation": "not_required", "description": "搜索消息，支持多种维度：时间范围、关键词、发送者、at我的、at指定用户、会话", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "search_messages" }, "metadata_source": "embedded-mcp-metadata", "name": "search_messages", "primary_cli_path": "chat message search-advanced", "reviewed": false, "risk": "low", "title": "搜索消息", "use_when": [ "多维度搜索/按发送者搜索/按人搜消息/指定多个群搜索/@我的消息搜索", "按发送者搜索/指定多个群搜索/多维度搜消息；多维度搜索消息", "搜一下消息里的changefree链接；消息搜索", "搜索消息/查找关键词/搜一下消息里的XX", "搜索消息里的关键词/包含XX的消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "按关键词搜索消息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.search_messages_by_keyword", "cli_name": "search", "cli_path": "chat message search", "confirmation": "not_required", "description": "按关键词搜索消息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "search_messages_by_keyword" }, "metadata_source": "embedded-mcp-metadata", "name": "search_messages_by_keyword", "primary_cli_path": "chat message search", "risk": "low", "title": "search_messages_by_keyword", "use_when": [ "按关键词搜索消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拉取指定发送者的消息（含单聊 / 群聊；两者互斥）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.search_messages_by_sender", "cli_name": "list-by-sender", "cli_path": "chat message list-by-sender", "confirmation": "not_required", "description": "根据发送者拉消息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "search_messages_by_sender" }, "metadata_source": "embedded-mcp-metadata", "name": "search_messages_by_sender", "primary_cli_path": "chat message list-by-sender", "risk": "low", "title": "search_messages_by_sender", "use_when": [ "某人发给我的消息/指定发送者/某人的消息", "某人发给我的消息/指定发送者的消息/某人最近的消息", "看看张三发给我的消息；按发送者查询消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拉取指定时间范围内当前用户的所有会话消息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.search_messages_by_time_range", "cli_name": "list-all", "cli_path": "chat message list-all", "confirmation": "not_required", "description": "根据指定时间范围，分页搜索历史消息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "search_messages_by_time_range" }, "metadata_source": "embedded-mcp-metadata", "name": "search_messages_by_time_range", "primary_cli_path": "chat message list-all", "risk": "low", "title": "search_messages_by_time_range", "use_when": [ "我最近所有消息/我今天的消息", "所有消息/全部会话消息/拉取全部消息/时间范围内消息/我的消息/我今天的消息/查我的钉钉消息/最近的消息", "查看我今天的所有消息；全量会话消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "搜索我创建的机器人", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“搜索机器人”请改用 dws chat bot find" ], "canonical_path": "chat.search_my_robots", "cli_name": "search", "cli_path": "chat bot search", "confirmation": "not_required", "description": "搜索我创建的机器人，可获取机器人robotCode等信息。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "bot", "rpc_name": "search_my_robots" }, "metadata_source": "embedded-mcp-metadata", "name": "search_my_robots", "primary_cli_path": "chat bot search", "risk": "low", "title": "搜索我创建的企业机器人", "use_when": [ "我创建的机器人/我的机器人/我自己的机器人/查看我的机器人", "我创建的机器人/我的机器人/我自己的机器人/查看我的机器人；搜索我创建的机器人", "查我的机器人 — 提取 robot-code", "查看我的机器人" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "自定义机器人 Webhook 发送群消息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.send_message_by_custom_robot", "cli_name": "send-by-webhook", "cli_path": "chat message send-by-webhook", "confirmation": "not_required", "description": "使用自定义机器人发送群消息，请注意自定义机器人与企业机器人的区别。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "bot", "rpc_name": "send_message_by_custom_robot" }, "metadata_source": "embedded-mcp-metadata", "name": "send_message_by_custom_robot", "primary_cli_path": "chat message send-by-webhook", "risk": "medium", "title": "自定义机器人发送群消息", "use_when": [ "7. Webhook 发告警", "CPU 超过 90% 自动告警；Webhook 告警", "Webhook 发消息/告警消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "以当前用户身份向群聊或单聊发送文本、Markdown、图片或本地文件", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.send_personal_message", "cli_name": "send", "cli_path": "chat message send", "confirmation": "not_required", "description": "以用户身份发消息，支持多种消息类型", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "send_personal_message" }, "metadata_source": "embedded-mcp-metadata", "name": "send_personal_message", "primary_cli_path": "chat message send", "reviewed": true, "risk": "medium", "tips": [ "发送前确认目标和内容；文件消息使用 --msg-type file --file-path", "需要 24 小时内防重复投递时提供稳定的 --uuid" ], "title": "send_personal_message", "use_when": [ "3. 以个人身份发送群消息", "4. 以个人身份单聊（通过 userId）", "4b. 以个人身份单聊（通过 openDingTalkId，三方应用等无法获取 userId 时使用）", "使用当前用户身份发送图片或本地文件", "再 dws drive info --file-id \u003cfileId\u003e --space-id \u003cspaceId\u003e 获取 dentryId", "单聊（推荐 --open-dingtalk-id）", "发单聊消息(以个人身份)", "发群消息(以个人身份)", "发送图片", "发送普通群消息或单聊消息", "幂等发送（24h 内相同 uuid 不重复投递）", "用 Markdown 语法发送", "用 Markdown 语法发送（mediaId 作为图片引用）", "用 openDingTalkId 发单聊消息", "给机器人发单聊/给机器人发消息/跟机器人聊天；给机器人发单聊消息", "群聊", "通知群里的人都来开会；个人身份群发" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "机器人发送消息（--group 群聊 / --users 单聊）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.send_robot_message", "cli_name": "send-by-bot", "cli_path": "chat message send-by-bot", "confirmation": "not_required", "description": "群聊：传 --group 指定群；单聊：传 --users 或 --open-dingtalk-ids 指定用户列表，与 --group 只能选其一，不能同时指定。--text 支持 Markdown。\n\n⚠️ 重要：该接口会真实发送消息到目标会话，不可用于测试或试探性调用。调用前必须确认消息内容和接收对象无误。", "effect": "write", "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "name": "send_robot_message", "primary_cli_path": "chat message send-by-bot", "reviewed": true, "risk": "medium", "title": "机器人发送消息（--group 群聊 / --users 单聊）", "use_when": [ "5. 机器人发群消息（Markdown）", "6. 机器人单聊发消息", "@所有人", "尝试发送，若报\"机器人不存在\"则执行 Step 3", "或者用 openDingtalkId 发送并 @", "机器人发消息/机器人群发", "机器人发送消息（--group 群聊 / --users 单聊）", "用 userId 发送并 @（注意 text 中 @userId）", "用机器人发消息 — 提取返回中的 processQueryKey", "给张三发一条机器人单聊消息；机器人单聊", "让机器人每天推送日报；机器人定时推送", "重新发送" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据用户提供的群和身份为用户设置群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“拉取会话的群身份”请改用 dws chat group-role list", "要“根据用户提供的群和成员为在群里查询成员的群身份”请改用 dws chat group-role query-user", "要“添加群身份”请改用 dws chat group-role add" ], "canonical_path": "chat.set_custom_user_roles", "cli_name": "set-user", "cli_path": "chat group-role set-user", "confirmation": "not_required", "description": "根据用户提供的群和身份为用户设置群身份", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "set_custom_user_roles" }, "metadata_source": "embedded-mcp-metadata", "name": "set_custom_user_roles", "primary_cli_path": "chat group-role set-user", "reviewed": false, "risk": "medium", "title": "set_custom_user_roles", "use_when": [ "给某人设置群身份/设定用户的群身份" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "管理群禁言成员", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "全员禁言/群禁言；全员禁言或解除" ], "canonical_path": "chat.set_group_member_mute_list", "cli_name": "group-mute-member", "cli_path": "chat group-mute-member", "confirmation": "not_required", "description": "管理群禁言成员", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "set_group_member_mute_list" }, "metadata_source": "embedded-mcp-metadata", "name": "set_group_member_mute_list", "primary_cli_path": "chat group-mute-member", "reviewed": false, "risk": "medium", "use_when": [ "禁言某人/指定成员禁言/解除某人禁言", "禁言某人/指定成员禁言；指定成员禁言" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "设置/取消群全员禁言", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "禁言某人/指定成员禁言；指定成员禁言" ], "canonical_path": "chat.set_group_mute", "cli_name": "group-mute", "cli_path": "chat group-mute", "confirmation": "not_required", "description": "设置/取消群全员禁言", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "set_group_mute" }, "metadata_source": "embedded-mcp-metadata", "name": "set_group_mute", "primary_cli_path": "chat group-mute", "reviewed": false, "risk": "medium", "use_when": [ "全员禁言/群禁言/解除禁言", "全员禁言/群禁言；全员禁言或解除" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "设置钉住(pin)某条消息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.set_pin_message", "cli_name": "set-pin-msg", "cli_path": "chat message set-pin-msg", "confirmation": "not_required", "description": "设置钉住(pin)某条消息", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "set_pin_message" }, "metadata_source": "embedded-mcp-metadata", "name": "set_pin_message", "primary_cli_path": "chat message set-pin-msg", "reviewed": false, "risk": "medium", "title": "设置钉住(pin)消息", "use_when": [ "钉住消息/Pin消息/置顶消息到会话；钉住消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "会话置顶/取消置顶", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "置顶某条消息/把这条消息置顶；置顶消息", "钉住消息/Pin消息/置顶消息到会话；钉住消息" ], "canonical_path": "chat.set_top_conversation", "cli_name": "set-top", "cli_path": "chat set-top", "confirmation": "not_required", "description": "会话置顶/取消置顶", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "set_top_conversation" }, "metadata_source": "embedded-mcp-metadata", "name": "set_top_conversation", "primary_cli_path": "chat set-top", "reviewed": false, "risk": "medium", "use_when": [ "置顶会话/取消置顶/会话置顶", "置顶会话/取消置顶；设置/取消会话置顶" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "群主转让", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.transfer_group_owner", "cli_name": "transfer-owner", "cli_path": "chat group transfer-owner", "confirmation": "not_required", "description": "群主转让", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "transfer_group_owner" }, "metadata_source": "embedded-mcp-metadata", "name": "transfer_group_owner", "primary_cli_path": "chat group transfer-owner", "reviewed": false, "risk": "medium", "use_when": [ "转让群主/换群主/群主转让" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取未读会话列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.unread_message_conversation_list", "cli_name": "list-unread-conversations", "cli_path": "chat message list-unread-conversations", "confirmation": "not_required", "description": "unread_message_conversation_list", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "unread_message_conversation_list" }, "metadata_source": "embedded-mcp-metadata", "name": "unread_message_conversation_list", "primary_cli_path": "chat message list-unread-conversations", "risk": "low", "use_when": [ "2b. 拉取未读会话列表", "未读会话列表", "未读消息会话/未读会话列表/我的未读会话", "未读消息会话/未读会话列表/我的未读会话；未读会话列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "取消某条钉住的(pin)消息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.unset_pin_message", "cli_name": "unset-pin-msg", "cli_path": "chat message unset-pin-msg", "confirmation": "not_required", "description": "取消某条钉住的(pin)消息", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "unset_pin_message" }, "metadata_source": "embedded-mcp-metadata", "name": "unset_pin_message", "primary_cli_path": "chat message unset-pin-msg", "reviewed": false, "risk": "medium", "title": "取消钉住的消息", "use_when": [ "取消钉住/Unpin消息；取消钉住消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "设置/取消群成员为管理员", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.update_conv_member_roles", "cli_name": "set-admin", "cli_path": "chat group set-admin", "confirmation": "not_required", "description": "设置/取消群成员为管理员", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_conv_member_roles" }, "metadata_source": "embedded-mcp-metadata", "name": "update_conv_member_roles", "primary_cli_path": "chat group set-admin", "reviewed": false, "risk": "medium", "use_when": [ "设管理员/取消管理员/设置群管理员", "设管理员/取消管理员；设置群管理员" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“拉取会话的群身份”请改用 dws chat group-role list", "要“根据用户提供的群和成员为在群里查询成员的群身份”请改用 dws chat group-role query-user", "要“添加群身份”请改用 dws chat group-role add" ], "canonical_path": "chat.update_custom_group_role", "cli_name": "update", "cli_path": "chat group-role update", "confirmation": "not_required", "description": "更新群身份", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_custom_group_role" }, "metadata_source": "embedded-mcp-metadata", "name": "update_custom_group_role", "primary_cli_path": "chat group-role update", "reviewed": false, "risk": "medium", "use_when": [ "修改/更新群身份名称" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新群头像", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.update_group_icon", "cli_name": "update-icon", "cli_path": "chat group update-icon", "confirmation": "not_required", "description": "更新群头像", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_group_icon" }, "metadata_source": "embedded-mcp-metadata", "name": "update_group_icon", "primary_cli_path": "chat group update-icon", "reviewed": false, "risk": "medium", "use_when": [ "改群头像/更新群头像；更新群头像" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新群名称", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.update_group_name", "cli_name": "rename", "cli_path": "chat group rename", "confirmation": "not_required", "description": "更新群名称", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "update_group_name" }, "metadata_source": "embedded-mcp-metadata", "name": "update_group_name", "primary_cli_path": "chat group rename", "risk": "medium", "title": "update_group_name", "use_when": [ "改群名" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新群设置", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.update_group_settings", "cli_name": "update-settings", "cli_path": "chat group update-settings", "confirmation": "not_required", "description": "更新群设置", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_group_settings" }, "metadata_source": "embedded-mcp-metadata", "name": "update_group_settings", "primary_cli_path": "chat group update-settings", "reviewed": false, "risk": "medium", "use_when": [ "改群设置/群设置开关/群权限/入群许可/禁止私聊；更新群设置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "群免打扰开关", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "关闭@所有人通知/屏蔽@all/不接收@所有人；关闭 @所有人提醒", "关闭红包通知/屏蔽红包/不接收红包提醒；关闭红包提醒", "隐藏会话/隐藏群聊/隐藏对话；隐藏会话" ], "canonical_path": "chat.update_notification_off", "cli_name": "mute", "cli_path": "chat mute", "confirmation": "not_required", "description": "群免打扰开关", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_notification_off" }, "metadata_source": "embedded-mcp-metadata", "name": "update_notification_off", "primary_cli_path": "chat mute", "reviewed": false, "risk": "medium", "use_when": [ "免打扰/消息免打扰/静音/开启免打扰/关闭免打扰" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "设置新成员入群可查看历史消息选项", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.update_show_history_msg_option", "cli_name": "set-history", "cli_path": "chat group set-history", "confirmation": "not_required", "description": "设置新成员入群可查看历史消息选项", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_show_history_msg_option" }, "metadata_source": "embedded-mcp-metadata", "name": "update_show_history_msg_option", "primary_cli_path": "chat group set-history", "reviewed": false, "risk": "medium", "use_when": [ "新成员看历史/历史消息可见范围；设置新成员可见历史消息", "设置历史消息/新成员看历史/新成员可见消息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "流式更新卡片内容", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.update_streaming_card", "cli_name": "update-card", "cli_path": "chat message update-card", "confirmation": "not_required", "description": "流式更新卡片内容", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_streaming_card" }, "metadata_source": "embedded-mcp-metadata", "name": "update_streaming_card", "primary_cli_path": "chat message update-card", "reviewed": false, "risk": "medium", "use_when": [ "更新卡片/流式更新卡片；流式更新卡片内容" ] } ], "use_when": [ "群聊/建群/群成员/群管理/发消息/发图片消息/发文件消息/发 Markdown 消息/截图发钉钉/转发消息/引用回复/@我/特别关注消息/机器人发消息/Webhook/机器人群发/机器人单聊/通知" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.contact.prod.json", "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "通讯录 / 用户 / 部门", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "avoid_when": [ "13800138000是谁/查手机号；按手机号搜人", "222020这个工号是谁/查工号；按工号搜人", "五道的上级是谁/谁负责XX/XX的下属有谁；AI语义搜人" ], "description": "通讯录 / 用户 / 部门 / 人员关系", "id": "contact", "name": "通讯录 / 用户 / 部门 / 人员关系", "runtime": true, "tool_count": 12, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询员工花名册字段信息，根据当前用户指定员工和字段列表，查询相应管理范围内员工的字段值信息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询花名册有权限的字段列表，根据当前用户查询花名册有权限的字段列”请改用 dws contact user profile fields" ], "canonical_path": "contact.get_authorized_emp_rosterInfo", "cli_name": "get", "cli_path": "contact user profile get", "confirmation": "not_required", "description": "查询员工花名册字段信息，根据当前用户指定员工和字段列表，查询相应管理范围内员工的字段值信息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "hrmregister", "rpc_name": "get_authorized_emp_rosterInfo" }, "metadata_source": "embedded-mcp-metadata", "name": "get_authorized_emp_rosterInfo", "primary_cli_path": "contact user profile get", "reviewed": false, "risk": "low", "title": "查询员工花名册字段信息", "use_when": [ "11. 根据字段 code 查询指定员工的花名册信息", "12. 查询所有可见字段的花名册信息", "花名册/员工档案/学历/家庭/银行卡/紧急联系人/合同" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取当前用户信息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量获取用户详情（逗号分隔 userId）”请改用 dws contact user get", "要“按关键词搜索用户”请改用 dws contact user search", "要“按手机号搜索用户”请改用 dws contact user search-mobile" ], "canonical_path": "contact.get_current_user_profile", "cli_name": "get-self", "cli_path": "contact user get-self", "confirmation": "not_required", "description": "获取当前登录用户的基本信息（如姓名、工号、手机号）、当前组织信息（corpId、组织名称）、直属主管信息、所属部门列表（含部门 ID 与名称）以及角色信息（如管理员类型、自定义角色标签等）。返回内容受组织隐私与权限策略控制：若某些字段（如主管、手机号）被设为不可见，则可能被过滤或省略。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "get_current_user_profile" }, "metadata_source": "embedded-mcp-metadata", "name": "get_current_user_profile", "primary_cli_path": "contact user get-self", "risk": "low", "title": "获取当前用户详情", "use_when": [ "1. 查看自己的信息 — 提取 userId", "我是谁/我的信息/我的 userId/当前用户/本人/self/me/whoami" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据指定的部门 ID，获取部门详情。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“按关键词搜索部门”请改用 dws contact dept search", "要“查看部门成员（逗号分隔 deptId）”请改用 dws contact dept list-members", "要“根据指定的部门 ID，获取其直接子部门列表，返回每个子部门的部门”请改用 dws contact dept list-children" ], "canonical_path": "contact.get_dept_info_by_dept_id", "cli_name": "get-info", "cli_path": "contact dept get-info", "confirmation": "not_required", "description": "根据指定的部门 ID，获取部门详情。结果受组织架构可见性控制：仅返回调用者有权限查看的部门信息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_dept_info_by_dept_id", "primary_cli_path": "contact dept get-info", "reviewed": false, "risk": "low", "title": "查询部门详情", "use_when": [ "4. 查看部门详情（部门ID、名称、人数）", "研发部有多少人；查部门人数", "研发部的详细信息/部门信息；查部门详情", "部门详情/部门信息/部门多少人" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查看部门成员（逗号分隔 deptId）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“按关键词搜索部门”请改用 dws contact dept search", "要“根据指定的部门 ID，获取其直接子部门列表，返回每个子部门的部门”请改用 dws contact dept list-children", "要“根据指定的部门 ID，获取部门详情”请改用 dws contact dept get-info" ], "canonical_path": "contact.get_dept_members_by_deptId", "cli_name": "list-members", "cli_path": "contact dept list-members", "confirmation": "not_required", "description": "获取指定部门下的所有成员，返回每位成员的用户 ID（userId）和显示名称（如真实姓名或昵称）。结果受组织可见性控制：若调用者无权查看某成员（例如该成员所在子部门被隐藏，或其个人信息设为私密），则该成员不会出现在返回列表中。适用于需要展示部门人员列表、选择协作成员等场景，仅支持调用者有权限访问的部门。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "get_dept_members_by_deptId" }, "metadata_source": "embedded-mcp-metadata", "name": "get_dept_members_by_deptId", "primary_cli_path": "contact dept list-members", "risk": "low", "title": "获取部门下所有成员", "use_when": [ "6. 查看部门成员", "部门有谁/部门成员/人员名单" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据指定的部门 ID，获取其直接子部门列表，返回每个子部门的部门 ID、名称。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“按关键词搜索部门”请改用 dws contact dept search", "要“查看部门成员（逗号分隔 deptId）”请改用 dws contact dept list-members", "要“根据指定的部门 ID，获取部门详情”请改用 dws contact dept get-info" ], "canonical_path": "contact.get_sub_depts_by_dept_id", "cli_name": "list-children", "cli_path": "contact dept list-children", "confirmation": "not_required", "description": "根据指定的部门 ID，获取其直接子部门列表，返回每个子部门的部门 ID、名称。结果受组织架构可见性控制：仅返回调用者有权限查看的子部门；若父部门不可见或无子部门，则返回空列表。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_sub_depts_by_dept_id", "primary_cli_path": "contact dept list-children", "reviewed": false, "risk": "low", "title": "获取部门的子部门", "use_when": [ "5. 查看直属子部门 — 提取子 deptId 列表", "子部门/下设部门/部门有哪些下级部门/枚举二级部门" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量获取用户详情（逗号分隔 userId）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“按关键词搜索用户”请改用 dws contact user search", "要“按手机号搜索用户”请改用 dws contact user search-mobile", "要“获取当前用户信息”请改用 dws contact user get-self" ], "canonical_path": "contact.get_user_info_by_user_ids", "cli_name": "get", "cli_path": "contact user get", "confirmation": "not_required", "description": "获取指定用户 ID 列表对应的员工详细信息，包括人员基本信息（ID、名称、主管名称、主管userId等）、所属角色信息、所在部门信息。返回结果受组织可见性规则限制：若调用者无权查看某员工（如部门隐藏、手机号设为私密等），则相应字段可能被过滤或不返回该员工。适用于需要批量获取同事信息的场景，如组织架构展示、审批人选择等。仅返回调用者权限范围内的有效数据。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "get_user_info_by_user_ids" }, "metadata_source": "embedded-mcp-metadata", "name": "get_user_info_by_user_ids", "primary_cli_path": "contact user get", "risk": "low", "title": "get_user_info_by_user_ids", "use_when": [ "查用户详情/部门/主管/管理员" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询花名册有权限的字段列表，根据当前用户查询花名册有权限的字段列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询员工花名册字段信息，根据当前用户指定员工和字段列表，查询相应”请改用 dws contact user profile get" ], "canonical_path": "contact.list_authorized_roster_fields", "cli_name": "fields", "cli_path": "contact user profile fields", "confirmation": "not_required", "description": "查询花名册有权限的字段列表，根据当前用户查询花名册有权限的字段列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "hrmregister", "rpc_name": "list_authorized_roster_fields" }, "metadata_source": "embedded-mcp-metadata", "name": "list_authorized_roster_fields", "primary_cli_path": "contact user profile fields", "reviewed": false, "risk": "low", "title": "查询花名册有权限字段列表", "use_when": [ "10. 查询花名册有权限的字段列表", "花名册字段/有哪些字段/字段列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取我的特别关注列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取我的特别关注列表”" ], "canonical_path": "contact.list_my_followings", "cli_name": "list-my-followings", "cli_path": "contact relation list-my-followings", "confirmation": "not_required", "description": "获取我的特别关注列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_my_followings", "primary_cli_path": "contact relation list-my-followings", "reviewed": false, "risk": "low", "use_when": [ "我关注了谁/我的特别关注列表/我的星标联系人/特别关注的人有哪些" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取离职员工列表，支持按照员工姓名、离职时间范围、部门过滤", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取离职员工列表，支持按照员工姓名、离职时间范围、部门过滤”" ], "canonical_path": "contact.query_dismission_employee_list", "cli_name": "search", "cli_path": "contact user dismission search", "confirmation": "not_required", "description": "获取离职员工列表，支持按照员工姓名、离职时间范围、部门过滤", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "hrmregister", "rpc_name": "query_dismission_employee_list" }, "metadata_source": "embedded-mcp-metadata", "name": "query_dismission_employee_list", "primary_cli_path": "contact user dismission search", "reviewed": false, "risk": "low", "title": "query_dismission_employee_list", "use_when": [ "13. 查询全部离职员工", "14. 按姓名/时间范围/部门筛选离职员工", "离职员工/离职名单/离职人员/已离职" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "按关键词搜索用户", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量获取用户详情（逗号分隔 userId）”请改用 dws contact user get", "要“按手机号搜索用户”请改用 dws contact user search-mobile", "要“获取当前用户信息”请改用 dws contact user get-self" ], "canonical_path": "contact.search_contact_by_key_word", "cli_name": "search", "cli_path": "contact user search", "confirmation": "not_required", "description": "根据关键词搜索好友和同事", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "search_contact_by_key_word" }, "metadata_source": "embedded-mcp-metadata", "name": "search_contact_by_key_word", "primary_cli_path": "contact user search", "risk": "low", "use_when": [ "2. 按名字搜索同事或好友 — 可提取 同事的userId，或好友的openDingTalkId" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "按关键词搜索部门", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“查看部门成员（逗号分隔 deptId）”请改用 dws contact dept list-members", "要“根据指定的部门 ID，获取其直接子部门列表，返回每个子部门的部门”请改用 dws contact dept list-children", "要“根据指定的部门 ID，获取部门详情”请改用 dws contact dept get-info" ], "canonical_path": "contact.search_dept_by_keyword", "cli_name": "search", "cli_path": "contact dept search", "confirmation": "not_required", "description": "根据关键词模糊搜索部门，返回匹配的部门列表，包含每个部门的 ID、名称。搜索范围限于调用者有权限查看的组织架构；若关键词无匹配结果或部门因可见性设置被隐藏，则相应部门不会出现在结果中。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "search_dept_by_keyword" }, "metadata_source": "embedded-mcp-metadata", "name": "search_dept_by_keyword", "primary_cli_path": "contact dept search", "risk": "low", "title": "搜索部门", "use_when": [ "3. 查看部门结构 — 提取 deptId", "找部门/哪个部门" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "按手机号搜索用户", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量获取用户详情（逗号分隔 userId）”请改用 dws contact user get", "要“按关键词搜索用户”请改用 dws contact user search", "要“获取当前用户信息”请改用 dws contact user get-self" ], "canonical_path": "contact.search_user_by_mobile", "cli_name": "search-mobile", "cli_path": "contact user search-mobile", "confirmation": "not_required", "description": "通过手机号搜索获取用户名称和userId。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "search_user_by_mobile" }, "metadata_source": "embedded-mcp-metadata", "name": "search_user_by_mobile", "primary_cli_path": "contact user search-mobile", "risk": "low", "title": "通过手机号获取成员userId和名称", "use_when": [ "按手机号搜索用户" ] } ], "use_when": [ "张三在哪个部门/查一下同事工号；通讯录精确查询", "通讯录/同事/部门/组织架构/子部门/部门多少人/离职员工/离职名单/离职花名册/花名册/员工档案/学历/家庭/银行卡/紧急联系人/合同/角色/主管角色/管理员角色/财务/HR/特别关注/星标联系人" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/catalog-completeness.json" ], "agent_summary": "管理钉钉开放平台应用、权限、版本、机器人、事件订阅与连接器", "agent_summary_source": "dws-command-surface-review", "avoid_when": [ "只需要查询开放平台文档时优先使用 devdoc" ], "description": "开放平台开发者能力", "id": "dev", "name": "开放平台开发者能力", "runtime": true, "tool_count": 34, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "添加开放平台应用成员", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“查询开放平台应用成员”请改用 dws dev app member list", "要“移除开放平台应用的协作成员”请改用 dws dev app member remove" ], "canonical_path": "dev.add_dev_app_members", "cli_name": "add", "cli_path": "dev app member add", "confirmation": "not_required", "description": "添加开放平台应用成员", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "add_dev_app_members" }, "name": "add_dev_app_members", "primary_cli_path": "dev app member add", "reviewed": true, "risk": "medium", "use_when": [ "添加开放平台应用成员" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "申请开放平台应用权限点", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“查询开放平台应用权限列表”请改用 dws dev app permission list", "要“移除开放平台应用已授予的权限点”请改用 dws dev app permission remove" ], "canonical_path": "dev.apply_dev_app_permissions", "cli_name": "add", "cli_path": "dev app permission add", "confirmation": "not_required", "description": "申请开放平台应用权限点", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "apply_dev_app_permissions" }, "name": "apply_dev_app_permissions", "primary_cli_path": "dev app permission add", "reviewed": true, "risk": "medium", "use_when": [ "申请开放平台应用权限点" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查看后台连接器守护进程状态（pid、运行时长、日志路径）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“优雅停止后台连接器守护进程（释放单实例锁与 Stream 连接）”请改用 dws dev connect stop" ], "canonical_path": "dev.connect_status", "cli_name": "status", "cli_path": "dev connect status", "confirmation": "not_required", "description": "查看连接器健康状态（healthy/degraded/down，pid、收发活动、日志路径；--json 供外部托管消费）", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "命令仅操作本地进程或策略文件，不调用 MCP 接口", "name": "connect_status", "primary_cli_path": "dev connect status", "reviewed": true, "risk": "low", "use_when": [ "查看/停止后台连接器（status/list 忽略全局 --format，出 JSON 用专属 --json）", "查看后台连接器守护进程状态（pid、运行时长、日志路径）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "优雅停止后台连接器守护进程（释放单实例锁与 Stream 连接）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“查看后台连接器守护进程状态（pid、运行时长、日志路径）”请改用 dws dev connect status" ], "canonical_path": "dev.connect_stop", "cli_name": "stop", "cli_path": "dev connect stop", "confirmation": "not_required", "description": "优雅停止后台连接器守护进程（释放单实例锁与 Stream 连接）", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "命令仅操作本地进程或策略文件，不调用 MCP 接口", "name": "connect_stop", "primary_cli_path": "dev connect stop", "reviewed": true, "risk": "medium", "use_when": [ "优雅停止后台连接器守护进程（释放单实例锁与 Stream 连接）", "查看/停止后台连接器（status/list 忽略全局 --format，出 JSON 用专属 --json）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建开放平台企业内部应用", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用，停用后应用能力对外不可用（可重新启用）”请改用 dws dev app disable", "要“删除开放平台企业内部应用（不可逆，需 --confirm-nam”请改用 dws dev app delete", "要“启用开放平台企业内部应用”请改用 dws dev app enable" ], "canonical_path": "dev.create_dev_app", "cli_name": "create", "cli_path": "dev app create", "confirmation": "not_required", "description": "创建开放平台企业内部应用", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "create_dev_app" }, "name": "create_dev_app", "primary_cli_path": "dev app create", "reviewed": true, "risk": "medium", "use_when": [ "创建应用", "创建开放平台企业内部应用", "创建开放平台应用，拿 unifiedAppId" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "基于当前配置创建应用新版本", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“分页查询应用版本列表”请改用 dws dev app version list", "要“查询指定版本详情”请改用 dws dev app version get", "要“查询版本发布/审批状态”请改用 dws dev app version status" ], "canonical_path": "dev.create_dev_app_version", "cli_name": "create", "cli_path": "dev app version create", "confirmation": "not_required", "description": "基于当前配置创建应用新版本", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "create_dev_app_version" }, "name": "create_dev_app_version", "primary_cli_path": "dev app version create", "reviewed": true, "risk": "medium", "use_when": [ "基于当前配置创建应用新版本", "版本发布/审批，线上搜索、加群、路由消息以 RELEASE 为准" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除开放平台企业内部应用（不可逆，需 --confirm-name 二次确认）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用，停用后应用能力对外不可用（可重新启用）”请改用 dws dev app disable", "要“创建开放平台企业内部应用”请改用 dws dev app create", "要“启用开放平台企业内部应用”请改用 dws dev app enable" ], "canonical_path": "dev.delete_dev_app", "cli_name": "delete", "cli_path": "dev app delete", "confirmation": "user_required", "description": "删除开放平台企业内部应用（不可逆，需 --confirm-name 二次确认）", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "delete_dev_app" }, "name": "delete_dev_app", "primary_cli_path": "dev app delete", "reviewed": true, "risk": "high", "use_when": [ "删除应用（不可逆，需 --confirm-name 二次确认）", "删除开放平台企业内部应用（不可逆，需 --confirm-name 二次确认）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "停用开放平台应用，停用后应用能力对外不可用（可重新启用）", "agent_summary_source": "destructive-safety-review", "availability": "available", "avoid_when": [ "要“创建开放平台企业内部应用”请改用 dws dev app create", "要“删除开放平台企业内部应用（不可逆，需 --confirm-nam”请改用 dws dev app delete", "要“启用开放平台企业内部应用”请改用 dws dev app enable" ], "canonical_path": "dev.disable_dev_app", "cli_name": "disable", "cli_path": "dev app disable", "confirmation": "user_required", "description": "停用开放平台企业内部应用", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "disable_dev_app" }, "name": "disable_dev_app", "primary_cli_path": "dev app disable", "reviewed": true, "risk": "high", "use_when": [ "停用/启用应用" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "停用开放平台应用的机器人（可重新启用）", "agent_summary_source": "destructive-safety-review", "availability": "available", "avoid_when": [ "要“启用现有应用机器人能力（纯启用，无需配置字段）”请改用 dws dev app robot enable", "要“查询机器人异步创建任务结果”请改用 dws dev app robot result", "要“查询现有应用的机器人配置”请改用 dws dev app robot get" ], "canonical_path": "dev.disable_dev_app_robot", "cli_name": "disable", "cli_path": "dev app robot disable", "confirmation": "user_required", "description": "停用现有应用的机器人能力", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "disable_dev_app_robot" }, "name": "disable_dev_app_robot", "primary_cli_path": "dev app robot disable", "reviewed": true, "risk": "high", "use_when": [ "启用/停用机器人" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "启用开放平台企业内部应用", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用，停用后应用能力对外不可用（可重新启用）”请改用 dws dev app disable", "要“创建开放平台企业内部应用”请改用 dws dev app create", "要“删除开放平台企业内部应用（不可逆，需 --confirm-nam”请改用 dws dev app delete" ], "canonical_path": "dev.enable_dev_app", "cli_name": "enable", "cli_path": "dev app enable", "confirmation": "not_required", "description": "启用开放平台企业内部应用", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "enable_dev_app" }, "name": "enable_dev_app", "primary_cli_path": "dev app enable", "reviewed": true, "risk": "medium", "use_when": [ "停用/启用应用", "启用开放平台企业内部应用" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "启用现有应用机器人能力（纯启用，无需配置字段）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用的机器人（可重新启用）”请改用 dws dev app robot disable", "要“查询机器人异步创建任务结果”请改用 dws dev app robot result", "要“查询现有应用的机器人配置”请改用 dws dev app robot get" ], "canonical_path": "dev.enable_dev_app_robot", "cli_name": "enable", "cli_path": "dev app robot enable", "confirmation": "not_required", "description": "启用现有应用机器人能力（纯启用，无需配置字段）", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "enable_dev_app_robot" }, "name": "enable_dev_app_robot", "primary_cli_path": "dev app robot enable", "reviewed": true, "risk": "medium", "use_when": [ "启用/停用机器人", "启用现有应用机器人能力（纯启用，无需配置字段）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询开放平台企业内部应用详情", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用，停用后应用能力对外不可用（可重新启用）”请改用 dws dev app disable", "要“创建开放平台企业内部应用”请改用 dws dev app create", "要“删除开放平台企业内部应用（不可逆，需 --confirm-nam”请改用 dws dev app delete" ], "canonical_path": "dev.get_dev_app", "cli_name": "get", "cli_path": "dev app get", "confirmation": "not_required", "description": "查询开放平台企业内部应用详情", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "get_dev_app" }, "name": "get_dev_app", "primary_cli_path": "dev app get", "reviewed": true, "risk": "low", "use_when": [ "查询单个应用详情", "查询开放平台企业内部应用详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "读取开放平台应用凭证", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“读取开放平台应用凭证”" ], "canonical_path": "dev.get_dev_app_credentials", "cli_name": "get", "cli_path": "dev app credentials get", "confirmation": "not_required", "description": "读取开放平台应用凭证", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "get_dev_app_credentials" }, "name": "get_dev_app_credentials", "primary_cli_path": "dev app credentials get", "reviewed": true, "risk": "low", "use_when": [ "查询 clientId/clientSecret（credentials 下只有 get 子命令）", "读取开放平台应用凭证" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询指定版本详情", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“分页查询应用版本列表”请改用 dws dev app version list", "要“基于当前配置创建应用新版本”请改用 dws dev app version create", "要“查询版本发布/审批状态”请改用 dws dev app version status" ], "canonical_path": "dev.get_dev_app_version_detail", "cli_name": "get", "cli_path": "dev app version get", "confirmation": "not_required", "description": "查询指定版本详情", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "get_dev_app_version_detail" }, "name": "get_dev_app_version_detail", "primary_cli_path": "dev app version get", "reviewed": true, "risk": "low", "use_when": [ "查询指定版本详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询版本发布/审批状态", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“分页查询应用版本列表”请改用 dws dev app version list", "要“基于当前配置创建应用新版本”请改用 dws dev app version create", "要“查询指定版本详情”请改用 dws dev app version get" ], "canonical_path": "dev.get_dev_app_version_status", "cli_name": "status", "cli_path": "dev app version status", "confirmation": "not_required", "description": "查询版本发布/审批状态", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "get_dev_app_version_status" }, "name": "get_dev_app_version_status", "primary_cli_path": "dev app version status", "reviewed": true, "risk": "low", "use_when": [ "查询版本发布/审批状态", "版本发布/审批，线上搜索、加群、路由消息以 RELEASE 为准" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询现有应用的机器人配置", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用的机器人（可重新启用）”请改用 dws dev app robot disable", "要“启用现有应用机器人能力（纯启用，无需配置字段）”请改用 dws dev app robot enable", "要“查询机器人异步创建任务结果”请改用 dws dev app robot result" ], "canonical_path": "dev.get_extension_robot_config", "cli_name": "get", "cli_path": "dev app robot get", "confirmation": "not_required", "description": "查询现有应用的机器人配置", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "get_extension_robot_config" }, "name": "get_extension_robot_config", "primary_cli_path": "dev app robot get", "reviewed": true, "risk": "low", "use_when": [ "查询现有应用的机器人配置", "查询现有机器人配置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询网页应用配置", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“配置网页应用能力”请改用 dws dev app webapp config" ], "canonical_path": "dev.get_extension_webapp_config", "cli_name": "get", "cli_path": "dev app webapp get", "confirmation": "not_required", "description": "查询网页应用配置", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "get_extension_webapp_config" }, "name": "get_extension_webapp_config", "primary_cli_path": "dev app webapp get", "reviewed": true, "risk": "low", "use_when": [ "查询网页应用配置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询开放平台企业内部应用列表", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用，停用后应用能力对外不可用（可重新启用）”请改用 dws dev app disable", "要“创建开放平台企业内部应用”请改用 dws dev app create", "要“删除开放平台企业内部应用（不可逆，需 --confirm-nam”请改用 dws dev app delete" ], "canonical_path": "dev.list_dev_app", "cli_name": "list", "cli_path": "dev app list", "confirmation": "not_required", "description": "查询开放平台企业内部应用列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "list_dev_app" }, "name": "list_dev_app", "primary_cli_path": "dev app list", "reviewed": true, "risk": "low", "use_when": [ "查询应用列表", "查询开放平台企业内部应用列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询应用已订阅的事件列表", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“取消订阅应用事件”请改用 dws dev app event unsubscribe", "要“订阅应用事件回调”请改用 dws dev app event subscribe" ], "canonical_path": "dev.list_dev_app_events", "cli_name": "list", "cli_path": "dev app event list", "confirmation": "not_required", "description": "查询应用已订阅的事件列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "list_dev_app_events" }, "name": "list_dev_app_events", "primary_cli_path": "dev app event list", "reviewed": true, "risk": "low", "use_when": [ "查询应用已订阅的事件列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询开放平台应用成员", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“添加开放平台应用成员”请改用 dws dev app member add", "要“移除开放平台应用的协作成员”请改用 dws dev app member remove" ], "canonical_path": "dev.list_dev_app_members", "cli_name": "list", "cli_path": "dev app member list", "confirmation": "not_required", "description": "查询开放平台应用成员", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "list_dev_app_members" }, "name": "list_dev_app_members", "primary_cli_path": "dev app member list", "reviewed": true, "risk": "low", "use_when": [ "查询开放平台应用成员" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询开放平台应用权限列表", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“申请开放平台应用权限点”请改用 dws dev app permission add", "要“移除开放平台应用已授予的权限点”请改用 dws dev app permission remove" ], "canonical_path": "dev.list_dev_app_permissions", "cli_name": "list", "cli_path": "dev app permission list", "confirmation": "not_required", "description": "查询开放平台应用权限列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "list_dev_app_permissions" }, "name": "list_dev_app_permissions", "primary_cli_path": "dev app permission list", "reviewed": true, "risk": "low", "use_when": [ "查询开放平台应用权限列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "分页查询应用版本列表", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“基于当前配置创建应用新版本”请改用 dws dev app version create", "要“查询指定版本详情”请改用 dws dev app version get", "要“查询版本发布/审批状态”请改用 dws dev app version status" ], "canonical_path": "dev.list_dev_app_versions", "cli_name": "list", "cli_path": "dev app version list", "confirmation": "not_required", "description": "分页查询应用版本列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "list_dev_app_versions" }, "name": "list_dev_app_versions", "primary_cli_path": "dev app version list", "reviewed": true, "risk": "low", "use_when": [ "分页查询应用版本列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "发布指定版本（含高敏权限需 --confirmed-sensitive）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“基于当前配置创建应用新版本”请改用 dws dev app version create", "要“查询指定版本详情”请改用 dws dev app version get", "要“查询版本发布/审批状态”请改用 dws dev app version status" ], "canonical_path": "dev.publish_dev_app_version", "cli_name": "publish", "cli_path": "dev app version publish", "confirmation": "not_required", "description": "发布指定版本（含高敏权限需 --confirmed-sensitive）", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "publish_dev_app_version" }, "name": "publish_dev_app_version", "primary_cli_path": "dev app version publish", "reviewed": true, "risk": "medium", "use_when": [ "发布指定版本（含高敏权限需 --confirmed-sensitive）", "版本发布/审批，线上搜索、加群、路由消息以 RELEASE 为准" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询机器人异步创建任务结果", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用的机器人（可重新启用）”请改用 dws dev app robot disable", "要“启用现有应用机器人能力（纯启用，无需配置字段）”请改用 dws dev app robot enable", "要“查询现有应用的机器人配置”请改用 dws dev app robot get" ], "canonical_path": "dev.query_robot_create_result", "cli_name": "result", "cli_path": "dev app robot result", "confirmation": "not_required", "description": "查询机器人异步创建任务结果", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "query_robot_create_result" }, "name": "query_robot_create_result", "primary_cli_path": "dev app robot result", "reviewed": true, "risk": "low", "use_when": [ "建号：轮询结果", "查询机器人异步创建任务结果" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "移除开放平台应用的协作成员", "agent_summary_source": "destructive-safety-review", "availability": "available", "avoid_when": [ "要“查询开放平台应用成员”请改用 dws dev app member list", "要“添加开放平台应用成员”请改用 dws dev app member add" ], "canonical_path": "dev.remove_dev_app_members", "cli_name": "remove", "cli_path": "dev app member remove", "confirmation": "user_required", "description": "移除开放平台应用成员", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "remove_dev_app_members" }, "name": "remove_dev_app_members", "primary_cli_path": "dev app member remove", "reviewed": true, "risk": "high", "use_when": [ "移除开放平台应用的协作成员" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "移除开放平台应用已授予的权限点", "agent_summary_source": "destructive-safety-review", "availability": "available", "avoid_when": [ "要“查询开放平台应用权限列表”请改用 dws dev app permission list", "要“申请开放平台应用权限点”请改用 dws dev app permission add" ], "canonical_path": "dev.remove_dev_app_permissions", "cli_name": "remove", "cli_path": "dev app permission remove", "confirmation": "user_required", "description": "取消开放平台应用权限点", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "remove_dev_app_permissions" }, "name": "remove_dev_app_permissions", "primary_cli_path": "dev app permission remove", "reviewed": true, "risk": "high", "use_when": [ "移除开放平台应用已授予的权限点" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "搜索开放平台文档", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“搜索开放平台文档”" ], "canonical_path": "dev.search_open_platform_docs_rag", "cli_name": "search", "cli_path": "dev doc search", "confirmation": "not_required", "description": "根据关键词搜索钉钉开放平台的开发文档，返回匹配的文档条目列表，包含标题、摘要、文档链接和相关标签。搜索结果按相关性排序。适用于开发者在集成或调试过程中快速查找 API 说明、接入指南、错误码解释等技术资料。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devdoc", "rpc_name": "search_open_platform_docs" }, "metadata_source": "embedded-mcp-metadata", "name": "search_open_platform_docs_rag", "primary_cli_path": "dev doc search", "reviewed": true, "risk": "low", "title": "search_open_platform_docs", "use_when": [ "搜索开放平台文档" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建或更新现有应用的机器人配置（upsert）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用的机器人（可重新启用）”请改用 dws dev app robot disable", "要“启用现有应用机器人能力（纯启用，无需配置字段）”请改用 dws dev app robot enable", "要“查询现有应用的机器人配置”请改用 dws dev app robot get" ], "canonical_path": "dev.set_extension_robot_config", "cli_name": "config", "cli_path": "dev app robot config", "confirmation": "not_required", "description": "创建或更新现有应用的机器人配置（upsert）", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "set_extension_robot_config" }, "name": "set_extension_robot_config", "primary_cli_path": "dev app robot config", "reviewed": true, "risk": "medium", "use_when": [ "创建/更新机器人配置（upsert）", "创建或更新现有应用的机器人配置（upsert）", "在明确的 unifiedAppId 上配置机器人能力" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "配置网页应用能力", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“查询网页应用配置”请改用 dws dev app webapp get" ], "canonical_path": "dev.set_extension_webapp_config", "cli_name": "config", "cli_path": "dev app webapp config", "confirmation": "not_required", "description": "配置网页应用能力", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "set_extension_webapp_config" }, "name": "set_extension_webapp_config", "primary_cli_path": "dev app webapp config", "reviewed": true, "risk": "medium", "use_when": [ "配置网页应用能力" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "异步提交钉钉智能体机器人创建任务（支持失败重试）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用的机器人（可重新启用）”请改用 dws dev app robot disable", "要“启用现有应用机器人能力（纯启用，无需配置字段）”请改用 dws dev app robot enable", "要“查询现有应用的机器人配置”请改用 dws dev app robot get" ], "canonical_path": "dev.submit_robot_create_task", "cli_name": "submit", "cli_path": "dev app robot submit", "confirmation": "not_required", "description": "异步提交钉钉智能体机器人创建任务（支持失败重试）", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "submit_robot_create_task" }, "name": "submit_robot_create_task", "primary_cli_path": "dev app robot submit", "reviewed": true, "risk": "medium", "use_when": [ "建号：异步提交", "异步提交钉钉智能体机器人创建任务（支持失败重试）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "订阅应用事件回调", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“取消订阅应用事件”请改用 dws dev app event unsubscribe", "要“查询应用已订阅的事件列表”请改用 dws dev app event list" ], "canonical_path": "dev.subscribe_dev_app_events", "cli_name": "subscribe", "cli_path": "dev app event subscribe", "confirmation": "not_required", "description": "订阅应用事件回调", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "subscribe_dev_app_events" }, "name": "subscribe_dev_app_events", "primary_cli_path": "dev app event subscribe", "reviewed": true, "risk": "medium", "use_when": [ "订阅应用事件回调" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "取消订阅应用事件", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“查询应用已订阅的事件列表”请改用 dws dev app event list", "要“订阅应用事件回调”请改用 dws dev app event subscribe" ], "canonical_path": "dev.unsubscribe_dev_app_events", "cli_name": "unsubscribe", "cli_path": "dev app event unsubscribe", "confirmation": "not_required", "description": "取消订阅应用事件", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "unsubscribe_dev_app_events" }, "name": "unsubscribe_dev_app_events", "primary_cli_path": "dev app event unsubscribe", "reviewed": true, "risk": "medium", "use_when": [ "取消订阅应用事件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "修改开放平台企业内部应用基础信息", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用，停用后应用能力对外不可用（可重新启用）”请改用 dws dev app disable", "要“创建开放平台企业内部应用”请改用 dws dev app create", "要“删除开放平台企业内部应用（不可逆，需 --confirm-nam”请改用 dws dev app delete" ], "canonical_path": "dev.update_dev_app", "cli_name": "update", "cli_path": "dev app update", "confirmation": "not_required", "description": "修改开放平台企业内部应用基础信息", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "update_dev_app" }, "name": "update_dev_app", "primary_cli_path": "dev app update", "reviewed": true, "risk": "medium", "use_when": [ "修改开放平台企业内部应用基础信息", "更新应用信息（写操作：先 --dry-run 预览，确认后加 --yes 执行；不加 --yes 会被拦下）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新开放平台应用安全配置", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新开放平台应用安全配置”所述变更时不要使用" ], "canonical_path": "dev.update_dev_app_security_config", "cli_name": "config", "cli_path": "dev app security config", "confirmation": "not_required", "description": "更新开放平台应用安全配置", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "update_dev_app_security_config" }, "name": "update_dev_app_security_config", "primary_cli_path": "dev app security config", "reviewed": true, "risk": "medium", "use_when": [ "更新开放平台应用安全配置" ] } ], "use_when": [ "开发或维护钉钉开放平台应用", "配置应用机器人、权限、成员、事件或发布版本" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.devdoc.prod.json", "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "开放平台文档搜索", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "description": "开放平台文档搜索", "id": "devdoc", "name": "开放平台文档搜索", "runtime": true, "tool_count": 1, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "按关键词搜索 open.dingtalk.com 开放平台文档", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“按关键词检索钉钉开放平台文档，只返回参考资料、参考资料链接和RA”请改用 dws devdoc article rag-pretest", "要“根据关键词搜索钉钉开放平台的开发文档，返回匹配的文档条目列表，包”请改用 dws devdoc article legacy-search", "要“根据关键词搜索钉钉开放平台的开发文档，返回匹配的文档条目列表，包”请改用 dws devdoc article legacy-search-open-platform" ], "canonical_path": "devdoc.search_open_platform_docs_rag", "cli_name": "search", "cli_path": "devdoc article search", "confirmation": "not_required", "description": "根据关键词搜索钉钉开放平台的开发文档，返回匹配的文档条目列表，包含标题、摘要、文档链接和相关标签。搜索结果按相关性排序。适用于开发者在集成或调试过程中快速查找 API 说明、接入指南、错误码解释等技术资料。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devdoc", "rpc_name": "search_open_platform_docs" }, "metadata_source": "embedded-mcp-metadata", "name": "search_open_platform_docs_rag", "primary_cli_path": "devdoc article search", "risk": "low", "title": "search_open_platform_docs", "use_when": [ "命中结果多时翻页", "开发文档/API 文档/接口文档", "开发者问\"OAuth2 怎么接", "查错误码 / 字段含义" ] } ], "use_when": [ "开发/API/调用错误 文档", "搜一下 OAuth2 接入文档；搜索开发文档" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.ding.prod.json", "skills/mono/SKILL.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "DING 消息 / 发送 / 撤回", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "description": "DING 消息 / 发送 / 撤回", "id": "ding", "name": "DING 消息 / 发送 / 撤回", "runtime": true, "tool_count": 2, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "撤回 DING 消息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“发送 DING 消息（应用内 / 短信 / 电话）”请改用 dws ding message send" ], "canonical_path": "ding.recall_ding_message", "cli_name": "recall", "cli_path": "ding message recall", "confirmation": "user_required", "description": "撤回已发送的DING消息", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "ding", "rpc_name": "recall_ding_message" }, "metadata_source": "embedded-mcp-metadata", "name": "recall_ding_message", "primary_cli_path": "ding message recall", "risk": "high", "use_when": [ "撤回 DING", "撤回DING；撤回 DING 消息", "机器人身份: 撤回" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "发送 DING 消息（应用内 / 短信 / 电话）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“撤回 DING 消息”请改用 dws ding message recall" ], "canonical_path": "ding.send_ding_message", "cli_name": "send", "cli_path": "ding message send", "confirmation": "not_required", "description": "发送 DING 消息给指定用户，支持配置机器人编码、接收人、提醒类型和消息内容。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "ding", "rpc_name": "send_ding_message" }, "metadata_source": "embedded-mcp-metadata", "name": "send_ding_message", "primary_cli_path": "ding message send", "risk": "medium", "title": "发送DING消息", "use_when": [ "DING 一下/紧急通知/电话提醒", "发DING/DING通知；发送 DING 消息", "机器人身份: 应用内 DING (免费)", "机器人身份: 电话 DING (紧急, 有成本!)" ] } ], "use_when": [ "DING/紧急消息/电话提醒" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json", "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "钉钉文档管理", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "avoid_when": [ "帮我建一个项目跟踪表；创建数据表格", "帮我看看收到的日报；收到的日志", "帮我记一下明天要做的事；创建个人待办", "我发给某人的消息/邮件/文档/今天我干了什么；搜行为记录" ], "description": "钉钉文档管理", "id": "doc", "name": "钉钉文档管理", "runtime": true, "tool_count": 36, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“从知识库节点移除指定企业用户的权限（仅支持 USER 类型）”请改用 dws doc permission remove", "要“修改企业用户在知识库节点上的角色（仅支持 USER 类型）”请改用 dws doc permission update", "要“查询知识库节点当前的成员权限列表”请改用 dws doc permission list" ], "canonical_path": "doc.add_permission", "cli_name": "add", "cli_path": "doc permission add", "confirmation": "not_required", "description": "为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量授予企业用户对节点的访问权限，添加成功后即可按指定角色访问该节点及其子节点（若子节点继承权限）。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口添加。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。\r\n- 入参直接采用扁平的 `userIds: List\u003cString\u003e`，每个元素为钉钉 staffId（外部 userId 格式，由钉钉开放平台体系下颁发）。如果你只有 unionId，请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "add_permission", "primary_cli_path": "doc permission add", "reviewed": false, "risk": "medium", "title": "添加节点成员", "use_when": [ "给单人开 READER 权限", "给多人开 EDITOR 权限（最多 30 个 uid）", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\u003e - \"把某篇文档授权给某人", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；新增权限", "设为管理者", "通过 alidocs URL 直接授权" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将指定节点复制到目标文件夹。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“将指定节点复制到目标文件夹。”所述变更时不要使用" ], "canonical_path": "doc.copy_document", "cli_name": "copy", "cli_path": "doc copy", "confirmation": "not_required", "description": "将指定节点复制到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时复制到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有可查看下载权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：复制操作底层可能异步执行，异步时操作已提交但新节点 ID 无法立即返回，请稍后查看目标文件夹确认结果。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "copy_document", "primary_cli_path": "doc copy", "reviewed": false, "risk": "medium", "title": "将指定节点复制到目标文件夹", "use_when": [ "复制到指定文件夹（异步）", "复制到目标知识库根目录", "复制到目标知识库根目录（不传 --folder 时）", "复制文档/拷贝一份/复制到；复制", "复制文档到指定文件夹（--node 支持 ID 或 URL）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建文档评论", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“回复文档评论”请改用 dws doc comment reply", "要“在钉钉文档中创建划词评论，评论关联文档内指定块的文本范围，支持”请改用 dws doc comment create-inline", "要“查询文档评论列表”请改用 dws doc comment list" ], "canonical_path": "doc.create_comment", "cli_name": "create", "cli_path": "doc comment create", "confirmation": "not_required", "description": "在钉钉文档中创建全文评论，评论不关联文档内具体位置，支持 @提及用户。\r\n\r\n通过 nodeId 定位文档，支持传入文档链接 URL 或文档 ID（dentryUuid）。\r\n- @提及用户：填写 mentionedUserIds，被提及用户会收到通知。\r\n如需创建划词评论（关联文档内指定文本范围），请使用 create_inline_comment 工具。\r\n如需回复已有评论，请使用 reply_comment 工具。\r\n操作受权限控制，仅当调用者对文档有评论权限时可创建评论。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc-comment", "rpc_name": "create_comment" }, "metadata_source": "embedded-mcp-metadata", "name": "create_comment", "primary_cli_path": "doc comment create", "risk": "medium", "title": "创建全文评论", "use_when": [ "2. 在文档上创建评论", "再将 userId 传入 --mention", "创建全文评论", "提取 userId 后:" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建一篇新的在线文档", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "在知识库里创建一个文档；创建空文件实体" ], "canonical_path": "doc.create_document", "cli_name": "create", "cli_path": "doc create", "confirmation": "not_required", "description": "创建一篇文字类型的钉钉在线文档（扩展名=adoc）。\r\n支持创建空文档或带有初始 Markdown 内容的文档。（如需创建钉钉AI表格、钉钉表格、钉钉脑图等其他类型的文件，使用 create_file 工具）\r\n支持三种创建位置：\r\n1. 指定 folderId：在该文件夹下创建\r\n2. 指定 workspaceId（知识库 ID）但不传 folderId：在该知识库的根目录下创建\r\n3. 都不传：在用户\"我的文档\"根目录下创建\r\n操作受权限控制，仅当调用者对目标位置有写入权限时可成功创建。\r\n内容长度上限 10000 字符，超出请使用 update_document 工具分批追加写入。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "create_document" }, "metadata_source": "embedded-mcp-metadata", "name": "create_document", "primary_cli_path": "doc create", "risk": "medium", "title": "创建钉钉文档", "use_when": [ "1. 创建空文档拿 nodeId", "2. 一步创建+写入：", "2. 创建文档 — 提取 nodeId", "5. 完整流程: 创建文档 → 写入内容 → 插入附件", "JSONML 创建到指定文件夹", "写文档/创建文档；新建文字文档（adoc）", "创建到指定文件夹", "创建到知识库", "创建空文档（仅取 nodeId 后再分步写入，适合 \u003e200KB 兜底）", "完整流程：创建文档 → 写入内容 → 插入附件", "查看具体命令的完整参数说明", "短纯文本字面量（\u003c 2KB 且无换行/表格才允许）", "详见 doc-create-workflow.md §JSONML 起稿判定", "默认创建到「我的文档」根目录（推荐文件路径）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建文件（文档/表格/脑图/白板/多维表/文件夹等）”所述变更时不要使用" ], "canonical_path": "doc.create_file", "cli_name": "create", "cli_path": "doc file create", "confirmation": "not_required", "description": "在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表或文件夹）。\r\n\r\n支持三种创建位置（按优先级）：\r\n1. 指定 folderId：在该文件夹下创建\r\n2. 仅指定 workspaceId（不传 folderId）：在该知识库的根目录下创建\r\n3. 都不传：在用户\"我的文档\"根目录下创建\r\n4. type 要创建的文件类型，必填。支持以下值：adoc（钉钉在线文档）、axls（钉钉表格）、appt（钉钉演示）、adraw（钉钉白板）、amind（钉钉脑图）、able（钉钉多维表）、folder（文件夹）\r\n操作受权限控制，仅当调用者对目标位置有写入权限时可成功创建。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "create_file" }, "metadata_source": "embedded-mcp-metadata", "name": "create_file", "primary_cli_path": "doc file create", "risk": "medium", "title": "创建节点", "use_when": [ "创建文件（文档/表格/脑图/白板/多维表/文件夹等）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建文件夹", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建文件夹”所述变更时不要使用" ], "canonical_path": "doc.create_folder", "cli_name": "create", "cli_path": "doc folder create", "confirmation": "not_required", "description": "在指定位置创建一个新的文件夹。\r\n\r\n支持在文件夹下或知识库下创建子文件夹。\r\n创建后返回新文件夹的节点 ID，可用于后续在该文件夹下创建文档或子文件夹。\r\n操作受权限控制，仅当调用者对父节点有写入权限时可成功创建。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "create_folder" }, "metadata_source": "embedded-mcp-metadata", "name": "create_folder", "primary_cli_path": "doc folder create", "risk": "medium", "title": "创建文件夹", "use_when": [ "在「我的文档」根目录创建", "在指定父文件夹下创建", "在知识库下创建" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在钉钉文档中创建划词评论，评论关联文档内指定块的文本范围，支持 @提及用户。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建文档评论”请改用 dws doc comment create", "要“回复文档评论”请改用 dws doc comment reply", "要“查询文档评论列表”请改用 dws doc comment list" ], "canonical_path": "doc.create_inline_comment", "cli_name": "create-inline", "cli_path": "doc comment create-inline", "confirmation": "not_required", "description": "在钉钉文档中创建划词评论，评论关联文档内指定块的文本范围，支持 @提及用户。\r\n\r\n通过 nodeId 定位文档，支持传入文档链接 URL 或文档 ID（dentryUuid）。\r\n- blockId、start、end 均为必填，用于定位评论标记的文本范围。\r\n- selectedText 可选填，填写后评论列表中会展示「引用原文：xxx」。\r\n- @提及用户：填写 mentionedUserIds，被提及用户会收到通知。\r\n如需创建全文评论（不关联文档内具体位置），请使用 create_comment 工具。\r\n如需回复已有评论，请使用 reply_comment 工具。\r\n操作受权限控制，仅当调用者对文档有评论权限时可创建评论。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc-comment", "rpc_name": "create_inline_comment" }, "metadata_source": "embedded-mcp-metadata", "name": "create_inline_comment", "primary_cli_path": "doc comment create-inline", "reviewed": false, "risk": "medium", "title": "创建划词评论", "use_when": [ "7. 创建划词评论并附带引用原文 + @ 相关人", "划词评论 + 引用原文 + @人", "确定选中文本在块内的起始偏移量 (start) 和结束偏移量 (end)", "计算偏移后：" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "用户未明确要求“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。”、目标不清楚或尚未确认时不要使用" ], "canonical_path": "doc.delete_document", "cli_name": "delete", "cli_path": "doc delete", "confirmation": "user_required", "description": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。\r\n\r\n支持范围：\r\n- 知识库（workspace）下的文档节点、文件夹节点\r\n- 钉盘「我的文件」或「团队空间（space）」下的文件、文件夹节点（但钉盘操作仍建议走钉盘MCP服务）\r\n\r\n不支持的操作：\r\n- 不支持直接删除知识库本身（workspace）\r\n- 不支持直接删除团队空间（space）\r\n\r\n权限要求：\r\n- 对目标节点有管理权限（owner 或被授予管理权限的成员）\r\n\r\n注意事项：\r\n- 删除操作不可立即撤销，请在调用前向用户确认\r\n- 删除文件夹时，文件夹内的所有子节点也会一并移入回收站", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "delete_document", "primary_cli_path": "doc delete", "reviewed": false, "risk": "high", "title": "删除节点", "use_when": [ "── delete（用户确认后才加 --yes）──", "删除文档/删掉这个文件/移到回收站/丢掉这篇文档；删除节点", "正确流程：1.向用户展示\"即将删除「文档名」到回收站\" → 2.等用户确认 → 3.执行下面命令" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除块元素（不可逆）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“将一个新的块元素插入指定文档，需要提供文档ID(dentryUu”请改用 dws doc block insert", "要“更新指定文档的指定块元素内容或样式，需要提供文档ID(dentr”请改用 dws doc block update", "要“查询文档一级块元素列表”请改用 dws doc block list" ], "canonical_path": "doc.delete_document_block", "cli_name": "delete", "cli_path": "doc block delete", "confirmation": "user_required", "description": "在指定文档中删除指定块元素，需要提供文档ID(dentryUuid)与块元素ID(blockId)。操作受文档权限控制，仅当调用者拥有编辑权限时生效。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "delete_document_block" }, "metadata_source": "embedded-mcp-metadata", "name": "delete_document_block", "primary_cli_path": "doc block delete", "risk": "high", "title": "删除块元素", "use_when": [ "5. 删除块", "删除（无需 format 区分）", "删除（用户确认后）", "编辑块/改段落/插入标题/删除块；删除" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取钉钉文档中指定附件的临时下载 URL。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“上传本地文件并作为附件插入文档（3 步合一：prepare +”请改用 dws doc media insert" ], "canonical_path": "doc.download_doc_attachment", "cli_name": "download", "cli_path": "doc media download", "confirmation": "not_required", "description": "获取钉钉文档中指定附件的临时下载 URL。\r\n传入文档标识 nodeId 和附件资源标识 resourceId，返回附件的 OSS 临时下载链接 downloadUrl。\r\n前置依赖：需先调用 list_document_blocks 获取文档块列表，从中找到 blockType 为 attachment 的块元素，提取其 resourceId 作为本工具的入参。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "download_doc_attachment", "primary_cli_path": "doc media download", "reviewed": false, "risk": "low", "title": "下载指定钉钉文档中的指定附件", "use_when": [ "下载文件/导出文件/下载到本地；下载", "下载文档中的附件（resourceId 从 block list 获取）", "下载附件/获取附件/取出文档里的附件；下载附件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取文件下载凭证，供 AI Agent 自行发起 HTTP GET 请求下载文件内容。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取文件下载凭证，供 AI Agent 自行发起 HTTP GET 请求下载文件内容。”" ], "canonical_path": "doc.download_file", "cli_name": "download", "cli_path": "doc download", "confirmation": "not_required", "description": "获取文件下载凭证，供 AI Agent 自行发起 HTTP GET 请求下载文件内容。本工具是两步下载流程的第一步（也是唯一需要调用的 MCP Tool）。\r\n\r\n完整下载流程：\r\n Step 1：调用本工具，传入文件节点 ID（nodeId），获取下载 URL（resourceUrl）和签名请求头（headers）。\r\n Step 2：AI Agent 自行发起 HTTP GET 请求：\r\n - URL：使用 resourceUrl 中的第一个 URL（优先级最高）。\r\n - Headers：将 headers 中所有键值对作为请求头携带。\r\n - 期望响应：HTTP 200，Body 为文件二进制内容。\r\n - 注意：下载凭证有过期时间（expirationSeconds），请在过期前完成下载；若已过期，需重新调用本工具获取新凭证。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "download_file", "primary_cli_path": "doc download", "reviewed": false, "risk": "low", "title": "获取文件下载凭证", "use_when": [ "指定文件路径", "自动推断文件名，下到目录" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "读取文档内容（Markdown）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“读取文档内容（Markdown）”" ], "canonical_path": "doc.get_document_content", "cli_name": "read", "cli_path": "doc read", "confirmation": "not_required", "description": "获取钉钉文档的内容，以 Markdown 格式返回。\r\n\r\n通过 nodeId 定位文档，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。\r\n\r\n支持的文档类型：钉钉在线文档。\r\n文档链接格式：https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\r\ndentryUuid 为 32 位字母数字字符串。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "get_document_content" }, "metadata_source": "embedded-mcp-metadata", "name": "get_document_content", "primary_cli_path": "doc read", "risk": "low", "title": "获取钉钉文档内容", "use_when": [ "1. 读出完整 JSONML 结构（输出含 revision，普通改写场景下不需要）", "4. 读取文档内容 (Markdown 格式)", "JSONML 完整结构 → 文件（无损改写前置）", "alidocs URL 直传", "查看具体命令的完整参数说明", "看文档/读内容/文档内容；读取", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"帮我看看这个文档", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；默认", "编辑块/改段落/插入标题/删除块；\"帮我看看这个文档", "编辑块/改段落/插入标题/删除块；默认", "默认 Markdown 输出（最常用）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取文档元信息（标题/类型/创建者/权限等）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取文档元信息（标题/类型/创建者/权限等）”" ], "canonical_path": "doc.get_document_info", "cli_name": "info", "cli_path": "doc info", "confirmation": "not_required", "description": "获取存储在钉钉文档（含知识库）、钉盘相关文件的元信息，包括文档标题、类型、创建者、创建时间等。\r\n返回字段中的 contentType 和 extension 是后续工具路由的关键依据。\r\n\r\n⚠️ 重要：当用户需要获取任何钉钉文件的内容时，必须先调用本工具，\r\n再根据返回的 contentType 和 extension 字段按以下规则选择对应工具：\r\n\r\n- contentType=ALIDOC, extension=adoc → 调用 get_document_content(nodeId)，返回 Markdown 内容\r\n- contentType=ALIDOC, extension=axls → 调用钉钉表格 MCP: get_all_sheets(nodeId) 获取工作表列表，再调用 get_range(nodeId, sheetId, range) 读取数据\r\n- contentType=ALIDOC, extension=able → 调用钉钉AI表格 MCP: get_tables(nodeId) 获取数据表列表（nodeId 即 baseId），再调用 query_records(nodeId, tableId) 查询记录\r\n- contentType≠ALIDOC 且 nodeType=file → 调用 download_file(nodeId)，返回文件下载链接", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "get_document_info" }, "metadata_source": "embedded-mcp-metadata", "name": "get_document_info", "primary_cli_path": "doc info", "risk": "low", "title": "获取节点基本信息", "use_when": [ "3. 获取文档元信息 (标题、类型、权限)", "alidocs URL 直传（CLI 自动解析）", "document/edit URL 直传（必须完整 URL，禁止单独提取 dentryKey）", "document/preview URL 直传", "❌ workspaceId（应作为 --workspace 用）", "❌ 单独的 dentryKey（必须带完整 URL）", "❌ 纯数字 dentryId（drive 链路）", "标准用法（nodeId 直传）", "步骤 1: 查询文件类型", "看文档/读内容/文档内容；元信息", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"这个文档的信息", "编辑块/改段落/插入标题/删除块；\"这个文档的信息", "这个 alidocs 表格链接帮我看下\"（粘贴原始 URL）；先 probe 节点类型" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据 taskId 查询文档导入任务的执行结果", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要根据 taskId 查询文档导入任务的执行结果时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.import_get", "cli_name": "get", "cli_path": "doc import get", "confirmation": "not_required", "description": "根据 taskId 查询文档导入任务的执行结果。\n通常不需要手动调用，dws doc import 会自动完成轮询。\n仅在导入命令超时或中断后，用于手动查询任务状态。\n\n任务状态:\n processing 转换中\n completed 导入成功，返回 documentUrl\n failed 导入失败", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "import_get", "primary_cli_path": "doc import get", "reviewed": false, "risk": "medium", "title": "查询导入任务结果（手动兜底）", "use_when": [ "根据 taskId 查询文档导入任务的执行结果" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将一个新的块元素插入指定文档，需要提供文档ID(dentryUuid)与块元素内容(必须包含 blockType 及对应类型的属性对象)。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除块元素（不可逆）”请改用 dws doc block delete", "要“更新指定文档的指定块元素内容或样式，需要提供文档ID(dentr”请改用 dws doc block update", "要“查询文档一级块元素列表”请改用 dws doc block list" ], "canonical_path": "doc.insert_document_block", "cli_name": "insert", "cli_path": "doc block insert", "confirmation": "not_required", "description": "将一个新的块元素插入指定文档，需要提供文档ID(dentryUuid)与块元素内容(必须包含 blockType 及对应类型的属性对象)。可以支持在指定块元素(传入blockId或index)的头部或尾部插入块元素。操作受文档权限控制，仅当调用者拥有编辑权限时生效。\r\n\r\n【附件插入说明】\r\n若 blockType 为 \"attachment\"：\r\n1. 必须先调用 get_doc_attachment_upload_info 工具获取该附件的属性（resourceId）。\r\n2. 将获取到的信息整合进 element 的 attachment 对象中，然后再调用此工具。\r\n\r\n【get_doc_attachment_upload_info 接口使用说明】\r\n获取向指定钉钉文档上传附件所需的 OSS 上传凭证信息。\r\n使用流程：\r\n1. 调用 get_doc_attachment_upload_info 接口，传入文档标识（nodeId）、文件名、文件大小和 MIME 类型，获取上传凭证。\r\n2. 使用返回的 uploadUrl 通过 HTTP PUT 请求将文件内容上传至 OSS，需设置以下请求头：\r\n Content-Type：与入参 mimeType 保持一致，例如 `application/pdf`\r\n Content-Length：与入参 fileSize 保持一致，单位为字节\r\n3. 上传成功后，使用返回的 resourceId 在文档中插入类型为附件的块元素。\r\n\r\n注意事项：\r\n1. uploadUrl 具有时效性，请在获取后尽快完成上传，避免凭证过期。\r\n2. fileSize 必须与实际文件大小一致，否则上传可能失败。\r\n3. mimeType 应与实际文件类型匹配，例如 PDF 文件传 application/pdf。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "insert_document_block", "primary_cli_path": "doc block insert", "reviewed": false, "risk": "medium", "title": "插入块元素", "use_when": [ "2. 在文档末尾插入段落", "3. 在指定块之前插入标题", "Callout（element JSON 次选；首选 JSONML container[subType=colorBlocks]）", "分栏（2 栏）", "单元格内含多段落 + 代码块", "在指定 block 之前插入", "在某个 block 后插入", "容器内定位插入（指定 parent + index）", "嵌入文件预览", "带格式文本（多个 leaf）", "带链接（link 是与 text 并列的子节点）", "引用块", "待办列表（checkbox）", "插入 JSONML 节点（同级定位）", "插入 JSONML 节点（容器内定位）", "插入分栏块(columns)：2 栏，children 为每栏的内容", "插入复杂块（callout / 分栏）—— element 默认按 JSON 解析", "插入引用块(blockquote)", "插入段落（同级定位）", "插入行内图片(inline image)：构造一个空 paragraph，在 children 中用 image elementType 指定图片 src", "插入表格(table)：2 行 3 列", "插入附件块(attachment)：resourceId 为资源ID，type 为 MIME 类型，viewType 可选 preview/summary", "文本段落", "无序列表项", "有序列表项（仅第一项设 start，后续项不设，系统自动递增）", "查看具体命令的完整参数说明", "标题（level 1-6）", "纯文本段落", "编辑块/改段落/插入标题/删除块；插入", "缩进子项（level: 1）", "群名片", "蓝色高亮块", "表格（2x3）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询文档评论列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建文档评论”请改用 dws doc comment create", "要“回复文档评论”请改用 dws doc comment reply", "要“在钉钉文档中创建划词评论，评论关联文档内指定块的文本范围，支持”请改用 dws doc comment create-inline" ], "canonical_path": "doc.list_comments", "cli_name": "list", "cli_path": "doc comment list", "confirmation": "not_required", "description": "获取钉钉文档的评论列表，支持分页查询、按评论类型和解决状态过滤。\r\n通过 nodeId 定位文档，支持传入文档链接 URL 或文档 ID（dentryUuid）。\r\n操作受权限控制，仅当调用者对文档有读取及以上权限时可获取评论。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc-comment", "rpc_name": "list_comments" }, "metadata_source": "embedded-mcp-metadata", "name": "list_comments", "primary_cli_path": "doc comment list", "risk": "low", "title": "获取文档评论列表", "use_when": [ "1. 查看文档的所有评论", "仅看未解决的划词评论", "查看文档全部评论" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询文档一级块元素列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除块元素（不可逆）”请改用 dws doc block delete", "要“将一个新的块元素插入指定文档，需要提供文档ID(dentryUu”请改用 dws doc block insert", "要“更新指定文档的指定块元素内容或样式，需要提供文档ID(dentr”请改用 dws doc block update" ], "canonical_path": "doc.list_document_blocks", "cli_name": "list", "cli_path": "doc block list", "confirmation": "not_required", "description": "查询指定钉钉文档下的一级块元素列表，需要提供dentryUuid。支持按按起始位置、终止位置范围及块类型过滤。操作受文档权限控制，当调用者拥有编辑或查看或下载权限时生效。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_document_blocks" }, "metadata_source": "embedded-mcp-metadata", "name": "list_document_blocks", "primary_cli_path": "doc block list", "risk": "low", "title": "查询指定钉钉文档下的一级块元素列表", "use_when": [ "1. 列出所有 block 拿到 uuid", "1. 查看文档块结构 — 获取 blockId", "1. 获取当前结构", "2. 读单个 block 完整子树", "划词评论（先 block list 取 blockId + paragraph.text，计算 start/end）", "列出 + 取 uuid", "列出所有 block，定位 BLOCK_ID", "列出顶层 JSONML 节点", "编辑块/改段落/插入标题/删除块；查看结构", "读单个 block 完整子树", "读取指定 uuid 的完整子树" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "遍历文件夹或知识库下的直接子节点", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“遍历文件夹或知识库下的直接子节点”" ], "canonical_path": "doc.list_nodes", "cli_name": "list", "cli_path": "doc list", "confirmation": "not_required", "description": "列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等），支持分页。\r\n\r\n返回结果基于当前 MCP 会话用户的可访问权限进行过滤。\r\n返回的节点列表包含多种类型：在线文档、文件夹、PDF、docx、表格、脑图、白板等。\r\n\r\n定位方式（按优先级）：\r\n1. 传 folderId：列出该文件夹下的直接子节点\r\n2. 仅传 workspaceId（不传 folderId）：列出该知识库根目录下的直接子节点\r\n3. 都不传：列出用户\"我的文档\"根目录下的直接子节点\r\n\r\n返回的 nodeId 可直接用于其他工具（如 get_document_content、update_document、create_document 等）。\r\n若 nodeType=folder 且 hasChildren=true，可将该 nodeId 作为 folderId 再次调用本工具进行递归遍历。\r\n若 contentType=alidoc，可调用 get_document_content(nodeId=nodeId) 获取文档内容。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_nodes" }, "metadata_source": "embedded-mcp-metadata", "name": "list_nodes", "primary_cli_path": "doc list", "risk": "low", "title": "列出指定文件夹或知识库下的直接子节点列表", "use_when": [ "遍历文件夹或知识库下的直接子节点" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询知识库节点当前的成员权限列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员”请改用 dws doc permission add", "要“从知识库节点移除指定企业用户的权限（仅支持 USER 类型）”请改用 dws doc permission remove", "要“修改企业用户在知识库节点上的角色（仅支持 USER 类型）”请改用 dws doc permission update" ], "canonical_path": "doc.list_permission", "cli_name": "list", "cli_path": "doc permission list", "confirmation": "not_required", "description": "查询知识库节点当前的成员权限列表。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_permission", "primary_cli_path": "doc permission list", "reviewed": false, "risk": "low", "title": "查询节点成员列表", "use_when": [ "拉取更多结果（默认 50，最大 200）", "按角色过滤查看", "查看谁有权限", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；查看谁有权限" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "上传本地文件并作为附件插入文档（3 步合一：prepare + PUT + insert）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“获取钉钉文档中指定附件的临时下载 URL”请改用 dws doc media download" ], "canonical_path": "doc.media_insert", "cli_name": "insert", "cli_path": "doc media insert", "confirmation": "not_required", "description": "将本地文件作为附件上传并插入到钉钉文档中（三步自动完成）。\n\n流程:\n 1. 获取附件上传凭证 (get_doc_attachment_upload_info)\n 2. HTTP PUT 上传文件到 OSS\n 3. 插入附件块到文档 (insert_document_block)\n\n--mime-type 可选，不指定时根据文件扩展名自动推断。", "effect": "write", "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "name": "media_insert", "primary_cli_path": "doc media insert", "reviewed": true, "risk": "medium", "title": "上传附件并插入文档", "use_when": [ "1. 基本用法: 插入本地文件到文档", "2. 指定附件显示名称", "3. 指定 MIME 类型 (文件扩展名无法推断时)", "4. 在指定块之前插入附件", "上传本地文件并作为附件插入文档（3 步合一：prepare + PUT + insert）", "在指定块之前插入附件", "基本用法：插入本地文件到文档", "指定 MIME 类型（扩展名无法推断时）", "指定附件显示名称", "提取 nodeId 后:", "插入图片/加图片/放张图/嵌入图片/往文档里插图；插入图片", "插入附件/上传附件到文档/往文档里加文件/加附件；插入附件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将指定节点移动到目标文件夹。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“将指定节点移动到目标文件夹。”所述变更时不要使用" ], "canonical_path": "doc.move_document", "cli_name": "move", "cli_path": "doc move", "confirmation": "not_required", "description": "将指定节点移动到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时移动到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有编辑权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：移动操作底层可能异步执行，异步时操作已提交但无法立即确认完成，请稍后查看目标文件夹确认结果。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "move_document", "primary_cli_path": "doc move", "reviewed": false, "risk": "medium", "title": "移动节点", "use_when": [ "移动到指定文件夹", "移动到目标知识库根目录（不传 --folder 时）", "移动到知识库根目录", "移动文档/搬到/移到/转移文件；移动", "移动文档到指定文件夹" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "用于查询通过 submit_export_job 提交的文字文档导出任务的执行状态，任务完成时返回文件下载链接。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“用于查询通过 submit_export_job 提交的文字文档导出任务的执行状态，任务完成时返回文件下载链接。”" ], "canonical_path": "doc.query_export_job", "cli_name": "get", "cli_path": "doc export get", "confirmation": "not_required", "description": "用于查询通过 submit_export_job 提交的文字文档导出任务的执行状态，任务完成时返回文件下载链接。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "query_export_job", "primary_cli_path": "doc export get", "reviewed": false, "risk": "low", "title": "查询文档导出任务状态", "use_when": [ "兜底：超时或中断后手动查任务" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员”请改用 dws doc permission add", "要“修改企业用户在知识库节点上的角色（仅支持 USER 类型）”请改用 dws doc permission update", "要“查询知识库节点当前的成员权限列表”请改用 dws doc permission list" ], "canonical_path": "doc.remove_permission", "cli_name": "remove", "cli_path": "doc permission remove", "confirmation": "user_required", "description": "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量移除成员在节点上的权限，移除后相关用户将无法通过该节点的直接授权访问内容（若有父节点继承权限则仍可通过继承权限访问）。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口移除。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。DOWNLOADER / READER / 非成员调用会返回 `forbidden.accessDenied`，错误信息会明确提示所需的最低角色。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "remove_permission", "primary_cli_path": "doc permission remove", "reviewed": false, "risk": "high", "title": "移除节点成员权限", "use_when": [ "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "对指定节点进行重命名。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“对指定节点进行重命名。”所述变更时不要使用" ], "canonical_path": "doc.rename_document", "cli_name": "rename", "cli_path": "doc rename", "confirmation": "not_required", "description": "对指定节点进行重命名。\r\n\r\n支持范围：\r\n- 知识库（workspace）下的文档节点、文件夹节点\r\n\r\n权限要求：\r\n- 对目标节点有编辑权限", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "rename_document", "primary_cli_path": "doc rename", "reviewed": false, "risk": "medium", "title": "对指定节点进行重命名", "use_when": [ "── rename ──", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"把这个文档标题改成 X\" / \"这个文档改名为 X", "重命名/rename/改名/改文档名/修改文档名称/修改文档标题/把这个文档叫做...；重命名", "重命名文档" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "回复文档评论", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建文档评论”请改用 dws doc comment create", "要“在钉钉文档中创建划词评论，评论关联文档内指定块的文本范围，支持”请改用 dws doc comment create-inline", "要“查询文档评论列表”请改用 dws doc comment list" ], "canonical_path": "doc.reply_comment", "cli_name": "reply", "cli_path": "doc comment reply", "confirmation": "not_required", "description": "回复钉钉文档中的已有评论，支持普通文字回复和表情贴图回复，支持 @提及用户。\r\n\r\n通过 nodeId 定位文档，通过 replyCommentKey 指定被回复的评论（可从 create_comment 或 list_comments 的返回结果中获取）。\r\n- 普通回复：填写 content，不填 emoji。\r\n- 表情贴图回复：填写 content（表情名称），同时将 emoji 设为 true。表情回复的 categoryFeature 会自动从被回复评论继承。\r\n- @提及用户：填写 mentionedUserIds，被提及用户会收到通知。\r\n操作受权限控制，仅当调用者对文档有评论权限时可回复评论。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc-comment", "rpc_name": "reply_comment" }, "metadata_source": "embedded-mcp-metadata", "name": "reply_comment", "primary_cli_path": "doc comment reply", "risk": "medium", "title": "回复评论", "use_when": [ "4. 回复某条评论（commentKey 从 list 或 create 返回中获取）", "5. 用表情回复评论", "文字回复", "表情回复（--content 填表情名称）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "搜索文档（不传关键词返回最近访问）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "搜一下 OAuth2 接入文档；搜索开发文档", "搜一下智能化方案/最近 OKR 相关邮件/最近发版相关消息；搜企业知识内容" ], "canonical_path": "doc.search_documents", "cli_name": "search", "cli_path": "doc search", "confirmation": "not_required", "description": "根据关键词和多种过滤条件搜索当前用户有权限访问的文档列表。\r\n\r\n支持的过滤条件：\r\n- keyword：关键词匹配文档标题和内容\r\n- extensions：按文件扩展名精确过滤（pdf/docx/png 等）\r\n- createdTimeFrom / createdTimeTo：按创建时间范围过滤\r\n- visitedTimeFrom / visitedTimeTo：按访问时间范围过滤\r\n- creatorUserIds：按创建者用户 ID 过滤\r\n - editorUserIds：按编辑者用户 ID 过滤\r\n- mentionedUserIds：按文档中 @提及的用户 ID 过滤\r\n- workspaceIds：按知识库范围过滤（支持知识库 URL）\r\n\r\n支持分页获取结果。搜索范围为用户在当前组织内有权限访问的所有文档数据。\r\n所有过滤条件均为可选，不传则不过滤。多个条件同时传入时取交集", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "search_documents" }, "metadata_source": "embedded-mcp-metadata", "name": "search_documents", "primary_cli_path": "doc search", "risk": "low", "title": "搜索文档", "use_when": [ "搜索文档（不传关键词返回最近访问）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "使用指定模板创建新文档", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要使用指定模板创建新文档时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.template_apply", "cli_name": "apply", "cli_path": "doc template apply", "confirmation": "not_required", "description": "使用指定模板创建新文档。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "template_apply", "primary_cli_path": "doc template apply", "reviewed": false, "risk": "medium", "title": "应用文档模板", "use_when": [ "使用指定模板创建新文档" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取当前用户可用的文档模板列表，支持按来源筛选", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要获取当前用户可用的文档模板列表，支持按来源筛选时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.template_list", "cli_name": "list", "cli_path": "doc template list", "confirmation": "not_required", "description": "获取当前用户可用的文档模板列表，支持按来源筛选。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "template_list", "primary_cli_path": "doc template list", "reviewed": false, "risk": "low", "title": "获取文档模板列表", "use_when": [ "获取当前用户可用的文档模板列表，支持按来源筛选" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据关键词搜索文档模板", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要根据关键词搜索文档模板时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.template_search", "cli_name": "search", "cli_path": "doc template search", "confirmation": "not_required", "description": "根据关键词搜索文档模板。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "template_search", "primary_cli_path": "doc template search", "reviewed": false, "risk": "low", "title": "搜索文档模板", "use_when": [ "根据关键词搜索文档模板" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新文档内容（追加 / 覆盖）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新文档内容（追加 / 覆盖）”所述变更时不要使用" ], "canonical_path": "doc.update_document", "cli_name": "update", "cli_path": "doc update", "confirmation": "not_required", "description": "更新钉钉文档的内容，扩展名=adoc，其他类型在线文档不能使用此mcp服务，支持两种更新模式。\r\n\r\n## 更新模式\r\n\r\n1. **overwrite**（覆盖，默认）：清空文档全部内容后重新写入。适用于需要完整替换文档内容的场景。⚠️ 会丢失原有内容，请谨慎使用。\r\n2. **append**（追加）：在文档末尾追加新内容。最安全的模式，不影响现有内容。\r\n 支持通过 index 参数指定插入位置（从 0 开始）；不传 index 时追加到末尾。\r\n block 的 index 可通过 list_document_blocks 工具获取。\r\n 插入成功后，该位置及之后的所有 block 的 index 会依次 +1。\r\n\r\n## 注意事项\r\n- 默认模式为 overwrite，不传 mode 时使用覆盖模式\r\n- overwrite 模式会清空所有内容，包括图片、评论等，请谨慎使用\r\n- 写入内容长度上限 10000 字符，超出请分批写入", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "update_document" }, "metadata_source": "embedded-mcp-metadata", "name": "update_document", "primary_cli_path": "doc update", "risk": "medium", "title": "更新钉钉文档的内容", "use_when": [ "2. 一步写入：", "2. 逐个追加：", "3. 写入内容 (追加模式)", "3. 逐个追加：", "4. 提交修改（默认直接覆盖，不做并发检查）", "JSONML 整篇无损 overwrite（默认不做并发检查；并发敏感时加 --revision \u003cN\u003e）", "append 到指定 block 前（index 通过 doc block list 获取）", "append 末尾追加", "heredoc（真实换行，含表格）", "overwrite 整段（用户已确认）", "stdin（heredoc，含表格）", "写文档/创建文档；整篇覆盖替换", "写文档/创建文档；追加内容", "插入分割线：使用 doc update --mode append 以 Markdown 格式追加", "短文本字面量（\u003c2KB 无换行）", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"往这个文档追加内容", "编辑块/改段落/插入标题/删除块；\"往这个文档追加内容" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新指定文档的指定块元素内容或样式，需要提供文档ID(dentryUuid)、块元素ID(blockId)与块元素内容(必须包含 blockType 及对应类型的属性对象)。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除块元素（不可逆）”请改用 dws doc block delete", "要“将一个新的块元素插入指定文档，需要提供文档ID(dentryUu”请改用 dws doc block insert", "要“查询文档一级块元素列表”请改用 dws doc block list" ], "canonical_path": "doc.update_document_block", "cli_name": "update", "cli_path": "doc block update", "confirmation": "not_required", "description": "更新指定文档的指定块元素内容或样式，需要提供文档ID(dentryUuid)、块元素ID(blockId)与块元素内容(必须包含 blockType 及对应类型的属性对象)。操作受文档权限控制，仅当调用者拥有编辑权限时生效。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_document_block", "primary_cli_path": "doc block update", "reviewed": false, "risk": "medium", "title": "更新块元素", "use_when": [ "2. 修改后写回（uuid 不变）", "3. 改完后写回（uuid 必须 == --block-id）", "4. 更新某个块的内容", "修改某块文本", "修改标题", "改一个 block 的文本", "整体替换（update 时 uuid 必须等于 --block-id）", "整体替换（update 的 uuid 必须等于 --block-id）", "更新已有标题", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"把正文里的一级标题/章节标题改成 X", "编辑块/改段落/插入标题/删除块；\"编辑这个文档的标题", "编辑块/改段落/插入标题/删除块；修改" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "修改企业用户在知识库节点上的角色（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员”请改用 dws doc permission add", "要“从知识库节点移除指定企业用户的权限（仅支持 USER 类型）”请改用 dws doc permission remove", "要“查询知识库节点当前的成员权限列表”请改用 dws doc permission list" ], "canonical_path": "doc.update_permission", "cli_name": "update", "cli_path": "doc permission update", "confirmation": "user_required", "description": "修改企业用户在知识库节点上的角色（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量调整成员角色，同一成员在同一节点只能拥有一个角色，变更后旧角色自动替换。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口变更。\r\n- 若成员的角色来自父节点的权限继承（PASS_ON 模式），且继承的角色高于目标角色，接口会拒绝操作。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。\r\n- 入参直接采用扁平的 `userIds: List\u003cString\u003e`，每个元素为钉钉 staffId（外部 userId 格式，由钉钉开放平台体系下颁发）。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_permission", "primary_cli_path": "doc permission update", "reviewed": false, "risk": "high", "title": "变更节点成员角色", "use_when": [ "修改某人角色（READER → EDITOR）", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；修改权限" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "上传文件到钉钉文档或知识库", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“上传文件到钉钉文档或知识库”所述变更时不要使用" ], "canonical_path": "doc.upload", "cli_name": "upload", "cli_path": "doc upload", "confirmation": "not_required", "description": "将本地文件上传到钉钉文档或钉钉知识库（三步上传流程）。\n\n流程:\n 1. 获取 OSS 上传凭证 (get_file_upload_info)\n 2. HTTP PUT 上传文件二进制到 OSS\n 3. 提交文件入库 (commit_uploaded_file)\n\n上传位置优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)", "effect": "write", "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "name": "upload", "primary_cli_path": "doc upload", "reviewed": true, "risk": "medium", "title": "上传文件到钉钉文档或钉钉知识库", "use_when": [ "1. 上传到\"我的文档\"根目录", "2. 上传到指定文件夹", "3. 上传到知识库并转换为在线文档", "上传到「我的文档」根目录", "上传到指定文件夹", "上传到知识库并转换为在线文档", "上传文件/传文件/上传到文档/上传到知识库；上传", "上传文件/传文件/上传到文档/上传到知识库；上传并转换", "上传文件到钉钉文档或知识库" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查看文档历史版本列表", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要查看文档历史版本列表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.version_list", "cli_name": "list", "cli_path": "doc version list", "confirmation": "not_required", "description": "查看文档历史版本列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "version_list", "primary_cli_path": "doc version list", "reviewed": false, "risk": "low", "use_when": [ "查看文档历史版本列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "回滚文档到指定版本", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要回滚文档到指定版本时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.version_revert", "cli_name": "revert", "cli_path": "doc version revert", "confirmation": "not_required", "description": "回滚文档到指定版本", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "version_revert", "primary_cli_path": "doc version revert", "reviewed": false, "risk": "low", "use_when": [ "回滚文档到指定版本" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "手动保存文档版本快照", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要手动保存文档版本快照时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.version_save", "cli_name": "save", "cli_path": "doc version save", "confirmation": "not_required", "description": "手动保存文档版本快照", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "version_save", "primary_cli_path": "doc version save", "reviewed": false, "risk": "medium", "use_when": [ "手动保存文档版本快照" ] } ], "use_when": [ "帮我写个项目周报；创建钉钉文档", "钉钉文档/云文档/知识库/读写文档/块级编辑/文档评论/文档复制移动" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json", "skills/mono/SKILL.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "钉盘文件管理", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "description": "钉盘文件管理", "id": "drive", "name": "钉盘文件管理", "runtime": true, "tool_count": 23, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“从知识库节点移除指定企业用户的权限（仅支持 USER 类型）”请改用 dws drive permission remove", "要“修改企业用户在知识库节点上的角色（仅支持 USER 类型）”请改用 dws drive permission update", "要“查询知识库节点当前的成员权限列表”请改用 dws drive permission list" ], "canonical_path": "drive.add_permission", "cli_name": "add", "cli_path": "drive permission add", "confirmation": "not_required", "description": "为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量授予企业用户对节点的访问权限，添加成功后即可按指定角色访问该节点及其子节点（若子节点继承权限）。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口添加。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。\r\n- 入参直接采用扁平的 `userIds: List\u003cString\u003e`，每个元素为钉钉 staffId（外部 userId 格式，由钉钉开放平台体系下颁发）。如果你只有 unionId，请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "add_permission" }, "metadata_source": "embedded-mcp-metadata", "name": "add_permission", "primary_cli_path": "drive permission add", "reviewed": false, "risk": "medium", "title": "添加节点成员", "use_when": [ "给文档授权/分享权限" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "提交文件上传", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“提交文件上传”所述变更时不要使用" ], "canonical_path": "drive.commit_upload", "cli_name": "commit", "cli_path": "drive commit", "confirmation": "not_required", "description": "文件上传流程：\r\nStep 1：调用 get_upload_info 获取预签名的 OSS 上传 URL\r\nStep 2：使用 Step 1 返回的 URL 将文件 PUT 到 OSS\r\nStep 3：调用本接口提交文件，传入Step 1返回的 uploadId 与对应的 fileName、fileSize 完成文件上传", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "commit_upload" }, "metadata_source": "embedded-mcp-metadata", "name": "commit_upload", "primary_cli_path": "drive commit", "risk": "medium", "title": "commit_upload", "use_when": [ "提交文件上传" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将指定节点复制到目标文件夹。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“将指定节点复制到目标文件夹。”所述变更时不要使用" ], "canonical_path": "drive.copy_document", "cli_name": "copy", "cli_path": "drive copy", "confirmation": "not_required", "description": "将指定节点复制到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时复制到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有可查看下载权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：复制操作底层可能异步执行，异步时操作已提交但新节点 ID 无法立即返回，请稍后查看目标文件夹确认结果。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "copy_document" }, "metadata_source": "embedded-mcp-metadata", "name": "copy_document", "primary_cli_path": "drive copy", "reviewed": false, "risk": "medium", "title": "将指定节点复制到目标文件夹", "use_when": [ "── 场景 A: 复制钉盘文件到知识库空间根目录 ──", "── 场景 C: 复制钉盘文件到钉盘 space 下的子文件夹 ──", "── 场景默认: 用户未指定目标位置 → 复制/移动到「我的文件」根目录 ──", "复制文件/移动文件/搬到/移到" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建文件夹", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建文件夹”所述变更时不要使用" ], "canonical_path": "drive.create_folder", "cli_name": "mkdir", "cli_path": "drive mkdir", "confirmation": "not_required", "description": "在钉盘中创建一个新文件夹\r\n最简用法：只传 name，文件夹会创建在当前用户「我的文件」的根目录下。\r\n如果想创建在某个子文件夹里，传 parentId（从 list_files 或 create_folder 的返回值中获取）。\r\n创建成功后返回 fileId，可直接用于后续操作（如在该文件夹下继续创建子文件夹或上传文件）。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "create_folder" }, "metadata_source": "embedded-mcp-metadata", "name": "create_folder", "primary_cli_path": "drive mkdir", "risk": "medium", "title": "创建文件夹", "use_when": [ "5. 创建文件夹", "新建文件夹/创建目录" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "用户未明确要求“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。”、目标不清楚或尚未确认时不要使用" ], "canonical_path": "drive.delete_document", "cli_name": "delete", "cli_path": "drive delete", "confirmation": "user_required", "description": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。\r\n\r\n支持范围：\r\n- 知识库（workspace）下的文档节点、文件夹节点\r\n- 钉盘「我的文件」或「团队空间（space）」下的文件、文件夹节点（但钉盘操作仍建议走钉盘MCP服务）\r\n\r\n不支持的操作：\r\n- 不支持直接删除知识库本身（workspace）\r\n- 不支持直接删除团队空间（space）\r\n\r\n权限要求：\r\n- 对目标节点有管理权限（owner 或被授予管理权限的成员）\r\n\r\n注意事项：\r\n- 删除操作不可立即撤销，请在调用前向用户确认\r\n- 删除文件夹时，文件夹内的所有子节点也会一并移入回收站", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "delete_document" }, "metadata_source": "embedded-mcp-metadata", "name": "delete_document", "primary_cli_path": "drive delete", "reviewed": false, "risk": "high", "title": "删除节点", "use_when": [ "删除文件/删除文件夹/移到回收站", "正确流程：1.向用户展示\"即将删除「文件名」到回收站\" → 2.等用户确认 → 3.执行下面命令" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取文件下载链接", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "把这个在线表格导出为 xlsx 文件；在线表格格式转换" ], "canonical_path": "drive.download_file", "cli_name": "download", "cli_path": "drive download", "confirmation": "not_required", "description": "获取钉盘普通文件的下载链接。调用钉盘文件下载接口，返回 OSS 预签名下载链接，链接有效期 15 分钟", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "download_file" }, "metadata_source": "embedded-mcp-metadata", "name": "download_file", "primary_cli_path": "drive download", "risk": "low", "title": "下载文件", "use_when": [ "4. 下载文件到本地", "下载文件", "查看具体命令的完整参数说明", "读一下这个 xlsx 的数据\" / xlsx 节点链接；下载本地表格文件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取文件元数据信息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取文件元数据信息”" ], "canonical_path": "drive.get_file_info", "cli_name": "info", "cli_path": "drive info", "confirmation": "not_required", "description": "获取钉盘中指定节点（文件或文件夹）的元数据信息，包括文件名、类型、状态、路径、创建时间、文件大小等", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "get_file_info" }, "metadata_source": "embedded-mcp-metadata", "name": "get_file_info", "primary_cli_path": "drive info", "risk": "low", "title": "获取文件元数据信息", "use_when": [ "3. 查看文件元数据", "文件详情/文件信息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取文件上传信息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取文件上传信息”" ], "canonical_path": "drive.get_upload_info", "cli_name": "upload-info", "cli_path": "drive upload-info", "confirmation": "not_required", "description": "文件上传流程：\r\nStep 1：调用本接口获取预签名的 OSS 上传 URL\r\nStep 2：使用 Step 1 返回的 URL 将文件 PUT 到 OSS\r\nStep 3：调用commit_upload 提交文件，传入本接口返回的 uploadId 与对应的 fileName、fileSize 完成文件上传", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "get_upload_info" }, "metadata_source": "embedded-mcp-metadata", "name": "get_upload_info", "primary_cli_path": "drive upload-info", "risk": "low", "title": "get_upload_info", "use_when": [ "获取文件上传信息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取文件/文件夹列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "帮我看看知识库里的文件；知识库节点列表" ], "canonical_path": "drive.list_files", "cli_name": "list", "cli_path": "drive list", "confirmation": "not_required", "description": "列出钉盘指定文件夹下的文件和文件夹，支持分页和排序\r\n最简用法：不传任何参数，列出默认空间根目录下的内容。\r\n如果想列出某个子文件夹的内容，传 parentId（从 create_folder 或 list_files 返回值中获取）。\r\n使用 nextToken 游标翻页：首次不传，后续翻页传上一次返回的 nextToken；nextToken 为 null 表示没有更多数据。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "list_files" }, "metadata_source": "embedded-mcp-metadata", "name": "list_files", "primary_cli_path": "drive list", "risk": "low", "title": "获取文件/文件夹列表", "use_when": [ "1. 浏览「我的文件」根目录", "2. 进入子目录 — 提取 dentryUuid 作为 folder", "── 场景 C: 复制钉盘文件到钉盘 space 下的子文件夹 ──", "── 场景默认: 用户未指定目标位置 → 复制/移动到「我的文件」根目录 ──", "我的文件/钉盘/网盘/云盘", "查看具体命令的完整参数说明" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询知识库节点当前的成员权限列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员”请改用 dws drive permission add", "要“从知识库节点移除指定企业用户的权限（仅支持 USER 类型）”请改用 dws drive permission remove", "要“修改企业用户在知识库节点上的角色（仅支持 USER 类型）”请改用 dws drive permission update" ], "canonical_path": "drive.list_permission", "cli_name": "list", "cli_path": "drive permission list", "confirmation": "not_required", "description": "查询知识库节点当前的成员权限列表。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_permission" }, "metadata_source": "embedded-mcp-metadata", "name": "list_permission", "primary_cli_path": "drive permission list", "reviewed": false, "risk": "low", "title": "查询节点成员列表", "use_when": [ "查询知识库节点当前的成员权限列表。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取当前用户可访问的空间列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "列出钉盘团队空间；列出钉盘空间" ], "canonical_path": "drive.list_spaces", "cli_name": "list-spaces", "cli_path": "drive list-spaces", "confirmation": "not_required", "description": "获取当前用户可访问的空间列表。\r\n最简用法：不传任何参数，返回所有企业空间。\r\n空间类型筛选：通过 spaceType 参数可以筛选返回的空间类型：\r\norgSpace（或 不传）：返回企业空间列表\r\nmySpace：返回用户的\"我的文件\"个人空间\r\n支持游标分页，使用 nextToken 进行翻页（仅企业空间支持分页）。\r\n返回结果说明：\r\n当 spaceType 为 orgSpace ，返回企业团队空间列表\r\n当 spaceType 为 mySpace 时，返回单个\"我的文件\"空间\r\n如果 nextToken 不为空，表示还有更多空间可以查询（仅企业空间）", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_spaces", "primary_cli_path": "drive list-spaces", "reviewed": false, "risk": "low", "title": "list_spaces", "use_when": [ "获取当前用户可访问的空间列表。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将指定节点移动到目标文件夹。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“将指定节点移动到目标文件夹。”所述变更时不要使用" ], "canonical_path": "drive.move_document", "cli_name": "move", "cli_path": "drive move", "confirmation": "not_required", "description": "将指定节点移动到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时移动到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有编辑权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：移动操作底层可能异步执行，异步时操作已提交但无法立即确认完成，请稍后查看目标文件夹确认结果。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "move_document" }, "metadata_source": "embedded-mcp-metadata", "name": "move_document", "primary_cli_path": "drive move", "reviewed": false, "risk": "medium", "title": "移动节点", "use_when": [ "── 场景 B: 移动钉盘文件到另一个钉盘 space 根目录 ──" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员”请改用 dws drive permission add", "要“修改企业用户在知识库节点上的角色（仅支持 USER 类型）”请改用 dws drive permission update", "要“查询知识库节点当前的成员权限列表”请改用 dws drive permission list" ], "canonical_path": "drive.permission_remove", "cli_name": "remove", "cli_path": "drive permission remove", "confirmation": "user_required", "description": "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量移除成员在节点上的权限，移除后相关用户将无法通过该节点的直接授权访问内容（若有父节点继承权限则仍可通过继承权限访问）。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口移除。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。DOWNLOADER / READER / 非成员调用会返回 `forbidden.accessDenied`，错误信息会明确提示所需的最低角色。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "remove_permission" }, "metadata_source": "embedded-mcp-metadata", "name": "permission_remove", "primary_cli_path": "drive permission remove", "reviewed": false, "risk": "high", "title": "移除节点成员权限", "use_when": [ "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "修改企业用户在知识库节点上的角色（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员”请改用 dws drive permission add", "要“从知识库节点移除指定企业用户的权限（仅支持 USER 类型）”请改用 dws drive permission remove", "要“查询知识库节点当前的成员权限列表”请改用 dws drive permission list" ], "canonical_path": "drive.permission_update", "cli_name": "update", "cli_path": "drive permission update", "confirmation": "not_required", "description": "修改企业用户在知识库节点上的角色（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量调整成员角色，同一成员在同一节点只能拥有一个角色，变更后旧角色自动替换。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口变更。\r\n- 若成员的角色来自父节点的权限继承（PASS_ON 模式），且继承的角色高于目标角色，接口会拒绝操作。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。\r\n- 入参直接采用扁平的 `userIds: List\u003cString\u003e`，每个元素为钉钉 staffId（外部 userId 格式，由钉钉开放平台体系下颁发）。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "update_permission" }, "metadata_source": "embedded-mcp-metadata", "name": "permission_update", "primary_cli_path": "drive permission update", "reviewed": false, "risk": "medium", "title": "变更节点成员角色", "use_when": [ "修改企业用户在知识库节点上的角色（仅支持 USER 类型）。" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询文件当前是否处于互联网公开发布状态，以及公开发布的权限设置", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要查询文件当前是否处于互联网公开发布状态，以及公开发布的权限设置时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "drive.publish_get", "cli_name": "get", "cli_path": "drive publish get", "confirmation": "not_required", "description": "查询文件当前是否处于互联网公开发布状态，以及公开发布的权限设置。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "publish_get", "primary_cli_path": "drive publish get", "reviewed": false, "risk": "medium", "title": "查询文件公开发布状态", "use_when": [ "查看公开状态/是否公开/发布状态" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "[危险] 将文件设置为互联网公开发布", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要[危险] 将文件设置为互联网公开发布时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "drive.publish_set", "cli_name": "set", "cli_path": "drive publish set", "confirmation": "not_required", "description": "[危险] 将文件设置为互联网公开发布。公开后任何人通过链接即可访问，无需登录钉钉。\n操作者需要是该文件的管理员或拥有者。执行前需要确认，或传入 --yes 跳过确认。\n\n公开权限 (--permission): READER(仅可查看) / DOWNLOADER(可查看和下载，默认) / EDITOR(可编辑)", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "publish_set", "primary_cli_path": "drive publish set", "reviewed": false, "risk": "medium", "title": "[危险] 设置文件为互联网公开", "use_when": [ "公开文件/互联网公开/设置公开/让互联网所有人可访问" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "[危险] 关闭文件的互联网公开发布", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要[危险] 关闭文件的互联网公开发布时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "drive.publish_unset", "cli_name": "unset", "cli_path": "drive publish unset", "confirmation": "not_required", "description": "[危险] 关闭文件的互联网公开发布。关闭后外部用户将无法再通过链接访问。执行前需要确认，或传入 --yes 跳过确认。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "publish_unset", "primary_cli_path": "drive publish unset", "reviewed": false, "risk": "medium", "title": "[危险] 关闭文件互联网公开", "use_when": [ "关闭公开/取消公开/取消互联网访问" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取当前用户最近访问或编辑过的文档列表", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要获取当前用户最近访问或编辑过的文档列表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "drive.recent", "cli_name": "recent", "cli_path": "drive recent", "confirmation": "not_required", "description": "获取当前用户最近访问或编辑过的文档列表。\n\n支持按文档类型、操作类型、创建人、所属组织过滤。所有过滤条件均为可选，不传则不过滤。\n\n操作类型 (--operate-type):\n 0 最近访问（含打开+编辑）（默认）\n 1 最近编辑\n 不传默认仅返回最近访问(0)\n\n创建人类型 (--creator-type):\n 0 全部 (默认)\n 1 我创建的\n 2 他人创建的", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "recent", "primary_cli_path": "drive recent", "reviewed": false, "risk": "low", "title": "获取最近访问/编辑的文档列表", "use_when": [ "最近访问/最近打开/最近编辑/最近文档" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查看回收站文件列表", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要查看回收站文件列表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "drive.recycle_list", "cli_name": "list", "cli_path": "drive recycle list", "confirmation": "not_required", "description": "查看回收站文件列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "recycle_list", "primary_cli_path": "drive recycle list", "reviewed": false, "risk": "low", "use_when": [ "8. 查看回收站并还原文件", "回收站/查看回收站/回收站列表/回收站里有什么" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "还原回收站中的文件", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要还原回收站中的文件时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "drive.recycle_restore", "cli_name": "restore", "cli_path": "drive recycle restore", "confirmation": "not_required", "description": "还原回收站中的文件", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "recycle_restore", "primary_cli_path": "drive recycle restore", "reviewed": false, "risk": "low", "use_when": [ "8. 查看回收站并还原文件", "恢复文件/还原删除的文件/从回收站恢复/还原回收站文件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "对指定节点进行重命名。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“对指定节点进行重命名。”所述变更时不要使用" ], "canonical_path": "drive.rename_document", "cli_name": "rename", "cli_path": "drive rename", "confirmation": "not_required", "description": "对指定节点进行重命名。\r\n\r\n支持范围：\r\n- 知识库（workspace）下的文档节点、文件夹节点\r\n\r\n权限要求：\r\n- 对目标节点有编辑权限", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "rename_document" }, "metadata_source": "embedded-mcp-metadata", "name": "rename_document", "primary_cli_path": "drive rename", "reviewed": false, "risk": "medium", "title": "对指定节点进行重命名", "use_when": [ "重命名/改名" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在钉盘空间中搜索文件、文件夹或空间，支持通过 searchTarget 参数切换搜索目标。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "在知识库里搜方案；空间内搜索" ], "canonical_path": "drive.search_files", "cli_name": "search", "cli_path": "drive search", "confirmation": "not_required", "description": "在钉盘空间中搜索文件、文件夹或空间，支持通过 searchTarget 参数切换搜索目标。\r\n\r\n支持三种搜索目标：\r\n1. searchTarget=all（默认）：同时搜索文件和空间，返回混合结果\r\n2. searchTarget=file：搜索钉盘中的文件和文件夹，支持按文件类型、扩展名过滤\r\n3. searchTarget=space：搜索钉盘团队空间，返回匹配的空间列表，可快速定位目标空间\r\n\r\n推荐搜索流程：\r\n- 不确定目标 → searchTarget=all 获取所有匹配结果\r\n- 明确知道空间名 → searchTarget=space 定位空间 → list_files(parentId=rootFolderId) 遍历\r\n- 知道文件名/内容关键词 → searchTarget=file 直接搜索文件\r\n- 需要浏览指定空间的全部内容 → 使用 list_files(spaceId=xxx) 遍历，而非搜索\r\n\r\n搜索结果通过 type 字段区分：SPACE（空间）、FILE（普通文件）、FOLDER（文件夹）、ALIDOC（钉钉在线文档）。\r\n搜索范围为用户在当前组织内有权限访问的所有钉盘文件（我的文件+团队文件）。\r\n\r\n重要提示：搜索结果按相关性排序，第一页结果最相关。如果第一页未找到目标，建议优先调整搜索条件（更精确的关键词、添加 fileTypes/extensions 过滤、缩小时间范围等），而不是反复翻页。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "search_files", "primary_cli_path": "drive search", "reviewed": false, "risk": "low", "title": "钉盘文件搜索", "use_when": [ "搜一下有没有叫XX的文件；全局搜索", "搜索钉盘文件/钉盘里找个文件/查找某个钉盘文件/钉盘中搜索", "查看具体命令的完整参数说明", "钉盘/网盘/我的文件里搜" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "上传本地文件到钉盘", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“上传本地文件到钉盘”所述变更时不要使用" ], "canonical_path": "drive.upload", "cli_name": "upload", "cli_path": "drive upload", "confirmation": "not_required", "description": "将本地文件上传（三步自动完成）。\n\n路由规则:\n 默认（无 --workspace） → 上传到钉盘（我的文件或指定空间）\n --workspace \u003cid\u003e → 上传到文档空间/知识库\n\n流程:\n 1. 获取 OSS 上传凭证\n 2. HTTP PUT 上传文件二进制到 OSS\n 3. 提交文件入库\n\n上传位置: --folder 指定父目录，不传则上传到空间根目录。", "effect": "write", "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "name": "upload", "primary_cli_path": "drive upload", "reviewed": true, "risk": "medium", "title": "上传本地文件到钉盘或文档空间", "use_when": [ "6. 上传文件（首选 upload 命令，自动完成三步流程）", "上传文件\"（未指定目标）；默认钉盘", "上传文件/传文件到钉盘", "上传文件到钉盘/我的文件；钉盘上传", "上传本地文件到钉盘", "帮我把这个文件传到网盘；钉盘上传", "查看具体命令的完整参数说明" ] } ], "use_when": [ "云盘/文件存储/文件上传下载/文件夹" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.live.prod.json", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "直播列表 / 信息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "description": "直播列表 / 信息", "id": "live", "name": "直播列表 / 信息", "runtime": true, "tool_count": 1, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查看我的直播列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查看我的直播列表”" ], "canonical_path": "live.get_my_lives", "cli_name": "list", "cli_path": "live stream list", "confirmation": "not_required", "description": "获取当前用户发起的直播列表，包含每场直播的基础信息与统计数据。返回字段包括：直播标题、封面图 URL、直播 ID、主播昵称、开始/结束时间戳、播放时长（毫秒）、观看量（UV）及直播状态（如已结束）。数据按分页返回，支持判断是否还有更多内容。适用于个人直播管理、历史记录查看等场景，仅展示当前用户有权限访问的直播内容。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "live", "rpc_name": "get_my_lives" }, "metadata_source": "embedded-mcp-metadata", "name": "get_my_lives", "primary_cli_path": "live stream list", "risk": "low", "title": "获取当前用户发起的直播列表", "use_when": [ "查看我的直播列表" ] } ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json", "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "邮箱 / 邮件收发", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "avoid_when": [ "我发给某人的消息/邮件/文档/今天我干了什么；搜行为记录" ], "description": "邮箱 / 邮件收发", "id": "mail", "name": "邮箱 / 邮件收发", "runtime": true, "tool_count": 30, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量删除邮件", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建回复草稿”请改用 dws mail message reply", "要“创建转发草稿”请改用 dws mail message forward", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.batch_delete_message", "cli_name": "batch-delete", "cli_path": "mail message batch-delete", "confirmation": "user_required", "description": "批量删除邮件", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "batch_delete_message", "primary_cli_path": "mail message batch-delete", "reviewed": false, "risk": "high", "use_when": [ "批量删除邮件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量删除用户邮箱联系人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“修改用户邮箱联系人信息”请改用 dws mail contact update", "要“列出用户邮箱联系人”请改用 dws mail contact list", "要“创建用户邮箱联系人”请改用 dws mail contact create" ], "canonical_path": "mail.batch_delete_user_mail_contacts", "cli_name": "batch-delete", "cli_path": "mail contact batch-delete", "confirmation": "user_required", "description": "批量删除用户邮箱联系人", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "batch_delete_user_mail_contacts", "primary_cli_path": "mail contact batch-delete", "reviewed": false, "risk": "high", "title": "batch_delete_user_mail_contacts", "use_when": [ "批量删除用户邮箱联系人" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量移动邮件到指定文件夹", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建回复草稿”请改用 dws mail message reply", "要“创建转发草稿”请改用 dws mail message forward", "要“批量删除邮件”请改用 dws mail message batch-delete" ], "canonical_path": "mail.batch_move_message", "cli_name": "batch-move", "cli_path": "mail message batch-move", "confirmation": "not_required", "description": "批量移动邮件到指定文件夹", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "batch_move_message", "primary_cli_path": "mail message batch-move", "reviewed": false, "risk": "medium", "title": "批量移动邮件", "use_when": [ "批量移动邮件到指定文件夹" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "下载邮件附件", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列举邮件附件”请改用 dws mail attachment list" ], "canonical_path": "mail.create_download_session", "cli_name": "download", "cli_path": "mail attachment download", "confirmation": "not_required", "description": "下载邮件附件", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_download_session", "primary_cli_path": "mail attachment download", "reviewed": false, "risk": "low", "title": "创建附件下载会话", "use_when": [ "下载到指定目录", "再下载指定附件到当前目录（每次只能下载一个附件）", "步骤 5.3：对每个附件逐个下载（没有批量下载命令，必须循环调用）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建邮件草稿", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“发送草稿箱中的邮件”请改用 dws mail draft send", "要“更新邮件草稿”请改用 dws mail draft update" ], "canonical_path": "mail.create_draft", "cli_name": "create", "cli_path": "mail draft create", "confirmation": "not_required", "description": "创建邮件草稿", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_draft", "primary_cli_path": "mail draft create", "reviewed": false, "risk": "medium", "use_when": [ "创建邮件草稿" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建转发草稿", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建回复草稿”请改用 dws mail message reply", "要“批量删除邮件”请改用 dws mail message batch-delete", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.create_forward_draft", "cli_name": "forward", "cli_path": "mail message forward", "confirmation": "not_required", "description": "创建转发草稿", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_forward_draft", "primary_cli_path": "mail message forward", "reviewed": false, "risk": "medium", "use_when": [ "创建转发草稿" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建邮件文件夹", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“列举邮件文件夹”请改用 dws mail folder list", "要“删除邮件文件夹”请改用 dws mail folder delete", "要“更新邮件文件夹”请改用 dws mail folder update" ], "canonical_path": "mail.create_mail_folder", "cli_name": "create", "cli_path": "mail folder create", "confirmation": "not_required", "description": "该工具支持在指定邮箱下创建邮件文件夹。可以创建顶层文件夹，也可以在指定父文件夹下创建子文件夹。创建成功后返回新文件夹的 ID 和元信息。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_mail_folder" }, "metadata_source": "embedded-mcp-metadata", "name": "create_mail_folder", "primary_cli_path": "mail folder create", "risk": "medium", "title": "创建邮件文件夹", "use_when": [ "1b. 创建顶层邮件文件夹", "1c. 创建子文件夹 — 先通过 folder list 获取父文件夹 id，再传给 --folder", "创建邮件文件夹/新建邮箱文件夹/新建邮件目录" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建回复草稿", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建转发草稿”请改用 dws mail message forward", "要“批量删除邮件”请改用 dws mail message batch-delete", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.create_reply_draft", "cli_name": "reply", "cli_path": "mail message reply", "confirmation": "not_required", "description": "创建回复草稿", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_reply_draft", "primary_cli_path": "mail message reply", "reviewed": false, "risk": "medium", "use_when": [ "创建回复草稿" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建回复全部草稿", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建转发草稿”请改用 dws mail message forward", "要“批量删除邮件”请改用 dws mail message batch-delete", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.create_replyall_draft", "cli_name": "reply-all", "cli_path": "mail message reply-all", "confirmation": "not_required", "description": "创建回复全部草稿", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_replyall_draft", "primary_cli_path": "mail message reply-all", "reviewed": false, "risk": "medium", "title": "create_replyall_draft", "use_when": [ "创建回复全部草稿" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建用户邮箱联系人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“修改用户邮箱联系人信息”请改用 dws mail contact update", "要“列出用户邮箱联系人”请改用 dws mail contact list", "要“批量删除用户邮箱联系人”请改用 dws mail contact batch-delete" ], "canonical_path": "mail.create_user_mail_contact", "cli_name": "create", "cli_path": "mail contact create", "confirmation": "not_required", "description": "创建用户邮箱联系人", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_user_mail_contact", "primary_cli_path": "mail contact create", "reviewed": false, "risk": "medium", "title": "create_user_mail_contact", "use_when": [ "创建用户邮箱联系人" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建个人邮件模板", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出用户邮件模板”请改用 dws mail template list", "要“删除用户邮件模板”请改用 dws mail template delete", "要“获取用户邮件模板详情”请改用 dws mail template get" ], "canonical_path": "mail.create_user_message_template", "cli_name": "create", "cli_path": "mail template create", "confirmation": "not_required", "description": "创建个人邮件模板", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_user_message_template", "primary_cli_path": "mail template create", "reviewed": false, "risk": "medium", "title": "create_user_message_template", "use_when": [ "创建个人邮件模板" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除邮件文件夹", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“列举邮件文件夹”请改用 dws mail folder list", "要“创建邮件文件夹”请改用 dws mail folder create", "要“更新邮件文件夹”请改用 dws mail folder update" ], "canonical_path": "mail.delete_mail_folder", "cli_name": "delete", "cli_path": "mail folder delete", "confirmation": "user_required", "description": "该工具支持删除指定邮箱下的邮件文件夹。需要传入要删除的文件夹 ID，文件夹 ID 可通过列出邮件文件夹获得。不要把文件夹名称当作 ID。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "delete_mail_folder" }, "metadata_source": "embedded-mcp-metadata", "name": "delete_mail_folder", "primary_cli_path": "mail folder delete", "risk": "high", "title": "删除邮件文件夹", "use_when": [ "1d. 更新或删除邮件文件夹 — 先通过 folder list 获取目标文件夹 id，再传给 --id" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除用户邮件模板", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出用户邮件模板”请改用 dws mail template list", "要“创建个人邮件模板”请改用 dws mail template create", "要“获取用户邮件模板详情”请改用 dws mail template get" ], "canonical_path": "mail.delete_user_message_template", "cli_name": "delete", "cli_path": "mail template delete", "confirmation": "user_required", "description": "删除用户邮件模板", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "delete_user_message_template", "primary_cli_path": "mail template delete", "reviewed": false, "risk": "high", "title": "delete_user_message_template", "use_when": [ "删除用户邮件模板" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查看邮件完整内容", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建转发草稿”请改用 dws mail message forward", "要“批量删除邮件”请改用 dws mail message batch-delete", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.get_email_by_message_id", "cli_name": "get", "cli_path": "mail message get", "confirmation": "not_required", "description": "根据 messageId 获取邮件详情", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "get_email_by_message_id" }, "metadata_source": "embedded-mcp-metadata", "name": "get_email_by_message_id", "primary_cli_path": "mail message get", "risk": "low", "use_when": [ "3. 查看邮件详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取会话详情", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取会话详情”" ], "canonical_path": "mail.get_thread", "cli_name": "get", "cli_path": "mail thread get", "confirmation": "not_required", "description": "通过会话 ID 获取指定邮箱中的会话信息，默认仅返回会话基本信息，可通过 $select 参数指定需要额外返回的字段（如 $select=messages 返回会话内的邮件列表）", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "get_thread" }, "metadata_source": "embedded-mcp-metadata", "name": "get_thread", "primary_cli_path": "mail thread get", "risk": "low", "title": "获取会话信息", "use_when": [ "步骤 5.2：用 conversationId 获取会话详情", "步骤 5.3（可选）：同时返回会话内所有邮件列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取用户邮件模板详情", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出用户邮件模板”请改用 dws mail template list", "要“创建个人邮件模板”请改用 dws mail template create", "要“删除用户邮件模板”请改用 dws mail template delete" ], "canonical_path": "mail.get_user_message_template", "cli_name": "get", "cli_path": "mail template get", "confirmation": "not_required", "description": "获取用户邮件模板详情", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_user_message_template", "primary_cli_path": "mail template get", "reviewed": false, "risk": "low", "title": "get_user_message_template", "use_when": [ "获取用户邮件模板详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列举邮件文件夹", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建邮件文件夹”请改用 dws mail folder create", "要“删除邮件文件夹”请改用 dws mail folder delete", "要“更新邮件文件夹”请改用 dws mail folder update" ], "canonical_path": "mail.list_folders", "cli_name": "list", "cli_path": "mail folder list", "confirmation": "not_required", "description": "该工具支持列出指定邮箱的顶层文件夹或指定父文件夹下的所有子文件夹。\r\n注意：该工具只会返回文件夹的 ID 和元信息（folderId为空则返回顶层文件夹，非空则返回指定父文件夹的子文件夹）", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_folders" }, "metadata_source": "embedded-mcp-metadata", "name": "list_folders", "primary_cli_path": "mail folder list", "risk": "low", "title": "列出邮件文件夹", "use_when": [ "1c. 创建子文件夹 — 先通过 folder list 获取父文件夹 id，再传给 --folder", "1d. 更新或删除邮件文件夹 — 先通过 folder list 获取目标文件夹 id，再传给 --id", "1h. 列出文件夹中的邮件会话 — 先通过 folder list 获取文件夹 id，再传给 --folder", "列出邮件会话/查看会话列表/查看某个文件夹里的邮件会话", "删除邮件文件夹/删除邮箱文件夹/删除邮件目录", "在某个邮件文件夹下创建子文件夹", "重命名邮件文件夹/修改邮箱文件夹名称/更新邮件目录名称" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列举邮件附件", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“下载邮件附件”请改用 dws mail attachment download" ], "canonical_path": "mail.list_mail_attachments", "cli_name": "list", "cli_path": "mail attachment list", "confirmation": "not_required", "description": "列举邮件附件", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_mail_attachments", "primary_cli_path": "mail attachment list", "reviewed": false, "risk": "low", "use_when": [ "先列出附件获取 id 和 name", "（对搜索结果中的每封邮件都要执行一次）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列举邮件标签", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列举邮件标签”" ], "canonical_path": "mail.list_tags", "cli_name": "list", "cli_path": "mail tag list", "confirmation": "not_required", "description": "该工具支持列出指定邮箱下的所有邮件标签。只会返回标签 的 ID 和元信息（名称、父标签、邮件数量、未读数量等。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_tags" }, "metadata_source": "embedded-mcp-metadata", "name": "list_tags", "primary_cli_path": "mail tag list", "risk": "low", "title": "列出邮件标签", "use_when": [ "1f. 创建子标签 — 先通过 tag list 获取父标签 id，再传给 --parent-id", "1g. 更新或删除邮件标签 — 先通过 tag list 获取目标标签 id，再传给 --id", "删除邮件标签/删除邮箱标签/删除 label", "在某个邮件标签下创建子标签", "查看邮件标签/列出邮箱标签/查看邮箱 label", "重命名邮件标签/修改邮箱标签名称/更新 label 名称" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出用户邮箱联系人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“修改用户邮箱联系人信息”请改用 dws mail contact update", "要“创建用户邮箱联系人”请改用 dws mail contact create", "要“批量删除用户邮箱联系人”请改用 dws mail contact batch-delete" ], "canonical_path": "mail.list_user_mail_contacts", "cli_name": "list", "cli_path": "mail contact list", "confirmation": "not_required", "description": "列出用户邮箱联系人", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_user_mail_contacts", "primary_cli_path": "mail contact list", "reviewed": false, "risk": "low", "title": "list_user_mail_contacts", "use_when": [ "列出用户邮箱联系人" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询可用邮箱地址", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询可用邮箱地址”" ], "canonical_path": "mail.list_user_mailboxes", "cli_name": "list", "cli_path": "mail mailbox list", "confirmation": "not_required", "description": "查询当前钉钉用户可以使用的 Email 地址列表。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_user_mailboxes" }, "metadata_source": "embedded-mcp-metadata", "name": "list_user_mailboxes", "primary_cli_path": "mail mailbox list", "risk": "low", "title": "列出可用邮箱地址", "use_when": [ "1. 查看可用邮箱 — 提取邮箱地址", "发带附件的邮件/发邮件附件", "发邮件/写邮件", "我的邮箱/邮箱地址", "获取/查找/得到 某人的邮箱地址" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出用户邮件模板", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建个人邮件模板”请改用 dws mail template create", "要“删除用户邮件模板”请改用 dws mail template delete", "要“获取用户邮件模板详情”请改用 dws mail template get" ], "canonical_path": "mail.list_user_message_templates", "cli_name": "list", "cli_path": "mail template list", "confirmation": "not_required", "description": "列出用户邮件模板", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_user_message_templates", "primary_cli_path": "mail template list", "reviewed": false, "risk": "low", "title": "list_user_message_templates", "use_when": [ "列出用户邮件模板" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "搜索邮件 (KQL 语法)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "mail message list" ], "availability": "available", "avoid_when": [ "要“创建转发草稿”请改用 dws mail message forward", "要“批量删除邮件”请改用 dws mail message batch-delete", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.search_emails", "cli_name": "search", "cli_path": "mail message search", "confirmation": "not_required", "description": "使用类似 KQL 的查询表达式搜索邮件。\r\n该工具支持通过灵活的查询表达式、分页、排序和字段选择来搜索邮件。\r\n\r\n注意：该工具只会返回邮件的ID和元信息，不会返回完整的邮件正文内容", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "search_emails" }, "metadata_source": "embedded-mcp-metadata", "name": "search_emails", "primary_cli_path": "mail message search", "risk": "low", "title": "搜索邮件", "use_when": [ "2. 搜索邮件 — 提取 messageId", "下载附件/保存附件/把附件存到本地/把所有附件下载到...", "发送草稿/把草稿发出去/发这封草稿", "取返回中的 nextCursor，传入下一次请求（nextCursor=\"$\" 时停止）", "找邮件/搜邮件/查邮件", "把XX邮件的所有附件都下载", "查看会话/获取会话/看这封邮件的会话", "查看附件/邮件附件/有什么附件", "步骤 5.1：先通过 message search 或 message get 获取邮件中的 conversationId", "看邮件/打开邮件/邮件内容", "示例：下载4月所有发票邮件的附件", "第一页" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "搜索账号", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“搜索账号”" ], "canonical_path": "mail.search_mail_users", "cli_name": "search", "cli_path": "mail user search", "confirmation": "not_required", "description": "搜索账号", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "search_mail_users", "primary_cli_path": "mail user search", "reviewed": false, "risk": "low", "use_when": [ "搜索/查找/联系 邮箱用户/联系人/某人的邮箱地址", "翻页继续搜索联系人/通讯录", "路径 2：mail user search（仅企业邮箱可用，个人邮箱会报权限错误可忽略）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "发送草稿箱中的邮件", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建邮件草稿”请改用 dws mail draft create", "要“更新邮件草稿”请改用 dws mail draft update" ], "canonical_path": "mail.send_draft", "cli_name": "send", "cli_path": "mail draft send", "confirmation": "not_required", "description": "发送草稿箱中的邮件", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "send_draft", "primary_cli_path": "mail draft send", "reviewed": false, "risk": "medium", "title": "发送邮件草稿", "use_when": [ "发送草稿箱中的邮件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "发送邮件", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建转发草稿”请改用 dws mail message forward", "要“批量删除邮件”请改用 dws mail message batch-delete", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.send_email", "cli_name": "send", "cli_path": "mail message send", "confirmation": "not_required", "description": "使用指定的Email地址作为发件人发送一封邮件。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "send_email" }, "metadata_source": "embedded-mcp-metadata", "name": "send_email", "primary_cli_path": "mail message send", "risk": "medium", "title": "发送邮件", "use_when": [ "4. 发送邮件（纯文本）", "4b. 发送带附件的邮件（自动编排：创建草稿→上传附件→发送草稿）", "4c. 发送带内联图片的邮件（正文自动转 HTML，\u003cimg\u003e 标签自动注入）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新邮件草稿", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建邮件草稿”请改用 dws mail draft create", "要“发送草稿箱中的邮件”请改用 dws mail draft send" ], "canonical_path": "mail.update_draft", "cli_name": "update", "cli_path": "mail draft update", "confirmation": "not_required", "description": "更新邮件草稿", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_draft", "primary_cli_path": "mail draft update", "reviewed": false, "risk": "medium", "use_when": [ "更新邮件草稿" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新邮件文件夹", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“列举邮件文件夹”请改用 dws mail folder list", "要“创建邮件文件夹”请改用 dws mail folder create", "要“删除邮件文件夹”请改用 dws mail folder delete" ], "canonical_path": "mail.update_mail_folder", "cli_name": "update", "cli_path": "mail folder update", "confirmation": "not_required", "description": "该工具支持修改指定邮箱下邮件文件夹的名称。需要传入要更新的文件夹 ID 和新名称。文件夹 ID 可通过列出邮件文件夹获得，不要把文件夹名称当作 ID。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "update_mail_folder" }, "metadata_source": "embedded-mcp-metadata", "name": "update_mail_folder", "primary_cli_path": "mail folder update", "risk": "medium", "title": "更新邮件文件夹", "use_when": [ "1d. 更新或删除邮件文件夹 — 先通过 folder list 获取目标文件夹 id，再传给 --id" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "修改用户邮箱联系人信息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出用户邮箱联系人”请改用 dws mail contact list", "要“创建用户邮箱联系人”请改用 dws mail contact create", "要“批量删除用户邮箱联系人”请改用 dws mail contact batch-delete" ], "canonical_path": "mail.update_user_mail_contact", "cli_name": "update", "cli_path": "mail contact update", "confirmation": "not_required", "description": "修改用户邮箱联系人信息", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_user_mail_contact", "primary_cli_path": "mail contact update", "reviewed": false, "risk": "medium", "title": "update_user_mail_contact", "use_when": [ "修改用户邮箱联系人信息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新用户邮件模板", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建个人邮件模板”请改用 dws mail template create", "要“删除用户邮件模板”请改用 dws mail template delete", "要“获取用户邮件模板详情”请改用 dws mail template get" ], "canonical_path": "mail.update_user_message_template", "cli_name": "update", "cli_path": "mail template update", "confirmation": "not_required", "description": "更新用户邮件模板", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_user_message_template", "primary_cli_path": "mail template update", "reviewed": false, "risk": "medium", "title": "update_user_message_template", "use_when": [ "更新用户邮件模板" ] } ], "use_when": [ "邮箱/邮件/发邮件/收邮件/搜邮件/查邮件/邮件草稿/转发邮件/回复邮件/邮件附件/抄送" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json", "skills/mono/SKILL.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "AI 听记 / 会议纪要：列表 / 详情 / 摘要 / 转写 / 待办 / 思维导图 / 发言人 / 热词 / 文件上传", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "description": "AI 听记 / 会议纪要", "id": "minutes", "name": "AI 听记 / 会议纪要", "runtime": true, "tool_count": 29, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量给多个听记增加成员，并且设置成员的权限。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量移除多个听记的成员的权限”请改用 dws minutes permission remove" ], "canonical_path": "minutes.add_member_permission", "cli_name": "add", "cli_path": "minutes permission add", "confirmation": "not_required", "description": "批量给多个听记增加成员，并且设置成员的权限。权限类型为：0:管理员;1:所有者；2:可编辑;3:可查看/下载;4:仅查看。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "add_member_permission", "primary_cli_path": "minutes permission add", "reviewed": false, "risk": "medium", "title": "add_member_permission", "use_when": [ "加/添加/共享/分享/让...看/让...访问", "把某人加到这个听记中/共享听记给某人/给某人添加听记权限/把听记分享给同事/让某人也能看这个听记", "添加参会者/加参会者/批量添加参会者/添加成员/加成员/批量添加成员/加参会人/添加参会人", "添加参会者/批量添加参会者/添加成员/批量添加成员/加参会人/加入成员" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "添加个人热词 (优化识别专有名词 / 人名)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询我的热词列表，返回个人的所有听记配置过的热词列表”请改用 dws minutes hot-word list" ], "canonical_path": "minutes.add_personal_hot_word", "cli_name": "add", "cli_path": "minutes hot-word add", "confirmation": "not_required", "description": "添加听记个人热词\r\n对于听记语音识别中，需要优化识别结果的专有名词、人名、以及其他用户需要添加热词的场景使用\r\n热词长度不超过10个汉字或5个英文单词", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "add_personal_hot_word" }, "metadata_source": "embedded-mcp-metadata", "name": "add_personal_hot_word", "primary_cli_path": "minutes hot-word add", "risk": "medium", "title": "add_personal_hot_word", "use_when": [ "10. 添加个人热词", "加热词/添加热词/设置热词/把某个词加到热词里/这个词总是识别错" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 / 状态)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“获取听记 AI 摘要 (Markdown 格式)”请改用 dws minutes get summary", "要“获取听记关键字列表”请改用 dws minutes get keywords", "要“获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接”请改用 dws minutes get info" ], "canonical_path": "minutes.batch_get_minutes_details", "cli_name": "batch", "cli_path": "minutes get batch", "confirmation": "not_required", "description": "根据听记taskUuid列表批量查询听记详情。输入参数：taskUuid列表（string[]，必填，每个元素为听记的唯一标识符，最少传入1个）。返回对应听记的详情列表，每条记录包含：听记标题、时长、参与人列表、创建时间、听记唯一标识taskUuid、听记状态。适用于已知特定听记taskUuid需批量获取详情的列表展示场景。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "batch_get_minutes_details" }, "metadata_source": "embedded-mcp-metadata", "name": "batch_get_minutes_details", "primary_cli_path": "minutes get batch", "risk": "low", "title": "batch_get_minutes_details", "use_when": [ "批量查询/查多个听记" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "取消文件上传会话，释放服务端资源", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建文件上传会话（获取预签名 URL，供 HTTP PUT 上传”请改用 dws minutes upload create", "要“完成文件上传并创建听记（幂等：同一 sessionId 重复调用”请改用 dws minutes upload complete" ], "canonical_path": "minutes.cancel_upload_session", "cli_name": "cancel", "cli_path": "minutes upload cancel", "confirmation": "not_required", "description": "取消文件上传会话\r\n当需要取消create_upload_session创建的会话时使用该接口，传入要取消的会话ID", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "cancel_upload_session" }, "metadata_source": "embedded-mcp-metadata", "name": "cancel_upload_session", "primary_cli_path": "minutes upload cancel", "risk": "medium", "title": "cancel_upload_session", "use_when": [ "12d.（可选）取消上传会话", "取消上传" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "完成文件上传并创建听记（幂等：同一 sessionId 重复调用返回已有任务）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建文件上传会话（获取预签名 URL，供 HTTP PUT 上传”请改用 dws minutes upload create", "要“取消文件上传会话，释放服务端资源”请改用 dws minutes upload cancel" ], "canonical_path": "minutes.complete_upload_session", "cli_name": "complete", "cli_path": "minutes upload complete", "confirmation": "not_required", "description": "文件上传完成后，创建听记。\r\n必须在create_upload_session之后、预签名URL上传`curl -X PUT \"{presignedUrl}\" -T \"/path/to/file.mp4\"`完成后调用。\r\n调用流程参考create_upload_session介绍。\r\n幂等：同一sessionId重复调用直接返回已有的任务，不会重复创建。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "complete_upload_session" }, "metadata_source": "embedded-mcp-metadata", "name": "complete_upload_session", "primary_cli_path": "minutes upload complete", "risk": "medium", "title": "complete_upload_session", "use_when": [ "12c. 通知服务端上传完成，创建听记" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "触发思维导图生成任务 (完成状态走 mind-graph status 轮询)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询思维导图任务状态 (0=进行中 / 1=成功 / 2=失败)”请改用 dws minutes mind-graph status" ], "canonical_path": "minutes.create_mind_graph", "cli_name": "create", "cli_path": "minutes mind-graph create", "confirmation": "not_required", "description": "触发创建听记思维导图任务。触发成功后，你需要知道听记思维导图任务状态，每2s调用一次query_mind_graph_status，如果状态是“进行中”需要保持轮询。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "create_mind_graph" }, "metadata_source": "embedded-mcp-metadata", "name": "create_mind_graph", "primary_cli_path": "minutes mind-graph create", "risk": "medium", "title": "create_mind_graph", "use_when": [ "8. 思维导图", "生成思维导图/创建脑图/帮我添加思维导图/基于这个听记做思维导图/把会议内容做成脑图" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "触发创建发言人的段落总结任务，该任务将听记的发言人的所有撰写内容汇总总结，触发后需要继续调用查询接口去查询总结任务的结果", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询发言人的段落总结任务的结果，该任务将听记的发言人的所有撰写内”请改用 dws minutes speaker summary get" ], "canonical_path": "minutes.create_speaker_summary", "cli_name": "create", "cli_path": "minutes speaker summary create", "confirmation": "not_required", "description": "触发创建发言人的段落总结任务，该任务将听记的发言人的所有撰写内容汇总总结，触发后需要继续调用查询接口去查询总结任务的结果", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_speaker_summary", "primary_cli_path": "minutes speaker summary create", "reviewed": false, "risk": "low", "title": "create_speaker_summary", "use_when": [ "9b. 发言人段落总结（异步：create 触发 → 延迟 5s → 轮询 get，最多 20 次）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建文件上传会话（获取预签名 URL，供 HTTP PUT 上传）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“取消文件上传会话，释放服务端资源”请改用 dws minutes upload cancel", "要“完成文件上传并创建听记（幂等：同一 sessionId 重复调用”请改用 dws minutes upload complete" ], "canonical_path": "minutes.create_upload_session", "cli_name": "create", "cli_path": "minutes upload create", "confirmation": "not_required", "description": "创建文件上传会话，获取预签名上传URL\r\n调用方拿到 URL 后，直接用HTTP PUT将文件上传到该URL\r\n必须与complete_upload_session配合使用\r\n1.调用create_upload_session获取预签名上传URL和上传ID\r\n2.HTTP PUT预签名上传URL上传文件(不带HEADER)\r\n3.调用complete_upload_session传入会话ID", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "create_upload_session" }, "metadata_source": "embedded-mcp-metadata", "name": "create_upload_session", "primary_cli_path": "minutes upload create", "risk": "medium", "title": "create_upload_session", "use_when": [ "12a. 创建上传会话，获取预签名 URL 和 sessionId", "把文件转成听记/上传音频文件/上传录音/把这个 mp3 转成听记/帮我把会议录音转写一下/把附件里的音频文件做转写" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取听记 AI 摘要 (Markdown 格式)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 /”请改用 dws minutes get batch", "要“获取听记关键字列表”请改用 dws minutes get keywords", "要“获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接”请改用 dws minutes get info" ], "canonical_path": "minutes.get_minutes_ai_summary", "cli_name": "summary", "cli_path": "minutes get summary", "confirmation": "not_required", "description": "根据听记唯一标识获取由AI生成的听记内容摘要。输入参数：目标听记的唯一标识符taskUuid。返回Markdown格式的摘要文本，内容由AI对听记转写原文进行结构化提炼生成，涵盖会议主题、核心结论、关键讨论点等。适用于快速了解听记核心内容、会议记录整理、摘要分享等场景。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "get_minutes_ai_summary" }, "metadata_source": "embedded-mcp-metadata", "name": "get_minutes_ai_summary", "primary_cli_path": "minutes get summary", "risk": "low", "title": "get_minutes_ai_summary", "use_when": [ "2. 获取 AI 摘要", "修改纪要/更新纪要/编辑纪要内容/重新整理纪要/纪要格式优化/纪要精简", "把 XX 改成 YY；用户只要整体纪要、未指定特定人物", "摘要/总结/会议纪要/纪要" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 /”请改用 dws minutes get batch", "要“获取听记 AI 摘要 (Markdown 格式)”请改用 dws minutes get summary", "要“获取听记关键字列表”请改用 dws minutes get keywords" ], "canonical_path": "minutes.get_minutes_basic_info", "cli_name": "info", "cli_path": "minutes get info", "confirmation": "not_required", "description": "根据听记唯一标识获取该听记的基础元数据信息。输入参数：听记的唯一标识符taskUuid。返回字段包括：创建人、开始时间、截止时间、听记标题、听记访问链接URL。适用于展示听记详情页头部信息、跳转听记原始链接、信息摘要展示等场景。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "get_minutes_basic_info" }, "metadata_source": "embedded-mcp-metadata", "name": "get_minutes_basic_info", "primary_cli_path": "minutes get info", "risk": "low", "title": "get_minutes_basic_info", "use_when": [ "听记详情/听记信息" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取听记关键字列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 /”请改用 dws minutes get batch", "要“获取听记 AI 摘要 (Markdown 格式)”请改用 dws minutes get summary", "要“获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接”请改用 dws minutes get info" ], "canonical_path": "minutes.get_minutes_keywords", "cli_name": "keywords", "cli_path": "minutes get keywords", "confirmation": "not_required", "description": "根据听记唯一标识查询该听记的关键字列表。输入参数：目标听记的唯一标识符taskUuid。返回关键字列表，每个元素为一个从听记内容中提取的核心关键词。适用于快速了解听记主题、关键词检索、内容分类打标及听记摘要辅助展示等场景。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "get_minutes_keywords" }, "metadata_source": "embedded-mcp-metadata", "name": "get_minutes_keywords", "primary_cli_path": "minutes get keywords", "risk": "low", "title": "get_minutes_keywords", "use_when": [ "关键字/关键词" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取听记语音转写原文 (含发言人 / 时间戳)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 /”请改用 dws minutes get batch", "要“获取听记 AI 摘要 (Markdown 格式)”请改用 dws minutes get summary", "要“获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接”请改用 dws minutes get info" ], "canonical_path": "minutes.get_minutes_transcription", "cli_name": "transcription", "cli_path": "minutes get transcription", "confirmation": "not_required", "description": "根据听记唯一标识查询该听记的完整语音转写原文。输入参数：听记的唯一标识符 taskUuid。返回转写内容列表，每条记录包含：发言人信息、语音转写文本、对应时间戳。适用于用户回顾会议发言内容、按发言人检索原文、生成会议记录等场景。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "get_minutes_transcription" }, "metadata_source": "embedded-mcp-metadata", "name": "get_minutes_transcription", "primary_cli_path": "minutes get transcription", "risk": "low", "title": "get_minutes_transcription", "use_when": [ "3. 查看完整转写原文（拉完后默认按时间线返回，AI 必须主动追问\"是否按发言人聚类\"）", "原文/转写/录音文字/逐字稿" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询发言人的段落总结任务的结果，该任务将听记的发言人的所有撰写内容汇总总结返回，配合创建任务使用", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“触发创建发言人的段落总结任务，该任务将听记的发言人的所有撰写内容”请改用 dws minutes speaker summary create" ], "canonical_path": "minutes.get_speaker_summary", "cli_name": "get", "cli_path": "minutes speaker summary get", "confirmation": "not_required", "description": "查询发言人的段落总结任务的结果，该任务将听记的发言人的所有撰写内容汇总总结返回，配合创建任务使用", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_speaker_summary", "primary_cli_path": "minutes speaker summary get", "reviewed": false, "risk": "low", "title": "get_speaker_summary", "use_when": [ "等待至少 5 秒..." ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "新版：查询我的听记列表，支持输入关键词或者时间范围查询，返回听记列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "aliases": [ "minutes list all", "minutes list shared" ], "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“新版：查询我的听记列表，支持输入关键词或者时间范围查询，返回听记列表。”" ], "canonical_path": "minutes.list_by_keyword_and_time_range", "cli_name": "mine", "cli_path": "minutes list mine", "confirmation": "not_required", "description": "新版：查询我的听记列表，支持输入关键词或者时间范围查询，返回听记列表。代替list_by_keyword_range。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_by_keyword_and_time_range", "primary_cli_path": "minutes list mine", "reviewed": false, "risk": "low", "title": "list_by_keyword_and_time_range", "use_when": [ "1. 查看我的听记列表 — 提取 taskUuid", "1b. 查看共享给我的听记", "1c. 查看我有权限访问的所有听记（支持关键字和时间范围筛选）", "从我创建的/我发起的听记里找XX", "从我的听记里仅按关键词搜索（\"从我的听记里搜技术方案\"）", "从我的听记里按关键词 + 上月时间范围搜索（\"上月听记里有没有提到OKR\"）", "从我的听记里按关键词 + 今日时间范围搜索（\"帮我从今天听记里找需求评审\"）", "关键词 + 时间范围组合", "别人给我的听记/共享听记/共享给我的", "我创建的听记/我发起的听记/我自己录的听记", "我可访问的听记/我能看到的听记/我有权限的听记/所有听记/全部听记", "我的听记", "我的听记里找XX", "按关键词搜索", "按关键词搜索共享听记", "按时间范围搜索", "某时间段内的听记/按时间查听记/按关键词查听记" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取听记中提取的待办事项", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 /”请改用 dws minutes get batch", "要“获取听记 AI 摘要 (Markdown 格式)”请改用 dws minutes get summary", "要“获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接”请改用 dws minutes get info" ], "canonical_path": "minutes.list_minutes_todos", "cli_name": "todos", "cli_path": "minutes get todos", "confirmation": "not_required", "description": "根据听记唯一标识查询该听记中提取的待办事项列表。输入参数：目标听记的唯一标识符taskUuid。返回待办事项列表，每条记录包含：待办事项内容、待办唯一ID、参与人信息、待办时间。适用于会后跟进行动项、任务分配追踪、按人员或时间筛选待办等场景。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "list_minutes_todos" }, "metadata_source": "embedded-mcp-metadata", "name": "list_minutes_todos", "primary_cli_path": "minutes get todos", "risk": "low", "title": "list_minutes_todos", "use_when": [ "4. 提取待办事项", "会议待办/听记待办/待办事项", "把 XX 改成 YY；用户想提取待办" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询我的热词列表，返回个人的所有听记配置过的热词列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加个人热词 (优化识别专有名词 / 人名)”请改用 dws minutes hot-word add" ], "canonical_path": "minutes.list_my_hotwords", "cli_name": "list", "cli_path": "minutes hot-word list", "confirmation": "not_required", "description": "查询我的热词列表，返回个人的所有听记配置过的热词列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_my_hotwords", "primary_cli_path": "minutes hot-word list", "reviewed": false, "risk": "low", "title": "list_my_hotwords", "use_when": [ "看看我的热词/我加了哪些热词/热词列表/查热词" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询思维导图任务状态 (0=进行中 / 1=成功 / 2=失败)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“触发思维导图生成任务 (完成状态走 mind-graph sta”请改用 dws minutes mind-graph create" ], "canonical_path": "minutes.query_mind_graph_status", "cli_name": "status", "cli_path": "minutes mind-graph status", "confirmation": "not_required", "description": "查询思维导图任务状态，根据taskUuid查询对应思维导图状态。\r\n返回的结果里，任务状态（taskStatus）如下：\r\n0-进行中，1-成功，2-失败\r\n如果没有返回任务状态，也视为成功", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "query_mind_graph_status" }, "metadata_source": "embedded-mcp-metadata", "name": "query_mind_graph_status", "primary_cli_path": "minutes mind-graph status", "risk": "low", "title": "query_mind_graph_status", "use_when": [ "8. 思维导图", "思维导图状态/脑图进度/思维导图好了吗" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询听记的音频/视频地址，入参为 taskUuid 和操作人 uid，操作人需拥有该听记的\"读\"权限及以上才会返回；", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 /”请改用 dws minutes get batch", "要“获取听记 AI 摘要 (Markdown 格式)”请改用 dws minutes get summary", "要“获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接”请改用 dws minutes get info" ], "canonical_path": "minutes.query_minutes_audio_url", "cli_name": "audio", "cli_path": "minutes get audio", "confirmation": "not_required", "description": "查询听记的音频/视频地址，入参为 taskUuid 和操作人 uid，操作人需拥有该听记的\"读\"权限及以上才会返回；支持所有类型的听记（线上闪记、线下闪记、A1 硬件听记、上传文件听记等）。在返回地址前会过滤以下场景：听记已被删除、A1 无痕模式听记、临存过期的听记（媒体未准备好或临时存储已过期）。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "query_minutes_audio_url", "primary_cli_path": "minutes get audio", "reviewed": false, "risk": "low", "title": "query_minutes_audio_url", "use_when": [ "4b. 获取音频/视频地址（用于下载或播放原始媒体文件）", "音频地址/音频链接/录音文件/下载录音/音频下载/视频文件/媒体地址" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据用户的标签或者分组信息来查询听记列表信息，用户的标签通过听记页面手动创建。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询我的的听记的标签或者分组列表，标签或者分组在听记页面创建”请改用 dws minutes tag list" ], "canonical_path": "minutes.query_minutes_by_tag_id", "cli_name": "query", "cli_path": "minutes tag query", "confirmation": "not_required", "description": "根据用户的标签或者分组信息来查询听记列表信息，用户的标签通过听记页面手动创建。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "query_minutes_by_tag_id", "primary_cli_path": "minutes tag query", "reviewed": false, "risk": "low", "title": "query_minutes_by_tag_id", "use_when": [ "查看某个标签下的听记/这个标签下有哪些听记/按标签查听记" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询我的的听记的标签或者分组列表，标签或者分组在听记页面创建。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“根据用户的标签或者分组信息来查询听记列表信息，用户的标签通过听记”请改用 dws minutes tag query" ], "canonical_path": "minutes.query_user_tag_list", "cli_name": "list", "cli_path": "minutes tag list", "confirmation": "not_required", "description": "查询我的的听记的标签或者分组列表，标签或者分组在听记页面创建。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "query_user_tag_list", "primary_cli_path": "minutes tag list", "reviewed": false, "risk": "low", "title": "query_user_tag_list", "use_when": [ "我的听记标签/听记分组/听记有哪些标签/有哪些分组", "按标签查/某个标签下的听记/标签筛选", "标签列表/分组列表/有哪些标签/有哪些分组" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "暂停听记录音", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“发起听记 (开始录音)”请改用 dws minutes record start", "要“恢复听记录音”请改用 dws minutes record resume", "要“结束听记录音”请改用 dws minutes record stop" ], "canonical_path": "minutes.record_pause", "cli_name": "pause", "cli_path": "minutes record pause", "confirmation": "not_required", "description": "暂停听记录音", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "执行听记指令-发起AI听记录音" }, "name": "record_pause", "primary_cli_path": "minutes record pause", "reviewed": true, "risk": "medium", "use_when": [ "7. 录音控制（基于 start 返回的 taskUuid）", "暂停一下/暂停录音", "暂停听记录音" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "恢复听记录音", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“发起听记 (开始录音)”请改用 dws minutes record start", "要“暂停听记录音”请改用 dws minutes record pause", "要“结束听记录音”请改用 dws minutes record stop" ], "canonical_path": "minutes.record_resume", "cli_name": "resume", "cli_path": "minutes record resume", "confirmation": "not_required", "description": "恢复听记录音", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "执行听记指令-发起AI听记录音" }, "name": "record_resume", "primary_cli_path": "minutes record resume", "reviewed": true, "risk": "medium", "use_when": [ "7. 录音控制（基于 start 返回的 taskUuid）", "恢复听记录音", "继续/继续录音" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "发起听记 (开始录音)", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“恢复听记录音”请改用 dws minutes record resume", "要“暂停听记录音”请改用 dws minutes record pause", "要“结束听记录音”请改用 dws minutes record stop" ], "canonical_path": "minutes.record_start", "cli_name": "start", "cli_path": "minutes record start", "confirmation": "not_required", "description": "发起听记（开始录音）", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "执行听记指令-发起AI听记录音" }, "name": "record_start", "primary_cli_path": "minutes record start", "reviewed": true, "risk": "medium", "use_when": [ "0. 发起听记（开始录音）", "发起听记 (开始录音)", "开始听记/开始录音/发起一个听记/启动听记/开始听记录这次会议/我要开始听记了/录音开始/我要听记" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "结束听记录音", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“发起听记 (开始录音)”请改用 dws minutes record start", "要“恢复听记录音”请改用 dws minutes record resume", "要“暂停听记录音”请改用 dws minutes record pause" ], "canonical_path": "minutes.record_stop", "cli_name": "stop", "cli_path": "minutes record stop", "confirmation": "not_required", "description": "结束听记录音", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "执行听记指令-发起AI听记录音" }, "name": "record_stop", "primary_cli_path": "minutes record stop", "reviewed": true, "risk": "medium", "use_when": [ "7. 录音控制（基于 start 返回的 taskUuid）", "结束听记/结束录音/停止录音/结束", "结束听记录音" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量移除多个听记的成员的权限。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量给多个听记增加成员，并且设置成员的权限”请改用 dws minutes permission add" ], "canonical_path": "minutes.remove_member_permission", "cli_name": "remove", "cli_path": "minutes permission remove", "confirmation": "user_required", "description": "批量移除多个听记的成员的权限。权限类型为：0:管理员;1:所有者；2:可编辑;3:可查看/下载;4:仅查看。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "remove_member_permission", "primary_cli_path": "minutes permission remove", "reviewed": false, "risk": "high", "title": "remove_member_permission", "use_when": [ "移除/取消/删除/不让...看", "移除某人的权限/取消共享/不让某人看这个听记了" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在段落 + 纪要中全量替换文字 (区分大小写，精确匹配)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "用户未明确要求“在段落 + 纪要中全量替换文字 (区分大小写，精确匹配)”、目标不清楚或尚未确认时不要使用" ], "canonical_path": "minutes.replace_minutes_text", "cli_name": "replace-text", "cli_path": "minutes replace-text", "confirmation": "user_required", "description": "把听记中所有出现的原文字替换为目标文字，包括转写段落和纪要摘要中出现的原文字都会被替换为目标文字", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "replace_minutes_text" }, "metadata_source": "embedded-mcp-metadata", "name": "replace_minutes_text", "primary_cli_path": "minutes replace-text", "risk": "high", "title": "replace_minutes_text", "use_when": [ "11. 查找替换听记文字", "把所有的A替换成B/查找替换/批量替换文字" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量替换听记中指定发言人", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“批量替换听记中指定发言人”所述变更时不要使用" ], "canonical_path": "minutes.replace_speaker", "cli_name": "replace", "cli_path": "minutes speaker replace", "confirmation": "not_required", "description": "批量替换听记转写中指定发言人，将源发言人（speakerNick）精确匹配的所有段落替换为目标发言人，支持同时替换 nickName 和 subSpeakerNickname 两种匹配方式，并自动更新纪要、待办中的发言人信息。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "replace_speaker" }, "metadata_source": "embedded-mcp-metadata", "name": "replace_speaker", "primary_cli_path": "minutes speaker replace", "risk": "medium", "title": "replace_speaker", "use_when": [ "3b. 用户提供\"某某人讲了 XX\" → AI 模糊匹配关键词后，引导确认替换发言人", "9. 替换发言人", "把 XX 改成 YY；用户直接说\"把发言人1改成张三", "替换发言人/修改发言人/换发言人名字/把说话人改成某某/发言人标注错了" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "全量覆盖纪要内容 (不触发 AI 重算)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“修改听记标题”请改用 dws minutes update title" ], "canonical_path": "minutes.update_minutes_summary", "cli_name": "summary", "cli_path": "minutes update summary", "confirmation": "not_required", "description": "用传入的摘要文本全量覆盖听记的纪要内容，不触发 AI 重新生成。适用于用户手动编辑或 AI Agent 修改纪要的场景。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "update_minutes_summary" }, "metadata_source": "embedded-mcp-metadata", "name": "update_minutes_summary", "primary_cli_path": "minutes update summary", "risk": "medium", "title": "update_minutes_summary", "use_when": [ "6. 更新纪要内容" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "修改听记标题", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“全量覆盖纪要内容 (不触发 AI 重算)”请改用 dws minutes update summary" ], "canonical_path": "minutes.update_minutes_title", "cli_name": "title", "cli_path": "minutes update title", "confirmation": "not_required", "description": "修改指定听记的标题名称。输入参数：taskUuid、newTitle 新的听记标题。操作成功返回更新结果状态。适用于用户对已有听记进行重命名、整理归档等场景。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "update_minutes_title" }, "metadata_source": "embedded-mcp-metadata", "name": "update_minutes_title", "primary_cli_path": "minutes update title", "risk": "medium", "title": "update_minutes_title", "use_when": [ "5. 修改标题", "改听记标题/重命名听记/修改标题" ] } ], "use_when": [ "听记/AI听记/会议纪要/转写/摘要/思维导图/发言人/热词" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json", "skills/mono/SKILL.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "OA 审批 / 同意 / 拒绝 / 撤销", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "description": "OA 审批 / 同意 / 拒绝 / 撤销", "id": "oa", "name": "OA 审批 / 同意 / 拒绝 / 撤销", "runtime": true, "tool_count": 15, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "同意审批", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed", "要“获取抄送用户的列表”请改用 dws oa approval list-cc" ], "canonical_path": "oa.approve_processInstance", "cli_name": "approve", "cli_path": "oa approval approve", "confirmation": "not_required", "description": "处理某个需要我处理的实例任务，拒绝审批实例任务，所需要的参数processInstanceId可以从list_pending_approvals工具获取。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "approve_processInstance" }, "metadata_source": "embedded-mcp-metadata", "name": "approve_processInstance", "primary_cli_path": "oa approval approve", "risk": "medium", "title": "approve_processInstance", "use_when": [ "4a. 同意审批", "同意审批/批准" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "用户添加审批评论", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed", "要“获取抄送用户的列表”请改用 dws oa approval list-cc" ], "canonical_path": "oa.dingflow_comments", "cli_name": "oa-comments", "cli_path": "oa approval oa-comments", "confirmation": "not_required", "description": "用户添加审批评论", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "dingflow_comments", "primary_cli_path": "oa approval oa-comments", "reviewed": false, "risk": "medium", "title": "dingflow_comments", "use_when": [ "13. 对审批实例添加评论（processInstanceId 来自 list-pending 或 detail）", "评论审批/添加评论/写评论" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取员工已处理任务列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取抄送用户的列表”请改用 dws oa approval list-cc" ], "canonical_path": "oa.get_done_tasks", "cli_name": "list-executed", "cli_path": "oa approval list-executed", "confirmation": "not_required", "description": "获取员工已处理任务列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_done_tasks", "primary_cli_path": "oa approval list-executed", "reviewed": false, "risk": "low", "title": "get_done_tasks", "use_when": [ "9. 我处理过的审批单", "我审批/处理过的审批单" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取抄送用户的列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.get_noticed_instances", "cli_name": "list-cc", "cli_path": "oa approval list-cc", "confirmation": "not_required", "description": "获取抄送用户的列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_noticed_instances", "primary_cli_path": "oa approval list-cc", "reviewed": false, "risk": "low", "title": "get_noticed_instances", "use_when": [ "11. 抄送我的审批单", "抄送我的审批单" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取审批实例详情", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.get_processInstance_detail", "cli_name": "detail", "cli_path": "oa approval detail", "confirmation": "not_required", "description": "获取指定审批实例的详情信息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "get_processInstance_detail" }, "metadata_source": "embedded-mcp-metadata", "name": "get_processInstance_detail", "primary_cli_path": "oa approval detail", "risk": "low", "title": "get_processInstance_detail", "use_when": [ "2. 查看审批详情 — 了解审批内容", "审批详情/看审批" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取审批操作记录", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.get_processInstance_records", "cli_name": "records", "cli_path": "oa approval records", "confirmation": "not_required", "description": "获取某个审批实例的审批操作记录信息，获取的是该审批实例有哪些人做了什么操作，以及操作结果是什么", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "get_processInstance_records" }, "metadata_source": "embedded-mcp-metadata", "name": "get_processInstance_records", "primary_cli_path": "oa approval records", "risk": "low", "title": "get_processInstance_records", "use_when": [ "6. 查看审批操作记录", "审批记录/操作历史" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取已提交实例列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.get_submitted_instances", "cli_name": "list-submitted", "cli_path": "oa approval list-submitted", "confirmation": "not_required", "description": "获取已提交实例列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_submitted_instances", "primary_cli_path": "oa approval list-submitted", "reviewed": false, "risk": "low", "title": "get_submitted_instances", "use_when": [ "10. 我发起的审批单", "我发起的审批单" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询已发起的审批实例列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.list_initiated_instances", "cli_name": "list-initiated", "cli_path": "oa approval list-initiated", "confirmation": "not_required", "description": "查询当前用户已发起的审批实例列表，查询的信息包含审批实例Id、审批实例发起时间、审批实例当前状态等基础信息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "list_initiated_instances" }, "metadata_source": "embedded-mcp-metadata", "name": "list_initiated_instances", "primary_cli_path": "oa approval list-initiated", "risk": "low", "title": "list_initiated_instances", "use_when": [ "8. 查看自己发起的审批列表（--process-code 来自 list-forms / search-forms / detail）", "我发起的审批" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询待我处理的审批", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.list_pending_approvals", "cli_name": "list-pending", "cli_path": "oa approval list-pending", "confirmation": "not_required", "description": "查询当前用户待处理的审批单列表，返回每条审批单的名称、唯一编码（如审批实例 ID）、处理跳转链接（用于一键进入审批页面）等关键信息。结果仅包含用户作为审批人且尚未处理的审批事项，适用于工作台待办集成、审批提醒等场景。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "list_pending_approvals" }, "metadata_source": "embedded-mcp-metadata", "name": "list_pending_approvals", "primary_cli_path": "oa approval list-pending", "risk": "low", "title": "list_pending_approvals", "use_when": [ "1. 查看待我处理的审批 — 提取 processInstanceId", "待审批/待处理审批", "待我审批/我要审批的" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询待我审批的任务 ID", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.list_pending_tasks", "cli_name": "tasks", "cli_path": "oa approval tasks", "confirmation": "not_required", "description": "查询待我审批的任务Id，获取任务Id之后，可以执行同意、拒绝审批单操作。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "list_pending_tasks" }, "metadata_source": "embedded-mcp-metadata", "name": "list_pending_tasks", "primary_cli_path": "oa approval tasks", "risk": "low", "title": "query_pending_tasks", "use_when": [ "3. 获取待审批任务 ID — 提取 taskId", "同意审批/批准", "我有哪些待审的任务", "拒绝审批/驳回" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取当前用户可见的审批表单列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.list_user_visible_process", "cli_name": "list-forms", "cli_path": "oa approval list-forms", "confirmation": "not_required", "description": "获取当前用户可见的审批表单列表，可获取审批表单的processCode。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "list_user_visible_process" }, "metadata_source": "embedded-mcp-metadata", "name": "list_user_visible_process", "primary_cli_path": "oa approval list-forms", "risk": "low", "title": "list_user_visible_process", "use_when": [ "7. 获取可见审批表单（得到 processCode）", "有哪些审批表单/可见表单" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "抄送审批人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.oa_cc_noticer", "cli_name": "oa-cc-noticer", "cli_path": "oa approval oa-cc-noticer", "confirmation": "not_required", "description": "抄送审批人", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "oa_cc_noticer", "primary_cli_path": "oa approval oa-cc-noticer", "reviewed": false, "risk": "medium", "title": "oa_cc_noticer", "use_when": [ "14. 对审批实例进行抄送（processInstanceId 来自 list-pending 或 detail）", "抄送审批/添加抄送人" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "转交审批任务", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.redirect_task", "cli_name": "redirect-task", "cli_path": "oa approval redirect-task", "confirmation": "not_required", "description": "转交审批任务", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "redirect_task", "primary_cli_path": "oa approval redirect-task", "reviewed": false, "risk": "medium", "title": "redirect_task", "use_when": [ "12. 转交审批任务（taskId 来自 tasks，toActionerId 来自 contact user search）", "转交审批/转交任务" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "拒绝审批", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.reject_processInstance", "cli_name": "reject", "cli_path": "oa approval reject", "confirmation": "user_required", "description": "处理某个需要我处理的实例任务，拒绝审批实例任务，所需要的参数processInstanceId可以从list_pending_approvals工具获取。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "reject_processInstance" }, "metadata_source": "embedded-mcp-metadata", "name": "reject_processInstance", "primary_cli_path": "oa approval reject", "risk": "high", "title": "reject_processInstance", "use_when": [ "4b. 拒绝审批", "拒绝审批/驳回" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "撤销已发起的审批", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.revoke_processInstance", "cli_name": "revoke", "cli_path": "oa approval revoke", "confirmation": "user_required", "description": "撤销当前用户已经发起的审批实例，需要的参数processInstanceId可以从", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "revoke_processInstance" }, "metadata_source": "embedded-mcp-metadata", "name": "revoke_processInstance", "primary_cli_path": "oa approval revoke", "risk": "high", "title": "revoke_processInstance", "use_when": [ "5. 撤销自己发起的审批", "撤回审批/取消审批", "撤销审批/撤回" ] } ], "use_when": [ "审批/请假/报销/出差/加班/同意/拒绝/撤销审批" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/catalog-completeness.json" ], "agent_summary": "管理 DWS 操作所需的行为授权和浏览器授权策略", "agent_summary_source": "dws-command-surface-review", "avoid_when": [ "普通 OAuth 登录使用 auth，而不是 pat" ], "description": "行为授权管理", "id": "pat", "name": "行为授权管理", "runtime": true, "tool_count": 2, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "按可信上下文为当前用户执行 PAT 批量授权，支持 dryRun 和 pending flow。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“按可信上下文为当前用户执行 PAT 批量授权，支持 dryRun 和 pending flow。”所述变更时不要使用" ], "canonical_path": "pat.batch_grant", "cli_name": "chmod", "cli_path": "pat chmod", "confirmation": "user_required", "description": "按可信上下文为当前用户执行 PAT 批量授权，支持 dryRun 和 pending flow。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "pat", "rpc_name": "pat.batch_grant" }, "metadata_source": "embedded-mcp-metadata", "name": "batch_grant", "primary_cli_path": "pat chmod", "reviewed": false, "risk": "high", "title": "批量授权", "use_when": [ "执行批量行为授权（高影响，必须先让用户确认）", "授予 Agent 行为权限/授权 scope/批量授权产品/一次性授权/会话授权/永久授权", "预览按产品展开的批量授权计划，不写入授权" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "配置 PAT 授权时是否打开浏览器", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“配置 PAT 授权时是否打开浏览器”所述变更时不要使用" ], "canonical_path": "pat.browser_policy", "cli_name": "browser-policy", "cli_path": "pat browser-policy", "confirmation": "not_required", "description": "配置 PAT 授权时是否打开浏览器", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "命令仅操作本地进程或策略文件，不调用 MCP 接口", "name": "browser_policy", "primary_cli_path": "pat browser-policy", "reviewed": true, "risk": "medium", "use_when": [ "PAT 授权时允许或禁止打开浏览器/配置浏览器授权策略", "允许 PAT 授权流程打开本地浏览器", "禁止指定 Agent 的 PAT 授权流程打开本地浏览器", "配置 PAT 授权时是否打开浏览器" ] } ], "use_when": [ "命令提示缺少行为授权", "批量申请产品授权或配置授权浏览器策略" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.report.prod.json", "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "日志：模版 / 收件箱 / 发件箱 / 单条详情 / 统计（资源.动词命令树，与 mail 对齐）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "avoid_when": [ "帮我创建一个待办提醒；个人待办", "我发给某人的消息/邮件/文档/今天我干了什么；搜行为记录" ], "description": "钉钉日志（OA 周报应用 / 日志模版填报）", "id": "report", "name": "钉钉日志（OA 周报应用 / 日志模版填报）", "runtime": true, "tool_count": 7, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "提交一份新日报（按模版）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "report create" ], "availability": "available", "avoid_when": [ "要“读取单份日报正文（含字段明细 + 钉钉跳转链接）”请改用 dws report entry get", "要“读取单份日报的已读统计”请改用 dws report entry stats" ], "canonical_path": "report.create_report", "cli_name": "submit", "cli_path": "report entry submit", "confirmation": "not_required", "description": "创建日志", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "create_report" }, "metadata_source": "embedded-mcp-metadata", "name": "create_report", "primary_cli_path": "report entry submit", "risk": "medium", "title": "create_report", "use_when": [ "2b. 提交日志（从步骤 1/2 取 templateId 与 contents 字段）— 推荐 --contents-file 传入避免 shell 引号", "内联（短内容）", "推荐：长内容走文件，避免 shell 引号问题" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取当前用户可用的日志模版列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“读取单个日志模版的字段定义”请改用 dws report template get" ], "canonical_path": "report.get_available_report_templates", "cli_name": "list", "cli_path": "report template list", "confirmation": "not_required", "description": "获取当前员工可使用的日志模版信息，包含日志模板的名称、模板Id等", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "get_available_report_templates" }, "metadata_source": "embedded-mcp-metadata", "name": "get_available_report_templates", "primary_cli_path": "report template list", "risk": "low", "title": "get_available_report_templates", "use_when": [ "1. 获取当前用户可用的日志模版", "写日报/提交周报/发日志/填日志", "有什么日志模版" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出我收到的日报", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "report list" ], "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出我收到的日报”" ], "canonical_path": "report.get_received_report_list", "cli_name": "list", "cli_path": "report inbox list", "confirmation": "not_required", "description": "查询当前人收到的日志列表", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "get_received_report_list" }, "metadata_source": "embedded-mcp-metadata", "name": "get_received_report_list", "primary_cli_path": "report inbox list", "risk": "low", "use_when": [ "3. 查看收到的日报列表 — 提取 reportId", "别人发给我的日志/我收到的日志", "我收到的日志", "查日志/看日报/看正文" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "读取单份日报正文（含字段明细 + 钉钉跳转链接）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "report detail" ], "availability": "available", "avoid_when": [ "要“提交一份新日报（按模版）”请改用 dws report entry submit", "要“读取单份日报的已读统计”请改用 dws report entry stats" ], "canonical_path": "report.get_report_entry_details", "cli_name": "get", "cli_path": "report entry get", "confirmation": "not_required", "description": "获取指定一篇日志的详情信息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "get_report_entry_details" }, "metadata_source": "embedded-mcp-metadata", "name": "get_report_entry_details", "primary_cli_path": "report entry get", "risk": "low", "title": "get_report_entry_details", "use_when": [ "2c. 仅当 submit 返回中缺少 dingtalkOpenUrl 时，手动补取 dingtalk:// 跳转链接", "4. 查看日报详情（正文/字段明细）", "从列表结果提取 reportId 后，再查正文", "先通过 report inbox list / outbox list / entry submit 取得 reportId，再查正文与跳转链接", "已知 reportId", "我发过 / 我创建的日志", "我收到的日志" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "读取单份日报的已读统计", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "report stats" ], "availability": "available", "avoid_when": [ "要“提交一份新日报（按模版）”请改用 dws report entry submit", "要“读取单份日报正文（含字段明细 + 钉钉跳转链接）”请改用 dws report entry get" ], "canonical_path": "report.get_report_statistics_by_id", "cli_name": "stats", "cli_path": "report entry stats", "confirmation": "not_required", "description": "获取日志统计数据，包括评论数量、点赞数量、已读数等", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "get_report_statistics_by_id" }, "metadata_source": "embedded-mcp-metadata", "name": "get_report_statistics_by_id", "primary_cli_path": "report entry stats", "risk": "low", "title": "获取指定日志的统计数据", "use_when": [ "5. 查看日报已读统计", "日志统计/已读统计" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出我发出的日报", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "report created", "report sent" ], "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出我发出的日报”" ], "canonical_path": "report.get_send_report_list", "cli_name": "list", "cli_path": "report outbox list", "confirmation": "not_required", "description": "查询当前人创建的日志详情列表，包含日志的内容、日志名称、创建时间、访问地址等信息", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "get_send_report_list" }, "metadata_source": "embedded-mcp-metadata", "name": "get_send_report_list", "primary_cli_path": "report outbox list", "risk": "low", "title": "get_send_report_list", "use_when": [ "6. 查看我发出的日报列表", "我发过 / 我创建的日志", "我发过的日志/我创建的日志" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "读取单个日志模版的字段定义", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "report template detail" ], "availability": "available", "avoid_when": [ "要“获取当前用户可用的日志模版列表”请改用 dws report template list" ], "canonical_path": "report.get_template_details_by_name", "cli_name": "get", "cli_path": "report template get", "confirmation": "not_required", "description": "获取当前员工可使用的日志模版详情信息，包括日志模板Id、日志模板内字段的名称、字段类型、字段排序等", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "get_template_details_by_name" }, "metadata_source": "embedded-mcp-metadata", "name": "get_template_details_by_name", "primary_cli_path": "report template get", "risk": "low", "title": "get_template_details_by_name", "use_when": [ "2. 按名称读取模版字段定义" ] } ], "use_when": [ "帮我看看收到的日报；收到的日志", "日志/日报/周报/日志统计/写日报/提交周报/发日志/填日志" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.sheet.prod.json", "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "钉钉表格管理", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "avoid_when": [ "帮我建一个项目跟踪表；创建数据表格", "这个 alidocs 表格链接帮我看下\"（粘贴原始 URL）；先 probe 节点类型" ], "description": "钉钉表格管理", "id": "sheet", "name": "钉钉表格管理", "runtime": true, "tool_count": 69, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在钉钉表格的指定工作表末尾追加空行或空列。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉表格的指定工作表末尾追加空行或空列。”所述变更时不要使用" ], "canonical_path": "sheet.add_dimension", "cli_name": "add-dimension", "cli_path": "sheet add-dimension", "confirmation": "not_required", "description": "在钉钉表格的指定工作表末尾追加空行或空列。\r\n\r\n参数说明：\r\n- dimension：维度类型，ROWS 表示追加行，COLUMNS 表示追加列\r\n- length：追加数量，必须为正整数", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "add_dimension", "primary_cli_path": "sheet add-dimension", "reviewed": false, "risk": "medium", "title": "追加行列", "use_when": [ "追加空行/追加空列/增加行数/增加列数/扩展表格/在末尾加空行；追加空行/空列" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在钉钉电子表格的指定工作表末尾追加若干行数据。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉电子表格的指定工作表末尾追加若干行数据。”所述变更时不要使用" ], "canonical_path": "sheet.append_rows", "cli_name": "append", "cli_path": "sheet append", "confirmation": "not_required", "description": "在钉钉电子表格的指定工作表末尾追加若干行数据。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 values 传入要追加的数据。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n系统会自动定位到工作表中最后一行有数据的位置，在其下方插入新行数据。\r\n如果工作表为空，数据将从第一行开始写入。\r\n\r\nvalues 为二维数组，外层数组的每个元素代表一行，内层数组的每个元素代表该行中的一个单元格值。\r\n追加的数据列数应与工作表已有数据的列数保持一致，以确保数据对齐。\r\n\r\n返回追加数据所在的单元格范围（A1 表示法）。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可追加。不支持跨组织操作。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "append_rows", "primary_cli_path": "sheet append", "reviewed": false, "risk": "medium", "title": "追加行", "use_when": [ "3. 追加单行数据", "4. 追加多行数据", "插入行/插入列/在某行前插入/在某列前插入；在末尾追加", "追加数据/添加行/在末尾加数据/新增记录；追加数据" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将多个写操作打包为一次原子请求执行", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要将多个写操作打包为一次原子请求执行时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.batch_update", "cli_name": "batch-update", "cli_path": "sheet batch-update", "confirmation": "not_required", "description": "将多个写操作打包为一次原子请求执行。\n\n默认严格事务模式：任一子操作失败则整批回滚。\n传 --continue-on-error 切换为宽松模式（遇失败继续执行）。\n\ntoolName 使用 CLI 命令名（与原子命令一致），input 的键用 CLI flag 名去掉 --。\nCLI 层自动翻译为 MCP toolName + 参数名，无需记忆 MCP 参数名。\n\n支持的 CLI 命令名:\n range clear / range update / merge-cells / unmerge-cells / update-dimension\n range fill / range copy-to / add-dimension / delete-dimension / move-dimension\n group-dimension / ungroup-dimension\n set-dropdown / delete-dropdown / csv-put / delete-float-image\n\n注意：batch-update 中 group-dimension 适合默认展开分组；需要 --group-state fold 时请使用独立\ndws sheet group-dimension 命令。\n\n--operations 是 JSON 数组，每项包含:\n toolName CLI 命令名（如 \"range clear\", \"range update\"）\n input 该命令的入参（不含 --node），键用 flag 名去掉 --\n\n完整映射表见:\n dingtalk-workspace/references/products/sheet/sheet-batch-operations.md", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "batch_update", "primary_cli_path": "sheet batch-update", "reviewed": false, "risk": "medium", "title": "批量执行多个写操作（原子事务）", "use_when": [ "批量操作/一次执行多个写操作/原子批量/先清除再写入；多个写操作打包" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在钉钉电子表格的指定工作表中创建一个浮动图表", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要在钉钉电子表格的指定工作表中创建一个浮动图表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.chart_create", "cli_name": "create", "cli_path": "sheet chart create", "confirmation": "not_required", "description": "在钉钉电子表格的指定工作表中创建一个浮动图表。\n\n--properties 为 JSON 格式，包含 position（锚点位置）、dimensions（尺寸）、chart（图表配置）三个必填字段，\n以及可选的 offset（偏移量）。支持 stdin heredoc 和 @file 两种传入方式。\n\nchart.type 支持: column（柱形图）、bar（条形图）、columnStacked（堆积柱形图）、barStacked（堆积条形图）、\nline（折线图）、lineStacked（堆积折线图）、area（面积图）、areaStacked（堆积面积图）、\nareaPercentStacked（百分比堆积面积图）、pie（饼图）、doughnut（环形图）、scatter（散点图）、\nradar（雷达图）。\nchart.series[].value / chart.series[].name / chart.category 使用 A1 区域表示法（如 \"A2:B10\"），\n不指定 sheet 前缀时默认使用 --sheet-id 的值。\nposition.col 使用列字母表示法（如 \"A\"、\"AA\"），不支持数字形式。\n\n创建成功后返回新图表的完整信息，包含系统分配的 chart-id。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "chart_create", "primary_cli_path": "sheet chart create", "reviewed": false, "risk": "medium", "title": "创建浮动图表", "use_when": [ "3. 创建柱形图", "创建折线图", "创建柱形图" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除钉钉电子表格中指定的浮动图表", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要删除钉钉电子表格中指定的浮动图表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.chart_delete", "cli_name": "delete", "cli_path": "sheet chart delete", "confirmation": "not_required", "description": "删除钉钉电子表格中指定的浮动图表。\n\n注意: 这是一个危险操作，删除后图表不可恢复。执行前需要确认，或传入 --yes 跳过确认。\nchart-id 可通过 chart list 获取。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "chart_delete", "primary_cli_path": "sheet chart delete", "reviewed": false, "risk": "medium", "title": "删除浮动图表", "use_when": [ "删除钉钉电子表格中指定的浮动图表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取钉钉电子表格指定工作表中的浮动图表", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要获取钉钉电子表格指定工作表中的浮动图表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.chart_list", "cli_name": "list", "cli_path": "sheet chart list", "confirmation": "not_required", "description": "获取钉钉电子表格指定工作表中的浮动图表。\n\n支持两种模式：\n1. 列出全部图表：不传 --chart-id，返回该工作表中所有浮动图表的列表。\n2. 获取单个图表：传入 --chart-id，返回该图表的详细信息。\n\n返回内容包含每个图表的 ID、锚点位置、尺寸坐标以及完整图表配置（类型、数据系列、分类轴、标题、图例、坐标轴等）。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "chart_list", "primary_cli_path": "sheet chart list", "reviewed": false, "risk": "low", "title": "获取浮动图表", "use_when": [ "1. 获取现有配置", "4. 验证创建结果", "列出所有浮动图表", "获取单个图表详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新钉钉电子表格中指定浮动图表的配置", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要更新钉钉电子表格中指定浮动图表的配置时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.chart_update", "cli_name": "update", "cli_path": "sheet chart update", "confirmation": "not_required", "description": "更新钉钉电子表格中指定浮动图表的配置。\n\n注意：本接口采用 PUT 语义（完整覆盖），非增量更新。\n建议先通过 chart list（传入 --chart-id）获取当前配置，修改后整体传入。\n如果只需修改部分字段（如仅修改标题），仍需传入完整的 chart 配置以避免其他字段被清空。\n\n--properties 结构与 chart create 完全相同。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "chart_update", "primary_cli_path": "sheet chart update", "reviewed": false, "risk": "medium", "title": "更新浮动图表", "use_when": [ "3. 整体回写" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "清除钉钉电子表格中指定工作表指定范围的单元格内容、格式或全部。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“基于源数据范围自动填充到目标范围”请改用 dws sheet range fill", "要“对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值”请改用 dws sheet range batch-set-style", "要“将源范围的数据复制到目标位置”请改用 dws sheet range copy-to" ], "canonical_path": "sheet.clear_range", "cli_name": "clear", "cli_path": "sheet range clear", "confirmation": "not_required", "description": "清除钉钉电子表格中指定工作表指定范围的单元格内容、格式或全部。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "clear_range", "primary_cli_path": "sheet range clear", "reviewed": false, "risk": "medium", "title": "清除区域", "use_when": [ "删除行/删除列/删掉第几行/删掉某列/移除行/移除列；仅清空内容但保留行/列", "清空/清除区域/擦除内容/清除格式；仅清除值", "清空/清除区域/擦除内容/清除格式；仅清除格式", "清空/清除区域/擦除内容/清除格式；全部清除", "清空/清除区域/擦除内容/清除格式；清除区域", "清空整片区域请改用 range clear" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "复制钉钉电子表格中的指定工作表，在同一表格中创建一个副本，可同时指定副本的目标位置。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“复制钉钉电子表格中的指定工作表，在同一表格中创建一个副本，可同时指定副本的目标位置。”所述变更时不要使用" ], "canonical_path": "sheet.copy_sheet", "cli_name": "copy", "cli_path": "sheet copy", "confirmation": "not_required", "description": "复制钉钉电子表格中的指定工作表，在同一表格中创建一个副本，可同时指定副本的目标位置。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "copy_sheet", "primary_cli_path": "sheet copy", "reviewed": false, "risk": "medium", "title": "复制工作表", "use_when": [ "只指定名称", "复制工作表/拷贝工作表/克隆工作表/工作表副本；复制工作表", "复制工作表/拷贝工作表/克隆工作表/工作表副本；复制并指定位置", "复制工作表/拷贝工作表/克隆工作表/工作表副本；复制并指定名称", "指定副本名称和位置", "按默认位置复制" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建条件格式规则", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "只设置静态样式用 sheet range set-style", "更新已有条件格式用 sheet cond-format update", "查看条件格式列表用 sheet cond-format list" ], "canonical_path": "sheet.create_cond_format", "cli_name": "create", "cli_path": "sheet cond-format create", "confirmation": "not_required", "description": "在指定工作表中创建一条条件格式规则。\r\n条件格式规则定义了当单元格满足特定条件时自动应用的样式。\r\n每条规则需要指定：应用范围（ranges）、条件类型及参数、命中时的单元格样式（cellStyle）。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_cond_format", "primary_cli_path": "sheet cond-format create", "reviewed": true, "risk": "medium", "title": "创建条件格式规则", "use_when": [ "按条件高亮或设置格式规则" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "为工作表创建基础筛选", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "只查看筛选信息用 sheet filter get", "更新筛选条件用 sheet filter update 或 clear-criteria", "管理筛选视图用 sheet filter-view create/update/list" ], "canonical_path": "sheet.create_filter", "cli_name": "create", "cli_path": "sheet filter create", "confirmation": "not_required", "description": "在钉钉电子表格的指定工作表中创建筛选。\r\n创建筛选后，工作表的指定范围将出现筛选下拉箭头，用户可通过 set_filter_criteria 设置具体的筛选条件。\r\n每个工作表只能有一个筛选，如果已存在筛选则会报错。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_filter", "primary_cli_path": "sheet filter create", "reviewed": true, "risk": "medium", "title": "创建筛选", "use_when": [ "需要在普通筛选范围上开启筛选" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建筛选视图", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "创建普通筛选用 sheet filter create", "更新已有筛选视图用 sheet filter-view update", "查看筛选视图列表用 sheet filter-view list" ], "canonical_path": "sheet.create_filter_view", "cli_name": "create", "cli_path": "sheet filter-view create", "confirmation": "not_required", "description": "在钉钉电子表格的指定工作表中创建一个筛选视图。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n筛选视图是独立于全局筛选的个人化数据过滤方式。创建后可通过 set_filter_view_criteria 设置具体的筛选条件。\r\n同一工作表可以创建多个筛选视图。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可创建。不支持跨组织操作。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_filter_view", "primary_cli_path": "sheet filter-view create", "reviewed": true, "risk": "medium", "title": "创建筛选视图", "use_when": [ "需要创建可保存的筛选视图" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在钉钉电子表格的指定工作表中插入一张浮动图片。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉电子表格的指定工作表中插入一张浮动图片。”所述变更时不要使用" ], "canonical_path": "sheet.create_float_image", "cli_name": "create-float-image", "cli_path": "sheet create-float-image", "confirmation": "not_required", "description": "在钉钉电子表格的指定工作表中插入一张浮动图片。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_float_image", "primary_cli_path": "sheet create-float-image", "reviewed": false, "risk": "medium", "title": "插入浮动图片", "use_when": [ "再创建浮动图片", "带偏移量" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "新建工作表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“新建工作表”所述变更时不要使用" ], "canonical_path": "sheet.create_sheet", "cli_name": "new", "cli_path": "sheet new", "confirmation": "not_required", "description": "在钉钉表格中创建一个新的工作表。\r\n通过 nodeId 定位表格文件，在该表格中新增一个工作表。\r\n当指定的工作表名称与已有名称重复时，系统会自动重命名为合法值。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "create_sheet" }, "metadata_source": "embedded-mcp-metadata", "name": "create_sheet", "primary_cli_path": "sheet new", "risk": "medium", "title": "新建工作表", "use_when": [ "1. 新建工作表", "加工作表/新增Sheet；新建工作表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建钉钉表格文档", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建钉钉表格文档”所述变更时不要使用" ], "canonical_path": "sheet.create_workspace_sheet", "cli_name": "create", "cli_path": "sheet create", "confirmation": "not_required", "description": "创建一篇新的钉钉在线表格。\r\n支持创建空表格。\r\n支持三种创建位置：\r\n1. 指定 folderId：在该文件夹下创建\r\n2. 指定 workspaceId（知识库 ID）但不传 folderId：在该知识库的根目录下创建\r\n3. 都不传：在用户\"我的文档\"根目录下创建\r\n操作受权限控制，仅当调用者对目标位置有写入权限时可成功创建。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "create_workspace_sheet" }, "metadata_source": "embedded-mcp-metadata", "name": "create_workspace_sheet", "primary_cli_path": "sheet create", "risk": "medium", "title": "新建钉钉表格", "use_when": [ "1. 创建表格文档 — 提取 nodeId", "4. 完整流程: 创建表格 → 上传附件", "4. 完整流程: 创建表格 → 写表头 → 写入图片", "创建表格/新建电子表格；创建表格文档" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除条件格式规则", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除普通筛选用 sheet filter delete", "删除筛选视图用 sheet filter-view delete", "只修改规则用 sheet cond-format update" ], "canonical_path": "sheet.delete_cond_format", "cli_name": "delete", "cli_path": "sheet cond-format delete", "confirmation": "user_required", "description": "删除指定工作表中的一条条件格式规则。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "delete_cond_format", "primary_cli_path": "sheet cond-format delete", "reviewed": true, "risk": "high", "title": "删除条件格式规则", "use_when": [ "删除某条条件格式规则" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在钉钉表格指定工作表中，从指定位置起删除若干连续的行或列。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "用户未明确要求“在钉钉表格指定工作表中，从指定位置起删除若干连续的行或列。”、目标不清楚或尚未确认时不要使用" ], "canonical_path": "sheet.delete_dimension", "cli_name": "delete-dimension", "cli_path": "sheet delete-dimension", "confirmation": "user_required", "description": "在钉钉表格指定工作表中，从指定位置起删除若干连续的行或列。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "delete_dimension", "primary_cli_path": "sheet delete-dimension", "reviewed": false, "risk": "high", "title": "删除指定位置的行或列", "use_when": [ "2. 从第 3 行开始删除 2 行", "3. 从 A 列开始删除 1 列", "4. 使用工作表前缀指定位置", "从 A 列开始删除 1 列", "从 AB 列开始删除 3 列", "从第 3 行开始删除 2 行", "使用工作表前缀（忽略 --sheet-id）", "删除行/删除列/删掉第几行/删掉某列/移除行/移除列；删除行或列" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除单元格下拉列表配置", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "修改下拉选项用 sheet set-dropdown", "只查询下拉配置用 sheet get-dropdown", "清空单元格内容用 sheet range clear" ], "canonical_path": "sheet.delete_dropdown_lists", "cli_name": "delete-dropdown", "cli_path": "sheet delete-dropdown", "confirmation": "user_required", "description": "删除钉钉表格指定单元格范围内的下拉列表配置。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "delete_dropdown_lists", "primary_cli_path": "sheet delete-dropdown", "reviewed": true, "risk": "high", "title": "删除下拉列表", "use_when": [ "移除指定范围的下拉列表配置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除工作表基础筛选", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "仅查看筛选信息用 sheet filter get", "删除筛选视图用 sheet filter-view delete", "只清除某列条件用 sheet filter clear-criteria" ], "canonical_path": "sheet.delete_filter", "cli_name": "delete", "cli_path": "sheet filter delete", "confirmation": "user_required", "description": "删除钉钉电子表格中指定工作表的筛选。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n删除筛选后，工作表中的筛选下拉箭头和所有筛选条件将被移除，所有被隐藏的行将重新显示。\r\n如果工作表没有筛选，调用此接口会报错。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可删除。不支持跨组织操作。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "delete_filter", "primary_cli_path": "sheet filter delete", "reviewed": true, "risk": "high", "title": "删除筛选", "use_when": [ "移除整张表的普通筛选配置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除筛选视图", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除基础筛选用 sheet filter delete", "只删除某列条件用 sheet filter-view delete-criteria", "查看筛选视图详情用 sheet filter-view info" ], "canonical_path": "sheet.delete_filter_view", "cli_name": "delete", "cli_path": "sheet filter-view delete", "confirmation": "user_required", "description": "删除钉钉电子表格中指定工作表的筛选视图。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 filterViewId 定位筛选视图。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\nfilterViewId 可通过 get_filter_views 获取。\r\n\r\n删除筛选视图后，该视图及其所有筛选条件将被永久移除。此操作不影响全局筛选或其他筛选视图。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可删除。不支持跨组织操作。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "delete_filter_view", "primary_cli_path": "sheet filter-view delete", "reviewed": true, "risk": "high", "title": "删除筛选视图", "use_when": [ "删除一个已保存的筛选视图" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除钉钉电子表格中指定的浮动图片。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "用户未明确要求“删除钉钉电子表格中指定的浮动图片。”、目标不清楚或尚未确认时不要使用" ], "canonical_path": "sheet.delete_float_image", "cli_name": "delete-float-image", "cli_path": "sheet delete-float-image", "confirmation": "user_required", "description": "删除钉钉电子表格中指定的浮动图片。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "delete_float_image", "primary_cli_path": "sheet delete-float-image", "reviewed": false, "risk": "high", "title": "删除浮动图片", "use_when": [ "删除浮动图片/移除浮动图片；删除浮动图片" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除钉钉电子表格中的指定工作表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "用户未明确要求“删除钉钉电子表格中的指定工作表”、目标不清楚或尚未确认时不要使用" ], "canonical_path": "sheet.delete_sheet", "cli_name": "delete-sheet", "cli_path": "sheet delete-sheet", "confirmation": "user_required", "description": "删除钉钉电子表格中的指定工作表", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "delete_sheet", "primary_cli_path": "sheet delete-sheet", "reviewed": false, "risk": "high", "title": "删除工作表", "use_when": [ "删除工作表/移除工作表/删掉这个Sheet；删除工作表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "基于源数据范围自动填充到目标范围。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值”请改用 dws sheet range batch-set-style", "要“将源范围的数据复制到目标位置”请改用 dws sheet range copy-to", "要“清除钉钉电子表格中指定工作表指定范围的单元格内容、格式或全部”请改用 dws sheet range clear" ], "canonical_path": "sheet.fill_range", "cli_name": "fill", "cli_path": "sheet range fill", "confirmation": "not_required", "description": "基于源数据范围自动填充到目标范围。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "fill_range", "primary_cli_path": "sheet range fill", "reviewed": false, "risk": "medium", "title": "区域自动填充", "use_when": [ "自动填充/填充序列/向下填充/拖拽填充/序列递增；自动填充" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "清除基础筛选中某一列条件", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除整个基础筛选用 sheet filter delete", "更新筛选条件用 sheet filter update", "筛选视图条件用 sheet filter-view delete-criteria" ], "canonical_path": "sheet.filter_clear_criteria", "cli_name": "clear-criteria", "cli_path": "sheet filter clear-criteria", "confirmation": "not_required", "description": "清除钉钉电子表格中指定工作表筛选的某一列的筛选条件。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 column 指定目标列。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n清除指定列的筛选条件后，该列不再参与筛选计算，之前被该列条件隐藏的行将重新显示（前提是其他列的条件也不隐藏该行）。\r\n此操作仅清除指定列的条件，不会删除整个筛选。如需删除整个筛选，请使用 delete_filter。\r\n\r\n如果指定列没有设置筛选条件，调用此接口不会报错。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可操作。不支持跨组织操作。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "clear_filter_criteria" }, "metadata_source": "embedded-mcp-metadata", "name": "filter_clear_criteria", "primary_cli_path": "sheet filter clear-criteria", "reviewed": true, "risk": "medium", "title": "清除筛选条件", "use_when": [ "仅清除普通筛选的某列筛选条件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除筛选视图单列筛选条件", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除整个筛选视图用 sheet filter-view delete", "基础筛选清除列条件用 sheet filter clear-criteria", "更新条件用 sheet filter-view update-criteria" ], "canonical_path": "sheet.filter_view_delete_criteria", "cli_name": "delete-criteria", "cli_path": "sheet filter-view delete-criteria", "confirmation": "user_required", "description": "清除钉钉电子表格中指定工作表筛选视图的某一列的筛选条件。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 filterViewId 定位筛选视图，通过 column 指定目标列。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\nfilterViewId 可通过 get_filter_views 获取。\r\n\r\n清除指定列的筛选条件后，该列不再参与筛选视图的筛选计算。\r\n此操作仅清除指定列的条件，不会删除整个筛选视图。如需删除整个筛选视图，请使用 delete_filter_view。\r\n清除操作仅影响当前筛选视图，不影响全局筛选或其他筛选视图。\r\n\r\n如果指定列没有设置筛选条件，调用此接口不会报错。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可操作。不支持跨组织操作。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "clear_filter_view_criteria" }, "metadata_source": "embedded-mcp-metadata", "name": "filter_view_delete_criteria", "primary_cli_path": "sheet filter-view delete-criteria", "reviewed": true, "risk": "high", "title": "清除筛选视图列条件", "use_when": [ "清除筛选视图中某列的筛选条件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取单列筛选条件", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "列出所有列条件用 sheet filter-view list-criteria", "删除单列条件用 sheet filter-view delete-criteria", "更新单列条件用 sheet filter-view update-criteria" ], "canonical_path": "sheet.filter_view_get_criteria", "cli_name": "get-criteria", "cli_path": "sheet filter-view get-criteria", "confirmation": "not_required", "description": "获取钉钉电子表格中指定工作表的所有筛选视图列表。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n筛选视图是独立于全局筛选的个人化数据过滤方式，不同用户可以创建自己的筛选视图，互不影响。\r\n返回该工作表下所有筛选视图的 ID、名称和范围信息。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_filter_views" }, "metadata_source": "embedded-mcp-metadata", "name": "filter_view_get_criteria", "primary_cli_path": "sheet filter-view get-criteria", "reviewed": true, "risk": "low", "title": "获取筛选视图", "use_when": [ "查看筛选视图某一列的筛选条件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取单个筛选视图详情", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "列出所有筛选视图用 sheet filter-view list", "更新筛选视图用 sheet filter-view update", "查看列条件用 sheet filter-view list-criteria" ], "canonical_path": "sheet.filter_view_info", "cli_name": "info", "cli_path": "sheet filter-view info", "confirmation": "not_required", "description": "获取钉钉电子表格中指定工作表的所有筛选视图列表。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n筛选视图是独立于全局筛选的个人化数据过滤方式，不同用户可以创建自己的筛选视图，互不影响。\r\n返回该工作表下所有筛选视图的 ID、名称和范围信息。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_filter_views" }, "metadata_source": "embedded-mcp-metadata", "name": "filter_view_info", "primary_cli_path": "sheet filter-view info", "reviewed": true, "risk": "low", "title": "获取筛选视图", "use_when": [ "已知道 filterViewId，需要查看名称、范围和配置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出筛选视图所有列条件", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "基础筛选条件用 sheet filter get/update", "更新条件用 sheet filter-view update-criteria", "查看单列条件用 sheet filter-view get-criteria" ], "canonical_path": "sheet.filter_view_list_criteria", "cli_name": "list-criteria", "cli_path": "sheet filter-view list-criteria", "confirmation": "not_required", "description": "获取钉钉电子表格中指定工作表的所有筛选视图列表。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n筛选视图是独立于全局筛选的个人化数据过滤方式，不同用户可以创建自己的筛选视图，互不影响。\r\n返回该工作表下所有筛选视图的 ID、名称和范围信息。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_filter_views" }, "metadata_source": "embedded-mcp-metadata", "name": "filter_view_list_criteria", "primary_cli_path": "sheet filter-view list-criteria", "reviewed": true, "risk": "low", "title": "获取筛选视图", "use_when": [ "查看筛选视图下每列筛选条件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新筛选视图列条件", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "删除筛选视图列条件用 sheet filter-view delete-criteria", "更新基础筛选条件用 sheet filter update", "更新视图名称/范围用 sheet filter-view update" ], "canonical_path": "sheet.filter_view_update_criteria", "cli_name": "update-criteria", "cli_path": "sheet filter-view update-criteria", "confirmation": "not_required", "description": "更新钉钉电子表格中指定工作表筛选视图的某一列的筛选条件。\n\n用途：为筛选视图的指定列创建或更新筛选条件，控制该列哪些数据行可见。\n场景：\n - 只显示某些特定值的行（如\"只看研发部\"）→ 使用 filterType: values\n - 按数值条件筛选（如\"绩效 ≥ 85\"）→ 使用 filterType: condition + operator: greater-equal\n - 按文本条件筛选（如\"名称包含关键字\"）→ 使用 filterType: condition + operator: contains\n区分：\n - update-criteria 精确控制单列条件，适合逐列设置不同的筛选逻辑\n - filter-view update --criteria 可以批量更新多列条件，适合一次性设置多列\n - delete-criteria 是 update-criteria 的逆操作，删除指定列的条件\n\n通过 --node 定位电子表格文档，通过 --sheet-id 定位工作表，通过 --filter-view-id 定位筛选视图，通过 --column 指定目标列。\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\nsheetId 支持传入工作表 ID 或工作表名称，可通过 sheet list 获取。\nfilterViewId 可通过 filter-view list 获取。\n\n--column 为列偏移量（从 0 开始），相对于筛选视图范围首列。\n例如筛选视图范围为 B1:E10，则 --column 0 代表 B 列，--column 1 代表 C 列。\n\n--filter-criteria 为该列的筛选条件 JSON 对象，支持三种筛选类型：\n values 按值筛选，通过 visibleValues 指定允许显示的值列表\n condition 按条件筛选，通过 conditions 指定条件运算符和比较值（最多 2 个）\n color 按颜色筛选，通过 backgroundColor 或 fontColor 指定颜色\n\ncondition 类型支持的 operator（必须使用 kebab-case 格式）：\n equal, not-equal, contains, not-contains,\n starts-with, not-starts-with, ends-with, not-ends-with,\n greater, greater-equal, less, less-equal\n\n多条件之间通过 conditionOperator 指定逻辑关系：\"and\"（且，默认）或 \"or\"（或）。\n\n更新条件后会立即在该筛选视图中生效。筛选视图的条件仅影响当前视图，不影响全局筛选或其他筛选视图。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "set_filter_view_criteria" }, "name": "filter_view_update_criteria", "primary_cli_path": "sheet filter-view update-criteria", "reviewed": true, "risk": "medium", "title": "更新筛选视图列条件", "use_when": [ "修改筛选视图中某一列的筛选规则" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在钉钉电子表格的指定工作表中查找匹配指定文本的所有单元格，返回匹配的单元格地址列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“在钉钉电子表格的指定工作表中查找匹配指定文本的所有单元格，返回匹配的单元格地址列表。”" ], "canonical_path": "sheet.find_cells", "cli_name": "find", "cli_path": "sheet find", "confirmation": "not_required", "description": "在钉钉电子表格的指定工作表中查找匹配指定文本的所有单元格，返回匹配的单元格地址列表。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 text 指定查找内容。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n支持多种查找模式：\r\n- 默认模式：在单元格值中进行子字符串匹配（区分大小写）\r\n- 忽略大小写：通过 matchCase: false 实现\r\n- 完整单元格匹配：通过 matchEntireCell: true 实现，仅匹配内容完全相同的单元格\r\n- 正则表达式：通过 useRegExp: true 实现，text 作为正则表达式进行匹配\r\n- 搜索公式：通过 matchFormulaText: true 实现，在公式文本中查找而非计算结果\r\n- 包含隐藏单元格：通过 includeHidden: true 实现\r\n\r\n返回所有匹配单元格的地址（A1 表示法）列表。若无匹配结果，返回空数组。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可查找。不支持跨组织查询。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "find_cells", "primary_cli_path": "sheet find", "reviewed": false, "risk": "low", "title": "查找", "use_when": [ "2. 基本搜索 — 在指定工作表中查找文本", "3. 在指定范围内搜索", "4. 正则搜索（不区分大小写）", "5. 精确匹配整个单元格", "6. 搜索公式文本", "在指定范围内搜索", "基本搜索", "导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；\"帮我找一下表格里的XXX", "搜索/查找/找单元格/搜内容/精确搜索/精确匹配/完全匹配/全字匹配；搜索公式", "搜索/查找/找单元格/搜内容/精确搜索/精确匹配/完全匹配/全字匹配；搜索单元格", "搜索/查找/找单元格/搜内容/精确搜索/精确匹配/完全匹配/全字匹配；正则搜索", "搜索/查找/找单元格/搜内容/精确搜索/精确匹配/完全匹配/全字匹配；精确匹配（只匹配完全等于的，不匹配包含的）", "搜索公式文本", "正则表达式搜索（不区分大小写）", "精确匹配整个单元格内容" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取全部工作表列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取全部工作表列表”" ], "canonical_path": "sheet.get_all_sheets", "cli_name": "list", "cli_path": "sheet list", "confirmation": "not_required", "description": "获取钉钉电子表格中的所有工作表列表。\r\n\r\n通过 nodeId 定位电子表格文档，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\n返回该电子表格下所有工作表的 ID 和名称，可用于后续调用 get_sheet 或 get_range 时指定目标工作表。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。\r\n\r\n支持的文档类型：钉钉在线电子表格。\r\n文档链接格式：https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\r\ndentryUuid 为 32 位字母数字字符串。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_all_sheets" }, "metadata_source": "embedded-mcp-metadata", "name": "get_all_sheets", "primary_cli_path": "sheet list", "risk": "low", "title": "获取所有工作表", "use_when": [ "1. 先查 sheetId", "1. 获取工作表列表", "2. 查看工作表列表 — 提取 sheetId", "导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；\"这个表格有哪些工作表", "导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；extension=axls", "看工作表/有哪些工作表/表格结构；列出工作表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查看条件格式规则列表或详情", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "创建条件格式用 sheet cond-format create", "删除条件格式用 sheet cond-format delete", "更新条件格式用 sheet cond-format update" ], "canonical_path": "sheet.get_cond_format", "cli_name": "list", "cli_path": "sheet cond-format list", "confirmation": "not_required", "description": "获取指定工作表中的所有条件格式规则，或通过 ruleId 获取单个规则的详情。\r\n条件格式规则定义了当单元格满足特定条件时自动应用的样式（如背景色、字体颜色等）。\r\n返回的每条规则包含：规则 ID、应用范围、条件类型及参数、命中时的单元格样式。\r\n支持的条件类型包括：数值比较、文本包含、空值/非空、错误值、重复/唯一值、自定义公式、排名、高于/低于平均值、标准差、时间段、数据条、图标集、色阶。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_cond_format", "primary_cli_path": "sheet cond-format list", "reviewed": true, "risk": "low", "title": "获取条件格式规则", "use_when": [ "查看工作表已有条件格式规则" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询单元格下拉列表配置", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除下拉列表用 sheet delete-dropdown", "设置下拉列表用 sheet set-dropdown", "读取单元格值用 sheet range read" ], "canonical_path": "sheet.get_dropdown_lists", "cli_name": "get-dropdown", "cli_path": "sheet get-dropdown", "confirmation": "not_required", "description": "查询钉钉表格指定范围内的下拉列表配置。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_dropdown_lists", "primary_cli_path": "sheet get-dropdown", "reviewed": true, "risk": "low", "title": "获取下拉列表", "use_when": [ "查看某个范围是否配置了下拉列表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查看工作表基础筛选信息", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "创建或更新筛选用 sheet filter create/update", "查看筛选视图列表用 sheet filter-view list", "查看筛选视图条件用 sheet filter-view get-criteria" ], "canonical_path": "sheet.get_filter", "cli_name": "get", "cli_path": "sheet filter get", "confirmation": "not_required", "description": "获取钉钉电子表格中指定工作表的筛选信息。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n返回当前工作表的筛选范围和各列的筛选条件详情。\r\n筛选条件类型包括：\r\n- 按值筛选（filterType: values）：指定允许显示的值列表\r\n- 按条件筛选（filterType: condition）：指定条件运算符和比较值\r\n- 按颜色筛选（filterType: color）：按单元格背景色或字体颜色筛选\r\n\r\n如果工作表未设置筛选，返回结果中筛选信息为空。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_filter", "primary_cli_path": "sheet filter get", "reviewed": true, "risk": "low", "title": "获取筛选", "use_when": [ "查看普通筛选是否存在及范围" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出工作表筛选视图", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "创建/更新筛选视图用 create/update", "查看列条件用 sheet filter-view list-criteria", "查看单个筛选视图详情用 sheet filter-view info" ], "canonical_path": "sheet.get_filter_views", "cli_name": "list", "cli_path": "sheet filter-view list", "confirmation": "not_required", "description": "获取钉钉电子表格中指定工作表的所有筛选视图列表。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n筛选视图是独立于全局筛选的个人化数据过滤方式，不同用户可以创建自己的筛选视图，互不影响。\r\n返回该工作表下所有筛选视图的 ID、名称和范围信息。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_filter_views", "primary_cli_path": "sheet filter-view list", "reviewed": true, "risk": "low", "title": "获取筛选视图", "use_when": [ "查看有哪些筛选视图" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取钉钉电子表格中指定浮动图片的详细信息。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取钉钉电子表格中指定浮动图片的详细信息。”" ], "canonical_path": "sheet.get_float_image", "cli_name": "get-float-image", "cli_path": "sheet get-float-image", "confirmation": "not_required", "description": "获取钉钉电子表格中指定浮动图片的详细信息。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_float_image", "primary_cli_path": "sheet get-float-image", "reviewed": false, "risk": "low", "title": "获取单张浮动图片", "use_when": [ "查看浮动图片/有哪些浮动图片/浮动图片列表；查看某个浮动图片详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "以 CSV 格式读取指定区域数据", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入 CSV 用 sheet csv-put", "写入普通二维数组用 sheet range update", "需要 JSON/结构化值用 sheet range read" ], "canonical_path": "sheet.get_range_as_csv", "cli_name": "csv-get", "cli_path": "sheet csv-get", "confirmation": "not_required", "description": "以 RFC 4180 CSV 格式读取钉钉电子表格中指定工作表的指定范围数据。\r\n\r\n与 get_range 的区别：\r\n- 返回 CSV 文本而非 JSON 二维数组，token 消耗约为 JSON 的 1/3\r\n- 每行前加 [row=N] 前缀标注真实表格行号，防止行号计算错误\r\n- 返回 colIndices 列字母映射数组，防止手数列号\r\n- 内置 maxChars 防爆保护，超限自动截断并设 hasMore=true\r\n- 支持 valueRenderOption 选择返回格式化展示值、原始值或公式文本", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_range_as_csv", "primary_cli_path": "sheet csv-get", "reviewed": true, "risk": "low", "title": "以 CSV 格式读取工作表数据", "use_when": [ "需要 CSV 文本而非 JSON 二维数组时读取 range" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "对钉钉表格指定工作表中的连续整行或整列创建分组", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要对钉钉表格指定工作表中的连续整行或整列创建分组时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.group_dimension", "cli_name": "group-dimension", "cli_path": "sheet group-dimension", "confirmation": "not_required", "description": "对钉钉表格指定工作表中的连续整行或整列创建分组。\n\n--range 使用整行/整列范围：\n 行分组：3:7 或 3\n 列分组：C:F 或 C\n\n支持在 --range 中携带工作表前缀（如 \"Sheet1!3:7\" / \"Sheet1!C:F\"），此时将忽略 --sheet-id。\n创建后可通过 sheet info --include groups 回读 rowGroups / columnGroups。\n\n--group-state 支持 expand / fold，默认 expand。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "group_dimension", "primary_cli_path": "sheet group-dimension", "reviewed": false, "risk": "low", "title": "对指定连续行/列创建分组", "use_when": [ "创建行分组/创建列分组/折叠几行/折叠几列/取消行列分组；创建分组", "创建行分组/创建列分组/折叠几行/折叠几列/展开行列分组/取消行列分组；创建分组", "创建行分组/创建列分组/折叠几行/折叠几列/展开行列分组/取消行列分组；创建并折叠" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取指定工作表详情", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定工作表详情”" ], "canonical_path": "sheet.info", "cli_name": "info", "cli_path": "sheet info", "confirmation": "not_required", "description": "获取钉钉电子表格中指定工作表的详细信息。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位具体的工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n返回指定工作表的 ID、名称、可见性、行列数、最后非空行列位置等详细信息。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。\r\n\r\n支持的文档类型：钉钉在线电子表格。\r\n文档链接格式：https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\r\ndentryUuid 为 32 位字母数字字符串。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_sheet" }, "metadata_source": "embedded-mcp-metadata", "name": "info", "primary_cli_path": "sheet info", "risk": "low", "title": "get_sheet", "use_when": [ "2. 查看工作表详情（确认列结构）", "2. 查看工作表详情（行列数、最后非空位置、mergedRanges 等）", "2. 查看工作表详情（行列数、最后非空位置等）", "看工作表/有哪些工作表/表格结构；工作表详情", "读数据/看表格内容；需要查看合并单元格 / 表头合并结构" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在钉钉表格指定工作表的指定位置之前（before）插入若干空行或空列。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉表格指定工作表的指定位置之前（before）插入若干空行或空列。”所述变更时不要使用" ], "canonical_path": "sheet.insert_dimension", "cli_name": "insert-dimension", "cli_path": "sheet insert-dimension", "confirmation": "not_required", "description": "在钉钉表格指定工作表的指定位置之前（before）插入若干空行或空列。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "insert_dimension", "primary_cli_path": "sheet insert-dimension", "reviewed": false, "risk": "medium", "title": "在指定位置插入行或列", "use_when": [ "2. 在第 3 行之前插入 2 行", "3. 在 A 列之前插入 1 列", "4. 使用工作表前缀指定位置", "使用工作表前缀（忽略 --sheet-id）", "在 A 列之前插入 1 列", "在 AB 列之前插入 3 列", "在第 3 行之前插入 2 行", "插入行/插入列/在某行前插入/在某列前插入；插入行或列", "查看具体命令的完整参数说明" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出钉钉电子表格指定工作表中的所有浮动图片。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出钉钉电子表格指定工作表中的所有浮动图片。”" ], "canonical_path": "sheet.list_float_images", "cli_name": "list-float-images", "cli_path": "sheet list-float-images", "confirmation": "not_required", "description": "列出钉钉电子表格指定工作表中的所有浮动图片。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_float_images", "primary_cli_path": "sheet list-float-images", "reviewed": false, "risk": "low", "title": "获取所有浮动图片", "use_when": [ "查看浮动图片/有哪些浮动图片/浮动图片列表；列出所有浮动图片" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "上传附件到表格", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“上传附件到表格”所述变更时不要使用" ], "canonical_path": "sheet.media_upload", "cli_name": "media-upload", "cli_path": "sheet media-upload", "confirmation": "not_required", "description": "将本地文件作为附件上传到钉钉表格（两步自动完成）。\n\n流程:\n 1. 获取附件上传凭证 (get_doc_attachment_upload_info)\n 2. HTTP PUT 上传文件到 OSS\n\n上传成功后返回 resourceId，可用于后续引用。\n--mime-type 可选，不指定时根据文件扩展名自动推断。", "effect": "write", "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "name": "media_upload", "primary_cli_path": "sheet media-upload", "reviewed": true, "risk": "medium", "title": "上传附件到表格", "use_when": [ "1. 基本用法: 上传本地文件到表格", "2. 自定义附件显示名称 (--name 指定上传后在表格中显示的名称)", "3. 指定 MIME 类型 (文件扩展名无法推断时)", "上传附件/传文件到表格/上传文件到表格/上传到表格；上传附件", "上传附件/传文件到表格/上传文件到表格/上传到表格；用户指定了上传后的名称", "上传附件到表格", "先上传图片获取 resourceUrl", "提取 nodeId 后:", "浮动图片/悬浮图片/在表格上放一张图/加个浮动的图；创建浮动图片" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将钉钉电子表格中指定工作表的指定区域内的单元格合并为一个或多个合并区域。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“将钉钉电子表格中指定工作表的指定区域内的单元格合并为一个或多个合并区域。”所述变更时不要使用" ], "canonical_path": "sheet.merge_cells", "cli_name": "merge-cells", "cli_path": "sheet merge-cells", "confirmation": "not_required", "description": "将钉钉电子表格中指定工作表的指定区域内的单元格合并为一个或多个合并区域。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "merge_cells", "primary_cli_path": "sheet merge-cells", "reviewed": false, "risk": "medium", "title": "合并单元格", "use_when": [ "2. 合并所有单元格（默认 mergeAll）", "3. 按行合并", "4. 按列合并", "使用带工作表前缀的范围（忽略 --sheet-id）", "合并单元格/合并/合并区域/按行合并/按列合并；合并所有单元格", "合并单元格/合并/合并区域/按行合并/按列合并；按列合并", "合并单元格/合并/合并区域/按行合并/按列合并；按行合并", "合并所有单元格（默认）", "按列合并", "按行合并" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在钉钉表格的指定工作表中，将指定范围的行或列移动到目标位置。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉表格的指定工作表中，将指定范围的行或列移动到目标位置。”所述变更时不要使用" ], "canonical_path": "sheet.move_dimension", "cli_name": "move-dimension", "cli_path": "sheet move-dimension", "confirmation": "not_required", "description": "在钉钉表格的指定工作表中，将指定范围的行或列移动到目标位置。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "move_dimension", "primary_cli_path": "sheet move-dimension", "reviewed": false, "risk": "medium", "title": "移动行列", "use_when": [ "将 B~C 列移动到 E 列的位置", "将 B~C 列（共 2 列）移动到 D 列的位置", "将第 2 行移动到第 5 行的位置", "将第 2 行移动到第 5 行的位置（索引从 0 开始）", "将第 2~4 行移动到第 1 行之前", "将第 2~4 行（共 3 行）移动到第 1 行的位置（最前面）", "移动行/移动列/调整行顺序/调整列顺序/行列拖拽/把第N行移到第M行；移动行或列" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量清除多个区域的内容或格式", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入/更新值用 sheet range update", "删除整张工作表用 sheet delete-sheet", "只清除一个区域用 sheet range clear" ], "canonical_path": "sheet.range_batch_clear", "cli_name": "batch-clear", "cli_path": "sheet range batch-clear", "confirmation": "user_required", "description": "批量清除多个区域，一次原子请求。任一区域清除失败则整批回滚。\n\n每个 --ranges 项必须包含工作表前缀（格式: \"SheetName!A1:B3\"）。\n不同区域可以属于不同工作表。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "range_batch_clear", "primary_cli_path": "sheet range batch-clear", "reviewed": true, "risk": "high", "title": "批量清除多个区域（原子事务）", "use_when": [ "一次清除多个 range 的值、格式或全部内容" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量设置多个区域的单元格样式或格式", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入单元格值用 sheet range update", "只设置一个区域样式用 sheet range set-style", "清空多个区域用 sheet range batch-clear" ], "canonical_path": "sheet.range_batch_set_style", "cli_name": "batch-set-style", "cli_path": "sheet range batch-set-style", "confirmation": "not_required", "description": "对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值、超链接、数字格式等内容。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "update_range" }, "metadata_source": "embedded-mcp-metadata", "name": "range_batch_set_style", "primary_cli_path": "sheet range batch-set-style", "reviewed": true, "risk": "medium", "title": "更新表格指定区域内容", "use_when": [ "一次更新多个 range 的样式或格式" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "复制源区域到目标区域", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入新值用 sheet range update", "只读取源数据用 sheet range read", "移动并清空源区域用 sheet range move-to" ], "canonical_path": "sheet.range_copy_to", "cli_name": "copy-to", "cli_path": "sheet range copy-to", "confirmation": "not_required", "description": "将源范围的数据复制到目标位置。支持同 sheet 和跨 sheet 复制。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "copy_range" }, "metadata_source": "embedded-mcp-metadata", "name": "range_copy_to", "primary_cli_path": "sheet range copy-to", "reviewed": true, "risk": "medium", "title": "区域复制", "use_when": [ "把一个 range 的数据复制到另一个位置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "移动源区域到目标区域并清空源区域", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "只复制不清空源区域用 sheet range copy-to", "只读取数据用 sheet range read", "清空区域用 sheet range clear" ], "canonical_path": "sheet.range_move_to", "cli_name": "move-to", "cli_path": "sheet range move-to", "confirmation": "user_required", "description": "将源范围的数据移动到目标位置，源区域将被清空。支持同 sheet 和跨 sheet 移动。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "move_range" }, "metadata_source": "embedded-mcp-metadata", "name": "range_move_to", "primary_cli_path": "sheet range move-to", "reviewed": true, "risk": "high", "title": "区域移动", "use_when": [ "把一个 range 移动到目标位置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "读取工作表指定区域的单元格值", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入值用 sheet range update", "清空内容/格式用 sheet range clear 或 batch-clear", "读取 CSV 格式用 sheet csv-get" ], "canonical_path": "sheet.range_read", "cli_name": "read", "cli_path": "sheet range read", "confirmation": "not_required", "description": "读取钉钉电子表格中指定工作表的指定范围数据。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 range 指定读取的单元格范围。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。不传则默认读取第一个工作表。\r\nrange 使用 A1 表示法指定单元格范围，支持带工作表前缀（如 \u003csheetId\u003e!A1:D10）。不传则默认读取该工作表的全部数据。\r\n\r\n返回指定范围内的单元格值、公式、显示值等信息。\r\n其中 values 返回公式计算后的结果值，formulas 返回原始公式，displayValues 返回界面上的显示值。\r\n所有数据均以二维数组形式返回，第一维为行，第二维为列。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。\r\n\r\n支持的文档类型：钉钉在线电子表格。\r\n文档链接格式：https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\r\ndentryUuid 为 32 位字母数字字符串。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_range" }, "metadata_source": "embedded-mcp-metadata", "name": "range_read", "primary_cli_path": "sheet range read", "reviewed": true, "risk": "low", "title": "读取工作表数据", "use_when": [ "读取某个 range 的数据或值" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "设置单个区域的单元格样式", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入单元格值用 sheet range update", "批量设置多个区域样式用 sheet range batch-set-style", "条件高亮用 sheet cond-format create/update" ], "canonical_path": "sheet.range_set_style", "cli_name": "set-style", "cli_path": "sheet range set-style", "confirmation": "not_required", "description": "对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值、超链接、数字格式等内容。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "update_range" }, "metadata_source": "embedded-mcp-metadata", "name": "range_set_style", "primary_cli_path": "sheet range set-style", "reviewed": true, "risk": "medium", "title": "更新表格指定区域内容", "use_when": [ "设置一个 range 的字体、颜色、对齐、数字格式等样式" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "写入或更新工作表指定区域的单元格值/超链接", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "只改样式用 sheet range set-style 或 batch-set-style", "只读数据用 sheet range read", "清空区域用 sheet range clear" ], "canonical_path": "sheet.range_update", "cli_name": "update", "cli_path": "sheet range update", "confirmation": "not_required", "description": "对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值、超链接、数字格式等内容。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "update_range" }, "metadata_source": "embedded-mcp-metadata", "name": "range_update", "primary_cli_path": "sheet range update", "reviewed": true, "risk": "medium", "title": "更新表格指定区域内容", "use_when": [ "向指定 range 写入二维数组值或超链接" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在钉钉表格的指定工作表中，全局查找并替换文本内容。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉表格的指定工作表中，全局查找并替换文本内容。”所述变更时不要使用" ], "canonical_path": "sheet.replace_all", "cli_name": "replace", "cli_path": "sheet replace", "confirmation": "not_required", "description": "在钉钉表格的指定工作表中，全局查找并替换文本内容。\r\n\r\n支持以下替换选项：\r\n- matchCase：是否区分大小写（默认 false）\r\n- matchEntireCell：是否完整单元格匹配（默认 false）\r\n- useRegExp：是否使用正则表达式（默认 false）\r\n- includeHidden：是否包含隐藏行/列（默认 false）\r\n- range：限定替换范围，使用 A1 表示法（如 A1:D100），不传时在整个工作表中替换\r\n\r\n返回被替换的单元格数量。\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 filterViewId 定位筛选视图，通过 column 指定目标列。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\nfilterViewId 可通过 get_filter_views 获取。\r\n\r\n清除指定列的筛选条件后，该列不再参与筛选视图的筛选计算。\r\n此操作仅清除指定列的条件，不会删除整个筛选视图。如需删除整个筛选视图，请使用 delete_filter_view。\r\n清除操作仅影响当前筛选视图，不影响全局筛选或其他筛选视图。\r\n\r\n如果指定列没有设置筛选条件，调用此接口不会报错。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可操作。不支持跨组织操作。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "replace_all", "primary_cli_path": "sheet replace", "reviewed": false, "risk": "medium", "title": "全局查找替换", "use_when": [ "替换/查找替换/全局替换/批量替换/把A替换成B/把所有的X改成Y；删除匹配内容", "替换/查找替换/全局替换/批量替换/把A替换成B/把所有的X改成Y；查找替换", "替换/查找替换/全局替换/批量替换/把A替换成B/把所有的X改成Y；正则替换", "替换/查找替换/全局替换/批量替换/把A替换成B/把所有的X改成Y；精确匹配后替换（只替换内容完全等于的单元格）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "设置单元格下拉列表配置", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除下拉配置用 sheet delete-dropdown", "只查询下拉配置用 sheet get-dropdown", "设置条件格式用 sheet cond-format create" ], "canonical_path": "sheet.set_dropdown_lists", "cli_name": "set-dropdown", "cli_path": "sheet set-dropdown", "confirmation": "not_required", "description": "在钉钉表格的指定单元格范围内设置下拉列表。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "set_dropdown_lists", "primary_cli_path": "sheet set-dropdown", "reviewed": true, "risk": "medium", "title": "设置下拉列表", "use_when": [ "给指定范围配置下拉选项" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将 CSV 文本写入工作表指定起点", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入 JSON 二维数组用 sheet range update", "只改样式用 sheet range set-style", "读取 CSV 用 sheet csv-get" ], "canonical_path": "sheet.set_range_from_csv", "cli_name": "csv-put", "cli_path": "sheet csv-put", "confirmation": "not_required", "description": "将 RFC 4180 格式的 CSV 文本写入指定工作表的指定单元格位置。\r\n\r\n只写纯值，不支持公式/样式/批注。=开头的内容当作文本处理，不会被解析为公式。\r\n自动扩容行列：当 CSV 数据超出当前工作表维度时，自动追加行/列。\r\n目标区域如含合并单元格，合并将被打散，值正常写入。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "set_range_from_csv", "primary_cli_path": "sheet csv-put", "reviewed": true, "risk": "medium", "title": "写入 CSV 数据到指定区域", "use_when": [ "把 CSV 文本导入到 sheet 指定位置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "对基础筛选范围内数据排序", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "仅更新筛选条件用 sheet filter update", "筛选视图排序/条件请使用 sheet filter-view update", "读取数据排序结果用 sheet range read" ], "canonical_path": "sheet.sort_filter", "cli_name": "sort", "cli_path": "sheet filter sort", "confirmation": "not_required", "description": "对钉钉电子表格中指定工作表的筛选范围内的数据进行排序。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n排序基于筛选范围内的指定列，支持升序和降序。\r\n排序会实际改变工作表中数据行的物理顺序。\r\n\r\n使用此接口前，工作表必须已创建筛选（通过 create_filter 创建）。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可操作。不支持跨组织操作。", "effect": "read", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "sort_filter", "primary_cli_path": "sheet filter sort", "reviewed": true, "risk": "medium", "title": "筛选排序", "use_when": [ "在普通筛选范围内设置排序" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "对钉钉电子表格中指定工作表指定范围的数据进行排序。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“基于源数据范围自动填充到目标范围”请改用 dws sheet range fill", "要“对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值”请改用 dws sheet range batch-set-style", "要“清除钉钉电子表格中指定工作表指定范围的单元格内容、格式或全部”请改用 dws sheet range clear" ], "canonical_path": "sheet.sort_range", "cli_name": "sort", "cli_path": "sheet range sort", "confirmation": "not_required", "description": "对钉钉电子表格中指定工作表指定范围的数据进行排序。支持多级排序（按 sortKeys 数组顺序优先级递减）。column 使用字母列名（如 \"A\"、\"B\"、\"AA\"）。如果数据首行为表头，可设置跳过首行不参与排序。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "sort_range", "primary_cli_path": "sheet range sort", "reviewed": false, "risk": "medium", "title": "区域排序", "use_when": [ "排序/给数据排序/按某列排序/升序/降序；区域排序" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "用于将钉钉在线表格导出为 xlsx。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“用于将钉钉在线表格导出为 xlsx。”" ], "canonical_path": "sheet.submit_export_job", "cli_name": "export", "cli_path": "sheet export", "confirmation": "not_required", "description": "用于将钉钉在线表格导出为 xlsx。导出为异步操作，提交后需使用 query_export_job 轮询任务状态并获取下载链接。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "submit_export_job", "primary_cli_path": "sheet export", "reviewed": false, "risk": "low", "title": "导出钉钉表格", "use_when": [ "--output 为目录时，自动按下载链接中的文件名保存", "仅导出，返回 downloadUrl（链接有时效性，请尽快下载）", "场景 A：仅获取下载链接（命令内部自动完成提交+轮询，最终返回 downloadUrl）", "场景 B：导出并自动下载为本地文件", "场景 C：下载到目录，自动按链接推断文件名", "导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；导出表格", "导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；需要落盘到本地", "导出并自动下载为本地文件", "把这个在线表格导出为 xlsx 文件；在线表格格式转换" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "使用指定模板创建新表格文档", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要使用指定模板创建新表格文档时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.template_apply", "cli_name": "apply", "cli_path": "sheet template apply", "confirmation": "not_required", "description": "使用指定模板创建新表格文档。", "effect": "write", "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "template_apply", "primary_cli_path": "sheet template apply", "reviewed": false, "risk": "medium", "title": "应用表格模板", "use_when": [ "使用指定模板创建新表格文档" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取当前用户可用的表格模板列表，支持按来源筛选", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要获取当前用户可用的表格模板列表，支持按来源筛选时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.template_list", "cli_name": "list", "cli_path": "sheet template list", "confirmation": "not_required", "description": "获取当前用户可用的表格模板列表，支持按来源筛选。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "template_list", "primary_cli_path": "sheet template list", "reviewed": false, "risk": "low", "title": "获取表格模板列表", "use_when": [ "获取当前用户可用的表格模板列表，支持按来源筛选" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据关键词搜索表格模板", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要根据关键词搜索表格模板时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.template_search", "cli_name": "search", "cli_path": "sheet template search", "confirmation": "not_required", "description": "根据关键词搜索表格模板。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "template_search", "primary_cli_path": "sheet template search", "reviewed": false, "risk": "low", "title": "搜索表格模板", "use_when": [ "根据关键词搜索表格模板" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "取消钉钉表格指定工作表中的连续整行或整列分组", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要取消钉钉表格指定工作表中的连续整行或整列分组时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.ungroup_dimension", "cli_name": "ungroup-dimension", "cli_path": "sheet ungroup-dimension", "confirmation": "not_required", "description": "取消钉钉表格指定工作表中的连续整行或整列分组。\n\n--range 使用整行/整列范围：\n 行分组：3:7 或 3\n 列分组：C:F 或 C\n\n支持在 --range 中携带工作表前缀（如 \"Sheet1!3:7\" / \"Sheet1!C:F\"），此时将忽略 --sheet-id。\n取消后可通过 sheet info --include groups 回读 rowGroups / columnGroups。", "effect": "read", "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "name": "ungroup_dimension", "primary_cli_path": "sheet ungroup-dimension", "reviewed": false, "risk": "low", "title": "取消指定连续行/列分组", "use_when": [ "创建行分组/创建列分组/折叠几行/折叠几列/取消行列分组；取消分组", "创建行分组/创建列分组/折叠几行/折叠几列/展开行列分组/取消行列分组；取消分组" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "取消钉钉表格指定工作表中指定范围内的合并单元格。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“取消钉钉表格指定工作表中指定范围内的合并单元格。”所述变更时不要使用" ], "canonical_path": "sheet.unmerge_range", "cli_name": "unmerge-cells", "cli_path": "sheet unmerge-cells", "confirmation": "not_required", "description": "取消钉钉表格指定工作表中指定范围内的合并单元格。\r\n\r\n通过 rangeAddress 参数指定要取消合并的范围，使用 A1 表示法（如 A1:D5）。\r\n该范围内所有合并的单元格都会被取消合并，恢复为独立的单元格。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "unmerge_range", "primary_cli_path": "sheet unmerge-cells", "reviewed": false, "risk": "medium", "title": "取消合并单元格", "use_when": [ "取消合并/拆分单元格/还原合并；取消合并单元格" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新条件格式规则", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除规则用 sheet cond-format delete", "新建规则用 sheet cond-format create", "静态设置样式用 sheet range set-style" ], "canonical_path": "sheet.update_cond_format", "cli_name": "update", "cli_path": "sheet cond-format update", "confirmation": "not_required", "description": "更新指定工作表中的一条条件格式规则。未传入的字段将保持原有值不变。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_cond_format", "primary_cli_path": "sheet cond-format update", "reviewed": true, "risk": "medium", "title": "更新条件格式规则", "use_when": [ "修改已有条件格式规则" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "批量更新钉钉表格指定工作表中连续多行/多列的属性，支持设置显隐状态（hidden）与行高/列宽（pixelSize）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“批量更新钉钉表格指定工作表中连续多行/多列的属性，支持设置显隐状态（hidden）与行高/列宽（pixelSize）。”所述变更时不要使用" ], "canonical_path": "sheet.update_dimension", "cli_name": "update-dimension", "cli_path": "sheet update-dimension", "confirmation": "not_required", "description": "批量更新钉钉表格指定工作表中连续多行/多列的属性，支持设置显隐状态（hidden）与行高/列宽（pixelSize）。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_dimension", "primary_cli_path": "sheet update-dimension", "reviewed": false, "risk": "medium", "title": "更新行列属性", "use_when": [ "2. 隐藏第 3~4 行", "3. 显示 A~B 列", "4. 设置第 1~5 行行高为 40px", "5. 设置 C 列列宽为 200px 并隐藏", "使用工作表前缀（忽略 --sheet-id）", "显示 A~B 列", "设置 C 列列宽为 200px 并隐藏", "设置第 1~5 行行高为 40px", "隐藏第 3~4 行", "隐藏行/隐藏列/显示行/显示列/设置行高/设置列宽/调整行高/调整列宽/行列属性；同时修改尺寸与显隐", "隐藏行/隐藏列/显示行/显示列/设置行高/设置列宽/调整行高/调整列宽/行列属性；设置行高/列宽", "隐藏行/隐藏列/显示行/显示列/设置行高/设置列宽/调整行高/调整列宽/行列属性；隐藏/显示行或列" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新工作表基础筛选条件", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "仅排序筛选范围用 sheet filter sort", "清除某列筛选条件用 sheet filter clear-criteria", "管理筛选视图条件用 sheet filter-view update-criteria" ], "canonical_path": "sheet.update_filter", "cli_name": "update", "cli_path": "sheet filter update", "confirmation": "not_required", "description": "批量更新钉钉电子表格中指定工作表的筛选条件。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n可同时更新多列的筛选条件，支持三种筛选类型：\r\n- 按值筛选（filterType: values）：指定允许显示的值列表，未在列表中的值将被隐藏\r\n- 按条件筛选（filterType: condition）：指定条件运算符和比较值\r\n- 按颜色筛选（filterType: color）：按单元格背景色或字体颜色筛选\r\n\r\n使用此接口前，工作表必须已创建筛选（通过 create_filter 创建）。\r\n此接口会替换指定列的现有筛选条件，未指定的列保持不变。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可操作。不支持跨组织操作。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_filter", "primary_cli_path": "sheet filter update", "reviewed": true, "risk": "medium", "title": "更新筛选", "use_when": [ "批量设置普通筛选的筛选条件" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新筛选视图属性和范围", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "创建新筛选视图用 sheet filter-view create", "删除筛选视图用 sheet filter-view delete", "只改某列筛选条件用 sheet filter-view update-criteria" ], "canonical_path": "sheet.update_filter_view", "cli_name": "update", "cli_path": "sheet filter-view update", "confirmation": "not_required", "description": "更新钉钉电子表格中指定工作表的筛选视图属性（名称、范围和/或筛选条件）。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 filterViewId 定位筛选视图。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\nfilterViewId 可通过 get_filter_views 获取。\r\n\r\n可更新筛选视图的名称、范围和筛选条件，至少需要传入一个更新字段。\r\n通过 criteria 参数可直接批量更新多列的筛选条件，指定列的条件会被替换，未指定的列保持不变。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可操作。不支持跨组织操作。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_filter_view", "primary_cli_path": "sheet filter-view update", "reviewed": true, "risk": "medium", "title": "更新筛选视图", "use_when": [ "修改筛选视图名称、范围或整体配置" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新钉钉电子表格中指定浮动图片的属性。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新钉钉电子表格中指定浮动图片的属性。”所述变更时不要使用" ], "canonical_path": "sheet.update_float_image", "cli_name": "update-float-image", "cli_path": "sheet update-float-image", "confirmation": "not_required", "description": "更新钉钉电子表格中指定浮动图片的属性。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_float_image", "primary_cli_path": "sheet update-float-image", "reviewed": false, "risk": "medium", "title": "更新浮动图片", "use_when": [ "替换图片（需先 media-upload 新图片获取 resourceUrl）", "移动浮动图片/调整浮动图片大小/修改浮动图片/更新浮动图片；更新浮动图片属性", "移动浮动图片到新位置", "调整尺寸" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "更新钉钉电子表格中指定工作表的属性，包括名称、位置、可见性、冻结行列等。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新钉钉电子表格中指定工作表的属性，包括名称、位置、可见性、冻结行列等。”所述变更时不要使用" ], "canonical_path": "sheet.update_sheet", "cli_name": "update", "cli_path": "sheet update", "confirmation": "not_required", "description": "更新钉钉电子表格中指定工作表的属性，包括名称、位置、可见性、冻结行列等。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_sheet", "primary_cli_path": "sheet update", "reviewed": false, "risk": "medium", "title": "更新工作表属性", "use_when": [ "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；冻结行列", "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；取消冻结", "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；显示工作表", "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；更新工作表属性", "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；移动工作表位置", "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；重命名工作表", "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；隐藏工作表", "取消冻结", "改名 + 调整冻结", "显示工作表", "移动工作表到第一个位置", "隐藏工作表" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在钉钉表格的指定单元格中插入图片。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉表格的指定单元格中插入图片。”所述变更时不要使用" ], "canonical_path": "sheet.write_image", "cli_name": "write-image", "cli_path": "sheet write-image", "confirmation": "not_required", "description": "在钉钉表格的指定单元格中插入图片。\r\n\r\n通过 nodeId 定位表格文件，通过 sheetId 和 rangeAddress 定位目标单元格区域，\r\n将图片资源写入到指定位置。图片资源需要先获取 resourceId 和 resourceUrl。\r\n\r\n使用流程：\r\n1. 先获取上传凭证（uploadUrl、resourceId、resourceUrl）\r\n2. 使用 HTTP PUT 请求将图片文件上传到 uploadUrl\r\n3. 调用本接口，传入 resourceId 和 resourceUrl，在指定单元格中插入图片", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "write_image", "primary_cli_path": "sheet write-image", "reviewed": false, "risk": "medium", "title": "单元格写入图片", "use_when": [ "1. 基本用法: 写入图片到指定单元格", "2. 指定显示尺寸", "3. 自定义图片名称", "写入图片/插入图片/加图片/放图片到单元格/嵌入图片到表格；写入图片", "写入图片/插入图片/加图片/放图片到单元格/嵌入图片到表格；用户指定了图片尺寸", "提取 nodeId 后:" ] } ], "use_when": [ "创建一个电子表格；创建表格文档", "在线电子表格/钉钉表格/axls/工作表/单元格读写/合并单元格/筛选视图/导出 xlsx", "帮我读一下表格 A1:D10 的数据；读取单元格数据" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.todo.prod.json", "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/schema-hints/imported/wukong.json" ], "agent_summary": "待办任务管理", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "avoid_when": [ "给自己留一个明天下午的时间块/建个个人日程；创建个人日程" ], "description": "待办任务管理", "id": "todo", "name": "待办任务管理", "runtime": true, "tool_count": 17, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "添加待办执行人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办提醒”请改用 dws todo task add-reminder" ], "canonical_path": "todo.add_task_executors", "cli_name": "add-executor", "cli_path": "todo task add-executor", "confirmation": "not_required", "description": "添加待办执行人", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "add_task_executors", "primary_cli_path": "todo task add-executor", "reviewed": false, "risk": "medium", "title": "add_task_executors", "use_when": [ "10. 添加待办执行人", "加个执行人/添加执行者" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "添加待办参与人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办执行人”请改用 dws todo task add-executor", "要“添加待办提醒”请改用 dws todo task add-reminder" ], "canonical_path": "todo.add_task_participants", "cli_name": "add-participant", "cli_path": "todo task add-participant", "confirmation": "not_required", "description": "添加待办参与人", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "add_task_participants", "primary_cli_path": "todo task add-participant", "reviewed": false, "risk": "medium", "title": "add_task_participants", "use_when": [ "12. 添加待办参与人", "加个参与人/添加参与者" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "添加待办任务附件", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor", "要“添加待办提醒”请改用 dws todo task add-reminder" ], "canonical_path": "todo.add_todo_attachment", "cli_name": "add-attachment", "cli_path": "todo task add-attachment", "confirmation": "not_required", "description": "添加待办任务附件", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "add_todo_attachment", "primary_cli_path": "todo task add-attachment", "reviewed": false, "risk": "medium", "use_when": [ "18. 上传附件（真实上传，先确认待办存在）— 从返回 result.attachmentIds 取 attachmentId" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "给待办添加评论", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除待办的评论”请改用 dws todo comment delete", "要“获取待办的评论”请改用 dws todo comment list" ], "canonical_path": "todo.add_todo_comment", "cli_name": "add", "cli_path": "todo comment add", "confirmation": "not_required", "description": "给待办添加评论", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "add_todo_comment", "primary_cli_path": "todo comment add", "reviewed": false, "risk": "medium", "title": "add_todo_comment", "use_when": [ "7. 给待办新增评论", "给待办加条评论/留个备注" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "添加待办提醒", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.add_todo_reminder", "cli_name": "add-reminder", "cli_path": "todo task add-reminder", "confirmation": "not_required", "description": "添加待办提醒", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "add_todo_reminder", "primary_cli_path": "todo task add-reminder", "reviewed": false, "risk": "medium", "title": "add_todo_reminder", "use_when": [ "14. 添加待办提醒（基于截止时间偏移，待办必须有截止时间）", "15. 添加待办提醒（自定义时间戳）", "给待办加个提醒/设置提醒" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在当前企业组织内创建一条个人待办的子待办事项（要求父待办必须是操作者本人创建），支持设置标题、执行人列表、截止时间、优先级（如高/中/低）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.create_personal_sub_todo", "cli_name": "create-sub", "cli_path": "todo task create-sub", "confirmation": "not_required", "description": "在当前企业组织内创建一条个人待办的子待办事项（要求父待办必须是操作者本人创建），支持设置标题、执行人列表、截止时间、优先级（如高/中/低）。待办将归属于当前用户，并对有权限的协作者可见。子待办不支持设置单独的循环规则（遵循父待办的循环规则）。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_personal_sub_todo", "primary_cli_path": "todo task create-sub", "reviewed": false, "risk": "medium", "title": "create_personal_sub_todo", "use_when": [ "1c. 创建子待办（需先获取父待办 ID）", "加个子任务/创建子待办" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建待办", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.create_personal_todo", "cli_name": "create", "cli_path": "todo task create", "confirmation": "not_required", "description": "在当前企业组织内创建一条个人待办事项，支持设置标题、执行人列表（UserId）、截止时间、优先级（如高/中/低）。待办将归属于当前用户，并对有权限的协作者可见。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "create_personal_todo" }, "metadata_source": "embedded-mcp-metadata", "name": "create_personal_todo", "primary_cli_path": "todo task create", "risk": "medium", "title": "创建个人待办", "use_when": [ "1. 创建待办 — 从返回 result.taskId 提取任务 ID", "1b. 创建按天循环的待办（必须先有 --due；recurrence 与 MCP create_personal_todo 一致）", "加个待办/记一下/TODO", "每天重复/循环待办/按天重复" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除待办", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.delete_todo", "cli_name": "delete", "cli_path": "todo task delete", "confirmation": "user_required", "description": "删除待办（所有执行者都删除）", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "delete_todo" }, "metadata_source": "embedded-mcp-metadata", "name": "delete_todo", "primary_cli_path": "todo task delete", "risk": "high", "title": "delete_todo", "use_when": [ "6. 删除待办", "删除待办/取消待办" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "删除待办的评论", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“给待办添加评论”请改用 dws todo comment add", "要“获取待办的评论”请改用 dws todo comment list" ], "canonical_path": "todo.delete_todo_comment", "cli_name": "delete", "cli_path": "todo comment delete", "confirmation": "user_required", "description": "删除待办的评论", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "delete_todo_comment", "primary_cli_path": "todo comment delete", "reviewed": false, "risk": "high", "title": "delete_todo_comment", "use_when": [ "9. 删除待办评论", "删除这条评论" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "待办详情", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.get_todo_detail", "cli_name": "get", "cli_path": "todo task get", "confirmation": "not_required", "description": "查询待办详情，用户必须是待办的创建者或者执行者才有权限查看。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "get_todo_detail" }, "metadata_source": "embedded-mcp-metadata", "name": "get_todo_detail", "primary_cli_path": "todo task get", "risk": "low", "title": "带鉴权的查询待办详情", "use_when": [ "3. 查看待办详情", "看看待办详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取当前用户在所属组织中的个人待办事项列表，返回每项待办的标题、截止日期、优先级（如高/中/低）、完成状态。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.get_user_todos_in_current_org", "cli_name": "list", "cli_path": "todo task list", "confirmation": "not_required", "description": "获取当前用户在所属组织中的个人待办事项列表，返回每项待办的标题、截止日期、优先级（如高/中/低）、完成状态。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_user_todos_in_current_org", "primary_cli_path": "todo task list", "reviewed": false, "risk": "low", "title": "get_user_todos_in_current_org", "use_when": [ "2. 查看未完成待办", "看看待办/我有啥要做" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取待办的评论", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除待办的评论”请改用 dws todo comment delete", "要“给待办添加评论”请改用 dws todo comment add" ], "canonical_path": "todo.list_todo_comment", "cli_name": "list", "cli_path": "todo comment list", "confirmation": "not_required", "description": "获取待办的评论", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_todo_comment", "primary_cli_path": "todo comment list", "reviewed": false, "risk": "low", "title": "list_todo_comment", "use_when": [ "8. 查看待办评论列表", "看看这个待办的评论" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "移除待办执行人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.remove_task_executors", "cli_name": "remove-executor", "cli_path": "todo task remove-executor", "confirmation": "user_required", "description": "移除待办执行人", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "remove_task_executors", "primary_cli_path": "todo task remove-executor", "reviewed": false, "risk": "high", "title": "remove_task_executors", "use_when": [ "11. 移除待办执行人", "移除执行人/删除执行者" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "移除待办参与人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.remove_task_participants", "cli_name": "remove-participant", "cli_path": "todo task remove-participant", "confirmation": "user_required", "description": "移除待办参与人", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "remove_task_participants", "primary_cli_path": "todo task remove-participant", "reviewed": false, "risk": "high", "title": "remove_task_participants", "use_when": [ "13. 移除待办参与人", "移除参与人/删除参与者" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "重置待办提醒", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.reset_todo_reminder", "cli_name": "reset-reminder", "cli_path": "todo task reset-reminder", "confirmation": "not_required", "description": "重置待办提醒", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "reset_todo_reminder", "primary_cli_path": "todo task reset-reminder", "reviewed": false, "risk": "medium", "title": "reset_todo_reminder", "use_when": [ "16. 重置待办提醒", "17. 重置待办提醒（指定新规则）", "重置提醒/清除提醒/修改提醒规则" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "修改执行者的待办完成状态", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.update_todo_done_status", "cli_name": "done", "cli_path": "todo task done", "confirmation": "not_required", "description": "修改执行者的待办完成状态", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "update_todo_done_status" }, "metadata_source": "embedded-mcp-metadata", "name": "update_todo_done_status", "primary_cli_path": "todo task done", "risk": "medium", "use_when": [ "5. 标记待办完成", "做完了/完成待办/标记完成" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "修改待办任务", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.update_todo_task", "cli_name": "update", "cli_path": "todo task update", "confirmation": "not_required", "description": "修改整个待办任务", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "update_todo_task" }, "metadata_source": "embedded-mcp-metadata", "name": "update_todo_task", "primary_cli_path": "todo task update", "risk": "medium", "use_when": [ "4. 修改待办信息", "改个待办/修改待办标题/改优先级" ] } ], "use_when": [ "帮我创建一个待办提醒；个人待办", "帮我记一下明天要做的事；创建个人待办", "待办/TODO/任务提醒/循环待办", "明早 9 点提醒我提交周报；创建个人待办，但需先声明 reminder 边界" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/SKILL.md", "skills/mono/schema-hints/catalog-completeness.json" ], "agent_summary": "管理钉钉知识库空间、节点、内容检索和知识库成员权限", "agent_summary_source": "dws-command-surface-review", "description": "知识库 / 空间管理 / 节点管理 / 成员管理", "id": "wiki", "name": "知识库 / 空间管理 / 节点管理 / 成员管理", "runtime": true, "tool_count": 15, "tools": [ { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "为知识库添加指定角色的成员。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“从知识库中移除指定的企业用户成员（仅支持 USER 类型）”请改用 dws wiki member remove", "要“修改成员在知识库中的角色”请改用 dws wiki member update", "要“查询知识库当前的成员权限列表，支持按角色过滤”请改用 dws wiki member list" ], "canonical_path": "wiki.add_member", "cli_name": "add", "cli_path": "wiki member add", "confirmation": "not_required", "description": "为知识库添加指定角色的成员。\r\n\r\n支持添加用户（USER）成员类型。\r\n添加成功后，被授权的成员即可按指定角色访问该知识库下的所有内容。\r\n\r\n适用场景：\r\n- 新员工入职，需要授予知识库访问权限。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口添加，知识库创建者默认为所有者。\r\n- 操作者需具备知识库的 OWNER 或 MANAGER 权限。\r\n- 单次请求最多传 30 个成员，超出需分批调用。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "add_member", "primary_cli_path": "wiki member add", "reviewed": false, "risk": "medium", "title": "添加知识库成员", "use_when": [ "2. 添加成员", "把知识库分享给某人/给某人加入知识库/邀请进知识库", "查看具体命令的完整参数说明" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表或文件夹）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等）”请改用 dws wiki node list", "要“将指定节点复制到目标文件夹”请改用 dws wiki node copy", "要“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将”请改用 dws wiki node delete" ], "canonical_path": "wiki.create_file", "cli_name": "create", "cli_path": "wiki node create", "confirmation": "not_required", "description": "在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表或文件夹）。\r\n\r\n支持三种创建位置（按优先级）：\r\n1. 指定 folderId：在该文件夹下创建\r\n2. 仅指定 workspaceId（不传 folderId）：在该知识库的根目录下创建\r\n3. 都不传：在用户\"我的文档\"根目录下创建\r\n4. type 要创建的文件类型，必填。支持以下值：adoc（钉钉在线文档）、axls（钉钉表格）、appt（钉钉演示）、adraw（钉钉白板）、amind（钉钉脑图）、able（钉钉多维表）、folder（文件夹）\r\n操作受权限控制，仅当调用者对目标位置有写入权限时可成功创建。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "create_file" }, "metadata_source": "embedded-mcp-metadata", "name": "create_file", "primary_cli_path": "wiki node create", "reviewed": false, "risk": "medium", "title": "创建节点", "use_when": [ "1. 创建文档节点", "2. 创建文件夹", "3. 在指定文件夹下创建", "在知识库里创建一个文档；创建空文件实体", "在知识库里创建文档/新建文件夹" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "创建一个新的钉钉文档知识库（WikiSpace）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“将指定知识库移入回收站”请改用 dws wiki space delete", "要“获取当前用户有权访问的知识库列表，支持按类型区分”请改用 dws wiki space list", "要“获取指定知识库的详细信息，包括名称、描述、创建者、创建时间、成员”请改用 dws wiki space get" ], "canonical_path": "wiki.create_wikiSpace", "cli_name": "create", "cli_path": "wiki space create", "confirmation": "not_required", "description": "创建一个新的钉钉文档知识库（WikiSpace）。\r\n知识库是组织内文档的核心容器，可在其中创建文档、文件夹等内容。\r\n创建成功后返回新知识库的 workspaceId，可用于后续在该知识库下创建文档（create_document）或遍历文件（list_nodes）。\r\n操作受权限控制，仅当调用者具备在当前组织内创建知识库的权限时可成功创建。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "create_wikiSpace", "primary_cli_path": "wiki space create", "reviewed": false, "risk": "medium", "title": "创建知识库", "use_when": [ "创建知识库", "创建知识库/新建知识库" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等）”请改用 dws wiki node list", "要“在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表”请改用 dws wiki node create", "要“将指定节点复制到目标文件夹”请改用 dws wiki node copy" ], "canonical_path": "wiki.delete_document", "cli_name": "delete", "cli_path": "wiki node delete", "confirmation": "user_required", "description": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。\r\n\r\n支持范围：\r\n- 知识库（workspace）下的文档节点、文件夹节点\r\n- 钉盘「我的文件」或「团队空间（space）」下的文件、文件夹节点（但钉盘操作仍建议走钉盘MCP服务）\r\n\r\n不支持的操作：\r\n- 不支持直接删除知识库本身（workspace）\r\n- 不支持直接删除团队空间（space）\r\n\r\n权限要求：\r\n- 对目标节点有管理权限（owner 或被授予管理权限的成员）\r\n\r\n注意事项：\r\n- 删除操作不可立即撤销，请在调用前向用户确认\r\n- 删除文件夹时，文件夹内的所有子节点也会一并移入回收站", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "delete_document" }, "metadata_source": "embedded-mcp-metadata", "name": "delete_document", "primary_cli_path": "wiki node delete", "reviewed": false, "risk": "high", "title": "删除节点", "use_when": [ "删除知识库里的文档/节点", "删除节点（会要求确认）" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将指定知识库移入回收站。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个新的钉钉文档知识库（WikiSpace）”请改用 dws wiki space create", "要“获取当前用户有权访问的知识库列表，支持按类型区分”请改用 dws wiki space list", "要“获取指定知识库的详细信息，包括名称、描述、创建者、创建时间、成员”请改用 dws wiki space get" ], "canonical_path": "wiki.delete_wikiSpace", "cli_name": "delete", "cli_path": "wiki space delete", "confirmation": "user_required", "description": "将指定知识库移入回收站。\r\n\r\n通过 workspaceId 定位知识库，支持传入知识库 ID 或知识库 URL，系统自动识别。\r\n删除后知识库会进入回收站，可在回收站中恢复。\r\n\r\n知识库 URL 格式：https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview\r\nworkspaceId 为字母数字字符串。\r\n\r\n注意事项：\r\n- **权限要求**：操作者必须具备知识库的「所有者（OWNER）」角色。\r\n- 删除操作不可逆（从回收站恢复除外），请确认后再执行。\r\n- 不支持跨组织删除。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "delete_wikiSpace", "primary_cli_path": "wiki space delete", "reviewed": false, "risk": "high", "title": "删除知识库", "use_when": [ "2. 删除知识库", "删除知识库/移除知识库/把知识库删了" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取指定知识库的详细信息，包括名称、描述、创建者、创建时间、成员数量等。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个新的钉钉文档知识库（WikiSpace）”请改用 dws wiki space create", "要“将指定知识库移入回收站”请改用 dws wiki space delete", "要“获取当前用户有权访问的知识库列表，支持按类型区分”请改用 dws wiki space list" ], "canonical_path": "wiki.get_wikiSpace", "cli_name": "get", "cli_path": "wiki space get", "confirmation": "not_required", "description": "获取指定知识库的详细信息，包括名称、描述、创建者、创建时间、成员数量等。\r\n通过 workspaceId 定位知识库，支持传入知识库 ID 或知识库 URL，系统自动识别。\r\n知识库 URL 格式：https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overviewworkspaceId 为字母数字字符串。\r\n仅限用户对该知识库具备\"可阅读\"权限时可获取。不支持跨组织查询。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "get_wikiSpace", "primary_cli_path": "wiki space get", "reviewed": false, "risk": "low", "title": "获取知识库", "use_when": [ "1. 确认知识库信息", "查看具体命令的完整参数说明", "查看知识库/知识库详情", "查看知识库详情" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "查询知识库当前的成员权限列表，支持按角色过滤。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库添加指定角色的成员”请改用 dws wiki member add", "要“从知识库中移除指定的企业用户成员（仅支持 USER 类型）”请改用 dws wiki member remove", "要“修改成员在知识库中的角色”请改用 dws wiki member update" ], "canonical_path": "wiki.list_member", "cli_name": "list", "cli_path": "wiki member list", "confirmation": "not_required", "description": "查询知识库当前的成员权限列表，支持按角色过滤。\r\n\r\n适用场景：\r\n- 获取知识库成员角色列表。\r\n\r\n每条记录包含成员的类型、名称及其角色信息。\r\n\r\n注意：\r\n- 底层接口一次性返回全量成员，不支持服务端游标分页。\r\n- 出参中包含 totalCount（全量成员总数）和 truncated（是否被截断）。当 truncated=true 时，说明知识库实际成员数超过 maxResults，建议通过 filterRoleIds 收窄查询范围；若仍超出 maxResults 上限，请引导用户去前端管理界面查看完整列表。\r\n- ORG 类型授权不会出现在查询结果中。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_member", "primary_cli_path": "wiki member list", "reviewed": false, "risk": "low", "title": "查询知识库成员列表", "use_when": [ "1. 查看当前成员（只返回 name/role/type，拿不到 userId）", "3. 查看当前成员", "知识库有哪些成员/查看知识库成员" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等），支持分页。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表”请改用 dws wiki node create", "要“将指定节点复制到目标文件夹”请改用 dws wiki node copy", "要“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将”请改用 dws wiki node delete" ], "canonical_path": "wiki.list_nodes", "cli_name": "list", "cli_path": "wiki node list", "confirmation": "not_required", "description": "列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等），支持分页。\r\n\r\n返回结果基于当前 MCP 会话用户的可访问权限进行过滤。\r\n返回的节点列表包含多种类型：在线文档、文件夹、PDF、docx、表格、脑图、白板等。\r\n\r\n定位方式（按优先级）：\r\n1. 传 folderId：列出该文件夹下的直接子节点\r\n2. 仅传 workspaceId（不传 folderId）：列出该知识库根目录下的直接子节点\r\n3. 都不传：列出用户\"我的文档\"根目录下的直接子节点\r\n\r\n返回的 nodeId 可直接用于其他工具（如 get_document_content、update_document、create_document 等）。\r\n若 nodeType=folder 且 hasChildren=true，可将该 nodeId 作为 folderId 再次调用本工具进行递归遍历。\r\n若 contentType=alidoc，可调用 get_document_content(nodeId=nodeId) 获取文档内容。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_nodes" }, "metadata_source": "embedded-mcp-metadata", "name": "list_nodes", "primary_cli_path": "wiki node list", "reviewed": false, "risk": "low", "title": "列出指定文件夹或知识库下的直接子节点列表", "use_when": [ "2. 列出根目录节点", "3. 进入子目录", "帮我看看知识库里的文件；知识库节点列表", "知识库下的文件/知识库里有哪些文档/浏览知识库内容", "读某个知识库里的某篇文档" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "获取当前用户有权访问的知识库列表，支持按类型区分。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个新的钉钉文档知识库（WikiSpace）”请改用 dws wiki space create", "要“将指定知识库移入回收站”请改用 dws wiki space delete", "要“获取指定知识库的详细信息，包括名称、描述、创建者、创建时间、成员”请改用 dws wiki space get" ], "canonical_path": "wiki.list_wikiSpaces", "cli_name": "list", "cli_path": "wiki space list", "confirmation": "not_required", "description": "获取当前用户有权访问的知识库列表，支持按类型区分。\r\n\r\n通过 wikiSpaceType 参数控制返回范围：\r\n- myWikiSpace：返回当前用户的「我的文档」个人空间（固定返回 1 条，不支持分页）\r\n- orgWikiSpace（默认）：返回当前用户在组织内有权访问的知识库列表，支持分页\r\n\r\n返回结果包含知识库 ID、名称、描述、访问链接等信息。\r\n返回的 workspaceId 可直接用于其他工具（如 get_wikiSpace、create_document、list_nodes 等）。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "list_wikiSpaces", "primary_cli_path": "wiki space list", "reviewed": false, "risk": "low", "title": "获取知识库列表", "use_when": [ "1. 先确认知识库 ID（避免授权到「我的文档」）", "1. 获取知识库 ID", "列出我有权访问的组织知识库", "列出钉盘企业空间", "列出钉盘团队空间；列出钉盘空间", "列出钉盘空间/钉盘团队空间", "我的文档/个人空间", "我的知识库/知识库列表/有哪些知识库", "获取「我的文档」个人空间", "获取钉盘「我的文件」" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将指定节点复制到目标文件夹。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等）”请改用 dws wiki node list", "要“在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表”请改用 dws wiki node create", "要“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将”请改用 dws wiki node delete" ], "canonical_path": "wiki.node_copy", "cli_name": "copy", "cli_path": "wiki node copy", "confirmation": "not_required", "description": "将指定节点复制到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时复制到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有可查看下载权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：复制操作底层可能异步执行，异步时操作已提交但新节点 ID 无法立即返回，请稍后查看目标文件夹确认结果。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "copy_document" }, "metadata_source": "embedded-mcp-metadata", "name": "node_copy", "primary_cli_path": "wiki node copy", "reviewed": false, "risk": "medium", "title": "将指定节点复制到目标文件夹", "use_when": [ "复制知识库里的文档", "复制节点到另一个文件夹" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "将指定节点移动到目标文件夹。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等）”请改用 dws wiki node list", "要“在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表”请改用 dws wiki node create", "要“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将”请改用 dws wiki node delete" ], "canonical_path": "wiki.node_move", "cli_name": "move", "cli_path": "wiki node move", "confirmation": "not_required", "description": "将指定节点移动到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时移动到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有编辑权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：移动操作底层可能异步执行，异步时操作已提交但无法立即确认完成，请稍后查看目标文件夹确认结果。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "move_document" }, "metadata_source": "embedded-mcp-metadata", "name": "node_move", "primary_cli_path": "wiki node move", "reviewed": false, "risk": "medium", "title": "移动节点", "use_when": [ "移动知识库里的文档", "移动节点到另一个文件夹" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据关键词和多种过滤条件搜索当前用户有权限访问的文档列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等）”请改用 dws wiki node list", "要“在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表”请改用 dws wiki node create", "要“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将”请改用 dws wiki node delete" ], "canonical_path": "wiki.node_search", "cli_name": "search", "cli_path": "wiki node search", "confirmation": "not_required", "description": "根据关键词和多种过滤条件搜索当前用户有权限访问的文档列表。\r\n\r\n支持的过滤条件：\r\n- keyword：关键词匹配文档标题和内容\r\n- extensions：按文件扩展名精确过滤（pdf/docx/png 等）\r\n- createdTimeFrom / createdTimeTo：按创建时间范围过滤\r\n- visitedTimeFrom / visitedTimeTo：按访问时间范围过滤\r\n- creatorUserIds：按创建者用户 ID 过滤\r\n - editorUserIds：按编辑者用户 ID 过滤\r\n- mentionedUserIds：按文档中 @提及的用户 ID 过滤\r\n- workspaceIds：按知识库范围过滤（支持知识库 URL）\r\n\r\n支持分页获取结果。搜索范围为用户在当前组织内有权限访问的所有文档数据。\r\n所有过滤条件均为可选，不传则不过滤。多个条件同时传入时取交集", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "search_documents" }, "metadata_source": "embedded-mcp-metadata", "name": "node_search", "primary_cli_path": "wiki node search", "reviewed": false, "risk": "low", "title": "搜索文档", "use_when": [ "在指定知识库内搜索", "在知识库里搜文档/空间内搜索", "在知识库里搜方案；空间内搜索", "按文件类型过滤" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "从知识库中移除指定的企业用户成员（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库添加指定角色的成员”请改用 dws wiki member add", "要“修改成员在知识库中的角色”请改用 dws wiki member update", "要“查询知识库当前的成员权限列表，支持按角色过滤”请改用 dws wiki member list" ], "canonical_path": "wiki.remove_member", "cli_name": "remove", "cli_path": "wiki member remove", "confirmation": "user_required", "description": "从知识库中移除指定的企业用户成员（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量移除知识库成员，移除后相关用户将无法访问该知识库下的内容（除非通过节点级权限另行授权）。\r\n\r\n适用场景：\r\n- 员工离职或转岗，需要撤销知识库访问权限。\r\n- 清理不再需要访问知识库的历史成员。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口移除。\r\n- **权限要求**：操作者必须具备知识库的「可管理（MANAGER）」及以上角色（OWNER 或 MANAGER）。EDITOR / DOWNLOADER / READER / 非成员调用会返回 `forbidden.accessDenied`，错误信息会明确提示所需的最低角色。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。", "effect": "destructive", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "remove_member", "primary_cli_path": "wiki member remove", "reviewed": false, "risk": "high", "title": "移除知识库成员", "use_when": [ "3. 移除成员", "移除知识库成员/把某人从知识库移除/删除知识库成员" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "根据关键词搜索当前用户有权限访问的知识库列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个新的钉钉文档知识库（WikiSpace）”请改用 dws wiki space create", "要“将指定知识库移入回收站”请改用 dws wiki space delete", "要“获取指定知识库的详细信息，包括名称、描述、创建者、创建时间、成员”请改用 dws wiki space get" ], "canonical_path": "wiki.search_wikiSpaces", "cli_name": "search", "cli_path": "wiki space search", "confirmation": "not_required", "description": "根据关键词搜索当前用户有权限访问的知识库列表。\r\n返回匹配的知识库列表，包括知识库 ID、名称、描述和访问链接。\r\n搜索范围为用户在当前组织内有权限访问的所有知识库。", "effect": "read", "idempotency": "idempotent", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "search_wikiSpaces", "primary_cli_path": "wiki space search", "reviewed": false, "risk": "low", "title": "搜索知识库", "use_when": [ "搜索知识库", "搜索知识库/找知识库" ] }, { "agent_metadata_source": "embedded-skill-metadata", "agent_summary": "修改成员在知识库中的角色。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库添加指定角色的成员”请改用 dws wiki member add", "要“从知识库中移除指定的企业用户成员（仅支持 USER 类型）”请改用 dws wiki member remove", "要“查询知识库当前的成员权限列表，支持按角色过滤”请改用 dws wiki member list" ], "canonical_path": "wiki.update_member", "cli_name": "update", "cli_path": "wiki member update", "confirmation": "not_required", "description": "修改成员在知识库中的角色。\r\n\r\n同一成员在同一知识库只能拥有一个角色，变更后旧角色自动替换。\r\n\r\n支持变更用户（USER）角色。\r\n\r\n适用场景：\r\n- 成员晋升为管理员，需要提升其知识库权限。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口变更。\r\n- 当前 Agent 调用场景下，**暂不支持 CONVERSATION（群会话）和 DEPT（部门）类型**。\r\n- 操作者需具备知识库的 OWNER 或 MANAGER 权限。", "effect": "write", "idempotency": "unknown", "interface_mode": "mcp", "metadata_source": "embedded-mcp-metadata", "name": "update_member", "primary_cli_path": "wiki member update", "reviewed": false, "risk": "medium", "title": "修改知识库成员角色", "use_when": [ "修改某人在知识库的权限/调整成员角色" ] } ], "use_when": [ "创建知识库/知识库列表/搜索知识库空间/wiki/团队空间/知识库成员管理/我的文档个人空间" ] } ], "source": "embedded-command-catalog", "tool_count": 538 }, "tools": { "aisearch.enterprise_person_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aisearch.enterprise_person_search", "skills/mono/references/intent-guide.md", "skills/mono/references/products/aisearch.md", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "企业内找人搜索工具，支持按姓名、部门、职位、技能、工作职责等多维度搜索企业内人员。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“企业内找人搜索工具，支持按姓名、部门、职位、技能、工作职责等多维度搜索企业内人员。”" ], "canonical_path": "aisearch.enterprise_person_search", "cli_name": "person", "cli_path": "aisearch person", "confirmation": "not_required", "description": "企业内找人搜索工具，支持按姓名、部门、职位、技能、工作职责等多维度搜索企业内人员。\\n\\n**适用场景示例**：\\n- 找一下负责智能化的人\\n- 帮我找产品经理\\n- 技术部有哪些人\\n- 张三的领导是谁\\n- 李四手下有哪些人\\n- 帮我找下王芳\\n- 谁在做大模型相关的工作\\n- 公司有哪些架构师\\n- 市场部的同事有谁\\n- 有没有会Java的同事\\n- 研发部的负责人是谁\\n- 帮我找一下跟智能客服有关的人\\n- 做设计的同事有谁\\n- 谁是技术总监\\n- 张三在哪个部门\\n\\n", "display": "AI 搜问", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aisearch person --keyword \"张三\" --dimension name --format json", "dws aisearch person --keyword \"产品部\" --dimension department --format json" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aisearch", "rpc_name": "enterprise_person_search" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "enterprise_person_search", "parameter_count": 2, "parameters": { "dimension": { "default": "all", "description": "查询维度: all/name/department/position/duty/supervisor/subordinate/phone/jobNumber，多个用逗号分隔", "interface_description": "查询维度，根据用户意图自动映射。可选值：\\n- all: 默认，全部维度\\n- name: 姓名（用户提到'姓名'、'叫什么'、'是谁'时使用）\\n- department: 部门（用户提到'部门'、'团队'时使用）\\n- position: 职位（用户提到'职位'、'岗位'时使用）\\n- duty: 职责/技能（用户提到'负责'、'职责'、'技能'时使用）\\n- supervisor: 上级（用户提到'上级'、'领导'、'主管'时使用）\\n- subordinate: 下级（用户提到'下级'、'下属'时使用）\\n- phone: 手机号（用户提到'手机号'、'电话'、'手机'时使用）\\n- jobNumber: 工号（用户提到'工号'、'员工编号'时使用）\\n\\n【重要】：从用户问题中识别维度词并映射到此字段，不要将维度词放入keyword中。", "interface_type": "array", "property": "dimension", "required": false, "type": "string" }, "keyword": { "description": "搜索关键词 (必填，如人名、技能关键词等)", "interface_description": "搜索关键词。仅填入实际的搜索目标（人名、技能关键词等），不包含查询维度词。 【关键词提取规则】： 以下维度词必须从keyword中排除，改为映射到dimension： - '上级'、'领导'、'主管' → dimension: ['supervisor'] - '下级'、'下属'、'团队成员' → dimension: ['subordinate'] - '部门'、'团队'、'组织' → dimension: ['department'] - '职位'、'岗位'、'职级' → dimension: ['position'] - '职责'、'负责'、'技能' → dimension: ['duty'] - '姓名'、'叫什么' → dimension: ['name'] 【示例】： - 用户问'五道的上级是谁' → keyword: '五道', dimension: ['supervisor'] - 用户问'张三负责什么' → keyword: '张三', dimension: ['duty'] - 用户问'AI搜问的负责人是谁' → keyword: 'AI搜问', dimension: ['duty'] - 用户问'产品部有谁' → keyword: '产品部', dimension: ['department'] - 用户问'李四是哪个部门的' → keyword: '李四', dimension: ['department']- 用户问'手机号13800138000是谁' → keyword: '13800138000', dimension: ['phone']\\n- 用户问'工号A12345是谁' → keyword: 'A12345', dimension: ['jobNumber']", "property": "keyword", "required": true, "type": "string" } }, "path": "aisearch.enterprise_person_search", "primary_cli_path": "aisearch person", "product_id": "aisearch", "reviewed": false, "risk": "low", "source": "runtime:aisearch", "title": "enterprise_person_search", "use_when": [ "13800138000是谁/查手机号；按手机号搜人", "222020这个工号是谁/查工号；按工号搜人", "五道的上级是谁/谁负责XX/XX的下属有谁；AI语义搜人", "找一下张三/搜同事/找人；AI搜人(首选)", "搜人/找人/谁负责/上级是谁/哪个部门的人" ] }, "aisearch.search_enterprise": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aisearch.search_enterprise", "skills/mono/references/intent-guide.md", "skills/mono/references/products/aisearch.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "企业内部知识搜索工具。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“企业内部知识搜索工具。”" ], "canonical_path": "aisearch.search_enterprise", "cli_name": "enterprise", "cli_path": "aisearch enterprise", "confirmation": "not_required", "description": "企业内部知识搜索工具。用于检索企业内部的文档、消息、日程、会议纪要、工作日志、多维表、企业百科等知识内容，基于关键词语义匹配返回相关资料。支持自然语言时间表达式（如\"最近\"、\"上周\"、\"本季度\"）。适用场景：查找某个主题的资料、搜索包含特定关键词的文档、了解某项目/产品相关信息、准备汇报材料等内容检索需求。", "display": "AI 搜问", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aisearch enterprise --queries \"智能化方案\" --types document --format json", "dws aisearch enterprise --queries \"搜索问题\" --types im --time-range \"最近\" --format json" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aisearch", "rpc_name": "search_enterprise" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_enterprise", "parameter_count": 3, "parameters": { "queries": { "description": "内容关键词列表，多个用逗号分隔；汇总类场景可留空", "interface_description": "搜索关键词列表，只放**内容关键词**。 **排除规则**： - 时间信息 放到 timeRange 字段 - 类型关键词（日志/文档/消息/会议/日程/纪要等） 放到 searchTypes 字段 - 汇总类词汇（工作总结/日报总结/周报总结/月报总结） 不作为关键词，通过searchTypes=['all']触发全量搜索 示例： - '2025-12-06 ~ 2025-12-19工作总结' queries=[]（时间走timeRange，工作总结触发all类型） - '智能化方案' queries=['智能化方案']", "interface_type": "array", "property": "queries", "required": false, "type": "string" }, "time-range": { "description": "时间范围，仅当用户显式给出时间词时填写，如 今天/本周/9月/过去一周", "interface_description": "时间范围。**提取规则**：仅当用户query中**显式出现**时间词汇时才填写，否则**必须留空**。**可识别的时间词汇**：- 相对时间：今天、昨天、本周、上周、这周、本月、上个月、最近、近期- 具体时间：9月、10月份、Q3、本季度、上半年、2024年- 时间范围：过去一周、最近三天**重要**：不要根据语义推测时间。如果用户没有使用上述时间词汇，即使语境暗示是近期，也**不填写**此字段。**示例**：- '本周的OKR文档' → timeRange='本周'- '9月的项目方案' → timeRange='9月'- '智能化相关文档' → timeRange不填写（无时间词）,默认不填写", "property": "timeRange", "required": false, "type": "string" }, "types": { "default": "all", "description": "搜索类型: all/document/im/calendar/todo/minute/report/image/link/notable/baike/mail，多个用逗号分隔", "interface_description": "搜索类型列表，支持同时搜索多种类型。可选值：all-全部, document-文档, im-消息, calendar-日程, todo-待办, minute-会议纪要/闪记/听记, report-日志, image-图片, link-链接, notable-多维表/ai表格, baike-百科, mail-邮件。 **特殊规则**： 1. report类型仅在用户query中**显式且仅限出现'日志'**一词时触发，'周报/日报/月报/工作汇报'等不触发report 2. mail类型仅在用户query中**显式出现'邮件/邮箱/mail/email'**等词汇时触发 3. '工作总结'、'日报总结'、'周报总结'、'月报总结'等汇总类场景，需要聚合所有工作内容，应使用['all'] 示例： - '本周的日志' searchTypes=['report'] - '我收到的邮件' searchTypes=['mail'] - '工作总结' searchTypes=['all']（需汇总所有内容） - '周报总结' searchTypes=['all']（需汇总所有内容） - 不填或['all'] 搜索全部类型，默认是['all']", "interface_type": "array", "property": "searchTypes", "required": false, "type": "string" } }, "path": "aisearch.search_enterprise", "primary_cli_path": "aisearch enterprise", "product_id": "aisearch", "reviewed": false, "risk": "low", "source": "runtime:aisearch", "title": "search_enterprise", "use_when": [ "搜一下智能化方案/最近 OKR 相关邮件/最近发版相关消息；搜企业知识内容", "搜资料/找方案/查文档/搜企业知识/项目相关内容/工作总结/周报总结", "最近/本周/今天 + XX相关消息/文档/邮件有哪些" ] }, "aisearch.search_enterprise_behavior": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aisearch.search_enterprise_behavior", "skills/mono/references/intent-guide.md", "skills/mono/references/products/aisearch.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "业内部行为记录搜索工具。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“业内部行为记录搜索工具。”" ], "canonical_path": "aisearch.search_enterprise_behavior", "cli_name": "behavior", "cli_path": "aisearch behavior", "confirmation": "not_required", "description": "业内部行为记录搜索工具。用于检索用户的操作行为记录，如文档的发送、创建、分享、编辑等历史操作，支持按人员、动作类型进行精确查询。适用场景：\"我给某人发过什么\"、\"我创建过哪些文档\"、\"某人发给我的消息\"、\"我分享过的资料\"等行为追溯需求。与知识搜索的区别：本工具关注\"谁对什么做了什么\"，而非内容本身。", "display": "AI 搜问", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aisearch behavior --queries \"智能化方案\" --types document --format json", "dws aisearch behavior --types mail --behavior-type send --direction \"我-\u003e汐峰\" --format json" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aisearch", "rpc_name": "search_enterprise_behavior" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_enterprise_behavior", "parameter_count": 6, "parameters": { "behavior-type": { "default": "all", "description": "行为类型: all/send/create/share/edit/receive", "enum": [ "all", "send", "create", "share", "edit", "receive" ], "interface_description": "行为类型（可选）：all-全部, send-发送, create-创建, share-分享, edit-编辑, receive-接收", "property": "behaviorType", "required": false, "type": "string" }, "chat-scope": { "description": "消息所在会话/群范围，仅 IM 类型且用户明确指定群名时填写", "interface_description": "消息所在的会话/群范围（可选），仅用于IM类型搜索。当用户指定群名/会话名时填写，系统会自动搜索群获取cid。 **填写条件**：用户query中出现具体群名/会话名 **不填写情况**：无明确会话范围时留空 **示例**： - '我在scrum群里发了什么' chatScope='scrum群' - '产品群里讨论了什么' chatScope='产品群' - '我发给汐峰的消息' chatScope不填写（用direction处理人际关系） - '我今天发了什么消息' chatScope不填写（无具体群名）", "property": "chatScope", "required": false, "type": "string" }, "direction": { "description": "交互方向，如 \"我-\u003e汐峰\"、\"汐峰-\u003e我\"、\"我\u003c-\u003e汐峰\"", "interface_description": "交互方向（可选），仅当用户query中**明确指定了交互对象（人名）**时填写。**格式**：'发起者-\u003e接收者' 或 '双向交互者\u003c-\u003e另一方'，'我'代表当前用户。**填写条件**：用户query中必须出现具体人名/对象**不填写情况**：无明确交互对象时留空，由behaviorType控制行为筛选**重要**：direction描述的是**内容流向**（谁发给谁），而非谁执行了动作。当用户没有指定具体人名时，即使behaviorType有方向性（如receive/send），也**不要**填写direction，更**不要**使用'我-\u003e*'或'*-\u003e我'这类通配符形式。**示例**：- '我发给汐峰的消息' direction='我-\u003e汐峰'- '汐峰发给我的文档' direction='汐峰-\u003e我'- '我和汐峰的聊天记录' direction='我\u003c-\u003e汐峰'- '帮我总结今天干了什么' direction不填写（无具体对象）- '我今天发的消息' direction不填写（无具体对象）- '我接受了哪些日程' direction不填写（无具体对象，用behaviorType=receive筛选）- '我创建了哪些文档' direction不填写（无具体对象，用behaviorType=create筛选）", "property": "direction", "required": false, "type": "string" }, "queries": { "description": "内容关键词列表，多个用逗号分隔；汇总类场景可留空", "interface_description": "搜索关键词列表，只放**内容关键词**。 **排除规则**： - 时间信息 放到 timeRange 字段 - 类型关键词（日志/文档/消息/会议/日程/纪要等） 放到 searchTypes 字段 - 汇总类词汇（工作总结/日报总结/周报总结/月报总结） 不作为关键词，通过searchTypes=['all']触发全量搜索 示例： - '2025-12-06 ~ 2025-12-19工作总结' queries=[]（时间走timeRange，工作总结触发all类型） - '智能化方案' queries=['智能化方案']", "interface_type": "array", "property": "queries", "required": false, "type": "string" }, "time-range": { "description": "时间范围，仅当用户显式给出时间词时填写，如 今天/本周/9月/过去一周", "interface_description": "时间范围。**提取规则**：仅当用户query中**显式出现**时间词汇时才填写，否则**必须留空**。**可识别的时间词汇**：- 相对时间：今天、昨天、本周、上周、这周、本月、上个月、最近、近期- 具体时间：9月、10月份、Q3、本季度、上半年、2024年- 时间范围：过去一周、最近三天**重要**：不要根据语义推测时间。如果用户没有使用上述时间词汇，即使语境暗示是近期，也**不填写**此字段。**示例**：- '本周的OKR文档' timeRange='本周'- '9月的项目方案' timeRange='9月'- '智能化相关文档' timeRange不填写（无时间词），默认不填写", "property": "timeRange", "required": false, "type": "string" }, "types": { "default": "all", "description": "搜索类型: all/document/im/calendar/todo/minute/report/image/link/notable/baike/mail，多个用逗号分隔", "interface_description": "searchTypes", "interface_type": "array", "property": "searchTypes", "required": false, "type": "string" } }, "path": "aisearch.search_enterprise_behavior", "primary_cli_path": "aisearch behavior", "product_id": "aisearch", "reviewed": false, "risk": "low", "source": "runtime:aisearch", "title": "search_enterprise_behavior", "use_when": [ "我发给某人的消息/邮件/文档/今天我干了什么；搜行为记录", "我发过/谁发给我/创建过/分享过/收到过/今天我干了什么" ] }, "aitable.advperm_disable": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.advperm_disable", "skills/mono/references/products/aitable/aitable-advperm.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "开启或关闭指定 Base 的高级权限总开关。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除指定 Base 下的自定义角色;”请改用 dws aitable advperm role-delete", "要“在指定 Base 下创建自定义角色;”请改用 dws aitable advperm role-create", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm enable" ], "canonical_path": "aitable.advperm_disable", "cli_name": "disable", "cli_path": "aitable advperm disable", "confirmation": "user_required", "description": "开启或关闭指定 Base 的高级权限总开关。必填 baseId、enabled(true=开启,false=关闭)。\r\n返回切换后的状态 {baseId, enabled};只有显式开启后,后续 list_roles / get_role 等角色配置才会真正生效。", "display": "AI 表格操作", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws aitable advperm disable --base-id \u003cbase-id\u003e" ], "group": "advperm", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "set_advanced_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "advperm_disable", "parameter_count": 1, "parameters": { "base-id": { "description": "目标 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" } }, "path": "aitable.advperm_disable", "primary_cli_path": "aitable advperm disable", "product_id": "aitable", "reviewed": false, "risk": "high", "source": "hardcoded:aitable", "title": "set_advanced_permission", "use_when": [ "开启或关闭指定 Base 的高级权限总开关。" ] }, "aitable.advperm_enable": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.advperm_enable", "skills/mono/references/products/aitable/aitable-advperm.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "开启或关闭指定 Base 的高级权限总开关。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除指定 Base 下的自定义角色;”请改用 dws aitable advperm role-delete", "要“在指定 Base 下创建自定义角色;”请改用 dws aitable advperm role-create", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm disable" ], "canonical_path": "aitable.advperm_enable", "cli_name": "enable", "cli_path": "aitable advperm enable", "confirmation": "not_required", "description": "开启或关闭指定 Base 的高级权限总开关。必填 baseId、enabled(true=开启,false=关闭)。\r\n返回切换后的状态 {baseId, enabled};只有显式开启后,后续 list_roles / get_role 等角色配置才会真正生效。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable advperm enable --base-id BASE_ID --format json" ], "group": "advperm", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "set_advanced_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "advperm_enable", "parameter_count": 1, "parameters": { "base-id": { "description": "目标 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" } }, "path": "aitable.advperm_enable", "primary_cli_path": "aitable advperm enable", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "set_advanced_permission", "use_when": [ "1. 确保高级权限已开" ] }, "aitable.advperm_role_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.advperm_role_create", "skills/mono/references/products/aitable/aitable-advperm.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "在指定 Base 下创建自定义角色;", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除指定 Base 下的自定义角色;”请改用 dws aitable advperm role-delete", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm disable", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm enable" ], "canonical_path": "aitable.advperm_role_create", "cli_name": "role-create", "cli_path": "aitable advperm role-create", "confirmation": "not_required", "description": "在指定 Base 下创建自定义角色;系统角色无法通过本工具创建。必填 baseId、name;可选 roleType、flowType、subRoles。\r\nsubRoles[].authLevel 取值:manage / edit-own / edit-custom-field / edit-field-range / read / none。\r\n返回新建角色的完整配置(同 get_role 出参格式)。\r\n自动兜底:caller 可以传稀疏 subRoles(只列关心的资源),或 subRoles 留空。MCP 会自动枚举 Base 下所有 sheet/dashboard,caller 未列的资源补 authLevel=none + bizType 对应默认 config;caller 列了但 config=null 的 sheet/dashboard 也填默认 config(避免前端 JSON.parse null 白屏)。app(bizType=3)需 caller 显式传,不自动枚举。\r\n约束:name 建议 ≤ 30 字;roleType 禁止以 system_ 开头(保留给系统角色);调用者 uid 必须是该 Base 的管理员,否则 UNAUTHORIZED。\r\n失败码:ILLEGAL_ARGUMENT / UNAUTHORIZED / SERVER_ERROR。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable advperm role-create --base-id BASE_ID --name \"市场可读\" --format json", "dws aitable advperm role-create --base-id BASE_ID --name \"市场可读\" --sub-roles '[{\"targetId\":\"\u003csheetId\u003e\",\"targetType\":\"sheet\",\"authLevel\":\"read\"}]' --format json" ], "group": "advperm", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "create_role" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "advperm_role_create", "parameter_count": 5, "parameters": { "base-id": { "description": "目标 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "flow-type": { "description": "流程类型 (按业务需要填写，留空表示无流程绑定)", "interface_description": "可选，流程类型字符串;按业务需要填写,留空表示无流程绑定", "property": "flowType", "required": false, "type": "string" }, "name": { "description": "角色名称 (必填)", "interface_description": "必填，角色名称", "property": "name", "required": true, "type": "string" }, "role-type": { "description": "角色类型 (留空由下游决定默认值，如 custom)", "interface_description": "可选，角色类型字符串(如 custom);留空由下游决定默认值", "property": "roleType", "required": false, "type": "string" }, "sub-roles": { "description": "子角色配置 JSON 数组：[{targetId,targetType,authLevel,appId?,config?}]", "interface_description": "可选，子角色配置列表;每项 {targetId, targetType, authLevel, appId, config}。\r\ntargetType 取值:sheet / dashboard / app;authLevel 取值:manage / edit-own / edit-custom-field / edit-field-range / read / none。\r\npatch 场景:不传=保留现有 subRoles 不变;传入则按 (targetId, targetType) 合并到现有 subRoles 上,只动入参覆盖到的项,其他项保留。", "interface_type": "array", "property": "subRoles", "required": false, "type": "string" } }, "path": "aitable.advperm_role_create", "primary_cli_path": "aitable advperm role-create", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "create_role", "use_when": [ "3. 创建角色 + 指定 sheet 子角色 authLevel=read", "仅指定 name，子角色由服务端按默认（none）填充", "创建时即指定 sub-roles（推荐——避免再走一次 role-update）" ] }, "aitable.advperm_role_delete": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.advperm_role_delete", "skills/mono/references/products/aitable/aitable-advperm.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除指定 Base 下的自定义角色;", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建自定义角色;”请改用 dws aitable advperm role-create", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm disable", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm enable" ], "canonical_path": "aitable.advperm_role_delete", "cli_name": "role-delete", "cli_path": "aitable advperm role-delete", "confirmation": "user_required", "description": "删除指定 Base 下的自定义角色;系统角色禁止删除,下游会返回业务错误。必填 baseId、roleId。\r\n返回被删除的 roleId。删除操作不可逆。", "display": "AI 表格操作", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws aitable advperm role-delete --base-id \u003cbase-id\u003e --role-id \u003crole-id\u003e" ], "group": "advperm", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "delete_role" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "advperm_role_delete", "parameter_count": 2, "parameters": { "base-id": { "description": "目标 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "role-id": { "description": "目标自定义角色 ID（系统角色禁删） (必填)", "interface_description": "目标角色 ID(字符串形态的 long 数字)", "property": "roleId", "required": true, "type": "string" } }, "path": "aitable.advperm_role_delete", "primary_cli_path": "aitable advperm role-delete", "product_id": "aitable", "reviewed": false, "risk": "high", "source": "hardcoded:aitable", "title": "delete_role", "use_when": [ "删除指定 Base 下的自定义角色;" ] }, "aitable.advperm_role_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.advperm_role_get", "skills/mono/references/products/aitable/aitable-advperm.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取指定 Base 下单个角色的完整配置,含 subRoles 与字段/行级权限。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建自定义角色;”请改用 dws aitable advperm role-create", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm disable", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm enable" ], "canonical_path": "aitable.advperm_role_get", "cli_name": "role-get", "cli_path": "aitable advperm role-get", "confirmation": "not_required", "description": "获取指定 Base 下单个角色的完整配置,含 subRoles 与字段/行级权限。\r\n\r\n参数:必填 baseId、roleId。\r\n\r\n返回 {roleId, name, roleType, flowType, isSystem, subRoles:[{targetId, targetType, authLevel, appId, config}]}。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable advperm role-get --base-id BASE_ID --role-id ROLE_ID --format json" ], "group": "advperm", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_role" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "advperm_role_get", "parameter_count": 2, "parameters": { "base-id": { "description": "目标 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "role-id": { "description": "目标角色 ID (字符串形态的 long 数字) (必填)", "interface_description": "目标角色 ID(字符串形态的 long 数字)", "property": "roleId", "required": true, "type": "string" } }, "path": "aitable.advperm_role_get", "primary_cli_path": "aitable advperm role-get", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "get_role", "use_when": [ "获取指定 Base 下单个角色的完整配置,含 subRoles 与字段/行级权限。" ] }, "aitable.advperm_role_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.advperm_role_list", "skills/mono/references/products/aitable/aitable-advperm.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "列出指定 Base 下的全部角色,含系统角色与自定义角色,并标注 isSystem 与默认角色信息。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建自定义角色;”请改用 dws aitable advperm role-create", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm disable", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm enable" ], "canonical_path": "aitable.advperm_role_list", "cli_name": "role-list", "cli_path": "aitable advperm role-list", "confirmation": "not_required", "description": "列出指定 Base 下的全部角色,含系统角色与自定义角色,并标注 isSystem 与默认角色信息。\r\n\r\n参数:必填 baseId。\r\n\r\n返回 {enabled, defaultRole:{mode, roleId}, roles:[{roleId, name, roleType, flowType, isSystem, subRoles}]}。\r\n\r\n不返回角色成员列表;若需要添加/移除角色成员,请使用其他专用工具。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable advperm role-list --base-id BASE_ID --format json" ], "group": "advperm", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "list_roles" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "advperm_role_list", "parameter_count": 1, "parameters": { "base-id": { "description": "目标 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" } }, "path": "aitable.advperm_role_list", "primary_cli_path": "aitable advperm role-list", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "list_roles", "use_when": [ "列出指定 Base 下的全部角色,含系统角色与自定义角色,并标注 isSystem 与默认角色信息。" ] }, "aitable.advperm_role_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.advperm_role_update", "skills/mono/references/products/aitable/aitable-advperm.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "增量更新自定义角色配置。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建自定义角色;”请改用 dws aitable advperm role-create", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm disable", "要“开启或关闭指定 Base 的高级权限总开关”请改用 dws aitable advperm enable" ], "canonical_path": "aitable.advperm_role_update", "cli_name": "role-update", "cli_path": "aitable advperm role-update", "confirmation": "not_required", "description": "增量更新自定义角色配置。必填 baseId、roleId;可选 name、roleType、flowType、subRoles。\r\nsubRoles 行为:不传=完全不动现有 subRoles;传入则按 (targetId, targetType) 与现有 subRoles 合并——入参中的 sub 整体替换该 sub,入参未提及的 sub 保留不变。MCP 已在内部做 get→merge,caller 无需先调 get_role。\r\n自动兜底:caller 传非空 subRoles 时,MCP 会对其中 sheet/dashboard 项里 config=null 的自动填默认 config(避免前端崩),不会额外枚举 Base 资源(与 create 不同,patch 保持\"只动调用方列的项\"语义)。\r\n系统角色禁止更新。\r\n约束:roleType 禁止以 system_ 开头;调用者 uid 必须是该 Base 的管理员,否则 UNAUTHORIZED。\r\n失败码:ILLEGAL_ARGUMENT / UNAUTHORIZED / SERVER_ERROR。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable advperm role-update --base-id BASE_ID --role-id ROLE_ID --name \"新名字\"", "dws aitable advperm role-update --base-id BASE_ID --role-id ROLE_ID --sub-roles '[{\"targetId\":\"\u003csheetId\u003e\",\"targetType\":\"sheet\",\"authLevel\":\"edit-own\"}]'" ], "group": "advperm", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "patch_role" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "advperm_role_update", "parameter_count": 6, "parameters": { "base-id": { "description": "目标 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "flow-type": { "description": "流程类型 (可选)", "interface_description": "可选，流程类型字符串;按业务需要填写,留空表示无流程绑定", "property": "flowType", "required": false, "type": "string" }, "name": { "description": "新角色名称 (可选，不传不修改)", "interface_description": "可选，角色名称;不传则不修改", "property": "name", "required": false, "type": "string" }, "role-id": { "description": "目标自定义角色 ID (必填，系统角色禁止更新)", "interface_description": "目标角色 ID(字符串形态的 long 数字)", "property": "roleId", "required": true, "type": "string" }, "role-type": { "description": "角色类型 (可选)", "interface_description": "可选，角色类型字符串(如 custom);留空由下游决定默认值", "property": "roleType", "required": false, "type": "string" }, "sub-roles": { "description": "子角色配置 JSON 数组，PATCH 语义：按 (targetId,targetType) 合并入现有 subRoles，未提及的 sub 保留", "interface_description": "可选，子角色配置列表;每项 {targetId, targetType, authLevel, appId, config}。\r\ntargetType 取值:sheet / dashboard / app;authLevel 取值:manage / edit-own / edit-custom-field / edit-field-range / read / none。\r\npatch 场景:不传=保留现有 subRoles 不变;传入则按 (targetId, targetType) 合并到现有 subRoles 上,只动入参覆盖到的项,其他项保留。", "interface_type": "array", "property": "subRoles", "required": false, "type": "string" } }, "path": "aitable.advperm_role_update", "primary_cli_path": "aitable advperm role-update", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "patch_role", "use_when": [ "只传 sub-roles，name 等其他字段保持不变（PATCH 语义）", "只改 sheet 子角色 authLevel，name 不传保持不变", "只改名" ] }, "aitable.attachment_upload": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.prepare_attachment_upload", "skills/mono/references/products/aitable/aitable-attachment.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "申请 attachment 字段 OSS 直传地址（不直接上传）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“申请 attachment 字段 OSS 直传地址（不直接上传）”所述变更时不要使用" ], "canonical_path": "aitable.attachment_upload", "cli_name": "upload", "cli_path": "aitable attachment upload", "confirmation": "not_required", "description": "为单个 attachment 字段文件申请带容量校验的 OSS 直传地址。\r\n该工具仅适用于“需要先上传本地文件，再将其写入 attachment 字段”的场景，不是通用文件上传入口，也不适用于后续导入类任务上传。\r\n如果已经有可直接下载的在线文件 URL，不要先下载文件再调用本工具；可直接在 create_records / update_records 的 attachment 字段中传入 [{\"url\":\"https://...\"}]，由服务端自动代拉外链并转存为内部附件。\r\n该工具只负责准备上传，不直接接收文件二进制内容；实际文件字节流应由客户端在 MCP 外上传到返回的 uploadUrl。\r\n上传文件时，向 uploadUrl 发起的 PUT 请求必须携带 Content-Type header，且其值必须是该文件的具体 MIME type。\r\n上传成功后，请在 create_records / update_records 的 attachment 字段中写入 [{\"fileToken\":\"...\"}]。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable attachment upload --base-id \u003cBASE_ID\u003e --file-name report.xlsx --size 204800", "dws aitable attachment upload --base-id \u003cBASE_ID\u003e --file-name photo.png --size 1024 --mime-type image/png" ], "group": "attachment", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "prepare_attachment_upload" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "attachment_upload", "parameter_count": 4, "parameters": { "base-id": { "description": "Base ID，可通过 base list 或 base search 获取 (必填)", "interface_description": "Base ID，可通过 list_bases 或 search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "file-name": { "description": "待上传的文件名，必须包含扩展名（如 report.xlsx、photo.png）(必填)", "interface_description": "待写入 attachment 字段的文件名，必须包含扩展名（如 report.xlsx、photo.png）。服务端会基于扩展名和 mimeType 推断资源类型。", "property": "fileName", "required": true, "type": "string" }, "mime-type": { "description": "文件 MIME type（如 image/png），不传时根据扩展名推断", "interface_description": "可选，文件 MIME type（如 application/pdf、image/png）。不传时服务端会根据 fileName 扩展名推断。若传入该值，则上传文件到 uploadUrl 时，PUT 请求必须携带 Content-Type header，且其值必须与这里完全一致。该字段只影响附件资源识别，不会把该工具升级为通用上传接口。", "property": "mimeType", "required": false, "type": "string" }, "size": { "description": "文件大小（字节），必须大于 0 (必填)", "interface_description": "文件大小（字节），必须大于 0。prepare 阶段会用它向下游申请带容量校验的 attachment 上传地址。", "interface_type": "number", "property": "size", "required": true, "type": "integer" } }, "path": "aitable.attachment_upload", "primary_cli_path": "aitable attachment upload", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "准备附件上传", "use_when": [ "1. 获取上传凭证" ] }, "aitable.base_copy": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.base_copy", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制元数据还是只是复制表的结构不复制数据，三个参数都是必填的,如果用户传的是链接的话则需要根据实际去调用文档的DWS去获取dentryuuid信息，并且传入", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“获取 Base 资源目录（tables、dashboards s”请改用 dws aitable base get" ], "canonical_path": "aitable.base_copy", "cli_name": "copy", "cli_path": "aitable base copy", "confirmation": "not_required", "description": "复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制元数据还是只是复制表的结构不复制数据，三个参数都是必填的,如果用户传的是链接的话则需要根据实际去调用文档的DWS去获取dentryuuid信息，并且传入", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable base copy --base-id \u003cbase-id\u003e --target-folder-id \u003ctarget-folder-id\u003e" ], "group": "base", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "copy_base" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "base_copy", "parameter_count": 3, "parameters": { "base-id": { "description": "源 Base ID (必填)", "interface_description": "源 Base 标识（必填），支持以下格式：dentryUuid / baseId：32 位字母数字字符串文档/文件夹的 dentryUuid", "property": "baseId", "required": true, "type": "string" }, "only-struct": { "description": "是否仅复制结构（不含数据），默认 false 表示完整复制", "property": "onlyStruct", "required": false, "type": "boolean" }, "target-folder-id": { "description": "目标文件夹 ID (必填, 不传会复制失败)", "interface_description": "目标父节点标识（必填），该字段最终生效值必须为 dentryUuid 类型（32 位字母数字字符串）若直接传入 dentryUuid 字符串，则直接使用该值", "property": "targetFolderId", "required": true, "type": "string" } }, "path": "aitable.base_copy", "primary_cli_path": "aitable base copy", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "copy_base", "use_when": [ "复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制元数据还是只是复制表的结构不复制数据，三个参数都是必填的,如果用户传的是链接的话则需要根据实际去调用文档的DWS去获取dentryuuid信息，并且传入" ] }, "aitable.base_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.create_base", "skills/mono/references/products/aitable.md", "skills/mono/references/products/doc.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建 AI 表格 Base", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy", "要“获取 Base 资源目录（tables、dashboards s”请改用 dws aitable base get" ], "canonical_path": "aitable.base_create", "cli_name": "create", "cli_path": "aitable base create", "confirmation": "not_required", "description": "创建一个新的 AI 表格 Base。当前仅要求 baseName，服务端按默认模板创建并返回 baseId/baseName，如果需要创建的特定的文件夹路径下，则需要传递folderId，这个是知识库节点的ID，调用文档的相关服务可以获取", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable base create --name \"项目跟踪\"" ], "group": "base", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_base" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "base_create", "parameter_count": 3, "parameters": { "folder-id": { "description": "目标父节点的 dentryUuid (知识库节点 ID)，也可传入标准节点 URL，MCP 会在创建前解析出实际生效的节点 ID", "interface_description": "对外协议字段名固定为folderId，表示目标父节点的 dentryUuid。 层会进一步兼容同字段传入的标准节点 URL，并在创建前解析出实际生效的节点 ID。", "property": "folderId", "required": false, "type": "string" }, "name": { "description": "Base 名称，1-50 字符；会去除首尾空格后校验 (必填)", "property": "name", "required": true, "type": "string" }, "template-id": { "description": "创建 Base 模板 ID，默认创建一个空 Base。可通过 template search 获取模板", "interface_description": "创建 Base 模板 ID，默认创建一个空 Base。可通过 search_templates 获取模板。", "property": "templateId", "required": false, "type": "string" } }, "path": "aitable.base_create", "primary_cli_path": "aitable base create", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "创建 AI 表格", "use_when": [ "表格/多维表/AI表格；创建" ] }, "aitable.base_delete": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.delete_base", "skills/mono/SKILL.md", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除 Base（高风险、不可逆）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy", "要“获取 Base 资源目录（tables、dashboards s”请改用 dws aitable base get" ], "canonical_path": "aitable.base_delete", "cli_name": "delete", "cli_path": "aitable base delete", "confirmation": "user_required", "description": "删除指定 Base（高风险、不可逆）。成功后应无法通过 get_base/search_bases 读取到该 Base", "display": "AI 表格操作", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws aitable base delete --base-id \u003cbase-id\u003e" ], "group": "base", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_base" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "base_delete", "parameter_count": 2, "parameters": { "base-id": { "description": "待删除 Base ID。建议先通过 base get 确认目标 (必填)", "interface_description": "待删除 Base ID。建议先通过 get_base 确认目标", "property": "baseId", "required": true, "type": "string" }, "reason": { "description": "一句话描述删除的原因", "property": "reason", "required": false, "type": "string" } }, "path": "aitable.base_delete", "primary_cli_path": "aitable base delete", "product_id": "aitable", "risk": "high", "source": "hardcoded:aitable", "title": "删除 AI 表格", "use_when": [ "表格/多维表/AI表格；删除" ] }, "aitable.base_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.get_base", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取 Base 资源目录（tables、dashboards summary）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy" ], "canonical_path": "aitable.base_get", "cli_name": "get", "cli_path": "aitable base get", "confirmation": "not_required", "description": "获取指定 Base 的资源目录级信息，返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。\r\n这是当前 Base 级目录入口：后续如需 tableId 或 dashboardId，优先从这里读取；table 详情再调用 get_tables，dashboard 详情再调用 get_dashboard", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable base get --base-id \u003cBASE_ID\u003e --format json", "dws aitable base get --base-id BASE_ID # 查询 baseId: dws aitable base list" ], "group": "base", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_base" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "base_get", "parameter_count": 1, "parameters": { "base-id": { "description": "Base 唯一标识。优先使用 base search / base list 返回值 (必填)", "interface_description": "Base 唯一标识。优先使用 search_bases/list_bases 返回值", "property": "baseId", "required": true, "type": "string" } }, "path": "aitable.base_get", "primary_cli_path": "aitable base get", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "获取 AI 表格信息", "use_when": [ "2. 获取 Base 信息 — 提取 tableId", "表格/多维表/AI表格；详情" ] }, "aitable.base_get_primary_doc_id": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.base_get_primary_doc_id", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "根据 baseId、tableId 和 recordId 获取主键文档对应的文档信息，会返回对应的文档的dentryuuid，然后利用该uuid去获取文档的内容以及做其他操作", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy" ], "canonical_path": "aitable.base_get_primary_doc_id", "cli_name": "get-primary-doc-id", "cli_path": "aitable base get-primary-doc-id", "confirmation": "not_required", "description": "根据 baseId、tableId 和 recordId 获取主键文档对应的文档信息，会返回对应的文档的dentryuuid，然后利用该uuid去获取文档的内容以及做其他操作", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable base get-primary-doc-id --base-id \u003cbase-id\u003e --record-id \u003crecord-id\u003e --table-id \u003ctable-id\u003e" ], "group": "base", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_base_primary_doc_id" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "base_get_primary_doc_id", "parameter_count": 3, "parameters": { "base-id": { "description": "Base ID，可通过 list_bases 或 search_bases 获取 (必填)", "interface_description": "Base ID，可通过 list_bases 或 search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "record-id": { "description": "记录 ID (必填)", "interface_description": "记录Id", "property": "recordId", "required": true, "type": "string" }, "table-id": { "description": "Table ID，可通过 list_tables 或 get_base 获取 (必填)", "interface_description": "Table ID，可通过 list_tables 或 get_base 获取", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.base_get_primary_doc_id", "primary_cli_path": "aitable base get-primary-doc-id", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "获取AI表格中主键即文档字段的文档ID", "use_when": [ "根据 baseId、tableId 和 recordId 获取主键文档对应的文档信息，会返回对应的文档的dentryuuid，然后利用该uuid去获取文档的内容以及做其他操作" ] }, "aitable.base_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.list_bases", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取 AI 表格列表（最近访问）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy" ], "canonical_path": "aitable.base_list", "cli_name": "list", "cli_path": "aitable base list", "confirmation": "not_required", "description": "列出当前用户可访问的 AI 表格 Base。默认返回最近访问结果，支持分页游标续取。返回 baseId 与 baseName，后续可直接用于 get_base。\r\nAI 表格访问地址可按 baseId 拼接为：https://docs.dingtalk.com/i/nodes/{baseId}", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable base list", "dws aitable base list --limit 5 --cursor NEXT_CURSOR" ], "group": "base", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "list_bases" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "base_list", "parameter_count": 2, "parameters": { "cursor": { "description": "首次不传；传入上次返回的游标继续获取下一页", "property": "cursor", "required": false, "type": "string" }, "limit": { "description": "每页数量，默认 10，最大 10", "interface_type": "number", "property": "limit", "required": false, "type": "integer" } }, "path": "aitable.base_list", "primary_cli_path": "aitable base list", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "获取 AI 表格列表", "use_when": [ "获取 AI 表格列表（最近访问）" ] }, "aitable.base_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.base_search", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "按名称关键词搜索 AI 表格 Base。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy" ], "canonical_path": "aitable.base_search", "cli_name": "search", "cli_path": "aitable base search", "confirmation": "not_required", "description": "按名称关键词搜索 AI 表格 Base。返回 baseId/baseName，结果按相关性排序。返回的 baseId 可直接用于 get_base 等后续工具。\r\nAI 表格访问地址可按 baseId 拼接为：https://docs.dingtalk.com/i/nodes/{baseId}", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable base search --query \"项目\" --format json" ], "group": "base", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "search_bases" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "base_search", "parameter_count": 2, "parameters": { "cursor": { "description": "分页游标，首次不传", "property": "cursor", "required": false, "type": "string" }, "query": { "description": "Base 名称关键词，建议至少 2 个字符 (必填)", "interface_description": "Base 名称关键词，建议至少 2 个字符", "property": "query", "required": true, "type": "string" } }, "path": "aitable.base_search", "primary_cli_path": "aitable base search", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "搜索 AI 表格", "use_when": [ "1. 搜索/列出 Base — 提取 baseId", "表格/多维表/AI表格；查看/查找/列表" ] }, "aitable.base_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.update_base", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新 Base 名称 / 备注", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建 AI 表格 Base”请改用 dws aitable base create", "要“删除 Base（高风险、不可逆）”请改用 dws aitable base delete", "要“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制”请改用 dws aitable base copy" ], "canonical_path": "aitable.base_update", "cli_name": "update", "cli_path": "aitable base update", "confirmation": "not_required", "description": "更新 Base 名称（可选备注）。当前不支持修改主题、封面等扩展属性", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable base update --base-id BASE_ID --name \"新名称\" # 查询 baseId: dws aitable base list" ], "group": "base", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_base" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "base_update", "parameter_count": 3, "parameters": { "base-id": { "description": "目标 Base ID (必填)", "interface_description": "目标 Base ID", "property": "baseId", "required": true, "type": "string" }, "desc": { "description": "备注文本", "property": "desc", "required": false, "type": "string" }, "name": { "description": "新名称，1-50 字符 (必填)", "property": "name", "required": true, "type": "string" } }, "path": "aitable.base_update", "primary_cli_path": "aitable base update", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "更新 AI 表格", "use_when": [ "表格/多维表/AI表格；修改" ] }, "aitable.chart_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.create_chart", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "在 dashboard 下创建 chart（需 --config 与 --layout）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 chart（同步删除其 dashboard 布局项；不可逆”请改用 dws aitable chart delete", "要“更新 chart 配置 / 布局”请改用 dws aitable chart update", "要“获取 chart 详细信息（widget.config + 布局”请改用 dws aitable chart get" ], "canonical_path": "aitable.chart_create", "cli_name": "create", "cli_path": "aitable chart create", "confirmation": "not_required", "description": "在指定 dashboard 下创建 chart。调用前必须先调用 get_dashboard_widgets_example 了解 config 入参结构和要求。返回新创建的 chart 详情。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable chart create --base-id BASE_ID --dashboard-id DASHBOARD_ID --config '{\"chartName\":\"销售柱图\",\"chartType\":\"bar\",...}' --layout '{\"x\":0,\"y\":0,\"w\":6,\"h\":4}'" ], "group": "chart", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_chart" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "chart_create", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "必传参数，所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "config": { "description": "图表配置 JSON，结构参考 chart widgets-example (必填)", "interface_description": "必传参数，图表配置对象，必须按 get_dashboard_widgets_example 返回的 JSONC 结构和注释构造符合要求的 JSON，仅需将占位值替换为真实值", "interface_type": "object", "property": "config", "required": true, "type": "string" }, "dashboard-id": { "description": "所属 Dashboard ID (必填)", "interface_description": "必传参数，所属 dashboard 的唯一标识，可通过 get_base 获取；若需进一步确认该 dashboard 下的 chart summary，可先调用 get_dashboard", "property": "dashboardId", "required": true, "type": "string" }, "layout": { "description": "图表布局 JSON，如 {\"x\":0,\"y\":0,\"w\":6,\"h\":4} (必填)", "interface_description": "必传参数，图表在 dashboard 中的位置和大小。x/y 表示横纵坐标，w/h 表示宽度/高度，单位是列数或行数。仪表盘是网格布局共 12 列、行数无明确限制，设置布局时一定注意。添加图表时同一行的图表保持高度一致，每行的图表宽度相加需要正好将整行填满，以避免出现空白。总计类的图表排在上部，以方便用户快速查看，下方再放置更具体的图表。通过 get_dashboard 获取当前已有图表的布局信息，新增图表时请合理安排布局以避免与现有图表重叠，如有必要也可以通过 update_chart 调整已有图表的布局以适应新增图表。", "interface_type": "object", "property": "layout", "required": true, "type": "string" } }, "path": "aitable.chart_create", "primary_cli_path": "aitable chart create", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "更新图表", "use_when": [ "在 dashboard 下创建 chart（需 --config 与 --layout）" ] }, "aitable.chart_delete": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.delete_chart", "skills/mono/SKILL.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除 chart（同步删除其 dashboard 布局项；不可逆）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“在 dashboard 下创建 chart（需 --config”请改用 dws aitable chart create", "要“更新 chart 配置 / 布局”请改用 dws aitable chart update", "要“获取 chart 详细信息（widget.config + 布局”请改用 dws aitable chart get" ], "canonical_path": "aitable.chart_delete", "cli_name": "delete", "cli_path": "aitable chart delete", "confirmation": "user_required", "description": "删除指定 chart，并同步删除其在 dashboard 中对应的布局项。删除操作不可逆。", "display": "AI 表格操作", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws aitable chart delete --base-id \u003cbase-id\u003e --chart-id \u003cchart-id\u003e --dashboard-id \u003cdashboard-id\u003e" ], "group": "chart", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_chart" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "chart_delete", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "chart-id": { "description": "目标 Chart ID (必填)", "interface_description": "目标 chart 的唯一标识，可通过 get_dashboard 获取", "property": "chartId", "required": true, "type": "string" }, "dashboard-id": { "description": "所属 Dashboard ID (必填)", "interface_description": "所属 dashboard 的唯一标识，可通过 get_base 获取", "property": "dashboardId", "required": true, "type": "string" }, "reason": { "description": "删除原因", "interface_description": "可先参数，删除原因", "property": "reason", "required": false, "type": "string" } }, "path": "aitable.chart_delete", "primary_cli_path": "aitable chart delete", "product_id": "aitable", "risk": "high", "source": "hardcoded:aitable", "title": "删除图表", "use_when": [ "删除 chart（同步删除其 dashboard 布局项；不可逆）" ] }, "aitable.chart_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.get_chart", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-dashboard-chart.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取 chart 详细信息（widget.config + 布局）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 chart（同步删除其 dashboard 布局项；不可逆”请改用 dws aitable chart delete", "要“在 dashboard 下创建 chart（需 --config”请改用 dws aitable chart create", "要“更新 chart 配置 / 布局”请改用 dws aitable chart update" ], "canonical_path": "aitable.chart_get", "cli_name": "get", "cli_path": "aitable chart get", "confirmation": "not_required", "description": "获取指定 chart 的详细信息。返回所属 dashboardId、chartName、chartType、widget.config 以及布局项。返回的 config 中 sheet 为该图表引用的数据表 tableId，view 为视图 viewId。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable chart get --base-id \u003cBASE_ID\u003e --dashboard-id \u003cDASHBOARD_ID\u003e --chart-id \u003cCHART_ID\u003e --format json", "dws aitable chart get --base-id BASE_ID --dashboard-id DASHBOARD_ID --chart-id CHART_ID" ], "group": "chart", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_chart" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "chart_get", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "chart-id": { "description": "目标 Chart ID（通过 dashboard get 获取）(必填)", "interface_description": "目标 chart 的唯一标识，可通过 get_dashboard 获取", "property": "chartId", "required": true, "type": "string" }, "dashboard-id": { "description": "所属 Dashboard ID (必填)", "interface_description": "所属 dashboard 的唯一标识，可通过 get_base 获取", "property": "dashboardId", "required": true, "type": "string" } }, "path": "aitable.chart_get", "primary_cli_path": "aitable chart get", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "获取图表信息", "use_when": [ "2) 先拿 dashboard，再拿 chart 详情" ] }, "aitable.chart_share_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.get_chart_share", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取 chart 分享配置", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“更新 chart 分享开关与类型”请改用 dws aitable chart share update" ], "canonical_path": "aitable.chart_share_get", "cli_name": "get", "cli_path": "aitable chart share get", "confirmation": "not_required", "description": "查询指定 chart 的当前分享配置。返回分享是否已开启（enabled）、分享类型（shareType：PUBLIC / ORG）、分享链接（shareUrl）等信息。若分享尚未开启，enabled 为 false，shareUrl 为 null。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable chart share get --base-id BASE_ID --dashboard-id DASHBOARD_ID --chart-id CHART_ID" ], "group": "chart.share", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_chart_share" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "chart_share_get", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "必填，所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "chart-id": { "description": "目标 Chart ID (必填)", "interface_description": "必填，目标 chart 的唯一标识，可通过 get_dashboard 获取", "property": "chartId", "required": true, "type": "string" }, "dashboard-id": { "description": "所属 Dashboard ID (必填)", "interface_description": "必填，所属 dashboard 的唯一标识，可通过 get_base 获取", "property": "dashboardId", "required": true, "type": "string" } }, "path": "aitable.chart_share_get", "primary_cli_path": "aitable chart share get", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "获取图表的分享配置", "use_when": [ "获取 chart 分享配置" ] }, "aitable.chart_share_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.update_chart_share", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新 chart 分享开关与类型", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“获取 chart 分享配置”请改用 dws aitable chart share get" ], "canonical_path": "aitable.chart_share_update", "cli_name": "update", "cli_path": "aitable chart share update", "confirmation": "not_required", "description": "用于开启或关闭指定 chart 的分享，并设置分享类型。\\nenabled=true 时开启分享；enabled=false 时关闭分享（shareType 此时无意义）。\\nshareType 支持两种：PUBLIC（任何人均可访问）、ORG（仅限当前组织成员访问）。\\n返回更新后的分享配置，包括 shareUrl（可直接发送给他人）。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable chart share update --base-id BASE_ID --dashboard-id DASHBOARD_ID --chart-id CHART_ID --enabled true --share-type ORG", "dws aitable chart share update --base-id BASE_ID --dashboard-id DASHBOARD_ID --chart-id CHART_ID --enabled false" ], "group": "chart.share", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_chart_share" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "chart_share_update", "parameter_count": 6, "parameters": { "allow-back-to-doc": { "description": "是否允许从分享页返回源 AI 表格（仅在显式传参时生效）", "interface_description": "可选，是否允许查看者通过分享页返回源 AI 表格文档。不传时保持原有配置", "property": "allowBackToDoc", "required": false, "type": "boolean" }, "base-id": { "description": "所属 Base ID (必填)", "interface_description": "必填，所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "chart-id": { "description": "目标 Chart ID (必填)", "interface_description": "必填，目标 chart 的唯一标识，可通过 get_dashboard 获取", "property": "chartId", "required": true, "type": "string" }, "dashboard-id": { "description": "所属 Dashboard ID (必填)", "interface_description": "必填，所属 dashboard 的唯一标识，可通过 get_base 获取", "property": "dashboardId", "required": true, "type": "string" }, "enabled": { "description": "分享开关：true 开启，false 关闭 (必填)", "interface_description": "必填，分享开关。true 表示开启分享，false 表示关闭分享", "interface_type": "boolean", "property": "enabled", "required": true, "type": "string" }, "share-type": { "description": "分享类型：PUBLIC 或 ORG（enabled=true 时生效）", "interface_description": "可选，分享类型，仅在 enabled=true 时有意义。支持值：PUBLIC（任何人均可通过分享链接访问，无需鉴权）、ORG（仅限当前组织成员访问）。默认为 PUBLIC。", "property": "shareType", "required": false, "type": "string" } }, "path": "aitable.chart_share_update", "primary_cli_path": "aitable chart share update", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "更新图表分享配置（开启或关闭或更新配置）", "use_when": [ "更新 chart 分享开关与类型" ] }, "aitable.chart_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.update_chart", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新 chart 配置 / 布局", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 chart（同步删除其 dashboard 布局项；不可逆”请改用 dws aitable chart delete", "要“在 dashboard 下创建 chart（需 --config”请改用 dws aitable chart create", "要“获取 chart 详细信息（widget.config + 布局”请改用 dws aitable chart get" ], "canonical_path": "aitable.chart_update", "cli_name": "update", "cli_path": "aitable chart update", "confirmation": "not_required", "description": "更新指定 chart 的配置或布局。调用前必须先调用 get_dashboard_widgets_example 了解 config 入参结构和要求。返回更新后的 chart 详情。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable chart update --base-id BASE_ID --dashboard-id DASHBOARD_ID --chart-id CHART_ID --config '{\"chartName\":\"新柱图名\",...}'", "dws aitable chart update --base-id BASE_ID --dashboard-id DASHBOARD_ID --chart-id CHART_ID --layout '{\"x\":0,\"y\":4,\"w\":12,\"h\":4}'" ], "group": "chart", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_chart" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "chart_update", "parameter_count": 5, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "chart-id": { "description": "目标 Chart ID (必填)", "interface_description": "目标 chart 的唯一标识，可通过 get_dashboard 获取", "property": "chartId", "required": true, "type": "string" }, "config": { "description": "图表配置 JSON (必填)", "interface_description": "必传参数，图表配置对象，必须按 get_dashboard_widgets_example 返回的 JSONC 结构和注释构造符合要求的 JSON，仅需将占位值替换为真实值", "interface_type": "object", "property": "config", "required": true, "type": "string" }, "dashboard-id": { "description": "所属 Dashboard ID (必填)", "interface_description": "所属 dashboard 的唯一标识，可通过 get_base 获取", "property": "dashboardId", "required": true, "type": "string" }, "layout": { "description": "图表布局更新 JSON", "interface_description": "可选，不提供此参数代表不更改布局，图表在 dashboard 中的位置和大小。x/y 表示横纵坐标，w/h 表示宽度/高度，单位是列数或行数。仪表盘是网格布局共 12 列、行数无明确限制，更新布局时一定注意。同一行的图表保持高度一致，每行的图表宽度相加需要正好将整行填满，以避免出现空白。总计类的图表排在上部，以方便用户快速查看，下方再放置更具体的图表。通过 get_dashboard 获取当前已有图表的布局信息，更新图表布局时请合理安排布局以避免与现有图表重叠，如有必要也可以通过 update_chart 调整已有图表的布局以让新布局更合适。", "interface_type": "object", "property": "layout", "required": false, "type": "string" } }, "path": "aitable.chart_update", "primary_cli_path": "aitable chart update", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "更新图表", "use_when": [ "更新 chart 配置 / 布局" ] }, "aitable.chart_widgets_example": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.get_dashboard_widgets_example", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-dashboard-chart.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "返回所有图表类型的 widget config 示例（JSONC）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 chart（同步删除其 dashboard 布局项；不可逆”请改用 dws aitable chart delete", "要“在 dashboard 下创建 chart（需 --config”请改用 dws aitable chart create", "要“获取 chart 详细信息（widget.config + 布局”请改用 dws aitable chart get" ], "canonical_path": "aitable.chart_widgets_example", "cli_name": "widgets-example", "cli_path": "aitable chart widgets-example", "confirmation": "not_required", "description": "返回所有图表类型的 widget config 示例（JSONC 格式，含注释说明每个字段的含义和约束，请直接阅读理解）。可作为 create_chart / update_chart 的 config 参数结构参考，根据目标图表类型选取对应示例。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable chart widgets-example --format json", "dws aitable chart widgets-example" ], "group": "chart", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_dashboard_widgets_example" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "chart_widgets_example", "parameter_count": 0, "parameters": {}, "path": "aitable.chart_widgets_example", "primary_cli_path": "aitable chart widgets-example", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "获取图表配置示例", "use_when": [ "1) 先看配置模板（JSONC）" ] }, "aitable.create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "创建 AI 表格（dws aitable base create 的别名）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建 AI 表格（dws aitable base create 的别名）”所述变更时不要使用" ], "canonical_path": "aitable.create", "cli_name": "create", "cli_path": "aitable create", "confirmation": "not_required", "description": "创建一个新的 AI 表格 Base。\n这是 dws aitable base create 的便捷别名,两个命令完全等价。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable create --name \u003cname\u003e" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_base" }, "is_alias": false, "name": "create", "parameter_count": 3, "parameters": { "folder-id": { "description": "目标父节点的 dentryUuid (知识库节点 ID)，也可传入标准节点 URL，MCP 会在创建前解析出实际生效的节点 ID", "property": "folderId", "required": false, "type": "string" }, "name": { "description": "Base 名称，1-50 字符；会去除首尾空格后校验 (必填)", "property": "name", "required": true, "type": "string" }, "template-id": { "description": "创建 Base 模板 ID，默认创建一个空 Base。可通过 template search 获取模板", "property": "templateId", "required": false, "type": "string" } }, "path": "aitable.create", "primary_cli_path": "aitable create", "product_id": "aitable", "reviewed": true, "risk": "medium", "source": "hardcoded:aitable", "title": "创建 AI 表格（dws aitable base create 的别名）", "use_when": [ "创建 AI 表格（dws aitable base create 的别名）" ] }, "aitable.dashboard_arrange": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.dashboard_arrange", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 dashboard（级联删除其下 chart；不可逆）”请改用 dws aitable dashboard delete", "要“在指定 Base 下创建 dashboard”请改用 dws aitable dashboard create", "要“返回 dashboard config 结构示例（JSONC）”请改用 dws aitable dashboard config-example" ], "canonical_path": "aitable.dashboard_arrange", "cli_name": "arrange", "cli_path": "aitable dashboard arrange", "confirmation": "not_required", "description": "自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排。根据仪表盘的网格列数（schemaVersion 为 2 时为 48 列，其他情况为 12 列），自动将 y 坐标相近的图表归为同一行，统一同行图表高度，按比例缩放宽度使每行精确填满全列，紧凑排列消除行间空隙，消除底部参差不齐。返回对齐后的完整布局信息。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable dashboard arrange --base-id \u003cbase-id\u003e --dashboard-id \u003cdashboard-id\u003e" ], "group": "dashboard", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "align_dashboard" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_arrange", "parameter_count": 2, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases / get_base 获取", "property": "baseId", "required": true, "type": "string" }, "dashboard-id": { "description": "目标 Dashboard ID (必填)", "interface_description": "目标 dashboard 的唯一标识，可通过 get_base 获取", "property": "dashboardId", "required": true, "type": "string" } }, "path": "aitable.dashboard_arrange", "primary_cli_path": "aitable dashboard arrange", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "自动对齐仪表盘布局", "use_when": [ "自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排。" ] }, "aitable.dashboard_config_example": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.get_dashboard_config_example", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-dashboard-chart.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "返回 dashboard config 结构示例（JSONC）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 dashboard（级联删除其下 chart；不可逆）”请改用 dws aitable dashboard delete", "要“在指定 Base 下创建 dashboard”请改用 dws aitable dashboard create", "要“自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排”请改用 dws aitable dashboard arrange" ], "canonical_path": "aitable.dashboard_config_example", "cli_name": "config-example", "cli_path": "aitable dashboard config-example", "confirmation": "not_required", "description": "返回 dashboard config 的完整结构示例（JSONC 格式，含注释说明每个字段的含义和约束，请直接阅读理解）。可作为 create_dashboard / update_dashboard 的 config 参数结构参考。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable dashboard config-example --format json", "dws aitable dashboard config-example" ], "group": "dashboard", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_dashboard_config_example" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_config_example", "parameter_count": 0, "parameters": {}, "path": "aitable.dashboard_config_example", "primary_cli_path": "aitable dashboard config-example", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "获取仪表盘配置示例", "use_when": [ "1) 先看配置模板（JSONC）" ] }, "aitable.dashboard_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.dashboard_create", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "在指定 Base 下创建 dashboard。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除 dashboard（级联删除其下 chart；不可逆）”请改用 dws aitable dashboard delete", "要“自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排”请改用 dws aitable dashboard arrange", "要“返回 dashboard config 结构示例（JSONC）”请改用 dws aitable dashboard config-example" ], "canonical_path": "aitable.dashboard_create", "cli_name": "create", "cli_path": "aitable dashboard create", "confirmation": "not_required", "description": "在指定 Base 下创建 dashboard。调用前必须先调用 get_dashboard_config_example 了解 config 入参结构和要求。返回新创建的 dashboard 详情。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable dashboard create --base-id \u003cbase-id\u003e --name \u003cname\u003e" ], "group": "dashboard", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_dashboard" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_create", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "必传参数，所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "config": { "description": "Dashboard 配置 JSON，结构参考 dashboard config-example。可用 --name 替代来快速创建空看板", "interface_description": "必传参数，Dashboard 配置对象，必须按 get_dashboard_config_example 返回的 JSONC 结构和注释构造符合要求的 JSON", "interface_type": "object", "property": "config", "required": false, "type": "string" }, "name": { "description": "新仪表盘名称（替代 --config 简化版创建空看板）", "property": "name", "required": true, "type": "string" } }, "path": "aitable.dashboard_create", "primary_cli_path": "aitable dashboard create", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "创建仪表盘", "use_when": [ "在指定 Base 下创建 dashboard。" ] }, "aitable.dashboard_delete": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.delete_dashboard", "skills/mono/SKILL.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除 dashboard（级联删除其下 chart；不可逆）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建 dashboard”请改用 dws aitable dashboard create", "要“自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排”请改用 dws aitable dashboard arrange", "要“返回 dashboard config 结构示例（JSONC）”请改用 dws aitable dashboard config-example" ], "canonical_path": "aitable.dashboard_delete", "cli_name": "delete", "cli_path": "aitable dashboard delete", "confirmation": "user_required", "description": "删除指定 dashboard，会级联删除该 dashboard 下的所有 chart；删除操作不可逆。", "display": "AI 表格操作", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws aitable dashboard delete --base-id \u003cbase-id\u003e --dashboard-id \u003cdashboard-id\u003e" ], "group": "dashboard", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_dashboard" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_delete", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "dashboard-id": { "description": "目标 Dashboard ID (必填)", "interface_description": "目标 dashboard 的唯一标识，可通过 get_base 获取", "property": "dashboardId", "required": true, "type": "string" }, "reason": { "description": "删除原因", "interface_description": "可选，删除原因", "property": "reason", "required": false, "type": "string" } }, "path": "aitable.dashboard_delete", "primary_cli_path": "aitable dashboard delete", "product_id": "aitable", "risk": "high", "source": "hardcoded:aitable", "title": "删除仪表盘", "use_when": [ "删除 dashboard（级联删除其下 chart；不可逆）" ] }, "aitable.dashboard_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.get_dashboard", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-dashboard-chart.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取 dashboard 详情（含 charts summary）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建 dashboard”请改用 dws aitable dashboard create", "要“自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排”请改用 dws aitable dashboard arrange", "要“返回 dashboard config 结构示例（JSONC）”请改用 dws aitable dashboard config-example" ], "canonical_path": "aitable.dashboard_get", "cli_name": "get", "cli_path": "aitable dashboard get", "confirmation": "not_required", "description": "获取指定 dashboard 的详细信息。\\r\\n返回 dashboardName、filters、layout，以及该 dashboard 下的 charts summary（chartId、chartName、chartType）。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable dashboard get --base-id \u003cBASE_ID\u003e --dashboard-id \u003cDASHBOARD_ID\u003e --format json", "dws aitable dashboard get --base-id BASE_ID --dashboard-id DASHBOARD_ID" ], "group": "dashboard", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_dashboard" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_get", "parameter_count": 2, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases / get_base 获取", "property": "baseId", "required": true, "type": "string" }, "dashboard-id": { "description": "目标 Dashboard ID（通过 base get 获取）(必填)", "interface_description": "目标 dashboard 的唯一标识，可通过 get_base 获取", "property": "dashboardId", "required": true, "type": "string" } }, "path": "aitable.dashboard_get", "primary_cli_path": "aitable dashboard get", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "获取仪表盘信息", "use_when": [ "2) 先拿 dashboard，再拿 chart 详情" ] }, "aitable.dashboard_share_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.get_dashboard_share", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取 dashboard 分享配置", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“更新 dashboard 分享开关与类型”请改用 dws aitable dashboard share update" ], "canonical_path": "aitable.dashboard_share_get", "cli_name": "get", "cli_path": "aitable dashboard share get", "confirmation": "not_required", "description": "查询指定 dashboard 的当前分享配置。返回分享是否已开启（enabled）、分享类型（shareType：PUBLIC / ORG）、分享链接（shareUrl）等信息。若分享尚未开启，enabled 为 false，shareUrl 为 null。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable dashboard share get --base-id BASE_ID --dashboard-id DASHBOARD_ID" ], "group": "dashboard.share", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_dashboard_share" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_share_get", "parameter_count": 2, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases / get_base 获取", "property": "baseId", "required": true, "type": "string" }, "dashboard-id": { "description": "目标 Dashboard ID (必填)", "interface_description": "目标 dashboard 的唯一标识，可通过 get_base 获取", "property": "dashboardId", "required": true, "type": "string" } }, "path": "aitable.dashboard_share_get", "primary_cli_path": "aitable dashboard share get", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "查询仪表盘分享配置", "use_when": [ "获取 dashboard 分享配置" ] }, "aitable.dashboard_share_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.update_dashboard_share", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新 dashboard 分享开关与类型", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“获取 dashboard 分享配置”请改用 dws aitable dashboard share get" ], "canonical_path": "aitable.dashboard_share_update", "cli_name": "update", "cli_path": "aitable dashboard share update", "confirmation": "not_required", "description": "用于开启或关闭指定 dashboard 的分享，并设置分享类型。enabled=true 时开启分享；enabled=false 时关闭分享（shareType 此时无意义）。shareType 支持两种：PUBLIC（任何人均可访问）、ORG（仅限当前组织成员访问）。返回更新后的分享配置，包括 shareUrl（可直接发送给他人）。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable dashboard share update --base-id BASE_ID --dashboard-id DASHBOARD_ID --enabled true --share-type PUBLIC", "dws aitable dashboard share update --base-id BASE_ID --dashboard-id DASHBOARD_ID --enabled false" ], "group": "dashboard.share", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_dashboard_share" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_share_update", "parameter_count": 5, "parameters": { "allow-back-to-doc": { "description": "是否允许从分享页返回源 AI 表格（仅在显式传参时生效）", "interface_description": "可选，是否允许查看者通过分享页返回源 AI 表格文档。不传时保持原有配置", "property": "allowBackToDoc", "required": false, "type": "boolean" }, "base-id": { "description": "所属 Base ID (必填)", "interface_description": "必填，所属 Base 的唯一标识，可通过 list_bases / search_bases / get_base 获取", "property": "baseId", "required": true, "type": "string" }, "dashboard-id": { "description": "目标 Dashboard ID (必填)", "interface_description": "必填，目标 dashboard 的唯一标识，可通过 get_base 获取", "property": "dashboardId", "required": true, "type": "string" }, "enabled": { "description": "分享开关：true 开启，false 关闭 (必填)", "interface_description": "必填，分享开关。true 表示开启分享，false 表示关闭分享", "interface_type": "boolean", "property": "enabled", "required": true, "type": "string" }, "share-type": { "description": "分享类型：PUBLIC 或 ORG（enabled=true 时生效）", "interface_description": "可选，分享类型，仅在 enabled=true 时有意义。支持值：PUBLIC（任何人均可通过分享链接访问，无需鉴权）、ORG（仅限当前组织成员访问）。默认为 PUBLIC。", "property": "shareType", "required": false, "type": "string" } }, "path": "aitable.dashboard_share_update", "primary_cli_path": "aitable dashboard share update", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "设置仪表盘分享配置（开启或关闭或更新配置）", "use_when": [ "更新 dashboard 分享开关与类型" ] }, "aitable.dashboard_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.dashboard_update", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新指定 dashboard 的配置。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定 Base 下创建 dashboard”请改用 dws aitable dashboard create", "要“自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排”请改用 dws aitable dashboard arrange", "要“返回 dashboard config 结构示例（JSONC）”请改用 dws aitable dashboard config-example" ], "canonical_path": "aitable.dashboard_update", "cli_name": "update", "cli_path": "aitable dashboard update", "confirmation": "not_required", "description": "更新指定 dashboard 的配置。调用前必须先调用 get_dashboard_config_example 了解 config 入参结构和要求。返回更新后的 dashboard 详情。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable dashboard update --base-id \u003cbase-id\u003e --dashboard-id \u003cdashboard-id\u003e --name \u003cname\u003e" ], "group": "dashboard", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_dashboard" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "dashboard_update", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "必传参数，所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "config": { "description": "Dashboard 配置更新项 JSON。可选，若只需改名可以用 --name 代替", "interface_description": "必传参数，Dashboard 配置对象，必须按 get_dashboard_config_example 返回的 JSONC 结构和注释构造符合要求的 JSON。传入需要更新的字段，未传入的字段保持原值", "interface_type": "object", "property": "config", "required": false, "type": "string" }, "dashboard-id": { "description": "目标 Dashboard ID (必填)", "interface_description": "必传参数，目标 dashboard 的唯一标识，可通过 get_base 获取", "property": "dashboardId", "required": true, "type": "string" }, "name": { "description": "要修改的新看板名称（替代 --config 简化操作）", "property": "name", "required": true, "type": "string" } }, "path": "aitable.dashboard_update", "primary_cli_path": "aitable dashboard update", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "更新仪表盘", "use_when": [ "更新指定 dashboard 的配置。" ] }, "aitable.export_data": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.export_data", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-export-import.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "导出数据（不传 --task-id 创建新任务并等待，传入 --task-id 继续等待）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“导出数据（不传 --task-id 创建新任务并等待，传入 --task-id 继续等待）”" ], "canonical_path": "aitable.export_data", "cli_name": "data", "cli_path": "aitable export data", "confirmation": "not_required", "description": "导出 AI 表格数据的统一入口。\r\n不传 taskId 时，会根据 scope / format 创建一个新的导出任务，并在 timeoutMs 时间内同步等待结果；若在等待窗口内完成，则直接返回 downloadUrl 和 fileName。\r\n传入 taskId 时，不会重新创建任务，而是继续等待该任务；若仍未完成，则继续返回同一个 taskId，供下一次调用继续等待。\r\n当前稳定支持的 scope：all、table、view；暂不开放按字段导出。\r\n当前稳定支持的 format：excel、attachment、excel_and_attachment、excel_with_inline_images。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable export data --base-id \u003cBASE_ID\u003e --scope table --table-id \u003cTABLE_ID\u003e --format excel --timeout-ms 1000", "dws aitable export data --base-id \u003cBASE_ID\u003e --task-id \u003cTASK_ID\u003e --timeout-ms 3000" ], "group": "export", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "export_data" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "export_data", "parameter_count": 7, "parameters": { "base-id": { "description": "Base ID (必填)", "interface_description": "Base ID，可通过 list_bases 或 search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "format": { "description": "导出格式：excel、attachment、excel_and_attachment、excel_with_inline_images", "interface_description": "可选，导出格式。创建新任务时必填。\n支持值：excel、attachment、excel_and_attachment、excel_with_inline_images。", "property": "format", "required": false, "type": "string" }, "scope": { "description": "导出范围：all（整个 Base）、table（指定数据表）、view（指定视图）", "interface_description": "可选，导出范围。创建新任务时必填。\n支持值：all（整个 Base）、table（指定数据表）、view（指定视图）。\nscope=table 时必须传 tableId；scope=view 时必须传 tableId 和 viewId。", "property": "scope", "required": true, "type": "string" }, "table-id": { "description": "Table ID，scope=table 或 scope=view 时必填", "interface_description": "可选，Table ID。scope=table 或 scope=view 时必填；可通过 get_base 获取。", "property": "tableId", "required": false, "type": "string" }, "task-id": { "description": "已有导出任务 ID，传入后继续等待（忽略 scope/format/table-id/view-id）", "interface_description": "可选，已有导出任务 ID。传入后表示继续等待该任务；此时不要再传 scope、format、tableId、viewId。", "property": "taskId", "required": false, "type": "string" }, "timeout-ms": { "description": "单次等待超时（毫秒），默认 30000，最大 30000", "interface_description": "可选，单次等待超时时间（毫秒）。默认 30000，最小 200，最大 30000。超时后会返回 taskId，供下一次继续等待。", "interface_type": "number", "property": "timeoutMs", "required": false, "type": "integer" }, "view-id": { "description": "View ID，scope=view 时必填", "interface_description": "可选，View ID。scope=view 时必填；可通过 list_views 或 get_views 获取。", "property": "viewId", "required": false, "type": "string" } }, "path": "aitable.export_data", "primary_cli_path": "aitable export data", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "导出数据", "use_when": [ "第一步：创建任务（按 scope 传必要参数）", "第一步：创建任务（按 scope 传必要参数）——注意：不要加 --format json！", "第二步：拿 taskId 继续轮询，直到返回 downloadUrl", "续等导出：拿到 downloadUrl 后再 curl 下载（见下方警告）" ] }, "aitable.field_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.field_create", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-field.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "在已有表格中批量新增字段。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除字段（不可逆，禁止删除主字段与最后一个字段）”请改用 dws aitable field delete", "要“批量获取字段详细信息（含完整配置）”请改用 dws aitable field get", "要“批量获取指定字段的详细信息，包括 fieldId、名称、类型、d”请改用 dws aitable field list" ], "canonical_path": "aitable.field_create", "cli_name": "create", "cli_path": "aitable field create", "confirmation": "not_required", "description": "在已有表格中批量新增字段。适用于建表后补充一批字段，或一次性添加多个关联、流转等复杂类型字段。单次最多创建 15 个字段；若超过该数量，请拆分多次调用。允许部分成功，返回结果会逐项说明每个字段是否创建成功；失败项会返回 reason 说明失败原因。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable field create --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e --name \"状态\" --type \"singleSelect\" --config '{\"options\":[{\"name\":\"待办\"},{\"name\":\"进行中\"},{\"name\":\"已完成\"}]}'", "dws aitable field create --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e --fields '[{\"fieldName\":\"状态\",\"type\":\"singleSelect\",\"config\":{\"options\":[{\"name\":\"待办\"}]}}]'" ], "group": "field", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_fields" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "field_create", "parameter_count": 7, "parameters": { "ai-config": { "description": "单字段 AI 配置 JSON（如 outputType/prompt，配合 --name/--type 使用）", "property": "aiConfig", "required": false, "type": "string" }, "base-id": { "description": "Base ID（通过 base list 获取）(必填)", "interface_description": "Base ID（通过 list_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "config": { "description": "单字段的额外配置 JSON（如 options，配合 --name/--type 使用）", "property": "config", "required": false, "type": "string" }, "fields": { "description": "待新增字段列表 JSON 数组，至少包含 1 个字段，单次最多 15 个。系统会按数组顺序依次创建，返回结果顺序与入参保持一致，并逐项标明成功/失败状态。若是单个字段可直接使用 --name/--type/--config", "interface_description": "待新增字段列表，至少包含 1 个字段，单次最多 15 个。系统会按数组顺序依次创建，返回结果顺序与入参保持一致，并逐项标明成功/失败状态。", "interface_type": "array", "property": "fields", "required": true, "type": "string" }, "name": { "description": "要创建的单字段名称（与 --type 配合使用，替代 --fields）", "property": "name", "required": false, "type": "string" }, "table-id": { "description": "Table ID（通过 base get 获取）(必填)", "interface_description": "Table ID（通过 get_base 获取）", "property": "tableId", "required": true, "type": "string" }, "type": { "description": "要创建的单字段类型（需要配合 --name，参考 table create 的内置类型）", "property": "type", "required": false, "type": "string" } }, "path": "aitable.field_create", "primary_cli_path": "aitable field create", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "create_fields", "use_when": [ "字段/列/column；添加", "或者使用批量创建模式:" ] }, "aitable.field_delete": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.delete_field", "skills/mono/SKILL.md", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-field.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除字段（不可逆，禁止删除主字段与最后一个字段）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“在已有表格中批量新增字段”请改用 dws aitable field create", "要“批量获取字段详细信息（含完整配置）”请改用 dws aitable field get", "要“批量获取指定字段的详细信息，包括 fieldId、名称、类型、d”请改用 dws aitable field list" ], "canonical_path": "aitable.field_delete", "cli_name": "delete", "cli_path": "aitable field delete", "confirmation": "user_required", "description": "删除指定 Table 中的一个字段（Field），删除操作不可逆。禁止删除主字段，且禁止删除最后一个字段\r\n\r\n此操作不可逆，会永久删除字段及其所有数据。\r\n必须提供准确的 baseId、tableId 和 fieldId，不得使用名称代替 ID。\r\n若字段不存在或无权限，将返回错误。", "display": "AI 表格操作", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws aitable field delete --base-id \u003cbase-id\u003e --field-id \u003cfield-id\u003e --table-id \u003ctable-id\u003e" ], "group": "field", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_field" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "field_delete", "parameter_count": 3, "parameters": { "base-id": { "description": "Base ID（通过 base list 获取）(必填)", "interface_description": "Base ID（通过 list_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "field-id": { "description": "待删除字段 ID（通过 table get 获取）(必填)", "interface_description": "待删除字段 ID（通过 get_tables 获取）", "property": "fieldId", "required": true, "type": "string" }, "table-id": { "description": "Table ID（通过 base get 获取）(必填)", "interface_description": "Table ID（通过 get_base 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.field_delete", "primary_cli_path": "aitable field delete", "product_id": "aitable", "risk": "high", "source": "hardcoded:aitable", "title": "删除字段", "use_when": [ "字段/列/column；删除" ] }, "aitable.field_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.get_fields", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-field.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量获取字段详细信息（含完整配置）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除字段（不可逆，禁止删除主字段与最后一个字段）”请改用 dws aitable field delete", "要“在已有表格中批量新增字段”请改用 dws aitable field create", "要“批量获取指定字段的详细信息，包括 fieldId、名称、类型、d”请改用 dws aitable field list" ], "canonical_path": "aitable.field_get", "cli_name": "get", "cli_path": "aitable field get", "confirmation": "not_required", "description": "批量获取指定字段的详细信息，包括 fieldId、名称、类型、description 以及类型相关完整配置（如格式化、选项、AI 配置等）。\r\n传 fieldIds 时单次最多获取 10 个字段；若需更多字段，请拆分多次调用。\r\n适用于在 get_tables 拿到字段目录后，按需展开少量字段的完整配置，避免大 options 字段放大 get_tables 返回值。\r\nAI 字段的返回结果中，config 仅包含字段物理配置，aiConfig 作为同级字段单独返回，结构与 create_fields 写入参数一致。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable field get --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e", "dws aitable field get --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e --field-ids fld1,fld2" ], "group": "field", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_fields" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "field_get", "parameter_count": 3, "parameters": { "base-id": { "description": "Base ID（可通过 base list 获取）(必填)", "interface_description": "Base ID（可通过 list_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "field-ids": { "description": "待获取详情的字段 ID 列表（通过 table get 获取），逗号分隔；建议只传真正需要展开完整配置的字段，单次最多 10 个；不传则返回全部字段。建议优先显式传入，以控制返回体大小，避免上下文突增", "interface_description": "待获取详情的字段 ID 列表，可通过 get_tables 获取；建议只传真正需要展开完整配置的字段，单次最多 10 个；不传则默认返回当前表下全部字段。建议优先显式传入，以控制返回体大小，避免上下文突增", "interface_type": "array", "property": "fieldIds", "required": false, "type": "string" }, "table-id": { "description": "Table ID（可通过 base get 获取）(必填)", "interface_description": "Table ID（可通过 get_base 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.field_get", "primary_cli_path": "aitable field get", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "获取字段详情", "use_when": [ "字段/列/column；查看" ] }, "aitable.field_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.field_list", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量获取指定字段的详细信息，包括 fieldId、名称、类型、description 以及类型相关完整配置（如格式化、选项、AI 配置等）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除字段（不可逆，禁止删除主字段与最后一个字段）”请改用 dws aitable field delete", "要“在已有表格中批量新增字段”请改用 dws aitable field create", "要“批量获取字段详细信息（含完整配置）”请改用 dws aitable field get" ], "canonical_path": "aitable.field_list", "cli_name": "list", "cli_path": "aitable field list", "confirmation": "not_required", "description": "批量获取指定字段的详细信息，包括 fieldId、名称、类型、description 以及类型相关完整配置（如格式化、选项、AI 配置等）。\r\n传 fieldIds 时单次最多获取 10 个字段；若需更多字段，请拆分多次调用。\r\n适用于在 get_tables 拿到字段目录后，按需展开少量字段的完整配置，避免大 options 字段放大 get_tables 返回值。\r\nAI 字段的返回结果中，config 仅包含字段物理配置，aiConfig 作为同级字段单独返回，结构与 create_fields 写入参数一致。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable field list --base-id \u003cbase-id\u003e --table-id \u003ctable-id\u003e" ], "group": "field", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_fields" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "field_list", "parameter_count": 3, "parameters": { "base-id": { "description": "Base ID（可通过 base list 获取）(必填)", "interface_description": "Base ID（可通过 list_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "field-ids": { "description": "待获取详情的字段 ID 列表（通过 table get 获取），逗号分隔；建议只传真正需要展开完整配置的字段，单次最多 10 个；不传则返回全部字段。建议优先显式传入，以控制返回体大小，避免上下文突增", "interface_description": "待获取详情的字段 ID 列表，可通过 get_tables 获取；建议只传真正需要展开完整配置的字段，单次最多 10 个；不传则默认返回当前表下全部字段。建议优先显式传入，以控制返回体大小，避免上下文突增", "interface_type": "array", "property": "fieldIds", "required": false, "type": "string" }, "table-id": { "description": "Table ID（可通过 base get 获取）(必填)", "interface_description": "Table ID（可通过 get_base 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.field_list", "primary_cli_path": "aitable field list", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "获取字段详情", "use_when": [ "批量获取指定字段的详细信息，包括 fieldId、名称、类型、description 以及类型相关完整配置（如格式化、选项、AI 配置等）。" ] }, "aitable.field_search_options": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.field_search_options", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "搜索指定单选/多选字段的 options 列表，支持按关键词模糊匹配（大小写不敏感、contains 模式）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除字段（不可逆，禁止删除主字段与最后一个字段）”请改用 dws aitable field delete", "要“在已有表格中批量新增字段”请改用 dws aitable field create", "要“批量获取字段详细信息（含完整配置）”请改用 dws aitable field get" ], "canonical_path": "aitable.field_search_options", "cli_name": "search-options", "cli_path": "aitable field search-options", "confirmation": "not_required", "description": "搜索指定单选/多选字段的 options 列表，支持按关键词模糊匹配（大小写不敏感、contains 模式）。\r\n目标字段必须是 singleSelect 或 multipleSelect 类型，否则返回错误。\r\n不传 keyword 时返回该字段全部 options。\r\n适用于 options 较多时按关键词缩小范围，避免通过 get_fields 拉取完整字段配置。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable field search-options --base-id \u003cbase-id\u003e --field-id \u003cfield-id\u003e --table-id \u003ctable-id\u003e" ], "group": "field", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "search_field_options" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "field_search_options", "parameter_count": 5, "parameters": { "base-id": { "description": "Base ID（通过 base list 获取）(必填)", "interface_description": "Base ID（可通过 list_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "field-id": { "description": "目标字段 ID，必须是 singleSelect 或 multipleSelect 类型；通过 table get / field get 获取 (必填)", "interface_description": "目标字段 ID，必须是 singleSelect 或 multipleSelect 类型的字段", "property": "fieldId", "required": true, "type": "string" }, "keyword": { "description": "模糊搜索关键词，大小写不敏感，按 contains 匹配 option name；不传则返回全部 options", "interface_description": "模糊搜索关键词，大小写不敏感，按 contains 匹配 option name；不传时返回全部 options", "property": "keyword", "required": false, "type": "string" }, "limit": { "description": "返回的最大 option 数量，默认 3000（全量返回），最大 3000；传入较小值可减少响应体积", "interface_description": "返回的最大 option 数量，默认 3000（即全量返回），最大 3000。传入较小值可减少响应体积、提升性能", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "table-id": { "description": "Table ID（通过 base get 获取）(必填)", "interface_description": "Table ID（可通过 get_base 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.field_search_options", "primary_cli_path": "aitable field search-options", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "搜索字段选项", "use_when": [ "搜索指定单选/多选字段的 options 列表，支持按关键词模糊匹配（大小写不敏感、contains 模式）。" ] }, "aitable.field_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.update_field", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-field.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新字段名称 / 配置 / AI 配置（至少传一项）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除字段（不可逆，禁止删除主字段与最后一个字段）”请改用 dws aitable field delete", "要“在已有表格中批量新增字段”请改用 dws aitable field create", "要“批量获取字段详细信息（含完整配置）”请改用 dws aitable field get" ], "canonical_path": "aitable.field_update", "cli_name": "update", "cli_path": "aitable field update", "confirmation": "not_required", "description": "更新指定字段的名称或配置。不可变更字段类型（type 不可修改）。\r\nnewFieldName、config、aiConfig 至少传入一项", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable field update --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e --field-id \u003cFIELD_ID\u003e --name \"新字段名\"", "dws aitable field update --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e --field-id \u003cFIELD_ID\u003e --config '{\"options\":[{\"name\":\"A\"},{\"name\":\"B\"}]}'" ], "group": "field", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_field" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "field_update", "parameter_count": 6, "parameters": { "ai-config": { "description": "更新后的 AI 配置 JSON，不修改 AI 配置时省略（与 MCP update_field.aiConfig 对齐）", "interface_description": "更新后的 AI 配置。传入时为整体替换，outputType 与 prompt 均为必填。不修改 AI 配置时省略。", "interface_type": "object", "property": "aiConfig", "required": false, "type": "string" }, "base-id": { "description": "Base ID（可通过 base list 获取）(必填)", "interface_description": "Base ID（可通过 list_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "config": { "description": "更新后的字段配置 JSON，结构与 field create 的 config 完全一致。不修改配置时省略。更新 singleSelect/multipleSelect 的 options 时需传入完整列表，系统以新列表整体覆盖；已有选项应回传原 id，新增选项无需传 id", "interface_description": "更新后的字段物理配置，结构与 create_fields.fields[].config 完全一致。\n不修改配置时省略。\n注意：更新 singleSelect/multipleSelect 的 options 时，需传入完整列表（含已有选项），系统以新列表整体覆盖，不是追加。\n注意：为避免已有单元格因 option id 变化而丢数据，更新时已有选项应尽量回传原 id；新增选项无需传 id。\n注意：如果请求中传入的 option id 在当前字段配置中不存在，系统会丢弃该 id，并按新增选项处理；若 id 合法但 name 改了，属于正常更新，会保留该 id。", "interface_type": "object", "property": "config", "required": false, "type": "string" }, "field-id": { "description": "Field ID（可通过 table get 获取）(必填)", "interface_description": "Field ID（可通过 get_tables 获取）", "property": "fieldId", "required": true, "type": "string" }, "name": { "description": "更新后的字段名称，最大100字。不修改名称时省略", "property": "name", "required": true, "type": "string" }, "table-id": { "description": "Table ID（可通过 base get 获取）(必填)", "interface_description": "Table ID（可通过 get_base 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.field_update", "primary_cli_path": "aitable field update", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "更新字段", "use_when": [ "字段/列/column；修改" ] }, "aitable.form_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-form.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "在指定数据表下创建一个新的表单视图（FormDesigner 类型）", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要在指定数据表下创建一个新的表单视图（FormDesigner 类型）时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_create", "cli_name": "create", "cli_path": "aitable form create", "confirmation": "not_required", "description": "在指定数据表下创建一个新的表单视图（FormDesigner 类型）。\n等价于 view create --view-type FormDesigner，但走 form 命令组对齐表单工作流。", "display": "AI 表格操作", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws aitable form create --base-id BASE_ID --table-id TABLE_ID --name \"员工信息收集\" --format json" ], "group": "form", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "form_create", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "property": "baseId", "required": true, "type": "string" }, "description": { "description": "表单描述（创建后可用 form update 调整）", "property": "description", "required": false, "type": "string" }, "name": { "description": "新表单名称 (必填)", "property": "name", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.form_create", "primary_cli_path": "aitable form create", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "创建表单视图", "use_when": [ "1) 创建表单 → 取返回的 data.viewId 作为 VIEW_ID" ] }, "aitable.form_delete": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "删除指定数据表下的表单视图（不可逆）", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要删除指定数据表下的表单视图（不可逆）时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_delete", "cli_name": "delete", "cli_path": "aitable form delete", "confirmation": "user_required", "description": "删除指定数据表下的表单视图（不可逆）。\n调用前建议先通过 form list 确认目标视图。", "display": "AI 表格操作", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws aitable form delete --help" ], "group": "form", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "form_delete", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标表单视图 ID（通过 form list 获取）(必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.form_delete", "primary_cli_path": "aitable form delete", "product_id": "aitable", "reviewed": false, "risk": "high", "source": "hardcoded:aitable", "title": "删除表单", "use_when": [ "删除指定数据表下的表单视图（不可逆）" ] }, "aitable.form_field_hide": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-form.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "切换表单视图中某个字段的隐藏/显示状态", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要切换表单视图中某个字段的隐藏/显示状态时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_field_hide", "cli_name": "hide", "cli_path": "aitable form field hide", "confirmation": "not_required", "description": "切换表单视图中某个字段的隐藏/显示状态。\n--hidden true：在表单中隐藏该字段（填写者不可见）\n--hidden false：显示该字段", "display": "AI 表格操作", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws aitable form field hide --base-id BASE_ID --table-id TABLE_ID --view-id VIEW_ID --field-id FIELD_ID --hidden true --format json" ], "group": "form.field", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "form_field_hide", "parameter_count": 5, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "property": "baseId", "required": true, "type": "string" }, "field-id": { "description": "目标字段 ID (必填)", "property": "fieldId", "required": true, "type": "string" }, "hidden": { "description": "true 隐藏字段，false 显示字段", "property": "hidden", "required": false, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标表单视图 ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.form_field_hide", "primary_cli_path": "aitable form field hide", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "切换表单字段隐藏", "use_when": [ "5) 隐藏不需要的题目" ] }, "aitable.form_field_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-form.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "列出指定表单视图当前可见的字段及其配置", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要列出指定表单视图当前可见的字段及其配置时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_field_list", "cli_name": "list", "cli_path": "aitable form field list", "confirmation": "not_required", "description": "列出指定表单视图当前可见的字段及其配置。\n返回每个字段的 fieldId、name、type、required、hidden、description。\n注意：hidden=true 的字段不会出现在此返回（它们在表单中已隐藏）；如需查看全部字段请用 field get。", "display": "AI 表格操作", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws aitable form field list --base-id BASE_ID --table-id TABLE_ID --view-id VIEW_ID --format json" ], "group": "form.field", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "form_field_list", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标表单视图 ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.form_field_list", "primary_cli_path": "aitable form field list", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "列出表单字段", "use_when": [ "3) 查看表单字段配置" ] }, "aitable.form_field_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-form.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "更新表单视图中某个字段的必填状态或描述", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要更新表单视图中某个字段的必填状态或描述时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_field_update", "cli_name": "update", "cli_path": "aitable form field update", "confirmation": "not_required", "description": "更新表单视图中某个字段的必填状态或描述。\n--required 或 --field-description 至少传入一项。", "display": "AI 表格操作", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws aitable form field update --base-id BASE_ID --table-id TABLE_ID --view-id VIEW_ID --field-id FIELD_ID --required true --format json" ], "group": "form.field", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "form_field_update", "parameter_count": 6, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "property": "baseId", "required": true, "type": "string" }, "field-description": { "description": "设置字段在表单中的描述文案", "property": "fieldDescription", "required": false, "type": "string" }, "field-id": { "description": "目标字段 ID（通过 form field list 获取）(必填)", "property": "fieldId", "required": true, "type": "string" }, "required": { "description": "设置字段在表单中的必填状态 (true/false)", "property": "required", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标表单视图 ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.form_field_update", "primary_cli_path": "aitable form field update", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "更新表单字段", "use_when": [ "4) 设置题目必填（FIELD_ID 来自步骤 2）" ] }, "aitable.form_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-form.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "按 viewId 获取单个表单视图的元信息（name/title/createdAt/shareFormUuid）", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要按 viewId 获取单个表单视图的元信息（name/title/createdAt/shareFormUuid）时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_get", "cli_name": "get", "cli_path": "aitable form get", "confirmation": "not_required", "description": "按 viewId 获取单个表单视图的元信息（name/title/createdAt/shareFormUuid）。\n内部拉取 list_form_views 后在客户端按 viewId 精确筛出单条（服务端的 viewIds\n过滤参数当前不生效，会返回全表所有表单，故在此侧过滤）。data 即命中的表单对象。", "display": "AI 表格操作", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws aitable form get --base-id BASE_ID --table-id TABLE_ID --view-id VIEW_ID --format json" ], "group": "form", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "form_get", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标表单视图 ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.form_get", "primary_cli_path": "aitable form get", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "获取单个表单视图详情", "use_when": [ "2) 查看单个表单详情" ] }, "aitable.form_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-form.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "列出指定数据表下的所有表单视图", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要列出指定数据表下的所有表单视图时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_list", "cli_name": "list", "cli_path": "aitable form list", "confirmation": "not_required", "description": "列出指定数据表下的所有表单视图。每个表单视图返回 viewId、name、title、createdAt（shareFormUuid 不在此返回，需 form share get 单独获取）。", "display": "AI 表格操作", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws aitable form list --base-id BASE_ID --table-id TABLE_ID --format json" ], "group": "form", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "form_list", "parameter_count": 2, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.form_list", "primary_cli_path": "aitable form list", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "列出表单视图", "use_when": [ "1) 列出数据表下的表单视图" ] }, "aitable.form_questions_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-form.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "在数据表中创建字段，即向表单添加题目", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要在数据表中创建字段，即向表单添加题目时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_questions_create", "cli_name": "create", "cli_path": "aitable form questions create", "confirmation": "not_required", "description": "在数据表中创建字段，即向表单添加题目。\n入参与 `field create` 完全一致：可用 --fields 批量创建，或 --name + --type 单题模式。\n若需将题目设为必填，创建后请用 form field update --required true 单独设置。", "display": "AI 表格操作", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws aitable form questions create --base-id BASE_ID --table-id TABLE_ID --fields '[{\"fieldName\":\"姓名\",\"type\":\"text\"},{\"fieldName\":\"邮箱\",\"type\":\"text\"}]' --format json" ], "group": "form.questions", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "form_questions_create", "parameter_count": 7, "parameters": { "ai-config": { "description": "单字段 AI 配置 JSON（如 outputType/prompt，配合 --name/--type 使用）", "property": "aiConfig", "required": false, "type": "string" }, "base-id": { "description": "Base ID（通过 base list 获取）(必填)", "property": "baseId", "required": true, "type": "string" }, "config": { "description": "单字段的额外配置 JSON（如 options，配合 --name/--type 使用）", "property": "config", "required": false, "type": "string" }, "fields": { "description": "待新增字段列表 JSON 数组，至少包含 1 个字段，单次最多 15 个。系统会按数组顺序依次创建，返回结果顺序与入参保持一致，并逐项标明成功/失败状态。若是单个字段可直接使用 --name/--type/--config", "property": "fields", "required": false, "type": "string" }, "name": { "description": "要创建的单字段名称（与 --type 配合使用，替代 --fields）", "property": "name", "required": false, "type": "string" }, "table-id": { "description": "Table ID（通过 base get 获取）(必填)", "property": "tableId", "required": true, "type": "string" }, "type": { "description": "要创建的单字段类型（需要配合 --name，参考 table create 的内置类型）", "property": "type", "required": false, "type": "string" } }, "path": "aitable.form_questions_create", "primary_cli_path": "aitable form questions create", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "向表单添加题目（等价于 field create）", "use_when": [ "2) 添加题目 → 取返回的 data.results[].fieldId 作为 FIELD_ID" ] }, "aitable.form_questions_delete": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "删除指定字段（即表单题目）", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要删除指定字段（即表单题目）时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_questions_delete", "cli_name": "delete", "cli_path": "aitable form questions delete", "confirmation": "user_required", "description": "删除指定字段（即表单题目）。**不可逆**。\n入参与 `field delete` 完全一致：必须传 --field-id；目前 MCP 不支持批量删除，需多次调用。", "display": "AI 表格操作", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws aitable form questions delete --help" ], "group": "form.questions", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "form_questions_delete", "parameter_count": 3, "parameters": { "base-id": { "description": "Base ID（通过 base list 获取）(必填)", "property": "baseId", "required": true, "type": "string" }, "field-id": { "description": "待删除字段 ID（通过 table get 获取）(必填)", "property": "fieldId", "required": true, "type": "string" }, "table-id": { "description": "Table ID（通过 base get 获取）(必填)", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.form_questions_delete", "primary_cli_path": "aitable form questions delete", "product_id": "aitable", "reviewed": false, "risk": "high", "source": "hardcoded:aitable", "title": "从表单删除题目（等价于 field delete，不可逆）", "use_when": [ "删除指定字段（即表单题目）" ] }, "aitable.form_share_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-form.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "读取指定视图当前的分享表单配置", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要读取指定视图当前的分享表单配置时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_share_get", "cli_name": "get", "cli_path": "aitable form share get", "confirmation": "not_required", "description": "读取指定视图当前的分享表单配置。\n返回 enabled（是否开启）、status、shareFormUuid、formName 等信息。\n若该视图尚未开启分享表单，enabled=false、status=0。", "display": "AI 表格操作", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws aitable form share get --base-id BASE_ID --table-id TABLE_ID --view-id VIEW_ID --format json" ], "group": "form.share", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "form_share_get", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标表单视图 ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.form_share_get", "primary_cli_path": "aitable form share get", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "获取表单分享配置", "use_when": [ "4) 查看分享配置" ] }, "aitable.form_share_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-form.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "开启或关闭指定视图的分享表单", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要开启或关闭指定视图的分享表单时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_share_update", "cli_name": "update", "cli_path": "aitable form share update", "confirmation": "not_required", "description": "开启或关闭指定视图的分享表单。\n--enabled true 表示开启分享，--enabled false 表示关闭分享。", "display": "AI 表格操作", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws aitable form share update --base-id BASE_ID --table-id TABLE_ID --view-id VIEW_ID --enabled true --format json" ], "group": "form.share", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "form_share_update", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "property": "baseId", "required": true, "type": "string" }, "enabled": { "description": "分享开关：true 开启，false 关闭 (必填)", "property": "enabled", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标表单视图 ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.form_share_update", "primary_cli_path": "aitable form share update", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "开启/关闭分享表单", "use_when": [ "6) 开启分享（注意：开启后需 UI 刷新页面才会看到分享面板）" ] }, "aitable.form_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-form.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "更新表单整体配置（标题、描述）", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要更新表单整体配置（标题、描述）时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.form_update", "cli_name": "update", "cli_path": "aitable form update", "confirmation": "not_required", "description": "更新表单整体配置（标题、描述）。\n--title（或其等价别名 --name）和 --description 至少传入一项。\n--title 与 --name 完全等价；同时传入时以 --title 优先。", "display": "AI 表格操作", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws aitable form update --base-id BASE_ID --table-id TABLE_ID --view-id VIEW_ID --title \"员工信息收集\" --description \"请填写您的基本信息\" --format json" ], "group": "form", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "form_update", "parameter_count": 6, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "property": "baseId", "required": true, "type": "string" }, "description": { "description": "表单描述", "property": "description", "required": false, "type": "string" }, "name": { "description": "表单标题（与 --title 等价）", "property": "name", "required": false, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "property": "tableId", "required": true, "type": "string" }, "title": { "description": "表单标题（与 --name 等价，二选一）", "property": "title", "required": false, "type": "string" }, "view-id": { "description": "目标表单视图 ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.form_update", "primary_cli_path": "aitable form update", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "更新表单配置", "use_when": [ "3) 配置表单标题与描述" ] }, "aitable.import_data": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.import_data", "skills/mono/references/products/aitable/aitable-export-import.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "触发导入并等待结果；每个 Sheet 新建为独立表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“申请导入文件 OSS 直传地址，返回 uploadUrl 与 i”请改用 dws aitable import upload" ], "canonical_path": "aitable.import_data", "cli_name": "data", "cli_path": "aitable import data", "confirmation": "not_required", "description": "将已通过 prepare_import_upload 上传完成的文件导入 AI 表格。支持两种模式：\r\n1. 新建表导入（默认）：不传 tableId，文件中的每个工作表新建为独立的数据表。导入成功时返回新增数据表的 tableIds。\r\n2. 追加导入：传入 tableId，数据追加到该已有数据表的末尾，不会新建表。可通过 fieldMapping 指定文件列名与目标表字段的映射关系；不传 fieldMapping 则按列名自动匹配。多 Sheet 文件可通过 srcSheetName 指定源 Sheet。\r\n工具内部会等待导入完成，大多数情况下一次调用即可拿到最终结果。若在 timeout 内未完成，再次传入相同 importId 继续等待，无需重新提交任务，也不要重新上传同一文件。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable import data --import-id \u003cimportId\u003e --format json", "dws aitable import data --import-id \u003cimportId\u003e --table-id \u003cTABLE_ID\u003e --format json" ], "group": "import", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "import_data" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "import_data", "parameter_count": 6, "parameters": { "field-mapping": { "description": "字段映射关系 JSON 对象。key 为目标表的字段名，value 为源文件中的列名。不传则按列名自动匹配", "interface_description": "可选，字段映射关系。key 为目标表的字段名，value 为源文件中的列名。仅追加导入模式生效。不传则按列名自动匹配", "interface_type": "object", "property": "fieldMapping", "required": false, "type": "string" }, "header-row": { "description": "表头所在行号（从 1 开始），数据从 headerRow 的下一行开始读取。不传则自动识别表头行", "interface_description": "可选，表头所在行号（从 1 开始，1 表示第一行）。数据将从 headerRow 的下一行开始读取。不传则自动识别表头行", "interface_type": "number", "property": "headerRow", "required": false, "type": "integer" }, "import-id": { "description": "prepare_import_upload 返回的 importId (必填)", "interface_description": "prepare_import_upload 返回的 importId", "property": "importId", "required": true, "type": "string" }, "src-sheet-name": { "description": "源文件中的 Sheet 名称。多 Sheet 文件时指定从哪个 Sheet 导入数据。不传则默认使用第一个 Sheet", "interface_description": "可选，源文件中的 Sheet 名称。当文件包含多个 Sheet 时，用于指定从哪个 Sheet 导入数据。不传则默认使用第一个 Sheet", "property": "srcSheetName", "required": false, "type": "string" }, "table-id": { "description": "目标数据表 ID。传入后数据将作为新行追加到该表中；不传则默认新建表导入", "interface_description": "可选，目标数据表 ID。传入后数据将作为新行追加到该已有表中，而非新建表。不传则默认新建表导入", "property": "tableId", "required": false, "type": "string" }, "timeout": { "description": "最长等待时间（秒），默认且推荐使用最大值 30", "interface_description": "可选，本次调用的最长等待时间（秒），默认且推荐使用最大值 30。最小 5，最大 30。超时后若任务仍未完成，再次传入相同 importId 继续等待", "interface_type": "number", "property": "timeout", "required": false, "type": "integer" } }, "path": "aitable.import_data", "primary_cli_path": "aitable import data", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "导入数据", "use_when": [ "第 3 步（替代）：追加到已有表", "第 3 步：触发导入（新建表模式）", "续等导入" ] }, "aitable.import_upload": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.prepare_import_upload", "skills/mono/references/products/aitable/aitable-export-import.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "申请导入文件 OSS 直传地址，返回 uploadUrl 与 importId", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“触发导入并等待结果；每个 Sheet 新建为独立表”请改用 dws aitable import data" ], "canonical_path": "aitable.import_upload", "cli_name": "upload", "cli_path": "aitable import upload", "confirmation": "not_required", "description": "为导入任务申请 OSS 直传地址。返回 uploadUrl 和 importId。\r\n客户端应通过 HTTP PUT 将原始文件字节流上传至 uploadUrl；除非 uploadUrl 对应的存储服务明确要求，否则不要额外附带 Content-Type 等自定义请求头。上传完成后将 importId 传入 import_data 即可触发导入，无需再传其他参数。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable import upload --base-id \u003cBASE_ID\u003e --file-name data.xlsx --file-size \u003c字节数\u003e --format json", "dws aitable import upload --base-id BASE_ID --file-name data.xlsx --file-size 204800" ], "group": "import", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "prepare_import_upload" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "import_upload", "parameter_count": 3, "parameters": { "base-id": { "description": "Base ID (必填)", "interface_description": "Base ID，可通过 list_bases 或 search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "file-name": { "description": "文件名，须带扩展名，如 data.xlsx (必填)", "interface_description": "文件名，须带扩展名，例如 data.xlsx。扩展名将作为导入格式依据", "property": "fileName", "required": true, "type": "string" }, "file-size": { "description": "文件大小（字节数）(必填)", "interface_description": "文件大小（字节数）", "interface_type": "number", "property": "fileSize", "required": true, "type": "integer" } }, "path": "aitable.import_upload", "primary_cli_path": "aitable import upload", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "准备导入文件上传", "use_when": [ "第 1 步：申请上传凭证" ] }, "aitable.info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.info", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取指定 Base 的资源目录级信息，返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定 Base 的资源目录级信息，返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。”" ], "canonical_path": "aitable.info", "cli_name": "info", "cli_path": "aitable info", "confirmation": "not_required", "description": "获取指定 Base 的资源目录级信息，返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。\r\n这是当前 Base 级目录入口：后续如需 tableId 或 dashboardId，优先从这里读取；table 详情再调用 get_tables，dashboard 详情再调用 get_dashboard", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable info --base-id \u003cbase-id\u003e" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_base" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "info", "parameter_count": 1, "parameters": { "base-id": { "description": "Base 唯一标识。优先使用 base search / base list 返回值 (必填)", "interface_description": "Base 唯一标识。优先使用 search_bases/list_bases 返回值", "property": "baseId", "required": true, "type": "string" } }, "path": "aitable.info", "primary_cli_path": "aitable info", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "获取 AI 表格信息", "use_when": [ "获取指定 Base 的资源目录级信息，返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。" ] }, "aitable.list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.list", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "列出当前用户可访问的 AI 表格 Base。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出当前用户可访问的 AI 表格 Base。”" ], "canonical_path": "aitable.list", "cli_name": "list", "cli_path": "aitable list", "confirmation": "not_required", "description": "列出当前用户可访问的 AI 表格 Base。默认返回最近访问结果，支持分页游标续取。返回 baseId 与 baseName，后续可直接用于 get_base。\r\nAI 表格访问地址可按 baseId 拼接为：https://docs.dingtalk.com/i/nodes/{baseId}", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable list" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "list_bases" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list", "parameter_count": 2, "parameters": { "cursor": { "description": "首次不传；传入上次返回的游标继续获取下一页", "property": "cursor", "required": false, "type": "string" }, "limit": { "description": "每页数量，默认 10，最大 10", "interface_type": "number", "property": "limit", "required": false, "type": "integer" } }, "path": "aitable.list", "primary_cli_path": "aitable list", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "获取 AI 表格列表", "use_when": [ "列出当前用户可访问的 AI 表格 Base。" ] }, "aitable.query_records": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.query_records", "skills/mono/references/products/aitable-record-ops.md", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-record-query.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询记录（支持按 ID 取或 filters/sort/分页遍历）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "aitable record list" ], "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询指定表格中的记录，支持两种模式： 按 ID 取：传入 rec”请改用 dws aitable record get" ], "canonical_path": "aitable.query_records", "cli_name": "query", "cli_path": "aitable record query", "confirmation": "not_required", "description": "查询 AI 表格记录。默认返回单页；传 --all 时自动翻页累计全部记录。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable record query --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e --format json", "dws aitable record query --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e --filters '{\"operator\":\"and\",\"operands\":[{\"operator\":\"eq\",\"operands\":[\"fld_state\",\"进行中\"]}]}' --format json" ], "group": "record", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "query_records" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_records", "parameter_count": 11, "parameters": { "all": { "description": "自动翻页获取全部记录。传入时自动循环直到无更多数据或达到 --page-limit 上限", "property": "all", "required": false, "type": "boolean" }, "base-id": { "description": "Base ID。", "interface_description": "Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "cursor": { "description": "分页游标，首次查询不传；cursor 为空表示已取完全部记录", "interface_description": "可选。分页游标，首次查询不传。当返回结果包含 cursor 字段时，将其传入下一次请求以获取后续数据；\ncursor 为空表示已取完全部记录。", "property": "cursor", "required": false, "type": "string" }, "field-ids": { "description": "Field ID 列表，CLI 使用逗号分隔。", "interface_description": "可选。指定要返回的字段 ID 列表。省略则返回所有字段（不包括计算字段、查找引用字段、其他引用关联字段）。建议在字段较多时按需传入，可显著减少响应体积；单次最多 100 个，如果当前表里有公式、查找引用、关联引用等计算字段，则必须传具体的字段 ID，否则默认不传获取所有字段的时候不会获取计算相关字段。", "interface_type": "array", "property": "fieldIds", "required": false, "type": "string" }, "filters": { "description": "过滤条件 JSON。", "interface_description": "结构化过滤条件，不传则返回全部记录（受 limit 限制）", "interface_type": "object", "property": "filters", "required": false, "type": "string" }, "limit": { "description": "单次返回的最大记录数，默认 100，最大 100", "interface_description": "可选。单次返回的最大记录数，默认 100，最大 100。", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "page-limit": { "default": "50", "description": "自动翻页最大页数（仅 --all 时生效）。默认 50 页（5000 条），设为 0 表示无限制", "property": "pageLimit", "required": false, "type": "integer" }, "query": { "description": "全文关键词。将对整表内容做文本匹配搜索，并返回符合条件的记录", "property": "query", "required": false, "type": "string" }, "record-ids": { "description": "Record ID 列表，CLI 使用逗号分隔。", "interface_description": "可选。指定要获取的记录 ID 列表，单次最多 100 个。传入时直接按 ID 返回，忽略 filters 和 sort。\n适用于已知 recordId（如关联字段中的 linkedRecordIds）时的精准取数。", "interface_type": "array", "property": "recordIds", "required": true, "type": "string" }, "sort": { "description": "排序 JSON 数组。", "interface_description": "可选。排序条件列表，按数组顺序依次生效。\n\n每个元素：{\"fieldId\": \"\u003cfieldId\u003e\", \"direction\": \"asc\" | \"desc\"}\n\n示例（先按优先级升序，再按截止日期降序）：\n[\n {\"fieldId\": \"fldPriorityId\", \"direction\": \"asc\"},\n {\"fieldId\": \"fldDueDateId\", \"direction\": \"desc\"}\n]", "interface_type": "array", "property": "sort", "required": false, "type": "string" }, "table-id": { "description": "Table ID。", "interface_description": "Table ID（通过 get_base 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.query_records", "primary_cli_path": "aitable record query", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "query_records", "use_when": [ "4. 查询记录", "从上次断点继续", "关键词搜索", "按 ID 查询", "无限制（拉完为止）", "游标分页", "示例：基础条件查询模板（可改内部 operator 为 contain 等）", "记录/行/数据/row；查看/搜索", "默认（最多 50 页 = 5000 条）" ] }, "aitable.record_batch_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "将同一份 cells JSON 批量应用到多条记录上", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要将同一份 cells JSON 批量应用到多条记录上时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "aitable.record_batch_update", "cli_name": "batch-update", "cli_path": "aitable record batch-update", "confirmation": "not_required", "description": "将同一份 cells JSON 批量应用到多条记录上。适合\"统一标记完成 / 统一改负责人 / 统一清空某字段\"等场景。\n\n与 record update 的区别：\n - record update 每条记录可有不同 cells，参数是 records JSON 数组\n - record batch-update 所有记录共享同一份 cells（CLI 客户端展开后调用相同 MCP 工具）\n\n单次最多 100 条；超出请拆分多次调用。\ncells 写入格式与 record update / record create 相同（详见 record create --help）。\n只读字段（formula / filterUp / lookup / 系统字段）不能写入。\n\nCLI 行为：客户端把 --record-ids 拆开后构造 [{recordId, cells}, ...] 调用 update_records；\n当前服务端尚未提供 broadcast patch 工具，所以本命令是纯语义包装，不省网络体积，仅省 LLM 构造 prompt 的 token。", "display": "AI 表格操作", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws aitable record batch-update --help" ], "group": "record", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "record_batch_update", "parameter_count": 4, "parameters": { "base-id": { "description": "Base ID，可通过 base list 或 base search 获取 (必填)", "property": "baseId", "required": true, "type": "string" }, "cells": { "description": "要应用到所有记录的 cells JSON 对象（共享 patch），如 '{\"fldStatusId\":\"已完成\"}' (必填)", "property": "cells", "required": true, "type": "string" }, "record-ids": { "description": "待更新的记录 ID 列表，逗号分隔，单次最多 100 条 (必填)", "property": "recordIds", "required": true, "type": "string" }, "table-id": { "description": "Table ID，可通过 base get 获取 (必填)", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.record_batch_update", "primary_cli_path": "aitable record batch-update", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "批量更新记录（同一 cells 应用到多条 recordId）", "use_when": [ "将同一份 cells JSON 批量应用到多条记录上" ] }, "aitable.record_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.create_records", "skills/mono/references/products/aitable-record-ops.md", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-attachment.md", "skills/mono/references/products/aitable/aitable-record-create.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量新增记录（单次最多 100 条）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“查询指定表格中的记录，支持两种模式： 按 ID 取：传入 rec”请改用 dws aitable record get", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_create", "cli_name": "create", "cli_path": "aitable record create", "confirmation": "not_required", "description": "在指定表格中批量新增记录", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable record create --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e --records '[{\"cells\":{\"fldABC\":\"完成设计\",\"fldDEF\":\"进行中\"}}]' --format json", "dws aitable record create --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e --records '[" ], "group": "record", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_records" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "record_create", "parameter_count": 4, "parameters": { "base-id": { "description": "Base ID，可通过 base list 或 base search 获取 (必填)", "interface_description": "Base ID，可通过 list_bases 或 search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "records": { "description": "待创建的记录列表 JSON 数组，单次最多 100 条 (必填)", "interface_description": "待创建的记录列表，单次最多 100 条", "interface_type": "array", "property": "records", "required": true, "type": "string" }, "records-file": { "description": "从文件读取 records JSON（替代 --records，适合 Windows 或超长数据）", "property": "recordsFile", "required": false, "type": "string" }, "table-id": { "description": "Table ID，可通过 base get 获取 (必填)", "interface_description": "Table ID，可通过 get_base 获取", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.record_create", "primary_cli_path": "aitable record create", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "新增记录", "use_when": [ "5. 新增记录 (cells 用 fieldId 作 key)", "再用 fieldId 写入记录", "单条", "多条", "步骤 2: 在 record create/update 中使用 fileToken 写入", "步骤 2: 在 record create/update 中使用 fileToken 写入附件字段", "记录/行/数据/row；添加/写入" ] }, "aitable.record_delete": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.delete_records", "skills/mono/SKILL.md", "skills/mono/references/products/aitable-record-ops.md", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-record-delete.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量删除记录（不可逆，单次最多 100 条）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询指定表格中的记录，支持两种模式： 按 ID 取：传入 rec”请改用 dws aitable record get", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_delete", "cli_name": "delete", "cli_path": "aitable record delete", "confirmation": "user_required", "description": "在指定 Table 中批量删除记录（不可逆，数据将永久丢失）。\r\n单次最多删除 100 条；超出请拆分多次调用。\r\n调用前建议先通过 query_records 确认目标记录 ID 与内容，避免误删。", "display": "AI 表格操作", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws aitable record delete --base-id \u003cbase-id\u003e --record-ids \u003crecord-ids\u003e --table-id \u003ctable-id\u003e" ], "group": "record", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_records" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "record_delete", "parameter_count": 3, "parameters": { "base-id": { "description": "Base ID，可通过 base list 或 base search 获取 (必填)", "interface_description": "Base ID，可通过 list_bases 或 search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "record-ids": { "description": "待删除的记录 ID 列表，逗号分隔，最多 100 条 (必填)", "interface_description": "待删除的记录 ID 列表，最多 100 条", "interface_type": "array", "property": "recordIds", "required": true, "type": "string" }, "table-id": { "description": "Table ID，可通过 base get 获取 (必填)", "interface_description": "Table ID，可通过 get_base 获取", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.record_delete", "primary_cli_path": "aitable record delete", "product_id": "aitable", "risk": "high", "source": "hardcoded:aitable", "title": "删除行记录", "use_when": [ "记录/行/数据/row；删除" ] }, "aitable.record_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.record_get", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询指定表格中的记录，支持两种模式： 按 ID 取：传入 recordIds（单次最多 100 个），直接获取指定记录。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_get", "cli_name": "get", "cli_path": "aitable record get", "confirmation": "not_required", "description": "查询指定表格中的记录，支持两种模式：\r\n- 按 ID 取：传入 recordIds（单次最多 100 个），直接获取指定记录。\r\n- 条件查：通过 filters 过滤、sort 排序、cursor 分页遍历全表。\r\n两种模式均可通过 fieldIds（单次最多 100 个）限制返回字段以节省 token。\r\n如果需要获取计算、查找引用等字段则必须传fieldIds的列ID或者列名称才会返回", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable record get --base-id \u003cbase-id\u003e --record-ids \u003crecord-ids\u003e --table-id \u003ctable-id\u003e" ], "group": "record", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "query_records" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "record_get", "parameter_count": 4, "parameters": { "base-id": { "description": "Base ID（通过 base list / base search 获取）(必填)", "interface_description": "Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "field-ids": { "description": "指定要返回的字段 ID 列表，逗号分隔。省略则返回所有字段。建议在字段较多时按需传入，可显著减少响应体积；单次最多 100 个", "interface_description": "可选。指定要返回的字段 ID 列表。省略则返回所有字段（不包括计算字段、查找引用字段、其他引用关联字段）。建议在字段较多时按需传入，可显著减少响应体积；单次最多 100 个，如果当前表里有公式、查找引用、关联引用等计算字段，则必须传具体的字段 ID，否则默认不传获取所有字段的时候不会获取计算相关字段。", "interface_type": "array", "property": "fieldIds", "required": false, "type": "string" }, "record-ids": { "description": "指定要获取的记录 ID 列表，逗号分隔，单次最多 100 个。传入时按 ID 返回，忽略 filters 和 sort。适用于已知 recordId（如关联字段中的 linkedRecordIds）时的精准取数", "interface_description": "可选。指定要获取的记录 ID 列表，单次最多 100 个。传入时直接按 ID 返回，忽略 filters 和 sort。\n适用于已知 recordId（如关联字段中的 linkedRecordIds）时的精准取数。", "interface_type": "array", "property": "recordIds", "required": true, "type": "string" }, "table-id": { "description": "Table ID（通过 base get 获取）(必填)", "interface_description": "Table ID（通过 get_base 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.record_get", "primary_cli_path": "aitable record get", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "query_records", "use_when": [ "记录/行/数据/row；已知 recordId 反查字段值" ] }, "aitable.record_history_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.record_history_list", "skills/mono/references/products/aitable/aitable-record-history.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询指定行记录的变更历史列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_history_list", "cli_name": "history-list", "cli_path": "aitable record history-list", "confirmation": "not_required", "description": "查询指定行记录的变更历史列表。返回该记录的字段变更、操作人（unionId）、操作时间等信息。\r\n操作人已完成身份脱敏，仅透出 unionId。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable record history-list --base-id BASE_ID --table-id TABLE_ID --record-id REC_ID [--offset N] [--limit M]", "dws aitable record history-list --base-id BASE --table-id TBL --record-id REC --format json | jq '.data.histories[] | {version, action, operateTime}'" ], "group": "record", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "query_record_history" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "record_history_list", "parameter_count": 5, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "目标 Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "limit": { "description": "每页返回数量，默认 20，最大 50", "interface_description": "每页获取数量，默认 20，最大 50", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "offset": { "description": "分页偏移量，默认 0", "interface_type": "number", "property": "offset", "required": false, "type": "integer" }, "record-id": { "description": "目标 Record ID (必填)", "interface_description": "要查询变更历史的目标记录 ID", "property": "recordId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "目标 Table ID（通过 get_base / list_tables 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.record_history_list", "primary_cli_path": "aitable record history-list", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "查询行记录变更历史", "use_when": [ "第 1 页（最新 20 条）", "第 2 页" ] }, "aitable.record_primary_doc_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.record_primary_doc_create", "skills/mono/references/products/aitable/aitable-primary-doc.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "为指定记录创建主键文档（幂等：若该记录已有主键文档则直接返回已有文档的 nodeId）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_primary_doc_create", "cli_name": "primary-doc-create", "cli_path": "aitable record primary-doc-create", "confirmation": "not_required", "description": "为指定记录创建主键文档（幂等：若该记录已有主键文档则直接返回已有文档的 nodeId）。\\n必填 baseId、tableId、fieldId、recordId。\\n返回创建或已存在的主键文档 nodeId，可直接用于钉钉文档 MCP 的 nodeId 参数。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable record primary-doc-create --base-id BASE_ID --table-id TABLE_ID --field-id FIELD_ID --record-id RECORD_ID" ], "group": "record", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "create_primary_doc" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "record_primary_doc_create", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "目标 Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "field-id": { "description": "主键字段 ID，必须是 primaryDoc 类型 (必填)", "interface_description": "主键字段 ID，必须是 primaryDoc 类型（通过 get_tables / get_fields 获取）", "property": "fieldId", "required": true, "type": "string" }, "record-id": { "description": "目标 Record ID (必填)", "interface_description": "目标记录 ID", "property": "recordId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "目标 Table ID（通过 get_base 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.record_primary_doc_create", "primary_cli_path": "aitable record primary-doc-create", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "创建主键文档", "use_when": [ "2. 为某条记录创建主键文档" ] }, "aitable.record_primary_doc_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.record_primary_doc_get", "skills/mono/references/products/aitable/aitable-primary-doc.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询指定记录的主键文档信息。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_primary_doc_get", "cli_name": "primary-doc-get", "cli_path": "aitable record primary-doc-get", "confirmation": "not_required", "description": "查询指定记录的主键文档信息。根据 baseId、tableId、recordId 返回该记录关联的主键文档 nodeId。若记录尚未创建主键文档，nodeId 为 null。返回的 nodeId 可直接用于钉钉文档 MCP 的 nodeId 参数。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable record primary-doc-get --base-id BASE_ID --table-id TABLE_ID --record-id RECORD_ID" ], "group": "record", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_primary_doc" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "record_primary_doc_get", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "目标 Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "record-id": { "description": "目标 Record ID (必填)", "interface_description": "目标记录 ID", "property": "recordId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "目标 Table ID（通过 get_base 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.record_primary_doc_get", "primary_cli_path": "aitable record primary-doc-get", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "查询主键文档信息", "use_when": [ "查询指定记录的主键文档信息。" ] }, "aitable.record_query_empty": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.record_query_empty", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询指定表格中\"完全没填用户字段\"的空行。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_query_empty", "cli_name": "query-empty", "cli_path": "aitable record query-empty", "confirmation": "not_required", "description": "查询指定表格中\"完全没填用户字段\"的空行。\r\n- 按表内顺序扫描一页（limit 默认 100，最大 100），内存中过滤出空行返回。\r\n- 空行定义：除系统字段（recordId / 创建人 / 创建时间 / 修改人 / 修改时间）外，\r\n 所有 cell 都是 null、空字符串、空集合或空 Map。\r\n- cursor 行为同 query_records：若返回的 nextCursor 非空，需要把它传回继续翻页。\r\n- 注意：本页 records 为空数组不代表全表无空行；只有当 nextCursor 也为空时才表示扫完全表。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable record query-empty --base-id \u003cbase-id\u003e --table-id \u003ctable-id\u003e" ], "group": "record", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "query_empty_records" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "record_query_empty", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "cursor": { "description": "分页游标。首次不传；返回 nextCursor 非空时把它传回继续扫", "interface_description": "可选。分页游标，首次查询不传。当返回结果包含 cursor 字段时，将其传入下一次请求以获取后续数据；cursor 为空表示已取完全部记录。", "property": "cursor", "required": false, "type": "string" }, "limit": { "description": "单次扫描的最大记录数（扫描预算，非返回数）；范围 [1, 100]，默认 100", "interface_description": "可选。单次扫描的最大记录数，默认 100，最大 100。该值是扫描预算而非返回数，可能扫到 100 条但全部非空。", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "Table ID（通过 get_base 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.record_query_empty", "primary_cli_path": "aitable record query-empty", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "查询空行", "use_when": [ "查询指定表格中\"完全没填用户字段\"的空行。" ] }, "aitable.record_share_url": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.record_share_url", "skills/mono/references/products/aitable/aitable-record-share.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取指定行记录的分享链接，可用于将记录分享给他人。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_share_url", "cli_name": "share-url", "cli_path": "aitable record share-url", "confirmation": "not_required", "description": "获取指定行记录的分享链接，可用于将记录分享给他人。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable record share-url --base-id BASE_ID --table-id TABLE_ID --record-ids rec1,rec2,rec3 [--view-id VIEW_ID]", "dws aitable record share-url --base-id BASE --table-id TBL --record-ids rec1" ], "group": "record", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_record_share_url" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "record_share_url", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "目标 Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "record-ids": { "description": "目标 Record ID 列表，逗号分隔，单次最多 20 条 (必填)", "interface_description": "目标记录 ID 列表，单次最多 20 条", "interface_type": "array", "property": "recordIds", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "目标 Table ID（通过 get_base / list_tables 获取）", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "视图 ID（可选，用于生成带视图上下文的分享链接）", "interface_description": "可选，视图 ID，用于生成带视图上下文的分享链接", "property": "viewId", "required": false, "type": "string" } }, "path": "aitable.record_share_url", "primary_cli_path": "aitable record share-url", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "get_record_share_url", "use_when": [ "一次拿一条记录的链接", "带视图上下文（链接打开时落在指定视图）", "批量拿，配合 jq 过滤出 url" ] }, "aitable.record_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.update_records", "skills/mono/references/products/aitable-record-ops.md", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-attachment.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量更新记录（单次最多 100 条）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_update", "cli_name": "update", "cli_path": "aitable record update", "confirmation": "not_required", "description": "批量更新指定记录的字段值，只需传入需修改的字段，未传入的字段保持原值", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable record update --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e --records '[{\"recordId\":\"rec001\",\"cells\":{\"fldDEF\":\"已完成\"}}]' --format json", "dws aitable record update --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e --records '[{\"recordId\":\"recXXX\",\"cells\":{\"fldAttachId\":[{\"fileToken\":\"ft_xxx\"}]}}]' --format json" ], "group": "record", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_records" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "record_update", "parameter_count": 4, "parameters": { "base-id": { "description": "Base ID，可通过 base list 或 base search 获取 (必填)", "interface_description": "Base ID，可通过 list_bases 或 search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "records": { "description": "待更新的记录内容列表 JSON 数组，单次最多 100 条 (必填)", "interface_description": "待更新的记录内容列表，单次最多 100 条", "interface_type": "array", "property": "records", "required": true, "type": "string" }, "records-file": { "description": "从文件读取 records JSON（替代 --records，适合 Windows 或超长数据）", "property": "recordsFile", "required": false, "type": "string" }, "table-id": { "description": "Table ID，可通过 base get 获取 (必填)", "interface_description": "Table ID，可通过 get_base 获取", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.record_update", "primary_cli_path": "aitable record update", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "更新记录", "use_when": [ "3. 写入记录", "记录/行/数据/row；修改/更新" ] }, "aitable.record_upsert": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.record_upsert", "skills/mono/references/products/aitable/aitable-record-upsert.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量创建或更新记录（Upsert 语义）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量删除记录（不可逆，单次最多 100 条）”请改用 dws aitable record delete", "要“批量新增记录（单次最多 100 条）”请改用 dws aitable record create", "要“查询记录（支持按 ID 取或 filters/sort/分页遍历”请改用 dws aitable record query" ], "canonical_path": "aitable.record_upsert", "cli_name": "upsert", "cli_path": "aitable record upsert", "confirmation": "not_required", "description": "批量创建或更新记录（Upsert 语义）。传入一批记录，带 recordId 的走更新逻辑，不带 recordId 的走创建逻辑，服务端自动拆分并分别执行。\r\n单次请求的记录总数（创建 + 更新）不得超过 100 条。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable record upsert --base-id BASE_ID --table-id TABLE_ID --records '[{\"recordId\":\"\u003c可选\u003e\",\"cells\":{...}}, ...]'", "dws aitable record upsert --base-id BASE --table-id TBL --records '[" ], "group": "record", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "record_upsert" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "record_upsert", "parameter_count": 4, "parameters": { "base-id": { "description": "Base ID，可通过 base list 或 base search 获取 (必填)", "interface_description": "目标 Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "records": { "description": "待 upsert 的记录内容列表 JSON 数组，单次最多 100 条；带 recordId 的走更新，不带的走创建 (必填，可改用 --records-file)", "interface_description": "待 upsert 的记录列表，单次最多 100 条。带 recordId 的记录走更新，不带的走创建", "interface_type": "array", "property": "records", "required": true, "type": "string" }, "records-file": { "description": "从文件读取 records JSON（避免命令行长度限制）；与 --records 互斥，优先级更高", "property": "recordsFile", "required": false, "type": "string" }, "table-id": { "description": "Table ID，可通过 base get 获取 (必填)", "interface_description": "目标 Table ID（通过 get_base / list_tables 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.record_upsert", "primary_cli_path": "aitable record upsert", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "record_upsert", "use_when": [ "1) 全部新建：所有项都不带 recordId", "2) 全部更新：所有项都带 recordId", "3) 混合：第 1 条更新（带 recordId），第 2 条创建（不带）", "4) 长 JSON 用文件" ] }, "aitable.search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.search", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "按名称关键词搜索 AI 表格 Base。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“按名称关键词搜索 AI 表格 Base。”" ], "canonical_path": "aitable.search", "cli_name": "search", "cli_path": "aitable search", "confirmation": "not_required", "description": "按名称关键词搜索 AI 表格 Base。返回 baseId/baseName，结果按相关性排序。返回的 baseId 可直接用于 get_base 等后续工具。\r\nAI 表格访问地址可按 baseId 拼接为：https://docs.dingtalk.com/i/nodes/{baseId}", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable search --query \u003cquery\u003e" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "search_bases" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search", "parameter_count": 2, "parameters": { "cursor": { "description": "分页游标，首次不传", "property": "cursor", "required": false, "type": "string" }, "query": { "description": "Base 名称关键词，建议至少 2 个字符 (必填)", "interface_description": "Base 名称关键词，建议至少 2 个字符", "property": "query", "required": true, "type": "string" } }, "path": "aitable.search", "primary_cli_path": "aitable search", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "搜索 AI 表格", "use_when": [ "按名称关键词搜索 AI 表格 Base。" ] }, "aitable.section_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.section_create", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "在指定 Base 下创建分区(用于在导航树中组织 table / dashboard,类似文件夹)。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于”请改用 dws aitable section list-empty", "要“列出指定 Base 当前版本下的全部 nsheet 节点,包括分”请改用 dws aitable section list-nodes", "要“删除指定分区”请改用 dws aitable section delete" ], "canonical_path": "aitable.section_create", "cli_name": "create", "cli_path": "aitable section create", "confirmation": "not_required", "description": "在指定 Base 下创建分区(用于在导航树中组织 table / dashboard,类似文件夹)。\r\n\r\n必填:\r\n- baseId\r\n- name\r\n\r\n可选:\r\n- parentSectionId:不传或空字符串表示创建在 Base 根目录下\r\n- index:0-based,不传则追加到末尾\r\n\r\n返回新建分区的 sectionId 与 name。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable section create --base-id \u003cBASE_ID\u003e --name 我的文件夹", "dws aitable section create --base-id \u003cBASE_ID\u003e --name 子文件夹 --parent-section-id \u003cSECTION_ID\u003e --index 0" ], "group": "section", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "create_section" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "section_create", "parameter_count": 4, "parameters": { "base-id": { "description": "Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "index": { "default": "-1", "description": "在父文件夹下的目标位置（0-based）；不传则追加到末尾", "interface_description": "可选，在父分区下的目标位置（0-based）；不传则追加到末尾", "interface_type": "number", "property": "index", "required": false, "type": "integer" }, "name": { "description": "文件夹名称 (必填)", "interface_description": "必填，分区名称", "property": "name", "required": true, "type": "string" }, "parent-section-id": { "description": "父文件夹 ID；不传或空字符串表示创建在 Base 根目录下", "interface_description": "可选，父分区 ID；不传或空字符串表示创建在 Base 根目录下", "property": "parentSectionId", "required": false, "type": "string" } }, "path": "aitable.section_create", "primary_cli_path": "aitable section create", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "创建分组", "use_when": [ "在指定 Base 下创建分区(用于在导航树中组织 table / dashboard,类似文件夹)。" ] }, "aitable.section_delete": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.section_delete", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除指定分区。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于”请改用 dws aitable section list-empty", "要“列出指定 Base 当前版本下的全部 nsheet 节点,包括分”请改用 dws aitable section list-nodes", "要“在指定 Base 下创建分区(用于在导航树中组织 table /”请改用 dws aitable section create" ], "canonical_path": "aitable.section_delete", "cli_name": "delete", "cli_path": "aitable section delete", "confirmation": "user_required", "description": "删除指定分区。\r\n\r\n必填 baseId、sectionId。\r\n\r\n注意删除操作不可逆;若分区下仍有 table / dashboard,下游会按既有规则处理。\r\n\r\n返回被删除的 sectionId。", "display": "AI 表格操作", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws aitable section delete --base-id \u003cBASE_ID\u003e --section-id \u003cSECTION_ID\u003e" ], "group": "section", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "delete_section" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "section_delete", "parameter_count": 2, "parameters": { "base-id": { "description": "Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "section-id": { "description": "目标文件夹 ID (必填)", "interface_description": "目标分区 ID", "property": "sectionId", "required": true, "type": "string" } }, "path": "aitable.section_delete", "primary_cli_path": "aitable section delete", "product_id": "aitable", "reviewed": false, "risk": "high", "source": "hardcoded:aitable", "title": "删除分组", "use_when": [ "删除指定分区。" ] }, "aitable.section_list_empty": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.section_list_empty", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于清理或诊断导航树。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 当前版本下的全部 nsheet 节点,包括分”请改用 dws aitable section list-nodes", "要“删除指定分区”请改用 dws aitable section delete", "要“在指定 Base 下创建分区(用于在导航树中组织 table /”请改用 dws aitable section create" ], "canonical_path": "aitable.section_list_empty", "cli_name": "list-empty", "cli_path": "aitable section list-empty", "confirmation": "not_required", "description": "列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于清理或诊断导航树。\r\n\r\n必填 baseId。\r\n\r\n返回按 name 升序排列的 [{sectionId, name, parentSectionId}] 列表与总数;parentSectionId 为空串表示该分区在 Base 根目录下。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable section list-empty --base-id \u003cBASE_ID\u003e" ], "group": "section", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "list_empty_sections" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "section_list_empty", "parameter_count": 1, "parameters": { "base-id": { "description": "Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" } }, "path": "aitable.section_list_empty", "primary_cli_path": "aitable section list-empty", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "查询空分组", "use_when": [ "列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于清理或诊断导航树。" ] }, "aitable.section_list_nodes": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.section_list_nodes", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "列出指定 Base 当前版本下的全部 nsheet 节点,包括分区、AI 表格、表单视图、仪表盘、文档、查询视图等。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于”请改用 dws aitable section list-empty", "要“删除指定分区”请改用 dws aitable section delete", "要“在指定 Base 下创建分区(用于在导航树中组织 table /”请改用 dws aitable section create" ], "canonical_path": "aitable.section_list_nodes", "cli_name": "list-nodes", "cli_path": "aitable section list-nodes", "confirmation": "not_required", "description": "列出指定 Base 当前版本下的全部 nsheet 节点,包括分区、AI 表格、表单视图、仪表盘、文档、查询视图等。\r\n\r\n必填 baseId。\r\n\r\n返回按 name 升序排列的 [{nodeId, nodeType, parentSectionId, name}] 列表与总数;parentSectionId 为空串表示该节点在 Base 根目录下。\r\n\r\n适合在 move_nsheet_node、reorder_section 等操作前用来定位节点 ID 与父级关系。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable section list-nodes --base-id \u003cBASE_ID\u003e" ], "group": "section", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "list_nsheet_nodes" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "section_list_nodes", "parameter_count": 1, "parameters": { "base-id": { "description": "Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" } }, "path": "aitable.section_list_nodes", "primary_cli_path": "aitable section list-nodes", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "查询AI表格节点", "use_when": [ "列出指定 Base 当前版本下的全部 nsheet 节点,包括分区、AI 表格、表单视图、仪表盘、文档、查询视图等。" ] }, "aitable.section_move_node": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.section_move_node", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "把任意 nsheet 节点(分区 / 多维表 / 表单视图 / 仪表盘 / 文档 / 查询视图)移动到目标分区下,可选同时调整全局位置。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于”请改用 dws aitable section list-empty", "要“删除指定分区”请改用 dws aitable section delete", "要“在指定 Base 下创建分区(用于在导航树中组织 table /”请改用 dws aitable section create" ], "canonical_path": "aitable.section_move_node", "cli_name": "move-node", "cli_path": "aitable section move-node", "confirmation": "not_required", "description": "把任意 nsheet 节点(分区 / 多维表 / 表单视图 / 仪表盘 / 文档 / 查询视图)移动到目标分区下,可选同时调整全局位置。\r\n\r\n必填:\r\n- baseId\r\n- nodeId\r\n- newParentSectionId:传空字符串表示移动到 Base 根目录\r\n\r\n可选:\r\n- targetIndex:0-based 全局下标;对分区节点会先 move 再调 reorder,中间步骤失败时会返回 MOVE_OK_REORDER_FAILED,可用 reorder_section 重试\r\n\r\n服务端会自动识别节点类型,调用方无需区分分区与非分区。\r\n\r\n返回被移动节点的 id、type、目标父级与下标。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable section move-node --base-id \u003cBASE_ID\u003e --node-id \u003cNODE_ID\u003e --new-parent-section-id \u003cSECTION_ID\u003e", "dws aitable section move-node --base-id \u003cBASE_ID\u003e --node-id \u003cNODE_ID\u003e --new-parent-section-id \"\" --target-index 0" ], "group": "section", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "move_nsheet_node" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "section_move_node", "parameter_count": 4, "parameters": { "base-id": { "description": "Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "new-parent-section-id": { "description": "目标父文件夹 ID；空字符串表示移到 Base 根目录 (必填)", "interface_description": "目标父分区 ID；空字符串表示移到 Base 根目录", "property": "newParentSectionId", "required": true, "type": "string" }, "node-id": { "description": "要移动的节点 ID，可以是文件夹、AI表格、表单视图、仪表盘、文档或查询视图 (必填)", "interface_description": "要移动的节点 ID，可以是分区、AI表格、表单视图、仪表盘、文档或查询视图", "property": "nodeId", "required": true, "type": "string" }, "target-index": { "default": "-1", "description": "Base 内节点的全局位置（0-based）；不传则不调整", "interface_description": "可选，Base 内节点的全局位置（0-based）；文件夹节点会触发额外的位置调整调用", "interface_type": "number", "property": "targetIndex", "required": false, "type": "integer" } }, "path": "aitable.section_move_node", "primary_cli_path": "aitable section move-node", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "移动AI表格节点", "use_when": [ "把任意 nsheet 节点(分区 / 多维表 / 表单视图 / 仪表盘 / 文档 / 查询视图)移动到目标分区下,可选同时调整全局位置。" ] }, "aitable.section_rename": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.section_rename", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "重命名指定分区。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于”请改用 dws aitable section list-empty", "要“删除指定分区”请改用 dws aitable section delete", "要“在指定 Base 下创建分区(用于在导航树中组织 table /”请改用 dws aitable section create" ], "canonical_path": "aitable.section_rename", "cli_name": "rename", "cli_path": "aitable section rename", "confirmation": "not_required", "description": "重命名指定分区。\r\n\r\n必填 baseId、sectionId、newName。\r\n\r\n返回重命名后的 sectionId 与新的 name。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable section rename --base-id \u003cBASE_ID\u003e --section-id \u003cSECTION_ID\u003e --new-name 新名称" ], "group": "section", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "rename_section" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "section_rename", "parameter_count": 3, "parameters": { "base-id": { "description": "Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "new-name": { "description": "新的文件夹名称 (必填)", "interface_description": "必填，新的分区名称", "property": "newName", "required": true, "type": "string" }, "section-id": { "description": "目标文件夹 ID (必填)", "interface_description": "目标分区 ID", "property": "sectionId", "required": true, "type": "string" } }, "path": "aitable.section_rename", "primary_cli_path": "aitable section rename", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "重命名分组", "use_when": [ "重命名指定分区。" ] }, "aitable.section_reorder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.section_reorder", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "在当前父分区下调整分区的展示顺序。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于”请改用 dws aitable section list-empty", "要“删除指定分区”请改用 dws aitable section delete", "要“在指定 Base 下创建分区(用于在导航树中组织 table /”请改用 dws aitable section create" ], "canonical_path": "aitable.section_reorder", "cli_name": "reorder", "cli_path": "aitable section reorder", "confirmation": "not_required", "description": "在当前父分区下调整分区的展示顺序。\r\n\r\n必填 baseId、sectionId、targetIndex(0-based)。\r\n\r\n返回被调整的 sectionId。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable section reorder --base-id \u003cBASE_ID\u003e --section-id \u003cSECTION_ID\u003e --target-index 0" ], "group": "section", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "reorder_section" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "section_reorder", "parameter_count": 3, "parameters": { "base-id": { "description": "Base ID (必填)", "interface_description": "所属 Base 的唯一标识，可通过 list_bases / search_bases 获取", "property": "baseId", "required": true, "type": "string" }, "section-id": { "description": "目标文件夹 ID (必填)", "interface_description": "目标分区 ID", "property": "sectionId", "required": true, "type": "string" }, "target-index": { "default": "-1", "description": "目标位置（0-based）(必填)", "interface_description": "必填，目标位置（0-based）", "interface_type": "number", "property": "targetIndex", "required": true, "type": "integer" } }, "path": "aitable.section_reorder", "primary_cli_path": "aitable section reorder", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "调整分组顺序", "use_when": [ "在当前父分区下调整分区的展示顺序。" ] }, "aitable.table_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.create_table", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建数据表并附带初始字段（最多 15 个）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除数据表（不可逆，高风险）”请改用 dws aitable table delete", "要“批量获取指定 Tables（数据表）的表级信息、字段目录与视图目”请改用 dws aitable table list", "要“批量获取数据表目录与字段、视图 summary”请改用 dws aitable table get" ], "canonical_path": "aitable.table_create", "cli_name": "create", "cli_path": "aitable table create", "confirmation": "not_required", "description": "在指定 Base 中新建表格，并可在创建时附带初始化一批基础字段。\r\n建表时单次最多附带 15 个字段；若 fields 为空，服务会自动补一个名为“标题”的 primaryDoc 首列。\r\n若 tableName 与当前 Base 下已有表重名，服务会自动续号为“原名 1 / 原名 2 ...”，并在 summary 中返回当前表名。\r\n如需添加更多字段，或在已有表中增加字段，请使用 create_fields。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable table create --base-id BASE_ID --name \"任务表\" --fields '[{\"fieldName\":\"任务名称\",\"type\":\"text\"},{\"fieldName\":\"优先级\",\"type\":\"singleSelect\",\"config\":{\"options\":[{\"name\":\"高\"},{\"name\":\"中\"},{\"name\":\"低\"}]}}]'" ], "group": "table", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_table" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "table_create", "parameter_count": 3, "parameters": { "base-id": { "description": "目标 Base ID（通过 base list 获取）(必填)", "interface_description": "目标 Base ID（通过 list_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "fields": { "default": "[]", "description": "建表时随附创建的初始字段 JSON 数组，至少 1 个，单次最多 15 个。若传空数组 []，系统会自动补一个名为'标题'的 primaryDoc 首列", "interface_description": "建表时随附创建的初始字段列表，至少包含 1 个字段，单次最多 15 个。若传空数组，系统会自动补一个名为“标题”的 primaryDoc 首列。\n建议在此处定义结构清晰的基础字段（如文本、数字、日期、单选等）；\n复杂字段（关联、流转等）建议建表完成后通过 create_fields 单独添加。\n\n每个字段对象包含：\n fieldName（必填）: 字段名称\n type（必填）: 字段类型，可选值与 config 结构详见本工具说明末尾的字段参考\n config（可选）: 字段配置，结构因 type 而异，详见字段参考\n\n示例：\n[\n {\"fieldName\":\"任务名称\",\"type\":\"text\"},\n {\"fieldName\":\"优先级\",\"type\":\"singleSelect\",\"config\":{\"options\":[{\"name\":\"高\"},{\"name\":\"中\"},{\"name\":\"低\"}]}},\n {\"fieldName\":\"截止日期\",\"type\":\"date\",\"config\":{\"formatter\":\"YYYY-MM-DD\"}},\n {\"fieldName\":\"负责人\",\"type\":\"user\",\"config\":{\"multiple\":false}}\n]", "interface_type": "array", "property": "fields", "required": false, "type": "string" }, "name": { "description": "表格名称，1~100 个字符；不能包含 / \\ ? * [ ] : 等字符 (必填)", "property": "name", "required": true, "type": "string" } }, "path": "aitable.table_create", "primary_cli_path": "aitable table create", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "创建数据表", "use_when": [ "数据表/子表/table；创建" ] }, "aitable.table_delete": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.delete_table", "skills/mono/SKILL.md", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除数据表（不可逆，高风险）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建数据表并附带初始字段（最多 15 个）”请改用 dws aitable table create", "要“批量获取指定 Tables（数据表）的表级信息、字段目录与视图目”请改用 dws aitable table list", "要“批量获取数据表目录与字段、视图 summary”请改用 dws aitable table get" ], "canonical_path": "aitable.table_delete", "cli_name": "delete", "cli_path": "aitable table delete", "confirmation": "user_required", "description": "删除指定 tableId 的数据表（不可逆，数据将永久丢失），该操作为高风险写入。\r\n调用前请先通过 get_base / get_tables 确认目标表 ID 与名称。", "display": "AI 表格操作", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws aitable table delete --base-id \u003cbase-id\u003e --table-id \u003ctable-id\u003e" ], "group": "table", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_table" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "table_delete", "parameter_count": 3, "parameters": { "base-id": { "description": "目标 Base ID（通过 base list 获取）(必填)", "interface_description": "目标 Base ID（通过 list_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "reason": { "description": "一句话描述一下删除该数据表的原因，用于审计", "property": "reason", "required": false, "type": "string" }, "table-id": { "description": "将被删除的 Table ID（通过 base get / get_tables 获取）(必填)", "interface_description": "将被删除的 Table ID（通过 get_base / get_tables 获取）", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.table_delete", "primary_cli_path": "aitable table delete", "product_id": "aitable", "risk": "high", "source": "hardcoded:aitable", "title": "删除数据表", "use_when": [ "数据表/子表/table；删除" ] }, "aitable.table_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.get_tables", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-advperm.md", "skills/mono/references/products/aitable/aitable-primary-doc.md", "skills/mono/references/products/aitable/aitable-record-create.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量获取数据表目录与字段、视图 summary", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建数据表并附带初始字段（最多 15 个）”请改用 dws aitable table create", "要“删除数据表（不可逆，高风险）”请改用 dws aitable table delete", "要“批量获取指定 Tables（数据表）的表级信息、字段目录与视图目”请改用 dws aitable table list" ], "canonical_path": "aitable.table_get", "cli_name": "get", "cli_path": "aitable table get", "confirmation": "not_required", "description": "批量获取指定 Tables（数据表）的表级信息、字段目录与视图目录。\r\n会返回 tables 列表；每个 table 直接包含 tableId、tableName、description、fields、views；字段列表仅包含 fieldId、fieldName、type、description；views 仅包含 viewId、viewName、type。\r\n若需读取字段的完整配置，请再调用 get_fields。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable table get --base-id \u003cBASE_ID\u003e --table-id \u003cTABLE_ID\u003e --format json", "dws aitable table get --base-id BASE_ID --format json" ], "group": "table", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_tables" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "table_get", "parameter_count": 2, "parameters": { "base-id": { "description": "所属 Base ID（通过 base list / base search 获取）(必填)", "interface_description": "所属 Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "table-ids": { "description": "待获取详情的 Table ID 列表（通过 base get 获取），逗号分隔，单次最多 10 个；不传则默认返回当前 Base 下全部表。建议优先显式传入，以控制返回体大小，避免上下文突增", "interface_description": "待获取详情的 Table ID 列表（通过 get_base 获取），单次最多 10 个；不传则默认返回当前 Base 下全部表。建议优先显式传入，以控制返回体大小，避免上下文突增", "interface_type": "array", "property": "tableIds", "required": false, "type": "string" } }, "path": "aitable.table_get", "primary_cli_path": "aitable table get", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "获取数据表", "use_when": [ "1. 查询表结构，拿到 primaryDoc 字段的 fieldId", "2. 拿目标 sheet 的 tableId", "3. 获取表结构 — 提取 fieldId", "先获取 fieldId", "数据表/子表/table；查看" ] }, "aitable.table_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.table_list", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量获取指定 Tables（数据表）的表级信息、字段目录与视图目录。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建数据表并附带初始字段（最多 15 个）”请改用 dws aitable table create", "要“删除数据表（不可逆，高风险）”请改用 dws aitable table delete", "要“批量获取数据表目录与字段、视图 summary”请改用 dws aitable table get" ], "canonical_path": "aitable.table_list", "cli_name": "list", "cli_path": "aitable table list", "confirmation": "not_required", "description": "批量获取指定 Tables（数据表）的表级信息、字段目录与视图目录。\r\n会返回 tables 列表；每个 table 直接包含 tableId、tableName、description、fields、views；字段列表仅包含 fieldId、fieldName、type、description；views 仅包含 viewId、viewName、type。\r\n若需读取字段的完整配置，请再调用 get_fields。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable table list --base-id \u003cbase-id\u003e" ], "group": "table", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_tables" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "table_list", "parameter_count": 2, "parameters": { "base-id": { "description": "所属 Base ID（通过 base list / base search 获取）(必填)", "interface_description": "所属 Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "table-ids": { "description": "待获取详情的 Table ID 列表（通过 base get 获取），逗号分隔，单次最多 10 个；不传则默认返回当前 Base 下全部表。建议优先显式传入，以控制返回体大小，避免上下文突增", "interface_description": "待获取详情的 Table ID 列表（通过 get_base 获取），单次最多 10 个；不传则默认返回当前 Base 下全部表。建议优先显式传入，以控制返回体大小，避免上下文突增", "interface_type": "array", "property": "tableIds", "required": false, "type": "string" } }, "path": "aitable.table_list", "primary_cli_path": "aitable table list", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "获取数据表", "use_when": [ "批量获取指定 Tables（数据表）的表级信息、字段目录与视图目录。" ] }, "aitable.table_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.update_table", "skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable/aitable-record-name-key.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "重命名数据表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建数据表并附带初始字段（最多 15 个）”请改用 dws aitable table create", "要“删除数据表（不可逆，高风险）”请改用 dws aitable table delete", "要“批量获取数据表目录与字段、视图 summary”请改用 dws aitable table get" ], "canonical_path": "aitable.table_update", "cli_name": "update", "cli_path": "aitable table update", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "name", "description", "record-name-key" ] ] }, "description": "重命名指定 Table（数据表）。若新名称不符合命名要求、与同一 Base 下其他表重名或无权限，将返回错误。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable table update --base-id BASE --table-id TBL --record-name-key task", "dws aitable table update --base-id BASE --table-id TBL --record-name-key project" ], "group": "table", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_table" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "table_update", "parameter_count": 5, "parameters": { "base-id": { "description": "所属 Base ID（用于定位目标表）(必填)", "interface_description": "所属 Base ID（用于定位目标表）。", "property": "baseId", "required": true, "type": "string" }, "description": { "description": "更新后的数据表备注说明；与 --name / --record-name-key 三选一", "interface_description": "可选，更新后的数据表备注说明。不修改时省略", "property": "description", "required": false, "type": "string" }, "name": { "description": "新表名。不能包含 / \\ ? * [ ] : 等特殊字符；与 --description / --record-name-key 三选一", "property": "name", "required": false, "type": "string" }, "record-name-key": { "description": "行命名规则枚举键（如 task / project / event / customer 等固定枚举值）；与 --name / --description 三选一", "interface_description": "设置行命名规则：recordNameKey 枚举键。注意该值不是字段 ID，而是一组固定枚举字符串（如 question、task、project、event）。不修改时省略。", "property": "recordNameKey", "required": false, "type": "string" }, "table-id": { "description": "目标 Table ID（通过 base get 获取）(必填)", "interface_description": "目标 Table ID（通过 get_base 获取）。", "property": "tableId", "required": true, "type": "string" } }, "path": "aitable.table_update", "primary_cli_path": "aitable table update", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "update_table", "use_when": [ "数据表/子表/table；重命名", "用户说\"恢复成默认（记录）\" → 传 ji_lu", "用户说\"把这张表的行叫'任务'吧\" → 传 task", "用户说\"换成项目\" → 传 project" ] }, "aitable.template_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.search_templates", "skills/mono/references/products/aitable.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "按关键词搜索 AI 表格模板（不传返回热门模板）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“按关键词搜索 AI 表格模板（不传返回热门模板）”" ], "canonical_path": "aitable.template_search", "cli_name": "search", "cli_path": "aitable template search", "confirmation": "not_required", "description": "按名称关键词搜索 AI 表格模板，支持分页。\r\n返回每个模板的 templateId、name、description，以及分页信息 hasMore / nextCursor。\r\n返回的 templateId 可直接用于 create_base。\r\n模板预览链接可通过 https://docs.dingtalk.com/table/template/{templateId} 拼接得到", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable template search --query \"项目管理\"", "dws aitable template search" ], "group": "template", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "search_templates" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "template_search", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标。首次请求不传；后续请原样传入上次返回的 nextCursor", "property": "cursor", "required": false, "type": "string" }, "limit": { "description": "每页返回数量。默认 10，最大 30", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "query": { "description": "模板名称关键词 (必填)", "interface_description": "模板名称关键词", "property": "query", "required": true, "type": "string" } }, "path": "aitable.template_search", "primary_cli_path": "aitable template search", "product_id": "aitable", "risk": "low", "source": "hardcoded:aitable", "title": "搜索模板", "use_when": [ "模板" ] }, "aitable.view_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.create_view", "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建视图（Grid/FormDesigner/Gantt/Calendar/Kanban/Gallery）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除视图（不可逆；禁止删除最后一个视图或锁定视图）”请改用 dws aitable view delete", "要“复制指定视图(View),生成一个与源视图结构一致的新视图(包含”请改用 dws aitable view duplicate", "要“获取指定数据表（Table）中的视图（View）完整信息，包括列”请改用 dws aitable view list" ], "canonical_path": "aitable.view_create", "cli_name": "create", "cli_path": "aitable view create", "confirmation": "not_required", "description": "在指定数据表（Table）下创建一个新视图（View）。\r\n当前稳定支持的 viewType：Grid、FormDesigner、Gantt、Calendar、Kanban、Gallery。\r\n若未传 viewName，则会按视图类型自动生成不重名名称。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view create --base-id BASE_ID --table-id TABLE_ID --view-type Gantt --name \"项目甘特图\" -f json", "dws aitable view create --base-id BASE_ID --table-id TABLE_ID --view-type Grid" ], "group": "view", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "create_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_create", "parameter_count": 7, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "config": { "description": "视图配置 JSON（含 visibleFieldIds、filter、sort、group 等）", "interface_description": "可选，创建视图时附带的配置。", "interface_type": "object", "property": "config", "required": false, "type": "string" }, "desc": { "description": "视图描述 JSON，如 {\"content\":[]}", "property": "desc", "required": false, "type": "string" }, "name": { "description": "视图名称，未传时自动生成", "property": "name", "required": false, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-sub-type": { "description": "视图子类型，可选", "interface_description": "可选，视图子类型。", "property": "viewSubType", "required": false, "type": "string" }, "view-type": { "description": "视图类型：Grid、FormDesigner、Gantt、Calendar、Kanban、Gallery (必填)", "interface_description": "新视图类型。当前支持：Grid、FormDesigner、Gantt、Calendar、Kanban、Gallery。", "property": "viewType", "required": true, "type": "string" } }, "path": "aitable.view_create", "primary_cli_path": "aitable view create", "product_id": "aitable", "risk": "medium", "source": "hardcoded:aitable", "title": "创建视图", "use_when": [ "第 1 步：创建 Gantt 视图" ] }, "aitable.view_delete": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.delete_view", "skills/mono/SKILL.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除视图（不可逆；禁止删除最后一个视图或锁定视图）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建视图（Grid/FormDesigner/Gantt/Cal”请改用 dws aitable view create", "要“复制指定视图(View),生成一个与源视图结构一致的新视图(包含”请改用 dws aitable view duplicate", "要“获取指定数据表（Table）中的视图（View）完整信息，包括列”请改用 dws aitable view list" ], "canonical_path": "aitable.view_delete", "cli_name": "delete", "cli_path": "aitable view delete", "confirmation": "user_required", "description": "删除指定视图（View）。该操作不可逆。\r\n已知保护：禁止删除数据表中的最后一个视图；锁定视图不允许删除。", "display": "AI 表格操作", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws aitable view delete --base-id \u003cbase-id\u003e --table-id \u003ctable-id\u003e --view-id \u003cview-id\u003e" ], "group": "view", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "delete_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_delete", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "要删除的 View ID (必填)", "interface_description": "要删除的视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_delete", "primary_cli_path": "aitable view delete", "product_id": "aitable", "risk": "high", "source": "hardcoded:aitable", "title": "删除视图", "use_when": [ "删除视图（不可逆；禁止删除最后一个视图或锁定视图）" ] }, "aitable.view_duplicate": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.view_duplicate", "skills/mono/references/products/aitable/aitable-view-extras.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "复制指定视图(View),生成一个与源视图结构一致的新视图(包含列顺序、筛选、排序、分组、自定义配置等)。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建视图（Grid/FormDesigner/Gantt/Cal”请改用 dws aitable view create", "要“删除视图（不可逆；禁止删除最后一个视图或锁定视图）”请改用 dws aitable view delete", "要“获取指定数据表（Table）中的视图（View）完整信息，包括列”请改用 dws aitable view list" ], "canonical_path": "aitable.view_duplicate", "cli_name": "duplicate", "cli_path": "aitable view duplicate", "confirmation": "not_required", "description": "复制指定视图(View),生成一个与源视图结构一致的新视图(包含列顺序、筛选、排序、分组、自定义配置等)。\r\n\r\n通过 baseId / tableId / sourceViewId 三元组定位源视图;未传 newViewName 时自动生成\"原视图名 (副本)\"风格的不重名名称。\r\n\r\n表单视图复制时会重置分享态,不会带过源视图的分享配置。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view duplicate --view-id VIEW_ID --new-name \"副本视图\"", "dws aitable view duplicate --view-id VIEW_ID --format json" ], "group": "view", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "duplicate_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_duplicate", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "new-name": { "description": "新视图名称（不传则由 server 默认命名）", "property": "newName", "required": false, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "源 View ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_duplicate", "primary_cli_path": "aitable view duplicate", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "复制视图", "use_when": [ "显式命名", "系统自动命名（一般是 \"原视图名 (副本)\"）" ] }, "aitable.view_get_aggregate": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询视图的聚合统计（汇总行）", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的条件填色规则”请改用 dws aitable view get fill-color-rule" ], "canonical_path": "aitable.view_get_aggregate", "cli_name": "aggregate", "cli_path": "aitable view get aggregate", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view get aggregate --view-id VIEW_ID --format json # Grid" ], "group": "view.get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_get_aggregate", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_get_aggregate", "primary_cli_path": "aitable view get aggregate", "product_id": "aitable", "reviewed": true, "risk": "low", "source": "hardcoded:aitable", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, "aitable.view_get_card": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询视图的卡片视图样式", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的条件填色规则”请改用 dws aitable view get fill-color-rule", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_card", "cli_name": "card", "cli_path": "aitable view get card", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view get card --view-id VIEW_ID --format json # Kanban / Gallery", "dws aitable view get card --view-id KANBAN_ID --format json" ], "group": "view.get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_get_card", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_get_card", "primary_cli_path": "aitable view get card", "product_id": "aitable", "reviewed": true, "risk": "low", "source": "hardcoded:aitable", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, "aitable.view_get_field_widths": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询视图的各列列宽", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的条件填色规则”请改用 dws aitable view get fill-color-rule", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_field_widths", "cli_name": "field-widths", "cli_path": "aitable view get field-widths", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view get field-widths --view-id VIEW_ID --format json # Grid" ], "group": "view.get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_get_field_widths", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_get_field_widths", "primary_cli_path": "aitable view get field-widths", "product_id": "aitable", "reviewed": true, "risk": "low", "source": "hardcoded:aitable", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, "aitable.view_get_fill_color_rule": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-extras.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询视图的条件填色规则", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_fill_color_rule", "cli_name": "fill-color-rule", "cli_path": "aitable view get fill-color-rule", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view get fill-color-rule --view-id GRID_ID --format json", "dws aitable view get fill-color-rule --view-id VIEW_ID --format json" ], "group": "view.get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_get_fill_color_rule", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_get_fill_color_rule", "primary_cli_path": "aitable view get fill-color-rule", "product_id": "aitable", "reviewed": true, "risk": "low", "source": "hardcoded:aitable", "title": "get_views", "use_when": [ "3) 查询当前规则", "看实际生效的 conditionalFormats" ] }, "aitable.view_get_filter": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询视图的筛选条件", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_filter", "cli_name": "filter", "cli_path": "aitable view get filter", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view get filter --view-id VIEW_ID --format json # 所有" ], "group": "view.get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_get_filter", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_get_filter", "primary_cli_path": "aitable view get filter", "product_id": "aitable", "reviewed": true, "risk": "low", "source": "hardcoded:aitable", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, "aitable.view_get_frozen_cols": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.view_get_frozen_cols", "skills/mono/references/products/aitable/aitable-view-extras.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询指定视图(View)当前的冻结列数(左侧固定列)。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_frozen_cols", "cli_name": "frozen-cols", "cli_path": "aitable view get frozen-cols", "confirmation": "not_required", "description": "查询指定视图(View)当前的冻结列数(左侧固定列)。\r\n\r\n通过 baseId / tableId / viewId 三元组定位目标视图。\r\n\r\n视图未显式设置时返回 null(前端实际显示会回落到默认 1),由调用方根据业务约定决定如何兜底。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view get frozen-cols --view-id VIEW_ID --format json" ], "group": "view.get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_frozen_columns_of_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_get_frozen_cols", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_get_frozen_cols", "primary_cli_path": "aitable view get frozen-cols", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "获取视图冻结列数", "use_when": [ "查询当前冻结列数" ] }, "aitable.view_get_group": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询视图的分组", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_group", "cli_name": "group", "cli_path": "aitable view get group", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view get group --view-id VIEW_ID --format json" ], "group": "view.get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_get_group", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_get_group", "primary_cli_path": "aitable view get group", "product_id": "aitable", "reviewed": true, "risk": "low", "source": "hardcoded:aitable", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, "aitable.view_get_lock": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.view_get_lock", "skills/mono/references/products/aitable/aitable-view-extras.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询指定视图(View)当前的锁定状态。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_lock", "cli_name": "lock", "cli_path": "aitable view get lock", "confirmation": "not_required", "description": "查询指定视图(View)当前的锁定状态。\r\n\r\n通过 baseId / tableId / viewId 三元组定位目标视图,返回 locked 字段(true 表示已锁定)。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view get lock --view-id VIEW_ID --format json" ], "group": "view.get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_view_lock_status" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_get_lock", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_get_lock", "primary_cli_path": "aitable view get lock", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "获取视图锁定状态", "use_when": [ "查询当前是否锁定" ] }, "aitable.view_get_row_height": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.view_get_row_height", "skills/mono/references/products/aitable/aitable-view-extras.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询指定视图(View)当前的单元格行高,单位为像素。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_row_height", "cli_name": "row-height", "cli_path": "aitable view get row-height", "confirmation": "not_required", "description": "查询指定视图(View)当前的单元格行高,单位为像素。\r\n\r\n通过 baseId / tableId / viewId 三元组定位目标视图。\r\n\r\n视图未显式设置时返回 null(前端实际显示会回落到默认 32px),由调用方根据业务约定决定如何兜底。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view get row-height --view-id VIEW_ID --format json" ], "group": "view.get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_cell_height_of_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_get_row_height", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_get_row_height", "primary_cli_path": "aitable view get row-height", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "获取视图行高", "use_when": [ "查询当前行高" ] }, "aitable.view_get_sort": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询视图的排序规则", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_sort", "cli_name": "sort", "cli_path": "aitable view get sort", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view get sort --view-id VIEW_ID --format json" ], "group": "view.get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_get_sort", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_get_sort", "primary_cli_path": "aitable view get sort", "product_id": "aitable", "reviewed": true, "risk": "low", "source": "hardcoded:aitable", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, "aitable.view_get_timebar": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询视图的时间条（甘特/时间轴）", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_timebar", "cli_name": "timebar", "cli_path": "aitable view get timebar", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view get timebar --view-id VIEW_ID --format json # Gantt" ], "group": "view.get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_get_timebar", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_get_timebar", "primary_cli_path": "aitable view get timebar", "product_id": "aitable", "reviewed": true, "risk": "low", "source": "hardcoded:aitable", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, "aitable.view_get_visible_fields": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询视图的可见字段及顺序", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“查询视图的卡片视图样式”请改用 dws aitable view get card", "要“查询视图的各列列宽”请改用 dws aitable view get field-widths", "要“查询视图的聚合统计（汇总行）”请改用 dws aitable view get aggregate" ], "canonical_path": "aitable.view_get_visible_fields", "cli_name": "visible-fields", "cli_path": "aitable view get visible-fields", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view get visible-fields --view-id VIEW_ID --format json" ], "group": "view.get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_get_visible_fields", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_get_visible_fields", "primary_cli_path": "aitable view get visible-fields", "product_id": "aitable", "reviewed": true, "risk": "low", "source": "hardcoded:aitable", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, "aitable.view_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.view_list", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建视图（Grid/FormDesigner/Gantt/Cal”请改用 dws aitable view create", "要“删除视图（不可逆；禁止删除最后一个视图或锁定视图）”请改用 dws aitable view delete", "要“复制指定视图(View),生成一个与源视图结构一致的新视图(包含”请改用 dws aitable view duplicate" ], "canonical_path": "aitable.view_list", "cli_name": "list", "cli_path": "aitable view list", "confirmation": "not_required", "description": "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。\r\n支持两种模式：\r\n- 显式选择：传入 viewIds，按入参顺序返回这些视图；单次最多 10 个。\r\n- 默认全量：省略 viewIds，返回当前表下全部视图，顺序与当前表视图目录一致。\r\n对 Kanban / Gantt / Gallery 视图，会在返回上额外提供 kanbanCard / ganttTimebar / galleryCard 三个类型化卡片配置块，其他视图类型为 null。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable view list --base-id \u003cbase-id\u003e --table-id \u003ctable-id\u003e" ], "group": "view", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "get_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_list", "parameter_count": 3, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-ids": { "description": "待获取详情的 View ID 列表，逗号分隔，单次最多 10 个；不传则返回全部视图", "interface_description": "可选，待获取详情的视图（View）ID 列表。显式传入时单次最多 10 个；省略时默认返回当前表下全部视图。", "interface_type": "array", "property": "viewIds", "required": false, "type": "string" } }, "path": "aitable.view_list", "primary_cli_path": "aitable view list", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "get_views", "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ] }, "aitable.view_lock": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.view_lock", "skills/mono/references/products/aitable/aitable-view-extras.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "锁定或解锁指定视图(View)。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建视图（Grid/FormDesigner/Gantt/Cal”请改用 dws aitable view create", "要“删除视图（不可逆；禁止删除最后一个视图或锁定视图）”请改用 dws aitable view delete", "要“复制指定视图(View),生成一个与源视图结构一致的新视图(包含”请改用 dws aitable view duplicate" ], "canonical_path": "aitable.view_lock", "cli_name": "lock", "cli_path": "aitable view lock", "confirmation": "not_required", "description": "锁定或解锁指定视图(View)。\r\n\r\n- lock:锁定后视图不再允许被修改或删除\r\n- unlock:解锁后恢复可编辑状态\r\n\r\n操作幂等:对已锁定视图再次 lock 或对未锁定视图再次 unlock 不会报错。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view lock --view-id VIEW_ID", "dws aitable view lock --view-id VIEW_ID --off" ], "group": "view", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "lock_or_unlock_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_lock", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "off": { "description": "解锁视图（不传则锁定）", "property": "off", "required": false, "type": "boolean" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_lock", "primary_cli_path": "aitable view lock", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "锁定或解锁视图", "use_when": [ "4) 锁定视图，防止他人改坏", "解锁", "锁定（默认）" ] }, "aitable.view_update_aggregate": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新视图的聚合统计（汇总行）", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“设置指定表格视图（Grid View）的条件填色规则（全量覆盖）”请改用 dws aitable view update fill-color-rule" ], "canonical_path": "aitable.view_update_aggregate", "cli_name": "aggregate", "cli_path": "aitable view update aggregate", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view update aggregate --view-id GRID_ID --field-id fldX --action SUM" ], "group": "view.update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_update_aggregate", "parameter_count": 7, "parameters": { "action": { "description": "聚合 action: SUM|AVG|MAX|MIN|MEDIAN|RANGE|...（配合 --field-id）", "property": "action", "required": false, "type": "string" }, "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "clear-field-id": { "description": "清除聚合的字段 ID 列表 (CSV)", "property": "clearFieldId", "required": false, "type": "string" }, "field-id": { "description": "单字段 ID（配合 --action 写入单个聚合）", "property": "fieldId", "required": false, "type": "string" }, "json": { "description": "完整 aggregate map JSON", "property": "json", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_update_aggregate", "primary_cli_path": "aitable view update aggregate", "product_id": "aitable", "reviewed": true, "risk": "medium", "source": "hardcoded:aitable", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, "aitable.view_update_card": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新视图的卡片视图样式", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate", "要“设置指定表格视图（Grid View）的条件填色规则（全量覆盖）”请改用 dws aitable view update fill-color-rule" ], "canonical_path": "aitable.view_update_card", "cli_name": "card", "cli_path": "aitable view update card", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view update card --view-id KANBAN_ID --cover-field-id fldAttachment --cover-resize-mode contain", "dws aitable view update card --view-id KANBAN_ID --no-cover" ], "group": "view.update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_update_card", "parameter_count": 10, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "cover-field-id": { "description": "封面字段 ID (Kanban / Gallery 通用)", "property": "coverFieldId", "required": false, "type": "string" }, "cover-mode": { "description": "封面模式 (仅 Gallery): none|auto|custom", "property": "coverMode", "required": false, "type": "string" }, "cover-resize-mode": { "description": "封面缩放: cover|contain|stretch", "property": "coverResizeMode", "required": false, "type": "string" }, "display-field-name": { "description": "是否显示字段名 (仅 Gallery)", "property": "displayFieldName", "required": false, "type": "boolean" }, "hidden-field-title": { "description": "隐藏字段名标题 (仅 Kanban)", "property": "hiddenFieldTitle", "required": false, "type": "boolean" }, "json": { "description": "完整 card 子块 JSON，与 typed flag 同时存在时 typed flag 优先", "property": "json", "required": true, "type": "string" }, "no-cover": { "description": "清除封面 (Kanban / Gallery 通用)；与 --cover-field-id 互斥", "property": "noCover", "required": false, "type": "boolean" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_update_card", "primary_cli_path": "aitable view update card", "product_id": "aitable", "reviewed": true, "risk": "medium", "source": "hardcoded:aitable", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, "aitable.view_update_field_widths": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新视图的各列列宽", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate", "要“设置指定表格视图（Grid View）的条件填色规则（全量覆盖）”请改用 dws aitable view update fill-color-rule" ], "canonical_path": "aitable.view_update_field_widths", "cli_name": "field-widths", "cli_path": "aitable view update field-widths", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view update field-widths --view-id GRID_ID --field-id fldX --width 200", "dws aitable view update field-widths --view-id GRID_ID --json '{\"fldA\":120,\"fldB\":200}'" ], "group": "view.update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_update_field_widths", "parameter_count": 6, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "field-id": { "description": "单字段 ID（配合 --width）", "property": "fieldId", "required": false, "type": "string" }, "json": { "description": "完整 fieldWidths map JSON", "property": "json", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" }, "width": { "description": "字段列宽（配合 --field-id）", "property": "width", "required": false, "type": "integer" } }, "path": "aitable.view_update_field_widths", "primary_cli_path": "aitable view update field-widths", "product_id": "aitable", "reviewed": true, "risk": "medium", "source": "hardcoded:aitable", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, "aitable.view_update_fill_color_rule": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_fill_color_rule", "skills/mono/references/products/aitable/aitable-view-extras.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "设置指定表格视图（Grid View）的条件填色规则（全量覆盖）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_fill_color_rule", "cli_name": "fill-color-rule", "cli_path": "aitable view update fill-color-rule", "confirmation": "not_required", "description": "设置指定表格视图（Grid View）的条件填色规则（全量覆盖）。传空数组 [] 表示清空当前视图的填色规则。单次最多设置 40 条规则；超出会被拒绝。注意：每条规则的 filters 数组只能有 1 条（filters[0]）。如需多条件，请拆成多条规则。仅支持 Grid 视图；锁定视图不允许修改。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view update fill-color-rule --view-id GRID_ID --json '[", "dws aitable view update fill-color-rule --view-id GRID_ID --json '[]'" ], "group": "view.update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "set_view_fill_color_rule" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_update_fill_color_rule", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "json": { "description": "conditionalFormats JSON 数组（整组替换；传 [] 清空）(必填)", "property": "json", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识，必须是表格视图（Grid View）类型。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_update_fill_color_rule", "primary_cli_path": "aitable view update fill-color-rule", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "设置视图填色规则", "use_when": [ "1) 给金额字段 \u003e 100 的单元格上 firstLine5 色", "2) 清空所有规则", "3) 金额 \u003e 100 的单元格上色" ] }, "aitable.view_update_filter": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新视图的筛选条件", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_filter", "cli_name": "filter", "cli_path": "aitable view update filter", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view update filter --view-id VIEW_ID --json '[{\"operator\":\"and\",\"operands\":[{\"operator\":\"eq\",\"operands\":[\"fldX\",\"value\"]}]}]'" ], "group": "view.update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_update_filter", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "json": { "description": "filter 数组 JSON", "example": "[{\"operator\":\"and\",\"operands\":[{\"operator\":\"eq\",\"operands\":[\"fldX\",\"value\"]}]}]", "format": "json", "property": "json", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_update_filter", "primary_cli_path": "aitable view update filter", "product_id": "aitable", "reviewed": true, "risk": "medium", "source": "hardcoded:aitable", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, "aitable.view_update_frozen_cols": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_frozen_cols", "skills/mono/references/products/aitable/aitable-view-extras.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "设置指定视图(View)的冻结列数(左侧固定列),默认 1。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_frozen_cols", "cli_name": "frozen-cols", "cli_path": "aitable view update frozen-cols", "confirmation": "not_required", "description": "设置指定视图(View)的冻结列数(左侧固定列),默认 1。\r\n\r\n通过 baseId / tableId / viewId 三元组定位目标视图。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view update frozen-cols --view-id VIEW_ID --count 1", "dws aitable view update frozen-cols --view-id VIEW_ID --count 0" ], "group": "view.update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "set_frozen_columns_of_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_update_frozen_cols", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "count": { "description": "冻结列数（\u003e=0；0 表示取消冻结）(必填)", "interface_description": "冻结的左侧列数，默认 1。", "interface_type": "number", "property": "count", "required": true, "type": "integer" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_update_frozen_cols", "primary_cli_path": "aitable view update frozen-cols", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "设置视图冻结列数", "use_when": [ "1) 关键字段冻结，避免横向滚动看不到", "冻结从首列起 1 列", "取消冻结" ] }, "aitable.view_update_group": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新视图的分组", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_group", "cli_name": "group", "cli_path": "aitable view update group", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view update group --view-id VIEW_ID --json '[{\"fieldId\":\"fldX\",\"direction\":\"asc\"}]'" ], "group": "view.update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_update_group", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "json": { "description": "group 数组 JSON", "example": "[{\"fieldId\":\"fldX\",\"direction\":\"asc\"}]", "format": "json", "property": "json", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_update_group", "primary_cli_path": "aitable view update group", "product_id": "aitable", "reviewed": true, "risk": "medium", "source": "hardcoded:aitable", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, "aitable.view_update_name": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "重命名视图（修改视图名称）", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_name", "cli_name": "name", "cli_path": "aitable view update name", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view update name --view-id VIEW_ID --name \"新视图名\"" ], "group": "view.update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_update_name", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "name": { "description": "新视图名称 (必填)", "property": "name", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_update_name", "primary_cli_path": "aitable view update name", "product_id": "aitable", "reviewed": true, "risk": "medium", "source": "hardcoded:aitable", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, "aitable.view_update_row_height": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_row_height", "skills/mono/references/products/aitable/aitable-view-extras.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "设置指定视图(View)的单元格高度(行高),单位为像素,默认 32。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_row_height", "cli_name": "row-height", "cli_path": "aitable view update row-height", "confirmation": "not_required", "description": "设置指定视图(View)的单元格高度(行高),单位为像素,默认 32。\r\n\r\n通过 baseId / tableId / viewId 三元组定位目标视图。\r\n\r\n工具层不做范围或枚举校验,超出下游允许范围的取值由下游回填错误。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view update row-height --view-id VIEW_ID --cell-height 56", "dws aitable view update row-height --base-id $BASE --table-id $TABLE --view-id $VIEW --cell-height 56" ], "group": "view.update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "set_cell_height_of_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_update_row_height", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "cell-height": { "description": "单元格高度（像素），合法档位 32 / 56 / 88 / 128 (必填)", "interface_description": "行高像素值，合法档位为 32 / 56 / 88 / 128，与前端 CELL_HEIGHTS 约定保持一致。", "interface_type": "number", "property": "cellHeight", "required": true, "type": "integer" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_update_row_height", "primary_cli_path": "aitable view update row-height", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "set_cell_height_of_view", "use_when": [ "2) 加大行高让数据更易读", "设置行高 — 推荐档位 32 / 56 / 88 / 128" ] }, "aitable.view_update_sort": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新视图的排序规则", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_sort", "cli_name": "sort", "cli_path": "aitable view update sort", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view update sort --view-id VIEW_ID --json '[{\"fieldId\":\"fldX\",\"direction\":\"asc\"}]'" ], "group": "view.update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_update_sort", "parameter_count": 4, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "json": { "description": "sort 数组 JSON", "example": "[{\"fieldId\":\"fldX\",\"direction\":\"asc\"}]", "format": "json", "property": "json", "required": true, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_update_sort", "primary_cli_path": "aitable view update sort", "product_id": "aitable", "reviewed": true, "risk": "medium", "source": "hardcoded:aitable", "title": "update_view", "use_when": [ "更新指定视图（View）的名称、描述或配置。" ] }, "aitable.view_update_timebar": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新视图的时间条（甘特/时间轴）", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_timebar", "cli_name": "timebar", "cli_path": "aitable view update timebar", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view update timebar --view-id GANTT_ID --start-field fldStart --end-field fldEnd --timeline-scale month", "dws aitable view update timebar --view-id GANTT_ID --official-holiday=true" ], "group": "view.update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_update_timebar", "parameter_count": 10, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "color-configs": { "description": "颜色配置 JSON 数组", "property": "colorConfigs", "required": false, "type": "string" }, "display-field-id": { "description": "时间条上显示的标题字段 ID", "property": "displayFieldId", "required": false, "type": "string" }, "end-field": { "description": "结束日期字段 ID", "property": "endField", "required": false, "type": "string" }, "json": { "description": "完整 ganttTimebar 子块 JSON", "property": "json", "required": true, "type": "string" }, "official-holiday": { "description": "是否标注法定节假日", "property": "officialHoliday", "required": false, "type": "boolean" }, "start-field": { "description": "开始日期字段 ID", "property": "startField", "required": false, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "timeline-scale": { "description": "时间尺度: year|quarter|month|weeks", "property": "timelineScale", "required": false, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_update_timebar", "primary_cli_path": "aitable view update timebar", "product_id": "aitable", "reviewed": true, "risk": "medium", "source": "hardcoded:aitable", "title": "update_view", "use_when": [ "第 2 步（必须）：绑定日期字段，否则视图为空" ] }, "aitable.view_update_visible_fields": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/aitable/aitable-view-config.md", "skills/mono/schema-hints/aitable-view-review.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新视图的可见字段及顺序", "agent_summary_source": "aitable-view-summary-review-v1", "availability": "available", "avoid_when": [ "要“更新视图的卡片视图样式”请改用 dws aitable view update card", "要“更新视图的各列列宽”请改用 dws aitable view update field-widths", "要“更新视图的聚合统计（汇总行）”请改用 dws aitable view update aggregate" ], "canonical_path": "aitable.view_update_visible_fields", "cli_name": "visible-fields", "cli_path": "aitable view update visible-fields", "confirmation": "not_required", "description": "更新指定视图（View）的名称、描述或配置。\r\n当前稳定支持更新：newViewName、viewDescription、visibleFieldIds、filter、sort、group；fieldWidths 和 aggregate 仅支持 Grid 视图。\r\n首列字段是每条数据的索引，不支持删除、移动或隐藏。\r\n对 Kanban / Gantt / Gallery 视图，config 入参支持 kanbanCard / ganttTimebar / galleryCard 三个类型化配置块进行局部更新（传谁更新谁）；若视图类型与块不匹配会返回 INVALID_UPDATE_VIEW_REQUEST。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable view update visible-fields --view-id VIEW_ID --field-ids fldPrimary,fldA", "dws aitable view update visible-fields --view-id VIEW_ID --json '[\"fldPrimary\",\"fldA\",\"fldB\"]'" ], "group": "view.update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable", "rpc_name": "update_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "view_update_visible_fields", "parameter_count": 5, "parameters": { "base-id": { "description": "所属 Base ID (必填)", "interface_description": "所属 Base 的唯一标识。", "property": "baseId", "required": true, "type": "string" }, "field-ids": { "description": "可见字段 ID 列表 (CSV)，整组替换原有顺序", "property": "fieldIds", "required": true, "type": "string" }, "json": { "description": "可见字段 ID 数组 JSON", "property": "json", "required": false, "type": "string" }, "table-id": { "description": "所属 Table ID (必填)", "interface_description": "所属数据表（Table）的唯一标识。", "property": "tableId", "required": true, "type": "string" }, "view-id": { "description": "目标 View ID (必填)", "interface_description": "目标视图（View）的唯一标识。", "property": "viewId", "required": true, "type": "string" } }, "path": "aitable.view_update_visible_fields", "primary_cli_path": "aitable view update visible-fields", "product_id": "aitable", "reviewed": true, "risk": "medium", "source": "hardcoded:aitable", "title": "update_view", "use_when": [ "传回全量列表解除隐藏", "只保留首列和 fldA，其余字段被隐藏" ] }, "aitable.workflow_disable": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.workflow_disable", "skills/mono/references/products/aitable/aitable-workflow.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "禁用指定 Base 中的自动化工作流。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 中的自动化工作流，直接返回下游 search”请改用 dws aitable workflow list", "要“启用指定 Base 中的自动化工作流”请改用 dws aitable workflow enable", "要“获取指定 Base 中某个自动化工作流的详细信息，直接返回下游”请改用 dws aitable workflow get" ], "canonical_path": "aitable.workflow_disable", "cli_name": "disable", "cli_path": "aitable workflow disable", "confirmation": "user_required", "description": "禁用指定 Base 中的自动化工作流。禁用后工作流将不再自动触发执行。", "display": "AI 表格操作", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws aitable workflow disable --base-id \u003cbase-id\u003e --workflow-id \u003cworkflow-id\u003e" ], "group": "workflow", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "disable_workflow" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "workflow_disable", "parameter_count": 2, "parameters": { "base-id": { "description": "目标 Base ID (必填)", "interface_description": "所属 Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "workflow-id": { "description": "目标工作流 ID (必填)", "interface_description": "目标工作流 ID", "property": "workflowId", "required": true, "type": "string" } }, "path": "aitable.workflow_disable", "primary_cli_path": "aitable workflow disable", "product_id": "aitable", "reviewed": false, "risk": "high", "source": "hardcoded:aitable", "title": "禁用自动化工作流", "use_when": [ "2. 禁用" ] }, "aitable.workflow_enable": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.workflow_enable", "skills/mono/references/products/aitable/aitable-workflow.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "启用指定 Base 中的自动化工作流。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 中的自动化工作流，直接返回下游 search”请改用 dws aitable workflow list", "要“禁用指定 Base 中的自动化工作流”请改用 dws aitable workflow disable", "要“获取指定 Base 中某个自动化工作流的详细信息，直接返回下游”请改用 dws aitable workflow get" ], "canonical_path": "aitable.workflow_enable", "cli_name": "enable", "cli_path": "aitable workflow enable", "confirmation": "not_required", "description": "启用指定 Base 中的自动化工作流。启用后工作流将按配置的触发条件自动执行。", "display": "AI 表格操作", "effect": "write", "effect_source": "command-verb", "examples": [ "dws aitable workflow enable --base-id BASE_ID --workflow-id WORKFLOW_ID --format json" ], "group": "workflow", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "enable_workflow" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "workflow_enable", "parameter_count": 2, "parameters": { "base-id": { "description": "目标 Base ID (必填)", "interface_description": "所属 Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "workflow-id": { "description": "目标工作流 ID (必填)", "interface_description": "目标工作流 ID", "property": "workflowId", "required": true, "type": "string" } }, "path": "aitable.workflow_enable", "primary_cli_path": "aitable workflow enable", "product_id": "aitable", "reviewed": false, "risk": "medium", "source": "hardcoded:aitable", "title": "启用自动化工作流", "use_when": [ "3. 调试做完后重启" ] }, "aitable.workflow_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.workflow_get", "skills/mono/references/products/aitable/aitable-workflow.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取指定 Base 中某个自动化工作流的详细信息，直接返回下游 getFlowDetail 的详情结构。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定 Base 中的自动化工作流，直接返回下游 search”请改用 dws aitable workflow list", "要“启用指定 Base 中的自动化工作流”请改用 dws aitable workflow enable", "要“禁用指定 Base 中的自动化工作流”请改用 dws aitable workflow disable" ], "canonical_path": "aitable.workflow_get", "cli_name": "get", "cli_path": "aitable workflow get", "confirmation": "not_required", "description": "获取指定 Base 中某个自动化工作流的详细信息，直接返回下游 getFlowDetail 的详情结构。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable workflow get --base-id BASE_ID --workflow-id WORKFLOW_ID --format json", "dws aitable workflow get --base-id BASE_ID --workflow-id WORKFLOW_ID --format json \u003e /tmp/wf-backup.json" ], "group": "workflow", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "get_workflow" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "workflow_get", "parameter_count": 2, "parameters": { "base-id": { "description": "目标 Base ID (必填)", "interface_description": "所属 Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "workflow-id": { "description": "目标工作流 ID (必填)", "interface_description": "目标工作流 ID", "property": "workflowId", "required": true, "type": "string" } }, "path": "aitable.workflow_get", "primary_cli_path": "aitable workflow get", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "获取自动化工作流", "use_when": [ "1. 留底当前状态" ] }, "aitable.workflow_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.aitable.workflow_list", "skills/mono/references/products/aitable/aitable-workflow.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "列出指定 Base 中的自动化工作流，直接返回下游 searchFlows 的响应结构。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“启用指定 Base 中的自动化工作流”请改用 dws aitable workflow enable", "要“禁用指定 Base 中的自动化工作流”请改用 dws aitable workflow disable", "要“获取指定 Base 中某个自动化工作流的详细信息，直接返回下游”请改用 dws aitable workflow get" ], "canonical_path": "aitable.workflow_list", "cli_name": "list", "cli_path": "aitable workflow list", "confirmation": "not_required", "description": "列出指定 Base 中的自动化工作流，直接返回下游 searchFlows 的响应结构。支持分页，limit 默认 20，最大 100；offset 默认 0。", "display": "AI 表格操作", "effect": "read", "effect_source": "command-verb", "examples": [ "dws aitable workflow list --base-id BASE_ID --format json", "dws aitable workflow list --base-id BASE_ID --limit 50 --offset 100" ], "group": "workflow", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "aitable-helper", "rpc_name": "list_workflows" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "workflow_list", "parameter_count": 3, "parameters": { "base-id": { "description": "目标 Base ID (必填)", "interface_description": "所属 Base ID（通过 list_bases / search_bases 获取）", "property": "baseId", "required": true, "type": "string" }, "limit": { "description": "分页大小 [1, 100]，不传走服务端默认 20", "interface_description": "可选，分页大小。默认 20，最大 100", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "offset": { "description": "分页偏移量，\u003e= 0，不传走服务端默认 0", "interface_description": "可选，分页偏移量。默认 0，必须大于等于 0", "interface_type": "number", "property": "offset", "required": false, "type": "integer" } }, "path": "aitable.workflow_list", "primary_cli_path": "aitable workflow list", "product_id": "aitable", "reviewed": false, "risk": "low", "source": "hardcoded:aitable", "title": "列出自动化工作流", "use_when": [ "4. 确认 status=RUNNING" ] }, "attendance.adjustment_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询单个补卡规则详情", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "不知道补卡规则ID时先用 attendance adjustment search", "查询加班规则详情时使用 attendance overtime get", "查询补卡审批单记录时使用 attendance approve list" ], "canonical_path": "attendance.adjustment_get", "cli_name": "get", "cli_path": "attendance adjustment get", "confirmation": "not_required", "description": "调用 MCP 工具 get_adjustment_rule_detail，根据补卡规则主键 ID 查询对应的补卡规则详情。\n--adjustment-id 必填。注意：已被删除或被更新覆盖的补卡规则无法查询到。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance adjustment get --adjustment-id 12345", "dws attendance adjustment get --adjustment-id 12345 --format json" ], "group": "adjustment", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "adjustment_get", "parameter_count": 1, "parameters": { "adjustment-id": { "description": "补卡规则主键 ID（必填）", "property": "adjustmentId", "required": true, "type": "integer" } }, "path": "attendance.adjustment_get", "primary_cli_path": "attendance adjustment get", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "根据补卡规则主键 ID 查询补卡规则详情", "use_when": [ "已取得补卡规则ID，需要查看规则详情" ] }, "attendance.adjustment_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询补卡规则列表", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "已知道补卡规则ID并要看详情时使用 attendance adjustment get", "查询加班规则时使用 attendance overtime search", "查询员工打卡/考勤记录时使用 attendance record get 或 attendance check record" ], "canonical_path": "attendance.adjustment_search", "cli_name": "search", "cli_path": "attendance adjustment search", "confirmation": "not_required", "description": "根据用户权限查询补卡规则列表，入参封装在 ATRuleQueryParam 对象中。\n --query 补卡规则名称关键字，模糊搜索（可选）\n --page 页码（从 1 开始，默认 1）（必填）\n --limit 每页条数（200 以内，默认 20）（必填）", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance adjustment search --page 1 --limit 20", "dws attendance adjustment search --query \"标准\" --page 1 --limit 50" ], "group": "adjustment", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "adjustment_search", "parameter_count": 3, "parameters": { "limit": { "default": "20", "description": "每页条数，200 以内（必填）", "property": "limit", "required": true, "type": "integer" }, "page": { "default": "1", "description": "页码，从 1 开始（必填）", "property": "page", "required": true, "type": "integer" }, "query": { "description": "补卡规则名称关键字，模糊搜索（可选）", "property": "query", "required": false, "type": "string" } }, "path": "attendance.adjustment_search", "primary_cli_path": "attendance adjustment search", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询当前用户可管理的补卡规则列表", "use_when": [ "需要查看有哪些补卡规则或筛选补卡规则" ] }, "attendance.approve_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/intent-guide.md", "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询考勤相关审批单记录", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查询假期余额时使用 attendance vacation balance", "查询实际打卡记录时使用 attendance record get 或 attendance check record", "需要获取可提交审批的模板/跳转链接时使用 attendance approve templates" ], "canonical_path": "attendance.approve_list", "cli_name": "list", "cli_path": "attendance approve list", "confirmation": "not_required", "description": "查询指定用户的考勤业务审批单记录（补卡 / 加班 / 请假 / 出差外出）。\n审批类型 --types 支持以下关键词（多个用英文逗号分隔）：\n - overtime / 加班 → bizType=1\n - trip / travel / business_trip / business-trip / 出差 / 外出 → bizType=2（出差与外出在查询接口合并为同一类，不再细分）\n - leave / 请假 → bizType=3\n - patch / repair-check / repair_check / 补卡 → bizType=4\n说明：\n - 服务端查询接口 bizType=2 同时覆盖出差与外出，传入 trip / travel / 出差 / 外出 任一别名都会返回这两类合并的记录；\n - 如需在提交入口区分外出（TRAVEL）与出差（OUT），请改用 dws attendance approve templates --type travel|out；\n - 返回每条记录含：用户 ID、审批标签、审批子类型、审批类型、生效时间、时长、时长单位、流程实例 ID。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance approve list --users userId1 --types overtime,leave --start 2026-04-01 --end 2026-04-30", "dws attendance approve list --users userId1 --types trip --start 2026-04-01 --end 2026-04-30 # 同时返回出差与外出" ], "group": "approve", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "approve_list", "parameter_count": 4, "parameters": { "end": { "description": "结束日期，格式 YYYY-MM-DD (必填)", "property": "end", "required": true, "type": "string" }, "start": { "description": "起始日期，格式 YYYY-MM-DD (必填)", "property": "start", "required": true, "type": "string" }, "types": { "description": "审批类型，逗号分隔：overtime/trip/leave/patch (必填)", "property": "types", "required": true, "type": "string" }, "users": { "description": "用户 ID 列表，逗号分隔 (必填)", "property": "users", "required": true, "type": "string" } }, "path": "attendance.approve_list", "primary_cli_path": "attendance approve list", "product_id": "attendance", "reviewed": true, "risk": "medium", "source": "hardcoded:attendance", "title": "查询用户审批单（补卡/加班/请假/出差外出）", "use_when": [ "查询补卡、加班、请假、出差外出等考勤审批记录" ] }, "attendance.approve_templates": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询考勤审批模板和提交入口", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查看已存在审批单记录时使用 attendance approve list", "查询考勤记录/统计时使用 attendance record get 或 attendance summary", "配置考勤规则时使用 attendance group/globalsetting/class 相关命令" ], "canonical_path": "attendance.approve_templates", "cli_name": "templates", "cli_path": "attendance approve templates", "confirmation": "not_required", "description": "当用户需要提交补卡、请假、加班、外出、出差时，查询对应考勤审批表单模板，返回审批提交跳转链接。\n审批类型支持：repair-check/patch/补卡、leave/请假、overtime/加班、travel/外出、out/trip/出差，也支持直接传 REPAIR_CHECK、LEAVE、OVERTIME、TRAVEL、OUT。\n向用户展示提交入口时，不要直接裸露 submitUrl，应使用 Markdown 可点击链接格式：[表单名称](submitUrl)。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance approve templates --type leave", "dws attendance approve templates --type REPAIR_CHECK" ], "group": "approve", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "approve_templates", "parameter_count": 1, "parameters": { "type": { "description": "审批类型：repair-check/patch/补卡、leave/请假、overtime/加班，或 REPAIR_CHECK/LEAVE/OVERTIME（必填）", "property": "type", "required": true, "type": "string" } }, "path": "attendance.approve_templates", "primary_cli_path": "attendance approve templates", "product_id": "attendance", "reviewed": true, "risk": "medium", "source": "hardcoded:attendance", "title": "查询补卡/请假/加班/外出/出差审批提交链接", "use_when": [ "用户要发起补卡、请假、加班、外出或出差审批前查询可用模板" ] }, "attendance.batch_get_employee_shifts": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.attendance.prod.json#attendance.batch_get_employee_shifts", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "批量查询员工班次信息", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查询实际排班记录时使用 attendance schedule get", "查询班次定义/班次ID时使用 attendance class search 或 attendance class get", "查询考勤组与规则时使用 attendance rules" ], "canonical_path": "attendance.batch_get_employee_shifts", "cli_name": "list", "cli_path": "attendance shift list", "confirmation": "not_required", "description": "批量查询多个员工在指定日期的考勤班次信息，返回每条记录包含：用户 ID（userId）、工作日期（workDate，毫秒时间戳）、打卡类型（checkType，如 OnDuty 表示上班）、计划打卡时间（planCheckTime，毫秒时间戳）以及是否为休息日（isRest，\"Y\"/\"N\"）。结果基于组织考勤配置生成，仅返回调用者有权限查看的员工数据，适用于排班核对、考勤预览等场景。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance shift list --users userId1,userId2 --start 2026-03-03 --end 2026-03-07 # 查询 userId: dws contact user search --keyword \"姓名\"" ], "group": "shift", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "attendance", "rpc_name": "batch_get_employee_shifts" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "batch_get_employee_shifts", "parameter_count": 3, "parameters": { "end": { "description": "结束日期，格式 YYYY-MM-DD (必填)", "format": "date", "property": "end", "required": true, "type": "string" }, "start": { "description": "开始日期，格式 YYYY-MM-DD (必填)", "format": "date", "property": "start", "required": true, "type": "string" }, "users": { "description": "用户 ID 列表，逗号分隔，最多 50 个 (必填)", "interface_type": "array", "property": "users", "required": true, "type": "string" } }, "path": "attendance.batch_get_employee_shifts", "primary_cli_path": "attendance shift list", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "batch_get_employee_shifts", "use_when": [ "按员工和日期范围查询班次/排班班次" ] }, "attendance.boss_check": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/attendance-example-normalization.json", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "管理员修正员工打卡结果", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "只查询打卡记录时使用 attendance check record/check result", "未获得用户明确确认时不要修改打卡结果", "查询考勤统计时使用 attendance summary" ], "canonical_path": "attendance.boss_check", "cli_name": "boss-check", "cli_path": "attendance boss-check", "confirmation": "user_required", "description": "调用 MCP 工具 boss_check 修改员工打卡记录。管理员可修改打卡时间、打卡结果等信息。\n\n参数说明：\n --plan-id 排班ID（与 --result-id 二选一）\n 来源：通过 dws attendance schedule get 获取，返回结果的 id 字段\n 示例：id: 948964045503 表示某天下班打卡的排班记录ID\n\n --result-id 打卡结果ID（与 --plan-id 二选一，优先使用）\n 来源：暂不支持（record get 未返回此字段），建议使用 --plan-id\n\n --time 新打卡时间，格式 yyyy-MM-dd HH:mm（可选）\n --result 打卡结果：Normal/TimesResultA/TimesResultB/TimesResultC/TimesResultD/TimesResultE/TimesResultF（可选）\n --absent-min 缺勤时长（分钟），当 result 为异常状态时需传值（可选）\n --remark 备注，最长500字符（可选）\n --user-say-yes 用户已确认，跳过交互式确认提示\n\n打卡结果枚举值：\n Normal 正常\n TimesResultA 迟到\n TimesResultB 早退\n TimesResultC 缺卡\n TimesResultD 迟到+早退\n TimesResultE 缺卡+早退\n TimesResultF 迟到+缺卡\n\n获取 planId 步骤：\n 1. 查询排班记录：dws attendance schedule get --userIdList USER_ID --workDateBegin DATE --workDateEnd DATE\n 2. 从返回结果中找到对应打卡类型（OnDuty=上班，OffDuty=下班）的 id 字段\n 3. 使用该 id 作为 --plan-id 参数", "display": "考勤打卡 / 排班 / 统计", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws attendance boss-check --help" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "boss_check", "parameter_count": 7, "parameters": { "absent-min": { "description": "缺勤时长（分钟）（可选）", "property": "absentMin", "required": false, "type": "integer" }, "plan-id": { "description": "排班ID（与 --result-id 二选一）", "property": "planId", "required": true, "type": "string" }, "remark": { "description": "备注，最长500字符（可选）", "property": "remark", "required": false, "type": "string" }, "result": { "description": "打卡结果：Normal/TimesResultA/TimesResultB/TimesResultC/TimesResultD/TimesResultE/TimesResultF（可选）", "property": "result", "required": false, "type": "string" }, "result-id": { "description": "打卡结果ID（与 --plan-id 二选一，优先使用）", "property": "resultId", "required": false, "type": "string" }, "time": { "description": "新打卡时间，格式 yyyy-MM-dd HH:mm（可选）", "property": "time", "required": false, "type": "string" }, "user-say-yes": { "description": "用户已确认，跳过交互式确认提示", "property": "userSayYes", "required": false, "type": "boolean" } }, "path": "attendance.boss_check", "primary_cli_path": "attendance boss-check", "product_id": "attendance", "reviewed": true, "risk": "high", "source": "hardcoded:attendance", "title": "BOSS 改签打卡记录", "use_when": [ "管理员确认需要人工修正员工打卡记录或打卡结果" ] }, "attendance.check_record": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询打卡记录", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改打卡结果时使用 attendance boss-check", "查询考勤统计摘要时使用 attendance summary", "查询考勤详情时使用 attendance record get" ], "canonical_path": "attendance.check_record", "cli_name": "record", "cli_path": "attendance check record", "confirmation": "not_required", "description": "查询指定用户的打卡流水记录。\n返回每条记录含：用户 ID、实际打卡时间、打卡地址、打卡经纬度、\n打卡类型（OnDuty/OffDuty）、定位方式（Map/Wifi/etc）。\n时间跨度不超过 1 个月。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance check record --users userId1 --start 2026-04-01 --end 2026-04-30" ], "group": "check", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "check_record", "parameter_count": 3, "parameters": { "end": { "description": "结束日期，格式 YYYY-MM-DD，不超过 1 个月 (必填)", "property": "end", "required": true, "type": "string" }, "start": { "description": "起始日期，格式 YYYY-MM-DD (必填)", "property": "start", "required": true, "type": "string" }, "users": { "description": "用户 ID 列表，逗号分隔 (必填)", "property": "users", "required": true, "type": "string" } }, "path": "attendance.check_record", "primary_cli_path": "attendance check record", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询打卡流水", "use_when": [ "查询员工打卡流水或打卡记录" ] }, "attendance.check_result": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询打卡结果", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改打卡结果时使用 attendance boss-check", "查询原始打卡流水时使用 attendance check record", "查询统计摘要时使用 attendance summary" ], "canonical_path": "attendance.check_result", "cli_name": "result", "cli_path": "attendance check result", "confirmation": "not_required", "description": "查询指定用户的打卡结果记录。\n返回每条记录含：用户 ID、工作日期、时间结果（Normal/Late/Early/Absenteeism/NotSigned）、\n位置结果、计划打卡时间、实际打卡时间、打卡流水 ID。\n时间跨度不超过 1 个月，最多 100 人。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance check result --users userId1,userId2 --start 2026-04-01 --end 2026-04-30 --limit 50" ], "group": "check", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "check_result", "parameter_count": 5, "parameters": { "end": { "description": "结束日期，格式 YYYY-MM-DD，不超过 1 个月 (必填)", "property": "end", "required": true, "type": "string" }, "limit": { "default": "100", "description": "分页大小，默认 100，范围 1-1000（可选）", "property": "limit", "required": false, "type": "integer" }, "offset": { "description": "分页偏移量，默认 0（可选）", "property": "offset", "required": false, "type": "integer" }, "start": { "description": "起始日期，格式 YYYY-MM-DD (必填)", "property": "start", "required": true, "type": "string" }, "users": { "description": "用户 ID 列表，逗号分隔，最多 100 个 (必填)", "property": "users", "required": true, "type": "string" } }, "path": "attendance.check_result", "primary_cli_path": "attendance check result", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询打卡结果", "use_when": [ "查询员工打卡结果或考勤结果" ] }, "attendance.checkin_records": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询打卡流水记录", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改打卡记录时使用 attendance boss-check", "查询班次/排班时使用 attendance shift list 或 schedule get", "查询考勤汇总时使用 attendance summary" ], "canonical_path": "attendance.checkin_records", "cli_name": "records", "cli_path": "attendance checkin records", "confirmation": "not_required", "description": "查询指定员工在一段时间内的签到记录。\n权限说明：\n - Boss / 超级管理员 / 超级子管理员：可查看全公司员工\n - 子管理员：可查看管理范围内的员工及自己\n - 部门主管：可查看所管理部门的员工及自己\n - 普通员工：只能查询自己\n\n日期格式：yyyy-MM-dd HH:mm:ss（如 2026-04-01 09:00:00）", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance checkin records --operator-corp-id corp001 --operator-staff-id op001 --staff-ids user001,user002 --start \"2026-04-01 00:00:00\" --end \"2026-04-07 00:00:00\"", "dws attendance checkin records --operator-corp-id corp001 --operator-staff-id op001 --staff-ids user001,user002 --start \"2026-04-01 00:00:00\" --end \"2026-04-07 00:00:00\" --format json" ], "group": "checkin", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "checkin_records", "parameter_count": 5, "parameters": { "end": { "description": "结束时间, 格式 yyyy-MM-dd HH:mm:ss（必填），开始到结束最多7天", "property": "end", "required": true, "type": "string" }, "operator-corp-id": { "description": "操作者企业 ID（必填）", "property": "operatorCorpId", "required": true, "type": "string" }, "operator-staff-id": { "description": "操作者员工 ID（必填）", "property": "operatorStaffId", "required": true, "type": "string" }, "staff-ids": { "description": "目标员工 ID 列表, 逗号分隔（必填），最多100人", "property": "staffIds", "required": true, "type": "string" }, "start": { "description": "开始时间, 格式 yyyy-MM-dd HH:mm:ss（必填），开始到结束最多7天", "property": "start", "required": true, "type": "string" } }, "path": "attendance.checkin_records", "primary_cli_path": "attendance checkin records", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询指定员工的签到记录", "use_when": [ "查询员工打卡流水、定位或打卡时间记录" ] }, "attendance.class_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "创建班次定义", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改已有班次时使用 attendance class update", "导入员工排班时使用 attendance schedule import", "查询已有班次时使用 attendance class search/get" ], "canonical_path": "attendance.class_create", "cli_name": "create", "cli_path": "attendance class create", "confirmation": "not_required", "description": "调用 MCP 工具 create_class_setting，创建一个新的班次。\n--name 和 --sections 必填，其余参数可选。由于保存班次耗时较久，指令需要带上 --timeout 10\n--yes 需要用户二次确认之后才允许带入，参考attendance.md中对于创建班次的说明\n\n常用 flag：\n --name 班次名称（必填）\n --owner 班次负责人 userId（可选）\n --class-vo 完整 TopAtClassVO JSON 字符串（可选，用于传入复杂结构）\n\n当使用 --class-vo 传入完整 JSON 时，--name 和 --owner 仍可覆写 JSON 中的同名字段。\ncheckTime 字段统一使用 \"HH:mm\" 格式（如 \"09:00\"），CLI 自动转换为服务端所需的时间戳。\n\n--class-vo JSON 可用字段说明：\n\n name string 班次名称（必填）\n owner string 班次负责人 userId\n sections []object 班次上下班时间段（必填），支持多段上下班，每段包含 times 数组：\n - times []object 每段有且只能有两个对象（上班+下班），每个对象字段：\n checkType string 打卡类型：OnDuty（上班）/ OffDuty（下班）（必填）\n checkTime string 打卡时间，格式 \"HH:mm\"（必填，如 \"09:00\"、\"17:30\"）\n across number 是否跨天：0（不跨天）/ 1（跨天）（必填）\n freeCheck bool 是否免打卡\n beginMin number 允许最早提前打卡时间（分钟，-1 表示不限制）\n endMin number 允许最晚打卡时间（分钟，-1 表示不限制）\n setting object 班次其他配置：\n - seriousLateMinutes number 晚到多少分钟记为严重迟到\n - absenteeismLateMinutes number 晚到多少分钟记为旷工迟到\n - attendDays number 本班次记为多少天出勤（支持两位小数）\n - topRestTimeList []object 班次休息时间（仅 sections 只有一段上下班时可用，最多 3 段休息时间）：\n checkType string 休息类型：OnDuty（开始休息）/ OffDuty（结束休息）\n checkTime string 休息时间，格式 \"HH:mm\"（如 \"12:00\"、\"13:00\"）\n across number 是否跨天：0/1", "display": "考勤打卡 / 排班 / 统计", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws attendance class create --name \"早班\" --class-vo '{\"sections\":[{\"times\":[{\"checkType\":\"OnDuty\",\"checkTime\":\"08:00\",\"across\":0},{\"checkType\":\"OffDuty\",\"checkTime\":\"17:00\",\"across\":0}]}]}' --timeout 10" ], "group": "class", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "class_create", "parameter_count": 4, "parameters": { "class-vo": { "description": "完整 TopAtClassVO JSON 字符串，包含 sections 等复杂子对象（必填）", "property": "classVo", "required": true, "type": "string" }, "name": { "description": "班次名称（必填）", "property": "name", "required": true, "type": "string" }, "owner": { "description": "班次负责人 userId（可选）", "property": "owner", "required": false, "type": "string" }, "yes": { "description": "跳过确认提示", "property": "yes", "required": false, "type": "boolean" } }, "path": "attendance.class_create", "primary_cli_path": "attendance class create", "product_id": "attendance", "reviewed": true, "risk": "medium", "source": "hardcoded:attendance", "title": "创建班次", "use_when": [ "需要新增一个班次/上下班时间规则" ] }, "attendance.class_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询单个班次定义详情", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "不知道班次ID时先用 attendance class search", "修改班次定义时使用 attendance class update", "查询员工排班记录时使用 attendance schedule get" ], "canonical_path": "attendance.class_get", "cli_name": "get", "cli_path": "attendance class get", "confirmation": "not_required", "description": "调用 MCP 工具 get_class_detail，根据班次 ID 查询该班次的详细信息。--class-id 必填。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance class get --class-id 1170996821", "dws attendance class get --class-id 1170996821 --format json" ], "group": "class", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "class_get", "parameter_count": 1, "parameters": { "class-id": { "description": "班次 ID（必填）", "property": "classId", "required": true, "type": "integer" } }, "path": "attendance.class_get", "primary_cli_path": "attendance class get", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "根据班次 ID 查询班次详情", "use_when": [ "已取得班次ID，需要查看班次配置" ] }, "attendance.class_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询班次定义列表", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "创建或修改班次定义时使用 attendance class create/update", "已知道班次ID并要看详情时使用 attendance class get", "查询员工排班记录时使用 attendance schedule get" ], "canonical_path": "attendance.class_search", "cli_name": "search", "cli_path": "attendance class search", "confirmation": "not_required", "description": "查询当前用户有权管理的班次列表（班次定义），支持按名称搜索和类型过滤。\n所有参数均为可选项：\n --page 页码（从 1 开始，默认 1）\n --limit 每页条数（最大 200，默认 20）\n --query 班次名称关键字，模糊搜索\n --filter-type 班次类型：ALL（全部班次）/ MINE_OWN（我负责的），默认 ALL", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance class search", "dws attendance class search --query \"早班\" --filter-type MINE_OWN" ], "group": "class", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "class_search", "parameter_count": 4, "parameters": { "filter-type": { "description": "班次类型：ALL 全部班次 / MINE_OWN 我负责的（可选）", "property": "filterType", "required": false, "type": "string" }, "limit": { "default": "20", "description": "每页条数，最大 200（可选）", "property": "limit", "required": false, "type": "integer" }, "page": { "default": "1", "description": "页码，从 1 开始（可选）", "property": "page", "required": false, "type": "integer" }, "query": { "description": "班次名称关键字，模糊搜索（可选）", "property": "query", "required": false, "type": "string" } }, "path": "attendance.class_search", "primary_cli_path": "attendance class search", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询当前用户可管理的所有班次详情", "use_when": [ "搜索或列出可用班次/班次ID" ] }, "attendance.class_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "更新班次定义", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "创建新班次时使用 attendance class create", "查询班次详情时使用 attendance class get", "调整员工排班时使用 attendance schedule import" ], "canonical_path": "attendance.class_update", "cli_name": "update", "cli_path": "attendance class update", "confirmation": "not_required", "description": "调用 MCP 工具 update_class_setting，更新一个已有的班次。\n--class-id 必填；其余参数均可选，仅需对要修改的字段进行赋値，未传的字段会自动从已有配置补充。由于保存班次耗时较久，指令需要带上 --timeout 10\n--yes 需要用户二次确认之后才允许带入，参考attendance.md中对于更新班次的说明\n\n常用 flag：\n --class-id 班次 ID（必填）\n --name 班次名称（可选，不传则保持原值）\n --owner 班次负责人 userId（可选，不传则保持原值）\n --class-vo 完整 TopAtClassVO JSON 字符串（可选，用于传入复杂结构）\n\n当使用 --class-vo 传入完整 JSON 时，--name 和 --owner 仍可覆写 JSON 中的同名字段。\ncheckTime 字段统一使用 \"HH:mm\" 格式（如 \"09:00\"），CLI 自动转换为服务端所需的时间戳。\n\n--class-vo JSON 可用字段说明：\n\n name string 班次名称（可选，不传则保持原值）\n owner string 班次负责人 userId（可选，不传则保持原值）\n sections []object 班次上下班时间段（可选，不传则保持原值），支持多段上下班，每段包含 times 数组：\n - times []object 每段有且只能有两个对象（上班+下班），每个对象字段：\n checkType string 打卡类型：OnDuty（上班）/ OffDuty（下班）（必填）\n checkTime string 打卡时间，格式 \"HH:mm\"（必填，如 \"09:00\"、\"17:30\"）\n across number 是否跨天：0（不跨天）/ 1（跨天）（必填）\n freeCheck bool 是否免打卡\n beginMin number 允许最早提前打卡时间（分钟，-1 表示不限制）\n endMin number 允许最晚打卡时间（分钟，-1 表示不限制）\n setting object 班次其他配置：\n - seriousLateMinutes number 晚到多少分钟记为严重迟到\n - absenteeismLateMinutes number 晚到多少分钟记为旷工迟到\n - attendDays number 本班次记为多少天出勤（支持两位小数）\n - topRestTimeList []object 班次休息时间（仅 sections 只有一段上下班时可用，最多 3 段休息时间）：\n checkType string 休息类型：OnDuty（开始休息）/ OffDuty（结束休息）\n checkTime string 休息时间，格式 \"HH:mm\"（如 \"12:00\"、\"13:00\"）\n across number 是否跨天：0/1", "display": "考勤打卡 / 排班 / 统计", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws attendance class update --class-id 1170996821 --name \"新早班\" --timeout 10", "dws attendance class update --class-id 1170996821 --class-vo '{\"sections\":[{\"times\":[{\"checkType\":\"OnDuty\",\"checkTime\":\"08:30\",\"across\":0},{\"checkType\":\"OffDuty\",\"checkTime\":\"17:30\",\"across\":0}]}]}' --timeout 10" ], "group": "class", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "class_update", "parameter_count": 5, "parameters": { "class-id": { "description": "班次 ID（必填）", "property": "classId", "required": true, "type": "integer" }, "class-vo": { "description": "完整 TopAtClassVO JSON 字符串，包含 sections 等复杂子对象（可选）", "property": "classVo", "required": false, "type": "string" }, "name": { "description": "班次名称（可选，不传则保持原值）", "property": "name", "required": false, "type": "string" }, "owner": { "description": "班次负责人 userId（可选，不传则保持原值）", "property": "owner", "required": false, "type": "string" }, "yes": { "description": "跳过确认提示", "property": "yes", "required": false, "type": "boolean" } }, "path": "attendance.class_update", "primary_cli_path": "attendance class update", "product_id": "attendance", "reviewed": true, "risk": "medium", "source": "hardcoded:attendance", "title": "更新班次", "use_when": [ "需要修改已有班次的名称、上下班时间或规则" ] }, "attendance.get_attendance_summary": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.attendance.prod.json#attendance.get_attendance_summary", "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询个人考勤统计摘要", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查看单条考勤明细时使用 attendance record get", "查看原始打卡记录时使用 attendance check record", "查看排班时使用 attendance schedule get" ], "canonical_path": "attendance.get_attendance_summary", "cli_name": "summary", "cli_path": "attendance summary", "confirmation": "not_required", "description": "获取考勤统计摘要", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance summary --user USER_ID --date 2026-03-12 --stats-type week", "dws attendance summary --user USER_ID --date \"2026-03-12 15:00:00\" --stats-type month" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "attendance", "rpc_name": "get_attendance_summary" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_attendance_summary", "parameter_count": 4, "parameters": { "date": { "description": "查询日期，格式 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss（必填）", "property": "date", "required": true, "type": "string" }, "stats-type": { "description": "统计类型：week（周统计）/ month（月统计）（必填）", "property": "statsType", "required": true, "type": "string" }, "tag-name": { "description": "标签名称（可选）", "property": "tagName", "required": false, "type": "string" }, "user": { "description": "钉钉用户 ID（必填）", "property": "user", "required": true, "type": "string" } }, "path": "attendance.get_attendance_summary", "primary_cli_path": "attendance summary", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "get_attendance_summary", "use_when": [ "查看员工考勤统计、出勤/异常/请假等摘要" ] }, "attendance.get_user_attendance_record": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.attendance.prod.json#attendance.get_user_attendance_record", "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询个人考勤详情", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改打卡结果时使用 attendance boss-check", "查询打卡流水/原始打卡记录时使用 attendance check record 或 checkin records", "查询考勤统计汇总时使用 attendance summary" ], "canonical_path": "attendance.get_user_attendance_record", "cli_name": "get", "cli_path": "attendance record get", "confirmation": "not_required", "description": "查询指定用户在某一天的考勤详情，包括实际打卡记录（如上班/下班时间、是否正常打卡）、当日所排班次、所属考勤组信息、是否为休息日、出勤工时（如 \"0Hours\"）、加班时长等。返回数据受组织权限和隐私策略限制，仅当调用者有权限查看该用户考勤信息时才返回有效内容。适用于员工自助查询、HR 核对出勤或审批关联场景。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance record get --user 011769261608 --date 2026-03-08", "dws attendance record get --user USER_ID --date 2026-03-08 # 查询 userId: dws contact user search --keyword \"姓名\"" ], "group": "record", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "attendance", "rpc_name": "get_user_attendance_record" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_user_attendance_record", "parameter_count": 2, "parameters": { "date": { "description": "查询日期，格式 YYYY-MM-DD (必填)", "property": "date", "required": true, "type": "string" }, "user": { "description": "钉钉用户 ID (必填)", "property": "user", "required": true, "type": "string" } }, "path": "attendance.get_user_attendance_record", "primary_cli_path": "attendance record get", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询指定用户某一天的考勤详情", "use_when": [ "查询某个员工某天或时间段的考勤明细" ] }, "attendance.globalsetting_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询企业全局考勤设置", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改全局设置时使用 attendance globalsetting save", "查看个人设置时使用 attendance selfsetting get", "查看考勤组规则时使用 attendance group get/rules" ], "canonical_path": "attendance.globalsetting_get", "cli_name": "get", "cli_path": "attendance globalsetting get", "confirmation": "not_required", "description": "查询全局规则设置，仅管理员可以调用。\n\n入参字段:\n --setting-scene 查询设置项，枚举值包括 checkRemind、fastCheck、checkResultNotify、lackRemind、personalAttendStatNotify、bossAttendStatNotify\n --scope 必填，必须明确输入 企业、全公司 或 所有人，用于确认本次查询面向全局范围\n\n说明：corpId 和 opUserId 由当前登录上下文自动补齐，不需要通过 CLI 入参传入。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance globalsetting get --scope 企业 --setting-scene checkRemind --format json", "dws attendance globalsetting get --scope 全公司 --setting-scene bossAttendStatNotify --format json" ], "group": "globalsetting", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "globalsetting_get", "parameter_count": 2, "parameters": { "scope": { "description": "全局范围确认，必须明确输入：企业/全公司/所有人（必填）", "property": "scope", "required": true, "type": "string" }, "setting-scene": { "description": "查询设置项：checkRemind/fastCheck/checkResultNotify/lackRemind/personalAttendStatNotify/bossAttendStatNotify（必填）", "property": "settingScene", "required": true, "type": "string" } }, "path": "attendance.globalsetting_get", "primary_cli_path": "attendance globalsetting get", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询全局规则设置（仅管理员）", "use_when": [ "管理员查看企业级打卡提醒、极速打卡等全局设置" ] }, "attendance.globalsetting_save": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/attendance-example-normalization.json", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "更新企业全局考勤设置", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改个人设置时使用 attendance selfsetting save", "修改考勤组配置时使用 attendance group update", "只查看全局设置时使用 attendance globalsetting get" ], "canonical_path": "attendance.globalsetting_save", "cli_name": "save", "cli_path": "attendance globalsetting save", "confirmation": "user_required", "description": "更新保存全局规则设置，仅管理员可以调用。\n\n入参字段:\n --setting-scene 必填，枚举值包括 checkRemind、fastCheck、checkResultNotify、lackRemind、personalAttendStatNotify、bossAttendStatNotify\n --scope 必填，必须明确输入 企业、全公司 或 所有人，用于确认本次更新面向全局范围\n\n按 settingScene 传入对应设置字段，且至少传一个字段：\n checkRemind:\n --check-remind-corp\n --check-remind-pc-corp\n fastCheck:\n --fast-check-corp\n checkResultNotify:\n --enable-check-cert-push\n lackRemind:\n --lack-remind-corp\n personalAttendStatNotify:\n --enable-personal-daily-report\n --enable-personal-weekly-report\n --enable-personal-weekly-report-card\n --enable-personal-monthly-report\n bossAttendStatNotify:\n --boss-daily-report-type\n --boss-weekly-report-type\n --boss-monthly-report-type\n\n说明：corpId 和 opUserId 由当前登录上下文自动补齐，不需要通过 CLI 入参传入。\n返回 ServiceResult，result 为 boolean，表示保存是否成功。", "display": "考勤打卡 / 排班 / 统计", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws attendance globalsetting save --help" ], "group": "globalsetting", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "globalsetting_save", "parameter_count": 15, "parameters": { "boss-daily-report-type": { "description": "团队考勤统计通知日报发送渠道类型：0 全关闭，1 开启", "property": "bossDailyReportType", "required": false, "type": "integer" }, "boss-monthly-report-type": { "description": "团队考勤统计通知月报发送渠道类型：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮", "property": "bossMonthlyReportType", "required": false, "type": "integer" }, "boss-weekly-report-type": { "description": "团队考勤统计通知周报发送渠道类型：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮", "property": "bossWeeklyReportType", "required": false, "type": "integer" }, "check-remind-corp": { "description": "打卡提醒企业总开关", "property": "checkRemindCorp", "required": false, "type": "boolean" }, "check-remind-pc-corp": { "description": "打卡提醒 PC 端弹窗企业总开关", "property": "checkRemindPcCorp", "required": false, "type": "boolean" }, "enable-check-cert-push": { "description": "打卡结果通知企业总开关", "property": "enableCheckCertPush", "required": false, "type": "boolean" }, "enable-personal-daily-report": { "description": "个人考勤统计通知日报企业总开关", "property": "enablePersonalDailyReport", "required": false, "type": "boolean" }, "enable-personal-monthly-report": { "description": "个人考勤统计通知月报企业总开关", "property": "enablePersonalMonthlyReport", "required": false, "type": "boolean" }, "enable-personal-weekly-report": { "description": "个人考勤统计通知周报企业开关，钉邮渠道", "property": "enablePersonalWeeklyReport", "required": false, "type": "boolean" }, "enable-personal-weekly-report-card": { "description": "个人考勤统计通知周报企业开关，工作通知渠道", "property": "enablePersonalWeeklyReportCard", "required": false, "type": "boolean" }, "fast-check-corp": { "description": "极速打卡企业总开关", "property": "fastCheckCorp", "required": false, "type": "boolean" }, "lack-remind-corp": { "description": "缺卡提醒企业总开关", "property": "lackRemindCorp", "required": false, "type": "boolean" }, "scope": { "description": "全局范围确认，必须明确输入：企业/全公司/所有人（必填）", "property": "scope", "required": true, "type": "string" }, "setting-scene": { "description": "更新设置项：checkRemind/fastCheck/checkResultNotify/lackRemind/personalAttendStatNotify/bossAttendStatNotify（必填）", "property": "settingScene", "required": true, "type": "string" }, "yes": { "description": "跳过确认提示", "property": "yes", "required": false, "type": "boolean" } }, "path": "attendance.globalsetting_save", "primary_cli_path": "attendance globalsetting save", "product_id": "attendance", "reviewed": true, "risk": "high", "source": "hardcoded:attendance", "title": "更新保存全局规则设置（仅管理员）", "use_when": [ "管理员需要修改企业级打卡提醒、极速打卡等全局设置" ] }, "attendance.group_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "创建考勤组", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "仅修改成员时使用 attendance group update-members", "修改已有考勤组时使用 attendance group update", "查询已有考勤组时使用 attendance group search/get" ], "canonical_path": "attendance.group_create", "cli_name": "create", "cli_path": "attendance group create", "confirmation": "user_required", "description": "调用 MCP 工具 create_group_setting，创建一个新的考勤组。\n--name 和 --type 必填，其余参数可选（未传字段使用默认值）。由于创建考勤组耗时较久，指令需要带上 --timeout 10\n--yes 需要用户二次确认之后才允许带入，参考attendance.md中对于创建考勤组的说明\n\n常用 flag：\n --name 考勤组名称（必填）\n --type 考勤组类型：FIXED（固定班制）/ TURN（排班制）/ NONE（自由工时）（必填，显式校验）\n --owner 考勤组主负责人 userId（可选）\n --group-vo 完整 groupVO JSON 字符串（可选，用于传入复杂子对象，会与 --name/--type/--owner 合并）\n\n当使用 --group-vo 传入完整 JSON 时，--name、--type、--owner 仍可覆写 JSON 中的同名字段。\n\n【无条件必填字段】\n name string 考勤组名称\n type string 考勤组类型：FIXED / TURN / NONE\n\n【条件必填字段（type=FIXED 固定班制时）】\n workDayClassList []number 工作日班次列表，不能为空。\n 一共7个值，分别代表周日到周六每天的班次id，为0表示当天休息。\n 例如 [0,1279240003,0,0,0,0,0] 表示周一的班次id为1279240003，其余日子都是休息\n defaultClassId number 默认班次 ID，不能为 null\n\n条件必填字段通过 --group-vo JSON 传入，CLI 在 --type=FIXED 时会显式校验这些字段。\n\n--group-vo 可用字段说明（与更新考勤组一致，均可选，只需包含要设置的字段）：\n\n【基础信息】\n id number 考勤组id（创建时禁止传入，由服务端分配）\n name string 考勤组名称（必填）\n type string 考勤组类型：FIXED（固定班制）/ TURN（排班制）/ NONE（自由工时）（必填）\n owner string 考勤组主负责人 userId\n managerList []string 考勤组子负责人 userId 列表\n skipHolidays bool 节假日自动排休（只有固定班制和自由工时考勤组生效）\n defaultGroup bool 是否默认考勤组\n classIds []number 所选班次 id 列表(只有固定班制和排班制才有班次，自由工时没有)\n\n【打卡范围与定位】\n trimDistance number 定位允许微调距离（米）\n enablePositionOfGps bool 打卡是否允许开启 GPS 定位\n enablePositionOfWifi bool 是否开启 wifi 定位\n enablePositionOfBle bool 是否启用蓝牙定位\n\n positions []object 考勤打卡地址列表（地址定位打卡用），每项字段：\n - title string 地址标题\n - address string 地址详情（完整地址文本）\n - latitude number 纬度\n - longitude number 经度\n - offset number 该地址允许的打卡范围，单位米\n\n wifis []object 打卡方式中的 wifi 详情列表，每项字段：\n - ssid string wifi 的 ssid（wifi名称）\n - macAddr string wifi 的 macAddr（MAC 地址）\n - groupId number 考勤组id\n\n bleDeviceVOList []object 已选择的蓝牙设备列表，每项字段：\n - name string 设备名称\n - deviceUid number 设备 uid\n - sn string 设备 sn 序列号\n - productType string 对外的设备类型\n - devServId number 内部设备类型\n\n【外勤打卡设置】\n enableOutsideCheck bool 是否可以外勤打卡\n enableOutsideCameraCheck bool 是否开启外勤打卡必须拍照\n enableOutsideRemark bool 是否开启外勤打卡必须填写备注\n enableOutsideApply bool 是否开启外勤打卡必须审批\n forbidHideOutSideAddress bool 禁止隐藏外勤打卡地址的功能，false表示允许用户隐藏外勤打卡地址\n enableOutSideUpdateNormalCheck bool 下班时间：允许外勤卡更新内勤卡\n enableOnDutyNormalUpdateOutsideCheck bool 上班时间：允许内勤卡更新外勤卡\n outsideCheckApproveMode string 外勤打卡需审批执行模式：\n NO_NEED_APPROVE（无需审批）\n APPROVE_FIRST（先审批后打卡）\n CHECK_FIRST（先打卡后审批）\n APPROVE_EVERYTIME（每次打卡都需要审批）\n outSideCheckApplyType number 外勤审批范围：1（全天外勤打卡）/ 2（上班外勤打卡）/ 3（下班外勤打卡）\n\n【打卡方式】\n enableCameraCheck bool 是否开启拍照打卡\n openCameraCheck bool 是否开启拍照打卡（与 enableCameraCheck 含义相同）\n openFaceCheck bool 是否开启人脸打卡\n enableFaceStrictMode bool 是否开启人脸严格模式（强制活体检测）\n enableFaceBeauty bool 是否开启美颜\n onlyMachineCheck bool 只允许考勤机打卡\n permitMaxBeaconCount number 允许绑定的智点设备数量\n disableCheckWhenRest bool 休息日打卡需审批（只在固定班制和排班制生效，true表示打卡需要提交审批单）\n\n\n【固定班制设置（FIXED）】\n defaultClassId number 固定班制的默认班次 id（type=FIXED 时必填）\n workDayClassList []number 固定班制的工作日班次 id 列表，一共7个值，分别代表周日到周六每天的班次id，为0表示当天休息，例如[0,1279240003,0,0,0,0,0]表示周一的班次id为1279240003，其余日子都是休息\n\n【排班制设置（TURN）】\n disableCheckWithoutSchedule bool 未排班时员工可打卡（true=未排班时禁止打卡）\n enableEmpSelectClass bool 未排班时，员工可选班次打卡\n enableScheduleAutoMatch bool 未排班时，系统自动匹配班次\n ----以下是排班制设置排班周期的，非必要，不是所有排班制考勤组都需要设置，不设置就是按照classIds中的班次由管理员自行排班-----\n cycleDays number 排班循环天数，支持大小周（14天）\n startCycleDate number 用户设置的大小周开始时间（时间戳，毫秒）\n cycleScheduleList []object 循环排班设置列表，每项字段：\n - cycleName string 周期名字（如\"第一周\"）\n - groupId number 考勤组 id\n - isValid string 是否有效：Y（有效）/ N（无效）\n - itemList []object 排班设置列表，每项字段：\n - classId number 班次 id\n - className string 班次名称\n - isValid string 是否有效（Y/N）\n\n【自由工时设置（NONE）】\n workDays []number 自由工时的工作日，如 [1,2,3,4,5] 表示周一到周五（1=周一，7=周日）\n freeCheckDayStartMinOffset number 自由打卡每日开始时间，距离 0 点的分钟数（如 480 表示 08:00 开始）\n freeCheckCoreTime number 自由工时考勤组的打卡最短工作时长（分钟）\n freeCheckDemandWorkMinutes number 自由工时考勤组要求的打卡时长（分钟）\n\n freeCheckSettingVO object 自由工时打卡设置，包含字段：\n - freeCheckType string 自由工时打卡类型：\n CYCLE（上下班交替打卡）\n MAX_TIME_UPDATE（最大时间打卡，第一次为上班，后续均为下班卡）\n - freeWorkDayLackSwitch bool 自由工时打卡规则：工作日没打卡记为缺卡（true=记缺卡）\n - freeOnDutyLackMinOffset number 自由工时打卡规则：上班缺卡生成时间偏移分钟数\n - freeOffDutyLackMinOffset number 自由工时打卡规则：下班缺卡生成时间偏移分钟数\n - delimitOffsetMinutesBetweenDays number 自由工时前后两天的分割线（距 0 点分钟数，超过此时间则归属第二天）\n - freeCheckGapVO object 自由工时/休息日打卡间隔设置：\n - onOffCheckGapMinutes number 上班打卡后，多久才可以打下班卡（分钟）\n - offOnCheckGapMinutes number 下班打卡后，多久才可以打上班卡（分钟）\n\n freeGroupSpecialDayVO object 自由工时考勤组特殊日期设置，包含字段：\n - specialOnDutyDays []number 特殊需要打卡日期的时间戳列表（毫秒，原本休息日需额外打卡的日期）\n - specialOffDutyDays []number 特殊无需打卡日期的时间戳列表（毫秒，原本工作日可免打卡的日期）", "display": "考勤打卡 / 排班 / 统计", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws attendance group create --name \"研发考勤组\" --type FIXED --group-vo '{\"defaultClassId\":1170996821,\"workDayClassList\":[0,1170996821,0,0,0,0,0]}' --timeout 10", "dws attendance group create --name \"自由工时分组\" --type NONE --timeout 10" ], "group": "group", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "group_create", "parameter_count": 6, "parameters": { "corp-id": { "description": "企业 corpId（可选，不传时由登录上下文自动补齐）", "property": "corpId", "required": false, "type": "string" }, "group-vo": { "description": "完整 groupVO JSON 字符串（可选，用于传入复杂子对象，会与 --name/--type/--owner 合并）", "property": "groupVo", "required": false, "type": "string" }, "name": { "description": "考勤组名称（必填）", "property": "name", "required": true, "type": "string" }, "owner": { "description": "考勤组主负责人 userId（可选）", "property": "owner", "required": false, "type": "string" }, "type": { "description": "考勤组类型：FIXED（固定班制）/ TURN（排班制）/ NONE（自由工时）（必填）", "property": "type", "required": true, "type": "string" }, "yes": { "description": "跳过确认提示", "property": "yes", "required": false, "type": "boolean" } }, "path": "attendance.group_create", "primary_cli_path": "attendance group create", "product_id": "attendance", "reviewed": true, "risk": "high", "source": "hardcoded:attendance", "title": "创建考勤组", "use_when": [ "需要新建一个考勤组并配置规则" ] }, "attendance.group_filtered_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance-schedule.md", "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询考勤组指定字段子集", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "不知道考勤组ID时先用 attendance group search", "需要修改成员时使用 attendance group update-members", "需要完整考勤组配置时使用 attendance group get" ], "canonical_path": "attendance.group_filtered_get", "cli_name": "filtered-get", "cli_path": "attendance group filtered-get", "confirmation": "not_required", "description": "调用 MCP 工具 get_group_filtered_detail，根据考勤组 ID 仅返回关心的字段子集，\n强烈建议在仅需查询成员信息、打卡地址、蓝牙、Wifi 时使用，节省查询成本。\n--group-id 必填；四个过滤字段均可选（不传则默认 false，即不查询该字段）。\n --member 是否查询考勤组成员信息\n --position 是否查询打卡地址\n --wifi 是否查询打卡 Wifi\n --bles 是否查询打卡蓝牙", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance group filtered-get --group-id \u003cgroupId\u003e --member --format json" ], "group": "group", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "group_filtered_get", "parameter_count": 5, "parameters": { "bles": { "description": "是否查询打卡蓝牙（可选）", "property": "bles", "required": false, "type": "boolean" }, "group-id": { "description": "考勤组 ID（必填）", "property": "groupId", "required": true, "type": "integer" }, "member": { "description": "是否查询考勤组成员信息（可选）", "property": "member", "required": false, "type": "boolean" }, "position": { "description": "是否查询打卡地址（可选）", "property": "position", "required": false, "type": "boolean" }, "wifi": { "description": "是否查询打卡 Wifi（可选）", "property": "wifi", "required": false, "type": "boolean" } }, "path": "attendance.group_filtered_get", "primary_cli_path": "attendance group filtered-get", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "根据考勤组 ID 按需查询成员/打卡地址/蓝牙/Wifi 信息", "use_when": [ "只需要考勤组成员、打卡地址、蓝牙等部分字段，减少返回体积" ] }, "attendance.group_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance-schedule.md", "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询考勤组完整详情", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "不知道考勤组ID时先用 attendance group search", "修改考勤组配置时使用 attendance group update", "只需要成员/地址等子集时使用 attendance group filtered-get" ], "canonical_path": "attendance.group_get", "cli_name": "get", "cli_path": "attendance group get", "confirmation": "not_required", "description": "调用 MCP 工具 get_group_detail，根据考勤组 ID 查询该考勤组的全量信息。\n--group-id 必填。如果只需查询成员、打卡地址、蓝牙、Wifi 子集，请使用 group filtered-get 以节省查询成本。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance group get --group-id \u003cgroupId\u003e --format json" ], "group": "group", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "group_get", "parameter_count": 1, "parameters": { "group-id": { "description": "考勤组 ID（必填）", "property": "groupId", "required": true, "type": "integer" } }, "path": "attendance.group_get", "primary_cli_path": "attendance group get", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "根据考勤组 ID 查询考勤组全量信息", "use_when": [ "已取得考勤组ID，需要查看完整配置" ] }, "attendance.group_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance-schedule.md", "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询考勤组列表", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "创建/修改考勤组时使用 attendance group create/update", "只需要部分字段时使用 attendance group filtered-get", "已知道考勤组ID并要看详情时使用 attendance group get" ], "canonical_path": "attendance.group_search", "cli_name": "search", "cli_path": "attendance group search", "confirmation": "not_required", "description": "根据当前用户的权限和筛选条件获取考勤组简要信息。\n入参 ATGroupSearchParam 对象（至少填写一个子字段）和 PageQuery 对象（两个子字段必填）均不能为空。\n --query 考勤组名称关键字，模糊搜索\n --type 考勤组类型：FIXED（固定班制）/ TURN（排班制）/ NONE（自由工时）\n --query-position 是否查询地理定位和 Wifi 名称（默认 false）\n --query-ble 是否查询蓝牙设备列表（默认 false）\n --page 页码（从 1 开始，默认 1）\n --limit 每页条数（200 以内，默认 20）", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance group search --query \"\u003c考勤组名称\u003e\" --type TURN --format json", "dws attendance group search --query \"研发组\" --type TURN --format json" ], "group": "group", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "group_search", "parameter_count": 6, "parameters": { "limit": { "default": "20", "description": "每页条数，200 以内（必填）", "property": "limit", "required": true, "type": "integer" }, "page": { "default": "1", "description": "页码，从 1 开始（必填）", "property": "page", "required": true, "type": "integer" }, "query": { "description": "考勤组名称关键字，模糊搜索（可选）", "property": "query", "required": false, "type": "string" }, "query-ble": { "description": "是否查询蓝牙设备列表（可选）", "property": "queryBle", "required": false, "type": "boolean" }, "query-position": { "description": "是否查询地理定位和 Wifi 名称（可选）", "property": "queryPosition", "required": false, "type": "boolean" }, "type": { "description": "考勤组类型：FIXED 固定班制 / TURN 排班制 / NONE 自由工时（可选）", "property": "type", "required": false, "type": "string" } }, "path": "attendance.group_search", "primary_cli_path": "attendance group search", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询当前用户可管理的考勤组列表", "use_when": [ "按权限或条件查看考勤组简要信息" ] }, "attendance.group_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "更新考勤组配置", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "创建新考勤组时使用 attendance group create", "只调整成员时使用 attendance group update-members", "查询考勤组详情时使用 attendance group get" ], "canonical_path": "attendance.group_update", "cli_name": "update", "cli_path": "attendance group update", "confirmation": "user_required", "description": "调用 MCP 工具 update_group_setting，更新考勤组配置信息。\n--group-id 必填；其余参数均可选，仅需对要修改的字段进行赋値，未传的字段会自动从已有配置补充。由于保存考勤组耗时较久，指令需要带上--timeout 10\n--yes 需要用户二次确认之后才允许带入，参考attendance.md中对于更新考勤组配置的说明\n\n常用简单字段可直接用 flag 传入；复杂子对象（如打卡地址、wifi、蓝牙设备、循环排班等）请用 --group-vo JSON 字符串传入完整 groupVO 对象覆写。\n\n常用 flag：\n --name 考勤组名称\n --type 考勤组类型：FIXED（固定班制）/ TURN（排班制）/ NONE（自由工时）\n --owner 考勤组主负责人 userId\n --classIds []number 所选班次 id 列表\n --enable-outside-check 是否允许外勤打卡 (true/false)\n --group-vo 完整 groupVO JSON 字符串（用于修改复杂子对象，会与其他 flag 合并，重复字段以 flag 为准）\n\n--group-vo 可用字段说明（均可选，只需包含要修改的字段）：\n\n【基础信息】\n id number 考勤组id，不随更新变化\n name string 考勤组名称\n type string 考勤组类型：FIXED（固定班制）/ TURN（排班制）/ NONE（自由工时）\n owner string 考勤组主负责人 userId\n managerList []string 考勤组子负责人 userId 列表\n skipHolidays bool 节假日自动排休（只有固定班制和自由工时考勤组生效）\n defaultGroup bool 是否默认考勤组\n classIds []number 所选班次 id 列表(只有固定班制和排班制才有班次，自由工时没有)\n\n【打卡范围与定位】\n trimDistance number 定位允许微调距离（米）\n enablePositionOfGps bool 打卡是否允许开启 GPS 定位\n enablePositionOfWifi bool 是否开启 wifi 定位\n enablePositionOfBle bool 是否启用蓝牙定位\n\n positions []object 考勤打卡地址列表（地址定位打卡用），每项字段：\n - title string 地址标题\n - address string 地址详情（完整地址文本）\n - latitude number 纬度\n - longitude number 经度\n - offset number 该地址允许的打卡范围，单位米\n\n wifis []object 打卡方式中的 wifi 详情列表，每项字段：\n - ssid string wifi 的 ssid（wifi名称）\n - macAddr string wifi 的 macAddr（MAC 地址）\n - groupId number 考勤组id\n\n bleDeviceVOList []object 已选择的蓝牙设备列表，每项字段：\n - name string 设备名称\n - deviceUid number 设备 uid\n - sn string 设备 sn 序列号\n - productType string 对外的设备类型\n - devServId number 内部设备类型\n\n【外勤打卡设置】\n enableOutsideCheck bool 是否可以外勤打卡\n enableOutsideCameraCheck bool 是否开启外勤打卡必须拍照\n enableOutsideRemark bool 是否开启外勤打卡必须填写备注\n enableOutsideApply bool 是否开启外勤打卡必须审批\n forbidHideOutSideAddress bool 禁止隐藏外勤打卡地址的功能，false表示允许用户隐藏外勤打卡地址\n enableOutSideUpdateNormalCheck bool 下班时间：允许外勤卡更新内勤卡\n enableOnDutyNormalUpdateOutsideCheck bool 上班时间：允许内勤卡更新外勤卡\n outsideCheckApproveMode string 外勤打卡需审批执行模式：\n NO_NEED_APPROVE（无需审批）\n APPROVE_FIRST（先审批后打卡）\n CHECK_FIRST（先打卡后审批）\n APPROVE_EVERYTIME（每次打卡都需要审批）\n outSideCheckApplyType number 外勤审批范围：1（全天外勤打卡）/ 2（上班外勤打卡）/ 3（下班外勤打卡）\n\n【打卡方式】\n enableCameraCheck bool 是否开启拍照打卡\n openCameraCheck bool 是否开启拍照打卡（与 enableCameraCheck 含义相同）\n openFaceCheck bool 是否开启人脸打卡\n enableFaceStrictMode bool 是否开启人脸严格模式（强制活体检测）\n enableFaceBeauty bool 是否开启美颜\n onlyMachineCheck bool 只允许考勤机打卡\n permitMaxBeaconCount number 允许绑定的智点设备数量\n disableCheckWhenRest bool 休息日打卡需审批（只在固定班制和排班制生效，true表示打卡需要提交审批单）\n\n\n【固定班制设置（FIXED）】\n defaultClassId number 固定班制的默认班次 id\n workDayClassList []number 固定班制的工作日班次 id 列表，一共7个值，分别代表周日到周六每天的班次id，为0表示当天休息，例如[0,1279240003,0,0,0,0,0]表示周一的班次id为1279240003，其余日子都是休息\n\n【排班制设置（TURN）】\n disableCheckWithoutSchedule bool 未排班时员工可打卡（true=未排班时禁止打卡）\n enableEmpSelectClass bool 未排班时，员工可选班次打卡\n enableScheduleAutoMatch bool 未排班时，系统自动匹配班次\n ----以下是排班制设置排班周期的，非必要，不是所有排班制考勤组都需要设置，不设置就是按照classIds中的班次由管理员自行排班-----\n cycleDays number 排班循环天数，支持大小周（14天）\n startCycleDate number 用户设置的大小周开始时间（时间戳，毫秒）\n cycleScheduleList []object 循环排班设置列表，每项字段：\n - cycleName string 周期名字（如\"第一周\"）\n - groupId number 考勤组 id\n - isValid string 是否有效：Y（有效）/ N（无效）\n - itemList []object 排班设置列表，每项字段：\n - classId number 班次 id\n - className string 班次名称\n - isValid string 是否有效（Y/N）\n\n【自由工时设置（NONE）】\n workDays []number 自由工时的工作日，如 [1,2,3,4,5] 表示周一到周五（1=周一，7=周日）\n freeCheckDayStartMinOffset number 自由打卡每日开始时间，距离 0 点的分钟数（如 480 表示 08:00 开始）\n freeCheckCoreTime number 自由工时考勤组的打卡最短工作时长（分钟）\n freeCheckDemandWorkMinutes number 自由工时考勤组要求的打卡时长（分钟）\n\n freeCheckSettingVO object 自由工时打卡设置，包含字段：\n - freeCheckType string 自由工时打卡类型：\n CYCLE（上下班交替打卡）\n MAX_TIME_UPDATE（最大时间打卡，第一次为上班，后续均为下班卡）\n - freeWorkDayLackSwitch bool 自由工时打卡规则：工作日没打卡记为缺卡（true=记缺卡）\n - freeOnDutyLackMinOffset number 自由工时打卡规则：上班缺卡生成时间偏移分钟数\n - freeOffDutyLackMinOffset number 自由工时打卡规则：下班缺卡生成时间偏移分钟数\n - delimitOffsetMinutesBetweenDays number 自由工时前后两天的分割线（距 0 点分钟数，超过此时间则归属第二天）\n - freeCheckGapVO object 自由工时/休息日打卡间隔设置：\n - onOffCheckGapMinutes number 上班打卡后，多久才可以打下班卡（分钟）\n - offOnCheckGapMinutes number 下班打卡后，多久才可以打上班卡（分钟）\n\n freeGroupSpecialDayVO object 自由工时考勤组特殊日期设置，包含字段：\n - specialOnDutyDays []number 特殊需要打卡日期的时间戳列表（毫秒，原本休息日需额外打卡的日期）\n - specialOffDutyDays []number 特殊无需打卡日期的时间戳列表（毫秒，原本工作日可免打卡的日期）", "display": "考勤打卡 / 排班 / 统计", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws attendance group update --group-id 123456 --name \"研发考勤组\" --timeout 10", "dws attendance group update --group-id 123456 --owner userId1 --timeout 10" ], "group": "group", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "group_update", "parameter_count": 8, "parameters": { "classIds": { "description": "所选班次 id 列表，JSON 数组格式，如 '[123,456]'（可选）", "property": "classIds", "required": false, "type": "string" }, "enable-outside-check": { "description": "是否允许外勤打卡，传 true 或 false（可选）", "property": "enableOutsideCheck", "required": false, "type": "string" }, "group-id": { "description": "考勤组 ID（必填）", "property": "groupId", "required": true, "type": "integer" }, "group-vo": { "description": "完整 groupVO JSON 字符串，用于修改复杂子对象（可选）", "property": "groupVo", "required": false, "type": "string" }, "name": { "description": "考勤组名称（可选）", "property": "name", "required": false, "type": "string" }, "owner": { "description": "考勤组主负责人 userId（可选）", "property": "owner", "required": false, "type": "string" }, "type": { "description": "考勤组类型：FIXED 固定班制 / TURN 排班制 / NONE 自由工时（可选）", "property": "type", "required": false, "type": "string" }, "yes": { "description": "跳过确认提示", "property": "yes", "required": false, "type": "boolean" } }, "path": "attendance.group_update", "primary_cli_path": "attendance group update", "product_id": "attendance", "reviewed": true, "risk": "high", "source": "hardcoded:attendance", "title": "更新考勤组配置（仅修改需要变更的字段）", "use_when": [ "需要修改已有考勤组的规则、班次、位置或范围" ] }, "attendance.group_update_members": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "增删考勤组成员", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改考勤组规则配置时使用 attendance group update", "创建新考勤组时使用 attendance group create", "只查询成员信息时使用 attendance group filtered-get 或 group get" ], "canonical_path": "attendance.group_update_members", "cli_name": "update-members", "cli_path": "attendance group update-members", "confirmation": "user_required", "description": "调用 MCP 工具 update_group_member，对指定考勤组的成员进行增删操作。\n--group-id 必填；所有成员/部门参数均可选，但至少需要传一个变更项。由于保存考勤组耗时较久，指令需要带上--timeout 10\n每次调用各参数最多传 20 个 ID。\n--yes 需要用户二次确认之后才允许带入，参考attendance.md中对于更新考勤组成员的说明\n --add-users 添加考勤人员 userId 列表，逗号分隔\n --remove-users 删除考勤人员 userId 列表，逗号分隔\n --add-extra-users 添加无需考勤的人员 userId 列表，逗号分隔\n --remove-extra-users 删除无需考勤的成员 userId 列表，逗号分隔\n --add-depts 添加考勤部门 ID 列表，逗号分隔，若要添加全公司，根部门id为-1\n --remove-depts 删除考勤部门 ID 列表，逗号分隔，全公司根部门id为-1", "display": "考勤打卡 / 排班 / 统计", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws attendance group update-members --group-id 123456 --add-users userId1,userId2", "dws attendance group update-members --group-id 123456 --remove-users userId1" ], "group": "group", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "group_update_members", "parameter_count": 8, "parameters": { "add-depts": { "description": "添加考勤部门 ID 列表，逗号分隔，最多 20 个（可选）", "property": "addDepts", "required": false, "type": "string" }, "add-extra-users": { "description": "添加无需考勤的人员 userId 列表，逗号分隔，最多 20 个（可选）", "property": "addExtraUsers", "required": false, "type": "string" }, "add-users": { "description": "添加考勤人员 userId 列表，逗号分隔，最多 20 个（可选）", "property": "addUsers", "required": false, "type": "string" }, "group-id": { "description": "考勤组 ID（必填）", "property": "groupId", "required": true, "type": "integer" }, "remove-depts": { "description": "删除考勤部门 ID 列表，逗号分隔，最多 20 个（可选）", "property": "removeDepts", "required": false, "type": "string" }, "remove-extra-users": { "description": "删除无需考勤的成员 userId 列表，逗号分隔，最多 20 个（可选）", "property": "removeExtraUsers", "required": false, "type": "string" }, "remove-users": { "description": "删除考勤人员 userId 列表，逗号分隔，最多 20 个（可选）", "property": "removeUsers", "required": false, "type": "string" }, "yes": { "description": "跳过确认提示", "property": "yes", "required": false, "type": "boolean" } }, "path": "attendance.group_update_members", "primary_cli_path": "attendance group update-members", "product_id": "attendance", "reviewed": true, "risk": "high", "source": "hardcoded:attendance", "title": "更新考勤组成员（添加/删除考勤人员、部门、无需考勤人员）", "use_when": [ "需要向考勤组添加或移除成员" ] }, "attendance.overtime_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询单个加班规则详情", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "不知道加班规则ID时先用 attendance overtime search", "查询员工班次时使用 attendance shift list", "查询补卡规则详情时使用 attendance adjustment get" ], "canonical_path": "attendance.overtime_get", "cli_name": "get", "cli_path": "attendance overtime get", "confirmation": "not_required", "description": "调用 MCP 工具 get_overtime_rule_detail，根据加班规则主键 ID 查询对应的加班规则详情。\n--overtime-id 必填。已被删除或更新覆盖的加班规则也可以查到。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance overtime get --overtime-id 12345", "dws attendance overtime get --overtime-id 12345 --format json" ], "group": "overtime", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "overtime_get", "parameter_count": 1, "parameters": { "overtime-id": { "description": "加班规则主键 ID（必填）", "property": "overtimeId", "required": true, "type": "integer" } }, "path": "attendance.overtime_get", "primary_cli_path": "attendance overtime get", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "根据加班规则主键 ID 查询加班规则详情", "use_when": [ "已取得加班规则ID，需要查看规则详情" ] }, "attendance.overtime_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询加班规则列表", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "已知道加班规则ID并要看详情时使用 attendance overtime get", "查询加班审批单记录时使用 attendance approve list", "查询补卡规则时使用 attendance adjustment search" ], "canonical_path": "attendance.overtime_search", "cli_name": "search", "cli_path": "attendance overtime search", "confirmation": "not_required", "description": "根据用户权限查询加班规则列表，入参封装在 ATRuleQueryParam 对象中。\n --query 加班规则名称关键字，模糊搜索（可选）\n --page 页码（从 1 开始，默认 1）（必填）\n --limit 每页条数（200 以内，默认 20）（必填）", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance overtime search --page 1 --limit 20", "dws attendance overtime search --query \"节假日\" --page 1 --limit 50" ], "group": "overtime", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "overtime_search", "parameter_count": 3, "parameters": { "limit": { "default": "20", "description": "每页条数，200 以内（必填）", "property": "limit", "required": true, "type": "integer" }, "page": { "default": "1", "description": "页码，从 1 开始（必填）", "property": "page", "required": true, "type": "integer" }, "query": { "description": "加班规则名称关键字，模糊搜索（可选）", "property": "query", "required": false, "type": "string" } }, "path": "attendance.overtime_search", "primary_cli_path": "attendance overtime search", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询当前用户可管理的加班规则列表", "use_when": [ "需要查看可用加班规则或筛选加班规则" ] }, "attendance.query_attendance_group_or_rules": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.attendance.prod.json#attendance.query_attendance_group_or_rules", "skills/mono/references/products/attendance-schedule.md", "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询考勤组与考勤规则", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "需要全局或个人设置时使用 globalsetting/selfsetting get", "需要考勤组完整详情时使用 attendance group get", "需要补卡/加班规则时使用 attendance adjustment/overtime search" ], "canonical_path": "attendance.query_attendance_group_or_rules", "cli_name": "rules", "cli_path": "attendance rules", "confirmation": "not_required", "description": "查询考勤组/考勤规则：\"我属于哪个考勤组\"\"我们的打卡范围是什么\"\"弹性工时是怎么算的\"", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance rules --date \u003c今天日期\u003e --format json", "dws attendance rules --date 2026-03-14" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "attendance", "rpc_name": "query_attendance_group_or_rules" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_attendance_group_or_rules", "parameter_count": 1, "parameters": { "date": { "description": "考勤日期，格式 YYYY-MM-DD 或 yyyy-MM-dd HH:mm:ss (必填)", "interface_description": "考勤日期 格式：yyyy-MM-dd HH:mm:ss", "property": "date", "required": true, "type": "string" } }, "path": "attendance.query_attendance_group_or_rules", "primary_cli_path": "attendance rules", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "query_attendance_group_or_rules", "use_when": [ "需要查看当前可见的考勤组和规则概览" ] }, "attendance.report_columns": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询可查看的考勤报表字段", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查询个人考勤明细时使用 attendance record get", "查询假期数据时使用 attendance report query-leave", "查询报表数据时使用 attendance report query-data" ], "canonical_path": "attendance.report_columns", "cli_name": "columns", "cli_path": "attendance report columns", "confirmation": "not_required", "description": "根据操作者的列权限，过滤并返回其有权查看的考勤字段列表。\n操作者必须是管理员，否则返回权限错误。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance report columns" ], "group": "report", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "report_columns", "parameter_count": 0, "parameters": {}, "path": "attendance.report_columns", "primary_cli_path": "attendance report columns", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "获取企业考勤字段列表", "use_when": [ "查看操作者有权限查询的考勤报表字段" ] }, "attendance.report_query_data": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询考勤报表数据", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查询个人单日明细时使用 attendance record get", "查询假期数据时使用 attendance report query-leave", "查询可用字段时先用 attendance report columns" ], "canonical_path": "attendance.report_query_data", "cli_name": "query-data", "cli_path": "attendance report query-data", "confirmation": "not_required", "description": "根据字段查询考勤数据，含列权限过滤和用户查看权限校验。\n--columns 为字段 ID 列表（逗号分隔），可通过 dws attendance report columns 获取。\n--users 最多 20 人，传入userId，--start 到 --end 不超过 32 天。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance report query-data --users userId1,userId2 --columns 1001,1002 --start \"2026-03-01 00:00:00\" --end \"2026-03-31 23:59:59\"", "dws attendance report query-data --users userId1,userId2 --columns 1001,1002 --start \"2026-03-01 00:00:00\" --end \"2026-03-31 23:59:59\" --format json" ], "group": "report", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "report_query_data", "parameter_count": 4, "parameters": { "columns": { "description": "字段 ID 列表，逗号分隔，可通过 report columns 获取（必填）", "property": "columns", "required": true, "type": "string" }, "end": { "description": "结束日期，格式 yyyy-MM-dd HH:mm:ss（必填）", "property": "end", "required": true, "type": "string" }, "start": { "description": "开始日期，格式 yyyy-MM-dd HH:mm:ss（必填）", "property": "start", "required": true, "type": "string" }, "users": { "description": "目标用户 userID 列表，逗号分隔，最多 20 人（必填）", "property": "users", "required": true, "type": "string" } }, "path": "attendance.report_query_data", "primary_cli_path": "attendance report query-data", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "根据字段查询考勤数据", "use_when": [ "按字段查询考勤报表数据并进行权限过滤" ] }, "attendance.report_query_leave": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询假期报表数据", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "查询假期余额变更记录时使用 attendance vacation records", "查询假期余额时使用 attendance vacation balance", "查询通用考勤报表时使用 attendance report query-data" ], "canonical_path": "attendance.report_query_leave", "cli_name": "query-leave", "cli_path": "attendance report query-leave", "confirmation": "not_required", "description": "查询用户假期数据，含用户查看权限校验。\n--leave-names 为假期类型名称列表（逗号分隔），不传则查询所有假期类型。\n--users 最多 20 人，传入userId，--start 到 --end 不超过 32 天。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance report query-leave --users userId1,userId2 --leave-names 年假,病假 --start \"2026-03-01 00:00:00\" --end \"2026-03-31 23:59:59\"", "dws attendance report query-leave --users userId1,userId2 --leave-names 年假,病假 --start \"2026-03-01 00:00:00\" --end \"2026-03-31 23:59:59\" --format json" ], "group": "report", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "report_query_leave", "parameter_count": 4, "parameters": { "end": { "description": "结束日期，格式 yyyy-MM-dd HH:mm:ss（必填）", "property": "end", "required": true, "type": "string" }, "leave-names": { "description": "假期类型名称列表，逗号分隔，不填则查询所有假期类型（选填）", "property": "leaveNames", "required": false, "type": "string" }, "start": { "description": "开始日期，格式 yyyy-MM-dd HH:mm:ss（必填）", "property": "start", "required": true, "type": "string" }, "users": { "description": "目标用户 userID 列表，逗号分隔，最多 20 人（必填）", "property": "users", "required": true, "type": "string" } }, "path": "attendance.report_query_leave", "primary_cli_path": "attendance report query-leave", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询用户假期数据", "use_when": [ "查询用户假期/请假相关报表数据" ] }, "attendance.schedule_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询员工排班记录", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "导入或修改排班时使用 attendance schedule import", "批量查询员工班次结果时使用 attendance shift list", "查询班次定义时使用 attendance class get/search" ], "canonical_path": "attendance.schedule_get", "cli_name": "get", "cli_path": "attendance schedule get", "confirmation": "not_required", "description": "获取指定用户在一段时间内的排班记录。\n返回每条记录包含 userId、classId、workDate、className、checkBeginTime、checkEndTime 等字段。\n\n日期格式支持：\n - YYYY-MM-DD（如 2026-04-01）\n - YYYY-MM-DD HH:mm:ss（如 2026-04-01 09:00:00）\n\n示例：\n dws attendance schedule get --users user001,user002 --start 2026-04-01 --end 2026-04-30", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance schedule get --userIdList 03642229451220076 --workDateBegin 2026-05-13 --workDateEnd 2026-05-13 -f json" ], "group": "schedule", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "schedule_get", "parameter_count": 3, "parameters": { "end": { "description": "结束日期，格式 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss（必填）", "property": "end", "required": true, "type": "string" }, "start": { "description": "开始日期，格式 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss（必填）", "property": "start", "required": true, "type": "string" }, "users": { "description": "用户ID列表，逗号分隔（必填）", "property": "users", "required": true, "type": "string" } }, "path": "attendance.schedule_get", "primary_cli_path": "attendance schedule get", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "获取指定用户的排班记录", "use_when": [ "查询指定员工在日期范围内的排班记录" ] }, "attendance.schedule_import": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/attendance-example-normalization.json", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "导入排班制考勤组排班记录", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "不确定 groupId/classId/workDate 时先查询考勤组和班次", "仅查看排班时使用 attendance schedule get 或 attendance shift list", "查询班次定义时使用 attendance class search/get" ], "canonical_path": "attendance.schedule_import", "cli_name": "import", "cli_path": "attendance schedule import", "confirmation": "user_required", "description": "为排班制考勤组导入排班记录。传入 JSON 数组格式排班数据，\n每条记录必填字段：\n - userId: 用户ID（必填）\n - workDate: 排班日期，格式 yyyy-MM-dd HH:mm:ss（必填）\n - classId: 班次ID（必填）\n - isRest: 是否为排休，取值 Y/N（必填）\n\n示例：\n dws attendance schedule import --groupId 123456 \\\n --scheduleVOS '[{\"userId\":\"user001\",\"workDate\":\"2026-04-22 09:00:00\",\"classId\":123,\"isRest\":\"N\"}]' \\\n --user-say-yes", "display": "考勤打卡 / 排班 / 统计", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws attendance schedule import --help" ], "group": "schedule", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "schedule_import", "parameter_count": 3, "parameters": { "groupId": { "description": "考勤组ID（必填）", "property": "groupId", "required": true, "type": "string" }, "scheduleVOS": { "description": "排班记录 JSON 数组（必填）", "property": "scheduleVOS", "required": true, "type": "string" }, "user-say-yes": { "description": "用户已确认，跳过交互式确认提示（Agent 调用时传 true 前必须完成用户二次确认）", "property": "userSayYes", "required": false, "type": "boolean" } }, "path": "attendance.schedule_import", "primary_cli_path": "attendance schedule import", "product_id": "attendance", "reviewed": true, "risk": "high", "source": "hardcoded:attendance", "title": "导入排班记录到排班制考勤组", "use_when": [ "需要批量导入或覆盖排班记录" ] }, "attendance.selfsetting_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询个人考勤设置", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改个人设置时使用 attendance selfsetting save", "查询个人考勤记录时使用 attendance record get", "查询企业全局设置时使用 attendance globalsetting get" ], "canonical_path": "attendance.selfsetting_get", "cli_name": "get", "cli_path": "attendance selfsetting get", "confirmation": "not_required", "description": "查询个人规则设置，包括打卡提醒、极速打卡、打卡结果通知、缺卡提醒、个人考勤统计通知、团队考勤统计通知等设置项。\n\n入参字段:\n --setting-scene 查询设置项，枚举值包括：\n checkRemind（打卡提醒）\n fastCheck（极速打卡）\n checkResultNotify（打卡结果通知）\n lackRemind（缺卡提醒）\n personalAttendStatNotify（个人考勤统计通知）\n bossAttendStatNotify（团队考勤统计通知）\n --user 必填，查询用户 ID，对应 MCP 参数 userId\n\n说明：corpId 和 opUserId 由当前登录上下文自动补齐，不需要通过 CLI 入参传入。\n\n出参字段说明:\n 顶层返回 ServiceResult:\n success 请求是否成功\n code 请求结果码\n message 请求结果说明\n result 个人规则设置结果；服务端可能根据 --setting-scene 仅返回对应设置项相关字段\n\n result 通用字段:\n corpId 企业 ID\n userId 用户 ID\n\n settingScene=checkRemind（打卡提醒）相关字段:\n checkRemindSetting DING 提醒渠道设置\n checkRemindSetting.onDutyRemind 上班打卡提醒设置，包含 openRemind、remindMinutes(负数标识几分钟前提醒，正数几分钟后提醒)\n checkRemindSetting.offDutyRemind 下班打卡提醒设置，包含 openRemind、remindMinutes(负数标识几分钟前提醒，正数几分钟后提醒)\n checkRemindUserOnDuty 工作通知渠道：用户个人上班打卡提醒开关\n checkRemindUserOffDuty 工作通知渠道：用户个人下班打卡提醒开关\n enableOndutyCheckRemindOfPc PC 端弹窗渠道：上班打卡提醒开关\n enableOffdutyCheckRemindOfPc PC 端弹窗渠道：下班打卡提醒开关\n\n settingScene=fastCheck（极速打卡）相关字段:\n ondutyCheckType 上班打卡方式：1 提醒打卡，2 不提醒且不自动打卡，3 自动打卡\n ondutyRemindStartMin 上班打卡提醒开始时间，单位：分钟\n ondutyRemindEndMin 上班打卡提醒结束时间，单位：分钟\n fastCheckLateNeedConfirm 迟到时是否需要二次确认\n offdutyCheckType 下班打卡方式：1 提醒打卡，2 不提醒且不自动打卡，3 自动打卡\n offdutyRemindStartMin 下班打卡提醒开始时间，单位：分钟\n offdutyRemindEndMin 下班打卡提醒结束时间，单位：分钟\n canUpdateOffDuty 是否允许用户更新下班打卡设置\n voiceRemindSwitch 极速打卡提示音开关\n vibrationRemindSwitch 极速打卡震动提醒开关\n\n settingScene=checkResultNotify（打卡结果通知）相关字段:\n checkResultMsg 打卡结果通知开关：0 关闭，1 开启\n\n settingScene=lackRemind（缺卡提醒）相关字段:\n lackSendTodoMsg 待办提醒开关：0 关闭，null 或 1 开启\n lackRemindUser 工作通知渠道：用户个人缺卡提醒开关：0 关闭，null 或 1 开启\n\n settingScene=personalAttendStatNotify（个人考勤统计通知）相关字段:\n personDailyReportSwitch 日报推送开关：0 关闭，1 开启\n personWeekReportType 周报通知渠道：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮\n personMonthReportType 月报通知渠道：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮\n\n settingScene=bossAttendStatNotify（团队考勤统计通知）相关字段:\n bossPushStartMin 日报推送开始时间，单位：分钟；-1 表示关闭日报推送\n bossWeekReportType 周报通知渠道：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮\n bossMonthReportType 月报通知渠道：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance selfsetting get --setting-scene checkRemind --user \u003cUSER_ID\u003e --format json", "dws attendance selfsetting get --setting-scene fastCheck --user \u003cUSER_ID\u003e --format json" ], "group": "selfsetting", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "selfsetting_get", "parameter_count": 2, "parameters": { "setting-scene": { "description": "查询设置项：checkRemind/fastCheck/checkResultNotify/lackRemind/personalAttendStatNotify/bossAttendStatNotify（必填）", "property": "settingScene", "required": true, "type": "string" }, "user": { "description": "查询用户 ID（必填）", "property": "user", "required": true, "type": "string" } }, "path": "attendance.selfsetting_get", "primary_cli_path": "attendance selfsetting get", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询个人规则设置", "use_when": [ "查看某个员工的个人打卡提醒、极速打卡、结果通知等设置" ] }, "attendance.selfsetting_save": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/attendance-example-normalization.json", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "更新个人考勤设置", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改企业全局设置时使用 attendance globalsetting save", "只查看个人设置时使用 attendance selfsetting get", "查询考勤记录时使用 attendance record get" ], "canonical_path": "attendance.selfsetting_save", "cli_name": "save", "cli_path": "attendance selfsetting save", "confirmation": "user_required", "description": "更新保存个人规则设置，包括打卡提醒、极速打卡、打卡结果通知、缺卡提醒、个人考勤统计通知、团队考勤统计通知等设置项。\n\n入参字段:\n --setting-scene 必填，枚举值包括 checkRemind、fastCheck、checkResultNotify、lackRemind、personalAttendStatNotify、bossAttendStatNotify\n --user 必填，更新用户 ID，对应 MCP 参数 userId\n\n按 settingScene 传入对应设置字段，且至少传一个字段：\n checkRemind:\n --check-remind-setting\n --check-remind-user-on-duty\n --check-remind-user-off-duty\n --enable-onduty-check-remind-of-pc\n --enable-offduty-check-remind-of-pc\n fastCheck:\n --onduty-check-type\n --offduty-check-type\n --onduty-remind-start-min\n --onduty-remind-end-min\n --offduty-remind-start-min\n --offduty-remind-end-min\n --fast-check-late-need-confirm\n --can-update-off-duty\n --voice-remind-switch\n --vibration-remind-switch\n checkResultNotify:\n --check-result-msg\n lackRemind:\n --lack-send-todo-msg\n --lack-remind-user\n personalAttendStatNotify:\n --person-daily-report-switch\n --person-week-report-type\n --person-month-report-type\n bossAttendStatNotify:\n --boss-push-start-min\n --boss-week-report-type\n --boss-month-report-type\n\n说明：corpId 和 opUserId 由当前登录上下文自动补齐，不需要通过 CLI 入参传入。\n返回 ServiceResult，包含 success、code、message、result；result 为 boolean，表示保存是否成功。", "display": "考勤打卡 / 排班 / 统计", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws attendance selfsetting save --help" ], "group": "selfsetting", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "selfsetting_save", "parameter_count": 27, "parameters": { "boss-month-report-type": { "description": "团队考勤统计月报通知渠道：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮", "property": "bossMonthReportType", "required": false, "type": "integer" }, "boss-push-start-min": { "description": "团队考勤统计日报推送开始时间，单位：分钟；-1 表示关闭日报推送", "property": "bossPushStartMin", "required": false, "type": "integer" }, "boss-week-report-type": { "description": "团队考勤统计周报通知渠道：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮", "property": "bossWeekReportType", "required": false, "type": "integer" }, "can-update-off-duty": { "description": "下班极速打卡：是否允许用户更新下班打卡设置", "property": "canUpdateOffDuty", "required": false, "type": "boolean" }, "check-remind-setting": { "description": "打卡提醒 DING 渠道设置 JSON，如 {\"onDutyRemind\":{\"openRemind\":true,\"remindMinutes\":10}}", "property": "checkRemindSetting", "required": false, "type": "string" }, "check-remind-user-off-duty": { "description": "打卡提醒工作通知渠道：用户个人下班打卡提醒开关", "property": "checkRemindUserOffDuty", "required": false, "type": "boolean" }, "check-remind-user-on-duty": { "description": "打卡提醒工作通知渠道：用户个人上班打卡提醒开关", "property": "checkRemindUserOnDuty", "required": false, "type": "boolean" }, "check-result-msg": { "description": "打卡结果通知开关：0 关闭，1 开启", "property": "checkResultMsg", "required": false, "type": "integer" }, "enable-offduty-check-remind-of-pc": { "description": "PC 端弹窗渠道：下班打卡提醒开关", "property": "enableOffdutyCheckRemindOfPc", "required": false, "type": "boolean" }, "enable-onduty-check-remind-of-pc": { "description": "PC 端弹窗渠道：上班打卡提醒开关", "property": "enableOndutyCheckRemindOfPc", "required": false, "type": "boolean" }, "fast-check-late-need-confirm": { "description": "上班极速打卡：迟到时是否需要二次确认", "property": "fastCheckLateNeedConfirm", "required": false, "type": "boolean" }, "lack-remind-user": { "description": "缺卡提醒工作通知渠道：0 关闭，null 或 1 开启", "property": "lackRemindUser", "required": false, "type": "integer" }, "lack-send-todo-msg": { "description": "缺卡提醒待办渠道：0 关闭，null 或 1 开启", "property": "lackSendTodoMsg", "required": false, "type": "integer" }, "offduty-check-type": { "description": "下班极速打卡方式：1 提醒打卡，2 不提醒且不自动打卡，3 自动打卡", "property": "offdutyCheckType", "required": false, "type": "integer" }, "offduty-remind-end-min": { "description": "下班打卡提醒结束时间，单位：分钟", "property": "offdutyRemindEndMin", "required": false, "type": "integer" }, "offduty-remind-start-min": { "description": "下班打卡提醒开始时间，单位：分钟", "property": "offdutyRemindStartMin", "required": false, "type": "integer" }, "onduty-check-type": { "description": "上班极速打卡方式：1 提醒打卡，2 不提醒且不自动打卡，3 自动打卡", "property": "ondutyCheckType", "required": false, "type": "integer" }, "onduty-remind-end-min": { "description": "上班打卡提醒结束时间，单位：分钟", "property": "ondutyRemindEndMin", "required": false, "type": "integer" }, "onduty-remind-start-min": { "description": "上班打卡提醒开始时间，单位：分钟", "property": "ondutyRemindStartMin", "required": false, "type": "integer" }, "person-daily-report-switch": { "description": "个人考勤统计日报推送开关：0 关闭，1 开启", "property": "personDailyReportSwitch", "required": false, "type": "integer" }, "person-month-report-type": { "description": "个人考勤统计月报通知渠道：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮", "property": "personMonthReportType", "required": false, "type": "integer" }, "person-week-report-type": { "description": "个人考勤统计周报通知渠道：0 全关闭，1 工作通知，2 钉邮，3 工作通知和钉邮", "property": "personWeekReportType", "required": false, "type": "integer" }, "setting-scene": { "description": "更新设置项：checkRemind/fastCheck/checkResultNotify/lackRemind/personalAttendStatNotify/bossAttendStatNotify（必填）", "property": "settingScene", "required": true, "type": "string" }, "user": { "description": "更新用户 ID（必填）", "property": "user", "required": true, "type": "string" }, "vibration-remind-switch": { "description": "极速打卡震动提醒开关", "property": "vibrationRemindSwitch", "required": false, "type": "boolean" }, "voice-remind-switch": { "description": "极速打卡提示音开关", "property": "voiceRemindSwitch", "required": false, "type": "boolean" }, "yes": { "description": "跳过确认提示", "property": "yes", "required": false, "type": "boolean" } }, "path": "attendance.selfsetting_save", "primary_cli_path": "attendance selfsetting save", "product_id": "attendance", "reviewed": true, "risk": "high", "source": "hardcoded:attendance", "title": "更新保存个人规则设置", "use_when": [ "需要修改员工个人打卡提醒、极速打卡或结果通知设置" ] }, "attendance.vacation_balance": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询员工假期余额", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改余额时使用 attendance vacation save-balance", "查询假期余额变更明细时使用 attendance vacation records", "查询假期类型时使用 attendance vacation types" ], "canonical_path": "attendance.vacation_balance", "cli_name": "balance", "cli_path": "attendance vacation balance", "confirmation": "not_required", "description": "调用 MCP 工具 get_leave_balance_quota 查询指定员工的假期余额。\n例如：查询某员工年假还剩多少、病假额度等。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance vacation balance --users userId1,userId2 --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890", "dws attendance vacation balance --users userId1,userId2 --leave-code \u003c假期类型code\u003e --format json" ], "group": "vacation", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "vacation_balance", "parameter_count": 2, "parameters": { "leave-code": { "description": "假期规则 code (必填，服务端要求非空，不传返回 INVALID_PARAMS)", "property": "leaveCode", "required": true, "type": "string" }, "users": { "description": "目标员工 ID 列表，逗号分隔 (必填)", "property": "users", "required": true, "type": "string" } }, "path": "attendance.vacation_balance", "primary_cli_path": "attendance vacation balance", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询指定员工假期余额", "use_when": [ "查询指定员工的年假、调休等假期余额" ] }, "attendance.vacation_records": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询假期余额变更记录", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改余额时使用 attendance vacation save-balance", "只看当前余额时使用 attendance vacation balance", "查询假期类型时使用 attendance vacation types" ], "canonical_path": "attendance.vacation_records", "cli_name": "records", "cli_path": "attendance vacation records", "confirmation": "not_required", "description": "调用 MCP 工具 get_leave_balance_records 查询指定员工的假期余额变更记录。\n例如：查询某员工年假变更历史、请假扣减记录等。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance vacation records --user USER_ID --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890 --start 2026-04-01 --end 2026-04-22", "dws attendance vacation records --user USER_ID --leave-code \u003c假期类型code\u003e --start 2026-04-01 --end 2026-04-22 --format json" ], "group": "vacation", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "vacation_records", "parameter_count": 4, "parameters": { "end": { "description": "查询结束日期，格式 YYYY-MM-DD (必填)", "property": "end", "required": true, "type": "string" }, "leave-code": { "description": "假期规则 code (必填，服务端要求非空，不传返回 INVALID_PARAMS)", "property": "leaveCode", "required": true, "type": "string" }, "start": { "description": "查询开始日期，格式 YYYY-MM-DD (必填)", "property": "start", "required": true, "type": "string" }, "user": { "description": "指定查询员工 ID (必填)", "property": "user", "required": true, "type": "string" } }, "path": "attendance.vacation_records", "primary_cli_path": "attendance vacation records", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询指定员工假期余额变更记录", "use_when": [ "查询员工假期余额的增减流水或变更历史" ] }, "attendance.vacation_save_balance": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "调整员工假期余额", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改假期类型/规则时使用 attendance vacation update-type", "只查询余额时使用 attendance vacation balance", "查询变更流水时使用 attendance vacation records" ], "canonical_path": "attendance.vacation_save_balance", "cli_name": "save-balance", "cli_path": "attendance vacation save-balance", "confirmation": "user_required", "description": "调用 MCP 工具 update_leave_balance 设置指定员工的假期余额数量。\n\n重要说明：这是设置（SET）接口，传入的值会替换当前余额，而不是增加（ADD）。\n\n参数说明：\n --target 目标员工工号（必填）\n --leave-code 假期编码（必填）\n --num 余额数量（必填，如8天传8，7.5天传7.5）\n --reason 变更原因（必填，最长100字符）\n --start 有效期开始日期 YYYY-MM-DD\n --end 有效期结束日期 YYYY-MM-DD\n --user-say-yes 用户已确认，跳过交互式确认提示（Agent 调用时传 true 前必须完成用户二次确认）\n\n注意：\n - 余额数量在传递给 MCP 时会自动乘以100（如8天传800，7.5天传750）\n - 此接口为 SET 操作：传入值会直接设置为新的余额，而非累加到现有余额", "display": "考勤打卡 / 排班 / 统计", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws attendance vacation save-balance --target user001 --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890 --num 8 --reason \"年度发放\"", "dws attendance vacation save-balance --target user001 --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890 --num 8 --reason \"年度发放\" --start 2024-01-01 --end 2024-12-31" ], "group": "vacation", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "vacation_save_balance", "parameter_count": 7, "parameters": { "end": { "description": "有效期结束日期 YYYY-MM-DD", "property": "end", "required": false, "type": "string" }, "leave-code": { "description": "假期编码（必填）", "property": "leaveCode", "required": true, "type": "string" }, "num": { "description": "余额数量（必填）", "property": "num", "required": true, "type": "string" }, "reason": { "description": "变更原因（必填）", "property": "reason", "required": true, "type": "string" }, "start": { "description": "有效期开始日期 YYYY-MM-DD", "property": "start", "required": false, "type": "string" }, "target": { "description": "目标员工工号（必填）", "property": "target", "required": true, "type": "string" }, "user-say-yes": { "description": "用户已确认，跳过交互式确认提示（Agent 调用时传 true 前必须完成用户二次确认）", "property": "userSayYes", "required": false, "type": "boolean" } }, "path": "attendance.vacation_save_balance", "primary_cli_path": "attendance vacation save-balance", "product_id": "attendance", "reviewed": true, "risk": "high", "source": "hardcoded:attendance", "title": "设置员工假期余额", "use_when": [ "管理员需要修改指定员工的假期余额数量" ] }, "attendance.vacation_types": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "查询可用假期类型", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "修改假期余额时使用 attendance vacation save-balance", "修改假期规则时使用 attendance vacation update-type", "查询员工假期余额时使用 attendance vacation balance" ], "canonical_path": "attendance.vacation_types", "cli_name": "types", "cli_path": "attendance vacation types", "confirmation": "not_required", "description": "调用 MCP 工具 get_leave_types 查询当前用户可用的假期规则列表。\n例如：年假、事假、病假等假期类型及对应规则。", "display": "考勤打卡 / 排班 / 统计", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws attendance vacation types" ], "group": "vacation", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "vacation_types", "parameter_count": 0, "parameters": {}, "path": "attendance.vacation_types", "primary_cli_path": "attendance vacation types", "product_id": "attendance", "reviewed": true, "risk": "low", "source": "hardcoded:attendance", "title": "查询当前用户假期规则列表", "use_when": [ "查看当前用户可用的假期规则/假期类型列表" ] }, "attendance.vacation_update_type": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/attendance.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-attendance-review.json" ], "agent_summary": "更新假期类型规则", "agent_summary_source": "attendance-agent-review-v1", "availability": "available", "avoid_when": [ "只查询假期类型时使用 attendance vacation types", "查询假期报表时使用 attendance report query-leave", "调整员工假期余额时使用 attendance vacation save-balance" ], "canonical_path": "attendance.vacation_update_type", "cli_name": "update-type", "cli_path": "attendance vacation update-type", "confirmation": "user_required", "description": "调用 MCP 工具 save_leave_type 更新已有假期规则。\n--leave-code 必填，指定要更新的假期规则编码。\n其他字段均为可选，仅需传入要修改的字段。\n\n参数说明：\n --leave-code 假期编码（必填）\n --name 假期名称（可选）\n --unit 假期单位：day/halfDay/hour（可选）\n --paid 是否带薪假期（可选）\n --per-hours 一天折算小时数（可选）\n --when-can-leave 新员工请假规则：entry/formal（可选）\n --visibility-rules 适用范围规则 JSON 数组（可选）\n --user-say-yes 用户已确认，跳过交互式确认提示（Agent 调用时传 true 前必须完成用户二次确认）\n\n--visibility-rules 适用范围语义（HSF 反序列化约定，必读）：\n - 不传：不修改原有可见范围。\n - 改为指定范围：传 [{\"type\":\"staff|dept|label|employee_type\",\"visible\":[\"id1\",\"id2\"]}, ...]，\n 每条规则 type 和 visible 都必须非空。\n - 改为全公司可见（哨兵约定）：必须显式传 [{\"type\":\"dept\",\"visible\":[\"-1\"]}]，\n 服务端识别后会落库为空可见范围（即全公司）。\n - 反例（CLI 会拦截报错，避免被服务端静默忽略）：\n * 空数组 []、[{}]、[{\"type\":\"dept\",\"visible\":[]}] 等被视为未传，不会生效为全公司可见；\n * 若要清空可见范围，必须显式传哨兵值 [\"-1\"]。", "display": "考勤打卡 / 排班 / 统计", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws attendance vacation update-type --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890 --name \"事假（修改版）\"", "dws attendance vacation update-type --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890 --unit hour --per-hours 8" ], "group": "vacation", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "vacation_update_type", "parameter_count": 8, "parameters": { "leave-code": { "description": "假期编码（必填）", "property": "leaveCode", "required": true, "type": "string" }, "name": { "description": "假期名称（可选）", "property": "name", "required": false, "type": "string" }, "paid": { "description": "是否带薪假期（可选）", "property": "paid", "required": false, "type": "boolean" }, "per-hours": { "description": "一天折算小时数（可选）", "property": "perHours", "required": false, "type": "integer" }, "unit": { "description": "假期单位：day/halfDay/hour（可选）", "property": "unit", "required": false, "type": "string" }, "user-say-yes": { "description": "用户已确认，跳过交互式确认提示（Agent 调用时传 true 前必须完成用户二次确认）", "property": "userSayYes", "required": false, "type": "boolean" }, "visibility-rules": { "description": "适用范围规则 JSON 数组（可选）。不传=不改；[{\"type\":\"dept\",\"visible\":[\"-1\"]}]=全公司可见（哨兵）；其余=改为指定范围。空数组/无效规则会报错", "property": "visibilityRules", "required": false, "type": "string" }, "when-can-leave": { "description": "新员工请假规则：entry/formal（可选）", "property": "whenCanLeave", "required": false, "type": "string" } }, "path": "attendance.vacation_update_type", "primary_cli_path": "attendance vacation update-type", "product_id": "attendance", "reviewed": true, "risk": "high", "source": "hardcoded:attendance", "title": "更新假期规则", "use_when": [ "管理员需要修改已有假期规则或假期类型配置" ] }, "calendar.add_attachments": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.calendar.add_attachments", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "为日程添加附件。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“为日程添加附件。”所述变更时不要使用" ], "canonical_path": "calendar.add_attachments", "cli_name": "add", "cli_path": "calendar attachment add", "confirmation": "not_required", "description": "为日程添加附件。请先使用钉盘功能上传附件，得到文件id", "display": "日历日程 / 会议室 / 闲忙", "effect": "write", "effect_source": "command-verb", "examples": [ "dws calendar attachment add --event \u003cEVENT_ID\u003e --files \u003cFILE_ID\u003e:report.pdf,\u003cFILE_ID2\u003e:slides.pptx", "dws calendar attachment add --event \u003cEVENT_ID\u003e --files \u003cFILE_ID\u003e:report.pdf,\u003cFILE_ID2\u003e:slides.pptx --format json" ], "group": "attachment", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "add_attachments" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_attachments", "parameter_count": 3, "parameters": { "calendar-id": { "description": "日历 ID (可选，默认 primary 主日历；指定其他日历本时填写，可通过 book list 获取)。注意：订阅日历下的日程不支持添加附件", "interface_description": "日历本id，可选，默认值为 \"primary\"，表示 主日历本", "property": "calendarId", "required": false, "type": "string" }, "event": { "description": "日程 ID (必填)", "interface_description": "日程id", "property": "eventId", "required": true, "type": "string" }, "files": { "description": "附件列表，格式 \u003cfileId\u003e:\u003cname\u003e，多项逗号分隔 (必填)", "example": "file-smoke:report.pdf", "format": "file-id-name-list", "interface_description": "attachments", "interface_type": "array", "property": "attachments", "required": true, "type": "string" } }, "path": "calendar.add_attachments", "primary_cli_path": "calendar attachment add", "product_id": "calendar", "reviewed": false, "risk": "medium", "source": "runtime:calendar", "title": "添加日程附件", "use_when": [ "把附件挂到指定日程", "日程附件/给会议加文件/上传日程材料；添加" ] }, "calendar.add_calendar_participant": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.calendar.prod.json#calendar.add_calendar_participant", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "添加参与者", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“查看参与者”请改用 dws calendar attendee list", "要“移除参与者”请改用 dws calendar attendee delete" ], "canonical_path": "calendar.add_calendar_participant", "cli_name": "add", "cli_path": "calendar attendee add", "confirmation": "not_required", "description": "向已存在的指定日程添加参与者，支持批量添加多人，可设置参与者类型和通知方式", "display": "日历日程 / 会议室 / 闲忙", "effect": "write", "effect_source": "command-verb", "examples": [ "dws calendar attendee add --event \u003cEVENT_ID\u003e --attendees \u003cUSER_ID_1\u003e,\u003cUSER_ID_2\u003e", "dws calendar attendee add --event \u003cEVENT_ID\u003e --attendees \u003cUSER_ID\u003e --optional" ], "group": "attendee", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "add_calendar_participant" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_calendar_participant", "parameter_count": 4, "parameters": { "attendees": { "description": "参会人 userId 列表，逗号分隔 (必填，最多500人)", "interface_description": "需要添加的参与人uid列表。", "interface_type": "array", "property": "attendeesToAdd", "required": true, "type": "string" }, "calendar-id": { "description": "日历 ID (可选，默认 primary 主日历；指定其他日历本时填写，可通过 book list 获取)。注意：订阅日历下的日程无参会人", "interface_description": "日历本id，可选，默认值为 \"primary\"，表示主日历本。", "property": "calendarId", "required": false, "type": "string" }, "event": { "description": "日程 ID (必填)", "interface_description": "日程ID，可调用创建日程接口或查询日程列表接口获取id参数值", "property": "eventId", "required": true, "type": "string" }, "optional": { "description": "参会人可选 (默认必选参会人)", "interface_description": "参会人可选。true - 可选参会人，false - 必选参会人。\n默认值：false", "property": "optional", "required": false, "type": "boolean" } }, "path": "calendar.add_calendar_participant", "primary_cli_path": "calendar attendee add", "product_id": "calendar", "risk": "medium", "source": "hardcoded:calendar", "title": "添加日程参与人", "use_when": [ "参会人/与会者；邀请/添加", "添加参会人（必须用 Step 1 返回的 eventId）" ] }, "calendar.add_meeting_room": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.calendar.prod.json#calendar.add_meeting_room", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "预定会议室", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“会议室分组列表”请改用 dws calendar room list-groups", "要“查询 [startTime, endTime] 时间段内所有可用”请改用 dws calendar room search", "要“移除会议室”请改用 dws calendar room delete" ], "canonical_path": "calendar.add_meeting_room", "cli_name": "add", "cli_path": "calendar room add", "confirmation": "not_required", "description": "为日程(event)添加 会议室，完成会议室的预定", "display": "日历日程 / 会议室 / 闲忙", "effect": "write", "effect_source": "command-verb", "examples": [ "dws calendar room add --event \u003cEVENT_ID\u003e --rooms \u003cROOM_ID\u003e", "dws calendar room add --event \u003cEVENT_ID\u003e --rooms \u003cROOM_ID\u003e --format json" ], "group": "room", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "add_meeting_room" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_meeting_room", "parameter_count": 3, "parameters": { "calendar-id": { "description": "日历 ID (可选，默认 primary 主日历；指定其他日历本时填写，可通过 book list 获取)，注意：订阅日历下的日程不支持添加会议室", "interface_description": "日历本id，可选，默认值为 \"primary\"，表示 主日历本", "property": "calendarId", "required": false, "type": "string" }, "event": { "description": "日程 ID (必填)", "interface_description": "日程ID，调用查询日程列表接口获取id参数值。", "property": "eventId", "required": true, "type": "string" }, "rooms": { "description": "会议室 ID 列表 (必填)", "interface_description": "需要预定的会议室roomId列表，可调用查询空闲会议室接口获取，一个日程最多添加5个会议室。", "interface_type": "array", "property": "roomIds", "required": true, "type": "string" } }, "path": "calendar.add_meeting_room", "primary_cli_path": "calendar room add", "product_id": "calendar", "risk": "medium", "source": "runtime:calendar", "title": "添加会议室", "use_when": [ "会议室/订会议室；给已有日程订会议室", "预定会议室" ] }, "calendar.create_calendar_event": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.calendar.create_calendar_event", "skills/mono/references/intent-guide.md", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除日程”请改用 dws calendar event delete", "要“查询当前用户指定日历本下的日程列表，按起止时间检索”请改用 dws calendar event list", "要“获取日程详情”请改用 dws calendar event get" ], "canonical_path": "calendar.create_calendar_event", "cli_name": "create", "cli_path": "calendar event create", "confirmation": "not_required", "constraints": { "require_together": [ [ "recurrence-type", "recurrence-interval", "recurrence-range-type" ] ] }, "description": "创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能。", "display": "日历日程 / 会议室 / 闲忙", "effect": "write", "effect_source": "command-verb", "examples": [ "dws calendar event create --title \"Q1 复盘会\" --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T15:00:00+08:00\"", "dws calendar event create --title \"周会\" --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T15:00:00+08:00\" --attendees userId1,userId2" ], "group": "event", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "create_calendar_event" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_calendar_event", "parameter_count": 22, "parameters": { "attendees": { "description": "参会人 userId 列表，逗号分隔 (最多500人)，日程组织人自动放入参会人列表，无需传入userId", "interface_description": "日程参与人userId列表，最多支持500个参与人。", "interface_type": "array", "property": "attendees", "required": false, "type": "string" }, "calendar-id": { "description": "日历 ID (可选，默认 primary 主日历；指定共享/订阅日历本时填写，可通过 book list 获取)", "interface_description": "日历本id，可选，默认值为 \"primary\"，表示在 主日历本下创建日程。", "property": "calendarId", "required": false, "type": "string" }, "desc": { "description": "日程描述 (最大5000字符)", "interface_description": "日程描述，纯文本类型，最大不超过5000个字符。", "property": "description", "required": false, "type": "string" }, "end": { "description": "结束时间 ISO-8601 (必填，例如 2026-03-10T15:00:00+08:00)", "format": "date-time", "interface_description": "日程结束时间，格式为ISO-8601的带时区的date-time格式，例如2025-11-14T10:00:00+08:00。", "property": "endDateTime", "required": true, "type": "string" }, "free-busy": { "description": "此日程的忙碌状态，默认值为busy。busy - 在忙闲视图中，此日程时间段为忙碌; free - 此日程不占用忙闲", "interface_description": "此日程的忙碌状态，默认值为busy。\nbusy - 在忙闲视图中，此日程时间段为忙碌。\nfree - 此日程不占用忙闲。", "property": "freeBusy", "required": false, "type": "string" }, "location": { "description": "地点信息（纯文本备注，如‘3号楼A区’；不等于预订会议室）", "interface_description": "地点信息。", "property": "location", "required": false, "type": "string" }, "open-dingtalk-ids": { "description": "openDingTalkId 列表，逗号分隔 (与 --attendees 至少传一个)", "interface_description": "openDingTalkId 和attendees至少传一个", "interface_type": "array", "property": "openDingTalkIds", "required": false, "type": "string" }, "recurrence-count": { "description": "[recurrence.range] 循环次数 (range-type=numbered 时必填)", "property": "recurrence.range.numberOfOccurrences", "required": false, "required_when": "recurrence-range-type is numbered", "type": "integer" }, "recurrence-day-of-month": { "description": "[recurrence.pattern] 每月第几天 (absoluteMonthly/absoluteYearly 时必填)", "property": "recurrence.pattern.dayOfMonth", "required": false, "required_when": "recurrence-type is absoluteMonthly or absoluteYearly", "type": "integer" }, "recurrence-days-of-week": { "description": "[recurrence.pattern] 周几: sunday,monday,...,saturday (weekly/relativeMonthly 时必填)", "property": "recurrence.pattern.daysOfWeek", "required": false, "required_when": "recurrence-type is weekly or relativeMonthly", "type": "string" }, "recurrence-end-date": { "description": "[recurrence.range] 循环结束时间 ISO-8601 (range-type=endDate 时必填)", "format": "date-time", "property": "recurrence.range.endDate", "required": false, "required_when": "recurrence-range-type is endDate", "type": "string" }, "recurrence-first-day-of-week": { "description": "[recurrence.pattern] 一周起始日，默认 sunday", "property": "recurrence.pattern.firstDayOfWeek", "required": false, "type": "string" }, "recurrence-index": { "description": "[recurrence.pattern] 每月第几周: first|second|third|fourth|last (relativeMonthly 时必填)", "property": "recurrence.pattern.index", "required": false, "required_when": "recurrence-type is relativeMonthly", "type": "string" }, "recurrence-interval": { "description": "[recurrence整体必填] 循环间隔 (\u003e0；如 daily 时表示每N天，weekly 时表示每N周，以此类推)", "property": "recurrence.pattern.interval", "required": false, "required_when": "any recurrence-* flag is provided", "type": "integer" }, "recurrence-range-type": { "description": "[recurrence整体必填] 循环范围: noEnd|endDate|numbered；与 --recurrence-type 必须成对出现", "property": "recurrence.range.type", "required": false, "required_when": "any recurrence-* flag is provided", "type": "string" }, "recurrence-type": { "description": "[recurrence整体必填] 循环类型: daily|weekly|absoluteMonthly|relativeMonthly|absoluteYearly；一旦使用 --recurrence-* 任一 flag，必须同时提供完整的 pattern+range 字段集合", "property": "recurrence.pattern.type", "required": false, "required_when": "any recurrence-* flag is provided", "type": "string" }, "remind-minutes": { "description": "日程开始前提醒，逗号分隔分钟数 (可选，例如 5,10,15 表示开始前5/10/15分钟提醒；不传则默认15分钟提醒)", "property": "remindMinutes", "required": false, "type": "string" }, "rich-text-desc": { "description": "html格式的富文本类型日程描述，用于复杂内容的展示", "interface_description": "html格式的富文本类型日程描述，用于复杂内容的展示。", "property": "richTextDescription", "required": false, "type": "string" }, "rooms": { "description": "会议室 roomId 列表，逗号分隔 (创建时直接预定，roomId 必须来自 `room search` 返回，若是循环会议，必须设置recurrence-end-date，避免长期预订)", "interface_description": "需要预定的会议室roomId列表，可调用查询空闲会议室接口获取，先确认会议室在时间段内为空闲状态", "interface_type": "array", "property": "roomIds", "required": false, "type": "string" }, "start": { "description": "开始时间 ISO-8601 (必填，例如 2026-03-10T14:00:00+08:00)", "format": "date-time", "interface_description": "日程开始时间，格式为ISO-8601的带时区的date-time格式，例如2025-11-14T10:00:00+08:00。", "property": "startDateTime", "required": true, "type": "string" }, "timezone": { "description": "时区 IANA 格式 (例如 Asia/Shanghai，默认 Asia/Shanghai)", "interface_description": "IANA Time Zone Database name. 指定日程时区，比如：Asia/Shanghai. 默认值为Asia/Shanghai", "property": "timeZone", "required": false, "type": "string" }, "title": { "description": "日程标题 (必填，最大2048字符)", "interface_description": "日程标题，最大不超过2048个字符。", "property": "summary", "required": true, "type": "string" } }, "path": "calendar.create_calendar_event", "primary_cli_path": "calendar event create", "product_id": "calendar", "reviewed": false, "risk": "medium", "source": "runtime:calendar", "title": "创建日程", "use_when": [ "会议室/订会议室；创建新日程并订会议室", "创建日程 — 提取 eventId", "创建日程时直接指定参会人 + 会议室", "日程/会议/约会/日历；创建/约/给自己留时间块/个人日程", "给自己留一个明天下午的时间块/建个个人日程；创建个人日程" ] }, "calendar.delete_calendar_event": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.calendar.prod.json#calendar.delete_calendar_event", "skills/mono/SKILL.md", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除日程", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能”请改用 dws calendar event create", "要“查询当前用户指定日历本下的日程列表，按起止时间检索”请改用 dws calendar event list", "要“获取日程详情”请改用 dws calendar event get" ], "canonical_path": "calendar.delete_calendar_event", "cli_name": "delete", "cli_path": "calendar event delete", "confirmation": "user_required", "description": "删除指定日程，组织者删除将通知所有参与者，参与者删除仅从自己日历移除", "display": "日历日程 / 会议室 / 闲忙", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws calendar event delete --id \u003cid\u003e" ], "group": "event", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "delete_calendar_event" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_calendar_event", "parameter_count": 2, "parameters": { "calendar-id": { "description": "日历 ID (可选，默认 primary 主日历；指定其他日历本时填写，可通过 book list 获取)", "interface_description": "日历本id，可选，默认值为 \"primary\"。", "property": "calendarId", "required": false, "type": "string" }, "id": { "description": "日程 ID (必填)", "interface_description": "日程ID，可调用创建日程接口或查询日程列表接口获取id参数值。", "property": "eventId", "required": true, "type": "string" } }, "path": "calendar.delete_calendar_event", "primary_cli_path": "calendar event delete", "product_id": "calendar", "risk": "high", "source": "runtime:calendar", "title": "删除指定日程", "use_when": [ "日程/会议/约会/日历；取消/删除" ] }, "calendar.delete_meeting_room": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.calendar.prod.json#calendar.delete_meeting_room", "skills/mono/SKILL.md", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "移除会议室", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“会议室分组列表”请改用 dws calendar room list-groups", "要“查询 [startTime, endTime] 时间段内所有可用”请改用 dws calendar room search", "要“预定会议室”请改用 dws calendar room add" ], "canonical_path": "calendar.delete_meeting_room", "cli_name": "delete", "cli_path": "calendar room delete", "confirmation": "user_required", "description": "移除日程中预约的会议室。\r\n1. 从日程中移除该会议室\r\n2. 释放该会议室预定记录", "display": "日历日程 / 会议室 / 闲忙", "effect": "write", "effect_source": "skill-explicit", "examples": [ "dws calendar room delete --event \u003cevent\u003e --rooms \u003crooms\u003e" ], "group": "room", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "delete_meeting_room" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_meeting_room", "parameter_count": 3, "parameters": { "calendar-id": { "description": "日历 ID (可选，默认 primary 主日历；指定其他日历本时填写，可通过 book list 获取)。注意：订阅日历下的日程无会议室", "interface_description": "日历本id，可选，默认值为 \"primary\"，表示 主日历本", "property": "calendarId", "required": false, "type": "string" }, "event": { "description": "日程 ID (必填)", "interface_description": "日程ID，调用查询日程列表接口获取id参数值。", "property": "eventId", "required": true, "type": "string" }, "rooms": { "description": "会议室 ID 列表 (必填)", "interface_description": "需要删除的会议室roomId列表", "interface_type": "array", "property": "roomIds", "required": true, "type": "string" } }, "path": "calendar.delete_meeting_room", "primary_cli_path": "calendar room delete", "product_id": "calendar", "risk": "high", "source": "runtime:calendar", "title": "移除日程中的会议室", "use_when": [ "会议室/订会议室；取消预定" ] }, "calendar.get_calendar": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.calendar.get_calendar", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "根据日历id查询指定日历的信息。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“搜索当前用户拥有的日历本，支持按日历本名模糊搜索”请改用 dws calendar book search", "要“查询用户的所有日历，其中id = \"primary\"为主日历（n”请改用 dws calendar book list" ], "canonical_path": "calendar.get_calendar", "cli_name": "get", "cli_path": "calendar book get", "confirmation": "not_required", "description": "根据日历id查询指定日历的信息。用户主日历本id固定为 \"primary\"", "display": "日历日程 / 会议室 / 闲忙", "effect": "read", "effect_source": "command-verb", "examples": [ "dws calendar book get --id primary", "dws calendar book get --id CALENDAR_ID" ], "group": "book", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "get_calendar" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_calendar", "parameter_count": 1, "parameters": { "id": { "description": "日历 ID (必填，主日历固定为 primary)", "interface_description": "日历id", "property": "calendarId", "required": true, "type": "string" } }, "path": "calendar.get_calendar", "primary_cli_path": "calendar book get", "product_id": "calendar", "reviewed": false, "risk": "low", "source": "runtime:calendar", "title": "查询指定日历信息", "use_when": [ "我有几个日历/查所有日历/别人共享给我的日历/他人共享给我的日历本；查指定日历本" ] }, "calendar.get_calendar_detail": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.calendar.prod.json#calendar.get_calendar_detail", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取日程详情", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能”请改用 dws calendar event create", "要“删除日程”请改用 dws calendar event delete", "要“查询当前用户指定日历本下的日程列表，按起止时间检索”请改用 dws calendar event list" ], "canonical_path": "calendar.get_calendar_detail", "cli_name": "get", "cli_path": "calendar event get", "confirmation": "not_required", "description": "根据eventId查询指定日程的明细。", "display": "日历日程 / 会议室 / 闲忙", "effect": "read", "effect_source": "command-verb", "examples": [ "dws calendar event get --id \u003cEVENT_ID\u003e", "dws calendar event get --id \u003cEVENT_ID\u003e --calendar-id primary" ], "group": "event", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "get_calendar_detail" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_calendar_detail", "parameter_count": 2, "parameters": { "calendar-id": { "description": "日历 ID (默认 primary 主日历)", "interface_description": "日历id。查询指定日历下的日程信息。默认值为primary (主日历)；大部分场景无需传此值，仅当用户要求查询其他日历本时。calendarId可通过\"查询用户日历列表\"获取。", "property": "calendarId", "required": false, "type": "string" }, "id": { "description": "日程 ID (必填)", "interface_description": "日程ID，可调用创建日程接口或查询日程列表接口获取id参数值", "property": "eventId", "required": true, "type": "string" } }, "path": "calendar.get_calendar_detail", "primary_cli_path": "calendar event get", "product_id": "calendar", "risk": "low", "source": "runtime:calendar", "title": "查询日程详情", "use_when": [ "日程/会议/约会/日历；详情" ] }, "calendar.get_calendar_participants": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.calendar.prod.json#calendar.get_calendar_participants", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查看参与者", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加参与者”请改用 dws calendar attendee add", "要“移除参与者”请改用 dws calendar attendee delete" ], "canonical_path": "calendar.get_calendar_participants", "cli_name": "list", "cli_path": "calendar attendee list", "confirmation": "not_required", "description": "获取指定日程的所有参与者列表及其状态信息", "display": "日历日程 / 会议室 / 闲忙", "effect": "read", "effect_source": "command-verb", "examples": [ "dws calendar attendee list --event \u003cEVENT_ID\u003e" ], "group": "attendee", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "get_calendar_participants" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_calendar_participants", "parameter_count": 2, "parameters": { "calendar-id": { "description": "日历 ID (可选，默认 primary 主日历；指定其他日历本时填写，可通过 book list 获取)。注意：订阅日历下的日程无参会人", "interface_description": "日历本id，可选，默认值为 \"primary\"，表示主日历本。", "property": "calendarId", "required": false, "type": "string" }, "event": { "description": "日程 ID (必填)", "interface_description": "日程ID，可调用创建日程接口或查询日程列表接口获取id参数值。", "property": "eventId", "required": true, "type": "string" } }, "path": "calendar.get_calendar_participants", "primary_cli_path": "calendar attendee list", "product_id": "calendar", "risk": "low", "source": "hardcoded:calendar", "title": "获取日程参与人", "use_when": [ "参会人/与会者；查看" ] }, "calendar.list_acls": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.calendar.list_acls", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "调用本接口，获取用户主日历的访问控制列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“调用本接口，获取用户主日历的访问控制列表。”" ], "canonical_path": "calendar.list_acls", "cli_name": "list", "cli_path": "calendar acl list", "confirmation": "not_required", "description": "调用本接口，获取用户主日历的访问控制列表。可查询用户的日历共享情况", "display": "日历日程 / 会议室 / 闲忙", "effect": "read", "effect_source": "command-verb", "examples": [ "dws calendar acl list" ], "group": "acl", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "list_acls" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_acls", "parameter_count": 0, "parameters": {}, "path": "calendar.list_acls", "primary_cli_path": "calendar acl list", "product_id": "calendar", "reviewed": false, "risk": "low", "source": "runtime:calendar", "title": "查询日历访问权限列表", "use_when": [ "我的日历共享给了谁/谁能看我日历/日历权限/取消共享/把日历分享给xxx；查看我共享出去的情况（即谁有权访问我的日历）" ] }, "calendar.list_calendar_events": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.calendar.list_calendar_events", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询当前用户指定日历本下的日程列表，按起止时间检索。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能”请改用 dws calendar event create", "要“删除日程”请改用 dws calendar event delete", "要“获取日程详情”请改用 dws calendar event get" ], "canonical_path": "calendar.list_calendar_events", "cli_name": "list", "cli_path": "calendar event list", "confirmation": "not_required", "description": "查询当前用户指定日历本下的日程列表，按起止时间检索。", "display": "日历日程 / 会议室 / 闲忙", "effect": "read", "effect_source": "command-verb", "examples": [ "dws calendar event list --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\"", "dws calendar event list --calendar-id primary" ], "group": "event", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "list_calendar_events" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_calendar_events", "parameter_count": 5, "parameters": { "calendar-id": { "description": "日历 ID (默认 primary 主日历，仅在查询其他日历本时填写)", "interface_description": "日历id。查询指定日历下的日程信息。默认值为primary (主日历)；大部分场景无需传此值，仅当用户要求查询其他日历本时。calendarId可通过\"查询用户日历列表\"获取。", "property": "calendarId", "required": false, "type": "string" }, "cursor": { "description": "分页游标 (首次查询无需传入，仅翻页时传入上一次返回的 nextCursor)", "interface_description": "分页游标，可选。首次查询无需传入此值。", "property": "cursor", "required": false, "type": "string" }, "end": { "description": "结束时间 ISO-8601 (例如 2026-03-10T18:00:00+08:00)", "format": "date-time", "interface_description": "日程结束时间，时间戳（毫秒级）", "interface_type": "number", "property": "endTime", "required": false, "type": "string" }, "limit": { "description": "每页返回条数 (默认 100，最大 100)", "interface_description": "一次调用最多返回的日程数量，可选。默认值为100。\n注意：最大值为100，表示每次最多查询100条。", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "start": { "description": "开始时间 ISO-8601 (例如 2026-03-10T14:00:00+08:00)", "format": "date-time", "interface_description": "日程开始时间，时间戳（毫秒级）", "interface_type": "number", "property": "startTime", "required": false, "type": "string" } }, "path": "calendar.list_calendar_events", "primary_cli_path": "calendar event list", "product_id": "calendar", "reviewed": false, "risk": "low", "source": "runtime:calendar", "title": "查询当前用户日程列表", "use_when": [ "日程/会议/约会/日历；查看" ] }, "calendar.list_calendars": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.calendar.list_calendars", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询用户的所有日历，其中id = \"primary\"为主日历（name = \"我的日历\"），为固定值。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“搜索当前用户拥有的日历本，支持按日历本名模糊搜索”请改用 dws calendar book search", "要“根据日历id查询指定日历的信息”请改用 dws calendar book get" ], "canonical_path": "calendar.list_calendars", "cli_name": "list", "cli_path": "calendar book list", "confirmation": "not_required", "description": "查询用户的所有日历，其中id = \"primary\"为主日历（name = \"我的日历\"），为固定值。", "display": "日历日程 / 会议室 / 闲忙", "effect": "read", "effect_source": "command-verb", "examples": [ "dws calendar book list" ], "group": "book", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "list_calendars" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_calendars", "parameter_count": 0, "parameters": {}, "path": "calendar.list_calendars", "primary_cli_path": "calendar book list", "product_id": "calendar", "reviewed": false, "risk": "low", "source": "runtime:calendar", "title": "查询用户日历列表", "use_when": [ "我有几个日历/查所有日历/别人共享给我的日历/他人共享给我的日历本；列表", "查下xxx的日程安排；查询是否有共享关系" ] }, "calendar.list_meeting_room_groups": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.calendar.prod.json#calendar.list_meeting_room_groups", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "会议室分组列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询 [startTime, endTime] 时间段内所有可用”请改用 dws calendar room search", "要“移除会议室”请改用 dws calendar room delete", "要“预定会议室”请改用 dws calendar room add" ], "canonical_path": "calendar.list_meeting_room_groups", "cli_name": "list-groups", "cli_path": "calendar room list-groups", "confirmation": "not_required", "description": "分页查询当前企业下的会议室分组列表，返回每个分组的名称（groupName）、唯一 ID（groupId）及其父分组 ID（parentId，0 表示根分组）。结果按组织架构权限过滤，仅包含调用者有权限查看的分组。", "display": "日历日程 / 会议室 / 闲忙", "effect": "read", "effect_source": "command-verb", "examples": [ "dws calendar room list-groups", "dws calendar room list-groups --limit 20 --page 0" ], "group": "room", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "list_meeting_room_groups" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_meeting_room_groups", "parameter_count": 2, "parameters": { "limit": { "description": "页大小 (可选，不填默认 100，超过 100 按 100 处理)", "property": "limit", "required": false, "type": "string" }, "page": { "description": "分页起始位置 (可选，不填默认 0)", "property": "page", "required": false, "type": "string" } }, "path": "calendar.list_meeting_room_groups", "primary_cli_path": "calendar room list-groups", "product_id": "calendar", "risk": "low", "source": "runtime:calendar", "title": "查询会议室分组列表", "use_when": [ "会议室/订会议室；分组" ] }, "calendar.list_suggested_event_times": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.calendar.prod.json#calendar.list_suggested_event_times", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "根据参会人推荐可用时间", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能”请改用 dws calendar event create", "要“删除日程”请改用 dws calendar event delete", "要“获取日程详情”请改用 dws calendar event get" ], "canonical_path": "calendar.list_suggested_event_times", "cli_name": "suggest", "cli_path": "calendar event suggest", "confirmation": "not_required", "description": "可根据参会人员的信息，推荐日程时间。用于日程时间未确定，解决会议时间协调问题。", "display": "日历日程 / 会议室 / 闲忙", "effect": "read", "effect_source": "command-verb", "examples": [ "dws calendar event suggest --users userId1,userId2 --duration 60", "dws calendar event suggest --start \"2026-03-10T09:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\" --users userId1" ], "group": "event", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "list_suggested_event_times" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_suggested_event_times", "parameter_count": 5, "parameters": { "duration": { "description": "日程持续时间 (分钟，默认30)", "interface_description": "日程持续时间，单位：分钟。默认为30分钟", "property": "durationMinutes", "required": false, "type": "string" }, "end": { "description": "推荐时间范围结束 ISO-8601 (默认次日18点)", "format": "date-time", "interface_description": "推荐时间范围：结束时间点\nISO8601 格式，如：2025-12-30T18:00:00+08:00\n默认为次日18点", "property": "end", "required": false, "type": "string" }, "start": { "description": "推荐时间范围开始 ISO-8601 (默认当前时间)", "format": "date-time", "interface_description": "推荐时间范围：开始时间点。\nISO8601 格式，如：2025-12-30T12:00:00+08:00。\n默认为当前时间。", "property": "start", "required": false, "type": "string" }, "timezone": { "description": "时区 IANA 格式 (默认 Asia/Shanghai)", "interface_description": "时区，IANA时区格式。默认为系统时区，即Asia/Shanghai。", "property": "timeZone", "required": false, "type": "string" }, "users": { "description": "参会人 userId 列表，逗号分隔", "interface_description": "attendeeUserIds", "interface_type": "array", "property": "attendeeUserIds", "required": false, "type": "string" } }, "path": "calendar.list_suggested_event_times", "primary_cli_path": "calendar event suggest", "product_id": "calendar", "risk": "low", "source": "runtime:calendar", "title": "建议日程时间", "use_when": [ "日程/会议/约会/日历；推荐时间/什么时候有空/协调时间" ] }, "calendar.query_available_meeting_room": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.calendar.query_available_meeting_room", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询 [startTime, endTime] 时间段内所有可用的会议室。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“会议室分组列表”请改用 dws calendar room list-groups", "要“移除会议室”请改用 dws calendar room delete", "要“预定会议室”请改用 dws calendar room add" ], "canonical_path": "calendar.query_available_meeting_room", "cli_name": "search", "cli_path": "calendar room search", "confirmation": "not_required", "description": "查询 [startTime, endTime] 时间段内所有可用的会议室。要求整个时间段内都空闲且当前用户可预定。适用于有明确时间段要求的查询。", "display": "日历日程 / 会议室 / 闲忙", "effect": "read", "effect_source": "command-verb", "examples": [ "dws calendar room search --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T15:00:00+08:00\"", "dws calendar room search --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T15:00:00+08:00\" --group-id \u003cGROUP_ID\u003e" ], "group": "room", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "query_available_meeting_room" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_available_meeting_room", "parameter_count": 6, "parameters": { "end": { "description": "结束时间 ISO-8601 (可选，不传则默认当前时间+1小时，例如 2026-03-10T15:00:00+08:00)", "format": "date-time", "interface_description": "结束时间，时间戳（毫秒级）", "property": "endTime", "required": false, "type": "string" }, "group-id": { "description": "会议室分组ID（可选，留空查根目录；会议室超100条时先用 list-groups 获取分组再按分组查询）", "interface_description": "会议室分组ID。可选字段。若不填写，则默认查询根目录下的空闲会议室。\n建议使用方式：首次查询时请留空此字段；若因当前企业会议室数量超过100条而返回错误，请先调用分页查询当前企业下的会议室分组列表，再根据具体的分组ID分别查询各分组下的会议室数据。", "property": "groupId", "required": false, "type": "string" }, "limit": { "description": "页大小 (可选，不填默认 100，超过 100 按 100 处理)", "property": "limit", "required": false, "type": "string" }, "page": { "description": "分页起始位置 (可选，不填默认 0)", "property": "page", "required": false, "type": "string" }, "room-name": { "description": "按会议室名称过滤（可选，服务端模糊匹配。调用方需先剔除用户口语后缀如「会议室/大会议室/小会议室」，仅传核心专名以提升命中率，例如用户说「永澄亭会议室」应传「永澄亭」）", "interface_description": "会议室名，按会议室名称过滤（可选，服务端模糊匹配。调用方需先剔除用户口语后缀如「会议室/大会议室/小会议室」，仅传核心专名以提升命中率，例如用户说「永澄亭会议室」应传「永澄亭」）", "property": "roomName", "required": false, "type": "string" }, "start": { "description": "开始时间 ISO-8601 (可选，不传则默认当前时间+1分钟，例如 2026-03-10T14:00:00+08:00)", "format": "date-time", "interface_description": "开始时间，时间戳（毫秒级）", "property": "startTime", "required": false, "type": "string" } }, "path": "calendar.query_available_meeting_room", "primary_cli_path": "calendar room search", "product_id": "calendar", "reviewed": false, "risk": "low", "source": "runtime:calendar", "title": "查询空闲会议室", "use_when": [ "会议室/订会议室；哪个空闲", "会议室/订会议室；按名找会议室（如「永澄亭」「永澄亭会议室」「约西湖厅」）", "搜索空闲会议室", "搜索空闲会议室，记下 roomId" ] }, "calendar.query_busy_status": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.calendar.prod.json#calendar.query_busy_status", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "查询用户闲忙状态", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询用户闲忙状态”" ], "canonical_path": "calendar.query_busy_status", "cli_name": "search", "cli_path": "calendar busy search", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "users", "rooms" ] ] }, "description": "可查询指定用户或者会议室在给定时间范围内的闲忙状态，返回已占用时间段的信息（注意只有时间信息）。结果受组织可见性策略控制：仅当调用者有权限查看该用户日历时方可获取有效数据。适用于安排会议前快速确认他人可用时间，或者查看指定会议室的预订状态。", "display": "日历日程 / 会议室 / 闲忙", "effect": "read", "effect_source": "command-verb", "examples": [ "dws calendar busy search --users \u003cUSER_ID_1\u003e,\u003cUSER_ID_2\u003e --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\"", "dws calendar busy search --rooms \u003cROOM_ID_1\u003e,\u003cROOM_ID_2\u003e --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\"" ], "group": "busy", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "query_busy_status" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_busy_status", "parameter_count": 4, "parameters": { "end": { "description": "结束时间 ISO-8601 (必填，例如 2026-03-10T18:00:00+08:00)", "format": "date-time", "interface_description": "查询的结束时间，时间戳（毫秒级）格式。", "interface_type": "number", "property": "endTime", "required": true, "type": "string" }, "rooms": { "description": "会议室 ID 列表，逗号分隔 (与 --users 至少指定其一，用于查询会议室闲忙)", "interface_description": "待查询的会议室id列表", "interface_type": "array", "property": "roomIds", "required": false, "type": "string" }, "start": { "description": "开始时间 ISO-8601 (必填，例如 2026-03-10T14:00:00+08:00)", "format": "date-time", "interface_description": "查询的开始时间，时间戳（毫秒级）格式。", "interface_type": "number", "property": "startTime", "required": true, "type": "string" }, "users": { "description": "用户 ID 列表，逗号分隔 (与 --rooms 至少指定其一)", "interface_description": "用户uid列表最大长度 20。", "interface_type": "array", "property": "userIds", "required": false, "type": "string" } }, "path": "calendar.query_busy_status", "primary_cli_path": "calendar busy search", "product_id": "calendar", "risk": "low", "source": "runtime:calendar", "title": "获取用户闲忙信息", "use_when": [ "同时查用户 + 会议室", "有空吗/忙不忙/闲忙；查询会议室闲忙", "有空吗/忙不忙/闲忙；查询用户闲忙", "有空吗/忙不忙/闲忙；用户 + 会议室一起查", "查会议室闲忙", "查用户闲忙" ] }, "calendar.remove_calendar_participant": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.calendar.prod.json#calendar.remove_calendar_participant", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "移除参与者", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“查看参与者”请改用 dws calendar attendee list", "要“添加参与者”请改用 dws calendar attendee add" ], "canonical_path": "calendar.remove_calendar_participant", "cli_name": "delete", "cli_path": "calendar attendee delete", "confirmation": "user_required", "description": "从已存在的指定日程中移除参与者，支持批量移除多人", "display": "日历日程 / 会议室 / 闲忙", "effect": "write", "effect_source": "command-verb", "examples": [ "dws calendar attendee delete --attendees \u003cattendees\u003e --event \u003cevent\u003e" ], "group": "attendee", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "remove_calendar_participant" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_calendar_participant", "parameter_count": 3, "parameters": { "attendees": { "description": "参会人 userId 列表，逗号分隔 (必填)", "interface_description": "需要被删除的日程参与者userId列表。", "interface_type": "array", "property": "attendeesToRemove", "required": true, "type": "string" }, "calendar-id": { "description": "日历 ID (可选，默认 primary 主日历；指定其他日历本时填写，可通过 book list 获取)。注意：订阅日历下的日程无参会人", "interface_description": "日历本id，可选，默认值为 \"primary\"，表示在 主日历本", "property": "calendarId", "required": false, "type": "string" }, "event": { "description": "日程 ID (必填)", "interface_description": "日程ID，可调用创建日程接口或查询日程列表接口获取id参数值。", "property": "eventId", "required": true, "type": "string" } }, "path": "calendar.remove_calendar_participant", "primary_cli_path": "calendar attendee delete", "product_id": "calendar", "risk": "high", "source": "hardcoded:calendar", "title": "删除日程参与人", "use_when": [ "参会人/与会者；移除" ] }, "calendar.respond": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.calendar.respond", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "作为日程参会人，设置自己的响应状态（接受、拒绝、暂定）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能”请改用 dws calendar event create", "要“删除日程”请改用 dws calendar event delete", "要“获取日程详情”请改用 dws calendar event get" ], "canonical_path": "calendar.respond", "cli_name": "respond", "cli_path": "calendar event respond", "confirmation": "not_required", "description": "作为日程参会人，设置自己的响应状态（接受、拒绝、暂定）。", "display": "日历日程 / 会议室 / 闲忙", "effect": "write", "effect_source": "command-verb", "examples": [ "dws calendar event respond --id \u003cEVENT_ID\u003e --status accepted", "dws calendar event respond --id \u003cEVENT_ID\u003e --status declined" ], "group": "event", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "respond" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "respond", "parameter_count": 3, "parameters": { "calendar-id": { "description": "日历 ID (可选，默认 primary 主日历；指定其他日历本时填写，可通过 book list 获取)，注意：订阅日历下的日程无参会人，因此不可响应", "interface_description": "日历本id，可选，默认值为 \"primary\"，表示 主日历本", "property": "calendarId", "required": false, "type": "string" }, "id": { "description": "日程 ID (必填)", "interface_description": "日程id", "property": "eventId", "required": true, "type": "string" }, "status": { "description": "响应状态: needsAction(未操作)|accepted(接受)|declined(拒绝)|tentative(暂定) (必填)", "enum": [ "needsAction", "accepted", "declined", "tentative" ], "interface_description": "设置响应状态，可取值和对应说明如下：\n1. needsAction：未操作（默认值）\n2. accepted：接受\n3. declined：拒绝\n4. tentative：暂定", "property": "responseStatus", "required": true, "type": "string" } }, "path": "calendar.respond", "primary_cli_path": "calendar event respond", "product_id": "calendar", "reviewed": false, "risk": "medium", "source": "runtime:calendar", "title": "响应日程", "use_when": [ "日程/会议/约会/日历；接受/拒绝/暂定日程" ] }, "calendar.search_calendar": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.calendar.search_calendar", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "搜索当前用户拥有的日历本，支持按日历本名模糊搜索。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询用户的所有日历，其中id = \"primary\"为主日历（n”请改用 dws calendar book list", "要“根据日历id查询指定日历的信息”请改用 dws calendar book get" ], "canonical_path": "calendar.search_calendar", "cli_name": "search", "cli_path": "calendar book search", "confirmation": "not_required", "description": "搜索当前用户拥有的日历本，支持按日历本名模糊搜索。获取全部日历请使用list_calendars", "display": "日历日程 / 会议室 / 闲忙", "effect": "read", "effect_source": "command-verb", "examples": [ "dws calendar book search --query \"项目\"", "dws calendar book search --query \"团队周报\"" ], "group": "book", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "search_calendar" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_calendar", "parameter_count": 1, "parameters": { "query": { "description": "按日历本名称模糊检索 (必填)", "interface_description": "按日历本名称模糊检索", "property": "calendarName", "required": true, "type": "string" } }, "path": "calendar.search_calendar", "primary_cli_path": "calendar book search", "product_id": "calendar", "reviewed": false, "risk": "low", "source": "runtime:calendar", "title": "搜索日历本列表", "use_when": [ "我有几个日历/查所有日历/别人共享给我的日历/他人共享给我的日历本；按名称搜索日历本" ] }, "calendar.update_calendar_event": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.calendar.update_calendar_event", "skills/mono/references/products/calendar.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "修改现有日程的信息，支持更新标题、时间、地点等任意字段，需要组织者权限。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能”请改用 dws calendar event create", "要“删除日程”请改用 dws calendar event delete", "要“获取日程详情”请改用 dws calendar event get" ], "canonical_path": "calendar.update_calendar_event", "cli_name": "update", "cli_path": "calendar event update", "confirmation": "not_required", "constraints": { "require_together": [ [ "recurrence-type", "recurrence-interval", "recurrence-range-type" ] ] }, "description": "修改现有日程的信息，支持更新标题、时间、地点等任意字段，需要组织者权限。（修改参与人需要使用给日程添加参与人或给日程删除参与人工具）", "display": "日历日程 / 会议室 / 闲忙", "effect": "write", "effect_source": "command-verb", "examples": [ "dws calendar event update --id \u003cEVENT_ID\u003e --title \"新标题\"", "dws calendar event update --id \u003cEVENT_ID\u003e --desc \"新描述\" --timezone Asia/Tokyo" ], "group": "event", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "calendar", "rpc_name": "update_calendar_event" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_calendar_event", "parameter_count": 19, "parameters": { "calendar-id": { "description": "日历 ID (可选，默认 primary 主日历；指定其他日历本时填写，可通过 book list 获取)", "interface_description": "日历本id，可选，默认值为 \"primary\"。", "property": "calendarId", "required": false, "type": "string" }, "desc": { "description": "新描述 (最大5000字符)", "interface_description": "日程描述，最大不超过5000个字符。", "property": "description", "required": false, "type": "string" }, "end": { "description": "新结束时间 ISO-8601", "format": "date-time", "interface_description": "日程结束时间，格式为ISO-8601的带时区的date-time格式，例如2025-11-14T10:00:00+08:00。", "property": "endDateTime", "required": false, "type": "string" }, "free-busy": { "description": "修改此日程的忙碌状态，无需修改则不传。busy - 在忙闲视图中，此日程时间段为忙碌; free - 此日程不占用忙闲", "interface_description": "修改此日程的忙碌状态。busy - 在忙闲视图中，此日程时间段为忙碌。free - 此日程时间段不占用忙闲。", "property": "freeBusy", "required": false, "type": "string" }, "id": { "description": "日程 ID (必填)", "interface_description": "日程ID，可调用创建日程接口或查询日程列表接口获取id参数值", "property": "eventId", "required": true, "type": "string" }, "location": { "description": "地点信息（纯文本备注，如‘3号楼A区’；不等于预订会议室）", "interface_description": "地点信息", "property": "location", "required": false, "type": "string" }, "recurrence-count": { "description": "[recurrence.range] 循环次数 (range-type=numbered 时必填)", "property": "recurrence.range.numberOfOccurrences", "required": false, "required_when": "recurrence-range-type is numbered", "type": "integer" }, "recurrence-day-of-month": { "description": "[recurrence.pattern] 每月第几天 (absoluteMonthly/absoluteYearly 时必填)", "property": "recurrence.pattern.dayOfMonth", "required": false, "required_when": "recurrence-type is absoluteMonthly or absoluteYearly", "type": "integer" }, "recurrence-days-of-week": { "description": "[recurrence.pattern] 周几: sunday,monday,...,saturday (weekly/relativeMonthly 时必填)", "property": "recurrence.pattern.daysOfWeek", "required": false, "required_when": "recurrence-type is weekly or relativeMonthly", "type": "string" }, "recurrence-end-date": { "description": "[recurrence.range] 循环结束时间 ISO-8601 (range-type=endDate 时必填)", "format": "date-time", "property": "recurrence.range.endDate", "required": false, "required_when": "recurrence-range-type is endDate", "type": "string" }, "recurrence-first-day-of-week": { "description": "[recurrence.pattern] 一周起始日，默认 sunday", "property": "recurrence.pattern.firstDayOfWeek", "required": false, "type": "string" }, "recurrence-index": { "description": "[recurrence.pattern] 每月第几周: first|second|third|fourth|last (relativeMonthly 时必填)", "property": "recurrence.pattern.index", "required": false, "required_when": "recurrence-type is relativeMonthly", "type": "string" }, "recurrence-interval": { "description": "[recurrence整体必填] 循环间隔 (\u003e0；如 daily 时表示每N天，weekly 时表示每N周)", "property": "recurrence.pattern.interval", "required": false, "required_when": "any recurrence-* flag is provided", "type": "integer" }, "recurrence-range-type": { "description": "[recurrence整体必填] 循环范围: noEnd|endDate|numbered；与 --recurrence-type 必须成对出现", "property": "recurrence.range.type", "required": false, "required_when": "any recurrence-* flag is provided", "type": "string" }, "recurrence-type": { "description": "[recurrence整体必填] 循环类型: daily|weekly|absoluteMonthly|relativeMonthly|absoluteYearly；MCP 不合并部分字段，修改任一循环字段都要重传完整 pattern+range", "property": "recurrence.pattern.type", "required": false, "required_when": "any recurrence-* flag is provided", "type": "string" }, "rich-text-desc": { "description": "html格式的富文本类型日程描述，用于复杂内容的展示", "interface_description": "html格式的富文本类型日程描述，用于复杂内容的展示。", "property": "richTextDescription", "required": false, "type": "string" }, "start": { "description": "新开始时间 ISO-8601", "format": "date-time", "interface_description": "日程开始时间，格式为ISO-8601的带时区的date-time格式，例如2025-11-14T10:00:00+08:00。", "property": "startDateTime", "required": false, "type": "string" }, "timezone": { "description": "时区 IANA 格式 (例如 Asia/Shanghai)", "interface_description": "IANA Time Zone Database name. 指定日程时区，比如：Asia/Shanghai. 默认值为Asia/Shanghai", "property": "timeZone", "required": false, "type": "string" }, "title": { "description": "新标题", "interface_description": "日程标题，最大不超过2048个字符。", "property": "summary", "required": false, "type": "string" } }, "path": "calendar.update_calendar_event", "primary_cli_path": "calendar event update", "product_id": "calendar", "reviewed": false, "risk": "medium", "source": "runtime:calendar", "title": "修改日程", "use_when": [ "日程/会议/约会/日历；修改/改时间/改描述" ] }, "chat.add_custom_group_role": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.add_custom_group_role", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "添加群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除群身份”请改用 dws chat group-role remove", "要“拉取会话的群身份”请改用 dws chat group-role list", "要“根据用户提供的群和成员为在群里查询成员的群身份”请改用 dws chat group-role query-user" ], "canonical_path": "chat.add_custom_group_role", "cli_name": "add", "cli_path": "chat group-role add", "confirmation": "not_required", "description": "添加群身份", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group-role add --group \u003copenConversationId\u003e --name \"管理员\"" ], "group": "group-role", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "add_custom_group_role" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_custom_group_role", "parameter_count": 2, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "name": { "description": "群身份名称 (必填)", "interface_description": "name", "property": "name", "required": true, "type": "string" } }, "path": "chat.add_custom_group_role", "primary_cli_path": "chat group-role add", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "添加群身份", "use_when": [ "创建/添加群身份" ] }, "chat.add_emoji_reaction": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.add_emoji_reaction", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "消息添加 emoji 回应", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建并推送流式卡片”请改用 dws chat message send-card", "要“合并转发消息”请改用 dws chat message combine-forward", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.add_emoji_reaction", "cli_name": "add-emoji", "cli_path": "chat message add-emoji", "confirmation": "not_required", "description": "消息添加 emoji 回应", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message add-emoji --conversation-id \u003copenConversationId\u003e --msg-id \u003copenMsgId\u003e --emoji \"赞\"", "dws chat message add-emoji --conversation-id \u003copenConversationId\u003e --msg-id \u003copenMsgId\u003e --emoji \"鼓掌\"" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "add_emoji_reaction" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_emoji_reaction", "parameter_count": 6, "parameters": { "chat": { "description": "--conversation-id 的别名", "property": "chat", "required": false, "type": "string" }, "conversation-id": { "description": "会话 openConversationId (必填，支持单聊/群聊)", "property": "conversationId", "required": true, "type": "string" }, "emoji": { "description": "emoji 表情名称 (必填)", "interface_description": "emojiName", "property": "emojiName", "required": true, "type": "string" }, "group": { "description": "--conversation-id 的别名", "interface_description": "openConversationId", "property": "openConversationId", "required": false, "type": "string" }, "id": { "description": "--conversation-id 的别名", "property": "id", "required": false, "type": "string" }, "msg-id": { "description": "消息 openMsgId (必填)", "interface_description": "openMsgId", "property": "openMsgId", "required": true, "type": "string" } }, "path": "chat.add_emoji_reaction", "primary_cli_path": "chat message add-emoji", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "消息添加 emoji 回应", "use_when": [ "emoji回应/表情回应/给消息加表情" ] }, "chat.add_group_member": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.add_group_member", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "向群中添加成员", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“从群中移除成员”请改用 dws chat group members remove", "要“将机器人添加到群中”请改用 dws chat group members add-bot", "要“查看群成员列表”请改用 dws chat group members list" ], "canonical_path": "chat.add_group_member", "cli_name": "add", "cli_path": "chat group members add", "confirmation": "not_required", "description": "添加群成员", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group members add --id \u003copenconversation_id\u003e --users userId1,userId2" ], "group": "group.members", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "add_group_member" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_group_member", "parameter_count": 2, "parameters": { "id": { "description": "群 ID / openconversation_id (必填)", "interface_description": "群Id，可以从根据关键词搜索群列表服务获取", "property": "openconversation_id", "required": true, "type": "string" }, "users": { "description": "要添加的用户 userId 或 openDingTalkId（可混传），逗号分隔 (必填)", "interface_description": "用户ID列表", "interface_type": "array", "property": "userId", "required": true, "type": "string" } }, "path": "chat.add_group_member", "primary_cli_path": "chat group members add", "product_id": "chat", "risk": "medium", "source": "runtime:group-chat", "title": "add_group_member", "use_when": [ "把张三拉进群；添加群成员", "拉人进群/加群成员" ] }, "chat.add_robot_to_group": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.add_robot_to_group", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "将机器人添加到群中", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“从群中移除成员”请改用 dws chat group members remove", "要“向群中添加成员”请改用 dws chat group members add", "要“查看群成员列表”请改用 dws chat group members list" ], "canonical_path": "chat.add_robot_to_group", "cli_name": "add-bot", "cli_path": "chat group members add-bot", "confirmation": "not_required", "description": "将自定义机器人添加到当前用户有管理权限的群聊中。如果没有权限则会报错", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group members add-bot --robot-code \u003crobot-code\u003e --id \u003copenconversation_id\u003e", "dws chat group members add-bot --group \u003copenconversation_id\u003e --robot-code \u003crobot-code\u003e" ], "group": "group.members", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "bot", "rpc_name": "add_robot_to_group" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_robot_to_group", "parameter_count": 2, "parameters": { "id": { "description": "群聊 openConversationId (必填)", "property": "id", "required": true, "type": "string" }, "robot-code": { "description": "机器人 Code (必填)", "interface_description": "机器人code，可在开发者后台查看，或者调用创建机器人服务获取", "property": "robotCode", "required": true, "type": "string" } }, "path": "chat.add_robot_to_group", "primary_cli_path": "chat group members add-bot", "product_id": "chat", "risk": "medium", "source": "hardcoded:chat", "title": "将企业机器人添加我有权限的群中", "use_when": [ "加机器人到群", "邀请机器人进群" ] }, "chat.add_text_emotion": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.add_text_emotion", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "添加文字表情", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建并推送流式卡片”请改用 dws chat message send-card", "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji" ], "canonical_path": "chat.add_text_emotion", "cli_name": "add-text-emotion", "cli_path": "chat message add-text-emotion", "confirmation": "not_required", "description": "添加文字表情", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message add-text-emotion --conversation-id \u003copenConversationId\u003e --msg-id \u003copenMsgId\u003e --emotion-id \u003cemotionId\u003e --emotion-name \"赞\" --text \"nice\" --background-id im_bg_5" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "add_text_emotion" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_text_emotion", "parameter_count": 9, "parameters": { "background-id": { "description": "背景 ID (必填)", "interface_description": "backgroundId", "property": "backgroundId", "required": true, "type": "string" }, "chat": { "description": "--conversation-id 的别名", "property": "chat", "required": false, "type": "string" }, "conversation-id": { "description": "会话 openConversationId (必填，支持单聊/群聊)", "property": "conversationId", "required": true, "type": "string" }, "emotion-id": { "description": "表情 ID (必填，通过 create-text-emotion 获取)", "interface_description": "emotionId", "property": "emotionId", "required": true, "type": "string" }, "emotion-name": { "description": "表情名称 (必填)", "interface_description": "emotionName", "property": "emotionName", "required": true, "type": "string" }, "group": { "description": "--conversation-id 的别名", "interface_description": "openConversationId", "property": "openConversationId", "required": false, "type": "string" }, "id": { "description": "--conversation-id 的别名", "property": "id", "required": false, "type": "string" }, "msg-id": { "description": "消息 openMsgId (必填)", "interface_description": "openMsgId", "property": "openMsgId", "required": true, "type": "string" }, "text": { "description": "文字内容 (必填)", "interface_description": "text", "property": "text", "required": true, "type": "string" } }, "path": "chat.add_text_emotion", "primary_cli_path": "chat message add-text-emotion", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "添加文字表情", "use_when": [ "文字表情回应/添加文字表情" ] }, "chat.combine_forward_messages": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.combine_forward_messages", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "合并转发消息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建并推送流式卡片”请改用 dws chat message send-card", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.combine_forward_messages", "cli_name": "combine-forward", "cli_path": "chat message combine-forward", "confirmation": "not_required", "description": "合并转发消息", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message combine-forward --src-conversation-id \u003csrcOpenCid\u003e --msg-ids \u003cid1\u003e,\u003cid2\u003e,\u003cid3\u003e --dest-conversation-id \u003cdestOpenCid\u003e", "dws chat message combine-forward --src-conversation-id \u003csrcOpenCid\u003e --msg-ids \u003cid1\u003e,\u003cid2\u003e --dest-conversation-id \u003cdestOpenCid\u003e --uuid \u003cidempotencyKey\u003e" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "combine_forward_messages" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "combine_forward_messages", "parameter_count": 4, "parameters": { "dest-conversation-id": { "description": "目标会话 openConversationId (必填，支持单聊/群聊)", "interface_description": "destOpenCid", "property": "destOpenCid", "required": true, "type": "string" }, "msg-ids": { "description": "源消息 openMessageId 列表，逗号分隔 (必填)", "interface_description": "srcOpenMessageIds", "interface_type": "array", "property": "srcOpenMessageIds", "required": true, "type": "string" }, "src-conversation-id": { "description": "源会话 openConversationId (必填，支持单聊/群聊)", "interface_description": "srcOpenCid", "property": "srcOpenCid", "required": true, "type": "string" }, "uuid": { "description": "幂等键（可选）", "interface_description": "uuid", "property": "uuid", "required": false, "type": "string" } }, "path": "chat.combine_forward_messages", "primary_cli_path": "chat message combine-forward", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "合并转发消息", "use_when": [ "合并转发/批量转发/合并转发多条消息", "合并转发/批量转发/合并转发多条消息；合并转发多条消息" ] }, "chat.create_and_send_card": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.create_and_send_card", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建并推送流式卡片", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.create_and_send_card", "cli_name": "send-card", "cli_path": "chat message send-card", "confirmation": "not_required", "constraints": { "mutually_exclusive": [ [ "group", "receiver" ] ], "require_one_of": [ [ "group", "receiver" ] ] }, "description": "创建并推送流式卡片", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message send-card --group \u003copenConversationId\u003e", "dws chat message send-card --receiver \u003copenDingTalkId\u003e" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "create_and_send_card" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_and_send_card", "parameter_count": 2, "parameters": { "group": { "description": "群聊 openConversationId（群聊时必填，与 --receiver 互斥）", "interface_description": "openConversationId", "property": "openConversationId", "required": false, "type": "string" }, "receiver": { "description": "单聊接收者 openDingTalkId（单聊时必填，与 --group 互斥）", "interface_description": "receiverOpenDingTalkId", "property": "receiverOpenDingTalkId", "required": false, "type": "string" } }, "path": "chat.create_and_send_card", "primary_cli_path": "chat message send-card", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "create_and_send_card", "use_when": [ "发卡片消息/推送流式卡片；创建并推送流式卡片" ] }, "chat.create_group_conversation": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.create_group_conversation", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建一个群聊，支持指定群名称、初始成员列表等参数。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“获取群邀请链接”请改用 dws chat group invite-url", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.create_group_conversation", "cli_name": "create", "cli_path": "chat group create", "confirmation": "not_required", "description": "创建一个群聊，支持指定群名称、初始成员列表等参数。可选择内部群/外部群/普通群/内部话题圈/外部话题圈/普通话题圈。默认为内部群。当选择内部群时如果所选成员非组织内成员会创建失败，创建成功后会返回。", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group create --name \"Q1 项目冲刺群\" --users userId1,userId2,userId3" ], "group": "group", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "create_group_conversation" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_group_conversation", "parameter_count": 4, "parameters": { "name": { "description": "群名称 (必填)", "property": "name", "required": true, "type": "string" }, "thread": { "description": "开启话题模式，将创建话题圈", "property": "thread", "required": false, "type": "boolean" }, "type": { "default": "INTERNAL", "description": "群类型: INTERNAL(内部群,默认)/EXTERNAL(外部群)/NORMAL(普通群)", "property": "type", "required": false, "type": "string" }, "users": { "description": "成员 userId 或 openDingTalkId（可混传），逗号分隔 (必填)", "property": "users", "required": true, "type": "string" } }, "path": "chat.create_group_conversation", "primary_cli_path": "chat group create", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "hardcoded:chat", "title": "create_group_conversation", "use_when": [ "帮我建一个项目群；创建群聊", "建群/创建群聊" ] }, "chat.create_smart_conv_category": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/chat.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "创建按群名称关键词或群成员自动匹配会话的智能分组", "agent_summary_source": "agent-selection-contract-v1", "availability": "available", "avoid_when": [ "只需要普通静态会话分组，或不希望根据关键词和成员自动匹配会话时不要使用" ], "canonical_path": "chat.create_smart_conv_category", "cli_name": "create-smart", "cli_path": "chat category create-smart", "confirmation": "not_required", "description": "创建智能会话分组，可指定群名称关键词和群内成员 openDingTalkId 作为匹配规则。", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat category create-smart --name \"重点项目群\" --keywords \"项目,重点\"" ], "group": "category", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "create_smart_conv_category" }, "is_alias": false, "name": "create_smart_conv_category", "parameter_count": 3, "parameters": { "keywords": { "description": "群名称关键词列表，逗号分隔（可选）", "interface_type": "array", "property": "groupNameKeywords", "required": false, "type": "string" }, "members": { "description": "群内成员 openDingTalkId 列表，逗号分隔（可选）", "interface_type": "array", "property": "memberOpenDingTalkIds", "required": false, "type": "string" }, "name": { "description": "分组名称 (必填)", "property": "categoryName", "required": true, "type": "string" } }, "path": "chat.create_smart_conv_category", "primary_cli_path": "chat category create-smart", "product_id": "chat", "reviewed": true, "risk": "medium", "source": "manual-schema-hint", "title": "创建智能会话分组", "use_when": [ "需要按群名称关键词或群成员自动归类会话时创建智能会话分组" ] }, "chat.create_text_emotion": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.create_text_emotion", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建文字表情", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.create_text_emotion", "cli_name": "create-text-emotion", "cli_path": "chat message create-text-emotion", "confirmation": "not_required", "description": "创建文字表情", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message create-text-emotion --emotion-name \"赞\" --text \"nice\"", "dws chat message create-text-emotion --emotion-name \"感谢\" --text \"感谢\" --background-id im_bg_5" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "create_text_emotion" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_text_emotion", "parameter_count": 3, "parameters": { "background-id": { "description": "背景 ID（可选，不传则由服务端默认分配）", "property": "backgroundId", "required": false, "type": "string" }, "emotion-name": { "description": "表情名称 (必填)", "interface_description": "emotionName", "property": "emotionName", "required": true, "type": "string" }, "text": { "description": "文字内容 (必填)", "interface_description": "text", "property": "text", "required": true, "type": "string" } }, "path": "chat.create_text_emotion", "primary_cli_path": "chat message create-text-emotion", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "创建文字表情", "use_when": [ "创建文字表情/新建文字表情" ] }, "chat.dismiss_group": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.dismiss_group", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "解散群聊", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“获取群邀请链接”请改用 dws chat group invite-url" ], "canonical_path": "chat.dismiss_group", "cli_name": "dismiss", "cli_path": "chat group dismiss", "confirmation": "not_required", "description": "解散群聊", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group dismiss --group \u003copenConversationId\u003e" ], "group": "group", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "dismiss_group" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "dismiss_group", "parameter_count": 1, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" } }, "path": "chat.dismiss_group", "primary_cli_path": "chat group dismiss", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "解散群聊", "use_when": [ "解散群/解散群聊", "解散群/解散群聊；解散群聊" ] }, "chat.download_media": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/chat.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "下载聊天消息中的图片/视频/语音等资源到本地文件", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.download_media", "cli_name": "download-media", "cli_path": "chat message download-media", "confirmation": "not_required", "description": "下载聊天消息中的图片、视频、语音等资源到本地文件。\n\n流程:\n 1. 根据 resourceType + resource-id + message-id + open-conversation-id 向服务端获取下载 URL\n 2. HTTP GET 下载文件到本地\n\n--output 指定本地保存路径，可以是文件路径或目录。\n如果指定目录，文件名从下载 URL 中自动推断。默认保存到当前目录。", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message download-media --type mediaId --resource-id \u003cmediaId\u003e --message-id \u003copenMessageId\u003e --open-conversation-id \u003copenConversationId\u003e --output ./photo.jpg", "dws chat message download-media --type mediaId --resource-id \u003cmediaId\u003e --message-id \u003copenMessageId\u003e --open-conversation-id \u003copenConversationId\u003e --output ./downloads/photo.jpg" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "is_alias": false, "name": "download_media", "parameter_count": 5, "parameters": { "message-id": { "description": "消息 openMessageId (必填)", "property": "messageId", "required": true, "type": "string" }, "open-conversation-id": { "description": "会话 openConversationId (必填)", "property": "openConversationId", "required": true, "type": "string" }, "output": { "description": "本地保存路径，文件或目录 (必填)", "property": "output", "required": true, "type": "string" }, "resource-id": { "description": "资源 ID，mediaId 类型时为消息中的 mediaId 值 (必填)", "property": "resourceId", "required": true, "type": "string" }, "type": { "description": "资源类型: mediaId (必填)", "enum": [ "mediaId" ], "property": "type", "required": true, "type": "string" } }, "path": "chat.download_media", "primary_cli_path": "chat message download-media", "product_id": "chat", "reviewed": true, "risk": "low", "source": "runtime:im", "title": "下载消息中的资源（图片/视频/语音等）到本地", "use_when": [ "下载聊天消息中的图片/视频/语音等资源到本地文件" ] }, "chat.forward_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.forward_message", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "单条消息转发", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.forward_message", "cli_name": "forward", "cli_path": "chat message forward", "confirmation": "not_required", "description": "单条消息转发", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message forward --src-conversation-id \u003csrcOpenCid\u003e --msg-id \u003copenMessageId\u003e --dest-conversation-id \u003cdestOpenCid\u003e" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "forward_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "forward_message", "parameter_count": 4, "parameters": { "dest-conversation-id": { "description": "目标会话 openConversationId (必填，支持单聊/群聊)", "interface_description": "destOpenCid", "property": "destOpenCid", "required": true, "type": "string" }, "msg-id": { "description": "源消息 openMessageId (必填)", "interface_description": "srcOpenMessageId", "property": "srcOpenMessageId", "required": true, "type": "string" }, "src-conversation-id": { "description": "源会话 openConversationId (必填，支持单聊/群聊)", "interface_description": "srcOpenCid", "property": "srcOpenCid", "required": true, "type": "string" }, "uuid": { "description": "幂等键（可选）", "interface_description": "uuid", "property": "uuid", "required": false, "type": "string" } }, "path": "chat.forward_message", "primary_cli_path": "chat message forward", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "单条消息转发", "use_when": [ "转发消息/把消息转到另一个群；转发单条消息", "转发消息/转发一条消息/把消息转发到另一个群" ] }, "chat.forward_topic": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.forward_topic", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "转发某个话题到其他会话", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.forward_topic", "cli_name": "forward-topic", "cli_path": "chat message forward-topic", "confirmation": "not_required", "description": "转发某个话题到其他会话", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message forward-topic --src-conversation-id \u003csrcOpenCid\u003e --src-msg-id \u003copenMessageId\u003e --src-thread-id \u003cconvThreadId\u003e --dest-conversation-id \u003cdestOpenCid\u003e" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "forward_topic" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "forward_topic", "parameter_count": 4, "parameters": { "dest-conversation-id": { "description": "目标会话 openConversationId (必填，转发到的会话)", "interface_description": "目标开放会话id", "property": "destOpenConversationId", "required": true, "type": "string" }, "src-conversation-id": { "description": "源会话 openConversationId (必填，消息所在的会话)", "interface_description": "源开放会话id", "property": "srcOpenConversationId", "required": true, "type": "string" }, "src-msg-id": { "description": "源消息 openMessageId (必填，要转发的消息)", "interface_description": "源开放消息id", "property": "srcOpenMessageId", "required": true, "type": "string" }, "src-thread-id": { "description": "话题 ID (必填，格式: convThread + 加密后的convThreadId)", "interface_description": "源话题id", "property": "srcOpenConvThreadId", "required": true, "type": "string" } }, "path": "chat.forward_topic", "primary_cli_path": "chat message forward-topic", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "转发某个话题到其他会话", "use_when": [ "转发话题/转发话题消息", "转发话题/转发话题消息/话题转发到另一个群；转发话题消息" ] }, "chat.get_conv_info_by_group_id": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.get_conv_info_by_group_id", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "根据群号获取群聊信息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“获取群邀请链接”请改用 dws chat group invite-url", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.get_conv_info_by_group_id", "cli_name": "get-by-group-id", "cli_path": "chat group get-by-group-id", "confirmation": "not_required", "description": "根据群号获取群聊信息", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat group get-by-group-id --group-id 12345678" ], "group": "group", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "get_conv_info_by_group_id" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_conv_info_by_group_id", "parameter_count": 1, "parameters": { "group-id": { "description": "群号 (必填，数字类型)", "interface_description": "groupId", "interface_type": "number", "property": "groupId", "required": true, "type": "integer" } }, "path": "chat.get_conv_info_by_group_id", "primary_cli_path": "chat group get-by-group-id", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:im", "title": "根据群号获取群聊信息", "use_when": [ "根据群号查群信息/群号查群/群号转openConversationId", "根据群号查群信息/群号转openConversationId；群号查群聊信息" ] }, "chat.get_conversation_info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.get_conversation_info", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取会话的基础信息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取会话的基础信息”" ], "canonical_path": "chat.get_conversation_info", "cli_name": "conversation-info", "cli_path": "chat conversation-info", "confirmation": "not_required", "constraints": { "mutually_exclusive": [ [ "group", "user", "open-dingtalk-id" ] ], "require_one_of": [ [ "group", "user", "open-dingtalk-id" ] ] }, "description": "获取会话的基础信息", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat conversation-info --group \u003copenConversationId\u003e --format json", "dws chat conversation-info --user \u003cuserId\u003e --format json" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "get_conversation_info" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_conversation_info", "parameter_count": 3, "parameters": { "group": { "description": "群聊 openConversationId（群聊时使用）", "interface_description": "openConversationId", "property": "openConversationId", "required": false, "type": "string" }, "open-dingtalk-id": { "description": "单聊对方 openDingTalkId（单聊时使用）", "interface_description": "openDingTalkId", "property": "openDingTalkId", "required": false, "type": "string" }, "user": { "description": "单聊对方 userId（单聊时使用）", "property": "user", "required": false, "type": "string" } }, "path": "chat.get_conversation_info", "primary_cli_path": "chat conversation-info", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:group-chat", "title": "get_conversation_info", "use_when": [ "获取会话的基础信息" ] }, "chat.get_group_invite_url": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.get_group_invite_url", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取群邀请链接", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.get_group_invite_url", "cli_name": "invite-url", "cli_path": "chat group invite-url", "confirmation": "not_required", "description": "获取群邀请链接", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat group invite-url --group \u003copenConversationId\u003e", "dws chat group invite-url --group \u003copenConversationId\u003e --expires-seconds 86400" ], "group": "group", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "get_group_invite_url" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_group_invite_url", "parameter_count": 2, "parameters": { "expires-seconds": { "description": "链接有效期（秒），0 表示永久有效，不传使用服务端默认值", "interface_description": "expiresSeconds", "interface_type": "number", "property": "expiresSeconds", "required": false, "type": "integer" }, "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" } }, "path": "chat.get_group_invite_url", "primary_cli_path": "chat group invite-url", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:im", "title": "获取群邀请链接", "use_when": [ "群邀请链接/入群链接/加群链接" ] }, "chat.list_conversation_message_v2": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.list_conversation_message_v2", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "拉取指定群聊的会话消息内容", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.list_conversation_message_v2", "cli_name": "list", "cli_path": "chat message list", "confirmation": "not_required", "constraints": { "mutually_exclusive": [ [ "group", "user", "open-dingtalk-id" ] ], "require_one_of": [ [ "group", "user", "open-dingtalk-id" ] ] }, "description": "拉取指定群聊的会话消息内容", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message list --group \u003copenconversation_id\u003e --time \"2025-03-01 00:00:00\"", "dws chat message list --user \u003cuserId\u003e --time \"2025-03-01 00:00:00\" --limit 50" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "list_conversation_message_v2" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_conversation_message_v2", "parameter_count": 6, "parameters": { "direction": { "description": "时间方向: newer=从给定时间往现在拉，older=从给定时间往以前拉（推荐）", "property": "direction", "required": false, "type": "string" }, "group": { "description": "群聊 openconversation_id（群聊时必填）", "interface_description": "会话Id", "property": "openconversation_id", "required": false, "type": "string" }, "limit": { "description": "返回数量，不传则不限制", "interface_description": "返回数量", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "open-dingtalk-id": { "description": "单聊用户 openDingTalkId（单聊时与 --user 二选一，适用于无法获取 userId 的场景）", "property": "openDingtalkId", "required": false, "type": "string" }, "time": { "description": "开始时间，格式: yyyy-MM-dd HH:mm:ss (必填)", "interface_description": "开始时间，格式：yyyy-MM-dd HH:mm:ss，非必填", "property": "time", "required": true, "type": "string" }, "user": { "description": "单聊用户 userId（单聊时与 --open-dingtalk-id 二选一）", "property": "user", "required": false, "type": "string" } }, "path": "chat.list_conversation_message_v2", "primary_cli_path": "chat message list", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:group-chat", "title": "list_conversation_message_v2", "use_when": [ "2. 拉取群消息", "和某人的单聊聊天记录/拉某人单聊历史", "拉取一下上周项目群的聊天记录；拉取会话消息", "拉取和张三的单聊记录；拉取单聊消息", "拉取和某人的单聊记录/单聊消息", "某个群的聊天记录", "聊天记录/会话消息/拉取会话" ] }, "chat.list_conversations_by_category": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.list_conversations_by_category", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "拉取用户指定自定义会话分组下的会话", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“获取用户自定义会话分组”请改用 dws chat category list" ], "canonical_path": "chat.list_conversations_by_category", "cli_name": "list-conversations", "cli_path": "chat category list-conversations", "confirmation": "not_required", "description": "拉取用户指定自定义会话分组下的会话", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat category list-conversations --category-id \u003c分组ID\u003e", "dws chat category list-conversations --category-id \u003c分组ID\u003e --exclude-muted" ], "group": "category", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "list_conversations_by_category" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_conversations_by_category", "parameter_count": 2, "parameters": { "category-id": { "description": "会话分组 ID (必填)", "interface_description": "categoryId", "interface_type": "string", "property": "categoryId", "required": true, "type": "integer" }, "exclude-muted": { "description": "是否排除已设置免打扰的会话（默认 false）", "interface_description": "excludeMuted", "property": "excludeMuted", "required": false, "type": "boolean" } }, "path": "chat.list_conversations_by_category", "primary_cli_path": "chat category list-conversations", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:im", "title": "list_conversations_by_category", "use_when": [ "某个分组下有哪些会话；分组下会话列表", "某个分组下的会话/分组会话列表" ] }, "chat.list_custom_group_roles": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.list_custom_group_roles", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "拉取会话的群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除群身份”请改用 dws chat group-role remove", "要“根据用户提供的群和成员为在群里查询成员的群身份”请改用 dws chat group-role query-user", "要“添加群身份”请改用 dws chat group-role add" ], "canonical_path": "chat.list_custom_group_roles", "cli_name": "list", "cli_path": "chat group-role list", "confirmation": "not_required", "description": "拉取会话的群身份", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat group-role list --group \u003copenConversationId\u003e" ], "group": "group-role", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "list_custom_group_roles" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_custom_group_roles", "parameter_count": 1, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" } }, "path": "chat.list_custom_group_roles", "primary_cli_path": "chat group-role list", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:im", "title": "拉取会话的群身份", "use_when": [ "查看群身份/群的自定义身份列表" ] }, "chat.list_group_bots": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.list_group_bots", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取群内所有机器人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.list_group_bots", "cli_name": "bots", "cli_path": "chat group bots", "confirmation": "not_required", "description": "获取群内所有机器人", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat group bots --group \u003copenConversationId\u003e" ], "group": "group", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "bot", "rpc_name": "list_group_bots" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_group_bots", "parameter_count": 1, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "property": "group", "required": true, "type": "string" } }, "path": "chat.list_group_bots", "primary_cli_path": "chat group bots", "product_id": "chat", "reviewed": false, "risk": "low", "source": "hardcoded:chat", "title": "list_group_bots", "use_when": [ "群机器人列表/群里有哪些机器人/查看群机器人", "群里有哪些机器人/查看群机器人/列出群机器人；查看群内机器人列表" ] }, "chat.list_individual_chat_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.list_individual_chat_message", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "拉取指定用户的单聊会话消息内容", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.list_individual_chat_message", "cli_name": "list-direct", "cli_path": "chat message list-direct", "confirmation": "not_required", "constraints": { "mutually_exclusive": [ [ "user", "open-dingtalk-id" ] ], "require_one_of": [ [ "user", "open-dingtalk-id" ] ] }, "description": "拉取指定用户的单聊会话消息内容", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message list-direct --time \u003ctime\u003e --user \u003cuser\u003e" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "list_individual_chat_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_individual_chat_message", "parameter_count": 5, "parameters": { "direction": { "description": "时间方向: newer=从给定时间往现在拉，older=从给定时间往以前拉", "property": "direction", "required": false, "type": "string" }, "limit": { "default": "50", "description": "每页返回数量（默认 50）", "interface_description": "返回数量", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "open-dingtalk-id": { "description": "对方 openDingTalkId（非同组织普通好友场景，与 --user 二选一）", "interface_description": "openDingTalkId，用于非同组织的普通好友", "property": "openDingTalkId", "required": false, "type": "string" }, "time": { "description": "开始时间，格式 yyyy-MM-dd HH:mm:ss (必填)", "interface_description": "开始时间，格式：yyyy-MM-dd HH:mm:ss，非必填", "property": "time", "required": true, "type": "string" }, "user": { "description": "对方 userId（同组织内同事，与 --open-dingtalk-id 二选一）", "interface_description": "单聊用户ID", "property": "userId", "required": false, "type": "string" } }, "path": "chat.list_individual_chat_message", "primary_cli_path": "chat message list-direct", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:group-chat", "title": "list_individual_chat_message", "use_when": [ "拉取指定用户的单聊会话消息内容" ] }, "chat.list_messages_by_ids": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.list_messages_by_ids", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量查消息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.list_messages_by_ids", "cli_name": "list-by-ids", "cli_path": "chat message list-by-ids", "confirmation": "not_required", "description": "批量查消息", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message list-by-ids --msg-ids msgId1,msgId2,msgId3" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "list_messages_by_ids" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_messages_by_ids", "parameter_count": 1, "parameters": { "msg-ids": { "description": "消息 ID 列表，逗号分隔，最多 50 条 (必填)", "interface_description": "openMsgIds", "interface_type": "array", "property": "openMsgIds", "required": true, "type": "string" } }, "path": "chat.list_messages_by_ids", "primary_cli_path": "chat message list-by-ids", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:im", "title": "批量查消息", "use_when": [ "批量查消息/按ID查消息/根据消息ID查" ] }, "chat.list_owned_or_admin_groups": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.list_owned_or_admin_groups", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "拉取我创建/管理的群", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.list_owned_or_admin_groups", "cli_name": "list-my-groups", "cli_path": "chat group list-my-groups", "confirmation": "not_required", "description": "拉取我创建/管理的群", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat group list-my-groups", "dws chat group list-my-groups --role OWNER" ], "group": "group", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "list_owned_or_admin_groups" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_owned_or_admin_groups", "parameter_count": 3, "parameters": { "exclude-muted": { "description": "是否排除已设置免打扰的群聊（默认 false）", "interface_description": "excludeMuted", "property": "excludeMuted", "required": false, "type": "boolean" }, "limit": { "description": "最多返回群数量，不传返回全部", "interface_description": "limit", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "role": { "description": "角色过滤: OWNER(仅群主) / ADMIN(仅管理员)，不传返回全部", "interface_description": "roleFilter", "property": "roleFilter", "required": false, "type": "string" } }, "path": "chat.list_owned_or_admin_groups", "primary_cli_path": "chat group list-my-groups", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:im", "title": "拉取我创建/管理的群", "use_when": [ "我创建的群/我管理的群/我是群主的群/我当管理员的群", "我创建的群/我管理的群/我是群主的群/我当管理员的群；拉取我创建/管理的群" ] }, "chat.list_pin_messages": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.list_pin_messages", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "拉取会话中钉住的(pin)消息列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.list_pin_messages", "cli_name": "list-pin-msg", "cli_path": "chat message list-pin-msg", "confirmation": "not_required", "description": "拉取会话中钉住的(pin)消息列表", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message list-pin-msg --open-conversation-id \u003copenConversationId\u003e", "dws chat message list-pin-msg --open-conversation-id \u003copenConversationId\u003e --size 50" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "list_pin_messages" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_pin_messages", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标（首次不传，翻页时传上次返回的 nextCursor）", "interface_description": "拉取消息的时间位点（毫秒时间戳），默认当前时间", "property": "cursor", "required": false, "type": "string" }, "open-conversation-id": { "description": "会话 openConversationId (必填，支持群聊/单聊)", "interface_description": "开放会话id", "property": "openConversationId", "required": true, "type": "string" }, "size": { "description": "一次拉取的消息数量（默认 20，最大 100）", "interface_description": "一次拉取的消息数量，默认20，最大100", "interface_type": "string", "property": "count", "required": false, "type": "integer" } }, "path": "chat.list_pin_messages", "primary_cli_path": "chat message list-pin-msg", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:im", "title": "拉取会话中钉住的消息列表", "use_when": [ "查看钉住的消息/Pin列表/钉住消息列表；拉取钉住消息列表" ] }, "chat.list_special_focus_messages": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.list_special_focus_messages", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "拉取特别关注人的消息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.list_special_focus_messages", "cli_name": "list-focused", "cli_path": "chat message list-focused", "confirmation": "not_required", "description": "拉特别关注人的消息", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message list-focused --limit 50", "dws chat message list-focused --limit 20 --cursor \u003cnextCursor\u003e" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "list_special_focus_messages" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_special_focus_messages", "parameter_count": 2, "parameters": { "cursor": { "description": "分页游标（首次不传或传 0，翻页传 nextCursor）", "interface_description": "分页游标，首次不传", "interface_type": "number", "property": "cursor", "required": false, "type": "integer" }, "limit": { "default": "50", "description": "每页返回数量（默认 50）", "interface_description": "每页数量，必填", "interface_type": "number", "property": "limit", "required": false, "type": "integer" } }, "path": "chat.list_special_focus_messages", "primary_cli_path": "chat message list-focused", "product_id": "chat", "risk": "low", "source": "runtime:group-chat", "title": "list_special_focus_messages", "use_when": [ "我特别关注的人最近发了什么消息/关注的人最近聊了啥/星标联系人最近的动态", "特别关注人的消息/关注的人的消息/星标联系人的消息" ] }, "chat.list_top_conversations": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.list_top_conversations", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "拉取用户的置顶会话", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "所有会话/全部会话列表/我的会话；分页获取全部会话", "置顶会话/取消置顶；设置/取消会话置顶" ], "canonical_path": "chat.list_top_conversations", "cli_name": "list-top-conversations", "cli_path": "chat list-top-conversations", "confirmation": "not_required", "description": "拉取用户的置顶会话", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat list-top-conversations --limit 1000", "dws chat list-top-conversations --limit 1000 --cursor \u003cnextCursor\u003e" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "list_top_conversations" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_top_conversations", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标（首次不传或传 0，翻页传 nextCursor）", "interface_description": "cursor", "interface_type": "number", "property": "cursor", "required": false, "type": "integer" }, "exclude-muted": { "description": "是否排除已设置免打扰的会话（默认 false）", "interface_description": "excludeMuted", "property": "excludeMuted", "required": false, "type": "boolean" }, "limit": { "default": "1000", "description": "每页返回数量（默认 1000）", "interface_description": "limit", "interface_type": "string", "property": "limit", "required": false, "type": "integer" } }, "path": "chat.list_top_conversations", "primary_cli_path": "chat list-top-conversations", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:group-chat", "title": "list_top_conversations", "use_when": [ "置顶会话/置顶消息", "置顶会话/置顶消息/我的置顶/查看置顶" ] }, "chat.list_topic_replies": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.list_topic_replies", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "拉取群话题回复消息列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.list_topic_replies", "cli_name": "list-topic-replies", "cli_path": "chat message list-topic-replies", "confirmation": "not_required", "description": "针对话题群中的单个话题，分页拉取话题的回复消息", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message list-topic-replies --group \u003copenconversation_id\u003e --topic-id \u003ctopicId\u003e", "dws chat message list-topic-replies --group \u003copenconversation_id\u003e --topic-id \u003ctopicId\u003e --time \"2025-03-01 00:00:00\" --limit 20" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "list_topic_replies" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_topic_replies", "parameter_count": 5, "parameters": { "direction": { "description": "时间方向: newer=从给定时间往现在拉，older=从给定时间往以前拉（推荐，默认 older）", "property": "direction", "required": false, "type": "string" }, "group": { "description": "群会话 openconversationId (必填)", "interface_description": "群会话唯一标识", "property": "openconversationId", "required": true, "type": "string" }, "limit": { "default": "50", "description": "返回数量（默认 50）", "interface_description": "返回数量", "interface_type": "number", "property": "pageSize", "required": false, "type": "integer" }, "time": { "description": "开始时间，格式: yyyy-MM-dd HH:mm:ss（可选）", "interface_description": "格式：yyyy-MM-dd HH:mm:ss，非必填", "property": "startTime", "required": false, "type": "string" }, "topic-id": { "description": "话题 ID，由 dws chat message list 返回 (必填)", "interface_description": "由 dws chat message list 指令 返回", "property": "topicId", "required": true, "type": "string" } }, "path": "chat.list_topic_replies", "primary_cli_path": "chat message list-topic-replies", "product_id": "chat", "risk": "low", "source": "runtime:group-chat", "title": "list_topic_replies", "use_when": [ "群里某条话题的回复", "话题回复/群话题消息回复/拉取话题回复" ] }, "chat.list_user_define_conv_categories": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.list_user_define_conv_categories", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取用户自定义会话分组", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“拉取用户指定自定义会话分组下的会话”请改用 dws chat category list-conversations" ], "canonical_path": "chat.list_user_define_conv_categories", "cli_name": "list", "cli_path": "chat category list", "confirmation": "not_required", "description": "获取用户自定义会话分组", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat category list" ], "group": "category", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "list_user_define_conv_categories" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_user_define_conv_categories", "parameter_count": 0, "parameters": {}, "path": "chat.list_user_define_conv_categories", "primary_cli_path": "chat category list", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:im", "title": "获取用户自定义会话分组", "use_when": [ "查看会话分组/自定义分组", "查看会话分组/自定义分组；获取会话分组" ] }, "chat.query_custom_user_roles": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.query_custom_user_roles", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "根据用户提供的群和成员为在群里查询成员的群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除群身份”请改用 dws chat group-role remove", "要“拉取会话的群身份”请改用 dws chat group-role list", "要“添加群身份”请改用 dws chat group-role add" ], "canonical_path": "chat.query_custom_user_roles", "cli_name": "query-user", "cli_path": "chat group-role query-user", "confirmation": "not_required", "description": "根据用户提供的群和成员为在群里查询成员的群身份", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat group-role query-user --group \u003copenConversationId\u003e --user \u003cuserId\u003e" ], "group": "group-role", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "query_custom_user_roles" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_custom_user_roles", "parameter_count": 2, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "user": { "description": "用户 userId（必填）", "interface_description": "openDingTalkId", "property": "openDingTalkId", "required": true, "type": "string" } }, "path": "chat.query_custom_user_roles", "primary_cli_path": "chat group-role query-user", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:im", "title": "查询群成员的群身份", "use_when": [ "查询某人的群身份/某人在群里有什么身份" ] }, "chat.query_message_send_status": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.query_message_send_status", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询以当前用户的身份发送的消息的发送状态", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.query_message_send_status", "cli_name": "query-send-status", "cli_path": "chat message query-send-status", "confirmation": "not_required", "description": "查询以当前用户的身份发送的消息的发送状态", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message query-send-status --open-task-id \u003copenTaskId\u003e" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "query_message_send_status" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_message_send_status", "parameter_count": 1, "parameters": { "open-task-id": { "description": "消息发送任务 ID (必填)", "interface_description": "openTaskId", "property": "openTaskId", "required": true, "type": "string" } }, "path": "chat.query_message_send_status", "primary_cli_path": "chat message query-send-status", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:im", "title": "查询以当前用户的身份发送的消息的发送状态", "use_when": [ "查询消息发送状态/消息发没发成功/消息状态", "消息发没发成功/查询消息发送状态；查询消息发送状态" ] }, "chat.query_msg_read_status": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.query_msg_read_status", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询消息的已读/未读状态", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.query_msg_read_status", "cli_name": "read-status", "cli_path": "chat message read-status", "confirmation": "not_required", "description": "查询消息的已读/未读状态", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message read-status --conversation-id \u003copenConversationId\u003e --message-id \u003copenMessageId\u003e", "dws chat message read-status --conversation-id \u003copenConversationId\u003e --message-id \u003copenMessageId\u003e --user userId1,userId2" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "query_msg_read_status" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_msg_read_status", "parameter_count": 5, "parameters": { "conversation-id": { "description": "会话 openConversationId (必填，群聊或单聊均可)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "message-id": { "description": "消息 openMessageId，由 chat message list 返回 (必填)", "interface_description": "openMessageId", "property": "openMessageId", "required": true, "type": "string" }, "target-open-dingtalk-ids": { "description": "目标用户 openDingTalkId 列表，逗号分隔（可选，不传则查所有接收者）", "interface_description": "targetOpenDingTalkIds", "interface_type": "array", "property": "targetOpenDingTalkIds", "required": false, "type": "string" }, "user": { "description": "目标用户 userId，支持逗号分隔（可选，不传则查所有接收者）", "property": "user", "required": false, "type": "string" }, "users": { "description": "目标用户 userId 列表，逗号分隔（可选，不传则查所有接收者）", "property": "users", "required": false, "type": "string" } }, "path": "chat.query_msg_read_status", "primary_cli_path": "chat message read-status", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:im", "title": "查询消息的已读/未读状态", "use_when": [ "消息已读未读/谁看了消息/查读状态/消息读取状态", "谁看了这条消息/消息已读未读/查读状态；查询消息已读状态" ] }, "chat.quit_group": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.quit_group", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "用户退群", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.quit_group", "cli_name": "quit", "cli_path": "chat group quit", "confirmation": "not_required", "description": "用户退群", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group quit --group \u003copenConversationId\u003e" ], "group": "group", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "quit_group" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "quit_group", "parameter_count": 1, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" } }, "path": "chat.quit_group", "primary_cli_path": "chat group quit", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "用户退群", "use_when": [ "退群/退出群聊/离开群；退出群聊" ] }, "chat.recall_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.recall_message", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "撤回用户发送的消息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.recall_message", "cli_name": "recall", "cli_path": "chat message recall", "confirmation": "user_required", "description": "撤回用户发送的消息", "display": "群聊 / 消息 / 机器人", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws chat message recall --conversation-id \u003copenConversationId\u003e --msg-id \u003copenMessageId\u003e" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "recall_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "recall_message", "parameter_count": 2, "parameters": { "conversation-id": { "description": "会话 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "msg-id": { "description": "消息 openMessageId (必填)", "interface_description": "openMessageId", "property": "openMessageId", "required": true, "type": "string" } }, "path": "chat.recall_message", "primary_cli_path": "chat message recall", "product_id": "chat", "reviewed": false, "risk": "high", "source": "runtime:im", "title": "撤回用户发送的消息", "use_when": [ "撤回我发的消息/撤回消息", "撤回我发的消息/撤回消息；撤回个人消息" ] }, "chat.recall_robot_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "机器人撤回消息（--group 群聊 / 不传为单聊）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.recall_robot_message", "cli_name": "recall-by-bot", "cli_path": "chat message recall-by-bot", "confirmation": "user_required", "description": "群聊：传 --group 与 --keys；单聊：仅传 --keys。--keys 为发送时返回的 processQueryKey 列表，逗号分隔。", "display": "群聊 / 消息 / 机器人", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws chat message recall-by-bot --robot-code \u003crobot-code\u003e --group \u003copenconversation_id\u003e --keys \u003cprocess-query-key\u003e", "dws chat message recall-by-bot --robot-code \u003crobot-code\u003e --keys key1,key2" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "is_alias": false, "name": "recall_robot_message", "parameter_count": 3, "parameters": { "group": { "description": "群聊 openConversationId（群聊撤回时必填）", "property": "group", "required": false, "type": "string" }, "keys": { "description": "消息 processQueryKey 列表，逗号分隔 (必填)", "property": "keys", "required": true, "type": "string" }, "robot-code": { "description": "机器人 Code (必填)", "property": "robotCode", "required": true, "type": "string" } }, "path": "chat.recall_robot_message", "primary_cli_path": "chat message recall-by-bot", "product_id": "chat", "reviewed": true, "risk": "high", "source": "hardcoded:chat", "title": "机器人撤回消息（--group 群聊 / 不传为单聊）", "use_when": [ "撤回机器人发的消息/机器人撤回消息", "机器人撤回消息（--group 群聊 / 不传为单聊）", "用同一个 robot-code + processQueryKey 撤回" ] }, "chat.remove_custom_group_role": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.remove_custom_group_role", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“拉取会话的群身份”请改用 dws chat group-role list", "要“根据用户提供的群和成员为在群里查询成员的群身份”请改用 dws chat group-role query-user", "要“添加群身份”请改用 dws chat group-role add" ], "canonical_path": "chat.remove_custom_group_role", "cli_name": "remove", "cli_path": "chat group-role remove", "confirmation": "user_required", "description": "删除群身份", "display": "群聊 / 消息 / 机器人", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws chat group-role remove --group \u003copenConversationId\u003e --role-id \u003copenRoleId\u003e" ], "group": "group-role", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "remove_custom_group_role" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_custom_group_role", "parameter_count": 2, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "role-id": { "description": "群身份 openRoleId，由 group-role list 返回 (必填)", "interface_description": "openRoleId", "property": "openRoleId", "required": true, "type": "string" } }, "path": "chat.remove_custom_group_role", "primary_cli_path": "chat group-role remove", "product_id": "chat", "reviewed": false, "risk": "high", "source": "runtime:im", "title": "删除群身份", "use_when": [ "删除群身份" ] }, "chat.remove_custom_user_roles": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.remove_custom_user_roles", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "移除用户的群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“拉取会话的群身份”请改用 dws chat group-role list", "要“根据用户提供的群和成员为在群里查询成员的群身份”请改用 dws chat group-role query-user", "要“添加群身份”请改用 dws chat group-role add" ], "canonical_path": "chat.remove_custom_user_roles", "cli_name": "remove-user", "cli_path": "chat group-role remove-user", "confirmation": "user_required", "description": "移除用户的群身份", "display": "群聊 / 消息 / 机器人", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws chat group-role remove-user --group \u003copenConversationId\u003e --user \u003cuserId\u003e --role-ids roleId1,roleId2" ], "group": "group-role", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "remove_custom_user_roles" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_custom_user_roles", "parameter_count": 3, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "role-ids": { "description": "要移除的群身份 openRoleId 列表，逗号分隔 (必填)", "interface_description": "openRoleIds", "interface_type": "array", "property": "openRoleIds", "required": true, "type": "string" }, "user": { "description": "用户 userId（必填）", "interface_description": "openDingTalkId", "property": "openDingTalkId", "required": true, "type": "string" } }, "path": "chat.remove_custom_user_roles", "primary_cli_path": "chat group-role remove-user", "product_id": "chat", "reviewed": false, "risk": "high", "source": "runtime:im", "title": "移除用户的群身份", "use_when": [ "移除某人的群身份/撤销群身份" ] }, "chat.remove_emoji_reaction": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.remove_emoji_reaction", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "消息删除emoji回应", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.remove_emoji_reaction", "cli_name": "remove-emoji", "cli_path": "chat message remove-emoji", "confirmation": "not_required", "description": "消息删除emoji回应", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message remove-emoji --conversation-id \u003copenConversationId\u003e --msg-id \u003copenMsgId\u003e --emoji \"赞\"" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "remove_emoji_reaction" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_emoji_reaction", "parameter_count": 6, "parameters": { "chat": { "description": "--conversation-id 的别名", "property": "chat", "required": false, "type": "string" }, "conversation-id": { "description": "会话 openConversationId (必填，支持单聊/群聊)", "property": "conversationId", "required": true, "type": "string" }, "emoji": { "description": "emoji 表情名称 (必填)", "interface_description": "emojiName", "property": "emojiName", "required": true, "type": "string" }, "group": { "description": "--conversation-id 的别名", "interface_description": "openConversationId", "property": "openConversationId", "required": false, "type": "string" }, "id": { "description": "--conversation-id 的别名", "property": "id", "required": false, "type": "string" }, "msg-id": { "description": "消息 openMsgId (必填)", "interface_description": "openMsgId", "property": "openMsgId", "required": true, "type": "string" } }, "path": "chat.remove_emoji_reaction", "primary_cli_path": "chat message remove-emoji", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "消息删除emoji回应", "use_when": [ "取消emoji回应/移除表情回应" ] }, "chat.remove_group_member": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.remove_group_member", "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "从群中移除成员", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“向群中添加成员”请改用 dws chat group members add", "要“将机器人添加到群中”请改用 dws chat group members add-bot", "要“查看群成员列表”请改用 dws chat group members list" ], "canonical_path": "chat.remove_group_member", "cli_name": "remove", "cli_path": "chat group members remove", "confirmation": "user_required", "description": "移除群成员", "display": "群聊 / 消息 / 机器人", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws chat group members remove --id \u003copenconversation_id\u003e --users userId1,userId2" ], "group": "group.members", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "remove_group_member" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_group_member", "parameter_count": 2, "parameters": { "id": { "description": "群 ID / openconversation_id (必填)", "interface_description": "会话Id", "property": "openConversationId", "required": true, "type": "string" }, "users": { "description": "要移除的用户 userId 列表，逗号分隔 (必填)", "interface_description": "需要被移除的成员userId列表", "interface_type": "array", "property": "userIdList", "required": true, "type": "string" } }, "path": "chat.remove_group_member", "primary_cli_path": "chat group members remove", "product_id": "chat", "risk": "high", "source": "runtime:group-chat", "title": "remove_group_member", "use_when": [ "踢人/移除群成员" ] }, "chat.remove_robot_in_group": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.remove_robot_in_group", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "从群内移除机器人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“向群中添加成员”请改用 dws chat group members add", "要“将机器人添加到群中”请改用 dws chat group members add-bot", "要“查看群成员列表”请改用 dws chat group members list" ], "canonical_path": "chat.remove_robot_in_group", "cli_name": "remove-bot", "cli_path": "chat group members remove-bot", "confirmation": "user_required", "description": "从群内移除机器人", "display": "群聊 / 消息 / 机器人", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws chat group members remove-bot --id \u003copenConversationId\u003e --bot-id \u003copenBotId\u003e" ], "group": "group.members", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "bot", "rpc_name": "remove_robot_in_group" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_robot_in_group", "parameter_count": 2, "parameters": { "bot-id": { "description": "机器人 openBotId (必填)", "property": "botId", "required": true, "type": "string" }, "id": { "description": "群聊 openConversationId (必填)", "property": "id", "required": true, "type": "string" } }, "path": "chat.remove_robot_in_group", "primary_cli_path": "chat group members remove-bot", "product_id": "chat", "reviewed": false, "risk": "high", "source": "hardcoded:chat", "title": "remove_robot_in_group", "use_when": [ "从群里移除机器人/踢出机器人", "从群里移除机器人/踢机器人；移除群内机器人" ] }, "chat.remove_text_emotion": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.remove_text_emotion", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除文字表情", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.remove_text_emotion", "cli_name": "remove-text-emotion", "cli_path": "chat message remove-text-emotion", "confirmation": "not_required", "description": "删除文字表情", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message remove-text-emotion --conversation-id \u003copenConversationId\u003e --msg-id \u003copenMsgId\u003e --emotion-id \u003cemotionId\u003e --emotion-name \"赞\" --text \"nice\" --background-id \u003cbackgroundId\u003e" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "remove_text_emotion" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_text_emotion", "parameter_count": 9, "parameters": { "background-id": { "description": "背景 ID (必填)", "interface_description": "backgroundId", "property": "backgroundId", "required": true, "type": "string" }, "chat": { "description": "--conversation-id 的别名", "property": "chat", "required": false, "type": "string" }, "conversation-id": { "description": "会话 openConversationId (必填，支持单聊/群聊)", "property": "conversationId", "required": true, "type": "string" }, "emotion-id": { "description": "表情 ID (必填)", "interface_description": "emotionId", "property": "emotionId", "required": true, "type": "string" }, "emotion-name": { "description": "表情名称 (必填)", "interface_description": "emotionName", "property": "emotionName", "required": true, "type": "string" }, "group": { "description": "--conversation-id 的别名", "interface_description": "openConversationId", "property": "openConversationId", "required": false, "type": "string" }, "id": { "description": "--conversation-id 的别名", "property": "id", "required": false, "type": "string" }, "msg-id": { "description": "消息 openMsgId (必填)", "interface_description": "openMsgId", "property": "openMsgId", "required": true, "type": "string" }, "text": { "description": "文字内容 (必填)", "interface_description": "text", "property": "text", "required": true, "type": "string" } }, "path": "chat.remove_text_emotion", "primary_cli_path": "chat message remove-text-emotion", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "删除文字表情", "use_when": [ "取消文字表情回应/移除文字表情" ] }, "chat.reply_personal_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "以当前用户身份引用一条已有消息并回复", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.reply_personal_message", "cli_name": "reply", "cli_path": "chat message reply", "confirmation": "not_required", "description": "以用户身份发消息，支持多种消息类型", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message reply --conversation-id \u003copenConversationId\u003e --ref-msg-id \u003copenMessageId\u003e --ref-sender \u003copenDingTalkId\u003e --text \"收到，马上处理\"" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "send_personal_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "reply_personal_message", "parameter_count": 6, "parameters": { "ai-tag": { "default": "true", "description": "消息是否带 AI 发送角标（默认 true）", "property": "aiTag", "required": false, "type": "boolean" }, "conversation-id": { "description": "会话 openConversationId (必填，支持单聊/群聊)", "property": "conversationId", "required": true, "type": "string" }, "ref-msg-id": { "description": "被引用的消息 openMessageId (必填)", "property": "refMsgId", "required": true, "type": "string" }, "ref-sender": { "description": "被引用消息的发送者 openDingTalkId (必填)", "property": "refSender", "required": true, "type": "string" }, "text": { "description": "回复内容 (必填)", "property": "text", "required": true, "type": "string" }, "uuid": { "description": "幂等键（可选）", "interface_description": "uuid", "property": "uuid", "required": false, "type": "string" } }, "path": "chat.reply_personal_message", "prerequisites": [ "已取得会话 ID、原消息 ID 和原消息发送者 openDingTalkId" ], "primary_cli_path": "chat message reply", "product_id": "chat", "reviewed": true, "risk": "medium", "source": "hardcoded:chat", "tips": [ "发送前确认引用消息、接收会话和回复内容" ], "title": "send_personal_message", "use_when": [ "引用回复/回复消息/引用消息回复", "引用消息回复/回复那条消息；引用回复消息", "需要保留被回复消息的引用关系" ] }, "chat.search_at_me_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.search_at_me_message", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "拉取 @我 的消息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.search_at_me_message", "cli_name": "list-mentions", "cli_path": "chat message list-mentions", "confirmation": "not_required", "description": "搜索at自己的消息", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message list-mentions --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-11T00:00:00+08:00\" --limit 50 --cursor 0", "dws chat message list-mentions --start \"2026-04-01T00:00:00+08:00\" --end \"2026-04-14T00:00:00+08:00\" --limit 20 --cursor 0" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "search_at_me_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_at_me_message", "parameter_count": 5, "parameters": { "cursor": { "default": "0", "description": "分页游标（默认 \"0\"，翻页传 nextCursor）", "interface_description": "cursor", "property": "cursor", "required": false, "type": "string" }, "end": { "description": "结束时间，ISO-8601 格式 (必填)", "format": "date-time", "interface_description": "endTime", "property": "endTime", "required": true, "type": "string" }, "group": { "description": "群聊 openconversation_id（可选，不传则查全部）", "interface_description": "openConversationId", "property": "openConversationId", "required": false, "type": "string" }, "limit": { "default": "50", "description": "每页返回数量（默认 50）", "interface_description": "limit", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "start": { "description": "开始时间，ISO-8601 格式 (必填)", "format": "date-time", "interface_description": "startTime", "property": "startTime", "required": true, "type": "string" } }, "path": "chat.search_at_me_message", "primary_cli_path": "chat message list-mentions", "product_id": "chat", "risk": "low", "source": "runtime:group-chat", "title": "search_at_me_message", "use_when": [ "@我的消息/at我的/提及我的", "@我的消息/提及我的", "谁@了我/查看提及我的消息；查询@我的消息" ] }, "chat.search_bots": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.search_bots", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "搜索机器人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“搜索我创建的机器人”请改用 dws chat bot search" ], "canonical_path": "chat.search_bots", "cli_name": "find", "cli_path": "chat bot find", "confirmation": "not_required", "description": "搜索机器人", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat bot find --query \"日报\"", "dws chat bot find --query \"日报\" --limit 20" ], "group": "bot", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "bot", "rpc_name": "search_bots" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_bots", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标（首次调用不传，翻页时传上次返回的 nextCursor）", "interface_description": "cursor", "property": "cursor", "required": false, "type": "string" }, "limit": { "default": "20", "description": "每页返回数量（默认 20）", "interface_description": "limit", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "query": { "description": "搜索关键词 (必填)", "property": "query", "required": true, "type": "string" } }, "path": "chat.search_bots", "primary_cli_path": "chat bot find", "product_id": "chat", "reviewed": false, "risk": "low", "source": "hardcoded:chat", "title": "search_bots", "use_when": [ "搜索机器人 — 提取 openDingTalkId（必须用 find，search 没有此字段）", "搜索机器人/找机器人/查机器人/帮我找XXX机器人", "搜索机器人/找机器人/查机器人/帮我找XXX机器人；搜索全部可用机器人", "给机器人发单聊/给机器人发消息/跟机器人聊天", "给机器人发单聊/给机器人发消息/跟机器人聊天；给机器人发单聊消息" ] }, "chat.search_common_groups": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.search_common_groups", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "搜索共同群（指定昵称列表，查询共同所在的群聊）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“搜索共同群（指定昵称列表，查询共同所在的群聊）”" ], "canonical_path": "chat.search_common_groups", "cli_name": "search-common", "cli_path": "chat search-common", "confirmation": "not_required", "description": "通过人员名称搜索共同群聊", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat search-common --nicks \"风雷,山乔\" --limit 20 --cursor 0", "dws chat search-common --nicks \"天鸡,乐函\" --match-mode OR --limit 20 --cursor 0" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "search_common_groups" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_common_groups", "parameter_count": 5, "parameters": { "cursor": { "default": "0", "description": "分页游标（默认 \"0\"，翻页传 nextCursor）", "interface_description": "翻页偏移量，首次查询不传或传\"0\"，后续传上一次返回的 nextCursor", "property": "cursor", "required": false, "type": "string" }, "exclude-muted": { "description": "是否排除已设置免打扰的群聊（默认 false）", "interface_description": "excludeMuted", "property": "excludeMuted", "required": false, "type": "boolean" }, "limit": { "default": "20", "description": "每页返回数量（默认 20）", "interface_description": "每页数量，默认20", "interface_type": "string", "property": "limit", "required": false, "type": "integer" }, "match-mode": { "default": "AND", "description": "匹配模式：AND=所有人都在群里，OR=任一人在群里（默认 AND）", "interface_description": "AND-所有nick对应的人都在群里。OR-任一nick对应的人在群里", "property": "matchMode", "required": false, "type": "string" }, "nicks": { "description": "要搜索的昵称列表，逗号分隔 (必填)", "interface_description": "字段名", "interface_type": "array", "property": "nicks", "required": true, "type": "string" } }, "path": "chat.search_common_groups", "primary_cli_path": "chat search-common", "product_id": "chat", "risk": "low", "source": "runtime:group-chat", "title": "search_common_groups", "use_when": [ "我和XX的共同群/我们都在哪些群/查共同群", "我和某人的共同群", "我和风雷的共同群/我们都在哪些群；搜索共同群" ] }, "chat.search_groups": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.search_groups_by_keyword", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "根据名称搜索会话列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "我创建的群/我管理的群/我是群主的群/我当管理员的群；拉取我创建/管理的群", "我和风雷的共同群/我们都在哪些群；搜索共同群", "搜一下消息里的changefree链接；消息搜索", "根据群号查群信息/群号转openConversationId；群号查群聊信息" ], "canonical_path": "chat.search_groups", "cli_name": "search", "cli_path": "chat search", "confirmation": "not_required", "description": "根据群名称关键词，搜索符合条件的群，返回群的openconversion_id、群名称等信息", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat search --query \"项目冲刺\"", "dws chat search --query \"项目冲刺\" --limit 20 --cursor 0" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "search_groups_by_keyword" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_groups", "parameter_count": 4, "parameters": { "cursor": { "default": "0", "description": "分页游标（默认 \"0\"，翻页传 nextCursor）", "property": "cursor", "required": false, "type": "string" }, "exclude-muted": { "description": "是否排除已设置免打扰的群聊（默认 false）", "property": "excludeMuted", "required": false, "type": "boolean" }, "limit": { "default": "20", "description": "每页返回数量（默认 20）", "property": "limit", "required": false, "type": "integer" }, "query": { "description": "搜索关键词 (必填)", "property": "keyword", "required": true, "type": "string" } }, "path": "chat.search_groups", "primary_cli_path": "chat search", "product_id": "chat", "risk": "low", "source": "runtime:im", "title": "search_groups_by_keyword", "use_when": [ "1. 搜索群 — 提取 openconversation_id", "搜索群/找群" ] }, "chat.search_messages": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.search_messages", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "搜索消息，支持多种维度：时间范围、关键词、发送者、at我的、at指定用户、会话", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.search_messages", "cli_name": "search-advanced", "cli_path": "chat message search-advanced", "confirmation": "not_required", "description": "搜索消息，支持多种维度：时间范围、关键词、发送者、at我的、at指定用户、会话", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message search-advanced --query \"周报\" --start \"2026-04-01T00:00:00+08:00\" --end \"2026-04-15T00:00:00+08:00\"", "dws chat message search-advanced --user \u003cuserId\u003e --start \"2026-04-01T00:00:00+08:00\" --end \"2026-04-15T00:00:00+08:00\"" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "search_messages" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_messages", "parameter_count": 11, "parameters": { "at-ids": { "description": "@指定人的 openDingTalkId 列表，逗号分隔（可选）", "interface_description": "atOpenDingTakIds", "interface_type": "array", "property": "atOpenDingTakIds", "required": false, "type": "string" }, "at-me": { "description": "只搜索 @我 的消息（可选，默认 false）", "interface_description": "atMe", "property": "atMe", "required": false, "type": "boolean" }, "conversation-ids": { "description": "会话 openConversationId 列表，逗号分隔（可选，群聊或单聊均可，不传则搜索所有会话）", "interface_description": "openConversationIds", "interface_type": "array", "property": "openConversationIds", "required": false, "type": "string" }, "cursor": { "default": "0", "description": "分页游标（默认 \"0\"）", "interface_description": "cursor", "property": "cursor", "required": false, "type": "string" }, "end": { "description": "结束时间，ISO-8601 格式（可选）", "format": "date-time", "interface_description": "endTime", "interface_type": "number", "property": "endTime", "required": false, "type": "string" }, "limit": { "default": "100", "description": "每页返回数量（默认 100）", "interface_description": "limit", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "query": { "description": "搜索关键词（可选）", "interface_description": "keyword", "property": "keyword", "required": false, "type": "string" }, "sender-ids": { "description": "发送者 openDingTalkId 列表，逗号分隔（可选）", "interface_description": "senderOpenDingTakIds", "interface_type": "array", "property": "senderOpenDingTakIds", "required": false, "type": "string" }, "start": { "description": "开始时间，ISO-8601 格式（可选）", "format": "date-time", "interface_description": "startTime", "interface_type": "number", "property": "startTime", "required": false, "type": "string" }, "user": { "description": "发送者 userId，支持逗号分隔（可选）", "property": "user", "required": false, "type": "string" }, "users": { "description": "发送者 userId 列表，逗号分隔（可选）", "property": "users", "required": false, "type": "string" } }, "path": "chat.search_messages", "primary_cli_path": "chat message search-advanced", "product_id": "chat", "reviewed": false, "risk": "low", "source": "runtime:im", "title": "搜索消息", "use_when": [ "多维度搜索/按发送者搜索/按人搜消息/指定多个群搜索/@我的消息搜索", "按发送者搜索/指定多个群搜索/多维度搜消息；多维度搜索消息", "搜一下消息里的changefree链接；消息搜索", "搜索消息/查找关键词/搜一下消息里的XX", "搜索消息里的关键词/包含XX的消息" ] }, "chat.search_messages_by_keyword": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.search_messages_by_keyword", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "按关键词搜索消息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.search_messages_by_keyword", "cli_name": "search", "cli_path": "chat message search", "confirmation": "not_required", "description": "按关键词搜索消息", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message search --query \"changefree\" --start \"2026-04-01T00:00:00+08:00\" --end \"2026-04-15T00:00:00+08:00\" --limit 50 --cursor 0", "dws chat message search --query \"codereview\" --group \u003copenconversation_id\u003e --start \"2026-04-01T00:00:00+08:00\" --end \"2026-04-15T00:00:00+08:00\" --limit 100 --cursor 0" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "search_messages_by_keyword" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_messages_by_keyword", "parameter_count": 6, "parameters": { "cursor": { "default": "0", "description": "分页游标（默认 \"0\"，翻页传 nextCursor）", "interface_description": "cursor", "property": "cursor", "required": false, "type": "string" }, "end": { "description": "结束时间，ISO-8601 格式 (必填)", "format": "date-time", "interface_description": "endTime", "interface_type": "number", "property": "endTime", "required": true, "type": "string" }, "group": { "description": "群聊 openconversation_id（可选，不传则搜索所有会话）", "interface_description": "openConversationId", "property": "openConversationId", "required": false, "type": "string" }, "limit": { "default": "100", "description": "每页返回数量（默认 100）", "interface_description": "limit", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "query": { "description": "搜索关键词 (必填)", "interface_description": "keyword", "property": "keyword", "required": true, "type": "string" }, "start": { "description": "开始时间，ISO-8601 格式 (必填)", "format": "date-time", "interface_description": "startTime", "interface_type": "number", "property": "startTime", "required": true, "type": "string" } }, "path": "chat.search_messages_by_keyword", "primary_cli_path": "chat message search", "product_id": "chat", "risk": "low", "source": "runtime:group-chat", "title": "search_messages_by_keyword", "use_when": [ "按关键词搜索消息" ] }, "chat.search_messages_by_sender": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.search_messages_by_sender", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "拉取指定发送者的消息（含单聊 / 群聊；两者互斥）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.search_messages_by_sender", "cli_name": "list-by-sender", "cli_path": "chat message list-by-sender", "confirmation": "not_required", "constraints": { "mutually_exclusive": [ [ "sender-user-id", "sender-open-dingtalk-id" ] ], "require_one_of": [ [ "sender-user-id", "sender-open-dingtalk-id" ] ] }, "description": "根据发送者拉消息", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message list-by-sender --sender-user-id \u003cuserId\u003e --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-11T00:00:00+08:00\" --limit 50 --cursor 0", "dws chat message list-by-sender --sender-open-dingtalk-id \u003copenDingTalkId\u003e --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-11T00:00:00+08:00\" --limit 50 --cursor 0" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "search_messages_by_sender" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_messages_by_sender", "parameter_count": 6, "parameters": { "cursor": { "default": "0", "description": "分页游标（默认 \"0\"，翻页传 nextCursor）", "interface_description": "cursor", "property": "cursor", "required": false, "type": "string" }, "end": { "description": "结束时间，ISO-8601 格式 (必填)", "format": "date-time", "interface_description": "endTime", "interface_type": "number", "property": "endTime", "required": true, "type": "string" }, "limit": { "default": "50", "description": "每页返回数量（默认 50）", "interface_description": "limit", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "sender-open-dingtalk-id": { "description": "发送者 openDingTalkId（与 --sender-user-id 二选一，适用于无法获取 userId 的场景）", "interface_description": "发送者的openDingTalkId", "property": "senderOpenDingTalkId", "required": false, "type": "string" }, "sender-user-id": { "description": "发送者 userId（与 --sender-open-dingtalk-id 二选一）", "interface_description": "发送者的userId", "property": "senderUserId", "required": false, "type": "string" }, "start": { "description": "开始时间，ISO-8601 格式 (必填)", "format": "date-time", "interface_description": "startTime", "interface_type": "number", "property": "startTime", "required": true, "type": "string" } }, "path": "chat.search_messages_by_sender", "primary_cli_path": "chat message list-by-sender", "product_id": "chat", "risk": "low", "source": "runtime:group-chat", "title": "search_messages_by_sender", "use_when": [ "某人发给我的消息/指定发送者/某人的消息", "某人发给我的消息/指定发送者的消息/某人最近的消息", "看看张三发给我的消息；按发送者查询消息" ] }, "chat.search_messages_by_time_range": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.search_messages_by_time_range", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "拉取指定时间范围内当前用户的所有会话消息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.search_messages_by_time_range", "cli_name": "list-all", "cli_path": "chat message list-all", "confirmation": "not_required", "description": "根据指定时间范围，分页搜索历史消息", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message list-all --start \"2025-03-01 00:00:00\" --end \"2025-03-31 23:59:59\" --limit 50", "dws chat message list-all --start \"2025-03-01 00:00:00\" --end \"2025-03-31 23:59:59\" --limit 50 --cursor \"abc123token\"" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "search_messages_by_time_range" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_messages_by_time_range", "parameter_count": 4, "parameters": { "cursor": { "default": "0", "description": "分页游标（首页传 \"0\"，后续从响应中获取）", "interface_description": "cursor", "property": "cursor", "required": false, "type": "string" }, "end": { "description": "结束时间，格式: yyyy-MM-dd HH:mm:ss (必填)", "interface_description": "结束时间，格式：yyyy-MM-dd HH:mm:ss，非必填", "property": "endTime", "required": true, "type": "string" }, "limit": { "default": "50", "description": "每页返回数量（默认 50）", "interface_description": "limit", "interface_type": "number", "property": "limit", "required": false, "type": "integer" }, "start": { "description": "起始时间，格式: yyyy-MM-dd HH:mm:ss (必填)", "interface_description": "开始时间，格式：yyyy-MM-dd HH:mm:ss，必填", "property": "startTime", "required": true, "type": "string" } }, "path": "chat.search_messages_by_time_range", "primary_cli_path": "chat message list-all", "product_id": "chat", "risk": "low", "source": "runtime:group-chat", "title": "search_messages_by_time_range", "use_when": [ "我最近所有消息/我今天的消息", "所有消息/全部会话消息/拉取全部消息/时间范围内消息/我的消息/我今天的消息/查我的钉钉消息/最近的消息", "查看我今天的所有消息；全量会话消息" ] }, "chat.search_my_robots": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.search_my_robots", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "搜索我创建的机器人", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“搜索机器人”请改用 dws chat bot find" ], "canonical_path": "chat.search_my_robots", "cli_name": "search", "cli_path": "chat bot search", "confirmation": "not_required", "description": "搜索我创建的机器人，可获取机器人robotCode等信息。", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat bot search --page 1", "dws chat bot search --page 1 --size 10 --name \"日报\"" ], "group": "bot", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "bot", "rpc_name": "search_my_robots" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_my_robots", "parameter_count": 3, "parameters": { "name": { "description": "按名称搜索", "property": "name", "required": false, "type": "string" }, "page": { "default": "1", "description": "页码，从1开始", "property": "page", "required": false, "type": "integer" }, "size": { "description": "每页条数 (默认50)", "property": "size", "required": false, "type": "integer" } }, "path": "chat.search_my_robots", "primary_cli_path": "chat bot search", "product_id": "chat", "risk": "low", "source": "hardcoded:chat", "title": "搜索我创建的企业机器人", "use_when": [ "我创建的机器人/我的机器人/我自己的机器人/查看我的机器人", "我创建的机器人/我的机器人/我自己的机器人/查看我的机器人；搜索我创建的机器人", "查我的机器人 — 提取 robot-code", "查看我的机器人" ] }, "chat.send_message_by_custom_robot": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.send_message_by_custom_robot", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "自定义机器人 Webhook 发送群消息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.send_message_by_custom_robot", "cli_name": "send-by-webhook", "cli_path": "chat message send-by-webhook", "confirmation": "not_required", "description": "使用自定义机器人发送群消息，请注意自定义机器人与企业机器人的区别。", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message send-by-webhook --token \u003cwebhook-token\u003e --title \"告警\" --text \"CPU 超 90% @10\" --at-all", "dws chat message send-by-webhook --token \u003cwebhook-token\u003e --title \"test\" --text \"hi @118785\" --at-users 118785" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "bot", "rpc_name": "send_message_by_custom_robot" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "send_message_by_custom_robot", "parameter_count": 6, "parameters": { "at-all": { "description": "@ 所有人", "property": "atAll", "required": false, "type": "boolean" }, "at-mobiles": { "description": "@ 指定手机号，逗号分隔", "interface_description": "被@的群成员手机号", "interface_type": "array", "property": "atMobiles", "required": false, "type": "string" }, "at-users": { "description": "@ 指定用户，逗号分隔", "property": "atUsers", "required": false, "type": "string" }, "text": { "description": "消息内容 (必填)", "interface_description": "消息内容,Markdown格式", "property": "text", "required": true, "type": "string" }, "title": { "description": "消息标题 (必填)", "interface_description": "消息标题", "property": "title", "required": true, "type": "string" }, "token": { "description": "Webhook Token (必填)", "property": "token", "required": true, "type": "string" } }, "path": "chat.send_message_by_custom_robot", "primary_cli_path": "chat message send-by-webhook", "product_id": "chat", "risk": "medium", "source": "hardcoded:chat", "title": "自定义机器人发送群消息", "use_when": [ "7. Webhook 发告警", "CPU 超过 90% 自动告警；Webhook 告警", "Webhook 发消息/告警消息" ] }, "chat.send_personal_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "以当前用户身份向群聊或单聊发送文本、Markdown、图片或本地文件", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.send_personal_message", "cli_name": "send", "cli_path": "chat message send", "confirmation": "not_required", "constraints": { "mutually_exclusive": [ [ "group", "user", "open-dingtalk-id" ] ], "require_one_of": [ [ "group", "user", "open-dingtalk-id" ], [ "text", "content", "msg-type" ] ] }, "description": "以用户身份发消息，支持多种消息类型", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message send --group \u003copenconversation_id\u003e --text \"hello\"", "dws chat message send --user \u003cuserId\u003e --text \"请查收\"" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "send_personal_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "send_personal_message", "parameter_count": 12, "parameters": { "ai-tag": { "default": "true", "description": "消息是否带 AI 发送角标（默认 true）", "property": "aiTag", "required": false, "type": "boolean" }, "at-all": { "description": "@所有人（仅群聊时生效，可选）,设置时，消息内容中一定要包含对应的占位符\u003c@all\u003e", "interface_description": "是否@所有人", "property": "atAll", "required": false, "type": "boolean" }, "at-open-dingtalk-ids": { "description": "@指定成员的 openDingTalkId 列表，逗号分隔（仅群聊时生效，可选）,设置--at-open-dingtalk-ids openDingTalkId1,openDingTalkId2时，消息内容中一定要包含对应格式的占位符\u003c@openDingTalkId1\u003e \u003c@openDingTalkId2\u003e", "property": "atOpenDingtalkIds", "required": false, "type": "string" }, "file-path": { "description": "本地文件路径（msgType=file 时可直接上传发送）", "format": "file-path", "property": "filePath", "required": false, "required_when": "msg-type is file or audio or video", "type": "string" }, "group": { "description": "群聊 openconversation_id（群聊时必填）", "property": "group", "required": false, "type": "string" }, "media-id": { "description": "图片 mediaId（通过 dt_media_upload 上传后用 extract_media_id.py 提取，仅 msgType=image）", "example": "@lADP_schema_smoke", "property": "mediaId", "required": false, "required_when": "msg-type is image", "type": "string" }, "msg-type": { "description": "富媒体消息类型: image/file/audio/video（audio/video 是 file 别名；纯文本/Markdown 无需指定，直接传内容即可）", "enum": [ "image", "file", "audio", "video" ], "interface_description": "消息类型", "property": "msgType", "required": false, "type": "string" }, "open-dingtalk-id": { "description": "单聊接收人 openDingTalkId（单聊时与 --user 二选一）", "property": "openDingtalkId", "required": false, "type": "string" }, "text": { "description": "消息内容（推荐方式，也可用位置参数传递。内容含换行/特殊字符时必须使用此 flag）", "property": "text", "required": false, "type": "string" }, "title": { "description": "消息标题，显示在消息列表（可选，未指定时使用消息内容）", "property": "title", "required": false, "type": "string" }, "user": { "description": "单聊接收人 userId（单聊时与 --open-dingtalk-id 二选一）", "property": "user", "required": false, "type": "string" }, "uuid": { "description": "幂等 UUID，相同 uuid 在 24h 内不会重复发送（可选）", "interface_description": "uuid", "property": "uuid", "required": false, "type": "string" } }, "path": "chat.send_personal_message", "positionals": [ { "description": "消息内容（也可使用 --text；富媒体消息可省略）", "index": 0, "name": "content", "required": false, "type": "string" } ], "primary_cli_path": "chat message send", "product_id": "chat", "reviewed": true, "risk": "medium", "source": "hardcoded:chat", "tips": [ "发送前确认目标和内容；文件消息使用 --msg-type file --file-path", "需要 24 小时内防重复投递时提供稳定的 --uuid" ], "title": "send_personal_message", "use_when": [ "3. 以个人身份发送群消息", "4. 以个人身份单聊（通过 userId）", "4b. 以个人身份单聊（通过 openDingTalkId，三方应用等无法获取 userId 时使用）", "使用当前用户身份发送图片或本地文件", "再 dws drive info --file-id \u003cfileId\u003e --space-id \u003cspaceId\u003e 获取 dentryId", "单聊（推荐 --open-dingtalk-id）", "发单聊消息(以个人身份)", "发群消息(以个人身份)", "发送图片", "发送普通群消息或单聊消息", "幂等发送（24h 内相同 uuid 不重复投递）", "用 Markdown 语法发送", "用 Markdown 语法发送（mediaId 作为图片引用）", "用 openDingTalkId 发单聊消息", "给机器人发单聊/给机器人发消息/跟机器人聊天；给机器人发单聊消息", "群聊", "通知群里的人都来开会；个人身份群发" ] }, "chat.send_robot_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "机器人发送消息（--group 群聊 / --users 单聊）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.send_robot_message", "cli_name": "send-by-bot", "cli_path": "chat message send-by-bot", "confirmation": "not_required", "constraints": { "mutually_exclusive": [ [ "group", "users" ] ], "require_one_of": [ [ "group", "users" ] ] }, "description": "群聊：传 --group 指定群；单聊：传 --users 或 --open-dingtalk-ids 指定用户列表，与 --group 只能选其一，不能同时指定。--text 支持 Markdown。\n\n⚠️ 重要：该接口会真实发送消息到目标会话，不可用于测试或试探性调用。调用前必须确认消息内容和接收对象无误。", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message send-by-bot --robot-code \u003crobot-code\u003e --group \u003copenconversation_id\u003e --title \"日报\" --text \"## 今日完成...\"", "dws chat message send-by-bot --robot-code \u003crobot-code\u003e --users userId1,userId2 --title \"提醒\" --text \"请提交周报\"" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "is_alias": false, "name": "send_robot_message", "parameter_count": 9, "parameters": { "at-all": { "description": "@所有人（可选），服务端接收字符串 true/false", "property": "atAll", "required": false, "type": "boolean" }, "at-open-dingtalk-ids": { "description": "@指定成员的 openDingtalkId 列表，逗号分隔（仅群聊时生效，可选）", "property": "atOpenDingtalkIds", "required": false, "type": "string" }, "at-user-ids": { "description": "@指定成员的 userId 列表，逗号分隔（仅群聊时生效，可选），--text 中需包含 @userId 对应文本", "property": "atUserIds", "required": false, "type": "string" }, "group": { "description": "群聊 openConversationId（群聊时必填）", "property": "group", "required": false, "type": "string" }, "open-dingtalk-ids": { "description": "用户 openDingtalkId 列表，逗号分隔（单聊时可替代 --users，可选）", "property": "openDingtalkIds", "required": false, "type": "string" }, "robot-code": { "description": "机器人 Code (必填)", "property": "robotCode", "required": true, "type": "string" }, "text": { "description": "消息内容 Markdown (必填)", "property": "text", "required": true, "type": "string" }, "title": { "description": "消息标题 (必填)", "property": "title", "required": true, "type": "string" }, "users": { "description": "用户 userId 列表，逗号分隔，最多20个（单聊时必填）", "property": "users", "required": false, "type": "string" } }, "path": "chat.send_robot_message", "primary_cli_path": "chat message send-by-bot", "product_id": "chat", "reviewed": true, "risk": "medium", "source": "hardcoded:chat", "title": "机器人发送消息（--group 群聊 / --users 单聊）", "use_when": [ "5. 机器人发群消息（Markdown）", "6. 机器人单聊发消息", "@所有人", "尝试发送，若报\"机器人不存在\"则执行 Step 3", "或者用 openDingtalkId 发送并 @", "机器人发消息/机器人群发", "机器人发送消息（--group 群聊 / --users 单聊）", "用 userId 发送并 @（注意 text 中 @userId）", "用机器人发消息 — 提取返回中的 processQueryKey", "给张三发一条机器人单聊消息；机器人单聊", "让机器人每天推送日报；机器人定时推送", "重新发送" ] }, "chat.set_custom_user_roles": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.set_custom_user_roles", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "根据用户提供的群和身份为用户设置群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“拉取会话的群身份”请改用 dws chat group-role list", "要“根据用户提供的群和成员为在群里查询成员的群身份”请改用 dws chat group-role query-user", "要“添加群身份”请改用 dws chat group-role add" ], "canonical_path": "chat.set_custom_user_roles", "cli_name": "set-user", "cli_path": "chat group-role set-user", "confirmation": "not_required", "description": "根据用户提供的群和身份为用户设置群身份", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group-role set-user --group \u003copenConversationId\u003e --user \u003cuserId\u003e --role-ids roleId1,roleId2" ], "group": "group-role", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "set_custom_user_roles" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "set_custom_user_roles", "parameter_count": 3, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "role-ids": { "description": "群身份 openRoleId 列表，逗号分隔 (必填)，传空字符串则清除该用户所有群身份", "interface_description": "openRoleIds", "interface_type": "array", "property": "openRoleIds", "required": true, "type": "string" }, "user": { "description": "用户 userId（必填）", "interface_description": "openDingTalkId", "property": "openDingTalkId", "required": true, "type": "string" } }, "path": "chat.set_custom_user_roles", "primary_cli_path": "chat group-role set-user", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "set_custom_user_roles", "use_when": [ "给某人设置群身份/设定用户的群身份" ] }, "chat.set_group_member_mute_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.set_group_member_mute_list", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "管理群禁言成员", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "全员禁言/群禁言；全员禁言或解除" ], "canonical_path": "chat.set_group_member_mute_list", "cli_name": "group-mute-member", "cli_path": "chat group-mute-member", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "users", "user" ] ] }, "description": "管理群禁言成员", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group-mute-member --group \u003cgroup\u003e --users \u003cusers\u003e" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "set_group_member_mute_list" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "set_group_member_mute_list", "parameter_count": 5, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "mute-time": { "description": "禁言时长（毫秒），支持 300000/3600000/86400000/604800000/2592000000", "enum": [ "300000", "3600000", "86400000", "604800000", "2592000000" ], "interface_description": "muteTime", "interface_type": "number", "property": "muteTime", "required": false, "required_when": "off is false", "type": "integer" }, "off": { "description": "移出禁言名单（不传则加入禁言名单）", "interface_description": "mute", "property": "mute", "required": false, "type": "boolean" }, "user": { "description": "群成员 userId，支持逗号分隔", "property": "user", "required": false, "type": "string" }, "users": { "description": "群成员 userId 列表，逗号分隔（批量）", "interface_description": "openDingTalkIds", "interface_type": "array", "property": "openDingTalkIds", "required": false, "type": "string" } }, "path": "chat.set_group_member_mute_list", "primary_cli_path": "chat group-mute-member", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "管理群禁言成员", "use_when": [ "禁言某人/指定成员禁言/解除某人禁言", "禁言某人/指定成员禁言；指定成员禁言" ] }, "chat.set_group_mute": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.set_group_mute", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "设置/取消群全员禁言", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "禁言某人/指定成员禁言；指定成员禁言" ], "canonical_path": "chat.set_group_mute", "cli_name": "group-mute", "cli_path": "chat group-mute", "confirmation": "not_required", "description": "设置/取消群全员禁言", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group-mute --group \u003cgroup\u003e" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "set_group_mute" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "set_group_mute", "parameter_count": 2, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "off": { "description": "取消全员禁言（不传则开启禁言）", "interface_description": "mute", "property": "mute", "required": false, "type": "boolean" } }, "path": "chat.set_group_mute", "primary_cli_path": "chat group-mute", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "设置/取消群全员禁言", "use_when": [ "全员禁言/群禁言/解除禁言", "全员禁言/群禁言；全员禁言或解除" ] }, "chat.set_pin_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.set_pin_message", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "设置钉住(pin)某条消息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.set_pin_message", "cli_name": "set-pin-msg", "cli_path": "chat message set-pin-msg", "confirmation": "not_required", "description": "设置钉住(pin)某条消息", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message set-pin-msg --open-conversation-id \u003copenConversationId\u003e --msg-id \u003copenMessageId\u003e" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "set_pin_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "set_pin_message", "parameter_count": 2, "parameters": { "msg-id": { "description": "消息 openMessageId (必填)", "interface_description": "开放消息id", "property": "openMessageId", "required": true, "type": "string" }, "open-conversation-id": { "description": "会话 openConversationId (必填，支持群聊/单聊)", "interface_description": "开放会话id", "property": "openConversationId", "required": true, "type": "string" } }, "path": "chat.set_pin_message", "primary_cli_path": "chat message set-pin-msg", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "设置钉住(pin)消息", "use_when": [ "钉住消息/Pin消息/置顶消息到会话；钉住消息" ] }, "chat.set_top_conversation": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.set_top_conversation", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "会话置顶/取消置顶", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "置顶某条消息/把这条消息置顶；置顶消息", "钉住消息/Pin消息/置顶消息到会话；钉住消息" ], "canonical_path": "chat.set_top_conversation", "cli_name": "set-top", "cli_path": "chat set-top", "confirmation": "not_required", "description": "会话置顶/取消置顶", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat set-top --conversation-id \u003cconversation-id\u003e" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "set_top_conversation" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "set_top_conversation", "parameter_count": 2, "parameters": { "conversation-id": { "description": "会话 openConversationId (必填，支持单聊/群聊)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "off": { "description": "取消置顶（不传则设置置顶）", "interface_description": "top", "property": "top", "required": false, "type": "boolean" } }, "path": "chat.set_top_conversation", "primary_cli_path": "chat set-top", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "会话置顶/取消置顶", "use_when": [ "置顶会话/取消置顶/会话置顶", "置顶会话/取消置顶；设置/取消会话置顶" ] }, "chat.transfer_group_owner": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.transfer_group_owner", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "群主转让", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.transfer_group_owner", "cli_name": "transfer-owner", "cli_path": "chat group transfer-owner", "confirmation": "not_required", "constraints": { "mutually_exclusive": [ [ "new-owner", "user" ] ], "require_one_of": [ [ "new-owner", "user" ] ] }, "description": "群主转让", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group transfer-owner --group \u003copenConversationId\u003e --new-owner \u003copenDingTalkId\u003e", "dws chat group transfer-owner --group \u003copenConversationId\u003e --user \u003cuserId\u003e" ], "group": "group", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "transfer_group_owner" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "transfer_group_owner", "parameter_count": 3, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "new-owner": { "description": "新群主 openDingTalkId", "interface_description": "newOwnerOpenDingTalkId", "property": "newOwnerOpenDingTalkId", "required": false, "type": "string" }, "user": { "description": "新群主 userId", "property": "user", "required": false, "type": "string" } }, "path": "chat.transfer_group_owner", "primary_cli_path": "chat group transfer-owner", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "群主转让", "use_when": [ "转让群主/换群主/群主转让" ] }, "chat.unread_message_conversation_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.unread_message_conversation_list", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取未读会话列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.unread_message_conversation_list", "cli_name": "list-unread-conversations", "cli_path": "chat message list-unread-conversations", "confirmation": "not_required", "description": "unread_message_conversation_list", "display": "群聊 / 消息 / 机器人", "effect": "read", "effect_source": "command-verb", "examples": [ "dws chat message list-unread-conversations", "dws chat message list-unread-conversations --count 20" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "unread_message_conversation_list" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "unread_message_conversation_list", "parameter_count": 2, "parameters": { "count": { "description": "返回未读会话条数（可选，不传则使用服务端默认值）", "interface_description": "总结会话条数，可不传", "interface_type": "number", "property": "count", "required": false, "type": "integer" }, "exclude-muted": { "description": "是否排除已设置免打扰的会话（默认 false）", "interface_description": "excludeMuted", "property": "excludeMuted", "required": false, "type": "boolean" } }, "path": "chat.unread_message_conversation_list", "primary_cli_path": "chat message list-unread-conversations", "product_id": "chat", "risk": "low", "source": "runtime:group-chat", "title": "unread_message_conversation_list", "use_when": [ "2b. 拉取未读会话列表", "未读会话列表", "未读消息会话/未读会话列表/我的未读会话", "未读消息会话/未读会话列表/我的未读会话；未读会话列表" ] }, "chat.unset_pin_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.unset_pin_message", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "取消某条钉住的(pin)消息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.unset_pin_message", "cli_name": "unset-pin-msg", "cli_path": "chat message unset-pin-msg", "confirmation": "not_required", "description": "取消某条钉住的(pin)消息", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message unset-pin-msg --open-conversation-id \u003copenConversationId\u003e --msg-id \u003copenMessageId\u003e" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "unset_pin_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "unset_pin_message", "parameter_count": 2, "parameters": { "msg-id": { "description": "消息 openMessageId (必填)", "interface_description": "开放消息id", "property": "openMessageId", "required": true, "type": "string" }, "open-conversation-id": { "description": "会话 openConversationId (必填，支持群聊/单聊)", "interface_description": "开放会话id", "property": "openConversationId", "required": true, "type": "string" } }, "path": "chat.unset_pin_message", "primary_cli_path": "chat message unset-pin-msg", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "取消钉住的消息", "use_when": [ "取消钉住/Unpin消息；取消钉住消息" ] }, "chat.update_conv_member_roles": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.update_conv_member_roles", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "设置/取消群成员为管理员", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.update_conv_member_roles", "cli_name": "set-admin", "cli_path": "chat group set-admin", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "users", "user" ] ] }, "description": "设置/取消群成员为管理员", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group set-admin --group \u003cgroup\u003e --users \u003cusers\u003e" ], "group": "group", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_conv_member_roles" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_conv_member_roles", "parameter_count": 4, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "off": { "description": "取消管理员（不传则设为管理员）", "interface_description": "admin", "property": "admin", "required": false, "type": "boolean" }, "user": { "description": "成员 userId，支持逗号分隔", "property": "user", "required": false, "type": "string" }, "users": { "description": "成员 userId 列表，逗号分隔（批量）", "interface_description": "目标用户openDingTalkIds", "interface_type": "array", "property": "openDingTalkIds", "required": false, "type": "string" } }, "path": "chat.update_conv_member_roles", "primary_cli_path": "chat group set-admin", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "设置/取消群成员为管理员", "use_when": [ "设管理员/取消管理员/设置群管理员", "设管理员/取消管理员；设置群管理员" ] }, "chat.update_custom_group_role": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.update_custom_group_role", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新群身份", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“拉取会话的群身份”请改用 dws chat group-role list", "要“根据用户提供的群和成员为在群里查询成员的群身份”请改用 dws chat group-role query-user", "要“添加群身份”请改用 dws chat group-role add" ], "canonical_path": "chat.update_custom_group_role", "cli_name": "update", "cli_path": "chat group-role update", "confirmation": "not_required", "description": "更新群身份", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group-role update --group \u003copenConversationId\u003e --role-id \u003copenRoleId\u003e --name \"新名称\"" ], "group": "group-role", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_custom_group_role" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_custom_group_role", "parameter_count": 3, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "name": { "description": "群身份新名称 (必填)", "interface_description": "name", "property": "name", "required": true, "type": "string" }, "role-id": { "description": "群身份 openRoleId，由 group-role list 返回 (必填)", "interface_description": "openRoleId", "property": "openRoleId", "required": true, "type": "string" } }, "path": "chat.update_custom_group_role", "primary_cli_path": "chat group-role update", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "更新群身份", "use_when": [ "修改/更新群身份名称" ] }, "chat.update_group_icon": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.update_group_icon", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新群头像", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.update_group_icon", "cli_name": "update-icon", "cli_path": "chat group update-icon", "confirmation": "not_required", "description": "更新群头像", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group update-icon --group \u003copenConversationId\u003e --icon-media-id \u003cmediaId\u003e" ], "group": "group", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_group_icon" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_group_icon", "parameter_count": 2, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "icon-media-id": { "description": "群头像 mediaId (必填)", "example": "@lADP_schema_smoke", "format": "dingtalk-media-id", "interface_description": "iconMediaId", "property": "iconMediaId", "required": true, "type": "string" } }, "path": "chat.update_group_icon", "primary_cli_path": "chat group update-icon", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "更新群头像", "use_when": [ "改群头像/更新群头像；更新群头像" ] }, "chat.update_group_name": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.chat.prod.json#chat.update_group_name", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新群名称", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.update_group_name", "cli_name": "rename", "cli_path": "chat group rename", "confirmation": "not_required", "description": "更新群名称", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group rename --id \u003copenconversation_id\u003e --name \"新群名\"" ], "group": "group", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "chat", "rpc_name": "update_group_name" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_group_name", "parameter_count": 2, "parameters": { "id": { "description": "群 ID / openconversation_id (必填)", "interface_description": "群Id，可从根据关键词搜索群列表服务获取", "property": "openconversation_id", "required": true, "type": "string" }, "name": { "description": "修改后的群名称 (必填)", "interface_description": "修改后的群名称", "property": "group_name", "required": true, "type": "string" } }, "path": "chat.update_group_name", "primary_cli_path": "chat group rename", "product_id": "chat", "risk": "medium", "source": "runtime:group-chat", "title": "update_group_name", "use_when": [ "改群名" ] }, "chat.update_group_settings": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.update_group_settings", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新群设置", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.update_group_settings", "cli_name": "update-settings", "cli_path": "chat group update-settings", "confirmation": "not_required", "description": "更新群设置", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group update-settings --group \u003copenConversationId\u003e --setting-key searchable --status 1", "dws chat group update-settings --group \u003copenConversationId\u003e --setting-key onlyAdminCanAtAll --status 0" ], "group": "group", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_group_settings" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_group_settings", "parameter_count": 3, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "setting-key": { "description": "群设置项 key (必填)", "interface_description": "settingKey", "property": "settingKey", "required": true, "type": "string" }, "status": { "description": "设置值: 0=关闭, 1=开启 (必填)", "interface_description": "status", "interface_type": "number", "property": "status", "required": true, "type": "integer" } }, "path": "chat.update_group_settings", "primary_cli_path": "chat group update-settings", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "更新群设置", "use_when": [ "改群设置/群设置开关/群权限/入群许可/禁止私聊；更新群设置" ] }, "chat.update_notification_off": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.update_notification_off", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "群免打扰开关", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "关闭@所有人通知/屏蔽@all/不接收@所有人；关闭 @所有人提醒", "关闭红包通知/屏蔽红包/不接收红包提醒；关闭红包提醒", "隐藏会话/隐藏群聊/隐藏对话；隐藏会话" ], "canonical_path": "chat.update_notification_off", "cli_name": "mute", "cli_path": "chat mute", "confirmation": "not_required", "description": "群免打扰开关", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat mute --conversation-id \u003copenConversationId\u003e", "dws chat mute --conversation-id \u003copenConversationId\u003e --off" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_notification_off" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_notification_off", "parameter_count": 4, "parameters": { "chat": { "description": "--conversation-id 的别名", "property": "chat", "required": false, "type": "string" }, "conversation-id": { "description": "会话 openConversationId (必填，支持单聊/群聊)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "id": { "description": "--conversation-id 的别名", "property": "id", "required": false, "type": "string" }, "off": { "description": "关闭免打扰（不传则开启免打扰）", "interface_description": "mute", "property": "mute", "required": false, "type": "boolean" } }, "path": "chat.update_notification_off", "primary_cli_path": "chat mute", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "群免打扰开关", "use_when": [ "免打扰/消息免打扰/静音/开启免打扰/关闭免打扰" ] }, "chat.update_show_history_msg_option": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.update_show_history_msg_option", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "设置新成员入群可查看历史消息选项", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个群聊，支持指定群名称、初始成员列表等参数”请改用 dws chat group create", "要“根据群号获取群聊信息”请改用 dws chat group get-by-group-id", "要“解散群聊”请改用 dws chat group dismiss" ], "canonical_path": "chat.update_show_history_msg_option", "cli_name": "set-history", "cli_path": "chat group set-history", "confirmation": "not_required", "description": "设置新成员入群可查看历史消息选项", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat group set-history --group \u003copenConversationId\u003e --option RECENT_100", "dws chat group set-history --group \u003copenConversationId\u003e --option FORBIDDEN" ], "group": "group", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_show_history_msg_option" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_show_history_msg_option", "parameter_count": 2, "parameters": { "group": { "description": "群聊 openConversationId (必填)", "interface_description": "openConversationId", "property": "openConversationId", "required": true, "type": "string" }, "option": { "description": "可见范围: FORBIDDEN | RECENT_100 | ALL (必填)", "enum": [ "FORBIDDEN", "RECENT_100", "ALL" ], "interface_description": "可选值: \"FORBIDDEN\"-禁止查看历史消息；\"RECENT_100\"-可查看最近100条消息；\"ALL\"-可查看全部历史消息", "property": "option", "required": true, "type": "string" } }, "path": "chat.update_show_history_msg_option", "primary_cli_path": "chat group set-history", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "设置新成员入群可查看历史消息选项", "use_when": [ "新成员看历史/历史消息可见范围；设置新成员可见历史消息", "设置历史消息/新成员看历史/新成员可见消息" ] }, "chat.update_streaming_card": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.chat.update_streaming_card", "skills/mono/references/intent-guide.md", "skills/mono/references/products/chat.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "流式更新卡片内容", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“合并转发消息”请改用 dws chat message combine-forward", "要“消息添加 emoji 回应”请改用 dws chat message add-emoji", "要“添加文字表情”请改用 dws chat message add-text-emotion" ], "canonical_path": "chat.update_streaming_card", "cli_name": "update-card", "cli_path": "chat message update-card", "confirmation": "not_required", "description": "流式更新卡片内容", "display": "群聊 / 消息 / 机器人", "effect": "write", "effect_source": "command-verb", "examples": [ "dws chat message update-card --biz-id \u003cbizId\u003e --content \"更新的卡片内容\" --flow-status 2", "dws chat message update-card --biz-id \u003cbizId\u003e --content \"最终内容\" --flow-status 3" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "im", "rpc_name": "update_streaming_card" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_streaming_card", "parameter_count": 3, "parameters": { "biz-id": { "description": "卡片业务 ID (必填)", "interface_description": "bizId", "property": "bizId", "required": true, "type": "string" }, "content": { "description": "卡片消息内容 (必填)", "interface_description": "msgContent", "property": "msgContent", "required": true, "type": "string" }, "flow-status": { "description": "流式状态 (必填)", "interface_description": "flowStatus", "interface_type": "string", "property": "flowStatus", "required": true, "type": "integer" } }, "path": "chat.update_streaming_card", "primary_cli_path": "chat message update-card", "product_id": "chat", "reviewed": false, "risk": "medium", "source": "runtime:im", "title": "流式更新卡片内容", "use_when": [ "更新卡片/流式更新卡片；流式更新卡片内容" ] }, "contact.get_authorized_emp_rosterInfo": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.contact.get_authorized_emp_rosterInfo", "skills/mono/references/products/contact.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询员工花名册字段信息，根据当前用户指定员工和字段列表，查询相应管理范围内员工的字段值信息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询花名册有权限的字段列表，根据当前用户查询花名册有权限的字段列”请改用 dws contact user profile fields" ], "canonical_path": "contact.get_authorized_emp_rosterInfo", "cli_name": "get", "cli_path": "contact user profile get", "confirmation": "not_required", "description": "查询员工花名册字段信息，根据当前用户指定员工和字段列表，查询相应管理范围内员工的字段值信息", "display": "通讯录 / 用户 / 部门 / 人员关系", "effect": "read", "effect_source": "command-verb", "examples": [ "dws contact user profile get --staff-id STAFF_ID", "dws contact user profile get --staff-id STAFF_ID --fields fieldCode1,fieldCode2" ], "group": "user.profile", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "hrmregister", "rpc_name": "get_authorized_emp_rosterInfo" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_authorized_emp_rosterInfo", "parameter_count": 2, "parameters": { "fields": { "description": "指定字段集合, 逗号分隔, 可通过 profile fields 获取（可选）", "interface_description": "指定字段集合", "interface_type": "array", "property": "fieldCodeList", "required": false, "type": "string" }, "staff-id": { "description": "查询员工 ID（可选）", "interface_description": "查询员工ID", "property": "staffId", "required": false, "type": "string" } }, "path": "contact.get_authorized_emp_rosterInfo", "primary_cli_path": "contact user profile get", "product_id": "contact", "reviewed": false, "risk": "low", "source": "runtime:hrmregister", "title": "查询员工花名册字段信息", "use_when": [ "11. 根据字段 code 查询指定员工的花名册信息", "12. 查询所有可见字段的花名册信息", "花名册/员工档案/学历/家庭/银行卡/紧急联系人/合同" ] }, "contact.get_current_user_profile": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.contact.prod.json#contact.get_current_user_profile", "skills/mono/references/products/contact.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取当前用户信息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量获取用户详情（逗号分隔 userId）”请改用 dws contact user get", "要“按关键词搜索用户”请改用 dws contact user search", "要“按手机号搜索用户”请改用 dws contact user search-mobile" ], "canonical_path": "contact.get_current_user_profile", "cli_name": "get-self", "cli_path": "contact user get-self", "confirmation": "not_required", "description": "获取当前登录用户的基本信息（如姓名、工号、手机号）、当前组织信息（corpId、组织名称）、直属主管信息、所属部门列表（含部门 ID 与名称）以及角色信息（如管理员类型、自定义角色标签等）。返回内容受组织隐私与权限策略控制：若某些字段（如主管、手机号）被设为不可见，则可能被过滤或省略。", "display": "通讯录 / 用户 / 部门 / 人员关系", "effect": "read", "effect_source": "command-verb", "examples": [ "dws contact user get-self", "dws contact user get-self --format json" ], "group": "user", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "get_current_user_profile" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_current_user_profile", "parameter_count": 0, "parameters": {}, "path": "contact.get_current_user_profile", "primary_cli_path": "contact user get-self", "product_id": "contact", "risk": "low", "source": "runtime:contact", "title": "获取当前用户详情", "use_when": [ "1. 查看自己的信息 — 提取 userId", "我是谁/我的信息/我的 userId/当前用户/本人/self/me/whoami" ] }, "contact.get_dept_info_by_dept_id": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.contact.get_dept_info_by_dept_id", "skills/mono/references/intent-guide.md", "skills/mono/references/products/contact.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "根据指定的部门 ID，获取部门详情。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“按关键词搜索部门”请改用 dws contact dept search", "要“查看部门成员（逗号分隔 deptId）”请改用 dws contact dept list-members", "要“根据指定的部门 ID，获取其直接子部门列表，返回每个子部门的部门”请改用 dws contact dept list-children" ], "canonical_path": "contact.get_dept_info_by_dept_id", "cli_name": "get-info", "cli_path": "contact dept get-info", "confirmation": "not_required", "description": "根据指定的部门 ID，获取部门详情。结果受组织架构可见性控制：仅返回调用者有权限查看的部门信息", "display": "通讯录 / 用户 / 部门 / 人员关系", "effect": "read", "effect_source": "command-verb", "examples": [ "dws contact dept get-info --dept 12345", "dws contact dept get-info --dept \u003cdeptId\u003e --format json" ], "group": "dept", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "get_dept_info_by_dept_id" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_dept_info_by_dept_id", "parameter_count": 1, "parameters": { "dept": { "description": "部门 ID (必填)", "format": "numeric-id", "interface_description": "部门Id", "interface_type": "number", "property": "deptId", "required": true, "type": "string" } }, "path": "contact.get_dept_info_by_dept_id", "primary_cli_path": "contact dept get-info", "product_id": "contact", "reviewed": false, "risk": "low", "source": "runtime:contact", "title": "查询部门详情", "use_when": [ "4. 查看部门详情（部门ID、名称、人数）", "研发部有多少人；查部门人数", "研发部的详细信息/部门信息；查部门详情", "部门详情/部门信息/部门多少人" ] }, "contact.get_dept_members_by_deptId": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.contact.prod.json#contact.get_dept_members_by_deptId", "skills/mono/references/intent-guide.md", "skills/mono/references/products/contact.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查看部门成员（逗号分隔 deptId）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“按关键词搜索部门”请改用 dws contact dept search", "要“根据指定的部门 ID，获取其直接子部门列表，返回每个子部门的部门”请改用 dws contact dept list-children", "要“根据指定的部门 ID，获取部门详情”请改用 dws contact dept get-info" ], "canonical_path": "contact.get_dept_members_by_deptId", "cli_name": "list-members", "cli_path": "contact dept list-members", "confirmation": "not_required", "description": "获取指定部门下的所有成员，返回每位成员的用户 ID（userId）和显示名称（如真实姓名或昵称）。结果受组织可见性控制：若调用者无权查看某成员（例如该成员所在子部门被隐藏，或其个人信息设为私密），则该成员不会出现在返回列表中。适用于需要展示部门人员列表、选择协作成员等场景，仅支持调用者有权限访问的部门。", "display": "通讯录 / 用户 / 部门 / 人员关系", "effect": "read", "effect_source": "command-verb", "examples": [ "dws contact dept list-members --depts 12345,67890", "dws contact dept list-members --depts 1 # 根部门" ], "group": "dept", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "get_dept_members_by_deptId" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_dept_members_by_deptId", "parameter_count": 1, "parameters": { "depts": { "description": "部门 ID 列表 (必填)", "interface_description": "需要获取部门的ID", "interface_type": "array", "property": "deptIds", "required": true, "type": "string" } }, "path": "contact.get_dept_members_by_deptId", "primary_cli_path": "contact dept list-members", "product_id": "contact", "risk": "low", "source": "runtime:contact", "title": "获取部门下所有成员", "use_when": [ "6. 查看部门成员", "部门有谁/部门成员/人员名单" ] }, "contact.get_sub_depts_by_dept_id": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.contact.get_sub_depts_by_dept_id", "skills/mono/references/products/contact.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "根据指定的部门 ID，获取其直接子部门列表，返回每个子部门的部门 ID、名称。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“按关键词搜索部门”请改用 dws contact dept search", "要“查看部门成员（逗号分隔 deptId）”请改用 dws contact dept list-members", "要“根据指定的部门 ID，获取部门详情”请改用 dws contact dept get-info" ], "canonical_path": "contact.get_sub_depts_by_dept_id", "cli_name": "list-children", "cli_path": "contact dept list-children", "confirmation": "not_required", "description": "根据指定的部门 ID，获取其直接子部门列表，返回每个子部门的部门 ID、名称。结果受组织架构可见性控制：仅返回调用者有权限查看的子部门；若父部门不可见或无子部门，则返回空列表。", "display": "通讯录 / 用户 / 部门 / 人员关系", "effect": "read", "effect_source": "command-verb", "examples": [ "dws contact dept list-children --dept 1 # 枚举根部门下的一级部门", "dws contact dept list-children --dept 12345 # 枚举指定部门的直属子部门" ], "group": "dept", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "get_sub_depts_by_dept_id" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_sub_depts_by_dept_id", "parameter_count": 1, "parameters": { "dept": { "description": "部门 ID (必填)", "format": "numeric-id", "interface_description": "部门Id", "interface_type": "number", "property": "deptId", "required": true, "type": "string" } }, "path": "contact.get_sub_depts_by_dept_id", "primary_cli_path": "contact dept list-children", "product_id": "contact", "reviewed": false, "risk": "low", "source": "runtime:contact", "title": "获取部门的子部门", "use_when": [ "5. 查看直属子部门 — 提取子 deptId 列表", "子部门/下设部门/部门有哪些下级部门/枚举二级部门" ] }, "contact.get_user_info_by_user_ids": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.contact.prod.json#contact.get_user_info_by_user_ids", "skills/mono/references/products/contact.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量获取用户详情（逗号分隔 userId）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“按关键词搜索用户”请改用 dws contact user search", "要“按手机号搜索用户”请改用 dws contact user search-mobile", "要“获取当前用户信息”请改用 dws contact user get-self" ], "canonical_path": "contact.get_user_info_by_user_ids", "cli_name": "get", "cli_path": "contact user get", "confirmation": "not_required", "description": "获取指定用户 ID 列表对应的员工详细信息，包括人员基本信息（ID、名称、主管名称、主管userId等）、所属角色信息、所在部门信息。返回结果受组织可见性规则限制：若调用者无权查看某员工（如部门隐藏、手机号设为私密等），则相应字段可能被过滤或不返回该员工。适用于需要批量获取同事信息的场景，如组织架构展示、审批人选择等。仅返回调用者权限范围内的有效数据。", "display": "通讯录 / 用户 / 部门 / 人员关系", "effect": "read", "effect_source": "command-verb", "examples": [ "dws contact user get --ids userId1,userId2", "dws contact user get --ids userId1,userId2 # 查询 userId: dws contact user search --keyword \"姓名\"" ], "group": "user", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "get_user_info_by_user_ids" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_user_info_by_user_ids", "parameter_count": 1, "parameters": { "ids": { "description": "用户 ID 列表 (必填)", "interface_description": "user_id的列表。可能也叫userId", "interface_type": "array", "property": "user_id_list", "required": true, "type": "string" } }, "path": "contact.get_user_info_by_user_ids", "primary_cli_path": "contact user get", "product_id": "contact", "risk": "low", "source": "runtime:contact", "title": "get_user_info_by_user_ids", "use_when": [ "查用户详情/部门/主管/管理员" ] }, "contact.list_authorized_roster_fields": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.contact.list_authorized_roster_fields", "skills/mono/references/products/contact.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询花名册有权限的字段列表，根据当前用户查询花名册有权限的字段列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询员工花名册字段信息，根据当前用户指定员工和字段列表，查询相应”请改用 dws contact user profile get" ], "canonical_path": "contact.list_authorized_roster_fields", "cli_name": "fields", "cli_path": "contact user profile fields", "confirmation": "not_required", "description": "查询花名册有权限的字段列表，根据当前用户查询花名册有权限的字段列表", "display": "通讯录 / 用户 / 部门 / 人员关系", "effect": "read", "effect_source": "command-verb", "examples": [ "dws contact user profile fields" ], "group": "user.profile", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "hrmregister", "rpc_name": "list_authorized_roster_fields" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_authorized_roster_fields", "parameter_count": 0, "parameters": {}, "path": "contact.list_authorized_roster_fields", "primary_cli_path": "contact user profile fields", "product_id": "contact", "reviewed": false, "risk": "low", "source": "runtime:hrmregister", "title": "查询花名册有权限字段列表", "use_when": [ "10. 查询花名册有权限的字段列表", "花名册字段/有哪些字段/字段列表" ] }, "contact.list_my_followings": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.contact.list_my_followings", "skills/mono/references/products/contact.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取我的特别关注列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取我的特别关注列表”" ], "canonical_path": "contact.list_my_followings", "cli_name": "list-my-followings", "cli_path": "contact relation list-my-followings", "confirmation": "not_required", "description": "获取我的特别关注列表", "display": "通讯录 / 用户 / 部门 / 人员关系", "effect": "read", "effect_source": "command-verb", "examples": [ "dws contact relation list-my-followings" ], "group": "relation", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "list_my_followings" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_my_followings", "parameter_count": 0, "parameters": {}, "path": "contact.list_my_followings", "primary_cli_path": "contact relation list-my-followings", "product_id": "contact", "reviewed": false, "risk": "low", "source": "runtime:contact", "title": "获取我的特别关注列表", "use_when": [ "我关注了谁/我的特别关注列表/我的星标联系人/特别关注的人有哪些" ] }, "contact.query_dismission_employee_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.contact.query_dismission_employee_list", "skills/mono/references/products/contact.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取离职员工列表，支持按照员工姓名、离职时间范围、部门过滤", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取离职员工列表，支持按照员工姓名、离职时间范围、部门过滤”" ], "canonical_path": "contact.query_dismission_employee_list", "cli_name": "search", "cli_path": "contact user dismission search", "confirmation": "not_required", "constraints": { "require_together": [ [ "start", "end" ] ] }, "description": "获取离职员工列表，支持按照员工姓名、离职时间范围、部门过滤", "display": "通讯录 / 用户 / 部门 / 人员关系", "effect": "read", "effect_source": "command-verb", "examples": [ "dws contact user dismission search", "dws contact user dismission search --name \"张三\"" ], "group": "user.dismission", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "hrmregister", "rpc_name": "query_dismission_employee_list" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_dismission_employee_list", "parameter_count": 8, "parameters": { "depts": { "description": "部门 ID 列表，逗号分隔（可选）", "property": "searchVO.depts", "required": false, "type": "string" }, "end": { "description": "离职日期查询范围结束，格式 YYYY-MM-DD（可选），与start要么都不填要么都填", "property": "searchVO.endDate", "required": false, "type": "string" }, "hide-partner": { "description": "是否隐藏合作伙伴，默认 false（可选）", "property": "searchVO.hidePartner", "required": false, "type": "boolean" }, "hide-retirement": { "default": "true", "description": "是否隐藏退休，默认 true（可选）", "property": "searchVO.hideRetirement", "required": false, "type": "boolean" }, "limit": { "default": "20", "description": "页大小，200 以内（可选）", "interface_description": "页大小，200以内", "interface_type": "number", "property": "pageSize", "required": false, "type": "integer" }, "name": { "description": "员工姓名，模糊搜索（可选）", "property": "searchVO.empName", "required": false, "type": "string" }, "page": { "default": "1", "description": "页码，从 1 开始（可选）", "interface_description": "页码，从1开始", "interface_type": "number", "property": "pageNum", "required": false, "type": "integer" }, "start": { "description": "离职日期查询范围开始，格式 YYYY-MM-DD（可选），与end要么都不填要么都填", "property": "searchVO.startDate", "required": false, "type": "string" } }, "path": "contact.query_dismission_employee_list", "primary_cli_path": "contact user dismission search", "product_id": "contact", "reviewed": false, "risk": "low", "source": "runtime:hrmregister", "title": "query_dismission_employee_list", "use_when": [ "13. 查询全部离职员工", "14. 按姓名/时间范围/部门筛选离职员工", "离职员工/离职名单/离职人员/已离职" ] }, "contact.search_contact_by_key_word": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.contact.prod.json#contact.search_contact_by_key_word", "skills/mono/references/intent-guide.md", "skills/mono/references/products/contact.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "按关键词搜索用户", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量获取用户详情（逗号分隔 userId）”请改用 dws contact user get", "要“按手机号搜索用户”请改用 dws contact user search-mobile", "要“获取当前用户信息”请改用 dws contact user get-self" ], "canonical_path": "contact.search_contact_by_key_word", "cli_name": "search", "cli_path": "contact user search", "confirmation": "not_required", "description": "根据关键词搜索好友和同事", "display": "通讯录 / 用户 / 部门 / 人员关系", "effect": "read", "effect_source": "command-verb", "examples": [ "dws contact user search --query \"张三\"", "dws contact user search --query \"张三\" --format json" ], "group": "user", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "search_contact_by_key_word" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_contact_by_key_word", "parameter_count": 1, "parameters": { "query": { "description": "搜索关键词 (必填)", "interface_description": "搜索的关键词；按照关联性排序", "property": "keyword", "required": true, "type": "string" } }, "path": "contact.search_contact_by_key_word", "primary_cli_path": "contact user search", "product_id": "contact", "risk": "low", "source": "runtime:contact", "title": "根据关键词搜索好友和同事", "use_when": [ "2. 按名字搜索同事或好友 — 可提取 同事的userId，或好友的openDingTalkId" ] }, "contact.search_dept_by_keyword": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.contact.prod.json#contact.search_dept_by_keyword", "skills/mono/references/products/contact.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "按关键词搜索部门", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“查看部门成员（逗号分隔 deptId）”请改用 dws contact dept list-members", "要“根据指定的部门 ID，获取其直接子部门列表，返回每个子部门的部门”请改用 dws contact dept list-children", "要“根据指定的部门 ID，获取部门详情”请改用 dws contact dept get-info" ], "canonical_path": "contact.search_dept_by_keyword", "cli_name": "search", "cli_path": "contact dept search", "confirmation": "not_required", "description": "根据关键词模糊搜索部门，返回匹配的部门列表，包含每个部门的 ID、名称。搜索范围限于调用者有权限查看的组织架构；若关键词无匹配结果或部门因可见性设置被隐藏，则相应部门不会出现在结果中。", "display": "通讯录 / 用户 / 部门 / 人员关系", "effect": "read", "effect_source": "command-verb", "examples": [ "dws contact dept search --query \"技术部\"", "dws contact dept search --query \"技术部\" --format json" ], "group": "dept", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "search_dept_by_keyword" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_dept_by_keyword", "parameter_count": 1, "parameters": { "query": { "description": "搜索关键词 (必填)", "interface_description": "搜索关键词", "property": "query", "required": true, "type": "string" } }, "path": "contact.search_dept_by_keyword", "primary_cli_path": "contact dept search", "product_id": "contact", "risk": "low", "source": "runtime:contact", "title": "搜索部门", "use_when": [ "3. 查看部门结构 — 提取 deptId", "找部门/哪个部门" ] }, "contact.search_user_by_mobile": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.contact.prod.json#contact.search_user_by_mobile", "skills/mono/references/products/contact.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "按手机号搜索用户", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量获取用户详情（逗号分隔 userId）”请改用 dws contact user get", "要“按关键词搜索用户”请改用 dws contact user search", "要“获取当前用户信息”请改用 dws contact user get-self" ], "canonical_path": "contact.search_user_by_mobile", "cli_name": "search-mobile", "cli_path": "contact user search-mobile", "confirmation": "not_required", "description": "通过手机号搜索获取用户名称和userId。", "display": "通讯录 / 用户 / 部门 / 人员关系", "effect": "read", "effect_source": "command-verb", "examples": [ "dws contact user search-mobile --mobile 13800138000" ], "group": "user", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "contact", "rpc_name": "search_user_by_mobile" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_user_by_mobile", "parameter_count": 1, "parameters": { "mobile": { "description": "手机号 (必填)", "interface_description": "搜索的手机号", "property": "mobile", "required": true, "type": "string" } }, "path": "contact.search_user_by_mobile", "primary_cli_path": "contact user search-mobile", "product_id": "contact", "risk": "low", "source": "runtime:contact", "title": "通过手机号获取成员userId和名称", "use_when": [ "按手机号搜索用户" ] }, "dev.add_dev_app_members": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "添加开放平台应用成员", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“查询开放平台应用成员”请改用 dws dev app member list", "要“移除开放平台应用的协作成员”请改用 dws dev app member remove" ], "canonical_path": "dev.add_dev_app_members", "cli_name": "add", "cli_path": "dev app member add", "confirmation": "not_required", "description": "添加开放平台应用成员", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app member add --member-type \u003cmember-type\u003e --unified-app-id \u003cunified-app-id\u003e --user-ids \u003cuser-ids\u003e" ], "group": "app.member", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "add_dev_app_members" }, "is_alias": false, "name": "add_dev_app_members", "parameter_count": 3, "parameters": { "member-type": { "description": "成员类型，如 DEVELOPER (必填)", "property": "memberType", "required": true, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" }, "user-ids": { "description": "成员 userId 列表，多个用逗号分隔 (必填)", "property": "userIds", "required": true, "type": "string" } }, "path": "dev.add_dev_app_members", "primary_cli_path": "dev app member add", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "添加开放平台应用成员", "use_when": [ "添加开放平台应用成员" ] }, "dev.apply_dev_app_permissions": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "申请开放平台应用权限点", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“查询开放平台应用权限列表”请改用 dws dev app permission list", "要“移除开放平台应用已授予的权限点”请改用 dws dev app permission remove" ], "canonical_path": "dev.apply_dev_app_permissions", "cli_name": "add", "cli_path": "dev app permission add", "confirmation": "not_required", "description": "申请开放平台应用权限点", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app permission add --unified-app-id \u003cunifiedAppId\u003e --scope-values \u003cscopeValue\u003e --format json" ], "group": "app.permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "apply_dev_app_permissions" }, "is_alias": false, "name": "apply_dev_app_permissions", "parameter_count": 2, "parameters": { "scope-values": { "description": "权限点 scopeValue，多个用逗号或分号分隔", "property": "scopeValues", "required": true, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.apply_dev_app_permissions", "primary_cli_path": "dev app permission add", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "申请开放平台应用权限点", "use_when": [ "申请开放平台应用权限点" ] }, "dev.connect_status": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查看后台连接器守护进程状态（pid、运行时长、日志路径）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“优雅停止后台连接器守护进程（释放单实例锁与 Stream 连接）”请改用 dws dev connect stop" ], "canonical_path": "dev.connect_status", "cli_name": "status", "cli_path": "dev connect status", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "robot-client-id", "unified-app-id" ] ] }, "description": "查看连接器健康状态（healthy/degraded/down，pid、收发活动、日志路径；--json 供外部托管消费）", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev connect status --json" ], "group": "connect", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "命令仅操作本地进程或策略文件，不调用 MCP 接口", "is_alias": false, "name": "connect_status", "parameter_count": 3, "parameters": { "json": { "description": "以 JSON 输出健康报告（供 launchd/systemd/pm2/cron 判断是否重启）", "property": "json", "required": false, "type": "boolean" }, "robot-client-id": { "description": "机器人 clientId（定位守护进程）", "property": "robotClientId", "required": false, "type": "string" }, "unified-app-id": { "description": "统一应用 ID（当未用 clientId 起守护进程时定位）", "property": "unifiedAppId", "required": false, "type": "string" } }, "path": "dev.connect_status", "primary_cli_path": "dev connect status", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "查看连接器健康状态（healthy/degraded/down，pid、收发活动、日志路径；--json 供外部托管消费）", "use_when": [ "查看/停止后台连接器（status/list 忽略全局 --format，出 JSON 用专属 --json）", "查看后台连接器守护进程状态（pid、运行时长、日志路径）" ] }, "dev.connect_stop": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "优雅停止后台连接器守护进程（释放单实例锁与 Stream 连接）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“查看后台连接器守护进程状态（pid、运行时长、日志路径）”请改用 dws dev connect status" ], "canonical_path": "dev.connect_stop", "cli_name": "stop", "cli_path": "dev connect stop", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "robot-client-id", "unified-app-id" ] ] }, "description": "优雅停止后台连接器守护进程（释放单实例锁与 Stream 连接）", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev connect stop" ], "group": "connect", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "命令仅操作本地进程或策略文件，不调用 MCP 接口", "is_alias": false, "name": "connect_stop", "parameter_count": 2, "parameters": { "robot-client-id": { "description": "机器人 clientId（定位守护进程）", "property": "robotClientId", "required": false, "type": "string" }, "unified-app-id": { "description": "统一应用 ID（当未用 clientId 起守护进程时定位）", "property": "unifiedAppId", "required": false, "type": "string" } }, "path": "dev.connect_stop", "primary_cli_path": "dev connect stop", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "优雅停止后台连接器守护进程（释放单实例锁与 Stream 连接）", "use_when": [ "优雅停止后台连接器守护进程（释放单实例锁与 Stream 连接）", "查看/停止后台连接器（status/list 忽略全局 --format，出 JSON 用专属 --json）" ] }, "dev.create_dev_app": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建开放平台企业内部应用", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用，停用后应用能力对外不可用（可重新启用）”请改用 dws dev app disable", "要“删除开放平台企业内部应用（不可逆，需 --confirm-nam”请改用 dws dev app delete", "要“启用开放平台企业内部应用”请改用 dws dev app enable" ], "canonical_path": "dev.create_dev_app", "cli_name": "create", "cli_path": "dev app create", "confirmation": "not_required", "description": "创建开放平台企业内部应用", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app create --name \"我的 AI 机器人\" --desc \"接 opencode\" --dry-run --format json" ], "group": "app", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "create_dev_app" }, "is_alias": false, "name": "create_dev_app", "parameter_count": 3, "parameters": { "desc": { "description": "应用描述", "property": "desc", "required": false, "type": "string" }, "icon-media-id": { "description": "应用图标 mediaId", "property": "iconMediaId", "required": false, "type": "string" }, "name": { "description": "应用名称 (必填)", "property": "name", "required": true, "type": "string" } }, "path": "dev.create_dev_app", "primary_cli_path": "dev app create", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "创建开放平台企业内部应用", "use_when": [ "创建应用", "创建开放平台企业内部应用", "创建开放平台应用，拿 unifiedAppId" ] }, "dev.create_dev_app_version": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "基于当前配置创建应用新版本", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“分页查询应用版本列表”请改用 dws dev app version list", "要“查询指定版本详情”请改用 dws dev app version get", "要“查询版本发布/审批状态”请改用 dws dev app version status" ], "canonical_path": "dev.create_dev_app_version", "cli_name": "create", "cli_path": "dev app version create", "confirmation": "not_required", "description": "基于当前配置创建应用新版本", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app version create --unified-app-id \u003cunifiedAppId\u003e --desc \"发布机器人能力\" --dry-run --format json" ], "group": "app.version", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "create_dev_app_version" }, "is_alias": false, "name": "create_dev_app_version", "parameter_count": 3, "parameters": { "desc": { "description": "版本描述", "property": "desc", "required": false, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" }, "version": { "description": "高级可选：显式版本号，如 1.0.1；默认不传，由服务端基于最新已发布版本自动递增", "property": "version", "required": false, "type": "string" } }, "path": "dev.create_dev_app_version", "primary_cli_path": "dev app version create", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "基于当前配置创建应用新版本", "use_when": [ "基于当前配置创建应用新版本", "版本发布/审批，线上搜索、加群、路由消息以 RELEASE 为准" ] }, "dev.delete_dev_app": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除开放平台企业内部应用（不可逆，需 --confirm-name 二次确认）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用，停用后应用能力对外不可用（可重新启用）”请改用 dws dev app disable", "要“创建开放平台企业内部应用”请改用 dws dev app create", "要“启用开放平台企业内部应用”请改用 dws dev app enable" ], "canonical_path": "dev.delete_dev_app", "cli_name": "delete", "cli_path": "dev app delete", "confirmation": "user_required", "description": "删除开放平台企业内部应用（不可逆，需 --confirm-name 二次确认）", "display": "开放平台开发者能力", "effect": "destructive", "effect_source": "skill-comment", "examples": [ "dws dev app delete --unified-app-id \u003cunified-app-id\u003e" ], "group": "app", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "delete_dev_app" }, "is_alias": false, "name": "delete_dev_app", "parameter_count": 2, "parameters": { "confirm-name": { "description": "二次确认：必须与被删应用的名称一致（不可逆操作的防误删）", "property": "confirmName", "required": false, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.delete_dev_app", "primary_cli_path": "dev app delete", "product_id": "dev", "reviewed": true, "risk": "high", "source": "hardcoded:dev", "title": "删除开放平台企业内部应用（不可逆，需 --confirm-name 二次确认）", "use_when": [ "删除应用（不可逆，需 --confirm-name 二次确认）", "删除开放平台企业内部应用（不可逆，需 --confirm-name 二次确认）" ] }, "dev.disable_dev_app": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "停用开放平台应用，停用后应用能力对外不可用（可重新启用）", "agent_summary_source": "destructive-safety-review", "availability": "available", "avoid_when": [ "要“创建开放平台企业内部应用”请改用 dws dev app create", "要“删除开放平台企业内部应用（不可逆，需 --confirm-nam”请改用 dws dev app delete", "要“启用开放平台企业内部应用”请改用 dws dev app enable" ], "canonical_path": "dev.disable_dev_app", "cli_name": "disable", "cli_path": "dev app disable", "confirmation": "user_required", "description": "停用开放平台企业内部应用", "display": "开放平台开发者能力", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws dev app disable --unified-app-id \u003cunified-app-id\u003e" ], "group": "app", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "disable_dev_app" }, "is_alias": false, "name": "disable_dev_app", "parameter_count": 1, "parameters": { "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.disable_dev_app", "primary_cli_path": "dev app disable", "product_id": "dev", "reviewed": true, "risk": "high", "source": "hardcoded:dev", "title": "停用开放平台企业内部应用", "use_when": [ "停用/启用应用" ] }, "dev.disable_dev_app_robot": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "停用开放平台应用的机器人（可重新启用）", "agent_summary_source": "destructive-safety-review", "availability": "available", "avoid_when": [ "要“启用现有应用机器人能力（纯启用，无需配置字段）”请改用 dws dev app robot enable", "要“查询机器人异步创建任务结果”请改用 dws dev app robot result", "要“查询现有应用的机器人配置”请改用 dws dev app robot get" ], "canonical_path": "dev.disable_dev_app_robot", "cli_name": "disable", "cli_path": "dev app robot disable", "confirmation": "user_required", "description": "停用现有应用的机器人能力", "display": "开放平台开发者能力", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws dev app robot disable --unified-app-id \u003cunifiedAppId\u003e --format json" ], "group": "app.robot", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "disable_dev_app_robot" }, "is_alias": false, "name": "disable_dev_app_robot", "parameter_count": 1, "parameters": { "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.disable_dev_app_robot", "primary_cli_path": "dev app robot disable", "product_id": "dev", "reviewed": true, "risk": "high", "source": "hardcoded:dev", "title": "停用现有应用的机器人能力", "use_when": [ "启用/停用机器人" ] }, "dev.enable_dev_app": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "启用开放平台企业内部应用", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用，停用后应用能力对外不可用（可重新启用）”请改用 dws dev app disable", "要“创建开放平台企业内部应用”请改用 dws dev app create", "要“删除开放平台企业内部应用（不可逆，需 --confirm-nam”请改用 dws dev app delete" ], "canonical_path": "dev.enable_dev_app", "cli_name": "enable", "cli_path": "dev app enable", "confirmation": "not_required", "description": "启用开放平台企业内部应用", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app enable --unified-app-id \u003cunified-app-id\u003e" ], "group": "app", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "enable_dev_app" }, "is_alias": false, "name": "enable_dev_app", "parameter_count": 1, "parameters": { "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.enable_dev_app", "primary_cli_path": "dev app enable", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "启用开放平台企业内部应用", "use_when": [ "停用/启用应用", "启用开放平台企业内部应用" ] }, "dev.enable_dev_app_robot": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "启用现有应用机器人能力（纯启用，无需配置字段）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用的机器人（可重新启用）”请改用 dws dev app robot disable", "要“查询机器人异步创建任务结果”请改用 dws dev app robot result", "要“查询现有应用的机器人配置”请改用 dws dev app robot get" ], "canonical_path": "dev.enable_dev_app_robot", "cli_name": "enable", "cli_path": "dev app robot enable", "confirmation": "not_required", "description": "启用现有应用机器人能力（纯启用，无需配置字段）", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app robot enable --unified-app-id \u003cunifiedAppId\u003e --format json" ], "group": "app.robot", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "enable_dev_app_robot" }, "is_alias": false, "name": "enable_dev_app_robot", "parameter_count": 1, "parameters": { "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.enable_dev_app_robot", "primary_cli_path": "dev app robot enable", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "启用现有应用机器人能力（纯启用，无需配置字段）", "use_when": [ "启用/停用机器人", "启用现有应用机器人能力（纯启用，无需配置字段）" ] }, "dev.get_dev_app": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询开放平台企业内部应用详情", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用，停用后应用能力对外不可用（可重新启用）”请改用 dws dev app disable", "要“创建开放平台企业内部应用”请改用 dws dev app create", "要“删除开放平台企业内部应用（不可逆，需 --confirm-nam”请改用 dws dev app delete" ], "canonical_path": "dev.get_dev_app", "cli_name": "get", "cli_path": "dev app get", "confirmation": "not_required", "description": "查询开放平台企业内部应用详情", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev app get --unified-app-id \u003cunifiedAppId\u003e --format json" ], "group": "app", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "get_dev_app" }, "is_alias": false, "name": "get_dev_app", "parameter_count": 1, "parameters": { "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.get_dev_app", "primary_cli_path": "dev app get", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "查询开放平台企业内部应用详情", "use_when": [ "查询单个应用详情", "查询开放平台企业内部应用详情" ] }, "dev.get_dev_app_credentials": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "读取开放平台应用凭证", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“读取开放平台应用凭证”" ], "canonical_path": "dev.get_dev_app_credentials", "cli_name": "get", "cli_path": "dev app credentials get", "confirmation": "not_required", "description": "读取开放平台应用凭证", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev app credentials get --unified-app-id \u003cunifiedAppId\u003e --format json" ], "group": "app.credentials", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "get_dev_app_credentials" }, "is_alias": false, "name": "get_dev_app_credentials", "parameter_count": 1, "parameters": { "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.get_dev_app_credentials", "primary_cli_path": "dev app credentials get", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "读取开放平台应用凭证", "use_when": [ "查询 clientId/clientSecret（credentials 下只有 get 子命令）", "读取开放平台应用凭证" ] }, "dev.get_dev_app_version_detail": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询指定版本详情", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“分页查询应用版本列表”请改用 dws dev app version list", "要“基于当前配置创建应用新版本”请改用 dws dev app version create", "要“查询版本发布/审批状态”请改用 dws dev app version status" ], "canonical_path": "dev.get_dev_app_version_detail", "cli_name": "get", "cli_path": "dev app version get", "confirmation": "not_required", "description": "查询指定版本详情", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev app version get --unified-app-id \u003cunified-app-id\u003e --version-id \u003cversion-id\u003e" ], "group": "app.version", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "get_dev_app_version_detail" }, "is_alias": false, "name": "get_dev_app_version_detail", "parameter_count": 2, "parameters": { "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" }, "version-id": { "description": "版本 ID (必填)", "property": "versionId", "required": true, "type": "string" } }, "path": "dev.get_dev_app_version_detail", "primary_cli_path": "dev app version get", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "查询指定版本详情", "use_when": [ "查询指定版本详情" ] }, "dev.get_dev_app_version_status": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询版本发布/审批状态", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“分页查询应用版本列表”请改用 dws dev app version list", "要“基于当前配置创建应用新版本”请改用 dws dev app version create", "要“查询指定版本详情”请改用 dws dev app version get" ], "canonical_path": "dev.get_dev_app_version_status", "cli_name": "status", "cli_path": "dev app version status", "confirmation": "not_required", "description": "查询版本发布/审批状态", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev app version status --unified-app-id \u003cunifiedAppId\u003e --version-id \u003cversionId\u003e --format json", "dws dev app version status --unified-app-id \u003cunifiedAppId\u003e --version-id \u003cversionId\u003e --format json" ], "group": "app.version", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "get_dev_app_version_status" }, "is_alias": false, "name": "get_dev_app_version_status", "parameter_count": 2, "parameters": { "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" }, "version-id": { "description": "版本 ID (必填)", "property": "versionId", "required": true, "type": "string" } }, "path": "dev.get_dev_app_version_status", "primary_cli_path": "dev app version status", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "查询版本发布/审批状态", "use_when": [ "查询版本发布/审批状态", "版本发布/审批，线上搜索、加群、路由消息以 RELEASE 为准" ] }, "dev.get_extension_robot_config": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询现有应用的机器人配置", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用的机器人（可重新启用）”请改用 dws dev app robot disable", "要“启用现有应用机器人能力（纯启用，无需配置字段）”请改用 dws dev app robot enable", "要“查询机器人异步创建任务结果”请改用 dws dev app robot result" ], "canonical_path": "dev.get_extension_robot_config", "cli_name": "get", "cli_path": "dev app robot get", "confirmation": "not_required", "description": "查询现有应用的机器人配置", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev app robot get --unified-app-id \u003cunifiedAppId\u003e --format json" ], "group": "app.robot", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "get_extension_robot_config" }, "is_alias": false, "name": "get_extension_robot_config", "parameter_count": 1, "parameters": { "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.get_extension_robot_config", "primary_cli_path": "dev app robot get", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "查询现有应用的机器人配置", "use_when": [ "查询现有应用的机器人配置", "查询现有机器人配置" ] }, "dev.get_extension_webapp_config": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询网页应用配置", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“配置网页应用能力”请改用 dws dev app webapp config" ], "canonical_path": "dev.get_extension_webapp_config", "cli_name": "get", "cli_path": "dev app webapp get", "confirmation": "not_required", "description": "查询网页应用配置", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev app webapp get --unified-app-id \u003cunified-app-id\u003e" ], "group": "app.webapp", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "get_extension_webapp_config" }, "is_alias": false, "name": "get_extension_webapp_config", "parameter_count": 1, "parameters": { "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.get_extension_webapp_config", "primary_cli_path": "dev app webapp get", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "查询网页应用配置", "use_when": [ "查询网页应用配置" ] }, "dev.list_dev_app": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询开放平台企业内部应用列表", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用，停用后应用能力对外不可用（可重新启用）”请改用 dws dev app disable", "要“创建开放平台企业内部应用”请改用 dws dev app create", "要“删除开放平台企业内部应用（不可逆，需 --confirm-nam”请改用 dws dev app delete" ], "canonical_path": "dev.list_dev_app", "cli_name": "list", "cli_path": "dev app list", "confirmation": "not_required", "description": "查询开放平台企业内部应用列表", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev app list --format json" ], "group": "app", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "list_dev_app" }, "is_alias": false, "name": "list_dev_app", "parameter_count": 11, "parameters": { "app-group-id": { "description": "应用分组 ID", "property": "appGroupId", "required": false, "type": "integer" }, "app-key": { "description": "按 appKey/clientId 过滤", "property": "appKey", "required": false, "type": "string" }, "creator": { "description": "创建人名称关键词", "property": "creator", "required": false, "type": "string" }, "cursor": { "description": "游标令牌：首次查询留空，续翻传上次出参的 nextCursor", "property": "cursor", "required": false, "type": "string" }, "develop-type": { "description": "开发类型枚举；不确定时不要传", "property": "developType", "required": false, "type": "integer" }, "filter-cool-app": { "description": "酷应用过滤枚举；不确定时不要传", "property": "filterCoolApp", "required": false, "type": "integer" }, "name": { "description": "应用名称关键词", "property": "name", "required": false, "type": "string" }, "page-size": { "default": "20", "description": "单页条数，默认 20", "property": "pageSize", "required": false, "type": "integer" }, "robot-name": { "description": "机器人名称关键词", "property": "robotName", "required": false, "type": "string" }, "sort-order": { "description": "排序方向 asc 或 desc", "property": "sortOrder", "required": false, "type": "string" }, "sort-type": { "description": "排序字段，如 gmt_modified", "property": "sortType", "required": false, "type": "string" } }, "path": "dev.list_dev_app", "primary_cli_path": "dev app list", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "查询开放平台企业内部应用列表", "use_when": [ "查询应用列表", "查询开放平台企业内部应用列表" ] }, "dev.list_dev_app_events": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询应用已订阅的事件列表", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“取消订阅应用事件”请改用 dws dev app event unsubscribe", "要“订阅应用事件回调”请改用 dws dev app event subscribe" ], "canonical_path": "dev.list_dev_app_events", "cli_name": "list", "cli_path": "dev app event list", "confirmation": "not_required", "description": "查询应用已订阅的事件列表", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev app event list --unified-app-id \u003cunifiedAppId\u003e --keyword \u003c关键词\u003e --format json" ], "group": "app.event", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "list_dev_app_events" }, "is_alias": false, "name": "list_dev_app_events", "parameter_count": 4, "parameters": { "cursor": { "description": "游标令牌：首次查询留空，续翻传上次出参的 nextCursor", "property": "cursor", "required": false, "type": "string" }, "keyword": { "description": "事件搜索关键词，支持按事件码或事件名称模糊匹配", "property": "keyword", "required": false, "type": "string" }, "page-size": { "default": "20", "description": "单页条数，默认 20", "property": "pageSize", "required": false, "type": "integer" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.list_dev_app_events", "primary_cli_path": "dev app event list", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "查询应用已订阅的事件列表", "use_when": [ "查询应用已订阅的事件列表" ] }, "dev.list_dev_app_members": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询开放平台应用成员", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“添加开放平台应用成员”请改用 dws dev app member add", "要“移除开放平台应用的协作成员”请改用 dws dev app member remove" ], "canonical_path": "dev.list_dev_app_members", "cli_name": "list", "cli_path": "dev app member list", "confirmation": "not_required", "description": "查询开放平台应用成员", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev app member list --unified-app-id \u003cunified-app-id\u003e" ], "group": "app.member", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "list_dev_app_members" }, "is_alias": false, "name": "list_dev_app_members", "parameter_count": 1, "parameters": { "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.list_dev_app_members", "primary_cli_path": "dev app member list", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "查询开放平台应用成员", "use_when": [ "查询开放平台应用成员" ] }, "dev.list_dev_app_permissions": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询开放平台应用权限列表", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“申请开放平台应用权限点”请改用 dws dev app permission add", "要“移除开放平台应用已授予的权限点”请改用 dws dev app permission remove" ], "canonical_path": "dev.list_dev_app_permissions", "cli_name": "list", "cli_path": "dev app permission list", "confirmation": "not_required", "description": "查询开放平台应用权限列表", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev app permission list --unified-app-id \u003cunifiedAppId\u003e --format json" ], "group": "app.permission", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "list_dev_app_permissions" }, "is_alias": false, "name": "list_dev_app_permissions", "parameter_count": 8, "parameters": { "api-status": { "description": "开发者后台 apiStatus 过滤", "property": "apiStatus", "required": false, "type": "string" }, "auth-status": { "default": "ALL", "description": "权限状态：ALL、AUTHED、UNAUTHED", "property": "authStatus", "required": false, "type": "string" }, "cursor": { "description": "游标令牌：首次查询留空，续翻传上次出参的 nextCursor", "property": "cursor", "required": false, "type": "string" }, "keyword": { "description": "权限名、权限点、接口名关键词", "property": "keyword", "required": false, "type": "string" }, "page-size": { "default": "20", "description": "单页条数，默认 20", "property": "pageSize", "required": false, "type": "integer" }, "scope-type": { "description": "权限一级类型：APP 或 SNS", "property": "scopeType", "required": false, "type": "string" }, "scope-value": { "description": "精确权限点 scopeValue", "property": "scopeValue", "required": false, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.list_dev_app_permissions", "primary_cli_path": "dev app permission list", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "查询开放平台应用权限列表", "use_when": [ "查询开放平台应用权限列表" ] }, "dev.list_dev_app_versions": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "分页查询应用版本列表", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“基于当前配置创建应用新版本”请改用 dws dev app version create", "要“查询指定版本详情”请改用 dws dev app version get", "要“查询版本发布/审批状态”请改用 dws dev app version status" ], "canonical_path": "dev.list_dev_app_versions", "cli_name": "list", "cli_path": "dev app version list", "confirmation": "not_required", "description": "分页查询应用版本列表", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev app version list --unified-app-id \u003cunified-app-id\u003e" ], "group": "app.version", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "list_dev_app_versions" }, "is_alias": false, "name": "list_dev_app_versions", "parameter_count": 3, "parameters": { "cursor": { "description": "游标令牌：首次查询留空，续翻传上次出参的 nextCursor", "property": "cursor", "required": false, "type": "string" }, "page-size": { "default": "20", "description": "单页条数，默认 20", "property": "pageSize", "required": false, "type": "integer" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.list_dev_app_versions", "primary_cli_path": "dev app version list", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "分页查询应用版本列表", "use_when": [ "分页查询应用版本列表" ] }, "dev.publish_dev_app_version": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "发布指定版本（含高敏权限需 --confirmed-sensitive）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“基于当前配置创建应用新版本”请改用 dws dev app version create", "要“查询指定版本详情”请改用 dws dev app version get", "要“查询版本发布/审批状态”请改用 dws dev app version status" ], "canonical_path": "dev.publish_dev_app_version", "cli_name": "publish", "cli_path": "dev app version publish", "confirmation": "not_required", "description": "发布指定版本（含高敏权限需 --confirmed-sensitive）", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app version publish --unified-app-id \u003cunifiedAppId\u003e --version-id \u003cversionId\u003e --dry-run --format json" ], "group": "app.version", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "publish_dev_app_version" }, "is_alias": false, "name": "publish_dev_app_version", "parameter_count": 4, "parameters": { "approver-user-id": { "description": "灰度选人模式下指定审批人 userId", "property": "approverUserId", "required": false, "type": "string" }, "confirmed-sensitive": { "description": "确认发布包含高敏权限的版本", "property": "confirmedSensitive", "required": false, "type": "boolean" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" }, "version-id": { "description": "版本 ID (必填)", "property": "versionId", "required": true, "type": "string" } }, "path": "dev.publish_dev_app_version", "primary_cli_path": "dev app version publish", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "发布指定版本（含高敏权限需 --confirmed-sensitive）", "use_when": [ "发布指定版本（含高敏权限需 --confirmed-sensitive）", "版本发布/审批，线上搜索、加群、路由消息以 RELEASE 为准" ] }, "dev.query_robot_create_result": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询机器人异步创建任务结果", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用的机器人（可重新启用）”请改用 dws dev app robot disable", "要“启用现有应用机器人能力（纯启用，无需配置字段）”请改用 dws dev app robot enable", "要“查询现有应用的机器人配置”请改用 dws dev app robot get" ], "canonical_path": "dev.query_robot_create_result", "cli_name": "result", "cli_path": "dev app robot result", "confirmation": "not_required", "description": "查询机器人异步创建任务结果", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev app robot result --task-id \u003ctaskId\u003e --format json" ], "group": "app.robot", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "query_robot_create_result" }, "is_alias": false, "name": "query_robot_create_result", "parameter_count": 1, "parameters": { "task-id": { "description": "提交创建任务时返回的 taskId (必填)", "property": "taskId", "required": true, "type": "string" } }, "path": "dev.query_robot_create_result", "primary_cli_path": "dev app robot result", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "查询机器人异步创建任务结果", "use_when": [ "建号：轮询结果", "查询机器人异步创建任务结果" ] }, "dev.remove_dev_app_members": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "移除开放平台应用的协作成员", "agent_summary_source": "destructive-safety-review", "availability": "available", "avoid_when": [ "要“查询开放平台应用成员”请改用 dws dev app member list", "要“添加开放平台应用成员”请改用 dws dev app member add" ], "canonical_path": "dev.remove_dev_app_members", "cli_name": "remove", "cli_path": "dev app member remove", "confirmation": "user_required", "description": "移除开放平台应用成员", "display": "开放平台开发者能力", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws dev app member remove --member-type \u003cmember-type\u003e --unified-app-id \u003cunified-app-id\u003e --user-ids \u003cuser-ids\u003e" ], "group": "app.member", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "remove_dev_app_members" }, "is_alias": false, "name": "remove_dev_app_members", "parameter_count": 3, "parameters": { "member-type": { "description": "成员类型，如 DEVELOPER (必填)", "property": "memberType", "required": true, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" }, "user-ids": { "description": "成员 userId 列表，多个用逗号分隔 (必填)", "property": "userIds", "required": true, "type": "string" } }, "path": "dev.remove_dev_app_members", "primary_cli_path": "dev app member remove", "product_id": "dev", "reviewed": true, "risk": "high", "source": "hardcoded:dev", "title": "移除开放平台应用成员", "use_when": [ "移除开放平台应用的协作成员" ] }, "dev.remove_dev_app_permissions": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "移除开放平台应用已授予的权限点", "agent_summary_source": "destructive-safety-review", "availability": "available", "avoid_when": [ "要“查询开放平台应用权限列表”请改用 dws dev app permission list", "要“申请开放平台应用权限点”请改用 dws dev app permission add" ], "canonical_path": "dev.remove_dev_app_permissions", "cli_name": "remove", "cli_path": "dev app permission remove", "confirmation": "user_required", "description": "取消开放平台应用权限点", "display": "开放平台开发者能力", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws dev app permission remove --scope-values \u003cscope-values\u003e --unified-app-id \u003cunified-app-id\u003e" ], "group": "app.permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "remove_dev_app_permissions" }, "is_alias": false, "name": "remove_dev_app_permissions", "parameter_count": 2, "parameters": { "scope-values": { "description": "待取消权限点 scopeValue，多个用逗号或分号分隔", "property": "scopeValues", "required": true, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.remove_dev_app_permissions", "primary_cli_path": "dev app permission remove", "product_id": "dev", "reviewed": true, "risk": "high", "source": "hardcoded:dev", "title": "取消开放平台应用权限点", "use_when": [ "移除开放平台应用已授予的权限点" ] }, "dev.search_open_platform_docs_rag": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "搜索开放平台文档", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“搜索开放平台文档”" ], "canonical_path": "dev.search_open_platform_docs_rag", "cli_name": "search", "cli_path": "dev doc search", "confirmation": "not_required", "description": "根据关键词搜索钉钉开放平台的开发文档，返回匹配的文档条目列表，包含标题、摘要、文档链接和相关标签。搜索结果按相关性排序。适用于开发者在集成或调试过程中快速查找 API 说明、接入指南、错误码解释等技术资料。", "display": "开放平台开发者能力", "effect": "read", "effect_source": "command-verb", "examples": [ "dws dev doc search --query \u003cquery\u003e" ], "group": "doc", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devdoc", "rpc_name": "search_open_platform_docs" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_open_platform_docs_rag", "parameter_count": 3, "parameters": { "page": { "default": "1", "description": "页码，默认 1", "interface_description": "分页页码", "interface_type": "number", "property": "page", "required": false, "type": "string" }, "query": { "description": "搜索关键词 (必填)", "property": "query", "required": true, "type": "string" }, "size": { "default": "10", "description": "每页数量，默认 10", "interface_description": "分页大小", "interface_type": "number", "property": "size", "required": false, "type": "string" } }, "path": "dev.search_open_platform_docs_rag", "primary_cli_path": "dev doc search", "product_id": "dev", "reviewed": true, "risk": "low", "source": "hardcoded:dev", "title": "search_open_platform_docs", "use_when": [ "搜索开放平台文档" ] }, "dev.set_extension_robot_config": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建或更新现有应用的机器人配置（upsert）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用的机器人（可重新启用）”请改用 dws dev app robot disable", "要“启用现有应用机器人能力（纯启用，无需配置字段）”请改用 dws dev app robot enable", "要“查询现有应用的机器人配置”请改用 dws dev app robot get" ], "canonical_path": "dev.set_extension_robot_config", "cli_name": "config", "cli_path": "dev app robot config", "confirmation": "not_required", "description": "创建或更新现有应用的机器人配置（upsert）", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app robot config --unified-app-id \u003cunifiedAppId\u003e --name \"小助手\" --desc \"接 opencode\" --dry-run --format json" ], "group": "app.robot", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "set_extension_robot_config" }, "is_alias": false, "name": "set_extension_robot_config", "parameter_count": 14, "parameters": { "add-scope": { "description": "是否自动添加机器人相关权限", "property": "addScope", "required": false, "type": "boolean" }, "brief": { "description": "机器人简介", "property": "brief", "required": false, "type": "string" }, "desc": { "description": "机器人描述", "property": "desc", "required": false, "type": "string" }, "disable-ssl-verify": { "description": "回调地址是否关闭 SSL 校验", "property": "disableSslVerify", "required": false, "type": "boolean" }, "event-callback-url": { "description": "事件回调地址", "property": "eventCallbackUrl", "required": false, "type": "string" }, "i18n-brief": { "description": "机器人简介国际化 JSON", "property": "i18nBrief", "required": false, "type": "string" }, "i18n-description": { "description": "机器人描述国际化 JSON", "property": "i18nDescription", "required": false, "type": "string" }, "i18n-name": { "description": "机器人名称国际化 JSON，如 '{\"en_US\":\"Bot\"}'", "property": "i18nName", "required": false, "type": "string" }, "icon-media-id": { "description": "机器人图标 mediaId", "property": "iconMediaId", "required": false, "type": "string" }, "mode": { "description": "机器人模式：HTTPS / STREAM / AISKILL", "property": "mode", "required": false, "type": "string" }, "name": { "description": "机器人名称", "property": "name", "required": true, "type": "string" }, "outgoing-url": { "description": "消息回调地址", "property": "outgoingUrl", "required": false, "type": "string" }, "skills": { "description": "技能列表，多个用逗号或分号分隔", "property": "skills", "required": false, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.set_extension_robot_config", "primary_cli_path": "dev app robot config", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "创建或更新现有应用的机器人配置（upsert）", "use_when": [ "创建/更新机器人配置（upsert）", "创建或更新现有应用的机器人配置（upsert）", "在明确的 unifiedAppId 上配置机器人能力" ] }, "dev.set_extension_webapp_config": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "配置网页应用能力", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“查询网页应用配置”请改用 dws dev app webapp get" ], "canonical_path": "dev.set_extension_webapp_config", "cli_name": "config", "cli_path": "dev app webapp config", "confirmation": "not_required", "description": "配置网页应用能力", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app webapp config --homepage-url \u003chomepage-url\u003e --unified-app-id \u003cunified-app-id\u003e" ], "group": "app.webapp", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "set_extension_webapp_config" }, "is_alias": false, "name": "set_extension_webapp_config", "parameter_count": 5, "parameters": { "h5-page-type": { "description": "网页应用生效端/页面类型", "property": "h5PageType", "required": false, "type": "string" }, "homepage-url": { "description": "移动端首页地址", "property": "homepageUrl", "required": true, "type": "string" }, "omp-url": { "description": "管理后台地址", "property": "ompUrl", "required": false, "type": "string" }, "pc-homepage-url": { "description": "PC 端首页地址", "property": "pcHomepageUrl", "required": false, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.set_extension_webapp_config", "primary_cli_path": "dev app webapp config", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "配置网页应用能力", "use_when": [ "配置网页应用能力" ] }, "dev.submit_robot_create_task": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "异步提交钉钉智能体机器人创建任务（支持失败重试）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用的机器人（可重新启用）”请改用 dws dev app robot disable", "要“启用现有应用机器人能力（纯启用，无需配置字段）”请改用 dws dev app robot enable", "要“查询现有应用的机器人配置”请改用 dws dev app robot get" ], "canonical_path": "dev.submit_robot_create_task", "cli_name": "submit", "cli_path": "dev app robot submit", "confirmation": "not_required", "description": "异步提交钉钉智能体机器人创建任务（支持失败重试）", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app robot submit --name \u003c智能体名\u003e --robot-name \u003c机器人名\u003e --desc \u003c描述\u003e --dry-run --format json" ], "group": "app.robot", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "submit_robot_create_task" }, "is_alias": false, "name": "submit_robot_create_task", "parameter_count": 6, "parameters": { "desc": { "description": "机器人功能描述，不超过 200 字 (必填)", "property": "desc", "required": true, "type": "string" }, "icon-media-id": { "description": "机器人图标 mediaId；为空时使用默认图标", "property": "iconMediaId", "required": false, "type": "string" }, "name": { "description": "智能体应用名称，长度 2-20，企业内唯一 (必填)", "property": "name", "required": true, "type": "string" }, "preview-media-id": { "description": "机器人预览图 mediaId；为空时复用图标", "property": "previewMediaId", "required": false, "type": "string" }, "robot-name": { "description": "承载机器人名称，用于客户端展示 (必填)", "property": "robotName", "required": true, "type": "string" }, "task-id": { "description": "失败重试时传入原 taskId；为空时服务端自动生成", "property": "taskId", "required": false, "type": "string" } }, "path": "dev.submit_robot_create_task", "primary_cli_path": "dev app robot submit", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "异步提交钉钉智能体机器人创建任务（支持失败重试）", "use_when": [ "建号：异步提交", "异步提交钉钉智能体机器人创建任务（支持失败重试）" ] }, "dev.subscribe_dev_app_events": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "订阅应用事件回调", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“取消订阅应用事件”请改用 dws dev app event unsubscribe", "要“查询应用已订阅的事件列表”请改用 dws dev app event list" ], "canonical_path": "dev.subscribe_dev_app_events", "cli_name": "subscribe", "cli_path": "dev app event subscribe", "confirmation": "not_required", "description": "订阅应用事件回调", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app event subscribe --unified-app-id \u003cunifiedAppId\u003e --event-codes \u003ccode1\u003e,\u003ccode2\u003e --dry-run --format json" ], "group": "app.event", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "subscribe_dev_app_events" }, "is_alias": false, "name": "subscribe_dev_app_events", "parameter_count": 2, "parameters": { "event-codes": { "description": "事件码，多个用逗号或分号分隔", "property": "eventCodes", "required": true, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.subscribe_dev_app_events", "primary_cli_path": "dev app event subscribe", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "订阅应用事件回调", "use_when": [ "订阅应用事件回调" ] }, "dev.unsubscribe_dev_app_events": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "取消订阅应用事件", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“查询应用已订阅的事件列表”请改用 dws dev app event list", "要“订阅应用事件回调”请改用 dws dev app event subscribe" ], "canonical_path": "dev.unsubscribe_dev_app_events", "cli_name": "unsubscribe", "cli_path": "dev app event unsubscribe", "confirmation": "not_required", "description": "取消订阅应用事件", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app event unsubscribe --event-codes \u003cevent-codes\u003e --unified-app-id \u003cunified-app-id\u003e" ], "group": "app.event", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "unsubscribe_dev_app_events" }, "is_alias": false, "name": "unsubscribe_dev_app_events", "parameter_count": 2, "parameters": { "event-codes": { "description": "事件码，多个用逗号或分号分隔", "property": "eventCodes", "required": true, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.unsubscribe_dev_app_events", "primary_cli_path": "dev app event unsubscribe", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "取消订阅应用事件", "use_when": [ "取消订阅应用事件" ] }, "dev.update_dev_app": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/dev.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "修改开放平台企业内部应用基础信息", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“停用开放平台应用，停用后应用能力对外不可用（可重新启用）”请改用 dws dev app disable", "要“创建开放平台企业内部应用”请改用 dws dev app create", "要“删除开放平台企业内部应用（不可逆，需 --confirm-nam”请改用 dws dev app delete" ], "canonical_path": "dev.update_dev_app", "cli_name": "update", "cli_path": "dev app update", "confirmation": "not_required", "description": "修改开放平台企业内部应用基础信息", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app update --unified-app-id \u003cunifiedAppId\u003e --name \u003c新名称\u003e --dry-run --format json" ], "group": "app", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "update_dev_app" }, "is_alias": false, "name": "update_dev_app", "parameter_count": 4, "parameters": { "desc": { "description": "新的应用描述", "property": "desc", "required": false, "type": "string" }, "icon-media-id": { "description": "新的应用图标 mediaId", "property": "iconMediaId", "required": false, "type": "string" }, "name": { "description": "新的应用名称", "property": "name", "required": true, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.update_dev_app", "primary_cli_path": "dev app update", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "修改开放平台企业内部应用基础信息", "use_when": [ "修改开放平台企业内部应用基础信息", "更新应用信息（写操作：先 --dry-run 预览，确认后加 --yes 执行；不加 --yes 会被拦下）" ] }, "dev.update_dev_app_security_config": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "更新开放平台应用安全配置", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新开放平台应用安全配置”所述变更时不要使用" ], "canonical_path": "dev.update_dev_app_security_config", "cli_name": "config", "cli_path": "dev app security config", "confirmation": "not_required", "description": "更新开放平台应用安全配置", "display": "开放平台开发者能力", "effect": "write", "effect_source": "command-verb", "examples": [ "dws dev app security config --redirect-urls \u003credirect-urls\u003e --unified-app-id \u003cunified-app-id\u003e" ], "group": "app.security", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "devapp", "rpc_name": "update_dev_app_security_config" }, "is_alias": false, "name": "update_dev_app_security_config", "parameter_count": 4, "parameters": { "ip-whitelist": { "description": "出口 IP 白名单，多个用逗号或分号分隔（整组覆盖，非追加）", "property": "ipWhitelist", "required": false, "type": "string" }, "redirect-urls": { "description": "登录重定向 URL，多个用逗号或分号分隔（整组覆盖，非追加）", "property": "redirectUrls", "required": true, "type": "string" }, "sso-urls": { "description": "端内免登地址，多个用逗号或分号分隔（整组覆盖，非追加）", "property": "ssoUrls", "required": false, "type": "string" }, "unified-app-id": { "description": "开放平台统一应用 ID（必填）", "property": "unifiedAppId", "required": true, "type": "string" } }, "path": "dev.update_dev_app_security_config", "primary_cli_path": "dev app security config", "product_id": "dev", "reviewed": true, "risk": "medium", "source": "hardcoded:dev", "title": "更新开放平台应用安全配置", "use_when": [ "更新开放平台应用安全配置" ] }, "devdoc.search_open_platform_docs_rag": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.devdoc.prod.json#devdoc.search_open_platform_docs", "skills/mono/references/products/devdoc.md", "skills/mono/references/products/simple.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "按关键词搜索 open.dingtalk.com 开放平台文档", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“按关键词检索钉钉开放平台文档，只返回参考资料、参考资料链接和RA”请改用 dws devdoc article rag-pretest", "要“根据关键词搜索钉钉开放平台的开发文档，返回匹配的文档条目列表，包”请改用 dws devdoc article legacy-search", "要“根据关键词搜索钉钉开放平台的开发文档，返回匹配的文档条目列表，包”请改用 dws devdoc article legacy-search-open-platform" ], "canonical_path": "devdoc.search_open_platform_docs_rag", "cli_name": "search", "cli_path": "devdoc article search", "confirmation": "not_required", "description": "根据关键词搜索钉钉开放平台的开发文档，返回匹配的文档条目列表，包含标题、摘要、文档链接和相关标签。搜索结果按相关性排序。适用于开发者在集成或调试过程中快速查找 API 说明、接入指南、错误码解释等技术资料。", "display": "开放平台文档搜索", "effect": "read", "effect_source": "command-verb", "examples": [ "dws devdoc article search --query \"OAuth2 接入\"", "dws devdoc article search --query \"消息卡片\" --page 2 --size 5" ], "group": "article", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "devdoc", "rpc_name": "search_open_platform_docs" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_open_platform_docs_rag", "parameter_count": 3, "parameters": { "page": { "default": "1", "description": "页码，默认 1", "interface_description": "分页页码", "interface_type": "number", "property": "page", "required": false, "type": "string" }, "query": { "description": "搜索关键词 (必填)", "property": "query", "required": true, "type": "string" }, "size": { "default": "10", "description": "每页数量，默认 10", "interface_description": "分页大小", "interface_type": "number", "property": "size", "required": false, "type": "string" } }, "path": "devdoc.search_open_platform_docs_rag", "primary_cli_path": "devdoc article search", "product_id": "devdoc", "risk": "low", "source": "hardcoded:devdoc", "title": "search_open_platform_docs", "use_when": [ "命中结果多时翻页", "开发文档/API 文档/接口文档", "开发者问\"OAuth2 怎么接", "查错误码 / 字段含义" ] }, "ding.recall_ding_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.ding.prod.json#ding.recall_ding_message", "skills/mono/SKILL.md", "skills/mono/references/intent-guide.md", "skills/mono/references/products/ding.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "撤回 DING 消息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“发送 DING 消息（应用内 / 短信 / 电话）”请改用 dws ding message send" ], "canonical_path": "ding.recall_ding_message", "cli_name": "recall", "cli_path": "ding message recall", "confirmation": "user_required", "description": "撤回已发送的DING消息", "display": "DING 消息 / 发送 / 撤回", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws ding message recall --robot-code \u003cROBOT_CODE\u003e --id \u003cOPEN_DING_ID\u003e", "dws ding message recall --robot-code \u003cROBOT_CODE\u003e --id \u003cOPEN_DING_ID\u003e --format json" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "ding", "rpc_name": "recall_ding_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "recall_ding_message", "parameter_count": 2, "parameters": { "id": { "description": "DING 消息 ID (必填)", "interface_description": "要撤回的钉钉消息ID，可通过发送DING消息接口获取", "property": "openDingId", "required": true, "type": "string" }, "robot-code": { "description": "机器人 ID (必填，或设 DINGTALK_DING_ROBOT_CODE)", "interface_description": "发送钉钉消息的机器人ID，必须与发送消息的机器人为同一个", "property": "robotCode", "required": true, "type": "string" } }, "path": "ding.recall_ding_message", "primary_cli_path": "ding message recall", "product_id": "ding", "risk": "high", "source": "runtime:ding", "title": "撤回已发送的DING消息", "use_when": [ "撤回 DING", "撤回DING；撤回 DING 消息", "机器人身份: 撤回" ] }, "ding.send_ding_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.ding.prod.json#ding.send_ding_message", "skills/mono/references/intent-guide.md", "skills/mono/references/products/ding.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "发送 DING 消息（应用内 / 短信 / 电话）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“撤回 DING 消息”请改用 dws ding message recall" ], "canonical_path": "ding.send_ding_message", "cli_name": "send", "cli_path": "ding message send", "confirmation": "not_required", "description": "发送 DING 消息给指定用户，支持配置机器人编码、接收人、提醒类型和消息内容。", "display": "DING 消息 / 发送 / 撤回", "effect": "write", "effect_source": "command-verb", "examples": [ "dws ding message send --robot-code \u003cROBOT_CODE\u003e --users \u003cUSER_ID_1\u003e,\u003cUSER_ID_2\u003e --content \"请查看\"", "dws ding message send --robot-code \u003cROBOT_CODE\u003e --type app --users userId1,userId2 --content \"请查看\" --format json" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "ding", "rpc_name": "send_ding_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "send_ding_message", "parameter_count": 4, "parameters": { "content": { "description": "DING 消息内容。", "interface_description": "消息内容", "property": "content", "required": true, "type": "string" }, "robot-code": { "description": "DING 机器人编码。通常来自开放平台或应用机器人配置。", "interface_description": "机器人Code", "property": "robotCode", "required": true, "type": "string" }, "type": { "default": "app", "description": "提醒类型。CLI 默认使用 app，对应应用内提醒。", "interface_description": "提醒类型，1：应用内钉钉，2：短信，3：电话", "interface_type": "number", "property": "remindType", "required": false, "type": "string" }, "users": { "description": "接收人的 userId 列表。CLI 使用逗号分隔，例如 user1,user2。", "interface_description": "接收者用户ID列表", "interface_type": "array", "property": "receiverUserIdList", "required": true, "type": "string" } }, "path": "ding.send_ding_message", "primary_cli_path": "ding message send", "product_id": "ding", "risk": "medium", "source": "runtime:ding", "title": "发送DING消息", "use_when": [ "DING 一下/紧急通知/电话提醒", "发DING/DING通知；发送 DING 消息", "机器人身份: 应用内 DING (免费)", "机器人身份: 电话 DING (紧急, 有成本!)" ] }, "doc.add_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-permission.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“从知识库节点移除指定企业用户的权限（仅支持 USER 类型）”请改用 dws doc permission remove", "要“修改企业用户在知识库节点上的角色（仅支持 USER 类型）”请改用 dws doc permission update", "要“查询知识库节点当前的成员权限列表”请改用 dws doc permission list" ], "canonical_path": "doc.add_permission", "cli_name": "add", "cli_path": "doc permission add", "confirmation": "not_required", "description": "为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量授予企业用户对节点的访问权限，添加成功后即可按指定角色访问该节点及其子节点（若子节点继承权限）。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口添加。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。\r\n- 入参直接采用扁平的 `userIds: List\u003cString\u003e`，每个元素为钉钉 staffId（外部 userId 格式，由钉钉开放平台体系下颁发）。如果你只有 unionId，请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc permission add --node \u003cDOC_ID\u003e --users uid1 --role READER", "dws doc permission add --node \u003cDOC_ID\u003e --users uid1,uid2 --role EDITOR" ], "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "add_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_permission", "parameter_count": 4, "parameters": { "node": { "description": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)", "property": "node", "required": true, "type": "string" }, "role": { "description": "权限角色: MANAGER / EDITOR / DOWNLOADER / READER (必填，大小写不敏感)", "property": "role", "required": true, "type": "string" }, "users": { "description": "被授权的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)", "property": "users", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）", "property": "workspace", "required": false, "type": "string" } }, "path": "doc.add_permission", "primary_cli_path": "doc permission add", "product_id": "doc", "reviewed": false, "risk": "medium", "source": "hardcoded:doc", "title": "添加节点成员", "use_when": [ "给单人开 READER 权限", "给多人开 EDITOR 权限（最多 30 个 uid）", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\u003e - \"把某篇文档授权给某人", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；新增权限", "设为管理者", "通过 alidocs URL 直接授权" ] }, "doc.copy_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-file-ops.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "将指定节点复制到目标文件夹。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“将指定节点复制到目标文件夹。”所述变更时不要使用" ], "canonical_path": "doc.copy_document", "cli_name": "copy", "cli_path": "doc copy", "confirmation": "not_required", "description": "将指定节点复制到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时复制到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有可查看下载权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：复制操作底层可能异步执行，异步时操作已提交但新节点 ID 无法立即返回，请稍后查看目标文件夹确认结果。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc copy --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e", "dws doc copy --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "copy_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "copy_document", "parameter_count": 3, "parameters": { "folder": { "description": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "property": "folder", "required": false, "type": "string" }, "node": { "description": "文档/文件 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL (不传 --folder 时复制到该知识库根目录)", "property": "workspace", "required": false, "type": "string" } }, "path": "doc.copy_document", "primary_cli_path": "doc copy", "product_id": "doc", "reviewed": false, "risk": "medium", "source": "hardcoded:doc", "title": "将指定节点复制到目标文件夹", "use_when": [ "复制到指定文件夹（异步）", "复制到目标知识库根目录", "复制到目标知识库根目录（不传 --folder 时）", "复制文档/拷贝一份/复制到；复制", "复制文档到指定文件夹（--node 支持 ID 或 URL）" ] }, "doc.create_comment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_comment", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-comment.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建文档评论", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“回复文档评论”请改用 dws doc comment reply", "要“在钉钉文档中创建划词评论，评论关联文档内指定块的文本范围，支持”请改用 dws doc comment create-inline", "要“查询文档评论列表”请改用 dws doc comment list" ], "canonical_path": "doc.create_comment", "cli_name": "create", "cli_path": "doc comment create", "confirmation": "not_required", "description": "在钉钉文档中创建全文评论，评论不关联文档内具体位置，支持 @提及用户。\r\n\r\n通过 nodeId 定位文档，支持传入文档链接 URL 或文档 ID（dentryUuid）。\r\n- @提及用户：填写 mentionedUserIds，被提及用户会收到通知。\r\n如需创建划词评论（关联文档内指定文本范围），请使用 create_inline_comment 工具。\r\n如需回复已有评论，请使用 reply_comment 工具。\r\n操作受权限控制，仅当调用者对文档有评论权限时可创建评论。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc comment create --node \u003cDOC_ID\u003e --content \"这里需要修改\"", "dws doc comment create --node \u003cDOC_ID\u003e --content \"请review\" --mention uid1,uid2" ], "group": "comment", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc-comment", "rpc_name": "create_comment" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_comment", "parameter_count": 3, "parameters": { "content": { "description": "评论的文字内容，纯文本 (必填)", "interface_description": "评论的文字内容，纯文本格式。必填。", "property": "content", "required": true, "type": "string" }, "mention": { "description": "被 @ 的用户 uid 列表，逗号分隔", "property": "mention", "required": false, "type": "string" }, "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "property": "node", "required": true, "type": "string" } }, "path": "doc.create_comment", "primary_cli_path": "doc comment create", "product_id": "doc", "risk": "medium", "source": "hardcoded:doc", "title": "创建全文评论", "use_when": [ "2. 在文档上创建评论", "再将 userId 传入 --mention", "创建全文评论", "提取 userId 后:" ] }, "doc.create_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_document", "skills/mono/references/intent-guide.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-create.md", "skills/mono/references/products/doc/doc-media.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "创建一篇新的在线文档", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "在知识库里创建一个文档；创建空文件实体" ], "canonical_path": "doc.create_document", "cli_name": "create", "cli_path": "doc create", "confirmation": "not_required", "description": "创建一篇文字类型的钉钉在线文档（扩展名=adoc）。\r\n支持创建空文档或带有初始 Markdown 内容的文档。（如需创建钉钉AI表格、钉钉表格、钉钉脑图等其他类型的文件，使用 create_file 工具）\r\n支持三种创建位置：\r\n1. 指定 folderId：在该文件夹下创建\r\n2. 指定 workspaceId（知识库 ID）但不传 folderId：在该知识库的根目录下创建\r\n3. 都不传：在用户\"我的文档\"根目录下创建\r\n操作受权限控制，仅当调用者对目标位置有写入权限时可成功创建。\r\n内容长度上限 10000 字符，超出请使用 update_document 工具分批追加写入。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc create --help", "dws doc create --name \"项目周报\"" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "create_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_document", "parameter_count": 7, "parameters": { "content": { "description": "文档初始内容（短文本字面量）；传 - 表示从 stdin 读取", "property": "content", "required": false, "type": "string" }, "content-file": { "description": "从文件读取文档内容（UTF-8）。推荐长/多行/表格内容使用", "property": "contentFile", "required": false, "type": "string" }, "content-format": { "description": "内容格式: 默认为 markdown，可选 jsonml", "property": "contentFormat", "required": false, "type": "string" }, "fix-jsonml": { "description": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用", "property": "fixJsonml", "required": false, "type": "boolean" }, "folder": { "description": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "property": "folder", "required": false, "type": "string" }, "name": { "description": "文档名称 (必填)", "interface_description": "新文档的标题，必填。", "property": "name", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID", "property": "workspace", "required": false, "type": "string" } }, "path": "doc.create_document", "primary_cli_path": "doc create", "product_id": "doc", "risk": "medium", "source": "hardcoded:doc", "title": "创建钉钉文档", "use_when": [ "1. 创建空文档拿 nodeId", "2. 一步创建+写入：", "2. 创建文档 — 提取 nodeId", "5. 完整流程: 创建文档 → 写入内容 → 插入附件", "JSONML 创建到指定文件夹", "写文档/创建文档；新建文字文档（adoc）", "创建到指定文件夹", "创建到知识库", "创建空文档（仅取 nodeId 后再分步写入，适合 \u003e200KB 兜底）", "完整流程：创建文档 → 写入内容 → 插入附件", "查看具体命令的完整参数说明", "短纯文本字面量（\u003c 2KB 且无换行/表格才允许）", "详见 doc-create-workflow.md §JSONML 起稿判定", "默认创建到「我的文档」根目录（推荐文件路径）" ] }, "doc.create_file": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_file", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建文件（文档/表格/脑图/白板/多维表/文件夹等）”所述变更时不要使用" ], "canonical_path": "doc.create_file", "cli_name": "create", "cli_path": "doc file create", "confirmation": "not_required", "description": "在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表或文件夹）。\r\n\r\n支持三种创建位置（按优先级）：\r\n1. 指定 folderId：在该文件夹下创建\r\n2. 仅指定 workspaceId（不传 folderId）：在该知识库的根目录下创建\r\n3. 都不传：在用户\"我的文档\"根目录下创建\r\n4. type 要创建的文件类型，必填。支持以下值：adoc（钉钉在线文档）、axls（钉钉表格）、appt（钉钉演示）、adraw（钉钉白板）、amind（钉钉脑图）、able（钉钉多维表）、folder（文件夹）\r\n操作受权限控制，仅当调用者对目标位置有写入权限时可成功创建。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc file create --name \"项目周报\" --type adoc", "dws doc file create --name \"数据统计\" --type axls --folder FOLDER_ID" ], "group": "file", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "create_file" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_file", "parameter_count": 4, "parameters": { "folder": { "description": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "property": "folder", "required": false, "type": "string" }, "name": { "description": "文件名称 (必填)", "interface_description": "新文件的名称，必填。", "property": "name", "required": true, "type": "string" }, "type": { "description": "文件类型: adoc/axls/appt/adraw/amind/able/folder (必填)", "interface_description": "要创建的文件类型，必填。支持：adoc（钉钉在线文档）、axls（钉钉表格）、appt（钉钉演示）、adraw（钉钉白板）、amind（钉钉脑图）、able（钉钉多维表）、folder（文件夹）。同时兼容旧版 accessType 数字字符串：\"0\"=adoc、\"1\"=axls、\"2\"=appt、\"3\"=adraw、\"6\"=amind、\"7\"=able、\"13\"=folder。", "property": "type", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL", "property": "workspace", "required": false, "type": "string" } }, "path": "doc.create_file", "primary_cli_path": "doc file create", "product_id": "doc", "risk": "medium", "source": "hardcoded:doc", "title": "创建节点", "use_when": [ "创建文件（文档/表格/脑图/白板/多维表/文件夹等）" ] }, "doc.create_folder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_folder", "skills/mono/references/products/doc/doc-file-ops.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "创建文件夹", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建文件夹”所述变更时不要使用" ], "canonical_path": "doc.create_folder", "cli_name": "create", "cli_path": "doc folder create", "confirmation": "not_required", "description": "在指定位置创建一个新的文件夹。\r\n\r\n支持在文件夹下或知识库下创建子文件夹。\r\n创建后返回新文件夹的节点 ID，可用于后续在该文件夹下创建文档或子文件夹。\r\n操作受权限控制，仅当调用者对父节点有写入权限时可成功创建。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc folder create --name \"项目资料\"", "dws doc folder create --name \"子文件夹\" --folder \u003cPARENT_DOC_FOLDER_NODE_ID\u003e" ], "group": "folder", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "create_folder" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_folder", "parameter_count": 3, "parameters": { "folder": { "description": "父文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "property": "folder", "required": false, "type": "string" }, "name": { "description": "文件夹名称 (必填)", "interface_description": "新文件夹的名称，必填。", "property": "name", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID", "property": "workspace", "required": false, "type": "string" } }, "path": "doc.create_folder", "primary_cli_path": "doc folder create", "product_id": "doc", "risk": "medium", "source": "hardcoded:doc", "title": "创建文件夹", "use_when": [ "在「我的文档」根目录创建", "在指定父文件夹下创建", "在知识库下创建" ] }, "doc.create_inline_comment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-comment.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "在钉钉文档中创建划词评论，评论关联文档内指定块的文本范围，支持 @提及用户。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建文档评论”请改用 dws doc comment create", "要“回复文档评论”请改用 dws doc comment reply", "要“查询文档评论列表”请改用 dws doc comment list" ], "canonical_path": "doc.create_inline_comment", "cli_name": "create-inline", "cli_path": "doc comment create-inline", "confirmation": "not_required", "description": "在钉钉文档中创建划词评论，评论关联文档内指定块的文本范围，支持 @提及用户。\r\n\r\n通过 nodeId 定位文档，支持传入文档链接 URL 或文档 ID（dentryUuid）。\r\n- blockId、start、end 均为必填，用于定位评论标记的文本范围。\r\n- selectedText 可选填，填写后评论列表中会展示「引用原文：xxx」。\r\n- @提及用户：填写 mentionedUserIds，被提及用户会收到通知。\r\n如需创建全文评论（不关联文档内具体位置），请使用 create_comment 工具。\r\n如需回复已有评论，请使用 reply_comment 工具。\r\n操作受权限控制，仅当调用者对文档有评论权限时可创建评论。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc comment create-inline --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --start 0 --end 10 --content \"这里需要修改\"", "dws doc comment create-inline --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --start 5 --end 20 --content \"建议调整\" --selected-text \"被选中的原文\"" ], "group": "comment", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc-comment", "rpc_name": "create_inline_comment" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_inline_comment", "parameter_count": 7, "parameters": { "block-id": { "description": "评论标记所在的块 ID，可通过 dws doc block list 获取 (必填)", "interface_description": "评论标记所在的块 ID。必填。", "property": "blockId", "required": true, "type": "string" }, "content": { "description": "评论的文字内容，纯文本 (必填)", "interface_description": "评论的文字内容，纯文本格式。必填。", "property": "content", "required": true, "type": "string" }, "end": { "description": "评论标记在块内文本中的结束字符偏移量，必须大于 start (必填)", "interface_description": "评论标记在块内文本中的结束字符偏移量，必须大于 start。必填。", "interface_type": "number", "property": "end", "required": true, "type": "integer" }, "mention": { "description": "被 @ 的用户 uid 列表，逗号分隔", "property": "mention", "required": false, "type": "string" }, "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "property": "node", "required": true, "type": "string" }, "selected-text": { "description": "选中文本的内容，填写后评论列表中会展示「引用原文：xxx」", "interface_description": "可选填。填写后，评论列表中会展示「引用原文：xxx」。建议传入选中文本的完整内容或前100个字符。", "property": "selectedText", "required": false, "type": "string" }, "start": { "description": "评论标记在块内文本中的起始字符偏移量，从 0 开始 (必填)", "interface_description": "评论标记在块内文本中的起始字符偏移量（从 0 开始）。必填。", "interface_type": "number", "property": "start", "required": true, "type": "integer" } }, "path": "doc.create_inline_comment", "primary_cli_path": "doc comment create-inline", "product_id": "doc", "reviewed": false, "risk": "medium", "source": "hardcoded:doc", "title": "创建划词评论", "use_when": [ "7. 创建划词评论并附带引用原文 + @ 相关人", "划词评论 + 引用原文 + @人", "确定选中文本在块内的起始偏移量 (start) 和结束偏移量 (end)", "计算偏移后：" ] }, "doc.delete_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document", "skills/mono/SKILL.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-file-ops.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "用户未明确要求“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。”、目标不清楚或尚未确认时不要使用" ], "canonical_path": "doc.delete_document", "cli_name": "delete", "cli_path": "doc delete", "confirmation": "user_required", "description": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。\r\n\r\n支持范围：\r\n- 知识库（workspace）下的文档节点、文件夹节点\r\n- 钉盘「我的文件」或「团队空间（space）」下的文件、文件夹节点（但钉盘操作仍建议走钉盘MCP服务）\r\n\r\n不支持的操作：\r\n- 不支持直接删除知识库本身（workspace）\r\n- 不支持直接删除团队空间（space）\r\n\r\n权限要求：\r\n- 对目标节点有管理权限（owner 或被授予管理权限的成员）\r\n\r\n注意事项：\r\n- 删除操作不可立即撤销，请在调用前向用户确认\r\n- 删除文件夹时，文件夹内的所有子节点也会一并移入回收站", "display": "钉钉文档管理", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws doc delete --node \u003cDOC_ID\u003e --format json # 查询 nodeId: dws drive search --query \"...\" 或 dws drive list" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "delete_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_document", "parameter_count": 1, "parameters": { "node": { "description": "文档/文件 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" } }, "path": "doc.delete_document", "primary_cli_path": "doc delete", "product_id": "doc", "reviewed": false, "risk": "high", "source": "hardcoded:doc", "title": "删除节点", "use_when": [ "── delete（用户确认后才加 --yes）──", "删除文档/删掉这个文件/移到回收站/丢掉这篇文档；删除节点", "正确流程：1.向用户展示\"即将删除「文档名」到回收站\" → 2.等用户确认 → 3.执行下面命令" ] }, "doc.delete_document_block": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.delete_document_block", "skills/mono/SKILL.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-block.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除块元素（不可逆）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“将一个新的块元素插入指定文档，需要提供文档ID(dentryUu”请改用 dws doc block insert", "要“更新指定文档的指定块元素内容或样式，需要提供文档ID(dentr”请改用 dws doc block update", "要“查询文档一级块元素列表”请改用 dws doc block list" ], "canonical_path": "doc.delete_document_block", "cli_name": "delete", "cli_path": "doc block delete", "confirmation": "user_required", "description": "在指定文档中删除指定块元素，需要提供文档ID(dentryUuid)与块元素ID(blockId)。操作受文档权限控制，仅当调用者拥有编辑权限时生效。", "display": "钉钉文档管理", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws doc block delete --block-id \u003cblock-id\u003e --node \u003cnode\u003e" ], "group": "block", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "delete_document_block" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_document_block", "parameter_count": 2, "parameters": { "block-id": { "description": "目标块 ID (必填)", "interface_description": "待删除块元素的唯一标识。可通过 list_document_blocks 工具查询获取（返回结果中的 blockId 字段）。目前仅支持根目录下的第一级块元素的 blockId。必填。", "property": "blockId", "required": true, "type": "string" }, "node": { "description": "文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" } }, "path": "doc.delete_document_block", "primary_cli_path": "doc block delete", "product_id": "doc", "risk": "high", "source": "hardcoded:doc", "title": "删除块元素", "use_when": [ "5. 删除块", "删除（无需 format 区分）", "删除（用户确认后）", "编辑块/改段落/插入标题/删除块；删除" ] }, "doc.download_doc_attachment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-media.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取钉钉文档中指定附件的临时下载 URL。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“上传本地文件并作为附件插入文档（3 步合一：prepare +”请改用 dws doc media insert" ], "canonical_path": "doc.download_doc_attachment", "cli_name": "download", "cli_path": "doc media download", "confirmation": "not_required", "description": "获取钉钉文档中指定附件的临时下载 URL。\r\n传入文档标识 nodeId 和附件资源标识 resourceId，返回附件的 OSS 临时下载链接 downloadUrl。\r\n前置依赖：需先调用 list_document_blocks 获取文档块列表，从中找到 blockType 为 attachment 的块元素，提取其 resourceId 作为本工具的入参。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc media download --node \u003cDOC_ID\u003e --resource-id \u003cRESOURCE_ID\u003e", "dws doc media download --node \"https://alidocs.dingtalk.com/i/nodes/xxx\" --resource-id \u003cRESOURCE_ID\u003e" ], "group": "media", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "download_doc_attachment" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "download_doc_attachment", "parameter_count": 2, "parameters": { "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "property": "node", "required": true, "type": "string" }, "resource-id": { "description": "附件资源 ID，可通过 dws doc block list 获取 (必填)", "interface_description": "附件的资源ID", "property": "resourceId", "required": true, "type": "string" } }, "path": "doc.download_doc_attachment", "primary_cli_path": "doc media download", "product_id": "doc", "reviewed": false, "risk": "low", "source": "hardcoded:doc", "title": "下载指定钉钉文档中的指定附件", "use_when": [ "下载文件/导出文件/下载到本地；下载", "下载文档中的附件（resourceId 从 block list 获取）", "下载附件/获取附件/取出文档里的附件；下载附件" ] }, "doc.download_file": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.download_file", "skills/mono/references/products/doc/doc-file-ops.md", "skills/mono/references/products/sheet.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取文件下载凭证，供 AI Agent 自行发起 HTTP GET 请求下载文件内容。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取文件下载凭证，供 AI Agent 自行发起 HTTP GET 请求下载文件内容。”" ], "canonical_path": "doc.download_file", "cli_name": "download", "cli_path": "doc download", "confirmation": "not_required", "description": "获取文件下载凭证，供 AI Agent 自行发起 HTTP GET 请求下载文件内容。本工具是两步下载流程的第一步（也是唯一需要调用的 MCP Tool）。\r\n\r\n完整下载流程：\r\n Step 1：调用本工具，传入文件节点 ID（nodeId），获取下载 URL（resourceUrl）和签名请求头（headers）。\r\n Step 2：AI Agent 自行发起 HTTP GET 请求：\r\n - URL：使用 resourceUrl 中的第一个 URL（优先级最高）。\r\n - Headers：将 headers 中所有键值对作为请求头携带。\r\n - 期望响应：HTTP 200，Body 为文件二进制内容。\r\n - 注意：下载凭证有过期时间（expirationSeconds），请在过期前完成下载；若已过期，需重新调用本工具获取新凭证。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc download --node \u003cNODE_ID\u003e", "dws doc download --node \u003cNODE_ID\u003e --output ./report.pdf" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "download_file" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "download_file", "parameter_count": 2, "parameters": { "node": { "description": "文件节点 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "output": { "description": "本地保存路径 (文件路径或目录)", "property": "output", "required": true, "type": "string" } }, "path": "doc.download_file", "primary_cli_path": "doc download", "product_id": "doc", "reviewed": false, "risk": "low", "source": "hardcoded:doc", "title": "获取文件下载凭证", "use_when": [ "指定文件路径", "自动推断文件名，下到目录" ] }, "doc.get_document_content": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.get_document_content", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-read.md", "skills/mono/references/products/doc/style/doc-update-workflow.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "读取文档内容（Markdown）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“读取文档内容（Markdown）”" ], "canonical_path": "doc.get_document_content", "cli_name": "read", "cli_path": "doc read", "confirmation": "not_required", "description": "获取钉钉文档的内容，以 Markdown 格式返回。\r\n\r\n通过 nodeId 定位文档，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。\r\n\r\n支持的文档类型：钉钉在线文档。\r\n文档链接格式：https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\r\ndentryUuid 为 32 位字母数字字符串。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc read --help", "dws doc read --node \u003cDOC_ID\u003e" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "get_document_content" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_document_content", "parameter_count": 3, "parameters": { "content-format": { "description": "输出格式: 默认为 markdown，可选 jsonml", "property": "contentFormat", "required": false, "type": "string" }, "node": { "description": "文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "output": { "description": "输出到本地文件路径（仅 --content-format jsonml 时生效）", "property": "output", "required": false, "type": "string" } }, "path": "doc.get_document_content", "primary_cli_path": "doc read", "product_id": "doc", "risk": "low", "source": "hardcoded:doc", "title": "获取钉钉文档内容", "use_when": [ "1. 读出完整 JSONML 结构（输出含 revision，普通改写场景下不需要）", "4. 读取文档内容 (Markdown 格式)", "JSONML 完整结构 → 文件（无损改写前置）", "alidocs URL 直传", "查看具体命令的完整参数说明", "看文档/读内容/文档内容；读取", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"帮我看看这个文档", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；默认", "编辑块/改段落/插入标题/删除块；\"帮我看看这个文档", "编辑块/改段落/插入标题/删除块；默认", "默认 Markdown 输出（最常用）" ] }, "doc.get_document_info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.get_document_info", "skills/mono/references/intent-guide.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-info.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取文档元信息（标题/类型/创建者/权限等）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取文档元信息（标题/类型/创建者/权限等）”" ], "canonical_path": "doc.get_document_info", "cli_name": "info", "cli_path": "doc info", "confirmation": "not_required", "description": "获取存储在钉钉文档（含知识库）、钉盘相关文件的元信息，包括文档标题、类型、创建者、创建时间等。\r\n返回字段中的 contentType 和 extension 是后续工具路由的关键依据。\r\n\r\n⚠️ 重要：当用户需要获取任何钉钉文件的内容时，必须先调用本工具，\r\n再根据返回的 contentType 和 extension 字段按以下规则选择对应工具：\r\n\r\n- contentType=ALIDOC, extension=adoc → 调用 get_document_content(nodeId)，返回 Markdown 内容\r\n- contentType=ALIDOC, extension=axls → 调用钉钉表格 MCP: get_all_sheets(nodeId) 获取工作表列表，再调用 get_range(nodeId, sheetId, range) 读取数据\r\n- contentType=ALIDOC, extension=able → 调用钉钉AI表格 MCP: get_tables(nodeId) 获取数据表列表（nodeId 即 baseId），再调用 query_records(nodeId, tableId) 查询记录\r\n- contentType≠ALIDOC 且 nodeType=file → 调用 download_file(nodeId)，返回文件下载链接", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc info --node \u003cDOC_ID\u003e", "dws doc info --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\"" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "get_document_info" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_document_info", "parameter_count": 1, "parameters": { "node": { "description": "文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" } }, "path": "doc.get_document_info", "primary_cli_path": "doc info", "product_id": "doc", "risk": "low", "source": "hardcoded:doc", "title": "获取节点基本信息", "use_when": [ "3. 获取文档元信息 (标题、类型、权限)", "alidocs URL 直传（CLI 自动解析）", "document/edit URL 直传（必须完整 URL，禁止单独提取 dentryKey）", "document/preview URL 直传", "❌ workspaceId（应作为 --workspace 用）", "❌ 单独的 dentryKey（必须带完整 URL）", "❌ 纯数字 dentryId（drive 链路）", "标准用法（nodeId 直传）", "步骤 1: 查询文件类型", "看文档/读内容/文档内容；元信息", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"这个文档的信息", "编辑块/改段落/插入标题/删除块；\"这个文档的信息", "这个 alidocs 表格链接帮我看下\"（粘贴原始 URL）；先 probe 节点类型" ] }, "doc.import_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-import.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "根据 taskId 查询文档导入任务的执行结果", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要根据 taskId 查询文档导入任务的执行结果时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.import_get", "cli_name": "get", "cli_path": "doc import get", "confirmation": "not_required", "description": "根据 taskId 查询文档导入任务的执行结果。\n通常不需要手动调用，dws doc import 会自动完成轮询。\n仅在导入命令超时或中断后，用于手动查询任务状态。\n\n任务状态:\n processing 转换中\n completed 导入成功，返回 documentUrl\n failed 导入失败", "display": "钉钉文档管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc import get --task-id \u003cTASK_ID\u003e", "dws doc import get --task-id \u003cTASK_ID\u003e --format json" ], "group": "import", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "import_get", "parameter_count": 1, "parameters": { "task-id": { "description": "导入任务 ID (必填)", "property": "taskId", "required": true, "type": "string" } }, "path": "doc.import_get", "primary_cli_path": "doc import get", "product_id": "doc", "reviewed": false, "risk": "medium", "source": "hardcoded:doc", "title": "查询导入任务结果（手动兜底）", "use_when": [ "根据 taskId 查询文档导入任务的执行结果" ] }, "doc.insert_document_block": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-block.md", "skills/mono/references/products/doc/format/doc-jsonml-cookbook.md", "skills/mono/references/products/doc/style/doc-update-workflow.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "将一个新的块元素插入指定文档，需要提供文档ID(dentryUuid)与块元素内容(必须包含 blockType 及对应类型的属性对象)。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除块元素（不可逆）”请改用 dws doc block delete", "要“更新指定文档的指定块元素内容或样式，需要提供文档ID(dentr”请改用 dws doc block update", "要“查询文档一级块元素列表”请改用 dws doc block list" ], "canonical_path": "doc.insert_document_block", "cli_name": "insert", "cli_path": "doc block insert", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "text", "heading", "element" ] ] }, "description": "将一个新的块元素插入指定文档，需要提供文档ID(dentryUuid)与块元素内容(必须包含 blockType 及对应类型的属性对象)。可以支持在指定块元素(传入blockId或index)的头部或尾部插入块元素。操作受文档权限控制，仅当调用者拥有编辑权限时生效。\r\n\r\n【附件插入说明】\r\n若 blockType 为 \"attachment\"：\r\n1. 必须先调用 get_doc_attachment_upload_info 工具获取该附件的属性（resourceId）。\r\n2. 将获取到的信息整合进 element 的 attachment 对象中，然后再调用此工具。\r\n\r\n【get_doc_attachment_upload_info 接口使用说明】\r\n获取向指定钉钉文档上传附件所需的 OSS 上传凭证信息。\r\n使用流程：\r\n1. 调用 get_doc_attachment_upload_info 接口，传入文档标识（nodeId）、文件名、文件大小和 MIME 类型，获取上传凭证。\r\n2. 使用返回的 uploadUrl 通过 HTTP PUT 请求将文件内容上传至 OSS，需设置以下请求头：\r\n Content-Type：与入参 mimeType 保持一致，例如 `application/pdf`\r\n Content-Length：与入参 fileSize 保持一致，单位为字节\r\n3. 上传成功后，使用返回的 resourceId 在文档中插入类型为附件的块元素。\r\n\r\n注意事项：\r\n1. uploadUrl 具有时效性，请在获取后尽快完成上传，避免凭证过期。\r\n2. fileSize 必须与实际文件大小一致，否则上传可能失败。\r\n3. mimeType 应与实际文件类型匹配，例如 PDF 文件传 application/pdf。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc block insert --help", "dws doc block insert --node \u003cDOC_ID\u003e --text \"这是一段文字\"" ], "group": "block", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "insert_document_block" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "insert_document_block", "parameter_count": 11, "parameters": { "content-format": { "description": "输入格式: 默认为 element，可选 jsonml", "property": "contentFormat", "required": false, "type": "string" }, "element": { "description": "块元素 JSON (高级)", "interface_description": "element 格式数据，待插入的块元素，必须包含 blockType 及对应类型的属性对象，详见块元素数据结构附录。最精简示例：{\"blockType\": \"paragraph\", \"paragraph\": {}}。", "interface_type": "object", "property": "element", "required": false, "type": "string" }, "fix-jsonml": { "description": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用", "property": "fixJsonml", "required": false, "type": "boolean" }, "heading": { "description": "快捷: 标题文本", "property": "heading", "required": false, "type": "string" }, "index": { "description": "参照位置索引 (从 0 开始)", "interface_description": "当 referenceBlockId 未指定时，使用 index 查找文档第 index 个一级块元素作为参照位置（从 0 开始）。两者均未指定时，默认插入到文档末尾。", "interface_type": "number", "property": "index", "required": false, "type": "integer" }, "level": { "default": "1", "description": "标题级别 1-6 (配合 --heading)", "property": "level", "required": false, "type": "integer" }, "node": { "description": "文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "parent-block": { "description": "父容器 UUID（容器内插入时使用，与 --index 配合）", "property": "parentBlock", "required": false, "type": "string" }, "ref-block": { "description": "参照块 ID (优先级高于 --index)", "property": "refBlock", "required": false, "type": "string" }, "text": { "description": "快捷: 段落文本内容", "property": "text", "required": false, "type": "string" }, "where": { "description": "插入方向: before / after (默认 after)", "interface_description": "插入方向：before（参照位置之前）或 after（参照位置之后）。默认为 after。", "property": "where", "required": false, "type": "string" } }, "path": "doc.insert_document_block", "primary_cli_path": "doc block insert", "product_id": "doc", "reviewed": false, "risk": "medium", "source": "hardcoded:doc", "title": "插入块元素", "use_when": [ "2. 在文档末尾插入段落", "3. 在指定块之前插入标题", "Callout（element JSON 次选；首选 JSONML container[subType=colorBlocks]）", "分栏（2 栏）", "单元格内含多段落 + 代码块", "在指定 block 之前插入", "在某个 block 后插入", "容器内定位插入（指定 parent + index）", "嵌入文件预览", "带格式文本（多个 leaf）", "带链接（link 是与 text 并列的子节点）", "引用块", "待办列表（checkbox）", "插入 JSONML 节点（同级定位）", "插入 JSONML 节点（容器内定位）", "插入分栏块(columns)：2 栏，children 为每栏的内容", "插入复杂块（callout / 分栏）—— element 默认按 JSON 解析", "插入引用块(blockquote)", "插入段落（同级定位）", "插入行内图片(inline image)：构造一个空 paragraph，在 children 中用 image elementType 指定图片 src", "插入表格(table)：2 行 3 列", "插入附件块(attachment)：resourceId 为资源ID，type 为 MIME 类型，viewType 可选 preview/summary", "文本段落", "无序列表项", "有序列表项（仅第一项设 start，后续项不设，系统自动递增）", "查看具体命令的完整参数说明", "标题（level 1-6）", "纯文本段落", "编辑块/改段落/插入标题/删除块；插入", "缩进子项（level: 1）", "群名片", "蓝色高亮块", "表格（2x3）" ] }, "doc.list_comments": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_comments", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-comment.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询文档评论列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建文档评论”请改用 dws doc comment create", "要“回复文档评论”请改用 dws doc comment reply", "要“在钉钉文档中创建划词评论，评论关联文档内指定块的文本范围，支持”请改用 dws doc comment create-inline" ], "canonical_path": "doc.list_comments", "cli_name": "list", "cli_path": "doc comment list", "confirmation": "not_required", "description": "获取钉钉文档的评论列表，支持分页查询、按评论类型和解决状态过滤。\r\n通过 nodeId 定位文档，支持传入文档链接 URL 或文档 ID（dentryUuid）。\r\n操作受权限控制，仅当调用者对文档有读取及以上权限时可获取评论。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc comment list --node \u003cDOC_ID\u003e", "dws doc comment list --node \u003cDOC_ID\u003e --type inline --resolve-status unresolved" ], "group": "comment", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc-comment", "rpc_name": "list_comments" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_comments", "parameter_count": 5, "parameters": { "cursor": { "description": "分页游标，从上一次请求的返回结果中获取 (首次请求不传)", "property": "cursor", "required": false, "type": "string" }, "limit": { "default": "50", "description": "每页返回的评论数量，默认 50，最大 50", "property": "limit", "required": false, "type": "integer" }, "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "property": "node", "required": true, "type": "string" }, "resolve-status": { "description": "按解决状态过滤: resolved (已解决) / unresolved (未解决)", "interface_description": "按解决状态过滤。可选值：resolved（已解决）、unresolved（未解决）。不传返回所有评论。", "property": "resolveStatus", "required": false, "type": "string" }, "type": { "description": "按评论类型过滤: global (全文评论) / inline (划词评论)", "property": "type", "required": false, "type": "string" } }, "path": "doc.list_comments", "primary_cli_path": "doc comment list", "product_id": "doc", "risk": "low", "source": "hardcoded:doc", "title": "获取文档评论列表", "use_when": [ "1. 查看文档的所有评论", "仅看未解决的划词评论", "查看文档全部评论" ] }, "doc.list_document_blocks": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_document_blocks", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-block.md", "skills/mono/references/products/doc/doc-comment.md", "skills/mono/references/products/doc/format/doc-jsonml-cookbook.md", "skills/mono/references/products/doc/style/doc-update-workflow.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询文档一级块元素列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除块元素（不可逆）”请改用 dws doc block delete", "要“将一个新的块元素插入指定文档，需要提供文档ID(dentryUu”请改用 dws doc block insert", "要“更新指定文档的指定块元素内容或样式，需要提供文档ID(dentr”请改用 dws doc block update" ], "canonical_path": "doc.list_document_blocks", "cli_name": "list", "cli_path": "doc block list", "confirmation": "not_required", "description": "查询指定钉钉文档下的一级块元素列表，需要提供dentryUuid。支持按按起始位置、终止位置范围及块类型过滤。操作受文档权限控制，当调用者拥有编辑或查看或下载权限时生效。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc block list --node \u003cDOC_ID\u003e", "dws doc block list --node \u003cDOC_ID\u003e --start-index 0 --end-index 5" ], "group": "block", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_document_blocks" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_document_blocks", "parameter_count": 6, "parameters": { "block-id": { "description": "指定块 UUID（content-format=jsonml 时读取完整子树）", "property": "blockId", "required": false, "type": "string" }, "block-type": { "description": "按块类型过滤", "interface_description": "按块类型过滤。不传时返回所有类型。", "property": "blockType", "required": false, "type": "string" }, "content-format": { "description": "输出格式: 默认为 element，可选 jsonml（返回 JSONML 节点数组）", "property": "contentFormat", "required": false, "type": "string" }, "end-index": { "description": "终止位置 (含)", "interface_description": "终止位置（≥ 0 的整数）。表示查询到根节点 children 的第 endIndex 个块为止（含）。不传时默认查询到末尾。", "interface_type": "number", "property": "endIndex", "required": false, "type": "integer" }, "node": { "description": "文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "start-index": { "description": "起始位置 (从 0 开始)", "interface_description": "起始位置（≥ 0 的整数）。表示从根节点 children 的第 startIndex 个块开始查询。不传时默认从头开始。", "interface_type": "number", "property": "startIndex", "required": false, "type": "integer" } }, "path": "doc.list_document_blocks", "primary_cli_path": "doc block list", "product_id": "doc", "risk": "low", "source": "hardcoded:doc", "title": "查询指定钉钉文档下的一级块元素列表", "use_when": [ "1. 列出所有 block 拿到 uuid", "1. 查看文档块结构 — 获取 blockId", "1. 获取当前结构", "2. 读单个 block 完整子树", "划词评论（先 block list 取 blockId + paragraph.text，计算 start/end）", "列出 + 取 uuid", "列出所有 block，定位 BLOCK_ID", "列出顶层 JSONML 节点", "编辑块/改段落/插入标题/删除块；查看结构", "读单个 block 完整子树", "读取指定 uuid 的完整子树" ] }, "doc.list_nodes": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_nodes", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "遍历文件夹或知识库下的直接子节点", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“遍历文件夹或知识库下的直接子节点”" ], "canonical_path": "doc.list_nodes", "cli_name": "list", "cli_path": "doc list", "confirmation": "not_required", "description": "列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等），支持分页。\r\n\r\n返回结果基于当前 MCP 会话用户的可访问权限进行过滤。\r\n返回的节点列表包含多种类型：在线文档、文件夹、PDF、docx、表格、脑图、白板等。\r\n\r\n定位方式（按优先级）：\r\n1. 传 folderId：列出该文件夹下的直接子节点\r\n2. 仅传 workspaceId（不传 folderId）：列出该知识库根目录下的直接子节点\r\n3. 都不传：列出用户\"我的文档\"根目录下的直接子节点\r\n\r\n返回的 nodeId 可直接用于其他工具（如 get_document_content、update_document、create_document 等）。\r\n若 nodeType=folder 且 hasChildren=true，可将该 nodeId 作为 folderId 再次调用本工具进行递归遍历。\r\n若 contentType=alidoc，可调用 get_document_content(nodeId=nodeId) 获取文档内容。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc list", "dws doc list --folder FOLDER_ID" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_nodes" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_nodes", "parameter_count": 4, "parameters": { "cursor": { "description": "分页游标 (从上次结果的 nextPageToken 获取)", "property": "cursor", "required": false, "type": "string" }, "folder": { "description": "文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "property": "folder", "required": false, "type": "string" }, "limit": { "description": "每页数量 (默认 50，最大 50)", "property": "limit", "required": false, "type": "integer" }, "workspace": { "description": "知识库 ID", "property": "workspace", "required": false, "type": "string" } }, "path": "doc.list_nodes", "primary_cli_path": "doc list", "product_id": "doc", "risk": "low", "source": "hardcoded:doc", "title": "列出指定文件夹或知识库下的直接子节点列表", "use_when": [ "遍历文件夹或知识库下的直接子节点" ] }, "doc.list_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-permission.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询知识库节点当前的成员权限列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员”请改用 dws doc permission add", "要“从知识库节点移除指定企业用户的权限（仅支持 USER 类型）”请改用 dws doc permission remove", "要“修改企业用户在知识库节点上的角色（仅支持 USER 类型）”请改用 dws doc permission update" ], "canonical_path": "doc.list_permission", "cli_name": "list", "cli_path": "doc permission list", "confirmation": "not_required", "description": "查询知识库节点当前的成员权限列表。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc permission list --node \u003cDOC_ID\u003e", "dws doc permission list --node \u003cDOC_ID\u003e --limit 50" ], "group": "permission", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_permission", "parameter_count": 4, "parameters": { "filter-role": { "description": "按角色过滤（逗号分隔）：OWNER / MANAGER / EDITOR / DOWNLOADER / READER", "property": "filterRole", "required": false, "type": "string" }, "limit": { "default": "30", "description": "返回成员数上限，默认 30，最大 200", "property": "limit", "required": false, "type": "integer" }, "node": { "description": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)", "property": "node", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）", "property": "workspace", "required": false, "type": "string" } }, "path": "doc.list_permission", "primary_cli_path": "doc permission list", "product_id": "doc", "reviewed": false, "risk": "low", "source": "hardcoded:doc", "title": "查询节点成员列表", "use_when": [ "拉取更多结果（默认 50，最大 200）", "按角色过滤查看", "查看谁有权限", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；查看谁有权限" ] }, "doc.media_insert": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-media.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "上传本地文件并作为附件插入文档（3 步合一：prepare + PUT + insert）", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“获取钉钉文档中指定附件的临时下载 URL”请改用 dws doc media download" ], "canonical_path": "doc.media_insert", "cli_name": "insert", "cli_path": "doc media insert", "confirmation": "not_required", "description": "将本地文件作为附件上传并插入到钉钉文档中（三步自动完成）。\n\n流程:\n 1. 获取附件上传凭证 (get_doc_attachment_upload_info)\n 2. HTTP PUT 上传文件到 OSS\n 3. 插入附件块到文档 (insert_document_block)\n\n--mime-type 可选，不指定时根据文件扩展名自动推断。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc media insert --node \u003cDOC_ID\u003e --file ./report.pdf", "dws doc media insert --node \u003cDOC_ID\u003e --file ./data.bin --name \"数据文件.dat\" --mime-type application/octet-stream" ], "group": "media", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "is_alias": false, "name": "media_insert", "parameter_count": 7, "parameters": { "file": { "description": "本地文件路径 (必填)", "property": "file", "required": true, "type": "string" }, "index": { "description": "插入位置索引", "property": "index", "required": false, "type": "integer" }, "mime-type": { "description": "文件 MIME 类型 (默认根据扩展名推断)", "property": "mimeType", "required": false, "type": "string" }, "name": { "description": "附件显示名称 (默认使用文件名)", "property": "name", "required": false, "type": "string" }, "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "property": "node", "required": true, "type": "string" }, "ref-block": { "description": "参考块 ID (配合 --where)", "property": "refBlock", "required": false, "type": "string" }, "where": { "description": "相对位置: before / after (配合 --ref-block)", "property": "where", "required": false, "type": "string" } }, "path": "doc.media_insert", "primary_cli_path": "doc media insert", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "hardcoded:doc", "title": "上传附件并插入文档", "use_when": [ "1. 基本用法: 插入本地文件到文档", "2. 指定附件显示名称", "3. 指定 MIME 类型 (文件扩展名无法推断时)", "4. 在指定块之前插入附件", "上传本地文件并作为附件插入文档（3 步合一：prepare + PUT + insert）", "在指定块之前插入附件", "基本用法：插入本地文件到文档", "指定 MIME 类型（扩展名无法推断时）", "指定附件显示名称", "提取 nodeId 后:", "插入图片/加图片/放张图/嵌入图片/往文档里插图；插入图片", "插入附件/上传附件到文档/往文档里加文件/加附件；插入附件" ] }, "doc.move_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.move_document", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-file-ops.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "将指定节点移动到目标文件夹。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“将指定节点移动到目标文件夹。”所述变更时不要使用" ], "canonical_path": "doc.move_document", "cli_name": "move", "cli_path": "doc move", "confirmation": "not_required", "description": "将指定节点移动到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时移动到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有编辑权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：移动操作底层可能异步执行，异步时操作已提交但无法立即确认完成，请稍后查看目标文件夹确认结果。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc move --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e", "dws doc move --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "move_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "move_document", "parameter_count": 3, "parameters": { "folder": { "description": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "property": "folder", "required": false, "type": "string" }, "node": { "description": "文档/文件 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL (不传 --folder 时移动到该知识库根目录)", "property": "workspace", "required": false, "type": "string" } }, "path": "doc.move_document", "primary_cli_path": "doc move", "product_id": "doc", "reviewed": false, "risk": "medium", "source": "hardcoded:doc", "title": "移动节点", "use_when": [ "移动到指定文件夹", "移动到目标知识库根目录（不传 --folder 时）", "移动到知识库根目录", "移动文档/搬到/移到/转移文件；移动", "移动文档到指定文件夹" ] }, "doc.query_export_job": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-export.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "用于查询通过 submit_export_job 提交的文字文档导出任务的执行状态，任务完成时返回文件下载链接。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“用于查询通过 submit_export_job 提交的文字文档导出任务的执行状态，任务完成时返回文件下载链接。”" ], "canonical_path": "doc.query_export_job", "cli_name": "get", "cli_path": "doc export get", "confirmation": "not_required", "description": "用于查询通过 submit_export_job 提交的文字文档导出任务的执行状态，任务完成时返回文件下载链接。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc export get --job-id \u003cJOB_ID\u003e" ], "group": "export", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "query_export_job" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_export_job", "parameter_count": 1, "parameters": { "job-id": { "description": "导出任务 ID (必填)", "interface_description": "由 submit_export_job 返回的导出任务 ID。必填。", "property": "jobId", "required": true, "type": "string" } }, "path": "doc.query_export_job", "primary_cli_path": "doc export get", "product_id": "doc", "reviewed": false, "risk": "low", "source": "hardcoded:doc", "title": "查询文档导出任务状态", "use_when": [ "兜底：超时或中断后手动查任务" ] }, "doc.remove_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员”请改用 dws doc permission add", "要“修改企业用户在知识库节点上的角色（仅支持 USER 类型）”请改用 dws doc permission update", "要“查询知识库节点当前的成员权限列表”请改用 dws doc permission list" ], "canonical_path": "doc.remove_permission", "cli_name": "remove", "cli_path": "doc permission remove", "confirmation": "user_required", "description": "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量移除成员在节点上的权限，移除后相关用户将无法通过该节点的直接授权访问内容（若有父节点继承权限则仍可通过继承权限访问）。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口移除。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。DOWNLOADER / READER / 非成员调用会返回 `forbidden.accessDenied`，错误信息会明确提示所需的最低角色。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。", "display": "钉钉文档管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws doc permission remove --node \u003cnode\u003e --users \u003cusers\u003e" ], "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "remove_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_permission", "parameter_count": 3, "parameters": { "node": { "description": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)", "property": "node", "required": true, "type": "string" }, "users": { "description": "被移除权限的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)", "property": "users", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）", "property": "workspace", "required": false, "type": "string" } }, "path": "doc.remove_permission", "primary_cli_path": "doc permission remove", "product_id": "doc", "reviewed": false, "risk": "high", "source": "hardcoded:doc", "title": "移除节点成员权限", "use_when": [ "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。" ] }, "doc.rename_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-file-ops.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "对指定节点进行重命名。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“对指定节点进行重命名。”所述变更时不要使用" ], "canonical_path": "doc.rename_document", "cli_name": "rename", "cli_path": "doc rename", "confirmation": "not_required", "description": "对指定节点进行重命名。\r\n\r\n支持范围：\r\n- 知识库（workspace）下的文档节点、文件夹节点\r\n\r\n权限要求：\r\n- 对目标节点有编辑权限", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc rename --node \u003cDOC_ID\u003e --name \"新名称\"", "dws doc rename --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --name \"项目周报 v2\"" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "rename_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "rename_document", "parameter_count": 2, "parameters": { "name": { "description": "新名称 (必填)", "property": "name", "required": true, "type": "string" }, "node": { "description": "文档/文件 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" } }, "path": "doc.rename_document", "primary_cli_path": "doc rename", "product_id": "doc", "reviewed": false, "risk": "medium", "source": "hardcoded:doc", "title": "对指定节点进行重命名", "use_when": [ "── rename ──", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"把这个文档标题改成 X\" / \"这个文档改名为 X", "重命名/rename/改名/改文档名/修改文档名称/修改文档标题/把这个文档叫做...；重命名", "重命名文档" ] }, "doc.reply_comment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.reply_comment", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-comment.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "回复文档评论", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建文档评论”请改用 dws doc comment create", "要“在钉钉文档中创建划词评论，评论关联文档内指定块的文本范围，支持”请改用 dws doc comment create-inline", "要“查询文档评论列表”请改用 dws doc comment list" ], "canonical_path": "doc.reply_comment", "cli_name": "reply", "cli_path": "doc comment reply", "confirmation": "not_required", "description": "回复钉钉文档中的已有评论，支持普通文字回复和表情贴图回复，支持 @提及用户。\r\n\r\n通过 nodeId 定位文档，通过 replyCommentKey 指定被回复的评论（可从 create_comment 或 list_comments 的返回结果中获取）。\r\n- 普通回复：填写 content，不填 emoji。\r\n- 表情贴图回复：填写 content（表情名称），同时将 emoji 设为 true。表情回复的 categoryFeature 会自动从被回复评论继承。\r\n- @提及用户：填写 mentionedUserIds，被提及用户会收到通知。\r\n操作受权限控制，仅当调用者对文档有评论权限时可回复评论。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"同意\"", "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"比心\" --emoji" ], "group": "comment", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc-comment", "rpc_name": "reply_comment" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "reply_comment", "parameter_count": 5, "parameters": { "comment-key": { "description": "被回复评论的 commentKey，格式: {13位毫秒时间戳}{32位UUID}，可从 list/create 结果获取 (必填)", "property": "commentKey", "required": true, "type": "string" }, "content": { "description": "回复的文字内容，表情回复时填写表情名称 (必填)", "interface_description": "回复的文字内容，纯文本格式。表情回复时填写表情名称。必填。", "property": "content", "required": true, "type": "string" }, "emoji": { "description": "设为 true 时作为表情贴图回复 (默认 false)", "interface_description": "设为 true 时，本次回复将作为表情贴图回复，categoryFeature 会自动从被回复评论继承。默认 false。", "property": "emoji", "required": false, "type": "boolean" }, "mention": { "description": "被 @ 的用户 uid 列表，逗号分隔", "property": "mention", "required": false, "type": "string" }, "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "property": "node", "required": true, "type": "string" } }, "path": "doc.reply_comment", "primary_cli_path": "doc comment reply", "product_id": "doc", "risk": "medium", "source": "hardcoded:doc", "title": "回复评论", "use_when": [ "4. 回复某条评论（commentKey 从 list 或 create 返回中获取）", "5. 用表情回复评论", "文字回复", "表情回复（--content 填表情名称）" ] }, "doc.search_documents": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.search_documents", "skills/mono/references/intent-guide.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "搜索文档（不传关键词返回最近访问）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "搜一下 OAuth2 接入文档；搜索开发文档", "搜一下智能化方案/最近 OKR 相关邮件/最近发版相关消息；搜企业知识内容" ], "canonical_path": "doc.search_documents", "cli_name": "search", "cli_path": "doc search", "confirmation": "not_required", "description": "根据关键词和多种过滤条件搜索当前用户有权限访问的文档列表。\r\n\r\n支持的过滤条件：\r\n- keyword：关键词匹配文档标题和内容\r\n- extensions：按文件扩展名精确过滤（pdf/docx/png 等）\r\n- createdTimeFrom / createdTimeTo：按创建时间范围过滤\r\n- visitedTimeFrom / visitedTimeTo：按访问时间范围过滤\r\n- creatorUserIds：按创建者用户 ID 过滤\r\n - editorUserIds：按编辑者用户 ID 过滤\r\n- mentionedUserIds：按文档中 @提及的用户 ID 过滤\r\n- workspaceIds：按知识库范围过滤（支持知识库 URL）\r\n\r\n支持分页获取结果。搜索范围为用户在当前组织内有权限访问的所有文档数据。\r\n所有过滤条件均为可选，不传则不过滤。多个条件同时传入时取交集", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc search --query \"会议纪要\"", "dws doc search" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "search_documents" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_documents", "parameter_count": 12, "parameters": { "created-from": { "description": "创建时间起始 (毫秒时间戳，含)", "property": "createdFrom", "required": false, "type": "integer" }, "created-to": { "description": "创建时间截止 (毫秒时间戳，含)", "property": "createdTo", "required": false, "type": "integer" }, "creator-uids": { "description": "按创建者用户 ID 过滤，逗号分隔", "property": "creatorUids", "required": false, "type": "array" }, "cursor": { "description": "分页游标 (从上次结果的 nextPageToken 获取)", "property": "cursor", "required": false, "type": "string" }, "editor-uids": { "description": "按编辑者用户 ID 过滤，逗号分隔", "property": "editorUids", "required": false, "type": "array" }, "extensions": { "description": "按文件扩展名过滤，不含点号，逗号分隔 (如 pdf,docx,png)。支持的在线文档类型后缀名: adoc=文字, axls=表格, appt=演示文稿, awbd=白板, adraw=画板, amind=脑图, able=多维表格, aform=收集表", "interface_description": "按文件扩展名精确过滤，不含点号。例如 [\"pdf\", \"docx\", \"png\"]。与 fileTypes 可同时使用。", "property": "extensions", "required": false, "type": "array" }, "limit": { "description": "每页数量 (默认 10，最大 30)", "property": "limit", "required": false, "type": "integer" }, "mentioned-uids": { "description": "按 @提及的用户 ID 过滤，逗号分隔", "property": "mentionedUids", "required": false, "type": "array" }, "query": { "description": "搜索关键词 (不传则返回最近访问)", "property": "query", "required": false, "type": "string" }, "visited-from": { "description": "访问时间起始 (毫秒时间戳，含)", "property": "visitedFrom", "required": false, "type": "integer" }, "visited-to": { "description": "访问时间截止 (毫秒时间戳，含)", "property": "visitedTo", "required": false, "type": "integer" }, "workspace-ids": { "description": "按知识库 ID 过滤，支持知识库 URL，逗号分隔", "interface_description": "按知识库范围过滤，支持知识库 URL", "property": "workspaceIds", "required": false, "type": "array" } }, "path": "doc.search_documents", "primary_cli_path": "doc search", "product_id": "doc", "risk": "low", "source": "hardcoded:doc", "title": "搜索文档", "use_when": [ "搜索文档（不传关键词返回最近访问）" ] }, "doc.template_apply": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "使用指定模板创建新文档", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要使用指定模板创建新文档时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.template_apply", "cli_name": "apply", "cli_path": "doc template apply", "confirmation": "not_required", "description": "使用指定模板创建新文档。", "display": "钉钉文档管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc template apply --help" ], "group": "template", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "template_apply", "parameter_count": 4, "parameters": { "folder": { "description": "目标文件夹 ID (可选)", "property": "folder", "required": false, "type": "string" }, "name": { "description": "新文档名称 (可选)", "property": "name", "required": false, "type": "string" }, "template-id": { "description": "模板 ID (必填)", "property": "templateId", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (可选)", "property": "workspace", "required": false, "type": "string" } }, "path": "doc.template_apply", "primary_cli_path": "doc template apply", "product_id": "doc", "reviewed": false, "risk": "medium", "source": "hardcoded:doc", "title": "应用文档模板", "use_when": [ "使用指定模板创建新文档" ] }, "doc.template_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "获取当前用户可用的文档模板列表，支持按来源筛选", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要获取当前用户可用的文档模板列表，支持按来源筛选时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.template_list", "cli_name": "list", "cli_path": "doc template list", "confirmation": "not_required", "description": "获取当前用户可用的文档模板列表，支持按来源筛选。", "display": "钉钉文档管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws doc template list --help" ], "group": "template", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "template_list", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标", "property": "cursor", "required": false, "type": "string" }, "limit": { "description": "返回数量上限", "property": "limit", "required": false, "type": "integer" }, "source": { "description": "模板来源: MY(我的模版)/PUBLIC(公开模版)，不传默认 MY", "property": "source", "required": false, "type": "string" } }, "path": "doc.template_list", "primary_cli_path": "doc template list", "product_id": "doc", "reviewed": false, "risk": "low", "source": "hardcoded:doc", "title": "获取文档模板列表", "use_when": [ "获取当前用户可用的文档模板列表，支持按来源筛选" ] }, "doc.template_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "根据关键词搜索文档模板", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要根据关键词搜索文档模板时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.template_search", "cli_name": "search", "cli_path": "doc template search", "confirmation": "not_required", "description": "根据关键词搜索文档模板。", "display": "钉钉文档管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws doc template search --help" ], "group": "template", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "template_search", "parameter_count": 4, "parameters": { "cursor": { "description": "分页游标", "property": "cursor", "required": false, "type": "string" }, "limit": { "description": "返回数量上限", "property": "limit", "required": false, "type": "integer" }, "query": { "description": "搜索关键词 (必填)", "property": "query", "required": true, "type": "string" }, "source": { "description": "模板来源: MY(我的模版)/PUBLIC(公开模版)，不传默认 MY", "property": "source", "required": false, "type": "string" } }, "path": "doc.template_search", "primary_cli_path": "doc template search", "product_id": "doc", "reviewed": false, "risk": "low", "source": "hardcoded:doc", "title": "搜索文档模板", "use_when": [ "根据关键词搜索文档模板" ] }, "doc.update_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.update_document", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-block.md", "skills/mono/references/products/doc/doc-update.md", "skills/mono/references/products/doc/style/doc-update-workflow.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "更新文档内容（追加 / 覆盖）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新文档内容（追加 / 覆盖）”所述变更时不要使用" ], "canonical_path": "doc.update_document", "cli_name": "update", "cli_path": "doc update", "confirmation": "not_required", "constraints": { "mutually_exclusive": [ [ "content", "content-file" ] ], "require_one_of": [ [ "content", "content-file" ] ] }, "description": "更新钉钉文档的内容，扩展名=adoc，其他类型在线文档不能使用此mcp服务，支持两种更新模式。\r\n\r\n## 更新模式\r\n\r\n1. **overwrite**（覆盖，默认）：清空文档全部内容后重新写入。适用于需要完整替换文档内容的场景。⚠️ 会丢失原有内容，请谨慎使用。\r\n2. **append**（追加）：在文档末尾追加新内容。最安全的模式，不影响现有内容。\r\n 支持通过 index 参数指定插入位置（从 0 开始）；不传 index 时追加到末尾。\r\n block 的 index 可通过 list_document_blocks 工具获取。\r\n 插入成功后，该位置及之后的所有 block 的 index 会依次 +1。\r\n\r\n## 注意事项\r\n- 默认模式为 overwrite，不传 mode 时使用覆盖模式\r\n- overwrite 模式会清空所有内容，包括图片、评论等，请谨慎使用\r\n- 写入内容长度上限 10000 字符，超出请分批写入", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc update --node \u003cDOC_ID\u003e --content \"# 追加内容\" --mode append", "dws doc update --node \u003cDOC_ID\u003e --content \"# 完整替换\" --mode overwrite" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "update_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_document", "parameter_count": 10, "parameters": { "content": { "description": "文档内容（短文本字面量）；传 - 表示从 stdin 读取", "property": "content", "required": false, "type": "string" }, "content-file": { "description": "从文件读取文档内容（UTF-8）。推荐长/多行/表格内容使用", "property": "contentFile", "required": false, "type": "string" }, "content-format": { "description": "内容格式: 默认为 markdown，可选 jsonml", "property": "contentFormat", "required": false, "type": "string" }, "dry-run": { "description": "预览覆盖写入差异，不调用远端 update", "property": "dryRun", "required": false, "type": "boolean" }, "fix-jsonml": { "description": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用", "property": "fixJsonml", "required": false, "type": "boolean" }, "index": { "default": "-1", "description": "插入位置（从 0 开始），仅在 mode=append 时生效。指定将内容插入到文档第几个 block 之前。不传时追加到末尾", "interface_description": "插入位置（从 0 开始），仅在 mode=append 时生效。指定将内容插入到文档第几个 block 之前。不传时追加到末尾。block 的 index 可通过 list_document_blocks 工具获取。插入成功后，该位置及之后的所有 block 的 index 会依次 +1。", "interface_type": "number", "property": "index", "required": false, "type": "integer" }, "mode": { "description": "更新模式: overwrite=覆盖, append=追加 (必填)", "interface_description": "更新模式，默认 overwrite。可选值：overwrite（覆盖全文）、append（追加到末尾）。", "property": "mode", "required": true, "type": "string" }, "node": { "description": "文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "revision": { "description": "可选，文档编辑版本号（仅 --content-format jsonml 生效）；传则触发并发检查（与服务端不一致时拒绝写入），不传则直接覆盖", "interface_description": "文档版本号", "interface_type": "string", "property": "revision", "required": false, "type": "integer" }, "yes": { "description": "确认执行破坏性写入 (仅 --mode overwrite 需要)", "property": "yes", "required": false, "type": "boolean" } }, "path": "doc.update_document", "primary_cli_path": "doc update", "product_id": "doc", "risk": "medium", "source": "hardcoded:doc", "title": "更新钉钉文档的内容", "use_when": [ "2. 一步写入：", "2. 逐个追加：", "3. 写入内容 (追加模式)", "3. 逐个追加：", "4. 提交修改（默认直接覆盖，不做并发检查）", "JSONML 整篇无损 overwrite（默认不做并发检查；并发敏感时加 --revision \u003cN\u003e）", "append 到指定 block 前（index 通过 doc block list 获取）", "append 末尾追加", "heredoc（真实换行，含表格）", "overwrite 整段（用户已确认）", "stdin（heredoc，含表格）", "写文档/创建文档；整篇覆盖替换", "写文档/创建文档；追加内容", "插入分割线：使用 doc update --mode append 以 Markdown 格式追加", "短文本字面量（\u003c2KB 无换行）", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"往这个文档追加内容", "编辑块/改段落/插入标题/删除块；\"往这个文档追加内容" ] }, "doc.update_document_block": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-block.md", "skills/mono/references/products/doc/format/doc-jsonml-cookbook.md", "skills/mono/references/products/doc/style/doc-update-workflow.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新指定文档的指定块元素内容或样式，需要提供文档ID(dentryUuid)、块元素ID(blockId)与块元素内容(必须包含 blockType 及对应类型的属性对象)。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除块元素（不可逆）”请改用 dws doc block delete", "要“将一个新的块元素插入指定文档，需要提供文档ID(dentryUu”请改用 dws doc block insert", "要“查询文档一级块元素列表”请改用 dws doc block list" ], "canonical_path": "doc.update_document_block", "cli_name": "update", "cli_path": "doc block update", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "text", "heading", "element" ] ] }, "description": "更新指定文档的指定块元素内容或样式，需要提供文档ID(dentryUuid)、块元素ID(blockId)与块元素内容(必须包含 blockType 及对应类型的属性对象)。操作受文档权限控制，仅当调用者拥有编辑权限时生效。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc block update --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --text \"新内容\"", "dws doc block update --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --element '{\"blockType\":\"heading\",\"heading\":{\"text\":\"新标题\",\"level\":1}}'" ], "group": "block", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "update_document_block" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_document_block", "parameter_count": 8, "parameters": { "block-id": { "description": "目标块 ID (必填)", "interface_description": "待删除块元素的唯一标识。可通过 list_document_blocks 工具查询获取（返回结果中的 blockId 字段）。目前仅支持根目录下的第一级块元素的 blockId。必填。", "property": "blockId", "required": true, "type": "string" }, "content-format": { "description": "输入格式: 默认为 element，可选 jsonml", "property": "contentFormat", "required": false, "type": "string" }, "element": { "description": "块元素 JSON (高级)", "interface_description": "待插入的块元素，必须包含 blockType 及对应类型的属性对象，详见块元素数据结构附录。最精简示例：{\"blockType\": \"paragraph\", \"paragraph\": {}}。", "interface_type": "object", "property": "element", "required": false, "type": "string" }, "fix-jsonml": { "description": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用", "property": "fixJsonml", "required": false, "type": "boolean" }, "heading": { "description": "快捷: 标题文本", "property": "heading", "required": false, "type": "string" }, "level": { "default": "1", "description": "标题级别 1-6 (配合 --heading)", "property": "level", "required": false, "type": "integer" }, "node": { "description": "文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "text": { "description": "快捷: 段落文本内容", "property": "text", "required": false, "type": "string" } }, "path": "doc.update_document_block", "primary_cli_path": "doc block update", "product_id": "doc", "reviewed": false, "risk": "medium", "source": "hardcoded:doc", "title": "更新块元素", "use_when": [ "2. 修改后写回（uuid 不变）", "3. 改完后写回（uuid 必须 == --block-id）", "4. 更新某个块的内容", "修改某块文本", "修改标题", "改一个 block 的文本", "整体替换（update 时 uuid 必须等于 --block-id）", "整体替换（update 的 uuid 必须等于 --block-id）", "更新已有标题", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"把正文里的一级标题/章节标题改成 X", "编辑块/改段落/插入标题/删除块；\"编辑这个文档的标题", "编辑块/改段落/插入标题/删除块；修改" ] }, "doc.update_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission", "skills/mono/SKILL.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-permission.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "修改企业用户在知识库节点上的角色（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员”请改用 dws doc permission add", "要“从知识库节点移除指定企业用户的权限（仅支持 USER 类型）”请改用 dws doc permission remove", "要“查询知识库节点当前的成员权限列表”请改用 dws doc permission list" ], "canonical_path": "doc.update_permission", "cli_name": "update", "cli_path": "doc permission update", "confirmation": "user_required", "description": "修改企业用户在知识库节点上的角色（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量调整成员角色，同一成员在同一节点只能拥有一个角色，变更后旧角色自动替换。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口变更。\r\n- 若成员的角色来自父节点的权限继承（PASS_ON 模式），且继承的角色高于目标角色，接口会拒绝操作。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。\r\n- 入参直接采用扁平的 `userIds: List\u003cString\u003e`，每个元素为钉钉 staffId（外部 userId 格式，由钉钉开放平台体系下颁发）。", "display": "钉钉文档管理", "effect": "write", "effect_source": "skill-explicit", "examples": [ "dws doc permission update --node \u003cDOC_ID\u003e --users uid1 --role EDITOR", "dws doc permission update --node \u003cDOC_ID\u003e --users uid1,uid2 --role READER" ], "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "update_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_permission", "parameter_count": 4, "parameters": { "node": { "description": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)", "property": "node", "required": true, "type": "string" }, "role": { "description": "新权限角色: MANAGER / EDITOR / DOWNLOADER / READER (必填，大小写不敏感)", "property": "role", "required": true, "type": "string" }, "users": { "description": "被更新的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)", "property": "users", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）", "property": "workspace", "required": false, "type": "string" } }, "path": "doc.update_permission", "primary_cli_path": "doc permission update", "product_id": "doc", "reviewed": false, "risk": "high", "source": "hardcoded:doc", "title": "变更节点成员角色", "use_when": [ "修改某人角色（READER → EDITOR）", "给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；修改权限" ] }, "doc.upload": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-file-ops.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "上传文件到钉钉文档或知识库", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“上传文件到钉钉文档或知识库”所述变更时不要使用" ], "canonical_path": "doc.upload", "cli_name": "upload", "cli_path": "doc upload", "confirmation": "not_required", "description": "将本地文件上传到钉钉文档或钉钉知识库（三步上传流程）。\n\n流程:\n 1. 获取 OSS 上传凭证 (get_file_upload_info)\n 2. HTTP PUT 上传文件二进制到 OSS\n 3. 提交文件入库 (commit_uploaded_file)\n\n上传位置优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc upload --file ./report.pdf", "dws doc upload --file ./slides.pptx --name \"Q1汇报.pptx\" --folder \u003cFOLDER_ID\u003e" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "is_alias": false, "name": "upload", "parameter_count": 5, "parameters": { "convert": { "description": "是否转换为钉钉在线文档", "property": "convert", "required": false, "type": "boolean" }, "file": { "description": "本地文件路径 (必填)", "property": "file", "required": true, "type": "string" }, "folder": { "description": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "property": "folder", "required": false, "type": "string" }, "name": { "description": "文件显示名称 (默认使用文件名)", "property": "name", "required": false, "type": "string" }, "workspace": { "description": "目标知识库 ID", "property": "workspace", "required": false, "type": "string" } }, "path": "doc.upload", "primary_cli_path": "doc upload", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "hardcoded:doc", "title": "上传文件到钉钉文档或钉钉知识库", "use_when": [ "1. 上传到\"我的文档\"根目录", "2. 上传到指定文件夹", "3. 上传到知识库并转换为在线文档", "上传到「我的文档」根目录", "上传到指定文件夹", "上传到知识库并转换为在线文档", "上传文件/传文件/上传到文档/上传到知识库；上传", "上传文件/传文件/上传到文档/上传到知识库；上传并转换", "上传文件到钉钉文档或知识库" ] }, "doc.version_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "查看文档历史版本列表", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要查看文档历史版本列表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.version_list", "cli_name": "list", "cli_path": "doc version list", "confirmation": "not_required", "description": "查看文档历史版本列表", "display": "钉钉文档管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws doc version list --help" ], "group": "version", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "version_list", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标", "property": "cursor", "required": false, "type": "string" }, "limit": { "description": "返回版本数量上限", "property": "limit", "required": false, "type": "integer" }, "node": { "description": "文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" } }, "path": "doc.version_list", "primary_cli_path": "doc version list", "product_id": "doc", "reviewed": false, "risk": "low", "source": "hardcoded:doc", "title": "查看文档历史版本列表", "use_when": [ "查看文档历史版本列表" ] }, "doc.version_revert": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "回滚文档到指定版本", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要回滚文档到指定版本时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.version_revert", "cli_name": "revert", "cli_path": "doc version revert", "confirmation": "not_required", "description": "回滚文档到指定版本", "display": "钉钉文档管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws doc version revert --help" ], "group": "version", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "version_revert", "parameter_count": 2, "parameters": { "node": { "description": "文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "version": { "description": "目标版本号 (必填，从 list 获取)", "property": "version", "required": true, "type": "integer" } }, "path": "doc.version_revert", "primary_cli_path": "doc version revert", "product_id": "doc", "reviewed": false, "risk": "low", "source": "hardcoded:doc", "title": "回滚文档到指定版本", "use_when": [ "回滚文档到指定版本" ] }, "doc.version_save": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "手动保存文档版本快照", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要手动保存文档版本快照时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "doc.version_save", "cli_name": "save", "cli_path": "doc version save", "confirmation": "not_required", "description": "手动保存文档版本快照", "display": "钉钉文档管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc version save --help" ], "group": "version", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "version_save", "parameter_count": 1, "parameters": { "node": { "description": "文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" } }, "path": "doc.version_save", "primary_cli_path": "doc version save", "product_id": "doc", "reviewed": false, "risk": "medium", "source": "hardcoded:doc", "title": "手动保存文档版本快照", "use_when": [ "手动保存文档版本快照" ] }, "drive.add_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.drive.add_permission", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“从知识库节点移除指定企业用户的权限（仅支持 USER 类型）”请改用 dws drive permission remove", "要“修改企业用户在知识库节点上的角色（仅支持 USER 类型）”请改用 dws drive permission update", "要“查询知识库节点当前的成员权限列表”请改用 dws drive permission list" ], "canonical_path": "drive.add_permission", "cli_name": "add", "cli_path": "drive permission add", "confirmation": "not_required", "description": "为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量授予企业用户对节点的访问权限，添加成功后即可按指定角色访问该节点及其子节点（若子节点继承权限）。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口添加。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。\r\n- 入参直接采用扁平的 `userIds: List\u003cString\u003e`，每个元素为钉钉 staffId（外部 userId 格式，由钉钉开放平台体系下颁发）。如果你只有 unionId，请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取。", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive permission add --node \u003cID\u003e --users uid1,uid2 --role READER" ], "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "add_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_permission", "parameter_count": 4, "parameters": { "node": { "description": "目标节点 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "role": { "description": "角色: MANAGER / EDITOR / DOWNLOADER / READER (必填)", "property": "role", "required": true, "type": "string" }, "users": { "description": "用户 userId 列表，逗号分隔 (必填)", "property": "users", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (选填)", "property": "workspace", "required": false, "type": "string" } }, "path": "drive.add_permission", "primary_cli_path": "drive permission add", "product_id": "drive", "reviewed": false, "risk": "medium", "source": "hardcoded:drive", "title": "添加节点成员", "use_when": [ "给文档授权/分享权限" ] }, "drive.commit_upload": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.commit_upload", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "提交文件上传", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“提交文件上传”所述变更时不要使用" ], "canonical_path": "drive.commit_upload", "cli_name": "commit", "cli_path": "drive commit", "confirmation": "not_required", "description": "文件上传流程：\r\nStep 1：调用 get_upload_info 获取预签名的 OSS 上传 URL\r\nStep 2：使用 Step 1 返回的 URL 将文件 PUT 到 OSS\r\nStep 3：调用本接口提交文件，传入Step 1返回的 uploadId 与对应的 fileName、fileSize 完成文件上传", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive commit --file-name \"report.pdf\" --file-size 102400 --upload-id \u003cUPLOAD_ID\u003e", "dws drive commit --file-name \"报告.pdf\" --file-size 102400 --upload-id \u003cuploadId\u003e" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "commit_upload" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "commit_upload", "parameter_count": 5, "parameters": { "file-name": { "description": "文件名（含扩展名），须与 get_upload_info 时一致 (必填)", "interface_description": "文件名（含扩展名），须与 get_upload_info 时传入的 fileName 一致", "property": "fileName", "required": true, "type": "string" }, "file-size": { "description": "文件大小（字节），须与 get_upload_info 时一致 (必填)", "interface_description": "文件大小（字节），须与 get_upload_info 时传入的 fileSize 一致，用于完整性校验", "interface_type": "number", "property": "fileSize", "required": true, "type": "integer" }, "folder": { "description": "父节点 ID (dentryUuid)，不传则提交到根目录 (可选)", "property": "folder", "required": false, "type": "string" }, "space-id": { "description": "空间 ID，不传则使用「我的文件」 (可选)", "interface_description": "目标空间 ID。不传时后端自动使用当前用户「我的文件」对应的 spaceId", "property": "spaceId", "required": false, "type": "string" }, "upload-id": { "description": "上传 ID，来自 get_upload_info 返回的 uploadId (必填)", "interface_description": "上传 ID，来自 get_upload_info 返回的 uploadId", "property": "uploadId", "required": true, "type": "string" } }, "path": "drive.commit_upload", "primary_cli_path": "drive commit", "product_id": "drive", "risk": "medium", "source": "hardcoded:drive", "title": "commit_upload", "use_when": [ "提交文件上传" ] }, "drive.copy_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.drive.copy_document", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "将指定节点复制到目标文件夹。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“将指定节点复制到目标文件夹。”所述变更时不要使用" ], "canonical_path": "drive.copy_document", "cli_name": "copy", "cli_path": "drive copy", "confirmation": "not_required", "description": "将指定节点复制到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时复制到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有可查看下载权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：复制操作底层可能异步执行，异步时操作已提交但新节点 ID 无法立即返回，请稍后查看目标文件夹确认结果。", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive copy --node \u003cID\u003e [--folder \u003cTARGET\u003e] [--workspace \u003cWS\u003e]", "dws drive copy --node \u003c源文件dentryUuid\u003e --folder \u003c我的文件rootFolderId\u003e --format json" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "copy_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "copy_document", "parameter_count": 3, "parameters": { "folder": { "description": "目标文件夹 nodeId", "property": "folder", "required": false, "type": "string" }, "node": { "description": "文档/文件 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID", "property": "workspace", "required": false, "type": "string" } }, "path": "drive.copy_document", "primary_cli_path": "drive copy", "product_id": "drive", "reviewed": false, "risk": "medium", "source": "hardcoded:drive", "title": "将指定节点复制到目标文件夹", "use_when": [ "── 场景 A: 复制钉盘文件到知识库空间根目录 ──", "── 场景 C: 复制钉盘文件到钉盘 space 下的子文件夹 ──", "── 场景默认: 用户未指定目标位置 → 复制/移动到「我的文件」根目录 ──", "复制文件/移动文件/搬到/移到" ] }, "drive.create_folder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.create_folder", "skills/mono/references/products/doc.md", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "创建文件夹", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建文件夹”所述变更时不要使用" ], "canonical_path": "drive.create_folder", "cli_name": "mkdir", "cli_path": "drive mkdir", "confirmation": "not_required", "description": "在钉盘中创建一个新文件夹\r\n最简用法：只传 name，文件夹会创建在当前用户「我的文件」的根目录下。\r\n如果想创建在某个子文件夹里，传 parentId（从 list_files 或 create_folder 的返回值中获取）。\r\n创建成功后返回 fileId，可直接用于后续操作（如在该文件夹下继续创建子文件夹或上传文件）。", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive mkdir --name \"项目资料\"", "dws drive mkdir --name \"子目录\" --folder \u003cdentryUuid\u003e" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "create_folder" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_folder", "parameter_count": 3, "parameters": { "folder": { "description": "父节点 ID (dentryUuid)，不传则在空间根目录下创建 (可选)", "property": "folder", "required": false, "type": "string" }, "name": { "description": "文件夹名称，最长 50 字符 (必填)", "interface_description": "文件夹名称，最长 50 个字符", "property": "name", "required": true, "type": "string" }, "space-id": { "description": "目标空间 ID，不传则使用「我的文件」 (可选)", "interface_description": "空间 ID。绝大多数情况下不需要传，后端自动使用当前用户默认空间 spaceId", "property": "spaceId", "required": false, "type": "string" } }, "path": "drive.create_folder", "primary_cli_path": "drive mkdir", "product_id": "drive", "risk": "medium", "source": "hardcoded:drive", "title": "创建文件夹", "use_when": [ "5. 创建文件夹", "新建文件夹/创建目录" ] }, "drive.delete_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.drive.delete_document", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "用户未明确要求“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。”、目标不清楚或尚未确认时不要使用" ], "canonical_path": "drive.delete_document", "cli_name": "delete", "cli_path": "drive delete", "confirmation": "user_required", "description": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。\r\n\r\n支持范围：\r\n- 知识库（workspace）下的文档节点、文件夹节点\r\n- 钉盘「我的文件」或「团队空间（space）」下的文件、文件夹节点（但钉盘操作仍建议走钉盘MCP服务）\r\n\r\n不支持的操作：\r\n- 不支持直接删除知识库本身（workspace）\r\n- 不支持直接删除团队空间（space）\r\n\r\n权限要求：\r\n- 对目标节点有管理权限（owner 或被授予管理权限的成员）\r\n\r\n注意事项：\r\n- 删除操作不可立即撤销，请在调用前向用户确认\r\n- 删除文件夹时，文件夹内的所有子节点也会一并移入回收站", "display": "钉盘文件管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws drive delete --node \u003cdentryUuid\u003e --format json # 查询 fileId: dws drive list" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "delete_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_document", "parameter_count": 1, "parameters": { "node": { "description": "文件/文件夹 ID (dentryUuid)，即 drive list 返回的 fileId (必填)", "property": "node", "required": true, "type": "string" } }, "path": "drive.delete_document", "primary_cli_path": "drive delete", "product_id": "drive", "reviewed": false, "risk": "high", "source": "hardcoded:drive", "title": "删除节点", "use_when": [ "删除文件/删除文件夹/移到回收站", "正确流程：1.向用户展示\"即将删除「文件名」到回收站\" → 2.等用户确认 → 3.执行下面命令" ] }, "drive.download_file": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.download_file", "skills/mono/references/intent-guide.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取文件下载链接", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "把这个在线表格导出为 xlsx 文件；在线表格格式转换" ], "canonical_path": "drive.download_file", "cli_name": "download", "cli_path": "drive download", "confirmation": "not_required", "description": "获取钉盘普通文件的下载链接。调用钉盘文件下载接口，返回 OSS 预签名下载链接，链接有效期 15 分钟", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive download --help", "dws drive download --node \u003cdentryUuid\u003e --output ./report.pdf" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "download_file" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "download_file", "parameter_count": 3, "parameters": { "node": { "description": "文件 ID (dentryUuid) (必填)", "property": "node", "required": true, "type": "string" }, "output": { "description": "本地保存路径 (文件路径或目录，必填)", "property": "output", "required": true, "type": "string" }, "space-id": { "description": "文件所属空间 ID (可选)", "interface_description": "文件所属空间 ID", "property": "spaceId", "required": false, "type": "string" } }, "path": "drive.download_file", "primary_cli_path": "drive download", "product_id": "drive", "risk": "low", "source": "hardcoded:drive", "title": "下载文件", "use_when": [ "4. 下载文件到本地", "下载文件", "查看具体命令的完整参数说明", "读一下这个 xlsx 的数据\" / xlsx 节点链接；下载本地表格文件" ] }, "drive.get_file_info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.get_file_info", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取文件元数据信息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取文件元数据信息”" ], "canonical_path": "drive.get_file_info", "cli_name": "info", "cli_path": "drive info", "confirmation": "not_required", "description": "获取钉盘中指定节点（文件或文件夹）的元数据信息，包括文件名、类型、状态、路径、创建时间、文件大小等", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive info --node \u003cdentryUuid\u003e", "dws drive info --node \u003cdentryUuid\u003e --format json" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "get_file_info" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_file_info", "parameter_count": 2, "parameters": { "node": { "description": "节点 ID (dentryUuid) (必填)", "property": "node", "required": true, "type": "string" }, "space-id": { "description": "节点所属空间 ID (可选)", "interface_description": "节点所属空间 ID。可不传，后端自动从 fileId（dentryUuid 格式）中解析出 spaceId", "property": "spaceId", "required": false, "type": "string" } }, "path": "drive.get_file_info", "primary_cli_path": "drive info", "product_id": "drive", "risk": "low", "source": "hardcoded:drive", "title": "获取文件元数据信息", "use_when": [ "3. 查看文件元数据", "文件详情/文件信息" ] }, "drive.get_upload_info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.get_upload_info", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取文件上传信息", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取文件上传信息”" ], "canonical_path": "drive.get_upload_info", "cli_name": "upload-info", "cli_path": "drive upload-info", "confirmation": "not_required", "description": "文件上传流程：\r\nStep 1：调用本接口获取预签名的 OSS 上传 URL\r\nStep 2：使用 Step 1 返回的 URL 将文件 PUT 到 OSS\r\nStep 3：调用commit_upload 提交文件，传入本接口返回的 uploadId 与对应的 fileName、fileSize 完成文件上传", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive upload-info --file-name \"report.pdf\" --file-size 102400", "dws drive upload-info --file-name \"slides.pptx\" --file-size 512000 --folder \u003cdentryUuid\u003e" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "get_upload_info" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_upload_info", "parameter_count": 5, "parameters": { "file-name": { "description": "文件名，须包含扩展名，如 报告.pdf (必填)", "interface_description": "文件名，须包含扩展名，如 报告.pdf。", "property": "fileName", "required": true, "type": "string" }, "file-size": { "description": "文件大小（字节）(必填)", "interface_description": "文件大小（字节），用于服务端生成上传凭证和后续完整性校验。", "interface_type": "number", "property": "fileSize", "required": true, "type": "integer" }, "folder": { "description": "父节点 ID (dentryUuid)，不传则上传到空间根目录 (可选)", "property": "folder", "required": false, "type": "string" }, "mime-type": { "description": "文件 MIME 类型，如 application/pdf，不传则自动推断 (可选)", "interface_description": "文件 MIME 类型，如 application/pdf。不传时由服务端根据文件扩展名自动推断。", "property": "mimeType", "required": false, "type": "string" }, "space-id": { "description": "目标空间 ID，不传则使用「我的文件」 (可选)", "interface_description": "目标空间 ID。不传时后端自动使用当前用户「我的文件」对应的 spaceId。", "property": "spaceId", "required": false, "type": "string" } }, "path": "drive.get_upload_info", "primary_cli_path": "drive upload-info", "product_id": "drive", "risk": "low", "source": "hardcoded:drive", "title": "get_upload_info", "use_when": [ "获取文件上传信息" ] }, "drive.list_files": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.list_files", "skills/mono/references/intent-guide.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取文件/文件夹列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "帮我看看知识库里的文件；知识库节点列表" ], "canonical_path": "drive.list_files", "cli_name": "list", "cli_path": "drive list", "confirmation": "not_required", "description": "列出钉盘指定文件夹下的文件和文件夹，支持分页和排序\r\n最简用法：不传任何参数，列出默认空间根目录下的内容。\r\n如果想列出某个子文件夹的内容，传 parentId（从 create_folder 或 list_files 返回值中获取）。\r\n使用 nextToken 游标翻页：首次不传，后续翻页传上一次返回的 nextToken；nextToken 为 null 表示没有更多数据。", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive list --help", "dws drive list --limit 20" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "list_files" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_files", "parameter_count": 8, "parameters": { "cursor": { "description": "分页游标，首次不传 (可选)", "property": "cursor", "required": false, "type": "string" }, "folder": { "description": "父节点 ID (dentryUuid)，不传则列出空间根目录 (可选)", "property": "folder", "required": false, "type": "string" }, "limit": { "default": "20", "description": "每页返回数量，默认 20，最大 50", "property": "limit", "required": false, "type": "integer" }, "order": { "description": "排序方向: asc|desc，默认 desc (可选，仅钉盘)", "interface_description": "排序方向。asc（升序）/ desc（降序），默认 desc", "property": "order", "required": false, "type": "string" }, "order-by": { "description": "排序字段: createTime|modifyTime|name (可选，仅钉盘)", "interface_description": "排序字段。可选值：createTime（创建时间）、modifyTime（修改时间）、name（名称）", "property": "orderBy", "required": false, "type": "string" }, "space-id": { "description": "钉盘空间 ID (纯数字)，不传则使用「我的文件」(可选)", "interface_description": "空间 ID。绝大多数情况下不需要传，后端自动使用当前用户「我的文件」对应的 spaceId", "property": "spaceId", "required": false, "type": "string" }, "thumbnail": { "description": "是否返回缩略图信息 (可选，仅钉盘)", "property": "thumbnail", "required": false, "type": "boolean" }, "workspace": { "description": "文档空间/知识库 ID (加密 string 或 URL)，传入则路由到文档空间 (可选)", "property": "workspace", "required": false, "type": "string" } }, "path": "drive.list_files", "primary_cli_path": "drive list", "product_id": "drive", "risk": "low", "source": "hardcoded:drive", "title": "获取文件/文件夹列表", "use_when": [ "1. 浏览「我的文件」根目录", "2. 进入子目录 — 提取 dentryUuid 作为 folder", "── 场景 C: 复制钉盘文件到钉盘 space 下的子文件夹 ──", "── 场景默认: 用户未指定目标位置 → 复制/移动到「我的文件」根目录 ──", "我的文件/钉盘/网盘/云盘", "查看具体命令的完整参数说明" ] }, "drive.list_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.drive.list_permission", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询知识库节点当前的成员权限列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员”请改用 dws drive permission add", "要“从知识库节点移除指定企业用户的权限（仅支持 USER 类型）”请改用 dws drive permission remove", "要“修改企业用户在知识库节点上的角色（仅支持 USER 类型）”请改用 dws drive permission update" ], "canonical_path": "drive.list_permission", "cli_name": "list", "cli_path": "drive permission list", "confirmation": "not_required", "description": "查询知识库节点当前的成员权限列表。", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive permission list --node \u003cID\u003e" ], "group": "permission", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_permission", "parameter_count": 4, "parameters": { "filter-role": { "description": "按角色过滤: OWNER / MANAGER / EDITOR / DOWNLOADER / READER", "property": "filterRole", "required": false, "type": "string" }, "limit": { "default": "30", "description": "返回成员数上限，默认 30，最大 200", "property": "limit", "required": false, "type": "integer" }, "node": { "description": "目标节点 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (选填)", "property": "workspace", "required": false, "type": "string" } }, "path": "drive.list_permission", "primary_cli_path": "drive permission list", "product_id": "drive", "reviewed": false, "risk": "low", "source": "hardcoded:drive", "title": "查询节点成员列表", "use_when": [ "查询知识库节点当前的成员权限列表。" ] }, "drive.list_spaces": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.drive.list_spaces", "skills/mono/references/intent-guide.md", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取当前用户可访问的空间列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "列出钉盘团队空间；列出钉盘空间" ], "canonical_path": "drive.list_spaces", "cli_name": "list-spaces", "cli_path": "drive list-spaces", "confirmation": "not_required", "description": "获取当前用户可访问的空间列表。\r\n最简用法：不传任何参数，返回所有企业空间。\r\n空间类型筛选：通过 spaceType 参数可以筛选返回的空间类型：\r\norgSpace（或 不传）：返回企业空间列表\r\nmySpace：返回用户的\"我的文件\"个人空间\r\n支持游标分页，使用 nextToken 进行翻页（仅企业空间支持分页）。\r\n返回结果说明：\r\n当 spaceType 为 orgSpace ，返回企业团队空间列表\r\n当 spaceType 为 mySpace 时，返回单个\"我的文件\"空间\r\n如果 nextToken 不为空，表示还有更多空间可以查询（仅企业空间）", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive list-spaces # deprecated", "dws drive list-spaces --space-type orgSpace --limit 20 --cursor \u003cTOKEN\u003e" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "list_spaces" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_spaces", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标，仅企业空间支持分页 (可选)", "property": "cursor", "required": false, "type": "string" }, "limit": { "default": "20", "description": "每页返回数量 (默认 20，最大 50)，仅 spaceType 为 orgSpace 时有效", "property": "limit", "required": false, "type": "integer" }, "space-type": { "description": "空间类型: orgSpace=企业空间(默认), mySpace=我的文件 (可选)", "interface_description": "空间类型。可选值：orgSpace（企业空间）、mySpace（我的文件）。不传时默认为 orgSpace", "property": "spaceType", "required": false, "type": "string" } }, "path": "drive.list_spaces", "primary_cli_path": "drive list-spaces", "product_id": "drive", "reviewed": false, "risk": "low", "source": "hardcoded:drive", "title": "list_spaces", "use_when": [ "获取当前用户可访问的空间列表。" ] }, "drive.move_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.drive.move_document", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "将指定节点移动到目标文件夹。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“将指定节点移动到目标文件夹。”所述变更时不要使用" ], "canonical_path": "drive.move_document", "cli_name": "move", "cli_path": "drive move", "confirmation": "not_required", "description": "将指定节点移动到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时移动到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有编辑权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：移动操作底层可能异步执行，异步时操作已提交但无法立即确认完成，请稍后查看目标文件夹确认结果。", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive move --node \u003cID\u003e [--folder \u003cTARGET\u003e] [--workspace \u003cWS\u003e]", "dws drive move --node \u003c源文件dentryUuid\u003e --folder \u003c目标space的rootFolderId\u003e --format json" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "move_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "move_document", "parameter_count": 3, "parameters": { "folder": { "description": "目标文件夹 nodeId", "property": "folder", "required": false, "type": "string" }, "node": { "description": "文档/文件 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID", "property": "workspace", "required": false, "type": "string" } }, "path": "drive.move_document", "primary_cli_path": "drive move", "product_id": "drive", "reviewed": false, "risk": "medium", "source": "hardcoded:drive", "title": "移动节点", "use_when": [ "── 场景 B: 移动钉盘文件到另一个钉盘 space 根目录 ──" ] }, "drive.permission_remove": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.drive.permission_remove", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员”请改用 dws drive permission add", "要“修改企业用户在知识库节点上的角色（仅支持 USER 类型）”请改用 dws drive permission update", "要“查询知识库节点当前的成员权限列表”请改用 dws drive permission list" ], "canonical_path": "drive.permission_remove", "cli_name": "remove", "cli_path": "drive permission remove", "confirmation": "user_required", "description": "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量移除成员在节点上的权限，移除后相关用户将无法通过该节点的直接授权访问内容（若有父节点继承权限则仍可通过继承权限访问）。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口移除。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。DOWNLOADER / READER / 非成员调用会返回 `forbidden.accessDenied`，错误信息会明确提示所需的最低角色。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。", "display": "钉盘文件管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws drive permission remove --node \u003cID\u003e --users uid1" ], "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "remove_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "permission_remove", "parameter_count": 3, "parameters": { "node": { "description": "目标节点 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "users": { "description": "用户 userId 列表，逗号分隔 (必填)", "property": "users", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (选填)", "property": "workspace", "required": false, "type": "string" } }, "path": "drive.permission_remove", "primary_cli_path": "drive permission remove", "product_id": "drive", "reviewed": false, "risk": "high", "source": "hardcoded:drive", "title": "移除节点成员权限", "use_when": [ "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。" ] }, "drive.permission_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.drive.permission_update", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "修改企业用户在知识库节点上的角色（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员”请改用 dws drive permission add", "要“从知识库节点移除指定企业用户的权限（仅支持 USER 类型）”请改用 dws drive permission remove", "要“查询知识库节点当前的成员权限列表”请改用 dws drive permission list" ], "canonical_path": "drive.permission_update", "cli_name": "update", "cli_path": "drive permission update", "confirmation": "not_required", "description": "修改企业用户在知识库节点上的角色（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量调整成员角色，同一成员在同一节点只能拥有一个角色，变更后旧角色自动替换。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口变更。\r\n- 若成员的角色来自父节点的权限继承（PASS_ON 模式），且继承的角色高于目标角色，接口会拒绝操作。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。\r\n- 入参直接采用扁平的 `userIds: List\u003cString\u003e`，每个元素为钉钉 staffId（外部 userId 格式，由钉钉开放平台体系下颁发）。", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive permission update --node \u003cID\u003e --users uid1 --role EDITOR" ], "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "update_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "permission_update", "parameter_count": 4, "parameters": { "node": { "description": "目标节点 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "role": { "description": "新角色: MANAGER / EDITOR / DOWNLOADER / READER (必填)", "property": "role", "required": true, "type": "string" }, "users": { "description": "用户 userId 列表，逗号分隔 (必填)", "property": "users", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (选填)", "property": "workspace", "required": false, "type": "string" } }, "path": "drive.permission_update", "primary_cli_path": "drive permission update", "product_id": "drive", "reviewed": false, "risk": "medium", "source": "hardcoded:drive", "title": "变更节点成员角色", "use_when": [ "修改企业用户在知识库节点上的角色（仅支持 USER 类型）。" ] }, "drive.publish_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/drive.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "查询文件当前是否处于互联网公开发布状态，以及公开发布的权限设置", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要查询文件当前是否处于互联网公开发布状态，以及公开发布的权限设置时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "drive.publish_get", "cli_name": "get", "cli_path": "drive publish get", "confirmation": "not_required", "description": "查询文件当前是否处于互联网公开发布状态，以及公开发布的权限设置。", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive publish get --node \u003cfileId\u003e", "dws drive publish get --node \u003cdentryUuid\u003e" ], "group": "publish", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "publish_get", "parameter_count": 1, "parameters": { "node": { "description": "目标文件 ID (dentryUuid) 或 URL (必填)", "property": "node", "required": true, "type": "string" } }, "path": "drive.publish_get", "primary_cli_path": "drive publish get", "product_id": "drive", "reviewed": false, "risk": "medium", "source": "hardcoded:drive", "title": "查询文件公开发布状态", "use_when": [ "查看公开状态/是否公开/发布状态" ] }, "drive.publish_set": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/drive.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "[危险] 将文件设置为互联网公开发布", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要[危险] 将文件设置为互联网公开发布时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "drive.publish_set", "cli_name": "set", "cli_path": "drive publish set", "confirmation": "not_required", "description": "[危险] 将文件设置为互联网公开发布。公开后任何人通过链接即可访问，无需登录钉钉。\n操作者需要是该文件的管理员或拥有者。执行前需要确认，或传入 --yes 跳过确认。\n\n公开权限 (--permission): READER(仅可查看) / DOWNLOADER(可查看和下载，默认) / EDITOR(可编辑)", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive publish set --node \u003cfileId\u003e [--permission READER|DOWNLOADER|EDITOR]", "dws drive publish set --node \u003cdentryUuid\u003e" ], "group": "publish", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "publish_set", "parameter_count": 2, "parameters": { "node": { "description": "目标文件 ID (dentryUuid) 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "permission": { "description": "公开后的权限: READER / DOWNLOADER(默认) / EDITOR", "property": "permission", "required": false, "type": "string" } }, "path": "drive.publish_set", "primary_cli_path": "drive publish set", "product_id": "drive", "reviewed": false, "risk": "medium", "source": "hardcoded:drive", "title": "[危险] 设置文件为互联网公开", "use_when": [ "公开文件/互联网公开/设置公开/让互联网所有人可访问" ] }, "drive.publish_unset": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/drive.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "[危险] 关闭文件的互联网公开发布", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要[危险] 关闭文件的互联网公开发布时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "drive.publish_unset", "cli_name": "unset", "cli_path": "drive publish unset", "confirmation": "not_required", "description": "[危险] 关闭文件的互联网公开发布。关闭后外部用户将无法再通过链接访问。执行前需要确认，或传入 --yes 跳过确认。", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive publish unset --node \u003cfileId\u003e", "dws drive publish unset --node \u003cdentryUuid\u003e" ], "group": "publish", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "publish_unset", "parameter_count": 1, "parameters": { "node": { "description": "目标文件 ID (dentryUuid) 或 URL (必填)", "property": "node", "required": true, "type": "string" } }, "path": "drive.publish_unset", "primary_cli_path": "drive publish unset", "product_id": "drive", "reviewed": false, "risk": "medium", "source": "hardcoded:drive", "title": "[危险] 关闭文件互联网公开", "use_when": [ "关闭公开/取消公开/取消互联网访问" ] }, "drive.recent": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/drive.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "获取当前用户最近访问或编辑过的文档列表", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要获取当前用户最近访问或编辑过的文档列表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "drive.recent", "cli_name": "recent", "cli_path": "drive recent", "confirmation": "not_required", "description": "获取当前用户最近访问或编辑过的文档列表。\n\n支持按文档类型、操作类型、创建人、所属组织过滤。所有过滤条件均为可选，不传则不过滤。\n\n操作类型 (--operate-type):\n 0 最近访问（含打开+编辑）（默认）\n 1 最近编辑\n 不传默认仅返回最近访问(0)\n\n创建人类型 (--creator-type):\n 0 全部 (默认)\n 1 我创建的\n 2 他人创建的", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive recent", "dws drive recent --operate-type 1" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "recent", "parameter_count": 6, "parameters": { "creator-type": { "description": "按创建人过滤: 0=全部, 1=我创建, 2=他人创建", "property": "creatorType", "required": false, "type": "integer" }, "cursor": { "description": "分页游标 (从上次结果的 nextCursor 获取)", "property": "cursor", "required": false, "type": "string" }, "file-types": { "default": "[]", "description": "按文档类型过滤，逗号分隔 (参考 RecentAccessType 枚举)", "property": "fileTypes", "required": false, "type": "string" }, "limit": { "description": "每页数量 (默认 20，最大 20)", "property": "limit", "required": false, "type": "integer" }, "operate-type": { "default": "[]", "description": "按操作类型过滤: 0=最近访问(默认), 1=最近编辑; 不传默认仅最近访问", "property": "operateType", "required": false, "type": "string" }, "org-ids": { "default": "[]", "description": "按资源所属组织 ID 过滤，逗号分隔", "property": "orgIds", "required": false, "type": "string" } }, "path": "drive.recent", "primary_cli_path": "drive recent", "product_id": "drive", "reviewed": false, "risk": "low", "source": "hardcoded:drive", "title": "获取最近访问/编辑的文档列表", "use_when": [ "最近访问/最近打开/最近编辑/最近文档" ] }, "drive.recycle_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/drive.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "查看回收站文件列表", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要查看回收站文件列表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "drive.recycle_list", "cli_name": "list", "cli_path": "drive recycle list", "confirmation": "not_required", "description": "查看回收站文件列表", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive recycle list", "dws drive recycle list --space-id 12345 --limit 10" ], "group": "recycle", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "recycle_list", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标", "property": "cursor", "required": false, "type": "string" }, "limit": { "description": "返回条数上限 (默认20，最大50)", "property": "limit", "required": false, "type": "integer" }, "space-id": { "description": "钉盘空间 ID (选填，不传则返回所有空间)", "property": "spaceId", "required": false, "type": "string" } }, "path": "drive.recycle_list", "primary_cli_path": "drive recycle list", "product_id": "drive", "reviewed": false, "risk": "low", "source": "hardcoded:drive", "title": "查看回收站文件列表", "use_when": [ "8. 查看回收站并还原文件", "回收站/查看回收站/回收站列表/回收站里有什么" ] }, "drive.recycle_restore": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/drive.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "还原回收站中的文件", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要还原回收站中的文件时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "drive.recycle_restore", "cli_name": "restore", "cli_path": "drive recycle restore", "confirmation": "not_required", "description": "还原回收站中的文件", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive recycle restore --id \u003crecycleItemId\u003e", "dws drive recycle restore --id \u003crecycleItemId\u003e --format json" ], "group": "recycle", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "recycle_restore", "parameter_count": 1, "parameters": { "id": { "description": "回收项 ID (必填，从 recycle list 获取)", "property": "id", "required": true, "type": "string" } }, "path": "drive.recycle_restore", "primary_cli_path": "drive recycle restore", "product_id": "drive", "reviewed": false, "risk": "low", "source": "hardcoded:drive", "title": "还原回收站中的文件", "use_when": [ "8. 查看回收站并还原文件", "恢复文件/还原删除的文件/从回收站恢复/还原回收站文件" ] }, "drive.rename_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.drive.rename_document", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "对指定节点进行重命名。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“对指定节点进行重命名。”所述变更时不要使用" ], "canonical_path": "drive.rename_document", "cli_name": "rename", "cli_path": "drive rename", "confirmation": "not_required", "description": "对指定节点进行重命名。\r\n\r\n支持范围：\r\n- 知识库（workspace）下的文档节点、文件夹节点\r\n\r\n权限要求：\r\n- 对目标节点有编辑权限", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive rename --node \u003cID\u003e --name \"新名称\"" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "rename_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "rename_document", "parameter_count": 2, "parameters": { "name": { "description": "新名称 (必填)", "property": "name", "required": true, "type": "string" }, "node": { "description": "文档/文件 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" } }, "path": "drive.rename_document", "primary_cli_path": "drive rename", "product_id": "drive", "reviewed": false, "risk": "medium", "source": "hardcoded:drive", "title": "对指定节点进行重命名", "use_when": [ "重命名/改名" ] }, "drive.search_files": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.drive.search_files", "skills/mono/references/intent-guide.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/drive.md", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "在钉盘空间中搜索文件、文件夹或空间，支持通过 searchTarget 参数切换搜索目标。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "在知识库里搜方案；空间内搜索" ], "canonical_path": "drive.search_files", "cli_name": "search", "cli_path": "drive search", "confirmation": "not_required", "description": "在钉盘空间中搜索文件、文件夹或空间，支持通过 searchTarget 参数切换搜索目标。\r\n\r\n支持三种搜索目标：\r\n1. searchTarget=all（默认）：同时搜索文件和空间，返回混合结果\r\n2. searchTarget=file：搜索钉盘中的文件和文件夹，支持按文件类型、扩展名过滤\r\n3. searchTarget=space：搜索钉盘团队空间，返回匹配的空间列表，可快速定位目标空间\r\n\r\n推荐搜索流程：\r\n- 不确定目标 → searchTarget=all 获取所有匹配结果\r\n- 明确知道空间名 → searchTarget=space 定位空间 → list_files(parentId=rootFolderId) 遍历\r\n- 知道文件名/内容关键词 → searchTarget=file 直接搜索文件\r\n- 需要浏览指定空间的全部内容 → 使用 list_files(spaceId=xxx) 遍历，而非搜索\r\n\r\n搜索结果通过 type 字段区分：SPACE（空间）、FILE（普通文件）、FOLDER（文件夹）、ALIDOC（钉钉在线文档）。\r\n搜索范围为用户在当前组织内有权限访问的所有钉盘文件（我的文件+团队文件）。\r\n\r\n重要提示：搜索结果按相关性排序，第一页结果最相关。如果第一页未找到目标，建议优先调整搜索条件（更精确的关键词、添加 fileTypes/extensions 过滤、缩小时间范围等），而不是反复翻页。", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive search --help", "dws drive search --query \"季度汇报\"" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "search_files" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_files", "parameter_count": 11, "parameters": { "created-from": { "description": "创建时间起始 (毫秒时间戳，含)", "property": "createdFrom", "required": false, "type": "integer" }, "created-to": { "description": "创建时间截止 (毫秒时间戳，含)", "property": "createdTo", "required": false, "type": "integer" }, "creator-uids": { "description": "按创建者用户 ID 过滤，逗号分隔", "property": "creatorUids", "required": false, "type": "array" }, "cursor": { "description": "分页游标，从上次返回的 nextCursor 获取 (可选)", "property": "cursor", "required": false, "type": "string" }, "extensions": { "description": "按文件扩展名过滤，不含点号，逗号分隔 (如 pdf,docx,adoc)", "interface_description": "按文件扩展名精确过滤，不含点号。仅 searchTarget=file 或 all 时生效。如 [\"pdf\", \"docx\", \"adoc\"]。", "property": "extensions", "required": false, "type": "array" }, "file-types": { "description": "按文件内容类型过滤，逗号分隔: alidoc,document,image,video,audio,archive (仅 target=file/all 生效)", "interface_description": "按文件内容类型过滤，仅 searchTarget=file 或 all 时生效。可选值：alidoc（钉钉在线文档）、document（本地文档，如 Word/Excel/PDF）、image（图片）、video（视频）、audio（音频）、archive（压缩包）。不传返回所有类型。如需精确匹配具体格式（如只搜 pdf），请使用 extensions 参数。", "property": "fileTypes", "required": false, "type": "array" }, "limit": { "description": "每页返回数量（默认 10，最大 30）", "property": "limit", "required": false, "type": "integer" }, "modified-from": { "description": "修改时间起始 (毫秒时间戳，含)", "property": "modifiedFrom", "required": false, "type": "integer" }, "modified-to": { "description": "修改时间截止 (毫秒时间戳，含)", "property": "modifiedTo", "required": false, "type": "integer" }, "query": { "description": "搜索关键词 (必填)", "property": "query", "required": true, "type": "string" }, "target": { "description": "搜索范围: all(默认,聚合钉盘+文档空间) | file(仅钉盘文件) | space(仅钉盘空间) (可选)", "property": "target", "required": false, "type": "string" } }, "path": "drive.search_files", "primary_cli_path": "drive search", "product_id": "drive", "reviewed": false, "risk": "low", "source": "hardcoded:drive", "title": "钉盘文件搜索", "use_when": [ "搜一下有没有叫XX的文件；全局搜索", "搜索钉盘文件/钉盘里找个文件/查找某个钉盘文件/钉盘中搜索", "查看具体命令的完整参数说明", "钉盘/网盘/我的文件里搜" ] }, "drive.upload": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/intent-guide.md", "skills/mono/references/products/drive.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "上传本地文件到钉盘", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“上传本地文件到钉盘”所述变更时不要使用" ], "canonical_path": "drive.upload", "cli_name": "upload", "cli_path": "drive upload", "confirmation": "not_required", "description": "将本地文件上传（三步自动完成）。\n\n路由规则:\n 默认（无 --workspace） → 上传到钉盘（我的文件或指定空间）\n --workspace \u003cid\u003e → 上传到文档空间/知识库\n\n流程:\n 1. 获取 OSS 上传凭证\n 2. HTTP PUT 上传文件二进制到 OSS\n 3. 提交文件入库\n\n上传位置: --folder 指定父目录，不传则上传到空间根目录。", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive upload --help", "dws drive upload --file ./report.pdf" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "is_alias": false, "name": "upload", "parameter_count": 7, "parameters": { "convert": { "description": "是否转换为钉钉在线文档 (仅文档空间上传时生效)", "property": "convert", "required": false, "type": "boolean" }, "file": { "description": "本地文件路径 (必填)", "property": "file", "required": true, "type": "string" }, "file-name": { "description": "文件显示名称 (默认使用文件名)", "property": "fileName", "required": false, "type": "string" }, "folder": { "description": "父节点 ID，不传则上传到空间根目录 (可选)", "property": "folder", "required": false, "type": "string" }, "mime-type": { "description": "文件 MIME 类型，不传则自动推断 (可选)", "property": "mimeType", "required": false, "type": "string" }, "space-id": { "description": "目标钉盘空间 ID，不传则使用「我的文件」 (可选)", "property": "spaceId", "required": false, "type": "string" }, "workspace": { "description": "目标知识库 ID，传入时路由到文档空间上传 (可选)", "property": "workspace", "required": false, "type": "string" } }, "path": "drive.upload", "primary_cli_path": "drive upload", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "hardcoded:drive", "title": "上传本地文件到钉盘或文档空间", "use_when": [ "6. 上传文件（首选 upload 命令，自动完成三步流程）", "上传文件\"（未指定目标）；默认钉盘", "上传文件/传文件到钉盘", "上传文件到钉盘/我的文件；钉盘上传", "上传本地文件到钉盘", "帮我把这个文件传到网盘；钉盘上传", "查看具体命令的完整参数说明" ] }, "live.get_my_lives": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.live.prod.json#live.get_my_lives", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "查看我的直播列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查看我的直播列表”" ], "canonical_path": "live.get_my_lives", "cli_name": "list", "cli_path": "live stream list", "confirmation": "not_required", "description": "获取当前用户发起的直播列表，包含每场直播的基础信息与统计数据。返回字段包括：直播标题、封面图 URL、直播 ID、主播昵称、开始/结束时间戳、播放时长（毫秒）、观看量（UV）及直播状态（如已结束）。数据按分页返回，支持判断是否还有更多内容。适用于个人直播管理、历史记录查看等场景，仅展示当前用户有权限访问的直播内容。", "display": "直播列表 / 信息", "effect": "read", "effect_source": "command-verb", "examples": [ "dws live stream list" ], "group": "stream", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "live", "rpc_name": "get_my_lives" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_my_lives", "parameter_count": 0, "parameters": {}, "path": "live.get_my_lives", "primary_cli_path": "live stream list", "product_id": "live", "risk": "low", "source": "runtime:live", "title": "获取当前用户发起的直播列表", "use_when": [ "查看我的直播列表" ] }, "mail.batch_delete_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_message", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量删除邮件", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建回复草稿”请改用 dws mail message reply", "要“创建转发草稿”请改用 dws mail message forward", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.batch_delete_message", "cli_name": "batch-delete", "cli_path": "mail message batch-delete", "confirmation": "user_required", "description": "批量删除邮件", "display": "邮箱 / 邮件收发", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws mail message batch-delete --email user@company.com --ids \u003cid1\u003e,\u003cid2\u003e" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "batch_delete_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "batch_delete_message", "parameter_count": 2, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "interface_description": "邮箱地址", "property": "email", "required": true, "type": "string" }, "ids": { "description": "要删除的邮件 ID 列表，逗号分隔 (必填)", "interface_description": "邮件id列表", "interface_type": "array", "property": "ids", "required": true, "type": "string" } }, "path": "mail.batch_delete_message", "primary_cli_path": "mail message batch-delete", "product_id": "mail", "reviewed": false, "risk": "high", "source": "runtime:mail", "title": "批量删除邮件", "use_when": [ "批量删除邮件" ] }, "mail.batch_delete_user_mail_contacts": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_user_mail_contacts", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量删除用户邮箱联系人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“修改用户邮箱联系人信息”请改用 dws mail contact update", "要“列出用户邮箱联系人”请改用 dws mail contact list", "要“创建用户邮箱联系人”请改用 dws mail contact create" ], "canonical_path": "mail.batch_delete_user_mail_contacts", "cli_name": "batch-delete", "cli_path": "mail contact batch-delete", "confirmation": "user_required", "description": "批量删除用户邮箱联系人", "display": "邮箱 / 邮件收发", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws mail contact batch-delete --email user@company.com --contact-ids \u003cid1\u003e,\u003cid2\u003e" ], "group": "contact", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "batch_delete_user_mail_contacts" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "batch_delete_user_mail_contacts", "parameter_count": 2, "parameters": { "contact-ids": { "description": "要删除的联系人 ID 列表，逗号分隔 (必填)", "interface_description": "要删除的联系人 id 列表", "interface_type": "array", "property": "contactIds", "required": true, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" } }, "path": "mail.batch_delete_user_mail_contacts", "primary_cli_path": "mail contact batch-delete", "product_id": "mail", "reviewed": false, "risk": "high", "source": "runtime:mail", "title": "batch_delete_user_mail_contacts", "use_when": [ "批量删除用户邮箱联系人" ] }, "mail.batch_move_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.batch_move_message", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量移动邮件到指定文件夹", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建回复草稿”请改用 dws mail message reply", "要“创建转发草稿”请改用 dws mail message forward", "要“批量删除邮件”请改用 dws mail message batch-delete" ], "canonical_path": "mail.batch_move_message", "cli_name": "batch-move", "cli_path": "mail message batch-move", "confirmation": "not_required", "description": "批量移动邮件到指定文件夹", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail message batch-move --email user@company.com --ids \u003cid1\u003e,\u003cid2\u003e --folder 6" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "batch_move_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "batch_move_message", "parameter_count": 3, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "interface_description": "邮箱地址", "property": "email", "required": true, "type": "string" }, "folder": { "description": "目标文件夹 ID (必填)", "interface_description": "目标文件夹", "property": "destinationFolderId", "required": true, "type": "string" }, "ids": { "description": "要移动的邮件 ID 列表，逗号分隔 (必填)", "interface_description": "邮件id列表", "interface_type": "array", "property": "ids", "required": true, "type": "string" } }, "path": "mail.batch_move_message", "primary_cli_path": "mail message batch-move", "product_id": "mail", "reviewed": false, "risk": "medium", "source": "runtime:mail", "title": "批量移动邮件", "use_when": [ "批量移动邮件到指定文件夹" ] }, "mail.create_download_session": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.create_download_session", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "下载邮件附件", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列举邮件附件”请改用 dws mail attachment list" ], "canonical_path": "mail.create_download_session", "cli_name": "download", "cli_path": "mail attachment download", "confirmation": "not_required", "description": "下载邮件附件", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail attachment download --email user@company.com --message-id \u003cmessageId\u003e --attachment-id \u003cattachmentId\u003e --name report.pdf", "dws mail attachment download --email user@company.com --message-id \u003cmessageId\u003e --attachment-id \u003cattachmentId\u003e --name img.png --output /tmp" ], "group": "attachment", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_download_session" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_download_session", "parameter_count": 5, "parameters": { "attachment-id": { "description": "附件唯一标识，取自 attachment list 的 id 字段 (必填)", "interface_description": "附件唯一标识", "property": "attachmentId", "required": true, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "message-id": { "description": "邮件唯一标识 messageId (必填)", "interface_description": "邮件的唯一标识id", "property": "messageId", "required": true, "type": "string" }, "name": { "description": "保存到本地的文件名，取自 attachment list 的 name 字段 (必填)", "property": "name", "required": true, "type": "string" }, "output": { "default": ".", "description": "保存目录，默认为当前目录", "property": "output", "required": false, "type": "string" } }, "path": "mail.create_download_session", "primary_cli_path": "mail attachment download", "product_id": "mail", "reviewed": false, "risk": "low", "source": "runtime:mail", "title": "创建附件下载会话", "use_when": [ "下载到指定目录", "再下载指定附件到当前目录（每次只能下载一个附件）", "步骤 5.3：对每个附件逐个下载（没有批量下载命令，必须循环调用）" ] }, "mail.create_draft": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.create_draft", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建邮件草稿", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“发送草稿箱中的邮件”请改用 dws mail draft send", "要“更新邮件草稿”请改用 dws mail draft update" ], "canonical_path": "mail.create_draft", "cli_name": "create", "cli_path": "mail draft create", "confirmation": "not_required", "description": "创建邮件草稿", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail draft create --from user@company.com --to colleague@company.com --subject \"草稿标题\" --content \"草稿正文\"", "dws mail draft create --from user@company.com --subject \"草稿标题\"" ], "group": "draft", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_draft" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_draft", "parameter_count": 7, "parameters": { "attachment": { "description": "附件文件路径，可多次指定 (可选)", "property": "attachment_local", "required": false, "type": "array" }, "cc": { "description": "抄送人列表", "interface_description": "抄送人Email地址列表", "interface_type": "array", "property": "ccRecipients", "required": false, "type": "string" }, "content": { "description": "邮件正文", "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": false, "type": "string" }, "from": { "description": "发件人邮箱 (必填)", "interface_description": "发信Email地址", "property": "from", "required": true, "type": "string" }, "inline-attachment": { "description": "内联附件文件路径（如图片），可多次指定，cid 自动生成 (可选)", "property": "inlineAttachment_local", "required": false, "type": "array" }, "subject": { "description": "邮件标题 (必填)", "interface_description": "邮件主题", "property": "subject", "required": true, "type": "string" }, "to": { "description": "收件人列表", "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": false, "type": "string" } }, "path": "mail.create_draft", "primary_cli_path": "mail draft create", "product_id": "mail", "reviewed": false, "risk": "medium", "source": "runtime:mail", "title": "创建邮件草稿", "use_when": [ "创建邮件草稿" ] }, "mail.create_forward_draft": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.create_forward_draft", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建转发草稿", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建回复草稿”请改用 dws mail message reply", "要“批量删除邮件”请改用 dws mail message batch-delete", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.create_forward_draft", "cli_name": "forward", "cli_path": "mail message forward", "confirmation": "not_required", "description": "创建转发草稿", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail message forward --from user@company.com --id \u003cmessageId\u003e", "dws mail message forward --from user@company.com --to colleague@company.com --id \u003cmessageId\u003e --subject \"Fwd: 周报\"" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_forward_draft" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_forward_draft", "parameter_count": 7, "parameters": { "attachment": { "description": "附件文件路径，可多次指定 (可选)", "property": "attachment_local", "required": false, "type": "array" }, "content": { "description": "转发附言", "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": false, "type": "string" }, "from": { "description": "发件人邮箱 (必填)", "interface_description": "发信Email地址", "property": "from", "required": true, "type": "string" }, "id": { "description": "要转发的邮件 ID (必填)", "interface_description": "转发的原始邮件id", "property": "messageId", "required": true, "type": "string" }, "inline-attachment": { "description": "内联附件文件路径（如图片），可多次指定，cid 自动生成 (可选)", "property": "inlineAttachment_local", "required": false, "type": "array" }, "subject": { "description": "转发邮件标题", "interface_description": "邮件主题", "property": "subject", "required": false, "type": "string" }, "to": { "description": "转发收件人列表", "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": false, "type": "string" } }, "path": "mail.create_forward_draft", "primary_cli_path": "mail message forward", "product_id": "mail", "reviewed": false, "risk": "medium", "source": "runtime:mail", "title": "创建转发草稿", "use_when": [ "创建转发草稿" ] }, "mail.create_mail_folder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.create_mail_folder", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建邮件文件夹", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“列举邮件文件夹”请改用 dws mail folder list", "要“删除邮件文件夹”请改用 dws mail folder delete", "要“更新邮件文件夹”请改用 dws mail folder update" ], "canonical_path": "mail.create_mail_folder", "cli_name": "create", "cli_path": "mail folder create", "confirmation": "not_required", "description": "该工具支持在指定邮箱下创建邮件文件夹。可以创建顶层文件夹，也可以在指定父文件夹下创建子文件夹。创建成功后返回新文件夹的 ID 和元信息。", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail folder create --email user@company.com --name \"项目资料\"", "dws mail folder create --email user@company.com --name \"子文件夹\" --folder \u003cfolderId\u003e" ], "group": "folder", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_mail_folder" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_mail_folder", "parameter_count": 3, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "interface_description": "邮件所属的邮箱地址", "property": "email", "required": true, "type": "string" }, "folder": { "description": "父文件夹 ID，不传则创建顶层文件夹 (可选)", "interface_description": "父文件夹唯一标识，不传则创建顶层文件夹", "property": "folder", "required": false, "type": "string" }, "name": { "description": "新建邮件文件夹名称 (必填)", "interface_description": "新建邮件文件夹名称", "property": "name", "required": true, "type": "string" } }, "path": "mail.create_mail_folder", "primary_cli_path": "mail folder create", "product_id": "mail", "risk": "medium", "source": "runtime:mail", "title": "创建邮件文件夹", "use_when": [ "1b. 创建顶层邮件文件夹", "1c. 创建子文件夹 — 先通过 folder list 获取父文件夹 id，再传给 --folder", "创建邮件文件夹/新建邮箱文件夹/新建邮件目录" ] }, "mail.create_reply_draft": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.create_reply_draft", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建回复草稿", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建转发草稿”请改用 dws mail message forward", "要“批量删除邮件”请改用 dws mail message batch-delete", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.create_reply_draft", "cli_name": "reply", "cli_path": "mail message reply", "confirmation": "not_required", "description": "创建回复草稿", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail message reply --from user@company.com --id \u003cmessageId\u003e", "dws mail message reply --from user@company.com --id \u003cmessageId\u003e --subject \"Re: 周报\" --content \"已收到，谢谢！\"" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_reply_draft" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_reply_draft", "parameter_count": 7, "parameters": { "attachment": { "description": "附件文件路径，可多次指定 (可选)", "property": "attachment_local", "required": false, "type": "array" }, "content": { "description": "回复正文", "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": false, "type": "string" }, "from": { "description": "发件人邮箱 (必填)", "interface_description": "发信Email地址", "property": "from", "required": true, "type": "string" }, "id": { "description": "要回复的邮件 ID (必填)", "interface_description": "回复的原始邮件id", "property": "messageId", "required": true, "type": "string" }, "inline-attachment": { "description": "内联附件文件路径（如图片），可多次指定，cid 自动生成 (可选)", "property": "inlineAttachment_local", "required": false, "type": "array" }, "subject": { "description": "回复邮件标题", "interface_description": "邮件主题", "property": "subject", "required": false, "type": "string" }, "to": { "description": "收件人列表", "interface_description": "收件人Email地址列表", "property": "to", "required": false, "type": "string" } }, "path": "mail.create_reply_draft", "primary_cli_path": "mail message reply", "product_id": "mail", "reviewed": false, "risk": "medium", "source": "runtime:mail", "title": "创建回复草稿", "use_when": [ "创建回复草稿" ] }, "mail.create_replyall_draft": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.create_replyall_draft", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建回复全部草稿", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建转发草稿”请改用 dws mail message forward", "要“批量删除邮件”请改用 dws mail message batch-delete", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.create_replyall_draft", "cli_name": "reply-all", "cli_path": "mail message reply-all", "confirmation": "not_required", "description": "创建回复全部草稿", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail message reply-all --from user@company.com --id \u003cmessageId\u003e", "dws mail message reply-all --from user@company.com --id \u003cmessageId\u003e --subject \"Re: 周报\" --content \"感谢大家的参与！\"" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_replyall_draft" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_replyall_draft", "parameter_count": 7, "parameters": { "attachment": { "description": "附件文件路径，可多次指定 (可选)", "property": "attachment_local", "required": false, "type": "array" }, "content": { "description": "回复正文", "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": false, "type": "string" }, "from": { "description": "发件人邮箱 (必填)", "interface_description": "发信Email地址", "property": "from", "required": true, "type": "string" }, "id": { "description": "要回复的邮件 ID (必填)", "interface_description": "回复的原始邮件id", "property": "messageId", "required": true, "type": "string" }, "inline-attachment": { "description": "内联附件文件路径（如图片），可多次指定，cid 自动生成 (可选)", "property": "inlineAttachment_local", "required": false, "type": "array" }, "subject": { "description": "回复邮件标题", "interface_description": "邮件主题", "property": "subject", "required": false, "type": "string" }, "to": { "description": "收件人列表", "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": false, "type": "string" } }, "path": "mail.create_replyall_draft", "primary_cli_path": "mail message reply-all", "product_id": "mail", "reviewed": false, "risk": "medium", "source": "runtime:mail", "title": "create_replyall_draft", "use_when": [ "创建回复全部草稿" ] }, "mail.create_user_mail_contact": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_mail_contact", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建用户邮箱联系人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“修改用户邮箱联系人信息”请改用 dws mail contact update", "要“列出用户邮箱联系人”请改用 dws mail contact list", "要“批量删除用户邮箱联系人”请改用 dws mail contact batch-delete" ], "canonical_path": "mail.create_user_mail_contact", "cli_name": "create", "cli_path": "mail contact create", "confirmation": "not_required", "description": "创建用户邮箱联系人", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail contact create --email user@company.com --contact-email colleague@company.com --display-name \"张三\"", "dws mail contact create --email user@company.com --contact-email colleague@company.com --first-name \"三\" --last-name \"张\"" ], "group": "contact", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_user_mail_contact" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_user_mail_contact", "parameter_count": 6, "parameters": { "contact-email": { "description": "联系人邮箱地址 (必填)", "interface_description": "contactEmail", "property": "contactEmail", "required": true, "type": "string" }, "display-name": { "description": "联系人显示名称 (可选)", "interface_description": "displayName", "property": "displayName", "required": false, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "first-name": { "description": "联系人名 (可选)", "interface_description": "firstName", "property": "firstName", "required": false, "type": "string" }, "last-name": { "description": "联系人姓 (可选)", "interface_description": "lastName", "property": "lastName", "required": false, "type": "string" }, "middle-name": { "description": "联系人中间名 (可选)", "interface_description": "middleName", "property": "middleName", "required": false, "type": "string" } }, "path": "mail.create_user_mail_contact", "primary_cli_path": "mail contact create", "product_id": "mail", "reviewed": false, "risk": "medium", "source": "runtime:mail", "title": "create_user_mail_contact", "use_when": [ "创建用户邮箱联系人" ] }, "mail.create_user_message_template": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_message_template", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建个人邮件模板", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出用户邮件模板”请改用 dws mail template list", "要“删除用户邮件模板”请改用 dws mail template delete", "要“获取用户邮件模板详情”请改用 dws mail template get" ], "canonical_path": "mail.create_user_message_template", "cli_name": "create", "cli_path": "mail template create", "confirmation": "not_required", "description": "创建个人邮件模板", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail template create --email user@company.com --name \"周报模板\" --subject \"周报\" --content \"本周工作总结...\"", "dws mail template create --email user@company.com --from user@company.com --name \"通知模板\" --subject \"通知\" --content \"...\" --to a@x.com,b@x.com --cc c@x.com" ], "group": "template", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_user_message_template" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_user_message_template", "parameter_count": 8, "parameters": { "cc": { "description": "模板抄送人列表，逗号分隔 (可选)", "interface_description": "抄送人Email地址列表", "interface_type": "array", "property": "ccRecipients", "required": false, "type": "string" }, "content": { "description": "模板邮件正文 (必填)", "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": true, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "from": { "description": "模板发件人邮箱 (可选)", "interface_description": "发信Email地址", "property": "from", "required": false, "type": "string" }, "is-draft": { "description": "是否为草稿模板 (可选，默认 false；仅草稿模板后续可 template update)", "interface_description": "true:创建模板草稿, false: 创建正式模板, 默认为true", "property": "isDraft", "required": false, "type": "boolean" }, "name": { "description": "模板名称 (必填)", "interface_description": "名称", "property": "name", "required": true, "type": "string" }, "subject": { "description": "模板邮件标题 (必填)", "interface_description": "邮件主题", "property": "subject", "required": true, "type": "string" }, "to": { "description": "模板收件人列表，逗号分隔 (可选)", "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": false, "type": "string" } }, "path": "mail.create_user_message_template", "primary_cli_path": "mail template create", "product_id": "mail", "reviewed": false, "risk": "medium", "source": "runtime:mail", "title": "create_user_message_template", "use_when": [ "创建个人邮件模板" ] }, "mail.delete_mail_folder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.delete_mail_folder", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除邮件文件夹", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“列举邮件文件夹”请改用 dws mail folder list", "要“创建邮件文件夹”请改用 dws mail folder create", "要“更新邮件文件夹”请改用 dws mail folder update" ], "canonical_path": "mail.delete_mail_folder", "cli_name": "delete", "cli_path": "mail folder delete", "confirmation": "user_required", "description": "该工具支持删除指定邮箱下的邮件文件夹。需要传入要删除的文件夹 ID，文件夹 ID 可通过列出邮件文件夹获得。不要把文件夹名称当作 ID。", "display": "邮箱 / 邮件收发", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws mail folder delete --email user@company.com --id \u003cfolderId\u003e", "dws mail folder delete --email user@company.com --id \u003cfolderId\u003e --format json" ], "group": "folder", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "delete_mail_folder" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_mail_folder", "parameter_count": 2, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "interface_description": "邮件所属的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "要删除的邮件文件夹 ID (必填)", "interface_description": "要删除的邮件文件夹 ID，不是文件夹名称", "property": "id", "required": true, "type": "string" } }, "path": "mail.delete_mail_folder", "primary_cli_path": "mail folder delete", "product_id": "mail", "risk": "high", "source": "runtime:mail", "title": "删除邮件文件夹", "use_when": [ "1d. 更新或删除邮件文件夹 — 先通过 folder list 获取目标文件夹 id，再传给 --id" ] }, "mail.delete_user_message_template": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.delete_user_message_template", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除用户邮件模板", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出用户邮件模板”请改用 dws mail template list", "要“创建个人邮件模板”请改用 dws mail template create", "要“获取用户邮件模板详情”请改用 dws mail template get" ], "canonical_path": "mail.delete_user_message_template", "cli_name": "delete", "cli_path": "mail template delete", "confirmation": "user_required", "description": "删除用户邮件模板", "display": "邮箱 / 邮件收发", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws mail template delete --email user@company.com --id \u003ctemplateId\u003e" ], "group": "template", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "delete_user_message_template" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_user_message_template", "parameter_count": 2, "parameters": { "email": { "description": "用户邮箱地址 (必填)", "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "模板唯一标识 (必填)", "interface_description": "模板id", "property": "id", "required": true, "type": "string" } }, "path": "mail.delete_user_message_template", "primary_cli_path": "mail template delete", "product_id": "mail", "reviewed": false, "risk": "high", "source": "runtime:mail", "title": "delete_user_message_template", "use_when": [ "删除用户邮件模板" ] }, "mail.get_email_by_message_id": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.get_email_by_message_id", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查看邮件完整内容", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建转发草稿”请改用 dws mail message forward", "要“批量删除邮件”请改用 dws mail message batch-delete", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.get_email_by_message_id", "cli_name": "get", "cli_path": "mail message get", "confirmation": "not_required", "description": "根据 messageId 获取邮件详情", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail message get --email user@company.com --id \u003cmessageId\u003e", "dws mail message get --email user@company.com --id \u003cmessageId\u003e --format json" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "get_email_by_message_id" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_email_by_message_id", "parameter_count": 2, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "interface_description": "邮件所属的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "邮件 ID (必填)", "interface_description": "邮件ID", "property": "messageId", "required": true, "type": "string" } }, "path": "mail.get_email_by_message_id", "primary_cli_path": "mail message get", "product_id": "mail", "risk": "low", "source": "runtime:mail", "title": "根据 messageId 获取邮件详情", "use_when": [ "3. 查看邮件详情" ] }, "mail.get_thread": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.get_thread", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取会话详情", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取会话详情”" ], "canonical_path": "mail.get_thread", "cli_name": "get", "cli_path": "mail thread get", "confirmation": "not_required", "description": "通过会话 ID 获取指定邮箱中的会话信息，默认仅返回会话基本信息，可通过 $select 参数指定需要额外返回的字段（如 $select=messages 返回会话内的邮件列表）", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail thread get --email user@company.com --id \u003cconversationId\u003e", "dws mail thread get --email user@company.com --id \u003cconversationId\u003e --format json" ], "group": "thread", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "get_thread" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_thread", "parameter_count": 2, "parameters": { "email": { "description": "会话所属邮箱地址 (必填)", "interface_description": "会话所属的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "会话唯一标识 conversationId (必填)", "interface_description": "会话唯一标识", "property": "conversationId", "required": true, "type": "string" } }, "path": "mail.get_thread", "primary_cli_path": "mail thread get", "product_id": "mail", "risk": "low", "source": "runtime:mail", "title": "获取会话信息", "use_when": [ "步骤 5.2：用 conversationId 获取会话详情", "步骤 5.3（可选）：同时返回会话内所有邮件列表" ] }, "mail.get_user_message_template": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.get_user_message_template", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取用户邮件模板详情", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出用户邮件模板”请改用 dws mail template list", "要“创建个人邮件模板”请改用 dws mail template create", "要“删除用户邮件模板”请改用 dws mail template delete" ], "canonical_path": "mail.get_user_message_template", "cli_name": "get", "cli_path": "mail template get", "confirmation": "not_required", "description": "获取用户邮件模板详情", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail template get --email user@company.com --id \u003ctemplateId\u003e" ], "group": "template", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "get_user_message_template" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_user_message_template", "parameter_count": 2, "parameters": { "email": { "description": "用户邮箱地址 (必填)", "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "模板唯一标识 (必填)", "interface_description": "模板id", "property": "id", "required": true, "type": "string" } }, "path": "mail.get_user_message_template", "primary_cli_path": "mail template get", "product_id": "mail", "reviewed": false, "risk": "low", "source": "runtime:mail", "title": "get_user_message_template", "use_when": [ "获取用户邮件模板详情" ] }, "mail.list_folders": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.list_folders", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "列举邮件文件夹", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建邮件文件夹”请改用 dws mail folder create", "要“删除邮件文件夹”请改用 dws mail folder delete", "要“更新邮件文件夹”请改用 dws mail folder update" ], "canonical_path": "mail.list_folders", "cli_name": "list", "cli_path": "mail folder list", "confirmation": "not_required", "description": "该工具支持列出指定邮箱的顶层文件夹或指定父文件夹下的所有子文件夹。\r\n注意：该工具只会返回文件夹的 ID 和元信息（folderId为空则返回顶层文件夹，非空则返回指定父文件夹的子文件夹）", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail folder list --email user@company.com", "dws mail folder list --email user@company.com --folder \u003cfolderId\u003e" ], "group": "folder", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_folders" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_folders", "parameter_count": 2, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "interface_description": "邮件所属的邮箱地址", "property": "email", "required": true, "type": "string" }, "folder": { "description": "父文件夹唯一标识，不传则返回顶层文件夹 (可选)", "interface_description": "文件夹唯一标识", "property": "folderId", "required": false, "type": "string" } }, "path": "mail.list_folders", "primary_cli_path": "mail folder list", "product_id": "mail", "risk": "low", "source": "runtime:mail", "title": "列出邮件文件夹", "use_when": [ "1c. 创建子文件夹 — 先通过 folder list 获取父文件夹 id，再传给 --folder", "1d. 更新或删除邮件文件夹 — 先通过 folder list 获取目标文件夹 id，再传给 --id", "1h. 列出文件夹中的邮件会话 — 先通过 folder list 获取文件夹 id，再传给 --folder", "列出邮件会话/查看会话列表/查看某个文件夹里的邮件会话", "删除邮件文件夹/删除邮箱文件夹/删除邮件目录", "在某个邮件文件夹下创建子文件夹", "重命名邮件文件夹/修改邮箱文件夹名称/更新邮件目录名称" ] }, "mail.list_mail_attachments": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.list_mail_attachments", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "列举邮件附件", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“下载邮件附件”请改用 dws mail attachment download" ], "canonical_path": "mail.list_mail_attachments", "cli_name": "list", "cli_path": "mail attachment list", "confirmation": "not_required", "description": "列举邮件附件", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail attachment list --email user@company.com --id \u003cmessageId\u003e" ], "group": "attachment", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_mail_attachments" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_mail_attachments", "parameter_count": 2, "parameters": { "email": { "description": "用户邮箱地址 (必填)", "interface_description": "用户邮件地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "邮件唯一标识 messageId (必填)", "interface_description": "邮件唯一标识", "property": "messageId", "required": true, "type": "string" } }, "path": "mail.list_mail_attachments", "primary_cli_path": "mail attachment list", "product_id": "mail", "reviewed": false, "risk": "low", "source": "runtime:mail", "title": "列举邮件附件", "use_when": [ "先列出附件获取 id 和 name", "（对搜索结果中的每封邮件都要执行一次）" ] }, "mail.list_tags": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.list_tags", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "列举邮件标签", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列举邮件标签”" ], "canonical_path": "mail.list_tags", "cli_name": "list", "cli_path": "mail tag list", "confirmation": "not_required", "description": "该工具支持列出指定邮箱下的所有邮件标签。只会返回标签 的 ID 和元信息（名称、父标签、邮件数量、未读数量等。", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail tag list --email user@company.com", "dws mail tag list --email user@company.com --format json" ], "group": "tag", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_tags" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_tags", "parameter_count": 1, "parameters": { "email": { "description": "用户的邮箱地址 (必填)", "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" } }, "path": "mail.list_tags", "primary_cli_path": "mail tag list", "product_id": "mail", "risk": "low", "source": "runtime:mail", "title": "列出邮件标签", "use_when": [ "1f. 创建子标签 — 先通过 tag list 获取父标签 id，再传给 --parent-id", "1g. 更新或删除邮件标签 — 先通过 tag list 获取目标标签 id，再传给 --id", "删除邮件标签/删除邮箱标签/删除 label", "在某个邮件标签下创建子标签", "查看邮件标签/列出邮箱标签/查看邮箱 label", "重命名邮件标签/修改邮箱标签名称/更新 label 名称" ] }, "mail.list_user_mail_contacts": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_mail_contacts", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "列出用户邮箱联系人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“修改用户邮箱联系人信息”请改用 dws mail contact update", "要“创建用户邮箱联系人”请改用 dws mail contact create", "要“批量删除用户邮箱联系人”请改用 dws mail contact batch-delete" ], "canonical_path": "mail.list_user_mail_contacts", "cli_name": "list", "cli_path": "mail contact list", "confirmation": "not_required", "description": "列出用户邮箱联系人", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail contact list --email user@company.com --limit 20", "dws mail contact list --email user@company.com --limit 20 --cursor \u003cnextCursor\u003e" ], "group": "contact", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_user_mail_contacts" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_user_mail_contacts", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标，取自响应中的 nextCursor 字段 (可选)", "interface_description": "cursor", "property": "cursor", "required": false, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "interface_description": "email", "property": "email", "required": true, "type": "string" }, "limit": { "description": "每页返回数量 (必填)", "interface_description": "size", "interface_type": "number", "property": "size", "required": true, "type": "string" } }, "path": "mail.list_user_mail_contacts", "primary_cli_path": "mail contact list", "product_id": "mail", "reviewed": false, "risk": "low", "source": "runtime:mail", "title": "list_user_mail_contacts", "use_when": [ "列出用户邮箱联系人" ] }, "mail.list_user_mailboxes": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.list_user_mailboxes", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "查询可用邮箱地址", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询可用邮箱地址”" ], "canonical_path": "mail.list_user_mailboxes", "cli_name": "list", "cli_path": "mail mailbox list", "confirmation": "not_required", "description": "查询当前钉钉用户可以使用的 Email 地址列表。", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail mailbox list", "dws mail mailbox list --format json" ], "group": "mailbox", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_user_mailboxes" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_user_mailboxes", "parameter_count": 0, "parameters": {}, "path": "mail.list_user_mailboxes", "primary_cli_path": "mail mailbox list", "product_id": "mail", "risk": "low", "source": "runtime:mail", "title": "列出可用邮箱地址", "use_when": [ "1. 查看可用邮箱 — 提取邮箱地址", "发带附件的邮件/发邮件附件", "发邮件/写邮件", "我的邮箱/邮箱地址", "获取/查找/得到 某人的邮箱地址" ] }, "mail.list_user_message_templates": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_message_templates", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "列出用户邮件模板", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建个人邮件模板”请改用 dws mail template create", "要“删除用户邮件模板”请改用 dws mail template delete", "要“获取用户邮件模板详情”请改用 dws mail template get" ], "canonical_path": "mail.list_user_message_templates", "cli_name": "list", "cli_path": "mail template list", "confirmation": "not_required", "description": "列出用户邮件模板", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail template list --email user@company.com --limit 20", "dws mail template list --email user@company.com --limit 20 --cursor \u003cnextCursor\u003e" ], "group": "template", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_user_message_templates" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_user_message_templates", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标，取自响应中的 nextCursor 字段 (可选)", "interface_description": "光标, 其值取自响应中的nextCursor字段，首次列出设为\"\"", "property": "cursor", "required": false, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "limit": { "description": "每页返回数量 (必填)", "interface_description": "模板数", "interface_type": "number", "property": "size", "required": true, "type": "string" } }, "path": "mail.list_user_message_templates", "primary_cli_path": "mail template list", "product_id": "mail", "reviewed": false, "risk": "low", "source": "runtime:mail", "title": "list_user_message_templates", "use_when": [ "列出用户邮件模板" ] }, "mail.search_emails": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.search_emails", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "搜索邮件 (KQL 语法)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "mail message list" ], "availability": "available", "avoid_when": [ "要“创建转发草稿”请改用 dws mail message forward", "要“批量删除邮件”请改用 dws mail message batch-delete", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.search_emails", "cli_name": "search", "cli_path": "mail message search", "confirmation": "not_required", "description": "使用类似 KQL 的查询表达式搜索邮件。\r\n该工具支持通过灵活的查询表达式、分页、排序和字段选择来搜索邮件。\r\n\r\n注意：该工具只会返回邮件的ID和元信息，不会返回完整的邮件正文内容", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail message search --email \u003cemail\u003e --query \u003cquery\u003e" ], "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "search_emails" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_emails", "parameter_count": 4, "parameters": { "cursor": { "description": "邮件的起始偏移标识, 其值取自响应中的nextCursor字段。\"\"表示从头开始", "interface_description": "用于检索后续结果的分页游标。第一页时为空。", "property": "cursor", "required": false, "type": "string" }, "email": { "description": "搜索目标邮箱地址 (必填)", "interface_description": "搜索目标Email地址", "property": "email", "required": true, "type": "string" }, "limit": { "default": "20", "description": "每页返回数量(最大限制 100, 默认 20)", "interface_description": "每次请求返回的最大结果数量（1-100）。", "property": "size", "required": false, "type": "string" }, "query": { "description": "KQL 查询表达式 (必填), 其中 date 格式必须遵循 ISO8601 规范", "interface_description": "查询表达式用于筛选邮件，其语法类似于 KQL。\n\n对于字符串类型的值，你可以选择以下两种方式之一：\n使用双引号将字符串括起来（如果字符串本身包含双引号，则需使用两个连续的双引号进行转义）；\n或者不使用双引号（此时字符串中不能包含空格）。\n\n如果字符串本身已经用双引号括起，则必须再在外层加一层双引号，并对内部原有的双引号进行转义（即每个内部双引号替换为两个双引号）。\n\n支持的字段包括：\n- date（日期）\n- size（大小）\n- tag（标签）\n- folderId（文件夹 ID）：常用文件夹 ID 如下：\n* 1：表示“已发送”\n* 2：表示“收件箱”\n* 3：表示“垃圾邮件”\n* 5：表示“草稿”\n* 6：表示“已删除”\n- isRead（是否已读）\n- hasAttachments（是否有附件）\n- subject（主题）\n- attachname（附件名称）\n- body（正文）\n- from（发件人）\n- to（收件人）\n\n示例1：\n查找 2025 年 1 月 1 日之后收到、且不在垃圾邮件或已删除文件夹中的邮件：\ndate\u003e2025-01-01T00:00:00Z AND (NOT folderId:3) AND (NOT folderId:6)\n\n示例2：\n查找发件人为 “alice” 的邮件，或者收件人为 “alice\u003ca@b.com\u003e” 且位于“已发送”文件夹中的邮件：\n(from:\"alice\") OR (to:\"alice\u003ca@b.com\u003e\" AND folderId:1)\n\n示例3：\n查找主题中包含 “test” 关键词的邮件，或者包含附件名含 “file” 关键词且发件人为 alice 的邮件：\n(subject:\"test\") OR (attachname:\"file\" AND from:alice\u003ca@b.com\u003e)", "property": "query", "required": true, "type": "string" } }, "path": "mail.search_emails", "primary_cli_path": "mail message search", "product_id": "mail", "risk": "low", "source": "runtime:mail", "title": "搜索邮件", "use_when": [ "2. 搜索邮件 — 提取 messageId", "下载附件/保存附件/把附件存到本地/把所有附件下载到...", "发送草稿/把草稿发出去/发这封草稿", "取返回中的 nextCursor，传入下一次请求（nextCursor=\"$\" 时停止）", "找邮件/搜邮件/查邮件", "把XX邮件的所有附件都下载", "查看会话/获取会话/看这封邮件的会话", "查看附件/邮件附件/有什么附件", "步骤 5.1：先通过 message search 或 message get 获取邮件中的 conversationId", "看邮件/打开邮件/邮件内容", "示例：下载4月所有发票邮件的附件", "第一页" ] }, "mail.search_mail_users": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.search_mail_users", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "搜索账号", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“搜索账号”" ], "canonical_path": "mail.search_mail_users", "cli_name": "search", "cli_path": "mail user search", "confirmation": "not_required", "description": "搜索账号", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail user search --email \u003c当前邮箱\u003e --keyword \"姓名\" --format json", "dws mail user search --keyword \"张三\"" ], "group": "user", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "search_mail_users" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_mail_users", "parameter_count": 5, "parameters": { "cursor": { "description": "分页游标，取自响应中的 nextCursor 字段", "interface_description": "cursor", "property": "cursor", "required": false, "type": "string" }, "email": { "description": "搜索目标邮箱地址 (可选)", "interface_description": "email", "property": "email", "required": false, "type": "string" }, "employee-no": { "description": "按工号搜索用户；提供此参数时 keyword 不再必填", "interface_description": "按工号精确查询", "property": "employeeNo", "required": true, "type": "string" }, "keyword": { "description": "搜索关键词（未提供 --employee-no 时为必填）", "interface_description": "搜索关键词（名字、昵称、拼音、工号、办公地点等）", "property": "keyword", "required": true, "type": "string" }, "limit": { "description": "每页返回数量", "interface_description": "size", "interface_type": "number", "property": "size", "required": false, "type": "string" } }, "path": "mail.search_mail_users", "primary_cli_path": "mail user search", "product_id": "mail", "reviewed": false, "risk": "low", "source": "runtime:mail", "title": "搜索账号", "use_when": [ "搜索/查找/联系 邮箱用户/联系人/某人的邮箱地址", "翻页继续搜索联系人/通讯录", "路径 2：mail user search（仅企业邮箱可用，个人邮箱会报权限错误可忽略）" ] }, "mail.send_draft": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.send_draft", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "发送草稿箱中的邮件", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建邮件草稿”请改用 dws mail draft create", "要“更新邮件草稿”请改用 dws mail draft update" ], "canonical_path": "mail.send_draft", "cli_name": "send", "cli_path": "mail draft send", "confirmation": "not_required", "description": "发送草稿箱中的邮件", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail draft send --from user@company.com --id \u003cmessageId\u003e" ], "group": "draft", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "send_draft" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "send_draft", "parameter_count": 2, "parameters": { "from": { "description": "发件人邮箱 (必填)，别名: --sender", "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "草稿邮件 ID (必填)", "interface_description": "邮件的唯一标识", "property": "messageId", "required": true, "type": "string" } }, "path": "mail.send_draft", "primary_cli_path": "mail draft send", "product_id": "mail", "reviewed": false, "risk": "medium", "source": "runtime:mail", "title": "发送邮件草稿", "use_when": [ "发送草稿箱中的邮件" ] }, "mail.send_email": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.send_email", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "发送邮件", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建转发草稿”请改用 dws mail message forward", "要“批量删除邮件”请改用 dws mail message batch-delete", "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move" ], "canonical_path": "mail.send_email", "cli_name": "send", "cli_path": "mail message send", "confirmation": "not_required", "description": "使用指定的Email地址作为发件人发送一封邮件。", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail message send --from user@company.com --to colleague@company.com --subject \"周报\" --content \"本周完成任务A和任务B\"", "dws mail message send --from user@company.com --to colleague@company.com --subject \"周报\" --content \"见附件\" --attachment ./report.pdf" ], "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "send_email" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "send_email", "parameter_count": 7, "parameters": { "attachment": { "description": "附件文件路径，可多次指定 (可选)", "property": "attachment_local", "required": false, "type": "array" }, "cc": { "description": "抄送人列表", "interface_description": "抄送人Email地址列表", "interface_type": "array", "property": "ccRecipients", "required": false, "type": "string" }, "content": { "description": "邮件正文 (必填)", "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": true, "type": "string" }, "from": { "description": "发件人邮箱 (必填)", "interface_description": "发信Email地址", "property": "from", "required": true, "type": "string" }, "inline-attachment": { "description": "内联附件文件路径（如图片），可多次指定，cid 自动生成 (可选)", "property": "inlineAttachment_local", "required": false, "type": "array" }, "subject": { "description": "邮件标题 (必填)", "interface_description": "邮件主题", "property": "subject", "required": true, "type": "string" }, "to": { "description": "收件人列表 (必填)", "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": true, "type": "string" } }, "path": "mail.send_email", "primary_cli_path": "mail message send", "product_id": "mail", "risk": "medium", "source": "runtime:mail", "title": "发送邮件", "use_when": [ "4. 发送邮件（纯文本）", "4b. 发送带附件的邮件（自动编排：创建草稿→上传附件→发送草稿）", "4c. 发送带内联图片的邮件（正文自动转 HTML，\u003cimg\u003e 标签自动注入）" ] }, "mail.update_draft": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.update_draft", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新邮件草稿", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建邮件草稿”请改用 dws mail draft create", "要“发送草稿箱中的邮件”请改用 dws mail draft send" ], "canonical_path": "mail.update_draft", "cli_name": "update", "cli_path": "mail draft update", "confirmation": "not_required", "description": "更新邮件草稿", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail draft update --from user@company.com --id \u003cmessageId\u003e --subject \"新标题\" --content \"新正文\"", "dws mail draft update --from user@company.com --id \u003cmessageId\u003e --content \"见附件\" --attachment ./report.pdf" ], "group": "draft", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "update_draft" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_draft", "parameter_count": 8, "parameters": { "attachment": { "description": "附件文件路径，可多次指定 (可选)", "property": "attachment_local", "required": false, "type": "array" }, "cc": { "description": "抄送人列表", "interface_description": "抄送人Email地址列表", "interface_type": "array", "property": "ccRecipients", "required": false, "type": "string" }, "content": { "description": "邮件正文", "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": false, "type": "string" }, "from": { "description": "发件人邮箱 (必填)", "interface_description": "发信Email地址", "property": "from", "required": true, "type": "string" }, "id": { "description": "草稿邮件 ID (必填)", "interface_description": "待更新的邮件id", "property": "id", "required": true, "type": "string" }, "inline-attachment": { "description": "内联附件文件路径（如图片），可多次指定，cid 自动生成 (可选)", "property": "inlineAttachment_local", "required": false, "type": "array" }, "subject": { "description": "邮件标题", "interface_description": "邮件主题", "property": "subject", "required": false, "type": "string" }, "to": { "description": "收件人列表", "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": false, "type": "string" } }, "path": "mail.update_draft", "primary_cli_path": "mail draft update", "product_id": "mail", "reviewed": false, "risk": "medium", "source": "runtime:mail", "title": "更新邮件草稿", "use_when": [ "更新邮件草稿" ] }, "mail.update_mail_folder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.update_mail_folder", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新邮件文件夹", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“列举邮件文件夹”请改用 dws mail folder list", "要“创建邮件文件夹”请改用 dws mail folder create", "要“删除邮件文件夹”请改用 dws mail folder delete" ], "canonical_path": "mail.update_mail_folder", "cli_name": "update", "cli_path": "mail folder update", "confirmation": "not_required", "description": "该工具支持修改指定邮箱下邮件文件夹的名称。需要传入要更新的文件夹 ID 和新名称。文件夹 ID 可通过列出邮件文件夹获得，不要把文件夹名称当作 ID。", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail folder update --email user@company.com --id \u003cfolderId\u003e --name \"新文件夹名\"", "dws mail folder update --email user@company.com --id \u003cfolderId\u003e --name \"新文件夹名\" --format json" ], "group": "folder", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "update_mail_folder" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_mail_folder", "parameter_count": 3, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "interface_description": "邮件所属的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "要更新的邮件文件夹 ID (必填)", "interface_description": "要更新的邮件文件夹 ID，不是文件夹名称", "property": "id", "required": true, "type": "string" }, "name": { "description": "更新后的邮件文件夹名称 (必填)", "interface_description": "更新后的邮件文件夹名称", "property": "name", "required": true, "type": "string" } }, "path": "mail.update_mail_folder", "primary_cli_path": "mail folder update", "product_id": "mail", "risk": "medium", "source": "runtime:mail", "title": "更新邮件文件夹", "use_when": [ "1d. 更新或删除邮件文件夹 — 先通过 folder list 获取目标文件夹 id，再传给 --id" ] }, "mail.update_user_mail_contact": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_mail_contact", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "修改用户邮箱联系人信息", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出用户邮箱联系人”请改用 dws mail contact list", "要“创建用户邮箱联系人”请改用 dws mail contact create", "要“批量删除用户邮箱联系人”请改用 dws mail contact batch-delete" ], "canonical_path": "mail.update_user_mail_contact", "cli_name": "update", "cli_path": "mail contact update", "confirmation": "not_required", "description": "修改用户邮箱联系人信息", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail contact update --email user@company.com --contact-id \u003ccontactId\u003e --display-name \"李四\"", "dws mail contact update --email user@company.com --contact-id \u003ccontactId\u003e --contact-email new@company.com --first-name \"四\" --last-name \"李\"" ], "group": "contact", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "update_user_mail_contact" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_user_mail_contact", "parameter_count": 7, "parameters": { "contact-email": { "description": "联系人邮箱地址 (可选)", "interface_description": "contactEmail", "property": "contactEmail", "required": false, "type": "string" }, "contact-id": { "description": "联系人唯一标识 (必填)", "interface_description": "要修改的联系人 id", "property": "contactId", "required": true, "type": "string" }, "display-name": { "description": "联系人显示名称 (可选)", "interface_description": "displayName", "property": "displayName", "required": false, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "first-name": { "description": "联系人名 (可选)", "interface_description": "firstName", "property": "firstName", "required": false, "type": "string" }, "last-name": { "description": "联系人姓 (可选)", "interface_description": "lastName", "property": "lastName", "required": false, "type": "string" }, "middle-name": { "description": "联系人中间名 (可选)", "interface_description": "middleName", "property": "middleName", "required": false, "type": "string" } }, "path": "mail.update_user_mail_contact", "primary_cli_path": "mail contact update", "product_id": "mail", "reviewed": false, "risk": "medium", "source": "runtime:mail", "title": "update_user_mail_contact", "use_when": [ "修改用户邮箱联系人信息" ] }, "mail.update_user_message_template": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_message_template", "skills/mono/references/products/mail.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "更新用户邮件模板", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建个人邮件模板”请改用 dws mail template create", "要“删除用户邮件模板”请改用 dws mail template delete", "要“获取用户邮件模板详情”请改用 dws mail template get" ], "canonical_path": "mail.update_user_message_template", "cli_name": "update", "cli_path": "mail template update", "confirmation": "not_required", "description": "更新用户邮件模板", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail template update --email user@company.com --id \u003ctemplateId\u003e --subject \"新标题\" --content \"新正文\"", "dws mail template update --email user@company.com --id \u003ctemplateId\u003e --name \"新模板名\"" ], "group": "template", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "update_user_message_template" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_user_message_template", "parameter_count": 8, "parameters": { "cc": { "description": "模板抄送人列表，逗号分隔 (可选)", "interface_description": "抄送人Email地址列表", "interface_type": "array", "property": "ccRecipients", "required": false, "type": "string" }, "content": { "description": "模板邮件正文 (可选)", "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": false, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "from": { "description": "模板发件人邮箱 (可选)", "interface_description": "发信Email地址", "property": "from", "required": false, "type": "string" }, "id": { "description": "模板唯一标识 (必填)", "interface_description": "模板id", "property": "id", "required": true, "type": "string" }, "name": { "description": "模板名称 (可选)", "interface_description": "名称", "property": "name", "required": false, "type": "string" }, "subject": { "description": "模板邮件标题 (可选)", "interface_description": "邮件主题", "property": "subject", "required": false, "type": "string" }, "to": { "description": "模板收件人列表，逗号分隔 (可选)", "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": false, "type": "string" } }, "path": "mail.update_user_message_template", "primary_cli_path": "mail template update", "product_id": "mail", "reviewed": false, "risk": "medium", "source": "runtime:mail", "title": "update_user_message_template", "use_when": [ "更新用户邮件模板" ] }, "minutes.add_member_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.minutes.add_member_permission", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量给多个听记增加成员，并且设置成员的权限。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量移除多个听记的成员的权限”请改用 dws minutes permission remove" ], "canonical_path": "minutes.add_member_permission", "cli_name": "add", "cli_path": "minutes permission add", "confirmation": "not_required", "description": "批量给多个听记增加成员，并且设置成员的权限。权限类型为：0:管理员;1:所有者；2:可编辑;3:可查看/下载;4:仅查看。", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes permission add --ids \u003cuuid1,uuid2\u003e --member-uids 123456,789012 --policy 3", "dws minutes permission add --ids \u003cuuid\u003e --member-uids 123456 --policy 2 --cover" ], "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "add_member_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_member_permission", "parameter_count": 5, "parameters": { "cover": { "description": "是否覆盖已有权限 (可选，默认 false)", "interface_description": "是否覆盖已有权限，默认 false", "interface_type": "string", "property": "coverPermission", "required": false, "type": "boolean" }, "ids": { "description": "听记 taskUuid 列表，逗号分隔 (必填)", "interface_description": "听记uuid列表，uuid为听记唯一标识", "interface_type": "array", "property": "uuids", "required": true, "type": "string" }, "member-uids": { "description": "成员钉钉 UID 列表，逗号分隔 (必填)", "interface_description": "需要添加的成员的钉钉Uid列表，长整型", "interface_type": "array", "property": "memberUids", "required": true, "type": "string" }, "policy": { "description": "权限类型: 0=管理员, 1=所有者, 2=可编辑, 3=可查看/下载, 4=仅查看 (必填)", "enum": [ "0", "1", "2", "3", "4" ], "interface_description": "策略id：MANAGER(0L, \"管理员\"), OWNER(1L, \"所有者\"), EDITOR(2L, \"可编辑\"), READ_DOWNLOAD(3L, \"可查看/下载\"), READ(4L, \"仅查看\");", "interface_type": "number", "property": "policyId", "required": true, "type": "string" }, "sub-resources": { "description": "权限子模块，逗号分隔: OrigContent/Summary/Analysis/Note (可选)", "interface_description": "权限子模块，OrigContent(原始内容) / Summary(纪要) / Analysis(分析) / Note(笔记)", "interface_type": "array", "property": "roleSubResourceIds", "required": false, "type": "string" } }, "path": "minutes.add_member_permission", "primary_cli_path": "minutes permission add", "product_id": "minutes", "reviewed": false, "risk": "medium", "source": "runtime:minutes", "title": "add_member_permission", "use_when": [ "加/添加/共享/分享/让...看/让...访问", "把某人加到这个听记中/共享听记给某人/给某人添加听记权限/把听记分享给同事/让某人也能看这个听记", "添加参会者/加参会者/批量添加参会者/添加成员/加成员/批量添加成员/加参会人/添加参会人", "添加参会者/批量添加参会者/添加成员/批量添加成员/加参会人/加入成员" ] }, "minutes.add_personal_hot_word": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.add_personal_hot_word", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "添加个人热词 (优化识别专有名词 / 人名)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询我的热词列表，返回个人的所有听记配置过的热词列表”请改用 dws minutes hot-word list" ], "canonical_path": "minutes.add_personal_hot_word", "cli_name": "add", "cli_path": "minutes hot-word add", "confirmation": "not_required", "description": "添加听记个人热词\r\n对于听记语音识别中，需要优化识别结果的专有名词、人名、以及其他用户需要添加热词的场景使用\r\n热词长度不超过10个汉字或5个英文单词", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes hot-word add --words \"钉钉\"", "dws minutes hot-word add --words \"OKR,钉钉,Copilot\"" ], "group": "hot-word", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "add_personal_hot_word" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_personal_hot_word", "parameter_count": 1, "parameters": { "words": { "description": "要添加的热词，多个用逗号分隔 (必填)", "interface_description": "hotWordList", "interface_type": "array", "property": "hotWordList", "required": true, "type": "string" } }, "path": "minutes.add_personal_hot_word", "primary_cli_path": "minutes hot-word add", "product_id": "minutes", "risk": "medium", "source": "runtime:minutes", "title": "add_personal_hot_word", "use_when": [ "10. 添加个人热词", "加热词/添加热词/设置热词/把某个词加到热词里/这个词总是识别错" ] }, "minutes.batch_get_minutes_details": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.batch_get_minutes_details", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 / 状态)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“获取听记 AI 摘要 (Markdown 格式)”请改用 dws minutes get summary", "要“获取听记关键字列表”请改用 dws minutes get keywords", "要“获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接”请改用 dws minutes get info" ], "canonical_path": "minutes.batch_get_minutes_details", "cli_name": "batch", "cli_path": "minutes get batch", "confirmation": "not_required", "description": "根据听记taskUuid列表批量查询听记详情。输入参数：taskUuid列表（string[]，必填，每个元素为听记的唯一标识符，最少传入1个）。返回对应听记的详情列表，每条记录包含：听记标题、时长、参与人列表、创建时间、听记唯一标识taskUuid、听记状态。适用于已知特定听记taskUuid需批量获取详情的列表展示场景。", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes get batch --ids uuid1,uuid2,uuid3" ], "group": "get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "batch_get_minutes_details" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "batch_get_minutes_details", "parameter_count": 1, "parameters": { "ids": { "description": "听记 taskUuid 列表，逗号分隔 (必填)", "property": "requestBody.taskUuids", "required": true, "type": "string" } }, "path": "minutes.batch_get_minutes_details", "primary_cli_path": "minutes get batch", "product_id": "minutes", "risk": "low", "source": "runtime:minutes", "title": "batch_get_minutes_details", "use_when": [ "批量查询/查多个听记" ] }, "minutes.cancel_upload_session": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.cancel_upload_session", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "取消文件上传会话，释放服务端资源", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建文件上传会话（获取预签名 URL，供 HTTP PUT 上传”请改用 dws minutes upload create", "要“完成文件上传并创建听记（幂等：同一 sessionId 重复调用”请改用 dws minutes upload complete" ], "canonical_path": "minutes.cancel_upload_session", "cli_name": "cancel", "cli_path": "minutes upload cancel", "confirmation": "not_required", "description": "取消文件上传会话\r\n当需要取消create_upload_session创建的会话时使用该接口，传入要取消的会话ID", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes upload cancel --session-id \u003csessionId\u003e", "dws minutes upload cancel --session-id \u003csessionId\u003e --format json" ], "group": "upload", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "cancel_upload_session" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "cancel_upload_session", "parameter_count": 1, "parameters": { "session-id": { "description": "要取消的会话 sessionId (必填)", "interface_description": "需要取消的会话sessionId", "property": "sessionId", "required": true, "type": "string" } }, "path": "minutes.cancel_upload_session", "primary_cli_path": "minutes upload cancel", "product_id": "minutes", "risk": "medium", "source": "runtime:minutes", "title": "cancel_upload_session", "use_when": [ "12d.（可选）取消上传会话", "取消上传" ] }, "minutes.complete_upload_session": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.complete_upload_session", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "完成文件上传并创建听记（幂等：同一 sessionId 重复调用返回已有任务）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建文件上传会话（获取预签名 URL，供 HTTP PUT 上传”请改用 dws minutes upload create", "要“取消文件上传会话，释放服务端资源”请改用 dws minutes upload cancel" ], "canonical_path": "minutes.complete_upload_session", "cli_name": "complete", "cli_path": "minutes upload complete", "confirmation": "not_required", "description": "文件上传完成后，创建听记。\r\n必须在create_upload_session之后、预签名URL上传`curl -X PUT \"{presignedUrl}\" -T \"/path/to/file.mp4\"`完成后调用。\r\n调用流程参考create_upload_session介绍。\r\n幂等：同一sessionId重复调用直接返回已有的任务，不会重复创建。", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes upload complete --session-id \u003csessionId\u003e", "dws minutes upload complete --session-id \u003csessionId\u003e --format json" ], "group": "upload", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "complete_upload_session" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "complete_upload_session", "parameter_count": 1, "parameters": { "session-id": { "description": "上传会话 ID，来自 create 返回的 sessionId (必填)", "interface_description": "上传文件会话ID，create_upload_session返回的sessionId", "property": "sessionId", "required": true, "type": "string" } }, "path": "minutes.complete_upload_session", "primary_cli_path": "minutes upload complete", "product_id": "minutes", "risk": "medium", "source": "runtime:minutes", "title": "complete_upload_session", "use_when": [ "12c. 通知服务端上传完成，创建听记" ] }, "minutes.create_mind_graph": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.create_mind_graph", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "触发思维导图生成任务 (完成状态走 mind-graph status 轮询)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询思维导图任务状态 (0=进行中 / 1=成功 / 2=失败)”请改用 dws minutes mind-graph status" ], "canonical_path": "minutes.create_mind_graph", "cli_name": "create", "cli_path": "minutes mind-graph create", "confirmation": "not_required", "description": "触发创建听记思维导图任务。触发成功后，你需要知道听记思维导图任务状态，每2s调用一次query_mind_graph_status，如果状态是“进行中”需要保持轮询。", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes mind-graph create --id \u003ctaskUuid\u003e", "dws minutes mind-graph create --id \u003ctaskUuid\u003e --format json" ], "group": "mind-graph", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "create_mind_graph" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_mind_graph", "parameter_count": 1, "parameters": { "id": { "description": "听记 taskUuid (必填)", "interface_description": "听记唯一标识", "property": "taskUuid", "required": true, "type": "string" } }, "path": "minutes.create_mind_graph", "primary_cli_path": "minutes mind-graph create", "product_id": "minutes", "risk": "medium", "source": "runtime:minutes", "title": "create_mind_graph", "use_when": [ "8. 思维导图", "生成思维导图/创建脑图/帮我添加思维导图/基于这个听记做思维导图/把会议内容做成脑图" ] }, "minutes.create_speaker_summary": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.minutes.create_speaker_summary", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "触发创建发言人的段落总结任务，该任务将听记的发言人的所有撰写内容汇总总结，触发后需要继续调用查询接口去查询总结任务的结果", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询发言人的段落总结任务的结果，该任务将听记的发言人的所有撰写内”请改用 dws minutes speaker summary get" ], "canonical_path": "minutes.create_speaker_summary", "cli_name": "create", "cli_path": "minutes speaker summary create", "confirmation": "not_required", "description": "触发创建发言人的段落总结任务，该任务将听记的发言人的所有撰写内容汇总总结，触发后需要继续调用查询接口去查询总结任务的结果", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes speaker summary create --ids \u003cuuid1,uuid2\u003e", "dws minutes speaker summary create --task-uuids \u003cuuid1,uuid2\u003e" ], "group": "speaker.summary", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "create_speaker_summary" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_speaker_summary", "parameter_count": 1, "parameters": { "ids": { "description": "听记 taskUuid 列表，逗号分隔 (必填)", "interface_description": "听记uuid列表", "interface_type": "array", "property": "uuids", "required": true, "type": "string" } }, "path": "minutes.create_speaker_summary", "primary_cli_path": "minutes speaker summary create", "product_id": "minutes", "reviewed": false, "risk": "low", "source": "runtime:minutes", "title": "create_speaker_summary", "use_when": [ "9b. 发言人段落总结（异步：create 触发 → 延迟 5s → 轮询 get，最多 20 次）" ] }, "minutes.create_upload_session": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.create_upload_session", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建文件上传会话（获取预签名 URL，供 HTTP PUT 上传）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“取消文件上传会话，释放服务端资源”请改用 dws minutes upload cancel", "要“完成文件上传并创建听记（幂等：同一 sessionId 重复调用”请改用 dws minutes upload complete" ], "canonical_path": "minutes.create_upload_session", "cli_name": "create", "cli_path": "minutes upload create", "confirmation": "not_required", "description": "创建文件上传会话，获取预签名上传URL\r\n调用方拿到 URL 后，直接用HTTP PUT将文件上传到该URL\r\n必须与complete_upload_session配合使用\r\n1.调用create_upload_session获取预签名上传URL和上传ID\r\n2.HTTP PUT预签名上传URL上传文件(不带HEADER)\r\n3.调用complete_upload_session传入会话ID", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes upload create --file-name \"meeting.mp4\" --file-size 102400", "dws minutes upload create --file-name \"meeting.mp4\" --file-size 102400 --title \"周会录音\"" ], "group": "upload", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "create_upload_session" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_upload_session", "parameter_count": 6, "parameters": { "enable-message-card": { "description": "是否推送闪记卡片消息 (可选)", "property": "minutesOption.enableMessageCard", "required": false, "type": "boolean" }, "file-name": { "description": "文件名（含后缀），如 meeting.mp4 (必填)", "interface_description": "文件名（含后缀），用于校验文件类型。例如：\"meeting.mp4\"", "property": "fileName", "required": true, "type": "string" }, "file-size": { "description": "文件大小（字节）(必填)", "interface_description": "文件大小（单位：Byte），用于容量校验和上传链接过期时间计算", "interface_type": "number", "property": "fileSize", "required": true, "type": "integer" }, "input-language": { "description": "ASR 识别的源语言 (可选)", "property": "minutesOption.inputLanguage", "required": false, "type": "string" }, "template-id": { "description": "纪要生成使用的模板 ID (可选)", "property": "minutesOption.templateId", "required": false, "type": "string" }, "title": { "description": "听记标题，不传时默认使用文件名去掉后缀 (可选)", "interface_description": "听记标题，不传时默认使用 fileName 去掉后缀", "property": "title", "required": false, "type": "string" } }, "path": "minutes.create_upload_session", "primary_cli_path": "minutes upload create", "product_id": "minutes", "risk": "medium", "source": "runtime:minutes", "title": "create_upload_session", "use_when": [ "12a. 创建上传会话，获取预签名 URL 和 sessionId", "把文件转成听记/上传音频文件/上传录音/把这个 mp3 转成听记/帮我把会议录音转写一下/把附件里的音频文件做转写" ] }, "minutes.get_minutes_ai_summary": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.get_minutes_ai_summary", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取听记 AI 摘要 (Markdown 格式)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 /”请改用 dws minutes get batch", "要“获取听记关键字列表”请改用 dws minutes get keywords", "要“获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接”请改用 dws minutes get info" ], "canonical_path": "minutes.get_minutes_ai_summary", "cli_name": "summary", "cli_path": "minutes get summary", "confirmation": "not_required", "description": "根据听记唯一标识获取由AI生成的听记内容摘要。输入参数：目标听记的唯一标识符taskUuid。返回Markdown格式的摘要文本，内容由AI对听记转写原文进行结构化提炼生成，涵盖会议主题、核心结论、关键讨论点等。适用于快速了解听记核心内容、会议记录整理、摘要分享等场景。", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes get summary --id \u003ctaskUuid\u003e", "dws minutes get summary --id \u003ctaskUuid\u003e --format json" ], "group": "get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "get_minutes_ai_summary" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_minutes_ai_summary", "parameter_count": 1, "parameters": { "id": { "description": "听记 taskUuid (必填)", "interface_description": "听记uuid", "property": "taskUuid", "required": true, "type": "string" } }, "path": "minutes.get_minutes_ai_summary", "primary_cli_path": "minutes get summary", "product_id": "minutes", "risk": "low", "source": "runtime:minutes", "title": "get_minutes_ai_summary", "use_when": [ "2. 获取 AI 摘要", "修改纪要/更新纪要/编辑纪要内容/重新整理纪要/纪要格式优化/纪要精简", "把 XX 改成 YY；用户只要整体纪要、未指定特定人物", "摘要/总结/会议纪要/纪要" ] }, "minutes.get_minutes_basic_info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.get_minutes_basic_info", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 /”请改用 dws minutes get batch", "要“获取听记 AI 摘要 (Markdown 格式)”请改用 dws minutes get summary", "要“获取听记关键字列表”请改用 dws minutes get keywords" ], "canonical_path": "minutes.get_minutes_basic_info", "cli_name": "info", "cli_path": "minutes get info", "confirmation": "not_required", "description": "根据听记唯一标识获取该听记的基础元数据信息。输入参数：听记的唯一标识符taskUuid。返回字段包括：创建人、开始时间、截止时间、听记标题、听记访问链接URL。适用于展示听记详情页头部信息、跳转听记原始链接、信息摘要展示等场景。", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes get info --id \u003ctaskUuid\u003e" ], "group": "get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "get_minutes_basic_info" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_minutes_basic_info", "parameter_count": 1, "parameters": { "id": { "description": "听记 taskUuid (必填)", "interface_description": "听记的taskUuid", "property": "taskUuid", "required": true, "type": "string" } }, "path": "minutes.get_minutes_basic_info", "primary_cli_path": "minutes get info", "product_id": "minutes", "risk": "low", "source": "runtime:minutes", "title": "get_minutes_basic_info", "use_when": [ "听记详情/听记信息" ] }, "minutes.get_minutes_keywords": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.get_minutes_keywords", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取听记关键字列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 /”请改用 dws minutes get batch", "要“获取听记 AI 摘要 (Markdown 格式)”请改用 dws minutes get summary", "要“获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接”请改用 dws minutes get info" ], "canonical_path": "minutes.get_minutes_keywords", "cli_name": "keywords", "cli_path": "minutes get keywords", "confirmation": "not_required", "description": "根据听记唯一标识查询该听记的关键字列表。输入参数：目标听记的唯一标识符taskUuid。返回关键字列表，每个元素为一个从听记内容中提取的核心关键词。适用于快速了解听记主题、关键词检索、内容分类打标及听记摘要辅助展示等场景。", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes get keywords --id \u003ctaskUuid\u003e" ], "group": "get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "get_minutes_keywords" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_minutes_keywords", "parameter_count": 1, "parameters": { "id": { "description": "听记 taskUuid (必填)", "interface_description": "听记的taskUuid", "property": "taskUuid", "required": true, "type": "string" } }, "path": "minutes.get_minutes_keywords", "primary_cli_path": "minutes get keywords", "product_id": "minutes", "risk": "low", "source": "runtime:minutes", "title": "get_minutes_keywords", "use_when": [ "关键字/关键词" ] }, "minutes.get_minutes_transcription": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.get_minutes_transcription", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取听记语音转写原文 (含发言人 / 时间戳)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 /”请改用 dws minutes get batch", "要“获取听记 AI 摘要 (Markdown 格式)”请改用 dws minutes get summary", "要“获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接”请改用 dws minutes get info" ], "canonical_path": "minutes.get_minutes_transcription", "cli_name": "transcription", "cli_path": "minutes get transcription", "confirmation": "not_required", "description": "根据听记唯一标识查询该听记的完整语音转写原文。输入参数：听记的唯一标识符 taskUuid。返回转写内容列表，每条记录包含：发言人信息、语音转写文本、对应时间戳。适用于用户回顾会议发言内容、按发言人检索原文、生成会议记录等场景。", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes get transcription --id \u003ctaskUuid\u003e", "dws minutes get transcription --id \u003ctaskUuid\u003e --direction 1" ], "group": "get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "get_minutes_transcription" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_minutes_transcription", "parameter_count": 3, "parameters": { "cursor": { "description": "分页 token (首页留空)", "property": "cursor", "required": false, "type": "string" }, "direction": { "default": "0", "description": "排序方向: 0=正序, 1=倒序 (默认 0)", "interface_description": "听记转写按时间的正反序，0为正序，相对时间逐渐增大，1为反序，默认为0", "property": "direction", "required": false, "type": "string" }, "id": { "description": "听记 taskUuid (必填)", "interface_description": "听记的taskUuid", "property": "taskUuid", "required": true, "type": "string" } }, "path": "minutes.get_minutes_transcription", "primary_cli_path": "minutes get transcription", "product_id": "minutes", "risk": "low", "source": "runtime:minutes", "title": "get_minutes_transcription", "use_when": [ "3. 查看完整转写原文（拉完后默认按时间线返回，AI 必须主动追问\"是否按发言人聚类\"）", "原文/转写/录音文字/逐字稿" ] }, "minutes.get_speaker_summary": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.minutes.get_speaker_summary", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询发言人的段落总结任务的结果，该任务将听记的发言人的所有撰写内容汇总总结返回，配合创建任务使用", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“触发创建发言人的段落总结任务，该任务将听记的发言人的所有撰写内容”请改用 dws minutes speaker summary create" ], "canonical_path": "minutes.get_speaker_summary", "cli_name": "get", "cli_path": "minutes speaker summary get", "confirmation": "not_required", "description": "查询发言人的段落总结任务的结果，该任务将听记的发言人的所有撰写内容汇总总结返回，配合创建任务使用", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes speaker summary get --ids \u003cuuid1,uuid2\u003e", "dws minutes speaker summary get --task-uuids \u003cuuid1,uuid2\u003e" ], "group": "speaker.summary", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "get_speaker_summary" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_speaker_summary", "parameter_count": 1, "parameters": { "ids": { "description": "听记 taskUuid 列表，逗号分隔 (必填)", "interface_description": "听记uuid列表，uuid为听记唯一标识", "interface_type": "array", "property": "uuids", "required": true, "type": "string" } }, "path": "minutes.get_speaker_summary", "primary_cli_path": "minutes speaker summary get", "product_id": "minutes", "reviewed": false, "risk": "low", "source": "runtime:minutes", "title": "get_speaker_summary", "use_when": [ "等待至少 5 秒..." ] }, "minutes.list_by_keyword_and_time_range": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.minutes.list_by_keyword_and_time_range", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "新版：查询我的听记列表，支持输入关键词或者时间范围查询，返回听记列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "aliases": [ "minutes list all", "minutes list shared" ], "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“新版：查询我的听记列表，支持输入关键词或者时间范围查询，返回听记列表。”" ], "canonical_path": "minutes.list_by_keyword_and_time_range", "cli_name": "mine", "cli_path": "minutes list mine", "confirmation": "not_required", "description": "新版：查询我的听记列表，支持输入关键词或者时间范围查询，返回听记列表。代替list_by_keyword_range。", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes list mine" ], "group": "list", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "list_by_keyword_and_time_range" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_by_keyword_and_time_range", "parameter_count": 5, "parameters": { "cursor": { "description": "分页 token (首页留空)", "property": "cursor", "required": false, "type": "string" }, "end": { "description": "结束时间 ISO-8601 (可选)", "format": "date-time", "property": "end", "required": false, "type": "string" }, "limit": { "default": "10", "description": "每页数据条数 (默认 10)", "property": "limit", "required": false, "type": "number" }, "query": { "description": "关键字筛选 (可选)", "property": "query", "required": false, "type": "string" }, "start": { "description": "开始时间 ISO-8601 (可选)", "format": "date-time", "property": "start", "required": false, "type": "string" } }, "path": "minutes.list_by_keyword_and_time_range", "primary_cli_path": "minutes list mine", "product_id": "minutes", "reviewed": false, "risk": "low", "source": "hardcoded:minutes", "title": "list_by_keyword_and_time_range", "use_when": [ "1. 查看我的听记列表 — 提取 taskUuid", "1b. 查看共享给我的听记", "1c. 查看我有权限访问的所有听记（支持关键字和时间范围筛选）", "从我创建的/我发起的听记里找XX", "从我的听记里仅按关键词搜索（\"从我的听记里搜技术方案\"）", "从我的听记里按关键词 + 上月时间范围搜索（\"上月听记里有没有提到OKR\"）", "从我的听记里按关键词 + 今日时间范围搜索（\"帮我从今天听记里找需求评审\"）", "关键词 + 时间范围组合", "别人给我的听记/共享听记/共享给我的", "我创建的听记/我发起的听记/我自己录的听记", "我可访问的听记/我能看到的听记/我有权限的听记/所有听记/全部听记", "我的听记", "我的听记里找XX", "按关键词搜索", "按关键词搜索共享听记", "按时间范围搜索", "某时间段内的听记/按时间查听记/按关键词查听记" ] }, "minutes.list_minutes_todos": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.list_minutes_todos", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取听记中提取的待办事项", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 /”请改用 dws minutes get batch", "要“获取听记 AI 摘要 (Markdown 格式)”请改用 dws minutes get summary", "要“获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接”请改用 dws minutes get info" ], "canonical_path": "minutes.list_minutes_todos", "cli_name": "todos", "cli_path": "minutes get todos", "confirmation": "not_required", "description": "根据听记唯一标识查询该听记中提取的待办事项列表。输入参数：目标听记的唯一标识符taskUuid。返回待办事项列表，每条记录包含：待办事项内容、待办唯一ID、参与人信息、待办时间。适用于会后跟进行动项、任务分配追踪、按人员或时间筛选待办等场景。", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes get todos --id \u003ctaskUuid\u003e", "dws minutes get todos --id \u003ctaskUuid\u003e --format json" ], "group": "get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "list_minutes_todos" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_minutes_todos", "parameter_count": 1, "parameters": { "id": { "description": "听记 taskUuid (必填)", "interface_description": "听记的taskUiUuid", "property": "taskUuid", "required": true, "type": "string" } }, "path": "minutes.list_minutes_todos", "primary_cli_path": "minutes get todos", "product_id": "minutes", "risk": "low", "source": "runtime:minutes", "title": "list_minutes_todos", "use_when": [ "4. 提取待办事项", "会议待办/听记待办/待办事项", "把 XX 改成 YY；用户想提取待办" ] }, "minutes.list_my_hotwords": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.minutes.list_my_hotwords", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询我的热词列表，返回个人的所有听记配置过的热词列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加个人热词 (优化识别专有名词 / 人名)”请改用 dws minutes hot-word add" ], "canonical_path": "minutes.list_my_hotwords", "cli_name": "list", "cli_path": "minutes hot-word list", "confirmation": "not_required", "description": "查询我的热词列表，返回个人的所有听记配置过的热词列表", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes hot-word list" ], "group": "hot-word", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "list_my_hotwords" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_my_hotwords", "parameter_count": 0, "parameters": {}, "path": "minutes.list_my_hotwords", "primary_cli_path": "minutes hot-word list", "product_id": "minutes", "reviewed": false, "risk": "low", "source": "runtime:minutes", "title": "list_my_hotwords", "use_when": [ "看看我的热词/我加了哪些热词/热词列表/查热词" ] }, "minutes.query_mind_graph_status": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.query_mind_graph_status", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询思维导图任务状态 (0=进行中 / 1=成功 / 2=失败)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“触发思维导图生成任务 (完成状态走 mind-graph sta”请改用 dws minutes mind-graph create" ], "canonical_path": "minutes.query_mind_graph_status", "cli_name": "status", "cli_path": "minutes mind-graph status", "confirmation": "not_required", "description": "查询思维导图任务状态，根据taskUuid查询对应思维导图状态。\r\n返回的结果里，任务状态（taskStatus）如下：\r\n0-进行中，1-成功，2-失败\r\n如果没有返回任务状态，也视为成功", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes mind-graph status --id \u003ctaskUuid\u003e", "dws minutes mind-graph status --id \u003ctaskUuid\u003e --format json" ], "group": "mind-graph", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "query_mind_graph_status" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_mind_graph_status", "parameter_count": 1, "parameters": { "id": { "description": "听记 taskUuid (必填)", "interface_description": "听记唯一标识", "property": "taskUuid", "required": true, "type": "string" } }, "path": "minutes.query_mind_graph_status", "primary_cli_path": "minutes mind-graph status", "product_id": "minutes", "risk": "low", "source": "runtime:minutes", "title": "query_mind_graph_status", "use_when": [ "8. 思维导图", "思维导图状态/脑图进度/思维导图好了吗" ] }, "minutes.query_minutes_audio_url": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.minutes.query_minutes_audio_url", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询听记的音频/视频地址，入参为 taskUuid 和操作人 uid，操作人需拥有该听记的\"读\"权限及以上才会返回；", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量查询听记详情 (标题 / 时长 / 参与人 / 创建时间 /”请改用 dws minutes get batch", "要“获取听记 AI 摘要 (Markdown 格式)”请改用 dws minutes get summary", "要“获取听记基础信息 (创建人 / 起止时间 / 标题 / 访问链接”请改用 dws minutes get info" ], "canonical_path": "minutes.query_minutes_audio_url", "cli_name": "audio", "cli_path": "minutes get audio", "confirmation": "not_required", "description": "查询听记的音频/视频地址，入参为 taskUuid 和操作人 uid，操作人需拥有该听记的\"读\"权限及以上才会返回；支持所有类型的听记（线上闪记、线下闪记、A1 硬件听记、上传文件听记等）。在返回地址前会过滤以下场景：听记已被删除、A1 无痕模式听记、临存过期的听记（媒体未准备好或临时存储已过期）。", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes get audio --id \u003ctaskUuid\u003e --format json" ], "group": "get", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "query_minutes_audio_url" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_minutes_audio_url", "parameter_count": 1, "parameters": { "id": { "description": "听记 taskUuid (必填)", "interface_description": "听记uuid", "property": "taskUuid", "required": true, "type": "string" } }, "path": "minutes.query_minutes_audio_url", "primary_cli_path": "minutes get audio", "product_id": "minutes", "reviewed": false, "risk": "low", "source": "runtime:minutes", "title": "query_minutes_audio_url", "use_when": [ "4b. 获取音频/视频地址（用于下载或播放原始媒体文件）", "音频地址/音频链接/录音文件/下载录音/音频下载/视频文件/媒体地址" ] }, "minutes.query_minutes_by_tag_id": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.minutes.query_minutes_by_tag_id", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "根据用户的标签或者分组信息来查询听记列表信息，用户的标签通过听记页面手动创建。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“查询我的的听记的标签或者分组列表，标签或者分组在听记页面创建”请改用 dws minutes tag list" ], "canonical_path": "minutes.query_minutes_by_tag_id", "cli_name": "query", "cli_path": "minutes tag query", "confirmation": "not_required", "description": "根据用户的标签或者分组信息来查询听记列表信息，用户的标签通过听记页面手动创建。", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes tag query --tag-id \u003ctagId\u003e", "dws minutes tag query --tag-id \u003ctagId\u003e --limit 20" ], "group": "tag", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "query_minutes_by_tag_id" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_minutes_by_tag_id", "parameter_count": 3, "parameters": { "cursor": { "description": "分页 token (首页留空)", "property": "cursor", "required": false, "type": "string" }, "limit": { "default": "10", "description": "每页数据条数 (默认 10)", "property": "size", "required": false, "type": "number" }, "tag-id": { "description": "标签/分组 ID，可通过 tag list 获取 (必填)", "interface_description": "tagId", "property": "tagId", "required": true, "type": "string" } }, "path": "minutes.query_minutes_by_tag_id", "primary_cli_path": "minutes tag query", "product_id": "minutes", "reviewed": false, "risk": "low", "source": "runtime:minutes", "title": "query_minutes_by_tag_id", "use_when": [ "查看某个标签下的听记/这个标签下有哪些听记/按标签查听记" ] }, "minutes.query_user_tag_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.minutes.query_user_tag_list", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询我的的听记的标签或者分组列表，标签或者分组在听记页面创建。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“根据用户的标签或者分组信息来查询听记列表信息，用户的标签通过听记”请改用 dws minutes tag query" ], "canonical_path": "minutes.query_user_tag_list", "cli_name": "list", "cli_path": "minutes tag list", "confirmation": "not_required", "description": "查询我的的听记的标签或者分组列表，标签或者分组在听记页面创建。", "display": "AI 听记 / 会议纪要", "effect": "read", "effect_source": "command-verb", "examples": [ "dws minutes tag list" ], "group": "tag", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "query_user_tag_list" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_user_tag_list", "parameter_count": 0, "parameters": {}, "path": "minutes.query_user_tag_list", "primary_cli_path": "minutes tag list", "product_id": "minutes", "reviewed": false, "risk": "low", "source": "runtime:minutes", "title": "query_user_tag_list", "use_when": [ "我的听记标签/听记分组/听记有哪些标签/有哪些分组", "按标签查/某个标签下的听记/标签筛选", "标签列表/分组列表/有哪些标签/有哪些分组" ] }, "minutes.record_pause": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "暂停听记录音", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“发起听记 (开始录音)”请改用 dws minutes record start", "要“恢复听记录音”请改用 dws minutes record resume", "要“结束听记录音”请改用 dws minutes record stop" ], "canonical_path": "minutes.record_pause", "cli_name": "pause", "cli_path": "minutes record pause", "confirmation": "not_required", "description": "暂停听记录音", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes record pause --id \u003ctaskUuid\u003e", "dws minutes record pause --id \u003ctaskUuid\u003e --session-id \u003csessionId\u003e" ], "group": "record", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "执行听记指令-发起AI听记录音" }, "is_alias": false, "name": "record_pause", "parameter_count": 2, "parameters": { "id": { "description": "听记 taskUuid (必填)", "property": "uuid", "required": true, "type": "string" }, "session-id": { "description": "AI 助理会话 ID (可选)", "property": "sessionId", "required": false, "type": "string" } }, "path": "minutes.record_pause", "primary_cli_path": "minutes record pause", "product_id": "minutes", "reviewed": true, "risk": "medium", "source": "runtime:minutes", "title": "暂停听记录音", "use_when": [ "7. 录音控制（基于 start 返回的 taskUuid）", "暂停一下/暂停录音", "暂停听记录音" ] }, "minutes.record_resume": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "恢复听记录音", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“发起听记 (开始录音)”请改用 dws minutes record start", "要“暂停听记录音”请改用 dws minutes record pause", "要“结束听记录音”请改用 dws minutes record stop" ], "canonical_path": "minutes.record_resume", "cli_name": "resume", "cli_path": "minutes record resume", "confirmation": "not_required", "description": "恢复听记录音", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes record resume --id \u003ctaskUuid\u003e", "dws minutes record resume --id \u003ctaskUuid\u003e --session-id \u003csessionId\u003e" ], "group": "record", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "执行听记指令-发起AI听记录音" }, "is_alias": false, "name": "record_resume", "parameter_count": 2, "parameters": { "id": { "description": "听记 taskUuid (必填)", "property": "uuid", "required": true, "type": "string" }, "session-id": { "description": "AI 助理会话 ID (可选)", "property": "sessionId", "required": false, "type": "string" } }, "path": "minutes.record_resume", "primary_cli_path": "minutes record resume", "product_id": "minutes", "reviewed": true, "risk": "medium", "source": "runtime:minutes", "title": "恢复听记录音", "use_when": [ "7. 录音控制（基于 start 返回的 taskUuid）", "恢复听记录音", "继续/继续录音" ] }, "minutes.record_start": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "发起听记 (开始录音)", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“恢复听记录音”请改用 dws minutes record resume", "要“暂停听记录音”请改用 dws minutes record pause", "要“结束听记录音”请改用 dws minutes record stop" ], "canonical_path": "minutes.record_start", "cli_name": "start", "cli_path": "minutes record start", "confirmation": "not_required", "description": "发起听记（开始录音）", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes record start", "dws minutes record start --session-id \u003csessionId\u003e" ], "group": "record", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "执行听记指令-发起AI听记录音" }, "is_alias": false, "name": "record_start", "parameter_count": 1, "parameters": { "session-id": { "description": "AI 助理会话 ID (可选)", "property": "sessionId", "required": false, "type": "string" } }, "path": "minutes.record_start", "primary_cli_path": "minutes record start", "product_id": "minutes", "reviewed": true, "risk": "medium", "source": "runtime:minutes", "title": "发起听记（开始录音）", "use_when": [ "0. 发起听记（开始录音）", "发起听记 (开始录音)", "开始听记/开始录音/发起一个听记/启动听记/开始听记录这次会议/我要开始听记了/录音开始/我要听记" ] }, "minutes.record_stop": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "结束听记录音", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "要“发起听记 (开始录音)”请改用 dws minutes record start", "要“恢复听记录音”请改用 dws minutes record resume", "要“暂停听记录音”请改用 dws minutes record pause" ], "canonical_path": "minutes.record_stop", "cli_name": "stop", "cli_path": "minutes record stop", "confirmation": "not_required", "description": "结束听记录音", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes record stop --id \u003ctaskUuid\u003e", "dws minutes record stop --id \u003ctaskUuid\u003e --session-id \u003csessionId\u003e" ], "group": "record", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "执行听记指令-发起AI听记录音" }, "is_alias": false, "name": "record_stop", "parameter_count": 2, "parameters": { "id": { "description": "听记 taskUuid (必填)", "property": "uuid", "required": true, "type": "string" }, "session-id": { "description": "AI 助理会话 ID (可选)", "property": "sessionId", "required": false, "type": "string" } }, "path": "minutes.record_stop", "primary_cli_path": "minutes record stop", "product_id": "minutes", "reviewed": true, "risk": "medium", "source": "runtime:minutes", "title": "结束听记录音", "use_when": [ "7. 录音控制（基于 start 返回的 taskUuid）", "结束听记/结束录音/停止录音/结束", "结束听记录音" ] }, "minutes.remove_member_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.minutes.remove_member_permission", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "批量移除多个听记的成员的权限。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“批量给多个听记增加成员，并且设置成员的权限”请改用 dws minutes permission add" ], "canonical_path": "minutes.remove_member_permission", "cli_name": "remove", "cli_path": "minutes permission remove", "confirmation": "user_required", "description": "批量移除多个听记的成员的权限。权限类型为：0:管理员;1:所有者；2:可编辑;3:可查看/下载;4:仅查看。", "display": "AI 听记 / 会议纪要", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws minutes permission remove --ids \u003cuuid1,uuid2\u003e --member-uids 123456,789012", "dws minutes permission remove --ids \u003cuuid\u003e --member-uids 123456" ], "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "remove_member_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_member_permission", "parameter_count": 2, "parameters": { "ids": { "description": "听记 taskUuid 列表，逗号分隔 (必填)", "interface_description": "听记uuid列表，uuid为听记唯一标识", "interface_type": "array", "property": "uuids", "required": true, "type": "string" }, "member-uids": { "description": "成员钉钉 UID 列表，逗号分隔 (必填)", "interface_description": "需要添加的成员的钉钉Uid列表，长整型", "interface_type": "array", "property": "memberUids", "required": true, "type": "string" } }, "path": "minutes.remove_member_permission", "primary_cli_path": "minutes permission remove", "product_id": "minutes", "reviewed": false, "risk": "high", "source": "runtime:minutes", "title": "remove_member_permission", "use_when": [ "移除/取消/删除/不让...看", "移除某人的权限/取消共享/不让某人看这个听记了" ] }, "minutes.replace_minutes_text": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.replace_minutes_text", "skills/mono/SKILL.md", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "在段落 + 纪要中全量替换文字 (区分大小写，精确匹配)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "用户未明确要求“在段落 + 纪要中全量替换文字 (区分大小写，精确匹配)”、目标不清楚或尚未确认时不要使用" ], "canonical_path": "minutes.replace_minutes_text", "cli_name": "replace-text", "cli_path": "minutes replace-text", "confirmation": "user_required", "description": "把听记中所有出现的原文字替换为目标文字，包括转写段落和纪要摘要中出现的原文字都会被替换为目标文字", "display": "AI 听记 / 会议纪要", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws minutes replace-text --id \u003ctaskUuid\u003e --search \"旧文字\" --replace \"新文字\"", "dws minutes replace-text --id \u003ctaskUuid\u003e --search \"发言人1\" --replace \"张三\" --format json" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "replace_minutes_text" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "replace_minutes_text", "parameter_count": 3, "parameters": { "id": { "description": "听记 taskUuid (必填)", "interface_description": "听记的taskUuid", "property": "taskUuid", "required": true, "type": "string" }, "replace": { "description": "替换为的新文字 (必填)", "interface_description": "替换后的目标文字，如 \"李四\"，允许为空字符串（即删除原始文字）", "property": "replacedText", "required": true, "type": "string" }, "search": { "description": "要查找的文字 (必填)", "interface_description": "被替换的原始文字，如 \"张三\"。区分大小写，精确匹配", "property": "originalText", "required": true, "type": "string" } }, "path": "minutes.replace_minutes_text", "primary_cli_path": "minutes replace-text", "product_id": "minutes", "risk": "high", "source": "runtime:minutes", "title": "replace_minutes_text", "use_when": [ "11. 查找替换听记文字", "把所有的A替换成B/查找替换/批量替换文字" ] }, "minutes.replace_speaker": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.replace_speaker", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "批量替换听记中指定发言人", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“批量替换听记中指定发言人”所述变更时不要使用" ], "canonical_path": "minutes.replace_speaker", "cli_name": "replace", "cli_path": "minutes speaker replace", "confirmation": "not_required", "description": "批量替换听记转写中指定发言人，将源发言人（speakerNick）精确匹配的所有段落替换为目标发言人，支持同时替换 nickName 和 subSpeakerNickname 两种匹配方式，并自动更新纪要、待办中的发言人信息。", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes speaker replace --id \u003ctaskUuid\u003e --from \"张三\" --to \"李四\"", "dws minutes speaker replace --id \u003ctaskUuid\u003e --from \"张三\" --to \"李四\" --target-uid \u003cuid\u003e" ], "group": "speaker", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "replace_speaker" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "replace_speaker", "parameter_count": 4, "parameters": { "from": { "description": "源发言人昵称 (必填)", "interface_description": "源发言人昵称，精确匹配转写段落中的 nickName 或 subSpeakerNickname 字段", "property": "speakerNick", "required": true, "type": "string" }, "id": { "description": "听记 taskUuid (必填)", "interface_description": "听记的taskUuid", "property": "taskUuid", "required": true, "type": "string" }, "target-uid": { "description": "目标发言人钉钉 UID (可选)", "interface_description": "目标发言人uid，如果为空则只修改发言人昵称", "property": "targetUid", "required": false, "type": "string" }, "to": { "description": "目标发言人昵称 (必填)", "interface_description": "目标发言人昵称，替换后所有匹配段落的发言人将显示为此名称", "property": "targetNickName", "required": true, "type": "string" } }, "path": "minutes.replace_speaker", "primary_cli_path": "minutes speaker replace", "product_id": "minutes", "risk": "medium", "source": "runtime:minutes", "title": "replace_speaker", "use_when": [ "3b. 用户提供\"某某人讲了 XX\" → AI 模糊匹配关键词后，引导确认替换发言人", "9. 替换发言人", "把 XX 改成 YY；用户直接说\"把发言人1改成张三", "替换发言人/修改发言人/换发言人名字/把说话人改成某某/发言人标注错了" ] }, "minutes.update_minutes_summary": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.update_minutes_summary", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "全量覆盖纪要内容 (不触发 AI 重算)", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“修改听记标题”请改用 dws minutes update title" ], "canonical_path": "minutes.update_minutes_summary", "cli_name": "summary", "cli_path": "minutes update summary", "confirmation": "not_required", "description": "用传入的摘要文本全量覆盖听记的纪要内容，不触发 AI 重新生成。适用于用户手动编辑或 AI Agent 修改纪要的场景。", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes update summary --id \u003ctaskUuid\u003e --content \"新的纪要内容\"", "dws minutes update summary --id \u003ctaskUuid\u003e --content \"新的纪要内容\" --format json" ], "group": "update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "update_minutes_summary" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_minutes_summary", "parameter_count": 2, "parameters": { "content": { "description": "新的纪要内容 (必填)", "interface_description": "更新纪要的全文内容", "property": "summaryText", "required": true, "type": "string" }, "id": { "description": "听记 taskUuid (必填)", "interface_description": "听记的taskUuid", "property": "taskUuid", "required": true, "type": "string" } }, "path": "minutes.update_minutes_summary", "primary_cli_path": "minutes update summary", "product_id": "minutes", "risk": "medium", "source": "runtime:minutes", "title": "update_minutes_summary", "use_when": [ "6. 更新纪要内容" ] }, "minutes.update_minutes_title": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.minutes.prod.json#minutes.update_minutes_title", "skills/mono/references/products/minutes.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "修改听记标题", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“全量覆盖纪要内容 (不触发 AI 重算)”请改用 dws minutes update summary" ], "canonical_path": "minutes.update_minutes_title", "cli_name": "title", "cli_path": "minutes update title", "confirmation": "not_required", "description": "修改指定听记的标题名称。输入参数：taskUuid、newTitle 新的听记标题。操作成功返回更新结果状态。适用于用户对已有听记进行重命名、整理归档等场景。", "display": "AI 听记 / 会议纪要", "effect": "write", "effect_source": "command-verb", "examples": [ "dws minutes update title --id \u003ctaskUuid\u003e --title \"Q2 复盘会议\"", "dws minutes update title --id \u003ctaskUuid\u003e --title \"新标题\" --format json" ], "group": "update", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "minutes", "rpc_name": "update_minutes_title" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_minutes_title", "parameter_count": 2, "parameters": { "id": { "description": "听记 taskUuid (必填)", "interface_description": "听记的taskUuid", "property": "taskUuid", "required": true, "type": "string" }, "title": { "description": "新标题 (必填)", "interface_description": "要更新的听记标题", "property": "title", "required": true, "type": "string" } }, "path": "minutes.update_minutes_title", "primary_cli_path": "minutes update title", "product_id": "minutes", "risk": "medium", "source": "runtime:minutes", "title": "update_minutes_title", "use_when": [ "5. 修改标题", "改听记标题/重命名听记/修改标题" ] }, "oa.approve_processInstance": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.approve_processInstance", "skills/mono/references/products/oa.md", "skills/mono/references/products/simple.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "同意审批", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed", "要“获取抄送用户的列表”请改用 dws oa approval list-cc" ], "canonical_path": "oa.approve_processInstance", "cli_name": "approve", "cli_path": "oa approval approve", "confirmation": "not_required", "description": "处理某个需要我处理的实例任务，拒绝审批实例任务，所需要的参数processInstanceId可以从list_pending_approvals工具获取。", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "write", "effect_source": "command-verb", "examples": [ "dws oa approval approve --instance-id \u003cid\u003e --task-id \u003ctaskId\u003e", "dws oa approval approve --instance-id \u003cid\u003e --task-id \u003ctaskId\u003e --remark \"同意\"" ], "group": "approval", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "approve_processInstance" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "approve_processInstance", "parameter_count": 3, "parameters": { "instance-id": { "description": "审批实例 ID (必填)", "interface_description": "审批实例Id", "property": "processInstanceId", "required": true, "type": "string" }, "remark": { "description": "审批意见 (可选)", "interface_description": "审批意见", "property": "remark", "required": false, "type": "string" }, "task-id": { "description": "审批任务 ID (必填)", "interface_description": "审批任务ID", "interface_type": "number", "property": "taskId", "required": true, "type": "string" } }, "path": "oa.approve_processInstance", "primary_cli_path": "oa approval approve", "product_id": "oa", "risk": "medium", "source": "runtime:oa", "title": "approve_processInstance", "use_when": [ "4a. 同意审批", "同意审批/批准" ] }, "oa.dingflow_comments": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.oa.dingflow_comments", "skills/mono/references/products/oa.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "用户添加审批评论", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed", "要“获取抄送用户的列表”请改用 dws oa approval list-cc" ], "canonical_path": "oa.dingflow_comments", "cli_name": "oa-comments", "cli_path": "oa approval oa-comments", "confirmation": "not_required", "description": "用户添加审批评论", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "write", "effect_source": "command-verb", "examples": [ "dws oa approval oa-comments --instance-id \u003cprocessInstanceId\u003e --content \"同意，请尽快处理\"", "dws oa approval oa-comments --instance-id \u003cprocessInstanceId\u003e --content \"同意，请尽快处理\" --format json" ], "group": "approval", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "dingflow_comments" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "dingflow_comments", "parameter_count": 2, "parameters": { "content": { "description": "评论内容 (必填)", "property": "content", "required": true, "type": "string" }, "instance-id": { "description": "审批实例 ID (必填)", "interface_description": "processInstanceId", "property": "processInstanceId", "required": true, "type": "string" } }, "path": "oa.dingflow_comments", "primary_cli_path": "oa approval oa-comments", "product_id": "oa", "reviewed": false, "risk": "medium", "source": "runtime:oa", "title": "dingflow_comments", "use_when": [ "13. 对审批实例添加评论（processInstanceId 来自 list-pending 或 detail）", "评论审批/添加评论/写评论" ] }, "oa.get_done_tasks": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.oa.get_done_tasks", "skills/mono/references/products/oa.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取员工已处理任务列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取抄送用户的列表”请改用 dws oa approval list-cc" ], "canonical_path": "oa.get_done_tasks", "cli_name": "list-executed", "cli_path": "oa approval list-executed", "confirmation": "not_required", "description": "获取员工已处理任务列表", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "read", "effect_source": "command-verb", "examples": [ "dws oa approval list-executed --limit \u003cpageSize\u003e --page \u003cpageNumber\u003e --query 关键词", "dws oa approval list-executed --limit \u003cpageSize\u003e --page \u003cpageNumber\u003e --query 关键词 --format json" ], "group": "approval", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "get_done_tasks" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_done_tasks", "parameter_count": 3, "parameters": { "limit": { "default": "20", "description": "每页大小（可选）", "interface_description": "页数", "interface_type": "number", "property": "pageSize", "required": false, "type": "string" }, "page": { "default": "1", "description": "分页页码（可选）", "interface_description": "页号", "interface_type": "number", "property": "pageNumber", "required": false, "type": "string" }, "query": { "description": "关键字搜索（可选）", "interface_description": "查询字段", "property": "query", "required": false, "type": "string" } }, "path": "oa.get_done_tasks", "primary_cli_path": "oa approval list-executed", "product_id": "oa", "reviewed": false, "risk": "low", "source": "runtime:oa", "title": "get_done_tasks", "use_when": [ "9. 我处理过的审批单", "我审批/处理过的审批单" ] }, "oa.get_noticed_instances": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.oa.get_noticed_instances", "skills/mono/references/products/oa.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取抄送用户的列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.get_noticed_instances", "cli_name": "list-cc", "cli_path": "oa approval list-cc", "confirmation": "not_required", "description": "获取抄送用户的列表", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "read", "effect_source": "command-verb", "examples": [ "dws oa approval list-cc --limit \u003cpageSize\u003e --page \u003cpageNumber\u003e --query 关键词", "dws oa approval list-cc --limit \u003cpageSize\u003e --page \u003cpageNumber\u003e --query 关键词 --format json" ], "group": "approval", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "get_noticed_instances" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_noticed_instances", "parameter_count": 3, "parameters": { "limit": { "default": "20", "description": "每页大小（可选）", "interface_description": "页数", "interface_type": "number", "property": "pageSize", "required": false, "type": "string" }, "page": { "default": "1", "description": "分页页码（可选）", "interface_description": "页号", "interface_type": "number", "property": "pageNumber", "required": false, "type": "string" }, "query": { "description": "关键字搜索（可选）", "interface_description": "query", "property": "query", "required": false, "type": "string" } }, "path": "oa.get_noticed_instances", "primary_cli_path": "oa approval list-cc", "product_id": "oa", "reviewed": false, "risk": "low", "source": "runtime:oa", "title": "get_noticed_instances", "use_when": [ "11. 抄送我的审批单", "抄送我的审批单" ] }, "oa.get_processInstance_detail": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.get_processInstance_detail", "skills/mono/references/products/oa.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取审批实例详情", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.get_processInstance_detail", "cli_name": "detail", "cli_path": "oa approval detail", "confirmation": "not_required", "description": "获取指定审批实例的详情信息", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "read", "effect_source": "command-verb", "examples": [ "dws oa approval detail --instance-id \u003cprocessInstanceId\u003e", "dws oa approval detail --instance-id \u003cprocessInstanceId\u003e --format json" ], "group": "approval", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "get_processInstance_detail" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_processInstance_detail", "parameter_count": 1, "parameters": { "instance-id": { "description": "审批实例 ID (必填)", "interface_description": "审批实例Id", "property": "processInstanceId", "required": true, "type": "string" } }, "path": "oa.get_processInstance_detail", "primary_cli_path": "oa approval detail", "product_id": "oa", "risk": "low", "source": "runtime:oa", "title": "get_processInstance_detail", "use_when": [ "2. 查看审批详情 — 了解审批内容", "审批详情/看审批" ] }, "oa.get_processInstance_records": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.get_processInstance_records", "skills/mono/references/products/oa.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取审批操作记录", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.get_processInstance_records", "cli_name": "records", "cli_path": "oa approval records", "confirmation": "not_required", "description": "获取某个审批实例的审批操作记录信息，获取的是该审批实例有哪些人做了什么操作，以及操作结果是什么", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "read", "effect_source": "command-verb", "examples": [ "dws oa approval records --instance-id \u003cprocessInstanceId\u003e", "dws oa approval records --instance-id \u003cprocessInstanceId\u003e --format json" ], "group": "approval", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "get_processInstance_records" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_processInstance_records", "parameter_count": 1, "parameters": { "instance-id": { "description": "审批实例 ID (必填)", "interface_description": "审批实例Id", "property": "processInstanceId", "required": true, "type": "string" } }, "path": "oa.get_processInstance_records", "primary_cli_path": "oa approval records", "product_id": "oa", "risk": "low", "source": "runtime:oa", "title": "get_processInstance_records", "use_when": [ "6. 查看审批操作记录", "审批记录/操作历史" ] }, "oa.get_submitted_instances": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.oa.get_submitted_instances", "skills/mono/references/products/oa.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取已提交实例列表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.get_submitted_instances", "cli_name": "list-submitted", "cli_path": "oa approval list-submitted", "confirmation": "not_required", "description": "获取已提交实例列表", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "read", "effect_source": "command-verb", "examples": [ "dws oa approval list-submitted --limit \u003cpageSize\u003e --page \u003cpageNumber\u003e --query 关键词", "dws oa approval list-submitted --limit \u003cpageSize\u003e --page \u003cpageNumber\u003e --query 关键词 --format json" ], "group": "approval", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "get_submitted_instances" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_submitted_instances", "parameter_count": 3, "parameters": { "limit": { "default": "20", "description": "每页大小（可选）", "interface_description": "页数", "interface_type": "number", "property": "pageSize", "required": false, "type": "string" }, "page": { "default": "1", "description": "分页页码（可选）", "interface_description": "页号", "interface_type": "number", "property": "pageNumber", "required": false, "type": "string" }, "query": { "description": "关键字搜索（可选）", "interface_description": "搜索字段", "property": "query", "required": false, "type": "string" } }, "path": "oa.get_submitted_instances", "primary_cli_path": "oa approval list-submitted", "product_id": "oa", "reviewed": false, "risk": "low", "source": "runtime:oa", "title": "get_submitted_instances", "use_when": [ "10. 我发起的审批单", "我发起的审批单" ] }, "oa.list_initiated_instances": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.list_initiated_instances", "skills/mono/references/products/oa.md", "skills/mono/references/products/simple.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询已发起的审批实例列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.list_initiated_instances", "cli_name": "list-initiated", "cli_path": "oa approval list-initiated", "confirmation": "not_required", "description": "查询当前用户已发起的审批实例列表，查询的信息包含审批实例Id、审批实例发起时间、审批实例当前状态等基础信息", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "read", "effect_source": "command-verb", "examples": [ "dws oa approval list-initiated --process-code \u003ccode\u003e --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-10T23:59:59+08:00\" --cursor 0 --limit 20", "dws oa approval list-initiated --process-code \u003ccode\u003e --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-10T23:59:59+08:00\" --cursor 0 --limit 20 --format json" ], "group": "approval", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "list_initiated_instances" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_initiated_instances", "parameter_count": 5, "parameters": { "cursor": { "default": "0", "description": "分页游标，首次传 0", "property": "cursor", "required": false, "type": "string" }, "end": { "description": "结束时间 ISO-8601 (如 2026-03-10T23:59:59+08:00) (必填)", "format": "date-time", "interface_description": "审批实例开始时间，Unix时间戳，单位毫秒", "interface_type": "number", "property": "endTime", "required": true, "type": "string" }, "limit": { "default": "20", "description": "每页大小，最大 20", "property": "limit", "required": false, "type": "string" }, "process-code": { "description": "表单 processCode (必填)", "interface_description": "需要查询实例列表的表单processCode", "property": "processCode", "required": true, "type": "string" }, "start": { "description": "开始时间 ISO-8601 (如 2026-03-10T00:00:00+08:00) (必填)", "format": "date-time", "interface_description": "审批实例开始时间，Unix时间戳，单位毫秒", "interface_type": "number", "property": "startTime", "required": true, "type": "string" } }, "path": "oa.list_initiated_instances", "primary_cli_path": "oa approval list-initiated", "product_id": "oa", "risk": "low", "source": "runtime:oa", "title": "list_initiated_instances", "use_when": [ "8. 查看自己发起的审批列表（--process-code 来自 list-forms / search-forms / detail）", "我发起的审批" ] }, "oa.list_pending_approvals": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.list_pending_approvals", "skills/mono/references/products/oa.md", "skills/mono/references/products/simple.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询待我处理的审批", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.list_pending_approvals", "cli_name": "list-pending", "cli_path": "oa approval list-pending", "confirmation": "not_required", "description": "查询当前用户待处理的审批单列表，返回每条审批单的名称、唯一编码（如审批实例 ID）、处理跳转链接（用于一键进入审批页面）等关键信息。结果仅包含用户作为审批人且尚未处理的审批事项，适用于工作台待办集成、审批提醒等场景。", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "read", "effect_source": "command-verb", "examples": [ "dws oa approval list-pending --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-10T23:59:59+08:00\"", "dws oa approval list-pending --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-10T23:59:59+08:00\" --query 关键词" ], "group": "approval", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "list_pending_approvals" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_pending_approvals", "parameter_count": 5, "parameters": { "end": { "description": "结束时间 ISO-8601 (如 2026-03-10T23:59:59+08:00) (必填)", "format": "date-time", "interface_description": "审批单创建时间的结束时间。毫秒时间戳格式，表示时间范围的上限。", "interface_type": "number", "property": "endTime", "required": true, "type": "string" }, "limit": { "description": "每页大小 (可选)", "interface_description": "每页大小", "interface_type": "number", "property": "pageSize", "required": false, "type": "string" }, "page": { "description": "分页页码 (可选)", "interface_description": "分页页码，从1开始", "interface_type": "number", "property": "pageNum", "required": false, "type": "string" }, "query": { "description": "关键字搜索（可选）", "interface_description": "query", "property": "query", "required": false, "type": "string" }, "start": { "description": "开始时间 ISO-8601 (如 2026-03-10T00:00:00+08:00) (必填)", "format": "date-time", "interface_description": "审批单创建时间的开始时间。毫秒时间戳格式，表示时间范围的下限", "interface_type": "number", "property": "starTime", "required": true, "type": "string" } }, "path": "oa.list_pending_approvals", "primary_cli_path": "oa approval list-pending", "product_id": "oa", "risk": "low", "source": "runtime:oa", "title": "list_pending_approvals", "use_when": [ "1. 查看待我处理的审批 — 提取 processInstanceId", "待审批/待处理审批", "待我审批/我要审批的" ] }, "oa.list_pending_tasks": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.list_pending_tasks", "skills/mono/references/products/oa.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询待我审批的任务 ID", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.list_pending_tasks", "cli_name": "tasks", "cli_path": "oa approval tasks", "confirmation": "not_required", "description": "查询待我审批的任务Id，获取任务Id之后，可以执行同意、拒绝审批单操作。", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "read", "effect_source": "command-verb", "examples": [ "dws oa approval tasks --instance-id \u003cprocessInstanceId\u003e", "dws oa approval tasks --instance-id \u003cprocessInstanceId\u003e --format json" ], "group": "approval", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "list_pending_tasks" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_pending_tasks", "parameter_count": 1, "parameters": { "instance-id": { "description": "审批实例 ID (必填)", "interface_description": "待我处理的审批实例Id，可通过list_pending_approvals工具获取", "property": "processInstanceId", "required": true, "type": "string" } }, "path": "oa.list_pending_tasks", "primary_cli_path": "oa approval tasks", "product_id": "oa", "risk": "low", "source": "runtime:oa", "title": "query_pending_tasks", "use_when": [ "3. 获取待审批任务 ID — 提取 taskId", "同意审批/批准", "我有哪些待审的任务", "拒绝审批/驳回" ] }, "oa.list_user_visible_process": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.list_user_visible_process", "skills/mono/references/products/oa.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取当前用户可见的审批表单列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.list_user_visible_process", "cli_name": "list-forms", "cli_path": "oa approval list-forms", "confirmation": "not_required", "description": "获取当前用户可见的审批表单列表，可获取审批表单的processCode。", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "read", "effect_source": "command-verb", "examples": [ "dws oa approval list-forms --cursor 0 --limit 100", "dws oa approval list-forms --cursor 0 --limit 100 --format json" ], "group": "approval", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "list_user_visible_process" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_user_visible_process", "parameter_count": 2, "parameters": { "cursor": { "default": "0", "description": "分页游标（默认 0，翻页传返回的 cursor）", "interface_description": "分页游标，首次调用需要传0", "interface_type": "number", "property": "cursor", "required": false, "type": "string" }, "limit": { "default": "100", "description": "每页大小（默认 100，最大 100）", "interface_description": "每页大小，最大值100", "interface_type": "number", "property": "pageSize", "required": false, "type": "string" } }, "path": "oa.list_user_visible_process", "primary_cli_path": "oa approval list-forms", "product_id": "oa", "risk": "low", "source": "runtime:oa", "title": "list_user_visible_process", "use_when": [ "7. 获取可见审批表单（得到 processCode）", "有哪些审批表单/可见表单" ] }, "oa.oa_cc_noticer": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.oa.oa_cc_noticer", "skills/mono/references/products/oa.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "抄送审批人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.oa_cc_noticer", "cli_name": "oa-cc-noticer", "cli_path": "oa approval oa-cc-noticer", "confirmation": "not_required", "description": "抄送审批人", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "write", "effect_source": "command-verb", "examples": [ "dws oa approval oa-cc-noticer --instance-id \u003cprocessInstanceId\u003e --users \"68674200835816\"", "dws oa approval oa-cc-noticer --instance-id \u003cprocessInstanceId\u003e --users \"userId1,userId2\" --operator-id \"123123\"" ], "group": "approval", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "oa_cc_noticer" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "oa_cc_noticer", "parameter_count": 3, "parameters": { "instance-id": { "description": "审批实例 ID (必填)", "interface_description": "processInstanceId", "property": "processInstanceId", "required": true, "type": "string" }, "operator-id": { "description": "操作人 ID (可选)", "interface_description": "operatorId", "property": "operatorId", "required": false, "type": "string" }, "users": { "description": "抄送用户 ID 列表，多个用逗号分隔 (必填)", "property": "users", "required": true, "type": "string" } }, "path": "oa.oa_cc_noticer", "primary_cli_path": "oa approval oa-cc-noticer", "product_id": "oa", "reviewed": false, "risk": "medium", "source": "runtime:oa", "title": "oa_cc_noticer", "use_when": [ "14. 对审批实例进行抄送（processInstanceId 来自 list-pending 或 detail）", "抄送审批/添加抄送人" ] }, "oa.redirect_task": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.oa.redirect_task", "skills/mono/references/products/oa.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "转交审批任务", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.redirect_task", "cli_name": "redirect-task", "cli_path": "oa approval redirect-task", "confirmation": "not_required", "description": "转交审批任务", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "write", "effect_source": "command-verb", "examples": [ "dws oa approval redirect-task --task-id \u003ctaskId\u003e --to-actioner-id \u003cuserId\u003e", "dws oa approval redirect-task --task-id \u003ctaskId\u003e --to-actioner-id \u003cuserId\u003e --remark \"请帮忙处理\"" ], "group": "approval", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "redirect_task" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "redirect_task", "parameter_count": 3, "parameters": { "remark": { "description": "转交说明 (可选)", "interface_description": "备注信息", "property": "remark", "required": false, "type": "string" }, "task-id": { "description": "审批任务 ID (必填)", "interface_description": "审批任务ID，必填", "property": "taskId", "required": true, "type": "string" }, "to-actioner-id": { "description": "转交目标用户 ID (必填)", "interface_description": "转交目标用户的用户ID", "property": "toActionerId", "required": true, "type": "string" } }, "path": "oa.redirect_task", "primary_cli_path": "oa approval redirect-task", "product_id": "oa", "reviewed": false, "risk": "medium", "source": "runtime:oa", "title": "redirect_task", "use_when": [ "12. 转交审批任务（taskId 来自 tasks，toActionerId 来自 contact user search）", "转交审批/转交任务" ] }, "oa.reject_processInstance": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.reject_processInstance", "skills/mono/SKILL.md", "skills/mono/references/products/oa.md", "skills/mono/references/products/simple.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "拒绝审批", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.reject_processInstance", "cli_name": "reject", "cli_path": "oa approval reject", "confirmation": "user_required", "description": "处理某个需要我处理的实例任务，拒绝审批实例任务，所需要的参数processInstanceId可以从list_pending_approvals工具获取。", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws oa approval reject --instance-id \u003cid\u003e --task-id \u003ctaskId\u003e --remark \"不同意\"", "dws oa approval reject --instance-id \u003cid\u003e --task-id \u003ctaskId\u003e --remark \"不符合要求\" --format json" ], "group": "approval", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "reject_processInstance" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "reject_processInstance", "parameter_count": 3, "parameters": { "instance-id": { "description": "审批实例 ID (必填)", "interface_description": "审批实例Id", "property": "processInstanceId", "required": true, "type": "string" }, "remark": { "description": "审批意见 (可选)", "interface_description": "审批意见", "property": "remark", "required": false, "type": "string" }, "task-id": { "description": "审批任务 ID (必填)", "interface_description": "审批任务ID", "interface_type": "number", "property": "taskId", "required": true, "type": "string" } }, "path": "oa.reject_processInstance", "primary_cli_path": "oa approval reject", "product_id": "oa", "risk": "high", "source": "runtime:oa", "title": "reject_processInstance", "use_when": [ "4b. 拒绝审批", "拒绝审批/驳回" ] }, "oa.revoke_processInstance": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.revoke_processInstance", "skills/mono/SKILL.md", "skills/mono/references/products/oa.md", "skills/mono/references/products/simple.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "撤销已发起的审批", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“同意审批”请改用 dws oa approval approve", "要“用户添加审批评论”请改用 dws oa approval oa-comments", "要“获取员工已处理任务列表”请改用 dws oa approval list-executed" ], "canonical_path": "oa.revoke_processInstance", "cli_name": "revoke", "cli_path": "oa approval revoke", "confirmation": "user_required", "description": "撤销当前用户已经发起的审批实例，需要的参数processInstanceId可以从", "display": "OA 审批 / 同意 / 拒绝 / 撤销", "effect": "write", "effect_source": "skill-explicit", "examples": [ "dws oa approval revoke --instance-id \u003cinstance-id\u003e" ], "group": "approval", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "oa", "rpc_name": "revoke_processInstance" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "revoke_processInstance", "parameter_count": 2, "parameters": { "instance-id": { "description": "审批实例 ID (必填)", "interface_description": "需要撤销的审批实例Id", "property": "processInstanceId", "required": true, "type": "string" }, "remark": { "description": "撤销说明 (可选)", "interface_description": "撤销审批的说明", "property": "remark", "required": false, "type": "string" } }, "path": "oa.revoke_processInstance", "primary_cli_path": "oa approval revoke", "product_id": "oa", "risk": "high", "source": "runtime:oa", "title": "revoke_processInstance", "use_when": [ "5. 撤销自己发起的审批", "撤回审批/取消审批", "撤销审批/撤回" ] }, "pat.batch_grant": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.pat.batch_grant", "skills/mono/references/products/pat.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "按可信上下文为当前用户执行 PAT 批量授权，支持 dryRun 和 pending flow。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“按可信上下文为当前用户执行 PAT 批量授权，支持 dryRun 和 pending flow。”所述变更时不要使用" ], "canonical_path": "pat.batch_grant", "cli_name": "chmod", "cli_path": "pat chmod", "confirmation": "user_required", "constraints": { "require_one_of": [ [ "scope", "product", "products", "domain", "domains", "recommend" ] ] }, "description": "按可信上下文为当前用户执行 PAT 批量授权，支持 dryRun 和 pending flow。", "display": "行为授权管理", "effect": "write", "effect_source": "skill-comment", "examples": [ "dws pat chmod --products calendar,aitable --grant-type session --session-id \u003cSESSION_ID\u003e --dry-run --format json" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "pat", "rpc_name": "pat.batch_grant" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "batch_grant", "parameter_count": 8, "parameters": { "agentCode": { "description": "Agent 唯一标识（可选；也可通过 env DINGTALK_DWS_AGENTCODE 注入，flag 优先；未传则由服务端默认兜底）", "property": "agentCode", "required": false, "type": "string" }, "domain": { "description": "产品域/产品编码，可重复；按产品 scope 模板批量授权；执行授权需 --yes", "property": "domain", "required": false, "type": "array" }, "domains": { "description": "产品域/产品编码列表，逗号分隔；执行批量授权需 --yes", "property": "domains", "required": false, "type": "array" }, "grant-type": { "default": "permanent", "description": "授权策略: once|session|permanent", "enum": [ "once", "session", "permanent" ], "property": "grantType", "required": false, "type": "string" }, "product": { "description": "产品编码，可重复；与 --products 等价；执行批量授权需 --yes", "property": "product", "required": false, "type": "array" }, "products": { "description": "产品编码列表，逗号分隔；执行批量授权需 --yes", "property": "products", "required": false, "type": "array" }, "recommend": { "description": "使用推荐 scope 集合批量授权；执行授权需 --yes", "property": "recommend", "required": false, "type": "boolean" }, "session-id": { "description": "会话标识（session 模式下必填）", "property": "sessionId", "required": false, "required_when": "grant-type is session", "type": "string" } }, "path": "pat.batch_grant", "positionals": [ { "description": "权限 scope，格式为 \u003cproduct\u003e.\u003centity\u003e:\u003cpermission\u003e；可重复", "index": 0, "name": "scope", "required": false, "type": "array", "variadic": true } ], "primary_cli_path": "pat chmod", "product_id": "pat", "reviewed": false, "risk": "high", "source": "hardcoded:pat", "title": "批量授权", "use_when": [ "执行批量行为授权（高影响，必须先让用户确认）", "授予 Agent 行为权限/授权 scope/批量授权产品/一次性授权/会话授权/永久授权", "预览按产品展开的批量授权计划，不写入授权" ] }, "pat.browser_policy": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/pat.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "配置 PAT 授权时是否打开浏览器", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“配置 PAT 授权时是否打开浏览器”所述变更时不要使用" ], "canonical_path": "pat.browser_policy", "cli_name": "browser-policy", "cli_path": "pat browser-policy", "confirmation": "not_required", "description": "配置 PAT 授权时是否打开浏览器", "display": "行为授权管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws pat browser-policy --enabled --format json", "dws pat browser-policy --enabled=false --agentCode \u003cAGENT_CODE\u003e --format json" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "命令仅操作本地进程或策略文件，不调用 MCP 接口", "is_alias": false, "name": "browser_policy", "parameter_count": 2, "parameters": { "agentCode": { "description": "Agent 唯一标识（可选；不填则写入全局默认策略，不从 env DINGTALK_DWS_AGENTCODE 回退）", "property": "agentCode", "required": false, "type": "string" }, "enabled": { "description": "PAT 撞墙时是否允许本地打开浏览器", "enum": [ "true", "false" ], "property": "enabled", "required": true, "type": "boolean" } }, "path": "pat.browser_policy", "primary_cli_path": "pat browser-policy", "product_id": "pat", "reviewed": true, "risk": "medium", "source": "hardcoded:pat", "title": "配置 PAT 授权时是否打开浏览器", "use_when": [ "PAT 授权时允许或禁止打开浏览器/配置浏览器授权策略", "允许 PAT 授权流程打开本地浏览器", "禁止指定 Agent 的 PAT 授权流程打开本地浏览器", "配置 PAT 授权时是否打开浏览器" ] }, "report.create_report": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.report.prod.json#report.create_report", "skills/mono/references/products/report.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "提交一份新日报（按模版）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "report create" ], "availability": "available", "avoid_when": [ "要“读取单份日报正文（含字段明细 + 钉钉跳转链接）”请改用 dws report entry get", "要“读取单份日报的已读统计”请改用 dws report entry stats" ], "canonical_path": "report.create_report", "cli_name": "submit", "cli_path": "report entry submit", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "contents", "contents-file" ] ] }, "description": "创建日志", "display": "钉钉日志（OA 周报应用 / 日志模版填报）", "effect": "write", "effect_source": "command-verb", "examples": [ "dws report entry submit --template-id \u003ctemplateId\u003e --contents-file ./report.json --format json", "dws report entry submit --template-id \u003ctemplateId\u003e --contents '[{\"key\":\"今日完成\",\"sort\":\"0\",\"content\":\"完成了需求评审\",\"contentType\":\"markdown\",\"type\":\"1\"}]' --format json" ], "group": "entry", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "create_report" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_report", "parameter_count": 6, "parameters": { "contents": { "description": "日志内容 JSON 数组 (必填，或用 --contents-file)，每项含 key/sort/content/contentType/type；传 - 表示从 stdin 读取", "example": "[{\"content\":\"schema smoke\",\"sort\":\"0\",\"key\":\"work\",\"contentType\":\"markdown\",\"type\":\"1\"}]", "format": "json", "interface_description": "日志内容列表", "interface_type": "array", "property": "contents", "required": false, "type": "string" }, "contents-file": { "description": "从文件读取 contents JSON（推荐用于含中文/换行/Markdown 的长内容，避免 shell 引号转义；优先级：--contents-file \u003e --contents - (stdin) \u003e --contents '\u003cjson\u003e'）", "property": "contentsFile", "required": false, "type": "string" }, "dd-from": { "default": "dws", "description": "创建来源标识", "interface_description": "创建日志的来源，自定义值", "property": "ddFrom", "required": false, "type": "string" }, "template-id": { "description": "日志模版 ID (必填)", "interface_description": "需要发送哪个日志模板的日志，可通过获取可见日志模板服务获取", "property": "templateId", "required": true, "type": "string" }, "to-chat": { "description": "是否发送到日志接收人单聊", "interface_description": "是否发送到日志接收人的单聊", "property": "toChat", "required": false, "type": "boolean" }, "to-user-ids": { "description": "接收人 userId，逗号分隔 (可选)", "interface_description": "该日志发送到的人员userId列表", "interface_type": "array", "property": "toUserIds", "required": false, "type": "string" } }, "path": "report.create_report", "primary_cli_path": "report entry submit", "product_id": "report", "risk": "medium", "source": "runtime:report", "title": "create_report", "use_when": [ "2b. 提交日志（从步骤 1/2 取 templateId 与 contents 字段）— 推荐 --contents-file 传入避免 shell 引号", "内联（短内容）", "推荐：长内容走文件，避免 shell 引号问题" ] }, "report.get_available_report_templates": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.report.prod.json#report.get_available_report_templates", "skills/mono/references/products/report.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取当前用户可用的日志模版列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“读取单个日志模版的字段定义”请改用 dws report template get" ], "canonical_path": "report.get_available_report_templates", "cli_name": "list", "cli_path": "report template list", "confirmation": "not_required", "description": "获取当前员工可使用的日志模版信息，包含日志模板的名称、模板Id等", "display": "钉钉日志（OA 周报应用 / 日志模版填报）", "effect": "read", "effect_source": "command-verb", "examples": [ "dws report template list", "dws report template list --format json" ], "group": "template", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "get_available_report_templates" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_available_report_templates", "parameter_count": 0, "parameters": {}, "path": "report.get_available_report_templates", "primary_cli_path": "report template list", "product_id": "report", "risk": "low", "source": "hardcoded:report", "title": "get_available_report_templates", "use_when": [ "1. 获取当前用户可用的日志模版", "写日报/提交周报/发日志/填日志", "有什么日志模版" ] }, "report.get_received_report_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.report.prod.json#report.get_received_report_list", "skills/mono/references/products/report.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "列出我收到的日报", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "report list" ], "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出我收到的日报”" ], "canonical_path": "report.get_received_report_list", "cli_name": "list", "cli_path": "report inbox list", "confirmation": "not_required", "description": "查询当前人收到的日志列表", "display": "钉钉日志（OA 周报应用 / 日志模版填报）", "effect": "read", "effect_source": "command-verb", "examples": [ "dws report inbox list --start-date 2026-05-04 --end-date 2026-05-11 --format json", "dws report inbox list --date 2026-05-11 --format json" ], "group": "inbox", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "get_received_report_list" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_received_report_list", "parameter_count": 5, "parameters": { "cursor": { "description": "分页游标（默认 0，翻页传返回的 cursor）", "interface_description": "起始游标，从 0 开始，示例值：1734048000000，必填", "interface_type": "number", "property": "cursor", "required": false, "type": "integer" }, "end": { "description": "结束时间 ISO-8601 (如 2026-03-10T23:59:59+08:00) (必填)", "format": "date-time", "interface_description": "结束时间，毫秒时间戳，示例值：1734048000000，必填，与开始时间的间隔不能超过180天", "interface_type": "number", "property": "endTime", "required": true, "type": "string" }, "sender-user-ids": { "description": "发送人 staffId 列表，逗号分隔，用于过滤指定发送人的日志", "interface_description": "发送人的staffId", "property": "senderUserIds", "required": false, "type": "array" }, "size": { "default": "20", "description": "每页条数（默认 20，最大 20）", "interface_description": "每页条数，最大 20，示例值：1734048000000，必填", "interface_type": "number", "property": "size", "required": false, "type": "integer" }, "start": { "description": "开始时间 ISO-8601 (如 2026-03-10T00:00:00+08:00) (必填)", "format": "date-time", "interface_description": "开始时间，毫秒时间戳，示例值：1734048000000，必填，与结束时间的间隔不能超过180天", "interface_type": "number", "property": "startTime", "required": true, "type": "string" } }, "path": "report.get_received_report_list", "primary_cli_path": "report inbox list", "product_id": "report", "risk": "low", "source": "runtime:report", "title": "查询当前人收到的日志列表", "use_when": [ "3. 查看收到的日报列表 — 提取 reportId", "别人发给我的日志/我收到的日志", "我收到的日志", "查日志/看日报/看正文" ] }, "report.get_report_entry_details": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.report.prod.json#report.get_report_entry_details", "skills/mono/references/products/report.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "读取单份日报正文（含字段明细 + 钉钉跳转链接）", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "report detail" ], "availability": "available", "avoid_when": [ "要“提交一份新日报（按模版）”请改用 dws report entry submit", "要“读取单份日报的已读统计”请改用 dws report entry stats" ], "canonical_path": "report.get_report_entry_details", "cli_name": "get", "cli_path": "report entry get", "confirmation": "not_required", "description": "获取指定一篇日志的详情信息", "display": "钉钉日志（OA 周报应用 / 日志模版填报）", "effect": "read", "effect_source": "command-verb", "examples": [ "dws report entry get --report-id \u003creportId\u003e --format json", "dws report entry get --report-id \u003creportId\u003e" ], "group": "entry", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "get_report_entry_details" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_report_entry_details", "parameter_count": 1, "parameters": { "report-id": { "description": "日志 ID (必填)", "interface_description": "日志Id，可以从查询当前用户收到的日志列表获取", "property": "report_id", "required": true, "type": "string" } }, "path": "report.get_report_entry_details", "primary_cli_path": "report entry get", "product_id": "report", "risk": "low", "source": "runtime:report", "title": "get_report_entry_details", "use_when": [ "2c. 仅当 submit 返回中缺少 dingtalkOpenUrl 时，手动补取 dingtalk:// 跳转链接", "4. 查看日报详情（正文/字段明细）", "从列表结果提取 reportId 后，再查正文", "先通过 report inbox list / outbox list / entry submit 取得 reportId，再查正文与跳转链接", "已知 reportId", "我发过 / 我创建的日志", "我收到的日志" ] }, "report.get_report_statistics_by_id": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.report.prod.json#report.get_report_statistics_by_id", "skills/mono/references/products/report.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "读取单份日报的已读统计", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "report stats" ], "availability": "available", "avoid_when": [ "要“提交一份新日报（按模版）”请改用 dws report entry submit", "要“读取单份日报正文（含字段明细 + 钉钉跳转链接）”请改用 dws report entry get" ], "canonical_path": "report.get_report_statistics_by_id", "cli_name": "stats", "cli_path": "report entry stats", "confirmation": "not_required", "description": "获取日志统计数据，包括评论数量、点赞数量、已读数等", "display": "钉钉日志（OA 周报应用 / 日志模版填报）", "effect": "read", "effect_source": "command-verb", "examples": [ "dws report entry stats --report-id \u003creportId\u003e", "dws report entry stats --report-id \u003creportId\u003e --format json" ], "group": "entry", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "get_report_statistics_by_id" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_report_statistics_by_id", "parameter_count": 1, "parameters": { "report-id": { "description": "日志 ID (必填)", "interface_description": "日志Id", "property": "report_id", "required": true, "type": "string" } }, "path": "report.get_report_statistics_by_id", "primary_cli_path": "report entry stats", "product_id": "report", "risk": "low", "source": "runtime:report", "title": "获取指定日志的统计数据", "use_when": [ "5. 查看日报已读统计", "日志统计/已读统计" ] }, "report.get_send_report_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.report.prod.json#report.get_send_report_list", "skills/mono/references/products/report.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "列出我发出的日报", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "report created", "report sent" ], "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出我发出的日报”" ], "canonical_path": "report.get_send_report_list", "cli_name": "list", "cli_path": "report outbox list", "confirmation": "not_required", "description": "查询当前人创建的日志详情列表，包含日志的内容、日志名称、创建时间、访问地址等信息", "display": "钉钉日志（OA 周报应用 / 日志模版填报）", "effect": "read", "effect_source": "command-verb", "examples": [ "dws report outbox list --cursor 0 --size 20 --format json", "dws report outbox list --cursor 0 --size 20" ], "group": "outbox", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "get_send_report_list" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_send_report_list", "parameter_count": 7, "parameters": { "cursor": { "description": "分页游标，首次传 0 (默认 0)", "interface_description": "分页游标，首次传0", "interface_type": "number", "property": "cursor", "required": false, "type": "integer" }, "end": { "description": "创建结束时间 ISO-8601 (默认最近 20 天；服务端单次查询跨度上限 20 天)", "format": "date-time", "interface_description": "日志创建的结束时间，毫秒级时间戳格式，示例：1734048000000；注意：开始时间和结束时间跨度不能超过180天", "interface_type": "number", "property": "endTime", "required": false, "type": "string" }, "modified-end": { "description": "修改结束时间 ISO-8601 (可选)", "format": "date-time", "interface_description": "日志修改的结束时间，毫秒级时间戳格式，示例：1734048000000", "interface_type": "number", "property": "modifiedEndTime", "required": false, "type": "string" }, "modified-start": { "description": "修改开始时间 ISO-8601 (可选)", "format": "date-time", "interface_description": "日志修改的开始时间，毫秒级时间戳格式，示例：1734048000000", "interface_type": "number", "property": "modifiedStartTime", "required": false, "type": "string" }, "size": { "default": "20", "description": "每页条数，最大 20 (默认 20)", "interface_description": "分页大小，最大20", "interface_type": "number", "property": "size", "required": false, "type": "integer" }, "start": { "description": "创建开始时间 ISO-8601 (默认最近 20 天；服务端单次查询跨度上限 20 天)", "format": "date-time", "interface_description": "日志创建的开始时间，毫秒级时间戳格式，示例：1734048000000；注意：开始时间和结束时间跨度不能超过180天", "interface_type": "number", "property": "startTime", "required": false, "type": "string" }, "template-name": { "description": "日志模板名称 (可选，不传查全部)", "interface_description": "日志模板名称，可不传，查询的是全部日志", "property": "report_template_name", "required": false, "type": "string" } }, "path": "report.get_send_report_list", "primary_cli_path": "report outbox list", "product_id": "report", "risk": "low", "source": "runtime:report", "title": "get_send_report_list", "use_when": [ "6. 查看我发出的日报列表", "我发过 / 我创建的日志", "我发过的日志/我创建的日志" ] }, "report.get_template_details_by_name": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.report.prod.json#report.get_template_details_by_name", "skills/mono/references/products/report.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "读取单个日志模版的字段定义", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "aliases": [ "report template detail" ], "availability": "available", "avoid_when": [ "要“获取当前用户可用的日志模版列表”请改用 dws report template list" ], "canonical_path": "report.get_template_details_by_name", "cli_name": "get", "cli_path": "report template get", "confirmation": "not_required", "description": "获取当前员工可使用的日志模版详情信息，包括日志模板Id、日志模板内字段的名称、字段类型、字段排序等", "display": "钉钉日志（OA 周报应用 / 日志模版填报）", "effect": "read", "effect_source": "command-verb", "examples": [ "dws report template get --name \u003ctemplateName\u003e", "dws report template get --name \"日报\" --format json" ], "group": "template", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "report", "rpc_name": "get_template_details_by_name" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_template_details_by_name", "parameter_count": 1, "parameters": { "name": { "description": "模版名称 (必填)", "interface_description": "日志模板名称", "property": "report_template_name", "required": true, "type": "string" } }, "path": "report.get_template_details_by_name", "primary_cli_path": "report template get", "product_id": "report", "risk": "low", "source": "runtime:report", "title": "get_template_details_by_name", "use_when": [ "2. 按名称读取模版字段定义" ] }, "sheet.add_dimension": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.add_dimension", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-dimension-operations.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "在钉钉表格的指定工作表末尾追加空行或空列。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉表格的指定工作表末尾追加空行或空列。”所述变更时不要使用" ], "canonical_path": "sheet.add_dimension", "cli_name": "add-dimension", "cli_path": "sheet add-dimension", "confirmation": "not_required", "description": "在钉钉表格的指定工作表末尾追加空行或空列。\r\n\r\n参数说明：\r\n- dimension：维度类型，ROWS 表示追加行，COLUMNS 表示追加列\r\n- length：追加数量，必须为正整数", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet add-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --dimension ROWS --length 5", "dws sheet add-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --dimension COLUMNS --length 3" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "add_dimension" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_dimension", "parameter_count": 4, "parameters": { "dimension": { "description": "维度类型: ROWS 或 COLUMNS (必填)", "enum": [ "ROWS", "COLUMNS" ], "interface_description": "追加维度（必填）。ROWS 表示追加行，COLUMNS 表示追加列。", "property": "dimension", "required": true, "type": "string" }, "length": { "description": "追加数量，正整数 (必填)", "interface_description": "要追加的行/列数量（必填），必须为正整数（\u003e= 1）。", "interface_type": "number", "property": "length", "required": true, "type": "integer" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.add_dimension", "primary_cli_path": "sheet add-dimension", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "追加行列", "use_when": [ "追加空行/追加空列/增加行数/增加列数/扩展表格/在末尾加空行；追加空行/空列" ] }, "sheet.append_rows": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.append_rows", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-dimension-operations.md", "skills/mono/references/products/sheet/sheet-write-data.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "在钉钉电子表格的指定工作表末尾追加若干行数据。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉电子表格的指定工作表末尾追加若干行数据。”所述变更时不要使用" ], "canonical_path": "sheet.append_rows", "cli_name": "append", "cli_path": "sheet append", "confirmation": "not_required", "description": "在钉钉电子表格的指定工作表末尾追加若干行数据。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 values 传入要追加的数据。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n系统会自动定位到工作表中最后一行有数据的位置，在其下方插入新行数据。\r\n如果工作表为空，数据将从第一行开始写入。\r\n\r\nvalues 为二维数组，外层数组的每个元素代表一行，内层数组的每个元素代表该行中的一个单元格值。\r\n追加的数据列数应与工作表已有数据的列数保持一致，以确保数据对齐。\r\n\r\n返回追加数据所在的单元格范围（A1 表示法）。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可追加。不支持跨组织操作。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet append --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --values '[[\"张三\",\"销售部\",50000]]'", "dws sheet append --node \u003cNODE_ID\u003e --sheet-id \"Sheet1\" --values '[[\"李四\",\"市场部\",38000],[\"王五\",\"销售部\",62000]]'" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "append_rows" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "append_rows", "parameter_count": 3, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的标识，支持两种格式：1) 工作表 ID（sheetId）；2) 工作表名称。可通过 get_all_sheets 获取。", "property": "sheetId", "required": true, "type": "string" }, "values": { "description": "追加数据，二维 JSON 数组 (必填)", "interface_description": "二维数组，外层数组的每个元素代表一行，内层数组的每个元素代表该行中的一个单元格值。追加的数据列数应与工作表已有数据的列数保持一致。", "interface_type": "array", "property": "values", "required": true, "type": "string" } }, "path": "sheet.append_rows", "primary_cli_path": "sheet append", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "追加行", "use_when": [ "3. 追加单行数据", "4. 追加多行数据", "插入行/插入列/在某行前插入/在某列前插入；在末尾追加", "追加数据/添加行/在末尾加数据/新增记录；追加数据" ] }, "sheet.batch_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-batch-operations.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "将多个写操作打包为一次原子请求执行", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要将多个写操作打包为一次原子请求执行时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.batch_update", "cli_name": "batch-update", "cli_path": "sheet batch-update", "confirmation": "not_required", "description": "将多个写操作打包为一次原子请求执行。\n\n默认严格事务模式：任一子操作失败则整批回滚。\n传 --continue-on-error 切换为宽松模式（遇失败继续执行）。\n\ntoolName 使用 CLI 命令名（与原子命令一致），input 的键用 CLI flag 名去掉 --。\nCLI 层自动翻译为 MCP toolName + 参数名，无需记忆 MCP 参数名。\n\n支持的 CLI 命令名:\n range clear / range update / merge-cells / unmerge-cells / update-dimension\n range fill / range copy-to / add-dimension / delete-dimension / move-dimension\n group-dimension / ungroup-dimension\n set-dropdown / delete-dropdown / csv-put / delete-float-image\n\n注意：batch-update 中 group-dimension 适合默认展开分组；需要 --group-state fold 时请使用独立\ndws sheet group-dimension 命令。\n\n--operations 是 JSON 数组，每项包含:\n toolName CLI 命令名（如 \"range clear\", \"range update\"）\n input 该命令的入参（不含 --node），键用 flag 名去掉 --\n\n完整映射表见:\n dingtalk-workspace/references/products/sheet/sheet-batch-operations.md", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet batch-update --node \u003cNODE_ID\u003e --operations '[", "dws sheet batch-update --node \u003cNODE_ID\u003e --continue-on-error --operations '[...]'" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "batch_update", "parameter_count": 3, "parameters": { "continue-on-error": { "description": "遇失败继续执行后续操作（默认 false，严格事务）", "property": "continueOnError", "required": false, "type": "boolean" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "operations": { "description": "操作数组 JSON (必填，每项 {toolName, input})", "property": "operations", "required": true, "type": "string" } }, "path": "sheet.batch_update", "primary_cli_path": "sheet batch-update", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "批量执行多个写操作（原子事务）", "use_when": [ "批量操作/一次执行多个写操作/原子批量/先清除再写入；多个写操作打包" ] }, "sheet.chart_create": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-chart.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "在钉钉电子表格的指定工作表中创建一个浮动图表", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要在钉钉电子表格的指定工作表中创建一个浮动图表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.chart_create", "cli_name": "create", "cli_path": "sheet chart create", "confirmation": "not_required", "description": "在钉钉电子表格的指定工作表中创建一个浮动图表。\n\n--properties 为 JSON 格式，包含 position（锚点位置）、dimensions（尺寸）、chart（图表配置）三个必填字段，\n以及可选的 offset（偏移量）。支持 stdin heredoc 和 @file 两种传入方式。\n\nchart.type 支持: column（柱形图）、bar（条形图）、columnStacked（堆积柱形图）、barStacked（堆积条形图）、\nline（折线图）、lineStacked（堆积折线图）、area（面积图）、areaStacked（堆积面积图）、\nareaPercentStacked（百分比堆积面积图）、pie（饼图）、doughnut（环形图）、scatter（散点图）、\nradar（雷达图）。\nchart.series[].value / chart.series[].name / chart.category 使用 A1 区域表示法（如 \"A2:B10\"），\n不指定 sheet 前缀时默认使用 --sheet-id 的值。\nposition.col 使用列字母表示法（如 \"A\"、\"AA\"），不支持数字形式。\n\n创建成功后返回新图表的完整信息，包含系统分配的 chart-id。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet chart create --node NODE_ID --sheet-id SHEET_ID --properties '{", "dws sheet chart create --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --properties '{" ], "group": "chart", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "chart_create", "parameter_count": 3, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "properties": { "description": "图表完整配置 JSON (必填，含 position/dimensions/chart)", "property": "properties", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID (必填)", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.chart_create", "primary_cli_path": "sheet chart create", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "创建浮动图表", "use_when": [ "3. 创建柱形图", "创建折线图", "创建柱形图" ] }, "sheet.chart_delete": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-chart.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "删除钉钉电子表格中指定的浮动图表", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要删除钉钉电子表格中指定的浮动图表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.chart_delete", "cli_name": "delete", "cli_path": "sheet chart delete", "confirmation": "not_required", "description": "删除钉钉电子表格中指定的浮动图表。\n\n注意: 这是一个危险操作，删除后图表不可恢复。执行前需要确认，或传入 --yes 跳过确认。\nchart-id 可通过 chart list 获取。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet chart delete --node NODE_ID --sheet-id SHEET_ID --chart-id CHART_ID" ], "group": "chart", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "chart_delete", "parameter_count": 3, "parameters": { "chart-id": { "description": "浮动图表 ID (必填，可通过 chart list 获取)", "property": "chartId", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.chart_delete", "primary_cli_path": "sheet chart delete", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "删除浮动图表", "use_when": [ "删除钉钉电子表格中指定的浮动图表" ] }, "sheet.chart_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-chart.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "获取钉钉电子表格指定工作表中的浮动图表", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要获取钉钉电子表格指定工作表中的浮动图表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.chart_list", "cli_name": "list", "cli_path": "sheet chart list", "confirmation": "not_required", "description": "获取钉钉电子表格指定工作表中的浮动图表。\n\n支持两种模式：\n1. 列出全部图表：不传 --chart-id，返回该工作表中所有浮动图表的列表。\n2. 获取单个图表：传入 --chart-id，返回该图表的详细信息。\n\n返回内容包含每个图表的 ID、锚点位置、尺寸坐标以及完整图表配置（类型、数据系列、分类轴、标题、图例、坐标轴等）。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet chart list --node NODE_ID --sheet-id SHEET_ID", "dws sheet chart list --node NODE_ID --sheet-id SHEET_ID --chart-id CHART_ID" ], "group": "chart", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "chart_list", "parameter_count": 3, "parameters": { "chart-id": { "description": "浮动图表 ID (可选，不传则返回全部)", "property": "chartId", "required": false, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.chart_list", "primary_cli_path": "sheet chart list", "product_id": "sheet", "reviewed": false, "risk": "low", "source": "hardcoded:sheet", "title": "获取浮动图表", "use_when": [ "1. 获取现有配置", "4. 验证创建结果", "列出所有浮动图表", "获取单个图表详情" ] }, "sheet.chart_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-chart.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "更新钉钉电子表格中指定浮动图表的配置", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要更新钉钉电子表格中指定浮动图表的配置时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.chart_update", "cli_name": "update", "cli_path": "sheet chart update", "confirmation": "not_required", "description": "更新钉钉电子表格中指定浮动图表的配置。\n\n注意：本接口采用 PUT 语义（完整覆盖），非增量更新。\n建议先通过 chart list（传入 --chart-id）获取当前配置，修改后整体传入。\n如果只需修改部分字段（如仅修改标题），仍需传入完整的 chart 配置以避免其他字段被清空。\n\n--properties 结构与 chart create 完全相同。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet chart update --node NODE_ID --sheet-id SHEET_ID --chart-id CHART_ID --properties '{", "dws sheet chart update --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --chart-id \u003cCHART_ID\u003e --properties '\u003c完整修改后的 JSON\u003e'" ], "group": "chart", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "chart_update", "parameter_count": 4, "parameters": { "chart-id": { "description": "浮动图表 ID (必填，可通过 chart list 获取)", "property": "chartId", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "properties": { "description": "图表完整配置 JSON (必填，PUT 语义整体覆盖)", "property": "properties", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID (必填)", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.chart_update", "primary_cli_path": "sheet chart update", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "更新浮动图表", "use_when": [ "3. 整体回写" ] }, "sheet.clear_range": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.clear_range", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-dimension-operations.md", "skills/mono/references/products/sheet/sheet-range-operations.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "清除钉钉电子表格中指定工作表指定范围的单元格内容、格式或全部。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“基于源数据范围自动填充到目标范围”请改用 dws sheet range fill", "要“对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值”请改用 dws sheet range batch-set-style", "要“将源范围的数据复制到目标位置”请改用 dws sheet range copy-to" ], "canonical_path": "sheet.clear_range", "cli_name": "clear", "cli_path": "sheet range clear", "confirmation": "not_required", "description": "清除钉钉电子表格中指定工作表指定范围的单元格内容、格式或全部。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet range clear --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:B3\"" ], "group": "range", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "clear_range" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "clear_range", "parameter_count": 4, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "清除范围，A1 表示法 (必填，如 A1:B3)", "format": "a1-range", "interface_description": "要清除的单元格范围（必填），使用 A1 表示法。例如：\"A1:B3\" 表示从 A1 到 B3 的矩形区域，\"A1\" 表示单个单元格，\"A:C\" 表示整列范围。", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" }, "type": { "description": "清除类型: content(仅值,默认) / format(仅格式) / all(全部)", "interface_description": "清除类型（可选，默认 content）。content: 仅清除单元格的值（保留格式）；format: 仅清除格式（保留值）；all: 清除值和格式。", "property": "type", "required": false, "type": "string" } }, "path": "sheet.clear_range", "primary_cli_path": "sheet range clear", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "清除区域", "use_when": [ "删除行/删除列/删掉第几行/删掉某列/移除行/移除列；仅清空内容但保留行/列", "清空/清除区域/擦除内容/清除格式；仅清除值", "清空/清除区域/擦除内容/清除格式；仅清除格式", "清空/清除区域/擦除内容/清除格式；全部清除", "清空/清除区域/擦除内容/清除格式；清除区域", "清空整片区域请改用 range clear" ] }, "sheet.copy_sheet": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.copy_sheet", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-workbook.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "复制钉钉电子表格中的指定工作表，在同一表格中创建一个副本，可同时指定副本的目标位置。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“复制钉钉电子表格中的指定工作表，在同一表格中创建一个副本，可同时指定副本的目标位置。”所述变更时不要使用" ], "canonical_path": "sheet.copy_sheet", "cli_name": "copy", "cli_path": "sheet copy", "confirmation": "not_required", "description": "复制钉钉电子表格中的指定工作表，在同一表格中创建一个副本，可同时指定副本的目标位置。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet copy --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e", "dws sheet copy --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --title \"销售副本\" --index 2" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "copy_sheet" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "copy_sheet", "parameter_count": 5, "parameters": { "index": { "description": "副本位置索引，0-based (不传则放在源工作表之后)", "interface_description": "副本工作表的位置索引（可选，0-based）。不传时放在源工作表之后。", "interface_type": "number", "property": "index", "required": false, "type": "integer" }, "name": { "description": "副本名称，最长 100 字符 (不传则系统自动生成)", "property": "name", "required": false, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "源工作表 ID 或名称 (必填)", "interface_description": "要复制的源工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" }, "title": { "description": "--name 的别名（兼容）", "interface_description": "副本名称", "property": "title", "required": false, "type": "string" } }, "path": "sheet.copy_sheet", "primary_cli_path": "sheet copy", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "复制工作表", "use_when": [ "只指定名称", "复制工作表/拷贝工作表/克隆工作表/工作表副本；复制工作表", "复制工作表/拷贝工作表/克隆工作表/工作表副本；复制并指定位置", "复制工作表/拷贝工作表/克隆工作表/工作表副本；复制并指定名称", "指定副本名称和位置", "按默认位置复制" ] }, "sheet.create_cond_format": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-conditional-format.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "创建条件格式规则", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "只设置静态样式用 sheet range set-style", "更新已有条件格式用 sheet cond-format update", "查看条件格式列表用 sheet cond-format list" ], "canonical_path": "sheet.create_cond_format", "cli_name": "create", "cli_path": "sheet cond-format create", "confirmation": "not_required", "description": "在指定工作表中创建一条条件格式规则。\r\n条件格式规则定义了当单元格满足特定条件时自动应用的样式。\r\n每条规则需要指定：应用范围（ranges）、条件类型及参数、命中时的单元格样式（cellStyle）。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet cond-format create --node NODE_ID --sheet-id SHEET_ID --ranges '[\"A2:H100\"]' --condition '{\"formulaCondition\":{\"formula\":\"=$H2=\\\"是\\\"\"}}' --cell-style '{\"backgroundColor\":\"#FFECEC\"}'", "dws sheet cond-format create --node NODE_ID --sheet-id SHEET_ID --ranges '[\"A2:H100\"]' --condition '{\"formulaCondition\":{\"formula\":\"=$A2\u003e$B2\"}}' --cell-style '{\"backgroundColor\":\"#FFECEC\"}'" ], "group": "cond-format", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "create_cond_format" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_cond_format", "parameter_count": 6, "parameters": { "cell-style": { "description": "单元格样式 JSON 对象 (可选)，如 '{\"backgroundColor\":\"#FF0000\",\"bold\":true}'", "example": "{\"backgroundColor\":\"#FFCDD2\",\"bold\":true}", "format": "json", "interface_description": "条件命中时应用的单元格样式。对 numberCondition、textCondition、emptyCondition、errorCondition、duplicateCondition、formulaCondition、rankCondition、averageCondition、stdevCondition 类型有效。", "interface_type": "object", "property": "cellStyle", "required": false, "type": "string" }, "condition": { "description": "条件类型及参数 JSON 对象 (必填)，如 '{\"numberCondition\":{\"operator\":\"greater\",\"value1\":\"80\"}}'", "example": "{\"numberCondition\":{\"operator\":\"greater\",\"value1\":\"80\"}}", "format": "json", "property": "condition", "required": true, "type": "string" }, "data-bar-style": { "description": "数据条样式 JSON 对象 (可选，仅数据条类型)，如 '{\"fill\":[\"#4CAF50\",\"#F44336\"],\"isGradient\":true}'", "format": "json", "interface_description": "数据条的显示样式配置。仅 dataBarCondition 类型时有效。", "interface_type": "object", "property": "dataBarStyle", "required": false, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "ranges": { "description": "应用范围 JSON 数组 (必填)，如 '[\"A1:E10\"]'", "example": "[\"A1:B2\"]", "format": "json", "interface_description": "条件格式规则的应用范围（必填），A1 表示法的数组。示例：[\"A1:E10\"]", "interface_type": "array", "property": "ranges", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.create_cond_format", "primary_cli_path": "sheet cond-format create", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "创建条件格式规则", "use_when": [ "按条件高亮或设置格式规则" ] }, "sheet.create_filter": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "为工作表创建基础筛选", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "只查看筛选信息用 sheet filter get", "更新筛选条件用 sheet filter update 或 clear-criteria", "管理筛选视图用 sheet filter-view create/update/list" ], "canonical_path": "sheet.create_filter", "cli_name": "create", "cli_path": "sheet filter create", "confirmation": "not_required", "description": "在钉钉电子表格的指定工作表中创建筛选。\r\n创建筛选后，工作表的指定范围将出现筛选下拉箭头，用户可通过 set_filter_criteria 设置具体的筛选条件。\r\n每个工作表只能有一个筛选，如果已存在筛选则会报错。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet filter create --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:E100\"", "dws sheet filter create --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:E100\" --criteria '[{\"column\":1,\"filterType\":\"values\",\"visibleValues\":[\"北京\",\"上海\"]}]'" ], "group": "filter", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "create_filter" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_filter", "parameter_count": 4, "parameters": { "criteria": { "description": "筛选条件 JSON 数组 (可选)", "interface_description": "各列的筛选条件（可选）。数组格式，每个元素包含 column（列偏移量，0-based）和筛选条件字段。示例：[{\"column\":0,\"filterType\":\"values\",\"visibleValues\":[\"A\",\"B\"]}]", "interface_type": "array", "property": "criteria", "required": false, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "筛选范围，A1 表示法，须包含表头行 (必填)", "format": "a1-range", "interface_description": "筛选的单元格范围（必填），使用 A1 表示法，如 A1:E10。", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.create_filter", "primary_cli_path": "sheet filter create", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "创建筛选", "use_when": [ "需要在普通筛选范围上开启筛选" ] }, "sheet.create_filter_view": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter-view.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "创建筛选视图", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "创建普通筛选用 sheet filter create", "更新已有筛选视图用 sheet filter-view update", "查看筛选视图列表用 sheet filter-view list" ], "canonical_path": "sheet.create_filter_view", "cli_name": "create", "cli_path": "sheet filter-view create", "confirmation": "not_required", "description": "在钉钉电子表格的指定工作表中创建一个筛选视图。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n筛选视图是独立于全局筛选的个人化数据过滤方式。创建后可通过 set_filter_view_criteria 设置具体的筛选条件。\r\n同一工作表可以创建多个筛选视图。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可创建。不支持跨组织操作。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet filter-view create --help", "dws sheet filter-view create --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --name \"我的视图\" --range \"A1:E10\"" ], "group": "filter-view", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "create_filter_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_filter_view", "parameter_count": 5, "parameters": { "criteria": { "description": "筛选条件，JSON 数组 (可选)", "interface_description": "各列的筛选条件（可选）。数组格式，每个元素包含 column（列偏移量，0-based）和筛选条件字段。示例：[{\"column\":0,\"filterType\":\"values\",\"visibleValues\":[\"A\",\"B\"]}]", "interface_type": "array", "property": "criteria", "required": false, "type": "string" }, "name": { "description": "筛选视图名称 (必填)", "interface_description": "筛选视图的名称（必填）。", "property": "name", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "筛选视图范围，A1 表示法，如 A1:E10 (必填)", "format": "a1-range", "interface_description": "筛选视图的单元格范围（必填），使用 A1 表示法，如 A1:E10。", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.create_filter_view", "primary_cli_path": "sheet filter-view create", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "创建筛选视图", "use_when": [ "需要创建可保存的筛选视图" ] }, "sheet.create_float_image": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.create_float_image", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-media-image.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "在钉钉电子表格的指定工作表中插入一张浮动图片。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉电子表格的指定工作表中插入一张浮动图片。”所述变更时不要使用" ], "canonical_path": "sheet.create_float_image", "cli_name": "create-float-image", "cli_path": "sheet create-float-image", "confirmation": "not_required", "description": "在钉钉电子表格的指定工作表中插入一张浮动图片。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet create-float-image --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --src \"/core/api/resources/img/xxxx...\" --range A1 --width 400 --height 300", "dws sheet create-float-image --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --src \"/core/api/resources/img/xxxx...\" --range B2 --width 200 --height 150 --offset-x 10 --offset-y 20" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "create_float_image" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_float_image", "parameter_count": 8, "parameters": { "height": { "description": "图片高度，像素 (必填)", "interface_description": "图片高度（必填），单位像素，正整数。", "interface_type": "number", "property": "height", "required": true, "type": "integer" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "offset-x": { "description": "水平偏移量，像素 (默认 0)", "interface_description": "相对锚点单元格的水平偏移量（可选），单位像素，默认 0。", "interface_type": "number", "property": "offsetX", "required": false, "type": "integer" }, "offset-y": { "description": "垂直偏移量，像素 (默认 0)", "interface_description": "相对锚点单元格的垂直偏移量（可选），单位像素，默认 0。", "interface_type": "number", "property": "offsetY", "required": false, "type": "integer" }, "range": { "description": "锚点单元格，A1 表示法，如 A1、B3 (必填)", "format": "a1-range", "interface_description": "浮动图片锚定的单元格位置（必填），使用 A1 表示法，如 \"A1\"、\"B3\"。必须是单个单元格。支持带工作表前缀（如 \"Sheet1!A1\"）。", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" }, "src": { "description": "图片资源路径，通过 media-upload 获取的 resourceUrl (必填)", "interface_description": "图片的 URL 地址（必填）。", "property": "src", "required": true, "type": "string" }, "width": { "description": "图片宽度，像素 (必填)", "interface_description": "图片宽度（必填），单位像素，正整数。", "interface_type": "number", "property": "width", "required": true, "type": "integer" } }, "path": "sheet.create_float_image", "primary_cli_path": "sheet create-float-image", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "插入浮动图片", "use_when": [ "再创建浮动图片", "带偏移量" ] }, "sheet.create_sheet": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.sheet.prod.json#sheet.create_sheet", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-workbook.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "新建工作表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“新建工作表”所述变更时不要使用" ], "canonical_path": "sheet.create_sheet", "cli_name": "new", "cli_path": "sheet new", "confirmation": "not_required", "description": "在钉钉表格中创建一个新的工作表。\r\n通过 nodeId 定位表格文件，在该表格中新增一个工作表。\r\n当指定的工作表名称与已有名称重复时，系统会自动重命名为合法值。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet new --node \u003cNODE_ID\u003e --name \"Sheet2\"", "dws sheet new --node \u003cNODE_ID\u003e --name \"数据汇总\"" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "create_sheet" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_sheet", "parameter_count": 2, "parameters": { "name": { "description": "工作表名称 (必填)", "interface_description": "新工作表的名称。当指定名称与已有工作表重复时，系统会自动重命名为合法值。必填。", "property": "name", "required": true, "type": "string" }, "node": { "description": "表格文档 ID (必填)", "property": "node", "required": true, "type": "string" } }, "path": "sheet.create_sheet", "primary_cli_path": "sheet new", "product_id": "sheet", "risk": "medium", "source": "hardcoded:sheet", "title": "新建工作表", "use_when": [ "1. 新建工作表", "加工作表/新增Sheet；新建工作表" ] }, "sheet.create_workspace_sheet": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.sheet.prod.json#sheet.create_workspace_sheet", "skills/mono/references/products/doc.md", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-media-image.md", "skills/mono/references/products/sheet/sheet-workbook.md", "skills/mono/references/products/sheet/sheet-write-data.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "创建钉钉表格文档", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建钉钉表格文档”所述变更时不要使用" ], "canonical_path": "sheet.create_workspace_sheet", "cli_name": "create", "cli_path": "sheet create", "confirmation": "not_required", "description": "创建一篇新的钉钉在线表格。\r\n支持创建空表格。\r\n支持三种创建位置：\r\n1. 指定 folderId：在该文件夹下创建\r\n2. 指定 workspaceId（知识库 ID）但不传 folderId：在该知识库的根目录下创建\r\n3. 都不传：在用户\"我的文档\"根目录下创建\r\n操作受权限控制，仅当调用者对目标位置有写入权限时可成功创建。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet create --name \"销售数据\"", "dws sheet create --name \"Q1 数据\" --folder \u003cFOLDER_ID\u003e" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "create_workspace_sheet" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_workspace_sheet", "parameter_count": 3, "parameters": { "folder": { "description": "目标文件夹 ID 或 URL", "property": "folder", "required": false, "type": "string" }, "name": { "description": "表格名称 (必填)", "interface_description": "新表格的标题，必填。", "property": "name", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID", "property": "workspace", "required": false, "type": "string" } }, "path": "sheet.create_workspace_sheet", "primary_cli_path": "sheet create", "product_id": "sheet", "risk": "medium", "source": "hardcoded:sheet", "title": "新建钉钉表格", "use_when": [ "1. 创建表格文档 — 提取 nodeId", "4. 完整流程: 创建表格 → 上传附件", "4. 完整流程: 创建表格 → 写表头 → 写入图片", "创建表格/新建电子表格；创建表格文档" ] }, "sheet.delete_cond_format": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-conditional-format.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "删除条件格式规则", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除普通筛选用 sheet filter delete", "删除筛选视图用 sheet filter-view delete", "只修改规则用 sheet cond-format update" ], "canonical_path": "sheet.delete_cond_format", "cli_name": "delete", "cli_path": "sheet cond-format delete", "confirmation": "user_required", "description": "删除指定工作表中的一条条件格式规则。", "display": "钉钉表格管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws sheet cond-format delete --node \u003cnode\u003e --rule-id \u003crule-id\u003e --sheet-id \u003csheet-id\u003e" ], "group": "cond-format", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "delete_cond_format" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_cond_format", "parameter_count": 4, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "rule-id": { "description": "条件格式规则 ID (必填)", "interface_description": "要删除的条件格式规则 ID（必填）。", "property": "ruleId", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。", "property": "sheetId", "required": true, "type": "string" }, "yes": { "description": "确认删除（危险操作，必须用户同意后才加此标志）", "property": "yes", "required": false, "type": "boolean" } }, "path": "sheet.delete_cond_format", "primary_cli_path": "sheet cond-format delete", "product_id": "sheet", "reviewed": true, "risk": "high", "source": "hardcoded:sheet", "title": "删除条件格式规则", "use_when": [ "删除某条条件格式规则" ] }, "sheet.delete_dimension": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.delete_dimension", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-dimension-operations.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "在钉钉表格指定工作表中，从指定位置起删除若干连续的行或列。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "用户未明确要求“在钉钉表格指定工作表中，从指定位置起删除若干连续的行或列。”、目标不清楚或尚未确认时不要使用" ], "canonical_path": "sheet.delete_dimension", "cli_name": "delete-dimension", "cli_path": "sheet delete-dimension", "confirmation": "user_required", "description": "在钉钉表格指定工作表中，从指定位置起删除若干连续的行或列。", "display": "钉钉表格管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws sheet delete-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --dimension ROWS --position \"3\" --length 2", "dws sheet delete-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --dimension COLUMNS --position \"A\" --length 1" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "delete_dimension" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_dimension", "parameter_count": 5, "parameters": { "dimension": { "description": "删除维度: ROWS 或 COLUMNS (必填)", "enum": [ "ROWS", "COLUMNS" ], "interface_description": "删除维度：ROWS 表示删除行，COLUMNS 表示删除列。必填。", "property": "dimension", "required": true, "type": "string" }, "length": { "description": "删除数量，正整数 (必填)，最大 5000", "format": "positive-integer", "interface_description": "要删除的行/列数量，必须为正整数（\u003e= 1）。必填。", "interface_type": "number", "property": "length", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "position": { "description": "删除起始位置，A1 表示法 (必填)。ROWS 时为行号如 \"3\"；COLUMNS 时为列字母如 \"A\"", "example": "1", "format": "a1-range", "interface_description": "删除起始位置的 A1 表示法。dimension=ROWS 时为 1-based 行号字符串，如 \"3\" 表示从第 3 行开始删除；dimension=COLUMNS 时为列字母，如 \"A\" 表示从 A 列开始删除、\"AB\" 表示从 AB 列开始删除。从该位置开始连续删除 length 个行/列。允许携带工作表前缀，如 \"Sheet1!3\" / \"Sheet1!A\"，此时将忽略 sheetId 参数。必填。", "property": "position", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "工作表 ID 或名称。可通过获取所有工作表接口获取 id 或 name 参数值。必填。若 position 携带 Sheet 前缀（如 Sheet1!3），以前缀为准。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.delete_dimension", "primary_cli_path": "sheet delete-dimension", "product_id": "sheet", "reviewed": false, "risk": "high", "source": "hardcoded:sheet", "title": "删除指定位置的行或列", "use_when": [ "2. 从第 3 行开始删除 2 行", "3. 从 A 列开始删除 1 列", "4. 使用工作表前缀指定位置", "从 A 列开始删除 1 列", "从 AB 列开始删除 3 列", "从第 3 行开始删除 2 行", "使用工作表前缀（忽略 --sheet-id）", "删除行/删除列/删掉第几行/删掉某列/移除行/移除列；删除行或列" ] }, "sheet.delete_dropdown_lists": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-dropdown.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "删除单元格下拉列表配置", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "修改下拉选项用 sheet set-dropdown", "只查询下拉配置用 sheet get-dropdown", "清空单元格内容用 sheet range clear" ], "canonical_path": "sheet.delete_dropdown_lists", "cli_name": "delete-dropdown", "cli_path": "sheet delete-dropdown", "confirmation": "user_required", "description": "删除钉钉表格指定单元格范围内的下拉列表配置。", "display": "钉钉表格管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws sheet delete-dropdown --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A2:A100\"", "dws sheet delete-dropdown --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"B1:D10\"" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "delete_dropdown_lists" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_dropdown_lists", "parameter_count": 3, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "要删除下拉列表的范围，A1 表示法，如 A2:A100 (必填)", "format": "a1-range", "interface_description": "要删除下拉列表的单元格范围（必填），A1 表示法，如 \"A2:A100\"。", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 获取。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.delete_dropdown_lists", "primary_cli_path": "sheet delete-dropdown", "product_id": "sheet", "reviewed": true, "risk": "high", "source": "hardcoded:sheet", "title": "删除下拉列表", "use_when": [ "移除指定范围的下拉列表配置" ] }, "sheet.delete_filter": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "删除工作表基础筛选", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "仅查看筛选信息用 sheet filter get", "删除筛选视图用 sheet filter-view delete", "只清除某列条件用 sheet filter clear-criteria" ], "canonical_path": "sheet.delete_filter", "cli_name": "delete", "cli_path": "sheet filter delete", "confirmation": "user_required", "description": "删除钉钉电子表格中指定工作表的筛选。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n删除筛选后，工作表中的筛选下拉箭头和所有筛选条件将被移除，所有被隐藏的行将重新显示。\r\n如果工作表没有筛选，调用此接口会报错。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可删除。不支持跨组织操作。", "display": "钉钉表格管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws sheet filter delete --node \u003cnode\u003e --sheet-id \u003csheet-id\u003e" ], "group": "filter", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "delete_filter" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_filter", "parameter_count": 2, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.delete_filter", "primary_cli_path": "sheet filter delete", "product_id": "sheet", "reviewed": true, "risk": "high", "source": "hardcoded:sheet", "title": "删除筛选", "use_when": [ "移除整张表的普通筛选配置" ] }, "sheet.delete_filter_view": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter-view.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "删除筛选视图", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除基础筛选用 sheet filter delete", "只删除某列条件用 sheet filter-view delete-criteria", "查看筛选视图详情用 sheet filter-view info" ], "canonical_path": "sheet.delete_filter_view", "cli_name": "delete", "cli_path": "sheet filter-view delete", "confirmation": "user_required", "description": "删除钉钉电子表格中指定工作表的筛选视图。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 filterViewId 定位筛选视图。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\nfilterViewId 可通过 get_filter_views 获取。\r\n\r\n删除筛选视图后，该视图及其所有筛选条件将被永久移除。此操作不影响全局筛选或其他筛选视图。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可删除。不支持跨组织操作。", "display": "钉钉表格管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws sheet filter-view delete --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e", "dws sheet filter-view delete --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e -f json" ], "group": "filter-view", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "delete_filter_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_filter_view", "parameter_count": 3, "parameters": { "filter-view-id": { "description": "筛选视图 ID (必填)", "interface_description": "要删除的筛选视图 ID（必填）。可通过 get_filter_views 接口获取。", "property": "filterViewId", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.delete_filter_view", "primary_cli_path": "sheet filter-view delete", "product_id": "sheet", "reviewed": true, "risk": "high", "source": "hardcoded:sheet", "title": "删除筛选视图", "use_when": [ "删除一个已保存的筛选视图" ] }, "sheet.delete_float_image": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.delete_float_image", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-media-image.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "删除钉钉电子表格中指定的浮动图片。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "用户未明确要求“删除钉钉电子表格中指定的浮动图片。”、目标不清楚或尚未确认时不要使用" ], "canonical_path": "sheet.delete_float_image", "cli_name": "delete-float-image", "cli_path": "sheet delete-float-image", "confirmation": "user_required", "description": "删除钉钉电子表格中指定的浮动图片。", "display": "钉钉表格管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws sheet delete-float-image --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --float-image-id \u003cFI_ID\u003e" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "delete_float_image" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_float_image", "parameter_count": 3, "parameters": { "float-image-id": { "description": "浮动图片 ID (必填)", "interface_description": "浮动图片 ID（必填）。可通过 list_float_images 接口获取。", "property": "floatImageId", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.delete_float_image", "primary_cli_path": "sheet delete-float-image", "product_id": "sheet", "reviewed": false, "risk": "high", "source": "hardcoded:sheet", "title": "删除浮动图片", "use_when": [ "删除浮动图片/移除浮动图片；删除浮动图片" ] }, "sheet.delete_sheet": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.delete_sheet", "skills/mono/references/products/sheet/sheet-workbook.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "删除钉钉电子表格中的指定工作表", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "用户未明确要求“删除钉钉电子表格中的指定工作表”、目标不清楚或尚未确认时不要使用" ], "canonical_path": "sheet.delete_sheet", "cli_name": "delete-sheet", "cli_path": "sheet delete-sheet", "confirmation": "user_required", "description": "删除钉钉电子表格中的指定工作表", "display": "钉钉表格管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws sheet delete-sheet --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "delete_sheet" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_sheet", "parameter_count": 2, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "要删除的工作表 ID 或名称 (必填)", "interface_description": "要删除的工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.delete_sheet", "primary_cli_path": "sheet delete-sheet", "product_id": "sheet", "reviewed": false, "risk": "high", "source": "hardcoded:sheet", "title": "删除工作表", "use_when": [ "删除工作表/移除工作表/删掉这个Sheet；删除工作表" ] }, "sheet.fill_range": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.fill_range", "skills/mono/references/products/sheet/sheet-range-operations.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "基于源数据范围自动填充到目标范围。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值”请改用 dws sheet range batch-set-style", "要“将源范围的数据复制到目标位置”请改用 dws sheet range copy-to", "要“清除钉钉电子表格中指定工作表指定范围的单元格内容、格式或全部”请改用 dws sheet range clear" ], "canonical_path": "sheet.fill_range", "cli_name": "fill", "cli_path": "sheet range fill", "confirmation": "not_required", "description": "基于源数据范围自动填充到目标范围。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet range fill --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --source-range \"A1:A5\" --target-range \"A6:A20\"", "dws sheet range fill --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --source-range \"A1:A5\" --target-range \"A6:A20\" --fill-type copy" ], "group": "range", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "fill_range" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "fill_range", "parameter_count": 5, "parameters": { "fill-type": { "description": "填充类型: 不传则自动检测 / copy(复制) / onlystyle(仅格式) / withoutstyle(仅值)", "interface_description": "填充类型（可选）。不传时引擎智能推断（与前端拖拽行为一致，自动识别等差/日期等序列模式）。可选值：copy(复制内容和格式)、series(强制序列递增)、onlystyle(仅格式)、withoutstyle(仅值无格式)。", "property": "fillType", "required": false, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" }, "source-range": { "description": "源数据范围，A1 表示法 (必填，如 A1:A5)", "format": "a1-range", "interface_description": "源数据范围（必填），使用 A1 表示法。例如 \"A1:A5\"，填充时以此区域的数据为基础进行扩展。", "property": "sourceRange", "required": true, "type": "string" }, "target-range": { "description": "目标填充范围，A1 表示法 (必填，如 A6:A20)", "format": "a1-range", "property": "targetRange", "required": true, "type": "string" } }, "path": "sheet.fill_range", "primary_cli_path": "sheet range fill", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "区域自动填充", "use_when": [ "自动填充/填充序列/向下填充/拖拽填充/序列递增；自动填充" ] }, "sheet.filter_clear_criteria": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "清除基础筛选中某一列条件", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除整个基础筛选用 sheet filter delete", "更新筛选条件用 sheet filter update", "筛选视图条件用 sheet filter-view delete-criteria" ], "canonical_path": "sheet.filter_clear_criteria", "cli_name": "clear-criteria", "cli_path": "sheet filter clear-criteria", "confirmation": "not_required", "description": "清除钉钉电子表格中指定工作表筛选的某一列的筛选条件。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 column 指定目标列。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n清除指定列的筛选条件后，该列不再参与筛选计算，之前被该列条件隐藏的行将重新显示（前提是其他列的条件也不隐藏该行）。\r\n此操作仅清除指定列的条件，不会删除整个筛选。如需删除整个筛选，请使用 delete_filter。\r\n\r\n如果指定列没有设置筛选条件，调用此接口不会报错。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可操作。不支持跨组织操作。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet filter clear-criteria --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --column 1", "dws sheet filter clear-criteria --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --column 0" ], "group": "filter", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "clear_filter_criteria" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "filter_clear_criteria", "parameter_count": 3, "parameters": { "column": { "description": "列偏移量，从 0 开始 (必填)", "interface_description": "要清除筛选条件的列偏移量（必填），0-based，相对于筛选范围起始列。", "interface_type": "number", "property": "column", "required": true, "type": "integer" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.filter_clear_criteria", "primary_cli_path": "sheet filter clear-criteria", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "清除筛选条件", "use_when": [ "仅清除普通筛选的某列筛选条件" ] }, "sheet.filter_view_delete_criteria": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter-view.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "删除筛选视图单列筛选条件", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除整个筛选视图用 sheet filter-view delete", "基础筛选清除列条件用 sheet filter clear-criteria", "更新条件用 sheet filter-view update-criteria" ], "canonical_path": "sheet.filter_view_delete_criteria", "cli_name": "delete-criteria", "cli_path": "sheet filter-view delete-criteria", "confirmation": "user_required", "description": "清除钉钉电子表格中指定工作表筛选视图的某一列的筛选条件。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 filterViewId 定位筛选视图，通过 column 指定目标列。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\nfilterViewId 可通过 get_filter_views 获取。\r\n\r\n清除指定列的筛选条件后，该列不再参与筛选视图的筛选计算。\r\n此操作仅清除指定列的条件，不会删除整个筛选视图。如需删除整个筛选视图，请使用 delete_filter_view。\r\n清除操作仅影响当前筛选视图，不影响全局筛选或其他筛选视图。\r\n\r\n如果指定列没有设置筛选条件，调用此接口不会报错。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可操作。不支持跨组织操作。", "display": "钉钉表格管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws sheet filter-view delete-criteria --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e --column 0", "dws sheet filter-view delete-criteria --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e --column 2" ], "group": "filter-view", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "clear_filter_view_criteria" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "filter_view_delete_criteria", "parameter_count": 4, "parameters": { "column": { "description": "列偏移量，从 0 开始 (必填)", "interface_description": "要清除筛选条件的列偏移量（必填），0-based，相对于筛选视图范围起始列。", "interface_type": "number", "property": "column", "required": true, "type": "integer" }, "filter-view-id": { "description": "筛选视图 ID (必填)", "interface_description": "目标筛选视图 ID（必填）。可通过 get_filter_views 接口获取。", "property": "filterViewId", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.filter_view_delete_criteria", "primary_cli_path": "sheet filter-view delete-criteria", "product_id": "sheet", "reviewed": true, "risk": "high", "source": "hardcoded:sheet", "title": "清除筛选视图列条件", "use_when": [ "清除筛选视图中某列的筛选条件" ] }, "sheet.filter_view_get_criteria": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter-view.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "获取单列筛选条件", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "列出所有列条件用 sheet filter-view list-criteria", "删除单列条件用 sheet filter-view delete-criteria", "更新单列条件用 sheet filter-view update-criteria" ], "canonical_path": "sheet.filter_view_get_criteria", "cli_name": "get-criteria", "cli_path": "sheet filter-view get-criteria", "confirmation": "not_required", "description": "获取钉钉电子表格中指定工作表的所有筛选视图列表。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n筛选视图是独立于全局筛选的个人化数据过滤方式，不同用户可以创建自己的筛选视图，互不影响。\r\n返回该工作表下所有筛选视图的 ID、名称和范围信息。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet filter-view get-criteria --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e --column 0", "dws sheet filter-view get-criteria --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e --column 2" ], "group": "filter-view", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_filter_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "filter_view_get_criteria", "parameter_count": 4, "parameters": { "column": { "description": "列偏移量，从 0 开始 (必填)", "property": "column", "required": true, "type": "integer" }, "filter-view-id": { "description": "筛选视图 ID (必填)", "property": "filterViewId", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.filter_view_get_criteria", "primary_cli_path": "sheet filter-view get-criteria", "product_id": "sheet", "reviewed": true, "risk": "low", "source": "hardcoded:sheet", "title": "获取筛选视图", "use_when": [ "查看筛选视图某一列的筛选条件" ] }, "sheet.filter_view_info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter-view.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "获取单个筛选视图详情", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "列出所有筛选视图用 sheet filter-view list", "更新筛选视图用 sheet filter-view update", "查看列条件用 sheet filter-view list-criteria" ], "canonical_path": "sheet.filter_view_info", "cli_name": "info", "cli_path": "sheet filter-view info", "confirmation": "not_required", "description": "获取钉钉电子表格中指定工作表的所有筛选视图列表。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n筛选视图是独立于全局筛选的个人化数据过滤方式，不同用户可以创建自己的筛选视图，互不影响。\r\n返回该工作表下所有筛选视图的 ID、名称和范围信息。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet filter-view info --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e" ], "group": "filter-view", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_filter_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "filter_view_info", "parameter_count": 3, "parameters": { "filter-view-id": { "description": "筛选视图 ID (必填)", "property": "filterViewId", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.filter_view_info", "primary_cli_path": "sheet filter-view info", "product_id": "sheet", "reviewed": true, "risk": "low", "source": "hardcoded:sheet", "title": "获取筛选视图", "use_when": [ "已知道 filterViewId，需要查看名称、范围和配置" ] }, "sheet.filter_view_list_criteria": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter-view.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "列出筛选视图所有列条件", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "基础筛选条件用 sheet filter get/update", "更新条件用 sheet filter-view update-criteria", "查看单列条件用 sheet filter-view get-criteria" ], "canonical_path": "sheet.filter_view_list_criteria", "cli_name": "list-criteria", "cli_path": "sheet filter-view list-criteria", "confirmation": "not_required", "description": "获取钉钉电子表格中指定工作表的所有筛选视图列表。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n筛选视图是独立于全局筛选的个人化数据过滤方式，不同用户可以创建自己的筛选视图，互不影响。\r\n返回该工作表下所有筛选视图的 ID、名称和范围信息。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet filter-view list-criteria --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e" ], "group": "filter-view", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_filter_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "filter_view_list_criteria", "parameter_count": 3, "parameters": { "filter-view-id": { "description": "筛选视图 ID (必填)", "property": "filterViewId", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.filter_view_list_criteria", "primary_cli_path": "sheet filter-view list-criteria", "product_id": "sheet", "reviewed": true, "risk": "low", "source": "hardcoded:sheet", "title": "获取筛选视图", "use_when": [ "查看筛选视图下每列筛选条件" ] }, "sheet.filter_view_update_criteria": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter-view.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "更新筛选视图列条件", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "删除筛选视图列条件用 sheet filter-view delete-criteria", "更新基础筛选条件用 sheet filter update", "更新视图名称/范围用 sheet filter-view update" ], "canonical_path": "sheet.filter_view_update_criteria", "cli_name": "update-criteria", "cli_path": "sheet filter-view update-criteria", "confirmation": "not_required", "description": "更新钉钉电子表格中指定工作表筛选视图的某一列的筛选条件。\n\n用途：为筛选视图的指定列创建或更新筛选条件，控制该列哪些数据行可见。\n场景：\n - 只显示某些特定值的行（如\"只看研发部\"）→ 使用 filterType: values\n - 按数值条件筛选（如\"绩效 ≥ 85\"）→ 使用 filterType: condition + operator: greater-equal\n - 按文本条件筛选（如\"名称包含关键字\"）→ 使用 filterType: condition + operator: contains\n区分：\n - update-criteria 精确控制单列条件，适合逐列设置不同的筛选逻辑\n - filter-view update --criteria 可以批量更新多列条件，适合一次性设置多列\n - delete-criteria 是 update-criteria 的逆操作，删除指定列的条件\n\n通过 --node 定位电子表格文档，通过 --sheet-id 定位工作表，通过 --filter-view-id 定位筛选视图，通过 --column 指定目标列。\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\nsheetId 支持传入工作表 ID 或工作表名称，可通过 sheet list 获取。\nfilterViewId 可通过 filter-view list 获取。\n\n--column 为列偏移量（从 0 开始），相对于筛选视图范围首列。\n例如筛选视图范围为 B1:E10，则 --column 0 代表 B 列，--column 1 代表 C 列。\n\n--filter-criteria 为该列的筛选条件 JSON 对象，支持三种筛选类型：\n values 按值筛选，通过 visibleValues 指定允许显示的值列表\n condition 按条件筛选，通过 conditions 指定条件运算符和比较值（最多 2 个）\n color 按颜色筛选，通过 backgroundColor 或 fontColor 指定颜色\n\ncondition 类型支持的 operator（必须使用 kebab-case 格式）：\n equal, not-equal, contains, not-contains,\n starts-with, not-starts-with, ends-with, not-ends-with,\n greater, greater-equal, less, less-equal\n\n多条件之间通过 conditionOperator 指定逻辑关系：\"and\"（且，默认）或 \"or\"（或）。\n\n更新条件后会立即在该筛选视图中生效。筛选视图的条件仅影响当前视图，不影响全局筛选或其他筛选视图。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet filter-view update-criteria --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e --column 0 --filter-criteria '{\"filterType\":\"values\",\"visibleValues\":[\"销售部\",\"市场部\"]}'", "dws sheet filter-view update-criteria --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e --column 2 --filter-criteria '{\"filterType\":\"condition\",\"conditions\":[{\"operator\":\"greater\",\"value\":\"100\"}]}'" ], "group": "filter-view", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "set_filter_view_criteria" }, "is_alias": false, "name": "filter_view_update_criteria", "parameter_count": 5, "parameters": { "column": { "description": "列偏移量，从 0 开始 (必填)", "property": "column", "required": true, "type": "integer" }, "filter-criteria": { "description": "筛选条件，JSON 对象 (必填)", "property": "filterCriteria", "required": true, "type": "string" }, "filter-view-id": { "description": "筛选视图 ID (必填)", "property": "filterViewId", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.filter_view_update_criteria", "primary_cli_path": "sheet filter-view update-criteria", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "更新筛选视图列条件", "use_when": [ "修改筛选视图中某一列的筛选规则" ] }, "sheet.find_cells": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.find_cells", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-search-replace.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "在钉钉电子表格的指定工作表中查找匹配指定文本的所有单元格，返回匹配的单元格地址列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“在钉钉电子表格的指定工作表中查找匹配指定文本的所有单元格，返回匹配的单元格地址列表。”" ], "canonical_path": "sheet.find_cells", "cli_name": "find", "cli_path": "sheet find", "confirmation": "not_required", "description": "在钉钉电子表格的指定工作表中查找匹配指定文本的所有单元格，返回匹配的单元格地址列表。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 text 指定查找内容。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n支持多种查找模式：\r\n- 默认模式：在单元格值中进行子字符串匹配（区分大小写）\r\n- 忽略大小写：通过 matchCase: false 实现\r\n- 完整单元格匹配：通过 matchEntireCell: true 实现，仅匹配内容完全相同的单元格\r\n- 正则表达式：通过 useRegExp: true 实现，text 作为正则表达式进行匹配\r\n- 搜索公式：通过 matchFormulaText: true 实现，在公式文本中查找而非计算结果\r\n- 包含隐藏单元格：通过 includeHidden: true 实现\r\n\r\n返回所有匹配单元格的地址（A1 表示法）列表。若无匹配结果，返回空数组。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可查找。不支持跨组织查询。", "display": "钉钉表格管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws sheet find --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --find \"销售额\"", "dws sheet find --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --find \"合计\" --range \"A1:D100\"" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "find_cells" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "find_cells", "parameter_count": 9, "parameters": { "include-hidden": { "description": "包含隐藏单元格", "interface_description": "是否在隐藏的行/列中也进行查找。默认为 false，即跳过隐藏单元格。", "property": "includeHidden", "required": false, "type": "boolean" }, "match-case": { "default": "true", "description": "区分大小写 (默认 true)", "interface_description": "是否区分大小写。默认为 true（区分大小写）。设为 false 时不区分大小写。", "property": "matchCase", "required": false, "type": "boolean" }, "match-entire-cell": { "description": "精确匹配整个单元格内容", "interface_description": "是否要求单元格内容与查找文本完全一致。默认为 false（子字符串匹配）。设为 true 时仅匹配内容完全相同的单元格。", "property": "matchEntireCell", "required": false, "type": "boolean" }, "match-formula": { "description": "搜索公式文本而非显示值", "property": "matchFormula", "required": false, "type": "boolean" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "query": { "description": "搜索文本 (必填，别名: --find)", "property": "query", "required": true, "type": "string" }, "range": { "description": "搜索范围，A1 表示法 (如 A1:D10)", "format": "a1-range", "interface_description": "将查找限定在指定单元格范围内（可选），使用 A1 表示法，如 A1:D100、A:A（整列）、1:1（整行）。不传时搜索整个工作表。底层直接映射为 findOptions.scope 参数，无额外性能开销。", "property": "range", "required": false, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" }, "use-regexp": { "description": "启用正则表达式搜索", "property": "useRegexp", "required": false, "type": "boolean" } }, "path": "sheet.find_cells", "primary_cli_path": "sheet find", "product_id": "sheet", "reviewed": false, "risk": "low", "source": "hardcoded:sheet", "title": "查找", "use_when": [ "2. 基本搜索 — 在指定工作表中查找文本", "3. 在指定范围内搜索", "4. 正则搜索（不区分大小写）", "5. 精确匹配整个单元格", "6. 搜索公式文本", "在指定范围内搜索", "基本搜索", "导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；\"帮我找一下表格里的XXX", "搜索/查找/找单元格/搜内容/精确搜索/精确匹配/完全匹配/全字匹配；搜索公式", "搜索/查找/找单元格/搜内容/精确搜索/精确匹配/完全匹配/全字匹配；搜索单元格", "搜索/查找/找单元格/搜内容/精确搜索/精确匹配/完全匹配/全字匹配；正则搜索", "搜索/查找/找单元格/搜内容/精确搜索/精确匹配/完全匹配/全字匹配；精确匹配（只匹配完全等于的，不匹配包含的）", "搜索公式文本", "正则表达式搜索（不区分大小写）", "精确匹配整个单元格内容" ] }, "sheet.get_all_sheets": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.sheet.prod.json#sheet.get_all_sheets", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-chart.md", "skills/mono/references/products/sheet/sheet-dimension-operations.md", "skills/mono/references/products/sheet/sheet-filter-view.md", "skills/mono/references/products/sheet/sheet-read-data.md", "skills/mono/references/products/sheet/sheet-search-replace.md", "skills/mono/references/products/sheet/sheet-style-format.md", "skills/mono/references/products/sheet/sheet-workbook.md", "skills/mono/references/products/sheet/sheet-write-data.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取全部工作表列表", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取全部工作表列表”" ], "canonical_path": "sheet.get_all_sheets", "cli_name": "list", "cli_path": "sheet list", "confirmation": "not_required", "description": "获取钉钉电子表格中的所有工作表列表。\r\n\r\n通过 nodeId 定位电子表格文档，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\n返回该电子表格下所有工作表的 ID 和名称，可用于后续调用 get_sheet 或 get_range 时指定目标工作表。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。\r\n\r\n支持的文档类型：钉钉在线电子表格。\r\n文档链接格式：https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\r\ndentryUuid 为 32 位字母数字字符串。", "display": "钉钉表格管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws sheet list --node \u003cNODE_ID\u003e", "dws sheet list --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\"" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_all_sheets" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_all_sheets", "parameter_count": 1, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" } }, "path": "sheet.get_all_sheets", "primary_cli_path": "sheet list", "product_id": "sheet", "risk": "low", "source": "hardcoded:sheet", "title": "获取所有工作表", "use_when": [ "1. 先查 sheetId", "1. 获取工作表列表", "2. 查看工作表列表 — 提取 sheetId", "导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；\"这个表格有哪些工作表", "导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；extension=axls", "看工作表/有哪些工作表/表格结构；列出工作表" ] }, "sheet.get_cond_format": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-conditional-format.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "查看条件格式规则列表或详情", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "创建条件格式用 sheet cond-format create", "删除条件格式用 sheet cond-format delete", "更新条件格式用 sheet cond-format update" ], "canonical_path": "sheet.get_cond_format", "cli_name": "list", "cli_path": "sheet cond-format list", "confirmation": "not_required", "description": "获取指定工作表中的所有条件格式规则，或通过 ruleId 获取单个规则的详情。\r\n条件格式规则定义了当单元格满足特定条件时自动应用的样式（如背景色、字体颜色等）。\r\n返回的每条规则包含：规则 ID、应用范围、条件类型及参数、命中时的单元格样式。\r\n支持的条件类型包括：数值比较、文本包含、空值/非空、错误值、重复/唯一值、自定义公式、排名、高于/低于平均值、标准差、时间段、数据条、图标集、色阶。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet cond-format list --node NODE_ID --sheet-id SHEET_ID" ], "group": "cond-format", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_cond_format" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_cond_format", "parameter_count": 3, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "rule-id": { "description": "条件格式规则 ID (可选，不传则返回全部)", "interface_description": "条件格式规则的唯一标识（可选）。如果提供，则只返回该规则的详情；不提供则返回所有规则。", "property": "ruleId", "required": false, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.get_cond_format", "primary_cli_path": "sheet cond-format list", "product_id": "sheet", "reviewed": true, "risk": "low", "source": "hardcoded:sheet", "title": "获取条件格式规则", "use_when": [ "查看工作表已有条件格式规则" ] }, "sheet.get_dropdown_lists": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-dropdown.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "查询单元格下拉列表配置", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除下拉列表用 sheet delete-dropdown", "设置下拉列表用 sheet set-dropdown", "读取单元格值用 sheet range read" ], "canonical_path": "sheet.get_dropdown_lists", "cli_name": "get-dropdown", "cli_path": "sheet get-dropdown", "confirmation": "not_required", "description": "查询钉钉表格指定范围内的下拉列表配置。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet get-dropdown --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A2:A100\"", "dws sheet get-dropdown --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1\"" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_dropdown_lists" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_dropdown_lists", "parameter_count": 3, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "查询范围，A1 表示法，如 A1:A100 (必填)", "format": "a1-range", "interface_description": "要查询下拉列表的单元格范围（必填），A1 表示法，如 \"A1\"、\"A1:A100\"、\"B2:D10\"。支持查询范围内所有单元格的下拉配置。", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 获取。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.get_dropdown_lists", "primary_cli_path": "sheet get-dropdown", "product_id": "sheet", "reviewed": true, "risk": "low", "source": "hardcoded:sheet", "title": "获取下拉列表", "use_when": [ "查看某个范围是否配置了下拉列表" ] }, "sheet.get_filter": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "查看工作表基础筛选信息", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "创建或更新筛选用 sheet filter create/update", "查看筛选视图列表用 sheet filter-view list", "查看筛选视图条件用 sheet filter-view get-criteria" ], "canonical_path": "sheet.get_filter", "cli_name": "get", "cli_path": "sheet filter get", "confirmation": "not_required", "description": "获取钉钉电子表格中指定工作表的筛选信息。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n返回当前工作表的筛选范围和各列的筛选条件详情。\r\n筛选条件类型包括：\r\n- 按值筛选（filterType: values）：指定允许显示的值列表\r\n- 按条件筛选（filterType: condition）：指定条件运算符和比较值\r\n- 按颜色筛选（filterType: color）：按单元格背景色或字体颜色筛选\r\n\r\n如果工作表未设置筛选，返回结果中筛选信息为空。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet filter get --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e", "dws sheet filter get --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --sheet-id \"Sheet1\"" ], "group": "filter", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_filter" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_filter", "parameter_count": 2, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.get_filter", "primary_cli_path": "sheet filter get", "product_id": "sheet", "reviewed": true, "risk": "low", "source": "hardcoded:sheet", "title": "获取筛选", "use_when": [ "查看普通筛选是否存在及范围" ] }, "sheet.get_filter_views": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter-view.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "列出工作表筛选视图", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "创建/更新筛选视图用 create/update", "查看列条件用 sheet filter-view list-criteria", "查看单个筛选视图详情用 sheet filter-view info" ], "canonical_path": "sheet.get_filter_views", "cli_name": "list", "cli_path": "sheet filter-view list", "confirmation": "not_required", "description": "获取钉钉电子表格中指定工作表的所有筛选视图列表。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n筛选视图是独立于全局筛选的个人化数据过滤方式，不同用户可以创建自己的筛选视图，互不影响。\r\n返回该工作表下所有筛选视图的 ID、名称和范围信息。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet filter-view list --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e", "dws sheet filter-view list --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --sheet-id \"Sheet1\"" ], "group": "filter-view", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_filter_views" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_filter_views", "parameter_count": 2, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.get_filter_views", "primary_cli_path": "sheet filter-view list", "product_id": "sheet", "reviewed": true, "risk": "low", "source": "hardcoded:sheet", "title": "获取筛选视图", "use_when": [ "查看有哪些筛选视图" ] }, "sheet.get_float_image": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.get_float_image", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-media-image.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取钉钉电子表格中指定浮动图片的详细信息。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取钉钉电子表格中指定浮动图片的详细信息。”" ], "canonical_path": "sheet.get_float_image", "cli_name": "get-float-image", "cli_path": "sheet get-float-image", "confirmation": "not_required", "description": "获取钉钉电子表格中指定浮动图片的详细信息。", "display": "钉钉表格管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws sheet get-float-image --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --float-image-id \u003cFI_ID\u003e" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_float_image" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_float_image", "parameter_count": 3, "parameters": { "float-image-id": { "description": "浮动图片 ID (必填)", "interface_description": "浮动图片 ID（必填）。可通过 list_float_images 接口获取。", "property": "floatImageId", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.get_float_image", "primary_cli_path": "sheet get-float-image", "product_id": "sheet", "reviewed": false, "risk": "low", "source": "hardcoded:sheet", "title": "获取单张浮动图片", "use_when": [ "查看浮动图片/有哪些浮动图片/浮动图片列表；查看某个浮动图片详情" ] }, "sheet.get_range_as_csv": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-chart.md", "skills/mono/references/products/sheet/sheet-read-data.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "以 CSV 格式读取指定区域数据", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入 CSV 用 sheet csv-put", "写入普通二维数组用 sheet range update", "需要 JSON/结构化值用 sheet range read" ], "canonical_path": "sheet.get_range_as_csv", "cli_name": "csv-get", "cli_path": "sheet csv-get", "confirmation": "not_required", "description": "以 RFC 4180 CSV 格式读取钉钉电子表格中指定工作表的指定范围数据。\r\n\r\n与 get_range 的区别：\r\n- 返回 CSV 文本而非 JSON 二维数组，token 消耗约为 JSON 的 1/3\r\n- 每行前加 [row=N] 前缀标注真实表格行号，防止行号计算错误\r\n- 返回 colIndices 列字母映射数组，防止手数列号\r\n- 内置 maxChars 防爆保护，超限自动截断并设 hasMore=true\r\n- 支持 valueRenderOption 选择返回格式化展示值、原始值或公式文本", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet csv-get --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:E5\"", "dws sheet csv-get --node \u003cNODE_ID\u003e" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_range_as_csv" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_range_as_csv", "parameter_count": 5, "parameters": { "max-chars": { "description": "CSV 最大字符数 (默认 200000)", "interface_description": "CSV 文本最大字符数（默认 200000）。超出时截断并设 hasMore=true。", "interface_type": "number", "property": "maxChars", "required": false, "type": "integer" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "读取范围，A1 表示法 (不传则读取全部非空数据)", "format": "a1-range", "interface_description": "A1 表示法（可选）。不传时读取全部非空数据。支持 {sheetId}!A1:D10 格式。", "property": "range", "required": false, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称", "interface_description": "工作表 ID 或名称（可选）。不传时默认读取第一个工作表。", "property": "sheetId", "required": false, "type": "string" }, "value-render-option": { "description": "取值模式: formatted_value | raw_value | formula", "interface_description": "formatted_value（默认，格式化展示值）| raw_value（原始值）| formula（公式文本，无公式时回退原始值）", "property": "valueRenderOption", "required": false, "type": "string" } }, "path": "sheet.get_range_as_csv", "primary_cli_path": "sheet csv-get", "product_id": "sheet", "reviewed": true, "risk": "low", "source": "hardcoded:sheet", "title": "以 CSV 格式读取工作表数据", "use_when": [ "需要 CSV 文本而非 JSON 二维数组时读取 range" ] }, "sheet.group_dimension": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-dimension-operations.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "对钉钉表格指定工作表中的连续整行或整列创建分组", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要对钉钉表格指定工作表中的连续整行或整列创建分组时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.group_dimension", "cli_name": "group-dimension", "cli_path": "sheet group-dimension", "confirmation": "not_required", "description": "对钉钉表格指定工作表中的连续整行或整列创建分组。\n\n--range 使用整行/整列范围：\n 行分组：3:7 或 3\n 列分组：C:F 或 C\n\n支持在 --range 中携带工作表前缀（如 \"Sheet1!3:7\" / \"Sheet1!C:F\"），此时将忽略 --sheet-id。\n创建后可通过 sheet info --include groups 回读 rowGroups / columnGroups。\n\n--group-state 支持 expand / fold，默认 expand。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet group-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"3:7\"", "dws sheet group-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"C:F\" --group-state fold" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "group_dimension", "parameter_count": 4, "parameters": { "group-state": { "default": "expand", "description": "创建后的分组状态: expand 或 fold", "property": "groupState", "required": false, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "整行/整列范围 (必填)，如 \"3:7\" 或 \"C:F\"", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.group_dimension", "primary_cli_path": "sheet group-dimension", "product_id": "sheet", "reviewed": false, "risk": "low", "source": "hardcoded:sheet", "title": "对指定连续行/列创建分组", "use_when": [ "创建行分组/创建列分组/折叠几行/折叠几列/取消行列分组；创建分组", "创建行分组/创建列分组/折叠几行/折叠几列/展开行列分组/取消行列分组；创建分组", "创建行分组/创建列分组/折叠几行/折叠几列/展开行列分组/取消行列分组；创建并折叠" ] }, "sheet.info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.sheet.prod.json#sheet.get_sheet", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-read-data.md", "skills/mono/references/products/sheet/sheet-workbook.md", "skills/mono/references/products/sheet/sheet-write-data.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "获取指定工作表详情", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定工作表详情”" ], "canonical_path": "sheet.info", "cli_name": "info", "cli_path": "sheet info", "confirmation": "not_required", "description": "获取钉钉电子表格中指定工作表的详细信息。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位具体的工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n返回指定工作表的 ID、名称、可见性、行列数、最后非空行列位置等详细信息。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。\r\n\r\n支持的文档类型：钉钉在线电子表格。\r\n文档链接格式：https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\r\ndentryUuid 为 32 位字母数字字符串。", "display": "钉钉表格管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws sheet info --node \u003cNODE_ID\u003e", "dws sheet info --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_sheet" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "info", "parameter_count": 2, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (不传则返回第一个工作表)", "interface_description": "目标工作表的 ID 或名称（可选）。可通过 get_all_sheets 接口获取工作表的 id 或 name 参数值。如果不传，则默认获取第一个工作表的信息。", "property": "sheetId", "required": false, "type": "string" } }, "path": "sheet.info", "primary_cli_path": "sheet info", "product_id": "sheet", "risk": "low", "source": "hardcoded:sheet", "title": "get_sheet", "use_when": [ "2. 查看工作表详情（确认列结构）", "2. 查看工作表详情（行列数、最后非空位置、mergedRanges 等）", "2. 查看工作表详情（行列数、最后非空位置等）", "看工作表/有哪些工作表/表格结构；工作表详情", "读数据/看表格内容；需要查看合并单元格 / 表头合并结构" ] }, "sheet.insert_dimension": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.insert_dimension", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-dimension-operations.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "在钉钉表格指定工作表的指定位置之前（before）插入若干空行或空列。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉表格指定工作表的指定位置之前（before）插入若干空行或空列。”所述变更时不要使用" ], "canonical_path": "sheet.insert_dimension", "cli_name": "insert-dimension", "cli_path": "sheet insert-dimension", "confirmation": "not_required", "description": "在钉钉表格指定工作表的指定位置之前（before）插入若干空行或空列。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet insert-dimension --help", "dws sheet insert-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --dimension ROWS --position \"3\" --length 2" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "insert_dimension" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "insert_dimension", "parameter_count": 5, "parameters": { "dimension": { "description": "插入维度: ROWS 或 COLUMNS (必填)", "enum": [ "ROWS", "COLUMNS" ], "interface_description": "插入维度：ROWS 表示插入行，COLUMNS 表示插入列。必填。", "property": "dimension", "required": true, "type": "string" }, "length": { "description": "插入数量，正整数 (必填)，最大 5000", "format": "positive-integer", "interface_description": "要插入的行/列数量，必须为正整数（\u003e= 1）。必填。", "interface_type": "number", "property": "length", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "position": { "description": "插入位置，A1 表示法 (必填)。ROWS 时为行号如 \"3\"；COLUMNS 时为列字母如 \"A\"", "example": "1", "format": "a1-range", "interface_description": "插入位置的 A1 表示法。dimension=ROWS 时为 1-based 行号字符串，如 \"3\" 表示在第 3 行之前插入；dimension=COLUMNS 时为列字母，如 \"A\" 表示在 A 列之前插入、\"AB\" 表示在 AB 列之前插入。允许携带工作表前缀，如 \"Sheet1!3\" / \"Sheet1!A\"，此时将忽略 sheetId 参数。必填。", "property": "position", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "工作表 ID 或名称。可通过获取所有工作表接口获取 id 或 name 参数值。必填。若 position 携带 Sheet 前缀（如 Sheet1!3），以前缀为准。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.insert_dimension", "primary_cli_path": "sheet insert-dimension", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "在指定位置插入行或列", "use_when": [ "2. 在第 3 行之前插入 2 行", "3. 在 A 列之前插入 1 列", "4. 使用工作表前缀指定位置", "使用工作表前缀（忽略 --sheet-id）", "在 A 列之前插入 1 列", "在 AB 列之前插入 3 列", "在第 3 行之前插入 2 行", "插入行/插入列/在某行前插入/在某列前插入；插入行或列", "查看具体命令的完整参数说明" ] }, "sheet.list_float_images": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.list_float_images", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-media-image.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "列出钉钉电子表格指定工作表中的所有浮动图片。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出钉钉电子表格指定工作表中的所有浮动图片。”" ], "canonical_path": "sheet.list_float_images", "cli_name": "list-float-images", "cli_path": "sheet list-float-images", "confirmation": "not_required", "description": "列出钉钉电子表格指定工作表中的所有浮动图片。", "display": "钉钉表格管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws sheet list-float-images --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "list_float_images" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_float_images", "parameter_count": 2, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.list_float_images", "primary_cli_path": "sheet list-float-images", "product_id": "sheet", "reviewed": false, "risk": "low", "source": "hardcoded:sheet", "title": "获取所有浮动图片", "use_when": [ "查看浮动图片/有哪些浮动图片/浮动图片列表；列出所有浮动图片" ] }, "sheet.media_upload": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-media-image.md", "skills/mono/schema-hints/catalog-completeness.json", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "上传附件到表格", "agent_summary_source": "dws-command-surface-review", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“上传附件到表格”所述变更时不要使用" ], "canonical_path": "sheet.media_upload", "cli_name": "media-upload", "cli_path": "sheet media-upload", "confirmation": "not_required", "description": "将本地文件作为附件上传到钉钉表格（两步自动完成）。\n\n流程:\n 1. 获取附件上传凭证 (get_doc_attachment_upload_info)\n 2. HTTP PUT 上传文件到 OSS\n\n上传成功后返回 resourceId，可用于后续引用。\n--mime-type 可选，不指定时根据文件扩展名自动推断。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet media-upload --node \u003cNODE_ID\u003e --file ./report.pdf", "dws sheet media-upload --node \u003cNODE_ID\u003e --file ./data.bin --name \"数据文件.dat\" --mime-type application/octet-stream" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "is_alias": false, "name": "media_upload", "parameter_count": 4, "parameters": { "file": { "description": "本地文件路径 (必填)", "property": "file", "required": true, "type": "string" }, "mime-type": { "description": "文件 MIME 类型 (默认根据扩展名推断)", "property": "mimeType", "required": false, "type": "string" }, "name": { "description": "附件显示名称 (默认使用文件名)", "property": "name", "required": false, "type": "string" }, "node": { "description": "目标表格文档的标识，支持传入 URL 或 ID (必填)", "property": "node", "required": true, "type": "string" } }, "path": "sheet.media_upload", "primary_cli_path": "sheet media-upload", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "上传附件到表格", "use_when": [ "1. 基本用法: 上传本地文件到表格", "2. 自定义附件显示名称 (--name 指定上传后在表格中显示的名称)", "3. 指定 MIME 类型 (文件扩展名无法推断时)", "上传附件/传文件到表格/上传文件到表格/上传到表格；上传附件", "上传附件/传文件到表格/上传文件到表格/上传到表格；用户指定了上传后的名称", "上传附件到表格", "先上传图片获取 resourceUrl", "提取 nodeId 后:", "浮动图片/悬浮图片/在表格上放一张图/加个浮动的图；创建浮动图片" ] }, "sheet.merge_cells": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.merge_cells", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-style-format.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "将钉钉电子表格中指定工作表的指定区域内的单元格合并为一个或多个合并区域。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“将钉钉电子表格中指定工作表的指定区域内的单元格合并为一个或多个合并区域。”所述变更时不要使用" ], "canonical_path": "sheet.merge_cells", "cli_name": "merge-cells", "cli_path": "sheet merge-cells", "confirmation": "not_required", "description": "将钉钉电子表格中指定工作表的指定区域内的单元格合并为一个或多个合并区域。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet merge-cells --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:B3\"", "dws sheet merge-cells --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:C3\" --merge-type mergeRows" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "merge_cells" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "merge_cells", "parameter_count": 4, "parameters": { "merge-type": { "description": "合并方式: mergeAll(默认)/mergeRows/mergeColumns", "interface_description": "合并方式，可选值：mergeAll（合并所有，默认）、mergeRows（按行合并）、mergeColumns（按列合并）。不传时默认为 mergeAll。", "property": "mergeType", "required": false, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "目标单元格区域地址，如 A1:B3 (必填)", "format": "a1-range", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "工作表 ID 或名称。可通过获取所有工作表接口获取 id 或 name 参数值。必填。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.merge_cells", "primary_cli_path": "sheet merge-cells", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "合并单元格", "use_when": [ "2. 合并所有单元格（默认 mergeAll）", "3. 按行合并", "4. 按列合并", "使用带工作表前缀的范围（忽略 --sheet-id）", "合并单元格/合并/合并区域/按行合并/按列合并；合并所有单元格", "合并单元格/合并/合并区域/按行合并/按列合并；按列合并", "合并单元格/合并/合并区域/按行合并/按列合并；按行合并", "合并所有单元格（默认）", "按列合并", "按行合并" ] }, "sheet.move_dimension": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.move_dimension", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-dimension-operations.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "在钉钉表格的指定工作表中，将指定范围的行或列移动到目标位置。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉表格的指定工作表中，将指定范围的行或列移动到目标位置。”所述变更时不要使用" ], "canonical_path": "sheet.move_dimension", "cli_name": "move-dimension", "cli_path": "sheet move-dimension", "confirmation": "not_required", "description": "在钉钉表格的指定工作表中，将指定范围的行或列移动到目标位置。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet move-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --dimension ROWS --start-index 1 --end-index 1 --destination-index 4", "dws sheet move-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --dimension ROWS --start-index 1 --end-index 3 --destination-index 0" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "move_dimension" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "move_dimension", "parameter_count": 6, "parameters": { "destination-index": { "description": "目标位置，A1 表示法 (必填)", "format": "a1-range", "interface_description": "目标位置的 A1 表示法（必填）。dimension=ROWS 时为 1-based 行号如 \"5\"；dimension=COLUMNS 时为列字母如 \"E\"。源行/列将移动到该位置之前。不能落在源范围 [startIndex, endIndex] 内。", "property": "destinationIndex", "required": true, "type": "string" }, "dimension": { "description": "维度类型: ROWS 或 COLUMNS (必填)", "enum": [ "ROWS", "COLUMNS" ], "interface_description": "移动维度（必填）。ROWS 表示移动行，COLUMNS 表示移动列。", "property": "dimension", "required": true, "type": "string" }, "end-index": { "description": "源结束位置，A1 表示法 (必填)", "format": "a1-range", "interface_description": "要移动的行/列的结束位置，A1 表示法（必填）。dimension=ROWS 时为 1-based 行号如 \"4\"；dimension=COLUMNS 时为列字母如 \"C\"。必须 \u003e= startIndex。", "property": "endIndex", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" }, "start-index": { "description": "源起始位置，A1 表示法 (必填)", "format": "a1-range", "interface_description": "要移动的行/列的起始位置，A1 表示法（必填）。dimension=ROWS 时为 1-based 行号如 \"2\"；dimension=COLUMNS 时为列字母如 \"B\"。", "property": "startIndex", "required": true, "type": "string" } }, "path": "sheet.move_dimension", "primary_cli_path": "sheet move-dimension", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "移动行列", "use_when": [ "将 B~C 列移动到 E 列的位置", "将 B~C 列（共 2 列）移动到 D 列的位置", "将第 2 行移动到第 5 行的位置", "将第 2 行移动到第 5 行的位置（索引从 0 开始）", "将第 2~4 行移动到第 1 行之前", "将第 2~4 行（共 3 行）移动到第 1 行的位置（最前面）", "移动行/移动列/调整行顺序/调整列顺序/行列拖拽/把第N行移到第M行；移动行或列" ] }, "sheet.range_batch_clear": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-batch-operations.md", "skills/mono/schema-hints/runtime-surface-completeness.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "批量清除多个区域的内容或格式", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入/更新值用 sheet range update", "删除整张工作表用 sheet delete-sheet", "只清除一个区域用 sheet range clear" ], "canonical_path": "sheet.range_batch_clear", "cli_name": "batch-clear", "cli_path": "sheet range batch-clear", "confirmation": "user_required", "description": "批量清除多个区域，一次原子请求。任一区域清除失败则整批回滚。\n\n每个 --ranges 项必须包含工作表前缀（格式: \"SheetName!A1:B3\"）。\n不同区域可以属于不同工作表。", "display": "钉钉表格管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws sheet range batch-clear --node \u003cNODE_ID\u003e --ranges '[\"Sheet1!A1:B3\",\"Sheet2!C1:D5\"]'", "dws sheet range batch-clear --node \u003cNODE_ID\u003e --ranges '[\"Sheet1!A1:Z1000\"]' --type all" ], "group": "range", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "range_batch_clear", "parameter_count": 3, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "ranges": { "description": "目标区域 JSON 数组，每项带 sheet 前缀 (必填，如 '[\"Sheet1!A1:B3\"]')", "format": "a1-range", "property": "ranges", "required": true, "type": "string" }, "type": { "description": "清除类型: content(仅值,默认) / format(仅格式) / all(全部)", "property": "type", "required": false, "type": "string" } }, "path": "sheet.range_batch_clear", "primary_cli_path": "sheet range batch-clear", "product_id": "sheet", "reviewed": true, "risk": "high", "source": "hardcoded:sheet", "title": "批量清除多个区域（原子事务）", "use_when": [ "一次清除多个 range 的值、格式或全部内容" ] }, "sheet.range_batch_set_style": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-style-format.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "批量设置多个区域的单元格样式或格式", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入单元格值用 sheet range update", "只设置一个区域样式用 sheet range set-style", "清空多个区域用 sheet range batch-clear" ], "canonical_path": "sheet.range_batch_set_style", "cli_name": "batch-set-style", "cli_path": "sheet range batch-set-style", "confirmation": "not_required", "description": "对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值、超链接、数字格式等内容。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet range batch-set-style --node \u003cNODE_ID\u003e --batch ./styles.json", "dws sheet range batch-set-style --node \u003cNODE_ID\u003e --batch ./styles.json --continue-on-error" ], "group": "range", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "update_range" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "range_batch_set_style", "parameter_count": 3, "parameters": { "batch": { "description": "批次配置 JSON 文件路径 (必填)", "property": "batch", "required": true, "type": "string" }, "continue-on-error": { "description": "遇到失败时继续执行后续条目（默认遇错即停）", "property": "continueOnError", "required": false, "type": "boolean" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" } }, "path": "sheet.range_batch_set_style", "primary_cli_path": "sheet range batch-set-style", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "更新表格指定区域内容", "use_when": [ "一次更新多个 range 的样式或格式" ] }, "sheet.range_copy_to": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-range-operations.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "复制源区域到目标区域", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入新值用 sheet range update", "只读取源数据用 sheet range read", "移动并清空源区域用 sheet range move-to" ], "canonical_path": "sheet.range_copy_to", "cli_name": "copy-to", "cli_path": "sheet range copy-to", "confirmation": "not_required", "description": "将源范围的数据复制到目标位置。支持同 sheet 和跨 sheet 复制。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet range copy-to --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --source-range \"A1:C5\" --target-range \"D1\"", "dws sheet range copy-to --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --source-range \"A1:C5\" --target-range \"A1\" --target-sheet-id \"Sheet2\"" ], "group": "range", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "copy_range" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "range_copy_to", "parameter_count": 6, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "paste-type": { "description": "粘贴类型: values(仅值) / formulas(仅公式) / formats(仅格式) / all(全部,默认)", "interface_description": "粘贴内容过滤（可选）。values: 仅粘贴值；formulas: 仅粘贴公式；formats: 仅粘贴格式。不传时复制全部内容。", "property": "pasteType", "required": false, "type": "string" }, "sheet-id": { "description": "源工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" }, "source-range": { "description": "源范围，A1 表示法 (必填，如 A1:C5)", "format": "a1-range", "interface_description": "要复制的源数据范围（必填），使用 A1 表示法。例如 \"A1:C5\"。", "property": "sourceRange", "required": true, "type": "string" }, "target-range": { "description": "目标位置，A1 表示法 (必填，如 D1；支持 Sheet2!A1 表示法指定目标工作表)", "format": "a1-range", "property": "targetRange", "required": true, "type": "string" }, "target-sheet-id": { "description": "目标工作表 ID 或名称（可选，不传则复制到同一工作表）", "interface_description": "目标工作表的 ID（可选）。不传时默认复制到源所在的同一工作表。跨工作表复制时需指定此参数。", "property": "targetSheetId", "required": false, "type": "string" } }, "path": "sheet.range_copy_to", "primary_cli_path": "sheet range copy-to", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "区域复制", "use_when": [ "把一个 range 的数据复制到另一个位置" ] }, "sheet.range_move_to": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-range-operations.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "移动源区域到目标区域并清空源区域", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "只复制不清空源区域用 sheet range copy-to", "只读取数据用 sheet range read", "清空区域用 sheet range clear" ], "canonical_path": "sheet.range_move_to", "cli_name": "move-to", "cli_path": "sheet range move-to", "confirmation": "user_required", "description": "将源范围的数据移动到目标位置，源区域将被清空。支持同 sheet 和跨 sheet 移动。", "display": "钉钉表格管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws sheet range move-to --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --source-range \"A1:C5\" --target-range \"D1\"", "dws sheet range move-to --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --source-range \"A1:C5\" --target-range \"A1\" --target-sheet-id \"Sheet2\"" ], "group": "range", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "move_range" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "range_move_to", "parameter_count": 5, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "源工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" }, "source-range": { "description": "源范围，A1 表示法 (必填，如 A1:C5)", "format": "a1-range", "interface_description": "要移动的源数据范围（必填），使用 A1 表示法。例如 \"A1:C5\"。移动后源区域将被清空。", "property": "sourceRange", "required": true, "type": "string" }, "target-range": { "description": "目标位置，A1 表示法 (必填，如 D1；支持 Sheet2!A1 表示法指定目标工作表)", "format": "a1-range", "property": "targetRange", "required": true, "type": "string" }, "target-sheet-id": { "description": "目标工作表 ID 或名称（可选，不传则移动到同一工作表）", "interface_description": "目标工作表的 ID（可选）。不传时默认移动到源所在的同一工作表。跨工作表移动时需指定此参数。", "property": "targetSheetId", "required": false, "type": "string" } }, "path": "sheet.range_move_to", "primary_cli_path": "sheet range move-to", "product_id": "sheet", "reviewed": true, "risk": "high", "source": "hardcoded:sheet", "title": "区域移动", "use_when": [ "把一个 range 移动到目标位置" ] }, "sheet.range_read": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.sheet.prod.json#sheet.get_range", "skills/mono/references/intent-guide.md", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-read-data.md", "skills/mono/references/products/sheet/sheet-workbook.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "读取工作表指定区域的单元格值", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入值用 sheet range update", "清空内容/格式用 sheet range clear 或 batch-clear", "读取 CSV 格式用 sheet csv-get" ], "canonical_path": "sheet.range_read", "cli_name": "read", "cli_path": "sheet range read", "confirmation": "not_required", "description": "读取钉钉电子表格中指定工作表的指定范围数据。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 range 指定读取的单元格范围。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。不传则默认读取第一个工作表。\r\nrange 使用 A1 表示法指定单元格范围，支持带工作表前缀（如 \u003csheetId\u003e!A1:D10）。不传则默认读取该工作表的全部数据。\r\n\r\n返回指定范围内的单元格值、公式、显示值等信息。\r\n其中 values 返回公式计算后的结果值，formulas 返回原始公式，displayValues 返回界面上的显示值。\r\n所有数据均以二维数组形式返回，第一维为行，第二维为列。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。\r\n\r\n支持的文档类型：钉钉在线电子表格。\r\n文档链接格式：https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\r\ndentryUuid 为 32 位字母数字字符串。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet range read --node \u003cNODE_ID\u003e", "dws sheet range read --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e" ], "group": "range", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "get_range" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "range_read", "parameter_count": 4, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "读取范围，A1 表示法 (如 A1:D10，不传则读取全部数据)", "format": "a1-range", "interface_description": "要读取的单元格范围（可选），使用 A1 表示法。支持两种格式：1) 仅范围，如 A1:D10（此时使用 sheetId 参数指定工作表）；2) 带工作表前缀，如 {sheetId}!A1:D10（此时忽略 sheetId 参数，从 range 中解析工作表标识）。不传时默认读取目标工作表的全部非空数据。系统会自动检测工作表的实际数据范围，避免返回大量空数据。", "property": "range", "required": false, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (不传则默认第一个工作表)", "interface_description": "目标工作表的 ID 或名称（可选）。可通过 get_all_sheets 接口获取工作表的 id 或 name。不传时默认读取第一个工作表。注意：当 range 参数包含工作表前缀（如 sheetId!A1:D10）时，range 中的前缀会覆盖此参数。", "property": "sheetId", "required": false, "type": "string" }, "value-render-option": { "description": "取值模式: formatted_value(默认) | raw_value | formula", "property": "valueRenderOption", "required": false, "type": "string" } }, "path": "sheet.range_read", "primary_cli_path": "sheet range read", "product_id": "sheet", "reviewed": true, "risk": "low", "source": "hardcoded:sheet", "title": "读取工作表数据", "use_when": [ "读取某个 range 的数据或值" ] }, "sheet.range_set_style": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-style-format.md", "skills/mono/references/products/sheet/sheet-write-data.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "设置单个区域的单元格样式", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入单元格值用 sheet range update", "批量设置多个区域样式用 sheet range batch-set-style", "条件高亮用 sheet cond-format create/update" ], "canonical_path": "sheet.range_set_style", "cli_name": "set-style", "cli_path": "sheet range set-style", "confirmation": "not_required", "constraints": { "mutually_exclusive": [ [ "bg-color", "bg-colors-json" ], [ "font-size", "font-sizes-json" ], [ "h-align", "h-aligns-json" ], [ "v-align", "v-aligns-json" ], [ "font-color", "font-colors-json" ], [ "font-weight", "font-weights-json" ] ], "require_one_of": [ [ "bg-color", "bg-colors-json", "font-size", "font-sizes-json", "h-align", "h-aligns-json", "v-align", "v-aligns-json", "font-color", "font-colors-json", "font-weight", "font-weights-json", "word-wrap", "number-format" ] ] }, "description": "对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值、超链接、数字格式等内容。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet range set-style --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:B3\" --bg-color \"#FFF2CC\" --font-weight bold --h-align center", "dws sheet range set-style --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"C1:C5\" --bg-colors-json '[[\"#FF0000\"],[\"#00FF00\"],[\"#0000FF\"],[\"#FFFF00\"],[\"#FF00FF\"]]'" ], "group": "range", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "update_range" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "range_set_style", "parameter_count": 17, "parameters": { "bg-color": { "description": "背景色（#RRGGBB），一键刷整个 range；与 --bg-colors-json 二选一", "property": "bgColor", "required": false, "type": "string" }, "bg-colors-json": { "description": "背景色二维 JSON 数组，维度需与 --range 一致", "example": "[[\"#ffffff\",\"#ffffff\"],[\"#ffffff\",\"#ffffff\"]]", "format": "json", "property": "bgColorsJson", "required": false, "type": "string" }, "font-color": { "description": "字体颜色（#RRGGBB），一键刷整个 range", "property": "fontColor", "required": false, "type": "string" }, "font-colors-json": { "description": "字体颜色二维 JSON 数组", "example": "[[\"#000000\",\"#000000\"],[\"#000000\",\"#000000\"]]", "format": "json", "property": "fontColorsJson", "required": false, "type": "string" }, "font-size": { "description": "字号，一键刷整个 range；与 --font-sizes-json 二选一", "property": "fontSize", "required": false, "type": "integer" }, "font-sizes-json": { "description": "字号二维 JSON 数组，维度需与 --range 一致", "example": "[[12,12],[12,12]]", "format": "json", "property": "fontSizesJson", "required": false, "type": "string" }, "font-weight": { "description": "字体粗细（bold/normal），一键刷整个 range", "enum": [ "bold", "normal" ], "property": "fontWeight", "required": false, "type": "string" }, "font-weights-json": { "description": "字体粗细二维 JSON 数组", "example": "[[\"normal\",\"normal\"],[\"normal\",\"normal\"]]", "format": "json", "property": "fontWeightsJson", "required": false, "type": "string" }, "h-align": { "description": "水平对齐（left/center/right/general），一键刷整个 range", "enum": [ "left", "center", "right", "general" ], "property": "hAlign", "required": false, "type": "string" }, "h-aligns-json": { "description": "水平对齐二维 JSON 数组", "example": "[[\"left\",\"left\"],[\"left\",\"left\"]]", "format": "json", "property": "hAlignsJson", "required": false, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "number-format": { "description": "数字格式 code（常用 General/@/#,##0/#,##0.00/0%/0.00%/yyyy/m/d/h:mm:ss；@ 为文本，适合长数字 ID）", "interface_description": "数字格式。常用值：General（常规）、@（文本）、#,##0（数字）、#,##0.00（带小数）、0%（百分数）、yyyy/m/d（日期）、hh:mm:ss（时间）、¥#,##0（人民币）、$#,##0（美元）等。", "property": "numberFormat", "required": false, "type": "string" }, "range": { "description": "目标单元格区域地址，如 A1:B3 (必填)", "format": "a1-range", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "工作表 ID 或名称。可通过获取所有工作表接口获取 id 或 name 参数值。必填。", "property": "sheetId", "required": true, "type": "string" }, "v-align": { "description": "垂直对齐（top/middle/bottom），一键刷整个 range", "enum": [ "top", "middle", "bottom" ], "property": "vAlign", "required": false, "type": "string" }, "v-aligns-json": { "description": "垂直对齐二维 JSON 数组", "example": "[[\"top\",\"top\"],[\"top\",\"top\"]]", "format": "json", "property": "vAlignsJson", "required": false, "type": "string" }, "word-wrap": { "description": "换行方式（overflow/clip/autoWrap），整个 range 共用", "enum": [ "overflow", "clip", "autoWrap" ], "interface_description": "单元格换行方式，单值字符串，整个 range 共用（非二维数组）。取值枚举：overflow / clip / autoWrap（驼峰，非下划线）。", "property": "wordWrap", "required": false, "type": "string" } }, "path": "sheet.range_set_style", "primary_cli_path": "sheet range set-style", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "更新表格指定区域内容", "use_when": [ "设置一个 range 的字体、颜色、对齐、数字格式等样式" ] }, "sheet.range_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.sheet.prod.json#sheet.update_range", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-conditional-format.md", "skills/mono/references/products/sheet/sheet-media-image.md", "skills/mono/references/products/sheet/sheet-style-format.md", "skills/mono/references/products/sheet/sheet-workbook.md", "skills/mono/references/products/sheet/sheet-write-data.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "写入或更新工作表指定区域的单元格值/超链接", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "只改样式用 sheet range set-style 或 batch-set-style", "只读数据用 sheet range read", "清空区域用 sheet range clear" ], "canonical_path": "sheet.range_update", "cli_name": "update", "cli_path": "sheet range update", "confirmation": "not_required", "description": "对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值、超链接、数字格式等内容。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet range update --help", "dws sheet range update --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:B2\" --values '[[{\"type\":\"text\",\"text\":\"姓名\"},{\"type\":\"text\",\"text\":\"分数\"}],[{\"type\":\"text\",\"text\":\"张三\"},{\"type\":\"text\",\"text\":\"90\"}]]'" ], "group": "range", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "update_range" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "range_update", "parameter_count": 4, "parameters": { "node": { "description": "表格文档 ID (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "目标单元格区域地址，如 A1:B3 (必填)", "format": "a1-range", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "工作表 ID 或名称。可通过获取所有工作表接口获取 id 或 name 参数值。必填。", "property": "sheetId", "required": true, "type": "string" }, "values": { "description": "单元格内容，二维 JSON 数组 (必填)；每个元素必须是 object：{type:text,text:...}、{type:richText,texts:[...]}、{dataValidation:...}、{cellStyles:...}、{hyperlink:...} 或 {}（详见 --help 长描述）", "interface_description": "单元格的值，二维数组格式。行列维度需与 rangeAddress 范围一致。示例（A1:B3）：[[\"1\",\"2\"],[\"3\",\"4\"],[\"5\",\"6\"]]。可与 hyperlinks 共存，会进行合并（对于同一个单元格，hyperlinks 的优先级更高）。可插入的值类型包括：1) 字符，如 \"123\"；2) 公式，如 \"=A3+B3\"、\"=SUM(B2:B4)\"；3) null，代表清除该单元格内容（但不支持全部单元格都填充 null）。", "interface_type": "array", "property": "values", "required": true, "type": "string" } }, "path": "sheet.range_update", "primary_cli_path": "sheet range update", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "更新表格指定区域内容", "use_when": [ "向指定 range 写入二维数组值或超链接" ] }, "sheet.replace_all": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.replace_all", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-search-replace.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "在钉钉表格的指定工作表中，全局查找并替换文本内容。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉表格的指定工作表中，全局查找并替换文本内容。”所述变更时不要使用" ], "canonical_path": "sheet.replace_all", "cli_name": "replace", "cli_path": "sheet replace", "confirmation": "not_required", "description": "在钉钉表格的指定工作表中，全局查找并替换文本内容。\r\n\r\n支持以下替换选项：\r\n- matchCase：是否区分大小写（默认 false）\r\n- matchEntireCell：是否完整单元格匹配（默认 false）\r\n- useRegExp：是否使用正则表达式（默认 false）\r\n- includeHidden：是否包含隐藏行/列（默认 false）\r\n- range：限定替换范围，使用 A1 表示法（如 A1:D100），不传时在整个工作表中替换\r\n\r\n返回被替换的单元格数量。\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 filterViewId 定位筛选视图，通过 column 指定目标列。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\nfilterViewId 可通过 get_filter_views 获取。\r\n\r\n清除指定列的筛选条件后，该列不再参与筛选视图的筛选计算。\r\n此操作仅清除指定列的条件，不会删除整个筛选视图。如需删除整个筛选视图，请使用 delete_filter_view。\r\n清除操作仅影响当前筛选视图，不影响全局筛选或其他筛选视图。\r\n\r\n如果指定列没有设置筛选条件，调用此接口不会报错。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可操作。不支持跨组织操作。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet replace --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --find \"旧文本\" --replacement \"新文本\"", "dws sheet replace --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --find \"待处理\" --replacement \"已完成\" --match-entire-cell" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "replace_all" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "replace_all", "parameter_count": 9, "parameters": { "find": { "description": "查找文本 (必填)", "property": "find", "required": true, "type": "string" }, "include-hidden": { "description": "包含隐藏行/列", "interface_description": "是否包含隐藏的行和列（可选，默认 false）。", "property": "includeHidden", "required": false, "type": "boolean" }, "match-case": { "description": "区分大小写 (默认 false)", "interface_description": "是否区分大小写（可选，默认 false）。", "property": "matchCase", "required": false, "type": "boolean" }, "match-entire-cell": { "description": "完整单元格匹配", "interface_description": "是否要求文本完全匹配整个单元格内容（可选，默认 false）。", "property": "matchEntireCell", "required": false, "type": "boolean" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "替换范围，A1 表示法 (如 A1:D100)", "format": "a1-range", "interface_description": "使用 A1 表示法限定替换范围（可选），如 A1:D100。不传时在整个工作表中替换。", "property": "range", "required": false, "type": "string" }, "replacement": { "description": "替换文本 (必填，可为空字符串表示删除)", "property": "replacement", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" }, "use-regexp": { "description": "启用正则表达式匹配", "property": "useRegexp", "required": false, "type": "boolean" } }, "path": "sheet.replace_all", "primary_cli_path": "sheet replace", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "全局查找替换", "use_when": [ "替换/查找替换/全局替换/批量替换/把A替换成B/把所有的X改成Y；删除匹配内容", "替换/查找替换/全局替换/批量替换/把A替换成B/把所有的X改成Y；查找替换", "替换/查找替换/全局替换/批量替换/把A替换成B/把所有的X改成Y；正则替换", "替换/查找替换/全局替换/批量替换/把A替换成B/把所有的X改成Y；精确匹配后替换（只替换内容完全等于的单元格）" ] }, "sheet.set_dropdown_lists": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-dropdown.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "设置单元格下拉列表配置", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除下拉配置用 sheet delete-dropdown", "只查询下拉配置用 sheet get-dropdown", "设置条件格式用 sheet cond-format create" ], "canonical_path": "sheet.set_dropdown_lists", "cli_name": "set-dropdown", "cli_path": "sheet set-dropdown", "confirmation": "not_required", "description": "在钉钉表格的指定单元格范围内设置下拉列表。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet set-dropdown --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A2:A100\" --options '[{\"value\":\"选项1\"},{\"value\":\"选项2\"},{\"value\":\"选项3\"}]'", "dws sheet set-dropdown --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"B2:B50\" --options '[{\"value\":\"高\",\"color\":\"#ff0000\"},{\"value\":\"中\",\"color\":\"#ffaa00\"},{\"value\":\"低\",\"color\":\"#00ff00\"}]' --multi-select" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "set_dropdown_lists" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "set_dropdown_lists", "parameter_count": 5, "parameters": { "multi-select": { "description": "是否允许多选（默认单选）", "property": "multiSelect", "required": false, "type": "boolean" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "options": { "description": "下拉选项 JSON 数组 (必填)，如 '[{\"value\":\"选项1\",\"color\":\"#ff0000\"}]'", "example": "[{\"value\":\"option1\"},{\"value\":\"option2\"}]", "format": "json", "interface_description": "下拉选项数组（必填），至少包含 1 个选项。每个选项包含 value（必填）和 color（可选）。选项值不能包含英文逗号。", "interface_type": "array", "property": "options", "required": true, "type": "string" }, "range": { "description": "目标单元格范围，A1 表示法，如 A2:A100 (必填)", "format": "a1-range", "interface_description": "要设置下拉列表的单元格范围（必填），A1 表示法，如 \"A2:A100\"。", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 获取。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.set_dropdown_lists", "primary_cli_path": "sheet set-dropdown", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "设置下拉列表", "use_when": [ "给指定范围配置下拉选项" ] }, "sheet.set_range_from_csv": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-write-data.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "将 CSV 文本写入工作表指定起点", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "写入 JSON 二维数组用 sheet range update", "只改样式用 sheet range set-style", "读取 CSV 用 sheet csv-get" ], "canonical_path": "sheet.set_range_from_csv", "cli_name": "csv-put", "cli_path": "sheet csv-put", "confirmation": "not_required", "description": "将 RFC 4180 格式的 CSV 文本写入指定工作表的指定单元格位置。\r\n\r\n只写纯值，不支持公式/样式/批注。=开头的内容当作文本处理，不会被解析为公式。\r\n自动扩容行列：当 CSV 数据超出当前工作表维度时，自动追加行/列。\r\n目标区域如含合并单元格，合并将被打散，值正常写入。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet csv-put --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --start-cell A1 --csv $'name,score\\nAlice,95\\nBob,87'", "dws sheet csv-put --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --start-cell B2 --csv @data.csv --allow-overwrite" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "set_range_from_csv" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "set_range_from_csv", "parameter_count": 5, "parameters": { "allow-overwrite": { "description": "允许覆盖已有数据 (默认 false)", "interface_description": "是否允许覆盖目标区域中已有数据的单元格。默认 false；设为 true 时允许覆盖非空单元格。", "property": "allowOverwrite", "required": false, "type": "boolean" }, "csv": { "description": "CSV 文本、@文件路径 或 - 表示 stdin (必填)", "interface_description": "RFC 4180 格式的 CSV 文本。只写纯值，不支持公式/样式/批注，=开头当文本处理。长度上限 2M 字符，单元格总数上限 30000。", "property": "csv", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的标识，支持两种格式：1) 工作表 ID（sheetId）；2) 工作表名称。可通过 get_all_sheets 获取。", "property": "sheetId", "required": true, "type": "string" }, "start-cell": { "description": "起始单元格，A1 表示法 (必填)", "format": "a1-range", "interface_description": "写入的起始单元格位置，A1 表示法（如 A1、B5、AA100）。CSV 数据从该单元格开始向右向下铺开，自动按 CSV 行列数推断终点。", "property": "startCell", "required": true, "type": "string" } }, "path": "sheet.set_range_from_csv", "primary_cli_path": "sheet csv-put", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "写入 CSV 数据到指定区域", "use_when": [ "把 CSV 文本导入到 sheet 指定位置" ] }, "sheet.sort_filter": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "对基础筛选范围内数据排序", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "仅更新筛选条件用 sheet filter update", "筛选视图排序/条件请使用 sheet filter-view update", "读取数据排序结果用 sheet range read" ], "canonical_path": "sheet.sort_filter", "cli_name": "sort", "cli_path": "sheet filter sort", "confirmation": "not_required", "description": "对钉钉电子表格中指定工作表的筛选范围内的数据进行排序。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n排序基于筛选范围内的指定列，支持升序和降序。\r\n排序会实际改变工作表中数据行的物理顺序。\r\n\r\n使用此接口前，工作表必须已创建筛选（通过 create_filter 创建）。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可操作。不支持跨组织操作。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet filter sort --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --column 0 --ascending", "dws sheet filter sort --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --column 2 --ascending=false" ], "group": "filter", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "sort_filter" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "sort_filter", "parameter_count": 4, "parameters": { "ascending": { "default": "true", "description": "是否升序，默认 true", "property": "ascending", "required": false, "type": "boolean" }, "column": { "description": "排序列偏移量，从 0 开始 (必填)", "property": "column", "required": true, "type": "integer" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.sort_filter", "primary_cli_path": "sheet filter sort", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "筛选排序", "use_when": [ "在普通筛选范围内设置排序" ] }, "sheet.sort_range": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.sort_range", "skills/mono/references/products/sheet/sheet-range-operations.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "对钉钉电子表格中指定工作表指定范围的数据进行排序。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“基于源数据范围自动填充到目标范围”请改用 dws sheet range fill", "要“对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值”请改用 dws sheet range batch-set-style", "要“清除钉钉电子表格中指定工作表指定范围的单元格内容、格式或全部”请改用 dws sheet range clear" ], "canonical_path": "sheet.sort_range", "cli_name": "sort", "cli_path": "sheet range sort", "confirmation": "not_required", "description": "对钉钉电子表格中指定工作表指定范围的数据进行排序。支持多级排序（按 sortKeys 数组顺序优先级递减）。column 使用字母列名（如 \"A\"、\"B\"、\"AA\"）。如果数据首行为表头，可设置跳过首行不参与排序。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet range sort --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:D10\" --sort-keys '[{\"column\":\"A\",\"ascending\":true}]'", "dws sheet range sort --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:D10\" --sort-keys '[{\"column\":\"A\",\"ascending\":true},{\"column\":\"C\",\"ascending\":false}]' --has-header" ], "group": "range", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "sort_range" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "sort_range", "parameter_count": 5, "parameters": { "has-header": { "description": "首行是否为表头（不参与排序）", "interface_description": "首行是否为表头（可选，默认 false）。为 true 时首行不参与排序。", "property": "hasHeader", "required": false, "type": "boolean" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "排序范围，A1 表示法 (必填，如 A1:D10)", "format": "a1-range", "interface_description": "要排序的单元格范围（必填），使用 A1 表示法。例如：\"A1:D10\" 表示从 A1 到 D10 的矩形区域。排序将对该范围内的行进行重排。", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" }, "sort-keys": { "description": "排序规则 JSON 数组 (必填，如 [{\"column\":\"A\",\"ascending\":true}])", "interface_description": "排序规则数组（必填），支持多级排序（按数组顺序优先级递减）。每个元素包含 column（列字母名称，如 \"A\"、\"B\"、\"AA\"）和 ascending（是否升序，默认 true）。", "interface_type": "array", "property": "sortKeys", "required": true, "type": "string" } }, "path": "sheet.sort_range", "primary_cli_path": "sheet range sort", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "区域排序", "use_when": [ "排序/给数据排序/按某列排序/升序/降序；区域排序" ] }, "sheet.submit_export_job": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.submit_export_job", "skills/mono/references/intent-guide.md", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-export.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "用于将钉钉在线表格导出为 xlsx。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“用于将钉钉在线表格导出为 xlsx。”" ], "canonical_path": "sheet.submit_export_job", "cli_name": "export", "cli_path": "sheet export", "confirmation": "not_required", "description": "用于将钉钉在线表格导出为 xlsx。导出为异步操作，提交后需使用 query_export_job 轮询任务状态并获取下载链接。", "display": "钉钉表格管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws sheet export --node \u003cNODE_ID\u003e", "dws sheet export --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\"" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "submit_export_job" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "submit_export_job", "parameter_count": 2, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "output": { "description": "本地保存路径（可选，支持文件路径或目录）", "property": "output", "required": false, "type": "string" } }, "path": "sheet.submit_export_job", "primary_cli_path": "sheet export", "product_id": "sheet", "reviewed": false, "risk": "low", "source": "hardcoded:sheet", "title": "导出钉钉表格", "use_when": [ "--output 为目录时，自动按下载链接中的文件名保存", "仅导出，返回 downloadUrl（链接有时效性，请尽快下载）", "场景 A：仅获取下载链接（命令内部自动完成提交+轮询，最终返回 downloadUrl）", "场景 B：导出并自动下载为本地文件", "场景 C：下载到目录，自动按链接推断文件名", "导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；导出表格", "导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；需要落盘到本地", "导出并自动下载为本地文件", "把这个在线表格导出为 xlsx 文件；在线表格格式转换" ] }, "sheet.template_apply": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "使用指定模板创建新表格文档", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要使用指定模板创建新表格文档时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.template_apply", "cli_name": "apply", "cli_path": "sheet template apply", "confirmation": "not_required", "description": "使用指定模板创建新表格文档。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet template apply --help" ], "group": "template", "has_parameters": true, "idempotency": "unknown", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "template_apply", "parameter_count": 4, "parameters": { "folder": { "description": "目标文件夹 ID (可选)", "property": "folder", "required": false, "type": "string" }, "name": { "description": "新表格文档名称 (可选)", "property": "name", "required": false, "type": "string" }, "template-id": { "description": "模板 ID (必填)", "property": "templateId", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (可选)", "property": "workspace", "required": false, "type": "string" } }, "path": "sheet.template_apply", "primary_cli_path": "sheet template apply", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "应用表格模板", "use_when": [ "使用指定模板创建新表格文档" ] }, "sheet.template_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "获取当前用户可用的表格模板列表，支持按来源筛选", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要获取当前用户可用的表格模板列表，支持按来源筛选时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.template_list", "cli_name": "list", "cli_path": "sheet template list", "confirmation": "not_required", "description": "获取当前用户可用的表格模板列表，支持按来源筛选。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet template list --help" ], "group": "template", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "template_list", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标", "property": "cursor", "required": false, "type": "string" }, "limit": { "description": "返回数量上限", "property": "limit", "required": false, "type": "integer" }, "source": { "description": "模板来源: MY(我的模版)/PUBLIC(公开模版)，不传默认 MY", "property": "source", "required": false, "type": "string" } }, "path": "sheet.template_list", "primary_cli_path": "sheet template list", "product_id": "sheet", "reviewed": false, "risk": "low", "source": "hardcoded:sheet", "title": "获取表格模板列表", "use_when": [ "获取当前用户可用的表格模板列表，支持按来源筛选" ] }, "sheet.template_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "根据关键词搜索表格模板", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要根据关键词搜索表格模板时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.template_search", "cli_name": "search", "cli_path": "sheet template search", "confirmation": "not_required", "description": "根据关键词搜索表格模板。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet template search --help" ], "group": "template", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "template_search", "parameter_count": 4, "parameters": { "cursor": { "description": "分页游标", "property": "cursor", "required": false, "type": "string" }, "limit": { "description": "返回数量上限", "property": "limit", "required": false, "type": "integer" }, "query": { "description": "搜索关键词 (必填)", "property": "query", "required": true, "type": "string" }, "source": { "description": "模板来源: MY(我的模版)/PUBLIC(公开模版)，不传默认 MY", "property": "source", "required": false, "type": "string" } }, "path": "sheet.template_search", "primary_cli_path": "sheet template search", "product_id": "sheet", "reviewed": false, "risk": "low", "source": "hardcoded:sheet", "title": "搜索表格模板", "use_when": [ "根据关键词搜索表格模板" ] }, "sheet.ungroup_dimension": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-dimension-operations.md", "skills/mono/schema-hints/runtime-surface-completeness.json" ], "agent_summary": "取消钉钉表格指定工作表中的连续整行或整列分组", "agent_summary_source": "runtime-surface-completeness-v1", "availability": "available", "avoid_when": [ "不需要取消钉钉表格指定工作表中的连续整行或整列分组时不要使用；如仅查询状态请优先选择对应 list/get/search 命令" ], "canonical_path": "sheet.ungroup_dimension", "cli_name": "ungroup-dimension", "cli_path": "sheet ungroup-dimension", "confirmation": "not_required", "description": "取消钉钉表格指定工作表中的连续整行或整列分组。\n\n--range 使用整行/整列范围：\n 行分组：3:7 或 3\n 列分组：C:F 或 C\n\n支持在 --range 中携带工作表前缀（如 \"Sheet1!3:7\" / \"Sheet1!C:F\"），此时将忽略 --sheet-id。\n取消后可通过 sheet info --include groups 回读 rowGroups / columnGroups。", "display": "钉钉表格管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws sheet ungroup-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"3:7\"", "dws sheet ungroup-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"C:F\"" ], "has_parameters": true, "idempotency": "idempotent", "interface_mode": "local", "interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref", "is_alias": false, "name": "ungroup_dimension", "parameter_count": 3, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "整行/整列范围 (必填)，如 \"3:7\" 或 \"C:F\"", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.ungroup_dimension", "primary_cli_path": "sheet ungroup-dimension", "product_id": "sheet", "reviewed": false, "risk": "low", "source": "hardcoded:sheet", "title": "取消指定连续行/列分组", "use_when": [ "创建行分组/创建列分组/折叠几行/折叠几列/取消行列分组；取消分组", "创建行分组/创建列分组/折叠几行/折叠几列/展开行列分组/取消行列分组；取消分组" ] }, "sheet.unmerge_range": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.unmerge_range", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-style-format.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "取消钉钉表格指定工作表中指定范围内的合并单元格。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“取消钉钉表格指定工作表中指定范围内的合并单元格。”所述变更时不要使用" ], "canonical_path": "sheet.unmerge_range", "cli_name": "unmerge-cells", "cli_path": "sheet unmerge-cells", "confirmation": "not_required", "description": "取消钉钉表格指定工作表中指定范围内的合并单元格。\r\n\r\n通过 rangeAddress 参数指定要取消合并的范围，使用 A1 表示法（如 A1:D5）。\r\n该范围内所有合并的单元格都会被取消合并，恢复为独立的单元格。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet unmerge-cells --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:D5\"" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "unmerge_range" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "unmerge_range", "parameter_count": 3, "parameters": { "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "取消合并的范围，A1 表示法，如 A1:D5 (必填)", "format": "a1-range", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.unmerge_range", "primary_cli_path": "sheet unmerge-cells", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "取消合并单元格", "use_when": [ "取消合并/拆分单元格/还原合并；取消合并单元格" ] }, "sheet.update_cond_format": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet/sheet-conditional-format.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "更新条件格式规则", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "删除规则用 sheet cond-format delete", "新建规则用 sheet cond-format create", "静态设置样式用 sheet range set-style" ], "canonical_path": "sheet.update_cond_format", "cli_name": "update", "cli_path": "sheet cond-format update", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "ranges", "condition", "cell-style", "data-bar-style" ] ] }, "description": "更新指定工作表中的一条条件格式规则。未传入的字段将保持原有值不变。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet cond-format update --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --rule-id \u003cRULE_ID\u003e --condition '{\"numberCondition\":{\"operator\":\"greater\",\"value1\":\"90\"}}'", "dws sheet cond-format update --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --rule-id \u003cRULE_ID\u003e --cell-style '{\"backgroundColor\":\"#C8E6C9\",\"fontColor\":\"#1B5E20\"}'" ], "group": "cond-format", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "update_cond_format" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_cond_format", "parameter_count": 7, "parameters": { "cell-style": { "description": "单元格样式 JSON 对象 (可选)", "example": "{\"backgroundColor\":\"#FFCDD2\",\"bold\":true}", "format": "json", "interface_description": "条件命中时应用的单元格样式。", "interface_type": "object", "property": "cellStyle", "required": false, "type": "string" }, "condition": { "description": "条件类型及参数 JSON 对象 (可选)，传入后替换原有条件类型", "example": "{\"numberCondition\":{\"operator\":\"greater\",\"value1\":\"80\"}}", "format": "json", "property": "condition", "required": false, "type": "string" }, "data-bar-style": { "description": "数据条样式 JSON 对象 (可选，仅数据条类型)", "format": "json", "interface_description": "数据条的显示样式配置。仅 dataBarCondition 类型时有效。", "interface_type": "object", "property": "dataBarStyle", "required": false, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "ranges": { "description": "应用范围 JSON 数组 (可选)，如 '[\"A1:E10\"]'", "example": "[\"A1:B2\"]", "format": "json", "interface_description": "条件格式规则的应用范围（可选）。", "interface_type": "array", "property": "ranges", "required": false, "type": "string" }, "rule-id": { "description": "条件格式规则 ID (必填)", "interface_description": "要更新的条件格式规则 ID（必填）。", "property": "ruleId", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.update_cond_format", "primary_cli_path": "sheet cond-format update", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "更新条件格式规则", "use_when": [ "修改已有条件格式规则" ] }, "sheet.update_dimension": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.update_dimension", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-dimension-operations.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "批量更新钉钉表格指定工作表中连续多行/多列的属性，支持设置显隐状态（hidden）与行高/列宽（pixelSize）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“批量更新钉钉表格指定工作表中连续多行/多列的属性，支持设置显隐状态（hidden）与行高/列宽（pixelSize）。”所述变更时不要使用" ], "canonical_path": "sheet.update_dimension", "cli_name": "update-dimension", "cli_path": "sheet update-dimension", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "hidden", "pixel-size" ] ] }, "description": "批量更新钉钉表格指定工作表中连续多行/多列的属性，支持设置显隐状态（hidden）与行高/列宽（pixelSize）。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet update-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --dimension ROWS --start-index \"3\" --length 2 --hidden", "dws sheet update-dimension --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --dimension COLUMNS --start-index \"A\" --length 2 --hidden=false" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "update_dimension" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_dimension", "parameter_count": 7, "parameters": { "dimension": { "description": "更新维度: ROWS 或 COLUMNS (必填)", "enum": [ "ROWS", "COLUMNS" ], "interface_description": "更新维度：ROWS 表示行（对应行高/行显隐），COLUMNS 表示列（对应列宽/列显隐）。必填。", "property": "dimension", "required": true, "type": "string" }, "hidden": { "description": "是否隐藏 (true=隐藏, false=显示)", "interface_description": "是否隐藏，true 表示隐藏、false 表示显示。与 pixelSize 至少填其一。可选。", "property": "hidden", "required": false, "type": "boolean" }, "length": { "description": "更新数量，正整数 (必填)，最大 5000", "format": "positive-integer", "interface_description": "要更新的连续行/列数量，必须为正整数（\u003e= 1），行列均最多 5000。必填。", "interface_type": "number", "property": "length", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "pixel-size": { "description": "行高或列宽（像素），ROWS 时为行高，COLUMNS 时为列宽", "interface_description": "行高或列宽，单位为像素（px），必须为非负整数。dimension=ROWS 时表示行高，dimension=COLUMNS 时表示列宽。与 hidden 至少填其一。可选。", "interface_type": "number", "property": "pixelSize", "required": false, "type": "integer" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "工作表 ID 或名称。可通过获取所有工作表接口获取 id 或 name 参数值。必填。若 startIndex 携带 Sheet 前缀（如 Sheet1!3），以前缀为准。", "property": "sheetId", "required": true, "type": "string" }, "start-index": { "description": "起始位置，A1 表示法 (必填)。ROWS 时为行号如 \"3\"；COLUMNS 时为列字母如 \"A\"", "example": "1", "format": "a1-range", "interface_description": "起始位置的 A1 表示法。dimension=ROWS 时为 1-based 行号字符串，如 \"3\" 表示从第 3 行开始；dimension=COLUMNS 时为列字母，如 \"A\" 表示从 A 列开始、\"AB\" 表示从 AB 列开始。从该位置起的连续 length 行/列将被更新。允许携带工作表前缀，如 \"Sheet1!3\" / \"Sheet1!A\"，此时将忽略 sheetId 参数。必填。", "property": "startIndex", "required": true, "type": "string" } }, "path": "sheet.update_dimension", "primary_cli_path": "sheet update-dimension", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "更新行列属性", "use_when": [ "2. 隐藏第 3~4 行", "3. 显示 A~B 列", "4. 设置第 1~5 行行高为 40px", "5. 设置 C 列列宽为 200px 并隐藏", "使用工作表前缀（忽略 --sheet-id）", "显示 A~B 列", "设置 C 列列宽为 200px 并隐藏", "设置第 1~5 行行高为 40px", "隐藏第 3~4 行", "隐藏行/隐藏列/显示行/显示列/设置行高/设置列宽/调整行高/调整列宽/行列属性；同时修改尺寸与显隐", "隐藏行/隐藏列/显示行/显示列/设置行高/设置列宽/调整行高/调整列宽/行列属性；设置行高/列宽", "隐藏行/隐藏列/显示行/显示列/设置行高/设置列宽/调整行高/调整列宽/行列属性；隐藏/显示行或列" ] }, "sheet.update_filter": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "更新工作表基础筛选条件", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "仅排序筛选范围用 sheet filter sort", "清除某列筛选条件用 sheet filter clear-criteria", "管理筛选视图条件用 sheet filter-view update-criteria" ], "canonical_path": "sheet.update_filter", "cli_name": "update", "cli_path": "sheet filter update", "confirmation": "not_required", "description": "批量更新钉钉电子表格中指定工作表的筛选条件。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\n\r\n可同时更新多列的筛选条件，支持三种筛选类型：\r\n- 按值筛选（filterType: values）：指定允许显示的值列表，未在列表中的值将被隐藏\r\n- 按条件筛选（filterType: condition）：指定条件运算符和比较值\r\n- 按颜色筛选（filterType: color）：按单元格背景色或字体颜色筛选\r\n\r\n使用此接口前，工作表必须已创建筛选（通过 create_filter 创建）。\r\n此接口会替换指定列的现有筛选条件，未指定的列保持不变。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可操作。不支持跨组织操作。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet filter update --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --criteria '[{\"column\":0,\"filterType\":\"values\",\"visibleValues\":[\"已完成\",\"进行中\"]},{\"column\":2,\"filterType\":\"condition\",\"conditions\":[{\"operator\":\"greater\",\"value\":\"50\"}]}]'", "dws sheet filter update --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --criteria '[{\"column\":1,\"filterType\":\"color\",\"backgroundColor\":\"#FF0000\"}]'" ], "group": "filter", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "update_filter" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_filter", "parameter_count": 3, "parameters": { "criteria": { "description": "筛选条件 JSON 数组 (必填)", "interface_description": "批量设置多列的筛选条件（必填）。数组格式，每个元素包含 column（列偏移量，0-based）和筛选条件字段。示例：[{\"column\":0,\"filterType\":\"values\",\"visibleValues\":[\"A\",\"B\"]}]", "interface_type": "array", "property": "criteria", "required": true, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.update_filter", "primary_cli_path": "sheet filter update", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "更新筛选", "use_when": [ "批量设置普通筛选的筛选条件" ] }, "sheet.update_filter_view": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-filter-view.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json", "skills/mono/schema-hints/zz-sheet-range-filter-review.json" ], "agent_summary": "更新筛选视图属性和范围", "agent_summary_source": "sheet-range-filter-agent-review-v1", "availability": "available", "avoid_when": [ "创建新筛选视图用 sheet filter-view create", "删除筛选视图用 sheet filter-view delete", "只改某列筛选条件用 sheet filter-view update-criteria" ], "canonical_path": "sheet.update_filter_view", "cli_name": "update", "cli_path": "sheet filter-view update", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "name", "range", "criteria" ] ] }, "description": "更新钉钉电子表格中指定工作表的筛选视图属性（名称、范围和/或筛选条件）。\r\n\r\n通过 nodeId 定位电子表格文档，通过 sheetId 定位工作表，通过 filterViewId 定位筛选视图。\r\nnodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\nsheetId 支持传入工作表 ID 或工作表名称，可通过 get_all_sheets 获取。\r\nfilterViewId 可通过 get_filter_views 获取。\r\n\r\n可更新筛选视图的名称、范围和筛选条件，至少需要传入一个更新字段。\r\n通过 criteria 参数可直接批量更新多列的筛选条件，指定列的条件会被替换，未指定的列保持不变。\r\n\r\n仅限用户对文档具备\"可编辑\"权限时可操作。不支持跨组织操作。", "display": "钉钉表格管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws sheet filter-view update --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e --name \"新名称\"", "dws sheet filter-view update --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e --range \"A1:F20\"" ], "group": "filter-view", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "update_filter_view" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_filter_view", "parameter_count": 6, "parameters": { "criteria": { "description": "筛选条件，JSON 数组", "interface_description": "需要更新的列筛选条件（可选）。数组格式，每个元素包含 column（列偏移量，0-based）和筛选条件字段。示例：[{\"column\":0,\"filterType\":\"values\",\"visibleValues\":[\"A\",\"B\"]}]", "interface_type": "array", "property": "criteria", "required": false, "type": "string" }, "filter-view-id": { "description": "筛选视图 ID (必填)", "interface_description": "要更新的筛选视图 ID（必填）。可通过 get_filter_views 接口获取。", "property": "filterViewId", "required": true, "type": "string" }, "name": { "description": "筛选视图新名称", "interface_description": "新的筛选视图名称（可选，name、range、criteria 至少传一个）。", "property": "name", "required": false, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "筛选视图新范围，A1 表示法", "format": "a1-range", "interface_description": "新的筛选视图范围（可选，name、range、criteria 至少传一个），使用 A1 表示法。", "property": "range", "required": false, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" } }, "path": "sheet.update_filter_view", "primary_cli_path": "sheet filter-view update", "product_id": "sheet", "reviewed": true, "risk": "medium", "source": "hardcoded:sheet", "title": "更新筛选视图", "use_when": [ "修改筛选视图名称、范围或整体配置" ] }, "sheet.update_float_image": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.update_float_image", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-media-image.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "更新钉钉电子表格中指定浮动图片的属性。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新钉钉电子表格中指定浮动图片的属性。”所述变更时不要使用" ], "canonical_path": "sheet.update_float_image", "cli_name": "update-float-image", "cli_path": "sheet update-float-image", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "src", "range", "width", "height", "offset-x", "offset-y" ] ] }, "description": "更新钉钉电子表格中指定浮动图片的属性。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet update-float-image --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --float-image-id \u003cFI_ID\u003e --range C5", "dws sheet update-float-image --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --float-image-id \u003cFI_ID\u003e --width 600 --height 400" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "update_float_image" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_float_image", "parameter_count": 9, "parameters": { "float-image-id": { "description": "浮动图片 ID (必填)", "interface_description": "浮动图片 ID（必填）。可通过 list_float_images 接口获取。", "property": "floatImageId", "required": true, "type": "string" }, "height": { "description": "新的图片高度，像素", "interface_description": "新的图片高度（可选），单位像素，正整数。", "interface_type": "number", "property": "height", "required": false, "type": "integer" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "offset-x": { "description": "新的水平偏移量，像素", "interface_description": "新的水平偏移量（可选），单位像素。", "interface_type": "number", "property": "offsetX", "required": false, "type": "integer" }, "offset-y": { "description": "新的垂直偏移量，像素", "interface_description": "新的垂直偏移量（可选），单位像素。", "interface_type": "number", "property": "offsetY", "required": false, "type": "integer" }, "range": { "description": "新的锚点单元格，A1 表示法", "format": "a1-range", "interface_description": "新的锚点单元格位置（可选），使用 A1 表示法，如 \"A1\"、\"B3\"。", "property": "range", "required": false, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" }, "src": { "description": "新的图片资源路径，通过 media-upload 获取的 resourceUrl", "interface_description": "新的图片 URL 地址（可选）。", "property": "src", "required": false, "type": "string" }, "width": { "description": "新的图片宽度，像素", "interface_description": "新的图片宽度（可选），单位像素，正整数。", "interface_type": "number", "property": "width", "required": false, "type": "integer" } }, "path": "sheet.update_float_image", "primary_cli_path": "sheet update-float-image", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "更新浮动图片", "use_when": [ "替换图片（需先 media-upload 新图片获取 resourceUrl）", "移动浮动图片/调整浮动图片大小/修改浮动图片/更新浮动图片；更新浮动图片属性", "移动浮动图片到新位置", "调整尺寸" ] }, "sheet.update_sheet": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.update_sheet", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-workbook.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "更新钉钉电子表格中指定工作表的属性，包括名称、位置、可见性、冻结行列等。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新钉钉电子表格中指定工作表的属性，包括名称、位置、可见性、冻结行列等。”所述变更时不要使用" ], "canonical_path": "sheet.update_sheet", "cli_name": "update", "cli_path": "sheet update", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "name", "index", "hidden", "frozen-row-count", "frozen-column-count", "tab-color" ] ] }, "description": "更新钉钉电子表格中指定工作表的属性，包括名称、位置、可见性、冻结行列等。", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet update --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --title \"汇总表\" --frozen-row-count 2 --frozen-column-count 1", "dws sheet update --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --hidden=true" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "update_sheet" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_sheet", "parameter_count": 9, "parameters": { "frozen-column-count": { "description": "冻结列数，0 表示取消冻结", "interface_description": "冻结的列数（可选）。0 表示取消冻结。", "interface_type": "number", "property": "frozenColumnCount", "required": false, "type": "integer" }, "frozen-row-count": { "description": "冻结行数，0 表示取消冻结", "interface_description": "冻结的行数（可选）。0 表示取消冻结。", "interface_type": "number", "property": "frozenRowCount", "required": false, "type": "integer" }, "hidden": { "description": "是否隐藏工作表 (true=隐藏, false=显示)", "interface_description": "是否隐藏工作表（可选）。true 隐藏，false 显示。", "property": "hidden", "required": false, "type": "boolean" }, "index": { "description": "工作表新位置索引，0-based", "interface_description": "工作表的新位置索引（可选，0-based）。0 表示移到最前面。", "interface_type": "number", "property": "index", "required": false, "type": "integer" }, "name": { "description": "工作表新名称，最长 100 字符", "property": "name", "required": false, "type": "string" }, "node": { "description": "表格文档 ID 或 URL (必填)", "property": "node", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "目标工作表的 ID 或名称（必填）。可通过 get_all_sheets 接口获取工作表的 id 或 name。", "property": "sheetId", "required": true, "type": "string" }, "tab-color": { "description": "工作表标签颜色，Hex 格式如 #FF0000；传空字符串清除颜色", "interface_description": "工作表标签颜色（可选）。Hex 格式如 #FF0000（6位 RGB）或 #FF0000FF（8位 ARGB）。传空字符串表示清除颜色。", "property": "tabColor", "required": false, "type": "string" }, "title": { "description": "--name 的别名（兼容）", "interface_description": "工作表的新名称（可选）。最长 100 字符。如果新名称与已有工作表重名，系统会自动在名称后追加后缀（如 \"-1\"）以避免冲突。", "property": "title", "required": false, "type": "string" } }, "path": "sheet.update_sheet", "primary_cli_path": "sheet update", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "更新工作表属性", "use_when": [ "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；冻结行列", "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；取消冻结", "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；显示工作表", "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；更新工作表属性", "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；移动工作表位置", "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；重命名工作表", "修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；隐藏工作表", "取消冻结", "改名 + 调整冻结", "显示工作表", "移动工作表到第一个位置", "隐藏工作表" ] }, "sheet.write_image": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.sheet.write_image", "skills/mono/references/products/sheet.md", "skills/mono/references/products/sheet/sheet-media-image.md", "skills/mono/schema-hints/selection-review.json" ], "agent_summary": "在钉钉表格的指定单元格中插入图片。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "仅需查询状态或预览结果、不应产生“在钉钉表格的指定单元格中插入图片。”所述变更时不要使用" ], "canonical_path": "sheet.write_image", "cli_name": "write-image", "cli_path": "sheet write-image", "confirmation": "not_required", "description": "在钉钉表格的指定单元格中插入图片。\r\n\r\n通过 nodeId 定位表格文件，通过 sheetId 和 rangeAddress 定位目标单元格区域，\r\n将图片资源写入到指定位置。图片资源需要先获取 resourceId 和 resourceUrl。\r\n\r\n使用流程：\r\n1. 先获取上传凭证（uploadUrl、resourceId、resourceUrl）\r\n2. 使用 HTTP PUT 请求将图片文件上传到 uploadUrl\r\n3. 调用本接口，传入 resourceId 和 resourceUrl，在指定单元格中插入图片", "display": "钉钉表格管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws sheet write-image --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range A1:A1 --file ./chart.png", "dws sheet write-image --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range B2:B2 --file ./logo.png --width 200 --height 100" ], "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "sheet", "rpc_name": "write_image" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "write_image", "parameter_count": 8, "parameters": { "file": { "description": "本地图片文件路径 (必填)", "property": "file", "required": true, "type": "string" }, "height": { "description": "图片显示高度 (可选)", "interface_description": "显示的图片高度", "interface_type": "number", "property": "height", "required": false, "type": "integer" }, "mime-type": { "description": "文件 MIME 类型 (默认根据扩展名推断)", "property": "mimeType", "required": false, "type": "string" }, "name": { "description": "图片显示名称 (默认使用文件名)", "property": "name", "required": false, "type": "string" }, "node": { "description": "目标表格文档的标识，支持传入 URL 或 ID (必填)", "property": "node", "required": true, "type": "string" }, "range": { "description": "目标单元格区域地址，如 A1:B3 (必填)", "format": "a1-range", "property": "range", "required": true, "type": "string" }, "sheet-id": { "description": "工作表 ID 或名称 (必填)", "interface_description": "工作表 ID 或名称。可通过获取所有工作表接口获取 id 或 name 参数值。必填。", "property": "sheetId", "required": true, "type": "string" }, "width": { "description": "图片显示宽度 (可选)", "interface_description": "显示的图片宽度", "interface_type": "number", "property": "width", "required": false, "type": "integer" } }, "path": "sheet.write_image", "primary_cli_path": "sheet write-image", "product_id": "sheet", "reviewed": false, "risk": "medium", "source": "hardcoded:sheet", "title": "单元格写入图片", "use_when": [ "1. 基本用法: 写入图片到指定单元格", "2. 指定显示尺寸", "3. 自定义图片名称", "写入图片/插入图片/加图片/放图片到单元格/嵌入图片到表格；写入图片", "写入图片/插入图片/加图片/放图片到单元格/嵌入图片到表格；用户指定了图片尺寸", "提取 nodeId 后:" ] }, "todo.add_task_executors": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.todo.add_task_executors", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "添加待办执行人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办提醒”请改用 dws todo task add-reminder" ], "canonical_path": "todo.add_task_executors", "cli_name": "add-executor", "cli_path": "todo task add-executor", "confirmation": "not_required", "description": "添加待办执行人", "display": "待办任务管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws todo task add-executor --task-id \u003ctaskId\u003e --executors \u003cUSER_ID_1\u003e,\u003cUSER_ID_2\u003e", "dws todo task add-executor --task-id \u003ctaskId\u003e --executors userId1,userId2 --format json" ], "group": "task", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "add_task_executors" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_task_executors", "parameter_count": 2, "parameters": { "executors": { "description": "执行者 userId 列表 (必填)", "property": "todoExecutorsAddRequest.executorIds", "required": true, "type": "string" }, "task-id": { "description": "待办任务 ID (必填)", "property": "todoExecutorsAddRequest.taskId", "required": true, "type": "string" } }, "path": "todo.add_task_executors", "primary_cli_path": "todo task add-executor", "product_id": "todo", "reviewed": false, "risk": "medium", "source": "runtime:todo", "title": "add_task_executors", "use_when": [ "10. 添加待办执行人", "加个执行人/添加执行者" ] }, "todo.add_task_participants": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.todo.add_task_participants", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "添加待办参与人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办执行人”请改用 dws todo task add-executor", "要“添加待办提醒”请改用 dws todo task add-reminder" ], "canonical_path": "todo.add_task_participants", "cli_name": "add-participant", "cli_path": "todo task add-participant", "confirmation": "not_required", "description": "添加待办参与人", "display": "待办任务管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws todo task add-participant --task-id \u003ctaskId\u003e --participants \u003cUSER_ID_1\u003e,\u003cUSER_ID_2\u003e", "dws todo task add-participant --task-id \u003ctaskId\u003e --participants userId1,userId2 --format json" ], "group": "task", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "add_task_participants" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_task_participants", "parameter_count": 2, "parameters": { "participants": { "description": "参与人 userId 列表 (必填)", "property": "todoParticipantsAddRequest.participantIds", "required": true, "type": "string" }, "task-id": { "description": "待办任务 ID (必填)", "property": "todoParticipantsAddRequest.taskId", "required": true, "type": "string" } }, "path": "todo.add_task_participants", "primary_cli_path": "todo task add-participant", "product_id": "todo", "reviewed": false, "risk": "medium", "source": "runtime:todo", "title": "add_task_participants", "use_when": [ "12. 添加待办参与人", "加个参与人/添加参与者" ] }, "todo.add_todo_attachment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.todo.add_todo_attachment", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "添加待办任务附件", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor", "要“添加待办提醒”请改用 dws todo task add-reminder" ], "canonical_path": "todo.add_todo_attachment", "cli_name": "add-attachment", "cli_path": "todo task add-attachment", "confirmation": "not_required", "description": "添加待办任务附件", "display": "待办任务管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws todo task add-attachment --task-id \u003ctaskId\u003e --file-path /path/to/file.pdf", "dws todo task add-attachment --task-id \u003ctaskId\u003e --file-path /path/to/file.pdf --format json" ], "group": "task", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "add_todo_attachment" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_todo_attachment", "parameter_count": 2, "parameters": { "file-path": { "description": "本地文件路径（必填）", "property": "filePath", "required": true, "type": "string" }, "task-id": { "description": "待办任务 ID (必填)", "property": "taskId", "required": true, "type": "string" } }, "path": "todo.add_todo_attachment", "primary_cli_path": "todo task add-attachment", "product_id": "todo", "reviewed": false, "risk": "medium", "source": "hardcoded:todo", "title": "添加待办任务附件", "use_when": [ "18. 上传附件（真实上传，先确认待办存在）— 从返回 result.attachmentIds 取 attachmentId" ] }, "todo.add_todo_comment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.todo.add_todo_comment", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "给待办添加评论", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除待办的评论”请改用 dws todo comment delete", "要“获取待办的评论”请改用 dws todo comment list" ], "canonical_path": "todo.add_todo_comment", "cli_name": "add", "cli_path": "todo comment add", "confirmation": "not_required", "description": "给待办添加评论", "display": "待办任务管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws todo comment add --task-id \u003ctaskId\u003e --content \"评论内容\"", "dws todo comment add --task-id \u003ctaskId\u003e --content \"已开始处理\" --format json" ], "group": "comment", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "add_todo_comment" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_todo_comment", "parameter_count": 2, "parameters": { "content": { "description": "评论内容 (必填)", "interface_description": "评论的内容", "property": "content", "required": true, "type": "string" }, "task-id": { "description": "待办任务 ID (必填)", "interface_description": "待办的标识id", "property": "taskId", "required": true, "type": "string" } }, "path": "todo.add_todo_comment", "primary_cli_path": "todo comment add", "product_id": "todo", "reviewed": false, "risk": "medium", "source": "runtime:todo", "title": "add_todo_comment", "use_when": [ "7. 给待办新增评论", "给待办加条评论/留个备注" ] }, "todo.add_todo_reminder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.todo.add_todo_reminder", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "添加待办提醒", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.add_todo_reminder", "cli_name": "add-reminder", "cli_path": "todo task add-reminder", "confirmation": "not_required", "description": "添加待办提醒", "display": "待办任务管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws todo task add-reminder --task-id \u003ctaskId\u003e --base-time dueTime --due-date-offset -30", "dws todo task add-reminder --task-id \u003ctaskId\u003e --base-time customTime --reminder-time-stamp \"2026-03-10T18:00:00+08:00\"" ], "group": "task", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "add_todo_reminder" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_todo_reminder", "parameter_count": 4, "parameters": { "base-time": { "description": "提醒基准时间: dueTime/customTime (必填)", "property": "todoReminderAddRequest.baseTime", "required": true, "type": "string" }, "due-date-offset": { "description": "截止时间偏移量，为整数 (baseTime=dueTime 时必填)", "property": "todoReminderAddRequest.dueDateOffset", "required": false, "type": "string" }, "reminder-time-stamp": { "description": "自定义提醒时间 ISO-8601 (如 2026-03-10T18:00:00+08:00，baseTime=customTime 时必填)", "format": "date-time", "property": "todoReminderAddRequest.reminderTimeStamp", "required": false, "type": "string" }, "task-id": { "description": "待办任务 ID (必填)", "property": "todoReminderAddRequest.taskId", "required": true, "type": "string" } }, "path": "todo.add_todo_reminder", "primary_cli_path": "todo task add-reminder", "product_id": "todo", "reviewed": false, "risk": "medium", "source": "runtime:todo", "title": "add_todo_reminder", "use_when": [ "14. 添加待办提醒（基于截止时间偏移，待办必须有截止时间）", "15. 添加待办提醒（自定义时间戳）", "给待办加个提醒/设置提醒" ] }, "todo.create_personal_sub_todo": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.todo.create_personal_sub_todo", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "在当前企业组织内创建一条个人待办的子待办事项（要求父待办必须是操作者本人创建），支持设置标题、执行人列表、截止时间、优先级（如高/中/低）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.create_personal_sub_todo", "cli_name": "create-sub", "cli_path": "todo task create-sub", "confirmation": "not_required", "description": "在当前企业组织内创建一条个人待办的子待办事项（要求父待办必须是操作者本人创建），支持设置标题、执行人列表、截止时间、优先级（如高/中/低）。待办将归属于当前用户，并对有权限的协作者可见。子待办不支持设置单独的循环规则（遵循父待办的循环规则）。", "display": "待办任务管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws todo task create-sub --parent-id \u003cPARENT_TASK_ID\u003e --title \"子任务标题\" --executors \u003cUSER_ID_1\u003e,\u003cUSER_ID_2\u003e --priority 40", "dws todo task create-sub --parent-id \u003cPARENT_TASK_ID\u003e --title \"子任务标题\" --executors \u003cUSER_ID\u003e --due \"2026-03-20T10:00:00+08:00\"" ], "group": "task", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "create_personal_sub_todo" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_personal_sub_todo", "parameter_count": 6, "parameters": { "due": { "description": "截止时间 ISO-8601 (如 2026-03-10T18:00:00+08:00)", "format": "date-time", "property": "PersonalTodoCreateVO.dueTime", "required": false, "type": "string" }, "executors": { "description": "执行者 userId 列表 (必填)", "property": "PersonalTodoCreateVO.executorIds", "required": true, "type": "string" }, "parent-id": { "description": "父待办任务 ID (必填)", "property": "PersonalTodoCreateVO.parentId", "required": true, "type": "string" }, "priority": { "description": "优先级: 10低/20普通/30较高/40紧急", "property": "PersonalTodoCreateVO.priority", "required": false, "type": "string" }, "recurrence": { "description": "循环待办 (需先设置 --due); 格式: DTSTART:20260320T100000Z\\nRRULE:FREQ=DAILY;INTERVAL=1", "property": "PersonalTodoCreateVO.recurrence", "required": false, "type": "string" }, "title": { "description": "子待办标题 (必填)", "property": "PersonalTodoCreateVO.subject", "required": true, "type": "string" } }, "path": "todo.create_personal_sub_todo", "primary_cli_path": "todo task create-sub", "product_id": "todo", "reviewed": false, "risk": "medium", "source": "runtime:todo", "title": "create_personal_sub_todo", "use_when": [ "1c. 创建子待办（需先获取父待办 ID）", "加个子任务/创建子待办" ] }, "todo.create_personal_todo": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.todo.prod.json#todo.create_personal_todo", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建待办", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.create_personal_todo", "cli_name": "create", "cli_path": "todo task create", "confirmation": "not_required", "description": "在当前企业组织内创建一条个人待办事项，支持设置标题、执行人列表（UserId）、截止时间、优先级（如高/中/低）。待办将归属于当前用户，并对有权限的协作者可见。", "display": "待办任务管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws todo task create --title \"修复线上Bug\" --executors \u003cUSER_ID_1\u003e,\u003cUSER_ID_2\u003e --priority 40", "dws todo task create --title \"每日站会\" --executors \u003cUSER_ID\u003e --due \"2026-03-20T10:00:00+08:00\" --recurrence \"DTSTART:20260320T020000Z\\nRRULE:FREQ=DAILY;INTERVAL=1\"" ], "group": "task", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "create_personal_todo" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_personal_todo", "parameter_count": 5, "parameters": { "due": { "description": "截止时间 ISO-8601 (如 2026-03-10T18:00:00+08:00)", "format": "date-time", "property": "due", "required": false, "type": "string" }, "executors": { "description": "执行者 userId 列表 (必填)", "property": "executors", "required": true, "type": "string" }, "priority": { "description": "优先级: 10低/20普通/30较高/40紧急", "property": "priority", "required": false, "type": "string" }, "recurrence": { "description": "循环待办 (需先设置 --due); 格式: DTSTART:20260320T100000Z\\nRRULE:FREQ=DAILY;INTERVAL=1", "property": "recurrence", "required": false, "type": "string" }, "title": { "description": "待办标题 (必填)", "property": "title", "required": true, "type": "string" } }, "path": "todo.create_personal_todo", "primary_cli_path": "todo task create", "product_id": "todo", "risk": "medium", "source": "hardcoded:todo", "title": "创建个人待办", "use_when": [ "1. 创建待办 — 从返回 result.taskId 提取任务 ID", "1b. 创建按天循环的待办（必须先有 --due；recurrence 与 MCP create_personal_todo 一致）", "加个待办/记一下/TODO", "每天重复/循环待办/按天重复" ] }, "todo.delete_todo": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.todo.prod.json#todo.delete_todo", "skills/mono/SKILL.md", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除待办", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.delete_todo", "cli_name": "delete", "cli_path": "todo task delete", "confirmation": "user_required", "description": "删除待办（所有执行者都删除）", "display": "待办任务管理", "effect": "destructive", "effect_source": "skill-explicit", "examples": [ "dws todo task delete --task-id \u003ctaskId\u003e" ], "group": "task", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "delete_todo" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_todo", "parameter_count": 1, "parameters": { "task-id": { "description": "待办任务 ID (必填)", "interface_description": "taskId", "property": "taskId", "required": true, "type": "string" } }, "path": "todo.delete_todo", "primary_cli_path": "todo task delete", "product_id": "todo", "risk": "high", "source": "hardcoded:todo", "title": "delete_todo", "use_when": [ "6. 删除待办", "删除待办/取消待办" ] }, "todo.delete_todo_comment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.todo.delete_todo_comment", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "删除待办的评论", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“给待办添加评论”请改用 dws todo comment add", "要“获取待办的评论”请改用 dws todo comment list" ], "canonical_path": "todo.delete_todo_comment", "cli_name": "delete", "cli_path": "todo comment delete", "confirmation": "user_required", "description": "删除待办的评论", "display": "待办任务管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws todo comment delete --task-id \u003ctaskId\u003e --comment-id \u003ccommentId\u003e" ], "group": "comment", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "delete_todo_comment" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_todo_comment", "parameter_count": 2, "parameters": { "comment-id": { "description": "评论 ID (必填)", "interface_description": "评论的标识id", "property": "commentId", "required": true, "type": "string" }, "task-id": { "description": "待办任务 ID (必填)", "interface_description": "待办的标识id", "property": "taskId", "required": true, "type": "string" } }, "path": "todo.delete_todo_comment", "primary_cli_path": "todo comment delete", "product_id": "todo", "reviewed": false, "risk": "high", "source": "runtime:todo", "title": "delete_todo_comment", "use_when": [ "9. 删除待办评论", "删除这条评论" ] }, "todo.get_todo_detail": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.todo.prod.json#todo.get_todo_detail", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "待办详情", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.get_todo_detail", "cli_name": "get", "cli_path": "todo task get", "confirmation": "not_required", "description": "查询待办详情，用户必须是待办的创建者或者执行者才有权限查看。", "display": "待办任务管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws todo task get --task-id \u003ctaskId\u003e", "dws todo task get --task-id \u003ctaskId\u003e --format json" ], "group": "task", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "get_todo_detail" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_todo_detail", "parameter_count": 1, "parameters": { "task-id": { "description": "待办任务 ID (必填)", "interface_description": "待办的标识 id", "property": "taskId", "required": true, "type": "string" } }, "path": "todo.get_todo_detail", "primary_cli_path": "todo task get", "product_id": "todo", "risk": "low", "source": "hardcoded:todo", "title": "带鉴权的查询待办详情", "use_when": [ "3. 查看待办详情", "看看待办详情" ] }, "todo.get_user_todos_in_current_org": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.todo.get_user_todos_in_current_org", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取当前用户在所属组织中的个人待办事项列表，返回每项待办的标题、截止日期、优先级（如高/中/低）、完成状态。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.get_user_todos_in_current_org", "cli_name": "list", "cli_path": "todo task list", "confirmation": "not_required", "description": "获取当前用户在所属组织中的个人待办事项列表，返回每项待办的标题、截止日期、优先级（如高/中/低）、完成状态。", "display": "待办任务管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws todo task list --page 1 --size 20 --status false", "dws todo task list --page 1 --size 20 --status false --format json" ], "group": "task", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "get_user_todos_in_current_org" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_user_todos_in_current_org", "parameter_count": 7, "parameters": { "page": { "default": "1", "description": "页码（默认 1）", "property": "page", "required": false, "type": "string" }, "plan-finish-date-end": { "description": "截止时间范围查询结束 ISO-8601 (如 2026-03-10T18:00:00+08:00)", "format": "date-time", "interface_description": "查询计划结束时间在此时间之前的数据, 13位时间戳，单位毫秒", "interface_type": "number", "property": "planFinishDateEnd", "required": false, "type": "string" }, "plan-finish-date-start": { "description": "截止时间范围查询开始 ISO-8601 (如 2026-03-10T18:00:00+08:00)", "format": "date-time", "interface_description": "查询计划结束时间在此时间之后的数据，13位时间戳，单位毫秒", "interface_type": "number", "property": "planFinishDateStart", "required": false, "type": "string" }, "priority": { "description": "优先级: 10 低/20 普通/30 较高/40 紧急", "property": "priority", "required": false, "type": "string" }, "role-types": { "description": "角色类型: creator/executor/participant", "interface_description": "角色列表执行人(executor)，创建人(creator)，参与人(participant)", "interface_type": "array", "property": "roleTypes", "required": false, "type": "string" }, "size": { "default": "20", "description": "获取数量，超过 20 自动分页 (默认 20)", "property": "size", "required": false, "type": "string" }, "status": { "description": "true=已完成, false=未完成", "property": "status", "required": false, "type": "string" } }, "path": "todo.get_user_todos_in_current_org", "primary_cli_path": "todo task list", "product_id": "todo", "reviewed": false, "risk": "low", "source": "hardcoded:todo", "title": "get_user_todos_in_current_org", "use_when": [ "2. 查看未完成待办", "看看待办/我有啥要做" ] }, "todo.list_todo_comment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.todo.list_todo_comment", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取待办的评论", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“删除待办的评论”请改用 dws todo comment delete", "要“给待办添加评论”请改用 dws todo comment add" ], "canonical_path": "todo.list_todo_comment", "cli_name": "list", "cli_path": "todo comment list", "confirmation": "not_required", "description": "获取待办的评论", "display": "待办任务管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws todo comment list --task-id \u003ctaskId\u003e", "dws todo comment list --task-id \u003ctaskId\u003e --page 1 --size 20" ], "group": "comment", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "list_todo_comment" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_todo_comment", "parameter_count": 3, "parameters": { "page": { "default": "1", "description": "页码 (默认 1)", "interface_description": "页码", "property": "page", "required": false, "type": "string" }, "size": { "default": "20", "description": "每页数量 (默认 20)", "interface_description": "每页显示多少条", "property": "pageSize", "required": false, "type": "string" }, "task-id": { "description": "待办任务 ID (必填)", "interface_description": "待办的标识 id", "property": "taskId", "required": true, "type": "string" } }, "path": "todo.list_todo_comment", "primary_cli_path": "todo comment list", "product_id": "todo", "reviewed": false, "risk": "low", "source": "runtime:todo", "title": "list_todo_comment", "use_when": [ "8. 查看待办评论列表", "看看这个待办的评论" ] }, "todo.remove_task_executors": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.todo.remove_task_executors", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "移除待办执行人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.remove_task_executors", "cli_name": "remove-executor", "cli_path": "todo task remove-executor", "confirmation": "user_required", "description": "移除待办执行人", "display": "待办任务管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws todo task remove-executor --task-id \u003ctaskId\u003e --executors \u003cUSER_ID_1\u003e,\u003cUSER_ID_2\u003e", "dws todo task remove-executor --task-id \u003ctaskId\u003e --executors userId1 --format json" ], "group": "task", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "remove_task_executors" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_task_executors", "parameter_count": 2, "parameters": { "executors": { "description": "执行者 userId 列表 (必填)", "property": "todoExecutorsRemoveRequest.executorIds", "required": true, "type": "string" }, "task-id": { "description": "待办任务 ID (必填)", "property": "todoExecutorsRemoveRequest.taskId", "required": true, "type": "string" } }, "path": "todo.remove_task_executors", "primary_cli_path": "todo task remove-executor", "product_id": "todo", "reviewed": false, "risk": "high", "source": "runtime:todo", "title": "remove_task_executors", "use_when": [ "11. 移除待办执行人", "移除执行人/删除执行者" ] }, "todo.remove_task_participants": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.todo.remove_task_participants", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "移除待办参与人", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.remove_task_participants", "cli_name": "remove-participant", "cli_path": "todo task remove-participant", "confirmation": "user_required", "description": "移除待办参与人", "display": "待办任务管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws todo task remove-participant --task-id \u003ctaskId\u003e --participants \u003cUSER_ID_1\u003e,\u003cUSER_ID_2\u003e", "dws todo task remove-participant --task-id \u003ctaskId\u003e --participants userId1 --format json" ], "group": "task", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "remove_task_participants" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_task_participants", "parameter_count": 2, "parameters": { "participants": { "description": "参与人 userId 列表 (必填)", "property": "todoParticipantsRemoveRequest.participantIds", "required": true, "type": "string" }, "task-id": { "description": "待办任务 ID (必填)", "property": "todoParticipantsRemoveRequest.taskId", "required": true, "type": "string" } }, "path": "todo.remove_task_participants", "primary_cli_path": "todo task remove-participant", "product_id": "todo", "reviewed": false, "risk": "high", "source": "runtime:todo", "title": "remove_task_participants", "use_when": [ "13. 移除待办参与人", "移除参与人/删除参与者" ] }, "todo.reset_todo_reminder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.todo.reset_todo_reminder", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "重置待办提醒", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.reset_todo_reminder", "cli_name": "reset-reminder", "cli_path": "todo task reset-reminder", "confirmation": "not_required", "description": "重置待办提醒", "display": "待办任务管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws todo task reset-reminder --task-id \u003ctaskId\u003e", "dws todo task reset-reminder --task-id \u003ctaskId\u003e --reminder-rules '[{\"dueDateOffset\":-30,\"baseTime\":\"dueTime\"},{\"reminderTimeStamp\":\"2026-03-10T18:00:00+08:00\",\"baseTime\":\"customTime\"}]'" ], "group": "task", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "reset_todo_reminder" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "reset_todo_reminder", "parameter_count": 2, "parameters": { "reminder-rules": { "description": "提醒规则 JSON 数组 (可选，为空则清除提醒)", "property": "todoReminderUpdateRequest.reminderRules", "required": false, "type": "string" }, "task-id": { "description": "待办任务 ID (必填)", "property": "todoReminderUpdateRequest.taskId", "required": true, "type": "string" } }, "path": "todo.reset_todo_reminder", "primary_cli_path": "todo task reset-reminder", "product_id": "todo", "reviewed": false, "risk": "medium", "source": "runtime:todo", "title": "reset_todo_reminder", "use_when": [ "16. 重置待办提醒", "17. 重置待办提醒（指定新规则）", "重置提醒/清除提醒/修改提醒规则" ] }, "todo.update_todo_done_status": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.todo.prod.json#todo.update_todo_done_status", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "修改执行者的待办完成状态", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.update_todo_done_status", "cli_name": "done", "cli_path": "todo task done", "confirmation": "not_required", "description": "修改执行者的待办完成状态", "display": "待办任务管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws todo task done --task-id \u003ctaskId\u003e --status true", "dws todo task done --task-id \u003ctaskId\u003e --status false" ], "group": "task", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "update_todo_done_status" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_todo_done_status", "parameter_count": 2, "parameters": { "status": { "description": "完成状态: true=已完成, false=未完成 (必填)", "property": "status", "required": true, "type": "string" }, "task-id": { "description": "待办任务 ID (必填)", "interface_description": "待办任务唯一标识id。指定需要修改哪个待办", "property": "taskId", "required": true, "type": "string" } }, "path": "todo.update_todo_done_status", "primary_cli_path": "todo task done", "product_id": "todo", "risk": "medium", "source": "hardcoded:todo", "title": "修改执行者的待办完成状态", "use_when": [ "5. 标记待办完成", "做完了/完成待办/标记完成" ] }, "todo.update_todo_task": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.todo.prod.json#todo.update_todo_task", "skills/mono/references/products/todo.md", "skills/mono/schema-hints/imported/wukong.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "修改待办任务", "agent_summary_source": "dws-wukong-envelope@4574f7022c32", "availability": "available", "avoid_when": [ "要“添加待办任务附件”请改用 dws todo task add-attachment", "要“添加待办参与人”请改用 dws todo task add-participant", "要“添加待办执行人”请改用 dws todo task add-executor" ], "canonical_path": "todo.update_todo_task", "cli_name": "update", "cli_path": "todo task update", "confirmation": "not_required", "description": "修改整个待办任务", "display": "待办任务管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws todo task update --task-id \u003ctaskId\u003e --title \"新标题\"", "dws todo task update --task-id \u003ctaskId\u003e --priority 40 --due \"2026-03-10T18:00:00+08:00\"" ], "group": "task", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "todo", "rpc_name": "update_todo_task" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_todo_task", "parameter_count": 5, "parameters": { "done": { "description": "完成状态: true/false", "property": "done", "required": false, "type": "string" }, "due": { "description": "截止时间 ISO-8601 (如 2026-03-10T18:00:00+08:00)", "format": "date-time", "property": "due", "required": false, "type": "string" }, "priority": { "description": "优先级: 10低/20普通/30较高/40紧急", "property": "priority", "required": false, "type": "string" }, "task-id": { "description": "待办任务 ID (必填)", "property": "taskId", "required": true, "type": "string" }, "title": { "description": "新标题", "property": "title", "required": false, "type": "string" } }, "path": "todo.update_todo_task", "primary_cli_path": "todo task update", "product_id": "todo", "risk": "medium", "source": "hardcoded:todo", "title": "修改整个待办任务", "use_when": [ "4. 修改待办信息", "改个待办/修改待办标题/改优先级" ] }, "wiki.add_member": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.add_member", "skills/mono/references/products/doc.md", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "为知识库添加指定角色的成员。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“从知识库中移除指定的企业用户成员（仅支持 USER 类型）”请改用 dws wiki member remove", "要“修改成员在知识库中的角色”请改用 dws wiki member update", "要“查询知识库当前的成员权限列表，支持按角色过滤”请改用 dws wiki member list" ], "canonical_path": "wiki.add_member", "cli_name": "add", "cli_path": "wiki member add", "confirmation": "not_required", "description": "为知识库添加指定角色的成员。\r\n\r\n支持添加用户（USER）成员类型。\r\n添加成功后，被授权的成员即可按指定角色访问该知识库下的所有内容。\r\n\r\n适用场景：\r\n- 新员工入职，需要授予知识库访问权限。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口添加，知识库创建者默认为所有者。\r\n- 操作者需具备知识库的 OWNER 或 MANAGER 权限。\r\n- 单次请求最多传 30 个成员，超出需分批调用。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws wiki member add --help", "dws wiki member add --workspace \u003cWS_ID\u003e --users uid1 --role READER" ], "group": "member", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "wiki", "rpc_name": "add_member" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_member", "parameter_count": 3, "parameters": { "role": { "description": "权限角色: MANAGER / EDITOR / DOWNLOADER / READER (必填，大小写不敏感)", "property": "role", "required": true, "type": "string" }, "users": { "description": "被添加的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)", "property": "users", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID 或 URL (必填)", "property": "workspace", "required": true, "type": "string" } }, "path": "wiki.add_member", "primary_cli_path": "wiki member add", "product_id": "wiki", "reviewed": false, "risk": "medium", "source": "hardcoded:wiki", "title": "添加知识库成员", "use_when": [ "2. 添加成员", "把知识库分享给某人/给某人加入知识库/邀请进知识库", "查看具体命令的完整参数说明" ] }, "wiki.create_file": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.create_file", "skills/mono/references/intent-guide.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表或文件夹）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等）”请改用 dws wiki node list", "要“将指定节点复制到目标文件夹”请改用 dws wiki node copy", "要“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将”请改用 dws wiki node delete" ], "canonical_path": "wiki.create_file", "cli_name": "create", "cli_path": "wiki node create", "confirmation": "not_required", "description": "在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表或文件夹）。\r\n\r\n支持三种创建位置（按优先级）：\r\n1. 指定 folderId：在该文件夹下创建\r\n2. 仅指定 workspaceId（不传 folderId）：在该知识库的根目录下创建\r\n3. 都不传：在用户\"我的文档\"根目录下创建\r\n4. type 要创建的文件类型，必填。支持以下值：adoc（钉钉在线文档）、axls（钉钉表格）、appt（钉钉演示）、adraw（钉钉白板）、amind（钉钉脑图）、able（钉钉多维表）、folder（文件夹）\r\n操作受权限控制，仅当调用者对目标位置有写入权限时可成功创建。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws wiki node create --workspace \u003cworkspaceId\u003e --name \"新文档\" --format json", "dws wiki node create --workspace \u003cworkspaceId\u003e --name \"方案目录\" --type folder --format json" ], "group": "node", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "create_file" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_file", "parameter_count": 4, "parameters": { "folder": { "description": "父节点 nodeId (选填，不传则在根目录创建)", "property": "folder", "required": false, "type": "string" }, "name": { "description": "节点名称 (必填)", "interface_description": "新文件的名称，必填。", "property": "name", "required": true, "type": "string" }, "type": { "default": "adoc", "description": "节点类型: adoc / axls / able / appt / adraw / amind / folder（asheet 不支持）", "interface_description": "要创建的文件类型，必填。支持：adoc（钉钉在线文档）、axls（钉钉表格）、appt（钉钉演示）、adraw（钉钉白板）、amind（钉钉脑图）、able（钉钉多维表）、folder（文件夹）。同时兼容旧版 accessType 数字字符串：\"0\"=adoc、\"1\"=axls、\"2\"=appt、\"3\"=adraw、\"6\"=amind、\"7\"=able、\"13\"=folder。", "property": "type", "required": false, "type": "string" }, "workspace": { "description": "知识库 ID (必填)", "property": "workspace", "required": true, "type": "string" } }, "path": "wiki.create_file", "primary_cli_path": "wiki node create", "product_id": "wiki", "reviewed": false, "risk": "medium", "source": "hardcoded:wiki", "title": "创建节点", "use_when": [ "1. 创建文档节点", "2. 创建文件夹", "3. 在指定文件夹下创建", "在知识库里创建一个文档；创建空文件实体", "在知识库里创建文档/新建文件夹" ] }, "wiki.create_wikiSpace": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.create_wikiSpace", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "创建一个新的钉钉文档知识库（WikiSpace）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“将指定知识库移入回收站”请改用 dws wiki space delete", "要“获取当前用户有权访问的知识库列表，支持按类型区分”请改用 dws wiki space list", "要“获取指定知识库的详细信息，包括名称、描述、创建者、创建时间、成员”请改用 dws wiki space get" ], "canonical_path": "wiki.create_wikiSpace", "cli_name": "create", "cli_path": "wiki space create", "confirmation": "not_required", "description": "创建一个新的钉钉文档知识库（WikiSpace）。\r\n知识库是组织内文档的核心容器，可在其中创建文档、文件夹等内容。\r\n创建成功后返回新知识库的 workspaceId，可用于后续在该知识库下创建文档（create_document）或遍历文件（list_nodes）。\r\n操作受权限控制，仅当调用者具备在当前组织内创建知识库的权限时可成功创建。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws wiki space create --name \"产品文档库\" --format json", "dws wiki space create --name \"技术方案\" --desc \"团队技术方案归档\" --format json" ], "group": "space", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "wiki", "rpc_name": "create_wikiSpace" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_wikiSpace", "parameter_count": 3, "parameters": { "desc": { "description": "知识库描述 (选填，不超过 500 字符)", "property": "desc", "required": false, "type": "string" }, "icon": { "description": "知识库图标标识 (选填)", "property": "icon", "required": false, "type": "string" }, "name": { "description": "知识库名称 (必填，不超过 100 字符)", "interface_description": "知识库名称，不超过32个字符", "property": "name", "required": true, "type": "string" } }, "path": "wiki.create_wikiSpace", "primary_cli_path": "wiki space create", "product_id": "wiki", "reviewed": false, "risk": "medium", "source": "hardcoded:wiki", "title": "创建知识库", "use_when": [ "创建知识库", "创建知识库/新建知识库" ] }, "wiki.delete_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.delete_document", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等）”请改用 dws wiki node list", "要“在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表”请改用 dws wiki node create", "要“将指定节点复制到目标文件夹”请改用 dws wiki node copy" ], "canonical_path": "wiki.delete_document", "cli_name": "delete", "cli_path": "wiki node delete", "confirmation": "user_required", "description": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。\r\n\r\n支持范围：\r\n- 知识库（workspace）下的文档节点、文件夹节点\r\n- 钉盘「我的文件」或「团队空间（space）」下的文件、文件夹节点（但钉盘操作仍建议走钉盘MCP服务）\r\n\r\n不支持的操作：\r\n- 不支持直接删除知识库本身（workspace）\r\n- 不支持直接删除团队空间（space）\r\n\r\n权限要求：\r\n- 对目标节点有管理权限（owner 或被授予管理权限的成员）\r\n\r\n注意事项：\r\n- 删除操作不可立即撤销，请在调用前向用户确认\r\n- 删除文件夹时，文件夹内的所有子节点也会一并移入回收站", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws wiki node delete --workspace \u003cworkspaceId\u003e --node \u003cnodeId\u003e" ], "group": "node", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "delete_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_document", "parameter_count": 2, "parameters": { "node": { "description": "节点 ID (必填)", "property": "node", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (必填，用于权限校验)", "property": "workspace", "required": true, "type": "string" } }, "path": "wiki.delete_document", "primary_cli_path": "wiki node delete", "product_id": "wiki", "reviewed": false, "risk": "high", "source": "hardcoded:wiki", "title": "删除节点", "use_when": [ "删除知识库里的文档/节点", "删除节点（会要求确认）" ] }, "wiki.delete_wikiSpace": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.delete_wikiSpace", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "将指定知识库移入回收站。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个新的钉钉文档知识库（WikiSpace）”请改用 dws wiki space create", "要“获取当前用户有权访问的知识库列表，支持按类型区分”请改用 dws wiki space list", "要“获取指定知识库的详细信息，包括名称、描述、创建者、创建时间、成员”请改用 dws wiki space get" ], "canonical_path": "wiki.delete_wikiSpace", "cli_name": "delete", "cli_path": "wiki space delete", "confirmation": "user_required", "description": "将指定知识库移入回收站。\r\n\r\n通过 workspaceId 定位知识库，支持传入知识库 ID 或知识库 URL，系统自动识别。\r\n删除后知识库会进入回收站，可在回收站中恢复。\r\n\r\n知识库 URL 格式：https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview\r\nworkspaceId 为字母数字字符串。\r\n\r\n注意事项：\r\n- **权限要求**：操作者必须具备知识库的「所有者（OWNER）」角色。\r\n- 删除操作不可逆（从回收站恢复除外），请确认后再执行。\r\n- 不支持跨组织删除。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws wiki space delete --workspace \u003cworkspaceId\u003e", "dws wiki space delete --workspace \"https://alidocs.dingtalk.com/i/spaces/xxx/overview\"" ], "group": "space", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "wiki", "rpc_name": "delete_wikiSpace" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_wikiSpace", "parameter_count": 1, "parameters": { "workspace": { "description": "知识库 ID 或 URL (必填)", "property": "workspace", "required": true, "type": "string" } }, "path": "wiki.delete_wikiSpace", "primary_cli_path": "wiki space delete", "product_id": "wiki", "reviewed": false, "risk": "high", "source": "hardcoded:wiki", "title": "删除知识库", "use_when": [ "2. 删除知识库", "删除知识库/移除知识库/把知识库删了" ] }, "wiki.get_wikiSpace": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.get_wikiSpace", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取指定知识库的详细信息，包括名称、描述、创建者、创建时间、成员数量等。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个新的钉钉文档知识库（WikiSpace）”请改用 dws wiki space create", "要“将指定知识库移入回收站”请改用 dws wiki space delete", "要“获取当前用户有权访问的知识库列表，支持按类型区分”请改用 dws wiki space list" ], "canonical_path": "wiki.get_wikiSpace", "cli_name": "get", "cli_path": "wiki space get", "confirmation": "not_required", "description": "获取指定知识库的详细信息，包括名称、描述、创建者、创建时间、成员数量等。\r\n通过 workspaceId 定位知识库，支持传入知识库 ID 或知识库 URL，系统自动识别。\r\n知识库 URL 格式：https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overviewworkspaceId 为字母数字字符串。\r\n仅限用户对该知识库具备\"可阅读\"权限时可获取。不支持跨组织查询。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws wiki space get --help", "dws wiki space get --workspace \u003cworkspaceId\u003e --format json" ], "group": "space", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "wiki", "rpc_name": "get_wikiSpace" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_wikiSpace", "parameter_count": 1, "parameters": { "workspace": { "description": "知识库 ID 或 URL (必填)", "property": "workspace", "required": true, "type": "string" } }, "path": "wiki.get_wikiSpace", "primary_cli_path": "wiki space get", "product_id": "wiki", "reviewed": false, "risk": "low", "source": "hardcoded:wiki", "title": "获取知识库", "use_when": [ "1. 确认知识库信息", "查看具体命令的完整参数说明", "查看知识库/知识库详情", "查看知识库详情" ] }, "wiki.list_member": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.list_member", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "查询知识库当前的成员权限列表，支持按角色过滤。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库添加指定角色的成员”请改用 dws wiki member add", "要“从知识库中移除指定的企业用户成员（仅支持 USER 类型）”请改用 dws wiki member remove", "要“修改成员在知识库中的角色”请改用 dws wiki member update" ], "canonical_path": "wiki.list_member", "cli_name": "list", "cli_path": "wiki member list", "confirmation": "not_required", "description": "查询知识库当前的成员权限列表，支持按角色过滤。\r\n\r\n适用场景：\r\n- 获取知识库成员角色列表。\r\n\r\n每条记录包含成员的类型、名称及其角色信息。\r\n\r\n注意：\r\n- 底层接口一次性返回全量成员，不支持服务端游标分页。\r\n- 出参中包含 totalCount（全量成员总数）和 truncated（是否被截断）。当 truncated=true 时，说明知识库实际成员数超过 maxResults，建议通过 filterRoleIds 收窄查询范围；若仍超出 maxResults 上限，请引导用户去前端管理界面查看完整列表。\r\n- ORG 类型授权不会出现在查询结果中。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws wiki member list --workspace \u003cWS_ID\u003e", "dws wiki member list --workspace \u003cWS_ID\u003e --limit 100" ], "group": "member", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "wiki", "rpc_name": "list_member" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_member", "parameter_count": 3, "parameters": { "filter-role": { "description": "按角色过滤（逗号分隔）：OWNER / MANAGER / EDITOR / DOWNLOADER / READER", "property": "filterRole", "required": false, "type": "string" }, "limit": { "default": "30", "description": "返回成员数上限，默认 30，最大 200", "property": "limit", "required": false, "type": "integer" }, "workspace": { "description": "知识库 ID 或 URL (必填)", "property": "workspace", "required": true, "type": "string" } }, "path": "wiki.list_member", "primary_cli_path": "wiki member list", "product_id": "wiki", "reviewed": false, "risk": "low", "source": "hardcoded:wiki", "title": "查询知识库成员列表", "use_when": [ "1. 查看当前成员（只返回 name/role/type，拿不到 userId）", "3. 查看当前成员", "知识库有哪些成员/查看知识库成员" ] }, "wiki.list_nodes": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.list_nodes", "skills/mono/references/intent-guide.md", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等），支持分页。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表”请改用 dws wiki node create", "要“将指定节点复制到目标文件夹”请改用 dws wiki node copy", "要“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将”请改用 dws wiki node delete" ], "canonical_path": "wiki.list_nodes", "cli_name": "list", "cli_path": "wiki node list", "confirmation": "not_required", "description": "列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等），支持分页。\r\n\r\n返回结果基于当前 MCP 会话用户的可访问权限进行过滤。\r\n返回的节点列表包含多种类型：在线文档、文件夹、PDF、docx、表格、脑图、白板等。\r\n\r\n定位方式（按优先级）：\r\n1. 传 folderId：列出该文件夹下的直接子节点\r\n2. 仅传 workspaceId（不传 folderId）：列出该知识库根目录下的直接子节点\r\n3. 都不传：列出用户\"我的文档\"根目录下的直接子节点\r\n\r\n返回的 nodeId 可直接用于其他工具（如 get_document_content、update_document、create_document 等）。\r\n若 nodeType=folder 且 hasChildren=true，可将该 nodeId 作为 folderId 再次调用本工具进行递归遍历。\r\n若 contentType=alidoc，可调用 get_document_content(nodeId=nodeId) 获取文档内容。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws wiki node list --workspace \u003cworkspaceId\u003e --format json", "dws wiki node list --workspace \u003cworkspaceId\u003e --folder \u003cparentNodeId\u003e --format json" ], "group": "node", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_nodes" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_nodes", "parameter_count": 4, "parameters": { "cursor": { "description": "分页游标", "property": "cursor", "required": false, "type": "string" }, "folder": { "description": "父节点 nodeId (选填，不传则列出根目录)", "property": "folder", "required": false, "type": "string" }, "limit": { "description": "每页数量 (默认 50，最大 50)", "property": "limit", "required": false, "type": "integer" }, "workspace": { "description": "知识库 ID (必填)", "property": "workspace", "required": true, "type": "string" } }, "path": "wiki.list_nodes", "primary_cli_path": "wiki node list", "product_id": "wiki", "reviewed": false, "risk": "low", "source": "hardcoded:wiki", "title": "列出指定文件夹或知识库下的直接子节点列表", "use_when": [ "2. 列出根目录节点", "3. 进入子目录", "帮我看看知识库里的文件；知识库节点列表", "知识库下的文件/知识库里有哪些文档/浏览知识库内容", "读某个知识库里的某篇文档" ] }, "wiki.list_wikiSpaces": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.list_wikiSpaces", "skills/mono/references/intent-guide.md", "skills/mono/references/products/drive.md", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "获取当前用户有权访问的知识库列表，支持按类型区分。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个新的钉钉文档知识库（WikiSpace）”请改用 dws wiki space create", "要“将指定知识库移入回收站”请改用 dws wiki space delete", "要“获取指定知识库的详细信息，包括名称、描述、创建者、创建时间、成员”请改用 dws wiki space get" ], "canonical_path": "wiki.list_wikiSpaces", "cli_name": "list", "cli_path": "wiki space list", "confirmation": "not_required", "description": "获取当前用户有权访问的知识库列表，支持按类型区分。\r\n\r\n通过 wikiSpaceType 参数控制返回范围：\r\n- myWikiSpace：返回当前用户的「我的文档」个人空间（固定返回 1 条，不支持分页）\r\n- orgWikiSpace（默认）：返回当前用户在组织内有权访问的知识库列表，支持分页\r\n\r\n返回结果包含知识库 ID、名称、描述、访问链接等信息。\r\n返回的 workspaceId 可直接用于其他工具（如 get_wikiSpace、create_document、list_nodes 等）。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws wiki space list --format json # 组织知识库（默认）", "dws wiki space list --type myWikiSpace --format json # 我的文档" ], "group": "space", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "wiki", "rpc_name": "list_wikiSpaces" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_wikiSpaces", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标 (首页留空)", "property": "cursor", "required": false, "type": "string" }, "limit": { "description": "每页数量 1-50 (默认 20)", "property": "limit", "required": false, "type": "string" }, "type": { "default": "orgWikiSpace", "description": "空间类型: orgWikiSpace(默认) / myWikiSpace / orgSpace(钉盘企业空间) / mySpace(钉盘我的文件)", "property": "type", "required": false, "type": "string" } }, "path": "wiki.list_wikiSpaces", "primary_cli_path": "wiki space list", "product_id": "wiki", "reviewed": false, "risk": "low", "source": "hardcoded:wiki", "title": "获取知识库列表", "use_when": [ "1. 先确认知识库 ID（避免授权到「我的文档」）", "1. 获取知识库 ID", "列出我有权访问的组织知识库", "列出钉盘企业空间", "列出钉盘团队空间；列出钉盘空间", "列出钉盘空间/钉盘团队空间", "我的文档/个人空间", "我的知识库/知识库列表/有哪些知识库", "获取「我的文档」个人空间", "获取钉盘「我的文件」" ] }, "wiki.node_copy": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.node_copy", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "将指定节点复制到目标文件夹。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等）”请改用 dws wiki node list", "要“在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表”请改用 dws wiki node create", "要“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将”请改用 dws wiki node delete" ], "canonical_path": "wiki.node_copy", "cli_name": "copy", "cli_path": "wiki node copy", "confirmation": "not_required", "description": "将指定节点复制到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时复制到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有可查看下载权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：复制操作底层可能异步执行，异步时操作已提交但新节点 ID 无法立即返回，请稍后查看目标文件夹确认结果。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws wiki node copy --workspace \u003cworkspaceId\u003e --node \u003cnodeId\u003e --format json", "dws wiki node copy --workspace \u003cworkspaceId\u003e --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e --format json" ], "group": "node", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "copy_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "node_copy", "parameter_count": 3, "parameters": { "folder": { "description": "目标文件夹 nodeId (选填)", "property": "folder", "required": false, "type": "string" }, "node": { "description": "源节点 ID (必填)", "property": "node", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (必填)", "property": "workspace", "required": true, "type": "string" } }, "path": "wiki.node_copy", "primary_cli_path": "wiki node copy", "product_id": "wiki", "reviewed": false, "risk": "medium", "source": "hardcoded:wiki", "title": "将指定节点复制到目标文件夹", "use_when": [ "复制知识库里的文档", "复制节点到另一个文件夹" ] }, "wiki.node_move": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.node_move", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "将指定节点移动到目标文件夹。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等）”请改用 dws wiki node list", "要“在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表”请改用 dws wiki node create", "要“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将”请改用 dws wiki node delete" ], "canonical_path": "wiki.node_move", "cli_name": "move", "cli_path": "wiki node move", "confirmation": "not_required", "description": "将指定节点移动到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时移动到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有编辑权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：移动操作底层可能异步执行，异步时操作已提交但无法立即确认完成，请稍后查看目标文件夹确认结果。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws wiki node move --workspace \u003cworkspaceId\u003e --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e --format json", "dws wiki node move --workspace \u003cworkspaceId\u003e --node \u003cnodeId\u003e --format json" ], "group": "node", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "move_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "node_move", "parameter_count": 3, "parameters": { "folder": { "description": "目标文件夹 nodeId (选填)", "property": "folder", "required": false, "type": "string" }, "node": { "description": "源节点 ID (必填)", "property": "node", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (必填)", "property": "workspace", "required": true, "type": "string" } }, "path": "wiki.node_move", "primary_cli_path": "wiki node move", "product_id": "wiki", "reviewed": false, "risk": "medium", "source": "hardcoded:wiki", "title": "移动节点", "use_when": [ "移动知识库里的文档", "移动节点到另一个文件夹" ] }, "wiki.node_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.node_search", "skills/mono/references/intent-guide.md", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/interface-refs.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "根据关键词和多种过滤条件搜索当前用户有权限访问的文档列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等）”请改用 dws wiki node list", "要“在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表”请改用 dws wiki node create", "要“将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将”请改用 dws wiki node delete" ], "canonical_path": "wiki.node_search", "cli_name": "search", "cli_path": "wiki node search", "confirmation": "not_required", "description": "根据关键词和多种过滤条件搜索当前用户有权限访问的文档列表。\r\n\r\n支持的过滤条件：\r\n- keyword：关键词匹配文档标题和内容\r\n- extensions：按文件扩展名精确过滤（pdf/docx/png 等）\r\n- createdTimeFrom / createdTimeTo：按创建时间范围过滤\r\n- visitedTimeFrom / visitedTimeTo：按访问时间范围过滤\r\n- creatorUserIds：按创建者用户 ID 过滤\r\n - editorUserIds：按编辑者用户 ID 过滤\r\n- mentionedUserIds：按文档中 @提及的用户 ID 过滤\r\n- workspaceIds：按知识库范围过滤（支持知识库 URL）\r\n\r\n支持分页获取结果。搜索范围为用户在当前组织内有权限访问的所有文档数据。\r\n所有过滤条件均为可选，不传则不过滤。多个条件同时传入时取交集", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws wiki node search --workspace \u003cworkspaceId\u003e --query \"方案\" --format json", "dws wiki node search --workspace \u003cworkspaceId\u003e --query \"周报\" --limit 10 --format json" ], "group": "node", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "search_documents" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "node_search", "parameter_count": 5, "parameters": { "cursor": { "description": "分页游标", "property": "cursor", "required": false, "type": "string" }, "extensions": { "description": "按文件扩展名过滤 (如 adoc,asheet,pdf)", "interface_description": "按文件扩展名精确过滤，不含点号。例如 [\"pdf\", \"docx\", \"png\"]。与 fileTypes 可同时使用。", "property": "extensions", "required": false, "type": "array" }, "limit": { "description": "每页数量 (默认 10，最大 30)", "property": "limit", "required": false, "type": "integer" }, "query": { "description": "搜索关键词 (必填)", "property": "query", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (必填)", "property": "workspace", "required": true, "type": "string" } }, "path": "wiki.node_search", "primary_cli_path": "wiki node search", "product_id": "wiki", "reviewed": false, "risk": "low", "source": "hardcoded:wiki", "title": "搜索文档", "use_when": [ "在指定知识库内搜索", "在知识库里搜文档/空间内搜索", "在知识库里搜方案；空间内搜索", "按文件类型过滤" ] }, "wiki.remove_member": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.remove_member", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/destructive-safety.json", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "从知识库中移除指定的企业用户成员（仅支持 USER 类型）。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库添加指定角色的成员”请改用 dws wiki member add", "要“修改成员在知识库中的角色”请改用 dws wiki member update", "要“查询知识库当前的成员权限列表，支持按角色过滤”请改用 dws wiki member list" ], "canonical_path": "wiki.remove_member", "cli_name": "remove", "cli_path": "wiki member remove", "confirmation": "user_required", "description": "从知识库中移除指定的企业用户成员（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量移除知识库成员，移除后相关用户将无法访问该知识库下的内容（除非通过节点级权限另行授权）。\r\n\r\n适用场景：\r\n- 员工离职或转岗，需要撤销知识库访问权限。\r\n- 清理不再需要访问知识库的历史成员。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口移除。\r\n- **权限要求**：操作者必须具备知识库的「可管理（MANAGER）」及以上角色（OWNER 或 MANAGER）。EDITOR / DOWNLOADER / READER / 非成员调用会返回 `forbidden.accessDenied`，错误信息会明确提示所需的最低角色。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws wiki member remove --workspace \u003cWS_ID\u003e --users uid1", "dws wiki member remove --workspace \u003cWS_ID\u003e --users uid1,uid2" ], "group": "member", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "wiki", "rpc_name": "remove_member" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_member", "parameter_count": 2, "parameters": { "users": { "description": "被移除的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)", "property": "users", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID 或 URL (必填)", "property": "workspace", "required": true, "type": "string" } }, "path": "wiki.remove_member", "primary_cli_path": "wiki member remove", "product_id": "wiki", "reviewed": false, "risk": "high", "source": "hardcoded:wiki", "title": "移除知识库成员", "use_when": [ "3. 移除成员", "移除知识库成员/把某人从知识库移除/删除知识库成员" ] }, "wiki.search_wikiSpaces": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.search_wikiSpaces", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "根据关键词搜索当前用户有权限访问的知识库列表。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“创建一个新的钉钉文档知识库（WikiSpace）”请改用 dws wiki space create", "要“将指定知识库移入回收站”请改用 dws wiki space delete", "要“获取指定知识库的详细信息，包括名称、描述、创建者、创建时间、成员”请改用 dws wiki space get" ], "canonical_path": "wiki.search_wikiSpaces", "cli_name": "search", "cli_path": "wiki space search", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "query", "type" ] ] }, "description": "根据关键词搜索当前用户有权限访问的知识库列表。\r\n返回匹配的知识库列表，包括知识库 ID、名称、描述和访问链接。\r\n搜索范围为用户在当前组织内有权限访问的所有知识库。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws wiki space search --query \"产品文档\" --format json", "dws wiki space search --query \"技术方案\" --limit 20 --format json" ], "group": "space", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "wiki", "rpc_name": "search_wikiSpaces" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_wikiSpaces", "parameter_count": 3, "parameters": { "limit": { "description": "返回数量 1-20 (默认 10)", "property": "limit", "required": false, "type": "string" }, "query": { "description": "搜索关键词 (搜索组织知识库时必填)", "property": "query", "required": false, "type": "string" }, "type": { "description": "知识库类型: myWikiSpace 时直接返回「我的文档」，省略则搜索组织知识库", "enum": [ "myWikiSpace" ], "property": "type", "required": false, "type": "string" } }, "path": "wiki.search_wikiSpaces", "primary_cli_path": "wiki space search", "product_id": "wiki", "reviewed": false, "risk": "low", "source": "hardcoded:wiki", "title": "搜索知识库", "use_when": [ "搜索知识库", "搜索知识库/找知识库" ] }, "wiki.update_member": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "internal/cli/schema_mcp_metadata.json#tools.wiki.update_member", "skills/mono/references/products/wiki.md", "skills/mono/schema-hints/selection-review.json", "skills/mono/schema-hints/sibling-disambiguation.json" ], "agent_summary": "修改成员在知识库中的角色。", "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32", "availability": "available", "avoid_when": [ "要“为知识库添加指定角色的成员”请改用 dws wiki member add", "要“从知识库中移除指定的企业用户成员（仅支持 USER 类型）”请改用 dws wiki member remove", "要“查询知识库当前的成员权限列表，支持按角色过滤”请改用 dws wiki member list" ], "canonical_path": "wiki.update_member", "cli_name": "update", "cli_path": "wiki member update", "confirmation": "not_required", "description": "修改成员在知识库中的角色。\r\n\r\n同一成员在同一知识库只能拥有一个角色，变更后旧角色自动替换。\r\n\r\n支持变更用户（USER）角色。\r\n\r\n适用场景：\r\n- 成员晋升为管理员，需要提升其知识库权限。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口变更。\r\n- 当前 Agent 调用场景下，**暂不支持 CONVERSATION（群会话）和 DEPT（部门）类型**。\r\n- 操作者需具备知识库的 OWNER 或 MANAGER 权限。", "display": "知识库 / 空间管理 / 节点管理 / 成员管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws wiki member update --workspace \u003cWS_ID\u003e --users uid1 --role EDITOR", "dws wiki member update --workspace \u003cWS_ID\u003e --users uid1,uid2 --role READER" ], "group": "member", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "wiki", "rpc_name": "update_member" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_member", "parameter_count": 3, "parameters": { "role": { "description": "新权限角色: MANAGER / EDITOR / DOWNLOADER / READER (必填，大小写不敏感)", "property": "role", "required": true, "type": "string" }, "users": { "description": "被更新的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)", "property": "users", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID 或 URL (必填)", "property": "workspace", "required": true, "type": "string" } }, "path": "wiki.update_member", "primary_cli_path": "wiki member update", "product_id": "wiki", "reviewed": false, "risk": "medium", "source": "hardcoded:wiki", "title": "修改知识库成员角色", "use_when": [ "修改某人在知识库的权限/调整成员角色" ] } } }