@chengzhao-dev/dsh-cpp-workflow 0.2.0 → 0.3.1

package/skills/building-cpp/scripts/checking-encoding.mjs

@@ -0,0 +1,241 @@
+#!/usr/bin/env node
+// Read-only encoding audit for a Git work tree.
+//
+// Default profile "portable" is the cross-platform baseline: UTF-8 without BOM,
+// LF line endings, one final newline. Profile "msvc" allows a UTF-8 BOM and CRLF
+// only for MSVC-compiled C/C++ sources; Markdown, CMake, scripts and configs stay
+// portable. It never rewrites files.
+//
+// Usage:
+//   node checking-encoding.mjs [--root DIR] [--profile portable|msvc] [--json] [--quiet]
+//
+// Exit codes: 0 clean, 1 issues found, 2 usage or Git error.
+import { execFileSync } from 'node:child_process'
+import { existsSync, readFileSync, statSync } from 'node:fs'
+import path from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+export const EXIT = { ok: 0, issues: 1, usage: 2 }
+
+const UTF8_BOM = [0xef, 0xbb, 0xbf]
+const UTF16_LE = [0xff, 0xfe]
+const UTF16_BE = [0xfe, 0xff]
+const UTF32_LE = [0xff, 0xfe, 0x00, 0x00]
+const UTF32_BE = [0x00, 0x00, 0xfe, 0xff]
+
+const CRLF_REQUIRED = new Set(['.bat', '.cmd'])
+const MSVC_SOURCE = new Set([
+  '.c', '.cc', '.cpp', '.cxx', '.h', '.hh', '.hpp', '.hxx', '.inl', '.ixx', '.cppm', '.rc',
+])
+const ALWAYS_LF = new Set([
+  '.md', '.qmd', '.txt', '.rst', '.yml', '.yaml', '.json', '.jsonc', '.json5', '.toml',
+  '.ini', '.cfg', '.conf', '.sh', '.bash', '.zsh', '.fish', '.ps1', '.py', '.mjs', '.cjs',
+  '.js', '.jsx', '.ts', '.tsx', '.css', '.scss', '.sass', '.less', '.html', '.htm', '.xml',
+  '.svg', '.cmake', '.lua', '.sql', '.gitignore', '.gitattributes', '.editorconfig',
+])
+const NO_EXTENSION_LF = new Set(['CMakeLists.txt', 'Makefile', 'Justfile', 'Dockerfile', 'LICENSE'])
+
+function usage(message) {
+  if (message) process.stderr.write(`错误：${message}\n`)
+  process.stderr.write('用法：node checking-encoding.mjs [--root DIR] [--profile portable|msvc] [--json] [--quiet]\n')
+  return EXIT.usage
+}
+
+function parseArgs(argv) {
+  const options = { root: undefined, profile: 'portable', json: false, quiet: false }
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index]
+    if (arg === '--root') {
+      options.root = argv[index + 1]
+      index += 1
+    } else if (arg === '--profile') {
+      options.profile = argv[index + 1]
+      index += 1
+    } else if (arg === '--json') {
+      options.json = true
+    } else if (arg === '--quiet') {
+      options.quiet = true
+    } else if (arg === '--help' || arg === '-h') {
+      options.help = true
+    } else {
+      throw new Error(`未知参数 ${arg}`)
+    }
+  }
+  if (options.profile !== 'portable' && options.profile !== 'msvc') {
+    throw new Error(`--profile 只能是 portable 或 msvc，收到 ${options.profile}`)
+  }
+  return options
+}
+
+function gitRoot(from) {
+  try {
+    return execFileSync('git', ['-C', from, 'rev-parse', '--show-toplevel'], {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim()
+  } catch {
+    return undefined
+  }
+}
+
+function listFiles(root) {
+  const output = execFileSync('git', ['-C', root, 'ls-files', '-z', '--cached', '--others', '--exclude-standard'], {
+    encoding: 'utf8',
+    maxBuffer: 64 * 1024 * 1024,
+  })
+  return output
+    .split('\0')
+    .filter(Boolean)
+    .map((item) => path.join(root, item))
+    .filter((file) => {
+      try {
+        return statSync(file).isFile()
+      } catch {
+        return false
+      }
+    })
+}
+
+function startsWith(buffer, bytes) {
+  return bytes.every((byte, index) => buffer[index] === byte)
+}
+
+function bomOf(buffer) {
+  if (startsWith(buffer, UTF32_LE)) return 'UTF-32 LE'
+  if (startsWith(buffer, UTF32_BE)) return 'UTF-32 BE'
+  if (startsWith(buffer, UTF8_BOM)) return 'UTF-8'
+  if (startsWith(buffer, UTF16_LE)) return 'UTF-16 LE'
+  if (startsWith(buffer, UTF16_BE)) return 'UTF-16 BE'
+  return undefined
+}
+
+function isBinary(buffer) {
+  const limit = Math.min(buffer.length, 8192)
+  for (let index = 0; index < limit; index += 1) {
+    if (buffer[index] === 0) return true
+  }
+  return false
+}
+
+function inspect(file, root, profile) {
+  const rel = path.relative(root, file).split(path.sep).join('/')
+  const extension = path.extname(file).toLowerCase()
+  const source = MSVC_SOURCE.has(extension)
+  const alwaysLf = ALWAYS_LF.has(extension) || NO_EXTENSION_LF.has(path.basename(file))
+  const issues = []
+  const add = (kind, message) => issues.push({ path: rel, kind, message })
+
+  let buffer
+  try {
+    buffer = readFileSync(file)
+  } catch (error) {
+    add('read', `无法读取（${error.message}）`)
+    return { rel, issues }
+  }
+
+  const bom = bomOf(buffer)
+  if (bom === 'UTF-8') {
+    if (profile !== 'msvc' || !source) {
+      add('bom', profile === 'msvc' && !source ? '只有 MSVC 编译的 C/C++ 源码可以带 BOM' : '不应带 BOM')
+    }
+  } else if (bom) {
+    add('bom', `发现 ${bom} BOM；只接受 UTF-8`)
+  }
+
+  if (bom && bom !== 'UTF-8') {
+    return { rel, issues }
+  }
+  if (isBinary(buffer)) {
+    return { rel, issues }
+  }
+
+  let text
+  try {
+    text = new TextDecoder('utf-8', { fatal: true }).decode(buffer)
+  } catch {
+    add('utf8', '不是合法 UTF-8')
+    return { rel, issues }
+  }
+
+  const body = text.startsWith('\uFEFF') ? text.slice(1) : text
+  if (body.includes('\uFEFF')) {
+    add('bom', '文件中间含 U+FEFF')
+  }
+
+  if (buffer.length > 0 && !body.endsWith('\n')) {
+    add('newline', '缺少末尾换行')
+  }
+
+  const crlf = (body.match(/\r\n/g) ?? []).length
+  const lf = (body.match(/(?<!\r)\n/g) ?? []).length
+  const cr = (body.match(/\r(?!\n)/g) ?? []).length
+
+  if (CRLF_REQUIRED.has(extension)) {
+    if (crlf === 0 || lf > 0 || cr > 0) add('eol', '应为 CRLF')
+  } else if (profile === 'msvc' && source && !alwaysLf) {
+    if ((crlf > 0 && lf > 0) || cr > 0) add('eol', '不要混用 CRLF 与 LF')
+  } else if (crlf > 0 || cr > 0) {
+    add('eol', '应为 LF')
+  }
+
+  return { rel, issues }
+}
+
+export function checkEncoding(root, profile = 'portable') {
+  const files = listFiles(root)
+  const results = []
+  for (const file of files) {
+    results.push(inspect(file, root, profile))
+  }
+  const issues = results.flatMap((result) => result.issues)
+  const counts = { files: results.length, issues: issues.length, bom: 0, eol: 0, utf8: 0, newline: 0, read: 0 }
+  for (const issue of issues) counts[issue.kind] = (counts[issue.kind] ?? 0) + 1
+  return { root, profile, files: results.length, issues, counts }
+}
+
+function main() {
+  let options
+  try {
+    options = parseArgs(process.argv.slice(2))
+  } catch (error) {
+    return usage(error.message)
+  }
+  if (options.help) {
+    process.stdout.write('检查 Git 工作树的 UTF-8/BOM、行尾与末尾换行；默认 portable。\n')
+    return EXIT.ok
+  }
+
+  const base = options.root ? path.resolve(options.root) : process.cwd()
+  if (!existsSync(base)) return usage(`根目录不存在：${base}`)
+  const root = gitRoot(base)
+  if (!root) return usage(`不是 Git 工作树：${base}`)
+
+  let report
+  try {
+    report = checkEncoding(root, options.profile)
+  } catch (error) {
+    process.stderr.write(`错误：${error.message}\n`)
+    return EXIT.usage
+  }
+
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`)
+  } else if (!options.quiet || report.issues.length > 0) {
+    if (report.issues.length === 0) {
+      process.stdout.write(`编码检查：${report.files} 个文件，未发现问题（profile ${report.profile}）。\n`)
+    } else {
+      process.stdout.write(`编码检查：${report.files} 个文件，发现 ${report.issues.length} 个问题（profile ${report.profile}）。\n`)
+      for (const issue of report.issues) {
+        process.stdout.write(`  ${issue.path}: [${issue.kind}] ${issue.message}\n`)
+      }
+      process.stdout.write(
+        `汇总：BOM ${report.counts.bom}，行尾 ${report.counts.eol}，UTF-8 ${report.counts.utf8}，末尾换行 ${report.counts.newline}\n`,
+      )
+    }
+  }
+  return report.issues.length === 0 ? EXIT.ok : EXIT.issues
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href) {
+  process.exitCode = main()
+}

package/skills/building-cpp/steps/01-build.md

@@ -60,7 +60,7 @@ GCC 模式把目录和编译器换成 `build/gcc`、`g++`。工程确有 C 源
 
 ## 情况
 
-**新工程**：从 `assets/templates/projects/` 选形态：`single` 单文件、`multi` 多文件单程序、`static-library` 静态库 + 程序、`shared-library` 动态库 + 程序。只复制目标工程缺的文件；已有的 `CMakeLists.txt`、`.clang-*`、源码不覆盖。模板里的 `{{PROJECT_NAME}}` 换成真实工程名，默认标准 C++23；四套模板已按 `__cplusplus` 条件使用 `std::format`，把 `standard`、`cxx_std_*`、`CXX_STANDARD` 和 `.clang-format` 的解析档位一起降到 C++11–C++20 后仍应能构建，降完跑 `references/standards/README.md` 的五档矩阵。模板源码是 `.cc`，头文件用路径式 `#define` 守卫；新增文件沿用 `.cc` / `.h`，已有工程保持原有扩展名。
+**新工程**：从 `assets/templates/projects/` 选形态：`single` 单文件、`multi` 多文件单程序、`static-library` 静态库 + 程序、`shared-library` 动态库 + 程序。只复制目标工程缺的文件；已有的 `CMakeLists.txt`、`.clang-*`、源码不覆盖。模板里的 `{{PROJECT_NAME}}` 换成真实工程名，默认标准 C++23；四套模板已按 `__cplusplus` 条件使用 `std::format`，把 `standard`、`cxx_std_*`、`CXX_STANDARD` 和 `.clang-format` 的解析档位一起降到 C++11–C++20 后仍应能构建，降完跑 `references/standards/README.md` 的五档矩阵。模板源码是 `.cpp`，头文件用路径式 `#define` 守卫；新增文件沿用 `.cpp` / `.h`，已有工程保持原有扩展名。
 
 **已有工程**：先读现有 `CMakeLists.txt`，找出全局设置、GLOB、输出目录和 target 命名；只改与当前任务相关的一处。大改前先让通过检查的项目入口跑通，保留可回退点。
 

package/skills/building-cpp/steps/02-tooling.md

@@ -13,8 +13,8 @@
 - `.clangd` 的 `CompilationDatabase` 指向 `build/<compiler>`；切换编译器时同步改，不能留旧目录。**不要写 `-std`**：它会覆盖 `compile_commands.json`，把 C++23 工程降成旧标准；标准只由构建声明和编译数据库决定。
 - `--query-driver` 是 clangd 的命令行参数，写在 `.vscode/settings.json` 的 `clangd.arguments` 里，不是 `.clangd` 的 YAML 键。它告诉 clangd 允许执行哪个编译器驱动来取系统头路径；路径写绝对路径，并与 `environment.json` 的编译器一致。
 - 首次复制时按轴替换三处：`compiler=clang` 用 `CompilationDatabase: build/clang`、`--query-driver=/usr/bin/clang++` 和 `cmake.debugConfig` 的 `MIMode: lldb` / `miDebuggerPath: /usr/bin/lldb`；`compiler=gcc` 用 `build/gcc`、`/usr/bin/g++` 和 `MIMode: gdb` / `/usr/bin/gdb`。只复制模板而不改这三处，GCC 模式会指向错误的数据库、驱动或调试器。原工程已有的 `.clangd` 不覆盖；要改先征得同意。
-- `.clang-format` 只保留 `Language: Cpp`、`BasedOnStyle: Google`、`Standard: Latest`（clang-format 21/22 不接受 `c++23`）。列宽 80、每级 2 空格、不用 tab、包含顺序都取 Google 预设；不要覆盖 `ColumnLimit`、`TabWidth`、`IncludeCategories` 或指针对齐。需要新规则时先改 `references/google-cpp-style.md` 并说明理由。
-- `.clang-tidy` 用 `Checks: '-*, google-*, readability-identifier-naming'`，保留 `WarningsAsErrors: '*'` 和 `FormatStyle: file`。`google-*` 覆盖 Google 风格能静态检查的部分；`readability-identifier-naming` 只配项目确实统一的命名项：类型/枚举/别名/模板参数 PascalCase，变量/参数/成员 snake_case，类成员尾随 `_`，结构体成员不尾随，常量 `k` + PascalCase。不要设 `FunctionCase`，Google 允许 `count()` / `set_count()` 这类访问器；不要重新打开 `cppcoreguidelines-*` 整包或 `portability-avoid-pragma-once`。
+- `.clang-format` 保留 `Language: Cpp`、`BasedOnStyle: Google` 和 `Standard`：模板资产写 `Latest`；工程按 `environment.json` 声明 C++11–C++20 时，把 `Standard` 改成 `c++NN`（映射见 `references/standards/README.md`）。clang-format 21/22 的 `Standard` 不接受 `c++23`，所以 C++23 工程仍写 `Latest`。列宽 80、每级 2 空格、不用 tab、包含顺序都取 Google 预设；不要覆盖 `ColumnLimit`、`TabWidth`、`IncludeCategories` 或指针对齐。需要新规则时先改 `references/google-cpp-style.md` 并说明理由。
+- `.clang-tidy` 用 `Checks: '-*, google-*, portability-avoid-pragma-once, readability-identifier-naming'`，保留 `WarningsAsErrors: '*'` 和 `FormatStyle: file`。`google-*` 覆盖 Google 风格能静态检查的部分；`readability-identifier-naming` 只配项目确实统一的命名项：类型/枚举/别名/模板参数 PascalCase，变量/参数/成员 snake_case，类成员尾随 `_`，结构体成员不尾随，常量 `k` + PascalCase。不要设 `FunctionCase`，Google 允许 `count()` / `set_count()` 这类访问器；`portability-avoid-pragma-once` 要打开，因为工程统一用路径式守卫；不要重新打开 `cppcoreguidelines-*` 整包。
 - `.clang-tidy` 关闭项和例外必须写理由；不要借 `-*` 之后再打开 `cppcoreguidelines-*` 这类非 Google 整族检查。
 - `.vscode/extensions.json` 推荐 clangd、CMake Tools 与 C/C++ 扩展；`.vscode/settings.json` 固定 clangd 参数、CMake 构建目录和 `cmake.debugConfig`。配置、构建、运行和调试只从 CMake Tools 进入，不写 `tasks.json` 或 `launch.json`；C/C++ 扩展只作为 CMake 快速调试的后端，IntelliSense 关闭，避免和 clangd 并行。配置注释用 JSONC 的 `//`，贴在被解释的键上方。
 - 配置注释写「为什么这样设」，不写「这一项是什么」；不写策略头、不指向文档路径。

package/skills/building-cpp/steps/03-check.md

@@ -8,15 +8,17 @@
 
 按固定顺序跑，前一步失败就停，不要带着失败继续：
 
-1. **校验环境声明（不带 `--live`）**：读 `environment.json`，检查三个环境轴、`standard` 和组合是否合法。环境轴为空、`standard` 非法或组合非法时，停在这里，不找可执行文件。
-2. **活动校验**：在声明的 build host 上跑 `--live`，核对 PATH 中的角色和版本。`windows` + `native` 在声明校验阶段就返回失败，不会进入这一步。
-3. **跑项目入口命令**：项目技能里写的入口命令（如 `./running-build.sh clang`）。入口命令仍是 `<entry-command>` 或空白时，停在这里，不要猜命令；是真实命令才跑。入口内部依次 configure → build → format → tidy → ctest → run；每一步失败都保留原始输出。
-4. **核对产物**：`build/<compiler>/compile_commands.json` 存在；`build/compile_commands.json` 指向当前编译器；`app` 可执行文件在 `build/<compiler>/bin`。
-5. **记录结果**：通过时记录编译器版本、构建目录、测试数量；失败时记录命令、退出码、第一条根因诊断。
+1. **校验编码与行尾**：在仓库根跑编码检查。默认 UTF-8 无 BOM、LF；MSVC 原生工程加 `--profile msvc`。有问题先按 `references/encoding.md` 修正，不带着 BOM 或混用行尾继续。
+2. **校验环境声明（不带 `--live`）**：读 `environment.json`，检查三个环境轴、`standard` 和组合是否合法。环境轴为空、`standard` 非法或组合非法时，停在这里，不找可执行文件。
+3. **活动校验**：在声明的 build host 上跑 `--live`，核对 PATH 中的角色和版本。`windows` + `native` 在声明校验阶段就返回失败，不会进入这一步。
+4. **跑项目入口命令**：项目技能里写的入口命令（如 `./running-build.sh clang`）。入口命令仍是 `<entry-command>` 或空白时，停在这里，不要猜命令；是真实命令才跑。入口内部依次 configure → build → format → tidy → ctest → run；每一步失败都保留原始输出。
+5. **核对产物**：`build/<compiler>/compile_commands.json` 存在；`build/compile_commands.json` 指向当前编译器；`app` 可执行文件在 `build/<compiler>/bin`。
+6. **记录结果**：通过时记录编译器版本、构建目录、测试数量；失败时记录命令、退出码、第一条根因诊断。
 
-环境校验脚本：
+编码检查与环境校验脚本：
 
 ```bash
+node "<skill-dir>/scripts/checking-encoding.mjs" --profile portable      # UTF-8 无 BOM、LF
 node "<skill-dir>/scripts/checking-environment.mjs" --project .          # 声明校验
 node "<skill-dir>/scripts/checking-environment.mjs" --project . --live   # 活动校验
 ```

package/skills/developing-cpp/SKILL.md

@@ -9,10 +9,12 @@ metadata:
 
 ## 适用场景
 
-管 `.h` / `.cc` 里换一台机器也不会改的内容：可观察行为、库与程序的边界、声明、命名、异常和源码注释。排版、命名、头文件与包含顺序以 `references/google-cpp-style.md` 的 Google 基线为准。异常条文采用 C++ Core Guidelines 的 Error handling，作为开发阶段的源码指导；它不进入插件运行时。`CMakeLists.txt`、`cmake/`、`running-build.sh`、`.clang-*`、`.vscode/` 和 `environment.json` 只开 `building-cpp`。只改函数体、命名、异常或注释且入口命令可运行时，定实现后只开 `building-cpp` 的「通过检查」；新增或移动源文件、改库与程序的边界、补测试 target 时，声明和实现可以先写，但完成前必须开 `building-cpp` 的定构建，把文件写进 CMake，再决定是否定工具配置，最后通过检查。`.qmd`、仓库 README、Python 和非 C++ 文档不打开本技能。
+管 `.h` / `.hpp` / `.cpp` / `.cc` 里换一台机器也不会改的内容：可观察行为、库与程序的边界、声明、命名、异常和源码注释。文件槽位与守卫以 `references/file-template.md` 为准；排版、命名、头文件与包含顺序以 `references/google-cpp-style.md` 的 Google 基线为准。异常条文采用 C++ Core Guidelines 的 Error handling，作为开发阶段的源码指导；它不进入插件运行时。`CMakeLists.txt`、`cmake/`、`running-build.sh`、`.clang-*`、`.vscode/` 和 `environment.json` 只开 `building-cpp`。只改函数体、命名、异常或注释且入口命令可运行时，定实现后只开 `building-cpp` 的「通过检查」；新增或移动源文件、改库与程序的边界、补测试 target 时，声明和实现可以先写，但完成前必须开 `building-cpp` 的定构建，把文件写进 CMake，再决定是否定工具配置，最后通过检查。`.qmd`、仓库 README、Python 和非 C++ 文档不打开本技能。
 
 存在项目技能 `cpp-workflow-project` 时先读它的 `SKILL.md`：工程名、库与程序的边界、阶段表、术语增补、入口命令。没有项目技能时门禁不会放出本技能，不要猜项目约定。
 
+源码和构建文件的编码以 `building-cpp` 的 `references/encoding.md` 为准；行尾与 `.clang-format` 的 `LineEnding` 跟仓库根 `.gitattributes` 和 `.editorconfig`。
+
 ## 两种走法
 
 | 走法 | 什么时候用 | 怎么做 |
@@ -29,9 +31,22 @@ metadata:
 | 1 | 定行为 | `steps/01-behavior.md` | 把这一处要能观察到的结果写成验收句 |
 | 2 | 定边界 | `steps/02-boundary.md` | 决定哪些放库、哪些放程序，依赖朝哪个方向 |
 | 3 | 定声明 | `steps/03-declaration.md` | 写命名、声明顺序、头文件契约和声明注释 |
-| 4 | 定实现 | `steps/04-implementation.md` | 写 `.cc` 的操作顺序、分组和实现注释 |
+| 4 | 定实现 | `steps/04-implementation.md` | 写 `.cpp` 函数体的操作顺序、分组和实现注释 |
+
+每步只打开同号的一个步骤文件。判不准才打开 `examples/` 里与该步对应的案例；`references/` 保存完整条文，只在排错、整目录重构，或步骤里明确指向某一条文时按需打开。性能问题读 `references/performance.md`，标准库设施选型读 `references/standard-library.md`，链接与产物的细节读 `building-cpp` 的 `references/linking.md`。
+
+### 四类改动
+
+先认这次改的是哪一类，再决定从哪一步进；一次改动混了两类时，按「写作 → 布局 → 排版 → 润色」的次序拆开做，前一类落定并经检查再进下一类。
+
+| 类型 | 典型请求 | 从哪进 | 先读哪份条文 |
+| --- | --- | --- | --- |
+| 写作 | 新增类型、函数或文件；改可观察行为；改库与程序的边界 | 第 1 步 | `steps/01-behavior.md`、`02-boundary.md`、`references/project-design.md` |
+| 布局 | 换文件位置、拆头文件、调声明顺序、补测试 target | 第 3 步 | `references/file-template.md`、`declaration-order.md` |
+| 排版 | 只改缩进、行宽、包含顺序或格式 | 第 3 步的声明写法，或 `building-cpp` 的「定工具配置」 | `references/google-cpp-style.md`、`layout.md` |
+| 润色 | 只改命名、只改注释措辞 | 第 3、4 步 | `references/naming.md`、`comments.md` |
 
-每步只打开同号的一个步骤文件。判不准才打开 `examples/` 里与该步对应的案例；`references/` 保存完整条文，只在排错、整目录重构，或步骤里明确指向某一条文时按需打开。
+只改格式时不动行为，只改注释时不动签名；类型注释的职责、跨文件边界与线程规则，只按 `references/comments.md` 的条文取内容。
 
 ## 完成判据
 
@@ -39,4 +54,5 @@ metadata:
 - 第 2 步的库 target 不依赖终端、GUI 或脚本；程序 target 只做装配和输入输出；共享抽象有第二个真实使用方。
 - 第 3 步的公共头文件自包含，命名、声明顺序和异常声明符合 `references/` 的条文。
 - 第 4 步的实现只兑现声明；资源由 RAII 管理；失败是正常结果时用返回值，函数无法完成任务时抛异常，不拿异常做正常分支。
+- 源码注释符合 `references/comments.md` 的四层规范，`node "<skill-dir>/scripts/checking-comments.mjs" --root <项目根>` 无输出。
 - 没有改 `CMakeLists.txt`、`.clang-*`、构建脚本，也没有把外部资料路径或项目专属类名写进通用条文。