データスタジオ

データスタジオ（Data Studio、対話で作るリアルタイムデータダッシュボード）

src/data-studio/config.ts の dsConfig() が読み込みます。ほとんどは呼び出し時に読まれるため、トグルは再起動なしで反映されます。MAX_PAGE_BYTES と MAX_VERSIONS は起動時に読まれる(ページ書き込みツール + ストアの配線)ため、変更するには再起動が必要です。これらの値は Settings → Preferences の Data Studio の下にも表示され、ローカル運用者が env ファイルを直接編集せずにダッシュボードのランタイムをチューニングできます。

`DATA_STUDIO_ENABLED`

DATA_STUDIO_ENABLED

制御対象: Data Studio モジュール全体。オフのとき、すべての /v1/data-studio/* ルート、/studio/p/* のホストページ、データプロキシが停止し（503 / 404）、ナビゲーションのエントリーは不活性になります。
使用箇所: src/gateway/api.ts（routeDataStudio、handleDataStudioHost、handleDataStudioProxy）。
デフォルト: true（有効）。
形式: 1/true/yes/on で有効化、0/false/no/off で無効化します。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_PROXY_ENABLED`

DATA_STUDIO_PROXY_ENABLED

制御対象: プロバイダーキーをサーバーサイドで注入し、呼び出しを計測する公開データプロキシ。オフのとき、プロキシは 503 を返し、ダッシュボードは「data paused」状態を表示します。ホスティングとオーサリングは引き続き機能します。
使用箇所: src/gateway/api.ts の handleDataStudioProxy。
デフォルト: true（有効）。
形式: 1/true/yes/on で有効化、0/false/no/off で無効化します。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_PUBLISH_ENABLED`

DATA_STUDIO_PUBLISH_ENABLED

制御対象: ダッシュボードを公開の共有可能なリンクに公開できるかどうか。オフのとき、公開は拒否され（403）、アプリ内のプライベートページのみが存在します。すでに公開されているページは引き続き解決されます。
使用箇所: src/gateway/api.ts の routeDataStudio（publish ルート）。
デフォルト: true（有効）。
形式: 1/true/yes/on で有効化、0/false/no/off で無効化します。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_ALLOW_PUBLIC_CUSTOM_SOURCES`

DATA_STUDIO_ALLOW_PUBLIC_CUSTOM_SOURCES

制御対象: 公開（パブリック）ページが、プロジェクト独自のカスタム外部データソースを使えるかどうか。完全な SSRF 対策が導入されるまではオフのままです。プロジェクトのカスタムソースはまだ配線されていないため、これは不活性です。
使用箇所: src/data-studio/config.ts（予約済みゲート）。
デフォルト: false。
形式: 1/true/yes/on で有効化、0/false/no/off で無効化します。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_PKG_MANAGER`

DATA_STUDIO_PKG_MANAGER

制御対象: ダッシュボードをコンパイルする共有 Vite/React ツールチェーンをブートストラップするパッケージマネージャー。既定では自動検出されます（pnpm、次に npm、yarn、bun）。1 つに強制するにはこれを設定します。
使用箇所: src/app.ts（build runner）、src/data-studio/build-runner.ts。
デフォルト: 空（自動検出）。
形式: pnpm | npm | yarn | bun のいずれか。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_BUILD_TIMEOUT_MS`

DATA_STUDIO_BUILD_TIMEOUT_MS

制御対象: 1 つのダッシュボードのコンパイル（vite build）の制限時間。これを超えるビルドは kill され、ビルドエラーとして報告されます。
使用箇所: src/data-studio/build-runner.ts（起動時の dsConfig 経由）。
デフォルト: 90000（90 秒）。
形式: 正の整数（ミリ秒）、最小 1000。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_MAX_WATCHERS`

DATA_STUDIO_MAX_WATCHERS

制御対象: 同時に実行するライブプレビューのビルド watcher の数（LRU。アイドルのプロジェクトは退避されます）。長命のビルドプロセスに対するリソース上限。
使用箇所: src/data-studio/build-runner.ts（起動時の dsConfig 経由）。
デフォルト: 3。
形式: 正の整数。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_MAX_CONCURRENT_BUILDS`

DATA_STUDIO_MAX_CONCURRENT_BUILDS

制御対象: 異なるプロジェクトで同時実行できる本番ビルド数の上限です。同一プロジェクトは FIFO のままで、同一ビルドは統合されます。
使用箇所: src/data-studio/build-scheduler.ts（Gateway 起動時に dsConfig 経由で読み込み）。
デフォルト: 自動：clamp(floor((availableParallelism - 2) / 2), 1, 3)。
形式: 正の整数。未設定時はデスクトップ CPU に合わせて自動計算します。
設定の所在: ユーザー向け設定ではありません

`DATA_STUDIO_MAX_CONCURRENT_VERIFICATIONS`

DATA_STUDIO_MAX_CONCURRENT_VERIFICATIONS

制御対象: 同時実行できるヘッドレスブラウザー検証数です。本番ビルド上限以下かつ最大 2 に制限されます。
使用箇所: src/data-studio/build-scheduler.ts（Gateway 起動時に dsConfig 経由で読み込み）。
デフォルト: 1。
形式: 正の整数。有効範囲は 1〜2 です。
設定の所在: ユーザー向け設定ではありません

`DATA_STUDIO_MIN_POLL_INTERVAL_SEC`

DATA_STUDIO_MIN_POLL_INTERVAL_SEC

制御対象: ダッシュボードが計測対象のデータソースをリフレッシュできる頻度の下限。これより速いバインディングはこの値にクランプされ、頻繁にリフレッシュすることがユーザーに伝わるようフラグが立てられます。
使用箇所: src/tools/data-studio.ts、src/data-studio/host.ts（データ SDK が読み取る、注入された window.STUDIO 設定）。
デフォルト: 5。
形式: 正の整数（秒）。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_PROXY_RATE_PER_MIN`

DATA_STUDIO_PROXY_RATE_PER_MIN

制御対象: ページトークンごとに 1 分あたりに許可されるプロキシリクエスト数。トークンは公開されている（ページに書き込まれる）ため、これが悪用に上限を設けます。キャッシュヒットはカウントされません。
使用箇所: src/data-studio/config.ts の ProxyRateLimiter。
デフォルト: 120。
形式: 正の整数。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_PROXY_DAILY_CAP`

DATA_STUDIO_PROXY_DAILY_CAP

制御対象: ページトークンごとに 1 日あたりに許可されるプロキシリクエスト数。
使用箇所: src/data-studio/config.ts の ProxyRateLimiter。
デフォルト: 5000。
形式: 正の整数。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_PROXY_CACHE_TTL_SEC`

DATA_STUDIO_PROXY_CACHE_TTL_SEC

制御対象: 同一の（ソース + パス + パラメーター）読み取りを、上流に再取得する前にプロキシがメモリから提供する期間。ビジーな、または広く共有されるダッシュボードのプロバイダー負荷とクォータを削減します。
使用箇所: src/data-studio/config.ts の ProxyCache。
デフォルト: 5。
形式: 正の整数（秒）。0 でキャッシュを無効化します。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_VERIFY_PREVIEW`

DATA_STUDIO_VERIFY_PREVIEW

制御対象: Data Studio が、ビルド成功後にデスクトップとモバイルのサイズでヘッドレスブラウザのプレビュー検証を自動実行するかどうか。有効なとき、ダッシュボードは、ビルドが通り、かつホストされたプレビューがページエラー、未処理の promise 拒否、アプリケーションの console.error エントリー、チャートまたはビジュアルのエラー、ページレベルのオーバーフロー、新たなランタイムログエラーなしで読み込まれるまで、完了とはみなされません。
使用箇所: src/tools/data-studio.ts の data_studio_build と data_studio_verify_preview。
デフォルト: true。
形式: 1/true/yes/on で有効化、0/false/no/off で無効化します。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_VERIFY_BASE_URL`

DATA_STUDIO_VERIFY_BASE_URL

制御対象: ヘッドレスプレビュー検証が使う gateway の origin。空のままにすると http://127.0.0.1:$\{GATEWAY_PORT:-8080\} を推論します。
使用箇所: src/data-studio/config.ts の dataStudioVerifyBaseUrl。
デフォルト: 空（ローカル gateway URL を推論）。
形式: 絶対 HTTP(S) origin、パスなし。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_VERIFY_TIMEOUT_MS`

DATA_STUDIO_VERIFY_TIMEOUT_MS

制御対象: 1 回のプレビュー検証実行に対する Playwright のナビゲーションタイムアウト。
使用箇所: src/data-studio/runtime-verify.ts。
デフォルト: 10000。
形式: 正の整数（ミリ秒）、最小 1000。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_VERIFY_SETTLE_MS`

DATA_STUDIO_VERIFY_SETTLE_MS

制御対象: プレビュー検証の判定が返される前に、非同期のアプリエラーが表面化するための DOMContentLoaded 後の追加時間。
使用箇所: src/data-studio/runtime-verify.ts。
デフォルト: 1500。
形式: 整数のミリ秒、0 以上。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_RUNTIME_FIX_MAX_ATTEMPTS`

DATA_STUDIO_RUNTIME_FIX_MAX_ATTEMPTS

制御対象: 残りのランタイムエラーを返す前に Agent が試みるべき build -> verify -> fix のラウンドの既定回数。
使用箇所: src/tools/data-studio.ts の data_studio_verify_preview の結果。
デフォルト: 6。
形式: 正の整数。DATA_STUDIO_RUNTIME_FIX_ATTEMPT_HARD_CAP でクランプされます。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_RUNTIME_FIX_ATTEMPT_HARD_CAP`

DATA_STUDIO_RUNTIME_FIX_ATTEMPT_HARD_CAP

制御対象: ランタイム修正ループのオペレーターハードキャップ。不正なプロンプトやアプリが無制限の検証サイクルを実行するのを防ぎます。
使用箇所: src/data-studio/config.ts の dsConfig()。
デフォルト: 10。
形式: 正の整数。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_POLISH_REVISION_BUDGET`

DATA_STUDIO_POLISH_REVISION_BUDGET

制御対象: 検証を通過したダッシュボードに対してエージェントがさらに何回手を入れられるか。その後はビルド結果が納品を促す。ユーザーメッセージ単位で数え、新しい依頼で最初に戻る。
使用箇所: src/tools/data-studio.ts data_studio_build の結果。
デフォルト: 2。
形式: 0 以上の整数。0 は最初に検証を通過した時点で納品。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_RUNTIME_LEARNING_ENABLED`

DATA_STUDIO_RUNTIME_LEARNING_ENABLED

制御対象: Data Studio が、プレビューのランタイム失敗と回復を Data Studio のランタイムレッスンストアに記録するかどうか。
使用箇所: src/data-studio/runtime-verify.ts とプロンプト組み立て。
デフォルト: true。
形式: 1/true/yes/on で有効化、0/false/no/off で無効化します。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_RUNTIME_LESSON_INJECT_LIMIT`

DATA_STUDIO_RUNTIME_LESSON_INJECT_LIMIT

制御対象: 生成プロンプトに注入される Data Studio ランタイムレッスンの最大数。アクティブなレッスンは最近の候補より優先されます。
使用箇所: src/data-studio/project-store.ts のプロンプトレンダリング。
デフォルト: 5。
形式: 整数、0 以上。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_RUNTIME_LESSON_PROMOTE_SUCCESSES`

DATA_STUDIO_RUNTIME_LESSON_PROMOTE_SUCCESSES

制御対象: 候補レッスンがアクティブに自動昇格する前の、同一ランタイムフィンガープリントに対する成功した回復の回数。
使用箇所: src/data-studio/project-store.ts の markRuntimeRecovered。
デフォルト: 2。
形式: 正の整数。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_PREFERENCE_LEARNING_ENABLED`

DATA_STUDIO_PREFERENCE_LEARNING_ENABLED

制御対象: Data Studio が、今後のプロンプトのためにユーザーのダッシュボードの言い回し、コンポーネントの選択、可視化の習慣、データの習慣を観察するかどうか。
使用箇所: src/app/plugins.ts とプロンプト組み立て。
デフォルト: false。
形式: 1/true/yes/on で有効化、0/false/no/off で無効化します。
設定の所在: 設定 → 環境設定（schema キー）

`DATA_STUDIO_PREFERENCE_INJECT_LIMIT`

DATA_STUDIO_PREFERENCE_INJECT_LIMIT

制御対象: 新しいダッシュボード生成の前に注入される Data Studio 設定メモリの最大数。関連性、新しさ、アクティブ状態でランク付けされます。
使用箇所: src/data-studio/project-store.ts のプロンプトレンダリング。
デフォルト: 6。
形式: 整数、0 以上。
設定の所在: 設定 → 環境設定（schema キー）

`BEHAVIOR_MEMORY_ENABLED` / `BEHAVIOR_MEMORY_CAPTURE_ENGAGEMENT` / `BEHAVIOR_MEMORY_CAPTURE_FEATURE_USAGE` / `BEHAVIOR_MEMORY_CAPTURE_CONFIGURATION` / `BEHAVIOR_MEMORY_CAPTURE_AUTOMATION` / `BEHAVIOR_MEMORY_CAPTURE_STRATEGY` / `BEHAVIOR_MEMORY_CAPTURE_FINANCIAL_CONTEXT` / `BEHAVIOR_MEMORY_CAPTURE_TRANSACTION` / `BEHAVIOR_MEMORY_CAPTURE_CONVERSATION` / `BEHAVIOR_REFLECTION_ENABLED` / `BEHAVIOR_REFLECTION_INCLUDE_IN_MEMORY` / `BEHAVIOR_REFLECTION_CUSTOM_PROMPT` / `BEHAVIOR_MEMORY_RAW_RETENTION_DAYS` / `BEHAVIOR_MEMORY_MAX_MB` / `BEHAVIOR_MEMORY_BATCH_SIZE` / `BEHAVIOR_MEMORY_BATCH_KB` / `BEHAVIOR_MEMORY_FLUSH_MS` / `BEHAVIOR_MEMORY_QUEUE_MAX` / `BEHAVIOR_MEMORY_PRESSURE_FREE_MB` / `BEHAVIOR_MEMORY_CRITICAL_FREE_MB` / `BEHAVIOR_MEMORY_DISK_CHECK_MS`

行動メモリ（ローカルの、粗粒度の製品利用テレメトリー）。マスタースイッチは既定でオフです。マスタースイッチを有効化した後も、機微なキャプチャクラスは明示的にオプトインしない限りオフのままです。

設定の所在: 設定 → 環境設定（schema キー）

目次