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.
- package/.auditignore +30 -0
- package/.gitignore +39 -0
- package/LICENSE +21 -0
- package/README.md +1482 -2
- package/cli.mjs +360 -0
- package/cordis.patch.yml +14 -0
- package/lib/ARCHITECTURE.md +34 -0
- package/lib/BUGFIX-NOTES-2026-09-14.md +278 -0
- package/lib/app/apply.js +275 -0
- package/lib/app/audit-api.js +158 -0
- package/lib/app/command-registry.js +262 -0
- package/lib/app/constants.js +16 -0
- package/lib/app/handlers/account.js +166 -0
- package/lib/app/handlers/clone.js +168 -0
- package/lib/app/handlers/http-constants.js +9 -0
- package/lib/app/handlers/identity-rewrite.js +94 -0
- package/lib/app/handlers/meta.js +175 -0
- package/lib/app/handlers/npm.js +169 -0
- package/lib/app/handlers/repo-actions.js +143 -0
- package/lib/app/handlers/repos.js +231 -0
- package/lib/app/handlers/settings.js +62 -0
- package/lib/app/host-doc-checks.js +25 -0
- package/lib/app/http-handlers.js +131 -0
- package/lib/app/index.js +30 -0
- package/lib/app/inject-text.js +191 -0
- package/lib/app/scan-root.js +23 -0
- package/lib/app/schema.js +150 -0
- package/lib/app/settings-bridge.js +167 -0
- package/lib/app/slash-commands.js +395 -0
- package/lib/app/slot-stats.js +35 -0
- package/lib/app/tool-call.js +662 -0
- package/lib/app/tools.js +40 -0
- package/lib/ast/brace.js +105 -0
- package/lib/ast/callgraph.js +135 -0
- package/lib/ast/code-lines.js +114 -0
- package/lib/ast/consts.js +12 -0
- package/lib/ast/control-flow.js +461 -0
- package/lib/ast/credential.js +199 -0
- package/lib/ast/dataflow.js +274 -0
- package/lib/ast/dup-code.js +165 -0
- package/lib/ast/index.js +36 -0
- package/lib/ast/io-risk-const.js +95 -0
- package/lib/ast/io-risk-fn.js +208 -0
- package/lib/ast/io-risk-loop.js +308 -0
- package/lib/ast/io-risk.js +314 -0
- package/lib/ast/lang.js +156 -0
- package/lib/ast/line-count.js +52 -0
- package/lib/ast/magic-number.js +272 -0
- package/lib/ast/naming.js +284 -0
- package/lib/ast/perf.js +472 -0
- package/lib/ast/scope.js +241 -0
- package/lib/ast/shell.js +131 -0
- package/lib/ast/size.js +378 -0
- package/lib/ast/symbol-index.js +399 -0
- package/lib/ast/tokenizer.js +341 -0
- package/lib/audit/analysis-coverage.js +98 -0
- package/lib/audit/audit-file.js +182 -0
- package/lib/audit/checks.js +17 -0
- package/lib/audit/client-entry.js +93 -0
- package/lib/audit/collector.js +477 -0
- package/lib/audit/ext-runner.js +80 -0
- package/lib/audit/file-context.js +138 -0
- package/lib/audit/finding.js +50 -0
- package/lib/audit/gitignore-match.js +113 -0
- package/lib/audit/glob.js +63 -0
- package/lib/audit/history-report.js +100 -0
- package/lib/audit/history.js +126 -0
- package/lib/audit/ignore-blind.js +101 -0
- package/lib/audit/index.js +33 -0
- package/lib/audit/orchestrate.js +476 -0
- package/lib/audit/public.js +24 -0
- package/lib/audit/repo-level.js +30 -0
- package/lib/audit/report-yaml.js +86 -0
- package/lib/audit/slot.js +65 -0
- package/lib/audit-defaults.js +18 -0
- package/lib/audit-rules/audit-rules-comment.yml +247 -0
- package/lib/audit-rules/audit-rules-cpp.yml +22 -0
- package/lib/audit-rules/audit-rules-docs.yml +32 -0
- package/lib/audit-rules/audit-rules-dsh.yml +162 -0
- package/lib/audit-rules/audit-rules-filehealth.yml +42 -0
- package/lib/audit-rules/audit-rules-folder.yml +99 -0
- package/lib/audit-rules/audit-rules-frontend.yml +335 -0
- package/lib/audit-rules/audit-rules-go.yml +22 -0
- package/lib/audit-rules/audit-rules-i18n.yml +45 -0
- package/lib/audit-rules/audit-rules-java.yml +105 -0
- package/lib/audit-rules/audit-rules-nodejs.yml +647 -0
- package/lib/audit-rules/audit-rules-npm.yml +187 -0
- package/lib/audit-rules/audit-rules-paths.yml +92 -0
- package/lib/audit-rules/audit-rules-performance.yml +207 -0
- package/lib/audit-rules/audit-rules-php.yml +22 -0
- package/lib/audit-rules/audit-rules-private.yml +24 -0
- package/lib/audit-rules/audit-rules-python.yml +106 -0
- package/lib/audit-rules/audit-rules-robustness.yml +27 -0
- package/lib/audit-rules/audit-rules-rust.yml +22 -0
- package/lib/audit-rules/audit-rules-structure.yml +159 -0
- package/lib/audit-rules/audit-rules-swift.yml +22 -0
- package/lib/audit-rules/audit-rules-template.yml +108 -0
- package/lib/checks/button-bind.js +276 -0
- package/lib/checks/common.js +170 -0
- package/lib/checks/credential-file.js +43 -0
- package/lib/checks/dataflow.js +40 -0
- package/lib/checks/dispatch.js +112 -0
- package/lib/checks/dup-code.js +69 -0
- package/lib/checks/dup-const.js +232 -0
- package/lib/checks/file-health.js +150 -0
- package/lib/checks/filter.js +131 -0
- package/lib/checks/folder.js +173 -0
- package/lib/checks/hardcoded-path.js +98 -0
- package/lib/checks/index.js +46 -0
- package/lib/checks/io.js +66 -0
- package/lib/checks/magic-number.js +42 -0
- package/lib/checks/npm-json.js +273 -0
- package/lib/checks/private.js +63 -0
- package/lib/checks/regex.js +256 -0
- package/lib/checks/semantic.js +134 -0
- package/lib/checks/structural.js +274 -0
- package/lib/cli/commands-account.mjs +107 -0
- package/lib/cli/commands-audit.mjs +144 -0
- package/lib/cli/commands-doc.mjs +127 -0
- package/lib/cli/commands-vcs.mjs +175 -0
- package/lib/client/index.js +162 -0
- package/lib/client-parts/00-loader.js +33 -0
- package/lib/client-parts/01-const.js +207 -0
- package/lib/client-parts/02-utils.js +62 -0
- package/lib/client-parts/03-icons.js +12 -0
- package/lib/client-parts/10-account.js +83 -0
- package/lib/client-parts/11-browser.js +95 -0
- package/lib/client-parts/20-repo.js +374 -0
- package/lib/client-parts/21-audit.js +301 -0
- package/lib/client-parts/22-settings.js +146 -0
- package/lib/client-parts/23-npm.js +383 -0
- package/lib/client-parts/30-page.js +56 -0
- package/lib/client-parts/40-controller.js +1092 -0
- package/lib/client-parts/41-actions.js +279 -0
- package/lib/client-parts/99-apply.js +72 -0
- package/lib/client.js +3195 -0
- package/lib/commit-push.js +144 -0
- package/lib/context/index.js +363 -0
- package/lib/core/atomic-json.js +98 -0
- package/lib/core/config.js +40 -0
- package/lib/core/credentials.js +274 -0
- package/lib/core/endpoints.js +109 -0
- package/lib/core/exec.js +162 -0
- package/lib/exempt/index.js +292 -0
- package/lib/fs/edit-after-read.js +103 -0
- package/lib/fsx.js +87 -0
- package/lib/git/account-status.js +140 -0
- package/lib/git/account.js +233 -0
- package/lib/git/api.js +136 -0
- package/lib/git/atomic-json.js +6 -0
- package/lib/git/browse.js +38 -0
- package/lib/git/clone-download.js +397 -0
- package/lib/git/clone-history-mode.js +143 -0
- package/lib/git/clone-history.js +175 -0
- package/lib/git/clone-jobs.js +250 -0
- package/lib/git/clone-replay-io.js +172 -0
- package/lib/git/clone-replay.js +275 -0
- package/lib/git/clone.js +445 -0
- package/lib/git/cloud.js +46 -0
- package/lib/git/commit-message.js +141 -0
- package/lib/git/config.js +6 -0
- package/lib/git/cred-env.js +88 -0
- package/lib/git/credentials.js +6 -0
- package/lib/git/endpoints.js +6 -0
- package/lib/git/exec.js +6 -0
- package/lib/git/identity-rewrite.js +297 -0
- package/lib/git/identity.js +150 -0
- package/lib/git/ignore.js +69 -0
- package/lib/git/index.js +41 -0
- package/lib/git/module-splitter.js +47 -0
- package/lib/git/post-push.js +101 -0
- package/lib/git/push-diagnose.js +142 -0
- package/lib/git/push.js +470 -0
- package/lib/git/remote-resolve.js +146 -0
- package/lib/git/remote.js +128 -0
- package/lib/git/repo-index.js +512 -0
- package/lib/git/repos.js +235 -0
- package/lib/git/scan-runner.js +159 -0
- package/lib/git/sensitive.js +134 -0
- package/lib/git/transport.js +430 -0
- package/lib/git/visibility.js +35 -0
- package/lib/git/wrapped-git.js +68 -0
- package/lib/http/index.js +170 -0
- package/lib/index.js +24 -0
- package/lib/link-check/index.js +187 -0
- package/lib/npm/account.js +64 -0
- package/lib/npm/install.js +211 -0
- package/lib/npm/npmrc.js +56 -0
- package/lib/npm/publish.js +167 -0
- package/lib/npm/registry.js +147 -0
- package/lib/plugin/auto-detect.js +92 -0
- package/lib/plugin/auto-push.js +154 -0
- package/lib/plugin/index.js +250 -0
- package/lib/readme-templates/readme.yml +38 -0
- package/lib/rule/compilers/credential.js +62 -0
- package/lib/rule/compilers/dataflow.js +38 -0
- package/lib/rule/compilers/file-health.js +75 -0
- package/lib/rule/compilers/frontend.js +86 -0
- package/lib/rule/compilers/func.js +35 -0
- package/lib/rule/compilers/helpers.js +71 -0
- package/lib/rule/compilers/index.js +29 -0
- package/lib/rule/compilers/link-semantic.js +45 -0
- package/lib/rule/compilers/list-kinds.js +12 -0
- package/lib/rule/compilers/numeric-kinds.js +66 -0
- package/lib/rule/compilers/regex.js +78 -0
- package/lib/rule/compilers/structure.js +80 -0
- package/lib/rule/compilers.js +17 -0
- package/lib/rule/homoglyph.js +45 -0
- package/lib/rule/loader.js +270 -0
- package/lib/rule/registry.js +115 -0
- package/lib/rule/scope.js +67 -0
- package/lib/score/docs-score.js +166 -0
- package/lib/score/index.js +140 -0
- package/lib/self/index.js +193 -0
- package/lib/skip-dirs.js +64 -0
- package/lib/tool-probes.json +50 -0
- package/lib/user-requirements.json +14 -0
- package/lib/vendor/js-yaml/LICENSE +21 -0
- package/lib/vendor/js-yaml/js-yaml.mjs +3073 -0
- package/package.json +95 -4
- package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
- package/scripts/audit-ext/_example-readme-present.mjs +34 -0
- package/scripts/audit-ext/variable-min-length.mjs +102 -0
- package/scripts/audit-runner.mjs +35 -0
- package/scripts/audit-runtime-check.mjs +129 -0
- package/scripts/browser-page-probe.mjs +271 -0
- package/scripts/build-client.mjs +119 -0
- package/scripts/check.mjs +88 -0
- package/scripts/clean-date-comments.py +102 -0
- package/scripts/doc-drift.mjs +200 -0
- package/scripts/doc-func.mjs +212 -0
- package/scripts/doc-tree.mjs +456 -0
- package/scripts/doc-version.mjs +220 -0
- package/scripts/frontend-preview-check.mjs +124 -0
- package/scripts/hot-path-probe-cjs.cjs +71 -0
- package/scripts/hot-path-probe-fs-shim.mjs +28 -0
- package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
- package/scripts/hot-path-probe.mjs +153 -0
- package/scripts/module-splitter.py +800 -0
- package/scripts/platform-scan.mjs +168 -0
- package/scripts/preview-gen.mjs +489 -0
- package/scripts/preview-local-runner.mjs +55 -0
- package/scripts/preview-server-direct.mjs +116 -0
- package/scripts/preview-server.mjs +305 -0
- package/scripts/preview-slot-data.mjs +123 -0
- package/scripts/probe-recheck.mjs +47 -0
- package/scripts/readme-gen.mjs +268 -0
- package/scripts/rename-locator.mjs +97 -0
- package/scripts/rule-switch.mjs +97 -0
- package/scripts/rules-solo-audit.mjs +173 -0
- package/scripts/scan-file-io.mjs +713 -0
- package/scripts/scan-hardcoded-paths.mjs +125 -0
- package/scripts/scan-repos.mjs +167 -0
- package/scripts/scan-version.mjs +122 -0
- package/scripts/scrub-user-wording.mjs +420 -0
- package/scripts/symbol-index.mjs +85 -0
- package/scripts/sync-plugin-install.mjs +223 -0
- package/scripts/sync-plugin.mjs +279 -0
- package/scripts/verify-prestep.mjs +100 -0
- package/skills/dev/audit-rule-authoring.md +58 -0
- package/skills/dev/dsh-git-push.md +323 -0
- package/skills/dev/git-push-live-fix.md +45 -0
- package/skills/dsh-repo-index.md +35 -0
- package/skills/guide/guide-audit.md +167 -0
- package/skills/guide/guide-cli-scripts.md +104 -0
- package/skills/guide/guide-clone-repos.md +173 -0
- package/skills/guide/guide-commit-push.md +156 -0
- package/skills/guide/guide-inject-ui.md +166 -0
- package/skills/guide/guide-slash-completion.md +118 -0
- package/skills/workflow/README.md +21 -0
- package/skills/workflow/git-commit-discipline.md +68 -0
- package/skills/workflow/git-project-startup.md +85 -0
- package/skills/workflow/git-rebuild-process.md +57 -0
- package/skills/workflow/github-operations.md +91 -0
- package/skills/workflow/readme-sync-git-md.md +28 -0
- package/skills/workflow/task-completion-report.md +73 -0
- package/skills/workflow/tool-json-add-ask.md +35 -0
- 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
|