dsh-git-push 0.0.0-stage → 2.8.6

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 (279) hide show
  1. package/.auditignore +30 -0
  2. package/.gitignore +39 -0
  3. package/LICENSE +21 -0
  4. package/README.md +1486 -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 +266 -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 +192 -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 +672 -0
  32. package/lib/app/tools.js +34 -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 +215 -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 +137 -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 +148 -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 +476 -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 +171 -0
  190. package/lib/npm/registry.js +168 -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 +196 -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/cpu-sample.mjs +188 -0
  231. package/scripts/doc-drift.mjs +200 -0
  232. package/scripts/doc-func.mjs +212 -0
  233. package/scripts/doc-tree.mjs +456 -0
  234. package/scripts/doc-version.mjs +220 -0
  235. package/scripts/frontend-preview-check.mjs +124 -0
  236. package/scripts/hot-path-probe-cjs.cjs +71 -0
  237. package/scripts/hot-path-probe-fs-shim.mjs +28 -0
  238. package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
  239. package/scripts/hot-path-probe.mjs +153 -0
  240. package/scripts/module-splitter.py +800 -0
  241. package/scripts/platform-scan.mjs +168 -0
  242. package/scripts/preview-gen.mjs +489 -0
  243. package/scripts/preview-local-runner.mjs +55 -0
  244. package/scripts/preview-server-direct.mjs +116 -0
  245. package/scripts/preview-server.mjs +305 -0
  246. package/scripts/preview-slot-data.mjs +123 -0
  247. package/scripts/probe-recheck.mjs +47 -0
  248. package/scripts/readme-gen.mjs +268 -0
  249. package/scripts/rename-locator.mjs +97 -0
  250. package/scripts/rule-switch.mjs +97 -0
  251. package/scripts/rules-solo-audit.mjs +173 -0
  252. package/scripts/scan-file-io.mjs +713 -0
  253. package/scripts/scan-hardcoded-paths.mjs +125 -0
  254. package/scripts/scan-repos.mjs +167 -0
  255. package/scripts/scan-version.mjs +122 -0
  256. package/scripts/scrub-user-wording.mjs +420 -0
  257. package/scripts/symbol-index.mjs +85 -0
  258. package/scripts/sync-plugin-install.mjs +223 -0
  259. package/scripts/sync-plugin.mjs +279 -0
  260. package/scripts/verify-prestep.mjs +100 -0
  261. package/skills/dev/audit-rule-authoring.md +58 -0
  262. package/skills/dev/dsh-git-push.md +323 -0
  263. package/skills/dev/git-push-live-fix.md +45 -0
  264. package/skills/dsh-repo-index.md +35 -0
  265. package/skills/guide/guide-audit.md +167 -0
  266. package/skills/guide/guide-cli-scripts.md +104 -0
  267. package/skills/guide/guide-clone-repos.md +173 -0
  268. package/skills/guide/guide-commit-push.md +156 -0
  269. package/skills/guide/guide-inject-ui.md +166 -0
  270. package/skills/guide/guide-slash-completion.md +118 -0
  271. package/skills/workflow/README.md +21 -0
  272. package/skills/workflow/git-commit-discipline.md +68 -0
  273. package/skills/workflow/git-project-startup.md +85 -0
  274. package/skills/workflow/git-rebuild-process.md +57 -0
  275. package/skills/workflow/github-operations.md +91 -0
  276. package/skills/workflow/readme-sync-git-md.md +28 -0
  277. package/skills/workflow/task-completion-report.md +73 -0
  278. package/skills/workflow/tool-json-add-ask.md +35 -0
  279. package/skills/workflow/versioning-rule.md +211 -0
@@ -0,0 +1,45 @@
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 语言包文件"
@@ -0,0 +1,105 @@
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