健康习惯跟踪 App 实操指导文档

项目：HealthHabitTracker（com.opc.healthhabit）｜ 平台：HarmonyOS 6.1.1（API 24）Stage 模型 ｜ 语言：ArkTS + ArkUI
本文档面向一人公司（OPC）独立开发者，提供从环境准备到演示讲解的严谨操作步骤，并说明开发过程中使用的华为云码道新特性。

---

一、应用简介

项目地址：https://gitcode.com/Lingxi-HandsOn/opc-health-habit-tracker
一款高颜值健康习惯跟踪应用，五大模块：

模块	功能	演示亮点
戒酒记录	每日无酒打卡、累计/连续天数、历史	打卡后 streak 实时 +1
断食追踪	16:8 / 18:6 / 20:4 计时器	大圆环实时计时，杀进程可恢复
体态矫正	每日训练清单勾选	完成度进度条 + 全完成鼓励文案
睡眠节律	就寝/起床录入、时长计算、规律性评分	近 7 天柱状图 + 0-100 评分
咖啡因记录	六种饮品一键 +1 杯、撤销	对照 400mg 安全线，超量变色警告

另有：首页仪表盘（五卡片总览 + 圆环进度）、统计页（周维度跨模块统计）、我的页（重置演示数据）。

---

二、环境准备（一次性，约 10 分钟）

1. 安装 DevEco Studio 6.0+（本项目使用其内置工具链：SDK HarmonyOS 6.1.1 / API 24、hvigor 6.24.4、Node 18、JBR 21）；安装华为云码道。
2. 打开 DevEco Studio → Device Manager，创建并手动启动一次手机模拟器（如 Pura 90），完成镜像下载与账号初始化——这一步必须做一次，否则命令行无法拉起模拟器；
3. （可选，真机演示）准备一台 HarmonyOS 手机，开启开发者模式与 USB 调试；
4. （可选，安装到设备）在 DevEco Studio → Project Structure → Signing Configs 配置自动签名（需华为开发者账号）。

三、获取与构建项目（约 3 分钟）

# 1. 进入项目目录
cd C:\Users\Administrator\Desktop\work\madao\health-habit-tracker

# 2. 安装依赖（使用 DevEco 内置 ohpm）
& "C:\Program Files\Huawei\DevEco Studio\tools\ohpm\bin\ohpm" install

# 3. 命令行构建 HAP（Windows PowerShell）
& "C:\Program Files\Huawei\DevEco Studio\tools\node\node.exe" `
  "C:\Program Files\Huawei\DevEco Studio\tools\hvigor\bin\hvigorw.js" `
  assembleHap --mode module -p module=entry --no-daemon

构建成功标志：BUILD SUCCESSFUL，产物位于 entry\build\default\outputs\default\entry-default-unsigned.hap。

更简单的替代方式：直接用 DevEco Studio 打开本项目目录，等待同步完成后点 Build → Build Hap(s)/APP(s) → Build Hap(s)。

四、安装与运行（约 3 分钟）

方式 A：DevEco Studio（推荐）

1. 启动模拟器或连接真机；
2. 配置自动签名（首次）；
3. 点击 Run ▶，自动安装并启动。

方式 B：命令行（需已签名 HAP 与在线设备）

hdc list targets                      # 确认设备在线
hdc install entry-default-signed.hap  # 安装
hdc shell aa start -a EntryAbility -b com.opc.healthhabit   # 启动

五、演示脚本（建议 5 分钟讲解动线）

1. 首页（30s）：打开应用 → 时段问候 + 五张习惯卡片，指出每卡的实时指标与进度环，强调"开箱即有数据"（内置近 7 天演示种子）；
2. 断食（60s）：进入断食页 → 选 16:8 → 开始断食 → 大圆环计时走动 → 按 Home 键杀进程重进，计时无丢失（基于开始时间戳恢复）→ 结束断食生成历史；
3. 戒酒（30s）：今日打卡 → 连续天数 5→6，展示历史列表；
4. 咖啡因（45s）：连点"美式"×3 → 累计 450mg → 进度条越过 400mg 变红警告 → 撤销一杯回落；
5. 睡眠（45s）：录入 23:30 就寝 / 07:00 起床 → 时长 7.5h → 近 7 天柱状图与规律性评分；
6. 体态（30s）：逐项勾选 → 完成度 100% → 出现鼓励文案；
7. 统计页（30s）：周维度五指标总览；
8. 我的页（15s）：点"重置演示数据"→ 数据恢复种子状态，演示可重复。

六、开发过程中使用的华为云码道新特性对照

码道新特性	本项目中的实际应用
鸿蒙专属 Agent	全流程 ArkTS/ArkUI 代码生成：17 个 ets 文件、2496 行一次成型，遵循 Stage 模型与 API 24 规范
文档上传并解析	上传《新特性.doc》自动解析特性清单，作为场景规划输入
Agent Team（多 Agent 协作编排）	编排"规格生成 → 架构契约 → 逻辑编码 → 构建修复 → 审查修复"五段流水线，按阶段自动接力
Review Agent（白盒化审查）	2 轮场景化审查：按 SPEC 逐场景核对验收标准，第 1 轮发现 7 项问题（含 streak 口径虚标等隐蔽缺陷）
Fix Agent（一键/批量修复）	批量修复 7 项确认缺陷，修复率 100%，自动二次构建验证回归
定时任务调度（流水线状态管理）	各阶段产物（报告/manifest/state）按轮次目录自动归档，可随时续跑
沙箱隔离	构建与脚本执行在独立运行目录 .hmos-feature-dev/runs/ 下，产物互不污染

一人公司提效点：规格→代码→构建→两轮审查修复全链路无需手写一行代码；传统一人完成同等质量（含审查闭环）约需 1-2 周，本流程在一次会话内完成。

七、项目结构速览

entry/src/main/ets/
├── pages/        # Index(三Tab+路由) / Home / Alcohol / Fasting / Posture / Sleep / Caffeine / Stats / Profile
├── components/   # HabitCard / ProgressRing / SectionTitle
├── store/        # PrefsStore(preferences单例) / HabitStore(@Observed全局状态)
├── model/        # Models.ets 数据模型
└── utils/        # DateUtils / DemoSeed(演示种子)

关键设计：

• 持久化：@kit.ArkData preferences，key 前缀 habit.*，写入即 flush；
• 断食恢复：仅存 startTs，界面每秒计算差值，天然抗杀进程；
• 演示种子：首启检测无数据时写入近 7 天记录，统计页/图表开箱即有内容；
• 跨日计算：就寝时间晚于起床时间自动 +24h；体态/咖啡因按日期切换自动归档重置。

八、质量记录

• 构建：BUILD SUCCESSFUL（unsigned HAP，608 KB）；
• 审查：2 轮，最终 8/8 场景 PASS（详见 .hmos-feature-dev/runs/run1/code-review-report.md）；
• 修复：7/7，成功率 100%（review-fix-report.md）；
• 设备自测：已完成模拟器走查（见第十节），无 crash，1 bug 已修复；
• 已知低级别优化项 4 个（历史 30 天截断、streak 隔日展示刷新等），不影响演示主路径。

九、常见问题（FAQ）

问题	处理
hvigor 命令找不到	用第三节完整路径调用，或在 DevEco Studio 内构建
模拟器 CLI 启动失败	必须先在 DevEco Studio Device Manager 手动启动一次
安装报签名错误	配置自动签名后重新构建 signed HAP
想清空数据重演示	我的页 → 重置演示数据