# autoGLM

**Repository Path**: kingelf/auto-glm

## Basic Information

- **Project Name**: autoGLM
- **Description**: 自动截屏工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 4
- **Created**: 2025-09-11
- **Last Updated**: 2025-12-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AutoGLM - 智能语音助手

AutoGLM是一款基于大语言模型的智能体操作系统，通过自然语言语音指令驱动AI模拟人类操作手机界面，实现跨应用的复杂任务自动化执行。

## 🚀 项目特色

- **🎤 语音优先**：支持自然语言语音指令，准确率≥95%
- **🤖 AI驱动**：集成GLM-4 Plus大语言模型，智能理解用户意图
- **📱 跨应用操作**：基于无障碍服务实现跨应用自动化操作
- **🎨 惊艳UI**：深空蓝主题 + 3D虚拟助手 + 流畅动画
- **🗺️ 核心功能**：高德地图3D截图一键完成

## 📋 当前开发状态

### ✅ 已完成
- [x] 项目架构搭建（MVVM + Hilt + Compose）
- [x] 数据库设计（Room + 数据模型）
- [x] 网络层设计（Retrofit + GLM API集成）
- [x] UI组件实现（虚拟助手、语音按钮、任务卡片）
- [x] 主题系统（深空蓝设计规范）
- [x] 基础配置（权限、服务、资源文件）

### 🚧 开发中
- [ ] 语音识别模块
- [ ] GLM-4 Plus API集成
- [ ] 无障碍服务实现
- [ ] 高德地图3D截图核心功能
- [ ] 虚拟助手交互逻辑

## 🏗️ 技术架构

```
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   UI Layer      │    │  Business Layer │    │   Data Layer    │
│                 │    │                 │    │                 │
│ • Compose UI    │◄──►│ • ViewModel     │◄──►│ • Repository    │
│ • Components    │    │ • Use Cases     │    │ • Local DB      │
│ • Navigation    │    │ • Services      │    │ • Remote API    │
└─────────────────┘    └─────────────────┘    └─────────────────┘
```

### 核心技术栈
- **开发语言**：Kotlin 1.9+
- **UI框架**：Jetpack Compose
- **架构模式**：MVVM + Clean Architecture
- **依赖注入**：Hilt
- **数据库**：Room + SQLite
- **网络请求**：Retrofit2 + OkHttp3
- **AI模型**：GLM-4 Plus API
- **系统交互**：AccessibilityService

## 🎯 核心功能

### 高德地图3D截图（第一版核心功能）
用户通过语音指令"打开高德地图并在三里屯切成3D地图截一张图"，系统自动完成：

1. **启动高德地图** - 检测并启动应用
2. **搜索地点** - 输入"三里屯"并搜索
3. **选择地点** - 点击第一个搜索结果
4. **切换3D模式** - 点击图层按钮选择3D
5. **截图保存** - 截取屏幕并保存图片

### 虚拟助手交互
- 3D风格的AI助手头像
- 呼吸动画和状态指示
- 情感化交互体验
- 实时语音反馈

## 📱 界面预览

### 主界面
- 深空蓝渐变背景
- 3D虚拟助手头像
- 语音按钮（支持动画效果）
- 最近任务列表

### 设计特色
- **科技感**：霓虹蓝主题 + 粒子效果
- **沉浸式**：全屏体验 + 流畅动画
- **智能化**：AI助手 + 语音交互
- **现代化**：Material Design 3

## 🔧 开发环境

### 系统要求
- Android Studio Electric Eel+
- JDK 8+
- Android SDK 29+
- Gradle 8.0+

### 构建配置
```bash
# 克隆项目
git clone <repository-url>

# 打开项目
# 使用Android Studio打开项目根目录

# 构建项目
./gradlew build

# 运行测试
./gradlew test
```

## 📋 权限说明

应用需要以下权限：
- **麦克风权限**：用于语音识别
- **存储权限**：用于保存截图和文件
- **无障碍服务**：用于跨应用操作
- **屏幕截图权限**：用于截取应用界面

## 🚀 快速开始

1. **安装应用**：下载并安装APK文件
2. **授予权限**：在设置中开启必要权限
3. **启动应用**：点击应用图标启动
4. **语音指令**：说出"打开高德地图并在三里屯切成3D地图截一张图"
5. **等待完成**：观看AI助手自动执行任务

## 📖 文档

- [产品需求文档](PRD.md) - 详细的产品需求和功能规格
- [设计规范文档](DESIGN_SPEC.md) - 完整的UI/UX设计规范
- [开发逻辑流程](开发逻辑流程.md) - 技术实现和架构设计
- [技术文档](doc/技术文档.md) - 技术架构和实现细节

## 🤝 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 📞 联系我们

- **项目主页**：https://github.com/autoglm/autoglm-android
- **问题反馈**：https://github.com/autoglm/autoglm-android/issues
- **邮箱**：dev@autoglm.com

---

**AutoGLM** - 让AI成为你的智能助手 🚀