cy-carousel-skill README

The project's README from github.com/chengyi-ai/cy-carousel-skill. As one markdown file: README.md.

cy-carousel：把一个概念做成十页图文

cy-carousel · 图文轮播 Skill

给一个选题，交回一整套能直接发布的图文轮播。

Claude Code Skill Codex Skill Python 3.10+ 页面 1440×1920 License: MIT 字体 SIL OFL 1.1

看样板 · 能做什么 · 安装 · 使用 · 目录结构 · 常见问题 · 反馈

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

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

样板

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

例 01 · ELIZA 效应（暗底）

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

ELIZA 效应全套预览

例 02 · OpenAI Dots（浅色纸底）

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

OpenAI Dots 全套预览

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

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

聪明汉斯全套预览

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

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

AI 幻觉全套预览

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

能做什么

flowchart LR
    A[选题<br/>2–4 个候选比一比] --> B[查证<br/>事实表回到一手出处]
    B --> C[找素材<br/>只用开放授权]
    C --> D[手排<br/>手排.py 逐页摆放]
    D --> E[渲染<br/>render.py]
    E --> F[检查<br/>check_all.py]
    F --> G[打包<br/>package.py]
    F -. 有错就改 .-> D
步骤 做什么 工具
🎯 选题 列几个候选，比素材、体裁、事实风险，选一个 —
🔍 查证 每个数字、引文回到论文原文或一手史料，写进事实表；单篇论文的案例不写成「AI 都这样」 PyMuPDF 定位原句
🖼️ 找素材 只用公有领域和开放授权素材，记原链接、许可、SHA256 和用页 —
✍️ 手排 照片卡、论文矢量纸条、扫描书页纸条、红圈/下划线/页边竖线、贴边出血、整页压暗底图、人名标签、问句贴条、毛笔双色标题、电子青大数字 scripts/手排.py
✅ 检查 一条命令查红线（图注、页眉、页码、小字、孤字）、文字出界、背景分类 scripts/check_all.py
📦 打包 输出成品文件夹和全套预览。不会自动发布 scripts/package.py

红线

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

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

版式一览

元素 做法
底色 暗底 #080808 或浅色纸底，一篇只用一种
标题 马善政毛笔两行：第一行米白 #F3F1E9，第二行电子青 #00E5FF，英文和数字自动换黑体
原文纸条 论文按宽度矢量渲染，扫描书页用 macOS Vision 找词框；关键词画红圈
照片和截图 不倾斜，贴页边出血，一页一个主角
大字 关键数字用电子青黑体 120–220px
正文 52–66px，每页最多两段、每段 ≤60 字；字体按题材从宋体粗/宋体/仿宋/楷体/文楷/苹方细里选

排字细节（破折号、省略号、两端对齐、横向压缩、图层顺序）见 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')   # 生成 页面脚本.json

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 和事实表没有放进仓库。

常见问题

不是 macOS 能用吗？

能（Windows 同理）。脚本读写一律按 UTF-8，不再依赖系统默认编码；S.init() 不再编译 Swift 工具，OCR（ocrfind）和组合 emoji 只在真正用到时才编译，非 macOS 会给出明确报错。只有扫描书页找词（scan_strip() 依赖的 ocrfind.swift）和 对照.py 的 OCR 要 macOS Vision。找不到词时可以直接给 scan_strip() 传 0–1 的框；论文纸条走 PyMuPDF 矢量渲染，跨平台。

封面毛笔字里的「AI」看着像「刈」？

用 headline() 写标题就不会：英文和数字会自动换成黑体（render.py 的 latin_font）。

会自动发布吗？

不会。脚本只出文件，发布由你自己来。

能用 build.py 的自动版式吗？

不推荐。那套出来的页面不如手排，build.py 只作为渲染和断行的底层库。

反馈

遇到渲染问题或有想法，直接提 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/。示例页面里的素材各有出处和许可，记录在每篇成品的置顶评论里。

cy-carousel-skill (chengyi-ai/cy-carousel-skill)

Searching Database…

410 ·GitHub
Cy-carousel-skill
这是什么？cy-carousel 是面向 AI 编程智能体（Claude Code 或 Codex）的技能（Skill），把一个主题变成一套完整、可直接发布的图文轮播：一张封面图加 10 张内页（1440x1920），并配有相匹配的标题、文案、置顶评论和来源列表。
它是独立应用，还是我在 Claude Code / Codex 里运行的东西？它是技能（Skill），不是独立程序：一个由脚本和说明组成的文件夹，当你描述一个主题时，Claude Code 或 Codex 会照着执行。你从不需要亲自运行可执行文件，只要让智能体生成轮播图就行。
怎么把它跑起来？安装 Python 3.10+ 以及 Pillow 12.1+、numpy 2+ 和 PyMuPDF（见 requirements.txt），然后在 Claude Code 或 Codex 中开启新对话，让它针对你的主题使用 cy-carousel。
它必须配合 Claude Code 或 Codex 才能用吗？是的，这个技能由 AI 编程智能体驱动，在你描述主题后由它替你运行调研、排版和打包脚本。另外，在扫描书页上定位文字位置还需要 macOS Vision。
可以直接用自动排版代替手工排版吗？不建议：自动版本（build.py）生成的页面效果不如手工排版的，项目保留 build.py 只是把它当作底层的渲染和断行库。
它需要 macOS 吗，还是在 Windows 上也能用？在 Windows 上同样可用；脚本现在读写一律使用 UTF-8。只有扫描纸质书页以获取文字框以及照片匹配的 OCR 步骤依赖 macOS Vision。
每个示例项目里包含什么？每个示例文件夹都带有完整的预览图、文案和生成它所用的排版脚本，但原始照片、源 PDF 和事实核查表格被刻意排除在仓库之外。
为什么毛笔字标题要把英文字母换成另一种字体？手写毛笔字体渲染 'AI' 时可能看起来像一个毫不相干的汉字，所以 headline() 函数会自动把拉丁字母和数字切换成无衬线字体以避免混淆。
我可以自己写排版脚本，而不让智能体来做吗？可以，仓库里包含一份完整的手工排版示例脚本，你可以复制并改造，作为自己轮播图的起始骨架。
What are similar projects?guizang-social-card-skill, guizang-yingzao-skill, dbskill, jinba-consulting-pptx-skill, linkedin-agent-skill, Tech-Doc-Style-Chinese, Humanizer-zh, software-certificate-skill
Which topics is it in?xiaohongshu, social-media, typography, chinese-language, claude-code-skill, content-creation, ocr, agent-skill, design, image-processing, skill, pdf
Creator
chengyi-ai
Size
56.3 MB
Stars
410
Updated
CommitOct 14Releasev0.1.1Oct 14
Age
13d
Commits · 90 Days