本机服务端口改 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:
parent
51abccbaaf
commit
700394b56f
@ -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);
|
||||
|
||||
@ -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` 同步 + 插件目标地址同步 |
|
||||
|
||||
@ -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";
|
||||
|
||||
|
||||
@ -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
|
||||
|
||||
@ -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;
|
||||
}
|
||||
|
||||
@ -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') },
|
||||
|
||||
@ -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;
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user