用途:在已安装 social-auto-upload 且 shell 可调用 sau 的环境中,让 agent 通过命令式接口完成小红书相关操作。
主要能力与命令入口:登录 sau xiaohongshu login --account <name>,生成或刷新指定账号 cookie;cookie 校验 sau xiaohongshu check --account <name>;视频上传 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。只有命令不可用或 CLI 执行失败时,才回退到故障排查说明;不要假设环境一定能读取仓库源码,也不要一开始就读 uploader/ 目录。
执行前检查:先确认当前 shell 能否调用 sau;若不可用,按 references/runtime-requirements.md 的回退方式处理。用户明确指定无头或有头模式时,显式传 --headless 或 --headed;只有用户明确要求定时发布时才使用 --schedule。若登录流程生成本地二维码图片,应优先把本地图片展示或发送给用户,而非只告诉路径。
模板与参考:scripts/examples/ 下有 xiaohongshu_commands.ps1、xiaohongshu_commands.sh、xiaohongshu_cli_template.py 可作稳定命令模板;参考文档包括运行前提、CLI 契约与故障排查。
限制:资料未说明支持平台、价格、账号权限或发布效果,也未给出 upload-video 等命令的完整参数细节,需以 CLI 契约与实际命令为准。