Xiaohongshu Upload Agent Skill

小红书上传 Skill

优先把 sau 作为主接口。

不要假设当前环境一定能读取仓库源码。

不要一开始就去读 uploader/。

只有在命令不可用或 CLI 执行失败时，才回退到故障排查说明。

功能概览

| 功能 | 命令入口 | 说明 |

| --- | --- | --- |

| 小红书登录 | sau xiaohongshu login --account <name> | 生成或刷新指定账号的 cookie |

| cookie 校验 | sau xiaohongshu check --account <name> | 检查指定账号 cookie 是否有效 |

| 视频上传 | sau xiaohongshu upload-video ... | 上传并发布小红书视频 |

| 图文上传 | sau xiaohongshu upload-note ... | 上传并发布小红书图文 |

元数据约定：

• 视频使用 title + desc + tags
• 图文使用 title + note + tags

默认工作流

• 先确认 references/runtime-requirements.md 里的运行前提。
• 再确认 references/cli-contract.md 里的命令契约。
• 执行匹配的 sau xiaohongshu ... 命令。
• 如果命令失败，再看 references/troubleshooting.md。

支持动作

• 使用 sau xiaohongshu login --account <name> 登录小红书
• 使用 sau xiaohongshu check --account <name> 校验 cookie 是否有效
• 使用 sau xiaohongshu upload-video ... 上传小红书视频
• 使用 sau xiaohongshu upload-note ... 上传小红书图文

命令选择建议

• 当用户需要新的 cookie，或现有 cookie 已失效时，使用 login
• 当用户只需要确认 cookie 状态时，使用 check
• 当用户要发布视频时，使用 upload-video
• 当用户要发布图文时，使用 upload-note

执行前检查

• 先确认当前 shell 里是否可以调用 sau
• 如果 sau 不可用，按 references/runtime-requirements.md 里的回退方式处理
• 当用户明确指定无头或有头模式时，显式传 --headless 或 --headed
• 只有用户明确要求定时发布时，才使用 --schedule
• 如果登录流程生成了本地二维码图片，不要只把图片路径告诉用户
• 二维码图片本身就是给用户扫码的，优先直接把本地图片展示/发送给用户

参考文档

• 运行前提：references/runtime-requirements.md
• CLI 契约：references/cli-contract.md
• 故障排查：references/troubleshooting.md