Merge commit 'a6382d6'

# Conflicts:
#	README.md
#	src/app.config.ts
#	src/pages/index/index.scss
#	src/pages/index/index.tsx

README.md

@@ -3,16 +3,18 @@
 这是一个适合零基础开发者的 `Taro + React + TypeScript` 微信小程序项目模板。你后续会用 React 组件方式开发页面，再编译成微信小程序代码进行预览和发布。
 
 当前首页已经改成了一版“设备绑定首页（无设备状态）”业务样式，方便你直接在这个基础上继续接真实接口和页面跳转。
-
 项目里也已经开始整理公共能力：
 
 - 颜色统一收口到全局主题变量，后续页面尽量不要再写散落的十六进制颜色
 - 通用 UI 优先拆成可复用组件，方便后续多页面共用
 
+当前项目还新增了一版“睡眠报告演示页”，用于展示宝宝睡眠评分、呼吸状态、HRV、异常统计和 AI 分析建议等完整报告结构。
+
 ## 1. 目前已经包含什么
 
 - `Taro + React + TypeScript` 项目骨架
 - 首页设备绑定业务示例页面
+- 睡眠报告演示页面
 - 小程序 `AppID` 配置
 - `AGENTS.md` 协作规则文件
 - 从开发到发布的中文说明
@@ -31,11 +33,31 @@
    ├─ app.config.ts
    ├─ app.scss
    ├─ app.tsx
+   ├─ components
+   │  └─ report
+   │     ├─ chart-card.tsx
+   │     ├─ chip-group.tsx
+   │     ├─ daytime-prediction.tsx
+   │     ├─ distribution-card.tsx
+   │     ├─ insight-list.tsx
+   │     ├─ kv-list.tsx
+   │     ├─ metric-grid.tsx
+   │     ├─ page-header.tsx
+   │     ├─ score-overview.tsx
+   │     ├─ section-card.tsx
+   │     └─ summary-block.tsx
    └─ pages
-      └─ index
+      ├─ index
+      │  ├─ index.config.ts
+      │  ├─ index.scss
+      │  └─ index.tsx
+      └─ report
          ├─ index.config.ts
          ├─ index.scss
-         └─ index.tsx
+         ├─ index.tsx
+         ├─ mock.ts
+         ├─ report-utils.ts
+         └─ types.ts
 ```
 
 ## 3. 你需要先准备什么
@@ -144,6 +166,12 @@ npm run dev:weapp
 6. 如果开发者工具提示编译目录相关问题，确认你已经先运行过：
    `npm run dev:weapp`
 
+如果你要重点查看新增的睡眠报告页：
+
+- 先进入首页
+- 点击底部“报告”
+- 或点击首页里的“查看睡眠报告”
+
 ## 11. 项目里的几个核心文件
 
 - [package.json](C:/Users/a/Documents/New%20project%203/package.json)
@@ -187,6 +215,29 @@ npm run dev:weapp
 - 设备列表
 - 报告、消息、我的等页面
 
+## 12.1 当前报告页做了什么
+
+现在项目里已经新增一个独立的“睡眠报告页”，主要包含：
+
+- 首页底部“报告”入口跳转
+- 首页主体里的“查看睡眠报告”快捷入口
+- `日报 / 周报 / 月报` 三种时间维度切换
+- 日期、房间、设备三个筛选条件
+- 睡眠评分总览
+- 睡眠趋势图和睡眠分数趋势图
+- 9 项核心指标卡片
+- AI 睡眠分析和改善建议
+- 异常统计、HRV、心率散点图、呼吸波形图
+- 低氧统计、打鼾监测、异常事件散点图
+- 睡眠结构、自主神经分析、日间状态预测
+
+说明：
+
+- 当前报告页使用本地 mock 数据驱动
+- 图表是轻量前端演示实现，没有引入大型图表依赖
+- 各板块尽量拆成了可复用组件，便于你继续改
+- 分享功能当前还是前端占位提示，后续可再接真实能力
+
 ## 13. 你接下来最常做的开发动作
 
 ### 改公共主题色
@@ -207,6 +258,24 @@ npm run dev:weapp
 
 - [src/pages/index/index.tsx](C:/Users/a/Documents/New%20project%203/src/pages/index/index.tsx)
 
+### 改报告页
+
+编辑：
+
+- [src/pages/report/index.tsx](C:/Users/a/Documents/New%20project%203/src/pages/report/index.tsx)
+
+### 改报告页 mock 数据
+
+编辑：
+
+- [src/pages/report/mock.ts](C:/Users/a/Documents/New%20project%203/src/pages/report/mock.ts)
+
+### 改报告页组件
+
+编辑：
+
+- `src/components/report/` 目录下的组件文件
+
 ### 改全局样式
 
 编辑：
@@ -236,6 +305,12 @@ src
 - 在微信开发者工具里查看编译后的模拟器效果
 - 扫码和蓝牙相关能力更推荐使用真机调试，因为开发者工具里不一定能完整模拟真实权限和设备搜索环境
 
+如果你在改报告页，推荐同步检查：
+
+- 报表维度切换后数据有没有变化
+- 日期、房间、设备切换后内容有没有同步
+- 点击图表节点后提示值有没有更新
+
 ### 真机预览
 
 1. 确保已填写真实 `AppID`
@@ -299,6 +374,20 @@ npm run build:weapp
 - HTTPS
 - 后台服务正常可访问
 
+### 5. 如何验证报告页里的纯逻辑
+
+当前项目新增了一个最小测试命令，用来验证报告页里的纯逻辑函数，比如：
+
+- 睡眠评分等级映射
+- 状态颜色映射
+- mock 数据选择逻辑
+
+执行：
+
+```bash
+npm run test:report
+```
+
 ## 17. 建议你下一步怎么做
 
 如果你是零基础，推荐按这个顺序继续：