首页/新闻资讯/正文详情

Expect架构全景图:Supervisor、Agent、Browser、Cookies五大核心包如何协作

发布时间:2026/9/27 6:14:36 来源:云帆数科 栏目:资讯中心
Expect架构全景图:Supervisor、Agent、Browser、Cookies五大核心包如何协作
Expect架构全景图Supervisor、Agent、Browser、Cookies五大核心包如何协作【免费下载链接】expectExpect tests your agents code in a real browser项目地址: https://gitcode.com/gh_mirrors/expect6/expectExpect 是一款让 AI 编程代理在真实浏览器里测试自己代码的开源工具它读取你的 Git 变更、自动生成测试计划并用 Playwright 在真实浏览器中执行检查性能、安全、设计与完整性问题再报告给代理去修复。下面从架构视角拆解 Expect 的五大核心包——supervisor、agent、browser、cookies、shared 各自负责什么以及它们如何协作完成一次完整的测试。一、Expect 是什么一条命令的浏览器测试和 Puppeteer、Cypress 等工具需要你手写脚本、维护选择器不同Expect 的定位是给代理装上 QA 超能力读取代码变更自动分析 unstaged、分支 diff 或指定 commit生成测试计划把变更转成可执行的测试步骤真实浏览器执行用 Playwright CDP 驱动真实 Chrome还能注入你系统浏览器的 Cookie模拟已登录的真实用户报告驱动修复把发现的问题交还代理修复后重跑验证二、整体架构一个仓库分工明确Expect 是一个 pnpm monorepo配合 turbo 做构建编排通过 pnpm-workspace.yaml 定义了packages/*与apps/*两组工作区位置内容角色packages/supervisor/expect/supervisor总指挥编排整个测试流程packages/agent/expect/agent代理桥统一接入各家编码代理packages/browser/expect/browser浏览器引擎自动化 快照 MCPpackages/cookies/expect/cookies身份注入提取真实浏览器 Cookiepackages/shared/expect/shared公共底座模型、提示词、工具函数apps/cli/Expect CLI终端交互入口Ink 界面packages/typescript-sdk/expect-sdk面向开发者的编程 SDK依赖关系呈现出清晰的分层结构supervisor 依赖 agent 与 browseragent 依赖 browserbrowser 依赖 cookies而 shared 不依赖任何业务包是所有包的公共底座。三、supervisor编排全流程的总指挥supervisor 包packages/supervisor/package.json是整个系统的调度中心核心组件包括Executorexecutor.ts执行引擎。先通过 Git 服务收集当前分支、变更文件、diff 预览与近期提交再构造执行上下文驱动代理按计划逐条执行测试步骤Plannerplanner.ts把代码变更翻译成结构化测试计划TestPlanReporterreporter.ts汇总每步结果输出最终测试报告Git / Githubgit/git.ts分支、diff、提交等 Git 操作封装Watchwatch.ts持续监听模式代码变更时自动评估并触发测试FlowStorageflow-storage.ts保存与复用测试流程flow支持-f slug快速重跑你可以把它理解为项目经理自己不写测试但知道每一步该让谁做什么。四、agent打通各家编码代理的统一桥Expect 支持 Claude Code、Codex、GitHub Copilot、Gemini CLI、Cursor、OpenCode、Factory Droid 等多家代理。agent 包packages/agent/package.json通过ACPAgent Client Protocol实现了统一抽象detect-agents.ts扫描PATH自动检测本机安装了哪些代理支持-a provider手动指定acp-client.ts与代理建立 ACP 会话流式接收执行事件与用量信息agent.tsAgent服务的核心实现向上暴露统一的流式接口这样 supervisor 无需关心背后到底是哪个代理换一家代理只需换一个后端实现架构上的可插拔性就来自这里。五、browser真实浏览器自动化的核心browser 包是 Expect 的手脚基于 Playwright 提供真实 DOM 级自动化而非截图坐标的计算机使用路线Browser 服务browser.ts启动/连接 Chromeheaded 或 headless创建页面并执行点击、输入等动作CDP 自动发现cdp-discovery.ts可接管一个已打开的 Chrome 实例--cdp或--profile复用现有配置文件快照与 Diffdiff.ts把页面压缩成带引用编号的可读树状快照并对比两次快照找出变化让代理能看懂页面MCP 服务mcp/server.ts、mcp/start-http.ts把浏览器能力封装成 MCP 工具供各类代理按需调用文档见 docs/mcp.md可视化 Overlayruntime/overlay/用 React 在页面上渲染光标、操作标记与进度让测试过程看得见六、cookies让测试用户变成真实用户很多 Bug 只在登录态下出现。cookies 包packages/cookies/负责从你的系统浏览器中提取真实 Cookie 并注入到测试浏览器中浏览器检测browser-detector.ts自动发现本机安装的 Chrome、Firefox、Safari 等及其配置Chromium 系读取chromium.ts解析 SQLite Cookie 库并完成解密CDP 通道cdp-client.ts通过 CDP 直接从运行中的浏览器拉取 Cookie一键提取cookies.ts统一入口browser 包在执行前调用它完成身份注入CI 场景下可用--no-cookies或--ci跳过该步骤无头运行、自动确认计划。七、shared五大包脚下的公共底座shared 包被其余所有业务包依赖提供约定与通用能力模型定义models.tsTestPlan、执行事件等跨包共享的数据结构提示词工程prompts.ts构造规划与执行阶段给代理的提示词浏览器容量估算estimate-browser-capacity.ts根据系统内存估算可安全开多少个浏览器实例可观测性与分析observability/、analytics/链路追踪与遥测八、端到端协作一次测试是怎么跑的把五个包串起来一次典型的/expect运行流程如下CLI 入口apps/cli/ 的终端界面解析参数变更范围、代理、目标 URL、浏览器模式上下文收集supervisor 的 Executor 调 Git 拿到分支、变更文件与 diff 预览规划Planner 把变更翻译成测试计划展示给用户确认-y可跳过执行agent 包建立 ACP 会话代理借助 browser 包的 MCP 工具逐步操作真实页面如需登录态cookies 包已提前注入身份报告与修复Reporter 汇总失败项代理修复代码后自动重跑验证直到通过整个链路中supervisor 出题、agent 做题、browser 动手、cookies 提供身份、shared 提供规则——职责边界干净这也是它容易扩展新代理、新浏览器能力的根本原因。九、上手指南三步体验 如果你想在本地跑起来git clone https://gitcode.com/gh_mirrors/expect6/expect cd expect pnpm install安装技能按官方说明让代理拉取 Expect 页面并执行初始化脚本启动测试在 Claude Code、Codex 等代理中输入/expect看它工作代理生成计划 → 真实浏览器逐步执行 → 发现问题并自动修复重验小结Expect 的架构精髓在于分层清晰——supervisor 编排、agent 适配、browser 自动化、cookies 注入身份、shared 统一约定五包各司其职又通过 Effect 依赖注入紧密协作把让 AI 代理在真实浏览器里验收自己的代码变成了一条命令的事。【免费下载链接】expectExpect tests your agents code in a real browser项目地址: https://gitcode.com/gh_mirrors/expect6/expect创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关推荐

网站被黑挂马别慌,找对企业网络托管公司从零搭建
网站被黑挂马别慌,找对企业网络托管公司从零搭建

网站被黑挂马别慌,找对企业网络托管公司从零搭建 凌晨两点,你盯着后台突然飙升的恶意流量,页面满屏的博彩广告,心里直冒冷汗:网站被黑挂马不知道怎么办?别急,这不仅是技术问题,更是架构漏洞。很多老板以为买个域名、找个人写几行代码就算完事,结果从… · 2026/9/27 6:14:24

底层能力:AI时代职场转型中真正保值的关键竞争力
底层能力:AI时代职场转型中真正保值的关键竞争力

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 6:14:17

外贸企业网络专线选型与落地实战指南
外贸企业网络专线选型与落地实战指南

摘要: 本文从外贸企业跨境网络的实际痛点出发,系统梳理了网络专线选型的完整思路。文章首先分析了跨境网络问题的成因,对比了普通宽带与企业专线的本质区别;随后指出带宽并非越大越好,应结合业务类型与并发量合理规划。… · 2026/9/27 6:14:11

给窗帘做网站常见报错与解决
给窗帘做网站常见报错与解决

给窗帘做网站多少钱?别被模板坑,教你3步搞定 模板网站太丑,客户根本看不下去。 你花大几千买的模板,往窗帘店里一放,显得廉价且过时,转化率惨不忍睹。很多老板问: 给窗帘做网站多少钱?… · 2026/9/27 6:51:50

西宁高端网站建设到底多少钱?揭秘3万到10万的差距
西宁高端网站建设到底多少钱?揭秘3万到10万的差距

西宁高端网站建设到底多少钱?揭秘3万到10万的差距 网站做好了没人访问,这是最让人头秃的事。花几万块建了个“漂亮”的官网,结果后台数据惨淡,连个询盘都没有。很多西宁的老板问,高端网站建设到底 多少钱… · 2026/9/27 6:51:44

LoRA先融合再量化:Model Optimizer扩散模型量化部署的完整指南
LoRA先融合再量化:Model Optimizer扩散模型量化部署的完整指南

LoRA先融合再量化:Model Optimizer扩散模型量化部署的完整指南 【免费下载链接】Model-Optimizer A unified library of SOTA model optimization techniques like quantization, distillation, pruning, neural architecture search, speculative decoding, etc. I… · 2026/9/27 6:51:32

IDEA+mybatis实现增删改查(CURD)
IDEA+mybatis实现增删改查(CURD)

目录0.前言1.具体操作0.前言 操作mybaits和mysql进行增删改查是必备的一步,今天写一篇文章简单记录一下mybatis的增删改查操作。 本文源代码下载地址, (1)百度网盘 通过网盘分享的文件:demo-mybiats-curd.zip 链接: … · 2026/9/27 6:51:32

一文讲透|2026年实测靠谱的专业AI论文网站
一文讲透|2026年实测靠谱的专业AI论文网站

2026年AI论文写作工具已从“基础生成”升级为具备学术合规性与智能优化能力的全流程助手,核心评价维度涵盖文献真实性、格式合规性、长文本逻辑、查重降重、AIGC合规等关键指标。本次测评覆盖6款主流工具,涵盖中英文论文、全流程与专项功能、免费与付费版… · 2026/9/27 6:51:32

洛谷题解:AT_pakencamp_2023_day3_d GCD
洛谷题解:AT_pakencamp_2023_day3_d GCD

1.前言 这是作者第一次把洛谷上的题解搬到这里来,想要享受更好的体验效果? 请点击这里 2.正文 思路 题目说让所有连续区间的最大公约数都互不相同,在互不相同的这个条件下,我似乎只能想到质数。 题目又说输出长度为 的 数… · 2026/9/27 6:51:26

MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现
MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现

简介:这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程,从线性调频(LFM)信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑,面向电子信息工程、计算机、数学等专业学生,适用于课程设计、期末大作… · 2026/9/27 0:00:01

汕头网站建设制作厂家避坑指南:5大注意事项救急
汕头网站建设制作厂家避坑指南:5大注意事项救急

汕头网站建设制作厂家避坑指南:5大注意事项救急 改个需求建站公司拖一周,这种憋屈事我见得太多了。 很多汕头老板找本地建站团队,签合同前看着方案挺美,一上线就变脸。 今天不聊虚的,直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01

多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习
多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习

简介:基于PyTorch的多模态虚假新闻检测项目完整代码包,面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者,解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征,以Res… · 2026/9/27 0:00:01

MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现
MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现

简介:这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程,从线性调频(LFM)信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑,面向电子信息工程、计算机、数学等专业学生,适用于课程设计、期末大作… · 2026/9/27 0:00:01

汕头网站建设制作厂家避坑指南:5大注意事项救急
汕头网站建设制作厂家避坑指南:5大注意事项救急

汕头网站建设制作厂家避坑指南:5大注意事项救急 改个需求建站公司拖一周,这种憋屈事我见得太多了。 很多汕头老板找本地建站团队,签合同前看着方案挺美,一上线就变脸。 今天不聊虚的,直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01

多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习
多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习

简介:基于PyTorch的多模态虚假新闻检测项目完整代码包,面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者,解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征,以Res… · 2026/9/27 0:00:01

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码