@intlayer/docs 8.0.5 → 8.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (154) hide show
  1. package/dist/cjs/generated/docs.entry.cjs +20 -20
  2. package/dist/cjs/generated/docs.entry.cjs.map +1 -1
  3. package/dist/esm/generated/docs.entry.mjs +20 -20
  4. package/dist/esm/generated/docs.entry.mjs.map +1 -1
  5. package/dist/types/generated/docs.entry.d.ts +1 -1
  6. package/dist/types/generated/docs.entry.d.ts.map +1 -1
  7. package/docs/ar/agent_skills.md +69 -0
  8. package/docs/ar/cli/extract.md +65 -0
  9. package/docs/ar/cli/index.md +1 -1
  10. package/docs/ar/cli/sdk.md +2 -2
  11. package/docs/ar/configuration.md +16 -3
  12. package/docs/ar/packages/intlayer-cli.md +9 -9
  13. package/docs/ar/per_locale_file.md +18 -0
  14. package/docs/de/agent_skills.md +28 -12
  15. package/docs/de/cli/extract.md +65 -0
  16. package/docs/de/cli/index.md +1 -1
  17. package/docs/de/cli/sdk.md +2 -2
  18. package/docs/de/configuration.md +16 -3
  19. package/docs/de/intlayer_with_analog.md +1 -1
  20. package/docs/de/packages/intlayer-cli.md +9 -9
  21. package/docs/de/per_locale_file.md +18 -0
  22. package/docs/en/agent_skills.md +28 -12
  23. package/docs/en/cli/extract.md +65 -0
  24. package/docs/en/cli/index.md +3 -3
  25. package/docs/en/cli/sdk.md +2 -2
  26. package/docs/en/configuration.md +15 -3
  27. package/docs/en/packages/intlayer-cli.md +9 -9
  28. package/docs/en/per_locale_file.md +1 -1
  29. package/docs/en-GB/agent_skills.md +69 -0
  30. package/docs/en-GB/cli/extract.md +65 -0
  31. package/docs/en-GB/cli/index.md +1 -1
  32. package/docs/en-GB/cli/sdk.md +2 -2
  33. package/docs/en-GB/configuration.md +15 -3
  34. package/docs/en-GB/packages/intlayer-cli.md +9 -9
  35. package/docs/en-GB/per_locale_file.md +18 -0
  36. package/docs/es/agent_skills.md +28 -12
  37. package/docs/es/cli/extract.md +65 -0
  38. package/docs/es/cli/index.md +1 -1
  39. package/docs/es/cli/sdk.md +2 -2
  40. package/docs/es/configuration.md +16 -3
  41. package/docs/es/intlayer_with_analog.md +1 -1
  42. package/docs/es/packages/intlayer-cli.md +9 -9
  43. package/docs/es/per_locale_file.md +18 -0
  44. package/docs/fr/agent_skills.md +28 -12
  45. package/docs/fr/cli/extract.md +65 -0
  46. package/docs/fr/cli/index.md +1 -1
  47. package/docs/fr/cli/sdk.md +2 -2
  48. package/docs/fr/configuration.md +16 -3
  49. package/docs/fr/intlayer_with_analog.md +1 -1
  50. package/docs/fr/packages/intlayer-cli.md +9 -9
  51. package/docs/fr/per_locale_file.md +18 -0
  52. package/docs/hi/agent_skills.md +69 -0
  53. package/docs/hi/cli/extract.md +65 -0
  54. package/docs/hi/cli/index.md +1 -1
  55. package/docs/hi/cli/sdk.md +2 -2
  56. package/docs/hi/configuration.md +16 -3
  57. package/docs/hi/packages/intlayer-cli.md +9 -9
  58. package/docs/hi/per_locale_file.md +18 -2
  59. package/docs/id/agent_skills.md +69 -0
  60. package/docs/id/cli/extract.md +65 -0
  61. package/docs/id/cli/index.md +1 -1
  62. package/docs/id/cli/sdk.md +2 -2
  63. package/docs/id/configuration.md +16 -3
  64. package/docs/id/packages/intlayer-cli.md +9 -9
  65. package/docs/id/per_locale_file.md +18 -0
  66. package/docs/it/agent_skills.md +28 -12
  67. package/docs/it/cli/extract.md +65 -0
  68. package/docs/it/cli/index.md +1 -1
  69. package/docs/it/cli/sdk.md +2 -2
  70. package/docs/it/configuration.md +16 -3
  71. package/docs/it/packages/intlayer-cli.md +9 -9
  72. package/docs/it/per_locale_file.md +18 -2
  73. package/docs/ja/agent_skills.md +28 -12
  74. package/docs/ja/cli/extract.md +65 -0
  75. package/docs/ja/cli/index.md +1 -1
  76. package/docs/ja/cli/sdk.md +2 -2
  77. package/docs/ja/configuration.md +16 -3
  78. package/docs/ja/packages/intlayer-cli.md +9 -9
  79. package/docs/ja/per_locale_file.md +18 -0
  80. package/docs/ko/agent_skills.md +28 -12
  81. package/docs/ko/cli/extract.md +65 -0
  82. package/docs/ko/cli/index.md +1 -1
  83. package/docs/ko/cli/sdk.md +2 -2
  84. package/docs/ko/configuration.md +16 -3
  85. package/docs/ko/packages/intlayer-cli.md +9 -9
  86. package/docs/ko/per_locale_file.md +18 -0
  87. package/docs/pl/agent_skills.md +69 -0
  88. package/docs/pl/cli/extract.md +65 -0
  89. package/docs/pl/cli/index.md +1 -1
  90. package/docs/pl/cli/sdk.md +2 -2
  91. package/docs/pl/configuration.md +16 -3
  92. package/docs/pl/packages/intlayer-cli.md +9 -9
  93. package/docs/pl/per_locale_file.md +18 -0
  94. package/docs/pt/agent_skills.md +29 -13
  95. package/docs/pt/cli/extract.md +65 -0
  96. package/docs/pt/cli/index.md +1 -1
  97. package/docs/pt/cli/sdk.md +2 -2
  98. package/docs/pt/configuration.md +16 -3
  99. package/docs/pt/packages/intlayer-cli.md +9 -9
  100. package/docs/pt/per_locale_file.md +18 -0
  101. package/docs/ru/agent_skills.md +69 -0
  102. package/docs/ru/cli/extract.md +65 -0
  103. package/docs/ru/cli/index.md +1 -1
  104. package/docs/ru/cli/sdk.md +2 -2
  105. package/docs/ru/configuration.md +16 -3
  106. package/docs/ru/packages/intlayer-cli.md +9 -9
  107. package/docs/ru/per_locale_file.md +18 -2
  108. package/docs/tr/agent_skills.md +69 -0
  109. package/docs/tr/cli/extract.md +65 -0
  110. package/docs/tr/cli/index.md +1 -1
  111. package/docs/tr/cli/sdk.md +2 -2
  112. package/docs/tr/configuration.md +16 -3
  113. package/docs/tr/packages/intlayer-cli.md +9 -9
  114. package/docs/tr/per_locale_file.md +18 -0
  115. package/docs/uk/agent_skills.md +69 -0
  116. package/docs/uk/cli/extract.md +65 -0
  117. package/docs/uk/cli/index.md +1 -1
  118. package/docs/uk/cli/sdk.md +1 -1
  119. package/docs/uk/configuration.md +15 -3
  120. package/docs/uk/packages/intlayer-cli.md +9 -9
  121. package/docs/vi/agent_skills.md +69 -0
  122. package/docs/vi/cli/extract.md +65 -0
  123. package/docs/vi/cli/index.md +1 -1
  124. package/docs/vi/cli/sdk.md +2 -2
  125. package/docs/vi/configuration.md +16 -3
  126. package/docs/vi/packages/intlayer-cli.md +9 -9
  127. package/docs/vi/per_locale_file.md +18 -0
  128. package/docs/zh/agent_skills.md +28 -12
  129. package/docs/zh/cli/extract.md +65 -0
  130. package/docs/zh/cli/index.md +1 -1
  131. package/docs/zh/cli/sdk.md +2 -2
  132. package/docs/zh/configuration.md +15 -2
  133. package/docs/zh/packages/intlayer-cli.md +9 -9
  134. package/docs/zh/per_locale_file.md +18 -0
  135. package/package.json +7 -7
  136. package/src/generated/docs.entry.ts +20 -20
  137. package/docs/ar/cli/transform.md +0 -65
  138. package/docs/de/cli/transform.md +0 -65
  139. package/docs/en/cli/transform.md +0 -65
  140. package/docs/en-GB/cli/transform.md +0 -65
  141. package/docs/es/cli/transform.md +0 -65
  142. package/docs/fr/cli/transform.md +0 -65
  143. package/docs/hi/cli/transform.md +0 -65
  144. package/docs/id/cli/transform.md +0 -65
  145. package/docs/it/cli/transform.md +0 -65
  146. package/docs/ja/cli/transform.md +0 -65
  147. package/docs/ko/cli/transform.md +0 -65
  148. package/docs/pl/cli/transform.md +0 -65
  149. package/docs/pt/cli/transform.md +0 -65
  150. package/docs/ru/cli/transform.md +0 -65
  151. package/docs/tr/cli/transform.md +0 -65
  152. package/docs/uk/cli/transform.md +0 -65
  153. package/docs/vi/cli/transform.md +0 -65
  154. package/docs/zh/cli/transform.md +0 -65
@@ -0,0 +1,69 @@
1
+ ---
2
+ createdAt: 2026-02-09
3
+ updatedAt: 2026-02-12
4
+ title: Kỹ năng Agent
5
+ description: Tìm hiểu cách sử dụng Intlayer Agent Skills để cải thiện khả năng AI agent hiểu về dự án của bạn, bao gồm các hướng dẫn thiết lập toàn diện cho Metadata, Sitemaps và Server Actions.
6
+ keywords:
7
+ - Intlayer
8
+ - Kỹ năng Agent
9
+ - AI Agent
10
+ - Quốc tế hóa
11
+ - Tài liệu
12
+ slugs:
13
+ - doc
14
+ - agent_skills
15
+ history:
16
+ - version: 8.1.0
17
+ date: 2026-02-09
18
+ changes: Init history
19
+ ---
20
+
21
+ ## Lệnh `intlayer init skills`
22
+
23
+ Lệnh `intlayer init skills` là cách dễ nhất để thiết lập agent skills trong dự án của bạn. Nó phát hiện môi trường và cài đặt các tập tin cấu hình cần thiết cho các nền tảng bạn ưu tiên.
24
+
25
+ ```bash
26
+ npx intlayer init skills
27
+ ```
28
+
29
+ Khi bạn chạy lệnh này, nó sẽ:
30
+
31
+ 1. Phát hiện framework mà bạn đang sử dụng (ví dụ: Next.js, React, Vite).
32
+ 2. Hỏi bạn muốn cài kỹ năng cho nền tảng nào (Cursor, Windsurf, VS Code, OpenCode, Claude Code, GitHub Copilot Workspace, v.v.).
33
+ 3. Tạo các tệp cấu hình cần thiết (chẳng hạn `.cursor/skills/intlayer_next_js/SKILL.md`, `.windsurf/skills/intlayer_next_js/SKILL.md`, `.opencode/skills/intlayer_next_js/SKILL.md`, `.vscode/mcp.json`, v.v.).
34
+
35
+ ## Các nền tảng được hỗ trợ
36
+
37
+ Intlayer cung cấp tài liệu cụ thể cho từng framework (Cài đặt, Sử dụng, Metadata, Sitemap, Server Actions, v.v.) để giúp AI agent hiểu cách làm việc với Intlayer trong dự án cụ thể của bạn. Các kỹ năng này được thiết kế để hướng dẫn agent vượt qua các phức tạp của quốc tế hóa, đảm bảo nó tuân theo các mô hình và thực hành tốt nhất.
38
+
39
+ Intlayer hỗ trợ tích hợp với các nền tảng sau:
40
+
41
+ ### 1. Cursor
42
+
43
+ Cursor hỗ trợ các máy chủ MCP (Model Context Protocol) và các kỹ năng tùy chỉnh. Chạy `intlayer init skills` sẽ:
44
+
45
+ - Tạo một tệp `.cursor/mcp.json` để giao tiếp với máy chủ Intlayer MCP.
46
+ - Cài đặt các kỹ năng cụ thể cho framework trong thư mục `.cursor/skills`.
47
+
48
+ ### 2. Windsurf
49
+
50
+ Windsurf là một IDE hỗ trợ bởi AI. Chạy `intlayer init skills` sẽ cài đặt các kỹ năng cụ thể cho framework trong thư mục `.windsurf/skills`.
51
+
52
+ ### 3. VS Code
53
+
54
+ Đối với người dùng VS Code, đặc biệt là những người sử dụng GitHub Copilot hoặc các tiện ích mở rộng tương thích với MCP khác, lệnh:
55
+
56
+ - Tạo cấu hình `.vscode/mcp.json`.
57
+ - Cài đặt các kỹ năng cụ thể cho framework trong thư mục `skills/` ở gốc dự án của bạn.
58
+
59
+ ### 4. OpenCode
60
+
61
+ OpenCode là một tác nhân CLI tương tác được thiết kế cho các tác vụ kỹ thuật phần mềm. Intlayer cung cấp các kỹ năng cụ thể để giúp OpenCode hỗ trợ bạn trong các tác vụ quốc tế hóa. Những kỹ năng này được cài đặt trong thư mục `.opencode/skills`.
62
+
63
+ ### 5. Claude Code
64
+
65
+ Claude Code có thể được cấu hình để sử dụng các kỹ năng của Intlayer. Lệnh này cài đặt các kỹ năng cụ thể cho framework trong thư mục `.claude/skills`.
66
+
67
+ ### 6. GitHub Copilot Workspace
68
+
69
+ GitHub Copilot Workspace cho phép bạn xác định các kỹ năng tùy chỉnh. Lệnh này cài đặt các kỹ năng cụ thể cho framework trong thư mục `.github/skills`.
@@ -0,0 +1,65 @@
1
+ ---
2
+ createdAt: 2024-08-11
3
+ updatedAt: 2025-11-22
4
+ title: Trích xuất chuỗi
5
+ description: Tìm hiểu cách trích xuất chuỗi từ các component của bạn vào một tệp .content nằm gần component.
6
+ keywords:
7
+ - Trích xuất
8
+ - Components
9
+ - Migration
10
+ - CLI
11
+ - Intlayer
12
+ slugs:
13
+ - doc
14
+ - concept
15
+ - cli
16
+ - extract
17
+ ---
18
+
19
+ # Trích xuất chuỗi
20
+
21
+ ```bash
22
+ npx intlayer extract
23
+ ```
24
+
25
+ Lệnh này phân tích các tệp mã của bạn để trích xuất chuỗi từ các component vào một tệp .content nằm gần component. Nó hỗ trợ việc chọn tệp tương tác hoặc chỉ định tệp cụ thể để trích xuất.
26
+
27
+ ## Bí danh:
28
+
29
+ - `npx intlayer ext`
30
+
31
+ ## Tham số:
32
+
33
+ **Tùy chọn chọn tệp:**
34
+
35
+ - **`-f, --file [files...]`**: Danh sách các tệp cụ thể để trích xuất. Nếu không được cung cấp, CLI sẽ quét các tệp khớp (`**/*.{tsx,jsx,vue,svelte,ts,js}`) và nhắc bạn chọn những tệp sẽ trích xuất.
36
+
37
+ > Ví dụ: `npx intlayer extract -f src/components/MyComponent.tsx`
38
+
39
+ **Tùy chọn đầu ra:**
40
+
41
+ - **`-o, --output-content-declarations [outputContentDeclarations]`**: Thư mục để lưu các tệp khai báo nội dung được tạo.
42
+
43
+ > Ví dụ: `npx intlayer extract -o src/content`
44
+
45
+ - **`--code-only`**: Chỉ trích xuất mã component (không ghi khai báo nội dung).
46
+
47
+ > Ví dụ: `npx intlayer extract --code-only`
48
+
49
+ - **`--declaration-only`**: Chỉ tạo khai báo nội dung (không ghi lại component).
50
+
51
+ > Ví dụ: `npx intlayer extract --declaration-only`
52
+
53
+ **Tùy chọn cấu hình:**
54
+
55
+ - **`--base-dir`**: Chỉ định thư mục gốc của dự án.
56
+ - **`--env`**: Chỉ định môi trường.
57
+ - **`--env-file`**: Cung cấp tệp môi trường tùy chỉnh.
58
+ - **`--verbose`**: Bật ghi nhật ký chi tiết.
59
+
60
+ **Các plugin bắt buộc:**
61
+
62
+ Lệnh extract hoạt động mà không cần plugin bổ sung đối với các tệp TypeScript / JSX. Tuy nhiên, nó yêu cầu các plugin sau phải được cài đặt cho các dự án Vue và Svelte:
63
+
64
+ - **`@intlayer/vue-transformer`**: Cho các tệp Vue.
65
+ - **`@intlayer/svelte-transformer`**: Cho các tệp Svelte.
@@ -170,7 +170,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình:
170
170
  "intlayer:fill": "npx intlayer fill",
171
171
  "intlayer:list": "npx intlayer content list",
172
172
  "intlayer:test": "npx intlayer content test",
173
- "intlayer:transform": "npx intlayer transform",
173
+ "intlayer:extract": "npx intlayer extract",
174
174
  "intlayer:projects": "npx intlayer projects list",
175
175
  "intlayer:doc:translate": "npx intlayer doc translate",
176
176
  "intlayer:doc:review": "npx intlayer doc review"
@@ -47,7 +47,7 @@ import {
47
47
  testMissingTranslations,
48
48
  docTranslate,
49
49
  docReview,
50
- transform,
50
+ extract,
51
51
  } from "@intlayer/cli";
52
52
 
53
53
  push();
@@ -66,6 +66,6 @@ docTranslate();
66
66
  // ...
67
67
  docReview();
68
68
  // ...
69
- transform();
69
+ extract();
70
70
  // ...
71
71
  ```
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  createdAt: 2024-08-13
3
- updatedAt: 2026-01-24
3
+ updatedAt: 2026-02-12
4
4
  title: Cấu hình
5
5
  description: Tìm hiểu cách cấu hình Intlayer cho ứng dụng của bạn. Hiểu các thiết lập và tùy chọn khác nhau để tùy chỉnh Intlayer theo nhu cầu của bạn.
6
6
  keywords:
@@ -14,6 +14,9 @@ slugs:
14
14
  - concept
15
15
  - configuration
16
16
  history:
17
+ - version: 8.0.6
18
+ date: 2026-02-12
19
+ changes: Add support for Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, and Together.ai providers
17
20
  - version: 8.0.5
18
21
  date: 2026-02-06
19
22
  changes: Thêm `dataSerialization` vào cấu hình AI
@@ -308,7 +311,7 @@ const config: IntlayerConfig = {
308
311
  ai: {
309
312
  /**
310
313
  * AI provider to use.
311
- * Options: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama'
314
+ * Options: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
312
315
  * Default: 'openai'
313
316
  */
314
317
  provider: "openai",
@@ -949,6 +952,16 @@ Intlayer hỗ trợ nhiều nhà cung cấp AI để tăng tính linh hoạt và
949
952
  - **Google Gemini**
950
953
  - **Meta Llama**
951
954
  - **Ollama**
955
+ - **OpenRouter**
956
+ - **Alibaba Cloud**
957
+ - **Fireworks**
958
+ - **Hugging Face**
959
+ - **Groq**
960
+ - **Amazon Bedrock**
961
+ - **Google AI Studio**
962
+ - **Google Vertex**
963
+ - **Together.ai**
964
+ - **ollama**
952
965
 
953
966
  #### Thuộc tính
954
967
 
@@ -956,7 +969,7 @@ Intlayer hỗ trợ nhiều nhà cung cấp AI để tăng tính linh hoạt và
956
969
  - _Kiểu_: `string`
957
970
  - _Mặc định_: `'openai'`
958
971
  - _Mô tả_: Nhà cung cấp được sử dụng cho các tính năng AI của Intlayer.
959
- - _Tùy chọn_: `'openai'`, `'anthropic'`, `'mistral'`, `'deepseek'`, `'gemini'`, `'ollama'`
972
+ - _Tùy chọn_: `'openai'`, `'anthropic'`, `'mistral'`, `'deepseek'`, `'gemini'`, `'ollama'`, `'openrouter'`, `'alibaba'`, `'fireworks'`, `'groq'`, `'huggingface'`, `'bedrock'`, `'googleaistudio'`, `'googlevertex'`, `'togetherai'`
960
973
  - _Ví dụ_: `'anthropic'`
961
974
  - _Lưu ý_: Các nhà cung cấp khác nhau có thể yêu cầu các khóa API khác nhau và có các mô hình giá khác nhau.
962
975
 
@@ -35,12 +35,12 @@ npm install intlayer-cli
35
35
 
36
36
  Gói này xuất các hàm cung cấp cho các lệnh CLI.
37
37
 
38
- | Hàm | Mô tả |
39
- | ----------- | ------------------------------------------------- |
40
- | `build` | Xây dựng các từ điển Intlayer. |
41
- | `audit` | Kiểm tra các từ điển để phát hiện bản dịch thiếu. |
42
- | `liveSync` | Đồng bộ các từ điển theo thời gian thực. |
43
- | `pull` | Kéo các từ điển từ nguồn từ xa. |
44
- | `push` | Đẩy các từ điển lên nguồn từ xa. |
45
- | `test` | Chạy kiểm thử trên các từ điển. |
46
- | `transform` | Chuyển đổi các từ điển giữa các định dạng. |
38
+ | Hàm | Mô tả |
39
+ | ---------- | ------------------------------------------------- |
40
+ | `build` | Xây dựng các từ điển Intlayer. |
41
+ | `audit` | Kiểm tra các từ điển để phát hiện bản dịch thiếu. |
42
+ | `liveSync` | Đồng bộ các từ điển theo thời gian thực. |
43
+ | `pull` | Kéo các từ điển từ nguồn từ xa. |
44
+ | `push` | Đẩy các từ điển lên nguồn từ xa. |
45
+ | `test` | Chạy kiểm thử trên các từ điển. |
46
+ | `extract` | Chuyển đổi các từ điển giữa các định dạng. |
@@ -112,6 +112,24 @@ module.exports = helloWorldContent;
112
112
 
113
113
  > Khuyến nghị: Định dạng này là tốt nhất khi sử dụng trình chỉnh sửa trực quan của Intlayer hoặc quản lý bản dịch trực tiếp trong mã.
114
114
 
115
+ ### Cấu hình toàn cầu cho các tệp theo từng Locale
116
+
117
+ Bạn có thể cấu hình cấu hình toàn cầu cho các tệp theo từng locale bằng cách thêm nội dung sau vào tệp `intlayer.config.ts` của bạn:
118
+
119
+ ```ts
120
+ import { Locales, type IntlayerConfig } from "intlayer";
121
+
122
+ const config: IntlayerConfig = {
123
+ dictionary: {
124
+ locale: Locales.ENGLISH,
125
+ },
126
+ };
127
+
128
+ export default config;
129
+ ```
130
+
131
+ Sử dụng cấu hình này, tất cả các tệp theo từng locale sẽ được tạo với locale mặc định được đặt là tiếng Anh. Nó cũng bao gồm việc tạo các tệp `.content` bằng cách sử dụng lệnh `extract` và compiler. (Xem [Compiler](https://intlayer.org/doc/compiler) hoặc [Extract](https://intlayer.org/doc/concept/cli/extract) để biết thêm thông tin.)
132
+
115
133
  ## Định dạng theo từng locale
116
134
 
117
135
  Định dạng này hữu ích khi:
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  createdAt: 2026-02-09
3
- updatedAt: 2026-02-09
3
+ updatedAt: 2026-02-12
4
4
  title: 代理技能
5
- description: 了解如何使用 Intlayer 代理技能来提高 AI 代理对项目的理解。
5
+ description: 了解如何使用 Intlayer 代理技能来提高 AI 代理对项目的理解,包括元数据 (Metadata)、站点地图 (Sitemaps) 和服务器操作 (Server Actions) 的全面设置指南。
6
6
  keywords:
7
7
  - Intlayer
8
8
  - 代理技能
@@ -13,7 +13,7 @@ slugs:
13
13
  - doc
14
14
  - agent_skills
15
15
  history:
16
- - version: 8.0.4
16
+ - version: 8.1.0
17
17
  date: 2026-02-09
18
18
  changes: 初始化历史
19
19
  ---
@@ -29,25 +29,41 @@ npx intlayer init skills
29
29
  运行此命令时,它将:
30
30
 
31
31
  1. 检测您正在使用的框架(例如 Next.js、React、Vite)。
32
- 2. 询问您要为哪些平台安装技能(Cursor、VS Code、OpenCode、Claude Code 等)。
33
- 3. 生成所需的配置文件(例如 `.cursor/mcp.json`、`.vscode/mcp.json` 或 `.intlayer/skills/*.md`)。
32
+ 2. 询问您要为哪些平台安装技能(Cursor、Windsurf、VS Code、OpenCode、Claude Code、GitHub Copilot Workspace 等)。
33
+ 3. 生成所需的配置文件(例如 `.cursor/skills/intlayer_next_js/SKILL.md`、`.windsurf/skills/intlayer_next_js/SKILL.md`、`.opencode/skills/intlayer_next_js/SKILL.md`、`.vscode/mcp.json` 等)。
34
34
 
35
35
  ## 支持的平台
36
36
 
37
+ Intlayer 提供特定于框架的文档(设置、用法、元数据、站点地图、服务器操作等),以帮助 AI 代理了解如何在您的特定项目中与 Intlayer 配合使用。这些技能旨在引导代理完成国际化的复杂过程,确保其遵循正确的模式和最佳实践。
38
+
37
39
  Intlayer 支持与以下平台集成:
38
40
 
39
41
  ### 1. Cursor
40
42
 
41
- Cursor 支持 MCP (Model Context Protocol) 服务器。运行 `intlayer init skills` 将创建一个 `.cursor/mcp.json` 文件,允许 Cursor 与 Intlayer MCP 服务器通信。
43
+ Cursor 支持 MCP (Model Context Protocol) 服务器和自定义技能。运行 `intlayer init skills` 将:
44
+
45
+ - 创建一个 `.cursor/mcp.json` 文件以与 Intlayer MCP 服务器通信。
46
+ - 在 `.cursor/skills` 目录中安装特定于框架的技能。
47
+
48
+ ### 2. Windsurf
49
+
50
+ Windsurf 是一款 AI 驱动的 IDE。运行 `intlayer init skills` 将在 `.windsurf/skills` 目录中安装特定于框架的技能。
51
+
52
+ ### 3. VS Code
53
+
54
+ 对于 VS Code 用户,尤其是那些使用 GitHub Copilot 或其他兼容 MCP 的扩展的用户,该命令:
55
+
56
+ - 创建 `.vscode/mcp.json` 配置。
57
+ - 在项目根目录的 `skills/` 目录中安装特定于框架的技能。
42
58
 
43
- ### 2. VS Code
59
+ ### 4. OpenCode
44
60
 
45
- 对于 VS Code 用户,尤其是那些使用 GitHub Copilot 或其他兼容 MCP 的扩展的用户,该命令会创建一个 `.vscode/mcp.json` 配置。
61
+ OpenCode 是一个专为软件工程任务设计的交互式 CLI 代理。Intlayer 提供特定技能来帮助 OpenCode 协助您完成国际化任务。这些技能安装在 `.opencode/skills` 目录中。
46
62
 
47
- ### 3. OpenCode
63
+ ### 5. Claude Code
48
64
 
49
- OpenCode 是一个专为软件工程任务设计的交互式 CLI 代理。Intlayer 提供特定的技能来帮助 OpenCode 协助您完成国际化任务。
65
+ Claude Code 可以配置为使用 Intlayer 技能。该命令在 `.claude/skills` 目录中安装特定于框架的技能。
50
66
 
51
- ### 4. Claude Code
67
+ ### 6. GitHub Copilot Workspace
52
68
 
53
- 可以通过将生成的配置添加到其桌面或 CLI 设置中,将 Claude Code 配置为使用 Intlayer 技能。
69
+ GitHub Copilot Workspace 允许您定义自定义技能。该命令在 `.github/skills` 目录中安装特定于框架的技能。
@@ -0,0 +1,65 @@
1
+ ---
2
+ createdAt: 2024-08-11
3
+ updatedAt: 2025-11-22
4
+ title: 提取字符串
5
+ description: 了解如何将组件中的字符串提取到靠近组件的 .content 文件中。
6
+ keywords:
7
+ - 提取
8
+ - 组件
9
+ - 迁移
10
+ - CLI
11
+ - Intlayer
12
+ slugs:
13
+ - doc
14
+ - concept
15
+ - cli
16
+ - extract
17
+ ---
18
+
19
+ # 提取字符串
20
+
21
+ ```bash
22
+ npx intlayer extract
23
+ ```
24
+
25
+ 此命令会分析你的代码文件,将组件中的字符串提取到靠近组件的 .content 文件中。它支持交互式文件选择或指定文件目标。
26
+
27
+ ## 别名:
28
+
29
+ - `npx intlayer ext`
30
+
31
+ ## 参数:
32
+
33
+ **文件选择选项:**
34
+
35
+ - **`-f, --file [files...]`**:要提取的特定文件列表。如果未提供,CLI 将扫描匹配的文件(`**/*.{tsx,jsx,vue,svelte,ts,js}`)并提示您选择要提取的文件。
36
+
37
+ > 示例:`npx intlayer extract -f src/components/MyComponent.tsx`
38
+
39
+ **输出选项:**
40
+
41
+ - **`-o, --output-content-declarations [outputContentDeclarations]`**:保存生成的内容声明文件的目录。
42
+
43
+ > 示例:`npx intlayer extract -o src/content`
44
+
45
+ - **`--code-only`**:仅提取组件代码(不写入内容声明)。
46
+
47
+ > 示例:`npx intlayer extract --code-only`
48
+
49
+ - **`--declaration-only`**:仅生成内容声明(不重写组件)。
50
+
51
+ > 示例:`npx intlayer extract --declaration-only`
52
+
53
+ **配置选项:**
54
+
55
+ - **`--base-dir`**:指定项目的基目录。
56
+ - **`--env`**:指定环境。
57
+ - **`--env-file`**:提供自定义的环境文件。
58
+ - **`--verbose`**:启用详细日志。
59
+
60
+ **必需的插件:**
61
+
62
+ extract 命令在 TypeScript / JSX 文件上无需额外插件即可运行。但是,对于 Vue 和 Svelte 项目,需要安装以下插件:
63
+
64
+ - **`@intlayer/vue-transformer`**:用于 Vue 文件。
65
+ - **`@intlayer/svelte-transformer`**:用于 Svelte 文件。
@@ -174,7 +174,7 @@ Intlayer 支持多种配置文件格式:
174
174
  "intlayer:fill": "npx intlayer fill",
175
175
  "intlayer:list": "npx intlayer content list",
176
176
  "intlayer:test": "npx intlayer content test",
177
- "intlayer:transform": "npx intlayer transform",
177
+ "intlayer:extract": "npx intlayer extract",
178
178
  "intlayer:projects": "npx intlayer projects list",
179
179
  "intlayer:doc:translate": "npx intlayer doc translate",
180
180
  "intlayer:doc:review": "npx intlayer doc review"
@@ -47,7 +47,7 @@ import {
47
47
  testMissingTranslations,
48
48
  docTranslate,
49
49
  docReview,
50
- transform,
50
+ extract,
51
51
  } from "@intlayer/cli";
52
52
 
53
53
  push();
@@ -66,6 +66,6 @@ docTranslate();
66
66
  // ...
67
67
  docReview();
68
68
  // ...
69
- transform();
69
+ extract();
70
70
  // ...
71
71
  ```
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  createdAt: 2024-08-13
3
- updatedAt: 2026-01-24
3
+ updatedAt: 2026-02-12
4
4
  title: 配置
5
5
  description: 了解如何为您的应用程序配置 Intlayer。了解各种设置和选项,以根据您的需求自定义 Intlayer。
6
6
  keywords:
@@ -14,6 +14,9 @@ slugs:
14
14
  - concept
15
15
  - configuration
16
16
  history:
17
+ - version: 8.0.6
18
+ date: 2026-02-12
19
+ changes: Add support for Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, and Together.ai providers
17
20
  - version: 8.0.5
18
21
  date: 2026-02-06
19
22
  changes: 在 AI 配置中添加 `dataSerialization`
@@ -293,7 +296,7 @@ const config: IntlayerConfig = {
293
296
  ai: {
294
297
  /**
295
298
  * AI provider to use.
296
- * Options: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama'
299
+ * Options: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
297
300
  * Default: 'openai'
298
301
  */
299
302
  provider: "openai",
@@ -848,6 +851,16 @@ Intlayer 支持多个 AI 提供商,以增强灵活性和选择。目前支持
848
851
  - **Google Gemini**
849
852
  - **Meta Llama**
850
853
  - **Ollama**
854
+ - **OpenRouter**
855
+ - **Alibaba Cloud**
856
+ - **Fireworks**
857
+ - **Hugging Face**
858
+ - **Groq**
859
+ - **Amazon Bedrock**
860
+ - **Google AI Studio**
861
+ - **Google Vertex**
862
+ - **Together.ai**
863
+ - **ollama**
851
864
 
852
865
  #### 属性
853
866
 
@@ -35,12 +35,12 @@ npm install intlayer-cli
35
35
 
36
36
  该包导出用于驱动 CLI 命令的函数。
37
37
 
38
- | Function | 描述 |
39
- | ----------- | -------------------------- |
40
- | `build` | 构建 Intlayer 字典。 |
41
- | `audit` | 审计字典以查找缺失的翻译。 |
42
- | `liveSync` | 实时同步字典。 |
43
- | `pull` | 从远程源拉取字典。 |
44
- | `push` | 将字典推送到远程源。 |
45
- | `test` | 对字典运行测试。 |
46
- | `transform` | 在不同格式之间转换字典。 |
38
+ | Function | 描述 |
39
+ | ---------- | -------------------------- |
40
+ | `build` | 构建 Intlayer 字典。 |
41
+ | `audit` | 审计字典以查找缺失的翻译。 |
42
+ | `liveSync` | 实时同步字典。 |
43
+ | `pull` | 从远程源拉取字典。 |
44
+ | `push` | 将字典推送到远程源。 |
45
+ | `test` | 对字典运行测试。 |
46
+ | `extract` | 在不同格式之间转换字典。 |
@@ -112,6 +112,24 @@ module.exports = helloWorldContent;
112
112
 
113
113
  > 推荐:当使用 Intlayer 的可视化编辑器或直接在代码中管理翻译时,此格式最佳。
114
114
 
115
+ ### 每个语言区域文件的全局配置
116
+
117
+ 您可以通过在 `intlayer.config.ts` 文件中添加以下内容来配置每个语言区域文件的全局配置:
118
+
119
+ ```ts
120
+ import { Locales, type IntlayerConfig } from "intlayer";
121
+
122
+ const config: IntlayerConfig = {
123
+ dictionary: {
124
+ locale: Locales.ENGLISH,
125
+ },
126
+ };
127
+
128
+ export default config;
129
+ ```
130
+
131
+ 使用此配置,所有按语言区域的文件都将以默认语言区域设置为英语的方式生成。它还包括使用 `extract` 命令和编译器生成的 `.content` 文件。(有关更多信息,请参阅 [编译器 (Compiler)](https://intlayer.org/doc/compiler) 或 [提取 (Extract)](https://intlayer.org/doc/concept/cli/extract)。)
132
+
115
133
  ## 按语言区域格式
116
134
 
117
135
  此格式适用于:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@intlayer/docs",
3
- "version": "8.0.5",
3
+ "version": "8.1.0",
4
4
  "private": false,
5
5
  "description": "Intlayer documentation",
6
6
  "keywords": [
@@ -73,14 +73,14 @@
73
73
  "watch": "webpack --config ./webpack.config.ts --watch"
74
74
  },
75
75
  "dependencies": {
76
- "@intlayer/config": "8.0.5",
77
- "@intlayer/core": "8.0.5",
78
- "@intlayer/types": "8.0.5"
76
+ "@intlayer/config": "8.1.0",
77
+ "@intlayer/core": "8.1.0",
78
+ "@intlayer/types": "8.1.0"
79
79
  },
80
80
  "devDependencies": {
81
- "@intlayer/api": "8.0.5",
82
- "@intlayer/cli": "8.0.5",
83
- "@types/node": "25.2.2",
81
+ "@intlayer/api": "8.1.0",
82
+ "@intlayer/cli": "8.1.0",
83
+ "@types/node": "25.2.3",
84
84
  "@utils/ts-config": "1.0.4",
85
85
  "@utils/ts-config-types": "1.0.4",
86
86
  "@utils/tsdown-config": "1.0.4",
@@ -273,6 +273,26 @@ export const docsEntry = {
273
273
  vi: readLocale('cli/editor.md', 'vi'),
274
274
  uk: readLocale('cli/editor.md', 'uk'),
275
275
  } as unknown as Record<LocalesValues, Promise<string>>,
276
+ './docs/en/cli/extract.md': {
277
+ en: readLocale('cli/extract.md', 'en'),
278
+ ru: readLocale('cli/extract.md', 'ru'),
279
+ ja: readLocale('cli/extract.md', 'ja'),
280
+ fr: readLocale('cli/extract.md', 'fr'),
281
+ ko: readLocale('cli/extract.md', 'ko'),
282
+ zh: readLocale('cli/extract.md', 'zh'),
283
+ es: readLocale('cli/extract.md', 'es'),
284
+ de: readLocale('cli/extract.md', 'de'),
285
+ ar: readLocale('cli/extract.md', 'ar'),
286
+ it: readLocale('cli/extract.md', 'it'),
287
+ 'en-GB': readLocale('cli/extract.md', 'en-GB'),
288
+ pt: readLocale('cli/extract.md', 'pt'),
289
+ hi: readLocale('cli/extract.md', 'hi'),
290
+ tr: readLocale('cli/extract.md', 'tr'),
291
+ pl: readLocale('cli/extract.md', 'pl'),
292
+ id: readLocale('cli/extract.md', 'id'),
293
+ vi: readLocale('cli/extract.md', 'vi'),
294
+ uk: readLocale('cli/extract.md', 'uk'),
295
+ } as unknown as Record<LocalesValues, Promise<string>>,
276
296
  './docs/en/cli/fill.md': {
277
297
  en: readLocale('cli/fill.md', 'en'),
278
298
  ru: readLocale('cli/fill.md', 'ru'),
@@ -493,26 +513,6 @@ export const docsEntry = {
493
513
  vi: readLocale('cli/test.md', 'vi'),
494
514
  uk: readLocale('cli/test.md', 'uk'),
495
515
  } as unknown as Record<LocalesValues, Promise<string>>,
496
- './docs/en/cli/transform.md': {
497
- en: readLocale('cli/transform.md', 'en'),
498
- ru: readLocale('cli/transform.md', 'ru'),
499
- ja: readLocale('cli/transform.md', 'ja'),
500
- fr: readLocale('cli/transform.md', 'fr'),
501
- ko: readLocale('cli/transform.md', 'ko'),
502
- zh: readLocale('cli/transform.md', 'zh'),
503
- es: readLocale('cli/transform.md', 'es'),
504
- de: readLocale('cli/transform.md', 'de'),
505
- ar: readLocale('cli/transform.md', 'ar'),
506
- it: readLocale('cli/transform.md', 'it'),
507
- 'en-GB': readLocale('cli/transform.md', 'en-GB'),
508
- pt: readLocale('cli/transform.md', 'pt'),
509
- hi: readLocale('cli/transform.md', 'hi'),
510
- tr: readLocale('cli/transform.md', 'tr'),
511
- pl: readLocale('cli/transform.md', 'pl'),
512
- id: readLocale('cli/transform.md', 'id'),
513
- vi: readLocale('cli/transform.md', 'vi'),
514
- uk: readLocale('cli/transform.md', 'uk'),
515
- } as unknown as Record<LocalesValues, Promise<string>>,
516
516
  './docs/en/cli/version.md': {
517
517
  en: readLocale('cli/version.md', 'en'),
518
518
  ru: readLocale('cli/version.md', 'ru'),