diff --git a/.agents/rules/ulthon-deploy-environment.md b/.agents/rules/ulthon-deploy-environment.md
index 3e5b3f2..41acfbe 100644
--- a/.agents/rules/ulthon-deploy-environment.md
+++ b/.agents/rules/ulthon-deploy-environment.md
@@ -41,3 +41,13 @@
 2. **非默认端口**——如果修改了框架模板的默认端口（如 HTTP 8000、MySQL 13306、Redis 16379 等），必须记录实际端口。否则智能体调试时（如 `tools:http:call`）会用默认端口连接，导致失败。
 
 目的是让后续会话中的智能体能从规则文件快速了解项目的实际运行方式、命令执行入口和访问地址，而不需要重新询问或猜测。
+
+## 多环境 .env 管理
+
+ThinkPHP 通过仓库根目录的 `.env` 文件读取环境配置（数据库连接、调试开关等）。多环境（测试 / 演示 / 正式等）的做法是：
+
+- 各环境的配置文件都放在仓库根目录，命名为 `.env.<环境>`（如 `.env.test`、`.env.prod`、`.env.demo`）
+- `.env` 是当前生效的文件，不提交到 git（已在 `.gitignore` 中排除）
+- 部署时通过流水线（CI/CD）将目标环境的文件覆盖为 `.env`，例如 `cp .env.prod .env`
+
+代码完全一样，只有 `.env` 不同。