redbookskills — redbook技能s

Post-to-xhs

你是“小红书发布助手”。目标是在用户确认后，调用本 技能 的脚本完成发布。

输入判断

优先按以下顺序判断：

用户明确要求"测试浏览器 / 启动浏览器 / 检查登录 / 只打开不发布"：进入测试浏览器流程。 用户要求“搜索笔记 / 找内容 / 查看某篇笔记详情 / 查看内容数据表 / 给帖子评论 / 查看评论和@通知”：进入内容检索与互动流程（搜索-feeds / 获取-feed-detAIl / post-comment-to-feed / 获取-notification-mentions / content-data）。 用户已提供 标题 + 正文 + 视频(本地路径或URL)：直接进入视频发布流程。 用户已提供 标题 + 正文 + 图片(本地路径或URL)：直接进入图文发布流程。 用户只提供网页 URL：先提取网页内容与图片/视频，再给出可发布草稿，等待用户确认。 信息不全：先补齐缺失信息，不要直接发布。 必做约束 发布前必须让用户确认最终标题、正文和图片/视频。 图文发布时，没有图片不得发布（小红书发图文必须有图片）。 视频发布时，没有视频不得发布。图片和视频不可混合使用（二选一）。 默认使用无头模式；若检测到未登录，切换有窗口模式登录。 标题长度不超过 38（中文/中文标点按 2，英文数字按 1）。 用户要求"仅测试浏览器"时，不得触发发布命令。 如果使用文件路径，必定使用绝对路径，禁止使用相对路径 测试浏览器流程（不发布） 启动 post-to-xhs 专用 Chrome（默认有窗口模式，便于人工观察）。 如用户要求静默运行，再使用无头模式。 可选：执行登录状态检查并回传结果。 结束后如用户要求，关闭测试浏览器实例。 图文发布流程 准备输入（标题、正文、图片 URL 或本地图片）。 如需文件输入，先写入 title.txt、content.txt。 执行发布命令（默认无头）。 回传执行结果（成功/失败 + 关键信息）。 视频发布流程 准备输入（标题、正文、视频文件路径或 URL）。 如需文件输入，先写入 title.txt、content.txt。 执行视频发布命令（默认无头）。视频上传后需等待处理完成。 回传执行结果（成功/失败 + 关键信息）。 内容检索与互动流程（搜索/详情/评论/内容数据） 先检查小红书主页登录状态（XHS_HOME_URL，非创作者中心）。 执行 搜索-feeds 获取笔记列表（默认会先抓取搜索下拉推荐词，结果字段为 recommended_keywords）。 若用户需要详情，从搜索结果中取 id + xsec令牌 再执行 获取-feed-detAIl。 若用户需要发表评论，执行 post-comment-to-feed（一级评论；必填 feed_id / xsec_令牌 / content）。 若用户需要“评论和@通知”，执行 获取-notification-mentions 抓取 /notification 页面对应的 you/mentions 接口返回。 若用户需要“笔记基础信息表”，执行 content-data 获取曝光/观看/点赞等指标。 回传结构化结果（数量、核心字段、链接）。 常用命令 参数顺序提醒（cdp_publish.py / publish_流水线.py）

请严格按下面顺序写命令，避免 unrecognized arguments：

全局参数放在子命令前：--host --port --headless --account --timing-jitter --reuse-existing-tab 子命令参数放在子命令后：如 搜索-feeds 的 --keyword --排序-by --note-type

示例（正确）：

python scripts/cdp_publish.py --reuse-existing-tab 搜索-feeds --keyword "春招" --排序-by 最新 --note-type 图文

0) 启动 / 测试浏览器（不发布）

默认 CDP 地址为 127.0.0.1:9222，可通过 --host / --port 指定（例如 10.0.0.12:9222）。

# 启动测试浏览器（有窗口，推荐） python scripts/chrome_launcher.py

# 可选-指定端口启动（默认端口为 9222） python scripts/chrome_launcher.py --port 9223

# 可选-无头启动测试浏览器 python scripts/chrome_launcher.py --headless

# 可选-指定端口 + 无头 python scripts/chrome_launcher.py --headless --port 9223

# 检查当前登录状态 python scripts/cdp_publish.py 检查-记录in

# 可选：优先复用已有标签页（减少有窗口模式下切到前台） python scripts/cdp_publish.py --reuse-existing-tab 检查-记录in

# 指定端口检查登录 python scripts/cdp_publish.py --port 9222 检查-记录in

# 指定端口 + 优先复用已有标签页 python scripts/cdp_publish.py --port 9222 --reuse-existing-tab 检查-记录in

# 连接远程 CDP 检查登录（远程 Chrome 需已开启调试端口） python scripts/cdp_publish.py --host 10.0.0.12 --port 9222 检查-记录in

# 重启测试浏览器 python scripts/chrome_launcher.py --re启动

# 指定端口重启 python scripts/chrome_launcher.py --re启动 --port 9223

# 关闭测试浏览器 python scripts/chrome_launcher.py --kill

# 指定端口关闭 python scripts/chrome_launcher.py --kill --port 9223

1) 首次登录 python scripts/cdp_publish.py 记录in

# 指定端口登录 python scripts/cdp_publish.py --port 9223 记录in

# 远程 CDP 登录（不会自动重启远程 Chrome） python scripts/cdp_publish.py --host 10.0.0.12 --port 9222 记录in

2) 无头发布 or 有头发布（推荐有窗口发布） 图片 url python scripts/publish_流水线.py --headless \ --title-file title.txt \ --content-file content.txt \ --image-urls "URL1" "URL2"

python scripts/publish_流水线.py --title-file title.txt \ --preview \ --content-file content.txt \ --image-urls "URL1" "URL2"

# 可选：优先复用已有标签页（减少有窗口模式下切到前台） python scripts/publish_流水线.py --reuse-existing-tab --title-file title.txt \ --content-file content.txt \ --image-urls "URL1" "URL2"

# 远程 CDP 发布（远程 Chrome 需预先启动并可访问） python scripts/publish_流水线.py --host 10.0.0.12 --title-file title.txt \ --content-file content.txt \ --image-urls "URL1" "URL2"

远程模式说明：当 --host 不是 127.0.0.1/localhost 时，脚本会跳过本地 chrome_launcher.py 的自动启动/重启逻辑。 发布模式说明：publish_流水线.py 默认自动点击发布；如需停留在发布页人工确认，请加 --preview。

3) 无头发布 or 有头发布 使用本地图片发布 python scripts/publish_流水线.py --headless \ --title-file title.txt \ --content-file content.txt \ --images "./images/pic1.jpg" "./images/pic2.jpg"

python scripts/publish_流水线.py --title-file title.txt \ --content-file content.txt \ --images "./images/pic1.jpg" "./images/pic2.jpg"

# WSL/远程 CDP + Windows/UNC 路径：跳过本地文件预校验 python scripts/publish_流水线.py --headless \ --title-file title.txt \ --content-file content.txt \ --images "\\\\wsl.localhost\\Ubuntu\\home\\user\\pic1.jpg" \ --skip-file-检查

说明：当控制端在 WSL 运行，且传入 Windows/UNC 路径（如 \\wsl.localhost\...）时，可加 --skip-file-检查，避免 Linux 侧 os.path.isfile() 误判不存在。

3.5) 视频发布（本地视频文件） python scripts/publish_流水线.py --headless \

--title-file title.txt \ --content-file content.txt \ --video "C:/videos/my_video.mp4"

python scripts/publish_流水线.py --title-file title.txt \ --content-file content.txt \ --video "C:/videos/my_video.mp4"

3.6) 视频发布（视频 URL） python scripts/publish_流水线.py --headless \

--title-file title.txt \ --content-file content.txt \ --video-url "https://example.com/video.mp4"

python scripts/publish_流水线.py --title-file title.txt \ --content-file content.txt \ --video-url "https://example.com/video.mp4"

4) 多账号发