Skip to content

Releases

v1.1.0

Choose a tag to compare

@x15907982411 x15907982411 released this 14 Nov 07:12

Playwright MCP for Operit v1.1.0

⬆️ 跟上上游

  • @playwright/mcp 0.0.84 → 0.0.85
  • playwright-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 自动升级成 HTTPS
  • browser_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

Choose a tag to compare

@x15907982411 x15907982411 released this 01 Nov 04:35

Playwright MCP for Operit v1.0.9

⬆️ 跟上上游

  • @playwright/mcp 0.0.83 → 0.0.84
  • playwright-core → 1.65.0-alpha-2026-10-30

这次上游加的东西挺实用:

  • browser_tabs 多了 isolatedContext —— 传个名字就开一个独立的浏览器上下文,cookie 和 localStorage 都是分开的。想同时挂两个账号,不用再反复退登录清缓存了
  • browser_find 多了 maxResults —— 页面上匹配几十个的时候能限个数,省 token
  • browser_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

Choose a tag to compare

@x15907982411 x15907982411 released this 30 Sep 12:10

Playwright MCP for Operit v1.0.8

⬆️ 上游同步

  • 适配 @playwright/mcp 0.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

Choose a tag to compare

@x15907982411 x15907982411 released this 23 Sep 12:31

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 + 三轮审查修复

Choose a tag to compare

@x15907982411 x15907982411 released this 19 Sep 01:13

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_modules mtime 前后一致(确认未被重建)
  • 端到端: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

Choose a tag to compare

@x15907982411 x15907982411 released this 12 Sep 11:16

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 + head SIGPIPE 导致脚本静默退出
  • Chromium 探测支持多路径与 build 择优

文档

  • README / DEPLOY / TROUBLESHOOTING / market 全面更新(自举机制、市场自动安装行为、自检清单)

一键部署:bash install.sh 卸载:bash uninstall.sh

v1.0.4

Choose a tag to compare

@x15907982411 x15907982411 released this 05 Sep 12:53

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

Choose a tag to compare

@x15907982411 x15907982411 released this 14 Aug 12:32

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

Choose a tag to compare

@x15907982411 x15907982411 released this 14 Aug 12:05

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

Choose a tag to compare

@x15907982411 x15907982411 released this 12 Aug 02:51

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 反馈 🙏