Skip to content

anbeime/skill / skills/cy-carousel-skill/cy-carousel-skill

cy-carousel

Verified

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

FileKindSize
.github/ISSUE_TEMPLATE/bug_report.ymlconfig1.4 KB
.github/ISSUE_TEMPLATE/config.ymlconfig27 B
.github/ISSUE_TEMPLATE/feature_request.ymlconfig932 B
.github/agent/implement.mdmarkdown1.9 KB
.github/agent/review.mdmarkdown1.5 KB
.github/agent/triage.mdmarkdown2.9 KB
.github/labels.jsonconfig2.2 KB
.github/pull_request_template.mdmarkdown409 B
.github/scripts/apply_triage.pyscript6.4 KB
.github/scripts/dump_issue.shscript509 B
.github/scripts/intake_feedback.pyscript4.0 KB
.github/scripts/open_agent_pr.shscript3.8 KB
.github/workflows/agent-cleanup.ymlconfig1.9 KB
.github/workflows/agent-implement.ymlconfig4.5 KB
.github/workflows/agent-review.ymlconfig2.8 KB
.github/workflows/agent-triage.ymlconfig4.6 KB
.github/workflows/claude.ymlconfig2.9 KB
.github/workflows/feedback-intake.ymlconfig2.0 KB
.github/workflows/sync-labels.ymlconfig798 B
.github/workflows/validate.ymlconfig1.1 KB
.gitignoreother65 B
CLAUDE.mdmarkdown2.3 KB
LICENSEother1.2 KB
README.mdmarkdown10.6 KB
SKILL.mdskill md9.7 KB
assets/banner.jpgbinary422.3 KB
assets/fonts/LXGWWenKai-Medium.ttfbinary24.2 MB
assets/fonts/MaShanZheng-Regular.ttfbinary5.6 MB
assets/fonts/NotoSansSC[wght].ttfbinary16.9 MB
assets/fonts/NotoSerifSC[wght].ttfbinary24.0 MB
assets/fonts/README.mdmarkdown677 B
assets/fonts/licensed/README.mdmarkdown1.0 KB
assets/fonts/lxgwwenkai-OFL.txtmarkdown5.0 KB
assets/fonts/mashanzheng-OFL.txtmarkdown4.3 KB
assets/fonts/notosanssc-OFL.txtmarkdown4.3 KB
assets/fonts/notoserifsc-OFL.txtmarkdown4.2 KB
assets/fonts/来源与许可证.jsonconfig1.3 KB
docs/agent-workflow.mdmarkdown7.8 KB
examples/01-ELIZA/README.mdmarkdown846 B
examples/01-ELIZA/全套预览.jpgbinary408.3 KB
examples/01-ELIZA/标题.txtmarkdown67 B
examples/01-ELIZA/正文.txtmarkdown1.7 KB
examples/02-Dots/README.mdmarkdown875 B
examples/02-Dots/全套预览.jpgbinary408.9 KB
examples/02-Dots/标题.txtmarkdown69 B
examples/02-Dots/正文.txtmarkdown1.8 KB
examples/03-聪明汉斯/README.mdmarkdown1.1 KB
examples/03-聪明汉斯/全套预览.jpgbinary450.1 KB
examples/03-聪明汉斯/制作.pyscript14.2 KB
examples/04-AI幻觉/README.mdmarkdown1.4 KB
examples/04-AI幻觉/全套预览.jpgbinary668.3 KB
examples/04-AI幻觉/制作.pyscript12.7 KB
examples/04-AI幻觉/标题.txtmarkdown131 B
examples/04-AI幻觉/正文.txtmarkdown1010 B
references/排字细节.mdmarkdown6.9 KB
requirements.txtmanifest91 B
scripts/blind_test.pyscript3.6 KB
scripts/build.pyscript43.6 KB
scripts/check_all.pyscript13.3 KB
scripts/cutout.swiftscript858 B
scripts/emoji.swiftscript1.6 KB
scripts/io_paths.pyscript1.0 KB
scripts/layouts_v2.pyscript67.0 KB
scripts/ocr.swiftscript1.3 KB
scripts/ocrfind.swiftscript1.3 KB
scripts/package.pyscript4.0 KB
scripts/render.pyscript47.9 KB
scripts/保脸裁切.pyscript2.1 KB
scripts/图像等比.pyscript3.2 KB
scripts/对照.pyscript12.3 KB
scripts/手排.pyscript26.9 KB
scripts/检测人脸.swiftscript935 B
scripts/浅色排版.pyscript10.3 KB
scripts/验证排版.pyscript23.8 KB
scripts/验证留白.pyscript1.4 KB
scripts/验证背景.pyscript17.5 KB
tests/test_agent_workflow.pyscript7.4 KB
tests/test_cache_and_config.pyscript6.1 KB
tests/test_cross_platform.pyscript5.1 KB
tests/test_render_smoke.pyscript3.8 KB
tests/test_strict_visual.pyscript10.6 KB
tests/test_strict_visual_integration.pyscript6.7 KB
tools/submit_feedback.pyscript2.6 KB
tools/validate_repo.pyscript4.5 KB
<div align="center">

![cy-carousel:把一个概念做成十页图文](assets/banner.jpg)

# cy-carousel · 图文轮播 Skill

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

[![Claude Code Skill](https://img.shields.io/badge/Claude_Code-Skill-D97757?style=flat-square)](SKILL.md)
[![Codex Skill](https://img.shields.io/badge/Codex-Skill-111111?style=flat-square)](SKILL.md)
[![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-3776AB?style=flat-square&logo=python&logoColor=white)](requirements.txt)
[![页面 1440×1920](https://img.shields.io/badge/页面-1440×1920-00E5FF?style=flat-square)](#版式一览)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](LICENSE)
[![字体 SIL OFL 1.1](https://img.shields.io/badge/字体-SIL_OFL_1.1-4CAF50?style=flat-square)](assets/fonts/README.md)

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

</div>

---

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

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

## 样板

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

### 例 01 · ELIZA 效应(暗底)

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

[![ELIZA 效应全套预览](examples/01-ELIZA/全套预览.jpg)](examples/01-ELIZA)

### 例 02 · OpenAI Dots(浅色纸底)

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

[![OpenAI Dots 全套预览](examples/02-Dots/全套预览.jpg)](examples/02-Dots)

### 例 03 · 聪明的汉斯 → 聪明汉斯效应(暗底,含手排脚本)

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

[![聪明汉斯全套预览](examples/03-聪明汉斯/全套预览.jpg)](examples/03-聪明汉斯)

### 例 04 · 律师问 ChatGPT → AI 幻觉(暗底,含手排脚本)

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

[![AI 幻觉全套预览](examples/04-AI幻觉/全套预览.jpg)](examples/04-AI幻觉)

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

## 能做什么

```mermaid
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](SKILL.md#红线违反任何一条就不合格)。

## 版式一览

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

排字细节(破折号、省略号、两端对齐、横向压缩、图层顺序)见 [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
```

装好后新开一个对话。

## 使用

在 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', account='你的账号名')   # 生成 页面脚本.json;account 是水印署名
```

```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
```

连续同骨架按内页的非空 `skeleton` 标签判断。未填写标签仍提示缺少记录,不把空值当作重复布局;严格模式只阻断留白、已知骨架重复及相关检查失败,其他视觉建议保持为建议项。

## 目录结构

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

## 常见问题

<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>
<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)。

## 许可

代码和文档以 [MIT 许可证](LICENSE) 发布。

字体不在 MIT 范围内:仓库自带的 Noto Serif SC、Noto Sans SC、马善政、霞鹜文楷 Medium 都是 SIL Open Font License 1.1,许可证和 SHA256 见 [assets/fonts/](assets/fonts/README.md)。示例页面里的素材各有出处和许可,记录在每篇成品的置顶评论里。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall