diff --git a/desktop/README.md b/desktop/README.md index dae1071..d645dfe 100644 --- a/desktop/README.md +++ b/desktop/README.md @@ -204,8 +204,8 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command" ## 和前端 / 插件怎么配合 -1. WMS 页面上点运单号旁的按钮 → 插件**直接用 `yuncang://open?code=<运单号>` 唤起本机软件**并定位到该单号 - (浏览器会先问一次「要打开吗」);也可以把插件的目标模板配成 `http://<站点>/local?code=<运单号>` 先开网页; +1. WMS 页面上点运单号旁的按钮 → 插件按「打开方式」处理:默认**直接用 `yuncang://open?code=<运单号>` 唤起本机软件**并定位到该单号 + (浏览器会先问一次「要打开吗」);把打开方式改成「独立小窗 / 新标签页」则改为打开网页; 2. `/local` 页只发一个请求 `GET /api/query/{code}`: - **连不上** → 提示「服务暂不可用 / 本地打印服务未启动,请下载安装后再试」+ 下载按钮; 点「已安装,启动本机软件」会走 `yuncang://open?code=...`,然后每秒重试同一个查询接口; @@ -226,8 +226,12 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command" - **在网页中查看** → 打开插件设置里的「唤不起时的兜底页」(默认 `http://localhost:7301/local?code={code}`, 该页面里有完整的下载安装引导); - **下载安装** → 打开插件设置里的「软件下载地址」(留空则不显示这个按钮)。 -3. 插件设置页有三个相关配置:目标地址模板(默认 `yuncang://open?code={code}`)、 - 唤不起时的兜底页、软件下载地址。老配置里如果是旧的 http 默认模板,升级时会自动换成协议模板。 +3. 插件设置页的相关配置: + - **打开方式**:`直接唤起本机软件(协议)`(默认)/ `独立小窗(网页)` / `新标签页(网页)`; + - **协议模板**(仅「直接唤起」时生效):默认 `yuncang://open?code={code}`; + - **网页地址模板**(仅小窗/标签页时生效):默认 `http://localhost:7301/local?code={code}`; + - **唤不起时的兜底页**、**软件下载地址**(留空则不显示「下载安装」按钮)。 + 老配置升级时会自动迁移(v3 把协议写在网页模板里的,会改成「打开方式 = 直接唤起 + 网页模板还原」),行为不变。 > 兜底只能靠「失焦」猜,不是 100% 准确(软件在后台启动、没抢焦点时会误报一次)。 > 想更稳就把目标模板配成 `/local?code={code}`:网页里有真实的查询结果,连不上就是真的没起来。