docs(agents): 补充 .env 环境切换与本地启动使用说明

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` 后再修改本地配置。
+项目使用 `.env` 统一管理 MySQL、Redis、RabbitMQ、SeaweedFS 以及应用服务的连接地址。
-- 默认 root 密码为 `root`，仅本地开发使用。
+
+### 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
+```