From edf15eb32a91e8e510df4def63474e2773e2dd62 Mon Sep 17 00:00:00 2001
From: Guoguo <i@qwq.trade>
Date: Tue, 28 Jul 2026 07:26:29 -0700
Subject: [PATCH] docs: fix stale region-layout comments to match measured
 mapping

---
 miniprogram/pages/manual-treatment/manual-treatment.wxml | 2 +-
 miniprogram/pages/scan-report/scan-report.wxml           | 2 +-
 miniprogram/pages/treatment-setup/treatment-setup.wxml   | 2 +-
 miniprogram/services/ble/protocol.js                     | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/miniprogram/pages/manual-treatment/manual-treatment.wxml b/miniprogram/pages/manual-treatment/manual-treatment.wxml
index 5d45731..6c4fe2d 100644
--- a/miniprogram/pages/manual-treatment/manual-treatment.wxml
+++ b/miniprogram/pages/manual-treatment/manual-treatment.wxml
@@ -24,7 +24,7 @@
     </view>
 
     <view class="page-title section-title">{{i18n.manual.regionTitle}}</view>
-    <!-- 脸型图布局（与「使用设置」一致）；位置↔idx：0=左 1=中上 2=中 3=中下 4=右 -->
+    <!-- 脸型图布局（与「使用设置」一致）；位置↔idx（实测）：0=右 1=左 2=上 3=中 4=下 -->
     <view class="face-map">
       <view class="face-region forehead {{regions[2].checked ? 'active' : ''}}" bindtap="onToggleRegion" data-idx="2">{{i18n.common.regions.top}}</view>
       <view class="face-region left-cheek {{regions[1].checked ? 'active' : ''}}" bindtap="onToggleRegion" data-idx="1">{{i18n.common.regions.left}}</view>
diff --git a/miniprogram/pages/scan-report/scan-report.wxml b/miniprogram/pages/scan-report/scan-report.wxml
index 22e2a44..9c5a483 100644
--- a/miniprogram/pages/scan-report/scan-report.wxml
+++ b/miniprogram/pages/scan-report/scan-report.wxml
@@ -33,7 +33,7 @@
     <!-- Face zones — 脸型图布局（与「使用设置」区域选择一致，果果 2026-07-28 定稿） -->
     <view class="card">
       <view class="card-title">{{i18n.report.faceTitle}}</view>
-      <!-- 脸型图（与「使用设置」同款布局）；位置↔faceZones 下标：1=中上 0=左 4=右 2=中 3=中下 -->
+      <!-- 脸型图（与「使用设置」同款布局）；faceZones 由 REGION_DEFS 定序：0=右 1=左 2=上 3=中 4=下 -->
       <view class="face-map">
         <view class="face-region forehead {{faceZones[2].colorClass}}" bindtap="onTapZone" data-wave="{{faceZones[2].waveKey}}">
           <view class="fz-name">{{faceZones[2].name}}</view>
diff --git a/miniprogram/pages/treatment-setup/treatment-setup.wxml b/miniprogram/pages/treatment-setup/treatment-setup.wxml
index c672401..1bc0d38 100644
--- a/miniprogram/pages/treatment-setup/treatment-setup.wxml
+++ b/miniprogram/pages/treatment-setup/treatment-setup.wxml
@@ -25,7 +25,7 @@
     <view class="page-title" style="font-size:28rpx;">{{i18n.setup.selectRegion}}</view>
     <view class="mode-tip" wx:if="{{selectedMode === 0}}">{{i18n.setup.normalTip}}</view>
 
-    <!-- 位置↔idx 对应新纵列布局：idx0=左(0x01) idx1=中上(0x02) idx2=中(0x04) idx3=中下(0x08) idx4=右(0x10) -->
+    <!-- 位置↔idx（实测 IO↔物理位置）：idx0=右(0x01) idx1=左(0x02) idx2=上(0x04) idx3=中(0x08) idx4=下(0x10) -->
     <view class="face-map">
       <view class="face-region forehead {{regions[2].checked ? 'active' : ''}} {{selectedMode === 0 ? 'disabled' : ''}}" bindtap="onToggleRegion" data-idx="2">{{i18n.common.regions.top}}</view>
       <view class="face-region left-cheek {{regions[1].checked ? 'active' : ''}} {{selectedMode === 0 ? 'disabled' : ''}}" bindtap="onToggleRegion" data-idx="1">{{i18n.common.regions.left}}</view>
diff --git a/miniprogram/services/ble/protocol.js b/miniprogram/services/ble/protocol.js
index 6c27b43..892c6a1 100644
--- a/miniprogram/services/ble/protocol.js
+++ b/miniprogram/services/ble/protocol.js
@@ -365,7 +365,7 @@ function parseException(payload) {
 
 // --- display helpers ---
 
-// 掩码 = IO 纵列布局（与 REGION 常量一致）。注意：此处为硬编码中文（历史遗留，
+// 掩码 = IO↔物理位置（与 REGION 常量一致）。注意：此处为硬编码中文（历史遗留，
 // history/treatment-done 在用）；新页面请改用 i18n common.regions.* 取标签。
 function getRegionName(mask) {
   var names = []