web-access Files

升级必读

• 升级前把 README 顶部那段提示词发给你的 Agent，它会先把数据搬到 ~/.web-access/ 再升级。
• 用户数据（config.env、站点经验）移到 ~/.web-access/（Windows 为 %USERPROFILE%\.web-access\），之后任何方式升级都不会再被覆盖。
• 用 npx skills update 升级的，升级前先备份，做法见 references/migration-2.6.md。
• git clone 和 Claude Code 插件安装，升级后由前置检查自动复制旧数据。
• 升级后等共享服务空闲时运行一次 proxy-maintenance.mjs restart。

任意 Chromium 内核浏览器可用

• WEB_ACCESS_BROWSER 改为填浏览器的用户数据目录，Brave、Arc、Dia、Vivaldi、Opera 等都能用。
• 旧值 chrome / chrome-canary / chromium / edge 仍然有效，老配置不用改。
• 首次配置：前置检查只列出应用数据目录最外层的文件夹名（Linux 含 ~/.config、~/snap、~/.var/app），Agent 认出浏览器后用 browser-probe.mjs 只进入认出的文件夹确认，再询问用户。
• 配置值无效时报「配置错误」，不会引导去停共享服务。
• 不再自动扫描 9222 等固定端口；用 --remote-debugging-port 单独启动的调试浏览器不在支持范围内。
• 契约变化：/health 的 browser.id 从 chrome 这类短名改为数据目录的真实路径。

跨站 iframe（新增）

• GET /frames?target=：列出页面里的 iframe（frameId、网址、是否跨进程等）。
• POST /eval?target=&frame=<frameId>：在该 iframe 中执行，跨站 iframe 也可以；不带 frame 时行为不变。
• GET /clickXY?target=&x=&y=：按视口坐标真实点击，可点中（嵌套的）跨站 iframe 里的元素，不激活标签页。

修复

• proxy-maintenance.mjs stop / restart 对真实服务报 ECONNRESET、restart 停了旧服务却不拉起新服务。
• 并发维护、服务退出瞬间连接被重置或 EPIPE 时，维护命令误报错误；停止请求未被接受时不再空等 15 秒。
• 首次配置的探测命令遇到无权限目录时崩溃。
• 迁移失败后再重试，旧的浏览器偏好会丢失。

致谢

• 「让任意 Chromium 浏览器可用」的思路来自 [#173]（@zhangweijian97），关联 [#172]、#149；用户数据位置问题来自 [#169]。