feat: 落地 V1 全部源码 — WebSocket 通知 + 应用内历史查看

17 个源文件 + .gitignore + 默认 config.json 模板,严格按方案文档第 6 节实现。

用户核心场景:

- Windows 接收 Gotify 通知(WS /stream → AppNotificationBuilder)

- 应用内查看历史消息(打开 MainWindow 触发 GetRecentMessagesAsync,实时通过 MessageReceived 事件追加)

- 列表条目双击打开 extras.client::notification.click.url

关键变更点:

- GotifyMessage.Extras 类型由 Dictionary<string,object> 改为 Dictionary<string,JsonElement>,避免 System.Text.Json 反序列化时丢失嵌套结构

- 新增 HistoryConfig.ViewerLimit(默认 50,UI 硬上限 200)

- GotifyApiService.GetRecentMessagesAsync:since=0 拉最近 N 条,OrderByDescending(Id) 保证顺序

- GotifyWebSocketService 新增 MessageReceived 事件,MainWindow 用 Dispatcher.Invoke 切回 UI 线程追加

- NotificationService.AddArgument('url=...') 透传 click URL 给 OnNotificationInvoked

- MainWindow.xaml 增加 ListView + 刷新按钮,使用 ObservableCollection<GotifyMessage>

- 默认 config.json 用 https://gotify.example.com 占位 URL,ClientToken 留空,首启动自动写入 %LOCALAPPDATA%

依赖:Microsoft.WindowsAppSDK 2.4.0(方案文档固定版本)。

构建:本机 .NET 8 SDK 未安装,build 待用户在装好 SDK 后执行: dotnet restore && dotnet build -c Release
This commit is contained in:
2026-09-06 18:44:55 +08:00
parent 4b7f3a383c
commit c2f44767a6
19 changed files with 1401 additions and 2 deletions
+66
View File
@@ -0,0 +1,66 @@
using Microsoft.Windows.AppNotifications;
using Microsoft.Windows.AppNotifications.Builder;
using WindowsGotify.Models;
namespace WindowsGotify.Services;
public sealed class NotificationService
{
private readonly NotificationConfig _config;
private readonly Logger _logger;
public NotificationService(AppConfig config, Logger logger)
{
_config = config.Notification;
_logger = logger;
}
public Task ShowAsync(GotifyMessage message)
{
if (!_config.Enabled)
return Task.CompletedTask;
try
{
var title = string.IsNullOrWhiteSpace(message.Title)
? "Gotify"
: message.Title.Trim();
var body = message.Message ?? string.Empty;
if (body.Length > _config.MaxMessageLength)
{
body = body[..Math.Max(0, _config.MaxMessageLength)] + "…";
}
var builder = new AppNotificationBuilder()
.AddText(title)
.AddText(body);
if (_config.Sound)
{
builder.SetAudioEvent(
message.Priority >= 8
? AppNotificationSoundEvent.Alarm
: AppNotificationSoundEvent.Default);
}
// 把 extras 里的 client::notification.click.url 透传给通知,让 App.OnNotificationInvoked 收到 url=...
var clickUrl = message.ClickUrl;
if (!string.IsNullOrWhiteSpace(clickUrl))
{
builder.AddArgument("url=" + Uri.EscapeDataString(clickUrl));
}
var notification = builder.BuildNotification();
AppNotificationManager.Default.Show(notification);
_logger.Info($"Notification shown. id={message.Id}, priority={message.Priority}, title={title}");
}
catch (Exception ex)
{
_logger.Error($"Notification display failed. id={message.Id}", ex);
}
return Task.CompletedTask;
}
}