dingtalk-aitable

价格

以上为公开标价。你的组织可能有协议价，以控制台显示的价格为准。

如何使用

1. 1

   为组织安装

   开通即安装：组织固定使用开通时的版本（当前为 1.0.0）。升级到新版本需要取消后重新开通。

2. 2

   创建凭证

   客户端使用组织凭证读取；绑定到数字人后，数字人使用绑定凭证按需加载。请求中携带：

   Authorization: Bearer $ZGI_MARKET_KEY

3. 3

   读取清单与安装包

   清单列出版本、文件和校验值；安装包是一个 zip 文件。

   curl "https://market-api.zgi.im/v1/market/skills/dingtalk-aitable/manifest" \
     -H "Authorization: Bearer $ZGI_MARKET_KEY"

   curl "https://market-api.zgi.im/v1/market/skills/dingtalk-aitable/package" \
     -H "Authorization: Bearer $ZGI_MARKET_KEY" \
     -o dingtalk-aitable.zip

   读取清单和下载安装包不计入用量。下载后请用响应头中的 SHA-256 校验文件。

技能说明

名称

dingtalk-aitable

说明

钉钉 AI 表格（多维表）。Use when 用户说 AI表格/多维表/数据表/base/table/建表/查记录/写数据/字段/记录增删改查/筛选/排序/公式/模板搜索/批量导入CSV或JSON/导出/仪表盘/图表/上传附件到表格/按字段类型建表/数据源/创建数据源/更新数据源配置/触发数据源同步/按任务 ID 查询同步状态/获取数据源配置/列出数据源可用来源/获取数据源可同步字段/审批数据同步。不做电子表格单元格读写（走 dingtalk-misc）、文档编辑（走 dingtalk-doc）；听记待办入表先用 dingtalk-minutes 提取，再由本 skill 写入。命令前缀：dws aitable。

# 钉钉 AI 表格 Skill

<!-- DWS_RUNTIME_CONTRACT_START -->
## 最小 DWS 执行契约

- 只通过 `dws` CLI 操作钉钉；结构化读取使用 `--format json`，按真实返回判断结果。
- 已知命令直接执行。只有 leaf 参数或安全语义不确定时读取精确 Schema，只有 Cobra flag 不确定时读取精确 leaf Help；不要加载产品级 Catalog 代替选路。
- 不猜命令、flag、字段、ID、账号或时间。后续 ID 必须来自真实返回；零命中、多候选或类型不明时停止并消歧。
- 解析目标、读取上下文和最终执行必须使用同一 profile；不得跨组织复用 userId、openDingTalkId 或 openConversationId。多账号组织只使用明确的 `isOrgCurrent=true` 默认账号；没有默认账号时要求用户指定，禁止选择第一项、最近登录或最近使用账号。
- 不输出或记录 token、refresh token、appSecret、webhook token 等凭据；宿主已注入认证时不要索要凭据。
- 写操作必须符合用户明确意图。是否需要确认以最终 Runtime gate 和 Schema 为准；本轮用户已明确要求执行、目标与影响无歧义的非破坏性写操作时，该明确指令就是本次确认，首次调用直接携带 Runtime 所需的 `--yes`，不先制造 `confirmation_required`。删除、停用自动化等破坏性或高风险动作仍须先说明对象、动作与影响并取得独立确认。
- 写后按任务结果契约验证；不能仅凭退出码宣称成功。部分结果、未知投递状态和失败项必须如实保留。
- 时间戳面向用户展示时转换为带时区的可读时间；默认使用当前会话时区，必要时同时保留原值。
- 遇到认证、权限、profile、confirmation 或未知错误时，只加载 `dingtalk-shared` 中对应 reference；不要连续猜测替代命令。
<!-- DWS_RUNTIME_CONTRACT_END -->

<!-- VISIBLE_SHORTCUTS_START -->
## Shortcut 发现（按需）

`aitable` 当前有 100 条公开 shortcut，完整清单保留在 Runtime Catalog 与 Schema，不在高频产品根 Skill 中重复展开。已知意图直接使用下方的优先路由、意图表或任务 reference；命令已选中时直接执行，只在参数/安全语义不确定时读取 leaf Schema，在当前 Cobra flags 不确定时读取 leaf Help。

仅当现有路由和 reference 都无法定位低频能力时，才执行 `dws shortcut list --service aitable --format json` 做最后回退；不要为已知高频意图加载完整 Shortcut Catalog 或产品级 Schema。
<!-- VISIBLE_SHORTCUTS_END -->

## Golden Route

已有 ID 直接使用；完整 URL 先解析；名称先唯一解析为稳定 ID。零命中或多候选时停止，不默认选第一项。

| 用户意图 | 唯一推荐入口 | 关键边界 |
|---|---|---|
| 从 URL 解析稳定 ID | `dws aitable +url-resolve --url <URL>` | 只解析 URL 中已有的 baseId/tableId/viewId/recordId，不做远端名称搜索 |
| 按名称唯一定位并操作 Base/Table | `dws aitable +resolve-base --name <名称>` → `dws aitable +resolve-table --base <ID> --name <表名>` | 默认精确匹配；只有用户明确接受模糊匹配时才加 `--fuzzy` |
| 浏览 Base 下的数据表 | `dws aitable +list-tables --base <ID>` | 只返回 tableId/tableName，不加载字段 |
| 搜索 Base 候选或检查是否存在 | `dws aitable +base-search --query <关键词>` | 用户说“搜索/找一下/候选/如果没有就创建”时直接走本入口，不先调用 `+resolve-base`；AITable 上下文中的 Base 名称不得路由到 `dws aisearch person` |
| 新建 Base 与整套表字段 | `dws aitable +base-bootstrap --name <名称> --tables '[{"name":"<表名>","fields":[{"fieldName":"<字段名>","type":"text"}]}]'` | 表对象键必须是 `name`，不是 `tableName`；字段使用 `fieldName/type/config`；参数已足够时直接执行，不读 Reference 或 Help |

• SKILL.md14.9 KiB
• references/06-data-analytics.md1.8 KiB
• references/aitable-record-ops.md5.2 KiB
• references/aitable-section.md1.3 KiB
• references/aitable.md9.3 KiB
• references/aitable/aitable-advperm.md10.2 KiB
• references/aitable/aitable-attachment.md2.1 KiB
• references/aitable/aitable-best-practices.md2.5 KiB
• references/aitable/aitable-cell-value.md8.6 KiB
• references/aitable/aitable-dashboard-chart.md3.3 KiB
• references/aitable/aitable-data-analysis-sop.md5.5 KiB
• references/aitable/aitable-datasource.md12.2 KiB
• references/aitable/aitable-error-recovery.md5.3 KiB
• references/aitable/aitable-export-import.md6.0 KiB
• references/aitable/aitable-field-properties.md7.6 KiB
• references/aitable/aitable-field.md7.7 KiB
• references/aitable/aitable-filter-sort.md7.8 KiB
• references/aitable/aitable-form.md7.3 KiB
• references/aitable/aitable-formula-guide.md7.0 KiB
• references/aitable/aitable-primary-doc.md2.2 KiB
• references/aitable/aitable-record-create.md2.2 KiB
• references/aitable/aitable-record-delete.md582 B
• references/aitable/aitable-record-history.md3.5 KiB
• references/aitable/aitable-record-name-key.md2.4 KiB
• references/aitable/aitable-record-query.md4.8 KiB
• references/aitable/aitable-record-share.md1.6 KiB
• references/aitable/aitable-record-stats.md2.9 KiB
• references/aitable/aitable-record-update.md2.9 KiB
• references/aitable/aitable-record-upsert.md3.3 KiB
• references/aitable/aitable-view-config.md11.8 KiB
• references/aitable/aitable-view-extras.md8.0 KiB
• references/aitable/aitable-workflow.md15.1 KiB
• references/field-rules.md5.2 KiB
• references/intent-guide.md1.8 KiB
• references/recipes/conventions.md3.4 KiB
• references/url-patterns.md9.0 KiB
• scripts/aitable_export_via_task.py7.6 KiB
• scripts/aitable_import_via_task.py5.8 KiB
• scripts/bulk_add_fields.py9.1 KiB
• scripts/import_records.py9.7 KiB
• scripts/upload_attachment.py6.3 KiB

来源与审核

审核状态

尚未审核，内容来自上游来源

许可证

未说明

审核状态是平台对上架信息的记录，不构成对上游服务质量或可用性的担保。