github/dingtalk-workspace-cli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d41ea586bf9514009e95137bd6befa8d8021c8fc
dingtalk-workspace-cli/internal/cli/schema_agent_metadata/sheet.json
T
玉澜 a6b2972a1e feat(schema): review sheet range and filter agent semantics 
Add explicit reviewed Agent hints for high-frequency sheet range/filter/filter-view, condition-format and dropdown tools. Replace generic avoid_when with concrete read/write/clear/style/filter-view disambiguation, tighten destructive operations, and regenerate schema metadata/catalog.

Validated with drift/catalog gates and go test ./internal/cli ./internal/app ./internal/generator/... .
2026-07-11 17:39:57 +08:00

2240 lines
101 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"product_id": "sheet",
"tools": {
"sheet add-dimension": {
"agent_summary": "在钉钉表格的指定工作表末尾追加空行或空列。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"追加空行/追加空列/增加行数/增加列数/扩展表格/在末尾加空行；追加空行/空列"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“在钉钉表格的指定工作表末尾追加空行或空列。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet append": {
"agent_summary": "在钉钉电子表格的指定工作表末尾追加若干行数据。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"3. 追加单行数据",
"4. 追加多行数据",
"插入行/插入列/在某行前插入/在某列前插入；在末尾追加",
"追加数据/添加行/在末尾加数据/新增记录；追加数据"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“在钉钉电子表格的指定工作表末尾追加若干行数据。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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]]'"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet batch-update": {
"agent_summary": "将多个写操作打包为一次原子请求执行",
"agent_summary_source": "runtime-surface-completeness-v1",
"use_when": [
"批量操作/一次执行多个写操作/原子批量/先清除再写入；多个写操作打包"
],
"avoid_when": [
"不需要将多个写操作打包为一次原子请求执行时不要使用；如仅查询状态请优先选择对应 list/get/search 命令"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"examples": [
"dws sheet batch-update --node \u003cNODE_ID\u003e --operations '[",
"dws sheet batch-update --node \u003cNODE_ID\u003e --continue-on-error --operations '[...]'"
],
"reviewed": false,
"source_refs": [
"skills/mono/references/products/sheet/sheet-batch-operations.md",
"skills/mono/schema-hints/runtime-surface-completeness.json"
],
"interface_mode": "local",
"availability": "available",
"interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref"
},
"sheet chart create": {
"agent_summary": "在钉钉电子表格的指定工作表中创建一个浮动图表",
"agent_summary_source": "runtime-surface-completeness-v1",
"use_when": [
"3. 创建柱形图",
"创建折线图",
"创建柱形图"
],
"avoid_when": [
"不需要在钉钉电子表格的指定工作表中创建一个浮动图表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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 '{"
],
"reviewed": false,
"source_refs": [
"skills/mono/references/products/sheet/sheet-chart.md",
"skills/mono/schema-hints/runtime-surface-completeness.json"
],
"interface_mode": "local",
"availability": "available",
"interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref"
},
"sheet chart delete": {
"agent_summary": "删除钉钉电子表格中指定的浮动图表",
"agent_summary_source": "runtime-surface-completeness-v1",
"use_when": [
"删除钉钉电子表格中指定的浮动图表"
],
"avoid_when": [
"不需要删除钉钉电子表格中指定的浮动图表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"examples": [
"dws sheet chart delete --node NODE_ID --sheet-id SHEET_ID --chart-id CHART_ID"
],
"reviewed": false,
"source_refs": [
"skills/mono/references/products/sheet/sheet-chart.md",
"skills/mono/schema-hints/runtime-surface-completeness.json"
],
"interface_mode": "local",
"availability": "available",
"interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref"
},
"sheet chart list": {
"agent_summary": "获取钉钉电子表格指定工作表中的浮动图表",
"agent_summary_source": "runtime-surface-completeness-v1",
"use_when": [
"1. 获取现有配置",
"4. 验证创建结果",
"列出所有浮动图表",
"获取单个图表详情"
],
"avoid_when": [
"不需要获取钉钉电子表格指定工作表中的浮动图表时不要使用；如仅查询状态请优先选择对应 list/get/search 命令"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"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"
],
"reviewed": false,
"source_refs": [
"skills/mono/references/products/sheet/sheet-chart.md",
"skills/mono/schema-hints/runtime-surface-completeness.json"
],
"interface_mode": "local",
"availability": "available",
"interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref"
},
"sheet chart update": {
"agent_summary": "更新钉钉电子表格中指定浮动图表的配置",
"agent_summary_source": "runtime-surface-completeness-v1",
"use_when": [
"3. 整体回写"
],
"avoid_when": [
"不需要更新钉钉电子表格中指定浮动图表的配置时不要使用；如仅查询状态请优先选择对应 list/get/search 命令"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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'"
],
"reviewed": false,
"source_refs": [
"skills/mono/references/products/sheet/sheet-chart.md",
"skills/mono/schema-hints/runtime-surface-completeness.json"
],
"interface_mode": "local",
"availability": "available",
"interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref"
},
"sheet cond-format create": {
"agent_summary": "创建条件格式规则",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"按条件高亮或设置格式规则"
],
"avoid_when": [
"只设置静态样式用 sheet range set-style",
"更新已有条件格式用 sheet cond-format update",
"查看条件格式列表用 sheet cond-format list"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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\"}'"
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet cond-format delete": {
"agent_summary": "删除条件格式规则",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"删除某条条件格式规则"
],
"avoid_when": [
"删除普通筛选用 sheet filter delete",
"删除筛选视图用 sheet filter-view delete",
"只修改规则用 sheet cond-format update"
],
"effect": "destructive",
"effect_source": "agent-hint",
"risk": "high",
"confirmation": "user_required",
"idempotency": "unknown",
"examples": [
"dws sheet cond-format delete --node \u003cnode\u003e --rule-id \u003crule-id\u003e --sheet-id \u003csheet-id\u003e"
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet cond-format list": {
"agent_summary": "查看条件格式规则列表或详情",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"查看工作表已有条件格式规则"
],
"avoid_when": [
"创建条件格式用 sheet cond-format create",
"删除条件格式用 sheet cond-format delete",
"更新条件格式用 sheet cond-format update"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws sheet cond-format list --node NODE_ID --sheet-id SHEET_ID"
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet cond-format update": {
"agent_summary": "更新条件格式规则",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"修改已有条件格式规则"
],
"avoid_when": [
"删除规则用 sheet cond-format delete",
"新建规则用 sheet cond-format create",
"静态设置样式用 sheet range set-style"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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\"}'"
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet copy": {
"agent_summary": "复制钉钉电子表格中的指定工作表，在同一表格中创建一个副本，可同时指定副本的目标位置。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"只指定名称",
"复制工作表/拷贝工作表/克隆工作表/工作表副本；复制工作表",
"复制工作表/拷贝工作表/克隆工作表/工作表副本；复制并指定位置",
"复制工作表/拷贝工作表/克隆工作表/工作表副本；复制并指定名称",
"指定副本名称和位置",
"按默认位置复制"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“复制钉钉电子表格中的指定工作表，在同一表格中创建一个副本，可同时指定副本的目标位置。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet create": {
"agent_summary": "创建钉钉表格文档",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"1. 创建表格文档 — 提取 nodeId",
"4. 完整流程: 创建表格 → 上传附件",
"4. 完整流程: 创建表格 → 写表头 → 写入图片",
"创建表格/新建电子表格；创建表格文档"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“创建钉钉表格文档”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"examples": [
"dws sheet create --name \"销售数据\"",
"dws sheet create --name \"Q1 数据\" --folder \u003cFOLDER_ID\u003e"
],
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "create_workspace_sheet"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet create-float-image": {
"agent_summary": "在钉钉电子表格的指定工作表中插入一张浮动图片。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"再创建浮动图片",
"带偏移量"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“在钉钉电子表格的指定工作表中插入一张浮动图片。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet csv-get": {
"agent_summary": "以 CSV 格式读取指定区域数据",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"需要 CSV 文本而非 JSON 二维数组时读取 range"
],
"avoid_when": [
"写入 CSV 用 sheet csv-put",
"写入普通二维数组用 sheet range update",
"需要 JSON/结构化值用 sheet range read"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"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"
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet csv-put": {
"agent_summary": "将 CSV 文本写入工作表指定起点",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"把 CSV 文本导入到 sheet 指定位置"
],
"avoid_when": [
"写入 JSON 二维数组用 sheet range update",
"只改样式用 sheet range set-style",
"读取 CSV 用 sheet csv-get"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet delete-dimension": {
"agent_summary": "在钉钉表格指定工作表中，从指定位置起删除若干连续的行或列。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"2. 从第 3 行开始删除 2 行",
"3. 从 A 列开始删除 1 列",
"4. 使用工作表前缀指定位置",
"从 A 列开始删除 1 列",
"从 AB 列开始删除 3 列",
"从第 3 行开始删除 2 行",
"使用工作表前缀（忽略 --sheet-id）",
"删除行/删除列/删掉第几行/删掉某列/移除行/移除列；删除行或列"
],
"avoid_when": [
"用户未明确要求“在钉钉表格指定工作表中，从指定位置起删除若干连续的行或列。”、目标不清楚或尚未确认时不要使用"
],
"effect": "destructive",
"effect_source": "agent-hint",
"risk": "high",
"confirmation": "user_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet delete-dropdown": {
"agent_summary": "删除单元格下拉列表配置",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"移除指定范围的下拉列表配置"
],
"avoid_when": [
"修改下拉选项用 sheet set-dropdown",
"只查询下拉配置用 sheet get-dropdown",
"清空单元格内容用 sheet range clear"
],
"effect": "destructive",
"effect_source": "agent-hint",
"risk": "high",
"confirmation": "user_required",
"idempotency": "unknown",
"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\""
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet delete-float-image": {
"agent_summary": "删除钉钉电子表格中指定的浮动图片。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"删除浮动图片/移除浮动图片；删除浮动图片"
],
"avoid_when": [
"用户未明确要求“删除钉钉电子表格中指定的浮动图片。”、目标不清楚或尚未确认时不要使用"
],
"effect": "destructive",
"effect_source": "agent-hint",
"risk": "high",
"confirmation": "user_required",
"idempotency": "unknown",
"examples": [
"dws sheet delete-float-image --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --float-image-id \u003cFI_ID\u003e"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet delete-sheet": {
"agent_summary": "删除钉钉电子表格中的指定工作表",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"删除工作表/移除工作表/删掉这个Sheet；删除工作表"
],
"avoid_when": [
"用户未明确要求“删除钉钉电子表格中的指定工作表”、目标不清楚或尚未确认时不要使用"
],
"effect": "destructive",
"effect_source": "agent-hint",
"risk": "high",
"confirmation": "user_required",
"idempotency": "unknown",
"examples": [
"dws sheet delete-sheet --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet export": {
"agent_summary": "用于将钉钉在线表格导出为 xlsx。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"--output 为目录时，自动按下载链接中的文件名保存",
"仅导出，返回 downloadUrl（链接有时效性，请尽快下载）",
"场景 A：仅获取下载链接（命令内部自动完成提交+轮询，最终返回 downloadUrl）",
"场景 B：导出并自动下载为本地文件",
"场景 C：下载到目录，自动按链接推断文件名",
"导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；导出表格",
"导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；需要落盘到本地",
"导出并自动下载为本地文件",
"把这个在线表格导出为 xlsx 文件；在线表格格式转换"
],
"avoid_when": [
"需要创建、修改或删除数据时不要使用；本命令只用于“用于将钉钉在线表格导出为 xlsx。”"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws sheet export --node \u003cNODE_ID\u003e",
"dws sheet export --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\""
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter clear-criteria": {
"agent_summary": "清除基础筛选中某一列条件",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"仅清除普通筛选的某列筛选条件"
],
"avoid_when": [
"删除整个基础筛选用 sheet filter delete",
"更新筛选条件用 sheet filter update",
"筛选视图条件用 sheet filter-view delete-criteria"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": true,
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "clear_filter_criteria"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter create": {
"agent_summary": "为工作表创建基础筛选",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"需要在普通筛选范围上开启筛选"
],
"avoid_when": [
"只查看筛选信息用 sheet filter get",
"更新筛选条件用 sheet filter update 或 clear-criteria",
"管理筛选视图用 sheet filter-view create/update/list"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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\":[\"北京\",\"上海\"]}]'"
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter delete": {
"agent_summary": "删除工作表基础筛选",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"移除整张表的普通筛选配置"
],
"avoid_when": [
"仅查看筛选信息用 sheet filter get",
"删除筛选视图用 sheet filter-view delete",
"只清除某列条件用 sheet filter clear-criteria"
],
"effect": "destructive",
"effect_source": "agent-hint",
"risk": "high",
"confirmation": "user_required",
"idempotency": "unknown",
"examples": [
"dws sheet filter delete --node \u003cnode\u003e --sheet-id \u003csheet-id\u003e"
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter get": {
"agent_summary": "查看工作表基础筛选信息",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"查看普通筛选是否存在及范围"
],
"avoid_when": [
"创建或更新筛选用 sheet filter create/update",
"查看筛选视图列表用 sheet filter-view list",
"查看筛选视图条件用 sheet filter-view get-criteria"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"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\""
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter sort": {
"agent_summary": "对基础筛选范围内数据排序",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"在普通筛选范围内设置排序"
],
"avoid_when": [
"仅更新筛选条件用 sheet filter update",
"筛选视图排序/条件请使用 sheet filter-view update",
"读取数据排序结果用 sheet range read"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter update": {
"agent_summary": "更新工作表基础筛选条件",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"批量设置普通筛选的筛选条件"
],
"avoid_when": [
"仅排序筛选范围用 sheet filter sort",
"清除某列筛选条件用 sheet filter clear-criteria",
"管理筛选视图条件用 sheet filter-view update-criteria"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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\"}]'"
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter-view create": {
"agent_summary": "创建筛选视图",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"需要创建可保存的筛选视图"
],
"avoid_when": [
"创建普通筛选用 sheet filter create",
"更新已有筛选视图用 sheet filter-view update",
"查看筛选视图列表用 sheet filter-view list"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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\""
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter-view delete": {
"agent_summary": "删除筛选视图",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"删除一个已保存的筛选视图"
],
"avoid_when": [
"删除基础筛选用 sheet filter delete",
"只删除某列条件用 sheet filter-view delete-criteria",
"查看筛选视图详情用 sheet filter-view info"
],
"effect": "destructive",
"effect_source": "agent-hint",
"risk": "high",
"confirmation": "user_required",
"idempotency": "unknown",
"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"
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter-view delete-criteria": {
"agent_summary": "删除筛选视图单列筛选条件",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"清除筛选视图中某列的筛选条件"
],
"avoid_when": [
"删除整个筛选视图用 sheet filter-view delete",
"基础筛选清除列条件用 sheet filter clear-criteria",
"更新条件用 sheet filter-view update-criteria"
],
"effect": "destructive",
"effect_source": "agent-hint",
"risk": "high",
"confirmation": "user_required",
"idempotency": "unknown",
"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"
],
"reviewed": true,
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "clear_filter_view_criteria"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter-view get-criteria": {
"agent_summary": "获取单列筛选条件",
"agent_summary_source": "dws-command-surface-review",
"use_when": [
"查看筛选视图某一列的筛选条件"
],
"avoid_when": [
"列出所有列条件用 sheet filter-view list-criteria",
"删除单列条件用 sheet filter-view delete-criteria",
"更新单列条件用 sheet filter-view update-criteria"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"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"
],
"reviewed": true,
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "get_filter_views"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter-view info": {
"agent_summary": "获取单个筛选视图详情",
"agent_summary_source": "dws-command-surface-review",
"use_when": [
"已知道 filterViewId，需要查看名称、范围和配置"
],
"avoid_when": [
"列出所有筛选视图用 sheet filter-view list",
"更新筛选视图用 sheet filter-view update",
"查看列条件用 sheet filter-view list-criteria"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws sheet filter-view info --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e"
],
"reviewed": true,
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "get_filter_views"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter-view list": {
"agent_summary": "列出工作表筛选视图",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"查看有哪些筛选视图"
],
"avoid_when": [
"创建/更新筛选视图用 create/update",
"查看列条件用 sheet filter-view list-criteria",
"查看单个筛选视图详情用 sheet filter-view info"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"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\""
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter-view list-criteria": {
"agent_summary": "列出筛选视图所有列条件",
"agent_summary_source": "dws-command-surface-review",
"use_when": [
"查看筛选视图下每列筛选条件"
],
"avoid_when": [
"基础筛选条件用 sheet filter get/update",
"更新条件用 sheet filter-view update-criteria",
"查看单列条件用 sheet filter-view get-criteria"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws sheet filter-view list-criteria --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --filter-view-id \u003cFV_ID\u003e"
],
"reviewed": true,
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "get_filter_views"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter-view update": {
"agent_summary": "更新筛选视图属性和范围",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"修改筛选视图名称、范围或整体配置"
],
"avoid_when": [
"创建新筛选视图用 sheet filter-view create",
"删除筛选视图用 sheet filter-view delete",
"只改某列筛选条件用 sheet filter-view update-criteria"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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\""
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet filter-view update-criteria": {
"agent_summary": "更新筛选视图列条件",
"agent_summary_source": "dws-command-surface-review",
"use_when": [
"修改筛选视图中某一列的筛选规则"
],
"avoid_when": [
"删除筛选视图列条件用 sheet filter-view delete-criteria",
"更新基础筛选条件用 sheet filter update",
"更新视图名称/范围用 sheet filter-view update"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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\"}]}'"
],
"reviewed": true,
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "set_filter_view_criteria"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet find": {
"agent_summary": "在钉钉电子表格的指定工作表中查找匹配指定文本的所有单元格，返回匹配的单元格地址列表。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"2. 基本搜索 — 在指定工作表中查找文本",
"3. 在指定范围内搜索",
"4. 正则搜索（不区分大小写）",
"5. 精确匹配整个单元格",
"6. 搜索公式文本",
"在指定范围内搜索",
"基本搜索",
"导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；\"帮我找一下表格里的XXX",
"搜索/查找/找单元格/搜内容/精确搜索/精确匹配/完全匹配/全字匹配；搜索公式",
"搜索/查找/找单元格/搜内容/精确搜索/精确匹配/完全匹配/全字匹配；搜索单元格",
"搜索/查找/找单元格/搜内容/精确搜索/精确匹配/完全匹配/全字匹配；正则搜索",
"搜索/查找/找单元格/搜内容/精确搜索/精确匹配/完全匹配/全字匹配；精确匹配（只匹配完全等于的，不匹配包含的）",
"搜索公式文本",
"正则表达式搜索（不区分大小写）",
"精确匹配整个单元格内容"
],
"avoid_when": [
"需要创建、修改或删除数据时不要使用；本命令只用于“在钉钉电子表格的指定工作表中查找匹配指定文本的所有单元格，返回匹配的单元格地址列表。”"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"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\""
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet get-dropdown": {
"agent_summary": "查询单元格下拉列表配置",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"查看某个范围是否配置了下拉列表"
],
"avoid_when": [
"删除下拉列表用 sheet delete-dropdown",
"设置下拉列表用 sheet set-dropdown",
"读取单元格值用 sheet range read"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"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\""
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet get-float-image": {
"agent_summary": "获取钉钉电子表格中指定浮动图片的详细信息。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"查看浮动图片/有哪些浮动图片/浮动图片列表；查看某个浮动图片详情"
],
"avoid_when": [
"需要创建、修改或删除数据时不要使用；本命令只用于“获取钉钉电子表格中指定浮动图片的详细信息。”"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws sheet get-float-image --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --float-image-id \u003cFI_ID\u003e"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet group-dimension": {
"agent_summary": "对钉钉表格指定工作表中的连续整行或整列创建分组",
"agent_summary_source": "runtime-surface-completeness-v1",
"use_when": [
"创建行分组/创建列分组/折叠几行/折叠几列/取消行列分组；创建分组",
"创建行分组/创建列分组/折叠几行/折叠几列/展开行列分组/取消行列分组；创建分组",
"创建行分组/创建列分组/折叠几行/折叠几列/展开行列分组/取消行列分组；创建并折叠"
],
"avoid_when": [
"不需要对钉钉表格指定工作表中的连续整行或整列创建分组时不要使用；如仅查询状态请优先选择对应 list/get/search 命令"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "local",
"availability": "available",
"interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref"
},
"sheet info": {
"agent_summary": "获取指定工作表详情",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"2. 查看工作表详情（确认列结构）",
"2. 查看工作表详情（行列数、最后非空位置、mergedRanges 等）",
"2. 查看工作表详情（行列数、最后非空位置等）",
"看工作表/有哪些工作表/表格结构；工作表详情",
"读数据/看表格内容；需要查看合并单元格 / 表头合并结构"
],
"avoid_when": [
"需要创建、修改或删除数据时不要使用；本命令只用于“获取指定工作表详情”"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws sheet info --node \u003cNODE_ID\u003e",
"dws sheet info --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e"
],
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "get_sheet"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet insert-dimension": {
"agent_summary": "在钉钉表格指定工作表的指定位置之前（before）插入若干空行或空列。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"2. 在第 3 行之前插入 2 行",
"3. 在 A 列之前插入 1 列",
"4. 使用工作表前缀指定位置",
"使用工作表前缀（忽略 --sheet-id）",
"在 A 列之前插入 1 列",
"在 AB 列之前插入 3 列",
"在第 3 行之前插入 2 行",
"插入行/插入列/在某行前插入/在某列前插入；插入行或列",
"查看具体命令的完整参数说明"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“在钉钉表格指定工作表的指定位置之前（before）插入若干空行或空列。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet list": {
"agent_summary": "获取全部工作表列表",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"1. 先查 sheetId",
"1. 获取工作表列表",
"2. 查看工作表列表 — 提取 sheetId",
"导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；\"这个表格有哪些工作表",
"导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel；extension=axls",
"看工作表/有哪些工作表/表格结构；列出工作表"
],
"avoid_when": [
"需要创建、修改或删除数据时不要使用；本命令只用于“获取全部工作表列表”"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws sheet list --node \u003cNODE_ID\u003e",
"dws sheet list --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\""
],
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "get_all_sheets"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet list-float-images": {
"agent_summary": "列出钉钉电子表格指定工作表中的所有浮动图片。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"查看浮动图片/有哪些浮动图片/浮动图片列表；列出所有浮动图片"
],
"avoid_when": [
"需要创建、修改或删除数据时不要使用；本命令只用于“列出钉钉电子表格指定工作表中的所有浮动图片。”"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws sheet list-float-images --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet media-upload": {
"agent_summary": "上传附件到表格",
"agent_summary_source": "dws-command-surface-review",
"use_when": [
"1. 基本用法: 上传本地文件到表格",
"2. 自定义附件显示名称 (--name 指定上传后在表格中显示的名称)",
"3. 指定 MIME 类型 (文件扩展名无法推断时)",
"上传附件/传文件到表格/上传文件到表格/上传到表格；上传附件",
"上传附件/传文件到表格/上传文件到表格/上传到表格；用户指定了上传后的名称",
"上传附件到表格",
"先上传图片获取 resourceUrl",
"提取 nodeId 后:",
"浮动图片/悬浮图片/在表格上放一张图/加个浮动的图；创建浮动图片"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“上传附件到表格”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": true,
"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"
],
"interface_mode": "composite",
"availability": "available",
"interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref"
},
"sheet merge-cells": {
"agent_summary": "将钉钉电子表格中指定工作表的指定区域内的单元格合并为一个或多个合并区域。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"2. 合并所有单元格（默认 mergeAll）",
"3. 按行合并",
"4. 按列合并",
"使用带工作表前缀的范围（忽略 --sheet-id）",
"合并单元格/合并/合并区域/按行合并/按列合并；合并所有单元格",
"合并单元格/合并/合并区域/按行合并/按列合并；按列合并",
"合并单元格/合并/合并区域/按行合并/按列合并；按行合并",
"合并所有单元格（默认）",
"按列合并",
"按行合并"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“将钉钉电子表格中指定工作表的指定区域内的单元格合并为一个或多个合并区域。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet move-dimension": {
"agent_summary": "在钉钉表格的指定工作表中，将指定范围的行或列移动到目标位置。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"将 B~C 列移动到 E 列的位置",
"将 B~C 列（共 2 列）移动到 D 列的位置",
"将第 2 行移动到第 5 行的位置",
"将第 2 行移动到第 5 行的位置（索引从 0 开始）",
"将第 2~4 行移动到第 1 行之前",
"将第 2~4 行（共 3 行）移动到第 1 行的位置（最前面）",
"移动行/移动列/调整行顺序/调整列顺序/行列拖拽/把第N行移到第M行；移动行或列"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“在钉钉表格的指定工作表中，将指定范围的行或列移动到目标位置。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet new": {
"agent_summary": "新建工作表",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"1. 新建工作表",
"加工作表/新增Sheet；新建工作表"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“新建工作表”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"examples": [
"dws sheet new --node \u003cNODE_ID\u003e --name \"Sheet2\"",
"dws sheet new --node \u003cNODE_ID\u003e --name \"数据汇总\""
],
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "create_sheet"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet range batch-clear": {
"agent_summary": "批量清除多个区域的内容或格式",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"一次清除多个 range 的值、格式或全部内容"
],
"avoid_when": [
"写入/更新值用 sheet range update",
"删除整张工作表用 sheet delete-sheet",
"只清除一个区域用 sheet range clear"
],
"effect": "destructive",
"effect_source": "agent-hint",
"risk": "high",
"confirmation": "user_required",
"idempotency": "unknown",
"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"
],
"reviewed": true,
"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"
],
"interface_mode": "local",
"availability": "available",
"interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref"
},
"sheet range batch-set-style": {
"agent_summary": "批量设置多个区域的单元格样式或格式",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"一次更新多个 range 的样式或格式"
],
"avoid_when": [
"写入单元格值用 sheet range update",
"只设置一个区域样式用 sheet range set-style",
"清空多个区域用 sheet range batch-clear"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": true,
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "update_range"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet range clear": {
"agent_summary": "清除钉钉电子表格中指定工作表指定范围的单元格内容、格式或全部。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"删除行/删除列/删掉第几行/删掉某列/移除行/移除列；仅清空内容但保留行/列",
"清空/清除区域/擦除内容/清除格式；仅清除值",
"清空/清除区域/擦除内容/清除格式；仅清除格式",
"清空/清除区域/擦除内容/清除格式；全部清除",
"清空/清除区域/擦除内容/清除格式；清除区域",
"清空整片区域请改用 range clear"
],
"avoid_when": [
"要“基于源数据范围自动填充到目标范围”请改用 dws sheet range fill",
"要“对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值”请改用 dws sheet range batch-set-style",
"要“将源范围的数据复制到目标位置”请改用 dws sheet range copy-to"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"examples": [
"dws sheet range clear --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:B3\""
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet range copy-to": {
"agent_summary": "复制源区域到目标区域",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"把一个 range 的数据复制到另一个位置"
],
"avoid_when": [
"写入新值用 sheet range update",
"只读取源数据用 sheet range read",
"移动并清空源区域用 sheet range move-to"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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\""
],
"reviewed": true,
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "copy_range"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet range fill": {
"agent_summary": "基于源数据范围自动填充到目标范围。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"自动填充/填充序列/向下填充/拖拽填充/序列递增；自动填充"
],
"avoid_when": [
"要“对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值”请改用 dws sheet range batch-set-style",
"要“将源范围的数据复制到目标位置”请改用 dws sheet range copy-to",
"要“清除钉钉电子表格中指定工作表指定范围的单元格内容、格式或全部”请改用 dws sheet range clear"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet range move-to": {
"agent_summary": "移动源区域到目标区域并清空源区域",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"把一个 range 移动到目标位置"
],
"avoid_when": [
"只复制不清空源区域用 sheet range copy-to",
"只读取数据用 sheet range read",
"清空区域用 sheet range clear"
],
"effect": "destructive",
"effect_source": "agent-hint",
"risk": "high",
"confirmation": "user_required",
"idempotency": "unknown",
"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\""
],
"reviewed": true,
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "move_range"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet range read": {
"agent_summary": "读取工作表指定区域的单元格值",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"读取某个 range 的数据或值"
],
"avoid_when": [
"写入值用 sheet range update",
"清空内容/格式用 sheet range clear 或 batch-clear",
"读取 CSV 格式用 sheet csv-get"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws sheet range read --node \u003cNODE_ID\u003e",
"dws sheet range read --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e"
],
"reviewed": true,
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "get_range"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet range set-style": {
"agent_summary": "设置单个区域的单元格样式",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"设置一个 range 的字体、颜色、对齐、数字格式等样式"
],
"avoid_when": [
"写入单元格值用 sheet range update",
"批量设置多个区域样式用 sheet range batch-set-style",
"条件高亮用 sheet cond-format create/update"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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\"]]'"
],
"reviewed": true,
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "update_range"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet range sort": {
"agent_summary": "对钉钉电子表格中指定工作表指定范围的数据进行排序。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"排序/给数据排序/按某列排序/升序/降序；区域排序"
],
"avoid_when": [
"要“基于源数据范围自动填充到目标范围”请改用 dws sheet range fill",
"要“对于一个钉钉在线表格，更新指定区域内单元格信息，包括单元格中的值”请改用 dws sheet range batch-set-style",
"要“清除钉钉电子表格中指定工作表指定范围的单元格内容、格式或全部”请改用 dws sheet range clear"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet range update": {
"agent_summary": "写入或更新工作表指定区域的单元格值/超链接",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"向指定 range 写入二维数组值或超链接"
],
"avoid_when": [
"只改样式用 sheet range set-style 或 batch-set-style",
"只读数据用 sheet range read",
"清空区域用 sheet range clear"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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\"}]]'"
],
"reviewed": true,
"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"
],
"interface_ref": {
"product_id": "sheet",
"rpc_name": "update_range"
},
"interface_mode": "mcp",
"availability": "available"
},
"sheet replace": {
"agent_summary": "在钉钉表格的指定工作表中，全局查找并替换文本内容。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"替换/查找替换/全局替换/批量替换/把A替换成B/把所有的X改成Y；删除匹配内容",
"替换/查找替换/全局替换/批量替换/把A替换成B/把所有的X改成Y；查找替换",
"替换/查找替换/全局替换/批量替换/把A替换成B/把所有的X改成Y；正则替换",
"替换/查找替换/全局替换/批量替换/把A替换成B/把所有的X改成Y；精确匹配后替换（只替换内容完全等于的单元格）"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“在钉钉表格的指定工作表中，全局查找并替换文本内容。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet set-dropdown": {
"agent_summary": "设置单元格下拉列表配置",
"agent_summary_source": "sheet-range-filter-agent-review-v1",
"use_when": [
"给指定范围配置下拉选项"
],
"avoid_when": [
"删除下拉配置用 sheet delete-dropdown",
"只查询下拉配置用 sheet get-dropdown",
"设置条件格式用 sheet cond-format create"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": true,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet template apply": {
"agent_summary": "使用指定模板创建新表格文档",
"agent_summary_source": "runtime-surface-completeness-v1",
"use_when": [
"使用指定模板创建新表格文档"
],
"avoid_when": [
"不需要使用指定模板创建新表格文档时不要使用；如仅查询状态请优先选择对应 list/get/search 命令"
],
"effect": "write",
"effect_source": "agent-hint",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"examples": [
"dws sheet template apply --help"
],
"reviewed": false,
"source_refs": [
"skills/mono/schema-hints/runtime-surface-completeness.json"
],
"interface_mode": "local",
"availability": "available",
"interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref"
},
"sheet template list": {
"agent_summary": "获取当前用户可用的表格模板列表，支持按来源筛选",
"agent_summary_source": "runtime-surface-completeness-v1",
"use_when": [
"获取当前用户可用的表格模板列表，支持按来源筛选"
],
"avoid_when": [
"不需要获取当前用户可用的表格模板列表，支持按来源筛选时不要使用；如仅查询状态请优先选择对应 list/get/search 命令"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws sheet template list --help"
],
"reviewed": false,
"source_refs": [
"skills/mono/schema-hints/runtime-surface-completeness.json"
],
"interface_mode": "local",
"availability": "available",
"interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref"
},
"sheet template search": {
"agent_summary": "根据关键词搜索表格模板",
"agent_summary_source": "runtime-surface-completeness-v1",
"use_when": [
"根据关键词搜索表格模板"
],
"avoid_when": [
"不需要根据关键词搜索表格模板时不要使用；如仅查询状态请优先选择对应 list/get/search 命令"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws sheet template search --help"
],
"reviewed": false,
"source_refs": [
"skills/mono/schema-hints/runtime-surface-completeness.json"
],
"interface_mode": "local",
"availability": "available",
"interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref"
},
"sheet ungroup-dimension": {
"agent_summary": "取消钉钉表格指定工作表中的连续整行或整列分组",
"agent_summary_source": "runtime-surface-completeness-v1",
"use_when": [
"创建行分组/创建列分组/折叠几行/折叠几列/取消行列分组；取消分组",
"创建行分组/创建列分组/折叠几行/折叠几列/展开行列分组/取消行列分组；取消分组"
],
"avoid_when": [
"不需要取消钉钉表格指定工作表中的连续整行或整列分组时不要使用；如仅查询状态请优先选择对应 list/get/search 命令"
],
"effect": "read",
"effect_source": "agent-hint",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"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\""
],
"reviewed": false,
"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"
],
"interface_mode": "local",
"availability": "available",
"interface_reason": "当前命令来自本地 Cobra 命令树或复合 helper，无固定 MCP interface_ref"
},
"sheet unmerge-cells": {
"agent_summary": "取消钉钉表格指定工作表中指定范围内的合并单元格。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"取消合并/拆分单元格/还原合并；取消合并单元格"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“取消钉钉表格指定工作表中指定范围内的合并单元格。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"examples": [
"dws sheet unmerge-cells --node \u003cNODE_ID\u003e --sheet-id \u003cSHEET_ID\u003e --range \"A1:D5\""
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet update": {
"agent_summary": "更新钉钉电子表格中指定工作表的属性，包括名称、位置、可见性、冻结行列等。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；冻结行列",
"修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；取消冻结",
"修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；显示工作表",
"修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；更新工作表属性",
"修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；移动工作表位置",
"修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；重命名工作表",
"修改工作表名称/重命名工作表/移动工作表位置/隐藏工作表/显示工作表/冻结行/冻结列/取消冻结/更新工作表属性；隐藏工作表",
"取消冻结",
"改名 + 调整冻结",
"显示工作表",
"移动工作表到第一个位置",
"隐藏工作表"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“更新钉钉电子表格中指定工作表的属性，包括名称、位置、可见性、冻结行列等。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet update-dimension": {
"agent_summary": "批量更新钉钉表格指定工作表中连续多行/多列的属性，支持设置显隐状态（hidden）与行高/列宽（pixelSize）。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"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 行",
"隐藏行/隐藏列/显示行/显示列/设置行高/设置列宽/调整行高/调整列宽/行列属性；同时修改尺寸与显隐",
"隐藏行/隐藏列/显示行/显示列/设置行高/设置列宽/调整行高/调整列宽/行列属性；设置行高/列宽",
"隐藏行/隐藏列/显示行/显示列/设置行高/设置列宽/调整行高/调整列宽/行列属性；隐藏/显示行或列"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“批量更新钉钉表格指定工作表中连续多行/多列的属性，支持设置显隐状态（hidden）与行高/列宽（pixelSize）。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet update-float-image": {
"agent_summary": "更新钉钉电子表格中指定浮动图片的属性。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"替换图片（需先 media-upload 新图片获取 resourceUrl）",
"移动浮动图片/调整浮动图片大小/修改浮动图片/更新浮动图片；更新浮动图片属性",
"移动浮动图片到新位置",
"调整尺寸"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“更新钉钉电子表格中指定浮动图片的属性。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
},
"sheet write-image": {
"agent_summary": "在钉钉表格的指定单元格中插入图片。",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"1. 基本用法: 写入图片到指定单元格",
"2. 指定显示尺寸",
"3. 自定义图片名称",
"写入图片/插入图片/加图片/放图片到单元格/嵌入图片到表格；写入图片",
"写入图片/插入图片/加图片/放图片到单元格/嵌入图片到表格；用户指定了图片尺寸",
"提取 nodeId 后:"
],
"avoid_when": [
"仅需查询状态或预览结果、不应产生“在钉钉表格的指定单元格中插入图片。”所述变更时不要使用"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"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"
],
"reviewed": false,
"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"
],
"interface_mode": "mcp",
"availability": "available"
}
}
}
Reference in New Issue View Git Blame Copy Permalink