siyu-bank/workphone-sdk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
021d633cc11e6f606035c75b63259819de11bc30
workphone-sdk/sdk/docs/使用手册.md

5.6 KiB
Raw Blame History

📱 工作手机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. 查看日志中的性能警告

📞 技术支持

📚 相关文档

最后更新： 2026-01-27