任务脚本编辑器使用指南

编辑器界面概览

LinkAndroid 的任务编辑器是一个功能完整的 Python 集成开发环境，包含以下主要区域：

• 代码编辑区：编写和编辑 Python 脚本，支持语法高亮
• 运行日志面板：实时显示脚本执行输出的日志信息
• 设备预览面板：查看设备屏幕截图和 UI 控件层级
• AI 聊天面板（PRO 版）：通过对话让 AI 生成或修改脚本
• 文档面板：内置 la 库完整 API 参考文档

代码编辑区

编辑区提供完整的代码编辑体验：

• Python 语法高亮：关键字、字符串、注释等使用不同颜色区分
• 自动缩进：按照 Python 规范自动处理缩进
• 行号显示：方便定位代码行

设备预览面板

设备预览面板是编写 UI 自动化脚本的利器，让您直观地查看设备界面并获取控件信息。

屏幕预览

实时显示设备的当前屏幕截图，点击预览图中的任意位置，可以快速生成点击坐标代码。

控件树

显示当前屏幕的 UI 控件层级结构（XML 布局），您可以：

• 展开/折叠控件树节点
• 查看每个控件的属性（class、text、resource-id、bounds 等）
• 在预览图中高亮对应的控件位置
• 快速复制控件的定位代码

# 设备预览面板生成的示例代码
# 点击"设置"按钮
device.click(540, 1200)

# 使用控件文本查找并点击
device.click("设置")

# 使用 resource-id 定位
device(resourceId="com.android.settings:id/title").click()

运行日志面板

运行日志面板展示脚本执行过程中的输出信息：

• 实时显示 print() 输出和 la.log() 日志
• 错误信息用红色高亮显示
• 支持日志级别过滤
• 运行完成后可保存日志到文件

文档面板

文档面板内置了 la 库的完整 API 参考文档（Manual.md），包含所有接口的详细说明和示例代码，无需离开编辑器即可查阅。

AI 辅助编程（PRO 版）

PRO 用户可以使用 AI 聊天面板，通过自然语言描述需求来生成或修改脚本。

示例：

"帮我写一个脚本，打开微信，找到名为'张三'的联系人，发送消息'早上好'"

AI 会自动分析设备当前界面，生成对应的 Python 代码，并支持一键应用到编辑器中。

快捷键