MistyWu812/xhs-ppt 是一个 Claude Code skill，用来把文章、草稿或 Markdown 文本转成小红书/公众号/social PNG 卡片；入口在 GitHub 仓库 https://github.com/MistyWu812/xhs-ppt，可在 Code 菜单下载 ZIP，也可用 git clone https://github.com/MistyWu812/xhs-ppt.git ~/.claude/skills/xhs-ppt 直接装到本地 skills 目录。

它的产物不是 .pptx 文件，而是一组 HTML 渲染出的 PNG 卡片，包含 9:16 竖卡、16:9 单页、2合1 竖卡和长图文。触发词里虽然有“生成 PPT”，但仓库 README 和 SKILL.md 都把它定位为“文章压缩成卡片组”。

安装后的目录检查

clone 到 Claude Code skills 目录后，根目录里应有 README.md、SKILL.md、tools/、templates/ 和 examples/。其中 templates/tech-cyan/ 是科技深色亮电光青旗舰模板，templates/tech-navy/ 是离线更稳的深蓝模板。

git clone https://github.com/MistyWu812/xhs-ppt.git ~/.claude/skills/xhs-ppt

依赖主要有三项：Google Chrome 用于 headless 渲染 HTML 到 PNG；Python 3；Pillow 用于 2合1 拼接。README 还提醒，旗舰配色会加载 Google Fonts 和 Material Icons，离线环境可改用 tech-navy。

python3 -m pip install pillow

非 macOS 或 Chrome 不在默认位置时，用 CHROME=/path/to/chrome 指定浏览器路径。

调用时先给文章，不要直接写 HTML

在 Claude Code 里贴原文或给文章路径，然后说：

用 xhs-ppt 把这篇渲染成科技风 2合1 卡片

skill 要求先读原文，判断文章属性，确定配色和图标体系；再输出分镜给人确认；确认后才进入 HTML 和 PNG 渲染。这个顺序是它和普通模板套图的差别。

第一步会抽出原文核心论点，把每段主张、证据和结论压成能单独读懂的金句。第二步会确定页数、每页结构和组件类型，并把核心点落到对应页面。第三步才从模板骨架复制 HTML，填组件，渲染 PNG。

直接跑工具脚本

如果已经有若干 slideNN.html，可直接使用 tools/render_cards.py。16:9 单页、小红书竖卡和 2合1 单 HTML 都有对应尺寸：

python3 tools/render_cards.py path/to/slides 1280x720 2
python3 tools/render_cards.py path/to/slides 1080x1440 2
python3 tools/render_cards.py path/to/slides 1280x1440 2

若要把两个 16:9 单页上下拼成 2合1 竖卡，使用：

BG=#1a1a2e python3 tools/stack_cards.py --pairs path/to/slides 2up

长图文则由 tools/render_longform.py 处理，HTML 内写入 <!-- render-size: 1080x4500 --> 后渲染成一张超长 PNG。

输出检查看四项

第一，看 PNG 数量是否等于 HTML 数量。第二，逐张看文字是否溢出，尤其是标题、金句条、表格和卡片边缘。第三，看配色是否整套统一，别把科技深色、深蓝和浅色家族混在同一组图里。第四，看字体和图标是否加载成功；联网旗舰模板若字体失败，视觉气质会明显下降。

2合1 产物还要看配对顺序。stack_cards.py --pairs 会按 1+2、3+4 的顺序拼接；如果页数是奇数，尾页会原样保留。小红书默认常用 9:16 1080×1440，公众号或长图场景可用 2合1 或 longform。

边界和入口判断

xhs-ppt 的北极星是“不点开原文也能读懂完整论点”。所以它强调覆盖性检查和脱稿自检：只看卡片组，也要能复述原文的主张、证据和结论。

它不是可编辑 PPTX deck 工具，也不是拿到文章后立刻出 HTML 的快捷模板。使用时要把文章理解、分镜确认和 PNG 自检都留出来；这样生成的卡片才像原文的压缩版，而不是只有标题和金句的预告片。