Skip to content

feat: 新增分贝阈值提醒(通知提供方 + 渠道 + 组件提示) - #8

Open
Starsky16 wants to merge 3 commits into
Yeson38:masterfrom
Starsky16:pr/3-threshold-notification
Open

Starsky16 wants to merge 3 commits into
Yeson38:masterfrom
Starsky16:pr/3-threshold-notification

Conversation

@Starsky16

@Starsky16 Starsky16 commented Sep 14, 2026

Copy link
Copy Markdown

概述

新增分贝阈值提醒:超过设定阈值时在组件上显示提示文字,并通过 ClassIsland 通知系统弹出提醒(带冷却防刷屏)。

这是「分贝监测插件重构与提醒功能」拆分系列的第 3/5 个 PR:

变更

  • Services/DecibelNotificationProvider:继承 NotificationProviderBase<DecibelNotificationProviderSettings>(从而获得宿主自动持久化的通知侧设置),注册「超过分贝阈值」通知渠道并通过 Channel(...) 发送,与内置通知提供方保持一致;Evaluate(mappedDb) 集中完成判定与冷却控制,供组件每个刷新周期调用。
  • Services/DecibelAlertEvaluator:提醒判定纯函数(与 UI/宿主无关)——严格大于阈值才触发、冷却期内不重复通知、冷却下限按 1 分钟处理;配套 9 条边界单元测试(等于阈值不触发、冷却中不通知、冷却刚过可通知等)。
  • Services/DecibelAlertStateModels/NotificationProviderSettings/DecibelNotificationProviderSettings:启用开关、阈值(显示刻度)、提醒文字、冷却时间(分钟)。
  • Controls/NotificationProviders/DecibelNotificationProviderSettingsControl:通知侧设置界面。
  • 组件:订阅 Evaluate 结果,超阈值时显示红色提示文字;新增「组件内提示」开关(关闭后不在组件上显示文字,但通知照常发送);提供方实例采用动态读取而非构造时缓存,避免组件先于 IHostedService 创建导致提醒永久失效。
  • Plugin:注册通知提供方;Decibel_Monitor.csproj 补充该控件 XAML/代码后置的 DependentUpon;README 补充阈值提醒用法、设置项与排查说明。

验证

dotnet build Decibel_Monitor.csproj -c Release
# 已成功生成:0 个警告 0 个错误

dotnet test Tests/Decibel_Monitor.Tests/Decibel_Monitor.Tests.csproj -c Release
# 已通过! - 失败: 0,通过: 37,已跳过: 0,总计: 37(原有 28 条 + 提醒判定 9 条)

通知渠道注册与提醒弹出已在宿主 ClassIsland 中人工实测,无头 CI 无法覆盖。

说明

本 PR 由 VS Code 中的 Cline 辅助生成。

- 新增 Services:AudioPeakMeter(门面)、AudioDeviceEnumerator(设备枚举与缓存)、ContinuousPeakCapture(常驻静默捕获流)、OneShotPeakCapture(一次性三级回退采样)、DecibelCalculator(线性峰值与显示刻度换算)、PeakSample(采样结果纯数据)。

- 新增插件全局设置 DecibelMonitorGlobalSettings 与持久化服务 DecibelMonitorSettingsService(整体反序列化,新增设置项无需同步维护)。

- Plugin.Initialize 注册全局设置服务与共享采样服务;组件将在后续 PR 切换为该服务。

- 新增 Tests/Decibel_Monitor.Tests(xunit),覆盖计算换算与采样数据纯逻辑,共 28 条用例全绿。

由 VS Code 中的 Cline 辅助生成。
- DecibelComponent 从宿主 DI 获取 AudioPeakMeter 与 DecibelMonitorSettingsService,改用 DecibelCalculator 做线性峰值到显示刻度的换算,不再自行枚举设备并三级回退采样。

- 数值改用 AvaloniaProperty(StyledProperty)绑定,移除手写的 INotifyPropertyChanged;采样 Tick 增加节流,避免异步任务堆积;放大倍数取自全局设置,同一麦克风所有组件数值一致。

- 组件设置控件精简为显示侧偏好(分贝前缀、更新频率);测量/校准与提醒设置分别移至插件设置页与通知提供方设置。

- Plugin 移除重复的 GetVoicePeakValue()。

- 编译警告由 3 个降为 0 个(原 CS0108/CS4014 随旧实现一并移除)。

由 VS Code 中的 Cline 辅助生成。
- 新增 DecibelNotificationProvider:继承 NotificationProviderBase<DecibelNotificationProviderSettings>
  以获得宿主自动持久化的通知侧设置,注册「超过分贝阈值」渠道并通过 Channel(...) 发送,与内置通知提供方保持一致。
- 提醒判定抽为纯函数 DecibelAlertEvaluator.Evaluate(...):严格大于阈值才触发、冷却期内不重复通知;
  配套 9 条边界单元测试(等于阈值不触发、冷却中不通知、冷却刚过可通知、冷却下限 1 分钟等),单元测试总数 37 条全绿。
- 新增通知侧设置控件:启用提醒、阈值(dB)、提醒文字、冷却时间(分钟)。
- 组件展示评估结果:超阈值时显示红色提示文字,可用组件设置里的「组件内提示」关闭(关闭后仍照常发送通知);
  提供方实例动态读取,避免组件先于 IHostedService 创建导致提醒永久失效。
- README 补充阈值提醒的使用方式、设置项与排查说明。

由 VS Code 中的 Cline 辅助生成。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant