核心用法
baoyu-translate 是一款功能完善的文档翻译技能，采用 TypeScript 脚本实现，支持通过 CLI 或 Agent 工具调用。用户可通过 /translate 指令发起翻译，支持文件路径、URL 或内联文本作为输入源。
三种翻译模式满足不同质量需求：
- Quick（快翻）：直接翻译，适合短文本、非正式内容
- Normal（标准）：先分析后翻译，适合一般文章、博客（默认模式）
- Refined（精翻）：分析→翻译→审校→润色四步流程，追求出版品质
智能分块机制：当内容超过 4000 词阈值时，自动启用分块翻译。系统会先提取术语建立会话级术语表，再通过子代理并行处理各区块，最后合并输出，确保长文档的术语一致性。
术语管理系统：支持多级术语表合并——内置词库（如 EN→ZH）+ EXTEND.md 自定义词库 + CLI 传入词库文件，实现专业领域的精准翻译。
9 种翻译风格预设：从 storyelling（叙事流畅）到 technical（技术文档风）、academic（学术严谨）、humorous（幽默适配）等，覆盖多元场景。支持自定义风格描述。
首次配置引导：若未检测到 EXTEND.md 配置文件，系统会主动询问目标语言、默认模式、受众、风格等偏好并保存，避免静默使用不合预期的默认值。
显著优点
1. 质量分层设计：三档模式让用户按需选择，避免"过度翻译"浪费算力，也确保重要文档可达出版标准
2. 术语一致性保障：长文档分块翻译时，通过前置术语提取和共享上下文（02-prompt.md）确保跨块术语统一
3. 翻译原则专业：强调"译意而非译词"，要求处理隐喻、习语时按目标语言自然表达重构，保留情感色彩而非字面直译
4. 输出结构完整：保留所有 Markdown 格式，智能处理 YAML frontmatter（区分源数据字段与翻译字段），并主动提醒图片语言本地化需求
5. 可扩展配置：EXTEND.md 支持自定义默认语言、模式、受众、术语表、分块阈值等，适合团队或个人建立翻译规范
潜在局限
1. 运行时依赖：需要 Bun 或 npx 环境，对纯浏览器/无 Node 环境不友好
2. 子代理依赖：分块翻译的并行效率依赖 Agent 工具可用性，否则降级为串行处理
3. 术语表维护成本：专业领域翻译效果取决于用户主动维护 EXTEND.md 词库，无内置领域词典（如医学、法律）
4. 图片处理局限：仅提醒可能的图片语言不匹配，不自动执行 OCR 或图像本地化
5. 审校深度边界：精翻模式的"审校"由 LLM 自检完成，非人工专家审校，对高度专业或敏感内容仍需人工复核
适合人群
- 内容创作者：需要将外文博客、教程本地化为中文
- 技术文档工程师：翻译 API 文档、技术规范，依赖 technical 风格和术语表
- 学术研究者：使用 academic 风格翻译论文，保持术语严谨
- 出版/媒体团队：通过 refined 模式追求接近人工翻译的出版质量
- 多语言运营团队：建立统一的 EXTEND.md 配置，确保团队翻译风格一致
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 术语误译 | LLM 可能将专业术语按通用含义翻译 | 维护 EXTEND.md 术语表，关键术语首现标注原文 |
| 长文档一致性 | 分块边界可能导致跨块指代不一致 | 使用 normal/refined 模式，依赖共享上下文机制 |
| 文化隐喻失真 | 幽默、双关等可能无法在目标语言还原 | 选择 humorous 风格并人工复核，必要时加注 |
| 敏感信息泄露 | 翻译内容可能经过外部 API | 确认部署环境的 data retention 政策，敏感文档考虑本地模型 |
| 图片文字遗漏 | 图表截图中的文字不会被翻译 | 主动查看系统提示的图片本地化清单，人工处理 |
整体而言，baoyu-translate 是一款设计精良、可配置性强的翻译工具，在开源技能中属于功能完整度较高的方案，适合对翻译质量有梯度要求的用户群体。