@intlayer/docs 9.0.0-canary.8 → 9.0.0

package/docs/vi/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Tự host Intlayer
+description: Chạy một phiên bản Intlayer hoàn chỉnh trên hạ tầng của riêng bạn chỉ với một lệnh duy nhất. Không yêu cầu tài khoản Intlayer Cloud.
+keywords:
+  - Self-Hosting
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Installation
+  - Infrastructure
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Tự host Intlayer
+
+Intlayer có thể chạy hoàn toàn trên hạ tầng của riêng bạn — không yêu cầu tài khoản Intlayer Cloud. Chỉ một lệnh duy nhất sẽ khởi động một stack sẵn sàng cho production:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Trình cài đặt sẽ tải xuống `docker-compose.yml` và `.env`, tự động tạo các secret cần thiết, và khởi động tất cả các container với `docker compose up -d`.
+
+## Mục lục
+
+<TOC/>
+
+---
+
+## Kiến trúc
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-node RS)             (S3 API)     (SMTP)        (in-image)
+                             minio:9001   mailpit:8025
+                             (console)    (web UI)
+```
+
+Chromium (được sử dụng để tạo ảnh chụp màn hình Puppeteer) được đóng gói bên trong image backend — không cần container riêng.
+
+---
+
+## Điều kiện tiên quyết
+
+- **Docker** ≥ 24 và **Docker Compose** ≥ v2. Nếu thiếu một trong hai, trình cài đặt sẽ in liên kết cài đặt và thoát.
+- Các cổng `3000`, `3100`, `8025`, `9000`, và `9001` phải khả dụng trên host.
+- Host chạy Linux hoặc macOS (hoặc WSL2 trên Windows).
+
+---
+
+## Bắt đầu nhanh
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Những gì trình cài đặt thực hiện:
+
+1.  Kiểm tra xem `docker` và `docker compose` có tồn tại không.
+2.  Tải xuống `docker-compose.yml` và `.env.example` vào `./intlayer/`.
+3.  Nếu không có `.env` tồn tại, sao chép file ví dụ và tạo các secret ngẫu nhiên cho `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID`, và `S3_SECRET_ACCESS_KEY` thông qua `openssl rand`.
+4.  Chạy `docker compose pull` + `docker compose up -d`.
+5.  In các URL: dashboard `:3000`, API `:3100`, UI email `:8025`, console MinIO `:9001`.
+
+Sau khi stack hoạt động, mở **http://localhost:3000** và tạo tài khoản đầu tiên của bạn.
+
+---
+
+## Các dịch vụ
+
+| Dịch vụ     | Image                                      | Cổng Host                      | Mục đích                                                         |
+| ----------- | ------------------------------------------ | ------------------------------ | ---------------------------------------------------------------- |
+| **app**     | được xây dựng từ `apps/app/Dockerfile`     | `3000`                         | Dashboard TanStack Start (UI của CMS)                            |
+| **backend** | được xây dựng từ `apps/backend/Dockerfile` | `3100`                         | API REST Fastify (endpoint `/health`)                            |
+| **mongo**   | `mongo:7`                                  | nội bộ                         | Bộ nhân bản một node (`rs0`)                                     |
+| **redis**   | `redis:7-alpine`                           | nội bộ                         | Hàng đợi công việc (BullMQ) và caching (ioredis)                 |
+| **minio**   | `minio/minio`                              | `9000` (S3), `9001` (console)  | Lưu trữ đối tượng tương thích S3 cho avatar và ảnh chụp màn hình |
+| **mailpit** | `axllent/mailpit`                          | `1025` (SMTP), `8025` (web UI) | Nơi nhận email giao dịch cục bộ                                  |
+
+Các cổng nội bộ (mongo, redis) không được phơi bày ra host theo mặc định.
+
+> Cổng MinIO `9000` phải có thể truy cập được bởi trình duyệt vì các tài sản được tải lên (avatars, ảnh chụp màn hình) được tải trực tiếp từ `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Các biến môi trường
+
+Trình cài đặt tạo ra một file `.env` sẵn sàng để sử dụng. Bảng dưới đây mô tả từng biến.
+
+### Bắt buộc (tự động tạo hoặc được nhắc nhở)
+
+| Biến                   | Ví dụ                                           | Mô tả                                             |
+| ---------------------- | ----------------------------------------------- | ------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Môi trường runtime                                |
+| `PORT`                 | `3100`                                          | Cổng lắng nghe của Backend                        |
+| `BACKEND_URL`          | `http://localhost:3100`                         | URL công khai của API backend                     |
+| `APP_URL`              | `http://localhost:3000`                         | URL công khai của dashboard                       |
+| `DOMAIN`               | `localhost`                                     | Miền cookie                                       |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | URI kết nối MongoDB đầy đủ                        |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL kết nối Redis                                 |
+| `BETTER_AUTH_SECRET`   | _(được tạo)_                                    | Secret 32-byte để ký session                      |
+| `MAIL_PROVIDER`        | `smtp`                                          | Phương thức gửi mail: `smtp` hoặc `resend`        |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Tên host SMTP (tên container Mailpit)             |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Cổng SMTP                                         |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Địa chỉ người gửi                                 |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Endpoint tương thích S3                           |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | URL công khai để trình duyệt tải tài sản          |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Tên bucket                                        |
+| `S3_ACCESS_KEY_ID`     | _(được tạo)_                                    | Khóa truy cập MinIO                               |
+| `S3_SECRET_ACCESS_KEY` | _(được tạo)_                                    | Khóa bí mật MinIO                                 |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL backend được tích hợp vào dashboard khi build |
+| `VITE_DOMAIN`          | `localhost`                                     | Miền được tích hợp vào dashboard khi build        |
+
+### Tùy chọn (tính năng sẽ suy giảm khi không có)
+
+| Biến                                                     | Tính năng                                                      |
+| -------------------------------------------------------- | -------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Dịch thuật và kiểm tra nội dung có sự hỗ trợ của AI            |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Quản lý thanh toán và đăng ký                                  |
+| `RESEND_API_KEY`                                         | Email giao dịch qua Resend (ghi đè Mailpit khi được thiết lập) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Đăng nhập GitHub OAuth                                         |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Đăng nhập Google OAuth                                         |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Đăng nhập GitLab OAuth                                         |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Đăng nhập Microsoft OAuth                                      |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Đăng nhập LinkedIn OAuth                                       |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Đăng nhập Atlassian OAuth                                      |
+
+---
+
+## Kết nối dự án Intlayer của bạn
+
+Khi stack đang chạy, hãy trỏ dự án của bạn đến backend và dashboard được tự host thay vì `intlayer.org`.
+
+### Cấu hình dự án
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * URL của dashboard CMS được tự host.
+     * Mặc định: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // ví dụ: http://localhost:3000
+
+    /**
+     * URL của API backend được tự host.
+     * Mặc định: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // ví dụ: http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Thiết lập các biến môi trường trong file `.env` của dự án bạn:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+Tạo thông tin truy cập trong dashboard được tự host của bạn dưới mục **Projects → Access keys** tại `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`
+
+Khi sử dụng SDK `@intlayer/api` theo cách lập trình, hãy truyền `backendURL` một cách rõ ràng:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+---
+
+## Nâng cấp
+
+Chạy lại trình cài đặt trên một triển khai hiện có sẽ thực hiện nâng cấp cuốn chiếu (rolling upgrade):
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Thao tác này sẽ kéo các image mới nhất và khởi động lại các container với `docker compose pull && docker compose up -d`. Các volume hiện có (`mongo-data`, `redis-data`, `minio-data`) được bảo toàn — không mất dữ liệu.
+
+Để nâng cấp thủ công từ bên trong thư mục `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Sao lưu và phục hồi
+
+Tất cả dữ liệu bền vững nằm trong ba Docker volume được đặt tên.
+
+### Sao lưu
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### Phục hồi
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Lặp lại cho redis-data và minio-data
+```
+
+---
+
+## Sử dụng reverse proxy (Nginx / Caddy)
+
+Đối với các triển khai production, hãy đặt một reverse proxy phía trước các container app và backend thay vì phơi bày chúng trực tiếp.
+
+### Ví dụ Nginx
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+Cập nhật các biến `.env` sau để khớp với các miền công khai của bạn:
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> Các biến `VITE_*` được tích hợp vào image dashboard tại thời điểm build. Nếu bạn thay đổi chúng sau khi image được build, bạn cần build lại image `app` (`docker compose build app`) hoặc sử dụng cấu hình runtime injection.
+
+---
+
+## Khắc phục sự cố
+
+### Backend bị crash-loop khi khởi động lần đầu
+
+MongoDB và Redis phải hoạt động tốt trước khi backend khởi động. File compose sử dụng `depends_on` với `condition: service_healthy`. Nếu bạn thấy backend khởi động lại liên tục, hãy kiểm tra xem healthcheck của `mongo` và `redis` có vượt qua không:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Dashboard không thể kết nối tới API
+
+Xác minh rằng `VITE_BACKEND_URL` khớp với URL mà backend có thể truy cập được từ **trình duyệt** (không phải mạng Docker). Nếu bạn đã thay đổi cổng backend hoặc thêm reverse proxy, hãy build lại image dashboard:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### Email không gửi được
+
+Theo mặc định, tất cả email gửi đi được Mailpit thu nhận. Mở `http://localhost:8025` để xem các tin nhắn đã gửi. Để gửi email thật, hãy đặt `MAIL_PROVIDER=resend` và `RESEND_API_KEY=<your-key>` trong `.env`, sau đó khởi động lại backend:
+
+```sh
+docker compose restart backend
+```
+
+### Thiếu MinIO bucket
+
+Nếu dịch vụ một lần chạy `minio-init` không chạy (hoặc chạy trước khi MinIO sẵn sàng), hãy tạo bucket thủ công:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Các liên kết hữu ích
+
+- [Tài liệu Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md)
+- [Tham chiếu cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md)
+- [CMS SDK — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)
+- [Docker Image (aymercizip/intlayer-selfhost)](https://hub.docker.com/repository/docker/aymercizip/intlayer-selfhost/general)

package/docs/zh/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js 需要依靠 `@intlayer/swc` 插件来进行优化步骤（导入重写
 
 > 该插件并未默认安装，因为 SWC 插件在 Next.js 当中目前仍处于实验阶段。未来这部分有可能会发生改变。
 
+<Tabs>
+ <Tab value="npm">
+
 ```bash packageManager="npm"
 npm install -D @intlayer/swc
 ```
@@ -247,6 +250,19 @@ pnpm add -D @intlayer/swc
 bun add -d @intlayer/swc
 ```
 
+ </Tab>
+ <Tab value="Crates.io (rust)">
+
+```toml fileName="Cargo.toml"
+[dependencies]
+intlayer-swc-plugin = "*"
+```
+
+[View on Crates.io](https://crates.io/crates/intlayer-swc-plugin)
+
+ </Tab>
+</Tabs>
+
 安装完毕后，Intlayer 将会自动侦测并使用该插件。
 
 至于**清除（purge）和最小化（minify）**步骤（即字段移除和字段重命名），请连同 `@intlayer/babel` 一并安装并加入 Babel 插件。由于 Next.js 依靠 SWC 处理代码转化，但仍会评估 `babel.config.js` 以决定插件配置，因此上述 Babel 插件能够在进入 SWC 前作为预处理步骤得以执行。

package/docs/zh/cli/index.md

@@ -125,7 +125,7 @@ Intlayer 接受多种配置文件格式：
 
 ### 身份验证
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/login.md)** - 在 Intlayer CMS 中进行身份验证并获取访问凭据
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/login.md)** - 在 Intlayer CMS 中进行身份验证并获取访问凭据
 
 ### 核心命令
 

package/docs/zh/cli/scan.md

@@ -150,10 +150,10 @@ await scan("https://example.com", {
 });
 ```
 
-对于更低级别的访问，来自 `@intlayer/chokidar/scan` 的 `scanWebsite` 会返回一个结构化的 `ScanResult` 对象：
+对于更低级别的访问，来自 `@intlayer/engine/scan` 的 `scanWebsite` 会返回一个结构化的 `ScanResult` 对象：
 
 ```ts
-import { scanWebsite } from "@intlayer/chokidar/scan";
+import { scanWebsite } from "@intlayer/engine/scan";
 
 const result = await scanWebsite("https://example.com", { deep: false });
 console.log(result.score, result.totalPageSize, result.events);

package/docs/zh/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-23
+updatedAt: 2026-07-11
 title: 配置
 description: 了解如何为您的应用程序配置 Intlayer。了解可用于根据您的需求自定义 Intlayer 的各种设置和选项。
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "添加 `analytics` 配置"
   - version: 9.0.0
     date: 2026-06-24
     changes: "Add `enableProxy` option to the routing configuration"
@@ -355,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * 分析（analytics）配置。
+   */
+  analytics: {
+    /**
+     * 是否启用分析数据收集（页面浏览量、内容曝光、A/B 事件）。
+     * 需要设置 `editor.clientId` 以进行归因。
+     * 默认值：false
+     */
+    enabled: true,
+
+    /**
+     * 自动批量发送到后端之间的毫秒数。
+     * 默认值：20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * 要记录的会话比例，从 0（不记录）到 1（全部记录）。
+     * 默认值：1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * 使用 AI 进行翻译和生成的设置。
    */
@@ -671,6 +698,20 @@ export default config;
 
 ---
 
+### 分析配置 (Analytics)
+
+定义与 Intlayer 分析相关的设置：收集实际展示给用户的内容（页面浏览量、内容曝光），并支持内容的 A/B 测试。
+
+分析功能严格采用选择加入（opt-in）模式：除非将 `analytics.enabled` 显式设置为 `true` **并且** 配置了用于归因的项目密钥（`editor.clientId`），否则不会收集任何数据。禁用时（默认），整个分析集成会从应用程序打包结果中被移除（死代码消除）。
+
+| 字段            | 描述                                                   | 类型      | 默认值  | 示例    | 说明                                                                                          |
+| --------------- | ------------------------------------------------------ | --------- | ------- | ------- | --------------------------------------------------------------------------------------------- |
+| `enabled`       | 启用分析数据收集（页面浏览量、内容曝光、A/B 事件）。   | `boolean` | `false` | `true`  | 需要设置 `editor.clientId` 以进行归因；否则即使 `enabled` 为 `true`，分析功能仍保持禁用状态。 |
+| `flushInterval` | 自动批量发送到后端之间的毫秒数。                       | `number`  | `20000` | `10000` |                                                                                               |
+| `sampleRate`    | 要记录的会话比例，从 `0`（不记录）到 `1`（全部记录）。 | `number`  | `1`     | `0.5`   | 采样按会话确定性进行，因此被记录的会话会报告其所有事件（不会出现部分漏斗）。                  |
+
+---
+
 ### 路由配置 (Routing)
 
 控制路由行为的设置，包括 URL 结构、区域设置存储和中间件管理。

package/docs/zh/how_works_intlayer.md

@@ -219,9 +219,9 @@ Intlayer 由多个包组成，每个包在翻译过程中都有特定的角色
 
 `@intlayer/dictionaries-entry`、`@intlayer/unmerged-dictionaries-entry` 和 `@intlayer/dynamic-dictionaries-entry` 包返回 Intlayer 字典的入口路径。由于浏览器无法搜索文件系统，因此无法使用像 Webpack 或 Rollup 这样的打包工具来获取字典的入口路径。这些包设计为别名，以便在 Vite、Webpack 和 Turbopack 等各种打包工具中进行打包优化。
 
-### @intlayer/chokidar
+### @intlayer/engine
 
-`@intlayer/chokidar` 包用于监视内容文件，并在每次修改时重新生成被修改的字典。
+`@intlayer/engine` 包用于监视内容文件，并在每次修改时重新生成被修改的字典。
 
 ### @intlayer/editor
 

package/docs/zh/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
+updatedAt: 2026-07-08
 title: Intlayer CMS | 将您的内容外部化到 Intlayer CMS
 description: 将您的内容外部化到 Intlayer CMS，以将内容管理委托给您的团队。
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - cms
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "将「实时同步」章节移动到独立页面（live-sync.md），此处仅保留简短介绍和链接"
   - version: 6.0.1
     date: 2025-09-22
     changes: "添加实时同步文档"
@@ -245,134 +248,7 @@ bun x intlayer dictionary push -d my-first-dictionary-key --env production
 
 实时同步让您的应用在运行时反映 CMS 内容的更改。无需重新构建或重新部署。启用后，更新会被流式传输到实时同步服务器，刷新您的应用读取的字典。
 
-> 实时同步需要持续的服务器连接，并且仅在企业版计划中可用。
-
-通过更新您的 Intlayer 配置来启用实时同步：
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  // ... 其他配置设置
-  editor: {
-    /**
-     * 当检测到更改时，启用本地配置的热重载。
-     * 例如，当添加或更新字典时，应用程序会更新页面上显示的内容。
-     *
-     * 由于热重载需要与服务器保持持续连接，
-     * 因此仅对 `enterprise` 计划的客户开放。
-     *
-     * 默认值：false
-     */
-    liveSync: true,
-  },
-  dictionary: {
-    /**
-     * 控制字典的导入方式：
-     *
-     * - "live"：字典通过 Live Sync API 动态获取。
-     *   替换 useIntlayer 为 useDictionaryDynamic。
-     *
-     * 注意：Live 模式使用 Live Sync API 获取字典。如果 API 调用失败，
-     * 字典将动态导入。
-     * 注意：只有带有远程内容和 "live" 标志的字典使用 live 模式。
-     * 其他字典为了性能使用动态模式。
-     */
-    importMode: "fetch",
-  },
-};
-
-export default config;
-```
-
-启动 Live Sync 服务器以包裹您的应用程序：
-
-使用 Next.js 的示例：
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... 其他脚本
-    "build": "next build",
-    "dev": "next dev",
-    "start": "npx intlayer live --with 'next start'",
-  },
-}
-```
-
-使用 Vite 的示例：
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... 其他脚本
-    "build": "vite build",
-    "dev": "vite dev",
-    "start": "npx intlayer live --with 'vite start'",
-  },
-}
-```
-
-Live Sync 服务器包裹您的应用程序，并在更新内容到达时自动应用。
-
-为了接收来自 CMS 的变更通知，Live Sync 服务器会与后端保持 SSE 连接。当 CMS 中的内容发生变化时，后端会将更新转发给 Live Sync 服务器，服务器会写入新的字典。您的应用将在下一次导航或浏览器刷新时反映更新, 无需重新构建。
-
-流程图（CMS/后端 -> Live Sync 服务器 -> 应用服务器 -> 前端）：
-
-![Live Sync 逻辑示意图](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
-
-工作原理：
-
-![Live Sync 流程 CMS/后端/Live Sync 服务器/应用服务器/前端示意图](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
-
-### 开发工作流程（本地）
-
-- 在开发过程中，应用启动时会获取所有远程字典，因此您可以快速测试更新。
-- 要在本地使用 Next.js 测试 Live Sync，请包装您的开发服务器：
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... 其他脚本
-    "dev": "npx intlayer live --with 'next dev'",
-    // "dev": "npx intlayer live --with 'vite dev'", // 适用于 Vite
-  },
-}
-```
-
-启用优化，以便 Intlayer 在开发期间应用实时导入转换：
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  editor: {
-    applicationURL: "http://localhost:5173",
-    liveSyncURL: "http://localhost:4000",
-    liveSync: true,
-  },
-  dictionary: {
-    importMode: "fetch",
-  },
-  build: {
-    optimize: true,
-  },
-};
-
-export default config;
-```
-
-此设置将您的开发服务器与实时同步服务器包装在一起，在启动时获取远程字典，并通过 SSE 从 CMS 流式传输更新。刷新页面以查看更改。
-
-注意事项和限制：
-
-- 将实时同步源添加到您的站点安全策略（CSP）中。确保实时同步 URL 被允许在 `connect-src` 中（如果相关，也包括 `frame-ancestors`）。
-- 实时同步不适用于静态输出。对于 Next.js，页面必须是动态的才能在运行时接收更新（例如，适当使用 `generateStaticParams`、`generateMetadata`、`getServerSideProps` 或 `getStaticProps`，以避免完全静态的限制）。
-- 应用程序 URL 应与您在编辑器配置中设置的 URL (`applicationURL`) 匹配。
-- CMS URL
-- 确保项目配置已推送到 Intlayer CMS。
-
-- 可视化编辑器使用 iframe 来显示您的网站。确保您网站的内容安全策略（CSP）允许 CMS URL 作为 `frame-ancestors`（默认是 'https://intlayer.org'）。检查编辑器控制台是否有任何错误。
+完整的设置指南（启用方式、启动 Live Sync 服务器、本地开发工作流程和限制条件）请参阅 [Live Sync 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/live-sync.md)。
 
 ## 调试
 

package/docs/zh/intlayer_with_adonisjs.md

@@ -60,19 +60,23 @@ See [Application Template](https://github.com/aymericzip/intlayer-adonis-templat
 要开始使用 `adonis-intlayer`，请使用 npm 安装该包：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > `--interactive` 标志是可选的。如果您是 AI 代理，请使用 `intlayer-cli init`。