总览：RespiraScope 的系统边界与设计取舍
从项目定位、整体架构和核心取舍开始，理解 RespiraScope 为什么被设计成一个后端采集处理服务加 Web Console 的实时信号系统。
阅读全文 返回博客
Series
RespiraScope 项目复盘
围绕实时呼吸信号采集、滤波、峰谷识别、记录复盘、API 集成、前端可视化和打包部署的完整工程复盘。
总览文章
子文章
10 篇 01
启动与配置：为什么用外部 TOML、端口避让和运行时前端配置
复盘 RespiraScope 的启动路径：外部配置、端口选择、FastAPI/Socket.IO 应用创建、静态 Web Console 注入，以及这些设计相比 .env 和硬编码端口的取舍。
阅读全文 02
实时管线：TCP 输入、sequence、handler、队列和 Socket.IO
解释 RespiraScope 的实时数据链路为什么不是一个大循环，而是由 DataReceiver、SignalProcessor、DataQueueManager 和 DataSender 组成的可解释管线。
阅读全文 04
SciPy 滤波函数详解：butter、sosfilt、sosfiltfilt 与 gaussian_filter1d
把 RespiraScope 中实际使用的第三方滤波函数逐个讲清楚：它们接收什么参数、输出什么结果、为什么实时和离线要用不同函数。
阅读全文 05
峰谷与 BPM：find_peaks、distance、prominence 和延迟确认
解释 RespiraScope 如何把滤波波形转换成波峰、波谷、BPM 和稳定性指标，并对比固定阈值、自适应阈值和候选峰确认的设计取舍。
阅读全文 06
记录复盘：RecordManager 为什么要保存 pre、record、post 和 scan
解释 RespiraScope 的记录系统为什么不只保存用户点击 Start 到 End 的区间，而要保留前后辅助点、扫描子区间和离线复算结果。
阅读全文 07
接口集成：为什么 HTTP 做控制面，Socket.IO 做数据面
复盘 RespiraScope 的对外接口设计：启动、停止、记录和复算走 HTTP，实时 raw、filtered、peak、valley、metrics 走 Socket.IO。
阅读全文 08
模拟信号与质量事件：为什么工程工具不能只依赖真实设备调试
复盘 RespiraScope 的内置模拟传感器、预设呼吸场景和 signal_quality 事件，解释它们如何服务算法调参和异常复盘。
阅读全文 09
Web Console：Monitor、Lab、ECharts 和记录回看的前端边界
解释 RespiraScope 前端为什么采用统一 Console + 多个静态页面，Monitor 如何消费实时数据，Lab 如何服务模拟和滤波调参。
阅读全文 10
测试、调试与打包：从 pytest 到 PyInstaller exe
复盘 RespiraScope 如何通过单元测试覆盖滤波、峰谷、Socket.IO、记录状态和 HTTP 默认值，并解释源码运行、onefile exe、onedir 包的取舍。
阅读全文