my-code-style 1.9.4 → 1.9.5

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## 变更日志
 
+## [1.9.5](https://github.com/myvn/codeStyle/compare/v1.9.4...v1.9.5) (2026-10-20)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **config:** Less 线误报、ESLint root、doctor 变体判定 ([7c9cc87](https://github.com/myvn/codeStyle/commit/7c9cc8771bbf5a94c61117d7afdf111a21ea162d))
+
 ## [1.9.4](https://github.com/myvn/codeStyle/compare/v1.9.3...v1.9.4) (2026-09-28)
 
 ## [1.9.3](https://github.com/myvn/codeStyle/compare/v1.9.2...v1.9.3) (2026-09-23)

package/README.md

@@ -33,6 +33,8 @@ pnpm prepare                          # npm: npm run prepare
 pnpm lint
 ```
 
+> **pnpm 10+ 用户注意**：依赖里带构建脚本的包（`esbuild`、`unrs-resolver` 等）默认被拦截，安装后补一条 `pnpm approve-builds` 放行即可，不是初始化失败。想写进配置：pnpm 10.26 起用 `pnpm-workspace.yaml` 的 `allowBuilds`（`包名: true` 映射，取代已弃用的 `onlyBuiltDependencies` 列表），pnpm 11+ 已不再读取旧键（pnpm 12 会静默忽略，仍报 `ERR_PNPM_IGNORED_BUILDS`）。
+
 init 脚本会自动检测技术栈类型（uni-app / Vue 3 / Node 基础库）、ESLint 版本、CSS 预处理器和包管理器，按需生成配置文件，并在结尾列出尚未安装的 peerDependencies 与对应安装命令。
 
 初始化后：`lint-staged` 会在 `git commit` 时自动修复暂存文件，`commitlint` 校验提交信息，`pnpm release` 生成版本与 CHANGELOG。全过程细节见 [docs/init-flow.md](docs/init-flow.md)，收益与代价评估见 [docs/manual.md](docs/manual.md)。
@@ -234,7 +236,7 @@ npx my-code-style-doctor
 
 对既有项目随时复验（init 的依赖体检只在新装/重装时打印一次）：
 
-- **peer 依赖**：按项目类型裁剪核对（与 init 同口径——ESLint 8 才查 classic import、无预处理器不查 stylelint 族），缺失/版本越界逐项报红，并输出可整段粘贴的补齐命令；
+- **peer 依赖**：按项目类型裁剪核对（与 init 同口径——ESLint 8 才查 classic import、不涉样式的项目不查 stylelint 族）。stylelint 变体**以项目实际的配置为准**（`.stylelintrc.cjs` extends 的是 `stylelint/less` 就只查 Less 线的 peer，不会给纯 Less 项目索要 `postcss-scss`），没有配置文件时才回落到依赖推断；缺失/版本越界逐项报红，并输出可整段粘贴的补齐命令；
 - **husky hooks**：存在 / 非空 / 可执行位 / 引用命令可解析 / `core.hooksPath` 指向；
 - **lockfile**：是否被 `.gitignore` 排除（排除 = 不同机器版本组合不可复现）；
 - **配置文件**：四件套是否就位。
@@ -262,7 +264,7 @@ npx my-code-style-doctor
 | 只装了 `my-code-style`，`pnpm lint` 报找不到 eslint                  | peerDependencies 全部是 optional，不会自动安装                                                   | 按 CLI 结尾输出的清单装全，**别漏 `typescript`**（`@typescript-eslint/parser` / `typescript-eslint` 的必需 peer）                                                                                                                                       |
 | stylelint 报 `Could not find plugin "stylelint-order"`               | recess-order 7 把 stylelint-order 声明为 peer（非依赖），pnpm 10+ 严格模式 / npm / yarn 不自动装 | 显式安装 `stylelint-order`（对齐 peer 范围 `^6 \|\| ^7 \|\| ^8`；Vue/SCSS 项目必装）                                                                                                                                                                    |
 | `pnpm prepare` 输出 `.git can't be found`，hooks 不生效              | husky 必须在 git 仓库内执行                                                                      | 先 `git init`、再 `pnpm prepare`；验证 `git config core.hooksPath` 输出 `.husky/_`                                                                                                                                                                      |
-| 安装依赖报 `ERR_PNPM_IGNORED_BUILDS`（如 `unrs-resolver`）           | pnpm 10+ 默认拦截依赖的构建脚本                                                                  | 执行 `pnpm approve-builds` 后重新安装，不是初始化失败                                                                                                                                                                                                   |
+| 安装依赖报 `ERR_PNPM_IGNORED_BUILDS`（如 `unrs-resolver`）           | pnpm 10+ 默认拦截依赖的构建脚本                                                                  | 执行 `pnpm approve-builds` 后重新安装，不是初始化失败；要写进配置就用 `pnpm-workspace.yaml` 的 `allowBuilds`（pnpm 10.26+，取代已弃用的 `onlyBuiltDependencies`；pnpm 11+ 不再读旧键）                                                                  |
 | `eslint` 声明 `>=8.0.0` 却生成了 Flat Config                         | 无上界范围 npm 实际会装 9，CLI 按 9 生成                                                         | 确定留在 8 就把范围收紧到 `<9`（如 `~8.57.0`）后重跑 init                                                                                                                                                                                               |
 | 首次接入存量/脚手架项目，`lint:style` 集中报几十个属性顺序错         | stylelint-order（recess-order）按既有排序规约检查，脚手架模板（如 Vite 的 `style.css`）不满足    | 一次性 `stylelint "**/*.{vue,nvue,html,css,scss,less}" --fix` 自动归位后再提交；此后保持绿色。属存量风格收敛，非本配置引入的错误                                                                                                                        |
 | 重复 init 后，改过的 `.prettierrc.cjs` / hooks 被覆盖                | 除 ESLint 入口与已存在的 `.gitignore` 外，目标文件一律覆盖                                       | 先用 `--dry-run` 看清单、用 `--backup` 留档（备份含 `package.json`，目录会自动写入 `.gitignore`）                                                                                                                                                       |
@@ -281,16 +283,16 @@ npx my-code-style-doctor
 ## 测试套件
 
 ```bash
-npm run test:all               # 全量运行 200 项：用例明细 + 分类统计 + 最慢文件定位
+npm run test:all               # 全量运行 209 项：用例明细 + 分类统计 + 最慢文件定位
 npm run diagnose               # 换机器后先跑它：进程 / git / 文件系统 / hooks 各占多少
 npm run sweep                  # 给本机找最佳文件级并发（扫 integration 套件）
-npm test                       # 只跑基础 CLI 与配置矩阵（98 项）
+npm test                       # 只跑基础 CLI 与配置矩阵（104 项）
 npm run test:integration:setup # 安装现代化隔离依赖运行环境
-npm run test:integration       # Flat Config、真实 Husky 及提交链路测试（66 项）
+npm run test:integration       # Flat Config、真实 Husky 及提交链路测试（67 项）
 npm run test:legacy:setup      # 安装 ESLint 8 隔离运行环境
-npm run test:legacy            # ESLint 8.57.0 兼容性回归测试（27 项）
+npm run test:legacy            # ESLint 8.57.0 兼容性回归测试（28 项）
 npm run test:stylelint17:setup # 安装 Stylelint 17 隔离运行环境
-npm run test:stylelint17       # Stylelint 17 生态兼容性回归（8 项）
+npm run test:stylelint17       # Stylelint 17 生态兼容性回归（10 项）
 ```
 
 `npm run test:all` 由 `scripts/test-all.cjs` 驱动，输出**套件 → 用例 → 汇总**三层：
@@ -299,50 +301,50 @@ npm run test:stylelint17       # Stylelint 17 生态兼容性回归（8 项）
 ```text
   my-code-style 测试套件
 
-  ▶ [1/4] 基础 CLI 与配置矩阵  （共 98 项，5 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+  ▶ [1/4] 基础 CLI 与配置矩阵  （共 104 项，5 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 运行器 TAP 解析：统计通过与失败、SKIP 与每用例耗时 · 7ms
       ✓ cz 交互提示为中文，且可选类型与 type-enum 一一对应 · 1ms
       ✓ peer 范围覆盖我们声明支持的上游大版本（校准防回退，BUG-027） · 0ms
       ✓ 一键安装命令对含 || 的版本范围加引号，可整段粘贴执行 · 40ms
       ✓ 初始化结尾指引把 cz 用法说清楚（先 git add + 指到 README 手册） · 80ms
       …
-     ✓ 通过 98  ·  4.2s   · 最慢文件 init-matrix.test.cjs 4.0s
+     ✓ 通过 104  ·  4.2s   · 最慢文件 init-matrix.test.cjs 4.0s
 
-  ▶ [2/4] 现代工具链与提交链  （共 66 项，24 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+  ▶ [2/4] 现代工具链与提交链  （共 67 项，24 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 完整提交链：JS/TS/Vue/nvue/CSS/less 自动修复及二次复检 · 10.4s
       ✓ 发布防呆：HEAD 已有 v* tag 时拦截（此时 release 工具会静默抬版并写出空 CHANGELOG） · 609ms
       …
-     ✓ 通过 66  ·  43.8s   · 最慢文件 commit-chain-both.test.cjs 11.9s
+     ✓ 通过 67  ·  43.8s   · 最慢文件 commit-chain-both.test.cjs 11.9s
 
-  ▶ [3/4] ESLint 8 兼容性  （共 27 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+  ▶ [3/4] ESLint 8 兼容性  （共 28 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 独立运行 ESLint 8 支持下限而非 ESLint 9 · 1ms
       ✓ ESLint 8 base：实际 CLI 加载生成配置并接受正常文件 · 1.3s
       …
-     ✓ 通过 27  ·  20.2s
+     ✓ 通过 28  ·  20.2s
 
-  ▶ [4/4] Stylelint 17 兼容性  （共 9 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+  ▶ [4/4] Stylelint 17 兼容性  （共 10 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 隔离环境装的是 stylelint 17（不是 16） · 2ms
       ✓ 生成的 .stylelintrc.cjs 在 stylelint 17 下可加载并放过正常 SCSS · 700ms
       …
-     ✓ 通过 9  ·  8.8s
+     ✓ 通过 10  ·  8.8s
 
   ──────────────────────────────────────────────────────
   套件                      通过    失败    跳过    用时
   ──────────────────────────────────────────────────────
-  基础 CLI 与配置矩阵         98       0       -    4.2s
-  现代工具链与提交链          66       0       -   43.8s
-  ESLint 8 兼容性             27       0       -   20.2s
-  Stylelint 17 兼容性          9       0       -    8.8s
+  基础 CLI 与配置矩阵        104       0       -    4.2s
+  现代工具链与提交链          67       0       -   43.8s
+  ESLint 8 兼容性             28       0       -   20.2s
+  Stylelint 17 兼容性         10       0       -    8.8s
   ──────────────────────────────────────────────────────
-  合计                       200       0       -   77.1s
+  合计                       209       0       -   77.1s
   ──────────────────────────────────────────────────────
 
   ⏱ 最慢文件：eslint8.test.cjs 18.0s · commit-chain-less.test.cjs 11.4s · commit-chain-both.test.cjs 11.3s
 
-  ✅ 全部通过：200/200 项，用时 77.1s
+  ✅ 全部通过：209/209 项，用时 77.1s
 ```
 
-终端里每个套件下方还有一条实时进度条（`██████░░░░ 38/66  失败 0  4.0s`）。附加参数：
+终端里每个套件下方还有一条实时进度条（`██████░░░░ 38/67  失败 0  4.0s`）。附加参数：
 
 | 参数                     | 作用                                                       |
 | ------------------------ | ---------------------------------------------------------- |

package/bin/doctor

@@ -9,6 +9,8 @@
 const fs = require("fs")
 const path = require("path")
 const { spawnSync } = require("child_process")
+// 样式变体判定与 bin/init 共用原语，避免两侧口径漂移（BUG-043）
+const styleVariant = require("../src/stylelint/variant.cjs")
 
 const PROJECT_ROOT = process.cwd()
 let problems = 0
@@ -136,8 +138,8 @@ ok(`my-code-style ${selfPkg.version}`)
 
 // ---- ② peer 依赖：装了吗？版本对吗？ ----
 // 与 init 的依赖体检（checkPeerDeps）同口径裁剪：classic import 仅 ESLint 8 legacy
-// 线需要；无预处理器且非 Vue 项目不查 stylelint 族；Vue 项目才查 vue 全家。
-// 改动需与 bin/init 两侧同步（init-matrix 回归守底）。
+// 线需要；不涉样式的项目不查 stylelint 族（变体判定见 src/stylelint/variant.cjs）；
+// Vue 项目才查 vue 全家。改动需与 bin/init 两侧同步（init-matrix 回归守底）。
 function requiredPeers(manifest) {
     const deps = {
         ...manifest.dependencies,
@@ -157,14 +159,11 @@ function requiredPeers(manifest) {
     ].some((f) => fs.existsSync(path.join(PROJECT_ROOT, f)))
     const useFlat = hasFlatEntry || (!hasLegacyEntry && eslintMajor >= 9)
     const isVue = !!(deps.vue || deps["@dcloudio/uni-app"] || deps["uni-app"])
-    const cssPre =
-        deps.less && (deps.sass || isVue)
-            ? "both"
-            : deps.less
-              ? "less"
-              : deps.sass || isVue
-                ? "scss"
-                : null
+    // 样式变体以项目实际的 stylelint 配置为准（配置顶层 extends 缺 peer 会直接加载
+    // 失败），没有配置时才回落到依赖推断。此前这里只看依赖，`less && (sass || isVue)`
+    // 把「Vue + Less」判成 both，给纯 Less 项目索要 postcss-scss /
+    // stylelint-config-recommended-scss（BUG-043，下游 Vue 3 + Less 项目实测）。
+    const cssPre = styleVariant.detectVariant(PROJECT_ROOT, deps, isVue)
 
     const list = [
         "eslint",

package/bin/init

@@ -12,6 +12,8 @@
 
 const fs = require("fs")
 const path = require("path")
+// 样式变体判定与 bin/doctor 共用原语，避免两侧口径漂移（BUG-043）
+const styleVariant = require("../src/stylelint/variant.cjs")
 
 const PROJECT_ROOT = process.cwd()
 const PACKAGE_DIR = path.resolve(__dirname, "..")
@@ -489,37 +491,15 @@ function detectCssPreprocessor() {
           }
         : {}
 
-    const hasSass = allDeps["sass"] || allDeps["node-sass"] || allDeps["sass-loader"]
-    const hasLess = allDeps["less"] || allDeps["less-loader"]
+    // 依赖优先（项目意图的更强信号）；认不出再看已有的 stylelint 配置。
+    // 判定原语与 bin/doctor 共用（src/stylelint/variant.cjs），两侧不会漂移；
+    // doctor 的优先级相反（配置优先），因为它要判的是「哪条线会被真正加载」。
+    const fromDeps = styleVariant.variantFromDeps(allDeps)
+    if (fromDeps) return fromDeps
 
-    if (hasSass && hasLess) return "both"
-    if (hasLess && !hasSass) return "less"
-    if (hasSass) return "scss"
-
-    // Fallback: check for existing stylelint config
-    if (fileExists(".stylelintrc.cjs") || fileExists(".stylelintrc.js")) {
-        const stylelintFile = fileExists(".stylelintrc.cjs")
-            ? ".stylelintrc.cjs"
-            : ".stylelintrc.js"
-        let content = ""
-        try {
-            content = fs.readFileSync(path.resolve(PROJECT_ROOT, stylelintFile), "utf8")
-        } catch {}
-        // "my-code-style/stylelint" is a prefix of "my-code-style/stylelint/less",
-        // so the Less entry must be matched before the SCSS one.
-        const usesLess =
-            /my-code-style\/stylelint\/less(?:-override)?/.test(content) ||
-            content.includes("postcss-less") ||
-            content.includes("stylelint-config-recommended-less")
-        const usesScss =
-            /my-code-style\/stylelint(?![-\w/])/.test(content) ||
-            content.includes("postcss-scss") ||
-            content.includes("stylelint-config-recommended-scss")
-        if (usesLess && usesScss) return "both"
-        if (usesLess) return "less"
-        if (usesScss) return "scss"
-        return "scss"
-    }
+    const fromConfig = styleVariant.variantFromConfig(PROJECT_ROOT)
+    if (fromConfig === "unknown") return "scss" // 有配置但认不出变体：按统一入口处理
+    if (fromConfig) return fromConfig
 
     // 无 package.json 时无法判断项目类型，不猜测样式方案（避免凭空安装一堆 stylelint 依赖）
     if (!pkg) {

package/package.json

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

package/src/eslint/base.cjs

@@ -5,6 +5,12 @@ const prettierConfig = require("../prettier/index.cjs")
 const { overrides: _prettierOverrides, ...prettierOptions } = prettierConfig
 
 module.exports = {
+    // 阻止 eslintrc 的级联合并：没有它，祖先目录（monorepo 根 / 上层目录）的
+    // .eslintrc 会被静默合并进来 —— 实测两个后果：① 根配置里本包没声明的规则
+    // （eqeqeq 之类）漏进子项目，报出与本包口径无关的错；② 根配置引用的插件
+    // 子项目没装时整条 lint 直接崩（ESLint couldn't find the plugin）。
+    // 本包的 stylelint 配置一直带 root: true，ESLint 侧对齐（BUG-042）。
+    root: true,
     env: {
         browser: true,
         es2021: true,
@@ -88,10 +94,6 @@ module.exports = {
         "no-param-reassign": "off",
         "no-redeclare": "off",
         "prefer-promise-reject-errors": "off",
-
-        // Standard JS 风格规则已通过手动配置实现，不再依赖 eslint-config-standard
-        "style/quotes": "off",
-        "style/semi": "off",
     },
     settings: {
         "import/parsers": { "@typescript-eslint/parser": [".ts", ".tsx"] },

package/src/eslint/flat/_shared.mjs

@@ -66,10 +66,6 @@ export const commonRules = {
     "no-param-reassign": "off",
     "no-redeclare": "off",
     "prefer-promise-reject-errors": "off",
-
-    // Standard JS uses @stylistic style/quotes — disable to avoid conflict
-    "style/quotes": "off",
-    "style/semi": "off",
 }
 
 /**

package/src/stylelint/less-override.cjs

@@ -13,6 +13,12 @@ module.exports = {
         "at-rule-no-unknown": null,
         // Less built-in functions (darken, lighten, fade...) unknown to Stylelint
         "function-no-unknown": null,
+        // Less 变量出现在媒体查询里（`@media (max-width: @screen-md)`）、Less 的
+        // `@import (reference) "m.less"` 选项，在 CSS 语法里都非法，会被 recommended
+        // 开启的这两条规则判死且无法 --fix（与 less.cjs 同源：BUG-040 / BUG-041）。
+        // 走 less-override 合并的项目同样需要这层放行。
+        "media-query-no-invalid": null,
+        "at-rule-prelude-no-invalid": null,
         // Allow ::v-deep / /deep/ / ::ng-deep pseudo-elements
         "selector-pseudo-element-no-unknown": [
             true,

package/src/stylelint/less.cjs

@@ -55,6 +55,16 @@ module.exports = {
         // BUG-029 深测实测）；SCSS 线上游（recommended-scss）本就将其置 null，
         // 这里对齐，保证 uni-app Less 项目 rpx 写法不误报。
         "declaration-property-value-no-unknown": null,
+        // 同 BUG-029 的机理：Less 用 @ 写变量，媒体查询里的 `@screen-md` 在 CSS
+        // 语法里不是合法值，stylelint-config-recommended 开启的 media-query-no-invalid
+        // 会报 "Invalid media query"（BUG-040 实测：下游 18 处命中，且无 fixer，
+        // --fix 后原地不动 → 门禁永久红）。SCSS 线由 recommended-scss 置 null，
+        // Less 线没有那层覆盖，这里对齐。
+        "media-query-no-invalid": null,
+        // Less 的 `@import (reference) "m.less"` / `@import (less) "t.css"` 选项在
+        // CSS 语法里同样非法，at-rule-prelude-no-invalid 会把整个 prelude 判死
+        // （BUG-041 实测：下游 3 处命中，无 fixer）。同样对齐 SCSS 线上游的 null。
+        "at-rule-prelude-no-invalid": null,
         // 允许小程序 page 标签
         "selector-type-no-unknown": [true, { ignoreTypes: ["page"] }],
         "comment-empty-line-before": "never",

package/src/stylelint/variant.cjs

@@ -0,0 +1,142 @@
+// 样式方案（变体）判定原语：bin/init 与 bin/doctor 共用，避免两侧口径漂移。
+//
+// 背景（BUG-043）：doctor 曾只按 package.json 的依赖猜变体，其中
+// `deps.less && (deps.sass || isVue)` 把「Vue + Less（无 sass）」判成 both，于是给
+// 纯 Less 项目索要 postcss-scss / stylelint-config-recommended-scss —— 项目实际
+// extends 的是 my-code-style/stylelint/less，这两个包装了也用不上，doctor 的
+// 「一键补齐」还会诱导用户装无用依赖（下游 Vue 3 + Less 项目实测 exit 1）。
+//
+// 真正决定加载哪条线的是 stylelint 配置本身（统一入口顶层 extends 了
+// recommended-scss，缺 peer 会直接加载失败），所以「体检 peer」必须以配置为准。
+// init 的口径刻意不同：它要决定「生成哪份配置」，依赖是项目意图的更强信号，
+// 因此保持 1.9.4 的顺序（先依赖、后配置），只是换成同一套原语。
+
+const fs = require("fs")
+const path = require("path")
+
+// stylelint 官方配置查找顺序里的常见文件名；package.json 的 stylelint 字段单列处理
+const CONFIG_FILES = [
+    ".stylelintrc",
+    ".stylelintrc.json",
+    ".stylelintrc.yaml",
+    ".stylelintrc.yml",
+    ".stylelintrc.js",
+    ".stylelintrc.cjs",
+    ".stylelintrc.mjs",
+    "stylelint.config.js",
+    "stylelint.config.mjs",
+    "stylelint.config.cjs",
+]
+
+/**
+ * 读取项目已有的 stylelint 配置内容（含 package.json 的 stylelint 字段）。
+ * 查找顺序对齐 stylelint 自己的 searchPlaces：package.json 优先，其后按 cosmiconfig
+ * 的文件名顺序，命中即停。
+ * @returns {string|null} 没有配置文件时返回 null
+ */
+function readStylelintConfig(projectRoot) {
+    const pkgPath = path.join(projectRoot, "package.json")
+    if (fs.existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"))
+            if (pkg.stylelint) {
+                return JSON.stringify(pkg.stylelint)
+            }
+        } catch {
+            // 非法 JSON 当作没有 package.json 处理（配置文件继续找）
+        }
+    }
+    for (const file of CONFIG_FILES) {
+        const configPath = path.join(projectRoot, file)
+        if (!fs.existsSync(configPath)) {
+            continue
+        }
+        try {
+            return fs.readFileSync(configPath, "utf8")
+        } catch {
+            // 读不出来（无权限、同名目录等）就继续找下一个候选文件
+            continue
+        }
+    }
+    return null
+}
+
+/**
+ * 从已有配置内容判定变体。
+ * @returns {"less"|"scss"|"both"|"unknown"|null}
+ *   less/scss/both — 命中明确标记；unknown — 有配置文件但认不出变体（纯手写规则）；
+ *   null — 项目没有 stylelint 配置
+ */
+function variantFromConfig(projectRoot) {
+    const content = readStylelintConfig(projectRoot)
+    if (content === null) {
+        return null
+    }
+    // "my-code-style/stylelint" 是 "my-code-style/stylelint/less" 的前缀，
+    // 所以 Less 入口必须先匹配（BUG-003 的教训）。
+    const usesLess =
+        /my-code-style\/stylelint\/less(?:-override)?/.test(content) ||
+        content.includes("postcss-less") ||
+        content.includes("stylelint-config-recommended-less")
+    const usesScss =
+        /my-code-style\/stylelint(?![-\w/])/.test(content) ||
+        content.includes("postcss-scss") ||
+        content.includes("stylelint-config-recommended-scss")
+    if (usesLess && usesScss) {
+        return "both"
+    }
+    if (usesLess) {
+        return "less"
+    }
+    if (usesScss) {
+        return "scss"
+    }
+    return "unknown"
+}
+
+/**
+ * 从依赖判定变体（sass / node-sass / sass-loader 与 less / less-loader 的组合）。
+ * @returns {"less"|"scss"|"both"|null} 认不出时返回 null
+ */
+function variantFromDeps(deps = {}) {
+    const hasSass = Boolean(deps.sass || deps["node-sass"] || deps["sass-loader"])
+    const hasLess = Boolean(deps.less || deps["less-loader"])
+    if (hasSass && hasLess) {
+        return "both"
+    }
+    if (hasLess) {
+        return "less"
+    }
+    if (hasSass) {
+        return "scss"
+    }
+    return null
+}
+
+/**
+ * 依赖判定 + Vue/uni-app 项目默认走统一（SCSS）入口 —— 与 bin/init 的兜底一致。
+ * @returns {"less"|"scss"|"both"|null}
+ */
+function variantFromDepsWithVueDefault(deps, isVue) {
+    return variantFromDeps(deps) ?? (isVue ? "scss" : null)
+}
+
+/**
+ * 体检口径（doctor）：配置内容优先，认不出再看依赖。
+ * @returns {"less"|"scss"|"both"|null} null = 项目不涉及样式检查
+ */
+function detectVariant(projectRoot, deps, isVue) {
+    const fromConfig = variantFromConfig(projectRoot)
+    if (fromConfig && fromConfig !== "unknown") {
+        return fromConfig
+    }
+    return variantFromDepsWithVueDefault(deps, isVue)
+}
+
+module.exports = {
+    readStylelintConfig,
+    variantFromConfig,
+    variantFromDeps,
+    variantFromDepsWithVueDefault,
+    detectVariant,
+}