项目定位

本项目围绕智能手环的初赛基础能力和复赛扩展方向，提供一套可本地运行、可录制演示、可继续迁移到 openvela 的作品材料：

• 本地手环演示：表盘时间、健康指标、步数目标、运动模式、提醒、异常告警、低功耗和同步状态。
• 本地后端模拟：健康数据采样、7 天历史、消息队列、离线/在线同步、告警状态 API。
• openvela 迁移骨架：快应用与 C/LVGL 原生骨架，覆盖页面、状态、传感器输入、蓝牙同步、低功耗策略与事件回调。
• 提交材料：官方题面对齐说明、测试记录、演示脚本、合规文件和提交包。

当前边界

当前可直接运行的是本地 HTML 演示和 Node.js 模拟后端；openvela 目录提供迁移骨架与接口设计。项目尚未在官方 openvela 模拟器、Bandx、真实开发板中完成构建运行，也未生成官方 quick app RPK 或 C/LVGL SDK 二进制。README、文档和演示均按这一边界表述。

快速运行

要求：Windows PowerShell，Node.js 18 或更新版本。

cd C:\CCFOpenSourcepowershell
cd C:\CCFOpenSource\03_openvela_SmartBand
powershell -ExecutionPolicy Bypass -File .\backend\run_backend.ps1
3_openvela_SmartBand
powershell -ExecutionPolicy Bypass -File .\backend\run_backend.ps1

脚本会启动本地服务，浏览器打开：

http://127.0.0.1:8787/index.html

也可以仅查看静态前端：

Start-Process .\demo\index.html

演示截图

这些截图由 Playwright 从本地演示自动截取，可作为初赛“运行演示（截图）”素材。

表盘与健康总览	后端健康数据采样

异常告警与离线同步	同步队列与历史数据

功能覆盖

赛题要求	当前实现	证据位置
表盘与时间显示	本地表盘实时显示时间、日期、电量、低功耗状态	demo/、截图
健康数据展示	心率、步数、卡路里、睡眠、血氧等模拟数据展示	demo/、backend/
基础 UI 交互	页面切换、运动模式、提醒、告警、同步状态	demo/app.js
可复现运行说明	一键启动后端与前端演示	backend/run_backend.ps1、本 README
openvela 迁移	快应用与 C/LVGL 骨架、模块边界和接口草案	openvela_quick_app_skeleton/、openvela_native_lvgl_skeleton/
工程化与合规	测试脚本、LICENSE、NOTICE、第三方声明	tests/、LICENSE、NOTICE、THIRD_PARTY_DECLARATION.md

项目结构

路径	说明
demo/	本地智能手环交互演示前端
backend/	Node.js 本地模拟后端与启动脚本
tests/	后端 API、UI 截图、演示证据和仓库结构检查脚本
openvela_quick_app_skeleton/	openvela 快应用迁移骨架
openvela_native_lvgl_skeleton/	openvela 原生 C/LVGL 迁移骨架
official_runtime_evidence/	官方模拟器/开发板运行证据的预留清单与采集说明
output/playwright/	自动截图与本地演示证据
docs/	归档后的详细方案、题面对齐、提交、评审和历史报告
dist/	已生成的提交压缩包，保留旧包不覆盖
submission_ppt/	提交展示材料说明

详细文档索引见 docs/README.md。

验证命令

node .\tests\backend_api_test.js
powershell -ExecutionPolicy Bypass -File .\tests\verify_demo_evidence.ps1
node .\tests\demo_ui_audit_check.js
powershell -ExecutionPolicy Bypass -File .\tests\repository_smoke_check.ps1

当前重点验证范围：本地后端 API、前端截图证据、UI 文案边界、仓库入口整洁度。真实 openvela 模拟器/开发板构建仍属于后续迁移验证。

提交包

当前仓库保留历史提交包，统一放在 dist/：

• dist/TaskA_openvela_smart_band_topic_aligned_20260707_chinese_docs_20260709_20260709_144552.zip
• dist/TaskA_openvela_smart_band_topic_aligned_20260707_official_toolchain_probe_20260709_20260709_135953.zip

平台最终提交时还需要按赛事页面上传 5 分钟内展示视频，并确保 GitLink 仓库公开可访问。

openvela 迁移边界

本仓库已经把应用逻辑拆成可迁移模块：页面状态、健康数据输入、运动记录、消息提醒、低功耗策略、同步队列与事件回调。下一步要在官方 openvela 环境中完成以下工作：

1. 选择快应用或 C/LVGL 原生路线。
2. 按骨架接入官方模拟器 Bandx 运行链路。
3. 将本地模拟后端的数据模型替换为 openvela 传感器、存储、蓝牙和生命周期接口。
4. 生成官方运行截图、日志、视频和可复现构建说明。

许可

项目代码按 Apache License 2.0 发布。第三方依赖与素材来源见 THIRD_PARTY_DECLARATION.md。