dsh-git-push 2.20.19 → 3.0.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 (196) hide show
  1. package/README.md +3 -2
  2. package/cli-tool.mjs +2 -4
  3. package/cli.mjs +7 -1
  4. package/lib/app/apply.js +4 -4
  5. package/lib/app/command-registry.js +22 -17
  6. package/lib/app/handlers/meta.js +2 -2
  7. package/lib/app/handlers/preprocess.js +107 -0
  8. package/lib/app/handlers/repo-actions.js +2 -2
  9. package/lib/app/http-handlers.js +13 -42
  10. package/lib/app/index.js +2 -1
  11. package/lib/app/inject-text.js +3 -3
  12. package/lib/app/preprocess-client.js +136 -0
  13. package/lib/app/repo-ownership.js +1 -1
  14. package/lib/app/schema.js +3 -3
  15. package/lib/app/severity.js +14 -0
  16. package/lib/app/slash-commands.js +5 -164
  17. package/lib/app/tool-call.js +73 -144
  18. package/lib/cli/commands-preprocess.mjs +74 -0
  19. package/lib/cli/commands-tool.mjs +3 -2
  20. package/lib/cli/commands-vcs.mjs +4 -4
  21. package/lib/cli/shared.mjs +35 -9
  22. package/lib/commit-push/pre-commit-engine.js +57 -10
  23. package/lib/commit-push.js +71 -27
  24. package/lib/{exempt/index.js → git/exempt-markers.js} +8 -1
  25. package/lib/git/ignore.js +1 -1
  26. package/lib/git/repos.js +2 -2
  27. package/lib/git/sensitive.js +1 -1
  28. package/lib/npm/publish.js +20 -5
  29. package/lib/plugin/auto-push.js +2 -2
  30. package/lib/preprocess/providers.js +191 -0
  31. package/lib/self/index.js +1 -1
  32. package/lib/skip-dirs.js +14 -55
  33. package/package.json +29 -37
  34. package/scripts/build-client.mjs +2 -0
  35. package/scripts/check.mjs +4 -2
  36. package/scripts/local-registry.mjs +2 -1
  37. package/cli-audit.mjs +0 -141
  38. package/lib/app/audit-api.js +0 -173
  39. package/lib/app/handlers/audit.js +0 -150
  40. package/lib/app/host-doc-checks.js +0 -25
  41. package/lib/app/scope-check.js +0 -69
  42. package/lib/ast/brace.js +0 -120
  43. package/lib/ast/callgraph.js +0 -135
  44. package/lib/ast/code-lines.js +0 -175
  45. package/lib/ast/consts.js +0 -12
  46. package/lib/ast/control-flow.js +0 -470
  47. package/lib/ast/credential.js +0 -315
  48. package/lib/ast/dataflow.js +0 -391
  49. package/lib/ast/dup-code.js +0 -165
  50. package/lib/ast/fs-hotspots.js +0 -154
  51. package/lib/ast/index.js +0 -38
  52. package/lib/ast/io-risk-const.js +0 -95
  53. package/lib/ast/io-risk-fn.js +0 -208
  54. package/lib/ast/io-risk-loop.js +0 -308
  55. package/lib/ast/io-risk.js +0 -314
  56. package/lib/ast/lang.js +0 -156
  57. package/lib/ast/line-count.js +0 -52
  58. package/lib/ast/magic-number.js +0 -272
  59. package/lib/ast/naming.js +0 -292
  60. package/lib/ast/perf.js +0 -488
  61. package/lib/ast/scope-collisions.js +0 -228
  62. package/lib/ast/scope.js +0 -241
  63. package/lib/ast/shell.js +0 -131
  64. package/lib/ast/size.js +0 -448
  65. package/lib/ast/symbol-index.js +0 -399
  66. package/lib/ast/tokenizer.js +0 -421
  67. package/lib/ast/treesitter.js +0 -413
  68. package/lib/audit/analysis-coverage.js +0 -98
  69. package/lib/audit/audit-file.js +0 -205
  70. package/lib/audit/auditignore-rules.js +0 -148
  71. package/lib/audit/checks.js +0 -17
  72. package/lib/audit/client-entry.js +0 -93
  73. package/lib/audit/collector.js +0 -610
  74. package/lib/audit/ext-runner.js +0 -80
  75. package/lib/audit/file-context.js +0 -391
  76. package/lib/audit/finding.js +0 -101
  77. package/lib/audit/gitignore-match.js +0 -113
  78. package/lib/audit/glob.js +0 -63
  79. package/lib/audit/history-report.js +0 -100
  80. package/lib/audit/history.js +0 -126
  81. package/lib/audit/ignore-blind.js +0 -102
  82. package/lib/audit/index.js +0 -33
  83. package/lib/audit/orchestrate.js +0 -672
  84. package/lib/audit/public.js +0 -24
  85. package/lib/audit/repo-level.js +0 -30
  86. package/lib/audit/report-yaml.js +0 -90
  87. package/lib/audit/scope-policy.js +0 -110
  88. package/lib/audit/slot.js +0 -66
  89. package/lib/audit-rules/audit-rules-comment.yml +0 -199
  90. package/lib/audit-rules/audit-rules-cpp.yml +0 -114
  91. package/lib/audit-rules/audit-rules-csharp.yml +0 -82
  92. package/lib/audit-rules/audit-rules-docs.yml +0 -32
  93. package/lib/audit-rules/audit-rules-dsh.yml +0 -177
  94. package/lib/audit-rules/audit-rules-filehealth.yml +0 -42
  95. package/lib/audit-rules/audit-rules-folder.yml +0 -99
  96. package/lib/audit-rules/audit-rules-frontend.yml +0 -335
  97. package/lib/audit-rules/audit-rules-go.yml +0 -103
  98. package/lib/audit-rules/audit-rules-i18n.yml +0 -45
  99. package/lib/audit-rules/audit-rules-java.yml +0 -105
  100. package/lib/audit-rules/audit-rules-nodejs.yml +0 -662
  101. package/lib/audit-rules/audit-rules-npm.yml +0 -187
  102. package/lib/audit-rules/audit-rules-paths.yml +0 -98
  103. package/lib/audit-rules/audit-rules-performance.yml +0 -245
  104. package/lib/audit-rules/audit-rules-php.yml +0 -101
  105. package/lib/audit-rules/audit-rules-private.yml +0 -24
  106. package/lib/audit-rules/audit-rules-python.yml +0 -106
  107. package/lib/audit-rules/audit-rules-robustness.yml +0 -31
  108. package/lib/audit-rules/audit-rules-rust.yml +0 -109
  109. package/lib/audit-rules/audit-rules-structure.yml +0 -158
  110. package/lib/audit-rules/audit-rules-swift.yml +0 -99
  111. package/lib/audit-rules/audit-rules-template.yml +0 -108
  112. package/lib/audit-ui-sdk/contract.js +0 -117
  113. package/lib/audit-ui-sdk/index.js +0 -17
  114. package/lib/checks/button-bind.js +0 -347
  115. package/lib/checks/common.js +0 -170
  116. package/lib/checks/credential-file.js +0 -43
  117. package/lib/checks/dataflow.js +0 -40
  118. package/lib/checks/dispatch.js +0 -117
  119. package/lib/checks/dup-code.js +0 -69
  120. package/lib/checks/dup-const.js +0 -232
  121. package/lib/checks/file-health.js +0 -150
  122. package/lib/checks/filter.js +0 -137
  123. package/lib/checks/folder.js +0 -173
  124. package/lib/checks/fs-scanner.js +0 -57
  125. package/lib/checks/hardcoded-path.js +0 -98
  126. package/lib/checks/index.js +0 -49
  127. package/lib/checks/io.js +0 -66
  128. package/lib/checks/magic-number.js +0 -42
  129. package/lib/checks/npm-json.js +0 -273
  130. package/lib/checks/private.js +0 -64
  131. package/lib/checks/regex.js +0 -298
  132. package/lib/checks/scope-collision.js +0 -68
  133. package/lib/checks/semantic.js +0 -134
  134. package/lib/checks/structural.js +0 -281
  135. package/lib/cli/commands-audit.mjs +0 -142
  136. package/lib/cli/commands-doc.mjs +0 -127
  137. package/lib/client-parts/audit/audit.js +0 -301
  138. package/lib/exempt/tool.js +0 -198
  139. package/lib/git/module-splitter.js +0 -47
  140. package/lib/link-check/index.js +0 -187
  141. package/lib/lint-adapter/detect.js +0 -161
  142. package/lib/lint-adapter/index.js +0 -50
  143. package/lib/lint-adapter/runner.js +0 -133
  144. package/lib/preprocess/audit.js +0 -98
  145. package/lib/preprocess/index.js +0 -78
  146. package/lib/rule/compilers/credential.js +0 -62
  147. package/lib/rule/compilers/dataflow.js +0 -38
  148. package/lib/rule/compilers/file-health.js +0 -75
  149. package/lib/rule/compilers/frontend.js +0 -86
  150. package/lib/rule/compilers/func.js +0 -35
  151. package/lib/rule/compilers/helpers.js +0 -71
  152. package/lib/rule/compilers/index.js +0 -29
  153. package/lib/rule/compilers/link-semantic.js +0 -45
  154. package/lib/rule/compilers/list-kinds.js +0 -12
  155. package/lib/rule/compilers/numeric-kinds.js +0 -73
  156. package/lib/rule/compilers/regex.js +0 -78
  157. package/lib/rule/compilers/structure.js +0 -107
  158. package/lib/rule/compilers.js +0 -17
  159. package/lib/rule/homoglyph.js +0 -45
  160. package/lib/rule/loader.js +0 -274
  161. package/lib/rule/registry.js +0 -122
  162. package/lib/rule/scope.js +0 -67
  163. package/lib/score/docs-score.js +0 -166
  164. package/lib/score/index.js +0 -234
  165. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  166. package/scripts/audit-ext/_example-readme-present.mjs +0 -34
  167. package/scripts/audit-ext/dsh-inject-declarations.mjs +0 -209
  168. package/scripts/audit-ext/variable-min-length.mjs +0 -102
  169. package/scripts/audit-gate.mjs +0 -235
  170. package/scripts/audit-runner.mjs +0 -35
  171. package/scripts/audit-runtime-check.mjs +0 -129
  172. package/scripts/browser-page-probe.mjs +0 -271
  173. package/scripts/check-js-scope.mjs +0 -87
  174. package/scripts/clean-date-comments.py +0 -102
  175. package/scripts/cpu-sample.mjs +0 -188
  176. package/scripts/doc-drift.mjs +0 -200
  177. package/scripts/hot-path-probe-cjs.cjs +0 -71
  178. package/scripts/hot-path-probe-fs-shim.mjs +0 -28
  179. package/scripts/hot-path-probe-fsp-shim.mjs +0 -31
  180. package/scripts/hot-path-probe.mjs +0 -153
  181. package/scripts/module-splitter.py +0 -800
  182. package/scripts/picker-repro.mjs +0 -115
  183. package/scripts/platform-scan.mjs +0 -168
  184. package/scripts/probe-recheck.mjs +0 -47
  185. package/scripts/rename-locator.mjs +0 -97
  186. package/scripts/rule-switch.mjs +0 -97
  187. package/scripts/rules-solo-audit.mjs +0 -173
  188. package/scripts/scan-file-io.mjs +0 -717
  189. package/scripts/scan-fs-hotspots.mjs +0 -107
  190. package/scripts/symbol-index.mjs +0 -85
  191. package/scripts/verify-prestep.mjs +0 -100
  192. package/skills/dev/audit-rule-authoring.md +0 -58
  193. package/skills/guide/guide-audit.md +0 -270
  194. /package/lib/{audit → app}/ownership.js +0 -0
  195. /package/lib/app/{schema-audit.js → schema-preprocess.js} +0 -0
  196. /package/lib/{audit-defaults.js → git/defaults.js} +0 -0
@@ -1,335 +0,0 @@
1
- # ============================================================
2
- # 前端 HTML 审计规则集(内嵌管理界面专用版)
3
- # 作者:DeepSeek
4
- # 版本:1.0.0
5
- # 适用:服务端渲染的管理后台、运维面板、内部工具
6
- # 描述:SEO 规则已移除,聚焦可访问性、安全、表单交互、性能
7
- # 最后更新:2026-09-08
8
- # ============================================================
9
-
10
- metadata:
11
- name: "前端 HTML 审计规则(内嵌管理界面)"
12
- version: "1.0.0"
13
- language: "html-internal"
14
- author: "DeepSeek"
15
- description: "用于服务端内嵌管理界面,不面向搜索引擎"
16
- last_updated: "2026-09-08"
17
-
18
- # exts 说明(2026-09-13):本包是「前端 HTML 审计规则集」,HTML 规则必须声明 exts,
19
- # 否则会跑在所有文本文件上——.mjs 里生成网页的 HTML 模板字符串会被当真实网页误报
20
- # (实例:scripts/preview-gen.mjs 里 `<script>${...}</script>` 被判「内联脚本」blocker)。
21
- # 框架类规则(react/vue 的 dangerouslySetInnerHTML / v-html / key)是 JS/JSX 写法,故限 JS 类。
22
- rules:
23
- # ----- 1. 可访问性 -----
24
- - id: a11y/img-alt-required
25
- exts: ["html", "htm"]
26
- name: "img 必须包含 alt 属性"
27
- category: "accessibility"
28
- severity: "error"
29
- description: "缺少 alt 导致屏幕阅读器无法理解图片内容"
30
- patterns:
31
- - "<img\\s+(?![^>]*\\balt\\s*=)[^>]*>"
32
- fixable: true
33
-
34
- - id: a11y/button-has-label
35
- exts: ["html", "htm"]
36
- name: "按钮必须有可访问名称"
37
- category: "accessibility"
38
- severity: "warning"
39
- description: "仅包含图标的按钮需添加 aria-label"
40
- fixable: false
41
- mitigation: "添加 aria-label 或 title"
42
-
43
- - id: a11y/link-has-href
44
- exts: ["html", "htm"]
45
- name: "链接必须有 href 或 role"
46
- category: "accessibility"
47
- severity: "warning"
48
- description: "点击事件建议用 button,而非 a 标签"
49
- patterns:
50
- - "<a\\s+(?![^>]*\\bhref\\s*=)[^>]*>"
51
- fixable: true
52
- mitigation: "使用 href='#' + onclick 或改为 button"
53
-
54
- - id: a11y/form-label-association
55
- exts: ["html", "htm"]
56
- name: "输入框必须关联 label"
57
- category: "accessibility"
58
- severity: "warning"
59
- description: "缺少 label 影响可访问性和操作体验"
60
- fixable: false
61
- mitigation: "使用 label[for=id] 或 aria-label"
62
-
63
- # ----- 2. 安全性 -----
64
- - id: security/script-unsafe-inline
65
- exts: ["html", "htm"]
66
- name: "禁止内联脚本(未受 CSP 保护)"
67
- category: "security"
68
- severity: "error"
69
- description: "管理界面任何 XSS 漏洞都可能造成严重破坏"
70
- patterns:
71
- - "<script\\s*>"
72
- - "javascript:"
73
- fixable: false
74
- mitigation: "使用外部脚本 + 严格 CSP"
75
-
76
- - id: security/event-handler-unsafe
77
- exts: ["html", "htm"]
78
- name: "禁止事件属性使用 javascript: 伪协议"
79
- category: "security"
80
- severity: "error"
81
- description: "onclick='javascript:...' 极易被利用"
82
- patterns:
83
- - "on\\w+\\s*=\\s*['\"]\\s*javascript:"
84
- fixable: true
85
-
86
- - id: security/link-rel-noopener
87
- exts: ["html", "htm"]
88
- name: "target='_blank' 必须加 rel='noopener'"
89
- category: "security"
90
- severity: "warning"
91
- description: "防止 window.opener 攻击"
92
- patterns:
93
- - "<a\\s+[^>]*target\\s*=\\s*['\"]_blank['\"][^>]*>"
94
- fixable: true
95
-
96
- - id: security/form-method-get-sensitive
97
- exts: ["html", "htm"]
98
- name: "敏感数据表单禁止使用 GET"
99
- category: "security"
100
- severity: "error"
101
- description: "GET 会暴露数据在 URL/日志中"
102
- patterns:
103
- - "<form\\s+[^>]*method\\s*=\\s*[\"']get[\"'][^>]*>"
104
- fixable: true
105
-
106
- # ----- 3. 表单与交互 -----
107
- - id: forms/button-missing-event
108
- exts: ["html", "htm"]
109
- name: "HTML 按钮未发现 inline 事件(提示,非阻断)"
110
- category: "forms"
111
- severity: "info"
112
- description: "独立 HTML 文件的按钮没有 inline onclick——但油猴/扩展脚本的按钮常在 JS 字符串里、事件用 addEventListener 绑定,本规则不构成误报阻断;真实绑定证据走 button/unbound 交叉比对"
113
- detection_method: "静态正则 + Puppeteer 动态检测"
114
- patterns:
115
- - "<button\\s+(?![^>]*\\bon(click|submit|tap)\\s*=)[^>]*>"
116
- - "<input\\s+[^>]*type\\s*=\\s*['\"](button|submit)['\"](?![^>]*\\bonclick\\s*=)[^>]*>"
117
- fixable: false
118
- mitigation: "独立 HTML:添加 onclick 或 @click;油猴/扩展:用 addEventListener 绑定(见 button/unbound)"
119
-
120
- - id: forms/input-validation-missing
121
- exts: ["html", "htm"]
122
- name: "输入框缺少 required 或 aria-required"
123
- category: "forms"
124
- severity: "warning"
125
- description: "管理表单的必填字段应标记"
126
- patterns:
127
- - '<input\\s+[^>]*type\\s*=\\s*["\''](text|email|number|url)["\''][^>]*>'
128
- fixable: true
129
-
130
- - id: forms/form-action-missing
131
- exts: ["html", "htm"]
132
- name: "表单缺少 action 或提交事件"
133
- category: "forms"
134
- severity: "warning"
135
- description: "未指定提交目标,可能导致操作失败"
136
- patterns:
137
- - '<form\\s+(?![^>]*\\baction\\s*=)[^>]*>'
138
- fixable: true
139
- mitigation: "添加 action='' 并使用 JavaScript 拦截"
140
-
141
- - id: forms/input-autocomplete-sensitive
142
- exts: ["html", "htm"]
143
- name: "敏感输入应设置 autocomplete='off'"
144
- category: "forms"
145
- severity: "warning"
146
- description: "密码等字段建议关闭自动补全"
147
- patterns:
148
- - '<input\\s+[^>]*type\\s*=\\s*["\''](password|credit-card)["\''][^>]*>'
149
- fixable: true
150
-
151
- # ----- 4. 性能 -----
152
- - id: performance/script-defer-or-async
153
- exts: ["html", "htm"]
154
- name: "外部脚本建议使用 defer 或 async"
155
- category: "performance"
156
- severity: "info"
157
- description: "可提升页面响应速度"
158
- patterns:
159
- - '<script\\s+src\\s*=\\s*["\''][^"\'']+["\''][^>]*>(?!.*?defer)(?!.*?async)'
160
- fixable: true
161
-
162
- - id: performance/img-loading-lazy
163
- exts: ["html", "htm"]
164
- name: "非关键图片建议设置 loading='lazy'"
165
- category: "performance"
166
- severity: "info"
167
- description: "可减少初始加载时间"
168
- patterns:
169
- - '<img\\s+(?![^>]*\\bloading\\s*=\\s*["\'']lazy["\''])[^>]*>'
170
- fixable: true
171
-
172
- # ----- 5. 结构与语义 -----
173
- - id: semantic/html-lang-required
174
- exts: ["html", "htm"]
175
- name: "html 标签必须包含 lang 属性"
176
- category: "semantic"
177
- severity: "warning"
178
- description: "影响语音合成和翻译"
179
- patterns:
180
- - '<html\\s+(?![^>]*\\blang\\s*=)[^>]*>'
181
- fixable: true
182
-
183
- - id: semantic/button-role-warning
184
- exts: ["html", "htm"]
185
- name: "div/span 模拟按钮需加 role='button'"
186
- category: "semantic"
187
- severity: "warning"
188
- description: "确保辅助设备识别"
189
- patterns:
190
- - '<div\\s+[^>]*onclick[^>]*>(?![^>]*role\\s*=\\s*["\'']button["\''])'
191
- fixable: false
192
-
193
- # ----- 6. 框架 -----
194
- - id: framework/react-dangerous-html
195
- exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx"]
196
- name: "React 禁止直接使用 dangerouslySetInnerHTML"
197
- category: "framework"
198
- severity: "error"
199
- description: "除非使用 DOMPurify 消毒"
200
- patterns:
201
- - "dangerouslySetInnerHTML"
202
- fixable: false
203
-
204
- - id: framework/vue-v-html
205
- exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx"]
206
- name: "Vue 禁止使用 v-html 渲染外部数据"
207
- category: "framework"
208
- severity: "error"
209
- description: "可能引入 XSS"
210
- patterns:
211
- - "v-html\\s*="
212
- fixable: false
213
-
214
- - id: framework/react-key-prop
215
- exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx"]
216
- name: "列表渲染必须包含 key"
217
- category: "framework"
218
- severity: "warning"
219
- description: "提升 Diff 性能和状态稳定性"
220
- patterns:
221
- - "\\{\\s*([a-zA-Z0-9_]+)\\.map\\s*\\([^)]*\\)\\s*=>\\s*<[^>]*>"
222
- fixable: true
223
-
224
- # ----- 7. 按钮事件绑定(油猴脚本/浏览器扩展交叉比对,1.0.5)-----
225
- # 场景:HTML 以字符串内嵌 JS(innerHTML=/insertAdjacentHTML/模板字符串/createElement),
226
- # 事件在 JS 里用 addEventListener/onclick= 绑定——不能只看 HTML 字符串里有没有 inline onclick。
227
- # unbound / create-element-binding 为交叉比对型(kind: button-bind,无 patterns),
228
- # 由 checkButtonBindings 同文件提取 HTML 按钮 ↔ JS 绑定证据后比对判定。
229
- - id: button/inline-binding-in-string
230
- exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx"]
231
- name: "HTML 字符串中的 inline onclick(建议改)"
232
- category: "button"
233
- severity: "info"
234
- description: "油猴脚本 HTML 字符串里写 onclick 通常无法访问闭包作用域且违反 CSP,建议改 addEventListener"
235
- patterns:
236
- - "<button[^>]*\\sonclick\\s*="
237
- - "<input[^>]*type\\s*=\\s*['\"](button|submit)['\"][^>]*\\sonclick\\s*="
238
- fixable: true
239
- mitigation: "移除字符串里的 onclick,改用 addEventListener 或事件委托"
240
-
241
- - id: button/unbound
242
- name: "按钮可能未绑定事件(交叉比对)"
243
- category: "button"
244
- severity: "warning"
245
- description: "HTML 字符串中有按钮,但同文件 JS 中找不到对应绑定证据(addEventListener/onclick=/选择器引用)——若通过事件委托或封装函数绑定请加豁免标记"
246
- fixable: false
247
- mitigation: "确认是否需要绑定;事件委托/封装函数绑定请加 dsh-skip-quality(文件头)豁免标记"
248
-
249
- - id: button/create-element-binding
250
- name: "createElement 创建的元素应显式绑定"
251
- category: "button"
252
- severity: "warning"
253
- description: "用 createElement('button'/'input') 创建元素但同文件找不到对应事件的绑定痕迹则为未绑定。按元素类型分流判据:button 要求 click 类(addEventListener('click')/onclick=/@click/事件委托);input 接受 change/input/submit/pointerdown/keydown 等表单控件标准事件;<input type=\"file\"> 由原生交互触发(label.click()/input.click() 打开选择框),存在程序化触发即视为已接好,不要求 click 绑定"
254
- fixable: false
255
- mitigation: "按钮在 appendChild 前调用 addEventListener('click', fn);表单控件绑定 change/input;原生文件选择框无需额外绑定,如判定仍不准可加 dsh-skip-quality 文件头标记"
256
-
257
- - id: button/event-delegation-detected
258
- name: "检测到事件委托模式"
259
- category: "button"
260
- severity: "info"
261
- description: "父级监听 click、经 e.target 分发——油猴动态插入内容的常见绑定方式,button/unbound 应将其视为已覆盖"
262
- patterns:
263
- - "document\\.(?:body|documentElement|querySelector\\s*\\([^)]*\\))\\s*\\.addEventListener\\s*\\(\\s*['\"]click['\"]"
264
- - "e\\.target\\.(id|classList|matches|closest|dataset)"
265
- fixable: false
266
- mitigation: "事件委托已覆盖子按钮;如需细粒度检查请人工确认"
267
-
268
- - id: button/dynamic-selector
269
- name: "检测动态选择器拼装"
270
- category: "button"
271
- severity: "info"
272
- description: "选择器通过字符串拼接/模板动态生成,静态无法解析——交叉比对可能漏报"
273
- patterns:
274
- - "querySelector\\s*\\(\\s*['\"][^'\"]*['\"]\\s*\\+"
275
- - "getElementById\\s*\\(\\s*['\"][^'\"]*['\"]\\s*\\+"
276
- - "(?:querySelector|querySelectorAll|getElementById)\\s*\\(\\s*`[^`]*\\$\\{"
277
- fixable: false
278
- mitigation: "动态选择器需运行时检测;建议改用固定 id 便于静态分析"
279
-
280
- - id: button/wrapped-binding
281
- name: "检测封装函数绑定"
282
- category: "button"
283
- severity: "info"
284
- description: "通过自定义函数绑定事件(bindClick('btn-id', fn)),交叉比对可能漏报"
285
- patterns:
286
- - "(?<![\\w.])(?:bind|on|add|attach)\\w*\\s*\\(\\s*['\"][^'\"]+['\"]\\s*,"
287
- fixable: false
288
- mitigation: "封装函数需人工确认其内部是否调用了 addEventListener"
289
-
290
- - id: button/csp-compatible
291
- name: "事件绑定应符合油猴脚本 CSP 要求"
292
- category: "security"
293
- severity: "warning"
294
- description: "inline 事件属性(onclick= 等)在油猴脚本环境可能受限"
295
- exts: ["html", "htm"]
296
- patterns:
297
- - "on(click|change|input|submit)\\s*=\\s*['\"]"
298
- fixable: true
299
- mitigation: "移除 inline 事件属性,改用 addEventListener"
300
-
301
- # ----- 严重级别映射 -----
302
- severity_map:
303
- error: "error"
304
- warning: "warning"
305
- info: "info"
306
-
307
- # ----- 阈值 -----
308
- thresholds:
309
- max_warnings: 15
310
- max_errors: 0
311
- max_info: 50
312
-
313
- # ----- 忽略规则 -----
314
- ignore:
315
- - pattern: "**/dist/**/*.html"
316
- rules: ["*"]
317
- - pattern: "**/node_modules/**/*.html"
318
- rules: ["*"]
319
-
320
- # ----- 动态检测 -----
321
- dynamic_detection:
322
- enabled: true
323
- wait_for: "networkidle2"
324
- timeout: 30000
325
- detect:
326
- - "按钮事件绑定"
327
- - "表单提交"
328
- - "label 关联"
329
- - "图片 alt"
330
-
331
- # ----- 输出 -----
332
- output:
333
- format: "json"
334
- include_suggestions: true
335
- include_fix_instructions: true
@@ -1,103 +0,0 @@
1
- # ============================================================
2
- # Go 代码审计规则集(首版 · 语言专项)
3
- # 版本:0.2.0
4
- # 适用:Go 项目
5
- # 描述:本槽位首版语言专项规则(**纯 pattern 层**,不依赖 AST 函数范围)。
6
- # 规则依据:对真实 Go 仓(spf13/cobra 等样本仓)实测各候选模式的出现次数后选型——
7
- # 只收「高信号 + 可判事实」的形态,避免静态扫 Go 时满屏噪音。
8
- # (AST 层的 min_length/max_lines/max_complexity/magic-number 仍待补 LANG_FUNC_RANGES.go)
9
- # 口径:exts 只认 .go;测试与示例目录用 exclude_paths 排除(测试里 panic/exit 是常态)。
10
- # ============================================================
11
-
12
- metadata:
13
- name: "Go 审计规则集(首版 · 语言专项)"
14
- version: "0.2.0"
15
- language: "go"
16
- author: "DeepSeek"
17
- description: "Go 项目语言专用规则(pattern 层首版:panic/os.Exit/fmt.Print/context.TODO/unsafe)"
18
- last_updated: "2026-10-16"
19
-
20
- rules:
21
- # ----- 1. 健壮性 -----
22
-
23
- - id: go/panic-outside-init
24
- name: "Go 避免在库代码里 panic"
25
- category: "robustness"
26
- severity: "warning"
27
- description: "库代码 panic 会把调用方进程直接带走;应由调用方决定错误处置(返回 error 或 os.Exit 在 main 里做)"
28
- # 负向环视避免命中 `x.panic(` 这类方法调用;测试/示例目录排除(测试里 panic 是断言手段)
29
- patterns:
30
- - "(?<![\\w$.])panic\\s*\\("
31
- # 注:exclude_paths 是**路径前缀**匹配 ⇒ 无法表达 "_test.go" 这类后缀;
32
- # 同目录的测试文件仍会命中(报告里给了目录级豁免提示)。此前这里写过一条
33
- # "_test.go" 是**死条目**(永不生效 ✗),2026-10-16 已删。
34
- exts: ["go"]
35
- exclude_paths:
36
- - "test/"
37
- - "tests/"
38
- - "testdata/"
39
- - "example/"
40
- - "examples/"
41
- fixable: false
42
-
43
- - id: go/os-exit-in-library
44
- name: "Go 库代码避免 os.Exit"
45
- category: "robustness"
46
- severity: "warning"
47
- description: "os.Exit 跳过 defer 清理(文件/锁/连接不会释放),且让调用方无法拦截;只在 main 或 CLI 入口使用"
48
- patterns:
49
- - "(?<![\\w$.])os\\.Exit\\s*\\("
50
- exts: ["go"]
51
- exclude_paths:
52
- - "test/"
53
- - "tests/"
54
- - "example/"
55
- - "examples/"
56
- - "cmd/"
57
- fixable: false
58
-
59
- # ----- 2. 可维护性 -----
60
-
61
- - id: go/fmt-print-debug
62
- name: "Go 避免用 fmt.Print* 输出日志"
63
- category: "maintainability"
64
- severity: "notice"
65
- description: "fmt.Print/Printf/Println 输出到 stdout 且无级别/时间戳,生产环境应走 log/slog 或项目日志器"
66
- patterns:
67
- - "(?<![\\w$.])fmt\\.Print(?:f|ln)\\s*\\("
68
- - "(?<![\\w$.])fmt\\.Print\\s*\\("
69
- exts: ["go"]
70
- exclude_paths:
71
- - "test/"
72
- - "tests/"
73
- - "example/"
74
- - "examples/"
75
- fixable: false
76
-
77
- - id: go/context-todo
78
- name: "Go 生产代码避免 context.TODO()"
79
- category: "maintainability"
80
- severity: "notice"
81
- description: "context.TODO() 表示「还没想好」——生产路径应传调用方 context(可取消/带超时),否则请求链路无法取消"
82
- patterns:
83
- - "context\\.TODO\\s*\\(\\s*\\)"
84
- exts: ["go"]
85
- exclude_paths:
86
- - "test/"
87
- - "tests/"
88
- - "example/"
89
- - "examples/"
90
- fixable: false
91
-
92
- # ----- 3. 安全 -----
93
-
94
- - id: go/unsafe-pointer
95
- name: "Go 慎用 unsafe.Pointer"
96
- category: "security"
97
- severity: "error"
98
- description: "unsafe 绕过 Go 类型安全与 GC 保证,跨版本/跨架构易出内存错误;确需使用时必须注释清楚不变量"
99
- patterns:
100
- - "unsafe\\.Pointer"
101
- - "(?<![\\w$.])unsafe\\.(?:Sizeof|Offsetof|Alignof)\\s*\\("
102
- exts: ["go"]
103
- fixable: false
@@ -1,45 +0,0 @@
1
- # dsh-skip-sensitive: 规则定义文件含符号示范文本(t() 调用等非真实数据)
2
- # dsh-git-push 审计规则(i18n 槽位,1.0.3)
3
- # 国际化审计:用户可见文案禁止硬编码(须 t('key') 包裹)、语言包文件分语言输出。
4
- # 规则类型由编译函数按字段自动指派(pattern/patterns → regex kind;detection_method → semantic)。
5
- # dimensions:10 维度绑定(文档/可维护性)。
6
- # ⚙️ 默认关闭(disabled: true,1.1.0):i18n 规则对纯中文零依赖 CLI/插件属「可选国际化」,
7
- # 硬编码中文是产品设计而非缺陷(见 dsh-skip-i18n 标记),默认不加载避免噪音;
8
- # 需要时删掉本行,或环境变量 DSH_GIT_PUSH_RULE_SLOTS 显式列出 i18n 强制启用。
9
- disabled: true
10
- metadata:
11
- name: "国际化审计规则(i18n 六条转规则)"
12
- version: "1.0.0"
13
-
14
- rules:
15
- # ----- 规则 1:用户可见文案硬编码(未用 t() 包裹)-----
16
- - id: i18n/hardcoded-user-visible
17
- name: "用户可见文案硬编码,未用 t() 包裹"
18
- category: "i18n"
19
- severity: "warning"
20
- description: "用户可见文案禁止硬编码,必须使用 t('key') 包裹(点分层级 key,动态内容用插值 t('key', { name, count }))"
21
- patterns:
22
- - "(message|title|label|placeholder|description|tooltip|errorMsg)\\s*[:=]\\s*['\"][^'\"]{4,}['\"]"
23
- - "console\\.(log|warn|error)\\s*\\(\\s*['\"][^'\"]{4,}['\"]"
24
- fixable: false
25
- mitigation: "改为 t('module.field'),语言包按 zh-CN.json / en-US.json 分文件输出"
26
-
27
- # ----- 规则 2:t() 动态内容用字符串拼接(应插值)-----
28
- - id: i18n/concat-in-t
29
- name: "t() 内字符串拼接(应使用插值)"
30
- category: "i18n"
31
- severity: "warning"
32
- description: "动态内容应使用插值 t('key', { name, count }),禁止在 t() 参数内拼接多语言句子"
33
- pattern: "(?<![A-Za-z])t\\s*\\(\\s*['\"][^'\"]*['\"]\\s*\\+"
34
- fixable: false
35
- mitigation: "改为 t('key', { name, count })"
36
-
37
- # ----- 规则 3:语言包文件缺失(zh-CN.json / en-US.json 分文件)-----
38
- - id: i18n/locale-file-missing
39
- name: "语言包文件缺失(zh-CN.json / en-US.json 分文件)"
40
- category: "i18n"
41
- severity: "warning"
42
- description: "语言包文件单独输出,按 zh-CN.json / en-US.json 分文件(i18next 复数/日期/货币用其复数规则或 Intl API)"
43
- detection_method: "locale-file-exists"
44
- fixable: false
45
- mitigation: "补齐 zh-CN.json / en-US.json 语言包文件"
@@ -1,105 +0,0 @@
1
- # ============================================================
2
- # Java/Kotlin 代码审计规则集
3
- # 版本:1.0.0
4
- # 适用:Java / Kotlin 项目(含 Android)
5
- # 描述:按文件类型识别路由——.java/.kt 文件由本槽位承载语言无关规则,
6
- # nodejs 槽位的同类规则不再接管 Java/Kotlin(2026-10-06 划分,对齐 Python 先例)。
7
- # 背景:全量审计 pix-ezviewer(Android,143 kt + 25 java)时 nodejs slot 对 Java
8
- # 套 JS 规则(方法长度/复杂度/短名全失效),而 AST 层此前只支持 JS+Python。
9
- # 修复:① AST 层加语言路由 lib/ast/lang.js——javaKtFuncRanges(方法签名 +
10
- # 括号配对)供函数长度/复杂度/嵌套使用,checkNameLengthAst 加 Java/Kotlin
11
- # 分支(类型+短名声明、fun 函数名);② 本槽位承接 Java/Kotlin 文件的语言
12
- # 无关规则(命名/长度/复杂度/嵌套/魔数)。
13
- # 检查器复用:max_depth/max_lines/max_complexity/min_length 由 numeric-kinds
14
- # 编译器自动派发(同 nodejs/pyl 一套检查器,tokenizer 支持 Java/Kotlin 语法:
15
- # //、/* */、字符串、泛型尖括号、Kotlin fun/val/var)。
16
- # ============================================================
17
-
18
- metadata:
19
- name: "Java/Kotlin 审计规则集"
20
- version: "1.0.0"
21
- language: "java"
22
- author: "DeepSeek"
23
- description: "Java/Kotlin 项目语言无关规则:命名规范、魔数、方法长度、嵌套深度、圈复杂度"
24
- last_updated: "2026-10-06"
25
-
26
- rules:
27
- # ----- 1. 可读性 -----
28
- # 全部规则 exts: ["java", "kt"]——本槽位只审计 Java/Kotlin 文件(文件类型识别路由的落点)。
29
- # Kotlin 的 .kts / Gradle 构建脚本(.gradle.kts)不在列——构建脚本是配置不是应用代码。
30
-
31
- - id: java/variable-min-length
32
- name: "Java/Kotlin 标识符长度不少于 2 个字符"
33
- category: "readability"
34
- severity: "warning"
35
- description: "过短的标识符(如单字母变量/字段/参数)降低代码可读性(Java/Kotlin 版)"
36
- min_length: 2
37
- exts: ["java", "kt"]
38
- exceptions: ["i", "j", "k", "n", "e", "x", "y", "z", "s", "id", "ok"]
39
- fixable: false
40
-
41
- - id: java/magic-number
42
- name: "Java/Kotlin 硬编码魔数检测(枚举成员豁免版)"
43
- kind: "magic-number-smart"
44
- category: "readability"
45
- severity: "warning"
46
- description: "检测硬编码魔数,自动豁免版本号/日期/HTTP 状态码/常见常量/枚举成员(Java enum/Kotlin enum class 体内的大写 NAME = 数字)"
47
- magic_number_hints: ["timeout", "retry", "max", "min", "limit", "size", "count", "port", "interval", "delay", "duration", "threshold", "buffer", "chunk", "padding", "spacing"]
48
- legitimate_hints: ["version", "date", "year", "month", "day", "hour", "minute", "second", "http", "status"]
49
- force_count: 3
50
- exts: ["java", "kt"]
51
- fixable: true
52
- mitigation: "提取命名常量并注释含义:private static final int MAX_RETRY = 3; 版本号/日期/HTTP 状态码/常见常量/枚举成员自动豁免"
53
-
54
- - id: java/max-nesting-depth
55
- name: "Java/Kotlin 嵌套过深(> 4 层)"
56
- category: "readability"
57
- severity: "warning"
58
- description: "代码嵌套超过 4 层(如 for→for→if→if),可读性灾难,应提前 return 或抽方法(Java/Kotlin 版)"
59
- max_depth: 4
60
- exts: ["java", "kt"]
61
- fixable: false
62
-
63
- - id: java/max-function-length
64
- name: "Java/Kotlin 方法长度不超过 50 行"
65
- category: "readability"
66
- severity: "warning"
67
- description: "过长的方法难以理解和维护(Java/Kotlin 版)"
68
- max_lines: 50
69
- exts: ["java", "kt"]
70
- # 序列化/反序列化职责方法豁免——Api response 模型类(Pixiv 项目)的
71
- # Json 序列化代码行数天然超长,拆分复杂化数据传递与生命周期(同 python 先例)
72
- scope_rules:
73
- - scope: "serialization"
74
- action: "exempt"
75
- reason: "序列化/反序列化职责方法:Json 模型类是数据载体,超 50 行是职责自然形态"
76
- fixable: true
77
-
78
- - id: java/max-file-length
79
- name: "Java/Kotlin 文件总行数不超过 400 行"
80
- category: "readability"
81
- severity: "warning"
82
- description: "单文件超过 400 行时应拆分(Java/Kotlin 版;存量超大文件为已知债务,仅提醒不拦截)"
83
- max_lines: 400
84
- exts: ["java", "kt"]
85
- fixable: false
86
-
87
- - id: java/comment-density
88
- name: "Java/Kotlin 行注释密度过高(注释复述代码)"
89
- category: "readability"
90
- severity: "warning"
91
- description: "变量即注释——语义明确的代码里标识符已表达内容,额外的行注释不加深理解;只保留具有隐性约束、复杂设计、外部契约、非显然决策的块注释(Javadoc/doc comment 不计,属设计说明)"
92
- threshold: 0.4
93
- exts: ["java", "kt"]
94
- fixable: false
95
-
96
- # ----- 2. 可维护性 -----
97
- - id: java/max-cyclomatic-complexity
98
- name: "Java/Kotlin 圈复杂度不超过 10(50 以上 blocker)"
99
- category: "maintainability"
100
- severity: "blocker"
101
- description: "圈复杂度评级(2026-10-02 用户口径):1~10 良好、11~20 中等(warning)、21~50 高风险(warning,应拆分)、50+ 极难维护(blocker 拦提交)——分支点:if/else if 每分支、for/while/do-while、case 每分支、catch、&&/||/??、三元 ?、带标签 break/continue、Kotlin when 计入"
102
- max_complexity: 10
103
- block_complexity: 50
104
- exts: ["java", "kt"]
105
- fixable: false