技能介绍

要解决的问题

把一份定稿书稿真正推上 Amazon，难点不在最后那个"点发布"，而在中间的格式链路：Kindle 电子书、平装、精装在 KDP 里是三个独立 Title，却共享同一个商品页，各自的排版、封面、分页策略都不一样。手搓 EPUB 时，ebooklib 有几个静默陷阱会让页面输出 0 字节却仍然"校验通过"；封面如果自己画印张 PDF，书脊宽度算错，整批就废。这个技能把整条链路脚本化，只把不可逆的点击交回给人。

流水线如何工作

锁定源文件：Google Doc 通过 export?format=docx 导出干净 DOCX，不走复制粘贴；同时核对文档内的版本戳，确认真是终稿而不是文件名骗人。
构建 EPUB：scripts/build_epub.py 用 mammoth 转 HTML、ebooklib 打包，自动补上多数书稿缺失的版权页、988 心理危机声明和可导航目录，并保留正文插图。
校验：scripts/validate_epub.py 调用 epubcheck，脚本里已写死三个 ebooklib 陷阱：带编码声明的字符串会返回空 body、CSS 必须用 add_link 注册、封面页要设 is_linear 并关掉 epub3_pages。
封面：先用 Nano Banana 生成无文字的封面画，再交给 KDP Cover Creator 排字并自动算书脊；电子书前封直接复用 Cover Creator 导出的约 1600×2560 JPG。
纸质版：不自制 6×9 内页 PDF，直接把 DOCX 上传给 KDP 分页，选黑白内页 + 6×9 开本。
元数据与发布：按模板填 3 个 BISAC、7 个关键词、AI 内容披露、定价与发布计划，再带着用户走完 Details → Content → Pricing → Publish，并把出版记录写回知识库。

注意点与边界

代理不输入密码、不驱动系统文件选择器，这些必须由用户本人完成；KDP 账号还要提前配好两步验证和税务/银行信息，否则版税收不回来。两个脚本顶部的 CONFIG 块要按书修改，它们是模板不是黑盒。精装定价存在隐性坑（walkthrough 有说明），epubcheck 依赖 PATH 上的 Java。