Xiaolvs Publish

小绿书发布

概述

将已生成的信息图 + 文案自动发布到小红书和微信公众号平台，默认创建草稿供用户检查后手动发布。

CDP 模式（推荐，必须使用）

必须使用 --cdp 模式，通过 Chrome DevTools Protocol 连接用户真实 Chrome 浏览器，绕过平台的自动化检测。不走 CDP 的 Playwright 模式极易被平台检测为自动化操作导致封号。

CDP Chrome 启动方式（使用独立 profile 目录）：

# ⚠️ macOS Chrome 不支持在默认 user-data-dir 上开 CDP
# 必须指定独立 --user-data-dir
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
    --remote-debugging-port=9222 \
    --user-data-dir="$HOME/.config/google-chrome-cdp" &

⚠️ 关键限制：macOS Chrome 在默认 data directory 上启动 CDP 会报错 DevTools remote debugging requires a non-default data directory。必须使用独立 profile 目录 ~/.config/google-chrome-cdp。

CDP 登录态管理

1. 首次使用：启动 CDP Chrome 后需要手动登录小红书和微信公众号（扫码）
2. 登录态持久化：登录后 session 保存在 ~/.config/google-chrome-cdp/ 中，后续无需重新登录
3. 发布前必须检查登录态：执行发布脚本前，先用 Playwright 连接 CDP 打开目标平台页面，检查是否跳转到 login 页。如果未登录，等待用户扫码登录完成后再执行发布脚本
4. 检查登录态的代码模式：

# 在执行发布前先确认登录态
async with async_playwright() as p:
    browser = await p.chromium.connect_over_cdp('http://localhost:9222')
    context = browser.contexts[0]
    page = await context.new_page()
    await page.goto('https://creator.xiaohongshu.com/publish/publish')
    # 等待最多120秒直到不再是登录页面
    for i in range(60):
        await asyncio.sleep(2)
        if 'login' not in page.url.lower() and 'passport' not in page.url.lower():
            print('登录确认成功')
            break

5. 脚本检测到未登录时不应直接退出：应打开登录页面并等待用户扫码，而非打印错误直接退出。如果当前脚本实现是直接退出的，需要在执行脚本前手动完成登录检查

前置条件

本 skill 假设以下文件已存在于项目子目录：

• infographic.png + chart_1~N.png — 信息图图片
• copywriting.txt — 公众号文案（标题 + 正文 + 标签）

如果尚未生成，请先使用 xiaolvs-image-gen skill。

平台 1：小红书发布

1.1 首次登录

python scripts/xhs_publish.py login

在弹出的浏览器中扫码登录小红书创作者平台，session 自动保存到 ~/.xiaohongshu/storage_state.json。

1.2 检查登录状态

python scripts/xhs_publish.py check

1.3 发布

⚠️ 必须使用 --copywriting 模式（推荐），禁止手动创建 JSON 配置文件。

copywriting.txt 中的正文常包含中文引号 "" 等特殊字符，手动构建 JSON 会导致引号转义失败（json.decoder.JSONDecodeError）。--copywriting 模式直接从纯文本文件读取，自动提取标题/正文/标签，彻底规避此问题。

# 推荐：--copywriting 模式（直接读取 copywriting.txt，自动提取标题/正文/标签，保留所有 emoji）
python scripts/xhs_publish_playwright.py publish \
    --copywriting <项目子目录>/copywriting.txt \
    --images <项目子目录>/infographic.png <项目子目录>/chart_1.png <项目子目录>/chart_2.png <项目子目录>/chart_3.png <项目子目录>/chart_4.png \
    --collection "AI产品经理" \
    --auto

⚠️ 外部链接自动过滤：脚本内置 _strip_urls() 函数，自动从正文中移除所有 http:// 和 https:// 链接及纯链接行。

copywriting.txt 解析规则：

• 标题：第 1 行（保留 emoji，不超过 20 字）
• 正文：第 2 行起到标签行之前
• 标签：最后一行（#标签1 #标签2 格式，自动去掉 # 号）

python scripts/xhs_publish_playwright.py publish --config <项目子目录>/xhs_publish_config.json --auto

⚠️ 使用 --config 模式时，正文中的中文引号 ""、'' 等特殊字符必须正确转义，否则会导致 JSON 解析失败。强烈建议使用 --copywriting 模式替代。

⚠️ 发布前必须等待用户确认。 无论是否使用 --auto，脚本在填写完所有字段后都会在浏览器顶部注入一个红色确认提示条（包含「取消」和「确认发布 ✓」按钮），等待用户在浏览器中检查内容无误后点击「确认发布」，才会执行发布按钮。最长等待 30 分钟。 ⚠️ 标题和正文必须保留 emoji。 从 copywriting.txt 提取标题和正文时，不要去除 emoji 符号（如 ⚡📌📊💡1️⃣2️⃣3️⃣ 等），它们是内容格式的一部分。 ⚠️ 外部链接自动过滤：脚本内置 _strip_urls() 函数，自动从正文中移除所有 http:// 和 https:// 链接。

发布流程：打开创作者平台 → JS click 切换图文 tab → 上传图片 → 填标题 → 填正文（保留 emoji，自动过滤外链）→ 添加话题 → 勾选原创声明 → 选择合集 → 勾选定时发布 → 浏览器顶部显示确认提示条，等待用户点击「确认发布」后执行发布 → 发布成功后自动截图并关闭浏览器。

平台 2：微信公众号发布

2.1 首次登录

python scripts/wechat_mp_publish.py login

在弹出的浏览器中扫码登录微信公众号后台，session 保存到 ~/.wechat_mp/storage_state.json。

2.2 检查登录状态

python scripts/wechat_mp_publish.py check

2.3 准备发布配置

支持两种模式：

方式 A：--copywriting 模式（推荐），直接从 copywriting.txt 自动提取标题和完整描述（保留所有 emoji）：

python scripts/wechat_mp_publish_playwright.py publish \
    --copywriting <项目子目录>/copywriting.txt \
    --images <项目子目录>/infographic.png <项目子目录>/chart_1.png <项目子目录>/chart_2.png <项目子目录>/chart_3.png <项目子目录>/chart_4.png \
    --collection AI前沿 \
    --auto

方式 B：--config 模式，使用 wechat_publish_config.json 配置（必须设置 copywriting_file 以确保描述内容完整）：

python scripts/wechat_mp_publish_playwright.py publish \
    --config <项目子目录>/wechat_publish_config.json \
    --auto

config 文件示例：

{
    "title": "⚡ AI已来，只是分布不均",
    "images": ["infographic.png", "chart_1.png", "chart_2.png", "chart_3.png", "chart_4.png"],
    "tags": ["AI趋势", "科技前沿"],
    "collection": "AI前沿",
    "copywriting_file": "copywriting.txt"
}

⚠️ 使用 --config 模式时，必须设置 copywriting_file 字段，指向 copywriting.txt 文件。脚本会从中读取完整的正文内容作为描述，确保不会遗漏内容。如果同时存在 description 字段和 copywriting_file，以 copywriting_file 为准。 ⚠️ 默认一律使用 --auto 创建草稿。 除非用户明确说「发布到线上」，否则不要直接发表。 ⚠️ 必须使用 --collection 参数或 config 中的 collection 字段指定合集。 ⚠️ 标题中的 emoji 必须保留，不要在配置或代码中去除标题开头的 emoji 符号。

图片顺序：infographic.png 必须排第一位（总览图在最前），后接 chart_1~N。 标题截断：微信公众号贴图标题限 20 字，超出自动截断。

2.4 发布流程（三阶段分步执行）

脚本采用三阶段分步执行架构，确保图片上传的可靠性：

Phase 1 — 导航：导航到微信公众号后台贴图编辑器（提取 token 构建编辑 URL）。

Phase 2 — 逐张图片上传：

• 每张图片由 Playwright 逐张上传，程序化控制顺序。
• 必须使用 file_inputs[1]（[0] 是菜单 input 无效）。每次上传前必须重新查询 DOM 获取最新 file input。
• 每张上传完成后固定等待确保处理完毕。
• 图片计数通过 mmbiz 缩略图元素 的 getBoundingClientRect() 尺寸过滤（20-200px），不使用页面 N/M 文本匹配（会误匹配表单字数计数器 0/20）。

Phase 3 — 填写与保存：

• 标题：通过 div.ProseMirror[data-placeholder="请在这里输入标题"] 精确定位（contenteditable div，非 textarea），使用 keyboard.type() 输入后按 Escape 移出焦点。
• 描述：遍历所有可见 ProseMirror contenteditable div，排除含"标题"的 data-placeholder，定位到描述区域。使用合成 ClipboardEvent('paste') + text/plain 输入内容，空行用 \u200B 零宽空格占位。
• 合集：通过 #js_article_tags_area 定位。
• 保存草稿：保存后最多等待 30 秒验证成功（检测 toast 提示、URL 跳转、确认对话框）。

2.5 保存后确认与浏览器关闭

• --auto 模式下草稿保存成功后自动等待 5 秒确保保存请求完成，不依赖 stdin input()（避免非交互终端 EOFError 导致浏览器提前关闭）。
• 非 auto 模式下浏览器保持打开，终端提示用户确认后关闭。
• finally 块确保异常时浏览器进程会被杀掉。

脚本文件

常见问题

关键发布规则

1. 小红书必须使用 --copywriting 模式，禁止创建 JSON 配置文件：copywriting.txt 正文中常含中文引号 ""、'' 等特殊字符，手动构建 xhs_publish_config.json 反复导致 json.decoder.JSONDecodeError。--copywriting 模式直接读取纯文本，自动提取标题/正文/标签，彻底规避此问题
2. 小红书发布前必须等待用户确认：无论是否使用 --auto，脚本填写完所有字段后会在浏览器顶部注入红色确认提示条（不遮挡页面内容），用户在浏览器中点击「确认发布 ✓」后才会执行发布。使用浏览器内 UI 确认而非 stdin input()，确保在非交互终端环境中也能正常工作
3. 标题和正文保留所有 emoji：从 copywriting.txt 提取时不要去除任何 emoji（包括 ⚡📌📊💡1️⃣2️⃣3️⃣🔄 等）
4. 微信公众号 config 必须设置 copywriting_file：确保描述内容完整，不要手动摘要
5. 微信公众号图片始终使用 file_inputs[1]：[0] 是菜单 input（无效），[1] 是编辑器 input（有效），每次上传前必须重新查询 DOM
6. 微信公众号标题通过 ProseMirror 定位：标题是 div.ProseMirror[data-placeholder="请在这里输入标题"]（contenteditable div，非 textarea），使用 keyboard.type() 输入，不能用 fill()。输入后按 Escape 移出焦点，防止描述误填到标题区
7. 微信公众号描述使用合成 paste 事件：ProseMirror 拦截键盘事件，唯一可靠方案是 ClipboardEvent('paste') + text/plain；空行用 \u200B 零宽空格占位。描述区域通过遍历所有 ProseMirror 并排除含"标题"的 placeholder 定位
8. 微信公众号图片计数禁用 N/M 文本匹配：页面上的 0/20、0/8、0/120 是表单字数计数器（<em class="frm_counter">），不是图片计数。必须通过 mmbiz 缩略图元素 + getBoundingClientRect() 尺寸过滤来计数
9. 微信公众号 auto 模式不依赖 stdin：--auto 模式保存草稿后自动等待 5 秒确认保存完成，不调用 input()，避免非交互终端 EOFError 导致浏览器提前关闭
10. content/description 必须与 copywriting.txt 一致：不要自行编辑、删减或重写 copywriting 中的内容