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,187 @@
|
|
|
1
|
+
# npm 插件发布审计规则(默认加载槽位)
|
|
2
|
+
# 依据:npm 官方 best practices(npm pack 内容判定 / package.json 字段契约)+ 本机 dsh 插件发布经验。
|
|
3
|
+
# 目标文件:package.json / .npmrc —— 通过 exts 字段显式放行(json/npmrc 默认不在 styleCode,
|
|
4
|
+
# styleRules regex 支持 per-rule exts,npm 规则只扫这两个类型,不误伤代码文件)。
|
|
5
|
+
# 语义:全部正则可执行;「缺某个字段」类检查(如缺 license/repository)正则无法表达,
|
|
6
|
+
# 走缺失检测兜底(附 npm doctor / npm publish --dry-run 建议),或由人工在发布前核查。
|
|
7
|
+
metadata:
|
|
8
|
+
name: "npm 插件发布审计规则集"
|
|
9
|
+
author: "EIGHTfs"
|
|
10
|
+
version: "1.0.0"
|
|
11
|
+
description: "针对要发布到 npm 的 dsh 插件:发布清单/依赖声明/凭据防泄漏/publishConfig 语义审计(只扫 package.json + .npmrc)"
|
|
12
|
+
|
|
13
|
+
rules:
|
|
14
|
+
# ── ① package.json 发布清单(files 白名单)──
|
|
15
|
+
- id: npm/files-suspicious-entry
|
|
16
|
+
name: "files 白名单含可疑条目(应核对实际打包路径)"
|
|
17
|
+
category: "npm"
|
|
18
|
+
severity: "warning"
|
|
19
|
+
description: "files 白名单决定 npm pack 打进包的内容;**条目指向不存在的路径**会让包缺运行时文件(如写 audit-rules 而实际是 lib/audit-rules)。引擎结构化判定:逐条核对 files 数组里的路径在仓库中是否存在"
|
|
20
|
+
kind: "npm-json"
|
|
21
|
+
exts: ["json"]
|
|
22
|
+
fixable: false
|
|
23
|
+
mitigation: "npm pack --dry-run 看实际打进包的文件清单;规则目录写完整相对路径(lib/audit-rules)"
|
|
24
|
+
- id: npm/files-missing-lib
|
|
25
|
+
name: "files 白名单可能漏掉 lib(主代码目录)"
|
|
26
|
+
category: "npm"
|
|
27
|
+
severity: "error"
|
|
28
|
+
description: "main/exports 指向 lib/ 下的入口,若 files 未包含 lib 目录,npm pack 包内没有入口文件 → 安装后 import 即失败"
|
|
29
|
+
kind: "npm-json"
|
|
30
|
+
exts: ["json"]
|
|
31
|
+
fixable: false
|
|
32
|
+
mitigation: "files 数组包含 \"lib\"(或列出实际入口文件);npm pack --dry-run 验证"
|
|
33
|
+
- id: npm/exports-without-client
|
|
34
|
+
name: "exports 缺 ./client 子路径(双半插件)"
|
|
35
|
+
category: "npm"
|
|
36
|
+
severity: "warning"
|
|
37
|
+
description: "dsh 双半插件(host+client)应 exports[\"./client\"] 指向 client 入口,宿主才能按子路径解析浏览器半部"
|
|
38
|
+
exts: ["json"]
|
|
39
|
+
patterns:
|
|
40
|
+
- "\"dsh\"\\s*:\\s*\\{[^}]*\"client\""
|
|
41
|
+
fixable: false
|
|
42
|
+
mitigation: "package.json 增加 exports[\"./client\"];与官方 client 插件清单对齐"
|
|
43
|
+
|
|
44
|
+
# ── ② 依赖声明 ──
|
|
45
|
+
- id: npm/dependency-star-range
|
|
46
|
+
name: "依赖版本用 * 通配(未锁定)"
|
|
47
|
+
category: "npm"
|
|
48
|
+
severity: "error"
|
|
49
|
+
description: "dependencies/peerDependencies 用 \"*\" 或 ^0.x 让安装解析到不可控版本;发布插件应锁定可复现的范围(^x.y.z),peer 用符合实际装载的版本"
|
|
50
|
+
# kind: npm-json → 结构化判定(真实解析 package.json,不靠正则命中):
|
|
51
|
+
# ① 只查会随包发布的字段(dependencies/peerDependencies/optionalDependencies),
|
|
52
|
+
# devDependencies 不发布、不在管辖内;
|
|
53
|
+
# ② **private: true 的本地私有插件整体豁免**——私有包不发布、依赖由宿主提供,
|
|
54
|
+
# peer 写 "*" 恰是「由宿主装载」的正确声明;写死版本反而与宿主实际装载版本冲突。
|
|
55
|
+
# 公开包仍严格报 * / x / latest / ^0.x。实现见 checks.js starRangeDeps。
|
|
56
|
+
kind: "npm-json"
|
|
57
|
+
fixable: true
|
|
58
|
+
mitigation: "改为精确范围(如 ^4.1.0);对照实际安装版本(npm ls js-yaml);私有本地插件无需改(本规则已豁免)"
|
|
59
|
+
- id: npm/undeclared-js-yaml
|
|
60
|
+
name: "import 了 js-yaml 但未声明依赖"
|
|
61
|
+
category: "npm"
|
|
62
|
+
severity: "error"
|
|
63
|
+
description: "lib 代码 import 'js-yaml' 且 package.json dependencies 无此项:纯净安装后 Cannot find module 'js-yaml'。npm 依赖必须声明,发布前 npm ls 全绿"
|
|
64
|
+
kind: "npm-json"
|
|
65
|
+
exts: ["json"]
|
|
66
|
+
fixable: true
|
|
67
|
+
mitigation: "package.json dependencies 增加 \"js-yaml\": \"^4.1.0\";npm ls 验证"
|
|
68
|
+
|
|
69
|
+
# ── ③ 凭据防泄漏(.npmrc / package.json)──
|
|
70
|
+
- id: npm/npmrc-authtoken
|
|
71
|
+
name: ".npmrc 含认证 token(禁止入库)"
|
|
72
|
+
category: "npm"
|
|
73
|
+
severity: "error"
|
|
74
|
+
description: ".npmrc 里 _authToken / //registry.npmjs.org/:_authToken 是 npm 发布凭据,进 git 即泄露;发布 token 应只在本机 ~/.npmrc,绝不进仓库"
|
|
75
|
+
exts: ["json", "npmrc"]
|
|
76
|
+
patterns:
|
|
77
|
+
- "_authToken"
|
|
78
|
+
- "//registry\\.npmjs\\.org/:_authToken"
|
|
79
|
+
- "always-auth\\s*=\\s*true"
|
|
80
|
+
fixable: false
|
|
81
|
+
mitigation: "从 .npmrc 删除 token 并加 .gitignore;令牌在 npmjs.com 撤销重发"
|
|
82
|
+
- id: npm/package-auth-props
|
|
83
|
+
name: "package.json 含发布凭据字段"
|
|
84
|
+
category: "npm"
|
|
85
|
+
severity: "error"
|
|
86
|
+
description: "package.json 不应含 publishConfig._authToken / //registry 凭据行;发布凭据只在本机环境"
|
|
87
|
+
exts: ["json"]
|
|
88
|
+
patterns:
|
|
89
|
+
- "\"publishConfig\"\\s*:\\s*\\{[^}]*_auth"
|
|
90
|
+
- "authToken"
|
|
91
|
+
fixable: false
|
|
92
|
+
mitigation: "删除 publishConfig 凭据字段;用环境变量 NODE_AUTH_TOKEN"
|
|
93
|
+
|
|
94
|
+
# ── ④ 发布语义 ──
|
|
95
|
+
- id: npm/private-true-conflict
|
|
96
|
+
name: "\"private\": true 与发布矛盾"
|
|
97
|
+
category: "npm"
|
|
98
|
+
severity: "warning"
|
|
99
|
+
description: "package.json 标记 private: true 时 npm publish 会被 npm 拒绝(除非 --access=restricted 私有包);要发布公开插件应去掉 private 或明确私有包意图"
|
|
100
|
+
exts: ["json"]
|
|
101
|
+
patterns:
|
|
102
|
+
- "\"private\"\\s*:\\s*true"
|
|
103
|
+
fixable: true
|
|
104
|
+
mitigation: "去掉 private 或按私有包发布;核对 npm registry 可见性预期"
|
|
105
|
+
- id: npm/license-field-check
|
|
106
|
+
name: "license 字段核对(缺失则 npm pack 告警)"
|
|
107
|
+
category: "npm"
|
|
108
|
+
severity: "warning"
|
|
109
|
+
description: "npm 要求 package.json 有 license 字段(可 SPDX 表达式);缺失时 npm publish 拒绝(npm 8+ 默认无 license 不可发布公共包)。引擎结构化判定:license 字段**缺失**才报(已声明则不报)"
|
|
110
|
+
kind: "npm-json"
|
|
111
|
+
exts: ["json"]
|
|
112
|
+
fixable: false
|
|
113
|
+
mitigation: "增加 \"license\": \"MIT\"(或项目实际 SPDX 值)+ LICENSE 文件;npm publish --dry-run 验证"
|
|
114
|
+
- id: npm/license-unlicensed
|
|
115
|
+
name: "license 声明为 UNLICENSED(别人无法合法使用/分发)"
|
|
116
|
+
category: "npm"
|
|
117
|
+
severity: "warning"
|
|
118
|
+
description: "UNLICENSED / PROPRIETARY 只表示「未授权」——公开包的使用者无法合法使用与再分发,npm 页面也会标红。与 npm/license-field-check(缺字段)互补,本规则只判「有字段但值等于未授权」。依据:npm-publish-checklist 清单第 2 项"
|
|
119
|
+
kind: "npm-json"
|
|
120
|
+
fixable: true
|
|
121
|
+
mitigation: "改为明确 SPDX(如 \"license\": \"MIT\" / \"Apache-2.0\"),并把 LICENSE 文件纳入 files 白名单"
|
|
122
|
+
- id: npm/files-risky-entry
|
|
123
|
+
name: "files 白名单含敏感内容或体积产物(会随包发布)"
|
|
124
|
+
category: "npm"
|
|
125
|
+
severity: "warning"
|
|
126
|
+
description: "逐条核对 files 数组:出现 node_modules / .env / secret|credential|token / *.key|*.pem ⇒ 判为 blocker(凭据随包发布不可逆);出现 *.tgz / music|audio / *.mp3|*.wav / 字体 ⇒ 按规则严重度报(体积白涨)。依据:npm-publish-checklist 清单第 3、9、12 项"
|
|
127
|
+
kind: "npm-json"
|
|
128
|
+
fixable: true
|
|
129
|
+
mitigation: "从 files 删除这些条目;凭据类同时轮换令牌;用 npm pack --dry-run --json 复核实际打进包的文件清单"
|
|
130
|
+
- id: npm/meta-incomplete
|
|
131
|
+
name: "包元信息不全(author / keywords / bugs / homepage)"
|
|
132
|
+
category: "npm"
|
|
133
|
+
severity: "info"
|
|
134
|
+
description: "缺 author/keywords/bugs/homepage 会让 npm 包页面没有作者与仓库入口、也搜不到;规则逐个列出缺失项,便于一次补齐。依据:npm-publish-checklist 清单第 7 项"
|
|
135
|
+
kind: "npm-json"
|
|
136
|
+
fixable: false
|
|
137
|
+
mitigation: "补齐 author、若干 keywords、bugs/homepage(地址需实测存在)"
|
|
138
|
+
- id: npm/prepack-script-present
|
|
139
|
+
name: "存在 prepack/prepare/publishOnly 脚本(发布时会自动执行)"
|
|
140
|
+
category: "npm"
|
|
141
|
+
severity: "info"
|
|
142
|
+
description: "npm publish 前会自动执行 prepack / prepare / publishOnly / prepublishOnly;脚本跑不通发布会直接失败。命中即提示发布前本地先跑一次,并确认其产物已被 files 覆盖。依据:npm-publish-checklist 清单第 8 项"
|
|
143
|
+
kind: "npm-json"
|
|
144
|
+
fixable: false
|
|
145
|
+
mitigation: "发布前本地执行同名脚本确认可跑通;产物路径与 files 白名单保持一致"
|
|
146
|
+
- id: npm/peer-range-unbounded
|
|
147
|
+
name: "peerDependencies 未写显式上界(宿主兼容范围不明确)"
|
|
148
|
+
category: "npm"
|
|
149
|
+
severity: "info"
|
|
150
|
+
description: "peer 是「由宿主提供」的依赖,^ / ~ 的隐式上界常与实际宿主版本错位;建议写显式区间(如 \">=0.1.6-0 <0.3.0-0\")。不含 '<' 的条目才提示;写 '*' 的交由 npm/dependency-star-range 管辖、私有包整体跳过。依据:npm-publish-checklist 清单第 4 项"
|
|
151
|
+
kind: "npm-json"
|
|
152
|
+
fixable: false
|
|
153
|
+
mitigation: "peerDependencies 写显式区间,上界对齐宿主实际兼容版本"
|
|
154
|
+
- id: npm/repository-field-check
|
|
155
|
+
name: "repository 字段核对(npm 包元数据)"
|
|
156
|
+
category: "npm"
|
|
157
|
+
severity: "info"
|
|
158
|
+
description: "建议声明 repository({type,url})便于 npm 页面与依赖审计溯源。引擎结构化判定:repository 字段**缺失**才报(已声明则不报)"
|
|
159
|
+
kind: "npm-json"
|
|
160
|
+
exts: ["json"]
|
|
161
|
+
fixable: false
|
|
162
|
+
mitigation: "增加 \"repository\": { \"type\": \"git\", \"url\": \"https://github.com/<owner>/<repo>.git\" }"
|
|
163
|
+
|
|
164
|
+
# ── 版本字段(npm 包版本语义;从 version 槽位迁入——这是 npm 通用约定,不是自家纪律)──
|
|
165
|
+
# 作用域:格式类只认 package.json(filePatterns)。原实现 exts:["json"] 会扫所有 json,
|
|
166
|
+
# 第三方资源仓库里成千上万个带 "version" 字段的 json 被逐条判 error(实测 1435 条误报)。
|
|
167
|
+
- id: npm/version-format-triple
|
|
168
|
+
name: "package.json version 非 X.Y.Z 三段格式"
|
|
169
|
+
category: "npm"
|
|
170
|
+
severity: "error"
|
|
171
|
+
description: "npm 包 version 必须 SemVer 三段 X.Y.Z(两段 1.0 / 四段 1.0.0.1 / 带前缀均不合规);X 可为 0(0.x = 开发初始阶段,SemVer §4)。只对 package.json 生效"
|
|
172
|
+
include_paths: ["package.json"]
|
|
173
|
+
exts: ["json"]
|
|
174
|
+
patterns:
|
|
175
|
+
- "\"version\"\\s*:\\s*\"(?![0-9]+\\.[0-9]+\\.[0-9]+\")"
|
|
176
|
+
fixable: true
|
|
177
|
+
mitigation: "改为 X.Y.Z(如 1.2.0 或 0.3.0——0.x 合法开发期)"
|
|
178
|
+
- id: npm/version-commit-mismatch
|
|
179
|
+
name: "提交信息里的版本号需与 package.json 一致"
|
|
180
|
+
category: "npm"
|
|
181
|
+
severity: "info"
|
|
182
|
+
description: "提交信息含版本号时,应与 package.json 的 version 一致(提交即存档新版本);引擎为单文件正则、无法跨文件比对,命中即提示人工核对"
|
|
183
|
+
exts: ["md"]
|
|
184
|
+
patterns:
|
|
185
|
+
- "版本\\s*[::]?\\s*v?[0-9]+\\.[0-9]+\\.[0-9]+"
|
|
186
|
+
fixable: false
|
|
187
|
+
mitigation: "提交前核对 package.json version = 提交信息里的版本号"
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
# dsh-git-push 审计规则(paths 槽位,1.0.0)
|
|
2
|
+
#
|
|
3
|
+
# 路径类审计规则**集中一处**:硬编码绝对路径 / 路径穿越 / cd 兜底 / 写入被忽略目录 / 文档旧凭据路径。
|
|
4
|
+
#
|
|
5
|
+
# 为什么独立成槽位:
|
|
6
|
+
# · 这些规则**与语言无关**(nodejs / python / java 项目都可能踩),与「按语言分组」的槽位语义不同;
|
|
7
|
+
# · 原先散落在 nodejs 与 folder 两个槽位里(同一个"路径"主题两处维护)⇒ 集中后消除分裂;
|
|
8
|
+
# · 引擎的槽位是**动态**的:本文件放进 lib/audit-rules/ 即自动成为槽位(无需改代码)。
|
|
9
|
+
#
|
|
10
|
+
# 三段式写法(本槽位统一遵循):
|
|
11
|
+
# ① patterns 正则初筛 → ② astConfirm/astConfirmKind 精筛(实现在 lib/checks/,可拿到文件路径与
|
|
12
|
+
# 仓库上下文)→ ③ exceptions 说明豁免边界(最终由人判断,正则只是线索不是判决)。
|
|
13
|
+
metadata:
|
|
14
|
+
name: "路径类审计规则(硬编码绝对路径 / 路径穿越 / cd 兜底 / 写入忽略目录 / 旧凭据路径)"
|
|
15
|
+
version: "1.0.0"
|
|
16
|
+
|
|
17
|
+
rules:
|
|
18
|
+
# ----- 规则 1:硬编码绝对路径(2026-10-11 新增)-----
|
|
19
|
+
# 正则初筛(跨系统字面量)→ 精筛 astConfirmKind: hardcoded-abs-path
|
|
20
|
+
# (lib/checks/common.js 的 hardcodedAbsPathLines:fs.existsSync 判断"本机可访问"并换算相对路径;
|
|
21
|
+
# 基准 = 该文件所在目录(用户确认的选择);可访问 ⇒ 警告并附相对路径;不可访问 ⇒ 仅警告)
|
|
22
|
+
- id: paths/hardcoded-absolute-path
|
|
23
|
+
name: "硬编码绝对路径(换机即失效)"
|
|
24
|
+
category: "paths"
|
|
25
|
+
severity: "warning"
|
|
26
|
+
description: "字符串里写死本机绝对路径(/volume1、/home、/Users、C:\\、\\\\server\\share、file://),换机/迁移/换挂载点后失效;应改为相对路径(基准 = 文件所在目录)、path.join 或配置项传入"
|
|
27
|
+
patterns:
|
|
28
|
+
- "/(volume[0-9]+|home|Users|var|usr|opt|tmp|mnt|srv|etc|root|Applications|Volumes)/[^\\s\"'`),;]+"
|
|
29
|
+
- "[A-Za-z]:[\\\\/][^\\s\"'`),;]+"
|
|
30
|
+
# UNC(\\\\server\\share\\...):初筛必须写,否则这类行进不了精筛通道
|
|
31
|
+
# (实测:漏了这条 ⇒ 夹具里 UNC 那行永远不报,而精筛明明有 UNC 判定)
|
|
32
|
+
- "\\\\\\\\[A-Za-z0-9_.-]+\\\\[^\\s\"'`),;]+"
|
|
33
|
+
- "file:///[^\\s\"'`),;]+"
|
|
34
|
+
astConfirm: true
|
|
35
|
+
astConfirmKind: "hardcoded-abs-path"
|
|
36
|
+
exceptions:
|
|
37
|
+
- "注释里的举例说明(仅提示,不阻断)"
|
|
38
|
+
- "已用 path.join / os.tmpdir() / 相对路径的写法"
|
|
39
|
+
- "测试夹具里刻意构造的样例路径(属测试数据)"
|
|
40
|
+
- "文档中带日期的历史实测记录(说明当时在哪台机器上跑的)"
|
|
41
|
+
|
|
42
|
+
# ----- 规则 2(迁移自 nodejs 槽位):路径穿越防护 -----
|
|
43
|
+
- id: security/no-path-traversal
|
|
44
|
+
name: "路径穿越防护"
|
|
45
|
+
category: "security"
|
|
46
|
+
severity: "error"
|
|
47
|
+
description: "直接使用用户输入作为文件路径存在目录遍历风险"
|
|
48
|
+
fixable: false
|
|
49
|
+
mitigation: "使用 path.resolve + startsWith 白名单校验"
|
|
50
|
+
|
|
51
|
+
# ----- 规则 3(迁移自 nodejs 槽位):文档引用旧凭据位置 -----
|
|
52
|
+
- id: credref-legacy-path
|
|
53
|
+
name: "文档引用旧凭据位置"
|
|
54
|
+
category: "security"
|
|
55
|
+
severity: "warning"
|
|
56
|
+
description: "文档含旧凭据位置引用:凭据统一存插件配置目录(DSH_HOME/git-push/,0600 权限)"
|
|
57
|
+
pattern: "(\\.ssh[\\\\/]credentials|data[\\\\/]sensitive[\\\\/]|credentials\\.md|sudo-key|git-rescue[\\\\/]token)"
|
|
58
|
+
fixable: false
|
|
59
|
+
|
|
60
|
+
# ----- 规则 4(迁移自 folder 槽位):cd 到可能不存在的目录 -----
|
|
61
|
+
# 三段式:正则初筛(cd 命令)→ token 精筛 astConfirm → 精筛集合 shell-cd-dynamic
|
|
62
|
+
# (lib/ast/shell.js:目标含 $、排除自我定位 dirname/BASH_SOURCE、同行无 ||、非 && 链)。
|
|
63
|
+
- id: folder/cd-to-maybe-missing
|
|
64
|
+
name: "cd 到可能不存在的目录(动态路径无兜底)"
|
|
65
|
+
category: "paths"
|
|
66
|
+
severity: "warning"
|
|
67
|
+
description: "cd 到变量/命令替换路径时目标目录可能不存在,cd 失败后脚本仍会继续执行;应加 || exit/return/echo 兜底或先确认目录存在"
|
|
68
|
+
patterns:
|
|
69
|
+
- "\\bcd\\s+\\S+"
|
|
70
|
+
astConfirm: true
|
|
71
|
+
astConfirmKind: "shell-cd-dynamic"
|
|
72
|
+
exceptions:
|
|
73
|
+
- "脚本自我定位(cd $(dirname $0) / ${BASH_SOURCE[0]%/*},目录必然存在)"
|
|
74
|
+
- "同行已有 || 兜底或 && 链"
|
|
75
|
+
|
|
76
|
+
# ----- 规则 5(迁移自 folder 槽位):写文件/目录到可能不存在的 gitignore 目录 -----
|
|
77
|
+
# 三段式:正则初筛(写操作字面量目标)→ token 精筛 astConfirm → 精筛集合
|
|
78
|
+
# write-into-gitignored(lib/ast/shell.js:读仓库 .gitignore 判定目标被忽略;无
|
|
79
|
+
# 仓库上下文 repoPath 时不报——不臆测)。
|
|
80
|
+
- id: folder/write-into-gitignored-dir
|
|
81
|
+
name: "写文件/目录到可能不存在的 gitignore 目录"
|
|
82
|
+
category: "paths"
|
|
83
|
+
severity: "warning"
|
|
84
|
+
description: "写操作的目标目录被 .gitignore 忽略且可能在仓库中不存在;产物不可见,运行时可能失败,应先 mkdir -p 或调整忽略"
|
|
85
|
+
patterns:
|
|
86
|
+
- "(writeFile|writeFileSync|appendFile|appendFileSync|createWriteStream|mkdir|mkdirSync)\\s*\\(\\s*['\"][^'\"]+['\"]"
|
|
87
|
+
astConfirm: true
|
|
88
|
+
astConfirmKind: "write-into-gitignored"
|
|
89
|
+
exceptions:
|
|
90
|
+
- "目标为 node_modules 内写入(安装产物)"
|
|
91
|
+
- "目标为 /tmp 临时目录"
|
|
92
|
+
- ".gitignore 中以 ! 取反的路径"
|
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
# dsh-skip-sensitive: 规则定义文件含符号示范文本(fs.readFileSync / push / while 等)
|
|
2
|
+
# dsh-skip-residue: 规则定义文件含 console/while(true) 模式串示范(规则定义本身)
|
|
3
|
+
# dsh-git-push 审计规则(performance 槽位,1.0.4 beta)
|
|
4
|
+
# 性能审计:内存爆炸 / 无界增长等高成本代码模式(子模式规则示范,文档 §13)。
|
|
5
|
+
# 规则类型由编译函数按字段自动指派;patterns 条目支持对象子模式(id/pattern/message)。
|
|
6
|
+
# dimensions:10 维度绑定,支持一字段多维度。
|
|
7
|
+
metadata:
|
|
8
|
+
name: "性能审计规则(memory-bomb 示范落地)"
|
|
9
|
+
version: "1.0.4"
|
|
10
|
+
|
|
11
|
+
rules:
|
|
12
|
+
# ── 内存爆炸检测(文档 §13 示例规则落地:子模式 + per-pattern message)──
|
|
13
|
+
- id: performance/memory-bomb
|
|
14
|
+
name: "检测可能导致内存爆炸的代码"
|
|
15
|
+
category: "performance"
|
|
16
|
+
severity: "warning"
|
|
17
|
+
description: "短时间内占用大量内存的代码模式(受控的本地小 JSON/配置文件读取不算)"
|
|
18
|
+
# 2026-09-27:仅代码文件——docs 方案文的「全量读入文件」示例是讲解文本,不是运行代码
|
|
19
|
+
exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx", "py"]
|
|
20
|
+
# 2026-09-13:子模式精筛——full-file-read 命中后由引擎确认「读的是否受控小文件」
|
|
21
|
+
astConfirmKind: "small-file-read"
|
|
22
|
+
patterns:
|
|
23
|
+
- id: full-file-read
|
|
24
|
+
pattern: "fs\\.(readFileSync|readFile)\\s*\\("
|
|
25
|
+
# 2026-09-13 误报修复(正则初筛 → AST 精筛):本规则针对「大文件全量读入」,
|
|
26
|
+
# 读**受控的本地小 JSON 数据/配置文件**(记分数据、标题缓存等,紧跟
|
|
27
|
+
# JSON.parse 或路径变量含 data/cache/config/locale)不构成内存爆炸风险——
|
|
28
|
+
# 旧实现命中即报,对任何读 JSON 的项目恒定误报。精筛条件见 astConfirmKind。
|
|
29
|
+
message: "全量读入文件可能占用大量内存,建议用流式处理"
|
|
30
|
+
- id: unbounded-push
|
|
31
|
+
pattern: "(for|while)\\s*\\([^)]*\\)\\s*\\{[^}]*\\.push\\s*\\([^)]*\\)"
|
|
32
|
+
message: "循环内 push 无界累积(可能内存增长失控),检查是否有清理机制或上限"
|
|
33
|
+
- id: chained-push
|
|
34
|
+
pattern: "\\.push\\s*\\([^)]*\\)\\s*\\.push"
|
|
35
|
+
message: "链式 push 连续追加(警惕无界累积),确认有上限控制"
|
|
36
|
+
- id: array-spread
|
|
37
|
+
pattern: "\\[\\s*\\.\\.\\.\\w+\\s*,\\s*\\.\\.\\.\\w+\\s*\\]"
|
|
38
|
+
message: "展开多个大数组会一次性创建新数组"
|
|
39
|
+
- id: infinite-loop
|
|
40
|
+
pattern: "while\\s*\\(\\s*true\\s*\\)"
|
|
41
|
+
message: "无限循环需确认有 break 条件和内存控制"
|
|
42
|
+
- id: exec-sync
|
|
43
|
+
pattern: "execSync\\s*\\("
|
|
44
|
+
message: "execSync 输出全部进内存,建议用 spawn + 流"
|
|
45
|
+
- id: json-stringify-large
|
|
46
|
+
pattern: "JSON\\.stringify\\s*\\([^)]{50,}\\)"
|
|
47
|
+
message: "大对象序列化会瞬间产生等量字符串"
|
|
48
|
+
fixable: false
|
|
49
|
+
mitigation: |
|
|
50
|
+
- 大文件用 fs.createReadStream 流式处理
|
|
51
|
+
- 数组累积加 maxLength 上限,超出时丢弃旧数据
|
|
52
|
+
- 缓存加 TTL 或 LRU 淘汰机制
|
|
53
|
+
- 递归加深度限制
|
|
54
|
+
- 子进程用 spawn + 流式读取
|
|
55
|
+
|
|
56
|
+
# ── 循环内全量集合物化(二次增长;真实样本见 lib/ast/perf.js 注释)──
|
|
57
|
+
- id: performance/loop-full-collection
|
|
58
|
+
name: "禁止在循环体内做全量集合物化"
|
|
59
|
+
category: "performance"
|
|
60
|
+
severity: "warning"
|
|
61
|
+
description: "循环体内 Array.from(x.values()/keys()/entries()) 会把整个集合物化一遍:成本≈循环次数×集合大小,随数据量二次增长(应先建索引、循环内 O(1) 查)"
|
|
62
|
+
exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx"]
|
|
63
|
+
# 纯正则无法表达「在不在循环体内」——由 AST 精筛(allow 语义:只报循环体内的命中)
|
|
64
|
+
astConfirmKind: "loop-full-collection"
|
|
65
|
+
patterns:
|
|
66
|
+
- id: array-from-values
|
|
67
|
+
pattern: "Array\\.from\\s*\\(\\s*[A-Za-z_$][\\w.$]*\\.(values|keys|entries)\\s*\\(\\s*\\)\\s*\\)"
|
|
68
|
+
message: "循环体内全量物化集合:改为循环外建一次索引(Map/Set),循环内 O(1) 查"
|
|
69
|
+
fixable: false
|
|
70
|
+
mitigation: "循环外建 Map/Set 索引(如 name→nodeId),循环内用 .get()/.has() 查;确需快照时提到循环外"
|
|
71
|
+
|
|
72
|
+
# ── 循环内重复调用同一函数(可记忆化 / 提前计算)──
|
|
73
|
+
- id: performance/repeat-identical-call
|
|
74
|
+
name: "同一循环体内重复调用同一函数(实参完全相同)"
|
|
75
|
+
category: "performance"
|
|
76
|
+
severity: "warning"
|
|
77
|
+
description: "同一循环体内 ≥2 次实参完全相同的调用:若该函数为纯函数且开销不小,应记忆化或提到循环外(真实案例:路径解析函数在解析循环内被调 8762 次、占全量扫描 89%,加记忆化后 4581ms→344ms)"
|
|
78
|
+
exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx"]
|
|
79
|
+
# 纯正则无法表达「在不在循环体内 / 实参是否相同」——由 AST 精筛(allow 语义)
|
|
80
|
+
astConfirmKind: "repeat-identical-call"
|
|
81
|
+
patterns:
|
|
82
|
+
- id: repeated-call
|
|
83
|
+
pattern: "[A-Za-z_$][\\w.$]*\\s*\\([^()]*\\)"
|
|
84
|
+
message: "循环体内重复调用(实参相同):若为纯函数可记忆化或提前计算"
|
|
85
|
+
fixable: false
|
|
86
|
+
mitigation: "加一层 Map 记忆化(键=入参组合)或把结果提到循环外;有副作用的调用(写文件/网络/日志)不适用"
|
|
87
|
+
|
|
88
|
+
# ── 写死 User-Agent(2026-10-12 从 gbmd 实战沉淀)──
|
|
89
|
+
# 教训:GameBanana 等平台的会话与「换取 cookie 时的浏览器 UA」绑定;下载路径写死 Chrome UA
|
|
90
|
+
# ⇒ 服务端判定未登录 ⇒ 全量 403。UA 必须来自配置/调用方,兜底常量要显式命名。
|
|
91
|
+
- id: performance/hardcoded-user-agent
|
|
92
|
+
name: "对象字面量里写死 User-Agent"
|
|
93
|
+
category: "performance"
|
|
94
|
+
severity: "blocker"
|
|
95
|
+
description: "请求头里直接写死浏览器 UA(而非读配置/调用方传入):会话类站点会因 UA 与 cookie 不匹配判未登录(实战:下载全 403)"
|
|
96
|
+
exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx", "py"]
|
|
97
|
+
patterns:
|
|
98
|
+
- id: literal-ua
|
|
99
|
+
pattern: "[\"']User-Agent[\"']\\s*:\\s*[\"']Mozilla[^\"']*[\"']"
|
|
100
|
+
message: "写死 User-Agent:改为读配置(如 cfg.gbUserAgent)或调用方传入;确需兜底请用命名常量(DEFAULT_UA)"
|
|
101
|
+
fixable: false
|
|
102
|
+
mitigation: "UA 与 cookie 同源:从配置/调用方取;兜底值提成命名常量并在注释里说明用途"
|
|
103
|
+
|
|
104
|
+
# ── 手写资源版本号(2026-10-12 从 gbmd 实战沉淀)──
|
|
105
|
+
# 教训:href 手写 ?v=4.4.1,而脚本元数据已 @version 4.5.0 ⇒ 必然漂移;serve 端 no-store 时
|
|
106
|
+
# 版本参数本身也多余(浏览器每次都会拉最新)。
|
|
107
|
+
- id: performance/handwritten-asset-version
|
|
108
|
+
name: "href 手写 ?v= 版本号(必然漂移)"
|
|
109
|
+
category: "performance"
|
|
110
|
+
severity: "warning"
|
|
111
|
+
description: "静态资源/脚本链接手写 ?v=:与真实版本(如油猴 @version)必然漂移,且服务端已 no-store 时属多余参数"
|
|
112
|
+
exts: ["html", "htm", "js", "mjs", "cjs", "ts", "tsx", "jsx", "vue", "svelte"]
|
|
113
|
+
patterns:
|
|
114
|
+
- id: userscript-v
|
|
115
|
+
pattern: "\\.user\\.js\\?v=[0-9]"
|
|
116
|
+
message: "油猴脚本链接手写 ?v=:与脚本 @version 必然漂移;服务端路由已 no-store 时请直接去掉版本参数"
|
|
117
|
+
fixable: false
|
|
118
|
+
mitigation: "去掉手写版本号;需要防缓存就用构建期 hash 或服务端 no-store"
|
|
119
|
+
|
|
120
|
+
# ── 接口回整个状态对象(2026-10-12 从 gbmd 实战沉淀)──
|
|
121
|
+
# 教训:/api/task 单次回 34.3MB、写接口把 38MB 完整任务塞进响应 ⇒ 每 2 秒轮询 ≈17MB/s,
|
|
122
|
+
# 页面卡死、服务端序列化被拖垮。列表类接口应回摘要 + 分页。
|
|
123
|
+
- id: performance/endpoint-returns-whole-state
|
|
124
|
+
name: "接口直接回整个状态对象(裸变量)"
|
|
125
|
+
category: "performance"
|
|
126
|
+
severity: "warning"
|
|
127
|
+
description: "响应体里直接塞一个裸变量(可能是完整状态对象):大对象序列化 + 传输成本随数据量线性增长(实战:34.3MB/次 × 每 2 秒)"
|
|
128
|
+
exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx"]
|
|
129
|
+
patterns:
|
|
130
|
+
- id: bare-task-var
|
|
131
|
+
pattern: "\\btask\\s*:\\s*[A-Za-z_$][\\w$]*\\s*[,}]"
|
|
132
|
+
message: "响应里回裸变量 task: X:确认 X 是否为完整状态对象;列表类接口应回摘要/分页"
|
|
133
|
+
fixable: false
|
|
134
|
+
mitigation: "改为回摘要(状态/统计/计数)+ 分页接口;完整对象只在显式导出接口返回"
|
|
135
|
+
|
|
136
|
+
# ── 无界循环 / 高 CPU 轮询(性能补充)──
|
|
137
|
+
- id: performance/busy-wait-loop
|
|
138
|
+
name: "忙等待循环(高 CPU 空转)"
|
|
139
|
+
category: "performance"
|
|
140
|
+
severity: "warning"
|
|
141
|
+
description: "while 空循环 / 同步轮询会占满 CPU 核心,建议用 setTimeout/async 等待"
|
|
142
|
+
patterns:
|
|
143
|
+
- "while\\s*\\(\\s*[^)]*true[^)]*\\s*\\)\\s*\\{\\s*\\}"
|
|
144
|
+
- "for\\s*\\([^)]*;[^)]*;[^)]*\\)\\s*\\{\\s*\\}"
|
|
145
|
+
fixable: false
|
|
146
|
+
mitigation: "等待用 setTimeout / async sleep,轮询加间隔与超时"
|
|
147
|
+
|
|
148
|
+
# ── 2026-10-12 实战沉淀:4 条需 AST 精筛的性能/健壮性规则 ──
|
|
149
|
+
# 共性:正则只能看出「写了某个调用/循环」,看不出它在不在循环里、循环规模多大、函数会不会返回 undefined。
|
|
150
|
+
# 每条都在真实修复提交上验证过:修复前命中、修复后不报(语料见 gbmd 项目 test/perf-antipatterns.test.cjs)。
|
|
151
|
+
|
|
152
|
+
- id: performance/loop-no-fallback-return
|
|
153
|
+
name: "循环后缺兜底 return(函数可能返回 undefined)"
|
|
154
|
+
category: "performance"
|
|
155
|
+
severity: "blocker"
|
|
156
|
+
description: "函数顶层循环里有值 return,循环之后既无 return 也无 throw ⇒ 某些分支会「走完循环直接掉出函数」返回 undefined;调用方解构/取值即崩(实战:fetchJsonHeaders 因 maxAttempts(6) > 循环上界 retries(1) 而返回 undefined,面板报 Cannot destructure property 'json' …)"
|
|
157
|
+
exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx"]
|
|
158
|
+
# 正则只做「循环行」初筛,是否真会掉出函数由 AST 判定(allow 语义)
|
|
159
|
+
astConfirmKind: "loop-no-fallback-return"
|
|
160
|
+
patterns:
|
|
161
|
+
- id: loop-line
|
|
162
|
+
pattern: "\\b(for|while)\\s*\\("
|
|
163
|
+
message: "循环之后没有兜底 return/throw:确认所有分支都会返回值或抛错(否则调用方拿到 undefined)"
|
|
164
|
+
fixable: false
|
|
165
|
+
mitigation: "循环结束后补 `throw lastErr` 或 `return 默认值`;重试循环的 maxAttempts 必须与循环上界一致"
|
|
166
|
+
|
|
167
|
+
- id: performance/loop-full-rewrite-call
|
|
168
|
+
name: "循环内调用「整份重写文件」的函数"
|
|
169
|
+
category: "performance"
|
|
170
|
+
severity: "warning"
|
|
171
|
+
description: "循环体里调用会 writeFileSync + JSON.stringify 整份文件的函数 ⇒ 每轮重写整份;单份几十 MB 时写盘量 = 轮数 × 文件大小(实战:收尾逐目录重写 15–26MB 游戏索引,数千轮 = 几十 GB、收尾 634 秒、接口堵死 74 秒)。**循环规模静态不可知**(13 个游戏 vs 4,598 个目录代码同形),故只作 warning,判真伪需运行期计数"
|
|
172
|
+
exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx"]
|
|
173
|
+
astConfirmKind: "loop-full-rewrite-call"
|
|
174
|
+
patterns:
|
|
175
|
+
- id: rewrite-like-call
|
|
176
|
+
pattern: "\\b\\w*(save|write|persist|flush|rewrite)\\w*\\s*\\("
|
|
177
|
+
message: "循环内整份重写文件:改为批量期间只更新内存、循环结束后统一落盘(或加 deferSave/防抖)"
|
|
178
|
+
fixable: false
|
|
179
|
+
mitigation: "批量收集改动 → 循环外每个目标文件只写一次;确需逐轮写就加节流窗口或改增量写"
|
|
180
|
+
|
|
181
|
+
- id: performance/nested-linear-scan
|
|
182
|
+
name: "成员判定回调里套循环做 === 比较(O(n×m))"
|
|
183
|
+
category: "performance"
|
|
184
|
+
severity: "warning"
|
|
185
|
+
description: "filter/find/some/every 的回调里再套 for 循环逐条 === 比较 ⇒ 复杂度 O(n×m)(实战:2,544 × 40,394 ≈ 1.03 亿次比较,纯 CPU 阻塞 12,784ms;改成先建 Set 再判定 ⇒ 14ms,913×)"
|
|
186
|
+
exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx"]
|
|
187
|
+
astConfirmKind: "nested-linear-scan"
|
|
188
|
+
patterns:
|
|
189
|
+
- id: membership-callback
|
|
190
|
+
pattern: "\\.(filter|find|some|every)\\s*\\("
|
|
191
|
+
message: "成员判定回调里套循环逐条比较:先把一侧收进 Set/Map 再判定(O(n+m))"
|
|
192
|
+
fixable: false
|
|
193
|
+
mitigation: "循环外建 Set/Map 索引,回调内 O(1) 查;键要选稳定唯一值(如 modId)"
|
|
194
|
+
|
|
195
|
+
- id: performance/long-sync-loop
|
|
196
|
+
name: "async 函数内长同步循环无让出点"
|
|
197
|
+
category: "performance"
|
|
198
|
+
severity: "warning"
|
|
199
|
+
description: "async 函数里的循环体含 ≥2 个同步调用且整段无 await ⇒ 长任务占满事件循环,期间接口全部超时(实战:收尾逐目录同步 stat/read/write 把 /api/* 堵死 74 秒)"
|
|
200
|
+
exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx"]
|
|
201
|
+
astConfirmKind: "long-sync-loop"
|
|
202
|
+
patterns:
|
|
203
|
+
- id: loop-line
|
|
204
|
+
pattern: "\\b(for|while)\\s*\\("
|
|
205
|
+
message: "长同步循环无让出点:每 N 轮 await setImmediate/延时一次(总耗时不变,服务保持可响应)"
|
|
206
|
+
fixable: false
|
|
207
|
+
mitigation: "循环内每 N 次迭代 `await new Promise((r) => setImmediate(r))`;或把同步 I/O 换成异步 API"
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# ============================================================
|
|
2
|
+
# PHP 代码审计规则集(占位)
|
|
3
|
+
# 版本:0.1.0
|
|
4
|
+
# 适用:PHP 项目
|
|
5
|
+
# 描述:⚠️ 占位槽位——语言专项规则待补。放入此文件即完成「槽位就绪」:
|
|
6
|
+
# 审计系统自动发现本槽位(放 audit-rules-*.yml 即生效,零代码改动)。
|
|
7
|
+
# 当前 PHP 文件由 nodejs 槽位的语言无关规则(凭据/路径穿越/文件健康度等)兜底审计,
|
|
8
|
+
# 语言相关规则(短名/魔数/函数长度/复杂度/嵌套)待补 AST 层 phpFuncRanges 后启用。
|
|
9
|
+
# 待办(补规则时):① AST 层 lang.js 的 LANG_FUNC_RANGES.php 实现函数范围收集
|
|
10
|
+
# (function 关键字 + 花括号配对,与 JS 同构);② 本槽位按 python/java 先例
|
|
11
|
+
# 写规则,exts: ["php"]。
|
|
12
|
+
# ============================================================
|
|
13
|
+
|
|
14
|
+
metadata:
|
|
15
|
+
name: "PHP 审计规则集(占位)"
|
|
16
|
+
version: "0.1.0"
|
|
17
|
+
language: "php"
|
|
18
|
+
author: "DeepSeek"
|
|
19
|
+
description: "PHP 项目语言专用规则(占位——规则待补,槽位已就绪)"
|
|
20
|
+
last_updated: "2026-10-06"
|
|
21
|
+
|
|
22
|
+
rules: []
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# 私密拦截审计规则(强制加载槽位)
|
|
2
|
+
# 强制加载:无论 auditRuleOrder 如何配置,本槽位永远合并进最终规则集(末尾追加,优先级最高)。
|
|
3
|
+
# 语义:仓库跟踪到以下私密文件时,按远端可见性分级——
|
|
4
|
+
# public → blocker 拦截提交(私密文件已可被任何人获取);private/unknown → warning 提醒。
|
|
5
|
+
# 本文件是规则文件也是权重文件:清单增删即规则调整(与插件其它 YAML 规则一致)。
|
|
6
|
+
metadata:
|
|
7
|
+
name: 私密文件拦截审计(强制槽位)
|
|
8
|
+
author: EIGHTfs
|
|
9
|
+
version: "1.0.0"
|
|
10
|
+
private_files:
|
|
11
|
+
- "**/id_ed25519"
|
|
12
|
+
- "**/id_rsa"
|
|
13
|
+
- "**/*.pem"
|
|
14
|
+
- "**/*.key"
|
|
15
|
+
- "**/github-token"
|
|
16
|
+
- "**/.git-push-token"
|
|
17
|
+
- "**/.env"
|
|
18
|
+
- "**/.env.*"
|
|
19
|
+
- "**/data/sensitive/**"
|
|
20
|
+
- "**/.ssh/**"
|
|
21
|
+
- "**/.dsh/git-push/**"
|
|
22
|
+
- "**/.npmrc"
|
|
23
|
+
- "**/*@*.{md,txt,js,json}" # 邮箱形态文件名(如 your-name@example.com 占位文件)——历史踩坑:真实邮箱做占位文件名入库,含空文件仓无法走 Git Data API 推送且邮箱公开
|
|
24
|
+
rules: []
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
# ============================================================
|
|
2
|
+
# Python 代码审计规则集
|
|
3
|
+
# 作者:DeepSeek
|
|
4
|
+
# 版本:1.0.0
|
|
5
|
+
# 适用:Python 项目
|
|
6
|
+
# 描述:按文件类型识别路由——.py 文件由本槽位承载语言无关规则,
|
|
7
|
+
# nodejs 槽位的同类规则不再接管 Python(2026-10-05 划分)。
|
|
8
|
+
# 背景:全量审计 KToolBox(Python + TSX 混合,408 文件)时 nodejs slot 对 .py
|
|
9
|
+
# 套 JS 规则,3009 条问题里 2882 条来自 nodejs(评分失真 56/C)。
|
|
10
|
+
# 修复:① AST 层豁免 Python 枚举成员(magic-number 的
|
|
11
|
+
# collectPythonEnumAssignLines)、i18n 键/路由路径(repeated 豁免)、
|
|
12
|
+
# 文档示例凭据(placeholder-credential 文档级豁免);
|
|
13
|
+
# ② 本槽位承接 Python 文件的语言无关规则(命名/长度/复杂度/嵌套/魔数)。
|
|
14
|
+
# 最后更新:2026-10-05
|
|
15
|
+
# ============================================================
|
|
16
|
+
|
|
17
|
+
metadata:
|
|
18
|
+
name: "Python 审计规则集"
|
|
19
|
+
version: "1.0.0"
|
|
20
|
+
language: "python"
|
|
21
|
+
author: "DeepSeek"
|
|
22
|
+
description: "Python 项目语言无关规则:命名规范、魔数、函数长度、嵌套深度、圈复杂度、文件长度"
|
|
23
|
+
last_updated: "2026-10-05"
|
|
24
|
+
|
|
25
|
+
rules:
|
|
26
|
+
# ----- 1. 可读性 -----
|
|
27
|
+
# 全部规则 exts: ["py"]——本槽位只审计 Python 文件(文件类型识别路由的落点)。
|
|
28
|
+
# 检查器复用:max_depth/max_lines/max_complexity/min_length 字段由 numeric-kinds
|
|
29
|
+
# 编译器自动派发到 max-depth/max-lines/func-lines/max-complexity/min-length kind,
|
|
30
|
+
# 与 nodejs 槽位同一套检查器(tokenizer 支持 py 语法,class/def/缩进可解析)。
|
|
31
|
+
|
|
32
|
+
- id: python/variable-min-length
|
|
33
|
+
name: "Python 变量名长度不少于 2 个字符"
|
|
34
|
+
category: "readability"
|
|
35
|
+
severity: "warning"
|
|
36
|
+
description: "过短的变量名(如 a, b, x)降低代码可读性(Python 版)"
|
|
37
|
+
min_length: 2
|
|
38
|
+
exts: ["py"]
|
|
39
|
+
exceptions: ["i", "j", "k", "n", "e", "cb"]
|
|
40
|
+
fixable: false
|
|
41
|
+
|
|
42
|
+
- id: python/magic-number
|
|
43
|
+
name: "Python 硬编码魔数检测(枚举成员豁免版)"
|
|
44
|
+
kind: "magic-number-smart"
|
|
45
|
+
category: "readability"
|
|
46
|
+
severity: "warning"
|
|
47
|
+
description: "检测硬编码魔数,自动豁免版本号/日期/HTTP 状态码/常见常量/**Python 枚举成员**(class X(Enum/IntEnum) 体内的大写 NAME = 数字)"
|
|
48
|
+
magic_number_hints: ["timeout", "retry", "max", "min", "limit", "size", "count", "port", "interval", "delay", "duration", "threshold", "buffer", "chunk"]
|
|
49
|
+
legitimate_hints: ["version", "date", "year", "month", "day", "hour", "minute", "second", "http", "status"]
|
|
50
|
+
force_count: 3
|
|
51
|
+
exts: ["py"]
|
|
52
|
+
fixable: true
|
|
53
|
+
mitigation: "提取命名常量并注释含义:MAX_RETRY = 3; 版本号/日期/HTTP 状态码/常见常量/枚举成员自动豁免"
|
|
54
|
+
|
|
55
|
+
- id: python/max-nesting-depth
|
|
56
|
+
name: "Python 嵌套过深(缩进层级 > 4)"
|
|
57
|
+
category: "readability"
|
|
58
|
+
severity: "warning"
|
|
59
|
+
description: "代码缩进嵌套超过 4 层(如 for→for→if→if),可读性灾难,应提前 return 或抽函数(Python 版)"
|
|
60
|
+
max_depth: 4
|
|
61
|
+
exts: ["py"]
|
|
62
|
+
fixable: false
|
|
63
|
+
|
|
64
|
+
- id: python/max-function-length
|
|
65
|
+
name: "Python 函数长度不超过 50 行"
|
|
66
|
+
category: "readability"
|
|
67
|
+
severity: "warning"
|
|
68
|
+
description: "过长的函数难以理解和维护(Python 版)"
|
|
69
|
+
max_lines: 50
|
|
70
|
+
exts: ["py"]
|
|
71
|
+
# 2026-10-05(评审规则③):序列化/反序列化职责函数豁免——意义明确、变量生命周期
|
|
72
|
+
# 仅当前会话时代码常超百行,过度拆分复杂化数据传递与生命周期(得不偿失)。
|
|
73
|
+
scope_rules:
|
|
74
|
+
- scope: "serialization"
|
|
75
|
+
action: "exempt"
|
|
76
|
+
reason: "序列化/反序列化职责函数:意义明确且变量生命周期仅当前会话,超百行是职责自然形态"
|
|
77
|
+
fixable: true
|
|
78
|
+
|
|
79
|
+
- id: python/max-file-length
|
|
80
|
+
name: "Python 文件总行数不超过 400 行"
|
|
81
|
+
category: "readability"
|
|
82
|
+
severity: "warning"
|
|
83
|
+
description: "单文件超过 400 行时应拆分模块(Python 版;存量超大文件为已知债务,仅提醒不拦截)"
|
|
84
|
+
max_lines: 400
|
|
85
|
+
exts: ["py"]
|
|
86
|
+
fixable: false
|
|
87
|
+
|
|
88
|
+
- id: python/comment-density
|
|
89
|
+
name: "Python 行注释密度过高(注释复述代码)"
|
|
90
|
+
category: "readability"
|
|
91
|
+
severity: "warning"
|
|
92
|
+
description: "变量即注释——语义明确的代码里变量名已表达内容,额外的行注释不加深理解;只保留具有隐性约束、复杂设计、外部契约、非显然决策的块注释,注释应解释「为什么」而非复述「做了什么」"
|
|
93
|
+
threshold: 0.4
|
|
94
|
+
exts: ["py"]
|
|
95
|
+
fixable: false
|
|
96
|
+
|
|
97
|
+
# ----- 2. 可维护性 -----
|
|
98
|
+
- id: python/max-cyclomatic-complexity
|
|
99
|
+
name: "Python 圈复杂度不超过 10(50 以上 blocker)"
|
|
100
|
+
category: "maintainability"
|
|
101
|
+
severity: "blocker"
|
|
102
|
+
description: "圈复杂度评级(2026-10-02 用户口径):1~10 良好、11~20 中等(warning)、21~50 高风险(warning,应拆分)、50+ 极难维护(blocker 拦提交)——分支点:if/elif 每分支、for/while、try/except、with/assert、and/or"
|
|
103
|
+
max_complexity: 10
|
|
104
|
+
block_complexity: 50
|
|
105
|
+
exts: ["py"]
|
|
106
|
+
fixable: false
|