核心用法
baoyu-translate 是一款面向文档与文章翻译的专业技能，提供三档翻译模式：
- Quick（快翻）：直接翻译，适用于短文本、非正式内容或快速任务。
- Normal（标准）：先分析再翻译，生成内容摘要、术语表与受众分析，适合一般文章与博客。
- Refined（精翻）：完整出版级流程，包含分析→翻译→审校→润色四步，输出高质量译文。
支持通过 EXTEND.md 配置文件自定义默认语言、目标受众、翻译风格、术语表及分块阈值。首次使用时会引导用户完成配置初始化。命令行接口支持 --mode、--from、--to、--audience、--style、--glossary 等参数，可覆盖配置文件设置。
显著优点
1. 术语一致性保障：内置英汉术语库，支持自定义词表与外部词表文件合并；长文翻译前先提取全文术语建立会话词表，确保分块翻译时术语统一。
2. 智能分块处理：超长文档（>4000词）自动拆分为语义完整的 Markdown 块，调用子代理并行翻译，再合并输出，兼顾效率与质量。
3. 九种翻译风格：涵盖叙事、正式、技术、直译、学术、商务、幽默、口语、优雅等风格，支持自定义描述，适配多元场景。
4. 出版级精翻流程：审校环节独立诊断准确性、欧化汉语、策略执行与表达问题；润色环节最终打磨，输出可直接发布的译文。
5. 图像语言感知：翻译完成后检测嵌入图片的文字语言是否与译文匹配，主动提示用户是否需要图像本地化。
6. 配置灵活：项目级、用户级、XDG 配置三级优先级，支持团队协作与个人偏好隔离。
潜在缺点与局限性
- 依赖外部运行时：需安装 Bun 或 Node.js（通过 npx），Windows 用户需配置 PowerShell 环境。
- 子代理依赖：分块翻译的最佳体验依赖 Agent 工具并行执行；若无此工具，回退到串行处理，长文效率下降。
- 术语提取自动化有限：虽扫描全文提取术语，但复杂领域（如生僻医学、法律）仍需人工校验词表。
- 图像本地化仅作提示：不自动处理图片内文字，需用户手动介入或使用其他工具。
- 精翻流程较重：四步流程产生大量中间文件，对简单任务可能显得冗余。
适合人群
- 技术博客作者、开发者文档维护者（需技术风格与术语一致）
- 学术研究者（需学术风格与引用格式保留）
- 出版编辑、译者（需精翻流程与审校环节）
- 企业本地化团队（需自定义词表与项目级配置）
- 多语言内容运营者（需快速切换目标受众与风格）
常规风险
- 配置覆盖风险：命令行参数覆盖 EXTEND.md，EXTEND.md 覆盖默认值，需确认最终生效配置。
- 分块边界语义断裂：虽按 Markdown 块拆分，极少数复杂表格或代码块仍可能破坏上下文连贯性。
- 术语冲突：内置词表、自定义词表、CLI 传入词表合并时，优先级规则需仔细阅读文档，避免意外覆盖。
- 长文内存占用：极长文档并行翻译时，子代理可能占用较多上下文窗口，需监控资源使用。