packServer/desktop/Services/AppSettings.cs

251 lines
9.9 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();
// 文件里存的是空串 = 用户没改过,用当前构建的默认值;
// 老版本会把默认地址直接落盘,所以「等于任何已知默认值」也当作没改过,跟随当前构建。
var stored = Normalize(settings.ServerBaseUrl);
settings.ServerBaseUrl = IsKnownDefault(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>落盘用的结构(和本类的可读属性一一对应)</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; }
}
}