Myna Recorder 用户手册

入门

Myna Recorder — 本手册中称为“Recorder”，在磁盘上是 Recorder.exe — 是一款面向 Windows 10 和 11（64 位）的宏录制工具。它记录你的键盘和鼠标操作，让你把录制结果作为一段可读的脚本来编辑，并把它回放到任何应用程序中。在此下载。

激活

1. 创建账户，并确认你的邮箱。
2. 在 Recorder 中，用你的邮箱和密码在右上角登录。登录后，顶栏会显示你的套餐和 AI 积分余额。

Recorder 会保持登录状态，断网时也照常工作。退出登录会释放这台电脑上的席位，供另一台机器使用。

你的第一个宏

按开始录制（F2），手动把任务做一遍，按停止录制（F3），然后按开始回放（F4）重放一遍，用停止回放（F6）可以提前结束运行。完整的快捷键表见回放。

本手册提到某个键时，指的都是默认设置。按键可以在设置 → 热键中更改。

宏会把真实的输入发送给当前最前面的窗口。开始之前先记住你的停止回放键；即使 Recorder 不是活动窗口，它也依然有效。

主窗口

六个视图。其中四个编辑同一个项目；智能体替你完成任务，连点器替你点击。

并排会同时显示步骤列表和脚本。变量按钮会打开一个面板，在运行时实时显示每个变量。

文件

• .recproj——一个项目：宏、它的裁剪图和它的设置都在一个文件里。平时保存的就是它。
• .recscript——单独的一段脚本，以文本形式保存。

正在编辑的宏会自动保存，包括“脚本”选项卡中尚未应用的文本。

录制

开始录制开始，停止录制结束（默认是 F2 和 F3）。录制是全局的：它会记录你在任何应用程序里的操作，并保留原本的时间间隔。

设置 → 录制决定录制哪些内容：键盘、鼠标点击、鼠标移动、鼠标滚轮。不录制鼠标移动时，宏会短得多，而且直接点到每个目标上；只有在绘图或需要鼠标悬停时才录制移动。

录制下来的坐标是绝对的屏幕像素。移动窗口、改变分辨率，或者在另一台机器上回放，录下的点击就会落到错误的地方。解决办法是图像锚点。

使用所有显示器会把捕获范围扩展到每一块屏幕。单屏电脑请保持关闭。

回放

这七个都是全局热键，而且 Recorder 占用的按键会被拦截：其他应用程序完全看不到它。可以在设置 → 热键中更改或禁用。

停止回放是中断正在运行的宏的唯一全局方式。请一直保留它的绑定；运行时隐藏窗口和智能体在没有它的情况下都会拒绝启动。

速度与重复

回放速度可以从 0.25× 到 10×。速度缩放的是录下来的等待时间，而不是你自己写的 sleep() 调用，它也不能让应用程序响应得更快。如果一个宏在 4× 下出错、在 1× 下正常，就用 wait_for() 取代那段计时。

重复会把宏运行指定的次数；0 表示“直到停止”。若要在一次运行内部循环，请使用循环块。

测试运行

“录制”选项卡中的测试只回放选中的行。“脚本”选项卡中的测试所选内容会编译并运行选中的文本，包括尚未应用的修改。宏本身始终不受影响。

• 无论重复和速度设成什么，测试都只以 1× 速度运行一次。
• 只选中一半的循环会自动扩展到整个块；选中分节标题就代表它里面的全部内容。
• 测试前会先有一段倒计时（设置 → 录制 → 测试开始前的等待时间，0–30 秒，默认 3 秒）。按停止可以取消。

运行时隐藏窗口

设置 → 窗口 → 录制或回放时隐藏此窗口会在运行期间隐藏 Recorder，测试运行也一样。它需要先绑定停止回放快捷键。

编辑宏

分节

分节就是步骤列表里的章节标题。任务的每一个实际阶段用一个分节。

with section("Log in"):
    click_crop("Username")
    type_text("user")

with section("Export"):
    click_crop("Export")

分节不能嵌套，而且要从最左边开始。循环和条件可以放在分节里面，每一层缩进四个空格。

标签与跳转

在任何命令上加 label="name"，它就成为一个跳转目标；单独一行的 label("name") 是一个什么都不做、专供跳转的步骤；goto("name") 跳转到那里。

with section("Retry"):
    click_crop("Refresh", label="again")
    wait_for("Done", timeout_ms=20000, on_fail="again")
    label("done")

每一个 goto("x")、on_no="x"、on_fail="x" 以及 wait_any 的箭头 -> "x"，都需要有一个带 label="x" 的步骤，否则回放会报错停止。标签必须唯一。

函数：参见脚本参考。

图像与裁剪图

裁剪图是屏幕上某样东西的、带名字的图片：一个按钮、一个图标、一个标题。Recorder 会在回放时找到它，并在它此刻所在的位置上操作，所以窗口挪了、分辨率变了，或者换一台机器，宏都还能用。

在图片视图里截取一张，给它起个名字，然后用这个名字：

wait_for("Save dialog", timeout_ms=10000, abort=True)
click_crop("Save button")

裁剪要紧凑。裁剪图只应包含有辨识度的部分，别的都不要；里面带上背景的话，背景一变匹配就会失败。

读取屏幕文字

read_text 把屏幕上某个区域的文字读进一个变量。用方法清理读回来的内容，再把它用在条件、运算里，或者作为 ${name} 放进任何文本参数中。

total = read_text(region=(820, 400, 180, 40), single_line=True)
message_box("The order total was ${total}")

一定要传入 region。读取整个桌面时，图像会被缩小，直到普通的界面文字无法辨认。

三个读取器

引擎是按步骤选择的。engine="ai" 只做转写；如果要对屏幕内容进行推理，请使用 ask_ai。

清理读回来的内容

total = read_text(region=(820, 400, 180, 40)).to_number()
if total < 1000:
    notify("Total looks low: ${total}")

这些方法列在清理读取到的内容一节。空白区域会存入 ""，运行照常继续。single_line=True 会把结果合并成一行。

询问 AI

ask_ai 把关于屏幕某部分的问题交给视觉模型，并保存回答：“有多少行是红色的？”、“是否有错误对话框？”。

n = ask_ai("how many error icons are visible", role="count", region=(0, 0, 800, 600))
if n:
    click(n.1.x, n.1.y)

每次调用都会消耗积分，并且会阻止导出；参见积分。一次运行最多可以进行 60 次 AI 调用。

三种角色

选择模型

model= 接受一个简短的名字。按你这一步所读取区域计价的实时列表，就在设置表单里（在脚本选项卡中双击 ask_ai 调用即可打开）。推荐的做法是使用默认模型和它默认的推理级别：调用中不写 model= 和 reasoning=，交给服务器自行选择，目前是 glm。这张表是给你在有理由需要不同选择时用的；最贵的模型并不是对每个问题都最准确，而最便宜的 gemma，在一张小裁剪图上实测反而是最准确的。

务必给它一个 region=。模型可以数清楚整个桌面上的东西，却未必能定位出它们的位置；如果宏需要点击，就需要一张小图片。这一点对 read_text 和 AI 监视行同样适用。

脚本参考

这套脚本语言看起来像 Python，只保留了其中很小的一部分：变量、算术运算、if/else、while 和 repeat 循环、命令调用和 def 函数、四个空格的缩进、# 注释。代码块可以嵌套；只有分节必须靠在最左边。没有列表，不能用 + 拼接字符串，也没有导入语句。

完整的参考 — 每一条命令、它接受的每一个参数、按键名称，以及每条命令的实际示例 — 就在应用程序内部，紧挨着你编写脚本的编辑器。在脚本选项卡中打开命令列表，右键点击任意命令即可查看它的说明页；选中一条命令，按下插入，就会在光标处插入一条有效的调用。双击某条调用可以打开它的设置表单，里面列出了该命令接受的每一个选项。

带名字的参数也可以按顺序省略名字来传入：press("a", 0.5) 就等同于 press("a", hold=0.5)。每条命令还都接受 label="name"。

监视

一条监视行就是一个看门狗：它会在宏运行期间盯着屏幕，或者在你单独按下开始监视之后持续监视，留意可能发生的情况：崩溃对话框、会话过期提示、缺货警告。wait_for 只监视你放置它的那个位置；监视行则全程监视。

该行监视什么

监视方式可以二选一：要查找的图片，或者要提出的问题。

何时触发

行内其余设置

触发后的动作

弹窗、Telegram、Discord，并附带一张截图。行上的标签用于选择要使用的渠道；凭据由设置提供。停止宏会同时停止宏运行和停止监视。分析行在每次检查时都会触发，因此无法停止宏。

行的设置里还保存着消息之间的静默期，这与检查频率是分开的。设置 → 通知也可以在监视开启期间，定时发送一张屏幕截图。

导出

导出按钮会带上每一条已开启且设置了图片的监视行，包括它的裁剪图和它的设置。导出的程序会在每次运行时启动它们，并在运行结束时停止它们，和这里的运行完全一样。向 AI 提问的行会在导出时被按名字拒绝；请先把它们关闭。它们的 Telegram 或 Discord 提醒能否送达，取决于导出时对凭据的那个询问。

自动连点器

连点器选项卡会不停地点击，或者不停地按某个键，直到你让它停下来：在光标所在位置、在一个固定点，或者按你录制的一串点位依次点击。它不是宏 — 什么都不会写进项目里 — 但这个选项卡上的一切设置都会被记住，供下次使用。

三种模式

各项设置

录制点位序列

在点位序列模式下，按下录制点位，然后依次在程序本身里逐一左键点击每一个位置。你点一下，就会多出一行，边点边看得见。按下停止键的那一次点击 — 以及在 Recorder 窗口上的任何其他点击 — 都不计入其中。之后，每一行都有自己的等待时间、按键和点击类型，选取可以在冻结的画面上移动某一个点位。

停止方式

• 停止按钮、停止自动连点器键、停止回放键，或者在 Recorder 处于前台时按 Esc。
• 按住模式：只有按住启动键时才会点击，并且这个按键依然会传递给指针下方的那个程序。
• 光标碰到屏幕顶部时停止：把鼠标推到屏幕顶边就会停止，在任何模式下都是如此 — 这是一种不需要用到键盘的退出方式。
• 手动移动鼠标时停止：一旦指针出现在连点器没有把它放到的位置，就会停止。

启动按钮会先等一小会儿，好让鼠标能离开这个窗口；热键则会立刻启动。

各套餐包含的内容

连点器本身是每个套餐都有的：以精确的频率点击一次或按一个键，位置在光标处或一个固定点，并带有次数、时限和各种停止方式。Basic 和 Pro 还增加了拟人化（光标会移动到每次点击的位置，按住时长也会变化）、两种抖动、散布、点位序列和游走框。在 Free 套餐下，这些控件会显示为灰色并带一个锁形图标；你在有对应套餐时设置的内容，会被保留到下次套餐重新覆盖它的时候。

拟人化动作的作用，是让一次运行的表现更接近一只手在操作普通应用程序里的鼠标。Recorder 不会做任何事情，让自己对任何程序隐身。

导出为程序

文件 → 导出为程序…会生成一个单独的 .exe，其中包含这个宏、它用到的裁剪图，以及调校时所用的文字读取器。它不需要安装程序、不需要运行库，也不需要一份 Recorder。

• 导出对话框提供一个控制窗口：运行、暂停和停止及其对应的热键，重复和速度，还有一行状态信息。不勾选的话，程序一打开就会运行，不显示任何界面，宏结束就关闭—这适合由计划任务启动的程序，但不适合第一次尝试。凡是要手动启动的，都勾选这个窗口：这样出问题时会用消息显示出来，而不是悄无声息地过去。
• 你的运行、暂停和停止热键，会按导出时在“设置 → 热键”中绑定的样子一起带走，已开启的监视行和按键连发设置也一样。
• 用到 AI 的宏（ask_ai，或者 read_text 搭配 engine="ai"）会在导出时被拒绝，并指出具体是哪些步骤。两种本地文字读取器则会内置到文件中。
• 如果宏或某条监视行会发送到 Telegram 或 Discord，并且已经配置好，Recorder 会询问是否包含这些凭据；拿到文件的任何人都能读到它们。不包含的话，通知步骤和提醒就什么也不会发送。Telegram 和 Discord 需要 Basic 或 Pro 套餐：在 Free 套餐下不会询问这个问题，详细信息也不会被带上。

停止已导出的程序

你的停止回放键，按你导出时绑定的样子；如果没改过就是 F6。如果你把停止键关掉了，就会退回使用 F6，因为无法停止的宏是不会运行的。

如果这个键已经被另一个程序占用，程序会依次尝试加上 Ctrl+Shift，再加上 Ctrl+Alt，并在第一步之前说明用的是哪一个。如果都注册不了，宏就完全不会运行，并说明原因。

已导出的程序包含宏中的一切，包括你输入过的任何文字。发给别人之前，请检查其中有没有密码和令牌。这个文件没有代码签名，所以 SmartScreen 在第一次运行时可能会发出警告。

AI 助手

描述你想要的宏，助手就会写出脚本。在你批准之前，什么都不会进入你的编辑器：先看回复内容，再按“使用”或“替换”。每一条回复都会经过编译器检查；如果编译不通过，助手会自动尝试修复一次，这会消耗一个积分。

有两种模式。构建直接写出宏。规划会先问清楚这项任务，在你按下写出宏之前不会写任何内容；只要步骤稍微多一点，就从这里开始。Ctrl+Enter 发送；新建会开始一段新的对话，并删除保存的记录。

模型和推理：两者都保持为默认。中等和最高是不同的模型，而不是更好的模型；推理越多，每一轮的花费越高，却很少会改变脚本。使用恢复机制会让宏在某次点击未命中之后自己找回正轨，而不是直接停止；在单击后添加短暂等待会在每次点击之后短暂暂停，以免下一步跑到屏幕前面去。这两项通常都保持开启。

如何得到好的回答

• 先截好裁剪图。助手会被告知有哪些裁剪图的名字。如果一个都没有，它就只能写坐标。
• 说清楚屏幕看起来是什么样子，而不只是目标是什么。“点击全部刷新，等状态栏显示完成”比“刷新电子表格”更好。
• 在对话中继续调整。“改成等保存对话框出现，而不是用固定延时”是很常见的后续要求。

积分

只要请求会发到服务器，就会消耗积分：助手的每一轮对话（包括自动修复那一次）、ask_ai 步骤、AI 监视行、read_text 搭配 engine="ai"，以及智能体运行中的每一步。录制、回放、图像锚点、两种本地文字读取器和导出都不消耗积分。你的余额显示在登录状态旁边、助手面板中，以及账户页面上；每一次 AI 步骤都会把花费写进运行日志。套餐和积分包在价格页面上。

宏中的每一个 AI 步骤（ask_ai、read_text 搭配 engine="ai"、AI 监视行）都消耗积分、需要已登录的账户，并且会阻止导出。已导出的程序没有账户可以计费。

智能体

智能体选项卡是第三种视图。输入一个目标，AI 就会在你的桌面上一步步把它完成，每一步之后都会检查屏幕。这就是 computer use：在你自己的桌面上，用真实的鼠标和键盘操作。它最适合一块屏幕上短小、看得见结果的工作—打开一个页面、填一张表单、点过几个界面；耗时较长或不常见的工作，更适合录制成宏。头几次请在旁边看着它运行。

每一步都是一次 AI 调用，按和 ask_ai 一样的积分计费—包括那些没能跑完全程的运行中的步骤。智能体只能看到屏幕；屏幕上的文字永远不会被当成对它的指令。

它不是助手。助手会写出一个你可以保存和回放的宏；智能体则是当场把工作做完，不留下任何东西。

运行一项任务

1. 输入目标：打开下载文件夹并按日期排序。保存会把它存进已保存列表；删除会移除一条。
2. 按开始，或者 Ctrl+Enter。每次运行前，Recorder 都会问一次让智能体接管？，并重复一遍目标以及它可以使用哪些权限。如果没有绑定停止回放快捷键，它不会启动；参见回放。
3. 留意这条时间线。每一步都会显示智能体看到了什么、它对上一步的判断（是、否，还是不确定）、它现在在做什么，以及花费了多少。页脚会保留本次运行的总花费和你剩余的积分。
4. 随时都可以按停止，或者你的停止快捷键。

一次运行会以已完成、卡住或已停止结束，并给出花费的积分、执行的步数和原因：某一步失败了三次、跑了四十步还没完成、达到积分上限，或者你按了停止键。

如果任务是一个问题（告诉我这个账户用的是哪个套餐），答案会以报告的形式返回：一个消息框，或者设置 → 通知中开启的桌面、Telegram、Discord 中的一种。

选项

它可以做什么

勾选框下方那一行会说明智能体可以使用哪些权限：默认是鼠标、键盘、计时、启动和消息。权限会打开设置 → 智能体，其中每一项都在它可以下面以勾选框列出：

最后两项请保持关闭。命令行拥有和你一样的权限，能做你能做的任何事，而智能体分不清哪条命令是安全的、哪条是破坏性的。

停止条件用来设定上限：一次运行的步数、单个步骤失败的次数，以及每次运行的积分（0 表示不限）。节奏用来设定智能体等待画面稳定的时间、步骤之间的间隔，以及一个步骤内各个动作之间的间隔。如果某个应用程序跟不上“先点击、后输入”的速度，就把最后一项调大。

设置

点击菜单栏中的设置。共有七个选项卡：热键、录制、键盘、窗口、通知、日志，以及智能体。确定会应用更改，取消会放弃更改，恢复默认设置会重置除 Telegram 和 Discord 凭据之外的一切。

热键

这七个全局热键都是默认设置，不是固定不变的。每一个都可以在这里重新分配或禁用，而且这个选项卡是唯一能看到当前设置的地方。点击一个字段，然后按下组合键；按 Esc 可以清空它。两个操作不能共用同一个键，如果某个键已经被另一个程序占用，Recorder 会发出警告。默认设置见回放。

录制与键盘

录制选项卡包含各项捕获开关和测试倒计时。键盘选项卡控制按住的键是否像真实键盘那样连发：默认关闭，可以设置延迟、速率、可选的随机波动，还有与本机一致可以直接套用你的 Windows 设置。这项设置会随已导出的程序一起带走。

窗口

运行时隐藏窗口、使用所有显示器、深色主题，以及从 85% 到 140% 的文字大小。后两项会立即生效。

通知

默认关闭。开启之后，Recorder 可以在录制完成、回放完成，以及回放中止时通知你，方式是桌面通知、Discord、Telegram，或者任意组合。桌面通知每个套餐都有；Telegram 和 Discord 需要 Basic 或 Pro 套餐。在 Free 套餐下，这两个选项呈灰色，下方会说明原因，你填入的令牌或 webhook 网址会先保存下来，等套餐支持了再启用。监视使用同样的渠道，并按行单独开关。图像质量用来设置随附截图的大小，从“很低”到“无损”。

Discord

只有一项：webhook 网址。

1. 先在 Discord 里创建一个 webhook。打开 Server Settings → Integrations → Webhooks，选择New Webhook，选好频道，起个名字，然后按Copy Webhook URL。你需要有 Manage Webhooks 权限。
2. 粘贴到 Recorder 中。打开设置 → 通知，勾选Discord，粘贴这个网址。
3. 发送一条测试消息。几秒钟内，频道里就应该会出现一条消息。

webhook 网址等同于密码。任何拿到它的人都能往那个频道里发消息。如果泄露了，就在 Discord 中删除这个 webhook 并新建一个；导出用到它的程序时会先询问。

Telegram

你需要从 BotFather 那里获取一个机器人令牌，以及这个对话的数字聊天 ID。两者都填在设置 → 通知中。

定时截图

监视时发送屏幕截图会每隔 N 秒向 Telegram 和 Discord 发送一次截图，范围是你选定的区域或整个屏幕。它只在开始监视开启时运行，并且永远不会用桌面气泡通知。

会发送什么

消息会直接从你的电脑发往 Discord 或 Telegram，绝不会经过我们的服务器。

诊断日志

视图 → 日志显示运行过程中的动作，设置 → 日志选择要记录哪些内容。宏出问题时，先开启每一步。文字内容会把从屏幕上读取到的字符以明文形式记录下来；找到问题之后，请把它重新关掉。

你的许可证

同一时间只能用在一台电脑上

要换到另一台机器，先在旧机器上退出登录，再在新机器上登录。如果旧电脑已经不在了，也照样在新电脑上登录：旧机器30 天没有联系过之后，新机器就会接替它的席位。

离线工作

掉线不会中断运行；状态栏会显示“已登录（离线工作中）”，Recorder 会继续工作。只有离线时间很长之后，它才会停止。

你的套餐未包含的功能

有六项功能是按套餐区分的：AI 功能、从屏幕读取文字、屏幕监视、导出为程序、Telegram 和 Discord 提醒，以及自动连点器的进阶选项（拟人化点击、抖动、散布、点位序列和游走框）。套餐未包含的控件会变成红色，点击它会说明原因；两个通知选项和连点器的进阶控件会显示为灰色并带一个锁形图标，旁边注明原因。

更改会在大约半小时内生效。账户对话框会显示你的套餐和积分余额。

疑难解答