feat: 添加合规

.env.mock

@@ -1,5 +1,20 @@
+# ========================================
 # Mock 测试环境配置
+# ========================================
 # 使用方式: npm run start:mock
+#
+# 工作原理：
+# 1. 通过 env-cmd 加载此配置文件
+# 2. REACT_APP_ENABLE_MOCK=true 会在 src/index.js 中启动 MSW (Mock Service Worker)
+# 3. MSW 在浏览器层面拦截所有 HTTP 请求
+# 4. 根据 src/mocks/handlers/* 中定义的规则返回 mock 数据
+# 5. 未定义 mock 的接口会继续请求真实后端
+#
+# 适用场景：
+# - 前端独立开发，无需后端支持
+# - 测试特定接口的 UI 表现
+# - 后端接口未就绪时的快速原型开发
+# ========================================
 
 # React 构建优化配置
 GENERATE_SOURCEMAP=false
@@ -10,10 +25,12 @@ IMAGE_INLINE_SIZE_LIMIT=10000
 NODE_OPTIONS=--max_old_space_size=4096
 
 # API 配置
-# Mock 模式下不需要真实的后端地址
-REACT_APP_API_URL=http://localhost:3000
+# Mock 模式下使用空字符串，让请求使用相对路径
+# MSW 会在浏览器层拦截这些请求，不需要真实的后端地址
+REACT_APP_API_URL=
 
 # 启用 Mock 数据（核心配置）
+# 此配置会触发 src/index.js 中的 MSW 初始化
 REACT_APP_ENABLE_MOCK=true
 
 # Mock 环境标识