Track bundled vendor runtime sources

vendor/social-auto-upload/skills/douyin-upload/references/troubleshooting.md

@@ -0,0 +1,87 @@
+# 故障排查
+
+## 找不到 `sau` 命令
+
+可以尝试以下方式：
+
+```powershell
+.\.venv\Scripts\Activate.ps1
+sau douyin --help
+```
+
+```powershell
+.\.venv\Scripts\sau.exe douyin --help
+```
+
+```bash
+uv run sau douyin --help
+```
+
+如果当前环境还没有安装项目：
+
+```bash
+uv pip install -e .
+```
+
+## cookie 无效或已过期
+
+先检查 cookie 状态：
+
+```bash
+sau douyin check --account <account>
+```
+
+如果无效，就重新登录：
+
+```bash
+sau douyin login --account <account>
+```
+
+## 无头登录二维码处理
+
+如果用户无法使用终端二维码输出：
+
+- 查找 CLI 打印出来的临时二维码图片
+- agent 不要只把图片路径回给用户
+- agent 应优先直接把本地二维码图片展示/发送给用户扫码
+
+如果终端二维码显示不正常，优先使用保存下来的图片路径，而不是反复尝试随机的终端设置。
+
+## 上传参数缺失
+
+### 视频上传
+
+最少需要：
+
+- `--account`
+- `--file`
+- `--title`
+
+### 图文上传
+
+最少需要：
+
+- `--account`
+- `--images`
+- `--title`
+
+`--note` 当前是可选图文正文。
+
+## 图片限制
+
+对 `upload-note` 来说：
+
+- 不支持 GIF
+- 最多 35 张图片
+
+如果超出这些限制，先减少图片数量或替换文件格式，再重试。
+
+## 定时发布
+
+时间格式使用：
+
+```text
+YYYY-MM-DD HH:MM
+```
+
+如果不需要定时发布，去掉 `--schedule` 即可改为立即发布。