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.
- package/README.md +10 -6
- package/cli-audit.mjs +141 -0
- package/cli-tool.mjs +86 -0
- package/cli.mjs +114 -335
- package/lib/app/command-registry.js +3 -2
- package/lib/app/constants.js +9 -0
- package/lib/app/handlers/clone.js +12 -3
- package/lib/app/handlers/http-constants.js +11 -2
- package/lib/app/handlers/npm.js +4 -2
- package/lib/app/handlers/repos.js +10 -1
- package/lib/app/handlers/settings.js +9 -1
- package/lib/app/http-handlers.js +24 -3
- package/lib/app/schema-audit.js +42 -0
- package/lib/app/schema.js +19 -19
- package/lib/app/settings-bridge.js +51 -0
- package/lib/app/tool-call.js +7 -5
- package/lib/audit-rules/audit-rules-paths.yml +7 -1
- package/lib/audit-ui-sdk/contract.js +117 -0
- package/lib/audit-ui-sdk/index.js +17 -0
- package/lib/checks/regex.js +6 -1
- package/lib/cli/commands-audit.mjs +12 -17
- package/lib/cli/commands-tool.mjs +93 -0
- package/lib/cli/commands-vcs.mjs +2 -1
- package/lib/cli/shared.mjs +448 -0
- package/lib/client-parts/{account.js → git/account.js} +1 -1
- package/lib/client-parts/{actions.js → git/actions.js} +26 -11
- package/lib/client-parts/{apply.js → git/apply.js} +1 -1
- package/lib/client-parts/{browser.js → git/browser.js} +1 -1
- package/lib/client-parts/{const.js → git/const.js} +6 -1
- package/lib/client-parts/{controller.js → git/controller.js} +23 -11
- package/lib/client-parts/{icons.js → git/icons.js} +1 -1
- package/lib/client-parts/{loader.js → git/loader.js} +1 -1
- package/lib/client-parts/{npm.js → git/npm.js} +1 -1
- package/lib/client-parts/{page.js → git/page.js} +11 -21
- package/lib/client-parts/{repo.js → git/repo.js} +1 -1
- package/lib/client-parts/{settings.js → git/settings.js} +1 -1
- package/lib/client-parts/{utils.js → git/utils.js} +1 -1
- package/lib/client.js +75 -354
- package/lib/commit-push/pre-commit-engine.js +388 -0
- package/lib/commit-push.js +42 -20
- package/lib/git/transport.js +31 -10
- package/lib/http/index.js +82 -10
- package/lib/npm/npmrc.js +22 -5
- package/lib/self/index.js +1 -1
- package/package.json +6 -2
- package/scripts/audit-gate.mjs +235 -0
- package/scripts/build-client.mjs +15 -8
- package/scripts/check.mjs +12 -3
- package/scripts/scan-file-io.mjs +5 -1
- package/scripts/scan-version.mjs +10 -7
- package/skills/dev/dsh-git-push.md +62 -0
- package/skills/guide/guide-audit.md +11 -11
- package/skills/guide/guide-cli-scripts.md +3 -3
- package/skills/guide/guide-commit-push.md +2 -2
- package/skills/guide/guide-inject-ui.md +0 -16
- package/assets/start.sh +0 -396
- package/scripts/scan-hardcoded-paths.mjs +0 -125
- /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
|
-
|
|
50
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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 =
|
|
27
|
-
const
|
|
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(
|
|
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 =
|
|
67
|
+
export function npmArgs({ npmrcFile = '', registry = DEFAULT_REGISTRY } = {}) {
|
|
52
68
|
const args = [];
|
|
53
69
|
if (npmrcFile) args.push('--userconfig', npmrcFile);
|
|
54
|
-
|
|
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.
|
|
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.
|
|
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
|
+
}
|
package/scripts/build-client.mjs
CHANGED
|
@@ -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
|
-
|
|
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/
|
|
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
|
-
'
|
|
51
|
-
'
|
|
52
|
-
'
|
|
53
|
-
'
|
|
54
|
-
'
|
|
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
|
-
|
|
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
|
-
/**
|
|
138
|
-
|
|
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];
|
package/scripts/scan-file-io.mjs
CHANGED
|
@@ -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, '..', '
|
|
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 = [];
|
package/scripts/scan-version.mjs
CHANGED
|
@@ -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
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
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 章节)
|