跳到主要内容

使用 AI 助手编写脚本

编辑器 AI 助手​

本页主要说明 脚本编辑器内的助手。2.3.9 起,独立 AI 工作台与 MCP 也支持编写、检查和按权限试跑脚本动作,见编写、搜索与管理动作。两种入口的保存和运行范围不同,不要把工作台的试跑能力套用到编辑器内助手。

脚本编辑器标题栏有一个魔法棒按钮(Ctrl+J 开关),打开右侧的 AI 助手面板:

  • 用自然语言描述需求,AI 会直接修改编辑器里的源码,也可以顺手填写标题与说明;
  • 运行失败或检查有问题时,“结果”页、状态栏或“问题”页会出现“让 AI 修复”入口,AI 会结合运行记录和诊断信息分析;
  • 可以选中一段代码“引用给 AI”,让它只改这部分;
  • 每轮修改后会显示改动摘要,可“撤销本轮”,也可用 Ctrl+Z 撤销;
  • AI 助手只修改代码,不会替你运行脚本。 运行与保存始终由你自己决定;
  • 2.3.23 起不再提供按旧能力扫描生成的风险差异提醒;运行前仍需自行检查代码。

AI 助手需要先保存动作(有动作 Id)才能使用。2.3.23 起,AI 写好的脚本与其他来源脚本一样,运行前不再逐项确认能力,请在运行前读一遍代码,尤其是涉及文件删除、网络上传、键盘监听的部分。详见 安全与授权。

引用错误与运行分析​

以下入口从 2.3.3 起可用。

根据是否已经运行过脚本,选择合适的排查入口:

  • 引用错误:在“问题”页选择一条诊断,点击 引用给 AI,将相关代码行和错误说明加入助手;没有行号时,错误会放入输入框。补充你的问题后再发送,也可用 复制错误 将诊断交给其他人排查。引用本身不会发送请求或运行脚本。
  • 分析已有运行:用 让 AI 分析 / 修复 查看最近一次运行记录,不会重新运行脚本。适合已经失败、希望先解释原因的情况。
  • 重新运行并分析:在助手中点击 运行并分析,按编辑器当前的运行方式真实运行当前脚本,记录本次 qk 调用,结束后交给 AI 分析异常和结果偏差。这是由你点击发起的运行,执行前仍应检查代码;该入口不会进入断点调试。

AI 不会自行决定运行脚本。分析后若修改了源码,仍由你检查、保存和决定是否再次运行;只读、正在保存、AI 正在处理或运行前检查未通过时,新的运行不能开始。

2.3.4 · 收起最近运行卡片​

以下调整从 2.3.4 起可用。

助手中的最近运行卡片可以用关闭按钮收起,运行记录仍保留,不会因此停止运行或删除结果。继续编辑源码时,同一份记录保持收起;下一次产生新的运行记录时,卡片会重新显示。关闭卡片不代表错误已经修复,需要时仍可从结果和诊断入口继续排查。

历史会话​

2.3.2 起,点击 历史会话 可查看当前脚本动作的旧对话,载入后继续聊天,也可改名、归档、恢复或永久删除。对话与模型上下文保存在当前账号本机数据中,重启后可以续聊;旧版进程内的临时对话不会自动变成可恢复历史。

切换历史会话只改变对话,不会恢复当时的源码。每轮发送仍使用编辑器当前内容;需要回退源码时,请用撤销或 保存版本。助手运行时不能切换会话。归档当前会话后进入新对话;“删除全部”包含当前动作的已归档会话,永久删除后无法恢复。

怎样描述需求​

给出输入、希望的输出、实际使用程序和失败时的处理。例如:“读取剪贴板文本,去掉首尾空白;没有文本时只通知;把结果写回并返回,不访问网络。”

已有源码时先选中需要修改的部分,再引用给 AI;运行失败时从结果或问题页使用“让 AI 修复”,让它结合诊断记录分析。

一轮修改后的检查​

先读修改内容,尤其检查新增的文件、网络、程序启动和键盘监听能力;再检查源码,并在测试数据上运行。大改前使用保存版本。AI 修改源码不等于替你确认了外部操作的后果。

先确认需求再修改​

以下变化从 2.3.1 起可用。

新建脚本或为脚本新增行为时,助手会先通过作答区确认输入、处理方式、输出及副作用;有多种合理理解时,会给出具体问题。请检查并提交答案后再让它修改。已经确认的要求不需要重复确认;修复报错、调整已有逻辑、参数值或标题说明时,可直接修改。

助手写入源码时会同时检查新草稿;检查通过后可直接以改动摘要结束这一轮。这里的写入是更新正在打开的编辑器,不等于替你保存正式动作或运行脚本。仍应检查差异、诊断和新增能力,再自行保存、试运行。

参考图片、文件与窗口​

脚本助手输入区开放附件,可选择或拖入文件、粘贴图片,也可从附件菜单截图或选择目标窗口。选择窗口通常会加入窗口信息文本与截图两个附件;发送前可分别删除。图片理解需要支持图片的模型,附件上限和发送范围见AI 附件说明。这部分同样需要 2.3.1 或更高版本。

例如要操作某个软件时,先选择该软件窗口,再说明目标控件、要处理的数据和期望结果。提供截图不意味着允许助手运行脚本,也不保证生成的定位方式适用于所有窗口状态。

2.3.4 · 提示词加载方式​

打开脚本助手输入区的「模型 · 推理档位」菜单,在「提示词加载方式」中选择:

  • 完整:默认方式,提供完整的脚本 API 编写说明。
  • 按需加载(实验):按当前任务加载需要的 API 说明,减少一次提供的说明量;复杂任务可能需要继续加载更多内容,应检查最终代码和诊断结果。

选择仅保存在本机,不同步到其他设备。方式在对话首次运行时固定;切换设置供尚未开始的新会话使用,已开始的对话及恢复的历史继续使用原方式。想比较两种方式时,请切换后新建对话,再用同一需求检查结果。这里不会改变脚本运行与保存仍由本人决定的规则。