接入 ESLint 与 Prettier 并加入 CI 静态门禁

README.md

@@ -21,13 +21,13 @@
 
 ## 技术栈
 
-| 层次       | 技术                                                      |
-| ---------- | --------------------------------------------------------- |
-| 应用框架   | Nuxt 4、Vue 3、Vue Router，客户端 SPA（`ssr: false`）     |
-| 状态与界面 | Pinia、PrimeVue 4、PrimeUI 主题、本地 Lucide 图标         |
-| 图表与远控 | ECharts、vue-echarts、noVNC                               |
-| 源码       | JavaScript、Vue 单文件组件、CSS，Nuxt 配置使用 TypeScript |
-| 验证工具   | Node.js `node:test`、Playwright、源码检查脚本、Prettier   |
+| 层次       | 技术                                                            |
+| ---------- | --------------------------------------------------------------- |
+| 应用框架   | Nuxt 4、Vue 3、Vue Router，客户端 SPA（`ssr: false`）           |
+| 状态与界面 | Pinia、PrimeVue 4、PrimeUI 主题、本地 Lucide 图标               |
+| 图表与远控 | ECharts、vue-echarts、noVNC                                     |
+| 源码       | JavaScript、Vue 单文件组件、CSS，Nuxt 配置使用 TypeScript       |
+| 验证工具   | Node.js `node:test`、Playwright、源码检查脚本、ESLint、Prettier |
 
 依赖的精确版本以 `package-lock.json` 为准。
 
@@ -70,19 +70,27 @@ npm run dev
 
 ## 常用命令
 
-| 命令              | 用途                                      |
-| ----------------- | ----------------------------------------- |
-| `npm run dev`     | 启动本地开发服务                          |
-| `npm run check`   | 检查应用源码语法、导入和历史部署路径依赖  |
-| `npm run build`   | 构建生产版本，输出到项目根目录 `.output/` |
-| `npm run preview` | 运行已构建的 Node.js 服务                 |
-| `npm test`        | 对生产构建运行浏览器端到端测试            |
-| `npm run format`  | 格式化应用、配置、脚本和测试代码          |
+| 命令                   | 用途                                      |
+| ---------------------- | ----------------------------------------- |
+| `npm run dev`          | 启动本地开发服务                          |
+| `npm run check`        | 检查应用源码语法、导入和历史部署路径依赖  |
+| `npm run lint`         | 检查应用、配置、脚本和测试的代码问题      |
+| `npm run lint:fix`     | 自动修复可安全修正的 ESLint 问题          |
+| `npm run build`        | 构建生产版本，输出到项目根目录 `.output/` |
+| `npm run preview`      | 运行已构建的 Node.js 服务                 |
+| `npm test`             | 对生产构建运行浏览器端到端测试            |
+| `npm run format`       | 统一格式化应用、配置、脚本、测试和文档    |
+| `npm run format:check` | 只检查格式，不改写文件                    |
+
+格式规则在 `.prettierrc.json`，扫描范围由 `.prettierignore` 排除生成物、本地报告、
+静态资源和 npm 管理的锁文件；不会将 `docs/` 或测试产物重新纳入提交。
 
 ### 构建与本地预览
 
 ```sh
 npm run check
+npm run lint
+npm run format:check
 npm run build
 NUXT_PUBLIC_API_BASE=http://127.0.0.1:8080 HOST=127.0.0.1 PORT=3000 npm run preview
 ```
@@ -137,7 +145,7 @@ CHROME_PATH=/absolute/path/to/chrome npm test
 测试产物保存在被忽略的 `tests/fixtures/runs/`。
 详细使用方式见 [测试说明](tests/README.md)。
 
-仓库包含 `.gitea/workflows/frontend.yml`：安装锁定依赖后运行源码检查、生产构建、浏览器测试和
+仓库包含 `.gitea/workflows/frontend.yml`：安装锁定依赖后先运行 ESLint 和格式检查，再安装测试浏览器、运行源码检查、生产构建、浏览器测试和
 `npm audit --audit-level=moderate`，不执行部署。Git 服务需启用 Actions 并配置兼容的 Linux runner；
 仅提交工作流不代表远端任务已经运行通过。