設計の要点
LinkJumkeyはDevTools Consoleの代替ではありません。ユーザーの意図やAIの提案を読み取り、
URL、Desktop Host、Chromeの現在タブのうち適切な実行先へ、確認済みの操作だけを渡します。
Desktop判断・保存・承認
分類、危険度表示、編集、プラン制限、実行結果、保存を担当します。
HostPC側の実行
ファイル、アプリ、Excel、キー、PowerShell、AppleScriptなどをOSに合わせて実行します。
Thin Chrome必要最小限の橋渡し
Desktopで承認済みのWeb操作を現在タブへ渡し、結果を返します。AI判断や保存はしません。
入力として認識する形式
| 入力 | 判定 | 実行先 | 推奨の表記 |
| HTTP/HTTPS、mailto、tel、主要URI | 通常ボタン | 既定ブラウザ/アプリ | URLを単独で記載 |
| Windows/Macの絶対パス | ファイルを開く | Host | 引用符付きでも可 |
| PowerShell | PCコード | Windows Host | ```powershell |
| Batch / cmd | PCコード | Windows Host | ```batch |
| AppleScript | PCコード | macOS Host | ```applescript |
| Shell / zsh / bash | PCコード | 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
| actionType | payload | 用途 |
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が提案する時のチェックリスト
- 標準のURL・ファイル・アプリ操作で足りないか先に確認する
- OSと対象アプリを明示する
- 不明なURL、パス、マクロ名、アプリIDを推測しない
- 必要な外部ソフト、モジュール、権限を
requiresへ書く
- 送信・削除・上書き・課金・管理者権限を伴うなら
risk.level=high
- コードを出す場合は、実行先に合う言語名のコードブロックを1つにする
- 実行ではなく下書きの提案に留める