打开浏览器

其他 社区 v0.2.0

技能解读

设计思路

open-gstack-browser 是 gstack 的「打开真 Chromium 用户界面」入口——把 headless 模式切到 headed 模式,让用户能在屏幕上看着 Claude 在浏览器里点点点,并通过 GStack Browser 的 Chrome 扩展看到右侧 Side Panel 的实时 activity feed 与 sidebar chat。设计目标:新人初见也能立刻信任——你看见每一个点击 / 截图 / 表单填充。

启动流程要点

Step 0:清场(必要时关掉旧 server)。 Step 1:$B connect——拉起 headed Chromium + 装好扩展,监听 localhost:34567。 Step 2-3:让用户确认 Side Panel 是否能看到——A) 看到了;B) 没看到(按指引装扩展或开 localhost:34567);C) Side Panel 啥都没显示,跑 $B status + 必要时 $B focus 拉前台。

Step 4:Demo

$B goto https://news.ycombinator.com
# 等 2 秒
$B snapshot -i

告诉用户:「看 Side Panel——goto 和 snapshot 应该实时出现在 activity feed 里。Claude 跑的每条命令都会实时显示。」

Step 5:Sidebar chat

Side Panel 还有 chat tab:在那里输入「take a snapshot and describe this page」——一个 sidebar agent(子 Claude 实例)会执行你的请求,命令出现在 activity feed。每个 task 上限 5 分钟,跑在隔离 session,不会干扰主 Claude Code 窗口。

Step 6:能力总结

  • 看 Claude 干活:跑任意 gstack skill(/qa / /design-review / /benchmark)都在可见浏览器里发生
  • 直接控制浏览器:sidebar chat 自然语言、$B 命令直接操作
  • 窗口管理:$B focus 任意时刻拉前台、$B disconnect 切回 headless
  • headed 模式下的 skill 表现:/qa 真浏览器跑测试套件、/design-review 真截屏、/benchmark 真测性能

适合谁

  • 第一次用 gstack 想看见 agent 干活的人
  • 调试 $B 命令时怕 headless 看不出错误的工程师
  • 给同事 / 客户演示时

不适合

  • CI / 服务器环境——没显示器
  • 性能敏感跑批——headed 比 headless 慢

配套

browse(命令体系)、gstack(生态入口)、canary(部署后监控)、webapp-testing(headed 模式下跑测试)。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
92 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@garrytan · v0.2.0 · 未声明许可证
上下文用量评级
较高消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Bun
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 0 步:飞行前清理

在连接之前,请终止所有过时的浏览服务器并清理可能因崩溃而保留的锁定文件。这可以防止“已连接”误报和 Chromium 配置文件锁定冲突。

02
第 1 步:连接

这将在 head 模式下启动 GStack 浏览器(重新命名为 Chromium),其中包含: 您可以观看的可见窗口(不是常规的 Chrome — 它保持不变) gstack 侧边栏扩展通过 `launchPersistentContext` 自动加载反机器人隐形补丁(Google 和 NYTimes 等网站无需验证码即可运行) 自定义用户代理和 Dock/菜单栏中的 GStack 浏览器品牌

03
第 2 步:验证

确认输出显示`Mode: headed`。从状态文件中读取端口:端口应为 34567。如果不同,请记下 — 用户可能需要它用于侧面板。还可以找到扩展路径,以便在用户需要手动加载时可以为他们提供帮助:

04
步骤 3:引导用户访问侧面板

使用 AskUserQuestion:Chrome 是通过 gstack 控件启动的。您应该会在页面顶部看到 Playwright 的 Chromium(不是常规的 Chrome),并带有金色闪光线。侧面板扩展应该自动加载。要打开它: 1. 在工具栏中查找拼图图标(扩展)——它可能会出现

05
第四步:演示

用户确认侧面板正常工作后,运行一个快速演示:等待 2 秒钟,然后: 告诉用户:“检查侧面板 - 您应该看到 `goto` 和 `snapshot` 命令出现在活动源中。Claude 运行的每个命令都会实时显示在此处。”

06
第五步:侧边栏聊天

在活动源演示之后,告诉用户侧边栏聊天:侧面板还有一个聊天选项卡。尝试输入诸如“拍摄快照并描述此页面”之类的消息。侧边栏代理(Claude 子实例)在浏览器中执行您的请求 - 您将看到命令在发生时出现在活动源中。

07
第 6 步:下一步是什么

告诉用户:一切都准备好了!您可以使用连接的 Chrome 执行以下操作: 实时观看 Claude 工作: - 运行任何 gstack 技能(`/qa`、`/design-review`、`/benchmark`)并观看可见 Chrome 窗口 + 侧面板提要中发生的每个操作

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。