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 輸出：配備專用變異測試套件，防止品質檢查出現回歸問題。
• 智能工作流程：支援「主題模式」（從研究到出版）與「手稿模式」（導入現有草稿）。