Browser Use Terminal 是一款运行在终端里的浏览器任务工具，让你能监控、实时转向并安全停止AI 浏览器任务的每一个动作。本文将用零基础也能看懂的方式，带你掌握它的可观测性能力：随时看清浏览器在干什么、随时注入新指令修正方向、随时一键停止且保留全部工作成果。

为什么浏览器任务需要"可观测性"

传统做法是把任务交给 AI 后"盲等结果"，但浏览器任务往往要几十秒到几分钟，期间可能遇到登录墙、反爬页面或理解偏差。Browser Use Terminal 把任务执行过程做成了实时可观测的设计：

• 📡看得到：实时进度、当前页面、成本与耗时一目了然
• 🧭拉得回：任务跑到一半可以随时打字注入新指令
• 🛑停得住：一键停止，且采用"优雅停止→强制终止"的安全机制
• 💾丢不了：停止后历史、截图和产物全部保留，可随时恢复继续

产品层面的交互设计思路，可以参考官方 UX 文档 docs/terminal-ui-product-ux.md。

实时监控：任务运行时你能看到什么

任务启动后，界面会持续回答三个问题：它正在做什么？浏览器在哪里？我能不能干预？

界面刻意隐藏了原始工具调用和调试信息，只在必要时暴露——这正是"把复杂度藏起来，需要时再打开"的设计原则。

底层事件流：给进阶用户的"全景镜头"

界面背后是一套完整的事件系统，任务全程都会记录标准化事件，例如task_started（任务开始）、tool.started/tool.output（工具执行与输出）、turn_aborted（回合被中止）等。事件名清单定义在 crates/browser-use-agent/src/events/names.rs，所有事件持久化在本地 SQLite 事件日志中，为历史回放、恢复和审计提供基础。

任务转向：跑到一半还能改方向

这是 Browser Use Terminal 最有价值的能力之一。任务运行中，界面底部始终有一个输入框提示Type to steer the agent...——输入新指令并按Enter，即可在不打断任务的情况下注入指导。

实现上，你的转向消息通过一个"邮箱（mailbox）"机制投递给正在运行的 agent：

• 投递入口：crates/browser-use-tui/src/runtime.rs 中的submit_runtime_user_input，把消息包装成MailboxItem交给运行时
• 运行时会在合适的时机（回合边界或工具间隙）消费这条消息，agent 随即按新方向继续

典型场景：agent 正在逐个页面收集数据，你发现它漏了一个关键条件——直接补一句"只统计 2025 年之后的条目"，它下一轮就会按新约束执行，无需从头重跑任务。

预算护栏：花费接近上限时自动提醒

长任务还要防"烧钱失控"。系统为任务目标（goal）设置了 token 预算，用量达到约 80% 时会发出预算告警转向事件（goal.budget_warning），接近耗尽时发出goal.budget_limit_steering_requested，让模型收到明确的预算提示并收敛行为。这套逻辑见 crates/browser-use-agent/src/goals/steering.rs 与 crates/browser-use-agent/src/goals/budget.rs。

安全停止：不是粗暴 kill，而是三段式优雅中止

按Ctrl+C停止任务时，内部并不是直接杀掉进程，而是一套先礼后兵的三段式序列（见 crates/browser-use-agent/src/task/abort.rs）：

1. 取消（Cancel）：发出协作式取消信号（CancellationToken），让当前任务在最近的检查点自行收敛
2. 宽限等待：短暂等待任务自行落定，同时与一个优雅中断超时窗口赛跑
3. 强制终止（Hard abort）：只有当任务在宽限窗口内"赖着不走"时，才强制中止其执行句柄

这样做的好处是：浏览器页面、已下载的文件、已写入的产物都尽量保持完整，停止后事件日志会记录turn_aborted，界面提示"Work preserved in history"——你的工作成果不会丢。

另外，界面还支持双按Esc快速中止（1.5 秒窗口内的双击判定，见 crates/browser-use-tui/src/main.rs），避免误触。

停止之后：恢复与继续

任务被停止或失败后，一切都在历史里等着：

• 按Tab打开历史面板（Previous work），列出已完成 / 已失败的任务
• 选中任务按Enter查看，按r恢复（resume）继续
• 恢复的原理是事件重放：读取持久化事件日志重建完整上下文，再无缝接上，实现在 crates/browser-use-agent/src/session/resume.rs，并支持 fork（分叉）与 rollback（回滚）

失败界面也总会给出下一步选项：Retry（重试）、检查登录、更换模型或浏览器，而不是冷冰冰地报错。

快捷键速查清单

配合 shell 侧的browser auth status、browser config show、browser diagnostics等命令，可以在任务外部快速核查环境状态。

小结

Browser Use Terminal 把"AI 浏览器自动化"从黑盒变成了可观测的驾驶舱：运行中实时监控进度与花费，随时转向修正方向，Ctrl+C一键安全停止，事后还能恢复继续。这套"监控—转向—停止—恢复"的闭环，正是它区别于普通 CLI 自动化工具的核心体验。

📌 延伸阅读：docs/terminal-ui-product-ux.md（产品交互设计）、docs/terminal-renderer-architecture.md（终端渲染架构）、docs/assistant-plugins.md（在 Claude Code / Codex 中集成使用）