@intlayer/docs 7.5.9 → 7.5.11

package/docs/zh/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: 列出内容声明文件
 description: 了解如何列出项目中的所有内容声明文件。
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: 为 list 命令添加绝对路径输出选项
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: 为 list 命令添加 JSON 输出选项
 ---
 
 # 列出内容声明文件
@@ -27,14 +34,36 @@ npx intlayer content list
 
 此命令显示项目中所有内容声明文件，展示它们的字典键和文件路径。它有助于概览所有内容文件，并验证它们是否被 Intlayer 正确发现。
 
+## 参数：
+
+- **`--json`**: 以 JSON 格式输出结果，而不是格式化文本。对脚本编写和程序化访问很有用。
+
+  > 示例: `npx intlayer content list --json`
+
 ## 示例：
 
+### 列出内容声明文件：
+
 ```bash
 npx intlayer content list
 ```
 
+### 以 JSON 格式输出：
+
+```bash
+npx intlayer content list --json
+```
+
+### 以绝对路径输出：
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## 示例输出：
 
+### 格式化输出：
+
 ```bash
 npx intlayer content list
 Content declaration files:
@@ -45,6 +74,14 @@ Content declaration files:
 内容声明文件总数：3
 ```
 
+### JSON 输出：
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
 此命令将输出：
 
 - 所有内容声明文件的格式化列表，包含它们的键和相对文件路径

package/docs/zh/cli/list_projects.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: 列出 Intlayer 项目
+description: 了解如何在目录或 git 仓库中列出所有 Intlayer 项目。
+keywords:
+  - List
+  - Projects
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: 向 list projects 命令添加绝对路径输出选项
+---
+
+# 列出 Intlayer 项目
+
+```bash
+npx intlayer projects list
+```
+
+此命令通过查找包含 Intlayer 配置文件的目录来搜索并列出所有 Intlayer 项目。对于在 monorepo、workspace 或 git 仓库中发现所有 Intlayer 项目非常有用。
+
+## 别名：
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## 参数：
+
+- **`--base-dir [path]`**：指定要从其开始搜索的基目录。默认是当前工作目录。
+
+  > 示例：`npx intlayer projects list --base-dir /path/to/workspace`
+
+  > 示例：`npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**：从 git 根目录开始搜索，而不是基目录。这对于在 monorepo 或 git 仓库中查找所有 Intlayer 项目很有用。
+
+  > 示例：`npx intlayer projects list --git-root`
+
+- **`--json`**：以 JSON 格式输出结果，而不是格式化文本。对脚本编写和程序化访问很有用。
+
+  > 示例：`npx intlayer projects list --json`
+
+- **`--absolute`**：以绝对路径输出结果，而不是相对路径。
+
+  > 示例：`npx intlayer projects list --absolute`
+
+## 工作原理：
+
+该命令将在指定目录（如果使用了 `--git-root` 则在 git 根目录）中搜索 Intlayer 配置文件。它会查找以下配置文件模式：
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+每个包含上述任一文件的目录都被视为一个 Intlayer 项目，并将在输出中列出。
+
+## 示例：
+
+### 列出当前目录中的项目：
+
+```bash
+npx intlayer projects list
+```
+
+### 在特定目录中列出项目：
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### 列出 git 仓库中的所有项目：
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### 使用快捷别名：
+
+```bash
+npx intlayer pl --git-root
+```
+
+### 以 JSON 格式输出：
+
+```bash
+npx intlayer projects list --json
+```
+
+## 示例输出：
+
+### 格式化输出：
+
+```bash
+$ npx intlayer projects list --git-root
+
+Found 3 Intlayer project(s):
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### JSON 输出：
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## 使用场景：
+
+- **Monorepo 管理**：在 monorepo 结构中发现所有 Intlayer 项目
+- **项目发现**：在工作区中查找所有启用 Intlayer 的项目
+- **CI/CD**：在自动化工作流中验证 Intlayer 项目
+- **文档**：生成列出所有使用 Intlayer 的项目的文档
+
+输出提供每个项目目录的绝对路径，便于导航或对多个 Intlayer 项目进行脚本化操作。

package/docs/zh/cli/push.md

@@ -23,7 +23,7 @@ slugs:
 npx intlayer dictionary push
 ```
 
-如果已安装 [intlayer 编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)，您也可以将词典推送到编辑器。此命令将使词典可用于[编辑器](https://intlayer.org/dashboard)。通过这种方式，您可以与团队共享词典，并在不修改应用代码的情况下编辑内容。
+如果已安装 [intlayer 编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)，您也可以将词典推送到编辑器。此命令将使词典可用于[编辑器](https://app.intlayer.org/)。通过这种方式，您可以与团队共享词典，并在不修改应用代码的情况下编辑内容。
 
 ## 别名：
 

package/docs/zh/configuration.md

@@ -246,14 +246,14 @@ module.exports = config;
 - **clientId**:
   - _类型_：`string` | `undefined`
   - _默认值_：`undefined`
-  - _描述_: clientId 和 clientSecret 允许 intlayer 包使用 oAuth2 认证与后端进行身份验证。访问令牌用于验证与项目相关的用户。要获取访问令牌，请访问 https://intlayer.org/dashboard/project 并创建一个账户。
+  - _描述_: clientId 和 clientSecret 允许 intlayer 包使用 oAuth2 认证与后端进行身份验证。访问令牌用于验证与项目相关的用户。要获取访问令牌，请访问 https://app.intlayer.org/project 并创建一个账户。
   - _示例_: `true`
   - _注意_: 重要提示：clientId 和 clientSecret 应保持机密，不得公开共享。请确保将它们保存在安全的位置，例如环境变量中。
 
 - **clientSecret**:
   - _类型_: `string` | `undefined`
   - _默认值_: `undefined`
-  - _描述_: clientId 和 clientSecret 允许 intlayer 包使用 oAuth2 认证与后端进行身份验证。访问令牌用于验证与项目相关的用户。要获取访问令牌，请访问 https://intlayer.org/dashboard/project 并创建一个账户。
+  - _描述_: clientId 和 clientSecret 允许 intlayer 包使用 oAuth2 认证与后端进行身份验证。访问令牌用于验证与项目相关的用户。要获取访问令牌，请访问 https://app.intlayer.org/project 并创建一个账户。
   - _示例_: `true`
   - _注意_: 重要提示：clientId 和 clientSecret 应保持机密，不得公开共享。请确保将它们保存在安全的位置，例如环境变量中。
 
@@ -469,7 +469,7 @@ module.exports = config;
 
 控制 Intlayer AI 功能的设置，包括提供商、模型和 API 密钥。
 
-如果您已使用访问密钥在[Intlayer 控制面板](https://intlayer.org/dashboard/project)注册，则此配置是可选的。Intlayer 会自动管理最有效且具有成本效益的 AI 解决方案以满足您的需求。使用默认选项可确保更好的长期可维护性，因为 Intlayer 会持续更新以使用最相关的模型。
+如果您已使用访问密钥在[Intlayer 控制面板](https://app.intlayer.org/project)注册，则此配置是可选的。Intlayer 会自动管理最有效且具有成本效益的 AI 解决方案以满足您的需求。使用默认选项可确保更好的长期可维护性，因为 Intlayer 会持续更新以使用最相关的模型。
 
 如果您希望使用自己的 API 密钥或特定模型，可以定义自定义的 AI 配置。
 此 AI 配置将在整个 Intlayer 环境中全局使用。CLI 命令将使用这些设置作为命令的默认值（例如 `fill`），同时 SDK、可视化编辑器和 CMS 也会使用这些默认值。您可以通过命令参数覆盖这些默认值以满足特定用例。

package/docs/zh/interest_of_intlayer.md

@@ -226,7 +226,7 @@ const ComponentExample = () => {
 | 功能                                                                                                                   | 描述                                                                                                                                                                                                                                                                                                                                                         |
 | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | ![功能](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **跨框架支持**<br><br>Intlayer 兼容所有主流框架和库，包括 Next.js、React、Vite、Vue.js、Nuxt、Preact、Express 等。                                                                                                                                                                                                                                           |
-| ![功能](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.png?raw=true)       | **基于JavaScript的内容管理**<br><br>利用JavaScript的灵活性，高效地定义和管理您的内容。<br><br> - [内容声明](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                        |
+| ![功能](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **基于JavaScript的内容管理**<br><br>利用JavaScript的灵活性，高效地定义和管理您的内容。<br><br> - [内容声明](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                        |
 | ![功能](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **每语言内容声明文件**<br><br>通过在自动生成之前只声明一次内容，加快您的开发速度。<br><br> - [每语言内容声明文件](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                          |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                   | **类型安全环境**<br><br>利用 TypeScript 确保您的内容定义和代码无错误，同时享受 IDE 自动补全的便利。<br><br> - [TypeScript 配置](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                    |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                      | **简化设置**<br><br>通过最少的配置快速启动运行。轻松调整国际化、路由、AI、构建和内容处理的设置。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                  |

package/docs/zh/intlayer_CMS.md

@@ -71,6 +71,26 @@ Intlayer 区分“本地”字典和“远程”字典。
 
 ## 配置
 
+运行以下命令登录 Intlayer CMS：
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+这将打开您的默认浏览器以完成身份验证过程并接收使用 Intlayer 服务所需的凭据（客户端 ID 和客户端密钥）。
+
 在您的 Intlayer 配置文件中，您可以自定义 CMS 设置：
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"
@@ -92,7 +112,7 @@ const config: IntlayerConfig = {
      *
      * 启用编辑器需要客户端 ID 和客户端密钥。
      * 它们用于识别正在编辑内容的用户。
-     * 可以通过在 Intlayer 控制面板 - 项目 (https://intlayer.org/dashboard/projects) 中创建新客户端来获取。
+     * 可以通过在 Intlayer 控制面板 - 项目 (https://app.intlayer.org/projects) 中创建新客户端来获取。
      * clientId: process.env.INTLAYER_CLIENT_ID,
      * clientSecret: process.env.INTLAYER_CLIENT_SECRET,
      */
@@ -142,7 +162,7 @@ const config = {
      *
      * 启用编辑器需要客户端 ID 和客户端密钥。
      * 它们用于识别正在编辑内容的用户。
-     * 可以通过在 Intlayer 仪表板 - 项目 (https://intlayer.org/dashboard/projects) 中创建新客户端来获取。
+     * 可以通过在 Intlayer 仪表板 - 项目 (https://app.intlayer.org/projects) 中创建新客户端来获取。
      * clientId: process.env.INTLAYER_CLIENT_ID,
      * clientSecret: process.env.INTLAYER_CLIENT_SECRET,
      */
@@ -192,7 +212,7 @@ const config = {
      *
      * 启用编辑器需要客户端ID和客户端密钥。
      * 它们用于识别正在编辑内容的用户。
-     * 可以通过在 Intlayer 控制面板 - 项目 (https://intlayer.org/dashboard/projects) 中创建新客户端来获取。
+     * 可以通过在 Intlayer 控制面板 - 项目 (https://app.intlayer.org/projects) 中创建新客户端来获取。
      * clientId: process.env.INTLAYER_CLIENT_ID,
      * clientSecret: process.env.INTLAYER_CLIENT_SECRET,
      */
@@ -224,7 +244,7 @@ const config = {
 module.exports = config;
 ```
 
-> 如果您没有客户端 ID 和客户端密钥，可以通过在[Intlayer 控制面板 - 项目](https://intlayer.org/dashboard/projects)中创建新客户端来获取。
+> 如果您没有客户端 ID 和客户端密钥，可以通过在[Intlayer 控制面板 - 项目](https://app.intlayer.org/projects)中创建新客户端来获取。
 
 > 要查看所有可用参数，请参考[配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。
 
@@ -264,7 +284,7 @@ npx intlayer dictionary push -d my-first-dictionary-key --env production
 
 ### 编辑字典
 
-然后，您将能够在 [Intlayer CMS](https://intlayer.org/dashboard/content) 中查看和管理您的字典。
+然后，您将能够在 [Intlayer CMS](https://app.intlayer.org/content) 中查看和管理您的字典。
 
 ## 实时同步
 

package/docs/zh/intlayer_with_express.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - express
+applicationTemplate: https://github.com/aymericzip/intlayer-express-template
 history:
   - version: 7.5.9
     date: 2025-12-30