docs: 更新本地服务管理规则

- 强制使用 dev-services.py 控制本地服务
- 明确前端/H5 固定端口 5178-5181
- 新增禁止无意义重启规则

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

CLAUDE.md

@@ -43,8 +43,8 @@ cd server
 # 编译打包
 mvn clean package -DskipTests
 
-# 本地运行
-mvn spring-boot:run
+# 本地运行（必须使用 dev-services.py）
+python dev-services.py start server
 
 # 或直接运行 JAR
 java -jar target/server-1.0.0.jar
@@ -65,8 +65,8 @@ cd web
 # 安装依赖
 npm install
 
-# 启动开发服务器 (端口 5173)
-npm run dev
+# 启动开发服务器（必须使用 dev-services.py，固定端口 5178）
+python dev-services.py start web
 
 # 类型检查
 npm run type-check
@@ -93,8 +93,8 @@ cd web-admin
 # 安装依赖
 npm install
 
-# 启动开发服务器 (端口 5174)
-npm run dev
+# 启动开发服务器（必须使用 dev-services.py，固定端口 5179）
+python dev-services.py start web-admin
 
 # 类型检查
 npm run type-check
@@ -130,10 +130,10 @@ npm run build:h5
 **H5 开发模式**（日常开发，推荐）：
 ```bash
 cd mini-program
-# 或使用启动脚本
-start-h5-dev.bat
+# 或使用 dev-services.py 启动（固定端口 5180）
+python dev-services.py start mini-program
 ```
-访问 `http://localhost:5173`，登录态保留，支持热更新。
+访问 `http://localhost:5180`，登录态保留，支持热更新。
 
 **微信小程序开发模式**（仅用于小程序特性验证）：
 ```bash
@@ -266,27 +266,44 @@ bash deploy-all.sh admin
 
 ---
 
-## 热加载规则（强制）
+## 本地服务管理规则（强制）
 
-**修改前后端代码后，优先利用热加载，避免不必要的重启**
+**启动、重启、停止本地前后端服务时，必须使用项目根目录下的 `dev-services.py` 脚本。**
 
-### 判断逻辑
+### 强制要求
+
+- ✅ 必须使用：`python dev-services.py [start|stop|restart|status|discover|logs] [服务名]`
+- ❌ 禁止直接使用 `npm run dev` / `pnpm run dev` 启动前端
+- ❌ 禁止直接使用 `npm run dev:h5` 启动小程序 H5
+- ❌ 禁止直接使用 `mvn spring-boot:run` 启动后端
+- ❌ 禁止无意义重启支持热加载的服务
+
+### 前端/H5 固定端口
+
+| 服务 | 目录 | 固定端口 |
+|---|---|---|
+| web | `web/` | 5178 |
+| web-admin | `web-admin/` | 5179 |
+| mini-program | `mini-program/` | 5180 |
+| life-script | `life-script/` | 5181 |
+
+后端服务端口保持原有配置不变。
+
+### 禁止无意义重启
+
+- 只有修改必须重启才能生效的文件时，才允许执行 `restart`
+- 修改源码文件（`.vue`、`.tsx`、`.ts`、`.js`、`.css`、`.scss` 等）时，`dev-services.py restart` 会拒绝重启
+- 确需强制重启时，使用 `python dev-services.py restart --force`
+
+### 热加载规则
 
 1. **不需要重启的场景**（热加载自动生效）
    - 前端：修改 `.vue`、`.tsx`、`.ts`、`.js`、`.css`、`.scss` 等源码文件
-   - 后端：修改业务逻辑、API 接口、组件代码等支持热更新的文件
    - 样式、模板、静态资源等修改
 
-2. **需要重启的场景**（热加载无法生效）
+2. **需要重启的场景**
    - 前端：修改 `vite.config.ts`、`tsconfig.json`、`.env`、`package.json`、别名配置等
-   - 后端：修改启动配置、数据库连接、中间件注册、环境变量等
-   - 新增或删除依赖包后
-
-### 操作原则
-
-- 修改后先观察终端输出，确认热加载是否成功
-- 只有修改了必须重启才能生效的配置时，才执行重启操作
-- 重启前后端服务前，需告知用户
+   - 后端：按现有后端规则处理（本地不启动后端，使用服务器验收）
 
 ---