xhs-note-creator

小红书笔记创作技能

根据用户提供的资料或需求，创作小红书笔记内容、生成精美图片卡片，并可选择发布到小红书。

详细参数文档见 references/params.md

工作流程

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

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

标题：不超过 20 字，吸引眼球，可用数字/疑问句/感叹号增强吸引力。

正文：段落清晰，点缀少量 Emoji（每段 1-2 个），短句短段，结尾附 5-10 个 SEO 标签。

第二步：生成渲染用 Markdown 文档

注意：此 Markdown 专为图片渲染设计，禁止直接使用上一步的笔记正文。

文档结构：

---
emoji: "🚀"
title: "封面大标题（≤15字）"
subtitle: "封面副标题（≤15字）"
---

# 正文内容...

---

# 第二张卡片内容...（使用 --- 手动分隔时）

分页策略选择：

• 内容需精确切分 → 用 --- 手动分隔，配合 -m separator
• 内容长短不稳定 → 生成普通 Markdown，使用 -m auto-split

第三步：渲染图片卡片

python scripts/render_xhs.py <markdown_file> [options]

默认主题：sketch（手绘素描风格）
默认分页：separator（按 --- 分隔）

常用示例：

# 默认（sketch 主题 + 手动分页）
python scripts/render_xhs.py content.md

# 自动分页（推荐内容长短不定时）
python scripts/render_xhs.py content.md -m auto-split

# 切换主题
python scripts/render_xhs.py content.md -t playful-geometric -m auto-split

# 固定尺寸自动缩放
python scripts/render_xhs.py content.md -m auto-fit

生成结果：cover.png（封面）+ card_1.png、card_2.png...（正文卡片）

可用主题（-t）：sketch、default、playful-geometric、neo-brutalism、botanical、professional、retro、terminal

分页模式（-m）：separator、auto-fit、auto-split、dynamic

完整参数说明见 references/params.md

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

前置条件：安装 Python 与 Node.js 依赖，并配置 .env 中的 XHS_CREATOR_COOKIE。Cookie 必须来自已登录的 https://creator.xiaohongshu.com（详见 references/params.md）。

# 默认仅自己可见（推荐先预览确认）
python scripts/publish_xhs.py --title "笔记标题" --desc "笔记描述" \
  --images cover.png card_1.png card_2.png

# 确认无误后公开发布
python scripts/publish_xhs.py --title "笔记标题" --desc "笔记描述" \
  --images cover.png card_1.png card_2.png --public

默认以「仅自己可见」发布，加 --public 参数才会公开。 发布链路已内置在当前技能中，不依赖外部 API 服务或其他项目目录。

技能资源

脚本

• scripts/render_xhs.py — 渲染脚本（主推，8 主题 + 4 分页模式）
• scripts/render_xhs_v2.py — 渲染脚本 V2（备用，7 种渐变色彩风格）
• scripts/publish_xhs.py — 发布脚本

模板与样式

• assets/cover.html — 封面 HTML 模板
• assets/card.html — 正文卡片 HTML 模板
• assets/styles.css — 公共容器样式
• assets/themes/ — 各主题 CSS 文件

参考文档

• references/params.md — 完整参数参考（主题/模式/发布参数）