这个文档分成两部分:
For Humans:给正常使用仓库的人看For AI Agents:给能执行命令和自动排查的 agent 看
git pull如果你平时是切分支开发,请先确认当前所在分支。
如果仓库最近改了 CLI、入口脚本、依赖配置,建议重新执行:
uv pip install -e .当前主线使用 patchright。
Windows PowerShell:
$env:PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright"; patchright install chromiumLinux / macOS:
PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright" patchright install chromium建议至少检查:
sau --help
sau douyin --help
sau kuaishou --help
sau xiaohongshu --help
sau bilibili --help
sau douyin check --account your_account
sau kuaishou check --account your_account
sau xiaohongshu check --account your_account
sau bilibili check --account your_account如果你在使用 skill,也建议同步看一下:
skills/douyin-upload/SKILL.mdskills/kuaishou-upload/SKILL.mdskills/xiaohongshu-upload/SKILL.mdskills/bilibili-upload/SKILL.mddocs/CLI.md
如果你是 agent,更新仓库后建议按下面顺序做最小验证:
- 拉取最新代码:
git pull- 重新同步本地安装:
uv pip install -e .-
如需浏览器驱动,更新
patchrightChromium -
重新验证 CLI:
sau --help
sau douyin --help
sau kuaishou --help
sau xiaohongshu --help
sau bilibili --help- 如果任务是浏览器平台链路,再继续验证:
sau douyin check --account test
sau kuaishou check --account test
sau xiaohongshu check --account test
sau bilibili check --account test- 如果用户依赖 skill,再检查这些路径是否仍存在且契约没变:
skills/douyin-upload/SKILL.mdskills/douyin-upload/references/cli-contract.mdskills/douyin-upload/references/runtime-requirements.mdskills/kuaishou-upload/SKILL.mdskills/kuaishou-upload/references/cli-contract.mdskills/kuaishou-upload/references/runtime-requirements.mdskills/xiaohongshu-upload/SKILL.mdskills/xiaohongshu-upload/references/cli-contract.mdskills/xiaohongshu-upload/references/runtime-requirements.mdskills/bilibili-upload/SKILL.mdskills/bilibili-upload/references/cli-contract.mdskills/bilibili-upload/references/runtime-requirements.md
- 优先相信
pyproject.toml,不要把requirements.txt视为当前主线真相 - 当前 README 只做总览,安装和更新以
docs/install.md、docs/update.md为准 - Web 相关内容属于历史路径,见
docs/legacy-web.md - 如果更新后的登录流程输出了本地二维码图片,agent 应直接把图片展示/发送给用户扫码,不要只回传图片路径
- Bilibili 命令运行时会自动检查并更新
biliup - Bilibili 登录当前仍建议让用户自己在本地真实终端里执行;如果二维码显示不完整,可让用户直接打开
qrcode.png扫码