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片段（不含

Book-PDF: 书籍级PDF手册全流程

概述