notis-browser-control

Notis 浏览器控制技能

当任务需要浏览器自动化，且适合使用 agent-browser 操控浏览器时，请使用此技能。

此技能会按需加载浏览器指南，并保留 Notis 专属运行时规则，适用于：

1. 在用户的计算机上使用 local_shell 控制浏览器
2. 在 Cloud Computer 中使用 sandbox_shell 控制浏览器

核心运行时规则

浏览器自动化是一种 Shell 工作流。

• 浏览器可以运行在 Cloud Computer 中时，使用 sandbox_shell。
• 浏览器必须运行在用户的计算机上时，使用 local_shell。
• 没有可见的桌面控制备用方案。如果 Agent Browser 无法访问所需的本地浏览器会话，请说明此限制，并请用户通过受支持的本地 Shell 浏览器工作流开放该会话。

运行时选择

浏览器控制技能和本地 set_shell_mode 路径适用于所有套餐，包括 Free。本地路径仍需要已连接的 Notis Desktop 桥接程序。云端执行则需要经服务器授权的托管运行时；如果该运行时不可用，请保留本地路径，并准确呈现返回的运行时指南。

符合以下条件时，选择 sandbox_shell：

• 网站是公开的，或可以使用专用凭据进行测试
• 任务不需要用户的本地浏览器配置文件、标签页、Cookie 或扩展程序
• 隔离性和可复现性比用户当前的浏览器会话更重要
• 需要测试 Web 流程、截取屏幕截图、提取内容或执行可重复的 QA 检查

符合以下条件时，选择 local_shell：

• 任务需要使用用户实际的本地浏览器状态
• 任务依赖本地 Cookie、本地身份验证、本地扩展程序或本地浏览器配置文件
• 需要使用在用户计算机上发现的配置文件
• 浏览器操作必须在用户的计算机上进行，而不是在隔离的沙盒中进行

本地与沙盒浏览器控制的区别

本地 Shell 浏览器控制：

• 在用户实际使用的计算机上运行
• 使用持久化的 ~/.notis-agent-browser/main 配置文件
• 在多次运行间复用 Cookie 和已保存的状态
• 依赖已连接的 Notis 桌面 Shell 桥接程序

沙盒 Shell 浏览器控制：

• 在隔离的 Cloud Computer 中运行
• 每次运行时 Cookie 均为空
• 无法访问用户的真实浏览器配置文件、主机密钥链、本地 Cookie、本地标签页或本地扩展程序
• 可以通过 Notis 的 Portal 登录链接工具进行身份验证；其他网站则使用 1Password Service Account 流程、每项任务专用的凭据或已配置的状态
• 对一般 Web 自动化来说更安全，也更易复现
• 对可重复的 QA、网页抓取、屏幕截图和公开应用测试来说是默认选择

反模式

• 不要自行编造配置文件路径。每次 Notis 运行都使用 ~/.notis-agent-browser/main。
• 不要在没有 --profile 的情况下运行任何 agent-browser 命令。守护进程可能会悄悄重启，并使用另一个空配置文件。
• 自动化运行结束时，或用户刚登录后，切勿跳过 agent-browser state save。
• 不要操控用户的真实 Chrome 配置文件，不要复制其默认配置文件，也不要连接 9222 端口来访问其主浏览器。Chrome 136+ 会阻止此操作，而且这会危及用户正在使用的会话。
• 不要假定沙盒浏览器可以访问本地身份验证状态。
• 使用 CLI 前，切勿跳过 agent-browser skills get core --full。

启动浏览器前，请先阅读 profile-and-state；保留规范配置文件，并在最后保存状态。然后加载本地或沙盒指南，默认情况下不要同时加载两者。命令语法请参阅实时 CLI 帮助，不要不必要地加载通用示例。

任务指南

请仅阅读此技能包中完成当前任务所需的指南。

• 对于经过身份验证的 Notis Spaces、报告和文档，请参阅notis-spaces 技能中的通用阅读 指南（托管指南：notis://docs/notis-spaces/references/reading.md）。Notis 登录 链接在沙盒中也能使用；无需本地 Cookie 或凭据。
• 嵌入式 Agent 浏览器技能
• 规范的 Notis 配置文件和状态持久化
• 本地 Shell 浏览器控制
• 沙盒 Shell 浏览器控制