| 1 | # 运行前提 |
| 2 | |
| 3 | 这个 skill 默认假设当前环境已经具备： |
| 4 | |
| 5 | - 已安装 `social-auto-upload` |
| 6 | - 可以调用 `sau` 命令，或至少有等效调用方式 |
| 7 | - 已为 `patchright` 安装 Chromium |
| 8 | |
| 9 | ## 推荐安装方式 |
| 10 | |
| 11 | 在项目根目录执行： |
| 12 | |
| 13 | ```bash |
| 14 | uv pip install -e . |
| 15 | ``` |
| 16 | |
| 17 | ## 安装 patchright 浏览器 |
| 18 | |
| 19 | Windows PowerShell： |
| 20 | |
| 21 | ```powershell |
| 22 | $env:PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright"; patchright install chromium |
| 23 | ``` |
| 24 | |
| 25 | Linux / macOS（bash / zsh）： |
| 26 | |
| 27 | ```bash |
| 28 | PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright" patchright install chromium |
| 29 | ``` |
| 30 | |
| 31 | ## 常见调用方式 |
| 32 | |
| 33 | ### 如果 `sau` 已经在 PATH 中 |
| 34 | |
| 35 | ```bash |
| 36 | sau douyin --help |
| 37 | ``` |
| 38 | |
| 39 | ### 如果虚拟环境存在，但还没有激活 |
| 40 | |
| 41 | PowerShell： |
| 42 | |
| 43 | ```powershell |
| 44 | .\.venv\Scripts\Activate.ps1 |
| 45 | sau douyin --help |
| 46 | ``` |
| 47 | |
| 48 | ### 如果你想直接调用可执行文件 |
| 49 | |
| 50 | PowerShell： |
| 51 | |
| 52 | ```powershell |
| 53 | .\.venv\Scripts\sau.exe douyin --help |
| 54 | ``` |
| 55 | |
| 56 | ### 如果你更倾向于使用 uv |
| 57 | |
| 58 | ```bash |
| 59 | uv run sau douyin --help |
| 60 | ``` |
| 61 | |
| 62 | ## 无头和有头模式 |
| 63 | |
| 64 | - 使用 `--headless` 表示无头模式 |
| 65 | - 使用 `--headed` 表示有头模式 |
| 66 | - 如果用户明确要求无头登录，也要预期 CLI 会通过控制台输出或临时图片路径提供二维码相关提示 |
| 67 | - 如果登录过程中已经生成了本地二维码图片，agent 应优先直接把图片展示/发送给用户扫码，不要只告诉用户图片路径 |
| 68 |