docs: clarify environment configuration

This commit is contained in:
Wenxin Duan
2026-09-08 22:51:20 +08:00
parent ba45382747
commit 9f247d22b2
+8 -9
View File
@@ -69,7 +69,6 @@ docs 架构、安全、事件、课堂演示和生产路线
```bash ```bash
pnpm install pnpm install
cp .env.example .env
pnpm dev pnpm dev
``` ```
@@ -79,15 +78,15 @@ Web 默认地址是 `http://127.0.0.1:5173`,Fastify 默认监听 `http://127.0
模型解析优先级为:当前 Session 的 Settings 配置、服务器环境变量、明确的 `MODEL_NOT_CONFIGURED` 错误。没有“第一个可用模型”的隐式回退。 模型解析优先级为:当前 Session 的 Settings 配置、服务器环境变量、明确的 `MODEL_NOT_CONFIGURED` 错误。没有“第一个可用模型”的隐式回退。
环境变量示例: `.env.example` 是变量清单;服务端只读取启动进程的环境,不会自动加载 `.env`。可以由 shell、IDE 或进程管理器注入,例如:
```dotenv ```bash
AGENT_PROVIDER=openai export AGENT_PROVIDER=openai
AGENT_MODEL=gpt-5-mini export AGENT_MODEL=gpt-5-mini
LLM_API=openai-responses export LLM_API=openai-responses
OPENAI_API_KEY= export OPENAI_API_KEY='your-key'
LLM_BASE_URL= export AGENT_MODEL_SUPPORTS_IMAGES=true
AGENT_MODEL_SUPPORTS_IMAGES=true pnpm dev
``` ```
Anthropic 使用 `AGENT_PROVIDER=anthropic`、`LLM_API=anthropic-messages` 和 `ANTHROPIC_API_KEY`。自定义兼容服务可设置 `LLM_BASE_URL`;默认仅接受安全的 HTTPS 地址,开发环境可接受 localhost,内网地址仅在明确设置 `ALLOW_PRIVATE_LLM_BASE_URLS=true` 后允许。 Anthropic 使用 `AGENT_PROVIDER=anthropic`、`LLM_API=anthropic-messages` 和 `ANTHROPIC_API_KEY`。自定义兼容服务可设置 `LLM_BASE_URL`;默认仅接受安全的 HTTPS 地址,开发环境可接受 localhost,内网地址仅在明确设置 `ALLOW_PRIVATE_LLM_BASE_URLS=true` 后允许。