ci(workflow): 添加脚本测试与改进预提交检查

- 在 GitHub Actions CI 工作流中添加 npm run test:scripts 测试步骤
- 在 package.json 中新增 test:scripts 脚本用于运行脚本相关测试
- 优化 husky 预提交钩子，失败时输出提示信息并阻止提交
- 新增 scripts/pre-commit.js 脚本，利用 lint-staged API 实现更严格的预提交检查
- 预提交检查包含 ESLint 自动修复和 Prettier 格式化，确保代码质量

Author: hqwlkj

.github/workflows/ci.yml

@@ -48,3 +48,6 @@ jobs:
 
       - name: Test
         run: npm test
+
+      - name: Test Scripts
+        run: npm run test:scripts

.husky/pre-commit

@@ -1 +1,9 @@
-npx lint-staged
+npm run pre-commit || {
+  echo ''
+  echo '===================================================='
+  echo 'pre-commit checks failed. in case of emergency, run:'
+  echo ''
+  echo 'git commit --no-verify'
+  echo '===================================================='
+  exit 1
+}

package.json

@@ -26,11 +26,13 @@
     "start": "node scripts/start.js",
     "build-and-start": "npm run build && npm run start",
     "test": "npm run test --workspaces --if-present",
+    "test:scripts": "node --test scripts/__tests__/*.test.js",
     "release:version": "node scripts/version.js",
     "prepare:package": "node scripts/prepare-package.js",
     "prepare:vscode": "node scripts/prepare-vscode.js",
     "changelog": "node scripts/generate-changelog.js",
-    "prepare": "husky && npm run build && npm run bundle"
+    "prepare": "husky && npm run build && npm run bundle",
+    "pre-commit": "node scripts/pre-commit.js"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.4",

scripts/pre-commit.js

@@ -0,0 +1,25 @@
+/**
+ * pre-commit hook 脚本
+ *
+ * 在 git commit 前自动执行 lint-staged，对暂存区的文件进行：
+ *   - ESLint 检查并自动修复（*.{ts,tsx,js,mjs,cjs,jsx}）
+ *   - Prettier 格式化（*.{ts,tsx,js,mjs,cjs,jsx,json} 及 .prettierrc）
+ *
+ * 由 .husky/pre-commit 调用，lint-staged 失败时会阻止提交。
+ */
+
+import { execSync } from "node:child_process";
+import lintStaged from "lint-staged";
+
+try {
+  // 获取 git 仓库根目录，作为 lint-staged 的工作目录
+  const root = execSync("git rev-parse --show-toplevel").toString().trim();
+
+  // 通过 lint-staged API 直接运行，仅处理暂存区文件
+  const passed = await lintStaged({ cwd: root });
+
+  // lint-staged 全部通过则正常退出，否则以失败码退出阻止提交
+  process.exit(passed ? 0 : 1);
+} catch {
+  process.exit(1);
+}