Skip to content
Back to search

cy-carousel

SkillWorks with Claude CodeGitHub

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chengyi-ai--cy-carousel-skill/badge.svg)](/listings/chengyi-ai--cy-carousel-skill)

HTML

<a href="/listings/chengyi-ai--cy-carousel-skill"><img src="/api/listings/chengyi-ai--cy-carousel-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**需要**:Python 3.10+、Pillow 12.1+、numpy 2+、PyMuPDF(见 [requirements.txt](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

装好后新开一个对话。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 65 lines
  1. ---
  2. name: cy-carousel
  3. description: 制作 AI 科技类小红书图文轮播(封面+10张内页,1440×1920,暗底或浅色纸底,电子青强调色):讲一个 AI 概念、一篇论文或一个产品,体裁是「AI 学习笔记」。查证一手出处、找开放授权素材(论文原文、真实截图、人物照),用 scripts/手排.py 照 ELIZA 的做法逐页手排(毛笔双色标题、原文纸条放大加红圈、电子青大数字、问句贴条),再用 render.py 渲染、check_all.py 检查、package.py 打包。用户要做 AI/科技/论文/产品类图文,或复用、精修这类轮播时使用。
  4. ---
  5. # AI 科技图文轮播
  6. 讲清一个 AI 概念、一篇论文或一个产品。读者不是专业人士,要让他一张张翻下去:反差钩子 → 一个看得懂的大例子 → 一句话定义 → 三条编号思考。样板(用户认定最好的两篇,先看它们的节奏和密度):`examples/01-ELIZA`(暗底)、`examples/02-Dots`(浅色纸底)。另有 `examples/03-聪明汉斯`(老照片+原书书页+论文,含完整手排脚本)、`examples/04-AI幻觉`(一场官司讲清一个概念:案卷原文纸条、聊天截图、大字定义)。
  7. ## 红线(违反任何一条就不合格)
  8. 1. **事实可回溯**:每个数字、引文、日期都回到论文原文、官方页面或一手史料,写进 `research/事实表.md`(陈述、原句、页码/URL、状态、用在哪页)。数字的主语要对(哪个模型、在什么考卷上);单篇论文的案例不能写成「AI 都这样」;流传但没证据的说法不写。
  9. 2. **只用开放授权素材**:公有领域、CC0、CC BY、CC BY-SA,或开放获取论文。记下原链接、许可、SHA256 和用页。不用生成的人物、无关古画、可辨认的陌生人;同一个真实人物含封面最多 3 页。
  10. 3. **图上不写出处、授权说明**。出处放置顶评论和 `来源.md`,CC BY 素材在置顶评论里署名。可以有黑底白字的人名/物件小标签;后来年份的照片要在标签里写清,别让人当成事件现场。
  11. 4. **不改原文**:纸条和截图是原样裁切,红圈、下划线是后加的标注。为了去掉半个词或无关的前后句可以涂白,置顶评论里说明。位图最多放大 1.25 倍。
  12. 5. **不用 `build.py` 的自动版式库**排页面,那套出来的页面「不如之前做的」。`build.py` 只作为渲染和断行的底层库。
  13. 6. **不发布**:脚本只出文件,不上传。
  14. 7. **参照图不外传**:参照账号/对标作者的图只在本机看和量,不上传到任何外部网站(以图搜图、在线 OCR、图床等),除非用户在对话里明确同意。
  15. ## 版式
  16. - **底色**:暗底 `#080808`(`check_all` 只认 ≤8 为纯黑),或浅色纸底(例 02 Dots);一篇只用一种,不混。浅底上字直接压底,不加白框。拼贴层透明底;整页压暗的照片用 `backdrop()`,darken 0.30–0.70,不要烤进拼贴。
  17. - **标题**:马善政毛笔两行,第一行米白 `#F3F1E9`,第二行电子青 `#00E5FF`,立体投影;英文和数字自动换黑体(`render.py` 的 `latin_font`,`headline()` 已设好)。离页面上边 ≥40px。
  18. - **原文纸条**:论文用 `strip()` 按目标宽度矢量渲染;扫描书页用 `scan_strip()`,词框由 macOS Vision 找(`scripts/ocrfind.swift`,首次自动编译)。只截含关键词的 1–2 行,满宽贴边、不倾斜。关键词画红圈;行距密时改用下划线(`unders`)或页边红竖线(`bars`);切进来的半个词、半行、无关前后句涂白(`whiteout`)。
  19. - **照片和截图**:`photo()` 不倾斜,`put(..., bleed='right'|'left'|'full')` 贴页边出血,一页一个主角。
  20. - **大字**:关键数字用 `big()`,电子青黑体 120–220px;定义页可以排成大字公式(例 01 第 7 页、例 03 第 7 页)。
  21. - **问句贴条**:`sticker()`,青底深字,每页最多一个,≤20 字。
  22. - **正文**:`body()` 52–66px,每页最多两段、每段 ≤60 字。**字体按题材选**:`body(font=...)` 候选 宋体粗(默认)/宋体/仿宋/楷体/文楷/苹方细;先用 `S.font_sample(同一句, 'out.png')` 出同字对比小样再定,**一篇内只用一款**(标题照旧是毛笔)。
  23. - **排字规则**:`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`。
  24. - **图层顺序**:默认文字压在图上。要图片压住文字边缘时用 `Canvas(split_shadow=True)` + `page(..., layer_order='text-under-images')`,顺序变成「底色 → 投影 → 文字 → 图片」。
  25. - **emoji**:组合 emoji(1️⃣ 2️⃣ 👉)用 `S.emoji('1️⃣', 64)` 出透明 PNG 再 `put`,不要塞进正文让字体去画。
  26. - **收尾**:毛笔金句+三条编号思考;署名只写账号名(水印)。
  27. ## 流程
  28. 1. **选题**:用户已经给了具体题目(概念、论文、产品)就直接用,跳过这一步;没给题目时先列 2–4 个候选,比素材(人物照/截图够不够清晰、许可干不干净、能否凑够 12 份以上不同原素材)、体裁(是不是「什么是 X」或反常识)、事实风险(有没有一手出处、争议多不多),选一个。
  29. 2. **查证**:建事实表,写「不写的内容」和「争议与写法」两节。论文用 PyMuPDF 定位要上版面的原句(页码+0–1 框)。
  30. 3. **找素材**:下载原图和论文 PDF,记许可和 SHA256,逐张看图(画面、人脸位置、能不能裁 3:4)。Wikimedia 请求放慢,遇 429 等一分钟。
  31. 4. **手排**:先出同字对比小样定正文字体;写 `制作.py`,`import 手排 as S`,`S.init(笔记目录)`;逐页用 `Canvas().put()` 摆图和纸条,用 `headline/big/body/sticker/label` 写字,`page(..., backdrop=...)` 组页,最后 `S.write_script(题目, '制作.py', account='账号名')` 生成 `页面脚本.json`(`account` 是水印署名;不传会印占位符「账号名」)。完整写法见 `examples/03-聪明汉斯/制作.py`。
  32. 5. **渲染**:`python3 scripts/render.py 页面脚本.json --out pages --assets-root .`;`S.preview('pages', '全套预览.jpg')` 出缩略图,逐页看:文字出界、压字、红圈标错、纸条带半截字、大块空白。之后每轮修改加 `--changed-only`,只重渲页面脚本、配置、素材或渲染代码变了的页(终端会列出重渲了哪几页),复查时只看这几页的原尺寸图。
  33. 6. **对照**(有参照页时):`python3 scripts/对照.py 参照.jpg pages/p03.png` 出左右并排图(同高)和文字行偏差表(四边、字高,1440 宽 px 与 %,超 1% 标红),按表调字号和位置再渲染。
  34. 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` 为空不代表通过。留白/骨架检查自身出错时也计入阻断。默认关闭。风格指标只作参考,别为凑指标改版式。
  35. 8. **给用户看**:全套预览、对照图、小样复制到会话工作目录,直接把图发给用户(用户看不到文件面板的预览)。
  36. 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 建议项要人工逐页看原尺寸图后处理。
  37. 10. **打包**:`python3 scripts/package.py --note . --pages pages --out 交付 --assets-root .`。严格视觉模式下加 `--strict-visual`,有阻断项会拒绝交付;逐页目检确认没问题后用 `--accept-visual "理由"` 放行,理由和被放行的阻断项写入 `交付清单.json` 的 `visual_accepted`。
  38. ## 省时间
  39. 做一版的时间几乎都花在 Agent 的来回上,脚本本身不慢(11 页渲染约 6 秒、检查约 10 秒)。下面这些做法省时间,但不放宽任何红线:
  40. - **能并行的就并行**:定下要用哪些一手材料后,写事实表和下载素材可以同时做,有子 Agent 时分头做;素材一次列好、批量下载,算 SHA256 和记许可放在同一个脚本里,别一张一张来回。
  41. - **不做没人要的步骤**:用户给了题目就不列候选;没有参照页就跳过「对照」;字体小样一次把候选字体排在一张图上,定了就不再回头换。
  42. - **改哪页渲哪页**:第一次全量渲染后,用 `render.py --changed-only`,复查时只看重渲的页。它按文件大小和修改时间判断素材、字库有没有换;用 `cp -p` 这类保留修改时间的方式换了同样大小的文件会认不出来,怀疑成图没跟上时去掉 `--changed-only` 全量渲染一次。
  43. - **先看缩略图再看原图**:先看 `全套预览.jpg` 找出有问题的页,只对这些页看原尺寸图;交付前再完整逐页看一遍。
  44. - **问题攒一批再改**:一轮把所有页的问题都列出来,一次改完再渲染,不要改一处渲一次。
  45. ## 常见坑
  46. - 严格视觉的连续同骨架检查依据内页非空的 `skeleton` 标签;未填写时仍提示缺少记录,不把空值判为重复。只在暗色正式稿中阻断,浅色稿和小样保持不适用;其他视觉建议不因该门禁升级为阻断。
  47. - 封面毛笔字里的「AI」要用黑体,否则像「刈」:用 `headline()` 就不会。
  48. - 扫描书页常把数字认错(「14」认成「I4」),找不到词时直接传 0–1 框。
  49. - 整页压暗底图上的文字要避开图里的关键部位(比如马鼻子和数字卡)。
  50. - iCloud 同步目录在磁盘快满时会把文件清出本地(读文件卡死):长任务前先看 `df -h`;被清出时先 `brctl download <路径>`,或把工程复制到本地临时目录跑,跑完再同步回来。
  51. - 换了正文字体后标点默认用字库自带的全角标点(`tight=False`),只有宋体粗按墨迹收紧;破折号、省略号别用字库字形,开 `typo=True`。
  52. - `hscale` 只压文字,不压图片;位图仍然只能等比缩放。
README.md · README · 220 lines
  1. <div align="center">
  2. ![cy-carousel:把一个概念做成十页图文](assets/banner.jpg)
  3. # cy-carousel · 图文轮播 Skill
  4. **给一个选题,交回一整套能直接发布的图文轮播。**
  5. [![Claude Code Skill](https://img.shields.io/badge/Claude_Code-Skill-D97757?style=flat-square)](SKILL.md)
  6. [![Codex Skill](https://img.shields.io/badge/Codex-Skill-111111?style=flat-square)](SKILL.md)
  7. [![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-3776AB?style=flat-square&logo=python&logoColor=white)](requirements.txt)
  8. [![页面 1440×1920](https://img.shields.io/badge/页面-1440×1920-00E5FF?style=flat-square)](#版式一览)
  9. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](LICENSE)
  10. [![字体 SIL OFL 1.1](https://img.shields.io/badge/字体-SIL_OFL_1.1-4CAF50?style=flat-square)](assets/fonts/README.md)
  11. [看样板](#样板) · [能做什么](#能做什么) · [安装](#安装) · [使用](#使用) · [目录结构](#目录结构) · [常见问题](#常见问题) · [反馈](#反馈)
  12. </div>
  13. ---
  14. 一个概念、一篇论文、一个产品,做成 **封面+10 页内页(1440×1920)**,连同 **标题、正文、置顶评论和来源清单** 一起交付。
  15. 暗底或浅色纸底、电子青强调色,毛笔双色大标题,论文原文放大加红圈,真实截图和人物老照片当主角。全程有事实核查、素材授权记录和自动检查。这套版式是拿一个个 AI 选题(ELIZA、Dots、AI 幻觉、聪明汉斯……)反复测出来的。
  16. ## 样板
  17. 四个例子,点图可以进对应目录看详情。
  18. ### 例 01 · ELIZA 效应(暗底)
  19. 六十年前的规则程序,在图灵测试里赢了 GPT-3.5。
  20. [![ELIZA 效应全套预览](examples/01-ELIZA/全套预览.jpg)](examples/01-ELIZA)
  21. ### 例 02 · OpenAI Dots(浅色纸底)
  22. 不是新模型,是给模型配了一台云电脑。
  23. [![OpenAI Dots 全套预览](examples/02-Dots/全套预览.jpg)](examples/02-Dots)
  24. ### 例 03 · 聪明的汉斯 → 聪明汉斯效应(暗底,含手排脚本)
  25. 1904 年的老照片和原书书页:马在看提问人的头;接到 AI 模型盯着图片角落的标签拿高分。
  26. [![聪明汉斯全套预览](examples/03-聪明汉斯/全套预览.jpg)](examples/03-聪明汉斯)
  27. ### 例 04 · 律师问 ChatGPT → AI 幻觉(暗底,含手排脚本)
  28. 一场官司的公开案卷:法院命令、宣誓书里的 ChatGPT 截图、NIST 定义原文。
  29. [![AI 幻觉全套预览](examples/04-AI幻觉/全套预览.jpg)](examples/04-AI幻觉)
  30. 每篇的节奏都是:**反差钩子 → 一个看得懂的大例子 → 一句话定义 → 三条编号思考**。
  31. ## 能做什么
  32. ```mermaid
  33. flowchart LR
  34. A[选题<br/>2–4 个候选比一比] --> B[查证<br/>事实表回到一手出处]
  35. B --> C[找素材<br/>只用开放授权]
  36. C --> D[手排<br/>手排.py 逐页摆放]
  37. D --> E[渲染<br/>render.py]
  38. E --> F[检查<br/>check_all.py]
  39. F --> G[打包<br/>package.py]
  40. F -. 有错就改 .-> D
  41. ```
  42. | 步骤 | 做什么 | 工具 |
  43. |---|---|---|
  44. | 🎯 **选题** | 列几个候选,比素材、体裁、事实风险,选一个 | — |
  45. | 🔍 **查证** | 每个数字、引文回到论文原文或一手史料,写进事实表;单篇论文的案例不写成「AI 都这样」 | PyMuPDF 定位原句 |
  46. | 🖼️ **找素材** | 只用公有领域和开放授权素材,记原链接、许可、SHA256 和用页 | — |
  47. | ✍️ **手排** | 照片卡、论文矢量纸条、扫描书页纸条、红圈/下划线/页边竖线、贴边出血、整页压暗底图、人名标签、问句贴条、毛笔双色标题、电子青大数字 | `scripts/手排.py` |
  48. | ✅ **检查** | 一条命令查红线(图注、页眉、页码、小字、孤字)、文字出界、背景分类 | `scripts/check_all.py` |
  49. | 📦 **打包** | 输出成品文件夹和全套预览。**不会自动发布** | `scripts/package.py` |
  50. ### 红线
  51. > 事实可回溯 · 只用开放授权素材 · 图上不写出处 · 不改原文(位图最多放大 1.25 倍)· 不自动发布 · 参照图不外传
  52. 完整的七条红线写在 [SKILL.md](SKILL.md#红线违反任何一条就不合格)。
  53. ## 版式一览
  54. | 元素 | 做法 |
  55. |---|---|
  56. | 底色 | 暗底 `#080808` 或浅色纸底,一篇只用一种 |
  57. | 标题 | 马善政毛笔两行:第一行米白 `#F3F1E9`,第二行电子青 `#00E5FF`,英文和数字自动换黑体 |
  58. | 原文纸条 | 论文按宽度矢量渲染,扫描书页用 macOS Vision 找词框;关键词画红圈 |
  59. | 照片和截图 | 不倾斜,贴页边出血,一页一个主角 |
  60. | 大字 | 关键数字用电子青黑体 120–220px |
  61. | 正文 | 52–66px,每页最多两段、每段 ≤60 字;字体按题材从宋体粗/宋体/仿宋/楷体/文楷/苹方细里选 |
  62. 排字细节(破折号、省略号、两端对齐、横向压缩、图层顺序)见 [references/排字细节.md](references/排字细节.md)。
  63. ## 安装
  64. **需要**:Python 3.10+、Pillow 12.1+、numpy 2+、PyMuPDF(见 [requirements.txt](requirements.txt))。扫描书页找词要 macOS(Vision)。
  65. **Claude Code**
  66. ```bash
  67. git clone https://github.com/chengyi-ai/cy-carousel-skill.git ~/.claude/skills/cy-carousel
  68. python3 -m pip install -r ~/.claude/skills/cy-carousel/requirements.txt
  69. ```
  70. **Codex**
  71. ```bash
  72. git clone https://github.com/chengyi-ai/cy-carousel-skill.git ~/.codex/skills/cy-carousel
  73. python3 -m pip install -r ~/.codex/skills/cy-carousel/requirements.txt
  74. ```
  75. 装好后新开一个对话。
  76. ## 使用
  77. 在 Claude Code 或 Codex 里直接说:
  78. > 用 cy-carousel 做一篇 AI 图文,讲「什么是聪明汉斯效应」,素材要有人物老照片和论文原文,照例 01 ELIZA 的节奏、例 03 的手排脚本来做,做完给我看全套预览。
  79. 想自己动手,手排脚本的骨架是这样(完整写法见 [`examples/03-聪明汉斯/制作.py`](examples/03-聪明汉斯/制作.py)):
  80. ```python
  81. import 手排 as S
  82. S.init('笔记目录')
  83. # 逐页:Canvas().put() 摆图和纸条 → headline / big / body / sticker / label 写字 → page() 组页
  84. S.write_script('题目', '制作.py', account='你的账号名') # 生成 页面脚本.json;account 是水印署名
  85. ```
  86. ```bash
  87. python3 scripts/render.py 页面脚本.json --out pages --assets-root .
  88. python3 scripts/render.py 页面脚本.json --out pages --assets-root . --changed-only # 之后每轮:只重渲改过的页
  89. python3 scripts/check_all.py 页面脚本.json --pages pages --assets-root . # errors 必须为零
  90. python3 scripts/package.py --note . --pages pages --out 交付 --assets-root .
  91. # 可选严格视觉(默认关闭):留白超标/连续同骨架时拒绝交付;目检后可 --accept-visual "理由" 放行并写入清单
  92. python3 scripts/package.py --note . --pages pages --out 交付 --assets-root . --strict-visual
  93. ```
  94. 连续同骨架按内页的非空 `skeleton` 标签判断。未填写标签仍提示缺少记录,不把空值当作重复布局;严格模式只阻断留白、已知骨架重复及相关检查失败,其他视觉建议保持为建议项。
  95. ## 目录结构
  96. ```
  97. cy-carousel/
  98. ├── SKILL.md AI 读取的主说明:红线、版式、流程、常见坑
  99. ├── README.md
  100. ├── LICENSE MIT(字体除外)
  101. ├── requirements.txt
  102. ├── scripts/
  103. │ ├── 手排.py 手排工具(AI 线的入口)
  104. │ ├── render.py 渲染(毛笔标题的英文数字用 latin_font 换黑体)
  105. │ ├── check_all.py 红线和技术检查
  106. │ ├── package.py 打包成品
  107. │ ├── 对照.py 参照页 vs 我们的页:并排对照图+文字行偏差表
  108. │ ├── blind_test.py 盲测拼图
  109. │ ├── build.py layouts_v2.py … 底层库(断行、字体配置),不直接用来排版
  110. │ ├── ocrfind.swift ocr.swift cutout.swift 检测人脸.swift macOS Vision 工具
  111. │ └── emoji.swift 组合 emoji 渲染成透明 PNG(AppKit)
  112. ├── references/
  113. │ └── 排字细节.md 正文字体候选、标点混排、两端对齐、横向压缩、图层顺序、对照测量
  114. ├── assets/
  115. │ ├── banner.jpg README 头图
  116. │ └── fonts/ Noto Serif SC、Noto Sans SC、马善政、霞鹜文楷(附 OFL 许可证)
  117. └── examples/
  118. ├── 01-ELIZA/ 暗底样板:全套预览、逐页文案
  119. ├── 02-Dots/ 浅色纸底样板:全套预览、逐页文案
  120. ├── 03-聪明汉斯/ 全套预览、制作.py(手排脚本写法)
  121. └── 04-AI幻觉/ 全套预览、制作.py、标题/正文
  122. ```
  123. 维护用的文件不属于 Skill 流程:`CLAUDE.md`(给 Agent 的项目约定)、`tools/`(仓库检查、登记反馈)、`tests/`、`docs/`、`.github/`(CI 与反馈处理工作流)。
  124. 示例只带全套预览、文案和制作脚本,原图、论文 PDF 和事实表没有放进仓库。
  125. ## 常见问题
  126. <details>
  127. <summary><b>不是 macOS 能用吗?</b></summary>
  128. 能(Windows 同理)。脚本读写一律按 UTF-8,不再依赖系统默认编码;`S.init()` 不再编译 Swift 工具,OCR(`ocrfind`)和组合 emoji 只在真正用到时才编译,非 macOS 会给出明确报错。只有扫描书页找词(`scan_strip()` 依赖的 `ocrfind.swift`)和 `对照.py` 的 OCR 要 macOS Vision。找不到词时可以直接给 `scan_strip()` 传 0–1 的框;论文纸条走 PyMuPDF 矢量渲染,跨平台。
  129. </details>
  130. <details>
  131. <summary><b>封面毛笔字里的「AI」看着像「刈」?</b></summary>
  132. 用 `headline()` 写标题就不会:英文和数字会自动换成黑体(`render.py` 的 `latin_font`)。
  133. </details>
  134. <details>
  135. <summary><b>做一版太慢了?</b></summary>
  136. 脚本本身不慢(11 页渲染约 6 秒、检查约 10 秒),时间主要花在 Agent 的来回上。`SKILL.md` 的「省时间」一节列了不放宽红线也能省时间的做法:题目已定就不列候选、查证和找素材并行、问题攒一批再改。之后每轮修改用 `render.py --changed-only`,只重渲改过的页。它按文件大小和修改时间判断素材有没有换,用 `cp -p` 换同样大小的文件认不出来;怀疑成图没跟上时,去掉 `--changed-only` 全量渲染一次。
  137. </details>
  138. <details>
  139. <summary><b>会自动发布吗?</b></summary>
  140. 不会。脚本只出文件,发布由你自己来。
  141. </details>
  142. <details>
  143. <summary><b>能用 build.py 的自动版式吗?</b></summary>
  144. 不推荐。那套出来的页面不如手排,`build.py` 只作为渲染和断行的底层库。
  145. </details>
  146. ## 反馈
  147. 遇到渲染问题或有想法,直接[提 issue](https://github.com/chengyi-ai/cy-carousel-skill/issues/new/choose),渲染问题附上出问题那一页的截图。
  148. 提交后 Agent 会自动读代码评估可行性,在 issue 下回复结论和实现思路;维护者确认后由 Agent 写代码、跑测试、提 PR,合并前一定有人审。社媒、群聊里的反馈也能登记进来,整套流程和配置见 [docs/agent-workflow.md](docs/agent-workflow.md)。
  149. ## 许可
  150. 代码和文档以 [MIT 许可证](LICENSE) 发布。
  151. 字体不在 MIT 范围内:仓库自带的 Noto Serif SC、Noto Sans SC、马善政、霞鹜文楷 Medium 都是 SIL Open Font License 1.1,许可证和 SHA256 见 [assets/fonts/](assets/fonts/README.md)。示例页面里的素材各有出处和许可,记录在每篇成品的置顶评论里。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.