从定位采集到云端上报，从电量优化到失败重试，覆盖完整的位置追踪生命周期。
每 N 分钟自动获取 GPS 与网络融合定位，通过 HTTP POST 将坐标数据发送至云端服务器。
位置变化不足 50 米时自动跳过本轮上报，有效节省网络流量与服务器资源。
通过 backgroundTaskManager 与 LOCATION 后台模式，实现锁屏及切换应用后持续定位不中断。
电量低于 20% 自动延长上报间隔至 15 分钟；低于 10% 暂停上报，保护设备续航。
上报失败自动重试 3 次，间隔分别为 30 秒、60 秒、120 秒，确保数据可靠送达。
主页实时显示当前坐标、上次上报时间、上报状态与电量模式，运行状态一目了然。
支持随时手动触发位置上报，方便开发调试与紧急场景下的即时定位同步。
服务地址、Token、上报间隔均可在设置页面修改并持久化存储，满足个性化部署需求。
HarmonyOS 终端负责采集与上报，云端服务接收并存储，AI Agent 按需读取位置数据。
标准的 RESTful 接口设计，JSON 格式请求体，Token 鉴权，简明的响应状态码。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
lat | number | 是 | 纬度（WGS84），范围 [-90, 90] |
lon | number | 是 | 经度（WGS84），范围 [-180, 180] |
timestamp | number | 是 | Unix 时间戳（秒） |
source | string | 是 | 固定值 "harmonyos" |
accuracy | number | 否 | 定位精度（米），无则 -1 |
altitude | number | 否 | 海拔（米），无则 -1 |
speed | number | 否 | 速度（米/秒），无则 -1 |
| 状态码 | 含义 |
|---|---|
200 | 上报成功 |
400 | 参数格式错误 |
401 | Token 无效 |
500 | 服务器内部错误 |
从环境准备到首次启动，四步完成项目部署。
下载并安装 DevEco Studio 最新版本，配置 HarmonyOS SDK（API 9 及以上）。
使用 git clone 获取项目源码，以 DevEco Studio 打开项目根目录。
通过 USB 连接 HarmonyOS 设备（华为或荣耀手机，系统版本 6.0 及以上），或启动本地模拟器。
点击 Run → Run 'entry' 启动应用。首次启动后在设置页配置服务地址、Token 与上报间隔。
| 操作 | 方式 |
|---|---|
| 开始追踪 | 主页点击「开始记录」，按提示授权定位权限 |
| 停止追踪 | 主页点击「停止记录」 |
| 立即上报 | 主页点击「立即上报」 |
| 修改配置 | 点击右上角齿轮图标进入设置页 |
| 开启后台权限 | 主页橙色横幅提示，点击跳转系统设置 |
| 工具 | 版本 |
|---|---|
| DevEco Studio | 最新版 |
| HarmonyOS SDK | API 9+ |
| 开发语言 | ArkTS |
| 目标设备 | 华为 / 荣耀手机 HarmonyOS 6.0+ |