# 📱 工作手机Agent使用手册

> 版本：v1.0  
> 更新：2026-01-27

---

## 📋 目录

1. [快速开始](#快速开始)
2. [功能说明](#功能说明)
3. [配置说明](#配置说明)
4. [语音命令](#语音命令)
5. [常见问题](#常见问题)
6. [故障排查](#故障排查)

---

## 🚀 快速开始

### 1. 安装APP

1. 下载APK文件
2. 在手机上安装
3. 打开"工作手机Agent"

### 2. 首次配置

#### 方式一：扫描二维码（推荐）

1. 点击右上角**设置**按钮
2. 点击**扫描二维码**
3. 扫描服务器提供的项目二维码
4. 自动完成配置

#### 方式二：手动配置

1. 点击右上角**设置**按钮
2. 输入**服务器地址**（如：`ws://sdk.quwanzhi.com:8899/ws/device`）
3. 输入**项目ID**
4. 点击**连接**

### 3. 开启权限

#### 必需权限
- ✅ **麦克风权限** - 用于语音识别
- ✅ **相机权限** - 用于扫描二维码
- ✅ **通知权限** - 用于后台运行

#### 推荐权限（可选但建议开启）
- ✅ **无障碍服务** - 用于UI自动化（更稳定）

**开启无障碍服务：**
1. 设置 → 无障碍 → 工作手机Agent
2. 开启服务
3. 返回APP

---

## 🎯 功能说明

### 1. 语音控制

#### 使用方法
1. 点击屏幕中央的**麦克风按钮**
2. 说话（支持中文）
3. 自动识别并执行

#### 支持的命令
- **打开应用**：`打开微信`、`打开豆包`、`打开抖音`
- **复合命令**：`打开豆包，搜索今天去哪`
- **导航操作**：`返回`、`回到桌面`、`最近任务`
- **滑动操作**：`向上滑`、`向下滑`、`左滑`、`右滑`
- **系统操作**：`截图`、`锁屏`、`音量加`、`音量减`

### 2. 快捷按钮

屏幕底部有三个快捷按钮：
- **打开豆包** - 快速打开豆包应用
- **返回** - 返回上一页
- **截图** - 快速截图

### 3. 后台服务

- APP关闭后服务继续运行
- 保持与服务器连接
- 接收远程控制命令
- 状态栏显示连接状态

---

## ⚙️ 配置说明

### 服务器地址格式

```
ws://服务器地址:端口/ws/device
```

**示例：**
- 本地开发：`ws://10.0.2.2:8899/ws/device`
- 生产环境：`ws://sdk.quwanzhi.com:8899/ws/device`

### 项目ID

- 由服务器管理员提供
- 用于区分不同的项目
- 一个设备只能绑定一个项目

### 设备ID

- 自动生成
- 格式：`device_型号_时间戳`
- 用于标识设备

---

## 🎤 语音命令

### 应用操作

| 命令 | 说明 | 示例 |
|------|------|------|
| 打开[应用名] | 打开指定应用 | `打开微信`、`打开豆包` |
| 启动[应用名] | 启动指定应用 | `启动抖音` |
| 切换到[应用名] | 切换到指定应用 | `切换到微信` |

**支持的应用：**
微信、抖音、豆包、支付宝、淘宝、微博、QQ、小红书、B站、知乎等20+应用

### 搜索操作

| 命令 | 说明 | 示例 |
|------|------|------|
| 搜索[关键词] | 在当前应用搜索 | `搜索今天去哪` |
| 打开[应用]，搜索[关键词] | 打开应用并搜索 | `打开豆包，搜索今天去哪` |

### 导航操作

| 命令 | 说明 |
|------|------|
| 返回 | 返回上一页 |
| 回到桌面 | 回到主屏幕 |
| 最近任务 | 显示最近任务 |

### 滑动操作

| 命令 | 说明 |
|------|------|
| 向上滑 | 向上滑动 |
| 向下滑 | 向下滑动 |
| 左滑 | 向左滑动 |
| 右滑 | 向右滑动 |

### 系统操作

| 命令 | 说明 |
|------|------|
| 截图 | 截取屏幕 |
| 锁屏 | 锁定屏幕 |
| 音量加 | 增加音量 |
| 音量减 | 减少音量 |
| 静音 | 静音 |

### 媒体控制

| 命令 | 说明 |
|------|------|
| 播放 | 播放/暂停 |
| 下一首 | 下一首 |
| 上一首 | 上一首 |

---

## ❓ 常见问题

### Q1: 语音识别不准确？

**A:** 
1. 确保在安静环境中使用
2. 说话清晰，语速适中
3. 检查麦克风权限是否开启
4. 尝试重新启动APP

### Q2: 命令执行失败？

**A:**
1. 检查无障碍服务是否开启（推荐）
2. 确保应用已安装
3. 检查网络连接
4. 查看日志文件：`/sdcard/workphone_agent/logs/`

### Q3: 无法连接服务器？

**A:**
1. 检查服务器地址是否正确
2. 检查网络连接
3. 检查防火墙设置
4. 尝试手动重连

### Q4: 后台服务停止？

**A:**
1. 检查电池优化设置（关闭对APP的优化）
2. 检查自启动权限
3. 确保通知权限已开启
4. 重启APP

### Q5: 无障碍服务无法开启？

**A:**
1. 检查系统版本（需要Android 5.0+）
2. 检查是否有其他无障碍服务冲突
3. 重启手机后重试
4. 如果仍无法开启，可以使用Shell命令方式（需要ADB）

---

## 🔧 故障排查

### 1. 查看日志

日志文件位置：`/sdcard/workphone_agent/logs/agent_YYYY-MM-DD.log`

**查看方法：**
1. 使用文件管理器
2. 打开`/sdcard/workphone_agent/logs/`
3. 查看最新的日志文件

### 2. 检查连接状态

**状态指示：**
- 🟢 **绿色圆点** - 已连接
- 🔴 **红色圆点** - 未连接

**如果未连接：**
1. 检查服务器地址
2. 检查网络
3. 点击设置 → 连接

### 3. 重置配置

如果遇到问题，可以重置配置：

1. 卸载APP
2. 重新安装
3. 重新配置

### 4. 性能问题

如果APP运行缓慢：

1. 清理后台应用
2. 重启手机
3. 检查内存使用情况
4. 查看日志中的性能警告

---

## 📞 技术支持

- **微信**：28533368
- **电话**：15880802661
- **邮箱**：zhiqun@qq.com

---

## 📚 相关文档

- [开发文档](../README.md)
- [语音命令使用指南](./语音命令使用指南.md)
- [设备启动指南](./设备启动指南.md)
- [真机部署指南](./真机部署指南.md)

---

**最后更新：** 2026-01-27
