diff --git a/.husky/pre-commit b/.husky/pre-commit
new file mode 100755
index 0000000..e3b5d05
--- /dev/null
+++ b/.husky/pre-commit
@@ -0,0 +1 @@
+npm run lint -- --fix
diff --git a/docs/.vitepress/theme/components/ReadingProgress.vue b/docs/.vitepress/theme/components/ReadingProgress.vue
index 2bf394e..b8124c8 100644
--- a/docs/.vitepress/theme/components/ReadingProgress.vue
+++ b/docs/.vitepress/theme/components/ReadingProgress.vue
@@ -4,10 +4,10 @@
       v-if="showProgress" 
       class="reading-progress"
       :class="{ 'is-dragging': isDragging }"
+      :title="isDragging ? '拖动调整位置' : '阅读进度 ' + progress + '%'"
       @mousedown="startDrag"
       @touchstart="startDrag"
       @click="handleClick"
-      :title="isDragging ? '拖动调整位置' : '阅读进度 ' + progress + '%'"
     >
       <svg class="progress-ring" viewBox="0 0 56 56">
         <circle
diff --git a/docs/.vitepress/theme/components/appendix/api-design/HttpMethodsDemo.vue b/docs/.vitepress/theme/components/appendix/api-design/HttpMethodsDemo.vue
index 94308ad..5f458bb 100644
--- a/docs/.vitepress/theme/components/appendix/api-design/HttpMethodsDemo.vue
+++ b/docs/.vitepress/theme/components/appendix/api-design/HttpMethodsDemo.vue
@@ -24,7 +24,7 @@
       </div>
 
       <!-- 当前方法详情 -->
-      <div class="method-detail" v-if="currentMethod">
+      <div v-if="currentMethod" class="method-detail">
         <div class="detail-header">
           <span class="http-badge" :class="currentMethod.name">{{ currentMethod.name }}</span>
           <span class="method-desc">{{ currentMethod.description }}</span>
@@ -51,13 +51,13 @@
         <div class="example-section">
           <div class="example-title">📝 使用示例</div>
           <div class="example-content">
-            <div class="example-item" v-for="(example, idx) in currentMethod.examples" :key="idx">
+            <div v-for="(example, idx) in currentMethod.examples" :key="idx" class="example-item">
               <div class="example-scenario">{{ example.scenario }}</div>
               <div class="example-request">
                 <span class="http-method" :class="currentMethod.name">{{ currentMethod.name }}</span>
                 <span class="request-url">{{ example.url }}</span>
               </div>
-              <div class="example-body" v-if="example.body">
+              <div v-if="example.body" class="example-body">
                 <pre><code>{{ JSON.stringify(example.body, null, 2) }}</code></pre>
               </div>
             </div>
diff --git a/docs/.vitepress/theme/components/appendix/cloud-topology/VpcArchitectureDemo.vue b/docs/.vitepress/theme/components/appendix/cloud-topology/VpcArchitectureDemo.vue
index 59aee49..58c93f0 100644
--- a/docs/.vitepress/theme/components/appendix/cloud-topology/VpcArchitectureDemo.vue
+++ b/docs/.vitepress/theme/components/appendix/cloud-topology/VpcArchitectureDemo.vue
@@ -214,7 +214,7 @@
       </div>
     </div>
   </div>
-</template>
+</div></template>
 
 <script setup>
 import { ref, computed, watch } from 'vue'
diff --git a/package-lock.json b/package-lock.json
index 70de627..fcf7416 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -21,6 +21,7 @@
         "@eslint/js": "^9.0.0",
         "eslint": "^9.0.0",
         "eslint-plugin-vue": "^9.30.0",
+        "husky": "^9.1.7",
         "markdown-it-katex": "^2.0.3",
         "prettier": "^3.7.4",
         "vue-eslint-parser": "^9.4.3"
@@ -2653,6 +2654,22 @@
         "url": "https://github.com/fb55/entities?sponsor=1"
       }
     },
+    "node_modules/husky": {
+      "version": "9.1.7",
+      "resolved": "https://registry.npmmirror.com/husky/-/husky-9.1.7.tgz",
+      "integrity": "sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "husky": "bin.js"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/typicode"
+      }
+    },
     "node_modules/ignore": {
       "version": "5.3.2",
       "resolved": "https://registry.npmmirror.com/ignore/-/ignore-5.3.2.tgz",
diff --git a/package.json b/package.json
index 9d96f00..4ec4a00 100644
--- a/package.json
+++ b/package.json
@@ -10,7 +10,8 @@
     "format": "prettier --write .",
     "verify": "bash scripts/verify.sh",
     "lint": "eslint docs/.vitepress/theme",
-    "lint:fix": "eslint docs/.vitepress/theme --fix"
+    "lint:fix": "eslint docs/.vitepress/theme --fix",
+    "prepare": "husky"
   },
   "keywords": [
     "easy-vibe",
@@ -26,9 +27,10 @@
     "@eslint/js": "^9.0.0",
     "eslint": "^9.0.0",
     "eslint-plugin-vue": "^9.30.0",
-    "vue-eslint-parser": "^9.4.3",
+    "husky": "^9.1.7",
     "markdown-it-katex": "^2.0.3",
-    "prettier": "^3.7.4"
+    "prettier": "^3.7.4",
+    "vue-eslint-parser": "^9.4.3"
   },
   "dependencies": {
     "@element-plus/icons-vue": "^2.3.2",