# Grun_Amazfit

**Repository Path**: xy2294490459/grun_amazfit

## Basic Information

- **Project Name**: Grun_Amazfit
- **Description**: 参考grun佳明版制作的华米版Grun
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-26
- **Last Updated**: 2025-12-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GRun for Amazfit Zepp OS

一个高性能的运动数据监控应用，专为华米 Zepp OS 手表设计。

## 功能特点

### 数据字段支持（41种）
- **基础数据**: 时间、计时器、距离
- **心率数据**: 当前心率、平均心率、心率区间
- **配速/速度**: 当前配速、平均配速、当前速度、平均速度
- **步频**: 当前步频、平均步频
- **功率**: 当前功率、平均功率（支持的设备）
- **ETA**: 5K、10K、半马、全马、50K、100K
- **所需配速**: 5K、10K、半马、全马、50K、100K
- **圈数据**: 圈时间、圈数、上一圈时间、单圈距离、单圈配速
- **其他**: 卡路里、海拔、上升、下降、提前/落后、训练效果、电池、GPS

### 智能颜色编码
- **心率区间**: 5个区间，不同颜色（黑、蓝、绿、橙、红）
- **配速状态**: 过快（蓝）、目标范围内（绿）、过慢（红）

### 配置选项
- **目标配速**: 理想跑步配速（秒/公里）
- **配速范围**: 配速可接受范围（秒）
- **单圈距离**: 圈距离（米）
- **更新间隔**: 数据更新频率（毫秒）
- **单位系统**: 公制/英制切换
- **语言**: 中文/英文切换
- **字体大小**: 可调节的显示字体
- **布局模式**: 自动/手动布局选择

### 设备适配
- **小屏设备**: 320x380px (如 Amazfit Bip 3)
- **中屏设备**: 390x454px (如 Amazfit GTS 2)
- **大屏设备**: 454x454px (如 Amazfit GTR 3)

## 技术栈

- **API_LEVEL**: Zepp OS 4.2 (4020000)
- **语言**: JavaScript (ES6+)
- **框架**: 原生 Zepp OS API
- **构建工具**: Zeus CLI

## 项目结构

```
Grun_Amazfit/
├── app.json                 # 应用配置
├── package.json             # 项目依赖
├── config.json              # UI 和权限配置
├── build.js                 # 构建脚本
├── zeus.bat                 # Zeus CLI 包装脚本
├── pages/                  # 页面文件
│   ├── index.page.js        # 主页面
│   ├── menu.page.js         # 菜单页面
│   ├── field_config.page.js  # 字段配置页面
│   └── settings.page.js      # 设置页面
├── utils/                  # 工具函数
│   ├── i18n.js            # 国际化语言支持
│   ├── performance.js       # 性能监控
│   ├── storage-manager.js   # 优化的存储管理
│   ├── logger.js           # 可视化日志
│   └── ui-components.js    # UI 组件库
└── dist/                   # 构建输出目录
```

## 快速开始

### 环境要求
- Node.js 16+
- Zeus CLI 1.8+
- Zepp OS 开发工具

### 安装依赖

```bash
npm install
```

### 构建应用

```bash
node build.js
```

### 使用 Zepp OS 开发工具

1. 打开 Zepp OS 开发工具
2. 选择"导入项目"
3. 导入 `dist` 目录
4. 连接设备并同步应用

## 性能优化

### 内存管理
- Widget 资源自动管理
- 配置缓存机制
- 智能数据更新（仅在数据变化时更新）
- 页面切换时清理资源

### 响应性能
- 默认 1 秒更新一次
- 可配置更新频率（0.5-5 秒）
- 优化计算和渲染逻辑
- 数据变化检测避免不必要的更新

### 使用官方推荐包

- **@silver-zepp/easy-storage**: 优化的存储管理
- **@silver-zepp/vis-log**: 可视化日志系统
- **@zeppos/zml**: Zepp OS 轻量级工具库
- **zeppos-zui**: 优化的 UI 组件库

## 开发指南

### 添加新字段

1. 在 `FIELD_TYPES` 中添加新常量
2. 在 `getFieldValue()` 中添加对应的 case
3. 在 `getFieldTitle()` 中添加标题
4. 在 `field_config.page.js` 的 `FIELD_OPTIONS` 中添加选项

### 添加新设置

1. 在 `settings.page.js` 的 `SETTINGS` 数组中添加配置项
2. 在 `DEFAULT_CONFIG` 中添加默认值
3. 在 UI 中添加显示和编辑逻辑

## 兼容性

- **平台**: Zepp OS 4.2+
- **设备**: 所有支持 Zepp OS 的华米手表
- **权限**: 位置、传感器

## 许可证

本项目参考 GRun-Chinese 项目开发，遵循开源许可证。

## 贡献

欢迎提交 Issue 和 Pull Request 来改进项目。

---

**构建日期**: 2025-12-26  
**API_LEVEL**: 4020000  
**版本**: 1.0.0