| 1 | # 更新说明 |
| 2 | |
| 3 | 这个文档分成两部分： |
| 4 | |
| 5 | - `For Humans`：给正常使用仓库的人看 |
| 6 | - `For AI Agents`：给能执行命令和自动排查的 agent 看 |
| 7 | |
| 8 | ## For Humans |
| 9 | |
| 10 | ### 1. 拉取最新代码 |
| 11 | |
| 12 | ```bash |
| 13 | git pull |
| 14 | ``` |
| 15 | |
| 16 | 如果你平时是切分支开发，请先确认当前所在分支。 |
| 17 | |
| 18 | ### 2. 更新本地可编辑安装 |
| 19 | |
| 20 | 如果仓库最近改了 CLI、入口脚本、依赖配置，建议重新执行： |
| 21 | |
| 22 | ```bash |
| 23 | uv pip install -e . |
| 24 | ``` |
| 25 | |
| 26 | ### 3. 如有需要，更新浏览器依赖 |
| 27 | |
| 28 | 当前主线使用 `patchright`。 |
| 29 | |
| 30 | Windows PowerShell： |
| 31 | |
| 32 | ```powershell |
| 33 | $env:PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright"; patchright install chromium |
| 34 | ``` |
| 35 | |
| 36 | Linux / macOS： |
| 37 | |
| 38 | ```bash |
| 39 | PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright" patchright install chromium |
| 40 | ``` |
| 41 | |
| 42 | ### 4. 更新后自检 |
| 43 | |
| 44 | 建议至少检查： |
| 45 | |
| 46 | ```bash |
| 47 | sau --help |
| 48 | sau douyin --help |
| 49 | sau kuaishou --help |
| 50 | sau xiaohongshu --help |
| 51 | sau bilibili --help |
| 52 | sau douyin check --account your_account |
| 53 | sau kuaishou check --account your_account |
| 54 | sau xiaohongshu check --account your_account |
| 55 | sau bilibili check --account your_account |
| 56 | ``` |
| 57 | |
| 58 | 如果你在使用 skill，也建议同步看一下： |
| 59 | |
| 60 | - `skills/douyin-upload/SKILL.md` |
| 61 | - `skills/kuaishou-upload/SKILL.md` |
| 62 | - `skills/xiaohongshu-upload/SKILL.md` |
| 63 | - `skills/bilibili-upload/SKILL.md` |
| 64 | - `docs/CLI.md` |
| 65 | |
| 66 | ## For AI Agents |
| 67 | |
| 68 | 如果你是 agent，更新仓库后建议按下面顺序做最小验证： |
| 69 | |
| 70 | 1. 拉取最新代码： |
| 71 | |
| 72 | ```bash |
| 73 | git pull |
| 74 | ``` |
| 75 | |
| 76 | 2. 重新同步本地安装： |
| 77 | |
| 78 | ```bash |
| 79 | uv pip install -e . |
| 80 | ``` |
| 81 | |
| 82 | 3. 如需浏览器驱动，更新 `patchright` Chromium |
| 83 | |
| 84 | 4. 重新验证 CLI： |
| 85 | |
| 86 | ```bash |
| 87 | sau --help |
| 88 | sau douyin --help |
| 89 | sau kuaishou --help |
| 90 | sau xiaohongshu --help |
| 91 | sau bilibili --help |
| 92 | ``` |
| 93 | |
| 94 | 5. 如果任务是浏览器平台链路，再继续验证： |
| 95 | |
| 96 | ```bash |
| 97 | sau douyin check --account test |
| 98 | sau kuaishou check --account test |
| 99 | sau xiaohongshu check --account test |
| 100 | sau bilibili check --account test |
| 101 | ``` |
| 102 | |
| 103 | 6. 如果用户依赖 skill，再检查这些路径是否仍存在且契约没变： |
| 104 | |
| 105 | - `skills/douyin-upload/SKILL.md` |
| 106 | - `skills/douyin-upload/references/cli-contract.md` |
| 107 | - `skills/douyin-upload/references/runtime-requirements.md` |
| 108 | - `skills/kuaishou-upload/SKILL.md` |
| 109 | - `skills/kuaishou-upload/references/cli-contract.md` |
| 110 | - `skills/kuaishou-upload/references/runtime-requirements.md` |
| 111 | - `skills/xiaohongshu-upload/SKILL.md` |
| 112 | - `skills/xiaohongshu-upload/references/cli-contract.md` |
| 113 | - `skills/xiaohongshu-upload/references/runtime-requirements.md` |
| 114 | - `skills/bilibili-upload/SKILL.md` |
| 115 | - `skills/bilibili-upload/references/cli-contract.md` |
| 116 | - `skills/bilibili-upload/references/runtime-requirements.md` |
| 117 | |
| 118 | ### 对 agent 的额外说明 |
| 119 | |
| 120 | - 优先相信 `pyproject.toml`，不要把 `requirements.txt` 视为当前主线真相 |
| 121 | - 当前 README 只做总览，安装和更新以 `docs/install.md`、`docs/update.md` 为准 |
| 122 | - Web 相关内容属于历史路径，见 `docs/legacy-web.md` |
| 123 | - 如果更新后的登录流程输出了本地二维码图片，agent 应直接把图片展示/发送给用户扫码，不要只回传图片路径 |
| 124 | - Bilibili 命令运行时会自动检查并更新 `biliup` |
| 125 | - Bilibili 登录当前仍建议让用户自己在本地真实终端里执行；如果二维码显示不完整，可让用户直接打开 `qrcode.png` 扫码 |
| 126 |