diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..21d66fd
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,42 @@
+# ============================================================
+# PromptCR-Lab 环境变量模板
+# 用法：cp .env.example .env 后填入真实密钥
+# 注意：.env 已被 git 忽略，切勿提交；shell export 的变量优先级高于本文件
+# ============================================================
+
+# --- 数据库 ---
+# Docker 部署（PostgreSQL 容器）：
+DATABASE_URL=postgresql+psycopg://postgres:postgres@localhost:5432/promptcr
+# 本地开发（SQLite 单文件，免装数据库）请改为：
+# DATABASE_URL=sqlite:///./promptcr.db
+
+# --- DeepSeek ---
+# 官方直连：
+DEEPSEEK_API_KEY=
+DEEPSEEK_BASE_URL=https://api.deepseek.com/v1
+DEEPSEEK_MODEL=deepseek-chat
+# 中转站（OpenAI 兼容）示例：
+# DEEPSEEK_BASE_URL=https://new-api.onemue.cn/v1
+# DEEPSEEK_MODEL=deepseek-v4-flash
+
+# --- Kimi（Moonshot） ---
+# 官方直连：
+KIMI_API_KEY=
+KIMI_BASE_URL=https://api.moonshot.cn/v1
+KIMI_MODEL=moonshot-v1-8k
+# 中转站示例：
+# KIMI_BASE_URL=https://new-api.onemue.cn/v1
+# KIMI_MODEL=kimi-k2.7
+
+# --- QWEN（通义千问） ---
+# 官方直连：
+QWEN_API_KEY=
+QWEN_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
+QWEN_MODEL=qwen-turbo
+# 中转站示例（本论文实验实际接入 GLM-4.7）：
+# QWEN_BASE_URL=https://new-api.onemue.cn/v1
+# QWEN_MODEL=glm-4.7
+
+# --- 调度参数（可选，默认值已够用） ---
+# DEFAULT_MODEL_CONCURRENCY=5
+# DEFAULT_MAX_RETRIES=3
diff --git a/.gitignore b/.gitignore
index 1e21c9b..ab4369a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,6 +1,7 @@
 # Environment variables and secrets
 .env
 .env.*
+!.env.example
 *.pem
 *.key
 *.p12