仓库协作指南

项目概览

这是一个基于 Vue 2.7、Vite 5、Vue Router 3 和 Element UI 2 的官网型前端项目，面向海格电器站点。运行环境要求 Node 18.13.x，默认使用 npm 脚本。页面主体集中在 src/views，通用组件在 src/components，接口封装在 src/api，路由入口是 src/router.js 与 src/route.js。

常用命令

• npm run dev：本地开发。
• npm run build：生产构建。
• npm run preview：本地预览构建结果。
• npm run build_tar：构建并打包产物。
• npm run dev_upload / npm run oa_upload：上传并解压到内网目标环境。此类命令会直接操作远端目录，修改前先确认部署路径与目标环境。

目录与改动约定

• 页面级改动优先落在 src/views/**，不要把页面业务堆进全局入口。
• 可复用展示组件放在 src/components/**，公共方法放在 src/utils/** 或 src/common/**。
• 接口请求统一收敛到 src/api/**，避免在视图组件里直接拼请求逻辑。
• 样式优先复用现有 scss、less 变量，不要随意新增一套命名体系。

编码要求

• 新增说明性文字、文档、注释默认使用中文；只有接口字段、库 API、品牌专有名词保留原文。
• 保持现有代码风格，避免无关格式化和大面积重排。
• 这个仓库存在较多历史代码与手工维护页面，重构前先确认影响范围，尤其是头部、页脚、路由和 SEO 相关逻辑。
• 如无特殊原因，不要改动上传、打包、压缩脚本中的路径、文件名和解压目录。

提交前检查

仓库当前没有成体系的自动化测试脚本。提交前至少执行一次 npm run build，并检查受影响页面的路由、接口调用和静态资源引用是否正常。提交信息建议沿用现有风格，例如 fix(contact): 更新联系我们页面顶部横幅图片、docs(页脚): 更新公司地址和名称信息。