aitable-workflow-cli 0.1.13-beta.1

package/templates/support-qa/profiles/aitable/wiki/faq-support/18-/345/274/200/345/217/221/350/200/205/346/214/207/345/215/227/AI/350/241/250/346/240/274/350/204/232/346/234/254/346/217/222/344/273/266 /345/274/200/345/217/221/346/214/207/345/215/227//345/255/227/346/256/265/346/225/260/346/215/256/347/273/223/346/236/204.md"

@@ -0,0 +1,65 @@
+# 字段数据结构
+
+## 字段配置类型定义
+
+| **字段类型** | **code** | **读取** | **写入** | **备注** |
+| --- | --- | --- | --- | --- |
+| 文本 | `text` | `undefined` | `undefined` |  |
+| 数字 | `number` | ```typescript<br>interface Property {<br>  /** 数字格式 */<br>  formatter: NumberFormatter;<br>}<br>``` | ```typescript<br>interface Property {<br>  /** 数字格式，默认为 INT */<br>  formatter?: NumberFormatter;<br>}<br>``` | [NumberFormatter](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=bmhb9tm5gl&sheetId=hERWDMS&viewId=qvGDAH2) |
+| 日期 | `date` | ```typescript<br>interface Property {<br>  /** 日期格式 */<br>  formatter: DateFormatter;<br>}<br>``` | ```typescript<br>interface Property {<br>  /** 日期格式，默认为YYYY-MM-DD */<br>  formatter?: DateFormatter;<br>}<br>``` | [DateFormatter](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=sgmPZ03ioN&sheetId=hERWDMS&viewId=qvGDAH2) |
+| 复选框 | `checkbox` | `undefined` | `undefined` |  |
+| 单选 | `singleSelect` | ```typescript<br>interface Property {<br>  /** 选项列表 */<br>  choices: Array<{<br>    /** 选项ID(由系统生成) */<br>    id: string;<br>    /** 选项名 */<br>    name: string;<br>  }>;<br>}<br>``` | ```typescript<br>interface Property {<br>  /** 选项列表，默认为空 */<br>  choices?: Array<{<br>    /** 更新已有选项需要传入选项ID */<br>    id?: string;<br>    /** 选项名 */<br>    name: string;<br>  }>;<br>}<br>``` |  |
+| 多选 | `multiSelect` | ```typescript<br>interface Property {<br>  /** 选项列表 */<br>  choices: Array<{<br>    /** 选项ID(由系统生成) */<br>    id: string;<br>    /** 选项名 */<br>    name: string;<br>  }>;<br>}<br>``` | ```typescript<br>interface Property {<br>  /** 选项列表，默认为空 */<br>  choices?: Array<{<br>    /** 选项ID(由系统生成) */<br>    id: string;<br>    /** 选项名 */<br>    name: string;<br>  }>;<br>}<br>``` |  |
+| 评分 | `rating` | ```typescript<br>interface Property {<br>  /** 最小值 */<br>  min: number;<br>  /** 最大值 */<br>  max: number;<br>  /** 图标类型 */<br>  icon: RatingIconType;<br>}<br>``` | ```typescript<br>interface Property {<br>  /** 最小值，默认为1，可传0/1 */<br>  min?: numb0er;<br>  /** 最大值，默认为5，可传2～10 */<br>  max?: number;<br>  /** 图标类型，默认为star */<br>  icon?: RatingIconType;<br>}<br>``` | [RatingIconType](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=bTFrjASNmd&sheetId=hERWDMS&viewId=qvGDAH2) |
+| 货币 | `currency` | ```typescript<br>interface Property {<br>  /** 货币格式 */<br>  formatter: CurrencyFormatter;<br>}<br>``` | ```typescript<br>interface Property {<br>  /** 货币格式，默认为FLOAT_2 */<br>  formatter?: CurrencyFormatter;<br>}<br>``` | [CurrencyFormatter](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=H14AhQltuW&sheetId=hERWDMS&viewId=qvGDAH2) |
+| 进度 | `progress` | ```typescript<br>interface Property {<br>  /** 进度格式 */<br>  formatter: ProgressFormatter;<br>  /** 是否开启自定义进度条值 */<br>  customizeRange: boolean;<br>  /** 起始值 */<br>  min: number;<br>  /** 目标值 */<br>  max: number;<br>}<br>``` | ```typescript<br>interface Property {<br>  /** 进度格式，默认为PERCENT */<br>  formatter?: ProgressFormatter;<br>  /** 是否自定义进度条值，默认false */<br>  customizeRange: boolean;<br>  /** 起始值，默认0 */<br>  min: number;<br>  /** 目标值，默认1 */<br>  max: number;<br>}<br>``` | [ProgressFormatter](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=PJ9idnGXLB&sheetId=hERWDMS&viewId=qvGDAH2)<br>:::<br>当需要自定义起始值或目标值时。请置customizeRange为开启状态。<br>::: |
+| 邮箱 | `email` | `undefined` | `undefined` |  |
+| 电话 | `telephone` | `undefined` | `undefined` |  |
+| 条码 | `barcode` | `undefined` | `undefined` |  |
+| 创建时间 | `createdTime` | ```typescript<br>interface Property {<br>  /** 日期格式 */<br>  formatter: DateFormatter;<br>}<br>``` | ```typescript<br>interface Property {<br>  /** 日期格式 */<br>  formatter: DateFormatter;<br>}<br>``` | [DateFormatter](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=sgmPZ03ioN&sheetId=hERWDMS&viewId=qvGDAH2) |
+| 更新时间 | `updatedTime` | ```typescript<br>interface Property {<br>  /** 日期格式 */<br>  formatter: DateFormatter;<br>}<br>``` | ```typescript<br>interface Property {<br>  /** 日期格式 */<br>  formatter: DateFormatter;<br>}<br>``` | [DateFormatter](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=sgmPZ03ioN&sheetId=hERWDMS&viewId=qvGDAH2) |
+| 附件 | `attachment` | `undefined` | `undefined` |  |
+| 链接 | `url` | `undefined` | `undefined` |  |
+| 富文本 | `richText` | `undefined` | `undefined` |  |
+| 主键文档 | `primaryDoc` | `undefined` | `undefined` |  |
+| 单向关联 | `unidirectionalLink` | ```typescript<br>interface Propterty {<br>  /** 是否支持多选 */<br>  multiple: string;<br>  /** 关联的数据表 */<br>  linkedSheetId: string;<br>}<br>``` | ```typescript<br>interface Propterty {<br>  /** 是否支持多选，默认为true */<br>  multiple?: string;<br>  /** 关联的数据表，不支持更新配置 */<br>  linkedSheetId?: string;<br>}<br>``` |  |
+| 双向关联 | `bidirectionalLink` | ```typescript<br>interface Propterty {<br>  /** 是否支持多选 */<br>  multiple: string;<br>  /** 关联的数据表 */<br>  linkedSheetId: string;<br>  /** 双向关联的另一个字段ID */<br>  linkedFieldId: string;<br>}<br>``` | ```typescript<br>interface Propterty {<br>  /** 是否支持多选，默认为true */<br>  multiple?: string;<br>  /** 关联的数据表，不支持更新配置 */<br>  linkedSheetId?: string;<br>}<br>``` |  |
+| 公式 | `formula` | ```typescript<br>interface Propterty {<br>  /** 计算结果格式 */<br>  formatter: NumberFormatter;<br>  /** 表达式 */<br>  formula: string;<br>}<br>``` | ```typescript<br>interface Propterty {<br>  /** 计算结果格式，默认为INT */<br>  formatter: NumberFormatter;<br>  /** 表达式, 默认为空 */<br>  formula?: string;<br>}<br>``` | [NumberFormatter](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=bmhb9tm5gl&sheetId=hERWDMS&viewId=qvGDAH2) |
+| 关联引用 | `lookup` | `undefined` | `undefined` |  |
+| 查找引用 | `filterUp` | `undefined` | `undefined` |  |
+| 地理位置 | `geolocation` | `undefined` | `undefined` |  |
+| 人员 | `user` | ```typescript<br>interface Propterty {<br>  /** 是否可多选 */<br>  multiple: boolean;<br>}<br>``` | ```typescript<br>interface Propterty {<br>  /** 是否可多选，默认为true */<br>  multiple: boolean;<br>}<br>``` |  |
+| 群组 | `group` | ```typescript<br>interface Propterty {<br>  /** 是否可多选 */<br>  multiple: boolean;<br>}<br>``` | ```typescript<br>interface Propterty {<br>  /** 是否可多选，默认为true */<br>  multiple: boolean;<br>}<br>``` |  |
+| 部门 | `department` | ```typescript<br>interface Propterty {<br>  /** 是否可多选 */<br>  multiple: boolean;<br>}<br>``` | ```typescript<br>interface Propterty {<br>  /** 是否可多选，默认为false */<br>  multiple?: boolean;<br>}<br>``` |  |
+
+## 字段值类型定义
+
+| **字段类型** | **code** | **读取** | **写入** |
+| --- | --- | --- | --- |
+| 文本 | `text` | `string` | `string` |
+| 数字 | `number` | `string` | `string \| number` |
+| 日期 | `date` | `number`<br>以毫秒为单位的 Unix 时间戳 | `string \| number`<br>dayjs可识别的时间文本结构或以毫秒为单位的 Unix 时间戳数值 |
+| 复选框 | `checkbox` | `boolean` | `boolean` |
+| 单选 | `singleSelect` | ```typescript<br>type Cell = {<br>  /** 选项ID */<br>  id: string;<br>  /** 选项名 */<br>  name: string<br>};<br>``` | ```typescript<br>type Cell = string \| {<br>  /** 选项ID */<br>  id?: string;<br>  /** 选项ID */<br>  name?: string;<br>};<br>```<br>直接传入选项名或选项ID或传入选项对象。 |
+| 多选 | `multiSelect` | ```typescript<br>type Cell = Array<{<br>  /** 选项ID */<br>  id: string;<br>  /** 选项名 */<br>  name: string<br>}>;<br>``` | ```typescript<br>type Cell = Array<string \| {<br>  /** 选项ID */<br>  id?: string;<br>  /** 选项名 */<br>  name?: string<br>}>;<br>```<br>直接传入选项名或选项ID或选项对象的数组。 |
+| 评分 | `rating` | `string` | `string \| number` |
+| 货币 | `currency` | `string` | `string \| number` |
+| 进度 | `progress` | `string` | `string \| number` |
+| 邮箱 | `email` | `string` | `string` |
+| 电话 | `telephone` | `string` | `string` |
+| 条码 | `barcode` | `string` | `string` |
+| 创建时间 | `createdTime` | `number`<br>以毫秒为单位的 Unix 时间戳 | 不支持更新系统字段 |
+| 更新时间 | `updatedTime` | `number`<br>以毫秒为单位的 Unix 时间戳 | 不支持更新系统字段 |
+| 附件 | `attachment` | `AttachmentValue[]`<br>[AttachmentValue](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=mgIYIgGieW&sheetId=hERWDMS&viewId=qvGDAH2) | `IOpenFile \| IOpenFile[] \| AttachmentValue \| AttachmentValue[]`<br>[IOpenFile](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=0VuOwCWaVq&sheetId=hERWDMS&viewId=qvGDAH2) \| [AttachmentValue](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=mgIYIgGieW&sheetId=hERWDMS&viewId=qvGDAH2) |
+| 链接 | `url` | ```typescript<br>type Cell = {<br>  /** 链接标题 */<br>  text?: string;<br>  /** 链接文本 */<br>  link: string;<br>};<br>``` | ```typescript<br>type Cell = {<br>  /** 链接标题 */<br>  text?: string;<br>  /** 链接文本 */<br>  link: string;<br>};<br>``` |
+| 富文本 | `richText` | ```typescript<br>type Cell = {<br>  /** markdown格式的富文本 */<br>  markdown: string;<br>};<br>``` | ```typescript<br>type Cell = {<br>  /** markdown格式的富文本 */<br>  markdown: string;<br>};<br>``` |
+| 主键文档 | `primaryDoc` | `string` | `string` |
+| 单向关联 | `unidirectionalLink` | ```typescript<br>type Cell = {<br>  /** 关联的记录ID列表 */<br>  linkedRecordIds: string[];<br>}<br>``` | ```typescript<br>type Cell = {<br>  /** 关联的记录ID列表 */<br>  linkedRecordIds: string[];<br>}<br>``` |
+| 双向关联 | `bidirectionalLink` | ```typescript<br>type Cell = {<br>  /** 关联的记录ID列表 */<br>  linkedRecordIds: string[];<br>}<br>``` | ```typescript<br>type Cell = {<br>  /** 关联的记录ID列表 */<br>  linkedRecordIds: string[];<br>}<br>``` |
+| 公式 | `formula` | `string` | 不支持更新计算字段 |
+| 关联引用 | `lookup` | `string` | 不支持更新计算字段 |
+| 查找引用 | `filterUp` | `string` | 不支持更新计算字段 |
+| 地理位置 | `geolocation` | ```typescript<br>type Cell = {<br>  /** address */<br>  address: string;<br>  /** 简短地址 */<br>  name: string;<br>  /** 完整地址 */<br>  fullAddress: string;<br>  /** 经纬度 */<br>  location: [number, number];<br>};<br>``` | 不支持更新此字段 |
+| 人员 | `user` | ```typescript<br>type Cell = Array<{<br>  /** 用户unionId */<br>  unionId: string;<br>  /** 用户名 */<br>  name?: string;<br>}><br>``` | ```typescript<br>type Cell = Array<{<br>  /** 用户unionId */<br>  unionId?: string;<br>  /** 用户在文档所属组织下的userId */<br>  userId?: string;<br>  /** 用户在文档所属组织下的员工工号 */<br>  jobNumber?: string;<br>  /** 用户在文档所属组织下的外部联系人ID */<br>  extContactUserId?: string;<br>}><br>``` |
+| 群组 | `group` | ```typescript<br>type Cell = Array<{<br>  /** 群会话ID */<br>  openConversationId: string;<br>  /** 群会话名称 */<br>  name?: string;<br>}><br>``` | ```typescript<br>type Cell = Array<{<br>  /** 群会话ID */<br>  openConversationId: string;<br>}><br>``` |
+| 部门 | `department` | ```typescript<br>type Cell = Array<{<br>  /** 部门ID */<br>  deptId: string;<br>  /** 部门名称 */<br>  name?: string;<br>}><br>``` | ```typescript<br>type Cell = Array<{<br>  /** 部门ID */<br>  deptId: string;<br>}><br>``` |

package/templates/support-qa/profiles/aitable/wiki/faq-support/18-/345/274/200/345/217/221/350/200/205/346/214/207/345/215/227/AI/350/241/250/346/240/274/350/204/232/346/234/254/346/217/222/344/273/266 /345/274/200/345/217/221/346/214/207/345/215/227.md"

@@ -0,0 +1,142 @@
+# AI表格脚本插件 开发指南
+
+# 简介
+
+脚本插件是AI表格提供的一种开放能力，开发者可以通过编写JS脚本的方式构建自定义脚本插件，并分享给表格协作者共同使用。
+
+脚本插件可以与表格数据进行交互，实现复杂的业务逻辑。和[AI表格边栏插件](https://alidocs.dingtalk.com/i/nodes/R4GpnMqJzOP0oLp6sXPBmZxx8Ke0xjE3)相比，开发者开发脚本时无需进行页面开发和部署，在AI表格的右侧边栏中即可实现脚本编辑、运行和发布，使用内置API构建简易插件交互面板。
+
+![script.gif](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/5fc9e494-8ba1-4b5b-b9c3-c47893fdb90f.gif)
+
+# SKill
+
+[https://github.com/dingdocs-notable/ai-table-plugin-generator](https://github.com/dingdocs-notable/ai-table-plugin-generator)
+
+使用上面的 skill 可以快速开发脚本插件
+
+# 开发与发布
+
+## 调试脚本
+
+### 打开脚本编辑器
+
+点击`插件`展示插件面板，在右下角选择`脚本插件`，进入脚本插件列表。
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/3c20a16e-e29b-43da-891f-b160be1f0c38.png)
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/a083f020-2d91-4898-baaf-d6439fa1693d.png)
+
+点击`添加脚本插件`创建新脚本。
+
+### 编辑脚本内容
+
+在脚本编辑区可编辑脚本内容。
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/7d730f95-7552-4bed-b5c5-c254adaca6c8.png)
+
+可通过点击编辑区上方的工具栏`全屏`展开编辑。
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/43805b8a-639b-4040-8448-f7ab27673dff.png)
+
+### 运行脚本
+
+点击`运行插件`进行功能调试。
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/accd8101-5bd9-441d-a1f3-5463eec49910.png)![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/b0ca0706-dac9-4aa8-9f09-69f6a95da220.png)
+
+## 发布脚本插件
+
+点击插件资料下方的`发布到此表格`按钮，脚本作者可将此插件发布到插件首页，其他打开此表格的编辑者也可以看到并使用插件。
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/484586b4-6eaa-4b1c-8da0-fb5b3607928d.png?x-oss-process=image/crop,x_0,y_0,w_716,h_554/ignore-error,1)
+
+配置插件资料，点击`发布`，返回插件首页即可查看脚本插件。
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/d3bbc13b-7792-43cc-9199-443b2890265d.png)
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/025a8ef3-4bb8-48b9-95c7-4e4a12219346.png)
+
+## 基于已有插件进行业务扩展
+
+在`插件中心`\-`脚本插件`中提供了一些官方脚本。
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/7bc3d27b-e850-467c-b05b-d59020eda93b.png)
+
+点击使用后，可在插件已用列表中点击`创建副本`，副本插件将作为个人创建的脚本插件并支持二次编辑。
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/d38b0711-74b9-451e-b125-990e99552006.png)
+
+# 内置API
+
+## 基本语法
+
+脚本插件使用JavaScript语法进行编写，开发者在代码编辑器中编辑的代码片段可视作在一个异步函数的局部作用域中执行。因此当调用异步API时，可以在编辑区的最外层使用`await`表达式。例如：
+
+```javascript
+// 无需定义async方法，可直接使用await
+const userInput = await Input.textAsync('请输入一段文本');
+Output.info('用户输入的文本为': userInput);
+```
+
+## AI表格数据模型
+
+脚本插件中提供了一个全局变量`Base`代表AI表格的数据模型。当需要通过脚本执行AI表格的增删改查操作时，可以通过调用Base对象上的各种 API进行操作。
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq75kP0pY1AlAK/img/b20af145-0d26-42cd-bea4-7c9821f17843.png)
+
+### 常用对象
+
+AI表格的数据对象有以下几类：
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/vBPlN5m0zy8wkOdG/img/d16de762-8859-4314-9378-6ff83bafca59.png)
+
+| **变量** | **含义** | **描述** |
+| --- | --- | --- |
+| [Base](https://alidocs.dingtalk.com/i/nodes/1OQX0akWmBejogd0TOoDmK42VGlDd3mE?utm_scene=team_space) | AI表格 | 可包含多个数据表，为整个AI表格的顶级对象。在脚本插件中，直接通过访问Base变量获取。 |
+| [Sheet](https://alidocs.dingtalk.com/i/nodes/y20BglGWOGQgpOj6uYQeAA3EWA7depqY?utm_scene=team_space) | 数据表 | 包含多个视图、字段、记录。可通过Base API获取到具体某个Sheet对象。 |
+| [View](https://alidocs.dingtalk.com/i/nodes/1R7q3QmWeljPoM5BSzo3RnAY8xkXOEP2?utm_scene=team_space) | 视图 | 可通过Sheet API 获取到某个数据表的具体某个View对象。 |
+| [Field](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=team_space) | 字段 | 可通过Sheet API 获取到某个数据表的具体某个Field对象。 |
+| [Record](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2uxONwRBoV6EDybno?utm_scene=team_space) | 记录 | 可通过Sheet API 获取到某个数据表的具体某个Record对象。 |
+
+## Input API
+
+脚本插件中提供了一个全局变量`Input`支持在运行页面中创建交互式UI，等待用户输入后执行后续步骤。每个交互式输入法都是异步的，因此调用此API时需要使用`await`表达式。
+
+Input模块的API具体使用说明参见：[《Input模块》](https://alidocs.dingtalk.com/i/nodes/3NwLYZXWyrmRolXLcYE0oX7aVkyEqBQm?utm_scene=person_space)
+
+## Output API
+
+脚本插件中提供了一个全局变量`Output`支持在运行页面中展示丰富的数据信息。
+
+Output模块的API具体使用说明参见：[《Output模块》](https://alidocs.dingtalk.com/i/nodes/mweZ92PV6O36dZbns96AzkKeJxEKBD6p?utm_scene=person_space)
+
+# 常见问题
+
+*   **脚本中是否可以调用外部接口数据？**
+    
+
+:::
+可以的，脚本插件中支持调用`fetch` API进行数据读写，前提需要开发者确保外部接口支持跨域访问。
+
+```javascript
+async function fetchImageAsOpenFile(url) {
+  const res = await fetch(url);
+  const ab = await res.arrayBuffer();
+  return {
+    name: 'image',
+    type: res.headers.get('content-type') || 'image/',
+    size: ab.byteLength,
+    content: abToBase64(ab)
+  };
+}
+function abToBase64(ab) {
+  const bytes = new Uint8Array(ab);
+  let binary = '';
+  const chunk = 0x8000;
+  for (let i = 0; i < bytes.length; i += chunk) {
+    binary += String.fromCharCode(...bytes.subarray(i, i + chunk));
+  }
+  return btoa(binary);
+}
+```
+:::

package/templates/support-qa/profiles/aitable/wiki/faq-support/18-/345/274/200/345/217/221/350/200/205/346/214/207/345/215/227/AI/350/241/250/346/240/274/350/276/271/346/240/217/346/217/222/344/273/266 /345/274/200/345/217/221/346/214/207/345/215/227/Base /346/250/241/345/235/227.md"

@@ -0,0 +1,391 @@
+# Base 模块
+
+当前AI表格格实例，AI表格格相关 API 的主入口，提供了操作AI表格基础对象的方法，支持查询权限、管理数据表以及获取选择区域等信息。
+
+```typescript
+const base = DingdocsScript.base;
+```
+```typescript
+const base = Base; // 提供了全局变量Base
+```
+> 文中未声明的类型定义，请至[请至钉钉文档查看附件《AI表格JSAPI 类型描述》。](https://alidocs.dingtalk.com/i/nodes/pGBa2Lm8aeP35vxdtDBqQ1Xx8gN7R35y?iframeQuery=anchorId%3DX02mk15wsqsz7clll7zlo)中进行查询
+
+### getActiveSheet
+
+获取当前激活的数据表对象。
+
+```typescript
+getActiveSheet(): Sheet | null
+```
+
+**返回值**
+
+*   [`Sheet[] | null`](https://alidocs.dingtalk.com/i/nodes/dQPGYqjpJYZnRbNYCzr9jRXw8akx1Z5N) - 当前选中的数据表对象，若未选中任何数据表则返回 null
+    
+
+**示例**
+
+```typescript
+const activeSheet = base.getActiveSheet();
+if (activeSheet) {
+  console.log(`当前选中的数据表: ${activeSheet.getName()}`);
+} else {
+  console.log('当前未选中任何数据表');
+}
+
+```
+```typescript
+const activeSheet = Base.getActiveSheet();
+if (activeSheet) {
+  Output.log(`当前选中的数据表: ${activeSheet.getName()}`);
+} else {
+  Output.log('当前未选中任何数据表');
+}
+
+```
+
+### getSheet
+
+根据数据表ID或数据表名称获取指定数据表。
+
+```typescript
+getSheet(idOrName: string): Sheet | null
+
+```
+
+**参数**
+
+*   `idOrName`: `string` - 数据表ID或数据表名称
+    
+
+**返回值**
+
+*   [`Sheet | null`](https://alidocs.dingtalk.com/i/nodes/y20BglGWOGQgpOj6uYQeAA3EWA7depqY?utm_scene=person_space) - 匹配的数据表对象，若未找到则返回 null
+    
+
+**示例**
+
+```typescript
+// 通过名称获取数据表
+const productSheet = base.getSheet('产品清单');
+if (productSheet) {
+  console.log(`成功获取数据表，字段数量: ${productSheet.getFields().length}`);
+}
+
+// 通过ID获取数据表
+const sheetById = base.getSheet('sht123456');
+
+```
+```typescript
+// 通过名称获取数据表
+const productSheet = Base.getSheet('产品清单');
+if (productSheet) {
+  Output.log(`成功获取数据表，字段数量: ${productSheet.getFields().length}`);
+}
+
+// 通过ID获取数据表
+const sheetById = Base.getSheet('sht123456');
+
+```
+
+### getSheets
+
+获取当前用户可见的所有数据表。
+
+```typescript
+getSheets(): Sheet[]
+```
+
+**返回值**
+
+*   [`Sheet[]`](https://alidocs.dingtalk.com/i/nodes/y20BglGWOGQgpOj6uYQeAA3EWA7depqY?utm_scene=person_space) - 当前用户可见的所有数据表对象数组
+    
+
+**示例**
+
+```typescript
+const allSheets = base.getSheets();
+console.log(`可见的数据表数量: ${allSheets.length}`);
+allSheets.forEach(sheet => {
+  console.log(`- ${sheet.getName()}`);
+});
+
+```
+```typescript
+const allSheets = Base.getSheets();
+Output.log(`可见的数据表数量: ${allSheets.length}`);
+allSheets.forEach(sheet => {
+  Output.log(`- ${sheet.getName()}`);
+});
+
+```
+
+### insertSheet
+
+插入一张数据表。
+
+```typescript
+insertSheet(name: string, fields?: FieldToInsert[]): Sheet
+
+```
+
+**参数**
+
+*   `name`: `string` - 数据表名称
+    
+*   `fields`: [`FieldToInsert[]`](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno?iframeQuery=record%3DhERWDMS_qvGDAH2_pbtVzlZUdc)  (可选) - 数据表携带的字段配置，不传时会携带默认空数据表模版的字段
+    
+
+根据字段类型不同，支持传入的字段属性结构也不同，具体可以参考[《字段数据结构》](https://alidocs.dingtalk.com/i/nodes/nYMoO1rWxmP7olkyF0kGwelwV47Z3je9?utm_scene=team_space&iframeQuery=anchorId%3Duu_mk4xf3z7pfeezmqbo5e)
+
+**返回值**
+
+*   [`Sheet`](https://alidocs.dingtalk.com/i/nodes/y20BglGWOGQgpOj6uYQeAA3EWA7depqY?utm_scene=person_space) - 新插入的数据表对象
+    
+
+**示例**
+
+```typescript
+// 创建一个仅有默认字段的数据表
+const newSheet = base.insertSheet('新数据表');
+
+// 创建一个带有自定义字段的数据表
+const customSheet = base.insertSheet('客户信息', [
+  { name: '客户名称', type: 'text' },
+  { name: '注册日期', type: 'date' }
+]);
+
+```
+```typescript
+// 创建一个仅有默认字段的数据表
+const newSheet = Base.insertSheet('新数据表');
+
+// 创建一个带有自定义字段的数据表
+const customSheet = Base.insertSheet('客户信息', [
+  { name: '客户名称', type: 'text' },
+  { name: '注册日期', type: 'date' }
+]);
+
+```
+
+### updateSheet
+
+根据数据表ID更新指定数据表。
+
+```typescript
+updateSheet(id: string, sheetConfig: SheetToUpdate): Sheet
+
+```
+
+**参数**
+
+*   `id`: `string` - 数据表ID
+    
+*   `sheetConfig`: [`SheetToUpdate`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=ldfKflKobM&sheetId=hERWDMS&viewId=qvGDAH2) - 需要更新的数据表名称和描述
+    
+
+**返回值**
+
+*   [`Sheet`](https://alidocs.dingtalk.com/i/nodes/y20BglGWOGQgpOj6uYQeAA3EWA7depqY?utm_scene=person_space) - 更新的数据表对象，支持链式调用
+    
+
+### deleteSheet
+
+根据数据表ID或数据表名称删除指定数据表。
+
+```typescript
+deleteSheet(idOrName: string): Base
+
+```
+
+**参数**
+
+*   `idOrName`: `string` - 数据表ID或数据表名称
+    
+
+**返回值**
+
+*   `Base` - Base对象本身，支持链式调用
+    
+
+**示例**
+
+```typescript
+// 通过名称删除数据表
+base.deleteSheet('临时数据表');
+
+// 通过ID删除数据表并链式调用
+base.deleteSheet('sht123456').getSheets();
+
+```
+
+### isFieldOfType
+
+判断字段是否为指定字段类型
+
+```typescript
+isFieldOfType: <T extends FieldType>(field: Field<FieldType>, type: T) => field is Field<T>;
+```
+
+**参数**
+
+*   `field`: [`Field`](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space) - 需要判断类型的字段对象
+    
+*   `field`: [`FieldType`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=7Gtfo83ZWU&sheetId=hERWDMS&viewId=qvGDAH2) - 指定字段类型
+    
+
+**返回值**
+
+*   `boolean` - 是否为对应类型的字段
+    
+
+**示例**
+
+```typescript
+const field = sheet.getField('数字');
+if (field && base.isFieldOfType(field, 'number')) {
+    console.log('This is a number field');
+} else {
+    console.log('This is not a number Field')
+}
+```
+```typescript
+const field = sheet.getField('数字');
+if (field && Base.isFieldOfType(field, 'number')) {
+    Output.log('This is a number field');
+} else {
+    Output.log('This is not a number Field')
+}
+```
+
+### getSelection
+
+获取当前AI表格激活区域的信息
+
+```typescript
+getSelection: () => Selection;
+
+```
+
+**返回值**
+
+*    [`Selection`](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno?iframeQuery=record%3DhERWDMS_qvGDAH2_IL4TFXyGoQ) - 数据表激活区域的信息
+    
+
+### getDentryUuid
+
+获取文档dentryUuid。
+
+```typescript
+getDentryUuid(): string
+```
+
+**返回值**
+
+*   `string` - 文档的dentryUuid
+    
+
+**示例**
+
+```typescript
+const uuid = base.getDentryUuid();
+console.log(`当前文档UUID: ${uuid}`);
+
+```
+```typescript
+const uuid = Base.getDentryUuid();
+Output.log(`当前文档UUID: ${uuid}`);
+
+```
+
+### getCorpId
+
+获取文档所属企业的 CorpId。
+
+> ⚠️ **仅脚本插件可用**：此 API 仅支持在脚本插件中使用，不支持在边栏插件中调用。如需在边栏插件中调用，请查看getAuthCode API实现[《其他接口》](https://alidocs.dingtalk.com/i/nodes/1zknDm0WRz0NZeXQugKKDANoWBQEx5rG?utm_scene=team_space&iframeQuery=anchorId%3Duu_metpevjdhlx2zj3ysyw)。
+
+```plaintext
+getCorpId(): string
+```
+
+**返回值**
+
+*   `string` - 文档所属企业的 CorpId
+    
+
+**示例**
+
+```typescript
+const corpId = Base.getCorpId();
+Output.log(`当前企业ID: ${corpId}`);
+```
+
+### getCurrentUser
+
+获取当前用户信息。
+
+> ⚠️ **仅脚本插件可用**：此 API 仅支持在脚本插件中使用，不支持在边栏插件中调用。如需在边栏插件中调用，请查看getAuthCode API实现[《其他接口》](https://alidocs.dingtalk.com/i/nodes/1zknDm0WRz0NZeXQugKKDANoWBQEx5rG?utm_scene=team_space&iframeQuery=anchorId%3Duu_metpevjdhlx2zj3ysyw)。
+
+```typescript
+getCurrentUser(): Promise<UserCellValue | null>
+```
+
+**返回值**
+
+*   [`Promise<UserCellValue | null>`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=udEx7tlPxG&sheetId=hERWDMS&viewId=qvGDAH2) - 当前用户信息，如果用户不存在则返回 null。[`UserCellValue`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=udEx7tlPxG&sheetId=hERWDMS&viewId=qvGDAH2) 包含当前用户的基本信息用户ID。
+    
+
+**示例**
+
+```typescript
+const currentUser = await Base.getCurrentUser();
+if (currentUser) {
+  Output.log(`当前用户: ${currentUser.name}`);
+  Output.log(`用户ID: ${currentUser.unionId}`);
+} else {
+  Output.log('无法获取当前用户信息');
+}
+```
+
+### getPermissionAsync
+
+获取文档权限。
+
+```javascript
+getPermissionAsync: (params: IGetPermission) => Promise<boolean>;
+```
+
+**参数**
+
+*    [`IGetPermission`](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno?iframeQuery=record%3DhERWDMS_qvGDAH2_o9sPfOWcwA) **-** 权限范围
+    
+
+**返回值**
+
+*   `Promise<boolean>` - 是否拥有权限
+    
+
+示例
+
+```typescript
+const hasPermission = await base.getPermissionAsync({
+    scope: PermissionScope.BASE,
+    permissionType: PermissionType.MANAGE,
+});
+console.log('当前', hasPermission ? '拥有' : '未拥有', 'AI 表格管理权限')
+```
+```typescript
+const hasPermission = await Base.getPermissionAsync({
+    scope: PermissionScope.BASE,
+    permissionType: PermissionType.MANAGE,
+});
+Output.log('当前', hasPermission ? '拥有' : '未拥有', 'AI 表格管理权限')
+```
+
+## 注意事项
+
+1.  在使用 `insertSheet` 方法时，确保提供的字段名称不重复，且第一个字段类型必须支持作为主字段
+    
+2.  不能删除最后一张数据表，调用 `deleteSheet` 时需注意
+    
+3.  部分操作受权限限制，在执行前可以通过 `getPermissionAsync` 检查权限