my-code-style 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -1,14 +1,36 @@
 ## 变更日志
 
+## [1.6.0](https://github.com/myvn/codeStyle/compare/v1.4.0...v1.6.0) (2026-09-18)
+
+### 🐛 Bug Fixes | Bug 修复
+
+- 修复 ESLint 版本/样式检测误判、规则冲突与 scope 生成缺陷 ([033967b](https://github.com/myvn/codeStyle/commit/033967b0efadbb705bdafe5d4dfc34dbc90578c2))
+- 修复 Flat Config 缺 eslint:recommended、Prettier 选项漂移等 7 类问题 ([e4533bb](https://github.com/myvn/codeStyle/commit/e4533bbdaf5752146289a2b4e044ce59658c9453))
+
+### ✨ Features | 新功能
+
+- **diagnose:** ⑤ 拆分排队来源：纯 git 链膨胀 vs 完整链膨胀 vs 错峰启动 ([5caa437](https://github.com/myvn/codeStyle/commit/5caa4372d6ebbc52e19ec771b65d9a0edf041d63))
+- **diagnose:** 增加 ⑤ 并发压力段，量"单个耗时被并发放大多少倍" ([df060d5](https://github.com/myvn/codeStyle/commit/df060d56cecfa7f3b830864cc01082ee14583662))
+- **diagnose:** 对照 fixture 落在仓库内 vs 系统临时目录 ([7ea7fdc](https://github.com/myvn/codeStyle/commit/7ea7fdc6f913dcad1e76fb110241f875a204c341))
+- **diagnose:** 新增 npm run diagnose，定位"一次提交到底花在哪" ([61dbfdb](https://github.com/myvn/codeStyle/commit/61dbfdb99813384097cf2f243b31d20c84695cbd))
+- **init:** 补全 peer 体检并按包管理器输出命令，新增初始化链路文档 ([0396198](https://github.com/myvn/codeStyle/commit/03961983be3a6f8cda96d4047450e7595ffefb97))
+- **sweep:** 新增 --suite 过滤与 npm run sweep，给本机找最佳并发 ([d65254d](https://github.com/myvn/codeStyle/commit/d65254d1c9ef3277fbc23dc87bb6285d5ef3829c))
+
 ## [1.5.0](https://github.com/myvn/codeStyle/compare/v1.4.0...v1.5.0) (2026-09-18)
 
 ### 🐛 Bug Fixes | Bug 修复
 
 - 修复 ESLint 版本/样式检测误判、规则冲突与 scope 生成缺陷 ([033967b](https://github.com/myvn/codeStyle/commit/033967b0efadbb705bdafe5d4dfc34dbc90578c2))
+- 修复 Flat Config 缺 eslint:recommended、Prettier 选项漂移等 7 类问题 ([e4533bb](https://github.com/myvn/codeStyle/commit/e4533bbdaf5752146289a2b4e044ce59658c9453))
 
 ### ✨ Features | 新功能
 
+- **diagnose:** ⑤ 拆分排队来源：纯 git 链膨胀 vs 完整链膨胀 vs 错峰启动 ([5caa437](https://github.com/myvn/codeStyle/commit/5caa4372d6ebbc52e19ec771b65d9a0edf041d63))
+- **diagnose:** 增加 ⑤ 并发压力段，量"单个耗时被并发放大多少倍" ([df060d5](https://github.com/myvn/codeStyle/commit/df060d56cecfa7f3b830864cc01082ee14583662))
+- **diagnose:** 对照 fixture 落在仓库内 vs 系统临时目录 ([7ea7fdc](https://github.com/myvn/codeStyle/commit/7ea7fdc6f913dcad1e76fb110241f875a204c341))
+- **diagnose:** 新增 npm run diagnose，定位"一次提交到底花在哪" ([61dbfdb](https://github.com/myvn/codeStyle/commit/61dbfdb99813384097cf2f243b31d20c84695cbd))
 - **init:** 补全 peer 体检并按包管理器输出命令，新增初始化链路文档 ([0396198](https://github.com/myvn/codeStyle/commit/03961983be3a6f8cda96d4047450e7595ffefb97))
+- **sweep:** 新增 --suite 过滤与 npm run sweep，给本机找最佳并发 ([d65254d](https://github.com/myvn/codeStyle/commit/d65254d1c9ef3277fbc23dc87bb6285d5ef3829c))
 
 ## [1.4.0](https://github.com/myvn/codeStyle/compare/v1.2.0...v1.4.0) (2026-09-17)
 

package/README.md

@@ -191,14 +191,145 @@ npx my-code-style-init [--dry-run] [--backup] [--version|-v] [--help|-h]
 ## 测试套件
 
 ```bash
-npm test                       # 运行基础 CLI 与配置矩阵测试（59 项）
+npm run test:all               # 全量运行 152 项：用例明细 + 分类统计 + 最慢文件定位
+npm run diagnose               # 换机器后先跑它：进程 / git / 文件系统 / hooks 各占多少
+npm run sweep                  # 给本机找最佳文件级并发（扫 integration 套件）
+npm test                       # 只跑基础 CLI 与配置矩阵（70 项）
 npm run test:integration:setup # 安装现代化隔离依赖运行环境
-npm run test:integration       # 运行 Flat Config、真实 Husky 及提交链路测试（47 项）
+npm run test:integration       # Flat Config、真实 Husky 及提交链路测试（55 项）
 npm run test:legacy:setup      # 安装 ESLint 8 隔离运行环境
-npm run test:legacy            # 运行 ESLint 8.57.0 兼容性回归测试（27 项）
-npm run test:all               # 全量运行全部 133 项测试
+npm run test:legacy            # ESLint 8.57.0 兼容性回归测试（27 项）
 ```
 
+`npm run test:all` 由 `scripts/test-all.cjs` 驱动，输出**套件 → 用例 → 汇总**三层：
+每个大类下面列出它的每条用例（✓/✗/○ + 耗时），最后给出分类统计与总条数。
+
+```text
+  my-code-style 测试套件
+
+  ▶ [1/3] 基础 CLI 与配置矩阵  （共 70 项，5 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+      ✓ 运行器 TAP 解析：统计通过与失败、SKIP 与每用例耗时 · 2ms
+      ✓ 所有公共导出目标存在且可通过包名解析 · 11ms
+      ✓ Prettier 默认值和 JSON/YAML/nvue 文件例外 · 1ms
+      …
+     ✓ 通过 70  ·  2.1s   · 最慢文件 init-matrix.test.cjs 1.9s
+
+  ▶ [2/3] 现代工具链与提交链  （共 55 项，23 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+      ✓ 完整提交链：JS/TS/Vue/nvue/CSS/scss 自动修复及二次复检 · 8.0s
+      ✓ 完整提交链拦截 nvue 内嵌样式错误（不是仅检查脚本） · 3.6s
+      ✓ Flat Config 启用 eslint:recommended 核心规则：no-debugger · 45ms
+      …
+     ✓ 通过 55  ·  30.8s   · 最慢文件 commit-chain-both.test.cjs 8.4s
+
+  ▶ [3/3] ESLint 8 兼容性  （共 27 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+      ✓ ESLint 8 base：生成的 lint 脚本遍历并拦截 broken.ts · 1.1s
+      …
+     ✓ 通过 27  ·  14.3s
+
+  ──────────────────────────────────────────────────────
+  套件                      通过    失败    跳过    用时
+  ──────────────────────────────────────────────────────
+  基础 CLI 与配置矩阵         70       0       -    2.1s
+  现代工具链与提交链          55       0       -   30.8s
+  ESLint 8 兼容性             27       0       -   14.3s
+  ──────────────────────────────────────────────────────
+  合计                       152       0       -   47.2s
+  ──────────────────────────────────────────────────────
+
+  ⏱ 最慢文件：eslint8.test.cjs 14.3s · commit-chain-both.test.cjs 8.4s · commit-chain-scss.test.cjs 8.3s
+
+  ✅ 全部通过：152/152 项，用时 47.2s
+```
+
+
+
+终端里每个套件下方还有一条实时进度条（`██████░░░░ 38/66  失败 0  4.0s`）。附加参数：
+
+| 参数                 | 作用                                                          |
+| -------------------- | ------------------------------------------------------------- |
+| `-- --quiet`         | 只看套件结论与汇总表，不列用例明细（长输出时用）                |
+| `-- --parallel`      | 强制三个套件同时跑（核数 ≥ 8 时默认已自动开启）                 |
+| `-- --serial`        | 强制串行（CI 形态，输出顺序最稳定）                             |
+| `-- --jobs=2`        | 配合并行限制同时运行的套件数，其余排队（面板显示"等待中"）      |
+| `-- --suite=base,legacy` | 只跑指定套件（base / integration / legacy，逗号分隔）       |
+| `-- --concurrency=4` | 覆盖套件内文件级并发（默认按核数与内存自动算，封顶 8）             |
+| `-- --verbose`       | 展开每个套件的原始 TAP 输出（排查单条用例）                     |
+| `-- --profile`       | 额外列出每个测试文件的耗时（定位集成套件瓶颈时用）              |
+| `-- --no-count`      | 跳过预统计，进度条退化为"已完成 N 项"                           |
+| `-- --progress`      | 在非 TTY（CI 日志）中也强制刷新进度行                           |
+
+### 并行跑更快
+
+测试用例之间不用同一份目录：基础套件只用临时目录，集成套件用 `demo-test/.runtime`，
+ESLint 8 套件用 `demo-test/.runtime-legacy`，所以两层并行都是安全的。**核数 ≥ 8 的机器
+会自动开启套件级并行**（想固定成 CI 那种串行输出用 `--serial`）：
+
+想给本机定一个更合适的并发数，跑 `npm run sweep`：它会把 integration 套件在 auto/1/2/4/6/8/12/16/24 各跑一次，直接给出最快的那一档（并发越高越慢就说明瓶颈在进程启动而非 CPU）。
+
+换了机器发现某个套件特别慢？先跑 `npm run diagnose`：它会把「进程启动 / npx 开销 / git / 文件系统 / 一次真实提交的 hooks」逐项列出来，直接指出时间花在哪一层。
+
+```bash
+npm run test:all                  # 16 核机器：自动并行，墙钟 ≈ 最慢的那套
+npm run test:all -- --serial      # 强制串行
+npm run test:all -- --parallel    # 低核机器上强制并行
+npm run test:all -- --profile     # 看每个测试文件耗时，定位瓶颈
+```
+
+两层并行的实现：
+
+- **文件级**：集成套件按"一条提交链一个文件"拆成 23 个测试文件，**由运行器自己按文件
+  调度**（每个文件一个 `node --test` 进程），不依赖 Node 的 `--test` 默认并发值——
+  同一个文件内的用例仍然串行（真实 git 仓库不能并行改），文件之间才是并发的。
+- **套件级**：三个套件再并行，互不共享目录。
+
+因为每个文件里跑的都是真实 `git commit`（单次 0.5–3.9s），墙钟由**最慢的那个文件**
+决定，所以文件尽量拆到"一个文件一次提交"。每个套件跑完会直接告诉你最慢文件是谁，
+汇总区再给一次全局 `⏱ 最慢文件`：
+
+| integration 子文件（23 个） | 单文件耗时（2 核、串行） | 内容 |
+| -------------------------- | ---------------------- | ---- |
+| `commit-chain-{scss,less,both}` | 2.7–3.3s | 三种预处理器的完整提交链（各 1 次提交） |
+| `empty-commit-guard` | 2.7s | 空提交守卫（重复暂存不得产生漂移提交） |
+| `git-mv-rm` | 3.2s | `git mv` / `git rm` 走 lint-staged |
+| `embedded-style-{vue,nvue,mixed-less}` | 1.9–2.0s | Vue/nvue 内嵌样式错误拦截 |
+| `git-edge-{first-commit,stash}` | 2.1s / 1.7s | 首次提交、用户 stash 保留 |
+| `partial-staging{,-unstaged,-invalid-message,-conflict}` | 0.5–1.7s | 部分暂存与冲突恢复 |
+| `error-recovery-{css,scss,less,js,ts,vue,nvue}` | 0.5–1.4s | 不可修复错误的回滚 |
+| `lint` | 3.9s | 32 条规则与格式化行为（无提交链） |
+| `release` | 0.8s | standard-version |
+
+两层并发都要控制规模，所以默认并发不交给 Node 猜，而是运行器自己算——**核数 × 1.5
+（至少 核数 - 1），再乘内存上限，最后封顶 8**（16 核机器实测：4/6/8/12/16/24 并发对应
+20.3/18.7/19.0/19.2/18.9/19.1s，6–8 之后加并发只会让每个文件变慢；要更多用
+`--concurrency` 覆盖）：实测一条真实提交链（`git` + `npx` + `eslint` +
+`prettier`）峰值 RSS 约 0.8GB，运行器留 30% 内存给系统，避免并发过多的小内存机器被
+并发 git/npx 撑到 OOM（进程被 SIGKILL）；文件数多于并发数时，**用例少的文件（多半是同
+一条重链）优先开跑**，避免长任务被排进最后一波、墙钟再多乘一倍。
+
+实测（2 核沙箱，152 项；沙箱内存 4G，所以自动并发是 3）：
+
+| 运行方式                            | 墙钟时间                                        |
+| ----------------------------------- | ----------------------------------------------- |
+| 串行套件 + 文件级并发 1（CI 旧形态） | 62.4s（hook 改造前同配置 70.3s）                |
+| 串行套件 + 自动并发 3（默认）        | 47.2s（hook 改造前同配置 51.8s）                |
+| `--parallel` 三套件 + 自动并发 3     | 43.0s（hook 改造前同配置 46.6s）                |
+| `node --test demo-test/integration/*.test.cjs`（Node 自己调度，等同旧命令） | 43.7s（只看集成套件那一段）      |
+| `npm run test:integration`（运行器调度，自动并发 3） | 30.6s（只看集成套件那一段）                    |
+| 串行套件 + 文件级并发 23（全部一波） | ✗ 3.8G 内存沙箱被 OOM 压垮（19 项 SIGKILL）      |
+
+（2 核沙箱里并行收益被 CPU 争抢吃掉大半，`--concurrency=1` 时单个文件只要 0.7–4.2s；
+16 核机器上集成套件那段 ≈ 最慢子文件，即"一次真实提交"的量级。）
+生成的 hook 优先直连本地 bin（husky 已把 `node_modules/.bin` 放进 PATH），
+找不到时才退回 `npx --no-install`——每次提交因此少起两个 npm CLI（实测每个 hook
+省 130–185ms），提交链从 3.3s 降到 2.8s。集成 fixture 同样用环境变量传 git 身份
+（`GIT_AUTHOR_*` / `GIT_CONFIG_COUNT`）代替 4 次 `git config`。
+
+`demo-test/integration/_runtime.cjs` 用「指纹 + 目录锁」保证并发启动时只同步一次
+隔离环境源码，不会读到写了一半的文件；`prettier` / `eslint` 以 getter 惰性加载，
+只做提交链的 8 个文件不再为它们付启动开销。
+
+未安装隔离运行环境时，对应套件会明确标记"未运行"并给出 setup 命令，退出码为 1（不会假装全绿）。
+
 ## License
 
 MIT

package/bin/init

@@ -233,24 +233,58 @@ function majorsForRange(range) {
 }
 
 /**
- * Detect ESLint major version from package.json or installed node_modules
- * Returns 8, 9, or null (not installed or ambiguous)
+ * Read the actually installed ESLint major version. In a monorepo the binary is
+ * usually hoisted to the workspace root, so walk up to 8 levels; a version is
+ * only accepted from the project root itself or from an ancestor that looks
+ * like a workspace root (package.json / pnpm-workspace.yaml / lerna.json).
+ */
+function findInstalledEslintMajor(rootDir) {
+    let dir = rootDir
+    for (let depth = 0; depth < 8; depth += 1) {
+        // 只采纳项目根或“像工作区根”的祖先里的安装（package.json / pnpm-workspace.yaml /
+        // lerna.json）。中间层（如 monorepo 的 packages/）通常没有任何 manifest，
+        // 必须继续向上找；而完全无关的上级目录（例如 /tmp 或 $HOME 的 node_modules）
+        // 即使存在 eslint 也不能当作项目依赖。
+        const isProjectRoot = dir === rootDir
+        const isWorkspaceRoot =
+            fs.existsSync(path.resolve(dir, "package.json")) ||
+            fs.existsSync(path.resolve(dir, "pnpm-workspace.yaml")) ||
+            fs.existsSync(path.resolve(dir, "lerna.json"))
+
+        if (isProjectRoot || isWorkspaceRoot) {
+            try {
+                const installedPkgPath = path.resolve(dir, "node_modules", "eslint", "package.json")
+                if (fs.existsSync(installedPkgPath)) {
+                    const installedPkg = JSON.parse(fs.readFileSync(installedPkgPath, "utf8"))
+                    const installedMajor = parseInt(String(installedPkg.version).split(".")[0], 10)
+                    if (!Number.isNaN(installedMajor)) {
+                        return installedMajor
+                    }
+                }
+            } catch {
+                // ignore unreadable/partial installs and keep walking up
+            }
+        }
+
+        const parent = path.dirname(dir)
+        if (parent === dir) break
+        dir = parent
+    }
+    return null
+}
+
+/**
+ * Detect ESLint major version from the installed package or the declared range.
+ * Returns 8, 9, 10, … or null (not installed and no usable range).
  */
 function detectEslintVersion(pkg = getProjectPkg(), rootDir = PROJECT_ROOT) {
     if (!pkg) return null
 
-    // 1. If eslint is installed in node_modules, read its actual major version directly
-    try {
-        const installedPkgPath = path.resolve(rootDir, "node_modules", "eslint", "package.json")
-        if (fs.existsSync(installedPkgPath)) {
-            const installedPkg = JSON.parse(fs.readFileSync(installedPkgPath, "utf8"))
-            const installedMajor = parseInt(installedPkg.version?.split(".")[0], 10)
-            if (!Number.isNaN(installedMajor)) {
-                return installedMajor
-            }
-        }
-    } catch {
-        // Fall through to package.json dependency declaration
+    // 1. If eslint is installed in node_modules (or hoisted to the workspace root),
+    //    read its actual major version directly
+    const installedMajor = findInstalledEslintMajor(rootDir)
+    if (installedMajor !== null) {
+        return installedMajor
     }
 
     // 2. Parse package.json dependency declaration
@@ -398,12 +432,13 @@ function detectProjectType() {
  */
 function detectCssPreprocessor() {
     const pkg = getProjectPkg()
-    if (!pkg) return "scss"
-    const allDeps = {
-        ...(pkg.dependencies || {}),
-        ...(pkg.devDependencies || {}),
-        ...(pkg.peerDependencies || {}),
-    }
+    const allDeps = pkg
+        ? {
+              ...(pkg.dependencies || {}),
+              ...(pkg.devDependencies || {}),
+              ...(pkg.peerDependencies || {}),
+          }
+        : {}
 
     const hasSass = allDeps["sass"] || allDeps["node-sass"] || allDeps["sass-loader"]
     const hasLess = allDeps["less"] || allDeps["less-loader"]
@@ -437,6 +472,11 @@ function detectCssPreprocessor() {
         return "scss"
     }
 
+    // 无 package.json 时无法判断项目类型，不猜测样式方案（避免凭空安装一堆 stylelint 依赖）
+    if (!pkg) {
+        return "none"
+    }
+
     // If not a Vue/uni-app project and no css preprocessor found, skip stylelint
     if (!isVueProject()) {
         return "none"
@@ -678,15 +718,15 @@ function main() {
 
     if (eslintVersion !== null && eslintVersion < 8) {
         console.error(
-            `不支持 ESLint ${eslintVersion} 版本；本配置包仅支持 ESLint 8 或 9，未修改任何文件`,
+            `不支持 ESLint ${eslintVersion} 版本；本配置包仅支持 ESLint 8 / 9 / 10，未修改任何文件`,
         )
         process.exitCode = 1
         return
     }
 
-    if (eslintVersion !== null && eslintVersion >= 10) {
+    if (eslintVersion !== null && eslintVersion > 10) {
         warn(
-            `ESLint ${eslintVersion} 尚未在 peerDependencies 声明支持（^8.57.0 || ^9.0.0），将按 Flat Config 生成`,
+            `ESLint ${eslintVersion} 尚未在 peerDependencies 声明支持（^8.57.0 || ^9.0.0 || ^10.0.0），将按 Flat Config 生成`,
         )
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-code-style",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Lint/Format/Git 配置工程化 npm 包（ESLint + Prettier + Stylelint + Commitlint + Husky + standard-version）",
   "type": "commonjs",
   "main": "src/eslint/uniapp.cjs",
@@ -45,10 +45,12 @@
     "test": "node --test tests/*.test.cjs demo-test/*.test.cjs",
     "test:demo": "node --test demo-test/*.test.cjs",
     "test:integration:setup": "node demo-test/setup-integration.cjs",
-    "test:integration": "node --test demo-test/integration/*.test.cjs",
+    "test:integration": "node scripts/test-all.cjs --suite=integration",
     "test:legacy:setup": "node demo-test/setup-legacy.cjs",
-    "test:legacy": "node --test demo-test/legacy/*.test.cjs",
-    "test:all": "npm test && npm run test:integration && npm run test:legacy",
+    "test:legacy": "node scripts/test-all.cjs --suite=legacy",
+    "test:all": "node scripts/test-all.cjs",
+    "diagnose": "node scripts/diagnose-speed.cjs",
+    "sweep": "node scripts/sweep-concurrency.cjs",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write .",
@@ -67,12 +69,11 @@
   "peerDependencies": {
     "@commitlint/cli": "^19.0.0",
     "@commitlint/config-conventional": "^19.0.0",
-    "@eslint/eslintrc": "^3.0.0",
     "@eslint/js": "^9.0.0",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "czg": "^1.0.0",
-    "eslint": "^8.57.0 || ^9.0.0",
+    "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^3.0.0",
     "eslint-plugin-import": "^2.0.0",
@@ -105,9 +106,6 @@
     "@commitlint/config-conventional": {
       "optional": true
     },
-    "@eslint/eslintrc": {
-      "optional": true
-    },
     "@eslint/js": {
       "optional": true
     },

package/src/commitlint/scopes.cjs

@@ -147,6 +147,8 @@ function getStagedFiles(cwd) {
         const output = execSync("git diff --cached --name-only -z", {
             cwd,
             stdio: ["pipe", "pipe", "ignore"],
+            // 大仓库/大量暂存文件可能超过默认 1MB，避免 ENOBUFS 导致 scope 猜测整体失败
+            maxBuffer: 64 * 1024 * 1024,
         }).toString()
         return output.split("\0").filter(Boolean)
     } catch {
@@ -154,6 +156,7 @@ function getStagedFiles(cwd) {
             const output = execSync("git status --porcelain -z", {
                 cwd,
                 stdio: ["pipe", "pipe", "ignore"],
+                maxBuffer: 64 * 1024 * 1024,
             }).toString()
             const parts = output.split("\0")
             const staged = []

package/src/eslint/base.cjs

@@ -1,4 +1,9 @@
 // Base ESLint config for TypeScript projects
+//
+// Prettier 选项以 src/prettier/index.cjs 为唯一来源，避免 rules 与 prettier 配置文件漂移
+const prettierConfig = require("../prettier/index.cjs")
+const { overrides: _prettierOverrides, ...prettierOptions } = prettierConfig
+
 module.exports = {
     env: {
         browser: true,
@@ -40,16 +45,7 @@ module.exports = {
     ],
     rules: {
         // Prettier 集成
-        "prettier/prettier": [
-            "error",
-            {
-                singleQuote: false,
-                tabWidth: 4,
-                semi: false,
-                trailingComma: "all",
-                endOfLine: "lf",
-            },
-        ],
+        "prettier/prettier": ["error", prettierOptions],
         // 格式化与风格
         indent: "off",
         semi: ["error", "never"],

package/src/eslint/flat/_shared.mjs

@@ -1,19 +1,21 @@
 // Shared constants and rule objects for Flat Config files
+import prettierConfig from "../../prettier/index.cjs"
+
+// Prettier 选项以 src/prettier/index.cjs 为唯一来源，避免 rules 与配置文件漂移
+const { overrides: _prettierOverrides, ...prettierOptions } = prettierConfig
 
 /**
  * Prettier plugin rules — mirrors base.cjs prettier/prettier config
  */
 export const prettierRules = {
-    "prettier/prettier": [
-        "error",
-        {
-            singleQuote: false,
-            tabWidth: 4,
-            semi: false,
-            trailingComma: "all",
-            endOfLine: "lf",
-        },
-    ],
+    "prettier/prettier": ["error", prettierOptions],
+}
+
+/**
+ * .nvue 覆写：规则内联 options 会整体替换而非合并，必须携带完整选项
+ */
+export const nvuePrettierRules = {
+    "prettier/prettier": ["error", { ...prettierOptions, parser: "vue", semi: true }],
 }
 
 /**

package/src/eslint/flat/base.mjs

@@ -1,6 +1,7 @@
 // Base ESLint Flat Config for TypeScript projects (ESLint v9+)
 // Equivalent to src/eslint/base.cjs but in flat config format
 
+import js from "@eslint/js"
 import tseslint from "typescript-eslint"
 import importX from "eslint-plugin-import-x"
 import eslintPluginPrettierRecommended from "eslint-plugin-prettier/recommended"
@@ -22,8 +23,13 @@ export default [
         ],
     },
 
+    // ESLint 官方推荐规则
+    // Replaces: extends: ["eslint:recommended"] — 缺失它会让 flat 配置弱于传统配置
+    // （no-debugger / no-cond-assign / no-constant-condition / no-empty 等不会被检查）
+    js.configs.recommended,
+
     // TypeScript recommended rules
-    // Replaces: extends: ["eslint:recommended", "plugin:@typescript-eslint/recommended"]
+    // Replaces: extends: ["plugin:@typescript-eslint/recommended"]
     ...tseslint.configs.recommended,
 
     // eslint-plugin-import-x configuration

package/src/eslint/flat/vue3.mjs

@@ -4,6 +4,7 @@ import pluginVue from "eslint-plugin-vue"
 import tseslint from "typescript-eslint"
 import parserVue from "vue-eslint-parser"
 import baseConfig from "./base.mjs"
+import { nvuePrettierRules } from "./_shared.mjs"
 
 export default [
     // Spread all base configs first
@@ -54,7 +55,7 @@ export default [
             // the legacy config in src/eslint/vue3.cjs.
             semi: "off",
             // Prettier cannot infer a parser from the custom .nvue extension.
-            "prettier/prettier": ["error", { parser: "vue", semi: true }],
+            ...nvuePrettierRules,
         },
     },
 ]

package/src/eslint/vue3.cjs

@@ -1,6 +1,10 @@
 // Vue 3 ESLint config — extends base, adds Vue-specific rules
 const base = require("./base.cjs")
 
+// .nvue 覆写必须携带完整 Prettier 选项：规则内联 options 会整体替换而非合并
+const prettierConfig = require("../prettier/index.cjs")
+const { overrides: _prettierOverrides, ...prettierOptions } = prettierConfig
+
 module.exports = {
     ...base,
     parser: "vue-eslint-parser",
@@ -25,7 +29,7 @@ module.exports = {
             rules: {
                 "vue/comment-directive": "off",
                 semi: "off",
-                "prettier/prettier": ["error", { parser: "vue", semi: true }],
+                "prettier/prettier": ["error", { ...prettierOptions, parser: "vue", semi: true }],
             },
         },
     ],

package/src/husky/commit-msg

@@ -1 +1,5 @@
-npx --no-install commitlint --edit "${1}"
+# 同 pre-commit：直接用本地 commitlint，省掉一次 npm CLI（npx）启动。
+if command -v commitlint >/dev/null 2>&1; then
+    exec commitlint --edit "$1"
+fi
+npx --no-install commitlint --edit "$1"

package/src/husky/pre-commit

@@ -1 +1,6 @@
-npx --no-install -- lint-staged
+# husky 已经把 node_modules/.bin 放进 PATH，所以优先直接执行本地 lint-staged：
+# 这样每次提交少起一个 npm CLI（npx）进程；找不到时再退回 npx（例如被提升到上层目录）。
+if command -v lint-staged >/dev/null 2>&1; then
+    exec lint-staged
+fi
+npx --no-install -- lint-staged