Open-AutoGLM 单元测试运行与二次开发环境配置
安装开发依赖
普通用户装 pip install -e . 就够了,但二次开发需要装开发依赖:
pip install -e ".[dev]"
方括号里的 dev extra 会额外安装 pytest 等测试依赖。项目的 setup.py / pyproject.toml 里定义了 extras_require。
运行测试
pytest tests/
如果测试目录不存在,说明版本里暂时还没写单元测试——这在开源框架初期很常见。可以自己补测试用例,推荐针对你的二次开发点写:
# 示例:测试你新加的 Long Press Drag handler
# tests/test_custom_actions.py
from phone_agent.actions.handler import ACTION_HANDLERS
def test_long_press_drag_registered():
assert "Long Press Drag" in ACTION_HANDLERS
虚拟环境管理建议
二次开发期间推荐独立 venv,不要用生产环境:
# 创建独立虚拟环境
python -m venv dev_env
dev_env\Scripts\activate # Windows
# source dev_env/bin/activate # macOS/Linux
# 安装开发版
pip install -e ".[dev]"
# 跑测试
pytest
开发工作流建议
1. fork Open-AutoGLM 仓库 → clone 到本地
2. 切换到 dev 分支(或新建功能分支)
3. pip install -e ".[dev]"
4. 修改代码 → 写/改测试 → pytest tests/
5. python main.py --verbose 手工验证(连真机)
6. commit → push → 提 PR
Verbose 模式作为开发调试
框架的 --verbose 模式(或 Python API 的 AgentConfig(verbose=True))本身就是最好的开发调试工具:
python main.py --verbose --list-apps # 检查 App 列表
python main.py --verbose "打开美团" # 看 Agent 的思考链和每步动作