| name | xhs-note-creator |
| version | 2.0.0 |
| description | 小红书笔记素材创作技能。当用户需要创建小红书笔记素材时使用这个技能。技能包含：根据用户的需求和提供的资料，撰写小红书笔记内容（标题+正文），生成图片卡片（封面+正文卡片），以及发布小红书笔记。 |
小红书笔记创作技能
这个技能用于创建专业的小红书笔记素材，包括内容撰写、图片卡片生成和笔记发布。
使用场景
- 用户需要创建小红书笔记时
- 用户提供资料需要转化为小红书风格内容时
- 用户需要生成精美的图片卡片用于发布时
工作流程
第一步：撰写小红书笔记内容
根据用户需求和提供的资料，创作符合小红书风格的内容：
标题要求
- 不超过 20 字
- 吸引眼球，制造好奇心
- 可使用数字、疑问句、感叹号增强吸引力
- 示例：「5个让效率翻倍的神器推荐！」「震惊！原来这样做才对」
正文要求
- 使用良好的排版，段落清晰
- 点缀少量 Emoji 增加可读性（每段 1-2 个即可）
- 使用简短的句子和段落
- 结尾给出 SEO 友好的 Tags 标签（5-10 个相关标签）
第二步：生成 Markdown 文档
注意：这里生成的 Markdown 文档是用于渲染卡片的，必须专门生成，禁止直接使用上一步的笔记正文内容。
Markdown 文件，文件应包含：
- YAML 头部元数据（封面信息）：
---
emoji: "🚀"
title: "大标题"
subtitle: "副标题文案"
---
- 用于渲染卡片的 Markdown 文本内容：
- 当待渲染内容必须严格切分为独立的数张图片时，可使用
--- 分割线主动将正文分隔为多个卡片段落（每个段落文本控制在 200 字左右），输出图片时使用参数-m separator
- 当待渲染内容无需严格分割，生成正常 Markdown 文本即可，跟下方分页模式参数规则按需选择
完整 Markdown 文档内容示例：
---
emoji: "💡"
title: "5个效率神器让工作效率翻倍"
subtitle: "对着抄作业就好了，一起变高效"
---
# 📝 神器一：Notion
> 全能型笔记工具，支持数据库、看板、日历等多种视图...
## 特色功能
- 特色一
- 特色二
# ⚡ 神器二：Raycast
\`\`\`
可使用代码块来增加渲染后图片的视觉丰富度
\`\`\`
## 推荐原因
- 原因一
- 原因二
- ……
# 🌈 神器三：Arc
全新理念的浏览器，侧边栏标签管理...
...
第三步：渲染图片卡片
将 Markdown 文档渲染为图片卡片。使用以下脚本渲染：
python scripts/render_xhs.py <markdown_file> [options]
- 默认输出目录为当前工作目录
- 生成的图片包括：封面（cover.png）和正文卡片（card_1.png, card_2.png, ...）
渲染参数（Python）
| 参数 | 简写 | 说明 | 默认值 |
|---|
--output-dir | -o | 输出目录 | 当前工作目录 |
--theme | -t | 排版主题 | default |
--mode | -m | 分页模式 | separator |
--width | -w | 图片宽度 | 1080 |
--height | | 图片高度（dynamic 下为最小高度） | 1440 |
--max-height | | dynamic 最大高度 | 4320 |
--dpr | | 设备像素比（清晰度） | 2 |
排版主题（--theme）
default：默认简约浅灰渐变背景（#f3f3f3 -> #f9f9f9）playful-geometric：活泼几何（Memphis）neo-brutalism：新粗野主义botanical：植物园自然professional：专业商务retro：复古怀旧terminal：终端命令行sketch：手绘素描
分页模式（--mode）
separator：按 --- 分隔符分页（适合内容已手动控量）auto-fit：固定尺寸下自动缩放文字，避免溢出/留白（适合封面+单张图片但尺寸固定的情况）auto-split：按渲染后高度自动切分分页（适合切分不影响阅读的长文内容）dynamic：根据内容动态调整图片高度（注意：图片最高 4320，字数超过 550 的不建使用此模式）
常用示例
python scripts/render_xhs.py content.md -m separator
python scripts/render_xhs.py content.md -m auto-fit
python scripts/render_xhs.py content.md -m auto-split
python scripts/render_xhs.py content.md -m dynamic --max-height 4320
python scripts/render_xhs.py content.md -t playful-geometric -m auto-split
Node.js 渲染（可选）
node scripts/render_xhs.js content.md -t default -m separator
Node.js 参数与 Python 基本一致：--output-dir/-o、--theme/-t、--mode/-m、--width/-w、--height、--max-height、--dpr。
第四步：发布小红书笔记（可选）
使用发布脚本将生成的图片发布到小红书：
python scripts/publish_xhs.py --title "笔记标题" --desc "笔记描述" --images card_1.png card_2.png cover.png
前置条件：
-
需配置小红书 Cookie：
- 方式一：设置环境变量
XHS_COOKIE=your_cookie_string_here
- 方式二（推荐）：从 memory 读取，执行
memory_search 检索 xhs-cookie，然后从 memory/xhs-cookie.md 获取
-
Cookie 获取方式（如需要重新获取）：
图片规格说明
封面卡片
- 尺寸比例：3:4（小红书推荐比例）
- 基准尺寸：1080×1440px
- 包含：Emoji 装饰、大标题、副标题
- 样式：渐变背景 + 圆角内容区
正文卡片
- 尺寸比例：3:4
- 基准尺寸：1080×1440px
- 支持：标题、段落、列表、引用、代码块、图片
- 样式：白色卡片 + 渐变背景边框
技能资源
脚本文件
scripts/render_xhs.py - Python 渲染脚本scripts/render_xhs.js - Node.js 渲染脚本scripts/publish_xhs.py - 小红书发布脚本
资源文件
assets/cover.html - 封面 HTML 模板assets/card.html - 正文卡片 HTML 模板assets/styles.css - 共用样式表
注意事项
- Markdown 文件应保存在工作目录，渲染后的图片也保存在工作目录
- 技能目录 (
md2Redbook/) 仅存放脚本和模板，不存放用户数据
- 图片尺寸会根据内容自动调整，但保持 3:4 比例
- Cookie 有有效期限制，过期后需要重新获取
- 发布功能依赖 xhs 库，需要安装：
pip install xhs
