数据工作室

由 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 键）