aitable-workflow-cli 0.1.25 → 0.1.26-beta.1788916459616

package/templates/_shared/aitable-faq/.kb/wiki/concepts//346/240/270/345/277/203/347/237/245/350/257/206.md

@@ -1,44 +1,43 @@
 ---
-title: AI表格文档对象模型核心知识
-category: concepts
+title: AI 表格文档对象模型核心知识
+category: concept
 sources: [18-开发者指南/AI表格边栏插件 开发指南/核心知识.md]
-created: 2026-08-24
-updated: 2026-08-24
-tags: [AI表格, 对象模型, 边栏插件, DingdocsScript]
-aliases: [AI表格DOM, 对象模型, 核心知识]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [对象模型, Base, Sheet, 边栏插件, 架构]
+aliases: [文档对象模型, AI表格对象模型, DOM]
 confidence: high
-summary: 介绍AI表格边栏插件开发中的文档对象模型（DOM），包括 Base、Sheet、View、Field、Record 等核心对象及其层级关系。通过 DingdocsScript.base 获取顶级对象后，可逐层访问数据表、视图、字段、记录并执行增删改查。
+summary: AI 表格文档对象模型的核心概念，阐述 Base、Sheet、View、Field、Record 五大对象的层级关系与获取方式，是边栏插件开发的基础认知。
 ---
 
-> AI表格文档对象模型是边栏插件开发的基础。理解各核心对象的层级关系与获取方式，才能正确调用 API 对表格数据执行增删改查。
+> AI 表格文档对象模型是边栏插件与表格数据交互的基础。理解 Base → Sheet → View/Field/Record 的层级结构，是正确调用各级 API 的前提。
 
-## 常用对象
-
-AI表格的数据对象模型有以下几类：
+## 对象层级结构
 
 ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/vBPlN5m0zy8wkOdG/img/d16de762-8859-4314-9378-6ff83bafca59.png)
 
+AI 表格的数据对象模型包含以下几类：
+
 | 对象 | 说明 | 获取方式 |
-|------|------|----------|
-| **Base** | AI表格，顶级对象，可包含多个数据表 | 边栏插件中通过 `DingdocsScript.base` 引用 |
-| **Sheet** | 数据表，包含多个视图、字段、记录 | 通过 Base API 获取具体 Sheet 对象 |
-| **View** | 视图 | 通过 Sheet API 获取 |
-| **Field** | 字段 | 通过 Sheet API 获取 |
-| **Record** | 记录 | 通过 Sheet API 获取 |
-| ~~Cell~~ | 单元格（暂不支持） | — |
+|------|------|---------|
+| **Base** | AI 表格顶级对象，可包含多个数据表 | `DingdocsScript.base` |
+| **Sheet** | 数据表，包含视图、字段和记录 | 通过 Base API 获取 |
+| **View** | 视图，数据表的呈现方式 | 通过 Sheet API 获取 |
+| **Field** | 字段，定义数据表的列结构 | 通过 Sheet API 获取 |
+| **Record** | 记录，数据表中的一行数据 | 通过 Sheet API 获取 |
 
 ## 快速开始
 
 操作 AI 表格数据遵循两步模式：**先确定要操作的对象，再调用该对象上的 API**。
 
-以新增一条标题为"测试用例"的记录为例，需先通过 Base API 获取激活的 Sheet，再调用 Sheet 的 `insertRecordAsync` 插入数据：
+以新增一条记录为例：
 
 ```typescript
 // script.ts
 async function insertRecord() {
-  // 获取当前激活的数据表
+  // 1. 获取当前激活的数据表
   const sheet = DingdocsScript.base.getActiveSheet();
-  // 向这个数据表中新增一条记录
+  // 2. 调用 Sheet 的 API 插入记录
   await sheet.insertRecordAsync({
     fields: {
       "标题": "测试用例",
@@ -47,26 +46,28 @@ async function insertRecord() {
 }
 DingdocsScript.registerScript('insertRecord', insertRecord);
 
-// ui.tsx
+// ui.tsx — 在 UI 侧调用注册的脚本
 await Dingdocs.script.run('insertRecord');
 ```
 
-## 参考文档
+## 关键要点
 
-详细的 API 定义请参阅钉钉文档中的《AI 表格对象模型 API 参考文档》。
+1. **Base 是入口**：所有数据访问从 `DingdocsScript.base` 开始
+2. **Sheet 是枢纽**：字段、视图、记录的管理都通过 Sheet 对象完成
+3. **逐级获取**：不能跳级直接获取 Record，需要先获取 Sheet 再获取 Record
 
 ## See Also
 
-- [AI表格插件-脚本插件](./AI表格插件-脚本插件.md)
-- [AI表格插件-自定义插件](./AI表格插件-自定义插件.md)
-- [AI表格三方插件使用授权](./AI表格三方插件使用授权.md)
-- [[AI表格 (多维表) OpenAPI 帮助文档|AI表格 OpenAPI 帮助文档]] ([AI表格 OpenAPI 帮助文档](../references/AI表格 (多维表) OpenAPI 帮助文档.md))
-- [[Record 模块|Record 模块 API 参考]] ([Record 模块 API 参考](../references/Record 模块.md))
-- [[View 模块|View 模块 API 参考]] ([View 模块 API 参考](../references/View 模块.md))
+- [AI表格边栏插件 开发指南](../topics/AI表格边栏插件%20开发指南.md)
+- [Sheet 模块](../references/Sheet%20模块.md)
+- [Record 模块](../references/Record%20模块.md)
+- [View 模块](../references/View%20模块.md)
+- [[AI表格边栏插件 开发指南|AI 表格边栏插件开发指南]] ([AI 表格边栏插件开发指南](<../topics/AI表格边栏插件 开发指南.md>))
+- [[Record 模块|Record 模块 API 参考]] ([Record 模块 API 参考](<../references/Record 模块.md>))
+- [[View 模块|View 模块 API 参考]] ([View 模块 API 参考](<../references/View 模块.md>))
 - [[其他接口|其他接口 API 参考]] ([其他接口 API 参考](../references/其他接口.md))
 - [[字段数据结构|字段数据结构参考]] ([字段数据结构参考](../references/字段数据结构.md))
-- [[AI表格边栏插件 开发指南|AI 表格边栏插件开发指南]] ([AI 表格边栏插件开发指南](../topics/AI表格边栏插件 开发指南.md))
-- [[钉钉AI表格FAQ|钉钉 AI 表格常见问题 FAQ]] ([钉钉 AI 表格常见问题 FAQ](../topics/钉钉AI表格FAQ.md))
+- [[钉钉AI表格FAQ|钉钉 AI 表格常见问题解答]] ([钉钉 AI 表格常见问题解答](../topics/钉钉AI表格FAQ.md))
 
 ## Sources
 

package/templates/_shared/aitable-faq/.kb/wiki/concepts//350/267/250AI/350/241/250/346/240/274/346/225/260/346/215/256/345/220/214/346/255/245.md

@@ -98,6 +98,7 @@ summary: 跨AI表格数据同步功能可将不同AI表格的数据同步或汇
 - [组织内共享数据源](../concepts/组织内共享数据源.md)
 - [钉钉AI听记数据同步](../concepts/钉钉AI听记数据同步.md)
 - [[单选多选字段同步其他表选项|单选多选字段同步其他表选项]] ([单选多选字段同步其他表选项](../topics/单选多选字段同步其他表选项.md))
+- [[钉钉AI表格FAQ|钉钉 AI 表格 FAQ]] ([钉钉 AI 表格 FAQ](../topics/钉钉AI表格FAQ.md))
 
 ## Sources
 

package/templates/_shared/aitable-faq/.kb/wiki/concepts//351/200/217/350/247/206/350/241/250/350/247/206/345/233/276.md

@@ -89,6 +89,7 @@ summary: 透视表视图通过拖拽字段实现多维度汇总统计，支持
 - [使用AI表格视图](../topics/使用AI表格视图.md)
 - [表格视图](../concepts/表格视图.md)
 - [数据表和视图的关系](../concepts/数据表和视图的关系.md)
+- [[钉钉AI表格FAQ|钉钉 AI 表格 FAQ]] ([钉钉 AI 表格 FAQ](../topics/钉钉AI表格FAQ.md))
 
 ## Sources
 

package/templates/_shared/aitable-faq/.kb/wiki/log.md

@@ -2,6 +2,63 @@
 
 ## [2026-07-20] 全量编译 | 189 新建, 0 更新, 0 跳过
 ## [2026-07-30] 增量编译 | 0 新建, 1 更新, 188 跳过
-## [2026-08-24] 增量编译 | 0 新建, 0 更新, 188 跳过, 3 失败
-## [2026-08-24] 增量编译 | 0 新建, 0 更新, 188 跳过, 3 失败
-## [2026-08-24] 增量编译 | 2 新建, 1 更新, 188 跳过
+## [2026-07-31] 增量编译 | 0 新建, 0 更新, 189 跳过
+## [2026-08-02] 增量编译 | 0 新建, 0 更新, 188 跳过, 1 失败
+## [2026-08-02] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-04] 增量编译 | 0 新建, 0 更新, 188 跳过, 1 失败
+## [2026-08-04] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-11] 增量编译 | 0 新建, 0 更新, 189 跳过
+## [2026-08-11] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-11] 增量编译 | 0 新建, 0 更新, 188 跳过, 1 失败
+## [2026-08-11] 增量编译 | 0 新建, 0 更新, 188 跳过, 1 失败
+## [2026-08-11] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-12] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-13] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-13] 增量编译 | 0 新建, 0 更新, 188 跳过, 1 失败
+## [2026-08-13] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-13] 增量编译 | 0 新建, 0 更新, 188 跳过, 1 失败
+## [2026-08-13] 增量编译 | 0 新建, 0 更新, 188 跳过, 1 失败
+## [2026-08-13] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-13] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-13] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-13] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-14] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-14] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-14] 增量编译 | 0 新建, 0 更新, 188 跳过, 1 失败
+## [2026-08-14] 增量编译 | 0 新建, 1 更新, 188 跳过
+## [2026-08-14] 增量编译 | 2 新建, 0 更新, 189 跳过
+## [2026-08-14] 增量编译 | 0 新建, 1 更新, 190 跳过
+## [2026-08-17] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-17] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-17] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-17] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-17] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-17] 增量编译 | 0 新建, 1 更新, 190 跳过
+## [2026-08-17] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-17] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-17] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-17] 增量编译 | 0 新建, 1 更新, 190 跳过
+## [2026-08-18] 增量编译 | 0 新建, 1 更新, 190 跳过
+## [2026-08-20] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-20] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-20] 增量编译 | 0 新建, 1 更新, 190 跳过
+## [2026-08-20] 增量编译 | 0 新建, 1 更新, 190 跳过
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 0 更新, 190 跳过, 1 失败
+## [2026-08-24] 增量编译 | 0 新建, 1 更新, 190 跳过
+## [2026-09-04] 增量编译 | 0 新建, 1 更新, 191 跳过
+## [2026-09-04] 增量编译 | 0 新建, 1 更新, 191 跳过
+## [2026-09-07] 增量编译 | 1 新建, 0 更新, 192 跳过
+## [2026-09-07] 增量编译 | 1 新建, 0 更新, 192 跳过

package/templates/_shared/aitable-faq/.kb/wiki/references/AI /350/241/250/346/240/274 AI /345/255/227/346/256/265/345/270/270/350/247/201/346/212/245/351/224/231/350/257/264/346/230/216.md"

@@ -217,6 +217,10 @@ summary: AI 表格 AI 字段执行过程中常见错误信息的完整汇总，
 
 - [AI表格 AI 字段 开发指南](../topics/AI表格%20AI%20字段%20开发指南.md)
 - [AI表格 AI 字段开发指南（FaaS版）](../topics/AI表格%20AI%20字段开发指南（FaaS版）.md)
+- [[国内外快递物流信息查询使用指南|国内外快递物流信息查询使用指南]] ([国内外快递物流信息查询使用指南](../references/国内外快递物流信息查询使用指南.md))
+- [[Dify智能体|Dify 智能体字段模板配置教程]] ([Dify 智能体字段模板配置教程](../topics/Dify智能体.md))
+- [[GPTPro 字段捷径 密钥获取指南|GPTPro 字段捷径密钥获取指南]] ([GPTPro 字段捷径密钥获取指南](<../topics/GPTPro 字段捷径 密钥获取指南.md>))
+- [[快递物流查询助手使用指南|快递物流查询助手使用指南]] ([快递物流查询助手使用指南](../topics/快递物流查询助手使用指南.md))
 
 ## Sources
 

package/templates/_shared/aitable-faq/.kb/wiki/references/AI/350/241/250/346/240/274 (/345/244/232/347/273/264/350/241/250) OpenAPI /345/270/256/345/212/251/346/226/207/346/241/243.md"

@@ -1,71 +1,80 @@
 ---
-title: AI表格 OpenAPI 帮助文档
+title: AI表格（多维表）OpenAPI 帮助文档
 category: references
 sources: [AI表格 (多维表) OpenAPI 帮助文档.md]
-created: 2026-08-24
-updated: 2026-08-24
-tags: [AI表格, OpenAPI, API, 数据结构, 多维表]
-aliases: [多维表API, AI表格API, OpenAPI帮助文档]
+created: 2026-09-04
+updated: 2026-09-04
+tags: [AI表格, 多维表, OpenAPI, 钉钉开放平台, CRUD]
+aliases: [多维表OpenAPI, 钉钉AI表格API, notable API]
 confidence: high
-summary: AI表格 OpenAPI 全量发布后的帮助文档，涵盖 Sheet、Field、Record 的 CRUD 接口定义、数据结构（字段类型与记录值格式）、调用方式与常见问题。API 前缀为 https://api.dingtalk.com/v1.0/notable/bases/。
+summary: 钉钉 AI 表格（多维表）OpenAPI 参考文档，涵盖数据结构（Base/Sheet/Field/Record）、支持的字段类型、Sheet/Field/Record 的 CRUD 接口列表，以及附件上传等常见操作说明。
 ---
 
-> AI表格 OpenAPI 支持对 Sheet、Field、Record 的增删改查操作。本文档涵盖调用方式、数据结构与 API 列表，是服务端集成 AI表格的参考文档。
+> AI 表格 OpenAPI 是钉钉开放平台提供的用于程序化管理 AI 表格（多维表）数据的接口集合，支持对 Sheet（数据表）、Field（字段）、Record（记录）进行完整的增删改查操作。本文档汇总了调用方式、数据结构、字段类型及 API 列表等关键参考信息。
 
-> **注意**：AI表格 OpenAPI 已全量发布，完整文档请前往[钉钉开放平台](https://open.dingtalk.com/document/orgapp/notable-data-structure)查看。本文档不再更新。
+> **注意**：AI 表格 OpenAPI 已全量发布，完整文档请前往 [钉钉开放平台](https://open.dingtalk.com/document/orgapp/notable-data-structure) 查看，本文档不再更新。
 
 ## 调用方式
 
-调用 AI表格 API 需完成以下步骤：
+调用 AI 表格 API 前需完成以下准备：
 
-1. **添加接口调用权限**：申请权限点「AI表格应用读权限」及「AI表格应用写权限」。[添加 API 权限](https://open.dingtalk.com/document/orgapp/add-api-permission)
-2. **获取 accessToken**：[获取企业内部应用的 accessToken](https://open.dingtalk.com/document/orgapp/obtain-the-access_token-of-an-internal-app)
-3. **调用 API**：参考[钉钉开放平台 API 概览](https://open.dingtalk.com/document/orgapp/dingtalk-openapi-overview)
+1. **添加接口调用权限**：申请「AI 表格应用读权限」及「AI 表格应用写权限」。参考 [添加接口调用权限](https://open.dingtalk.com/document/orgapp/add-api-permission)。
+2. **获取 accessToken**：通过 [获取企业内部应用的 accessToken](https://open.dingtalk.com/document/orgapp/obtain-the-access_token-of-an-internal-app) 接口获取凭证。
+3. **调用 API**：参考 [调用服务端 API](https://open.dingtalk.com/document/orgapp/how-to-call-apis) 及 [钉钉 OpenAPI 概览](https://open.dingtalk.com/document/orgapp/dingtalk-openapi-overview)。
+
+**关键约定**：
+
+- API 固定前缀：`https://api.dingtalk.com/v1.0/notable/bases/`
+- 所有 API 均需要通过 `operatorId` 参数指定操作用户身份
+- API 调用次数计费遵循 [钉钉开放平台规则](https://open.dingtalk.com/document/orgapp/descriptions-about-adjusting-limit-and-frequency-of-api-calls)
+- API 也可在 [SDK](https://open.dingtalk.com/document/orgapp/sdk-download) 中使用，搜索方法名即可，接口位于 `notable_1.0` 命名空间下
 
 ## 数据结构
 
-AI表格包含以下基本结构：
+AI 表格包含以下四层基本结构：
 
-### Base
+### Base（文档）
 
-即一篇 AI表格文档。`baseId` 唯一标识一篇文档，可通过以下方式获取：
+Base 代表一篇 AI 表格文档，通过 `baseId` 唯一标识。获取 `baseId` 的方式：
 
-- **通过 URL 获取**：文档 URL 中包含 baseId
+**通过 URL 获取**
 
-  ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AJdl64r2VK4vqke1/img/231ffaa5-891e-42de-b129-b16038a741c4.png)
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AJdl64r2VK4vqke1/img/231ffaa5-891e-42de-b129-b16038a741c4.png)
 
-- **通过文档信息面板获取**
+**通过文档信息面板获取**
 
-  ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AJdl64r2VK4vqke1/img/37d3bcb9-61b2-46f1-acdd-a8180f99211f.png)
-  ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AJdl64r2VK4vqke1/img/193e9694-6da3-4225-881f-bf4a2c5c3d78.png)
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AJdl64r2VK4vqke1/img/37d3bcb9-61b2-46f1-acdd-a8180f99211f.png)
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AJdl64r2VK4vqke1/img/193e9694-6da3-4225-881f-bf4a2c5c3d78.png)
 
-- **通过其它 API 获取**：[知识库 API](https://open.dingtalk.com/document/orgapp/knowledge-base-overview) 返回的 `dentryUuid` 即是 AI表格 `baseId`
+**通过 API 获取**
+
+- [知识库 API](https://open.dingtalk.com/document/orgapp/knowledge-base-overview) 返回的 `dentryUuid` 即为 AI 表格的 `baseId`
   - [获取节点](https://open.dingtalk.com/document/orgapp/get-node)
-  - [创建知识库文档](https://open.dingtalk.com/document/orgapp/create-team-space-document)（创建 AI表格时 `docType` 值为 `BASE`）
+  - [创建知识库文档](https://open.dingtalk.com/document/orgapp/create-team-space-document)（创建 AI 表格时 `docType` 值为 `BASE`）
 
-### Sheet
+### Sheet（数据表）
 
-即数据表。一篇 AI表格文档中通常有多个数据表，且至少有一个。
+Sheet 代表一张数据表。一篇 AI 表格文档中通常包含多个数据表，且至少有一个。
 
-- 所有访问 sheet 的接口可用 `sheetId` 或 `sheetName` 作为入参
-- `sheetId` 仅保证文档内唯一，不保证全局唯一
-- `sheetName` 为前端可见名称（如 `阅读记录`）
+- 可通过 `sheetId` 或 `sheetName` 访问数据表
+- `sheetId` 可通过「获取所有数据表」等接口获取，仅保证在文档内唯一
+- `sheetName` 为前端可见的数据表名称（如 `阅读记录`）
 
-### Field
+### Field（字段）
 
-即字段，数据表中的每一列。
+Field 代表数据表中的一列。一个数据表通常有多个字段。
 
-- 所有访问 field 的接口可用 `fieldId` 或 `fieldName` 作为入参
-- `fieldId` 仅保证文档内唯一，不保证全局唯一
-- `fieldName` 为前端可见名称（如 `学科领域`）
-- 每个数据表的第一列为「主字段」，仅支持特定几种字段类型，且该列不可删除
+- 可通过 `fieldId` 或 `fieldName` 访问字段
+- `fieldId` 可通过「获取所有字段」等接口获取，仅保证在文档内唯一
+- `fieldName` 为前端可见的字段名称（如 `学科领域`）
+- 每个 Sheet 的第一列为「主字段」，仅支持特定几种字段类型，且该列不可删除。可通过打开任意 AI 表格 → 编辑主字段 → 查看可设置的字段类型来确认
 
-### Record
+### Record（记录）
 
-即记录，数据表中的每一行。
+Record 代表数据表中的一行。一个数据表通常有多条记录。
 
-- 访问 record 接口需使用 `recordId`
-- `recordId` 仅保证文档内唯一，不保证全局唯一
+- 所有访问记录的接口需要使用 `recordId`
+- `recordId` 可通过「新增多行记录」「获取多行记录」等接口获取，仅保证在文档内唯一
 
 ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4j6OJQKGL3Ngq3p8/img/bdc8d25c-c5ac-4bd4-be92-6e7d97b4c3e3.png)
 
@@ -73,94 +82,81 @@ AI表格包含以下基本结构：
 
 目前仅支持以下字段类型：
 
-| 字段 | 类型 (type) | 属性 (property) | 设置值格式 | 返回值格式 |
-|------|------------|----------------|-----------|-----------|
-| 文本 | `text` | 无 | `"TextString"` | `"TextString"` |
-| 数字 | `number` | `{ formatter: "INT" \| "FLOAT_1" \| ... }` | `123` | `"123"` |
-| 货币 | `currency` | `{ currencyType, formatter }` | `123` | `"123"` |
-| 单选 | `singleSelect` | `{ choices: [{ name }] }` | `"optionName"` | `{ id, name }` |
-| 多选 | `multipleSelect` | 同单选 | `["opt1", "opt2"]` | `[{ id, name }]` |
-| 日期 | `date` | `{ formatter: "YYYY-MM-DD" \| ... }` | 时间戳或 ISO 8601 字符串 | 时间戳 |
-| 人员 | `user` | `{ multiple: boolean }` | `[{ unionId }]` | `[{ unionId }]` |
-| 部门 | `department` | `{ multiple: boolean }` | `[{ deptId }]` | `[{ deptId }]` |
-| 群组 | `group` | `{ multiple: boolean }` | `[{ openConversationId }]` | `[{ openConversationId }]` |
-| 附件 | `attachment` | 无 | 需先上传获取 | `[{ filename, size, type, url }]` |
-| 单向关联 | `unidirectionalLink` | `{ multiple, linkedSheetId }` | `{ linkedRecordIds: [...] }` | `{ linkedRecordIds: [...] }` |
-| 双向关联 | `bidirectionalLink` | `{ multiple, linkedSheetId, linkedFieldId }` | `{ linkedRecordIds: [...] }` | `{ linkedRecordIds: [...] }` |
-| 链接 | `url` | 无 | `{ text, link }` | `{ text, link }` |
-| 富文本 | `richText` | 无 | `{ markdown: "..." }` | `{ markdown: "..." }` |
-| 地理位置 | `geolocation` | 无 | `{ address, name, location }` | `{ address, name, location }` |
-
-> **注意**：富文本字段通过 markdown 读取后的值是有损的，颜色、字体样式、@人 等信息会丢失。
->
-> **附件 URL**：当附件是在线文档时，链接无访问时效；其它文件为有访问时效的下载链接。
+| 字段 | 类型 (type) | 设置值格式 | 返回值格式 |
+| --- | --- | --- | --- |
+| 文本 | `text` | `"TextString"`（字符串） | `"TextString"`（字符串） |
+| 数字 | `number` | `123`（整数/浮点数/字符串） | `"123"`（字符串形式） |
+| 货币 | `currency` | `123`（整数/浮点数/字符串），需指定 `currencyType` | `"123"`（字符串形式） |
+| 单选 | `singleSelect` | `"optionName1"`（选项名） | `{ "id": "id", "name": "optionName1" }` |
+| 多选 | `multipleSelect` | `["optionName1", "optionName2"]` | `[{ "id": "id1", "name": "optionName1" }, ...]` |
+| 日期 | `date` | `1688601600000`（时间戳）或 ISO 8601 字符串 | `1688601600000`（时间戳） |
+| 人员 | `user` | `[{ "unionId": "xxx" }]` | `[{ "unionId": "xxx" }]` |
+| 部门 | `department` | `[{ "deptId": "xxx" }]` | `[{ "deptId": "xxx" }]` |
+| 群组 | `group` | `[{ "openConversationId": "xxx" }]` | `[{ "openConversationId": "xxx" }]` |
+| 附件 | `attachment` | 需先通过资源上传接口获取 | `[{ "filename": "...", "size": ..., "url": "..." }]` |
+| 单向关联 | `unidirectionalLink` | `{ "linkedRecordIds": ["xxx"] }` | `{ "linkedRecordIds": ["xxx"] }` |
+| 双向关联 | `bidirectionalLink` | `{ "linkedRecordIds": ["xxx"] }` | `{ "linkedRecordIds": ["xxx"] }` |
+| 链接 | `url` | `{ "text": "...", "link": "..." }` | `{ "text": "...", "link": "..." }` |
+| 富文本 | `richText` | `{ "markdown": "..." }` | `{ "markdown": "..." }` |
+| 地理位置 | `geolocation` | `{ "address": "...", "name": "...", "location": [...] }` | `{ "address": "...", "name": "...", "location": [...] }` |
+
+**字段配置说明**：
+
+- **数字**：支持 `INT`（整数）、`FLOAT_1`~`FLOAT_4`（保留 1-4 位小数）、`THOUSAND`（千分位）、`THOUSAND_FLOAT`、`PERCENT`（百分比）、`PERCENT_FLOAT` 等格式
+- **货币**：额外支持 CNY、HKD、USD、EUR、GBP、JPY、KRW 等多种货币类型
+- **日期**：支持 `YYYY-MM-DD`、`YYYY-MM-DD HH:mm`、`YYYY/MM/DD`、`YYYY/MM/DD HH:mm` 四种显示格式
+- **人员/部门/群组**：通过 `multiple` 属性控制是否支持多选，默认为 `true`
+- **单向关联**：需指定 `linkedSheetId`（关联的数据表 ID）；可通过关联的 `sheetId` + `recordId` 调用 `GetRecord` 获取关联记录的值
+- **双向关联**：需指定 `linkedSheetId`，创建时不需传 `linkedFieldId`（由系统自动生成）
+
+**注意事项**：
+
+- 富文本字段通过 markdown 读取后的值是有损的，颜色、字体样式、@人等信息会丢失
+- 附件字段返回的 `url`：当附件是在线文档时，链接无访问时效；当附件为其他文件时，链接具有访问时效，一段时间后无法访问
 
 ## API 列表
 
-> **调用前必看**：
-> 1. API 固定前缀为 `https://api.dingtalk.com/v1.0/notable/bases/`，以下省略，调用时需自行添加。
-> 2. 所有 API 需通过 query 中的 `operatorId` 参数指定调用用户身份。
-> 3. 调用次数计费遵循[钉钉开放平台规则](https://open.dingtalk.com/document/orgapp/descriptions-about-adjusting-limit-and-frequency-of-api-calls)。
->
-> API 也可在[钉钉开放平台 SDK](https://open.dingtalk.com/document/orgapp/sdk-download) 中使用，搜索方法名即可（如搜索 `CreateSheet`）。接口位于 `notable_1.0` 命名空间下。
-
-### 数据表
-
-| API | 方法 | 路径 |
-|-----|------|------|
-| 创建数据表 CreateSheet | POST | `{baseId}/sheets?operatorId={operatorId}` |
-| 获取所有数据表 GetAllSheets | GET | `{baseId}/sheets?operatorId={operatorId}` |
-| 获取数据表 GetSheet | GET | `{baseId}/sheets/{sheetId}?operatorId={operatorId}` |
-| 更新数据表 UpdateSheet | PUT | `{baseId}/sheets/{sheetIdOrName}?operatorId={operatorId}` |
-| 删除数据表 DeleteSheet | DELETE | `{baseId}/sheets/{sheetIdOrName}?operatorId={operatorId}` |
+### 数据表 API
 
-创建数据表示例：
-
-```json
-POST {baseId}/sheets?operatorId={operatorId}
-BODY
-{
-  "name": "Sheet1",
-  "fields": [
-    { "name": "Field1", "type": "text" },
-    { "name": "Field2", "type": "number" }
-  ]
-}
-```
+| API 名 | 方法 | 路径 |
+| --- | --- | --- |
+| 创建数据表 CreateSheet | `POST` | `{baseId}/sheets` |
+| 获取所有数据表 GetAllSheets | `GET` | `{baseId}/sheets` |
+| 获取数据表 GetSheet | `GET` | `{baseId}/sheets/{sheetId}` |
+| 更新数据表 UpdateSheet | `PUT` | `{baseId}/sheets/{sheetIdOrName}` |
+| 删除数据表 DeleteSheet | `DELETE` | `{baseId}/sheets/{sheetIdOrName}` |
 
-### 字段
+### 字段 API
 
-| API | 方法 | 路径 |
-|-----|------|------|
-| 新增字段 CreateField | POST | `{baseId}/sheets/{sheetIdOrName}/fields?operatorId={operatorId}` |
-| 获取所有字段 GetAllFields | GET | `{baseId}/sheets/{sheetIdOrName}/fields?operatorId={operatorId}` |
-| 更新字段 UpdateField | PUT | `{baseId}/sheets/{sheetIdOrName}/fields/{fieldIdOrName}?operatorId={operatorId}` |
-| 删除字段 DeleteField | DELETE | `{baseId}/sheets/{sheetIdOrName}/fields/{fieldIdOrName}?operatorId={operatorId}` |
+| API 名 | 方法 | 路径 |
+| --- | --- | --- |
+| 新增字段 CreateField | `POST` | `{baseId}/sheets/{sheetIdOrName}/fields` |
+| 获取所有字段 GetAllFields | `GET` | `{baseId}/sheets/{sheetIdOrName}/fields` |
+| 更新字段 UpdateField | `PUT` | `{baseId}/sheets/{sheetIdOrName}/fields/{fieldIdOrName}` |
+| 删除字段 DeleteField | `DELETE` | `{baseId}/sheets/{sheetIdOrName}/fields/{fieldIdOrName}` |
 
-> **为什么返回的字段数量不全？** 目前只返回支持的字段类型。
+> **Q：为什么返回的字段数量不全？** 目前只返回支持的字段类型，具体参考上方字段类型列表。
 >
-> **为什么返回的字段顺序和界面不同？** AI表格中数据表是无序的，只有视图才有序，暂不支持基于视图获取字段。
+> **Q：为什么返回的字段顺序和界面看到的顺序不同？** AI 表格中数据表是无序的，只有视图才有序。目前暂不支持基于视图获取所有字段。
 
-### 记录
+### 记录 API
 
-| API | 方法 | 路径 |
-|-----|------|------|
-| 新增多行记录 InsertRecords | POST | `{baseId}/sheets/{sheetIdOrName}/records?operatorId={operatorId}` |
-| 列出多行记录 ListRecords | POST | `{baseId}/sheets/{sheetIdOrName}/records/list?operatorId={operatorId}` |
-| 获取记录 GetRecord | GET | `{baseId}/sheets/{sheetIdOrName}/records/{recordId}?operatorId={operatorId}` |
-| 更新多行记录 UpdateRecords | PUT | `{baseId}/sheets/{sheetIdOrName}/records?operatorId={operatorId}` |
-| 删除多条记录 DeleteRecords | POST | `{baseId}/sheets/{sheetIdOrName}/records/delete?operatorId={operatorId}` |
+| API 名 | 方法 | 路径 |
+| --- | --- | --- |
+| 新增多行记录 InsertRecords | `POST` | `{baseId}/sheets/{sheetIdOrName}/records` |
+| 列出多行记录 ListRecords | `POST` | `{baseId}/sheets/{sheetIdOrName}/records/list` |
+| 获取记录 GetRecord | `GET` | `{baseId}/sheets/{sheetIdOrName}/records/{recordId}` |
+| 更新多行记录 UpdateRecords | `PUT` | `{baseId}/sheets/{sheetIdOrName}/records` |
+| 删除多条记录 DeleteRecords | `POST` | `{baseId}/sheets/{sheetIdOrName}/records/delete` |
 
-新增多行记录示例：
+**InsertRecords 示例**：
 
 ```json
-POST {baseId}/sheets/{sheetIdOrName}/records?operatorId={operatorId}
-BODY
 {
   "records": [
     {
       "fields": {
-        "多行文本": "内容1",
+        "多行文本": "多行文本内容",
         "数字": 100,
         "单选": "选项1",
         "多选": ["选项1", "选项2"]
@@ -168,7 +164,7 @@ BODY
     },
     {
       "fields": {
-        "多行文本": "内容2",
+        "多行文本": "多行文本内容_",
         "数字": 101,
         "单选": "选项2",
         "多选": ["选项1"]
@@ -178,26 +174,34 @@ BODY
 }
 ```
 
-列出记录支持分页（`maxResults` 最大 100，`nextToken` 用于翻页），返回包含 `hasMore`、`nextToken` 以及每条记录的 `fields`、`createdBy`、`lastModifiedBy`、`createdTime`、`lastModifiedTime`。
+其中 `records` 是数组，每个元素代表一行；`fields` 为 key-value pair，key 是字段 ID 或字段名，value 是要填入的值（格式与字段类型相关）。
 
-> **为什么返回的记录顺序和界面不同？** 数据表是无序的，只有视图才有序。
+**ListRecords 说明**：
+
+- 支持分页：`maxResults` 每次拉取行数最大 100，`nextToken` 用于翻页
+- 特定情况下可能返回空数组，只要 `hasMore` 为 `true` 说明数据未拉完，需继续请求
+- 返回包含记录的 `fields`、`createdBy`、`lastModifiedBy`、`createdTime`、`lastModifiedTime`
+
+> **Q：为什么返回的记录顺序和界面看到的顺序不同？** 数据表是无序的，只有视图才有序。目前暂不支持基于视图获取所有记录。
 
 ## 常见问题
 
-### Q：如何创建 AI表格？
+### Q：如何创建 AI 表格？
 
-使用[创建知识库文档接口](https://open.dingtalk.com/document/orgapp/create-team-space-document)，`docType` 传 `BASE`。
+使用 [创建知识库文档接口](https://open.dingtalk.com/document/orgapp/create-team-space-document)，`docType` 传 `BASE`。
 
-### Q：如何调整 AI表格权限？
+### Q：如何调整 AI 表格权限？
 
-文档权限请使用[权限管理接口](https://open.dingtalk.com/document/orgapp/add-permissions-file)。高级权限暂不支持 API 访问。
+AI 表格文档权限请使用 [权限管理接口](https://open.dingtalk.com/document/orgapp/add-permissions-file) 访问。AI 表格高级权限暂不支持 API 访问。
 
 ### Q：如何上传附件？
 
-上传附件需 3 步：
+上传附件需要 3 步：
 
 **第 1 步：获取资源上传信息**
 
+权限点：企业存储文件写权限。
+
 ```http
 POST /v1.0/doc/docs/resources/{documentId}/uploadInfos/query?operatorId=String HTTP/1.1
 Host: api.dingtalk.com
@@ -205,7 +209,35 @@ x-acs-dingtalk-access-token: String
 Content-Type: application/json
 ```
 
-Body 参数：`size`（资源大小）、`mediaType`（mimeType）、`resourceName`（资源名称）。返回 `uploadUrl`、`resourceId`、`resourceUrl`。
+请求参数：
+
+| 名称 | 类型 | 必填 | 描述 |
+| --- | --- | --- | --- |
+| documentId (Path) | String | 是 | 文档唯一标识，即 baseId/dentryUuid |
+| operatorId (Query) | String | 是 | 操作用户 unionId |
+| size (Body) | Long | 是 | 资源大小 |
+| mediaType (Body) | String | 是 | [mimeType](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Guides/MIME_types/Common_types) |
+| resourceName (Body) | String | 是 | 资源名称 |
+
+返回参数：
+
+| 名称 | 类型 | 描述 |
+| --- | --- | --- |
+| uploadUrl | String | 资源上传地址 |
+| resourceId | String | 资源 ID |
+| resourceUrl | String | 资源访问 URL |
+
+返回示例：
+
+```json
+{
+  "result": {
+    "resourceId": "6c6a466c-6a52-4aa0-a80f-13896e635145",
+    "uploadUrl": "https://alidocs2.oss-cn-zhangjiakou.aliyuncs.com/res/..."
+  },
+  "success": true
+}
+```
 
 **第 2 步：上传文件到 uploadUrl**
 
@@ -213,7 +245,7 @@ Body 参数：`size`（资源大小）、`mediaType`（mimeType）、`resourceNa
 curl -X PUT -H "Content-Type: image/jpeg" --data-binary @/path/to/your/image.jpg {uploadUrl}
 ```
 
-**第 3 步：调用新增/更新记录接口写入 AI表格**
+**第 3 步：调用新增/更新多行记录接口写入 AI 表格**
 
 ```json
 [
@@ -233,7 +265,7 @@ curl -X PUT -H "Content-Type: image/jpeg" --data-binary @/path/to/your/image.jpg
 
 - [字段数据结构](./字段数据结构.md)
 - [其他接口](./其他接口.md)
-- [核心知识](../concepts/核心知识.md)
+- [常见问题](./常见问题.md)
 
 ## Sources
 

package/templates/_shared/aitable-faq/.kb/wiki/references/BarcodeField /346/235/241/347/240/201/345/255/227/346/256/265.md"

@@ -49,6 +49,8 @@ if (Base.isFieldOfType(barcodeField, 'barcode')) {
 
 - [Base 模块 API 参考](../references/Base%20模块.md)
 - [AutoNumberField 自动编号字段 API](../references/AutoNumberField%20自动编号字段.md)
+- [[AttachmentField 附件字段|AttachmentField 附件字段 API]] ([AttachmentField 附件字段 API](<../references/AttachmentField 附件字段.md>))
+- [[EmailField 邮箱字段|EmailField 邮箱字段 API]] ([EmailField 邮箱字段 API](<../references/EmailField 邮箱字段.md>))
 
 ## Sources
 

package/templates/_shared/aitable-faq/.kb/wiki/references/Base /346/250/241/345/235/227.md"

@@ -151,6 +151,20 @@ const hasPermission = await Base.getPermissionAsync({
 - [Sheet 模块](../references/Sheet%20模块.md)
 - [读写AI 表格模型](../concepts/读写AI%20表格模型.md)
 - [Field 模块](../references/Field%20模块.md)
+- [[AttachmentField 附件字段|AttachmentField 附件字段 API]] ([AttachmentField 附件字段 API](<../references/AttachmentField 附件字段.md>))
+- [[AutoNumberField 自动编号字段|AutoNumberField 自动编号字段 API]] ([AutoNumberField 自动编号字段 API](<../references/AutoNumberField 自动编号字段.md>))
+- [[BarcodeField 条码字段|BarcodeField 条码字段 API]] ([BarcodeField 条码字段 API](<../references/BarcodeField 条码字段.md>))
+- [[BidirectionalLinkField 双向关联字段|BidirectionalLinkField 双向关联字段 API]] ([BidirectionalLinkField 双向关联字段 API](<../references/BidirectionalLinkField 双向关联字段.md>))
+- [[CheckboxField 复选框字段|CheckboxField 复选框字段 API]] ([CheckboxField 复选框字段 API](<../references/CheckboxField 复选框字段.md>))
+- [[CreatedTimeField 创建时间字段|CreatedTimeField 创建时间字段 API]] ([CreatedTimeField 创建时间字段 API](<../references/CreatedTimeField 创建时间字段.md>))
+- [[CurrencyField 货币字段|CurrencyField 货币字段 API]] ([CurrencyField 货币字段 API](<../references/CurrencyField 货币字段.md>))
+- [[DateField 日期字段|DateField 日期字段 API]] ([DateField 日期字段 API](<../references/DateField 日期字段.md>))
+- [[DepartmentField 部门字段|DepartmentField 部门字段 API]] ([DepartmentField 部门字段 API](<../references/DepartmentField 部门字段.md>))
+- [[EmailField 邮箱字段|EmailField 邮箱字段 API]] ([EmailField 邮箱字段 API](<../references/EmailField 邮箱字段.md>))
+- [[Event事件模块|Event 事件模块 API 参考]] ([Event 事件模块 API 参考](../references/Event事件模块.md))
+- [[Input模块|Input 模块 API 参考]] ([Input 模块 API 参考](../references/Input模块.md))
+- [[UI 模块|UI 模块 API 参考]] ([UI 模块 API 参考](<../references/UI 模块.md>))
+- [[AI表格脚本插件 开发指南|AI 表格脚本插件开发指南]] ([AI 表格脚本插件开发指南](<../topics/AI表格脚本插件 开发指南.md>))
 
 ## Sources
 

package/templates/_shared/aitable-faq/.kb/wiki/references/Field /346/250/241/345/235/227.md"

@@ -110,6 +110,8 @@ const format = numberField.getFormat();
 - [Sheet 模块](../references/Sheet%20模块.md)
 - [字段数据结构](../references/字段数据结构.md)
 - [Record 模块](../references/Record%20模块.md)
+- [[读写AI 表格模型|读写 AI 表格模型]] ([读写 AI 表格模型](<../concepts/读写AI 表格模型.md>))
+- [[Base 模块|Base 模块 API 参考]] ([Base 模块 API 参考](<../references/Base 模块.md>))
 
 ## Sources