dingtalk-aitable

name	dingtalk-aitable
description	钉钉 AI 表格（多维表）。Use when 用户说 AI表格/多维表/数据表/base/table/建表/查记录/写数据/字段/记录增删改查/筛选/排序/公式/模板搜索/批量导入CSV或JSON/导出/仪表盘/图表/上传附件到表格/按字段类型建表。Distinct from 主 dws skill 的 dws sheet(电子表格/单元格读写/公式)、dws doc(文档编辑)。命令前缀：dws aitable。
cli_version	>=0.2.14
metadata	{"category":"product","stability":"experimental","requires":{"bins":["dws"]}}

钉钉 AI 表格 Skill

🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。20 个 dingtalk-* skill 全部通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整；生产 / 共享环境请优先使用 mono 模式（dws skill setup --mode mono）。问题请提 issue 反馈。

PREREQUISITE: Read the root dws skill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. The dws binary must be on PATH.

⚠️ 命令可用性可能因企业服务发现配置而异。本文档列出的命令基于 dws envelope schema 与本仓库 v1.0.30 实测，但部分命令的 cobra 子命令暴露与否还取决于你的企业 MCP gateway 是否注册了对应 tool。如果跑某条命令报 unknown command 或 fall back 到父级 help，说明当前账号企业未开通该能力。实际调用前可用 dws <cmd> --help 或 --dry-run 验证。

命令参考：aitable.md；复杂命令按需加载 references/aitable/*.md；剧本：06-data-analytics.md。

意图表

用户说	命令
"搜表格 / 找一个 base"	dws aitable base search --query "<名>"
"创建 AI 表格 / 多维表"	dws aitable base create --name "<名称>" [--template-id <id>]
"查数据表 / 建数据表"	dws aitable table get --base-id <baseId> / dws aitable table create --base-id <baseId> --name "<表名>" --fields '[...]'
"查字段 / 字段类型"	dws aitable field get --base-id <id> --table-id <id>
"查记录 / 搜索记录"	dws aitable record query --base-id <baseId> --table-id <tableId> [--filters '...']
"写记录 / 更新记录 / 删除记录"	dws aitable record create/update/delete --base-id <baseId> --table-id <tableId> ...
"筛选 / 排序 / 公式 / 跨表引用"	先读 references/aitable/aitable-filter-sort.md / aitable-formula-guide.md
"批量导入 JSON / CSV"	python scripts/import_records.py <baseId> <tableId> data.csv|data.json
"批量加字段"	python scripts/bulk_add_fields.py --base-id <id> --table-id <id> --fields fields.json
"导入 / 导出表格"	先读 references/aitable/aitable-export-import.md；导出优先 python scripts/aitable_export_via_task.py <baseId> --scope table --table-id <tableId>
"仪表盘 / 图表"	先读 references/aitable/aitable-dashboard-chart.md
"上传附件到记录"	先读 references/aitable/aitable-attachment.md；可用 python scripts/upload_attachment.py --base-id <id> --file <path>

危险操作

base delete / table delete / field delete / record delete 不可逆，必须先向用户确认再加 --yes。

评测高频硬约束

• 创建/改字段/写记录是多轮连续任务时，不能在"让我执行/先获取 ID"后停下；必须实际调用对应 dws aitable 命令并验证结果。
• 字段重命名使用 dws aitable field update --base-id <baseId> --table-id <tableId> --field-id <fieldId> --name "<新名称>" --format json；先 field get 找真实 fieldId，不要猜字段名能直接更新。
• 写记录前必须 field get 获取 fieldId 与类型；record create/update 的 cells key 用 fieldId，不是字段中文名。长 JSON 使用 --records-file。
• 表或字段创建返回名称被系统自动加后缀时，后续必须使用返回的真实 tableId/fieldId，不要继续按原名称猜。
• record update/delete 先 record query/list 定位 recordId；删除必须确认，普通新增/更新按用户明确要求可直接执行后读回验证。
• record query/create/update/delete、field create、导入导出、图表和附件场景必须先读对应 references/aitable/*.md，不要凭旧单文件参数猜 flag。

字段类型规则

详见本 skill 的 field-rules.md。

跨产品协作

• 单元格 / 工作表 / 公式 → 走主 dws skill 的 sheet 产品路由（dws sheet）