? UserNameProvider { get; set; }
+
public LocalHttpServer(OrderQueryService queryService)
{
_queryService = queryService;
}
+ /// 是否已登录(网页靠它判断要不要唤起登录)
+ public bool IsLoggedIn => IsLoggedInProvider?.Invoke() ?? false;
+
/// 浏览器里可直接打开的地址
public string BaseUrl => $"http://localhost:{Port}";
@@ -124,6 +136,27 @@ public sealed class LocalHttpServer : IDisposable
var path = request.Url?.AbsolutePath ?? "/";
Log?.Invoke($"{request.HttpMethod} {path} ← {request.RemoteEndPoint?.Address}");
+ // 网页请求唤起登录(POST,避免被浏览器的链接预取误触发)
+ if (path.Equals("/api/activate-login", StringComparison.OrdinalIgnoreCase))
+ {
+ if (!request.HttpMethod.Equals("POST", StringComparison.OrdinalIgnoreCase))
+ {
+ await WriteJsonAsync(response, 405, new { ok = false, message = "请用 POST" }).ConfigureAwait(false);
+ return;
+ }
+
+ Log?.Invoke("网页请求唤起登录");
+ LoginRequested?.Invoke();
+
+ await WriteJsonAsync(response, 200, new
+ {
+ ok = true,
+ loggedIn = IsLoggedIn,
+ message = IsLoggedIn ? "已登录,已把主界面唤到前台" : "已请求本机软件显示登录窗口",
+ }).ConfigureAwait(false);
+ return;
+ }
+
if (!request.HttpMethod.Equals("GET", StringComparison.OrdinalIgnoreCase))
{
await WriteJsonAsync(response, 405, new { ok = false, message = "只支持 GET" }).ConfigureAwait(false);
@@ -133,12 +166,15 @@ public sealed class LocalHttpServer : IDisposable
if (path.Equals("/api/health", StringComparison.OrdinalIgnoreCase)
|| path.Equals("/api/health/", StringComparison.OrdinalIgnoreCase))
{
+ // ok = 服务在跑(前端只认这个);loggedIn = 本机软件是否已登录(没登录就唤起登录)
await WriteJsonAsync(response, 200, new
{
ok = true,
name = "云仓视频溯源打印服务",
version = typeof(LocalHttpServer).Assembly.GetName().Version?.ToString() ?? "1.0.0",
port = Port,
+ loggedIn = IsLoggedIn,
+ user = UserNameProvider?.Invoke(),
serverTime = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"),
}).ConfigureAwait(false);
return;
@@ -147,6 +183,13 @@ public sealed class LocalHttpServer : IDisposable
const string queryPrefix = "/api/query/";
if (path.StartsWith(queryPrefix, StringComparison.OrdinalIgnoreCase))
{
+ // 未登录不查(网页会先把登录窗叫出来)
+ if (!IsLoggedIn)
+ {
+ await WriteJsonAsync(response, 401, new { ok = false, message = "本机软件未登录,请先在软件里登录", loggedIn = false }).ConfigureAwait(false);
+ return;
+ }
+
var code = Uri.UnescapeDataString(path[queryPrefix.Length..]).Trim();
var result = _queryService.Query(code);
@@ -170,10 +213,11 @@ public sealed class LocalHttpServer : IDisposable
云仓视频溯源软件(本机服务)
- 服务运行中,只监听本机(127.0.0.1:17311)。
+ 服务运行中,只监听本机(127.0.0.1:17300)。
- - /api/health 探活
- /api/query/{运单号} 按运单号查信息
+ - /api/health 探活(含登录状态)
+ /api/query/{运单号} 按运单号查信息(需已登录)
+ POST /api/activate-login 把登录窗叫到前台
""";
await WriteHtmlAsync(response, 200, html).ConfigureAwait(false);
@@ -214,7 +258,7 @@ public sealed class LocalHttpServer : IDisposable
var origin = request.Headers["Origin"];
response.Headers["Access-Control-Allow-Origin"] = string.IsNullOrEmpty(origin) ? "*" : origin;
response.Headers["Vary"] = "Origin";
- response.Headers["Access-Control-Allow-Methods"] = "GET, OPTIONS";
+ response.Headers["Access-Control-Allow-Methods"] = "GET, POST, OPTIONS";
response.Headers["Access-Control-Allow-Headers"] = "Content-Type, Accept";
response.Headers["Access-Control-Max-Age"] = "600";
diff --git a/desktop/Services/SingleInstance.cs b/desktop/Services/SingleInstance.cs
index 6f0a245..7fc40bc 100644
--- a/desktop/Services/SingleInstance.cs
+++ b/desktop/Services/SingleInstance.cs
@@ -11,7 +11,7 @@ namespace YuncangTrace.LocalService.Services;
/// 单实例 + 参数转发(命名管道)
///
/// 场景:窗口已经开着,用户又点了一次 WMS 页面上的「查看打包视频」→ 系统按协议再启动一次本程序。
-/// 这时第二个实例**不应该**去抢 17311 端口,而是把 `yuncang://open?code=xxx` 通过管道送给第一个实例,
+/// 这时第二个实例**不应该**去抢 17300 端口,而是把 `yuncang://open?code=xxx` 通过管道送给第一个实例,
/// 由它把窗口激活并查询那个运单号。
///
public sealed class SingleInstance : IDisposable
diff --git a/frontend/src/api/local.ts b/frontend/src/api/local.ts
index 01a3a14..d3c958c 100644
--- a/frontend/src/api/local.ts
+++ b/frontend/src/api/local.ts
@@ -1,19 +1,19 @@
/**
* 本机软件(打印服务)客户端 —— 由 Chrome 插件打开的公共页用它查运单信息
*
- * 本机服务默认监听 `http://localhost:17311`:
- * - `GET /api/health` 探活:能连通就是「软件已启动」
- * - `GET /api/query/{code}` 按运单号查信息
+ * 本机服务默认监听 `http://localhost:17300`:
+ * - `GET /api/health` 探活 + 登录状态(`{ ok, loggedIn, user }`)
+ * - `GET /api/query/{code}` 按运单号查信息(需已登录)
+ * - `POST /api/activate-login` 把本机软件的登录窗叫到前台
*
- * ⚠️ 这是**跨域**请求(页面同源是我们的站点,目标是 localhost:17311):
- * 本机软件必须允许 CORS(`Access-Control-Allow-Origin` 放行站点来源),否则浏览器会拦掉,
+ * ⚠️ 这是**跨域**请求(页面同源是我们的站点,目标是 localhost:17300): * 本机软件必须允许 CORS(`Access-Control-Allow-Origin` 放行站点来源),否则浏览器会拦掉,
* 表现和「软件没启动」一样 —— 页面统一提示「服务暂不可用」。
*
* 地址可用 `VITE_LOCAL_SERVICE` 覆盖(换端口 / 换 127.0.0.1 时用)。
*/
/** 本机服务地址(去掉末尾斜杠) */
-export const LOCAL_BASE = ((import.meta.env.VITE_LOCAL_SERVICE as string | undefined) || 'http://localhost:17311')
+export const LOCAL_BASE = ((import.meta.env.VITE_LOCAL_SERVICE as string | undefined) || 'http://localhost:17300')
.replace(/\/+$/, '');
/** 本机服务返回非 2xx / 超时 / 跨域失败时抛它 */
@@ -28,13 +28,13 @@ export class LocalServiceError extends Error {
}
}
-/** 带超时的 GET;返回解析后的 JSON(不是 JSON 就给纯文本) */
-async function get(path: string, timeoutMs: number): Promise {
+/** 带超时的请求;返回解析后的 JSON(不是 JSON 就给纯文本) */
+async function request(path: string, timeoutMs: number, method: 'GET' | 'POST' = 'GET'): Promise {
const controller = new AbortController();
const timer = setTimeout(() => controller.abort(), timeoutMs);
try {
const res = await fetch(`${LOCAL_BASE}${path}`, {
- method: 'GET',
+ method,
headers: { Accept: 'application/json' },
signal: controller.signal,
});
@@ -52,24 +52,56 @@ async function get(path: string, timeoutMs: number): Promise {
}
}
+function get(path: string, timeoutMs: number): Promise {
+ return request(path, timeoutMs, 'GET');
+}
+
+/** 本机软件状态(`GET /api/health`) */
+export interface LocalHealth {
+ /** 软件在跑(只要 2xx 就算) */
+ online: boolean;
+ /** 软件已登录(没登录就唤起登录窗) */
+ loggedIn: boolean;
+ /** 当前登录用户显示名 */
+ user: string | null;
+}
+
/**
- * 探活:本机软件是否在跑
+ * 探活 + 拿登录状态
*
- * 只要 `GET /api/health` 能拿到 2xx 就算可用;返回体里显式写了 `ok:false` 也算不可用。
- * 连不上 / 超时 / 被 CORS 拦掉 → false(页面统一提示「服务暂不可用」)。
+ * 连不上 / 超时 / 被 CORS 拦掉 → `online: false`(页面统一提示「服务暂不可用」)。
+ * 老版本软件没有 `loggedIn` 字段 → 当作已登录(不让新页面把老客户端卡死)。
*/
-export async function checkLocalHealth(): Promise {
+export async function localHealth(): Promise {
try {
const data = await get('/api/health', 2500);
- if (data && typeof data === 'object' && 'ok' in data) {
- return Boolean((data as { ok?: unknown }).ok);
- }
- return true;
+ if (!data || typeof data !== 'object') return { online: true, loggedIn: true, user: null };
+
+ const record = data as Record;
+ const online = record.ok !== false;
+ const loggedIn = 'loggedIn' in record ? Boolean(record.loggedIn) : true;
+ const user = typeof record.user === 'string' ? record.user : null;
+
+ return { online, loggedIn, user };
} catch {
- return false;
+ return { online: false, loggedIn: false, user: null };
}
}
+/** 向后兼容:只关心「在不在跑」的地方用这个 */
+export async function checkLocalHealth(): Promise {
+ return (await localHealth()).online;
+}
+
+/**
+ * 请求本机软件把登录窗叫到前台(`POST /api/activate-login`)
+ *
+ * `navigator.userActivation` 限定?不需要 —— 但必须用 POST:GET 会被链接预取 / 预渲染误触发。
+ */
+export function requestLocalLogin(): Promise<{ ok?: boolean; loggedIn?: boolean; message?: string }> {
+ return request('/api/activate-login', 4000, 'POST');
+}
+
/**
* 按运单号 / 码查信息(本机软件返回什么就原样给什么,展示层做通用渲染)
* @param code 运单号(来自插件跳转的 `?code=`)
@@ -109,13 +141,34 @@ export function launchApp(code?: string): void {
/**
* 轮询探活:本机软件从被叫醒到 HTTP 服务可用需要几秒
- * @return 超时前探到返回 true,否则 false
+ * @return 最后一次探到的状态
*/
-export async function waitForHealth(timeoutMs = 12000, intervalMs = 1000): Promise {
+export async function waitForHealth(timeoutMs = 12000, intervalMs = 1000): Promise {
const deadline = Date.now() + timeoutMs;
+ let last: LocalHealth = { online: false, loggedIn: false, user: null };
+
while (Date.now() < deadline) {
- if (await checkLocalHealth()) return true;
+ last = await localHealth();
+ if (last.online) return last;
await new Promise(resolve => setTimeout(resolve, intervalMs));
}
- return false;
+
+ return last;
+}
+
+/**
+ * 等用户在本机软件里登录完成(每 1s 问一次 health,最多 timeoutMs)
+ * @return 最后一次探到的状态
+ */
+export async function waitForLoggedIn(timeoutMs = 30000, intervalMs = 1000): Promise {
+ const deadline = Date.now() + timeoutMs;
+ let last: LocalHealth = { online: false, loggedIn: false, user: null };
+
+ while (Date.now() < deadline) {
+ last = await localHealth();
+ if (!last.online || last.loggedIn) return last;
+ await new Promise(resolve => setTimeout(resolve, intervalMs));
+ }
+
+ return last;
}
diff --git a/frontend/src/router/index.ts b/frontend/src/router/index.ts
index 0236c45..e2ac205 100644
--- a/frontend/src/router/index.ts
+++ b/frontend/src/router/index.ts
@@ -13,8 +13,14 @@ const routes: RouteRecordRaw[] = [
// 手机扫码后打开:确认登录(公开)
{ path: '/wechat', name: 'wechat-confirm', component: () => import('@/views/WechatConfirmView.vue'), meta: { public: true, bare: true } },
// 本机软件(打印服务)公共页:**不需要登录**,Chrome 插件打开 `/local?code=<运单号>`
- // 页面自己探活 http://localhost:17311/api/health,再查 /api/query/{code}
- { path: '/local', name: 'local-service', component: () => import('@/views/LocalServiceView.vue'), meta: { public: true, bare: true } },
+ // 页面自己探活 http://localhost:17300/api/health,没登录就唤起软件登录,再查 /api/query/{code}
+ {
+ path: '/local',
+ alias: '/local/',
+ name: 'local-service',
+ component: () => import('@/views/LocalServiceView.vue'),
+ meta: { public: true, bare: true },
+ },
{ path: '/', name: 'home', component: () => import('@/views/HomeView.vue') },
{ path: '/devices', name: 'devices', component: () => import('@/views/DevicesView.vue') },
diff --git a/frontend/src/views/LocalServiceView.vue b/frontend/src/views/LocalServiceView.vue
index aa27a1f..735f001 100644
--- a/frontend/src/views/LocalServiceView.vue
+++ b/frontend/src/views/LocalServiceView.vue
@@ -1,11 +1,13 @@