| 1 | # 故障排查 |
| 2 | |
| 3 | ## 找不到 `sau` 命令 |
| 4 | |
| 5 | 可以尝试以下方式： |
| 6 | |
| 7 | ```powershell |
| 8 | .\.venv\Scripts\Activate.ps1 |
| 9 | sau kuaishou --help |
| 10 | ``` |
| 11 | |
| 12 | ```powershell |
| 13 | .\.venv\Scripts\sau.exe kuaishou --help |
| 14 | ``` |
| 15 | |
| 16 | ```bash |
| 17 | uv run sau kuaishou --help |
| 18 | ``` |
| 19 | |
| 20 | 如果当前环境还没有安装项目： |
| 21 | |
| 22 | ```bash |
| 23 | uv pip install -e . |
| 24 | ``` |
| 25 | |
| 26 | ## cookie 无效或已过期 |
| 27 | |
| 28 | 先检查 cookie 状态： |
| 29 | |
| 30 | ```bash |
| 31 | sau kuaishou check --account <account> |
| 32 | ``` |
| 33 | |
| 34 | 如果无效，就重新登录： |
| 35 | |
| 36 | ```bash |
| 37 | sau kuaishou login --account <account> |
| 38 | ``` |
| 39 | |
| 40 | ## 登录二维码问题 |
| 41 | |
| 42 | 如果用户反馈二维码在终端里不好扫： |
| 43 | |
| 44 | - 先优先使用 CLI / uploader 生成的本地二维码图片 |
| 45 | - 只有用户明确需要可见浏览器窗口，或图片方案仍然不方便时，再切到 `--headed` |
| 46 | - 如果 CLI / uploader 已经生成临时二维码图片，agent 不要只回图片路径 |
| 47 | - agent 应优先直接把本地二维码图片展示/发送给用户扫码 |
| 48 | - 图片路径只作为补充信息 |
| 49 | |
| 50 | ## 上传参数缺失 |
| 51 | |
| 52 | ### 视频上传 |
| 53 | |
| 54 | 最少需要： |
| 55 | |
| 56 | - `--account` |
| 57 | - `--file` |
| 58 | - `--title` |
| 59 | |
| 60 | ### 图文上传 |
| 61 | |
| 62 | 最少需要： |
| 63 | |
| 64 | - `--account` |
| 65 | - `--images` |
| 66 | - `--title` |
| 67 | |
| 68 | `--note` 当前是可选图文正文。 |
| 69 | |
| 70 | ## 图文上传只有一张生效 |
| 71 | |
| 72 | 如果用户一次传了多张图片，但页面只识别到一张，先确认： |
| 73 | |
| 74 | - `--images` 里传的是不是真正不同的文件 |
| 75 | - 不是同一路径重复多次 |
| 76 | |
| 77 | ## 定时发布 |
| 78 | |
| 79 | 时间格式使用： |
| 80 | |
| 81 | ```text |
| 82 | YYYY-MM-DD HH:MM |
| 83 | ``` |
| 84 | |
| 85 | 如果不需要定时发布，去掉 `--schedule` 即可改为立即发布。 |
| 86 |