數據工作室

由 src/data-studio/config.ts 的 dsConfig() 讀取。大多數在調用時讀取，因此開關無需重啟即生效；MAX_PAGE_BYTES 和 MAX_VERSIONS 在啟動時讀取（page-write 工具 + store 接線），因此改動它們需要重啟。這些值也在 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

作用: 在服務端注入 provider 密鑰並計量調用的公共數據代理。關閉時代理返回 503，儀表盤顯示「數據已暫停」狀態；託管與編寫仍可正常工作。
消費方: 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 route).
默認值: 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 (reserved gate).
默認值: false。
格式: 1/true/yes/on 啟用，0/false/no/off 禁用。
設置歸屬: 設置 → 偏好（schema 鍵）

`DATA_STUDIO_PKG_MANAGER`

DATA_STUDIO_PKG_MANAGER

作用: 由哪個包管理器引導編譯儀表盤的共享 Vite/React 工具鏈。默認自動檢測（依次 pnpm、npm、yarn、bun）；設置此項可強制指定。
消費方: 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

作用: 單次儀表盤編譯（vite build）的時間上限。超過此值的構建會被終止並報告為構建錯誤。
消費方: src/data-studio/build-runner.ts (via dsConfig at boot).
默認值: 90000（90s）。
格式: 正整數（毫秒），最小值 1000。
設置歸屬: 設置 → 偏好（schema 鍵）

`DATA_STUDIO_MAX_WATCHERS`

DATA_STUDIO_MAX_WATCHERS

作用: 同時運行多少個實時預覽構建 watcher（LRU；空閒項目會被淘汰）。這是對長期運行的構建進程的資源上限。
消費方: src/data-studio/build-runner.ts (via dsConfig at boot).
默認值: 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

作用: 每個 page-token 每分鐘允許的代理請求數。該 token 是公開的（寫入頁面中），因此此項限制濫用。緩存命中不計入。
消費方: src/data-studio/config.ts ProxyRateLimiter.
默認值: 120。
格式: 正整數。
設置歸屬: 設置 → 偏好（schema 鍵）

`DATA_STUDIO_PROXY_DAILY_CAP`

DATA_STUDIO_PROXY_DAILY_CAP

作用: 每個 page-token 每天允許的代理請求數。
消費方: src/data-studio/config.ts ProxyRateLimiter.
默認值: 5000。
格式: 正整數。
設置歸屬: 設置 → 偏好（schema 鍵）

`DATA_STUDIO_PROXY_CACHE_TTL_SEC`

DATA_STUDIO_PROXY_CACHE_TTL_SEC

作用: 對於相同的（source + path + params）讀取，代理在從內存返回多久後才向上遊重新拉取。為繁忙或被廣泛分享的儀表盤削減 provider 負載與配額消耗。
消費方: src/data-studio/config.ts ProxyCache.
默認值: 5。
格式: 正整數（秒）；0 禁用緩存。
設置歸屬: 設置 → 偏好（schema 鍵）

`DATA_STUDIO_VERIFY_PREVIEW`

DATA_STUDIO_VERIFY_PREVIEW

作用: Data Studio 是否在構建成功後以桌面和移動端尺寸自動運行無頭瀏覽器預覽校驗。啟用時，儀表盤只有在構建通過、且託管預覽加載時沒有頁面錯誤、未處理的 promise rejection、應用 console.error 記錄、圖表或視覺錯誤、頁面級溢出或新的 runtime-log 錯誤時，才視為完成。
消費方: 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 鍵）