小红书笔记创作技能

这个技能用于创建专业的小红书笔记素材，包括内容撰写、图片卡片生成（支持7种样式主题）和智能分页渲染。

使用场景

•用户需要创建小红书笔记时
•用户提供资料需要转化为小红书风格内容时
•用户需要生成精美的图片卡片用于发布时
•用户需要多种风格样式选择时

工作流程

第一步：撰写小红书笔记内容

根据用户需求和提供的资料，创作符合小红书风格的内容：

标题要求

•不超过 20 字
•吸引眼球，制造好奇心
•可使用数字、疑问句、感叹号增强吸引力
•示例：「5个让效率翻倍的神器推荐！」「震惊！原来这样做才对」

正文要求

•使用良好的排版，段落清晰
•点缀少量 Emoji 增加可读性（每段 1-2 个即可）
•使用简短的句子和段落
•结尾给出 SEO 友好的 Tags 标签（5-10 个相关标签）

第二步：生成 Markdown 文档

注意：这里生成的 Markdown 文档是用于渲染卡片的，必须专门生成，禁止直接使用上一步的笔记正文内容。

Markdown 文件，文件应包含：

•YAML 头部元数据（封面信息）：

yaml

---
emoji: "🚀"           # 封面装饰 Emoji
title: "大标题"        # 封面大标题（不超过15字）
subtitle: "副标题文案"  # 封面副标题（不超过15字）
---

•
用于渲染卡片的 Markdown 文本内容：
- •使用 --- 分割线将正文分隔为多个卡片段落
- •每个分段的文字控制在 200 字左右
- •脚本会自动检测内容高度并智能分页

完整示例：

markdown

---
emoji: "💡"
title: "5个效率神器让工作效率翻倍"
subtitle: "对着抄作业就好了，一起变高效"
---

# 神器一：Notion 📝

> 全能型笔记工具，支持数据库、看板、日历等多种视图...

## 特色功能

- 特色一
- 特色二

---

# 神器二：Raycast ⚡

可使用代码块来增加渲染后图片的视觉丰富度

## 推荐原因

- 原因一
- 原因二
- ……

---

# 神器三：Arc 🌈

全新理念的浏览器，侧边栏标签管理...

...

#效率工具 #生产力 #Mac软件

第三步：渲染图片卡片

将 Markdown 文档渲染为图片卡片。推荐使用 V2 版本脚本，支持智能分页和多种样式。

V2 渲染脚本（推荐）

V2 版本新增特性：

•✅ 智能分页：自动检测内容高度，超出时自动拆分到多张卡片
•✅ 多种样式：支持 7 种预设样式主题
•✅ 字数预估：基于字数预分配内容，减少渲染次数

Python 版本：

bash

# 基本用法
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 版本：

bash

# 基本用法
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

可用样式主题

样式键	名称	描述
`purple`	紫韵	默认样式，紫蓝色渐变
`xiaohongshu`	小红书红	小红书品牌色系
`mint`	清新薄荷	绿色/自然调
`sunset`	日落橙	粉色/日落渐变
`ocean`	深海蓝	蓝绿色海洋调
`elegant`	优雅白	简约灰白调
`dark`	暗黑模式	深色背景，高对比度

旧版渲染脚本（保留）

如需使用旧版（不支持自动分页）：

bash

# 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>]

旧版已知问题：单张卡片内容过多时可能出现文字溢出，需手动用 --- 分隔。

第四步：发布小红书笔记（可选）

使用发布脚本将生成的图片发布到小红书：

bash

python scripts/publish_xhs.py --title "笔记标题" --desc "笔记描述" --images card_1.png card_2.png cover.png

前置条件：

•在同目录下创建 .env 文件，配置小红书 Cookie：

code

XHS_COOKIE=your_cookie_string_here

•
Cookie 获取方式：
- •在浏览器中登录小红书（https://www.xiaohongshu.com）
- •打开开发者工具（F12）
- •在 Network 标签中查看请求头的 Cookie

图片规格说明

封面卡片

•尺寸比例：3:4（小红书推荐比例）
•基准尺寸：1080×1440px
•包含：Emoji 装饰、大标题、副标题
•样式：渐变背景 + 圆角内容区（根据所选主题变化）

正文卡片

•尺寸比例：3:4
•基准尺寸：1080×1440px
•支持：标题、段落、列表、引用、代码块、图片
•样式：白色卡片 + 渐变背景边框（根据所选主题变化）
•V2 版本：自动分页，单张卡片内容不会溢出

技能资源

脚本文件

•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

智能分页说明

V2 版本的智能分页机制：

•预估阶段：基于字数、元素类型预估内容高度
•预渲染阶段：使用 Playwright 预渲染并测量实际高度
•拆分阶段：如果内容超出，按段落/行智能拆分内容
•固定输出：每张卡片固定为 1080×1440px，确保一致性

这种机制确保无论内容多长，都不会出现文字溢出问题。