{ "version": 1, "source": { "kind": "explicit", "name": "agent-selection-contract-v1", "reviewed": true, "repository": "DingTalk-Real-AI/dingtalk-workspace-cli", "channel": "open-source" }, "coverage": { "source_tools": 513 }, "tools": { "aisearch.enterprise_person_search": { "use_when": [ "13800138000是谁/查手机号；按手机号搜人", "222020这个工号是谁/查工号；按工号搜人", "五道的上级是谁/谁负责XX/XX的下属有谁；AI语义搜人", "找一下张三/搜同事/找人；AI搜人(首选)", "搜人/找人/谁负责/上级是谁/哪个部门的人" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“企业内找人搜索工具，支持按姓名、部门、职位、技能、工作职责等多维度搜索企业内人员。”" ], "examples": [ "dws aisearch person --keyword \"张三\" --dimension name --format json", "dws aisearch person --keyword \"产品部\" --dimension department --format json" ], "interface_mode": "mcp", "availability": "available" }, "aisearch.search_enterprise": { "use_when": [ "搜一下智能化方案/最近 OKR 相关邮件/最近发版相关消息；搜企业知识内容", "搜资料/找方案/查文档/搜企业知识/项目相关内容/工作总结/周报总结", "最近/本周/今天 + XX相关消息/文档/邮件有哪些" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“企业内部知识搜索工具。”" ], "examples": [ "dws aisearch enterprise --queries \"智能化方案\" --types document --format json", "dws aisearch enterprise --queries \"搜索问题\" --types im --time-range \"最近\" --format json" ], "interface_mode": "mcp", "availability": "available" }, "aisearch.search_enterprise_behavior": { "use_when": [ "我发给某人的消息/邮件/文档/今天我干了什么；搜行为记录", "我发过/谁发给我/创建过/分享过/收到过/今天我干了什么" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“业内部行为记录搜索工具。”" ], "examples": [ "dws aisearch behavior --queries \"智能化方案\" --types document --format json", "dws aisearch behavior --types mail --behavior-type send --direction \"我->汐峰\" --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.advperm_disable": { "use_when": [ "开启或关闭指定 Base 的高级权限总开关。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“开启或关闭指定 Base 的高级权限总开关。”所述变更时不要使用" ], "examples": [ "dws aitable advperm disable --base-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.advperm_enable": { "use_when": [ "1. 确保高级权限已开" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“开启或关闭指定 Base 的高级权限总开关。”所述变更时不要使用" ], "examples": [ "dws aitable advperm enable --base-id BASE_ID --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.advperm_role_create": { "use_when": [ "3. 创建角色 + 指定 sheet 子角色 authLevel=read", "仅指定 name，子角色由服务端按默认（none）填充", "创建时即指定 sub-roles（推荐——避免再走一次 role-update）" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“在指定 Base 下创建自定义角色;”所述变更时不要使用" ], "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\":\"\",\"targetType\":\"sheet\",\"authLevel\":\"read\"}]' --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.advperm_role_delete": { "use_when": [ "删除指定 Base 下的自定义角色;" ], "avoid_when": [ "用户未明确要求“删除指定 Base 下的自定义角色;”、目标不清楚或尚未确认时不要使用" ], "examples": [ "dws aitable advperm role-delete --base-id --role-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.advperm_role_get": { "use_when": [ "获取指定 Base 下单个角色的完整配置,含 subRoles 与字段/行级权限。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定 Base 下单个角色的完整配置,含 subRoles 与字段/行级权限。”" ], "examples": [ "dws aitable advperm role-get --base-id BASE_ID --role-id ROLE_ID --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.advperm_role_list": { "use_when": [ "列出指定 Base 下的全部角色,含系统角色与自定义角色,并标注 isSystem 与默认角色信息。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出指定 Base 下的全部角色,含系统角色与自定义角色,并标注 isSystem 与默认角色信息。”" ], "examples": [ "dws aitable advperm role-list --base-id BASE_ID --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.advperm_role_update": { "use_when": [ "只传 sub-roles，name 等其他字段保持不变（PATCH 语义）", "只改 sheet 子角色 authLevel，name 不传保持不变", "只改名" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“增量更新自定义角色配置。”所述变更时不要使用" ], "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\":\"\",\"targetType\":\"sheet\",\"authLevel\":\"edit-own\"}]'" ], "interface_mode": "mcp", "availability": "available" }, "aitable.attachment_upload": { "use_when": [ "1. 获取上传凭证" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“申请 attachment 字段 OSS 直传地址（不直接上传）”所述变更时不要使用" ], "examples": [ "dws aitable attachment upload --base-id --file-name report.xlsx --size 204800", "dws aitable attachment upload --base-id --file-name photo.png --size 1024 --mime-type image/png" ], "interface_mode": "mcp", "availability": "available" }, "aitable.base_copy": { "use_when": [ "复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制元数据还是只是复制表的结构不复制数据，三个参数都是必填的,如果用户传的是链接的话则需要根据实际去调用文档的DWS去获取dentryuuid信息，并且传入" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“复制当前AI表格到指定的路径下，支持传入目标地址以及是否需要复制元数据还是只是复制表的结构不复制数据，三个参数都是必填的,如果用户传的是链接的话则需要根据实际去调用文档的DWS去获取dentryuuid信息，并且传入”所述变更时不要使用" ], "examples": [ "dws aitable base copy --base-id --target-folder-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.base_create": { "use_when": [ "表格/多维表/AI表格；创建" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建 AI 表格 Base”所述变更时不要使用" ], "examples": [ "dws aitable base create --name \"项目跟踪\"" ], "interface_mode": "mcp", "availability": "available" }, "aitable.base_delete": { "use_when": [ "表格/多维表/AI表格；删除" ], "avoid_when": [ "用户未明确要求“删除 Base（高风险、不可逆）”、目标不清楚或尚未确认时不要使用" ], "examples": [ "dws aitable base delete --base-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.base_get": { "use_when": [ "2. 获取 Base 信息 — 提取 tableId", "表格/多维表/AI表格；详情" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取 Base 资源目录（tables、dashboards summary）”" ], "examples": [ "dws aitable base get --base-id --format json", "dws aitable base get --base-id BASE_ID # 查询 baseId: dws aitable base list" ], "interface_mode": "mcp", "availability": "available" }, "aitable.base_get_primary_doc_id": { "use_when": [ "根据 baseId、tableId 和 recordId 获取主键文档对应的文档信息，会返回对应的文档的dentryuuid，然后利用该uuid去获取文档的内容以及做其他操作" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“根据 baseId、tableId 和 recordId 获取主键文档对应的文档信息，会返回对应的文档的dentryuuid，然后利用该uuid去获取文档的内容以及做其他操作”" ], "examples": [ "dws aitable base get-primary-doc-id --base-id --record-id --table-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.base_list": { "use_when": [ "获取 AI 表格列表（最近访问）" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取 AI 表格列表（最近访问）”" ], "examples": [ "dws aitable base list", "dws aitable base list --limit 5 --cursor NEXT_CURSOR" ], "interface_mode": "mcp", "availability": "available" }, "aitable.base_search": { "use_when": [ "1. 搜索/列出 Base — 提取 baseId", "表格/多维表/AI表格；查看/查找/列表" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“按名称关键词搜索 AI 表格 Base。”" ], "examples": [ "dws aitable base search --query \"项目\" --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.base_update": { "use_when": [ "表格/多维表/AI表格；修改" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新 Base 名称 / 备注”所述变更时不要使用" ], "examples": [ "dws aitable base update --base-id BASE_ID --name \"新名称\" # 查询 baseId: dws aitable base list" ], "interface_mode": "mcp", "availability": "available" }, "aitable.chart_create": { "use_when": [ "在 dashboard 下创建 chart（需 --config 与 --layout）" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“在 dashboard 下创建 chart（需 --config 与 --layout）”所述变更时不要使用" ], "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}'" ], "interface_mode": "mcp", "availability": "available" }, "aitable.chart_delete": { "use_when": [ "删除 chart（同步删除其 dashboard 布局项；不可逆）" ], "avoid_when": [ "用户未明确要求“删除 chart（同步删除其 dashboard 布局项；不可逆）”、目标不清楚或尚未确认时不要使用" ], "examples": [ "dws aitable chart delete --base-id --chart-id --dashboard-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.chart_get": { "use_when": [ "2) 先拿 dashboard，再拿 chart 详情" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取 chart 详细信息（widget.config + 布局）”" ], "examples": [ "dws aitable chart get --base-id --dashboard-id --chart-id --format json", "dws aitable chart get --base-id BASE_ID --dashboard-id DASHBOARD_ID --chart-id CHART_ID" ], "interface_mode": "mcp", "availability": "available" }, "aitable.chart_share_get": { "use_when": [ "获取 chart 分享配置" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取 chart 分享配置”" ], "examples": [ "dws aitable chart share get --base-id BASE_ID --dashboard-id DASHBOARD_ID --chart-id CHART_ID" ], "interface_mode": "mcp", "availability": "available" }, "aitable.chart_share_update": { "use_when": [ "更新 chart 分享开关与类型" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新 chart 分享开关与类型”所述变更时不要使用" ], "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" ], "interface_mode": "mcp", "availability": "available" }, "aitable.chart_update": { "use_when": [ "更新 chart 配置 / 布局" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新 chart 配置 / 布局”所述变更时不要使用" ], "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}'" ], "interface_mode": "mcp", "availability": "available" }, "aitable.chart_widgets_example": { "use_when": [ "1) 先看配置模板（JSONC）" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“返回所有图表类型的 widget config 示例（JSONC）”" ], "examples": [ "dws aitable chart widgets-example --format json", "dws aitable chart widgets-example" ], "interface_mode": "mcp", "availability": "available" }, "aitable.create": { "use_when": [ "创建 AI 表格（dws aitable base create 的别名）" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建 AI 表格（dws aitable base create 的别名）”所述变更时不要使用" ], "examples": [ "dws aitable create --name " ], "interface_mode": "mcp", "availability": "available" }, "aitable.dashboard_arrange": { "use_when": [ "自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“自动对齐仪表盘中的图表布局，对错乱的图表进行全局重排。”所述变更时不要使用" ], "examples": [ "dws aitable dashboard arrange --base-id --dashboard-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.dashboard_config_example": { "use_when": [ "1) 先看配置模板（JSONC）" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“返回 dashboard config 结构示例（JSONC）”" ], "examples": [ "dws aitable dashboard config-example --format json", "dws aitable dashboard config-example" ], "interface_mode": "mcp", "availability": "available" }, "aitable.dashboard_create": { "use_when": [ "在指定 Base 下创建 dashboard。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“在指定 Base 下创建 dashboard。”所述变更时不要使用" ], "examples": [ "dws aitable dashboard create --base-id --name " ], "interface_mode": "mcp", "availability": "available" }, "aitable.dashboard_delete": { "use_when": [ "删除 dashboard（级联删除其下 chart；不可逆）" ], "avoid_when": [ "用户未明确要求“删除 dashboard（级联删除其下 chart；不可逆）”、目标不清楚或尚未确认时不要使用" ], "examples": [ "dws aitable dashboard delete --base-id --dashboard-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.dashboard_get": { "use_when": [ "2) 先拿 dashboard，再拿 chart 详情" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取 dashboard 详情（含 charts summary）”" ], "examples": [ "dws aitable dashboard get --base-id --dashboard-id --format json", "dws aitable dashboard get --base-id BASE_ID --dashboard-id DASHBOARD_ID" ], "interface_mode": "mcp", "availability": "available" }, "aitable.dashboard_share_get": { "use_when": [ "获取 dashboard 分享配置" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取 dashboard 分享配置”" ], "examples": [ "dws aitable dashboard share get --base-id BASE_ID --dashboard-id DASHBOARD_ID" ], "interface_mode": "mcp", "availability": "available" }, "aitable.dashboard_share_update": { "use_when": [ "更新 dashboard 分享开关与类型" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新 dashboard 分享开关与类型”所述变更时不要使用" ], "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" ], "interface_mode": "mcp", "availability": "available" }, "aitable.dashboard_update": { "use_when": [ "更新指定 dashboard 的配置。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新指定 dashboard 的配置。”所述变更时不要使用" ], "examples": [ "dws aitable dashboard update --base-id --dashboard-id --name " ], "interface_mode": "mcp", "availability": "available" }, "aitable.export_data": { "use_when": [ "第一步：创建任务（按 scope 传必要参数）", "第一步：创建任务时使用 --export-format 指定导出格式，并保持 --format json 作为结构化输出", "第二步：拿 taskId 继续轮询，直到返回 downloadUrl", "续等导出：拿到 downloadUrl 后再 curl 下载（见下方警告）" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“导出数据（不传 --task-id 创建新任务并等待，传入 --task-id 继续等待）”" ], "examples": [ "dws aitable export data --base-id --scope table --table-id --export-format excel --timeout-ms 1000 --format json", "dws aitable export data --base-id --task-id --timeout-ms 3000 --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.field_create": { "use_when": [ "字段/列/column；添加", "或者使用批量创建模式:" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“在已有表格中批量新增字段。”所述变更时不要使用" ], "examples": [ "dws aitable field create --base-id --table-id --name \"状态\" --type \"singleSelect\" --config '{\"options\":[{\"name\":\"待办\"},{\"name\":\"进行中\"},{\"name\":\"已完成\"}]}'", "dws aitable field create --base-id --table-id --fields '[{\"fieldName\":\"状态\",\"type\":\"singleSelect\",\"config\":{\"options\":[{\"name\":\"待办\"}]}}]'" ], "interface_mode": "mcp", "availability": "available" }, "aitable.field_delete": { "use_when": [ "字段/列/column；删除" ], "avoid_when": [ "用户未明确要求“删除字段（不可逆，禁止删除主字段与最后一个字段）”、目标不清楚或尚未确认时不要使用" ], "examples": [ "dws aitable field delete --base-id --field-id --table-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.field_get": { "use_when": [ "字段/列/column；查看" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“批量获取字段详细信息（含完整配置）”" ], "examples": [ "dws aitable field get --base-id --table-id ", "dws aitable field get --base-id --table-id --field-ids fld1,fld2" ], "interface_mode": "mcp", "availability": "available" }, "aitable.field_list": { "use_when": [ "批量获取指定字段的详细信息，包括 fieldId、名称、类型、description 以及类型相关完整配置（如格式化、选项、AI 配置等）。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“批量获取指定字段的详细信息，包括 fieldId、名称、类型、description 以及类型相关完整配置（如格式化、选项、AI 配置等）。”" ], "examples": [ "dws aitable field list --base-id --table-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.field_search_options": { "use_when": [ "搜索指定单选/多选字段的 options 列表，支持按关键词模糊匹配（大小写不敏感、contains 模式）。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“搜索指定单选/多选字段的 options 列表，支持按关键词模糊匹配（大小写不敏感、contains 模式）。”" ], "examples": [ "dws aitable field search-options --base-id --field-id --table-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.field_update": { "use_when": [ "字段/列/column；修改" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新字段名称 / 配置 / AI 配置（至少传一项）”所述变更时不要使用" ], "examples": [ "dws aitable field update --base-id --table-id --field-id --name \"新字段名\"", "dws aitable field update --base-id --table-id --field-id --config '{\"options\":[{\"name\":\"A\"},{\"name\":\"B\"}]}'" ], "interface_mode": "mcp", "availability": "available" }, "aitable.import_data": { "use_when": [ "第 3 步（替代）：追加到已有表", "第 3 步：触发导入（新建表模式）", "续等导入" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“触发导入并等待结果；每个 Sheet 新建为独立表”所述变更时不要使用" ], "examples": [ "dws aitable import data --import-id --format json", "dws aitable import data --import-id --table-id --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.import_upload": { "use_when": [ "第 1 步：申请上传凭证" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“申请导入文件 OSS 直传地址，返回 uploadUrl 与 importId”所述变更时不要使用" ], "examples": [ "dws aitable import upload --base-id --file-name data.xlsx --file-size <字节数> --format json", "dws aitable import upload --base-id BASE_ID --file-name data.xlsx --file-size 204800" ], "interface_mode": "mcp", "availability": "available" }, "aitable.info": { "use_when": [ "获取指定 Base 的资源目录级信息，返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定 Base 的资源目录级信息，返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。”" ], "examples": [ "dws aitable info --base-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.list": { "use_when": [ "列出当前用户可访问的 AI 表格 Base。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出当前用户可访问的 AI 表格 Base。”" ], "examples": [ "dws aitable list" ], "interface_mode": "mcp", "availability": "available" }, "aitable.query_records": { "use_when": [ "4. 查询记录", "从上次断点继续", "关键词搜索", "按 ID 查询", "无限制（拉完为止）", "游标分页", "示例：基础条件查询模板（可改内部 operator 为 contain 等）", "记录/行/数据/row；查看/搜索", "默认（最多 50 页 = 5000 条）" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询记录（支持按 ID 取或 filters/sort/分页遍历）”" ], "examples": [ "dws aitable record query --base-id --table-id --format json", "dws aitable record query --base-id --table-id --filters '{\"operator\":\"and\",\"operands\":[{\"operator\":\"eq\",\"operands\":[\"fld_state\",\"进行中\"]}]}' --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.record_create": { "use_when": [ "5. 新增记录 (cells 用 fieldId 作 key)", "再用 fieldId 写入记录", "单条", "多条", "步骤 2: 在 record create/update 中使用 fileToken 写入", "步骤 2: 在 record create/update 中使用 fileToken 写入附件字段", "记录/行/数据/row；添加/写入" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“批量新增记录（单次最多 100 条）”所述变更时不要使用" ], "examples": [ "dws aitable record create --base-id --table-id --records '[{\"cells\":{\"fldABC\":\"完成设计\",\"fldDEF\":\"进行中\"}}]' --format json", "dws aitable record create --base-id --table-id --records '[" ], "interface_mode": "mcp", "availability": "available" }, "aitable.record_delete": { "use_when": [ "记录/行/数据/row；删除" ], "avoid_when": [ "用户未明确要求“批量删除记录（不可逆，单次最多 100 条）”、目标不清楚或尚未确认时不要使用" ], "examples": [ "dws aitable record delete --base-id --record-ids --table-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.record_get": { "use_when": [ "记录/行/数据/row；已知 recordId 反查字段值" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询指定表格中的记录，支持两种模式： 按 ID 取：传入 recordIds（单次最多 100 个），直接获取指定记录。”" ], "examples": [ "dws aitable record get --base-id --record-ids --table-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.record_history_list": { "use_when": [ "第 1 页（最新 20 条）", "第 2 页" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询指定行记录的变更历史列表。”" ], "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}'" ], "interface_mode": "mcp", "availability": "available" }, "aitable.record_primary_doc_create": { "use_when": [ "2. 为某条记录创建主键文档" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“为指定记录创建主键文档（幂等：若该记录已有主键文档则直接返回已有文档的 nodeId）。”所述变更时不要使用" ], "examples": [ "dws aitable record primary-doc-create --base-id BASE_ID --table-id TABLE_ID --field-id FIELD_ID --record-id RECORD_ID" ], "interface_mode": "mcp", "availability": "available" }, "aitable.record_primary_doc_get": { "use_when": [ "查询指定记录的主键文档信息。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询指定记录的主键文档信息。”" ], "examples": [ "dws aitable record primary-doc-get --base-id BASE_ID --table-id TABLE_ID --record-id RECORD_ID" ], "interface_mode": "mcp", "availability": "available" }, "aitable.record_query_empty": { "use_when": [ "查询指定表格中\"完全没填用户字段\"的空行。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询指定表格中\"完全没填用户字段\"的空行。”" ], "examples": [ "dws aitable record query-empty --base-id --table-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.record_share_url": { "use_when": [ "一次拿一条记录的链接", "带视图上下文（链接打开时落在指定视图）", "批量拿，配合 jq 过滤出 url" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定行记录的分享链接，可用于将记录分享给他人。”" ], "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" ], "interface_mode": "mcp", "availability": "available" }, "aitable.record_update": { "use_when": [ "3. 写入记录", "记录/行/数据/row；修改/更新" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“批量更新记录（单次最多 100 条）”所述变更时不要使用" ], "examples": [ "dws aitable record update --base-id --table-id --records '[{\"recordId\":\"rec001\",\"cells\":{\"fldDEF\":\"已完成\"}}]' --format json", "dws aitable record update --base-id --table-id --records '[{\"recordId\":\"recXXX\",\"cells\":{\"fldAttachId\":[{\"fileToken\":\"ft_xxx\"}]}}]' --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.record_upsert": { "use_when": [ "1) 全部新建：所有项都不带 recordId", "2) 全部更新：所有项都带 recordId", "3) 混合：第 1 条更新（带 recordId），第 2 条创建（不带）", "4) 长 JSON 用文件" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“批量创建或更新记录（Upsert 语义）。”所述变更时不要使用" ], "examples": [ "dws aitable record upsert --base-id BASE_ID --table-id TABLE_ID --records '[{\"recordId\":\"<可选>\",\"cells\":{...}}, ...]'", "dws aitable record upsert --base-id BASE --table-id TBL --records '[" ], "interface_mode": "mcp", "availability": "available" }, "aitable.search": { "use_when": [ "按名称关键词搜索 AI 表格 Base。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“按名称关键词搜索 AI 表格 Base。”" ], "examples": [ "dws aitable search --query " ], "interface_mode": "mcp", "availability": "available" }, "aitable.section_create": { "use_when": [ "在指定 Base 下创建分区(用于在导航树中组织 table / dashboard,类似文件夹)。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“在指定 Base 下创建分区(用于在导航树中组织 table / dashboard,类似文件夹)。”所述变更时不要使用" ], "examples": [ "dws aitable section create --base-id --name 我的文件夹", "dws aitable section create --base-id --name 子文件夹 --parent-section-id --index 0" ], "interface_mode": "mcp", "availability": "available" }, "aitable.section_delete": { "use_when": [ "删除指定分区。" ], "avoid_when": [ "用户未明确要求“删除指定分区。”、目标不清楚或尚未确认时不要使用" ], "examples": [ "dws aitable section delete --base-id --section-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.section_list_empty": { "use_when": [ "列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于清理或诊断导航树。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出指定 Base 下所有没有任何子节点的分区(空文件夹),用于清理或诊断导航树。”" ], "examples": [ "dws aitable section list-empty --base-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.section_list_nodes": { "use_when": [ "列出指定 Base 当前版本下的全部 nsheet 节点,包括分区、AI 表格、表单视图、仪表盘、文档、查询视图等。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出指定 Base 当前版本下的全部 nsheet 节点,包括分区、AI 表格、表单视图、仪表盘、文档、查询视图等。”" ], "examples": [ "dws aitable section list-nodes --base-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.section_move_node": { "use_when": [ "把任意 nsheet 节点(分区 / 多维表 / 表单视图 / 仪表盘 / 文档 / 查询视图)移动到目标分区下,可选同时调整全局位置。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“把任意 nsheet 节点(分区 / 多维表 / 表单视图 / 仪表盘 / 文档 / 查询视图)移动到目标分区下,可选同时调整全局位置。”所述变更时不要使用" ], "examples": [ "dws aitable section move-node --base-id --node-id --new-parent-section-id ", "dws aitable section move-node --base-id --node-id --new-parent-section-id \"\" --target-index 0" ], "interface_mode": "mcp", "availability": "available" }, "aitable.section_rename": { "use_when": [ "重命名指定分区。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“重命名指定分区。”所述变更时不要使用" ], "examples": [ "dws aitable section rename --base-id --section-id --new-name 新名称" ], "interface_mode": "mcp", "availability": "available" }, "aitable.section_reorder": { "use_when": [ "在当前父分区下调整分区的展示顺序。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“在当前父分区下调整分区的展示顺序。”所述变更时不要使用" ], "examples": [ "dws aitable section reorder --base-id --section-id --target-index 0" ], "interface_mode": "mcp", "availability": "available" }, "aitable.table_create": { "use_when": [ "数据表/子表/table；创建" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建数据表并附带初始字段（最多 15 个）”所述变更时不要使用" ], "examples": [ "dws aitable table create --base-id BASE_ID --name \"任务表\" --fields '[{\"fieldName\":\"任务名称\",\"type\":\"text\"},{\"fieldName\":\"优先级\",\"type\":\"singleSelect\",\"config\":{\"options\":[{\"name\":\"高\"},{\"name\":\"中\"},{\"name\":\"低\"}]}}]'" ], "interface_mode": "mcp", "availability": "available" }, "aitable.table_delete": { "use_when": [ "数据表/子表/table；删除" ], "avoid_when": [ "用户未明确要求“删除数据表（不可逆，高风险）”、目标不清楚或尚未确认时不要使用" ], "examples": [ "dws aitable table delete --base-id --table-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.table_get": { "use_when": [ "1. 查询表结构，拿到 primaryDoc 字段的 fieldId", "2. 拿目标 sheet 的 tableId", "3. 获取表结构 — 提取 fieldId", "先获取 fieldId", "数据表/子表/table；查看" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“批量获取数据表目录与字段、视图 summary”" ], "examples": [ "dws aitable table get --base-id --table-id --format json", "dws aitable table get --base-id BASE_ID --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.table_list": { "use_when": [ "批量获取指定 Tables（数据表）的表级信息、字段目录与视图目录。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“批量获取指定 Tables（数据表）的表级信息、字段目录与视图目录。”" ], "examples": [ "dws aitable table list --base-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.table_update": { "use_when": [ "数据表/子表/table；重命名", "用户说\"恢复成默认（记录）\" → 传 ji_lu", "用户说\"把这张表的行叫'任务'吧\" → 传 task", "用户说\"换成项目\" → 传 project" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“重命名数据表”所述变更时不要使用" ], "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" ], "interface_mode": "mcp", "availability": "available" }, "aitable.template_search": { "use_when": [ "模板" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“按关键词搜索 AI 表格模板（不传返回热门模板）”" ], "examples": [ "dws aitable template search --query \"项目管理\"", "dws aitable template search" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_create": { "use_when": [ "第 1 步：创建 Gantt 视图" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建视图（Grid/FormDesigner/Gantt/Calendar/Kanban/Gallery）”所述变更时不要使用" ], "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" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_delete": { "use_when": [ "删除视图（不可逆；禁止删除最后一个视图或锁定视图）" ], "avoid_when": [ "用户未明确要求“删除视图（不可逆；禁止删除最后一个视图或锁定视图）”、目标不清楚或尚未确认时不要使用" ], "examples": [ "dws aitable view delete --base-id --table-id --view-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_duplicate": { "use_when": [ "显式命名", "系统自动命名（一般是 \"原视图名 (副本)\"）" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“复制指定视图(View),生成一个与源视图结构一致的新视图(包含列顺序、筛选、排序、分组、自定义配置等)。”所述变更时不要使用" ], "examples": [ "dws aitable view duplicate --view-id VIEW_ID --new-name \"副本视图\"", "dws aitable view duplicate --view-id VIEW_ID --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_get_aggregate": { "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。”" ], "examples": [ "dws aitable view get aggregate --view-id VIEW_ID --format json # Grid" ] }, "aitable.view_get_card": { "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。”" ], "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" ] }, "aitable.view_get_field_widths": { "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。”" ], "examples": [ "dws aitable view get field-widths --view-id VIEW_ID --format json # Grid" ] }, "aitable.view_get_fill_color_rule": { "use_when": [ "3) 查询当前规则", "看实际生效的 conditionalFormats" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。”" ], "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" ] }, "aitable.view_get_filter": { "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。”" ], "examples": [ "dws aitable view get filter --view-id VIEW_ID --format json # 所有" ] }, "aitable.view_get_frozen_cols": { "use_when": [ "查询当前冻结列数" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询指定视图(View)当前的冻结列数(左侧固定列)。”" ], "examples": [ "dws aitable view get frozen-cols --view-id VIEW_ID --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_get_group": { "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。”" ], "examples": [ "dws aitable view get group --view-id VIEW_ID --format json" ] }, "aitable.view_get_lock": { "use_when": [ "查询当前是否锁定" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询指定视图(View)当前的锁定状态。”" ], "examples": [ "dws aitable view get lock --view-id VIEW_ID --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_get_row_height": { "use_when": [ "查询当前行高" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询指定视图(View)当前的单元格行高,单位为像素。”" ], "examples": [ "dws aitable view get row-height --view-id VIEW_ID --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_get_sort": { "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。”" ], "examples": [ "dws aitable view get sort --view-id VIEW_ID --format json" ] }, "aitable.view_get_timebar": { "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。”" ], "examples": [ "dws aitable view get timebar --view-id VIEW_ID --format json # Gantt" ] }, "aitable.view_get_visible_fields": { "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。”" ], "examples": [ "dws aitable view get visible-fields --view-id VIEW_ID --format json" ] }, "aitable.view_list": { "use_when": [ "获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定数据表（Table）中的视图（View）完整信息，包括列顺序、筛选、排序、分组、条件格式、自定义配置等。”" ], "examples": [ "dws aitable view list --base-id --table-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_lock": { "use_when": [ "4) 锁定视图，防止他人改坏", "解锁", "锁定（默认）" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“锁定或解锁指定视图(View)。”所述变更时不要使用" ], "examples": [ "dws aitable view lock --view-id VIEW_ID", "dws aitable view lock --view-id VIEW_ID --off" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_update_aggregate": { "use_when": [ "更新指定视图（View）的名称、描述或配置。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新指定视图（View）的名称、描述或配置。”所述变更时不要使用" ], "examples": [ "dws aitable view update aggregate --view-id GRID_ID --field-id fldX --action SUM" ], "interface_mode": "composite", "availability": "available", "interface_ref": null, "interface_reason": "The CLI performs an aitable/get_views preflight, locally transforms the requested configuration, and then calls aitable/update_view; the two-call workflow has no single direct MCP interface." }, "aitable.view_update_card": { "use_when": [ "更新指定视图（View）的名称、描述或配置。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新指定视图（View）的名称、描述或配置。”所述变更时不要使用" ], "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" ], "interface_mode": "composite", "availability": "available", "interface_ref": null, "interface_reason": "The CLI performs an aitable/get_views preflight, locally transforms the requested configuration, and then calls aitable/update_view; the two-call workflow has no single direct MCP interface." }, "aitable.view_update_field_widths": { "use_when": [ "更新指定视图（View）的名称、描述或配置。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新指定视图（View）的名称、描述或配置。”所述变更时不要使用" ], "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}'" ], "interface_mode": "composite", "availability": "available", "interface_ref": null, "interface_reason": "The CLI performs an aitable/get_views preflight, locally transforms the requested configuration, and then calls aitable/update_view; the two-call workflow has no single direct MCP interface." }, "aitable.view_update_fill_color_rule": { "use_when": [ "1) 给金额字段 > 100 的单元格上 firstLine5 色", "2) 清空所有规则", "3) 金额 > 100 的单元格上色" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“设置指定表格视图（Grid View）的条件填色规则（全量覆盖）。”所述变更时不要使用" ], "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 '[]'" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_update_filter": { "use_when": [ "更新指定视图（View）的名称、描述或配置。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新指定视图（View）的名称、描述或配置。”所述变更时不要使用" ], "examples": [ "dws aitable view update filter --view-id VIEW_ID --json '[{\"operator\":\"and\",\"operands\":[{\"operator\":\"eq\",\"operands\":[\"fldX\",\"value\"]}]}]'" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_update_frozen_cols": { "use_when": [ "1) 关键字段冻结，避免横向滚动看不到", "冻结从首列起 1 列", "取消冻结" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“设置指定视图(View)的冻结列数(左侧固定列),默认 1。”所述变更时不要使用" ], "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" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_update_group": { "use_when": [ "更新指定视图（View）的名称、描述或配置。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新指定视图（View）的名称、描述或配置。”所述变更时不要使用" ], "examples": [ "dws aitable view update group --view-id VIEW_ID --json '[{\"fieldId\":\"fldX\",\"direction\":\"asc\"}]'" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_update_name": { "use_when": [ "更新指定视图（View）的名称、描述或配置。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新指定视图（View）的名称、描述或配置。”所述变更时不要使用" ], "examples": [ "dws aitable view update name --view-id VIEW_ID --name \"新视图名\"" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_update_row_height": { "use_when": [ "2) 加大行高让数据更易读", "设置行高 — 推荐档位 32 / 56 / 88 / 128" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“设置指定视图(View)的单元格高度(行高),单位为像素,默认 32。”所述变更时不要使用" ], "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" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_update_sort": { "use_when": [ "更新指定视图（View）的名称、描述或配置。" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新指定视图（View）的名称、描述或配置。”所述变更时不要使用" ], "examples": [ "dws aitable view update sort --view-id VIEW_ID --json '[{\"fieldId\":\"fldX\",\"direction\":\"asc\"}]'" ], "interface_mode": "mcp", "availability": "available" }, "aitable.view_update_timebar": { "use_when": [ "第 2 步（必须）：绑定日期字段，否则视图为空" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新指定视图（View）的名称、描述或配置。”所述变更时不要使用" ], "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" ], "interface_mode": "composite", "availability": "available", "interface_ref": null, "interface_reason": "The CLI performs an aitable/get_views preflight, locally transforms the requested configuration, and then calls aitable/update_view; the two-call workflow has no single direct MCP interface." }, "aitable.view_update_visible_fields": { "use_when": [ "传回全量列表解除隐藏", "只保留首列和 fldA，其余字段被隐藏" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“更新指定视图（View）的名称、描述或配置。”所述变更时不要使用" ], "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\"]'" ], "interface_mode": "mcp", "availability": "available" }, "aitable.workflow_disable": { "use_when": [ "2. 禁用" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“禁用指定 Base 中的自动化工作流。”所述变更时不要使用" ], "examples": [ "dws aitable workflow disable --base-id --workflow-id " ], "interface_mode": "mcp", "availability": "available" }, "aitable.workflow_enable": { "use_when": [ "3. 调试做完后重启" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“启用指定 Base 中的自动化工作流。”所述变更时不要使用" ], "examples": [ "dws aitable workflow enable --base-id BASE_ID --workflow-id WORKFLOW_ID --format json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.workflow_get": { "use_when": [ "1. 留底当前状态" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取指定 Base 中某个自动化工作流的详细信息，直接返回下游 getFlowDetail 的详情结构。”" ], "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 > /tmp/wf-backup.json" ], "interface_mode": "mcp", "availability": "available" }, "aitable.workflow_list": { "use_when": [ "4. 确认 status=RUNNING" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“列出指定 Base 中的自动化工作流，直接返回下游 searchFlows 的响应结构。”" ], "examples": [ "dws aitable workflow list --base-id BASE_ID --format json", "dws aitable workflow list --base-id BASE_ID --limit 50 --offset 100" ], "interface_mode": "mcp", "availability": "available" }, "attendance.batch_get_employee_shifts": { "use_when": [ "批量查询员工班次信息（间隔 ≤ 7 天，最多 50 人）" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“批量查询员工班次信息（间隔 ≤ 7 天，最多 50 人）”" ], "examples": [ "dws attendance shift list --users userId1,userId2 --start 2026-03-03 --end 2026-03-07 # 查询 userId: dws contact user search --keyword \"姓名\"" ], "interface_mode": "mcp", "availability": "available" }, "attendance.get_attendance_summary": { "use_when": [ "查看考勤统计摘要（--stats-type 必填：week 周统计 / month 月统计）", "考勤汇总/统计" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询某个人的考勤统计摘要”" ], "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" ] }, "attendance.get_user_attendance_record": { "use_when": [ "查询个人考勤详情" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询个人考勤详情”" ], "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 \"姓名\"" ], "interface_mode": "mcp", "availability": "available" }, "attendance.query_attendance_group_or_rules": { "use_when": [ "1. 先查考勤组和关联班次（即使排休也需要确认考勤组）", "1. 先查考勤组并获取关联班次（先查后排）", "查看考勤组和规则", "用户只属于一个考勤组，直接查询即可确定", "考勤组/考勤规则/打卡规则", "自动获取当前用户的考勤组（用户只属于一个考勤组，无需选择）" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询考勤组与考勤规则”" ], "examples": [ "dws attendance rules --date <今天日期> --format json", "dws attendance rules --date 2026-03-14" ], "interface_mode": "mcp", "availability": "available" }, "calendar.add_attachments": { "use_when": [ "把附件挂到指定日程", "日程附件/给会议加文件/上传日程材料；添加" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“为日程添加附件。”所述变更时不要使用" ], "examples": [ "dws calendar attachment add --event --files :report.pdf,:slides.pptx", "dws calendar attachment add --event --files :report.pdf,:slides.pptx --format json" ], "interface_mode": "mcp", "availability": "available" }, "calendar.add_calendar_participant": { "use_when": [ "参会人/与会者；邀请/添加", "添加参会人（必须用 Step 1 返回的 eventId）" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“添加参与者”所述变更时不要使用" ], "examples": [ "dws calendar attendee add --event --attendees ,", "dws calendar attendee add --event --attendees --optional" ], "interface_mode": "mcp", "availability": "available" }, "calendar.add_meeting_room": { "use_when": [ "会议室/订会议室；给已有日程订会议室", "预定会议室" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“预定会议室”所述变更时不要使用" ], "examples": [ "dws calendar room add --event --rooms ", "dws calendar room add --event --rooms --format json" ], "interface_mode": "mcp", "availability": "available" }, "calendar.create_calendar_event": { "use_when": [ "会议室/订会议室；创建新日程并订会议室", "创建日程 — 提取 eventId", "创建日程时直接指定参会人 + 会议室", "日程/会议/约会/日历；创建/约/给自己留时间块/个人日程", "给自己留一个明天下午的时间块/建个个人日程；创建个人日程" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建新的日程，支持设置时间、参与者、提醒，以及预定会议室等功能。”所述变更时不要使用" ], "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" ], "interface_mode": "mcp", "availability": "available" }, "calendar.delete_calendar_event": { "use_when": [ "日程/会议/约会/日历；取消/删除" ], "avoid_when": [ "用户未明确要求“删除日程”、目标不清楚或尚未确认时不要使用" ], "examples": [ "dws calendar event delete --id " ], "interface_mode": "mcp", "availability": "available" }, "calendar.delete_meeting_room": { "use_when": [ "会议室/订会议室；取消预定" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“移除会议室”所述变更时不要使用" ], "examples": [ "dws calendar room delete --event --rooms " ], "interface_mode": "mcp", "availability": "available" }, "calendar.get_calendar": { "use_when": [ "我有几个日历/查所有日历/别人共享给我的日历/他人共享给我的日历本；查指定日历本" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“根据日历id查询指定日历的信息。”" ], "examples": [ "dws calendar book get --id primary", "dws calendar book get --id CALENDAR_ID" ], "interface_mode": "mcp", "availability": "available" }, "calendar.get_calendar_detail": { "use_when": [ "日程/会议/约会/日历；详情" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取日程详情”" ], "examples": [ "dws calendar event get --id ", "dws calendar event get --id --calendar-id primary" ], "interface_mode": "mcp", "availability": "available" }, "calendar.get_calendar_participants": { "use_when": [ "参会人/与会者；查看" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查看参与者”" ], "examples": [ "dws calendar attendee list --event " ], "interface_mode": "mcp", "availability": "available" }, "calendar.list_acls": { "use_when": [ "我的日历共享给了谁/谁能看我日历/日历权限/取消共享/把日历分享给xxx；查看我共享出去的情况（即谁有权访问我的日历）" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“调用本接口，获取用户主日历的访问控制列表。”" ], "examples": [ "dws calendar acl list" ], "interface_mode": "mcp", "availability": "available" }, "calendar.list_calendar_events": { "use_when": [ "日程/会议/约会/日历；查看" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询当前用户指定日历本下的日程列表，按起止时间检索。”" ], "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" ], "interface_mode": "mcp", "availability": "available" }, "calendar.list_calendars": { "use_when": [ "我有几个日历/查所有日历/别人共享给我的日历/他人共享给我的日历本；列表", "查下xxx的日程安排；查询是否有共享关系" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询用户的所有日历，其中id = \"primary\"为主日历（name = \"我的日历\"），为固定值。”" ], "examples": [ "dws calendar book list" ], "interface_mode": "mcp", "availability": "available" }, "calendar.list_meeting_room_groups": { "use_when": [ "会议室/订会议室；分组" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“会议室分组列表”" ], "examples": [ "dws calendar room list-groups", "dws calendar room list-groups --limit 20 --page 0" ], "interface_mode": "mcp", "availability": "available" }, "calendar.list_suggested_event_times": { "use_when": [ "日程/会议/约会/日历；推荐时间/什么时候有空/协调时间" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“根据参会人推荐可用时间”" ], "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" ], "interface_mode": "mcp", "availability": "available" }, "calendar.query_available_meeting_room": { "use_when": [ "会议室/订会议室；哪个空闲", "会议室/订会议室；按名找会议室（如「永澄亭」「永澄亭会议室」「约西湖厅」）", "搜索空闲会议室", "搜索空闲会议室，记下 roomId" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询 [startTime, endTime] 时间段内所有可用的会议室。”" ], "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 " ], "interface_mode": "mcp", "availability": "available" }, "calendar.query_busy_status": { "use_when": [ "同时查用户 + 会议室", "有空吗/忙不忙/闲忙；查询会议室闲忙", "有空吗/忙不忙/闲忙；查询用户闲忙", "有空吗/忙不忙/闲忙；用户 + 会议室一起查", "查会议室闲忙", "查用户闲忙" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查询用户闲忙状态”" ], "examples": [ "dws calendar busy search --users , --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\"", "dws calendar busy search --rooms , --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\"" ], "interface_mode": "mcp", "availability": "available" }, "calendar.remove_calendar_participant": { "use_when": [ "参会人/与会者；移除" ], "avoid_when": [ "用户未明确要求“移除参与者”、目标不清楚或尚未确认时不要使用" ], "examples": [ "dws calendar attendee delete --attendees --event " ], "interface_mode": "mcp", "availability": "available" }, "calendar.respond": { "use_when": [ "日程/会议/约会/日历；接受/拒绝/暂定日程" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“作为日程参会人，设置自己的响应状态（接受、拒绝、暂定）。”所述变更时不要使用" ], "examples": [ "dws calendar event respond --id --status accepted", "dws calendar event respond --id --status declined" ], "interface_mode": "mcp", "availability": "available" }, "calendar.search_calendar": { "use_when": [ "我有几个日历/查所有日历/别人共享给我的日历/他人共享给我的日历本；按名称搜索日历本" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“搜索当前用户拥有的日历本，支持按日历本名模糊搜索。”" ], "examples": [ "dws calendar book search --query \"项目\"", "dws calendar book search --query \"团队周报\"" ], "interface_mode": "mcp", "availability": "available" }, "calendar.update_calendar_event": { "use_when": [ "日程/会议/约会/日历；修改/改时间/改描述" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“修改现有日程的信息，支持更新标题、时间、地点等任意字段，需要组织者权限。”所述变更时不要使用" ], "examples": [ "dws calendar event update --id --title \"新标题\"", "dws calendar event update --id --desc \"新描述\" --timezone Asia/Tokyo" ], "interface_mode": "mcp", "availability": "available" }, "chat.add_custom_group_role": { "use_when": [ "创建/添加群身份" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“添加群身份”所述变更时不要使用" ], "examples": [ "dws chat group-role add --group --name \"管理员\"" ], "interface_mode": "mcp", "availability": "available" }, "chat.add_emoji_reaction": { "use_when": [ "emoji回应/表情回应/给消息加表情" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“消息添加 emoji 回应”所述变更时不要使用" ], "examples": [ "dws chat message add-emoji --conversation-id --msg-id --emoji \"赞\"", "dws chat message add-emoji --conversation-id --msg-id --emoji \"鼓掌\"" ], "interface_mode": "mcp", "availability": "available" }, "chat.add_group_member": { "use_when": [ "把张三拉进群；添加群成员", "拉人进群/加群成员" ], "avoid_when": [ "设管理员/取消管理员；设置群管理员" ], "examples": [ "dws chat group members add --id --users userId1,userId2" ], "interface_mode": "mcp", "availability": "available" }, "chat.add_robot_to_group": { "use_when": [ "加机器人到群", "邀请机器人进群" ], "avoid_when": [ "从群里移除机器人/踢机器人；移除群内机器人" ], "examples": [ "dws chat group members add-bot --robot-code --id ", "dws chat group members add-bot --group --robot-code " ], "interface_mode": "mcp", "availability": "available" }, "chat.add_text_emotion": { "use_when": [ "文字表情回应/添加文字表情" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“添加文字表情”所述变更时不要使用" ], "examples": [ "dws chat message add-text-emotion --conversation-id --msg-id --emotion-id --emotion-name \"赞\" --text \"nice\" --background-id im_bg_5" ], "interface_mode": "mcp", "availability": "available" }, "chat.combine_forward_messages": { "use_when": [ "合并转发/批量转发/合并转发多条消息", "合并转发/批量转发/合并转发多条消息；合并转发多条消息" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“合并转发消息”所述变更时不要使用" ], "examples": [ "dws chat message combine-forward --src-conversation-id --msg-ids ,, --dest-conversation-id ", "dws chat message combine-forward --src-conversation-id --msg-ids , --dest-conversation-id --uuid " ], "interface_mode": "mcp", "availability": "available" }, "chat.create_and_send_card": { "use_when": [ "发卡片消息/推送流式卡片；创建并推送流式卡片" ], "avoid_when": [ "更新卡片/流式更新卡片；流式更新卡片内容" ], "examples": [ "dws chat message send-card --group ", "dws chat message send-card --receiver " ], "interface_mode": "mcp", "availability": "available" }, "chat.create_smart_conv_category": { "agent_summary": "创建按群名称关键词或群成员自动匹配会话的智能分组", "use_when": [ "需要按群名称关键词或群成员自动归类会话时创建智能会话分组" ], "avoid_when": [ "只需要普通静态会话分组，或不希望根据关键词和成员自动匹配会话时不要使用" ], "examples": [ "dws chat category create-smart --name \"重点项目群\" --keywords \"项目,重点\"" ], "reviewed": true }, "chat.create_group_conversation": { "use_when": [ "帮我建一个项目群；创建群聊", "建群/创建群聊" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建一个群聊，支持指定群名称、初始成员列表等参数。”所述变更时不要使用" ], "examples": [ "dws chat group create --name \"Q1 项目冲刺群\" --users userId1,userId2,userId3" ], "interface_mode": "mcp", "availability": "available" }, "chat.create_text_emotion": { "use_when": [ "创建文字表情/新建文字表情" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“创建文字表情”所述变更时不要使用" ], "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" ], "interface_mode": "mcp", "availability": "available" }, "chat.dismiss_group": { "use_when": [ "解散群/解散群聊", "解散群/解散群聊；解散群聊" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“解散群聊”所述变更时不要使用" ], "examples": [ "dws chat group dismiss --group " ], "interface_mode": "mcp", "availability": "available" }, "chat.download_media": { "use_when": [ "下载聊天消息中的图片/视频/语音等资源到本地文件" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“下载聊天消息中的图片/视频/语音等资源到本地文件”" ], "examples": [ "dws chat message download-media --type mediaId --resource-id --message-id --open-conversation-id --output ./photo.jpg", "dws chat message download-media --type mediaId --resource-id --message-id --open-conversation-id --output ./downloads/photo.jpg" ], "interface_mode": "composite", "availability": "available", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref" }, "chat.forward_message": { "use_when": [ "转发消息/把消息转到另一个群；转发单条消息", "转发消息/转发一条消息/把消息转发到另一个群" ], "avoid_when": [ "合并转发/批量转发/合并转发多条消息；合并转发多条消息", "转发话题/转发话题消息/话题转发到另一个群；转发话题消息" ], "examples": [ "dws chat message forward --src-conversation-id --msg-id --dest-conversation-id " ], "interface_mode": "mcp", "availability": "available" }, "chat.forward_topic": { "use_when": [ "转发话题/转发话题消息", "转发话题/转发话题消息/话题转发到另一个群；转发话题消息" ], "avoid_when": [ "仅需查询状态或预览结果、不应产生“转发某个话题到其他会话”所述变更时不要使用" ], "examples": [ "dws chat message forward-topic --src-conversation-id --src-msg-id --src-thread-id --dest-conversation-id " ], "interface_mode": "mcp", "availability": "available" }, "chat.get_conv_info_by_group_id": { "use_when": [ "根据群号查群信息/群号查群/群号转openConversationId", "根据群号查群信息/群号转openConversationId；群号查群聊信息" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“根据群号获取群聊信息”" ], "examples": [ "dws chat group get-by-group-id --group-id 12345678" ], "interface_mode": "mcp", "availability": "available" }, "chat.get_conversation_info": { "use_when": [ "获取会话的基础信息" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取会话的基础信息”" ], "examples": [ "dws chat conversation-info --group --format json", "dws chat conversation-info --user --format json" ], "interface_mode": "mcp", "availability": "available" }, "chat.get_group_invite_url": { "use_when": [ "群邀请链接/入群链接/加群链接" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取群邀请链接”" ], "examples": [ "dws chat group invite-url --group ", "dws chat group invite-url --group --expires-seconds 86400" ], "interface_mode": "mcp", "availability": "available" }, "chat.get_group_members": { "use_when": [ "查看群成员列表" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“查看群成员列表”" ], "examples": [ "dws chat group members list --id " ], "interface_mode": "mcp", "availability": "available" }, "chat.list_conversation_message_v2": { "use_when": [ "2. 拉取群消息", "和某人的单聊聊天记录/拉某人单聊历史", "拉取一下上周项目群的聊天记录；拉取会话消息", "拉取和张三的单聊记录；拉取单聊消息", "拉取和某人的单聊记录/单聊消息", "某个群的聊天记录", "聊天记录/会话消息/拉取会话" ], "avoid_when": [ "DING消息/查DING/DING历史；查询 DING 消息列表", "查看我今天的所有消息；全量会话消息", "查看钉住的消息/Pin列表/钉住消息列表；拉取钉住消息列表", "看看张三发给我的消息；按发送者查询消息" ], "examples": [ "dws chat message list --group --time \"2025-03-01 00:00:00\"", "dws chat message list --user --time \"2025-03-01 00:00:00\" --limit 50" ], "interface_mode": "mcp", "availability": "available" }, "chat.list_conversations_by_category": { "use_when": [ "某个分组下有哪些会话；分组下会话列表", "某个分组下的会话/分组会话列表" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“拉取用户指定自定义会话分组下的会话”" ], "examples": [ "dws chat category list-conversations --category-id <分组ID>", "dws chat category list-conversations --category-id <分组ID> --exclude-muted" ], "interface_mode": "mcp", "availability": "available" }, "chat.list_custom_group_roles": { "use_when": [ "查看群身份/群的自定义身份列表" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“拉取会话的群身份”" ], "examples": [ "dws chat group-role list --group " ], "interface_mode": "mcp", "availability": "available" }, "chat.list_group_bots": { "use_when": [ "群机器人列表/群里有哪些机器人/查看群机器人", "群里有哪些机器人/查看群机器人/列出群机器人；查看群内机器人列表" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“获取群内所有机器人”" ], "examples": [ "dws chat group bots --group " ], "interface_mode": "mcp", "availability": "available" }, "chat.list_individual_chat_message": { "use_when": [ "拉取指定用户的单聊会话消息内容" ], "avoid_when": [ "需要创建、修改或删除数据时不要使用；本命令只用于“拉取指定用户的单聊会话消息内容”" ], "examples": [ "dws chat message list-direct --time