跳转到主要内容
应用的所有服务端配置都通过环境变量完成。本地开发使用 .env.local，Docker 部署使用 .env.production，Vercel 在项目的 Settings → Environment Variables 中配置。

​
环境变量

DEEPSEEK_API_KEY 和 GEMINI_API_KEY 至少填写一个。两个都不填时，访客必须在设置中填写自己的 Key 才能使用，首页的今日一句也会改用内置备用句。
完整示例：
.env.production

​
模型服务商

应用通过 OpenAI 兼容的 Chat Completions 接口调用模型。 服务端会根据服务商自动调整请求参数：
  • DeepSeek：使用 json_object 格式返回结构化结果，并关闭思考模式。
  • Gemini：使用严格的 JSON Schema 返回结构化结果。gemini-flash-latest 使用 low 推理档，gemini-flash-lite-latest 使用 minimal 推理档。

​
使用自定义接口地址

如果你通过代理或兼容网关访问模型服务商，可以设置 DEEPSEEK_API_URL 或 GEMINI_API_URL。地址必须是完整的 Chat Completions 端点，而不是 Base URL。
接口地址只能在服务器环境变量中配置。浏览器请求中携带自定义 API URL 时，服务端会直接拒绝，以防止应用被当作任意地址的转发代理。

​
请求超时

​
访问密码

设置 CODE 后，访客打开网站时需要先输入访问密码。
  • 验证通过后，服务端写入一个 HttpOnly 会话 Cookie ja_session，有效期 7 天。
  • 会话令牌使用 CODE 作为密钥进行 HMAC-SHA256 签名。修改 CODE 后，所有已登录的会话立即失效。
  • 未通过验证时，解析、翻译、释义、图片识别、朗读、聊天和今日一句等接口都会返回 401。
  • 生产环境中 Cookie 带有 Secure 标记，需要通过 HTTPS 访问。
CODE 适合简单的私有部署，用来防止陌生人消耗你的 API 额度。它不能替代完整的账户和权限系统。

​
Umami 统计

同时填写以下两个变量后，应用会加载 Umami 统计脚本：
任意一个为空时，应用不加载 Umami。两个变量由服务端在运行时读取，修改后重启服务即可生效，Docker 部署无需重新构建镜像。 统计只记录功能用量，不记录任何内容。详见密钥与隐私。