packServer/desktop/Services/AppSettings.cs
liufumingren 228723e0c3 设备端扫码上报 + 桌面端/Android 正式包发布脚手架
AndroidStation(原中控改造为纯设备端)
- 只做三件事:UDP 48899 被桌面端发现、TCP 8087 推送 USB 扫码结果、离线语音播报
- 扫码不再经过 UI:去掉逐键重绘,50ms 自动提交,同一码重复扫码也一律上报
- 离线语音种子(数字/字母/“开始打包”/欢迎语)随包安装,MediaPlayer 播放,启动把音量拉满
- 启动播报「欢迎使用溯源系统,初始化已经完成,扫码即可开始打包」
- 移除 Device Owner / 设备管理员 / lock task / 网络与 IP 设置等非普通应用能力(仅保留开机自启)
- 正式签名 keystore + release 签名配置,versionName/versionCode 可由打包脚本覆盖

发布脚手架
- backend/android_client:Android 正式包构建(build.ps1 + package.config.json)
- backend/scripts/deploy/publish-android.cjs + npm run android:build / android:publish
- 桌面端安装包改为 download/desktop,Android 为 download/android_client;
  version.json 仍走 /download/version.json(老客户端写死),新增 /download/android_client/version.json
- 谷歌插件随桌面端 MSI 安装到 <安装目录>\extension,工具菜单新增「复制谷歌插件地址」
- git-safety-check 增加仓库级禁区(keystore.properties / *.jks / local.properties)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 05:53:27 +08:00

268 lines
11 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

using System;
using System.IO;
using System.Text.Encodings.Web;
using System.Text.Json;
namespace YuncangTrace.LocalService.Services;
/// <summary>
/// 本机设置:`%LOCALAPPDATA%\YuncangTrace\settings.json`
///
/// 目前只有「服务器地址」(登录用的后端)和「记住账号」。
/// 服务器地址的**默认值**来自构建环境(<see cref="BuildInfo"/>),用户没改过就不落盘,
/// 这样 Debug / Release 两个构建各自连自己的后端,不会互相污染。
/// </summary>
public sealed class AppSettings
{
/// <summary>当前构建的默认后端地址(Debug = 本地 7300,Release = 正式站点)</summary>
public static string DefaultServer => BuildInfo.DefaultServer;
/// <summary>后端 API 根地址(登录、校验令牌都走它)</summary>
public string ServerBaseUrl { get; set; } = DefaultServer;
/// <summary>地址来自命令行/环境变量的临时覆盖(不落盘)</summary>
[System.Text.Json.Serialization.JsonIgnore]
public bool ServerIsVolatile { get; private set; }
/// <summary>上次登录的账号(只在「记住账号」勾选时保存)</summary>
public string LastAccount { get; set; } = string.Empty;
/// <summary>是否记住账号</summary>
public bool RememberAccount { get; set; } = true;
// ---------------- 主体(租户) ----------------
/// <summary>上次选择的主体 id(0 = 未选)</summary>
public int SubjectId { get; set; }
/// <summary>上次选择的主体名称(仅界面展示)</summary>
public string SubjectName { get; set; } = string.Empty;
/// <summary>我在该主体里的角色(1 管理员 / 2 成员):非管理员看不到「开启设备服务」</summary>
public int SubjectRole { get; set; } = 2;
// ---------------- 设备服务(本机作为扫码中控上报;**默认关闭**) ----------------
/// <summary>是否已开启设备服务</summary>
public bool DeviceServiceEnabled { get; set; }
/// <summary>本机设备 id(服务端 scanners.id)</summary>
public int DeviceId { get; set; }
/// <summary>本机设备 SN(默认用机器名,可手工指定)</summary>
public string DeviceSn { get; set; } = string.Empty;
/// <summary>设备长期 JWT(上报用;关闭服务时清空)</summary>
public string DeviceToken { get; set; } = string.Empty;
/// <summary>设备刷新令牌(服务用它自动续期访问令牌;关闭服务时清空)</summary>
public string DeviceRefreshToken { get; set; } = string.Empty;
/// <summary>设备令牌到期时间(展示用)</summary>
public string DeviceTokenExpiresAt { get; set; } = string.Empty;
// ---------------- 录像存储 ----------------
/// <summary>
/// 录像根目录(空 = 默认 <c>~/packVideo</c>)
///
/// 实际放在这里的文件按 <c>年/月/日</c> 分子目录(见 <see cref="VideoStorage.FolderFor"/>),
/// 例如 <c>~/packVideo/2026/03/11/7915…_合并_20260311_101500.mp4</c>。
/// </summary>
public string VideoRoot { get; set; } = string.Empty;
/// <summary>解析后的录像根目录(没设置就是默认值)</summary>
[System.Text.Json.Serialization.JsonIgnore]
public string VideoRootResolved => string.IsNullOrWhiteSpace(VideoRoot)
? VideoStorage.DefaultRoot
: VideoRoot;
// ---------------- NTP 校时(本机系统时钟) ----------------
/// <summary>是否启用 NTP 校时(总开关;关闭后启动/定时都不再校时)</summary>
public bool NtpEnabled { get; set; } = true;
/// <summary>NTP 服务器(域名或 IP)</summary>
public string NtpServer { get; set; } = "ntp.aliyun.com";
/// <summary>启动时是否自动校时</summary>
public bool NtpSyncOnStartup { get; set; } = true;
/// <summary>
/// 运行期间的自动校时间隔(分钟;0 = 只在启动时校一次)
/// 本机会持续漂移,定时校一次能避免「跑一天又差几秒」。
/// </summary>
public int NtpSyncIntervalMinutes { get; set; } = 30;
/// <summary>上次校时时间(展示用,格式 yyyy-MM-dd HH:mm:ss)</summary>
public string NtpLastSyncAt { get; set; } = string.Empty;
/// <summary>上次校时前的本机偏差(秒,正数 = 本机慢了)</summary>
public double NtpLastOffsetSeconds { get; set; }
private static string Dir => Path.Combine(
Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "YuncangTrace");
private static string FilePath => Path.Combine(Dir, "settings.json");
private static readonly JsonSerializerOptions Options = new()
{
WriteIndented = true,
Encoder = JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
};
/// <summary>读设置(读不到就用默认值,绝不抛)</summary>
public static AppSettings Load()
{
try
{
if (!File.Exists(FilePath)) return new AppSettings();
var settings = JsonSerializer.Deserialize<AppSettings>(File.ReadAllText(FilePath));
if (settings is null) return new AppSettings();
// 文件里存的是空串 = 用户没改过,用当前构建的默认值;
// 老版本会把默认地址直接落盘,所以「等于任何已知默认值」也当作没改过,跟随当前构建。
// 同一个域名只换了协议(http → https 强制跳转后 POST 会被降级成 GET)也按默认值处理。
var stored = Normalize(settings.ServerBaseUrl);
settings.ServerBaseUrl = IsKnownDefault(stored) || IsSameHostAsDefault(stored) ? DefaultServer : stored;
return settings;
}
catch (Exception ex)
{
AppLog.Write($"读取设置失败(用默认值):{ex.Message}");
return new AppSettings();
}
}
/// <summary>运行时指定后端地址(<c>--server=</c> / <c>YUNCANG_SERVER</c>),只影响本次运行</summary>
public void UseServer(string? url)
{
var value = (url ?? string.Empty).Trim();
if (value.Length == 0) return;
ServerBaseUrl = Normalize(value);
ServerIsVolatile = true;
AppLog.Write($"后端地址已被临时覆盖:{ServerBaseUrl}(不保存)");
}
/// <summary>存设置(失败只记日志)</summary>
public void Save()
{
try
{
ServerBaseUrl = Normalize(ServerBaseUrl);
if (!RememberAccount) LastAccount = string.Empty;
Directory.CreateDirectory(Dir);
// 等于构建默认值(或只是临时覆盖)就写空串:换环境构建时能自动跟随,只有用户手改的地址才落盘
var stored = ServerIsVolatile || ServerBaseUrl == DefaultServer ? string.Empty : ServerBaseUrl;
var payload = new StoredSettings
{
ServerBaseUrl = stored,
LastAccount = LastAccount,
RememberAccount = RememberAccount,
SubjectId = SubjectId,
SubjectName = SubjectName,
SubjectRole = SubjectRole,
DeviceServiceEnabled = DeviceServiceEnabled,
DeviceId = DeviceId,
DeviceSn = DeviceSn,
DeviceToken = DeviceToken,
DeviceTokenExpiresAt = DeviceTokenExpiresAt,
DeviceRefreshToken = DeviceRefreshToken,
NtpEnabled = NtpEnabled,
NtpServer = NtpServer,
NtpSyncOnStartup = NtpSyncOnStartup,
NtpSyncIntervalMinutes = NtpSyncIntervalMinutes,
NtpLastSyncAt = NtpLastSyncAt,
NtpLastOffsetSeconds = NtpLastOffsetSeconds,
};
File.WriteAllText(FilePath, JsonSerializer.Serialize(payload, Options));
}
catch (Exception ex)
{
AppLog.Write($"保存设置失败:{ex.Message}");
}
}
/// <summary>统一成 `http://host:port` 形式(去掉末尾斜杠,没写协议就补 http://)</summary>
public static string Normalize(string? url)
{
var value = (url ?? string.Empty).Trim();
if (value.Length == 0) return DefaultServer;
if (!value.Contains("://", StringComparison.Ordinal)) value = "http://" + value;
return value.TrimEnd('/');
}
/// <summary>是不是"内置默认地址"之一(老版本落盘过这些值,不该当成用户自定义)</summary>
private static bool IsKnownDefault(string url)
{
return url.Equals(DefaultServer, StringComparison.OrdinalIgnoreCase)
|| url.Equals(Normalize(BuildInfo.DevServer), StringComparison.OrdinalIgnoreCase)
|| url.Equals(Normalize(BuildInfo.ProdServerPlaceholder), StringComparison.OrdinalIgnoreCase);
}
/// <summary>和默认地址是同一台服务器,只是协议不同(例如强制 HTTPS 之前落盘的 http 地址)</summary>
public static bool IsSameHostAsDefault(string? url)
{
if (!Uri.TryCreate(Normalize(url), UriKind.Absolute, out var stored)
|| !Uri.TryCreate(DefaultServer, UriKind.Absolute, out var current))
{
return false;
}
if (!string.Equals(stored.Host, current.Host, StringComparison.OrdinalIgnoreCase)) return false;
if (current.Scheme != Uri.UriSchemeHttps || stored.Scheme != Uri.UriSchemeHttp) return false;
// 只认「默认端口」的旧地址(http://host 与 https://host),不碰用户自己加的端口
return stored.Port == current.Port || (stored.Port == 80 && current.Port == 443);
}
/// <summary>落盘用的结构(和本类的可读属性一一对应)</summary>
private sealed class StoredSettings
{
public string ServerBaseUrl { get; set; } = string.Empty;
public string LastAccount { get; set; } = string.Empty;
public bool RememberAccount { get; set; } = true;
public int SubjectId { get; set; }
public string SubjectName { get; set; } = string.Empty;
public int SubjectRole { get; set; } = 2;
public bool DeviceServiceEnabled { get; set; }
public int DeviceId { get; set; }
public string DeviceSn { get; set; } = string.Empty;
public string DeviceToken { get; set; } = string.Empty;
public string DeviceTokenExpiresAt { get; set; } = string.Empty;
public string DeviceRefreshToken { get; set; } = string.Empty;
// ---------------- NTP 校时 ----------------
public bool NtpEnabled { get; set; } = true;
public string NtpServer { get; set; } = "ntp.aliyun.com";
public bool NtpSyncOnStartup { get; set; } = true;
public int NtpSyncIntervalMinutes { get; set; } = 30;
public string NtpLastSyncAt { get; set; } = string.Empty;
public double NtpLastOffsetSeconds { get; set; }
}
}