本机服务端口改 17300,/api/health 带登录状态,网页可唤起软件登录

- 端口 17311 → **17300**(桌面端常量、localhost/127.0.0.1 双前缀、前端 LOCAL_BASE、
  插件默认目标与说明、两个 README 全部同步)。
- `/api/health` 返回值加上 `loggedIn` / `user`(由 App 提供:IsLoggedInProvider、UserNameProvider),
  前端只认 `ok`(探活),再用 `loggedIn` 决定要不要唤起登录。
- 新增 `POST /api/activate-login`:叫本机软件把登录窗(已登录则主界面)带到前台。
  用 POST 而不是 GET,避免被浏览器/聊天工具的链接预取误触发;CORS Allow-Methods 加了 POST。
- `/api/query/{code}` 未登录时返回 401(前端会转去唤起登录)。
- 桌面端:App 记住登录窗引用,收到 LoginRequested 时切回 UI 线程激活它(托盘里也能叫出来)。
- 前端 `/local?code=`:
  - 路由加 alias `/local/`;
  - 新增 need-login 状态:探活到「软件在跑但没登录」→ 自动 POST activate-login →
    每秒探活等登录(30s 上限)→ 登录完成后自动查询;期间有「再叫一次登录窗口」按钮与托盘提示;
  - api/local.ts 增加 localHealth()(online/loggedIn/user)、requestLocalLogin()、waitForLoggedIn();
    waitForHealth() 改为返回状态而非 bool;老版本软件没有 loggedIn 字段时按已登录处理(向后兼容)。
- 实测(7301 + 模拟的 17300):打开 /local/?code=… → 「本机软件未登录 / 正在等待登录…」→
  mock 翻成已登录后自动切到查询结果(5 行);杀掉 mock 后显示「服务暂不可用」且探测地址为 17300。
This commit is contained in:
liufumingren 2026-10-17 10:28:01 +08:00
parent 51abccbaaf
commit 700394b56f
7 changed files with 334 additions and 78 deletions

View File

@ -9,7 +9,7 @@ namespace YuncangTrace.LocalService;
/// 应用入口,负责四件事:
///
/// 1. **防多开**:全局互斥体;第二个实例把参数(可能是 `yuncang://open?code=xxx`)送给第一个实例后自己退出;
/// 2. **本机 HTTP 服务**(127.0.0.1:17311):登录前就起来,关窗口也不停(托盘里继续跑);
/// 2. **本机 HTTP 服务**(127.0.0.1:17300):登录前就起来,关窗口也不停(托盘里继续跑);
/// 3. **托盘图标**:关窗口 = 缩到托盘;只有从托盘菜单「退出」才真正退出;
/// 4. **登录**:有本地令牌先验证(`/api/web/me`),失效就弹登录窗;登录成功再开主窗口。
/// </summary>
@ -22,6 +22,7 @@ public partial class App : Application
private LocalHttpServer? _server;
private TrayIconService? _tray;
private MainWindow? _main;
private LoginWindow? _loginWindow;
private Session? _session;
private string? _pendingLaunchUrl;
private bool _exiting;
@ -49,6 +50,10 @@ public partial class App : Application
// ② 本机服务先起来(和登录状态无关)
_server = new LocalHttpServer(new OrderQueryService());
_server.Log += AppLog.Write;
// 网页靠 /api/health 里的 loggedIn 判断要不要唤起登录,靠 /api/activate-login 把登录窗叫到前台
_server.IsLoggedInProvider = () => _session is not null;
_server.UserNameProvider = () => _session?.DisplayName;
_server.LoginRequested += OnLoginRequested;
StartLocalServer();
// ③ 托盘
@ -87,7 +92,12 @@ public partial class App : Application
}
var login = new LoginWindow(_settings, saved);
if (login.ShowDialog() == true && login.Session is not null)
_loginWindow = login;
var accepted = login.ShowDialog() == true && login.Session is not null;
_loginWindow = null;
if (accepted)
{
_session = login.Session;
return true;
@ -96,6 +106,37 @@ public partial class App : Application
return false;
}
/// <summary>
/// 网页请求唤起登录(`POST /api/activate-login`):来自 HTTP 线程,切回 UI 线程处理
/// </summary>
private void OnLoginRequested()
{
Dispatcher.Invoke(() =>
{
// 已登录:把主界面叫到前台就够了
if (_session is not null)
{
ShowAppWindow();
return;
}
// 没登录:登录窗是模态的,一直在,只要把它叫到最前面
if (_loginWindow is not null)
{
if (_loginWindow.WindowState == WindowState.Minimized) _loginWindow.WindowState = WindowState.Normal;
_loginWindow.Activate();
_loginWindow.Topmost = true;
_loginWindow.Topmost = false;
_loginWindow.Focus();
return;
}
// 兜底(正常不会走到):直接走一次登录流程
if (ShowLogin()) ShowMainWindow();
});
}
/// <summary>退出登录:清令牌 → 关主窗口 → 重新登录(取消则退出程序)</summary>
private void OnLogoutRequested()
{
@ -183,8 +224,8 @@ public partial class App : Application
{
var hint = ex.ErrorCode switch
{
5 => "没有绑定端口的权限。用管理员执行一次:netsh http add urlacl url=http://localhost:17311/ user=%USERNAME%",
32 => "端口 17311 已被占用(可能还有一个本程序实例在跑)。",
5 => "没有绑定端口的权限。用管理员执行一次:netsh http add urlacl url=http://localhost:17300/ user=%USERNAME%",
32 => "端口 17300 已被占用(可能还有一个本程序实例在跑)。",
_ => $"启动本机服务失败:{ex.Message}",
};
AppLog.Write(hint);

View File

@ -4,11 +4,11 @@ Windows 桌面端,用**前端 `/local` 公共页**和 **Chrome 插件**做对
- **登录页**:账号密码登录后端(`POST /api/web/auth/login`)拿 user JWT,令牌存本机;
下次启动先用 `/api/web/me` 验证,还有效就直接进主界面;
- 在 `127.0.0.1:17311` 起一个本机 HTTP 服务,浏览器里的页面直接查询本机数据;
- 在 `127.0.0.1:17300` 起一个本机 HTTP 服务,浏览器里的页面直接查询本机数据;
- 注册 `yuncang://` 启动协议,网页可以「叫醒」本软件(前提是已安装);
- **托盘图标**:关窗口只是缩到托盘(本机服务不能因关窗断掉),双击托盘恢复窗口,
右键菜单有「打开主界面 / 服务地址 / 退出」;
- **防多开**:全局互斥体 + 命名管道 —— 第二个实例不会抢 17311 端口,而是把
- **防多开**:全局互斥体 + 命名管道 —— 第二个实例不会抢 17300 端口,而是把
`yuncang://open?code=xxx` 转给已运行的实例(在托盘里也会被叫出来并直接查询),然后自己退出。
```
@ -36,7 +36,7 @@ desktop/
| 场景 | 行为 |
| --- | --- |
| 首次启动 | 先起本机服务(17311)与托盘,再弹登录页 → 登录成功才出主窗口 |
| 首次启动 | 先起本机服务(17300)与托盘,再弹登录页 → 登录成功才出主窗口 |
| 已有令牌 | 登录窗一闪而过:`/api/web/me` 通过就直接进主窗口;失效则清掉令牌留在登录页 |
| 关窗口(X) | 隐藏到托盘,本机服务继续跑(第一次会冒一个气泡提示) |
| 再次双击 exe / 点网页「启动本机软件」 | 不会开第二个:把 `yuncang://open?code=…` 通过命名管道转给已运行实例 |
@ -70,29 +70,33 @@ dotnet publish -c Release -r win-x64 --self-contained false -o publish
dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -o publish
```
## 本机接口(前端 `/local` 页用的就是这两个)
## 本机接口(前端 `/local` 页用的就是这三个)
服务固定监听 `http://localhost:17311`(端口写在前端页面与插件里)。
代码里**同时注册了 `http://127.0.0.1:17311/`** 前缀 —— `HttpListener` 只接受「注册过的 host」,
服务固定监听 `http://localhost:17300`(端口写在前端页面与插件里)。
代码里**同时注册了 `http://127.0.0.1:17300/`** 前缀 —— `HttpListener` 只接受「注册过的 host」,
不注册的话用 127.0.0.1 访问会直接被回 400(前端改 `VITE_LOCAL_SERVICE` 时就会碰到)。
浏览器直接打开 <http://localhost:17311/> 会看到一个说明页(列了下面两个接口,方便排查)。
浏览器直接打开 <http://localhost:17300/> 会看到一个说明页(列了接口,方便排查)。
| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | `/api/health` | 探活:**只要能返回 2xx 就认为软件已启动**。返回 `{ ok, name, version, port, serverTime }` |
| GET | `/api/query/{code}` | 按运单号查信息。**成功时把字段平铺在顶层**(`{ code, orderNo, ... }`),失败返回 `{ ok:false, message }` + 4xx |
| GET | `/api/health` | 验活 + 登录状态:**2xx 即认为软件已启动**。返回 `{ ok, name, version, port, loggedIn, user, serverTime }` |
| GET | `/api/query/{code}` | 按运单号查信息(**需已登录**,否则 401 `{ ok:false, loggedIn:false, message }`)。成功时字段**平铺**在顶层(`{ code, orderNo, ... }`) |
| POST | `/api/activate-login` | 把本机软件的**登录窗叫到前台**(已登录时把主界面叫到前台)。网页发现 `loggedIn:false` 时自动调它 |
示例:
```powershell
curl http://localhost:17311/api/health
curl http://localhost:17311/api/query/321408064481776
curl http://localhost:17300/api/health
curl http://localhost:17300/api/query/321408064481776
curl -X POST http://localhost:17300/api/activate-login
```
为什么唤起登录用 **POST**:GET 会被浏览器/聊天工具的链接预取误触发,POST 不会。
浏览器跨域(页面在站点域名上,请求的是 localhost)必须回这些响应头,代码里已经处理:
- `Access-Control-Allow-Origin`(回显 Origin)、`Allow-Methods`、`Allow-Headers`、`Max-Age`
- `Access-Control-Allow-Origin`(回显 Origin)、`Allow-Methods`(`GET, POST, OPTIONS`)、`Allow-Headers`、`Max-Age`
- `Access-Control-Allow-Private-Network: true` —— 公网 https 页面访问 localhost 时 Chrome 会发
私有网络预检(PNA),不回这个头预检就失败
@ -126,13 +130,15 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command"
## 和前端 / 插件怎么配合
1. WMS 页面上点运单号旁的按钮 → 插件打开 `http://<站点>/local?code=<运单号>`;
2. `/local` 页先探活 `http://localhost:17311/api/health`:
- 通 → 直接调 `/api/query/{code}` 展示;
- 不通 → 提示「服务暂不可用 / 本地打印服务未启动,请下载安装后再试」+ 下载按钮;
点「已安装,启动本机软件」会走 `yuncang://open?code=...`,然后每 1s 轮询探活,起来后自动查询。
1. WMS 页面上点运单号旁的按钮 → 插件打开 `http://<站点>/local?code=<运单号>`(`/local/` 也认);
2. `/local` 页先探活 `http://localhost:17300/api/health`:
- **连不上** → 提示「服务暂不可用 / 本地打印服务未启动,请下载安装后再试」+ 下载按钮;
点「已安装,启动本机软件」会走 `yuncang://open?code=...`,然后每 1s 轮询探活;
- **连上了但 `loggedIn:false`**(软件没登录)→ 页面自动 `POST /api/activate-login`
把本机登录窗叫到前台,然后每秒探活等登录完成(最长 30s),登录好**自动继续查询**;
- **已登录** → 直接调 `/api/query/{code}` 展示(页面顶部会显示「本机软件已登录:xxx」)。
3. 本软件被协议拉起时,会拿到 `yuncang://open?code=xxx` 参数:已经开着就转给原窗口(单实例),
没开就启动并直接查询这个码。
没开就启动 → 先登录 → 登录完自动查询这个码(登录前收到的 code 会先存着)。
## ★ 接真实数据
@ -164,8 +170,8 @@ public QueryResult Query(string? code)
| 现象 | 处理 |
| --- | --- |
| 启动报「没有绑定端口的权限」/ `Access is denied (5)` | 管理员执行 `netsh http add urlacl url=http://localhost:17311/ user=%USERNAME%`,或改成以当前用户身份运行 |
| 启动报「没有绑定端口的权限」/ `Access is denied (5)` | 管理员执行 `netsh http add urlacl url=http://localhost:17300/ user=%USERNAME%`,或改成以当前用户身份运行 |
| 报端口被占用(错误 32) | 已经开了一个实例(单实例会把参数转过去);检查任务管理器里的残留进程 |
| 网页提示服务不可用,但软件在跑 | 先用浏览器直接打开 `http://localhost:17311/api/health`:打不开→防火墙/端口;打得开→多半是 CORS 头没回 |
| 网页提示服务不可用,但软件在跑 | 先用浏览器直接打开 `http://localhost:17300/api/health`:打不开→防火墙/端口;打得开→多半是 CORS 头没回 |
| 点网页「启动本机软件」没反应 | 协议没注册(界面看「启动协议」状态);或浏览器拦了自动跳转(必须用户点击) |
| 改了协议名 | 注册表重注册 + 前端 `VITE_APP_PROTOCOL` 同步 + 插件目标地址同步 |

View File

@ -22,12 +22,12 @@ namespace YuncangTrace.LocalService.Services;
///
/// 用 <see cref="HttpListener"/>(HTTP.sys):绑定 `http://localhost:端口/` 一般不需要管理员权限;
/// 若报「拒绝访问(5)」,用管理员执行一次:
/// <c>netsh http add urlacl url=http://localhost:17311/ user=%USERNAME%</c>
/// <c>netsh http add urlacl url=http://localhost:17300/ user=%USERNAME%</c>
/// </summary>
public sealed class LocalHttpServer : IDisposable
{
/// <summary>监听端口(前端/插件里写死的 17311)</summary>
public const int Port = 17311;
/// <summary>监听端口(前端/插件里写死的 17300)</summary>
public const int Port = 17300;
private readonly HttpListener _listener = new();
private readonly OrderQueryService _queryService;
@ -37,11 +37,23 @@ public sealed class LocalHttpServer : IDisposable
/// <summary>日志回调(服务线程 → UI 线程的桥,UI 那边自己 Dispatcher.Invoke)</summary>
public event Action<string>? Log;
/// <summary>网页请求唤起登录(`POST /api/activate-login`);服务线程触发,订阅方自己切 UI 线程</summary>
public event Action? LoginRequested;
/// <summary>当前是否已登录(由 App 提供,供 `/api/health` 用)</summary>
public Func<bool>? IsLoggedInProvider { get; set; }
/// <summary>当前登录用户显示名(由 App 提供,供 `/api/health` 用)</summary>
public Func<string?>? UserNameProvider { get; set; }
public LocalHttpServer(OrderQueryService queryService)
{
_queryService = queryService;
}
/// <summary>是否已登录(网页靠它判断要不要唤起登录)</summary>
public bool IsLoggedIn => IsLoggedInProvider?.Invoke() ?? false;
/// <summary>浏览器里可直接打开的地址</summary>
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
<style>body{font:14px/1.7 "Microsoft YaHei UI",sans-serif;margin:40px;color:#1f2430}
code{background:#f3f4f6;padding:1px 6px;border-radius:5px}a{color:#2563eb}</style>
<h2>云仓视频溯源软件(本机服务)</h2>
<p>服务运行中,只监听本机(127.0.0.1:17311)。</p>
<p>服务运行中,只监听本机(127.0.0.1:17300)。</p>
<ul>
<li><a href="/api/health">/api/health</a> 探活</li>
<li><code>/api/query/{运单号}</code> 按运单号查信息</li>
<li><a href="/api/health">/api/health</a> 探活(含登录状态)</li>
<li><code>/api/query/{运单号}</code> 按运单号查信息(需已登录)</li>
<li><code>POST /api/activate-login</code> 把登录窗叫到前台</li>
</ul>
""";
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";

View File

@ -11,7 +11,7 @@ namespace YuncangTrace.LocalService.Services;
/// 单实例 + 参数转发(命名管道)
///
/// 场景:窗口已经开着,用户又点了一次 WMS 页面上的「查看打包视频」→ 系统按协议再启动一次本程序。
/// 这时第二个实例**不应该**去抢 17311 端口,而是把 `yuncang://open?code=xxx` 通过管道送给第一个实例,
/// 这时第二个实例**不应该**去抢 17300 端口,而是把 `yuncang://open?code=xxx` 通过管道送给第一个实例,
/// 由它把窗口激活并查询那个运单号。
/// </summary>
public sealed class SingleInstance : IDisposable

View File

@ -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<T>(path: string, timeoutMs: number): Promise<T> {
/** 带超时的请求;返回解析后的 JSON(不是 JSON 就给纯文本) */
async function request<T>(path: string, timeoutMs: number, method: 'GET' | 'POST' = 'GET'): Promise<T> {
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<T>(path: string, timeoutMs: number): Promise<T> {
}
}
function get<T>(path: string, timeoutMs: number): Promise<T> {
return request<T>(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<boolean> {
export async function localHealth(): Promise<LocalHealth> {
try {
const data = await get<unknown>('/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<string, unknown>;
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<boolean> {
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<boolean> {
export async function waitForHealth(timeoutMs = 12000, intervalMs = 1000): Promise<LocalHealth> {
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<LocalHealth> {
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;
}

View File

@ -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') },

View File

@ -1,11 +1,13 @@
<script setup lang="ts">
/**
* 本机软件(打印服务)公共页 —— **不需要登录**,给 Chrome 插件直接打开用
* 本机软件(打印服务)公共页 —— **不需要登录网站**,给 Chrome 插件直接打开用
*
* 流程:
* 1. 打开就探活 `GET http://localhost:17311/api/health`;
* 2. 探不到 → 「服务暂不可用 / 本地打印服务未启动,请下载安装后再试」+ 下载按钮(居中);
* 3. 探到了 → 用插件带过来的 `?code=`(运单号)调 `GET /api/query/{code}`,把返回信息展示出来。
* 1. 打开就探活 `GET http://localhost:17300/api/health`;
* 2. 连不上 → 「服务暂不可用 / 本地打印服务未启动,请下载安装后再试」+ 下载按钮 + 「启动本机软件」;
* 3. 连上了但**本机软件没登录** → 自动请求 `POST /api/activate-login` 把登录窗叫到前台,
* 然后每秒探活等登录完成(最长 30s),登录好自动继续;
* 4. 已登录 → 用插件带过来的 `?code=`(运单号)调 `GET /api/query/{code}`,把返回信息展示出来。
*
* 前端路由:`/local?code=xxx`(`meta.public`,未登录也能看);插件里把目标地址模板写成
* `http://<站点>/local?code={code}` 即可。
@ -14,12 +16,15 @@ import { computed, onMounted, ref } from 'vue';
import { useRoute, useRouter } from 'vue-router';
import {
APP_PROTOCOL,
checkLocalHealth,
launchApp,
localHealth,
requestLocalLogin,
queryLocalInfo,
waitForHealth,
waitForLoggedIn,
LOCAL_BASE,
LocalServiceError,
type LocalHealth,
} from '@/api/local';
/**
@ -31,7 +36,7 @@ const DOWNLOAD_URL = (import.meta.env.VITE_SOFTWARE_DOWNLOAD_URL as string | und
const route = useRoute();
const router = useRouter();
type Status = 'checking' | 'offline' | 'launching' | 'ready';
type Status = 'checking' | 'offline' | 'launching' | 'need-login' | 'ready';
const status = ref<Status>('checking');
const code = ref(String(route.query.code || '').trim());
@ -40,34 +45,97 @@ const querying = ref(false);
const error = ref('');
const launchFailed = ref(false);
/** 探活:连不上就是「软件没启动」 */
/** 本机软件当前登录用户(health 里带回来的) */
const loggedUser = ref<string | null>(null);
/** 正在等用户在软件里完成登录 */
const waitingLogin = ref(false);
const emptyHealth: LocalHealth = { online: false, loggedIn: false, user: null };
/** 探活 + 按状态往下走 */
async function detect() {
status.value = 'checking';
error.value = '';
launchFailed.value = false;
const alive = await checkLocalHealth();
status.value = alive ? 'ready' : 'offline';
if (alive) await runQuery();
const health = await localHealth();
if (!health.online) {
status.value = 'offline';
return;
}
if (!health.loggedIn) {
await requireLogin(health);
return;
}
await enterReady(health);
}
/**
* 「启动本机软件」:用自定义协议叫醒(浏览器会问一次),再轮询探活
*
* 网页不能直接跑 exe —— 只能让系统按注册的协议去拉起(百度云盘/迅雷就是这个路子)。
*/
/** 已登录:展示 + 查询 */
async function enterReady(health: LocalHealth) {
loggedUser.value = health.user;
status.value = 'ready';
await runQuery();
}
/** 本机软件没登录:唤起登录窗并等登录完成 */
async function requireLogin(health: LocalHealth = emptyHealth) {
status.value = 'need-login';
loggedUser.value = health.user;
await askLogin();
}
/** 请求唤起登录窗,并轮询等登录完成(30s) */
async function askLogin() {
waitingLogin.value = true;
try {
await requestLocalLogin();
} catch {
// 唤起失败也继续轮询:用户可能自己从托盘打开软件登录
}
const health = await waitForLoggedIn(30000);
if (!health.online) {
status.value = 'offline';
waitingLogin.value = false;
return;
}
if (health.loggedIn) {
waitingLogin.value = false;
await enterReady(health);
return;
}
// 30s 还没登录:留在提示页,用户可再点一次
waitingLogin.value = false;
}
/** 「启动本机软件」:自定义协议叫醒 → 轮询探活 → 需要登录就唤起登录 */
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();
const health = await waitForHealth();
if (!health.online) {
launchFailed.value = true;
status.value = 'offline';
return;
}
launchFailed.value = true;
status.value = 'offline';
if (!health.loggedIn) {
await requireLogin(health);
return;
}
await enterReady(health);
}
/** 按码查信息(没填码就只停在输入框) */
@ -81,6 +149,12 @@ async function runQuery() {
try {
info.value = await queryLocalInfo(target);
} catch (err) {
if (err instanceof LocalServiceError && err.status === 401) {
// 刚好在这期间退出了登录:再走一次唤起登录
await requireLogin();
return;
}
error.value = err instanceof LocalServiceError
? `查询失败:${err.message}`
: '查询失败,请确认本机软件已启动后重试';
@ -152,8 +226,29 @@ onMounted(detect);
</p>
</template>
<!-- ③ 本机软件在跑 -->
<!-- ③ 软件在跑,但没登录 → 唤起软件登录 -->
<template v-else-if="status === 'need-login'">
<div class="notice center-block">
<b>本机软件未登录</b>
</div>
<p class="center hint">已在本机弹出登录窗口,请完成登录</p>
<p v-if="waitingLogin" class="center hint">正在等待登录…(登录成功后本页会自动继续)</p>
<p class="center">
<button class="btn" type="button" :disabled="waitingLogin" @click="askLogin">
{{ waitingLogin ? '等待登录中…' : '再叫一次登录窗口' }}
</button>
</p>
<p class="center hint tiny">
看不到窗口?双击托盘里的「云仓视频溯源软件」图标
<br>
(探测地址:{{ LOCAL_BASE }})
</p>
</template>
<!-- ④ 已登录:查询 -->
<template v-else>
<p v-if="loggedUser" class="center hint tiny">本机软件已登录:{{ loggedUser }}</p>
<div v-if="!code" class="field-plain">
<span class="tip">必填 · 运单号 / 条码</span>
<div class="input-row">
@ -213,6 +308,17 @@ onMounted(detect);
text-align: center;
}
/* 「未登录」提示:不是错误,用品牌色淡底 */
.notice {
margin-bottom: 14px;
padding: 10px 12px;
border-radius: 8px;
background: #eff6ff;
color: #1d4ed8;
border: 1px solid #bfdbfe;
font-size: 14px;
}
.download {
display: inline-block;
padding: 10px 22px;