GitHub 收藏详解 · 官方资料解读
qz 浏览器 Agent 详解：在自己的 Chrome 中研究、采集与复用任务
用途、核心机制、上手路径与使用边界
来源：alibaba/qz-browser-agent · alibaba
I
用户问题
定位与适用任务网页研究经常同时需要登录状态、跨站导航、动态内容和来源整理。qz 把 Agent 放进日常浏览器侧栏，让用户观察执行过程，也让外部编程 Agent 通过 CLI 或 MCP 委派整项网页任务。它的关键选择是复用本地浏览器环境，而不是要求用户另外建立一个远程浏览器。
- 跨网站整理带来源的研究表格
- 利用已有登录态完成可见网页任务
- 把重复调研保存为可复用 Skill
* * *
II
产品机制
能力与工作方式- 侧栏与后台职责分离架构文档中，Background 保存任务状态和持久数据，Side Panel 负责展示，Content script 读取与操作页面。界面关闭、任务状态和模型调用属于不同层，排错时应分别检查。 原文
- 委派目标而非逐次点击外部 Agent 可以提交完整目标，再通过流式观察获取进展、待回答问题与最终结果。CLI 和 MCP 是连接入口，实际执行与持久化仍在扩展中。 原文
- 成功流程可以沉淀完成任务后，可以要求保存为 Skill，下次通过简短请求复用流程。保存前应先确认来源选择、字段定义和失败处理，避免把一次偶然成功的操作当成稳定规则。 原文
- 本地状态与模型请求分开看会话、技能和采集数据保存在本机，用户选择模型提供方。浏览器本地运行并不意味着推理全程离线；任务相关内容仍可能发给配置的模型和访问的网站。 原文
* * *
III
使用流程
从最小任务开始- 装好扩展从 README 的商店入口安装，打开侧栏并阅读首次数据说明。先用公开网页建立基线，再接入需要登录的工作。
- 配置模型在 Settings 选择支持工具调用的模型提供方并完成认证。先让它读取单页并返回标题和来源，确认模型与页面执行两条链路都正常。
- 限定交付内容给出需要比较的对象、字段、时间范围和来源要求。要求无法确认的值留空或标记，不让 Agent 用猜测填满表格。
- 复查后连接外部 Agent确认侧栏任务可完成后再配对 CLI，检查流式结果与表格来源。只有经过复核的流程才保存为 Skill。
以下试用顺序与检查方法是编辑建议；命令入口依据官方文档，本文未运行项目。 原文
官方入口示例
npx qz-browser-agent@latest connect
npx qz-browser-agent@latest create "Compare the official feature pages of two tools and return source links" --stream请先完成上文前置配置；示例不包含真实凭据。
* * *
IV
边界与限制
约束与选用判断| 边界 | 具体含义 | 使用建议 |
|---|---|---|
| 浏览器版本差异 | README 对 Chrome、Edge 和 Firefox 的发布与开发状态分别说明。 原文 | 按当前平台说明选择安装包，不把临时加载当成正式商店发布。 |
| 费用与权限 | 扩展许可与模型调用费用是两回事，网页任务使用的是浏览器当前可见权限。 原文 | 先限制任务范围；涉及提交或修改的数据应在动作前核对。 |
左右滑动查看完整表格
适合需要真实浏览器上下文的研究与数据整理。如果目标只是抓取公开静态页面，先评估更简单的 HTTP 抓取是否已足够。
* * *
V
怎样判断是否值得采用
试用场景与验收可先比较两个产品的官方功能页，输出功能、限制和来源 URL。要求每个结论能回到具体页面，并单列未验证项。之后再加入登录后的仪表盘内容，观察是否出现权限或页面加载问题。这样的分阶段试用能区分模型理解错误、网站差异和扩展执行错误。
检查任务状态完成、后续问题已处理、导出文件能打开，以及关键单元格与来源一致。返回一个漂亮表格不等于任务已经核实。
资料依据：固定版本 README · 补充官方文档 · 当前仓库。
资料获取时间（UTC）：2026-11-02T07:26:40.908Z；仓库快照提交：1aaa6ee2d1fb。来源日期表示该仓库快照提交时间，并非项目首次发布日期。
* * *
编者评论
这篇文章，如何判断
阅读价值
任务入口、可见执行和可复用 Skill 的关系很明确，架构文档也说明了状态归属，便于理解失败发生在哪一层。
保留意见
未运行扩展或独立验证作者的竞品比较表；本文只解读官方能力和边界。网站改版与模型选择都会影响成功率。 试用案例和验收方法是编辑建议。评级衡量资料参考价值，不是产品性能评分。
可迁移启发
网页自动化的可复用单元应包括来源规则和验收规则，而不只是点击顺序。把“哪些信息无法确认”保留下来，也是一种可靠交付。
原文摘录