@intlayer/docs 8.0.5 → 8.1.1
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.
- package/dist/cjs/generated/docs.entry.cjs +20 -20
- package/dist/cjs/generated/docs.entry.cjs.map +1 -1
- package/dist/esm/generated/docs.entry.mjs +20 -20
- package/dist/esm/generated/docs.entry.mjs.map +1 -1
- package/dist/types/generated/docs.entry.d.ts +1 -1
- package/dist/types/generated/docs.entry.d.ts.map +1 -1
- package/docs/ar/agent_skills.md +69 -0
- package/docs/ar/cli/extract.md +65 -0
- package/docs/ar/cli/index.md +1 -1
- package/docs/ar/cli/sdk.md +2 -2
- package/docs/ar/configuration.md +16 -3
- package/docs/ar/packages/intlayer-cli.md +9 -9
- package/docs/ar/per_locale_file.md +18 -0
- package/docs/de/agent_skills.md +28 -12
- package/docs/de/cli/extract.md +65 -0
- package/docs/de/cli/index.md +1 -1
- package/docs/de/cli/sdk.md +2 -2
- package/docs/de/configuration.md +16 -3
- package/docs/de/intlayer_with_analog.md +1 -1
- package/docs/de/packages/intlayer-cli.md +9 -9
- package/docs/de/per_locale_file.md +18 -0
- package/docs/en/agent_skills.md +28 -12
- package/docs/en/cli/extract.md +65 -0
- package/docs/en/cli/index.md +3 -3
- package/docs/en/cli/sdk.md +2 -2
- package/docs/en/configuration.md +15 -3
- package/docs/en/packages/intlayer-cli.md +9 -9
- package/docs/en/per_locale_file.md +1 -1
- package/docs/en-GB/agent_skills.md +69 -0
- package/docs/en-GB/cli/extract.md +65 -0
- package/docs/en-GB/cli/index.md +1 -1
- package/docs/en-GB/cli/sdk.md +2 -2
- package/docs/en-GB/configuration.md +15 -3
- package/docs/en-GB/packages/intlayer-cli.md +9 -9
- package/docs/en-GB/per_locale_file.md +18 -0
- package/docs/es/agent_skills.md +28 -12
- package/docs/es/cli/extract.md +65 -0
- package/docs/es/cli/index.md +1 -1
- package/docs/es/cli/sdk.md +2 -2
- package/docs/es/configuration.md +16 -3
- package/docs/es/intlayer_with_analog.md +1 -1
- package/docs/es/packages/intlayer-cli.md +9 -9
- package/docs/es/per_locale_file.md +18 -0
- package/docs/fr/agent_skills.md +28 -12
- package/docs/fr/cli/extract.md +65 -0
- package/docs/fr/cli/index.md +1 -1
- package/docs/fr/cli/sdk.md +2 -2
- package/docs/fr/configuration.md +16 -3
- package/docs/fr/intlayer_with_analog.md +1 -1
- package/docs/fr/packages/intlayer-cli.md +9 -9
- package/docs/fr/per_locale_file.md +18 -0
- package/docs/hi/agent_skills.md +69 -0
- package/docs/hi/cli/extract.md +65 -0
- package/docs/hi/cli/index.md +1 -1
- package/docs/hi/cli/sdk.md +2 -2
- package/docs/hi/configuration.md +16 -3
- package/docs/hi/packages/intlayer-cli.md +9 -9
- package/docs/hi/per_locale_file.md +18 -2
- package/docs/id/agent_skills.md +69 -0
- package/docs/id/cli/extract.md +65 -0
- package/docs/id/cli/index.md +1 -1
- package/docs/id/cli/sdk.md +2 -2
- package/docs/id/configuration.md +16 -3
- package/docs/id/packages/intlayer-cli.md +9 -9
- package/docs/id/per_locale_file.md +18 -0
- package/docs/it/agent_skills.md +28 -12
- package/docs/it/cli/extract.md +65 -0
- package/docs/it/cli/index.md +1 -1
- package/docs/it/cli/sdk.md +2 -2
- package/docs/it/configuration.md +16 -3
- package/docs/it/packages/intlayer-cli.md +9 -9
- package/docs/it/per_locale_file.md +18 -2
- package/docs/ja/agent_skills.md +28 -12
- package/docs/ja/cli/extract.md +65 -0
- package/docs/ja/cli/index.md +1 -1
- package/docs/ja/cli/sdk.md +2 -2
- package/docs/ja/configuration.md +16 -3
- package/docs/ja/packages/intlayer-cli.md +9 -9
- package/docs/ja/per_locale_file.md +18 -0
- package/docs/ko/agent_skills.md +28 -12
- package/docs/ko/cli/extract.md +65 -0
- package/docs/ko/cli/index.md +1 -1
- package/docs/ko/cli/sdk.md +2 -2
- package/docs/ko/configuration.md +16 -3
- package/docs/ko/packages/intlayer-cli.md +9 -9
- package/docs/ko/per_locale_file.md +18 -0
- package/docs/pl/agent_skills.md +69 -0
- package/docs/pl/cli/extract.md +65 -0
- package/docs/pl/cli/index.md +1 -1
- package/docs/pl/cli/sdk.md +2 -2
- package/docs/pl/configuration.md +16 -3
- package/docs/pl/packages/intlayer-cli.md +9 -9
- package/docs/pl/per_locale_file.md +18 -0
- package/docs/pt/agent_skills.md +29 -13
- package/docs/pt/cli/extract.md +65 -0
- package/docs/pt/cli/index.md +1 -1
- package/docs/pt/cli/sdk.md +2 -2
- package/docs/pt/configuration.md +16 -3
- package/docs/pt/packages/intlayer-cli.md +9 -9
- package/docs/pt/per_locale_file.md +18 -0
- package/docs/ru/agent_skills.md +69 -0
- package/docs/ru/cli/extract.md +65 -0
- package/docs/ru/cli/index.md +1 -1
- package/docs/ru/cli/sdk.md +2 -2
- package/docs/ru/configuration.md +16 -3
- package/docs/ru/packages/intlayer-cli.md +9 -9
- package/docs/ru/per_locale_file.md +18 -2
- package/docs/tr/agent_skills.md +69 -0
- package/docs/tr/cli/extract.md +65 -0
- package/docs/tr/cli/index.md +1 -1
- package/docs/tr/cli/sdk.md +2 -2
- package/docs/tr/configuration.md +16 -3
- package/docs/tr/packages/intlayer-cli.md +9 -9
- package/docs/tr/per_locale_file.md +18 -0
- package/docs/uk/agent_skills.md +69 -0
- package/docs/uk/cli/extract.md +65 -0
- package/docs/uk/cli/index.md +1 -1
- package/docs/uk/cli/sdk.md +1 -1
- package/docs/uk/configuration.md +15 -3
- package/docs/uk/packages/intlayer-cli.md +9 -9
- package/docs/vi/agent_skills.md +69 -0
- package/docs/vi/cli/extract.md +65 -0
- package/docs/vi/cli/index.md +1 -1
- package/docs/vi/cli/sdk.md +2 -2
- package/docs/vi/configuration.md +16 -3
- package/docs/vi/packages/intlayer-cli.md +9 -9
- package/docs/vi/per_locale_file.md +18 -0
- package/docs/zh/agent_skills.md +28 -12
- package/docs/zh/cli/extract.md +65 -0
- package/docs/zh/cli/index.md +1 -1
- package/docs/zh/cli/sdk.md +2 -2
- package/docs/zh/configuration.md +15 -2
- package/docs/zh/packages/intlayer-cli.md +9 -9
- package/docs/zh/per_locale_file.md +18 -0
- package/package.json +7 -7
- package/src/generated/docs.entry.ts +20 -20
- package/docs/ar/cli/transform.md +0 -65
- package/docs/de/cli/transform.md +0 -65
- package/docs/en/cli/transform.md +0 -65
- package/docs/en-GB/cli/transform.md +0 -65
- package/docs/es/cli/transform.md +0 -65
- package/docs/fr/cli/transform.md +0 -65
- package/docs/hi/cli/transform.md +0 -65
- package/docs/id/cli/transform.md +0 -65
- package/docs/it/cli/transform.md +0 -65
- package/docs/ja/cli/transform.md +0 -65
- package/docs/ko/cli/transform.md +0 -65
- package/docs/pl/cli/transform.md +0 -65
- package/docs/pt/cli/transform.md +0 -65
- package/docs/ru/cli/transform.md +0 -65
- package/docs/tr/cli/transform.md +0 -65
- package/docs/uk/cli/transform.md +0 -65
- package/docs/vi/cli/transform.md +0 -65
- 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.
|
package/docs/vi/cli/index.md
CHANGED
|
@@ -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:
|
|
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"
|
package/docs/vi/cli/sdk.md
CHANGED
|
@@ -47,7 +47,7 @@ import {
|
|
|
47
47
|
testMissingTranslations,
|
|
48
48
|
docTranslate,
|
|
49
49
|
docReview,
|
|
50
|
-
|
|
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
|
-
|
|
69
|
+
extract();
|
|
70
70
|
// ...
|
|
71
71
|
```
|
package/docs/vi/configuration.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
createdAt: 2024-08-13
|
|
3
|
-
updatedAt: 2026-
|
|
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
|
|
39
|
-
|
|
|
40
|
-
| `build`
|
|
41
|
-
| `audit`
|
|
42
|
-
| `liveSync`
|
|
43
|
-
| `pull`
|
|
44
|
-
| `push`
|
|
45
|
-
| `test`
|
|
46
|
-
| `
|
|
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:
|
package/docs/zh/agent_skills.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
createdAt: 2026-02-09
|
|
3
|
-
updatedAt: 2026-02-
|
|
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
|
|
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/
|
|
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)
|
|
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
|
-
###
|
|
59
|
+
### 4. OpenCode
|
|
44
60
|
|
|
45
|
-
|
|
61
|
+
OpenCode 是一个专为软件工程任务设计的交互式 CLI 代理。Intlayer 提供特定技能来帮助 OpenCode 协助您完成国际化任务。这些技能安装在 `.opencode/skills` 目录中。
|
|
46
62
|
|
|
47
|
-
###
|
|
63
|
+
### 5. Claude Code
|
|
48
64
|
|
|
49
|
-
|
|
65
|
+
Claude Code 可以配置为使用 Intlayer 技能。该命令在 `.claude/skills` 目录中安装特定于框架的技能。
|
|
50
66
|
|
|
51
|
-
###
|
|
67
|
+
### 6. GitHub Copilot Workspace
|
|
52
68
|
|
|
53
|
-
|
|
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 文件。
|
package/docs/zh/cli/index.md
CHANGED
|
@@ -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:
|
|
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"
|
package/docs/zh/cli/sdk.md
CHANGED
|
@@ -47,7 +47,7 @@ import {
|
|
|
47
47
|
testMissingTranslations,
|
|
48
48
|
docTranslate,
|
|
49
49
|
docReview,
|
|
50
|
-
|
|
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
|
-
|
|
69
|
+
extract();
|
|
70
70
|
// ...
|
|
71
71
|
```
|
package/docs/zh/configuration.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
createdAt: 2024-08-13
|
|
3
|
-
updatedAt: 2026-
|
|
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`
|
|
41
|
-
| `audit`
|
|
42
|
-
| `liveSync`
|
|
43
|
-
| `pull`
|
|
44
|
-
| `push`
|
|
45
|
-
| `test`
|
|
46
|
-
| `
|
|
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.
|
|
3
|
+
"version": "8.1.1",
|
|
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.
|
|
77
|
-
"@intlayer/core": "8.
|
|
78
|
-
"@intlayer/types": "8.
|
|
76
|
+
"@intlayer/config": "8.1.1",
|
|
77
|
+
"@intlayer/core": "8.1.1",
|
|
78
|
+
"@intlayer/types": "8.1.1"
|
|
79
79
|
},
|
|
80
80
|
"devDependencies": {
|
|
81
|
-
"@intlayer/api": "8.
|
|
82
|
-
"@intlayer/cli": "8.
|
|
83
|
-
"@types/node": "25.2.
|
|
81
|
+
"@intlayer/api": "8.1.1",
|
|
82
|
+
"@intlayer/cli": "8.1.1",
|
|
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'),
|