功能概述
钉钉 AI 表格技能（dingtalk-ai-table）是面向企业用户的多维表格自动化操作工具，通过调用钉钉 Notable API（/v1.0/notable）实现对工作表、字段、记录的完整生命周期管理。不同于传统电子表格，AI 表格采用多维数据模型，支持更复杂的企业级数据协作场景。
核心能力
- 工作表管理：创建、删除、查询工作表结构
- 字段管理：支持文本、数字、日期等字段类型的增删改
- 记录操作：新增、查询、更新、删除数据记录，支持条件筛选
- 身份集成：自动转换 userId 与 unionId，与企业钉钉组织架构打通
显著优点
1. 深度钉钉生态集成：直接调用企业内部数据，无需额外同步
2. 自动化工作流：支持脚本化批量操作，可融入 CI/CD 或定时任务
3. 权限继承：复用钉钉企业权限体系，数据安全可控
4. 多维数据模型：字段类型丰富，支持比 Excel 更复杂的业务场景
潜在局限与风险
- 配置门槛高：需钉钉开放平台应用密钥、userId、base_id 等多参数
- Token 失效风险：缓存机制无法感知吊销，需手动
--nocache刷新 - API 调用限制：受钉钉平台频次限制，高频场景需设计兜底
- 数据误操作风险：删除字段/记录不可逆，脚本执行前需充分验证
- 依赖企业权限：个人用户无法独立使用，必须有钉钉企业环境
适用人群
- 企业 IT 管理员：自动化数据维护与报表生成
- 业务系统开发者：将钉钉表格作为轻量级数据后端
- 数字化转型团队：构建低代码数据工作流
使用建议
首次使用务必按文档完成 DINGTALK_APP_KEY、DINGTALK_APP_SECRET、DINGTALK_MY_USER_ID 等配置，并通过 dt_helper.sh 工具管理凭证。生产环境操作建议先测试读取权限，确认无误后再执行写入/删除类操作。