爱意满满的作品展示区。
BlackHole1

[开源]: EPUB 双语无损翻译

  •  2
     
  •   BlackHole1 ·
    PRO
    ·
    BlackHole1 · Jul 15, 2025 · 6702 views
    This topic created in 475 days ago, the information mentioned may be changed or developed.

    我们之前开源了 pdf-craft。在维护的过程中,我们发现有些用户也非常需要:「 EPUB 翻译」,于是在最近一段时间,我们针对这个需求开源了 epub-translator(MIT 协议)。

    功能特性

    • 多语言互译:支持 英文、中文、日文、西班牙语、法语、德语等主流语言互译。
    • 无损翻译:基于 AI 大模型 100% 保留原书的格式、插图、目录和排版
    • 双语对照:支持双语对照,方便学习和阅读
    • 插入提示词:指导 AI 翻译,如术语表,角色人名表等。
    • AI 模型可选:支持 DeepSeek 、ChatGPT 等主流大模型
    • 高性能并行:AI 请求多路并发,快速翻译整本书籍
    • 错误自恢复:自动重试超时 & 速率限制,长书也能一次跑通
    • OOMOL Studio 一键体验:集成至 OOMOL Studio,提供一键式翻译体验

    安装

    pip install epub-translator
    

    核心用法示例

    from epub_translator import LLM, translate, Language
    
    llm = LLM(
      key="<LLM-API-KEY>", # LLM 的 API key
      url="https://api.deepseek.com", # LLM 的 base URL
      model="deepseek-chat", # LLM 的模型名
      token_encoding="o200k_base", # 计算 tokens 个数的本地模型
    )
    
    translate(
      llm=llm, # 上一步构造的 llm 对象
      source_path="/path/to/epub/file", # 要翻译的原 EPUB 文件
      translated_path="/path/to/translated/epub/file", # 翻译后的 EPUB 保存路径
      target_language=Language.SIMPLIFIED_CHINESE, # 翻译目标语言,此例为简体中文。
      user_prompt="Le Petit Prince 应该译为“小王子”。", # 用户提示词,指导 AI 翻译 (可选)
    )
    

    运行后即可得到保留原版版式的「双语 EPUB 」,在 KOReader / Koodo Reader / Apple Books 等阅读器里直接打开即可

    实际效果

    开源与社区

    我们非常欢迎各位 V 友参与,无论是提交 PR 、反馈问题,还是分享使用经验,都可以帮助我们改进这个工具。

    如果觉得不错,欢迎给项目点个 star ⭐

    你也可以通过 https://oomol.com/community/ 找到我们。

    17 replies  •  2025-07-26 17:37:11 +08:00
    simple233
    simple233
    Jul 15, 2025
    1
    牛的
    byby
    byby
    Jul 15, 2025 via iPhone
    2
    试试,看看和沉浸式哪个效果好
    leic4u
    leic4u
    Jul 15, 2025
    3
    支持,建议早日出个小工具,方便没有 pip 运行环境的人使用。
    ZxykM
    ZxykM
    Jul 16, 2025
    6
    @heyeshuang 同,我也用的这个
    zouzou0208
    zouzou0208
    Jul 16, 2025❤️2
    7
    @lyka @ZxykM 谢谢有点惭愧这个项目有日子没认真维护了,后面我做一些更新
    DaXiGa
    DaXiGa
    Jul 16, 2025❤️1
    8
    翻译好的的小王子可以给个下载链接看看效果吗
    CQCQCQ
    CQCQCQ
    Jul 16, 2025
    9
    @lyka 同用。一般书籍用内置的 Google translate 足矣
    bbroot
    bbroot
    Jul 16, 2025
    10
    支持下
    azhangbing
    azhangbing
    Jul 16, 2025
    11
    平时不用 OOMOL ,在 OOMOL 中应该怎么设置 deepseek 的 APIKEY
    yulgang
    yulgang
    Jul 16, 2025
    12
    卧槽,牛的
    nno
    nno
    Jul 16, 2025
    13
    我自己用 rust 写了个支持 markdown 、html 翻译的,零依赖,打包不到 5M
    lianyanjiajia
    lianyanjiajia
    Jul 16, 2025
    14
    牛的
    DonaldVVV
    DonaldVVV
    Jul 18, 2025
    15
    在科技爱好者周刊看到这个项目了;
    我说怎么眼熟呢,原来是先在 v 站看到过的👍
    lyka
    lyka
    Jul 23, 2025
    16
    @xliao 的确如此。最近试了一下用 chatgpt 的 API 翻了一本书。花了大约 30 元人民币。效果也没有差多少。
    Aixtuz
    Aixtuz
    Jul 26, 2025
    17
    来提个建议:希望参考下 XDG 目录规范,给用户目录下的隐藏文件夹挪挪位置。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   1281 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 48ms · UTC 21:09 · PVG 05:09 · LAX 13:09 · JFK 16:09
    ♥ Do have faith in what you're doing.