在 Trae 中使用 AI 编程

兼容性提示

经实测，Trae 与 AScript MCP 服务的兼容性不佳，AI 工具调用成功率较低，可能出现跳过工具调用、直接生成代码等情况，需要反复手动提示。建议优先使用 Cursor 以获得更稳定的体验。

以下配置方法仅供参考。

Trae 是字节跳动推出的 AI 原生 IDE，完全免费。

配置完成后，你可以直接在对话框中说：

"帮我写一个 Android 自动点击屏幕中间的脚本"

AI 会自动查询 AScript 文档，生成可运行的代码。

---

第一步：添加 AScript AI 服务

1. 打开 Trae，点击左侧菜单 MCP（或在设置中搜索 MCP）
2. 点击 「添加 MCP 服务器」
3. 将以下配置粘贴进去，保存

{
  "mcpServers": {
    "ascript": {
      "url": "http://mcp.ascript.cn/sse"
    }
  }
}

---

第二步：添加项目规则

在项目根目录创建文件 .trae/rules/project.md，内容如下：

你是 ascript 自动化开发助手。

禁止假设！禁止猜测！你不知道 ascript 的 API，不知道界面上有什么控件，不知道按钮在哪个坐标。一切数据必须通过 MCP 工具从真实设备获取。

编写自动化代码的唯一正确流程：
1. 先用 auto_connect 或 connect_device 连接设备
2. 用 observe_device 或 screen_capture + dump_ui_tree 查看真实界面，获取控件树和控件属性（text、id、className 等）
3. 用 search_api 或 get_module_apis 查询 ascript API 的正确调用方式
4. 编写代码时，必须优先使用控件选择器（如通过 text、id、className 等属性定位控件并操作）。只有当目标元素确实没有任何可用的控件属性时，才可以使用坐标作为兜底方案
5. 用 deploy_and_run 发送到设备运行，查看日志和截图验证
6. 有报错就改代码重新 deploy_and_run，直到跑通

控件优先原则：
- dump_ui_tree 返回的控件树中，大部分元素都有 text、id、className 等属性
- 写代码时必须优先用这些属性通过控件 API 来查找和操作元素（如点击、输入等）
- 坐标点击只在控件没有任何可识别属性时才使用，且必须在代码中注释说明为什么不能用控件
- 绝对不要在有控件属性可用的情况下使用坐标

严格禁止：
- 禁止写"假设按钮在xxx位置"等猜测性代码
- 禁止编造 API（如 ascript.device 等不存在的接口）
- 禁止不查询文档就写 ascript 代码
- 禁止不看设备界面就写坐标和选择器
- 禁止在有控件属性（text/id/className）的情况下用坐标点击
- Android/iOS 禁止本地执行，禁止 pip install ascript，只能通过 MCP 工具发到设备运行
- Windows 代码可以在本地直接运行

---

第三步：开始 AI 编程

在 Trae 的对话框（Builder 模式）中直接描述需求即可，例如：

• 帮我写一个 Android 自动点击坐标 (500, 800) 的脚本
• 写一个 iOS 自动滑动屏幕的脚本
• 帮我查找屏幕上的蓝色按钮并点击

AI 会自动调用 AScript 文档，按规范生成代码。

---

tip

如果 AI 没有自动查询 API 就开始写代码，可以提示它：「请先查询 AScript API 文档再写代码」