# OneShotAiPanel

> 設定したLLM（opencode、shadcn、fallback）に接続し、タスクをワンショットで実行するオープンソースのReactコンポーネント：JSONのストリーミング、スキーマ検証、差分レビュー、そしてあなたのスタックへの直接プラグイン。

## OneShotAiPanel とは？

あなたの選んだLLMに接続し、リクエストを検証済みの成果物に変えるReactコンポーネント。手動のコピー＆ペーストは不要です。

## 機能

- **設定したLLMへの接続** : 構成したプロバイダー（opencode、shadcn、fallback、または独自のonSend）を呼び出します
- **リアルタイムのJSONストリーミング** : モデルの応答がストリーミングで届き、スキーマ（zod）に対して検証されます
- **検証済みのJSONスキーマ** : 各ticketはスキーマで制御された正確な構造を期待します
- **自動検証** : 不一致があれば、2回目のやり取りのためにターゲットを絞ったフィードバックが返されます
- **Diffとレビュー** : 既存のコンテンツがある場合、行ごとのdiffで統合前に何が変わるかを確認できます
- **直接プラグイン** : onPlugで選択したコンテンツを取得し、自分のコード、アダプター、SDKに組み込みます

## 仕組み

- **1. タスクを記述する** — ユーザープロンプト、システムプロンプト、そしてコンテキストファイル。コンポーネントが最終的なプロンプトを組み立てます。
- **2. モデル接続を設定する** — コンポーネントは、アダプター（opencode、shadcn、fallback）または独自のonSendで構成したプロバイダーに接続します。この接続がなければ何も動作しません。
- **3. 送信は一度だけ** — モデルはストリーミングJSONで応答します。各ticketはスキーマで制御された正確な構造を期待します。
- **4. 自動検証** — 応答はスキーマに対して検証されます。不一致があれば、2回目のやり取りのためにターゲットを絞ったフィードバックが返されます。
- **5. Diffとレビュー** — 既存のコンテンツがある場合、行ごとのdiffで統合前に何が変わるかを確認できます。
- **6. プラグイン** — onPlugで選択したコンテンツを取得し、自分のコード、アダプター、SDKに組み込みます。

## 設定（主なprops）

### コンテンツ

- `title` — コンポーネントのヘッダーに表示されるタイトル。
- `systemPrompt` — モデルに与えられる役割とルール。
- `initialUserPrompt` — ユーザーフィールドにあらかじめ入力される初期リクエスト。

### コンテキスト

- `files` — モデルへのコンテキストとして提供されるプロジェクトファイル。
- `tickets` — タスクの分解。各ticketはJSONスキーマを持ちます。

### 契約

- `parser` — レスポンスのパースと検証をカスタマイズします。
- `invalidMode` — レスポンスがスキーマを検証しない場合に警告またはブロックします。

### アダプター

- `adapter` — プロバイダー（opencode、shadcn、fallback）、モデル、APIキー。
- `onSend` — 送信を独自ロジック（SDK、プロキシ…）で置き換えます。

### イベント

- `onPlug` — ユーザーが選択したコンテンツを統合したときに呼び出されます。

### i18n

- `language` — インターフェースの言語。
- `labels` — 任意のラベルを細かく上書きします。

### UI

- `actionLabel` — メインの実行ボタンのラベル。
- `showInfoButton` — ヘルプ／統合／クレジットボタンを表示します。
- `showSettingsButton` — 設定ボタンを表示します。
- `showInfoIntegration` — ヘルプパネルに統合ポイントを表示します。
- `showInfoCredits` — ヘルプパネルにクレジットを表示します。

## インストール

ソースコードとデモはGitHubにあります：

- リポジトリ : https://github.com/bn-dev-19/one-shot-ai-panel
- 現在のバージョン : v1.1.3 (アーカイブ : https://github.com/bn-dev-19/one-shot-ai-panel/archive/refs/tags/v1.1.3.zip)

## Playground

このサイト上で実際に動作しています： : https://oneshot-ai-panel.asistem19.com/ja#playground

## リンク

- ホーム : https://oneshot-ai-panel.asistem19.com/ja
- GitHub : https://github.com/bn-dev-19/one-shot-ai-panel
- ライセンス : https://oneshot-ai-panel.asistem19.com/ja/license
- 利用規約 : https://oneshot-ai-panel.asistem19.com/ja/terms
- プライバシーポリシー : https://oneshot-ai-panel.asistem19.com/ja/privacy
- クレジット : https://oneshot-ai-panel.asistem19.com/ja/credits