1快速上手（第一次一分钟，之后一秒钟）
- 打开文件夹，双击
启动分贝仪.bat（会自动用浏览器打开页面，不用装任何东西，也不用联网）。
注意：不要直接双击 index.html。直接双击时浏览器不给持久化的麦克风授权，很容易「点了没反应」。
注意：整个文件夹要一起拷到那台电脑上（启动器依赖同目录的 server.ps1 或 server.js），
只拷 index.html 会退化到最差的那种打开方式。
- 第一次：页面会自己去连麦克风，浏览器左上角弹出提示时点一次 「允许」，就直接进入主界面了。
- 以后：不用再点任何按钮 —— 启动器打开页面后会自动进入，直接投影即可。
数字开始跳动、下方曲线开始起伏，就说明麦克风已经在工作了。
浏览器会把「允许」记在这个地址上（前提是启动器每次用同一个端口，比如固定 http://127.0.0.1:8731）；
万一哪天又开始问了，多半是端口变了或清过浏览器数据，允许一次即可。
2常用操作与快捷键
| 我想做的事 | 怎么做 |
|---|
| 开始监测 | 打开页面就会自己连上；第一次只需在浏览器提示里点一次「允许」 |
| 不想自动进入（看说明页） | 在地址后面加 ?auto=0，就回到「点开始监测」的老样子 |
| 全屏投影 | 按 F（再按一次退出），或点右上角「全屏」 |
| 讲课时暂停计时 | 按 空格（再按一次继续） |
| 重置本节课 | 按 R（连续计时与打断次数归零，今日累计保留） |
| 切换自习 / 早读 | 点顶栏「自习 / 早读」，或按 m |
| 一键校准底噪 | 按 c，或点右上角「设置」 → 「一键校准底噪」 |
| 调整安静阈值 | 点右上角「设置」 → 「安静阈值」滑块，或按 c 一键校准底噪 |
| 校准分贝数值 | 点右上角「设置」 → 「灵敏度校准」滑块 |
| 导出今日记录 | 点右上角「设置」 → 「导出今日记录（CSV）」 |
| 换麦克风设备 | 点右上角「设置」 → 「麦克风设备」下拉框 |
| 切换亮色 / 暗色 | 点右上角「设置」 → 「界面主题」 |
| 课后复盘（时间轴） | 点右上角「复盘」按钮 |
| 查看使用说明 | 点右上角「说明」按钮（就是本面板） |
3教室使用建议
麦克风怎么放：
- 放在讲台中间，朝下对着教室，不要贴墙、不要塞进抽屉。
- 远离空调出风口、电风扇、投影仪散热口——这些持续噪音会让读数一直偏高。
- 笔记本自带的麦克风也能用，但增益通常偏低；若数值偏小，可把「灵敏度校准」往上调 5~10。
阈值怎么定（默认 55 dB）：
| 班级情况 | 建议阈值 |
|---|
| 重点班 / 自习纪律很好 | 约 50 dB |
| 普通班 / 一般情况 | 55 ~ 58 dB（默认 55） |
| 班级活跃、讨论课较多 | 约 60 dB |
| 环境本身比较吵（临街、施工） | 60 ~ 65 dB |
判断方法：让全班正常安静下来，看仪表稳定在多少。把阈值定在「安静读数 + 8 ~ 12 dB」左右最合适——既不会因为一点点翻书声就清零，也能在真吵起来时及时提示。
去抖时间为什么默认 1.5 秒：一次翻书、两声咳嗽、一张椅子响，不应该把学生辛苦攒的连续安静清零。去抖的意思就是「必须连续超过阈值这么久，才算一次打断」。默认 1.5 秒比较宽容，是为了保护学生积极性；纪律比较松的班可以调到 3 秒，只有在确实需要更严格时才建议调到 1.0 秒。
怎么看下面那条曲线：它是最近 60 秒的分贝走势，虚线就是当前阈值（自习是安静阈值，早读是达标线）。
自习时曲线在虚线下方＝安静，越平越稳；一整段都在虚线上方＝这段一直在说话，累计安静会被倒扣。
早读时反过来看：曲线在虚线上方才是读出了声音，起伏越连续说明读得越整齐。
纵轴不会自动缩放（固定为阈值上下各 30 dB），所以「整堂课都偏轻」这种事在曲线上一眼就能看出来——
如果曲线长期贴着下边缘，多半是麦克风离得太远，调「灵敏度校准」而不是调阈值。
9段位与「持续吵闹倒扣」
段位看的是「这一场攒下了多少有效时间」，不是页面开了多久，也不是今天一共开了多久。
大数字下方那枚徽章就是段位，自习与早读各有一套，颜色从青铜一路暖到荣耀王者。
门槛随「这一场有多长」自动缩放。一个 40 分钟的自习时段，不可能凑出 60 分钟的安静，
所以每场都从青铜重新起算，门槛按场次长度折算（自习看安静时长、早读看洪亮时长）。
自习（按这一场多长自动缩放）：
| 段位 | 40′ | 45′ | 60′ | 80′ |
|---|
| 倔强青铜 | 0 | 0 | 0 | 0 |
| 秩序白银 | 4:00 | 4:30 | 6:00 | 8:00 |
| 荣耀黄金 | 8:00 | 9:00 | 12:00 | 16:00 |
| 尊贵铂金 | 12:00 | 13:30 | 18:00 | 24:00 |
| 永恒钻石 | 17:00 | 19:00 | 25:00 | 33:30 |
| 至尊星耀 | 23:00 | 26:00 | 35:00 | 46:30 |
| 最强王者 | 30:00 | 34:00 | 45:00 | 60:00 |
| 荣耀王者 | 36:00 | 40:30 | 54:00 | 72:00 |
早读（固定 20 分钟一场）：
| 段位 | 需要洪亮累计 | 段位 | 需要洪亮累计 |
|---|
| 倔强青铜 | 0 | 永恒钻石 | 8:30 |
| 秩序白银 | 2:00 | 至尊星耀 | 11:30 |
| 荣耀黄金 | 4:00 | 最强王者 | 15:00 |
| 尊贵铂金 | 6:00 | 荣耀王者 | 17:00 |
程序怎么知道你上的是哪一场：按电脑的时钟自动认。
12:50 – 13:50 是午自习（60 分钟 → 上表 60′ 列），
16:30 – 17:10 是下午自习（40 分钟 → 40′ 列），
20:10 – 21:30 是晚自修（80 分钟 → 80′ 列）；
这三个时段之外的开机都按「一节课 45 分钟」（45′ 列）算。
跨进新时段＝新的一局：段位回到青铜重新往上打，今日累计与「连续安静」都不动。
换场只换尺子，不表演「降段」——那个灰色闪一下的动画只留给被噪音扣下来的情况。
升段有动画：徽章会弹一下、外面扩散两圈光环、再飘出「升段」两个字（封顶时是「封顶」）。
整个动作只有 1.3 秒，全在徽章自己身上，不挡视线、不用点关闭。
左边的卡片是「当前这一段连续安静」，徽章是「这一场累计」——所以两处的数字本来就不一样：
卡片上的连续被吵断会归零，徽章不会归零，只会被倒扣。
持续吵闹会倒扣时长（只对自习生效）：全班连续超过安静阈值满
8 秒之后开始扣 —— 每多吵 1 秒，就从这一场的有效时长里扣掉 1 秒，
徽章右侧会跳出一个红色的 −12s，同时段位可能当场掉一档。
安静下来的那一刻立即停止，不追讨、不欠账，扣到 0 就到此为止，不会变成负数。
为什么这么设计：如果吵闹只是「不长个子」，学生对「一直说话」几乎没有痛感；
加上倒扣之后，「吵一分钟」和「安静一分钟」的差距是两分钟，坐不住的代价才看得见。
这条规则和「打断次数」是两件事：打断记的是次数，倒扣扣的是时长，两者会同时生效。
觉得太狠就调松：点「设置」→「持续吵闹倒扣」把 8 秒改大（比如 12 秒），
或者直接拖到 0 关掉倒扣，只保留打断计数。暂停（空格）期间不判定、不倒扣，
老师讲课时可以放心说话。
倒扣扣的是「这一场的有效时长」和「今日累计安静」两个数；本节课的打断次数、最长连续这些数据不会被改写。
8一键校准底噪（推荐每学期做一次）
为什么需要它：每间教室的底噪都不一样 —— 临街、顶楼、空调出风口、投影仪散热，都能让「安静时的读数」差出十几 dB。所以安静阈值没有万能值，按 c 当场测一次最准。
怎么用（三步）：
- 先让全班安静下来（安静到平时上课该有的样子就行，不用刻意屏息）。
- 按 c，或点右上角「设置」 → 「一键校准底噪」。
- 等 5 秒倒计时走完，看一下「教室底噪」和「建议安静阈值」，点 「应用这个阈值」 即可。
它算的是什么：测量期间程序按每秒约 60 次采样，最后取中位数作为底噪（不是平均值 —— 中途一声咳嗽不会把结果带偏），再把阈值定在 「底噪 + 10 dB」（音量约 3 倍）。这个「+10 dB」正是下面那张表推荐的「安静读数 + 8~12 dB」的中间值。
测量时不会乱计时：这 5 秒里程序不判打断、也不累计安静时长，连续时长原地冻结，测完不会平白多出 5 秒。
如果提示「声音起伏较大」：说明这 5 秒里有人说话或走动，结果不可靠，让全班再安静一点、重新测一次即可。若提示「底噪本身就偏高」，多半是麦克风离空调 / 风扇 / 投影仪散热口太近，挪个位置再测。
校准底噪 ≠ 灵敏度校准：「灵敏度校准」是把大屏读数对齐到实物分贝仪、让数字本身准；「一键校准底噪」是决定多吵才算吵的那条线。两者互不替代，建议先做灵敏度校准，再做底噪校准。
换了教室、换了麦克风、或者季节变了（开了空调 / 关了窗），都值得重新按一次 c。
5投影到大屏
- 用 HDMI / Type-C 把电脑接到教室大屏或投影，选择「复制」显示模式。
- 双击
启动分贝仪.bat 打开页面（不要直接双击 index.html）。
- 按 F 进入全屏。
- 合上笔记本屏幕之前，先在电源设置里把「合盖动作」设为「不采取任何操作」，否则合盖会睡眠、投屏就断了。
- 建议关上班级的自动熄屏和睡眠（电源计划 → 屏幕和睡眠 → 设为「从不」）。
投到大屏时建议用亮色主题（默认就是），白底在投影上更清楚、更省眼。
4早读模式怎么用
和自习完全相反：越响越好。自习是“越安静越好”；早读是“越洪亮越好”——读数越高，大数字颜色越暖、下方 60 秒曲线爬得越高、段位涨得越快。
怎么切换：点顶栏的「自习 / 早读」分段按钮，或直接按 m。切换是中性操作：不会清掉任何记录，也不会算作“打断”。
达标线怎么定（默认 65 dB）：全班齐声朗读通常在 72~85 dB。达标线要比普遍朗读音量低一截 —— 留出换气、句间起伏的余量，读出声音就能稳定在达标区里；定得太高（比如贴着 75）会让计时一直被换气打断。想更严就往上拖一点，在「设置」 →「早读设置」里调。默认 65 dB 适合大多数班级。
换气、句间停顿不会清零：朗读时换一口气、句子之间停一下，只要在 1.2 秒内回到达标线以上，计时就不中断、也不清零。只有停下来超过 1.2 秒，才不再继续往上加——已经读出来的时长不会被扣掉。
数据说明：早读与自习是两套独立记录，各有各的累计时长与段位阶梯，互不冲抵。页面关掉再打开时，只续上「今日累计」；连续时长、最长连续、打断次数都会从零重新开始（段位也一样——它只认这一场）。所有数据只存在这台电脑这个浏览器里，不联网、不上传。
早读模式下大屏越响颜色越暖——学生看一眼就知道“现在越响越好”。
6常见问题排查
点了「开始监测」没反应，或提示「权限被拒绝」：
- 看地址栏最左边的小图标（锁 / 权限）→ 点开 → 「此网站的权限」→ 麦克风 → 改成「允许」。
- 如果地址栏里根本没有授权提示，就到 Edge 设置 → Cookie 和网站权限 → 网站权限 → 麦克风，把本页面的地址添加进「允许」。
- 按 Ctrl + F5 刷新页面，再点一次「开始监测」。
同时确认系统里也开着：Windows 设置 → 隐私和安全性 → 麦克风 → 打开「让应用访问你的麦克风」。
提示「没有检测到麦克风设备」：检查麦克风（或耳麦 / USB 声卡）是否插好；在 Windows 设置 → 系统 → 声音 → 输入 里确认设备存在并且有电平跳动，然后刷新页面重试。
提示「麦克风被其他程序占用」：关闭腾讯会议 / 钉钉 / 微信 / QQ / 录屏或直播软件（它们常常在后台占着麦克风），刷新页面再点一次「开始监测」。
数字乱跳 / 一直偏高 / 一直偏低：
- 一直在 80+，安静时也下不来：麦克风离空调、风扇或音箱太近，或系统「麦克风加强」开太大 → 换个位置，或在「设置」里把「灵敏度校准」往下调。
- 一直贴在 35~40 不动：麦克风没在工作。看「设置」里的「麦克风输入电平」条会不会动，不会动就换设备、插紧接口。
- 想更准：手机上下一个分贝仪 App，放在同一位置做对比，用「灵敏度校准」把两边读数调到接近即可。
用着用着不动了（切过别的程序 / 电脑锁过屏）：浏览器会在后台挂起音频，切回本页面即会自动恢复。如果还没恢复，按一次 空格 暂停再继续，或者刷新页面。
7数据说明
- 数据全部保存在这台电脑的这个浏览器里（本地存储），不会上传到任何服务器，也不需要联网。
- 什么时候开始计时：页面一打开、麦克风连上就开始计时（不再等点按钮）。
想在正式上课前先准备好，就连上后按 空格 暂停，上课时再按一次继续；
已经提前积累的一小段，按 R 重置本节课即可清掉。
- 按日期每天一份，跨次保留的只有两项：今日累计时长、今日累计打断次数。
- 关掉页面再打开：「今日累计」会续上；连续时长、最长连续、打断次数与噪音时间轴都从零重新开始——这样早读的数据不会被带到自习，每节课都是全新的开始。
- 清今日：点「设置」 → 「清空今日数据」（只清今天的累计，设置不动）。
- 清全部：点「设置」 → 「清空全部数据」（连今日累计和设置一起清掉，会二次确认）。
- 导出：点「设置」 → 「导出今日记录（CSV）」，或「复盘」面板里的同名按钮。
- 换电脑 / 换浏览器，数据不会跟着走，导出的 CSV 是唯一的迁移方式。
请用普通窗口上课；「无痕 / InPrivate」窗口关闭后数据会丢失。