宝玉翻译

其他 社区

技能解读

baoyu-translate 把翻译做成三档分级(quick / normal / refined),每档的取舍透明:要快还是要好,自己选。

三档对比

按 Modes 章节:

  • quick(快译):直翻最快,最忠实于原文,适合内部参考
  • normal(精校):基于 quick 做语言润色 + 上下文分析,适合对外发表的双语版
  • refined(重写 / 全文重写):按目标语言写作习惯重组结构,可能改章节顺序、合并段落,适合跨文化内容

每档对应不同的处理深度——quick 1 倍 token,refined 可能 5–10 倍 token。

Defaults

默认档可在 preferences.md 配置(比如 normal);当前会话临时切换可用命令参数。

工作流

按 Workflow:① 读输入文档(Markdown / 纯文本 / docx);② 决定模式;③ Quick 直翻;Normal 翻完再过一遍润色;Refined 还要做章节级重排 + 自检;④ 输出译文;⑤ 双语对照(可选)方便审校。

关键设计

作者强调技术文档里的细节——「reduce friction」直翻成「减少摩擦」很怪,refined 档会处理成「降低使用门槛」。这种「保留写作意图」的能力是它和纯机翻最大的差别。

Extension Support

EXTEND.md 提供扩展:你可以接入术语表(保证某个词永远翻成你定的版本)、风格指南(保持公司一致的语气)、目标受众(学生 vs 专业人士不同译法)。

适合谁

  • 中英双语博客作者,每篇要发双语版
  • 产品文档国际化(i18n),需要保持术语一致
  • 内容团队翻译用户研究、行业报告
  • 技术作者把自己的英文博客翻成中文(或反向)

不适合

  • 法律 / 医疗 / 合规内容——不容意译,必须人工终审
  • 文学翻译(小说、诗)——refined 档可能有用,但人工修订仍是必须
  • 实时同传 / 视频字幕——用专门的语音 + 翻译流水线

配套

和 baoyu-format-markdown 配合:先把粗稿整成干净 Markdown,再翻;用 baoyu-post-to-wechat / -x 发布。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@JimLiu · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Bun
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步:加载首选项

1.1 检查 EXTEND.md(请参阅上面的“首选项”部分) 1.2 加载语言对的内置术语表(如果有):EN→ZH:references/glossary-en-zh.md 1.3 合并术语表:EXTEND.md `glossary`(内联)+ EXTEND.md `glossary_files`(外部文件,相对于 EXTEND.md 位置的路径)+内置词汇表 + `--glossary` 文件(CLI 覆盖所有)

02
第 2 步:具体化源代码并创建输出目录

物化源(按原样文件,内联文本/URL→保存到`translate/{slug}.md`),然后创建输出目录:`{source-dir}/{source-basename}-{target-lang}/`。如果未指定`--from`,则检测源语言。完整详细信息:references/workflow-mechanics.md 输出目录内容(所有中间文件和最终文件都在此处):文件·模式·描述`translation.md`·全部·最终翻译(始终是此名称)

03
第 3 步:评估内容长度

快速模式不会分块——无论长度如何,都会直接翻译。翻译之前,估计一下字数。如果内容超过块阈值(默认 4000 个单词),则主动发出警告:“本文有 ~{N} 个单词。快速模式无需分块即可一次性翻译 — 对于长内容,`--mode normal` 会产生更好的结果,并且术语一致。”如果用户不切换则继续。对于普通模式和精细模式:

04
第 4 步:翻译和优化

翻译原则(适用于所有模式):重写,而不是翻译:将内容重写为自然、引人入胜的目标语言,就像熟练的母语作家从头开始编写一样。质量测试:“这读起来是否像最初用目标语言编写的?”准确性第一:事实、数据和逻辑必须与原文完全一致自然流:使用惯用的目标语言词序。将长源句子分解为较短、自然的句子。按预期含义而不是逐字解释隐喻和习语

05
第五步:输出

最终翻译始终位于输出目录中的`translation.md`。编写最终翻译后,进行轻量级图像语言传递: 从翻译的文章中收集图像参考 识别可能包含大量文本的图像,例如封面、屏幕截图、图表、图表、框架和信息图表 如果任何图像可能包含与翻译的文章语言不匹配的主要文本语言,主动提醒用户

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。