核心用法
baoyu-translate 是一款面向高质量文档翻译的 CLI 技能，提供 Quick（快速）/ Normal（标准）/ Refined（精翻） 三档翻译模式，覆盖从即时任务到出版级润色的全场景需求。
核心流程：
- Quick：直接翻译，适合短文本与快速任务
- Normal（默认）：先分析内容领域、语气与术语，再执行翻译，适合博客与一般文章
- Refined：完整六步工作流（分析→翻译→初稿→批判性审校→修订→润色），输出出版级质量
智能分块：长文档（>4000词）自动触发 Markdown 语义分块，通过子代理并行处理，确保术语一致性与结构完整。
配置系统：支持 EXTEND.md 自定义目标语言、默认模式、受众画像、翻译风格（9种预设如 storytelling、technical、academic）、术语库等。首次使用引导式配置，避免静默降级。
显著优点
1. 质量分层清晰：三档模式精准匹配场景，避免过度工程或质量不足
2. 术语一致性保障：内置英汉术语库 + 自定义术语表 + 会话级术语提取，长文档分块翻译仍能保持统一
3. 翻译风格精细化：9种预设风格 + 自定义描述，从学术严谨到叙事生动均可覆盖
4. 工程化设计：完整的工作流文件留存（01-analysis.md → 05-revision.md），便于审计与迭代
5. 受众感知：支持 general/technical/academic/business 等受众预设，自动调整注释深度与语言正式度
6. 图像语言提醒：翻译后主动检测嵌入图片的语言匹配问题，避免常见疏漏
潜在缺点与局限性
1. 运行时依赖：需 Bun 或 npx 环境，Windows 用户需额外配置
2. 配置门槛：EXTEND.md 首次配置为阻塞操作，对临时用户不够轻量
3. 子代理依赖：分块翻译依赖 Agent 工具可用性，否则退化为顺序处理，效率降低
4. 语言对限制：内置术语库目前仅覆盖 EN→ZH，其他语言对依赖用户自建术语表
5. 无实时协作：工作流文件本地化存储，不支持多用户同步编辑
适合人群
- 内容创作者/译者：需要稳定输出出版级中文译文
- 技术文档团队：处理长文档时重视术语一致性与可审计性
- 学术研究者：精翻模式满足期刊投稿级别的语言质量要求
- 本地化工程师：可通过
EXTEND.md与 CLI 参数深度定制流水线
常规风险
- 长文档 Quick 模式风险：系统会警告但未阻止，用户可能误用于长文本导致质量下降
- 术语表冲突：多级术语合并（内置→EXTEND.md→CLI参数）优先级需仔细核对
- 图像本地化遗漏：系统仅提醒不自动处理，需用户手动跟进
- 路径权限问题：
EXTEND.md的 XDG 与用户目录路径在部分 CI/CD 环境可能无法写入
总体评估
baoyu-translate 是目前开源生态中工作流最完整的翻译技能之一，将传统 CAT 工具的核心概念（术语库、风格指南、质量检查）以代码化方式实现。适合对翻译质量有明确分层需求、愿意投入配置成本的专业场景。