setup-browser-cookies

setup-browser-cookies 技能概览

setup-browser-cookies 做什么

setup-browser-cookies 技能帮助代理将真实 Chromium 浏览器里的 cookies 导入到无头浏览会话中。它面向需要先具备已登录状态才能开始测试的认证 QA 和浏览器自动化场景。

谁应该安装它

如果你经常需要以下工作，就应该安装 setup-browser-cookies 技能：

• 测试登录后才能访问的页面
• 复现认证流程中的 bug
• 将真实浏览器会话交给自动化流程继续使用
• 避免每次运行都手动重建认证状态

这项技能有什么不同

和那种只会说“先登录”的通用提示不同，setup-browser-cookies 提供了明确的 cookie 导入流程和交互式选择步骤。当你需要控制哪些域会被带入无头会话，而不是只给一个笼统的“完成认证”指令时，这一点尤其重要。

什么时候适合用

setup-browser-cookies for Browser Automation 最适合的情况是：浏览器状态已经存在于 Chromium 中，而你的主要任务是安全复用这份状态。如果你需要完整的凭据输入、MFA 处理，或者从零开始走一套全新的认证流程，它就不那么合适了。

如何使用 setup-browser-cookies 技能

安装该技能

使用你环境对应的仓库技能安装流程，然后确认系统里能以 setup-browser-cookies 这个名字找到该技能。如果你的环境使用 skill manager，就先安装包，再检查技能目录里是否包含 SKILL.md 和 SKILL.md.tmpl。

从合适的任务提示开始

只有当你的请求清楚说明需要哪种已认证浏览器状态时，这项技能才最有效。好的输入应当写明：

• 目标站点或应用
• 登录后要执行的任务
• 你是想导入所有 cookies，还是只导入特定域
• 任何浏览器限制，例如仅限 Chromium

更强的提示示例如下：“使用 setup-browser-cookies 导入我在 example.com 的 Chromium cookies，然后打开 dashboard，并验证 billing page 是否能以已认证用户身份加载。”

先读什么

在依赖 setup-browser-cookies usage 流程之前，先检查：

• SKILL.md，了解精确的操作步骤
• SKILL.md.tmpl，看清这个技能是如何生成的，以及哪些内容被设计为稳定不变
• 涉及 preamble、safe operations 和 skill routing 的章节

这些内容比通读整份文件更重要，因为它们会告诉你这个技能什么时候应该运行，以及它对会话有什么要求。

实用工作流建议

为了获得更好的结果，告诉代理：

• 哪个浏览器 profile 或哪台机器保存着 cookies
• 你是否预期存在跨多个域的认证
• 如果 cookie picker 显示的域太多，应该怎么处理
• 目标是只读验证，还是会进行会修改数据的操作

如果任务描述不够明确，技能可能会导入错误的域，或者过早停止。你要明确说明自己关心哪些已认证页面，而不是只说站点名称。

setup-browser-cookies 技能 FAQ

setup-browser-cookies 只适用于 Chromium 吗？

它的设计就是把真实 Chromium 浏览器中的 cookies 导入到无头会话里。如果你的浏览器状态在别处，这项技能未必是最佳选择，除非你的工作流已经把这道转换桥接好了。

我还需要提供登录信息吗？

很多情况下不需要，前提是已经存在有效的浏览器会话。setup-browser-cookies 技能的目标是复用已认证状态，而不是用凭据输入去替代应用本身的登录流程。

它比普通的“登录”提示更好吗？

是的，前提是瓶颈在于会话复用。普通提示可以要求执行登录行为，但 setup-browser-cookies install 提供的是可重复的 cookie 导入模式，以及更清晰的认证浏览工作触发方式。

什么时候不该用它？

如果你需要以下内容，就不要用它：

• 全新的账号创建流程
• 重置密码步骤
• 手动 MFA 注册
• 非 Chromium 的会话迁移

在这些情况下，通常更适合用更通用的浏览器自动化技能，或者针对任务单独写一个登录提示。

如何改进 setup-browser-cookies 技能

给技能正确的会话目标

最有效的改进通常来自更准确的会话目标，而不是更多指令。请明确写出具体站点、已认证路由，以及导入完成后代理应该停在哪一步。这样可以减少 cookies 加载后的猜测空间。

降低 cookie 作用域的歧义

如果你的环境涉及多个子域，请说明哪些才是重点。例如：“导入 app.example.com 和 api.example.com 的 cookies，但忽略营销域名。” 这样可以避免导入无关域，导致会话变得杂乱或混淆。

先为最常见的失败模式做准备

最常见的失败是认证状态不完整：页面虽然打开了，却仍然显示登录墙、session 过期，或者只有部分权限。遇到这种情况时，请把导入后看到了什么、哪个域失败了、浏览器 profile 里是否已经有活跃会话，一并补充到提示里。

用结果导向的反馈持续迭代

第一次运行之后，围绕代理应该验证的结果继续细化任务：

• “确认账户菜单显示的是已登录用户”
• “打开 admin page 并检查 session 是否保持有效”
• “如果导入失败，先询问后再用不同的域集合重试”

这类反馈会让 setup-browser-cookies guide 比简单重复原始目标更有效。