chore(config): 初始化项目配置与部署基础

README.md

@@ -146,6 +146,41 @@ docker compose up --build
 
 当前文档目标已统一为完整 V1 闭环：真实 Chroma RAG、OpenAI 兼容 LLM、OpenAI 兼容 Embedding、工具注册和审计日志。开发阶段可以用测试桩验证页面和边界，但不作为 V1 验收结果。
 
+## 环境变量
+
+项目当前通过 `os.environ` 读取配置，核心变量如下：
+
+```env
+DJANGO_SECRET_KEY=replace-with-a-local-secret-key
+DJANGO_DEBUG=true
+DJANGO_ALLOWED_HOSTS=*
+
+LLM_API_KEY=your_llm_api_key
+LLM_BASE_URL=https://api.openai.com/v1
+LLM_MODEL=gpt-4.1-mini
+
+EMBEDDING_API_KEY=
+EMBEDDING_BASE_URL=
+EMBEDDING_MODEL=text-embedding-3-small
+
+SCENARIO_CONFIG_DIR=configs
+UPLOAD_ROOT=data/uploads
+CHROMA_PATH=data/chroma
+```
+
+说明：
+
+- `EMBEDDING_API_KEY` 为空时，代码会自动复用 `LLM_API_KEY`。
+- `EMBEDDING_BASE_URL` 为空时，代码会自动复用 `LLM_BASE_URL`。
+- `.env.example` 只作为模板，不应填写真实密钥并提交到仓库。
+- 当前代码会在 Django settings 初始化时自动加载根目录 `.env`，本地 `python manage.py runserver`、`pytest` 和 Docker Compose 可以复用同一套配置。
+- Docker Compose 当前在 `docker-compose.yml` 中通过 `env_file` 读取 `.env`。
+
+常见做法：
+
+- 本地开发：复制 `.env.example` 为 `.env`，填入真实参数后运行。
+- Docker 演示：确认 `.env` 已配置后，再执行 `docker compose up --build`。
+
 ## 文档入口
 
 - [V1 总需求文档](docs/需求分析/1.V1总需求文档.md)