From e13fa975f81df1cc977fd5f30c35bab41623335a Mon Sep 17 00:00:00 2001 From: HynLcc Date: Mon, 18 May 2026 20:08:07 +0800 Subject: [PATCH] docs: sync admin limits and AI chat updates --- en/basic/admin-panel/overview.mdx | 2 +- en/basic/admin-panel/settings.mdx | 9 +++++++++ en/basic/ai/ai-chat.mdx | 4 +++- en/basic/space/billing.mdx | 4 ++-- en/deploy/env.mdx | 26 ++++++++++++++++++++++++++ zh/basic/admin-panel/overview.mdx | 2 +- zh/basic/admin-panel/settings.mdx | 9 +++++++++ zh/basic/ai/ai-chat.mdx | 4 +++- zh/basic/space/billing.mdx | 4 ++-- zh/deploy/env.mdx | 26 ++++++++++++++++++++++++++ 10 files changed, 82 insertions(+), 8 deletions(-) diff --git a/en/basic/admin-panel/overview.mdx b/en/basic/admin-panel/overview.mdx index 5e15816..0a34b6b 100644 --- a/en/basic/admin-panel/overview.mdx +++ b/en/basic/admin-panel/overview.mdx @@ -20,7 +20,7 @@ After logging in as an administrator, click the "Admin Panel" button in the uppe - **[Spaces](/en/basic/admin-panel/spaces)** - Manage spaces and auto-join settings - **[Self-hosted license](/en/deploy/activate)** - Register, update, and view the current instance license - **[Template admin](/en/basic/admin-panel/template-admin)** - Configure template center and custom templates -- **[Instance settings](/en/basic/admin-panel/settings)** - Configure system-wide settings and permissions +- **[Instance settings](/en/basic/admin-panel/settings)** - Configure system-wide settings, permissions, email, and system limits - **[AI settings](/en/basic/admin-panel/ai-setting)** - Configure AI features and models - **[Automation management](/en/basic/admin-panel/automation-management)** - View automation run status and run history - **[Sandbox Agent](/en/basic/admin-panel/sandbox-agent)** - Configure Sandbox Agent runtime limits and base snapshots diff --git a/en/basic/admin-panel/settings.mdx b/en/basic/admin-panel/settings.mdx index 3030296..a332f11 100644 --- a/en/basic/admin-panel/settings.mdx +++ b/en/basic/admin-panel/settings.mdx @@ -17,6 +17,7 @@ This page mainly covers instance-level basics. The main settings are grouped as |------|------| | **General Settings** | Includes **Allow creating new accounts**, **Allow sending space invitations**, **Allow everyone to create new spaces**, and **Enable email verification** | | **Email** | Includes **Notification Email** and **Automation Email** for password reset, email verification, notification emails, and invitation emails | +| **System limits** | Shows the effective table data, field, view, and text limits for the instance | To enable system emails, complete the setup in **Email**. @@ -24,6 +25,14 @@ To enable system emails, complete the setup in **Email**. If email is not fully configured, the **Email** item in the **Pending configuration** panel will not turn green. +## System limits + +**System limits** shows the current instance-level limits for table data and related configuration. If you need to adjust a limit, use the environment variable shown on that page. + + +After changing an environment variable, restart the service for the new value to take effect. + + ## Pending configuration The **Pending configuration** panel on the right is a system checklist. It shows which important settings are still missing for the instance. diff --git a/en/basic/ai/ai-chat.mdx b/en/basic/ai/ai-chat.mdx index 4cc3a0d..655acc2 100644 --- a/en/basic/ai/ai-chat.mdx +++ b/en/basic/ai/ai-chat.mdx @@ -19,7 +19,7 @@ Open a table or view, then click the **Cuppy** icon in the top right corner to o AI prioritizes information from the current page: - **Current table and view**: The current table, current view, and the filtered or sorted results in that view. -- **Selected records**: If records are selected, AI uses them as key context. +- **Selected rows, columns, and cells**: If rows, columns, or a rectangular cell range are selected in Grid view, AI uses that selection as key context. - **Uploaded files**: Add PDFs, Excel files, Word documents, images, and other files to the conversation. - **More nodes with `@`**: Type `@` in the input box to add tables, views, apps, automations, or folders from the tree. @@ -91,6 +91,8 @@ Ask questions about data in the current table, for example: If the question involves multiple tables, use `@` to add the related tables or views to the conversation. +In Grid view, you can also select rows, columns, or a rectangular cell range, then use **Add to Chat** from the context menu. The selection appears as a chip in the input box, and clicking the chip highlights the related grid area again. + ### Generate Temporary Charts or Report Previews AI can generate one-time HTML previews from queried data, useful for checking charts or reports quickly: diff --git a/en/basic/space/billing.mdx b/en/basic/space/billing.mdx index 8006881..715d5af 100644 --- a/en/basic/space/billing.mdx +++ b/en/basic/space/billing.mdx @@ -202,7 +202,7 @@ After cancellation: **Credits were used on a failed action. Can I get them back?** - Credits are consumed when your prompt is processed, even if the result isn't what you expected. If the failure was caused by a system error on our end, we may restore credits after review. + Credits are consumed once your prompt is processed, even if the result is not what you expected. If the AI Agent is unexpectedly interrupted, Teable restores the credits used by the final failed step. If you believe the failure was caused by a Teable-side issue, contact support and we can review it. **I lost credits to repeated errors that didn't fix the problem.** @@ -210,7 +210,7 @@ After cancellation: **The AI made changes I didn't ask for and used my credits.** - If the AI agent made unwanted changes in App Builder, you can roll back to a previous version. Credits for processed prompts can't be automatically refunded, but if the behavior seems like a product bug, we can review it. + If the AI agent made unwanted changes in App Builder, you can roll back to a previous version. Credits for processed prompts are not automatically refunded unless the AI Agent was unexpectedly interrupted, but if the behavior seems like a product bug, we can review it. If you believe credits were unfairly consumed because of a Teable-side issue, submit a [Credit Issue Report](https://app.teable.ai/share/shrmBIyArdkWm999klP/view) with the related usage details. diff --git a/en/deploy/env.mdx b/en/deploy/env.mdx index bb69773..e8b1009 100644 --- a/en/deploy/env.mdx +++ b/en/deploy/env.mdx @@ -70,6 +70,7 @@ Also ensure the public bucket is configured with **public-read + CORS**. See: [O | **Session/JWT Configuration** | | | | | | BACKEND_SESSION_EXPIRES_IN | Session expiration time | 7d | - | 7d | | BACKEND_SESSION_COOKIE_SECURE | Whether to secure session cookie | false | - | true | +| BACKEND_SESSION_ORIGIN_CHECK_ENABLED | Enable Origin and Fetch Metadata checks for unsafe browser session-cookie API requests. Enable only when your reverse proxy or CDN preserves these headers | false | - | false | | BACKEND_JWT_EXPIRES_IN | JWT expiration time | 20d | - | 20d | | BACKEND_RESET_PASSWORD_EMAIL_EXPIRES_IN | Reset password email expiration time | 30m | - | 30m | | **Resource Limits** | | | | | @@ -77,6 +78,31 @@ Also ensure the public bucket is configured with **public-read + CORS**. See: [O | 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 | +| TASK_MAX_FIELDS_PER_BATCH | Maximum number of AI fields sent to the model in one batch request. Values are clamped from 1 to 20 | 5 | - | 5 | +| TASK_MAX_CONCURRENCY | Maximum pending AI field task runs dispatched in one scheduling cycle. Values are clamped from 1 to 20 | 5 | - | 5 | +| TABLE_LIMIT_FIELD_OPTIONS_MAX_BYTES | Maximum serialized field option bytes | 262144 | - | 262144 | +| TABLE_LIMIT_SELECT_CHOICES_MAX | Maximum select choices per select field | 1000 | - | 1000 | +| TABLE_LIMIT_SELECT_CHOICE_NAME_MAX_LENGTH | Maximum select choice name length | 1000 | - | 1000 | +| TABLE_LIMIT_SELECT_DEFAULT_VALUES_MAX | Maximum select default values | 100 | - | 100 | +| TABLE_LIMIT_CELL_VALUE_MAX_BYTES | Maximum cell value bytes | 262144 | - | 262144 | +| TABLE_LIMIT_RECORD_FIELDS_MAX_BYTES | Maximum serialized record fields bytes | 1048576 | - | 1048576 | +| TABLE_LIMIT_RECORDS_PER_MUTATION_MAX | Maximum records per mutation | 20000 | - | 20000 | +| TABLE_LIMIT_COMPUTED_CELL_VALUE_MAX_BYTES | Maximum computed cell value bytes | 262144 | - | 262144 | +| TABLE_LIMIT_FORMULA_MAX_LENGTH | Maximum formula length | 8192 | - | 8192 | +| TABLE_LIMIT_TABLES_PER_BASE_MAX | Maximum tables per base | 1000 | - | 1000 | +| TABLE_LIMIT_FIELDS_PER_TABLE_MAX | Maximum fields per table | 500 | - | 500 | +| TABLE_LIMIT_VIEWS_PER_TABLE_MAX | Maximum views per table | 100 | - | 100 | +| TABLE_LIMIT_CREATE_TABLE_FIELDS_MAX | Maximum fields accepted when creating a table | 1000 | - | 1000 | +| TABLE_LIMIT_CREATE_TABLE_VIEWS_MAX | Maximum views accepted when creating a table | 20 | - | 20 | +| TABLE_LIMIT_CREATE_TABLE_RECORDS_MAX | Maximum records accepted when creating a table | 20000 | - | 20000 | +| TABLE_LIMIT_RECORDS_PER_TABLE_MAX | Maximum rows per table. Empty means no instance-level row limit | - | - | 1000000 | +| TABLE_LIMIT_VIEW_FILTER_ITEMS_MAX | Maximum filter items in a view | 100 | - | 100 | +| TABLE_LIMIT_VIEW_FILTER_DEPTH_MAX | Maximum nested filter depth in a view | 5 | - | 5 | +| TABLE_LIMIT_VIEW_SORT_ITEMS_MAX | Maximum sort items in a view | 20 | - | 20 | +| TABLE_LIMIT_VIEW_GROUP_ITEMS_MAX | Maximum group items in a view | 3 | - | 3 | +| 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 | | **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 | diff --git a/zh/basic/admin-panel/overview.mdx b/zh/basic/admin-panel/overview.mdx index a585a59..ef4fbea 100644 --- a/zh/basic/admin-panel/overview.mdx +++ b/zh/basic/admin-panel/overview.mdx @@ -22,7 +22,7 @@ description: "Teable 私有化部署的管理员后台，用于管理实例的 - **[空间管理](/zh/basic/admin-panel/spaces)** - 管理空间和自动加入设置 - **[自托管许可证](/zh/deploy/activate)** - 注册、更新和查看当前实例许可证 - **[模板管理](/zh/basic/admin-panel/template-admin)** - 配置模板中心和自定义模板 -- **[实例设置](/zh/basic/admin-panel/settings)** - 配置系统级设置和权限 +- **[实例设置](/zh/basic/admin-panel/settings)** - 配置系统级设置、权限、邮箱和系统限制 - **[AI 配置](/zh/basic/admin-panel/ai-setting)** - 配置 AI 功能和模型 - **[自动化管理](/zh/basic/admin-panel/automation-management)** - 查看自动化运行状态和历史记录 - **[沙箱 Agent](/zh/basic/admin-panel/sandbox-agent)** - 配置沙箱 Agent 运行限制和基础快照 diff --git a/zh/basic/admin-panel/settings.mdx b/zh/basic/admin-panel/settings.mdx index 60479a9..dcc2f16 100644 --- a/zh/basic/admin-panel/settings.mdx +++ b/zh/basic/admin-panel/settings.mdx @@ -13,9 +13,18 @@ description: "管理实例级开关、邮件配置和系统待配置项。" |------|------| | **通用配置** | 包括 **允许新用户注册**、**允许发送空间邀请**、**允许所有人创建新的空间**、**启用邮箱验证** | | **邮箱** | 包括 **通知邮箱** 和 **自动化邮箱**，用于密码找回、邮箱验证、通知邮件和邀请邮件 | +| **系统限制** | 查看当前实例生效的表数据、字段、视图和文本限制 | 如果需要启用系统邮件，请在 **邮箱** 中完成配置。 +## 系统限制 + +**系统限制** 用于查看当前实例生效的数据与配置上限。如果需要调整某个限制，请以页面中显示的环境变量为准。 + + +修改环境变量后，需要重启服务才会生效。 + + ## 待配置项 右侧 **待配置项** 可以理解为一份系统检查清单。它不是普通说明卡片，而是在告诉你：当前实例还缺少哪些关键配置。 diff --git a/zh/basic/ai/ai-chat.mdx b/zh/basic/ai/ai-chat.mdx index 1f29d53..953b45a 100644 --- a/zh/basic/ai/ai-chat.mdx +++ b/zh/basic/ai/ai-chat.mdx @@ -19,7 +19,7 @@ AI 会优先参考当前页面。需要跨表格、视图、应用、自动化 AI 会优先参考你当前页面中的信息： - **当前表格和视图**：包括当前表格、当前视图，以及视图中的筛选和排序结果。 -- **选中的记录**：如果你选中了记录，AI 会把这些记录作为重点参考。 +- **选中的行、列和单元格区域**：如果你在网格视图中选中了行、列或矩形单元格区域，AI 会把这些选区作为重点参考。 - **上传的文件**：可以把 PDF、Excel、Word、图片等文件加入对话。 - **`@` 让 AI 参考更多节点**：在输入框中输入 `@`，可以把目录树里的表格、视图、应用、自动化或文件夹加入对话。 @@ -91,6 +91,8 @@ AI 不只回答问题，也可以协助创建、更新或整理数据。对于 如果问题涉及多个表格，建议用 `@` 把相关表格或视图加入对话。 +在网格视图中，你也可以选中行、列或矩形单元格区域，然后从右键菜单选择 **添加到 AI 对话**。选区会以标签形式进入输入框；点击标签时，会重新高亮对应的网格区域。 + ### 生成临时图表或报告预览 AI 可以根据已经查询到的数据生成一次性的 HTML 预览，适合临时查看图表或报告： diff --git a/zh/basic/space/billing.mdx b/zh/basic/space/billing.mdx index 36c2c21..03d0160 100644 --- a/zh/basic/space/billing.mdx +++ b/zh/basic/space/billing.mdx @@ -202,7 +202,7 @@ Teable 遵循"物有所值"的取消政策。当您取消订阅时，您并非 **一次失败的操作消耗了算力，可以恢复吗？** - 只要提示词被处理，就会消耗算力，即使结果并不是您预期的。如果失败是由 Teable 侧的系统问题导致，我们会在审核后酌情恢复算力。 + 只要提示词被处理，就会消耗算力，即使结果并不是您预期的。如果 AI Agent 被意外中断，Teable 会返还最后一步失败时消耗的算力。如果您认为失败是由 Teable 侧问题导致，我们可以进一步审核处理。 **我连续尝试修复问题，但一直失败并消耗了算力。** @@ -210,7 +210,7 @@ Teable 遵循"物有所值"的取消政策。当您取消订阅时，您并非 **AI 做了我没有要求的改动，并消耗了算力。** - 如果应用构建器做出了不需要的改动，您可以回退到之前的版本。已处理提示词的算力不会自动退回，但如果该行为看起来像产品 bug，我们可以进行审核。 + 如果应用构建器做出了不需要的改动，您可以回退到之前的版本。已处理提示词的算力不会自动退回，除非 AI Agent 被意外中断；如果该行为看起来像产品 bug，我们可以进行审核。 如果您认为算力是因为 Teable 侧问题被不公平消耗，请提交 [Credit Issue Report](https://app.teable.ai/share/shrmBIyArdkWm999klP/view)，并附上相关用量明细。 diff --git a/zh/deploy/env.mdx b/zh/deploy/env.mdx index d6ec530..81b981d 100644 --- a/zh/deploy/env.mdx +++ b/zh/deploy/env.mdx @@ -70,6 +70,7 @@ mode: "wide" | **会话/JWT 配置** | | | | | | BACKEND_SESSION_EXPIRES_IN | 会话过期时间 | 7d | - | 7d | | BACKEND_SESSION_COOKIE_SECURE | 是否启用会话 Cookie 安全保护，默认为 false | false | - | true | +| BACKEND_SESSION_ORIGIN_CHECK_ENABLED | 对使用浏览器会话 Cookie 的非安全 API 请求启用 Origin 与 Fetch Metadata 校验。仅在反向代理或 CDN 会保留这些请求头时启用 | false | - | false | | BACKEND_JWT_EXPIRES_IN | JWT 过期时间 | 20d | - | 20d | | BACKEND_RESET_PASSWORD_EMAIL_EXPIRES_IN | 重置密码邮件过期时间 | 30m | - | 30m | | **资源限制** | | | | | @@ -77,6 +78,31 @@ mode: "wide" | MAX_READ_ROWS | 单次请求最大读取行数 | - | - | 10000 | | MAX_ATTACHMENT_UPLOAD_SIZE | 附件上传最大大小（字节） | - | - | 2147483648 | | MAX_SPACE_OWNER_COUNT | 单个用户可作为所有者拥有或管理的最大空间数量 | 10 | - | 10 | +| TASK_MAX_FIELDS_PER_BATCH | 单次批量请求发送给模型的 AI 字段数量上限，取值会限制在 1 到 20 | 5 | - | 5 | +| TASK_MAX_CONCURRENCY | 每轮调度最多派发的待处理 AI 字段任务运行数，取值会限制在 1 到 20 | 5 | - | 5 | +| TABLE_LIMIT_FIELD_OPTIONS_MAX_BYTES | 字段选项序列化后的最大字节数 | 262144 | - | 262144 | +| TABLE_LIMIT_SELECT_CHOICES_MAX | 每个选择字段的最大选项数 | 1000 | - | 1000 | +| TABLE_LIMIT_SELECT_CHOICE_NAME_MAX_LENGTH | 选择项名称最大长度 | 1000 | - | 1000 | +| TABLE_LIMIT_SELECT_DEFAULT_VALUES_MAX | 选择字段默认值最大数量 | 100 | - | 100 | +| TABLE_LIMIT_CELL_VALUE_MAX_BYTES | 单元格值最大字节数 | 262144 | - | 262144 | +| TABLE_LIMIT_RECORD_FIELDS_MAX_BYTES | 记录字段数据序列化后的最大字节数 | 1048576 | - | 1048576 | +| TABLE_LIMIT_RECORDS_PER_MUTATION_MAX | 单次变更最大记录数 | 20000 | - | 20000 | +| TABLE_LIMIT_COMPUTED_CELL_VALUE_MAX_BYTES | 计算字段单元格值最大字节数 | 262144 | - | 262144 | +| TABLE_LIMIT_FORMULA_MAX_LENGTH | 公式最大长度 | 8192 | - | 8192 | +| TABLE_LIMIT_TABLES_PER_BASE_MAX | 每个数据库（Base）最大表数量 | 1000 | - | 1000 | +| TABLE_LIMIT_FIELDS_PER_TABLE_MAX | 每张表最大字段数 | 500 | - | 500 | +| TABLE_LIMIT_VIEWS_PER_TABLE_MAX | 每张表最大视图数 | 100 | - | 100 | +| TABLE_LIMIT_CREATE_TABLE_FIELDS_MAX | 创建表时允许的最大字段数 | 1000 | - | 1000 | +| TABLE_LIMIT_CREATE_TABLE_VIEWS_MAX | 创建表时允许的最大视图数 | 20 | - | 20 | +| TABLE_LIMIT_CREATE_TABLE_RECORDS_MAX | 创建表时允许的最大记录数 | 20000 | - | 20000 | +| TABLE_LIMIT_RECORDS_PER_TABLE_MAX | 每张表最大行数。为空时表示没有实例级行数上限 | - | - | 1000000 | +| TABLE_LIMIT_VIEW_FILTER_ITEMS_MAX | 单个视图最大筛选条件数 | 100 | - | 100 | +| TABLE_LIMIT_VIEW_FILTER_DEPTH_MAX | 单个视图最大嵌套筛选深度 | 5 | - | 5 | +| TABLE_LIMIT_VIEW_SORT_ITEMS_MAX | 单个视图最大排序条件数 | 20 | - | 20 | +| TABLE_LIMIT_VIEW_GROUP_ITEMS_MAX | 单个视图最大分组条件数 | 3 | - | 3 | +| TABLE_LIMIT_VIEW_OPTIONS_MAX_BYTES | 视图配置序列化后的最大字节数 | 262144 | - | 262144 | +| TABLE_LIMIT_NAME_MAX_LENGTH | 支持的表对象显示名称最大长度 | 100 | - | 100 | +| TABLE_LIMIT_DESCRIPTION_MAX_LENGTH | 支持的表对象描述最大长度 | 2000 | - | 2000 | | **功能开关** | | | | | | RECORD_HISTORY_DISABLED | 是否禁用记录历史，默认为 false | false | - | true | | PASSWORD_LOGIN_DISABLED | 是否禁用密码登录（OAuth 和 OIDC 仍然可用），默认为 false | false | - | true |