Auto-Redbook-Skills：自动撰写小红书笔记、生成多主题卡片并可选择性自动发布的 Skills
这是一个面向支持 Skills 的 AI 客户端（如 Claude Code 等）的开源技能包：它根据 Markdown 内容自动撰写小红书笔记，使用 Playwright 渲染出 1080×1440（3:4）的封面与正文卡片图，支持 8 套主题与 4 种分页模式，并可选地通过内置的小红书 Creator 纯 HTTP 签名与发布脚本上传图文笔记（默认仅自己可见）。
社区作者 · zZz
它解决什么问题
项目定位：Auto-Redbook-Skills 是一个“自动撰写小红书笔记、生成多主题卡片、可选自动发布”的 Skills，当前版本对渲染脚本和样式系统做了一次完整重构。
重构亮点：
- 8 套主题皮肤：默认简约灰，以及 Playful Geometric、Neo-Brutalism、Botanical、Professional、Retro、Terminal、Sketch（配图 1 为 Playful Geometric 示例、配图 2 为 Retro 示例、配图 3 为 Sketch 示例、配图 4 为 Terminal 示例、配图 5 为 Auto Fit 模式示例）。
- 4 种分页模式：separator 按 --- 分隔手动分页；auto-fit 固定尺寸、自动整体缩放内容以避免溢出或大面积留白；auto-split 根据渲染后高度自动拆分为多张卡片；dynamic 根据内容动态调整图片高度。
- 统一卡片结构：外层浅灰背景（card-container）+ 内层主题背景（card-inner）+ 纯排版层（card-content）。
- 封面与正文一体化：封面背景、标题渐变和正文卡片背景都按主题自动匹配。
尺寸与输出：所有示例均为 1080×1440px，符合小红书推荐的 3:4 比例；渲染结果包含封面 cover.png 与正文卡片 card_1.png、card_2.png……
脚本与结构：核心渲染脚本为 scripts/render_xhs.py（8 主题 + 4 分页模式），另有 scripts/render_xhs_v2.py（7 种渐变色彩风格）、scripts/render_xhs.js（Node.js 渲染）与 scripts/publish_xhs.py（自包含的小红书 Creator 发布脚本，默认仅自己可见）。项目还包含 SKILL.md（技能描述/Agent 使用说明）、references/params.
md（主题/模式/发布参数完整参考）、assets/ 下的 cover.html、card.html、styles.css、example.md 与 themes/ 主题样式，以及 demos/ 各主题示例。发布脚本已内置 Creator 纯 HTTP 签名、素材上传和发布链路，不依赖浏览器自动化、外部 API 服务或其他项目目录。
使用注意：发布前需确保已悉知官方 3 月 10 日发布的《关于打击AI托管运营账号的治理公告》；Cookie 属创作服务平台 Cookie，不要提交到 Git 或共享；Cookie 过期后发布失败属正常现象，重新抓取即可；避免短时间高频发布以免触发平台风控。
适用对象：需要批量产出小红书图文素材的内容创作者、运营人员，以及希望把“写作—配图—发布”链路交给 Agent 自动执行的开发者。
许可证：MIT License © 2026。致谢 Playwright、Marked、xhs、Spider_XHS（基于提交 2030f5d 提取并内置）与 Cursor。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
准备环境：需要 Python 环境（安装 requirements.txt 依赖）与 Node.js 18+（同时用于图片渲染和内置的小红书 Creator 请求签名）。
方式一：Claude Code Plugin 安装（推荐） 1）添加本仓库为 marketplace：/plugin marketplace add comeonzhj/Auto-Redbook-Skills 2）安装插件：/plugin install auto-redbook-skills@comeonzhj-Auto-Redbook-Skills 3）安装后运行 /reload-plugins 即可使用。
方式二：一句话安装 跟你的 Agent 说：拉取下面的项目，安装其中的技能：https://github.com/comeonzhj/Auto-Redbook-Skills
方式三：手动安装
- 克隆项目
git clone https://github.com/comeonzhj/Auto-Redbook-Skills.gitcd Auto-Redbook-Skills可将本项目放到支持 Skills 的客户端目录，例如：Claude 为 ~/.claude/skills/；Alma 为 ~/.config/Alma/skills/；TRAE 为 /your-path/.trae/skills/。
- 安装依赖
Python
pip install -r requirements.txt，然后 playwright install chromiumNode.js
npm install，然后 npx playwright install chromium- 渲染图片（Python，核心脚本 scripts/render_xhs.py）
python scripts/render_xhs.py demos/content.md（默认主题 + 手动分页）python scripts/render_xhs.py demos/content.md -m auto-split（自动分页，推荐，内容长短难控时使用）python scripts/render_xhs.py demos/content_auto_fit.md -m auto-fit（固定尺寸自动缩放）python scripts/render_xhs.py demos/content.md -t playful-geometric -m auto-split（切换主题）python scripts/render_xhs.py demos/content.md -t retro -m dynamic --width 1080 --height 1440 --max-height 2160 --dpr 2（自定义尺寸与像素比）主要参数：--theme/-t 可选 default、playful-geometric、neo-brutalism、botanical、professional、retro、terminal、sketch；--mode/-m 可选 separator / auto-fit / auto-split / dynamic；--width/-w 图片宽度默认 1080；--height 图片高度默认 1440（dynamic 模式下为最小高度）；--max-height dynamic 模式最大高度默认 2160；--dpr 设备像素比默认 2，控制清晰度。
生成结果包含封面 cover.png 与正文卡片 card_1.png、card_2.png……
node scripts/render_xhs.js demos/content.md node scripts/render_xhs.js demos/content.md -t terminal -m auto-split
- 渲染图片（Node.js，脚本 scripts/render_xhs.js，参数与 Python 基本一致）
- 配置 Creator Cookie（发布功能需要）
cp env.example.txt .env编辑 .env：XHS_CREATOR_COOKIE = your_creator_cookie_string_here 获取方式：浏览器登录小红书创作服务平台 → F12 → Network → 刷新页面 → 选择发往 creator.xiaohongshu.com 的请求 → 复制 Request Headers 中的完整 Cookie。
- 发布图文笔记（可选）
python scripts/publish_xhs.py --title "笔记标题" --desc "笔记描述内容" --images cover.png card_1.png card_2.png可选参数：--public 公开发布（默认仅自己可见）；--post-time "2026-08-14 10:00:00" 按本机时区定时发布，也支持 13 位毫秒时间戳；--topics AI 效率工具 添加一个或多个话题（不要带 #）；--location "上海" 添加地点；--proxy http://127.0.0.1:7890 使用 HTTP/HTTPS 代理；--dry-run 仅做本地参数验证，不登录、不上传、不发布。
运行发布命令前请确保已经执行
pip install -r requirements.txt 和 npm install。
常见问题：Cookie 过期后发布失败是正常现象，重新抓一次 Cookie 即可；不要把 .env 提交到 Git 或共享出去，请使用创作服务平台 Cookie；避免短时间内高频发布，以免触发平台风控；图片默认 1080×1440px，符合小红书推荐比例。
