zJay26 管理抖音登录与账号
只使用 python "{baseDir}/../../scripts/cli.py" <子命令>。如果系统只有 python3，替换命令名。不要使用其他抖音登录工具。
先确认账号
用户指定账号时，在子命令前加入 --account <名称>。用户未指定时，CLI 自动使用默认命名账号；需要展示或切换账号时运行：
python "{baseDir}/../../scripts/cli.py" list-accounts
多个账号且用户意图不明确时，展示名称和描述并询问一次。选定后，本次流程保持同一账号。
检查状态
python "{baseDir}/../../scripts/cli.py" check-login
- CLI 会优先复用已有的本地 Chrome 调试实例和其中的登录会话；已有 headed Chrome 不会因为默认模式偏好被重启。
- 导航后的短暂验证码/风控中间页会由 CLI 做有限稳定重检；切到 headed 后还会重新读取当前页面，不沿用切换前的旧风险结果。
logged_in: true：可以继续。logged_in: false：进入登录流程；退出码1不是程序崩溃。action: risk_recovered_after_headed_switch、risk_recovered: true且logged_in: true：临时风险状态已经消失，直接继续，不要请用户验证。needs_user_verification: true：浏览器已切为 headed 或已停在验证页，请用户人工处理，不要绕过或连续重试。
二维码登录
- 获取二维码：
python "{baseDir}/../../scripts/cli.py" get-qrcode
- 将 JSON 的
qrcode_data_url作为图片展示给用户，不输出到公开日志。 - 用户扫码后单次等待：
python "{baseDir}/../../scripts/cli.py" wait-login
wait-login 最多等待 120 秒。超时后重新获取二维码，不要高频轮询。
短信验证码登录
普通手机号页先取得用户明确提供的中国大陆手机号：
python "{baseDir}/../../scripts/cli.py" send-code --phone <手机号>
身份验证页已有绑定手机号入口时，不传手机号：
python "{baseDir}/../../scripts/cli.py" send-code
收到用户提供的 6 位验证码后提交：
python "{baseDir}/../../scripts/cli.py" verify-code --code <6位验证码>
不要在回复中重复完整手机号或验证码；不要保存这些一次性信息。
多账号
python "{baseDir}/../../scripts/cli.py" add-account --name work --description "工作号"
python "{baseDir}/../../scripts/cli.py" set-default-account --name work
python "{baseDir}/../../scripts/cli.py" update-account --name work --description "创作账号"
python "{baseDir}/../../scripts/cli.py" --account work check-login
python "{baseDir}/../../scripts/cli.py" remove-account --name work
每个命名账号使用独立端口和 Chrome Profile。账号名称必须是跨平台有效目录名；重复端口、大小写冲突名称和损坏配置会被拒绝。update-account 只修改描述，remove-account 只移除账号登记并保留 Profile 数据。
边界与失败处理
- 当前没有公开的强制退出或清除 Cookie 命令；不要承诺代替用户登出。
- Chrome 未找到时先使用
douyin-env运行doctor。 - 配置损坏时报告具体路径并停止，不要自动重建。
- 只有 CLI 最终返回
needs_user_verification: true时，才保留可见浏览器并等待用户处理；标题或风险关键词命中本身不等于需要人工验证。