Repository navigation
Releases
v1.1.0
Playwright MCP for Operit v1.1.0
⬆️ 跟上上游
@playwright/mcp0.0.84 → 0.0.85playwright-core→1.66.0-alpha-2026-11-09
这次上游动的东西,手机上大部分摸不到:
--background/--no-tab-group—— 浏览器扩展专属,需要扩展 0.5.0 以上,Operit 用不到browser.contextOptions.locateOnlyVisible—— 新配置项,开启后定位器只看可见元素。默认关browser_snapshot现在会保留容器(对话框、地标、表格)的可访问名称- 表单关联的自定义元素支持
getByLabel了
⚠️ 本版要求 Node.js ≥ 20
之前一直写 >=18,但上游有个容易漏的差异:
@playwright/mcp@0.0.85 engines.node = ">=18"
playwright@1.66.0-alpha engines.node = ">=20" ←
playwright-core@1.66.0-alpha engines.node = ">=20" ←
插件实际跑在上游没承诺支持的环境上。npm 对 engines 不匹配只给 warning 不阻断,所以 Node 18 也许能跑,但没人保证。
这版统一提到 >=20,安装时会直接检查并给出明确提示,不再靠玄学。
🔧 Chromium 还是 1237
上游 0.0.85 配套的是 1254(Chrome for Testing 158.0.8127.18),proot 下 rev1246 以上一启动就是 SIGTRAP,所以继续用 1237。
这次跨度更大,差 17 个 build,特意先验过:
playwright-core 1.66驱动chromium-1237(Chrome 152.0.7977.8),launch 3.1 秒,截图 / 执行 JS / 点击 / 关闭全通- 走真实 MCP 协议:initialize → tools/list → navigate → snapshot → screenshot → evaluate → close,全链路 3.7 秒
tools/list还是 25 个
🩹 15 条修复,挑几个有意义的
- 回滚了 0.0.84 的 aria 可见性过滤:inert 或 modal 对话框外的内容不再被隐藏
- 配置文件里的相对路径改为「相对于源文件」解析
- 页面定时器被节流或暂停时,settle 等待不再挂死 —— 对 Android 后台运行有实际价值
browser_navigate不再把 HTTP 自动升级成 HTTPSbrowser_evaluate支持 BigInt / NaN / Infinity / undefined / 循环对象browser_console_messages的源行号改为从 1 开始
🔒 发布前被外部审查翻出来的 21 处
这版在发出去之前,请另一双眼睛(带故障注入和实跑)把包翻了几遍,累计挖出 21 个问题,全部已修。挑几个值得说的:
P1 · GitHub Actions 脚本注入
issue-notify.yml 把 ${{ github.event.issue.title }} 直接拼进 run: 的 shell 脚本。Issue 标题是外部用户可控的——一个精心构造的标题就能让 Runner 执行任意命令。已改成所有事件字段走 step 级 env:,多行正文用随机 delimiter。
P2 · 升级不是事务性的
原来是 rm -rf 旧目录 && cp -r 新目录。复制中途失败,旧目录没了、新目录只拷了一半、主配置却已更新——一次失败的升级能把原本能用的安装毁掉。
现在是:staging 复制 → 校验关键文件 → 旧目录改名备份 → mv 原子上位 → 失败回滚。INT/TERM 中断也有 trap 兜底还原。
P2 · --keep-deps 三阶段提交
只做「写临时名 + 逐个 mv」还不够——mv 阶段失败会留下新旧混合目录。现在多了备份 .old 并在失败时回滚已替换项。
P2 · 卸载脚本拼错参数会真的执行卸载
bash uninstall.sh --dry-rnu(dry-run 手滑)以前会真的删除主配置条目和运行目录,还打印「卸载完成」。现在未知参数直接 exit 2。
P2 · 主配置根节点是数组时假报成功
JS 数组可以挂命名属性,但 JSON.stringify() 不序列化它们——脚本会打印「✅ 已合并」,文件里什么都没写。现在入库前先校验根节点类型,并且校验提前到任何写入之前。
P2 · 坏 build 拦截能被符号链接绕过
做个 chromium-1237 -> chromium-1300 的符号链接,实际指向 1300 的浏览器就被当成 1237。已改成先 os.path.realpath()。
其余还包括:README 解压目录名、安装器与转发器的 Chromium 探测逻辑不一致、两个 shell 测试没进 CI、zip 内脚本没有执行位、文档日期错位等。
✅ 验证
本地实测
check_consistency FAIL 0 · WARN 0
test_find_chrome 7/7
test_legacy_id_migration 2/2
test_deploy_rundir 9/9
test_keepdeps_rollback 24/24
neg_cases 9/9
install.sh --dry-run exit 0
install.sh --bad-arg exit 2
uninstall.sh --dry-rnu exit 2
CI 三件套 + 三个新增 step 全部纳入 GitHub Actions。
测试只用确定性故障,不依赖 chmod 000 这类权限模拟(root 下不可靠,会得到假绿)。
📦 安装
解压后运行 bash install.sh(脚本已设 755,./install.sh 也行),装过的会自动升级。
完整变更:v1.0.9...v1.1.0
v1.0.9
Playwright MCP for Operit v1.0.9
⬆️ 跟上上游
@playwright/mcp0.0.83 → 0.0.84playwright-core→1.65.0-alpha-2026-10-30
这次上游加的东西挺实用:
browser_tabs多了isolatedContext—— 传个名字就开一个独立的浏览器上下文,cookie 和 localStorage 都是分开的。想同时挂两个账号,不用再反复退登录清缓存了browser_find多了maxResults—— 页面上匹配几十个的时候能限个数,省 tokenbrowser_network_requests多了all—— 页面跳转后之前的请求记录还在,排查接口方便- 新增
--redact-url-params=access_token,code,URL 里的敏感参数能打码。这只是图个方便,别当成安全边界 target放开了写法,JS / Python / Java / C# 四种定位器都能认- 新增
--ignore-roots
🔧 Chromium 还是 1237
上游 0.0.84 配套的是 1252,但 proot 环境里 rev1246 以上一启动就是 SIGTRAP,起不来。
这次特意试了 1237 跟 playwright 1.65 的组合 —— 差 15 个 build,启动、渲染、截图、执行 JS 全都正常。坏 build 拦截逻辑原样保留。
🩹 顺手修的安装脚本问题
跟 0.0.84 没关系,是之前就有的毛病:
- 结构校验失败照样打印「部署完成」 → 现在直接报错退出,退出码非 0
--keep-deps不查版本 → 先比对实际版本,对不上就走常规安装,免得留下旧包让转发器又装一遍- 主配置备份名精确到秒 → 同一秒连跑两次会互相覆盖,现在带上进程号
- 主配置直接覆盖写 → 中途中断会留半截 JSON,改成临时文件 + 重命名
- 参数打错只警告 → 现在拒绝并打印用法,退出码 2
- 非法
PW_MCP_INSTALL_MODE被静默当成local→ 现在明确报错 - 另外 Chromium 探测加了可执行权限过滤,npm 安装前会检查目录是否可写
🔄 插件 ID 统一成 playwrightmcp
这是个老问题了:仓库里的部署脚本一直用 playwright_mcp(带下划线),但 Operit 市场装出来、实机跑的目录都是 playwrightmcp。
结果就是手动跑 install.sh 会装出另一个条目,看起来像「升级了没生效」。
这版统一改了,转发器文件也跟着改名。装过旧版的人升级时,安装脚本会把 mcpServers 和 pluginMetadata 里的旧条目一并清掉,不会两个同时被加载;旧运行目录不自动删,只提示一句。
✅ 验证
- CI 三件套全绿(一致性自检 / 单元测试 / 负例回归)
- 本机实测:升级 → 重启 MCP → 25 个工具在线 →
browser_find(maxResults=1)只回一条、browser_tabs(isolatedContext="test-ctx")建出来的 tab 带标注,两个新参数都按预期工作 - 新增一条迁移回归测试,直接跑
install.sh里的真实合并逻辑,不是另写一份
📦 安装
解压后运行 ./install.sh,装过的会自动升级。手动装也行:npm i -g @playwright/mcp@0.0.84
完整变更:v1.0.8...v1.0.9
v1.0.8
Playwright MCP for Operit v1.0.8
⬆️ 上游同步
- 适配
@playwright/mcp0.0.82 → 0.0.83(上游 8 项 bugfix:browser_find正则/文件名支持、navigate/reload 遇对话框报错、下载中关闭浏览器防崩、wait_for超时明示等) playwright-core同步1.64.0-alpha-1790635538000
🛡️ 可靠性增强(四轮外审迭代·20 项意见闭环)
- 新增已知坏 build 拦截:
KNOWN_BAD_BUILD_MIN=1246—— 选中 proot 必崩的 rev1246+ 时拒绝启动(不再静默 SIGTRAP;自动下载路径同样拦截) - 本地包版本校验:
@playwright/mcp版本与期望不符时自动校准安装(支持PW_MCP_VER升级/降级/回滚) - 损坏包防护:cli.js 大小校验 + 安装后版本复核
- 日志完善:全路径来源打印、异常分支明示
📄 文档
- README / DEPLOY / TROUBLESHOOTING / CHANGELOG / market 全部同步 v1.0.8
✅ 验证
- CI 三件套全绿(一致性自检 / 单元测试 / 负例回归)
- 本机全链路实测:升级 → 重启 MCP → 25 工具在线 → navigate / snapshot / screenshot / wait_for / close 全通过
📦 升级安装
解压后运行 ./install.sh(会自动处理旧版校准升级);或手动:npm i -g @playwright/mcp@0.0.83
完整变更:v1.0.7...v1.0.8
v1.0.7
v1.0.7 · 2026-09-23
本版主要来自社区反馈(感谢 @bingfengcxl-crypto 的两条 issue)。
🐛 修复:自动下载 Chromium 必然失败
install chromium→install-browser chromium
@playwright/mcp@0.0.82的 cli.js 只把install-browser映射给下游 Playwright;
直接传install chromium会被顶层解析器拒掉(too many arguments: install, chromium)。
受影响 5 处:转发器下载调用、docstring、两处提示文本、DEPLOY 表格。
※ 本机已有 Chromium 的环境不会走到这条路径,属长期潜伏的 bug。
🛡️ 兼容性:proot 下的新版 Chromium 会崩
- 新增排障条目 问题 13:rev1246+(Chrome for Testing 154.0.8037.0)在 proot 下启动即 SIGTRAP(exit 133),
而 1237 完全正常;给出 1237 的回退与下载命令(含 zip 目录结构注意事项) - 转发器新增
PW_MCP_PREFERRED_BUILD(默认1237):本机存在多个 build 时优先选已知可用版本,
不再「选最新」 - 自动下载到「非偏好 build」时会打一条 WARN,提示可能的崩溃与回退方式
PW_MCP_MIN_BUILD默认值 1243 → 1237(原值会让 1237 白刷一条 WARN;install.sh同步)
📄 文档
- DEPLOY:Chromium 行补
install-browser与 build 偏好说明;环境变量表补PW_MCP_PREFERRED_BUILD - README:补
PW_MCP_PREFERRED_BUILD说明与问题 13 链接 - TROUBLESHOOTING:问题 4 增加与问题 13 的交叉引用
📦 安装 / 升级
见 README「安装」一节。升级可直接用新版文件覆盖;mcpServers.playwright_mcp.env 与
node_modules 保留即可免重装依赖。
校验:python 语法检查、shell 语法检查、JSON 校验,find_chrome() 边界矩阵 4 例
(默认 / 偏好关闭 / 偏好不存在 / 非法值)全部通过。
v1.0.6 — 跟进上游 0.0.82 + 三轮审查修复
v1.0.6
跟进上游 @playwright/mcp 0.0.80 → 0.0.82,并完成一轮三轮代码审查(作者自审 → 陌生视角 → 外部 AI → 作者终审)。
⬆️ 版本跟进
- 上游升到 0.0.82(新特性:60fps 可样式化视频录制
browser_start_video;WebMCP 工具;--profile-dir-name) - 工具数:25 个(v1.0.5 及以前文档写「24」是因为漏列了
browser_emulate_media,本次已订正)
🔧 安装脚本修复(11 项)
--keep-deps真正生效:此前会先rm -rf整个运行目录再谈"保留依赖",实际每次全删重建(帮助文档与实现不一致)- npm 源默认改为官方源:0.0.82 依赖
playwright-core@1.64.0-alpha-*,国内镜像未同步会报ETARGET - curl 半成品防护:下载转发器改为
.tmp→ 校验(shebang + 编译)→ 原子替换 - 配置合并加类型校验:
mcpServers/pluginMetadata非对象时重置并告警,不静默 - 备份失败明确提示、备份清理改用
find、NODE_MAJOR健壮解析、JSON 补尾随换行 uninstall.sh:去掉eval(消除字符串逃逸面)、备份清理与 install 对齐
🐍 转发器改进
- 新增 node 版本校验(< 18 或解析失败则跳过该候选,日志可见)
bootstrap.log日志轮转(超 1MB 转.log.1,可用PW_MCP_LOG_MAX调整)
📄 文档
- 快速开始改为 A. Release 完整包(国内推荐) / B. raw 直连
- 新增 问题 12:npm install 报 ETARGET(现象/根因/解法/验证)
- Chromium 兼容结论更新:
chromium-1237在新旧驱动下均兼容(无需重新下载) - 新增
CHANGELOG.md:版本变更记录 + 版本语义说明
✅ 实测
- 隔离环境完整安装 / 重复安装(幂等)/
--dry-run/uninstall全流程通过 --keep-deps:node_modulesmtime 前后一致(确认未被重建)- 端到端:MCP 握手成功,
tools/list返回 25 个工具 - Chromium:复用本机
chromium-1237,启动/导航/locator 全通
⚠️ 注意
- 市场条目仍在审核,暂可能搜不到;请使用本 Release 的 zip 或一键脚本安装
@playwright/mcp@0.0.82的 alpha 依赖需 npm 官方源(脚本已默认)
🔧 勘误(v1.0.6 patch 1,2026-09-19)
修复 install.sh 生成 pluginMetadata.version 时误用了上游 MCP 版本号(0.0.82)而非插件版本号(1.0.6)的问题 —— 此前安装后,Operit 插件页会显示版本 0.0.82。
- 影响范围:仅
install.sh生成的配置元数据;功能不受影响 - 处理方式:已更新
install.sh并替换本 Release 的 zip 资产(tag 不变) - 如已安装:重跑一次
bash install.sh即可修正版本显示
版本语义说明:自 1.0.6 起,pluginMetadata.version 表示插件自身版本,与上游 @playwright/mcp 版本解耦;升级后版本号由 0.0.x 变为 1.0.6 属预期行为。
🔧 勘误(v1.0.6 patch 2,2026-09-19)
market/README.md 同步 6 处过期值(Release 示例版本、工具数 24→25、updatedAt、示例 version、设计要点标题、ping_mcp 提醒),并重新打包资产。
🔧 勘误(v1.0.6 patch 3,2026-09-19)
第三轮外部评审的修复,共 7 项代码 + 1 项文档。其中 1 项为高严重度回归(本轮修复过程自身引入):
| # | 严重度 | 位置 | 问题 | 修法 |
|---|---|---|---|---|
| 1 | 🔴 高 | install.sh |
KEEP_DEPS_EFFECTIVE 只在 [5/6] 段内赋值,--dry-run 下 set -u 抛 unbound 并 exit 1("dry-run 实测通过"的自述不实,已更正) |
提升到全局初始化区 |
| 2 | 🟡 中 | 转发器 | PW_MCP_LOG_MAX / PW_MCP_MIN_BUILD 模块级 int():写成 1m、1243x 这类口语值会 ValueError 直接崩溃 |
新增 _int_env():告警 + 回退默认值 |
| 3 | 🟡 中 | 转发器 | 本地 npm install 未传 cwd,隐式依赖进程工作目录;一旦启动方式变化会装错位置、污染全局 |
run() 支持 cwd;本地安装显式 cwd=HERE |
| 4 | 🟢 低 | install.sh / uninstall.sh |
备份清理用 find -printf(GNU 扩展),Termux 的 toybox find 不支持 |
改用便携写法 ls -1t |
| 5 | 🟢 低 | install.sh |
[1/6] 允许缺 python3,但 [2/6] 下载校验链硬依赖 python3 → 该兜底路径必然失败 |
python3 缺失时降级为「shebang + 体积下限」校验 |
| 6 | 🟢 低 | install.sh |
--keep-deps 复制循环末尾 [ -f ] && cp 的返回值会被 set -e 捕获 |
改为 if 语句 |
| 7 | 🟢 低 | 转发器 | _log_rotated 注释易被误读为"持续监控" |
补充注释说明 |
本轮实测(隔离环境,全部通过):
--dry-run exit 0 (修复前 exit 1 / unbound variable)
--dry-run --keep-deps exit 0
--keep-deps(幂等) exit 0
完整安装 / 卸载 exit 0
非法环境变量容错 ValueError/Traceback 出现次数 = 0
备份上限清理 8 份 → 5 份 ✅
同时修复的文档问题:上一轮 patch 说明中的"感谢实机验证时发现此问题"措辞不当(本项目由作者自行实机验证),已改为陈述句。
本 Release 资产已更新为新包(22 个文件,含新增 CHANGELOG.md),tag 仍为 v1.0.6。
v1.0.5
v1.0.5
新增
- 自举转发器:首次启动自动安装
@playwright/mcp并复用/下载 Chromium,装完即用 - 市场一键可用:新增
package.json依赖声明,安装时自动npm install - install.sh 重构:
--global/--skip-deps/--dry-run,自动创建 venv,结构校验 - uninstall.sh 新增:
--keep-files/--purge/--dry-run
修复
- 修复
npm install在/sdcard(FUSE)上执行失败的问题 - 修复缺 venv 导致的启动失败(Unknown error)
- 修复
pipefail+headSIGPIPE 导致脚本静默退出 - Chromium 探测支持多路径与 build 择优
文档
- README / DEPLOY / TROUBLESHOOTING / market 全面更新(自举机制、市场自动安装行为、自检清单)
一键部署:
bash install.sh卸载:bash uninstall.sh
v1.0.4
v1.0.4(2026-09-05)
适配 Operit 新版 MCP 部署机制(2026-08-22 起),并升级上游到 stable 0.0.80。
✨ 更新内容
- 上游 @playwright/mcp 0.0.79 → 0.0.80(9/1 官方 stable):
- 新增
browser_start_recording/browser_stop_recording(opt-in,需--caps=devtools,默认不启用,工具面仍为 24 个) - 修复截图原始字节、browser_close 缓存清理、killkillkill 安全修复等
- 依赖 playwright 1.63.0-alpha-2026-08-31(需求 chromium build 1243,实测复用 1234/1237 兼容)
- 新增
- install.sh 适配新版 Operit 部署机制(源码级对齐 MCPConfigGenerator.kt):
- 生成
playwright_mcp.py转发器(exec 转发 node cli.js)+ 空requirements.txt(保 PYTHON 判定) - 配置 command 改为
~/mcp_plugins/playwright_mcp/venv/bin/python -m playwright_mcp,env 留空 - 转发器占位符(
@NODE_BIN@/@CLI_JS@/@CHROME_BIN@)部署时自动替换为真实路径
- 生成
- 新增
scripts/playwright_mcp.py转发器模板(install.sh 与手动部署共用单一来源) - 修复版本表述逻辑谬误:早期 v1.0.0 的"25 工具笔误"表述统一为"v1.0.1 及以后版本已修正"
- config/mcp_config.json 与 DEPLOY/TROUBLESHOOTING 文档同步:author/repoUrl 指向本项目,版本号全量更新
- chromium 多路径探测(
$HOME+/root兜底)+ build 探测提示(低于 1243 给警告不静默挖坑)
📦 安装
curl -sL https://raw.githubusercontent.com/x15907982411/playwright-mcp-for-operit/main/install.sh -o install.sh
bash install.sh或从本 Release zip 提取 install.sh(raw.githubusercontent.com 在国内可能无法直连)。
✅ 已验证
- 本机全链路实测通过:install.sh 全流程 +
venv/bin/python -m playwright_mcp --version→Version 0.0.80 - MCP stdio 协议 initialize + tools/list(24 工具)+ browser_navigate + browser_snapshot 全通
v1.0.3
v1.0.3 改进(三轮 AI 评审驱动)
- installedPath 跟随 OPERIT_DATA_DIR(/sdcard → /storage/emulated/0 转换)
- /root/mcp_plugins → $HOME/mcp_plugins,新增 LINUX_RUN_DIR 可覆盖
- 防残缺 chromium:只认 >1MB 二进制,下载中断残留不再误判
- 共享库缺失检查(ldd),启动前提前提示 apt 依赖清单
- 备份轮换:只保留最近 3 份 .bak
- 版本不一致自动重装(不再要求手动)
- npm 失败补 EACCES 权限提示
- 备份输出修星号不展开 bug;cd 改 pushd/popd
- README 注明推荐 proot 执行
v1.0.2
v1.0.2 改进
- 动态获取全局 node_modules 路径(npm root -g),修复 Termux 等环境下 /usr/lib 硬编码崩溃
- OPERIT_DATA_DIR 环境变量可覆盖默认数据目录
- 安装后强校验 @playwright/mcp 版本 == 0.0.79,不一致阻止部署
- 合并配置 JSON 解析容错:损坏时给出明确报错与备份恢复指引
- trap 自动清理临时文件
- 脚本头部声明适用环境 + 安全审查提示
- 下载失败时提示可 export PLAYWRIGHT_DOWNLOAD_HOST 换镜像
v1.0.1
v1.0.1 修复(2026-08-12)
- install.sh 重写:锁版本 @playwright/mcp@0.0.79;生成 15 字段完整 pluginMetadata(修复 Operit MCPRepository NPE 导致插件加载不上);自动合并进主配置(原文件自动备份)+ 双路径部署;chromium 下载失败时给出复用方案降级提示
- README/DEPLOY 修正工具数 25→24(官方 v0.0.79 stable 实测 24 个 browser_* 工具)
- TROUBLESHOOTING 新增:问题 4(pluginMetadata 缺失 NPE 修复)、问题 8(24 工具说明)
- 全部改动经实机验证:脚本全流程跑通、Operit 加载成功、24 工具可用
感谢 @Kang5 的 issue 反馈 🙏