my-code-style 1.8.0 → 1.8.2

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 ## 变更日志
 
+## [1.8.2](https://github.com/myvn/codeStyle/compare/v1.8.1...v1.8.2) (2026-09-21)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* versionrc 静默压优先级警告 + CHANGELOG 结构修复 + 发布工具迁移 catv@12 ([d1b8abf](https://github.com/myvn/codeStyle/commit/d1b8abfcccb595c33d4b9490e87b0599fe37b6bc))
+
+### [1.8.1](https://github.com/myvn/codeStyle/compare/v1.8.0...v1.8.1) (2026-09-20)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **init:** 安装命令里的版本范围加引号，粘贴不再被 shell 截断 ([9abaf1d](https://github.com/myvn/codeStyle/commit/9abaf1d76ea3aff05f0d26d11a43e8661ed6221a))
+
+
+### ✨ Features | 新功能
+
+* **init:** 输出步骤化为固定六步，dry-run 全流程预览 ([f14ca47](https://github.com/myvn/codeStyle/commit/f14ca47449b7d3e8f9a381b6e145e99232586886))
+
 ## [1.8.0](https://github.com/myvn/codeStyle/compare/v1.7.2...v1.8.0) (2026-09-20)
 
 ### ✨ Features | 新功能
@@ -12,8 +31,6 @@
 - **publish:** 增强 provenance 校验与日志自证，同步文档与发布流程 ([ba6db63](https://github.com/myvn/codeStyle/commit/ba6db63dce8144f53ad2be9c49278ff67b924518))
 - **修复:** Merge branch 'arena/01a0b214-codestyle' ([7c024dc](https://github.com/myvn/codeStyle/commit/7c024dce1bc1ef9d7fc9ef03b74f936b87a4704a))
 
-## [1.5.0](https://github.com/myvn/codeStyle/compare/v1.4.0...v1.5.0) (2026-09-18)
-
 ### [1.7.2](https://github.com/myvn/codeStyle/compare/v1.7.1...v1.7.2) (2026-09-20)
 
 ### 🐛 Bug Fixes | Bug 修复

package/README.md

@@ -189,7 +189,7 @@ module.exports = {
 | `my-code-style/stylelint/less-override` | Less 专用覆写配置             |
 | `my-code-style/commitlint`              | Commitlint 基础配置           |
 | `my-code-style/commitlint/scopes`       | 动态 scope 工具函数           |
-| `my-code-style/versionrc`               | standard-version 配置         |
+| `my-code-style/versionrc`               | commit-and-tag-version 配置   |
 
 ## CLI 初始化参数
 
@@ -213,7 +213,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`）工程无缝对接 standard-version，一键版本递增与 CHANGELOG 生成
+- **ESM 兼容的自动版本发布**：支持 CommonJS（`.versionrc.js`）与 ESM（`.versionrc.cjs`）工程无缝对接 commit-and-tag-version（standard-version 的社区维护分支），一键版本递增与 CHANGELOG 生成
 
 ## 常见问题（使用中遇到的问题）
 
@@ -239,10 +239,10 @@ npx my-code-style-init [--dry-run] [--backup] [--version|-v] [--help|-h]
 ## 测试套件
 
 ```bash
-npm run test:all               # 全量运行 175 项：用例明细 + 分类统计 + 最慢文件定位
+npm run test:all               # 全量运行 179 项：用例明细 + 分类统计 + 最慢文件定位
 npm run diagnose               # 换机器后先跑它：进程 / git / 文件系统 / hooks 各占多少
 npm run sweep                  # 给本机找最佳文件级并发（扫 integration 套件）
-npm test                       # 只跑基础 CLI 与配置矩阵（81 项）
+npm test                       # 只跑基础 CLI 与配置矩阵（85 项）
 npm run test:integration:setup # 安装现代化隔离依赖运行环境
 npm run test:integration       # Flat Config、真实 Husky 及提交链路测试（59 项）
 npm run test:legacy:setup      # 安装 ESLint 8 隔离运行环境
@@ -257,46 +257,46 @@ npm run test:stylelint17       # Stylelint 17 生态兼容性回归（8 项）
 ```text
   my-code-style 测试套件
 
-  ▶ [1/4] 基础 CLI 与配置矩阵  （共 81 项，5 文件 · 3 文件并发（自动：2 核 / 内存 4G））
-      ✓ 运行器 TAP 解析：统计通过与失败、SKIP 与每用例耗时 · 2ms
-      ✓ 运行器表格：CJK 宽度按两列计算，耗时格式化区分秒与毫秒 · 1ms
+  ▶ [1/4] 基础 CLI 与配置矩阵  （共 85 项，5 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+      ✓ 运行器 TAP 解析：统计通过与失败、SKIP 与每用例耗时 · 7ms
       ✓ cz 交互提示为中文，且可选类型与 type-enum 一一对应 · 1ms
-      ✓ 初始化结尾指引把 cz 用法说清楚（先 git add + 指到 README 手册） · 83ms
+      ✓ 一键安装命令对含 || 的版本范围加引号，可整段粘贴执行 · 44ms
+      ✓ 初始化结尾指引把 cz 用法说清楚（先 git add + 指到 README 手册） · 80ms
       …
-     ✓ 通过 81  ·  3.8s   · 最慢文件 init-matrix.test.cjs 3.5s
+     ✓ 通过 85  ·  3.7s   · 最慢文件 init-matrix.test.cjs 3.2s
 
   ▶ [2/4] 现代工具链与提交链  （共 59 项，23 文件 · 3 文件并发（自动：2 核 / 内存 4G））
-      ✓ 完整提交链：JS/TS/Vue/nvue/CSS/less 自动修复及二次复检 · 10.9s
-      ✓ 发布防呆：HEAD 已有 v* tag 时拦截（此时 standard-version 会静默抬版并写出空 CHANGELOG） · 461ms
+      ✓ 完整提交链：JS/TS/Vue/nvue/CSS/less 自动修复及二次复检 · 10.4s
+      ✓ 发布防呆：HEAD 已有 v* tag 时拦截（此时 release 工具会静默抬版并写出空 CHANGELOG） · 609ms
       …
-     ✓ 通过 59  ·  41.6s   · 最慢文件 commit-chain-scss.test.cjs 11.5s
+     ✓ 通过 59  ·  41.0s   · 最慢文件 commit-chain-both.test.cjs 10.6s
 
   ▶ [3/4] ESLint 8 兼容性  （共 27 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 独立运行 ESLint 8 支持下限而非 ESLint 9 · 1ms
-      ✓ ESLint 8 base：实际 CLI 加载生成配置并接受正常文件 · 1.7s
+      ✓ ESLint 8 base：实际 CLI 加载生成配置并接受正常文件 · 1.3s
       …
-     ✓ 通过 27  ·  20.5s
+     ✓ 通过 27  ·  18.3s
 
   ▶ [4/4] Stylelint 17 兼容性  （共 8 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 隔离环境装的是 stylelint 17（不是 16） · 2ms
-      ✓ 生成的 .stylelintrc.cjs 在 stylelint 17 下可加载并放过正常 SCSS · 747ms
+      ✓ 生成的 .stylelintrc.cjs 在 stylelint 17 下可加载并放过正常 SCSS · 700ms
       …
-     ✓ 通过 8  ·  7.5s
+     ✓ 通过 8  ·  7.2s
 
   ──────────────────────────────────────────────────────
   套件                      通过    失败    跳过    用时
   ──────────────────────────────────────────────────────
-  基础 CLI 与配置矩阵         81       0       -    3.8s
-  现代工具链与提交链          59       0       -   41.6s
-  ESLint 8 兼容性             27       0       -   20.5s
-  Stylelint 17 兼容性          8       0       -    7.5s
+  基础 CLI 与配置矩阵         85       0       -    3.7s
+  现代工具链与提交链          59       0       -   41.0s
+  ESLint 8 兼容性             27       0       -   18.3s
+  Stylelint 17 兼容性          8       0       -    7.2s
   ──────────────────────────────────────────────────────
-  合计                       175       0       -   73.5s
+  合计                       179       0       -   71.1s
   ──────────────────────────────────────────────────────
 
-  ⏱ 最慢文件：eslint8.test.cjs 20.5s · commit-chain-scss.test.cjs 11.5s · commit-chain-both.test.cjs 11.2s
+  ⏱ 最慢文件：eslint8.test.cjs 18.3s · commit-chain-both.test.cjs 10.6s · commit-chain-scss.test.cjs 10.6s
 
-  ✅ 全部通过：175/175 项，用时 73.5s
+  ✅ 全部通过：179/179 项，用时 71.1s
 ```
 
 终端里每个套件下方还有一条实时进度条（`██████░░░░ 38/66  失败 0  4.0s`）。附加参数：
@@ -353,7 +353,7 @@ npm run test:all -- --profile     # 看每个测试文件耗时，定位瓶颈
 | `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                        |
+| `release`                                                | 0.8s                     | commit-and-tag-version                  |
 
 两层并发都要控制规模，所以默认并发不交给 Node 猜，而是运行器自己算——**核数 × 1.5
 （至少 核数 - 1），再乘内存上限，最后封顶 8**（16 核机器实测：4/6/8/12/16/24 并发对应
@@ -374,7 +374,7 @@ npm run test:all -- --profile     # 看每个测试文件耗时，定位瓶颈
 | `npm run test:integration`（运行器调度，自动并发 3）                        | 30.6s（只看集成套件那一段）                 |
 | 串行套件 + 文件级并发 23（全部一波）                                        | ✗ 3.8G 内存沙箱被 OOM 压垮（19 项 SIGKILL） |
 
-同机复测（175 项，同一台 2 核沙箱连续跑；绝对秒数随机器负载波动，相对关系稳定）：串行套件 + 文件级并发 1 = 85.1s、默认自动并发 3 = 73.5s、`--parallel` 四套件 = 63.8s、`npm run test:integration` = 40.7s、`node --test demo-test/integration/*.test.cjs` = 54.5s。
+同机复测（179 项，同一台 2 核沙箱连续跑；绝对秒数随机器负载波动，相对关系稳定）：串行套件 + 文件级并发 1 = 70.4s、默认自动并发 3 = 71.1s、`--parallel` 四套件 = 66.8s、`npm run test:integration` = 41.2s、`node --test demo-test/integration/*.test.cjs` = 53.3s。
 
 （2 核沙箱里并行收益被 CPU 争抢吃掉大半，`--concurrency=1` 时单个文件只要 0.7–4.2s；
 16 核机器上集成套件那段 ≈ 最慢子文件，即"一次真实提交"的量级。）
@@ -399,7 +399,7 @@ npm run release:push
 
 也可以拆成两步：`npm run release` 只做到打 tag，之后用 `git push --follow-tags origin <分支>` 手动推送。
 
-> ⚠️ **别把两条命令连起来跑**：`release` 已经把 tag 打在 HEAD 上了，紧接着跑 `release:push`，standard-version **不会报错**，而是把版本号再抬一级、写出一个没有条目的空 CHANGELOG 并打出第二个 tag —— 等于多发一个空版本（npm 上不可撤销）。
+> ⚠️ **别把两条命令连起来跑**：`release` 已经把 tag 打在 HEAD 上了，紧接着跑 `release:push`，发布工具 **不会报错**，而是把版本号再抬一级、写出一个没有条目的空 CHANGELOG 并打出第二个 tag —— 等于多发一个空版本（npm 上不可撤销）。
 >
 > 两条命令的第一步都是 `scripts/release-guard.cjs` 发布前防呆，命中下面两种情况会直接中止并打印该执行的命令：HEAD 上已经有 `v*` tag（说明这一版已生成，只差推送）、已跟踪文件还有未提交改动（会被卷进版本提交）。未跟踪文件不拦截。
 

package/bin/init

@@ -65,7 +65,6 @@ function ensureGitignoreEntry(entry) {
         `${content}${separator}\n# my-code-style 初始化备份目录\n${entry}\n`,
         "utf8",
     )
-    log(`已将 ${entry} 追加到 .gitignore`)
 }
 
 function getProjectPkg() {
@@ -431,6 +430,28 @@ function addDevCommand(packageManager) {
     }
 }
 
+// 步骤标题行：CJK 字符按 2 列计宽，右侧补齐横线，让每个步骤标题线等长
+function displayWidth(text) {
+    let width = 0
+    for (const ch of text) {
+        width += ch.codePointAt(0) > 0xff ? 2 : 1
+    }
+    return width
+}
+
+function stepHeader(current, total, title) {
+    const head = `步骤 ${current}/${total} · ${title}`
+    const pad = Math.max(4, 46 - displayWidth(head))
+    console.log(`\n  ── ${head} ${"─".repeat(pad)}`)
+}
+
+// 打印安装规格时按需加引号：`name@range` 里含 || 或 >= 等字符会被 shell 当成
+// 管道/重定向，把整条命令截断（stylelint@^16.24.0 || ^17.0.0 原样粘贴必炸）。
+// 规格含安全字符集（字母数字 @ / . _ ^ ~ -）之外的任何字符就整体包一层双引号。
+function shellSafeSpec(spec) {
+    return /[^A-Za-z0-9@/._^~-]/.test(spec) ? `"${spec}"` : spec
+}
+
 /**
  * `pnpm prepare` / `yarn prepare` run the script directly, but npm needs an
  * explicit `npm run prepare` (plain `npm prepare` is not a command).
@@ -600,7 +621,7 @@ module.exports = {
 }
 
 function versionrcContent() {
-    return `// standard-version config — powered by my-code-style
+    return `// commit-and-tag-version config — powered by my-code-style
 module.exports = require("my-code-style/versionrc")
 `
 }
@@ -712,15 +733,17 @@ function main() {
     }
 
     const dryRun = process.argv.includes("--dry-run")
-    const label = dryRun ? "[DRY RUN] " : ""
 
-    console.log("")
-    console.log("  my-code-style-init — 初始化项目配置")
-    console.log("")
+    let toolVersion = ""
+    try {
+        toolVersion = ` v${require("../package.json").version}`
+    } catch {}
 
+    console.log("")
+    console.log(`  my-code-style-init${toolVersion} — 把 my-code-style 接入当前项目`)
     if (dryRun) {
-        warn("Dry run mode — no files will be written")
         console.log("")
+        warn("Dry run 预览模式：以下所有步骤都不会写入文件")
     }
 
     // --- Detection phase ---
@@ -752,11 +775,7 @@ function main() {
         return
     }
 
-    if (eslintVersion !== null && eslintVersion > 10) {
-        warn(
-            `ESLint ${eslintVersion} 尚未在 peerDependencies 声明支持（^8.57.0 || ^9.0.0 || ^10.0.0），将按 Flat Config 生成`,
-        )
-    }
+    const eslintUnannounced = eslintVersion !== null && eslintVersion > 10
 
     // Do not silently mix an installed major version with an incompatible format.
     if (
@@ -777,21 +796,32 @@ function main() {
     const useFlatConfig = eslintVersion !== 8
     const eslintFormat = useFlatConfig ? "flat" : "eslintrc"
 
-    log(`检测到 ESLint 版本: ${eslintVersion || "默认最新 (9+)"} → 使用 ${eslintFormat} 格式`)
-    log(
-        `检测到项目类型: ${projectType === "uniapp" ? "uni-app" : projectType === "vue" ? "Vue" : "Node/TS 基础"}`,
+    stepHeader(1, 6, "检测项目环境")
+    console.log(`      · 包管理器：${pm}`)
+    console.log(
+        `      · ESLint：${eslintVersion || "未声明，按已安装版本处理"} → ${eslintFormat === "flat" ? "Flat Config" : "传统 .eslintrc 格式"}`,
     )
-    log(
-        `检测到 CSS 预处理器: ${cssPreprocessor === "both" ? "SCSS + Less (混合)" : cssPreprocessor}`,
+    console.log(
+        `      · 项目类型：${projectType === "uniapp" ? "uni-app" : projectType === "vue" ? "Vue" : "Node/TS 基础库"}`,
     )
-    console.log("")
+    console.log(
+        `      · CSS 预处理器：${cssPreprocessor === "both" ? "SCSS + Less（混合）" : cssPreprocessor === "none" ? "未检测到" : cssPreprocessor}`,
+    )
+    if (eslintUnannounced) {
+        warn(
+            `ESLint ${eslintVersion} 尚未在 peerDependencies 声明支持（^8.57.0 || ^9.0.0 || ^10.0.0），将按 Flat Config 生成`,
+        )
+    }
 
     // --- Build file list based on detection ---
     const files = []
+    let skipStylelint = false
 
+    stepHeader(2, 6, "ESLint 入口")
     if (hasFlatConfigFile || hasLegacyConfigFile) {
-        log("保留已有 ESLint 配置，不生成额外入口")
+        console.log("      保留已有 ESLint 配置，不生成额外入口")
     } else if (useFlatConfig) {
+        console.log("      生成 Flat Config 入口 eslint.config.mjs")
         files.push({
             path: "eslint.config.mjs",
             exists:
@@ -802,6 +832,7 @@ function main() {
             content: eslintFlatConfigContent(projectType),
         })
     } else {
+        console.log("      生成传统格式入口 .eslintrc.cjs")
         files.push({
             path: ".eslintrc.cjs",
             exists: fileExists(".eslintrc.cjs"),
@@ -829,7 +860,7 @@ function main() {
             content: stylelintrcContent(cssPreprocessor),
         })
     } else {
-        log("跳过 Stylelint 配置 (未检测到 CSS 预处理器)")
+        skipStylelint = true
     }
 
     files.push({
@@ -844,11 +875,10 @@ function main() {
         versionrcPath = ".versionrc.cjs"
     }
 
-    if (isEsm && fileExists(".versionrc.js") && !fileExists(".versionrc.cjs")) {
-        warn(
-            "检测到 ESM 项目 (type: module) 存在旧的 .versionrc.js，standard-version 需使用 .versionrc.cjs",
-        )
-    }
+    const staleVersionrc = isEsm && fileExists(".versionrc.js") && !fileExists(".versionrc.cjs")
+    // 发布工具读配置的顺序是 ['.versionrc', '.versionrc.cjs', '.versionrc.json', '.versionrc.js']：
+    // 无扩展名或 .json 的旧文件会压过本次生成的 .versionrc.cjs（实测 standard-version 9.5 / catv 均如此）
+    const staleVersionrcTop = [".versionrc", ".versionrc.json"].filter((f) => fileExists(f))
 
     files.push({
         path: versionrcPath,
@@ -876,12 +906,17 @@ function main() {
         })
     }
 
-    // Show what will be created/overwritten
+    const backup = args.includes("--backup")
+    stepHeader(3, 6, "配置文件与 Git hooks")
+    let overwriteTotal = 0
+    let createTotal = 0
     for (const f of files) {
         if (f.exists) {
-            warn(`${label}覆盖 ${f.path}`)
+            overwriteTotal++
+            console.log(`      覆盖 ${f.path}`)
         } else {
-            success(`${label}创建 ${f.path}`)
+            createTotal++
+            console.log(`      新建 ${f.path}`)
         }
     }
 
@@ -889,7 +924,7 @@ function main() {
     const huskyDir = path.resolve(PROJECT_ROOT, ".husky")
     const hasHusky = fs.existsSync(huskyDir)
     if (!hasHusky) {
-        success(`${label}创建 .husky/ 目录`)
+        console.log("      新建 .husky/ 目录")
     }
 
     const hooks = [
@@ -899,23 +934,91 @@ function main() {
 
     for (const h of hooks) {
         if (fileExists(h.path)) {
-            warn(`${label}覆盖 ${h.path}`)
+            overwriteTotal++
+            console.log(`      覆盖 ${h.path}`)
         } else {
-            success(`${label}创建 ${h.path}`)
+            createTotal++
+            console.log(`      新建 ${h.path}`)
         }
     }
 
-    if (dryRun) {
+    console.log(
+        `      小计：覆盖 ${overwriteTotal} 个 · 新建 ${createTotal} 个` +
+            (backup ? " · 旧文件将备份到 .my-code-style-backup/" : "") +
+            (dryRun ? "（Dry run 预览，不写入）" : ""),
+    )
+    if (skipStylelint) {
+        console.log("      · 跳过 .stylelintrc.cjs（未检测到 CSS 预处理器）")
+    }
+    if (staleVersionrc) {
+        warn(
+            "检测到 ESM 项目 (type: module) 存在旧的 .versionrc.js，发布工具需要使用 .versionrc.cjs",
+        )
+    }
+    if (staleVersionrcTop.length > 0) {
+        warn(
+            `检测到 ${staleVersionrcTop.join("、")}：发布工具会优先读取它，本次生成的 .versionrc.cjs 不会生效；请把配置合并进来或删除旧文件`,
+        )
+    }
+
+    const printPackageJsonStep = () => {
+        stepHeader(4, 6, "package.json")
+        if (dryRun) {
+            console.log(
+                "      · 将更新 scripts（lint / lint:fix / format / prepare / release / cz）与 lint-staged",
+            )
+            return
+        }
+        console.log("      ✓ scripts 已更新（lint / lint:fix / format / prepare / release / cz）")
+        console.log("      ✓ lint-staged 已按检测到的 CSS 预处理器生成")
+    }
+
+    const printDepsStep = () => {
+        stepHeader(5, 6, "依赖体检")
+        const findings = checkPeerDeps({ useFlatConfig, cssPreprocessor, projectType })
+        if (findings === 0) {
+            console.log("      ✓ 已装依赖版本都在要求范围内，声明的依赖也都已安装")
+        }
+    }
+
+    const printFooter = () => {
+        stepHeader(6, 6, "接下来")
+        console.log(`      1. 启用 husky hooks：${runScriptCommand(pm, "prepare")}`)
+        console.log(`      2. 首次检查：${runScriptCommand(pm, "lint")}`)
+        console.log("      3. 使用 czg 提交 commit：")
+        console.log(`         ${runScriptCommand(pm, "cz")}`)
+        console.log(
+            "         （先 git add 暂存改动；交互步骤、类型与 scope 规则见本包 README《用 pnpm cz 提交》）",
+        )
+        if (pm === "pnpm") {
+            console.log("")
+            console.log(
+                "      提示：pnpm 10+ 默认拦截依赖的构建脚本，若安装时提示 ERR_PNPM_IGNORED_BUILDS（如 unrs-resolver），执行 pnpm approve-builds 后重试。",
+            )
+        }
         console.log("")
-        warn("Dry run 结束，未修改任何文件")
+        if (dryRun) {
+            success("Dry run 结束：未写入任何文件；去掉 --dry-run 执行真实初始化")
+        } else {
+            success(
+                `初始化完成：覆盖 ${overwriteTotal} 个 · 新建 ${createTotal} 个 · package.json 已更新`,
+            )
+        }
         console.log("")
+    }
+
+    // Dry run：把 package.json / 依赖体检 / 下一步三步也预览出来，然后结束
+    if (dryRun) {
+        printPackageJsonStep()
+        printDepsStep()
+        printFooter()
         return
     }
 
     // Optional backup of existing files before modifying
-    const backup = args.includes("--backup")
+    const backupDir = path.resolve(PROJECT_ROOT, ".my-code-style-backup")
+    let backedUpCount = 0
     if (backup) {
-        const backupDir = path.resolve(PROJECT_ROOT, ".my-code-style-backup")
         ensureDir(backupDir)
         // package.json is rewritten (scripts + lint-staged), so it must be backed
         // up as well — users lose custom lint-staged groups otherwise.
@@ -925,7 +1028,7 @@ function main() {
                 const targetPath = path.resolve(backupDir, item.path)
                 ensureDir(path.dirname(targetPath))
                 fs.copyFileSync(srcPath, targetPath)
-                log(`已备份 ${item.path} -> .my-code-style-backup/${item.path}`)
+                backedUpCount++
             }
         }
     }
@@ -1003,16 +1106,19 @@ function main() {
                 "lint:fix": `${lintCommand} --fix`,
                 format: "prettier --write .",
                 prepare: "husky",
-                release: "standard-version",
+                release: "commit-and-tag-version",
                 cz: "czg",
             },
             "lint-staged": getLintStagedConfig(cssPreprocessor),
         })
-        success("更新 package.json (scripts + lint-staged)")
+        printPackageJsonStep()
 
         // The backup directory is ours, not the user's source — keep it out of git
         if (backup) {
             ensureGitignoreEntry(".my-code-style-backup/")
+            console.log(
+                `      ✓ ${backedUpCount} 个旧文件已备份到 .my-code-style-backup/（目录已写入 .gitignore）`,
+            )
         }
     } catch (err) {
         console.error(`\n  ✖ 初始化写入失败: ${err.message}；正在回滚...`)
@@ -1048,40 +1154,8 @@ function main() {
         return
     }
 
-    // Check for missing peerDependencies
-    checkPeerDeps({ useFlatConfig, cssPreprocessor, projectType })
-
-    console.log("")
-    success("配置初始化完成！")
-    console.log("")
-    console.log("  下一步：")
-    console.log("  1. 确保已安装 peerDependencies：")
-    console.log(`     ${addDevCommand(pm)} my-code-style`)
-    if (useFlatConfig) {
-        console.log("  2. Flat Config 需要的额外依赖：")
-        console.log(
-            `     ${addDevCommand(pm)} typescript-eslint globals eslint-plugin-import-x @eslint/js`,
-        )
-        console.log("  3. 初始化 husky：")
-        console.log(`     ${runScriptCommand(pm, "prepare")}`)
-        console.log("  4. 使用 czg 提交 commit：")
-    } else {
-        console.log("  2. 初始化 husky：")
-        console.log(`     ${runScriptCommand(pm, "prepare")}`)
-        console.log("  3. 使用 czg 提交 commit：")
-    }
-    console.log(`     ${runScriptCommand(pm, "cz")}`)
-    console.log(
-        "     （先 git add 暂存改动；交互步骤、类型与 scope 规则见本包 README《用 pnpm cz 提交》）",
-    )
-    if (pm === "pnpm") {
-        console.log("")
-        console.log("  提示：pnpm 10+ 默认拦截依赖的构建脚本，若安装时提示")
-        console.log(
-            "  ERR_PNPM_IGNORED_BUILDS（如 unrs-resolver），执行 pnpm approve-builds 后重试。",
-        )
-    }
-    console.log("")
+    printDepsStep()
+    printFooter()
 }
 
 function modifyPackageJson(updates) {
@@ -1131,11 +1205,11 @@ function checkPeerDeps({
     projectType = "base",
 } = {}) {
     const pkg = getProjectPkg()
-    if (!pkg) return
+    if (!pkg) return 0
 
     // If running within the package itself, skip external missing deps check
     if (pkg.name === "my-code-style") {
-        return
+        return 0
     }
 
     const baseDeps = [
@@ -1149,7 +1223,7 @@ function checkPeerDeps({
         "husky",
         "lint-staged",
         "czg",
-        "standard-version",
+        "commit-and-tag-version",
     ]
 
     const flatDeps = useFlatConfig
@@ -1225,23 +1299,24 @@ function checkPeerDeps({
         ...(pkg.devDependencies || {}),
     }
 
-    checkInstalledVersions({ peerDeps, allPeerDeps })
+    const versionProblems = checkInstalledVersions({ peerDeps, allPeerDeps })
 
     const missing = allPeerDeps.filter((dep) => !allDeps[dep])
     if (missing.length > 0) {
         console.log("")
-        warn(`以下依赖未安装：${missing.join(", ")}`)
+        warn(`以下依赖未安装（${missing.length} 个）：${missing.join(", ")}`)
         console.log("")
-        warn("一键安装命令：")
-        console.log(`  ${addDevCommand(detectPackageManager())} my-code-style \\`)
+        warn("一键安装命令（可整段粘贴执行）：")
+        console.log(`        ${addDevCommand(detectPackageManager())} my-code-style \\`)
         missing.forEach((dep, i) => {
             const version =
                 dep === "eslint" ? (useFlatConfig ? "^9.0.0" : "^8.57.0") : peerDeps[dep] || ""
-            const depWithVersion = version ? `${dep}@${version}` : dep
+            const depWithVersion = shellSafeSpec(version ? `${dep}@${version}` : dep)
             const suffix = i < missing.length - 1 ? " \\" : ""
-            console.log(`  ${depWithVersion}${suffix}`)
+            console.log(`          ${depWithVersion}${suffix}`)
         })
     }
+    return missing.length + versionProblems
 }
 
 // 体检时会顺着这些包的 peerDependencies 反查底层依赖的实际版本
@@ -1337,14 +1412,17 @@ function checkInstalledVersions({ peerDeps, allPeerDeps, rootDir = PROJECT_ROOT
         }
     }
 
-    if (!problems.length) return;
+    if (!problems.length) return 0
     console.log("");
-    warn("以下依赖已安装，但版本与当前配置不匹配：");
-    for (const problem of problems) console.log(`  · ${problem.message}`);
+    warn(`以下依赖已安装，但版本与当前配置不匹配（${problems.length} 个）：`);
+    for (const problem of problems) console.log(`      · ${problem.message}`);
     console.log("");
-    warn("对齐命令（也可以把上游配置包降到与你现有版本匹配的大版本）：");
+    warn("对齐命令（可整段粘贴执行；也可以把上游配置包降到匹配的大版本）：");
     const targets = [...new Set(problems.map((problem) => problem.target))];
-    console.log(`  ${addDevCommand(detectPackageManager())} ${targets.join(" ")}`);
+    console.log(
+        `        ${addDevCommand(detectPackageManager())} ${targets.map(shellSafeSpec).join(" ")}`,
+    );
+    return problems.length
 }
 
 // Only run when executed directly; requiring this file must be side-effect free.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-code-style",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "Lint/Format/Git 配置工程化 npm 包（ESLint + Prettier + Stylelint + Commitlint + Husky + standard-version）",
   "type": "commonjs",
   "main": "src/eslint/uniapp.cjs",
@@ -57,8 +57,8 @@
     "lint:fix": "eslint . --fix",
     "format": "prettier --write .",
     "prepare": "node -e \"if (!process.env.CI) { try { require('child_process').execSync('husky', { stdio: 'ignore' }) } catch {} }\"",
-    "release": "node scripts/release-guard.cjs && standard-version",
-    "release:push": "node scripts/release-guard.cjs && standard-version && git push --follow-tags origin HEAD",
+    "release": "node scripts/release-guard.cjs && commit-and-tag-version",
+    "release:push": "node scripts/release-guard.cjs && commit-and-tag-version && git push --follow-tags origin HEAD",
     "pub": "npm run release:push",
     "cz": "czg",
     "link": "pnpm link --global",
@@ -74,6 +74,7 @@
     "@eslint/js": "^9.0.0",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
+    "commit-and-tag-version": "^12.0.0",
     "czg": "^1.0.0",
     "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
     "eslint-config-prettier": "^10.1.8",
@@ -89,7 +90,6 @@
     "postcss-less": "^6.0.0",
     "postcss-scss": "^4.0.0",
     "prettier": "^3.0.0",
-    "standard-version": "^9.0.0",
     "stylelint": "^16.24.0 || ^17.0.0",
     "stylelint-config-html": "^2.0.0",
     "stylelint-config-recess-order": "^5.0.0 || ^6.0.0 || ^7.0.0",
@@ -163,9 +163,6 @@
     "prettier": {
       "optional": true
     },
-    "standard-version": {
-      "optional": true
-    },
     "stylelint": {
       "optional": true
     },
@@ -198,10 +195,28 @@
     },
     "vue-eslint-parser": {
       "optional": true
+    },
+    "commit-and-tag-version": {
+      "optional": true
     }
   },
   "devDependencies": {
-    "standard-version": "^9.5.0"
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/js": "^9.39.5",
+    "commit-and-tag-version": "^12.7.3",
+    "czg": "^1.14.0",
+    "eslint": "^9.39.5",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^3.10.1",
+    "eslint-plugin-import-x": "^4.17.1",
+    "eslint-plugin-prettier": "^5.5.6",
+    "globals": "^16.5.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
+    "prettier": "^3.9.8",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.70.0"
   },
   "keywords": [
     "eslint-config",

package/src/versionrc/index.cjs

@@ -1,4 +1,4 @@
-// standard-version config
+// commit-and-tag-version config（standard-version 的社区维护分支，配置兼容）
 module.exports = {
     header: "## 变更日志\n",
     types: [