TermControlAgent/modify.md

项目修改记录

2025-08-07

Python版本兼容性分析

• 分析了 requirements.txt 中的依赖包版本
• 确定支持的Python版本范围：3.8 - 3.11
• 推荐使用Python 3.9或3.10版本

pip编码问题修复

• 修复了 requirements.txt 中中文注释导致的GBK编码错误
• 将中文注释改为英文注释
• 建议升级pip版本到最新版本

adbutils版本修复

• 修复了 adbutils==2.0.0 版本不存在的问题
• 更新为 adbutils==2.10.0（有效的最新版本）

配置模块导出修复

• 修复了 ProtocolType 和 DeviceStatus 无法从 app.core.config 导入的问题
• 在 app/core/config/__init__.py 中添加了这两个类的导入和导出

设备管理器导入路径修复

• 修复了多个服务文件中 device_manager 导入路径错误的问题
• 将 from app.core.device_manager import device_manager 改为 from app.core.device.manager import device_manager
• 修复了多个API端点文件中的导入路径错误

服务类名称修复

• 修复了 app/core/device/dispatcher.py 中服务类名称错误的问题
• 将 ADBService、SSHService、ATService、PLNKService、ATXService 改为 AdbService、SshService、AtService、PlnkService、AtxService

未使用的导入清理

• 移除了 app/api/v1/endpoints/adb.py 中未使用的 UploadFile 和 File 导入
• 这解决了 python-multipart 依赖问题

警告过滤添加

• 在 run.py 中添加了 warnings.filterwarnings 来忽略paramiko的弃用警告
• 解决了 TripleDES 加密算法弃用警告

USB监控模块删除

• 删除了 app/api/v1/endpoints/usb_monitor.py 文件
• 该文件依赖不存在的 device_monitor_manager 服务
• 更新了 app/core/app/router.py 和 app/api/v1/endpoints/__init__.py 中的相关引用
• 这解决了路由注册时的导入错误问题