From 9be56db38505d0973176916c0b57d1e2231c5b46 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Sat, 17 Oct 2026 10:06:08 +0800 Subject: [PATCH] =?UTF-8?q?=E5=89=8D=E7=AB=AF=EF=BC=9A/local=20=E9=A1=B5?= =?UTF-8?q?=E6=94=AF=E6=8C=81=E3=80=8C=E5=8F=AB=E9=86=92=E3=80=8D=E5=B7=B2?= =?UTF-8?q?=E5=AE=89=E8=A3=85=E7=9A=84=E6=9C=AC=E6=9C=BA=E8=BD=AF=E4=BB=B6?= =?UTF-8?q?=EF=BC=88=E8=87=AA=E5=AE=9A=E4=B9=89=E5=8D=8F=E8=AE=AE=20+=20?= =?UTF-8?q?=E8=BD=AE=E8=AF=A2=E6=8E=A2=E6=B4=BB=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 网页没法直接执行 exe,只能走「自定义 URL Scheme」(百度云盘 baiduyunguanjia://、迅雷 thunder:// 都是这个套路):浏览器让系统按注册表里的协议去拉起应用。 - api/local.ts 新增 APP_PROTOCOL(VITE_APP_PROTOCOL,默认 yuncang)、appLaunchUrl()、 launchApp()(隐藏 iframe 触发,避免协议没注册时整页报错)、waitForHealth()(1s 一次, 默认最多等 12s)。 - 离线态多一个「已安装,启动本机软件」按钮:点完进 launching 态,轮询 health; 起来了就自动查询原来的 code;12s 还没起来则提示「可能没安装 / 没注册启动协议」, 并保留下载按钮。 - 下载按钮、探活提示与居中布局保持不变。 实测(7301 + 模拟的 17311):先打开显示「服务暂不可用」;点启动后进入「正在启动本机软件…」, 轮询期间把模拟服务起起来,页面自动切到查询结果(4 行)。 --- frontend/src/api/local.ts | 42 +++++++++++++++++++++ frontend/src/views/LocalServiceView.vue | 49 ++++++++++++++++++++++--- 2 files changed, 86 insertions(+), 5 deletions(-) diff --git a/frontend/src/api/local.ts b/frontend/src/api/local.ts index 0fd0327..01a3a14 100644 --- a/frontend/src/api/local.ts +++ b/frontend/src/api/local.ts @@ -77,3 +77,45 @@ export async function checkLocalHealth(): Promise { export function queryLocalInfo(code: string): Promise { return get(`/api/query/${encodeURIComponent(code)}`, 8000); } + +/** + * 叫醒已安装的本机软件:**自定义 URL Scheme**(安装包写进注册表的那种,像 `thunder://`、 + * `baiduyunguanjia://` 一样) + * + * 网页**无法直接执行 exe**:只能让浏览器去打开 `xxx://…`,由系统按注册表找到 exe 并拉起( + * Chrome/Edge 会先弹「要打开 xxx 吗?」)。所以:先试这个,再轮询 health 确认真的起来了。 + * + * 协议名用 `VITE_APP_PROTOCOL` 配(默认 `yuncang`),必须与安装包里注册的一致。 + */ +export const APP_PROTOCOL = (import.meta.env.VITE_APP_PROTOCOL as string | undefined) || 'yuncang'; + +/** 拼出唤醒地址(把 code 一并带过去,软件起来后可以直接定位到该运单) */ +export function appLaunchUrl(code?: string): string { + const query = code ? `?code=${encodeURIComponent(code)}` : ''; + return `${APP_PROTOCOL}://open${query}`; +} + +/** + * 触发唤醒。用隐藏 iframe 而不是 `location.href`: + * 协议没注册时 Chrome 会直接在当前标签报错页,用 iframe 就只是静默失败。 + */ +export function launchApp(code?: string): void { + const iframe = document.createElement('iframe'); + iframe.style.display = 'none'; + iframe.src = appLaunchUrl(code); + document.body.appendChild(iframe); + setTimeout(() => iframe.remove(), 1500); +} + +/** + * 轮询探活:本机软件从被叫醒到 HTTP 服务可用需要几秒 + * @return 超时前探到返回 true,否则 false + */ +export async function waitForHealth(timeoutMs = 12000, intervalMs = 1000): Promise { + const deadline = Date.now() + timeoutMs; + while (Date.now() < deadline) { + if (await checkLocalHealth()) return true; + await new Promise(resolve => setTimeout(resolve, intervalMs)); + } + return false; +} diff --git a/frontend/src/views/LocalServiceView.vue b/frontend/src/views/LocalServiceView.vue index 239c756..aa27a1f 100644 --- a/frontend/src/views/LocalServiceView.vue +++ b/frontend/src/views/LocalServiceView.vue @@ -12,7 +12,15 @@ */ import { computed, onMounted, ref } from 'vue'; import { useRoute, useRouter } from 'vue-router'; -import { checkLocalHealth, queryLocalInfo, LOCAL_BASE, LocalServiceError } from '@/api/local'; +import { + APP_PROTOCOL, + checkLocalHealth, + launchApp, + queryLocalInfo, + waitForHealth, + LOCAL_BASE, + LocalServiceError, +} from '@/api/local'; /** * 安装包下载地址:换成真实地址,或用环境变量 `VITE_SOFTWARE_DOWNLOAD_URL` 覆盖 @@ -23,23 +31,45 @@ const DOWNLOAD_URL = (import.meta.env.VITE_SOFTWARE_DOWNLOAD_URL as string | und const route = useRoute(); const router = useRouter(); -type Status = 'checking' | 'offline' | 'ready'; +type Status = 'checking' | 'offline' | 'launching' | 'ready'; const status = ref('checking'); const code = ref(String(route.query.code || '').trim()); const info = ref(null); const querying = ref(false); const error = ref(''); +const launchFailed = ref(false); /** 探活:连不上就是「软件没启动」 */ async function detect() { status.value = 'checking'; error.value = ''; + launchFailed.value = false; const alive = await checkLocalHealth(); status.value = alive ? 'ready' : 'offline'; if (alive) await runQuery(); } +/** + * 「启动本机软件」:用自定义协议叫醒(浏览器会问一次),再轮询探活 + * + * 网页不能直接跑 exe —— 只能让系统按注册的协议去拉起(百度云盘/迅雷就是这个路子)。 + */ +async function launch() { + launchFailed.value = false; + status.value = 'launching'; + launchApp(code.value.trim() || undefined); + + const alive = await waitForHealth(); + if (alive) { + status.value = 'ready'; + await runQuery(); + return; + } + launchFailed.value = true; + status.value = 'offline'; +} + /** 按码查信息(没填码就只停在输入框) */ async function runQuery() { const target = code.value.trim(); @@ -91,10 +121,14 @@ onMounted(detect);
云仓视频溯源系统
- + +