Skill: dingidng (version 1.0.0)

--- name: autoglm-runner description: Execute mobile automation tasks using Zhipu AI's AutoGLM. Use when testing mobile apps, automating game workflows, running UI tests on Android emulators, or performing automated phone operations including app launching, login flows, and in-app interactions. --- # AutoGLM Runner Execute mobile automation tasks using Zhipu AI's AutoGLM model for Android emulator testing and game automation. ## When to Use - Running automated tests on mobile apps - Testing game login and progression flows - Performing UI automation on Android emulators (MuMu, etc.) - Executing repetitive mobile tasks automatically - Validating app functionality across multiple scenarios ## Configuration ### Required Settings (已配置，可直接使用) | 参数 | 值 | |------|-----| | Base URL | `https://open.bigmodel.cn/api/paas/v4` | | Model | `autoglm-phone` | | API Key | `*************` | > **重要**: 调用时必须同时指定 `--base-url`、`--model` 和 `--apikey` 三个参数，否则会连接失败或认证错误。 ### Device Setup Ensure ADB is connected to target device: ```bash adb connect 127.0.0.1:7555 adb devices ``` ## Quick Start (推荐) ### 直接执行 Python 命令 (最可靠) ```bash cd Open-AutoGLM python main.py --base-url "https://open.bigmodel.cn/api/paas/v4" --model "autoglm-phone" --apikey "your-api-key" "你的任务描述" ``` ### 使用批处理脚本 ```bash cd Open-AutoGLM run_autoglm.bat --base-url https://open.bigmodel.cn/api/paas/v4 --model "autoglm-phone" --apikey "your-api-key" "打开微信，进入朋友圈，发布一条动态" ``` ## Usage Patterns ### Pattern 1: Simple Task Execution For single automation tasks: ```bash cd Open-AutoGLM python main.py --base-url "https://open.bigmodel.cn/api/paas/v4" --model "autoglm-phone" --apikey "your-api-key" "打开微信，进入朋友圈，发布一条动态" ``` ### Pattern 2: Game Testing Workflow For game automation testing (launch → login → gameplay): ```bash cd Open-AutoGLM game_auto_test.bat ``` This runs the complete test suite: 1. Launch game 2. Wait for startup 3. Click login button 4. Navigate to main city 5. Upgrade a building ### Pattern 3: Batch Testing Multiple Apps For testing multiple installed games: ```bash cd Open-AutoGLM simple_game_test.bat ``` Automatically detects and tests all installed game packages. ## Task Templates ### App Testing - "打开 [应用名]，查看首页内容" - "打开 [应用名]，搜索 [关键词]" - "打开 [应用名]，进入设置页面" ### Game Automation **Important**: For 三国志战略版 (Sanguo Zhanlue Ban), the login button is labeled "前往征战" (Go to Battle), not "登录". **三国志战略版渠道版本**: - 官方版本：`com.aligames.sgzzlb` - 应用宝渠道：`com.tencent.tmgp.s3.sgzzlb` - B 站渠道：`com.aligames.sgzzlb.bilibili` - 华为/荣耀：`com.aligames.sgzzlb.honor` - 三星：`com.aligames.sgzzlb.samsung` - 联想：`com.aligames.sgzzlb.lenovo` - 4399: `com.aligames.sgzzlb.m4399` - 努比亚：`com.aligames.sgzzlb.nubia` - 阿里游戏：`com.aligames.sgzzlb.aligames` **三国志战略版选服操作指南**: 选服是登录前的关键步骤，正确的操作流程如下： 1. **进入登录界面后**，屏幕底部会显示当前服务器信息（如"2026春季皮肤测试服 维护"） 2. **点击"点击选服"文字**（在屏幕底部中间位置），打开服务器选择界面 3. 在服务器选择界面： - 左侧是赛季分类标签（已有角色、赛季1、赛季2等） - 中间是服务器列表 - 底部有"搜索服务器名称"输入框和"确定"按钮 4. **搜索服务器**：点击底部的搜索框，输入服务器名称 5. **选中搜索结果**：从搜索结果列表中**点击选中**目标服务器（这一步很重要，必须点击选中后再点确定） 6. **确认选择**：点击"确定"按钮返回登录界面 7. **登录游戏**：点击"前往征战"按钮进入游戏 > **注意**： > - 不要点击"选择赛季"或"输入服务器id"，这些不是选服入口 > - 搜索后必须先**点击选中**搜索结果中的服务器，再点确定，否则不会切换服务器 **主城升级操作指南**： 主城（君王殿）和城内建筑的升级入口在**城建系统**中： 1. **进入主城**：点击"前往征战"进入游戏主界面后，点击主城建筑（中央的城堡图标） 2. **入城**：点击"入城"按钮进入城内界面 3. **打开城建**：在城内界面点击屏幕左上方的"城建"按钮 4. **选择建筑升级**：在城建界面可以看到各种建筑（内政、军事、守备三类） 5. **点击升级**：选择可升级的建筑，点击"升级"按钮完成升级 > **注意**：**君王殿**就是主城，升级君王殿即升级主城等级 **GM 指令操作**（测试服专用）： 如果需要执行 GM 指令（如关闭调试信息）： 1. **打开 GM 入口**：点击底部"更多"按钮 → 点击"GM" 2. **搜索指令**：在 GM 面板右上角的搜索框输入指令名称 3. **执行指令**：点击搜索结果中的指令执行 **常用 GM 指令示例**： - `debug` → 点击"隐藏 debug 信息"：关闭屏幕上的调试信息，避免遮挡按钮识别 **升级优先级建议**： - 优先升级：仓库（避免资源爆仓）→ 农场/采石场/伐木场/冶铁厂（资源产出）→ 民居（铜币收入） - 其次升级：军舍（增加部队上限）→ 军营（提升兵力） - 最后升级：城墙、士气坛等守备建筑 > **提示**： > - 升级建筑需要满足"君王殿"等级要求 > - 升级需要消耗资源（木材、粮食、石料等）和时间 > - 如果升级按钮是灰色的，说明条件未满足或资源不足 **Task Examples**: - "打开三国志战略版官方版本，点击前往征战按钮登录" - "启动灵犀官渠，点击屏幕底部的点击选服文字，搜索公共1赛季测试服，选中后点确定，然后点击前往征战登录" - "打开三国志战略版应用宝渠道，等待启动后点击前往征战" - "打开三国志战略版 B 站版本，升级主城建筑" - "打开 [游戏名]，升级主城建筑" - "打开 [游戏名]，参与一次战斗" ### System Operations - "调节亮度到 50%" - "打开 WiFi 设置" - "截取当前屏幕" ## Script Reference | Script | Purpose | |--------|---------| | `run_autoglm.bat` | Basic execution wrapper | | `game_auto_test.bat` | Game launch + login + upgrade test | | `simple_game_test.bat` | Auto-detect and test all games | | `interactive_menu.bat` | Interactive menu with 21+ presets | | `test_scripts.bat` | Command-line test runner (15 scripts) | ## Example Commands ### Test WeChat ```bash python main.py --base-url "https://open.bigmodel.cn/api/paas/v4" --model "autoglm-phone" --apikey "b6e4e5932e4e43b8bcce9d719d582392.OsCQzFhUuCdygFpi" "打开微信" ``` ### Test Taobao Search ```bash python main.py --base-url "https://open.bigmodel.cn/api/paas/v4" --model "autoglm-phone" --apikey "b6e4e5932e4e43b8bcce9d719d582392.OsCQzFhUuCdygFpi" "打开淘宝，搜索 iPhone，查看第一个商品" ``` ### Test Game Login ```bash python main.py --base-url "https://open.bigmodel.cn/api/paas/v4" --model "autoglm-phone" --apikey "b6e4e5932e4e43b8bcce9d719d582392.OsCQzFhUuCdygFpi" "打开三国志战略版应用宝渠道，点击前往征战按钮登录" ``` ## 执行原则 **只执行给定的命令，不要额外发散** - 严格按照用户指令执行，不要添加未要求的操作 - 如果当前状态已经可以完成指令，直接执行，不要额外探索 - 遇到不确定的情况时，优先按照指令字面意思执行 - 如需发散或探索，必须基于用户的明确指令 ## 任务完成判定 当任务目标达成时，**立即停止执行并使用 `finish` 动作结束任务**： ### 启动类任务完成标准 | 任务 | 完成判定 | |------|----------| | 启动应用/游戏 | 应用/游戏成功打开并加载完成 | | 启动官网包/官渠 | 三国志战略版成功启动（官网包=灵犀官渠=三国志战略版官方版本） | | 登录游戏 | 进入游戏主界面（看到角色信息和地图） | ### 重要提示 - **灵犀官渠 = 三国志战略版官方版本 = 官网包**：三者是同一个应用的不同叫法 - "灵犀官渠"是渠道版本名称 - "三国志战略版"是游戏显示名称 - "官网包"是简称 - 启动后显示"三国志战略版"标题是正常的，任务即完成 - 任务完成后立即调用 `finish(message="任务完成")` 结束执行 - 不要继续探索或执行未要求的操作 ### 启动指令对照表 | 用户指令 | 实际应用 | 包名 | |---------|---------|------| | 启动官网包 | 灵犀官渠/三国志战略版 | com.aligames.sgzzlb | | 启动灵犀官渠 | 灵犀官渠/三国志战略版 | com.aligames.sgzzlb | | 启动三国志战略版 | 三国志战略版 | com.aligames.sgzzlb | ## 遇到不会的操作 当 AutoGLM 遇到不熟悉或无法识别的游戏界面/操作时： 1. **优先按指令执行**：严格按照用户给定的步骤操作 2. **查看提示**：注意屏幕上的文字提示、按钮标签 3. **网络搜索**：如果界面复杂且无法理解，可以建议用户搜索具体操作步骤 4. **记录问题**：将遇到的问题记录下来，以便后续优化 **搜索建议格式**： ``` "三国志战略版 [具体操作名称] 步骤" 例如： - "三国志战略版 主城升级 步骤" - "三国志战略版 城建系统 入口" - "三国志战略版 君王殿升级 条件" ``` ## Troubleshooting ### Issue: Unicode Encoding Errors **Solution**: All scripts already set UTF-8 encoding. If issues persist: ```bash chcp 65001 ``` ### Issue: Device Not Found **Solution**: ```bash adb kill-server adb start-server adb connect 127.0.0.1:7555 ``` ### Issue: ADB Keyboard Required **Solution**: Install ADB Keyboard on emulator: ```bash adb install ADBKeyboard.apk ``` Then enable in Settings > Language & Input. ### Issue: API Connection Failed **Solution**: - Verify API key is correct - Check network connectivity - Visit https://open.bigmodel.cn to verify account status ## Advanced Options | Parameter | Description | Default | |-----------|-------------|---------| | `--max-steps` | Maximum execution steps | 100 | | `--device-id` | Specific device ID | Auto-detect | | `--lang` | Language (cn/en) | cn | | `--quiet` | Suppress verbose output | false | ## Output Interpretation AutoGLM returns: - **思考过程**: AI reasoning and decision making - **执行动作**: Actions performed (Tap, Launch, Swipe, etc.) - **性能指标**: Token generation latency metrics - **Result**: Final task outcome Monitor these to understand execution flow and diagnose failures. ## Best Practices 1. **Start Simple**: Test basic tasks before complex workflows 2. **Monitor Execution**: Watch for unexpected navigation or errors 3. **Clear Data Between Tests**: Use `adb shell pm clear <package>` to reset app state 4. **Allow Sufficient Time**: Complex tasks may need more steps (`--max-steps 50`) 5. **Document Failures**: Keep logs for debugging recurring issues ## Related Files - `README_TEST.md` - Complete testing guide - `GAME_TEST_GUIDE.md` - Game automation documentation - `logs/` - Test execution logs - `screenshots/` - Test screenshots (when using full batch mode)


Security scan verdicts — ClawScan: suspicious | static analysis: suspicious | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)