mirror of
https://github.com/comeonzhj/Auto-Redbook-Skills.git
synced 2026-03-27 12:49:27 +08:00
feat: v2.0 智能分页渲染 + 7种可选样式
新增功能： - 智能分页渲染脚本（Python/Node.js），自动解决内容溢出问题 - 7种可选样式主题：purple, xiaohongshu, mint, sunset, ocean, elegant, dark - 新增 STYLES.md 样式选择指南 - 更新 README，添加 v2.0 更新说明 - 保留 V1 旧版脚本保证兼容性 使用方式： python scripts/render_xhs_v2.py note.md --style sunset
This commit is contained in:
ZhangJia
113
SKILL.md
113
SKILL.md
@@ -1,17 +1,18 @@
|
||||
---
|
||||
name: xhs-note-creator
|
||||
description: 小红书笔记素材创作技能。当用户需要创建小红书笔记素材时使用这个技能。技能包含：根据用户的需求和提供的资料，撰写小红书笔记内容（标题+正文），生成图片卡片（封面+正文卡片），以及发布小红书笔记。
|
||||
name: Auto-Redbook
|
||||
description: 小红书笔记素材创作技能。当用户需要创建小红书笔记素材时使用这个技能。技能包含：根据用户的需求和提供的资料，撰写小红书笔记内容（标题+正文），生成图片卡片（封面+正文卡片，支持多种样式主题）。
|
||||
---
|
||||
|
||||
# 小红书笔记创作技能
|
||||
|
||||
这个技能用于创建专业的小红书笔记素材，包括内容撰写、图片卡片生成和笔记发布。
|
||||
这个技能用于创建专业的小红书笔记素材，包括内容撰写、图片卡片生成（支持7种样式主题）和智能分页渲染。
|
||||
|
||||
## 使用场景
|
||||
|
||||
- 用户需要创建小红书笔记时
|
||||
- 用户提供资料需要转化为小红书风格内容时
|
||||
- 用户需要生成精美的图片卡片用于发布时
|
||||
- 用户需要多种风格样式选择时
|
||||
|
||||
## 工作流程
|
||||
|
||||
@@ -49,7 +50,7 @@ subtitle: "副标题文案" # 封面副标题（不超过15字）
|
||||
2. 用于渲染卡片的 Markdown 文本内容：
|
||||
- 使用 `---` 分割线将正文分隔为多个卡片段落
|
||||
- 每个分段的文字控制在 200 字左右
|
||||
- 后续会将每个卡片段落渲染为一张图片
|
||||
- 脚本会自动检测内容高度并智能分页
|
||||
|
||||
完整示例：
|
||||
```markdown
|
||||
@@ -72,9 +73,7 @@ subtitle: "对着抄作业就好了，一起变高效"
|
||||
|
||||
# 神器二：Raycast ⚡
|
||||
|
||||
\`\`\`
|
||||
可使用代码块来增加渲染后图片的视觉丰富度
|
||||
\`\`\`
|
||||
|
||||
## 推荐原因
|
||||
|
||||
@@ -90,28 +89,74 @@ subtitle: "对着抄作业就好了，一起变高效"
|
||||
|
||||
...
|
||||
|
||||
#效率工具 #生产力 #Mac软件
|
||||
```
|
||||
|
||||
### 第三步：渲染图片卡片
|
||||
|
||||
将 Markdown 文档渲染为图片卡片。提供两种渲染脚本：
|
||||
将 Markdown 文档渲染为图片卡片。**推荐使用 V2 版本脚本**，支持智能分页和多种样式。
|
||||
|
||||
#### Python 渲染脚本
|
||||
#### V2 渲染脚本（推荐）
|
||||
|
||||
V2 版本新增特性：
|
||||
- ✅ **智能分页**：自动检测内容高度，超出时自动拆分到多张卡片
|
||||
- ✅ **多种样式**：支持 7 种预设样式主题
|
||||
- ✅ **字数预估**：基于字数预分配内容，减少渲染次数
|
||||
|
||||
**Python 版本：**
|
||||
|
||||
```bash
|
||||
python scripts/render_xhs.py <markdown_file> [--output-dir <output_directory>]
|
||||
# 基本用法
|
||||
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
|
||||
```
|
||||
|
||||
- 默认输出目录为当前工作目录
|
||||
- 生成的图片包括：封面（cover.png）和正文卡片（card_1.png, card_2.png, ...）
|
||||
|
||||
#### Node.js 渲染脚本
|
||||
**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>]
|
||||
```
|
||||
|
||||
功能与 Python 版本相同。
|
||||
**旧版已知问题**：单张卡片内容过多时可能出现文字溢出，需手动用 `---` 分隔。
|
||||
|
||||
### 第四步：发布小红书笔记（可选）
|
||||
|
||||
@@ -139,30 +184,46 @@ XHS_COOKIE=your_cookie_string_here
|
||||
- 尺寸比例：3:4（小红书推荐比例）
|
||||
- 基准尺寸：1080×1440px
|
||||
- 包含：Emoji 装饰、大标题、副标题
|
||||
- 样式：渐变背景 + 圆角内容区
|
||||
- 样式：渐变背景 + 圆角内容区（根据所选主题变化）
|
||||
|
||||
### 正文卡片
|
||||
- 尺寸比例：3:4
|
||||
- 基准尺寸：1080×1440px
|
||||
- 支持：标题、段落、列表、引用、代码块、图片
|
||||
- 样式：白色卡片 + 渐变背景边框
|
||||
- 样式：白色卡片 + 渐变背景边框（根据所选主题变化）
|
||||
- V2 版本：自动分页，单张卡片内容不会溢出
|
||||
|
||||
## 技能资源
|
||||
|
||||
### 脚本文件
|
||||
- `scripts/render_xhs.py` - Python 渲染脚本
|
||||
- `scripts/render_xhs.js` - Node.js 渲染脚本
|
||||
- `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/cover.html` - 封面 HTML 模板（旧版）
|
||||
- `assets/card.html` - 正文卡片 HTML 模板（旧版）
|
||||
- `assets/styles.css` - 共用样式表（旧版）
|
||||
- `assets/example.md` - 示例 Markdown 文件
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. Markdown 文件应保存在工作目录，渲染后的图片也保存在工作目录
|
||||
2. 技能目录 (`md2Redbook/`) 仅存放脚本和模板，不存放用户数据
|
||||
3. 图片尺寸会根据内容自动调整，但保持 3:4 比例
|
||||
4. Cookie 有有效期限制，过期后需要重新获取
|
||||
5. 发布功能依赖 xhs 库，需要安装：`pip install xhs`
|
||||
1. **V2 版本推荐**：V2 版本支持智能分页，可自动处理内容溢出问题
|
||||
2. **样式选择**：根据内容风格选择合适的样式主题
|
||||
3. **Markdown 位置**：Markdown 文件应保存在工作目录，渲染后的图片也保存在工作目录
|
||||
4. **内容长度**：建议每个 `---` 分隔的内容块控制在 200 字以内
|
||||
5. **Cookie 有效期**：发布功能的 Cookie 有过期限制，过期后需要重新获取
|
||||
6. **发布依赖**：发布功能依赖 xhs 库，需要安装：`pip install xhs`
|
||||
|
||||
## 智能分页说明
|
||||
|
||||
V2 版本的智能分页机制：
|
||||
|
||||
1. **预估阶段**：基于字数、元素类型预估内容高度
|
||||
2. **预渲染阶段**：使用 Playwright 预渲染并测量实际高度
|
||||
3. **拆分阶段**：如果内容超出，按段落/行智能拆分内容
|
||||
4. **固定输出**：每张卡片固定为 1080×1440px，确保一致性
|
||||
|
||||
这种机制确保无论内容多长，都不会出现文字溢出问题。
|
||||
|
||||
Reference in New Issue
Block a user