# Phase 3 功能使用指南

## 📖 用户操作指南

### 1. 记录抽烟

#### 方式一：从首页快速记录

1. 打开小程序，进入首页
2. 点击「记录抽烟」按钮
3. 弹出记录表单：
   - **时间**: 默认当前时间，可修改日期和时间
   - **数量**: 默认 1 支，可通过 +/- 调整或直接输入
   - **烟瘾等级**: 选择 1-5 级（默认 2 级）
   - **备注**: 选填，最多 200 字符
4. 点击「确定」提交
5. 提示"记录成功"，首页数据自动更新

#### 方式二：从历史记录页新增

1. 切换到「记录」标签页
2. 点击右下角浮动 ➕ 按钮
3. 跳转到首页进行记录

### 2. 记录想抽忍住了

#### 从首页记录

1. 打开小程序，进入首页
2. 点击「想抽忍住了」按钮（绿色）
3. 弹出记录表单：
   - **时间**: 默认当前时间，可修改
   - **备注**: 记录抵抗心得或当时的想法
   - 数量和等级不显示（自动设置为 num=0, level=2）
4. 点击「确定」提交
5. 提示"太棒了！"

### 3. 查看历史记录

1. 切换到「记录」标签页
2. 查看所有记录，按日期分组显示
3. 可以通过顶部标签筛选：
   - **全部**: 显示所有记录
   - **已抽烟**: 只显示抽烟记录
   - **已忍住**: 只显示忍住记录

#### 记录卡片信息

每条记录显示：
- **类型图标**: 💪（忍住）或 🚬（抽烟）
- **类型标题**: "想抽忍住了" 或 "记录抽烟"
- **时间**: HH:mm 格式
- **数量和等级**: 仅抽烟记录显示
- **备注**: 如果有填写
- **间隔时间**: 距离上一条记录的时间

#### 日期分组

- **今天**: 显示"今天 X月X日"
- **昨天**: 显示"昨天 X月X日"
- **更早**: 显示"X月X日"

### 4. 编辑记录

1. 进入「记录」标签页
2. 找到要编辑的记录
3. 点击卡片右上角的「编辑」按钮（蓝色）
4. 弹出编辑表单，数据已预填充
5. 修改需要更改的内容
6. 点击「确定」保存
7. 提示"更新成功"，列表自动刷新

**注意**:
- 可以修改时间、数量、等级、备注
- 不能改变记录类型（抽烟/忍住）

### 5. 删除记录

1. 进入「记录」标签页
2. 找到要删除的记录
3. 点击卡片右上角的「删除」按钮（红色）
4. 弹出确认对话框："确定要删除这条记录吗？"
5. 点击「确定」删除
6. 提示"删除成功"，记录从列表中消失

**注意**:
- 删除操作不可恢复
- 删除后会立即从列表中移除（乐观更新）
- 如果删除失败，会自动恢复记录并提示错误

### 6. 下拉刷新

1. 进入「记录」标签页
2. 在列表顶部向下拉动
3. 显示刷新指示器
4. 释放后自动刷新数据
5. 刷新完成后回到顶部

**用途**:
- 同步最新数据
- 查看其他设备的记录
- 修复显示异常

### 7. 上拉加载更多

1. 进入「记录」标签页
2. 滚动到列表底部
3. 自动触发加载更多
4. 显示"加载中..."
5. 新数据追加到列表底部

**说明**:
- 每次加载 20 条记录
- 没有更多时显示"没有更多了"
- 正在加载时不会重复请求

---

## 🎨 界面说明

### 首页 (pages/index/index.vue)

#### 配色
- **背景**: 渐变（浅绿 → 白色）
- **卡片**: 白色 + 阴影
- **主题色**: 翡翠绿 #10B981
- **按钮**: 
  - 记录抽烟: 白色背景 + 灰色边框
  - 想抽忍住了: 绿色背景 + 白色文字

#### 布局
```
┌─────────────────────────────┐
│ 状态栏                       │
│ 问候语 + 头像          ⚙️    │
│ AI 提示卡片 (可关闭)  ×     │
│ ┌─────────────────────┐     │
│ │    距上次抽烟        │     │
│ │    02:45:39         │     │
│ │  ✨ 下次建议: 15:30  │     │
│ └─────────────────────┘     │
│ ┌──────┐ ┌──────┐          │
│ │今日  │ │烟瘾  │          │
│ │已抽  │ │发作  │          │
│ └──────┘ └──────┘          │
│ [🚬 记录抽烟] [💪 想抽忍住了] │
└─────────────────────────────┘
```

### 历史记录页 (pages/logs/index.vue)

#### 配色
- **背景**: 渐变（浅绿 → 白色）
- **标签栏**: 
  - 未选中: 白色 + 灰色边框
  - 选中: 绿色背景 + 白色文字
- **卡片**: 
  - 白色背景
  - 绿色左边框（忍住）
  - 红色左边框（抽烟）

#### 布局
```
┌─────────────────────────────┐
│ 历史记录                     │
│ [全部] [已抽烟] [已忍住]     │
├─────────────────────────────┤
│ 今天 1月25日                │
│ ● ┌───────────────────┐     │
│ │ │ 💪 想抽忍住了      │     │
│ │ │ 14:30            │     │
│ │ │ 想抽但忍住了      │     │
│ │ │ 距上次 2小时15分  │     │
│ │ └───────────────────┘     │
│ │   [编辑] [删除]          │
│ ● ┌───────────────────┐     │
│   │ 🚬 记录抽烟        │     │
│   │ 12:15  3支 等级2   │     │
│   │ 压力大、工作繁忙    │     │
│   └───────────────────┘     │
│     [编辑] [删除]          │
│                             │
│ 昨天 1月24日                │
│ ● ┌───────────────────┐     │
│   │ ...               │     │
│   └───────────────────┘     │
│                             │
│                        [+]  │
└─────────────────────────────┘
```

### 记录弹框 (components/smoke-record-dialog)

#### 抽烟模式
```
┌─────────────────────────────┐
│ 记录抽烟                ×   │
├─────────────────────────────┤
│ 时间                         │
│ [2025-01-25] [14:30]        │
│                             │
│ 数量                         │
│ [-]  [1]  [+]               │
│                             │
│ 烟瘾等级                     │
│ [1] [2] [3] [4] [5]         │
│                             │
│ 备注                         │
│ ┌─────────────────────┐     │
│ │ 记录抽烟原因...      │     │
│ └─────────────────────┘     │
├─────────────────────────────┤
│ [取消]           [确定]     │
└─────────────────────────────┘
```

#### 忍住模式
```
┌─────────────────────────────┐
│ 想抽忍住了              ×   │
├─────────────────────────────┤
│ 时间                         │
│ [2025-01-25] [14:30]        │
│                             │
│ 备注                         │
│ ┌─────────────────────┐     │
│ │ 记录抵抗心得...      │     │
│ └─────────────────────┘     │
├─────────────────────────────┤
│ [取消]           [确定]     │
└─────────────────────────────┘
```

---

## 💡 使用技巧

### 1. 快速记录

**场景**: 刚抽完烟，想快速记录

**操作**:
1. 打开小程序
2. 点击「记录抽烟」
3. 直接点击「确定」（使用默认值）

**时间**: < 3 秒

### 2. 详细记录

**场景**: 需要记录详细信息

**操作**:
1. 打开记录表单
2. 修改时间（如果不是刚抽的）
3. 调整数量和等级
4. 填写备注（为什么抽、当时心情等）
5. 提交

**建议备注内容**:
- 抽烟原因：压力大、无聊、社交、习惯
- 当时心情：焦虑、放松、开心、郁闷
- 触发场景：工作、休息、饭后、等人

### 3. 回顾分析

**查看抽烟规律**:
1. 进入历史记录页
2. 查看时间分布
3. 查看间隔时间
4. 查看备注了解触发原因

**筛选特定类型**:
1. 点击「已抽烟」查看所有抽烟记录
2. 点击「已忍住」查看抵抗记录
3. 对比数量，激励自己

### 4. 纠正错误

**场景**: 记录时间或内容错误

**操作**:
1. 进入历史记录页
2. 找到错误记录
3. 点击「编辑」
4. 修改错误信息
5. 保存

### 5. 删除重复

**场景**: 误操作重复记录

**操作**:
1. 进入历史记录页
2. 找到重复记录
3. 点击「删除」
4. 确认删除

---

## ⚠️ 注意事项

### 数据同步

- 记录会实时同步到服务器
- 多设备登录时，数据自动同步
- 删除后不可恢复，请谨慎操作

### 时间设置

- 可以记录过去的时间
- 不能记录未来的时间
- 建议在抽烟后立即记录，更准确

### 备注内容

- 最多 200 字符
- 建议记录关键信息
- 帮助分析抽烟规律

### 网络问题

- 需要网络连接才能同步
- 网络异常时会提示错误
- 可以下拉刷新重试

---

## 🆘 常见问题

### Q: 记录后首页数据没更新？

**A**: 尝试以下方法：
1. 下拉刷新首页
2. 切换 Tab 重新进入
3. 检查网络连接

### Q: 删除记录后又出现了？

**A**: 可能是网络问题导致删除失败：
1. 检查网络连接
2. 重新尝试删除
3. 联系客服

### Q: 编辑后数据没变？

**A**: 
1. 检查是否点击了「确定」
2. 查看是否有错误提示
3. 刷新列表重试

### Q: 看不到历史记录？

**A**:
1. 下拉刷新列表
2. 检查筛选标签（是否选了「已抽烟」但没有记录）
3. 检查网络连接

### Q: 如何查看更早的记录？

**A**:
1. 滚动到列表底部
2. 会自动加载更多
3. 每次加载 20 条

---

## 📞 技术支持

如遇到其他问题，请通过以下方式联系：
- 小程序内客服
- 问题反馈
- GitHub Issues

---

**更新时间**: 2025-01-25  
**版本**: Phase 3 完整版