dsh-git-push 2.20.19 → 3.1.0
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 +76 -47
- package/cli-tool.mjs +2 -4
- package/cli.mjs +11 -4
- package/lib/app/apply.js +15 -13
- package/lib/app/command-registry.js +26 -19
- package/lib/app/handlers/http-constants.js +8 -0
- package/lib/app/handlers/meta.js +2 -2
- package/lib/app/handlers/preprocess.js +104 -0
- package/lib/app/handlers/repo-actions.js +2 -3
- package/lib/app/handlers/repos.js +137 -10
- package/lib/app/handlers/settings.js +34 -15
- package/lib/app/http-handlers.js +13 -42
- package/lib/app/index.js +3 -2
- package/lib/app/inject-text.js +6 -21
- package/lib/app/preprocess-client.js +136 -0
- package/lib/app/repo-ownership.js +1 -1
- package/lib/app/schema.js +20 -10
- package/lib/app/settings-bridge.js +60 -8
- package/lib/app/severity.js +14 -0
- package/lib/app/slash-commands.js +5 -164
- package/lib/app/tool-call.js +96 -163
- package/lib/cli/commands-preprocess.mjs +74 -0
- package/lib/cli/commands-tool.mjs +3 -2
- package/lib/cli/commands-vcs.mjs +39 -5
- package/lib/cli/shared.mjs +36 -10
- package/lib/client/index.js +11 -16
- package/lib/client-parts/git/account.js +21 -12
- package/lib/client-parts/git/actions.js +23 -77
- package/lib/client-parts/git/apply.js +8 -2
- package/lib/client-parts/git/browser.js +1 -1
- package/lib/client-parts/git/const.js +33 -1
- package/lib/client-parts/git/controller.js +175 -176
- package/lib/client-parts/git/icons.js +1 -1
- package/lib/client-parts/git/loader.js +1 -1
- package/lib/client-parts/git/npm.js +56 -37
- package/lib/client-parts/git/page.js +53 -1
- package/lib/client-parts/git/repo.js +8 -1
- package/lib/client-parts/git/settings.js +13 -1
- package/lib/client-parts/git/state.js +237 -0
- package/lib/client-parts/git/utils.js +1 -1
- package/lib/client.js +631 -312
- package/lib/commit-push/pre-commit-engine.js +629 -30
- package/lib/commit-push.js +127 -67
- package/lib/context/index.js +7 -5
- package/lib/core/config.js +1 -27
- package/lib/core/exec.js +2 -11
- package/lib/{exempt/index.js → git/exempt-markers.js} +8 -1
- package/lib/git/identity-rewrite.js +1 -1
- package/lib/git/ignore.js +1 -1
- package/lib/git/index.js +1 -1
- package/lib/git/push.js +2 -17
- package/lib/git/repo-index.js +8 -3
- package/lib/git/repos.js +2 -2
- package/lib/git/sensitive.js +1 -1
- package/lib/npm/install.js +1 -1
- package/lib/npm/publish.js +20 -5
- package/lib/npm/registry.js +2 -2
- package/lib/plugin/auto-push.js +5 -8
- package/lib/preprocess/providers.js +195 -0
- package/lib/self/index.js +1 -1
- package/lib/skip-dirs.js +14 -55
- package/package.json +31 -42
- package/skills/dev/dsh-git-push.md +9 -9
- package/skills/guide/guide-commit-push.md +11 -13
- package/skills/workflow/README.md +0 -1
- package/skills/workflow/task-completion-report.md +2 -2
- package/.auditignore +0 -30
- package/.gitignore +0 -43
- package/cli-audit.mjs +0 -141
- package/lib/BUGFIX-NOTES-2026-09-14.md +0 -278
- package/lib/app/audit-api.js +0 -173
- package/lib/app/handlers/audit.js +0 -150
- package/lib/app/host-doc-checks.js +0 -25
- package/lib/app/schema-audit.js +0 -42
- package/lib/app/scope-check.js +0 -69
- package/lib/ast/brace.js +0 -120
- package/lib/ast/callgraph.js +0 -135
- package/lib/ast/code-lines.js +0 -175
- package/lib/ast/consts.js +0 -12
- package/lib/ast/control-flow.js +0 -470
- package/lib/ast/credential.js +0 -315
- package/lib/ast/dataflow.js +0 -391
- package/lib/ast/dup-code.js +0 -165
- package/lib/ast/fs-hotspots.js +0 -154
- package/lib/ast/index.js +0 -38
- package/lib/ast/io-risk-const.js +0 -95
- package/lib/ast/io-risk-fn.js +0 -208
- package/lib/ast/io-risk-loop.js +0 -308
- package/lib/ast/io-risk.js +0 -314
- package/lib/ast/lang.js +0 -156
- package/lib/ast/line-count.js +0 -52
- package/lib/ast/magic-number.js +0 -272
- package/lib/ast/naming.js +0 -292
- package/lib/ast/perf.js +0 -488
- package/lib/ast/scope-collisions.js +0 -228
- package/lib/ast/scope.js +0 -241
- package/lib/ast/shell.js +0 -131
- package/lib/ast/size.js +0 -448
- package/lib/ast/symbol-index.js +0 -399
- package/lib/ast/tokenizer.js +0 -421
- package/lib/ast/treesitter.js +0 -413
- package/lib/audit/analysis-coverage.js +0 -98
- package/lib/audit/audit-file.js +0 -205
- package/lib/audit/auditignore-rules.js +0 -148
- package/lib/audit/checks.js +0 -17
- package/lib/audit/client-entry.js +0 -93
- package/lib/audit/collector.js +0 -610
- package/lib/audit/ext-runner.js +0 -80
- package/lib/audit/file-context.js +0 -391
- package/lib/audit/finding.js +0 -101
- package/lib/audit/gitignore-match.js +0 -113
- package/lib/audit/glob.js +0 -63
- package/lib/audit/history-report.js +0 -100
- package/lib/audit/history.js +0 -126
- package/lib/audit/ignore-blind.js +0 -102
- package/lib/audit/index.js +0 -33
- package/lib/audit/orchestrate.js +0 -672
- package/lib/audit/public.js +0 -24
- package/lib/audit/repo-level.js +0 -30
- package/lib/audit/report-yaml.js +0 -90
- package/lib/audit/scope-policy.js +0 -110
- package/lib/audit/slot.js +0 -66
- package/lib/audit-rules/audit-rules-comment.yml +0 -199
- package/lib/audit-rules/audit-rules-cpp.yml +0 -114
- package/lib/audit-rules/audit-rules-csharp.yml +0 -82
- package/lib/audit-rules/audit-rules-docs.yml +0 -32
- package/lib/audit-rules/audit-rules-dsh.yml +0 -177
- package/lib/audit-rules/audit-rules-filehealth.yml +0 -42
- package/lib/audit-rules/audit-rules-folder.yml +0 -99
- package/lib/audit-rules/audit-rules-frontend.yml +0 -335
- package/lib/audit-rules/audit-rules-go.yml +0 -103
- package/lib/audit-rules/audit-rules-i18n.yml +0 -45
- package/lib/audit-rules/audit-rules-java.yml +0 -105
- package/lib/audit-rules/audit-rules-nodejs.yml +0 -662
- package/lib/audit-rules/audit-rules-npm.yml +0 -187
- package/lib/audit-rules/audit-rules-paths.yml +0 -98
- package/lib/audit-rules/audit-rules-performance.yml +0 -245
- package/lib/audit-rules/audit-rules-php.yml +0 -101
- package/lib/audit-rules/audit-rules-private.yml +0 -24
- package/lib/audit-rules/audit-rules-python.yml +0 -106
- package/lib/audit-rules/audit-rules-robustness.yml +0 -31
- package/lib/audit-rules/audit-rules-rust.yml +0 -109
- package/lib/audit-rules/audit-rules-structure.yml +0 -158
- package/lib/audit-rules/audit-rules-swift.yml +0 -99
- package/lib/audit-rules/audit-rules-template.yml +0 -108
- package/lib/audit-ui-sdk/contract.js +0 -117
- package/lib/audit-ui-sdk/index.js +0 -17
- package/lib/checks/button-bind.js +0 -347
- package/lib/checks/common.js +0 -170
- package/lib/checks/credential-file.js +0 -43
- package/lib/checks/dataflow.js +0 -40
- package/lib/checks/dispatch.js +0 -117
- package/lib/checks/dup-code.js +0 -69
- package/lib/checks/dup-const.js +0 -232
- package/lib/checks/file-health.js +0 -150
- package/lib/checks/filter.js +0 -137
- package/lib/checks/folder.js +0 -173
- package/lib/checks/fs-scanner.js +0 -57
- package/lib/checks/hardcoded-path.js +0 -98
- package/lib/checks/index.js +0 -49
- package/lib/checks/io.js +0 -66
- package/lib/checks/magic-number.js +0 -42
- package/lib/checks/npm-json.js +0 -273
- package/lib/checks/private.js +0 -64
- package/lib/checks/regex.js +0 -298
- package/lib/checks/scope-collision.js +0 -68
- package/lib/checks/semantic.js +0 -134
- package/lib/checks/structural.js +0 -281
- package/lib/cli/commands-audit.mjs +0 -142
- package/lib/cli/commands-doc.mjs +0 -127
- package/lib/client-parts/audit/audit.js +0 -301
- package/lib/exempt/tool.js +0 -198
- package/lib/git/module-splitter.js +0 -47
- package/lib/link-check/index.js +0 -187
- package/lib/lint-adapter/detect.js +0 -161
- package/lib/lint-adapter/index.js +0 -50
- package/lib/lint-adapter/runner.js +0 -133
- package/lib/preprocess/audit.js +0 -98
- package/lib/preprocess/index.js +0 -78
- package/lib/rule/compilers/credential.js +0 -62
- package/lib/rule/compilers/dataflow.js +0 -38
- package/lib/rule/compilers/file-health.js +0 -75
- package/lib/rule/compilers/frontend.js +0 -86
- package/lib/rule/compilers/func.js +0 -35
- package/lib/rule/compilers/helpers.js +0 -71
- package/lib/rule/compilers/index.js +0 -29
- package/lib/rule/compilers/link-semantic.js +0 -45
- package/lib/rule/compilers/list-kinds.js +0 -12
- package/lib/rule/compilers/numeric-kinds.js +0 -73
- package/lib/rule/compilers/regex.js +0 -78
- package/lib/rule/compilers/structure.js +0 -107
- package/lib/rule/compilers.js +0 -17
- package/lib/rule/homoglyph.js +0 -45
- package/lib/rule/loader.js +0 -274
- package/lib/rule/registry.js +0 -122
- package/lib/rule/scope.js +0 -67
- package/lib/score/docs-score.js +0 -166
- package/lib/score/index.js +0 -234
- package/lib/user-requirements.json +0 -15
- package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
- package/scripts/audit-ext/_example-readme-present.mjs +0 -34
- package/scripts/audit-ext/dsh-inject-declarations.mjs +0 -209
- package/scripts/audit-ext/variable-min-length.mjs +0 -102
- package/scripts/audit-gate.mjs +0 -235
- package/scripts/audit-runner.mjs +0 -35
- package/scripts/audit-runtime-check.mjs +0 -129
- package/scripts/browser-page-probe.mjs +0 -271
- package/scripts/build-client.mjs +0 -131
- package/scripts/bump-version.mjs +0 -178
- package/scripts/check-js-scope.mjs +0 -87
- package/scripts/check.mjs +0 -203
- package/scripts/clean-date-comments.py +0 -102
- package/scripts/cpu-sample.mjs +0 -188
- package/scripts/doc-drift.mjs +0 -200
- package/scripts/doc-func.mjs +0 -212
- package/scripts/doc-tree.mjs +0 -458
- package/scripts/doc-version.mjs +0 -149
- package/scripts/hot-path-probe-cjs.cjs +0 -71
- package/scripts/hot-path-probe-fs-shim.mjs +0 -28
- package/scripts/hot-path-probe-fsp-shim.mjs +0 -31
- package/scripts/hot-path-probe.mjs +0 -153
- package/scripts/local-registry.mjs +0 -37
- package/scripts/module-splitter.py +0 -800
- package/scripts/picker-repro.mjs +0 -115
- package/scripts/platform-scan.mjs +0 -168
- package/scripts/probe-recheck.mjs +0 -47
- package/scripts/rename-locator.mjs +0 -97
- package/scripts/rule-switch.mjs +0 -97
- package/scripts/rules-solo-audit.mjs +0 -173
- package/scripts/scan-file-io.mjs +0 -717
- package/scripts/scan-fs-hotspots.mjs +0 -107
- package/scripts/scan-version.mjs +0 -125
- package/scripts/symbol-index.mjs +0 -85
- package/scripts/verify-prestep.mjs +0 -100
- package/scripts/version-source.mjs +0 -173
- package/skills/dev/audit-rule-authoring.md +0 -58
- package/skills/guide/guide-audit.md +0 -270
- /package/lib/{audit → app}/ownership.js +0 -0
- /package/lib/{audit-defaults.js → git/defaults.js} +0 -0
package/lib/checks/regex.js
DELETED
|
@@ -1,298 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 检查层 · 正则类规则
|
|
3
|
-
*
|
|
4
|
-
* 职责:跑 compiled regex/path-regex/blacklist 规则,把命中转成 finding。
|
|
5
|
-
* 正则只做初筛;需要语义确认的规则在此消费 astConfirm 精筛集合(见 common.js),
|
|
6
|
-
* 避免「正则命中即报」造成误报。
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
import { makeCodeSpanFilter, checkMagicNumberSmartAst } from '../ast/index.js';
|
|
10
|
-
import { RISK_BADGE, RISK_LABEL } from '../ast/io-risk.js';
|
|
11
|
-
// 硬编码绝对路径精筛(paths 槽位 / astConfirmKind: "hardcoded-abs-path")——引擎侧唯一实现:
|
|
12
|
-
// fs 可访问性判断 + 相对路径换算(正则做不到的两件事)。脚本调用本实现,不自带第二份 PATTERNS。
|
|
13
|
-
import { hardcodedAbsPathLines, hardcodedAbsPathDetail, describeHardcodedAbsPath } from './hardcoded-path.js';
|
|
14
|
-
|
|
15
|
-
/* ───────── 正则检查常量 ───────── */
|
|
16
|
-
const DEFAULT_REGEX_THRESHOLD = 40; // 规则未配 threshold 时的默认阈值
|
|
17
|
-
|
|
18
|
-
/**
|
|
19
|
-
* 按规则名前缀挑豁免关键词(与 lib/exempt/index.js 的 EXEMPT_MARKERS 分类一致)。
|
|
20
|
-
*
|
|
21
|
-
* 修 bug:此前只区分 `[FUNC]` / `credential-ref` 两种 kind,其余正则规则一律提示
|
|
22
|
-
* `dsh-skip-residue` ⇒ 安全类(security/credential/secret/password/hardcoded)与风格类
|
|
23
|
-
* (min-length/max-lines 等)按提示写了 residue 标记**并不会豁免**(residue 只覆盖
|
|
24
|
-
* debugger/todo/console/io-risk/client-node-builtin-require),提示与行为不符(用户实测报告)。
|
|
25
|
-
*
|
|
26
|
-
* @returns {string} 展示给用户的豁免提示(含「写哪里生效」的说明)
|
|
27
|
-
*/
|
|
28
|
-
export function pickExemptHint(rule) {
|
|
29
|
-
const id = String(rule?.id || '');
|
|
30
|
-
const kind = String(rule?.kind || '');
|
|
31
|
-
const hit = (words) => (Array.isArray(words) ? words : []).some((w) => id.includes(w));
|
|
32
|
-
const sensitive = EXEMPT_MARKERS['dsh-skip-sensitive'] || {};
|
|
33
|
-
const residue = EXEMPT_MARKERS['dsh-skip-residue'] || {};
|
|
34
|
-
const style = EXEMPT_MARKERS['dsh-skip-style'] || {};
|
|
35
|
-
// 凭据/密钥类:kind 直接判定,或规则名命中敏感词
|
|
36
|
-
if (['[FUNC]', 'credential-ref', 'credential-file', 'path-regex'].includes(kind) || hit(sensitive.sensitiveRules)) {
|
|
37
|
-
return 'dsh-skip-sensitive(行尾=本行 / 文件头=整文件)';
|
|
38
|
-
}
|
|
39
|
-
if (hit(residue.residueRules)) return 'dsh-skip-residue(行尾=本行)';
|
|
40
|
-
if (hit(style.styleRules)) return 'dsh-skip-style(文件头=整文件)';
|
|
41
|
-
// 三套清单都没命中:**不能**再沿用一个写了不生效的标记 ✗(2026-10-17「措辞无效」的根因之一:
|
|
42
|
-
// 这里原样返回 dsh-skip-residue,而 residue 只管 debugger/todo/console/io-risk 等窄集合,
|
|
43
|
-
// 其余 regex 规则(vague-function-name / timeout-on-external-api …)写了完全不生效)。
|
|
44
|
-
// 改为按注册表反查:真能豁免给出真标记,否则如实留空(由 finding 出口统一校正兜底)。
|
|
45
|
-
const truth = exemptHintForFinding({ kind: kind || 'regex', rule: id });
|
|
46
|
-
return truth ? `${truth.marker}(${truth.hint})` : '';
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
import { makeFinding } from '../audit/index.js';
|
|
50
|
-
import { safeRe } from '../rule/compilers.js';
|
|
51
|
-
import { capSeverity } from './common.js';
|
|
52
|
-
// 豁免提示按规则名前缀选关键词——分类清单复用豁免注册表(单一来源,避免两处各写一份清单)
|
|
53
|
-
import { EXEMPT_MARKERS, exemptHintForFinding } from '../exempt/index.js';
|
|
54
|
-
import { credentialValueLines, placeholderCredentialLines, shortFuncNameLines, smallFileReadLines, consoleLogJsonLines, loopFullCollectionLines, repeatIdenticalCallLines, loopNoFallbackReturnLines, loopFullRewriteCallLines, nestedLinearScanLines, longSyncLoopLines, smartHitLines, shellCdDynamicLines, writeIntoGitignoredLines, ioRiskLines, ioRiskDetail } from './common.js';
|
|
55
|
-
|
|
56
|
-
/** 检查文本是否符合 regex 型规则(regex / secret / credential-ref)。
|
|
57
|
-
* @param {object} args { file, text, rules, source? , repoPath? } repoPath:仓库根(写目标命中 .gitignore 的精筛需要) */
|
|
58
|
-
export function checkRegexRules({ file, text, rules, source = '新增行', repoPath = '', treeConfirm = null }) {
|
|
59
|
-
const findings = [];
|
|
60
|
-
const lines = text.split('\n');
|
|
61
|
-
for (const rule of rules || []) {
|
|
62
|
-
// 子模式(subPatterns: [{regex, message}])优先;退回兼容旧结构(pattern/patterns RegExp)
|
|
63
|
-
const subs = Array.isArray(rule.subPatterns) && rule.subPatterns.length ? rule.subPatterns : null;
|
|
64
|
-
const patterns = subs
|
|
65
|
-
? subs.map((x) => x.regex)
|
|
66
|
-
: [rule.pattern, ...(Array.isArray(rule.patterns) ? rule.patterns : [])].filter(Boolean);
|
|
67
|
-
if (!patterns.length) continue;
|
|
68
|
-
// 白名单行豁免——命中 whitelist_patterns 的行不报(修凭据类误报:
|
|
69
|
-
// GM_cookie API 名 / o.cookie 属性 / "Cookie=" 字符串字面量 / gbCookie 字段名
|
|
70
|
-
// 都不是硬编码凭据值,正则只看文本无法区分「引用」与「赋值」)
|
|
71
|
-
const whitelist = (rule.whitelistPatterns || []).map((w) => new RegExp(w));
|
|
72
|
-
// 正则初筛 → token 级精筛(规则声明 astConfirm: true 时启用)。
|
|
73
|
-
// 正则只负责快速筛出候选行,无法区分「代码」与「注释/字符串」;对候选行再做
|
|
74
|
-
// token 判定(lib/ast/code-lines.js 的 makeCodeLineFilter)确认是否真在代码里,
|
|
75
|
-
// 消除「注释里的版本号/日期」「CSS 字号/字符串里的数字」这类误报。
|
|
76
|
-
const candidates = [];
|
|
77
|
-
if (rule.astConfirm) {
|
|
78
|
-
for (let i = 0; i < lines.length; i++) {
|
|
79
|
-
const line = lines[i];
|
|
80
|
-
if (!line) continue;
|
|
81
|
-
if (whitelist.length && whitelist.some((w) => w.test(line))) continue;
|
|
82
|
-
if (patterns.some((p) => { p.lastIndex = 0; return p.test(line); })) candidates.push(i + 1);
|
|
83
|
-
}
|
|
84
|
-
}
|
|
85
|
-
const codeFilter = rule.astConfirm ? makeCodeSpanFilter(text, candidates, { file }) : null;
|
|
86
|
-
// 注释内命中一律丢弃(懒构建:只有真出现命中才 tokenize 一趟)。
|
|
87
|
-
// 背景:规则匹配到**注释里**的示例/说明文字是最常见的纯误报形态
|
|
88
|
-
// (实测:URL 判定谓词的注释里写着 fetch('vfs://…'),被 timeout 规则当成真实外呼)。
|
|
89
|
-
// 只剔注释、不剔字符串:paths/凭据类规则的命中本来就写在字符串字面量里。
|
|
90
|
-
// 注释类规则(comment/*、documentation/*、comment-density、no-date-in-comment 等)不适用。
|
|
91
|
-
const COMMENT_TARGET_RULE = /^(comment|documentation)\/|comment-(density|suspicious)|no-date-in-comment|context-todo/;
|
|
92
|
-
const skipCommentHits = !COMMENT_TARGET_RULE.test(String(rule.id || ''));
|
|
93
|
-
let commentFilter = null;
|
|
94
|
-
const inComment = (line, col) => {
|
|
95
|
-
if (!skipCommentHits) return false;
|
|
96
|
-
// 注意:候选行必须给**全部行**,不能复用本规则的 candidates ——
|
|
97
|
-
// makeCodeLineFilter 的 isCode 只对传入候选行成立,命中行若不在集合里会返回 false,
|
|
98
|
-
// 于是「代码里的真实命中」被当成「注释内」误杀(实测:硬编码密码 blocker 直接消失)。
|
|
99
|
-
if (!commentFilter) commentFilter = makeCodeSpanFilter(text, lines.map((_, k) => k + 1), { file, onlyComment: true });
|
|
100
|
-
return !commentFilter.isCodeHit(line, col);
|
|
101
|
-
};
|
|
102
|
-
// readability/magic-number(唯一声明 astConfirm: magic-number 的规则)已合并进
|
|
103
|
-
// magic-number-smart;本分支保留机制(自定义规则包可复用),当前无内置规则消费。
|
|
104
|
-
const magicSmartLines = rule.astConfirm === 'magic-number' ? smartHitLines(text) : null;
|
|
105
|
-
// 具名精筛 astConfirmKind —— 规则声明「命中后还要 AST 确认什么」。
|
|
106
|
-
// 两种语义:deny = 集合内的行豁免(如 small-file-read 的受控小文件);
|
|
107
|
-
// allow = 只有集合内的行才报(如 short-func-name 的 token 级短名判定)。
|
|
108
|
-
let kindFilter = null;
|
|
109
|
-
if (rule.astConfirmKind === 'small-file-read') kindFilter = { mode: 'deny', lines: smallFileReadLines(text) };
|
|
110
|
-
// CLI console.log(JSON.stringify(大对象)) 一次性输出行豁免(memory-bomb json-stringify-large)
|
|
111
|
-
else if (rule.astConfirmKind === 'console-log-json') kindFilter = { mode: 'deny', lines: consoleLogJsonLines(text) };
|
|
112
|
-
else if (rule.astConfirmKind === 'short-func-name') kindFilter = { mode: 'allow', lines: shortFuncNameLines(text, treeConfirm?.tree || null) };
|
|
113
|
-
else if (rule.astConfirmKind === 'credential-value') kindFilter = { mode: 'allow', lines: credentialValueLines(text, treeConfirm?.tree || null) };
|
|
114
|
-
// 前缀型密钥串(ghp_/sk-/AKIA)的占位符精筛:命中行是「演示值/占位文案」时豁免
|
|
115
|
-
else if (rule.astConfirmKind === 'placeholder-credential') kindFilter = { mode: 'deny', lines: placeholderCredentialLines(text, file) };
|
|
116
|
-
// shell 健壮性精筛(folder/cd-to-maybe-missing:cd 到动态路径且无兜底)
|
|
117
|
-
else if (rule.astConfirmKind === 'shell-cd-dynamic') kindFilter = { mode: 'allow', lines: shellCdDynamicLines(text) };
|
|
118
|
-
// 目录健壮性精筛(folder/write-into-gitignored-dir:写目标命中 .gitignore,需 repoPath 上下文)
|
|
119
|
-
else if (rule.astConfirmKind === 'write-into-gitignored') kindFilter = { mode: 'allow', lines: writeIntoGitignoredLines(text, repoPath) };
|
|
120
|
-
// 硬编码绝对路径精筛(paths/hardcoded-absolute-path):正则初筛形状,精筛判「本机是否可访问」
|
|
121
|
-
// 并换算相对路径(基准 = 文件所在目录)。可访问 ⇒ message 附相对路径;不可访问 ⇒ 仅警告。
|
|
122
|
-
else if (rule.astConfirmKind === 'hardcoded-abs-path') kindFilter = { mode: 'allow', lines: hardcodedAbsPathLines(text, file, repoPath), detail: hardcodedAbsPathDetail(text, file, repoPath) };
|
|
123
|
-
// I/O 风险——正则只做初筛(注释/字符串里的 fs 示例会被命中),
|
|
124
|
-
// 由 AST 确认真实调用行,未确认的行不报
|
|
125
|
-
else if (rule.astConfirmKind === 'io-risk') kindFilter = { mode: 'allow', lines: ioRiskLines(text), detail: ioRiskDetail(text) };
|
|
126
|
-
// 性能反模式:循环体内做全量集合物化(`Array.from(x.values())` 在 for/while/forEach 里)——
|
|
127
|
-
// allow 语义:只有落在循环体内的命中才报(循环外做一次完全正常,不得误报)
|
|
128
|
-
else if (rule.astConfirmKind === 'loop-full-collection') kindFilter = { mode: 'allow', lines: loopFullCollectionLines(text) };
|
|
129
|
-
// 性能反模式:同一循环体内重复调用同一函数(实参完全相同)→ 若为纯函数可记忆化/提前计算
|
|
130
|
-
else if (rule.astConfirmKind === 'repeat-identical-call') kindFilter = { mode: 'allow', lines: repeatIdenticalCallLines(text) };
|
|
131
|
-
// 性能反模式(2026-10-12 实战沉淀,每条都验证过「修复前命中、修复后不报」):
|
|
132
|
-
// ① 函数顶层循环里有值 return、循环之后既无 return 也无 throw ⇒ 可能返回 undefined
|
|
133
|
-
// (实战:fetchJsonHeaders 返回 undefined ⇒ 调用方解构崩溃)
|
|
134
|
-
else if (rule.astConfirmKind === 'loop-no-fallback-return') kindFilter = { mode: 'allow', lines: loopNoFallbackReturnLines(text) };
|
|
135
|
-
// ② 循环体内调用「整份重写文件」的函数 ⇒ 每轮重写整份(实战:逐目录写 15–26MB 游戏索引 = 几十 GB)
|
|
136
|
-
// 循环规模静态不可知,故规则本身只作 warning
|
|
137
|
-
else if (rule.astConfirmKind === 'loop-full-rewrite-call') kindFilter = { mode: 'allow', lines: loopFullRewriteCallLines(text) };
|
|
138
|
-
// ③ 成员判定回调(filter/find/some/every)里套 for + === ⇒ O(n×m)(实战:1.03 亿次比较 = 12,784ms)
|
|
139
|
-
else if (rule.astConfirmKind === 'nested-linear-scan') kindFilter = { mode: 'allow', lines: nestedLinearScanLines(text) };
|
|
140
|
-
// ④ async 函数内长同步循环(≥2 个 Sync 调用、无 await 让出点)⇒ 占满事件循环(实战:/api/* 堵死 74 秒)
|
|
141
|
-
else if (rule.astConfirmKind === 'long-sync-loop') kindFilter = { mode: 'allow', lines: longSyncLoopLines(text) };
|
|
142
|
-
for (let i = 0; i < lines.length; i++) {
|
|
143
|
-
const line = lines[i];
|
|
144
|
-
if (!line) continue;
|
|
145
|
-
if (whitelist.length && whitelist.some((w) => w.test(line))) continue; // 白名单整行豁免
|
|
146
|
-
// 精筛优先级:具名 kindFilter(astConfirmKind)比通用 codeFilter 更精确,二者并存时
|
|
147
|
-
// 以 kindFilter 为准 —— 否则会出现「kindFilter 判定这行不是凭据赋值(应拦),
|
|
148
|
-
// 却被 codeFilter 的粗判放行」。实测 README 说明「token 被误报」的文档段落:
|
|
149
|
-
// 行内含 markdown 行内代码,codeFilter 判为「代码行」而放行,而真正做 token 级
|
|
150
|
-
// 判定、明确认定其非凭据赋值的 credential-value 精筛被这层 AND 条件压制。
|
|
151
|
-
const hasKindAllow = kindFilter?.mode === 'allow';
|
|
152
|
-
if (!hasKindAllow) {
|
|
153
|
-
if (codeFilter && !codeFilter.isCode(i + 1)) continue; // 精筛:注释/字符串行不报
|
|
154
|
-
if (magicSmartLines && !magicSmartLines.has(i + 1)) continue; // 值级精筛:非魔数不报
|
|
155
|
-
}
|
|
156
|
-
if (kindFilter?.mode === 'deny' && kindFilter.lines.has(i + 1)) continue; // 命中即豁免(受控小文件等)
|
|
157
|
-
if (hasKindAllow && !kindFilter.lines.has(i + 1)) continue; // 仅白名单行可报(token 级精筛)
|
|
158
|
-
for (let j = 0; j < patterns.length; j++) {
|
|
159
|
-
const p = patterns[j];
|
|
160
|
-
p.lastIndex = 0;
|
|
161
|
-
const m = line ? p.exec(line) : null;
|
|
162
|
-
if (m) {
|
|
163
|
-
// 列级/语法级精筛(**按规则 opt-in**:rule.astConfirmSpan === true)。
|
|
164
|
-
// ① 优先**语法树**:编排层已(异步)预解析本文件并传入同步确认函数 treeConfirm ✓
|
|
165
|
-
// —— verdict === false ⇒ 命中处是不透明构造(字符串/注释/模板)⇒ 丢弃;
|
|
166
|
-
// verdict === true ⇒ 真代码 ⇒ 放行(不再看 ②);
|
|
167
|
-
// verdict === null ⇒ 无法判定(无语法/解析失败)⇒ 回退 ②
|
|
168
|
-
// ② 回退 **token 级列级判定**(2.8.9 实现):命中列落在字符串/注释区间内 ⇒ 丢弃
|
|
169
|
-
// 为什么必须 opt-in、且绝不覆盖 kindFilter(allow):硬编码路径/凭据类规则的命中
|
|
170
|
-
// 本来就写在字符串里(实测:无条件开启会让 paths/hardcoded-absolute-path 从 5 条掉到 0 条 ✗)
|
|
171
|
-
// 注释内命中:丢弃(见上方 skipCommentHits 说明)
|
|
172
|
-
if (inComment(i + 1, m.index + 1)) continue;
|
|
173
|
-
if (rule.astConfirmSpan === true && !hasKindAllow) {
|
|
174
|
-
const verdict = typeof treeConfirm === 'function' ? treeConfirm(i + 1, m.index + 1) : null;
|
|
175
|
-
if (verdict === false) continue;
|
|
176
|
-
if (verdict !== true && codeFilter?.isCodeHit && !codeFilter.isCodeHit(i + 1, m.index + 1)) continue;
|
|
177
|
-
}
|
|
178
|
-
// I/O 风险:message 用 AST 的分级详情(四级徽标 + 上下文 + 理由),
|
|
179
|
-
// 否则只剩 yml 的 description,看不出这条是高还是低(正则路径特性)
|
|
180
|
-
const ioHit = rule.astConfirmKind === 'io-risk' ? kindFilter?.detail?.get(i + 1) : null;
|
|
181
|
-
const ioMsg = ioHit
|
|
182
|
-
? `${RISK_BADGE[ioHit.risk]} ${RISK_LABEL[ioHit.risk]}风险:${ioHit.call}(${ioHit.type}/${ioHit.kind})——${ioHit.reason}`
|
|
183
|
-
: null;
|
|
184
|
-
// 硬编码绝对路径:message 用精筛详情(可访问 ⇒ 附相对路径;不可访问 ⇒ 仅警告),
|
|
185
|
-
// 否则只剩 yml 的通用 description,看不到"改成什么"。
|
|
186
|
-
const hcHit = rule.astConfirmKind === 'hardcoded-abs-path' ? kindFilter?.detail?.get(i + 1) : null;
|
|
187
|
-
const hcMsg = hcHit ? describeHardcodedAbsPath(hcHit) : null;
|
|
188
|
-
// I/O 分级:低风险(启动路径上的一次性同步 I/O)性质上是**提示**,
|
|
189
|
-
// 不是「代码质量缺陷」—— 它不影响并发、不随数据量放大。此前 severity
|
|
190
|
-
// 一律取规则级 warning,导致 173 条 io-risk 里 161 条纯提示全按 warning
|
|
191
|
-
// 展示,把真实高危淹没在噪声里(scoreImpact 已先行降为 0,此处补齐 severity,
|
|
192
|
-
// 使「展示口径」与「计分口径」一致:info 即不计分)。
|
|
193
|
-
const ioSev = rule.astConfirmKind === 'io-risk' && ioHit
|
|
194
|
-
&& (ioHit.risk === 'low' || ioHit.risk === 'safe') ? 'info' : null;
|
|
195
|
-
// 文档类文件降级:文档里写路径示例是**说明内容**,不是可执行代码里的坏路径。
|
|
196
|
-
// 规则本体是 blocker(拦真代码里的硬编码),文档统一降 warning 保留可见性。
|
|
197
|
-
const docDowngrade = rule.astConfirmKind === 'hardcoded-abs-path'
|
|
198
|
-
&& (/\.(md|markdown|mdx|txt|rst|adoc)$/i.test(String(file || ''))
|
|
199
|
-
|| /(^|\/)docs?\//i.test(String(file || ''))) ? 'warning' : null;
|
|
200
|
-
findings.push(makeFinding({
|
|
201
|
-
file, line: i + 1, rule: rule.id, kind: rule.kind,
|
|
202
|
-
severity: ioSev || docDowngrade || (rule.level === 'blocker' ? 'blocker' : rule.severity),
|
|
203
|
-
// I/O 分级 > 子模式专属 > 规则级
|
|
204
|
-
message: ioMsg || hcMsg || subs?.[j]?.message || rule.message || rule.name,
|
|
205
|
-
dimensions: rule.dimensions,
|
|
206
|
-
exemptHint: pickExemptHint(rule),
|
|
207
|
-
// I/O 分级:按风险等级定计分影响——低风险(启动路径一次性读取)
|
|
208
|
-
// 规则自身已注明「可豁免」,再按满分扣分属口径自相矛盾,
|
|
209
|
-
// 故降为 0(保留 finding 作提醒,不计入评分维度)
|
|
210
|
-
scoreImpact: rule.astConfirmKind === 'io-risk'
|
|
211
|
-
? (ioHit?.risk === 'low' || ioHit?.risk === 'safe' ? 0
|
|
212
|
-
: (ioHit?.risk === 'high' ? 2 : 1))
|
|
213
|
-
: (rule.level === 'blocker' ? 2 : (rule.severity === 'info' ? 0 : 1)), // info 级=建议/核对提示(版本表每行核对等),不扣分(countByDimension 跳过 scoreImpact 0)
|
|
214
|
-
}));
|
|
215
|
-
break; // 同规则一行只报一次
|
|
216
|
-
}
|
|
217
|
-
}
|
|
218
|
-
}
|
|
219
|
-
}
|
|
220
|
-
return findings;
|
|
221
|
-
}
|
|
222
|
-
|
|
223
|
-
/** 检查 path-regex 型规则(对文件路径校验)。 */
|
|
224
|
-
export function checkPathRegexRules({ file, relPath, rules }) {
|
|
225
|
-
const findings = [];
|
|
226
|
-
for (const rule of rules || []) {
|
|
227
|
-
const re = rule.pathPattern ? new RegExp(rule.pathPattern) : null;
|
|
228
|
-
if (re && re.test(relPath)) {
|
|
229
|
-
findings.push(makeFinding({
|
|
230
|
-
file, line: 1, rule: rule.id, kind: 'path-regex',
|
|
231
|
-
severity: rule.level === 'blocker' ? 'blocker' : rule.severity,
|
|
232
|
-
message: `${rule.message || rule.name}(命中路径 ${relPath})`,
|
|
233
|
-
dimensions: rule.dimensions,
|
|
234
|
-
exemptHint: 'dsh-skip-sensitive(文件头=整文件)',
|
|
235
|
-
scoreImpact: rule.level === 'blocker' ? 2 : 1,
|
|
236
|
-
}));
|
|
237
|
-
}
|
|
238
|
-
}
|
|
239
|
-
return findings;
|
|
240
|
-
}
|
|
241
|
-
|
|
242
|
-
/**
|
|
243
|
-
* 注释措辞黑名单检查(comment-wording)。
|
|
244
|
-
* 两种模式(约定:关键词取消分数制):
|
|
245
|
-
* - blocker 模式(规则 severity=blocker):白名单命中 → 该行豁免不拦截;黑名单任一命中 → 直接 blocker。
|
|
246
|
-
* 不再计分/不再累计阈值——白名单放行、黑名单拦截,二值判定。
|
|
247
|
-
* - 普通模式(其余规则):保留历史分数制(blacklist 加分 + whitelist 减分 + additional_features 加分,
|
|
248
|
-
* 单行超阈值报 warning/notice)。
|
|
249
|
-
*/
|
|
250
|
-
export function checkBlacklist({ file, text, rules }) {
|
|
251
|
-
const findings = [];
|
|
252
|
-
const lines = text.split('\n');
|
|
253
|
-
for (const rule of rules || []) {
|
|
254
|
-
const black = (rule.blacklist || []).map((b) => ({ re: safeRe(b.pattern, rule.name || rule.id), weight: Number(b.weight) || 0, pattern: b.pattern }))
|
|
255
|
-
.filter((b) => b.re);
|
|
256
|
-
const white = (rule.whitelist || []).map((w) => ({ re: safeRe(w.pattern, rule.name || rule.id), penalty: Number(w.penalty) || 0 }))
|
|
257
|
-
.filter((w) => w.re);
|
|
258
|
-
const feats = (rule.additionalFeatures || []).map((a) => ({ re: safeRe(a.pattern, rule.name || rule.id), weight: Number(a.weight) || 0 }))
|
|
259
|
-
.filter((a) => a.re);
|
|
260
|
-
const threshold = Number(rule.threshold) || DEFAULT_REGEX_THRESHOLD;
|
|
261
|
-
|
|
262
|
-
// —— blocker 模式:白名单豁免 + 黑名单直拦(取消分数制)——
|
|
263
|
-
if (rule.severity === 'blocker') {
|
|
264
|
-
lines.forEach((line, idx) => {
|
|
265
|
-
if (white.some((w) => w.re.test(line))) return; // 白名单命中 → 整行豁免
|
|
266
|
-
const hit = black.find((b) => b.re.test(line));
|
|
267
|
-
if (!hit) return;
|
|
268
|
-
findings.push(makeFinding({
|
|
269
|
-
file, line: idx + 1, rule: rule.id, kind: 'blacklist',
|
|
270
|
-
severity: 'blocker',
|
|
271
|
-
message: `${rule.name || rule.id}(命中黑名单词「${hit.pattern}」)`,
|
|
272
|
-
dimensions: rule.dimensions || ['文档'],
|
|
273
|
-
exemptHint: 'dsh-skip-quality(文件头=整文件)',
|
|
274
|
-
scoreImpact: 2,
|
|
275
|
-
}));
|
|
276
|
-
});
|
|
277
|
-
continue;
|
|
278
|
-
}
|
|
279
|
-
|
|
280
|
-
// —— 普通模式:历史分数制 ——
|
|
281
|
-
lines.forEach((line, idx) => {
|
|
282
|
-
let score = 0;
|
|
283
|
-
for (const b of black) if (b.re.test(line)) score += b.weight;
|
|
284
|
-
for (const wEntry of white) if (wEntry.re.test(line)) score -= wEntry.penalty;
|
|
285
|
-
for (const f of feats) if (f.re.test(line)) score += f.weight;
|
|
286
|
-
if (score < threshold) return;
|
|
287
|
-
findings.push(makeFinding({
|
|
288
|
-
file, line: idx + 1, rule: rule.id, kind: 'blacklist',
|
|
289
|
-
severity: capSeverity(rule.severity || 'warning', 'warning'),
|
|
290
|
-
message: `${rule.name || rule.id}(措辞分 ${score} ≥ ${threshold})`,
|
|
291
|
-
dimensions: rule.dimensions || ['文档'],
|
|
292
|
-
exemptHint: 'dsh-skip-quality(文件头=整文件)',
|
|
293
|
-
scoreImpact: 1,
|
|
294
|
-
}));
|
|
295
|
-
});
|
|
296
|
-
}
|
|
297
|
-
return findings;
|
|
298
|
-
}
|
|
@@ -1,68 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 检查层 · 拼接产物作用域撞名(kind = scope-collision)
|
|
3
|
-
*
|
|
4
|
-
* 判定在 `lib/ast/scope-collisions.js`(token 级、按真实作用域帧),契约在
|
|
5
|
-
* `lib/audit/scope-policy.js`(按**被审项目自己**的 package.json 取)。
|
|
6
|
-
*
|
|
7
|
-
* 两类命中,严重度口径**故意不同**:
|
|
8
|
-
* ① 同帧重名(任何 js 文件都查)——分两档,避免把合法写法拦成 blocker:
|
|
9
|
-
* · 两次都是 var:同一声明的重复写入(后一次等价赋值),运行时无害 → warning;
|
|
10
|
-
* · 含 function / class / const / let:后声明真的顶掉前者,或拼接后整份产物
|
|
11
|
-
* 直接 SyntaxError → 跟随规则声明(yml `severity: error` ⇒ blocker 拦截提交)。
|
|
12
|
-
* ② 前缀 / 顶层零声明(**只对项目自己声明的产物文件**生效)——契约类问题,
|
|
13
|
-
* 一律 capSeverity 到 warning:绝不因为别人的风格约定拦下提交。
|
|
14
|
-
*
|
|
15
|
-
* 为什么契约必须以「项目自己声明」为准:规则包是**跨仓库共享**的(同一份 yml 审计所有仓库)。
|
|
16
|
-
* 把 dshgp_ 写进 yml,会给所有被审项目刷出「缺少 dshgp_ 前缀」,
|
|
17
|
-
* 把真正的同帧重名淹掉。项目没声明 dshScopeCheck ⇒ 这里只做通用项(同帧重名)。
|
|
18
|
-
*
|
|
19
|
-
* 豁免:空 rules 短路(规则被 exts/exclude_paths/file_patterns 过滤空时,
|
|
20
|
-
* 防止读 rule.severity 抛错——与 structural.js 各检查器同款守卫)。
|
|
21
|
-
*/
|
|
22
|
-
|
|
23
|
-
import { makeFinding } from '../audit/index.js';
|
|
24
|
-
import { readProjectScopePolicy } from '../audit/scope-policy.js';
|
|
25
|
-
import { analyzeScopeCollisions } from '../ast/index.js';
|
|
26
|
-
import { HINT_QUALITY, capSeverity } from './common.js';
|
|
27
|
-
|
|
28
|
-
/**
|
|
29
|
-
* @param {object} ctx { file(绝对路径), relPath, text, rules }
|
|
30
|
-
* @returns {Array} findings
|
|
31
|
-
*/
|
|
32
|
-
export function checkScopeCollision({ file, text, rules }) {
|
|
33
|
-
const findings = [];
|
|
34
|
-
const rule = (rules || [])[0];
|
|
35
|
-
if (!rule) return findings;
|
|
36
|
-
|
|
37
|
-
const project = readProjectScopePolicy(file);
|
|
38
|
-
// 全仓扫描口径:必须严格命中项目声明的 files 清单,不能「没清单就都算产物」
|
|
39
|
-
const enforceContract = project.declared && project.isDeclaredArtifact;
|
|
40
|
-
const result = analyzeScopeCollisions(String(text || ''), {
|
|
41
|
-
prefix: enforceContract ? project.prefix : '',
|
|
42
|
-
allowlist: enforceContract ? project.allowlist : [],
|
|
43
|
-
topLevelMustBeEmpty: enforceContract ? project.topLevelMustBeEmpty : false,
|
|
44
|
-
});
|
|
45
|
-
|
|
46
|
-
const ruleId = rule.id || 'dsh/scope-collision';
|
|
47
|
-
const dimensions = rule.dimensions || ['健壮性'];
|
|
48
|
-
const base = { file, rule: ruleId, kind: 'scope-collision', dimensions, exemptHint: HINT_QUALITY, scoreImpact: 1 };
|
|
49
|
-
// 契约类(前缀 / 顶层零声明)与「纯 var 重声明」最高只到 warning
|
|
50
|
-
const softSeverity = capSeverity(rule.severity || 'warning', 'warning');
|
|
51
|
-
// ① 同帧重名:严重度按**命中性质**分档,避免把合法写法拦成 blocker
|
|
52
|
-
// · 两次都是 var ⇒ 同一声明的重复写入(后一次等价赋值),运行时无害 → warning
|
|
53
|
-
// · 含 function / class / const / let ⇒ 后声明真的顶掉前者,或拼接后整份产物
|
|
54
|
-
// 直接 SyntaxError(命名冲突)→ 按规则声明的严重度(error ⇒ blocker)
|
|
55
|
-
const hardSeverity = rule.level === 'blocker' ? 'blocker' : capSeverity(rule.severity || 'warning', 'warning');
|
|
56
|
-
for (const hit of result.duplicates) {
|
|
57
|
-
const varOnly = Array.isArray(hit.keywords) && hit.keywords.every((kw) => kw === 'var');
|
|
58
|
-
findings.push(makeFinding({ ...base, line: hit.line, severity: varOnly ? softSeverity : hardSeverity, message: hit.message }));
|
|
59
|
-
}
|
|
60
|
-
// ② 契约类(项目自选):恒为 warning
|
|
61
|
-
for (const hit of result.topLevel) {
|
|
62
|
-
findings.push(makeFinding({ ...base, line: hit.line, severity: softSeverity, message: hit.message }));
|
|
63
|
-
}
|
|
64
|
-
for (const hit of result.missingPrefix) {
|
|
65
|
-
findings.push(makeFinding({ ...base, line: hit.line, severity: softSeverity, message: hit.message }));
|
|
66
|
-
}
|
|
67
|
-
return findings;
|
|
68
|
-
}
|
package/lib/checks/semantic.js
DELETED
|
@@ -1,134 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 检查层 · 语义类规则
|
|
3
|
-
*
|
|
4
|
-
* 职责:由规则 yml 声明的语义检查(如 patch insert 语义、仓库级语义规则)。
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
import { makeFinding, CODE_EXTS } from '../audit/index.js';
|
|
8
|
-
import { HINT_QUALITY } from './common.js';
|
|
9
|
-
|
|
10
|
-
/** 顶层 `- id:` 行(缩进 0 的覆盖),或缩进 1 的 insert 块内列表项。 */
|
|
11
|
-
const ID_TOP_RE = /^- id:\s*["']?([^"'\s]+)["']?\s*$/;
|
|
12
|
-
const ID_INDENT_RE = /^\s+- id:\s*["']?([^"'\s]+)["']?\s*$/;
|
|
13
|
-
|
|
14
|
-
/** 检查语义规则(semantic:占位消费——无静态可判定性时按路径/命名提示,不做臆测)。 */
|
|
15
|
-
/**
|
|
16
|
-
* semantic 占位规则检查:无法自动判定、需人工确认的规则(安全/a11y/dependency 类)。
|
|
17
|
-
*
|
|
18
|
-
* 语义(修):
|
|
19
|
-
* ① 只对**代码文件**生效——.gitignore/README/yml/json 没有「用户输入路径/依赖/按钮」
|
|
20
|
-
* 可判定语义,逐文件报属纯噪音。
|
|
21
|
-
* ② **仓库级规则只报一次**——npm audit(dependency/known-vulnerability)、
|
|
22
|
-
* 路径穿越人工核查(security/no-path-traversal)、a11y(button/label)都是
|
|
23
|
-
* 「整个仓库」的属性,不是「某个文件」的属性。逐文件报会在 4 个文件上产出
|
|
24
|
-
* 16 条同义提示(4 文件 × 4 规则),把真实问题淹没。
|
|
25
|
-
* 判定依据:规则只声明 name/description、**无任何可执行字段**(无 pattern/
|
|
26
|
-
* threshold/kind/detection)→ 本 engine 无法评估,交人工按仓库维度核查一次。
|
|
27
|
-
* 多文件时报在**文件路径字典序最小**的那个文件上(稳定可复现),其余文件静默。
|
|
28
|
-
* ③ 单文件审计(如 diff 范围的末尾批次)拿不到全仓列表时退回逐文件提示,
|
|
29
|
-
* 由调用方(auditFull/auditChanged)传 repoLevel 去重,保证不丢提示。
|
|
30
|
-
*
|
|
31
|
-
* @param {object} args { file, relPath, rules, repoLevelRules? }
|
|
32
|
-
* repoLevelRules:调用方判定为「仓库级、已报过」的规则 id 集合(Set),命中则跳过。
|
|
33
|
-
* @returns {Array} findings
|
|
34
|
-
*/
|
|
35
|
-
export function checkSemantic({ file, relPath, rules, repoLevelRules }) {
|
|
36
|
-
const findings = [];
|
|
37
|
-
const target = String(relPath || file || '');
|
|
38
|
-
// ① 非代码文件没有可判定的语义对象
|
|
39
|
-
const ext = target.split('.').pop().toLowerCase();
|
|
40
|
-
if (!CODE_EXTS.has(ext)) return findings;
|
|
41
|
-
for (const rule of rules || []) {
|
|
42
|
-
// 文件系统上下文类:期望存在同名 test 文件 / 语言包文件(engine 无法读目录时跳过,交调用方仓库级处理)
|
|
43
|
-
if (rule.detectionMethod === 'test-file-exists' || /test-file/i.test(rule.id || '')
|
|
44
|
-
|| rule.detectionMethod === 'locale-file-exists' || /locale-file/i.test(rule.id || '')) {
|
|
45
|
-
continue; // 需文件系统上下文,由 auditFull 层处理(避免此处臆测)
|
|
46
|
-
}
|
|
47
|
-
// ② 仓库级规则已报过 → 本文件不再重复
|
|
48
|
-
if (repoLevelRules && repoLevelRules.has(rule.id)) continue;
|
|
49
|
-
findings.push(makeFinding({
|
|
50
|
-
file, line: 1, rule: rule.id, kind: 'semantic',
|
|
51
|
-
severity: 'notice',
|
|
52
|
-
message: rule.message || rule.name || '语义规则提示(需人工确认)',
|
|
53
|
-
dimensions: rule.dimensions || ['健壮性'],
|
|
54
|
-
exemptHint: HINT_QUALITY,
|
|
55
|
-
scoreImpact: 0,
|
|
56
|
-
}));
|
|
57
|
-
}
|
|
58
|
-
return findings;
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
/**
|
|
62
|
-
* 判定规则是否为「仓库级语义占位」——无任何可执行检测字段、需人工按仓库维度核查。
|
|
63
|
-
* 这类规则只应报一次(否则每文件一条同义提示)。
|
|
64
|
-
* 判定:semantic kind 且既无 pattern(s)、无 threshold / min 长度 / max 深度等数值字段、
|
|
65
|
-
* 无 detectionMethod、无 blacklist/whitelist 等清单字段。
|
|
66
|
-
* @param {object} rule 编译后规则对象
|
|
67
|
-
* @returns {boolean}
|
|
68
|
-
*/
|
|
69
|
-
export function isRepoLevelSemanticRule(rule) {
|
|
70
|
-
if (!rule || rule.kind !== 'semantic') return false;
|
|
71
|
-
if (rule.detectionMethod) return false;
|
|
72
|
-
const hasPattern = rule.pattern !== undefined || (Array.isArray(rule.patterns) && rule.patterns.length > 0);
|
|
73
|
-
const numericFields = ['threshold', 'minLength', 'maxDepth', 'maxLines', 'maxComplexity', 'minOccurrences', 'minLines'];
|
|
74
|
-
const hasNumeric = numericFields.some((k) => rule[k] !== undefined && rule[k] !== null);
|
|
75
|
-
const listFields = ['blacklist', 'whitelist', 'additionalFeatures', 'requiredPatterns'];
|
|
76
|
-
const hasList = listFields.some((k) => Array.isArray(rule[k]) && rule[k].length > 0);
|
|
77
|
-
return !hasPattern && !hasNumeric && !hasList;
|
|
78
|
-
}
|
|
79
|
-
|
|
80
|
-
/**
|
|
81
|
-
* cordis.patch.yml insert 语义检查(patch-insert kind)。
|
|
82
|
-
* 旧实现是 regex「命中 insert: 行即提示」——纯 insert(只新建、不覆盖任何行)
|
|
83
|
-
* 也会被报,如 dsh-skill-scoreboard 的 patch(insert 新建 skill-scoreboard loader,
|
|
84
|
-
* 基座没有同名行可覆盖)被误报成 duplicate-id 风险。
|
|
85
|
-
* 语义判定:解析 yml 文本——
|
|
86
|
-
* 1) insert 块(`- insert:` 后缩进列表)内的 id 集合
|
|
87
|
-
* 2) 顶层(缩进 0)`- id:` 覆盖行的 id 集合
|
|
88
|
-
* 3) 仅当两集合有交集(insert 新建的 id 与按 id 覆盖行同 id)才报 duplicate-id 双挂风险
|
|
89
|
-
* 纯 insert 或 id 无交集 → 不报。
|
|
90
|
-
* @param {object} p { file, text, rules } rules=编译后的 patch-insert 规则
|
|
91
|
-
* @returns {Array} findings
|
|
92
|
-
*/
|
|
93
|
-
export function checkPatchInsert({ file, text, rules }) {
|
|
94
|
-
const findings = [];
|
|
95
|
-
const lines = String(text || '').split('\n');
|
|
96
|
-
const insertIds = []; // { id, line }
|
|
97
|
-
const overrideIds = []; // { id, line }
|
|
98
|
-
let inInsert = false;
|
|
99
|
-
for (let i = 0; i < lines.length; i++) {
|
|
100
|
-
const raw = lines[i];
|
|
101
|
-
const t = raw.trim();
|
|
102
|
-
if (!t || t.startsWith('#')) continue; // 空行/注释(README 对照示例多为注释,不算)
|
|
103
|
-
if (ID_TOP_RE.test(t) && /^- id:/.test(raw)) {
|
|
104
|
-
// 缩进 0 的 - id 行 = 顶层覆盖已有 loader 行(无论当前是否在 insert 块内,都终结 insert 块)
|
|
105
|
-
const id = t.match(ID_TOP_RE)[1];
|
|
106
|
-
overrideIds.push({ id, line: i + 1 });
|
|
107
|
-
inInsert = false;
|
|
108
|
-
continue;
|
|
109
|
-
}
|
|
110
|
-
if (inInsert && ID_INDENT_RE.test(raw)) {
|
|
111
|
-
const id = raw.trim().match(ID_TOP_RE)[1];
|
|
112
|
-
insertIds.push({ id, line: i + 1 });
|
|
113
|
-
continue;
|
|
114
|
-
}
|
|
115
|
-
if (/^- insert:\s*$/.test(t)) { inInsert = true; continue; }
|
|
116
|
-
// 离开 insert 块:insert 块内列表项以缩进(空格开头)为特征;缩进 0 的非 insert 行结束块
|
|
117
|
-
if (inInsert && !/^\s/.test(raw)) inInsert = false;
|
|
118
|
-
}
|
|
119
|
-
for (const rule of rules || []) {
|
|
120
|
-
for (const ins of insertIds) {
|
|
121
|
-
if (overrideIds.some((o) => o.id === ins.id)) {
|
|
122
|
-
findings.push(makeFinding({
|
|
123
|
-
file, line: ins.line, rule: rule.id, kind: 'patch-insert',
|
|
124
|
-
severity: rule.level === 'blocker' ? 'blocker' : rule.severity || 'warning',
|
|
125
|
-
message: `${rule.message || rule.name}(insert 新建 id「${ins.id}」与顶层覆盖行同 id,会 duplicate-id 双挂)`,
|
|
126
|
-
dimensions: rule.dimensions || ['健壮性'],
|
|
127
|
-
exemptHint: HINT_QUALITY,
|
|
128
|
-
scoreImpact: 1,
|
|
129
|
-
}));
|
|
130
|
-
}
|
|
131
|
-
}
|
|
132
|
-
}
|
|
133
|
-
return findings;
|
|
134
|
-
}
|