插件兜底判定改用「探测本机服务」,消除软件已在跑时的误报

现象:点「查看打包视频」后,软件其实已经被唤起/本来就在跑,却弹出
「没打开本机软件?可能还没安装…」。

原因:原判定只看「4 秒内页面有没有失焦」。但
1. 软件已经在跑时,协议只是把参数转给已有实例,主窗口不一定抢焦点;
2. 冷启动(单文件自解压 + 恢复登录)可能超过 4 秒;
两种情况页面都还聚焦 → 被误判为失败。

修复:
- manifest 增加 host_permissions(http://localhost:17300/*、http://127.0.0.1:17300/*),
  让 background 能探测本机服务(不受页面 CSP 影响)。
- background 新增 pst:probe:fetch GET /api/query/,**任何 HTTP 响应(200/400/401)都算在线**;
  服务端本来就回显 Origin,chrome-extension:// 来源也已验证可通(实测回
  Access-Control-Allow-Origin: chrome-extension://…)。
- content.js launchProtocol 改为:
  - 触发协议后每 0.7s 探测一次,最长 8 秒(给冷启动足够时间);
  - 探测到服务 → 判定成功,什么都不做(软件已在跑时第一次探测就成功,不再误报);
  - 8 秒都探测不到 → 才弹兜底卡片(在网页中查看 / 下载安装 / 关闭);
  - 页面失焦仍保留为「快速判定成功」的辅助信号。
- options 页与 desktop/README 的兜底说明同步(4 秒 → 约 8 秒 / 探测本机服务)。

验证:manifest JSON 合法(v3 + 两个 host 权限);content.js / background.js node --check 通过;
带 chrome-extension:// 来源请求本机接口能拿到 Access-Control-Allow-Origin 回显。
This commit is contained in:
liufumingren 2026-10-17 11:28:35 +08:00
parent cae0440fa1
commit 65a4fd86f1

View File

@ -222,7 +222,10 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command"
「要打开吗」上点了取消,这三种情况在页面侧**完全一样**。所以必须做超时兜底:
1. 点击 → 隐藏 iframe 触发 `yuncang://open?code=xxx`(不能导航当前页,否则协议没注册会变成错误页);
2. 4 秒内页面没失焦(软件窗口没抢焦点)→ 认为没起来,右下角弹出兜底卡片:
2. **判断到底成没成,不看页面焦点,看本机服务在不在**:协议触发后每 0.7s 探测一次
`http://localhost:17300/api/query/`(任何 HTTP 响应都算成功,扩展带 host 权限,不受页面 CSP 影响);
- 探测到 → 什么也不做(软件本来就在跑时也能正确判定,不会误报);
- 8 秒都探测不到 → 认为没起来,右下角弹出兜底卡片:
- **在网页中查看** → 打开插件设置里的「唤不起时的兜底页」(默认 `http://localhost:7301/local?code={code}`,
该页面里有完整的下载安装引导);
- **下载安装** → 打开插件设置里的「软件下载地址」(留空则不显示这个按钮)。
@ -233,8 +236,9 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command"
- **唤不起时的兜底页**、**软件下载地址**(留空则不显示「下载安装」按钮)。
老配置升级时会自动迁移(v3 把协议写在网页模板里的,会改成「打开方式 = 直接唤起 + 网页模板还原」),行为不变。
> 兜底只能靠「失焦」猜,不是 100% 准确(软件在后台启动、没抢焦点时会误报一次)。
> 想更稳就把目标模板配成 `/local?code={code}`:网页里有真实的查询结果,连不上就是真的没起来。
> 判定依据是「本机服务在不在」,所以**软件已经在跑时不会误报**(这是最常见的场景:
> 协议只是把参数转给已有实例,窗口不一定抢焦点)。真正的误报只剩一种:软件在跑但用户手动
> 「停止服务」了 —— 那种情况提示一下也算合理。页面失焦只作为「快速判定成功」的辅助信号。
## ★ 接真实数据