diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..7769110
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,5 @@
+# 微信小程序配置（真实微信登录）
+# 复制本文件为 server/.env 并填入真实值；或直接在部署环境设置环境变量。
+# 获取方式：微信公众平台 mp.weixin.qq.com → 开发 → 开发管理 → 开发设置 → AppID / AppSecret
+WX_APPID=你的小程序AppID
+WX_SECRET=你的小程序AppSecret
diff --git a/.gitignore b/.gitignore
index 65b9366..21ddf1d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -11,9 +11,10 @@ wheels/
 # Virtual environments
 .venv
 
-# Credentials（微信 AppID/Secret 等，勿提交）
+# Credentials（微信 AppID/Secret 等，勿提交；.env.example 是模板，需提交）
 .env
-.env.*
+.env.local
+*.local
 *.local
 
 # Runtime data: JSON "database" files are generated on first boot from