skill-xhs-publisher · 小红书发布
小红书发布 skill：Playwright + 持久化登录态驱动创作者后台，headless 完成图文/视频发布。
流程：check 验环境 → login 扫码 → plan 预检确认 → publish --exec 执行。发布前须经用户确认；标题 ≤ 20 全角字。
调用示例：在聊天框中说"把这组图发到小红书，标题是秋日露营清单"（附上图片）。
产品详解
定位
skill-xhs-publisher 是小红书的专用发布执行器：用 Playwright + 持久化登录态驱动创作者后台，headless 完成图文/视频发布。它只做"发出去"这件事，不做内容分析、不做评论区互动。
核心能力
- 图文/视频发布：统一走共享脚本
xhs_publish.py；图文发布必须有图片，视频发布必须有视频，两者不可混用。 - 扫码登录：
login把二维码抠成 PNG 供扫码，登录态持久化，一次登录长期复用。 - 发布前预检：
plan做 dry-run 预检（标题长度/媒体路径/步骤），展示给用户确认最终标题、正文、图片/视频。 - 成功校验：脚本内置发布成功判定（URL 离开 /publish/publish 才算成功），上传完成有等待机制。
- 反检测：禁用 AutomationControlled 特征 + 逐字符输入 + zh-CN 语言 + 登录态持久化；但自动化发布仍存在被平台风控、限流、封号的风险。
- 发布后留痕：人设评分与发布记录自动落入 skill-publish-log，供监控与归因。
工作流程
check：验环境（playwright + chromium 内核）- 未登录 →
login有头扫码（一次即可） plan：dry-run 预检，给用户确认最终标题、正文、媒体- 发布前人设检查（有 Profile 时；低于 80 分告知偏离点，不阻断）
publish / publish-video --exec执行（首次建议--headed校验选择器，通过后再 headless）- 成功校验 → 发布后留痕（persona 记录 + publish-log）
输入与输出
| 输入 | 说明 |
|---|---|
| 标题 + 图片 | 图文发布（标题 ≤ 20 全角字，超限脚本直接拦下） |
| 标题 + 视频 | 视频发布 |
| 网页 URL | 先提取内容与媒体，产出可发布草稿，等确认 |
输出：发布执行结果（成功/失败）及发布后的小红书链接；记录自动写入 skill-publish-log。
与相邻 skill 的区别
| skill | 分工 |
|---|---|
| skill-xhs-publisher（本） | 发布：发图文/视频 |
| skill-xhs-comment-reply | 评论区互动：抓评论 + 回复粉丝评论（共用登录态） |
| xhs-analyzer | 分析：搜索规律、爆款拆解、关键词矩阵、限流检测 |
| skill-cross-platform-publish | 多平台一稿多发的编排器；发小红书时委派本 SKILL |
适用场景
- 定时/批量把做好的图文笔记发到小红书
- 视频内容同步发小红书
- 需要发布前预检与成功校验的自动化发布流程
使用前准备
- 需扫码登录一次（
login）；干净网络 IP（机房/代理出口可能被小红书安全限制拦截）。 - 默认建议先用测试号、小流量运行，最终内容人工复核；自动化发布有被风控、限流、封号的风险，使用者自行评估承担。
- 文件路径必须为绝对路径；标题 ≤ 20 全角字。
skill-xhs-publisher 隶属于 Aiglade Skill 库。在 Aiglade 聊天框中用自然语言描述需求即可调用。