huashu-chrome · 让 AI agent 开你自己的 Chrome

它到底是什么

SEC.01 · PARTS LIST · 器官清单

「npm 包？插件？CLI？还是 MCP？——都是。它们是同一个产品的五个器官。」

REF	器官	是什么	一句话职责
01	npm 包	分发载体	npx huashu-chrome install 一条命令装完一切
02	CLI	包的入口	三个动词：install（装扩展+写好各家 agent 的 MCP 配置）/ mcp（见下）/ doctor（体检）
03	MCP server	agent 的接口	huashu-chrome mcp 被宿主拉起，每个会话一个进程，通过 stdio 把 22 个浏览器工具递给 agent
04	本地桥 bridge	本机路由器	127.0.0.1 常驻单例：token 认证、站点白名单裁决、每条命令审计落盘；多个 agent 会话共享一条桥
05	Chrome 扩展	手	住在你日常的 Chrome 里，带全部登录态干活；offscreen 文档保活的 WebSocket 连桥

一条命令的旅程

SEC.02 · FIG.1 · SIGNAL TRACE · 信号追踪

以 agent 说「点击登录按钮」为例，8 站：

SIGNAL TRACE — tool:click方向：AGENT → 页面 → AGENT

01AGENTagent（Claude Code/Codex…）吐出工具调用 click

02MCP SERVER→ stdio → MCP server（本会话专属进程）

03本地桥→ WebSocket + token → 本地桥

04本地桥桥裁决：站点在白名单吗？→ 审计落盘 → 盖上会话身份章（sid）

05扩展→ WebSocket → Chrome 扩展（offscreen 常连，Service Worker 被唤醒）

06页面扩展在页面里定位元素、检查遮挡，派发真实点击

07页面采集「效果证据」：页面到底动没动（DOM/焦点/目标状态）

08AGENT快照原路返回 agent——它看到的不是「已点击」，是「点击之后页面变成了什么样」

NOTE / 注脚全程 127.0.0.1，一个字节都不出网；掉线自愈（桥重启、扩展重载、SW 回收都设计过）。

你看得见它在干活

SEC.03 · FIG.2 · 可见性 · 差异化卖点一

花叔A 小红书后台你自己的其他标签…

B 需要人帮忙：验证码 / 扫码 / 付款确认

正在做什么

准备做什么

多 agent 并发不打架

SEC.04 · FIG.3 · 会话隔离 · 差异化卖点二

每个会话有自己的受控标签页和会话色；想抢别人正在操控的页面会被拦下并给出三条出路。两个 agent 踩同一页时，边框变双色条纹——「你们在互相踩」一眼可见。

会话身份色板
identity.js a855f7 22c55e 3b82f6 f97316 ef4444 eab308

花叔会话 A

会话 A · 自己的受控标签页

花叔会话 B

会话 B · 互不越界

双色条纹＝「你们在互相踩」

FIG.3 — 会话色描边（左、中）与冲突告警条纹（右）

它越用越快

SEC.05 · 效率与安全 · 差异化卖点三

EXEC / 剧本

act 剧本

翻页 repeat、可选弹窗 if、状态断言 assert——一次调用跑完整个流程（实测归因：浏览器执行只占墙钟 2%，98% 是 agent 回合，省回合=省时间）

■ 浏览器执行 2%▨ agent 回合 98%

MEM / 经验回流

learnings 经验回流

摸过一次的网站沉淀成笔记甚至可执行剧本。真实数字：飞书多维表格从零摸索 281 次调用，规律摸清后同类任务不到 10 次

281 → <10调用次数 · 同类任务实测

LOCK / 硬闸

敏感操作的闸

敏感操作的闸在扩展里，agent 够不着：支付确认必须真人点头，没有任何参数能跳过

HUMAN ONLY
无参数可跳过

上手

SEC.06 · QUICK START · 三步

$ npx huashu-chrome install

# 装扩展引导 + 自动写好 MCP 配置

$ # 重启你的 agent

› 帮我看看小红书后台这周的数据

1npx huashu-chrome install（装扩展引导+自动写好 MCP 配置）
2重启你的 agent
3直接说人话：「帮我看看小红书后台这周的数据」

脚注：MIT 开源。