用途
这是一个小红书笔记创作技能，用于创建专业的小红书笔记素材，涵盖内容撰写、图片卡片生成（支持 7 种样式主题）和智能分页渲染。适用于用户需要创建小红书笔记、将资料转化为小红书风格内容、生成精美图片卡片用于发布，或需要多种风格样式选择的场景。
主要能力
- 撰写小红书笔记内容：标题不超过 20 字，正文排版清晰，点缀少量 Emoji，结尾给出 SEO 友好的 5–10 个相关 Tags 标签。
- 生成专门用于渲染卡片的 Markdown 文档，通过 --- 分割线将正文分隔为多个卡片段落，每个分段文字控制在 200 字左右。
- 渲染图片卡片：V2 版本支持智能分页、7 种预设样式主题与字数预估；V1 版本为旧版，不支持自动分页。
- 可选发布功能：使用发布脚本将生成的图片发布到小红书。
使用方式
第一步：撰写笔记内容，输出标题与正文，正文段落清晰并使用少量 Emoji，结尾附上 5–10 个 Tags 标签。
第二步：生成用于渲染卡片的 Markdown 文档（禁止直接使用上一步的正文内容），包含 YAML 头部元数据（emoji 封面装饰、title 封面大标题不超过 15 字、subtitle 副标题不超过 15 字），以及用 --- 分隔的正文卡片段落。
第三步：渲染图片卡片。推荐 V2 脚本：
Python 版本：
# 基本用法
python scripts/render_xhs_v2.py <markdown_file>
# 指定输出目录
python scripts/render_xhs_v2.py <markdown_file> -o <output_directory>
# 指定样式主题
python scripts/render_xhs_v2.py <markdown_file> --style xiaohongshu
# 查看所有可用样式
python scripts/render_xhs_v2.py --list-styles
Node.js 版本：
# 基本用法
node scripts/render_xhs_v2.js <markdown_file>
# 指定输出目录和样式
node scripts/render_xhs_v2.js <markdown_file> -o ./output --style mint
# 查看所有可用样式
node scripts/render_xhs_v2.js --list-styles
旧版渲染脚本（不支持自动分页）：
# Python 版本
python scripts/render_xhs.py <markdown_file> [--output-dir <output_directory>]
# Node.js 版本
node scripts/render_xhs.js <markdown_file> [--output-dir <output_directory>]
第四步（可选）：发布小红书笔记
python scripts/publish_xhs.py --title "笔记标题" --desc "笔记描述" --images card_1.png card_2.png cover.png
前置条件：在同目录下创建 .env 文件，配置小红书 Cookie：
XHS_COOKIE=your_cookie_string_here
Cookie 获取方式：在浏览器登录小红书（https://www.xiaohongshu.com），打开开发者工具（F12），在 Network 标签中查看请求头的 Cookie。
样式主题
| 样式键 | 名称 | 描述 |
|---|---|---|
| purple | 紫韵 | 默认样式，紫蓝色渐变 |
| xiaohongshu | 小红书红 | 小红书品牌色系 |
| mint | 清新薄荷 | 绿色/自然调 |
| sunset | 日落橙 | 粉色/日落渐变 |
| ocean | 深海蓝 | 蓝绿色海洋调 |
| elegant | 优雅白 | 简约灰白调 |
| dark | 暗黑模式 | 深色背景，高对比度 |
图片规格
- 封面卡片：尺寸比例 3:4（小红书推荐比例），基准尺寸 1080×1440px，包含 Emoji 装饰、大标题、副标题，样式为渐变背景 + 圆角内容区（随主题变化）。
- 正文卡片：尺寸比例 3:4，基准尺寸 1080×1440px，支持标题、段落、列表、引用、代码块、图片，样式为白色卡片 + 渐变背景边框（随主题变化）。V2 版本自动分页，单张卡片内容不会溢出。
智能分页说明（V2）
- 预估阶段：基于字数、元素类型预估内容高度。
- 预渲染阶段：使用 Playwright 预渲染并测量实际高度。
- 拆分阶段：如果内容超出，按段落/行智能拆分内容。
- 固定输出：每张卡片固定为 1080×1440px，确保一致性。
该机制确保无论内容多长，都不会出现文字溢出问题。
技能资源
脚本文件：
- scripts/render_xhs.py - Python V1 渲染脚本（旧版）
- scripts/render_xhs.js - Node.js V1 渲染脚本（旧版）
- scripts/render_xhs_v2.py - Python V2 渲染脚本（推荐）
- scripts/render_xhs_v2.js - Node.js V2 渲染脚本（推荐）
- scripts/publish_xhs.py - 小红书发布脚本
资源文件：
- assets/cover.html - 封面 HTML 模板（旧版）
- assets/card.html - 正文卡片 HTML 模板（旧版）
- assets/styles.css - 共用样式表（旧版）
- assets/example.md - 示例 Markdown 文件
注意事项
- V2 版本推荐：V2 支持智能分页，可自动处理内容溢出问题。
- 样式选择：根据内容风格选择合适的样式主题。
- Markdown 位置：Markdown 文件应保存在工作目录，渲染后的图片也保存在工作目录。
- 内容长度：建议每个 --- 分隔的内容块控制在 200 字以内。
- Cookie 有效期：发布功能的 Cookie 有过期限制，过期后需要重新获取。
- 发布依赖：发布功能依赖 xhs 库，需要安装：
pip install xhs - 旧版已知问题：单张卡片内容过多时可能出现文字溢出，需手动用 --- 分隔。