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}`:网页里有真实的查询结果,连不上就是真的没起来。 +> 判定依据是「本机服务在不在」,所以**软件已经在跑时不会误报**(这是最常见的场景: +> 协议只是把参数转给已有实例,窗口不一定抢焦点)。真正的误报只剩一种:软件在跑但用户手动 +> 「停止服务」了 —— 那种情况提示一下也算合理。页面失焦只作为「快速判定成功」的辅助信号。 ## ★ 接真实数据