my-code-style 1.8.5 → 1.8.6

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## 变更日志
 
+## [1.8.6](https://github.com/myvn/codeStyle/compare/v1.8.5...v1.8.6) (2026-09-22)
+
+### 🐛 Bug Fixes | Bug 修复
+
+- 下游升级实测三缺陷——stylelint×prettier 内联互搏、release 脚本纠偏、stale versionrc 清理 ([7fa54f6](https://github.com/myvn/codeStyle/commit/7fa54f67aebc4497a9ce0f612758bd84d64ca550))
+
 ## [1.8.5](https://github.com/myvn/codeStyle/compare/v1.8.4...v1.8.5) (2026-09-22)
 
 ### 🐛 Bug Fixes | Bug 修复

package/README.md

@@ -214,7 +214,7 @@ npx my-code-style-init [--dry-run] [--backup] [--version|-v] [--help|-h]
 - **现代化 Git Hooks**：采用 Husky 9 原生极简 hook + lint-staged 互斥文件分组，串行运行、消除并发写入缓存冲突
 - **Stylelint SCSS、Less 及混合工程双支持**：支持纯 SCSS、纯 Less 以及两者共存的混合工程，放行 `@` 变量、小程序 `rpx`/`page`、深度选择器 `::v-deep` 及现代 CSS 伪类，组件内嵌多预处理器样式全面检查
 - **严格暂存区 Scope 猜测**：`guessCurrentScope()` 严格只依据 Git 暂存区推断 scope，支持多目录频次投票、重命名、物理删除、中文路径与空格路径
-- **ESM 兼容的自动版本发布**：支持 CommonJS（`.versionrc.js`）与 ESM（`.versionrc.cjs`）工程无缝对接 commit-and-tag-version（standard-version 的社区维护分支），一键版本递增与 CHANGELOG 生成
+- **ESM 兼容的自动版本发布**：支持 CommonJS（`.versionrc.js`）与 ESM（`.versionrc.cjs`）工程无缝对接 commit-and-tag-version（standard-version 的社区维护分支），一键版本递增与 CHANGELOG 生成。peer 范围有意钉在 `^12`：13.x 的 writer 存在回归且要求搭配新 preset 组合，稳定性待观察后再放宽（旧项目遗留的 `release: standard-version` 会在 init 时被自动纠偏）
 
 ## 常见问题（使用中遇到的问题）
 
@@ -240,12 +240,12 @@ npx my-code-style-init [--dry-run] [--backup] [--version|-v] [--help|-h]
 ## 测试套件
 
 ```bash
-npm run test:all               # 全量运行 184 项：用例明细 + 分类统计 + 最慢文件定位
+npm run test:all               # 全量运行 189 项：用例明细 + 分类统计 + 最慢文件定位
 npm run diagnose               # 换机器后先跑它：进程 / git / 文件系统 / hooks 各占多少
 npm run sweep                  # 给本机找最佳文件级并发（扫 integration 套件）
-npm test                       # 只跑基础 CLI 与配置矩阵（86 项）
+npm test                       # 只跑基础 CLI 与配置矩阵（88 项）
 npm run test:integration:setup # 安装现代化隔离依赖运行环境
-npm run test:integration       # Flat Config、真实 Husky 及提交链路测试（63 项）
+npm run test:integration       # Flat Config、真实 Husky 及提交链路测试（65 项）
 npm run test:legacy:setup      # 安装 ESLint 8 隔离运行环境
 npm run test:legacy            # ESLint 8.57.0 兼容性回归测试（27 项）
 npm run test:stylelint17:setup # 安装 Stylelint 17 隔离运行环境
@@ -258,20 +258,20 @@ npm run test:stylelint17       # Stylelint 17 生态兼容性回归（8 项）
 ```text
   my-code-style 测试套件
 
-  ▶ [1/4] 基础 CLI 与配置矩阵  （共 86 项，5 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+  ▶ [1/4] 基础 CLI 与配置矩阵  （共 88 项，5 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 运行器 TAP 解析：统计通过与失败、SKIP 与每用例耗时 · 7ms
       ✓ cz 交互提示为中文，且可选类型与 type-enum 一一对应 · 1ms
       ✓ peer 范围覆盖我们声明支持的上游大版本（校准防回退，BUG-027） · 0ms
       ✓ 一键安装命令对含 || 的版本范围加引号，可整段粘贴执行 · 40ms
       ✓ 初始化结尾指引把 cz 用法说清楚（先 git add + 指到 README 手册） · 80ms
       …
-     ✓ 通过 86  ·  3.6s   · 最慢文件 init-matrix.test.cjs 3.2s
+     ✓ 通过 88  ·  3.6s   · 最慢文件 init-matrix.test.cjs 3.4s
 
-  ▶ [2/4] 现代工具链与提交链  （共 63 项，24 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+  ▶ [2/4] 现代工具链与提交链  （共 65 项，24 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 完整提交链：JS/TS/Vue/nvue/CSS/less 自动修复及二次复检 · 10.4s
       ✓ 发布防呆：HEAD 已有 v* tag 时拦截（此时 release 工具会静默抬版并写出空 CHANGELOG） · 609ms
       …
-     ✓ 通过 63  ·  40.2s   · 最慢文件 commit-chain-both.test.cjs 10.7s
+     ✓ 通过 65  ·  45.3s   · 最慢文件 commit-chain-both.test.cjs 12.4s
 
   ▶ [3/4] ESLint 8 兼容性  （共 27 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 独立运行 ESLint 8 支持下限而非 ESLint 9 · 1ms
@@ -279,26 +279,26 @@ npm run test:stylelint17       # Stylelint 17 生态兼容性回归（8 项）
       …
      ✓ 通过 27  ·  18.3s
 
-  ▶ [4/4] Stylelint 17 兼容性  （共 8 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+  ▶ [4/4] Stylelint 17 兼容性  （共 9 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 隔离环境装的是 stylelint 17（不是 16） · 2ms
       ✓ 生成的 .stylelintrc.cjs 在 stylelint 17 下可加载并放过正常 SCSS · 700ms
       …
-     ✓ 通过 8  ·  7.2s
+     ✓ 通过 9  ·  8.2s
 
   ──────────────────────────────────────────────────────
   套件                      通过    失败    跳过    用时
   ──────────────────────────────────────────────────────
-  基础 CLI 与配置矩阵         86       0       -    3.6s
-  现代工具链与提交链          63       0       -   40.2s
+  基础 CLI 与配置矩阵         88       0       -    3.6s
+  现代工具链与提交链          65       0       -   45.3s
   ESLint 8 兼容性             27       0       -   18.7s
-  Stylelint 17 兼容性          8       0       -    7.3s
+  Stylelint 17 兼容性          9       0       -    8.2s
   ──────────────────────────────────────────────────────
-  合计                       184       0       -   69.1s
+  合计                       189       0       -   76.9s
   ──────────────────────────────────────────────────────
 
   ⏱ 最慢文件：eslint8.test.cjs 18.0s · commit-chain-less.test.cjs 11.4s · commit-chain-both.test.cjs 11.3s
 
-  ✅ 全部通过：184/184 项，用时 69.1s
+  ✅ 全部通过：189/189 项，用时 76.9s
 ```
 
 终端里每个套件下方还有一条实时进度条（`██████░░░░ 38/66  失败 0  4.0s`）。附加参数：
@@ -376,7 +376,7 @@ npm run test:all -- --profile     # 看每个测试文件耗时，定位瓶颈
 | `npm run test:integration`（运行器调度，自动并发 3）                        | 30.6s（只看集成套件那一段）                 |
 | 串行套件 + 文件级并发 23（全部一波）                                        | ✗ 3.8G 内存沙箱被 OOM 压垮（19 项 SIGKILL） |
 
-同机复测（184 项，同一台 2 核沙箱连续跑；绝对秒数随机器负载波动，相对关系稳定）：串行套件 + 文件级并发 1 = 72.3s、默认自动并发 3 = 69.1s、`--parallel` 四套件 = 64.0s、`npm run test:integration` = 43.3s、`node --test demo-test/integration/*.test.cjs` = 62.4s（部分为 182 项时实测，本轮仅集成套件 +2 用例，差值在秒级）。
+同机复测（189 项，同一台 2 核沙箱连续跑；绝对秒数随机器负载波动，相对关系稳定）：串行套件 + 文件级并发 1 = 84.4s、默认自动并发 3 = 76.9s、`npm run test:integration` = 45.3s（其余口径为早前基线实测，相对关系稳定）。
 
 （2 核沙箱里并行收益被 CPU 争抢吃掉大半，`--concurrency=1` 时单个文件只要 0.7–4.2s；
 16 核机器上集成套件那段 ≈ 最慢子文件，即"一次真实提交"的量级。）

package/bin/init

@@ -1031,6 +1031,25 @@ function main() {
                 backedUpCount++
             }
         }
+        // 与本次生成的 .versionrc.cjs 抢生效顺序的同名旧配置（.versionrc /
+        // .versionrc.json 会直接压过生成物，ESM 项目的 .versionrc.js 徒增歧义）：
+        // 备份后移除，不留"哪份在生效"的悬案（下游升级实测 D2）
+        const staleVersionrcFiles = [
+            ...staleVersionrcTop,
+            ...(staleVersionrc ? [".versionrc.js"] : []),
+        ]
+        for (const relPath of staleVersionrcFiles) {
+            if (!fileExists(relPath)) continue
+            const staleSrc = path.resolve(PROJECT_ROOT, relPath)
+            const staleTarget = path.resolve(backupDir, relPath)
+            ensureDir(path.dirname(staleTarget))
+            fs.copyFileSync(staleSrc, staleTarget)
+            fs.rmSync(staleSrc)
+            backedUpCount++
+            console.log(
+                `      · 旧 ${relPath} 已备份到 .my-code-style-backup/ 并移除（由 ${versionrcPath} 接管）`,
+            )
+        }
     }
 
     // ESLint 8 directory traversal defaults to .js; explicitly include typed
@@ -1182,6 +1201,16 @@ function modifyPackageJson(updates) {
     // Merge scripts: updates won't overwrite existing scripts with the same key
     if (updates.scripts) {
         pkg.scripts = { ...updates.scripts, ...(pkg.scripts || {}) }
+        // 唯一纠偏例外：standard-version 已停止维护且从未是我们的 peer，旧项目
+        // 遗留的 release: standard-version 会让 pnpm release 必然 command not
+        // found（下游 1.2 → 1.8.5 升级实测）。其余自定义脚本仍尊重不覆盖。
+        if (
+            typeof pkg.scripts.release === "string" &&
+            pkg.scripts.release.includes("standard-version")
+        ) {
+            pkg.scripts.release = updates.scripts.release
+            console.log("      ✓ release 脚本已从 standard-version 纠偏为 commit-and-tag-version")
+        }
     }
 
     // Set lint-staged (replace existing lint-staged to avoid stale/duplicate patterns)
@@ -1349,79 +1378,79 @@ const PEER_SOURCE_TARGETS = [
  *      stylelint ^17），以及 typescript-eslint 与其 parser/plugin 的版本错位。
  */
 function checkInstalledVersions({ peerDeps, allPeerDeps, rootDir = PROJECT_ROOT }) {
-    const problems = [];
-    const seen = new Set();
+    const problems = []
+    const seen = new Set()
     const add = (name, message, target) => {
-        const key = `${name}\u0000${message}`;
-        if (seen.has(key)) return;
-        seen.add(key);
-        problems.push({ name, message, target });
-    };
-    const minorOf = (version) => String(version).split(".").slice(0, 2).join(".");
+        const key = `${name}\u0000${message}`
+        if (seen.has(key)) return
+        seen.add(key)
+        problems.push({ name, message, target })
+    }
+    const minorOf = (version) => String(version).split(".").slice(0, 2).join(".")
 
     // 1) 本工具的 peer 范围 vs 实际安装
     for (const dep of allPeerDeps) {
-        const range = dep === "eslint" ? peerDeps.eslint : peerDeps[dep];
-        if (!range || range === "*" || range.startsWith("npm:")) continue;
-        const installed = findInstalledPackage(dep, rootDir);
-        if (!installed) continue;
-        const allowed = satisfiesRange(range, installed.version);
-        if (allowed === null || allowed) continue;
-        add(dep, `${dep} 装了 ${installed.version}，本工具要求 ${range}`, `${dep}@${range}`);
+        const range = dep === "eslint" ? peerDeps.eslint : peerDeps[dep]
+        if (!range || range === "*" || range.startsWith("npm:")) continue
+        const installed = findInstalledPackage(dep, rootDir)
+        if (!installed) continue
+        const allowed = satisfiesRange(range, installed.version)
+        if (allowed === null || allowed) continue
+        add(dep, `${dep} 装了 ${installed.version}，本工具要求 ${range}`, `${dep}@${range}`)
     }
 
     // 2) 上游配置包的 peer vs 实际安装（配置文件本身也会挑底层版本）
     for (const dep of PEER_SOURCE_PACKAGES) {
-        const source = findInstalledPackage(dep, rootDir);
-        if (!source) continue;
+        const source = findInstalledPackage(dep, rootDir)
+        if (!source) continue
         for (const [target, range] of Object.entries(source.manifest.peerDependencies || {})) {
-            if (!PEER_SOURCE_TARGETS.includes(target)) continue;
-            if (range === "*" || String(range).startsWith("npm:")) continue;
-            const installed = findInstalledPackage(target, rootDir);
+            if (!PEER_SOURCE_TARGETS.includes(target)) continue
+            if (range === "*" || String(range).startsWith("npm:")) continue
+            const installed = findInstalledPackage(target, rootDir)
             if (!installed) {
-                if (!rangeIntervals(range).length) continue;
+                if (!rangeIntervals(range).length) continue
                 add(
                     target,
                     `${dep}@${source.version} 需要 ${target}@${range}，项目里没有安装`,
                     `${target}@${range}`,
-                );
-                continue;
+                )
+                continue
             }
-            const allowed = satisfiesRange(range, installed.version);
-            if (allowed === null || allowed) continue;
+            const allowed = satisfiesRange(range, installed.version)
+            if (allowed === null || allowed) continue
             add(
                 target,
                 `${dep}@${source.version} 要求 ${target}@${range}，实际装了 ${installed.version}`,
                 `${target}@${range}`,
-            );
+            )
         }
     }
 
     // 3) typescript-eslint 与 @typescript-eslint/parser、eslint-plugin 必须同版本
-    const meta = findInstalledPackage("typescript-eslint", rootDir);
+    const meta = findInstalledPackage("typescript-eslint", rootDir)
     if (meta) {
         for (const sibling of ["@typescript-eslint/parser", "@typescript-eslint/eslint-plugin"]) {
-            const installed = findInstalledPackage(sibling, rootDir);
-            if (!installed) continue;
-            if (minorOf(installed.version) === minorOf(meta.version)) continue;
+            const installed = findInstalledPackage(sibling, rootDir)
+            if (!installed) continue
+            if (minorOf(installed.version) === minorOf(meta.version)) continue
             add(
                 sibling,
                 `${sibling}@${installed.version} 与 typescript-eslint@${meta.version} 不是同一版本`,
                 `${sibling}@${meta.version}`,
-            );
+            )
         }
     }
 
     if (!problems.length) return 0
-    console.log("");
-    warn(`以下依赖已安装，但版本与当前配置不匹配（${problems.length} 个）：`);
-    for (const problem of problems) console.log(`      · ${problem.message}`);
-    console.log("");
-    warn("对齐命令（可整段粘贴执行；也可以把上游配置包降到匹配的大版本）：");
-    const targets = [...new Set(problems.map((problem) => problem.target))];
+    console.log("")
+    warn(`以下依赖已安装，但版本与当前配置不匹配（${problems.length} 个）：`)
+    for (const problem of problems) console.log(`      · ${problem.message}`)
+    console.log("")
+    warn("对齐命令（可整段粘贴执行；也可以把上游配置包降到匹配的大版本）：")
+    const targets = [...new Set(problems.map((problem) => problem.target))]
     console.log(
         `        ${addDevCommand(detectPackageManager())} ${targets.map(shellSafeSpec).join(" ")}`,
-    );
+    )
     return problems.length
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-code-style",
-  "version": "1.8.5",
+  "version": "1.8.6",
   "description": "Lint/Format/Git 配置工程化 npm 包（ESLint + Prettier + Stylelint + Commitlint + Husky + standard-version）",
   "type": "commonjs",
   "main": "src/eslint/uniapp.cjs",

package/src/stylelint/index.cjs

@@ -6,7 +6,6 @@ module.exports = {
         "stylelint-config-recommended-scss",
         "stylelint-config-recommended-vue/scss",
         "stylelint-config-html/vue",
-        "stylelint-config-recess-order",
     ],
     plugins: ["stylelint-prettier"],
     ignoreFiles: [
@@ -21,14 +20,28 @@ module.exports = {
         {
             files: ["**/*.{vue,nvue,html}"],
             customSyntax: "postcss-html",
+            // 内联 style="..." 属性同时被 prettier（经 eslint-plugin-prettier 以 vue
+            // 解析器处理整份 SFC）格式化；stylelint 侧任何声明级 fixer（recess-order
+            // 重排、stylelint-prettier）对同一批内联属性都有独立主张，且 postcss-html
+            // 把属性内容 round-trip 时会有损（实测产生前导空格、丢失分号后空格），
+            // 两边对"正确形态"永远谈不拢——lint-staged 链 stylelint 最后执行，提交
+            // 产物永远 prettier-red，门禁无法收敛（下游 1.8.5 升级实测，BUG-031）。
+            // 因此 vue/html 交给 prettier 全权格式化：这里既关 stylelint-prettier，
+            // 也不启用 recess-order；<style> 块的格式化由 prettier CLI / eslint
+            // --fix 承担，stylelint 只保留下面 rules 里的语义规则。
+            rules: { "prettier/prettier": null },
         },
         {
             files: ["**/*.{css,scss}"],
             customSyntax: "postcss-scss",
+            // recess-order 只在纯样式文件生效（extends 在 lint 时惰性解析，
+            // 配置本体保持无 peer 可加载）；vue/html 的内联属性不参与排序
+            extends: ["stylelint-config-recess-order"],
         },
         {
             files: ["**/*.less"],
             customSyntax: "postcss-less",
+            extends: ["stylelint-config-recess-order"],
         },
     ],
     rules: {

package/src/stylelint/less.cjs

@@ -5,7 +5,6 @@ module.exports = {
         "stylelint-config-recommended",
         "stylelint-config-recommended-vue",
         "stylelint-config-html/vue",
-        "stylelint-config-recess-order",
     ],
     plugins: ["stylelint-prettier"],
     ignoreFiles: [
@@ -20,10 +19,17 @@ module.exports = {
         {
             files: ["**/*.{vue,nvue,html}"],
             customSyntax: "postcss-html",
+            // 与统一入口（index.cjs）同理：内联 style="..." 属性归 prettier 管，
+            // stylelint 侧的声明级 fixer（recess-order / stylelint-prettier）对它
+            // 的改写经 postcss-html round-trip 会有损且与 prettier 主张冲突，
+            // lint-staged 链尾的 stylelint --fix 会把提交产物改成 prettier-red
+            // 形态（BUG-031）。vue/html 只保留语义规则。
+            rules: { "prettier/prettier": null },
         },
         {
             files: ["**/*.less"],
             customSyntax: "postcss-less",
+            extends: ["stylelint-config-recess-order"],
         },
     ],
     rules: {