调试台
在接入 API 前试运行浏览器、单页抓取和多页爬取能力。
先证明目标站点、运行设置和输出格式稳定，再迁移到 API 代码。
按需求选择完整 Playwright 控制、单页提取或有边界的站内采集。
生成的 SDK 和 cURL 示例使用公开 API 鉴权，不依赖控制台私有行为。
工作台类型
打开控制台浏览器工作台，用于登录、点击、复杂等待和多步骤 Playwright 流程。
打开控制台单页抓取工作台，渲染一个 URL 并提取文本、HTML 或截图。
打开控制台多页爬取工作台，用最大页数、同站链接和包含/排除规则控制范围。
智能体受独立公开准入契约约束；当前生产路径使用浏览器、单页抓取和多页爬取工作台。准入标准见智能体契约。
运行设置
运行前确认四类控制：浏览器档案决定是否带状态启动和是否写回，超时限制会话最长运行时间，录制保存跟踪记录或视频，保持会话用于脚本结束后的人工检查。这些设置会进入生成的 SDK 和 cURL 示例，因此你可以在控制台外复现同一次工作流。
浏览器工作流
已经知道要执行的 Playwright 脚本时，使用浏览器工作台。
export default async function run({ page, log }) {
await page.goto('https://example.com', { waitUntil: 'networkidle' });
log('Title:', await page.title());
}运行开始后，可以在同一个页面里查看实时画面、输出、浏览器日志、网络事件和指标，不需要跳回会话列表排查。
单页与多页抓取
单页抓取和多页爬取都从明确 URL 开始，区别在于范围：单页抓取用于一个页面的渲染结果，多页爬取用于有边界的站内采集。
单页抓取重点是输出格式和内容收窄：文本、HTML、截图，以及包含/排除选择器。多页爬取重点是边界：起始 URL、最多页面数、站点地图或同站链接跟随。两者都应先检查摘要，再迁移生成脚本或接入代码。
多页爬取默认限制在同站点内，避免误触发过大的范围，也让运行结果更容易解释。
接入代码
每个调试台类型都会展示 SDK 和 cURL 示例。示例只使用公开 API 鉴权：
export HIVEBROWSER_API_KEY=hb_live_...生成的示例不会包含控制台内部委托鉴权头，也不会包含实时画面的临时令牌。把生成脚本视为应用代码：提交到生产前应审查脚本、避免把敏感信息写入日志，并把稳定工作流迁移到自己的代码仓库。
历史与排查
单页抓取和多页爬取运行后，会回到各自工作台并显示紧凑结果卡片。单页抓取会突出 HTTP 状态、标题、内容块和截图；多页爬取会突出页面数、同站链接、站点地图候选和截图。先确认结果，再按需打开完整浏览器工作台。
最近运行会保留会话 ID、状态、耗时、输出预览，以及回到会话详情的链接。用它对比成功和失败尝试，不需要在完整会话表里翻找。
失败时打开会话详情页，继续查看请求 ID、运行时日志、回放产物和浏览器/网络事件。