KASUGAI Canvas v6.17.0

1. 📋 概要

KASUGAI Canvas は、AI とマルチエンジンで拓く 2D/3D GIS です。CesiumJS + Three.js（メイン・3D）を核に、MapLibre / OpenLayers / Leaflet / GSI Maps の互換プレイヤーと試験的エンジン Navara が同じ .kasc プロジェクトを再生するマルチエンジン構成を採り、AI チャット（Gemini / OpenAI互換 の内蔵AI、GitHub Copilot・Devin・Antigravity のブリッジ連携）で地図を操作できます。Re:Earth GeoSuite と上位互換の GIS 基本機能に加え、KASUGAI 独自の FLY 機能を備えています。

v3.4.2 以降、地図タイル・検索・レイヤー取得は CesiumJS が直接行い、Rust サーバーはバージョン管理・シャットダウン・ヘルスチェック API のみ提供します。

2. 🌐💻 マルチエンジン — ブラウザ WebGIS とローカルアプリ

マルチエンジン構成（Cesium＋4互換プレイヤー＋試験的 Navara）の利用形態は2系統です。メインはインストール不要のブラウザ WebGIS（CDN エンジン × 外部ホストの .kasc）、フル機能が必要な場合はローカルアプリを使います。

3. 🤖 AI — API 直通とブリッジ経由

AI チャットはどちらの利用形態でも使えます。接続系統は2系統で、プロバイダ名の接頭辞【API】/【ブリッジ】がそのまま系統を示します。メインは公式 API へブラウザから直接繋ぐ内蔵AI、既存の AI 契約や自作エージェントを繋ぐ場合はブリッジ経由を使います。

どちらの系統でもチャット UI・地図操作・runCode サンドボックス・MCP データソース（Box 等）・AI プラグイン生成は共通です。ハブはアプリ版・ブラウザ WebGIS 共通の bridge-hub.exe 1本（127.0.0.1:8511）に集約しており、フロントは /health で検出して接続するため、CDN 経由のブラウザ WebGIS からもブリッジ系プロバイダが選べます。逆方向の「外部 → ブラウザを操る」はローカルアプリ本体 :8510 の /api/command 経路です。

設定手順は 【API】内蔵AI・【ブリッジ】外部エージェント連携（接続方式ごとの規約判断もこちら）、52ツールの引数・提供条件は AI ツール仕様 を参照してください。

4. 🔗 連携構成図 — どこで動くか

KASUGAI Canvas は エンジン（プレイヤー本体）とデータ（.kasc + DATA/）が分離した設計です。開発の起点は kasugai_canvas リポジトリの web/（エンジン正本）で、そこから GitHub Pages CDN（kasugai-canvas-web） と 配布 ZIP（ローカルアプリ） の2経路で発行されます。メインの使い方は、CDN が配信するエンジンに静的ホスト上の .kasc を ?kasc= で指定して開く サーバレスな WebGIS です（インストール不要）。

flowchart TB
  REPO["kasugai_canvas リポジトリ（開発の起点）
web/ = エンジン正本 ＋ server/ = Rust アプリ"]

  REPO ==>|"tools/publish_cdn.py"| CDN["GitHub Pages CDN（メイン）
kasugai-canvas-web
stable/・unstable/
cesium / maplibre / openlayers / leaflet / gsimaps / navara(試験)"]
  REPO ==>|"run.py -B → ZIP（自動更新）"| APP["ローカルアプリ
kasugai_canvas.exe :8510
フル機能（QGIS連携・保存・rclone・AIブリッジ）"]
  UP["vendor 上流オリジナル
jsdelivr / raw.githubusercontent
（各 engine の vendor.json でピン）"]
  UP -.->|"vendor/*（gsimaps・navara）
SW が同一オリジン中継"| APP
  UP -.->|"vendor/*（gsimaps・navara）
SW が同一オリジン中継"| WEB

  QGIS["QGIS + geo_webview"] -->|"エクスポート"| DATA[".kasc + DATA/ のみ配置
任意の静的ホスト or :8089
（エンジンは CDN 経由）"]

  CDN ==>|"エンジンを配信"| WEB["ブラウザ WebGIS（メインの利用形態）
…/<engine>/?kasc=<.kascのURL>
CDN 経由ならインストール不要"]
  DATA -.->|"?kasc= で指定"| WEB
  QGIS -.->|"▶ Canvas で登録"| APP

  AGENTS["外部エージェント
GitHub Copilot / Devin / Antigravity
要各CLI・本人認証"] ==>|"AI が地図を制御
（reply/actions を返す）"| BRIDGE["AIブリッジハブ bridge-hub.exe
アプリ・WebGIS 共通 =8511
チャット ─POST /agent {provider,...}→
選択中プロバイダのみ内部起動"]
  APP ---|"起動時に未起動なら自動起動（内蔵なし）"| BRIDGE
  CDN -.->|"download/bridge-hub.exe(.zip) を配信"| BRIDGE
  BRIDGE -.->|"同一PCなら /health 検出（:8511）で接続"| WEB
  AIAPI["AI API（内蔵AI）
Gemini / OpenAI互換
BYOキー or /api/gemini キー隠蔽プロキシ
（workers・Cloud Run・ローカル）"] ==>|"AI が地図を制御
（function calling）"| WEB

  WEB --- DEMO["公開デモ（WebGIS の実例）
CDNホスト版＝CDN経由
Cloudflare Pages / Workers / Cloud Run
＝web/自前配信＋認証・/api/*"]

  classDef webgis fill:#eef0ff,stroke:#667eea,color:#1a2230
  classDef localapp fill:#e9f7ee,stroke:#2e9e56,color:#1a2230
  classDef ai fill:#f4eaff,stroke:#8a4fff,color:#1a2230
  classDef neutral fill:#f6f8fa,stroke:#9aa5b1,color:#5a6577
  class WEB,CDN webgis
  class APP localapp
  class BRIDGE,AGENTS,AIAPI ai
  class QGIS,DATA,DEMO neutral
        

実行時の供給元 — 何をどこから読むか

web/ 一式は publish_cdn.py が CDN へ丸ごとミラーするため、shared/ 等の同じファイルが CDN と配布物（ZIP・インストーラー）の両方に存在します。どちらを読むかは開いているページのオリジンで決まります（エンジンコードは全て相対パス参照）。外部を参照するのは /vendor/*（gsimaps・navara）のみで、実体はどこにも置かず Service Worker（vendor-proxy-sw.js＝vendor 同一オリジン中継・SW 制御）が vendor.json のピン先（jsdelivr・raw.githubusercontent）からどのオリジンでも同一オリジン供給します（Service Worker 前提）。

再生 URL …/<stage>/<engine>/?kasc=<.kascのURL> の意味:

静的ホストへ .kasc+DATA/ だけを置く通常の WebGIS 配信では、エンジンは常に CDN（kasugai-canvas-web）から読み込まれます。機能面ではローカルアプリだけがフル機能（QGIS連携・ファイル保存・rclone・ブリッジハブの自動起動）を持ちます。AI の接続系統とブリッジハブの構成（:8511 に一本化・bridge-hub.zip）は「3. AI — API 直通とブリッジ経由」にまとめています。CDN 経由はブラウザ閲覧中心です。なおローカルアプリも vendored 地理院地図（gsimaps vendor・約75MB）は同梱せず、/vendor/* のミスを Service Worker が上流オリジナル（vendor.json のピン先 CDN）へ中継して同一オリジン供給します。さらに描画ライブラリ（CesiumJS・Leaflet・MapLibre・OpenLayers・DuckDB-WASM 等）は jsdelivr/unpkg から読み込むため、配布形態に関わらずブラウザ実行は常にオンライン前提です（試験的エンジン Navara は Worker の同一オリジン要件から vendor/navara/ 同梱 dist を使用）。公開デモはいずれもこの WebGIS の実例で、Cloudflare Pages/Workers・Cloud Run 版は web/ を自前配信し認証・/api/* を付加した構成です（基本の配布経路は CDN + 配布 ZIP の2系統）。データの配信元は静的ホストのほか、QGIS 側の geo_webview 内蔵サーバー（127.0.0.1:8089 /export-data/）からも読めます（自分の PC 上のみ有効）。詳細は kasugai-canvas-web ガイド を参照してください。

5. 📚 ドキュメント

マルチエンジン — WebGIS / ローカルアプリ

AI — API / ブリッジ

仕様・技術選定

拡張・連携

記録（挑戦中）

挑戦中のイベントのみ掲載しています。終了したイベントは終了したイベントの記録にまとめています。