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.
Files changed (239) hide show
  1. package/README.md +76 -47
  2. package/cli-tool.mjs +2 -4
  3. package/cli.mjs +11 -4
  4. package/lib/app/apply.js +15 -13
  5. package/lib/app/command-registry.js +26 -19
  6. package/lib/app/handlers/http-constants.js +8 -0
  7. package/lib/app/handlers/meta.js +2 -2
  8. package/lib/app/handlers/preprocess.js +104 -0
  9. package/lib/app/handlers/repo-actions.js +2 -3
  10. package/lib/app/handlers/repos.js +137 -10
  11. package/lib/app/handlers/settings.js +34 -15
  12. package/lib/app/http-handlers.js +13 -42
  13. package/lib/app/index.js +3 -2
  14. package/lib/app/inject-text.js +6 -21
  15. package/lib/app/preprocess-client.js +136 -0
  16. package/lib/app/repo-ownership.js +1 -1
  17. package/lib/app/schema.js +20 -10
  18. package/lib/app/settings-bridge.js +60 -8
  19. package/lib/app/severity.js +14 -0
  20. package/lib/app/slash-commands.js +5 -164
  21. package/lib/app/tool-call.js +96 -163
  22. package/lib/cli/commands-preprocess.mjs +74 -0
  23. package/lib/cli/commands-tool.mjs +3 -2
  24. package/lib/cli/commands-vcs.mjs +39 -5
  25. package/lib/cli/shared.mjs +36 -10
  26. package/lib/client/index.js +11 -16
  27. package/lib/client-parts/git/account.js +21 -12
  28. package/lib/client-parts/git/actions.js +23 -77
  29. package/lib/client-parts/git/apply.js +8 -2
  30. package/lib/client-parts/git/browser.js +1 -1
  31. package/lib/client-parts/git/const.js +33 -1
  32. package/lib/client-parts/git/controller.js +175 -176
  33. package/lib/client-parts/git/icons.js +1 -1
  34. package/lib/client-parts/git/loader.js +1 -1
  35. package/lib/client-parts/git/npm.js +56 -37
  36. package/lib/client-parts/git/page.js +53 -1
  37. package/lib/client-parts/git/repo.js +8 -1
  38. package/lib/client-parts/git/settings.js +13 -1
  39. package/lib/client-parts/git/state.js +237 -0
  40. package/lib/client-parts/git/utils.js +1 -1
  41. package/lib/client.js +631 -312
  42. package/lib/commit-push/pre-commit-engine.js +629 -30
  43. package/lib/commit-push.js +127 -67
  44. package/lib/context/index.js +7 -5
  45. package/lib/core/config.js +1 -27
  46. package/lib/core/exec.js +2 -11
  47. package/lib/{exempt/index.js → git/exempt-markers.js} +8 -1
  48. package/lib/git/identity-rewrite.js +1 -1
  49. package/lib/git/ignore.js +1 -1
  50. package/lib/git/index.js +1 -1
  51. package/lib/git/push.js +2 -17
  52. package/lib/git/repo-index.js +8 -3
  53. package/lib/git/repos.js +2 -2
  54. package/lib/git/sensitive.js +1 -1
  55. package/lib/npm/install.js +1 -1
  56. package/lib/npm/publish.js +20 -5
  57. package/lib/npm/registry.js +2 -2
  58. package/lib/plugin/auto-push.js +5 -8
  59. package/lib/preprocess/providers.js +195 -0
  60. package/lib/self/index.js +1 -1
  61. package/lib/skip-dirs.js +14 -55
  62. package/package.json +31 -42
  63. package/skills/dev/dsh-git-push.md +9 -9
  64. package/skills/guide/guide-commit-push.md +11 -13
  65. package/skills/workflow/README.md +0 -1
  66. package/skills/workflow/task-completion-report.md +2 -2
  67. package/.auditignore +0 -30
  68. package/.gitignore +0 -43
  69. package/cli-audit.mjs +0 -141
  70. package/lib/BUGFIX-NOTES-2026-09-14.md +0 -278
  71. package/lib/app/audit-api.js +0 -173
  72. package/lib/app/handlers/audit.js +0 -150
  73. package/lib/app/host-doc-checks.js +0 -25
  74. package/lib/app/schema-audit.js +0 -42
  75. package/lib/app/scope-check.js +0 -69
  76. package/lib/ast/brace.js +0 -120
  77. package/lib/ast/callgraph.js +0 -135
  78. package/lib/ast/code-lines.js +0 -175
  79. package/lib/ast/consts.js +0 -12
  80. package/lib/ast/control-flow.js +0 -470
  81. package/lib/ast/credential.js +0 -315
  82. package/lib/ast/dataflow.js +0 -391
  83. package/lib/ast/dup-code.js +0 -165
  84. package/lib/ast/fs-hotspots.js +0 -154
  85. package/lib/ast/index.js +0 -38
  86. package/lib/ast/io-risk-const.js +0 -95
  87. package/lib/ast/io-risk-fn.js +0 -208
  88. package/lib/ast/io-risk-loop.js +0 -308
  89. package/lib/ast/io-risk.js +0 -314
  90. package/lib/ast/lang.js +0 -156
  91. package/lib/ast/line-count.js +0 -52
  92. package/lib/ast/magic-number.js +0 -272
  93. package/lib/ast/naming.js +0 -292
  94. package/lib/ast/perf.js +0 -488
  95. package/lib/ast/scope-collisions.js +0 -228
  96. package/lib/ast/scope.js +0 -241
  97. package/lib/ast/shell.js +0 -131
  98. package/lib/ast/size.js +0 -448
  99. package/lib/ast/symbol-index.js +0 -399
  100. package/lib/ast/tokenizer.js +0 -421
  101. package/lib/ast/treesitter.js +0 -413
  102. package/lib/audit/analysis-coverage.js +0 -98
  103. package/lib/audit/audit-file.js +0 -205
  104. package/lib/audit/auditignore-rules.js +0 -148
  105. package/lib/audit/checks.js +0 -17
  106. package/lib/audit/client-entry.js +0 -93
  107. package/lib/audit/collector.js +0 -610
  108. package/lib/audit/ext-runner.js +0 -80
  109. package/lib/audit/file-context.js +0 -391
  110. package/lib/audit/finding.js +0 -101
  111. package/lib/audit/gitignore-match.js +0 -113
  112. package/lib/audit/glob.js +0 -63
  113. package/lib/audit/history-report.js +0 -100
  114. package/lib/audit/history.js +0 -126
  115. package/lib/audit/ignore-blind.js +0 -102
  116. package/lib/audit/index.js +0 -33
  117. package/lib/audit/orchestrate.js +0 -672
  118. package/lib/audit/public.js +0 -24
  119. package/lib/audit/repo-level.js +0 -30
  120. package/lib/audit/report-yaml.js +0 -90
  121. package/lib/audit/scope-policy.js +0 -110
  122. package/lib/audit/slot.js +0 -66
  123. package/lib/audit-rules/audit-rules-comment.yml +0 -199
  124. package/lib/audit-rules/audit-rules-cpp.yml +0 -114
  125. package/lib/audit-rules/audit-rules-csharp.yml +0 -82
  126. package/lib/audit-rules/audit-rules-docs.yml +0 -32
  127. package/lib/audit-rules/audit-rules-dsh.yml +0 -177
  128. package/lib/audit-rules/audit-rules-filehealth.yml +0 -42
  129. package/lib/audit-rules/audit-rules-folder.yml +0 -99
  130. package/lib/audit-rules/audit-rules-frontend.yml +0 -335
  131. package/lib/audit-rules/audit-rules-go.yml +0 -103
  132. package/lib/audit-rules/audit-rules-i18n.yml +0 -45
  133. package/lib/audit-rules/audit-rules-java.yml +0 -105
  134. package/lib/audit-rules/audit-rules-nodejs.yml +0 -662
  135. package/lib/audit-rules/audit-rules-npm.yml +0 -187
  136. package/lib/audit-rules/audit-rules-paths.yml +0 -98
  137. package/lib/audit-rules/audit-rules-performance.yml +0 -245
  138. package/lib/audit-rules/audit-rules-php.yml +0 -101
  139. package/lib/audit-rules/audit-rules-private.yml +0 -24
  140. package/lib/audit-rules/audit-rules-python.yml +0 -106
  141. package/lib/audit-rules/audit-rules-robustness.yml +0 -31
  142. package/lib/audit-rules/audit-rules-rust.yml +0 -109
  143. package/lib/audit-rules/audit-rules-structure.yml +0 -158
  144. package/lib/audit-rules/audit-rules-swift.yml +0 -99
  145. package/lib/audit-rules/audit-rules-template.yml +0 -108
  146. package/lib/audit-ui-sdk/contract.js +0 -117
  147. package/lib/audit-ui-sdk/index.js +0 -17
  148. package/lib/checks/button-bind.js +0 -347
  149. package/lib/checks/common.js +0 -170
  150. package/lib/checks/credential-file.js +0 -43
  151. package/lib/checks/dataflow.js +0 -40
  152. package/lib/checks/dispatch.js +0 -117
  153. package/lib/checks/dup-code.js +0 -69
  154. package/lib/checks/dup-const.js +0 -232
  155. package/lib/checks/file-health.js +0 -150
  156. package/lib/checks/filter.js +0 -137
  157. package/lib/checks/folder.js +0 -173
  158. package/lib/checks/fs-scanner.js +0 -57
  159. package/lib/checks/hardcoded-path.js +0 -98
  160. package/lib/checks/index.js +0 -49
  161. package/lib/checks/io.js +0 -66
  162. package/lib/checks/magic-number.js +0 -42
  163. package/lib/checks/npm-json.js +0 -273
  164. package/lib/checks/private.js +0 -64
  165. package/lib/checks/regex.js +0 -298
  166. package/lib/checks/scope-collision.js +0 -68
  167. package/lib/checks/semantic.js +0 -134
  168. package/lib/checks/structural.js +0 -281
  169. package/lib/cli/commands-audit.mjs +0 -142
  170. package/lib/cli/commands-doc.mjs +0 -127
  171. package/lib/client-parts/audit/audit.js +0 -301
  172. package/lib/exempt/tool.js +0 -198
  173. package/lib/git/module-splitter.js +0 -47
  174. package/lib/link-check/index.js +0 -187
  175. package/lib/lint-adapter/detect.js +0 -161
  176. package/lib/lint-adapter/index.js +0 -50
  177. package/lib/lint-adapter/runner.js +0 -133
  178. package/lib/preprocess/audit.js +0 -98
  179. package/lib/preprocess/index.js +0 -78
  180. package/lib/rule/compilers/credential.js +0 -62
  181. package/lib/rule/compilers/dataflow.js +0 -38
  182. package/lib/rule/compilers/file-health.js +0 -75
  183. package/lib/rule/compilers/frontend.js +0 -86
  184. package/lib/rule/compilers/func.js +0 -35
  185. package/lib/rule/compilers/helpers.js +0 -71
  186. package/lib/rule/compilers/index.js +0 -29
  187. package/lib/rule/compilers/link-semantic.js +0 -45
  188. package/lib/rule/compilers/list-kinds.js +0 -12
  189. package/lib/rule/compilers/numeric-kinds.js +0 -73
  190. package/lib/rule/compilers/regex.js +0 -78
  191. package/lib/rule/compilers/structure.js +0 -107
  192. package/lib/rule/compilers.js +0 -17
  193. package/lib/rule/homoglyph.js +0 -45
  194. package/lib/rule/loader.js +0 -274
  195. package/lib/rule/registry.js +0 -122
  196. package/lib/rule/scope.js +0 -67
  197. package/lib/score/docs-score.js +0 -166
  198. package/lib/score/index.js +0 -234
  199. package/lib/user-requirements.json +0 -15
  200. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  201. package/scripts/audit-ext/_example-readme-present.mjs +0 -34
  202. package/scripts/audit-ext/dsh-inject-declarations.mjs +0 -209
  203. package/scripts/audit-ext/variable-min-length.mjs +0 -102
  204. package/scripts/audit-gate.mjs +0 -235
  205. package/scripts/audit-runner.mjs +0 -35
  206. package/scripts/audit-runtime-check.mjs +0 -129
  207. package/scripts/browser-page-probe.mjs +0 -271
  208. package/scripts/build-client.mjs +0 -131
  209. package/scripts/bump-version.mjs +0 -178
  210. package/scripts/check-js-scope.mjs +0 -87
  211. package/scripts/check.mjs +0 -203
  212. package/scripts/clean-date-comments.py +0 -102
  213. package/scripts/cpu-sample.mjs +0 -188
  214. package/scripts/doc-drift.mjs +0 -200
  215. package/scripts/doc-func.mjs +0 -212
  216. package/scripts/doc-tree.mjs +0 -458
  217. package/scripts/doc-version.mjs +0 -149
  218. package/scripts/hot-path-probe-cjs.cjs +0 -71
  219. package/scripts/hot-path-probe-fs-shim.mjs +0 -28
  220. package/scripts/hot-path-probe-fsp-shim.mjs +0 -31
  221. package/scripts/hot-path-probe.mjs +0 -153
  222. package/scripts/local-registry.mjs +0 -37
  223. package/scripts/module-splitter.py +0 -800
  224. package/scripts/picker-repro.mjs +0 -115
  225. package/scripts/platform-scan.mjs +0 -168
  226. package/scripts/probe-recheck.mjs +0 -47
  227. package/scripts/rename-locator.mjs +0 -97
  228. package/scripts/rule-switch.mjs +0 -97
  229. package/scripts/rules-solo-audit.mjs +0 -173
  230. package/scripts/scan-file-io.mjs +0 -717
  231. package/scripts/scan-fs-hotspots.mjs +0 -107
  232. package/scripts/scan-version.mjs +0 -125
  233. package/scripts/symbol-index.mjs +0 -85
  234. package/scripts/verify-prestep.mjs +0 -100
  235. package/scripts/version-source.mjs +0 -173
  236. package/skills/dev/audit-rule-authoring.md +0 -58
  237. package/skills/guide/guide-audit.md +0 -270
  238. /package/lib/{audit → app}/ownership.js +0 -0
  239. /package/lib/{audit-defaults.js → git/defaults.js} +0 -0
@@ -1,117 +0,0 @@
1
- /**
2
- * contract.js —— 审计 UI 契约:什么算一个可插拔的审计面板、缺什么算构建失败。
3
- *
4
- * 为什么契约单独成文件、并且只有常量 + 校验函数(照 dsh-model-team 的 ui/theme-sdk 范式):
5
- * 面板实现是「别人写的代码」,它只应该依赖这一层。契约一旦散落到 SDK 各处,
6
- * 作者就得靠读实现来猜哪些能用 —— 那等于没有契约。
7
- * 校验发生在**构建期**(将来接回 UI 时由构建脚本调 defineAuditPanel),运行期不再重复校验:
8
- * 坏实现应该在打包时被挡住,而不是等宿主里白屏才被发现。
9
- *
10
- * 校验项刻意只覆盖「构建期一定能判」的部分(形状与版本),**不猜作者意图**:
11
- * 猜意图的校验(例如「Panel 是否真的渲染了 summary」「styles 里有没有外链 CSS」)
12
- * 会在真实实现上误报,最后逼人把校验关掉 —— 那比没有校验更糟。
13
- *
14
- * 本文件零依赖(不 import 任何模块):它既要能进构建脚本,也要能进浏览器产物,
15
- * 任何 Node 专有 API 都会让它两边都用不了。test/test-audit-ui-contract.mjs 钉住这条。
16
- *
17
- * 契约形状(与 docs/SPEC.md 第十一节同源):
18
- * defineAuditPanel({ meta: { id, name, contractVersion }, Panel, styles?, setup? })
19
- * Panel(props) 收到的 props 分三组,键名见下方三个常量:
20
- * data —— 执行侧/宿主给的面板只读数据(summary / quality / findings / ruleSlots)
21
- * actions —— 面板可以调的动作(reload / toggleRule / editWeight / toggleDisabled)
22
- * state —— 宿主状态快照(loading / error / auditEnabled / auditScanScope)
23
- * 数据只读、状态只读、要改状态走 actions —— 面板不自己保存这些状态。
24
- */
25
-
26
- /** 契约版本:SDK 的破坏性改动就 +1,构建期用它拒掉按旧契约写的实现。 */
27
- export const AUDIT_UI_CONTRACT_VERSION = 1;
28
-
29
- /** meta.id 的合法形状:小写字母开头 + [a-z0-9-],2~32 字符。
30
- * 用做样式命名空间(写进 [data-audit-panel="id"]),所以必须是能当 CSS 属性值的形状。 */
31
- export const AUDIT_PANEL_ID_PATTERN = /^[a-z][a-z0-9-]{1,31}$/;
32
-
33
- /** 面板拿到的只读数据键(与引擎返回字段同名,不再做二次改名);导出成常量而非只写注释,
34
- * 宿主与实现都从这里取键名,改名只改一处。 */
35
- export const AUDIT_PANEL_DATA_KEYS = Object.freeze(['summary', 'quality', 'findings', 'ruleSlots']);
36
-
37
- /** 面板可以调的动作(实现只读地拿到这些函数;要不要用是实现的自由)。 */
38
- export const AUDIT_PANEL_ACTION_KEYS = Object.freeze(['reload', 'toggleRule', 'editWeight', 'toggleDisabled']);
39
-
40
- /** 面板能看到的宿主状态(只读快照;面板自己不应保存这些状态)。 */
41
- export const AUDIT_PANEL_STATE_KEYS = Object.freeze(['loading', 'error', 'auditEnabled', 'auditScanScope']);
42
-
43
- /** meta 只认这三个字段:未登记的键不会带进产物(契约面就是这三个,不是"随便加")。 */
44
- const META_KEYS = Object.freeze(['id', 'name', 'contractVersion']);
45
-
46
- /**
47
- * 校验 meta 三个字段。
48
- * 每一项单独报错并带上字段名与要求 —— 契约可用性的一半在错误信息:
49
- * 只说「meta 非法」会让人回去翻文档,说清「要求 /^[a-z][a-z0-9-]{1,31}$/」才修得动。
50
- * @param {object} meta 面板定义的 meta
51
- */
52
- function assertMetaShape(meta) {
53
- if (!meta || typeof meta !== 'object') {
54
- throw new Error('[audit-ui] 缺少 meta(要求 { id, name, contractVersion })');
55
- }
56
- if (typeof meta.id !== 'string' || !AUDIT_PANEL_ID_PATTERN.test(meta.id)) {
57
- throw new Error(`[audit-ui] meta.id 非法:${JSON.stringify(meta.id)}(要求 ${String(AUDIT_PANEL_ID_PATTERN)};小写字母开头、只含 [a-z0-9-]、2~32 字符)`);
58
- }
59
- if (typeof meta.name !== 'string' || meta.name.trim() === '') {
60
- throw new Error(`[audit-ui] meta.name 必须是非空字符串(收到 ${JSON.stringify(meta.name)})`);
61
- }
62
- if (meta.contractVersion !== AUDIT_UI_CONTRACT_VERSION) {
63
- throw new Error(`[audit-ui] meta.contractVersion 不匹配:面板写的是 ${JSON.stringify(meta.contractVersion)},当前 SDK 是 ${AUDIT_UI_CONTRACT_VERSION}(按旧契约写的实现要跟着改)`);
64
- }
65
- }
66
-
67
- /**
68
- * 校验必填项:Panel 必须是函数。
69
- * 只判「是不是函数」——判不了「它渲染得对不对」,后者要跑起来才知道,属于运行期的事。
70
- * @param {object} definition 面板定义
71
- */
72
- function assertRequiredParts(definition) {
73
- if (typeof definition.Panel !== 'function') {
74
- throw new Error(`[audit-ui] Panel 必须是函数组件(收到 ${typeof definition.Panel})`);
75
- }
76
- }
77
-
78
- /**
79
- * 校验可选项:出现即必须是约定类型(缺省 = 不启用该能力)。
80
- * @param {object} definition 面板定义
81
- */
82
- function assertOptionalParts(definition) {
83
- if (definition.styles !== undefined && typeof definition.styles !== 'string') {
84
- throw new Error(`[audit-ui] styles 若存在必须是字符串(收到 ${typeof definition.styles};自带 CSS 文本,不要引外部 CSS 文件)`);
85
- }
86
- if (definition.setup !== undefined && typeof definition.setup !== 'function') {
87
- throw new Error(`[audit-ui] setup 若存在必须是函数(收到 ${typeof definition.setup};返回值可作为卸载清理函数)`);
88
- }
89
- }
90
-
91
- /**
92
- * 声明并校验一个审计面板(构建期调用)。
93
- *
94
- * 返回值是**冻结的新对象**(只含契约内的字段):
95
- * · 运行期有人往面板对象上挂字段 → 严格模式下直接抛错,而不是静默生效后被别处读到;
96
- * · 未登记的字段不会被带进产物 —— 「契约面有哪几个字段」是确定的,不随作者顺手加键而膨胀。
97
- *
98
- * @param {object} definition { meta, Panel, styles?, setup? }
99
- * @returns {{meta: object, Panel: Function, styles?: string, setup?: Function}} 冻结后的面板定义
100
- */
101
- export function defineAuditPanel(definition) {
102
- if (!definition || typeof definition !== 'object' || Array.isArray(definition)) {
103
- throw new Error('[audit-ui] defineAuditPanel 需要一个对象参数(形如 { meta, Panel, styles?, setup? })');
104
- }
105
- assertMetaShape(definition.meta);
106
- assertRequiredParts(definition);
107
- assertOptionalParts(definition);
108
- // meta 只保留契约字段:多写的键不进产物,避免「产物里有、契约里没有」的暗面
109
- const meta = {};
110
- for (const key of META_KEYS) meta[key] = definition.meta[key];
111
- return Object.freeze({
112
- meta: Object.freeze(meta),
113
- Panel: definition.Panel,
114
- styles: definition.styles,
115
- setup: definition.setup,
116
- });
117
- }
@@ -1,17 +0,0 @@
1
- /**
2
- * index.js —— 审计 UI SDK 的唯一导出面:面板实现只允许从这里 import。
3
- *
4
- * 为什么「只留一个入口」:分组导出看着只是方便,实际是**什么算稳定契约**的边界——
5
- * 实现若绕过它去 import contract.js 的内部细节,SDK 一旦重构就会伤到别人。
6
- * 所以本文件只 re-export 承诺面,一个多余符号都不加;想加符号先问「它算契约吗」。
7
- * 契约形状(meta/Panel/styles/setup 与 props 三组键)的权威说明在 ./contract.js 头部。
8
- */
9
-
10
- export {
11
- AUDIT_UI_CONTRACT_VERSION,
12
- AUDIT_PANEL_ID_PATTERN,
13
- AUDIT_PANEL_DATA_KEYS,
14
- AUDIT_PANEL_ACTION_KEYS,
15
- AUDIT_PANEL_STATE_KEYS,
16
- defineAuditPanel,
17
- } from './contract.js';
@@ -1,347 +0,0 @@
1
- /**
2
- * 检查层 · 按钮事件绑定交叉比对
3
- *
4
- * 职责:HTML 里的按钮/选择器与 JS 里的事件绑定交叉比对,识别「声明了但没绑定」等缺陷。
5
- */
6
-
7
- import { join } from 'node:path';
8
-
9
- import { makeFinding } from '../audit/index.js';
10
- import { HINT_QUALITY } from './common.js';
11
- import { tokenize } from '../ast/tokenizer.js';
12
-
13
- /* ═══════════════ 按钮事件绑定检查(button-bind, 油猴脚本版) ═══════════════ */
14
-
15
- /* ═══════════════ JSX 工厂调用的按钮提取 ═══════════════ */
16
-
17
- /**
18
- * 从 startIdx 起取「括号配平的完整调用表达式」片段。
19
- *
20
- * 为什么必须配平:`jsx.jsx('button', {` 只是调用开头,事件属性在后续行——
21
- * 只看单行会把 15 个按钮全判成「无 onClick」(实测踩过)。圆括号与花括号
22
- * 都参与计数:属性对象用 {}、字符串里的括号不应计数(本函数按引号状态跳过)。
23
- * @param {string} text
24
- * @param {number} startIdx
25
- * @param {number} maxLen 安全上限,避免未闭合时扫到文件尾
26
- * @returns {{snippet:string, endIdx:number}}
27
- */
28
- export function readBalancedCall(text, startIdx, maxLen = 4000) {
29
- let depth = 0;
30
- let started = false;
31
- let quote = '';
32
- const end = Math.min(String(text || '').length, startIdx + maxLen);
33
- for (let i = startIdx; i < end; i++) {
34
- const ch = text[i];
35
- if (quote) {
36
- if (ch === '\\') { i++; continue; }
37
- if (ch === quote) quote = '';
38
- continue;
39
- }
40
- if (ch === "'" || ch === '"' || ch === '`') { quote = ch; continue; }
41
- if (ch === '(' || ch === '{' || ch === '[') { depth++; started = true; continue; }
42
- if (ch === ')' || ch === '}' || ch === ']') {
43
- depth--;
44
- if (started && depth <= 0) return { snippet: text.slice(startIdx, i + 1), endIdx: i + 1 };
45
- }
46
- }
47
- return { snippet: text.slice(startIdx, end), endIdx: end };
48
- }
49
-
50
- /**
51
- * 抽取 JSX 工厂调用创建的按钮:jsx.jsx('button', {...}) / jsxs(...) / h('button', ...)。
52
- *
53
- * 为什么需要:client.js 里 15 个按钮全是这种调用式创建,而本检查原先只认
54
- * innerHTML 字符串 / 反引号模板 / createElement——对这种形态完全不可见
55
- * (实测对 client.js 跑出 0 条 finding,两个「点了没反应」的按钮也漏掉)。
56
- * 绑定判定:属性对象里出现 onClick/onChange/onInput/onSubmit 等 on[A-Z] 事件属性即已绑定。
57
- * @param {string} text
58
- * @returns {Array<{line:number, event:string, text:string}>}
59
- */
60
- export function extractJsxButtons(text) {
61
- const out = [];
62
- // 前置 (?<![\w$]) 只排除标识符字符,**不能排除 '.'**——本仓写法是 `jsx.jsx(...)`,
63
- // 把 '.' 也否定掉会让 jsx 永远不匹配(实测提取数 0)。命名空间前缀(jsx./React.)允许。
64
- //
65
- // 修三处误报:
66
- // ① 只认 'button',不再把 'input' 当按钮候选——input 用 onChange 传值,本就不需要
67
- // onClick,混进来会产出「input 未绑定」的假 finding(实测 client.js 11 个 input 全中)。
68
- // ② 只在**代码片段**上匹配,注释里提到的 'button' 不再算数——原先直接 re.exec(text) 扫原文,
69
- // 本文件自己的文档注释里写 `jsx.jsx('button', {...})` 就被当真按钮报了 3 条。
70
- // ③ 行号按匹配位置修正到「实际 tag 所在行」——原先用 m.index 算行号,跨行属性对象下
71
- // 会漂到前一个调用上(实测把 616 行的 input 报成 623 行 button 的位置)。
72
- const re = /(?<![\w$])(?:(?:[\w$]+\.)*jsxs?|h|React\.createElement)\s*\(\s*['"]button['"]/g;
73
- const code = stripCommentLines(text);
74
- let match;
75
- while ((match = re.exec(code)) !== null) {
76
- const { snippet } = readBalancedCall(text, match.index);
77
- // 事件属性要在**非注释**片段上判定:注释里写 `// onClick: 不算` 不能算已绑定
78
- // (注释与代码同为「有 onClick」的两个方向都会骗过纯文本正则,故两者都要过滤)
79
- const ev = /\bon([A-Z][A-Za-z]*)\s*:/.exec(stripCommentLines(snippet));
80
- // 按钮文本(children)用于提示可读性
81
- const label = (/children\s*:\s*['"`]([^'"`]{1,30})['"`]/.exec(snippet) || [])[1]
82
- || (/['"`]([^'"`]{1,20})['"`]\s*\]/.exec(snippet) || [])[1] || '';
83
- out.push({
84
- line: text.slice(0, match.index).split('\n').length,
85
- tag: 'button',
86
- event: ev ? `on${ev[1]}` : '',
87
- text: String(label).trim(),
88
- blank: !ev,
89
- });
90
- }
91
- return out;
92
- }
93
-
94
- /**
95
- * 把注释所在行整行替换为空格(保持行数与长度)。
96
- *
97
- * 为什么需要:提取按钮时若直接扫原文,注释里写的 `jsx.jsx('button', {...})` 会被当成真按钮
98
- * (本文件自己的文档注释即触发 3 条假 finding)。
99
- * 为什么按行而非按 token 偏移:tokenizer 的 token 只带 `line`、不带字符偏移,
100
- * 按行处理是现有能力下最简洁且无误伤的做法——代价是「行尾注释后的真代码」也会被整行
101
- * 略去,但那种写法(`const x = jsx.jsx('button',{}) // 注`)在本仓并不存在,
102
- * 且真按钮几乎总是跨行属性对象,实际影响可忽略。
103
- * @param {string} text
104
- * @returns {string} 与输入逐行等长的文本,注释行内容为空格
105
- */
106
- function stripCommentLines(text) {
107
- const lines = String(text || '').split('\n');
108
- try {
109
- const commentLines = new Set();
110
- for (const tk of tokenize(text)) if (tk && tk.type === 'comment') commentLines.add(tk.line);
111
- for (const ln of commentLines) {
112
- const idx = ln - 1;
113
- if (idx >= 0 && idx < lines.length) lines[idx] = ' '.repeat(lines[idx].length);
114
- }
115
- } catch {
116
- // 分词失败(语法不完整等)时退回原文:宁可多报也不静默漏报
117
- return String(text || '');
118
- }
119
- return lines.join('\n');
120
- }
121
-
122
- /**
123
- * 油猴脚本/浏览器扩展按钮事件绑定交叉比对(同文件内)。
124
- * 场景:HTML 以字符串形式内嵌在 JS(innerHTML=/insertAdjacentHTML/模板字符串/createElement),
125
- * 事件在 JS 里用 addEventListener/onclick= 赋值绑定——不能只看 HTML 里有没有 inline onclick。
126
- *
127
- * 三步:
128
- * 1. 从 JS 文本提取「HTML 字符串中的按钮」(inline onclick 降级 info 不计为绑定证据)
129
- * 2. 从同一文本提取「绑定证据」:addEventListener('click' / .onclick= 赋值 / 自定义 on* 函数调用 pattern
130
- * 3. 交叉比对:按钮 id/class/text 能在绑定证据中找到 → 已绑定;找不到 → unbound warning
131
- *
132
- * 只报 warning 不阻断(手工确认绑定方式),inline onclick 场景报 info 建议。
133
- * 输入规则约定(yml 声明 kind: button-bind,或 category: 'button' 无 patterns):
134
- * - rule.extra.buttonInsertPatterns / bindPatterns 可选覆盖(默认内置油猴常用模式)
135
- * @param {object} opts { file, text, rules }
136
- * @returns {Array} findings
137
- */
138
- export function checkButtonBindings({ file, text, rules, fileScope = '' }) {
139
- const findings = [];
140
- if (!text) return findings;
141
-
142
- const btns = [];
143
- const binds = new Set();
144
- let hasDelegation = false;
145
-
146
- // ── 1. 提取 HTML 字符串中的按钮 ──
147
- // innerHTML='...' 或 innerHTML="..."(含模板字符串反引号)
148
- const htmlChunks = [];
149
- const chunkRe = /(?:innerHTML|outerHTML|insertAdjacentHTML\s*\([^)]*\))\s*=\s*(`[^`]*`|'[^']*'|"[^"]*")/g;
150
- let match;
151
- while ((match = chunkRe.exec(text)) !== null) {
152
- htmlChunks.push({ html: match[1], start: match.index });
153
- }
154
- // 模板字符串里的 <button ...>...</button>(不局限于 innerHTML 赋值)
155
- const tplChunks = [];
156
- const tplRe = /`[^`]*<button[^`]*`/g;
157
- while ((match = tplRe.exec(text)) !== null) tplChunks.push({ html: match[0], start: match.index });
158
-
159
- const btnRe = /<button\b([^>]*)>([\s\S]*?)<\/button\s*>|<input\b[^>]*type\s*=\s*['"](?:button|submit)['"][^>]*>/gi;
160
- // JSX/React 事件属性(onClick=/onChange= 等驼峰 on[A-Z])→ 声明式绑定,视为已绑定(防 React 代码误报 unbound)
161
- const jsxEventRe = /\bon[A-Z][\w]*\s*=\s*[\{'"`]/;
162
- // Vue/声明式模板事件属性:@click / @click.self|stop|prevent|once / v-on:click(含修饰符)/ @[click]
163
- // 2026-10-17 由 ZipCalm 反馈修复:该项目的 .vue 按钮**全部**写作
164
- // `<button … data-testid="compress-close" @click="emit('close')">关闭</button>`,
165
- // 而旧判据只认 React 的 onClick ⇒ 同一元素上的绑定看不见 ⇒ 16 条全部误报
166
- // (判据说"未找到绑定证据",但绑定就写在按钮元素自己身上 ✗ 属判错事实)。
167
- // 注意只认 click 类事件:Vue 的 @click 是绑定证据,与 HTML 字符串里的 inline onclick 不同,
168
- // 不产生 button/inline-binding-in-string 提示(那是 DOM0 内联写法的问题)。
169
- const vueEventRe = /(?:@click(?:\.\w+)*|v-on:click(?:\.\w+)*|@\[click\])\s*=/;
170
- for (const chunk of htmlChunks.concat(tplChunks)) {
171
- let bm;
172
- while ((bm = btnRe.exec(chunk.html)) !== null) {
173
- const attrs = bm[1] || '';
174
- const line = text.slice(0, chunk.start + bm.index).split('\n').length;
175
- btns.push({
176
- line,
177
- id: (attrs.match(/\bid=["']([^"']+)["']/i) || [])[1] || '',
178
- class: (attrs.match(/\bclass=["']([^"']+)["']/i) || [])[1] || '',
179
- text: (bm[2] || '').replace(/<[^>]*>/g, '').trim().slice(0, 30),
180
- hasInline: /\bonclick\s*=/.test(attrs),
181
- jsxBound: jsxEventRe.test(attrs), // React 声明式事件(onClick 等驼峰)
182
- vueBound: vueEventRe.test(attrs), // Vue 声明式事件(@click / v-on:click)
183
- // 静态 disabled 按钮:永远不会被点击 ⇒ 无需绑定(2026-10-17 ZipCalm 反馈:
184
- // `<button type="button" disabled title="任务未结束…">删除</button>` 被判 unbound 属
185
- // 判据不适配 ✓)。只认静态属性:`:disabled="cond"` 是动态的,可能可点 ⇒ 不在此列 ✓
186
- staticDisabled: /(?:^|\s)disabled(?:\s|$)/.test(attrs),
187
- });
188
- }
189
- }
190
- // JSX 工厂调用创建的按钮(jsx.jsx('button', {...}))——与 HTML 字符串同等待遇:
191
- // 属性里有 onClick 等事件属性即已绑定;没有则进 unbound 判定(原先完全不可见)
192
- const jsxBtns = extractJsxButtons(text);
193
- // createElement('button'/'input') 创建的元素:需要看是否以**该元素类型应有的方式**接好交互
194
- const created = [];
195
- const createRe = /createElement\s*\(\s*['"](button|input)['"]\s*\)/g;
196
- while ((match = createRe.exec(text)) !== null) {
197
- // 文件选择框识别:createElement('input') 之后常见写法是 `input.type = 'file'`
198
- // 或对象字面量 `{ type: 'file' }`。这类元素由原生交互触发(见下方 createElement 判定),
199
- // 不适用「必须绑 click」的判据。
200
- const after = text.slice(match.index, match.index + 800);
201
- const isFile = match[1] === 'input' && /(?:\.type\s*=\s*['"]file['"]|type\s*[:=]\s*['"]file['"])/i.test(after);
202
- created.push({ line: text.slice(0, match.index).split('\n').length, tag: match[1], isFile });
203
- }
204
-
205
- // ── 2. 提取绑定证据(选择器引用 + 绑定调用 + 事件委托)──
206
- // 覆盖:getElementById / querySelector / querySelectorAll(含属性选择器)/ jQuery $() / .onclick= / .addEventListener('click'
207
- const bindRe = /(?:getElementById\s*\(\s*['"]([^'"]+)['"]|querySelector(?:All)?\s*\(\s*['"]([^'"]+)['"]|\$\s*\(\s*['"]([^'"]+)['"]|\.addEventListener\s*\(\s*['"]click['"]|\.onclick\s*=|\.on\s*\(\s*['"\]click['"])/g;
208
- while ((match = bindRe.exec(text)) !== null) {
209
- for (const sel of [match[1], match[2], match[3]]) {
210
- if (sel) binds.add(sel);
211
- if (sel && sel.startsWith('#')) binds.add(sel.slice(1)); // #id 同时存 id
212
- if (sel && sel.startsWith('.')) binds.add(sel); // .class 已存;供 class 匹配
213
- }
214
- if (match[0].includes('addEventListener') || match[0].includes('.onclick') || match[0].includes('.on(')) binds.add('__has_click_handler__');
215
- }
216
-
217
- // ── 非点击类事件证据(2026-10-24 补)──
218
- // 为什么需要:上面的 bindRe **只认 click**,于是表单控件的正当接法一律被判成「未绑定」。
219
- // 实测外部项目三处 `<input type="file">`(原生 label.click() 触发文件选择,事件是 change)
220
- // 全被报「创建了按钮但没绑 click」——但它根本不需要 click。
221
- // 语义边界:这些事件对 button/a **不算**绑定证据(按钮的正当交互仍是 click 类),
222
- // 只在「创建的是 input」时才作为已绑定的依据(表单控件的 change/input/submit 是标准用法)。
223
- const altEventRe = /\.addEventListener\s*\(\s*['"](?:change|input|submit|pointerdown|pointerup|keydown|keyup|touchstart|focus)['"]|\.on\s*\(\s*['"](?:change|input|submit|pointerdown|pointerup|keydown|keyup|touchstart|focus)['"]|\bon(?:change|input|submit|pointerdown|keydown)\s*=/g;
224
- const hasAltHandler = altEventRe.test(text);
225
- // 程序化触发(label.click() / input.click()):文件选择框的常规接法,靠原生行为打开选择框
226
- const hasProgrammaticClick = /\.click\s*\(\s*\)/.test(text);
227
- // 事件委托识别(更宽):父级 .addEventListener('click' + e.target.closest('选择器') 任一出现即视为委托面
228
- // 覆盖:document.body.addEventListener('click' / container.addEventListener('click' / ev.target.closest('.btn') 分发
229
- const delegationRe = /\.addEventListener\s*\(\s*['"]click['"]|\.closest\s*\(\s*['"][^'"]+['"]\)/g; if (delegationRe.test(text)) hasDelegation = true;
230
- // 委托分发选择器(ev.target.closest('.mm-retry-btn'))也入 binds——按 class 匹配绑定面
231
- const closestRe = /\.closest\s*\(\s*['"]([^'"]+)['"]\)/g;
232
- while ((match = closestRe.exec(text)) !== null) {
233
- if (match[1]) binds.add(match[1]);
234
- if (match[1] && match[1].startsWith('#')) binds.add(match[1].slice(1));
235
- }
236
- // 属性选择器引用(querySelectorAll("button[data-dl]"))→ 按钮 data-* 匹配用
237
- const attrSelRe = /querySelector(?:All)?\s*\(\s*['"]([^'"]*(?:\[[a-z-]+\][^'"]*)?)['"]\)/g;
238
- while ((match = attrSelRe.exec(text)) !== null) {
239
- const ms = match[1]?.match(/\[([a-z][\w-]*)\]/g) || [];
240
- for (const at of ms) binds.add(at); // [data-dl] 等原样存入
241
- }
242
-
243
- // ── 3. 交叉比对 ──
244
- // 3a. JSX 工厂按钮:有事件属性即已绑定;无则报 unbound(不再依赖 HTML/选择器比对,
245
- // 因为绑定就写在同一个属性对象里,交叉比对没必要也不可靠)
246
- for (const b of jsxBtns) {
247
- if (!b.blank) continue;
248
- findings.push(makeFinding({
249
- file, line: b.line, rule: 'button/unbound', kind: 'button-bind',
250
- severity: 'warning',
251
- message: `按钮「${b.text || '(无文本)'}」(行 ${b.line})用 jsx 工厂调用创建但属性里没有 onClick 等事件属性——若由父级事件委托处理请加豁免标记`,
252
- dimensions: ['可维护性'], exemptHint: HINT_QUALITY, scoreImpact: 1,
253
- }));
254
- }
255
-
256
- // 3b. HTML 字符串里的按钮
257
- for (const btn of btns) {
258
- // JSX/React 声明式事件:onClick 等驼峰属性 = 已绑定(React 虚拟 DOM 内声明式,非油猴场景)
259
- // Vue 同理:@click / v-on:click 写在按钮元素上 = 已绑定(2026-10-17 修复,见 vueEventRe 注释)
260
- if (btn.jsxBound || btn.vueBound) continue;
261
- if (btn.staticDisabled) continue; // 静态禁用按钮:不可点 ⇒ 无绑定诉求 ✓
262
- // inline onclick:有绑定但建议改(info)
263
- if (btn.hasInline) {
264
- findings.push(makeFinding({
265
- file, line: btn.line, rule: 'button/inline-binding-in-string', kind: 'button-bind',
266
- severity: 'notice',
267
- message: `油猴脚本 HTML 字符串中的按钮含 inline onclick(行 ${btn.line}):通常无法访问闭包作用域且易违反 CSP,建议改 addEventListener/事件委托`,
268
- dimensions: ['可读性'], exemptHint: HINT_QUALITY, scoreImpact: 0,
269
- }));
270
- continue;
271
- }
272
- // 事件委托覆盖:父级监听了 click(含 closest 分发)→ 默认视为已覆盖
273
- if (hasDelegation) continue;
274
- let matched = false;
275
- if (btn.id && (binds.has(btn.id) || binds.has(`#${btn.id}`))) matched = true;
276
- if (!matched && btn.class) {
277
- for (const cls of btn.class.split(/\s+/)) {
278
- if (cls && binds.has(`.${cls}`)) { matched = true; break; }
279
- }
280
- }
281
- if (!matched && created.length) {
282
- // createElement 按钮:要求同一文件存在 addEventListener/onclick 痕迹
283
- matched = binds.has('__has_click_handler__');
284
- }
285
- if (!matched) {
286
- findings.push(makeFinding({
287
- file, line: btn.line, rule: 'button/unbound', kind: 'button-bind',
288
- severity: 'warning',
289
- message: `按钮「${btn.text || btn.id || '(无文本)'}」(行 ${btn.line})在 HTML 字符串中但未在 JS 中找到绑定证据——若通过事件委托/封装函数绑定请加豁免标记`,
290
- dimensions: ['可维护性'], exemptHint: HINT_QUALITY, scoreImpact: 1,
291
- }));
292
- }
293
- }
294
- // createElement('button'/'input') 创建的按钮:文件无任何点击绑定痕迹 → 未绑定
295
- // (jsx 工厂按钮已由 3a 单独判定,不参与此处兜底,避免互相掩盖)
296
- if (created.length && !binds.has('__has_click_handler__')) {
297
- // 按创建的元素类型分流判定「是否真的缺交互绑定」:
298
- // · 含 button ⇒ 必须有 click 类绑定(alt 事件不足以证明按钮可点)
299
- // · 只创建 input ⇒ change/input/submit 等是标准绑定方式,有就算已绑
300
- // · 全部是 <input type="file"> ⇒ 原生交互(label.click()/input.click() 打开选择框),
301
- // 本身不需要点击处理器;存在程序化触发即视为按原生方式接好
302
- const hasButton = created.some((c) => c.tag === 'button');
303
- const allFileInputs = created.every((c) => c.tag === 'input' && c.isFile);
304
- const coveredByAltEvent = !hasButton && hasAltHandler;
305
- const coveredByNativeFile = allFileInputs && hasProgrammaticClick;
306
- if (!coveredByAltEvent && !coveredByNativeFile) {
307
- const lineNos = [...new Set(created.map((c) => c.line))].sort((a, b) => a - b);
308
- const kindWord = created[0].tag === 'input' ? '表单控件' : '按钮';
309
- findings.push(makeFinding({
310
- file, line: lineNos[0], rule: 'button/create-element-binding', kind: 'button-bind',
311
- severity: 'warning',
312
- message: `createElement('${created[0].tag}') 创建了${kindWord}(行 ${lineNos.join('/')})但同文件未找到对应事件绑定`
313
- + (created[0].tag === 'input'
314
- ? '——请绑定 change/input(表单控件)或补一个可豁免标记'
315
- : '——请在 appendChild 前绑定 click'),
316
- dimensions: ['可维护性'], exemptHint: HINT_QUALITY, scoreImpact: 1,
317
- }));
318
- }
319
- }
320
- // 去重:同一按钮可能被多路提取命中(innerHTML 片段 + 反引号模板 + JSX 工厂)⇒ 同一行只留一条
321
- // (2026-10-17 实测:`el.innerHTML = \`<button…>\`` 会同时进 htmlChunks 与 tplChunks ⇒ 重复报 2 条 ✗)
322
- const seenKey = new Set();
323
- const deduped = findings.filter((f) => {
324
- const k = `${f.rule}|${f.line}`;
325
- if (seenKey.has(k)) return false;
326
- seenKey.add(k);
327
- return true;
328
- });
329
- // 分片架构适配(2026-10-24):DSH 插件的客户端源码可以是**分片**(`lib/client-parts/**`),
330
- // 注意:标准 `client-parts/` 布局由规则包的 exclude_dirs 全局跳过(片段语义,完整判定交给产物),
331
- // 本分支覆盖的是**自定义分片目录**(package.json 的 dsh.client.fragments 指向别处)的情形。
332
- // 由构建脚本拼成运行态单文件(`lib/client.js`)。分片是**片段**:单个分片语法都不成立,
333
- // 「创建元素」与「绑定事件」完全可能落在不同分片(视图分片建 DOM、控制器分片绑事件),
334
- // 于是「同文件找不到绑定证据」这个判据在分片架构里**前提就不成立**。
335
- // 处理:分片文件降级为 info(仍出现在报告里、不扣分),完整性由产物 client.js 承担判定
336
- // ——产物是所有分片的拼接,证据自然齐全。
337
- // 不用 exempt 静默排除:让「分片里某按钮确实没绑」这个事实仍可被看到。
338
- if (fileScope === 'dsh-client-fragment') {
339
- return deduped.map((f) => makeFinding({
340
- ...f,
341
- severity: 'info',
342
- scoreImpact: 0,
343
- message: `${f.message}(本文件是客户端分片,绑定可能写在其它分片;完整性以拼接产物 client.js 的判定为准)`,
344
- }));
345
- }
346
- return deduped;
347
- }
@@ -1,170 +0,0 @@
1
- /**
2
- * 检查层 · 公共设施
3
- *
4
- * 职责:检查器共用的豁免提示、severity 封顶、按 kind 分组,
5
- * 以及各 astConfirm 精筛集合的取值函数(把 AST 判定结果喂给 regex 类规则)。
6
- *
7
- * 为什么集中在这里:这些是多个检查器的共同依赖,散落各处会造成
8
- * 「同一语义两处定义、改一处漏一处」——精筛集合尤其如此。
9
- */
10
-
11
- // 性能:循环体内做全量集合物化(判据与实现见 lib/ast/perf.js,含真实样本与实测数据)。
12
- // 规则层统一从本模块取精筛集合,保持「精筛集合的取值函数都在 common.js」这一约定。
13
- export { loopFullCollectionLines, repeatIdenticalCallLines } from '../ast/perf.js';
14
- // 2026-10-12 实战沉淀:循环后缺兜底 return / 循环内整份重写 / 嵌套线性扫描 / 长同步循环无让出点
15
- export { loopNoFallbackReturnLines, loopFullRewriteCallLines, nestedLinearScanLines, longSyncLoopLines } from '../ast/perf.js';
16
-
17
- import { normalizeScopeRules } from '../rule/scope.js';
18
-
19
- import { checkMagicNumberSmartAst, checkSmallFileReadAst, checkConsoleLogJsonAst, checkShortFunctionNameAst, checkPlaceholderCredentialAst, checkCredentialRefAst, shellCdDynamicLines as shellCdDynamicAst, writeIntoGitignoredLines as writeIntoGitignoredAst, scanIoRiskAst } from '../ast/index.js';
20
-
21
- /** 质量类检查的豁免提示(文件头=整文件豁免)。单处定义,多处复用,避免重复字面量。 */
22
- export const HINT_QUALITY = 'dsh-skip-quality(文件头=整文件)';
23
- /** 大文件/目录类检查的豁免提示(只能文件头)。 */
24
- export const HINT_SIZE = 'dsh-skip-size(文件头=整文件)';
25
- /** 敏感/凭据类检查的豁免提示(文件头=整文件 / 行尾=本行)。 */
26
- export const HINT_SENSITIVE = 'dsh-skip-sensitive(文件头=整文件)';
27
-
28
- /**
29
- * 规则声明的 severity 是上限:检查器内部风险升级不得超过规则自身声明。
30
- * (修正:max-complexity 规则声明 warning,不应因内部 block 阈值而升为 blocker)
31
- * @param {string} ruleSeverity yml 声明的 severity
32
- * @param {string} internalLevel 检查器内部评估等级
33
- * @returns {string} 最终 severity
34
- */
35
- export function capSeverity(ruleSeverity, internalLevel) {
36
- const rank = { notice: 0, info: 0, warning: 1, error: 2, blocker: 2 };
37
- const declared = rank[ruleSeverity] ?? 1;
38
- const internal = rank[internalLevel] ?? 1;
39
- const final = Math.min(declared, internal);
40
- return final >= 2 ? (ruleSeverity === 'error' ? 'error' : 'blocker') : (final === 1 ? 'warning' : 'notice');
41
- }
42
-
43
- /**
44
- * 按 kind 分组编译规则。
45
- *
46
- * ⚠️ 这里必须补 `normalizeScopeRules`:规范化原本只在 **yml 加载路径**(lib/rule/loader.js)执行,
47
- * 而检查器拿到的是**编译后**的规则对象(本函数是必经环节)⇒ 若此处不补,规则 yml 里的
48
- * `scope_rules` 会在编译环节**丢失**,导致作用域降级/豁免在生产中永不生效
49
- * (实测:DSH 客户端单文件的 downgrade 声明因此不触发,看起来只有检查器里的兜底在起作用)。
50
- * normalizeScopeRules 幂等,故与 loader 重复调用无害。
51
- */
52
- export function groupByKind(compiled) {
53
- const grouped = {};
54
- for (const r of compiled || []) {
55
- const withScope = r && typeof r === 'object' && !Array.isArray(r)
56
- ? { ...r, scopeRules: normalizeScopeRules(r) }
57
- : r;
58
- (grouped[withScope.kind] ||= []).push(withScope);
59
- }
60
- return grouped;
61
- }
62
-
63
- /**
64
- * astConfirm: "magic-number" 的值级精筛集合——返回 checkMagicNumberSmartAst
65
- * 判定为「真魔数」的行的 Set(版本号/日期/HTTP 状态码/命名常量值/参数默认值/
66
- * 索引运算 i+1 等豁免行不在其中)。正则初筛出的候选行必须在此集合内才报。
67
- * @param {string} text 文件全文
68
- * @returns {Set<number>} 命中行号集合
69
- */
70
- export function smartHitLines(text) {
71
- const hits = checkMagicNumberSmartAst(String(text || ''));
72
- return new Set(hits.map((h) => h.line));
73
- }
74
-
75
- /**
76
- * astConfirmKind: "small-file-read" 的精筛集合——受控小文件读取的行号
77
- * (读 JSON 数据/配置/缓存,不构成 memory-bomb 风险)。
78
- * 并集 console.log(JSON.stringify(大对象)) 一次性输出行(CLI --json 出口
79
- * 序列化一次即打印退出,不常驻内存)——两类都属 memory-bomb 的合法豁免场景。
80
- * @param {string} text 文件全文
81
- * @returns {Set<number>} 应豁免的行号集合
82
- */
83
- export function smallFileReadLines(text) {
84
- const s = checkSmallFileReadAst(String(text || ''));
85
- for (const line of checkConsoleLogJsonAst(String(text || ''))) s.add(line);
86
- return s;
87
- }
88
-
89
- /**
90
- * astConfirmKind: "console-log-json" 的精筛集合——`console.log(JSON.stringify(大对象))`
91
- * 一次性输出行(CLI --json 出口序列化一次即打印退出,不常驻内存),豁免 memory-bomb。
92
- * @param {string} text 文件全文
93
- * @returns {Set<number>} 豁免行号集合
94
- */
95
- export function consoleLogJsonLines(text) {
96
- return checkConsoleLogJsonAst(String(text || ''));
97
- }
98
-
99
- /**
100
- * astConfirmKind: "short-func-name" 的精筛集合——token 级判定为「真的过短且非公认
101
- * 缩写」的函数声明行(i18n 的 tr/t、字典 L 等不在其中)。
102
- * @param {string} text 文件全文
103
- * @returns {Set<number>} 允许报的行号集合
104
- */
105
- export function shortFuncNameLines(text, tree) {
106
- return new Set(checkShortFunctionNameAst(String(text || ''), { tree: tree || null }).map((h) => h.line));
107
- }
108
-
109
- /**
110
- * astConfirmKind: "credential-value" 的精筛集合——token 级确认「凭据标识符右侧
111
- * 直接是有效字符串字面量」的行号(类型检查/字段透传/占位符/取环境变量都不算硬编码)。
112
- * 见 ast.js checkCredentialRefAst。
113
- */
114
- /**
115
- * astConfirmKind: "placeholder-credential" 的集合取值——占位符密钥串所在行。
116
- * 集合内 = 命中行是演示/占位值(豁免);集合外 = 疑似真凭据(照报)。
117
- */
118
- export function placeholderCredentialLines(text, file) {
119
- return checkPlaceholderCredentialAst(text, file);
120
- }
121
-
122
- export function credentialValueLines(text, tree) {
123
- return checkCredentialRefAst(String(text || ''), tree);
124
- }
125
-
126
- /**
127
- * astConfirmKind: "shell-cd-dynamic" 的集合取值——cd 到动态路径($VAR/$())且无兜底
128
- * 的行号(报)。见 lib/ast/shell.js shellCdDynamicLines。
129
- */
130
- /**
131
- * astConfirmKind: "io-risk" 的集合取值——AST 确认为「真实 fs 调用」的行号。
132
- * 正则初筛只看字符(会把注释/字符串里的 `fs.writeFile(...)` 示例、规则描述文本
133
- * 一并命中);本集合由 scanIoRiskAst 经 tokenizer 给出,注释与字符串内的调用
134
- * 不会出现在其中 —— 正则误报在此被 AST 修正。
135
- * @param {string} text 文件全文
136
- * @returns {Set<number>} 真实 I/O 调用所在行号集合
137
- */
138
- export function ioRiskLines(text) {
139
- return new Set(scanIoRiskAst(String(text || '')).map((h) => h.line));
140
- }
141
-
142
- /**
143
- * astConfirmKind: "io-risk" 的分级详情——行号 → 该行的分级命中(供 finding message 用)。
144
- * 同一行可能有多个 I/O 调用,取**风险最高**的一条描述(改造优先级视角)。
145
- * @param {string} text 文件全文
146
- * @returns {Map<number, object>} 行号 → 命中项
147
- */
148
- export function ioRiskDetail(text) {
149
- const out = new Map();
150
- const rank = { high: 0, medium: 1, low: 2, safe: 3 };
151
- for (const h of scanIoRiskAst(String(text || ''))) {
152
- const prev = out.get(h.line);
153
- if (!prev || (rank[h.risk] ?? 9) < (rank[prev.risk] ?? 9)) out.set(h.line, h);
154
- }
155
- return out;
156
- }
157
-
158
- export function shellCdDynamicLines(text) {
159
- return shellCdDynamicAst(String(text || ''));
160
- }
161
-
162
- /**
163
- * astConfirmKind: "write-into-gitignored" 的集合取值——写文件/目录目标命中仓库
164
- * .gitignore 且可能不存在的行号(报)。需仓库上下文 repoPath(读 .gitignore),
165
- * 无上下文时返回空集合(不报)。见 lib/ast/shell.js writeIntoGitignoredLines。
166
- */
167
- export function writeIntoGitignoredLines(text, repoPath) {
168
- return writeIntoGitignoredAst(String(text || ''), String(repoPath || ''));
169
- }
170
-