主界面移除协议状态文字;修复「未登录/网络异常时不会自动更新」与「误清登录令牌」

一、UI
- 主界面删除「已注册 yuncang://(网页可叫醒本软件)」整行(`ProtocolText`),
  行定义 4→3(标题 / 查询 / 日志);删除 `UpdateProtocolState()` 及其调用。
  协议对用户是内部实现,不展示;注册由 MSI 完成、卸载自动删除、启动自动校正。

二、修复(本次测试暴露的真实缺陷)
1. **更新检查提前到登录之前**(`App.OnStartup`):
   原来放在 `ShowMainWindow()` 之后,一旦本地令牌失效/未登录,软件停在登录窗,
   **永远不会检查更新**(实测 1.0.7 → 1.0.8 卡在登录窗 180s 未更新)。
2. **`ApiClient.MeAsync` 不再把网络错误当成"令牌失效"**:
   原来 catch(ApiException) → return null,调用方据此 `SessionStore.Clear()`,
   后端启动中/一时连不上就会**误删 session.json**(本次就丢了登录态)。
   现在只有 401/403 返回 null;超时/连不上/5xx 抛异常 → 登录窗保留令牌并提示,
   下次启动仍可自动登录。

三、验证(标准流程:打包 → 启动旧版 → 自动更新)
- 打包 1.0.9(含修复)并安装(旧版 1.0.7 因缺陷无法自更新,只能手工升级一次);
- 打包 1.0.10 → `test-update.ps1`:
    当前安装 1.0.9(**处于登录窗,未登录**)→ 后端目标 1.0.10
    [4s] 1.0.9 → [10s] 1.0.10
    ✔ 自动更新完成:1.0.9 → 1.0.10(耗时 10.1s)
    ✔ 本机服务 17300 有响应(HTTP 401)
    ✔ 软件进程已恢复
  证明「未登录也能检测并完成更新」。

四、待用户操作:本次测试中 session.json 被旧逻辑误删,需要**重新登录一次**;
   之后的版本不会因为网络抖动再丢登录态。
This commit is contained in:
liufumingren 2026-10-17 16:59:23 +08:00
parent 457fbd6c9e
commit 2ab3ad35e5
5 changed files with 34 additions and 53 deletions

View File

@ -78,7 +78,10 @@ public partial class App : Application
AppLog.Write($"本机服务:{_server.BaseUrl}({(_server.IsRunning ? "运行中" : "未启动")})");
AppLog.Write($"环境:{BuildInfo.EnvironmentLabel},后端:{_settings.ServerBaseUrl}");
// ④ 登录 → 主窗口
// ④ 检查更新(**不依赖登录**:令牌失效/未登录时也要能更新;放登录之前)
_ = CheckUpdatesAsync();
// ⑤ 登录 → 主窗口
if (!ShowLogin())
{
ExitApplication();
@ -86,9 +89,6 @@ public partial class App : Application
}
ShowMainWindow();
// ⑤ 检查更新(后台;失败静默,不影响使用)
_ = CheckUpdatesAsync();
}
/// <summary>

View File

@ -10,7 +10,6 @@
FontSize="13">
<Grid Margin="18">
<Grid.RowDefinitions>
<RowDefinition Height="Auto" />
<RowDefinition Height="Auto" />
<RowDefinition Height="Auto" />
<RowDefinition Height="*" />
@ -32,12 +31,8 @@
</StackPanel>
</DockPanel>
<!-- ② 协议状态(协议由安装包注册、卸载自动取消;本机服务随程序运行,不提供停止/启动按钮) -->
<TextBlock x:Name="ProtocolText" Grid.Row="1" Margin="2,0,0,10"
Foreground="{StaticResource MutedBrush}" TextTrimming="CharacterEllipsis" />
<!-- ③ 查询测试 -->
<Border Grid.Row="2" Background="White" BorderBrush="{StaticResource LineBrush}"
<!-- ② 查询测试 -->
<Border Grid.Row="1" Background="White" BorderBrush="{StaticResource LineBrush}"
BorderThickness="1" CornerRadius="8" Padding="12,10" Margin="0,0,0,10">
<StackPanel>
<DockPanel>
@ -54,8 +49,8 @@
</StackPanel>
</Border>
<!-- ⑤ 日志 -->
<Grid Grid.Row="3">
<!-- ③ 日志 -->
<Grid Grid.Row="2">
<Grid.RowDefinitions>
<RowDefinition Height="Auto" />
<RowDefinition Height="Auto" />

View File

@ -47,7 +47,6 @@ public partial class MainWindow : Window
Loaded += (_, _) =>
{
UpdateServerState();
UpdateProtocolState();
};
Closing += OnClosing;
Closed += (_, _) => AppLog.Written -= OnLogWritten;
@ -85,30 +84,6 @@ public partial class MainWindow : Window
StatusDot.Fill = (Brush)FindResource(running ? "OkBrush" : "BadBrush");
}
// ---------------- 启动协议 ----------------
/// <summary>
/// 协议状态只做展示:**注册由安装包完成、卸载时由 MSI 自动删除**;
/// 运行时启动时会自动校正到当前 exe(App.EnsureProtocolRegistered)。
/// UI 上不提供手动注册/取消 —— 手动取消会让网页再也叫不醒软件,属于误操作。
/// </summary>
private void UpdateProtocolState()
{
var registered = ProtocolHelper.IsRegistered();
var command = ProtocolHelper.RegisteredCommand();
var exe = Environment.ProcessPath;
// 注册表指向的必须就是当前这个 exe(否则网页叫醒拿到的是旧路径/开发目录里的 exe)
var pointsToMe = command is not null && exe is not null
&& command.IndexOf(exe, StringComparison.OrdinalIgnoreCase) >= 0;
ProtocolText.Text = !registered
? $"未注册 {ProtocolHelper.Scheme}://(网页无法叫醒本软件,重新运行安装包可修复)"
: pointsToMe
? $"已注册 {ProtocolHelper.Scheme}://(网页可叫醒本软件)"
: $"已注册,但指向旧路径(重启本软件会自动校正)";
}
// ---------------- 查询 ----------------
private void Query_Click(object sender, RoutedEventArgs e) => RunQuery();

View File

@ -338,8 +338,8 @@ HKEY_CURRENT_USER\Software\Classes\yuncang
- **每次启动都会自动把注册项校正到「当前这个 exe」**(幂等)。这一点很关键:
换目录安装、从 `bin\Debug` 换成发布版、重新装一遍之后,注册表里残留的旧路径会让网页
唤起一个不存在 / 缺运行时的 exe(典型现象就是弹「You must install .NET」或干脆没反应)。
- **界面只显示协议状态,不提供手动注册/取消**:注册由安装包完成、卸载时 MSI 自动删除;
留一个「取消」按钮只会让用户误点后网页再也叫不醒软件(要恢复还得重装)。
- **界面上完全不展示协议**:注册由安装包完成、卸载时 MSI 自动删除,启动时自动校正到当前 exe;
用户不需要知道 `yuncang://` 这回事(排障看日志或注册表即可)。
- 手工注册/排查:
```powershell

View File

@ -1,4 +1,5 @@
using System;
using System.Net;
using System.Net.Http;
using System.Text;
using System.Text.Json;
@ -86,26 +87,36 @@ public sealed class ApiClient
return (session, user);
}
/// <summary>校验令牌是否还有效(`GET /api/web/me`),无效返回 null</summary>
/// <summary>
/// 校验令牌是否还有效(`GET /api/web/me`)。
/// </summary>
/// <returns>令牌有效返回用户;**401/403 返回 null**(真失效,调用方可以清掉本地令牌)</returns>
/// <exception cref="ApiException">网络不通 / 超时 / 服务端 5xx —— 不能当成“登录失效”,否则会误删令牌</exception>
public async Task<ApiUser?> MeAsync(string token, CancellationToken ct = default)
{
try
using var response = await SendAsync(() =>
{
using var response = await SendAsync(() =>
{
var request = new HttpRequestMessage(HttpMethod.Get, $"{BaseUrl}/api/web/me");
request.Headers.TryAddWithoutValidation("Authorization", $"Bearer {token}");
return request;
}, "校验登录态", ct).ConfigureAwait(false);
var request = new HttpRequestMessage(HttpMethod.Get, $"{BaseUrl}/api/web/me");
request.Headers.TryAddWithoutValidation("Authorization", $"Bearer {token}");
return request;
}, "校验登录态", ct).ConfigureAwait(false);
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, _) = ReadEnvelope(response, text);
return data is null ? null : ReadUser(data.Value);
}
catch (ApiException)
// 只有 401/403 才是「令牌真失效」;5xx / 网关错误不应该让客户端把登录态抹掉
if (response.StatusCode is HttpStatusCode.Unauthorized or HttpStatusCode.Forbidden)
{
return null;
}
if (!response.IsSuccessStatusCode)
{
throw new ApiException(
$"校验登录态失败(HTTP {(int)response.StatusCode})",
(int)response.StatusCode);
}
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, _) = ReadEnvelope(response, text);
return data is null ? null : ReadUser(data.Value);
}
/// <summary>发请求:连不上时翻成「无法连接服务器」这种能看懂的提示</summary>