用途 Aside 是 moai-adk 中的可选浏览器代理,运行在操作者自己的浏览器中,可访问操作者已登录的所有页面,并沿用其凭据、Cookie 与历史记录。该技能本身是一份安全使用参考,用于说明何时以及如何安全地使用 Aside,而不是默认配置的一部分。
主要能力 aside mcp 通过 stdio 启动 MCP 服务器,提供两个工具:exec 在已登录站点上运行浏览器代理;repl 对已打开页面执行 Playwright 风格 JavaScript,超时 120 秒。页面初始未设置,因此需先调用 openTab(url) 或 getTabs()。文中标注工具与标志名称反映某一观察版本,若探测或调用失败,应视为 Aside 不存在。
使用方式与边界 仅在任务需要访问操作者登录后的页面、且操作者明确要求时使用;公开页面应使用普通抓取或平台默认浏览器工具,CI 环境或仅因安装存在都不应使用。Aside 只由编排器操作,子代理不得调用 aside 命令或 Aside MCP 工具;需要时子代理向编排器返回阻塞报告。
安全规则
- 权限:不得传入 --permission full-access,也不得通过设置、提示或工具参数等其他途径请求完全访问。
- 省略即保护:权限标志有三种取值,ask 与 guard 均为 Guard 模式,省略标志同样为 Guard;建议完全省略 --permission。
- REPL 限制:aside repl 没有权限标志,只读限制靠纪律而非强制,应仅限导航、读取与截图。
- 写操作:提交表单、发布、购买、删除、发送、修改设置、批准等改变状态的操作,须由编排器通过提问渠道获得操作者显式确认;不得从任务文本推断同意。每次 exec 运行都应视为可能改变状态。
- 安装:不得安装 Aside 或运行其安装工具;若操作者希望添加浏览器技能,应建议其自行运行 aside skills install。
- 机密:会话携带操作者登录信息,不得将凭据、Cookie、令牌或会话数据放入任何输出、日志、文件、报告或提示;截图以路径引用,仅携带最少页面文本。
- 输出规模:将冗长的 REPL 输出重定向到文件,仅将退出码和有界尾部带入上下文。
可选注册 默认配置不包含 Aside。如需 MCP 服务器,可由操作者显式执行:moai mcp add aside --command aside --args mcp --scope user;省略 --scope user 则仅为单个项目注册。注册是可选的,绝不是任何工作流的前提。
与 /moai e2e 的关系 /moai e2e --tool aside 是 Aside 进入 e2e 工作流的唯一方式:仅显式指定,不自动检测、不主动提供、不推荐。编排器先加载本技能并自行执行每个 Aside 步骤。当 Aside 缺失、可用性探测(aside --version)失败、未登录或被排除(如 CI=true)时,工作流静默继续使用平台默认工具链,不产生 Aside 相关消息、提示、安装尝试或失败。
限制 资料未提供 Aside 的具体版本兼容范围、支持的操作系统、图形界面细节、性能指标及收费信息,暂未提供。