Tabbit博客

Tabbit CLI 教程:安装、任务空间与回执

安装 Tabbit CLI,运行一个范围明确的浏览器任务,并用回执核对结果。

本文目录
  1. 安装并核对官方启动器
  2. Agent 需要哪些条件
  3. 新建一个有名字的任务
  4. 用回执恢复结果
  5. 两个任务共享什么
  6. 兼容范围和清理

Tabbit CLI 让受支持的本地 Agent 操作已启动的 Tabbit。安装官方桌面应用,确认 Agent 能加载 tabbit skill,再检查启动器能否连到目标浏览器。接通后,用一个练习任务验证页面结果和回执。

安装并核对官方启动器

从 Tabbit 官方站下载并启动桌面应用,再重启 Agent 让它重新加载已安装的 skill。macOS 启动器位于 $HOME/.local/bin/tabbit-cli。Windows 的 skill 位于当前用户目录,PowerShell 启动器按官方指引位于 LocalAppData 的 Tabbit/LocalAgent/bin/tabbit-cli.exe。先运行 diagnose,确认连接的是预期版本。

如果同时运行多个版本,取启动器为目标浏览器打印的实例 ID,并在整个任务中用 TABBIT_PLAYWRIGHT_INSTANCE 固定该值。

launcher="$HOME/.local/bin/tabbit-cli"
"$launcher" diagnose

官方安装指南 · 下载并安装 Tabbit · Tabbit 浏览器概览

Agent 需要哪些条件

Agent 需要能运行本机命令的 shell 或受支持的集成,运行环境要能到达 Tabbit 运行时。还要能加载 skill 或按文档调用启动器。识别 skill、连到目标浏览器、读出页面结果是三项不同的检查。纯云端客户端先验证是否有连接路径。

适合 Agent 的浏览器 · 浏览器 Agent

新建一个有名字的任务

给任务起清楚的名字。导航、动作和验证沿用同一个名字。先打开无需账号的练习页,回报标题和未展开的状态。每次调用使用不同请求 ID,动作 ID 留作之后恢复回执。

按需将命令中的地址替换成下方链接。重新练习时换一个新的任务名和请求 ID。

"$launcher" nodejs --task "CLI practice" --request-id cli-practice-open <<'JS'
await page.goto('https://go.tabbit.ai/blog/tabbit-cli-complete-guide/fixture.html');
return { title: await page.title(), visible: await page.locator('#source').isVisible() };
JS

打开练习页 · 浏览器自动化 · 让 AI Agent 操作浏览器

用回执恢复结果

沿用任务名,展开一次 Show source details,回读可见编号。如果没有收到响应,用原请求 ID 查询 receipt。这样能取得原动作结果,无需再次点击。对可能已经完成的操作,重试前先核对页面状态。

"$launcher" nodejs --task "CLI practice" --request-id cli-practice-click <<'JS'
await page.getByText('Show source details', { exact: true }).click();
return await page.locator('#source').innerText();
JS
"$launcher" receipt --task "CLI practice" --request-id cli-practice-click

Agent 浏览器安全

两个任务共享什么

本次用 Tabbit 稳定版 1.21.21.0。任务 A 展开 DEMO-F08 并保存任务脚本变量。任务 B 另开一页,详情仍收起,也没有 A 的变量,但能读取 A 写入的同源测试存储。任务名分隔页面所有权和任务状态。站点存储和登录态取决于选定浏览器配置。

检查项任务 A任务 B
详情展开 · DEMO-F08收起
任务变量TASK-A-ONLY无
同源存储ORIGIN-F08读到测试标记
Tabbit CLI 练习页展开 DEMO-F08 前后的两张截图

兼容范围和清理

链接中的 Codex 案例实际用独立本地 Codex 会话调用 Tabbit CLI。DeepSeek Harness 案例实测的是其原生适配器。官方快速开始还列出其他可接入客户端,本文实验使用 macOS 启动器。finish 前导出回执,结束时只关闭自己为练习创建的任务页。

"$launcher" finish --task "CLI practice"
问题先检查
缺少 skill重启 Agent 并核对 skill 目录
运行时不可达启动目标 Tabbit 版本并运行 diagnose
没收到结果先查原请求再决定是否重试

Codex 接入 · DeepSeek Harness 适配器 · Tabbit CLI 基准测试

两位发帖者分享了在 Tabbit 打开工作标签和提取讨论重点的体验。它们描述的是浏览器使用,CLI 接入可按本文的任务和回执单独验证。 Reddit 1 · Reddit 2

常见问题

在哪里安装 Tabbit CLI?

安装并启动官方桌面版 Tabbit,按快速开始核对启动器和 skill。

怎么确认 CLI 已连接?

用正式启动器运行 diagnose,再用真实任务核对标题和可见值。

不同任务的登录态独立吗?

任务隔离页面所有权和任务状态。同一选定配置下,任务可以共享站点存储和登录态。

响应中断怎么处理?

按任务名和原请求 ID 查询回执。重做动作前先确认页面状态。

所有 Agent 都能接入吗?

核对客户端能否加载 skill 或调用受支持的启动器,并能到达 Tabbit 运行时。

finish 会做什么?

它释放任务所有权。先导出证据,练习结束时只关闭自己创建的任务页。

下一步

让 Tabbit 与你并肩工作。

跨标签页调研、自动化重复的浏览器工作,让每一处上下文都触手可及。