用途
Setup Browser Cookies 用于把用户在真实 Chromium 系浏览器(Comet、Chrome、Arc、Brave、Edge)中的已登录会话 Cookie 导入到无头浏览(headless browse)会话中,使自动化浏览会话立即具备已登录状态,无需重新登录。
主要能力
- 自动检测已安装的 Chromium 系浏览器。
- 打开交互式选择器 UI,可切换浏览器、按域名搜索。
- 点击“+”导入某个域名的 Cookie,点击垃圾桶图标移除已导入的 Cookie。
- 支持直接指定域名的导入方式,跳过 UI。
- Cookie 被解密后加载进 Playwright 会话,会话在命令之间保持 Cookie,导入后即时可用。
- UI 仅显示域名和 Cookie 数量,不暴露 Cookie 值。
使用方式
- 查找 browse 二进制文件:
B=$(browse/bin/find-browse 2>/dev/null || ~/.codex/skills/gstack/browse/bin/find-browse 2>/dev/null)
if [ -n "$B" ]; then
echo "READY: $B"
else
echo "NEEDS_SETUP"
fi
如果返回 NEEDS_SETUP,需告知用户 gstack browse 需要一次性构建(约 10 秒),获得同意后运行:
cd <SKILL_DIR> && ./setup
若未安装 bun:
curl -fsSL https://bun.sh/install | bash
- 打开 Cookie 选择器:
$B cookie-import-browser
该命令会自动检测已安装的 Chromium 浏览器并打开交互式选择器 UI,用户可选择要导入的域名后告知完成。
- 直接导入(替代方式),当用户直接指定域名时跳过 UI:
$B cookie-import-browser comet --domain github.com
若指定了其他浏览器,则将 comet 替换为对应浏览器名称。
- 验证,在用户确认完成后:
$B cookies
向用户展示已导入 Cookie 的摘要(各域名数量)。
适用场景
- 需要在无头自动化浏览会话中复用真实浏览器已登录状态的场景。
- 需要按域名选择性地导入登录会话 Cookie 的场景。
限制与注意事项
- 每个浏览器首次导入可能触发 macOS Keychain 对话框,需点击“Allow”或“Always Allow”。
- Cookie 选择器与 browse 服务器使用同一端口,不额外启动进程。
- UI 中仅显示域名与 Cookie 数量,不暴露 Cookie 值。
- 具体收费、价格、支持平台范围等资料暂未提供。