xiaohongshu-writer

name	xiaohongshu-writer
description	小红书图文内容创作助手。**必须传入 content**（含 title、body、hashtags、thumbnail），建议 generate_thumbnail=true。优先 Playwright HTML 截图生成封面，失败时回退 Pillow。
license	MIT
compatibility	Requires Python 3.x with playwright (pip install playwright, playwright install chromium)，或 Pillow 作为回退
metadata	{"author":"skillLite","version":"1.0"}

小红书图文创作助手

工作流程

1. Agent 用本 Skill 的指引，根据用户主题生成完整内容（标题、正文、标签、封面设计）
2. 调用本工具，传入生成的 content，建议 generate_thumbnail: true
3. 脚本：优先用 Playwright 渲染 HTML 并截图（效果好、排版一致），失败时回退 Pillow；返回 base64 及保存到 image_path

无需 OpenAI，优先 Playwright HTML 截图，回退 Pillow 绘图。

---

输出结构（工具返回）

{
  "success": true,
  "title": "吸睛标题，带 emoji",
  "body": "正文内容",
  "hashtags": ["#话题1", "#话题2"],
  "thumbnail": {
    "cover_title": "封面显示标题",
    "accent_color": "#FF6B6B",
    "style": "gradient",
    "image_base64": "封面图 base64（仅当未保存到文件时返回，避免输出过大）",
    "image_path": "项目根目录下保存的图片路径，如 xiaohongshu_thumbnail.png",
    "image_source": "playwright 或 pillow"
  }
}

---

标题规则

• 长度：15-25 字为宜，信息密度高
• 必备：至少 1 个 emoji，放在开头或关键词处
• 禁止：标题党、夸张承诺、违禁词
• 技巧：数字+结果、反常识、疑问式、场景代入

---

正文规则

• 分段：每段 2-4 行，多用空行隔开
• 语气：口语化、像朋友分享，用"我"、"你"
• emoji：适当点缀，每段 0-2 个，不过度
• 结构：开头抓人 → 干货/故事 → 总结/互动
• 禁止：硬广感、堆砌关键词、违禁词

---

标签规则

• 数量：3-5 个
• 搭配：1 个大类话题 + 2-3 个细分 + 1 个热门
• 示例：#生活好物 #平价好物 #宿舍党必备 #618攻略

---

缩略图（封面）设计

封面为高质量图文风格，包含三部分：主标题、正文摘要（2–5 行）、话题标签。由 Playwright 渲染 HTML 并截图（主）或 Pillow 绘制（备选）生成，竖版 3:4。成功后保存到项目根目录 xiaohongshu_thumbnail.png。

Agent 生成 content 时，thumbnail 需包含：

字段	说明	示例
cover_title	封面上显示的主标题（可略，默认用 title）	"3 件办公室好物"
accent_color	主色调，十六进制或中文	"#FF6B6B" 或 "暖橙"
style	风格	"gradient" / "minimal" / "vibrant"

风格说明

• gradient：渐变背景，主色到深色（默认）
• minimal：简约灰白
• vibrant：纯色块

---

使用方式

工具调用：传入 content（必填），即 Agent 已生成的内容。格式：

{
  "content": {
    "title": "🛒 打工人的 3 件办公室好物！",
    "body": "正文...",
    "hashtags": ["#办公室好物", ...],
    "thumbnail": {
      "cover_title": "3 件办公室好物",
      "accent_color": "#FF6B6B",
      "style": "gradient"
    }
  },
  "generate_thumbnail": true
}

前置条件：

• pip install playwright 且执行 playwright install chromium（优先，skilllite init 时会安装）
• 可选回退：pip install Pillow 及中文字体（macOS 自带 PingFang；Linux: apt install fonts-noto-cjk；或于 .skills/xiaohongshu-writer/fonts/ 放入 NotoSansCJKsc-Regular.otf）

沙箱下使用 Playwright：macOS 沙箱会阻止 fork/spawn。若需 HTML 截图，可设置；仅本技能会跳过沙箱（其它技能仍走沙箱）：

• SKILLBOX_SANDBOX_LEVEL=2，或
• SKILLBOX_ALLOW_PLAYWRIGHT=1

Runtime

entry_point: scripts/main.py
language: python
input_schema:
  type: object
  properties:
    content:
      type: object
      description: Agent 生成的小红书内容，含 title、body、hashtags、thumbnail
    generate_thumbnail:
      type: boolean
      description: 是否生成缩略图
      default: true
  required:
    - content