gongnyang/bookforge

解决的问题

Bookforge 是一个专为 Claude Code 和 OpenAI Codex 设计的智能技能，旨在从 Markdown 内容自动生成专业级、商业级的电子书 PDF。它通过提供样式包、自动化构建脚本以及严格的品质控制（QC）门禁系统，消除了手动排版和布局设计的过程，防止低质量或格式错误的文档被最终生成。

工作原理

该项目结合了渲染引擎（Typst 和 Chromium/HTML）以及一组预定义的样式包（例如：实用型、洞察型、学术型、论文型、商务型、杂志型），将 Markdown 转换为 PDF。

核心组件包括：

• 样式包：每个包包含特定的排版规则书、字体设置和颜色标记，确保一致的专业外观。
• 图表轨道：支持两种类型的图表：AntV 信息图 DSL（通过提交的供应商捆绑包进行 SSR 渲染）和作者编写的 SVG，这些图表会进行字体大小和配色方案的标准化与验证。
• 目录系统：一个灵活的目录系统，提供六种不同布局，可按书籍进行调整。
• QC 门禁：一套 17 个机械门禁（G0-G17），检查从字体嵌入（Type3 字形）和页面几何（溢出、碰撞）到内容密度和 WCAG 色彩对比度的所有问题。
• 变异测试套件：一个测试框架，向书籍中注入缺陷，以确保 QC 门禁能正确检测错误，而不会产生误报。

适用人群

该工具适用于 AI 代理（特别是 Claude Code 和 OpenAI Codex）以及希望在无需专业排版软件或手动布局调整的情况下生成高质量、可印刷数字书籍的开发者。

主要亮点

• 商业级排版：基于真实商业出版测量的六种独特风格。
• 严格的品质控制：17 个自动门禁，一旦发现布局或可访问性错误，将阻止最终 PDF 的生成。
• 集成图表功能：原生支持 AntV 和自定义 SVG 图表，并具备自动标准化功能。
• 专业级 PDF 输出：配备专用的变异测试套件，防止品质检查出现回归问题。
• 智能工作流：支持「主题模式」（从研究到出版）和「手稿模式」（导入现有草稿）。