claude-style-pdflisted

# Claude 风格 PDF 工作流 把一句话主题、一份大纲、或一篇文档，转成视觉上忠实于 Claude.ai 调性的**暖纸风 PDF**。 作者写 **Markdown**，CSS 主题负责好看；Python 把它渲染成 PDF。 ## 第一性原则：三条试金石（与 PPT skill 同源） 1. **纸感**：背景温润米色 `#F4EEE1`，强调赭红 `#A6645A`，正文暖墨黑 `#2C2826`。**绝不出现冷色**（蓝/绿/紫/冷灰）。 2. **节奏**：全衬线（中文思源宋体、西文 Source Serif Pro），行高 1.6，正文测距 ~32 字，字号梯度收窄。让人"读"而非"扫"。 3. **克制**：无阴影、无渐变、圆角≤4px、边框≤0.5pt。装饰只允许引用竖条/波浪线/章节编号/年轮四种；赭红是稀缺高光，每页 `==变色==` 最多 2-3 处，优先用波浪线/加粗。 设计 token 固化在 `scripts/theme.py`（与 PPT 的 `tokens.py` 同色），改色/改字号只动这一处。 ## 工作流（状态机） ### 0. SCENE — 场景采访（用户未说明用途时先问） > 这份文档用于什么场景？(知识分享/学习笔记 · 报告 · 文章随笔 · 白皮书 · 方案提案 · 操作指南，或直接描述) 场景决定：是否要封面/目录、密度（`density`）、是否自动章节编号（`numbered`）、用哪些块。 ### 1. INTAKE — 识别输入 | 输入 | 处理 | |---|---| | 一两句话主题 | 你生成大纲与全部正文 | | 大纲 | 你按大纲填正文 | | 长文档 | 切章节、提炼，保留原意 | ### 2. PLAN — 列章节结构 用 `#`/`##`/`###` 规划层级。每个一级章节是一个 `#`。长文每 1-2 个大章节前可放一个**章节分隔整页**（`::: divider`）。 ### 3. WRITE — 写 Markdown 写到工作目录的一个 `.md`，结构见下方「作者契约」。 ### 4. BUILD — 渲染 ```bash python scripts/build_pdf.py <输入.md> --output "<桌面或指定>.pdf" -v ``` 不要 AI 配图占位时加 `--no-images`。 ### 5. DELIVER — 交付 读 stdout 摘要 JSON（页 md、是否目录、内嵌图/占位图数），用自然语言告知用户：生成到哪、是否含占位图（需补真实配图）。 ## 作者契约：Markdown + frontmatter + 块指令 ### frontmatter（YAML，文件顶部） ```yaml --- title: 文档标题 # 必填（封面/页眉用） subtitle: 副标题 # 可选 author: 作者 # 可选 date: 2026-05-31 # 可选 doc_type: notes # 语义标记：notes/report/article/whitepaper/guide language: zh-CN density: medium # low | medium | high → 整体字号微调 cover: true # 是