@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.3

package/docs/vi/releases/v8.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-22
-updatedAt: 2026-01-26
+updatedAt: 2026-06-14
 title: Intlayer v8. Có gì mới?
 description: Khám phá những điểm mới trong Intlayer v8. Cải tiến chính về trải nghiệm nhà phát triển, xác thực theo schema và quản lý từ điển.
 keywords:
@@ -409,6 +409,16 @@ Chúng tôi đã giới thiệu các hàm renderer và component độc lập m
 
 ---
 
+## Tệp Nội dung YAML & Markdown (v8.10.0)
+
+Giờ đây, bạn có thể khai báo nội dung trực tiếp bằng các phần mở rộng tệp `.content.md` và `.content.yaml`. Điều này hoàn hảo cho nội dung dạng dài, blog, tài liệu và chính sách bảo mật.
+
+Các tệp này hoàn toàn có thể chỉnh sửa từ Visual Editor, mang lại quy trình làm việc hợp lý cho các thành viên không thuộc nhóm kỹ thuật.
+
+Để biết thêm chi tiết, xem [Tài liệu Tệp Nội dung YAML](https://intlayer.org/doc/concept/content#yaml-content-file) và [Tài liệu Tệp Nội dung Markdown](https://intlayer.org/doc/concept/content/markdown).
+
+---
+
 ## Viết lại URL tùy chỉnh
 
 Intlayer v8 giới thiệu hỗ trợ cho **Viết lại URL tùy chỉnh**, cho phép bạn định nghĩa các đường dẫn theo ngôn ngữ (locale) khác với cấu trúc chuẩn `/locale/path`. Đây là một tính năng mạnh mẽ để cải thiện SEO địa phương và mang lại trải nghiệm người dùng tự nhiên hơn cho những người không nói tiếng Anh.
@@ -753,6 +763,61 @@ export default {
   </Tab>
 </Tabs>
 
+## Quy tắc số nhiều Unicode CLDR (v8.8.0)
+
+Một helper nút `plural` mới đã được giới thiệu dựa trên các quy tắc số nhiều được định nghĩa bởi Dự án Unicode CLDR, giúp cải thiện hỗ trợ cho các ngôn ngữ phức tạp.
+
+```typescript fileName="src/openings.content.ts"
+import { plural, t, type Dictionary } from "intlayer";
+
+const openingsContent = {
+  key: "total_openings",
+  content: {
+    totalOpenings: t({
+      vi: plural({
+        other: "{{count}} cơ hội",
+      }),
+      en: plural({
+        one: "{{count}} opening",
+        other: "{{count}} openings",
+      }),
+      fr: plural({
+        one: "{{count}} offre",
+        other: "{{count}} offres",
+      }),
+    }),
+  },
+} satisfies Dictionary;
+
+export default openingsContent;
+```
+
+Sau đó, bạn có thể truyền số lượng một cách động trong component framework của mình:
+
+```tsx
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
+  const { totalOpenings } = useIntlayer("total_openings");
+
+  return (
+    <div>
+      {/* Trong tiếng Anh:                             */}
+      {/*  count=0  → "0 openings"   (other)           */}
+      {/*  count=1  → "1 opening"    (one)             */}
+      {/*  count=2  → "2 openings"   (other)           */}
+      {/*  count=21 → "21 openings"  (other)           */}
+      <p>{totalOpenings(count)}</p>
+    </div>
+  );
+};
+```
+
+Để biết thêm thông tin, xem [Tài liệu Đa dạng hóa (Pluralization)](https://intlayer.org/doc/concept/content/plural).
+
+---
+
 ## Xác thực Schema Nội dung
 
 Intlayer v8 giới thiệu tính năng xác thực schema cho các dictionaries. Bây giờ bạn có thể định nghĩa các schema xác thực có thể tái sử dụng trong cấu hình của mình bằng Zod và áp dụng chúng cho các file nội dung. Điều này đảm bảo nội dung của bạn luôn tuân theo cấu trúc mong đợi, giúp phát hiện lỗi trong quá trình build.
@@ -797,6 +862,34 @@ Nếu nội dung không khớp với schema (ví dụ: title quá ngắn), quá
 
 ---
 
+## TypeScript: Các bộ truy cập nguyên bản IntlayerNode
+
+Kiểu `IntlayerNode` đã được cập nhật để cho phép gọi trực tiếp các phương thức JavaScript nguyên bản (primitive) trên các nút nội dung. Điều này giúp bạn có thể tương tác trực tiếp với nội dung đã được bản địa hóa của mình như thể nó là một chuỗi, số, boolean hoặc mảng nguyên bản tiêu chuẩn.
+
+Được hỗ trợ trên React, Preact, Solid, Svelte, Vue và Angular.
+
+### Ví dụ về Chuỗi (String)
+
+```typescript
+content.placeholder; // Trả về IntlayerNode<string>
+content.placeholder.value; // Trả về string
+content.placeholder.toString(); // Trả về string
+content.placeholder.toLowerCase(); // Trả về string
+String(content.placeholder); // Trả về string
+content.placeholder.toUpperCase(); // Trả về chuỗi viết hoa
+content.placeholder.replace("a", "b"); // Trả về chuỗi đã sửa đổi
+```
+
+### Ví dụ về Mảng (Array)
+
+```typescript
+content.myArrayOfString             // Trả về IntlayerNode<Array<string>>
+content.myArrayOfString.find(...)   // Trả về phần tử
+content.myArrayOfString.join(', ')  // Trả về chuỗi được nối
+```
+
+---
+
 ### Phát hiện nội dung tự động nâng cao
 
 Trong v8, Intlayer tự động nhận diện thông minh cú pháp Markdown, thẻ HTML và các chèn biến trong các chuỗi nội dung của bạn. Điều này có nghĩa là bạn thường có thể bỏ qua các hàm trợ giúp như `md()`, `html()` hoặc `insert()`.
@@ -1002,6 +1095,17 @@ Phần mở rộng Intlayer cho VSCode nhận được các cập nhật lớn t
 
 ---
 
+## Công cụ: C++ Watcher & OXC-based LSP (v8.12.0)
+
+Intlayer v8.12.0 mang lại những cải tiến lớn cho trải nghiệm nhà phát triển:
+
+- **Parcel Watcher**: Trình theo dõi nội dung (content watcher) đã được di chuyển từ `chokidar` sang `@parcel/watcher`, tận dụng tính năng theo dõi tệp C++ gốc để cung cấp các bản cập nhật nhanh hơn và giảm đáng kể mức tiêu thụ bộ nhớ.
+- **Language Server Protocol (LSP) mới**: Một LSP hoàn toàn mới hiện đã sẵn sàng. Được xây dựng với phân tích cú pháp dựa trên OXC, nó giúp IDE và các tác nhân AI của bạn liên kết liền mạch các lệnh gọi `useIntlayer('my-key')` với các tệp `.content` tương ứng của chúng và ngược lại.
+
+Để biết thêm chi tiết, xem [Tài liệu LSP](https://intlayer.org/doc/lsp).
+
+---
+
 ## Tối ưu trình biên dịch
 
 Intlayer v8 bao gồm một lớp cache mới cho trình biên dịch Markdown và HTML. Điều này đảm bảo rằng các chuỗi nội dung giống hệt với cùng cấu hình chỉ được phân tích một lần, giảm đáng kể chi phí khi tái kết xuất hoặc khi sử dụng cùng nội dung ở nhiều nơi.
@@ -1057,6 +1161,48 @@ Intlayer v8 bao gồm một lớp cache mới cho trình biên dịch Markdown v
 
 ---
 
+## Tối ưu hóa Build Thử nghiệm: Minify & Purge (v8.7.0)
+
+Intlayer v8.7.0 giới thiệu các tính năng build thử nghiệm mới trong `intlayer.config.ts` của bạn được thiết kế để tối ưu hóa bundle production của bạn:
+
+- **Thu nhỏ từ điển (Dictionary Minification)**: Thu nhỏ các tệp từ điển để giảm kích thước.
+- **Loại bỏ khóa không sử dụng (Unused Key Purging)**: Quét và loại bỏ các khóa dịch không sử dụng khỏi từ điển, đổi tên các khóa đang hoạt động thành các ký tự ngắn (ví dụ: `"products" -> "a"`, `"pricing" -> "b"`). Điều này giúp giảm kích thước bundle lên tới 5%.
+- **Vô hiệu hóa kiểm tra TypeScript**: Tăng tốc độ build bằng cách vô hiệu hóa kiểm tra kiểu dữ liệu (typechecking) TypeScript trong bước biên dịch.
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  dictionary: {
+    importMode: "dynamic",
+  },
+  build: {
+    /**
+     * Thu nhỏ các từ điển để giảm kích thước bundle.
+     */
+    minify: true,
+
+    /**
+     * Loại bỏ các khóa không sử dụng trong từ điển
+     */
+    purge: true,
+
+    /**
+     * Cho biết liệu quá trình build có nên kiểm tra các kiểu TypeScript hay không
+     */
+    checkTypes: false,
+  },
+};
+
+export default config;
+```
+
+---
+
 ## Tính linh hoạt: Chế độ import hợp nhất
 
 Thuộc tính boolean `live` đã bị đánh dấu là deprecated và được thay bằng thuộc tính `importMode` toàn diện hơn. Điều này cho phép xác định rõ ràng cách các dictionary nên được tải: theo kiểu tĩnh, động, hoặc qua đồng bộ trực tiếp.
@@ -1204,6 +1350,49 @@ Nội dung Markdown và HTML trong Svelte bây giờ tự động được phân
 
 ---
 
+## Hỗ trợ Angular: Vite Bundler (v8.11.0)
+
+Đối với người dùng Angular, Intlayer hiện hỗ trợ nguyên bản trình đóng gói Vite thông qua một plugin esbuild tùy chỉnh mới, giúp tăng tốc thời gian phát triển và build.
+
+Để biết chi tiết về cấu hình, xem [Tài liệu Môi trường Angular](https://intlayer.org/doc/environment/angular).
+
+---
+
+## Tạo Sitemap (v8.6.0)
+
+Intlayer hiện tự động tạo sitemap dựa trên các locale và chế độ định tuyến (routing mode) của bạn. Điều này đặc biệt hữu ích cho việc tối ưu hóa SEO trong các kiến trúc router như TanStack Router:
+
+```typescript fileName="src/routes/sitemap.xml.ts"
+import { createFileRoute } from "@tanstack/react-router";
+import { generateSitemap } from "intlayer";
+
+const SITE_URL = (
+  import.meta.env.VITE_SITE_URL ?? "http://localhost:3000"
+).replace(/\/$/, "");
+
+export const Route = createFileRoute("/sitemap.xml")({
+  server: {
+    handlers: {
+      GET: async () => {
+        const sitemap = generateSitemap(
+          [
+            { path: "/", changefreq: "daily", priority: 1.0 },
+            { path: "/about", changefreq: "monthly", priority: 0.8 },
+          ],
+          { siteUrl: SITE_URL }
+        );
+
+        return new Response(sitemap, {
+          headers: { "Content-Type": "application/xml" },
+        });
+      },
+    },
+  },
+});
+```
+
+---
+
 ## Ghi chú nâng cấp từ v7
 
 ### Thay đổi cấu hình

package/docs/vi/releases/v9.md

@@ -0,0 +1,232 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-14
+title: Intlayer v9 Mới - Có gì mới?
+description: Khám phá các tính năng mới trong Intlayer v9. Giới thiệu các package tương thích drop-in cho các thư viện i18n phổ biến và hỗ trợ Collections, Variants, và Dynamic Records.
+keywords:
+  - Intlayer
+  - Compatibility
+  - Migration
+  - Collections
+  - Variants
+  - Dynamic Records
+  - i18next
+  - next-intl
+  - vue-i18n
+slugs:
+  - doc
+  - releases
+  - v9
+author: aymericzip
+---
+
+# Intlayer v9 Mới - Có gì mới?
+
+Chào mừng bạn đến với Intlayer v9! Bản phát hành lớn này đánh dấu một cột mốc quan trọng trong việc đơn giản hóa lộ trình migration sang Intlayer với các **Compat Adapter Packages** dành cho các thư viện i18n phổ biến (`react-i18next`, `next-intl`, `vue-i18n`, v.v.) và bổ sung hỗ trợ cho các cấu trúc nội dung phong phú: **Collections**, **Variants**, và **Dynamic Records**.
+
+## Mục lục
+
+<TOC levels={[2]} maxDepth={1} />
+
+---
+
+## Compat Adapter Packages
+
+Việc migration sang Intlayer từ các thư viện i18n phổ biến giờ đây dễ dàng hơn bao giờ hết. Chúng tôi đã tạo ra năm compat package cung cấp **chính xác các public API tương tự** như các thư viện i18n tiêu chuẩn nhưng ủy quyền toàn bộ việc xử lý translation cho Intlayer tại runtime.
+
+### Cung cấp cùng một Public API với Strict Typing
+
+Bằng cách thay thế các import, bạn sẽ nhận được tất cả các lợi ích của Intlayer (bao gồm cả compile-time type safety dựa trên các dictionary thực tế của bạn) với những thay đổi code tối thiểu:
+
+- `@intlayer/i18next`
+- `@intlayer/react-i18next`
+- `@intlayer/next-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+
+Ví dụ, chỉ cần thay đổi:
+
+```ts
+import { useTranslation } from "react-i18next";
+```
+
+thành:
+
+```ts
+import { useTranslation } from "@intlayer/react-i18next";
+```
+
+Các key của bạn giờ đây sẽ được **strictly typed** dựa trên các Intlayer dictionary của bạn, mang lại khả năng auto-completion dot-path đầy đủ trong IDE của bạn!
+
+### Bundler Alias Plugins (Vite, Next.js, Turbopack)
+
+Để cho phép migration mà không cần phải viết lại tất cả các câu lệnh import một cách thủ công, mỗi compat adapter package đều đi kèm một **custom bundler plugin** (Vite hoặc Next.js) dưới subpath `/plugin`.
+
+Các plugin này tự động rewrite các import hiện có (ví dụ: `react-i18next` hoặc `next-intl`) thành các package tương đương `@intlayer/*` tại build time.
+
+#### Ví dụ Next.js (Webpack / Turbopack)
+
+Thay vì `withIntlayer`, hãy bọc cấu hình Next.js của bạn bằng compat plugin:
+
+```ts fileName="next.config.ts"
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+import type { NextConfig } from "next";
+
+const withIntlayer = createNextI18nPlugin();
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+#### Ví dụ Vite (React, Vue, Solid, Svelte)
+
+```ts fileName="vite.config.ts"
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vueI18nVitePlugin()],
+});
+```
+
+---
+
+## Mutualized Runtime Resolver
+
+Tất cả các compat adapter giờ đây đều định tuyến việc xử lý translation thông qua một runtime parser duy nhất và được tối ưu hóa cao: `@intlayer/core/messageFormat`.
+
+- **Interpolate Message**: Xử lý các cú pháp tiêu chuẩn `{{var}}` (whitespace & dot-paths), các đối số định dạng ICU (`{v, number, percent}` v.v.), và các template `{var}` cơ bản.
+- **Message Node Resolver**: Xử lý các node lồng nhau: `insert()`, `plural()` (quy tắc số nhiều CLDR), `enu()` (enumeration), `gender()`, các thẻ HTML, array, và các callable function node.
+- **Tokenized Tag Parser**: Hỗ trợ các thẻ XML/HTML inline và các thẻ được đánh số (ví dụ: `<1>children</1>`) để hỗ trợ render rich-text một cách dễ dàng.
+
+---
+
+## Chi tiết tính năng: Collections, Variants & Dynamic Records
+
+Intlayer v9 mở rộng vượt ra ngoài các đối tượng key-value tĩnh, cho phép các dictionary khai báo các cấu trúc layout động được định kiểu đầy đủ (fully typed) từ đầu đến cuối.
+
+### 1. Collections
+
+Định nghĩa một danh sách các item có thứ tự do CMS quản lý (ví dụ: FAQ, sản phẩm, hoặc danh sách blog):
+
+```ts fileName="faq.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  content: [
+    {
+      question: t({
+        vi: "Intlayer là gì?",
+        en: "What is Intlayer?",
+        fr: "Qu'est-ce qu'Intlayer ?",
+      }),
+      answer: t({
+        vi: "Một bộ công cụ i18n.",
+        en: "An i18n toolkit.",
+        fr: "Une boîte à outils i18n.",
+      }),
+    },
+  ],
+} satisfies Dictionary;
+```
+
+#### Cách sử dụng:
+
+```ts
+// Lấy tất cả các item
+const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
+
+// Lấy một item duy nhất bằng index
+const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+```
+
+### 2. Variants
+
+Cung cấp các bản thử nghiệm A/B, seasonal header, feature flag, hoặc các landing page tùy chỉnh:
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ vi: "Chào mừng", en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({
+      vi: "Mua ngay",
+      en: "Shop now",
+      fr: "Acheter maintenant",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+#### Cách sử dụng:
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+### 3. Dynamic Records
+
+Định nghĩa các dictionary có các mục nhập được tải động tại runtime thông qua các query ID:
+
+```ts fileName="product.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "product-copy",
+  meta: {
+    id: "prod_123",
+    category: "books",
+  },
+  content: {
+    title: t({ vi: "Clean Code", en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### Cách sử dụng:
+
+```ts
+// Chỉ tải động item được yêu cầu (yêu cầu Suspense)
+const product = useIntlayer("product-copy", {
+  id: "prod_123",
+  category: "books",
+});
+```
+
+---
+
+## Tối ưu hóa Dynamic Loading & Bundle Size
+
+Để giữ cho các bundle cực kỳ nhỏ gọn, Intlayer v9 hỗ trợ dynamic lazy loading.
+
+Trong cấu hình của bạn, hãy đặt `importMode` thành `'dynamic'` hoặc `'fetch'`:
+
+```ts fileName="intlayer.config.ts"
+export default {
+  dictionary: {
+    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+  },
+};
+```
+
+Tại build time, `@intlayer/swc` và `@intlayer/babel` sẽ quét các file của bạn và thay thế các lệnh gọi `useIntlayer` / `getIntlayer` bằng các wrapper có khả năng tree-shake (`useDictionary` / `useDictionaryDynamic`). Chỉ nội dung được yêu cầu cho collection item, variant, hoặc locale đã chọn mới được tải, giúp ngăn production bundle của bạn chứa các bản dịch không sử dụng.
+
+---
+
+## Lưu ý khi migration từ v8
+
+Nếu bạn đang nâng cấp từ v8, lưu ý rằng v9 không bao gồm các breaking change. Tuy nhiên, dưới đây là các thay đổi chính:
+
+- **Locales & Dialects**: Nếu sử dụng các dependency i18n bên ngoài, hãy thêm các compat adapter plugin tương ứng của chúng vào cấu hình hoặc thiết lập bundler của bạn để tự động rewrite các import.
+- **Custom Selectors**: Khi gọi `useIntlayer`, tham số thứ hai giờ đây được dành riêng cho một đối tượng option chứa `{ locale, item, variant, id }`. Nếu trước đây bạn đã truyền trực tiếp một chuỗi locale, bạn vẫn có thể làm như vậy, nhưng việc sử dụng đối tượng options được khuyến nghị cho các lựa chọn nâng cao.
+
+---
+
+## Liên kết hữu ích
+
+- [Hướng dẫn về Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compat/index.md)
+- [Dynamic Dictionaries - Collections, Variants & Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dynamic_dictionaries/index.md)
+- [Tài liệu tham khảo cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md)

package/docs/zh/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: 审核文档
 description: 学习如何审核不同语言版本的文档文件，以确保质量、一致性和完整性。
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "添加 --log 选项"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ bun x intlayer doc review
 
 ## 参数：
 
-`doc review` 命令接受与 `doc translate` 相同的参数，允许您审核特定的文档文件并应用质量检查。
+**文件列表选项：**
 
-如果您启用了其中一个 git 选项，命令将只审核文件中发生更改的部分。脚本会将文件分块处理并审核每个块。如果某个块没有更改，脚本将跳过该块，以加快审核过程并限制 AI 提供商 API 的成本。
+- **`--doc-pattern [docPattern...]`**：匹配要审核的文档文件的全局模式。
 
-有关完整的参数列表，请参阅[翻译文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/doc-translate.md)命令文档。
+  > 示例：`npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**：排除不审核的文件的全局匹配模式。
+
+  > 示例：`npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**：如果文件在指定时间之前被修改，则跳过该文件。
+  - 可以是绝对时间，如 "2025-12-05"（字符串或 Date 类型）
+  - 可以是相对时间，单位为毫秒，如 `1 * 60 * 60 * 1000`（1 小时）
+  - 此选项通过 `fs.stat` 方法检查文件的更新时间，因此可能会受到 Git 或其他修改文件工具的影响。
+
+  > 示例：`npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**：如果文件在指定时间内被修改，则跳过该文件。
+  - 可以是绝对时间，如 "2025-12-05"（字符串或 Date 类型）
+  - 可以是相对时间，单位为毫秒，如 `1 * 60 * 60 * 1000`（1 小时）
+  - 此选项通过 `fs.stat` 方法检查文件的更新时间，因此可能会受到 Git 或其他修改文件工具的影响。
+
+  > 示例：`npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**：如果文件已存在，则跳过该文件。
+
+  > 示例：`npx intlayer doc review --skip-if-exists`
+
+**审核模式选项：**
+
+- **`--log`**：仅记录模式。不使用 AI 进行翻译；而是记录需要关注的块（带有行号和内容），供基础语言环境和目标语言环境参考，以帮助另一个代理生成翻译。
+
+  > 示例：`npx intlayer doc review --log`
+
+**入口输出选项：**
+
+- **`--locales [locales...]`**：目标语言，用于审核文档。
+
+  > 示例：`npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**：源语言（基础文档），用于对比的起始语言。
+
+  > 示例：`npx intlayer doc review --base-locale en`
+
+**文件处理选项：**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**：同时处理审核的文件数量。
+
+  > 示例：`npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**AI 选项：**
+
+- **`--model [model]`**：用于审核的 AI 模型（例如，`gpt-3.5-turbo`）。
+- **`--provider [provider]`**：用于审核的 AI 提供商。
+- **`--temperature [temperature]`**：AI 模型的温度设置。
+- **`--api-key [apiKey]`**：为 AI 服务提供您自己的 API 密钥。
+- **`--application-context [applicationContext]`**：为 AI 审核提供额外的上下文信息。
+- **`--data-serialization [dataSerialization]`**：用于 Intlayer AI 功能的数据序列化格式。选项：`json`（标准、可靠），`toon`（更少 token，但一致性较低）。
+- **`--custom-prompt [prompt]`**：自定义用于审核的基础提示。（注意：对于大多数用例，建议使用 `--custom-instructions` 选项，因为它能更好地控制审核行为。）
+
+  > 示例：`npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**环境变量选项：**
+
+- **`--env`**：指定环境（例如，`development`，`production`）。
+- **`--env-file [envFile]`**：提供自定义环境文件以加载变量。
+- **`--base-dir`**：指定项目的基础目录。
+- **`--no-cache`**：禁用缓存。
+
+  > 示例: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**日志选项:**
+
+- **`--verbose`**: 启用详细日志以便调试。（CLI 默认启用）
+
+  > 示例: `npx intlayer doc review --verbose`
+
+**自定义指令选项:**
+
+- **`--custom-instructions [customInstructions]`**: 添加到提示中的自定义指令。用于应用关于格式、URL 翻译等的特定规则。
+
+  > 示例: `npx intlayer doc review --custom-instructions "避免翻译网址，并保持 markdown 格式"`
+
+  > 示例: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Git 选项:**
+
+- **`--git-diff`**: 仅针对包含从基础分支（默认 `origin/main`）到当前分支（默认 `HEAD`）的更改的文件运行。
+- **`--git-diff-base`**: 指定 git diff 的基础参考（默认 `origin/main`）。
+- **`--git-diff-current`**: 指定 git diff 的当前参考（默认 `HEAD`）。
+- **`--uncommitted`**: 包含未提交的更改。
+- **`--unpushed`**: 包含未推送的更改。
+- **`--untracked`**: 包含未跟踪的文件。
+
+  > 示例: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > 示例: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> 请注意，输出文件路径将通过替换以下模式来确定：
+>
+> - `/{{baseLocale}}/` 替换为 `/{{locale}}/`（Unix）
+> - `\{{baseLocale}}\` 替换为 `\{{locale}}\`（Windows）
+> - `_{{baseLocale}}.` 替换为 `_{{locale}}.`
+> - `{{baseLocale}}_` 替换为 `{{locale}}_`
+> - `.{{baseLocaleName}}.` 替换为 `.{{localeName}}.`
+>
+> 如果未找到上述模式，输出文件将在文件扩展名后添加 `.{{locale}}`。例如，`./my/file.md` 将被审核并为法语版本更新为 `./my/file.fr.md`。

package/docs/zh/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "添加 scan 命令"
   - version: 8.6.4

package/docs/zh/cli/scan.md

@@ -18,7 +18,7 @@ slugs:
   - cli
   - scan
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "添加 scan 命令"
 author: aymericzip