@intlayer/docs 7.5.0-canary.0 → 7.5.0-canary.1

package/docs/zh/cli/login.md

@@ -0,0 +1,182 @@
+---
+createdAt: 2025-12-16
+updatedAt: 2025-12-16
+title: CLI - 登录
+description: 了解如何使用 Intlayer CLI 的 login 命令与 Intlayer CMS 进行身份验证并获取访问凭证。
+keywords:
+  - CLI
+  - 登录
+  - 认证
+  - CMS
+  - Intlayer
+  - 凭证
+slugs:
+  - doc
+  - concept
+  - cli
+  - login
+---
+
+# Intlayer CLI 登录命令
+
+---
+
+## 描述
+
+Intlayer CLI 的 `login` 命令允许您对 Intlayer CMS 进行身份验证。该命令会自动打开您的默认浏览器以完成身份验证流程，并接收使用 Intlayer 服务所需的凭证（Client ID 和 Client Secret）。
+
+## 用法
+
+```bash
+npx intlayer login [options]
+```
+
+或
+
+```bash
+intlayer login [options]
+```
+
+## 选项
+
+### `--cms-url <url>`
+
+指定用于身份验证的 Intlayer CMS 的 URL。
+
+- **类型**: `string`
+- **默认**: 在 `intlayer.config.*` 中配置的值，或 `https://intlayer.org`
+- **示例**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### 配置选项
+
+您还可以使用常见的配置选项：
+
+- `--env-file <path>`：环境文件的路径
+- `-e, --env <env>`：执行环境
+- `--base-dir <dir>`：项目的基目录
+- `--verbose`：启用详细输出（默认：true）
+- `--prefix <prefix>`：日志前缀
+
+## 工作原理
+
+1. **启动本地服务器**：该命令在一个随机端口上启动本地 HTTP 服务器，以从 CMS 接收凭证
+
+指定要用于身份验证的 Intlayer CMS 的 URL。
+
+- **类型**: `string`
+- **默认**: 在 `intlayer.config.*` 中配置的值，或 `https://intlayer.org`
+- **示例**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### 配置选项
+
+您还可以使用常用的配置选项：
+
+- `--env-file <path>`: 环境文件的路径
+- `-e, --env <env>`: 执行环境
+- `--base-dir <dir>`: 项目的基目录
+- `--verbose`: 启用详细输出（默认：true）
+- `--prefix <prefix>`: 日志前缀
+
+## 工作原理
+
+1. **启动本地服务器**：该命令在随机端口启动一个本地 HTTP 服务器以接收来自 CMS 的凭证
+2. **Browser Opening**：该命令会自动在你的默认浏览器中打开 CMS 的登录 URL
+3. **Authentication**：在浏览器中使用你的 Intlayer 帐户完成身份验证
+4. **Credentials Reception**：本地服务器从 CMS 接收 Client ID 和 Client Secret
+5. **Instructions**：该命令显示在项目中配置凭证的说明
+
+## 输出
+
+登录成功后，命令将显示：
+
+1. **接收到的凭证**（Client ID 和 Client Secret）
+2. **`.env` 文件的说明**：
+
+```bash
+INTLAYER_CLIENT_ID=your_client_id
+INTLAYER_CLIENT_SECRET=your_client_secret
+```
+
+3. **Intlayer 配置文件的说明**：
+
+```typescript
+{
+  editor: {
+    cmsURL: 'https://intlayer.org',
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+}
+```
+
+## 手动配置
+
+如果浏览器没有自动打开，您可以手动访问终端中显示的 URL。
+
+## 示例
+
+### 使用自定义 CMS URL 登录
+
+```bash
+npx intlayer login --cms-url https://custom-cms.example.com
+```
+
+### 使用特定环境文件登录
+
+```bash
+npx intlayer login --env-file .env.production
+```
+
+### 以详细模式登录
+
+```bash
+npx intlayer login --verbose
+```
+
+## 故障排除
+
+### 浏览器未打开
+
+如果浏览器没有自动打开，请复制终端中显示的 URL 并在浏览器中手动打开。
+
+### 连接问题
+
+如果遇到连接问题，请验证：
+
+1. 确认 CMS URL 是否正确
+2. 确认您的网络连接正常工作
+3. 确认没有防火墙阻止连接
+
+### 未收到凭证
+
+如果未收到凭证：
+
+1. 确保在浏览器中完成了身份验证流程
+2. 验证本地端口未被阻塞
+3. 重新尝试该命令
+
+## 后续步骤
+
+完成登录后：
+
+1. 将凭证添加到您的 `.env` 文件中
+2. 在 `intlayer.config.*` 文件中配置这些凭证
+3. 使用 CLI 命令管理您的词典：
+   - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/push.md) - 将词典推送到 CMS
+   - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/pull.md) - 从 CMS 拉取词典
+   - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md) - 填充缺失的翻译
+   - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md) - 填充缺失的翻译
+
+## 另请参阅
+
+- [CLI 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/index.md)
+- [Intlayer 配置](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)

package/docs/zh/configuration.md

@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 7.5.0
+    date: 2025-12-17
+    changes: 添加 `buildMode` 选项
   - version: 6.0.0
     date: 2025-09-16
     changes: 添加 `live` 导入模式
@@ -528,6 +531,15 @@ Intlayer 支持多个 AI 提供商，以增强灵活性和选择。目前支持
 
 #### 属性
 
+- **mode**：
+  - _类型_：`'auto' | 'manual'`
+  - _默认值_：`'auto'`
+  - _描述_：控制构建的模式。
+  - _示例_：`'manual'`
+  - _注意_：如果为 'auto'，构建将在应用程序构建时自动启用。
+  - _注意_：如果为 'manual'，构建仅在执行构建命令时设置。
+  - _注意_：可用于禁用字典构建，例如当应避免在 Node.js 环境中执行时。
+
 - **optimize**：
   - _类型_：`boolean`
   - _默认值_：`process.env.NODE_ENV === 'production'`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "7.5.0-canary.0",
+  "version": "7.5.0-canary.1",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,23 +73,23 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "7.5.0-canary.0",
-    "@intlayer/core": "7.5.0-canary.0",
-    "@intlayer/types": "7.5.0-canary.0"
+    "@intlayer/config": "7.5.0-canary.1",
+    "@intlayer/core": "7.5.0-canary.1",
+    "@intlayer/types": "7.5.0-canary.1"
   },
   "devDependencies": {
-    "@intlayer/api": "7.5.0-canary.0",
-    "@intlayer/cli": "7.5.0-canary.0",
-    "@types/node": "24.10.1",
+    "@intlayer/api": "7.5.0-canary.1",
+    "@intlayer/cli": "7.5.0-canary.1",
+    "@types/node": "25.0.2",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
     "fast-glob": "3.3.3",
     "rimraf": "6.1.2",
-    "tsdown": "0.16.8",
+    "tsdown": "0.18.0",
     "tsx": "^4.20.6",
     "typescript": "5.9.3",
-    "vitest": "4.0.15"
+    "vitest": "4.0.16"
   },
   "engines": {
     "node": ">=14.18"

package/src/generated/docs.entry.ts

@@ -300,6 +300,25 @@ export const docsEntry = {
     id: readLocale('cli/live.md', 'id'),
     vi: readLocale('cli/live.md', 'vi'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './docs/en/cli/login.md': {
+    en: readLocale('cli/login.md', 'en'),
+    ru: readLocale('cli/login.md', 'ru'),
+    ja: readLocale('cli/login.md', 'ja'),
+    fr: readLocale('cli/login.md', 'fr'),
+    ko: readLocale('cli/login.md', 'ko'),
+    zh: readLocale('cli/login.md', 'zh'),
+    es: readLocale('cli/login.md', 'es'),
+    de: readLocale('cli/login.md', 'de'),
+    ar: readLocale('cli/login.md', 'ar'),
+    it: readLocale('cli/login.md', 'it'),
+    'en-GB': readLocale('cli/login.md', 'en-GB'),
+    pt: readLocale('cli/login.md', 'pt'),
+    hi: readLocale('cli/login.md', 'hi'),
+    tr: readLocale('cli/login.md', 'tr'),
+    pl: readLocale('cli/login.md', 'pl'),
+    id: readLocale('cli/login.md', 'id'),
+    vi: readLocale('cli/login.md', 'vi'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './docs/en/cli/pull.md': {
     en: readLocale('cli/pull.md', 'en'),
     ru: readLocale('cli/pull.md', 'ru'),