步骤	操作	阻塞?
1	填写标题、正文、标签、上传封面	❌
2	截图发送到群	⚠️ 必须
3	等待用户确认	✅ 阻塞
4	收到"发布"→点击发布	❌
4	收到"存草稿"→点击暂存	❌

用户指令：

发布 / 确认发布 → 执行发布
存草稿 / 暂存 → 保存到草稿箱

排版规则

项	规则
标题	≤20字，emoji+关键词+数字，公式：人群+关键词+数字+悬念+emoji
正文	300-1000字，双换行分段，每段1-2个emoji开头，前3行放核心
标签	#话题名(无空格) 3-8个，精准在前泛话题在后
封面	3:4竖版(1080×1440)，大字+对比色+人物/产品占60%+
图片	1-18张，JPG/PNG，≤20MB/张
最佳时间	工作日18-22点，周末20-23点

内容适配模板

将任意内容转化为小红书格式时：

标题：提炼核心卖点，套用公式 人群定位+关键词+数字+悬念词+emoji
- 例：打工人必看🔥5个效率工具让你准时下班

正文排版：

emoji 开头金句/痛点（抓注意力）

emoji 正文第一段（核心信息，≤3行）

emoji 正文第二段（展开论述）

emoji 正文第三段（补充/案例）

emoji 总结/互动引导（提问/投票）

#精准话题1 #精准话题2 #泛话题3 #泛话题4

emoji策略：每段开头1个，正文中关键词旁适度点缀，不超过正文的5%
标签策略：2个精准话题(搜索量高) + 2-4个泛话题(曝光量大) + 1-2个长尾话题

发布流程（Browser工具操作）

通用流程

Step 0: 确认发布内容类型

视频 → 走视频发布流程
图文 → 走图文发布流程
长文 → 走长文发布流程

📷 图文发布流程（7步）

Step 1: 打开发布页面

browser(action="navigate", profile="openclaw", 
       targetUrl="https://creator.xiaohongshu.com/publish/publish?source=official&target=image")

Step 2: 确认发布类型

点击「上传图文」

Step 3: 上传封面图片

点击上传按钮或 input[type='file'] 上传封面图
等待图片加载完成

Step 4: 填写标题

⚠️ 定位标题输入框：placeholder="填写标题会有更多赞哦"
使用 JavaScript 精确填充（防止UI错位）：

// 找到标题输入框并设置值
const titleInput = document.querySelector('input[placeholder*="标题"]');
if(titleInput) {
  titleInput.value = '标题内容（≤20字）';
  titleInput.dispatchEvent(new Event('input', {bubbles: true}));
}

Step 5: 填写正文（⚠️ 最关键一步）

先点击正文编辑器获取焦点：

browser(action="act", kind="click", ref="<正文框ref>")

等待 500ms 让 Tiptap/ProseMirror 编辑器初始化
使用 Tiptap/ProseMirror API 填写正文：

// 将 Markdown 转换为 HTML
const text = `要粘贴的正文内容`;
const paragraphs = text.split('\n').filter(p => p.trim());
const htmlParts = paragraphs.map(p => {
    // 处理 **粗体**
    p = p.replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>');
    return '<p>' + p + '</p>';
});
const html = htmlParts.join('');

// 写入编辑器
const editor = document.querySelector('.tiptap.ProseMirror');
if (editor) {
    editor.focus();
    editor.innerHTML = html;
    editor.dispatchEvent(new Event('input', {bubbles: true}));
}

验证：正文框字数统计应显示 X/1000（X>0），如果仍显示 0/1000，尝试方案B/C/D（见"UI问题与解决方案"）
⚠️ 如果使用 browser evaluate，fn 中不能有 await，用 setTimeout 包裹：new Promise(r=>setTimeout(r,500)).then(()=>{...})

Step 6: 检查排版

⚠️ 必须先验证正文已写入：正文框字数应 > 0
截图确认格式
确认标题框内只有标题（≤20字），字数 X/20
确认正文框内有完整正文，字数 X/1000
如正文 0/1000 → 正文未写入 → 回到 Step 5 尝试其他方案
如有排版问题，手动调整

Step 7: 🔍 截图确认（必须步骤）

⚠️ 在点击发布/保存草稿之前，必须执行此步骤

使用 browser 截图当前页面内容：

browser(action="screenshot", target="host")

将截图发送到群中汇报：

message(action="send", channel="telegram", target="-1003890797239", 
       message="📝 小红书内容已填写完毕，请确认后回复'发布'或'存草稿'",
       accountId="xiaocode")

必须等待用户确认后才能继续（不自动发布）

Step 8: ⏳ 等待用户确认

用户回复以下指令之一：
- 发布 / 确认发布 → 执行发布
- 存草稿 / 暂存 → 保存到草稿箱
- 修改 / 取消 → 停止流程，等待重新触发
⚠️ 此步骤是阻塞的，在收到明确指令前不执行任何操作

Step 9: ✅ 执行发布/存草稿

根据用户确认选择：

发布模式：

点击「发布」按钮
等待发布成功提示
截图确认发布结果
发送完成通知到群

草稿模式：

点击「暂存离开」按钮
确认草稿保存成功
发送完成通知到群

📝 长文发布流程（6步）

相比图文，少去上传图片封面步骤

Step 1: 打开发布页面

URL: https://creator.xiaohongshu.com/publish/publish?source=official

Step 2: 确认发布类型

点击「写长文」

Step 3: 填写标题

同图文 Step 4

Step 4: 填写正文

同图文 Step 5

Step 5: 🔍 截图确认（必须步骤）

同图文 Step 7：必须先截图发送到群等待确认

Step 6: ⏳ 等待用户确认

同图文 Step 8：等待用户回复「发布」或「存草稿」

Step 7: ✅ 执行发布/存草稿

同图文 Step 9

🎬 视频发布流程（3步）

Step 1: 上传视频

点击「上传视频」
选择视频文件上传

Step 2: 🔍 截图确认（必须步骤）

填写标题、描述等内容后
执行 browser(action="screenshot", target="host") 截图
发送到群中等待确认
⚠️ 必须等待用户确认后才能发布

Step 3: ⏳ 等待用户确认

同图文 Step 8

Step 4: ✅ 执行发布

用户确认后点击「发布」

自动化脚本用法

python scripts/xhs_publish.py \
  --title "标题文字" \
  --content "正文内容" \
  --tags "话题1,话题2,话题3" \
  --image "/path/to/cover.jpg" \
  --mode draft \
  --auto-login

参数说明：

--auto-login: 自动连接 openclaw 浏览器获取登录态
--mode draft: 保存到草稿箱（默认）
--mode publish: 直接发布

浏览器自动化注意事项

已登录态获取

使用 openclaw 浏览器 profile="openclaw"，通过 CDP 连接 (http://127.0.0.1:18800) 自动复用登录态。

UI 问题与解决方案

❌ 问题1：正文框 0/1000 写不进去（已确认 2026-03-20）

现象：标题正确（8字），但正文框显示 0/1000，browser 的 fill/type 均无法写入内容。

根因：小红书创作者平台已从 Quill.js 迁移到 Tiptap/ProseMirror（class=tiptap.ProseMirror）。普通 DOM 操作（设置 innerText/value）不触发 React 状态更新，导致：

内容虽然视觉上出现，但 Tiptap 内部状态为空
字数统计不变（0/1000）
保存草稿后正文丢失

✅ 解决方案（推荐方案）：

方案A：Tiptap/ProseMirror API 直接写入（推荐）

// 将 Markdown 转换为 HTML 段落
const text = '要粘贴的正文内容\n第二段内容';
const paragraphs = text.split('\n').filter(p => p.trim());
const htmlParts = paragraphs.map(p => {
    // 处理 **粗体**
    p = p.replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>');
    return '<p>' + p + '</p>';
});
const html = htmlParts.join('');

// 写入 Tiptap 编辑器
const editor = document.querySelector('.tiptap.ProseMirror');
if (editor) {
    editor.focus();
    editor.innerHTML = html;
    editor.dispatchEvent(new Event('input', {bubbles: true}));
}

方案B：Clipboard API 模拟粘贴（备选）

// 先点击正文编辑器获取焦点
document.querySelector('.tiptap.ProseMirror')?.click();
// 等待 300ms 让编辑器初始化
await new Promise(r => setTimeout(r, 300));
// 使用 Clipboard API 粘贴
const text = '要粘贴的正文内容';
const clipboardData = new DataTransfer();
clipboardData.setData('text/plain', text);
const pasteEvent = new ClipboardEvent('paste', {
  clipboardData: clipboardData,
  bubbles: true,
  cancelable: true
});
document.querySelector('.tiptap.ProseMirror')?.dispatchEvent(pasteEvent);

方案C：executeCommand（兼容方案）

document.querySelector('.tiptap.ProseMirror')?.focus();
document.execCommand('selectAll');
document.execCommand('insertText', false, '正文内容');

验证标准：写入后正文框字数统计应显示 X/1000（X>0）。

❌ 问题2：标题和正文内容混串

现象：标题输入框显示字符计数如 "510/20"，内容被粘贴到了标题位置。

根因：编辑器 UI 的 contenteditable 字段定位错误。

解决：

先填标题：使用 input[placeholder*="标题"] 定位
再点击正文框：点击 .ql-editor 后等待 500ms
最后填正文：使用方案A粘贴
验证标题框字数 ≤ 20，正文框字数 > 0

手动修正流程（最终兜底）

打开草稿箱
点击"编辑"进入文章
手动复制正文到正确位置，修正标题
点击发布

错误处理

错误	处理
登录过期	提示用户重新扫码，保存新cookie
滑块验证	暂停等待手动完成，设置 `--headless false`
标题超长	自动截断到20字并警告
图片上传失败	重试3次，每次间隔5秒
网络超时	重试3次，指数退避(5s/15s/45s)
发布频率限制	等待60秒后重试
内容混入标题	保存草稿后手动修正

发布前检查清单

标题 ≤20字，含emoji和关键词
正文 ≥100字（新规要求）
标签 3-8个，#格式
封面图 3:4竖版
无其他平台水印
非AI搬运内容（原创要求）

文件结构

xhs-smart-publisher/
├── SKILL.md
├── scripts/
│   └── xhs_publish.py        # Playwright 自动发布脚本
├── references/
│   └── platform-rules.md     # 完整平台规则（从调研文档提取）
└── templates/
    └── content-template.md   # 排版模板示例

xhs-smart-publisher

小红书智能发布

⚡ 快速工作流