chengyi-ai/cy-carousel-skill

选用指南

AI 根据 README 整理 · 2026/10/11 13:16:05

使用方式

在 Claude Code 或 Codex 中直接描述需求，或使用手排脚本逐页排版，然后运行渲染、检查和打包脚本。

查看 README 依据

在 Claude Code 或 Codex 里直接说： > 用 cy-carousel 做一篇 AI 图文，讲「什么是聪明汉斯效应」，素材要有人物老照片和论文原文，照例 01 ELIZA 的节奏、例 03 的手排脚本来做，做完给我看全套预览。 想自己动手，手排脚本的骨架是这样（完整写法见 [`examples/03-聪明汉斯/制作.py`](examples/03-聪明汉斯/制作.py)）： ```python import 手排 as S S.init('笔记目录') # 逐页：Canvas().put() 摆图和纸条 → headline / big / body / sticker / label 写字 → page() 组页 S.write_script('题目', '制作.py') # 生成 页面脚本.json ``` ```bash 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 打包成品

部署要求

需要 Python 3.10+、Pillow 12.1+、numpy 2+、PyMuPDF；扫描书页找词功能需要 macOS Vision。

查看 README 依据

排字细节（破折号、省略号、两端对齐、横向压缩、图层顺序）见 [references/排字细节.md](references/排字细节.md)。 ## 安装 **需要**：Python 3.10+、Pillow 12.1+、numpy 2+、PyMuPDF（见 [requirements.txt](requirements.txt)）。扫描书页找词要 macOS（Vision）。 **Claude Code** ```bash 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** ```bash 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 ``` 装好后新开一个对话。 ## 使用

已知限制

不会自动发布，只输出文件；build.py 的自动版式不推荐使用；示例仓库不包含原图、论文 PDF 和事实表。

查看 README 依据

<summary><b>封面毛笔字里的「AI」看着像「刈」？</b></summary> 用 `headline()` 写标题就不会：英文和数字会自动换成黑体（`render.py` 的 `latin_font`）。 </details> <details> <summary><b>会自动发布吗？</b></summary> 不会。脚本只出文件，发布由你自己来。 </details> <details> <summary><b>能用 build.py 的自动版式吗？</b></summary> 不推荐。那套出来的页面不如手排，`build.py` 只作为渲染和断行的底层库。 </details> ## 反馈 遇到渲染问题或有想法，直接[提 issue](https://github.com/chengyi-ai/cy-carousel-skill/issues/new/choose)，渲染问题附上出问题那一页的截图。 提交后 Agent 会自动读代码评估可行性，在 issue 下回复结论和实现思路；维护者确认后由 Agent 写代码、跑测试、提 PR，合并前一定有人审。社媒、群聊里的反馈也能登记进来，整套流程和配置见 [docs/agent-workflow.md](docs/agent-workflow.md)。 ## 许可

├── 03-聪明汉斯/ 全套预览、制作.py（手排脚本写法） └── 04-AI幻觉/ 全套预览、制作.py、标题/正文 ``` 维护用的文件不属于 Skill 流程：`CLAUDE.md`（给 Agent 的项目约定）、`tools/`（仓库检查、登记反馈）、`tests/`、`docs/`、`.github/`（CI 与反馈处理工作流）。 示例只带全套预览、文案和制作脚本，原图、论文 PDF 和事实表没有放进仓库。 ## 常见问题 <details> <summary><b>不是 macOS 能用吗？</b></summary> 能（Windows 同理）。脚本读写一律按 UTF-8，不再依赖系统默认编码；`S.init()` 不再编译 Swift 工具，OCR（`ocrfind`）和组合 emoji 只在真正用到时才编译，非 macOS 会给出明确报错。只有扫描书页找词（`scan_strip()` 依赖的 `ocrfind.swift`）和 `对照.py` 的 OCR 要 macOS Vision。找不到词时可以直接给 `scan_strip()` 传 0–1 的框；论文纸条走 PyMuPDF 矢量渲染，跨平台。 </details> <details>