aitable-workflow-cli 0.1.13-beta.1

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/topics/AI/350/241/250/346/240/274 AI /345/255/227/346/256/265/345/274/200/345/217/221/346/214/207/345/215/227/357/274/210FaaS/347/211/210/357/274/211.md"

@@ -0,0 +1,215 @@
+---
+title: AI表格 AI 字段开发指南（FaaS版）
+category: topic
+sources: [18-开发者指南/AI表格 AI 字段 开发指南/AI表格 AI 字段开发指南（FaaS版）.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [AI字段, FaaS, 开发指南, Node.js, 插件开发]
+aliases: [FaaS AI字段, AI字段FaaS版]
+confidence: high
+summary: FaaS 类型 AI 字段的完整开发指南，涵盖项目初始化、UI 配置组件（formItems）、执行函数（execute）、返回类型（resultType）、授权机制及国际化等核心开发流程。
+---
+
+> FaaS 类型的 AI 字段支持通过代码调用三方 API，灵活实现自定义业务功能。开发者可以利用 Node.js 运行时编写插件逻辑，将垂直场景能力融入 AI 表格构建的业务系统。
+
+## 概述
+
+AI 字段 FaaS 版是 AI 表格字段级开放能力，本质是一个 Node.js 函数。执行时会将当前行的指定字段数据作为输入，开发者执行自定义业务逻辑后返回对应的单元格值，由 AI 表格服务写入并渲染。每条记录的函数执行相互独立，仅支持获取当前行信息。
+
+如果希望快速上手，可以基于 [demo](https://github.com/dingdocs-notable/field-decorator-demo) + [skills](https://github.com/dingdocs-notable/ai-table-plugin-generator) 让 AI 快速开发。
+
+## 开发与调试
+
+### 初始化项目
+
+克隆 FaaS AI 字段代码：
+
+```bash
+git clone https://github.com/dingdocs-notable/field-decorator-demo
+```
+
+项目目录结构：
+
+```
+field-decorator-demo
+├── package.json
+├── config.json        // 本地调试授权配置
+├── src
+│   └── index.ts       // 项目入口文件
+└── tsconfig.json
+```
+
+在 `index.ts` 中实现 FaaS AI 字段的 UI 配置和逻辑。
+
+### 启动本地服务
+
+```bash
+cd field-demo
+npm install
+npm run start
+```
+
+如果 npm 安装较慢，可切换淘宝源：`npm config set registry https://registry.npmmirror.com/`
+
+### 使用 AI 字段开发助手调试
+
+打开任意钉钉 AI 表格，点击「插件」展示插件面板，选择「AI 字段开发助手」。
+
+![AI 字段开发助手入口](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eYVOL5jz3Q6yzlpz/img/60771575-7d84-4572-821f-a84238f3a812.png)
+
+选中 FaaS 调试，在本地服务已启动的情况下点击「添加字段」，即可出现 AI 字段配置面板。
+
+![FaaS 调试面板](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eYVOL5jz3Q6yzlpz/img/74994e2a-5d80-49f8-a4ee-e573bff2f4a6.png)
+
+![配置面板](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eYVOL5jz3Q6yzlpz/img/624c047c-96e0-439f-b075-0babfb0eb84a.png)
+
+通过「AI 字段开发助手」创建的字段仅支持在当前视图第一行触发，需保持「AI 字段调试助手」和「本地服务」处于运行状态。
+
+如遇 Chrome 阻止 HTTPS 访问 HTTP 的问题，可关闭 `chrome://flags/#local-network-access-check`（设为 disable 后重启浏览器），或使用以下命令启动 Chrome：
+
+- Mac: `open -na "Google Chrome" --args --user-data-dir="/tmp/chrome_dev_test" --disable-web-security --disable-site-isolation-trials --disable-features=BlockInsecurePrivateNetworkRequests`
+- Windows: `chrome.exe --disable-features=BlockInsecurePrivateNetworkRequests --disable-web-security --user-data-dir=C:\temp\chrome-dev`
+
+### 模拟 FaaS 请求
+
+![模拟请求](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eYVOL5jz3Q6yzlpz/img/43f11bfb-1870-4d68-9ece-1f3042daa885.png)
+
+在下拉框中选择需要调试的 FaaS 字段并点击「调试」，调试插件会模拟 FaaS 行为，将 `execute` 函数执行结果写入 AI 表格。目前仅支持在当前视图第一行触发，且不支持自动更新。
+
+### 发布 AI 字段
+
+填写[钉钉 AI 表格 AI 字段上架申请表单](https://alidocs.dingtalk.com/notable/share/form/v014j6OJ5jxepK0Eq3p_hERWDMS_Wqw4Upz)，提交后会有专员拉群沟通。
+
+## AI 字段结构
+
+AI 字段由 `formItems`、`execute` 和 `resultType` 三个核心属性组成：
+
+| 属性 | 说明 |
+| --- | --- |
+| `formItems` | 描述 AI 字段的 UI 表单，运行时表单数据作为 `execute` 的入参 |
+| `resultType` | 声明 AI 字段的返回值类型 |
+| `execute` | AI 字段的实际运行函数 |
+
+## formItems 配置项 UI
+
+### 基础配置
+
+- **key**: 配置项唯一 ID，在 execute 中通过 `formData[key]` 获取值
+- **label**: 配置项名称，支持国际化
+- **component**: 组件类型，支持 Textarea、SingleSelect、MultiSelect、Radio、FieldSelect
+- **validator**: 配置是否必选
+- **tooltips**: 配置项提示，支持国际化和链接
+
+### Textarea 组件
+
+多行文本输入组件，`props` 支持 `placeholder`（提示文字）和 `enableFieldReference`（是否支持引用字段）。execute 入参类型为 `string`。
+
+![Textarea 组件](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eYVOL5jz3Q6yzlpz/img/6fc35bdb-ff84-4971-83f8-871882367ecb.png)
+
+### SingleSelect 组件
+
+下拉单选组件，`props` 支持 `placeholder`、`options`（选项数组，含 key/title）、`defaultValue`。execute 入参为所选配置项的 `key`（string）。
+
+![SingleSelect 组件](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eYVOL5jz3Q6yzlpz/img/923926b3-9e4e-4c8a-b675-07458faf23f5.png)
+
+### MultiSelect 组件
+
+下拉多选组件，`props` 支持 `placeholder`、`options`、`defaultValue`（string 数组）。execute 入参为所选配置项的 `key` 数组（`Array<string>`）。
+
+![MultiSelect 组件](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eYVOL5jz3Q6yzlpz/img/63f59202-d598-4c12-939d-2d1aed839528.png)
+
+### Radio 组件
+
+单选框组件，`props` 支持 `options`（含 value/label）和 `defaultValue`。execute 入参为所选配置项的 `value`（string）。
+
+![Radio 组件](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eYVOL5jz3Q6yzlpz/img/7de8343a-80ba-4115-a0a8-0a20a5c0f670.png)
+
+### FieldSelect 组件
+
+字段选择组件，`props` 支持 `mode`（single/multiple）和 `supportTypes`。支持的字段类型包括：Text、Number、SingleSelect、MultiSelect、Link、Attachment。
+
+![FieldSelect 组件](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/eYVOL5jz3Q6yzlpz/img/af17717b-c624-4852-9ed4-05489bd16e0b.png)
+
+不同字段类型传递给 execute 的值类型：
+
+| 字段类型 | execute 入参类型 |
+| --- | --- |
+| Text | `string` |
+| Number | `number` |
+| SingleSelect | `string` |
+| MultiSelect | `string[]` |
+| Link | `{ url: string, text: string }` |
+| Attachment | `Array<{ name, type, size, tmp_url }>` |
+
+## resultType 返回类型
+
+`resultType` 中声明的类型需要和 `execute` 函数返回的类型一致，否则校验不通过，数据不会写入 AI 表格。
+
+| 返回类型 | execute 返回值 | 说明 |
+| --- | --- | --- |
+| Text | `string` | 文本数据 |
+| Number | `number` | 数字数据 |
+| SingleSelect | `string` | 需配置 `extra.options` |
+| MultiSelect | `Array<string>` | 需配置 `extra.options` |
+| Link | `{ text, link }` | 链接数据 |
+| Attachment | `[{ fileName, type, url }]` | 附件，URL 需公开可访问 |
+| Object | `object` | 需配置 `extra.properties`，必须有一个 `primary: true` 的属性 |
+
+## execute 执行函数
+
+### 入参
+
+- **context**: 运行时上下文，包含 `fetch`（HTTP 请求 API）、`baseId`、`sheetId`、`extensionId`、`tenantId`、`logId`
+- **formData**: 用户在 UI 组件上配置的参数对象
+
+### 返回值
+
+| 属性 | 说明 |
+| --- | --- |
+| `code` | 执行结果码（Success / Error / RateLimit / QuotaExhausted / ConfigError / InvalidArgument / AuthorizationError） |
+| `data` | 返回数据，需与 `resultType` 一致 |
+| `errorMessage` | 自定义错误信息（仅 Error 时生效），需在 `errorMessages` 中定义 |
+| `extra` | 自定义错误上下文（如 traceid），便于排查问题 |
+
+### 域名白名单
+
+调用外部 API 时需先声明白名单，规则：只配置域名（含主机名），不带协议和路径，支持 IP 地址。
+
+```typescript
+fieldDecoratorKit.setDomainList(['example.com']);
+```
+
+### 运行环境
+
+| 参数 | 详情 |
+| --- | --- |
+| Node.js 版本 | 16.x |
+| 单实例规格 | 1 核 1G |
+| 超时时间 | 15 分钟 |
+| 服务隔离 | 按插件 + 组织维度 |
+| 并发限制 | 不超过 10n |
+
+不支持的三方库：axios、got、bcrypt、moment、jsdom、sharp、crypto（用 crypto-js 替代）。
+
+## 授权机制
+
+授权为可选项，取决于 AI 字段是否依赖三方平台凭证。支持两种 APIKey 授权模式：
+
+- **HeaderBearerToken**: 请求时自动在 header 中添加 `Authorization: Bearer APIKey`
+- **MultiHeaderToken**: 支持多个 key，分别添加到 header 中
+
+本地调试时在 `config.json` 中配置 mock 授权信息。
+
+## 国际化
+
+通过 `i18nMap` 定义语言资源映射，使用 `t(key)` 引用。支持 zh-CN、en-US、ja-JP 三种语言，不属于这三种时默认使用中文。
+
+## See Also
+
+- [AI表格 AI 字段开发指南（公式版）](../topics/AI表格%20AI%20字段开发指南（公式版）.md)
+- [AI表格 AI 字段 开发指南](../topics/AI表格%20AI%20字段%20开发指南.md)
+- [AI 表格 AI 字段常见报错说明](../references/AI%20表格%20AI%20字段常见报错说明.md)
+
+## Sources
+
+- [AI表格 AI 字段开发指南（FaaS版）](https://alidocs.dingtalk.com/notable/share/form/v014j6OJ5jxepK0Eq3p_hERWDMS_Wqw4Upz)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/topics/AI/350/241/250/346/240/274 AI /345/255/227/346/256/265/345/274/200/345/217/221/346/214/207/345/215/227/357/274/210/345/205/254/345/274/217/347/211/210/357/274/211.md"

@@ -0,0 +1,131 @@
+---
+title: AI表格 AI 字段开发指南（公式版）
+category: topic
+sources: [18-开发者指南/AI表格 AI 字段 开发指南/AI表格 AI 字段开发指南（公式版）.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [AI字段, 公式, 开发指南, 模板引擎, Nunjucks]
+aliases: [公式AI字段, AI字段公式版]
+confidence: high
+summary: 公式类型 AI 字段的开发指南，介绍如何通过公式模板和配置项组件封装高频业务场景，涵盖模板语法、UI 组件、国际化以及调试发布流程。
+---
+
+> 公式类型的 AI 字段借助灵活的公式能力，封装高频业务场景，用户通过内置配置即可快速使用，无需从头编写公式。
+
+## 核心组成
+
+公式 AI 字段由两部分组成：
+
+1. **公式模板（formulaTemplate）**: 包含变量的公式模板，根据用户配置替换为实际公式值
+2. **配置项组件（uiSchema）**: 定义用户配置字段时的 UI 组件，用于配置字段选择、下拉选项、开关等
+
+## 开发步骤
+
+### 实现公式模板
+
+将公式中需要动态选择的字段替换为变量格式 `[{$ field.name $}]`，公式中的引号 `""` 和斜杠 `\` 需要添加 `\` 进行转义。
+
+```json
+{
+  "formulaTemplate": "IF(AND([{$ field2.name $}]=\"\", [{$ field1.name $}]=\"\"), \"\", ...)"
+}
+```
+
+### 配置 UI 组件
+
+通过 `uiSchema` 定义配置面板，使用 `FieldMetaEditor` 组件包含多个配置项：
+
+```json
+{
+  "uiSchema": {
+    "fieldMetaEditor": {
+      "component": "FieldMetaEditor",
+      "props": {
+        "schema": {
+          "items": [
+            {
+              "key": "field1",
+              "label": "选择预计完成日期（必填）",
+              "component": "FieldSelect",
+              "props": { "mode": "single", "supportTypes": ["date"] },
+              "validator": { "required": true }
+            }
+          ]
+        }
+      }
+    }
+  }
+}
+```
+
+### 配置字段类型
+
+设置 `fieldType` 为 `formula`：
+
+```json
+{ "fieldType": "formula" }
+```
+
+## 调试流程
+
+1. 打开任意钉钉 AI 表格，点击「插件」→「AI 字段开发助手」
+
+![AI 字段开发助手](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/1GXn45Kaz8RroqDQ/img/5d600b81-9a8e-4962-822c-6fca3ec58791.png)
+
+2. 在右侧面板粘贴 JSON 配置文件，或选择内置模板快速体验
+
+![配置 JSON](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/1GXn45Kaz8RroqDQ/img/09405623-c76d-4b41-bb10-3a07ce2526b4.png)
+
+3. 点击「添加字段」创建并预览效果
+
+![生成字段](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/1GXn45Kaz8RroqDQ/img/914f334a-4c06-4519-ad43-0d7c37a3a4bc.png)
+
+## UI 组件类型
+
+| 组件 | 说明 | 出参类型 |
+| --- | --- | --- |
+| Textarea | 多行文本输入 | `string`，`{$ field1 $}` 替换为输入值 |
+| SingleSelect | 下拉单选 | `string`，替换为所选项的 `key` |
+| MultiSelect | 下拉多选 | `Array<string>`，替换为多选值 |
+| FieldSelect | 字段选择 | `{ id, name }`，通过 `{$ field1.name $}` 获取字段名 |
+| Radio | 单选框 | `boolean`，`{$ field1 $}` 替换为布尔值 |
+
+## 输入字段类型
+
+通过 `supportTypes` 限制可选字段类型：
+
+| 类型值 | 说明 |
+| --- | --- |
+| text | 文本类型 |
+| number | 数字类型 |
+| select | 单选类型 |
+| multiSelect | 多选类型 |
+| link | 链接类型 |
+
+## 模板语法
+
+模板引擎使用 [Nunjucks](https://mozilla.github.io/nunjucks/cn/templating.html)，常见用法：
+
+- **引用变量**: `{$ field1.name $}`（两侧预留空格）
+- **获取表名**: `{$ __context__.table.name $}`
+- **条件语法**: `{% if variable === 1 %}...{% endif %}`
+- **逻辑运算**: `and`、`or`、`not`
+- **算术运算**: `{$ 1 + 2 $}`
+- **比较**: `==`、`!=`、`>`、`>=`、`<`、`<=`
+
+## 国际化
+
+通过 `i18nMap` 定义语言资源，使用 `${{key}}` 引用。支持 zh-CN、en-US、ja-JP，默认使用中文。
+
+## 发布
+
+在表单中提交 AI 字段插件，钉钉侧审核通过后发布给所有用户使用。
+
+## See Also
+
+- [AI表格 AI 字段开发指南（FaaS版）](../topics/AI表格%20AI%20字段开发指南（FaaS版）.md)
+- [AI表格 AI 字段 开发指南](../topics/AI表格%20AI%20字段%20开发指南.md)
+
+## Sources
+
+- AI表格 AI 字段开发指南（公式版）

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/topics/AI/350/241/250/346/240/274/346/217/222/344/273/266/344/270/255/345/277/203-/344/275/277/347/224/250/346/214/207/345/215/227.md

@@ -0,0 +1,106 @@
+---
+title: AI表格插件中心-使用指南
+category: topic
+sources: [13-插件中心/AI表格插件中心-使用指南.md]
+original_sources: [https://wolai.dingtalk.com/iGKHtcPQt9aeJz8gAJZEB4]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [插件中心, 插件, 使用指南, 批量操作]
+aliases: [插件中心, 插件使用指南]
+confidence: high
+summary: AI表格插件中心提供丰富的插件生态，包括批量操作（删除重复、批量上传等）、便捷预览（图库预览、Markdown预览等）和AI插件等类别，支持搜索、使用、分享和固定常用插件。
+---
+
+> AI表格插件中心是一个灵活便捷的插件市场，提供丰富的插件满足长尾需求，同时开放能力允许有编程能力的用户自行开发脚本插件和自定义插件。
+
+## 精选插件
+
+### 批量操作
+
+| 插件名 | 功能介绍 |
+| --- | --- |
+| 删除重复记录 | 选择字段作为查找范围，查找并批量删除重复记录，支持跨表查找 |
+| 批量上传附件 | 批量上传附件，支持新增记录上传、匹配文件名上传、从指定行号批量上传 |
+| 查找替换 | 根据自定义条件批量查找和替换数据 |
+| 变更追踪器 | 追踪数据表记录变更，生成审计日志 |
+| 批量更新 | 批量更新字段记录值，支持文本、数字、日期、单选、多选等多种类型 |
+| 批量修改字段类型 | 选择字段批量完成字段类型智能转换 |
+| 网页采集助手 | 一键从任意网页中采集内容并导入AI表格 |
+
+### 便捷预览
+
+| 插件名 | 功能介绍 |
+| --- | --- |
+| 图库预览 | 点击单元格即可在侧边栏中查看详细图片和信息 |
+| Markdown 预览 | 查看 Markdown 内容单元格的格式化结果 |
+| 网页预览 | 点击网页链接单元格直接预览对应网页内容 |
+| HTML 预览 | 点击 HTML 内容单元格直接预览网页内容 |
+
+### AI 插件
+
+| 插件名 | 功能介绍 |
+| --- | --- |
+| 百炼智能体工作台 | 连接企业级 AI 智能体，获取任务自动化、数据分析和决策支持能力 |
+| 视频转图片 | 从视频文件中提取关键帧并保存为图片附件 |
+
+## 使用插件
+
+打开AI表格，点击右上角的**插件**图标，右侧边栏展示精选推荐插件，也可点击**插件中心**搜索更多插件。
+
+![](https://img.alicdn.com/imgextra/i1/O1CN01wMUmhO1waRsH8M3xA_!!6000000006324-2-tps-2940-1598.png)
+
+### 操作步骤
+
+1. 点击右上角**插件**按钮 > 插件列表，点击**插件中心**
+2. 输入搜索关键字找到匹配需求的插件
+
+![](https://img.alicdn.com/imgextra/i1/O1CN01wAZBlS24mpVXoWaSt_!!6000000007434-2-tps-2924-1592.png)
+
+3. 鼠标悬停查看插件详细介绍，或点击**使用**打开插件配置面板
+
+### 分享插件
+
+进入插件介绍页面，点击**分享**即可复制链接。被分享用户通过浏览器打开链接，点击**去钉钉多维表体验**即可试用。
+
+![](https://img.alicdn.com/imgextra/i3/O1CN01V4Hp1W21QRIVEbtYm_!!6000000006979-2-tps-2590-1408.png)
+
+![](https://img.alicdn.com/imgextra/i2/O1CN01MmxP4c27mJujEBMVc_!!6000000007839-2-tps-2042-1486.png)
+
+### 固定常用插件
+
+鼠标悬停在插件上点击固定按钮，即可将常用插件钉住在右侧边栏方便快速使用。
+
+![](https://img.alicdn.com/imgextra/i3/O1CN01GR2m93294TE4NyleQ_!!6000000008014-2-tps-782-1504.png)
+
+### 移除插件
+
+在已使用列表中，点击插件右侧 **更多 > 从列表中移除**，再次使用时需重新开启。
+
+![](https://img.alicdn.com/imgextra/i4/O1CN011PkJjC1XjH74Q7amw_!!6000000002959-2-tps-910-1024.png)
+
+## 插件使用权限
+
+- 未开启高级权限时：拥有可编辑或可管理权限的用户可以使用
+- 开启高级权限时：仅拥有数据表可管理权限的用户可以使用
+
+## FAQ
+
+**问：如何定义自己的插件？**
+
+答：可以查看 [AI表格插件-自定义插件](../concepts/AI表格插件-自定义插件.md)。
+
+**问：什么是脚本插件？**
+
+答：可以查看 [AI表格插件-脚本插件](../concepts/AI表格插件-脚本插件.md)。
+
+## See Also
+
+- [AI表格插件-自定义插件](../concepts/AI表格插件-自定义插件.md)
+- [AI表格插件-脚本插件](../concepts/AI表格插件-脚本插件.md)
+- [AI表格三方插件使用授权](../concepts/AI表格三方插件使用授权.md)
+- [[AI 表格插件 - 企业内插件发布指南|AI表格插件 - 企业内插件发布指南]] ([AI表格插件 - 企业内插件发布指南](../topics/AI 表格插件 - 企业内插件发布指南.md))
+- [[在表格中标记重复内容|在表格中标记重复内容]] ([在表格中标记重复内容](../topics/在表格中标记重复内容.md))
+
+## Sources
+
+- [AI表格插件中心-使用指南](https://wolai.dingtalk.com/iGKHtcPQt9aeJz8gAJZEB4)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/topics/AI/350/241/250/346/240/274/346/225/260/346/215/256/346/272/220 /345/274/200/345/217/221/346/214/207/345/215/227.md"

@@ -0,0 +1,162 @@
+---
+title: AI 表格数据源开发指南
+category: topic
+sources: [18-开发者指南/AI表格数据源 开发指南.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [数据源, 数据同步, 插件开发, 数据连接, MySQL, 三方插件]
+aliases: [数据源插件开发, 数据连接器开发]
+confidence: high
+summary: AI 表格数据源同步插件的完整开发指南，涵盖数据同步概念、前端配置页面开发、服务端接口（表结构/行记录）开发、请求签名验证、插件调试与发布流程。
+---
+
+> 数据源同步是钉钉 AI 表格的数据集成能力，能将分散在不同系统和平台的数据自动汇聚到 AI 表格中。开发者可以构建自定义数据源同步插件，将任意外部数据接入 AI 表格生态。
+
+## 数据源同步概述
+
+### 核心价值
+
+- **数据集中化管理**：整合多系统数据，避免数据孤岛
+- **自动化数据流转**：支持定时或实时同步，减少人工操作
+- **跨系统数据协作**：打通不同业务系统的数据壁垒
+
+### 已支持的数据源
+
+- 钉钉生态：AI 表格、钉钉表格、OA 审批、考勤打卡、通讯录等
+- 数据库：MySQL、PostgreSQL、SQLServer 等
+- 电商平台：淘宝生意参谋、拼多多商家后台、得物、阿里妈妈等
+- 企业应用：聚水潭 ERP、Teambition 等
+
+## 数据同步使用流程
+
+以 MySQL 插件为例：
+
+1. **入口**：AI 表格左下角「添加/导入」→「从其他数据源同步」
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/2M9qP5jzYp9RDO01/img/924493f8-5edc-473f-815b-dabe23e040ae.png)
+
+2. **选择数据源**：在数据连接中心选择目标数据源
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/jP2lRYj3jM0kZO8g/img/1070d32c-4fd9-48a8-ac31-e527288f5d58.png)
+
+3. **配置连接**：登录数据库、选择数据表和导出字段
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/2M9qP5jzYp9RDO01/img/317cd69a-80ac-416b-b317-00acbc3ecb9b.png)
+
+4. **同步设置**：配置同步字段和定时同步
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/2M9qP5jzYp9RDO01/img/d098c9cd-9497-4dd9-8265-0e18eb7672b7.png)
+
+5. **保存并同步**：完成配置后生成同步表
+
+## 插件开发要素
+
+每个数据源插件需具备以下信息：
+
+| 信息 | 必须 | 说明 |
+|------|------|------|
+| 前端配置页面 | 是 | 用户配置数据源信息的界面 |
+| 页面宽高 | 否 | 容器尺寸，默认 300×450 |
+| 三方服务端地址 | 是 | 接收 AI 表格请求的服务地址 |
+| 表结构同步接口 | 是 | `/api/sheet_meta`，返回字段配置 |
+| 行记录同步接口 | 是 | `/api/records`，返回数据记录 |
+| 请求签名 | 否 | 确保接口调用来源安全 |
+
+## 前端配置页面开发
+
+### 快速开始
+
+使用官方模板：[datasource-plugin-demo](https://github.com/dingdocs-notable/datasource-plugin-demo)
+
+```bash
+git clone https://github.com/dingdocs-notable/datasource-plugin-demo
+cd datasource-plugin-demo && npm install && npm start
+```
+
+非脚手架项目需初始化 iframe 环境：
+
+```javascript
+import { initView } from 'dingtalk-docs-cool-app';
+initView({ onReady: () => {}, onError: e => console.log(e) });
+```
+
+### 关键 API
+
+- `saveConfigAndGoNext(config)` — 保存配置并进入字段配置步骤
+- `Dingdocs.base.host.getAuthCode(corpId)` — 获取免登码
+- URL 中 `$CORPID$` 占位符会被替换为当前组织 CorpId
+
+前端页面需部署到 **HTTPS** 公网地址。
+
+## 服务端接口开发
+
+### 表结构接口 `/api/sheet_meta`
+
+- 方法：`POST`，超时 10s
+- 请求体包含：`requestId`、`params`（前端配置的 JSON 字符串）、`context`（unionId, corpId）
+- 返回体需包含 `sheetName` 和 `fields` 数组，每个字段有 `id`、`name`、`type`、`isPrimary`、`property`
+
+### 行记录接口 `/api/records`
+
+- 方法：`POST`，超时 20s
+- 支持分页：`maxResults`（默认 300）、`nextToken`
+- 返回体包含 `records` 数组、`hasMore`、`nextToken`、`total`
+
+### 请求签名验证
+
+通过 Header 中的 `Ding-Docs-Timestamp` 和 `Ding-Docs-Signature` 验证请求来源：
+
+```java
+String content = body + timestamp;
+byte[] hash = sha256_HMAC.doFinal(content.getBytes(StandardCharsets.UTF_8));
+String signatureExpected = Base64.getEncoder().encodeToString(hash);
+return signature.equals(signatureExpected);
+```
+
+服务端 Demo：[datasource-plugin-node-demo](https://github.com/dingdocs-notable/datasource-plugin-node-demo)
+
+## 插件调试
+
+1. 通过 AI 表格的「自定义插件测试」入口
+2. 填写前端页面地址和服务端地址
+3. 完成数据源配置和同步测试
+
+![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/2M9qP5jzYp9RDO01/img/e0533809-4577-4eaa-b137-171092f8da83.png)
+
+## 插件发布
+
+### 企业内插件
+
+仅当前企业可见，无需平台审核，通过钉钉开发者平台创建企业内部应用 → 添加酷应用 → 配置「扩展到 AI 表格」→ 发布版本。
+
+### 三方企业插件
+
+面向多企业开放，需入驻钉钉服务商、注册三方应用、发布酷应用并通过审核。
+
+## FAQ
+
+**Q：前端页面无法加载**
+A：检查 URL 是否为 HTTPS 协议，以及代码中是否执行了 `initView` 方法。
+
+**Q：企业内插件获取授权码失败**
+A：参见《AI 表格插件 - 企业内插件发布指南》。
+
+## 字段类型枚举
+
+| 字段 | type | 属性示例 |
+|------|------|---------|
+| 文本 | `text` | 无 |
+| 数字 | `number` | `formatter: "INT" \| "FLOAT_1" \| "THOUSAND" ...` |
+| 单选 | `singleSelect` | `choices: [{name: "选项名"}]` |
+| 多选 | `multipleSelect` | 同单选 |
+| 日期 | `date` | `formatter: "YYYY-MM-DD" \| "YYYY-MM-DD HH:mm" ...` |
+| 链接 | `url` | 无 |
+
+## See Also
+
+- [AI表格脚本插件 开发指南](../topics/AI表格脚本插件%20开发指南.md)
+- [字段数据结构](../references/字段数据结构.md)
+
+## Sources
+
+- [AI表格数据源 开发指南](https://open.dingtalk.com/document/orgapp/obtain-the-userid-of-a-user-by-using-the-log-free)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/topics/AI/350/241/250/346/240/274/347/232/204/345/257/274/345/207/272.md

@@ -0,0 +1,35 @@
+---
+title: AI表格的导出
+category: topic
+sources: [02-基础操作/AI表格的导出.md]
+original_sources: [https://wolai.dingtalk.com/f5Pg1satbD9Akjbj6kfj6n]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [导出, Excel, 数据备份]
+aliases: [导出表格, 导出Excel]
+confidence: high
+summary: AI表格支持导出为 Excel 文件（.xlsx）和附件压缩包，导出权限与表格权限保持一致，开启高级权限后导出范围为可见数据。
+---
+
+> AI表格支持将数据导出为 Excel 文件以便保存到本地，这是数据备份和与外部系统交换数据的便捷方式。
+
+## 导出为Excel文件
+
+点击右上角菜单图标，在弹出菜单中选择 **导出为Excel (.xlsx)** 或 **导出附件为压缩包**。
+
+![](https://img.alicdn.com/imgextra/i2/O1CN01HswHzY21RoUANxd8d_!!6000000006982-2-tps-1012-440.png)
+
+## 常见问题
+
+**Q：哪些人有权限可导出AI表格？**
+
+A：导出权限与表格权限保持一致，拥有可管理、可编辑、可查看/下载权限的人均可导出。开启高级权限后也可以导出，但导出范围为高级权限下可见范围的数据。
+
+## See Also
+
+- [将Excel文件导入AI表格](../topics/将Excel文件导入AI表格.md)
+- [查看历史记录](../topics/查看历史记录.md)
+
+## Sources
+
+- [AI表格的导出](https://wolai.dingtalk.com/f5Pg1satbD9Akjbj6kfj6n)