xhs_note · diff
v1.0.0 to v1.1.0
29 added, 10 removed. Audit F to F.
---
name: xhs_note
- description: '小红书图文创作 / 笔记 / 种草文案 (xiaohongshu / red note) — 端到端：成文→图文卡片(HTML→图)→去AI化→交付。标题四件套 + 碎句正文 + 话题标签，配 3:4 竖版卡片。honors user persona & style memory.'
- version: 1.0.0
+ description: '小红书图文创作 / 笔记 / 种草文案 (xiaohongshu / red note) — 端到端：成文→配图(≥3 张竖版)→去AI化→在线预览打包交付。以图为主、文字辅助：标题四件套 + 碎句正文 + 话题标签，配 3:4 竖版卡片，最少 3 张图。honors user persona & style memory.'
+ version: 1.1.0
tags:
- 小红书
- 图文
- 笔记
- 内容创作
- xiaohongshu
platforms:
- macos
- linux
- windows
---
# 小红书图文创作
把一个主题做成可直接发布的小红书笔记：文案 + 竖版图文卡片。
+ > 🖼️ **小红书是「以图为主、文字辅助」的平台**。读者先滑图、再看字——首图（封面）决定点不点进来，图不够好、不够多，文案再好也没人看。
+ >
+ > **硬性要求：每篇笔记至少 3 张竖版图（1 封面 + ≥2 张内容图/照片）**。`xhs_package` 会强制校验，不足 3 张直接拒绝打包。图要成组、风格统一、信息落在图上（大标题/清单/对比都做进图里），正文只作补充。
+
## 开工前：读取共享人设记忆
先用 `recall_structured` 取回并全程遵守：
- `content_persona` — 人设 / 口吻
- `writing_style_xhs` — 小红书文风
- `topic_interests` — 选题方向
- `banned_words` — 禁用 / 敏感词
- `signature_blocks` — 固定开场 / 结尾段
取不到就用中性默认，不要编造。
## SOP
### 1. 成文（小红书文案公式）
**标题（≤20 字，四件套任选组合）**
- **数字**：「30天」「省了800块」「3个动作」
- **悬念**：「原来一直做错了……」
- **情绪**：😭 😮💨 🤯 直给情绪
- **对比 / 反转**：「从烂脸到裸妆出门」
**正文**
- 碎句、一句一断，用 emoji 分段。
- 开头**痛点共鸣**，戳中读者才往下看。
- 中段**干货清单**：可操作、具体、有数字。
- 全程 `writing_style_xhs` + `content_persona`，大量第一人称和"姐妹们 / 你"。
**话题标签（3–8 个）**
大词 + 中词 + 长尾组合，例：`#护肤` `#敏感肌护肤` `#学生党平价护肤`。
- ### 2. 图文卡片（HTML → 图）
+ ### 2. 配图（以图为主，**≥3 张竖版**）
+ 这是小红书的重头戏。**至少出 3 张 3:4 竖版图**，一组风格统一：
+
+ 1. **封面（第 1 张，必出）** — 大标题 + 一句钩子，缩略图上就能读懂、想点进来。
+ 2. **内容图（≥2 张）** — 把干货做进图里：清单卡、步骤卡、对比卡、金句卡，或用 `image_generate`（`aspectRatio=portrait`）出实拍风照片/场景图。一条要点一张，别把所有字堆一张。
+ 3. **结尾图（可选）** — 关注 / 互动引导卡。
+
+ 两种出图方式，按需混用，凑够 ≥3 张：
+
+ - **HTML 卡片 → 图**：用下面的模板库填文案后 `render_html_image` 渲染。
+ - **AI 生成照片/背景**：`image_generate(action=generate, aspectRatio=portrait)`（3:4 竖版），做封面底图或实拍风内容图。
+
**卡片模板库**（竖版 3:4，挑选组合或据用户口味自创）：
- `references/xhs_card_cover.html` — 封面 / 大标题。
- `references/xhs_card_content.html` — 干货清单。
- `references/xhs_card_end.html` — 关注 CTA。
- `references/xhs_card_quote.html` — 金句 / 大字引用卡。
想要别的视觉风格时，直接生成一份新的自包含 HTML 卡片（可参考现有模板结构），不必局限于现成几款。`render_html_image` 渲染出的 PNG **本身就是预览**——先把图给用户看，满意再进入第 4 步打包。
**填充占位符**：每个模板里有 `{{TITLE}}` `{{SUBTITLE}}` `{{POINTS}}` `{{CTA}}` 等占位 token。把第 1 步的文案填进去——`{{POINTS}}` 是清单，按模板注释里的格式（每条一个 `<li>`）注入。
**渲染成图**：用 `render_html_image` 把填好的 HTML 渲染成 PNG。两种传法：
- 写入临时文件后传 `filePath`：
```
render_html_image(filePath="<填好的卡片.html>", filename="xhs_cover",
width=1080, height=1440, fullPage=false)
```
- 或直接内联传 `html="<填好的完整HTML字符串>"`，其余参数同上。
竖版 3:4 用 `width=1080 height=1440`。`fullPage=false` 保证输出严格 3:4，不因内容溢出而拉长。
**可选封面底图**：想要更精致的封面，可先用 `image_generate`（`aspectRatio=portrait`）生成一张背景图，再把其链接填进封面模板的背景占位处。
### 3. 去 AI 化
`load_skill deai_humanize`，对正文跑"打分→改写→复检"循环，`platform=xhs`，目标 `score ≤ 55`。小红书口吻要碎、要有情绪，别写成公众号。
- ### 4. 交付
+ ### 4. 打包交付（xhs_package —— 在线预览 + 素材下载）
- 用 `xhs_publish`（action=export）把**卡片图 + 正文 + 话题标签**打成一个 `.zip` 发布包，一键下载：
+ **默认用 `xhs_package` 交付**。它产出小红书风的**在线预览**（手机版：图在上、可左右滑动，标题/正文/标签在下辅助）+ **素材 zip**（按 01、02… 编号的卡片图 + 文案.txt），并附手动上传步骤：
```
- xhs_publish(action="export", title="<标题>", body="<正文>",
+ xhs_package(title="<标题>", body="<正文，含 emoji 与换行>",
tags="标签1,标签2,标签3",
- images="<封面卡的 render_html_image 下载链接>,<内容卡链接>,<结尾卡链接>")
+ images="<封面图链接>,<内容图1链接>,<内容图2链接>[,更多]")
```
- `images` 按顺序传每张卡片的 `render_html_image` 返回链接（首图即封面）。工具会返回发布包下载链接 + 手动上传步骤。
+ `images` 按展示顺序传每张图的 `render_html_image` / `image_generate` 返回链接（**首图即封面**）。
- 小红书**没有官方发布 API**：由用户下载后到创作平台手动上传完成发布，**不自动上传、不绕过任何风控/人机验证**。发布属于对外动作，必须用户明确同意。
+ > ⚠️ **`xhs_package` 强制 ≥3 张图**：解析到的图不足 3 张会被直接拒绝，并提示去补图。所以第 2 步务必先把 ≥3 张竖版图都出好，再来打包。
- 发布前对照 `banned_words` 扫一遍正文和标题，命中即标注替换。
+ 把返回的**在线预览链接**发给用户看；满意后由用户下载素材 zip，到创作平台手动上传。小红书**没有官方发布 API**：**不自动上传、不绕过任何风控/人机验证**。发布属于对外动作，必须用户明确同意。
+
+ （旧的 `xhs_publish` 只出 zip、无在线预览，`xhs_package` 已覆盖并更完整；仅在用户只要发布包、不需要预览时才用它。）
+
+ 打包前对照 `banned_words` 扫一遍正文和标题，命中即标注替换。
## 保存自定义卡片模板 / 对话升级技能
用户满意某个自创卡片、想复用时，用 `skill_manage` 存成**自定义技能**（`builtin=false` 才能写）：
- `skill_manage(action="create", name="my_xhs_cards", content="<一份 SKILL.md>")`（首次）。
- `skill_manage(action="write_file", name="my_xhs_cards", filePath="references/<卡片名>.html", content="<HTML>")`。
> 本技能 `xhs_note` 是内置技能、不能被直接编辑；自定义卡片一律存到用户自己的自定义技能里。写入都会过安全扫描。
## 参考
- `references/xhs_card_cover.html` — 封面大标题卡（bold hero）。
- `references/xhs_card_content.html` — 干货清单卡（clean list）。
- `references/xhs_card_end.html` — 关注引导卡（follow CTA）。
- `references/xhs_card_quote.html` — 金句 / 大字引用卡。