核心用法
baoyu-translate 是一款面向专业场景的多模式翻译技能，专为追求译文质量的写作者、译者和技术内容团队设计。它提供三种翻译模式：
- Quick（快速模式）：直接翻译，适合短文本、非正式内容或快速任务
- Normal（标准模式，默认）：分析 → 翻译，适合文章、博客等常规内容
- Refined（精翻模式）：分析 → 翻译 → 审校 → 润色，面向出版级重要文档
使用时只需提供原文（文本、文件或 URL），系统自动检测语言并输出译文。支持通过 EXTEND.md 配置默认目标语言、翻译风格、受众画像、自定义术语表等。长文（默认 >4000 词）自动触发分块翻译，通过子代理并行处理确保术语一致性。
翻译原则：重写而非直译，追求"读起来像母语原创"的自然流畅感；优先保证事实、数据和逻辑准确；主动为专业术语添加简洁注释（加粗括号内）。
显著优点
| 维度 | 亮点 |
|------|------|
| **模式灵活** | 三档精度可选，从快速草稿到出版成品全覆盖，支持"继续润色"升级 |
| **术语管控** | 内置英中术语表 + 用户自定义术语表 + 自动提取文档术语，三重保障一致性 |
| **长文优化** | 智能分块保留 Markdown 结构边界，子代理并行翻译后合并，避免上下文断裂 |
| **风格系统** | 9 种预设风格（storytelling/formal/technical/elegant 等）+ 自定义描述，适配不同场景 |
| **受众定制** | 通用/技术/学术/商业受众画像，自动调整注释密度与语气 |
| **完整留痕** | Normal/Refined 模式保存分析、提示词、草稿、审校、修订等中间文件，便于复盘 |
| **首次引导** | 无配置时强制运行首次设置流程，降低上手门槛 |
潜在缺点与局限性
- 依赖 Bun/Node 运行时：需本地安装
bun或通过npx获取，对纯云端环境不够友好 - 分块阈值固定：虽可配置，但超大文档（数万词）仍可能面临合并后的局部连贯性挑战
- 子代理可用性：若运行时无 Agent 工具，长文只能串行处理，效率下降
- 图像本地化：仅提醒用户检查图文语言匹配，不自动处理图片内文字
- 术语表维护成本：专业领域需用户持续维护
EXTEND.md，无自动术语学习机制
适合人群
- 内容创作者：将外文博客、技术文档转为母语风格文章
- 技术写作者：API 文档、README、架构说明的多语言本地化
- 学术译者：论文、报告等需要术语严谨与出版质量的场景
- 产品团队：帮助中心、用户手册的规模化翻译与风格统一
常规风险
| 风险类型 | 说明 | 缓解措施 |
|----------|------|----------|
| 术语不一致 | 长文分块翻译时，若共享提示词遗漏关键术语，可能出现前后译法不一 | 依赖 `02-prompt.md` 中的合并术语表，人工复核专业文档 |
| 语境丢失 | 分块边界若切断长句或逻辑链，可能导致局部理解偏差 | 分块优先在 Markdown 块边界切割，复杂段落建议手动调整阈值 |
| 过度润色 | Refined 模式多次迭代可能偏离原意 | `04-critique.md` 仅诊断不生成译文，强制基于原文修订 |
| 配置漂移 | 多项目共用全局 `EXTEND.md` 时，术语表可能冲突 | 优先使用项目级 `.baoyu-skills/baoyu-translate/EXTEND.md` |
整体而言，baoyu-translate 是少数将"翻译工程化"落地的开源工具，适合对译文质量有硬性要求、愿意投入配置成本的团队。