troubleshooting.md - Social Auto Upload

troubleshooting.md

1	# 故障排查
2
3	## 找不到 `sau` 命令
4
5	可以尝试以下方式：
6
7	```powershell
8	.\.venv\Scripts\Activate.ps1
9	sau douyin --help
10	```
11
12	```powershell
13	.\.venv\Scripts\sau.exe douyin --help
14	```
15
16	```bash
17	uv run sau douyin --help
18	```
19
20	如果当前环境还没有安装项目：
21
22	```bash
23	uv pip install -e .
24	```
25
26	## cookie 无效或已过期
27
28	先检查 cookie 状态：
29
30	```bash
31	sau douyin check --account <account>
32	```
33
34	如果无效，就重新登录：
35
36	```bash
37	sau douyin login --account <account>
38	```
39
40	## 无头登录二维码处理
41
42	如果用户无法使用终端二维码输出：
43
44	- 查找 CLI 打印出来的临时二维码图片
45	- agent 不要只把图片路径回给用户
46	- agent 应优先直接把本地二维码图片展示/发送给用户扫码
47
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	对 `upload-note` 来说：
73
74	- 不支持 GIF
75	- 最多 35 张图片
76
77	如果超出这些限制，先减少图片数量或替换文件格式，再重试。
78
79	## 定时发布
80
81	时间格式使用：
82
83	```text
84	YYYY-MM-DD HH:MM
85	```
86
87	如果不需要定时发布，去掉 `--schedule` 即可改为立即发布。
88

88 lines MARKDOWN