From 3f4f44b7f296c816c5b9a1b499b99873c2e4c38c Mon Sep 17 00:00:00 2001 From: HynLcc Date: Wed, 12 Aug 2026 23:21:45 +0800 Subject: [PATCH] docs: raise automation trigger interval floors and correct audit log retention - scheduled and email triggers now accept a minimum 10-minute interval - drop the outdated one-month audit log retention claim and fix its paging description - explain when user field notifications are sent - document the automation interval env vars and the current cold archive switch Co-Authored-By: Claude Opus 5 --- en/basic/admin-panel/audit-log.mdx | 5 ++--- .../automation/trigger/email/email-received-overview.mdx | 2 +- en/basic/automation/trigger/external/scheduled-time.mdx | 2 +- en/basic/field/user.mdx | 2 ++ en/deploy/env.mdx | 6 ++++-- zh/basic/admin-panel/audit-log.mdx | 5 ++--- .../automation/trigger/email/email-received-overview.mdx | 4 ++-- zh/basic/automation/trigger/external/scheduled-time.mdx | 6 +++--- zh/basic/field/user.mdx | 2 ++ zh/deploy/env.mdx | 6 ++++-- 10 files changed, 23 insertions(+), 17 deletions(-) diff --git a/en/basic/admin-panel/audit-log.mdx b/en/basic/admin-panel/audit-log.mdx index b3062248..b64a0dba 100644 --- a/en/basic/admin-panel/audit-log.mdx +++ b/en/basic/admin-panel/audit-log.mdx @@ -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 @@ -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. diff --git a/en/basic/automation/trigger/email/email-received-overview.mdx b/en/basic/automation/trigger/email/email-received-overview.mdx index b6c359ef..87a0ce49 100644 --- a/en/basic/automation/trigger/email/email-received-overview.mdx +++ b/en/basic/automation/trigger/email/email-received-overview.mdx @@ -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 diff --git a/en/basic/automation/trigger/external/scheduled-time.mdx b/en/basic/automation/trigger/external/scheduled-time.mdx index 410d8bea..e8df1646 100644 --- a/en/basic/automation/trigger/external/scheduled-time.mdx +++ b/en/basic/automation/trigger/external/scheduled-time.mdx @@ -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 | diff --git a/en/basic/field/user.mdx b/en/basic/field/user.mdx index 44dbb8f1..6e25c038 100644 --- a/en/basic/field/user.mdx +++ b/en/basic/field/user.mdx @@ -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. diff --git a/en/deploy/env.mdx b/en/deploy/env.mdx index 2a3e8151..2808a5a1 100644 --- a/en/deploy/env.mdx +++ b/en/deploy/env.mdx @@ -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 | @@ -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 | @@ -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 | diff --git a/zh/basic/admin-panel/audit-log.mdx b/zh/basic/admin-panel/audit-log.mdx index 6fe68c96..4500fd66 100644 --- a/zh/basic/admin-panel/audit-log.mdx +++ b/zh/basic/admin-panel/audit-log.mdx @@ -7,7 +7,7 @@ description: "在管理员后台查看实例范围内的活动记录，筛选操 路径：管理面板 → 审计日志 -**审计日志** 用于查看实例范围内的近期活动记录，帮助管理员回溯谁在什么时间做了什么操作。日志仅保留一个月。 +**审计日志** 用于查看实例范围内的活动记录，帮助管理员回溯谁在什么时间做了什么操作。 ## 可查看的操作 @@ -28,9 +28,8 @@ description: "在管理员后台查看实例范围内的活动记录，筛选操 ## 浏览大量日志 -分组后的审计日志每页显示 50 条记录。使用列表底部的 **上一页** 和 **下一页** 切换分组结果。打开分组记录后，可以查看该操作内的事件明细；明细视图在页数较多时仍支持输入页码并点击 **跳转**。 +分组后的审计日志每页显示 50 条记录。分组列表和打开分组后的事件明细都使用列表底部的 **上一页** 和 **下一页** 翻页。 ## 注意事项 - 只有实例管理员可以访问管理面板。 -- 审计日志用于近期操作回溯，仅保留一个月。 diff --git a/zh/basic/automation/trigger/email/email-received-overview.mdx b/zh/basic/automation/trigger/email/email-received-overview.mdx index d3710e87..5e4c1a9c 100644 --- a/zh/basic/automation/trigger/email/email-received-overview.mdx +++ b/zh/basic/automation/trigger/email/email-received-overview.mdx @@ -23,7 +23,7 @@ AI 会为你处理一切：选择合适的触发器，映射相关字段，自 | 设置 | 必填 | 说明 | |---|---|---| | 连接类型 | 是 | 选择 IMAP、Gmail 或 Outlook | -| 轮询间隔 | 是 | 系统检查新邮件的频率，范围 1–60 分钟，默认 10 分钟 | +| 轮询间隔 | 是 | 系统检查新邮件的频率，范围 10–60 分钟，默认 10 分钟 | ## 连接类型详解 @@ -90,7 +90,7 @@ AI 会为你处理一切：选择合适的触发器，映射相关字段，自 | IMAP 连接失败 | 检查服务器地址和端口是否正确；确认邮箱已开启 IMAP 服务；部分邮箱（如 QQ、163）需使用授权码而非登录密码 | | Gmail 授权失败 | 确认 Google 账户允许第三方应用访问；如果使用 Google Workspace，管理员可能需要先在管理控制台中批准 | | 邮件没有被触发 | 确认邮件是"未读"状态；检查轮询间隔设置；确认监控的文件夹或标签正确 | -| 触发延迟 | 触发时间取决于轮询间隔。如果设置为 10 分钟，最长可能延迟 10 分钟。需要更快响应的场景建议缩短间隔 | +| 触发延迟 | 触发时间取决于轮询间隔。如果设置为 10 分钟，最长可能延迟 10 分钟 | | 附件无法读取 | 确认附件大小在系统支持范围内；部分加密或特殊格式的附件可能无法正常解析 | ## 注意事项 diff --git a/zh/basic/automation/trigger/external/scheduled-time.mdx b/zh/basic/automation/trigger/external/scheduled-time.mdx index 21258863..a1e4478c 100644 --- a/zh/basic/automation/trigger/external/scheduled-time.mdx +++ b/zh/basic/automation/trigger/external/scheduled-time.mdx @@ -31,7 +31,7 @@ AI 会为你处理一切：选择合适的触发器，映射相关字段，自 | 频率 | 间隔范围 | 附加设置 | |---|---|---| -| 分钟 | 每 1–60 分钟 | — | +| 分钟 | 每 10–60 分钟 | — | | 小时 | 每 1–24 小时 | — | | 天 | 每 1–31 天 | 具体触发时间（时:分） | | 周 | 每 1–52 周 | 星期几（可多选）+ 触发时间 | @@ -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 日执行一次性数据迁移 | 一次性 | 指定日期和时间 | ## 触发后可用的数据 @@ -81,7 +81,7 @@ AI 会为你处理一切：选择合适的触发器，映射相关字段，自 - 一次性触发器在执行完成后会**自动停用**工作流，无需手动关闭。 - 时区设置非常重要。如果团队成员分布在不同时区，请确认你选择的时区与预期的触发时间一致。 -- 频率设置过高（如每 1 分钟）会消耗大量运行次数，请根据实际业务需要合理设置。 +- 触发越频繁，消耗的运行次数越多，请根据实际业务需要设置间隔。 - 如果工作流在某个触发时刻正处于上一次运行中，系统会跳过本次触发。 - 建议在首次启用前使用测试功能验证工作流逻辑是否正确。 diff --git a/zh/basic/field/user.mdx b/zh/basic/field/user.mdx index d47f6177..9499adb5 100644 --- a/zh/basic/field/user.mdx +++ b/zh/basic/field/user.mdx @@ -47,3 +47,5 @@ description: "用于在记录中选择空间成员，常用于负责人、参与 ## 注意事项 - 如果开启 **允许多选**，一条记录在分组或看板视图中可能出现在多个成员分组下。比如任务同时分给 A 和 B，A 的列和 B 的列都会显示这条任务。 +- **用户被选择后发送通知** 只针对新的指派：有人编辑记录时选中成员，或表单提交时填入成员。导入数据、复制表格或记录、从回收站恢复记录、撤销重做这些只是把已有指派带过去的操作，不会发送通知。 +- 同一个人在同一张表内几秒钟之内指派了多条记录时，成员只会收到一条合并后的通知，而不是每条记录一条。 diff --git a/zh/deploy/env.mdx b/zh/deploy/env.mdx index f2298fd9..4d8b9c69 100644 --- a/zh/deploy/env.mdx +++ b/zh/deploy/env.mdx @@ -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 | @@ -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 | @@ -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 |