Wenyi断点续跑完全指南为什么再运行同一条命令就能接着翻译【免费下载链接】wenyi将被语言阻隔的作品带到读者的语言中。Bringing literature into your language.项目地址: https://gitcode.com/BigDawnGhost/wenyiWenyi文译是一个面向长文本的 AI 翻译项目把整本书放进全局视野里翻译。它最大的实用特性之一就是断点续跑翻译中断后你不需要重新来过再运行同一条命令就能从上次停下的地方继续。这篇指南帮你彻底理解它背后的机制和正确用法。上图的运行记录显示了 3 次独立运行——这正是断点续跑最典型的痕迹每次中断后重新执行命令都会追加一条新的运行记录而不是推倒重来。为什么长文本翻译特别需要断点续跑翻译一本小说通常需要数小时全书预扫、逐章翻译、润色、审校每一步都在调用大模型。这么长的时间里意外几乎不可避免 网络抖动、API 超时、限流HTTP 429 电脑休眠、进程被 CtrlC 或强制关闭 模型额度用尽、余额不足如果每次都从头翻译不仅浪费时间还会白白消耗 Token 费用。Wenyi 的设计目标就是随时可以中断随时可以接上。为什么再运行同一条命令就能接着翻译秘密在于三个设计它们共同构成了状态即进度的机制。1️⃣ 每个完成的批次都立即落盘状态目录是唯一真相Wenyi 不会等整本书翻译完才保存。每翻译完一个批次一批段落就立刻写入本地状态目录state/书名/targets/目标语言/章节中间结果、术语 SQLite 库、用量和报告都在这里。由于每个批次完成后即刻持久化即使进程下一秒就被杀掉已完成的译文也安全保存在磁盘上。相关的持久化逻辑可以在 packages/core/wenyi_core/pipeline/runstore.py 中查看状态存储统一走 packages/core/wenyi_core/storage/protocol.py 协议。2️⃣ manifest 用 SHA-256 哈希绑定源文件确保接的是同一本书状态目录里的manifest.json记录了源文件的 SHA-256 哈希。再次运行时Wenyi 会先核对文件身份✅ 同一份源文件 → 校验通过继续续跑❌ 同名文件但内容变了 →拒绝续跑要求重建状态这一步防止了状态对不上号的尴尬比如你换了个修订版的 EPUB旧译文不能直接套在新内容上。初始化是最后提交 manifest 的保证写入的原子性。3️⃣ 已有译文自动跳过只补齐未完成部分续跑时Wenyi 会先分离已完成与待译批次已完成的章节和段落直接跳过不产生任何模型调用和费用只针对未完成部分继续翻译并按原文顺序重新确定衔接上下文。开启润色时更精细章节 JSON 中每个段落的target_before_polish保留翻译阶段的译文target保留润色后的最终译文——哪一步做完了就从哪一步之后接着走。实战三步中断后如何续跑第 1 步中断或发现中断无需任何特殊操作。CtrlC、断网、关机都可以。中断后已落盘的批次不受影响。第 2 步用同一个源文件再运行同一条命令uv run wenyi translate book.epub命令完全一样Wenyi 自动识别到已有状态跳过已完成部分继续翻译。第 3 步用 status 查看进度wenyi status book.epub可以随时确认章节完成情况和累计时长。timing.json只累计实际执行时间两次运行之间的停机时间不计入。 小技巧也可以先用wenyi prepare book.epub只做准备解析、风格分析、初始术语表不翻正文之后再跑translate复用状态继续翻译。常见疑问 FAQQ中断了 3 次会重复翻译或重复计费吗不会。已完成批次命中缓存直接跳过Token 用量在各次运行间累加到同一份usage.json不会重复计费。Q改了源文件内容还能续吗不能直接续。manifest 的哈希校验会拒绝并提示重建状态——这是保护你的译文不被套在错的内容上。Q审校Review也支持续跑吗支持但语义不同。审校每次都会全量重审完整译文并创建新的时间戳审校目录interrupted和failed状态的审校都可续跑下次review继续同一目录而不是新建。详见 docs/zh/pipeline.md — 断点续跑。QSRT 字幕翻译也能续跑吗能。字幕走轻量路径进度落在state/srt/slug/targets/目标语言/batches/中已缓存的批次会跳过实现逻辑在 packages/core/wenyi_core/srt/store.py。Q想从头重新翻译怎么办只有这时才需要清理对应的状态目录或改用新的目标目录。状态目录里都有什么断点以 SRT 为例目录结构一目了然书籍目录类似额外含章节 JSON 与术语库state/srt/slug/targets/目标语言/ manifest.json # 源身份、字幕条数、配置 cues.jsonl # 每行一条字幕的翻译状态 batches/ # 模型原始批次结果供续跑 usage.json # 跨续跑累计 token timing.json # 累计执行时长与每次运行用时 events.jsonl # 运行事件与 LLM 重试记录书籍状态目录还包含glossary.db术语 SQLite 库和reviews/审校记录。完整说明见 docs/zh/usage.md — 中断与续跑。续跑之后直接导出成品断点续跑还有一个隐藏福利——assemble可以在不调用任何模型的情况下把当前已落盘的一致快照重新导出为成品。就算另一个终端还在继续翻译导出读取的是调用时已落盘的快照不必等整本书结束。总结Wenyi 断点续跑的本质可以概括为一句话批次级检查点 内容哈希校验 幂等跳过。每批译文立即落盘 → 中断不丢进度manifest 哈希绑定源文件 → 保证续的是同一本书已有译文自动跳过 → 不重复翻译、不重复计费所以再运行同一条命令不是玄学而是状态目录在默默替你记账。把长篇小说放心地交给 Wenyi睡一觉起来接着跑就好 更多机制细节可参考 docs/zh/pipeline.md 与 docs/zh/architecture.md。【免费下载链接】wenyi将被语言阻隔的作品带到读者的语言中。Bringing literature into your language.项目地址: https://gitcode.com/BigDawnGhost/wenyi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考