docs: 重写 README.md 提供更清晰的脚本使用说明

将原本简单的版本和命令说明重构为结构化的文档，包含：
- 彩色命令速查表
- 详细分类的开发、构建、发布、部署命令
- 代码检查与格式化说明
- 常用工作流示例
使新开发者能更快速上手项目脚本使用

README.md

@@ -1,34 +1,113 @@
-## 基础信息
-```bash
-nodejs 20.19.0
-pnpm 10.12.4
-```
+# 📖 项目脚本使用说明
+
+本项目在 `package.json` 中定义了一系列常用脚本，用于本地开发、构建、发布和部署。  
+以下是每个脚本的功能及使用方法。
+
+---
+
+## 🎯 彩色命令速查表
+
+| 环境 | 命令 | 端口 / 说明 |
+|------|------|------------|
+| 🟢 开发环境 | `npm run dev` | 3000 |
+| 🟡 测试环境 | `npm run dev:test` | 4000 |
+| 🔴 生产环境（本地调试） | `npm run dev:pro` | 5000 |
+| 📦 构建开发环境 | `npm run build:dev` | - |
+| 📦 构建测试环境 | `npm run build:test` | - |
+| 📦 构建生产环境 | `npm run build` | - |
+| 🚀 发布版本 | `npm run release` | 自动推送代码 + tags |
+| 📤 部署测试环境 | `npm run deploy:test` | 打包 + 部署 |
+| 🔍 类型检查 | `npm run type-check` | TypeScript 检查 |
+| 🧹 代码修复 | `npm run lint` | ESLint 自动修复 |
+| 🎨 格式化代码 | `npm run format` | Prettier 格式化 |
+
+---
+
+## 📦 开发相关
+
+| 命令 | 说明 | 运行示例 |
+|------|------|----------|
+| `npm run dev` | 启动开发环境（development），端口 3000 | `npm run dev` |
+| `npm run dev:test` | 启动测试环境（test），端口 4000 | `npm run dev:test` |
+| `npm run dev:pro` | 启动生产环境（production）本地调试，端口 5000 | `npm run dev:pro` |
+
+---
+
+## 🏗 构建相关
+
+| 命令 | 说明 | 运行示例 |
+|------|------|----------|
+| `npm run build:dev` | 打包 **开发环境** 构建产物 | `npm run build:dev` |
+| `npm run build:test` | 打包 **测试环境** 构建产物 | `npm run build:test` |
+| `npm run build` | 打包 **生产环境** 构建产物 | `npm run build` |
+
+---
+
+## 🚀 发布相关
+
+| 命令 | 说明 | 运行示例 |
+|------|------|----------|
+| `npm run bump` | 自动更新版本号（patch 增量），并生成 Git 提交信息 | `npm run bump` |
+| `npm run release` | 更新版本号 → 推送代码 → 推送 tags → 生成发布日志 | `npm run release` |
 
-## 开发阶段
+> 💡 `npm run release` 会执行：
+> 1. `npm run bump`  
+> 2. `git push`（推送代码）  
+> 3. `git push --tags`（推送版本标签）  
+> 4. `node scripts/release-message.js`（生成发布信息）
+
+---
+
+## 📤 部署相关
+
+| 命令 | 说明 | 运行示例 |
+|------|------|----------|
+| `npm run deploy:test` | **打包测试环境** 并执行部署脚本 | `npm run deploy:test` |
+| `npm run run:deploy` | 直接执行部署脚本（不打包） | `npm run run:deploy` |
+
+> ⚠ `run:deploy` 会调用 `scripts/deploy.ps1`（PowerShell 脚本），需确保本地已安装 PowerShell 且允许执行脚本。
+
+---
+
+## 👀 预览构建产物
+
+| 命令 | 说明 | 运行示例 |
+|------|------|----------|
+| `npm run preview` | 本地预览已构建的生产环境包（默认端口 4173） | `npm run preview` |
+
+---
+
+## 🔍 代码检查与格式化
+
+| 命令 | 说明 | 运行示例 |
+|------|------|----------|
+| `npm run type-check` | TypeScript 类型检查 | `npm run type-check` |
+| `npm run lint` | ESLint 代码规范检查并自动修复问题 | `npm run lint` |
+| `npm run format` | 使用 Prettier 格式化 `src/` 目录下的代码 | `npm run format` |
+
+---
+
+## 📝 常用工作流示例
+
+**本地开发**  
 ```bash
-  npm run dev # 启动研发环境
-  npm run dev:test # 启动测试环境
-  npm run dev:pro # 启动生产环境
+npm install
+npm run dev
 ```
 
-## 版本发布
-用于发布版本，自动生成版本tag, 如：`v0.0.2`
+**打包并部署测试环境**
 ```bash
-  npm run release
+npm run deploy:test
 ```
 
-
-## 构建阶段
+**发布新版本到远程仓库**
 ```bash
-  npm run build:dev # 构建研发环境
-  npm run build:test # 构建测试环境 
-  npm run build # 构建生产环境
+npm run release
 ```
 
-## 部署阶段
-> 说明：目前仅测试环境需要手动部署，研发与生产环境使用jenkins自动部署
+**代码检查与格式化**
 ```bash
-  # npm run deploy # 部署生产环境
-  npm run deploy:test # 部署测试环境
-  # npm run deploy:dev # 部署研发环境
+npm run type-check
+npm run lint
+npm run format
 ```