1. 概述

环境变量本质上是一组注入到运行时环境里的配置值，用来告诉应用当前该连接什么环境、运行在哪、打开什么能力。它和写死在代码里的常量不同，环境变量的配置可以随着开发、联调、生产环境切换。

这个项目里，环境变量最直接承担两类职责：

• 标记当前业务运行语义，比如 APP_ENV
• 提供外部依赖地址，比如 API_BASE_URL

当前 web 端直接读取 process.env.API_BASE_URL，并带了一个本地回退值。api 侧的 wrangler.jsonc 还没有真正的多环境变量配置，admin 端也还没接入任何环境变量。

所以目标很明确：

• 三端统一环境变量命名
• 同时覆盖 Next.js 服务端和客户端组件
• 显式区分 development、test、production 三种环境
• 去掉页面代码里的硬编码回退地址
• 让 API、Web、Admin 都真正消费同一套环境约定
• 顺带把 zod 收敛到工作区根级 catalog 管理