dsh-git-push 0.0.0-stage → 2.8.4

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 (278) hide show
  1. package/.auditignore +30 -0
  2. package/.gitignore +39 -0
  3. package/LICENSE +21 -0
  4. package/README.md +1482 -2
  5. package/cli.mjs +360 -0
  6. package/cordis.patch.yml +14 -0
  7. package/lib/ARCHITECTURE.md +34 -0
  8. package/lib/BUGFIX-NOTES-2026-09-14.md +278 -0
  9. package/lib/app/apply.js +275 -0
  10. package/lib/app/audit-api.js +158 -0
  11. package/lib/app/command-registry.js +262 -0
  12. package/lib/app/constants.js +16 -0
  13. package/lib/app/handlers/account.js +166 -0
  14. package/lib/app/handlers/clone.js +168 -0
  15. package/lib/app/handlers/http-constants.js +9 -0
  16. package/lib/app/handlers/identity-rewrite.js +94 -0
  17. package/lib/app/handlers/meta.js +175 -0
  18. package/lib/app/handlers/npm.js +169 -0
  19. package/lib/app/handlers/repo-actions.js +143 -0
  20. package/lib/app/handlers/repos.js +231 -0
  21. package/lib/app/handlers/settings.js +62 -0
  22. package/lib/app/host-doc-checks.js +25 -0
  23. package/lib/app/http-handlers.js +131 -0
  24. package/lib/app/index.js +30 -0
  25. package/lib/app/inject-text.js +191 -0
  26. package/lib/app/scan-root.js +23 -0
  27. package/lib/app/schema.js +150 -0
  28. package/lib/app/settings-bridge.js +167 -0
  29. package/lib/app/slash-commands.js +395 -0
  30. package/lib/app/slot-stats.js +35 -0
  31. package/lib/app/tool-call.js +662 -0
  32. package/lib/app/tools.js +40 -0
  33. package/lib/ast/brace.js +105 -0
  34. package/lib/ast/callgraph.js +135 -0
  35. package/lib/ast/code-lines.js +114 -0
  36. package/lib/ast/consts.js +12 -0
  37. package/lib/ast/control-flow.js +461 -0
  38. package/lib/ast/credential.js +199 -0
  39. package/lib/ast/dataflow.js +274 -0
  40. package/lib/ast/dup-code.js +165 -0
  41. package/lib/ast/index.js +36 -0
  42. package/lib/ast/io-risk-const.js +95 -0
  43. package/lib/ast/io-risk-fn.js +208 -0
  44. package/lib/ast/io-risk-loop.js +308 -0
  45. package/lib/ast/io-risk.js +314 -0
  46. package/lib/ast/lang.js +156 -0
  47. package/lib/ast/line-count.js +52 -0
  48. package/lib/ast/magic-number.js +272 -0
  49. package/lib/ast/naming.js +284 -0
  50. package/lib/ast/perf.js +472 -0
  51. package/lib/ast/scope.js +241 -0
  52. package/lib/ast/shell.js +131 -0
  53. package/lib/ast/size.js +378 -0
  54. package/lib/ast/symbol-index.js +399 -0
  55. package/lib/ast/tokenizer.js +341 -0
  56. package/lib/audit/analysis-coverage.js +98 -0
  57. package/lib/audit/audit-file.js +182 -0
  58. package/lib/audit/checks.js +17 -0
  59. package/lib/audit/client-entry.js +93 -0
  60. package/lib/audit/collector.js +477 -0
  61. package/lib/audit/ext-runner.js +80 -0
  62. package/lib/audit/file-context.js +138 -0
  63. package/lib/audit/finding.js +50 -0
  64. package/lib/audit/gitignore-match.js +113 -0
  65. package/lib/audit/glob.js +63 -0
  66. package/lib/audit/history-report.js +100 -0
  67. package/lib/audit/history.js +126 -0
  68. package/lib/audit/ignore-blind.js +101 -0
  69. package/lib/audit/index.js +33 -0
  70. package/lib/audit/orchestrate.js +476 -0
  71. package/lib/audit/public.js +24 -0
  72. package/lib/audit/repo-level.js +30 -0
  73. package/lib/audit/report-yaml.js +86 -0
  74. package/lib/audit/slot.js +65 -0
  75. package/lib/audit-defaults.js +18 -0
  76. package/lib/audit-rules/audit-rules-comment.yml +247 -0
  77. package/lib/audit-rules/audit-rules-cpp.yml +22 -0
  78. package/lib/audit-rules/audit-rules-docs.yml +32 -0
  79. package/lib/audit-rules/audit-rules-dsh.yml +162 -0
  80. package/lib/audit-rules/audit-rules-filehealth.yml +42 -0
  81. package/lib/audit-rules/audit-rules-folder.yml +99 -0
  82. package/lib/audit-rules/audit-rules-frontend.yml +335 -0
  83. package/lib/audit-rules/audit-rules-go.yml +22 -0
  84. package/lib/audit-rules/audit-rules-i18n.yml +45 -0
  85. package/lib/audit-rules/audit-rules-java.yml +105 -0
  86. package/lib/audit-rules/audit-rules-nodejs.yml +647 -0
  87. package/lib/audit-rules/audit-rules-npm.yml +187 -0
  88. package/lib/audit-rules/audit-rules-paths.yml +92 -0
  89. package/lib/audit-rules/audit-rules-performance.yml +207 -0
  90. package/lib/audit-rules/audit-rules-php.yml +22 -0
  91. package/lib/audit-rules/audit-rules-private.yml +24 -0
  92. package/lib/audit-rules/audit-rules-python.yml +106 -0
  93. package/lib/audit-rules/audit-rules-robustness.yml +27 -0
  94. package/lib/audit-rules/audit-rules-rust.yml +22 -0
  95. package/lib/audit-rules/audit-rules-structure.yml +159 -0
  96. package/lib/audit-rules/audit-rules-swift.yml +22 -0
  97. package/lib/audit-rules/audit-rules-template.yml +108 -0
  98. package/lib/checks/button-bind.js +276 -0
  99. package/lib/checks/common.js +170 -0
  100. package/lib/checks/credential-file.js +43 -0
  101. package/lib/checks/dataflow.js +40 -0
  102. package/lib/checks/dispatch.js +112 -0
  103. package/lib/checks/dup-code.js +69 -0
  104. package/lib/checks/dup-const.js +232 -0
  105. package/lib/checks/file-health.js +150 -0
  106. package/lib/checks/filter.js +131 -0
  107. package/lib/checks/folder.js +173 -0
  108. package/lib/checks/hardcoded-path.js +98 -0
  109. package/lib/checks/index.js +46 -0
  110. package/lib/checks/io.js +66 -0
  111. package/lib/checks/magic-number.js +42 -0
  112. package/lib/checks/npm-json.js +273 -0
  113. package/lib/checks/private.js +63 -0
  114. package/lib/checks/regex.js +256 -0
  115. package/lib/checks/semantic.js +134 -0
  116. package/lib/checks/structural.js +274 -0
  117. package/lib/cli/commands-account.mjs +107 -0
  118. package/lib/cli/commands-audit.mjs +144 -0
  119. package/lib/cli/commands-doc.mjs +127 -0
  120. package/lib/cli/commands-vcs.mjs +175 -0
  121. package/lib/client/index.js +162 -0
  122. package/lib/client-parts/00-loader.js +33 -0
  123. package/lib/client-parts/01-const.js +207 -0
  124. package/lib/client-parts/02-utils.js +62 -0
  125. package/lib/client-parts/03-icons.js +12 -0
  126. package/lib/client-parts/10-account.js +83 -0
  127. package/lib/client-parts/11-browser.js +95 -0
  128. package/lib/client-parts/20-repo.js +374 -0
  129. package/lib/client-parts/21-audit.js +301 -0
  130. package/lib/client-parts/22-settings.js +146 -0
  131. package/lib/client-parts/23-npm.js +383 -0
  132. package/lib/client-parts/30-page.js +56 -0
  133. package/lib/client-parts/40-controller.js +1092 -0
  134. package/lib/client-parts/41-actions.js +279 -0
  135. package/lib/client-parts/99-apply.js +72 -0
  136. package/lib/client.js +3195 -0
  137. package/lib/commit-push.js +144 -0
  138. package/lib/context/index.js +363 -0
  139. package/lib/core/atomic-json.js +98 -0
  140. package/lib/core/config.js +40 -0
  141. package/lib/core/credentials.js +274 -0
  142. package/lib/core/endpoints.js +109 -0
  143. package/lib/core/exec.js +162 -0
  144. package/lib/exempt/index.js +292 -0
  145. package/lib/fs/edit-after-read.js +103 -0
  146. package/lib/fsx.js +87 -0
  147. package/lib/git/account-status.js +140 -0
  148. package/lib/git/account.js +233 -0
  149. package/lib/git/api.js +136 -0
  150. package/lib/git/atomic-json.js +6 -0
  151. package/lib/git/browse.js +38 -0
  152. package/lib/git/clone-download.js +397 -0
  153. package/lib/git/clone-history-mode.js +143 -0
  154. package/lib/git/clone-history.js +175 -0
  155. package/lib/git/clone-jobs.js +250 -0
  156. package/lib/git/clone-replay-io.js +172 -0
  157. package/lib/git/clone-replay.js +275 -0
  158. package/lib/git/clone.js +445 -0
  159. package/lib/git/cloud.js +46 -0
  160. package/lib/git/commit-message.js +141 -0
  161. package/lib/git/config.js +6 -0
  162. package/lib/git/cred-env.js +88 -0
  163. package/lib/git/credentials.js +6 -0
  164. package/lib/git/endpoints.js +6 -0
  165. package/lib/git/exec.js +6 -0
  166. package/lib/git/identity-rewrite.js +297 -0
  167. package/lib/git/identity.js +150 -0
  168. package/lib/git/ignore.js +69 -0
  169. package/lib/git/index.js +41 -0
  170. package/lib/git/module-splitter.js +47 -0
  171. package/lib/git/post-push.js +101 -0
  172. package/lib/git/push-diagnose.js +142 -0
  173. package/lib/git/push.js +470 -0
  174. package/lib/git/remote-resolve.js +146 -0
  175. package/lib/git/remote.js +128 -0
  176. package/lib/git/repo-index.js +512 -0
  177. package/lib/git/repos.js +235 -0
  178. package/lib/git/scan-runner.js +159 -0
  179. package/lib/git/sensitive.js +134 -0
  180. package/lib/git/transport.js +430 -0
  181. package/lib/git/visibility.js +35 -0
  182. package/lib/git/wrapped-git.js +68 -0
  183. package/lib/http/index.js +170 -0
  184. package/lib/index.js +24 -0
  185. package/lib/link-check/index.js +187 -0
  186. package/lib/npm/account.js +64 -0
  187. package/lib/npm/install.js +211 -0
  188. package/lib/npm/npmrc.js +56 -0
  189. package/lib/npm/publish.js +167 -0
  190. package/lib/npm/registry.js +147 -0
  191. package/lib/plugin/auto-detect.js +92 -0
  192. package/lib/plugin/auto-push.js +154 -0
  193. package/lib/plugin/index.js +250 -0
  194. package/lib/readme-templates/readme.yml +38 -0
  195. package/lib/rule/compilers/credential.js +62 -0
  196. package/lib/rule/compilers/dataflow.js +38 -0
  197. package/lib/rule/compilers/file-health.js +75 -0
  198. package/lib/rule/compilers/frontend.js +86 -0
  199. package/lib/rule/compilers/func.js +35 -0
  200. package/lib/rule/compilers/helpers.js +71 -0
  201. package/lib/rule/compilers/index.js +29 -0
  202. package/lib/rule/compilers/link-semantic.js +45 -0
  203. package/lib/rule/compilers/list-kinds.js +12 -0
  204. package/lib/rule/compilers/numeric-kinds.js +66 -0
  205. package/lib/rule/compilers/regex.js +78 -0
  206. package/lib/rule/compilers/structure.js +80 -0
  207. package/lib/rule/compilers.js +17 -0
  208. package/lib/rule/homoglyph.js +45 -0
  209. package/lib/rule/loader.js +270 -0
  210. package/lib/rule/registry.js +115 -0
  211. package/lib/rule/scope.js +67 -0
  212. package/lib/score/docs-score.js +166 -0
  213. package/lib/score/index.js +140 -0
  214. package/lib/self/index.js +193 -0
  215. package/lib/skip-dirs.js +64 -0
  216. package/lib/tool-probes.json +50 -0
  217. package/lib/user-requirements.json +14 -0
  218. package/lib/vendor/js-yaml/LICENSE +21 -0
  219. package/lib/vendor/js-yaml/js-yaml.mjs +3073 -0
  220. package/package.json +95 -4
  221. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  222. package/scripts/audit-ext/_example-readme-present.mjs +34 -0
  223. package/scripts/audit-ext/variable-min-length.mjs +102 -0
  224. package/scripts/audit-runner.mjs +35 -0
  225. package/scripts/audit-runtime-check.mjs +129 -0
  226. package/scripts/browser-page-probe.mjs +271 -0
  227. package/scripts/build-client.mjs +119 -0
  228. package/scripts/check.mjs +88 -0
  229. package/scripts/clean-date-comments.py +102 -0
  230. package/scripts/doc-drift.mjs +200 -0
  231. package/scripts/doc-func.mjs +212 -0
  232. package/scripts/doc-tree.mjs +456 -0
  233. package/scripts/doc-version.mjs +220 -0
  234. package/scripts/frontend-preview-check.mjs +124 -0
  235. package/scripts/hot-path-probe-cjs.cjs +71 -0
  236. package/scripts/hot-path-probe-fs-shim.mjs +28 -0
  237. package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
  238. package/scripts/hot-path-probe.mjs +153 -0
  239. package/scripts/module-splitter.py +800 -0
  240. package/scripts/platform-scan.mjs +168 -0
  241. package/scripts/preview-gen.mjs +489 -0
  242. package/scripts/preview-local-runner.mjs +55 -0
  243. package/scripts/preview-server-direct.mjs +116 -0
  244. package/scripts/preview-server.mjs +305 -0
  245. package/scripts/preview-slot-data.mjs +123 -0
  246. package/scripts/probe-recheck.mjs +47 -0
  247. package/scripts/readme-gen.mjs +268 -0
  248. package/scripts/rename-locator.mjs +97 -0
  249. package/scripts/rule-switch.mjs +97 -0
  250. package/scripts/rules-solo-audit.mjs +173 -0
  251. package/scripts/scan-file-io.mjs +713 -0
  252. package/scripts/scan-hardcoded-paths.mjs +125 -0
  253. package/scripts/scan-repos.mjs +167 -0
  254. package/scripts/scan-version.mjs +122 -0
  255. package/scripts/scrub-user-wording.mjs +420 -0
  256. package/scripts/symbol-index.mjs +85 -0
  257. package/scripts/sync-plugin-install.mjs +223 -0
  258. package/scripts/sync-plugin.mjs +279 -0
  259. package/scripts/verify-prestep.mjs +100 -0
  260. package/skills/dev/audit-rule-authoring.md +58 -0
  261. package/skills/dev/dsh-git-push.md +323 -0
  262. package/skills/dev/git-push-live-fix.md +45 -0
  263. package/skills/dsh-repo-index.md +35 -0
  264. package/skills/guide/guide-audit.md +167 -0
  265. package/skills/guide/guide-cli-scripts.md +104 -0
  266. package/skills/guide/guide-clone-repos.md +173 -0
  267. package/skills/guide/guide-commit-push.md +156 -0
  268. package/skills/guide/guide-inject-ui.md +166 -0
  269. package/skills/guide/guide-slash-completion.md +118 -0
  270. package/skills/workflow/README.md +21 -0
  271. package/skills/workflow/git-commit-discipline.md +68 -0
  272. package/skills/workflow/git-project-startup.md +85 -0
  273. package/skills/workflow/git-rebuild-process.md +57 -0
  274. package/skills/workflow/github-operations.md +91 -0
  275. package/skills/workflow/readme-sync-git-md.md +28 -0
  276. package/skills/workflow/task-completion-report.md +73 -0
  277. package/skills/workflow/tool-json-add-ask.md +35 -0
  278. package/skills/workflow/versioning-rule.md +211 -0
@@ -0,0 +1,162 @@
1
+ # dsh 插件专属审计规则(默认加载槽位)
2
+ # 依据:DeepSeek Harness 官方文档(https://deepseekdocs.com/docs/learn/core/plugin-anatomy 等)
3
+ # ① 插件 = cordis 插件 + package.json dsh 字段(dsh.bundle.patch / dsh.client / dsh.profile.bundles)
4
+ # ② capability 安全:依赖必须静态声明(export const inject / static inject),未声明访问被 Proxy 拒绝
5
+ # ③ 装载闭包只含 @deepseek-ai/* scoped 包;裸名 cordis/schemastery 解析失败
6
+ # ④ 工具契约:output.render 必填(dsh-tools rc.6 起缺省抛 userRender is not a function)
7
+ # ⑤ cordis.patch.yml 顶层数组:insert 或按 id 覆盖;config 整行替换非深合并;name 不符 warn 跳过
8
+ # ⑥ Client 半部:exports["./client"] + dsh.client 声明,懒 CJS 模块表
9
+ # 适用:dsh 插件项目(含 dsh-git-push 自身)——非插件项目命中率低,成本可忽略。
10
+ # 引擎约束:styleRules regex 逐行扫描新增行,因此全部规则设计为「单行命中即违规」的正向模式;
11
+ # 跨行/缺失类检查(如 inject 缺声明、output 缺 render)请用 code_audit 的 LLM 深度审查兜底。
12
+ metadata:
13
+ name: "dsh 插件专属审计规则集"
14
+ author: "EIGHTfs"
15
+ version: "1.0.0"
16
+ description: "针对 DeepSeek Harness 插件(cordis 形态)的结构、依赖、工具契约、patch 语义审计;单行正则可执行"
17
+
18
+ rules:
19
+ # ── ① 依赖与导入(文档:装载闭包只含 @deepseek-ai/*)──
20
+ - id: dsh/import-bare-cordis
21
+ name: "禁止裸名导入 cordis"
22
+ category: "dsh"
23
+ severity: "error"
24
+ description: "必须 import from '@deepseek-ai/cordis'(框架被 vendor 化只发布为 @deepseek-ai/* scoped 包);裸名 cordis 在新 loader 装载闭包中解析失败"
25
+ patterns:
26
+ - "import\\s+.*?\\s+from\\s+['\"]cordis['\"]"
27
+ - "require\\s*\\(\\s*['\"]cordis['\"]\\s*\\)"
28
+ fixable: true
29
+ mitigation: "改为 import ... from '@deepseek-ai/cordis';若已依赖裸名 cordis 需在插件目录自身安装该依赖"
30
+ - id: dsh/import-bare-schemastery
31
+ name: "禁止裸名导入 schemastery"
32
+ category: "dsh"
33
+ severity: "error"
34
+ description: "配置 schema 必须 z from '@deepseek-ai/schemastery';裸名 schemastery 解析失败"
35
+ patterns:
36
+ - "import\\s+.*?\\s+from\\s+['\"]schemastery['\"]"
37
+ - "require\\s*\\(\\s*['\"]schemastery['\"]\\s*\\)"
38
+ fixable: true
39
+ mitigation: "改为 import z from '@deepseek-ai/schemastery'"
40
+
41
+ # ── ② 工具契约:output.render 空实现/缺失等价(dsh-tools 契约)──
42
+ - id: dsh/tool-render-empty-body
43
+ name: "工具 render 空实现(返回 null/undefined/空体)"
44
+ category: "dsh"
45
+ severity: "error"
46
+ description: "dsh-tools 契约要求 render 返回内容块数组;空实现/返回 null 使工具结果无法回显(等效缺失)"
47
+ patterns:
48
+ - "render\\s*\\([^)]*\\)\\s*\\{\\s*\\}"
49
+ - "render\\s*\\([^)]*\\)\\s*\\{\\s*return\\s+null\\s*;?\\s*\\}"
50
+ - "render\\s*\\([^)]*\\)\\s*\\{\\s*return\\s+undefined\\s*;?\\s*\\}"
51
+ fixable: false
52
+ mitigation: "render(_args, value) { return [{ type: 'text', text: String(value) }] }"
53
+ - id: dsh/client-node-builtin-require
54
+ name: "Client 半部 require Node 内置模块"
55
+ category: "dsh"
56
+ severity: "error"
57
+ description: "浏览器 client 半部无 Node 运行时;require('fs'/'path'/'os'/'child_process'/'net'/'http'(无 window)) 必然运行失败"
58
+ patterns:
59
+ - "require\\s*\\(\\s*['\"](?:node:)?(?:fs|path|os|child_process|net|dgram|tls|http|https|worker_threads|cluster)['\"]\\s*\\)"
60
+ # 2026-09-13 误报修复:本规则只查浏览器侧代码(crx/、client/、public/ 等)。
61
+ # 纯正则无法区分 server/ 与 client/ 目录(exts 只按扩展名),漏掉会误伤 Node 后端
62
+ # require('fs'/'path') 等正常用法——exclude_paths 声明排除 Node 侧目录,
63
+ # 引擎按 relPath 前缀过滤(见 lib/audit/checks.js filterRulesByExt + runChecks)。
64
+ # 补充:crx/native-host/ 是浏览器扩展的 Node 原生宿主(host 半部),require 正常;
65
+ # exts 限 JS 类排除 .sh/.py 等非 JS 文件(start.sh 内嵌 node -e 的 require 也正常)。
66
+ # 2026-09-20 误报修复(根目录 Node 构建脚本):
67
+ # · exts 去掉 cjs——`.cjs` 是 CommonJS/Node 专属模块格式,浏览器 client 半部不可能
68
+ # 是 .cjs 文件(浏览器只加载 .js/.mjs/.ts 编译产物),根目录构建脚本(build.cjs
69
+ # /webpack.config.cjs 等)的 require('fs') 属正常 Node 用法,不再误报;
70
+ # · exclude_paths 补根级 Node 构建/配置脚本文件名前缀(build./gulpfile/webpack.config/
71
+ # rollup.config/vite.config/tsup.config/eslint.config/jest.config/babel.config 等)——
72
+ # 这类工具脚本与配置文件放仓库根、require Node 内置模块是常态,同样不该被当 client。
73
+ exts: ["js", "mjs", "ts", "tsx", "jsx"]
74
+ exclude_paths:
75
+ - "server/"
76
+ - "test/"
77
+ - "tests/"
78
+ - "scripts/"
79
+ - "tool/"
80
+ - "tools/"
81
+ - "lib/"
82
+ - "utils/"
83
+ - "crx/native-host/"
84
+ - "build."
85
+ - "gulpfile"
86
+ - "gruntfile"
87
+ - "webpack.config"
88
+ - "rollup.config"
89
+ - "vite.config"
90
+ - "tsup.config"
91
+ - "eslint.config"
92
+ - "jest.config"
93
+ - "babel.config"
94
+ - "cli.js"
95
+ - "cli.mjs"
96
+ fixable: false
97
+ mitigation: "浏览器侧改用 fetch/WebSocket/indexedDB 等 web API;Node 侧能力留在 host 半部经 RPC 暴露"
98
+
99
+ # ── ③ 配置 schema:凭据字段应 role('secret')(落盘脱敏)──
100
+ - id: dsh/schema-secret-field-role
101
+ name: "配置凭据字段未标注 role('secret')"
102
+ category: "dsh"
103
+ severity: "warning"
104
+ description: "配置 schema 中的 token/secret/apiKey/password 字段应 z.string().role('secret'),凭据才不进 settings 明文/日志;缺 role 有泄露风险"
105
+ patterns:
106
+ - "(?:token|secret|apiKey|password|credential)[A-Za-z0-9_]*\\s*:\\s*z\\.string\\(\\)(?!\\s*\\.\\s*role)"
107
+ fixable: true
108
+ mitigation: "改为 z.string().role('secret');凭据值落插件配置目录(0600),不回写 settings.yaml"
109
+
110
+ # ── ④ patch 语义(cordis.patch.yml):insert 与按 id 覆盖冲突 ──
111
+ - id: dsh/patch-insert-unique-id
112
+ name: "patch insert 行 id 应与被覆盖行区分"
113
+ category: "dsh"
114
+ severity: "warning"
115
+ kind: "patch-insert"
116
+ description: "cordis.patch.yml 中 insert 新建的行若与后续按 id 覆盖行同 id 会 duplicate-id 双挂;insert 行 id 应唯一(除非刻意二次配置,需确认覆盖语义)"
117
+ exts: ["yml", "yaml"]
118
+ fixable: false
119
+ mitigation: "insert 行与按 id 覆盖行避免同 id;核对 dsh web --dump-config 组合树"
120
+
121
+ # ── ⑤ 结构红线:Client 半部入口规范 ──
122
+ - id: dsh/client-module-loader-id
123
+ name: "Client 半部入口应使用统一 ModuleLoader 契约"
124
+ category: "dsh"
125
+ severity: "warning"
126
+ description: "client 半部应通过 window.__ModuleLoader__.load({ id, factory (模块表) }) 注册懒加载入口;直接顶层副作用写法不生效"
127
+ patterns:
128
+ - "window\\.__ModuleLoader__\\.load\\s*\\([^)]{0,80}"
129
+ fixable: false
130
+ mitigation: "window.__ModuleLoader__.load({ id: '<pkg>', factory: (require) => ({ apply }) })"
131
+
132
+ # ── ⑥ 插件运行时铁律(来源:2026-10-10 dsh-file-path-tracker 真实事故,两条都实测触发过)──
133
+ # 事故链 A:读 ctx.sessionId ⇒ 事件处理器抛 inject 错 ⇒ tools/pre-execute 每次工具调用都触发
134
+ # ⇒ 宿主**所有工具**全部失败(现场:任何工具都返回 cannot get property "sessionId" without inject)。
135
+ # 事故链 B:HTTP 路由用猜测 API 兜底链(x.addRoute || x.route || x.use)+ 静默 return
136
+ # ⇒ 路由从未注册、页面一直 404,却没有任何报错(靠查反代日志才发现)。
137
+ # 说明:只收「与 DSH 插件强关联」且**单行可判定**的两条;部署卫生类检查(local-plugins 里混入
138
+ # 备份目录、profile patch 内同一 loader id 重复)不是单行内容匹配,属脚本层检查,见 SPEC 待办。
139
+ - id: dsh/ctx-undeclared-property-read
140
+ name: "读 ctx 上未注入的属性(cordis 严格代理会抛,可打挂宿主全部工具)"
141
+ category: "dsh"
142
+ severity: "blocker"
143
+ description: "cordis 的 Context 是严格代理:访问未声明/未注入的属性直接抛 cannot get property \"<name>\" without inject。事件处理器(尤其 tools/pre-execute 这类每次工具调用都触发的事件)里抛错会把宿主所有工具调用打挂。下面列的是实测致命且**不是** cordis 服务的标识字段。"
144
+ exts: ["js", "mjs", "cjs", "ts", "mts", "cts"]
145
+ # 引擎只在 blacklist 式规则上应用 whitelist(纯 patterns 规则不吃白名单),故这里用 blacklist。
146
+ blacklist:
147
+ - pattern: "ctx\\.(sessionId|sessionID|conversationId|agentId|workspaceRoot|dshHome|DSH_HOME)\\b"
148
+ # 注释里**提到**这些字段名属正常(本项目就在注释里写明这条铁律),整行豁免,避免自我误报。
149
+ whitelist:
150
+ - pattern: "^\\s*(?://|\\*|/\\*)"
151
+ fixable: true
152
+ mitigation: "从事件负载取,或 ctx.get('<已在 inject 里声明的服务>') 取;取不到用空值兜底,绝不假定 ctx 上有该字段;事件回调整体包 try/catch 作纵深防御"
153
+ - id: dsh/host-api-guessed-fallback-chain
154
+ name: "猜宿主 API 的兜底链(A || B || C)"
155
+ category: "dsh"
156
+ severity: "error"
157
+ description: "注册/接线代码里用 x.addRoute || x.route || x.use 这类**猜测**的 API 兜底链;真实 API 不匹配时静默 return ⇒ 功能整体失效却没有任何报错(实测:HTTP 路由从未注册,页面一直 404,直到查反代日志才发现)。DSH 宿主真实 API 形如 webServer.register({ kind:'prefix', path, handler })。"
158
+ exts: ["js", "mjs", "cjs", "ts", "mts", "cts"]
159
+ patterns:
160
+ - "\\b(addRoute|addHandler|registerRoute|useRoute)\\s*\\|\\|"
161
+ fixable: true
162
+ mitigation: "按官方真实 API 写(webServer.register({ kind:'prefix', path, handler }));接线失败必须 return false 并告警,不得静默吞掉"
@@ -0,0 +1,42 @@
1
+ # ============================================================
2
+ # 文件健康度矩阵评分规则集
3
+ # 作者:DeepSeek
4
+ # 版本:1.0.0
5
+ # 适用:所有源代码文件(豁免见下)
6
+ # 描述:行数 + 大小 + 行长 三维独立分级,矩阵组合后扣分
7
+ # 最后更新:2026-09-12
8
+ # 算法来源:用户提供《文件健康度矩阵评分算法》1.0.0
9
+ # ============================================================
10
+
11
+ metadata:
12
+ name: "文件健康度矩阵评分规则集"
13
+ version: "1.0.0"
14
+ author: "DeepSeek"
15
+ description: "单文件健康度评估(行数40% + 大小35% + 行长25%),score<9 提示、<5 blocker"
16
+ last_updated: "2026-09-12"
17
+
18
+ rules:
19
+ # ----- 文件健康度矩阵评分(kind: file-health) -----
20
+ - id: maintainability/file-health
21
+ name: "文件健康度矩阵评分(行数/大小/行长三维)"
22
+ category: "maintainability"
23
+ kind: "file-health"
24
+ severity: "warning"
25
+ # 只对代码文件评健康度(2026-09-13):md/txt 等文档的「行数/行长」不是代码健康问题
26
+ #(README 表格行天然超长、文档天然几百行),不声明 exts 时会对文档误报。
27
+ exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx", "py", "go", "rs", "java", "kt", "swift", "php", "rb", "sh", "bash"]
28
+ description: "按文件健康度矩阵算法评估:三维独立分级(行数≤200/400/800/1500;大小KB≤30/100/300/1000;行长≤120/200/300/500),加权等级=行数×0.40+大小×0.35+行长×0.25,按扣分表(0/1.0/2.5/4.5/7.0)线性插值,score=max(0.1, 10-penalty);score≥9 健康,<9 提示拆分,<5 blocker。豁免:*.generated.* / *.min.* / locales/ 整文件跳过;constants/ 行数豁免(大小/行长仍评);routes/ 行数阈值放宽"
29
+ dimensions:
30
+ - 可维护性
31
+ - 可读性
32
+ # 参数(缺省即内置默认值;可按需覆盖)
33
+ # weight_lines: 0.40
34
+ # weight_size: 0.35
35
+ # weight_line_length: 0.25
36
+ # base_score: 10
37
+ # lines_levels: [200, 400, 800, 1500]
38
+ # size_levels: [30, 100, 300, 1000]
39
+ # line_length_levels: [120, 200, 300, 500]
40
+ # level_penalties: [0, 1.0, 2.5, 4.5, 7.0]
41
+ # warn_score: 9
42
+ # block_score: 5
@@ -0,0 +1,99 @@
1
+ # dsh-skip-sensitive: 规则定义文件含符号示范文本(package/ dist/ 等非真实数据)
2
+ # dsh-skip-residue: 规则定义文件含 debugger/console 模式串示范(规则定义本身)
3
+ # dsh-git-push 审计规则(folder 槽位,1.0.3)
4
+ # 目录级审计规则:由 checkFolderRules 在 auditFull 目录层消费(非文件行级)。
5
+ # 字段:threshold / exclude_dirs / signatures / required_patterns 由 folder 编译函数认领。
6
+ metadata:
7
+ name: "文件夹数量审计规则(防止解包/依赖/构建产物入库)"
8
+ version: "1.0.1"
9
+
10
+ rules:
11
+ # ----- 规则 1:目录总数异常(正常项目源码目录 ≤ 30)-----
12
+ - id: folder/total-count
13
+ name: "项目源码目录总数异常"
14
+ category: "folder"
15
+ severity: "warning"
16
+ description: "正常项目源码目录(不含 node_modules/.git/dist 等)应 ≤ 30 个,超过可能是解包产物混入"
17
+ threshold: 30
18
+ # 排除项在遍历时剪枝(不含其子目录)——见 lib/checks/folder.js 的 excludedNames。
19
+ # .trash:安全删除约定的回收站(gitignore),是回收站不是源码,计入会虚增目录数。
20
+ # ⚠️ 工程/资源目录(gradle/docs/res 等)不在此列:exclude_dirs 会被 collector 的
21
+ # SKIP_DIRS 消费(loadYamlBlacklistDirs)→ 全局跳过审计。工程目录的 total-count
22
+ # 排除在 folder.js 按名称过滤(只影响计数,不影响 collector 遍历)。
23
+ exclude_dirs:
24
+ # 客户端分片目录(C8:分片源码 → 构建拼接成 lib/client.js):分片是同一个客户端入口的
25
+ # 组成部分,与产物一起算**一个**逻辑模块 ⇒ 不计入目录类计数,否则恒定多报 1 个。
26
+ - "client-parts"
27
+ - "node_modules"
28
+ - "node_modules.orig"
29
+ - ".git"
30
+ - ".svn"
31
+ - "dist"
32
+ - "build"
33
+ - "out"
34
+ - "coverage"
35
+ - "__pycache__"
36
+ - ".next"
37
+ - ".nuxt"
38
+ - "vendor"
39
+ - ".dsh"
40
+ - ".trash"
41
+ message: "项目源码目录数 {count} 超过阈值 {threshold},可能混入解包产物"
42
+
43
+ # ----- 规则 2:单目录文件数量异常(> 500 极可能是依赖/解包)-----
44
+ - id: folder/file-count-per-dir
45
+ name: "单目录文件数量异常"
46
+ category: "folder"
47
+ severity: "warning"
48
+ description: "单个目录下文件数量 > 500,极可能是解包产物或依赖目录"
49
+ threshold: 500
50
+ exclude_dirs:
51
+ # 客户端分片目录(C8:分片源码 → 构建拼接成 lib/client.js):分片是同一个客户端入口的
52
+ # 组成部分,与产物一起算**一个**逻辑模块 ⇒ 不计入目录类计数,否则恒定多报 1 个。
53
+ - "client-parts"
54
+ - "node_modules"
55
+ - ".git"
56
+ - "dist"
57
+ - "build"
58
+ - "out"
59
+ - "coverage"
60
+ - "__pycache__"
61
+ - ".dsh"
62
+ - ".trash"
63
+ message: "目录 {path} 包含 {count} 个文件,超过阈值 {threshold},疑似解包产物"
64
+
65
+ # ----- 规则 3:解包产物特征目录(package/package.json、dist/、build/、.tgz 等)-----
66
+ - id: folder/unpacked-artifact-signature
67
+ name: "检测解包产物特征目录"
68
+ category: "folder"
69
+ severity: "error"
70
+ description: "检测 tar 解包后的典型目录结构(package/ + package.json、dist/、build/、临时构建目录)"
71
+ signatures:
72
+ - pattern: "package/package.json"
73
+ message: "检测到 tar 解包产物:package/ 子目录含 package.json"
74
+ - pattern: "dist/**"
75
+ message: "检测到构建产物目录 dist/ 被提交"
76
+ - pattern: "build/**"
77
+ message: "检测到构建产物目录 build/ 被提交"
78
+ - pattern: "**/.tmp-build/**"
79
+ message: "检测到临时构建目录 .tmp-build/ 被提交"
80
+
81
+ # ----- 规则 4:.gitignore 未覆盖常见产物目录 -----
82
+ - id: folder/gitignore-missing-artifacts
83
+ name: ".gitignore 未覆盖产物目录"
84
+ category: "folder"
85
+ severity: "warning"
86
+ description: "常见产物目录(node_modules/dist/build/coverage 等)应出现在 .gitignore 中"
87
+ required_patterns:
88
+ - "node_modules"
89
+ - "dist"
90
+ - "build"
91
+ - "coverage"
92
+ - "*.log"
93
+ - ".env"
94
+ message: ".gitignore 中缺少必要忽略项:{missing}"
95
+
96
+ # 规则 5/6(folder/cd-to-maybe-missing、folder/write-into-gitignored-dir)已于 2026-10-11
97
+ # **迁移到 lib/audit-rules/audit-rules-paths.yml**(路径类规则集中一处,避免同一检测两处实现)。
98
+ # 规则 id 与 astConfirmKind 未变 ⇒ 精筛实现(lib/ast/shell.js 的 shell-cd-dynamic /
99
+ # write-into-gitignored)无需改动;此处不再保留副本。
@@ -0,0 +1,335 @@
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: "确认是否需要绑定;事件委托/封装函数绑定请加豁免标记"
248
+
249
+ - id: button/create-element-binding
250
+ name: "createElement 创建的按钮应显式绑定"
251
+ category: "button"
252
+ severity: "warning"
253
+ description: "用 createElement('button'/'input') 创建按钮但同文件无 addEventListener/onclick 绑定痕迹,则为未绑定"
254
+ fixable: false
255
+ mitigation: "在 appendChild 前调用 btn.addEventListener('click', fn)"
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
@@ -0,0 +1,22 @@
1
+ # ============================================================
2
+ # Go 代码审计规则集(占位)
3
+ # 版本:0.1.0
4
+ # 适用:Go 项目
5
+ # 描述:⚠️ 占位槽位——语言专项规则待补。放入此文件即完成「槽位就绪」:
6
+ # 审计系统自动发现本槽位(放 audit-rules-*.yml 即生效,零代码改动)。
7
+ # 当前 Go 文件由 nodejs 槽位的语言无关规则(凭据/路径穿越/文件健康度等)兜底审计,
8
+ # 语言相关规则(短名/魔数/函数长度/复杂度/嵌套)待补 AST 层 goFuncRanges 后启用。
9
+ # 待办(补规则时):① AST 层 lang.js 的 LANG_FUNC_RANGES.go 实现函数范围收集
10
+ # (func 关键字 + 花括号配对);② 本槽位按 python/java 先例写 min_length/
11
+ # max_depth/max_lines/max_complexity/magic-number 规则,exts: ["go"]。
12
+ # ============================================================
13
+
14
+ metadata:
15
+ name: "Go 审计规则集(占位)"
16
+ version: "0.1.0"
17
+ language: "go"
18
+ author: "DeepSeek"
19
+ description: "Go 项目语言专用规则(占位——规则待补,槽位已就绪)"
20
+ last_updated: "2026-10-06"
21
+
22
+ rules: []