/redbook-creator-publish

name: redbook-creator-publish
description: "小红书帖子创作与发布技能。用于：(1) 生成小红书风格的帖子内容（标题+正文+标签）(2) 生成帖子相关的配图 (3) 自动上传到小红书创作者平台（默认自动上传，失败时自动提供手动指引） (4) 生成本地预览HTML文件。触发词：小红书创作、create redbook、小红书、红书、笔记创作、帖子创作"

小红书帖子创作与发布技能

概述

本技能帮助用户创作小红书风格的优质内容，包括标题、正文、标签、配图，并**默认自动上传**到小红书创作者平台。

**重要更新（v3.0）**：

• 🐍 **Python 实现**：使用 Playwright for Python 实现浏览器自动化（新增）
• 🚀 **默认自动上传**：无需询问用户，直接执行自动上传
• 🔧 **智能降级**：自动上传失败时自动提供详细手动上传指引
• ✅ 配图改为 PNG/JPG 格式（不再使用 HTML）
• ✅ 预览 HTML 和 MD 文档支持显示图片
• ✅ 使用 Playwright 浏览器自动化（比 Selenium 更快更稳定）
• ✅ DOM 选择器配置化
• ✅ 话题深度搜索功能

前置检查

在开始工作流程前，必须检查并准备以下环境：

1. 检查 Python 环境（必需）

python3 --version

**要求**：Python 3.0 或更高版本

**如果未安装或版本过低**：

• 输出错误信息：`❌ 未检测到 Python 3+ 环境`
• 提示用户：

  本技能需要 Python 3.0+ 支持。

  安装方法:
  - macOS: brew install python3
  - Windows: 访问 https://www.python.org/ 下载安装

  安装完成后请重新运行此技能。

• **停止执行**，等待用户安装 Python

2. 检查 Playwright 是否安装（首次自动安装）

python3 -c "import playwright" 2>/dev/null && echo "Playwright installed" || echo "Playwright not found"

**如果未安装**：

• 输出信息：`🔍 检测到 Playwright 未安装，正在自动安装...`
• 自动执行安装：

  pip3 install playwright
  playwright install chromium

• 显示安装进度和结果
• 安装完成后输出：`✅ Playwright 安装完成`

**如果已安装**：

• 输出：`✅ Playwright 已安装`

3. 检查 Chrome 浏览器（用于 HTML 转图片）

# macOS
test -d "/Applications/Google Chrome.app" && echo "Chrome installed" || echo "Chrome not found"

**如果未安装**：

• 输出警告信息：`⚠️ 未检测到 Chrome 浏览器`
• 提示用户：

  配图转换需要 Chrome（HTML 转 PNG 功能）。

  下载地址: https://www.google.com/chrome/

  注意：Playwright 会使用 Chromium 进行自动化上传，不依赖系统 Chrome

• 可以继续执行（配图可稍后手动生成）

工作流程

第一步：确定创作主题并深度搜索

**重要**：无论用户是否提供话题，都必须先进行深度搜索，确保内容的准确性和时效性。

1.1 话题确定

• **用户提供话题**：使用用户提供的话题
• **用户未提供话题**：搜索当日最新的 AI 资讯或热门话题作为创作素材

1.2 深度搜索（必须执行）

使用 WebSearch 工具对话题进行深度搜索：

**搜索要求**：

• 搜索至少 2-3 个相关关键词
• 获取最新的数据、案例、用户反馈（确保信息来自最新年份（如2026年）
• 了解话题的热度和讨论方向
• 确保内容符合主题并有深度

**示例搜索关键词**：

• 话题"AI工具"：
• "2026最新AI工具推荐"
• "AI工具使用教程案例"
• "AI工具效率提升数据"
• 话题"工作效率"：
• "提高工作效率方法2026"
• "效率工具推荐使用体验"
• "时间管理技巧实战"

**搜索输出**：

🔍 正在深度搜索话题: [话题名称]

搜索关键词 1: [关键词]
- 找到 X 个相关结果
- 关键信息: [摘要]

搜索关键词 2: [关键词]
- 找到 X 个相关结果
- 关键信息: [摘要]

✅ 搜索完成，已获取充足素材

第二步：生成帖子内容

参考 [references/style-guide.md](references/style-guide.md) 了解小红书内容风格规范。

标题要求

• **字数限制**：不超过20个字
• **可以使用emoji**：适当添加1-2个emoji增加吸引力
• **钩子设计**：标题必须包含钩子元素，激发用户好奇心

**标题钩子类型**：

• 数字型：「3个方法」「5分钟学会」
• 疑问型：「为什么...」「你知道吗」
• 利益型：「省钱」「变美」「提效」
• 悬念型：「没想到...」「竟然...」
• 共鸣型：「终于找到了」「后悔没早知道」

正文要求

• **语言**：使用中文（技术专有名词可保留英文）
• **字数要求**：正文内容必须在 **300-500字** 之间，内容要充实有料
• **结构**：开头钩子 → 核心内容（详细展开）→ 总结/互动
• **段落**：每段2-4行，善用分段和空行
• **符号**：适当使用分隔符增强阅读体验
• **素材来源**：基于深度搜索结果，整合最新信息和案例

**正文钩子段示例**：

姐妹们！这个方法我藏了好久了...
不敢相信，我居然现在才发现这个...
分享一个让我效率翻倍的小技巧...

**正文内容展开要求**：

• 每个要点要有详细说明，不能只是一句话带过
• 加入个人使用体验和感受（可以基于搜索到的用户反馈改写）
• 提供具体的使用场景和案例（使用搜索到的真实案例）
• 适当加入对比（使用前 vs 使用后）
• 引用搜索到的数据增加可信度

**内容输出格式**：

## 标题
[生成的标题，包含emoji]

## 正文
[开头钩子段 - 引发共鸣，30-50字]

[核心内容 - 详细展开每个要点，200-350字]
- 使用搜索到的数据和案例
- 加入具体使用场景
- 提供对比和体验

[总结段 - 归纳重点，30-50字]

[互动引导 - 引导评论收藏，20-30字]

## 标签
#标签1 #标签2 #标签3 #标签4 #标签5 #标签6 #标签7 #标签8

第三步：生成配图（PNG/JPG 格式）

**重要变更**：不再使用 HTML 格式，直接生成 PNG/JPG 图片。

图片生成流程

1. **先生成 HTML 模板**（临时文件）：使用 Newsprint 风格创建卡片 2. **转换为 PNG**：使用 Chrome headless 模式截图 3. **删除临时 HTML**：只保留 PNG 文件

图片要求

• **数量**：生成 **1张** 主图配图即可（不再需要多张裁剪）
• **格式**：PNG 或 JPG（推荐 PNG）
• **尺寸**：**9:16 竖版比例**（小红书标准竖版比例）
• 尺寸：1080x1920 px
• 比例：9:16（小红书最佳展示比例）
• 直接按原尺寸生成，不做缩放或裁剪
• **内容对应**：图片内容需要概括文章的核心要点
• **风格要求**：
• **重要**：每张图片根据内容各自设计，不要所有图片风格都一样
• 可以使用不同的布局、配色、字体组合
• 减少AI感，追求自然、真实的视觉效果
• 配色自然和谐，不要过于饱和
• 可参考 Newsprint 报纸风格，但不限于此风格
• **文字**：
• 图片中如需文字，**必须使用中文**
• 字体清晰易读，**绝对不允许出现乱码**
• 使用高清渲染确保文字显示清晰
• **安全**：使用合规、保险的元素，避免敏感内容

配图类型规划

只生成 **1张主图**，不再需要多张裁剪：

| 图片序号 | 文件名 | 图片类型 | 内容说明 | |---------|--------|---------|---------| | 第1张 | cover.png | 主图 | 9:16 竖版主图，包含标题和核心内容，吸引点击 |

**注意**：

• 只生成一张 9:16 的高清主图即可
• 图片尺寸：1080x1920 px（直接生成，不做缩放）
• 图片风格根据内容自行设计，可以多样化
• 确保文字清晰，无乱码
• 在 HTML 设计时，卡片尺寸直接设置为 1080x1920px

设计系统参考

**重要**：图片风格不需要统一，可以根据内容各自设计。

**可选设计风格**： 1. **Newsprint 报纸风格**（参考 [assets/image-templates.html](assets/image-templates.html)）

• 致敬印刷报纸的黄金时代
• 高对比度排版、网格布局
• 适合严肃、专业的内容

2. **现代简约风格**

• 大量留白，简洁排版
• 柔和配色，圆角设计
• 适合轻松、友好的内容

3. **杂志封面风格**

• 大标题，醒目视觉
• 多彩配色，吸引眼球
• 适合推荐、盘点类内容

4. **卡片堆叠风格**

• 多层卡片，信息丰富
• 清晰层次，易于阅读
• 适合教程、步骤类内容

**设计原则**（所有风格通用）：

• 文字必须清晰，使用中文，绝对不允许乱码
• 内容丰富但不拥挤，留有呼吸空间
• 配色自然和谐，符合主题
• 突出核心信息，次要信息可适当弱化

**Design Tokens（设计变量）**：

--background: #F9F9F7;  /* 报纸米白色 */
--foreground: #111111;  /* 墨黑色 */
--muted: #E5E5E0;       /* 分隔灰 */
--accent: #CC0000;      /* 编辑红（仅用于强调） */

**字体系统**：

• **标题**：`Noto Serif SC`（中文衬线，粗体，大字号）
• **正文**：`Noto Sans SC`（中文无衬线）
• **UI/标签**：`Inter`（英文无衬线，大写，字母间距加宽）
• **数据/日期**：`JetBrains Mono`（等宽字体）

**核心设计规则**： 1. **零圆角**：所有元素必须使用 `border-radius: 0` 2. **高对比度**：黑白为主，红色仅作点缀 3. **可见网格**：使用边框分隔，模拟报纸栏目 4. **大写标签**：`text-transform: uppercase; letter-spacing: 0.15em` 5. **点状背景纹理**：模拟报纸印刷效果 6. **悬停效果**：颜色反转（黑变白，白变黑） 7. **灰度图片**：图片默认灰度处理

HTML 转 PNG 的执行步骤

**步骤 1**：创建临时 HTML 文件

# 创建临时目录
mkdir -p ./redbook-article/[主题]-[日期]/temp/

# 使用 Write 工具生成 HTML 文件
# 文件: ./redbook-article/[主题]-[日期]/temp/cover.html

**步骤 2**：使用 Python 脚本转换为 PNG

python3 /Users/a58/.claude/skills/redbook-creator-publish/scripts/html_to_image.py \
  ./redbook-article/[主题]-[日期]/temp/ \
  --output ./redbook-article/[主题]-[日期]/images/

**步骤 3**：清理临时文件

rm -rf ./redbook-article/[主题]-[日期]/temp/

**输出日志示例**：

🎨 生成配图...

📝 创建临时 HTML 模板...
  ✅ cover.html
  ✅ content-1.html
  ✅ content-2.html
  ✅ summary.html

🖼️  转换为 PNG 图片...
使用 Chrome: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

转换: cover.html -> cover.png ... ✅
转换: content-1.html -> content-1.png ... ✅
转换: content-2.html -> content-2.png ... ✅
转换: summary.html -> summary.png ... ✅

完成: 4/4 个文件转换成功

🗑️  清理临时文件...
✅ 配图生成完成！

第四步：生成本地文件

在用户当前工作目录下创建