Repository navigation
Conversation
- 新增 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 辅助生成。
- 新增插件设置页（设置 → Decibel_Monitor，External 分类）：全局校准（参考 dB 0..150、放大倍数、校准按钮）、 持续监听麦克风与采样参数、默认捕获设备信息与捕获设备列表诊断。 - 校准改为调用 AudioPeakMeter.CaptureSamplePeakAsync 显式采样一次，结果写入全局放大倍数， 插件内所有组件立即生效（同一麦克风各组件数值一致）。 - Plugin 注册设置页；Decibel_Monitor.csproj 补充设置页 XAML 与代码后置的 DependentUpon。 - README 更新：设置分布（组件设置 / 通知设置 / 插件设置页三处）、校准位置由组件设置改为插件设置页、 补充全局设置项与故障排查说明。 由 VS Code 中的 Cline 辅助生成。
- IntegrationTest.yml：下载官方 ClassIsland 2.1.0.1 folder 包，用 -epp 加载本插件并启动， 轮询等待插件写入 loaded.marker 以确认 Initialize 完整执行（注册组件与提醒提供方无异常）； 超时或进程提前退出即失败，并在失败时打印 AppRoot 目录便于排查。 - Plugin：设置 DECIBEL_MONITOR_CI_MARKER=1 时向插件配置目录写入 loaded.marker，供上述工作流判定加载成功； 未设置该环境变量时行为与原来完全一致。 - Build.yml / Test.yml：构建与单元测试步骤对齐现有工程（tools/publish.ps1、Tests/Decibel_Monitor.Tests）。 由 VS Code 中的 Cline 辅助生成。
组件由宿主从 DI 根容器以瞬态方式解析且从不调用释放方法，原实现在构造函数中启动 DispatcherTimer：已启动的定时器被 Dispatcher 强引用，Tick 闭包会永久钉住组件实例，导致组件重建后旧实例与定时器都无法回收。改为随视觉树附着/分离启停定时器，并移除不再需要的 IDisposable。 已知行为变化：组件不在视觉树上时不再采样，依赖 Tick 的阈值提醒在组件离树期间不会触发。
- 新增 AverageVolumeAlertEvaluator（滑动窗口平均判定，严格大于阈值） - 新增判定源抽象 IAlertDecisionSource 与 AlertContext/AlertDecision 契约 - 新增判定源①AutoThresholdDecisionSource：超阈值且冷却已过即提醒 - 新增判定源②HotkeyConfirmDecisionSource：超阈值开筛选窗口，窗口内命中热键才提醒 - 新增仲裁模块 AlertDecisionCoordinator：自持优先级配置、统一归口发出通知事件 - 测试工程链接上述纯逻辑源文件，新增 43 条用例（共 80 条全绿）
- Alarm/HotkeyWindowMonitor：经 IAppHost 动态解析 KeyboardCapture 全局键盘服务 （非必需依赖，未解析到则定时重试降级为空转），把筛选窗口期间的 KeyDown 封送回 UI 线程并映射修饰键后转发给热键判定源，暴露窗口开关状态事件供组件红绿点。 - Alarm/AlertRuntimeService：周期采样构造判定上下文交由仲裁模块裁定， 经 NotifyRequested 统一接入现有通知提供方发出强调通知（语音由宿主负责）， 执行提醒后进入 3 秒防自激暂停分贝采样判定并清空样本窗口。 - Plugin.cs：注册自动/热键两个判定源、仲裁模块及两个宿主服务（默认均未启用）。
- 通知提供方设置只保留提醒文字，阈值与冷却统一由判定源负责，消除双重门槛 - 插件设置页新增“提醒判定”分区：平均窗口时长、判定源优先级排序、自动提醒与热键确认设置 - 分贝组件改为纯显示侧，新增热键筛选窗口红/绿点指示，只读取提醒运行时服务状态 - 仲裁模块支持运行时应用判定源优先级顺序
- 组件不再显示提醒文字，统一为单一状态点：绿=正常，红=提醒触发中（含筛选窗口开启与冷却期） - 判定源接口新增 Description 与 IsCoolingDown，供设置页展示与状态点判定 - 设置页补全判定源分组名（判定源①/②）、阈值与冷却/窗口时长滑块的数值显示、优先级列表说明 - 组件设置项 ShowAlertTextOnComponent 改为 ShowStatusIndicator（组件上不再有提醒文字）
- 窗口开启期间状态点在红绿之间交替（400ms 半周期），与静态红/绿区分开 - 窗口开启时组件更新节拍收紧到闪烁半周期，避免更新频率设置高时看不出闪动 - 组件设置说明与设置页描述同步补充闪动含义
把散落在运行时服务（布尔 OR 压平）与组件（自行解释布尔）两处的提醒状态判断 收敛为一个枚举与一个纯函数式合并器，为后续「形状 + 填充 + 呼吸 + 数字颜色」 四通道显示改造提供唯一判定依据。 - 合并规则按「是否需要用户动手」排序：窗口 > 超阈值 > 冷却 > 正常 > 无数据， 窗口压制冷却，避免两源同时启用时「该按键」被长冷却盖掉 - 阈值迟滞（施密特触发）：只作用于数字颜色判据，迟滞带 2.0 显示刻度单位 （1 单位 = 1 dB，等价 20*log10(0.8) 约 -1.9 dB），不影响判定源的提醒行为 - 时间滞回：升级立即生效、降级需新态持续 1 秒，计时用真实经过时间而非采样次数 - 冷却期内数字判据改用 1 秒短窗口平均；输出 Changed 标志与显式 Reset() - 新增 32 条单测覆盖合并组合、优先级压制、两种滞回、判据切换与呼吸时机
用 IndicatorStateResolver 替换运行时服务里布尔 OR 拼装的 IsAlertStateActive， 状态含义与滞回规则统一归解析器，服务只负责压平各源状态与维护两类窗口。 - 暴露 IndicatorState / IndicatorValueState / IsIndicatorBreathing / IndicatorStateChanged 供组件读取，不再暴露含义被压平的布尔量 - 新增 1 秒短窗口平均（独立于判定用的平均窗口），按真实时间戳剔除过期样本， 供冷却期数字判据使用 - 数字判据阈值取已启用判定源中的最小者（各源共用同一数值） - HotkeyConfirmDecisionSource 新增 WindowOpenUntilUtc，供计算窗口剩余时间与呼吸时机 - 默认捕获设备变化（含被拔出/禁用后为 null）时 Reset 解析器与短窗口，避免残留红色； 无可用捕获设备时视为无采样，状态切 NoData、数值显示 N/A，不再伪装成绿色正常 - 组件仅为保持编译通过做最小适配，视觉行为与改动前一致（视觉改造在下一阶段）
状态点由"单点红绿闪动"改为四通道编码，不再用红绿交替造成最紧急状态有一半时间 显示成正常： - 形状 12px 互斥显示：常态低不透明度绿圆 / 超标红实心方 / 冷却期红空心方 / 待热键确认橙三角；无采样或未启用判定源时不显示任何形状 - 呼吸 Animation 驱动三角不透明度，触发点为窗口剩余时间 <= min(3s, WindowTimeout/4)， 窗口开启期间静置 - 数字 Foreground 绑定判据颜色（冷却期用 1 秒短窗口平均），改用宿主主题语义画刷 SystemFillColorCriticalBrush / SystemFillColorSuccessBrush / SystemFillColorCautionBrush - 删除 TickCount64 取模闪烁与窗口期 400ms 强制刷新；保留视觉树生命周期管理 - 形状与颜色只在 Changed 为真时重设，并用 _visualsApplied 在首次附着时强制应用一次 （状态未变化时 Changed 为假，否则新实例不会显示形状），分离时复位
状态点由单点红绿闪动改为四形状体系后，README 与设置页文案仍停留在旧描述： - README 新增「提醒状态点」小节：形状对照表（半透明绿圆=正常 / 红实心方=正在 超阈值 / 红空心方=冷却期 / 橙三角=待热键确认且窗口即将超时时呼吸）与数字颜色 判据说明（非冷却期用滑动平均值、冷却期用 1 秒短窗口平均、2 dB 迟滞、无采样不设色） - 设置页「判定源②」与「筛选窗口时长」两处 Description 由红绿闪动改为橙色三角与呼吸提示 - 组件设置页说明与 ShowStatusIndicator 的 XML 注释同步为四形状语义
提醒判定迁到插件设置页的"判定源"、通知提供方改为只负责提醒正文之后，文档与 注释仍指向旧位置与已删除的设置项： - README：`ShowAlertTextOnComponent` 改为 `ShowStatusIndicator`；通知提供方设置只 剩 `AlertText`（删去 IsAlertEnabled / AlertThreshold / AlertCooldownMinutes）； "设置位置一览"与"阈值提醒"小节改为指向插件设置页的判定源；补全判定源①/②字段、 平均窗口与优先级；故障排查补上"判定源默认关闭"与判定源②需 KeyboardCapture - 组件设置页 XAML 注释：提醒相关设置的指向同步为"判定源在插件设置页、正文与语音在 通知提供方"
实机验证发现冷却期形状与设计 3.2 节不符：判定源的 IsTriggerActive 不受冷却影响， 低阈值用法下 600 秒冷却期内几乎全程显示实心方，"刚提醒过"这一事实在形状上丢失， 且数字颜色的"冷却期改用 1 秒短窗口平均"分支走不到。 改为按判定源分别计算"超阈值且未冷却"后再取或，使冷却期形状恒为空心方、 数字判据切换生效。同步 README 形状对照表与设置页文案，并修正 README 中 "未启用任何判定源时数字显示 N/A"的不准确表述。 副作用：提醒与冷却在同一拍写入，因此 Alerting（红实心方）在冷却时间非 0 时 实际不可见，仅在冷却时间为 0 时出现；已在 README、组件设置页与 resolver 注释中 按此精确说明。
课间休息与每节课开头若干分钟内的超阈值不再发出通知，避免课间交谈、上课起立 等声音被当成吵闹造成误报。 关键点：抑制时直接跳过仲裁模块的 Decide 调用，而不是只在通知出口拦截。 Decide 一旦被调用就会写入冷却时间，课间的一次误报会吃掉整段冷却，导致进入 上课后该提醒而不提醒，反而比不抑制更严重。抑制期间状态点改由"当前窗口平均 是否超阈值"直接驱动，仍照常显示噪音（超阈值红实心方、否则绿圆）。 - 新增 Alerting/ScheduleGate.cs：纯逻辑时段闸门，上课起点取 OnClass 上升沿并用 真实时间计时；课表未启用或未加载时整体旁路。自定义 SchedulePhase 枚举以避免 测试项目引用宿主类型，新增 14 条单测 - AlertRuntimeService 惰性解析 IAppHost.TryGetService<ILessonsService>()（零新增依赖） - 新增设置项 SuppressAlertDuringBreak（默认开）与 ClassStartProtectionMinutes （默认 3，0 表示关闭），设置页新增「时段闸门」分组
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
变更
Alerting/IndicatorStateResolver（状态合并与滞回纯逻辑）及单测。AlertRuntimeService接入解析器：按设备可用性判定"无采样"；冷却期内不再把"正在超阈值"计入，状态点保持空心方。DecibelComponent改用形状与呼吸表达状态点，数字颜色随判据变化。Alerting/ScheduleGate（依赖宿主课表状态）、单测与设置项SuppressAlertDuringBreak、ClassStartProtectionMinutes。验证
dotnet build -c Release：0 警告 0 错误。dotnet test Tests/Decibel_Monitor.Tests -c Release：133 通过 / 0 失败（含新增的状态点解析器与时段闸门单测）。说明
本 PR 为堆叠系列的第 7 环，基于前一环分支；上游既有 PR 同样以
master为 base，评审时请以Commits中属于本环的提交为准。本 PR 由 AI 辅助生成。