aitable-workflow-cli 0.1.13-beta.1

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

@@ -0,0 +1,116 @@
+---
+title: Field 模块 API 参考
+category: reference
+sources: [18-开发者指南/AI表格脚本插件 开发指南/Field 模块.md, 18-开发者指南/AI表格边栏插件 开发指南/Field 模块.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [Field, 字段, 字段类型, 属性, CellValue, API]
+aliases: [字段模块, Field API, Field 基类]
+confidence: high
+summary: Field 模块提供操作数据表字段的方法，包括基本信息获取（ID/名称/类型/主键判断）、属性读写、字段值分页获取，以及通过泛型获取类型化字段的用法。
+---
+
+> Field 模块封装了数据表字段的操作接口，开发者可以获取字段信息、修改属性、读取字段值。推荐通过泛型或 `isFieldOfType` 获取类型化字段以获得更好的类型提示。
+
+## 获取 Field 实例
+
+通过 Sheet 模块获取字段：
+
+```typescript
+// 边栏插件（推荐使用泛型）
+const field = sheet.getField<SingleSelectField>(fieldNameOrId);
+field.addOption('Option1');
+
+// 脚本插件（使用 isFieldOfType 判断类型）
+const field = sheet.getField(fieldNameOrId);
+if (Base.isFieldOfType(field, 'singleSelect')) {
+  field.addOption('新选项');
+}
+```
+
+推荐从字段角度进行值的增删改查：
+
+```typescript
+await singleSelectField.setValueAsync(recordOrId, 'OptionId1');
+```
+
+## 基本信息方法
+
+| 方法 | 返回值 | 说明 |
+|------|--------|------|
+| `isValid()` | `boolean` | 字段是否有效 |
+| `getSheetId()` | `string` | 所属数据表 ID |
+| `getId()` | `string` | 字段 ID |
+| `isPrimary()` | `boolean` | 是否为主键列 |
+| `getName()` | `string` | 字段名称 |
+| `getType()` | `FieldType` | 字段类型 |
+
+### setName
+
+设置字段名称，返回 Field 自身（链式调用）。
+
+```typescript
+field.setName('客户全名');
+```
+
+注意：同一数据表中字段名称必须唯一，不能修改同步字段名称，需要字段更新权限。
+
+## 字段属性方法
+
+### getProperty
+
+获取字段配置属性，返回 `FieldProperty | undefined`。不同字段类型有不同属性结构，详见《字段数据结构》。
+
+```typescript
+const property = field.getProperty();
+```
+
+### setPropertyAsync
+
+异步设置字段配置属性，返回 `Promise<Field<T>>`。
+
+```typescript
+if (field.getType() === 'number') {
+  await field.setPropertyAsync({ formatter: 'FLOAT_1' });
+}
+```
+
+注意：某些属性修改可能触发整列数据加载。
+
+## 记录方法
+
+### getFieldValuesAsync
+
+分页获取整列字段值，返回 `Promise<PagedFieldValues<T> | null>`。
+
+```typescript
+const result = await field.getFieldValuesAsync({ pageSize: 20 });
+if (result) {
+  const { fieldValues, hasMore, cursor, total } = result;
+}
+```
+
+## 类型化字段
+
+Field 类支持泛型，可以获取特定类型的字段以使用专有方法：
+
+```typescript
+// 边栏插件
+const selectField = sheet.getField<SelectField>('状态');
+const options = selectField.getOptions();
+
+const numberField = sheet.getField<NumberField>('金额');
+const format = numberField.getFormat();
+```
+
+确保获取的字段类型与泛型匹配，不确定时先用 `getType()` 判断。
+
+## See Also
+
+- [Sheet 模块](../references/Sheet%20模块.md)
+- [字段数据结构](../references/字段数据结构.md)
+- [Record 模块](../references/Record%20模块.md)
+
+## Sources
+
+- [Field 模块](https://alidocs.dingtalk.com/i/nodes/y20BglGWOGQgpOj6uYQeAA3EWA7depqY?utm_scene=person_space)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/FilterUpField /346/237/245/346/211/276/345/274/225/347/224/250/345/255/227/346/256/265.md"

@@ -0,0 +1,82 @@
+---
+title: FilterUpField 查找引用字段
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/FilterUpField 查找引用字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [FilterUpField, 查找引用, Field API]
+aliases: [查找引用字段, filterUp]
+confidence: high
+summary: FilterUpField 是 AI 表格对象模型中的查找引用字段类型，继承自 Field 基类。它根据指定条件自动查找并引用数据，属于只读自动计算字段，不支持手动写入。
+---
+
+> FilterUpField 是 AI 表格中用于按条件查找并引用数据的字段类型。无需编写公式或建立关联关系，即可根据指定条件快速筛选和统计数据，是一种自动计算字段。
+
+## 核心特性
+
+- 继承自基础 Field 类
+- 通过字段配置**自动计算**引用结果，不能手动写入单元格值
+- 适用于筛选和统计数据场景
+
+## 字段特有方法
+
+### getValueAsync
+
+获取指定记录在查找引用字段中的计算结果值。
+
+```typescript
+getValueAsync: (recordId: string) => Promise<FormulaValue | null>
+```
+
+**参数**
+
+- `recordId`: `string` - 记录 ID
+
+**返回值**
+
+- `Promise<FormulaValue | null>` - 可能是单个值或数组；无匹配数据时返回 `null`
+
+**示例（泛型写法）**
+
+```typescript
+const filterUpField = sheet.getField<FilterUpField>('本月销售额');
+if (filterUpField) {
+  const monthlySales = await filterUpField.getValueAsync('rec_789');
+  if (monthlySales !== null) {
+    console.log(`本月销售额: ${monthlySales}`);
+    if (Array.isArray(monthlySales)) {
+      monthlySales.forEach((value, index) => {
+        console.log(`汇总值${index + 1}: ${value}`);
+      });
+    }
+  }
+}
+```
+
+**示例（类型守卫写法）**
+
+```typescript
+const filterUpField = sheet.getField('本月销售额');
+if (Base.isFieldOfType(filterUpField, 'filterUp')) {
+  const monthlySales = await filterUpField.getValueAsync('rec_789');
+  if (monthlySales !== null) {
+    Output.log(`本月销售额: ${monthlySales}`);
+  }
+}
+```
+
+## 注意事项
+
+- 该字段为只读字段，值由系统自动计算生成
+- 返回值可能为单个值，也可能为数组（多个汇总函数结果）
+- 如果筛选条件无匹配数据，返回 `null`
+
+## See Also
+
+- [Field 模块](./Field%20模块.md)
+- [FormulaField 公式字段](./FormulaField%20公式字段.md)
+- [LookupField 关联引用字段](./LookupField%20关联引用字段.md)
+
+## Sources
+
+- [FilterUpField 查找引用字段](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/FormulaField /345/205/254/345/274/217/345/255/227/346/256/265.md"

@@ -0,0 +1,92 @@
+---
+title: FormulaField 公式字段
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/FormulaField 公式字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [FormulaField, 公式字段, Field API]
+aliases: [公式字段, formula]
+confidence: high
+summary: FormulaField 是 AI 表格对象模型中的公式字段类型，通过预定义公式表达式自动计算并显示结果。支持读取计算结果和设置公式表达式。
+---
+
+> FormulaField 用于处理公式计算类型数据，通过预定义的公式表达式自动计算并显示结果。该字段的值不能手动写入，但可以通过 API 修改公式表达式。
+
+## 核心特性
+
+- 继承自基础 Field 类
+- 通过公式表达式**自动计算**结果，单元格值不可手动写入
+- 支持读取计算结果和动态修改公式
+
+## 字段特有方法
+
+### getValueAsync
+
+获取指定记录的公式计算结果。
+
+```typescript
+getValueAsync: (recordId: string) => Promise<FormulaValue | null>
+```
+
+**参数**
+
+- `recordId`: `string` - 记录 ID
+
+**返回值**
+
+- `Promise<FormulaValue | null>` - 计算结果，可能是单个值或数组；计算失败或记录不存在时返回 `null`
+
+**示例**
+
+```typescript
+const formulaField = sheet.getField<FormulaField>('总金额');
+if (formulaField) {
+  const result = await formulaField.getValueAsync('rec_order_123');
+  if (result !== null) {
+    console.log(`订单总金额: ${result}`);
+  }
+}
+```
+
+### setFormula
+
+设置公式表达式。
+
+```typescript
+setFormula: (formula: string) => string
+```
+
+**参数**
+
+- `formula`: `string` - 公式表达式
+
+**返回值**
+
+- `string` - 字段 ID
+
+**示例**
+
+```typescript
+const formulaField = sheet.getField<FormulaField>('总金额');
+if (formulaField) {
+  formulaField.setFormula("[单价]*[数量]");
+  formulaField.setFormula("[单价]*20");
+}
+```
+
+## 注意事项
+
+- 公式字段值由系统自动计算，不能通过 `setValueAsync` 写入
+- 公式中引用其他字段时使用 `[字段名]` 语法
+- 返回值类型取决于公式计算结果，可能是数字、字符串或数组
+
+## See Also
+
+- [Field 模块](./Field%20模块.md)
+- [FilterUpField 查找引用字段](./FilterUpField%20查找引用字段.md)
+- [LookupField 关联引用字段](./LookupField%20关联引用字段.md)
+- [NumberField 数字字段](./NumberField%20数字字段.md)
+
+## Sources
+
+- [FormulaField 公式字段](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/GeoLocationField /345/234/260/347/220/206/344/275/215/347/275/256/345/255/227/346/256/265.md"

@@ -0,0 +1,62 @@
+---
+title: GeoLocationField 地理位置字段
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/GeoLocationField 地理位置字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [GeoLocationField, 地理位置, Field API]
+aliases: [地理位置字段, geoLocation]
+confidence: high
+summary: GeoLocationField 是 AI 表格对象模型中的地理位置字段类型，用于存储和获取包含地址、简短地址、完整地址及经纬度的地理位置数据。
+---
+
+> GeoLocationField 用于处理地理位置数据，返回结构化的位置信息，包括地址名称、完整地址和经纬度坐标。适用于需要记录地点信息的业务场景。
+
+## 核心特性
+
+- 继承自基础 Field 类
+- 返回结构化的地理位置信息（GeoLocationValue）
+- 包含 address、name、fullAddress 和 location（经纬度）
+
+## 数据结构
+
+```typescript
+type GeoLocationValue = {
+  address: string;        // 地址
+  name: string;           // 简短地址
+  fullAddress: string;    // 完整地址
+  location: [number, number]; // 经纬度
+};
+```
+
+## 字段特有方法
+
+### getValueAsync
+
+获取指定记录的地理位置值。
+
+```typescript
+getValueAsync: (recordId: string) => Promise<GeoLocationValue | null>
+```
+
+**参数**
+
+- `recordId`: `string` - 记录 ID
+
+**返回值**
+
+- `Promise<GeoLocationValue | null>` - 地理位置对象；无数据时返回 `null`
+
+## 注意事项
+
+- 返回值包含多层地址信息，使用 `name` 获取简短地址，`fullAddress` 获取完整地址
+- `location` 字段为 `[经度, 纬度]` 的二元组
+
+## See Also
+
+- [Field 模块](./Field%20模块.md)
+- [TextField 文本字段](./TextField%20文本字段.md)
+
+## Sources
+
+- [GeoLocationField 地理位置字段](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/GridView /350/241/250/346/240/274/350/247/206/345/233/276.md"

@@ -0,0 +1,138 @@
+---
+title: GridView 表格视图 API 参考
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/View 模块/GridView 表格视图.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [GridView, 表格视图, 视图, 筛选, 排序, 填色, API]
+aliases: [表格视图API, GridView API]
+confidence: high
+summary: GridView 是数据表中的表格视图类型，提供字段显隐与宽度管理、记录可见性查询、填色规则、筛选条件管理和视图设置提交等功能的完整 API 参考。
+---
+
+> GridView（表格视图）是 AI 表格中最常用的视图类型，以表格形式展示数据。GridView 在 View 基类上扩展了字段显隐、宽度调整、筛选条件管理、填色规则等高级视图配置能力。
+
+## 获取 GridView 实例
+
+通过 View 对象的 `asGridView()` 方法转换：
+
+```typescript
+const view = sheet.getView('view123');
+const gridView = view.asGridView();
+```
+
+## 基本信息方法
+
+| 方法 | 返回值 | 说明 |
+|------|--------|------|
+| `sheetId` | `string` | 所属数据表 ID（属性） |
+| `getName()` | `string` | 视图名称 |
+| `getType()` | `'Grid'` | 视图类型，始终返回 `'Grid'` |
+| `getMeta()` | `IGridViewMeta` | 视图元信息（ID、名称、类型、属性） |
+
+## 字段管理方法
+
+### 字段显隐
+
+- `getVisibleFieldIdList()` — 获取可见字段 ID 列表
+- `showField(fieldId)` — 显示字段（单个 ID 或数组）
+- `hideField(fieldId)` — 隐藏字段（主键字段禁止隐藏）
+
+### 字段宽度
+
+- `getFieldWidth(fieldId)` — 获取单个字段宽度（像素）
+- `getFieldWidths()` — 获取所有字段宽度映射
+- `setFieldWidth(fieldId, width)` — 设置单个字段宽度
+- `setFieldWidths(fieldWidths)` — 批量设置字段宽度，返回 GridView 自身
+
+## 记录管理方法
+
+### getVisibleRecordIdListAsync
+
+获取可见记录 ID 列表，返回 `Promise<string[]>`。
+
+```typescript
+const visibleRecordIds = await gridView.getVisibleRecordIdListAsync();
+```
+
+## 填色规则方法
+
+| 方法 | 说明 |
+|------|------|
+| `getFillColorInfo()` | 获取当前填色规则信息 |
+| `addFillColorRuleAsync(params)` | 新增填色规则 |
+| `updateFillColorRuleAsync(params)` | 更新填色规则 |
+| `deleteFillColorRuleAsync(ruleId)` | 删除填色规则 |
+
+填色规则操作后需调用 `applySetting()` 保存。
+
+```typescript
+await gridView.addFillColorRuleAsync({
+  type: FillColorType.Column,
+  fieldId: 'fieldId123',
+  format: { color: '1' },
+});
+gridView.applySetting();
+```
+
+## 筛选条件管理方法
+
+### getFilterInfo
+
+获取当前筛选信息，无筛选条件时返回 `null`。
+
+### addFilterConditionAsync / updateFilterConditionAsync / deleteFilterConditionAsync
+
+新增、更新或删除筛选条件，支持单个条件或条件数组。操作后需调用 `applySetting()` 保存。
+
+```typescript
+await gridView.addFilterConditionAsync({
+  fieldId: 'field123',
+  operator: FilterOperator.Contains,
+  value: '重要',
+});
+gridView.applySetting();
+```
+
+### setFilterConjunction
+
+设置筛选条件之间的关系（`and` 或 `or`）。
+
+```typescript
+gridView.setFilterConjunction(FilterConjunction.And);
+gridView.applySetting();
+```
+
+## applySetting — 提交设置
+
+将分组/筛选/排序/填色等视图配置提交并同步给其他用户。所有视图配置修改后均需调用此方法。
+
+```typescript
+gridView.applySetting();
+```
+
+## 完整使用示例
+
+```typescript
+const view = views.find(v => v.getType() === 'Grid');
+const gridView = view.asGridView();
+
+gridView.hideField(['field1', 'field2']);
+gridView.setFieldWidth('titleField', 300);
+
+await gridView.addFilterConditionAsync([
+  { fieldId: 'statusField', operator: FilterOperator.IsNot, value: '已完成' },
+  { fieldId: 'priorityField', operator: FilterOperator.IsGreater, value: 3 },
+]);
+gridView.setFilterConjunction(FilterConjunction.And);
+gridView.applySetting();
+```
+
+## See Also
+
+- [View 模块](../references/View%20模块.md)
+- [Sheet 模块](../references/Sheet%20模块.md)
+
+## Sources
+
+- [GridView 表格视图](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=QPi6Mob6PM&sheetId=hERWDMS&viewId=qvGDAH2)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/GroupField /347/276/244/347/273/204/345/255/227/346/256/265.md"

@@ -0,0 +1,86 @@
+---
+title: GroupField 群组字段
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/GroupField 群组字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [GroupField, 群组字段, Field API, 钉钉群]
+aliases: [群组字段, group]
+confidence: high
+summary: GroupField 是 AI 表格对象模型中的群组字段类型，用于关联钉钉群聊会话。通过 openConversationId 识别群聊，支持读取和设置群会话值。
+---
+
+> GroupField 用于处理群组类型数据，可将钉钉群聊会话与数据表记录关联。通过 openConversationId 唯一标识群聊会话，支持读取和写入群会话信息。
+
+## 前置概念
+
+**openConversationId** 用于唯一识别群聊会话，可通过钉钉创建群接口的返回值获取。详见 [钉钉 IM 会话概述](https://open.dingtalk.com/document/development/im-session-overview)。
+
+## 字段特有方法
+
+### getValueAsync
+
+获取指定记录中选择的群会话列表。
+
+```typescript
+getValueAsync: (recordId: string) => Promise<GroupCellValue[] | null>
+```
+
+**参数**
+
+- `recordId`: `string` - 记录 ID
+
+**返回值**
+
+- `Promise<GroupCellValue[] | null>` - 群会话数组，包含群名称和 openConversationId
+
+**示例**
+
+```typescript
+const groupField = sheet.getField<GroupField>('群组');
+if (groupField) {
+  const groups = await groupField.getValueAsync('rec123456');
+  console.log('查询到群会话：', groups.map(g => `群名：${g.name}|群ID: ${g.openConversationId}`).join('\n'));
+}
+```
+
+### setValueAsync
+
+设置指定记录的群会话值。
+
+```typescript
+setValueAsync: (recordId: string, value: GroupCellValue[]) => Promise<boolean>
+```
+
+**参数**
+
+- `recordId`: `string` - 记录 ID
+- `value`: `GroupCellValue[]` - 群会话值数组，传入 openConversationId
+
+**返回值**
+
+- `Promise<boolean>` - 操作是否成功
+
+**示例**
+
+```typescript
+const groupField = sheet.getField<GroupField>('群组');
+if (groupField) {
+  const success = await groupField.setValueAsync('rec123456', [
+    { openConversationId: 'cidxxxxx123' },
+    { openConversationId: 'cidxxxxx456' },
+  ]);
+  if (success) {
+    console.log('向记录中更新了两个群会话');
+  }
+}
+```
+
+## See Also
+
+- [Field 模块](./Field%20模块.md)
+- [UserField 人员字段](./UserField%20人员字段.md)
+
+## Sources
+
+- [GroupField 群组字段](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/Input/346/250/241/345/235/227.md

@@ -0,0 +1,110 @@
+---
+title: Input 模块 API 参考
+category: reference
+sources: [18-开发者指南/AI表格脚本插件 开发指南/Input模块.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [Input, 用户输入, 表单, 交互, 脚本插件, API]
+aliases: [Input API, 输入模块]
+confidence: high
+summary: Input 模块为脚本插件提供交互式用户输入能力，支持文本输入（textAsync）、选择器（selectAsync）和表单（formAsync）三种交互方式，以及输入校验和按钮字段自动填充机制。
+---
+
+> Input 模块是脚本插件的全局变量，支持在运行面板中创建交互式 UI 等待用户输入。所有交互方法均为异步，需配合 `await` 使用。
+
+## textAsync — 文本输入
+
+在运行面板插入输入框，等待用户输入。
+
+```typescript
+textAsync: (label: string, config?: InputConfig<string>) => Promise<string>;
+```
+
+```typescript
+const userInput = await Input.textAsync("请输入一段内容");
+Output.info('用户输入:', userInput);
+```
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn55XMvyeMyno8/img/f9995ccb-041f-4bd7-990f-fe08d1f3ce5e.png)
+
+## selectAsync — 选择器
+
+显示一组按钮，等待用户点击选择。
+
+```typescript
+selectAsync: <V>(label: string, options: Array<string | SelectOption<V>>, config?: InputConfig) => Promise<string | V | undefined>;
+```
+
+```typescript
+const answer = await Input.selectAsync('请选择答案', ['A', 'B', 'C', 'D']);
+```
+
+选项支持字符串格式或 `{text, value}` 对象格式。
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn55XMvyeMyno8/img/fb8a8701-ca5a-40d7-ae7e-5a595bb7153d.png)
+
+## formAsync — 表单
+
+插入包含多个表单项的复合表单，等待用户提交。
+
+```typescript
+formAsync: (title: string, items: FormItem[], config?: InputConfig) => Promise<Record<FormItemKey, FormItemResult | undefined>>;
+```
+
+### 支持的表单项类型
+
+| 类型 | 说明 | 返回值 |
+|------|------|--------|
+| `sheet` | 数据表选择器 | `Sheet` |
+| `field` | 字段选择器（需 `referenceSheet`） | `Field` |
+| `view` | 视图选择器（需 `referenceSheet`） | `View` |
+| `record` | 记录选择器（需 `referenceSheet`） | `Record` |
+| `text` | 文本输入框 | `string` |
+| `number` | 数字输入框 | `number` |
+| `select` | 下拉选择器 | 选项值 |
+
+```typescript
+const formResult = await Input.formAsync('请填写表单', [
+  { type: 'sheet', key: 'sheet', option: { label: '选择数据表' }, required: true },
+  { type: 'field', key: 'field', option: { label: '选择字段', referenceSheet: 'sheet' } },
+  { type: 'text', key: 'text', option: { label: '请输入文本' }, required: true },
+]);
+```
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn55XMvyeMyno8/img/a84f21dd-da0a-4351-810e-0a5c0a69046e.png)
+
+## 入参校验
+
+三种输入方法均支持 `config.validate` 校验函数，校验不通过时阻止提交并显示错误信息。
+
+```typescript
+const name = await Input.textAsync('请输入名称', {
+  validate: (value) => {
+    if (!value.trim()) return { valid: false, error: '不能为空' };
+    return { valid: true };
+  },
+});
+```
+
+支持异步校验（返回 `Promise<ValidationResult>`）。
+
+## 按钮字段触发脚本
+
+脚本可通过直接运行或按钮字段触发。通过按钮字段触发时，`formAsync` 会自动识别上下文并填充：
+
+- **Sheet** → 自动填充为按钮所在数据表
+- **View** → 自动填充为当前视图（需 `referenceSheet`）
+- **Record** → 自动填充为点击按钮的行记录（需 `referenceSheet`）
+
+当所有必填项均可自动填充时，表单自动提交无需用户操作；否则已识别项预填后等待用户完成剩余输入。
+
+## See Also
+
+- [Output模块](../references/Output模块.md)
+- [AI表格脚本插件 开发指南](../topics/AI表格脚本插件%20开发指南.md)
+- [Base 模块](../references/Base%20模块.md)
+- [[AI表格脚本插件 开发指南|AI 表格脚本插件开发指南]] ([AI 表格脚本插件开发指南](../topics/AI表格脚本插件 开发指南.md))
+
+## Sources
+
+- [Input模块](https://alidocs.dingtalk.com/i/nodes/3NwLYZXWyrmRolXLcYE0oX7aVkyEqBQm?utm_scene=team_space&iframeQuery=anchorId%3Duu_mmiv2vbfh6belccm86f)