SwiftBand

SwiftBand 是一款面向 openvela 快应用运行时（frameworks_runtimes_quickapp）的智能手环应用。采用「组件化 UI + 响应式 Store + 清单路由」的前端式架构，覆盖多表盘、心率/步数、卡片切换、智能消息中心、运动记录、7 日历史、低功耗与模拟手机同步，并附带一个独立的原生 C/LVGL 兜底子工程。

SwiftBand preview

预览：直接用浏览器打开 preview/index.html，点击「自动预览」查看表盘轮播、心率/步数圆环、全屏来电、运动记录、7 日趋势、AI 健康助手与手机同步（支持 ?tour=1 自动播放、?record=1 录制模式、?scene=ai 直达场景）。

界面一览

智能消息中心	AI 健康助手	手机同步

以上为 preview/index.html 自动预览中的真实渲染截图。

功能亮点

三套表盘：潮流数字 / 极简 AOD / 运动，swiper 轮播切换并持久化所选表盘。
健康数据：场景化模拟心率、步数、卡路里，stat-ring 圆环实时展示。
智能消息中心：来电全屏强提醒、短信横幅、应用卡片、运动中细横幅、勿扰只放行来电，并调用 @system.vibrator 真实震动。
运动记录：步行/跑步计时，实时时长/步数/卡路里，结束写入会话历史。
AI 健康助手：通过 @system.fetch 调用 OpenAI 兼容大模型（DeepSeek 主用、MiniMax 兜底），根据当日数据生成简短健康建议；密钥配置在 src/common/ai-config.js。
持久化：@system.storage 保存设置、7 日历史与运动会话，历史页用 canvas 趋势图展示。
低功耗：常亮 / 节能 / 息屏三档，@system.brightness 调暗，@system.sensor 抬腕亮屏。
国际化：中英文文案，设置页实时切换并按设备语言自动选择。
模拟同步：设置页同步进度，tools/phone_sync_mock.py 提供宿主机同步接收。

快速开始

需要 Node.js ≥ 18、npm、OpenSSL；详见 docs/build-and-run.md。

npm run setup        # 安装依赖 + 生成品牌资产 + 生成自签名证书
npm run build:rpk    # 构建 debug 签名 rpk -> dist/org.team.swiftband.debug.1.0.0.rpk
npm run release:rpk  # 构建 release 签名 rpk -> dist/org.team.swiftband.release.1.0.0.rpk

本地自检

npm run check        # 格式、语法、结构、冒烟、单元、原生语法与离线预览检查
npm run validate     # 工程结构与关键特性标记
npm run smoke        # 消息优先级规则
npm test             # 核心业务逻辑单元测试（mock 系统 API）
npm run check:native # 原生兜底 C 源语法检查
npm run ai:check     # 用生产代码对 DeepSeek/MiniMax 真实接口做端到端校验
npm run preview:check
npm run sync:mock

在 openvela 上运行

openvela 快应用由运行时加载，设备/模拟器需启用 CONFIG_QUICKAPP + CONFIG_QUICKAPP_VAPP，或使用 AIoT-IDE 的 vela-miwear-watch 模拟器镜像：

OPENVELA_ROOT=/path/to/openvela bash scripts/run_sim.sh
bash scripts/push_rpk.sh dist/org.team.swiftband.debug.1.0.0.rpk
adb shell 'vapp hap://app/org.team.swiftband'

完整运行与检查步骤见 docs/runtime-checks.md。

离线预览

没有 openvela 模拟器时，可直接打开 preview/index.html 查看交互行为（见 preview/README.md）。预览图为 docs/img/swiftband_preview.svg（动画 SVG，浏览器中可见动效，静态首帧可直接阅读）。

项目结构

src/                          快应用主工程（manifest / app.ux / common / components / pages / i18n / assets）
native_fallback/swiftband_min 原生 C/LVGL 兜底子工程
scripts/                      构建、签名、资产、校验脚本
tests/                        核心逻辑单元测试
tools/                        phone_sync_mock.py 同步接收
preview/                      桌面浏览器离线预览
docs/                         架构 / 功能 / 构建运行 / 运行时检查 / 合规

文档

许可证

Apache-2.0，见 LICENSE、NOTICE、THIRD_PARTY.md。