一个用于 ClassIsland 的分贝监测插件，通过一条常驻的低开销捕获流实时读取麦克风峰值并在主界面显示分贝映射值。支持全局校准（将数字音频幅度映射到目标 dBFS），并可通过系统实时计量作为补充。
- 实时显示麦克风分贝值（映射到 0–150 范围以便在 UI 中直观显示）。默认通过一条常驻的低开销捕获流持续计算峰值——数值稳定、无周期性开/关录音造成的闪烁（Windows 麦克风占用图标会常亮而非闪烁）。
- 校准功能：根据目标 dBFS 自动计算并保存全局放大倍数（插件设置页 → 全局校准）。校准时才会进行一次显式采样。
- 阈值提醒：超过指定分贝值时，在组件上显示提示文字，并通过 ClassIsland 通知系统弹出醒目提醒（带冷却时间防刷屏）。
本插件的设置分布在 ClassIsland 的三个位置：
| 位置 | 内容 |
|---|---|
| ① 组件设置（右键组件 → 设置） | 显示偏好：是否在组件上显示“超过阈值”的提示文字（ShowAlertTextOnComponent） |
| ② 通知设置（设置 → 通知 → 分贝提醒） | 启用提醒、阈值（dB）、提醒文字、冷却时间（分钟） |
| ③ 插件设置页（设置 → Decibel_Monitor） | 全局校准（参考 dB、放大倍数、校准按钮）、测量参数（持续监听、采样时长）、设备诊断 |
- .NET 8
- ClassIsland
确保项目正确加载插件。
- 在宿主中将本组件加入布局（或通过插件管理启用）。
- 主界面会显示当前分贝映射值（0–150），数值由全局校准决定（同一麦克风所有组件一致）。
- 进行校准（设置 → Decibel_Monitor 页）：
- 将麦克风对准参考声源或播放测试音。
- 将参考滑块设置为目标显示 dB（默认 70，范围 0..150，对应 dBFS -80）。
- 点击“校准”按钮。插件采样一次并计算全局放大倍数，保存后所有组件立即生效。
- 采样或静音表现异常时，可在同一页面使用“捕获设备列表”诊断，或调整测量参数。
- 打开 设置 → 通知 → 分贝提醒。
- 开启“启用提醒”，设置阈值（dB）、提醒文字与冷却时间（分钟）。
- 当分贝值超过阈值时：
- 组件上显示红色提示文字；
- 通过 ClassIsland 通知系统弹出醒目提醒；
- 冷却时间内不会重复提醒（默认 10 分钟）。
- 测量得到的线性峰值：
measuredLinear（0..1） - 目标线性值：
targetLinear = 10^(targetDbFS / 20) - 放大倍数：
magnification = targetLinear / measuredLinear
插件会对计算结果做上限保护（默认上限 1024；下限可为 0），以避免极端错误值。
ShowAlertTextOnComponent(bool)：是否在组件上显示“超过阈值”的提示文字，默认 true；关闭后仍会发送系统通知，但不在组件上显示提示文字。ShowDecibelPrefix(bool)：数值前是否显示“分贝:”前缀（如“分贝: 70.0”），默认 true。UpdateIntervalMs(int)：数值更新频率（毫秒，100..1000，可配置范围 100..5000），默认 200。
IsAlertEnabled(bool)：是否启用阈值提醒，默认 false。AlertThreshold(double)：提醒阈值（显示刻度 0..150），默认 120。AlertText(string)：提醒文字（通知横幅与组件提示），默认“请保持安静”。AlertCooldownMinutes(int)：触发提醒后的冷却时间（分钟），默认 10。
ReferenceDecibel(double)：校准参考（显示刻度 dB 0..150），默认 70（对应 -80 dBFS）。Magnification(double)：全局放大倍数，校准后保存，所有组件统一使用。EnableContinuousMonitoring(bool)：是否启用“持续监听麦克风”（常驻静默捕获流），默认 true。关闭后仅使用系统实时计量，多数设备会一直显示 0。FallbackCaptureMs(int)：显式采样（如校准）的单次录音时长（毫秒），默认 400。SignalThreshold(double)：信号检测阈值（存在配置文件中，可在采样异常时调低）。
- 提醒一直没有触发：
- 确认 ClassIsland 全局通知开关与 设置 → 通知 → 分贝提醒 的开关均已开启。
- 确认分贝值确实超过了设定阈值（长期显示 0 请参考下一条）。
- 若宿主日志中无“注册提醒渠道：…（超过分贝阈值）”，说明加载的是旧版本插件，请更新插件并重启。
- 分贝值长期显示
0.0：- 若关闭了“持续监听麦克风”，则只使用系统实时计量，多数设备会一直为 0；请到 设置 → Decibel_Monitor 页 确认该开关已开启（开启后麦克风占用图标会常亮）。
- 确认宿主应用有麦克风权限（Windows 隐私设置）。
- 确认默认捕获设备已启用并未被独占。
- 在 设置 → Decibel_Monitor 页 使用“捕获设备列表”检查系统设备；增加音量或靠近声源再测。
- 出现“麦克风正在使用”提示且图标闪烁：说明加载的是旧版本插件（旧版周期性开/关录音）。请更新插件；当前版本为常驻监听，图标只会常亮不会闪烁。如不希望常亮，可关闭“持续监听麦克风”。
- 校准结果异常：
- 确认目标单位为 dBFS（数字音频相对量），而非声压级 dB SPL。
- 若测量值接近 0，会导致放大倍数非常大，请提高测试音量或选择更高的目标 dBFS。
- 插件需要访问麦克风进行本地采样，宿主必须授予麦克风权限。
- 插件不会上传或外传音频数据，所有采样仅在本地处理。
- 欢迎提交 issue 或 PR。请遵循仓库中的贡献指南（若存在 CONTRIBUTING.md）提交风格一致的修改。
- 单元测试：
Tests/Decibel_Monitor.Tests覆盖DecibelCalculator与PeakSample纯函数（Windows 环境运行dotnet test）。 - Idea来自：HAHAHAHAHAYINING,讨论#561
- 主要开发者：Yeson38
- 参考代码：CIImage