dsh-git-push 2.20.11 → 2.20.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/README.md +10 -6
  2. package/cli-audit.mjs +141 -0
  3. package/cli-tool.mjs +86 -0
  4. package/cli.mjs +114 -335
  5. package/lib/app/command-registry.js +3 -2
  6. package/lib/app/constants.js +9 -0
  7. package/lib/app/handlers/clone.js +12 -3
  8. package/lib/app/handlers/http-constants.js +11 -2
  9. package/lib/app/handlers/npm.js +4 -2
  10. package/lib/app/handlers/repos.js +10 -1
  11. package/lib/app/handlers/settings.js +9 -1
  12. package/lib/app/http-handlers.js +24 -3
  13. package/lib/app/schema-audit.js +42 -0
  14. package/lib/app/schema.js +19 -19
  15. package/lib/app/settings-bridge.js +51 -0
  16. package/lib/app/tool-call.js +7 -5
  17. package/lib/audit-rules/audit-rules-paths.yml +7 -1
  18. package/lib/audit-ui-sdk/contract.js +117 -0
  19. package/lib/audit-ui-sdk/index.js +17 -0
  20. package/lib/checks/regex.js +6 -1
  21. package/lib/cli/commands-audit.mjs +12 -17
  22. package/lib/cli/commands-tool.mjs +93 -0
  23. package/lib/cli/commands-vcs.mjs +2 -1
  24. package/lib/cli/shared.mjs +448 -0
  25. package/lib/client-parts/{account.js → git/account.js} +1 -1
  26. package/lib/client-parts/{actions.js → git/actions.js} +26 -11
  27. package/lib/client-parts/{apply.js → git/apply.js} +1 -1
  28. package/lib/client-parts/{browser.js → git/browser.js} +1 -1
  29. package/lib/client-parts/{const.js → git/const.js} +6 -1
  30. package/lib/client-parts/{controller.js → git/controller.js} +23 -11
  31. package/lib/client-parts/{icons.js → git/icons.js} +1 -1
  32. package/lib/client-parts/{loader.js → git/loader.js} +1 -1
  33. package/lib/client-parts/{npm.js → git/npm.js} +1 -1
  34. package/lib/client-parts/{page.js → git/page.js} +11 -21
  35. package/lib/client-parts/{repo.js → git/repo.js} +1 -1
  36. package/lib/client-parts/{settings.js → git/settings.js} +1 -1
  37. package/lib/client-parts/{utils.js → git/utils.js} +1 -1
  38. package/lib/client.js +75 -354
  39. package/lib/commit-push/pre-commit-engine.js +388 -0
  40. package/lib/commit-push.js +42 -20
  41. package/lib/git/transport.js +31 -10
  42. package/lib/http/index.js +82 -10
  43. package/lib/npm/npmrc.js +22 -5
  44. package/lib/self/index.js +1 -1
  45. package/package.json +6 -2
  46. package/scripts/audit-gate.mjs +235 -0
  47. package/scripts/build-client.mjs +15 -8
  48. package/scripts/check.mjs +12 -3
  49. package/scripts/scan-file-io.mjs +5 -1
  50. package/scripts/scan-version.mjs +10 -7
  51. package/skills/dev/dsh-git-push.md +62 -0
  52. package/skills/guide/guide-audit.md +11 -11
  53. package/skills/guide/guide-cli-scripts.md +3 -3
  54. package/skills/guide/guide-commit-push.md +2 -2
  55. package/skills/guide/guide-inject-ui.md +0 -16
  56. package/assets/start.sh +0 -396
  57. package/scripts/scan-hardcoded-paths.mjs +0 -125
  58. /package/lib/client-parts/{audit.js → audit/audit.js} +0 -0
package/lib/http/index.js CHANGED
@@ -19,6 +19,55 @@ export const READ_METHODS = new Set(['GET', 'HEAD', 'OPTIONS']);
19
19
 
20
20
  export const ALLOWED_ORIGINS = new Set(['http://127.0.0.1', 'http://localhost', 'http://[::1]']);
21
21
 
22
+ /**
23
+ * 从 Origin / Host 值里取主机名:去 scheme、去端口、剥 IPv6 方括号。
24
+ * 为什么不用简单的 `^([^/:]+)`:那会在 `http://[::1]:3080` 上止步于 `[`,
25
+ * 把 IPv6 回环判成未知主机(同源判定失效)。
26
+ * @param {string} value 如 "http://127.0.0.1:3080" / "10.10.10.4:3080" / "dsh-app://app"
27
+ * @returns {string} 主机名(取不到返回空串)
28
+ */
29
+ export function hostNameOf(value = '') {
30
+ const text = String(value || '').trim().replace(/^[a-z][a-z0-9+.-]*:\/\//i, '');
31
+ if (!text) return '';
32
+ if (text.startsWith('[')) {
33
+ const end = text.indexOf(']');
34
+ return end > 0 ? text.slice(1, end) : '';
35
+ }
36
+ const match = /^([^/:]+)(?::\d+)?/.exec(text);
37
+ return match ? match[1] : '';
38
+ }
39
+
40
+ /**
41
+ * 是否本机回环主机(127.0.0.1 / localhost / ::1)。
42
+ * 用途:无 Origin 的写请求只允许来自「本机」——桌面壳转发的目标恒是回环地址,
43
+ * 而局域网直连(Host 是 10.x/192.168.x)不享受该放行,避免给局域网开 CSRF 口子。
44
+ * @param {string} value Origin 或 Host 值
45
+ * @returns {boolean}
46
+ */
47
+ export function isLoopbackHost(value = '') {
48
+ const LOOPBACK = new Set(['127.0.0.1', 'localhost', '::1']);
49
+ // ① 先按**裸地址**判:`socket.remoteAddress` 给的就是裸形态(`127.0.0.1` / `::1` /
50
+ // `::ffff:127.0.0.1`),没有 scheme、没有方括号、IPv6 也不带端口。
51
+ // hostNameOf 的 `^([^/:]+)` 对裸 IPv6(以 `:` 开头)会解析成空串 ⇒ 必须先在这里判。
52
+ const raw = String(value || '').trim().toLowerCase();
53
+ const bare = raw.startsWith('::ffff:') ? raw.slice('::ffff:'.length) : raw;
54
+ if (LOOPBACK.has(bare)) return true;
55
+ // ② 再退回 hostNameOf:处理带 scheme / 端口 / IPv6 方括号的 Origin 与 Host 头。
56
+ let name = hostNameOf(value).toLowerCase();
57
+ if (name.startsWith('::ffff:')) name = name.slice('::ffff:'.length);
58
+ return LOOPBACK.has(name);
59
+ }
60
+
61
+ /**
62
+ * 是否 JSON 请求体(忽略 charset 等参数)。
63
+ * 用途:无 Origin 写请求的放行判据——跨站表单设不出 application/json。
64
+ * @param {string} contentType Content-Type 头值
65
+ * @returns {boolean}
66
+ */
67
+ export function isJsonContentType(contentType = '') {
68
+ return String(contentType || '').toLowerCase().split(';')[0].trim() === 'application/json';
69
+ }
70
+
22
71
  /**
23
72
  * Origin 校验:写请求必须带同源 Origin(可信页面来源),否则 403(防 CSRF)。
24
73
  * GET/OPTIONS 等只读请求免校验(读不产生副作用)。
@@ -32,10 +81,12 @@ export const ALLOWED_ORIGINS = new Set(['http://127.0.0.1', 'http://localhost',
32
81
  * @param {string} [origin] Origin 请求头值(可能 undefined)
33
82
  * @param {Set<string>} [allowed] 允许的源集合(默认本机回环,测试可注入)
34
83
  * @param {string} [host] 请求 Host 头值(如 "10.10.10.4:3080";同源放行依据)
84
+ * @param {string} [contentType] Content-Type 请求头值(无 Origin 时的放行判据之一)
85
+ * @param {string} [remoteAddress] TCP 对端地址(`req.socket.remoteAddress`;**比 Host 头可信**)
35
86
  * @returns {{ok: boolean, status?: number, code?: string, message?: string}}
36
87
  * ok=true 放行;ok=false 时带 status/code/message
37
88
  */
38
- export function checkOrigin(method = '', origin = '', allowed = ALLOWED_ORIGINS, host = '') {
89
+ export function checkOrigin(method = '', origin = '', allowed = ALLOWED_ORIGINS, host = '', contentType = '', remoteAddress = '') {
39
90
  const methodUpper = String(method || '').toUpperCase();
40
91
  if (!WRITE_METHODS.has(methodUpper) && !READ_METHODS.has(methodUpper)) {
41
92
  return { ok: false, status: 405, code: 'METHOD', message: `不支持的 HTTP 方法: ${method}` };
@@ -43,14 +94,33 @@ export function checkOrigin(method = '', origin = '', allowed = ALLOWED_ORIGINS,
43
94
  if (READ_METHODS.has(methodUpper)) return { ok: true }; // 只读免校验
44
95
  const originStr = String(origin || '').trim();
45
96
  if (!originStr) {
97
+ // 桌面端(dsh-app:// 自定义协议)放行通道。
98
+ // 桌面壳 forwardWebRequest 转发 /api/* 到后端时**显式剥离 Origin**
99
+ // (headers.delete('origin'),只补 cookie),于是写请求到这里 Origin 恒为空。
100
+ // 若不特判,桌面版设置页的**所有保存/开关/按钮**都会 403,而 GET 免校验照常
101
+ // —— 表现为「页面能打开、保存永不生效、回显旧值」,且拒绝发生在 handler 之前
102
+ // 连日志都不留,用户无从自查(外部报告已完整复现并定位到桌面壳源码)。
103
+ // 放行判据取三条同时成立,CSRF 防护不降级:
104
+ // ① **Content-Type 是 application/json**:浏览器跨站表单(text/plain /
105
+ // urlencoded / multipart)设不出这个 CT;fetch/XHR 设 JSON CT 属非简单请求 →
106
+ // 触发 CORS 预检,而本 API 从不回 CORS 许可头 ⇒ 预检失败,真实请求发不出去。
107
+ // ② **Host 是回环地址**:桌面壳转发目标是 127.0.0.1:<port>;服务若监听
108
+ // 0.0.0.0,局域网上的机器发「无 Origin + JSON」的写请求仍会被拒,CSRF 面不扩大。
109
+ // ③ 浏览器发起的写请求**必带 Origin** ⇒ 走下方既有同源/跨源判定,不受本分支影响。
110
+ // ②' **本机判定以 TCP 对端地址为准,Host 只作补充**:
111
+ // Host 头是客户端可控的(构造 `Host: 127.0.0.1` 即可伪造),
112
+ // 而 `socket.remoteAddress` 由内核给出、无法伪造 ⇒ 有 remoteAddress 时以它定论。
113
+ // 只在拿不到 remoteAddress(进程内/测试调用)时才退回看 Host。
114
+ // 顺带覆盖「某些转发链路会丢 Host」的场景(实测宿主转发后 host 可能为空)。
115
+ const fromLoopback = remoteAddress
116
+ ? isLoopbackHost(remoteAddress)
117
+ : isLoopbackHost(host);
118
+ if (isJsonContentType(contentType) && fromLoopback) return { ok: true };
46
119
  return { ok: false, status: 403, code: 'NO_ORIGIN', message: '写请求缺少 Origin 头——拒绝(防 CSRF)' };
47
120
  }
48
121
  // 主机名解析:兼容带协议(Origin)与不带协议(Host 头)两种输入,忽略端口
49
- const hostOf = (u) => {
50
- const s = String(u || '').trim().replace(/^https?:\/\//i, '');
51
- const match = /^([^/:]+)(?::\d+)?/.exec(s);
52
- return match ? match[1] : '';
53
- };
122
+ // 用模块级 hostNameOf(支持 IPv6 方括号与任意 scheme,如 dsh-app://)
123
+ const hostOf = hostNameOf;
54
124
  const oHost = hostOf(originStr);
55
125
  // 同源放行(1.0.5):Origin 主机与请求 Host 一致 = 可信页面自身发起的请求(防跨站 CSRF 的核心)
56
126
  const hHost = hostOf(host);
@@ -105,12 +175,13 @@ export function httpOk(ok = true, extra = {}) {
105
175
 
106
176
  /**
107
177
  * 统一鉴权流水线:Origin → 方法 → 写确认 → 体大小,全部通过返回 {ok:true}。
108
- * @param {object} req { method, origin, contentLength, isWriteConfirmOp }
178
+ * @param {object} req { method, origin, host, contentType, contentLength, isWriteConfirmOp }
109
179
  * @param {object} [opts] { allowedOrigins, bodyLimit, isWriteConfirmOp }
110
180
  * @returns {{ok: boolean, status?: number, code?: string, message?: string}}
111
181
  */
112
- export function authPipeline({ method = '', origin = '', contentLength = 0, isWriteConfirmOp = false } = {}, opts = {}) {
113
- const originCheck = checkOrigin(method, origin, opts.allowedOrigins);
182
+ export function authPipeline({ method = '', origin = '', host = '', contentType = '', contentLength = 0, isWriteConfirmOp = false } = {}, opts = {}) {
183
+ // host / contentType 一并传入:无 Origin 的桌面端转发判据需要它们(见 checkOrigin)
184
+ const originCheck = checkOrigin(method, origin, opts.allowedOrigins, host, contentType);
114
185
  if (!originCheck.ok) return originCheck;
115
186
  if (opts.isWriteConfirmOp ?? isWriteConfirmOp) {
116
187
  // 写确认由调用方在解析 body 后判定(body.confirm),这里只占位返回 ok
@@ -161,7 +232,8 @@ export function routeRequest(req = {}, handlers = {}) {
161
232
  if (!handler) {
162
233
  return { status: 404, body: { ok: false, code: 'NOT_FOUND', message: `无此端点: ${method} ${path}` } };
163
234
  }
164
- const originCheck = checkOrigin(method, req.origin);
235
+ // host / content-type 一并传入:桌面端(dsh-app://)转发剥离 Origin,靠这两个头判定放行
236
+ const originCheck = checkOrigin(method, req.origin, undefined, req.headers?.host, req.headers?.['content-type']);
165
237
  if (!originCheck.ok) return { status: originCheck.status, body: { ok: false, ...originCheck } };
166
238
  const sizeCheck = checkBodySize(Number(req.headers?.['content-length']) || 0);
167
239
  if (!sizeCheck.ok) return { status: sizeCheck.status, body: { ok: false, ...sizeCheck } };
package/lib/npm/npmrc.js CHANGED
@@ -9,9 +9,24 @@ import { join } from 'node:path';
9
9
 
10
10
  import { credentialsDir } from '../core/credentials.js';
11
11
  import { writeTextAtomic } from '../core/atomic-json.js';
12
+ import { DEFAULT_REGISTRY } from './registry.js';
12
13
 
13
14
  export const NPMRC_FILE = 'npmrc';
14
15
 
16
+ /**
17
+ * 归一化 registry:空串、纯空白、undefined 都回落默认值。
18
+ *
19
+ * 为什么必须有这层:`registry=`(空值)写进 npmrc 后,npm 会在构建 nerf-dart 时
20
+ * 用 `new URL('')` 直接抛 `ERR_INVALID_URL`,所有 npm 子命令全部不可用——
21
+ * 而调用方很容易写成 `registry: cfg?.npmRegistry || ''`(未配置 → 空串),
22
+ * 函数默认值又只在 `undefined` 时生效,于是空串一路穿到底。实测踩过:
23
+ * 撤包工具因此完全跑不起来,报的还是「Invalid URL」这种看不出根因的错。
24
+ */
25
+ function effectiveRegistry(registry) {
26
+ const text = String(registry || '').trim();
27
+ return text || DEFAULT_REGISTRY;
28
+ }
29
+
15
30
  /** 按 registry 推导 authToken 行前缀:`//host/path/`(用于 `//host/:_authToken=…`)。 */
16
31
  export function registryAuthPrefix(registry = '') {
17
32
  try {
@@ -23,11 +38,12 @@ export function registryAuthPrefix(registry = '') {
23
38
  }
24
39
 
25
40
  /** 生成 npmrc 文本(纯函数,便于测试):registry 行 +(有 token 时)authToken 行。 */
26
- export function npmrcText({ registry = 'https://registry.npmjs.org/', token = '' } = {}) {
27
- const lines = [`registry=${registry}`];
41
+ export function npmrcText({ registry = DEFAULT_REGISTRY, token = '' } = {}) {
42
+ const effective = effectiveRegistry(registry);
43
+ const lines = [`registry=${effective}`];
28
44
  const t = String(token || '').trim();
29
45
  if (t) {
30
- const prefix = registryAuthPrefix(registry);
46
+ const prefix = registryAuthPrefix(effective);
31
47
  if (prefix) lines.push(`${prefix}:_authToken=${t}`);
32
48
  }
33
49
  return `${lines.join('\n')}\n`;
@@ -48,9 +64,10 @@ export function writeNpmrc({ workspaceRoot = '', registry = 'https://registry.np
48
64
  }
49
65
 
50
66
  /** 拼 npm 全局参数:统一走我们的 npmrc + 显式 registry(不改用户全局配置)。 */
51
- export function npmArgs({ npmrcFile = '', registry = 'https://registry.npmjs.org/' } = {}) {
67
+ export function npmArgs({ npmrcFile = '', registry = DEFAULT_REGISTRY } = {}) {
52
68
  const args = [];
53
69
  if (npmrcFile) args.push('--userconfig', npmrcFile);
54
- if (registry) args.push('--registry', registry);
70
+ const effective = effectiveRegistry(registry);
71
+ if (effective) args.push('--registry', effective);
55
72
  return args;
56
73
  }
package/lib/self/index.js CHANGED
@@ -9,7 +9,7 @@
9
9
  */
10
10
 
11
11
 
12
- export const VERSION = '2.20.11'; // 2.20.11:修 CI 真因——test-cifs-init 直接 execFileSync 读 `git config --global --get-all safe.directory`,而该键**不存在时退出码为 1**,execFileSync 抛错;CI 是全新 HOME(无该键)必炸,本地开发机早有该键所以一直绿。改用无键容错的 readGlobalSafeDirs()(无键即空列表)。以「全新 HOME」模拟 CI 条件验证 7/7 通过。历史:2.20.10:敏感文件扫描不再享「强制全仓」特权——改为与审计同一开关同一范围:审计关闭(audit=false)时不扫,审计开启时只扫「本次将提交的文件」(按 auditScanScope 的 diff 语义)。新增 scanSensitive 参数贯通 tool-call → commitAndPush → ensureGitignore;缺省 true 仅为兼容直接调用方(CLI/测试)。历史:2.20.9:修「有改动提交卡分钟级」——scanSensitiveFiles 递归读全仓每个文件内容,在 CIFS/SMB 上每文件一次网络往返;724 文件的仓库实测单文件改动卡满 15 分钟仍未返回(0 改动秒回,因为零改动整段跳过)。改为提交路径只扫「本次将提交的文件」(paths 精确模式用 pathList,否则解析 git status --porcelain 的变更集);实测同一仓库从 60 秒跑不完降到 26 毫秒。缺省不传 onlyPaths 时保持原全仓行为(兼容其它调用方)。历史:2.20.8:修 CI 假红——test-cifs-init 的幂等断言把 skipped 文案写死成「已登记」,但这是 CIFS 环境分支;CI 是本地盘、属主与进程同 uid,走的是「属主一致」分支,断言因此恒失败(run 57~61 全红而本地一直绿)。改为按环境分支匹配 /已登记|一致/,并在本地盘条件(/tmp + 同 uid)完整复刻验证通过。历史:2.20.7:修 dataflow/clear-then-access 第六类误报——reset() 被当清空方法。业务代码里 reset() 绝大多数是「恢复默认值/重置状态」,重置后对象仍有内容、读取安全(实测:某配置类 reset()->bool,测试断言 cfg.reset() 后 get("general.theme")=="dark" 取得有效默认值);同语料 13 条命中里 12 条源于此。已从 CLEAR_METHODS 移除,真正的容器清空用 clear()(保留)。历史:2.20.6:修 dataflow/clear-then-access 第五类系统性误报——Python 缩进式函数体从未被识别(区间收集只认 function 关键字与 ') {'),fnRanges 为空导致 mergeFnRanges 退化成「整个文件一个区间」,同文件内任意位置的 clear 与 access 都配成一对(实测 clear 在 invalidate()、访问在 build_index(),相距 177 行仍被报)。新增 collectPythonDefBodies 按缩进解析 def/async def 块并独立成体;闭包(嵌套 def 捕获外层变量)仍合并为一个体(是同一数据流,不该拆)。真实语料 13→1,剩余 1 条属 D3 边界内的合理提示(reset 后另有 _load_settings 重填,跨方法推断不做)。历史:2.20.5:修 dataflow/clear-then-access 四类系统性误报(真实语料实测 11 条命中里 8 条是误报)——①.empty() 被当清空(实为查询,从 CLEAR_METHODS 移除)②写目标 obj[k]=v 被当读访问(配对 ] 后跟 = 即按写回撤销)③类型注解位参与(PEP526 `x: list = []` 的 list 被当对象名、`-> list[str]` 被当访问;`:` 前须为标识符以区分 Python 函数定义冒号)④多目标解包错位(`a, b = [], {}` 把 [] 算给 b)。修复后同批文件 11→3 且剩余 3 条经人工核实均为真命中,真缺陷未被压制(正样本断言)。历史:2.20.4:树化迁移第二条 short-func-name——类方法/对象方法短名此前完全查不到(token 级只认 function 关键字),现走 method_definition 等定义节点判定;get/set 访问器显式排除(name 是属性名非函数名);初筛补方法形态 pattern(allow 精筛前 pattern 必须先命中候选,否则树化无效);TREE_FIRST_KINDS 登记 short-func-name。历史:2.20.3:修 CIFS/SMB 上「建仓成功但仓库对外不可用」——forceuid 挂载把目录属主映射成挂载用户(本机 杜渊/1026)而进程 uid 是套件用户(284371),git 2.55 对所有命令报 dubious ownership;插件内部带 -c safe.directory=* 感觉不到,交出去的仓库用户一敲 git 就挂。实测仓库级 [safe] directory 不生效(所有权检查先于读仓库 config),故新增 registerTrustedRepo/unregisterTrustedRepo 走 global 具体路径登记(只登记该目录,不用 *,同 uid 自动跳过),ensureUsableLocalRepo 三条路径(keep/create/repair)统一补齐。历史:2.20.2:修委托层自身灯下黑——tools/ruff 缺可执行位时旧行为静默返回空,与「项目没配 ruff」在报告里完全无法区分(部署副本迁移实测踩中:cp/同步不保 mode)。新增 detectLinterStatus 输出 unavailable(含具体成因与修复动作),并接进 linted;候选路径四律清单合并为 binCandidates 单一来源(原 resolveBin 与 resolveBinDetailed 各写一份,改一处漏一处会自相矛盾)。历史:2.20.1:新增外部 linter 委托层(方向 A 骨架,lib/lint-adapter/)——探测被审项目自带官方 linter([tool.ruff] 配置 + tools/·PATH 可执行自探测)→ 调用 ruff --output-format json → 适配成统一 finding(规则码→维度映射、路径转相对、来源标记 linter:ruff)。两条硬约束落地:①外部 finding severity 恒封顶 warning,**只进评分与报告、绝不进拦截门禁**(别人的规则集不裁决本仓能否提交);②探不到/崩溃/超时/坏输出一律降级空(含退出码≥2 不得被当成「外部判定无问题」的假阴性)。仅 full 范围委托;linted 委托状态进审计结果(防静默空转);lint-adapter 纳入层边界门禁 AUDIT_DIRS。历史:2.20.0:评分「零规则维度记 0」——本次生效规则集里一条规则都没绑定的维度(无检测能力)权重记 0 剔出分母,并回传 uncoveredDimensions 显式标注「测不到≠质量高」;编排层新增 computeDimRuleCounts,五个评分调用点统一接 dimRuleCounts,含全塌保护与向后兼容。历史:2.19.0:审计「有树走树」(方向 E1-E3)——凭据精筛 credential-value 改吃 tree-sitter 语法树(参数默认值/复合右值/三元不再误报、bytes/raw 前缀真凭据不再漏报、凭据名强弱分级+值置信度),建树触发与 astConfirmSpan 解耦(TREE_FIRST_KINDS),treeUsage 状态进审计结果(防静默回退)。历史:2.18.3:新增 scope_check 工具与 kind=scope-collision 审计规则(拼接产物作用域撞名)。
12
+ export const VERSION = '2.20.17'; // 2.20.17:修桌面端(dsh-app://)所有写接口 403 NO_ORIGIN + 本地列表超时改预算传播 + 放行判据加固。① 桌面壳 forwardWebRequest 转发 /api/* 时显式剥离 Origin,checkOrigin 对无 Origin 的写请求一律拒,导致设置页所有保存/开关/按钮失效且不留日志 → 无 Origin 时要求「Content-Type=application/json + 本机来源」同时成立才放行;② 本机判定以 TCP 对端地址(socket.remoteAddress,内核给出不可伪造)为准,Host 仅在拿不到 socket 时兜底——只信 Host 会被 `Host: 127.0.0.1` 伪造绕过;isLoopbackHost 补裸 IPv6 与 ::ffff: 映射形态;③ 恢复 403 拒绝日志 http-rejects.log(query 凭据键打码);④ settings-set 凭据类回显改「(已保存)」;⑤ 前端保存先 await 写入结果再提示;⑥ clone-progress 改 GET 轮询;⑦ 本地列表 SSH 探测改为预算传播(每步 timeoutMs = min(单步上限, 剩余预算)),扫描长轮询 60s→20s、前端单请求 25s,轮次耗尽不再误报「扫描完成」。历史:2.20.15:
13
13
  // 实测后果:该目录有 package.json ⇒ npm 去打包整棵 DSH 树、输出 2.1MB > spawnSync 默认 maxBuffer 1MB ⇒ ENOBUFS(npm_publish 的体检与真发全部失败);
14
14
  // 该目录没有 package.json 时报 ENOENT。现 publish 的两个调用点显式传 cwd=目标包目录,并给 runNpm 加 16MB maxBuffer。
15
15
  // 2.8.3:文案修正——「零改动 / 无新提交」明确为**正常成功路径**(注入用法、工具描述、README、skill 同批改),并修 job 输出自相矛盾(cleanSkipCommit 路径补 committed:false,不再显示「已提交,未推送」)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-git-push",
3
- "version": "2.20.11",
3
+ "version": "2.20.17",
4
4
  "description": "DSH git 自动提交推送插件——统一函数入口架构(规则/审计/git/自身/侧边栏/评分/豁免/上下文/HTTP/测试十大总入口)",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
@@ -16,6 +16,8 @@
16
16
  "scripts",
17
17
  "assets",
18
18
  "cli.mjs",
19
+ "cli-audit.mjs",
20
+ "cli-tool.mjs",
19
21
  "cordis.patch.yml",
20
22
  "README.md",
21
23
  "LICENSE",
@@ -23,7 +25,9 @@
23
25
  ".gitignore"
24
26
  ],
25
27
  "bin": {
26
- "git-sluice": "./cli.mjs"
28
+ "git-sluice": "./cli.mjs",
29
+ "audit-sluice": "./cli-audit.mjs",
30
+ "tool-sluice": "./cli-tool.mjs"
27
31
  },
28
32
  "dsh": {
29
33
  "bundle": {
@@ -0,0 +1,235 @@
1
+ #!/usr/bin/env node
2
+ // 提交前审计引擎 · 轻量门禁入口(不是给人看的 CLI,只服务 commit 门禁)
3
+ //
4
+ // 为什么单独开一个入口、不复用 cli.mjs(实测数字决定,别改成"复用更省事"):
5
+ // 同一仓库、同一 scope、同一台 CIFS 机器上——
6
+ // 进程内直接调审计内核 1.0s
7
+ // 本轻量入口(子进程 + JSON) 1.3s
8
+ // cli.mjs audit --json 6.4s
9
+ // 多出来的 5.4s 全是 cli.mjs 全家桶的 ESM 模块解析(account/vcs/doc/npm/git 命令族被
10
+ // 一路链式 import 进来),与本次审计无关。门禁每次提交都要跑,不能为此付 5 秒。
11
+ // 所以本文件**只** import 审计内核与评分两层,加任何新的 import 前先量耗时。
12
+ //
13
+ // 契约(与实现语言无关,替代引擎照此实现即可):
14
+ // stdout : 一行 JSON { ok, scope, summary, quality, findings, files }
15
+ // 退出码 : 0 = 无 blocker(放行)/ 1 = 有 blocker(拦截)/ 2 = 执行失败(参数错、内部异常)
16
+ // stderr : 仅诊断信息,不参与判定
17
+ // --blockers-only : findings 只留 blocker 级(大仓 4900 条约 3.8MB,门禁未必需要全量)
18
+ //
19
+ // stdout 纯净性:审计过程里任何 console.* / 直接 stdout 写入都被临时改道到 stderr,
20
+ // 最后只由本文件写那一行 JSON。否则调用方 JSON.parse 会被进度噪音打死(历史故障)。
21
+ //
22
+ // 参数缺省语义(必须与插件默认配置等价,测试钉住):
23
+ // --max-scan-files 缺省 = DEFAULT_MAX_SCAN_FILES(3000),**不是 0**
24
+ // —— capScanFiles 里 0 的含义是「不限」,把缺省当 0 会把大仓全量扫,语义正好相反。
25
+ // --disabled-slots 缺省 = 不禁用任何槽位。
26
+ // --slots 缺省 = 不限定规则包(加载层默认偏好顺序);只在调用方显式给白名单时传。
27
+
28
+ import { fileURLToPath } from 'node:url';
29
+ import { resolve } from 'node:path';
30
+
31
+ // 宿主文档漂移检查器接线(导入即安装,幂等):`lib/audit/**` 不许 import scripts/**,
32
+ // 这两个检查器由宿主入口注入。漏掉这一行会让「目录树漂移 / 函数列表漂移」两类 finding
33
+ // 整类消失(实测同一棵树上少 4 条 finding)——**行为一致性要求本入口必须显式接线**,
34
+ // 与 lib/commit-push.js / cli.mjs 两处宿主入口同款。依赖只有 node 内置模块,几乎零加载代价。
35
+ import '../lib/app/host-doc-checks.js';
36
+ import { auditWithScope } from '../lib/audit/index.js';
37
+ import { scoreQuality } from '../lib/score/index.js';
38
+
39
+ /** 退出码语义(任何语言都能实现 exit 0/1/2,比让调用方解析 JSON 猜语义可靠)。 */
40
+ export const EXIT_OK = 0;
41
+ export const EXIT_BLOCKED = 1;
42
+ export const EXIT_FAILED = 2;
43
+
44
+ /**
45
+ * 引擎侧「全量扫描文件数上限」默认值。
46
+ * 单一来源是 lib/app/schema-audit.js 的 DEFAULT_MAX_SCAN_FILES(3000,由 lib/client/index.js
47
+ * 的 MAX_SCAN_FILES_DEFAULT 与之对齐)。本文件不复用那个常量是因为轻量入口不能 import
48
+ * lib/app/ 与 lib/client/(那会把加载代价拉回去)。代价是两处数字必须相等 ——
49
+ * test/test-pre-commit-engine.mjs 用 defaultConfig().maxScanFiles 钉住这条,改一处漏另一处会变红。
50
+ */
51
+ export const DEFAULT_MAX_SCAN_FILES = 3000;
52
+
53
+ /** 参数错误统一用这个错误类型,main 据此输出「用法」而不是「内部异常」。 */
54
+ export class GateUsageError extends Error {
55
+ constructor(message) {
56
+ super(message);
57
+ this.name = 'GateUsageError';
58
+ }
59
+ }
60
+
61
+ /**
62
+ * 解析命令行参数(纯函数,测试可直接调用,不必起子进程)。
63
+ * @param {string[]} argv 不含 node 与脚本路径的参数表
64
+ * @returns {{repo: string, scope: 'diff'|'full', rulesetDir: string, weights: object,
65
+ * maxScanFiles: number, disabledSlots: string[], blockersOnly: boolean, json: boolean}}
66
+ */
67
+ /** 取值的参数解析器(各自单职责,主循环只做分派——避免一个巨型 if 链)。 */
68
+ function parseScopeValue(rawValue) {
69
+ if (rawValue !== 'diff' && rawValue !== 'full') throw new GateUsageError(`--scope 只接受 diff|full,收到:${rawValue}`);
70
+ return rawValue;
71
+ }
72
+
73
+ function parseWeightsValue(rawValue) {
74
+ let parsedWeights;
75
+ try {
76
+ parsedWeights = JSON.parse(rawValue);
77
+ } catch (e) {
78
+ throw new GateUsageError(`--weights 不是合法 JSON:${e.message}`);
79
+ }
80
+ return parsedWeights && typeof parsedWeights === 'object' ? parsedWeights : {};
81
+ }
82
+
83
+ function parseMaxScanFilesValue(rawValue) {
84
+ const asNumber = Number(rawValue);
85
+ // 只接受非负有限数:0 有明确含义(不限),所以不能用 falsy 判断把它当成「没传」
86
+ if (!Number.isFinite(asNumber) || asNumber < 0) throw new GateUsageError(`--max-scan-files 需要非负数字,收到:${rawValue}`);
87
+ return asNumber;
88
+ }
89
+
90
+ function parseSlotListValue(rawValue) {
91
+ return String(rawValue).split(',').map((slotName) => slotName.trim()).filter(Boolean);
92
+ }
93
+
94
+ /**
95
+ * 参数分派表:键是参数名,值是「要不要取值 + 怎么落到解析结果上」。
96
+ * 未知参数一律报错(不做静默忽略)——拼错的参数被忽略,等于门禁悄悄少传一项设置。
97
+ */
98
+ const GATE_FLAG_SPECS = {
99
+ '--repo': { needsValue: true, apply: (target, rawValue) => { target.repo = rawValue; } },
100
+ '--scope': { needsValue: true, apply: (target, rawValue) => { target.scope = parseScopeValue(rawValue); } },
101
+ '--ruleset': { needsValue: true, apply: (target, rawValue) => { target.rulesetDir = rawValue; } },
102
+ '--weights': { needsValue: true, apply: (target, rawValue) => { target.weights = parseWeightsValue(rawValue); } },
103
+ '--max-scan-files': { needsValue: true, apply: (target, rawValue) => { target.maxScanFiles = parseMaxScanFilesValue(rawValue); } },
104
+ '--disabled-slots': { needsValue: true, apply: (target, rawValue) => { target.disabledSlots = parseSlotListValue(rawValue); } },
105
+ '--slots': { needsValue: true, apply: (target, rawValue) => { target.slots = parseSlotListValue(rawValue); } },
106
+ '--blockers-only': { needsValue: false, apply: (target) => { target.blockersOnly = true; } },
107
+ '--json': { needsValue: false, apply: (target) => { target.json = true; } },
108
+ };
109
+
110
+ /**
111
+ * 解析命令行参数(纯函数,测试可直接调用,不必起子进程)。
112
+ * @param {string[]} argv 不含 node 与脚本路径的参数表
113
+ * @returns {{repo: string, scope: 'diff'|'full', rulesetDir: string, weights: object,
114
+ * maxScanFiles: number, disabledSlots: string[], slots: string[], blockersOnly: boolean, json: boolean}}
115
+ */
116
+ export function parseGateArgs(argv = []) {
117
+ const target = {
118
+ repo: '',
119
+ scope: 'diff',
120
+ rulesetDir: '',
121
+ weights: {},
122
+ maxScanFiles: DEFAULT_MAX_SCAN_FILES,
123
+ disabledSlots: [],
124
+ slots: [],
125
+ blockersOnly: false,
126
+ json: false,
127
+ };
128
+ for (let cursor = 0; cursor < argv.length; cursor += 1) {
129
+ const flagName = argv[cursor];
130
+ const spec = GATE_FLAG_SPECS[flagName];
131
+ if (!spec) throw new GateUsageError(`不认识的参数:${flagName}`);
132
+ if (!spec.needsValue) { spec.apply(target); continue; }
133
+ const flagValue = argv[cursor + 1];
134
+ if (flagValue === undefined) throw new GateUsageError(`参数 ${flagName} 缺少取值`);
135
+ cursor += 1;
136
+ spec.apply(target, flagValue);
137
+ }
138
+ if (!target.repo) throw new GateUsageError('缺少必填参数 --repo <仓库绝对路径>');
139
+ return target;
140
+ }
141
+
142
+ /**
143
+ * 跑一次审计并组装契约 JSON(纯逻辑,测试可直接调用)。
144
+ * 与旧「进程内提交门禁」逐项对齐的点:
145
+ * · scope / maxScanFiles / rulesetDir / disabledSlots 的取值路径完全相同;
146
+ * · 评分上下文只给 files / dimFileCounts / dimRuleCounts(**不给 docsScore**)——
147
+ * 旧 runAudit 就是这么调的,多给一项会让分数变化;
148
+ * · summary 直接透传内核结果,不在这里重新计数。
149
+ * @param {object} opts parseGateArgs 的返回值
150
+ * @returns {Promise<{ok: boolean, scope: string, summary: object, quality: object, findings: object[], files: number}>}
151
+ */
152
+ export async function runGateAudit(opts) {
153
+ const auditResult = await auditWithScope(opts.repo, {
154
+ scope: opts.scope,
155
+ maxScanFiles: opts.maxScanFiles,
156
+ rulesetDir: opts.rulesetDir,
157
+ // 空数组与 undefined 在加载层同义(都用默认偏好顺序),显式给 undefined 更贴合旧行为
158
+ slots: Array.isArray(opts.slots) && opts.slots.length ? opts.slots : undefined,
159
+ disabledSlots: Array.isArray(opts.disabledSlots) ? opts.disabledSlots : [],
160
+ });
161
+ const quality = scoreQuality(auditResult.findings, opts.weights, {
162
+ files: auditResult.files,
163
+ dimFileCounts: auditResult.dimFileCounts,
164
+ dimRuleCounts: auditResult.dimRuleCounts,
165
+ });
166
+ const findings = opts.blockersOnly
167
+ ? (auditResult.findings || []).filter((finding) => finding.severity === 'blocker')
168
+ : (auditResult.findings || []);
169
+ return {
170
+ ok: (auditResult.summary?.blocker ?? 0) === 0,
171
+ scope: auditResult.scope,
172
+ summary: auditResult.summary,
173
+ quality,
174
+ findings,
175
+ files: auditResult.files,
176
+ };
177
+ }
178
+
179
+ /**
180
+ * 把审计期间的一切 stdout 写入改道到 stderr,返回还原函数。
181
+ * 为什么不用「审计结束后从 stdout 里找 JSON 行」:findings 可达数 MB 且内容里可能含
182
+ * 花括号,正则挑行不可靠;从源头保证 stdout 只有一行才是可验证的。
183
+ */
184
+ export function muteStdout() {
185
+ const originalWrite = process.stdout.write;
186
+ process.stdout.write = process.stderr.write.bind(process.stderr);
187
+ return () => { process.stdout.write = originalWrite; };
188
+ }
189
+
190
+ /** 写契约 JSON 并在冲刷完成后退出(flush 后再 exit,避免大 payload 被截断)。 */
191
+ function emitAndExit(result, exitCode) {
192
+ const payload = `${JSON.stringify(result)}\n`;
193
+ process.stdout.write(payload, () => { process.exit(exitCode); });
194
+ }
195
+
196
+ /** 入口:解析 → 审计 → 输出 → 定退出码。 */
197
+ async function main(argv) {
198
+ let opts;
199
+ try {
200
+ opts = parseGateArgs(argv);
201
+ } catch (e) {
202
+ process.stderr.write(`${e.name === 'GateUsageError' ? '参数错误' : '内部错误'}:${e.message}\n`);
203
+ return EXIT_FAILED;
204
+ }
205
+ const restoreStdout = muteStdout();
206
+ let gateAuditResult;
207
+ try {
208
+ gateAuditResult = await runGateAudit(opts);
209
+ } catch (e) {
210
+ process.stderr.write(`审计执行失败(repo=${opts.repo} scope=${opts.scope}):${e?.stack || e}\n`);
211
+ return EXIT_FAILED;
212
+ } finally {
213
+ restoreStdout();
214
+ }
215
+ emitAndExit(gateAuditResult, gateAuditResult.ok ? EXIT_OK : EXIT_BLOCKED);
216
+ // emitAndExit 内部已注册退出,这里返回一个占位码保持函数语义完整
217
+ return gateAuditResult.ok ? EXIT_OK : EXIT_BLOCKED;
218
+ }
219
+
220
+ /** 直接执行时才真正开跑:被测试 import 时不得产生副作用。 */
221
+ function invokedDirectly() {
222
+ const entry = process.argv[1];
223
+ if (!entry) return false;
224
+ try { return resolve(entry) === resolve(fileURLToPath(import.meta.url)); } catch { return false; }
225
+ }
226
+
227
+ if (invokedDirectly()) {
228
+ main(process.argv.slice(2)).then((code) => {
229
+ // 正常路径里 emitAndExit 已经退出;走到这里说明审计抛错或没输出结果
230
+ if (typeof code === 'number') process.exitCode = code;
231
+ }).catch((e) => {
232
+ process.stderr.write(`未捕获异常:${e?.stack || e}\n`);
233
+ process.exit(EXIT_FAILED);
234
+ });
235
+ }
@@ -25,7 +25,15 @@ import { join, dirname } from 'node:path';
25
25
  import { fileURLToPath } from 'node:url';
26
26
 
27
27
  export const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
28
- export const PARTS_DIR = join(ROOT, 'lib', 'client-parts');
28
+ // 分片按侧分目录(2026-11-08 UI 与审计解耦):
29
+ // · lib/client-parts/git/** —— git / 发布 / 工具链侧,**参与构建**(本文件的 PARTS_DIR)
30
+ // · lib/client-parts/audit/** —— 审计侧,**不参与构建**(UI 上不再有审计 Tab)
31
+ // 审计侧分片留在源码里可查可改(将来拆成独立项目时整体搬走),但不进产物 ⇒ 不进 UI。
32
+ // 不参与构建的方式:不在 PARTS_DIR 下 ⇒ readParts 的「未登记分片」检查天然扫不到它,
33
+ // 也不会因「缺片」报错(缺片检查只针对 PART_ORDER 里列出的片)。
34
+ export const PARTS_DIR = join(ROOT, 'lib', 'client-parts', 'git');
35
+ /** 不参与构建的分片目录(只做归档,构建脚本不读、不校验)。 */
36
+ export const ARCHIVE_PARTS_DIR = join(ROOT, 'lib', 'client-parts', 'audit');
29
37
  export const OUT_FILE = join(ROOT, 'lib', 'client.js');
30
38
 
31
39
  /**
@@ -36,7 +44,7 @@ export const OUT_FILE = join(ROOT, 'lib', 'client.js');
36
44
  * 命名约定:分片文件名**不带数字序号**(顺序只由本表这一处权威声明)。
37
45
  * 序号前缀看似方便,实则会漂移——重排/插片时新旧序号并存,扫目录看到的顺序
38
46
  * 与真实拼接顺序不一致,比没有序号更坏。顺序信息集中在 PART_ORDER +
39
- * 每个分片头注释的「第 N/14 片」锚点,改序只改这两处。
47
+ * 每个分片头注释的「第 N/M 片」锚点,改序只改这两处。
40
48
  */
41
49
  export const PART_ORDER = [
42
50
  'loader.js', // [1] loader + factory 头 + require + NS(必须首片)
@@ -47,12 +55,11 @@ export const PART_ORDER = [
47
55
  'browser.js', // [6] 目录选择器
48
56
  'repo.js', // [7] 仓库管理卡
49
57
  'npm.js', // [7续] NPM 面板(账号卡 + 装包表单 + npm 凭据字段)
50
- 'audit.js', // [8] 审计 Tab
51
- 'settings.js', // [9] 设置 Tab
52
- 'page.js', // [10] 页面装配(GitPushPage)
53
- 'controller.js', // [11] Controller:状态机 + 数据加载
54
- 'actions.js', // [11续] Controller:动作注入
55
- 'apply.js', // [12] 收尾:注册 settings.section + factory 返回(必须末片)
58
+ 'settings.js', // [8] 设置 Tab(原第 9 片;审计 Tab 已移出构建)
59
+ 'page.js', // [9] 页面装配(GitPushPage,两选项卡)
60
+ 'controller.js', // [10] Controller:状态机 + 数据加载
61
+ 'actions.js', // [10续] Controller:动作注入
62
+ 'apply.js', // [11] 收尾:注册 settings.section + factory 返回(必须末片)
56
63
  ];
57
64
 
58
65
  /** 读出全部分片内容(缺片直接报错,避免拼出半份产物当成功)。 */
package/scripts/check.mjs CHANGED
@@ -41,7 +41,10 @@ function collectJson(dir, acc = []) {
41
41
  return acc;
42
42
  }
43
43
 
44
- const files = [...collectJs(join(ROOT, 'lib')), join(ROOT, 'cli.mjs')];
44
+ // 三个 CLI 入口都要做语法检查:它们不是 lib/ 下的文件,靠 collectJs 收不到——
45
+ // 漏检的后果是「新入口语法错,但门禁全绿」(与被拆出来的入口一起构成盲区)。
46
+ const CLI_ENTRIES = ['cli.mjs', 'cli-audit.mjs', 'cli-tool.mjs'].map((name) => join(ROOT, name));
47
+ const files = [...collectJs(join(ROOT, 'lib')), ...CLI_ENTRIES];
45
48
  // docs/*.json 也必须能解析:版本表与发版说明直接依赖 docs/releases.json,
46
49
  // 而它曾在 2.8.4 因一个尾随逗号变成非法 JSON 却**四项门禁全绿**(缺口)——这类错误必须在门禁里变红 ✗
47
50
  const jsonFiles = [...collectJson(join(ROOT, 'lib')), ...collectJson(join(ROOT, 'docs'))];
@@ -134,8 +137,14 @@ const AUDIT_DIRS = new Set(['ast', 'audit', 'audit-rules', 'checks', 'exempt', '
134
137
  const GIT_DIRS = new Set(['git', 'npm']);
135
138
  const GIT_TOP = new Set(['commit-push.js']);
136
139
  const AUDIT_TOP = new Set(['audit-defaults.js', 'skip-dirs.js']);
137
- /** 反向接缝预算:实测 7 处(commit-push 3 + git/{ignore,repos,sensitive} 4);上调需写明理由。 */
138
- const SEAM_BUDGET = 7;
140
+ /**
141
+ * 反向接缝预算:实测 **5 处**;上调需写明理由。
142
+ *
143
+ * 2026-11-13 从 7 降到 5:提交前预处理解耦后,`lib/commit-push.js` 不再 import `audit/index.js` 与
144
+ * `score/index.js`(改调外部引擎子进程),只剩 `exempt/index.js` 这一条(示例目录豁免要用)。
145
+ * 预算跟着实收紧,是为了让这个成果**被门禁钉住**——以后谁再往 git 侧加审计 import,5→6 就会红。
146
+ */
147
+ const SEAM_BUDGET = 5;
139
148
 
140
149
  const layerOf = (rel) => {
141
150
  const top = rel.split('/')[0];
@@ -556,7 +556,10 @@ export function main(argv = process.argv.slice(2)) {
556
556
  const defaults = targets.length ? targets : [
557
557
  join(root, '..', 'lib'),
558
558
  join(root, '..', 'scripts'),
559
+ // 三个 CLI 入口都在默认扫描集里:入口按侧拆分后,漏掉新入口 = file-io 默认静默漏扫
559
560
  join(root, '..', 'cli.mjs'),
561
+ join(root, '..', 'cli-audit.mjs'),
562
+ join(root, '..', 'cli-tool.mjs'),
560
563
  join(root, '..', 'lib', 'client.js'),
561
564
  ];
562
565
  const files = collectFiles(defaults);
@@ -582,7 +585,8 @@ export function scanFileIo(opts = {}) {
582
585
  const root = dirname(fileURLToPath(import.meta.url));
583
586
  const dirs = targets.length ? targets : [
584
587
  join(root, '..', 'lib'), join(root, '..', 'scripts'),
585
- join(root, '..', 'cli.mjs'), join(root, '..', 'lib', 'client.js'),
588
+ join(root, '..', 'cli.mjs'), join(root, '..', 'cli-audit.mjs'), join(root, '..', 'cli-tool.mjs'),
589
+ join(root, '..', 'lib', 'client.js'),
586
590
  ];
587
591
  const files = collectFiles(dirs);
588
592
  let hits = [];
@@ -74,13 +74,16 @@ function main() {
74
74
  const vi = versionInfo(pkgJson);
75
75
  if (!vi.ok) errors.push(vi.error);
76
76
  // 3) cli.mjs HELP 文本(源码里是 v${VERSION} 模板,运行时渲染为 v<版本>)
77
- const cliPath = join(ROOT, 'cli.mjs');
78
- let cliText = '';
79
- if (existsSync(cliPath)) {
80
- try { cliText = readFileSync(cliPath, 'utf8'); } catch { /* 忽略 */ }
81
- }
82
- if (!cliText.includes('v${VERSION}')) {
83
- errors.push('cli.mjs HELP 未引用 v${VERSION} 模板(应在 HELP 首行 git-sluice v${VERSION})');
77
+ // 三个 CLI 入口都必须在 HELP 首行引用 v${VERSION} 模板(入口拆成三个后,只查 cli.mjs 会漏掉另外两个)
78
+ for (const entryFile of ['cli.mjs', 'cli-audit.mjs', 'cli-tool.mjs']) {
79
+ const entryPath = join(ROOT, entryFile);
80
+ let entryText = '';
81
+ if (existsSync(entryPath)) {
82
+ try { entryText = readFileSync(entryPath, 'utf8'); } catch { /* 忽略 */ }
83
+ }
84
+ if (!entryText.includes('v${VERSION}')) {
85
+ errors.push(`${entryFile} HELP 未引用 v${VERSION} 模板(应在 HELP 首行 <CLI名> v${VERSION})`);
86
+ }
84
87
  }
85
88
  // 4) 版本列表宿主(适配分体式:优先 docs/CHANGELOG.md 的 dshgp-version
86
89
  // 标记块——README 不再内嵌版本表,只有链接引用;无标记块回退 README 章节)