# mower_app

**Repository Path**: dylanln/mower_app

## Basic Information

- **Project Name**: mower_app
- **Description**: 割草机小程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-08
- **Last Updated**: 2025-12-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 割草机器人控制微信小程序

这是一个用于控制割草机器人的微信小程序，提供机器人控制、状态监控、地图显示等功能。

## 功能特性

### 🎮 控制面板
- 实时显示机器人连接状态
- 机器人基本控制按钮（开始、停止、暂停、返航）
- 状态信息显示（机器人状态、任务状态、位置信息）
- 地图管理功能（保存、加载、删除地图）

### 🗺️ 地图监控
- 实时显示机器人位置
- 机器人运动轨迹绘制
- 地图边界显示
- 地图缩放和定位控制
- 实时状态信息面板

### ⚙️ 设置页面
- 服务器连接设置
- 地图显示配置
- 状态更新频率设置
- 通知偏好设置
- 应用信息和日志管理

## 技术架构

### 前端框架
- **微信小程序原生框架** - 基础开发框架
- **TDesign Miniprogram** - UI 组件库
- **原生 Map 组件** - 地图显示

### 核心模块
- **API 封装** - HTTP 请求封装
- **状态管理** - 机器人状态管理器
- **日志系统** - 应用日志记录

### 通信协议
- 基于 HTTP RESTful API
- 与割草机器人通过指定端口通信
- 支持实时状态轮询

## 项目结构

```
mower_app/
├── app.js                  # 小程序主文件
├── app.json               # 全局配置
├── app.wxss               # 全局样式
├── pages/                 # 页面文件
│   ├── index/            # 控制面板页面
│   │   ├── index.js
│   │   ├── index.json
│   │   ├── index.wxml
│   │   └── index.wxss
│   ├── map/              # 地图监控页面
│   │   ├── map.js
│   │   ├── map.json
│   │   ├── map.wxml
│   │   └── map.wxss
│   └── settings/         # 设置页面
│       ├── settings.js
│       ├── settings.json
│       ├── settings.wxml
│       └── settings.wxss
├── utils/                # 工具模块
│   ├── api.js            # API 接口封装
│   ├── status-manager.js # 状态管理器
│   └── logger.js         # 日志工具
├── images/               # 图片资源
└── project.config.json   # 项目配置
```

## API 接口

### 机器人控制
- `GET /crs/mower/robot/get_localization_pose` - 获取定位
- `GET /crs/mower/robot/get_gnss` - 获取 GNSS 数据
- `GET /crs/mower/robot/robot_status` - 获取机器人状态

### 地图管理
- `GET /crs/mower/map/get_map_list` - 获取地图列表
- `GET /crs/mower/map/get_map` - 获取地图
- `GET /crs/mower/map/delete_map` - 删除地图
- `GET /crs/mower/map/save_map` - 保存地图
- `GET /crs/mower/map/start_record_map` - 开始录制地图
- `GET /crs/mower/map/stop_record_map` - 停止录制地图

### 任务控制
- `GET /crs/mower/service/start_task` - 开始任务
- `GET /crs/mower/service/end_task` - 结束任务
- `GET /crs/mower/task/pause_task` - 暂停任务
- `GET /crs/mower/task/continue_task` - 继续任务
- `GET /crs/mower/task/task_status` - 获取任务状态

详细 API 文档请参考 `割草机器人api文档.md`

## 开发指南

### 环境要求
- 微信开发者工具
- Node.js (用于 npm 包管理)
- TDesign Miniprogram 组件库

### 安装步骤

1. 克隆项目到本地
2. 在微信开发者工具中导入项目
3. 安装依赖：
   ```bash
   npm install
   ```
4. 在微信开发者工具中构建 npm 包
5. 配置服务器地址（在设置页面中）

### 配置说明

#### 服务器地址
在设置页面中配置机器人服务器的 IP 地址和端口，例如：`http://192.168.1.100:8080`

#### 小程序配置
在 `project.config.json` 中设置正确的 `appid`

## 设计规范

### 颜色方案
- 主色: #22c55e (绿色)
- 次要色: #1e3a8a (深蓝)
- 警告色: #f97316 (橙色)
- 危险色: #ef4444 (红色)
- 背景色: #0f172a (深灰)

### 字体规范
- 主标题: 32rpx, 600 weight
- 正文: 28rpx, 500 weight
- 辅助文字: 24rpx, normal weight

### 间距规范
- 页面边距: 20rpx
- 组件间距: 16rpx, 24rpx
- 内边距: 24rpx

## 故障排除

### 连接问题
1. 检查服务器地址是否正确
2. 确认机器人服务器是否运行
3. 检查网络连接和防火墙设置
4. 确认端口是否被占用

### 地图显示问题
1. 检查位置权限是否已授予
2. 确认 GPS 信号是否正常
3. 检查地图数据是否正确加载

### 性能优化
1. 调整状态更新频率
2. 限制轨迹点数量
3. 定期清理缓存和日志

## 版本历史

### v1.0.0 (当前版本)
- 基础控制功能
- 地图显示和监控
- 设置页面
- 状态管理
- 日志系统

## 许可证

MIT License

## 贡献指南

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

## 联系方式

如有问题或建议，请联系开发团队。