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