name: xiaohongshu-upload description: 当 agent 需要通过已安装的 sau CLI 完成小红书登录、cookie 校验、视频上传或图文发布时使用这个 skill。该 skill 适用于已经安装 social-auto-upload 且可调用 sau 命令的环境。优先使用这个 skill 进行稳定的命令式小红书工作流，而不是一开始就阅读 uploader 源码。 metadata: version: "1.0.1"

小红书上传 Skill

优先把 sau 作为主接口。

不要假设当前环境一定能读取仓库源码。 不要一开始就去读 uploader/。 只有在命令不可用或 CLI 执行失败时，才回退到故障排查说明。

这里描述代码提供的 CLI 功能，不表示当前版本已完成真实账号发布验证。运行前提和命令调用方式见 references/runtime-requirements.md。

功能概览

元数据约定：

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

默认工作流

1. 先确认 references/runtime-requirements.md 里的运行前提。
2. 再确认 references/cli-contract.md 里的命令契约。
3. 执行匹配的 sau xiaohongshu ... 命令。
4. 如果命令失败，再看 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
• 如果登录流程生成了本地二维码图片，不要只把图片路径告诉用户
• 二维码图片本身就是给用户扫码的，优先直接把本地图片展示/发送给用户

模板文件

当你需要稳定的命令模板时，使用 scripts/examples/ 下的文件：

• xiaohongshu_commands.ps1
• xiaohongshu_commands.sh
• xiaohongshu_cli_template.py

参考文档

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