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
5 changes: 2 additions & 3 deletions en/basic/admin-panel/audit-log.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: "Review instance-wide activity, filter operation history, and inspe

Path: Admin Panel → Audit log

**Audit log** lets administrators review recent activity across the instance and trace who performed an operation, when it happened, and what area it affected. Logs are retained for one month.
**Audit log** lets administrators review activity across the instance and trace who performed an operation, when it happened, and what area it affected.

## What You Can Review

Expand All @@ -28,9 +28,8 @@ If a user, base, or space has been deleted, the entry remains in the log and the

## Browse Large Log Lists

The grouped audit log shows 50 entries per page. Use **Previous** and **Next** at the bottom of the list to move through grouped results. Open a grouped entry to view the events inside that operation; this detail view still supports page numbers and **Go** when there are many pages.
The grouped audit log shows 50 entries per page. Use **Previous** and **Next** at the bottom of the list to move through results, both in the grouped list and after you open a grouped entry to view the events inside that operation.

## Notes

- Only instance administrators can access the Admin Panel.
- The audit log is intended for recent operational review and is retained for one month.
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Describe the goal once, and the workflow is ready — no manual setup needed.
| Setting | Required | Description |
|---|---|---|
| Connection Type | Yes | IMAP, Gmail, or Outlook |
| Poll Interval | Yes | How often to check for new emails: 1 to 60 minutes (default 10) |
| Poll Interval | Yes | How often to check for new emails: 10 to 60 minutes (default 10) |

## Connection types in detail

Expand Down
2 changes: 1 addition & 1 deletion en/basic/automation/trigger/external/scheduled-time.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Describe the goal once, and the workflow is ready — no manual setup needed.

| Frequency | Interval | Extra Settings |
|---|---|---|
| Minutes | Every 1–60 min | — |
| Minutes | Every 10–60 min | — |
| Hours | Every 1–24 h | — |
| Days | Every 1–31 days | Trigger time (hour + minute) |
| Weeks | Every 1–52 weeks | Weekdays (Mon–Sun) + trigger time |
Expand Down
2 changes: 2 additions & 0 deletions en/basic/field/user.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -47,3 +47,5 @@ A **User** field selects space members in a record. It works well for task assig
## Notes

- If **Allow multiple users** is enabled, one record may appear under multiple member groups in grouped or Kanban views. For example, if a task is assigned to A and B, it appears in both A's column and B's column.
- **Notify users when selected** covers new assignments only: someone selecting a member while editing records, or a form submission that fills the field. Operations that carry existing assignments along, such as importing data, duplicating a table or record, restoring records from the trash, and undo or redo, send no notifications.
- When one person assigns members across several records in the same table within a few seconds, each member receives one combined notification instead of one per record.
6 changes: 4 additions & 2 deletions en/deploy/env.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ mode: "wide"
| BACKEND_STORAGE_PROVIDER | Storage provider, options: local, minio, s3, aliyun | local | - | s3 |
| BACKEND_STORAGE_LOCAL_PATH | Local storage path | .assets/uploads | - | .assets/uploads |
| BACKEND_STORAGE_PUBLIC_BUCKET | Public bucket name | public | - | teable-public |
| BACKEND_STORAGE_PRIVATE_BUCKET | Private bucket name for attachments, app files, record-history cold parts, and other protected content | private | - | teable-private |
| BACKEND_STORAGE_PRIVATE_BUCKET | Private bucket name for attachments, app files, archived data, and other protected content | private | - | teable-private |
| BACKEND_STORAGE_PUBLIC_URL | Public URL override for public bucket (optional) | - | - | https://cdn.example.com |
| BACKEND_STORAGE_PRIVATE_BUCKET_ENDPOINT | Private bucket endpoint override (optional) | - | - | https://private-bucket.endpoint |
| BACKEND_STORAGE_S3_REGION | S3 storage region, required when BACKEND_STORAGE_PROVIDER is s3 | - | - | us-east-2 |
Expand Down Expand Up @@ -107,6 +107,8 @@ mode: "wide"
| TABLE_LIMIT_VIEW_OPTIONS_MAX_BYTES | Maximum serialized view option bytes | 262144 | - | 262144 |
| TABLE_LIMIT_NAME_MAX_LENGTH | Maximum display name length for supported table objects | 100 | - | 100 |
| TABLE_LIMIT_DESCRIPTION_MAX_LENGTH | Maximum description length for supported table objects | 2000 | - | 2000 |
| AUTOMATION_MIN_SCHEDULED_MINUTES_INTERVAL | Shortest interval (minutes) a scheduled trigger may use with the Minutes frequency. Set above 60 to disable minute-level schedules | 10 | - | 15 |
| AUTOMATION_MIN_EMAIL_POLL_INTERVAL_MINUTES | Shortest mailbox poll interval (minutes) an email trigger may use | 10 | - | 15 |
| **AI & App Builder (runtime plane connection)** | | | | |
| SANDBOX_PROVIDER | Sandbox provider for AI sessions; `opensandbox` connects to a self-hosted runtime plane | - | - | opensandbox |
| TEABLE_INFRA_API_URL | Runtime plane entry URL — must be the public entry (it routes `/v1` to the sandbox engine), not an internal service address | - | - | https://infra.teable.example.com |
Expand All @@ -122,7 +124,7 @@ mode: "wide"
| SANDBOX_DISK | Ephemeral disk (GiB) per sandbox (admin panel settings take precedence) | 15 | - | 15 |
| **Feature Toggles** | | | | |
| RECORD_HISTORY_DISABLED | Whether to disable record history, defaults to false | false | - | true |
| BACKEND_RECORD_HISTORY_COLD_DISABLED | Whether to stop scheduled record-history cold-storage migration, compaction, and buffer deletion. Reads still include migrated history | false | - | true |
| BACKEND_STORAGE_COLD_ARCHIVE_DISABLED | Whether to stop scheduled archiving of historical data. Already-archived data stays readable | false | - | true |
| PASSWORD_LOGIN_DISABLED | Whether to disable password login (OAuth and OIDC still available) | false | - | true |
| **Analytics & Monitoring** | | | | |
| MICROSOFT_CLARITY_ID | Microsoft Clarity metrics ID, for enabling Microsoft Clarity analytics | - | - | your-metrics-id |
Expand Down
5 changes: 2 additions & 3 deletions zh/basic/admin-panel/audit-log.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: "在管理员后台查看实例范围内的活动记录,筛选操

路径:管理面板 → 审计日志

**审计日志** 用于查看实例范围内的近期活动记录,帮助管理员回溯谁在什么时间做了什么操作。日志仅保留一个月
**审计日志** 用于查看实例范围内的活动记录,帮助管理员回溯谁在什么时间做了什么操作。

## 可查看的操作

Expand All @@ -28,9 +28,8 @@ description: "在管理员后台查看实例范围内的活动记录,筛选操

## 浏览大量日志

分组后的审计日志每页显示 50 条记录。使用列表底部的 **上一页** 和 **下一页** 切换分组结果。打开分组记录后,可以查看该操作内的事件明细;明细视图在页数较多时仍支持输入页码并点击 **跳转**
分组后的审计日志每页显示 50 条记录。分组列表和打开分组后的事件明细都使用列表底部的 **上一页** 和 **下一页** 翻页

## 注意事项

- 只有实例管理员可以访问管理面板。
- 审计日志用于近期操作回溯,仅保留一个月。
4 changes: 2 additions & 2 deletions zh/basic/automation/trigger/email/email-received-overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ AI 会为你处理一切:选择合适的触发器,映射相关字段,自
| 设置 | 必填 | 说明 |
|---|---|---|
| 连接类型 | 是 | 选择 IMAP、Gmail 或 Outlook |
| 轮询间隔 | 是 | 系统检查新邮件的频率,范围 1–60 分钟,默认 10 分钟 |
| 轮询间隔 | 是 | 系统检查新邮件的频率,范围 10–60 分钟,默认 10 分钟 |

## 连接类型详解

Expand Down Expand Up @@ -90,7 +90,7 @@ AI 会为你处理一切:选择合适的触发器,映射相关字段,自
| IMAP 连接失败 | 检查服务器地址和端口是否正确;确认邮箱已开启 IMAP 服务;部分邮箱(如 QQ、163)需使用授权码而非登录密码 |
| Gmail 授权失败 | 确认 Google 账户允许第三方应用访问;如果使用 Google Workspace,管理员可能需要先在管理控制台中批准 |
| 邮件没有被触发 | 确认邮件是"未读"状态;检查轮询间隔设置;确认监控的文件夹或标签正确 |
| 触发延迟 | 触发时间取决于轮询间隔。如果设置为 10 分钟,最长可能延迟 10 分钟。需要更快响应的场景建议缩短间隔 |
| 触发延迟 | 触发时间取决于轮询间隔。如果设置为 10 分钟,最长可能延迟 10 分钟 |
| 附件无法读取 | 确认附件大小在系统支持范围内;部分加密或特殊格式的附件可能无法正常解析 |

## 注意事项
Expand Down
6 changes: 3 additions & 3 deletions zh/basic/automation/trigger/external/scheduled-time.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ AI 会为你处理一切:选择合适的触发器,映射相关字段,自

| 频率 | 间隔范围 | 附加设置 |
|---|---|---|
| 分钟 | 每 1–60 分钟 | — |
| 分钟 | 每 10–60 分钟 | — |
| 小时 | 每 1–24 小时 | — |
| 天 | 每 1–31 天 | 具体触发时间(时:分) |
| 周 | 每 1–52 周 | 星期几(可多选)+ 触发时间 |
Expand Down Expand Up @@ -60,7 +60,7 @@ AI 会为你处理一切:选择合适的触发器,映射相关字段,自
| 工作日每天下午 5 点检查逾期任务 | 周 / 每 1 周 | 周一至周五,触发时间 17:00 |
| 每月 1 号和 15 号发送账单提醒 | 月 / 每 1 个月 | 日期 1 和 15,触发时间 10:00 |
| 每月最后一天生成月度报告 | 月 / 每 1 个月 | 日期 -1,触发时间 18:00 |
| 每 5 分钟检查外部数据源 | 分钟 / 每 5 分钟 | — |
| 每 15 分钟检查外部数据源 | 分钟 / 每 15 分钟 | — |
| 2025 年 3 月 1 日执行一次性数据迁移 | 一次性 | 指定日期和时间 |

## 触发后可用的数据
Expand All @@ -81,7 +81,7 @@ AI 会为你处理一切:选择合适的触发器,映射相关字段,自

- 一次性触发器在执行完成后会**自动停用**工作流,无需手动关闭。
- 时区设置非常重要。如果团队成员分布在不同时区,请确认你选择的时区与预期的触发时间一致。
- 频率设置过高(如每 1 分钟)会消耗大量运行次数,请根据实际业务需要合理设置
- 触发越频繁,消耗的运行次数越多,请根据实际业务需要设置间隔
- 如果工作流在某个触发时刻正处于上一次运行中,系统会跳过本次触发。
- 建议在首次启用前使用测试功能验证工作流逻辑是否正确。

Expand Down
2 changes: 2 additions & 0 deletions zh/basic/field/user.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -47,3 +47,5 @@ description: "用于在记录中选择空间成员,常用于负责人、参与
## 注意事项

- 如果开启 **允许多选**,一条记录在分组或看板视图中可能出现在多个成员分组下。比如任务同时分给 A 和 B,A 的列和 B 的列都会显示这条任务。
- **用户被选择后发送通知** 只针对新的指派:有人编辑记录时选中成员,或表单提交时填入成员。导入数据、复制表格或记录、从回收站恢复记录、撤销重做这些只是把已有指派带过去的操作,不会发送通知。
- 同一个人在同一张表内几秒钟之内指派了多条记录时,成员只会收到一条合并后的通知,而不是每条记录一条。
6 changes: 4 additions & 2 deletions zh/deploy/env.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ mode: "wide"
| BACKEND_STORAGE_PROVIDER | 存储提供商,可选值:local、minio、s3、aliyun | local | - | s3 |
| BACKEND_STORAGE_LOCAL_PATH | 本地存储路径 | .assets/uploads | - | .assets/uploads |
| BACKEND_STORAGE_PUBLIC_BUCKET | public bucket 名称 | public | - | teable-public |
| BACKEND_STORAGE_PRIVATE_BUCKET | private bucket 名称,用于附件、应用文件、记录历史冷存储分片等需要保护的内容 | private | - | teable-private |
| BACKEND_STORAGE_PRIVATE_BUCKET | private bucket 名称,用于附件、应用文件、归档数据等需要保护的内容 | private | - | teable-private |
| BACKEND_STORAGE_PUBLIC_URL | public bucket 的公共访问 URL 覆盖(可选) | - | - | https://cdn.example.com |
| BACKEND_STORAGE_PRIVATE_BUCKET_ENDPOINT | private bucket 的 endpoint 覆盖(可选) | - | - | https://private-bucket.endpoint |
| BACKEND_STORAGE_S3_REGION | S3 云存储区域,当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置 | - | - | us-east-2 |
Expand Down Expand Up @@ -107,6 +107,8 @@ mode: "wide"
| TABLE_LIMIT_VIEW_OPTIONS_MAX_BYTES | 视图配置序列化后的最大字节数 | 262144 | - | 262144 |
| TABLE_LIMIT_NAME_MAX_LENGTH | 支持的表对象显示名称最大长度 | 100 | - | 100 |
| TABLE_LIMIT_DESCRIPTION_MAX_LENGTH | 支持的表对象描述最大长度 | 2000 | - | 2000 |
| AUTOMATION_MIN_SCHEDULED_MINUTES_INTERVAL | 定时触发器按分钟触发时允许的最短间隔(分钟)。设置为大于 60 可关闭分钟级定时 | 10 | - | 15 |
| AUTOMATION_MIN_EMAIL_POLL_INTERVAL_MINUTES | 邮件触发器检查邮箱的最短轮询间隔(分钟) | 10 | - | 15 |
| **AI 与 App Builder(运行平面接入)** | | | | |
| SANDBOX_PROVIDER | AI 会话的沙箱提供方;`opensandbox` 表示接入自部署运行平面 | - | - | opensandbox |
| TEABLE_INFRA_API_URL | 运行平面入口 URL —— 必须是公共入口(它负责把 `/v1` 分流给沙箱引擎),不能填内部服务地址 | - | - | https://infra.teable.example.com |
Expand All @@ -122,7 +124,7 @@ mode: "wide"
| SANDBOX_DISK | 每个沙箱的临时磁盘(GiB,管理面板中的设置优先) | 15 | - | 15 |
| **功能开关** | | | | |
| RECORD_HISTORY_DISABLED | 是否禁用记录历史,默认为 false | false | - | true |
| BACKEND_RECORD_HISTORY_COLD_DISABLED | 是否停止记录历史冷存储的定时迁移、合并和数据库缓冲区删除;读取仍会包含已迁移的历史 | false | - | true |
| BACKEND_STORAGE_COLD_ARCHIVE_DISABLED | 是否停止历史数据的定时归档;已归档的数据仍可正常读取 | false | - | true |
| PASSWORD_LOGIN_DISABLED | 是否禁用密码登录(OAuth 和 OIDC 仍然可用),默认为 false | false | - | true |
| **分析监控** | | | | |
| MICROSOFT_CLARITY_ID | Microsoft Clarity 指标 ID,用于启用 Microsoft Clarity 分析 | - | - | your-metrics-id |
Expand Down