nepiedg
10 KiB
10 KiB
Phase 3 功能使用指南
📖 用户操作指南
1. 记录抽烟
方式一：从首页快速记录
- 打开小程序，进入首页
- 点击「记录抽烟」按钮
- 弹出记录表单：
- 时间: 默认当前时间，可修改日期和时间
- 数量: 默认 1 支，可通过 +/- 调整或直接输入
- 烟瘾等级: 选择 1-5 级（默认 2 级）
- 备注: 选填，最多 200 字符
- 点击「确定」提交
- 提示"记录成功"，首页数据自动更新
方式二：从历史记录页新增
- 切换到「记录」标签页
- 点击右下角浮动 ➕ 按钮
- 跳转到首页进行记录
2. 记录想抽忍住了
从首页记录
- 打开小程序，进入首页
- 点击「想抽忍住了」按钮（绿色）
- 弹出记录表单：
- 时间: 默认当前时间，可修改
- 备注: 记录抵抗心得或当时的想法
- 数量和等级不显示（自动设置为 num=0, level=2）
- 点击「确定」提交
- 提示"太棒了！"
3. 查看历史记录
- 切换到「记录」标签页
- 查看所有记录，按日期分组显示
- 可以通过顶部标签筛选：
- 全部: 显示所有记录
- 已抽烟: 只显示抽烟记录
- 已忍住: 只显示忍住记录
记录卡片信息
每条记录显示：
- 类型图标: 💪（忍住）或 🚬（抽烟）
- 类型标题: "想抽忍住了" 或 "记录抽烟"
- 时间: HH:mm 格式
- 数量和等级: 仅抽烟记录显示
- 备注: 如果有填写
- 间隔时间: 距离上一条记录的时间
日期分组
- 今天: 显示"今天 X月X日"
- 昨天: 显示"昨天 X月X日"
- 更早: 显示"X月X日"
4. 编辑记录
- 进入「记录」标签页
- 找到要编辑的记录
- 点击卡片右上角的「编辑」按钮（蓝色）
- 弹出编辑表单，数据已预填充
- 修改需要更改的内容
- 点击「确定」保存
- 提示"更新成功"，列表自动刷新
注意:
- 可以修改时间、数量、等级、备注
- 不能改变记录类型（抽烟/忍住）
5. 删除记录
- 进入「记录」标签页
- 找到要删除的记录
- 点击卡片右上角的「删除」按钮（红色）
- 弹出确认对话框："确定要删除这条记录吗？"
- 点击「确定」删除
- 提示"删除成功"，记录从列表中消失
注意:
- 删除操作不可恢复
- 删除后会立即从列表中移除（乐观更新）
- 如果删除失败，会自动恢复记录并提示错误
6. 下拉刷新
- 进入「记录」标签页
- 在列表顶部向下拉动
- 显示刷新指示器
- 释放后自动刷新数据
- 刷新完成后回到顶部
用途:
- 同步最新数据
- 查看其他设备的记录
- 修复显示异常
7. 上拉加载更多
- 进入「记录」标签页
- 滚动到列表底部
- 自动触发加载更多
- 显示"加载中..."
- 新数据追加到列表底部
说明:
- 每次加载 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. 快速记录
场景: 刚抽完烟，想快速记录
操作:
- 打开小程序
- 点击「记录抽烟」
- 直接点击「确定」（使用默认值）
时间: < 3 秒
2. 详细记录
场景: 需要记录详细信息
操作:
- 打开记录表单
- 修改时间（如果不是刚抽的）
- 调整数量和等级
- 填写备注（为什么抽、当时心情等）
- 提交
建议备注内容:
- 抽烟原因：压力大、无聊、社交、习惯
- 当时心情：焦虑、放松、开心、郁闷
- 触发场景：工作、休息、饭后、等人
3. 回顾分析
查看抽烟规律:
- 进入历史记录页
- 查看时间分布
- 查看间隔时间
- 查看备注了解触发原因
筛选特定类型:
- 点击「已抽烟」查看所有抽烟记录
- 点击「已忍住」查看抵抗记录
- 对比数量，激励自己
4. 纠正错误
场景: 记录时间或内容错误
操作:
- 进入历史记录页
- 找到错误记录
- 点击「编辑」
- 修改错误信息
- 保存
5. 删除重复
场景: 误操作重复记录
操作:
- 进入历史记录页
- 找到重复记录
- 点击「删除」
- 确认删除
⚠️ 注意事项
数据同步
- 记录会实时同步到服务器
- 多设备登录时，数据自动同步
- 删除后不可恢复，请谨慎操作
时间设置
- 可以记录过去的时间
- 不能记录未来的时间
- 建议在抽烟后立即记录，更准确
备注内容
- 最多 200 字符
- 建议记录关键信息
- 帮助分析抽烟规律
网络问题
- 需要网络连接才能同步
- 网络异常时会提示错误
- 可以下拉刷新重试
🆘 常见问题
Q: 记录后首页数据没更新？
A: 尝试以下方法：
- 下拉刷新首页
- 切换 Tab 重新进入
- 检查网络连接
Q: 删除记录后又出现了？
A: 可能是网络问题导致删除失败：
- 检查网络连接
- 重新尝试删除
- 联系客服
Q: 编辑后数据没变？
A:
- 检查是否点击了「确定」
- 查看是否有错误提示
- 刷新列表重试
Q: 看不到历史记录？
A:
- 下拉刷新列表
- 检查筛选标签（是否选了「已抽烟」但没有记录）
- 检查网络连接
Q: 如何查看更早的记录？
A:
- 滚动到列表底部
- 会自动加载更多
- 每次加载 20 条
📞 技术支持
如遇到其他问题，请通过以下方式联系：
- 小程序内客服
- 问题反馈
- GitHub Issues
更新时间: 2025-01-25
版本: Phase 3 完整版