Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@

# Local agent handoff and screenshot scratch output.
/HANDOFF.md
/eval/
/images/_scratch/
/images/_tmp/
/images/_preview/
8 changes: 8 additions & 0 deletions en/basic/admin-panel/ai-setting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -104,8 +104,16 @@ If you also need a custom domain, or if your server cannot access the Vercel API
| Optional item | When you need it |
|------|------|
| **Custom domain** | When you want to publish apps under your own domain |
| **App Auth** | When generated apps need **Email OTP** or **Google** sign-in |
| **Vercel API proxy URL** | When your server cannot reach the Vercel API directly, or when you use a proxy or gateway |

In **App Auth**, you can configure sign-in providers for generated apps:

- **Email OTP** uses an independent SMTP mailbox for app login verification emails.
- **Google OAuth** requires a Client ID and Client Secret. Add the redirect URI shown on this page to the authorized redirect URI list in Google Cloud Console.

**Teable** sign-in is available by default. **Email OTP** appears in App Builder only after the SMTP settings are complete, and **Google** appears only after both OAuth credentials are configured.

<Tip>
Click **Test Public Access** in the page and confirm that both your **Teable instance** and **object storage (MinIO / S3)** are publicly accessible.
</Tip>
Expand Down
2 changes: 2 additions & 0 deletions en/basic/ai/ai-chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,8 @@ AI prioritizes information from the current page:

Files can also be pasted or dropped directly into the input box. They appear as attachment chips first, then become available to AI after the message is sent.

When you paste a long block of plain text, Teable converts it to a Markdown attachment so the message input stays easy to read. You can preview text and Markdown attachments from their attachment chips.

## Common Uses

<CardGroup cols={2}>
Expand Down
12 changes: 12 additions & 0 deletions en/basic/ai/app-builder.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,18 @@ Use **Custom domain** to bind a domain to the published app. A subdomain is reco

You can also use an available subdomain under `teable.app`, such as `your-name.teable.app`.

### App Login

Click **Add login** in the app header to require visitors to sign in before they can use the app. Once login is configured, the button changes to **Login settings**.

When you enable login:

1. Choose where to store app users. You can create a **Users** table or reuse an existing table with an email field. Each signed-in user is stored as one record, and the same user table can be reused by multiple apps.
2. Choose at least one sign-in method, such as **Email OTP**, **Google**, or **Teable**. Available methods depend on your instance's authentication settings.
3. Choose an access policy: **Anyone can sign up**, **Allowed email domains**, or **Invite only**.

Login changes appear in the preview after it reloads. Publish the app again to apply those changes to the live app.

### Version History & Rollback
Teable automatically tracks every deployment.
- Click the **History** (clock icon) button to view a list of all deployed versions.
Expand Down
7 changes: 7 additions & 0 deletions en/basic/automation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,13 @@ Changes are saved as a draft. The live workflow keeps running on the previous ve

Open a workflow → **Execution History**. Each run shows status, time spent, and per-step input/output. Click a run to inspect every step.

Use the history filters to narrow the list by status, duration, or date range. Failed runs can be rerun from the run detail panel:

- **Full rerun** runs every step again and may create duplicate records, emails, or notifications.
- **Resume from failed step** is available when Teable can safely continue from the failed step.

Rerun attempts are marked as retries and link back to the original run.

## Limits

| Item | Limit |
Expand Down
5 changes: 4 additions & 1 deletion en/basic/view/grid.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,10 @@ Changing row height does not affect field header height, which cannot be adjuste

If you want to ensure your preferred row height configuration isn't accidentally changed, you can lock the view (coming soon), which will prevent all collaborators from changing the view's configuration until someone with creator permissions unlocks it.

### Selection Statistics

When you select cells in grid view, Teable shows **Average**, **Count**, and **Sum** for the selected numeric cells.

### Hiding Fields in Grid View

To hide fields in grid view (or show hidden fields), click the "Hide Fields" button in the view bar to open the hide fields dialog. If there are no hidden fields in the current view, the "Hide Fields" button will appear as an eye icon with a line through it and display "Hide Fields."
Expand Down Expand Up @@ -76,4 +80,3 @@ Shorter row heights allow you to see more records at once, while larger row heig
To expand a single row at a time, you can press the spacebar when any cell in the selected row is focused.

You can also view the full content of the current cell by clicking on it, then use arrow keys to quickly move between different cells.

1 change: 1 addition & 0 deletions en/deploy/env.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,7 @@ Also ensure the public bucket is configured with **public-read + CORS**. See: [O
| MAX_COPY_CELLS | Maximum number of cells to copy in a single request | - | - | 50000 |
| MAX_READ_ROWS | Maximum number of rows to read in a single request | - | - | 10000 |
| MAX_ATTACHMENT_UPLOAD_SIZE | Maximum attachment upload size (bytes) | - | - | 2147483648 |
| MAX_SPACE_OWNER_COUNT | Maximum number of spaces a user can own | 10 | - | 10 |
| Feature Toggles |
| RECORD_HISTORY_DISABLED | Whether to disable record history, defaults to false | false | - | true |
| PASSWORD_LOGIN_DISABLED | Whether to disable password login (OAuth and OIDC still available) | false | - | true |
Expand Down
8 changes: 8 additions & 0 deletions zh/basic/admin-panel/ai-setting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -103,8 +103,16 @@ Vercel 相关费用主要分成两部分:
| 可选项 | 什么时候需要 |
|------|------|
| **自定义域名** | 需要把应用发布到自己的域名下 |
| **应用登录** | 生成的应用需要支持 **邮箱验证码** 或 **Google** 登录时 |
| **Vercel API 代理地址** | 服务器不能直接访问 Vercel API,或需要通过代理、网关访问 |

在 **应用登录** 中,可以为生成的应用配置登录提供方:

- **邮箱验证码** 使用独立 SMTP 邮箱发送应用登录验证码。
- **Google 登录** 需要填写客户端 ID 和客户端密钥,并将页面中显示的回调地址添加到 Google Cloud Console 的已授权重定向 URI。

**Teable 登录** 默认可用。只有完整配置 SMTP 后,**邮箱验证码** 才会出现在应用构建器的登录设置中;只有同时配置 Google 客户端 ID 和密钥后,**Google** 登录才会出现。

<Tip>
点击页面中的 **测试公网访问**,确认 **Teable 实例** 和 **对象存储(MinIO / S3)** 都已经可以从公网访问。
</Tip>
Expand Down
2 changes: 2 additions & 0 deletions zh/basic/ai/ai-chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,8 @@ AI 会优先参考你当前页面中的信息:

你也可以直接把文件粘贴或拖拽到输入框中。文件会先显示为附件标签,发送后再交给 AI 参考。

较长的纯文本粘贴会转成 Markdown 附件,避免输入框被大段文本占满。文本和 Markdown 附件可从附件标签中打开预览。

## 常见用法

<CardGroup cols={2}>
Expand Down
12 changes: 12 additions & 0 deletions zh/basic/ai/app-builder.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,18 @@ Teable 应用构建器 (App Builder) 允许您在不编写代码的情况下,

也可以使用 `teable.app` 下可用的子域名,例如 `your-name.teable.app`。

### 应用登录

在应用顶部点击 **添加登录**,可以要求访问者登录后再使用应用。配置后,该按钮会变为 **登录设置**。

启用登录时:

1. 选择登录用户的存储位置。可以创建 **用户** 表,也可以复用已有的、包含邮箱字段的表。每位登录用户会作为一条记录保存,同一用户表可被多个应用复用。
2. 至少选择一种登录方式,例如 **邮箱验证码**、**Google** 或 **Teable**。可选方式取决于实例的认证配置。
3. 设置访问控制:**所有人可注册**、**允许的邮箱域名** 或 **仅邀请用户**。

登录配置会在预览重新加载后生效。要让线上应用使用新的登录配置,需要重新发布应用。

### 版本历史与回滚

Teable 自动跟踪每一次部署。
Expand Down
7 changes: 7 additions & 0 deletions zh/basic/automation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,13 @@ AI 会为你创建并测试完整自动化,包括触发器、操作和字段

打开工作流 → **执行历史**。每次运行显示状态、耗时和逐步输入/输出。点击可查看详情。

可使用历史筛选按状态、运行耗时或时间范围缩小结果。失败的运行可以在运行详情中重跑:

- **完整重跑** 会重新执行全部步骤,可能产生重复记录、邮件或通知。
- 当 Teable 可以安全地从失败节点继续时,可选择 **从失败步骤恢复**。

重跑产生的运行会标记为重试,并可跳转查看原始运行。

## 限制

| 项目 | 限制 |
Expand Down
4 changes: 4 additions & 0 deletions zh/basic/view/grid.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,10 @@ description: "表格视图是 Teable 中的一种数据展示方式,它以表
- 将鼠标移动到列分割线上(通常在第一列右侧有一条较粗的分隔线),按住并拖动该分割线,即可将左侧的所有列冻结
- 右键点击表头,在菜单中选择"冻结至此字段",即可将该字段及其左侧的所有列冻结

### 3. 选区统计

选区时,Teable 会显示数值的 **平均值**、**计数** 和 **总和**。

## 三、 交互

### 1. 单元格操作
Expand Down
1 change: 1 addition & 0 deletions zh/deploy/env.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,7 @@ mode: "wide"
| MAX_COPY_CELLS | 单次请求最大复制单元格数 | - | - | 50000 |
| MAX_READ_ROWS | 单次请求最大读取行数 | - | - | 10000 |
| MAX_ATTACHMENT_UPLOAD_SIZE | 附件上传最大大小(字节) | - | - | 2147483648 |
| MAX_SPACE_OWNER_COUNT | 单个用户可作为所有者拥有或管理的最大空间数量 | 10 | - | 10 |
| 功能开关 |
| RECORD_HISTORY_DISABLED | 是否禁用记录历史,默认为 false | false | - | true |
| PASSWORD_LOGIN_DISABLED | 是否禁用密码登录(OAuth 和 OIDC 仍然可用),默认为 false | false | - | true |
Expand Down