From 93df41695425ed1afc439c15dd7aeaca7c504c35 Mon Sep 17 00:00:00 2001
From: marsal <wangyuhang@sino-assistance.com>
Date: Mon, 13 Jul 2026 14:34:49 +0800
Subject: [PATCH] =?UTF-8?q?docs(agents):=20=E8=A1=A5=E5=85=85=20IDE=20?=
 =?UTF-8?q?=E6=9C=AC=E5=9C=B0=E8=B0=83=E8=AF=95=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index d6032d6..ee58f53 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -150,3 +150,47 @@ cp .env.remote .env
 cp .env.local .env
 # 编辑 .env 中的 MYSQL_HOST、REDIS_HOST、RABBITMQ_HOST、MCI_SERVER_URL、VITE_API_BASE_URL
 ```
+
+## 6. 本地调试（IDE）
+
+### 6.1 后端 Spring Boot 调试
+
+1. 切换环境：
+   ```bash
+   cd /Users/marsal/Projects/sino-project/sino-mci
+   cp .env.local .env        # 连接本地 docker-compose 基础设施
+   # 或 cp .env.remote .env  # 连接远程基础设施（如 192.168.1.173）
+   ```
+
+2. 在 IntelliJ IDEA 中创建 Run Configuration：
+   - **Main class**: `com.sino.mci.server.MciServerApplication`
+   - **Active profiles**: `dev`
+   - **Environment variables**: 填入 `.env` 中的关键变量，例如：
+     ```
+     MYSQL_HOST=localhost;REDIS_HOST=localhost;RABBITMQ_HOST=localhost;MYSQL_PORT=3306;MYSQL_ROOT_PASSWORD=root;MYSQL_DATABASE=sino_mci;MYSQL_USER=root;REDIS_PORT=6379;RABBITMQ_DEFAULT_USER=guest;RABBITMQ_DEFAULT_PASS=guest;RABBITMQ_AMQP_PORT=5672
+     ```
+
+   > 也可安装 EnvFile / .env 插件让 IDE 自动加载 `.env`。
+
+3. 启动 Debug，访问 `http://localhost:8080/msg-platform`。
+
+### 6.2 前端 Vite 调试
+
+```bash
+cd admin-web
+npm run dev
+```
+
+代理目标由 `VITE_API_BASE_URL` 决定（定义在 `.env` 中）：
+- `.env.local`：指向 `http://localhost:8080`
+- `.env.remote`：指向 `http://192.168.1.173:8080`
+
+### 6.3 Channel Service 调试
+
+```bash
+cd channel-service
+source .venv/bin/activate
+python -m app.main
+```
+
+`MCI_SERVER_URL` 从 `.env` 加载，指向后端地址。