xhs-note-creator

✨ 新增功能

• 🚀 智能分页渲染 - 自动检测内容高度，超出时自动拆分到多张卡片，彻底解决文字溢出问题
• 🎨 7种可选样式 - 新增多种主题风格，一键切换不同视觉效果
• ⚡ V2 渲染脚本 - 全新 render_xhs_v2.py / render_xhs_v2.js，推荐升级使用

📋 可用样式列表

| 样式 | 名称 | 预览 |

|------|------|------|

| purple | 紫韵（默认）| 蓝紫色渐变 |

| xiaohongshu | 小红书红 | 品牌红色系 |

| mint | 清新薄荷 | 绿色自然调 |

| sunset | 日落橙 | 粉橙浪漫调 |

| ocean | 深海蓝 | 海洋蓝色调 |

| elegant | 优雅白 | 灰白简约调 |

| dark | 暗黑模式 | 深色高对比 |

🎯 使用 V2 脚本

```bash

# Python 版本

python scripts/render_xhs_v2.py note.md --style sunset

# Node.js 版本

node scripts/render_xhs_v2.js note.md --style ocean

# 查看所有样式

python scripts/render_xhs_v2.py --list-styles

```

📁 v2.0 新增文件

```

scripts/

├── render_xhs_v2.py # 新增：Python 智能分页版（推荐）

├── render_xhs_v2.js # 新增：Node.js 智能分页版（推荐）

├── render_xhs.py # 旧版：保留兼容

└── render_xhs.js # 旧版：保留兼容

STYLES.md # 新增：样式选择指南

```

注：V1 旧版脚本保留兼容，V2 版本完全向下兼容 Markdown 格式。

---

• 📝 撰写笔记 - 根据既定主题，撰写小红书笔记（提示词自己调整，在 SKILL.md里）
• 🎨 生成卡片 - 根据内容自动渲染生成图片，包含 cover 和内容详情，支持 Markdown 渲染
• 🐍 双语言脚本 - 提供 Python 和 Node.js 两种渲染方案
• 📤 一键发布 - 支持直接发布到小红书（需配置 Cookie）

Clone 项目

Clone 项目到本地

```bash

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

```

移动到支持 Skills 的客户端对应文件夹里：

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

安装依赖

Python 版本：

```bash

pip install markdown pyyaml playwright python-dotenv xhs

playwright install chromium

```

Node.js 版本：

```bash

cd Auto-Redbook-Skills

npm install

npx playwright install chromium

```

V2 渲染（推荐）

```bash

# 使用默认样式

python scripts/render_xhs_v2.py note.md

# 指定样式主题

python scripts/render_xhs_v2.py note.md --style sunset

# 指定输出目录

python scripts/render_xhs_v2.py note.md -o ./output --style xiaohongshu

# 查看所有样式

python scripts/render_xhs_v2.py --list-styles

```

V2 特性：

• 智能分页：自动检测内容高度，自动拆分卡片
• 固定尺寸：所有卡片固定 1080×1440px
• 多种样式：7种预设主题风格

V1 渲染（旧版）

```bash

# Python 版本

python scripts/render_xhs.py note.md

# Node.js 版本

node scripts/render_xhs.js note.md

```

注意： V1 版本当内容过长时可能出现溢出，建议手动使用 --- 分隔内容。

1. 配置 Cookie

复制 env.example.txt 为 .env，填入小红书 Cookie：

```bash

cp env.example.txt .env

```

编辑 .env 文件：

```

XHS_COOKIE=your_cookie_string_here

```

获取 Cookie 方法：

1. 在浏览器中登录 [小红书](https://www.xiaohongshu.com)
2. 打开开发者工具（F12）
3. 在 Network 标签中查看任意请求的 Cookie 头
4. 复制完整的 cookie 字符串

2. 发布笔记

Skills 会自动发布，也可以手动执行：

```bash

python scripts/publish_xhs.py \

--title "笔记标题" \

--desc "笔记描述内容" \

--images cover.png card_1.png card_2.png

```

可选参数：

| 参数 | 说明 |

|------|------|

| --private | 设为私密笔记 |

| --post-time "2024-01-01 12:00:00" | 定时发布 |

| --dry-run | 仅验证，不实际发布 |

修改背景渐变（V1）

编辑 assets/card.html 中的 .card-container：

```css

.card-container {

background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);

}

```

预设渐变色：

| 名称 | 渐变值 |

|------|--------|

| 紫蓝 | #667eea → #764ba2 |

| 粉红 | #f093fb → #f5576c |

| 青蓝 | #4facfe → #00f2fe |

| 绿色 | #43e97b → #38f9d7 |

| 橙黄 | #fa709a → #fee140 |

更多样式选择（V2）

V2 版本提供 7 种内置样式，通过 --style 参数快速切换：

```bash

python scripts/render_xhs_v2.py note.md --style dark # 暗黑模式

python scripts/render_xhs_v2.py note.md --style mint # 清新薄荷

```

详见 [STYLES.md](./STYLES.md)

```

md2Redbook/

├── SKILL.md # 技能描述（AI Agent 使用）

├── README.md # 项目文档

├── STYLES.md # 样式选择指南

├── requirements.txt # Python 依赖

├── package.json # Node.js 依赖

├── env.example.txt # Cookie 配置示例

├── assets/

│ ├── cover.html # 封面 HTML 模板

│ ├── card