comeonzhj/Auto-Redbook-Skills - 观星指南 Stargazers.cn

📕 Auto-Redbook-Skills（已重构版）

⚠️ 使用此工具前情确保已悉知官方 3 月 10 日发布的公告

方式一：Claude Code Plugin 安装（推荐）

# 添加本仓库为 marketplace
/plugin marketplace add comeonzhj/Auto-Redbook-Skills

# 安装插件
/plugin install auto-redbook-skills@comeonzhj-Auto-Redbook-Skills

安装后运行 /reload-plugins 即可使用。

方式二：一句话安装

跟你的 Agent 说：

拉取下面的项目，安装其中的技能：https://github.com/comeonzhj/Auto-Redbook-Skills

方式三：手动安装

详见下方使用方式总览。

自动撰写小红书笔记、生成多主题卡片、可选自动发布的 Skills
当前版本对渲染脚本和样式系统做了一次完整重构，感谢 Cursor 的辅助开发 🙌

✨ 本次重构亮点

🎨 8 套主题皮肤：默认简约灰 + Playful Geometric / Neo-Brutalism / Botanical / Professional / Retro / Terminal / Sketch
📐 4 种分页模式：
- separator：按 --- 分隔手动分页
- auto-fit：固定尺寸，自动整体缩放内容，避免溢出/大面积留白
- auto-split：根据渲染后高度自动拆分为多张卡片
- dynamic：根据内容动态调整图片高度
🧱 统一卡片结构：外层浅灰背景（card-container）+ 内层主题背景（card-inner）+ 纯排版层（card-content）
🧠 封面与正文一体化：封面背景、标题渐变和正文卡片背景都按主题自动匹配

🖼 主题效果示例

所有示例均为 1080×1440px，小红书推荐 3:4 比例更多示例去 demo 中查看

Auto-fit 模式示例（自动缩放）

Auto Fit

🚀 使用方式总览

1. 克隆项目

git clone https://github.com/comeonzhj/Auto-Redbook-Skills.git
cd Auto-Redbook-Skills

可以将本项目放到支持 Skills 的客户端目录，例如：

Claude：~/.claude/skills/
Alma：~/.config/Alma/skills/
TRAE：/your-path/.trae/skills/

2. 安装依赖

Python：

pip install -r requirements.txt
playwright install chromium

Node.js：

npm install
npx playwright install chromium

Node.js 18+ 同时用于图片渲染和内置的小红书 Creator 请求签名。

🎨 渲染图片（Python）

核心脚本：scripts/render_xhs.py

# 最简单用法（默认主题 + 手动分页）
python scripts/render_xhs.py demos/content.md

# 使用自动分页（推荐：内容长短难控）
python scripts/render_xhs.py demos/content.md -m auto-split

# 使用固定尺寸自动缩放（auto-fit）
python scripts/render_xhs.py demos/content_auto_fit.md -m auto-fit

# 切换主题（例如 Playful Geometric）
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.js）

脚本：scripts/render_xhs.js，参数与 Python 基本一致：

# 默认主题 + 手动分页
node scripts/render_xhs.js demos/content.md

# 指定主题 + 自动分页
node scripts/render_xhs.js demos/content.md -t terminal -m auto-split

📤 发布到小红书

1. 配置 Creator Cookie

cp env.example.txt .env

编辑 .env：

XHS_CREATOR_COOKIE=your_creator_cookie_string_here

获取方式：浏览器登录小红书创作服务平台 → F12 → Network → 刷新页面 → 选择发往 creator.xiaohongshu.com 的请求 → 复制 Request Headers 中的完整 Cookie。

2. 发布图文笔记（可选）

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`	仅做本地参数验证，不登录、不上传、不发布

发布脚本已内置 Creator 纯 HTTP 签名、素材上传和发布链路，不依赖浏览器自动化、外部 API 服务或其他项目目录。运行发布命令前请确保已经执行 pip install -r requirements.txt 和 npm install。

📁 项目结构（重构后）

Auto-Redbook-Skills/
├── SKILL.md              # 技能描述（Agent 使用说明）
├── README.md             # 项目文档（你现在看到的）
├── requirements.txt      # Python 依赖
├── package.json          # Node.js 依赖
├── env.example.txt       # Cookie 配置示例
├── vendor/xhs_publish_runtime/ # 内置 Creator 鉴权、签名与发布运行时
├── references/           # 技能参考文档
│   └── params.md         # 完整参数参考（主题/模式/发布参数）
├── assets/
│   ├── cover.html        # 封面 HTML 模板
│   ├── card.html         # 正文卡片 HTML 模板
│   ├── styles.css        # 共用容器样式（cover-inner / card-inner 等）
│   └── example.md        # 示例 Markdown
├── assets/themes/        # 主题样式（只控制排版 & 内层背景）
│   ├── default.css
│   ├── playful-geometric.css
│   ├── neo-brutalism.css
│   ├── botanical.css
│   ├── professional.css
│   ├── retro.css
│   ├── terminal.css
│   └── sketch.css
├── demos/                # 各主题示例渲染结果
│   ├── content.md
│   ├── content_auto_fit.md
│   ├── auto-fit/
│   ├── playful-geometric/
│   ├── retro/
│   ├── Sketch/
│   └── terminal/
└── scripts/
    ├── render_xhs.py     # Python 渲染脚本（8 主题 + 4 分页模式）
    ├── render_xhs_v2.py  # Python 渲染脚本 V2（7 渐变色彩风格）
    ├── render_xhs.js     # Node.js 渲染脚本
    └── publish_xhs.py    # 自包含的小红书 Creator 发布脚本（默认仅自己可见）

⚠️ 注意事项

Cookie 安全：不要把 .env 提交到 Git 或共享出去；请使用创作服务平台 Cookie。
Cookie 有效期：过期后发布失败是正常现象，重新抓一次 Cookie 即可。
发布频率：避免短时间内高频发布，以免触发平台风控。
图片尺寸：默认 1080×1440px，符合小红书推荐比例。

🙏 致谢

Playwright - 浏览器自动化渲染
Marked - Markdown 解析
~~xhs - 原小红书 API 客户端（发布实现已停用）~~
Spider_XHS - 当前 Creator 纯 HTTP 登录、签名、上传与发布实现参考（基于提交 2030f5d 提取并内置）
Cursor - 本次重构过程中提供了极大帮助 ❤️