novelws 1.2.0

package/plugins/translate/commands/translate-preview.md

@@ -0,0 +1,543 @@
+---
+title: 翻译预览 - /translate-preview
+description: 预览翻译效果，试译前 500 字，对比多种翻译风格
+---
+
+# 翻译预览
+
+## 使用方法
+
+```bash
+/translate-preview [选项] [文件]
+```
+
+### 基本用法
+
+```bash
+/translate-preview --to en                      # 预览当前章节
+/translate-preview --to en chapter-01.md        # 预览指定章节
+/translate-preview --to en --compare-styles     # 对比三种风格
+```
+
+### 选项
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--to <语言>` | 目标语言（必需） | - |
+| `--from <语言>` | 源语言 | 自动检测 |
+| `--compare-styles` | 对比三种翻译风格 | false |
+| `--length <字数>` | 预览长度 | 500 |
+
+---
+
+## 功能详解
+
+### 1. 快速试译
+
+取当前章节前 500 字试译，让用户确认风格满意度。
+
+**示例：**
+
+```
+原文（前 500 字）：
+李明站在青云宗的山门前，心中百感交集。三年前，他还是一个普通的外门弟子，
+每天做着最苦最累的杂活。如今，他已经是内门弟子，甚至得到了掌门的青睐。
+
+他的心如刀绞，眼看着师父倒在血泊中。"师父！"他冲上前去，却被一股无形
+的力量震飞。那人冷笑一声："就凭你，也想救他？"
+
+---
+
+译文（Literary 风格）：
+Li Ming stood before the mountain gate of Azure Cloud Sect, his heart a
+tumult of emotions. Three years ago, he had been nothing more than an
+ordinary outer disciple, toiling day after day at the most menial tasks.
+Now, he was an inner disciple, even earning the favor of the Sect Master.
+
+His heart wrenched with agony as he watched his master collapse into a
+pool of blood. "Master!" He rushed forward, only to be thrown back by an
+invisible force. The man sneered coldly, "You think you can save him?"
+
+---
+
+✅ 术语应用：
+  - 李明 → Li Ming
+  - 青云宗 → Azure Cloud Sect
+  - 师父 → Master
+
+📊 翻译统计：
+  - 原文：500 字
+  - 译文：412 词（-17.6%）
+  - 段落数：2 → 2（一致）
+
+💡 建议：
+  - 翻译风格适合严肃文学
+  - 术语应用正确
+  - 可以开始正式翻译
+```
+
+---
+
+### 2. 风格对比
+
+同时展示三种翻译风格，帮助用户选择最适合的。
+
+**示例：**
+
+```
+原文：
+他的心如刀绞，眼看着师父倒在血泊中。
+
+---
+
+【Literary 风格】（文学性翻译）
+His heart wrenched with agony as he watched his master collapse into a
+pool of blood.
+
+特点：
+✓ 保持意境和情感
+✓ 使用文学化表达（wrenched with agony）
+✓ 适合严肃文学、文青向网文
+
+---
+
+【Casual 风格】（口语化翻译）
+His heart ached like crazy, seeing his master fall in a pool of blood.
+
+特点：
+✓ 通俗易懂
+✓ 使用口语化表达（ached like crazy）
+✓ 适合爽文、轻小说
+
+---
+
+【Formal 风格】（正式翻译）
+His heart was seized by profound anguish as he observed his master fall
+into a pool of blood.
+
+特点：
+✓ 庄重典雅
+✓ 使用正式表达（seized by profound anguish）
+✓ 适合历史、武侠
+
+---
+
+推荐：Literary（最接近原文意境）
+
+选择风格后，使用：
+  /translate --to en --style literary chapter-01.md
+```
+
+---
+
+### 3. 术语预览
+
+展示术语表在翻译中的应用效果。
+
+**示例：**
+
+```
+原文中检测到的术语：
+
+✅ 已定义（5 个）：
+  - 李明 → Li Ming
+  - 青云宗 → Azure Cloud Sect
+  - 师父 → Master
+  - 内门弟子 → inner disciple
+  - 外门弟子 → outer disciple
+
+⚠️ 未定义（3 个）：
+  - 灵气（出现 2 次）
+    建议：/glossary add "概念:灵气|spiritual energy|霊気"
+
+  - 筑基期（出现 1 次）
+    建议：/glossary add "概念:筑基期|Foundation Establishment|築基期"
+
+  - 天灵根（出现 1 次）
+    建议：/glossary add "概念:天灵根|Heavenly Spirit Root|天霊根"
+
+💡 建议：
+  先添加未定义术语，再进行正式翻译，确保术语一致性 100%
+```
+
+---
+
+## 执行流程
+
+### 当用户调用 /translate-preview 时
+
+**Step 1: 验证参数**
+```
+检查 --to 参数是否提供（必需）
+验证语言代码是否支持（zh/en/ja）
+确定预览长度（默认 500 字）
+```
+
+**Step 2: 读取源文件**
+```
+如果指定文件 → 读取该文件
+如果未指定 → 读取当前章节
+提取前 N 字（默认 500）
+```
+
+**Step 3: 加载术语表**
+```
+读取 .specify/translation/glossary.json
+如果不存在 → 警告："术语表未初始化，建议先运行 /glossary init"
+扫描预览文本，标记术语
+```
+
+**Step 4: 执行翻译**
+
+如果 `--compare-styles` 为 true：
+```
+并行翻译三种风格：
+  1. Literary 风格
+  2. Casual 风格
+  3. Formal 风格
+
+对每种风格：
+  - 使用相同的术语表
+  - 应用不同的翻译策略
+  - 生成翻译结果
+```
+
+如果 `--compare-styles` 为 false：
+```
+使用默认 literary 风格翻译
+```
+
+**Step 5: 分析结果**
+```
+统计：
+  - 原文字数
+  - 译文词数
+  - 长度变化百分比
+  - 段落数对应
+
+术语检查：
+  - 已定义术语列表
+  - 未定义术语列表
+  - 术语应用情况
+```
+
+**Step 6: 展示结果**
+```
+显示：
+  - 原文
+  - 译文（单个或三种风格对比）
+  - 术语应用情况
+  - 翻译统计
+  - 建议和下一步操作
+```
+
+---
+
+## 翻译提示词
+
+### Literary 风格
+
+```
+你是专业的文学翻译专家，精通{source_lang}到{target_lang}的文学翻译。
+
+任务：将以下文本从{source_lang}翻译为{target_lang}，使用文学性翻译风格。
+
+翻译要求：
+1. 保持原文的意境和情感
+2. 使用文学化的表达方式
+3. 保持叙述节奏和风格
+4. 严格使用术语表中的译名
+5. 适合严肃文学和文青向网文
+
+术语表：
+{glossary_list}
+
+待翻译文本：
+{text}
+
+请提供文学性翻译。
+```
+
+### Casual 风格
+
+```
+你是专业的文学翻译专家，精通{source_lang}到{target_lang}的翻译。
+
+任务：将以下文本从{source_lang}翻译为{target_lang}，使用口语化翻译风格。
+
+翻译要求：
+1. 通俗易懂，贴近日常口语
+2. 使用简单直接的表达
+3. 保持轻松的阅读感
+4. 严格使用术语表中的译名
+5. 适合爽文和轻小说
+
+术语表：
+{glossary_list}
+
+待翻译文本：
+{text}
+
+请提供口语化翻译。
+```
+
+### Formal 风格
+
+```
+你是专业的文学翻译专家，精通{source_lang}到{target_lang}的翻译。
+
+任务：将以下文本从{source_lang}翻译为{target_lang}，使用正式翻译风格。
+
+翻译要求：
+1. 庄重典雅，用词考究
+2. 使用正式的书面表达
+3. 保持文本的严肃性
+4. 严格使用术语表中的译名
+5. 适合历史小说和武侠
+
+术语表：
+{glossary_list}
+
+待翻译文本：
+{text}
+
+请提供正式翻译。
+```
+
+---
+
+## 示例对话
+
+### 示例 1：基本预览
+
+```
+用户：/translate-preview --to en
+
+助手：
+正在预览翻译效果...
+
+原文（前 500 字）：
+李明站在青云宗的山门前，心中百感交集。三年前，他还是一个普通的
+外门弟子，每天做着最苦最累的杂活...
+
+---
+
+译文（Literary 风格）：
+Li Ming stood before the mountain gate of Azure Cloud Sect, his heart
+a tumult of emotions. Three years ago, he had been nothing more than
+an ordinary outer disciple...
+
+---
+
+✅ 术语应用：3/3（100%）
+  - 李明 → Li Ming
+  - 青云宗 → Azure Cloud Sect
+  - 外门弟子 → outer disciple
+
+📊 翻译统计：
+  - 原文：500 字
+  - 译文：412 词（-17.6%）
+  - 段落数：2 → 2（一致）
+
+💡 建议：
+  翻译风格适合当前文本，可以开始正式翻译。
+
+下一步：
+  /translate --to en chapter-01.md
+```
+
+### 示例 2：风格对比
+
+```
+用户：/translate-preview --to en --compare-styles
+
+助手：
+正在对比三种翻译风格...
+
+原文：
+他的心如刀绞，眼看着师父倒在血泊中。
+
+---
+
+【Literary 风格】
+His heart wrenched with agony as he watched his master collapse into
+a pool of blood.
+
+【Casual 风格】
+His heart ached like crazy, seeing his master fall in a pool of blood.
+
+【Formal 风格】
+His heart was seized by profound anguish as he observed his master fall
+into a pool of blood.
+
+---
+
+风格对比：
+
+| 维度 | Literary | Casual | Formal |
+|------|----------|--------|--------|
+| 文学性 | ★★★★★ | ★★☆☆☆ | ★★★★☆ |
+| 易读性 | ★★★★☆ | ★★★★★ | ★★★☆☆ |
+| 正式度 | ★★★★☆ | ★★☆☆☆ | ★★★★★ |
+
+推荐：Literary（最接近原文意境）
+
+选择风格后使用：
+  /translate --to en --style literary chapter-01.md
+  /translate --to en --style casual chapter-01.md
+  /translate --to en --style formal chapter-01.md
+```
+
+### 示例 3：术语未定义警告
+
+```
+用户：/translate-preview --to en
+
+助手：
+⚠️ 警告：术语表未初始化
+
+建议先初始化术语表：
+  /glossary init
+
+然后添加主要术语：
+  /glossary add "角色:李明|Li Ming"
+  /glossary add "地名:青云宗|Azure Cloud Sect"
+
+是否继续预览（不使用术语表）？(y/n)
+
+用户：y
+
+助手：
+正在预览翻译效果（未使用术语表）...
+
+原文（前 500 字）：
+李明站在青云宗的山门前...
+
+---
+
+译文（Literary 风格）：
+Li Ming stood before the mountain gate of Qingyun Sect...
+
+---
+
+⚠️ 注意：
+  未使用术语表，译名可能不一致。
+  例如："青云宗" 被翻译为 "Qingyun Sect"，
+  但您可能希望使用 "Azure Cloud Sect"。
+
+强烈建议：
+  1. 初始化术语表
+  2. 添加核心术语
+  3. 重新预览
+```
+
+---
+
+## 最佳实践
+
+### 1. 预览时机
+
+**推荐：** 在正式翻译前预览
+
+```bash
+# 第一次翻译前
+/translate-preview --to en --compare-styles
+
+# 选择风格后
+/translate --to en --style literary --all
+```
+
+### 2. 预览长度
+
+- **500 字：** 适合快速预览（默认）
+- **1000 字：** 适合详细评估
+- **2000 字：** 适合完整章节预览
+
+```bash
+/translate-preview --to en --length 1000
+```
+
+### 3. 风格选择指南
+
+| 小说类型 | 推荐风格 | 理由 |
+|---------|---------|------|
+| 严肃文学 | Literary | 保持文学性和意境 |
+| 都市爽文 | Casual | 轻松易读 |
+| 历史武侠 | Formal | 庄重典雅 |
+| 玄幻修仙 | Literary | 保持意境 |
+| 轻小说 | Casual | 口语化 |
+| 科幻 | Literary | 平衡专业性和可读性 |
+
+### 4. 迭代优化
+
+```bash
+# 第一次预览
+/translate-preview --to en --compare-styles
+
+# 根据反馈调整术语表
+/glossary add "概念:灵气|spiritual energy"
+
+# 再次预览
+/translate-preview --to en
+
+# 满意后正式翻译
+/translate --to en --all
+```
+
+---
+
+## 常见问题
+
+### Q: 预览和正式翻译有什么区别？
+
+A: 预览只翻译前 500 字，用于快速评估风格。正式翻译会翻译完整章节，并生成翻译报告。
+
+### Q: 可以预览多个章节吗？
+
+A: 预览命令只支持单个章节。如果想评估多章节效果，建议先翻译 1-2 章，然后检查质量。
+
+### Q: 风格对比需要多长时间？
+
+A: 约 30-60 秒（需要翻译三次）。
+
+### Q: 预览结果会保存吗？
+
+A: 不会。预览仅用于评估，不会保存翻译结果。
+
+---
+
+## 技术实现细节
+
+### 并行翻译
+
+```
+对比风格时，三种风格并行翻译：
+
+Promise.all([
+  translateWithStyle(text, 'literary'),
+  translateWithStyle(text, 'casual'),
+  translateWithStyle(text, 'formal')
+])
+
+总时间 ≈ 单次翻译时间
+```
+
+### 缓存优化
+
+```
+术语表缓存：
+  - 首次读取后缓存
+  - 避免重复读取
+
+翻译结果缓存：
+  - 相同文本 + 相同风格 = 使用缓存
+  - 缓存有效期：15 分钟
+```
+
+---
+
+## 相关命令
+
+- `/translate` - 正式翻译
+- `/glossary` - 管理术语表
+- `/analyze` - 分析翻译质量