KASUGAI Canvas v6.17.0

AI の利用形態（通常版 / アプリ版）

「通常版」は静的配信・Cloudflare・Cloud Run などブラウザだけで開く形態、「アプリ版」はローカル Rust サーバー（kasugai_canvas.exe）で動かす形態です。AI チャット本体・地図操作・コード実行・プラグイン生成はどちらでも使え、アプリ版には永続化・共有・システムに触れる高権限機能とローカルブリッジの自動起動があります。

【ブリッジ】系統（GitHub Copilot・Devin・Antigravity・外部エージェント）の設定手順・ブリッジハブ構成（待受ポート・CLI 要件・環境変数）は 【ブリッジ】外部エージェント連携 に集約しています。

AI プロバイダの2系統（【API】と【ブリッジ】）

「AI プロバイダ」の選択肢は名前の先頭の接頭辞で2系統に分かれます。入力方法も動作モデルも異なるため、目的に応じて選びます。

どちらを選んでもチャット UI・地図操作・runCode・破壊的操作の確認ダイアログは共通です。ブリッジ系を選んだ場合のみ「エンドポイントURL・トークン・BYOキー送信」のブリッジ欄が表示され、GitHub Copilot / Devin / Antigravity ではさらにモデル選択と疎通ステータスが表示されます。

🔑 API キー管理

Gemini キーは Google AI Studio、Maps キーは Google Cloud Console で発行。キーは localStorage にのみ保存され、.kasc エクスポートには含まれません。発行したキーは 管理（⚙）→ AI → チャット（Gemini）・管理（⚙）→ Google Maps（Maps キー）で設定します。

Google Cloud で有効化・キー制限への追加が必要な API:

• Map Tiles API — Photorealistic 3D Tiles
• Geocoding API — 検索プロバイダ「Google」（ハイブリッド検索の住所側）
• Places API (New) — ハイブリッド検索の施設・キーワード側 / AIツール searchPlaces
• Street View Static API — Street View のメタデータ確認（「SV」ボタン・地図クリック・AIツール openStreetView。パノラマ自体は Google マップを別タブで開くだけなので API 不要）

Geocoding / Places / Street View の Web サービス API は HTTP リファラー制限付きキーを拒否します。リファラー制限をかけたい場合は「Web サービス用キー」欄に制限なしの別キーを設定してください（Map Tiles API のみリファラー制限が有効なので、上の「Maps API キー」に制限付きキーを入れる運用が可能です）。Street View 候補ラインは Google マップ内部のカバレッジデータ（キー不要・非公式）を使用します

サーバー配布（BYO 不要化）：バックエンド（Cloud Run・Cloudflare Pages/Workers）のシークレットに GOOGLE_MAPS_API_KEY を設定すると、/api/capabilities が google.mapsApiKey を通知し、ブラウザに Maps キーが未保存の場合に自動登録します。訪問者は何も入力せずに Maps 系機能を使えます（BYO キーが保存済みならそちらが優先）。Maps キーはタイル URL 等に埋め込まれる設計上の公開キーなので、保護は秘匿ではなく GCP コンソールの HTTP リファラ制限（https://<配信ドメイン>/*）で行ってください

OpenAI互換エンドポイントの設定

「AI プロバイダ」で「OpenAI互換」を選ぶと、GitHub Models（GitHub PAT）・OpenAI・Azure OpenAI・Ollama・LM Studio など chat/completions 互換エンドポイントに、ベースURL・キー・モデル名を指定して接続できます（ブラウザから直接接続するため、エンドポイント側の CORS 許可が必要です）。「接続プリセット」で主要サービスのベースURLを自動入力でき、「モデル一覧を取得」ボタンは {ベースURL}/models をブラウザから取得して接続・キー・CORS の疎通確認を行い、取得したモデル ID をモデル欄の選択肢へ反映します。さくらのAI Engine は専用プロバイダ「【API】さくらAIEngine」として用意されており、エンドポイント（https://api.ai.sakura.ad.jp/v1）固定でアカウントトークンとモデルだけを設定します（OpenAI互換側にさくら向け設定が残っていた場合は初回起動時に自動移行されます）。GitHub Copilot 契約を使いたい場合は 【ブリッジ】外部エージェント連携 を参照してください。

ローカルサーバー版の独自API（公開環境では無効）

GET  /api/capabilities   → {"tier":"local","features":["fetchProxy","pluginWrite","fileWrite",...]}
GET  /api/fetch?url=...  → CORS回避のGETプロキシ（http/httpsのみ・30秒・20MB上限）
POST /api/mcp?url=...    → リモート MCP サーバーへの中継プロキシ
                           （Workers/Cloud Run にも同パスあり。Authorization・
                           セッションヘッダ・ボディをそのまま転送。
                           SSRF 制限は /api/fetch と同じ・応答32MB上限）
POST /api/plugins        → {"id","name","version","description","layer","code"}
                           PLUGIN/<id>/plugin.js・manifest.json を作成し plugins.json に登録
DELETE /api/plugins/{id} → プラグインの公開取り消し（PLUGIN/<id>/ と plugins.json 登録を削除）
GET  /api/files?project= → projects/<project>/DATA/ 内のファイル一覧（{name,size,modified}[]）
PUT  /api/files/{project}/{path} → DATA/ へボディを書き込み（サブフォルダ可・64MB上限）
DELETE /api/files/{project}/{path} → DATA/ 内のファイルを削除

プラグインIDは半角英数・-・_ のみ（64文字まで）。公開・削除は実ファイルを書き換えるため、フロント側では必ず確認ダイアログが出ます。公開環境（Pages/Workers）に同等の無認証書き込みAPIを置かないでください。