@llm-translate/cli 1.0.0-next.1

package/docs/zh/cli/file.md

@@ -0,0 +1,213 @@
+# llm-translate file
+
+::: info 翻译说明
+所有非英文文档均使用 Claude Sonnet 4 自动翻译。
+:::
+
+翻译单个文件。
+
+## 语法
+
+```bash
+llm-translate file <input> [output] [options]
+```
+
+## 参数
+
+| 参数 | 描述 |
+|----------|-------------|
+|`<input>`| 输入文件路径（必需） |
+|`[output]`| 输出文件路径（可选，默认为 stdout） |
+
+## 选项
+
+### 翻译选项
+
+| 选项 | 默认值 | 描述 |
+|--------|---------|-------------|
+|`--source-lang `,`-s`| 必需 | 源语言代码 |
+|`--target-lang `,`-t`| 必需 | 目标语言代码 |
+|`--glossary `,`-g`| 无 | 术语表文件路径 |
+
+### 质量选项
+
+| 选项 | 默认值 | 描述 |
+|--------|---------|-------------|
+|`--quality`| 85 | 质量阈值（0-100） |
+|`--max-iterations`| 4 | 最大优化迭代次数 |
+|`--strict-quality`| false | 未达到阈值时失败 |
+|`--strict-glossary`| false | 术语表术语未应用时失败 |
+
+### 提供商选项
+
+| 选项 | 默认值 | 描述 |
+|--------|---------|-------------|
+|`--provider `,`-p`| claude | 提供商名称 |
+|`--model `,`-m`| 不定 | 模型标识符 |
+
+### 输出选项
+
+| 选项 | 默认值 | 描述 |
+|--------|---------|-------------|
+|`--output `,`-o`| 自动 | 输出文件路径 |
+|`--format `,`-f`| 自动 | 强制输出格式（md\|html\|txt） |
+|`--dry-run`| false | 显示将要执行的操作 |
+|`--json`| false | 以 JSON 格式输出结果 |
+|`--verbose `,`-v`| false | 启用详细日志记录 |
+|`--quiet `,`-q`| false | 抑制非错误输出 |
+
+### 高级选项
+
+| 选项 | 默认值 | 描述 |
+|--------|---------|-------------|
+|`--no-cache`| false | 禁用翻译缓存 |
+|`--chunk-size`| 1024 | 每个分块的最大令牌数 |
+|`--context`| 无 | 翻译的附加上下文 |
+
+## 示例
+
+### 基本用法
+
+```bash
+# Translate to Korean
+llm-translate file README.md -o README.ko.md -s en -t ko
+
+# With explicit output path
+llm-translate file README.md --output README.ko.md --source-lang en --target-lang ko
+
+# Specify source and target languages
+llm-translate file doc.md -o doc.ja.md --source-lang en --target-lang ja
+```
+
+### 使用术语表
+
+```bash
+# Use glossary for consistent terminology
+llm-translate file api-docs.md -o api-docs.ko.md \
+  -s en -t ko \
+  --glossary glossary.json
+```
+
+### 质量控制
+
+```bash
+# Higher quality threshold
+llm-translate file important.md -o important.ko.md \
+  -s en -t ko \
+  --quality 95 \
+  --max-iterations 6
+
+# Strict mode (fail if not met)
+llm-translate file legal.md -o legal.ko.md \
+  --source-lang en \
+  --target-lang ko \
+  --quality 95 \
+  --strict-quality
+```
+
+### 提供商选择
+
+```bash
+# Use Claude Sonnet
+llm-translate file doc.md -o doc.ko.md \
+  -s en -t ko \
+  --provider claude \
+  --model claude-sonnet-4-5-20250929
+
+# Use OpenAI
+llm-translate file doc.md -o doc.ko.md \
+  -s en -t ko \
+  --provider openai \
+  --model gpt-4o
+```
+
+### 从 stdin 输入
+
+```bash
+# Pipe content (uses stdin mode when no TTY)
+cat doc.md | llm-translate -s en -t ko > doc.ko.md
+
+# Use with other tools
+curl https://example.com/doc.md | llm-translate -s en -t ko
+```
+
+## 输出格式
+
+### 普通模式
+
+```
+✓ Translated README.md → README.ko.md
+  Quality: 92/85 (threshold met)
+  Duration: 3.2s
+```
+
+### 详细模式
+
+```bash
+llm-translate file doc.md -o doc.ko.md --target ko --verbose
+```
+
+```
+ℹ Loading configuration...
+ℹ Provider: claude (claude-haiku-4-5-20251001)
+ℹ Parsing document...
+ℹ Chunks: 5
+ℹ Starting translation...
+
+[Chunk 1/5] Starting initial translation...
+[Chunk 1/5] Quality: 78/85
+[Chunk 1/5] Generating improvements...
+[Chunk 1/5] Quality: 91/85 ✓
+
+[Chunk 2/5] Starting initial translation...
+[Chunk 2/5] Quality: 88/85 ✓
+...
+
+✓ Translation complete
+  Quality: 89/85 (threshold met)
+  Iterations: avg 1.8
+  Tokens: 5,234 input / 6,456 output
+  Cache: 3,200 read / 800 written
+  Duration: 8.4s
+```
+
+## 语言代码
+
+常见语言代码：
+
+| 代码 | 语言 |
+|------|----------|
+|`en`| 英语 |
+|`ko`| 韩语 |
+|`ja`| 日语 |
+|`zh`| 中文（简体） |
+|`zh-TW`| 中文（繁体） |
+|`es`| 西班牙语 |
+|`fr`| 法语 |
+|`de`| 德语 |
+
+## 错误处理
+
+### 文件未找到
+
+```bash
+$ llm-translate file missing.md -s en -t ko
+Error: Could not read file 'missing.md'
+Exit code: 3
+```
+
+### 质量未达标（严格模式）
+
+```bash
+$ llm-translate file doc.md -o doc.ko.md -s en -t ko --quality 99 --strict-quality
+Error: Quality threshold not met: 94/99
+Exit code: 4
+```
+
+### API 错误
+
+```bash
+$ llm-translate file doc.md --target ko
+Error: Provider error: Rate limit exceeded
+Exit code: 5
+```

package/docs/zh/cli/glossary.md

@@ -0,0 +1,273 @@
+# llm-translate glossary
+
+::: info 翻译说明
+所有非英文文档均使用 Claude Sonnet 4 自动翻译。
+:::
+
+管理术语表文件以确保术语一致性。
+
+## 概要
+
+```bash
+llm-translate glossary <subcommand> [options]
+```
+
+## 子命令
+
+### list
+
+列出术语表中的所有术语。
+
+```bash
+llm-translate glossary list --glossary glossary.json
+```
+
+选项：
+| 选项 | 描述 |
+|--------|-------------|
+|`--glossary `,`-g`| 术语表文件路径（必需） |
+|`--target `,`-t`| 按目标语言过滤 |
+|`--format `| 输出格式：` table `、` json`|
+
+示例：
+
+```bash
+# List all terms
+llm-translate glossary list -g glossary.json
+
+# Filter by target language
+llm-translate glossary list -g glossary.json --target ko
+
+# JSON output
+llm-translate glossary list -g glossary.json --format json
+```
+
+输出：
+```
+Glossary: glossary.json (15 terms)
+
+Source          | Korean (ko)      | Japanese (ja)    | Flags
+----------------|------------------|------------------|-------
+component       | 컴포넌트         | コンポーネント    |
+prop            | 프롭             | プロップ          |
+state           | 상태             | ステート          |
+TypeScript      | -                | -                | DNT
+API             | -                | -                | DNT, CS
+
+DNT = Do Not Translate, CS = Case Sensitive
+```
+
+### validate
+
+验证术语表文件结构和内容。
+
+```bash
+llm-translate glossary validate --glossary glossary.json
+```
+
+选项：
+| 选项 | 描述 |
+|--------|-------------|
+|`--glossary `,`-g`| 术语表文件路径（必需） |
+|`--strict`| 警告时失败 |
+
+示例：
+
+```bash
+# Basic validation
+llm-translate glossary validate -g glossary.json
+
+# Strict mode
+llm-translate glossary validate -g glossary.json --strict
+```
+
+输出：
+```
+Validating glossary.json...
+
+✓ Valid JSON structure
+✓ Required fields present
+✓ 15 terms found
+
+Warnings:
+  - Term "component" has no context
+  - Term "hook" missing Japanese translation
+
+✓ Validation passed (2 warnings)
+```
+
+### add
+
+向术语表添加新术语。
+
+```bash
+llm-translate glossary add <source> [options]
+```
+
+选项：
+| 选项 | 描述 |
+|--------|-------------|
+|`--glossary `,`-g`| 术语表文件路径（必需） |
+|`--target `| 目标翻译（格式：` lang=value`） |
+|`--context`| 术语的上下文 |
+|`--dnt`| 标记为"不翻译" |
+|`--case-sensitive`| 标记为区分大小写 |
+
+示例：
+
+```bash
+# Add with translations
+llm-translate glossary add "container" \
+  -g glossary.json \
+  --target ko="컨테이너" \
+  --target ja="コンテナ"
+
+# Add do-not-translate term
+llm-translate glossary add "Kubernetes" \
+  -g glossary.json \
+  --dnt
+
+# Add with context
+llm-translate glossary add "instance" \
+  -g glossary.json \
+  --target ko="인스턴스" \
+  --context "Cloud computing instance"
+```
+
+### remove
+
+从术语表中删除术语。
+
+```bash
+llm-translate glossary remove <source> --glossary glossary.json
+```
+
+示例：
+
+```bash
+llm-translate glossary remove "deprecated-term" -g glossary.json
+```
+
+### update
+
+更新现有术语。
+
+```bash
+llm-translate glossary update <source> [options]
+```
+
+选项：
+| 选项 | 描述 |
+|--------|-------------|
+|`--glossary `,`-g`| 术语表文件路径（必需） |
+|`--target`| 更新目标翻译 |
+|`--context`| 更新上下文 |
+|`--dnt`| 设置/取消设置不翻译 |
+
+示例：
+
+```bash
+# Update translation
+llm-translate glossary update "component" \
+  -g glossary.json \
+  --target ko="컴포넌트 요소"
+
+# Add context
+llm-translate glossary update "state" \
+  -g glossary.json \
+  --context "React component state"
+```
+
+### stats
+
+显示术语表统计信息。
+
+```bash
+llm-translate glossary stats --glossary glossary.json
+```
+
+输出：
+```
+Glossary Statistics: glossary.json
+
+Terms: 15
+  - With translations: 12
+  - Do not translate: 3
+
+Languages:
+  - Korean (ko): 12 terms
+  - Japanese (ja): 10 terms
+  - Chinese (zh): 8 terms
+
+Token estimate: ~450 tokens
+```
+
+### merge
+
+合并多个术语表。
+
+```bash
+llm-translate glossary merge \
+  --input glossary-a.json \
+  --input glossary-b.json \
+  --output merged.json
+```
+
+选项：
+| 选项 | 描述 |
+|--------|-------------|
+|`--input `,`-i`| 输入术语表文件（多个） |
+|`--output `,`-o`| 输出合并的术语表 |
+|`--strategy `| 冲突解决：` first `、` last `、` error`|
+
+### export
+
+将术语表导出为不同格式。
+
+```bash
+llm-translate glossary export --glossary glossary.json --format csv
+```
+
+选项：
+| 选项 | 描述 |
+|--------|-------------|
+|`--format `| 导出格式：` csv `、` tsv `、` xlsx`|
+|`--output `,`-o`| 输出文件路径 |
+
+## 最佳实践
+
+### 组织大型术语表
+
+```bash
+# Split by domain
+glossaries/
+├── common.json      # Shared terms
+├── frontend.json    # UI terminology
+├── backend.json     # Server terminology
+└── devops.json      # Infrastructure terms
+
+# Merge for use
+llm-translate glossary merge \
+  -i glossaries/common.json \
+  -i glossaries/frontend.json \
+  -o project-glossary.json
+```
+
+### 版本控制
+
+将术语表包含在版本控制中：
+
+```bash
+git add glossary.json
+git commit -m "Add project glossary"
+```
+
+### 定期维护
+
+```bash
+# Validate before commits
+llm-translate glossary validate -g glossary.json --strict
+
+# Review stats periodically
+llm-translate glossary stats -g glossary.json
+```

package/docs/zh/cli/index.md

@@ -0,0 +1,111 @@
+# CLI 参考
+
+::: info 翻译说明
+所有非英文文档均使用 Claude Sonnet 4 自动翻译。
+:::
+
+llm-translate 提供了用于翻译文档的命令行界面。
+
+## 安装
+
+```bash
+npm install -g @llm-translate/cli
+```
+
+## 全局选项
+
+这些选项适用于所有命令：
+
+| 选项 | 描述 |
+|--------|-------------|
+|`--help `,`-h`| 显示帮助 |
+|`--version `,`-V`| 显示版本 |
+|`--verbose `,`-v`| 启用详细输出 |
+|`--quiet `,`-q`| 抑制非必要输出 |
+|`--config`| 配置文件路径 |
+
+## 命令
+
+### [file](./file)
+
+翻译单个文件。
+
+```bash
+llm-translate file <input> [output] [options]
+```
+
+### [dir](./dir)
+
+翻译目录中的所有文件。
+
+```bash
+llm-translate dir <input> <output> [options]
+```
+
+### [init](./init)
+
+初始化配置文件。
+
+```bash
+llm-translate init [options]
+```
+
+### [glossary](./glossary)
+
+管理术语表文件。
+
+```bash
+llm-translate glossary <subcommand> [options]
+```
+
+## 快速示例
+
+```bash
+# Translate a file to Korean
+llm-translate file README.md -o README.ko.md -s en -t ko
+
+# Translate with glossary
+llm-translate file docs/guide.md -o docs/guide.ja.md \
+  -s en -t ja --glossary glossary.json
+
+# Batch translate a directory
+llm-translate dir ./docs ./docs-ko -s en -t ko
+
+# Initialize config
+llm-translate init --provider claude
+
+# Validate glossary
+llm-translate glossary validate glossary.json
+```
+
+## 退出代码
+
+| 代码 | 描述 |
+|------|-------------|
+| 0 | 成功 |
+| 1 | 一般错误 |
+| 2 | 无效参数 |
+| 3 | 文件未找到 |
+| 4 | 未达到质量阈值（严格模式） |
+| 5 | 提供商/API 错误 |
+| 6 | 术语表验证失败 |
+
+## 环境变量
+
+```bash
+# API Keys
+ANTHROPIC_API_KEY=sk-ant-xxxxx
+OPENAI_API_KEY=sk-xxxxx
+OLLAMA_BASE_URL=http://localhost:11434
+```
+
+## 配置优先级
+
+设置按以下顺序应用（后者覆盖前者）：
+
+1. 内置默认值
+2. 配置文件 (`.translaterc.json`)
+3. 环境变量
+4. CLI 参数
+
+详情请参见[配置](../guide/configuration)。