Skip to content
Back to search

xhs-article-to-images

Agent-assisted Markdown article to Xiaohongshu image cards workflow

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/bozhoudev--xhs-article-to-images/badge.svg)](/listings/bozhoudev--xhs-article-to-images)

HTML

<a href="/listings/bozhoudev--xhs-article-to-images"><img src="/api/listings/bozhoudev--xhs-article-to-images/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.

git clone https://github.com/bozhouDev/xhs-article-to-images.git
cd xhs-article-to-images
npm install
npx playwright install chromium

作为 Codex / Claude skill 使用时,把仓库链接到你的 skills 目录:

ln -s "$(pwd)" ~/.codex/skills/xhs-article-to-images
# 或:
ln -s "$(pwd)" ~/.claude/skills/xhs-article-to-images

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 · 108 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: xhs-article-to-images
  3. description: 把 Markdown 长文转成小红书 3:4(1080×1440)图片组的 Agent skill。内置五套设计皮肤(E 雅刊·默认 / A 暖杏奶咖 / B 雾松青 / C 黛墨描金 / D 夜读鎏金)+ 女性向三主题(F 粉色王国 / G 乙游夜境 / H 吉卜力)× 多种页型;Agent 负责读文章、拆页和填 HTML,Playwright 渲染器负责逐张截图导出 PNG。当用户说"长文转图片"、"小红书长图"、"把这篇文章做成小红书图文/图片/卡片"、"文章转图片"、"用我的设计稿排版"、"转成 3:4 图组"、想要"女性向/少女风/粉色/乙游风/吉卜力风"排版时使用;用户给了一篇文章并提到发小红书时也应使用。
  4. ---
  5. # 小红书长文转图片
  6. 把一篇 Markdown 文章(含图片)转成一组小红书 3:4 卡片图。流水线:**读文章 → 选皮肤 → 拆页排版成 HTML → Playwright 截图 → 交付 PNG**。
  7. **默认目标:全文重排版**——把文章完整转成好看的图文卡片,不是 8 页精华摘要。主力页型是**正文**;段落有图就用**图文**;页型按需选用,不为凑花样硬塞金句/对比/清单页。
  8. 这个 skill 使用**固定的五套皮肤 + 女性向三主题模板**,不重新设计版式,目标是稳定复刻设计稿的样子。用户提到"皮肤/设计稿"或想要暖杏、雾松、黛墨、夜读、雅刊、粉色、乙游、吉卜力这类风格时用本 skill。
  9. ## 设计系统一览
  10. - 卡片基准 **1080 × 1440(3:4)**,皮肤与页型全部由 `assets/styles.css`(A/B/C 三套皮肤)、`assets/styles-d.css`(D 独立体系)、`assets/styles-e.css`(E 独立体系)、`assets/styles-fem.css`(女性向三主题独立体系)定义
  11. - 五套设计皮肤:**E 雅刊(默认)**(暖白纸 + Newsreader 高对比衬线,作品集编辑感,封面需一张配图)/ **A 暖杏奶咖**(暖调爆款)/ **B 雾松青**(清爽治愈,封面需 16:9 配图)/ **C 黛墨描金**(编辑感)/ **D 夜读鎏金**(深墨鎏金,惊艳向)
  12. - 女性向三主题(`femcard` 体系,共用一套骨架,换主题改 `t-pink/t-otome/t-ghibli` 类名 + 同步替换卡内 `.fem-deco` 装饰块):**F 粉色王国**(童话甜粉,彩虹+城堡+云朵手绘装饰,圆体标题)/ **G 乙游夜境**(暗黑浪漫深色,银紫光边框+罗马环+月+蝴蝶,高对比衬线)/ **H 吉卜力**(治愈自然,太阳+胖云+飞鸟+山丘,清新衬线)。女性向主题自带封面横幅图槽与 16:9 图文图槽
  13. - 基础页型:封面、正文、清单、图文混排(16:9 图槽)、结尾号召;**E 与女性向三主题另有可选页型**:大字陈述(statement)、要点正文(points / idea)、三观对比(views)——只在内容天然适合时用,**不是每篇必用**
  14. - A/B/C 共用一套 HTML 骨架,换肤只改 `skin-a/b/c` 类名;**D 用 `dcard`、E 用 `ecard`、女性向三主题用 `femcard` 独立类名体系,四套体系绝不混排**
  15. - 完整 HTML 骨架在 `assets/template.html`,所有页型都有现成可拷的示例块
  16. ## 工作流
  17. ### 1. 输入确认
  18. 需要:文章路径(Markdown)。可选:皮肤指定、品牌区文案、页数偏好。信息够就直接开工,不要追问。
  19. ### 2. 读文章 + 拆页规划
  20. 读 `references/content-mapping.md`(皮肤选择标准、页型容量上限、文案改写要求都在里面),然后产出内部页计划。**用户不指定皮肤时默认用 E 雅刊**,只有用户点名其他皮肤、或明确让你自由挑选时才换:
  21. ```text
  22. 皮肤:E 雅刊(默认)
  23. P1 cover 钩子标题 + 导语
  24. P2 body §1 为什么选 Obsidian(第 1 页)
  25. P3 body §1 续(装不下就拆页)
  26. P4 media 下载安装截图
  27. P5 body 新建仓库 + git clone
  28. P6 media GitHub 创建仓库截图
  29. ...
  30. Pn body 最后一节
  31. Pn+1 ending (可选)CTA
  32. ```
  33. 按文章 **H2/H3 顺序**拆页;**正文为主,有图用图文**;超容量拆页,**不删内容**。页数通常 10–18(小红书上限 18)。用户说「摘要版 / N 页以内」才做压缩。开工前用一两句话说明皮肤和预计页数即可。
  34. ### 3. 建任务文件夹 + 排版
  35. 在当前项目中为每篇文章建立一个任务文件夹,推荐命名为 `imgs-{标题}/`:
  36. ```
  37. imgs-Agent记忆/
  38. ├── index.html ← 从 template.html 拷贝骨架后填内容
  39. ├── styles.css ← 从 skill assets/ 拷贝
  40. ├── styles-d.css ← 从 skill assets/ 拷贝
  41. ├── styles-e.css ← 从 skill assets/ 拷贝
  42. ├── styles-fem.css ← 从 skill assets/ 拷贝(女性向三主题)
  43. ├── assets/ ← 文章配图、封面图;并拷入 assets/avatar.png(品牌头像)
  44. └── output/ ← 渲染产物 PNG(最终交付物)
  45. ```
  46. HTML/CSS 是工程中间产物:发布后只需保留 `output/` 里的 PNG,index.html、两个 CSS 和 assets 可以删掉(用户说"发布了/清理一下"时再删,不要主动删)。
  47. 排版要点:
  48. - 把四个 CSS(`styles.css`、`styles-d.css`、`styles-e.css`、`styles-fem.css`)和 `template.html` 拷进任务文件夹,把 template 改名 `index.html`,删掉用不到的示例卡,留下的卡按页计划填入真实内容
  49. - 每张卡的 id 按顺序命名:`xhs-01`、`xhs-02`…(渲染脚本按 id 命名 PNG)
  50. - 严格遵守 `content-mapping.md` 的每页容量上限,超了就**拆页**,**禁止删内容凑页**,**不许缩字号**
  51. - 文章里的图片拷贝/下载到任务 `assets/`,HTML 用相对路径引用
  52. ### 4. 配图处理
  53. - 文章自带图优先,放进图文混排页
  54. - 皮肤 E 的封面底部需要一张横幅配图(约 2.6:1 宽条裁切)、皮肤 B 的封面需要一张 16:9 横图:文章没有合适的就按 `content-mapping.md` 第五节的三选一流程(用户上传 / 网图 / AI 生成)处理一次
  55. - 如需 AI 生成配图,生成图只作为排版中间产物,存任务 `assets/` 即可
  56. ### 5. 渲染截图
  57. ```bash
  58. npx xhs-render <任务目录>
  59. # 或在本仓库根目录执行:
  60. node scripts/render.cjs <任务目录>
  61. ```
  62. 脚本会打开 `index.html`,等字体就绪后把所有 `.card` / `.dcard` / `.ecard` / `.femcard` 节点按 id 逐张导出到 `output/`,并打印每张实际尺寸(应为 1080×1440)。需要 2 倍清晰度加 `--scale 2`。
  63. ### 6. 自检 + 交付
  64. 渲染完先自己用 Read 工具看一遍每张 PNG,检查:
  65. - 文字是否溢出卡片、压到品牌区或贴边
  66. - 配图裁切是否裁掉了人脸 / 关键信息(需要时给 `<img>` 加 `object-position` 调整再渲)
  67. - 每页下半部分是否大面积空白(正文页应填满;图文页空白可能来自大图,但不应是因为删光了字)
  68. - 页码、总页数是否对得上
  69. 有问题改 HTML 重渲,没问题再交付。交付时给出:任务文件夹路径、每张图的绝对路径、皮肤和页数说明、网图来源(如有)。
  70. 如项目有自己的内容管理约定,可以把任务目录路径、输出 PNG 路径和发布文案记录回对应笔记或 issue。
  71. ## 禁忌
  72. - 不混皮肤:一组图只用一套皮肤;A/B/C 的 `card`、D 的 `dcard`、E 的 `ecard`、女性向三主题的 `femcard` 四套类名体系不互换;女性向三主题之间也只能选一个(t-pink / t-otome / t-ghibli)
  73. - 不发明新版式、新配色:只用四份 CSS 里已有的类,需要微调也只在任务文件夹的 index.html 里加内联样式,**不改 skill assets 里的 CSS**
  74. - 全文模式下正文忠实于原文结构,只做断行和轻度润色;封面标题可写钩子。只有用户要「摘要版」时才大幅压缩
  75. - 不缩小字号塞内容,不让文字溢出或贴边
  76. - 不在图片里放使用说明、快捷键提示等与内容无关的文字
README.md · README · 145 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # xhs-article-to-images
  2. 把 Markdown 长文转成小红书 3:4 图片组的 Agent skill。
  3. 它不是传统的全自动 Markdown parser。推荐用法是:让 Codex / Claude 这类 Agent 读文章、按规则拆页、填入 HTML 模板,再用内置 Playwright 渲染器逐张导出 PNG。
  4. ## 效果预览
  5. <table>
  6. <tr>
  7. <td><img src="preview/output/preview-e.png" width="180" alt="E 雅刊封面"></td>
  8. <td><img src="preview/output/preview-e-body.png" width="180" alt="E 雅刊正文页"></td>
  9. <td><img src="preview/output/preview-a.png" width="180" alt="A 暖杏奶咖"></td>
  10. </tr>
  11. <tr>
  12. <td><img src="preview/output/preview-b.png" width="180" alt="B 雾松青"></td>
  13. <td><img src="preview/output/preview-c.png" width="180" alt="C 黛墨描金"></td>
  14. <td><img src="preview/output/preview-d.png" width="180" alt="D 夜读鎏金"></td>
  15. </tr>
  16. <tr>
  17. <td><img src="preview/output/preview-f.png" width="180" alt="F 粉色王国"></td>
  18. <td><img src="preview/output/preview-g.png" width="180" alt="G 乙游夜境"></td>
  19. <td><img src="preview/output/preview-h.png" width="180" alt="H 吉卜力"></td>
  20. </tr>
  21. </table>
  22. ## 能做什么
  23. - 输出 1080 x 1440 PNG,适合小红书 3:4 图文。
  24. - 内置五套设计皮肤:E 雅刊(默认)、A 暖杏奶咖、B 雾松青、C 黛墨描金、D 夜读鎏金。
  25. - 外加女性向三主题:F 粉色王国(童话甜粉)、G 乙游夜境(暗黑浪漫)、H 吉卜力(治愈自然),共用一套 `femcard` 骨架、换类名即换主题。
  26. - 支持封面、正文、图文混排、清单、金句、大字陈述、要点正文、三观对比、结尾等页型。
  27. - 默认走全文重排版:正文为主,有图用图文,超容量拆页,不把长文硬压成 8 页摘要。
  28. - 提供 `xhs-init` 初始化任务目录,`xhs-render` 渲染截图。
  29. ## 安装
  30. ```bash
  31. git clone https://github.com/bozhouDev/xhs-article-to-images.git
  32. cd xhs-article-to-images
  33. npm install
  34. npx playwright install chromium
  35. ```
  36. 作为 Codex / Claude skill 使用时,把仓库链接到你的 skills 目录:
  37. ```bash
  38. ln -s "$(pwd)" ~/.codex/skills/xhs-article-to-images
  39. # 或:
  40. ln -s "$(pwd)" ~/.claude/skills/xhs-article-to-images
  41. ```
  42. ## 快速使用
  43. 初始化一篇文章的任务目录:
  44. ```bash
  45. npm run init:task -- ./work/my-article
  46. ```
  47. 编辑 `./work/my-article/index.html`:保留需要的卡片,填入文章内容,把图片放进 `./work/my-article/assets/`。
  48. 渲染 PNG:
  49. ```bash
  50. npm run render -- ./work/my-article
  51. ```
  52. 输出文件会在:
  53. ```text
  54. ./work/my-article/output/
  55. ```
  56. 需要 2 倍清晰度:
  57. ```bash
  58. npm run render -- ./work/my-article --scale 2
  59. ```
  60. ## 预览图重渲
  61. ```bash
  62. npm run render:preview
  63. ```
  64. 这会重新生成 `preview/output/*.png`,README 中的效果图也会随之更新。
  65. ## 目录结构
  66. ```text
  67. .
  68. ├── SKILL.md # Agent 使用说明
  69. ├── assets/
  70. │ ├── template.html # 全量卡片模板
  71. │ ├── styles.css # A/B/C 皮肤
  72. │ ├── styles-d.css # D 夜读鎏金
  73. │ ├── styles-e.css # E 雅刊
  74. │ ├── styles-fem.css # 女性向三主题 F 粉色王国 / G 乙游夜境 / H 吉卜力
  75. │ ├── avatar.png # 示例头像,可替换
  76. │ ├── cover-hero.jpg # 示例封面图
  77. │ ├── media-1.jpg # 示例图文页图片
  78. │ └── social/ # 作者社媒二维码
  79. ├── references/
  80. │ └── content-mapping.md # 文章到卡片的拆页规则
  81. ├── scripts/
  82. │ ├── init-task.cjs # 初始化任务目录
  83. │ └── render.cjs # Playwright 截图导出
  84. └── preview/ # README 预览工程和输出图
  85. ```
  86. ## 品牌替换
  87. 默认模板里使用了“泊舟的AI思考”和示例头像。开源仓库保留它们作为可运行示例;正式使用时替换:
  88. - `assets/avatar.png`
  89. - HTML 里的品牌名、tagline 和页脚文案
  90. - 封面/图文页中的示例图片
  91. ## 开源状态
  92. 这个仓库已经移除了本地绝对路径和私有 skill 依赖;`.DS_Store`、`node_modules`、普通任务输出目录会被忽略。`preview/output/*.png` 特意保留,用于 README 展示最终效果。
  93. ## 关注作者
  94. 如果这个项目对你有帮助,也可以关注一下我的社媒账号。
  95. <table>
  96. <tr>
  97. <td align="center">
  98. <img src="assets/social/xiaohongshu.jpg" width="260" alt="泊舟的AI思考 小红书账号">
  99. <br>
  100. 小红书
  101. </td>
  102. <td align="center">
  103. <img src="assets/social/douyin.jpg" width="260" alt="泊舟的AI思考 抖音账号">
  104. <br>
  105. 抖音
  106. </td>
  107. </tr>
  108. </table>
  109. ## License
  110. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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