Skip to content
项目

alibaba/qz-browser-agent

在 GitHub 查看

alibaba/qz-browser-agent has 221 GitHub stars and 33 forks. GitHot measured 0 stars in 24 hours, +10 in 7 days, and +61 in 15 days. Last checked 2026-11-15 14:12 UTC. Last push 2026-11-14.

这些数字如何统计

实测星标增长

24小时
0
7天
+10
15天
+61
1个月
更新延迟

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

Local-first AI agent for Chrome: browser automation, web research, and data extraction with your own model.

人工智能

README.zh-CN.md

原文

qz logo

轻舟(qz)

English · 简体中文 · 官网

开源、本地优先的浏览器 Agent

支持任意模型 · 调研 · 自动化 · 数据提取

Chrome Web Store npm License Developer checks

轻舟(qz)是一个运行在你浏览器里的开源浏览器 Agent(Chrome 扩展)。一句话描述任务,它就会在你已登录的网站上自动操作、提取数据,交付表格、文件或带出处的报告。可接入 DeepSeek、OpenAI、Claude 等任意模型,用自己的 API Key,数据留在本地,只发给你选的模型;Grok Bot、Claude Code、Codex 等 Agent 也能通过 CLI 和 MCP 把网页任务交给它。

在 Chrome 应用商店获取

npx skills add alibaba/qz-browser-agent -g

轻舟从 Wikipedia 采集杭州照片

https://github.com/user-attachments/assets/3203bc89-ef26-4f66-86cc-b602a912a1ab

为什么用轻舟?

解决 Agent 网页交互的“最后一公里”

通用 AI Agent 并不擅长复杂的浏览器操作,遇到登录墙、连续点击或异步翻页极易中断。轻舟相当于为你的 Agent 挂载了一个真实的本地 Chrome,在真实环境里跑完复杂流程,再将干净的结果返回。

透明可见,人与 Agent 协同

其他 browser agent 大多能看到执行过程,但中途很难介入,而且要么只给人用,要么只给 Agent 用。轻舟常驻在浏览器侧边栏,每一步操作和结果都清晰可见,你可以随时介入或停止。同时,Claude Code、Codex 等 coding agent 也能通过 CLI 和 MCP 直接向轻舟下发任务。

并行多任务调研,从网页数据到可复用 Skill

告别在十几个标签页之间反复横跳与手动清洗数据。轻舟可以同时运行大量任务,每个任务还能派生子任务分头执行,把单个 browser agent 难以完成的大规模调研拆开并行推进。面对分散在不同网站、结构混乱的网页信息,轻舟能跨站点自动提取你需要比对的参数,并附带来源链接;将异构的网页内容直接整理为标准化的对比视图或本地文件,无缝接入你的分析流。跑通的流程还能直接沉淀为 Skill,下次只需一句话即可复用。

原生浏览器环境,数据纯本地留存

告别繁琐的虚拟环境配置。轻舟直接调用你日常使用的 Chrome,现有的登录状态、Cookie 和扩展程序即插即用。任务数据完全存储在本地,底层大模型由你自主配置,安全可控。

可以让轻舟做什么

从一个简单的任务开始

规划 3 天杭州文化漫游,串联西湖、博物馆与历史街区。查阅文旅部门和场馆官网,核对开放时间、门票与预约要求,整理每日路线表并附来源,未核实处标明。

多来源收集,自动开启目标模式。

多来源信息整理

对比最近 6 个月发布的主流开源大模型,每行一个模型:发布日期、参数量、上下文长度、协议、主要基准成绩,附官方来源。

将信息整理至数据表中。

跑通一次,一句话存成 Skill

找 arXiv 上最近一个月关于 browser agent 的 10 篇论文,整理标题、一句话结论和链接。

跑通后说一句“保存为 Skill”,下次只要说“本周的 browser agent 论文”就能复用。

多任务并行调研

找出 GitHub 上本周 star 涨得最快的 10 个 AI agent 项目,读完 README,写一份带链接的周报。

让你的 Agent 把任务交给轻舟

在 pi 等编程 Agent 里说:

用轻舟查本周 GitHub 上最火的 AI agent 项目,整理成周报发给我。

快速开始

  1. 安装扩展:前往 Chrome 应用商店点击添加至 Chrome,完成后点击浏览器工具栏上的轻舟图标,唤起侧边栏。

  2. 接入模型:进入设置,选择模型服务商(如 DeepSeek、Claude),填入 API Key 并保存。若已有 ChatGPT 账号,可直接选择 OpenAI Codex 登录,免填 Key。

    轻舟设置页:选择服务商并填入 API Key
  3. 运行任务:在侧边栏输入你的指令,例如:

    查今年诺贝尔奖各奖项得主,整理成带来源链接的表格。
    
  4. (可选)接入其他 Agent:在终端运行 npx --yes qz-browser-agent@latest connect,即可让外部 Agent 调用轻舟。详见 让你的 Agent 更会用浏览器。

无法访问 Chrome 应用商店?手动安装
  1. 下载最新版本中的 ZIP 安装包并解压。
  2. 打开 chrome://extensions,启用开发者模式。
  3. 点击加载已解压的扩展程序,选择解压后的 qz-browser-agent-extension 文件夹。
  4. 打开侧边栏,按上面的说明配置模型。

让你的 Agent 更会用浏览器

Grok Bot、Claude Code、Codex、pi 等 Agent 遇到网页任务时,可以把它交给轻舟。轻舟在你的浏览器侧边栏里执行,过程看得见,结果再交回给 Agent,让它接着往下做。

  1. 安装 Skill:让你的 Agent 学会怎么调用轻舟。
    npx skills add alibaba/qz-browser-agent -g
    
  2. 配对一次:需要 Node.js 22 及以上版本,运行后会自动在你的默认浏览器里完成配对。
    npx qz-browser-agent@latest connect
    
  3. 直接吩咐:跟你的 Agent 说“用轻舟对比最近 6 个月发布的开源大模型,整理成带来源的表格”。
直接用 CLI 或 MCP
npx qz-browser-agent@latest create "你的任务" --stream
  • --stream 会实时显示任务进展、需要你回答的问题和最终结果。
  • 用 MCP 客户端的话,配对后运行 npx qz-browser-agent@latest mcp,填入它返回的 HTTP 地址即可。
  • 经常使用的话,可以运行 npm install --global qz-browser-agent 全局安装,之后用 qz 代替 npx qz-browser-agent@latest。
  • 多浏览器配对、追问、导出等用法见 CLI 与 MCP 参考。

与同类项目对比

轻舟 Nanobrowser Browser Use agent-browser Playwright MCP
整个任务交给它,不用一步步指挥 ✅ ◐ ◐ ◐ ❌
直接用你已登录的 Chrome ✅ ✅ ◐ ◐ ◐
实时掌控每一步,人和 Agent 都能用 ✅ ◐ ◐ ◐ ◐
多任务并行,每个任务还能拆子任务 ✅ ◐ ◐ ◐ ◐
跑通的流程存成可复用的 Skill ✅ ❌ ◐ ❌ ❌

✅ 内置支持 · ◐ 部分支持或需配置/写代码 · ❌ 不支持。截至 2026 年 10 月,依据各项目公开文档。

本地优先

轻舟完全运行在你的浏览器里。会话、Skill 和采集的数据都保存在本地,CLI/MCP 桥接服务同样运行在你的本机上。轻舟没有后台服务器,数据只会发给你配置的模型,以及任务直接访问的网站。

详见隐私政策与浏览器权限。

常见问题

轻舟免费吗?

扩展和 CLI 按 Apache-2.0 免费提供。模型费用取决于服务商,也支持兼容的本地模型。ChatGPT 的权限和额度取决于你的账号及套餐。

怎么用 ChatGPT 账号登录?

在设置中选择 OpenAI Codex,按设备码提示在 auth.openai.com 完成登录。回到轻舟,选择模型并保存。如果设备码登录未启用,请按 OpenAI 的认证说明操作。

支持哪些模型?

支持协议兼容且具备工具调用能力的服务商,包括兼容的本地模型服务。预设包括 OpenAI Codex、OpenRouter、DeepSeek、Kimi For Coding、OpenCode Go、OpenCode Zen 和 Fireworks AI 等。详见服务商文档。

支持 Edge 或 Firefox 吗?

发布版本运行在 Chrome 和 Edge。Firefox 尚未发布。开发时的临时加载见 在 Firefox 中临时加载。与 Chrome 仍有差异的行为见 Firefox 与 Chrome 的差异。API 调查见 Firefox 能力差。

开发

需要修改轻舟的行为或检查其运行方式时,可以在本地构建并加载扩展。

从源码构建

安装 Node.js 24 LTS 和 npm,然后在本地仓库中运行:

npm ci
npm run build

打开 chrome://extensions,启用开发者模式,点击加载已解压的扩展程序,选择 dist/extension/。 在 Firefox 中临时加载同一套源码,见在 Firefox 中临时加载。

开发与测试

完成测试环境配置后,使用以下命令:

npm run dev             # 源码变更后自动重新构建
npm test                # 运行默认测试
npm run verify          # 类型检查,并运行共享测试
npm run verify:chrome   # 加载 dist/extension/ 的 Chrome 套件
npm run verify:coverage # 共享套件、Chrome 套件,以及覆盖率门禁

重新构建后,在 chrome://extensions 中重新加载扩展,并重新打开侧边栏。

添加能力包

想添加轻舟还没有的工具、视图、设置或服务商,见能力包指南。

更多文档

许可证

复用或分发时,请遵循 Apache-2.0 及第三方依赖各自的许可证,详见 THIRD_PARTY_NOTICES.md。


两岸猿声啼不住,轻舟已过万重山。
—— 李白《早发白帝城》