\r \r

ClawPhone Phone Control\r

\r

快速流程\r

\r

1. 先感知，再操作。\r
2. 优先用文字/节点能力，坐标点击只在当前截图下临时使用。\r
3. 脆弱流程必须一步一验，不要把多步盲打成“理应成功”。\r \r

感知优先级\r

\r

1. 先用 get_screen_info 判断前台应用、分辨率、可见文字。\r
2. 需要精确定位时，再用 capture_screen。\r
3. 需要找标准控件时，优先 click_by_text 或 find_node。\r \r

操作原则\r

\r

• 输入前先确认输入框真的已获焦。\r
• 启动 App 后先确认前台应用真的切换成功。\r
• 若工具返回“已点击”“已启动”“已输入”，仍要以界面复核为准。\r
• 发送前先确认文本真的已经进入输入框。\r
• 点击发送前先确认发送控件真实可见。\r
• 发送后必须再次确认界面已变化，不要仅凭工具返回值认定成功。\r \r

启动 App\r

\r

1. 可先调用 launch_app(...)。\r
2. 立即用 get_current_app 或 get_screen_info 确认前台应用是否真的切换。\r
3. 若仍停留在桌面或其他 App，不要在同一路径上重复盲开。\r
4. 先读取当前屏幕状态，再决定是否改用桌面图标点击、通知入口或其他页面内入口。\r \r

输入兜底\r

\r

1. 先确认输入框已聚焦。\r
2. 优先尝试 type_text(...)。\r
3. 若 type_text(...) 失败，或文本没有真正进入输入框，立即切到兜底链路：\r
   • set_clipboard(...)\r
   • 长按当前截图里的输入区域\r
   • 截图确认菜单\r
   • 基于当前截图临时点击 粘贴\r
4. 粘贴后再次确认文本真的进入输入框，再继续后续操作。\r \r

坐标原则\r

\r

• 坐标只对应“当前设备、当前页面、当前截图”。\r
• 不要把一次成功的坐标写成固定流程。\r
• 如果页面一变、键盘弹出、工具栏切换，之前的坐标立即失效，应重新截图。\r \r

失败排查\r

\r 按下面顺序定位失败点：\r \r

1. 是否在正确页面。\r
2. 是否点中了真实控件，而不是附近空白区域。\r
3. 输入框是否真的聚焦。\r
4. 文字是否真的进入输入框。\r
5. 发送按钮是否真的出现且可点击。\r
6. 操作后界面是否真的变化。\r
7. 某条路径失败后，是否及时切换到更合适的兜底路径，而不是重复试错。\r \r

微信等脆弱场景\r

\r

• 聊天发送属于脆弱流程，默认一步一验。\r
• press_enter 只能作为兜底，不要把它当作“必然发送成功”的主路径。\r
• 微信自定义弹窗通常不在无障碍树中，遇到菜单项时应截图后临时取坐标点击。\r \r

参考\r

\r

• 需要工具说明时，读 tools-reference.md。\r