using System.ComponentModel; using System.Runtime.CompilerServices; using Avalonia.Threading; using ClassHelper.ClassIslandPlugin.Models; using ClassHelper.ClassIslandPlugin.Services; using ClassIsland.Core.Abstractions.Controls; using ClassIsland.Core.Attributes; using ClassIsland.Core.Enums.SettingsWindow; using CommunityToolkit.Mvvm.Input; namespace ClassHelper.ClassIslandPlugin.Views; /// /// 「班级小助手联动」设置页。 /// /// 页面上的绑定源就是本页自己(DataContext = this): 暴露全部配置项, /// 暴露运行状态。这样 XAML 里能直接写 {Binding Settings.Xxx}, /// 不需要再套一层 ViewModel,改配置项时也少一处"两边同步"的机会。 /// // 图标用 Fluent 字体的码位(与 ClassIsland 内置设置页写法一致):未选中/选中同一枚插头图标 [SettingsPageInfo( "classhelper.classisland.bridge.settings", "班级小助手联动", "\uE71B", "\uE71B", SettingsPageCategory.External)] public partial class BridgeSettingsPage : SettingsPageBase, INotifyPropertyChanged { public BridgeSettingsPage(PluginSettings settings, BridgeService bridge) { Settings = settings; Bridge = bridge; ReportCommand = new AsyncRelayCommand(ReportAsync); TestCommand = new AsyncRelayCommand(TestAsync); PullCommand = new AsyncRelayCommand(PullAsync); MirrorCommand = new AsyncRelayCommand(MirrorAsync); InitializeComponent(); DataContext = this; Raise(nameof(StatusText)); } public PluginSettings Settings { get; } public BridgeService Bridge { get; } public IAsyncRelayCommand ReportCommand { get; } public IAsyncRelayCommand TestCommand { get; } public IAsyncRelayCommand PullCommand { get; } public IAsyncRelayCommand MirrorCommand { get; } private PropertyChangedEventHandler? _propertyChanged; /// /// 显式实现 :AvaloniaObject 自带一个同名但类型不同的事件, /// 直接声明会遮蔽基类成员。显式实现既不影响 Avalonia 的绑定查找(它按接口取),也不会有歧义。 /// event PropertyChangedEventHandler? INotifyPropertyChanged.PropertyChanged { add => _propertyChanged += value; remove => _propertyChanged -= value; } /* ---------------------------------------------------------------- 绑定用的展示文本 */ /// 一句话结论:还没配 / 已配置 / 已连接 / 连接异常。 public string StatusText { get { if (!Settings.IsConfigured) return "尚未配置:请填写服务器地址与设备令牌"; if (!Bridge.IsAttached) return "已填写配置,等待 ClassIsland 课程服务就绪"; return Bridge.LastReportOk ? "已连接" : "连接异常"; } } public string DetailText { get { var week = Bridge.LastServerWeek?.ToString() ?? "—"; return $"最后上报:{Bridge.LastReportAtText} 教学周:{week} " + $"课表 {Bridge.LastScheduleEntryCount} 节 / 节次 {Bridge.LastTimeLayoutItemCount} 条 " + $"已弹出提醒:{Bridge.NotificationCount} 条"; } } /// 调试信息(设置页里打开"显示调试信息"才可见)。 public string DebugText { get { var lines = new List { $"服务器地址:{(string.IsNullOrWhiteSpace(Settings.ServerUrl) ? "(未填)" : Settings.ServerUrl)}", $"设备令牌:{(string.IsNullOrWhiteSpace(Settings.DeviceToken) ? "(未填)" : Mask(Settings.DeviceToken))}", $"设备标识:{(string.IsNullOrWhiteSpace(Settings.DeviceKey) ? "(未生成)" : Settings.DeviceKey)}", $"课程服务:{(Bridge.IsAttached ? "已接入" : "未接入")}", $"与服务端时钟差:{Bridge.ClientTimeOffsetText}", $"ClassIsland 版本:{SafeVersion()}", $"配置目录:{PluginConfigFolder}", }; return string.Join(Environment.NewLine, lines); } } /// 设置页所在的插件配置目录(从插件入口拿;拿不到时留空)。 private string PluginConfigFolder => ClassIsland.Shared.IAppHost.TryGetService()?.PluginConfigFolder ?? "—"; private static string SafeVersion() { try { return ClassIsland.Core.AppBase.AppVersion ?? "—"; } catch { return "—"; } } /// 令牌只露头尾,避免设置页截图时把可用凭证泄露出去。 private static string Mask(string token) => token.Length <= 14 ? token : $"{token[..12]}…{token[^4..]}"; /* ---------------------------------------------------------------- 交互 */ private async Task ReportAsync() { await Bridge.ReportAsync("手动").ConfigureAwait(true); } /// 不带课表上报一次:用来快速验证"地址 + 令牌"是否可用,不会因为课表为空而出错。 private async Task TestAsync() { await Bridge.ReportAsync("连接检查", includeSchedule: false).ConfigureAwait(true); } private async Task PullAsync() { await Bridge.PullPendingAsync().ConfigureAwait(true); } private async Task MirrorAsync() { await Bridge.MirrorScheduleAsync().ConfigureAwait(true); } private void OnSettingsChanged(object? sender, PropertyChangedEventArgs args) { // 影响上报链路的改动需要立刻重建定时器;纯界面项(如"显示调试信息")不用管 if (args.PropertyName is nameof(PluginSettings.ServerUrl) or nameof(PluginSettings.DeviceToken) or nameof(PluginSettings.AutoReport) or nameof(PluginSettings.ReportIntervalSeconds) or nameof(PluginSettings.ReceiveNotifications) or nameof(PluginSettings.NotificationPollSeconds)) { Bridge.RestartTimer(); } Raise(nameof(StatusText)); Raise(nameof(DebugText)); } private void OnBridgeChanged(object? sender, PropertyChangedEventArgs args) { // Bridge 的属性变化可能来自线程池(HttpClient 回调),绑定必须在 UI 线程上更新 if (Dispatcher.UIThread.CheckAccess()) { RaiseStateProperties(); } else { Dispatcher.UIThread.Post(RaiseStateProperties); } } private void RaiseStateProperties() { Raise(nameof(StatusText)); Raise(nameof(DetailText)); Raise(nameof(DebugText)); } private void OnLoaded(object sender, Avalonia.Interactivity.RoutedEventArgs args) { // 改完地址/令牌/间隔要重建定时器,否则"改了设置但上报节奏还是旧的" Settings.PropertyChanged += OnSettingsChanged; // 运行状态(上一次上报结果 / 待弹出提醒数)变了要刷新状态卡片 Bridge.PropertyChanged += OnBridgeChanged; } private void OnUnloaded(object sender, Avalonia.Interactivity.RoutedEventArgs args) { Settings.PropertyChanged -= OnSettingsChanged; Bridge.PropertyChanged -= OnBridgeChanged; } private void Raise([CallerMemberName] string? propertyName = null) => _propertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName)); }