Book-PDF：书籍级PDF手册全流程
从一个主题到100页+专业PDF。五个阶段：调研 → 规划 → 写作 → 构建 → 版本更新。
前置依赖
- Node.js >= 16
- Playwright：
npm install playwright && npx playwright install chromium
参考资料导航
| 需要时读取 | 文件 | 内容 |
|---|---|---|
| 写HTML片段时 | references/design-system.md | CSS变量、主题、组件HTML速查、视觉红线 |
| 新建项目时 | templates/ 目录 | 可直接复制的骨架文件（build.js/build-pdf.js/update.sh/styles.css） |
| 参考已有项目时 | 01-公众号写作/_过程文件/openclaw-guide/ | 首个实战项目（8 Part、35节、100页+） |
项目初始化
用 init 脚本一键创建项目骨架：
bash scripts/init-project.sh <项目目录> <手册标题>
# 示例：bash scripts/init-project.sh ./my-guide "Python完全指南"
自动创建目录结构、复制模板文件、生成 version.json/CHANGELOG.md/PROJECT.md、检查依赖。
项目结构
{项目名}/
├── PROJECT.md # 项目中枢（大纲+进度+数据速查）
├── styles.css # 共享CSS（从templates/复制）
├── build.js # HTML合并脚本（从templates/复制，改FRAGMENT_ORDER）
├── build-pdf.js # Playwright PDF渲染（从templates/复制）
├── update.sh # 一键版本更新（从templates/复制）
├── version.json # {"version":"1.0.0","build":1,"lastUpdate":"","title":""}
├── CHANGELOG.md # 更新日志
├── fragments/ # 内容片段（纯HTML，不含<html><head>）
│ ├── 00-cover.html / 01-toc.html
│ ├── part{N}-{中文简称}.html
│ ├── appendix.html / 99-backpage.html
├── research/ # 调研资料
├── output/ # {title}-v{version}.html/.pdf
└── versions/ # 历史PDF存档
阶段1：调研
- 与用户确定主题和目标读者
- 拆分调研维度（6-10个方向）
- 启动多个background agent并行调研，每份保存到
{项目目录}/research/YYYY-MM-{关键词}.md - 调研完成后汇总，进入规划
阶段2：规划
编辑项目目录下的 PROJECT.md，包含：
- 章节大纲表（Part + 节号 + 标题 + 核心内容 + 信息来源）
- 调研资料索引（路径 + 摘要 + 状态）
- Agent并行分工方案（关联性强的Part分给同一个agent）
- 进度追踪表 + 关键数据速查
修改 build.js 中的 FRAGMENT_ORDER。与用户确认大纲后进入写作。
阶段3：写作
多Agent并行，每个agent输出一个HTML片段。
每个写作agent需要：
- 读取 references/design-system.md 了解可用组件和片段结构规范
- 读取对应调研资料
- 输出纯HTML片段（不含
<html><head><style>标签，只写正文内容）
⚠️ 片段结构铁律（必须在agent prompt中明确告知）
每个正文片段必须遵循以下结构，否则PDF排版会出错：
<div class="content">
<h2 class="section-title page-break" id="partN"><span class="num">§0N</span> 标题</h2>
<p class="section-en">English Title</p>
<p class="section-intro">概述</p>
<!-- 正文 -->
</div>
三条规则：
<div class="content">包裹 → 控制左右边距（没有它内容顶边）id="partN"属性 → 目录锚点跳转需要page-breakclass → 每章从新页开始
目录片段使用 .toc + .toc-item + <a href="#partN"> 结构。详见 design-system.md。
品牌水印（封面+尾页必须包含）
所有PDF手册的封面和尾页必须包含以下品牌信息：
封面：
- 作者：
<div class="cover-author"><strong>蒲公英</strong><br>公众号「AI编程蒲公英」· B站「AI编程程序猿-蒲公英」</div>
尾页（class必须是 back-page，带连字符）：
- 社交链接：B站
https://space.bilibili.com/3493114559858979/· 公众号「AI编程蒲公英」 - 详细模板见 design-system.md 和
templates/fragments/99-backpage.html
阶段4：构建
node build.js # 合并片段 → HTML
node build-pdf.js # Playwright → PDF
# 或一键：
./update.sh build # 仅构建
阶段5：版本更新
修改 fragments/*.html 后运行：
./update.sh patch "修正某个错误" # 1.0.0 → 1.0.1
./update.sh minor "更新内容" # 1.0.0 → 1.1.0
./update.sh major "新增章节" # 1.0.0 → 2.0.0
自动：更新version.json → 写CHANGELOG → build HTML（版本号注入封面）→ 生成PDF → 备份到versions/
快速启动清单
- 确定主题、读者、规模
-
bash scripts/init-project.sh <目录> <标题>创建项目 - 修改 build.js 的
FRAGMENT_ORDER - 编辑 PROJECT.md（大纲+调研索引+进度）
- 多Agent并行调研 → 并行写作 →
./update.sh minor "初版"构建