fix(ci): 修复 CI 失败的机制性问题

- package.json: 补回 docs-zh-hk 自己的 scripts (lint/clean/sync) 与 devDependencies (zhlint/commander/open/simple-git)
- ci.yml: pnpm-action 升级到 v4 + version 10 (与 packageManager 字段对齐)，pull_request branches 由 master 改为 main，pnpm install 改为 --frozen-lockfile
- pnpm-lock.yaml: 配合上面依赖变更重新生成（pnpm 10 格式）
- patches/zhlint@0.8.1.patch: 修补 case-abbrs.js 递归调用时 abbr[0] 为 undefined 触发 toLowerCase crash 的 bug
- guide/essentials/event-handling.md: 顺手把两处 i.e. 英文注释翻译成繁中

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: DaZuiZui

.github/workflows/ci.yml

@@ -4,21 +4,21 @@ on:
   push:
     branches-ignore: ['gh-pages']
   pull_request:
-    branches: [master]
+    branches: [main]
 
 jobs:
   build:
     runs-on: ubuntu-latest
 
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
         with:
-          version: 8
+          version: 10
       - uses: actions/setup-node@v4
         with:
           node-version: 20
           cache: 'pnpm'
       - run: |
-          pnpm install
+          pnpm install --frozen-lockfile
           pnpm lint

package.json

@@ -5,6 +5,9 @@
     "dev": "vitepress",
     "build": "vitepress build",
     "preview": "vitepress preview",
+    "lint": "zhlint 'src/{api,about,guide,sponsor,translations,tutorial}/**/*.md'",
+    "clean": "rm -rf .vitepress/dist",
+    "sync": "node scripts/sync.js",
     "preinstall": "npx only-allow pnpm",
     "type": "vue-tsc --noEmit"
   },
@@ -20,11 +23,15 @@
     "@types/body-scroll-lock": "^3.1.2",
     "@types/markdown-it": "^14.1.2",
     "@types/node": "^25.5.2",
+    "commander": "^9.5.0",
+    "open": "^10.1.0",
     "oxc-minify": "^0.124.0",
+    "simple-git": "^3.27.0",
     "typescript": "^5.9.3",
     "vitepress-plugin-group-icons": "^1.7.3",
     "vitepress-plugin-llms": "^1.12.0",
-    "vue-tsc": "^3.2.6"
+    "vue-tsc": "^3.2.6",
+    "zhlint": "0.8.1"
   },
   "engines": {
     "node": ">=20"
@@ -37,6 +44,9 @@
     "onlyBuiltDependencies": [
       "esbuild",
       "vue-demi"
-    ]
+    ],
+    "patchedDependencies": {
+      "zhlint@0.8.1": "patches/zhlint@0.8.1.patch"
+    }
   }
 }

patches/zhlint@0.8.1.patch

@@ -0,0 +1,17 @@
+diff --git a/lib/rules/case-abbrs.js b/lib/rules/case-abbrs.js
+index 3a7b720f7c809d7571a6ae39bf5b8354177a7fb9..3342164087b9c64b6f404d3aad2429599672c800 100644
+--- a/lib/rules/case-abbrs.js
++++ b/lib/rules/case-abbrs.js
+@@ -27,10 +27,10 @@ const reverseAbbrsIntoChars = (abbrs) => {
+ const matchAbbr = (token, group, reversedAbbrChars) => {
+     // find previous token
+     const tokenBefore = findTokenBefore(group, token);
+-    if (tokenBefore && !tokenBefore.spaceAfter) {
++    if (tokenBefore && !tokenBefore.spaceAfter && tokenBefore.value !== undefined) {
+         // get the next matching abbr chars by removing the last char and filtering
+         const matchedAbbrChars = reversedAbbrChars
+-            .filter((abbr) => abbr[0].toLowerCase() === tokenBefore.value.toLowerCase())
++            .filter((abbr) => abbr.length > 0 && typeof abbr[0] === 'string' && abbr[0].toLowerCase() === String(tokenBefore.value).toLowerCase())
+             .map((abbr) => abbr.slice(1));
+         // keep matching until any abbr chars fully matched
+         // then return true