paged-reports 的用途是把 Markdown 转成适合打印的文档,流程为:markdown → 带品牌 token 的 HTML 模板 → paged.js 分页 → PDF(或浏览器预览、杂志模式 URL)。该技能只负责排版机制,字体、颜色、字号由项目品牌决定。
使用方式:先按优先级读取品牌 token——项目 DESIGN.md 的 frontmatter 为规范来源,其次项目内品牌技能(Focus.AI 为 focus-ai-brand),都没有则询问,不要自行编造配色。随后读取源 Markdown 并选择模式:standard(浏览器预览)、paged(PDF 交付)、magazine(可分享滚动 URL),映射见 references/paged-system.md。从 templates/ 选择模板,Focus.AI 提供 client 与 labs 各含 standard、paged 共四套,项目可复制并替换顶部 token 块。按分页约定组织结构:使用 .section 包裹、封面后第一节加 .no-break-before、需保持完整的元素设 break-inside: avoid,先阅读“Smart Page Break System”再写 HTML。渲染时把 HTML 写入临时路径,再打开预览或驱动无头 Chrome 生成 PDF。生成后应查看输出(打开 PDF 或转成图片检查),确认没有孤行标题、跨页表格或封面后空白页。
PDF 生成依赖 browser-automation 技能(chrome-driver)提供 pdf 二进制: PDF_BIN=$(ls -d ~/.claude/plugins/cache/focus-marketplace/chrome-driver/*/bin/pdf | sort -V | tail -1) $PDF_BIN "file:///tmp/report-$(date +%s).html" ./output.pdf 若未安装 chrome-driver,应回退到浏览器打印路径,而非把 HTML 当作 PDF 交付。
注意事项:字体必须在分页前加载,使用 PagedConfig = { auto: false } 并在 document.fonts.ready 内调用 preview();打印需 print-color-adjust: exact 以保留背景;避免纯白与纯黑;封面后空白页通常源于第一节继承了 break-before: page,用 .no-break-before 修正;magazine 模式面向屏幕,若交付物是 PDF 应直接用 paged 模式。参考主题包括模式与 /report 参数、智能分页、页眉页码与 @page 规则、封面与卡片等组件、magazine 模式及 paged.js 初始化,详见 references/paged-system.md 与 templates/。