nepiedg
379 lines
10 KiB
Markdown
379 lines
10 KiB
Markdown
# 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 完整版
|