このページは便宜のために英語から翻訳したものです。英語の原文が最も正確な版であり、両者が異なる場合は英語の原文が優先されます。

Myna Recorder ユーザー マニュアル

Recorder でできることすべてを網羅。各コマンドの正確な構文は、アプリ内のエディターの横に用意されています。

2026年9月15日更新。

はじめに

Myna Recorder — このマニュアルでは “Recorder”、ディスク上では Recorder.exe — は、Windows 10 および 11 の 64 ビット版で動作するマクロ レコーダーです。キーボードとマウスの操作を記録し、その結果を読みやすいスクリプトとして編集し、任意のアプリケーションへ再生できます。こちらからダウンロード。

アクティベーション

  1. アカウントを作成し、メール アドレスを確認してください。
  2. Recorder の右上で、メール アドレスとパスワードを使ってサインインしてください。サインイン後は、バーにプランと AI クレジット残高が表示されます。

Recorder は接続が切れてもサインインしたまま動作を続けます。サインアウトすると、このコンピューターの利用枠が解放され、別のマシンで使えるようになります。

最初のマクロ

記録を開始(F2)を押して作業を手動で行い、記録を停止(F3)を押します。続いて 再生を開始(F4)で再生し、途中で終了するときは 再生を停止(F6)を押します。ショートカットの一覧は「再生」にあります。

このマニュアルでキー名を挙げている場合は、既定のキーを指します。キーの変更は「設定 → ホットキー」で行えます。

マクロは、そのとき手前にあるものへ実際の入力を送ります。開始前に 再生を停止 キーを確認してください。Recorder がアクティブなウィンドウでなくても機能します。

ウィンドウ

6 つのビューがあります。4 つは 1 つのプロジェクトを編集するもので、エージェントは代わりに作業を行い、クリッカーは代わりにクリックします。

ビュー用途
Recorderステップ一覧。1 アクションにつき 1 行で、ラベル、セクション、まとめられたマウス移動の連続を含みます。並べ替え、削除、タイミングの調整に向いています。
スクリプト同じマクロをテキストとして表示します。ループ、条件、細かい編集に向いています。コマンドをダブルクリックすると、その設定フォームが開きます。エディターの下にある 説明 はコードの横に平易な言葉の列を追加し、自動補完 は入力中に候補の名前を示し、構文チェック は入力中に問題を一覧表示します。
クリッカーオート クリッカーです。1 回のクリック、1 つのキー、またはポイントのシーケンスを、設定した速度で繰り返します — 詳しくは「オート クリッカー」をご覧ください。
エージェントやってほしいことを伝えると、AI が実際のマウスとキーボードを操作して 1 ステップずつ実行します — 詳しくは「エージェント」をご覧ください。
監視再生と並行して、または単独で動作する監視行です — 詳しくは「監視」をご覧ください。
画像このマクロが使う、名前付きの画面切り抜きです。ここで取得、再取得、名前の変更ができます。切り抜きは、このコンピューター上のすべてのマクロで共有されます。

左右に並べるを使うと、ステップ一覧とスクリプトを同時に表示できます。変数ボタンを押すと、実行中のすべての変数をリアルタイムで表示するドックが開きます。

ファイル

  • .recproj — プロジェクト。マクロ、切り抜き、設定を 1 つのファイルにまとめたものです。通常はこれを保存します。
  • .recscript — スクリプト単体をテキストとして保存したものです。

作業中のマクロは自動保存されます。未適用の「スクリプト」タブのテキストも含みます。

記録

記録を開始で記録が始まり、記録を停止で終わります(既定では F2 と F3)。記録はグローバルです。どのアプリケーションでの操作も、元のタイミングどおりに記録します。

設定 → 記録では、記録する内容(キーボード、マウス クリック、マウスの移動、マウス ホイール)を選べます。マウスの移動を記録しなければマクロはずっと短くなり、各ターゲットへ直接クリックします。移動を記録するのは、描画やホバーが必要な場合だけにしてください。

記録される座標は、画面上の絶対ピクセル位置です。ウィンドウを移動したり、解像度を変えたり、別のマシンで再生したりすると、記録したクリックは間違った場所に着地します。対処法は画像アンカーです。

すべてのモニターを使用をオンにすると、すべてのディスプレイにまたがって記録します。モニターが 1 台なら、オフのままにしてください。

再生

操作既定のキー
記録を開始F2
記録を停止F3
再生を開始F4
再生の一時停止 / 再開F5
再生を停止F6
オート クリッカーを開始F7
オート クリッカーを停止F8

7 つすべてがグローバルです。Recorder が保持しているキーは消費され、他のアプリケーションには渡りません。変更や無効化は「設定 → ホットキー」で行います。

再生を停止は、実行中のマクロを中断できる唯一のグローバルな方法です。必ず割り当てたままにしてください。これが割り当てられていないと、実行中に隠す機能やエージェントは開始を拒否します。

速度と繰り返し

再生は 0.25 倍から 10 倍の速度で行えます。速度は記録された待機時間を伸縮させるもので、自分で書いた sleep() 呼び出しには影響せず、アプリケーションの応答を速くすることもできません。マクロが 4 倍速では失敗し 1 倍速では動く場合は、そのタイミングを wait_for() に置き換えてください。

繰り返しは、マクロを指定した回数だけ実行します。0 は“停止するまで”を意味します。1 回の実行の中でループさせるには、ループ ブロックを使ってください。

テスト実行

「記録」タブの テストは、選択した行だけを再生します。「スクリプト」タブの 選択範囲をテストは、選択したテキストをコンパイルして再生し、未適用の編集内容も含みます。マクロ本体は変更されません。

  • テストは、「繰り返し」と「速度」の設定にかかわらず、常に1 回だけ、1 倍速で実行されます。
  • ループの一部だけを選択した場合は、ブロック全体に広げられます。セクションの見出しを選択した場合は、その中身すべてを選択したものとして扱われます。
  • 最初にカウントダウンが行われます(設定 → 記録 → テスト開始前の待機時間、0–30 秒、既定 3 秒)。停止を押すとキャンセルされます。

実行中に隠す

設定 → ウィンドウ → 記録中や再生中はこのウィンドウを隠すをオンにすると、テストを含め、実行中は Recorder が隠れます。再生を停止のショートカットが割り当てられている必要があります。

マクロの編集

セクション

セクションは、ステップ一覧における章の見出しです。タスクの実際の工程ごとに 1 つずつ使ってください。

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

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

セクションは入れ子にできず、必ず左端から始まります。ループや条件はセクションの中に置くことができ、レベルごとに半角スペース 4 つでインデントします。

ラベルとジャンプ

任意のコマンドに label="name" を付けるとジャンプ先になります。label("name") だけを 1 行に書くと、ジャンプ先専用の何もしないステップになります。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")
引数内容
"crop"引用符で囲んだ名前、または名前の条件式です。例:"A" or "B"、"A" and "B"(括弧でグループ化も可能)。wait_for、click_crop、および 4 種類の if_image/while_image ブロックで使えます。click_crop は最初に書かれた名前をクリックします。詳しくは条件をご覧ください。
confidence一致の厳しさです(0–1)。既定は 0.8。ホバーで色調が変わるボタンには低くし、間違ったものに一致してしまう場合は高くしてください。
timeout_ms探し続ける時間です。既定は 5000。
abort既定は False:画像が見つからなくても単なる不一致であり、エラーではないため、実行は続行されます。停止させたい場合は abort=True にしてください。
on_fail画像が最後まで見つからなかったときにジャンプするラベルです。
region(x, y, w, h):この矩形の中だけを検索します。同じコントロールが 2 か所に現れる場合に使ってください。各数値は変数でも、和の式でも構いません。
match"color"(既定、より厳密)または "shape"(輪郭のみで、テーマが変わっても機能する)を指定します。古い書き方の grayscale=True も、引き続き match="shape" と同じ意味です。
x_offset / y_offsetclick_crop の場合:一致した部分の中心からクリック位置をずらします。
pre_click_msclick_crop の場合:押す前にカーソルが一致箇所の上で静止している時間です。既定は 200。詳しくは「マウス」をご覧ください。
into一致結果を変数に保存します。r = wait_for("crop") のように書いても構いません。詳しくは一致結果をご覧ください。

ぎりぎりまで絞って取得してください。切り抜きには、特徴的な部分だけを入れ、それ以外は含めないようにします。背景が写り込んでいると、その背景が変わったときに一致しなくなります。

画面からの文字読み取り

read_text は、画面の領域を読み取って変数に格納します。結果はメソッドで整形し、条件式や算術式で使ったり、テキスト引数の中で ${name} として使ったりできます。

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

必ず region を指定してください。デスクトップ全体を読み取ると縮小されすぎて、通常のインターフェイスの文字は読み取れなくなります。

3 つの読み取りエンジン

engine=内容
"builtin"既定のエンジンです。このコンピューター上で無料で動作し、エクスポートしたプログラムにも組み込まれます。
"tesseract"こちらもローカルで無料です。組み込みエンジンより良く読み取れる画面も、悪くなる画面もあります。page_mode= を指定できるのはこのエンジンだけで、画像を行に分割する方法を制御します。読み取り結果が惜しいのに間違っている場合に試してください。
"ai"サーバー上の文字起こしモデルです。クレジットを消費し、エクスポートをブロックします。詳しくは「クレジット」をご覧ください。重要な部分を両方のローカル エンジンが誤読する場合に使ってください。

エンジンはステップごとに選べます。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 を指定すると、結果を 1 行にまとめます。

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)

呼び出すたびにクレジットを消費し、エクスポートをブロックします。クレジットを参照してください。1 回の実行につき AI の呼び出しは 60 回までです。

3 つのロール

role=回答
"count"既定のロール。数値と位置を返します: n が件数、n.1.x / n.1.y が 1 件目の位置、n.2.x が 2 件目です。インデックスには変数も使えます: click(n.${i}.x, n.${i}.y)。Yes/No のロールはありません。if n: は“見つかったか”、if not n: は“見つからなかったか”を意味します。
"explain"文章です。log() や notify() に使います。
"read"文字起こしです。選んだモデルを使います — 固定の文字起こしモデルを使う read_text(engine="ai") とは異なります。

モデルの選択

model= には短い名前を指定します。そのステップが読み取る領域の料金で計算された最新の一覧は、設定フォーム(「スクリプト」タブで ask_ai の呼び出しをダブルクリック)にあります。推奨設定は既定のモデルを既定の推論レベルで使うことです:model= と reasoning= を呼び出しから省くと、サーバーが選びます。現在は glm です。この表は、あえて変更したい理由がある場合のためのものです。最も高価なモデルがどの質問にも最も正確とは限らず、最も安価な gemma が、小さな切り抜きで最も正確だったと測定されています。

名前モデルreasoning= のレベルtemperature=
gemmaGoogle Gemma 3 12B—0–2
glmGLM 5.3 Flash (既定)—0–2
qwen-vlQwen3-VL 30B—0–2
gemini-liteGemini 3.1 Flash Lite—0–2
geminiGemini 3.7 Flashlow, medium, high—
haikuClaude Haiku 4.5—0–1
sonnetClaude Sonnet 5low, medium, high, xhigh, max(既定は high)—
gemini-proGemini 3.1 Prolow, medium, high0–2
kimiKimi K3low, high, max(常に推論する。既定は max)—
opusClaude Opus 5low, medium, high, xhigh, max(既定は high)—

必ず region= を指定してください。モデルはデスクトップ全体にわたって物を数えられますが、その後で位置を特定することはできません。クリックしたいマクロには、小さな画像が必要です。これは read_text や AI の監視行にも当てはまります。

スクリプト リファレンス

スクリプトは Python に似ていますが、その中のごく一部だけを使います:変数、算術演算、if/else、while と repeat のループ、コマンド呼び出しと def 関数、4 スペースのインデント、# コメントです。ブロックは入れ子にできますが、セクションだけは左端に置く必要があります。リストはなく、+ による文字列結合もなく、インポートもありません。

完全なリファレンス — すべてのコマンド、それぞれが取るすべての引数、キー名、そして実例 — はアプリ内の、スクリプトを書くエディターのすぐ横にあります。「スクリプト」タブでコマンド一覧を開き、任意のコマンドを右クリックするとそのマニュアル ページが開きます。1 つを選んで挿入を押すと、カーソル位置に有効な呼び出しが挿入されます。呼び出しをダブルクリックすると設定フォームが開き、そのコマンドが受け付けるすべてのオプションが一覧表示されます。

名前付き引数は、名前を省いて順番どおりに渡すこともできます:press("a", 0.5) は press("a", hold=0.5) と同じです。どのコマンドも label="name" を受け付けます。

監視

「監視」は画面を見張る機能です。マクロの実行中はもちろん、監視を開始を押すだけで単独でも、クラッシュ ダイアログ、セッション切れのバナー、在庫切れの警告など、起こりうることに備えて画面を見張ります。wait_for は置いた場所だけを見ますが、監視は実行中ずっと見続けます。

行が監視するもの

監視方法のチップで、見つける画像か、尋ねる質問かのどちらかを選びます。

種類内容
画像名前を付けた切り抜きを、wait_for と同じ方法で照合します。無料で、好きなだけ頻繁に行えます。
AI に質問ビジョン モデルへの質問です:“エラー ダイアログは出ていますか?” 回答は件数で、0 は何も見つからなかったことを意味します。クレジットを消費します。クレジットを参照してください。

発火条件

設定意味
出現時画像が現れる、または件数が 0 から何らかの数値に変わったときです。
消失時それまであったものが、なくなったときです。行は先に見つけている必要があるため、まだ開いてすらいないものに対して発火することはありません。
分析AI の行専用です。エッジはありません:モデルが見たものを説明し、行は確認のたびにその文章を送ります。

行のその他の項目

列内容
検索範囲画面のどの部分を検索または質問の対象にするかです。空欄はどこでも、という意味です。AI の行には小さな領域を指定してください。AI への質問を参照してください。
一致方法画像の行では、色はより厳密に、形状は輪郭だけで一致し、テーマが変わっても影響を受けません。横のギアには通知の間隔の設定があります。AI の行では、このセルでモデル、推論、温度、領域、通知の間隔を設定します。
確認間隔この行が確認する間隔を秒単位で指定します。AI の行は 1 秒未満にはできず、既定は 60 秒です。
開始待ち監視を開始してからこの行が動き始めるまでの遅延で、アプリケーションの読み込みが終わるのを待つためのものです。監視を開始するたびにリセットされます。
メッセージアラートの内容です。${name} は置き換えられます。空欄のままにすると、分析の行はモデル自身が返した文章を送ります。

発火時の動作

ポップアップ、Telegram、Discord、そしてスクリーンショットの添付です。行のピルで送信先を選び、設定で認証情報を指定します。マクロを停止は、マクロと監視の両方を停止します。分析の行は確認のたびに発火するため、マクロを停止することはできません。

行の設定には、確認間隔とは別に、メッセージ間の通知の間隔もあります。設定 > 通知では、監視中に画面のスクリーンショットをタイマーで送信することもできます。

エクスポート

エクスポートボタンは、オンになっていて画像を持つすべての監視行を、その切り抜きと設定ごと引き継ぎます。エクスポートしたプログラムは、実行のたびにそれらを開始し、実行が終わると停止します。ここでの実行とまったく同じです。AI に質問する行は、エクスポート時に名前を挙げて拒否されます。先にオフにしてください。Telegram や Discord への通知が届くかどうかは、エクスポート時の認証情報の確認によって決まります。

オート クリッカー

クリッカータブは、停止するまでクリックまたはキー入力を繰り返します:カーソル位置、指定した位置、またはクリックして記録した一連のポイントです。これはマクロではありません — プロジェクトには何も追加されません — ただし、このタブの設定はすべて次回のために記憶されます。

3 つのモード

モード内容
クリッククリックを 1 回、繰り返します。ボタンは左・右・中央、種類はシングル・ダブル・トリプルから選べます。位置は、マウスに追従するカーソル位置、フリーズした画面上で選ぶ固定位置、またはボックス内をランダムに移動する位置のいずれかです。
キー入力1 つのキーを繰り返し押します。
ポイントのシーケンス複数の場所を順番にクリックし、それぞれに固有の待機時間、ボタン、クリックの種類があり、これを繰り返します。

設定

設定意味
クリックの間隔クリックの間隔をミリ秒単位で指定します。さらに、任意でジッターを追加できます:クリックごとに新しく抽選される上限までの追加時間で、リズムが完全に一定になることはありません。横の緑のピルには、長押し時間とジッターを含めた、1 秒あたりのクリック数として計算された値が表示されます。
長押し時間各クリックでボタンやキーを押し続ける時間で、これにも独自のジッターがあります。
停止条件停止するまで、クリック回数(シーケンスの場合は周回数)、または時間のいずれかです。
散らばり各クリックが、その基準点からどれだけ離れた場所に着地してもよいか(任意の方向)を指定し、長時間の実行で同じ 1 ピクセルばかりを叩かないようにします。0 は正確な位置を意味します。対象より小さい値にしてください。
ボックス内のランダム移動ボックスを選び、その中の開始位置を指定します。各クリックは前回の位置から一定の距離までしか動かず、ボックスの外に出ることはありません。
ホットキーF7 で開始、F8 で停止します。どのプログラムからでも使えます。変更は設定 > ホットキーで行えます。

シーケンスの記録

ポイントのシーケンスでポイントを記録を押し、プログラム自体の中で、クリックしたい場所を順に左クリックしていきます。クリックするたびに、見ている前で行が追加されます。停止を押したクリック — および Recorder のウィンドウ上でのそのほかのクリック — はカウントされません。その後、各行には固有の待機時間、ボタン、クリックの種類があり、選択でフリーズした画面上の 1 点を動かせます。

停止する方法

  • 停止ボタン、クリッカー停止キー、再生停止キー、または Recorder が最前面にあるときの Esc です。
  • 長押しモード:開始キーを押し続けている間だけクリックし、そのキーはポインター下のプログラムにもそのまま届きます。
  • カーソルが画面上端に触れたら停止する:マウスを画面の上端に押し当てると、どのモードでも停止します — キーボードなしでも抜け出せる方法です。
  • マウスが手動で動かされたら停止する:クリッカー自身が動かしていない場所にポインターがある、その瞬間です。

開始ボタンは、マウスがウィンドウの外に出られるよう少し待ってから始まります。ホットキーはすぐに始まります。

各プランに含まれるもの

クリッカー本体はすべてのプランに含まれます:正確な速さでの 1 回のクリックまたは 1 つのキー、カーソル位置または固定位置、回数、時間制限、そしてあらゆる停止方法です。Basic と Pro では、人間らしい動き(カーソルが 1 回ごとにクリック位置まで移動し、長押し時間も変化します)、2 種類のジッター、散らばり、ポイントのシーケンス、範囲内のランダム移動が加わります。Free では、これらの設定はグレー表示になり、横に錠前のアイコンが付きます。プラン加入前に設定しておいた内容は、対象になったときのために保持されます。

人間らしい動きは、通常のアプリケーションにおいてマウスを操作する手の動きに近づけるためのものです。Recorder は、どのプログラムに対しても自分自身を隠すようなことは一切行いません。

プログラムとしてエクスポート

ファイル → プログラムとしてエクスポート… は、マクロとその切り抜き、調整に使った文字読み取り機能を含む単一の .exe を書き出します。インストーラーもランタイムも Recorder のコピーも必要ありません。

  • エクスポート ダイアログにはコントロール ウィンドウを付けるかどうかの選択肢があります:実行・一時停止・停止とそのキー、繰り返しと速度、そしてステータス行です。付けない場合、プログラムは開かれた瞬間に実行を始め、何も表示せず、マクロが終わると閉じます — スケジューラーが起動するものには向いていますが、最初に試すには向きません。手動で起動するものにはこのウィンドウにチェックを付けてください。そうすれば、問題は黙って見過ごされず、メッセージで表示されます。
  • 実行、一時停止、停止の各キーは、エクスポート時点で設定 → ホットキーに割り当てられていたとおりに引き継がれます。オンになっている監視行やキーボードの連続入力設定も同様です。
  • AI を使うマクロ(ask_ai、または read_text に engine="ai" を指定したもの)はエクスポート時に拒否され、該当するステップが示されます。2 つのローカルの読み取り機能はファイルの中に持ち出されます。
  • マクロや監視行が Telegram または Discord への送信を行い、いずれかが設定されている場合、Recorder はその認証情報を含めるかどうかを尋ねます。含めると、そのファイルを持つ人は誰でもそれを読み取れます。含めない場合、notify ステップや通知は何も送信しません。Telegram と Discord には Basic または Pro が必要です。Free ではこの質問自体が表示されず、情報が持ち出されることもありません。

エクスポートしたプログラムを停止する

エクスポート時に割り当てられていた再生を停止キーです。変更していなければ F6 です。停止キーをオフにしていた場合は F6 に戻ります。停止できないマクロは実行されないためです。

そのキーをほかのアプリケーションが使用している場合、プログラムはまず Ctrl+Shift を、続けて Ctrl+Alt を試し、最初のステップの前にどちらを使うかを知らせます。どれも登録できない場合、マクロはまったく実行されず、理由が報告されます。

エクスポートしたプログラムには、入力した文字も含め、マクロのすべてが含まれています。誰かに送る前に、パスワードやトークンが含まれていないか確認してください。このファイルはコード署名されていないため、初めて実行したときに SmartScreen が警告を表示することがあります。

AI アシスタント

作りたいマクロを説明すると、アシスタントがスクリプトを書きます。承認するまで、エディターには何も反映されません:返信を読んでから、「使用」または「置き換え」を押してください。すべての返信はコンパイラーでチェックされ、コンパイルできない場合、アシスタントは自動修正を 1 回試みます。これにはクレジットが消費されます。

モードは 2 つです。ビルドはマクロを書きます。プランは作業内容について質問し、マクロを書くを押すまで何も書きません。数ステップを超える作業は、まずこちらから始めてください。Ctrl+Enter で送信します。新規は新しい会話を開始し、保存されていた会話履歴を削除します。

モデルと推論は、どちらも既定のままにしてください。中と最上位は別のモデルであり、より優れたモデルではありません。また、推論を増やすと 1 回のやり取りごとのコストが増えますが、スクリプトが変わることはほとんどありません。リカバリーを使用は、クリックを外したときにマクロが停止せず、自力で元の流れに戻るようにします。クリックの後に短い sleep を追加は、クリックのたびに短く一時停止し、次のステップが画面より先に進まないようにします。どちらも通常はオンのままにしておきます。

良い回答を得るには

  • まず切り抜きを取得してください。 アシスタントには存在する切り抜きの名前が伝えられます。切り抜きが 1 つもないと、座標しか書けません。
  • 目標だけでなく、画面がどう見えるかを伝えてください。「すべて更新をクリックし、ステータス バーに Done と表示されるまで待つ」は「スプレッドシートを更新する」より優れています。
  • 会話の中で調整してください。「スリープの代わりに保存ダイアログを待つ」というのは、ごく普通の追加指示です。

クレジット

クレジットは、サーバーに届くものすべてに対して消費されます:アシスタントのやり取り(自動修正を含む)、ask_ai ステップ、AI の監視行、read_text に engine="ai" を指定したもの、そしてエージェント実行の各ステップです。記録、再生、画像アンカー、2 つのローカルの文字読み取り機能、エクスポートには一切かかりません。残高は、サインイン状態の横、アシスタント パネル、そしてアカウント ページに表示されます。AI のステップごとに、その料金が実行ログに記録されます。プランとクレジット パックについては料金ページをご覧ください。

マクロ内のすべての AI ステップ(ask_ai、read_text に engine="ai" を指定したもの、AI の監視行)はクレジットを消費し、サインイン済みのアカウントが必要で、エクスポートをブロックします。エクスポートしたプログラムには、請求先となるアカウントがありません。

エージェント

エージェントタブは 3 つ目のビューです。目標を入力すると、AI がそれを 1 ステップずつ、あなたのデスクトップ上で実行し、各ステップのあとに画面を確認します。これは、実際のマウスとキーボードを使った、あなた自身のデスクトップ上での computer use です。1 つの画面に収まる、短く目に見える作業に最も向いています — ページを開く、フォームに入力する、いくつかの画面をクリックして進む、といった作業です。長く続く作業や普段と違う作業は、マクロとして記録するほうが向いています。最初の数回は見守ってください。

各ステップは 1 回の AI 呼び出しで、ask_ai と同じクレジットで課金されます — 目標に到達しない実行のステップも含みます。エージェントが見るのは画面だけであり、画面上の文字がエージェントへの指示になることはありません。

これはアシスタントとは違います。アシスタントは、あなたが保存して再生するマクロを書きますが、エージェントはその場で作業を行い、あとには何も残しません。

作業を実行する

  1. 目標を入力します:ダウンロード フォルダーを開いて日付順に並べ替える。保存は保存済みの一覧に残し、削除は 1 つを取り除きます。
  2. 開始を押すか Ctrl+Enter を押します。Recorder は実行のたびに 1 回、エージェントに任せますか?と尋ね、目標と使用が許可されているものを繰り返し表示します。再生を停止のショートカットが設定されていないと開始しません。再生するを参照してください。
  3. タイムラインを見守ります。各ステップには、エージェントが見たもの、その前のステップへの判定(はい・いいえ・不明のいずれか)、現在行っていること、かかった費用が表示されます。フッターには実行の合計と残りのクレジットが表示され続けます。
  4. いつでも停止、またはご自身の停止ショートカットを押してください。

実行は完了、行き詰まり、停止のいずれかで終わり、そのクレジット、ステップ数、理由(3 回失敗したステップ、40 ステップに達しても終わらなかった、クレジットの上限、または停止キー)が示されます。

作業が質問の場合(このアカウントのプランを教えて)、答えはレポートとして返ってきます:メッセージ ボックス、または設定 → 通知でオンにしたデスクトップ・Telegram・Discord のいずれかです。

オプション

モデル既定、中、または最上位。最上位が推奨の設定で、新しいプロファイルはこの設定で始まります。
クレジット最適化各ステップでより小さいスクリーンショットを送信し、1 回の実行あたり約 2 割安くなります。エージェントが小さな文字を見落とす場合はオフにしてください。
マクロとして学習このビルドでは使用できません。ボックスはグレー表示になっています。エージェントはマクロを残しません。

エージェントに許可すること

ボックスの下の行には、エージェントが使用できるものが示されます。既定では マウス、キーボード、タイミング、起動、メッセージ です。権限を押すと設定 → エージェントが開き、それぞれができることの下のチェック ボックスになっています:

権限既定
マウスを移動してクリックするオン
キーボードで入力するオン
待機オン
ファイル、フォルダー、Web ページを開くオン
見つけた内容を報告するオン
コマンドを実行するオフ — オフのままにしてください。まだ十分にテストされていません。
コンピューターを再起動またはシャットダウンするオフ

最後の 2 つはオフのままにしてください。コマンド ラインはあなたと同じ権限で何でも実行でき、エージェントには安全なコマンドと破壊的なコマンドの区別がつきません。

停止条件では、1 回の実行のステップ数、1 つのステップの失敗回数、1 回の実行あたりのクレジット(0 で無制限)といった上限を設定します。ペースでは、画面が落ち着くまでエージェントが待つ時間、ステップの間の時間、そして 1 つのステップ内での操作の間の時間を設定します。クリックしてすぐ入力する動作についていけないアプリケーションには、最後の項目を長くしてください。

設定

メニュー ストリップの設定を押します。タブは 7 つ:ホットキー、記録、キーボード、ウィンドウ、通知、ログ、そしてエージェントです。OK で適用、キャンセルで破棄、既定に戻すで Telegram と Discord の認証情報を除くすべてがリセットされます。

ホットキー

7 つのグローバル ホットキーは既定値であり、固定ではありません。ここで割り当ての変更や無効化ができ、現在の設定を確認できるのはこのタブだけです。フィールドをクリックしてキーの組み合わせを押してください。Esc でクリアします。2 つの動作が同じキーを共有することはできず、ほかのアプリケーションがそのキーをすでに使用している場合は Recorder が警告します。既定値は再生するにあります。

記録とキーボード

記録には、キャプチャの切り替えとテストのカウントダウンがあります。キーボードでは、押し続けたキーが実際のキーボードのようにリピートするかどうかを設定します。既定はオフで、遅延、速度、任意のばらつき、そしてお使いの Windows の設定をコピーするこの PC に合わせるがあります。この設定はエクスポートしたプログラムにも引き継がれます。

ウィンドウ

実行中に隠す、すべてのモニターを使用、ダーク テーマ、そして 85% から 140% までの文字サイズです。最後の 2 つはその場で反映されます。

通知

既定ではオフです。有効にすると、Recorder は記録が終わったとき、再生が終わったとき、再生が中止されたときを、デスクトップ通知、Discord、Telegram、またはその組み合わせで知らせます。デスクトップ通知はすべてのプランで使えます。Telegram と Discord には Basic または Pro が必要です。Free では 2 つのボックスがグレー表示になり、理由がその下に表示されます。入力したトークンや Webhook は、プランが対応するようになったときのために保存されます。監視も同じ通知先を使い、行ごとに切り替えられます。画像の品質では、添付するスクリーンショットの大きさを「非常に低い」から「ロスレス」まで設定します。

Discord

フィールドは 1 つだけです:Webhook の URL。

  1. Discord で Webhook を作成します。 サーバー設定 → 連携サービス → ウェブフックを開き、新しいウェブフックを選び、チャンネルを選んで名前を付け、ウェブフック URLをコピーを押します。ウェブフックの管理権限が必要です。
  2. それを Recorder に貼り付けます。 設定 → 通知でDiscordにチェックを入れ、URL を貼り付けます。
  3. テストを送信します。 数秒以内にチャンネルにメッセージが表示されるはずです。

Webhook の URL はパスワードと同じです。 これを知っている人なら誰でもそのチャンネルに投稿できます。漏えいした場合は、Discord でそのウェブフックを削除して新しく作り直してください。これを使うプログラムをエクスポートする際には、先に確認が行われます。

Telegram

BotFather から取得したボット トークンと、会話の数値のチャット ID が必要です。どちらも設定 → 通知に入力します。

定期スクリーンショット

監視中に画面の画像を送信するは、選んだ範囲または画面全体のスクリーンショットを N 秒ごとに Telegram と Discord に投稿します。これは監視を開始がオンの間だけ動作し、デスクトップのバルーン通知は使いません。

送信される内容

常に何が終わったかを示す 1 行のテキスト、または監視行で設定したメッセージです。
場合により監視行でオンにするか、定期スクリーンショットを有効にした場合のスクリーンショットです。その瞬間に選んだ範囲に画面上にあったものがそのまま写ります。
なしあなたのマクロ、スクリプト、切り抜き、アカウントに関する情報は一切含まれません。

メッセージはお使いのコンピューターから直接 Discord や Telegram に送られ、当社のサーバーを経由することはありません。

診断ログ

表示 → ログには実行中の動作が表示され、設定 → ログで記録する内容を選びます。マクロの動作がおかしいときは、まずすべてのステップをオンにしてください。文字の内容は、画面から読み取った文字をそのままの文字で記録します。問題を見つけたら、再びオフにしてください。

お使いのライセンス

同時に使えるのは 1 台のコンピューター

別のマシンに移す場合は、古いほうでサインアウトしてから、新しいほうでサインインしてください。古いコンピューターがもう使えない場合でも、新しいほうでそのままサインインできます。古いマシンが30 日間接続してこないと、新しいマシンがその枠を引き継ぎます。

オフラインで動作する

接続が切れても実行は止まりません。ストリップには “サインイン中(オフラインで動作)” と表示され、Recorder は動作を続けます。停止するのは、長時間オフラインが続いた場合だけです。

プランに含まれていない機能

プランで内容が変わるのは 6 つです:AI 機能、画面からの文字読み取り、画面監視、プログラムとしてのエクスポート、Telegram と Discord への通知、そしてオート クリッカーの追加機能(人間らしいクリック、ジッター、散らばり、ポイントのシーケンス、範囲内のランダム移動)です。プランに含まれていない操作は赤色になり、クリックすると理由が説明されます。2 つの通知ボックスとクリッカーの追加コントロールは、南京錠のアイコンと理由とともにグレー表示になります。

変更は約 30 分以内に反映されます。アカウントダイアログには、プランとクレジット残高が表示されます。

トラブルシューティング

症状よくある原因と対処法
クリックが違う場所に当たる 記録された座標は絶対座標です(記録を参照)。ウィンドウが移動したか、解像度が変わっています。click(x, y) を click_crop("name") に置き換えてください。
1 ステップずつ実行すると動くが、全速だと失敗する アプリケーション側に少し時間が必要です。クリックはすでに pre_click_ms=200 の間対象の上で静止しています。失敗するクリックでは 400–600 を試すか、さらに良い方法として、これから使うものを wait_for してください。
画像が見えているのに wait_for がタイムアウトする 切り抜きに変化した背景が含まれているか、コントロールの配色が違います。より狭く取り直すか、confidence を下げるか、match="shape" を試してください。「画像検索」のログ トピックでスコアを確認できます。
read_text が意味のない文字を返す region がない、または広すぎます。文字の部分だけに絞り、それでも組み込みの読み取り機能がうまくいかない場合は engine="tesseract" を試してください。
ask_ai ステップや AI の監視行が何も答えない クレジットのあるサインイン済みのアカウントと、内容が読み取れる程度に小さい region= が必要です。
エージェントが開始しない 再生を停止のショートカットが割り当てられていません(ダイアログには エージェントには停止キーが必要です と表示されます)。設定 → ホットキーで設定してください。クレジットのあるサインイン済みのアカウントも必要です。
エージェントが停止または行き詰まりで終わる 上限に達したか(1 つのステップが 3 回失敗、40 ステップに到達、またはクレジットの上限)、モデルがあきらめたかのいずれかで、最後の行にどちらかが示されます。目標をより小さな作業に分けるか、クレジット最適化をオフにするか、設定 → エージェントで上限を引き上げてください。
実行後にキーボードが固まったままになる key_down に対応する key_up がありません。修飾キーを手で押して離してから、マクロを修正してください。
「不明なラベル」エラーで再生が止まる goto、on_no、on_fail、または wait_any の矢印が、どのステップにもラベル付けされておらず、どのセクションの名前でもないものを指定しています。つづりを確認してください。ラベルとセクション名は大文字・小文字を区別します。
ショートカット キーを押しても何も起きない 割り当てが変更されている、無効になっている、またはほかのアプリケーションが先に登録しています。Windows はグローバル キーの共有を許しません。設定 → ホットキーを確認してください。
エクスポートしたプログラムが F6 で停止しない ほかの何かが停止キーを使用しているため、プログラムは開始前に Ctrl+Shift または Ctrl+Alt で有効化し、その旨を知らせています。キーはエクスポート時点の設定 → ホットキーの割り当てのまま引き継がれます。割り当てを変更したら、再度エクスポートしてください。
再生を開始しても何も起こらない 対象のアプリケーションが管理者として実行されているのに対し、Recorder はそうなっていません。Recorder も管理者として起動してください。
ボタンが赤色になっている その機能はお使いのプランに含まれていません。クリックすると、どの機能かがメッセージで示されます。お使いのライセンスを参照してください。
エクスポートしたプログラムを実行しても見た目に何も起こらない コントロール ウィンドウなしでエクスポートされているため、開かれた瞬間に実行を始め、マクロが終わると閉じます。コントロール ウィンドウを表示するにチェックを入れて、もう一度エクスポートしてください。実行・一時停止・停止が画面に表示されるようになり、問題が起きた場合はメッセージで表示されます。

それでも解決しませんか?

support@mynarecorder.com までメールしてください。期待していたことと実際に起きたことを、ログがあればそれも添えてお伝えいただくと、1 回の返信で実際に役立つ回答が得られます。