chengyi-ai/cy-carousel-skill

---

一个概念、一篇论文、一个产品，做成 封面＋10 页内页（1440×1920），连同 标题、正文、置顶评论和来源清单 一起交付。

暗底或浅色纸底、电子青强调色，毛笔双色大标题，论文原文放大加红圈，真实截图和人物老照片当主角。全程有事实核查、素材授权记录和自动检查。这套版式是拿一个个 AI 选题（ELIZA、Dots、AI 幻觉、聪明汉斯……）反复测出来的。

样板

四个例子，点图可以进对应目录看详情。

例 01 · ELIZA 效应（暗底）

六十年前的规则程序，在图灵测试里赢了 GPT-3.5。

例 02 · OpenAI Dots（浅色纸底）

不是新模型，是给模型配了一台云电脑。

例 03 · 聪明的汉斯 → 聪明汉斯效应（暗底，含手排脚本）

1904 年的老照片和原书书页：马在看提问人的头；接到 AI 模型盯着图片角落的标签拿高分。

例 04 · 律师问 ChatGPT → AI 幻觉（暗底，含手排脚本）

一场官司的公开案卷：法院命令、宣誓书里的 ChatGPT 截图、NIST 定义原文。

每篇的节奏都是：反差钩子 → 一个看得懂的大例子 → 一句话定义 → 三条编号思考。

能做什么

flowchart LR
    A[选题2–4 个候选比一比] --> B[查证事实表回到一手出处]
    B --> C[找素材只用开放授权]
    C --> D[手排手排.py 逐页摆放]
    D --> E[渲染render.py]
    E --> F[检查check_all.py]
    F --> G[打包package.py]
    F -. 有错就改 .-> D

红线

事实可回溯 · 只用开放授权素材 · 图上不写出处 · 不改原文（位图最多放大 1.25 倍）· 不自动发布 · 参照图不外传

完整的七条红线写在 SKILL.md。

版式一览

排字细节（破折号、省略号、两端对齐、横向压缩、图层顺序）见 references/排字细节.md。

安装

需要：Python 3.10+、Pillow 12.1+、numpy 2+、PyMuPDF（见 requirements.txt）。扫描书页找词要 macOS（Vision）。

Claude Code

git clone https://github.com/chengyi-ai/cy-carousel-skill.git ~/.claude/skills/cy-carousel
python3 -m pip install -r ~/.claude/skills/cy-carousel/requirements.txt

Codex

git clone https://github.com/chengyi-ai/cy-carousel-skill.git ~/.codex/skills/cy-carousel
python3 -m pip install -r ~/.codex/skills/cy-carousel/requirements.txt

装好后新开一个对话。

使用

在 Claude Code 或 Codex 里直接说：

用 cy-carousel 做一篇 AI 图文，讲「什么是聪明汉斯效应」，素材要有人物老照片和论文原文，照例 01 ELIZA 的节奏、例 03 的手排脚本来做，做完给我看全套预览。

想自己动手，手排脚本的骨架是这样（完整写法见 examples/03-聪明汉斯/制作.py）：

import 手排 as S

S.init('笔记目录')
# 逐页：Canvas().put() 摆图和纸条 → headline / big / body / sticker / label 写字 → page() 组页
S.write_script('题目', '制作.py', account='你的账号名')   # 生成 页面脚本.json；account 是水印署名

python3 scripts/render.py 页面脚本.json --out pages --assets-root .
python3 scripts/check_all.py 页面脚本.json --pages pages --assets-root .   # errors 必须为零
python3 scripts/package.py --note . --pages pages --out 交付 --assets-root .
# 可选严格视觉（默认关闭）：留白超标/连续同骨架时拒绝交付；目检后可 --accept-visual "理由" 放行并写入清单
python3 scripts/package.py --note . --pages pages --out 交付 --assets-root . --strict-visual

目录结构

cy-carousel/
├── SKILL.md              AI 读取的主说明：红线、版式、流程、常见坑
├── README.md
├── LICENSE             MIT（字体除外）
├── requirements.txt
├── scripts/
│   ├── 手排.py            手排工具（AI 线的入口）
│   ├── render.py          渲染（毛笔标题的英文数字用 latin_font 换黑体）
│   ├── check_all.py       红线和技术检查
│   ├── package.py         打包成品
│   ├── 对照.py            参照页 vs 我们的页：并排对照图＋文字行偏差表
│   ├── blind_test.py      盲测拼图
│   ├── build.py  layouts_v2.py  …   底层库（断行、字体配置），不直接用来排版
│   ├── ocrfind.swift  ocr.swift  cutout.swift  检测人脸.swift   macOS Vision 工具
│   └── emoji.swift        组合 emoji 渲染成透明 PNG（AppKit）
├── references/
│   └── 排字细节.md         正文字体候选、标点混排、两端对齐、横向压缩、图层顺序、对照测量
├── assets/
│   ├── banner.jpg         README 头图
│   └── fonts/             Noto Serif SC、Noto Sans SC、马善政、霞鹜文楷（附 OFL 许可证）
└── examples/
    ├── 01-ELIZA/          暗底样板：全套预览、逐页文案
    ├── 02-Dots/           浅色纸底样板：全套预览、逐页文案
    ├── 03-聪明汉斯/        全套预览、制作.py（手排脚本写法）
    └── 04-AI幻觉/          全套预览、制作.py、标题/正文

维护用的文件不属于 Skill 流程：CLAUDE.md（给 Agent 的项目约定）、tools/（仓库检查、登记反馈）、tests/、docs/、.github/（CI 与反馈处理工作流）。

示例只带全套预览、文案和制作脚本，原图、论文 PDF 和事实表没有放进仓库。

常见问题

反馈

遇到渲染问题或有想法，直接提 issue，渲染问题附上出问题那一页的截图。

提交后 Agent 会自动读代码评估可行性，在 issue 下回复结论和实现思路；维护者确认后由 Agent 写代码、跑测试、提 PR，合并前一定有人审。社媒、群聊里的反馈也能登记进来，整套流程和配置见 docs/agent-workflow.md。

许可

代码和文档以 MIT 许可证 发布。

字体不在 MIT 范围内：仓库自带的 Noto Serif SC、Noto Sans SC、马善政、霞鹜文楷 Medium 都是 SIL Open Font License 1.1，许可证和 SHA256 见 assets/fonts/。示例页面里的素材各有出处和许可，记录在每篇成品的置顶评论里。