跳转到内容
/
AI Agent 使用
Last updated

AI Agent 使用指南

本页面介绍如何在 Codex、Claude Code、Cursor、Gemini CLI 等 AI 编程助手中使用 ml-cli。

复制到 Agent

将以下提示词复制并粘贴到您的 AI 助手中，即可自动安装配置 MoreLogin CLI：

This template's language is not my preference. Before your first substantive reply, detect and use my OS UI language (Windows: `Get-UICulture`, then `Get-Culture`); if unavailable, use my latest non-template message's language.

Follow the MoreLogin installation, verification, and `ml-cli` usage guide:
https://github.com/MoreLoginBrowser/morelogin-skills/blob/main/skills/morelogin-setup/install.md

Keep commands, paths, JSON/API fields, and original MoreLogin responses unchanged. Ask before permissions, login/security steps, downloads, installation, GUI launches, or state changes.

您也可以通过已安装的 CLI 生成相同的提示词：

ml-cli install-prompt

Agent Guide 命令

安装后，AI Agent 应读取内置指南：

ml-cli agent-guide

该指南会告诉 Agent：

  • 何时使用 ml-cli
  • 如何发现命令格式
  • 如何将自然语言映射到命令
  • 何时需要确认
  • 如何处理本地沙箱错误，例如 connect EPERM 127.0.0.1:40000

Doctor 命令

使用 doctor 验证本地 API 连通性：

ml-cli doctor
ml-cli doctor --output-json

doctor 会检查端口发现，并调用 MoreLogin 本地状态接口。

浏览器环境便捷命令

当用户通过名称引用浏览器环境时，使用以下命令：

ml-cli env find --name P-1
ml-cli env find --keyword Amazon
ml-cli env open --name P-1
ml-cli env open --keyword "team-a"
ml-cli env open --name P-1 --exact

env find --keyword 通过 MoreLogin 本地 API 搜索环境名称、分组名、标签名和备注。 env open 仅在恰好匹配一个候选项时才启动环境。如果匹配到多个，将打印候选列表并退出，不启动任何环境。

云手机便捷命令

当用户通过名称引用云手机时，使用以下命令：

ml-cli cloudphone find --name CP-1
ml-cli cloudphone find --keyword "android-test"
ml-cli --timeout 120 cloudphone open --name CP-1
ml-cli --timeout 120 cloudphone open --keyword "android-test"
ml-cli --timeout 120 cloudphone open --name CP-1 --headless false
ml-cli --timeout 30 cloudphone close --name CP-1
ml-cli --timeout 30 cloudphone close --keyword "android-test"
ml-cli --timeout 120 cloudphone open --name CP-1 --exact

cloudphone find --keyword 通过 MoreLogin 本地 API 搜索云手机名称、分组名、标签名和备注。 cloudphone open 和 cloudphone close 仅在恰好匹配一个候选项时才操作。如果匹配到多个，将打印候选列表并退出，不改变任何状态。 对于 --headless，false 显示云手机窗口，true 不显示。API 默认值为 true。

自然语言示例

设置完成后，您可以这样说：

MoreLogin 第一页有多少个浏览器环境？
显示 MoreLogin 浏览器环境第一页，包含环境名称、ID 和状态。
打开 P-1 环境。
检查 P-1 环境是否正在运行。
关闭 P-1 环境。
查找名称包含 Amazon 的浏览器环境。
查找环境名称、分组名、标签名或备注包含 Amazon 的浏览器环境。
打开分组或标签包含 Amazon 的浏览器环境。如果有多个，先显示候选列表。
启动第一个浏览器环境，并告诉我调试端口。
显示所有 MoreLogin 分组。
显示所有 MoreLogin 标签。
显示代理记录第一页。
显示云手机列表。
打开 CP-1 云手机。
查找分组、标签或备注包含 Android 的云手机。
打开名称、分组、标签或备注包含 CP-204 的云手机，并显示窗口。
关闭 CP-1 云手机。
阅读 ml-cli 帮助，总结常用浏览器环境命令。

Commands