bazhuayu 命令找不到 | 检查 Node.js 目录和 npm 全局 bin 是否在 PATH |
升级后 octopus 命令找不到 | v0.1.32 已将入口改为 bazhuayu；替换脚本、CI 和 Agent 调用，但保留 OCTOPUS_* 环境变量 |
中文 --goal 参数异常 | 使用双引号：--goal "提取电影名称、评分" |
| PowerShell 多行命令报错 | 使用反引号 ` 续行，或写成单行 |
| URL 导航失败 | 检查 https://、域名和路径是否完整 |
--output 文件位置不对 | 先切换到工作目录，或传绝对路径 |
旧版 octopus recognize 报未知命令 | recognize 已在 v0.1.23 被移除；当前使用 bazhuayu detect |
detect 在生成任务前报告验证码、访问限制或安全验证 | v0.1.32 的提前识别机制已阻止无效任务生成；先处理网站验证或访问限制，再重新执行 bazhuayu detect |
--run-sample 报参数错误 | 仅在 detect --agent 中使用，并传入正整数 |
| Agent plan preview 不通过 | 打开上下文中的截图和候选区裁剪图，补全 visualReview，并确保候选 ID 与 selection 一致 |
| Agent 任务已生成但样品采集失败 | 检查 JSON 中的 sampleRun.exitCode、sampleRun.summary 和样品输出目录 |
detect --agent --yes 仍在旧脚本里 | detect --agent 不需要 --yes，但仍接受该参数以兼容旧脚本；新脚本请省略 |
PROFILE_NOT_FOUND | 使用 browser profiles --json 返回的准确 profileName，名称区分大小写 |
EXTENSION_NOT_READY | 重新打开浏览器并确认扩展启用，直到 readyForUserBrowserRun 为 true |
BROWSER_RUNNING / PROFILE_RUNNING | 安装扩展前关闭浏览器，或给 browser install 添加 --force-close |
USER_BROWSER_HEADLESS_UNSUPPORTED | 用户浏览器不支持 --headless；移除该参数或切换到 --browser independent |
Linux 上 --browser user 不可用 | 用户模式仅支持 Windows 和 macOS；Linux 使用独立模式 |
task rename/move/delete 或 schedule cloud update/start/stop 报缺少确认 | 远端状态修改命令必须显式传入 --yes |
data preview --unexported 没有标记数据为已导出 | 这是预期行为；--unexported 只读取云端未导出数据，不改变导出状态 |
| API 列表任务无法同步到云端 | API 列表任务当前 localOnly: true，使用 bazhuayu run <taskId> --task-file task.json 本地运行 |
run --max-rows <n> 到上限后未退出 | 升级到 v0.1.32；该版本已修复部分任务达到上限后无法正常结束的问题 |
安装 @latest 卡住 | 使用固定版本：npm install -g bazhuayu-cli@0.1.32 |
