docs(wiki): B5 §45 患者数据可携权导出 — 关键数字 + 项目阶段 + 模块描述

- 关键数字：迁移 177 / 路由 386+ / 权限 142 / 测试 1037(+6) / 事件 32·52·83
- 项目阶段：B5 §45 已实现(6 测试全绿)，§47 删除权待后续
- erp-health 模块导航：加个保法 §45 数据可携权导出

.gitea/workflows/ci.yml

@@ -46,6 +46,47 @@ jobs:
           ERP__JWT__SECRET: ci-test-secret
           ERP__AUTH__SUPER_ADMIN_PASSWORD: CI_Test_Pass_2026
 
+  # PP-10: 覆盖率 baseline（软门禁阶段）
+  # 当前 continue-on-error=true，先让覆盖率可见、生成报告 artifact。
+  # 后续根据 baseline 真实数据提高 fail-under 阈值（目标 service 层 ≥60%）并去掉
+  # continue-on-error 硬化门禁。见 docs/discussions/2026-06-25-analysis/ PP-10。
+  coverage:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_DB: erp_test
+          POSTGRES_USER: test
+          POSTGRES_PASSWORD: test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: ". -> target"
+      - name: Install cargo-tarpaulin
+        run: cargo install cargo-tarpaulin --locked
+      - name: Run coverage (fail-under 20% baseline)
+        run: cargo tarpaulin --workspace --out Xml --output-dir coverage --fail-under 20 -- --test-threads=2
+        env:
+          ERP__DATABASE__URL: postgres://test:test@localhost:5432/erp_test
+          ERP__JWT__SECRET: ci-test-secret
+          ERP__AUTH__SUPER_ADMIN_PASSWORD: CI_Test_Pass_2026
+      - uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage/
+          if-no-files-found: warn
+
   frontend-build:
     runs-on: ubuntu-latest
     steps:

.github/workflows/test.yml

@@ -17,7 +17,7 @@ jobs:
         image: postgres:16
         env:
           POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: 123123
+          POSTGRES_PASSWORD: postgres
           POSTGRES_DB: postgres
         ports:
           - 5432:5432
@@ -28,9 +28,9 @@ jobs:
           --health-retries 5
 
     env:
-      TEST_DB_URL: postgres://postgres:123123@localhost:5432/postgres
+      TEST_DB_URL: postgres://postgres:postgres@localhost:5432/postgres
       JWT_SECRET: test-jwt-secret-for-ci
-      DATABASE_URL: postgres://postgres:123123@localhost:5432/erp_ci
+      DATABASE_URL: postgres://postgres:postgres@localhost:5432/erp_ci
 
     steps:
       - uses: actions/checkout@v4
@@ -81,7 +81,7 @@ jobs:
         run: pnpm build
 
       - name: Security audit (npm)
-        run: npx npm-audit --audit-level=high || true
+        run: npx npm-audit --audit-level=high
 
   miniprogram-test:
     runs-on: ubuntu-latest

.gitignore

@@ -82,6 +82,28 @@ tmp/
 screenshots/
 server-log.txt
 snapshot_*.txt
+_*.txt
+_server_*.txt
+tmp_*.txt
+direct_*.txt
+server_*.txt
+server_combined.txt
+out.txt
+_wx_login.json
+.claude/settings.json
+
+# Trace/debug JSON
+trace-*.json
+
+# Graphify knowledge graph (regenerated locally)
+graphify-out/
+
+# Native miniprogram (separate project)
+apps/mp-native/
+
+# Misc untracked
+err.txt
 uploads/g:/hms/.superpowers/
 .claude/skills/design-handoff/node_modules/
 .design/config.yml
+.superpowers/

CLAUDE.md

@@ -504,3 +504,32 @@ chore(docker): 添加 PostgreSQL 健康检查
 | 设计文档索引 | `wiki/index.md` |
 | 开发进度、模块状态 | `wiki/index.md` 关键数字 |
 | 环境配置、连接信息、登录凭据 | `wiki/infrastructure.md` §2 |
+
+## graphify — 代码知识图谱
+
+> 项目知识图谱位于 `graphify-out/`，当前规模：18,517 节点 / 22,666 边 / 1,841 社区（纯 AST 解析，无 API 成本）。
+> 工具：`python -m graphify`（已安装 graphifyy 0.8.18）。
+
+### 开发流程中的使用场景
+
+| 时机 | 命令 | 目的 |
+|------|------|------|
+| **接手新任务，理解代码关系** | `graphify query "概念名"` | 搜索相关节点，比 Grep 更精准（按调用/引用/包含关系） |
+| **排查 bug，追踪调用链** | `graphify path "A" "B"` | 查找两个模块/函数间的最短路径 |
+| **理解某个模块的职责** | `graphify explain "模块名"` | 自然语言解释节点及其邻居 |
+| **代码改动后** | `graphify update .` | 增量更新图谱（AST-only，秒级完成） |
+| **宏观架构审查** | 读 `graphify-out/GRAPH_REPORT.md` | 全局社区结构、跨文件关系概览 |
+
+### 使用优先级（融入 §2.5 闭环工作法）
+
+在 §2.5 步骤 1「现状确认」中，**优先使用 graphify 替代盲目 Grep**：
+
+1. **先 `graphify query`** — 精确定位相关节点和社区（比 Grep 返回更结构化的结果）
+2. **再 `graphify path`** — 确认模块间依赖路径（避免遗漏间接依赖）
+3. **最后 Grep/Glob/Read** — 确认 graphify 发现的具体文件内容
+
+### 注意事项
+
+- `graphify update .` 纯本地 AST 解析，不消耗 LLM token，每次代码改动后都可以运行
+- 查询结果比 GRAPH_REPORT.md 更精准，优先使用 query/path/explain，仅在需要全局视图时读报告
+- 首次生成需几分钟（1712 文件），后续增量更新秒级完成

Cargo.toml

@@ -120,6 +120,9 @@ handlebars = "6"
 # HTML sanitization
 ammonia = "4"
 
+# Document parsing
+pdf-extract = "0.7"
+
 # Metrics
 metrics = "0.24"
 metrics-exporter-prometheus = "0.16"

apps/miniprogram/.env.production

@@ -1,3 +1,5 @@
 TARO_APP_API_URL=https://api.hms.example.com/api/v1
 TARO_APP_DEFAULT_TENANT_ID=
-TARO_APP_ENCRYPTION_KEY=
+# TARO_APP_ENCRYPTION_KEY 不在此文件设置
+# 生产密钥通过 CI/CD 环境变量注入（dotenv 不覆盖已有 env var）
+# 本地 build:weapp 测试时自动回退到 .env 中的开发密钥

apps/miniprogram/config/index.ts

@@ -2,6 +2,12 @@ import { defineConfig } from '@tarojs/cli';
 import path from 'path';
 
 export default defineConfig(async (merge) => {
+  // 生产构建缺少加密密钥时发出警告（不阻断构建，但提示开发者/CI 配置）
+  if (process.env.NODE_ENV === 'production' && !process.env.TARO_APP_ENCRYPTION_KEY) {
+    console.warn('[config] ⚠ TARO_APP_ENCRYPTION_KEY 未设置，将回退到 .env 中的开发密钥');
+    console.warn('[config] 生产部署应通过 CI/CD 环境变量注入独立密钥');
+  }
+
   const baseConfig = {
     projectName: 'hms-miniprogram',
     date: '2026-4-23',
@@ -19,6 +25,7 @@ export default defineConfig(async (merge) => {
       'process.env.TARO_APP_WX_TEMPLATE_REPORT': JSON.stringify(process.env.TARO_APP_WX_TEMPLATE_REPORT || ''),
       'process.env.TARO_APP_WX_TEMPLATE_CRITICAL_ALERT': JSON.stringify(process.env.TARO_APP_WX_TEMPLATE_CRITICAL_ALERT || ''),
       'process.env.TARO_APP_WX_TEMPLATE_HEALTH_ABNORMAL': JSON.stringify(process.env.TARO_APP_WX_TEMPLATE_HEALTH_ABNORMAL || ''),
+      'process.env.TARO_APP_WX_TEMPLATE_MEDICATION': JSON.stringify(process.env.TARO_APP_WX_TEMPLATE_MEDICATION || ''),
       'process.env.TARO_APP_DEFAULT_TENANT_ID': JSON.stringify(process.env.TARO_APP_DEFAULT_TENANT_ID || ''),
       'process.env.TARO_APP_DEV_USER': JSON.stringify(
         process.env.NODE_ENV === 'production' ? '' : (process.env.TARO_APP_DEV_USER || '')
@@ -37,15 +44,34 @@ export default defineConfig(async (merge) => {
       resource: ['src/styles/variables.scss'],
     },
     mini: {
+      virtualHost: true,
+      copy: {
+        patterns: [
+          { from: 'src/native-components/', to: 'dist/native-components/', ignore: ['*.ts'] },
+        ],
+        options: {},
+      },
       compile: {
         exclude: [],
         include: [],
       },
       commonChunks: ['runtime', 'vendors', 'taro', 'common'],
       addChunkPages(pages) {
+        // 主包 TabBar 页面保持 common chunk
+        const tabBarPages = new Set([
+          'pages/index/index',
+          'pages/health/index',
+          'pages/mall/index',
+          'pages/messages/index',
+          'pages/profile/index',
+        ]);
         pages.forEach((page) => {
           if (page.name === 'app') return;
-          page.chunks?.unshift('common');
+          // 分包页面不注入 common chunk，由分包自己的 vendors.js 承载
+          if (page.name.startsWith('pages/pkg-')) return;
+          if (tabBarPages.has(page.name) || !page.name.startsWith('pages/')) {
+            page.chunks?.unshift('common');
+          }
         });
       },
       miniCssExtractPluginOption: {

apps/miniprogram/native/pkg-veepoo/index.js

@@ -0,0 +1,863 @@
+/**
+ * Veepoo M2 原生小程序页面 — 连接 + 测量
+ *
+ * 完全脱离 Taro 框架，直接使用微信原生 API + Veepoo SDK。
+ * 流程严格对齐官方 Demo：
+ *   onLoad 注册全局监听器
+ *   → scan → stopScan → connect(等待 connection:true)
+ *   → delay 500ms → authenticate
+ *   → SDK 事件(type=1) / Storage 轮询 → ready
+ */
+// eslint-disable-next-line no-undef
+const { veepooBle, veepooFeature, veepooLogger } = require('./libs/veepoo-sdk');
+
+// ── 常量 ──
+
+var SDK_EVENT_AUTH = 1;
+var SDK_EVENT_BATTERY = 2;
+var SDK_EVENT_SLEEP = 4;
+var SDK_EVENT_DAILY = 5;
+var SDK_EVENT_TEMPERATURE = 6;
+var SDK_EVENT_BLOOD_PRESSURE = 18;
+var SDK_EVENT_BLOOD_OXYGEN = 31;
+var SDK_EVENT_HEART_RATE = 51;
+var SDK_EVENT_PRESSURE = 58;
+var SDK_EVENT_AUTO_TEST = 54;
+
+var MEASURE_TYPES = [
+  { type: 'heart_rate', label: '心率', unit: 'bpm', icon: '♥', color: '#EF4444', sdkType: SDK_EVENT_HEART_RATE },
+  { type: 'blood_oxygen', label: '血氧', unit: '%', icon: 'O₂', color: '#3B82F6', sdkType: SDK_EVENT_BLOOD_OXYGEN },
+  { type: 'blood_pressure', label: '血压', unit: 'mmHg', icon: '↕', color: '#8B5CF6', sdkType: SDK_EVENT_BLOOD_PRESSURE },
+  { type: 'temperature', label: '体温', unit: '°C', icon: 'T', color: '#F59E0B', sdkType: SDK_EVENT_TEMPERATURE },
+  { type: 'pressure', label: '压力', unit: '', icon: '~', color: '#6366F1', sdkType: SDK_EVENT_PRESSURE },
+];
+
+var MEASURE_TIMEOUTS = {
+  heart_rate: 60000,
+  blood_oxygen: 60000,
+  blood_pressure: 120000,
+  temperature: 60000,
+  pressure: 90000,
+};
+
+var MEASURE_SETTLE_DELAY = 1500;
+
+function _findConfig(type) {
+  for (var i = 0; i < MEASURE_TYPES.length; i++) {
+    if (MEASURE_TYPES[i].type === type) return MEASURE_TYPES[i];
+  }
+  return MEASURE_TYPES[0];
+}
+
+// ── Page ──
+
+// eslint-disable-next-line no-undef
+Page({
+  data: {
+    phase: 'idle',
+    deviceId: '',
+    deviceName: 'M2',
+    batteryLevel: null,
+    error: '',
+    selectedType: 'heart_rate',
+    selectedIcon: '♥',
+    selectedColor: '#EF4444',
+    selectedLabel: '心率',
+    selectedUnit: 'bpm',
+    measureTypes: MEASURE_TYPES,
+    measurePhase: 'idle',
+    measureProgress: 0,
+    measureDisplayValue: '',
+    measureError: '',
+    results: {},
+    hasResults: false,
+    // 自动测量状态
+    autoMeasuring: false,
+    autoMeasureDone: false,
+    autoMeasureStatus: {},
+    autoMeasureValues: {},
+    autoMeasureProgress: 0,
+  },
+
+  _authTimer: null,
+  _authTimeout: null,
+  _scanTimer: null,
+  _scanFound: null,
+  _measureTimer: null,
+  _settleTimer: null,
+  _lastValues: null,
+  _connected: false,
+  _eventChannel: null,
+  _connecting: false,
+  _listenersRegistered: false,
+  _autoQueue: null,
+  _autoQueueIndex: 0,
+
+  // ── 生命周期 ──
+
+  onLoad: function () {
+    // eslint-disable-next-line no-undef
+    this._eventChannel = this.getOpenerEventChannel();
+    // eslint-disable-next-line no-undef
+    wx.setNavigationBarTitle({ title: 'M2 手环测量' });
+    this._updateSelectedDisplay('heart_rate');
+
+    // 注意：不在 onLoad 注册 veepooWeiXinSDKNotifyMonitorValueChange！
+    // 该函数内部会调用 wx.notifyBLECharacteristicValueChange，需要蓝牙适配器已初始化。
+    // onLoad 时适配器未初始化 → 返回 "notifyBLECharacteristicValueChange:fail:not init"
+    // 监听器改在 _doConnect 的 connection:true 回调中注册。
+
+    // eslint-disable-next-line no-undef
+    console.log('[veepoo-native] 页面已加载');
+  },
+
+  onUnload: function () {
+    this._cleanup();
+  },
+
+  _cleanup: function () {
+    if (this._authTimer) { clearInterval(this._authTimer); this._authTimer = null; }
+    if (this._authTimeout) { clearTimeout(this._authTimeout); this._authTimeout = null; }
+    if (this._scanTimer) { clearTimeout(this._scanTimer); this._scanTimer = null; }
+    if (this._measureTimer) { clearTimeout(this._measureTimer); this._measureTimer = null; }
+    if (this._settleTimer) { clearTimeout(this._settleTimer); this._settleTimer = null; }
+    this._connecting = false;
+    if (this._connected) {
+      try { veepooBle.veepooWeiXinSDKloseBluetoothAdapterManager(function () {}); } catch (e) {
+        // eslint-disable-next-line no-undef
+        console.warn('[veepoo-native] 断开异常:', e);
+      }
+      this._connected = false;
+    }
+  },
+
+  // ── 全局监听器（onLoad 注册一次） ──
+
+  _registerGlobalListeners: function () {
+    if (this._listenersRegistered) return;
+    this._listenersRegistered = true;
+    var self = this;
+
+    // SDK 数据监听 — 接收所有解析后的事件（auth/measure/battery 等）
+    veepooBle.veepooWeiXinSDKNotifyMonitorValueChange(function (data) {
+      // eslint-disable-next-line no-undef
+      console.log('[veepoo-native] SDK 数据事件:', JSON.stringify(data).substring(0, 500));
+      self._handleSdkEvent(data);
+    });
+
+    // BLE 连接状态变化
+    veepooBle.veepooWeiXinSDKBLEConnectionStateChangeManager(function (res) {
+      // eslint-disable-next-line no-undef
+      console.log('[veepoo-native] 连接状态变化:', JSON.stringify(res));
+      if (!res.connected) {
+        self._connected = false;
+        self._connecting = false;
+        self._cancelPendingMeasure();
+        self.setData({ phase: 'disconnected' });
+      }
+    });
+
+    // eslint-disable-next-line no-undef
+    console.log('[veepoo-native] SDK 函数类型:', {
+      scanFn: typeof veepooBle.veepooWeiXinSDKStartScanDeviceAndReceiveScanningDevice,
+      connectFn: typeof veepooBle.veepooWeiXinSDKBleConnectionServicesCharacteristicsNotifyManager,
+      dataFn: typeof veepooBle.veepooWeiXinSDKNotifyMonitorValueChange,
+      authFn: typeof veepooFeature.veepooBlePasswordCheckManager,
+    });
+  },
+
+  _updateSelectedDisplay: function (type) {
+    var cfg = _findConfig(type);
+    this.setData({
+      selectedType: type,
+      selectedIcon: cfg.icon,
+      selectedColor: cfg.color,
+      selectedLabel: cfg.label,
+      selectedUnit: cfg.unit,
+    });
+  },
+
+  // ── 连接流程 ──
+
+  handleConnect: function () {
+    if (this.data.phase !== 'idle' && this.data.phase !== 'error' && this.data.phase !== 'disconnected') return;
+    if (this._connecting) return;
+    this._connecting = true;
+
+    this.setData({ phase: 'scanning', error: '' });
+    veepooLogger.setLevel(0);
+
+    var self = this;
+    self._scanFound = null;
+
+    veepooBle.veepooWeiXinSDKStartScanDeviceAndReceiveScanningDevice(function (res) {
+      var device = Array.isArray(res) ? res[0] : res;
+      if (!device) return;
+      var name = (device.localName || device.name || '').toUpperCase();
+      var deviceId = device.deviceId || device.mac || '';
+      // eslint-disable-next-line no-undef
+      console.log('[veepoo-native] 扫描到:', name, deviceId);
+      if (!self._scanFound && (name.indexOf('M2') !== -1 || name.indexOf('VPM') !== -1 || name.indexOf('VEEPOO') !== -1)) {
+        self._scanFound = device;
+        veepooBle.veepooWeiXinSDKStopSearchBleManager(function () {
+          self._doConnect(device);
+        });
+      }
+    });
+
+    this._scanTimer = setTimeout(function () {
+      if (!self._scanFound) {
+        veepooBle.veepooWeiXinSDKStopSearchBleManager(function () {});
+        self._connecting = false;
+        self.setData({ phase: 'error', error: '未找到 M2 设备，请确保手环已开机且蓝牙已开启' });
+      }
+    }, 15000);
+  },
+
+  _doConnect: function (device) {
+    this.setData({ phase: 'connecting' });
+    // eslint-disable-next-line no-undef
+    console.log('[veepoo-native] 开始连接:', device.deviceId || device.mac);
+    var self = this;
+
+    veepooBle.veepooWeiXinSDKBleConnectionServicesCharacteristicsNotifyManager(device, function (result) {
+      // eslint-disable-next-line no-undef
+      console.log('[veepoo-native] 连接阶段回调:', JSON.stringify(result).substring(0, 300));
+
+      // 只响应最终就绪回调（connection:true）
+      if (result.connection === true) {
+        self._connected = true;
+        self._connecting = false;
+        self.setData({
+          deviceId: device.deviceId || device.mac || '',
+        });
+
+        // 关键：在连接就绪后注册数据监听器
+        // veepooWeiXinSDKNotifyMonitorValueChange 内部会调用
+        // wx.notifyBLECharacteristicValueChange，需要蓝牙适配器已初始化+已连接
+        self._registerGlobalListeners();
+
+        // eslint-disable-next-line no-undef
+        console.log('[veepoo-native] 连接就绪，监听器已注册，500ms 后发送认证');
+
+        setTimeout(function () {
+          // eslint-disable-next-line no-undef
+          console.log('[veepoo-native] 调用 veepooBlePasswordCheckManager');
+          veepooFeature.veepooBlePasswordCheckManager();
+          self.setData({ phase: 'authenticating' });
+        }, 500);
+
+        // Storage 轮询兜底
+        self._authTimer = setInterval(function () {
+          try {
+            // eslint-disable-next-line no-undef
+            var status = wx.getStorageSync('deviceChipStatus');
+            // SDK 可能写入字符串或布尔值 true
+            if (status === 'successfulVerification' || status === 'passTheVerification' || status === true) {
+              clearInterval(self._authTimer);
+              self._authTimer = null;
+              self._onReady();
+            }
+          } catch (_) { /* ignore */ }
+        }, 500);
+
+        self._authTimeout = setTimeout(function () {
+          if (self._authTimer) {
+            clearInterval(self._authTimer);
+            self._authTimer = null;
+            self._connecting = false;
+            // eslint-disable-next-line no-undef
+            console.error('[veepoo-native] 认证超时 deviceChipStatus=', wx.getStorageSync('deviceChipStatus'));
+            self.setData({ phase: 'error', error: '设备认证超时，请重新连接' });
+          }
+        }, 8000);
+      }
+    });
+  },
+
+  _onReady: function () {
+    if (this._authTimeout) { clearTimeout(this._authTimeout); this._authTimeout = null; }
+    this._connecting = false;
+    // eslint-disable-next-line no-undef
+    console.log('[veepoo-native] 认证成功，设备就绪');
+    this.setData({ phase: 'ready' });
+    veepooFeature.veepooReadElectricQuantityManager();
+
+    // 认证成功后自动读取 3 天睡眠数据 + 开启自动测量
+    this._readSleepData();
+    this._enableAutoMeasurement();
+
+    // 自动依次测量所有指标（面向中老年人，减少操作）
+    this._startAutoMeasureQueue();
+  },
+
+  // ── SDK 事件路由 ──
+
+  _handleSdkEvent: function (data) {
+    if (!data || data.type === undefined) return;
+    var type = data.type;
+
+    if (type === SDK_EVENT_AUTH) {
+      var content = data.content || {};
+      // eslint-disable-next-line no-undef
+      console.log('[veepoo-native] 认证事件: VPDeviceAck=' + content.VPDeviceAck + ' VPDevicepassword=' + content.VPDevicepassword);
+      // VPDeviceAck 是认证结果（successfulVerification/passTheVerification）
+      // VPDevicepassword 是设备密码原始值（如 "0000"），不是认证结果
+      if (content.VPDeviceAck === 'successfulVerification' || content.VPDeviceAck === 'passTheVerification') {
+        if (this._authTimer) { clearInterval(this._authTimer); this._authTimer = null; }
+        if (this._authTimeout) { clearTimeout(this._authTimeout); this._authTimeout = null; }
+        this._onReady();
+      }
+      return;
+    }
+
+    if (type === SDK_EVENT_BATTERY) {
+      var pct = (data.content || {}).VPDeviceElectricPercent;
+      if (pct !== undefined && pct !== null) {
+        this.setData({ batteryLevel: Number(pct) });
+      }
+      return;
+    }
+
+    // 睡眠数据回调（type=4）
+    if (type === SDK_EVENT_SLEEP) {
+      this._handleSleepEvent(data);
+      return;
+    }
+
+    // 日常数据回调（type=5）
+    if (type === SDK_EVENT_DAILY) {
+      // 日常数据用于历史同步，原生页面暂不处理
+      return;
+    }
+
+    // 自动测量配置回调（type=54）
+    if (type === SDK_EVENT_AUTO_TEST) {
+      // eslint-disable-next-line no-undef
+      console.log('[veepoo-native] 自动测量配置回调');
+      return;
+    }
+
+    for (var i = 0; i < MEASURE_TYPES.length; i++) {
+      if (MEASURE_TYPES[i].sdkType === type) {
+        this._handleMeasureEvent(MEASURE_TYPES[i].type, data);
+        return;
+      }
+    }
+  },
+
+  // ── 测量流程 ──
+
+  handleSelectType: function (e) {
+    var type = e.currentTarget.dataset.type;
+    if (this.data.measurePhase === 'measuring') return;
+    this._updateSelectedDisplay(type);
+    this.setData({ measureError: '' });
+  },
+
+  handleStartMeasure: function () {
+    var type = this.data.selectedType;
+    if (this.data.measurePhase === 'measuring') return;
+    if (!this._connected) {
+      this.setData({ measureError: '设备未连接' });
+      return;
+    }
+
+    var self = this;
+    self._lastValues = null;
+
+    self.setData({
+      measurePhase: 'measuring',
+      measureProgress: 0,
+      measureDisplayValue: '',
+      measureError: '',
+    });
+
+    self._sendMeasureCommand(type, true);
+
+    self._measureTimer = setTimeout(function () {
+      self._onMeasureError('测量超时，请重试');
+    }, MEASURE_TIMEOUTS[type] || 60000);
+  },
+
+  handleCancelMeasure: function () {
+    this._cancelPendingMeasure();
+    this.setData({
+      measurePhase: 'idle',
+      measureProgress: 0,
+      measureDisplayValue: '',
+    });
+  },
+
+  handleDisconnect: function () {
+    this._cleanup();
+    this.setData({ phase: 'idle', deviceId: '', batteryLevel: null, error: '' });
+  },
+
+  handleBack: function () {
+    var results = this.data.results;
+    if (Object.keys(results).length > 0) {
+      try {
+        // eslint-disable-next-line no-undef
+        wx.setStorageSync('hms:veepoo_measure_results', JSON.stringify(results));
+      } catch (_) { /* ignore */ }
+    }
+    if (this._eventChannel) {
+      this._eventChannel.emit('measureComplete', { results: results, count: Object.keys(results).length });
+    }
+    // eslint-disable-next-line no-undef
+    wx.navigateBack({ delta: 1 });
+  },
+
+  handleResetResult: function () {
+    var type = this.data.selectedType;
+    var newResults = Object.assign({}, this.data.results);
+    delete newResults[type];
+    this.setData({
+      measurePhase: 'idle',
+      measureProgress: 0,
+      measureDisplayValue: '',
+      measureError: '',
+      results: newResults,
+      hasResults: Object.keys(newResults).length > 0,
+    });
+  },
+
+  // ── 测量事件处理 ──
+
+  _handleMeasureEvent: function (type, data) {
+    // 自动测量模式下，路由到自动测量处理器
+    if (this.data.autoMeasuring) {
+      this._handleAutoMeasureEvent(type, data);
+      return;
+    }
+
+    // 手动测量模式
+    if (this.data.selectedType !== type || this.data.measurePhase !== 'measuring') return;
+
+    var content = data.content || {};
+    var self = this;
+
+    if (content.deviceBusy === true) { self._onMeasureError('设备正忙，请稍后重试'); return; }
+    if (content.notWear === true || data.state === 6) { self._onMeasureError('请将手环佩戴到手腕上'); return; }
+    if (data.state === 7) { self._onMeasureError('设备正在充电'); return; }
+    if (data.state === 8) { self._onMeasureError('设备电量不足'); return; }
+    if (type === 'pressure' && data.ack === 2) { self._onMeasureError('设备电量不足'); return; }
+    if (type === 'pressure' && data.ack === 3) { self._onMeasureError('设备正在测量其他数据'); return; }
+    if (type === 'pressure' && data.ack === 4) { self._onMeasureError('佩戴检测未通过'); return; }
+
+    var values = self._extractValues(type, content);
+    if (!values) return;
+
+    self._lastValues = values;
+
+    var displayVal = self._formatValues(type, values);
+    var progress = data.Progress !== undefined ? data.Progress : 0;
+    self.setData({
+      measureDisplayValue: displayVal,
+      measureProgress: Math.max(progress, 0),
+    });
+
+    if (progress >= 100) {
+      self._onMeasureSuccess(type, values);
+      return;
+    }
+
+    if (!self._settleTimer) {
+      self._settleTimer = setTimeout(function () {
+        if (self._lastValues && self.data.measurePhase === 'measuring') {
+          self._onMeasureSuccess(type, self._lastValues);
+        }
+      }, MEASURE_SETTLE_DELAY);
+    }
+  },
+
+  _extractValues: function (type, content) {
+    switch (type) {
+      case 'heart_rate': {
+        var hr = Number(content.heartRate);
+        return (hr >= 30 && hr <= 250) ? { heart_rate: hr } : null;
+      }
+      case 'blood_oxygen': {
+        var bo = Number(content.bloodOxygen);
+        return (bo >= 70 && bo <= 100) ? { blood_oxygen: bo } : null;
+      }
+      case 'blood_pressure': {
+        var high = Number(content.bloodPressureHigh);
+        var low = Number(content.bloodPressureLow);
+        return (high > 0 && low > 0) ? { systolic: high, diastolic: low } : null;
+      }
+      case 'temperature': {
+        var temp = Number(content.bodyTemperature);
+        return (temp > 30 && temp < 45) ? { temperature: temp } : null;
+      }
+      case 'pressure': {
+        var p = Number(content.pressure);
+        return (p >= 0 && p <= 100) ? { pressure: p } : null;
+      }
+      default: return null;
+    }
+  },
+
+  _formatValues: function (type, values) {
+    if (type === 'blood_pressure') {
+      return (values.systolic != null ? values.systolic : '--') + '/' + (values.diastolic != null ? values.diastolic : '--');
+    }
+    var v = Object.values(values)[0];
+    return (v !== undefined && v !== null) ? String(v) : '--';
+  },
+
+  _onMeasureSuccess: function (type, values) {
+    this._cancelPendingMeasure();
+
+    var result = { type: type, values: values, measuredAt: Date.now() };
+    var newResults = Object.assign({}, this.data.results);
+    newResults[type] = result;
+
+    this.setData({
+      measurePhase: 'success',
+      measureProgress: 100,
+      measureDisplayValue: this._formatValues(type, values),
+      results: newResults,
+      hasResults: true,
+    });
+
+    if (this._eventChannel) {
+      this._eventChannel.emit('measureResult', result);
+    }
+  },
+
+  _onMeasureError: function (msg) {
+    this._cancelPendingMeasure();
+    this.setData({ measurePhase: 'error', measureError: msg });
+  },
+
+  _cancelPendingMeasure: function () {
+    if (this._measureTimer) { clearTimeout(this._measureTimer); this._measureTimer = null; }
+    if (this._settleTimer) { clearTimeout(this._settleTimer); this._settleTimer = null; }
+    this._lastValues = null;
+
+    var type = this.data.selectedType;
+    if (type) this._sendMeasureCommand(type, false);
+  },
+
+  _sendMeasureCommand: function (type, on) {
+    switch (type) {
+      case 'heart_rate':
+        veepooFeature.veepooSendHeartRateTestSwitchManager({ switch: !!on });
+        break;
+      case 'blood_oxygen':
+        veepooFeature.veepooSendBloodOxygenControlDataManager({ switch: on ? 'start' : 'stop' });
+        break;
+      case 'blood_pressure':
+        veepooFeature.veepooSendReadUniversalBloodPressureDataManager({ switch: on ? 'start' : 'stop' });
+        break;
+      case 'temperature':
+        veepooFeature.veepooSendTemperatureMeasurementSwitchManager({ switch: !!on });
+        break;
+      case 'pressure':
+        veepooFeature.veepooSendPressureTestManager({ switch: !!on });
+        break;
+    }
+  },
+
+  // ── 睡眠数据读取 ──
+
+  _sleepResults: null,
+  _sleepDay: 0,
+
+  _readSleepData: function () {
+    this._sleepResults = [];
+    this._sleepDay = 0;
+    // eslint-disable-next-line no-undef
+    console.log('[veepoo-native] 开始读取睡眠数据（3天）');
+
+    // 依次读取 3 天睡眠
+    var self = this;
+    veepooFeature.veepooSendReadPreciseSleepManager({ day: 0 });
+
+    // 延迟读取后续天（避免并发冲突）
+    // eslint-disable-next-line no-undef
+    setTimeout(function () { veepooFeature.veepooSendReadPreciseSleepManager({ day: 1 }); }, 3000);
+    // eslint-disable-next-line no-undef
+    setTimeout(function () { veepooFeature.veepooSendReadPreciseSleepManager({ day: 2 }); }, 6000);
+  },
+
+  _handleSleepEvent: function (data) {
+    var progress = data.Progress || 0;
+    if (progress < 100) return;
+
+    var content = data.content || {};
+    var readDay = data.readDay || 0;
+    var totalTime = Number(content.sleepTotalTime || 0);
+
+    if (totalTime <= 0) return;
+
+    var sleepResult = {
+      day: readDay,
+      deepSleepMinutes: Number(content.deepSleepTime || 0),
+      lightSleepMinutes: Number(content.lightSleepTime || 0),
+      totalSleepMinutes: totalTime,
+      qualityScore: Number(content.sleepQuality || 0),
+      fallAsleepTime: String(content.fallAsleepTime || ''),
+      exitSleepTime: String(content.exitSleepTime || ''),
+    };
+
+    if (!this._sleepResults) this._sleepResults = [];
+    this._sleepResults.push(sleepResult);
+
+    // eslint-disable-next-line no-undef
+    console.log('[veepoo-native] 睡眠数据 day=' + readDay + ' 总时长=' + totalTime + '分钟 质量=' + sleepResult.qualityScore + '星');
+
+    // 保存到 Storage 供 Taro 页面读取
+    try {
+      // eslint-disable-next-line no-undef
+      wx.setStorageSync('hms:veepoo_sleep_results', JSON.stringify(this._sleepResults));
+    } catch (_) { /* ignore */ }
+  },
+
+  // ── 自动测量 ──
+
+  _enableAutoMeasurement: function () {
+    // eslint-disable-next-line no-undef
+    console.log('[veepoo-native] 开启自动测量功能');
+
+    // 开启心率自动监测
+    try {
+      veepooFeature.veepooSendSwitchSettingDataManager({
+        VPSettingAutomaticHRTest: 'open',
+      });
+    } catch (e) {
+      // eslint-disable-next-line no-undef
+      console.warn('[veepoo-native] 开启心率自动监测失败:', e);
+    }
+
+    // 开启血压自动监测
+    try {
+      veepooFeature.veepooSendSwitchSettingDataManager({
+        VPSettingAutomaticBPTest: 'open',
+      });
+    } catch (e) {
+      // eslint-disable-next-line no-undef
+      console.warn('[veepoo-native] 开启血压自动监测失败:', e);
+    }
+
+    // 开启体温自动监测
+    try {
+      veepooFeature.veepooSendSwitchSettingDataManager({
+        VPSettingAutomaticTemperatureTest: 'open',
+      });
+    } catch (e) {
+      // eslint-disable-next-line no-undef
+      console.warn('[veepoo-native] 开启体温自动监测失败:', e);
+    }
+  },
+
+  // ── 自动测量队列 ──
+
+  _startAutoMeasureQueue: function () {
+    var types = [];
+    var status = {};
+    for (var i = 0; i < MEASURE_TYPES.length; i++) {
+      types.push(MEASURE_TYPES[i].type);
+      status[MEASURE_TYPES[i].type] = 'pending';
+    }
+
+    this._autoQueue = types;
+    this._autoQueueIndex = 0;
+
+    this.setData({
+      autoMeasuring: true,
+      autoMeasureDone: false,
+      autoMeasureStatus: status,
+      autoMeasureValues: {},
+      autoMeasureProgress: 0,
+    });
+
+    // eslint-disable-next-line no-undef
+    console.log('[veepoo-native] 启动自动测量队列，共 ' + types.length + ' 项');
+
+    var self = this;
+    setTimeout(function () {
+      self._startNextAutoMeasure();
+    }, 800);
+  },
+
+  _startNextAutoMeasure: function () {
+    if (!this._autoQueue || this._autoQueueIndex >= this._autoQueue.length) {
+      this._onAutoMeasureComplete();
+      return;
+    }
+
+    var type = this._autoQueue[this._autoQueueIndex];
+    this._updateSelectedDisplay(type);
+
+    var status = Object.assign({}, this.data.autoMeasureStatus);
+    status[type] = 'measuring';
+    this.setData({
+      autoMeasureStatus: status,
+      measurePhase: 'measuring',
+      measureProgress: 0,
+      measureDisplayValue: '',
+      measureError: '',
+    });
+
+    // eslint-disable-next-line no-undef
+    console.log('[veepoo-native] 自动测量 [' + (this._autoQueueIndex + 1) + '/' + this._autoQueue.length + ']: ' + type);
+
+    this._lastValues = null;
+    this._sendMeasureCommand(type, true);
+
+    var self = this;
+    var timeout = MEASURE_TIMEOUTS[type] || 60000;
+    this._measureTimer = setTimeout(function () {
+      // eslint-disable-next-line no-undef
+      console.warn('[veepoo-native] 自动测量超时: ' + type);
+      self._onAutoMeasureError(type, '测量超时');
+    }, timeout);
+  },
+
+  _handleAutoMeasureEvent: function (type, data) {
+    if (!this._autoQueue || this._autoQueueIndex >= this._autoQueue.length) return;
+    if (type !== this._autoQueue[this._autoQueueIndex]) return;
+
+    var content = data.content || {};
+    var self = this;
+
+    if (content.deviceBusy === true) { self._onAutoMeasureError(type, '设备正忙'); return; }
+    if (content.notWear === true || data.state === 6) { self._onAutoMeasureError(type, '未佩戴'); return; }
+    if (data.state === 7) { self._onAutoMeasureError(type, '设备充电中'); return; }
+    if (data.state === 8) { self._onAutoMeasureError(type, '电量不足'); return; }
+    if (type === 'pressure' && data.ack === 2) { self._onAutoMeasureError(type, '电量不足'); return; }
+    if (type === 'pressure' && data.ack === 3) { self._onAutoMeasureError(type, '设备正忙'); return; }
+    if (type === 'pressure' && data.ack === 4) { self._onAutoMeasureError(type, '未佩戴'); return; }
+
+    var values = self._extractValues(type, content);
+    if (!values) return;
+
+    self._lastValues = values;
+
+    var progress = data.Progress !== undefined ? data.Progress : 0;
+    self.setData({ measureProgress: Math.max(progress, 0) });
+
+    if (progress >= 100) {
+      self._onAutoMeasureSuccess(type, values);
+      return;
+    }
+
+    if (!self._settleTimer) {
+      self._settleTimer = setTimeout(function () {
+        if (self._lastValues && self.data.autoMeasuring) {
+          self._onAutoMeasureSuccess(type, self._lastValues);
+        }
+      }, MEASURE_SETTLE_DELAY);
+    }
+  },
+
+  _onAutoMeasureSuccess: function (type, values) {
+    this._cancelPendingMeasure();
+
+    var result = { type: type, values: values, measuredAt: Date.now() };
+    var newResults = Object.assign({}, this.data.results);
+    newResults[type] = result;
+
+    var status = Object.assign({}, this.data.autoMeasureStatus);
+    status[type] = 'done';
+
+    var newValues = Object.assign({}, this.data.autoMeasureValues);
+    newValues[type] = this._formatValues(type, values);
+
+    var doneCount = 0;
+    var keys = Object.keys(status);
+    for (var i = 0; i < keys.length; i++) {
+      if (status[keys[i]] === 'done' || status[keys[i]] === 'error') doneCount++;
+    }
+    var progress = Math.round((doneCount / this._autoQueue.length) * 100);
+
+    // eslint-disable-next-line no-undef
+    console.log('[veepoo-native] 自动测量完成: ' + type + ' = ' + newValues[type] + ' (' + progress + '%)');
+
+    this.setData({
+      results: newResults,
+      hasResults: true,
+      autoMeasureStatus: status,
+      autoMeasureValues: newValues,
+      autoMeasureProgress: progress,
+      measurePhase: 'idle',
+    });
+
+    this._autoQueueIndex++;
+    var self = this;
+    setTimeout(function () {
+      self._startNextAutoMeasure();
+    }, 800);
+  },
+
+  _onAutoMeasureError: function (type, msg) {
+    this._cancelPendingMeasure();
+
+    var status = Object.assign({}, this.data.autoMeasureStatus);
+    status[type] = 'error';
+
+    var doneCount = 0;
+    var keys = Object.keys(status);
+    for (var i = 0; i < keys.length; i++) {
+      if (status[keys[i]] === 'done' || status[keys[i]] === 'error') doneCount++;
+    }
+    var progress = Math.round((doneCount / this._autoQueue.length) * 100);
+
+    // eslint-disable-next-line no-undef
+    console.warn('[veepoo-native] 自动测量失败: ' + type + ' - ' + msg + ' (' + progress + '%)');
+
+    this.setData({
+      autoMeasureStatus: status,
+      autoMeasureProgress: progress,
+      measurePhase: 'idle',
+    });
+
+    this._autoQueueIndex++;
+    var self = this;
+    setTimeout(function () {
+      self._startNextAutoMeasure();
+    }, 500);
+  },
+
+  _onAutoMeasureComplete: function () {
+    // eslint-disable-next-line no-undef
+    console.log('[veepoo-native] 自动测量全部完成');
+
+    var results = this.data.results;
+    if (Object.keys(results).length > 0) {
+      try {
+        // eslint-disable-next-line no-undef
+        wx.setStorageSync('hms:veepoo_measure_results', JSON.stringify(results));
+      } catch (_) { /* ignore */ }
+    }
+
+    this.setData({
+      autoMeasureDone: true,
+      autoMeasuring: false,
+      autoMeasureProgress: 100,
+      measurePhase: 'idle',
+    });
+  },
+
+  handleCancelAutoMeasure: function () {
+    this._cancelPendingMeasure();
+    this._autoQueue = null;
+
+    var results = this.data.results;
+    if (Object.keys(results).length > 0) {
+      try {
+        // eslint-disable-next-line no-undef
+        wx.setStorageSync('hms:veepoo_measure_results', JSON.stringify(results));
+      } catch (_) { /* ignore */ }
+    }
+
+    this.setData({
+      autoMeasuring: false,
+      autoMeasureDone: false,
+      measurePhase: 'idle',
+    });
+  },
+});

apps/miniprogram/native/pkg-veepoo/index.json

@@ -0,0 +1,6 @@
+{
+  "navigationBarTitleText": "M2 手环测量",
+  "navigationBarBackgroundColor": "#FFFFFF",
+  "navigationBarTextStyle": "black",
+  "backgroundColor": "#F5F5F4"
+}

apps/miniprogram/native/pkg-veepoo/index.wxml

@@ -0,0 +1,215 @@
+<!--
+  Veepoo M2 原生小程序页面 — 连接 + 测量
+  设计原型: docs/design/veepoo-measure-prototype.html
+  完全匹配 SDK 官方 Demo 流程，不依赖 Taro
+-->
+
+<!-- ═══ 未连接 / 错误 / 断开 ═══ -->
+<block wx:if="{{phase === 'idle' || phase === 'error' || phase === 'disconnected'}}">
+  <view class="connect-screen">
+    <view class="connect-anim">
+      <view class="connect-ring"></view>
+      <view class="connect-center">
+        <text class="connect-bt">BT</text>
+      </view>
+    </view>
+    <text class="connect-title">M2 手环健康测量</text>
+    <text class="connect-hint">请确保手环已开机且蓝牙已开启</text>
+
+    <view wx:if="{{error}}" class="connect-error">
+      <text class="connect-error-text">{{error}}</text>
+    </view>
+
+    <view class="connect-btn-wrap">
+      <view class="btn-primary" bindtap="handleConnect">
+        {{phase === 'error' ? '重新连接' : phase === 'disconnected' ? '重新连接' : '连接 M2 手环'}}
+      </view>
+    </view>
+
+    <view wx:if="{{hasResults}}" class="connect-back">
+      <view class="btn-text" bindtap="handleBack">查看测量结果并返回</view>
+    </view>
+  </view>
+</block>
+
+<!-- ═══ 连接中（扫描/连接/认证） ═══ -->
+<block wx:elif="{{phase === 'scanning' || phase === 'connecting' || phase === 'authenticating'}}">
+  <view class="connect-screen">
+    <view class="connect-anim">
+      <view class="connect-ring connect-ring--active"></view>
+      <view class="connect-center">
+        <text class="connect-bt">BT</text>
+      </view>
+    </view>
+    <text class="connect-title">
+      {{phase === 'scanning' ? '正在搜索 M2 手环...' : phase === 'connecting' ? '正在连接...' : '正在认证...'}}
+    </text>
+    <text class="connect-hint">请确保手环已开机且靠近手机</text>
+  </view>
+</block>
+
+<!-- ═══ 自动测量中 / 自动测量完成 ═══ -->
+<block wx:elif="{{phase === 'ready' && (autoMeasuring || autoMeasureDone)}}">
+  <view class="measure-page">
+    <!-- 设备状态栏 -->
+    <view class="device-bar">
+      <view class="device-bar__left">
+        <view class="device-bar__dot"></view>
+        <text class="device-bar__name">{{deviceName}}</text>
+        <text wx:if="{{batteryLevel !== null}}" class="device-bar__battery">{{batteryLevel}}%</text>
+      </view>
+      <view wx:if="{{autoMeasuring}}" class="device-bar__disconnect" bindtap="handleCancelAutoMeasure">取消</view>
+    </view>
+
+    <view class="auto-measure">
+      <!-- 标题 -->
+      <view class="auto-measure__header">
+        <text class="auto-measure__title">{{autoMeasureDone ? '✓ 测量完成！' : '正在自动测量...'}}</text>
+        <text wx:if="{{!autoMeasureDone}}" class="auto-measure__subtitle">请保持手环佩戴，无需任何操作</text>
+      </view>
+
+      <!-- 指标列表 -->
+      <view class="auto-measure__list">
+        <view
+          wx:for="{{measureTypes}}"
+          wx:key="type"
+          class="auto-item {{autoMeasureStatus[item.type] === 'done' ? 'auto-item--done' : autoMeasureStatus[item.type] === 'measuring' ? 'auto-item--active' : autoMeasureStatus[item.type] === 'error' ? 'auto-item--error' : ''}}"
+        >
+          <view class="auto-item__left">
+            <view class="auto-item__icon-wrap" style="background: {{autoMeasureStatus[item.type] === 'done' ? item.color : autoMeasureStatus[item.type] === 'error' ? '#ccc' : item.color}}">
+              <text class="auto-item__icon">{{autoMeasureStatus[item.type] === 'done' ? '✓' : autoMeasureStatus[item.type] === 'error' ? '✕' : item.icon}}</text>
+            </view>
+            <text class="auto-item__label">{{item.label}}</text>
+          </view>
+          <view class="auto-item__right">
+            <block wx:if="{{autoMeasureStatus[item.type] === 'done'}}">
+              <text class="auto-item__value" style="color: {{item.color}}">{{autoMeasureValues[item.type]}}</text>
+              <text wx:if="{{item.unit}}" class="auto-item__unit">{{item.unit}}</text>
+            </block>
+            <text wx:elif="{{autoMeasureStatus[item.type] === 'measuring'}}" class="auto-item__status auto-item__status--active">测量中...</text>
+            <text wx:elif="{{autoMeasureStatus[item.type] === 'error'}}" class="auto-item__status auto-item__status--error">已跳过</text>
+            <text wx:else class="auto-item__status">等待中</text>
+          </view>
+        </view>
+      </view>
+
+      <!-- 进度条 -->
+      <view class="auto-progress">
+        <view class="auto-progress__bar">
+          <view class="auto-progress__fill" style="width: {{autoMeasureProgress}}%"></view>
+        </view>
+        <text class="auto-progress__text">{{autoMeasureProgress}}%</text>
+      </view>
+
+      <!-- 免责声明 -->
+      <view class="disclaimer">
+        <text class="disclaimer__text">测量数据仅供参考，不作为医学诊断依据。如有不适请及时就医。</text>
+      </view>
+
+      <!-- 操作按钮 -->
+      <view class="actions">
+        <block wx:if="{{autoMeasureDone}}">
+          <view class="btn btn--primary" bindtap="handleBack">查看结果并返回</view>
+        </block>
+        <block wx:elif="{{autoMeasuring}}">
+          <view class="btn btn--text" bindtap="handleCancelAutoMeasure">取消自动测量</view>
+        </block>
+      </view>
+    </view>
+  </view>
+</block>
+
+<!-- ═══ 就绪 + 手动测量 ═══ -->
+<block wx:elif="{{phase === 'ready'}}">
+  <view class="measure-page">
+    <!-- 设备状态栏 -->
+    <view class="device-bar">
+      <view class="device-bar__left">
+        <view class="device-bar__dot"></view>
+        <text class="device-bar__name">{{deviceName}}</text>
+        <text wx:if="{{batteryLevel !== null}}" class="device-bar__battery">{{batteryLevel}}%</text>
+      </view>
+      <view class="device-bar__disconnect" bindtap="handleDisconnect">断开</view>
+    </view>
+
+    <!-- 指标选择器 — 药丸式 -->
+    <scroll-view class="selector" scroll-x enhanced show-scrollbar="{{false}}">
+      <view
+        wx:for="{{measureTypes}}"
+        wx:key="type"
+        class="selector__pill {{selectedType === item.type ? 'selector__pill--active' : ''}} {{results[item.type] ? 'selector__pill--done' : ''}}"
+        data-type="{{item.type}}"
+        bindtap="handleSelectType"
+      >
+        <view class="selector__icon-wrap" style="background: {{item.color}}">
+          <text class="selector__icon">{{item.icon}}</text>
+        </view>
+        <text class="selector__label">{{item.label}}</text>
+      </view>
+    </scroll-view>
+
+    <!-- 仪表盘区域 -->
+    <view class="gauge-section">
+      <view class="gauge {{measurePhase === 'measuring' ? 'gauge--measuring' : ''}}">
+        <!-- SVG 圆环 -->
+        <view class="gauge__ring-wrap">
+          <view class="gauge__ring-bg"></view>
+          <view class="gauge__ring-progress" style="background: conic-gradient({{selectedColor}} {{measureProgress * 3.6}}deg, #E8E2DC 0deg);"></view>
+          <view class="gauge__center">
+            <!-- 空闲 -->
+            <block wx:if="{{measurePhase === 'idle'}}">
+              <text class="gauge__icon-lg" style="color: {{selectedColor}}">{{selectedIcon}}</text>
+              <text class="gauge__hint">点击下方按钮开始</text>
+            </block>
+            <!-- 测量中 -->
+            <block wx:elif="{{measurePhase === 'measuring'}}">
+              <text wx:if="{{measureDisplayValue}}" class="gauge__value" style="color: {{selectedColor}}">{{measureDisplayValue}}</text>
+              <text wx:else class="gauge__loading">测量中...</text>
+              <text wx:if="{{measureDisplayValue}}" class="gauge__unit">{{selectedUnit}}</text>
+            </block>
+            <!-- 成功 -->
+            <block wx:elif="{{measurePhase === 'success'}}">
+              <text class="gauge__value" style="color: {{selectedColor}}">{{measureDisplayValue}}</text>
+              <text class="gauge__unit">{{selectedUnit}}</text>
+            </block>
+            <!-- 错误 -->
+            <block wx:elif="{{measurePhase === 'error'}}">
+              <text class="gauge__err">!</text>
+              <text class="gauge__err-text">{{measureError}}</text>
+            </block>
+          </view>
+        </view>
+      </view>
+
+      <!-- 进度条 -->
+      <view wx:if="{{measurePhase === 'measuring' && measureProgress > 0}}" class="progress-bar">
+        <view class="progress-bar__fill" style="width: {{measureProgress}}%; background: {{selectedColor}};"></view>
+      </view>
+    </view>
+
+    <!-- 免责声明 -->
+    <view class="disclaimer">
+      <text class="disclaimer__text">测量数据仅供参考，不作为医学诊断依据。如有不适请及时就医。</text>
+    </view>
+
+    <!-- 操作按钮 -->
+    <view class="actions">
+      <block wx:if="{{measurePhase === 'idle'}}">
+        <view class="btn btn--primary" style="background: {{selectedColor}}; box-shadow: 0 4px 16px rgba(0,0,0,0.15);" bindtap="handleStartMeasure">
+          开始测量{{selectedLabel}}
+        </view>
+      </block>
+      <block wx:elif="{{measurePhase === 'measuring'}}">
+        <view class="btn btn--secondary" bindtap="handleCancelMeasure">停止测量</view>
+        <view class="btn btn--text" bindtap="handleBack">完成并查看结果</view>
+      </block>
+      <block wx:elif="{{measurePhase === 'success'}}">
+        <view class="btn btn--primary" style="background: {{selectedColor}}; box-shadow: 0 4px 16px rgba(0,0,0,0.15);" bindtap="handleResetResult">重新测量</view>
+        <view class="btn btn--secondary" bindtap="handleBack">完成并查看结果</view>
+      </block>
+      <block wx:elif="{{measurePhase === 'error'}}">
+        <view class="btn btn--primary" style="background: {{selectedColor}}; box-shadow: 0 4px 16px rgba(0,0,0,0.15);" bindtap="handleStartMeasure">重新测量</view>
+      </block>
+    </view>
+  </view>
+</block>

apps/miniprogram/native/pkg-veepoo/index.wxss

@@ -0,0 +1,619 @@
+/**
+ * Veepoo M2 原生页面样式
+ * 设计原型: docs/design/veepoo-measure-prototype.html
+ * 复刻小程序 design token
+ */
+
+page {
+  --pri: #C4623A;
+  --pri-l: #F0DDD4;
+  --bg: #F5F0EB;
+  --card: #FFFFFF;
+  --tx: #2D2A26;
+  --tx2: #5A554F;
+  --tx3: #78716C;
+  --bd: #E8E2DC;
+  --acc: #5B7A5E;
+  --acc-l: #E8F0E8;
+  --dan: #B54A4A;
+  --dan-l: #FDEAEA;
+  background: var(--bg);
+  min-height: 100vh;
+}
+
+/* ═══════════════════════════════════════
+   连接页面（未连接/连接中/错误）
+   ═══════════════════════════════════════ */
+.connect-screen {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  min-height: 100vh;
+  padding: 0 40px;
+}
+
+.connect-anim {
+  position: relative;
+  width: 120px;
+  height: 120px;
+  margin-bottom: 28px;
+}
+
+.connect-ring {
+  position: absolute;
+  inset: 0;
+  border-radius: 50%;
+  border: 3px solid var(--pri);
+  animation: pulse-ring 2s ease-out infinite;
+}
+
+.connect-ring--active {
+  border-color: var(--pri);
+  animation: pulse-ring 1.5s ease-out infinite;
+}
+
+.connect-center {
+  position: absolute;
+  inset: 20px;
+  border-radius: 50%;
+  background: var(--pri);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.connect-bt {
+  color: #fff;
+  font-size: 20px;
+  font-weight: 700;
+}
+
+.connect-title {
+  font-family: Georgia, 'Times New Roman', serif;
+  font-size: 22px;
+  font-weight: 700;
+  color: var(--tx);
+  margin-bottom: 8px;
+  line-height: 1.3;
+}
+
+.connect-hint {
+  font-size: 14px;
+  color: var(--tx3);
+  margin-bottom: 32px;
+  text-align: center;
+}
+
+.connect-error {
+  margin-bottom: 16px;
+  text-align: center;
+}
+
+.connect-error-text {
+  font-size: 14px;
+  color: var(--dan);
+}
+
+.connect-btn-wrap {
+  width: 200px;
+}
+
+.connect-back {
+  margin-top: 16px;
+}
+
+@keyframes pulse-ring {
+  0% { transform: scale(1); opacity: 1; }
+  100% { transform: scale(1.4); opacity: 0; }
+}
+
+/* ═══════════════════════════════════════
+   测量页面（就绪态）
+   ═══════════════════════════════════════ */
+
+/* ═══ 自动测量进度 ═══ */
+.auto-measure {
+  padding: 24px 20px 40px;
+}
+
+.auto-measure__header {
+  text-align: center;
+  margin-bottom: 28px;
+}
+
+.auto-measure__title {
+  display: block;
+  font-family: Georgia, 'Times New Roman', serif;
+  font-size: 24px;
+  font-weight: 700;
+  color: var(--tx);
+  margin-bottom: 8px;
+}
+
+.auto-measure__subtitle {
+  display: block;
+  font-size: 14px;
+  color: var(--tx3);
+}
+
+.auto-measure__list {
+  background: var(--card);
+  border-radius: 16px;
+  box-shadow: 0 2px 12px rgba(45,42,38,0.06);
+  overflow: hidden;
+}
+
+.auto-item {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 16px 20px;
+  border-bottom: 1px solid var(--bd);
+  transition: background 200ms ease;
+}
+
+.auto-item:last-child {
+  border-bottom: none;
+}
+
+.auto-item--active {
+  background: rgba(196,98,58,0.04);
+}
+
+.auto-item--done {
+  background: rgba(91,122,94,0.04);
+}
+
+.auto-item--error {
+  opacity: 0.6;
+}
+
+.auto-item__left {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+}
+
+.auto-item__icon-wrap {
+  width: 40px;
+  height: 40px;
+  border-radius: 12px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.auto-item--done .auto-item__icon-wrap {
+  background: var(--acc) !important;
+}
+
+.auto-item--error .auto-item__icon-wrap {
+  background: var(--tx3) !important;
+}
+
+.auto-item__icon {
+  font-size: 18px;
+  color: #fff;
+  font-weight: 700;
+}
+
+.auto-item__label {
+  font-size: 16px;
+  font-weight: 600;
+  color: var(--tx);
+}
+
+.auto-item__right {
+  display: flex;
+  align-items: baseline;
+  gap: 4px;
+}
+
+.auto-item__value {
+  font-family: Georgia, 'Times New Roman', serif;
+  font-size: 22px;
+  font-weight: 700;
+}
+
+.auto-item__unit {
+  font-size: 13px;
+  color: var(--tx3);
+}
+
+.auto-item__status {
+  font-size: 14px;
+  color: var(--tx3);
+}
+
+.auto-item__status--active {
+  color: var(--pri);
+  font-weight: 600;
+}
+
+.auto-item__status--error {
+  color: var(--tx3);
+}
+
+/* ── 自动测量进度条 ── */
+.auto-progress {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  margin-top: 24px;
+  padding: 0 4px;
+}
+
+.auto-progress__bar {
+  flex: 1;
+  height: 6px;
+  background: var(--bd);
+  border-radius: 3px;
+  overflow: hidden;
+}
+
+.auto-progress__fill {
+  height: 100%;
+  background: var(--pri);
+  border-radius: 3px;
+  transition: width 0.5s ease-out;
+}
+
+.auto-progress__text {
+  font-size: 14px;
+  font-weight: 600;
+  color: var(--pri);
+  min-width: 36px;
+  text-align: right;
+}
+.measure-page {
+  min-height: 100vh;
+  padding-bottom: 40px;
+}
+
+/* ── 设备状态栏 ── */
+.device-bar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 10px 20px;
+  background: var(--card);
+  border-bottom: 1px solid var(--bd);
+}
+
+.device-bar__left {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.device-bar__dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--acc);
+}
+
+.device-bar__name {
+  font-size: 16px;
+  font-weight: 600;
+  color: var(--tx);
+}
+
+.device-bar__battery {
+  font-size: 13px;
+  color: var(--tx3);
+  margin-left: 4px;
+}
+
+.device-bar__disconnect {
+  font-size: 13px;
+  color: var(--tx3);
+  padding: 6px 12px;
+  background: transparent;
+  border: 1px solid var(--bd);
+  border-radius: 999px;
+}
+
+/* ── 指标选择器（药丸式） ── */
+.selector {
+  display: flex;
+  white-space: nowrap;
+  padding: 16px 20px;
+  gap: 8px;
+}
+
+.selector__pill {
+  flex-shrink: 0;
+  display: inline-flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+  padding: 10px 14px;
+  border-radius: 16px;
+  position: relative;
+  min-width: 64px;
+  transition: all 200ms ease;
+}
+
+.selector__pill--active {
+  background: var(--card);
+  box-shadow: 0 2px 12px rgba(45,42,38,0.10);
+}
+
+.selector__pill--done::after {
+  content: '✓';
+  position: absolute;
+  top: 4px;
+  right: 6px;
+  font-size: 10px;
+  color: #fff;
+  background: var(--acc);
+  width: 16px;
+  height: 16px;
+  border-radius: 50%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.selector__icon-wrap {
+  width: 36px;
+  height: 36px;
+  border-radius: 12px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition: transform 200ms ease;
+}
+
+.selector__pill--active .selector__icon-wrap {
+  transform: scale(1.15);
+}
+
+.selector__icon {
+  font-size: 18px;
+  color: #fff;
+}
+
+.selector__label {
+  font-size: 13px;
+  color: var(--tx3);
+}
+
+.selector__pill--active .selector__label {
+  color: var(--tx);
+  font-weight: 600;
+}
+
+/* ── 仪表盘 ── */
+.gauge-section {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  padding: 16px 0 24px;
+}
+
+.gauge {
+  position: relative;
+}
+
+.gauge--measuring {
+  animation: gauge-breathe 2s ease-in-out infinite;
+}
+
+@keyframes gauge-breathe {
+  0%, 100% { transform: scale(1); }
+  50% { transform: scale(1.03); }
+}
+
+.gauge__ring-wrap {
+  position: relative;
+  width: 220px;
+  height: 220px;
+}
+
+.gauge__ring-bg {
+  position: absolute;
+  inset: 0;
+  border-radius: 50%;
+  border: 10px solid var(--bd);
+  box-sizing: border-box;
+}
+
+.gauge__ring-progress {
+  position: absolute;
+  inset: 0;
+  border-radius: 50%;
+}
+
+.gauge__center {
+  position: absolute;
+  inset: 20px;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  background: var(--bg);
+  border-radius: 50%;
+}
+
+.gauge__icon-lg {
+  font-size: 40px;
+  margin-bottom: 8px;
+}
+
+.gauge__hint {
+  font-size: 13px;
+  color: var(--tx3);
+  text-align: center;
+}
+
+.gauge__value {
+  font-family: Georgia, 'Times New Roman', serif;
+  font-size: 52px;
+  font-weight: 700;
+  line-height: 1;
+}
+
+.gauge__unit {
+  font-size: 14px;
+  color: var(--tx3);
+  margin-top: 4px;
+}
+
+.gauge__loading {
+  font-size: 16px;
+  color: var(--tx2);
+}
+
+.gauge__err {
+  font-size: 36px;
+  color: var(--dan);
+  font-weight: 700;
+}
+
+.gauge__err-text {
+  font-size: 13px;
+  color: var(--tx2);
+  text-align: center;
+}
+
+/* ── 进度条 ── */
+.progress-bar {
+  width: 240px;
+  height: 4px;
+  background: var(--bd);
+  border-radius: 2px;
+  margin-top: 16px;
+  overflow: hidden;
+}
+
+.progress-bar__fill {
+  height: 100%;
+  border-radius: 2px;
+  transition: width 0.3s ease-out;
+}
+
+/* ── 免责声明 ── */
+.disclaimer {
+  text-align: center;
+  padding: 0 20px;
+  margin-bottom: 16px;
+}
+
+.disclaimer__text {
+  font-size: 11px;
+  color: var(--tx3);
+  line-height: 1.5;
+}
+
+/* ── 操作按钮 ── */
+.actions {
+  padding: 0 20px;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.btn {
+  height: 52px;
+  border-radius: 16px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 18px;
+  font-weight: 600;
+  text-align: center;
+  transition: opacity 150ms;
+}
+
+.btn:active {
+  opacity: 0.85;
+}
+
+.btn--primary {
+  background: var(--pri);
+  color: #fff;
+  box-shadow: 0 4px 16px rgba(196,98,58,0.3);
+}
+
+.btn--secondary {
+  background: var(--card);
+  color: var(--tx);
+  border: 1px solid var(--bd);
+}
+
+.btn--text {
+  background: transparent;
+  color: var(--tx3);
+  height: 44px;
+  font-size: 14px;
+}
+
+/* ═══ 旧版兼容样式 ═══ */
+.btn-primary {
+  background: var(--pri);
+  color: #fff;
+  height: 52px;
+  border-radius: 16px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 18px;
+  font-weight: 600;
+  box-shadow: 0 4px 16px rgba(196,98,58,0.3);
+}
+.btn-primary:active { opacity: 0.85; }
+
+.btn-secondary {
+  background: var(--card);
+  color: var(--tx);
+  height: 52px;
+  border-radius: 16px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 18px;
+  font-weight: 600;
+  border: 1px solid var(--bd);
+}
+.btn-secondary:active { opacity: 0.85; }
+
+.btn-text {
+  background: transparent;
+  color: var(--tx3);
+  height: 44px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 14px;
+}
+
+.btn-large { margin: 0; }
+
+/* 旧版 header/selector/gauge 兼容 */
+.header { display: none; }
+.header-device { display: none; }
+.header-dot { display: none; }
+.header-name { display: none; }
+.header-battery { display: none; }
+.header-disconnect { display: none; }
+.selector-item { display: none; }
+.selector-icon { display: none; }
+.selector-label { display: none; }
+.selector-check { display: none; }
+.gauge-circle { display: none; }
+.gauge-icon { display: none; }
+.gauge-hint { display: none; }
+.gauge-value { display: none; }
+.gauge-loading { display: none; }
+.gauge-err { display: none; }
+.gauge-err-text { display: none; }
+.gauge-progress-bar { display: none; }
+.gauge-progress-fill { display: none; }
+.assessment { display: none; }
+.assessment-text { display: none; }
+.disclaimer-text { display: none; }
+.measure-error { display: none; }
+.measure-error-text { display: none; }

apps/miniprogram/package.json

@@ -34,6 +34,7 @@
     "@tarojs/runtime": "4.2.0",
     "@tarojs/shared": "4.2.0",
     "@tarojs/taro": "4.2.0",
+    "mp-html": "^2.5.2",
     "react": "^18.3.0",
     "react-dom": "18.3.1",
     "zustand": "^5.0.0"

apps/miniprogram/pnpm-lock.yaml

@@ -38,6 +38,9 @@ importers:
       '@tarojs/taro':
         specifier: 4.2.0
         version: 4.2.0(@tarojs/components@4.2.0(@tarojs/helper@4.2.0)(@types/react@18.3.28)(html-webpack-plugin@5.6.7(webpack@5.95.0(@swc/core@1.3.96)(esbuild@0.27.7)))(postcss@8.5.12)(rollup@3.30.0)(webpack-chain@6.5.1)(webpack-dev-server@4.15.2(webpack@5.95.0(@swc/core@1.3.96)(esbuild@0.27.7)))(webpack@5.95.0(@swc/core@1.3.96)(esbuild@0.27.7)))(@tarojs/helper@4.2.0)(@tarojs/shared@4.2.0)(@types/react@18.3.28)(html-webpack-plugin@5.6.7(webpack@5.95.0(@swc/core@1.3.96)(esbuild@0.27.7)))(postcss@8.5.12)(rollup@3.30.0)(webpack-chain@6.5.1)(webpack-dev-server@4.15.2(webpack@5.95.0(@swc/core@1.3.96)(esbuild@0.27.7)))(webpack@5.95.0(@swc/core@1.3.96)(esbuild@0.27.7))
+      mp-html:
+        specifier: ^2.5.2
+        version: 2.5.2
       react:
         specifier: ^18.3.0
         version: 18.3.1
@@ -4435,6 +4438,9 @@ packages:
   mobile-detect@1.4.5:
     resolution: {integrity: sha512-yc0LhH6tItlvfLBugVUEtgawwFU2sIe+cSdmRJJCTMZ5GEJyLxNyC/NIOAOGk67Fa8GNpOttO3Xz/1bHpXFD/g==}
 
+  mp-html@2.5.2:
+    resolution: {integrity: sha512-45e8c32Qgux4YU4iC3qCSFsOh3y+RwPwZ+iz/vvLkDgSGWk+1zsL4WUzWWQc9w3AsAfkaD/QR0oIufIDngBmXA==}
+
   ms@2.0.0:
     resolution: {integrity: sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==}
 
@@ -11011,6 +11017,8 @@ snapshots:
 
   mobile-detect@1.4.5: {}
 
+  mp-html@2.5.2: {}
+
   ms@2.0.0: {}
 
   ms@2.1.3: {}

apps/miniprogram/project.config.json

@@ -14,7 +14,8 @@
     "minifyWXML": true,
     "packNpmManually": false,
     "packNpmRelationList": [],
-    "ignoreUploadUnusedFiles": true
+    "ignoreUploadUnusedFiles": true,
+    "skylineRenderEnable": false
   },
   "condition": {}
 }

apps/miniprogram/src/app.config.ts

@@ -1,4 +1,5 @@
 export default defineAppConfig({
+  ...(process.env.NODE_ENV === 'production' ? { lazyCodeLoading: 'requiredComponents' as const } : {}),
   pages: [
     'pages/index/index',
     'pages/login/index',

apps/miniprogram/src/app.tsx

@@ -1,4 +1,5 @@
 import './utils/crypto-polyfill';
+import './utils/abort-controller-polyfill';
 import { useEffect, useRef, PropsWithChildren } from 'react';
 import { useDidShow, useDidHide } from '@tarojs/taro';
 import ErrorBoundary from './components/ErrorBoundary';

apps/miniprogram/src/components/RichArticle/index.tsx

@@ -0,0 +1,54 @@
+import { memo, useMemo } from 'react';
+import { View } from '@tarojs/components';
+import { sanitizeHtml } from '@/utils/sanitize-html';
+
+interface RichArticleProps {
+  html: string;
+  className?: string;
+}
+
+const TAG_STYLE = JSON.stringify({
+  h1: 'font-size:20px;font-weight:700;color:#2D2A26;margin:16px 0 8px',
+  h2: 'font-size:18px;font-weight:700;color:#2D2A26;margin:16px 0 8px',
+  h3: 'font-size:16px;font-weight:700;color:#2D2A26;margin:16px 0 8px',
+  h4: 'font-size:15px;font-weight:600;color:#2D2A26;margin:12px 0 6px',
+  p: 'font-size:16px;color:#2D2A26;line-height:1.85;margin-bottom:12px',
+  ul: 'padding-left:20px;margin:8px 0;font-size:16px;line-height:1.9;color:#2D2A26',
+  ol: 'padding-left:20px;margin:8px 0;font-size:16px;line-height:1.9;color:#2D2A26',
+  li: 'margin-bottom:4px',
+  blockquote: 'border-left:3px solid #C4623A;padding:6px 12px;color:#5A554F;margin:12px 0',
+  strong: 'font-weight:700;color:#2D2A26',
+  em: 'font-style:italic',
+  code: 'background:#F5F0EB;padding:2px 6px;border-radius:4px;font-size:14px;color:#C4623A',
+  pre: 'background:#F5F0EB;padding:12px;border-radius:8px;margin:14px 0;overflow-x:auto',
+  table: 'width:100%;border-collapse:collapse;margin:8px 0;font-size:14px',
+  th: 'border:1px solid #E8E2DC;padding:6px 8px;background:#FAF8F5;font-weight:600;text-align:left',
+  td: 'border:1px solid #E8E2DC;padding:6px 8px',
+  hr: 'border:none;border-top:1px dashed #D1D5DB;margin:14px 0',
+  img: 'max-width:100%;border-radius:8px;margin:8px 0;display:block',
+  a: 'color:#C4623A;text-decoration:none',
+});
+
+function prepareHtml(raw: string): string {
+  return sanitizeHtml(raw);
+}
+
+function RichArticle({ html, className }: RichArticleProps) {
+  const content = useMemo(() => prepareHtml(html), [html]);
+
+  if (!content) return null;
+
+  return (
+    <View className={className}>
+      <mp-html
+        content={content}
+        lazy-load
+        selectable
+        container-style="font-size:16px;color:#5A554F;line-height:1.8;word-break:break-word"
+        tag-style={TAG_STYLE}
+      />
+    </View>
+  );
+}
+
+export default memo(RichArticle);

apps/miniprogram/src/components/SegmentTabs/index.tsx

@@ -3,12 +3,12 @@ import { View, Text } from '@tarojs/components';
 import './index.scss';
 
 interface Tab {
-  key: string;
-  label: string;
+  readonly key: string;
+  readonly label: string;
 }
 
 interface SegmentTabsProps {
-  tabs: Tab[];
+  tabs: readonly Tab[];
   activeKey: string;
   onChange: (key: string) => void;
   variant?: 'underline' | 'pill';

apps/miniprogram/src/components/ui/DoctorTabBar/index.tsx

@@ -27,7 +27,9 @@ export default function DoctorTabBar({ active }: DoctorTabBarProps) {
 
   const handleTab = (tab: TabItem) => {
     if (tab.key === activeKey) return;
-    Taro.reLaunch({ url: tab.url });
+    Taro.reLaunch({ url: tab.url }).catch(() => {
+      Taro.redirectTo({ url: tab.url }).catch(() => {});
+    });
   };
 
   return (

apps/miniprogram/src/hooks/useAlertPolling.ts

@@ -79,8 +79,14 @@ export function useAlertPolling() {
       s.lastAlertCount = count;
 
       failCount = 0;
-    } catch {
-      failCount++;
+    } catch (err) {
+      // 权限不足时立即停止轮询，不再重试（避免反复弹 toast）
+      if (err instanceof Error && err.message === '权限不足') {
+        s.failCount = MAX_FAILURES;
+        return;
+      }
+      // 网络异常时快速累积失败计数（离线抑制下会在 3s 内快速耗尽重试）
+      failCount += 3;
     }
 
     if (gen !== s.generation) return;

apps/miniprogram/src/native-components/mp-html/index.js

@@ -0,0 +1,8 @@
+"use strict";function e(t){"@babel/helpers - typeof";return(e="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e})(t)}function t(e,t,o){return(t=n(t))in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e}function n(t){var n=o(t,"string");return"symbol"==e(n)?n:n+""}function o(t,n){if("object"!=e(t)||!t)return t;var o=t[Symbol.toPrimitive];if(void 0!==o){var i=o.call(t,n||"default");if("object"!=e(i))return i;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===n?String:Number)(t)}/*!
+ * mp-html v2.5.2
+ * https://github.com/jin-yufeng/mp-html
+ *
+ * Released under the MIT license
+ * Author: Jin Yufeng
+ */
+var i=require("./parser"),r=[];Component({data:{nodes:[]},properties:{containerStyle:String,content:{type:String,value:"",observer:function(e){this.setContent(e)}},copyLink:{type:Boolean,value:!0},domain:String,errorImg:String,lazyLoad:Boolean,loadingImg:String,pauseVideo:{type:Boolean,value:!0},previewImg:{type:null,value:!0},scrollTable:Boolean,selectable:null,setTitle:{type:Boolean,value:!0},showImgMenu:{type:Boolean,value:!0},tagStyle:Object,useAnchor:null},created:function(){this.plugins=[];for(var e=r.length;e--;)this.plugins.push(new r[e](this))},detached:function(){this._hook("onDetached")},methods:{in:function(e,t,n){e&&t&&n&&(this._in={page:e,selector:t,scrollTop:n})},navigateTo:function(e,n){var o=this;return new Promise(function(i,r){if(!o.data.useAnchor)return void r(Error("Anchor is disabled"));var a=wx.createSelectorQuery().in(o._in?o._in.page:o).select((o._in?o._in.selector:"._root")+(e?"".concat(">>>","#").concat(e):"")).boundingClientRect();o._in?a.select(o._in.selector).scrollOffset().select(o._in.selector).boundingClientRect():a.selectViewport().scrollOffset(),a.exec(function(e){if(!e[0])return void r(Error("Label not found"));var a=e[1].scrollTop+e[0].top-(e[2]?e[2].top:0)+(n||parseInt(o.data.useAnchor)||0);o._in?o._in.page.setData(t({},o._in.scrollTop,a)):wx.pageScrollTo({scrollTop:a,duration:300}),i()})})},getText:function(e){var t="";return function e(n){for(var o=0;o<n.length;o++){var i=n[o];if("text"===i.type)t+=i.text.replace(/&amp;/g,"&");else if("br"===i.name)t+="\n";else{var r="p"===i.name||"div"===i.name||"tr"===i.name||"li"===i.name||"h"===i.name[0]&&i.name[1]>"0"&&i.name[1]<"7";r&&t&&"\n"!==t[t.length-1]&&(t+="\n"),i.children&&e(i.children),r&&"\n"!==t[t.length-1]?t+="\n":"td"!==i.name&&"th"!==i.name||(t+="\t")}}}(e||this.data.nodes),t},getRect:function(){var e=this;return new Promise(function(t,n){wx.createSelectorQuery().in(e).select("._root").boundingClientRect().exec(function(e){return e[0]?t(e[0]):n(Error("Root label not found"))})})},pauseMedia:function(){for(var e=(this._videos||[]).length;e--;)this._videos[e].pause()},setPlaybackRate:function(e){this.playbackRate=e;for(var t=(this._videos||[]).length;t--;)this._videos[t].playbackRate(e)},setContent:function(e,t){var n=this;this.imgList&&t||(this.imgList=[]),this._videos=[];var o={},r=new i(this).parse(e);if(t)for(var a=this.data.nodes.length,s=r.length;s--;)o["nodes[".concat(a+s,"]")]=r[s];else o.nodes=r;if(this.setData(o,function(){n._hook("onLoad"),n.triggerEvent("load")}),this.data.lazyLoad||this.imgList._unloadimgs<this.imgList.length/2){var l=0,c=function(e){e&&e.height||(e={}),e.height===l?n.triggerEvent("ready",e):(l=e.height,setTimeout(function(){n.getRect().then(c).catch(c)},350))};this.getRect().then(c).catch(c)}else this.imgList._unloadimgs||this.getRect().then(function(e){n.triggerEvent("ready",e)}).catch(function(){n.triggerEvent("ready",{})})},_hook:function(e){for(var t=r.length;t--;)this.plugins[t][e]&&this.plugins[t][e]()},_add:function(e){e.detail.root=this}}});

apps/miniprogram/src/native-components/mp-html/index.json

@@ -0,0 +1 @@
+{"component":true,"usingComponents":{"node":"./node/node"}}

apps/miniprogram/src/native-components/mp-html/index.wxml

@@ -0,0 +1 @@
+<view class="_root {{selectable?'_select':''}}" style="{{containerStyle}}"><slot wx:if="{{!nodes[0]}}"/><node id="_root" childs="{{nodes}}" opts="{{[lazyLoad,loadingImg,errorImg,showImgMenu,selectable]}}" catchadd="_add"/></view>

apps/miniprogram/src/native-components/mp-html/index.wxss

@@ -0,0 +1 @@
+._root{padding:1px 0;overflow-x:auto;overflow-y:hidden;-webkit-overflow-scrolling:touch}._select{-webkit-user-select:text;user-select:text}

apps/miniprogram/src/native-components/mp-html/node/node.json

@@ -0,0 +1 @@
+{"component":true,"usingComponents":{"node":"./node"}}

apps/miniprogram/src/native-components/mp-html/node/node.wxml

@@ -0,0 +1 @@
+<wxs module="isInline">var e={abbr:!0,b:!0,big:!0,code:!0,del:!0,em:!0,i:!0,ins:!0,label:!0,q:!0,small:!0,span:!0,strong:!0,sub:!0,sup:!0};module.exports=function(n,i){return e[n]||-1!==(i||"").indexOf("inline")};</wxs><template name="el"><block wx:if="{{n.name==='img'}}"><rich-text wx:if="{{n.t}}" style="display:{{n.t}}" nodes="<img class='_img' style='{{n.attrs.style}}' src='{{n.attrs.src}}'>" data-i="{{i}}" catchtap="imgTap"/><block wx:else><image wx:if="{{(opts[1]&&!ctrl[i])||ctrl[i]<0}}" class="_img" style="{{n.attrs.style}}" src="{{ctrl[i]<0?opts[2]:opts[1]}}" mode="widthFix"/><image id="{{n.attrs.id}}" class="_img {{n.attrs.class}}" style="{{ctrl[i]===-1?'display:none;':''}}width:{{ctrl[i]||1}}px;height:1px;{{n.attrs.style}}" src="{{n.attrs.src}}" mode="{{!n.h?'widthFix':(!n.w?'heightFix':(n.m||'scaleToFill'))}}" lazy-load="{{opts[0]}}" webp="{{n.webp}}" show-menu-by-longpress="{{opts[3]&&!n.attrs.ignore}}" data-i="{{i}}" bindload="imgLoad" binderror="mediaError" catchtap="imgTap" bindlongpress="noop"/></block></block><text wx:elif="{{n.text}}" user-select="{{opts[4]=='force'&&isiOS}}" decode>{{n.text}}</text><text wx:elif="{{n.name==='br'}}">{{'\n'}}</text><view wx:elif="{{n.name==='a'}}" id="{{n.attrs.id}}" class="{{n.attrs.href?'_a ':''}}{{n.attrs.class}}" hover-class="_hover" style="display:inline;{{n.attrs.style}}" data-i="{{i}}" catchtap="linkTap"><node childs="{{n.children}}" opts="{{opts}}" style="display:inherit"/></view><video wx:elif="{{n.name==='video'}}" id="{{n.attrs.id}}" class="{{n.attrs.class}}" style="{{n.attrs.style}}" autoplay="{{n.attrs.autoplay}}" controls="{{n.attrs.controls}}" loop="{{n.attrs.loop}}" muted="{{n.attrs.muted}}" object-fit="{{n.attrs['object-fit']}}" poster="{{n.attrs.poster}}" src="{{n.src[ctrl[i]||0]}}" data-i="{{i}}" bindplay="play" bindpause="mediaEvent" bindfullscreenchange="mediaEvent" binderror="mediaError"/><audio wx:elif="{{n.name==='audio'}}" id="{{n.attrs.id}}" class="{{n.attrs.class}}" style="{{n.attrs.style}}" author="{{n.attrs.author}}" controls="{{n.attrs.controls}}" loop="{{n.attrs.loop}}" name="{{n.attrs.name}}" poster="{{n.attrs.poster}}" src="{{n.src[ctrl[i]||0]}}" data-i="{{i}}" bindplay="play" bindpause="mediaEvent" binderror="mediaError"/><rich-text wx:else id="{{n.attrs.id}}" style="{{n.f}}" user-select="{{opts[4]}}" nodes="{{[n]}}"/></template><block wx:for="{{nodes}}" wx:for-item="n1" wx:for-index="i1" wx:key="i1"><template wx:if="{{!n1.c&&(!n1.children||n1.name==='a'||!isInline(n1.name,n1.attrs.style))}}" is="el" data="{{n:n1,i:''+i1,opts:opts,ctrl:ctrl}}"/><view wx:else id="{{n1.attrs.id}}" class="_{{n1.name}} {{n1.attrs.class}}" style="{{n1.attrs.style}}"><block wx:for="{{n1.children}}" wx:for-item="n2" wx:for-index="i2" wx:key="i2"><template wx:if="{{!n2.c&&(!n2.children||n2.name==='a'||!isInline(n2.name,n2.attrs.style))}}" is="el" data="{{n:n2,i:i1+'_'+i2,opts:opts,ctrl:ctrl}}"/><view wx:else id="{{n2.attrs.id}}" class="_{{n2.name}} {{n2.attrs.class}}" style="{{n2.attrs.style}}"><block wx:for="{{n2.children}}" wx:for-item="n3" wx:for-index="i3" wx:key="i3"><template wx:if="{{!n3.c&&(!n3.children||n3.name==='a'||!isInline(n3.name,n3.attrs.style))}}" is="el" data="{{n:n3,i:i1+'_'+i2+'_'+i3,opts:opts,ctrl:ctrl}}"/><view wx:else id="{{n3.attrs.id}}" class="_{{n3.name}} {{n3.attrs.class}}" style="{{n3.attrs.style}}"><block wx:for="{{n3.children}}" wx:for-item="n4" wx:for-index="i4" wx:key="i4"><template wx:if="{{!n4.c&&(!n4.children||n4.name==='a'||!isInline(n4.name,n4.attrs.style))}}" is="el" data="{{n:n4,i:i1+'_'+i2+'_'+i3+'_'+i4,opts:opts,ctrl:ctrl}}"/><view wx:else id="{{n4.attrs.id}}" class="_{{n4.name}} {{n4.attrs.class}}" style="{{n4.attrs.style}}"><block wx:for="{{n4.children}}" wx:for-item="n5" wx:for-index="i5" wx:key="i5"><template wx:if="{{!n5.c&&(!n5.children||n5.name==='a'||!isInline(n5.name,n5.attrs.style))}}" is="el" data="{{n:n5,i:i1+'_'+i2+'_'+i3+'_'+i4+'_'+i5,opts:opts,ctrl:ctrl}}"/><node wx:else id="{{n5.attrs.id}}" class="_{{n5.name}} {{n5.attrs.class}}" style="{{n5.attrs.style}}" childs="{{n5.children}}" opts="{{opts}}"/></block></view></block></view></block></view></block></view></block>

apps/miniprogram/src/native-components/mp-html/node/node.wxss

@@ -0,0 +1 @@
+._a{padding:1.5px 0 1.5px 0;color:#366092;word-break:break-all}._hover{text-decoration:underline;opacity:.7}._img{max-width:100%;-webkit-touch-callout:none}._b,._strong{font-weight:700}._code{font-family:monospace}._del{text-decoration:line-through}._em,._i{font-style:italic}._h1{font-size:2em}._h2{font-size:1.5em}._h3{font-size:1.17em}._h5{font-size:.83em}._h6{font-size:.67em}._h1,._h2,._h3,._h4,._h5,._h6{display:block;font-weight:700}._ins{text-decoration:underline}._li{display:list-item}._ol{list-style-type:decimal}._ol,._ul{display:block;padding-left:40px;margin:1em 0}._q::before{content:'"'}._q::after{content:'"'}._sub{font-size:smaller;vertical-align:sub}._sup{font-size:smaller;vertical-align:super}._tbody,._tfoot,._thead{display:table-row-group}._tr{display:table-row}._td,._th{display:table-cell;vertical-align:middle}._th{font-weight:700;text-align:center}._ul{list-style-type:disc}._ul ._ul{margin:0;list-style-type:circle}._ul ._ul ._ul{list-style-type:square}._abbr,._b,._code,._del,._em,._i,._ins,._label,._q,._span,._strong,._sub,._sup{display:inline}._blockquote,._div,._p{display:block}

apps/miniprogram/src/pages/article/detail/index.config.ts

@@ -0,0 +1,6 @@
+export default definePageConfig({
+  navigationBarTitleText: '文章详情',
+  usingComponents: {
+    'mp-html': '../../../native-components/mp-html/index',
+  },
+});

apps/miniprogram/src/pages/article/detail/index.scss

@@ -1,19 +1,21 @@
 @import '../../../styles/variables.scss';
 
-// 文章详情页 — 对齐原型 docs/design/mp-04-article-report.html → ArticleDetail
+// 文章详情页 — 阅读优化排版
 
 .article-detail-page {
-  padding-bottom: 80px;
+  padding-bottom: 100px;
+  background: $card;
 }
 
 .article-title {
   font-family: Georgia, 'Times New Roman', serif;
-  font-size: var(--tk-font-h2);
+  font-size: var(--tk-font-h1);
   font-weight: 700;
   color: $tx;
   display: block;
-  line-height: 1.4;
-  margin-bottom: var(--tk-gap-sm);
+  line-height: 1.35;
+  margin-bottom: var(--tk-gap-md);
+  letter-spacing: 0.5px;
 }
 
 .article-meta {
@@ -21,36 +23,38 @@
   gap: var(--tk-gap-md);
   font-size: var(--tk-font-cap);
   color: $tx3;
-  margin-bottom: var(--tk-gap-md);
+  margin-bottom: var(--tk-gap-lg);
+  align-items: center;
+}
+
+.meta-item {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.meta-icon {
+  font-size: 13px;
+  line-height: 1;
 }
 
 .article-divider {
   height: 1px;
-  background: $bd-l;
+  background: linear-gradient(90deg, $bd-l, $bd, $bd-l);
   margin-bottom: var(--tk-section-gap);
 }
 
 .article-body {
-  font-size: 15px;
+  // RichText 内部样式由 formatArticleHtml 内联注入
+  // 这里只控制容器间距
+  font-size: var(--tk-font-body);
   color: $tx2;
   line-height: 1.8;
 
-  // RichText 内部样式
-  h1, h2, h3 {
-    font-weight: bold;
+  // 兜底：万一内联样式未生效的标签
+  h1, h2, h3, h4, h5, h6 {
     color: $tx;
-    margin: var(--tk-gap-lg) 0 var(--tk-gap-sm);
-  }
-
-  p {
-    margin-bottom: var(--tk-gap-md);
-    text-indent: 2em;
-  }
-
-  img {
-    max-width: 100%;
-    border-radius: $r-sm;
-    margin: var(--tk-gap-sm) 0;
+    line-height: 1.4;
   }
 }
 
@@ -59,31 +63,40 @@
   bottom: 0;
   left: 0;
   right: 0;
-  height: 60px;
+  height: 64px;
   background: $card;
   border-top: 1px solid $bd-l;
   display: flex;
   align-items: center;
   justify-content: center;
-  gap: 32px;
+  gap: 48px;
   padding: 0 var(--tk-page-padding);
   z-index: 10;
+  // 安全区适配
+  padding-bottom: env(safe-area-inset-bottom);
+  box-shadow: 0 -2px 12px rgba(45, 42, 38, 0.06);
 }
 
 .article-action-btn {
   display: flex;
   flex-direction: column;
   align-items: center;
-  gap: 2px;
+  gap: 4px;
+  min-width: $touch-min;
+  min-height: $touch-min;
+  justify-content: center;
+  border-radius: $r-sm;
+  transition: background var(--tk-duration-fast);
 
   &:active {
+    background: $surface-alt;
     opacity: var(--tk-touch-feedback-opacity);
   }
 }
 
 .article-action-icon {
-  font-size: 20px;
-  color: $tx3;
+  font-size: 22px;
+  color: $tx2;
   line-height: 1;
 }
 
@@ -105,3 +118,29 @@
   font-size: var(--tk-font-body);
   color: $tx3;
 }
+
+// ─── 关怀模式覆盖 ───
+.elder-mode {
+  .article-title {
+    font-size: var(--tk-font-h1);
+    line-height: 1.3;
+  }
+
+  .article-body {
+    font-size: var(--tk-font-body);
+    line-height: 2;
+  }
+
+  .article-bottom-bar {
+    height: 72px;
+    gap: 56px;
+  }
+
+  .article-action-icon {
+    font-size: 26px;
+  }
+
+  .article-action-text {
+    font-size: var(--tk-font-body-sm);
+  }
+}

apps/miniprogram/src/pages/article/detail/index.tsx

@@ -1,13 +1,13 @@
 import { useState, useCallback } from 'react';
-import { View, Text, RichText } from '@tarojs/components';
+import { View, Text } from '@tarojs/components';
 import Taro, { useRouter, useShareAppMessage } from '@tarojs/taro';
 import { usePageData } from '@/hooks/usePageData';
 import { getArticleDetail, getPublicArticleDetail, Article } from '../../../services/article';
 import { trackEvent } from '@/services/analytics';
-import { sanitizeHtml } from '@/utils/sanitize-html';
 import { useElderClass } from '../../../hooks/useElderClass';
 import { useAuthStore } from '../../../stores/auth';
 import PageShell from '@/components/ui/PageShell';
+import RichArticle from '@/components/RichArticle';
 import './index.scss';
 
 export default function ArticleDetail() {
@@ -77,14 +77,24 @@ export default function ArticleDetail() {
       <Text className='article-title'>{article.title}</Text>
 
       <View className='article-meta'>
-        {article.author && <Text>{article.author}</Text>}
-        {article.published_at && <Text>{article.published_at.slice(0, 10)}</Text>}
+        {article.author && (
+          <View className='meta-item'>
+            <Text className='meta-icon'>✍</Text>
+            <Text>{article.author}</Text>
+          </View>
+        )}
+        {article.published_at && (
+          <View className='meta-item'>
+            <Text className='meta-icon'>📅</Text>
+            <Text>{article.published_at.slice(0, 10)}</Text>
+          </View>
+        )}
       </View>
 
       <View className='article-divider' />
 
       <View className='article-body'>
-        <RichText nodes={sanitizeHtml(article.content || '')} />
+        <RichArticle html={article.content || ''} />
       </View>
 
       <View className='article-bottom-bar'>

apps/miniprogram/src/pages/article/index.tsx

@@ -3,7 +3,13 @@ import { View, Text, ScrollView } from '@tarojs/components';
 import Taro from '@tarojs/taro';
 import { safeNavigateTo } from '@/utils/navigate';
 import { usePageData } from '@/hooks/usePageData';
-import { listArticles, listCategories } from '../../services/article';
+import { useAuthStore } from '@/stores/auth';
+import {
+  listArticles,
+  listCategories,
+  listPublicArticles,
+  listPublicCategories,
+} from '../../services/article';
 import PageShell from '@/components/ui/PageShell';
 import ContentCard from '@/components/ui/ContentCard';
 import LoadingCard from '@/components/ui/LoadingCard';
@@ -33,6 +39,7 @@ interface ArticleCategory {
 
 export default function ArticleList() {
   const modeClass = useElderClass();
+  const isLoggedIn = !!useAuthStore((s) => s.user);
   const [articles, setArticles] = useState<ArticleItem[]>([]);
   const [, setPage] = useState(1);
   const [, setTotal] = useState(0);
@@ -46,10 +53,9 @@ export default function ArticleList() {
     setError(false);
     try {
       const cid = categoryId !== undefined ? categoryId : activeCategory;
-      const res = await listArticles({
-        page: p,
-        category_id: cid || undefined,
-      });
+      const res = isLoggedIn
+        ? await listArticles({ page: p, category_id: cid || undefined })
+        : await listPublicArticles({ page: p, category_id: cid || undefined });
       const list = res.data || [];
       setArticles(append ? (prev) => [...prev, ...list] : list);
       setTotal(res.total);
@@ -61,19 +67,21 @@ export default function ArticleList() {
     } finally {
       setLoading(false);
     }
-  }, [activeCategory]);
+  }, [activeCategory, isLoggedIn]);
 
   usePageData(
     useCallback(async () => {
       try {
-        const cats = await listCategories();
+        const cats = isLoggedIn
+          ? await listCategories()
+          : await listPublicCategories();
         setCategories(cats || []);
       } catch (err) {
         console.warn('[article] 加载分类失败:', err);
         setCategories([]);
       }
       await fetchData(1);
-    }, [fetchData]),
+    }, [fetchData, isLoggedIn]),
     { throttleMs: 10000, enablePullDown: true },
   );
 

apps/miniprogram/src/pages/health/index.scss

@@ -2,410 +2,131 @@
 @import '../../styles/mixins.scss';
 
 .health-page {
-  padding-bottom: calc(var(--tk-tabbar-space) + env(safe-area-inset-bottom));
-}
-
-/* ─── 页头 ─── */
-.health-header {
-  margin-bottom: var(--tk-section-gap);
-}
-
-.health-title {
-  @include serif-number;
-  font-size: var(--tk-font-h1);
-  font-weight: 700;
-  color: $tx;
-}
-
-/* ─── 今日体征摘要 ─── */
-.vitals-grid {
-  margin-bottom: var(--tk-section-gap);
-}
-
-.vitals-row {
-  display: grid;
-  grid-template-columns: 1fr 1fr;
-  gap: var(--tk-gap-sm);
-}
-
-.vital-cell {
-  text-align: center;
-  padding: var(--tk-gap-sm);
-  border-radius: $r-sm;
-  background: $bg;
-}
-
-.vital-value {
-  @include serif-number;
-  font-size: var(--tk-font-num);
-  font-weight: 700;
-  color: $tx;
-  display: block;
-}
-
-.vital-unit {
-  font-size: var(--tk-font-micro);
-  color: $tx3;
-  display: block;
-  margin-top: 2px;
-}
-
-.vital-label {
-  font-size: var(--tk-font-cap);
-  color: $tx2;
-  display: block;
-  margin-top: 4px;
-}
-
-.vital-cell.vital-warn {
-  background: $wrn-l;
-
-  .vital-value {
-    color: $wrn;
-  }
-}
-
-.vital-cell.vital-ok {
-  .vital-value {
-    color: $acc;
-  }
-}
-
-/* ─── 快捷入口 ─── */
-.quick-entries {
-  display: grid;
-  grid-template-columns: repeat(4, 1fr);
-  gap: var(--tk-gap-sm);
-  margin-bottom: var(--tk-section-gap);
-}
-
-.quick-entry {
   display: flex;
   flex-direction: column;
+  height: 100vh;
+}
+
+/* ─── 分类标签 ─── */
+.health-categories {
+  white-space: nowrap;
+  padding: var(--tk-gap-xs) var(--tk-page-padding);
+  margin-bottom: var(--tk-gap-xs);
+  flex-shrink: 0;
+}
+
+.health-cat-tab {
+  display: inline-flex;
   align-items: center;
-  gap: var(--tk-gap-xs);
-  min-height: var(--tk-touch-min);
   justify-content: center;
-
-  &:active {
-    opacity: var(--tk-touch-feedback-opacity);
-  }
-}
-
-.quick-icon {
-  width: 48px;
-  height: 48px;
-  border-radius: $r;
-  background: var(--tk-pri-l);
-  @include flex-center;
-}
-
-.quick-icon-text {
-  font-size: var(--tk-font-body);
-  font-weight: 600;
-  color: var(--tk-pri);
-}
-
-.quick-label {
-  font-size: var(--tk-font-cap);
-  color: $tx2;
-  font-weight: 500;
-}
-
-/* ─── 告警提示 ─── */
-.alert-hint {
-  display: flex;
-  align-items: center;
-  gap: var(--tk-gap-sm);
-  margin-bottom: var(--tk-section-gap);
-
-  &:active {
-    opacity: var(--tk-touch-feedback-opacity);
-  }
-}
-
-.alert-dot {
-  width: 10px;
-  height: 10px;
-  border-radius: 50%;
-  background: $dan;
-  flex-shrink: 0;
-}
-
-.alert-text {
-  flex: 1;
+  padding: 8px 18px;
+  margin-right: 8px;
   font-size: var(--tk-font-body-sm);
-  font-weight: 500;
-  color: $dan;
-}
-
-.alert-arrow {
-  font-size: var(--tk-font-body);
-  color: $tx3;
-  flex-shrink: 0;
-}
-
-/* ─── 趋势图 ─── */
-.trend-section {
-  margin-bottom: var(--tk-gap-sm);
-}
-
-.section-title {
-  @include section-title;
-}
-
-.trend-empty {
-  text-align: center;
-}
-
-.trend-empty-text {
-  font-size: var(--tk-font-cap);
+  font-weight: 400;
   color: $tx2;
+  background: $surface-alt;
+  border-radius: 20px;
+  transition: all 0.2s;
+
+  &--active {
+    background: var(--tk-pri);
+    color: $white;
+    font-weight: 600;
+    box-shadow: 0 2px 8px rgba(196, 98, 58, 0.2);
+  }
 }
 
-.trend-chart {
-  padding: var(--tk-gap-md);
-}
-
-.trend-bars {
-  display: flex;
-  align-items: flex-end;
-  height: 120px;
-  background: $bg;
-  border-radius: $r-sm;
-  padding: var(--tk-gap-sm) var(--tk-gap-xs);
-  gap: 0;
-  position: relative;
-}
-
-.trend-threshold-line {
-  position: absolute;
-  left: 8px;
-  right: 8px;
-  border-top: 1.5px dashed $wrn;
-  opacity: 0.6;
-  pointer-events: none;
-}
-
-.trend-threshold-label {
-  position: absolute;
-  right: 0;
-  top: -16px;
-  font-size: var(--tk-font-micro);
-  color: $wrn;
-  opacity: 0.8;
-}
-
-.trend-bar-col {
+/* ─── 可滚动内容区 ─── */
+.health-scroll {
   flex: 1;
+  overflow: hidden;
+  /* 微信小程序 ScrollView scrollY 需要显式高度 */
+  height: 0; /* flex:1 + height:0 让 flex 布局正确分配剩余高度 */
+}
+
+/* ─── 文章列表 ─── */
+.health-article-list {
   display: flex;
   flex-direction: column;
-  align-items: center;
-  height: 100%;
-  justify-content: flex-end;
-}
-
-.trend-bar {
-  width: 28px;
-  border-radius: $r-xs $r-xs 0 0;
-  min-height: 8px;
-  opacity: 0.8;
-
-  &.trend-bar-normal {
-    background: var(--tk-pri);
-  }
-
-  &.trend-bar-warn {
-    background: $wrn;
-  }
-}
-
-.trend-bar-label {
-  font-size: var(--tk-font-micro);
-  color: var(--tk-text-secondary);
-  margin-top: var(--tk-gap-2xs);
-}
-
-/* ─── BLE 设备卡片 ─── */
-.device-section {
-  margin-bottom: var(--tk-gap-sm);
-}
-
-.device-card {
-  display: flex;
-  align-items: center;
   gap: var(--tk-gap-sm);
+  padding: 0 var(--tk-page-padding) var(--tk-gap-lg);
 
-  &:active {
-    opacity: var(--tk-touch-feedback-opacity);
+  .content-card {
+    display: flex;
+    gap: 14px;
   }
 }
 
-.device-icon {
-  width: 48px;
-  height: 48px;
-  border-radius: $r-sm;
-  background: var(--tk-pri-l);
-  @include flex-center;
-  flex-shrink: 0;
-}
-
-.device-icon-text {
-  font-size: var(--tk-font-body);
-}
-
-.device-info {
+.health-article-body {
   flex: 1;
+  display: flex;
   min-width: 0;
 }
 
-.device-name {
-  font-size: var(--tk-font-cap);
-  font-weight: 500;
-  color: $tx;
-  display: block;
-}
-
-.device-desc {
-  font-size: var(--tk-font-cap);
-  color: $acc;
-  display: block;
-}
-
-.device-arrow {
-  font-size: var(--tk-font-cap);
-  color: var(--tk-text-secondary);
-  flex-shrink: 0;
-}
-
-/* ─── 健康资讯入口 ─── */
-.article-entry {
-  &:active {
-    opacity: var(--tk-touch-feedback-opacity);
-  }
-}
-
-.article-entry-text {
-  font-size: var(--tk-font-cap);
-  color: $tx;
-  font-weight: 500;
-}
-
-/* ─── AI 建议卡片 ─── */
-.ai-suggestion-card {
-  background: $acc-l;
-  border-radius: $r;
-  padding: var(--tk-gap-md);
-  margin-bottom: var(--tk-section-gap);
-  box-shadow: none;
-  border-left: 4px solid $acc;
-}
-
-.ai-card-header {
+.health-article-content {
+  flex: 1;
   display: flex;
+  flex-direction: column;
   justify-content: space-between;
-  align-items: center;
-  margin-bottom: var(--tk-gap-xs);
+  min-width: 0;
 }
 
-.ai-card-title {
-  font-size: var(--tk-font-cap);
-  font-weight: 600;
-  color: $acc;
+.health-article-title {
+  font-family: Georgia, 'Times New Roman', serif;
+  font-size: var(--tk-font-body);
+  font-weight: 700;
+  color: $tx;
+  line-height: 1.35;
+  margin-bottom: 4px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
 }
 
-.ai-card-count {
-  font-size: var(--tk-font-micro);
-  color: $acc;
-  opacity: 0.7;
-}
-
-.ai-suggestion-item {
-  padding: var(--tk-gap-xs) 0;
-  border-bottom: 1px solid rgba($acc, 0.15);
-
-  &:last-child {
-    border-bottom: none;
-  }
-}
-
-.ai-suggestion-main {
-  display: flex;
-  align-items: center;
-  gap: var(--tk-gap-xs);
-
-  &:active {
-    opacity: var(--tk-touch-feedback-opacity);
-  }
-}
-
-.ai-risk-dot {
-  width: 8px;
-  height: 8px;
-  border-radius: 50%;
-  flex-shrink: 0;
-
-  &.ai-risk-high {
-    background: $dan;
-  }
-
-  &.ai-risk-medium {
-    background: $wrn;
-  }
-
-  &.ai-risk-low {
-    background: $acc;
-  }
-}
-
-.ai-suggestion-text {
+.health-article-summary {
   font-size: var(--tk-font-cap);
   color: $tx2;
-  line-height: 1.6;
+  line-height: 1.4;
+  display: block;
+  margin-bottom: var(--tk-gap-2xs);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 
-/* ─── AI 建议反馈按钮 ─── */
-.ai-feedback-row {
+.health-article-meta {
   display: flex;
-  gap: var(--tk-gap-xs);
-  margin-top: var(--tk-gap-2xs);
-  padding-left: 20px;
-}
-
-.ai-feedback-btn {
-  height: 44px;
-  min-height: 44px;
-  border-radius: $r-xs;
-  @include flex-center;
-  padding: 0 var(--tk-gap-sm);
-
-  &:active {
-    opacity: var(--tk-touch-feedback-opacity);
-  }
-
-  &.ai-feedback-adopt {
-    background: rgba($acc, 0.15);
-  }
-
-  &.ai-feedback-ignore {
-    background: $surface-alt;
-  }
-
-  &.ai-feedback-consult {
-    background: var(--tk-pri-l);
-  }
-}
-
-.ai-feedback-btn-text {
+  gap: var(--tk-gap-sm);
   font-size: var(--tk-font-micro);
-  font-weight: 500;
-  color: $tx2;
+  color: $tx3;
+  align-items: center;
 }
 
-.ai-feedback-adopt .ai-feedback-btn-text {
-  color: $acc;
-}
-
-.ai-feedback-consult .ai-feedback-btn-text {
+.health-article-tag {
+  font-size: var(--tk-font-micro);
   color: var(--tk-pri);
+  background: var(--tk-pri-l);
+  padding: 2px 8px;
+  border-radius: $r-xs;
+}
+
+.health-article-date {
+  font-size: var(--tk-font-micro);
+  color: $tx3;
+}
+
+// 长者模式
+.elder-mode .health-page {
+  .health-cat-tab {
+    padding: 10px 20px;
+    font-size: 15px;
+  }
+  .health-article-title {
+    font-size: 18px;
+  }
+  .health-article-summary {
+    font-size: 15px;
+  }
 }

apps/miniprogram/src/pages/health/index.tsx

@@ -1,226 +1,152 @@
-import { View, Text } from '@tarojs/components';
+import { useState, useCallback } from 'react';
+import { View, Text, ScrollView } from '@tarojs/components';
 import Taro from '@tarojs/taro';
 import { safeNavigateTo } from '@/utils/navigate';
+import { usePageData } from '@/hooks/usePageData';
 import { useAuthStore } from '../../stores/auth';
-import { useElderClass } from '../../hooks/useElderClass';
-import GuestGuard from '../../components/GuestGuard';
-import Loading from '../../components/Loading';
+import {
+  listArticles,
+  listCategories,
+  listPublicArticles,
+  listPublicCategories,
+  type Article,
+  type ArticleCategory,
+} from '../../services/article';
 import PageShell from '@/components/ui/PageShell';
 import ContentCard from '@/components/ui/ContentCard';
-import SegmentTabs from '../../components/SegmentTabs';
-import { useHealthOverview, VITAL_TABS, type VitalType } from './useHealthOverview';
-import { submitSuggestionFeedback } from '../../services/ai-analysis';
+import EmptyState from '../../components/EmptyState';
+import ErrorState from '../../components/ErrorState';
+import Loading from '../../components/Loading';
+import { useElderClass } from '../../hooks/useElderClass';
 import './index.scss';
 
-const QUICK_ENTRIES = [
-  { label: '录入体征', icon: '笔', path: '/pages/pkg-health/input/index' },
-  { label: '健康趋势', icon: '线', path: '/pages/pkg-health/trend/index' },
-  { label: '我的报告', icon: '报', path: '/pages/pkg-profile/reports/index' },
-  { label: '用药记录', icon: '药', path: '/pages/pkg-profile/medication/index' },
-] as const;
-
-function statusClass(status?: string): string {
-  if (!status) return '';
-  if (status === 'high' || status === 'abnormal') return 'vital-warn';
-  if (status === 'low') return 'vital-warn';
-  return 'vital-ok';
-}
-
 export default function Health() {
-  const user = useAuthStore((s) => s.user);
   const modeClass = useElderClass();
-  const {
-    todaySummary, loading, error, activeTab, trendData, trendLoading,
-    aiSuggestions, thresholds, alertCount, handleTabChange, fetchData,
-  } = useHealthOverview();
+  const isLoggedIn = !!useAuthStore((s) => s.user);
+  const [articles, setArticles] = useState<Article[]>([]);
+  const [page, setPage] = useState(1);
+  const [total, setTotal] = useState(0);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(false);
+  const [categories, setCategories] = useState<ArticleCategory[]>([]);
+  const [activeCategory, setActiveCategory] = useState<string | null>(null);
 
-  if (!user) {
-    return <GuestGuard title='请先登录' desc='登录后即可查看健康数据' />;
-  }
-
-  if (error) {
-    return (
-      <PageShell padding="md" safeBottom={false} scroll={false} className={`health-page ${modeClass}`}>
-        <View className='health-header'>
-          <Text className='health-title'>健康总览</Text>
-        </View>
-        <Loading />
-      </PageShell>
-    );
-  }
-
-  const maxTrendValue = trendData.reduce((max, d) => Math.max(max, d.value), 1);
-  const dayLabels = ['日', '一', '二', '三', '四', '五', '六'];
-
-  const summary = todaySummary || {};
-  const vitals = [
-    { label: '血压', value: summary.blood_pressure ? `${summary.blood_pressure.systolic}/${summary.blood_pressure.diastolic}` : '—', unit: 'mmHg', status: summary.blood_pressure?.status },
-    { label: '心率', value: summary.heart_rate ? `${summary.heart_rate.value}` : '—', unit: 'bpm', status: summary.heart_rate?.status },
-    { label: '血糖', value: summary.blood_sugar ? `${summary.blood_sugar.value}` : '—', unit: 'mmol/L', status: summary.blood_sugar?.status },
-    { label: '体重', value: summary.weight ? `${summary.weight.value}` : '—', unit: 'kg', status: summary.weight?.status },
-  ];
-
-  const getThresholdValue = (type: VitalType): number | null => {
-    if (!thresholds.length) return null;
-    const th = thresholds;
-    if (type === 'blood_pressure') {
-      const v = th.find((t) => t.indicator === 'systolic_bp' && t.level === 'high');
-      return v?.threshold_value ?? 140;
+  const fetchData = useCallback(async (p: number, append = false, categoryId?: string | null) => {
+    setLoading(true);
+    setError(false);
+    try {
+      const cid = categoryId !== undefined ? categoryId : activeCategory;
+      const res = isLoggedIn
+        ? await listArticles({ page: p, category_id: cid || undefined })
+        : await listPublicArticles({ page: p, category_id: cid || undefined });
+      const list = res.data || [];
+      setArticles(append ? (prev) => [...prev, ...list] : list);
+      setTotal(res.total);
+      setPage(p);
+    } catch (err) {
+      console.warn('[health] 加载文章列表失败:', err);
+      setError(true);
+      Taro.showToast({ title: '加载失败', icon: 'none' });
+    } finally {
+      setLoading(false);
     }
-    if (type === 'heart_rate') {
-      const v = th.find((t) => t.indicator === 'heart_rate' && t.level === 'high');
-      return v?.threshold_value ?? 100;
+  }, [activeCategory, isLoggedIn]);
+
+  usePageData(
+    useCallback(async () => {
+      try {
+        const cats = isLoggedIn
+          ? await listCategories()
+          : await listPublicCategories();
+        setCategories(cats || []);
+      } catch (err) {
+        console.warn('[health] 加载分类失败:', err);
+        setCategories([]);
+      }
+      await fetchData(1);
+    }, [fetchData, isLoggedIn]),
+    { throttleMs: 10000, enablePullDown: true },
+  );
+
+  const loadMore = useCallback(() => {
+    if (!loading && articles.length < total) {
+      fetchData(page + 1, true);
     }
-    if (type === 'blood_sugar') {
-      const v = th.find((t) => t.indicator === 'blood_sugar_fasting' && t.level === 'high');
-      return v?.threshold_value ?? 6.1;
-    }
-    return null;
+  }, [loading, articles.length, total, page, fetchData]);
+
+  const handleCategoryChange = (categoryId: string | null) => {
+    setActiveCategory(categoryId);
+    fetchData(1, false, categoryId);
+  };
+
+  const formatDate = (dateStr?: string) => {
+    if (!dateStr) return '';
+    const d = new Date(dateStr);
+    const month = d.getMonth() + 1;
+    const day = d.getDate();
+    return `${month}月${day}日`;
   };
 
   return (
-    <PageShell padding="md" safeBottom={false} scroll className={`health-page ${modeClass}`}>
-      <View className='health-header'>
-        <Text className='health-title'>健康总览</Text>
-      </View>
+    <PageShell safeBottom={false} padding="none" scroll={false} className={`health-page ${modeClass}`}>
+      {/* 分类标签 */}
+      {categories.length > 0 && (
+        <ScrollView scrollX className='health-categories'>
+          <View
+            className={`health-cat-tab ${!activeCategory ? 'health-cat-tab--active' : ''}`}
+            onClick={() => handleCategoryChange(null)}
+          >
+            <Text>推荐</Text>
+          </View>
+          {categories.map((cat) => (
+            <View
+              key={cat.id}
+              className={`health-cat-tab ${activeCategory === cat.id ? 'health-cat-tab--active' : ''}`}
+              onClick={() => handleCategoryChange(cat.id)}
+            >
+              <Text>{cat.name}</Text>
+            </View>
+          ))}
+        </ScrollView>
+      )}
 
-      {/* 今日体征摘要 */}
-      <ContentCard variant="elevated" className='vitals-grid'>
-        {loading ? <Loading /> : (
-          <View className='vitals-row'>
-            {vitals.map((v) => (
-              <View className={`vital-cell ${statusClass(v.status)}`} key={v.label}>
-                <Text className='vital-value'>{v.value}</Text>
-                <Text className='vital-unit'>{v.unit}</Text>
-                <Text className='vital-label'>{v.label}</Text>
-              </View>
+      {/* 文章列表 */}
+      <ScrollView scrollY className='health-scroll' onScrollToLower={loadMore} lowerThreshold={200}>
+        {error ? (
+          <ErrorState onRetry={() => fetchData(1, false, null)} />
+        ) : articles.length === 0 && !loading ? (
+          <EmptyState text='暂无健康资讯' />
+        ) : (
+          <View className='health-article-list'>
+            {articles.map((a) => (
+              <ContentCard
+                key={a.id}
+                padding='sm'
+                margin='none'
+                onPress={() => safeNavigateTo(`/pages/article/detail/index?id=${a.id}`)}
+              >
+                <View className='health-article-body'>
+                  <View className='health-article-content'>
+                    <Text className='health-article-title'>{a.title}</Text>
+                    {a.summary && (
+                      <Text className='health-article-summary'>{a.summary}</Text>
+                    )}
+                    <View className='health-article-meta'>
+                      {(a.category_name || a.category) && (
+                        <Text className='health-article-tag'>{a.category_name || a.category}</Text>
+                      )}
+                      {a.published_at && (
+                        <Text className='health-article-date'>{formatDate(a.published_at)}</Text>
+                      )}
+                    </View>
+                  </View>
+                </View>
+              </ContentCard>
             ))}
           </View>
         )}
-      </ContentCard>
-
-      {/* 快捷入口 */}
-      <View className='quick-entries'>
-        {QUICK_ENTRIES.map((e) => (
-          <View
-            key={e.label}
-            className='quick-entry'
-            onClick={() => safeNavigateTo(e.path)}
-          >
-            <View className='quick-icon'>
-              <Text className='quick-icon-text'>{e.icon}</Text>
-            </View>
-            <Text className='quick-label'>{e.label}</Text>
-          </View>
-        ))}
-      </View>
-
-      {/* 告警提示 */}
-      {alertCount > 0 && (
-        <ContentCard
-          variant="elevated"
-          className='alert-hint'
-          onPress={() => safeNavigateTo('/pages/pkg-health/alerts/index')}
-        >
-          <View className='alert-dot' />
-          <Text className='alert-text'>{alertCount} 条待处理告警</Text>
-          <Text className='alert-arrow'>›</Text>
-        </ContentCard>
-      )}
-
-      {/* AI 建议 */}
-      {aiSuggestions.length > 0 && (
-        <View className='ai-suggestion-card'>
-          <View className='ai-card-header'>
-            <Text className='ai-card-title'>AI 健康建议</Text>
-            <Text className='ai-card-count'>{aiSuggestions.length} 条</Text>
-          </View>
-          {aiSuggestions.map((s) => {
-            const riskCls = s.risk_level === 'high' ? 'ai-risk-high' : s.risk_level === 'medium' ? 'ai-risk-medium' : 'ai-risk-low';
-            const params = s.params as Record<string, unknown> | null;
-            const reason = (params?.reason as string) || (params?.message as string) || '健康建议';
-            return (
-              <View key={s.id} className='ai-suggestion-item'>
-                <View className='ai-suggestion-main' onClick={() => {
-                  if (s.suggestion_type === 'appointment') safeNavigateTo('/pages/appointment/create/index');
-                  else if (s.suggestion_type === 'followup') safeNavigateTo('/pages/pkg-profile/followups/index');
-                }}>
-                  <View className={`ai-risk-dot ${riskCls}`} />
-                  <Text className='ai-suggestion-text'>{reason.slice(0, 50)}</Text>
-                </View>
-                <View className='ai-feedback-row'>
-                  <View className='ai-feedback-btn ai-feedback-adopt' onClick={async () => {
-                    try { await submitSuggestionFeedback(s.id, 'adopt'); Taro.showToast({ title: '已采纳', icon: 'success' }); fetchData(); }
-                    catch { Taro.showToast({ title: '操作失败', icon: 'none' }); }
-                  }}>
-                    <Text className='ai-feedback-btn-text'>采纳</Text>
-                  </View>
-                  <View className='ai-feedback-btn ai-feedback-ignore' onClick={async () => {
-                    try { await submitSuggestionFeedback(s.id, 'ignore'); Taro.showToast({ title: '已忽略', icon: 'success' }); fetchData(); }
-                    catch { Taro.showToast({ title: '操作失败', icon: 'none' }); }
-                  }}>
-                    <Text className='ai-feedback-btn-text'>忽略</Text>
-                  </View>
-                  <View className='ai-feedback-btn ai-feedback-consult' onClick={async () => {
-                    try { await submitSuggestionFeedback(s.id, 'consult'); safeNavigateTo('/pages/consultation/index'); }
-                    catch { Taro.showToast({ title: '操作失败', icon: 'none' }); }
-                  }}>
-                    <Text className='ai-feedback-btn-text'>咨询医生</Text>
-                  </View>
-                </View>
-              </View>
-            );
-          })}
-        </View>
-      )}
-
-      {/* 7天趋势 */}
-      <View className='trend-section'>
-        <Text className='section-title'>近 7 天趋势</Text>
-        <SegmentTabs tabs={VITAL_TABS} activeKey={activeTab} onChange={handleTabChange} variant="pill" />
-        {trendLoading ? <Loading /> : trendData.length === 0 ? (
-          <ContentCard padding="md">
-            <Text className='trend-empty-text'>暂无趋势数据</Text>
-          </ContentCard>
-        ) : (
-          <ContentCard padding="md">
-            <View className='trend-bars'>
-              {(() => {
-                const tv = getThresholdValue(activeTab);
-                if (tv) {
-                  const pct = Math.min(95, (tv / maxTrendValue) * 100);
-                  return (
-                    <View className='trend-threshold-line' style={`bottom:${((12 + pct * 1.08) / 120 * 100).toFixed(1)}%;`}>
-                      <Text className='trend-threshold-label'>{tv}</Text>
-                    </View>
-                  );
-                }
-                return null;
-              })()}
-              {trendData.map((point, i) => {
-                const heightPct = Math.max(8, (point.value / maxTrendValue) * 100);
-                const tv = getThresholdValue(activeTab);
-                const isAbnormal = tv ? point.value >= tv : false;
-                const dayOfWeek = new Date(point.date).getDay();
-                return (
-                  <View className='trend-bar-col' key={i}>
-                    <View
-                      className={`trend-bar ${isAbnormal ? 'trend-bar-warn' : 'trend-bar-normal'}`}
-                      style={`height:${heightPct}%;`}
-                    />
-                    <Text className='trend-bar-label'>{dayLabels[dayOfWeek]}</Text>
-                  </View>
-                );
-              })}
-            </View>
-          </ContentCard>
-        )}
-      </View>
-
-      {/* 健康资讯入口 */}
-      <ContentCard onPress={() => safeNavigateTo('/pages/article/index')}>
-        <Text className='article-entry-text'>最新健康资讯 ›</Text>
-      </ContentCard>
+        {loading && <Loading />}
+      </ScrollView>
     </PageShell>
   );
 }

apps/miniprogram/src/pages/index/index.tsx

@@ -105,8 +105,8 @@ function GuestHome({ modeClass }: { modeClass: string }) {
         indicatorActiveColor='#FFFFFF'
         autoplay={swiperAutoplay}
         circular
-        interval={4000}
-        duration={500}
+        interval={5000}
+        duration={300}
       >
         {slides.map((slide, idx) => (
           <SwiperItem key={slide.id || idx}>
@@ -370,7 +370,8 @@ export default function Index() {
         url: target,
         fail: () => {
           redirectingRef.current = false;
-          console.warn('跳转医生端失败，停留患者首页');
+          console.warn('跳转医生端失败，降级为 redirectTo');
+          Taro.redirectTo({ url: target }).catch(() => {});
         },
       });
     }

apps/miniprogram/src/pages/login/index.tsx

@@ -9,6 +9,7 @@ declare const __wxConfig: Record<string, unknown> | undefined;
 
 const IS_DEV = process.env.NODE_ENV !== 'production';
 const IS_SIMULATOR = typeof __wxConfig !== 'undefined' && (__wxConfig as Record<string, unknown>)?.envVersion === 'develop';
+const SHOW_DEV_LOGIN = (IS_DEV || IS_SIMULATOR) && !!(process.env.TARO_APP_DEV_USER && process.env.TARO_APP_DEV_PASS);
 
 export default function Login() {
   const [agreed, setAgreed] = useState(false);
@@ -40,11 +41,16 @@ export default function Login() {
     }
   };
 
-  const handleWechatLogin = async () => {
+  const requireAgreement = () => {
     if (!agreed) {
       Taro.showToast({ title: '请先阅读并同意用户协议', icon: 'none' });
-      return;
+      return false;
     }
+    return true;
+  };
+
+  const handleWechatLogin = async () => {
+    if (!requireAgreement()) return;
     try {
       const { code } = await Taro.login();
       const result = await login(code);
@@ -60,23 +66,6 @@ export default function Login() {
     }
   };
 
-  const handleDevQuickLogin = async () => {
-    const devUser = process.env.TARO_APP_DEV_USER || '';
-    const devPass = process.env.TARO_APP_DEV_PASS || '';
-    if (!devUser || !devPass) {
-      Taro.showToast({ title: '未配置开发账号', icon: 'none' });
-      return;
-    }
-    try {
-      const success = await credentialLogin(devUser, devPass);
-      if (success) {
-        navigateAfterLogin();
-      }
-    } catch (err: unknown) {
-      Taro.showToast({ title: err instanceof Error ? err.message : '登录失败', icon: 'none' });
-    }
-  };
-
   const handleGetPhone = async (e: { detail: { errMsg: string; encryptedData: string; iv: string } }) => {
     if (e.detail.errMsg !== 'getPhoneNumber:ok') {
       Taro.showToast({ title: '需要授权手机号', icon: 'none' });
@@ -100,6 +89,7 @@ export default function Login() {
   };
 
   // DevTools 中 getPhoneNumber 不可用，直接传 mock 数据绕过微信 SDK
+  // 仅在后端 wechat_dev_mode=true 时有效，后端会生成 mock 手机号
   const handleDevBindPhone = async () => {
     try {
       const success = await bindPhone('dev_mock', 'dev_mock');
@@ -117,6 +107,21 @@ export default function Login() {
     }
   };
 
+  const handleDevQuickLogin = async () => {
+    if (!requireAgreement()) return;
+    const devUser = process.env.TARO_APP_DEV_USER || '';
+    const devPass = process.env.TARO_APP_DEV_PASS || '';
+    if (!devUser || !devPass) return;
+    try {
+      const success = await credentialLogin(devUser, devPass);
+      if (success) {
+        navigateAfterLogin();
+      }
+    } catch (err: unknown) {
+      Taro.showToast({ title: err instanceof Error ? err.message : '登录失败', icon: 'none' });
+    }
+  };
+
   return (
     <View className="login-page">
       {/* 品牌区 */}
@@ -130,16 +135,32 @@ export default function Login() {
 
       {!needBind ? (
         <>
-          {/* 微信一键登录 */}
+          {/* 微信一键登录（主按钮） */}
           <View className="login-wechat-btn" onClick={handleWechatLogin}>
             <Text className="login-wechat-icon">微</Text>
             <Text className="login-wechat-text">微信一键登录</Text>
           </View>
+
+          {/* 协议 */}
+          <View className="agreement-row">
+            <View
+              className={`agreement-check ${agreed ? 'checked' : ''}`}
+              onClick={() => setAgreed(!agreed)}
+            >
+              {agreed && <Text className="agreement-check-mark">&#10003;</Text>}
+            </View>
+            <Text className="agreement-text">
+              登录即同意
+              <Text className="agreement-link" onClick={() => safeNavigateTo('/pages/legal/user-agreement')}>《用户协议》</Text>
+              和
+              <Text className="agreement-link" onClick={() => safeNavigateTo('/pages/legal/privacy-policy')}>《隐私政策》</Text>
+            </Text>
+          </View>
         </>
       ) : (
         <View className="login-bind-section">
           {/* 真机：微信手机号授权 */}
-          {!(IS_DEV || IS_SIMULATOR) && (
+          {!SHOW_DEV_LOGIN && (
             <Button
               className="login-btn-bind"
               openType="getPhoneNumber"
@@ -151,7 +172,7 @@ export default function Login() {
             </Button>
           )}
           {/* DevTools：跳过微信 SDK 直接调后端（后端 wechat_dev_mode 会用 mock 手机号） */}
-          {(IS_DEV || IS_SIMULATOR) && (
+          {SHOW_DEV_LOGIN && (
             <Button
               className="login-btn-bind"
               onClick={handleDevBindPhone}
@@ -161,29 +182,28 @@ export default function Login() {
               授权手机号完成绑定（开发模式）
             </Button>
           )}
+          {/* 协议 */}
+          <View className="agreement-row" style={{ marginTop: '16px' }}>
+            <View
+              className={`agreement-check ${agreed ? 'checked' : ''}`}
+              onClick={() => setAgreed(!agreed)}
+            >
+              {agreed && <Text className="agreement-check-mark">&#10003;</Text>}
+            </View>
+            <Text className="agreement-text">
+              登录即同意
+              <Text className="agreement-link" onClick={() => safeNavigateTo('/pages/legal/user-agreement')}>《用户协议》</Text>
+              和
+              <Text className="agreement-link" onClick={() => safeNavigateTo('/pages/legal/privacy-policy')}>《隐私政策》</Text>
+            </Text>
+          </View>
         </View>
       )}
 
-      {/* 协议 */}
-      <View className="agreement-row">
-        <View
-          className={`agreement-check ${agreed ? 'checked' : ''}`}
-          onClick={() => setAgreed(!agreed)}
-        >
-          {agreed && <Text className="agreement-check-mark">&#10003;</Text>}
-        </View>
-        <Text className="agreement-text">
-          登录即同意
-          <Text className="agreement-link" onClick={() => safeNavigateTo('/pages/legal/user-agreement')}>《用户协议》</Text>
-          和
-          <Text className="agreement-link" onClick={() => safeNavigateTo('/pages/legal/privacy-policy')}>《隐私政策》</Text>
-        </Text>
-      </View>
-
       <View style={{ flex: 1 }} />
 
-      {/* 开发模式 */}
-      {(IS_DEV || IS_SIMULATOR) && (
+      {/* 开发模式快速登录 — 仅 dev 构建 + DevTools 中显示 */}
+      {SHOW_DEV_LOGIN && (
         <View className="login-dev-btn" onClick={handleDevQuickLogin}>
           <Text className="login-dev-btn-text">开发模式快速登录 ›</Text>
         </View>

apps/miniprogram/src/pages/pkg-health/device-sync/index.tsx

@@ -6,20 +6,66 @@ import { BLEManager } from '@/services/ble/BLEManager';
 import { XiaomiBandAdapter } from '@/services/ble/adapters/XiaomiBandAdapter';
 import { BloodPressureAdapter } from '@/services/ble/adapters/BloodPressureAdapter';
 import { GlucoseMeterAdapter } from '@/services/ble/adapters/GlucoseMeterAdapter';
-import { CustomBandAdapter } from '@/services/ble/adapters/GenericBleAdapter';
+import { CustomBandAdapter, HuaweiBandAdapter, FallbackAdapter } from '@/services/ble/adapters/GenericBleAdapter';
 import { DataSyncScheduler } from '@/services/ble/DataSyncScheduler';
 import { uploadReadings } from '@/services/device-sync';
 import { useAuthStore } from '@/stores/auth';
-import type { BLEDevice, NormalizedReading } from '@/services/ble/types';
+import type { BLEDevice, NormalizedReading, BLEDiscoveredService } from '@/services/ble/types';
 import { useElderClass } from '@/hooks/useElderClass';
 import PageShell from '@/components/ui/PageShell';
 import ContentCard from '@/components/ui/ContentCard';
+import PrimaryButton from '@/components/ui/PrimaryButton';
 import './index.scss';
 
-/** liveReadings 最大保留条数，防止内存无限增长 */
 const MAX_LIVE_READINGS = 200;
 
-type PageState = 'idle' | 'scanning' | 'connecting' | 'connected' | 'syncing' | 'done' | 'error';
+type PageState = 'idle' | 'scanning' | 'found' | 'connecting' | 'connected' | 'syncing' | 'done' | 'error';
+
+const DEVICE_TYPE_MAP: Record<string, { label: string; unit: string }> = {
+  heart_rate: { label: '心率', unit: 'bpm' },
+  blood_pressure: { label: '血压', unit: 'mmHg' },
+  blood_glucose: { label: '血糖', unit: 'mmol/L' },
+  blood_oxygen: { label: '血氧', unit: '%' },
+  temperature: { label: '体温', unit: '°C' },
+  steps: { label: '步数', unit: '步' },
+  sleep: { label: '睡眠', unit: 'h' },
+  stress: { label: '压力', unit: '' },
+};
+
+function formatReadingValue(r: NormalizedReading): string {
+  if (r.device_type === 'heart_rate' && typeof r.values.heart_rate === 'number') {
+    return String(r.values.heart_rate);
+  }
+  if (r.device_type === 'blood_pressure') {
+    if (typeof r.values.systolic === 'number' && typeof r.values.diastolic === 'number') {
+      return `${r.values.systolic}/${r.values.diastolic}`;
+    }
+    if (r.metric === 'systolic' && typeof r.values.value === 'number') return String(r.values.value);
+    if (r.metric === 'diastolic' && typeof r.values.value === 'number') return String(r.values.value);
+  }
+  if (r.device_type === 'blood_glucose' && typeof r.values.blood_glucose === 'number') {
+    return String(r.values.blood_glucose);
+  }
+  if (typeof r.values.value === 'number') return String(r.values.value);
+  return '--';
+}
+
+function getReadingUnit(r: NormalizedReading): string {
+  const mapped = DEVICE_TYPE_MAP[r.device_type];
+  if (mapped) return mapped.unit;
+  return typeof r.values.unit === 'string' ? r.values.unit : '';
+}
+
+function getReadingLabel(r: NormalizedReading): string {
+  const mapped = DEVICE_TYPE_MAP[r.device_type];
+  if (!mapped) return r.device_type;
+  if (r.device_type === 'blood_pressure') {
+    if (r.metric === 'systolic') return '收缩压';
+    if (r.metric === 'diastolic') return '舒张压';
+    return '血压';
+  }
+  return mapped.label;
+}
 
 export default function DeviceSync() {
   const modeClass = useElderClass();
@@ -34,16 +80,16 @@ export default function DeviceSync() {
   const [errorMsg, setErrorMsg] = useState('');
   const [lastSyncAt, setLastSyncAt] = useState<number | null>(null);
   const [pendingCount, setPendingCount] = useState(0);
+  const [discoveredServices, setDiscoveredServices] = useState<BLEDiscoveredService[]>([]);
 
-  const scheduler = useMemo(() => new DataSyncScheduler({
-    intervalMs: 60 * 60 * 1000,
-  }), []);
+  const scheduler = useMemo(() => new DataSyncScheduler({ intervalMs: 60 * 60 * 1000 }), []);
 
   const bleManagerRef = useRef<BLEManager | null>(null);
   const getBleManager = useCallback(() => {
     if (!bleManagerRef.current) {
       const mgr = new BLEManager({ scanTimeout: 10000, retryCount: 3 });
       mgr.registerAdapter(XiaomiBandAdapter);
+      mgr.registerAdapter(HuaweiBandAdapter);
       mgr.registerAdapter(BloodPressureAdapter);
       mgr.registerAdapter(GlucoseMeterAdapter);
       mgr.registerAdapter(CustomBandAdapter);
@@ -53,7 +99,12 @@ export default function DeviceSync() {
   }, []);
 
   useThrottledDidShow(() => {
-    const bleManager = getBleManager();
+    let bleManager: BLEManager;
+    try {
+      bleManager = getBleManager();
+    } catch {
+      return;
+    }
     bleManager.setOnConnectionChange(() => {});
     bleManager.setOnReadings((readings) => {
       setLiveReadings((prev) => {
@@ -61,17 +112,8 @@ export default function DeviceSync() {
         return merged.length > MAX_LIVE_READINGS ? merged.slice(-MAX_LIVE_READINGS) : merged;
       });
     });
-
-    // 显示上次同步时间
     setLastSyncAt(scheduler.getLastSyncAt());
 
-    // 检查是否有未上传的缓冲数据
-    const buffer = (bleManager as unknown as { dataBuffer?: Map<string, number> }).dataBuffer;
-    if (buffer) {
-      setPendingCount(buffer.size);
-    }
-
-    // 自动同步：超过间隔时尝试上传缓冲数据
     if (currentPatient && scheduler.needsSync()) {
       scheduler.tryAutoSync(async () => {
         const count = await bleManager.flushPendingReadings(async (readings) => {
@@ -95,18 +137,23 @@ export default function DeviceSync() {
   }, [scheduler]);
 
   const handleScan = useCallback(async () => {
+    console.log('[device-sync] 用户点击扫描按钮');
     setPageState('scanning');
     setDevices([]);
     setErrorMsg('');
     try {
       const found = await getBleManager().scanDevices();
-      setDevices(found);
-      if (found.length === 0) {
-        setErrorMsg('未发现支持的设备，请确认设备已开启蓝牙并靠近手机');
-      }
-      setPageState('idle');
+      console.log('[device-sync] 扫描返回设备数:', found.length);
+      // 未匹配适配器的设备分配 FallbackAdapter（尝试标准健康协议）
+      const withFallback = found.map((d) =>
+        d.adapter ? d : { ...d, adapter: FallbackAdapter },
+      );
+      setDevices(withFallback);
+      setPageState('found');
     } catch (e: unknown) {
-      setErrorMsg(e instanceof Error ? e.message : '扫描失败');
+      const msg = e instanceof Error ? e.message : '扫描失败';
+      console.error('[device-sync] 扫描异常:', msg);
+      setErrorMsg(msg);
       setPageState('error');
     }
   }, []);
@@ -117,6 +164,8 @@ export default function DeviceSync() {
     setErrorMsg('');
     try {
       await getBleManager().connect(device);
+      const conn = getBleManager().getConnection();
+      setDiscoveredServices(conn?.discoveredServices ?? []);
       setPageState('connected');
     } catch (e: unknown) {
       setErrorMsg(e instanceof Error ? e.message : '连接失败');
@@ -126,33 +175,22 @@ export default function DeviceSync() {
 
   const handleSync = useCallback(async () => {
     if (!currentPatient || !selectedDevice) return;
-
     setPageState('syncing');
     setErrorMsg('');
-
     try {
       const result = await getBleManager().syncToServer(async (readings) => {
-        return uploadReadings(
-          currentPatient.id,
-          selectedDevice.deviceId,
-          selectedDevice.name,
-          readings,
-        );
+        return uploadReadings(currentPatient.id, selectedDevice.deviceId, selectedDevice.name, readings);
       });
-
       if (result.success) {
         setSyncCount(result.uploadedCount);
         setLastSyncAt(Date.now());
         setPageState('done');
-
-        // 如果从体征录入页跳转而来，将最新读数写入 storage 供回填
         if (returnTo === 'input' && liveReadings.length > 0) {
           const mapped: Record<string, number> = {};
           for (const r of liveReadings) {
             if (r.device_type === 'blood_pressure') {
               if (r.metric === 'systolic' && typeof r.values.value === 'number') mapped.systolic = r.values.value;
               if (r.metric === 'diastolic' && typeof r.values.value === 'number') mapped.diastolic = r.values.value;
-              // 兼容 values 中直接包含 systolic/diastolic 的格式
               if (typeof r.values.systolic === 'number') mapped.systolic = r.values.systolic as number;
               if (typeof r.values.diastolic === 'number') mapped.diastolic = r.values.diastolic as number;
             } else if (r.device_type === 'blood_glucose' && typeof r.values.blood_glucose === 'number') {
@@ -182,143 +220,377 @@ export default function DeviceSync() {
     setLiveReadings([]);
     setSyncCount(0);
     setErrorMsg('');
+    setDiscoveredServices([]);
   }, []);
 
-  const renderIdle = () => (
-    <View className="sync-section">
-      <View className="sync-hero">
-        <Text className="sync-hero-icon">D</Text>
-        <Text className="sync-hero-title">设备同步</Text>
-        <Text className="sync-hero-desc">连接智能手环、血压计、血糖仪，自动采集健康数据</Text>
+  const latestReading = liveReadings.length > 0 ? liveReadings[liveReadings.length - 1] : null;
+
+  // ── 渲染子区域 ──
+
+  const renderHero = () => (
+    <View className="ds-hero">
+      <View className="ds-hero__icon">
+        <Text className="ds-hero__bt">BT</Text>
       </View>
-
-      {(lastSyncAt || pendingCount > 0) && (
-        <View className="sync-status-info">
-          {lastSyncAt && (
-            <Text className="sync-status-time">
-              上次同步: {new Date(lastSyncAt).toLocaleTimeString()}
-            </Text>
-          )}
-          {pendingCount > 0 && (
-            <Text className="sync-status-pending">
-              {pendingCount} 条数据待上传
-            </Text>
-          )}
-        </View>
-      )}
-
-      <View className="sync-action" onClick={handleScan}>
-        <Text className="sync-action-text">扫描设备</Text>
-      </View>
-
-      {devices.length > 0 && (
-        <View className="sync-device-list">
-          <Text className="sync-section-title">发现的设备</Text>
-          {devices.map((d) => (
-            <View
-              key={d.deviceId}
-              className="sync-device-item"
-              onClick={() => handleConnect(d)}
-            >
-              <View className="sync-device-info">
-                <Text className="sync-device-name">{d.name}</Text>
-                <Text className="sync-device-adapter">{d.adapter?.name}</Text>
-              </View>
-              <Text className="sync-device-rssi">信号 {d.RSSI > -60 ? '强' : d.RSSI > -80 ? '中' : '弱'}</Text>
-            </View>
-          ))}
-        </View>
-      )}
+      <Text className="ds-hero__title">智能设备同步</Text>
+      <Text className="ds-hero__desc">连接蓝牙设备，自动采集健康数据</Text>
     </View>
   );
 
-  const renderConnected = () => (
-    <View className="sync-section">
-      <ContentCard className="sync-status-card">
-        <Text className="sync-status-dot sync-status-dot--connected" />
-        <Text className="sync-status-text">已连接: {selectedDevice?.name}</Text>
-      </ContentCard>
+  const renderDeviceTypes = () => (
+    <View className="ds-types">
+      <Text className="ds-types__label">支持的设备</Text>
+      <View className="ds-types__row">
+        <View className="ds-type-tag"><Text className="ds-type-tag__dot ds-type-tag__dot--heart" /><Text className="ds-type-tag__text">心率手环</Text></View>
+        <View className="ds-type-tag"><Text className="ds-type-tag__dot ds-type-tag__dot--bp" /><Text className="ds-type-tag__text">血压计</Text></View>
+        <View className="ds-type-tag"><Text className="ds-type-tag__dot ds-type-tag__dot--glu" /><Text className="ds-type-tag__text">血糖仪</Text></View>
+      </View>
+    </View>
+  );
 
-      {liveReadings.length > 0 && (
-        <View className="sync-readings-panel">
-          <Text className="sync-section-title">实时数据</Text>
-          {liveReadings.slice(-5).reverse().map((r, i) => (
-            <View key={i} className="sync-reading-item">
-              <Text className="sync-reading-type">
-                {r.device_type === 'heart_rate' ? '心率'
-                  : r.device_type === 'blood_pressure' ? `血压(${r.metric === 'systolic' ? '收缩压' : r.metric === 'diastolic' ? '舒张压' : 'MAP'})`
-                  : r.device_type === 'blood_glucose' ? '血糖'
-                  : r.device_type}
-              </Text>
-              <Text className="sync-reading-value">
-                {r.device_type === 'heart_rate'
-                  ? `${r.values.heart_rate} bpm`
-                  : r.metric
-                    ? `${r.values.value} ${r.values.unit}`
-                    : JSON.stringify(r.values)}
-              </Text>
+  const renderLastSync = () => {
+    if (!lastSyncAt && pendingCount === 0) return null;
+    return (
+      <ContentCard variant="outlined" padding="md" margin="none" className="ds-sync-info">
+        <View className="ds-sync-info__inner">
+          <View className="ds-sync-info__icon-wrap">
+            <Text className="ds-sync-info__check">✓</Text>
+          </View>
+          <View className="ds-sync-info__text">
+            <Text className="ds-sync-info__title">上次同步</Text>
+            {lastSyncAt && <Text className="ds-sync-info__time">{new Date(lastSyncAt).toLocaleTimeString()}</Text>}
+          </View>
+          {pendingCount > 0 && (
+            <View className="ds-sync-info__badge">{pendingCount} 条待上传</View>
+          )}
+        </View>
+      </ContentCard>
+    );
+  };
+
+  const renderPendingWarning = () => {
+    if (pendingCount <= 0) return null;
+    return (
+      <View className="ds-warning">
+        <Text className="ds-warning__icon">!</Text>
+        <Text className="ds-warning__text">{pendingCount} 条数据待上传</Text>
+      </View>
+    );
+  };
+
+  const renderScanButton = () => (
+    <View className="ds-scan-btn-wrap">
+      <PrimaryButton size="large" onClick={handleScan} loading={pageState === 'scanning'}>
+        扫描附近设备
+      </PrimaryButton>
+    </View>
+  );
+
+  const renderDeviceList = () => {
+    if (pageState !== 'found') return null;
+    if (devices.length === 0) {
+      return (
+        <View className="ds-devices ds-devices--empty">
+          <View className="ds-devices__empty-box">
+            <Text className="ds-devices__empty-box-icon">!</Text>
+            <Text className="ds-devices__empty-box-title">未发现设备</Text>
+            <Text className="ds-devices__empty-box-desc">请确认设备已开机且蓝牙已开启，并靠近手机后重试</Text>
+          </View>
+          <View className="ds-devices__rescan-wrap">
+            <PrimaryButton size="large" onClick={handleScan}>重新扫描</PrimaryButton>
+          </View>
+        </View>
+      );
+    }
+    return (
+      <View className="ds-devices">
+        <View className="ds-devices__header">
+          <Text className="ds-devices__count">发现 {devices.length} 台设备</Text>
+          <Text className="ds-devices__rescan" onClick={handleScan}>重新扫描</Text>
+        </View>
+        {devices.map((d) => {
+          const isFallback = d.adapter?.name === '通用设备';
+          return (
+            <View key={d.deviceId} className={`ds-device-card ${isFallback ? 'ds-device-card--generic' : ''}`} onClick={() => handleConnect(d)}>
+              <View className="ds-device-card__icon">
+                <Text className="ds-device-card__bt">BT</Text>
+              </View>
+              <View className="ds-device-card__info">
+                <Text className="ds-device-card__name">{d.name}</Text>
+                <Text className="ds-device-card__adapter">{d.adapter?.name}{isFallback ? ' · 尝试标准协议' : ''}</Text>
+              </View>
+              <View className="ds-device-card__signal">
+                {[4, 7, 10, 13].map((h, i) => (
+                  <View
+                    key={i}
+                    className={`ds-signal-bar ${i < (d.RSSI > -60 ? 4 : d.RSSI > -80 ? 3 : d.RSSI > -90 ? 2 : 1) ? 'ds-signal-bar--active' : ''}`}
+                    style={{ height: `${h}px` }}
+                  />
+                ))}
+              </View>
+              <Text className="ds-device-card__arrow">›</Text>
+            </View>
+          );
+        })}
+        <View className="ds-devices__empty-hint">
+          <Text className="ds-devices__empty-icon">?</Text>
+          <View className="ds-devices__empty-text">
+            <Text className="ds-devices__empty-title">没有找到你的设备？</Text>
+            <Text className="ds-devices__empty-desc">确保设备已开机且蓝牙已开启</Text>
+          </View>
+        </View>
+      </View>
+    );
+  };
+
+  const renderLoading = (text: string) => (
+    <View className="ds-loading">
+      <View className="ds-loading__spinner" />
+      <Text className="ds-loading__text">{text}</Text>
+    </View>
+  );
+
+  const renderConnectedStatus = () => (
+    <View className="ds-connected-status">
+      <View className="ds-connected-status__icon">
+        <Text className="ds-connected-status__bt">BT</Text>
+      </View>
+      <View className="ds-connected-status__info">
+        <Text className="ds-connected-status__name">{selectedDevice?.name}</Text>
+        <Text className="ds-connected-status__sub">已连接 · 正在采集数据</Text>
+      </View>
+      <View className="ds-connected-status__badge">实时</View>
+    </View>
+  );
+
+  /** 渲染 BLE 服务发现信息 */
+  const renderServiceDiscovery = () => {
+    if (discoveredServices.length === 0) return null;
+
+    // 检查各类健康数据是否在已发现的 UUID 中可用
+    const hasCharShort = (short: string) =>
+      discoveredServices.some((s) =>
+        s.characteristics.some((c) =>
+          c.uuid.toUpperCase().replace(/-/g, '').slice(-4) === short,
+        ),
+      );
+
+    const capabilities = [
+      { key: '2A37', label: '心率', available: hasCharShort('2A37') },
+      { key: '2A5F', label: '血氧(实时)', available: hasCharShort('2A5F') },
+      { key: '2A5E', label: '血氧(单次)', available: hasCharShort('2A5E') },
+      { key: '2A1C', label: '体温', available: hasCharShort('2A1C') },
+      { key: '2A35', label: '血压', available: hasCharShort('2A35') },
+    ];
+
+    const availableCount = capabilities.filter((c) => c.available).length;
+
+    return (
+      <ContentCard variant="outlined" padding="md" margin="none" className="ds-services-info">
+        <Text className="ds-services-info__title">
+          设备服务 ({discoveredServices.length} 个服务, {availableCount} 种可用数据)
+        </Text>
+        <View className="ds-services-info__caps">
+          {capabilities.map((cap) => (
+            <View key={cap.key} className={`ds-cap-tag ${cap.available ? 'ds-cap-tag--on' : 'ds-cap-tag--off'}`}>
+              <Text className="ds-cap-tag__dot">{cap.available ? '●' : '○'}</Text>
+              <Text className="ds-cap-tag__text">{cap.label}</Text>
             </View>
           ))}
-          <Text className="sync-readings-count">
-            已采集 {liveReadings.length} 条数据
-          </Text>
         </View>
-      )}
+        {availableCount <= 1 && (
+          <View className="ds-services-info__hint">
+            <Text className="ds-services-info__hint-text">
+              {selectedDevice?.name?.includes('HUAWEI') || selectedDevice?.name?.includes('HW')
+                ? '华为手环的睡眠/步数/压力数据使用私有协议，需要华为运动健康 App 同步'
+                : '此设备仅暴露少量标准健康服务，更多数据请使用设备官方 App 同步'}
+            </Text>
+          </View>
+        )}
+      </ContentCard>
+    );
+  };
 
-      <View className="sync-actions-row">
-        <View className="sync-action sync-action--primary" onClick={handleSync}>
-          <Text className="sync-action-text">上传数据</Text>
+  const renderLatestReading = () => {
+    if (!latestReading) return null;
+    return (
+      <ContentCard variant="elevated" padding="lg" margin="none" className="ds-latest-reading">
+        <View className="ds-latest-reading__icon-wrap ds-latest-reading__icon-wrap--heart">
+          <Text className="ds-latest-reading__heart">♥</Text>
         </View>
-        <View className="sync-action sync-action--danger" onClick={handleDisconnect}>
-          <Text className="sync-action-text">断开连接</Text>
+        <View className="ds-latest-reading__body">
+          <Text className="ds-latest-reading__label">{getReadingLabel(latestReading)} · 刚刚</Text>
+          <View className="ds-latest-reading__values">
+            <Text className="ds-latest-reading__num">{formatReadingValue(latestReading)}</Text>
+            <Text className="ds-latest-reading__unit">{getReadingUnit(latestReading)}</Text>
+          </View>
         </View>
+      </ContentCard>
+    );
+  };
+
+  const renderReadingsHistory = () => {
+    if (liveReadings.length <= 1) return null;
+    const history = liveReadings.slice(0, -1).reverse().slice(0, 5);
+    return (
+      <View className="ds-history">
+        <Text className="ds-history__title">历史读数</Text>
+        <View className="ds-history__list">
+          {history.map((r, i) => (
+            <View key={i} className={`ds-history__row ${i === history.length - 1 ? 'ds-history__row--last' : ''}`}>
+              <Text className="ds-history__type">{getReadingLabel(r)}</Text>
+              <View className="ds-history__val-wrap">
+                <Text className="ds-history__val">{formatReadingValue(r)}</Text>
+                <Text className="ds-history__unit">{getReadingUnit(r)}</Text>
+              </View>
+            </View>
+          ))}
+        </View>
+        <Text className="ds-history__count">已采集 {liveReadings.length} 条数据</Text>
+      </View>
+    );
+  };
+
+  const renderConnectedActions = () => (
+    <View className="ds-actions">
+      <View className="ds-actions__upload" onClick={handleSync}>
+        <Text className="ds-actions__upload-text">上传数据</Text>
+      </View>
+      <View className="ds-actions__disconnect" onClick={handleDisconnect}>
+        <Text className="ds-actions__disconnect-icon">✕</Text>
       </View>
     </View>
   );
 
   const renderDone = () => (
-    <View className="sync-section">
-      <ContentCard className="sync-result-card">
-        <Text className="sync-result-icon">V</Text>
-        <Text className="sync-result-title">同步完成</Text>
-        <Text className="sync-result-count">成功上传 {syncCount} 条数据</Text>
-      </ContentCard>
-      <View className="sync-action" onClick={() => {
-        handleDisconnect();
-        if (returnTo === 'input') {
-          Taro.navigateBack();
-        }
-      }}>
-        <Text className="sync-action-text">{returnTo === 'input' ? '返回录入' : '完成'}</Text>
+    <View className="ds-done">
+      <View className="ds-done__icon">
+        <Text className="ds-done__check">✓</Text>
+      </View>
+      <Text className="ds-done__title">同步完成</Text>
+      <Text className="ds-done__desc">数据已安全上传至健康管理平台</Text>
+      <View className="ds-done__stats">
+        <View className="ds-done__stat">
+          <Text className="ds-done__stat-num ds-done__stat-num--pri">{syncCount}</Text>
+          <Text className="ds-done__stat-label">上传条数</Text>
+        </View>
+        <View className="ds-done__stat">
+          <Text className="ds-done__stat-num">{new Set(liveReadings.map((r) => r.device_type)).size}</Text>
+          <Text className="ds-done__stat-label">数据类型</Text>
+        </View>
+        <View className="ds-done__stat">
+          <Text className="ds-done__stat-num ds-done__stat-num--acc">100%</Text>
+          <Text className="ds-done__stat-label">成功率</Text>
+        </View>
+      </View>
+      <PrimaryButton size="large" onClick={() => { handleDisconnect(); if (returnTo === 'input') Taro.navigateBack(); }}>
+        {returnTo === 'input' ? '返回录入' : '完成'}
+      </PrimaryButton>
+    </View>
+  );
+
+  const renderError = () => (
+    <View className="ds-error-page">
+      <View className="ds-error-page__icon">
+        <Text className="ds-error-page__x">✕</Text>
+      </View>
+      <Text className="ds-error-page__title">连接失败</Text>
+      <Text className="ds-error-page__desc">{errorMsg || '无法连接到设备，请检查设备是否在范围内并重试'}</Text>
+      <View className="ds-error-page__detail">
+        <Text className="ds-error-page__detail-title">错误详情</Text>
+        <View className="ds-error-page__detail-row"><Text className="ds-error-page__detail-label">设备</Text><Text className="ds-error-page__detail-value">{selectedDevice?.name || '--'}</Text></View>
+        <View className="ds-error-page__detail-row ds-error-page__detail-row--last"><Text className="ds-error-page__detail-label">时间</Text><Text className="ds-error-page__detail-value">{new Date().toLocaleTimeString()}</Text></View>
+      </View>
+      <PrimaryButton size="large" onClick={handleScan}>重新扫描</PrimaryButton>
+      <View className="ds-error-page__back" onClick={() => Taro.navigateBack()}>
+        <Text className="ds-error-page__back-text">返回</Text>
       </View>
     </View>
   );
 
+  // ── 主渲染 ──
   return (
-    <PageShell padding="none" className={modeClass}>
-      <View className="sync-header">
-        <Text className="sync-header-title">设备同步</Text>
-      </View>
-
-      {errorMsg && (
-        <View className="sync-error">
-          <Text className="sync-error-text">{errorMsg}</Text>
+    <PageShell padding="none" className={`ds-page ${modeClass}`}>
+      {/* 空闲态 */}
+      {pageState === 'idle' && (
+        <View className="ds-body">
+          {renderHero()}
+          {renderDeviceTypes()}
+          {renderLastSync()}
+          {renderPendingWarning()}
+          {renderScanButton()}
         </View>
       )}
 
-      {(pageState === 'scanning' || pageState === 'connecting' || pageState === 'syncing') && (
-        <View className="sync-loading">
-          <Text className="sync-loading-text">
-            {pageState === 'scanning' && '正在扫描设备...'}
-            {pageState === 'connecting' && '正在连接设备...'}
-            {pageState === 'syncing' && '正在上传数据...'}
-          </Text>
+      {/* 扫描结果（设备列表或空结果提示） */}
+      {pageState === 'found' && (
+        <View className="ds-body">
+          {renderHero()}
+          {renderDeviceTypes()}
+          {renderDeviceList()}
         </View>
       )}
 
-      {(pageState === 'idle' || pageState === 'error') && renderIdle()}
-      {pageState === 'connected' && renderConnected()}
-      {pageState === 'done' && renderDone()}
+      {/* 扫描中 */}
+      {pageState === 'scanning' && (
+        <View className="ds-body ds-body--center">
+          <View className="ds-pulse">
+            <View className="ds-pulse__ring ds-pulse__ring--1" />
+            <View className="ds-pulse__ring ds-pulse__ring--2" />
+            <View className="ds-pulse__center">
+              <Text className="ds-pulse__bt">BT</Text>
+            </View>
+          </View>
+          <Text className="ds-pulse__title">正在搜索设备...</Text>
+          <Text className="ds-pulse__hint">请确保设备已开启蓝牙并靠近手机</Text>
+        </View>
+      )}
+
+      {/* 连接中 */}
+      {pageState === 'connecting' && (
+        <View className="ds-body ds-body--center">
+          <View className="ds-connect-anim">
+            <View className="ds-connect-anim__ring" />
+            <View className="ds-connect-anim__center">
+              <Text className="ds-connect-anim__bt">BT</Text>
+            </View>
+          </View>
+          <Text className="ds-connect-anim__title">正在连接 {selectedDevice?.name}</Text>
+          <Text className="ds-connect-anim__sub">正在进行蓝牙配对...</Text>
+          <View className="ds-steps">
+            <View className="ds-steps__dot ds-steps__dot--done" />
+            <Text className="ds-steps__label ds-steps__label--done">发现设备</Text>
+            <View className="ds-steps__line ds-steps__line--active" />
+            <View className="ds-steps__dot ds-steps__dot--active" />
+            <Text className="ds-steps__label ds-steps__label--active">连接中</Text>
+            <View className="ds-steps__line" />
+            <View className="ds-steps__dot" />
+            <Text className="ds-steps__label">同步数据</Text>
+          </View>
+        </View>
+      )}
+
+      {/* 同步中 */}
+      {pageState === 'syncing' && renderLoading('正在上传数据...')}
+
+      {/* 已连接 */}
+      {pageState === 'connected' && (
+        <View className="ds-body">
+          {renderConnectedStatus()}
+          {renderServiceDiscovery()}
+          {renderLatestReading()}
+          {renderReadingsHistory()}
+          {renderConnectedActions()}
+        </View>
+      )}
+
+      {/* 同步完成 */}
+      {pageState === 'done' && <View className="ds-body ds-body--center">{renderDone()}</View>}
+
+      {/* 错误态 */}
+      {pageState === 'error' && errorMsg && (
+        <View className="ds-body ds-body--center">{renderError()}</View>
+      )}
     </PageShell>
   );
 }

apps/miniprogram/src/pages/pkg-health/veepoo-measure/index.config.ts

@@ -0,0 +1,3 @@
+export default definePageConfig({
+  navigationBarTitleText: '健康测量',
+});

apps/miniprogram/src/pages/pkg-health/veepoo-measure/index.scss

@@ -0,0 +1,256 @@
+// Veepoo 测量结果 + 上传页样式
+// 设计原型: docs/design/veepoo-measure-prototype.html
+@import '../../../styles/variables.scss';
+
+.vm-page {
+  min-height: 100vh;
+  background: var(--tk-bg-primary, $bg);
+}
+
+// ── 连接中（等待跳转态） ──
+.vm-connect {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  min-height: 100vh;
+  padding: 0 32px;
+
+  &__anim {
+    position: relative;
+    width: 120px;
+    height: 120px;
+    margin-bottom: 24px;
+  }
+
+  &__ring {
+    position: absolute;
+    inset: 0;
+    border-radius: 50%;
+    border: 3px solid $pri;
+    animation: vm-pulse-ring 2s ease-out infinite;
+  }
+
+  &__center {
+    position: absolute;
+    inset: 20px;
+    border-radius: 50%;
+    background: $pri;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+  }
+
+  &__bt {
+    color: #fff;
+    font-size: 20px;
+    font-weight: 700;
+  }
+
+  &__title {
+    font-family: Georgia, 'Times New Roman', serif;
+    font-size: var(--tk-font-h2, 22px);
+    font-weight: 700;
+    color: $tx;
+    margin-bottom: 8px;
+  }
+
+  &__hint {
+    font-size: var(--tk-font-body-sm, 14px);
+    color: $tx3;
+  }
+}
+
+@keyframes vm-pulse-ring {
+  0% { transform: scale(1); opacity: 1; }
+  100% { transform: scale(1.4); opacity: 0; }
+}
+
+// ── 上传页面 ──
+.vm-upload {
+  min-height: 100vh;
+  padding-bottom: 40px;
+
+  &__header {
+    padding: var(--tk-gap-lg, 24px) var(--tk-page-padding, 20px) var(--tk-gap-md, 16px);
+  }
+
+  &__title {
+    display: block;
+    font-family: Georgia, 'Times New Roman', serif;
+    font-size: var(--tk-font-h2, 22px);
+    font-weight: 700;
+    color: $tx;
+    line-height: 1.3;
+  }
+
+  &__subtitle {
+    display: block;
+    font-size: var(--tk-font-body-sm, 14px);
+    color: $tx3;
+    margin-top: 4px;
+  }
+}
+
+// ── 结果卡片网格 ──
+.vm-results-grid {
+  padding: 0 var(--tk-page-padding, 20px);
+  display: grid;
+  grid-template-columns: repeat(2, 1fr);
+  gap: var(--tk-gap-sm, 12px);
+}
+
+.vm-result-card {
+  background: $card;
+  border-radius: var(--tk-card-radius, 16px);
+  padding: var(--tk-gap-md, 16px);
+  box-shadow: $shadow-sm;
+  position: relative;
+  overflow: hidden;
+
+  &--full {
+    grid-column: 1 / -1;
+  }
+
+  &--empty {
+    opacity: 0.5;
+  }
+
+  &__badge {
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 4px;
+    height: 100%;
+    border-radius: 0 4px 4px 0;
+  }
+
+  &__label {
+    display: block;
+    font-size: var(--tk-font-cap, 13px);
+    color: $tx2;
+    margin-bottom: 8px;
+    padding-left: 8px;
+  }
+
+  &__row {
+    display: flex;
+    align-items: baseline;
+    gap: 4px;
+    padding-left: 8px;
+  }
+
+  &__value {
+    font-family: Georgia, 'Times New Roman', serif;
+    font-size: var(--tk-font-num-lg, 34px);
+    font-weight: 700;
+    color: $tx;
+    line-height: 1;
+  }
+
+  &__unit {
+    font-size: var(--tk-font-cap, 13px);
+    color: $tx3;
+  }
+
+  &__tag {
+    display: inline-flex;
+    align-items: center;
+    gap: 3px;
+    margin-top: 8px;
+    margin-left: 8px;
+    padding: 2px 8px;
+    border-radius: 999px;
+    font-size: var(--tk-font-micro, 11px);
+    font-weight: 500;
+
+    &--normal {
+      background: $acc-l;
+      color: $acc;
+    }
+
+    &--warning {
+      background: $wrn-l;
+      color: $wrn;
+    }
+
+    &--danger {
+      background: $dan-l;
+      color: $dan;
+    }
+  }
+
+  &__placeholder {
+    padding-left: 8px;
+    font-size: var(--tk-font-body-sm, 14px);
+    color: $tx3;
+  }
+
+  &--sleep {
+    padding-bottom: 12px;
+  }
+}
+
+// ── 睡眠数据行 ──
+.vm-sleep-row {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 6px 8px;
+  margin-left: 8px;
+
+  &__day {
+    font-size: var(--tk-font-body-sm, 14px);
+    color: $tx2;
+    min-width: 40px;
+  }
+
+  &__time {
+    font-family: Georgia, 'Times New Roman', serif;
+    font-size: var(--tk-font-body, 16px);
+    font-weight: 600;
+    color: $tx;
+  }
+
+  &__quality {
+    font-size: 12px;
+    color: $wrn;
+    margin-left: auto;
+  }
+}
+
+// ── 底部上传播区 ──
+.vm-upload-footer {
+  padding: var(--tk-gap-lg, 24px) var(--tk-page-padding, 20px) var(--tk-gap-xl, 32px);
+
+  &__hint {
+    display: block;
+    font-size: var(--tk-font-cap, 13px);
+    color: $tx3;
+    text-align: center;
+    margin-bottom: var(--tk-gap-sm, 12px);
+  }
+
+  &__btn {
+    width: 100%;
+  }
+
+  &__time {
+    display: block;
+    font-size: var(--tk-font-micro, 11px);
+    color: $tx3;
+    text-align: center;
+    margin-top: var(--tk-gap-sm, 12px);
+  }
+}
+
+// ── 长者模式 ──
+.elder-mode {
+  .vm-results-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .vm-result-card__value {
+    font-size: var(--tk-font-num-lg, 40px);
+  }
+}

apps/miniprogram/src/pages/pkg-health/veepoo-measure/index.tsx

@@ -0,0 +1,306 @@
+import React, { useRef } from 'react';
+import { View, Text } from '@tarojs/components';
+import Taro, { useDidShow, useRouter } from '@tarojs/taro';
+import { useAuthStore } from '@/stores/auth';
+import { uploadReadings } from '@/services/device-sync';
+import type { NormalizedReading } from '@/services/ble/types';
+import { useElderClass } from '@/hooks/useElderClass';
+import PageShell from '@/components/ui/PageShell';
+import PrimaryButton from '@/components/ui/PrimaryButton';
+import './index.scss';
+
+/** 原生页面返回的测量结果格式 */
+interface NativeMeasureResult {
+  type: string;
+  values: Record<string, number>;
+  measuredAt: number;
+}
+
+/** 原生页面返回的睡眠数据格式 */
+interface NativeSleepResult {
+  day: number;
+  deepSleepMinutes: number;
+  lightSleepMinutes: number;
+  totalSleepMinutes: number;
+  qualityScore: number;
+  fallAsleepTime: string;
+  exitSleepTime: string;
+}
+
+/** 指标配置 */
+const METRIC_CONFIG = [
+  { type: 'heart_rate', label: '心率', unit: 'bpm', color: '#EF4444', icon: '♥' },
+  { type: 'blood_oxygen', label: '血氧', unit: '%', color: '#3B82F6', icon: 'O₂' },
+  { type: 'blood_pressure', label: '血压', unit: 'mmHg', color: '#8B5CF6', icon: '↕' },
+  { type: 'temperature', label: '体温', unit: '°C', color: '#F59E0B', icon: 'T' },
+  { type: 'pressure', label: '压力', unit: '', color: '#6366F1', icon: '~' },
+] as const;
+
+/** 健康评估 */
+function assessHealth(type: string, values: Record<string, number>): { level: 'normal' | 'warning' | 'danger'; text: string } {
+  switch (type) {
+    case 'heart_rate': {
+      const v = values.heart_rate ?? 0;
+      if (v >= 60 && v <= 100) return { level: 'normal', text: '心率正常' };
+      if (v < 50 || v > 120) return { level: 'danger', text: '心率异常' };
+      return { level: 'warning', text: '心率偏离正常范围' };
+    }
+    case 'blood_oxygen': {
+      const v = values.blood_oxygen ?? 0;
+      if (v >= 95) return { level: 'normal', text: '血氧正常' };
+      if (v >= 90) return { level: 'warning', text: '血氧偏低' };
+      return { level: 'danger', text: '血氧过低' };
+    }
+    case 'blood_pressure': {
+      const sys = values.systolic ?? 0;
+      const dia = values.diastolic ?? 0;
+      if (sys >= 90 && sys <= 140 && dia >= 60 && dia <= 90) return { level: 'normal', text: '血压正常' };
+      if (sys > 160 || dia > 100) return { level: 'danger', text: '血压过高' };
+      return { level: 'warning', text: '血压偏高' };
+    }
+    case 'temperature': {
+      const v = values.temperature ?? 0;
+      if (v >= 36.0 && v <= 37.3) return { level: 'normal', text: '体温正常' };
+      if (v > 38.0) return { level: 'danger', text: '发热' };
+      return { level: 'warning', text: '体温偏离正常' };
+    }
+    case 'pressure': {
+      const v = values.pressure ?? 0;
+      if (v >= 1 && v <= 40) return { level: 'normal', text: '压力正常' };
+      if (v > 60) return { level: 'danger', text: '压力过高' };
+      return { level: 'warning', text: '压力偏高' };
+    }
+    default:
+      return { level: 'normal', text: '' };
+  }
+}
+
+/** 格式化显示值 */
+function formatValue(type: string, values: Record<string, number>): string {
+  if (type === 'blood_pressure') {
+    return `${values.systolic ?? '--'}/${values.diastolic ?? '--'}`;
+  }
+  const v = Object.values(values)[0];
+  return v !== undefined ? String(v) : '--';
+}
+
+export default function VeepooMeasure() {
+  const modeClass = useElderClass();
+  const router = useRouter();
+  const patient = useAuthStore((s) => s.currentPatient);
+  const navigatedRef = useRef(false);
+  const [results, setResults] = React.useState<Record<string, NativeMeasureResult>>({});
+  const [sleepData, setSleepData] = React.useState<NativeSleepResult[]>([]);
+  const [uploadStatus, setUploadStatus] = React.useState<'idle' | 'uploading' | 'success' | 'error'>('idle');
+
+  // 从 URL 或 store 获取 patientId
+  const patientId = patient?.id || router.params.patientId || '';
+
+  // C3 修复：用 ref 防重入，避免 React Strict Mode 双触发
+  if (!navigatedRef.current) {
+    navigatedRef.current = true;
+    // 延迟到下一个微任务，确保页面渲染完成后再跳转
+    setTimeout(() => {
+      Taro.navigateTo({
+        url: `/pkg-veepoo/index?patientId=${patientId}`,
+        events: {
+          measureResult: (data: NativeMeasureResult) => {
+            setResults((prev) => ({ ...prev, [data.type]: data }));
+          },
+          measureComplete: (data: { results: Record<string, NativeMeasureResult>; count: number }) => {
+            if (data.results) setResults(data.results);
+          },
+        },
+      });
+    }, 50);
+  }
+
+  // 页面恢复时读取原生页面返回的测量结果 + 睡眠数据
+  useDidShow(() => {
+    try {
+      const raw = Taro.getStorageSync('hms:veepoo_measure_results');
+      if (raw) {
+        const parsed = JSON.parse(raw) as Record<string, NativeMeasureResult>;
+        setResults(parsed);
+        Taro.removeStorageSync('hms:veepoo_measure_results');
+      }
+    } catch { /* ignore */ }
+
+    try {
+      const rawSleep = Taro.getStorageSync('hms:veepoo_sleep_results');
+      if (rawSleep) {
+        const parsedSleep = JSON.parse(rawSleep) as NativeSleepResult[];
+        if (parsedSleep.length > 0) {
+          setSleepData(parsedSleep);
+        }
+        Taro.removeStorageSync('hms:veepoo_sleep_results');
+      }
+    } catch { /* ignore */ }
+  });
+
+  const handleUpload = async () => {
+    // 修复：添加明确的错误提示，不再静默退出
+    if (!patientId) {
+      console.warn('[veepoo-measure] 上传失败：未获取到患者 ID');
+      Taro.showToast({ title: '请先绑定患者档案', icon: 'none' });
+      return;
+    }
+    const allResults = Object.values(results);
+    const hasMeasureData = allResults.length > 0;
+    const hasSleep = sleepData.length > 0;
+
+    if (!hasMeasureData && !hasSleep) {
+      console.warn('[veepoo-measure] 上传失败：无数据');
+      Taro.showToast({ title: '暂无测量数据', icon: 'none' });
+      return;
+    }
+
+    setUploadStatus('uploading');
+    try {
+      const allReadings: NormalizedReading[] = [];
+
+      // 测量结果
+      if (hasMeasureData) {
+        console.log('[veepoo-measure] 上传测量数据', allResults.length, '项');
+        allReadings.push(...allResults.map((r) => ({
+          device_type: r.type as NormalizedReading['device_type'],
+          values: r.values,
+          measured_at: new Date(r.measuredAt).toISOString(),
+        })));
+      }
+
+      // 睡眠数据
+      if (hasSleep) {
+        const now = new Date();
+        console.log('[veepoo-measure] 上传睡眠数据', sleepData.length, '天');
+        allReadings.push(...sleepData.map((s) => {
+          const baseDate = new Date(now.getTime() - s.day * 86400000);
+          return {
+            device_type: 'sleep' as const,
+            values: {
+              deep_sleep_minutes: s.deepSleepMinutes,
+              light_sleep_minutes: s.lightSleepMinutes,
+              total_sleep_minutes: s.totalSleepMinutes,
+              quality_score: s.qualityScore,
+            },
+            measured_at: baseDate.toISOString(),
+          };
+        }));
+      }
+
+      await uploadReadings(patientId, 'veepoo_m2', 'Veepoo M2', allReadings);
+      setUploadStatus('success');
+      Taro.showToast({ title: '数据已上传', icon: 'success' });
+    } catch (err) {
+      console.error('[veepoo-measure] 上传失败:', err);
+      setUploadStatus('error');
+      Taro.showToast({ title: '上传失败，请重试', icon: 'none' });
+    }
+  };
+
+  const hasResults = Object.keys(results).length > 0;
+  const measuredCount = Object.keys(results).length;
+  const measuredAt = hasResults
+    ? new Date(Object.values(results)[0].measuredAt).toLocaleString('zh-CN', { month: 'numeric', day: 'numeric', hour: '2-digit', minute: '2-digit' })
+    : '';
+
+  return (
+    <PageShell padding="none" className={`vm-page ${modeClass}`}>
+      {hasResults ? (
+        <View className="vm-upload">
+          {/* 页面标题 */}
+          <View className="vm-upload__header">
+            <Text className="vm-upload__title">测量结果</Text>
+            <Text className="vm-upload__subtitle">Veepoo M2 · 刚刚完成测量</Text>
+          </View>
+
+          {/* 结果卡片网格 */}
+          <View className="vm-results-grid">
+            {METRIC_CONFIG.map((metric) => {
+              const result = results[metric.type];
+              if (result) {
+                const assessment = assessHealth(metric.type, result.values);
+                return (
+                  <View
+                    key={metric.type}
+                    className={`vm-result-card ${metric.type === 'blood_pressure' ? 'vm-result-card--full' : ''}`}
+                  >
+                    <View className="vm-result-card__badge" style={{ background: metric.color }} />
+                    <Text className="vm-result-card__label">{metric.label}</Text>
+                    <View className="vm-result-card__row">
+                      <Text className="vm-result-card__value">{formatValue(metric.type, result.values)}</Text>
+                      <Text className="vm-result-card__unit">{metric.unit}</Text>
+                    </View>
+                    <View className={`vm-result-card__tag vm-result-card__tag--${assessment.level}`}>
+                      <Text>● {assessment.text}</Text>
+                    </View>
+                  </View>
+                );
+              }
+              // 未测量占位
+              return (
+                <View
+                  key={metric.type}
+                  className={`vm-result-card vm-result-card--empty ${metric.type === 'blood_pressure' ? 'vm-result-card--full' : ''}`}
+                >
+                  <View className="vm-result-card__badge" style={{ background: metric.color, opacity: 0.3 }} />
+                  <Text className="vm-result-card__label">{metric.label}</Text>
+                  <Text className="vm-result-card__placeholder">未测量</Text>
+                </View>
+              );
+            })}
+
+            {/* 睡眠数据卡片 */}
+            {sleepData.length > 0 && (
+              <View className="vm-result-card vm-result-card--full vm-result-card--sleep">
+                <View className="vm-result-card__badge" style={{ background: '#5B7A5E' }} />
+                <Text className="vm-result-card__label">睡眠数据（{sleepData.length} 天）</Text>
+                {sleepData.map((sleep, idx) => {
+                  const hours = Math.floor(sleep.totalSleepMinutes / 60);
+                  const mins = sleep.totalSleepMinutes % 60;
+                  const dayLabel = sleep.day === 0 ? '昨晚' : sleep.day === 1 ? '前晚' : '大前晚';
+                  return (
+                    <View key={idx} className="vm-sleep-row">
+                      <Text className="vm-sleep-row__day">{dayLabel}</Text>
+                      <Text className="vm-sleep-row__time">{hours}h{mins > 0 ? ` ${mins}min` : ''}</Text>
+                      <View className="vm-sleep-row__quality">
+                        {'★'.repeat(Math.min(sleep.qualityScore, 5))}{'☆'.repeat(Math.max(5 - sleep.qualityScore, 0))}
+                      </View>
+                    </View>
+                  );
+                })}
+                <View className="vm-result-card__tag vm-result-card__tag--normal">
+                  <Text>● 自动同步</Text>
+                </View>
+              </View>
+            )}
+          </View>
+
+          {/* 底部上传播区 */}
+          <View className="vm-upload-footer">
+            <Text className="vm-upload-footer__hint">测量数据将上传至您的健康档案</Text>
+            <View className="vm-upload-footer__btn">
+              <PrimaryButton onClick={handleUpload} disabled={uploadStatus === 'uploading'}>
+                {uploadStatus === 'uploading'
+                  ? '上传中...'
+                  : uploadStatus === 'success'
+                    ? '✓ 已上传'
+                    : `上传数据（${measuredCount} 项测量${sleepData.length > 0 ? ' + ' + sleepData.length + ' 天睡眠' : ''}）`}
+              </PrimaryButton>
+            </View>
+            {measuredAt && <Text className="vm-upload-footer__time">测量时间：{measuredAt}</Text>}
+          </View>
+        </View>
+      ) : (
+        <View className="vm-connect">
+          <View className="vm-connect__anim">
+            <View className="vm-connect__ring" />
+            <View className="vm-connect__center"><Text className="vm-connect__bt">BT</Text></View>
+          </View>
+          <Text className="vm-connect__title">M2 手环健康测量</Text>
+          <Text className="vm-connect__hint">即将跳转到设备测量页面...</Text>
+        </View>
+      )}
+    </PageShell>
+  );
+}

apps/miniprogram/src/pages/pkg-profile/health-records/index.scss

@@ -1,18 +1,12 @@
 @import '../../../styles/variables.scss';
 @import '../../../styles/mixins.scss';
 
-// PageShell 已接管：min-height, background, padding
-
 .page-title {
-  font-family: 'Georgia', 'Times New Roman', serif;
-  font-size: var(--tk-font-num);
-  font-weight: bold;
-  color: $tx;
-  margin-bottom: var(--tk-section-gap);
-  display: block;
+  @include section-title;
   padding-left: var(--tk-gap-2xs);
 }
 
+/* ─── 健康记录卡片 ─── */
 .record-list {
   display: flex;
   flex-direction: column;
@@ -65,3 +59,79 @@
   display: block;
   margin-top: var(--tk-gap-xs);
 }
+
+/* ─── 诊断记录卡片 ─── */
+.diagnosis-list {
+  display: flex;
+  flex-direction: column;
+  gap: var(--tk-gap-md);
+}
+
+.diagnosis-card {
+  background: $card;
+  border-radius: $r;
+  padding: var(--tk-card-padding-lg);
+  box-shadow: $shadow-sm;
+}
+
+.diagnosis-card__header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: var(--tk-gap-xs);
+}
+
+.diagnosis-card__name {
+  font-size: var(--tk-font-body-lg);
+  font-weight: bold;
+  color: $tx;
+  flex: 1;
+  margin-right: var(--tk-gap-sm);
+}
+
+.diagnosis-card__status {
+  font-size: var(--tk-font-cap);
+  padding: 2px 8px;
+  border-radius: $r-pill;
+  font-weight: 600;
+
+  &.active { background: $acc-l; color: $acc; }
+  &.resolved { background: $bd-l; color: $tx2; }
+  &.chronic { background: $wrn-l; color: $wrn; }
+}
+
+.diagnosis-card__meta {
+  display: flex;
+  gap: var(--tk-gap-sm);
+  align-items: center;
+  margin-bottom: var(--tk-gap-2xs);
+}
+
+.diagnosis-card__type {
+  font-size: var(--tk-font-cap);
+  padding: 1px 6px;
+  border-radius: $r-pill;
+
+  &.primary { background: var(--tk-pri-l); color: var(--tk-pri); }
+  &.secondary { background: $bd-l; color: $tx2; }
+  &.comorbid { background: $wrn-l; color: $wrn; }
+}
+
+.diagnosis-card__code {
+  font-size: var(--tk-font-cap);
+  color: $tx3;
+  font-variant-numeric: tabular-nums;
+}
+
+.diagnosis-card__date {
+  font-size: var(--tk-font-cap);
+  color: $tx3;
+  display: block;
+}
+
+.diagnosis-card__notes {
+  font-size: var(--tk-font-body);
+  color: $tx2;
+  display: block;
+  margin-top: var(--tk-gap-xs);
+}

apps/miniprogram/src/pages/pkg-profile/health-records/index.tsx

@@ -3,89 +3,197 @@ import { View, Text } from '@tarojs/components';
 import Taro, { useReachBottom } from '@tarojs/taro';
 import { usePageData } from '@/hooks/usePageData';
 import { getCachedPatientId } from '@/services/request';
-import { listHealthRecords, HealthRecord } from '../../../services/health-record';
+import {
+  listHealthRecords,
+  HealthRecord,
+  listDiagnoses,
+  Diagnosis,
+} from '../../../services/health-record';
 import EmptyState from '../../../components/EmptyState';
 import Loading from '../../../components/Loading';
 import { useElderClass } from '../../../hooks/useElderClass';
 import PageShell from '@/components/ui/PageShell';
+import SegmentTabs from '../../../components/SegmentTabs';
 import './index.scss';
 
-const TYPE_MAP: Record<string, string> = {
+const TABS = [
+  { key: 'records', label: '体检记录' },
+  { key: 'diagnoses', label: '诊断记录' },
+] as const;
+
+const RECORD_TYPE_MAP: Record<string, string> = {
   checkup: '体检',
   follow_up: '复查',
   referral: '转诊',
 };
 
-export default function HealthRecords() {
-  const modeClass = useElderClass();
-  const [records, setRecords] = useState<HealthRecord[]>([]);
-  const [page, setPage] = useState(1);
-  const [total, setTotal] = useState(0);
-  const [loading, setLoading] = useState(false);
-  const [hasPatient, setHasPatient] = useState(true);
+const DIAG_TYPE_MAP: Record<string, { label: string; cls: string }> = {
+  primary: { label: '主要', cls: 'primary' },
+  secondary: { label: '次要', cls: 'secondary' },
+  comorbid: { label: '合并症', cls: 'comorbid' },
+};
 
-  const fetchData = useCallback(async (p: number, append = false) => {
+const DIAG_STATUS_MAP: Record<string, { label: string; cls: string }> = {
+  active: { label: '活动', cls: 'active' },
+  resolved: { label: '已解决', cls: 'resolved' },
+  chronic: { label: '慢性', cls: 'chronic' },
+};
+
+type TabKey = 'records' | 'diagnoses';
+
+export default function HealthArchive() {
+  const modeClass = useElderClass();
+  const [tab, setTab] = useState<TabKey>('records');
+
+  // --- 健康记录 ---
+  const [records, setRecords] = useState<HealthRecord[]>([]);
+  const [recordsPage, setRecordsPage] = useState(1);
+  const [recordsTotal, setRecordsTotal] = useState(0);
+  const [recordsLoading, setRecordsLoading] = useState(false);
+
+  const fetchRecords = useCallback(async (p: number, append = false) => {
     const patientId = getCachedPatientId();
-    if (!patientId) {
-      setRecords([]);
-      setHasPatient(false);
-      return;
-    }
-    setHasPatient(true);
-    setLoading(true);
+    if (!patientId) return;
+    setRecordsLoading(true);
     try {
       const res = await listHealthRecords(patientId, { page: p, page_size: 20 });
       const list = res.data || [];
       setRecords(append ? (prev) => [...prev, ...list] : list);
-      setTotal(res.total);
-      setPage(p);
+      setRecordsTotal(res.total);
+      setRecordsPage(p);
     } catch (err) {
       console.warn('[health-records] 加载失败:', err);
       Taro.showToast({ title: '加载失败', icon: 'none' });
     } finally {
-      setLoading(false);
+      setRecordsLoading(false);
     }
   }, []);
 
-  usePageData(async () => { await fetchData(1); }, { throttleMs: 10000, enablePullDown: true });
+  // --- 诊断记录 ---
+  const [diagnoses, setDiagnoses] = useState<Diagnosis[]>([]);
+  const [diagPage, setDiagPage] = useState(1);
+  const [diagTotal, setDiagTotal] = useState(0);
+  const [diagLoading, setDiagLoading] = useState(false);
+  const [diagnosesLoaded, setDiagnosesLoaded] = useState(false);
+
+  const fetchDiagnoses = useCallback(async (p: number, append = false) => {
+    const patientId = getCachedPatientId();
+    if (!patientId) return;
+    setDiagLoading(true);
+    try {
+      const res = await listDiagnoses(patientId, { page: p, page_size: 20 });
+      const list = res.data || [];
+      setDiagnoses(append ? (prev) => [...prev, ...list] : list);
+      setDiagTotal(res.total);
+      setDiagPage(p);
+      setDiagnosesLoaded(true);
+    } catch (err) {
+      console.warn('[diagnoses] 加载失败:', err);
+      Taro.showToast({ title: '加载失败', icon: 'none' });
+    } finally {
+      setDiagLoading(false);
+    }
+  }, []);
+
+  const handleRefresh = useCallback(async () => {
+    if (tab === 'records') {
+      await fetchRecords(1);
+    } else {
+      await fetchDiagnoses(1);
+    }
+  }, [tab, fetchRecords, fetchDiagnoses]);
+
+  const handleTabSwitch = (key: TabKey) => {
+    if (key === tab) return;
+    setTab(key);
+    if (key === 'diagnoses' && !diagnosesLoaded) {
+      fetchDiagnoses(1);
+    }
+  };
+
+  usePageData(handleRefresh, { throttleMs: 10000, enablePullDown: true });
+
+  const currentLoading = tab === 'records' ? recordsLoading : diagLoading;
+  const currentItems = tab === 'records' ? records.length : diagnoses.length;
+  const currentTotal = tab === 'records' ? recordsTotal : diagTotal;
 
   useReachBottom(() => {
-    if (!loading && records.length < total) {
-      fetchData(page + 1, true);
+    if (currentLoading || currentItems >= currentTotal) return;
+    if (tab === 'records') {
+      fetchRecords(recordsPage + 1, true);
+    } else {
+      fetchDiagnoses(diagPage + 1, true);
     }
   });
 
+  const hasPatient = !!getCachedPatientId();
+
   return (
     <PageShell className={modeClass}>
-      <Text className='page-title'>健康记录</Text>
+      <Text className='page-title'>健康档案</Text>
 
-      <View className='record-list'>
-        {records.map((r) => (
-          <View className='record-card' key={r.id}>
-            <View className='record-card__header'>
-              <Text className='record-card__type'>
-                {TYPE_MAP[r.record_type] || r.record_type}
-              </Text>
-              <Text className='record-card__date'>{r.record_date}</Text>
+      <SegmentTabs tabs={TABS} activeKey={tab} onChange={(k) => handleTabSwitch(k as TabKey)} variant="pill" />
+
+      {tab === 'records' && (
+        <View className='record-list'>
+          {records.map((r) => (
+            <View className='record-card' key={r.id}>
+              <View className='record-card__header'>
+                <Text className='record-card__type'>
+                  {RECORD_TYPE_MAP[r.record_type] || r.record_type}
+                </Text>
+                <Text className='record-card__date'>{r.record_date}</Text>
+              </View>
+              {r.overall_assessment && (
+                <Text className='record-card__assessment'>{r.overall_assessment}</Text>
+              )}
+              {r.source && (
+                <Text className='record-card__source'>来源：{r.source}</Text>
+              )}
+              {r.notes && (
+                <Text className='record-card__notes'>{r.notes}</Text>
+              )}
             </View>
-            {r.overall_assessment && (
-              <Text className='record-card__assessment'>{r.overall_assessment}</Text>
-            )}
-            {r.source && (
-              <Text className='record-card__source'>来源：{r.source}</Text>
-            )}
-            {r.notes && (
-              <Text className='record-card__notes'>{r.notes}</Text>
-            )}
-          </View>
-        ))}
-      </View>
-
-      {records.length === 0 && !loading && (
-        <EmptyState text={hasPatient ? '暂无健康记录' : '请先在就诊人管理中选择就诊人'} />
+          ))}
+        </View>
       )}
 
-      {loading && <Loading />}
+      {tab === 'diagnoses' && (
+        <View className='diagnosis-list'>
+          {diagnoses.map((d) => {
+            const typeInfo = DIAG_TYPE_MAP[d.diagnosis_type] || { label: d.diagnosis_type, cls: '' };
+            const statusInfo = DIAG_STATUS_MAP[d.status] || { label: d.status, cls: '' };
+            return (
+              <View className='diagnosis-card' key={d.id}>
+                <View className='diagnosis-card__header'>
+                  <Text className='diagnosis-card__name'>{d.diagnosis_name}</Text>
+                  <Text className={`diagnosis-card__status ${statusInfo.cls}`}>
+                    {statusInfo.label}
+                  </Text>
+                </View>
+                <View className='diagnosis-card__meta'>
+                  <Text className={`diagnosis-card__type ${typeInfo.cls}`}>
+                    {typeInfo.label}
+                  </Text>
+                  <Text className='diagnosis-card__code'>{d.icd_code}</Text>
+                </View>
+                <Text className='diagnosis-card__date'>诊断日期：{d.diagnosed_date}</Text>
+                {d.notes && (
+                  <Text className='diagnosis-card__notes'>{d.notes}</Text>
+                )}
+              </View>
+            );
+          })}
+        </View>
+      )}
+
+      {currentItems === 0 && !currentLoading && (
+        <EmptyState text={hasPatient
+          ? (tab === 'records' ? '暂无健康记录' : '暂无诊断记录')
+          : '请先在就诊人管理中选择就诊人'} />
+      )}
+
+      {currentLoading && <Loading />}
     </PageShell>
   );
 }

apps/miniprogram/src/pages/pkg-profile/reports/index.scss

@@ -1,13 +1,12 @@
 @import '../../../styles/variables.scss';
 @import '../../../styles/mixins.scss';
 
-// PageShell 已接管：min-height, background, padding
-
 .page-title {
   @include section-title;
   padding-left: var(--tk-gap-2xs);
 }
 
+/* ─── 检查报告卡片 ─── */
 .report-list {
   display: flex;
   flex-direction: column;
@@ -80,3 +79,63 @@
   display: block;
   padding-left: 72px;
 }
+
+/* ─── AI 分析卡片 ─── */
+.ai-list {
+  display: flex;
+  flex-direction: column;
+  gap: var(--tk-gap-md);
+}
+
+.ai-card {
+  background: $card;
+  border-radius: $r;
+  padding: var(--tk-card-padding-lg);
+  box-shadow: $shadow-sm;
+
+  &:active {
+    opacity: var(--tk-touch-feedback-opacity);
+  }
+
+  &__header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: var(--tk-gap-xs);
+  }
+
+  &__type {
+    font-size: var(--tk-font-body-lg);
+    font-weight: bold;
+    color: $tx;
+    flex: 1;
+  }
+
+  &__status {
+    font-size: var(--tk-font-cap);
+    padding: 2px 8px;
+    border-radius: $r-pill;
+    font-weight: 600;
+
+    &.completed { background: $acc-l; color: $acc; }
+    &.streaming { background: var(--tk-pri-l); color: var(--tk-pri); }
+    &.failed { background: $dan-l; color: $dan; }
+    &.pending { background: $bd-l; color: $tx2; }
+  }
+
+  &__footer {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+  }
+
+  &__time {
+    font-size: var(--tk-font-cap);
+    color: $tx3;
+  }
+
+  &__model {
+    font-size: var(--tk-font-cap);
+    color: $tx3;
+  }
+}

apps/miniprogram/src/pages/pkg-profile/reports/index.tsx

@@ -5,104 +5,187 @@ import { safeNavigateTo } from '@/utils/navigate';
 import { usePageData } from '@/hooks/usePageData';
 import { getCachedPatientId } from '@/services/request';
 import { listReports, LabReport } from '../../../services/report';
+import { listAiAnalysis, type AiAnalysisItem } from '../../../services/ai-analysis';
 import EmptyState from '../../../components/EmptyState';
 import Loading from '../../../components/Loading';
 import { useElderClass } from '../../../hooks/useElderClass';
 import PageShell from '@/components/ui/PageShell';
+import SegmentTabs from '../../../components/SegmentTabs';
 import './index.scss';
 
+type TabKey = 'reports' | 'ai';
+
+const TABS = [
+  { key: 'reports', label: '检查报告' },
+  { key: 'ai', label: 'AI 解读' },
+] as const;
+
+const AI_TYPE_LABELS: Record<string, string> = {
+  lab_report_interpretation: '化验单解读',
+  health_trend_analysis: '趋势分析',
+  personalized_checkup_plan: '体检方案',
+  report_summary_generation: '报告摘要',
+};
+
+const AI_STATUS_MAP: Record<string, { text: string; cls: string }> = {
+  completed: { text: '已完成', cls: 'completed' },
+  streaming: { text: '分析中', cls: 'streaming' },
+  failed: { text: '失败', cls: 'failed' },
+  pending: { text: '等待中', cls: 'pending' },
+};
+
 export default function MyReports() {
   const modeClass = useElderClass();
-  const [reports, setReports] = useState<LabReport[]>([]);
-  const [page, setPage] = useState(1);
-  const [total, setTotal] = useState(0);
-  const [loading, setLoading] = useState(false);
-  const [hasPatient, setHasPatient] = useState(true);
+  const [tab, setTab] = useState<TabKey>('reports');
 
-  const fetchData = useCallback(async (p: number, append = false) => {
+  // --- 检查报告 ---
+  const [reports, setReports] = useState<LabReport[]>([]);
+  const [reportsPage, setReportsPage] = useState(1);
+  const [reportsTotal, setReportsTotal] = useState(0);
+  const [reportsLoading, setReportsLoading] = useState(false);
+
+  const fetchReports = useCallback(async (p: number, append = false) => {
     const patientId = getCachedPatientId();
-    if (!patientId) {
-      setReports([]);
-      setHasPatient(false);
-      return;
-    }
-    setHasPatient(true);
-    setLoading(true);
+    if (!patientId) return;
+    setReportsLoading(true);
     try {
       const res = await listReports(patientId, p);
       const list = res.data || [];
       setReports(append ? (prev) => [...prev, ...list] : list);
-      setTotal(res.total);
-      setPage(p);
+      setReportsTotal(res.total);
+      setReportsPage(p);
     } catch (err) {
       console.warn('[reports] 加载报告列表失败:', err);
       Taro.showToast({ title: '加载失败', icon: 'none' });
     } finally {
-      setLoading(false);
+      setReportsLoading(false);
     }
   }, []);
 
-  usePageData(async () => { await fetchData(1); }, { throttleMs: 10000, enablePullDown: true });
+  // --- AI 分析 ---
+  const [aiList, setAiList] = useState<AiAnalysisItem[]>([]);
+  const [aiPage, setAiPage] = useState(1);
+  const [aiHasMore, setAiHasMore] = useState(true);
+  const [aiLoading, setAiLoading] = useState(false);
+  const [aiLoaded, setAiLoaded] = useState(false);
+
+  const fetchAiList = useCallback(async (p: number, append = false) => {
+    setAiLoading(true);
+    try {
+      const res = await listAiAnalysis(p, 20);
+      const items = res.data || [];
+      setAiList(append ? (prev) => [...prev, ...items] : items);
+      setAiPage(p);
+      setAiHasMore(items.length >= 20);
+      setAiLoaded(true);
+    } catch (err) {
+      console.warn('[ai-report] 加载分析列表失败:', err);
+      Taro.showToast({ title: '加载失败', icon: 'none' });
+    } finally {
+      setAiLoading(false);
+    }
+  }, []);
+
+  const handleRefresh = useCallback(async () => {
+    if (tab === 'reports') {
+      await fetchReports(1);
+    } else {
+      await fetchAiList(1);
+    }
+  }, [tab, fetchReports, fetchAiList]);
+
+  const handleTabSwitch = (key: TabKey) => {
+    if (key === tab) return;
+    setTab(key);
+    if (key === 'ai' && !aiLoaded) {
+      fetchAiList(1);
+    }
+  };
+
+  usePageData(handleRefresh, { throttleMs: 10000, enablePullDown: true });
+
+  const currentLoading = tab === 'reports' ? reportsLoading : aiLoading;
 
   useReachBottom(() => {
-    if (!loading && reports.length < total) {
-      fetchData(page + 1, true);
+    if (currentLoading) return;
+    if (tab === 'reports') {
+      if (reports.length < reportsTotal) fetchReports(reportsPage + 1, true);
+    } else {
+      if (aiHasMore) fetchAiList(aiPage + 1, true);
     }
   });
 
-  const goToDetail = (id: string) => {
-    safeNavigateTo(`/pages/pkg-profile/reports/detail/index?id=${id}`);
-  };
+  const hasPatient = !!getCachedPatientId();
 
-  const formatStatus = (report: LabReport) => {
+  const formatReportStatus = (report: LabReport) => {
     const items = report.items;
     if (!items || !Array.isArray(items)) return 'unknown';
     const vals = items as Array<{ is_abnormal?: boolean }>;
-    const hasAbnormal = vals.some((v) => v.is_abnormal);
-    return hasAbnormal ? 'abnormal' : 'normal';
-  };
-
-  const typeInitial = (type: string) => {
-    return type ? type.charAt(0) : '报';
+    return vals.some((v) => v.is_abnormal) ? 'abnormal' : 'normal';
   };
 
   return (
     <PageShell className={modeClass}>
-      <Text className='page-title'>检查报告</Text>
+      <Text className='page-title'>我的报告</Text>
 
-      <View className='report-list'>
-        {reports.map((r) => {
-          const status = formatStatus(r);
-          return (
-            <View
-              className='report-card'
-              key={r.id}
-              onClick={() => goToDetail(r.id)}
-            >
-              <View className='report-card-top'>
-                <View className='report-type-row'>
-                  <View className='report-avatar'>
-                    <Text className='report-avatar-text'>{typeInitial(r.report_type)}</Text>
+      <SegmentTabs tabs={TABS} activeKey={tab} onChange={(k) => handleTabSwitch(k as TabKey)} variant="pill" />
+
+      {tab === 'reports' && (
+        <View className='report-list'>
+          {reports.map((r) => {
+            const status = formatReportStatus(r);
+            return (
+              <View className='report-card' key={r.id} onClick={() => safeNavigateTo(`/pages/pkg-profile/reports/detail/index?id=${r.id}`)}>
+                <View className='report-card-top'>
+                  <View className='report-type-row'>
+                    <View className='report-avatar'>
+                      <Text className='report-avatar-text'>{r.report_type ? r.report_type.charAt(0) : '报'}</Text>
+                    </View>
+                    <Text className='report-type'>{r.report_type}</Text>
                   </View>
-                  <Text className='report-type'>{r.report_type}</Text>
+                  <Text className={`report-status ${status}`}>
+                    {status === 'normal' ? '正常' : status === 'abnormal' ? '异常' : '未知'}
+                  </Text>
                 </View>
-                <Text className={`report-status ${status}`}>
-                  {status === 'normal' ? '正常' : status === 'abnormal' ? '异常' : '未知'}
-                </Text>
+                <Text className='report-date'>{r.report_date}</Text>
               </View>
-              <Text className='report-date'>{r.report_date}</Text>
-            </View>
-          );
-        })}
-      </View>
+            );
+          })}
+        </View>
+      )}
 
-      {reports.length === 0 && !loading && (
+      {tab === 'ai' && (
+        <View className='ai-list'>
+          {aiList.map((item) => {
+            const si = AI_STATUS_MAP[item.status] || { text: item.status, cls: '' };
+            return (
+              <View
+                key={item.id}
+                className='ai-card'
+                onClick={() => item.status === 'completed' && safeNavigateTo(`/pages/ai-report/detail/index?id=${item.id}`)}
+              >
+                <View className='ai-card__header'>
+                  <Text className='ai-card__type'>{AI_TYPE_LABELS[item.analysis_type] || item.analysis_type}</Text>
+                  <Text className={`ai-card__status ${si.cls}`}>{si.text}</Text>
+                </View>
+                <View className='ai-card__footer'>
+                  <Text className='ai-card__time'>{new Date(item.created_at).toLocaleString('zh-CN')}</Text>
+                  <Text className='ai-card__model'>{item.model_used}</Text>
+                </View>
+              </View>
+            );
+          })}
+        </View>
+      )}
+
+      {tab === 'reports' && reports.length === 0 && !reportsLoading && (
         <EmptyState text={hasPatient ? '暂无报告记录' : '请先在就诊人管理中选择就诊人'} />
       )}
-
-      {loading && (
-        <Loading />
+      {tab === 'ai' && aiList.length === 0 && !aiLoading && (
+        <EmptyState text='暂无 AI 分析报告' />
       )}
+
+      {currentLoading && <Loading />}
     </PageShell>
   );
 }

apps/miniprogram/src/pages/pkg-profile/settings/index.scss

@@ -65,3 +65,14 @@
   font-family: 'Georgia', 'Times New Roman', serif;
   flex-shrink: 0;
 }
+
+.settings-toggle {
+  font-size: var(--tk-font-cap);
+  color: $tx3;
+  margin-right: var(--tk-gap-xs);
+
+  &.settings-toggle--active {
+    color: var(--tk-pri);
+    font-weight: 600;
+  }
+}

apps/miniprogram/src/pages/pkg-profile/settings/index.tsx

@@ -2,6 +2,7 @@ import { View, Text } from '@tarojs/components';
 import Taro from '@tarojs/taro';
 import { safeNavigateTo } from '@/utils/navigate';
 import { useAuthStore } from '../../../stores/auth';
+import { useUIStore } from '../../../stores/ui';
 import { invalidateHeadersCache, clearRequestCache } from '@/services/request';
 import { useElderClass } from '../../../hooks/useElderClass';
 import PageShell from '@/components/ui/PageShell';
@@ -12,6 +13,8 @@ export default function Settings() {
   const modeClass = useElderClass();
   const logout = useAuthStore((s) => s.logout);
   const isMedicalStaff = useAuthStore((s) => s.isMedicalStaff);
+  const mode = useUIStore((s) => s.mode);
+  const toggleMode = useUIStore((s) => s.toggle);
 
   const handleClearCache = async () => {
     const { confirm } = await Taro.showModal({
@@ -72,6 +75,16 @@ export default function Settings() {
       <Text className='page-title'>设置</Text>
 
       <View className='settings-group'>
+        <View className='settings-item' onClick={toggleMode}>
+          <View className='settings-icon'>
+            <Text className='settings-icon-text'>老</Text>
+          </View>
+          <Text className='settings-label'>长辈模式</Text>
+          <Text className={`settings-toggle ${mode === 'elder' ? 'settings-toggle--active' : ''}`}>
+            {mode === 'elder' ? '已开启' : '未开启'}
+          </Text>
+          <Text className='settings-arrow'>{'>'}</Text>
+        </View>
         <View className='settings-item' onClick={handleClearCache}>
           <View className='settings-icon'>
             <Text className='settings-icon-text'>缓</Text>

apps/miniprogram/src/services/analytics.ts

@@ -66,6 +66,7 @@ function persistQueue(): void {
 }
 
 export function trackEvent(event: EventName | string, properties?: Record<string, unknown>): void {
+  if (flushDisabled) return;
   loadQueue();
   const evt: AnalyticsEvent = {
     event,
@@ -89,7 +90,10 @@ export function trackPageView(pageName: string, properties?: Record<string, unkn
   trackEvent('page_view', { page: pageName, ...properties });
 }
 
+let flushDisabled = false;
+
 export async function flushEvents(): Promise<void> {
+  if (flushDisabled) return;
   loadQueue();
   if (memoryQueue.length === 0) return;
 
@@ -99,9 +103,16 @@ export async function flushEvents(): Promise<void> {
 
   try {
     await api.post('/analytics/batch', { events: batch });
-  } catch (e) {
-    // 静默失败，不打印错误避免控制台洪泛
-    void e;
+  } catch (e: unknown) {
+    const msg = e instanceof Error ? e.message : String(e);
+    if (msg === '权限不足' || msg === '登录已过期') {
+      // 权限不足或未认证，停止后续 flush 并丢弃队列
+      flushDisabled = true;
+      memoryQueue = [];
+      persistQueue();
+      return;
+    }
+    // 其他错误（网络等）保留队列重试
     memoryQueue = [...batch.slice(-MAX_QUEUE_SIZE), ...memoryQueue].slice(-MAX_QUEUE_SIZE);
     persistQueue();
   }
@@ -111,3 +122,8 @@ export function getQueueSize(): number {
   loadQueue();
   return memoryQueue.length;
 }
+
+/** 登录/切换用户时调用，重新启用 flush */
+export function resetAnalyticsDisabled(): void {
+  flushDisabled = false;
+}

apps/miniprogram/src/services/article.ts

@@ -1,3 +1,4 @@
+import Taro from '@tarojs/taro';
 import { api } from './request';
 
 export interface Article {
@@ -41,6 +42,46 @@ export function buildCategoryTree(flat: ArticleCategory[]): ArticleCategory[] {
   return roots;
 }
 
+/** 获取默认 tenant_id（用于公开 API 调用） */
+function getDefaultTenantId(): string {
+  return Taro.getStorageSync('tenant_id') || process.env.TARO_APP_DEFAULT_TENANT_ID || '';
+}
+
+// ---------------------------------------------------------------------------
+// 公开端点（无需认证，游客可访问）
+// ---------------------------------------------------------------------------
+
+export async function listPublicArticles(params?: {
+  page?: number;
+  page_size?: number;
+  category_id?: string;
+  tag_id?: string;
+  keyword?: string;
+}) {
+  const tenantId = getDefaultTenantId();
+  return api.get<{ data: Article[]; total: number }>('/public/articles', {
+    tenant_id: tenantId,
+    page: params?.page ?? 1,
+    page_size: params?.page_size ?? 20,
+    ...params,
+  });
+}
+
+export async function listPublicCategories() {
+  const tenantId = getDefaultTenantId();
+  return api.get<ArticleCategory[]>('/public/article-categories', {
+    tenant_id: tenantId,
+  });
+}
+
+export async function getPublicArticleDetail(id: string) {
+  return api.get<Article>(`/public/articles/${id}`);
+}
+
+// ---------------------------------------------------------------------------
+// 认证端点（需要登录）
+// ---------------------------------------------------------------------------
+
 export async function listArticles(params?: {
   page?: number;
   page_size?: number;
@@ -60,11 +101,6 @@ export async function getArticleDetail(id: string) {
   return api.get<Article>(`/health/articles/${id}`);
 }
 
-/** 公开文章详情（无需认证） */
-export async function getPublicArticleDetail(id: string) {
-  return api.get<Article>(`/public/articles/${id}`);
-}
-
 export async function listCategories() {
   return api.get<ArticleCategory[]>('/health/article-categories');
 }

apps/miniprogram/src/services/auth.ts

@@ -68,7 +68,9 @@ export interface PatientSummary {
 }
 
 /** 获取患者摘要列表（字段最小化，替代 getPatients） */
-export async function getPatientSummaries() {
-  const res = await api.get<PaginatedData<PatientSummary>>('/health/patients/summary');
+export async function getPatientSummaries(userId?: string) {
+  const params: Record<string, string> = {};
+  if (userId) params.user_id = userId;
+  const res = await api.get<PaginatedData<PatientSummary>>('/health/patients/summary', { params });
   return Array.isArray(res?.data) ? res.data : (Array.isArray(res) ? res : []);
 }

apps/miniprogram/src/services/ble/BLEConnection.ts

@@ -7,6 +7,8 @@ import type {
   BLEConnectionChangeResult,
   BLECharacteristicChangeResult,
   BLEServiceItem,
+  BLEDiscoveredService,
+  BLEDiscoveredCharacteristic,
 } from './types';
 
 /** BLE 连接管理 — 封装连接/断开/服务发现/通知订阅/数据监听 */
@@ -121,10 +123,24 @@ export class BLEConnection {
     }
   }
 
-  /** 发现服务并启用通知 */
+  /** 已知的健康相关 Characteristic UUID（用于自动发现和订阅） */
+  private static readonly HEALTH_CHAR_UUIDS: Record<string, string> = {
+    '2A37': 'heart_rate',       // Heart Rate Measurement
+    '2A38': 'heart_rate_loc',   // Body Sensor Location
+    '2A1C': 'temperature',      // Temperature Measurement
+    '2A35': 'blood_pressure',   // Blood Pressure Measurement
+    '2A5F': 'blood_oxygen',     // PLX Continuous Measurement
+    '2A5E': 'blood_oxygen_spot',// PLX Spot-Check Measurement
+  };
+
+  /** 发现服务并启用通知 — 先订阅适配器指定的，再扫描全部服务尝试自动发现 */
   private async discoverServices(device: BLEDevice): Promise<void> {
     const servicesRes = await Taro.getBLEDeviceServices({ deviceId: device.deviceId });
     const services = servicesRes.services || [];
+    const discoveredServices: BLEDiscoveredService[] = [];
+
+    // ── 第一轮：订阅适配器预定义的 Characteristic（保持向后兼容） ──
+    const subscribedCharUUIDs = new Set<string>();
 
     for (const { service: svcUUID, characteristic: charUUID } of device.adapter!.notifyCharacteristics) {
       const svc = services.find((s: BLEServiceItem) =>
@@ -137,13 +153,90 @@ export class BLEConnection {
         serviceId: svc.uuid,
       });
 
-      await Taro.notifyBLECharacteristicValueChange({
-        deviceId: device.deviceId,
-        serviceId: svc.uuid,
-        characteristicId: charUUID,
-        state: true,
+      try {
+        await Taro.notifyBLECharacteristicValueChange({
+          deviceId: device.deviceId,
+          serviceId: svc.uuid,
+          characteristicId: charUUID,
+          state: true,
+        });
+        subscribedCharUUIDs.add(charUUID.toUpperCase().replace(/-/g, '').slice(-4));
+        console.log(`[ble] 已订阅适配器预定义: ${svcUUID} / ${charUUID}`);
+      } catch (err) {
+        console.warn(`[ble] 订阅失败 (预定义): ${charUUID}`, err);
+      }
+    }
+
+    // ── 第二轮：扫描全部服务，发现并订阅健康相关 Characteristic ──
+    for (const svc of services) {
+      const svcUUID = svc.uuid.toUpperCase();
+      const discoveredChars: BLEDiscoveredCharacteristic[] = [];
+
+      let charsRes: Taro.getBLEDeviceCharacteristics.SuccessCallbackResult;
+      try {
+        charsRes = await Taro.getBLEDeviceCharacteristics({
+          deviceId: device.deviceId,
+          serviceId: svc.uuid,
+        });
+      } catch (err) {
+        console.warn(`[ble] 读取特征列表失败: ${svcUUID}`, err);
+        continue;
+      }
+
+      const characteristics = charsRes.characteristics || [];
+
+      for (const char of characteristics) {
+        const charUUIDShort = char.uuid.toUpperCase().replace(/-/g, '').slice(-4);
+        const props = char.properties || {};
+
+        const discoveredChar: BLEDiscoveredCharacteristic = {
+          uuid: char.uuid,
+          properties: {
+            read: !!props.read,
+            write: !!props.write,
+            notify: !!props.notify,
+            indicate: !!props.indicate,
+          },
+        };
+        discoveredChars.push(discoveredChar);
+
+        // 如果是已知的健康 UUID 且尚未订阅，尝试订阅
+        if (
+          BLEConnection.HEALTH_CHAR_UUIDS[charUUIDShort] &&
+          !subscribedCharUUIDs.has(charUUIDShort) &&
+          (props.notify || props.indicate)
+        ) {
+          try {
+            await Taro.notifyBLECharacteristicValueChange({
+              deviceId: device.deviceId,
+              serviceId: svc.uuid,
+              characteristicId: char.uuid,
+              state: true,
+            });
+            subscribedCharUUIDs.add(charUUIDShort);
+            console.log(`[ble] 自动发现并订阅: ${BLEConnection.HEALTH_CHAR_UUIDS[charUUIDShort]} (${svcUUID} / ${char.uuid})`);
+          } catch (err) {
+            console.warn(`[ble] 自动订阅失败: ${char.uuid}`, err);
+          }
+        }
+      }
+
+      discoveredServices.push({
+        uuid: svc.uuid,
+        isPrimary: !!svc.isPrimary,
+        characteristics: discoveredChars,
       });
     }
+
+    // 存储发现结果到连接信息
+    if (this.conn) {
+      this.conn = { ...this.conn, discoveredServices };
+    }
+
+    console.log(`[ble] 服务发现完成: ${discoveredServices.length} 个服务, 已订阅 ${subscribedCharUUIDs.size} 个特征`);
+    console.log(`[ble] 已订阅的健康特征:`, [...subscribedCharUUIDs].map(
+      (s) => `${s}(${BLEConnection.HEALTH_CHAR_UUIDS[s] ?? '未知'})`
+    ).join(', '));
   }
 
   /** 手动读取特征值 */

apps/miniprogram/src/services/ble/BLEManager.ts

@@ -70,10 +70,13 @@ export class BLEManager {
 
   /** 初始化蓝牙适配器 */
   async initialize(): Promise<void> {
+    console.log('[ble] 步骤1: 开始初始化蓝牙适配器...');
     try {
       await Taro.openBluetoothAdapter();
+      console.log('[ble] 步骤1: 蓝牙适配器初始化成功');
     } catch (e: unknown) {
       const errMsg = e instanceof Error ? e.message : (e as { errMsg?: string })?.errMsg || '蓝牙初始化失败，请检查蓝牙是否开启';
+      console.error('[ble] 步骤1: 蓝牙初始化失败:', errMsg);
       throw new Error(errMsg);
     }
   }
@@ -83,38 +86,61 @@ export class BLEManager {
     await this.initialize();
 
     const discovered = new Map<string, BLEDevice>();
+    const allModelKeywords = this.adapters.flatMap((a) => a.supportedModels);
+
+    console.log('[ble] 步骤2: 注册的适配器:', this.adapters.map((a) => a.name));
+    console.log('[ble] 步骤2: 匹配关键词:', allModelKeywords);
+
+    let scanDeviceCount = 0;
 
     const onFound = (res: BLEScanResult) => {
-      for (const device of res.devices || []) {
+      const devices = res.devices || [];
+      scanDeviceCount += devices.length;
+
+      for (const device of devices) {
         const name = device.name || device.localName || '';
         if (!name) continue;
         const adapter = this.matchAdapter(name);
-        if (adapter) {
-          discovered.set(device.deviceId, {
-            deviceId: device.deviceId,
-            name,
-            RSSI: device.RSSI ?? 0,
-            localName: device.localName,
-            advertisData: device.advertisData,
-            adapter,
-          });
+
+        // 每个新发现的设备都打印（最多前 30 个避免日志爆炸）
+        if (discovered.size < 30 && !discovered.has(device.deviceId)) {
+          console.log(`[ble] 发现设备: "${name}" (RSSI:${device.RSSI ?? '?'}, 匹配:${adapter?.name ?? '无'})`);
         }
+
+        discovered.set(device.deviceId, {
+          deviceId: device.deviceId,
+          name,
+          RSSI: device.RSSI ?? 0,
+          localName: device.localName,
+          advertisData: device.advertisData,
+          adapter: adapter ?? undefined,
+        });
       }
     };
 
     Taro.onBluetoothDeviceFound(onFound);
 
-    const allServiceUUIDs = this.adapters.flatMap((a) => a.serviceUUIDs);
+    console.log('[ble] 步骤3: 开始扫描 (超时', this.config.scanTimeout, 'ms)...');
+    // 不传 services 参数 — 扫描所有 BLE 设备，避免设备使用私有 UUID 被过滤掉
     await Taro.startBluetoothDevicesDiscovery({
       allowDuplicatesKey: false,
-      services: allServiceUUIDs.length > 0 ? allServiceUUIDs : undefined,
     });
 
     return new Promise((resolve) => {
       this.scanTimer = setTimeout(async () => {
         await this.stopScan();
         Taro.offBluetoothDeviceFound(onFound);
-        resolve(Array.from(discovered.values()));
+
+        const results = Array.from(discovered.values());
+        console.log('[ble] 步骤4: 扫描结束');
+        console.log('[ble] 回调触发设备总数:', scanDeviceCount);
+        console.log('[ble] 有名称的设备数:', discovered.size);
+        console.log('[ble] 最终返回设备数:', results.length);
+        if (results.length > 0) {
+          console.log('[ble] 设备列表:', results.map((d) => `${d.name} (${d.adapter?.name ?? '无适配器'})`));
+        }
+
+        resolve(results);
       }, this.config.scanTimeout);
     });
   }

apps/miniprogram/src/services/ble/VeepooBridge.ts

@@ -0,0 +1,305 @@
+/**
+ * Veepoo SDK 桥接模块
+ *
+ * 调用顺序（基于 SDK Demo 验证）：
+ * 1. startScan() — 初始化蓝牙 + 扫描
+ * 2. stopScan() — 找到设备后停止扫描
+ * 3. connectDevice(deviceObj) — 传入完整设备对象（非 deviceId 字符串）
+ * 4. registerDataListener() — 连接成功后注册数据监听
+ * 5. authenticate() — 延迟 500ms 后调用秘钥认证
+ * 6. 认证结果通过数据监听回调 type=1 返回
+ */
+
+// @ts-ignore — SDK 类型声明为 any
+import { veepooBle, veepooFeature, veepooLogger } from './veepoo-sdk';
+
+// ── SDK 事件类型常量 ──
+
+/** 秘钥认证结果 */
+export const SDK_EVENT_AUTH = 1;
+/** 日常数据 */
+export const SDK_EVENT_DAILY = 5;
+/** 体温检测 */
+export const SDK_EVENT_TEMPERATURE = 6;
+/** 血压 */
+export const SDK_EVENT_BLOOD_PRESSURE = 18;
+/** 血氧手动测量 */
+export const SDK_EVENT_BLOOD_OXYGEN = 31;
+/** 心率测量 */
+export const SDK_EVENT_HEART_RATE = 51;
+/** 压力测量 */
+export const SDK_EVENT_PRESSURE = 58;
+
+/** 设备正忙状态枚举（SDK state 字段） */
+export const DEVICE_STATE = {
+  IDLE: 0,
+  MEASURING_BP: 1,
+  MEASURING_HR: 2,
+  AUTO_TEST: 3,
+  MEASURING_SPO2: 4,
+  MEASURING_FATIGUE: 5,
+  NOT_WORN: 6,
+  CHARGING: 7,
+  LOW_BATTERY: 8,
+  BUSY: 9,
+} as const;
+
+/** 连接回调中 connection 字段为 true 表示连接成功 */
+export interface VeepooConnectionResult {
+  connection?: boolean;
+  errno?: number;
+  errCode?: number;
+  errMsg?: string;
+}
+
+/** SDK 事件回调数据（统一格式） */
+export interface SdkEventData {
+  name: string;
+  type: number;
+  content: Record<string, unknown>;
+  Progress?: number;
+  state?: number;
+  control?: number;
+  ack?: number;
+}
+
+// ── 蓝牙模块 ──
+
+/** 初始化蓝牙 + 开始扫描 */
+export function startScan(onDeviceFound: (device: unknown) => void): void {
+  veepooBle.veepooWeiXinSDKStartScanDeviceAndReceiveScanningDevice(
+    (res: unknown) => {
+      const device = Array.isArray(res) ? res[0] : res;
+      if (device) onDeviceFound(device);
+    },
+  );
+}
+
+/** 停止扫描 */
+export function stopScan(): Promise<void> {
+  return new Promise((resolve) => {
+    veepooBle.veepooWeiXinSDKStopSearchBleManager(() => resolve());
+  });
+}
+
+/** 连接设备 — 传入完整设备对象 */
+export function connectDevice(device: unknown): Promise<VeepooConnectionResult> {
+  return new Promise((resolve) => {
+    veepooBle.veepooWeiXinSDKBleConnectionServicesCharacteristicsNotifyManager(
+      device,
+      (res: VeepooConnectionResult) => resolve(res),
+    );
+  });
+}
+
+/** 注册数据监听（必须在连接成功后调用） */
+export function registerDataListener(callback: (data: SdkEventData) => void): void {
+  veepooBle.veepooWeiXinSDKNotifyMonitorValueChange(callback);
+}
+
+/** 监听蓝牙连接状态变化 */
+export function registerConnectionListener(callback: (res: { deviceId: string; connected: boolean }) => void): void {
+  veepooBle.veepooWeiXinSDKBLEConnectionStateChangeManager(callback);
+}
+
+/** 断开连接 */
+export function disconnect(): Promise<void> {
+  return new Promise((resolve) => {
+    veepooBle.veepooWeiXinSDKloseBluetoothAdapterManager(() => resolve());
+  });
+}
+
+// ── 功能模块：认证 ──
+
+/** 秘钥认证（无参数无回调，结果通过数据监听 type=1 返回） */
+export function authenticate(): void {
+  veepooFeature.veepooBlePasswordCheckManager();
+}
+
+// ── 功能模块：测量指令 ──
+
+/** 心率测量开关（true=开启，false=关闭） */
+export function setHeartRateMeasure(on: boolean): void {
+  veepooFeature.veepooSendHeartRateTestSwitchManager({ switch: on });
+}
+
+/** 血氧测量开关（'start'=开启，'stop'=关闭） */
+export function setBloodOxygenMeasure(action: 'start' | 'stop'): void {
+  veepooFeature.veepooSendBloodOxygenControlDataManager({ switch: action });
+}
+
+/** 血压测量开关（'start'=开启，'stop'=关闭） */
+export function setBloodPressureMeasure(action: 'start' | 'stop'): void {
+  veepooFeature.veepooSendReadUniversalBloodPressureDataManager({ switch: action });
+}
+
+/** 体温测量（单次触发） */
+export function startTemperatureMeasure(): void {
+  veepooFeature.veepooSendTemperatureMeasurementSwitchManager();
+}
+
+/** 压力测量开关（true=开启，false=关闭） */
+export function setPressureMeasure(on: boolean): void {
+  veepooFeature.veepooSendPressureTestManager({ switch: on });
+}
+
+// ── 功能模块：日常数据 ──
+
+/** 读取日常数据（day: 0=今天, 1=昨天, 2=前天；package: 开始包序号，默认1） */
+export function readDailyData(day: number, pkg: number = 1): void {
+  veepooFeature.veepooSendReadDailyDataManager({ day, package: pkg });
+}
+
+// ── 功能模块：精准睡眠数据 ──
+
+/** 精准睡眠事件类型 */
+export const SDK_EVENT_SLEEP = 4;
+
+/** 精准睡眠数据（SDK 回调 type=4） */
+export interface SleepData {
+  /** 入睡时间（时间戳字符串） */
+  fallAsleepTime: string;
+  /** 退出睡眠时间（时间戳字符串） */
+  exitSleepTime: string;
+  /** 起夜得分 */
+  nightScore: number;
+  /** 深睡得分 */
+  deepSleepScore: number;
+  /** 睡眠效率得分 */
+  sleepEfficiencyScore: number;
+  /** 入睡效率得分 */
+  fallAsleepEfficiencyScore: number;
+  /** 睡眠时长得分 */
+  sleepTimeScore: number;
+  /** 睡眠质量（1-5 星） */
+  sleepQuality: number;
+  /** 深睡时长（分钟） */
+  deepSleepTime: number;
+  /** 浅睡时长（分钟） */
+  lightSleepTime: number;
+  /** 其他睡眠时长（分钟） */
+  otherSleepTime: number;
+  /** 睡眠总时长（分钟） */
+  sleepTotalTime: number;
+  /** 首次深睡眠时长（分钟） */
+  firstDeepSleepTime: number;
+  /** 起夜总时长（分钟） */
+  nightTotalTime: number;
+  /** 起夜到深睡均值 */
+  nightDeepSleepMeanValue: number;
+  /** 失眠得分 */
+  insomniaScore: number;
+  /** 失眠次数 */
+  insomniaCount: number;
+  /** 睡眠曲线字符串（0=深睡, 1=浅睡, 2=REM, 3=失眠, 4=苏醒） */
+  sleepCurve: string;
+}
+
+/** 读取精准睡眠数据（day: 0=今天, 1=昨天, 2=前天） */
+export function readPreciseSleepData(day: number): void {
+  veepooFeature.veepooSendReadPreciseSleepManager({ day });
+}
+
+// ── 功能模块：自动测量（B3） ──
+
+/** 自动测量事件类型 */
+export const SDK_EVENT_AUTO_TEST = 54;
+
+/** B3 自动测量功能类型枚举 */
+export const AUTO_TEST_FUN_TYPES = {
+  PULSE_RATE: 0,       // 脉率
+  BLOOD_PRESSURE: 1,   // 血压
+  BLOOD_GLUCOSE: 2,    // 血糖
+  PRESSURE: 3,         // 压力
+  BLOOD_OXYGEN: 4,     // 血氧
+  TEMPERATURE: 5,      // 体温
+  LORENTZ_SCATTER: 6,  // 洛伦兹散点图
+  HRV: 7,              // HRV
+  BLOOD_COMPONENT: 8,  // 血液成分
+} as const;
+
+export type AutoTestFunType = (typeof AUTO_TEST_FUN_TYPES)[keyof typeof AUTO_TEST_FUN_TYPES];
+
+/** B3 自动测量配置项 */
+export interface AutoTestConfig {
+  /** 协议类型（不可修改） */
+  protocolType: number;
+  /** 功能类型 0-8（可修改） */
+  funTypeContent: AutoTestFunType;
+  /** 开关：0=关闭, 1=开启 */
+  funSwitch: number;
+  /** 最小步进（分钟） */
+  stepUnit: number;
+  /** 是否支持时间段修改 */
+  timeSlotModify: number;
+  /** 是否支持时间间隔修改 */
+  timeIntervalModify: number;
+  /** 支持的测试时间段 */
+  supportTimeSlot: { startTime: string; stopTime: string };
+  /** 测量间隔（分钟，按 stepUnit 递增） */
+  measInterval: number;
+  /** 当前测试时间段 */
+  currentTimeSlot: { startTime: string; stopTime: string };
+}
+
+/** 读取自动测量功能配置 */
+export function readAutoTestConfig(): void {
+  veepooFeature.veepooSendReadB3AutoTestFeatureDataManager();
+}
+
+/** 设置自动测量功能 */
+export function setAutoTestConfig(config: AutoTestConfig): void {
+  veepooFeature.veepooSendSetupB3AutoTestFeatureDataManager({
+    p_protocol_type: config.protocolType,
+    p_fun_type_content: config.funTypeContent,
+    p_fun_switch: config.funSwitch,
+    p_step_unit: config.stepUnit,
+    p_time_slot_modify: config.timeSlotModify,
+    p_time_interval_modify: config.timeIntervalModify,
+    p_support_time_slot: config.supportTimeSlot,
+    p_meas_inv: config.measInterval,
+    p_cur_time_slot: config.currentTimeSlot,
+  });
+}
+
+// ── 功能模块：开关设置 ──
+
+/** 自动心率监测开关 */
+export function setAutoHeartRate(enabled: boolean): void {
+  veepooFeature.veepooSendSwitchSettingDataManager({
+    VPSettingAutomaticHRTest: enabled ? 'open' : 'close',
+  });
+}
+
+/** 自动血压监测开关 */
+export function setAutoBloodPressure(enabled: boolean): void {
+  veepooFeature.veepooSendSwitchSettingDataManager({
+    VPSettingAutomaticBPTest: enabled ? 'open' : 'close',
+  });
+}
+
+/** 体温自动监测 */
+export function setAutoTemperature(enabled: boolean): void {
+  veepooFeature.veepooSendSwitchSettingDataManager({
+    VPSettingAutomaticTemperatureTest: enabled ? 'open' : 'close',
+  });
+}
+
+/** 读取体温自动监测数据 */
+export function readAutoTemperatureData(): void {
+  veepooFeature.veepooReadAutoTemperatureMeasurementDataManager({ day: 0 });
+}
+
+// ── 功能模块：设备信息 ──
+
+/** 读取设备电量 */
+export function readBatteryLevel(): void {
+  veepooFeature.veepooReadElectricQuantityManager();
+}
+
+// ── 日志模块 ──
+
+/** 设置日志级别（0=DEBUG, 1=INFO, 2=WARN, 3=ERROR, 4=NONE） */
+export function setLogLevel(level: number): void {
+  veepooLogger.setLevel(level);
+}

apps/miniprogram/src/services/ble/adapters/GenericBleAdapter.ts

@@ -23,8 +23,44 @@ const SERVICES: Record<string, { uuid: string; chars: { notify: string; read: st
       read: '00002A35-0000-1000-8000-00805F9B34FB',
     },
   },
+  pulse_oximeter: {
+    uuid: '00001822-0000-1000-8000-00805F9B34FB',
+    chars: {
+      // PLX Continuous Measurement — 实时血氧+脉率
+      notify: '00002A5F-0000-1000-8000-00805F9B34FB',
+      // PLX Spot-Check Measurement — 单次测量
+      read: '00002A5E-0000-1000-8000-00805F9B34FB',
+    },
+  },
 };
 
+// ── IEEE 11073 SFLOAT 解析（Bluetooth SIG 医疗 Profile 通用格式） ──
+
+/** 特殊 SFLOAT 值 */
+const SFLOAT_NAN = 0x07FF;
+const SFLOAT_NRES = 0x0800;
+const SFLOAT_POS_INF = 0x07FE;
+const SFLOAT_NEG_INF = 0x0802;
+
+function parseSFLOAT(view: DataView, offset: number): number | null {
+  if (offset + 2 > view.byteLength) return null;
+  const raw = view.getUint16(offset, true);
+
+  if (raw === SFLOAT_NAN || raw === SFLOAT_NRES) return null;
+  if (raw === SFLOAT_POS_INF) return Infinity;
+  if (raw === SFLOAT_NEG_INF) return -Infinity;
+
+  const signM = (raw >> 15) & 0x01;
+  const exp = (raw >> 12) & 0x07;
+  const mantissa = raw & 0x0FFF;
+
+  // 指数用 3 位补码表示（0-3 正，4-7 负）
+  const exponent = exp >= 4 ? exp - 8 : exp;
+  const signedMantissa = signM ? -(mantissa ^ 0x0FFF) - 1 : mantissa;
+
+  return signedMantissa * Math.pow(10, exponent);
+}
+
 // ── 解析器 ──
 
 function parseHeartRate(data: ArrayBuffer): NormalizedReading | null {
@@ -66,6 +102,39 @@ function parseTemperature(data: ArrayBuffer): NormalizedReading | null {
   };
 }
 
+/**
+ * 解析 Pulse Oximeter Service 数据
+ * PLX Continuous Measurement (0x2A5F) 和 Spot-Check (0x2A5E) 共用
+ * 格式: Flags(1B) + SpO2(SFLOAT 2B) + PulseRate(SFLOAT 2B) + optional...
+ */
+function parsePulseOximeter(data: ArrayBuffer): NormalizedReading[] {
+  const view = new DataView(data);
+  if (view.byteLength < 5) return [];
+
+  const spO2 = parseSFLOAT(view, 1);
+  const pulseRate = parseSFLOAT(view, 3);
+  const now = new Date().toISOString();
+  const results: NormalizedReading[] = [];
+
+  if (spO2 !== null && spO2 >= 0 && spO2 <= 100) {
+    results.push({
+      device_type: 'blood_oxygen',
+      values: { blood_oxygen: Math.round(spO2), unit: '%' },
+      measured_at: now,
+    });
+  }
+
+  if (pulseRate !== null && pulseRate > 0 && pulseRate <= 300) {
+    results.push({
+      device_type: 'heart_rate',
+      values: { heart_rate: Math.round(pulseRate) },
+      measured_at: now,
+    });
+  }
+
+  return results;
+}
+
 // ── 工厂函数 ──
 
 export interface GenericAdapterConfig {
@@ -100,20 +169,23 @@ export function createGenericBleAdapter(config: GenericAdapterConfig): DeviceAda
     ): NormalizedReading[] {
       const upper = charUUID.toUpperCase();
 
-      // Heart Rate Measurement
-      const hrsChar = SERVICES.heart_rate.chars.notify.toUpperCase();
-      if (upper === hrsChar || upper.includes('2A37')) {
+      // Heart Rate Measurement (0x2A37)
+      if (upper.includes('2A37')) {
         const result = parseHeartRate(data);
         return result ? [result] : [];
       }
 
-      // Temperature Measurement
-      const htChar = SERVICES.health_thermometer.chars.notify.toUpperCase();
-      if (upper === htChar || upper.includes('2A1C')) {
+      // Temperature Measurement (0x2A1C)
+      if (upper.includes('2A1C')) {
         const result = parseTemperature(data);
         return result ? [result] : [];
       }
 
+      // Pulse Oximeter Continuous (0x2A5F) / Spot-Check (0x2A5E)
+      if (upper.includes('2A5F') || upper.includes('2A5E')) {
+        return parsePulseOximeter(data);
+      }
+
       return [];
     },
 
@@ -142,4 +214,30 @@ export const CustomBandAdapter = createGenericBleAdapter({
   profiles: ['heart_rate', 'health_thermometer'],
 });
 
+/** 华为手环/手表 BLE 适配器 */
+export const HuaweiBandAdapter = createGenericBleAdapter({
+  name: 'Huawei Band',
+  supportedModels: [
+    'HUAWEI Band',
+    'HUAWEI Watch',
+    'Huawei Band',
+    'Huawei Watch',
+    'HW-B',
+    'HUAW',
+    '华为手环',
+    '华为手表',
+  ],
+  profiles: ['heart_rate', 'health_thermometer', 'pulse_oximeter'],
+});
+
+/**
+ * 万能 fallback 适配器 — 匹配所有有名称的设备
+ * 尝试标准 BLE 健康协议（心率/体温/血压），设备不支持的服务会被安全跳过
+ */
+export const FallbackAdapter = createGenericBleAdapter({
+  name: '通用设备',
+  supportedModels: [],  // 不参与 matchAdapter，仅作为 fallback
+  profiles: ['heart_rate', 'health_thermometer', 'blood_pressure'],
+});
+
 export default CustomBandAdapter;

apps/miniprogram/src/services/ble/adapters/index.ts

@@ -1,4 +1,4 @@
 export { XiaomiBandAdapter } from './XiaomiBandAdapter';
 export { BloodPressureAdapter } from './BloodPressureAdapter';
 export { GlucoseMeterAdapter } from './GlucoseMeterAdapter';
-export { CustomBandAdapter, createGenericBleAdapter } from './GenericBleAdapter';
+export { CustomBandAdapter, HuaweiBandAdapter, FallbackAdapter, createGenericBleAdapter } from './GenericBleAdapter';

apps/miniprogram/src/services/ble/types.ts

@@ -72,6 +72,8 @@ export interface BLEConnection {
   adapter: DeviceAdapter;
   connectedAt?: number;
   error?: string;
+  /** 连接后扫描到的全部服务（用于调试和展示） */
+  discoveredServices?: BLEDiscoveredService[];
 }
 
 /** 同步操作结果 */
@@ -96,7 +98,20 @@ export interface BLEManagerConfig {
 export type GenericBLEProfile =
   | 'heart_rate'       // Heart Rate Service (0x180D)
   | 'health_thermometer' // Health Thermometer Service (0x1809)
-  | 'blood_pressure';  // Blood Pressure Service (0x1810)
+  | 'blood_pressure'   // Blood Pressure Service (0x1810)
+  | 'pulse_oximeter';  // Pulse Oximeter Service (0x1822)
+
+/** BLE 服务发现结果（连接后扫描到的全部服务/特征） */
+export interface BLEDiscoveredCharacteristic {
+  uuid: string;
+  properties: { read: boolean; write: boolean; notify: boolean; indicate: boolean };
+}
+
+export interface BLEDiscoveredService {
+  uuid: string;
+  isPrimary: boolean;
+  characteristics: BLEDiscoveredCharacteristic[];
+}
 
 /** 微信 BLE 扫描回调结果 */
 export interface BLEScanResult {

apps/miniprogram/src/services/ble/veepoo/VeepooHistoryReader.ts

@@ -0,0 +1,245 @@
+/**
+ * Veepoo 历史数据读取器 — 3天日常数据分批读取 + 上传
+ *
+ * SDK 日常数据格式（type=5）：
+ * - 包含计步、心率、血压、血氧、睡眠、压力、体温等
+ * - Progress 字段 1-100% 表示读取进度
+ * - 每次回调可能包含一包数据
+ */
+
+import Taro from '@tarojs/taro';
+import { readDailyData } from '../VeepooBridge';
+import type { SdkEventData } from '../VeepooBridge';
+import type { NormalizedReading } from '../types';
+import type { SleepReading } from './types';
+import { uploadReadings } from '@/services/device-sync';
+
+const CHECKPOINT_KEY = 'veepoo_history_checkpoint';
+const UPLOAD_BATCH_SIZE = 20;
+
+interface Checkpoint {
+  lastProgress: number;
+  packagesRead: number;
+  deviceId: string;
+  timestamp: number;
+}
+
+export type HistoryReadPhase = 'idle' | 'reading' | 'uploading' | 'done' | 'error';
+
+export class VeepooHistoryReader {
+  private phase: HistoryReadPhase = 'idle';
+  private progress = 0;
+  private packagesRead = 0;
+  private buffer: NormalizedReading[] = [];
+  private day = 0;
+  private patientId = '';
+  private deviceId = '';
+  private onProgress?: (progress: number, phase: HistoryReadPhase) => void;
+  private uploadedCount = 0;
+
+  setCallbacks(cbs: { onProgress?: (progress: number, phase: HistoryReadPhase) => void }): void {
+    this.onProgress = cbs.onProgress;
+  }
+
+  /** 开始读取3天数据 */
+  async startRead(patientId: string, deviceId: string): Promise<number> {
+    this.patientId = patientId;
+    this.deviceId = deviceId;
+    this.buffer = [];
+    this.uploadedCount = 0;
+    this.phase = 'reading';
+
+    // 依次读取 3 天数据
+    for (let day = 0; day < 3; day++) {
+      this.day = day;
+      this.progress = 0;
+      this.onProgress?.(0, 'reading');
+
+      await this.readDay(day);
+
+      // 刷新剩余 buffer
+      if (this.buffer.length > 0) {
+        await this.flushBuffer();
+      }
+    }
+
+    this.phase = 'done';
+    this.onProgress?.(100, 'done');
+    this.clearCheckpoint();
+
+    return this.uploadedCount;
+  }
+
+  /** 读取单天数据 */
+  private readDay(day: number): Promise<void> {
+    return new Promise((resolve) => {
+      // 发送读取指令
+      readDailyData(day, 1);
+
+      // 进度通过 handleDailyEvent 更新
+      // Progress=100 时 resolve
+      this.dayResolve = resolve;
+
+      // 超时保护：30s
+      this.dayTimeout = setTimeout(() => {
+        this.dayResolve = null;
+        resolve();
+      }, 30_000);
+    });
+  }
+
+  private dayResolve: (() => void) | null = null;
+  private dayTimeout: ReturnType<typeof setTimeout> | null = null;
+
+  /** 处理 SDK 日常数据回调 */
+  handleDailyEvent(data: SdkEventData): void {
+    if (this.phase !== 'reading') return;
+
+    const progress = (data.Progress ?? 0) as number;
+    this.progress = progress;
+    this.onProgress?.(progress, 'reading');
+
+    // 解析数据
+    const readings = this.parseDailyData(data);
+    if (readings.length > 0) {
+      this.buffer.push(...readings);
+      this.packagesRead++;
+    }
+
+    // 达到批量大小就上传
+    if (this.buffer.length >= UPLOAD_BATCH_SIZE) {
+      this.flushBuffer();
+    }
+
+    // 进度 100% 表示当天数据读取完成
+    if (progress >= 100) {
+      if (this.dayTimeout) clearTimeout(this.dayTimeout);
+      this.dayTimeout = null;
+      const resolve = this.dayResolve;
+      this.dayResolve = null;
+      resolve?.();
+    }
+  }
+
+  /** 解析 SDK 日常数据为 NormalizedReading */
+  private parseDailyData(data: SdkEventData): NormalizedReading[] {
+    const content = data.content ?? {};
+    const readings: NormalizedReading[] = [];
+    const now = new Date();
+    // 偏移到对应天
+    const baseDate = new Date(now.getTime() - this.day * 86400000);
+    const timestamp = baseDate.toISOString();
+
+    // 心率
+    const hr = content.heartReat ?? content.heartRate;
+    if (typeof hr === 'number' && hr >= 30 && hr <= 250) {
+      readings.push({ device_type: 'heart_rate', values: { heart_rate: hr }, measured_at: timestamp });
+    }
+
+    // 血氧
+    const bo = content.bloodOxygen;
+    if (typeof bo === 'number' && bo >= 70 && bo <= 100) {
+      readings.push({ device_type: 'blood_oxygen', values: { blood_oxygen: bo }, measured_at: timestamp });
+    }
+
+    // 血压
+    const bph = content.bloodPressureHigh;
+    const bpl = content.bloodPressureLow;
+    if (typeof bph === 'number' && typeof bpl === 'number' && bph > 0 && bpl > 0) {
+      readings.push({ device_type: 'blood_pressure', values: { systolic: bph, diastolic: bpl }, measured_at: timestamp });
+    }
+
+    // 体温
+    const temp = content.bodyTemperature;
+    if (typeof temp === 'number' && temp > 30 && temp < 45) {
+      readings.push({ device_type: 'temperature', values: { temperature: temp }, measured_at: timestamp });
+    }
+
+    // 压力
+    const pressure = content.pressure;
+    if (typeof pressure === 'number' && pressure >= 0 && pressure <= 100) {
+      readings.push({ device_type: 'stress', values: { value: pressure }, measured_at: timestamp });
+    }
+
+    // 步数
+    const steps = content.stepCount ?? content.steps;
+    if (typeof steps === 'number' && steps >= 0) {
+      readings.push({ device_type: 'steps', values: { value: steps }, measured_at: timestamp });
+    }
+
+    return readings;
+  }
+
+  /** 上传 buffer 中的数据 */
+  private async flushBuffer(): Promise<void> {
+    if (this.buffer.length === 0) return;
+
+    const batch = this.buffer.splice(0, this.buffer.length);
+    this.phase = 'uploading';
+    this.onProgress?.(this.progress, 'uploading');
+
+    try {
+      await uploadReadings(this.patientId, this.deviceId, 'Veepoo M2', batch);
+      this.uploadedCount += batch.length;
+      this.saveCheckpoint();
+    } catch {
+      // 上传失败，放回 buffer
+      this.buffer.unshift(...batch);
+    }
+
+    this.phase = 'reading';
+  }
+
+  private saveCheckpoint(): void {
+    try {
+      const checkpoint: Checkpoint = {
+        lastProgress: this.progress,
+        packagesRead: this.packagesRead,
+        deviceId: this.deviceId,
+        timestamp: Date.now(),
+      };
+      Taro.setStorageSync(CHECKPOINT_KEY, JSON.stringify(checkpoint));
+    } catch { /* ignore */ }
+  }
+
+  private clearCheckpoint(): void {
+    try { Taro.removeStorageSync(CHECKPOINT_KEY); } catch { /* ignore */ }
+  }
+
+  getPhase(): HistoryReadPhase { return this.phase; }
+  getProgress(): number { return this.progress; }
+  getUploadedCount(): number { return this.uploadedCount; }
+
+  // ── 睡眠数据上传 ──
+
+  /** 将睡眠数据转换为 NormalizedReading 并上传 */
+  async uploadSleepReadings(patientId: string, deviceId: string, sleepData: SleepReading[]): Promise<number> {
+    if (sleepData.length === 0) return 0;
+
+    const now = new Date();
+    const readings: NormalizedReading[] = sleepData.map((sleep) => {
+      // 根据天数偏移计算日期
+      const baseDate = new Date(now.getTime() - sleep.day * 86400000);
+      return {
+        device_type: 'sleep',
+        values: {
+          deep_sleep_minutes: sleep.deepSleepMinutes,
+          light_sleep_minutes: sleep.lightSleepMinutes,
+          total_sleep_minutes: sleep.totalSleepMinutes,
+          quality_score: sleep.qualityScore,
+        },
+        measured_at: baseDate.toISOString(),
+      };
+    });
+
+    try {
+      await uploadReadings(patientId, deviceId, 'Veepoo M2', readings);
+      this.uploadedCount += readings.length;
+      console.log('[veepoo-history] 睡眠数据上传成功:', readings.length, '条');
+      return readings.length;
+    } catch (err) {
+      console.error('[veepoo-history] 睡眠数据上传失败:', err);
+      return 0;
+    }
+  }
+}

apps/miniprogram/src/services/ble/veepoo/VeepooPipeline.ts

@@ -0,0 +1,588 @@
+/**
+ * Veepoo 管线 — SDK 事件路由 + 连接编排 + 测量 Promise 封装
+ *
+ * 职责：
+ * 1. 连接流程编排：扫描 → 连接 → 注册监听 → 认证 → 就绪
+ * 2. SDK 事件路由：registerDataListener 按 type 分发
+ * 3. 测量 Promise 化：startMeasure(type) → Promise<MeasureResult>
+ */
+
+import Taro from '@tarojs/taro';
+import {
+  startScan,
+  stopScan,
+  connectDevice,
+  registerDataListener,
+  registerConnectionListener,
+  authenticate,
+  disconnect as veepooDisconnect,
+  setHeartRateMeasure,
+  setBloodOxygenMeasure,
+  setBloodPressureMeasure,
+  startTemperatureMeasure,
+  setPressureMeasure,
+  readBatteryLevel,
+  readPreciseSleepData,
+  readAutoTestConfig,
+  setAutoHeartRate,
+  setAutoBloodPressure,
+  setAutoTemperature,
+  setLogLevel,
+  SDK_EVENT_AUTH,
+  SDK_EVENT_HEART_RATE,
+  SDK_EVENT_BLOOD_OXYGEN,
+  SDK_EVENT_BLOOD_PRESSURE,
+  SDK_EVENT_TEMPERATURE,
+  SDK_EVENT_PRESSURE,
+  SDK_EVENT_DAILY,
+  SDK_EVENT_SLEEP,
+  SDK_EVENT_AUTO_TEST,
+  DEVICE_STATE,
+} from '../VeepooBridge';
+import type { SdkEventData } from '../VeepooBridge';
+import type { MeasureType, MeasureResult, SleepReading } from './types';
+
+const AUTH_TIMEOUT = 8_000;
+const AUTH_POLL_INTERVAL = 500;
+const MEASURE_SETTLE_DELAY = 1_500;
+
+/** pending 测量的 resolve/reject 句柄 */
+interface PendingMeasure {
+  type: MeasureType;
+  resolve: (result: MeasureResult) => void;
+  reject: (error: Error) => void;
+  timer: ReturnType<typeof setTimeout>;
+  lastValue: number | null;
+  lastValues: Record<string, number>;
+  settleTimer: ReturnType<typeof setTimeout> | null;
+}
+
+/** SDK type 到 MeasureType 的映射 */
+const SDK_TYPE_TO_MEASURE: Record<number, MeasureType> = {
+  [SDK_EVENT_HEART_RATE]: 'heart_rate',
+  [SDK_EVENT_BLOOD_OXYGEN]: 'blood_oxygen',
+  [SDK_EVENT_BLOOD_PRESSURE]: 'blood_pressure',
+  [SDK_EVENT_TEMPERATURE]: 'temperature',
+  [SDK_EVENT_PRESSURE]: 'pressure',
+};
+
+export type ConnectionChangeCallback = (connected: boolean, deviceId: string) => void;
+export type AuthResultCallback = (success: boolean) => void;
+export type MeasureEventCallback = (type: MeasureType, data: Record<string, unknown>) => void;
+export type DailyDataCallback = (data: SdkEventData) => void;
+export type SleepDataCallback = (day: number, sleep: SleepReading) => void;
+
+export class VeepooPipeline {
+  private pending: PendingMeasure | null = null;
+  private isConnected = false;
+  private deviceId = '';
+
+  /** 睡眠数据读取 Promise resolve 队列 */
+  private sleepResolvers: Map<number, (sleep: SleepReading | null) => void> = new Map();
+  private sleepTimeouts: Map<number, ReturnType<typeof setTimeout>> = new Map();
+
+  private onConnectionChange?: ConnectionChangeCallback;
+  private onAuthResult?: AuthResultCallback;
+  private onMeasureEvent?: MeasureEventCallback;
+  private onDailyData?: DailyDataCallback;
+  private onSleepData?: SleepDataCallback;
+
+  /** 注册回调 */
+  setCallbacks(cbs: {
+    onConnectionChange?: ConnectionChangeCallback;
+    onAuthResult?: AuthResultCallback;
+    onMeasureEvent?: MeasureEventCallback;
+    onDailyData?: DailyDataCallback;
+    onSleepData?: SleepDataCallback;
+  }): void {
+    this.onConnectionChange = cbs.onConnectionChange;
+    this.onAuthResult = cbs.onAuthResult;
+    this.onMeasureEvent = cbs.onMeasureEvent;
+    this.onDailyData = cbs.onDailyData;
+    this.onSleepData = cbs.onSleepData;
+  }
+
+  /** 全流程：扫描 → 连接 → 注册监听 → 认证 */
+  async connect(targetName: string, debug = false): Promise<string> {
+    console.log('[veepoo-pipeline] connect() 开始, target:', targetName);
+    if (debug) setLogLevel(0);
+
+    // 1. 扫描
+    console.log('[veepoo-pipeline] Step 1: 扫描...');
+    const device = await this.scanFor(targetName);
+    if (!device) {
+      console.error('[veepoo-pipeline] 扫描未找到设备');
+      throw new Error(`未找到设备 ${targetName}`);
+    }
+    console.log('[veepoo-pipeline] 找到设备:', (device as Record<string, unknown>)?.deviceId);
+
+    // 2. 连接
+    console.log('[veepoo-pipeline] Step 2: 连接...');
+    const connRes = await connectDevice(device);
+    console.log('[veepoo-pipeline] 连接结果:', JSON.stringify(connRes));
+    // SDK 连接成功返回 errno=0 或 connection=true，两种都要兼容
+    const ok = connRes?.connection === true || connRes?.errno === 0 || connRes?.errCode === 0;
+    if (!ok) throw new Error('连接失败');
+
+    const id = (device as Record<string, unknown>).deviceId as string;
+    this.deviceId = id;
+    this.isConnected = true;
+
+    // 3. 注册数据监听（连接成功后）
+    registerDataListener((data) => this.routeEvent(data));
+    registerConnectionListener((res) => {
+      this.isConnected = res.connected;
+      this.onConnectionChange?.(res.connected, res.deviceId);
+    });
+
+    // 4. 认证（延迟 500ms）
+    await delay(500);
+    authenticate();
+
+    // 5. 等待认证结果
+    const authOk = await this.waitForAuth();
+    if (!authOk) throw new Error('设备认证失败，请重新连接');
+
+    // 6. 读取电量
+    readBatteryLevel();
+
+    return id;
+  }
+
+  /** 扫描指定名称的设备 */
+  private scanFor(targetName: string): Promise<unknown | null> {
+    return new Promise((resolve) => {
+      let found: unknown = null;
+      const upper = targetName.toUpperCase();
+
+      startScan((device) => {
+        const d = device as Record<string, unknown>;
+        const name = String(d.localName ?? d.name ?? '').toUpperCase();
+        if (name.includes(upper) && !found) {
+          found = device;
+          stopScan().then(() => resolve(found));
+        }
+      });
+
+      setTimeout(() => {
+        if (!found) {
+          stopScan().then(() => resolve(null));
+        }
+      }, 10_000);
+    });
+  }
+
+  /** 等待认证结果（轮询 deviceChipStatus） */
+  private waitForAuth(): Promise<boolean> {
+    return new Promise((resolve) => {
+      const start = Date.now();
+
+      const poll = () => {
+        try {
+          const status = Taro.getStorageSync('deviceChipStatus');
+          if (status === 'successfulVerification' || status === 'passTheVerification') {
+            this.onAuthResult?.(true);
+            resolve(true);
+            return;
+          }
+        } catch { /* ignore */ }
+
+        if (Date.now() - start >= AUTH_TIMEOUT) {
+          this.onAuthResult?.(false);
+          resolve(false);
+          return;
+        }
+
+        setTimeout(poll, AUTH_POLL_INTERVAL);
+      };
+
+      poll();
+    });
+  }
+
+  /** SDK 事件路由 */
+  private routeEvent(data: SdkEventData): void {
+    const eventType = data.type;
+
+    // 认证回调
+    if (eventType === SDK_EVENT_AUTH) {
+      const content = data.content ?? {};
+      const password = content.VPDevicepassword;
+      if (password === 'passTheVerification' || password === 'successfulVerification') {
+        this.onAuthResult?.(true);
+      }
+      return;
+    }
+
+    // 日常数据
+    if (eventType === SDK_EVENT_DAILY) {
+      this.onDailyData?.(data);
+      return;
+    }
+
+    // 精准睡眠数据
+    if (eventType === SDK_EVENT_SLEEP) {
+      this.handleSleepEvent(data);
+      return;
+    }
+
+    // 自动测量功能回调
+    if (eventType === SDK_EVENT_AUTO_TEST) {
+      console.log('[veepoo-pipeline] 自动测量配置回调:', JSON.stringify(data).substring(0, 300));
+      return;
+    }
+
+    // 测量数据
+    const measureType = SDK_TYPE_TO_MEASURE[eventType];
+    if (!measureType) return;
+
+    this.handleMeasureEvent(measureType, data);
+    this.onMeasureEvent?.(measureType, data.content ?? {});
+  }
+
+  /** 处理测量事件 */
+  private handleMeasureEvent(type: MeasureType, data: SdkEventData): void {
+    if (!this.pending || this.pending.type !== type) return;
+
+    const content = data.content ?? {};
+
+    // 检查设备状态错误
+    const deviceBusy = content.deviceBusy === true;
+    const notWear = content.notWear === true;
+    const state = data.state;
+    const ack = data.ack;
+
+    if (deviceBusy) {
+      this.rejectPending(new Error('设备正忙，请稍后重试'));
+      return;
+    }
+    if (notWear || state === DEVICE_STATE.NOT_WORN) {
+      this.rejectPending(new Error('请将手环佩戴到手腕上'));
+      return;
+    }
+    if (state === DEVICE_STATE.CHARGING) {
+      this.rejectPending(new Error('设备正在充电，请取出后重试'));
+      return;
+    }
+    if (state === DEVICE_STATE.LOW_BATTERY) {
+      this.rejectPending(new Error('设备电量不足，请充电后重试'));
+      return;
+    }
+    if (type === 'pressure' && ack === 2) {
+      this.rejectPending(new Error('设备电量不足'));
+      return;
+    }
+    if (type === 'pressure' && ack === 3) {
+      this.rejectPending(new Error('设备正在测量其他数据'));
+      return;
+    }
+    if (type === 'pressure' && ack === 4) {
+      this.rejectPending(new Error('佩戴检测未通过'));
+      return;
+    }
+
+    // 提取数值
+    const values = this.extractValues(type, content);
+    if (!values) return;
+
+    // 更新 pending 最新值
+    this.pending.lastValues = values;
+
+    // 对于进度型指标，检查是否完成
+    const progress = data.Progress;
+    if (progress !== undefined && progress >= 100) {
+      this.resolvePending(values);
+      return;
+    }
+
+    // 对于持续测量型/单次型，收到第一个有效值后延迟 settle
+    if (this.pending.settleTimer === null) {
+      this.pending.settleTimer = setTimeout(() => {
+        if (this.pending && this.pending.lastValues && Object.keys(this.pending.lastValues).length > 0) {
+          this.resolvePending(this.pending.lastValues);
+        }
+      }, MEASURE_SETTLE_DELAY);
+    }
+  }
+
+  /** 从 SDK content 提取标准化数值 */
+  private extractValues(type: MeasureType, content: Record<string, unknown>): Record<string, number> | null {
+    switch (type) {
+      case 'heart_rate': {
+        const hr = Number(content.heartRate);
+        if (hr >= 30 && hr <= 250) return { heart_rate: hr };
+        return null;
+      }
+      case 'blood_oxygen': {
+        const bo = Number(content.bloodOxygen);
+        if (bo >= 70 && bo <= 100) return { blood_oxygen: bo };
+        return null;
+      }
+      case 'blood_pressure': {
+        const high = Number(content.bloodPressureHigh);
+        const low = Number(content.bloodPressureLow);
+        if (high > 0 && low > 0) return { systolic: high, diastolic: low };
+        return null;
+      }
+      case 'temperature': {
+        const temp = Number(content.bodyTemperature);
+        if (temp > 30 && temp < 45) return { temperature: temp };
+        return null;
+      }
+      case 'pressure': {
+        const p = Number(content.pressure);
+        if (p >= 0 && p <= 100) return { pressure: p };
+        return null;
+      }
+      default:
+        return null;
+    }
+  }
+
+  /** 发起测量 */
+  startMeasure(type: MeasureType): Promise<MeasureResult> {
+    if (this.pending) {
+      throw new Error(`正在测量 ${this.pending.type}，请等待完成`);
+    }
+    if (!this.isConnected) {
+      throw new Error('设备未连接');
+    }
+
+    return new Promise<MeasureResult>((resolve, reject) => {
+      const timeout = getMeasureTimeout(type);
+
+      const timer = setTimeout(() => {
+        this.rejectPending(new Error('测量超时，请重试'));
+      }, timeout);
+
+      this.pending = {
+        type,
+        resolve,
+        reject,
+        timer,
+        lastValue: null,
+        lastValues: {},
+        settleTimer: null,
+      };
+
+      // 发送 SDK 测量指令
+      this.sendMeasureCommand(type);
+    });
+  }
+
+  /** 取消当前测量 */
+  cancelMeasure(): void {
+    if (!this.pending) return;
+    this.stopMeasureCommand(this.pending.type);
+    if (this.pending.lastValues && Object.keys(this.pending.lastValues).length > 0) {
+      this.resolvePending(this.pending.lastValues);
+    } else {
+      this.rejectPending(new Error('测量已取消'));
+    }
+  }
+
+  /** 发送 SDK 测量指令 */
+  private sendMeasureCommand(type: MeasureType): void {
+    switch (type) {
+      case 'heart_rate':
+        setHeartRateMeasure(true);
+        break;
+      case 'blood_oxygen':
+        setBloodOxygenMeasure('start');
+        break;
+      case 'blood_pressure':
+        setBloodPressureMeasure('start');
+        break;
+      case 'temperature':
+        startTemperatureMeasure();
+        break;
+      case 'pressure':
+        setPressureMeasure(true);
+        break;
+    }
+  }
+
+  /** 发送 SDK 停止测量指令 */
+  private stopMeasureCommand(type: MeasureType): void {
+    switch (type) {
+      case 'heart_rate':
+        setHeartRateMeasure(false);
+        break;
+      case 'blood_oxygen':
+        setBloodOxygenMeasure('stop');
+        break;
+      case 'blood_pressure':
+        setBloodPressureMeasure('stop');
+        break;
+      case 'temperature':
+        break; // 体温是单次触发，无法停止
+      case 'pressure':
+        setPressureMeasure(false);
+        break;
+    }
+  }
+
+  /** 成功 resolve pending 测量 */
+  private resolvePending(values: Record<string, number>): void {
+    if (!this.pending) return;
+    const p = this.pending;
+    this.pending = null;
+
+    clearTimeout(p.timer);
+    if (p.settleTimer) clearTimeout(p.settleTimer);
+
+    // 停止持续测量型指标的 SDK 指令
+    this.stopMeasureCommand(p.type);
+
+    p.resolve({
+      type: p.type,
+      values,
+      measuredAt: Date.now(),
+    });
+  }
+
+  /** 失败 reject pending 测量 */
+  private rejectPending(error: Error): void {
+    if (!this.pending) return;
+    const p = this.pending;
+    this.pending = null;
+
+    clearTimeout(p.timer);
+    if (p.settleTimer) clearTimeout(p.settleTimer);
+
+    // 停止 SDK 指令
+    this.stopMeasureCommand(p.type);
+
+    p.reject(error);
+  }
+
+  // ── 睡眠数据 ──
+
+  /** 读取单天精准睡眠数据，返回 Promise */
+  readSleepData(day: number): Promise<SleepReading | null> {
+    if (!this.isConnected) {
+      return Promise.reject(new Error('设备未连接'));
+    }
+
+    return new Promise<SleepReading | null>((resolve) => {
+      this.sleepResolvers.set(day, resolve);
+
+      // 超时保护 30s
+      const timer = setTimeout(() => {
+        this.sleepResolvers.delete(day);
+        this.sleepTimeouts.delete(day);
+        resolve(null);
+      }, 30_000);
+      this.sleepTimeouts.set(day, timer);
+
+      // 发送 SDK 读取指令
+      readPreciseSleepData(day);
+    });
+  }
+
+  /** 读取 3 天睡眠数据 */
+  async readAllSleepData(): Promise<SleepReading[]> {
+    const results: SleepReading[] = [];
+    for (let day = 0; day < 3; day++) {
+      const sleep = await this.readSleepData(day);
+      if (sleep) {
+        results.push(sleep);
+      }
+    }
+    return results;
+  }
+
+  /** 处理 SDK 睡眠数据回调（type=4） */
+  private handleSleepEvent(data: SdkEventData): void {
+    const progress = data.Progress ?? 0;
+    const readDay = (data as { readDay?: number }).readDay ?? 0;
+
+    // 进度未达 100% 忽略
+    if (progress < 100) return;
+
+    const content = data.content ?? {};
+    const sleep = this.parseSleepData(readDay, content as Record<string, unknown>);
+
+    // 通知回调
+    if (sleep) {
+      this.onSleepData?.(readDay, sleep);
+    }
+
+    // resolve 等待中的 Promise
+    const resolve = this.sleepResolvers.get(readDay);
+    if (resolve) {
+      const timer = this.sleepTimeouts.get(readDay);
+      if (timer) clearTimeout(timer);
+      this.sleepResolvers.delete(readDay);
+      this.sleepTimeouts.delete(readDay);
+      resolve(sleep);
+    }
+  }
+
+  /** 从 SDK content 解析精准睡眠数据 */
+  private parseSleepData(day: number, content: Record<string, unknown>): SleepReading | null {
+    const total = Number(content.sleepTotalTime ?? 0);
+    if (total <= 0) return null;
+
+    return {
+      day,
+      deepSleepMinutes: Number(content.deepSleepTime ?? 0),
+      lightSleepMinutes: Number(content.lightSleepTime ?? 0),
+      otherSleepMinutes: Number(content.otherSleepTime ?? 0),
+      totalSleepMinutes: total,
+      qualityScore: Number(content.sleepQuality ?? 0),
+      fallAsleepTime: String(content.fallAsleepTime ?? ''),
+      exitSleepTime: String(content.exitSleepTime ?? ''),
+    };
+  }
+
+  // ── 自动测量 ──
+
+  /** 开启自动测量（心率 + 血压 + 血氧 + 体温） */
+  enableAutoMeasurement(): void {
+    if (!this.isConnected) return;
+
+    console.log('[veepoo-pipeline] 开启自动测量功能');
+    setAutoHeartRate(true);
+    setAutoBloodPressure(true);
+    setAutoTemperature(true);
+
+    // 读取当前自动测量配置
+    readAutoTestConfig();
+  }
+
+  /** 断开连接 */
+  async disconnect(): Promise<void> {
+    if (this.pending) {
+      this.rejectPending(new Error('设备已断开'));
+    }
+    this.isConnected = false;
+    this.deviceId = '';
+    await veepooDisconnect();
+  }
+
+  /** 获取连接状态 */
+  getConnected(): boolean {
+    return this.isConnected;
+  }
+
+  /** 获取设备 ID */
+  getDeviceId(): string {
+    return this.deviceId;
+  }
+}
+
+function delay(ms: number): Promise<void> {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+function getMeasureTimeout(type: MeasureType): number {
+  const timeouts: Record<MeasureType, number> = {
+    heart_rate: 60_000,
+    blood_oxygen: 60_000,
+    blood_pressure: 120_000,
+    temperature: 60_000,
+    pressure: 90_000,
+  };
+  return timeouts[type];
+}

apps/miniprogram/src/services/ble/veepoo/index.ts

@@ -0,0 +1,21 @@
+export { VeepooPipeline } from './VeepooPipeline';
+export { VeepooHistoryReader } from './VeepooHistoryReader';
+export type {
+  ConnectionChangeCallback,
+  AuthResultCallback,
+  MeasureEventCallback,
+  DailyDataCallback,
+} from './VeepooPipeline';
+export type {
+  MeasureType,
+  MeasurePhase,
+  MeasureStatus,
+  MeasureResult,
+  MeasureConfig,
+  ConnectionPhase,
+  VeepooDeviceInfo,
+  HistorySyncState,
+  SleepReading,
+  AutoTestSyncState,
+} from './types';
+export { MEASURE_TYPES, MEASURE_CONFIG } from './types';

apps/miniprogram/src/services/ble/veepoo/types.ts

@@ -0,0 +1,152 @@
+/** Veepoo 管线专用类型定义 */
+
+/** 测量指标类型 */
+export type MeasureType =
+  | 'heart_rate'
+  | 'blood_oxygen'
+  | 'blood_pressure'
+  | 'temperature'
+  | 'pressure';
+
+/** 所有支持的测量指标 */
+export const MEASURE_TYPES: readonly MeasureType[] = [
+  'heart_rate',
+  'blood_oxygen',
+  'blood_pressure',
+  'temperature',
+  'pressure',
+] as const;
+
+/** 测量指标配置 */
+export interface MeasureConfig {
+  label: string;
+  unit: string;
+  icon: string;
+  color: string;
+  /** 正常范围 [min, max] */
+  normalRange: [number, number];
+  /** 测量超时（毫秒） */
+  timeout: number;
+  /** 测量模式 */
+  mode: 'continuous' | 'progress' | 'single';
+}
+
+/** 各指标配置表 */
+export const MEASURE_CONFIG: Record<MeasureType, MeasureConfig> = {
+  heart_rate: {
+    label: '心率',
+    unit: 'bpm',
+    icon: '♥',
+    color: '#EF4444',
+    normalRange: [60, 100],
+    timeout: 60_000,
+    mode: 'continuous',
+  },
+  blood_oxygen: {
+    label: '血氧',
+    unit: '%',
+    icon: 'O₂',
+    color: '#3B82F6',
+    normalRange: [95, 100],
+    timeout: 60_000,
+    mode: 'continuous',
+  },
+  blood_pressure: {
+    label: '血压',
+    unit: 'mmHg',
+    icon: '↕',
+    color: '#8B5CF6',
+    normalRange: [90, 140],
+    timeout: 120_000,
+    mode: 'progress',
+  },
+  temperature: {
+    label: '体温',
+    unit: '°C',
+    icon: 'T',
+    color: '#F59E0B',
+    normalRange: [36.0, 37.3],
+    timeout: 60_000,
+    mode: 'single',
+  },
+  pressure: {
+    label: '压力',
+    unit: '',
+    icon: '~',
+    color: '#6366F1',
+    normalRange: [1, 40],
+    timeout: 90_000,
+    mode: 'progress',
+  },
+};
+
+/** 连接阶段 */
+export type ConnectionPhase =
+  | 'idle'
+  | 'scanning'
+  | 'connecting'
+  | 'authenticating'
+  | 'ready'
+  | 'disconnected'
+  | 'error';
+
+/** 测量阶段 */
+export type MeasurePhase = 'idle' | 'measuring' | 'success' | 'error';
+
+/** 单个指标的测量状态 */
+export interface MeasureStatus {
+  phase: MeasurePhase;
+  progress: number;
+  currentValue: number | null;
+  result: MeasureResult | null;
+  error: string | null;
+}
+
+/** 测量结果 */
+export interface MeasureResult {
+  type: MeasureType;
+  values: Record<string, number>;
+  measuredAt: number;
+}
+
+/** 设备信息 */
+export interface VeepooDeviceInfo {
+  deviceId: string;
+  name: string;
+  batteryLevel: number | null;
+}
+
+/** 历史数据同步状态 */
+export interface HistorySyncState {
+  phase: 'idle' | 'reading' | 'uploading' | 'done';
+  progress: number;
+  packagesRead: number;
+  lastCheckpoint: number;
+}
+
+/** 睡眠数据（从 SDK 精准睡眠解析） */
+export interface SleepReading {
+  /** 读取天数（0=今天, 1=昨天, 2=前天） */
+  day: number;
+  /** 深睡时长（分钟） */
+  deepSleepMinutes: number;
+  /** 浅睡时长（分钟） */
+  lightSleepMinutes: number;
+  /** 其他睡眠时长（分钟） */
+  otherSleepMinutes: number;
+  /** 睡眠总时长（分钟） */
+  totalSleepMinutes: number;
+  /** 睡眠质量评分（1-5 星） */
+  qualityScore: number;
+  /** 入睡时间（时间戳字符串） */
+  fallAsleepTime: string;
+  /** 退出睡眠时间（时间戳字符串） */
+  exitSleepTime: string;
+}
+
+/** 自动测量同步状态 */
+export interface AutoTestSyncState {
+  phase: 'idle' | 'reading_config' | 'configuring' | 'configured';
+  enabledTypes: string[];
+  intervalMinutes: number;
+}

apps/miniprogram/src/services/request.ts

@@ -22,6 +22,42 @@ const ERROR_CODE_MAP: Record<string, string> = {
   CONCURRENCY_CONFLICT: '数据已被其他人修改，请刷新后重试',
 };
 
+// --- 网络异常状态感知 ---
+// 检测到网络故障后，短时间内抑制后续请求，避免并发请求全部超时产生大量 toast
+// 连续失败时指数退避（3s → 6s → 12s → 30s），避免后端不可达时请求洪泛
+const OFFLINE_SUPPRESS_MS = 3000;
+const OFFLINE_MAX_MS = 30_000;
+let offlineDetectedAt = 0;
+let offlineSuppressMs = OFFLINE_SUPPRESS_MS;
+let networkToastShown = false;
+let networkToastTimer: ReturnType<typeof setTimeout> | null = null;
+let consecutiveNetErrors = 0;
+
+function isOffline(): boolean {
+  return offlineDetectedAt > 0 && Date.now() - offlineDetectedAt < offlineSuppressMs;
+}
+
+function markOffline(): void {
+  offlineDetectedAt = Date.now();
+  consecutiveNetErrors++;
+  // 指数退避：连续失败越多，抑制时间越长（3s → 6s → 12s → 30s cap）
+  offlineSuppressMs = Math.min(OFFLINE_MAX_MS, OFFLINE_SUPPRESS_MS * Math.pow(2, consecutiveNetErrors - 1));
+  if (!networkToastShown) {
+    networkToastShown = true;
+    Taro.showToast({ title: '网络异常，请检查连接', icon: 'none', duration: 2000 });
+    if (networkToastTimer) clearTimeout(networkToastTimer);
+    networkToastTimer = setTimeout(() => { networkToastShown = false; networkToastTimer = null; }, offlineSuppressMs);
+  }
+}
+
+function clearOffline(): void {
+  offlineDetectedAt = 0;
+  offlineSuppressMs = OFFLINE_SUPPRESS_MS;
+  consecutiveNetErrors = 0;
+  if (networkToastTimer) { clearTimeout(networkToastTimer); networkToastTimer = null; }
+  networkToastShown = false;
+}
+
 function safeGet(key: string): string {
   return secureGet(key);
 }
@@ -125,9 +161,15 @@ async function doRefresh(): Promise<boolean> {
 let reLaunchPromise: Promise<void> | null = null;
 
 function safeReLaunch(url: string): void {
+  // 已在目标页，跳过（防止 DevTools reLaunch bug）
+  const pages = Taro.getCurrentPages();
+  const currentPath = pages[pages.length - 1]?.path || '';
+  if (currentPath.includes('pages/login')) return;
   if (reLaunchPromise) return;
   reLaunchPromise = Taro.reLaunch({ url }).then(() => {}, (err) => {
     console.warn('[request] reLaunch failed:', err);
+    // reLaunch 失败时降级为 redirectTo
+    Taro.redirectTo({ url }).catch(() => {});
   }).then(() => {
     setTimeout(() => { reLaunchPromise = null; }, 2000);
   });
@@ -139,6 +181,12 @@ async function request<T>(method: string, path: string, data?: unknown, timeout?
   let retryCount401 = 0;
   for (;;) {
     if (signal?.aborted) throw new Error('请求已取消');
+
+    // 离线抑制：刚检测到网络故障时，直接跳过请求，避免 9+ 并发请求全部超时
+    if (isOffline()) {
+      throw new Error('网络异常');
+    }
+
     if (!bypassLimiter) await limiter.acquire();
     try {
       const headers = await getHeaders();
@@ -153,10 +201,13 @@ async function request<T>(method: string, path: string, data?: unknown, timeout?
           Taro.showToast({ title: '网络超时，请重试', icon: 'none' });
           throw new Error('网络超时');
         }
-        Taro.showToast({ title: '网络异常，请检查连接', icon: 'none' });
+        // 网络异常：标记离线 + toast 去重（3 秒内只弹一次）
+        markOffline();
         throw new Error('网络异常');
       }
 
+      // 请求成功，清除离线标记
+      clearOffline();
       if (signal?.aborted) throw new Error('请求已取消');
 
       if (res.statusCode === 401) {
@@ -181,7 +232,6 @@ async function request<T>(method: string, path: string, data?: unknown, timeout?
       }
 
       if (res.statusCode === 403) {
-        Taro.showToast({ title: '权限不足', icon: 'none' });
         throw new Error('权限不足');
       }
 
@@ -275,4 +325,6 @@ export function resetForTesting(): void {
   headersCacheTs = 0;
   refreshPromise = null;
   isLoggingOut = false;
+  offlineDetectedAt = 0;
+  networkToastShown = false;
 }

apps/miniprogram/src/stores/auth.ts

@@ -2,13 +2,14 @@ import { create } from 'zustand';
 import Taro from '@tarojs/taro';
 import * as authApi from '@/services/auth';
 import { secureGet, secureSet, secureRemove } from '@/utils/secure-storage';
-import { clearRequestCache, markLoggingOut, clearLoggingOut, setCachedPatientId } from '@/services/request';
+import { clearRequestCache, invalidateHeadersCache, markLoggingOut, clearLoggingOut, setCachedPatientId } from '@/services/request';
 
 // secureGet 已内置明文键 fallback，无需再手动 fallback
 function storageGet(key: string): string {
   return secureGet(key);
 }
 import { resetAllStores } from './index';
+import { resetAnalyticsDisabled } from '@/services/analytics';
 
 // --- 内存缓存，避免每次 Tab 切换重复 Storage IPC + JSON.parse ---
 let cachedUserJson = '';
@@ -142,16 +143,24 @@ export const useAuthStore = create<AuthState>((set, get) => ({
         secureSet('tenant_id', user.tenant_id || '');
         set({ user, roles, loading: false });
         clearLoggingOut();
+        invalidateHeadersCache();
+        resetAnalyticsDisabled();
         get().loadPatients();
         return true;
       }
+      // 未绑定：存储 openid 供后续绑定流程使用
+      if (!resp.openid) {
+        set({ loading: false });
+        throw new Error('登录失败：服务器未返回用户标识');
+      }
       secureSet('wechat_openid', resp.openid);
       set({ loading: false });
       return false;
     } catch (err) {
       console.warn('[auth] 微信登录失败:', err);
       set({ loading: false });
-      return false;
+      // 不吞掉错误 — 让调用方区分"未绑定"和"真正的错误"
+      throw err;
     }
   },
 
@@ -175,7 +184,8 @@ export const useAuthStore = create<AuthState>((set, get) => ({
       secureSet('tenant_id', resp.user?.tenant_id || tenantId);
       set({ user: resp.user, roles, loading: false });
       clearLoggingOut();
-      // 登录成功后自动加载患者档案（如果有的话）
+      invalidateHeadersCache();
+      resetAnalyticsDisabled();
       get().loadPatients();
       return true;
     } catch (err) {
@@ -211,6 +221,8 @@ export const useAuthStore = create<AuthState>((set, get) => ({
       secureRemove('wechat_openid');
       set({ user: tokenData.user, roles, loading: false });
       clearLoggingOut();
+      invalidateHeadersCache();
+      resetAnalyticsDisabled();
       get().loadPatients();
       return true;
     } catch (err: unknown) {
@@ -237,7 +249,8 @@ export const useAuthStore = create<AuthState>((set, get) => ({
 
   loadPatients: async () => {
     try {
-      const summaries = await authApi.getPatientSummaries();
+      const userId = get().user?.id;
+      const summaries = await authApi.getPatientSummaries(userId);
       const patients: authApi.PatientInfo[] = summaries.map((p) => ({
         id: p.id,
         name: p.name,
@@ -287,6 +300,9 @@ export const useAuthStore = create<AuthState>((set, get) => ({
     });
     resetAllStores();
     set({ user: null, roles: [], currentPatient: null, patients: [] });
-    Taro.reLaunch({ url: '/pages/index/index' });
+    Taro.reLaunch({ url: '/pages/index/index' }).catch((err) => {
+      console.warn('[auth] reLaunch after logout failed:', err);
+      Taro.redirectTo({ url: '/pages/index/index' }).catch(() => {});
+    });
   },
 }));

apps/miniprogram/src/stores/veepoo.ts

@@ -0,0 +1,335 @@
+import { create } from 'zustand';
+import { VeepooPipeline } from '@/services/ble/veepoo/VeepooPipeline';
+import { VeepooHistoryReader } from '@/services/ble/veepoo/VeepooHistoryReader';
+import type {
+  MeasureType,
+  MeasureStatus,
+  MeasureResult,
+  ConnectionPhase,
+  VeepooDeviceInfo,
+  HistorySyncState,
+  SleepReading,
+} from '@/services/ble/veepoo/types';
+import { MEASURE_TYPES } from '@/services/ble/veepoo/types';
+import { useAuthStore } from './auth';
+
+/** 初始化每个指标的默认状态 */
+function initialMeasureStates(): Record<MeasureType, MeasureStatus> {
+  const states = {} as Record<MeasureType, MeasureStatus>;
+  for (const t of MEASURE_TYPES) {
+    states[t] = { phase: 'idle', progress: 0, currentValue: null, result: null, error: null };
+  }
+  return states;
+}
+
+interface VeepooState {
+  // 连接
+  connectionPhase: ConnectionPhase;
+  device: VeepooDeviceInfo | null;
+  error: string | null;
+
+  // 测量
+  activeMeasure: MeasureType | null;
+  measureStates: Record<MeasureType, MeasureStatus>;
+
+  // 历史
+  historySync: HistorySyncState;
+
+  // 睡眠
+  sleepData: SleepReading[];
+  sleepLoading: boolean;
+
+  // Actions
+  connect: (targetName?: string) => Promise<void>;
+  disconnect: () => Promise<void>;
+  startMeasure: (type: MeasureType) => Promise<MeasureResult>;
+  cancelMeasure: () => void;
+  syncHistory: (patientId: string) => Promise<void>;
+  readSleepData: () => Promise<SleepReading[]>;
+  enableAutoMeasurement: () => void;
+  reset: () => void;
+}
+
+let pipelineInstance: VeepooPipeline | null = null;
+let historyReaderInstance: VeepooHistoryReader | null = null;
+
+function getPipeline(): VeepooPipeline {
+  if (!pipelineInstance) {
+    pipelineInstance = new VeepooPipeline();
+  }
+  return pipelineInstance;
+}
+
+function getHistoryReader(): VeepooHistoryReader {
+  if (!historyReaderInstance) {
+    historyReaderInstance = new VeepooHistoryReader();
+  }
+  return historyReaderInstance;
+}
+
+export const useVeepooStore = create<VeepooState>((set, get) => ({
+  connectionPhase: 'idle',
+  device: null,
+  error: null,
+  activeMeasure: null,
+  measureStates: initialMeasureStates(),
+  historySync: { phase: 'idle', progress: 0, packagesRead: 0, lastCheckpoint: 0 },
+  sleepData: [],
+  sleepLoading: false,
+
+  connect: async (targetName = 'M2') => {
+    console.log('[veepoo-store] connect() 开始, target:', targetName);
+    set({ connectionPhase: 'scanning', error: null });
+    const pipeline = getPipeline();
+    const historyReader = getHistoryReader();
+
+    // 注册全部回调（包含新增的 onSleepData）
+    pipeline.setCallbacks({
+      onConnectionChange: (connected) => {
+        if (!connected) {
+          set({ connectionPhase: 'disconnected', device: null });
+        }
+      },
+      onAuthResult: (success) => {
+        if (success) {
+          set({ connectionPhase: 'ready' });
+        }
+      },
+      onMeasureEvent: (type, data) => {
+        const state = get();
+        if (state.activeMeasure !== type) return;
+
+        const value = extractDisplayValue(type, data);
+        set({
+          measureStates: {
+            ...state.measureStates,
+            [type]: {
+              ...state.measureStates[type],
+              phase: 'measuring',
+              progress: (data.Progress ?? data.progress ?? 0) as number,
+              currentValue: value,
+            },
+          },
+        });
+      },
+      onDailyData: (data) => {
+        // 转发给 HistoryReader 处理
+        historyReader.handleDailyEvent(data);
+
+        const progress = data.Progress ?? 0;
+        set((s) => ({
+          historySync: { ...s.historySync, progress: progress as number },
+        }));
+      },
+      onSleepData: (_day, sleep) => {
+        // 收集睡眠数据到 store
+        set((s) => ({
+          sleepData: [...s.sleepData, sleep],
+        }));
+      },
+    });
+
+    // 注册 HistoryReader 进度回调
+    historyReader.setCallbacks({
+      onProgress: (progress, phase) => {
+        set((s) => ({
+          historySync: {
+            ...s.historySync,
+            phase: phase === 'uploading' ? 'uploading' : 'reading',
+            progress,
+          },
+        }));
+      },
+    });
+
+    try {
+      set({ connectionPhase: 'connecting' });
+      const deviceId = await pipeline.connect(targetName);
+      set({
+        connectionPhase: 'authenticating',
+        device: { deviceId, name: targetName, batteryLevel: null },
+      });
+
+      // 认证结果由 onAuthResult 回调设置
+      // 等待 ready 状态（最多 10s）
+      await waitForState(() => get().connectionPhase === 'ready', 10_000);
+
+      // 认证通过后：自动同步历史 + 读取睡眠 + 开启自动测量
+      const patient = useAuthStore.getState().currentPatient;
+      const readyState = get().connectionPhase === 'ready';
+      if (patient && readyState) {
+        const deviceIdForReader = get().device?.deviceId ?? 'veepoo_m2';
+
+        // 并行执行三件事：
+        // 1. 同步日常历史数据（后台执行，进度通过回调更新）
+        get().syncHistory(patient.id);
+
+        // 2. 读取睡眠数据 → 完成后自动上传
+        get().readSleepData().then((sleepResults) => {
+          if (sleepResults.length > 0) {
+            historyReader.uploadSleepReadings(patient.id, deviceIdForReader, sleepResults);
+          }
+        });
+
+        // 3. 开启自动测量（心率+血压+体温）
+        pipeline.enableAutoMeasurement();
+      }
+    } catch (err) {
+      console.error('[veepoo-store] connect 失败:', err);
+      set({
+        connectionPhase: 'error',
+        error: err instanceof Error ? err.message : '连接失败',
+      });
+    }
+  },
+
+  disconnect: async () => {
+    const pipeline = getPipeline();
+    await pipeline.disconnect();
+    set({
+      connectionPhase: 'idle',
+      device: null,
+      error: null,
+      activeMeasure: null,
+      measureStates: initialMeasureStates(),
+      sleepData: [],
+      sleepLoading: false,
+    });
+  },
+
+  startMeasure: async (type: MeasureType) => {
+    const state = get();
+    if (state.activeMeasure) {
+      throw new Error(`正在测量 ${state.activeMeasure}，请等待完成`);
+    }
+    if (state.connectionPhase !== 'ready') {
+      throw new Error('设备未就绪');
+    }
+
+    set({
+      activeMeasure: type,
+      measureStates: {
+        ...state.measureStates,
+        [type]: { phase: 'measuring', progress: 0, currentValue: null, result: null, error: null },
+      },
+    });
+
+    const pipeline = getPipeline();
+    try {
+      const result = await pipeline.startMeasure(type);
+      set((s) => ({
+        activeMeasure: null,
+        measureStates: {
+          ...s.measureStates,
+          [type]: { phase: 'success', progress: 100, currentValue: null, result, error: null },
+        },
+      }));
+      return result;
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : '测量失败';
+      set((s) => ({
+        activeMeasure: null,
+        measureStates: {
+          ...s.measureStates,
+          [type]: { phase: 'error', progress: 0, currentValue: null, result: null, error: msg },
+        },
+      }));
+      throw err;
+    }
+  },
+
+  cancelMeasure: () => {
+    const pipeline = getPipeline();
+    pipeline.cancelMeasure();
+  },
+
+  syncHistory: async (patientId: string) => {
+    const deviceId = get().device?.deviceId ?? 'veepoo_m2';
+    set((s) => ({ historySync: { ...s.historySync, phase: 'reading', progress: 0 } }));
+
+    try {
+      const historyReader = getHistoryReader();
+      const count = await historyReader.startRead(patientId, deviceId);
+      set((s) => ({
+        historySync: { ...s.historySync, phase: 'done', progress: 100, packagesRead: count },
+      }));
+      console.log('[veepoo-store] 历史数据同步完成, 上传:', count, '条');
+    } catch (err) {
+      console.error('[veepoo-store] 历史数据同步失败:', err);
+      set((s) => ({ historySync: { ...s.historySync, phase: 'done', progress: 100 } }));
+    }
+  },
+
+  readSleepData: async () => {
+    const pipeline = getPipeline();
+    if (!pipeline.getConnected()) {
+      console.warn('[veepoo-store] 设备未连接，跳过睡眠数据读取');
+      return [];
+    }
+
+    set({ sleepLoading: true, sleepData: [] });
+    try {
+      const sleepResults = await pipeline.readAllSleepData();
+      set({ sleepData: sleepResults, sleepLoading: false });
+      console.log('[veepoo-store] 睡眠数据读取完成:', sleepResults.length, '天');
+      return sleepResults;
+    } catch (err) {
+      console.error('[veepoo-store] 睡眠数据读取失败:', err);
+      set({ sleepLoading: false });
+      return [];
+    }
+  },
+
+  enableAutoMeasurement: () => {
+    const pipeline = getPipeline();
+    pipeline.enableAutoMeasurement();
+  },
+
+  reset: () => {
+    set({
+      connectionPhase: 'idle',
+      device: null,
+      error: null,
+      activeMeasure: null,
+      measureStates: initialMeasureStates(),
+      historySync: { phase: 'idle', progress: 0, packagesRead: 0, lastCheckpoint: 0 },
+      sleepData: [],
+      sleepLoading: false,
+    });
+  },
+}));
+
+/** 从 SDK 事件 content 提取显示值 */
+function extractDisplayValue(type: MeasureType, content: Record<string, unknown>): number | null {
+  switch (type) {
+    case 'heart_rate': {
+      const v = Number(content.heartRate);
+      return v >= 30 && v <= 250 ? v : null;
+    }
+    case 'blood_oxygen': {
+      const v = Number(content.bloodOxygen);
+      return v >= 70 && v <= 100 ? v : null;
+    }
+    case 'blood_pressure':
+      return Number(content.bloodPressureHigh) || null;
+    case 'temperature':
+      return Number(content.bodyTemperature) || null;
+    case 'pressure':
+      return Number(content.pressure) || null;
+    default:
+      return null;
+  }
+}
+
+/** 轮询等待状态满足条件 */
+function waitForState(check: () => boolean, timeoutMs: number): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const start = Date.now();
+    const poll = () => {
+      if (check()) { resolve(); return; }
+      if (Date.now() - start >= timeoutMs) { reject(new Error('等待超时')); return; }
+      setTimeout(poll, 200);
+    };
+    poll();
+  });
+}

apps/miniprogram/src/types/mp-html.d.ts

@@ -0,0 +1,15 @@
+declare namespace JSX {
+  interface IntrinsicElements {
+    'mp-html': {
+      content?: string;
+      'lazy-load'?: boolean;
+      selectable?: boolean;
+      'show-img-menu'?: boolean;
+      domain?: string;
+      'tag-style'?: string;
+      'link-style'?: string;
+      'container-style'?: string;
+      onReady?: () => void;
+    };
+  }
+}

apps/miniprogram/src/utils/abort-controller-polyfill.ts

@@ -0,0 +1,57 @@
+/**
+ * AbortController / AbortSignal polyfill — 微信小程序 JS 运行时
+ *
+ * 微信小程序 JSCore/V8 不提供 AbortController / AbortSignal Web API。
+ * usePageData hook 在每个页面挂载时 new AbortController()，
+ * 缺少 polyfill 会导致 ReferenceError 崩溃，影响全部 ~40 个数据页面。
+ *
+ * 在 app.tsx 首行导入（crypto-polyfill 之后），确保在任何页面代码之前执行。
+ *
+ * 实现了 usePageData / request.ts 所需的完整规范子集：
+ * - signal.aborted (getter)
+ * - controller.abort()
+ * - signal.addEventListener('abort', cb) / removeEventListener
+ */
+
+if (typeof globalThis.AbortController === 'undefined') {
+  class _AbortSignal {
+    aborted = false;
+    private _listeners: Array<() => void> = [];
+
+    addEventListener(type: string, cb: () => void): void {
+      if (type === 'abort') this._listeners.push(cb);
+    }
+
+    removeEventListener(_type: string, cb: () => void): void {
+      this._listeners = this._listeners.filter((fn) => fn !== cb);
+    }
+
+    /** @internal 触发 abort 事件 */
+    _doAbort(): void {
+      if (this.aborted) return;
+      this.aborted = true;
+      const listeners = this._listeners.slice();
+      this._listeners = [];
+      for (const fn of listeners) {
+        try {
+          fn();
+        } catch {
+          /* best-effort dispatch */
+        }
+      }
+    }
+  }
+
+  class _AbortController {
+    readonly signal = new _AbortSignal();
+
+    abort(): void {
+      this.signal._doAbort();
+    }
+  }
+
+  // @ts-expect-error — polyfill: globalThis 上原本没有 AbortController
+  globalThis.AbortController = _AbortController;
+  // @ts-expect-error — polyfill: globalThis 上原本没有 AbortSignal
+  globalThis.AbortSignal = _AbortSignal;
+}

apps/miniprogram/src/utils/elder-toast.ts

@@ -16,7 +16,7 @@ export function showToast(options: {
   const duration = options.duration ?? (mode === 'elder' ? 3000 : 1500);
 
   if (mode === 'elder') {
-    try { Taro.vibrateShort({ type: 'light' }); } catch { /* 不支持时静默 */ }
+    Taro.vibrateShort({ type: 'light' }).catch(() => {});
   }
 
   Taro.showToast({ ...options, duration, icon: options.icon ?? 'none' });

apps/miniprogram/src/utils/haptic.ts

@@ -2,21 +2,15 @@ import Taro from '@tarojs/taro';
 
 /** 轻触反馈（按钮点击） */
 export function hapticLight(): void {
-  try {
-    Taro.vibrateShort({ type: 'light' });
-  } catch { /* 部分设备不支持 */ }
+  Taro.vibrateShort({ type: 'light' }).catch(() => { /* DevTools 不支持 type 参数，真机正常 */ });
 }
 
 /** 中等反馈（成功操作） */
 export function hapticMedium(): void {
-  try {
-    Taro.vibrateShort({ type: 'medium' });
-  } catch { /* ignore */ }
+  Taro.vibrateShort({ type: 'medium' }).catch(() => { /* ignore */ });
 }
 
 /** 重度反馈（错误/警告） */
 export function hapticHeavy(): void {
-  try {
-    Taro.vibrateShort({ type: 'heavy' });
-  } catch { /* ignore */ }
+  Taro.vibrateShort({ type: 'heavy' }).catch(() => { /* ignore */ });
 }

apps/miniprogram/src/utils/navigate.ts

@@ -3,8 +3,26 @@ import Taro from '@tarojs/taro';
 const LOGIN_PAGE = '/pages/login/index';
 const MAX_PAGE_STACK = 9;
 
+// reLaunch 去重：避免 401 + 并发请求同时触发多个 reLaunch
+let reLaunchPromise: Promise<void> | null = null;
+
 export function navigateToLogin() {
-  Taro.reLaunch({ url: LOGIN_PAGE });
+  // 已在登录页，跳过
+  const pages = Taro.getCurrentPages();
+  const currentPath = pages[pages.length - 1]?.path || '';
+  if (currentPath.includes('pages/login')) return;
+
+  // 去重：上一个 reLaunch 还没完成就跳过
+  if (reLaunchPromise) return;
+  reLaunchPromise = Taro.reLaunch({ url: LOGIN_PAGE })
+    .catch((err) => {
+      console.warn('[navigate] reLaunch to login failed:', err);
+      // reLaunch 失败时降级为 redirectTo
+      Taro.redirectTo({ url: LOGIN_PAGE }).catch(() => {});
+    })
+    .then(() => {
+      setTimeout(() => { reLaunchPromise = null; }, 2000);
+    });
 }
 
 export function safeNavigateTo(url: string): void {

apps/miniprogram/src/utils/sanitize-html.ts

@@ -11,11 +11,12 @@ const ALLOWED_TAGS = new Set([
 ]);
 
 const ALLOWED_ATTRS: Record<string, Set<string>> = {
-  '*': new Set(['class']),
+  '*': new Set(['class', 'style', 'data-w-e-type']),
   a: new Set(['href', 'title']),
   img: new Set(['src', 'alt', 'width', 'height']),
   td: new Set(['colspan', 'rowspan']),
   th: new Set(['colspan', 'rowspan']),
+  span: new Set(['style']),
 };
 
 const URL_ATTRS = new Set(['href', 'src']);

apps/web/src/App.tsx

@@ -46,7 +46,7 @@ const AiPromptList = lazy(() => import('./pages/health/AiPromptList'));
 const AiAnalysisList = lazy(() => import('./pages/health/AiAnalysisList'));
 const AiUsageDashboard = lazy(() => import('./pages/health/AiUsageDashboard'));
 const AiConfigPage = lazy(() => import('./pages/health/AiConfigPage'));
-const AiKnowledgePage = lazy(() => import('./pages/health/AiKnowledgePage'));
+const KnowledgeV2Page = lazy(() => import('./pages/ai/KnowledgeV2Page'));
 const AiChatPage = lazy(() => import('./pages/ai/ChatPage'));
 const AlertList = lazy(() => import('./pages/health/AlertList'));
 const AlertDashboard = lazy(() => import('./pages/health/AlertDashboard'));
@@ -330,7 +330,7 @@ export default function App() {
                       <Route path="/health/ai-analysis" element={<AiAnalysisList />} />
                       <Route path="/health/ai-usage" element={<AiUsageDashboard />} />
                       <Route path="/health/ai-config" element={<AiConfigPage />} />
-                      <Route path="/health/ai-knowledge" element={<AiKnowledgePage />} />
+                      <Route path="/health/ai-knowledge" element={<KnowledgeV2Page />} />
                       <Route path="/ai/chat" element={<AiChatPage />} />
                       <Route path="/health/alerts" element={<AlertList />} />
                       <Route path="/health/alert-dashboard" element={<AlertDashboard />} />

apps/web/src/api/ai/knowledge.ts

@@ -1,110 +0,0 @@
-import client from '../client';
-
-// === Types ===
-
-export interface KnowledgeReference {
-  id: string;
-  tenant_id: string;
-  title: string;
-  analysis_type: string;
-  source_name: string;
-  content_summary: string;
-  tags: Record<string, unknown> | null;
-  is_enabled: boolean;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface KnowledgeGuide {
-  id: string;
-  tenant_id: string;
-  title: string;
-  analysis_type: string;
-  content: string;
-  category: string | null;
-  is_enabled: boolean;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface CreateReferenceReq {
-  title: string;
-  analysis_type: string;
-  source_name: string;
-  content_summary: string;
-  tags?: Record<string, unknown>;
-  is_enabled?: boolean;
-}
-
-export interface UpdateReferenceReq {
-  title?: string;
-  analysis_type?: string;
-  source_name?: string;
-  content_summary?: string;
-  tags?: Record<string, unknown>;
-  is_enabled?: boolean;
-}
-
-export interface CreateGuideReq {
-  title: string;
-  analysis_type: string;
-  content: string;
-  category?: string;
-  is_enabled?: boolean;
-}
-
-export interface UpdateGuideReq {
-  title?: string;
-  analysis_type?: string;
-  content?: string;
-  category?: string;
-  is_enabled?: boolean;
-}
-
-// === API ===
-
-export const knowledgeApi = {
-  // References
-  listReferences: async (params?: { analysis_type?: string }) => {
-    const resp = await client.get('/ai/knowledge/references', { params });
-    return resp.data.data as { data: KnowledgeReference[]; total: number };
-  },
-  createReference: async (data: CreateReferenceReq) => {
-    const resp = await client.post('/ai/knowledge/references', data);
-    return resp.data.data as { id: string };
-  },
-  updateReference: async (id: string, data: UpdateReferenceReq) => {
-    const resp = await client.put(`/ai/knowledge/references/${id}`, data);
-    return resp.data.data as { id: string };
-  },
-  deleteReference: async (id: string) => {
-    const resp = await client.delete(`/ai/knowledge/references/${id}`);
-    return resp.data.data as { id: string };
-  },
-  reEmbedReference: async (id: string) => {
-    const resp = await client.post(`/ai/knowledge/references/${id}/re-embed`);
-    return resp.data.data as { id: string };
-  },
-
-  // Guides
-  listGuides: async (params?: { analysis_type?: string }) => {
-    const resp = await client.get('/ai/knowledge/guides', { params });
-    return resp.data.data as { data: KnowledgeGuide[]; total: number };
-  },
-  createGuide: async (data: CreateGuideReq) => {
-    const resp = await client.post('/ai/knowledge/guides', data);
-    return resp.data.data as { id: string };
-  },
-  updateGuide: async (id: string, data: UpdateGuideReq) => {
-    const resp = await client.put(`/ai/knowledge/guides/${id}`, data);
-    return resp.data.data as { id: string };
-  },
-  deleteGuide: async (id: string) => {
-    const resp = await client.delete(`/ai/knowledge/guides/${id}`);
-    return resp.data.data as { id: string };
-  },
-  reEmbedGuide: async (id: string) => {
-    const resp = await client.post(`/ai/knowledge/guides/${id}/re-embed`);
-    return resp.data.data as { id: string };
-  },
-};

apps/web/src/api/ai/knowledgeV2.ts

@@ -0,0 +1,188 @@
+import client from '../client';
+
+// === Types ===
+
+export interface KnowledgeBase {
+  id: string;
+  tenant_id: string;
+  name: string;
+  kb_type: string;
+  description: string | null;
+  icon: string | null;
+  chunk_strategy: Record<string, unknown>;
+  intent_keywords: Record<string, unknown>;
+  embedding_model: string | null;
+  is_enabled: boolean;
+  document_count: number;
+  chunk_count: number;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface KnowledgeDocument {
+  id: string;
+  tenant_id: string;
+  knowledge_base_id: string;
+  title: string;
+  doc_type: string;
+  source_type: string;
+  source_url: string | null;
+  file_name: string | null;
+  file_size: number | null;
+  file_mime_type: string | null;
+  content: string | null;
+  status: string;
+  chunk_count: number;
+  embedded_count: number;
+  error_message: string | null;
+  processing_started_at: string | null;
+  processing_completed_at: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface SearchHit {
+  chunk_id: string;
+  document_id: string;
+  chunk_index: number;
+  content: string;
+  doc_title: string;
+  similarity: number;
+  metadata: Record<string, unknown>;
+}
+
+export interface CreateKnowledgeBaseReq {
+  name: string;
+  kb_type: string;
+  description?: string;
+  icon?: string;
+  chunk_strategy?: Record<string, unknown>;
+  intent_keywords?: Record<string, unknown>;
+  embedding_model?: string;
+  is_enabled?: boolean;
+}
+
+export interface UpdateKnowledgeBaseReq {
+  name?: string;
+  kb_type?: string;
+  description?: string;
+  icon?: string;
+  chunk_strategy?: Record<string, unknown>;
+  intent_keywords?: Record<string, unknown>;
+  embedding_model?: string;
+  is_enabled?: boolean;
+}
+
+export interface CreateDocumentReq {
+  kb_id: string;
+  title: string;
+  doc_type?: string;
+  source_type?: string;
+  source_url?: string;
+  content?: string;
+}
+
+// === API ===
+
+export const knowledgeV2Api = {
+  // Knowledge Bases
+  listKnowledgeBases: async (params?: {
+    kb_type?: string;
+    is_enabled?: boolean;
+    page?: number;
+    page_size?: number;
+  }) => {
+    const resp = await client.get('/ai/knowledge-bases', { params });
+    return resp.data.data as {
+      data: KnowledgeBase[];
+      total: number;
+      page: number;
+      page_size: number;
+    };
+  },
+
+  getKnowledgeBase: async (id: string) => {
+    const resp = await client.get(`/ai/knowledge-bases/${id}`);
+    return resp.data.data as KnowledgeBase;
+  },
+
+  createKnowledgeBase: async (data: CreateKnowledgeBaseReq) => {
+    const resp = await client.post('/ai/knowledge-bases', data);
+    return resp.data.data as { id: string };
+  },
+
+  updateKnowledgeBase: async (id: string, data: UpdateKnowledgeBaseReq) => {
+    const resp = await client.put(`/ai/knowledge-bases/${id}`, data);
+    return resp.data.data as { id: string };
+  },
+
+  deleteKnowledgeBase: async (id: string) => {
+    const resp = await client.delete(`/ai/knowledge-bases/${id}`);
+    return resp.data.data as { id: string };
+  },
+
+  // Documents
+  listDocuments: async (
+    kbId: string,
+    params?: { status?: string; page?: number; page_size?: number },
+  ) => {
+    const resp = await client.get(
+      `/ai/knowledge-bases/${kbId}/documents`,
+      { params },
+    );
+    return resp.data.data as {
+      data: KnowledgeDocument[];
+      total: number;
+      page: number;
+      page_size: number;
+    };
+  },
+
+  getDocument: async (id: string) => {
+    const resp = await client.get(`/ai/documents/${id}`);
+    return resp.data.data as KnowledgeDocument;
+  },
+
+  createManualDocument: async (data: CreateDocumentReq) => {
+    const resp = await client.post('/ai/documents/manual', data);
+    return resp.data.data as { id: string };
+  },
+
+  uploadDocument: async (
+    kbId: string,
+    file: File,
+    title?: string,
+  ) => {
+    const formData = new FormData();
+    formData.append('kb_id', kbId);
+    formData.append('file', file);
+    if (title) {
+      formData.append('title', title);
+    }
+    const resp = await client.post('/ai/documents/upload', formData, {
+      headers: { 'Content-Type': 'multipart/form-data' },
+    });
+    return resp.data.data as { id: string };
+  },
+
+  deleteDocument: async (kbId: string, id: string) => {
+    const resp = await client.delete(
+      `/ai/knowledge-bases/${kbId}/documents/${id}`,
+    );
+    return resp.data.data as { id: string };
+  },
+
+  // Hit Test
+  hitTest: async (kbId: string, query: string, topK?: number) => {
+    const resp = await client.post('/ai/documents/hit-test', {
+      kb_id: kbId,
+      query,
+      top_k: topK,
+    });
+    return resp.data.data as {
+      query: string;
+      total: number;
+      hits: SearchHit[];
+    };
+  },
+};

apps/web/src/api/ai/prompts.ts

@@ -11,6 +11,7 @@ export interface PromptItem {
   version: number;
   is_active: boolean;
   category: string;
+  analysis_type: string;
   tags: Record<string, unknown> | null;
   created_at: string;
   updated_at: string;
@@ -23,10 +24,11 @@ export interface CreatePromptReq {
   user_prompt_template: string;
   model_config: Record<string, unknown>;
   category: string;
+  analysis_type: string;
 }
 
 export const promptApi = {
-  list: async (params?: { category?: string; page?: number; page_size?: number }) => {
+  list: async (params?: { category?: string; analysis_type?: string; page?: number; page_size?: number }) => {
     const resp = await client.get('/ai/prompts', { params });
     return resp.data.data as PaginatedResponse<PromptItem>;
   },
@@ -38,8 +40,15 @@ export const promptApi = {
     const resp = await client.post(`/ai/prompts/${id}/activate`);
     return resp.data.data as PromptItem;
   },
+  deactivate: async (id: string) => {
+    const resp = await client.post(`/ai/prompts/${id}/deactivate`);
+    return resp.data.data as PromptItem;
+  },
   rollback: async (id: string) => {
     const resp = await client.post(`/ai/prompts/${id}/rollback`);
     return resp.data.data as PromptItem;
   },
+  delete: async (id: string) => {
+    await client.delete(`/ai/prompts/${id}`);
+  },
 };

apps/web/src/api/health/articles.ts

@@ -23,6 +23,7 @@ export interface ArticleListItem {
   review_note?: string;
   view_count: number;
   sort_order: number;
+  is_public: boolean;
   published_at?: string;
   created_at: string;
   updated_at: string;
@@ -43,6 +44,7 @@ export interface CreateArticleReq {
   category_id?: string;
   tag_ids?: string[];
   sort_order?: number;
+  is_public?: boolean;
 }
 
 export interface UpdateArticleReq {
@@ -55,6 +57,7 @@ export interface UpdateArticleReq {
   category_id?: string;
   tag_ids?: string[];
   sort_order?: number;
+  is_public?: boolean;
   version: number;
 }
 
@@ -79,6 +82,7 @@ export interface ArticleCategory {
   description?: string;
   created_at: string;
   updated_at: string;
+  version: number;
 }
 
 export interface CreateCategoryReq {
@@ -233,11 +237,11 @@ export const articleCategoryApi = {
     return data.data;
   },
 
-  delete: async (id: string) => {
+  delete: async (id: string, version: number) => {
     const { data } = await client.delete<{
       success: boolean;
       data: null;
-    }>(`/health/article-categories/${id}`);
+    }>(`/health/article-categories/${id}`, { data: { version } });
     return data.data;
   },
 };

apps/web/src/api/health/points.ts

@@ -322,10 +322,11 @@ export const pointsApi = {
   },
 
   updateProduct: async (id: string, req: Partial<CreatePointsProductReq> & { is_active?: boolean; version: number }) => {
+    const { version, ...fields } = req;
     const { data } = await client.put<{
       success: boolean;
       data: PointsProduct;
-    }>(`/health/admin/points/products/${id}`, req);
+    }>(`/health/admin/points/products/${id}`, { data: fields, version });
     return data.data;
   },
 

apps/web/src/api/users.ts

@@ -18,10 +18,10 @@ export interface UpdateUserRequest {
   version: number;
 }
 
-export async function listUsers(page = 1, pageSize = 20, search = '') {
+export async function listUsers(page = 1, pageSize = 20, search = '', excludeOnlyRoles?: string) {
   const { data } = await client.get<{ success: boolean; data: PaginatedResponse<UserInfo> }>(
     '/users',
-    { params: { page, page_size: pageSize, search: search || undefined } }
+    { params: { page, page_size: pageSize, search: search || undefined, exclude_only_roles: excludeOnlyRoles } }
   );
   return data.data;
 }

apps/web/src/components/DrawerForm.tsx

@@ -19,6 +19,8 @@ interface DrawerFormProps {
   sections?: FormSection[];
   children?: React.ReactNode;
   columns?: 1 | 2;
+  form?: ReturnType<typeof Form.useForm>[0];
+  onValuesChange?: (changedValues: Record<string, unknown>, allValues: Record<string, unknown>) => void;
 }
 
 export function DrawerForm({
@@ -32,8 +34,11 @@ export function DrawerForm({
   sections,
   children,
   columns = 2,
+  form: externalForm,
+  onValuesChange,
 }: DrawerFormProps) {
-  const [form] = Form.useForm();
+  const [internalForm] = Form.useForm();
+  const form = externalForm ?? internalForm;
   const isDark = useThemeMode();
 
   React.useEffect(() => {
@@ -81,7 +86,7 @@ export function DrawerForm({
         </Space>
       }
     >
-      <Form form={form} layout="vertical" initialValues={initialValues}>
+      <Form form={form} layout="vertical" initialValues={initialValues} onValuesChange={onValuesChange}>
         {sections
           ? sections.map((s, i) => (
               <div key={i}>

apps/web/src/hooks/usePaginatedData.ts

@@ -56,56 +56,62 @@ export function usePaginatedData<T, F = string>(
   const [searchText, setSearchText] = useState('');
   const [filters, setFilters] = useState<F>(defaultFilters);
 
-   
   const fetchFnRef = useRef(fetchFn);
-  fetchFnRef.current = fetchFn;
 
   const searchTextRef = useRef(searchText);
-  searchTextRef.current = searchText;
 
   const filtersRef = useRef(filters);
-  filtersRef.current = filters;
 
   const stateRef = useRef(state);
-  stateRef.current = state;
-   
 
-  const refresh = useCallback(
-    async (p?: number) => {
-      const targetPage = p ?? stateRef.current.page;
-      setState((s) => ({ ...s, loading: true }));
-      try {
-        const result = await fetchFnRef.current(
-          targetPage,
-          pageSize,
-          filtersRef.current ?? searchTextRef.current,
-        );
-        setState({ data: result.data, total: result.total, page: targetPage, loading: false });
-      } catch (err) {
-        console.warn('[usePaginatedData] 加载数据失败:', err);
-        message.error('加载数据失败');
-        setState((s) => ({ ...s, loading: false }));
-      }
-    },
-    [pageSize],
-  );
-
-  // 合并初始 fetch 和 filters 变化时的 fetch，消除双重请求
-  const isFirstRender = useRef(true);
   useEffect(() => {
+    fetchFnRef.current = fetchFn;
+    searchTextRef.current = searchText;
+    filtersRef.current = filters;
+    stateRef.current = state;
+  });
+
+  // 所有 fetch 统一走 useEffect，通过 fetchTrigger 触发
+  const [fetchTrigger, setFetchTrigger] = useState(0);
+  const pendingPageRef = useRef<number | undefined>(undefined);
+  const isFirstRender = useRef(true);
+
+  // refresh 只负责设置目标页并递增 trigger，实际 fetch 在 useEffect 中执行
+  const refresh = useCallback((p?: number) => {
+    pendingPageRef.current = p;
+    setFetchTrigger((t) => t + 1);
+  }, []);
+
+  useEffect(() => {
+    const targetPage = pendingPageRef.current ?? stateRef.current.page;
+    pendingPageRef.current = undefined;
+
     if (isFirstRender.current) {
       isFirstRender.current = false;
-      if (shouldAutoFetch) {
-        refresh(1);
-      }
-      return;
+      if (!shouldAutoFetch) return;
     }
-    if (shouldAutoFetch) {
-      refresh(1);
-    }
-  // refresh 每次渲染都稳定，不放入依赖数组；filters 变化触发重新 fetch
-  // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [shouldAutoFetch, filters]);
+
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- 数据获取 hook：loading → fetch → setState 是标准模式
+    setState((s) => ({ ...s, loading: true }));
+
+    let cancelled = false;
+    fetchFnRef.current(targetPage, pageSize, filtersRef.current ?? searchTextRef.current)
+      .then((result) => {
+        if (!cancelled) {
+          setState({ data: result.data, total: result.total, page: targetPage, loading: false });
+        }
+      })
+      .catch((err) => {
+        if (!cancelled) {
+          console.warn('[usePaginatedData] 加载数据失败:', err);
+          message.error('加载数据失败');
+          setState((s) => ({ ...s, loading: false }));
+        }
+      });
+
+    return () => { cancelled = true; };
+    // fetchTrigger 变化 = 手动 refresh；filters 变化 = 筛选刷新
+  }, [shouldAutoFetch, filters, fetchTrigger, pageSize]);
 
   return { ...state, searchText, setSearchText, filters, setFilters, refresh };
 }
@@ -115,5 +121,5 @@ interface PaginatedResult<T, F> extends PaginatedState<T> {
   setSearchText: (text: string) => void;
   filters: F;
   setFilters: (filters: F | ((prev: F) => F)) => void;
-  refresh: (page?: number) => Promise<void>;
+  refresh: (page?: number) => void;
 }

apps/web/src/pages/Users.tsx

@@ -52,7 +52,7 @@ export default function Users() {
   const {
     data: users, total, page, loading, refresh,
   } = usePaginatedData<UserInfo>(async (p, pageSize, search) => {
-    const result = await listUsers(p, pageSize, search);
+    const result = await listUsers(p, pageSize, search, 'patient');
     return { data: result.data, total: result.total };
   }, 20);
 

apps/web/src/pages/ai/KnowledgeV2Page.tsx

@@ -0,0 +1,566 @@
+import { useCallback, useEffect, useState } from 'react';
+import {
+  Card,
+  Table,
+  Button,
+  Space,
+  Modal,
+  Form,
+  Input,
+  Select,
+  Switch,
+  message,
+  Popconfirm,
+  Tag,
+  Upload,
+  Progress,
+  Drawer,
+  List,
+  Empty,
+} from 'antd';
+import {
+  PlusOutlined,
+  DeleteOutlined,
+  UploadOutlined,
+  SearchOutlined,
+  FileTextOutlined,
+  DatabaseOutlined,
+} from '@ant-design/icons';
+import type { UploadFile } from 'antd/es/upload/interface';
+import {
+  knowledgeV2Api,
+  type KnowledgeBase,
+  type KnowledgeDocument,
+  type SearchHit,
+  type CreateKnowledgeBaseReq,
+} from '../../api/ai/knowledgeV2';
+
+const KB_TYPES = [
+  { label: '临床指南', value: 'clinical_guide' },
+  { label: '操作规程', value: 'sop' },
+  { label: 'FAQ', value: 'faq' },
+  { label: '产品知识', value: 'product' },
+  { label: '通用', value: 'general' },
+];
+
+export default function KnowledgeV2Page() {
+  const [kbs, setKbs] = useState<KnowledgeBase[]>([]);
+  const [total, setTotal] = useState(0);
+  const [page, setPage] = useState(1);
+  const [loading, setLoading] = useState(false);
+  const [createModalOpen, setCreateModalOpen] = useState(false);
+  const [editKb, setEditKb] = useState<KnowledgeBase | null>(null);
+  const [form] = Form.useForm();
+
+  // Document drawer state
+  const [docDrawerKb, setDocDrawerKb] = useState<KnowledgeBase | null>(null);
+  const [docs, setDocs] = useState<KnowledgeDocument[]>([]);
+  const [docsLoading, setDocsLoading] = useState(false);
+  const [uploadModalOpen, setUploadModalOpen] = useState(false);
+  const [uploadKbId, setUploadKbId] = useState<string>('');
+  const [fileList, setFileList] = useState<UploadFile[]>([]);
+
+  // Hit test state
+  const [hitTestKb, setHitTestKb] = useState<KnowledgeBase | null>(null);
+  const [hitTestQuery, setHitTestQuery] = useState('');
+  const [hitResults, setHitResults] = useState<SearchHit[]>([]);
+  const [hitTestLoading, setHitTestLoading] = useState(false);
+
+  const loadKbs = useCallback(async () => {
+    setLoading(true);
+    try {
+      const res = await knowledgeV2Api.listKnowledgeBases({
+        page,
+        page_size: 20,
+      });
+      setKbs(res.data);
+      setTotal(res.total);
+    } catch {
+      message.error('加载知识库列表失败');
+    } finally {
+      setLoading(false);
+    }
+  }, [page]);
+
+  useEffect(() => {
+    loadKbs();
+  }, [loadKbs]);
+
+  const handleCreate = async () => {
+    try {
+      const values = await form.validateFields();
+      const req: CreateKnowledgeBaseReq = {
+        name: values.name,
+        kb_type: values.kb_type,
+        description: values.description,
+        is_enabled: values.is_enabled ?? true,
+      };
+      await knowledgeV2Api.createKnowledgeBase(req);
+      message.success('知识库创建成功');
+      setCreateModalOpen(false);
+      form.resetFields();
+      loadKbs();
+    } catch {
+      // validation error
+    }
+  };
+
+  const handleUpdate = async () => {
+    if (!editKb) return;
+    try {
+      const values = await form.validateFields();
+      await knowledgeV2Api.updateKnowledgeBase(editKb.id, {
+        name: values.name,
+        kb_type: values.kb_type,
+        description: values.description,
+        is_enabled: values.is_enabled,
+      });
+      message.success('知识库更新成功');
+      setEditKb(null);
+      form.resetFields();
+      loadKbs();
+    } catch {
+      // validation error
+    }
+  };
+
+  const handleDelete = async (id: string) => {
+    try {
+      await knowledgeV2Api.deleteKnowledgeBase(id);
+      message.success('知识库已删除');
+      loadKbs();
+    } catch {
+      message.error('删除失败');
+    }
+  };
+
+  const loadDocuments = async (kb: KnowledgeBase) => {
+    setDocDrawerKb(kb);
+    setDocsLoading(true);
+    try {
+      const res = await knowledgeV2Api.listDocuments(kb.id, {
+        page: 1,
+        page_size: 50,
+      });
+      setDocs(res.data);
+    } catch {
+      message.error('加载文档列表失败');
+    } finally {
+      setDocsLoading(false);
+    }
+  };
+
+  const handleUpload = async () => {
+    if (!uploadKbId || fileList.length === 0) return;
+    try {
+      const file = fileList[0].originFileObj;
+      if (!file) return;
+      await knowledgeV2Api.uploadDocument(uploadKbId, file);
+      message.success('文档上传成功，正在处理...');
+      setUploadModalOpen(false);
+      setFileList([]);
+      if (docDrawerKb) {
+        loadDocuments(docDrawerKb);
+      }
+    } catch {
+      message.error('上传失败');
+    }
+  };
+
+  const handleDeleteDoc = async (kbId: string, docId: string) => {
+    try {
+      await knowledgeV2Api.deleteDocument(kbId, docId);
+      message.success('文档已删除');
+      if (docDrawerKb) {
+        loadDocuments(docDrawerKb);
+      }
+    } catch {
+      message.error('删除失败');
+    }
+  };
+
+  const handleHitTest = async () => {
+    if (!hitTestKb || !hitTestQuery.trim()) return;
+    setHitTestLoading(true);
+    try {
+      const res = await knowledgeV2Api.hitTest(hitTestKb.id, hitTestQuery, 5);
+      setHitResults(res.hits);
+    } catch {
+      message.error('搜索失败');
+      setHitResults([]);
+    } finally {
+      setHitTestLoading(false);
+    }
+  };
+
+  const statusTag = (status: string) => {
+    const map: Record<string, { color: string; label: string }> = {
+      pending: { color: 'default', label: '待处理' },
+      processing: { color: 'processing', label: '处理中' },
+      completed: { color: 'success', label: '已完成' },
+      failed: { color: 'error', label: '失败' },
+    };
+    const info = map[status] || { color: 'default', label: status };
+    return <Tag color={info.color}>{info.label}</Tag>;
+  };
+
+  const kbColumns = [
+    {
+      title: '名称',
+      dataIndex: 'name',
+      key: 'name',
+      render: (name: string, record: KnowledgeBase) => (
+        <Button type="link" onClick={() => loadDocuments(record)}>
+          {name}
+        </Button>
+      ),
+    },
+    {
+      title: '类型',
+      dataIndex: 'kb_type',
+      key: 'kb_type',
+      render: (type: string) => {
+        const found = KB_TYPES.find((t) => t.value === type);
+        return found?.label || type;
+      },
+    },
+    {
+      title: '文档数',
+      dataIndex: 'document_count',
+      key: 'document_count',
+      width: 90,
+    },
+    {
+      title: '切片数',
+      dataIndex: 'chunk_count',
+      key: 'chunk_count',
+      width: 90,
+    },
+    {
+      title: '状态',
+      dataIndex: 'is_enabled',
+      key: 'is_enabled',
+      width: 80,
+      render: (v: boolean) => (
+        <Tag color={v ? 'green' : 'red'}>{v ? '启用' : '禁用'}</Tag>
+      ),
+    },
+    {
+      title: '创建时间',
+      dataIndex: 'created_at',
+      key: 'created_at',
+      width: 170,
+      render: (v: string) => new Date(v).toLocaleString('zh-CN'),
+    },
+    {
+      title: '操作',
+      key: 'actions',
+      width: 240,
+      render: (_: unknown, record: KnowledgeBase) => (
+        <Space size="small">
+          <Button
+            size="small"
+            icon={<UploadOutlined />}
+            onClick={() => {
+              setUploadKbId(record.id);
+              setUploadModalOpen(true);
+            }}
+          >
+            上传
+          </Button>
+          <Button
+            size="small"
+            icon={<SearchOutlined />}
+            onClick={() => {
+              setHitTestKb(record);
+              setHitResults([]);
+              setHitTestQuery('');
+            }}
+          >
+            搜索测试
+          </Button>
+          <Button
+            size="small"
+            onClick={() => {
+              setEditKb(record);
+              form.setFieldsValue({
+                name: record.name,
+                kb_type: record.kb_type,
+                description: record.description,
+                is_enabled: record.is_enabled,
+              });
+            }}
+          >
+            编辑
+          </Button>
+          <Popconfirm
+            title="确定删除此知识库？"
+            onConfirm={() => handleDelete(record.id)}
+          >
+            <Button size="small" danger icon={<DeleteOutlined />} />
+          </Popconfirm>
+        </Space>
+      ),
+    },
+  ];
+
+  const kbFormContent = (
+    <Form form={form} layout="vertical">
+      <Form.Item
+        name="name"
+        label="知识库名称"
+        rules={[{ required: true, message: '请输入知识库名称' }]}
+      >
+        <Input placeholder="例：高血压临床指南" />
+      </Form.Item>
+      <Form.Item
+        name="kb_type"
+        label="知识库类型"
+        rules={[{ required: true, message: '请选择类型' }]}
+      >
+        <Select options={KB_TYPES} placeholder="选择类型" />
+      </Form.Item>
+      <Form.Item name="description" label="描述">
+        <Input.TextArea rows={3} placeholder="知识库描述（可选）" />
+      </Form.Item>
+      <Form.Item name="is_enabled" label="启用" valuePropName="checked">
+        <Switch defaultChecked />
+      </Form.Item>
+    </Form>
+  );
+
+  const docColumns = [
+    {
+      title: '标题',
+      dataIndex: 'title',
+      key: 'title',
+      ellipsis: true,
+    },
+    {
+      title: '类型',
+      dataIndex: 'doc_type',
+      key: 'doc_type',
+      width: 80,
+    },
+    {
+      title: '来源',
+      dataIndex: 'source_type',
+      key: 'source_type',
+      width: 80,
+      render: (v: string) => <Tag>{v === 'upload' ? '上传' : '手动'}</Tag>,
+    },
+    {
+      title: '状态',
+      dataIndex: 'status',
+      key: 'status',
+      width: 90,
+      render: statusTag,
+    },
+    {
+      title: '切片/嵌入',
+      key: 'progress',
+      width: 130,
+      render: (_: unknown, record: KnowledgeDocument) => {
+        if (record.chunk_count === 0) return '-';
+        const pct = Math.round(
+          (record.embedded_count / record.chunk_count) * 100,
+        );
+        return <Progress percent={pct} size="small" />;
+      },
+    },
+    {
+      title: '操作',
+      key: 'actions',
+      width: 70,
+      render: (_: unknown, record: KnowledgeDocument) => (
+        <Popconfirm
+          title="确定删除此文档？"
+          onConfirm={() =>
+            handleDeleteDoc(record.knowledge_base_id, record.id)
+          }
+        >
+          <Button size="small" danger icon={<DeleteOutlined />} />
+        </Popconfirm>
+      ),
+    },
+  ];
+
+  return (
+    <div style={{ padding: 24 }}>
+      <Card
+        title={
+          <Space>
+            <DatabaseOutlined />
+            知识库管理 V2
+          </Space>
+        }
+        extra={
+          <Button
+            type="primary"
+            icon={<PlusOutlined />}
+            onClick={() => {
+              form.resetFields();
+              setCreateModalOpen(true);
+            }}
+          >
+            新建知识库
+          </Button>
+        }
+      >
+        <Table
+          rowKey="id"
+          columns={kbColumns}
+          dataSource={kbs}
+          loading={loading}
+          pagination={{
+            current: page,
+            total,
+            pageSize: 20,
+            onChange: setPage,
+            showTotal: (t) => `共 ${t} 条`,
+          }}
+        />
+      </Card>
+
+      {/* 创建知识库 Modal */}
+      <Modal
+        title="新建知识库"
+        open={createModalOpen}
+        onOk={handleCreate}
+        onCancel={() => {
+          setCreateModalOpen(false);
+          form.resetFields();
+        }}
+        okText="创建"
+      >
+        {kbFormContent}
+      </Modal>
+
+      {/* 编辑知识库 Modal */}
+      <Modal
+        title="编辑知识库"
+        open={!!editKb}
+        onOk={handleUpdate}
+        onCancel={() => {
+          setEditKb(null);
+          form.resetFields();
+        }}
+        okText="保存"
+      >
+        {kbFormContent}
+      </Modal>
+
+      {/* 文档列表 Drawer */}
+      <Drawer
+        title={
+          docDrawerKb
+            ? `${docDrawerKb.name} — 文档列表`
+            : '文档列表'
+        }
+        open={!!docDrawerKb}
+        onClose={() => setDocDrawerKb(null)}
+        width={720}
+      >
+        <Table
+          rowKey="id"
+          columns={docColumns}
+          dataSource={docs}
+          loading={docsLoading}
+          pagination={false}
+          size="small"
+          locale={{ emptyText: <Empty description="暂无文档" /> }}
+        />
+      </Drawer>
+
+      {/* 上传文档 Modal */}
+      <Modal
+        title="上传文档"
+        open={uploadModalOpen}
+        onOk={handleUpload}
+        onCancel={() => {
+          setUploadModalOpen(false);
+          setFileList([]);
+        }}
+        okText="上传"
+      >
+        <Upload
+          beforeUpload={() => false}
+          maxCount={1}
+          fileList={fileList}
+          onChange={({ fileList: fl }) => setFileList(fl)}
+          accept=".pdf,.txt,.md,.docx,.xlsx"
+        >
+          <Button icon={<UploadOutlined />}>选择文件</Button>
+        </Upload>
+        <div style={{ marginTop: 8, color: '#999', fontSize: 12 }}>
+          支持 PDF、TXT、Markdown、DOCX、XLSX，最大 20MB
+        </div>
+      </Modal>
+
+      {/* Hit Test Drawer */}
+      <Drawer
+        title={
+          hitTestKb ? `${hitTestKb.name} — 向量搜索测试` : '搜索测试'
+        }
+        open={!!hitTestKb}
+        onClose={() => {
+          setHitTestKb(null);
+          setHitResults([]);
+        }}
+        width={600}
+      >
+        <Space.Compact style={{ width: '100%', marginBottom: 16 }}>
+          <Input
+            placeholder="输入搜索文本..."
+            value={hitTestQuery}
+            onChange={(e) => setHitTestQuery(e.target.value)}
+            onPressEnter={handleHitTest}
+          />
+          <Button
+            type="primary"
+            icon={<SearchOutlined />}
+            loading={hitTestLoading}
+            onClick={handleHitTest}
+          >
+            搜索
+          </Button>
+        </Space.Compact>
+
+        <List
+          dataSource={hitResults}
+          locale={{ emptyText: <Empty description="输入查询后点击搜索" /> }}
+          renderItem={(item) => (
+            <List.Item key={item.chunk_id}>
+              <List.Item.Meta
+                avatar={
+                  <FileTextOutlined style={{ fontSize: 20, color: '#1890ff' }} />
+                }
+                title={
+                  <Space>
+                    <span>{item.doc_title}</span>
+                    <Tag color="blue">切片 #{item.chunk_index}</Tag>
+                    <Tag color="green">
+                      相似度 {(item.similarity * 100).toFixed(1)}%
+                    </Tag>
+                  </Space>
+                }
+                description={
+                  <div
+                    style={{
+                      maxHeight: 120,
+                      overflow: 'hidden',
+                      textOverflow: 'ellipsis',
+                      color: '#666',
+                    }}
+                  >
+                    {item.content}
+                  </div>
+                }
+              />
+            </List.Item>
+          )}
+        />
+      </Drawer>
+    </div>
+  );
+}

apps/web/src/pages/health/AiKnowledgePage.tsx

@@ -1,508 +0,0 @@
-import { useCallback, useEffect, useState } from 'react';
-import {
-  Card,
-  Table,
-  Button,
-  Space,
-  Modal,
-  Form,
-  Input,
-  Select,
-  Switch,
-  message,
-  Popconfirm,
-  Tabs,
-  Tag,
-  Tooltip,
-} from 'antd';
-import {
-  PlusOutlined,
-  EditOutlined,
-  DeleteOutlined,
-  ReloadOutlined,
-  ThunderboltOutlined,
-} from '@ant-design/icons';
-import {
-  knowledgeApi,
-  type KnowledgeReference,
-  type KnowledgeGuide,
-  type CreateReferenceReq,
-  type UpdateReferenceReq,
-  type CreateGuideReq,
-  type UpdateGuideReq,
-} from '../../api/ai/knowledge';
-import { AuthButton } from '../../components/AuthButton';
-
-const ANALYSIS_TYPES = [
-  { value: 'lab_report', label: '化验报告' },
-  { value: 'trend', label: '趋势分析' },
-  { value: 'report_summary', label: '报告摘要' },
-  { value: 'dialysis_risk', label: '透析风险' },
-  { value: 'checkup_plan', label: '体检计划' },
-  { value: 'follow_up', label: '随访总结' },
-];
-
-export default function AiKnowledgePage() {
-  return (
-    <Card title="AI 知识库管理">
-      <Tabs
-        items={[
-          { key: 'references', label: '参考资料', children: <ReferencesTab /> },
-          { key: 'guides', label: '临床指南', children: <GuidesTab /> },
-        ]}
-      />
-    </Card>
-  );
-}
-
-// === References Tab ===
-
-function ReferencesTab() {
-  const [data, setData] = useState<KnowledgeReference[]>([]);
-  const [loading, setLoading] = useState(false);
-  const [modalOpen, setModalOpen] = useState(false);
-  const [editing, setEditing] = useState<KnowledgeReference | null>(null);
-  const [filterType, setFilterType] = useState<string | undefined>();
-  const [form] = Form.useForm();
-
-  const fetchData = useCallback(async () => {
-    setLoading(true);
-    try {
-      const result = await knowledgeApi.listReferences(
-        filterType ? { analysis_type: filterType } : undefined,
-      );
-      setData(result.data);
-    } catch {
-      message.error('加载参考资料失败');
-    } finally {
-      setLoading(false);
-    }
-  }, [filterType]);
-
-  useEffect(() => {
-    fetchData();
-  }, [fetchData]);
-
-  const openCreate = () => {
-    setEditing(null);
-    form.resetFields();
-    form.setFieldsValue({ is_enabled: true });
-    setModalOpen(true);
-  };
-
-  const openEdit = (record: KnowledgeReference) => {
-    setEditing(record);
-    form.setFieldsValue({
-      title: record.title,
-      analysis_type: record.analysis_type,
-      source_name: record.source_name,
-      content_summary: record.content_summary,
-      is_enabled: record.is_enabled,
-    });
-    setModalOpen(true);
-  };
-
-  const handleSubmit = async () => {
-    const values = await form.validateFields();
-    try {
-      if (editing) {
-        const req: UpdateReferenceReq = {
-          title: values.title,
-          analysis_type: values.analysis_type,
-          source_name: values.source_name,
-          content_summary: values.content_summary,
-          is_enabled: values.is_enabled,
-        };
-        await knowledgeApi.updateReference(editing.id, req);
-        message.success('更新成功');
-      } else {
-        const req: CreateReferenceReq = {
-          title: values.title,
-          analysis_type: values.analysis_type,
-          source_name: values.source_name,
-          content_summary: values.content_summary,
-          is_enabled: values.is_enabled,
-        };
-        await knowledgeApi.createReference(req);
-        message.success('创建成功');
-      }
-      setModalOpen(false);
-      fetchData();
-    } catch {
-      message.error(editing ? '更新失败' : '创建失败');
-    }
-  };
-
-  const handleDelete = async (id: string) => {
-    try {
-      await knowledgeApi.deleteReference(id);
-      message.success('删除成功');
-      fetchData();
-    } catch {
-      message.error('删除失败');
-    }
-  };
-
-  const handleReEmbed = async (id: string) => {
-    try {
-      await knowledgeApi.reEmbedReference(id);
-      message.success('向量重新生成已触发');
-    } catch {
-      message.error('向量重新生成失败');
-    }
-  };
-
-  const columns = [
-    { title: '标题', dataIndex: 'title', key: 'title', ellipsis: true },
-    {
-      title: '分析类型',
-      dataIndex: 'analysis_type',
-      key: 'analysis_type',
-      width: 120,
-      render: (v: string) => {
-        const found = ANALYSIS_TYPES.find((t) => t.value === v);
-        return <Tag>{found?.label ?? v}</Tag>;
-      },
-    },
-    { title: '来源', dataIndex: 'source_name', key: 'source_name', width: 150, ellipsis: true },
-    {
-      title: '状态',
-      dataIndex: 'is_enabled',
-      key: 'is_enabled',
-      width: 80,
-      render: (v: boolean) => (
-        <Tag color={v ? 'green' : 'default'}>{v ? '启用' : '禁用'}</Tag>
-      ),
-    },
-    {
-      title: '更新时间',
-      dataIndex: 'updated_at',
-      key: 'updated_at',
-      width: 170,
-      render: (v: string) => (v ? new Date(v).toLocaleString() : '-'),
-    },
-    {
-      title: '操作',
-      key: 'actions',
-      width: 200,
-      render: (_: unknown, record: KnowledgeReference) => (
-        <Space size="small">
-          <Tooltip title="编辑">
-            <Button type="text" icon={<EditOutlined />} onClick={() => openEdit(record)} />
-          </Tooltip>
-          <Tooltip title="重新生成向量">
-            <Button
-              type="text"
-              icon={<ThunderboltOutlined />}
-              onClick={() => handleReEmbed(record.id)}
-            />
-          </Tooltip>
-          <Popconfirm
-            title="确定删除此参考资料？"
-            onConfirm={() => handleDelete(record.id)}
-            okText="删除"
-            cancelText="取消"
-          >
-            <Button type="text" danger icon={<DeleteOutlined />} />
-          </Popconfirm>
-        </Space>
-      ),
-    },
-  ];
-
-  return (
-    <>
-      <Space style={{ marginBottom: 16 }}>
-        <Select
-          allowClear
-          placeholder="按分析类型过滤"
-          style={{ width: 180 }}
-          options={ANALYSIS_TYPES}
-          value={filterType}
-          onChange={setFilterType}
-        />
-        <AuthButton code="ai.knowledge.manage">
-          <Button type="primary" icon={<PlusOutlined />} onClick={openCreate}>
-            新增参考资料
-          </Button>
-        </AuthButton>
-        <Button icon={<ReloadOutlined />} onClick={fetchData}>
-          刷新
-        </Button>
-      </Space>
-
-      <Table
-        rowKey="id"
-        columns={columns}
-        dataSource={data}
-        loading={loading}
-        pagination={{ pageSize: 20, showTotal: (total) => `共 ${total} 条` }}
-        size="small"
-      />
-
-      <Modal
-        title={editing ? '编辑参考资料' : '新增参考资料'}
-        open={modalOpen}
-        onOk={handleSubmit}
-        onCancel={() => setModalOpen(false)}
-        width={600}
-        destroyOnClose
-      >
-        <Form form={form} layout="vertical">
-          <Form.Item name="title" label="标题" rules={[{ required: true, message: '请输入标题' }]}>
-            <Input />
-          </Form.Item>
-          <Form.Item
-            name="analysis_type"
-            label="分析类型"
-            rules={[{ required: true, message: '请选择分析类型' }]}
-          >
-            <Select options={ANALYSIS_TYPES} />
-          </Form.Item>
-          <Form.Item name="source_name" label="来源名称" rules={[{ required: true }]}>
-            <Input />
-          </Form.Item>
-          <Form.Item
-            name="content_summary"
-            label="内容摘要"
-            rules={[{ required: true, message: '请输入内容摘要' }]}
-          >
-            <Input.TextArea rows={4} />
-          </Form.Item>
-          <Form.Item name="is_enabled" label="启用" valuePropName="checked">
-            <Switch />
-          </Form.Item>
-        </Form>
-      </Modal>
-    </>
-  );
-}
-
-// === Guides Tab ===
-
-function GuidesTab() {
-  const [data, setData] = useState<KnowledgeGuide[]>([]);
-  const [loading, setLoading] = useState(false);
-  const [modalOpen, setModalOpen] = useState(false);
-  const [editing, setEditing] = useState<KnowledgeGuide | null>(null);
-  const [filterType, setFilterType] = useState<string | undefined>();
-  const [form] = Form.useForm();
-
-  const fetchData = useCallback(async () => {
-    setLoading(true);
-    try {
-      const result = await knowledgeApi.listGuides(
-        filterType ? { analysis_type: filterType } : undefined,
-      );
-      setData(result.data);
-    } catch {
-      message.error('加载临床指南失败');
-    } finally {
-      setLoading(false);
-    }
-  }, [filterType]);
-
-  useEffect(() => {
-    fetchData();
-  }, [fetchData]);
-
-  const openCreate = () => {
-    setEditing(null);
-    form.resetFields();
-    form.setFieldsValue({ is_enabled: true });
-    setModalOpen(true);
-  };
-
-  const openEdit = (record: KnowledgeGuide) => {
-    setEditing(record);
-    form.setFieldsValue({
-      title: record.title,
-      analysis_type: record.analysis_type,
-      content: record.content,
-      category: record.category,
-      is_enabled: record.is_enabled,
-    });
-    setModalOpen(true);
-  };
-
-  const handleSubmit = async () => {
-    const values = await form.validateFields();
-    try {
-      if (editing) {
-        const req: UpdateGuideReq = {
-          title: values.title,
-          analysis_type: values.analysis_type,
-          content: values.content,
-          category: values.category,
-          is_enabled: values.is_enabled,
-        };
-        await knowledgeApi.updateGuide(editing.id, req);
-        message.success('更新成功');
-      } else {
-        const req: CreateGuideReq = {
-          title: values.title,
-          analysis_type: values.analysis_type,
-          content: values.content,
-          category: values.category,
-          is_enabled: values.is_enabled,
-        };
-        await knowledgeApi.createGuide(req);
-        message.success('创建成功');
-      }
-      setModalOpen(false);
-      fetchData();
-    } catch {
-      message.error(editing ? '更新失败' : '创建失败');
-    }
-  };
-
-  const handleDelete = async (id: string) => {
-    try {
-      await knowledgeApi.deleteGuide(id);
-      message.success('删除成功');
-      fetchData();
-    } catch {
-      message.error('删除失败');
-    }
-  };
-
-  const handleReEmbed = async (id: string) => {
-    try {
-      await knowledgeApi.reEmbedGuide(id);
-      message.success('向量重新生成已触发');
-    } catch {
-      message.error('向量重新生成失败');
-    }
-  };
-
-  const columns = [
-    { title: '标题', dataIndex: 'title', key: 'title', ellipsis: true },
-    {
-      title: '分析类型',
-      dataIndex: 'analysis_type',
-      key: 'analysis_type',
-      width: 120,
-      render: (v: string) => {
-        const found = ANALYSIS_TYPES.find((t) => t.value === v);
-        return <Tag>{found?.label ?? v}</Tag>;
-      },
-    },
-    {
-      title: '分类',
-      dataIndex: 'category',
-      key: 'category',
-      width: 100,
-      render: (v: string | null) => v || '-',
-    },
-    {
-      title: '状态',
-      dataIndex: 'is_enabled',
-      key: 'is_enabled',
-      width: 80,
-      render: (v: boolean) => (
-        <Tag color={v ? 'green' : 'default'}>{v ? '启用' : '禁用'}</Tag>
-      ),
-    },
-    {
-      title: '更新时间',
-      dataIndex: 'updated_at',
-      key: 'updated_at',
-      width: 170,
-      render: (v: string) => (v ? new Date(v).toLocaleString() : '-'),
-    },
-    {
-      title: '操作',
-      key: 'actions',
-      width: 200,
-      render: (_: unknown, record: KnowledgeGuide) => (
-        <Space size="small">
-          <Tooltip title="编辑">
-            <Button type="text" icon={<EditOutlined />} onClick={() => openEdit(record)} />
-          </Tooltip>
-          <Tooltip title="重新生成向量">
-            <Button
-              type="text"
-              icon={<ThunderboltOutlined />}
-              onClick={() => handleReEmbed(record.id)}
-            />
-          </Tooltip>
-          <Popconfirm
-            title="确定删除此临床指南？"
-            onConfirm={() => handleDelete(record.id)}
-            okText="删除"
-            cancelText="取消"
-          >
-            <Button type="text" danger icon={<DeleteOutlined />} />
-          </Popconfirm>
-        </Space>
-      ),
-    },
-  ];
-
-  return (
-    <>
-      <Space style={{ marginBottom: 16 }}>
-        <Select
-          allowClear
-          placeholder="按分析类型过滤"
-          style={{ width: 180 }}
-          options={ANALYSIS_TYPES}
-          value={filterType}
-          onChange={setFilterType}
-        />
-        <AuthButton code="ai.knowledge.manage">
-          <Button type="primary" icon={<PlusOutlined />} onClick={openCreate}>
-            新增临床指南
-          </Button>
-        </AuthButton>
-        <Button icon={<ReloadOutlined />} onClick={fetchData}>
-          刷新
-        </Button>
-      </Space>
-
-      <Table
-        rowKey="id"
-        columns={columns}
-        dataSource={data}
-        loading={loading}
-        pagination={{ pageSize: 20, showTotal: (total) => `共 ${total} 条` }}
-        size="small"
-      />
-
-      <Modal
-        title={editing ? '编辑临床指南' : '新增临床指南'}
-        open={modalOpen}
-        onOk={handleSubmit}
-        onCancel={() => setModalOpen(false)}
-        width={700}
-        destroyOnClose
-      >
-        <Form form={form} layout="vertical">
-          <Form.Item name="title" label="标题" rules={[{ required: true, message: '请输入标题' }]}>
-            <Input />
-          </Form.Item>
-          <Form.Item
-            name="analysis_type"
-            label="分析类型"
-            rules={[{ required: true, message: '请选择分析类型' }]}
-          >
-            <Select options={ANALYSIS_TYPES} />
-          </Form.Item>
-          <Form.Item name="category" label="分类">
-            <Input placeholder="如：心血管、内分泌" />
-          </Form.Item>
-          <Form.Item
-            name="content"
-            label="指南内容"
-            rules={[{ required: true, message: '请输入指南内容' }]}
-          >
-            <Input.TextArea rows={8} />
-          </Form.Item>
-          <Form.Item name="is_enabled" label="启用" valuePropName="checked">
-            <Switch />
-          </Form.Item>
-        </Form>
-      </Modal>
-    </>
-  );
-}

apps/web/src/pages/health/AiPromptList.tsx

@@ -3,36 +3,68 @@ import {
   Table,
   Button,
   Space,
-  Modal,
   Form,
   Input,
   Select,
   Tag,
+  Badge,
   message,
+  Drawer,
+  Descriptions,
+  Typography,
+  Slider,
+  InputNumber,
+  Modal,
 } from 'antd';
-import { PlusOutlined, UndoOutlined, CheckOutlined } from '@ant-design/icons';
-import { promptApi, type PromptItem, type CreatePromptReq } from '../../api/ai/prompts';
+import {
+  PlusOutlined,
+  UndoOutlined,
+  CheckOutlined,
+  EyeOutlined,
+  StopOutlined,
+  DeleteOutlined,
+} from '@ant-design/icons';
+import { promptApi, type PromptItem } from '../../api/ai/prompts';
 import { AuthButton } from '../../components/AuthButton';
+import { DrawerForm } from '../../components/DrawerForm';
+import type { FormSection } from '../../components/DrawerForm';
+import { PageContainer } from '../../components/PageContainer';
 import { useThemeMode } from '../../hooks/useThemeMode';
+import { formatDateTime } from '../../utils/format';
 
-const CATEGORIES = [
-  { value: 'lab_report_interpretation', label: '化验单解读' },
-  { value: 'health_trend_analysis', label: '趋势分析' },
-  { value: 'personalized_checkup_plan', label: '体检方案' },
-  { value: 'report_summary_generation', label: '报告摘要' },
+// --- 分析类型定义（与后端 AnalysisType::prompt_name() 一一对应） ---
+
+const ANALYSIS_TYPES = [
+  { value: 'lab_report_interpretation', label: '化验单解读', api: '化验单解读 API' },
+  { value: 'health_trend_analysis', label: '趋势分析', api: '趋势分析 API' },
+  { value: 'personalized_checkup_plan', label: '体检方案', api: '体检方案 API' },
+  { value: 'report_summary_generation', label: '报告摘要', api: '报告摘要 API' },
+  { value: 'follow_up_summary_generation', label: '随访摘要', api: '随访摘要 API' },
+] as const;
+
+const ANALYSIS_TYPE_MAP = Object.fromEntries(
+  ANALYSIS_TYPES.map((t) => [t.value, t]),
+);
+
+const MODEL_OPTIONS = [
+  { value: 'deepseek-chat', label: 'DeepSeek Chat' },
+  { value: 'deepseek-reasoner', label: 'DeepSeek Reasoner' },
+  { value: 'claude-sonnet-4-20250514', label: 'Claude Sonnet 4' },
+  { value: 'gpt-4o', label: 'GPT-4o' },
+  { value: 'qwen-plus', label: 'Qwen Plus' },
 ];
 
-const CATEGORY_MAP: Record<string, string> = Object.fromEntries(
-  CATEGORIES.map((c) => [c.value, c.label]),
-);
+const DEFAULT_MODEL_CONFIG = { model: 'deepseek-chat', temperature: 0.7, max_tokens: 4096 };
 
 export default function AiPromptList() {
   const [data, setData] = useState<PromptItem[]>([]);
   const [total, setTotal] = useState(0);
   const [page, setPage] = useState(1);
   const [loading, setLoading] = useState(false);
-  const [categoryFilter, setCategoryFilter] = useState<string | undefined>();
-  const [modalOpen, setModalOpen] = useState(false);
+  const [analysisTypeFilter, setAnalysisTypeFilter] = useState<string | undefined>();
+  const [drawerOpen, setDrawerOpen] = useState(false);
+  const [detailOpen, setDetailOpen] = useState(false);
+  const [viewing, setViewing] = useState<PromptItem | null>(null);
   const [form] = Form.useForm();
   const isDark = useThemeMode();
 
@@ -43,7 +75,7 @@ export default function AiPromptList() {
         const result = await promptApi.list({
           page: p,
           page_size: 20,
-          category: categoryFilter,
+          analysis_type: analysisTypeFilter,
         });
         setData(result.data);
         setTotal(result.total);
@@ -53,18 +85,29 @@ export default function AiPromptList() {
         setLoading(false);
       }
     },
-    [page, categoryFilter],
+    [page, analysisTypeFilter],
   );
 
   useEffect(() => {
     fetchData();
   }, [fetchData]);
 
-  const handleCreate = async (values: CreatePromptReq) => {
+  const handleCreate = async (values: Record<string, unknown>) => {
+    const model = String(values.model ?? 'deepseek-chat');
+    const temperature = Number(values.temperature ?? 0.7);
+    const max_tokens = Number(values.max_tokens ?? 4096);
     try {
-      await promptApi.create(values);
+      await promptApi.create({
+        name: String(values.name ?? ''),
+        analysis_type: String(values.analysis_type ?? ''),
+        category: String(values.analysis_type ?? ''),
+        description: values.description ? String(values.description) : undefined,
+        system_prompt: String(values.system_prompt ?? ''),
+        user_prompt_template: String(values.user_prompt_template ?? ''),
+        model_config: { model, temperature, max_tokens },
+      });
       message.success('Prompt 创建成功');
-      setModalOpen(false);
+      setDrawerOpen(false);
       form.resetFields();
       fetchData();
     } catch {
@@ -72,7 +115,7 @@ export default function AiPromptList() {
     }
   };
 
-  const handleActivate = async (id: string) => {
+  const handleActivate = useCallback(async (id: string) => {
     try {
       await promptApi.activate(id);
       message.success('已激活');
@@ -80,9 +123,19 @@ export default function AiPromptList() {
     } catch {
       message.error('激活失败');
     }
-  };
+  }, [fetchData]);
 
-  const handleRollback = async (id: string) => {
+  const handleDeactivate = useCallback(async (id: string) => {
+    try {
+      await promptApi.deactivate(id);
+      message.success('已停用');
+      fetchData();
+    } catch {
+      message.error('停用失败');
+    }
+  }, [fetchData]);
+
+  const handleRollback = useCallback(async (id: string) => {
     try {
       await promptApi.rollback(id);
       message.success('已回滚');
@@ -90,31 +143,78 @@ export default function AiPromptList() {
     } catch {
       message.error('回滚失败');
     }
+  }, [fetchData]);
+
+  const handleDelete = useCallback((record: PromptItem) => {
+    Modal.confirm({
+      title: '确认删除',
+      content: `确定要删除 Prompt「${record.name}」(v${record.version}) 吗？`,
+      okType: 'danger',
+      onOk: async () => {
+        try {
+          await promptApi.delete(record.id);
+          message.success('删除成功');
+          fetchData();
+        } catch {
+          message.error('删除失败');
+        }
+      },
+    });
+  }, [fetchData]);
+
+  const openDetail = (record: PromptItem) => {
+    setViewing(record);
+    setDetailOpen(true);
   };
 
+  // 按 analysis_type 汇总当前激活版本
+  const activeVersionMap = useMemo(() => {
+    const map = new Map<string, number>();
+    for (const item of data) {
+      if (item.is_active) {
+        map.set(item.analysis_type, item.version);
+      }
+    }
+    return map;
+  }, [data]);
+
   const columns = useMemo(() => [
     {
       title: '名称',
       dataIndex: 'name',
       key: 'name',
-      width: 180,
+      width: 160,
       render: (name: string) => <span style={{ fontWeight: 500 }}>{name}</span>,
     },
     {
-      title: '类别',
-      dataIndex: 'category',
-      key: 'category',
-      width: 120,
-      render: (v: string) => (
-        <Tag color="blue">{CATEGORY_MAP[v] || v}</Tag>
-      ),
+      title: '分析类型',
+      dataIndex: 'analysis_type',
+      key: 'analysis_type',
+      width: 130,
+      render: (v: string) => {
+        const cfg = ANALYSIS_TYPE_MAP[v];
+        return cfg ? <Tag color="blue">{cfg.label}</Tag> : <Tag>{v}</Tag>;
+      },
+    },
+    {
+      title: '调用链路',
+      dataIndex: 'analysis_type',
+      key: 'api_route',
+      width: 160,
+      render: (v: string) => {
+        const cfg = ANALYSIS_TYPE_MAP[v];
+        return <Typography.Text type="secondary" style={{ fontSize: 12 }}>{cfg?.api ?? v}</Typography.Text>;
+      },
     },
     {
       title: '版本',
       dataIndex: 'version',
       key: 'version',
       width: 70,
-      render: (v: number) => `v${v}`,
+      render: (v: number, record: PromptItem) => {
+        const isActive = activeVersionMap.get(record.analysis_type) === v && record.is_active;
+        return isActive ? <Tag color="green">v{v}</Tag> : <span>v{v}</span>;
+      },
     },
     {
       title: '状态',
@@ -122,7 +222,7 @@ export default function AiPromptList() {
       key: 'is_active',
       width: 80,
       render: (v: boolean) => (
-        <Tag color={v ? 'green' : 'default'}>{v ? '启用' : '停用'}</Tag>
+        <Badge status={v ? 'success' : 'default'} text={v ? '启用' : '停用'} />
       ),
     },
     {
@@ -130,145 +230,247 @@ export default function AiPromptList() {
       dataIndex: 'updated_at',
       key: 'updated_at',
       width: 170,
-      render: (v: string) => (v ? new Date(v).toLocaleString('zh-CN') : '-'),
+      render: (v: string) => formatDateTime(v),
     },
     {
       title: '操作',
       key: 'actions',
-      width: 160,
+      width: 220,
       render: (_: unknown, record: PromptItem) => (
         <AuthButton code="ai.prompt.manage">
           <Space size={4}>
+            <Button type="link" size="small" icon={<EyeOutlined />} onClick={() => openDetail(record)}>
+              查看
+            </Button>
             {!record.is_active && (
-              <Button
-                type="link"
-                size="small"
-                icon={<CheckOutlined />}
-                onClick={() => handleActivate(record.id)}
-              >
+              <Button type="link" size="small" icon={<CheckOutlined />} onClick={() => handleActivate(record.id)}>
                 激活
               </Button>
             )}
-            <Button
-              type="link"
-              size="small"
-              icon={<UndoOutlined />}
-              onClick={() => handleRollback(record.id)}
-            >
+            {record.is_active && (
+              <Button type="link" size="small" icon={<StopOutlined />} onClick={() => handleDeactivate(record.id)}>
+                停用
+              </Button>
+            )}
+            <Button type="link" size="small" icon={<UndoOutlined />} onClick={() => handleRollback(record.id)}>
               回滚
             </Button>
+            <Button type="link" size="small" danger icon={<DeleteOutlined />} onClick={() => handleDelete(record)}>
+              删除
+            </Button>
           </Space>
         </AuthButton>
       ),
     },
-  ], [handleActivate, handleRollback]);
+  ], [handleActivate, handleDeactivate, handleRollback, handleDelete, activeVersionMap]);
 
-  return (
-    <div>
-      <div className="erp-page-header">
-        <div>
-          <h4>AI Prompt 管理</h4>
-          <div className="erp-page-subtitle">管理 AI 分析提示词模板和版本</div>
-        </div>
-        <Space size={8}>
-          <Select
-            placeholder="筛选类别"
-            value={categoryFilter}
-            onChange={(v) => {
-              setCategoryFilter(v);
-              setPage(1);
-            }}
-            options={CATEGORIES}
-            allowClear
-            style={{ width: 150 }}
-          />
-          <AuthButton code="ai.prompt.manage">
-            <Button
-              type="primary"
-              icon={<PlusOutlined />}
-              onClick={() => {
-                form.resetFields();
-                setModalOpen(true);
-              }}
-            >
-              新建 Prompt
-            </Button>
-          </AuthButton>
-        </Space>
-      </div>
-
-      <div
-        style={{
-          background: isDark ? '#111827' : '#FFFFFF',
-          borderRadius: 12,
-          border: `1px solid ${isDark ? '#0f172a' : '#f8fafc'}`,
-          overflow: 'hidden',
-        }}
-      >
-        <Table
-          columns={columns}
-          dataSource={data}
-          rowKey="id"
-          loading={loading}
-          pagination={{
-            current: page,
-            total,
-            pageSize: 20,
-            onChange: (p) => {
-              setPage(p);
-              fetchData(p);
-            },
-            showTotal: (t) => `共 ${t} 条记录`,
-            style: { padding: '12px 16px', margin: 0 },
-          }}
-        />
-      </div>
-
-      <Modal
-        title="新建 Prompt"
-        open={modalOpen}
-        onCancel={() => setModalOpen(false)}
-        onOk={() => form.submit()}
-        width={600}
-        destroyOnHidden
-      >
-        <Form form={form} onFinish={handleCreate} layout="vertical" style={{ marginTop: 16 }}>
+  const formSections: FormSection[] = [
+    {
+      title: '基本信息',
+      fields: (
+        <>
+          <Form.Item
+            name="analysis_type"
+            label="分析类型"
+            rules={[{ required: true, message: '请选择分析类型' }]}
+            extra="选择后自动填充名称，决定该 Prompt 被哪条分析链路调用"
+          >
+            <Select
+              options={ANALYSIS_TYPES.map((t) => ({ value: t.value, label: t.label }))}
+              placeholder="选择分析类型"
+            />
+          </Form.Item>
           <Form.Item
             name="name"
-            label="名称"
-            rules={[{ required: true, message: '请输入 Prompt 名称' }]}
+            label="标识符"
+            rules={[
+              { required: true, message: '请输入标识符' },
+              { pattern: /^[a-z0-9_]{3,64}$/, message: '仅允许小写字母、数字、下划线，3-64位' },
+            ]}
+            extra="后端按此标识符查找 Prompt，通常与分析类型一致，非必要勿改"
           >
-            <Input placeholder="如：化验单解读 V2" />
-          </Form.Item>
-          <Form.Item name="category" label="类别" rules={[{ required: true, message: '请选择类别' }]}>
-            <Select options={CATEGORIES} placeholder="选择类别" />
+            <Input placeholder="如 lab_report_interpretation" />
           </Form.Item>
           <Form.Item name="description" label="描述">
-            <Input.TextArea rows={2} placeholder="Prompt 用途说明" />
+            <Input.TextArea rows={2} placeholder="Prompt 用途说明（仅展示，不影响选择）" />
           </Form.Item>
+        </>
+      ),
+    },
+    {
+      title: '模型配置',
+      fields: (
+        <>
+          <Form.Item name="model" label="模型" rules={[{ required: true, message: '请选择模型' }]}>
+            <Select options={MODEL_OPTIONS} placeholder="选择 AI 模型" />
+          </Form.Item>
+          <Form.Item name="temperature" label="Temperature" extra="越低越确定，越高越多样">
+            <Slider min={0} max={2} step={0.1} />
+          </Form.Item>
+          <Form.Item name="max_tokens" label="Max Tokens">
+            <InputNumber min={256} max={8192} step={256} style={{ width: '100%' }} placeholder="4096" />
+          </Form.Item>
+        </>
+      ),
+    },
+    {
+      title: '提示词模板',
+      fields: (
+        <>
           <Form.Item
             name="system_prompt"
             label="System Prompt"
             rules={[{ required: true, message: '请输入 System Prompt' }]}
           >
-            <Input.TextArea rows={4} placeholder="系统提示词" />
+            <Input.TextArea rows={6} placeholder="系统提示词，定义 AI 的角色和行为规则" />
           </Form.Item>
           <Form.Item
             name="user_prompt_template"
             label="User Prompt 模板"
             rules={[{ required: true, message: '请输入 User Prompt 模板' }]}
+            extra="支持 Handlebars {{变量}} 语法，如 {{patient_name}}、{{report_date}}"
           >
-            <Input.TextArea rows={4} placeholder="用户提示词模板，可用 {{变量}} 占位" />
+            <Input.TextArea rows={6} placeholder="用户提示词模板，可用 {{变量}} 占位" />
           </Form.Item>
-          <Form.Item
-            name="model_config"
-            label="模型配置 (JSON)"
-            initialValue={{ model: 'deepseek-chat', temperature: 0.7 }}
+        </>
+      ),
+    },
+  ];
+
+  return (
+    <PageContainer
+      title="AI Prompt 管理"
+      subtitle="管理 AI 分析提示词模板和版本"
+      filters={
+        <Select
+          placeholder="筛选分析类型"
+          value={analysisTypeFilter}
+          onChange={(v) => {
+            setAnalysisTypeFilter(v);
+            setPage(1);
+          }}
+          options={ANALYSIS_TYPES.map((t) => ({ value: t.value, label: t.label }))}
+          allowClear
+          style={{ width: 160 }}
+        />
+      }
+      actions={
+        <AuthButton code="ai.prompt.manage">
+          <Button
+            type="primary"
+            icon={<PlusOutlined />}
+            onClick={() => {
+              form.resetFields();
+              form.setFieldsValue(DEFAULT_MODEL_CONFIG);
+              setDrawerOpen(true);
+            }}
           >
-            <Input.TextArea rows={3} placeholder='{"model": "deepseek-chat", "temperature": 0.7}' />
-          </Form.Item>
-        </Form>
-      </Modal>
-    </div>
+            新建 Prompt
+          </Button>
+        </AuthButton>
+      }
+    >
+      <Table
+        columns={columns}
+        dataSource={data}
+        rowKey="id"
+        loading={loading}
+        pagination={{
+          current: page,
+          total,
+          pageSize: 20,
+          onChange: (p) => {
+            setPage(p);
+            fetchData(p);
+          },
+          showTotal: (t) => `共 ${t} 条记录`,
+        }}
+      />
+
+      {/* 新建 Prompt Drawer */}
+      <DrawerForm
+        title="新建 Prompt"
+        open={drawerOpen}
+        onClose={() => setDrawerOpen(false)}
+        onSubmit={handleCreate}
+        form={form}
+        onValuesChange={(changed) => {
+          if ('analysis_type' in changed && changed.analysis_type) {
+            form.setFieldValue('name', changed.analysis_type);
+          }
+        }}
+        initialValues={{
+          ...DEFAULT_MODEL_CONFIG,
+          category: '',
+          analysis_type: undefined,
+          name: '',
+          description: '',
+        }}
+        width={720}
+        columns={1}
+        sections={formSections}
+      />
+
+      {/* 查看 Prompt 详情 */}
+      <Drawer
+        title={viewing ? `${viewing.name} (v${viewing.version})` : 'Prompt 详情'}
+        open={detailOpen}
+        onClose={() => { setDetailOpen(false); setViewing(null); }}
+        width={640}
+        styles={{ body: { background: isDark ? '#141414' : undefined } }}
+      >
+        {viewing && (
+          <>
+            <Descriptions column={2} size="small" style={{ marginBottom: 16 }}>
+              <Descriptions.Item label="分析类型">
+                <Tag color="blue">{ANALYSIS_TYPE_MAP[viewing.analysis_type]?.label ?? viewing.analysis_type}</Tag>
+              </Descriptions.Item>
+              <Descriptions.Item label="标识符">
+                <Typography.Text code style={{ fontSize: 12 }}>{viewing.analysis_type}</Typography.Text>
+              </Descriptions.Item>
+              <Descriptions.Item label="状态">
+                <Badge status={viewing.is_active ? 'success' : 'default'} text={viewing.is_active ? '启用' : '停用'} />
+              </Descriptions.Item>
+              <Descriptions.Item label="版本">v{viewing.version}</Descriptions.Item>
+              <Descriptions.Item label="调用链路" span={2}>
+                <Typography.Text type="secondary">{ANALYSIS_TYPE_MAP[viewing.analysis_type]?.api ?? viewing.analysis_type}</Typography.Text>
+              </Descriptions.Item>
+              <Descriptions.Item label="更新时间">{formatDateTime(viewing.updated_at)}</Descriptions.Item>
+            </Descriptions>
+
+            {viewing.description && (
+              <div style={{ marginBottom: 16 }}>
+                <Typography.Text type="secondary" style={{ fontSize: 12 }}>描述</Typography.Text>
+                <div style={{ marginTop: 4 }}>{viewing.description}</div>
+              </div>
+            )}
+
+            {[
+              { label: 'System Prompt', content: viewing.system_prompt },
+              { label: 'User Prompt 模板', content: viewing.user_prompt_template },
+              { label: '模型配置', content: JSON.stringify(viewing.model_config, null, 2) },
+            ].map(({ label, content }) => (
+              <div key={label} style={{ marginBottom: 16 }}>
+                <Typography.Text type="secondary" style={{ fontSize: 12 }}>{label}</Typography.Text>
+                <pre style={{
+                  marginTop: 4,
+                  padding: 12,
+                  background: isDark ? '#1e293b' : '#f8fafc',
+                  borderRadius: 8,
+                  fontSize: 13,
+                  lineHeight: 1.6,
+                  whiteSpace: 'pre-wrap',
+                  wordBreak: 'break-word',
+                  maxHeight: 300,
+                  overflow: 'auto',
+                }}>
+                  {content}
+                </pre>
+              </div>
+            ))}
+          </>
+        )}
+      </Drawer>
+    </PageContainer>
   );
 }

apps/web/src/pages/health/ArticleCategoryManage.tsx

@@ -57,7 +57,7 @@ export default function ArticleCategoryManage() {
     setModalOpen(true);
   };
 
-  const openEditModal = (record: ArticleCategory) => {
+  const openEditModal = useCallback((record: ArticleCategory) => {
     setEditingCategory(record);
     form.setFieldsValue({
       name: record.name,
@@ -67,7 +67,7 @@ export default function ArticleCategoryManage() {
       description: record.description,
     });
     setModalOpen(true);
-  };
+  }, [form]);
 
   const closeModal = () => {
     setModalOpen(false);
@@ -111,15 +111,15 @@ export default function ArticleCategoryManage() {
     }
   };
 
-  const handleDelete = async (id: string) => {
+  const handleDelete = useCallback(async (record: ArticleCategory) => {
     try {
-      await articleCategoryApi.delete(id);
+      await articleCategoryApi.delete(record.id, record.version ?? 0);
       message.success('分类已删除');
       fetchCategories();
     } catch {
       message.error('删除失败，可能该分类下还有文章');
     }
-  };
+  }, [fetchCategories]);
 
   // 构建父分类选项（排除自身）
   const parentOptions = categories
@@ -184,7 +184,7 @@ export default function ArticleCategoryManage() {
             <Popconfirm
               title="确定删除此分类？"
               description="删除后不可恢复，关联文章将变为未分类"
-              onConfirm={() => handleDelete(record.id)}
+              onConfirm={() => handleDelete(record)}
             >
               <Button size="small" type="text" icon={<DeleteOutlined />} danger />
             </Popconfirm>

apps/web/src/pages/health/ArticleManageList.tsx

@@ -119,7 +119,7 @@ export default function ArticleManageList() {
       .catch((err) => console.warn('[ArticleManageList] 获取文章分类失败:', err));
   }, []);
 
-  const handleDelete = async (id: string, version: number) => {
+  const handleDelete = useCallback(async (id: string, version: number) => {
     try {
       await articleApi.delete(id, version);
       message.success('文章已删除');
@@ -127,9 +127,9 @@ export default function ArticleManageList() {
     } catch {
       message.error('删除失败');
     }
-  };
+  }, [refresh]);
 
-  const handleSubmit = async (record: ArticleListItem) => {
+  const handleSubmit = useCallback(async (record: ArticleListItem) => {
     try {
       await articleApi.submit(record.id, record.version);
       message.success('已提交审核');
@@ -137,9 +137,9 @@ export default function ArticleManageList() {
     } catch {
       message.error('提交审核失败');
     }
-  };
+  }, [refresh]);
 
-  const handleApprove = async (record: ArticleListItem) => {
+  const handleApprove = useCallback(async (record: ArticleListItem) => {
     try {
       await articleApi.approve(record.id, record.version);
       message.success('审核通过，文章已发布');
@@ -147,13 +147,13 @@ export default function ArticleManageList() {
     } catch {
       message.error('审核操作失败');
     }
-  };
+  }, [refresh]);
 
-  const openRejectModal = (record: ArticleListItem) => {
+  const openRejectModal = useCallback((record: ArticleListItem) => {
     setRejectingArticle(record);
     rejectForm.resetFields();
     setRejectModalOpen(true);
-  };
+  }, [rejectForm]);
 
   const handleReject = async (values: { review_note: string }) => {
     if (!rejectingArticle) return;
@@ -167,7 +167,7 @@ export default function ArticleManageList() {
     }
   };
 
-  const handleUnpublish = async (record: ArticleListItem) => {
+  const handleUnpublish = useCallback(async (record: ArticleListItem) => {
     try {
       await articleApi.unpublish(record.id, record.version);
       message.success('文章已撤回为草稿');
@@ -175,9 +175,9 @@ export default function ArticleManageList() {
     } catch {
       message.error('撤回操作失败');
     }
-  };
+  }, [refresh]);
 
-  const renderActions = (record: ArticleListItem) => (
+  const renderActions = useCallback((record: ArticleListItem) => (
     <Space size={4} wrap>
       {record.status === 'draft' && (
         <>
@@ -252,7 +252,7 @@ export default function ArticleManageList() {
         </AuthButton>
       )}
     </Space>
-  );
+  ), [navigate, handleSubmit, handleApprove, openRejectModal, handleUnpublish, handleDelete]);
 
   const columns = useMemo(() => [
     {
@@ -410,7 +410,7 @@ export default function ArticleManageList() {
             <Button size="small" type="text" icon={<EditOutlined />}
               onClick={() => { setCatEditing(record); catForm.setFieldsValue(record); setCatModalOpen(true); }} />
             <Popconfirm title="确定删除？" onConfirm={async () => {
-              try { await articleCategoryApi.delete(record.id); message.success('已删除'); fetchCategories(); } catch { message.error('删除失败'); }
+              try { await articleCategoryApi.delete(record.id, record.version ?? 0); message.success('已删除'); fetchCategories(); } catch { message.error('删除失败'); }
             }}>
               <Button size="small" type="text" icon={<DeleteOutlined />} danger />
             </Popconfirm>
@@ -522,7 +522,6 @@ export default function ArticleManageList() {
           </Button>
         </AuthButton>
       )}
-      loading={loading}
     >
       <Tabs
         activeKey={activePageTab}

apps/web/src/pages/health/PointsProductList.tsx

@@ -11,12 +11,15 @@ import {
   Tag,
   Badge,
   Switch,
+  Upload,
   message,
 } from 'antd';
 import {
   PlusOutlined,
   EditOutlined,
   DeleteOutlined,
+  PictureOutlined,
+  UploadOutlined,
 } from '@ant-design/icons';
 import {
   pointsApi,
@@ -26,8 +29,11 @@ import {
 import { AuthButton } from '../../components/AuthButton';
 import { DrawerForm } from '../../components/DrawerForm';
 import type { FormSection } from '../../components/DrawerForm';
+import MediaPicker from '../../components/MediaPicker';
 import { PageContainer } from '../../components/PageContainer';
+import { uploadFile } from '../../api/upload';
 import { usePaginatedData } from '../../hooks/usePaginatedData';
+import { useThemeMode } from '../../hooks/useThemeMode';
 import { formatDateTime } from '../../utils/format';
 
 /** 商品类型映射 */
@@ -59,6 +65,9 @@ interface ProductFilters {
 export default function PointsProductList() {
   const [modalOpen, setModalOpen] = useState(false);
   const [editing, setEditing] = useState<PointsProduct | null>(null);
+  const [mediaPickerOpen, setMediaPickerOpen] = useState(false);
+  const [imageUrl, setImageUrl] = useState<string>('');
+  const isDark = useThemeMode();
 
   const fetchProducts = useCallback(
     async (page: number, pageSize: number, filters: ProductFilters) => {
@@ -94,11 +103,13 @@ export default function PointsProductList() {
   // ---- 新建 / 编辑 ----
   const openCreate = () => {
     setEditing(null);
+    setImageUrl('');
     setModalOpen(true);
   };
 
   const openEdit = (record: PointsProduct) => {
     setEditing(record);
+    setImageUrl(record.image_url || '');
     setModalOpen(true);
   };
 
@@ -115,12 +126,14 @@ export default function PointsProductList() {
         points_cost: number;
         stock: number;
         description?: string;
-        image_url?: string;
         sort_order?: number;
       };
+      // 保存时去掉 URL 中的 ?token= 参数（token 是临时的，不应持久化）
+      const cleanImageUrl = imageUrl ? imageUrl.replace(/\?token=.*$/, '') : undefined;
       if (editing) {
         await pointsApi.updateProduct(editing.id, {
           ...typed,
+          image_url: cleanImageUrl,
           version: editing.version,
         });
       } else {
@@ -130,7 +143,7 @@ export default function PointsProductList() {
           points_cost: typed.points_cost,
           stock: typed.stock,
           description: typed.description,
-          image_url: typed.image_url,
+          image_url: cleanImageUrl,
           sort_order: typed.sort_order,
         };
         await pointsApi.createProduct(req);
@@ -138,8 +151,9 @@ export default function PointsProductList() {
       message.success(editing ? '更新成功' : '创建成功');
       handleCloseDrawer();
       refresh(page);
-    } catch {
-      message.error(editing ? '更新失败' : '创建失败');
+    } catch (err: unknown) {
+      const apiMsg = (err as { response?: { data?: { message?: string } } })?.response?.data?.message;
+      message.error(apiMsg || (editing ? '更新失败' : '创建失败'));
     }
   };
 
@@ -309,8 +323,51 @@ export default function PointsProductList() {
       title: '展示设置',
       fields: (
         <>
-          <Form.Item name="image_url" label="图片链接">
-            <Input placeholder="商品图片 URL" />
+          <Form.Item label="商品图片">
+            <Space.Compact style={{ width: '100%' }}>
+              <Input
+                value={imageUrl}
+                onChange={(e) => setImageUrl(e.target.value)}
+                placeholder="输入 URL 或从媒体库选择"
+                style={{ flex: 1 }}
+              />
+              <Button icon={<PictureOutlined />} onClick={() => setMediaPickerOpen(true)}>
+                媒体库
+              </Button>
+              <Upload
+                accept="image/*"
+                showUploadList={false}
+                beforeUpload={async (file) => {
+                  try {
+                    const result = await uploadFile(file);
+                    setImageUrl(result.url);
+                    message.success('图片上传成功');
+                  } catch {
+                    message.error('图片上传失败');
+                  }
+                  return false;
+                }}
+              >
+                <Button icon={<UploadOutlined />}>上传</Button>
+              </Upload>
+            </Space.Compact>
+            {imageUrl && (
+              <div
+                style={{
+                  marginTop: 8,
+                  borderRadius: 8,
+                  overflow: 'hidden',
+                  border: `1px solid ${isDark ? '#1e293b' : '#e2e8f0'}`,
+                }}
+              >
+                <img
+                  src={imageUrl}
+                  alt="商品图片预览"
+                  style={{ width: '100%', height: 120, objectFit: 'cover' }}
+                  onError={(e) => { (e.target as HTMLImageElement).style.display = 'none'; }}
+                />
+              </div>
+            )}
           </Form.Item>
           <Form.Item name="sort_order" label="排序">
             <InputNumber min={0} max={9999} style={{ width: '100%' }} placeholder="0" />
@@ -394,7 +451,6 @@ export default function PointsProductList() {
               points_cost: editing.points_cost,
               stock: editing.stock,
               description: editing.description,
-              image_url: editing.image_url,
               sort_order: editing.sort_order,
             }
           : { stock: -1, sort_order: 0 }}
@@ -403,6 +459,15 @@ export default function PointsProductList() {
         columns={2}
         sections={formSections}
       />
+
+      <MediaPicker
+        open={mediaPickerOpen}
+        onClose={() => setMediaPickerOpen(false)}
+        onSelect={(url) => {
+          setImageUrl(url);
+          message.success('已选择图片');
+        }}
+      />
     </PageContainer>
   );
 }

apps/web/src/pages/health/PointsRuleList.tsx

@@ -142,8 +142,9 @@ export default function PointsRuleList() {
       setModalOpen(false);
       form.resetFields();
       fetchData();
-    } catch {
-      message.error(editing ? '更新失败' : '创建失败');
+    } catch (err: unknown) {
+      const apiMsg = (err as { response?: { data?: { message?: string } } })?.response?.data?.message;
+      message.error(apiMsg || (editing ? '更新失败' : '创建失败'));
     }
   };
 

apps/web/src/pages/health/StatisticsDashboard/AdminDashboard.tsx

@@ -6,11 +6,13 @@ import {
   MedicineBoxOutlined,
   UserOutlined,
 } from '@ant-design/icons';
+import { useNavigate } from 'react-router-dom';
 import { useStatsData } from './useStatsData';
 import { useCountUp } from '../../../hooks/useCountUp';
 import HealthDataCenter from './HealthDataCenter';
 
 export function AdminDashboard() {
+  const navigate = useNavigate();
   const { patientStats, followUpStats, healthDataStats, dialysisStats, doctorCount, loading } = useStatsData();
   const patientCount = useCountUp(patientStats?.total_patients ?? 0);
   const appointmentCount = useCountUp(healthDataStats?.appointments?.this_month ?? 0);
@@ -18,39 +20,51 @@ export function AdminDashboard() {
 
   if (loading && !patientStats) return <Spin size="large" style={{ display: 'block', margin: '80px auto' }} />;
 
+  const newThisMonth = patientStats?.new_this_month ?? 0;
+  const newThisWeek = patientStats?.new_this_week ?? 0;
+
   return (
     <div>
       <Flex justify="space-between" align="center" style={{ marginBottom: 24 }}>
         <div>
           <Typography.Title level={4} style={{ margin: 0 }}>管理中心</Typography.Title>
-          <Typography.Text type="secondary">数据概览</Typography.Text>
+          <Typography.Text type="secondary">
+            患者增长 {newThisMonth > 0 ? `本月+${newThisMonth}` : ''} · 本周+{newThisWeek} · 活跃 {patientStats?.active_this_month ?? 0}
+          </Typography.Text>
         </div>
       </Flex>
 
       <Row gutter={[16, 16]}>
         <Col xs={12} sm={8} lg={4}>
-          <Card size="small">
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/patients')}>
             <Statistic title="患者总数" value={patientCount} prefix={<TeamOutlined />} />
           </Card>
         </Col>
         <Col xs={12} sm={8} lg={4}>
-          <Card size="small">
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/appointments')}>
             <Statistic title="本月预约" value={appointmentCount} prefix={<CalendarOutlined />} />
           </Card>
         </Col>
         <Col xs={12} sm={8} lg={4}>
-          <Card size="small">
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/follow-up-tasks')}>
             <Statistic
               title="随访完成"
               value={followUpStats?.completion_rate ?? 0}
               precision={0}
               suffix="%"
               prefix={<SafetyCertificateOutlined />}
+              suffix={
+                <span style={{ fontSize: 12 }}>
+                  % {followUpStats && followUpStats.overdue > 0 && (
+                    <Typography.Text type="danger" style={{ fontSize: 11 }}>({followUpStats.overdue}逾期)</Typography.Text>
+                  )}
+                </span>
+              }
             />
           </Card>
         </Col>
         <Col xs={12} sm={8} lg={4}>
-          <Card size="small">
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/daily-monitoring')}>
             <Statistic
               title="体征上报"
               value={healthDataStats?.vital_signs_report_rate?.report_rate ?? 0}
@@ -61,10 +75,20 @@ export function AdminDashboard() {
           </Card>
         </Col>
         <Col xs={12} sm={8} lg={4}>
-          <Card size="small">
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/doctors')}>
             <Statistic title="医护人数" value={doctorCountDisplay} prefix={<UserOutlined />} />
           </Card>
         </Col>
+        <Col xs={12} sm={8} lg={4}>
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/consultations')}>
+            <Statistic
+              title="咨询待回复"
+              value={healthDataStats ? 0 : 0}
+              prefix={<TeamOutlined />}
+              valueStyle={{ color: '#d97706' }}
+            />
+          </Card>
+        </Col>
       </Row>
 
       {/* 健康数据中心 Tab */}

apps/web/src/pages/health/StatisticsDashboard/DoctorDashboard.tsx

@@ -2,9 +2,10 @@ import { Row, Col, Card, Statistic, List, Tag, Spin, Typography, Flex, Space, Bu
 import {
   TeamOutlined,
   MessageOutlined,
-  SafetyCertificateOutlined,
   MedicineBoxOutlined,
+  CalendarOutlined,
   ArrowUpOutlined,
+  ArrowDownOutlined,
   AlertOutlined,
   RightOutlined,
 } from '@ant-design/icons';
@@ -137,7 +138,7 @@ export function DoctorDashboard() {
 
         {/* 统计卡片 */}
         <Col xs={12} sm={6}>
-          <Card size="small">
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/patients')}>
             <Statistic
               title="我的患者"
               value={myPatientsCount}
@@ -151,19 +152,22 @@ export function DoctorDashboard() {
           </Card>
         </Col>
         <Col xs={12} sm={6}>
-          <Card size="small">
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/follow-up-tasks')}>
             <Statistic
-              title="随访完成率"
-              value={p?.follow_up_rate ?? 0}
-              precision={0}
-              suffix="%"
-              prefix={<SafetyCertificateOutlined />}
-              styles={{ content: { color: (p?.follow_up_rate ?? 0) >= 80 ? '#3f8600' : '#cf1322' } }}
+              title="今日预约"
+              value={p?.today_appointments ?? 0}
+              prefix={<CalendarOutlined />}
+              suffix={p?.yesterday_today_appointments != null ? (() => {
+                const diff = (p.today_appointments ?? 0) - (p.yesterday_today_appointments ?? 0);
+                if (diff > 0) return <Typography.Text type="success" style={{ fontSize: 12 }}><ArrowUpOutlined /> {diff}</Typography.Text>;
+                if (diff < 0) return <Typography.Text type="danger" style={{ fontSize: 12 }}><ArrowDownOutlined /> {Math.abs(diff)}</Typography.Text>;
+                return null;
+              })() : undefined}
             />
           </Card>
         </Col>
         <Col xs={12} sm={6}>
-          <Card size="small">
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/consultations')}>
             <Statistic
               title="本月咨询"
               value={consultationsCount}
@@ -177,7 +181,7 @@ export function DoctorDashboard() {
           </Card>
         </Col>
         <Col xs={12} sm={6}>
-          <Card size="small">
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/daily-monitoring')}>
             <Statistic
               title="体征上报率"
               value={p?.vital_signs_report_rate ?? 0}
@@ -192,13 +196,18 @@ export function DoctorDashboard() {
         {/* 化验审核 */}
         {p && p.pending_lab_reviews > 0 && (
           <Col xs={24} md={12}>
-            <Card title={`化验审核 (${p.pending_lab_reviews}待审)`} size="small">
-              <List
-                size="small"
-                dataSource={[]}
-                locale={{ emptyText: '暂无待审核化验' }}
-                renderItem={() => <List.Item />}
-              />
+            <Card
+              title={`化验审核 (${p.pending_lab_reviews}待审)`}
+              size="small"
+              extra={
+                <Button type="link" size="small" icon={<RightOutlined />} onClick={() => navigate('/health/patients')}>
+                  查看待审
+                </Button>
+              }
+            >
+              <Typography.Text type="secondary">
+                您有 {p.pending_lab_reviews} 份化验报告待审核，请及时处理。
+              </Typography.Text>
             </Card>
           </Col>
         )}
@@ -211,7 +220,7 @@ export function DoctorDashboard() {
               dataSource={activeConsultations}
               locale={{ emptyText: '暂无未读消息' }}
               renderItem={(session) => (
-                <List.Item style={{ padding: '6px 0' }}>
+                <List.Item style={{ padding: '6px 0', cursor: 'pointer' }} onClick={() => navigate(`/health/consultations/${session.id}`)}>
                   <Space>
                     <Typography.Text strong style={{ fontSize: 13 }}>{session.patient_name ?? '患者'}</Typography.Text>
                     <Tag color={session.status === 'active' ? 'green' : 'default'}>{session.status === 'active' ? '进行中' : session.status}</Tag>

apps/web/src/pages/health/StatisticsDashboard/NurseDashboard.tsx

@@ -1,4 +1,5 @@
 import { Row, Col, Card, Statistic, Progress, List, Spin, Typography, Flex, Space } from 'antd';
+import { useNavigate } from 'react-router-dom';
 import {
   TeamOutlined,
   SafetyCertificateOutlined,
@@ -11,6 +12,7 @@ import { followUpApi, type FollowUpTask } from '../../../api/health/followUp';
 import { useCountUp } from '../../../hooks/useCountUp';
 
 export function NurseDashboard() {
+  const navigate = useNavigate();
   const [personal, setPersonal] = useState<PersonalStats | null>(null);
   const [followUpTasks, setFollowUpTasks] = useState<FollowUpTask[]>([]);
   const [loading, setLoading] = useState(true);
@@ -66,7 +68,7 @@ export function NurseDashboard() {
                     {p.abnormal_vital_signs} 位患者体征异常
                   </Typography.Text>
                 </Space>
-                <Typography.Link>查看全部 →</Typography.Link>
+                <Typography.Link onClick={() => navigate('/health/alert-dashboard')}>查看全部 →</Typography.Link>
               </Flex>
             </Card>
           </Col>

apps/web/src/pages/health/StatisticsDashboard/OperatorDashboard.tsx

@@ -1,21 +1,25 @@
-import { Row, Col, Card, Statistic, List, Spin, Typography, Flex } from 'antd';
+import { Row, Col, Card, Statistic, List, Spin, Typography, Flex, Button } from 'antd';
 import {
   TrophyOutlined,
   FileTextOutlined,
   CalendarOutlined,
   ShoppingOutlined,
+  RightOutlined,
 } from '@ant-design/icons';
 import { useEffect, useState, useCallback } from 'react';
+import { useNavigate } from 'react-router-dom';
 import { useStatsData } from './useStatsData';
 import { articleApi, type ArticleListItem } from '../../../api/health/articles';
 import { useCountUp } from '../../../hooks/useCountUp';
 
 export function OperatorDashboard() {
-  const { pointsStats, loading } = useStatsData();
+  const navigate = useNavigate();
+  const { pointsStats, offlineEventCount, loading } = useStatsData();
   const [topArticles, setTopArticles] = useState<ArticleListItem[]>([]);
   const issuedCount = useCountUp(pointsStats?.total_issued ?? 0);
   const spentCount = useCountUp(pointsStats?.total_spent ?? 0);
   const activeCount = useCountUp(pointsStats?.active_accounts ?? 0);
+  const offlineCount = useCountUp(offlineEventCount);
 
   const fetchTopArticles = useCallback(async () => {
     try {
@@ -26,6 +30,8 @@ export function OperatorDashboard() {
     }
   }, []);
 
+  // fetchTopArticles 内部 async setState（外部数据获取），非同步派生 state，属合理 effect 用法
+  // eslint-disable-next-line react-hooks/set-state-in-effect
   useEffect(() => { fetchTopArticles(); }, [fetchTopArticles]);
 
   if (loading && !pointsStats) return <Spin size="large" style={{ display: 'block', margin: '80px auto' }} />;
@@ -41,12 +47,12 @@ export function OperatorDashboard() {
 
       <Row gutter={[16, 16]}>
         <Col xs={12} sm={6}>
-          <Card size="small">
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/points-rules')}>
             <Statistic title="积分发放" value={issuedCount} prefix={<TrophyOutlined />} />
           </Card>
         </Col>
         <Col xs={12} sm={6}>
-          <Card size="small">
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/points-rules')}>
             <Statistic title="积分消费" value={spentCount} prefix={<ShoppingOutlined />}
               suffix={pointsStats ? (
                 <Typography.Text type="secondary" style={{ fontSize: 12 }}>
@@ -57,26 +63,34 @@ export function OperatorDashboard() {
           </Card>
         </Col>
         <Col xs={12} sm={6}>
-          <Card size="small">
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/points-rules')}>
             <Statistic title="活跃账户" value={activeCount} prefix={<FileTextOutlined />} />
           </Card>
         </Col>
         <Col xs={12} sm={6}>
-          <Card size="small">
-            <Statistic title="线下活动" value={0} prefix={<CalendarOutlined />} />
+          <Card size="small" style={{ cursor: 'pointer' }} onClick={() => navigate('/health/offline-events')}>
+            <Statistic title="线下活动" value={offlineCount} prefix={<CalendarOutlined />} />
           </Card>
         </Col>
 
         {/* 积分排行 */}
         <Col xs={24} md={12}>
-          <Card title="积分消费排行" size="small">
+          <Card
+            title="积分消费排行"
+            size="small"
+            extra={
+              <Button type="link" size="small" icon={<RightOutlined />} onClick={() => navigate('/health/points-rules')}>
+                查看全部
+              </Button>
+            }
+          >
             <List
               size="small"
               dataSource={pointsStats?.top_earners?.slice(0, 5) ?? []}
               locale={{ emptyText: '暂无数据' }}
               renderItem={(item, idx) => (
-                <List.Item>
-                  <Typography.Text>{idx + 1}. {item.patient_id?.slice(0, 8) ?? '未知'}</Typography.Text>
+                <List.Item style={{ cursor: 'pointer' }} onClick={() => navigate(`/health/patients/${item.patient_id}`)}>
+                  <Typography.Text>{idx + 1}. {item.patient_name}</Typography.Text>
                   <Typography.Text type="secondary">{item.total_earned} 分</Typography.Text>
                 </List.Item>
               )}
@@ -86,13 +100,21 @@ export function OperatorDashboard() {
 
         {/* 热门文章 */}
         <Col xs={24} md={12}>
-          <Card title="热门文章" size="small">
+          <Card
+            title="热门文章"
+            size="small"
+            extra={
+              <Button type="link" size="small" icon={<RightOutlined />} onClick={() => navigate('/health/articles')}>
+                内容管理
+              </Button>
+            }
+          >
             <List
               size="small"
               dataSource={topArticles}
               locale={{ emptyText: '暂无数据' }}
               renderItem={(article) => (
-                <List.Item style={{ padding: '6px 0' }}>
+                <List.Item style={{ padding: '6px 0', cursor: 'pointer' }} onClick={() => navigate(`/health/articles/${article.id}/edit`)}>
                   <Typography.Text ellipsis style={{ flex: 1, fontSize: 13 }}>{article.title}</Typography.Text>
                   <Typography.Text type="secondary" style={{ fontSize: 12, marginLeft: 8 }}>
                     {article.view_count} 次阅读

apps/web/src/pages/health/StatisticsDashboard/useStatsData.ts

@@ -24,6 +24,7 @@ export interface StatsData {
   healthDataStats: HealthDataStats | null;
   dialysisStats: DialysisStatistics | null;
   doctorCount: number;
+  offlineEventCount: number;
   loading: boolean;
   error: string | null;
   refresh: () => void;
@@ -40,6 +41,7 @@ export function useStatsData(): StatsData {
   const [healthDataStats, setHealthDataStats] = useState<HealthDataStats | null>(null);
   const [dialysisStats, setDialysisStats] = useState<DialysisStatistics | null>(null);
   const [doctorCount, setDoctorCount] = useState(0);
+  const [offlineEventCount, setOfflineEventCount] = useState(0);
 
   const fetchAllStats = useCallback(async () => {
     // 缓存未过期，直接使用
@@ -52,6 +54,7 @@ export function useStatsData(): StatsData {
       setHealthDataStats(c.healthDataStats as HealthDataStats | null);
       setDialysisStats(c.dialysisStats as DialysisStatistics | null);
       setDoctorCount(c.doctorCount as number);
+      setOfflineEventCount(c.offlineEventCount as number);
       setLoading(false);
       return;
     }
@@ -66,6 +69,7 @@ export function useStatsData(): StatsData {
       setHealthDataStats(c.healthDataStats as HealthDataStats | null);
       setDialysisStats(c.dialysisStats as DialysisStatistics | null);
       setDoctorCount(c.doctorCount as number);
+      setOfflineEventCount(c.offlineEventCount as number);
       setLoading(false);
       return;
     }
@@ -86,6 +90,7 @@ export function useStatsData(): StatsData {
         healthDataStats: null,
         dialysisStats: null,
         doctorCount: 0,
+        offlineEventCount: 0,
       };
 
       const tryFetch = async <T,>(fn: () => Promise<T>, key: string, label: string) => {
@@ -110,14 +115,19 @@ export function useStatsData(): StatsData {
           'doctorCount',
           '医护',
         ),
+        tryFetch(
+          async () => { const r = await pointsApi.listOfflineEvents({ page: 1, page_size: 1 }); return r.total; },
+          'offlineEventCount',
+          '线下活动',
+        ),
       ]);
 
-      if (!hasAnyError || errors.length < 7) {
+      if (!hasAnyError || errors.length < 8) {
         cachedStats = results;
         cachedAt = Date.now();
       }
 
-      if (hasAnyError && errors.length === 7) {
+      if (hasAnyError && errors.length === 8) {
         setError('加载统计数据失败');
       }
 
@@ -133,6 +143,7 @@ export function useStatsData(): StatsData {
       setHealthDataStats(c.healthDataStats as HealthDataStats | null);
       setDialysisStats(c.dialysisStats as DialysisStatistics | null);
       setDoctorCount(c.doctorCount as number);
+      setOfflineEventCount(c.offlineEventCount as number);
     } finally {
       fetchPromise = null;
       setLoading(false);
@@ -144,7 +155,7 @@ export function useStatsData(): StatsData {
   }, [fetchAllStats]);
 
   return {
-    patientStats, consultationStats, followUpStats, pointsStats, healthDataStats, dialysisStats, doctorCount,
+    patientStats, consultationStats, followUpStats, pointsStats, healthDataStats, dialysisStats, doctorCount, offlineEventCount,
     loading, error, refresh: fetchAllStats,
   };
 }

apps/web/src/pages/health/articleEditor/ArticleEditor.tsx

@@ -45,6 +45,7 @@ export default function ArticleEditor() {
   const [categoryId, setCategoryId] = useState<string | undefined>(undefined);
   const [selectedTagIds, setSelectedTagIds] = useState<string[]>([]);
   const [sortOrder, setSortOrder] = useState(0);
+  const [isPublic, setIsPublic] = useState(true);
   const [version, setVersion] = useState(0);
 
   // 选项数据
@@ -99,8 +100,9 @@ export default function ArticleEditor() {
         setCoverImage(article.cover_image || '');
         setSlug(article.slug || '');
         setCategoryId(article.category_id);
-        setSelectedTagIds(article.tags?.map((t) => t.id) || []);
+        setSelectedTagIds(article.tags?.map((t) => t.id).filter(Boolean) || []);
         setSortOrder(article.sort_order);
+        setIsPublic(article.is_public ?? true);
         setVersion(article.version);
       } catch {
         message.error('加载文章失败');
@@ -228,8 +230,9 @@ export default function ArticleEditor() {
           cover_image: coverImage || undefined,
           slug: slug || undefined,
           category_id: categoryId,
-          tag_ids: selectedTagIds,
+          tag_ids: selectedTagIds.filter(Boolean),
           sort_order: sortOrder,
+          is_public: isPublic,
           version,
         });
         message.success('文章已保存');
@@ -243,8 +246,9 @@ export default function ArticleEditor() {
           cover_image: coverImage || undefined,
           slug: slug || undefined,
           category_id: categoryId,
-          tag_ids: selectedTagIds,
+          tag_ids: selectedTagIds.filter(Boolean),
           sort_order: sortOrder,
+          is_public: isPublic,
         });
         message.success('文章已创建');
         navigate('/health/articles');
@@ -256,7 +260,7 @@ export default function ArticleEditor() {
     }
   }, [
     id, isEdit, title, summary, content, coverImage, slug, categoryId,
-    selectedTagIds, sortOrder, version, navigate,
+    selectedTagIds, sortOrder, isPublic, version, navigate,
   ]);
 
   const handleSubmit = useCallback(async () => {
@@ -275,8 +279,9 @@ export default function ArticleEditor() {
           cover_image: coverImage || undefined,
           slug: slug || undefined,
           category_id: categoryId,
-          tag_ids: selectedTagIds,
+          tag_ids: selectedTagIds.filter(Boolean),
           sort_order: sortOrder,
+          is_public: isPublic,
           version,
         });
         const updated = await articleApi.get(id);
@@ -290,8 +295,9 @@ export default function ArticleEditor() {
           cover_image: coverImage || undefined,
           slug: slug || undefined,
           category_id: categoryId,
-          tag_ids: selectedTagIds,
+          tag_ids: selectedTagIds.filter(Boolean),
           sort_order: sortOrder,
+          is_public: isPublic,
         });
         currentVersion = created.version;
         setVersion(created.version);
@@ -312,7 +318,7 @@ export default function ArticleEditor() {
     }
   }, [
     id, isEdit, title, summary, content, coverImage, slug, categoryId,
-    selectedTagIds, sortOrder, version, navigate,
+    selectedTagIds, sortOrder, isPublic, version, navigate,
   ]);
 
   if (loading) {
@@ -463,6 +469,8 @@ export default function ArticleEditor() {
         onSlugChange={setSlug}
         sortOrder={sortOrder}
         onSortOrderChange={setSortOrder}
+        isPublic={isPublic}
+        onIsPublicChange={setIsPublic}
         categories={categories}
         tags={tags}
       />

apps/web/src/pages/health/articleEditor/ArticleSettingsDrawer.tsx

@@ -1,5 +1,5 @@
 import { useState } from 'react';
-import { Drawer, Input, Select, Space, Upload, Button, message } from 'antd';
+import { Drawer, Input, Select, Space, Upload, Button, Switch, message } from 'antd';
 import { UploadOutlined, PictureOutlined } from '@ant-design/icons';
 import type { ArticleTagItem } from '../../../api/health/articles';
 import { uploadFile } from '../../../api/upload';
@@ -21,6 +21,8 @@ interface ArticleSettingsDrawerProps {
   onSlugChange: (v: string) => void;
   sortOrder: number;
   onSortOrderChange: (v: number) => void;
+  isPublic: boolean;
+  onIsPublicChange: (v: boolean) => void;
   categories: { id: string; name: string }[];
   tags: ArticleTagItem[];
 }
@@ -53,6 +55,8 @@ export default function ArticleSettingsDrawer({
   onSlugChange,
   sortOrder,
   onSortOrderChange,
+  isPublic,
+  onIsPublicChange,
   categories,
   tags,
 }: ArticleSettingsDrawerProps) {
@@ -190,6 +194,17 @@ export default function ArticleSettingsDrawer({
               placeholder="0"
             />
           </div>
+
+          {/* 公开可见 */}
+          <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between' }}>
+            <div>
+              <label style={{ ...labelStyle(isDark), marginBottom: 2 }}>公开可见</label>
+              <div style={{ fontSize: 12, color: isDark ? '#64748b' : '#94a3b8' }}>
+                开启后游客可在小程序查看此文章
+              </div>
+            </div>
+            <Switch checked={isPublic} onChange={onIsPublicChange} />
+          </div>
         </div>
       </Drawer>
 

crates/erp-ai/Cargo.toml

@@ -26,3 +26,4 @@ sha2.workspace = true
 redis.workspace = true
 hex.workspace = true
 regex-lite.workspace = true
+pdf-extract.workspace = true

crates/erp-ai/src/entity/ai_knowledge_bases.rs

@@ -0,0 +1,31 @@
+use sea_orm::entity::prelude::*;
+use serde::{Deserialize, Serialize};
+
+#[derive(Clone, Debug, PartialEq, DeriveEntityModel, Serialize, Deserialize)]
+#[sea_orm(table_name = "ai_knowledge_bases")]
+pub struct Model {
+    #[sea_orm(primary_key, auto_increment = false)]
+    pub id: Uuid,
+    pub tenant_id: Uuid,
+    pub name: String,
+    pub kb_type: String,
+    pub description: Option<String>,
+    pub icon: Option<String>,
+    pub chunk_strategy: serde_json::Value,
+    pub intent_keywords: serde_json::Value,
+    pub embedding_model: Option<String>,
+    pub is_enabled: bool,
+    pub document_count: i32,
+    pub chunk_count: i32,
+    pub created_at: DateTimeUtc,
+    pub updated_at: DateTimeUtc,
+    pub created_by: Option<Uuid>,
+    pub updated_by: Option<Uuid>,
+    pub deleted_at: Option<DateTimeUtc>,
+    pub version_lock: i32,
+}
+
+#[derive(Copy, Clone, Debug, EnumIter, DeriveRelation)]
+pub enum Relation {}
+
+impl ActiveModelBehavior for ActiveModel {}

crates/erp-ai/src/entity/ai_knowledge_chunks.rs

@@ -0,0 +1,34 @@
+use sea_orm::entity::prelude::*;
+use serde::{Deserialize, Serialize};
+
+#[derive(Clone, Debug, PartialEq, DeriveEntityModel, Serialize, Deserialize)]
+#[sea_orm(table_name = "ai_knowledge_chunks")]
+pub struct Model {
+    #[sea_orm(primary_key, auto_increment = false)]
+    pub id: Uuid,
+    pub tenant_id: Uuid,
+    pub knowledge_base_id: Uuid,
+    pub document_id: Uuid,
+    pub chunk_index: i32,
+    pub content: String,
+    pub token_count: Option<i32>,
+    // pgvector 字段 — SeaORM 不原生支持 vector 类型，查询时用 raw SQL
+    #[sea_orm(ignore)]
+    pub embedding: Option<Vec<f32>>,
+    pub start_offset: Option<i32>,
+    pub end_offset: Option<i32>,
+    pub page_number: Option<i32>,
+    pub metadata: serde_json::Value,
+    pub hit_count: i32,
+    pub last_hit_at: Option<DateTimeUtc>,
+    pub created_at: DateTimeUtc,
+    pub updated_at: DateTimeUtc,
+    pub created_by: Option<Uuid>,
+    pub updated_by: Option<Uuid>,
+    pub deleted_at: Option<DateTimeUtc>,
+}
+
+#[derive(Copy, Clone, Debug, EnumIter, DeriveRelation)]
+pub enum Relation {}
+
+impl ActiveModelBehavior for ActiveModel {}

crates/erp-ai/src/entity/ai_knowledge_documents.rs

@@ -0,0 +1,36 @@
+use sea_orm::entity::prelude::*;
+use serde::{Deserialize, Serialize};
+
+#[derive(Clone, Debug, PartialEq, DeriveEntityModel, Serialize, Deserialize)]
+#[sea_orm(table_name = "ai_knowledge_documents")]
+pub struct Model {
+    #[sea_orm(primary_key, auto_increment = false)]
+    pub id: Uuid,
+    pub tenant_id: Uuid,
+    pub knowledge_base_id: Uuid,
+    pub title: String,
+    pub doc_type: String,
+    pub source_type: String,
+    pub source_url: Option<String>,
+    pub file_name: Option<String>,
+    pub file_size: Option<i64>,
+    pub file_mime_type: Option<String>,
+    pub content: Option<String>,
+    pub status: String,
+    pub chunk_count: i32,
+    pub embedded_count: i32,
+    pub error_message: Option<String>,
+    pub processing_started_at: Option<DateTimeUtc>,
+    pub processing_completed_at: Option<DateTimeUtc>,
+    pub created_at: DateTimeUtc,
+    pub updated_at: DateTimeUtc,
+    pub created_by: Option<Uuid>,
+    pub updated_by: Option<Uuid>,
+    pub deleted_at: Option<DateTimeUtc>,
+    pub version_lock: i32,
+}
+
+#[derive(Copy, Clone, Debug, EnumIter, DeriveRelation)]
+pub enum Relation {}
+
+impl ActiveModelBehavior for ActiveModel {}

crates/erp-ai/src/entity/ai_prompt.rs

@@ -16,6 +16,8 @@ pub struct Model {
     pub version: i32,
     pub is_active: bool,
     pub category: String,
+    /// 后端选择键：与 AnalysisType::prompt_name() 对应，handler 按此字段查找激活 Prompt
+    pub analysis_type: String,
     pub tags: Option<serde_json::Value>,
     pub created_at: DateTimeUtc,
     pub updated_at: DateTimeUtc,

crates/erp-ai/src/entity/mod.rs

@@ -3,6 +3,9 @@ pub mod ai_analysis_queue;
 pub mod ai_chat_message;
 pub mod ai_chat_session;
 pub mod ai_feature_flags;
+pub mod ai_knowledge_bases;
+pub mod ai_knowledge_chunks;
+pub mod ai_knowledge_documents;
 pub mod ai_knowledge_guides;
 pub mod ai_knowledge_references;
 pub mod ai_knowledge_rules;