@intlayer/docs 9.0.0-canary.9 → 9.0.1

package/docs/zh/intlayer_with_vite+solid.md

@@ -32,7 +32,7 @@ author: aymericzip
 
 <Tabs defaultTab="video">
   <Tab label="视频" value="video">
-  
+
 <iframe title="The best i18n solution for Vite and Solid? Discover Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?si=VaKmrYMmXjo3xpk2"/>
 
   </Tab>
@@ -58,19 +58,19 @@ author: aymericzip
 使用 npm 安装所需的包：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` 标志是可选的。如果您是 AI 代理，请使用 `intlayer-cli init`。

package/docs/zh/intlayer_with_vite+svelte.md

@@ -133,19 +133,19 @@ Intlayer 不仅仅是一个 i18n 解决方案，还提供了一个**自托管的
 使用 npm 安装必要的包：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` 标志是可选的。如果您是 AI 代理，请使用 `intlayer-cli init`。

package/docs/zh/intlayer_with_vite+vue.md

@@ -93,7 +93,7 @@ Intlayer 不仅仅是一个 i18n 解决方案，还提供了一个**自托管的
 
 <Tabs defaultTab="video">
   <Tab label="视频" value="video">
-  
+
 <iframe title="The best i18n solution for Vite and Vue? Discover Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/IE3XWkZ6a5U?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </Tab>
@@ -130,19 +130,19 @@ Intlayer 不仅仅是一个 i18n 解决方案，还提供了一个**自托管的
 使用 npm 安装所需的包：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` 标志是可选的。如果您是 AI 代理，请使用 `intlayer-cli init`。

package/docs/zh/live-sync.md

@@ -0,0 +1,175 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: 实时同步（Live Sync）| 让应用实时反映 CMS 内容变更
+description: 让您的应用在运行时实时反映 Intlayer CMS 的内容变更，无需重新构建或重新部署。
+keywords:
+  - 实时同步
+  - Live Sync
+  - CMS
+  - 可视化编辑器
+  - 国际化
+  - 文档
+  - Intlayer
+  - Next.js
+  - Vite
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "从 Intlayer CMS 文档中拆分为独立页面"
+  - version: 6.0.1
+    date: 2025-09-22
+    changes: "添加实时同步文档"
+  - version: 6.0.0
+    date: 2025-09-04
+    changes: "用 `liveSync` 字段替换 `hotReload` 字段"
+author: aymericzip
+---
+
+# 实时同步
+
+实时同步让您的应用在运行时反映 CMS 内容的更改。无需重新构建或重新部署。启用后，更新会被流式传输到实时同步服务器，刷新您的应用读取的字典。
+
+## 目录
+
+<TOC/>
+
+---
+
+## 启用实时同步
+
+> 实时同步需要持续的服务器连接，并且仅在企业版计划中可用。
+
+通过更新您的 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'）。检查编辑器控制台是否有任何错误。
+
+## Useful links
+
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)
+- [Intlayer 可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)
+- [配置参考](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)
+- [自托管指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/self_hosting.md)

package/docs/zh/migration_from_i18next_to_intlayer.md

@@ -99,19 +99,19 @@ Intlayer 也是 i18n 生态系统中**开发最活跃的**解决方案——问
 安装 Intlayer 核心包和兼容性适配器：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` 标志是可选的。如果你是 AI 代理，请使用 `intlayer-cli init`。

package/docs/zh/migration_from_next-i18next_to_intlayer.md

@@ -102,19 +102,19 @@ Intlayer 不仅仅是一个 i18n 解决方案，它还提供**自托管[可视
 安装 Intlayer 核心包和兼容适配器:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` 标志是可选的。如果您是 AI 代理,请使用 `intlayer-cli init`。

package/docs/zh/migration_from_next-intl_to_intlayer.md

@@ -98,19 +98,19 @@ Intlayer 不仅仅是一个 i18n 解决方案，它提供了一个**自托管的
 安装 Intlayer 核心包和 `@intlayer/next-intl` 兼容性适配器：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` 标志是可选的。如果你是 AI 代理，请使用 `intlayer-cli init`。
@@ -184,9 +184,7 @@ import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
 
 const withIntlayer = createNextIntlPlugin();
 
-const nextConfig: NextConfig = {
-  /* 你现有的配置选项 */
-};
+const nextConfig: NextConfig = {/* 你现有的配置选项 */};
 
 export default withIntlayer(nextConfig);
 ```

package/docs/zh/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -101,19 +101,19 @@ Intlayer 不仅仅是一个 i18n 解决方案，它还提供**自托管的[可
 安装 Intlayer 核心包和兼容性适配器：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` 标志是可选的。如果你是 AI 代理，使用 `intlayer-cli init`。

package/docs/zh/migration_from_react-i18next_to_intlayer.md

@@ -101,19 +101,19 @@ Intlayer 不仅是一个 i18n 方案，它还提供**自托管的[可视化编
 安装 Intlayer 核心包和兼容性适配器：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` 标志是可选的。如果你是 AI 代理，请使用 `intlayer-cli init`。
@@ -209,9 +209,7 @@ import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
 
 const withIntlayer = createNextI18nPlugin();
 
-const nextConfig: NextConfig = {
-  /* your options */
-};
+const nextConfig: NextConfig = {/* your options */};
 
 export default withIntlayer(nextConfig);
 ```

package/docs/zh/migration_from_vue-i18n_to_intlayer.md

@@ -100,19 +100,19 @@ Intlayer 也是 i18n 生态中**开发最活跃的**解决方案 —— 问题
 安装 Intlayer 核心 package 和兼容适配器：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` flag 是可选的。如果您是 AI agent，请使用 `intlayer-cli init`。

package/docs/zh/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-07-08
 title: New Intlayer v9 - What's new?
 description: Discover what's new in Intlayer v9. Introducing drop-in compatibility packages for popular i18n libraries and support for Collections and Variants.
 keywords:
@@ -9,9 +9,11 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - CMS SDK
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=zmCN4z_B4jk
 slugs:
   - doc
   - releases
@@ -23,6 +25,14 @@ author: aymericzip
 
 Welcome to Intlayer v9! This major release marks a huge milestone in simplifying the migration path to Intlayer with **Compat Adapter Packages** for major i18n libraries (`react-i18next`, `next-intl`, `vue-i18n`, etc.) and adds support for rich content structures: **Collections** and **Variants**.
 
+<iframe
+  src="https://www.youtube.com/embed/zmCN4z_B4jk"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Video - New Intlayer v9 - What's new?"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
 ## Table of contents
 
 <TOC levels={[2]} maxDepth={1} />
@@ -109,28 +119,40 @@ Intlayer v9 expands beyond static key-value objects, allowing dictionaries to de
 
 Define a CMS-managed list of ordered items (e.g. FAQs, products, or blog lists):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
-      answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
-    },
-  ],
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### Usage:
 
 ```ts
-// Fetch all items
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Fetch single item by index
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. Variants
@@ -180,28 +202,52 @@ export default {
 ```ts
 // Fetches only the requested item dynamically (requires Suspense)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## Dynamic Loading & Bundle Size Optimizations
-
-To keep bundles extremely small, Intlayer v9 supports dynamic lazy loading.
-
-In your configuration, set `importMode` to `'dynamic'` or `'fetch'`:
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
+## `@intlayer/analytics`：内容曝光追踪与 A/B 测试
+
+全新的可选包 [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) 会告诉您访客实际看到了哪些内容——并通过让您对内容进行 A/B 测试、按变体衡量转化率，补上 **Collections & Variants** 的最后一环。
+
+- **Provider 级别追踪**：`IntlayerProvider`（React / Next.js / React Native）会在加载、路由变化和语言切换时自动记录 `page_view` 事件。
+- **节点级别追踪**：每次 `useIntlayer` 解析都会上报一个 `content_exposure` 事件——包括显示了哪个字典键、键路径、语言，以及（如适用）哪个 A/B **变体**。同一刷新窗口内对同一节点的重复曝光会被合并为一个事件。
+- **确定性 A/B 分配**：`getVariant(experimentKey, variants)` 在**无需服务器往返**的情况下为每个会话分配变体，因此首次渲染前不会出现闪烁。
+- **`useConversion()`**：将目标（注册、点击、购买等）归因于会话所看到的变体。
+- **未安装时零成本**：与 `@intlayer/editor` 相同的可摇树优化模式——用 `try/catch` 包裹的动态 `import()`，加上一个编译期环境变量（`INTLAYER_ANALYTICS_ENABLED`），对未启用的应用会将整个集成从打包结果中彻底移除。
+- **无需新增配置项**：复用现有的 `editor.backendURL`（上报端点 / 自托管）和 `editor.clientId`（项目密钥，同时也是启用开关）。
+- **注重隐私**：会话匿名哈希化（SHA-256，不存储原始 ID）、不存储 IP、仅保留粗粒度的国家级地理位置，请求大约每 20 秒批量发送一次。
+- **仪表盘**：新的 **Analytics** 页面（选择项目后显示在侧边栏中）展示活跃用户数、今日用户数、最近 7/30/90 天用户数、访客变化趋势图，以及按语言和地理位置的细分。
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
 };
 ```
 
-At build time, `@intlayer/swc` and `@intlayer/babel` scan your files and replace `useIntlayer` / `getIntlayer` calls with tree-shakeable wrappers (`useDictionary` / `useDictionaryDynamic`). Only the content required for the selected collection item, variant, or locale is loaded, preventing your production bundle from containing unused translations.
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+目前已支持 React、Next.js 和 React Native（通过 `react-intlayer`）；其他框架绑定（Vue、Svelte、Angular 等）正在规划中，将遵循与 `@intlayer/editor` 相同的推广模式。完整指南请参阅 [Analytics 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)。
 
 ---
 
@@ -284,6 +330,34 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK：将 Intlayer 用作无头内容数据库
+
+Intlayer v9 在 `@intlayer/api` 中提供了一个简洁、自动鉴权的 SDK，用于以编程方式与 CMS 交互——获取项目、获取字典，以及从你自己的服务器、脚本或 CI 推送或更新它们。鉴权（OAuth2 `client_credentials`）会自动处理并刷新。
+
+SDK 拆分为**两个独立的导入**，因此你的打包产物只包含你实际使用的领域：
+
+1. `createIntlayerCMS` —— 一个轻量的**鉴权器**，持有凭据和受管理的令牌（不打包任何领域客户端）。
+2. `dictionaryEndpoint`、`projectEndpoint`、… —— 按领域划分的**端点绑定器**，各自从其独立子路径导入。
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// 配置是可选的：凭据会回退到 INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET（由 `@intlayer/config/built` 解析）。
+const cms = createIntlayerCMS();
+
+// 读取
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// 写入 —— 像数据库一样使用 CMS
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> 安全：CMS 凭据授予对内容的写入权限。务必只在**服务端**创建鉴权器——切勿将 `clientId` / `clientSecret` 发送到浏览器。
+
+---
+
 ## Migration notes from v8
 
 If you are upgrading from v8, note that the v9 does not include breaking changes. But here are the key changes:
@@ -298,4 +372,6 @@ If you are upgrading from v8, note that the v9 does not include breaking changes
 
 - [Compat Adapter Packages Guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/compat/index.md)
 - [Dynamic Dictionaries - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dynamic_dictionaries/index.md)
+- [Analytics - 内容曝光追踪与 A/B 测试](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Configuration Reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md)
+- [CMS SDK - 通过 @intlayer/api 进行编程访问](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)