For AI / Developers

+Autoへ正確に操作を渡す

このページは、外部AIへ指示する人、コードを提案するAI、詳しい設定を作る人向けです。 一般利用者向けの説明と実行仕様を分離し、何がどこで動くかを曖昧にしないための資料です。

外部AI・開発者向け: このページは実行仕様です。初めて使う方は一般向け手順から始めてください。

設計の要点

LinkJumkeyはDevTools Consoleの代替ではありません。ユーザーの意図やAIの提案を読み取り、 URL、Desktop Host、Chromeの現在タブのうち適切な実行先へ、確認済みの操作だけを渡します。

Desktop

判断・保存・承認

分類、危険度表示、編集、プラン制限、実行結果、保存を担当します。

Host

PC側の実行

ファイル、アプリ、Excel、キー、PowerShell、AppleScriptなどをOSに合わせて実行します。

Thin Chrome

必要最小限の橋渡し

Desktopで承認済みのWeb操作を現在タブへ渡し、結果を返します。AI判断や保存はしません。

入力として認識する形式

入力判定実行先推奨の表記
HTTP/HTTPS、mailto、tel、主要URI通常ボタン既定ブラウザ/アプリURLを単独で記載
Windows/Macの絶対パスファイルを開くHost引用符付きでも可
PowerShellPCコードWindows Host```powershell
Batch / cmdPCコードWindows Host```batch
AppleScriptPCコードmacOS Host```applescript
Shell / zsh / bashPCコードmacOS Host```shell
JavaScript、bookmarklet、userscript本文Webページ操作Chrome現在タブ```javascript または javascript:
LinkJumkey Auto Plan JSON指定された型型による```json
自然文AIが操作案を作成確認後に決定OS、対象、完了条件を書く

外部AIへ相談する時の依頼文

ChatGPT、Claude、Geminiなどへ、次を貼ってから「やりたいこと」を続けてください。

私はプログラマーではありません。LinkJumkey Desktop の「+Auto」で使える操作を作りたいです。

OS: Windows 11(Macなら macOS と書き換え)
やりたいこと: ここへ具体的に書く
対象: 使うアプリ、Webサイト、ファイルが分かれば書く
完了の状態: 何が起きれば成功かを書く

最初に、次の3点を専門用語なしの日本語で説明してください。
1. 何ができるか
2. 事前に必要なもの
3. データ送信・削除・設定変更などの注意点

コードが必要なら、LinkJumkeyが判別できるよう、コードブロックは1つにまとめて
言語を powershell / batch / applescript / shell / javascript のどれかで指定してください。
単純なURLや標準機能で足りる場合は、コードを作らず一番簡単な方法を提案してください。
ログイン回避、CAPTCHA回避、Cookieやパスワードの取得は提案しないでください。
LinkJumkeyの検索語入力欄の文字を使う場合は、受け取り方を
https://linkjumkey.matsumotojoho.com/guide/linkjumkey-input-arguments.txt に合わせてください。
AI側への補足 返答に説明文を含めても構いません。コードまたは下記Auto Planを明確なコードブロックに分けると判定が安定します。

AI向け: LinkJumkey Auto Plan v1

単一コードでは表しにくい操作は、次の型付きJSONを返せます。未知のキーは破棄され、Desktopでもう一度検証されます。ツールから扱う場合は JSON Schema を正としてください。

{
  "version": 1,
  "actionType": "openApp",
  "title": "朝の準備",
  "label": "Excelを開く",
  "summary": "Microsoft Excelを起動します。",
  "target": "このWindows PC",
  "payload": {
    "appHint": "Microsoft Excel"
  },
  "requires": ["Microsoft Excel"],
  "risk": {
    "level": "low",
    "reasons": []
  },
  "confidence": 0.95
}

actionTypeとpayload

actionTypepayload用途
basicUrl{url, typeMode}固定URL / 入力を付けるURL
openFile{file, appHint, launchArgs}ローカルファイル
openApp{appHint, launchArgs}アプリ起動
postText{preText, postText, includeCommon, destination, paste, appHint}destination: "clipboard" はコピーだけ、"app" は対象アプリへ貼り付け。paste は旧形式との互換用です。
sendKeys{sequence, appHint}ショートカットキー
runMacro{file, macro, args, passInput}Excelマクロ
recipe{steps}安全な複数手順
runScript{scriptType, script, timeoutMs, passInput}PCコード
browserScript{code, world, timeoutMs}現在のChromeタブ
manual{request}情報不足・対応不可

recipe.stepsで許可されるのは openApp / openUrl / openFile / postText / sendKeys / runMacro / wait のみ、最大12手順です。任意コードはレシピへ混在できません。

検索語入力欄の文字を使う場合は、runMacro と runScript に "passInput": true、openFile と openApp に launchArgs を指定します。コードでの受け取り方と安全な書き方は 検索語を引数で受け取る を正としてください。

Webページ操作の境界

できる例

  • ページ内の見出しや該当行を強調する
  • 現在ページの入力欄へ、ユーザーが指定した文字を入れる
  • 開いている表から表示中の情報を整形して返す
  • 既存のbookmarkletやuserscript本文を、押した時だけ実行する

できない・許可しない例

  • chrome://、chrome-extension://、Chromeウェブストア、DevToolsなどの保護ページ
  • ログイン、MFA、CAPTCHA、アクセス権限の回避
  • Chrome拡張・Firefox Add-onそのもののインストールや代替実行
  • 確認なしの常時実行、全ページ監視、バックグラウンド収集
実行world 通常はページと分離されたUSER_SCRIPTを使います。ページ自身のJavaScript変数や関数へ触れる必要がある時だけMAINを選びます。
セキュリティ境界 USER_SCRIPTはページ本体のJavaScriptとの分離であり、セキュリティサンドボックスではありません。許可したサイトのDOMを読み書きでき、コード次第では外部通信も行えます。静的な危険パターン検出も安全保証ではないため、生成元・実行対象・送信先をユーザーが確認する前提です。

安全確認とデータの扱い

  • 外部AIのAuto Planは、許可リスト外の項目をサーバーとDesktopの両方で破棄します
  • コード操作は最低でも「内容確認」扱いになり、削除・権限・保存情報・外部通信などは強い警告を表示します
  • 高リスク判定では確認チェックを入れない限り編集画面へ進めません
  • 実行結果は終了状態、所要時間、標準出力、エラーを表示します
  • 共有リンク、MCP、外部ディープリンクから任意スクリプト本文を無確認で登録する経路は作りません
  • Thin拡張は操作案やコードをクラウドへ保存しません。Desktopとローカル認証し、承認済み処理を現在タブへ渡します。現行版は自動接続し、接続コードは旧版との互換用です
  • Desktopの公開状態APIは接続コードを返しません。接続コードはDesktop本体だけが表示でき、ThinではChromeのローカルストレージに保存します

AIが提案する時のチェックリスト

  1. 標準のURL・ファイル・アプリ操作で足りないか先に確認する
  2. OSと対象アプリを明示する
  3. 不明なURL、パス、マクロ名、アプリIDを推測しない
  4. 必要な外部ソフト、モジュール、権限をrequiresへ書く
  5. 送信・削除・上書き・課金・管理者権限を伴うならrisk.level=high
  6. コードを出す場合は、実行先に合う言語名のコードブロックを1つにする
  7. 実行ではなく下書きの提案に留める