---
name: cy-carousel
description: 制作 AI 科技类小红书图文轮播（封面＋10张内页，1440×1920，暗底或浅色纸底，电子青强调色）：讲一个 AI 概念、一篇论文或一个产品，体裁是「AI 学习笔记」。查证一手出处、找开放授权素材（论文原文、真实截图、人物照），用 scripts/手排.py 照 ELIZA 的做法逐页手排（毛笔双色标题、原文纸条放大加红圈、电子青大数字、问句贴条），再用 render.py 渲染、check_all.py 检查、package.py 打包。用户要做 AI/科技/论文/产品类图文，或复用、精修这类轮播时使用。
---

# AI 科技图文轮播

讲清一个 AI 概念、一篇论文或一个产品。读者不是专业人士，要让他一张张翻下去：反差钩子 → 一个看得懂的大例子 → 一句话定义 → 三条编号思考。样板（用户认定最好的两篇，先看它们的节奏和密度）：`examples/01-ELIZA`（暗底）、`examples/02-Dots`（浅色纸底）。另有 `examples/03-聪明汉斯`（老照片＋原书书页＋论文，含完整手排脚本）、`examples/04-AI幻觉`（一场官司讲清一个概念：案卷原文纸条、聊天截图、大字定义）。

## 红线（违反任何一条就不合格）

1. **事实可回溯**：每个数字、引文、日期都回到论文原文、官方页面或一手史料，写进 `research/事实表.md`（陈述、原句、页码/URL、状态、用在哪页）。数字的主语要对（哪个模型、在什么考卷上）；单篇论文的案例不能写成「AI 都这样」；流传但没证据的说法不写。
2. **只用开放授权素材**：公有领域、CC0、CC BY、CC BY-SA，或开放获取论文。记下原链接、许可、SHA256 和用页。不用生成的人物、无关古画、可辨认的陌生人；同一个真实人物含封面最多 3 页。
3. **图上不写出处、授权说明**。出处放置顶评论和 `来源.md`，CC BY 素材在置顶评论里署名。可以有黑底白字的人名/物件小标签；后来年份的照片要在标签里写清，别让人当成事件现场。
4. **不改原文**：纸条和截图是原样裁切，红圈、下划线是后加的标注。为了去掉半个词或无关的前后句可以涂白，置顶评论里说明。位图最多放大 1.25 倍。
5. **不用 `build.py` 的自动版式库**排页面，那套出来的页面「不如之前做的」。`build.py` 只作为渲染和断行的底层库。
6. **不发布**：脚本只出文件，不上传。
7. **参照图不外传**：参照账号/对标作者的图只在本机看和量，不上传到任何外部网站（以图搜图、在线 OCR、图床等），除非用户在对话里明确同意。

## 版式

- **底色**：暗底 `#080808`（`check_all` 只认 ≤8 为纯黑），或浅色纸底（例 02 Dots）；一篇只用一种，不混。浅底上字直接压底，不加白框。拼贴层透明底；整页压暗的照片用 `backdrop()`，darken 0.30–0.70，不要烤进拼贴。
- **标题**：马善政毛笔两行，第一行米白 `#F3F1E9`，第二行电子青 `#00E5FF`，立体投影；英文和数字自动换黑体（`render.py` 的 `latin_font`，`headline()` 已设好）。离页面上边 ≥40px。
- **原文纸条**：论文用 `strip()` 按目标宽度矢量渲染；扫描书页用 `scan_strip()`，词框由 macOS Vision 找（`scripts/ocrfind.swift`，首次自动编译）。只截含关键词的 1–2 行，满宽贴边、不倾斜。关键词画红圈；行距密时改用下划线（`unders`）或页边红竖线（`bars`）；切进来的半个词、半行、无关前后句涂白（`whiteout`）。
- **照片和截图**：`photo()` 不倾斜，`put(..., bleed='right'|'left'|'full')` 贴页边出血，一页一个主角。
- **大字**：关键数字用 `big()`，电子青黑体 120–220px；定义页可以排成大字公式（例 01 第 7 页、例 03 第 7 页）。
- **问句贴条**：`sticker()`，青底深字，每页最多一个，≤20 字。
- **正文**：`body()` 52–66px，每页最多两段、每段 ≤60 字。**字体按题材选**：`body(font=...)` 候选 宋体粗（默认）/宋体/仿宋/楷体/文楷/苹方细；先用 `S.font_sample(同一句, 'out.png')` 出同字对比小样再定，**一篇内只用一款**（标题照旧是毛笔）。
- **排字规则**：`body(..., typo=True)`：「——」画成两段带间隙细线（每段 0.74em、推进 0.86em）、省略号画三个等距圆点、【】约 0.44em、「·」约 0.3em、正文里的数字和拉丁字母换 Times（非 macOS 找不到时回退随包 Noto Serif SC 并警告）并放大 1.07（`latin_scale` 1.05–1.10）。`justify=True` 两端对齐（增量肉眼几乎看不出：字缝最多加 0.05em、空格最多 0.5em，超了整行左对齐；先用标点挤压吸收余量）。`hscale` 横向压缩文字层（参照账号正文约 0.95，默认 1.0）；`headline/big` 也有 `hscale`。数值和原理见 `references/排字细节.md`。
- **图层顺序**：默认文字压在图上。要图片压住文字边缘时用 `Canvas(split_shadow=True)` ＋ `page(..., layer_order='text-under-images')`，顺序变成「底色 → 投影 → 文字 → 图片」。
- **emoji**：组合 emoji（1️⃣ 2️⃣ 👉）用 `S.emoji('1️⃣', 64)` 出透明 PNG 再 `put`，不要塞进正文让字体去画。
- **收尾**：毛笔金句＋三条编号思考；署名只写账号名（水印）。

## 流程

1. **选题**：先列 2–4 个候选，比素材（人物照/截图够不够清晰、许可干不干净、能否凑够 12 份以上不同原素材）、体裁（是不是「什么是 X」或反常识）、事实风险（有没有一手出处、争议多不多），选一个。
2. **查证**：建事实表，写「不写的内容」和「争议与写法」两节。论文用 PyMuPDF 定位要上版面的原句（页码＋0–1 框）。
3. **找素材**：下载原图和论文 PDF，记许可和 SHA256，逐张看图（画面、人脸位置、能不能裁 3:4）。Wikimedia 请求放慢，遇 429 等一分钟。
4. **手排**：先出同字对比小样定正文字体；写 `制作.py`，`import 手排 as S`，`S.init(笔记目录)`；逐页用 `Canvas().put()` 摆图和纸条，用 `headline/big/body/sticker/label` 写字，`page(..., backdrop=...)` 组页，最后 `S.write_script(题目, '制作.py')` 生成 `页面脚本.json`。完整写法见 `examples/03-聪明汉斯/制作.py`。
5. **渲染**：`python3 scripts/render.py 页面脚本.json --out pages --assets-root .`；`S.preview('pages', '全套预览.jpg')` 出缩略图，逐页看：文字出界、压字、红圈标错、纸条带半截字、大块空白。
6. **对照**（有参照页时）：`python3 scripts/对照.py 参照.jpg pages/p03.png` 出左右并排图（同高）和文字行偏差表（四边、字高，1440 宽 px 与 %，超 1% 标红），按表调字号和位置再渲染。
7. **检查**：`python3 scripts/check_all.py 页面脚本.json --pages pages --assets-root .`，`errors` 必须为零。可选严格视觉：加 `--strict-visual`（或页面脚本 `config.visual_gate: true`）后，留白超标和「与前页骨架相同」会列入 `visual_blockers` 并使退出码非零；色彩丰富度、原图数量等依赖体裁的建议项不参与。仅适用于正式稿的暗色调；三页小样和浅色调不跑这两项，会在 `checks.strict_visual` 写明不适用并在终端提示，`visual_blockers` 为空不代表通过。留白/骨架检查自身出错时也计入阻断。默认关闭。风格指标只作参考，别为凑指标改版式。
8. **给用户看**：全套预览、对照图、小样复制到会话工作目录，直接把图发给用户（用户看不到文件面板的预览）。
9. **文稿**：标题 3 个（≤20 字）、正文、置顶评论（一手出处、几处说明、逐页配图出处）、`来源.md`。打包（`package.py`）要求笔记目录里有分别命名的非空 UTF-8 文件 `标题.txt`、`正文.txt`、`置顶评论.txt`、`来源.md`，合并成一份「帖子文案.txt」不行。`素材清单.json`（可选）顶层必须是对象：`{"assets":[{"path":"assets/a.png","sha256":"…"}]}`，写成数组会报错。`check_all` / `package` 的「技术通过」不等于视觉验收，输出里的 `visual_acceptance` 字段始终是「未验收」，advisory 建议项要人工逐页看原尺寸图后处理。
10. **打包**：`python3 scripts/package.py --note . --pages pages --out 交付 --assets-root .`。严格视觉模式下加 `--strict-visual`，有阻断项会拒绝交付；逐页目检确认没问题后用 `--accept-visual "理由"` 放行，理由和被放行的阻断项写入 `交付清单.json` 的 `visual_accepted`。

## 常见坑

- 封面毛笔字里的「AI」要用黑体，否则像「刈」：用 `headline()` 就不会。
- 扫描书页常把数字认错（「14」认成「I4」），找不到词时直接传 0–1 框。
- 整页压暗底图上的文字要避开图里的关键部位（比如马鼻子和数字卡）。
- iCloud 同步目录在磁盘快满时会把文件清出本地（读文件卡死）：长任务前先看 `df -h`；被清出时先 `brctl download <路径>`，或把工程复制到本地临时目录跑，跑完再同步回来。
- 换了正文字体后标点默认用字库自带的全角标点（`tight=False`），只有宋体粗按墨迹收紧；破折号、省略号别用字库字形，开 `typo=True`。
- `hscale` 只压文字，不压图片；位图仍然只能等比缩放。