aitable-workflow-cli 0.1.13-beta.1

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/LastModifiedTimeField /346/234/200/345/220/216/346/233/264/346/226/260/346/227/266/351/227/264/345/255/227/346/256/265.md"

@@ -0,0 +1,96 @@
+---
+title: LastModifiedTimeField 最后更新时间字段
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/LastModifiedTimeField 最后更新时间字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [LastModifiedTimeField, 最后更新时间, Field API]
+aliases: [最后更新时间字段, lastModifiedTime]
+confidence: high
+summary: LastModifiedTimeField 是 AI 表格对象模型中的最后修改时间字段类型，系统自动记录行记录的最后修改时间。为只读字段，支持获取时间戳和设置日期格式。
+---
+
+> LastModifiedTimeField 用于自动记录数据行的最后修改时间，以毫秒级 Unix 时间戳形式存储。这是一个系统自动生成的只读字段，不能手动设置值，但可以自定义日期显示格式。
+
+## 核心特性
+
+- 继承自基础 Field 类
+- 系统自动记录，**只读字段**，不能手动设置值
+- 以毫秒级 Unix 时间戳存储
+
+## 字段特有方法
+
+### getValueAsync
+
+获取指定记录的最后修改时间。
+
+```typescript
+getValueAsync: (recordId: string) => Promise<DateCellValue | null>
+```
+
+**参数**
+
+- `recordId`: `string` - 记录 ID
+
+**返回值**
+
+- `Promise<DateCellValue | null>` - 最后修改时间的时间戳（毫秒）；字段值为空时返回 `null`
+
+**示例**
+
+```typescript
+const lastModifiedTimeField = sheet.getField<LastModifiedTimeField>('最后修改时间');
+if (lastModifiedTimeField) {
+  const timestamp = await lastModifiedTimeField.getValueAsync('rec123456');
+  if (timestamp !== null) {
+    const date = new Date(timestamp);
+    console.log(`最后修改时间: ${date.toLocaleString()}`);
+  }
+}
+```
+
+### getDateFormat
+
+获取日期格式。
+
+```typescript
+getDateFormat: () => DateFormatter
+```
+
+**返回值**
+
+- `DateFormatter` - 日期格式
+
+### setDateFormat
+
+设置日期格式。
+
+```typescript
+setDateFormat: (format: DateFormatter) => string
+```
+
+**参数**
+
+- `format`: `DateFormatter` - 日期格式（如 `'YYYY-MM-DD HH:mm:ss'`）
+
+**返回值**
+
+- `string` - 字段 ID
+
+**示例**
+
+```typescript
+const lastModifiedTimeField = sheet.getField<LastModifiedTimeField>('最后修改时间');
+if (lastModifiedTimeField) {
+  lastModifiedTimeField.setDateFormat('YYYY-MM-DD HH:mm:ss');
+}
+```
+
+## See Also
+
+- [Field 模块](./Field%20模块.md)
+- [Record 模块](./Record%20模块.md)
+
+## Sources
+
+- [LastModifiedTimeField 最后更新时间字段](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/LookupField /345/205/263/350/201/224/345/274/225/347/224/250/345/255/227/346/256/265.md"

@@ -0,0 +1,72 @@
+---
+title: LookupField 关联引用字段
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/LookupField 关联引用字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [LookupField, 关联引用, Field API]
+aliases: [关联引用字段, lookup]
+confidence: high
+summary: LookupField 是 AI 表格对象模型中的关联引用字段类型，提供跨表数据引用能力，自动计算引用结果。属于只读字段，支持对引用数据进行后续计算。
+---
+
+> LookupField 用于跨表数据引用，可以快捷地从关联表中提取数据并进行后续计算。该字段通过配置自动计算引用结果，不支持手动写入单元格值。
+
+## 核心特性
+
+- 继承自基础 Field 类
+- 提供跨表数据引用能力
+- 通过字段配置**自动计算**引用结果，不能手动写入
+- 支持多对多关联场景，返回值可为数组
+
+## 字段特有方法
+
+### getValueAsync
+
+获取指定记录的关联引用值。
+
+```typescript
+getValueAsync: (recordId: string) => Promise<FormulaValue | null>
+```
+
+**参数**
+
+- `recordId`: `string` - 记录 ID
+
+**返回值**
+
+- `Promise<FormulaValue | null>` - 关联字段值，可能是单个值或数组；无关联数据时返回 `null`
+
+**示例**
+
+```typescript
+const lookupField = sheet.getField<LookupField>('客户名称');
+if (lookupField) {
+  const customerName = await lookupField.getValueAsync('rec_order_456');
+  if (customerName !== null) {
+    console.log(`关联的客户名称: ${customerName}`);
+    if (Array.isArray(customerName)) {
+      customerName.forEach((name, index) => {
+        console.log(`客户${index + 1}: ${name}`);
+      });
+    }
+  }
+}
+```
+
+## 注意事项
+
+- 该字段为只读，值由系统根据关联配置自动计算
+- 多对多关联时返回值为数组
+- 需要先建立关联关系才能使用关联引用字段
+
+## See Also
+
+- [Field 模块](./Field%20模块.md)
+- [FilterUpField 查找引用字段](./FilterUpField%20查找引用字段.md)
+- [FormulaField 公式字段](./FormulaField%20公式字段.md)
+- [UnidirectionalLinkFields 单向关联字段](./UnidirectionalLinkFields%20单向关联字段.md)
+
+## Sources
+
+- [LookupField 关联引用字段](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/MultiSelectField /345/244/232/351/200/211/345/255/227/346/256/265.md"

@@ -0,0 +1,127 @@
+---
+title: MultiSelectField 多选字段
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/MultiSelectField 多选字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [MultiSelectField, 多选字段, Field API, 选项管理]
+aliases: [多选字段, multipleSelect]
+confidence: high
+summary: MultiSelectField 是 AI 表格对象模型中的多选字段类型，支持从预设选项中选择多个值。提供选项的增删改查、记录值的读写等完整操作能力。
+---
+
+> MultiSelectField 用于从预设选项中选择多个值，常用于标签、分类等多值场景。提供完整的选项管理（增删改查）和记录值读写功能。
+
+## 核心特性
+
+- 继承自基础 Field 类
+- 支持多选，返回值为选项数组
+- 提供选项的完整生命周期管理
+
+## 字段特有方法
+
+### getValueAsync
+
+获取指定记录中选择的选项列表。
+
+```typescript
+getValueAsync: (recordId: string) => Promise<SelectOption[] | null>
+```
+
+**返回值**
+
+- `Promise<SelectOption[] | null>` - 选项数组，包含 `id` 和 `name` 属性；未选择时返回 `null`
+
+### setValueAsync
+
+设置指定记录的多选选项。
+
+```typescript
+setValueAsync: (recordId: string, optionId: string | string[]) => Promise<boolean>
+```
+
+**参数**
+
+- `recordId`: `string` - 记录 ID
+- `optionId`: `string | string[]` - 单个选项 ID 或选项 ID 数组
+
+**示例**
+
+```typescript
+const tagsField = sheet.getField<MultipleSelectField>('标签');
+if (tagsField) {
+  const options = tagsField.getOptions();
+  const urgentTag = options.find(opt => opt.name === '紧急');
+  const importantTag = options.find(opt => opt.name === '重要');
+  if (urgentTag && importantTag) {
+    await tagsField.setValueAsync('rec123456', [urgentTag.id, importantTag.id]);
+  }
+}
+```
+
+### addOption
+
+添加单个新选项。
+
+```typescript
+addOption: (name: string) => string
+```
+
+### addOptions
+
+批量添加多个选项。
+
+```typescript
+addOptions: (optionList: { name: string }[]) => string
+```
+
+**示例**
+
+```typescript
+priorityField.addOptions([
+  { name: '低' }, { name: '中' }, { name: '高' }, { name: '紧急' }
+]);
+```
+
+### getOptions
+
+获取所有选项列表。
+
+```typescript
+getOptions: () => ISelectFieldOption[]
+```
+
+**返回值**
+
+- `ISelectFieldOption[]` - 选项列表，每个选项包含 `id`、`name` 和 `color` 属性
+
+### deleteOptionAsync
+
+删除指定选项（异步，因会影响字段值）。
+
+```typescript
+deleteOptionAsync: (idOrName: string) => Promise<string>
+```
+
+### setOptionAsync
+
+修改指定选项的配置。
+
+```typescript
+setOptionAsync: (nameOrId: string, config: IOptionConfig) => Promise<string>
+```
+
+**示例**
+
+```typescript
+await statusField.setOptionAsync('进行中', { name: '处理中' });
+```
+
+## See Also
+
+- [Field 模块](./Field%20模块.md)
+- [SingleSelectField 单选字段](./SingleSelectField%20单选字段.md)
+
+## Sources
+
+- [MultiSelectField 多选字段](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/NumberField /346/225/260/345/255/227/345/255/227/346/256/265.md"

@@ -0,0 +1,97 @@
+---
+title: NumberField 数字字段
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/NumberField 数字字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [NumberField, 数字字段, Field API, 数字格式]
+aliases: [数字字段, number]
+confidence: high
+summary: NumberField 是 AI 表格对象模型中的数字字段类型，支持整数和小数，提供多种格式化选项（如百分比、货币），以及值的读写和格式设置功能。
+---
+
+> NumberField 用于处理数字类型数据，支持整数、小数以及多种格式化展示（百分比、货币等）。提供值的读写和格式化配置功能。
+
+## 核心特性
+
+- 继承自基础 Field 类
+- 支持整数和小数
+- 提供多种数字格式化选项（如 `CNY_FLOAT`、`PERCENT_FLOAT`）
+
+## 字段特有方法
+
+### getValueAsync
+
+获取指定记录的数字值。
+
+```typescript
+getValueAsync: (recordId: string) => Promise<number | null>
+```
+
+**返回值**
+
+- `Promise<number | null>` - 数字值；记录不存在或值为空时返回 `null`
+
+### setValueAsync
+
+设置指定记录的数字值。
+
+```typescript
+setValueAsync: (recordId: string, num: number) => Promise<boolean>
+```
+
+**示例**
+
+```typescript
+const priceField = sheet.getField<NumberField>('价格');
+if (priceField) {
+  const success = await priceField.setValueAsync('rec123456', 199.99);
+}
+```
+
+### getFormatter
+
+获取数字字段的格式。
+
+```typescript
+getFormatter(): NumericalFormatter
+```
+
+### setFormatter
+
+设置数字字段的格式。
+
+```typescript
+setFormatter: (formatter: NumericalFormatter) => string
+```
+
+**常用格式类型**
+
+| 格式 | 说明 |
+|------|------|
+| `CNY_FLOAT` | 人民币格式 |
+| `PERCENT_FLOAT` | 百分比格式 |
+
+**示例**
+
+```typescript
+const priceField = sheet.getField<NumberField>('价格');
+if (priceField) {
+  priceField.setFormatter('CNY_FLOAT');
+}
+
+const rateField = sheet.getField<NumberField>('完成率');
+if (rateField) {
+  rateField.setFormatter('PERCENT_FLOAT');
+}
+```
+
+## See Also
+
+- [Field 模块](./Field%20模块.md)
+- [ProgressField 进度字段](./ProgressField%20进度字段.md)
+- [RatingField 评分字段](./RatingField%20评分字段.md)
+
+## Sources
+
+- [NumberField 数字字段](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)

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

@@ -0,0 +1,97 @@
+---
+title: Output 模块 API 参考
+category: reference
+sources: [18-开发者指南/AI表格脚本插件 开发指南/Output模块.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [Output, 输出, 日志, Markdown, 表格, 脚本插件, API]
+aliases: [Output API, 输出模块]
+confidence: high
+summary: Output 模块为脚本插件提供运行面板中的信息展示能力，支持 log/info/success/warn/error 五种级别的文本输出、Markdown 富文本渲染、表格展示和清屏操作。
+---
+
+> Output 模块是脚本插件的全局变量，类似于 Console API，用于在运行面板中展示丰富的数据信息，帮助开发者调试和向用户呈现结果。
+
+## 文本输出方法
+
+五种级别的文本输出，背景色依次为透明、蓝色、绿色、黄色、红色：
+
+### log — 普通日志
+
+```typescript
+Output.log('日志信息');
+```
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/Q35O851wgBDDEl9V/img/2346149c-b62d-4a6e-952f-d02792d58b57.png)
+
+### info — 提示信息
+
+```typescript
+Output.info('提示信息');
+```
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/Q35O851wgBDDEl9V/img/53e80c8d-bd8d-4b20-870b-967e78ecb0fd.png)
+
+### success — 成功信息
+
+```typescript
+Output.success('操作成功！共处理了 10 条记录');
+```
+
+### warn — 警告信息
+
+```typescript
+Output.warn('告警信息');
+```
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/Q35O851wgBDDEl9V/img/6391438c-af6c-4bcb-8fe3-b5ed13fb2308.png)
+
+### error — 错误信息
+
+```typescript
+Output.error('错误信息');
+```
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/Q35O851wgBDDEl9V/img/024e971d-b54a-47cd-9e7e-acda507444f8.png)
+
+## markdown — 富文本输出
+
+支持标准 Markdown 语法渲染。
+
+```typescript
+Output.markdown(`## 标题\n- **加粗**\n- *斜体*\n- \`代码\``);
+```
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/Q35O851wgBDDEl9V/img/1f371fcb-d2f6-46a6-a58d-6221fff3ac71.png)
+
+## table — 表格展示
+
+以表格形式展示数组或对象。
+
+```typescript
+Output.table([
+  { name: 'John', age: 15, gender: 'Male' },
+  { name: 'Alice', age: 24, gender: 'Female' },
+]);
+```
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/Q35O851wgBDDEl9V/img/9b57fc6d-c58e-4779-a4bf-bfe3bff9479e.png)
+
+## clear — 清空输出
+
+清空运行面板中的所有输出内容。
+
+```typescript
+Output.clear();
+Output.log('面板已清空');
+```
+
+## See Also
+
+- [Input模块](../references/Input模块.md)
+- [AI表格脚本插件 开发指南](../topics/AI表格脚本插件%20开发指南.md)
+- [[AI表格脚本插件 开发指南|AI 表格脚本插件开发指南]] ([AI 表格脚本插件开发指南](../topics/AI表格脚本插件 开发指南.md))
+
+## Sources
+
+- Output模块

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/PrimaryField /344/270/273/351/224/256/346/226/207/346/241/243/345/255/227/346/256/265.md"

@@ -0,0 +1,78 @@
+---
+title: PrimaryField 主键文档字段
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/PrimaryField 主键文档字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [PrimaryField, 主键字段, Field API]
+aliases: [主键文档字段, primaryDoc]
+confidence: high
+summary: PrimaryField 是 AI 表格对象模型中的主键文档字段类型，数据表中仅主键字段可设为 PrimaryField。支持文本值的读写操作。
+---
+
+> PrimaryField 用于处理主键文档字段数据，是数据表中唯一的主键列。每个数据表有且仅有一个主键字段，通常用于存储记录的标题或唯一标识文本。
+
+## 核心特性
+
+- 继承自基础 Field 类
+- 数据表中**仅主键字段**可以设置为 PrimaryField
+- 支持文本值的读写
+
+## 字段特有方法
+
+### getValueAsync
+
+获取指定记录的主键文本值。
+
+```typescript
+getValueAsync: (recordId: string) => Promise<string | null>
+```
+
+**返回值**
+
+- `Promise<string | null>` - 文本值；记录不存在或值为空时返回 `null`
+
+**示例**
+
+```typescript
+const primaryDocField = sheet.getField<PrimaryDocField>('标题');
+if (primaryDocField) {
+  const text = await primaryDocField.getValueAsync('rec123456');
+}
+```
+
+### setValueAsync
+
+设置指定记录的主键文本值。
+
+```typescript
+setValueAsync: (recordId: string, text: string) => Promise<boolean>
+```
+
+**参数**
+
+- `recordId`: `string` - 记录 ID
+- `text`: `string` - 要设置的文本值
+
+**返回值**
+
+- `Promise<boolean>` - 设置是否成功
+
+**示例**
+
+```typescript
+const primaryDocField = sheet.getField<PrimaryDocField>('标题');
+if (primaryDocField) {
+  const success = await primaryDocField.setValueAsync('rec123456', '这是一条新的内容');
+}
+```
+
+## See Also
+
+- [Field 模块](./Field%20模块.md)
+- [TextField 文本字段](./TextField%20文本字段.md)
+- [RichTextField 富文本字段](./RichTextField%20富文本字段.md)
+
+## Sources
+
+- [PrimaryField 主键文档字段](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/ProgressField /350/277/233/345/272/246/345/255/227/346/256/265.md"

@@ -0,0 +1,80 @@
+---
+title: ProgressField 进度字段
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/ProgressField 进度字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [ProgressField, 进度字段, Field API]
+aliases: [进度字段, progress]
+confidence: medium
+summary: ProgressField 是 AI 表格对象模型中的进度字段类型（灰度放量中），以百分比形式展示任务完成进度，支持设置范围和格式化。
+---
+
+> ProgressField 用于表示任务或项目的完成进度，通常以百分比形式展示。支持设置进度范围（最小值/最大值）和格式化配置。该字段目前处于灰度放量阶段。
+
+## 核心特性
+
+- 继承自基础 Field 类
+- 以百分比形式展示进度
+- 支持自定义范围（最小值、最大值）
+- **灰度放量阶段**，可能尚未对所有用户开放
+
+## 字段特有方法
+
+### getValueAsync / setValueAsync
+
+读取和设置进度值。
+
+```typescript
+getValueAsync: (recordId: string) => Promise<number | null>
+setValueAsync: (recordId: string, val: number) => Promise<boolean>
+```
+
+**示例**
+
+```typescript
+const progressField = sheet.getField<ProgressField>('完成进度');
+if (progressField) {
+  const progress = await progressField.getValueAsync('rec123456');
+  console.log(`完成进度: ${progress !== null ? progress : 0}%`);
+
+  await progressField.setValueAsync('rec123456', 75);
+}
+```
+
+### getMin / setMin
+
+获取或设置进度最小值。
+
+```typescript
+getMin: () => number
+setMin: (val: number) => string
+```
+
+### getMax / setMax
+
+获取或设置进度最大值。
+
+```typescript
+getMax: () => number
+setMax: (val: number) => string
+```
+
+### getFormatter / setFormatter
+
+获取或设置进度字段的格式。
+
+```typescript
+getFormatter: () => ProgressFormatter
+setFormatter: (val: ProgressFormatter) => string
+```
+
+## See Also
+
+- [Field 模块](./Field%20模块.md)
+- [NumberField 数字字段](./NumberField%20数字字段.md)
+- [RatingField 评分字段](./RatingField%20评分字段.md)
+
+## Sources
+
+- [ProgressField 进度字段](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)