| name | xhs-note-creator |
| description | 小红书文字笔记创作与卡片渲染技能。适用于以文字内容为主的笔记场景（干货分享、知识科普、清单排行、教程步骤、资源推荐等）。本技能负责：(1) 撰写小红书笔记文案（标题+正文+标签），(2) 通过本地渲染脚本生成排版精美的图片卡片（9 种 CSS 主题 + 多种分页模式）。本技能不再内置发布能力——发布请交由 xhs-publisher 技能，通过浏览器自动化以真实用户操作方式发布，规避直接调用平台接口的高风险。触发关键词："写笔记"、"发小红书"、"小红书文案"、"撰写笔记"、"排版卡片"、"生成卡片"。注意：当用户需要 AI 生成插画/卡通/手绘风格的原创配图内容（非文字排版）时，应使用 xhs-images-design 技能而非本技能。 |
小红书笔记创作技能
根据用户提供的资料或需求，创作小红书笔记内容、生成精美图片卡片。卡片渲染完成后，发布必须交由独立的 xhs-publisher 技能通过浏览器自动化完成（详见第五步）；不要使用其他技能或临时拼接发布流程，以免因步骤较多导致失败。
详细参数文档见 references/params.md
工作流程
第零步：创建选题文件夹
在生成任何 Markdown 或图片文件前，先在项目根目录创建本次选题文件夹：
- 使用当天日期创建一级目录，格式为
YYYYMMDD，例如 20260513/。
- 从本次选题中提炼一个具体关键词作为目录名，不要使用泛化的
subject。目录格式为 <keyword>_N，例如 20260513/skincare_1/；如果同一关键词目录已存在，则使用下一个可用编号。
- 本次生成的所有文件都必须放入该选题目录，包括第一步的纯文本笔记
note.md、第二步的渲染用 Markdown（如 content.md）以及后续生成的 cover.png、card_1.png 等图片。
关键词命名要求：使用一个能概括选题的短词，优先用英文或拼音小写，必要时用数字；只使用字母、数字、连字符或下划线。示例：护肤选题用 skincare_1，咖啡选题用 coffee_1，AI 工具选题用 aitools_1。
示例结构：
20260513/
└── skincare_1/
├── note.md
├── content.md
├── cover.png
├── card_1.png
└── card_2.png
第一步：撰写小红书笔记内容
根据用户需求和资料，创作符合小红书风格的内容：
标题：不超过 18 字，吸引眼球，可用数字/疑问句/感叹号增强吸引力。
正文：段落清晰，点缀少量 Emoji（每段 1-2 个），短句短段，结尾附 5-10 个 SEO 标签。不要使用任何 Markdown 语法！！只用 emoji、换行和全角符号排版。
第二步：生成渲染用 Markdown 文档
注意：此 Markdown 专为图片渲染设计，禁止直接使用上一步的笔记正文。
文档结构：
---
emoji: "🚀"
title: "封面大标题（≤15字）"
subtitle: "封面副标题（≤15字）"
---
# 标题
内容...
---
# 标题
内容...
上方示例生成：一张封面（emoji + title + subtitle）+ 两张正文卡片（各自的 # 标题作为卡片标题）。
分页策略选择：
- 内容需精确切分 → 用
--- 手动分隔，配合 -m separator
- 内容长短不稳定 → 生成普通 Markdown，使用
-m auto-split
第三步：选择主题风格
渲染前，必须向用户展示所有可用主题并让用户选择。使用 AskUserQuestion 工具，将 9 种主题作为选项列出：
| 编号 | 主题值 | 名称 | 视觉特征 |
|---|
| 1 | sketch | 手绘素描 | 手绘线条风格，温暖自然 |
| 2 | default | 默认简约 | 浅灰渐变背景，干净利落 |
| 3 | playful-geometric | 活泼几何 | Memphis 设计风格，色彩丰富 |
| 4 | neo-brutalism | 新粗野主义 | 粗框线条、强对比色块 |
| 5 | botanical | 植物园自然 | 绿植元素，自然清新 |
| 6 | professional | 专业商务 | 商务蓝色调，简洁正式 |
| 7 | retro | 复古怀旧 | 暖色调复古感，年代氛围 |
| 8 | terminal | 终端命令行 | 深色背景，代码终端风格 |
| 9 | pink-notebook | 粉色笔记本 | 粉色格子纸、手绘贴纸、玫瑰棕文字 |
展示方式：使用 AskUserQuestion 工具，将 9 种主题作为选项列出，每个选项包含名称和简短描述，等待用户选择后再进入渲染步骤。
第四步：渲染图片卡片
根据用户在第三步选择的主题，执行渲染命令：
python scripts/render_xhs.py <选题文件夹>/content.md -t <用户选择的主题> -o <选题文件夹> [options]
默认分页：separator（按 --- 分隔）
常用示例：
python scripts/render_xhs.py 20260513/skincare_1/content.md -t sketch -o 20260513/skincare_1
python scripts/render_xhs.py 20260513/skincare_1/content.md -t playful-geometric -m auto-split -o 20260513/skincare_1
生成结果保存在选题文件夹中：cover.png（封面）+ card_1.png、card_2.png...（正文卡片）。如果不传 -o，渲染脚本默认把图片输出到 Markdown 文件所在目录。
分页模式（-m）：separator、auto-split、dynamic
完整参数说明见 references/params.md
第五步：发布小红书笔记（必须交由 xhs-publisher 技能）
本技能已不再内置任何发布脚本，也不再涉及 Cookie 或平台接口调用。早期版本曾通过 publish_xhs.py 直接调用小红书接口发布，但直接调用平台接口风险极高（易触发风控、账号受限），已整体移除。
卡片渲染完成后，发布必须交由独立的 xhs-publisher 技能完成：它通过 Playwright 驱动真实浏览器，完整模拟真实用户的扫码登录、点击、输入、上传与点「发布」操作，全程不碰任何私有接口或签名，安全性远高于直接调接口。发布流程步骤较多，使用其他技能或自行拼接流程容易遗漏状态检查、上传顺序、隐私设置或发布按钮点击逻辑，导致失败。
接续方式：将本技能产出的 cover.png、card_*.png、标题与正文交给 xhs-publisher，由其走浏览器发布流程（默认「仅自己可见」，发布后由用户在小红书端自行决定是否公开）。
本技能只负责「写文案 + 渲染卡片」；发布动作必须调用 xhs-publisher 技能。不要使用其他技能执行发布流程，发布步骤较多，容易因遗漏环节而失败。
技能资源
脚本
scripts/render_xhs.py — 渲染脚本（主推，9 主题 + 多种分页模式）scripts/render_xhs_v2.py — 渲染脚本 V2（备用，7 种渐变色彩风格）scripts/render_xhs.js / scripts/render_xhs_v2.js — Node.js 版渲染脚本（参数与 Python 版基本一致）
发布能力已迁移至独立的 xhs-publisher 技能（浏览器自动化），本目录不再保留任何发布/Cookie 脚本。
模板与样式
assets/cover.html — 封面 HTML 模板assets/card.html — 正文卡片 HTML 模板assets/styles.css — 公共容器样式assets/themes/ — 各主题 CSS 文件
参考文档
references/params.md — 完整参数参考（主题/模式）
