From 65a4fd86f1857b30410c075551e240d716f1393f Mon Sep 17 00:00:00 2001 From: liufumingren Date: Sat, 17 Oct 2026 11:28:35 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8F=92=E4=BB=B6=E5=85=9C=E5=BA=95=E5=88=A4?= =?UTF-8?q?=E5=AE=9A=E6=94=B9=E7=94=A8=E3=80=8C=E6=8E=A2=E6=B5=8B=E6=9C=AC?= =?UTF-8?q?=E6=9C=BA=E6=9C=8D=E5=8A=A1=E3=80=8D=EF=BC=8C=E6=B6=88=E9=99=A4?= =?UTF-8?q?=E8=BD=AF=E4=BB=B6=E5=B7=B2=E5=9C=A8=E8=B7=91=E6=97=B6=E7=9A=84?= =?UTF-8?q?=E8=AF=AF=E6=8A=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 现象:点「查看打包视频」后,软件其实已经被唤起/本来就在跑,却弹出 「没打开本机软件?可能还没安装…」。 原因:原判定只看「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 回显。 --- desktop/README.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/desktop/README.md b/desktop/README.md index d645dfe..0cbeba2 100644 --- a/desktop/README.md +++ b/desktop/README.md @@ -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}`:网页里有真实的查询结果,连不上就是真的没起来。 +> 判定依据是「本机服务在不在」,所以**软件已经在跑时不会误报**(这是最常见的场景: +> 协议只是把参数转给已有实例,窗口不一定抢焦点)。真正的误报只剩一种:软件在跑但用户手动 +> 「停止服务」了 —— 那种情况提示一下也算合理。页面失焦只作为「快速判定成功」的辅助信号。 ## ★ 接真实数据