技能介绍

它解决什么问题

长篇技术文档、内部分享或专栏文章往往以 PDF、Word、PPT 甚至截图的形式散落着。直接打印或导出，得到的只是普通文档：没有封面、扉页、目录、版权页这类书籍结构，排版也谈不上统一。zeroworld-ebook 做的事，是把这些来源各异的内容整理成一本结构完整的 A5 电子实体书 PDF——封面、扉页、版权页、编者序、目录、章节页、附录、结语、封底一应俱全，正文统一到思源宋体的中文字号与行距。

核心能力与执行流程

输入覆盖面很广：PDF、Markdown、Word、PPT、Excel/CSV、HTML、EPUB、TXT、图片都能处理，图片走视觉识别或 OCR 提取文字。整个流程固定分五步：

Step 1 提取文本：按格式选择提取器，PDF 可用 pdftotext，缺则回退 pdfplumber；Word 走 python-docx，PPT 走 python-pptx，Excel 转 Markdown 表格。表格复杂或版式特殊的页面，用 Read 工具打开原文件目视核对，避免内容被截断。
Step 2 审读与改写：这里有一条铁律——用户正文默认一字不改。只补结构残缺、清格式残留、拆长段，并列出建议清单等用户确认后才动笔。除非用户明确要求，否则不启用补写过渡句和结语的模式 B。
Step 3 规范化：整理为带 YAML front-matter 的 book.md。
Step 4 3D 定制台（强制）：生成书稿后必须打开定制台让用户调封面与正文，不能直接出 PDF。装帧主题提供 7 套皮肤，从深墨蓝金到水墨宣纸，也支持 --theme random 盲盒抽卡；正文区可直接修改书稿全文；参数自动存入浏览器 localStorage。用户点「审阅 / 正式生成」后拿到 book_params.json。
Step 5 质检：统一用 Python 做页数与尺寸检查，再用 Read 打开成品目视确认封面、目录、正文页没有排版崩坏。A5 对应 420×595pt。

不想在浏览器里操作时，CLI 也能一步到位：--params 一次吃进主题、配色、排布、元数据和正文。交付物包括最终 PDF、可继续编辑的 book.md 以及定制台 HTML 副本。

适用边界与注意点

CLI 路径只在用户明确说了「不用调 / 直接出书 / 直接用默认」时才能走。Windows 环境要注意 GTK3 运行时缺失会直接影响 WeasyPrint 可用性，PATH 没配对也会报错；字体发虚是 Linux 的 hinting 配置问题，字体回退成雅黑则说明 Noto Serif SC 没装对或字形名不匹配。结构缺失或表格提取不全时不能凭空补数据，必须先打开原文件核后再动手。适合想要「一本像样的书」的非虚构长文；如果只是需要普通的文档转换，用这个属于杀鸡用牛刀。