声迹帮助你把家里令人困扰的嗡嗡声、低频轰鸣或间歇噪声，变成可重复观察的记录和明确的下一步。它直接在浏览器中分析麦克风或本地 WAV 音频，默认不上传原始录音。
它适合回答这类问题：声音是否会随着自己能控制的设备状态改变？它是否会在相似的时间、门窗和环境条件下反复出现？接下来应再记录什么，而不是靠猜测继续排查？
- 用手机或电脑浏览器记录约 30 秒的环境声音。
- 看见稳定频率、频带变化、最近波形和声音随时间的变化。
- 建立“基线”，再和后续记录做相对比较。
- 根据证据强弱给出普通人能理解的结论、限制和下一步建议。
- 在本机保存会话，并导出 JSON、CSV 或频谱图；也可以导入已导出的会话继续查看。
- 可选填入自己的兼容接口访问密钥，让智能解释自动补充到分析结论中；没有密钥或在线服务失败时，仍会显示本地分析结果。
真实产品截图：当声音可能来自室外、楼下或其他无法控制的环境时，页面会引导记录条件变化和重复观察，而不是要求用户猜下一步。
真实产品截图：图中的 60 Hz 数据是用于展示界面和分析流程的合成演示信号，不是对真实现场声源的归因结果。
- 打开网页并允许麦克风权限；尽量把设备放在固定位置、保持朝向不变。
- 选择“建立基线”，记录约 30 秒当前环境。如果能听到问题声音，就在它出现时记录；如果暂时没有，也可以先记录安静状态。
- 按噪声情况选择一条排查路径：
- 声音可能和你能操作的电器有关：选择“可控设备”。一次只安全地改变一个状态，例如开启或关闭一台设备。
- 声音可能来自室外、楼下、公共设备或未知方向：选择“外部或未知来源”。在声音出现、减弱或消失时记录一次，并写下时间、门窗和环境变化。
- 保存后阅读“结论”和“下一步”。当证据不足时，页面会明确提示应该重复哪一次记录，而不会把不确定性包装成答案。
本地 WAV 文件也能分析，单个文件上限为 200 MB。
先记录基线，再只改变一个安全、可逆的设备状态，最后恢复原状态进行验证。若同一频段的变化在恢复后也消失，结果可以支持“声音与该设备状态有关”；如果没有重复或条件不一致，页面会把结论降为线索而非确认。
先记录基线；在疑似声音出现、减弱或消失时，于同一位置记录“外部或未知条件变化”；再在相似条件下重复观察。你可以据此得到“声音与记录到的条件重复相关”的结论。
这条路径不能确认是某一台室外空调、楼下某个设备、具体方位或任何责任方。它的价值是把模糊的困扰转为可比较的时间、条件和频率记录，帮助你决定是否值得继续观察、与物业沟通，或请合格的专业人员检测。
声迹会把频率图和统计数据翻译成三类信息：
- 发生了什么：哪些频率或频带在当前记录中更稳定、更突出或发生了变化。
- 证据有多可靠：记录时长、削波、位置、朝向、输入来源和采集设置是否足以比较。
- 下一步怎么做：是否应恢复验证、重复观察、固定门窗条件，还是暂时停止归因。
未校准的手机和电脑麦克风适合在相同设备、相同位置与相同朝向下做相对比较。它们不能直接给出法定分贝声压级、唯一声源识别、精确方位、故障诊断或可用于争议裁决的检测报告。
测量会话默认保存在当前浏览器的本地存储中，保存的是有限的频谱帧、波形摘要、质量状态和你主动填写的上下文，不保存原始音频。清除浏览器网站数据会清除这些会话；导出文件可能含有位置和备注，分享前请检查。
智能解释是可选项，不是独立的“诊断模块”。填写访问密钥并开启自动解释后，声迹会把结构化测量证据发送到你配置的兼容接口，以补充可读说明；原始音频不会发送。访问密钥只留在当前页面内存，刷新页面后需要重新填写。若接口、网络或跨域策略不可用，声迹会保留本地规则结论并显示中文原因。
不要把访问密钥、个人录音或包含住址等隐私信息的导出文件提交到公开仓库或公开 issue。
- 每次比较尽量使用同一台设备、同一位置、同一朝向和相同的输入来源。
- 可控设备一次只改变一个安全且可恢复的状态；不要拆卸设备、接触带电部件或进行危险操作。
- 外部声音要记录时间、门窗状态、天气或明显环境变化，并在相似条件下重复观察。
- 当页面提示证据不足时，优先完成它建议的下一次记录，而不是急于给声源下结论。
需要 Node.js 22 或更高版本，以及 pnpm 11。
pnpm install --frozen-lockfile
pnpm dev
完整检查与生产预览：
pnpm lint
pnpm test
pnpm build
pnpm preview
麦克风权限需要安全上下文：HTTPS 或本机开发地址。
当前代码已按 0.2.0 的首个公开版本整理，正式版本以 Git 标签和 Release 页面为准。贡献方式见 CONTRIBUTING.md，安全问题请见 SECURITY.md。项目采用 MIT License。
©ming woqiang0610@163.com