@llm-translate/cli 1.0.0-next.1

package/docs/zh/guide/getting-started.md

@@ -0,0 +1,150 @@
+# 快速开始
+
+::: info 翻译说明
+所有非英文文档均使用 Claude Sonnet 4 自动翻译。
+:::
+
+## 安装
+
+### npm（推荐）
+
+```bash
+npm install -g @llm-translate/cli
+```
+
+### 从源码安装
+
+```bash
+git clone https://github.com/selenehyun/llm-translate.git
+cd llm-translate
+npm install
+npm run build
+npm link
+```
+
+## 前置要求
+
+- Node.js 24 或更高版本
+- 至少一个 LLM 提供商的 API 密钥：
+  - Anthropic (Claude)
+  - OpenAI
+  - Ollama（本地运行，无需 API 密钥）
+
+## 配置
+
+### 1. 设置 API 密钥
+
+```bash
+# For Claude (recommended)
+export ANTHROPIC_API_KEY=sk-ant-xxxxx
+
+# For OpenAI
+export OPENAI_API_KEY=sk-xxxxx
+
+# For Ollama (no key needed, just ensure server is running)
+# See the Ollama guide for setup: ./ollama
+export OLLAMA_BASE_URL=http://localhost:11434
+```
+
+### 2. 初始化配置（可选）
+
+```bash
+llm-translate init
+```
+
+这将创建一个包含默认设置的 `.translaterc.json` 文件：
+
+```json
+{
+  "provider": {
+    "name": "claude",
+    "model": "claude-haiku-4-5-20251001"
+  },
+  "translation": {
+    "qualityThreshold": 85,
+    "maxIterations": 4
+  },
+  "paths": {
+    "glossary": "./glossary.json"
+  }
+}
+```
+
+## 第一次翻译
+
+### 基本用法
+
+```bash
+# Translate a markdown file to Korean
+llm-translate file README.md -o README.ko.md -s en -t ko
+
+# Using long option names
+llm-translate file docs/guide.md -o docs/guide.ja.md --source-lang en --target-lang ja
+```
+
+### 使用术语表
+
+1. 创建一个 `glossary.json` 文件：
+
+```json
+{
+  "sourceLanguage": "en",
+  "terms": [
+    {
+      "source": "component",
+      "targets": { "ko": "컴포넌트" },
+      "context": "UI component"
+    },
+    {
+      "source": "prop",
+      "targets": { "ko": "프롭" },
+      "context": "React prop"
+    },
+    {
+      "source": "TypeScript",
+      "doNotTranslate": true
+    }
+  ]
+}
+```
+
+2. 使用术语表进行翻译：
+
+```bash
+llm-translate file README.md -o README.ko.md -s en -t ko --glossary glossary.json
+```
+
+### 批量翻译
+
+翻译整个目录：
+
+```bash
+llm-translate dir ./docs ./docs-ko -s en -t ko --glossary glossary.json
+```
+
+## 理解输出结果
+
+翻译完成后，您将看到：
+
+```
+✓ Translation complete
+  Quality: 92/85 (threshold met)
+  Iterations: 2
+  Tokens: 1,234 input / 1,456 output
+  Cache: 890 read / 234 written (78% hit rate)
+  Duration: 3.2s
+```
+
+- **Quality**：最终得分与质量阈值的对比
+- **Iterations**：优化迭代次数
+- **Tokens**：API 令牌使用量
+- **Cache**：提示缓存统计（仅限 Claude）
+- **Duration**：总处理时间
+
+## 下一步
+
+- [配置您的项目](./configuration) 以获得最佳设置
+- [设置术语表](./glossary) 确保术语一致性
+- [了解质量控制](./quality-control) 和调优
+- [优化成本](./cost-optimization) 适用于大型项目
+- [使用 Ollama 本地运行](./ollama) 进行私密的离线翻译

package/docs/zh/guide/glossary.md

@@ -0,0 +1,214 @@
+# 术语表
+
+::: info 翻译说明
+所有非英文文档均使用 Claude Sonnet 4 自动翻译。
+:::
+
+术语表功能确保所有翻译中术语的一致性。定义一次术语，它们每次都会以相同的方式翻译。
+
+## 术语表文件格式
+
+创建一个 `glossary.json` 文件：
+
+```json
+{
+  "sourceLanguage": "en",
+  "version": "1.0.0",
+  "terms": [
+    {
+      "source": "component",
+      "targets": {
+        "ko": "컴포넌트",
+        "ja": "コンポーネント",
+        "zh": "组件"
+      },
+      "context": "UI component in React/Vue"
+    }
+  ]
+}
+```
+
+## 术语结构
+
+### 基本术语
+
+```json
+{
+  "source": "endpoint",
+  "targets": {
+    "ko": "엔드포인트",
+    "ja": "エンドポイント"
+  }
+}
+```
+
+### 带上下文
+
+上下文帮助 LLM 理解如何使用术语：
+
+```json
+{
+  "source": "state",
+  "targets": { "ko": "상태" },
+  "context": "Application state in state management"
+}
+```
+
+### 不翻译
+
+保持技术术语为英文：
+
+```json
+{
+  "source": "Kubernetes",
+  "doNotTranslate": true
+}
+```
+
+### 特定语言不翻译
+
+```json
+{
+  "source": "React",
+  "doNotTranslateFor": ["ko", "ja"],
+  "targets": {
+    "zh": "React框架"
+  }
+}
+```
+
+### 大小写敏感性
+
+```json
+{
+  "source": "API",
+  "targets": { "ko": "API" },
+  "caseSensitive": true
+}
+```
+
+## 完整示例
+
+```json
+{
+  "sourceLanguage": "en",
+  "version": "1.0.0",
+  "description": "Technical documentation glossary",
+  "terms": [
+    {
+      "source": "component",
+      "targets": { "ko": "컴포넌트", "ja": "コンポーネント" },
+      "context": "UI component"
+    },
+    {
+      "source": "prop",
+      "targets": { "ko": "프롭", "ja": "プロップ" },
+      "context": "React component property"
+    },
+    {
+      "source": "hook",
+      "targets": { "ko": "훅", "ja": "フック" },
+      "context": "React hook (useState, useEffect, etc.)"
+    },
+    {
+      "source": "state",
+      "targets": { "ko": "상태", "ja": "ステート" },
+      "context": "Component or application state"
+    },
+    {
+      "source": "TypeScript",
+      "doNotTranslate": true
+    },
+    {
+      "source": "JavaScript",
+      "doNotTranslate": true
+    },
+    {
+      "source": "npm",
+      "doNotTranslate": true
+    },
+    {
+      "source": "API",
+      "doNotTranslate": true,
+      "caseSensitive": true
+    }
+  ]
+}
+```
+
+## CLI 命令
+
+### 列出术语表术语
+
+```bash
+llm-translate glossary list --glossary glossary.json
+```
+
+### 验证术语表
+
+```bash
+llm-translate glossary validate --glossary glossary.json
+```
+
+### 添加术语
+
+```bash
+llm-translate glossary add "container" --target ko="컨테이너" --glossary glossary.json
+```
+
+### 删除术语
+
+```bash
+llm-translate glossary remove "container" --glossary glossary.json
+```
+
+## 最佳实践
+
+### 1. 从常见技术术语开始
+
+```json
+{
+  "terms": [
+    { "source": "API", "doNotTranslate": true },
+    { "source": "SDK", "doNotTranslate": true },
+    { "source": "CLI", "doNotTranslate": true },
+    { "source": "URL", "doNotTranslate": true },
+    { "source": "JSON", "doNotTranslate": true }
+  ]
+}
+```
+
+### 2. 包含产品特定术语
+
+```json
+{
+  "source": "Workspace",
+  "targets": { "ko": "워크스페이스" },
+  "context": "Product-specific workspace feature"
+}
+```
+
+### 3. 为歧义术语添加上下文
+
+```json
+{
+  "source": "run",
+  "targets": { "ko": "실행" },
+  "context": "Execute a command or script"
+}
+```
+
+### 4. 对品牌名称使用 `doNotTranslate`
+
+```json
+{
+  "source": "GitHub",
+  "doNotTranslate": true
+}
+```
+
+### 5. 版本化您的术语表
+
+跟踪术语表变更与您的文档一起。
+
+## 术语应用方式

package/docs/zh/guide/index.md

@@ -0,0 +1,32 @@
+# 什么是 llm-translate？
+
+::: info 翻译说明
+所有非英文文档均使用 Claude Sonnet 4 自动翻译。
+:::
+
+llm-translate 是一个使用大型语言模型翻译文档的 CLI 工具。它专为技术文档设计，在一致性、准确性和格式保持方面至关重要。
+
+## 主要功能
+
+### 术语表强制执行
+
+定义一次特定领域的术语，确保在所有文档中保持一致的翻译。
+
+```json
+{
+  "terms": [
+    {
+      "source": "API endpoint",
+      "targets": { "ko": "API 엔드포인트", "ja": "APIエンドポイント" }
+    },
+    {
+      "source": "Kubernetes",
+      "doNotTranslate": true
+    }
+  ]
+}
+```
+
+### Self-Refine质量控制
+
+llm-translate 不只是翻译一次就完事。它使用迭代改进过程：