Guoguo 21dccd2274 fix(mapping): correct region↔IO mapping per on-device measurement
Measured on real hardware: IO1=right IO2=left IO3=top IO4=middle IO5=bottom
(0x01=right 0x02=left 0x04=top 0x08=middle 0x10=bottom). The earlier verbal
'left=IO1/upper=IO2...' spec was wrong; this reverts to the original Phase-1
mapping, which the measurement confirms.

- protocol.js REGION constants + getRegionName + REGION_NAMES
- CRITICAL: buildVendorCommand ioMasks was built from REGION.* constants whose
  values just flipped, scrambling IO slot order; pin to literal [0x01..0x10]
- diagnosis.js REGION_DEFS key↔mask; pd_region_map values unchanged (PD is
  keyed by orientation, which is stable) — right=PD5 left=PD1 top=PD2
  middle=PD3,6,7 bottom=PD4
- common.js region labels back to right/left/top/middle/bottom (上/中/下)
- treatment-setup / manual-treatment / treating / scan-report / ble-debug
  face-map bindings and REGION_MAP realigned
- verified: mock pipeline lands left→IO2, middle→IO4 correctly
2026-07-28 07:22:36 -07:00

Hox 文档目录

本目录集中存放项目说明、设计文档、协议资料、计划清单和原型文件,根目录只保留代码目录与仓库级配置。

目录结构

目录 内容
requirements/ 产品说明、系统说明等需求来源文档
design/ 业务流程、接口、数据库、后台、安全、测试等设计文档
protocols/ BLE、云端通信等协议文档;部分 IoT/MQTT 内容为历史设计参考
planning/ 开发计划、当前进度交接、待确认事项、缺口清单
reviews/ 代码与文档对比、评审和分析材料;旧评审可能是历史快照
prototypes/ 小程序和管理后台原型文件
reference/ 原始资料包、UI 导出页、截图等参考材料

当前入口

  • planning/PROGRESS.md — 当前实现和部署状态,以此为准
  • deploy/tencent-cloud.md — 腾讯云函数、MySQL、COS 部署说明
  • requirements/软件系统说明.docx
  • requirements/光子美容仪软件系统说明.docx
  • design/01-BLE通信协议明细.md
  • protocols/BLE协议冲突与问题清单.md
  • protocols/协议简述-补充解析.md
  • design/02-小程序业务流程与状态机.md
  • planning/需求缺口清单.md
  • reviews/代码与设计文档对比分析.md — 历史阶段评审,不能代表当前实现

当前实现提示

  • 当前后端是 server/ 下的腾讯云 HTTP 函数,不是微信云开发函数。
  • 当前小程序通过 HTTPS API 调后端,不再使用 wx.cloud.callFunction()
  • 当前设备不直接连云端 MQTT,设备通信主路径是小程序 BLE 中转。
  • 登录资料授权使用 wx.getUserProfile() 官方弹窗;微信可能返回 微信用户 等脱敏资料。
S
描述
无详细信息
自述文档
1.9 MiB
语言
JavaScript 77.2%
Vue 22%
CSS 0.7%