Skip to content

Conversation

@ZV-Liu
Copy link

@ZV-Liu ZV-Liu commented Dec 14, 2025

✨ 主要变更

新增文件

  • web_ui.py (754行): 完整的 Gradio Web UI 实现
  • resources/iShot_2025-12-14_14.04.42.png: Web UI 界面截图

文档更新

  • README.md: 新增 Web UI 使用指南章节
  • README_en.md: 新增英文版 Web UI 使用指南

🎯 核心功能

1. 📱 设备管理

  • 查看所有已连接设备
  • 支持 USB 和 WiFi 连接
  • 远程设备连接功能

2. 🔍 系统检查

  • ADB 工具安装状态检查
  • 设备连接状态检查
  • ADB Keyboard 安装检查
  • 模型 API 连接检查

3. 💬 对话控制

  • 自然语言任务输入
  • 流式输出显示 AI 思考过程
  • 实时设备截图显示(支持自动刷新)
  • 会话管理(新对话/终止任务)

4. ⚙️ 配置管理

  • 模型 API 地址配置
  • API Key 管理
  • 多设备实时选择
  • 语言切换(中英文)
  • 最大步数设置

🚀 使用方式

# 启动 Web UI
python web_ui.py

# 访问界面
http://127.0.0.1:7860
📖 技术实现
框架: Gradio 4.x
架构:
AgentSession 类管理会话状态
流式输出支持实时反馈
全局会话存储支持多会话
特性:
支持任务中断
自动截图刷新
完整的错误处理
环境检查与诊断
✅ 测试清单
 Web UI 正常启动
 设备连接和管理功能
 系统环境检查功能
 任务执行与流式输出
 截图实时显示
 会话管理功能
 文档更新(中英文)
📸 截图
<img width="1575" height="1005" alt="iShot_2025-12-14_16 27 01" src="https://github.com/user-attachments/assets/a1d073ac-d6bf-4a39-bed2-1af01a1103d6" />

🔗 相关 Issue
解决了用户对可视化界面的需求,降低了使用门槛。

@tigerjibo
Copy link

Good idea. I'm actually working on this feature today as well.

@yongbin-buaa
Copy link
Collaborator

Hi, 这是一个不错的feature, 但是有几点需要优化:

  1. 应该支持中英文双语, 根据用户的选择的language确定system prompt 以及页面框架描述
  2. 应该允许用户在网页配置使用base-url model和apikey, 目前我似乎没有找到对应的位置
image

- Add missing wifi_connection_md component to fix output count mismatch (24 vs 23)
- Fix Button component initialization by using 'value' parameter instead of 'label'
- Resolves TypeError: Button.__init__() got an unexpected keyword argument 'label'
@ZV-Liu
Copy link
Author

ZV-Liu commented Dec 15, 2025

嗨,我已经为页面添加了支持中英文双语,通过在页面能够选择语言,进而确定传入Agent_Config 后的system prompt语言以及切换页面框架。
其次,在布局方面,优化为纵向排列,支持base url和api key

@ZV-Liu
Copy link
Author

ZV-Liu commented Dec 17, 2025

Hi, 这是一个不错的feature, 但是有几点需要优化:

  1. 应该支持中英文双语, 根据用户的选择的language确定system prompt 以及页面框架描述
  2. 应该允许用户在网页配置使用base-url model和apikey, 目前我似乎没有找到对应的位置
image

嗨,我已经为页面添加了支持中英文双语,通过在页面能够选择语言,进而确定传入Agent_Config 后的system prompt语言以及切换页面框架。
其次,在布局方面,优化为纵向排列,支持base url和api key

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants