diff --git a/en/basic/ai/app-builder.mdx b/en/basic/ai/app-builder.mdx
index 89bb8a86..4b8699e7 100644
--- a/en/basic/ai/app-builder.mdx
+++ b/en/basic/ai/app-builder.mdx
@@ -75,16 +75,16 @@ You can update the app's code by importing a ZIP:
#### Secrets
-Use **Secrets** for API keys, credentials, and runtime configuration that your app needs at runtime. In the App Builder chat panel, open the **+** menu and choose **Secrets**.
+Use **Secrets** for API keys, credentials, and configuration values your app needs while it runs. In the App Builder chat panel, open the **+** menu and choose **Secrets**.
| Detail | Behavior |
| --- | --- |
-| Availability | App Secrets are available in both preview and published app runtime environments |
+| Availability | App Secrets are available in the app preview environment and the published app |
| Code access | Server-side app code can read them from environment variables such as `process.env.MY_API_KEY` |
| Saved values | Secret values are write-only after saving; enter a new value to update one |
| Key format | Keys must start with an uppercase letter and can contain uppercase letters, digits, and underscores |
-The preview runtime reads the current app Secrets when it starts or restarts. Publish the app again to use updated Secrets in the live app.
+After you add, delete, or change a Secret value, the app preview environment uses the new value. The published app uses it only after you republish. Editing only a Secret description does not require republishing.
## Publishing & Management
@@ -92,6 +92,7 @@ The preview runtime reads the current app Secrets when it starts or restarts. Pu
When your app is ready, click the **Publish** button (arrow icon) in the top right corner.
- **Public URL**: Teable generates a secure, publicly accessible URL for your app.
- **Custom Domain**: Map your own domain to the app.
+- **App configuration changes**: If the publish menu shows **App configuration changed — redeploy to apply**, click **Redeploy** to apply pending Secret value or login changes to the live app.
- Login settings appear in the preview after it reloads. Publish the app again to apply those changes to the live app.
+ Login settings appear in the app preview environment after it reloads. Publish the app again to apply those changes to the published app.
diff --git a/zh/basic/ai/app-builder.mdx b/zh/basic/ai/app-builder.mdx
index e0aa0493..7c1eefc0 100644
--- a/zh/basic/ai/app-builder.mdx
+++ b/zh/basic/ai/app-builder.mdx
@@ -83,16 +83,16 @@ Teable 应用构建器 (App Builder) 允许您在不编写代码的情况下，
#### 密钥管理
-不要把 API Key、访问凭证和运行时配置直接写进源码。需要让应用读取这些值时，在应用构建器对话面板中打开 **+** 菜单，选择 **密钥管理**。
+不要把 API Key、访问凭证和应用运行所需的配置直接写进源码。需要让应用读取这些值时，在应用构建器对话面板中打开 **+** 菜单，选择 **密钥管理**。
| 细节 | 行为 |
| --- | --- |
-| 生效范围 | 应用密钥可用于预览环境和已发布应用的运行环境 |
+| 生效范围 | 应用密钥可用于应用预览环境和已发布应用 |
| 代码读取 | 服务端代码可通过 `process.env.MY_API_KEY` 等环境变量读取 |
| 已保存的值 | 保存后不会明文展示；需要修改时，输入新值覆盖 |
| Key 格式 | Key 需要以大写字母开头，只能包含大写字母、数字和下划线 |
-预览环境启动或重启时会读取当前应用密钥。需要让线上应用使用新密钥时，请重新发布应用。
+新增、删除或修改密钥值后，应用预览环境会使用新值；已发布应用需要重新发布后才会使用。只修改密钥描述，不需要重新发布。
## 发布与管理
@@ -102,6 +102,7 @@ Teable 应用构建器 (App Builder) 允许您在不编写代码的情况下，
- **公开链接**：Teable 会为您的应用生成一个安全的、可公开访问的 URL。
- **自定义域名**：支持绑定您自己的域名。
+- **应用配置变更**：如果发布菜单显示 **应用配置已修改，重新发布后生效**，点击 **重新发布**，将待生效的密钥值或登录配置变更应用到线上应用。
- 登录配置会在预览重新加载后生效。要让线上应用使用新的登录配置，需要重新发布应用。
+ 登录配置会在应用预览环境重新加载后生效。要让已发布应用使用新的登录配置，需要重新发布应用。