From cae0440fa151ece12d8906cf76bd507cac1b0da9 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Sat, 17 Oct 2026 11:22:04 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8F=92=E4=BB=B6=E3=80=8C=E6=89=93=E5=BC=80?= =?UTF-8?q?=E6=96=B9=E5=BC=8F=E3=80=8D=E6=96=B0=E5=A2=9E=E5=8D=8F=E8=AE=AE?= =?UTF-8?q?=E5=94=A4=E8=B5=B7=EF=BC=88openMode=3Dapp=EF=BC=89=EF=BC=8C?= =?UTF-8?q?=E5=8D=8F=E8=AE=AE=E6=A8=A1=E6=9D=BF=E4=B8=8E=E7=BD=91=E9=A1=B5?= =?UTF-8?q?=E6=A8=A1=E6=9D=BF=E5=88=86=E7=A6=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 原来「协议唤起」是靠把 URL 模板写成 yuncang:// 来隐式表达的,用户在界面上看不到、 也不好在「唤起软件」和「开网页」之间切。 - 现在「点击后打开方式」有三个值:app(直接唤起本机软件,默认)/ window(独立小窗)/ tab(新标签页)。 - openMode=app 时用新增的 appUrlTemplate(默认 yuncang://open?code={code}),规则级的网页模板不参与; - openMode=window/tab 时仍用 urlTemplate(默认 http://localhost:7301/local?code={code})。 - 配置版本 3 → 4:v3 曾把协议模板当作 urlTemplate 的默认值,升级时把网页模板还原、 并设置 openMode=app,行为保持不变;用户自定义过的模板不动。 - 兜底不变:4 秒内页面没失焦 → 右下角「在网页中查看」(fallbackUrl)+「下载安装」(downloadUrl)。 验证(options 页跑 PSTRules): - 默认 { openMode: app, urlTemplate: http://localhost:7301/local?code={code}, appUrlTemplate: yuncang://open?code={code} }; - v3 配置 { version:3, urlTemplate:'yuncang://open?code={code}', openMode:'window' } 升级后 → { openMode: app, urlTemplate: http://localhost:7301/local?code={code} }; - 自定义网页模板 + openMode=tab 保持不变;window 模式仍可正常保存。 - 插件脚本 node --check 全通过。 桌面端 README:更新「和前端 / 插件怎么配合」与「插件直接唤起与兜底」两节, 说明打开方式、两种模板与配置迁移。 --- desktop/README.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) 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}`:网页里有真实的查询结果,连不上就是真的没起来。