Skip to main content

使用 AScript AI Studio

本文带你完成一次完整流程：登录工作站、创建工程、让 AI 编写脚本、连接手机、同步运行，并检查 Token 用量。

1. 登录工作站​

打开 ai.ascript.cn。工作站使用 AScript 统一账号登录。

当前工作站面向已开通 VIP 的账号开放。登录后如果账号没有工作站权限，页面会提示开通会员；铜卡、银卡、金卡和铂金卡都支持访问。

登录过程中，原始登录 Token 只用于换取会话，不会长期保存在浏览器存储中。不要把登录链接或 Token 转发给其他人。

2. 创建或导入工程​

新建工程​

  1. 点击左侧 新建工程。
  2. 选择 Android 或 iOS。
  3. 输入工程名称，例如“电商签到”。
  4. 点击 创建工程。

工作站会生成对应平台的基础工程，通常包含 __init__.py、启动文件和 res 资源目录。

导入已有工程​

  1. 点击左侧 上传工程。
  2. 选择 .zip 或 .ias 工程文件。
  3. 确认工程名称和平台。
  4. 等待工程文件树加载完成。

导入限制：压缩包不超过 100 MB，解压后不超过 250 MB，最多 5,000 个文件。工程根目录必须包含 __init__.py。不要上传包含路径穿越、符号链接或不明可执行文件的压缩包。

3. 浏览和编辑文件​

在左侧工程文件树中选择文件，文件会在编辑器标签中打开。

  • .py 文件使用 Monaco 编辑器打开，并提供 Python/AScript 补全和诊断；
  • 图片等资源可以在工作区中预览；
  • 文件修改后会显示未保存状态；
  • 点击 保存 或使用 Ctrl/Cmd + S 保存；
  • 文件被其他 AI 任务或页面修改时，工作站会提示保存冲突，不会静默覆盖；
  • 多个文件可以同时打开，关闭未保存标签时会先确认。

先保存手动编辑，再让 AI 修改同一个文件，可以减少冲突。

4. 用自然语言描述需求​

在右侧对话框输入需求。描述越具体，AI 越容易一次完成。建议包含以下信息：

  • 要自动化的目标和业务流程；
  • 目标 App、页面入口和关键操作；
  • 成功标准和失败时的处理方式；
  • 是否需要连接真机验证；
  • 只允许修改哪些文件或函数。

例如：

请在当前 Android 工程中实现某东商城每日签到。先检查现有文件，优先复用已有的页面定位工具；如果找不到签到入口，记录清晰日志并停止，不要修改 res 目录。

如果是排查问题，可以直接附上现象和日志：

运行到提交订单页面时偶发找不到按钮。请检查定位逻辑、等待时间和异常处理，只修改负责提交订单的函数，并说明修改原因。

AI 会在工程上下文中阅读相关文件。任务执行期间，编辑器会暂时进入“AI 正在接管编辑”状态，任务完成或停止后即可继续手动编辑。

5. 选择模型和推理强度​

发送按钮附近的设置菜单可以查看当前模型和推理强度。推理强度支持轻度、中、高、极高四档。

  • 简单改名、补充函数时可以使用轻度或中；
  • 涉及多文件分析、复杂 Bug 或真机验证时，建议使用高或极高；
  • 推理强度越高，通常需要更多时间和 Token。

实际可用模型和默认档位由工作站服务端配置，以页面显示为准。

6. 连接 Android / iOS 手机​

真机连接不是开始源码开发的前置条件，但它能让 AI 读取实时界面并验证脚本。

手机端准备​

  1. 安装对应平台的 AScript Android App 或 AScript iOS App。
  2. 打开 AScript App 首页的 AI 编程。
  3. 保持手机网络可用，并停留在等待配对的页面。

工作站配对​

  1. 在工作站中选择 Android 或 iOS 工程。
  2. 点击编辑器顶部的 连接设备，或在对话框底部点击 连接调试设备。
  3. 点击 生成配对码，得到一个临时的 6 位数字。
  4. 在手机 AScript App 的“AI 编程”页面输入配对码并确认。
  5. 返回工作站，看到设备名称和工程名称后，表示连接成功。

配对码临时有效。不要把配对码发给不相关的人，也不要将同一台手机同时绑定到不相关的工程。

7. 同步、运行和查看日志​

设备连接成功后，可以在编辑器工具栏中完成以下操作：

  1. 保存当前文件。
  2. 点击 运行，工作站会先保存并增量同步发生变化的文件。
  3. 查看底部 运行日志，确认脚本启动、页面定位和异常信息。
  4. 需要终止时点击 停止，向设备发送停止指令。

同步只传输变化的文件。同步失败时，先检查手机连接和工程启动错误，再重新同步。

8. 使用设备工具辅助 AI​

连接设备后，工具栏会开放与当前平台匹配的设备能力：

  • APP 控件检索：查看当前页面的控件树、文本和层级信息；
  • 图色检索：查看截图、颜色和图像定位结果；
  • OCR：识别屏幕中的文字；
  • 运行日志：查看实时输出和错误；
  • UI 生成器、插件中心和导包工具：按平台和账号权限显示可用功能。

你也可以直接在对话中告诉 AI：

请先查看当前屏幕和控件树，找到“签到”按钮，再修改签到函数并在真机上运行验证。

手机未连接时，AI 可以继续分析源码和 AScript API，但不会把静态推断描述成已经在真机上验证。

9. 检查 AI 修改并撤销​

AI 任务完成后，工作站会显示本轮修改的文件、增加行数和删除行数。

建议按以下顺序检查：

  1. 打开修改过的文件，确认关键逻辑；
  2. 查看 AI 回复中的修改说明和验证结果；
  3. 连接设备后运行一次，查看日志；
  4. 确认无误后继续下一轮需求。

如果本轮修改不合适，可以点击 撤销本次修改。撤销只针对最近一轮 AI 修改，并且要求工程文件仍保持该轮完成时的状态。如果你已经手动编辑或又执行了新的 AI 任务，工作站会拒绝覆盖，避免误删新内容。

10. 后台任务和重新打开​

AI 任务在云端执行。发送任务后，即使刷新页面、关闭浏览器或暂时离开电脑，任务也可能继续运行。

重新打开 ai.ascript.cn 并登录后，工作站会尝试恢复正在执行或刚完成的任务。恢复后可以继续查看 AI 回复、文件变化和撤销入口。

长任务建议提前写好验收标准，例如“只修改登录函数、完成后列出修改文件、不要删除现有日志”。

11. 查看 Token 和账户用量​

点击账户菜单中的 钱包、数据看板或使用日志，可以查看：

  • 当前余额和账号会员状态；
  • 充值、消耗和签到记录；
  • 调用次数、消费金额和 Token 总量；
  • 输入 Token、缓存读取、缓存写入和输出 Token；
  • 每个工程、会话和模型的任务明细；
  • 首段响应时间、总耗时和任务状态。

工作站按实际用量扣费，Token 用多少付多少。会员提供工作站访问权限，Token 消耗仍以账户中心实际记录为准；每日签到奖励也以账户页面显示为准。

常见问题​

没有看到创建工程按钮​

请先确认已经登录，并检查账号是否开通任意档位 VIP。工作站目前对未登录或没有访问权限的账号锁定工程操作。

AI 说无法验证手机​

检查工程是否为 Android/iOS、手机 AScript App 是否打开“AI 编程”、配对码是否过期，以及工作站中显示的工程是否与手机端一致。没有设备时可以选择继续离线分析。

保存时提示冲突​

说明当前文件已经被其他页面或 AI 任务修改。先刷新文件内容，确认要保留的版本，再继续编辑或重新发送需求，不要强行覆盖。

运行日志没有内容​

确认设备仍然连接、工程是否已经同步、脚本是否成功启动。可以先停止运行，再保存、增量同步后重新运行。

为什么 Token 消耗比预期多​

工程上下文、历史对话、附件和较高推理强度都会增加输入或输出用量。可以缩短无关历史、明确修改范围、拆分大任务，并在发送前查看当前推理档位。

可以完全替代 Cursor / VS Code 吗​

如果你希望零配置并直接连接真机，AScript AI Studio 更合适；如果你需要本地依赖、终端和自定义插件，仍可以使用 Cursor / VS Code。两种方式可以配合使用。