​

配置说明

核心应用不需要环境变量。只在需要启用某个可选服务时添加对应变量。

​

环境变量

​

浏览器变量

以 VITE_ 开头的变量会被打包进浏览器代码。不要把密钥放进这些变量。 浏览器变量只适合公开配置，例如 Supabase URL、Supabase anon key 和 Stripe publishable key。

​

服务端变量

仅服务端使用的变量需要配置在托管平台中，例如 Netlify environment variables。不要提交 service role key、Stripe secret key、webhook secret 或 AI provider key。 Functions 优先读取不带 VITE_ 的服务端变量，并在迁移期兼容现有的 VITE_SUPABASE_URL、VITE_SUPABASE_ANON_KEY、SUPABASE_SERVICE_ROLE_KEY 和 VITE_STRIPE_PRICE_ID。其中 VITE_STRIPE_PRICE_ID 只作为旧版服务端回退值，浏览器代码不再读取它。

​

功能检测

应用会在运行时检查环境变量：

• Supabase 变量启用登录和云同步。
• Stripe 变量启用支付流程。
• 开放 API Key 依赖 Supabase 和 Netlify Functions；API 配额变量只用于覆盖默认值。
• AI 录入依赖 Supabase、Netlify Functions、AI 录入迁移，以及 OPENROUTER_API_KEY 或 ANTHROPIC_API_KEY。
• 缺少可选变量时，应用保持本地优先模式。

​

Bark 设置

Bark 通知设置在应用界面中配置。用户需要提供 Bark server URL、device key 和提醒时间。