Strata Endpoint for LM Studio

Strata（Niko1221/Strata / Winery-Strata系）へ接続する専用Generatorプラグインのベータ版です。既存の sonct/openai-compat-endpoint とは別の yuanjumay/strata-endpoint として使用します。

画像の転送・認識はユーザー環境で動作していますが、画像入力ボタンの表示は実験的な補助処理に依存します。長時間の自動検索に対する履歴圧縮・RAGによる退避は未実装です。詳細は「既知の制限」を参照してください。

対応範囲

会話中の画像を読み取り、OpenAI互換の image_url（base64 data URL）で転送。
Strataの reasoning_content をLM Studioのreasoningフラグ付きストリームへ変換。
Thinking: Server default / Off / Low / Medium / High。
出力上限と reasoning_budget_tokens を個別指定。0はパラメーター省略。
MCP等のツール定義・呼び出し・結果を転送。複数呼び出しが交互に届いてもindex別に組み立てます。
空白等を含むツール名はAPI互換名に変換して送信し、受信時はLM Studioの元の名前へ戻します。会話履歴の呼び出し名も同じ変換を適用します。
一意な場合は Visit_Website_Advanced のような単純な名前を使用します。正規化すると同じ名前になる別ツールがある場合だけ識別用の接尾辞を付け、曖昧な呼び出しは推測しません。
回答全体が完全な <tool_call><function=...><parameter=...> ブロックの場合は、現在有効なツールとJSON Schemaで引数を検証して復元します。説明文・コード例・未登録名・不正な引数・途中で切れた出力は実行しません。
停止ボタンの中断を接続開始時から通信に反映。
APIキーなしのローカルStrataに接続可能。キーを指定した場合のみBearer認証。
小型の補助画像モデルをCPUにロードし、Strataチャットの Attach image を有効化する実験的な回避処理。
analyze-images-advanced 0.5.3以降は、画像ツール自身が独立したStrata解析の完了を待ち、解析文を正式なツール結果として返します。メイン会話はその結果から元の依頼を続行します。旧版の解析待ちデータを処理する互換経路も残しています。

開発・インストール

このディレクトリーでPowerShellを開きます。

常用する場合は開発サーバーを停止してから以下を実行します。

LM Studioの生成元の選択で yuanjumay/strata-endpoint を選んでください。実際の表示場所・名称はLM Studioのバージョンによって異なります。

旧ローカル版の local/strata-endpoint とは別のプラグインIDです。既存の会話では生成元から公開版を選択し直し、接続先と会話ごとの設定を確認してください。設定の自動移行や会話内のプラグインIDの書き換えは行いません。画像ボタンの補助処理は、移行期間中の旧ローカル版の会話も認識します。

Hubへの公開（開発者向け）

manifest.json の公開先は yuanjumay/strata-endpoint です。 npm test で検証後、このディレクトリーで lms push を実行するとHubへ公開・更新されます。 lms dev --install はローカルへのインストールで、Hubへの公開は行いません。

接続設定

プラグインのグローバル設定で以下を指定します。

設定	初期値・用途
Strata Base URL	`http://127.0.0.1:8080/v1`。実際の接続先へ変更
API Key	認証を使うサーバーのみ指定

会話ごとの設定:

設定	初期値・用途
Model	`strata`。必要なら実際のモデルID・エイリアスへ変更
Thinking	Server default。Offは `reasoning_effort: "none"`
Max output tokens	0（サーバーに任せる）。思考と回答の両方を含む
Thinking token budget	0（サーバーに任せる）

画像入力

添付画像の保持と履歴の欠落（0.1.3）

LM Studioの一時添付ファイルは、ツールやプラグインの終了後に利用できなくなる場合があります。読み取れた画像は会話の作業ディレクトリー内の .strata-image-cache に保存し、一時ファイルが消えても同じ添付識別子に対応する画像を復元して送信します。画像本体は内容のハッシュ名、添付との対応は識別子のハッシュ名で保存し、別の作業ディレクトリーからは再利用しません。

修正前に消失し、保存済みコピーもない過去の画像は、その画像を含めていない旨を明示して履歴を送ります。過去の回答・ツール結果・現在の依頼は保持するため、古い添付のENOENTで会話全体は止まりません。ただし画像の再確認が必要なら再添付してください。新しい未処理の添付が読めない場合は、画像を黙って省略せず「再添付が必要」というエラーにします。

ストリームの終了イベントを受信した時点で生成完了とし、後続の接続リセットや後片付けの失敗で完成済み回答を失敗扱いにしません。終了イベント前の切断や未完成のツール引数は引き続きエラーになります。

通常の画像選択を有効にする補助モデル

SmolVLM-256M-Instruct Q8_0（画像アダプター込み約365 MB）を使用します。初回のみ:

補助モデルは利用者側で事前に取得してください。プラグインによる自動ダウンロードは行いません。取得済みの補助モデルを、プラグイン起動時にSDKからロードします。同じ画像モデルが既にロード済みなら、そのインスタンスを再利用します。未ロードの場合は strata-vision-primer の識別名で、GPUオフ・KVキャッシュもCPU・コンテキスト512の構成でロードします。アイドル有効期限は指定しません。手動ロード済みモデルの設定は変更しません。補助モデルへ推論リクエストは送りません。画像と質問はStrataへ送ります。 Analyze Local Image Advanced を併用する場合は yuanjumay/analyze-images-advanced 0.5.3以降を使用してください。古い版はロード済みの補助モデルで画像解析を試みるため、512トークンのコンテキスト超過になります。 0.5.3以降の画像ツールは、画像ツール側の Strata analysis Base URL（既定は8080/v1）で独立した解析を実行し、完了した解析文をLM Studioへ返します。待機中JSONを返す方式は廃止しました。生成側の接続先を変更した場合は、画像ツール側の接続設定も合わせてください。

以下は旧版の解析待ちデータを含む履歴の互換処理です。アダプターはメイン生成前に、画像と解析指示だけを含む独立リクエストを同じStrata接続先へ送ります（ツールなし、Thinking off、最大2048トークン）。解析文は対応する role: tool の内容に入れてメイン生成へ渡します。解析リクエスト自体の出力は LM Studioの回答ストリームへ送りません。元のユーザー依頼を保ち、追加の解析用ユーザーメッセージも入れません。対象は直前のAnalyze呼び出しに対応する結果だけで、作業ディレクトリー・画像ハッシュ・有効期限を確認します。別チャットの情報や変更済み画像は使いません。解析後の応答を跨いで自動送信を繰り返すこともありません。自動ダウンロードや既存モデルのアンロードは行いません。

公式のGenerator能力宣言APIがないため、実験的に会話の lastUsedModel 情報を補います。対象は現在アクティブで yuanjumay/strata-endpoint（または旧 local/strata-endpoint）が有効、かつ lastUsedModel が未設定の会話です。自分が設定した補助モデルのインスタンス更新も対象にします。会話を .strata-vision-primer.bak にバックアップし、既存のモデル設定は上書きしません。プラグインの動作中は2秒ごとにアクティブな会話を確認し、新しいStrataチャットにも適用します。 30秒ごとにロード状態も確認し、補助モデルが解放されていたらロードし直します。初回失敗時にも再試行します。プラグイン起動時は最大5秒まで準備を待ち、それを超える場合はバックグラウンドで処理を続けます。LM Studioがプラグインプロセスを終了した間は監視も停止します。画面への反映に少し時間がかかる場合があります。

LM Studio 0.4.26の実画面で、旧ローカル版を選択したまま Attach image の出現を確認済みです。 SDKによる実機の未ロード状態からのロード、および手動ロード済みモデルの再利用も確認済みです。ユーザー環境では、添付画像をStrataへ送り画像認識できることを確認しています。

既知の制限

Attach image が表示されない、または一度表示された後に消える場合があります。補助モデルのロードを待ってから、生成元のモデル／Strataプラグインを選択し直してください。改善しない場合は、次節の @strata-image によるパス指定を使用できます。
画像ボタンの表示は正式なGenerator能力宣言ではなく、LM Studioの会話ファイルの lastUsedModel と内部UI状態を利用する回避処理です。会話本文は変更しませんが、モデル情報を書き換えるためバックアップを作成します。LM Studioの更新で動作が変わる可能性があります。
通常の添付と画像コマンドを含め、画像認識にはStrata側の画像対応モデルとVision encoderが必要です。

パス指定の代替入力

LM Studioで画像を添付できる場合は通常どおり添付します。画像が会話に渡れば、このアダプターは画像データを転送します。

補助モデルが使えない場合、Generator選択中の添付メニューが Attach file のみになることがあります。この場合は入力欄に以下のように記入します。 Generatorだけを選んだ状態でも処理できます。各コマンドは単独の行、パスは絶対パス・二重引用符付きです。

複数の画像はコマンド行を増やします。送信データではコマンドを画像に変換し、質問文だけを残します。 Generatorのみの場合、会話履歴のコマンドも各リクエストで元の画像ファイルから読み直します。元ファイルを移動・変更すると次の送信に影響するため、その会話の間は元ファイルを保持してください。このプラグインのPrompt Preprocessorも有効にした場合は、コマンドをLM Studioの添付に変換する経路も用意しています。パス指定はユーザーメッセージの先頭列の @strata-image 行だけを対象にします。モデルの返答やツール結果に書かれたパスは読み取りません。 1枚20 MiB、会話全体の画像合計64 MiBまで。対応形式はPNG/JPEG/WebP/GIF/BMP/TIFF/AVIFです。画像以外の未処理ファイルはエラーにして、黙って捨てないようにしています。

Strata側でも画像対応モデルとVision encoderが必要です。 LM Studioのインストール済みプログラム自体は変更しません。画像コマンドのStrata実機との通信・回答はまだ確認が必要です。

検証状況・制限

LM Studio 0.4.28の自動タイトル生成には10秒の制限があります。専用の依頼文を識別し、画像・ツールを除いた短いテキスト、思考なし、最大64トークンでタイトルを生成します。 6秒以内に返らない場合やタイトル生成の通信に失敗した場合は、会話の先頭文からタイトルを付け、完了した本文に This operation was aborted が付くのを防ぎます。ユーザーによる停止は中断として扱います。

TypeScriptビルドと自動テストで、実際のSDKのChat/ChatMessageを使う画像転送、画像コマンド、 UTF-8とネットワーク境界をまたぐSSE、Thinking分類、交互に届くツール呼び出し、中断、不完全なストリームの検出、リクエスト設定を検証しています。

回答品質やツール選択はStrata側のモデル・設定に依存し、すべての構成での動作は保証していません。ユーザー環境でStrataによる画像認識の成功報告あり。ツール呼び出しがXML本文として返る報告に対し、報告された2件の出力を使った再現テストで、数値引数の復元とLM Studioの呼び出し通知までを検証しました。ツール引数は完成後に検証してからLM Studioへ順番に渡すため、引数の途中表示は行いません。 LM Studio 0.4.26で複数ツール呼び出しの2件目以降の名前通知が無視される警告を確認したため、完成前の toolCallGenerationNameReceived 通知は省き、完成した呼び出しの name を渡します。 LM Studio 0.4.28の実画面でも、報告されたXMLを使って2つのダミーツールが正しい名前・引数で認識されることを確認しています。ユーザーによる実行許可後、両ツールの実行、両結果の次ラウンドへの返却、最終応答の完了までローカルのテストサーバーで検証済みです。テストでは実サイトにアクセスしていません。 Strataの既定サンプリングを利用し、LM Studioのモデル用Temperature等は転送しません。詳細な内部推論を生成させる機能ではなく、サーバーが公開する reasoning_content を表示する処理です。

参照

2026-10-31に仕様とローカルの @lmstudio/sdk 1.5.0 を確認。