xhs-note

# 小红书图文创作 把一个主题做成可直接发布的小红书笔记：文案 + 竖版图文卡片。 > 🖼️ **小红书是「以图为主、文字辅助」的平台**。读者先滑图、再看字——首图（封面）决定点不点进来，图不够好、不够多，文案再好也没人看。 > > **硬性要求：每篇笔记至少 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. 配图（以图为主，**≥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. 打包交付（xhs_package —— 在线预览 + 素材下载） **默认用 `xhs_package` 交付**。它产出小红书风的**在线预览**（手机版：图在上、可左右滑动，标题/正文/标签在下辅助）+ **素材 zip**（按 01、02… 编号的卡片图 + 文案.txt），并附手动上传步骤： ``` xhs_package(title="<标题>", body="<正文，含 emoji 与换行>", tags="标签1,标签2,标签3", images="<封面图链接>,<内容图1链接>,<内容图2链接>[,更多]") ``` `images` 按展示顺序传每张图的 `render_html_image` / `image_generate` 返回链接（**首图即封面**）。 > ⚠️ **`xhs_package` 强制 ≥3 张图**：解析到的图不足 3 张会被直接拒绝，并提示去补图。所以第 2 步务必先把 ≥3 张竖版图都出好，再来打包。 把返回的**在线预览链接**发给用户看；满意后由用户下载素材 zip，到创作平台手动上传。小红书**没有官方发布 API**：**不自动上传、不绕过任何风控/人机验证**。发布属于对外动作，必须用户明确同意。 （旧的 `xhs_publish` 只出 zip、无在线预览，`xhs_package` 已覆盖并更完整；仅在用户只要发布包、不需要预览时才用它。） 打包前对照 `banned_words` 扫一遍正文和标题，命中即标注替换。 ## 定时 / 批量场景：内容日历 + 合规 长期投产（每日定时）时： - **选题前查重（成文前）**：`content_item(action="check_recent", platform="xhs", topic="<选题>")`，命中就换角度。只计已打包/已发布。 - **交付即扫即记（自动）**：`xhs_package` 交付时会**自动**跑合规扫描并**自动记入内容日历**——你只需在 `xhs_package` 里传上 `topic="<选题>"`（与 `title` 区分）。个人 / 品牌禁用词可另调 `compliance_scan(text, extraBannedWords="<recall 到的 banned_words>")`。 - **上传后**：用户手动发布后 `content_item(action="mark_published", id)`，就能知道哪些已发、哪些还在待办。 ## 保存自定义卡片模板 / 对话升级技能 用户满意某个自创卡片、想复用时，用 `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` — 金句 / 大字引用卡。