Documentation Index
Fetch the complete documentation index at: https://help.teable.ai/llms.txt
Use this file to discover all available pages before exploring further.
云端版本所有方案可用；私有部署版本需要商业版及以上方案。
概览
应用构建器（App Builder）遵循 “Prompt to App”（提示词即应用）的工作流。您描述想要的内容，AI 为您构建应用结构、页面和逻辑。然后，您可以使用可视化编辑器或代码微调每一个细节。应用构建器与 AI 对话 的区别：应用构建器用于创建自定义界面和独立应用。如果在数据库内部进行交互式数据分析和临时提问，请使用 AI 对话。
创建应用
主要有两种创建应用的方式：- 从数据库创建：在数据库中，点击 ”+ 创建” 选择 “新应用” 生成一个链接到当前数据的应用。
- 从对话创建：打开 AI Chat 并说 “为这个客户表创建一个 CRM 应用”。
应用编辑器界面
应用构建器为非技术用户和开发者提供了双重界面。1. 对话界面 (AI 驱动)
这是您的应用控制中心。- 自然语言编辑：描述您想做的更改，如 “把标题改成蓝色” 或 “添加一个新记录提交表单”。
- 智能路由：AI 能够理解您指的是哪个组件或页面，并直接对其进行修改。
- 清除对话历史：如果当前对话已经跑偏，可点击面板右下角的 清除对话，重新开始一个新的会话。这样会丢失当前对话的历史上下文，但不会删除应用本身。首次使用会弹出确认，并可选择下次不再提示。
2. 实时预览面板
- 多设备模拟：使用顶部的切换器在 桌面、平板 和 移动 视图之间切换。
- 即时反馈：您的修改会立即渲染并显示。
3. 开发者模式 (代码编辑器)
为了实现无限的定制能力，我们提供了直接访问代码的权限。- Monaco Editor：浏览器中类似 VS Code 的编码体验。
- React 组件：直接编辑底层 React 代码、Tailwind CSS 类和逻辑。
- 文件树：完整浏览项目文件结构。
下载代码
您可以随时将整个应用下载为 ZIP 压缩包：- 切换到编辑器中的 Code 标签页。
- 点击标签栏中的
...菜单。 - 选择 下载代码，包含所有源文件的 ZIP 压缩包将保存到您的电脑。
.env 文件。分享 ZIP 前请先检查其中内容。
导入代码
您可以通过导入 ZIP 来更新应用代码：- 切换到编辑器中的 Code 标签页。
- 点击标签栏中的
...菜单。 - 选择 导入代码 ，导入 ZIP（≤ 5MB）来更新代码。
- 仅需包含源代码文件，请勿包含
node_modules、.next等构建产物。 - 请压缩最外层项目文件夹本身（右键文件夹 → 压缩），而非进入文件夹内部选中文件再压缩。
- 导入会合并并覆盖同名文件。
- ZIP 中的根目录
.env会被读取为应用的自定义环境变量。其他.env*变体（如.env.local）会被忽略。
发布与管理
发布您的应用
当应用准备就绪时，点击右上角的 发布 按钮（箭头图标）。- 公开链接：Teable 会为您的应用生成一个安全的、可公开访问的 URL。
- 自定义域名：支持绑定您自己的域名。
自定义域名
在 自定义域名 中可以为已发布应用绑定访问域名。建议使用子域名，例如app.yourdomain.com。输入域名后，Teable 会显示需要添加的 DNS 记录；在域名服务商处添加记录，等待生效后回到 Teable 完成验证。
也可以使用 teable.app 下可用的子域名，例如 your-name.teable.app。
应用登录
在应用顶部点击 添加登录，可以要求访问者登录后再使用应用。配置后，该按钮会变为 登录设置。 启用登录时：- 选择登录用户的存储位置。可以创建 用户 表，也可以复用已有的、包含邮箱字段的表。每位登录用户会作为一条记录保存，同一用户表可被多个应用复用。
- 至少选择一种登录方式，例如 邮箱验证码、Google 或 Teable。可选方式取决于实例的认证配置。
- 设置访问控制：所有人可注册、允许的邮箱域名 或 仅邀请用户。
版本历史与回滚
Teable 自动跟踪每一次部署。- 点击 历史 按钮（时钟图标）查看所有已部署的版本列表。
- 一键回滚：如果新的更新出现问题，您可以即时将线上应用恢复到任何之前的稳定版本。
自动修复 (Auto-fix)
如果您的自定义代码导致构建错误，部署将会失败。- Teable 在错误日志旁提供了一个 Auto-fix (自动修复) 按钮。
- 点击它，AI 将分析编译错误并自动修补代码以解决问题。
删除应用
要删除应用，请点击顶部的 设置 (齿轮图标) 按钮，然后选择 删除。最佳实践
应用构建器的构建技巧、提示词写法、版本回退建议和常见问题，请参考 应用构建器最佳实践。私有化部署配置
如果您使用私有化部署的 Teable，请直接参考 AI 配置 页面完成配置。 应用构建器依赖的 AI 聊天运行环境、Vercel 部署配置、公网访问测试 以及相关排查说明，均以该页面为准。发布前，请先确认 Teable 和对象存储（MinIO / S3）都能被公网访问；不确定时，可以在 AI 配置 页面使用 测试公网访问 进行验证。
常见问题
清除对话历史会删除应用吗？
清除对话历史会删除应用吗？
不会。清除对话只会清除当前应用对话的历史上下文，不会删除应用本身。如果对话已经跑偏，可以用它重新开始。
如何下载或导入应用代码？
如何下载或导入应用代码？
切换到编辑器中的 Code 标签页，点击标签栏中的
... 菜单，然后选择 下载代码 或 导入代码。导入 ZIP 时，请只包含源代码文件，不要包含 node_modules、.next 等构建产物。登录配置什么时候会对线上应用生效？
登录配置什么时候会对线上应用生效？
登录配置会在预览重新加载后生效。要让线上应用使用新的登录配置，需要重新发布应用。
如何回滚应用到之前的版本？
如何回滚应用到之前的版本？
点击 历史 按钮（时钟图标）查看已部署版本，并将线上应用恢复到之前的稳定版本。
为什么提示 Agent 正在其他对话中执行？
为什么提示 Agent 正在其他对话中执行？
每个用户最多可同时运行 3 个 Agent，包括 AI 对话和应用构建器。如果应用构建器提示 Agent 正在其他对话中执行，说明已有任务正在运行，请等待上一个任务完成后再继续。
应用构建器运行失败时如何返还算力？
应用构建器运行失败时如何返还算力？
一次应用构建器运行可能包含多个处理步骤，对话里和账单里都会汇总展示同一轮运行的算力消耗。已经完成并保存的工作可以继续使用；如果最后一步意外中断，会自动返还中断那一步消耗的算力。你可以继续在同一个应用对话里推进后续工作。