从终端调试运行中的浏览器扩展

​

启用

# 只读模式始终开启。加上控制开关以对扩展执行操作：
pnpm extension dev --allow-control

# 再加上 eval 以在某个上下文中执行任意表达式：
pnpm extension dev --allow-control --allow-eval

​

你可以做什么

​

指定上下文

​

示例：我的后台处理器到底有没有运行？

pnpm extension eval "globalThis.__lastSyncAt" --context background --allow-eval

{ "ok": true, "value": 1718000000000 }

​

跨浏览器支持

​

安全性

• 观察无需任何开关。 读取日志和 DOM 始终可用。
• 有边界的操作需要 --allow-control。 storage、reload 与 open 会改变状态，因此你需要按会话主动开启。
• eval 需要 --allow-eval 以及一个按会话生成的 token。 该 token 写入 dist/ 之外的一个 0600 文件中，因此绝不会随构建产物发出——本地随机进程无法悄悄驱动你的 service worker。
• 任何东西都不会进入生产环境。 控制通道只在 dev / preview 期间存在；它依赖一个不会出现在打包产物中的端口。

​

配合 AI agent

​

下一步

• 触发动作和键盘命令——无需点击即可测试处理器，无头并可在 CI 中运行。
• 同时运行两个 MCP 服务器——Extension.js 控制能力与 Chrome DevTools MCP 并存。
• CI 模板——将这些能力接入 pull request 的检查。