跳转到主要内容

配置说明

核心应用不需要任何环境变量即可运行。仅在需要启用可选云服务时按需添加对应变量;仓库根目录提供了 .env.example 模板。

环境变量一览

浏览器变量

所有以 VITE_ 开头的变量都会在构建时注入前端产物,请勿在其中放入任何服务端密钥。 Passkey 通行密钥不需要额外的 VITE_* 变量——只需在 Supabase Dashboard(本地开发为 supabase/config.toml)中启用,详见 Supabase 集成。

服务端变量

服务端变量应配置在托管平台(如 Netlify Environment Variables)中,切勿提交 SUPABASE_SECRET_KEY、STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET 或模型供应商密钥。 Functions 优先读取 SUPABASE_URL、SUPABASE_PUBLISHABLE_KEY、SUPABASE_SECRET_KEY 和 STRIPE_PRICE_ID,同时兼容旧名 VITE_SUPABASE_URL、VITE_SUPABASE_ANON_KEY、SUPABASE_SERVICE_ROLE_KEY 和 VITE_STRIPE_PRICE_ID。

运行时功能检测

应用在运行时按已配置的环境变量启用对应模块:
  • 配置 Supabase 后开启账号登录、Passkey、云同步与账号管理。
  • 配置 Stripe 后开启终身高级版结账与支付状态对账。
  • Developer API Key、/api/v1/* 与 /api/mcp 依赖 Supabase 与 Netlify Functions。
  • AI 录入依赖 Supabase、Netlify Functions、执行至 20260922000100_ai_monthly_quota.sql 的数据库迁移,以及 OPENROUTER_API_KEY 或 ANTHROPIC_API_KEY。
  • 缺少可选变量时,应用自动保持本地优先模式。

Bark 通知设置

Bark 推送参数(服务器地址、device key、提前提醒天数及单条订阅开关)由用户在网页端 设置 → 通知 中自行配置。