vue2-client 1.17.19 → 1.17.20

package/.claude/settings.local.json

@@ -1,21 +1,21 @@
-{
-  "permissions": {
-    "allow": [
-      "WebSearch",
-      "WebFetch(domain:context7.com)",
-      "Bash(npm run lint)",
-      "mcp__context7__resolve-library-id",
-      "mcp__context7__get-library-docs",
-      "WebFetch(domain:github.com)",
-      "Bash(npm run serve:*)",
-      "mcp__serena__get_current_config",
-      "mcp__serena__activate_project",
-      "mcp__serena__get_symbols_overview",
-      "mcp__serena__list_dir",
-      "mcp__serena__find_file"
-    ],
-    "deny": [],
-    "ask": [],
-    "defaultMode": "acceptEdits"
-  }
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "WebFetch(domain:context7.com)",
+      "Bash(npm run lint)",
+      "mcp__context7__resolve-library-id",
+      "mcp__context7__get-library-docs",
+      "WebFetch(domain:github.com)",
+      "Bash(npm run serve:*)",
+      "mcp__serena__get_current_config",
+      "mcp__serena__activate_project",
+      "mcp__serena__get_symbols_overview",
+      "mcp__serena__list_dir",
+      "mcp__serena__find_file"
+    ],
+    "deny": [],
+    "ask": [],
+    "defaultMode": "acceptEdits"
+  }
 }

package/.cursorrules

@@ -1,19 +1,19 @@
-你是JavaScript、Node.js、Vue 2.7+、AntdV方面的专家。
-
-代码风格和结构
-
-编写简洁、技术性的JavaScript代码，并提供准确的示例。
--使用组合API和声明式编程模式 setup 语法糖函数；避免选项API 或者 stepup 标签。如果已有代码，则使用已有的代码。
--比起代码复制，更喜欢迭代和模块化。
-使用带有助动词的描述性变量名（例如，isLoading, hasError）。
--结构文件：导出的组件，可组合，助手，静态内容，类型。
-
-命名约定
--使用小写带破折号的目录（例如，components/auth-wizard）。
--组件名称使用PascalCase（例如，AuthWizard.vue）。
--对可组合组件使用camelCase（例如，useAuthState.ts）。
-
-语法和格式
--方法和计算属性使用箭头函数。
--避免在条件语句中使用不必要的花括号；对简单的语句使用简洁的语法。
--使用模板语法进行声明性呈现。
+你是JavaScript、Node.js、Vue 2.7+、AntdV方面的专家。
+
+代码风格和结构
+
+编写简洁、技术性的JavaScript代码，并提供准确的示例。
+-使用组合API和声明式编程模式 setup 语法糖函数；避免选项API 或者 stepup 标签。如果已有代码，则使用已有的代码。
+-比起代码复制，更喜欢迭代和模块化。
+使用带有助动词的描述性变量名（例如，isLoading, hasError）。
+-结构文件：导出的组件，可组合，助手，静态内容，类型。
+
+命名约定
+-使用小写带破折号的目录（例如，components/auth-wizard）。
+-组件名称使用PascalCase（例如，AuthWizard.vue）。
+-对可组合组件使用camelCase（例如，useAuthState.ts）。
+
+语法和格式
+-方法和计算属性使用箭头函数。
+-避免在条件语句中使用不必要的花括号；对简单的语句使用简洁的语法。
+-使用模板语法进行声明性呈现。

package/.env.apply

@@ -1,19 +1,19 @@
-VUE_APP_PUBLIC_PATH=/
-VUE_APP_NAME=Admin
-VUE_APP_ROUTES_KEY=admin.routes
-VUE_APP_PERMISSIONS_KEY=admin.permissions
-VUE_APP_ROLES_KEY=admin.roles
-VUE_APP_USER_KEY=admin.user
-VUE_APP_LOGIN_KEY=admin.login
-VUE_APP_SETTING_KEY=admin.setting
-VUE_APP_TBAS_KEY=admin.tabs
-VUE_APP_TBAS_TITLES_KEY=admin.tabs.titles
-VUE_APP_DICTIONARY_KEY=admin.dictionary
-VUE_APP_BADGE_KEY=admin.badge
-VUE_APP_SINGLEVALUE_KEY=admin.singlevalue
-VUE_APP_DIVISIONSOHCHINA=admin.divisionsohchina
-VUE_APP_WEB_CONFIG_KEY=admin.webconfig
-VUE_APP_API_BASE_URL=http://123.60.214.109:8405
-VUE_APP_SYSTEM_NAME=af-apply
-VUE_APP_LOGIN_VERSION=V4
-
+VUE_APP_PUBLIC_PATH=/
+VUE_APP_NAME=Admin
+VUE_APP_ROUTES_KEY=admin.routes
+VUE_APP_PERMISSIONS_KEY=admin.permissions
+VUE_APP_ROLES_KEY=admin.roles
+VUE_APP_USER_KEY=admin.user
+VUE_APP_LOGIN_KEY=admin.login
+VUE_APP_SETTING_KEY=admin.setting
+VUE_APP_TBAS_KEY=admin.tabs
+VUE_APP_TBAS_TITLES_KEY=admin.tabs.titles
+VUE_APP_DICTIONARY_KEY=admin.dictionary
+VUE_APP_BADGE_KEY=admin.badge
+VUE_APP_SINGLEVALUE_KEY=admin.singlevalue
+VUE_APP_DIVISIONSOHCHINA=admin.divisionsohchina
+VUE_APP_WEB_CONFIG_KEY=admin.webconfig
+VUE_APP_API_BASE_URL=http://123.60.214.109:8405
+VUE_APP_SYSTEM_NAME=af-apply
+VUE_APP_LOGIN_VERSION=V4
+

package/.env.gaslink

@@ -1,19 +1,19 @@
-VUE_APP_PUBLIC_PATH=/
-VUE_APP_NAME=Admin
-VUE_APP_ROUTES_KEY=admin.routes
-VUE_APP_PERMISSIONS_KEY=admin.permissions
-VUE_APP_ROLES_KEY=admin.roles
-VUE_APP_USER_KEY=admin.user
-VUE_APP_LOGIN_KEY=admin.login
-VUE_APP_SETTING_KEY=admin.setting
-VUE_APP_TBAS_KEY=admin.tabs
-VUE_APP_TBAS_TITLES_KEY=admin.tabs.titles
-VUE_APP_DICTIONARY_KEY=admin.dictionary
-VUE_APP_BADGE_KEY=admin.badge
-VUE_APP_SINGLEVALUE_KEY=admin.singlevalue
-VUE_APP_DIVISIONSOHCHINA=admin.divisionsohchina
-VUE_APP_WEB_CONFIG_KEY=admin.webconfig
-VUE_APP_API_BASE_URL=http://123.60.214.109:8405
-VUE_APP_SYSTEM_NAME=af-gaslink
-VUE_APP_LOGIN_VERSION=V4
-
+VUE_APP_PUBLIC_PATH=/
+VUE_APP_NAME=Admin
+VUE_APP_ROUTES_KEY=admin.routes
+VUE_APP_PERMISSIONS_KEY=admin.permissions
+VUE_APP_ROLES_KEY=admin.roles
+VUE_APP_USER_KEY=admin.user
+VUE_APP_LOGIN_KEY=admin.login
+VUE_APP_SETTING_KEY=admin.setting
+VUE_APP_TBAS_KEY=admin.tabs
+VUE_APP_TBAS_TITLES_KEY=admin.tabs.titles
+VUE_APP_DICTIONARY_KEY=admin.dictionary
+VUE_APP_BADGE_KEY=admin.badge
+VUE_APP_SINGLEVALUE_KEY=admin.singlevalue
+VUE_APP_DIVISIONSOHCHINA=admin.divisionsohchina
+VUE_APP_WEB_CONFIG_KEY=admin.webconfig
+VUE_APP_API_BASE_URL=http://123.60.214.109:8405
+VUE_APP_SYSTEM_NAME=af-gaslink
+VUE_APP_LOGIN_VERSION=V4
+

package/.env.his

@@ -1,19 +1,19 @@
-VUE_APP_PUBLIC_PATH=/
-VUE_APP_NAME=Admin
-VUE_APP_ROUTES_KEY=admin.routes
-VUE_APP_PERMISSIONS_KEY=admin.permissions
-VUE_APP_ROLES_KEY=admin.roles
-VUE_APP_USER_KEY=admin.user
-VUE_APP_LOGIN_KEY=admin.login
-VUE_APP_SETTING_KEY=admin.setting
-VUE_APP_TBAS_KEY=admin.tabs
-VUE_APP_TBAS_TITLES_KEY=admin.tabs.titles
-VUE_APP_DICTIONARY_KEY=admin.dictionary
-VUE_APP_BADGE_KEY=admin.badge
-VUE_APP_SINGLEVALUE_KEY=admin.singlevalue
-VUE_APP_DIVISIONSOHCHINA=admin.divisionsohchina
-VUE_APP_WEB_CONFIG_KEY=admin.webconfig
-VUE_APP_API_BASE_URL=http://123.60.214.109:8405
-VUE_APP_SYSTEM_NAME=af-his
-VUE_APP_LOGIN_VERSION=V4
-
+VUE_APP_PUBLIC_PATH=/
+VUE_APP_NAME=Admin
+VUE_APP_ROUTES_KEY=admin.routes
+VUE_APP_PERMISSIONS_KEY=admin.permissions
+VUE_APP_ROLES_KEY=admin.roles
+VUE_APP_USER_KEY=admin.user
+VUE_APP_LOGIN_KEY=admin.login
+VUE_APP_SETTING_KEY=admin.setting
+VUE_APP_TBAS_KEY=admin.tabs
+VUE_APP_TBAS_TITLES_KEY=admin.tabs.titles
+VUE_APP_DICTIONARY_KEY=admin.dictionary
+VUE_APP_BADGE_KEY=admin.badge
+VUE_APP_SINGLEVALUE_KEY=admin.singlevalue
+VUE_APP_DIVISIONSOHCHINA=admin.divisionsohchina
+VUE_APP_WEB_CONFIG_KEY=admin.webconfig
+VUE_APP_API_BASE_URL=http://123.60.214.109:8405
+VUE_APP_SYSTEM_NAME=af-his
+VUE_APP_LOGIN_VERSION=V4
+

package/.env.liuli

@@ -1,20 +1,20 @@
-VUE_APP_PUBLIC_PATH=/liuli-web
-VUE_APP_NAME=Admin
-VUE_APP_ROUTES_KEY=admin.routes
-VUE_APP_PERMISSIONS_KEY=admin.permissions
-VUE_APP_ROLES_KEY=admin.roles
-VUE_APP_USER_KEY=admin.user
-VUE_APP_LOGIN_KEY=admin.login
-VUE_APP_SETTING_KEY=admin.setting
-VUE_APP_TBAS_KEY=admin.tabs
-VUE_APP_TBAS_TITLES_KEY=admin.tabs.titles
-VUE_APP_DICTIONARY_KEY=admin.dictionary
-VUE_APP_BADGE_KEY=admin.badge
-VUE_APP_SINGLEVALUE_KEY=admin.singlevalue
-VUE_APP_DIVISIONSOHCHINA=admin.divisionsohchina
-VUE_APP_WEB_CONFIG_KEY=admin.webconfig
-VUE_APP_API_BASE_URL=http://123.60.214.109:8405
-VUE_APP_SYSTEM_NAME=af-liuli
-VUE_APP_SINGLE_PAPER=TRUE
-VUE_APP_LOGIN_VERSION=V4
-
+VUE_APP_PUBLIC_PATH=/liuli-web
+VUE_APP_NAME=Admin
+VUE_APP_ROUTES_KEY=admin.routes
+VUE_APP_PERMISSIONS_KEY=admin.permissions
+VUE_APP_ROLES_KEY=admin.roles
+VUE_APP_USER_KEY=admin.user
+VUE_APP_LOGIN_KEY=admin.login
+VUE_APP_SETTING_KEY=admin.setting
+VUE_APP_TBAS_KEY=admin.tabs
+VUE_APP_TBAS_TITLES_KEY=admin.tabs.titles
+VUE_APP_DICTIONARY_KEY=admin.dictionary
+VUE_APP_BADGE_KEY=admin.badge
+VUE_APP_SINGLEVALUE_KEY=admin.singlevalue
+VUE_APP_DIVISIONSOHCHINA=admin.divisionsohchina
+VUE_APP_WEB_CONFIG_KEY=admin.webconfig
+VUE_APP_API_BASE_URL=http://123.60.214.109:8405
+VUE_APP_SYSTEM_NAME=af-liuli
+VUE_APP_SINGLE_PAPER=TRUE
+VUE_APP_LOGIN_VERSION=V4
+

package/.env.scada

@@ -1,19 +1,19 @@
-VUE_APP_PUBLIC_PATH=/
-VUE_APP_NAME=Admin
-VUE_APP_ROUTES_KEY=admin.routes
-VUE_APP_PERMISSIONS_KEY=admin.permissions
-VUE_APP_ROLES_KEY=admin.roles
-VUE_APP_USER_KEY=admin.user
-VUE_APP_LOGIN_KEY=admin.login
-VUE_APP_SETTING_KEY=admin.setting
-VUE_APP_TBAS_KEY=admin.tabs
-VUE_APP_TBAS_TITLES_KEY=admin.tabs.titles
-VUE_APP_DICTIONARY_KEY=admin.dictionary
-VUE_APP_BADGE_KEY=admin.badge
-VUE_APP_SINGLEVALUE_KEY=admin.singlevalue
-VUE_APP_DIVISIONSOHCHINA=admin.divisionsohchina
-VUE_APP_WEB_CONFIG_KEY=admin.webconfig
-VUE_APP_API_BASE_URL=http://123.60.214.109:8405
-VUE_APP_SYSTEM_NAME=af-scada
-VUE_APP_LOGIN_VERSION=V4
-
+VUE_APP_PUBLIC_PATH=/
+VUE_APP_NAME=Admin
+VUE_APP_ROUTES_KEY=admin.routes
+VUE_APP_PERMISSIONS_KEY=admin.permissions
+VUE_APP_ROLES_KEY=admin.roles
+VUE_APP_USER_KEY=admin.user
+VUE_APP_LOGIN_KEY=admin.login
+VUE_APP_SETTING_KEY=admin.setting
+VUE_APP_TBAS_KEY=admin.tabs
+VUE_APP_TBAS_TITLES_KEY=admin.tabs.titles
+VUE_APP_DICTIONARY_KEY=admin.dictionary
+VUE_APP_BADGE_KEY=admin.badge
+VUE_APP_SINGLEVALUE_KEY=admin.singlevalue
+VUE_APP_DIVISIONSOHCHINA=admin.divisionsohchina
+VUE_APP_WEB_CONFIG_KEY=admin.webconfig
+VUE_APP_API_BASE_URL=http://123.60.214.109:8405
+VUE_APP_SYSTEM_NAME=af-scada
+VUE_APP_LOGIN_VERSION=V4
+

package/.eslintrc.js

@@ -1,90 +1,90 @@
-module.exports = {
-  root: true,
-  env: {
-    node: true
-  },
-  extends: [
-    'plugin:vue/essential',
-    'plugin:vue/strongly-recommended',
-    '@vue/standard'
-  ],
-  rules: {
-    'comma-dangle': 'off',
-    'no-console': 'off',
-    'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
-    'generator-star-spacing': 'off',
-    'no-mixed-operators': 0,
-    'vue/max-attributes-per-line': [
-      2,
-      {
-        singleline: {
-          max: 5
-        },
-        multiline: {
-          max: 1,
-        }
-      }
-    ],
-    'vue/attribute-hyphenation': 0,
-    'vue/html-self-closing': 0,
-    'vue/component-name-in-template-casing': 0,
-    'vue/html-closing-bracket-spacing': 0,
-    'vue/singleline-html-element-content-newline': 0,
-    'vue/no-unused-components': 0,
-    'vue/multiline-html-element-content-newline': 0,
-    'vue/no-use-v-if-with-v-for': 0,
-    'vue/html-closing-bracket-newline': 0,
-    'vue/no-parsing-error': 0,
-    'vue/name-property-casing': 0,
-    'vue/multi-word-component-names': 0,
-    'vue/require-valid-default-prop': 0,
-    'no-template-curly-in-string': 0,
-    'vue/no-mutating-props': 0,
-    'no-useless-escape': 0,
-    'no-tabs': 0,
-    'multiline-ternary': 0,
-    'object-shorthand': 0,
-    quotes: [
-      2,
-      'single',
-      {
-        avoidEscape: true,
-        allowTemplateLiterals: true
-      }
-    ],
-    semi: [
-      2,
-      'never',
-      {
-        beforeStatementContinuationChars: 'never'
-      }
-    ],
-    'no-delete-var': 2,
-    'prefer-const': [
-      2,
-      {
-        ignoreReadBeforeAssign: false
-      }
-    ],
-    'template-curly-spacing': 'off',
-    indent: 'off',
-    // 必须使用全等: false
-    eqeqeq: 0,
-    // 可以使用!! 双重否定
-    'no-extra-boolean-cast': 'off'
-  },
-  parserOptions: {
-    parser: '@babel/eslint-parser'
-  },
-  overrides: [
-    {
-      files: [
-        '**/__tests__/*.{j,t}s?(x)',
-        '**/tests/unit/**/*.spec.{j,t}s?(x)'
-      ],
-      env: {
-        jest: true
-      }
-    }
-  ]
-}
+module.exports = {
+  root: true,
+  env: {
+    node: true
+  },
+  extends: [
+    'plugin:vue/essential',
+    'plugin:vue/strongly-recommended',
+    '@vue/standard'
+  ],
+  rules: {
+    'comma-dangle': 'off',
+    'no-console': 'off',
+    'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
+    'generator-star-spacing': 'off',
+    'no-mixed-operators': 0,
+    'vue/max-attributes-per-line': [
+      2,
+      {
+        singleline: {
+          max: 5
+        },
+        multiline: {
+          max: 1,
+        }
+      }
+    ],
+    'vue/attribute-hyphenation': 0,
+    'vue/html-self-closing': 0,
+    'vue/component-name-in-template-casing': 0,
+    'vue/html-closing-bracket-spacing': 0,
+    'vue/singleline-html-element-content-newline': 0,
+    'vue/no-unused-components': 0,
+    'vue/multiline-html-element-content-newline': 0,
+    'vue/no-use-v-if-with-v-for': 0,
+    'vue/html-closing-bracket-newline': 0,
+    'vue/no-parsing-error': 0,
+    'vue/name-property-casing': 0,
+    'vue/multi-word-component-names': 0,
+    'vue/require-valid-default-prop': 0,
+    'no-template-curly-in-string': 0,
+    'vue/no-mutating-props': 0,
+    'no-useless-escape': 0,
+    'no-tabs': 0,
+    'multiline-ternary': 0,
+    'object-shorthand': 0,
+    quotes: [
+      2,
+      'single',
+      {
+        avoidEscape: true,
+        allowTemplateLiterals: true
+      }
+    ],
+    semi: [
+      2,
+      'never',
+      {
+        beforeStatementContinuationChars: 'never'
+      }
+    ],
+    'no-delete-var': 2,
+    'prefer-const': [
+      2,
+      {
+        ignoreReadBeforeAssign: false
+      }
+    ],
+    'template-curly-spacing': 'off',
+    indent: 'off',
+    // 必须使用全等: false
+    eqeqeq: 0,
+    // 可以使用!! 双重否定
+    'no-extra-boolean-cast': 'off'
+  },
+  parserOptions: {
+    parser: '@babel/eslint-parser'
+  },
+  overrides: [
+    {
+      files: [
+        '**/__tests__/*.{j,t}s?(x)',
+        '**/tests/unit/**/*.spec.{j,t}s?(x)'
+      ],
+      env: {
+        jest: true
+      }
+    }
+  ]
+}

package/.serena/memories/code_style_conventions.md

@@ -0,0 +1,218 @@
+# Vue2-Client 代码风格和约定
+
+## 总体原则
+- 编写简洁、技术性的JavaScript代码
+- 提供准确的代码示例
+- 优先迭代和模块化，避免代码重复
+- 使用描述性变量名（如：isLoading, hasError）
+
+## Vue组件开发规范
+
+### 组件API风格
+**优先使用**：
+- Vue 2.7组合API + setup语法糖
+- 声明式编程模式
+
+**避免使用**（除非修改现有代码）：
+- 选项API (Options API)
+- 传统的setup标签形式
+
+### 示例：推荐的组件结构
+```vue
+<script setup>
+import { ref, computed } from 'vue'
+
+// 使用组合API
+const isLoading = ref(false)
+const hasError = ref(false)
+
+// 计算属性使用箭头函数
+const displayText = computed(() => {
+  return isLoading.value ? '加载中...' : '已完成'
+})
+
+// 方法使用箭头函数
+const handleClick = () => {
+  isLoading.value = true
+}
+</script>
+
+<template>
+  <div>{{ displayText }}</div>
+</template>
+```
+
+## 命名约定
+
+### 目录命名
+- 使用kebab-case（小写带破折号）
+- 示例：`components/auth-wizard`、`pages/user-manage`
+
+### 文件命名
+- **组件文件**：使用PascalCase
+  - 示例：`AuthWizard.vue`、`UserTable.vue`
+- **可组合函数**：使用camelCase
+  - 示例：`useAuthState.js`、`useFormValidation.js`
+- **工具函数**：使用camelCase
+  - 示例：`formatDate.js`、`encryptData.js`
+
+### 变量命名
+- **布尔值**：使用助动词前缀
+  - `isLoading`、`hasError`、`canEdit`、`shouldShow`
+- **普通变量**：使用camelCase
+  - `userData`、`pageTitle`、`apiResponse`
+- **常量**：使用UPPER_SNAKE_CASE
+  - `API_BASE_URL`、`MAX_RETRY_COUNT`
+
+## 项目特定约定
+
+### X组件命名规范
+Base-client中的核心组件使用X前缀：
+- `XForm`：表单组件
+- `XTable`：表格组件
+- `XCard`：卡片组件
+- `XPageView`：页面视图组件
+
+### 组件文件结构
+```
+src/
+├── base-client/          # 基础组件（全局注册）
+│   ├── components/       # X系列组件
+│   └── plugins/          # 全局插件
+├── components/           # 通用组件（按需引入）
+├── pages/               # 页面组件
+└── layouts/             # 布局组件
+```
+
+## 代码格式规范
+
+### 语法和格式
+- **箭头函数**：方法和计算属性统一使用箭头函数
+- **简洁语法**：避免条件语句中不必要的花括号
+  ```javascript
+  // 推荐
+  if (isValid) return true
+  
+  // 避免（简单语句）
+  if (isValid) {
+    return true
+  }
+  ```
+- **模板语法**：使用声明式渲染，避免在模板中写复杂逻辑
+
+### 导入顺序
+文件导入按以下顺序组织：
+1. Vue核心和第三方库
+2. 组件导入
+3. 可组合函数（composables）
+4. 工具函数（helpers）
+5. 静态内容（assets、styles）
+6. 类型定义（如果有）
+
+示例：
+```javascript
+// 1. 核心库
+import { ref, computed } from 'vue'
+import { message } from 'ant-design-vue'
+
+// 2. 组件
+import UserForm from '@/components/UserForm.vue'
+
+// 3. 可组合函数
+import { useAuth } from '@/composables/useAuth'
+
+// 4. 工具
+import { formatDate } from '@/utils/date'
+
+// 5. 样式
+import './styles.less'
+```
+
+## Less样式规范
+
+### 样式组织
+- 使用Less预处理器
+- 主题变量定义在`src/theme/`
+- 组件样式与组件文件共同放置
+- 使用BEM命名规范（可选，但推荐）
+
+### 示例
+```less
+.user-table {
+  &__header {
+    padding: 16px;
+  }
+  
+  &__body {
+    min-height: 400px;
+  }
+}
+```
+
+## 注释规范
+
+### 注释语言
+- **必须使用中文**编写注释
+- 代码注释、文档、说明都使用中文
+
+### 注释格式
+```javascript
+/**
+ * 用户认证可组合函数
+ * @returns {Object} 返回认证状态和方法
+ */
+const useAuth = () => {
+  // 检查用户是否已登录
+  const isLoggedIn = ref(false)
+  
+  return { isLoggedIn }
+}
+```
+
+## 配置驱动开发规范
+
+### JSON配置
+项目采用配置驱动模式，组件行为通过JSON配置定义：
+```javascript
+// XForm配置示例
+const formConfig = {
+  columns: [
+    {
+      title: '用户名',
+      key: 'username',
+      type: 'input',
+      required: true
+    }
+  ]
+}
+```
+
+### 配置文件位置
+- 系统配置：`src/config/`
+- 默认配置：`src/config/default/`
+- 配置替换器：`src/config/replacer/`
+
+## ESLint规范
+- 开发时默认禁用ESLint（--no-eslint）
+- 提交前必须运行`npm run lint`检查
+- 遵循Vue官方ESLint规则
+- 标准JavaScript风格（@vue/eslint-config-standard）
+
+## Git提交规范
+虽然项目未强制要求，但推荐使用约定式提交：
+- `feat:` 新功能
+- `fix:` 修复bug
+- `docs:` 文档更新
+- `style:` 代码格式调整
+- `refactor:` 重构
+- `test:` 测试相关
+- `chore:` 构建或工具变更
+
+## 最佳实践
+1. **组件复用**：优先使用base-client中的X组件
+2. **配置优于编码**：能用配置实现的不写硬编码
+3. **mixins使用**：表单验证等共享逻辑使用mixins
+4. **响应式设计**：使用XFormCol栅格系统
+5. **API调用**：统一使用`src/services/apiService.js`
+6. **数据转换**：遵循DataModel模式
+7. **错误处理**：使用axios拦截器统一处理