translate-book整书翻译Skill：Git Tag + ClawHub发布流程与Issue优先贡献完整指南

translate-book整书翻译SkillGit Tag ClawHub发布流程与Issue优先贡献完整指南【免费下载链接】translate-bookAgent skill for Codex, Claude Code, and OpenClaw that translates entire books (PDF/DOCX/EPUB) into any language using parallel subagents.项目地址: https://gitcode.com/gh_mirrors/tran/translate-booktranslate-book 是一个面向 Codex、Claude Code 和 OpenClaw 的AI 整书翻译 Agent Skill把整本 PDF/DOCX/EPUB 拆成 chunk交给 8 路并行子代理翻译校验后合并成 HTML/DOCX/EPUB/PDF。本文带你完整走一遍它的Git Tag ClawHub 发布流程并详解项目推崇的Issue 优先贡献指南——无论你是想发版维护者还是想贡献补丁的新手照着做即可。先看懂项目一条可续跑的整书翻译流水线在讨论发布之前先建立对代码仓库的基本认知后面的流程和贡献约定都围绕这套结构展开模块作用SKILL.mdSkill 编排入口定义 8 步工作流转换 → 拆块 → 术语表 → 并行翻译 → 校验 → 合并构建scripts/convert.py输入转换与拆块用 SHA-256 记录每个 chunk 指纹scripts/merge_and_build.py合并译文并生成 book.html / book.docx / book.epub / book.pdftests/纯标准库单测 三档 baseline 整链路测试 仓库把确定性记账交给 Python 脚本把语义翻译交给 LLM 子代理这也是它对发布与贡献如此讲究的原因——任何改动都可能触碰 chunk/manifest 契约。Git Tag ClawHub 三步发布法最快配置方法项目的发布流程固化在 release.md配套说明见 AGENTS.md 与 CLAUDE.md 的 Conventions 一节严格是按顺序执行的三条命令任一失败立即停下报告不做自动恢复第 1 步推送 main 分支git push origin main第 2 步打 Git Tag —— 仓库里唯一的版本锚点git tag v0.3.0 git push --tags注意版本是裸 semver如0.3.0v前缀只加在 Git Tag 上。发布命令对空版本号会直接中止避免打出名为v的裸 tag。不要跳过这一步Git Tag 是整个仓库唯一的版本锚点。第 3 步发布到 ClawHubnpx clawhublatest publish ./ --version 0.3.0 首次在某台机器上发布需要浏览器认证按机器缓存npx clawhublatest login发布失败时的三个处理原则Not logged in→ 先跑login然后只重跑第 3 步Tag 已推、第 3 步因其他原因失败→ 修复原因后用同一版本号只重跑第 3 步绝不擅自git tag -f强推覆盖 Tag除非用户明确批准。三步全部成功后报告已发布版本和各步结果即可。Issue 优先向 translate-book 贡献代码的正确姿势README.zh-CN.md 明确约定请提交详细的 Issue而不是直接从 Pull Request 开始。为什么不建议直接提 Pull Request本项目按 AI 辅助的 Skill 流水线维护每个变更都需要放在同一个维护者掌握的上下文里结合编排规则、chunk/manifest 契约、baseline 资产和发布流程一起评估。因此 PR 不是首选入口可能会被转为 Issue 继续讨论。如果你手头已有 patch请把思路、关键 diff、失败用例或验证结果写进 Issue维护者可能据此重写或拆分后再合入。一篇高价值 Issue 的 4 个要素当前行为 vs 期望行为——一句话讲清差距输入格式与环境——PDF/DOCX/EPUB、操作系统、Python、Calibre、Pandoc 版本最小复现步骤——或可公开的小样本文件日志、截图或生成文件名——能直接定位失败环节。动手改代码前先跑通测试再说话仓库测试几乎零依赖纯标准库在 tests/baselines/README.md 中有三档 baseline 约定# 单测CI 等价秒级 python3 -m unittest discover -s tests -p test_*.py -v python3 -m compileall scripts tests # 整链路冒烟从 tests/.artifacts/ 内跑 baseline mkdir -p tests/.artifacts cd tests/.artifacts python3 ../../scripts/convert.py ../baselines/standard-alice/standard-alice.epub --olang zh三档 baseline 各司其职sleepy-hollow~21 chunk做冒烟standard-alice~38 chunk、约 45 张内嵌图是发布闸门diligent-dick~57 chunk专门压测别名漂移场景。改动glossary或merge_meta时记得带上第三档。关键文件与延伸阅读发布流程原文.claude/commands/release.md贡献与反馈约定README.zh-CN.md 的「反馈与贡献」一节仓库级协作守则AGENTS.md、CLAUDE.md编排细节SKILL.mdStep 4 / 4.5 / 5 覆盖并行翻译与术语表合并协议LICENSEMIT写在最后 记住两条主线即可发布是「push main → git tag → clawhub publish」的严格三连Git Tag 不可跳过贡献从一份写满细节的 Issue 开始让维护者在完整上下文里替你把关实现。把这两点做对你就能与这个项目以同样的节奏协作。【免费下载链接】translate-bookAgent skill for Codex, Claude Code, and OpenClaw that translates entire books (PDF/DOCX/EPUB) into any language using parallel subagents.项目地址: https://gitcode.com/gh_mirrors/tran/translate-book创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考