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,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