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/rule/scope.js
DELETED
|
@@ -1,67 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 审计作用域判断 · 机制层(方案 Step 3)
|
|
3
|
-
*
|
|
4
|
-
* 目标:让规则知道「这段代码在什么作用域/路径上」,从“看代码长什么样”升级到
|
|
5
|
-
* “理解代码在干什么”——误报率从 ~97%(io-risk 实测 2/65 真警告)往 ~15% 收敛。
|
|
6
|
-
*
|
|
7
|
-
* 本文件只做机制(声明 + 解析),不判断任何具体作用域:
|
|
8
|
-
* - normalizeScopeRules:编译期把规则 yml 的 scope_rules 规范成 rule.scopeRules 数组
|
|
9
|
-
* - resolveScopeAction:执行期按运行时填充的 scopeInfo(path/lexical/effective)取 action
|
|
10
|
-
*
|
|
11
|
-
* 作用域命名空间(规则 yml 里 scope 字段可用的值,多值逗号分隔,* 全匹配):
|
|
12
|
-
* - 执行路径:startup / request / background / test / unknown
|
|
13
|
-
* - 词法作用域:global / module / function / block / loop
|
|
14
|
-
* - 功能作用域(闭包双重作用域):public / private / callback
|
|
15
|
-
* action:exempt(豁免)/ block(阻断)/ warn(警告)/ downgrade(降级),缺省 warn。
|
|
16
|
-
* - exempt :命中即**跳过**该命中(不出现在报告里);
|
|
17
|
-
* - block :命中即升级为阻断(用于「这个作用域里这么做是硬错误」);
|
|
18
|
-
* - warn :保持规则自身分级(缺省行为);
|
|
19
|
-
* - downgrade :**仍出现在报告里**,但降为 info 且不扣分——用于「平台/框架约束导致不可避免」
|
|
20
|
-
* 的场景(如 DSH 要求客户端为单文件,该文件必然超长且不可拆分)。
|
|
21
|
-
*
|
|
22
|
-
* 与规则检查器约定(Step 4 起各规则填充):
|
|
23
|
-
* scopeInfo = { path: 'request'|'startup'|..., lexical: 'function'|'loop'|..., effective: 'public'|... }
|
|
24
|
-
* —— rule.scopeRules 命中任一维度值即返回对应 action;无 scope_rules 或未命中 → null(规则默认行为)。
|
|
25
|
-
*/
|
|
26
|
-
|
|
27
|
-
/** 合法 action 白名单(缺省 warn——未知作用域保守提示,不豁免也不阻断)。 */
|
|
28
|
-
export const SCOPE_ACTIONS = ['exempt', 'block', 'warn', 'downgrade'];
|
|
29
|
-
|
|
30
|
-
/**
|
|
31
|
-
* 规范化规则 yml 的 scope_rules 字段(编译期,幂等)。
|
|
32
|
-
* @param {object} rule 编译后的规则对象(yml 字段已透传:rule.scope_rules)
|
|
33
|
-
* @returns {Array<{scope:string, action:string, reason:string, _i:number}>}
|
|
34
|
-
*/
|
|
35
|
-
export function normalizeScopeRules(rule) {
|
|
36
|
-
const raw = rule && (rule.scope_rules || rule.scopeRules);
|
|
37
|
-
if (!Array.isArray(raw)) return [];
|
|
38
|
-
return raw.map((x, i) => ({
|
|
39
|
-
scope: String((x && x.scope) || '').trim(),
|
|
40
|
-
action: SCOPE_ACTIONS.includes(x && x.action) ? x.action : 'warn',
|
|
41
|
-
reason: (x && x.reason) || '',
|
|
42
|
-
_i: i,
|
|
43
|
-
}));
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
/**
|
|
47
|
-
* 执行期:按运行时作用域信息取 action。
|
|
48
|
-
* @param {Array<{scope:string, action:string}>} scopeRules 规范化后的规则作用域规则(rule.scopeRules)
|
|
49
|
-
* @param {object} [scopeInfo] 运行时填充:{ path, lexical, effective }(值即作用域字符串,如 'request')
|
|
50
|
-
* @returns {'exempt'|'block'|'warn'|null} action;无规则/无命中 → null(规则默认行为)
|
|
51
|
-
*/
|
|
52
|
-
export function resolveScopeAction(scopeRules, scopeInfo = {}) {
|
|
53
|
-
if (!Array.isArray(scopeRules) || scopeRules.length === 0) return null;
|
|
54
|
-
for (const sr of scopeRules) {
|
|
55
|
-
const keys = String(sr.scope || '').split(',').map((s) => s.trim()).filter(Boolean);
|
|
56
|
-
if (!keys.length) continue;
|
|
57
|
-
if (keys.includes('*')) return sr.action;
|
|
58
|
-
const hit = keys.some((k) => {
|
|
59
|
-
for (const v of Object.values(scopeInfo)) {
|
|
60
|
-
if (v != null && String(v) === k) return true;
|
|
61
|
-
}
|
|
62
|
-
return false;
|
|
63
|
-
});
|
|
64
|
-
if (hit) return sr.action;
|
|
65
|
-
}
|
|
66
|
-
return null;
|
|
67
|
-
}
|
package/lib/score/docs-score.js
DELETED
|
@@ -1,166 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 文档加分制检查器——文档维度从扣分制改纯加分制(0 分起、上限 10)。
|
|
3
|
-
*
|
|
4
|
-
* 原则(需求讨论 DeepSeekHarness/文档加分制.md + docs/方案-文档维度加分制.md):
|
|
5
|
-
* · 只奖励「做了」(结构信号 + 交叉验证),不判断「做得好」——内容质量机器判不了
|
|
6
|
-
* · 检查范围=**文档集**:README.md(约定入口)+ docs/ 下递归 .md(排除 node_modules 等)
|
|
7
|
-
* + 根级常见文档名白名单(CHANGELOG/INSTALL/GUIDE/UPGRADING/升级记录/快速开始…)
|
|
8
|
-
* · 版本一致性是唯一硬交叉验证:文档集**任一**版本号 == package.json version
|
|
9
|
-
* (README 里的 Node 18.0.0 等无关版本不会误加)
|
|
10
|
-
* · 多文档版本号互相矛盾(README=1.5.6 vs CHANGELOG=1.5.5):存在性加分照给,
|
|
11
|
-
* 矛盾只进 review(人工复核)**不扣分**——与 version/readme-changelog 口径错开
|
|
12
|
-
* 约束:结果**不进 findings**(不进扣分维度/门禁/问题计数),由 scoreQuality 单独加分。
|
|
13
|
-
*/
|
|
14
|
-
import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
|
|
15
|
-
import { join } from 'node:path';
|
|
16
|
-
|
|
17
|
-
/** 单项文档加分项满分(每题 2.5 分,4 题合计 10 分)。 */
|
|
18
|
-
const DOCS_ITEM_SCORE = 2.5;
|
|
19
|
-
|
|
20
|
-
/** 根级常见文档名白名单(docs/ 之外的「项目文档」识别)。 */
|
|
21
|
-
const ROOT_DOC_NAMES = [
|
|
22
|
-
'CHANGELOG.md', 'INSTALL.md', 'GUIDE.md', 'UPGRADING.md',
|
|
23
|
-
'升级记录.md', '快速开始.md', '安装.md', 'change.log', 'CHANGELOG',
|
|
24
|
-
];
|
|
25
|
-
/** docs/ 遍历时跳过的目录(复用审计收集器语义,不把依赖/夹具文档当项目文档)。 */
|
|
26
|
-
const SKIP_DIRS = new Set(['node_modules', 'vendor', 'test', 'tests', 'dist', 'build', '.git', 'coverage']);
|
|
27
|
-
/** 版本号提取(语义与文档讨论一致:v?x.y.z,任一匹配即可)。 */
|
|
28
|
-
const VERSION_RE = /v?(\d+\.\d+\.\d+)/g;
|
|
29
|
-
/**
|
|
30
|
-
* 「版本记录语境」行:md 标题 / 表格版本列 / version:·版本: 前缀 / CHANGELOG 条目(- 开头)。
|
|
31
|
-
* 用于**不一致检测**——排除正文「Node 18.0.0 支持」这类环境版本(非项目版本口径,
|
|
32
|
-
* 若全提取会频繁误报不一致);加分(存在性)仍用全文提取的宽松集合。
|
|
33
|
-
*/
|
|
34
|
-
const VERSION_RECORD_LINE_RE = /^(#+\s.*v?\d+\.\d+\.\d+|.*\|[^|]*v?\d+\.\d+\.\d+[^|]*\|.*|.*\b(version|版本).{0,4}[::].*v?\d+\.\d+\.\d+.*|[-*]\s+v?\d+\.\d+\.\d+.*)/i;
|
|
35
|
-
/** 安装/启动命令结构信号。 */
|
|
36
|
-
const INSTALL_RE = /npm install|pnpm add|yarn add|docker run|npm run (start|dev|build|serve)/i;
|
|
37
|
-
/** 环境变量清单结构信号。 */
|
|
38
|
-
const ENV_RE = /\.env|process\.env|环境变量/i;
|
|
39
|
-
|
|
40
|
-
/**
|
|
41
|
-
* 收集项目文档集(README + docs/ 下递归 + 根级常见命名),去重、保序。
|
|
42
|
-
* @param {string} root 项目根
|
|
43
|
-
* @returns {string[]} 文档文件绝对路径
|
|
44
|
-
*/
|
|
45
|
-
export function collectDocFiles(root = '.') {
|
|
46
|
-
const out = [];
|
|
47
|
-
const push = (p) => { try { if (existsSync(p) && statSync(p).isFile()) out.push(p); } catch { /* 忽略 */ } };
|
|
48
|
-
// ① README 入口(大小写兼容)
|
|
49
|
-
push(join(root, 'README.md'));
|
|
50
|
-
push(join(root, 'readme.md'));
|
|
51
|
-
// ② docs/ 递归(排除 SKIP_DIRS)
|
|
52
|
-
const docs = join(root, 'docs');
|
|
53
|
-
if (existsSync(docs)) {
|
|
54
|
-
const walk = (dir) => {
|
|
55
|
-
let ents;
|
|
56
|
-
try { ents = readdirSync(dir, { withFileTypes: true }); } catch { return; }
|
|
57
|
-
for (const ent of ents) {
|
|
58
|
-
if (SKIP_DIRS.has(ent.name)) continue;
|
|
59
|
-
const p = join(dir, ent.name);
|
|
60
|
-
if (ent.isDirectory()) walk(p);
|
|
61
|
-
else if (ent.name.endsWith('.md') || ent.name.endsWith('.markdown')) out.push(p);
|
|
62
|
-
}
|
|
63
|
-
};
|
|
64
|
-
walk(docs);
|
|
65
|
-
}
|
|
66
|
-
// ③ 根级常见文档名
|
|
67
|
-
for (const n of ROOT_DOC_NAMES) push(join(root, n));
|
|
68
|
-
return [...new Set(out)];
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
/** 4 项加分项静态定义(配置 yml audit-rules-docs.yml 与这里一一对应,增删改两处)。 */
|
|
72
|
-
export const DOCS_SCORE_ITEMS = [
|
|
73
|
-
{ id: 'readme-exists', name: 'README 存在', score: DOCS_ITEM_SCORE },
|
|
74
|
-
{ id: 'version-consistent', name: '版本号与 package.json 一致', score: DOCS_ITEM_SCORE },
|
|
75
|
-
{ id: 'install-command', name: '有安装/启动命令', score: DOCS_ITEM_SCORE },
|
|
76
|
-
{ id: 'env-list', name: '有环境变量清单', score: DOCS_ITEM_SCORE },
|
|
77
|
-
];
|
|
78
|
-
|
|
79
|
-
/**
|
|
80
|
-
* 对项目根跑文档加分检查。
|
|
81
|
-
* @param {string} root 项目根(审计目标目录;仓库根/快照根均适用)
|
|
82
|
-
* @returns {{hits: string[], review: string[], items: Array<{id,name,score,hit}>, files: string[], versions: string[]}}
|
|
83
|
-
*/
|
|
84
|
-
export function checkDocsScore(root = '.') { // dsh-skip-func-length dsh-skip-complexity: 文档加分判定器(四检查链 + 宿主版本比对多条件,职责单一;53 行/24 复杂度为结构必然)
|
|
85
|
-
const files = collectDocFiles(root);
|
|
86
|
-
// 预读为 Map<path, text>(文档文件数有限,一次性读取;供全部检查复用,
|
|
87
|
-
// 避免宿主比对循环内二次 readFileSync——io-risk 会按「循环内同步读」报中风险)
|
|
88
|
-
const textsByFile = new Map();
|
|
89
|
-
// dsh-skip-residue(io-risk:文档文件数有限,一次性启动读取,非热路径循环)
|
|
90
|
-
for (const f of files) { try { textsByFile.set(f, readFileSync(f, 'utf8')); } catch { /* 读失败跳过 */ } } // dsh-skip-residue(io-risk:文档数有限一次性读取)
|
|
91
|
-
const all = [...textsByFile.values()].join('\n');
|
|
92
|
-
const hits = [];
|
|
93
|
-
const review = [];
|
|
94
|
-
// ① README 存在(约定入口;docs/ 不能替代此项)
|
|
95
|
-
const hasReadme = existsSync(join(root, 'README.md')) || existsSync(join(root, 'readme.md'));
|
|
96
|
-
if (hasReadme) hits.push('readme-exists');
|
|
97
|
-
else if (files.length) review.push('README 缺失(仅有 docs/ 等文档)');
|
|
98
|
-
// ② 版本一致性(交叉验证,最硬):文档集任一版本号 == pkg.version
|
|
99
|
-
let pkgVersion = '';
|
|
100
|
-
try {
|
|
101
|
-
pkgVersion = String(JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')).version || '').trim();
|
|
102
|
-
} catch { /* 无 package.json / 解析失败:版本项跳过,其余照判 */ }
|
|
103
|
-
const versions = [...new Set([...all.matchAll(VERSION_RE)].map((m) => m[1]))];
|
|
104
|
-
if (pkgVersion && versions.includes(pkgVersion)) hits.push('version-consistent');
|
|
105
|
-
// ③ 安装/启动命令
|
|
106
|
-
if (INSTALL_RE.test(all)) hits.push('install-command');
|
|
107
|
-
// ④ 环境变量清单
|
|
108
|
-
if (ENV_RE.test(all)) hits.push('env-list');
|
|
109
|
-
// 多文档口径不一致(存在性加分照给,矛盾只提示不扣分;仅看版本记录语境,排除环境版本)。
|
|
110
|
-
// 修:原「记录语境版本数 >1 就报」误判——CHANGELOG 版本表天然含全部历史版本
|
|
111
|
-
// (几十条)必然 >1,永不消失。现改为:**只比对版本宿主文档**(README 的「(当前)」
|
|
112
|
-
// 标记行 + CHANGELOG/版本表 的最新条目),各宿主声明的当前版本互相矛盾才算不一致。
|
|
113
|
-
// 普通 docs 文档(方案/细则/示例)不参与——其中的版本号是历史引用或 IP/端口示例
|
|
114
|
-
// (如 `127.0.0.1`),不是当前版本声明。
|
|
115
|
-
if (pkgVersion) {
|
|
116
|
-
const hostVersions = new Map(); // 宿主文件 -> 声明的当前版本
|
|
117
|
-
for (const f of files) {
|
|
118
|
-
const isHost = /README\.md$/i.test(f) || /CHANGELOG|版本表|版本记录/i.test(f);
|
|
119
|
-
if (!isHost) continue;
|
|
120
|
-
const text = textsByFile.get(f);
|
|
121
|
-
if (!text) continue;
|
|
122
|
-
// README:优先「(当前)」标记行;CHANGELOG/版本表:取版本表(`| 版本 |`)首条数据行
|
|
123
|
-
const curLine = text.split('\n').find((l) => /\d+\.\d+\.\d+.*(当前)|(当前).*\d+\.\d+\.\d+/.test(l) && VERSION_RECORD_LINE_RE.test(l));
|
|
124
|
-
if (curLine) {
|
|
125
|
-
const vers = [...curLine.matchAll(VERSION_RE)].map((m) => m[1]);
|
|
126
|
-
if (vers.length) hostVersions.set(f, vers[0]);
|
|
127
|
-
continue;
|
|
128
|
-
}
|
|
129
|
-
const recs = [...new Set(
|
|
130
|
-
text.split('\n')
|
|
131
|
-
.filter((line) => VERSION_RECORD_LINE_RE.test(line))
|
|
132
|
-
.flatMap((line) => [...line.matchAll(VERSION_RE)].map((m) => m[1])),
|
|
133
|
-
)];
|
|
134
|
-
if (recs.length) hostVersions.set(f, maxVersion(recs));
|
|
135
|
-
}
|
|
136
|
-
const distinct = [...new Set(hostVersions.values())];
|
|
137
|
-
if (distinct.length > 1) {
|
|
138
|
-
const shown = [...hostVersions.entries()]
|
|
139
|
-
.map(([, v]) => (v === pkgVersion ? `${v}(=pkg)` : v))
|
|
140
|
-
.slice(0, 3).join(' / ');
|
|
141
|
-
review.push(`文档集版本号不一致(${shown}),请人工核对`);
|
|
142
|
-
} else if (!versions.length) {
|
|
143
|
-
review.push('文档集未发现版本号(README/CHANGELOG 等应有版本记录)');
|
|
144
|
-
}
|
|
145
|
-
}
|
|
146
|
-
return {
|
|
147
|
-
hits,
|
|
148
|
-
review,
|
|
149
|
-
files,
|
|
150
|
-
versions,
|
|
151
|
-
items: DOCS_SCORE_ITEMS.map((it) => ({ ...it, hit: hits.includes(it.id) })),
|
|
152
|
-
};
|
|
153
|
-
}
|
|
154
|
-
|
|
155
|
-
/** 取版本号数组里的最大版本(x.y.z 数值比较)。 */
|
|
156
|
-
function maxVersion(list) {
|
|
157
|
-
const cmp = (a, b) => {
|
|
158
|
-
const pa = a.split('.').map(Number);
|
|
159
|
-
const pb = b.split('.').map(Number);
|
|
160
|
-
for (let i = 0; i < 3; i++) {
|
|
161
|
-
if (pa[i] !== pb[i]) return pa[i] - pb[i];
|
|
162
|
-
}
|
|
163
|
-
return 0;
|
|
164
|
-
};
|
|
165
|
-
return [...list].sort(cmp).pop();
|
|
166
|
-
}
|
package/lib/score/index.js
DELETED
|
@@ -1,234 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* dsh-git-push 评分总入口
|
|
3
|
-
*
|
|
4
|
-
* 统一 10 维度加权评分:问题(dimensions) → 分维度计数 → 加权总分。
|
|
5
|
-
* 每个编译函数声明 dimensions 绑定(支持一字段多维度)。
|
|
6
|
-
* 权重沿用 10 维度表(合计 100)。
|
|
7
|
-
*
|
|
8
|
-
* 审计豁免见 .auditignore(本文件是配置数据表,魔数即参数值,不适用魔数类规则)。
|
|
9
|
-
*/
|
|
10
|
-
export const DEFAULT_WEIGHTS = {
|
|
11
|
-
'可读性': 15, '可维护性': 15, '健壮性': 15, '安全性': 18, '性能': 10,
|
|
12
|
-
'测试覆盖': 10, '可观测性': 5, '可部署性': 5, '文档': 4, '开发者体验': 3,
|
|
13
|
-
};
|
|
14
|
-
|
|
15
|
-
/**
|
|
16
|
-
* 每维度对数衰减系数 k(约定:扣分平缓化,线性改对数 + 5 档调 k)。
|
|
17
|
-
* 单维度评分:max(0.1, base - k * ln(1 + errorCount)),base=10。
|
|
18
|
-
* k 按维度重要性分 5 档:安全类衰减最快(k=1.5),文档/开发者体验最宽松(k=0.8)。
|
|
19
|
-
* 比旧版(安全 1.8 / 其余 1.0-1.5)整体调低 0.2-0.3——同样错误数下扣分更温和、不会一下子扣完。
|
|
20
|
-
* 注:10 个维度权重(DEFAULT_WEIGHTS)由侧边栏可调,k 是固定的 5 档衰减系数,两者独立。
|
|
21
|
-
*/
|
|
22
|
-
export const DIMENSION_K = {
|
|
23
|
-
'可读性': 1.3, '可维护性': 1.3, '健壮性': 1.3, '安全性': 1.5, '性能': 1.1,
|
|
24
|
-
'测试覆盖': 1.0, '可观测性': 1.0, '可部署性': 1.0, '文档': 0.8, '开发者体验': 0.8,
|
|
25
|
-
};
|
|
26
|
-
|
|
27
|
-
export const DIMENSION_ORDER = Object.keys(DEFAULT_WEIGHTS);
|
|
28
|
-
|
|
29
|
-
/** 等级分界(score ≥ 阈值取该级;A 最优,E 最差)。 */
|
|
30
|
-
export const LEVEL_A_MIN = 85;
|
|
31
|
-
export const LEVEL_B_MIN = 70;
|
|
32
|
-
export const LEVEL_C_MIN = 55;
|
|
33
|
-
export const LEVEL_D_MIN = 40;
|
|
34
|
-
/**
|
|
35
|
-
* 审计评分保留的小数位数(展示与 level 档位判定共用)。
|
|
36
|
-
* 改这一处即改全局精度:整数分丢失维度间差异(79 与 79.4 同显 79),
|
|
37
|
-
* 三位小数便于对照「同一仓库改一处代码后分数动了多少」。
|
|
38
|
-
*/
|
|
39
|
-
export const SCORE_DECIMALS = 3;
|
|
40
|
-
/** 舍入因子 = 10^SCORE_DECIMALS:先乘后除,实现「保留 N 位小数」。 */
|
|
41
|
-
const SCORE_ROUND_FACTOR = 10 ** SCORE_DECIMALS;
|
|
42
|
-
/** 单维度得分下限:错误再多也保留微弱区分度(不塌陷成 0)。 */
|
|
43
|
-
export const DIMENSION_SCORE_FLOOR = 0.1;
|
|
44
|
-
|
|
45
|
-
/**
|
|
46
|
-
* 按 10 维度汇总问题计数。
|
|
47
|
-
* @param {Array} findings 统一问题对象数组(含 dimensions 字段)
|
|
48
|
-
* @returns {{[dim]: number}} 分维度计数
|
|
49
|
-
*/
|
|
50
|
-
export function countByDimension(findings = []) {
|
|
51
|
-
const counts = Object.fromEntries(DIMENSION_ORDER.map((d) => [d, 0]));
|
|
52
|
-
// 公平性修复(大项目小问题线性累加不公平——小问题不会同时出现):
|
|
53
|
-
// warning/info 类**每文件每规则每维度最多计 1 次**——一个文件 20 处短变量 = 该文件 1 个
|
|
54
|
-
// 「命名可读性」问题(修一处即覆盖全消),不随同规则条数线性累加;不同规则各计
|
|
55
|
-
// (同文件 20 个不同规则问题 = 20),与大项目文件数解耦。
|
|
56
|
-
// blocker(安全/凭据等硬问题)保持每次计 2——同文件多个凭据 = 多个致命风险,不合并。
|
|
57
|
-
const seenRule = new Map(); // `${rule}|${dim}` → Set(file);仅 warning/info 参与去重
|
|
58
|
-
for (const f of findings) {
|
|
59
|
-
// 已确认豁免(.auditignore 的「路径 : 规则」):不参与计分,但保留在报告里可追溯
|
|
60
|
-
if (f.exempted) continue;
|
|
61
|
-
// scoreImpact: 0 的纯提醒(语义占位提示:npm audit 人工核查 / a11y /
|
|
62
|
-
// 路径穿越人工确认)不拉低质量分——它们不是「代码质量缺陷」,只是需要人工确认的
|
|
63
|
-
// 提示项;照常展示但不计入评分维度计数(severity=notice 且声明 0 影响的都不计)。
|
|
64
|
-
if (f.scoreImpact === 0) continue;
|
|
65
|
-
const sev = f.severity === 'blocker' ? 2 : 1;
|
|
66
|
-
const dedup = f.severity !== 'blocker';
|
|
67
|
-
const key = f.file || '__nofile__';
|
|
68
|
-
const rulePrefix = `${f.rule || '?'}|`;
|
|
69
|
-
for (const dim of f.dimensions || []) {
|
|
70
|
-
if (!(dim in counts)) continue;
|
|
71
|
-
if (dedup) {
|
|
72
|
-
const sKey = rulePrefix + dim;
|
|
73
|
-
if (!seenRule.has(sKey)) seenRule.set(sKey, new Set());
|
|
74
|
-
const fileSet = seenRule.get(sKey);
|
|
75
|
-
if (fileSet.has(key)) continue;
|
|
76
|
-
fileSet.add(key);
|
|
77
|
-
}
|
|
78
|
-
counts[dim] += sev;
|
|
79
|
-
}
|
|
80
|
-
}
|
|
81
|
-
return counts;
|
|
82
|
-
}
|
|
83
|
-
|
|
84
|
-
/**
|
|
85
|
-
* 每维度**命中文件数**(file 去重)——动态权重的分子。
|
|
86
|
-
*
|
|
87
|
-
* 与 countByDimension 同口径:`scoreImpact === 0` 的纯提示不计(它们本就不拉低分数);
|
|
88
|
-
* blocker 与 warning 在这里都只算「该文件命中过这个维度」一次——动态权重衡量的是
|
|
89
|
-
* **问题覆盖面**,不是问题条数(条数已由 countByDimension 的对数衰减承担)。
|
|
90
|
-
* 无文件的仓库级 finding(如 folder/locale)记为 1 个「文件」,避免整维度被算成 0 命中。
|
|
91
|
-
*/
|
|
92
|
-
export function countHitFilesByDimension(findings = []) {
|
|
93
|
-
const sets = new Map();
|
|
94
|
-
for (const f of findings) {
|
|
95
|
-
if (f.exempted) continue; // 已确认豁免不参与「命中文件数」口径
|
|
96
|
-
if (f.scoreImpact === 0) continue;
|
|
97
|
-
const fileKey = f.file || '__repo__';
|
|
98
|
-
for (const dim of f.dimensions || []) {
|
|
99
|
-
if (!(dim in DEFAULT_WEIGHTS)) continue;
|
|
100
|
-
if (!sets.has(dim)) sets.set(dim, new Set());
|
|
101
|
-
sets.get(dim).add(fileKey);
|
|
102
|
-
}
|
|
103
|
-
}
|
|
104
|
-
const out = Object.fromEntries(DIMENSION_ORDER.map((d) => [d, 0]));
|
|
105
|
-
for (const [dim, set] of sets) out[dim] = set.size;
|
|
106
|
-
return out;
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
/**
|
|
110
|
-
* 计算 10 维度评分与总分(0-100)。
|
|
111
|
-
*
|
|
112
|
-
* 公式(用户 2026-09-11 权威 + 2026-09-12 防零分塌陷升级):
|
|
113
|
-
* - dims[d] = 维度得分(0-10 原始分):max(0.1, base - k_d * ln(1 + errorCount_d))
|
|
114
|
-
* base=10;k_d 见 DIMENSION_K(5 档:安全 1.5 / 可读·可维护·健壮 1.3 / 性能 1.1 / 测试·可观测·可部署 1.0 / 文档·开发者体验 0.8)
|
|
115
|
-
* errorCount 按 countByDimension:warning 计 1 / blocker 计 2
|
|
116
|
-
* - score = Σ(dims[d] × w[d]) / Σw × 10(满分区间的百分比映射 × 100,数学等价)
|
|
117
|
-
* 防零分塌陷:对数衰减替代线性扣分——10 个错误和 100 个错误有明显分差(不都归 0),floor=0.1 保留微弱区分度。
|
|
118
|
-
* @param {Array} findings
|
|
119
|
-
* @param {object} [weights] 覆盖权重(默认 DEFAULT_WEIGHTS)
|
|
120
|
-
* @param {object} [context] { files?: number, scope?: string, dimFileCounts?: object, dimRuleCounts?: object }
|
|
121
|
-
* —— files=0(空目录/0 变动)时不评分(score:null + emptyResult:true),防止「没扫到任何文件却直接满分」;
|
|
122
|
-
* dimRuleCounts(维度→生效规则绑定数)给出时,**零规则维度权重记 0**(无检测能力的维度不再贡献满分,
|
|
123
|
-
* 见下方「零规则维度记 0」);缺省则沿用旧口径(不缩放),行为逐位等价。
|
|
124
|
-
* 返回 uncoveredDimensions:被记 0 的维度清单,供报告显式标注「本维度无检测能力」。
|
|
125
|
-
* @returns {{dims: object, score: number|null, level: 'A'|'B'|'C'|'D'|'E'|null, weights: object, emptyResult?: boolean, emptyReason?: string}}
|
|
126
|
-
*/
|
|
127
|
-
export function scoreQuality(findings = [], weights = {}, context = {}) {
|
|
128
|
-
const { files = null, docsScore = null, dimFileCounts = null, dimRuleCounts = null } = context;
|
|
129
|
-
// 0 文件(空目录 / diff 0 变动)不评分——findings 为空时对数衰减天然给满分,
|
|
130
|
-
// 但「没扫到任何文件」不等于「代码健康」,返回 null 明确区分(调用方展示「未扫描到内容」)。
|
|
131
|
-
if (files !== null && Number(files) === 0) {
|
|
132
|
-
return {
|
|
133
|
-
dims: {}, counts: {}, score: null, level: null,
|
|
134
|
-
weights: { ...DEFAULT_WEIGHTS, ...weights },
|
|
135
|
-
emptyResult: true,
|
|
136
|
-
emptyReason: '未扫描到任何文件(空目录或 0 个变动文件),未评分',
|
|
137
|
-
};
|
|
138
|
-
}
|
|
139
|
-
const weightMap = { ...DEFAULT_WEIGHTS, ...weights };
|
|
140
|
-
const counts = countByDimension(findings);
|
|
141
|
-
const dims = {};
|
|
142
|
-
// 文档维度加分制(需求讨论 DeepSeekHarness/文档加分制.md)——
|
|
143
|
-
// 文档得分 = min(10, Σ命中加分项分值),0 分起、上限 = 其他扣分制维度满分;
|
|
144
|
-
// 分值来自 docsScore.items[].score(配置可调,缺省每项 2.5);
|
|
145
|
-
// docsScore 缺省(旧调用不传 context.docsScore)→ 回退扣分制,兼容。
|
|
146
|
-
const docsTotal = Array.isArray(docsScore?.items)
|
|
147
|
-
? docsScore.items.filter((i) => i.hit).reduce((a, i) => a + (Number(i.score) || 0), 0)
|
|
148
|
-
: NaN;
|
|
149
|
-
for (const dim of DIMENSION_ORDER) {
|
|
150
|
-
// 对数衰减(防零分塌陷):score = max(DIMENSION_SCORE_FLOOR, 10 - k*ln(1+count))。dims 存原始分(不乘权重)。
|
|
151
|
-
if (dim === '文档' && Number.isFinite(docsTotal)) {
|
|
152
|
-
dims[dim] = Math.min(10, docsTotal);
|
|
153
|
-
continue;
|
|
154
|
-
}
|
|
155
|
-
const k = DIMENSION_K[dim] ?? 1.5;
|
|
156
|
-
dims[dim] = Math.max(DIMENSION_SCORE_FLOOR, 10 - k * Math.log(1 + counts[dim]));
|
|
157
|
-
}
|
|
158
|
-
// 最终得分 = Σ(维度得分 × 权重) / Σ权重 × 10(Σ(10×w)/Σw×10 = 100 满分;floor 0.1 时全扣 ≈ 1 分)
|
|
159
|
-
// 保留**三位小数**(不再 Math.round 取整)——整数分丢失维度间差异(79 与 79.4 同显 79);
|
|
160
|
-
// 侧边栏/工具展示更精细,也便于对照「同一仓库改一处代码后分数动了多少」;level 档位用同一分值判定。
|
|
161
|
-
// ── 动态权重(2026-10-30):实际权重 = 设定权重 × 动态权重,动态权重 = 命中文件数 / 总文件数 ──
|
|
162
|
-
// 语义:某维度只在少数文件出问题时,它的实际权重按「问题覆盖面」缩小(扣分更轻);
|
|
163
|
-
// 问题铺满全仓时动态权重=1,退化为纯静态权重(与历史分数一致)。
|
|
164
|
-
// 三条口径(已与需求方对齐):
|
|
165
|
-
// ① 分母用 Σ实际权重(而非固定 100)——否则「全绿」会因有效权重全为 0 而算出 0 分;
|
|
166
|
-
// ② **无命中的维度不缩放**(用设定权重):该维度没问题,必须保持满分贡献,
|
|
167
|
-
// 否则满分会被自己的 0 权重拖成 0 分;
|
|
168
|
-
// ③ 文档维度也参与:它的「命中文件数」取 docsScore.files(仓库里实际存在的文档文件),
|
|
169
|
-
// 因为它本身是加分制、没有「命中问题的文件」概念;无文档文件信息时回退不缩放。
|
|
170
|
-
// 总文件数缺失(files=null,旧调用方)⇒ 全部不缩放,行为与改造前逐位等价。
|
|
171
|
-
// 分母优先用**该维度可作用文件数**(dimFileCounts,由审计编排层按规则 exts 声明统计):
|
|
172
|
-
// 数据文件占比高的仓库里,用总文件数会把代码问题被数据资产数量摊薄(实测某资源仓库
|
|
173
|
-
// 3086 个文本文件中 2701 个是清单 json,可读性权重被稀释到 1/10)。
|
|
174
|
-
// 缺 dimFileCounts(旧调用方/独立调用)→ 回退总文件数,行为与上一版一致。
|
|
175
|
-
// ── 零规则维度记 0(2026-11-06):某维度在本次生效的规则集里**一条规则都没绑定**,
|
|
176
|
-
// 说明它对本仓库**没有检测能力**——此前它按「无命中=满分 10 + 满设定权重」计入总分,
|
|
177
|
-
// 于是「测不到」被算成「质量高」(实测外部仓库:安全性权重 18 仅 3 处规则绑定,
|
|
178
|
-
// 测试覆盖/可观测性/开发者体验 0 处绑定,五维齐满分把分抬到 85/A,而人工核实出 6 个真问题)。
|
|
179
|
-
// 记 0 等价于**把该维度剔出分母**:既不贡献满分、也不因满分稀释其它维度的扣分,
|
|
180
|
-
// 总分只在「真被测过的维度」上归一——口径更诚实且实现最简(不造新规则、不改衰减曲线)。
|
|
181
|
-
// 判据用**生效规则集**(已按仓库语言/槽位过滤后的 grouped),不是全量规则表:
|
|
182
|
-
// 纯 Python 仓库里没有 C# 专属规则属正常,不该因此把「可维护性」记 0。
|
|
183
|
-
// 缺 dimRuleCounts(旧调用方/独立调用)⇒ 不启用本口径,行为与改造前逐位等价。
|
|
184
|
-
const ruleCountOf = (dim) => {
|
|
185
|
-
if (!dimRuleCounts || typeof dimRuleCounts !== 'object') return null;
|
|
186
|
-
const n = Number(dimRuleCounts[dim]);
|
|
187
|
-
return Number.isFinite(n) ? n : 0;
|
|
188
|
-
};
|
|
189
|
-
// 防全塌保护:只有「规则集确实给出了维度绑定信息」(至少一个维度计数>0)时才启用本口径。
|
|
190
|
-
// 极端情形(自定义规则集所有规则都不声明 dimensions ⇒ dimRuleCounts 为 {},十维全 0)
|
|
191
|
-
// 会让分母塌成 0、总分算成 0——那不是「诚实」而是失真,故整条口径退回旧行为(不缩放)。
|
|
192
|
-
const coverageKnown = DIMENSION_ORDER.some((d) => ruleCountOf(d) > 0);
|
|
193
|
-
const denomOf = (dim) => {
|
|
194
|
-
const perDim = Number(dimFileCounts?.[dim]) > 0 ? Number(dimFileCounts[dim]) : 0;
|
|
195
|
-
return perDim || (Number(files) > 0 ? Number(files) : 0);
|
|
196
|
-
};
|
|
197
|
-
const anyDenom = DIMENSION_ORDER.some((d) => denomOf(d) > 0);
|
|
198
|
-
const hitFiles = anyDenom ? countHitFilesByDimension(findings) : null;
|
|
199
|
-
const dynamicRatio = (dim) => {
|
|
200
|
-
const total = denomOf(dim);
|
|
201
|
-
if (!total) return null; // 该维度既无分母也无总文件数 → 不启用动态权重
|
|
202
|
-
if (dim === '文档') {
|
|
203
|
-
const docFiles = Array.isArray(docsScore?.files) ? docsScore.files.length : 0;
|
|
204
|
-
return docFiles > 0 ? Math.min(1, docFiles / total) : null;
|
|
205
|
-
}
|
|
206
|
-
const hf = hitFiles[dim] || 0;
|
|
207
|
-
return hf > 0 ? Math.min(1, hf / total) : null; // 无命中 → 不缩放
|
|
208
|
-
};
|
|
209
|
-
const dynamicWeights = {};
|
|
210
|
-
const uncoveredDimensions = [];
|
|
211
|
-
for (const d of DIMENSION_ORDER) {
|
|
212
|
-
// 零规则维度:直接记 0 权重(不进分母),并登记供报告显式标注「本维度无检测能力」
|
|
213
|
-
if (coverageKnown && ruleCountOf(d) === 0) {
|
|
214
|
-
dynamicWeights[d] = 0;
|
|
215
|
-
uncoveredDimensions.push(d);
|
|
216
|
-
continue;
|
|
217
|
-
}
|
|
218
|
-
const ratio = dynamicRatio(d);
|
|
219
|
-
dynamicWeights[d] = (weightMap[d] || 0) * (ratio === null ? 1 : ratio);
|
|
220
|
-
}
|
|
221
|
-
const totalWeight = Object.values(dynamicWeights).reduce((a, b) => a + b, 0);
|
|
222
|
-
const weightedSum = DIMENSION_ORDER.reduce((a, d) => a + dims[d] * (dynamicWeights[d] || 0), 0);
|
|
223
|
-
// 百分比映射:Σ(dims×w)/Σw 是 0~10 的分值,×10 归一到 0~100;再按 SCORE_DECIMALS 保留小数
|
|
224
|
-
const percentScale = 10;
|
|
225
|
-
const score = totalWeight > 0
|
|
226
|
-
? Math.round(((weightedSum / totalWeight) * percentScale) * SCORE_ROUND_FACTOR) / SCORE_ROUND_FACTOR
|
|
227
|
-
: 0;
|
|
228
|
-
const level = score >= LEVEL_A_MIN ? 'A' : score >= LEVEL_B_MIN ? 'B' : score >= LEVEL_C_MIN ? 'C' : score >= LEVEL_D_MIN ? 'D' : 'E';
|
|
229
|
-
return {
|
|
230
|
-
dims, counts, score, level, weights: weightMap, dynamicWeights,
|
|
231
|
-
// 启用零规则口径时回传清单(空数组=十维都有检测能力);未启用则为 null,调用方据此区分口径
|
|
232
|
-
uncoveredDimensions: coverageKnown ? uncoveredDimensions : null,
|
|
233
|
-
};
|
|
234
|
-
}
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"user": "默认开发者",
|
|
3
|
-
"description": "默认开发者特殊要求(AI 调用 git_commit_push / git_remote_create 前必须逐条核对达标,全部达标才执行)",
|
|
4
|
-
"items": [
|
|
5
|
-
"提交信息写清做了什么:commit message 必须描述本次实际变更内容(做了什么),禁止空泛词(如 update、fix、改了点东西);格式建议 feat:/fix:/docs:/chore: 前缀 + 具体说明,先在会话和用户讨论经过用户确认",
|
|
6
|
-
"单文件代码非必要不要超过 400 行,否则需要按功能拆分",
|
|
7
|
-
"大文件/产物不入库:node_modules、lock 文件、构建产物、下载的图片/视频等若无引用不入库;如已入库需先清理(.gitignore + 必要时 git rm --cached),tools/tool 文件夹的二进制文件可以豁免,bin 文件夹新增文件第一次提交提醒用户确认是否需要提交",
|
|
8
|
-
"敏感信息不入库:token/密钥/密码/凭据文件不入公开仓库;如涉及需先移出或豁免确认",
|
|
9
|
-
"删除需可恢复:删除文件/目录前先确认有 git 历史或备份(禁 rm -rf 无痕删除),大删除先 commit 检查点",
|
|
10
|
-
"文档对话类措辞:公开仓库文档只写做了什么,不含会话引用/决策来源/AI 许可表述/商量转述等沟通措辞(见 release-docs-rule)",
|
|
11
|
-
"dryRun 先行:批量/破坏性操作(重建历史、删除、迁移)先 dryRun 预演,确认无误再执行",
|
|
12
|
-
"版本号同步:功能变更时同步更新 package.json version 与 README 版本记录表",
|
|
13
|
-
"提交信息结构化:提交信息含**多个要点**或需要 why/verify 溯源时,用 messageItems 传数组(元素为字符串或 {what,type?,scope?,why?,verify?,refs?},仅 what 必填)——message 只传字符串(宿主校验只认标量类型)并作标题,条目会渲染成要点与正文;简单一句话说清时用字符串即可,不必强行结构化"
|
|
14
|
-
]
|
|
15
|
-
}
|
|
Binary file
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 审计扩展契约示例——演示如何写一个自动接入的独立审计脚本。
|
|
3
|
-
*
|
|
4
|
-
* 契约(复制本文件骨架即可新增扩展):
|
|
5
|
-
* export const auditExt = {
|
|
6
|
-
* name: '扩展名', // findings 里 source 标记 `ext:<name>`
|
|
7
|
-
* match: (repo) => true, // 是否适用该仓库(返回 false 跳过)
|
|
8
|
-
* run: async (repo, opts) => [], // 返回 findings 数组
|
|
9
|
-
* };
|
|
10
|
-
*
|
|
11
|
-
* 自动接入:放进 scripts/audit-ext/ 即被统一入口动态加载——
|
|
12
|
-
* auditFull/auditWithScope 自动并入 + `node scripts/audit-runner.mjs <repo>` 独立跑。
|
|
13
|
-
*
|
|
14
|
-
* 本示例:检查仓库根有没有 README.md(找不到给 info 提示)——演示 match/run 用法。
|
|
15
|
-
*/
|
|
16
|
-
|
|
17
|
-
export const auditExt = {
|
|
18
|
-
name: 'example-readme-present',
|
|
19
|
-
match: (repo) => Boolean(repo && repo !== '.'),
|
|
20
|
-
run: async (repo) => {
|
|
21
|
-
const { existsSync } = await import('node:fs');
|
|
22
|
-
const { join } = await import('node:path');
|
|
23
|
-
const findings = [];
|
|
24
|
-
if (!existsSync(join(repo, 'README.md'))) {
|
|
25
|
-
findings.push({
|
|
26
|
-
file: 'README.md', line: 1, rule: 'ext/readme-present',
|
|
27
|
-
severity: 'info', scoreImpact: 0,
|
|
28
|
-
message: '仓库根缺 README.md(示例审计扩展:演示契约接入)',
|
|
29
|
-
dimensions: ['文档'],
|
|
30
|
-
});
|
|
31
|
-
}
|
|
32
|
-
return findings;
|
|
33
|
-
},
|
|
34
|
-
};
|