From 0e8d3f61d4337cf596bfe1cb71b47af79ad57f2a Mon Sep 17 00:00:00 2001
From: marsal <wangyuhang@sino-assistance.com>
Date: Mon, 13 Jul 2026 14:26:39 +0800
Subject: [PATCH] =?UTF-8?q?docs(agents):=20=E8=A1=A5=E5=85=85=20.env=20?=
 =?UTF-8?q?=E7=8E=AF=E5=A2=83=E5=88=87=E6=8D=A2=E4=B8=8E=E6=9C=AC=E5=9C=B0?=
 =?UTF-8?q?=E5=90=AF=E5=8A=A8=E4=BD=BF=E7=94=A8=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md | 64 ++++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 61 insertions(+), 3 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 4f1f38c..d6032d6 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -88,7 +88,65 @@ docker exec -it mci-redis redis-cli
 docker compose -p sino-mci --profile app build mci-server
 ```
 
-## 5. 环境变量
+## 5. 环境变量与快速切换环境
 
-- 复制 `.env.example` 为 `.env` 后再修改本地配置。
-- 默认 root 密码为 `root`，仅本地开发使用。
+项目使用 `.env` 统一管理 MySQL、Redis、RabbitMQ、SeaweedFS 以及应用服务的连接地址。
+
+### 5.1 快速切换本地/远程基础设施
+
+```bash
+cd /Users/marsal/Projects/sino-project/sino-mci
+
+# 方案 A：连接本机 localhost 上的基础设施（默认）
+cp .env.local .env
+
+# 方案 B：连接远程基础设施（如 192.168.1.173）
+cp .env.remote .env
+```
+
+`.env` 文件不会被提交（已加入 `.gitignore`），可以按需要随时切换。
+
+### 5.2 本地启动后端/前端/Channel Service
+
+```bash
+# 后端
+./scripts/run-local.sh backend
+
+# 前端
+./scripts/run-local.sh frontend
+
+# Channel Service
+./scripts/run-local.sh channel
+```
+
+`run-local.sh` 会自动加载项目根目录的 `.env`，并把 `MYSQL_HOST`、`REDIS_HOST`、`RABBITMQ_HOST`、`MCI_SERVER_URL`、`VITE_API_BASE_URL` 等变量注入到对应进程中。
+
+### 5.3 Docker Compose 启动（不受 .env 中 host 影响）
+
+```bash
+# 只启动基础设施
+./scripts/local-up.sh
+
+# 启动基础设施 + 应用服务
+./scripts/local-up.sh --with-apps
+```
+
+`local-up.sh` 会自动把 host 覆盖为 Docker 容器名（`mci-mysql`、`mci-redis`、`mci-rabbitmq`、`mci-server`），因此无论 `.env` 中是 `localhost` 还是远程 IP，容器内部都能正确互联。
+
+### 5.4 手动执行 docker compose 的注意事项
+
+若直接运行 `docker compose` 命令，容器会使用当前 `.env` 中的 `MYSQL_HOST` 等变量。请确保 `.env` 中的 host 对容器可访问，或改用 `local-up.sh` 启动。
+
+### 5.5 默认账号
+
+- MySQL root 密码：`root`（仅本地/内网开发使用）
+- 平台管理员：`superadmin` / `admin123`
+
+### 5.6 新增环境/自定义地址
+
+复制任意一份模板后修改：
+
+```bash
+cp .env.local .env
+# 编辑 .env 中的 MYSQL_HOST、REDIS_HOST、RABBITMQ_HOST、MCI_SERVER_URL、VITE_API_BASE_URL
+```