選択範囲への AI アシスタント（Ctrl+K / Ctrl+I）

AI に聞く・AI で編集する

デフォルトの AI。 設定 → AI アシスタント の上部にある デフォルトの AI は、Ctrl+K/Ctrl+I、AI チャット チャット（セッションごとに変更可）、および自動処理（質問の書き換え、要約、音声の要約、コンテキスト生成）で使うアシスタントを選びます。CLI と API プロバイダーの両方を一覧します。音声の文字起こし と embeddings には専用のプロバイダーがあり、LightNote は選んだプロバイダーに応じて モデルを提案 します。

エディターで Ctrl+K（AI に質問）または Ctrl+I（AI で編集）を、選択あり/なしで 押すと、浮動のインラインチャット風ポップアップが開きます。プロンプト欄は空行の下に選択範囲が あらかじめ入っています。その上に指示を入力し、Ctrl+Enter で送信します。ポップアップでは AI（既定の AI が事前選択）と結果モードを選びます: 差分で選択範囲を置き換える （元 × 提案、適用 / コピー / 破棄付き）か、回答をテキストで表示するだけ にします。

LightNote は AI CLI を「ワンショット」モードで実行します（ターミナルを開きません）。 CLI と既定の AI は 設定 → AI アシスタントにあります。

モデルをつなぐ

API のモデル。ローカル CLI に加えて、設定 → AI アシスタントで OpenAI 互換 API（OpenAI、Groq、DeepSeek、OpenRouter、Gemini、Anthropic、Ollama／LM Studio などのローカルインスタンス…）の LLM モデルを登録できます。カタログからプロバイダーを選び（ベース URL は設定済み）、キーを貼り付け（このコンピューターにのみエンコードして保存）、モデルを取得…とテストを使います。登録したモデルは Ctrl+K の同じ選択肢に CLI と並んで表示されます。

ワンステップで接続。通常の手順は表に入力することではありません。設定 → AI アシスタントでAI を接続…をクリックし、プロバイダーを選び（一覧には無料プランありのものと、お使いのコンピューター上、キー不要で動くものが示されます）、3 つの手順に従い、ボタンでキーのページを開いてキーを貼り付けます。アドレスとモデルは LightNote が自動で入力し、保存する前に接続をテストします。キーの誤りは会話の途中ではなくその場でわかります。上の一覧には接続済みのものと、不足があるものについて何が足りないか（「キーが未入力です」「モデルが未選択です」）が表示され、ダブルクリックするとそのプロバイダーで再び接続画面が開きます。

細かい調整。アドレス、モデル、MCP の許可、CLI のコマンド、音声の文字起こし、埋め込みは、いずれもページ下部の詳細設定にそのままあります。接続画面の詳細オプションでも、接続前にベース URL とモデルを変更できます。何も削除していません。始めたばかりの人の前から動かしただけです。 エンベディングには任意の次元数という項目もあります。モデルによってはより小さいベクトル（1536 ではなく 512）を返せて、ほとんど品質を落とさずにキャッシュが半分になります。わからなければ（モデルの既定）のままにしてください——すべての提供元がこのパラメーターを受け付けるわけではありません。値を変えるとキャッシュは無効になります：次元の違うベクトルは比較できないので、破棄され、次の検索で作り直されます。その分の呼び出しは新たに課金されます。

失敗にも種類があります。 求められる対処が正反対なので、LightNote は種類を分けて扱います。プロバイダーの混雑と呼び出し頻度の制限は時間が解決します。アプリが自分で呼び出しをやり直し、プロバイダーが求めた待ち時間も守るので、それでもだめだったときだけエラーが出ます。残高や利用上限は何度繰り返しても解決しません。無駄に試さずに済むよう、メッセージがそう伝えます。会話が長くなりすぎたときに必要なのは新しいセッションで、別のモデルではありません。そしてモデルの問題——提供終了、アカウント外、プランの対象外、あるいは呼び出しを受けたまま応答しない——だけが、モデルを替えれば解決するものです。 求められた待ち時間が長すぎるときは、窓を止めたままにせず、何秒を求められたのかをメッセージが伝えます。

モデルを自動で切り替える。 現在のモデルが失敗したら自動で切り替えるにチェックを入れると、LightNote はその場に表示された順に、そのプロバイダーの推奨モデルを試します。既定でオフなのは意図的です。試行の一つ一つがあなたのアカウントに課金される呼び出しだからです。代わりのモデルが、あなたが選んだモデルより高くつくことはありません——一覧は高い順に公開され、アプリはそれを下る一方だからです。一覧にない独自のモデルは、いちばん安いものに直接落ちます。プロバイダーに保存されるのは決定的な失敗のときだけです。ネットワークの問題だった場合、切り替えはその呼び出しかぎりで、あなたの選択はそのまま残ります。切り替えは決して黙って行われません。どのモデルが応答したか、変更が保存されたかを通知が伝えます。

そして、失敗より先に届く知らせ。 自動の切り替えは呼び出しが失敗したあとにしか働きませんが、LightNote が自分で参照しているモデルのカタログは、たいていそれより先に提供終了を知っています。LightNote 自身が登録したモデルがカタログから外れると、その旨が知らされ、設定 → AI アシスタント に後継へ移るボタンが現れます。後継は、同じ規則により、けっして高くなりません。この知らせは、アプリが選びあなたが一度も触っていないモデルにだけ働きます。あなたが入力したモデルはあなたの選択であり、LightNote は口を出しません。

どれも応答しないとき。 LightNote は何が起きたかを伝え、モデルを替える、別のアシスタントを使う、解決するまでそのプロバイダーを無効にするのいずれかを提案します。無効にしたプロバイダー（詳細の表の有効列）は、キーもそのほかの設定も失わずに一覧から消えるだけです。アシスタントの一覧では、それぞれがローカルかクラウドかを示します。クラウドのものを選ぶと、送信したテキストはあなたのマシンの外に出ます。

AI を設定。 どんな AI でも、手順に沿って設定するには AI を設定… ボタンを使います。設定 → AI アシスタント の上部にあります（空のチャットの AI を接続… や、AI がないときの Ctrl+K の案内から開くのも同じものです）。何を設定したいかを尋ね、5 つの道筋を一歩ずつ案内します: クラウドの AI、Ollama または LM Studio によるお使いのコンピューターの AI、LightNote で直接動かすお使いのコンピューターの AI、コマンドライン アシスタント、意味で検索です。ボタンの横の 各機能が使う AI の表は、チャット、Ctrl+K、ブロックの AI、自動タスク、意味で検索をそれぞれどの AI が担当するかを示します。詳しくは お使いのコンピューターの AI を参照してください。

キー不要：ローカル LLM

まだ AI がない場合。 アシスタントを接続していない状態で Ctrl+K を押すと、LightNote がそのことを説明し、その場で接続することを提案します。接続するとすぐに、指示した操作がそのまま続きます—ショートカットを押し直す必要はありません。

ローカル LLM（キー不要）。ローカルプロバイダー（Ollama、LM Studio、llama.cpp）に API キーは不要です。追加から選び（サーバーが起動しているかどうかが一覧に表示されます）、モデルを取得…で取得済みのモデルから選択します。Ollama が未インストールの場合は、LightNote がインストールを案内します。初回起動時に登録済みなので、モデルを選ぶだけです。ローカルモデルは応答に時間がかかることがあるため（特にモデルを読み込む初回の生成時）、LightNote はクラウドサービスよりもはるかに長く待ちます。あなたのテキストがターミナルの外に出ることはありません。

別のプログラムなしでモデルを動かす。 Ollama や LM Studio のほかに、LightNote は llama.cpp の公式プログラムを使って、モデルを自分でダウンロードして実行できます。AI を設定 ウィザードは、ディスクとメモリをどれだけ使うかを事前に示し、お使いのコンピューターでの速度を測定します。お使いのコンピューターの AI を参照してください。

反映・プロンプト・操作のありか

ブロック単位で受け入れ。 結果が 差分 で表示されるとき、すべてを受け入れる必要はありません。変更された各ブロックには含めるかどうかのチェックボックスがあり、最終的なテキストは残したブロックだけで再構成されます。プロンプトにはファイルの自動コンテキスト（パス、言語、選択範囲の前後の行）も含まれるため、何も貼り付けなくても AI がより正確に答えます。

プロンプトライブラリ。 AI → プロンプトライブラリ… は、再利用できるプロンプトをワークスペースの Prompts/ フォルダー内の .md ファイルとして保管します。オープンな形式で、Git で版管理でき、あなたのセカンドブレインの一部になります。選択画面には検索・プレビュー・新しいプロンプトを作るボタンがあります。ひとつ選ぶと {selection}、{file}、{folder}、{name}、{language} の各項目が現在のエディターの文脈で埋められ（独自の変数はそのまま残ります）、本文が Ctrl+K の入力欄に挿入されるか、アクティブな AI ターミナルへ送られます（送信はしません）。

コードエディターだけではありません。 AI 操作（Ctrl+K / Ctrl+I とコンテキストメニュー）は、Markdown エディター、タスクの埋め込みノート、データベースの SQL クエリエディター でも使えます。いずれもカーソル上にポップアップが開き、その場に結果を適用します。

AI の操作はすべて AI メニューにまとまっています（☰ ボタンと、アクティビティバーの杖ボタン）: AI に質問（Ctrl+K）、AI で編集（Ctrl+I）、AI セッション、AI チャット、プロンプトライブラリ、ワークスペースのコンテキストファイルを生成、このフォルダーで AI を有効化、AI アシスタントの設定。

入力中はウィンドウが閉じません。エディターをクリックしても閉じないので、コードを読み返したり別の箇所を選択したりしても、すでに入力した指示は失われません。閉じるのは Esc、ウィンドウの ✕、そして結果の操作（適用／破棄）です。タブを切り替えると、書きかけの内容を保ったままいったん引っ込みます。同じファイルに戻って Ctrl+K を押せば、指示は途中からそのまま現れます。