@intlayer/docs 9.4.4 → 9.5.0

package/docs/zh/intlayer_CMS.md

@@ -47,8 +47,6 @@ Intlayer CMS 是一个应用程序，允许您将 Intlayer 项目的内容外部
 
 <TOC/>
 
----
-
 ## 理解远程字典
 
 Intlayer 区分“本地”字典和“远程”字典。
@@ -412,8 +410,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 有关完整的设置指南、环境变量参考、升级说明和备份/恢复过程，请参阅[自托管指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/self_hosting.md)。
 
----
-
 ## 调试
 
 如果您遇到 CMS 的任何问题，请检查以下内容：
@@ -438,25 +434,21 @@ curl -fsSL https://intlayer.org/install.sh | sh
 [可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md) 编辑的是本地字典，并将修改直接写回您的代码库中，因此应用需要重新构建，并且更改需要走正常的代码审查和部署流程。而 CMS 编辑的是远程字典：修改完全不触碰您的代码库，运行中的站点无需重新部署即可直接生效。团队通常两者搭配使用：开发者维护的内容使用编辑器，市场团队每周频繁更新的内容使用 CMS。
 
 </Question>
-
 <Question title="i18n 会给我的 bundle 体积增加多少？">
 
 远少于基于命名空间的方案，因为页面永远不会下载它不渲染的语言目录。服务端渲染的标记在服务端直接解析内容，而构建时编译器将 `useIntlayer` 调用替换为组件使用的确切字典条目，因此未使用的键和未使用的语言都会被自动丢弃。[动态字典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dynamic_dictionaries/index.md) 会按语言环境拆分剩余内容。与常规替代方案相比，Intlayer 可将 bundle 和页面体积减少高达 50%。请参阅 [Bundle 体积优化](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/bundle_optimization.md) 和 [性能基准](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/benchmark/index.md)。
 
 </Question>
-
 <Question title="我可以从 i18next、next-intl 或 react-i18next 迁移而无需重写组件吗？">
 
 可以，有两条迁移路径。您可以使用 [i18next 迁移指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/migration_from_i18next_to_intlayer.md) 或 [next-intl 迁移指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/migration_from_next-intl_to_intlayer.md) 逐步迁移内容。或者，您可以完全保留当前的 API：[兼容性适配器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/index.md) 公开与 `i18next`、`react-i18next`、`next-intl`、`next-i18next`、`react-intl`、`use-intl`、`vue-i18n` 和 `Lingui` 完全相同的 API，但底层由 Intlayer 字典驱动，因此只需更改导入语句，组件代码无需修改。
 
 </Question>
-
 <Question title="我可以保留现有的 JSON 翻译文件吗？">
 
 可以。[JSON 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md) 将您的 `/messages/{locale}/{namespace}.json` 文件作为单一真实来源（source of truth），并双向生成 Intlayer 字典。[PO 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-po.md) 对 gettext 目录执行相同的操作，而 [按语言环境组织的文件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/per_locale_file.md) 允许您按语言拆分内容，而不是将所有语言打包到一个文件中。
 
 </Question>
-
 <Question title="我必须逐个键迁移我的内容吗？">
 
 不需要。运行 `npx intlayer extract`，Intlayer 会读取您的源码文件，提取面向用户的字符串，并在每个组件旁边生成 `.content` 文件，这样您只需审查 diff，而无需手动逐一复制字符串到语言目录中。请参阅 [extract 命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md)。
@@ -464,7 +456,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 如需全自动流程，[Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compiler.md) 可以在构建时对 JSX、TSX、Vue 和 Svelte 源码执行相同操作，在每次更改时自动生成字典，完全无需手动维护键名。它通过静态分析工作，因此仅在运行时存在的字符串无法被捕获，并且需要少量注解以区分用户文本和应用程序逻辑。
 
 </Question>
-
 <Question title="有哪些可用的编辑器和 AI 代理工具？">
 
 共有 5 个工具，均为可选：
@@ -476,43 +467,36 @@ curl -fsSL https://intlayer.org/install.sh | sh
 - **[ESLint 插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/eslint.md)**：`no-raw-text` 规则标记硬编码字符串，并提供针对静态字典键和未使用内容的额外规则。
 
 </Question>
-
 <Question title="哪些内容应该迁移到 CMS 中？">
 
 经常变化且不属于版本发布周期的一部分的内容：落地页文案、定价方案措辞、活动公告等任何由市场团队负责的内容。而作为界面核心组成部分的内容（如按钮标签和表单验证错误信息）更适合作为本地字典保留在代码库中，以便与使用它的代码一同进行代码审查。
 
 </Question>
-
 <Question title="如果 CMS 无法访问会发生什么？">
 
 应用程序会自动回退到字典的本地声明，因此网络故障或外部中断只会降级为使用构建时打包的本地内容，绝不会渲染出空白页面。这正是为每个远程字典保留本地声明至关重要的原因。
 
 </Question>
-
 <Question title="我可以自托管 CMS 吗？">
 
 可以。CMS 完全可以在您自己的基础设施上运行，这非常适合内容不能离开内部网络的私有化合规场景。请参阅 [自托管 Intlayer 指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/self_hosting.md)。
 
 </Question>
-
 <Question title="内容编辑人员发布更改需要开发者介入吗？">
 
 不需要。这正是远程字典的核心价值：编辑人员在 CMS 中修改文案，线上站点便会直接反映更新，通过 [实时同步 (live sync)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/live.md) 在运行时即时应用更新，无需等待构建和发布流水线。
 
 </Question>
-
 <Question title="除了使用图形界面外，我可以对 CMS 进行自动化操作吗？">
 
 可以。`@intlayer/api` SDK 公开了与图形界面完全相同的 API 端点，因此您可以通过脚本或 CI/CD 流水线拉取项目、读取字典并推送更新。上方章节展示了身份认证及各端点的调用方法。
 
 </Question>
-
 <Question title="CMS 是否支持 A/B 测试翻译？">
 
 支持。远程字典支持 [内容变体 (variants)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dynamic_dictionaries/variants.md)，并且 [数据分析 (analytics)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/analytics.md) 会报告每个变体的曝光数据，使文案效果能够通过数据直接衡量，而无需无谓争论。
 
 </Question>
-
 <Question title="CMS 是免费的吗？">
 
 Intlayer 的核心库、CLI、编译器和可视化编辑器均在 Apache 2.0 许可证下完全开源免费。云端托管版 CMS 是一项可选的付费服务，您也可以选择完全免费的 [自托管方案](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/self_hosting.md)。

package/docs/zh/intlayer_visual_editor.md

@@ -221,25 +221,21 @@ pnpm intlayer-editor start -e development
 可视化编辑器编辑的是本地字典，并将修改直接写回您的代码库中，因此会走常规的代码审查和部署流水线。而 [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 编辑的是远程字典，可在运行中的线上站点直接生效而无需重新部署。编辑器适合开发者掌控的内容；CMS 适合市场团队掌控的内容。
 
 </Question>
-
 <Question title="i18n 会给我的 bundle 体积增加多少？">
 
 远少于基于命名空间的方案，因为页面永远不会下载它不渲染的语言目录。服务端渲染的标记在服务端直接解析内容，而构建时编译器将 `useIntlayer` 调用替换为组件使用的确切字典条目，因此未使用的键和未使用的语言都会被自动丢弃。[动态字典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dynamic_dictionaries/index.md) 会按语言环境拆分剩余内容。与常规替代方案相比，Intlayer 可将 bundle 和页面体积减少高达 50%。请参阅 [Bundle 体积优化](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/bundle_optimization.md) 和 [性能基准](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/benchmark/index.md)。
 
 </Question>
-
 <Question title="我可以从 i18next、next-intl 或 react-i18next 迁移而无需重写组件吗？">
 
 可以，有两条迁移路径。您可以使用 [i18next 迁移指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/migration_from_i18next_to_intlayer.md) 或 [next-intl 迁移指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/migration_from_next-intl_to_intlayer.md) 逐步迁移内容。或者，您可以完全保留当前的 API：[兼容性适配器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/index.md) 公开与 `i18next`、`react-i18next`、`next-intl`、`next-i18next`、`react-intl`、`use-intl`、`vue-i18n` 和 `Lingui` 完全相同的 API，但底层由 Intlayer 字典驱动，因此只需更改导入语句，组件代码无需修改。
 
 </Question>
-
 <Question title="我可以保留现有的 JSON 翻译文件吗？">
 
 可以。[JSON 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md) 将您的 `/messages/{locale}/{namespace}.json` 文件作为单一真实来源（source of truth），并双向生成 Intlayer 字典。[PO 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-po.md) 对 gettext 目录执行相同的操作，而 [按语言环境组织的文件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/per_locale_file.md) 允许您按语言拆分内容，而不是将所有语言打包到一个文件中。
 
 </Question>
-
 <Question title="我必须逐个键迁移我的内容吗？">
 
 不需要。运行 `npx intlayer extract`，Intlayer 会读取您的源码文件，提取面向用户的字符串，并在每个组件旁边生成 `.content` 文件，这样您只需审查 diff，而无需手动逐一复制字符串到语言目录中。请参阅 [extract 命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md)。
@@ -247,7 +243,6 @@ pnpm intlayer-editor start -e development
 如需全自动流程，[Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compiler.md) 可以在构建时对 JSX、TSX、Vue 和 Svelte 源码执行相同操作，在每次更改时自动生成字典，完全无需手动维护键名。它通过静态分析工作，因此仅在运行时存在的字符串无法被捕获，并且需要少量注解以区分用户文本和应用程序逻辑。
 
 </Question>
-
 <Question title="有哪些可用的编辑器和 AI 代理工具？">
 
 共有 5 个工具，均为可选：
@@ -259,37 +254,31 @@ pnpm intlayer-editor start -e development
 - **[ESLint 插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/eslint.md)**：`no-raw-text` 规则标记硬编码字符串，并提供针对静态字典键和未使用内容的额外规则。
 
 </Question>
-
 <Question title="可视化编辑器运行在哪里？">
 
 运行在您自己的基础设施上。它在 iframe 中加载您的应用程序并与本地编辑器服务器通信，因此您的内容永远不会离开您的本地环境。这使得无法将文案发送到第三方托管服务的敏感项目也能放心使用。
 
 </Question>
-
 <Question title="内容编辑人员需要懂编程吗？">
 
 不需要。他们只需打开站点，点击任意文本块即可在页面上就地修改。编辑器会自动解析是哪个字典条目支撑了该文本，并将更改准确写回正确的内容文件中，因此翻译人员无需知道文件路径或键名。
 
 </Question>
-
 <Question title="通过可视化编辑器修改会更改我的源代码文件吗？">
 
 是的，这正是其设计目的。更改会直接写入您代码库中的内容声明文件，因此它会作为正常的代码 diff 展示供您审查和提交，并且应用会重新构建以呈现最新修改。
 
 </Question>
-
 <Question title="编辑器显示空白页或拒绝加载我的网站，我应该检查什么？">
 
 编辑器通过 iframe 展示您的应用程序，因此您的内容安全策略 (CSP) 必须将编辑器的来源允许为 `frame-ancestors`（默认为 `http://localhost:8000`）。同时请确认编辑器配置中的 `applicationURL` 与您应用的实际服务地址完全一致。编辑器控制台会详细报告这两类错误。
 
 </Question>
-
 <Question title="我可以在生产环境中使用可视化编辑器吗？">
 
 它是专为开发和预发布 (staging) 环境设计的，在这类环境中编辑后触发重新构建是可以接受的。若要在无需重新部署的情况下直接修改线上运行中的内容，请使用 [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 及其远程字典功能。
 
 </Question>
-
 <Question title="可视化编辑器是免费的吗？">
 
 是的。可视化编辑器是开源项目的一部分，基于 Apache 2.0 许可证授权，包含商业用途。仅托管版 [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 属于付费服务，并且 CMS 也完全支持 [自托管](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/self_hosting.md)。

package/docs/zh/intlayer_with_adonisjs.md

@@ -331,25 +331,21 @@ AdonisJS 提供了 `@adonisjs/i18n`，它涵盖了 `resources/lang` 文件中的
 请参阅 [为什么选择 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/interest_of_intlayer.md)。
 
 </Question>
-
 <Question title="i18n 会给我的 AdonisJS 服务端体积增加多少？">
 
 极少。字典在构建前预先编译，仅包含您声明的语言环境，因此启动时无需加载整个大目录，处理请求路径时也无需读取文件系统。这在 Serverless 和 Edge 环境中尤为重要，因为体积直接决定冷启动耗时。请参阅 [Bundle 体积优化](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/bundle_optimization.md)。
 
 </Question>
-
 <Question title="我可以从 i18next 迁移而无需重写路由处理函数吗？">
 
 可以，有两条迁移路径。您可以使用 [i18next 迁移指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/migration_from_i18next_to_intlayer.md) 逐步迁移内容。或者，您可以完全保留当前的 API：[兼容性适配器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/index.md) 公开与 `i18next` 完全相同的 API，但底层由 Intlayer 字典驱动，因此只需更改导入语句，路由处理函数代码无需修改。
 
 </Question>
-
 <Question title="我可以保留现有的 JSON 翻译文件吗？">
 
 可以。[JSON 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md) 将您的 `/messages/{locale}/{namespace}.json` 文件作为单一真实来源（source of truth），并双向生成 Intlayer 字典。[PO 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-po.md) 对 gettext 目录执行相同的操作，而 [按语言环境组织的文件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/per_locale_file.md) 允许您按语言拆分内容，而不是将所有语言打包到一个文件中。
 
 </Question>
-
 <Question title="我必须逐个键迁移我的内容吗？">
 
 不需要。运行 `npx intlayer extract`，Intlayer 会读取您的源码文件，提取面向用户的字符串，并在每个组件旁边生成 `.content` 文件，这样您只需审查 diff，而无需手动逐一复制字符串到语言目录中。请参阅 [extract 命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md)。
@@ -357,7 +353,6 @@ AdonisJS 提供了 `@adonisjs/i18n`，它涵盖了 `resources/lang` 文件中的
 在同一项目的前端部分，[Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compiler.md) 则更进一步，可以在构建时直接从 JSX、TSX、Vue 或 Svelte 源码生成字典，使应用的前后端共享同一套内容层，完全无需手动维护键名。
 
 </Question>
-
 <Question title="有哪些可用的编辑器和 AI 代理工具？">
 
 共有 5 个工具，均为可选：
@@ -369,67 +364,56 @@ AdonisJS 提供了 `@adonisjs/i18n`，它涵盖了 `resources/lang` 文件中的
 - **[ESLint 插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/eslint.md)**：`no-raw-text` 规则标记硬编码字符串，并提供针对静态字典键和未使用内容的额外规则。
 
 </Question>
-
 <Question title="Intlayer 如何知道用哪种语言响应？">
 
 默认情况下，`adonis-intlayer` 读取传入请求的 `Accept-Language` 请求头，并选择最匹配的已声明语言环境，若无匹配则回退到默认语言环境。您可以通过 `routing.storage` 自定义来源，例如自定义标头或由前端设置的 Cookie，从而使 API 按照用户实际选择的语言响应，而非浏览器默认宣称的语言。请参阅 [配置参考](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。
 
 </Question>
-
 <Question title="语言环境在每个请求之间是否隔离？">
 
 是的。中间件会将活动语言环境限定在当前请求范围内，因此两个使用不同语言的并发请求绝不会互相读取或干扰对方的语言环境。这使得在服务内部调用 `t()` 和 `getIntlayer()` 具备完全的线程与并发安全性，而无需在每个函数中显式传递语言环境参数。
 
 </Question>
-
 <Question title="如何使用接收者的语言发送事务性邮件？">
 
 像声明其他内容一样在内容文件中声明邮件文本，然后使用 `getIntlayer` 针对接收者存储的语言环境进行解析，而不是使用请求的语言环境。这对于后台作业和队列处理至关重要，因为这类场景下语言属于用户数据库记录，并不存在传入请求标头可供读取。
 
 </Question>
-
 <Question title="如何本地化 API 错误消息？">
 
 在构建错误对象的代码位置使用 `t()` 包裹消息文本。当前活动的请求语言环境会直接将其解析，使客户端能够直接显示该文本，从而无需在前端维护一套冗余平行的错误码目录。
 
 </Question>
-
 <Question title="如何在控制器或服务中使用翻译？">
 
 使用您的字典键调用 `getIntlayer`，或者用 `t()` 包裹一段文本。活动语言环境来源于中间件安装的请求上下文，因此不需要注入服务，也不需要在参数中向下传递语言环境。
 
 </Question>
-
 <Question title="它是否适用于 Edge 模板？">
 
 可以。在控制器中解析内容并将其传递给视图，这样模板渲染的就是已经翻译好的值，而无需在模板内部自行解析键名。
 
 </Question>
-
 <Question title="如何使用 AI 自动翻译后端内容？">
 
 运行 `npx intlayer fill`，它会使用您选择的 LLM、您自己的提供商和 API 密钥填充缺失的翻译。添加 `--git-diff` 参数可以仅翻译当前分支修改过的内容。请参阅 [fill 命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md) 和 [CI/CD 集成](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/CI_CD.md)。
 
 </Question>
-
 <Question title="Intlayer 在服务端是否支持复数、性别和插值？">
 
 支持：包括 [复数形式](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/plurial.md)、[基于性别的内容](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/gender.md)、条件分支、用于插值变量的 [插入内容 (insertions)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/insertion.md)、用于邮件正文的 [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/markdown.md)，以及用于数字、日期和货币的 [格式化工具](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/formatters.md)。
 
 </Question>
-
 <Question title="我在服务端能获得 TypeScript 自动补全吗？">
 
 是的。Intlayer 会在 `./types/intlayer.d.ts` 中为您的字典生成类型定义，因此访问不存在的键会在编译期直接报错，而不会在运行时返回空字符串。在 CI 中运行 `npx intlayer test` 可在声明的语言环境缺失内容时使构建失败。
 
 </Question>
-
 <Question title="前端和后端可以共享相同的内容吗？">
 
 可以，这正是推荐的架构模式。`adonis-intlayer` 可以与 `react-intlayer`、`next-intlayer` 和 `vite-intlayer` 共同基于完全相同的声明内容工作，因此在 API 响应和页面展示中使用的文案只需声明一次。请参阅 [Intlayer 工作原理](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/how_works_intlayer.md)。
 
 </Question>
-
 <Question title="Intlayer 是免费且开源的吗？">
 
 是的，基于 Apache 2.0 许可证开源，包含商业用途。托管版 [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 是可选的付费服务，同时完全支持 [自托管](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/self_hosting.md)。

package/docs/zh/intlayer_with_analog.md

@@ -67,37 +67,31 @@ author: aymericzip
 Intlayer 经过优化，可与 Analog 完美配合，提供**多语言路由**、**SSR 支持**以及扩展国际化 (i18n) 所需的所有功能。
 
 </Accordion>
-
 <Accordion header="捆绑尺寸">
 
 不要将大量 JSON 文件加载到页面中，而只需加载必要的内容。 Intlayer 有助于**将捆绑包和页面大小减少多达 50%**。
 
 </Accordion>
-
 <Accordion header="可维护性">
 
 确定应用程序内容的范围**有利于大型应用程序的维护**。您可以复制或删除单个功能文件夹，而无需承担检查整个内容代码库的精神负担。此外，Intlayer 具有**完全类型化 (fully typed)**，以确保您的内容的准确性。
 
 </Accordion>
-
 <Accordion header="AI Agent">
 
 共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 </Accordion>
-
 <Accordion header="自动化">
 
 使用您选择的法学硕士，通过自动化在 CI/CD 管道中进行翻译，而费用由您的 AI 提供商承担。 Intlayer 还提供了一个**编译器**来自动提取内容，以及一个[网络平台](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)来帮助**在后台翻译**。
 
 </Accordion>
-
 <Accordion header="表现">
 
 将大量 JSON 文件连接到组件可能会导致性能和反应性问题。 Intlayer 可在构建时 (build time)优化您的内容加载。
 
 </Accordion>
-
 <Accordion header="使用 none-dev 进行扩展">
 
 Intlayer 不仅仅是一个 i18n 解决方案，还提供了一个**自托管的[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)**和一个**[完整的 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** 来帮助您管理多语言内容**实时**，与译员、文案人员和其他团队成员无缝协作。内容可以本地和/或远程存储。
@@ -105,14 +99,11 @@ Intlayer 不仅仅是一个 i18n 解决方案，还提供了一个**自托管的
 </Accordion>
 </AccordionGroup>
 
----
-
 ## 在 Analog 应用中设置 Intlayer 的分步指南
 
 请参阅 GitHub 上的 [Application Template](https://github.com/aymericzip/intlayer-analog-template)。
 
 <Steps>
-
 <Step number={1} title="安装依赖项">
 
 使用 npm 安装必要的包：
@@ -164,7 +155,6 @@ bun add intlayer angular-intlayer vite-intlayer
   将 Intlayer 与 Vite 集成的包。它提供了一个插件来处理内容声明文件，并为最佳性能设置别名。
 
 </Step>
-
 <Step number={2} title="配置你的项目">
 
 创建一个配置文件来配置应用的语言：
@@ -190,7 +180,6 @@ export default config;
 > 通过此配置文件，你可以设置本地化 URL、中间件重定向、cookie 名称、内容声明的位置和扩展名、禁用控制台中的 Intlayer 日志等。有关可用参数的完整列表，请参阅 [配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。
 
 </Step>
-
 <Step number={3} title="在你的 Vite 配置中集成 Intlayer">
 
 要将 Intlayer 与 Analog 集成，你需要使用 `vite-intlayer` 插件。
@@ -218,7 +207,6 @@ export default defineConfig(() => ({
 > `intlayer()` 插件使用 Intlayer 配置 Vite。它处理内容声明文件并为最佳性能设置别名。
 
 </Step>
-
 <Step number={4} title="声明你的内容">
 
 创建和管理内容声明以存储翻译：
@@ -252,7 +240,6 @@ export default appContent;
 > 有关更多详情，请参阅 [内容声明文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)。
 
 </Step>
-
 <Step number={5} title="在你的代码中使用 Intlayer">
 
 要在整个 Analog 应用中使用 Intlayer 的国际化功能，你需要在应用配置中提供 Intlayer。
@@ -292,7 +279,6 @@ export default class HomeComponent {
 Intlayer 内容作为 `Signal` 返回，所以你通过调用信号来访问值：`content().title`。
 
 </Step>
-
 <Step number={6} title="更改你的内容的语言" isOptional={true}>
 
 要更改内容的语言，你可以使用由 `useLocale` 函数提供的 `setLocale` 函数。这允许你设置应用的语言环境并相应地更新内容。
@@ -404,8 +390,6 @@ Intlayer 使用模块扩充 (module augmentation) 来利用 TypeScript 的优势
 
 有关如何使用该扩展的更多详细信息，请参考 [Intlayer VS Code 扩展文档](https://intlayer.org/doc/vs-code-extension)。
 
----
-
 ### 进一步探索
 
 要进一步探索，你可以实现 [可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md) 或使用 [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 外部化你的内容。
@@ -425,25 +409,21 @@ Analog 是基于 Vite 构建的 Angular 元框架，因此它继承了 Angular
 请参阅 [为什么选择 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/interest_of_intlayer.md) 以及 [Angular 指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_angular_21.md) 了解 Angular 专用 API。
 
 </Question>
-
 <Question title="i18n 会给我的 Analog bundle 体积增加多少？">
 
 远少于基于命名空间的方案，因为页面永远不会下载它不渲染的语言目录。服务端渲染的标记在服务端直接解析内容，构建时编译器将 `useIntlayer` 调用替换为组件使用的确切字典条目，因此未使用的键和未使用的语言都会被自动丢弃，并且 [动态字典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dynamic_dictionaries/index.md) 会按语言环境拆分剩余内容。与常规替代方案相比，Intlayer 可将 bundle 和页面体积减少高达 50%。请参阅 [Bundle 体积优化](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/bundle_optimization.md) 和 [性能基准](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/benchmark/index.md)。
 
 </Question>
-
 <Question title="我可以从 ngx-translate、Transloco 或 @angular/localize 迁移而无需重写模板吗？">
 
 基本可以。请按照 [ngx-translate 迁移指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/ngx-translate.md) 或 [Transloco 迁移指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/transloco.md) 迁移内容。您也可以逐步迁移：[JSON 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md) 将现有的 JSON 目录作为单一真实来源（source of truth），并生成 Intlayer 字典，使两个层在逐个组件迁移时保持同步。
 
 </Question>
-
 <Question title="我可以保留现有的 JSON 翻译文件吗？">
 
 可以。[JSON 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md) 将您的 `/messages/{locale}/{namespace}.json` 文件作为单一真实来源（source of truth），并双向生成 Intlayer 字典。[PO 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-po.md) 对 gettext 目录执行相同的操作，而 [按语言环境组织的文件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/per_locale_file.md) 允许您按语言拆分内容，而不是将所有语言打包到一个文件中。
 
 </Question>
-
 <Question title="我必须逐个键迁移我的内容吗？">
 
 不需要。运行 `npx intlayer extract`，Intlayer 会读取您的源码文件，提取面向用户的字符串，并在每个组件旁边生成 `.content` 文件，这样您只需审查 diff，而无需手动逐一复制字符串到语言目录中。请参阅 [extract 命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md)。
@@ -451,7 +431,6 @@ Analog 是基于 Vite 构建的 Angular 元框架，因此它继承了 Angular
 如需全自动流程，[Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compiler.md) 可以在构建时对 JSX、TSX、Vue 和 Svelte 源码执行相同操作，在每次更改时自动生成字典，完全无需手动维护键名。它通过静态分析工作，因此仅在运行时存在的字符串无法被捕获，并且需要少量注解以区分用户文本和应用程序逻辑。
 
 </Question>
-
 <Question title="有哪些可用的编辑器和 AI 代理工具？">
 
 共有 5 个工具，均为可选：
@@ -463,55 +442,46 @@ Analog 是基于 Vite 构建的 Angular 元框架，因此它继承了 Angular
 - **[ESLint 插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/eslint.md)**：`no-raw-text` 规则标记硬编码字符串，并提供针对静态字典键和未使用内容的额外规则。
 
 </Question>
-
 <Question title="我是否需要为每种语言分别构建一个产物？">
 
 不需要。那是 `@angular/localize` 的模式，即每个语言环境都被编译为独立 bundle 并单独部署。而在 Intlayer 中，单次构建即可支持所有声明的语言环境，活动语言在运行时直接从 URL、Cookie 或 `Accept-Language` 请求头中解析。
 
 </Question>
-
 <Question title="Intlayer 是否支持 Angular signals 和独立组件 (standalone components)？">
 
 支持。内容通过 signals 公开，因此当语言环境更改时模板会自动重新渲染而无需刷新页面，并且 Provider 可以像其他独立 Provider 一样直接注册。
 
 </Question>
-
 <Question title="如何在运行时切换语言？">
 
 第 6 步对此进行了介绍。`useLocale` 公开活动语言环境、声明的语言环境以及持久化选择的设置函数，而 `getLocalizedUrl` 会重写当前路径，使用户在切换后保留在相同路由上。
 
 </Question>
-
 <Question title="它是否适用于 Analog 服务端渲染 (SSR) 和 Vite？">
 
 是的。`intlayer()` Vite 插件负责编译内容并在开发期间进行监听，语言环境在服务端直接解析，因此首次 HTML 响应就已经对应了正确的语言。预渲染路由则在构建时解析内容。
 
 </Question>
-
 <Question title="如何使用 AI 自动翻译应用？">
 
 运行 `npx intlayer fill`。它会使用您选择的 LLM、您自己的提供商和 API 密钥填充缺失的翻译，并且 `--git-diff` 参数可将处理范围限制在当前分支修改的内容。请参阅 [fill 命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md) 和 [CI/CD 集成](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/CI_CD.md)。
 
 </Question>
-
 <Question title="Intlayer 是否支持复数、性别和富文本？">
 
 支持：包括 [复数形式](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/plurial.md)、[基于性别的内容](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/gender.md)、条件渲染、插值用的 [插入内容 (insertions)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/insertion.md)、用于长文本的 [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/markdown.md)，以及用于数字、日期和货币的 [格式化工具](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/formatters.md)。
 
 </Question>
-
 <Question title="如何在发布前捕获缺失的翻译？">
 
 在 CI 中运行 `npx intlayer test`。当声明的语言环境存在缺失内容时构建将失败。[VS Code 扩展](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/vs_code_extension.md) 会在您输入时实时报告相同错误。请参阅 [测试您的内容](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/testing.md)。
 
 </Question>
-
 <Question title="翻译人员如何无需接触代码即可编辑内容？">
 
 可以通过自托管的 [可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)（任何人都可以直接在运行中的应用上就地修改文案），或通过 [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 进行无需重新部署的内容外部化更新。
 
 </Question>
-
 <Question title="Intlayer 是免费且开源的吗？">
 
 是的，基于 Apache 2.0 许可证开源，包含商业用途。托管版 CMS 是可选的付费服务，同时完全支持 [自托管](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/self_hosting.md)。