坐直

坐直 Upright 是一款浏览器内运行的本地坐姿检测网页工具，全程所有图像、模型计算在本机完成，不会上传任何画面与用户数据到服务器。仅首次加载下载约9MB MediaPipe模型，之后缓存本地。

使用流程

1. Chrome打开项目页面，授予摄像头、通知权限；
2. 端正坐好，点击校准，保持3秒，生成属于你个人的基线，校准信息保存在浏览器localStorage，下次打开复用；
3. 支持置顶小窗，切其他标签页也可以接收提醒；
4. 可自定义语言、主题、灵敏度、提示音，所有设置自动留存。

8项体态检测 + 2类护眼提醒

实时识别8个坐姿维度：

• 离屏幕太近、低头、歪头、头前伸
• 驼背塌陷、耸肩、歪坐、太久不眨眼

配套健康提醒：

• 45分钟久坐提醒
• 20分钟远眺提醒（遵循20-20-20护眼法则，触发后开启20秒绿色倒计时，其他检测临时暂停）

当检测到不良体态持续3秒，页面会渐变为红色并播放提示音；姿势恢复1.5秒后告警解除。采用迟滞双阈值，避免临界状态频繁抖动。灵敏度三档可调，可单独开关每一项检测。

人脸离开摄像头画面，会自动清除警报。

底层原理

基于MediaPipe Face Landmarker + Pose Landmarker，WASM/WebGPU在浏览器本地推理。
摄像头画面送入模型后，通过metrics.ts提取体态指标，judge.ts对比个人基线，结合EMA平滑滤波、持续时间判断，最后由alerts.ts触发页面变色、提示音、系统通知。

所有判定是相对你校准的基线，抵消摄像头位置、身高、座椅高度带来的影响。

本地部署

pnpm install
pnpm dev

使用Chrome打开Vite提供的本地地址；摄像头权限要求localhost或者HTTPS。
MediaPipe模型由站点自托管，不依赖第三方。

后台运行特性

Chrome采集摄像头的标签页不会被冻结，后台维持约1fps检测帧率，足以支撑3秒的判定窗口；采用setInterval而非requestAnimationFrame，隐藏标签页也可持续监测。

未来可通过MediaStreamTrack+Web Worker进一步提升后台帧率。

已知局限

1. 头部俯仰方向依赖MediaPipe矩阵设定，符号异常可修改配置HEAD_PITCH_SIGN；
2. 头前伸、歪坐检测，需要画面能识别到肩膀；
3. 仅适配Chrome浏览器，置顶小窗依赖Chrome专属Document Picture-in-Picture接口；
4. 无内置多模态大模型，可后续增加临界帧AI辅助判断作为可选增强。