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,27 @@
|
|
|
1
|
+
# dsh-skip-sensitive: 规则定义文件含符号示范文本(fs.writeFile 等非真实数据)
|
|
2
|
+
# dsh-skip-residue: 规则定义文件含 debugger/console 模式串示范(规则定义本身)
|
|
3
|
+
# dsh-git-push 审计规则(robustness 槽位,1.0.3)
|
|
4
|
+
# 规则类型由编译函数按字段自动指派(pattern/patterns → regex kind)。
|
|
5
|
+
# dimensions:10 维度绑定,支持一字段多维度。
|
|
6
|
+
metadata:
|
|
7
|
+
name: "健壮性审计规则(写文件目录保障等)"
|
|
8
|
+
version: "1.0.3"
|
|
9
|
+
|
|
10
|
+
rules:
|
|
11
|
+
# ── 写文件前确保父目录存在(mkdir-before-write,用户素材)──
|
|
12
|
+
- id: robustness/mkdir-before-write
|
|
13
|
+
name: "写文件前必须确保目录存在"
|
|
14
|
+
category: "robustness"
|
|
15
|
+
severity: "warning"
|
|
16
|
+
description: "直接 writeFile 而不 mkdir 父目录,会导致 ENOENT 错误"
|
|
17
|
+
# 正则初筛 → token 级精筛(makeCodeLineFilter):剔除注释与字符串里的调用示例。
|
|
18
|
+
# 本规则是纯 regex,此前会把**说明本规则自身的文档**也命中——实测
|
|
19
|
+
# lib/checks/common.js 的 JSDoc(「会把注释/字符串里的 `fs.writeFile(...)`
|
|
20
|
+
# 示例一并命中」这句话本身)被报成 mkdir-before-write,属自举误报。
|
|
21
|
+
astConfirm: true
|
|
22
|
+
patterns:
|
|
23
|
+
- "fs\\.(writeFile|writeFileSync|appendFile|appendFileSync|createWriteStream)\\s*\\("
|
|
24
|
+
# 豁免场景:目录通常已存在的常见情况
|
|
25
|
+
exceptions:
|
|
26
|
+
- "目标目录为项目根目录"
|
|
27
|
+
- "目标目录已被显式创建"
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# ============================================================
|
|
2
|
+
# Rust 代码审计规则集(占位)
|
|
3
|
+
# 版本:0.1.0
|
|
4
|
+
# 适用:Rust 项目
|
|
5
|
+
# 描述:⚠️ 占位槽位——语言专项规则待补。放入此文件即完成「槽位就绪」:
|
|
6
|
+
# 审计系统自动发现本槽位(放 audit-rules-*.yml 即生效,零代码改动)。
|
|
7
|
+
# 当前 Rust 文件由 nodejs 槽位的语言无关规则(凭据/路径穿越/文件健康度等)兜底审计,
|
|
8
|
+
# 语言相关规则(短名/魔数/函数长度/复杂度/嵌套)待补 AST 层 rustFuncRanges 后启用。
|
|
9
|
+
# 待办(补规则时):① AST 层 lang.js 的 LANG_FUNC_RANGES.rust 实现函数范围收集
|
|
10
|
+
# (fn 关键字 + 花括号配对,pub fn / impl 块内 fn);② 本槽位按 python/java 先例
|
|
11
|
+
# 写 min_length/max_depth/max_lines/max_complexity/magic-number 规则,exts: ["rs"]。
|
|
12
|
+
# ============================================================
|
|
13
|
+
|
|
14
|
+
metadata:
|
|
15
|
+
name: "Rust 审计规则集(占位)"
|
|
16
|
+
version: "0.1.0"
|
|
17
|
+
language: "rust"
|
|
18
|
+
author: "DeepSeek"
|
|
19
|
+
description: "Rust 项目语言专用规则(占位——规则待补,槽位已就绪)"
|
|
20
|
+
last_updated: "2026-10-06"
|
|
21
|
+
|
|
22
|
+
rules: []
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
# 目录结构规范(本地定制版)
|
|
2
|
+
# 依据:DeepSeek《项目目录结构规范(最小通用版)v1.0》+ 本地逐条取舍讨论。
|
|
3
|
+
# 定位:本项目(DSH 插件 / 纯 JS + ESM + 无编译)的目录结构约定——
|
|
4
|
+
# 不是照搬通用规范,而是「取最小集 + 按需扩展 + 统一单数」。
|
|
5
|
+
# 执行:path-regex 规则校验「新增/变更文件的路径」是否违反单数命名(warning 提醒不拦截);
|
|
6
|
+
# 目录缺失/依赖方向等结构性约定由人/AI 遵守(详见 directory_roles 与 dependency_rules)。
|
|
7
|
+
metadata:
|
|
8
|
+
name: 目录结构规范(本地定制版)
|
|
9
|
+
author: EIGHTfs
|
|
10
|
+
version: "1.0.0"
|
|
11
|
+
description: "dsh-git-push 目录结构取舍结论:lib/ 平铺即源码(不引入 src/)、docs/ skills/ 保留、无 script/config/dist/log 空目录;统一单数命名(tool/ test/ doc/,不用 tools/ tests/ docs/)"
|
|
12
|
+
|
|
13
|
+
# ============================================================
|
|
14
|
+
# 一、取舍结论(2026-09-09 逐条讨论后定稿)
|
|
15
|
+
# ============================================================
|
|
16
|
+
decisions:
|
|
17
|
+
- item: "src/"
|
|
18
|
+
keep: false
|
|
19
|
+
reason: "纯 JS + ESM + 无编译,src/ 无收益(不编译就不需要源码/产物分离);已模块化拆分,lib/ 即源码"
|
|
20
|
+
- item: "lib/"
|
|
21
|
+
keep: true
|
|
22
|
+
reason: "DSH 插件生态惯例,lib/ 即核心代码目录(33 个功能模块);与规范『lib/ 只放第三方适配』语义错位但保留——插件场景下 lib/ 就是 src/"
|
|
23
|
+
- item: "tool/ 独立目录"
|
|
24
|
+
keep: false
|
|
25
|
+
reason: "cli.mjs 留根级(package.json bin 指向)+ lib/plugin-tools.js 单文件(9 工具 286 行)够用;到 30+ 工具再拆 tool/"
|
|
26
|
+
- item: "test/ 分层(unit/integration/e2e/fixture)"
|
|
27
|
+
keep: false
|
|
28
|
+
reason: "纯函数级单测无 unit/integration 实质分界;14 个 test-<module>.mjs 平铺,找测试=找模块;fixture 多了再收 test/fixture/"
|
|
29
|
+
- item: "doc/ 单数"
|
|
30
|
+
keep: false
|
|
31
|
+
reason: "现有 docs/(复数)已建立索引习惯,改名纯成本;新增目录一律单数,存量 docs/ 作为历史约定保留"
|
|
32
|
+
- item: "script/ config/ dist/ log/"
|
|
33
|
+
keep: false
|
|
34
|
+
reason: "无构建步骤(源码即产物);配置走 settings 机制 + lib/ 内 yml 规则数据(audit-rules/ readme-templates/ 同源部署,不抽顶层)"
|
|
35
|
+
- item: "skills/"
|
|
36
|
+
keep: true
|
|
37
|
+
reason: "DSH 插件特性:注入给 AI 的手册(dsh-git-push.md / dsh-git-push-functions.md / git-workflow-gitpush/),通用规范未覆盖"
|
|
38
|
+
- item: "client/ 独立目录(fullstack 场景)"
|
|
39
|
+
keep: false
|
|
40
|
+
reason: "DSH 客户端插件必须挂固定命名空间,不能自由放 client/;前端在 lib/client.js + lib/viewer.js 内"
|
|
41
|
+
|
|
42
|
+
# ============================================================
|
|
43
|
+
# 二、核心原则
|
|
44
|
+
# ============================================================
|
|
45
|
+
principles:
|
|
46
|
+
- "一致性优先于花哨:同类文件放同目录,同目录命名风格统一"
|
|
47
|
+
- "统一单数:所有功能目录用单数(tool/、test/、doc/、lib/),不用复数(tools/、tests/、docs/、libs/)"
|
|
48
|
+
- "工具与源码同库:cli.mjs 根级 + lib/plugin-tools.js 注册 agent 工具,不建空 tool/ 目录"
|
|
49
|
+
- "规则数据随代码:audit-rules/*.yml、readme-templates/*.yml 放 lib/ 子目录(files 白名单 + 相对路径解析依赖)"
|
|
50
|
+
- "最小可用:不预设未来需求,目录按需添加"
|
|
51
|
+
|
|
52
|
+
# ============================================================
|
|
53
|
+
# 三、目录清单(单数标准 + 复数禁止)
|
|
54
|
+
# ============================================================
|
|
55
|
+
naming:
|
|
56
|
+
standard_singular:
|
|
57
|
+
- "lib/" # 核心代码(本项目语义:即 src/)
|
|
58
|
+
- "test/" # 测试(test-<module>.mjs 平铺)
|
|
59
|
+
- "doc/" # 文档标准名(本项目存量用 docs/,新目录用 doc/)
|
|
60
|
+
- "tool/" # 工具标准名(当前未建独立目录,cli.mjs 根级 + lib/plugin-tools.js)
|
|
61
|
+
- "script/" # 运维脚本(当前无)
|
|
62
|
+
- "config/" # 非代码配置(当前无,配置走 settings)
|
|
63
|
+
- "dist/" # 构建产物(当前无)
|
|
64
|
+
- "log/" # 日志(当前无)
|
|
65
|
+
forbidden_plural:
|
|
66
|
+
- "tools/"
|
|
67
|
+
- "tests/"
|
|
68
|
+
- "libs/"
|
|
69
|
+
- "docs/" # 存量例外:现有 docs/ 保留不报;新目录禁止再建复数 docs/
|
|
70
|
+
- "scripts/"
|
|
71
|
+
- "configs/"
|
|
72
|
+
allowed_legacy:
|
|
73
|
+
- "docs/" # 历史约定(任务清单/检查清单所在),不再新增兄弟复数目录
|
|
74
|
+
|
|
75
|
+
# ============================================================
|
|
76
|
+
# 四、各目录职责(本地实际)
|
|
77
|
+
# ============================================================
|
|
78
|
+
directory_roles:
|
|
79
|
+
- name: "lib/"
|
|
80
|
+
role: "全部业务代码(平级模块化,等价规范 src/core + src/host + src/shared 合并)"
|
|
81
|
+
contents:
|
|
82
|
+
- "core.js - 门面 re-export(13 模块,0 import,等价 shared 无依赖层)"
|
|
83
|
+
- "git-core.js - git 基础执行"
|
|
84
|
+
- "github-api.js - GitHub API 访问(Git Data API / SSH 回退)"
|
|
85
|
+
- "commit-push.js - 提交推送编排"
|
|
86
|
+
- "audit.js - 审计引擎(L0 静态 + 规则执行)"
|
|
87
|
+
- "rule-packs.js - YAML 规则装载/编译"
|
|
88
|
+
- "audit-rules/ - 规则数据(nodejs/frontend/comment/dsh/npm/version/template/private/structure)"
|
|
89
|
+
- "readme-templates/ - README 模板 yml"
|
|
90
|
+
- "plugin-*.js - 装配层(host 等价:工具注册/HTTP/设置/审计服务接线)"
|
|
91
|
+
- "client.js viewer.js- 客户端 UI(DSH 命名空间内)"
|
|
92
|
+
dependencies: "模块间单向依赖、无环(拆分时保证);装配层依赖业务模块,业务模块不依赖装配层"
|
|
93
|
+
|
|
94
|
+
- name: "test/"
|
|
95
|
+
role: "自动化测试(纯函数级单测)"
|
|
96
|
+
contents:
|
|
97
|
+
- "test-<module>.mjs - 按被测模块命名(audit/core/rule-packs/cli/quality/viewer... 11 套件 476 断言)"
|
|
98
|
+
dependencies: "对应 lib/ 模块结构"
|
|
99
|
+
|
|
100
|
+
- name: "docs/"
|
|
101
|
+
role: "文档(存量复数,历史约定保留)"
|
|
102
|
+
contents:
|
|
103
|
+
- "任务清单 / code-quality-checklist.yaml / 方案模板"
|
|
104
|
+
dependencies: "无"
|
|
105
|
+
|
|
106
|
+
- name: "skills/"
|
|
107
|
+
role: "注入给 AI 的手册(DSH 插件特性)"
|
|
108
|
+
contents:
|
|
109
|
+
- "dsh-git-push.md / dsh-git-push-functions.md / task-completion-report.md / git-workflow-gitpush/"
|
|
110
|
+
dependencies: "无"
|
|
111
|
+
|
|
112
|
+
# ============================================================
|
|
113
|
+
# 五、根目录文件
|
|
114
|
+
# ============================================================
|
|
115
|
+
root_files:
|
|
116
|
+
- name: "package.json"
|
|
117
|
+
required: true
|
|
118
|
+
description: "项目元信息与依赖(files 白名单:lib/skills/docs/cordis.patch.yml)"
|
|
119
|
+
- name: "README.md"
|
|
120
|
+
required: true
|
|
121
|
+
description: "项目说明(含版本记录表)"
|
|
122
|
+
- name: ".gitignore"
|
|
123
|
+
required: true
|
|
124
|
+
description: "忽略规则"
|
|
125
|
+
- name: "cli.mjs"
|
|
126
|
+
required: true
|
|
127
|
+
description: "CLI 入口(package.json bin: git-sluice)"
|
|
128
|
+
- name: "cordis.patch.yml"
|
|
129
|
+
required: true
|
|
130
|
+
description: "DSH 插件配置(插件根)"
|
|
131
|
+
- name: ".env.example"
|
|
132
|
+
required: false
|
|
133
|
+
description: "环境变量模板(当前无,配置走 settings)"
|
|
134
|
+
|
|
135
|
+
# ============================================================
|
|
136
|
+
# 六、依赖方向规则(已满足,防未来破坏)
|
|
137
|
+
# ============================================================
|
|
138
|
+
dependency_rules:
|
|
139
|
+
- "core.js(门面) → 各业务模块(git-core/github-api/repo-scan/...)"
|
|
140
|
+
- "plugin-*.js(装配层) → 业务模块(单向,业务模块不依赖装配层)"
|
|
141
|
+
- "audit.js → rule-packs.js → audit-rules/*.yml(规则数据单向)"
|
|
142
|
+
- "禁止: 业务模块 → 装配层(plugin-*);装配层只在注册/接线时引用业务模块"
|
|
143
|
+
- "禁止: 规则 yml 依赖代码;代码引擎不得依赖具体规则内容(数据驱动)"
|
|
144
|
+
|
|
145
|
+
# ============================================================
|
|
146
|
+
# 七、机器执行:单数命名校验(path-regex,warning 提醒不拦截)
|
|
147
|
+
# ============================================================
|
|
148
|
+
# kind: path-regex——对新增/变更文件的路径匹配;命中复数目录名 → warning。
|
|
149
|
+
# 注意:docs/ 是存量允许例外(allowed_legacy),不在此拦截。
|
|
150
|
+
rules:
|
|
151
|
+
- id: structure/dir-singular
|
|
152
|
+
name: "目录命名统一单数(复数禁止)"
|
|
153
|
+
category: "maintainability"
|
|
154
|
+
severity: "warning"
|
|
155
|
+
kind: "path-regex"
|
|
156
|
+
description: "功能目录统一单数(tool/ test/ doc/ lib/),复数(tools/ tests/ docs/ scripts/ configs/ libs/)违反一致性原则"
|
|
157
|
+
pattern: "(?:^|/)(tools|tests|scripts|configs|libs|logs)/"
|
|
158
|
+
fixable: false
|
|
159
|
+
mitigation: "目录改单数:tools/→tool/、tests/→test/、scripts/→script/、configs/→config/、libs/→lib/、logs/→log/"
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# ============================================================
|
|
2
|
+
# Swift 代码审计规则集(占位)
|
|
3
|
+
# 版本:0.1.0
|
|
4
|
+
# 适用:Swift 项目(iOS/macOS)
|
|
5
|
+
# 描述:⚠️ 占位槽位——语言专项规则待补。放入此文件即完成「槽位就绪」:
|
|
6
|
+
# 审计系统自动发现本槽位(放 audit-rules-*.yml 即生效,零代码改动)。
|
|
7
|
+
# 当前 Swift 文件由 nodejs 槽位的语言无关规则(凭据/路径穿越/文件健康度等)兜底审计,
|
|
8
|
+
# 语言相关规则(短名/魔数/函数长度/复杂度/嵌套)待补 AST 层 swiftFuncRanges 后启用。
|
|
9
|
+
# 待办(补规则时):① AST 层 lang.js 的 LANG_FUNC_RANGES.swift 实现函数范围收集
|
|
10
|
+
# (func 关键字 + 花括号配对,含 `func name()` 与 `func name() async throws`);
|
|
11
|
+
# ② 本槽位按 python/java 先例写规则,exts: ["swift"]。
|
|
12
|
+
# ============================================================
|
|
13
|
+
|
|
14
|
+
metadata:
|
|
15
|
+
name: "Swift 审计规则集(占位)"
|
|
16
|
+
version: "0.1.0"
|
|
17
|
+
language: "swift"
|
|
18
|
+
author: "DeepSeek"
|
|
19
|
+
description: "Swift 项目语言专用规则(占位——规则待补,槽位已就绪)"
|
|
20
|
+
last_updated: "2026-10-06"
|
|
21
|
+
|
|
22
|
+
rules: []
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
# ============================================================
|
|
2
|
+
# 审计规则纯模板(自定义规则入口)
|
|
3
|
+
# 作者:DeepSeek
|
|
4
|
+
# 版本:1.0.0
|
|
5
|
+
# 描述:空白模板,用于自定义添加审计规则
|
|
6
|
+
# 最后更新:2026-09-08
|
|
7
|
+
# ============================================================
|
|
8
|
+
|
|
9
|
+
metadata:
|
|
10
|
+
name: "自定义审计规则集"
|
|
11
|
+
version: "1.0.0"
|
|
12
|
+
language: "all"
|
|
13
|
+
author: "DeepSeek"
|
|
14
|
+
description: "根据项目需求自定义填充规则"
|
|
15
|
+
last_updated: "2026-09-08"
|
|
16
|
+
|
|
17
|
+
rules:
|
|
18
|
+
# ----- 示例规则(请替换为你的规则) -----
|
|
19
|
+
# - id: category/rule-name
|
|
20
|
+
# name: "规则显示名称"
|
|
21
|
+
# category: "category"
|
|
22
|
+
# severity: "warning" # error | warning | info
|
|
23
|
+
# description: "规则详细说明"
|
|
24
|
+
# pattern: "^正则表达式$"
|
|
25
|
+
# fixable: true
|
|
26
|
+
# examples:
|
|
27
|
+
# bad: "错误示例"
|
|
28
|
+
# good: "正确示例"
|
|
29
|
+
|
|
30
|
+
# ----- 目录结构校验(kind: path-regex——对文件路径跑正则,如复数目录名) -----
|
|
31
|
+
# - id: structure/dir-singular
|
|
32
|
+
# name: "目录命名统一单数"
|
|
33
|
+
# category: "maintainability"
|
|
34
|
+
# severity: "warning"
|
|
35
|
+
# kind: "path-regex"
|
|
36
|
+
# pattern: "(?:^|/)(tools|tests|scripts|configs|libs|logs)/"
|
|
37
|
+
|
|
38
|
+
# ----- 嵌套深度(kind: max-depth——缩进层级超阈值) -----
|
|
39
|
+
# - id: readability/max-nesting-depth
|
|
40
|
+
# name: "嵌套过深"
|
|
41
|
+
# category: "readability"
|
|
42
|
+
# severity: "warning"
|
|
43
|
+
# max_depth: 3
|
|
44
|
+
|
|
45
|
+
# ----- 重复硬编码字符串(kind: repeated-string——字面量出现数 + 白名单豁免) -----
|
|
46
|
+
# - id: security/no-repeated-hardcoded-literals
|
|
47
|
+
# name: "检测重复出现的硬编码文本"
|
|
48
|
+
# category: "security"
|
|
49
|
+
# severity: "warning"
|
|
50
|
+
# min_occurrences: 3
|
|
51
|
+
# ignore_patterns: ["^\\d+$", "^utf-?8$"]
|
|
52
|
+
# ignore_values: ["0", "1", "true", "false", "null", "undefined", "''", "\"\""]
|
|
53
|
+
|
|
54
|
+
# ----- 空规则占位(启动时无检查) -----
|
|
55
|
+
- id: placeholder/example
|
|
56
|
+
name: "示例规则(可删除)"
|
|
57
|
+
category: "placeholder"
|
|
58
|
+
severity: "info"
|
|
59
|
+
description: "请替换为实际规则"
|
|
60
|
+
pattern: "^$"
|
|
61
|
+
fixable: false
|
|
62
|
+
|
|
63
|
+
# ----- 严重级别映射(可自定义) -----
|
|
64
|
+
severity_map:
|
|
65
|
+
error: "error"
|
|
66
|
+
warning: "warning"
|
|
67
|
+
info: "info"
|
|
68
|
+
|
|
69
|
+
# ----- 阈值配置(按需调整) -----
|
|
70
|
+
thresholds:
|
|
71
|
+
max_warnings: 20
|
|
72
|
+
max_errors: 0
|
|
73
|
+
max_info: 50
|
|
74
|
+
|
|
75
|
+
# ----- 忽略规则(按需调整) -----
|
|
76
|
+
ignore:
|
|
77
|
+
- pattern: "**/node_modules/**/*"
|
|
78
|
+
rules: ["*"]
|
|
79
|
+
- pattern: "**/dist/**/*"
|
|
80
|
+
rules: ["*"]
|
|
81
|
+
- pattern: "**/*.{test,spec}.js"
|
|
82
|
+
rules: ["*"]
|
|
83
|
+
|
|
84
|
+
# ----- 输出配置(按需调整) -----
|
|
85
|
+
output:
|
|
86
|
+
format: "json"
|
|
87
|
+
include_suggestions: true
|
|
88
|
+
include_code_snippets: true
|
|
89
|
+
|
|
90
|
+
# ============================================================
|
|
91
|
+
# 注释豁免标记速查(每种拦截类型可独立豁免)
|
|
92
|
+
# ============================================================
|
|
93
|
+
# 位置语义:写在「文件头注释(前 3 行)」= 整个文件豁免该拦截类型;
|
|
94
|
+
# 写在「对应位置注释」= 只豁免该位置(secret 支持行尾单行)。
|
|
95
|
+
#
|
|
96
|
+
# dsh-skip-sensitive → 豁免敏感内容(secret/凭据/隐私措辞)——行尾=单行 / 文件头=整文件
|
|
97
|
+
# dsh-skip-size → 豁免二进制/大文件检查(只能写文件头——文件大小是整文件属性)
|
|
98
|
+
# dsh-skip-func-length → 豁免函数长度检查(文件头=全文件;函数定义行尾=单函数)
|
|
99
|
+
# dsh-skip-syntax → 豁免语法/JSON/YAML 解析(只能写文件头)
|
|
100
|
+
# dsh-skip-quality → 豁免质量评分(func-lines/silent-catch/sync-in-async)(文件头)
|
|
101
|
+
# dsh-skip-residue → 豁免残留类(debugger/todo/console)(行尾=单行 / 文件头=整文件)
|
|
102
|
+
# dsh-skip-style → 豁免全部 styleRules(文件头)
|
|
103
|
+
#
|
|
104
|
+
# 示例:
|
|
105
|
+
# // dsh-skip-sensitive (行尾=本行不做敏感扫描)
|
|
106
|
+
# /** dsh-skip-size */ (文件头=本文件不报大文件)
|
|
107
|
+
# function x() { ... } // dsh-skip-func-length (函数定义行尾=跳过该函数长度检查)
|
|
108
|
+
include_fix_instructions: true
|
|
@@ -0,0 +1,276 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 检查层 · 按钮事件绑定交叉比对
|
|
3
|
+
*
|
|
4
|
+
* 职责:HTML 里的按钮/选择器与 JS 里的事件绑定交叉比对,识别「声明了但没绑定」等缺陷。
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { join } from 'node:path';
|
|
8
|
+
|
|
9
|
+
import { makeFinding } from '../audit/index.js';
|
|
10
|
+
import { HINT_QUALITY } from './common.js';
|
|
11
|
+
import { tokenize } from '../ast/tokenizer.js';
|
|
12
|
+
|
|
13
|
+
/* ═══════════════ 按钮事件绑定检查(button-bind, 油猴脚本版) ═══════════════ */
|
|
14
|
+
|
|
15
|
+
/* ═══════════════ JSX 工厂调用的按钮提取 ═══════════════ */
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* 从 startIdx 起取「括号配平的完整调用表达式」片段。
|
|
19
|
+
*
|
|
20
|
+
* 为什么必须配平:`jsx.jsx('button', {` 只是调用开头,事件属性在后续行——
|
|
21
|
+
* 只看单行会把 15 个按钮全判成「无 onClick」(实测踩过)。圆括号与花括号
|
|
22
|
+
* 都参与计数:属性对象用 {}、字符串里的括号不应计数(本函数按引号状态跳过)。
|
|
23
|
+
* @param {string} text
|
|
24
|
+
* @param {number} startIdx
|
|
25
|
+
* @param {number} maxLen 安全上限,避免未闭合时扫到文件尾
|
|
26
|
+
* @returns {{snippet:string, endIdx:number}}
|
|
27
|
+
*/
|
|
28
|
+
export function readBalancedCall(text, startIdx, maxLen = 4000) {
|
|
29
|
+
let depth = 0;
|
|
30
|
+
let started = false;
|
|
31
|
+
let quote = '';
|
|
32
|
+
const end = Math.min(String(text || '').length, startIdx + maxLen);
|
|
33
|
+
for (let i = startIdx; i < end; i++) {
|
|
34
|
+
const ch = text[i];
|
|
35
|
+
if (quote) {
|
|
36
|
+
if (ch === '\\') { i++; continue; }
|
|
37
|
+
if (ch === quote) quote = '';
|
|
38
|
+
continue;
|
|
39
|
+
}
|
|
40
|
+
if (ch === "'" || ch === '"' || ch === '`') { quote = ch; continue; }
|
|
41
|
+
if (ch === '(' || ch === '{' || ch === '[') { depth++; started = true; continue; }
|
|
42
|
+
if (ch === ')' || ch === '}' || ch === ']') {
|
|
43
|
+
depth--;
|
|
44
|
+
if (started && depth <= 0) return { snippet: text.slice(startIdx, i + 1), endIdx: i + 1 };
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
return { snippet: text.slice(startIdx, end), endIdx: end };
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* 抽取 JSX 工厂调用创建的按钮:jsx.jsx('button', {...}) / jsxs(...) / h('button', ...)。
|
|
52
|
+
*
|
|
53
|
+
* 为什么需要:client.js 里 15 个按钮全是这种调用式创建,而本检查原先只认
|
|
54
|
+
* innerHTML 字符串 / 反引号模板 / createElement——对这种形态完全不可见
|
|
55
|
+
* (实测对 client.js 跑出 0 条 finding,两个「点了没反应」的按钮也漏掉)。
|
|
56
|
+
* 绑定判定:属性对象里出现 onClick/onChange/onInput/onSubmit 等 on[A-Z] 事件属性即已绑定。
|
|
57
|
+
* @param {string} text
|
|
58
|
+
* @returns {Array<{line:number, event:string, text:string}>}
|
|
59
|
+
*/
|
|
60
|
+
export function extractJsxButtons(text) {
|
|
61
|
+
const out = [];
|
|
62
|
+
// 前置 (?<![\w$]) 只排除标识符字符,**不能排除 '.'**——本仓写法是 `jsx.jsx(...)`,
|
|
63
|
+
// 把 '.' 也否定掉会让 jsx 永远不匹配(实测提取数 0)。命名空间前缀(jsx./React.)允许。
|
|
64
|
+
//
|
|
65
|
+
// 修三处误报:
|
|
66
|
+
// ① 只认 'button',不再把 'input' 当按钮候选——input 用 onChange 传值,本就不需要
|
|
67
|
+
// onClick,混进来会产出「input 未绑定」的假 finding(实测 client.js 11 个 input 全中)。
|
|
68
|
+
// ② 只在**代码片段**上匹配,注释里提到的 'button' 不再算数——原先直接 re.exec(text) 扫原文,
|
|
69
|
+
// 本文件自己的文档注释里写 `jsx.jsx('button', {...})` 就被当真按钮报了 3 条。
|
|
70
|
+
// ③ 行号按匹配位置修正到「实际 tag 所在行」——原先用 m.index 算行号,跨行属性对象下
|
|
71
|
+
// 会漂到前一个调用上(实测把 616 行的 input 报成 623 行 button 的位置)。
|
|
72
|
+
const re = /(?<![\w$])(?:(?:[\w$]+\.)*jsxs?|h|React\.createElement)\s*\(\s*['"]button['"]/g;
|
|
73
|
+
const code = stripCommentLines(text);
|
|
74
|
+
let match;
|
|
75
|
+
while ((match = re.exec(code)) !== null) {
|
|
76
|
+
const { snippet } = readBalancedCall(text, match.index);
|
|
77
|
+
// 事件属性要在**非注释**片段上判定:注释里写 `// onClick: 不算` 不能算已绑定
|
|
78
|
+
// (注释与代码同为「有 onClick」的两个方向都会骗过纯文本正则,故两者都要过滤)
|
|
79
|
+
const ev = /\bon([A-Z][A-Za-z]*)\s*:/.exec(stripCommentLines(snippet));
|
|
80
|
+
// 按钮文本(children)用于提示可读性
|
|
81
|
+
const label = (/children\s*:\s*['"`]([^'"`]{1,30})['"`]/.exec(snippet) || [])[1]
|
|
82
|
+
|| (/['"`]([^'"`]{1,20})['"`]\s*\]/.exec(snippet) || [])[1] || '';
|
|
83
|
+
out.push({
|
|
84
|
+
line: text.slice(0, match.index).split('\n').length,
|
|
85
|
+
tag: 'button',
|
|
86
|
+
event: ev ? `on${ev[1]}` : '',
|
|
87
|
+
text: String(label).trim(),
|
|
88
|
+
blank: !ev,
|
|
89
|
+
});
|
|
90
|
+
}
|
|
91
|
+
return out;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* 把注释所在行整行替换为空格(保持行数与长度)。
|
|
96
|
+
*
|
|
97
|
+
* 为什么需要:提取按钮时若直接扫原文,注释里写的 `jsx.jsx('button', {...})` 会被当成真按钮
|
|
98
|
+
* (本文件自己的文档注释即触发 3 条假 finding)。
|
|
99
|
+
* 为什么按行而非按 token 偏移:tokenizer 的 token 只带 `line`、不带字符偏移,
|
|
100
|
+
* 按行处理是现有能力下最简洁且无误伤的做法——代价是「行尾注释后的真代码」也会被整行
|
|
101
|
+
* 略去,但那种写法(`const x = jsx.jsx('button',{}) // 注`)在本仓并不存在,
|
|
102
|
+
* 且真按钮几乎总是跨行属性对象,实际影响可忽略。
|
|
103
|
+
* @param {string} text
|
|
104
|
+
* @returns {string} 与输入逐行等长的文本,注释行内容为空格
|
|
105
|
+
*/
|
|
106
|
+
function stripCommentLines(text) {
|
|
107
|
+
const lines = String(text || '').split('\n');
|
|
108
|
+
try {
|
|
109
|
+
const commentLines = new Set();
|
|
110
|
+
for (const tk of tokenize(text)) if (tk && tk.type === 'comment') commentLines.add(tk.line);
|
|
111
|
+
for (const ln of commentLines) {
|
|
112
|
+
const idx = ln - 1;
|
|
113
|
+
if (idx >= 0 && idx < lines.length) lines[idx] = ' '.repeat(lines[idx].length);
|
|
114
|
+
}
|
|
115
|
+
} catch {
|
|
116
|
+
// 分词失败(语法不完整等)时退回原文:宁可多报也不静默漏报
|
|
117
|
+
return String(text || '');
|
|
118
|
+
}
|
|
119
|
+
return lines.join('\n');
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* 油猴脚本/浏览器扩展按钮事件绑定交叉比对(同文件内)。
|
|
124
|
+
* 场景:HTML 以字符串形式内嵌在 JS(innerHTML=/insertAdjacentHTML/模板字符串/createElement),
|
|
125
|
+
* 事件在 JS 里用 addEventListener/onclick= 赋值绑定——不能只看 HTML 里有没有 inline onclick。
|
|
126
|
+
*
|
|
127
|
+
* 三步:
|
|
128
|
+
* 1. 从 JS 文本提取「HTML 字符串中的按钮」(inline onclick 降级 info 不计为绑定证据)
|
|
129
|
+
* 2. 从同一文本提取「绑定证据」:addEventListener('click' / .onclick= 赋值 / 自定义 on* 函数调用 pattern
|
|
130
|
+
* 3. 交叉比对:按钮 id/class/text 能在绑定证据中找到 → 已绑定;找不到 → unbound warning
|
|
131
|
+
*
|
|
132
|
+
* 只报 warning 不阻断(手工确认绑定方式),inline onclick 场景报 info 建议。
|
|
133
|
+
* 输入规则约定(yml 声明 kind: button-bind,或 category: 'button' 无 patterns):
|
|
134
|
+
* - rule.extra.buttonInsertPatterns / bindPatterns 可选覆盖(默认内置油猴常用模式)
|
|
135
|
+
* @param {object} opts { file, text, rules }
|
|
136
|
+
* @returns {Array} findings
|
|
137
|
+
*/
|
|
138
|
+
export function checkButtonBindings({ file, text, rules }) {
|
|
139
|
+
const findings = [];
|
|
140
|
+
if (!text) return findings;
|
|
141
|
+
|
|
142
|
+
const btns = [];
|
|
143
|
+
const binds = new Set();
|
|
144
|
+
let hasDelegation = false;
|
|
145
|
+
|
|
146
|
+
// ── 1. 提取 HTML 字符串中的按钮 ──
|
|
147
|
+
// innerHTML='...' 或 innerHTML="..."(含模板字符串反引号)
|
|
148
|
+
const htmlChunks = [];
|
|
149
|
+
const chunkRe = /(?:innerHTML|outerHTML|insertAdjacentHTML\s*\([^)]*\))\s*=\s*(`[^`]*`|'[^']*'|"[^"]*")/g;
|
|
150
|
+
let match;
|
|
151
|
+
while ((match = chunkRe.exec(text)) !== null) {
|
|
152
|
+
htmlChunks.push({ html: match[1], start: match.index });
|
|
153
|
+
}
|
|
154
|
+
// 模板字符串里的 <button ...>...</button>(不局限于 innerHTML 赋值)
|
|
155
|
+
const tplChunks = [];
|
|
156
|
+
const tplRe = /`[^`]*<button[^`]*`/g;
|
|
157
|
+
while ((match = tplRe.exec(text)) !== null) tplChunks.push({ html: match[0], start: match.index });
|
|
158
|
+
|
|
159
|
+
const btnRe = /<button\b([^>]*)>([\s\S]*?)<\/button\s*>|<input\b[^>]*type\s*=\s*['"](?:button|submit)['"][^>]*>/gi;
|
|
160
|
+
// JSX/React 事件属性(onClick=/onChange= 等驼峰 on[A-Z])→ 声明式绑定,视为已绑定(防 React 代码误报 unbound)
|
|
161
|
+
const jsxEventRe = /\bon[A-Z][\w]*\s*=\s*[\{'"`]/;
|
|
162
|
+
for (const chunk of htmlChunks.concat(tplChunks)) {
|
|
163
|
+
let bm;
|
|
164
|
+
while ((bm = btnRe.exec(chunk.html)) !== null) {
|
|
165
|
+
const attrs = bm[1] || '';
|
|
166
|
+
const line = text.slice(0, chunk.start + bm.index).split('\n').length;
|
|
167
|
+
btns.push({
|
|
168
|
+
line,
|
|
169
|
+
id: (attrs.match(/\bid=["']([^"']+)["']/i) || [])[1] || '',
|
|
170
|
+
class: (attrs.match(/\bclass=["']([^"']+)["']/i) || [])[1] || '',
|
|
171
|
+
text: (bm[2] || '').replace(/<[^>]*>/g, '').trim().slice(0, 30),
|
|
172
|
+
hasInline: /\bonclick\s*=/.test(attrs),
|
|
173
|
+
jsxBound: jsxEventRe.test(attrs), // React 声明式事件(onClick 等驼峰)
|
|
174
|
+
});
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
// JSX 工厂调用创建的按钮(jsx.jsx('button', {...}))——与 HTML 字符串同等待遇:
|
|
178
|
+
// 属性里有 onClick 等事件属性即已绑定;没有则进 unbound 判定(原先完全不可见)
|
|
179
|
+
const jsxBtns = extractJsxButtons(text);
|
|
180
|
+
// createElement('button') 创建的按钮:后续调用 addEventListener 才算绑定
|
|
181
|
+
const created = [];
|
|
182
|
+
const createRe = /createElement\s*\(\s*['"](button|input)['"]\s*\)/g;
|
|
183
|
+
while ((match = createRe.exec(text)) !== null) {
|
|
184
|
+
created.push({ line: text.slice(0, match.index).split('\n').length, tag: match[1] });
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
// ── 2. 提取绑定证据(选择器引用 + 绑定调用 + 事件委托)──
|
|
188
|
+
// 覆盖:getElementById / querySelector / querySelectorAll(含属性选择器)/ jQuery $() / .onclick= / .addEventListener('click'
|
|
189
|
+
const bindRe = /(?:getElementById\s*\(\s*['"]([^'"]+)['"]|querySelector(?:All)?\s*\(\s*['"]([^'"]+)['"]|\$\s*\(\s*['"]([^'"]+)['"]|\.addEventListener\s*\(\s*['"]click['"]|\.onclick\s*=|\.on\s*\(\s*['"\]click['"])/g;
|
|
190
|
+
while ((match = bindRe.exec(text)) !== null) {
|
|
191
|
+
for (const sel of [match[1], match[2], match[3]]) {
|
|
192
|
+
if (sel) binds.add(sel);
|
|
193
|
+
if (sel && sel.startsWith('#')) binds.add(sel.slice(1)); // #id 同时存 id
|
|
194
|
+
if (sel && sel.startsWith('.')) binds.add(sel); // .class 已存;供 class 匹配
|
|
195
|
+
}
|
|
196
|
+
if (match[0].includes('addEventListener') || match[0].includes('.onclick') || match[0].includes('.on(')) binds.add('__has_click_handler__');
|
|
197
|
+
}
|
|
198
|
+
// 事件委托识别(更宽):父级 .addEventListener('click' + e.target.closest('选择器') 任一出现即视为委托面
|
|
199
|
+
// 覆盖:document.body.addEventListener('click' / container.addEventListener('click' / ev.target.closest('.btn') 分发
|
|
200
|
+
const delegationRe = /\.addEventListener\s*\(\s*['"]click['"]|\.closest\s*\(\s*['"][^'"]+['"]\)/g;
|
|
201
|
+
if (delegationRe.test(text)) hasDelegation = true;
|
|
202
|
+
// 委托分发选择器(ev.target.closest('.mm-retry-btn'))也入 binds——按 class 匹配绑定面
|
|
203
|
+
const closestRe = /\.closest\s*\(\s*['"]([^'"]+)['"]\)/g;
|
|
204
|
+
while ((match = closestRe.exec(text)) !== null) {
|
|
205
|
+
if (match[1]) binds.add(match[1]);
|
|
206
|
+
if (match[1] && match[1].startsWith('#')) binds.add(match[1].slice(1));
|
|
207
|
+
}
|
|
208
|
+
// 属性选择器引用(querySelectorAll("button[data-dl]"))→ 按钮 data-* 匹配用
|
|
209
|
+
const attrSelRe = /querySelector(?:All)?\s*\(\s*['"]([^'"]*(?:\[[a-z-]+\][^'"]*)?)['"]\)/g;
|
|
210
|
+
while ((match = attrSelRe.exec(text)) !== null) {
|
|
211
|
+
const ms = match[1]?.match(/\[([a-z][\w-]*)\]/g) || [];
|
|
212
|
+
for (const at of ms) binds.add(at); // [data-dl] 等原样存入
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
// ── 3. 交叉比对 ──
|
|
216
|
+
// 3a. JSX 工厂按钮:有事件属性即已绑定;无则报 unbound(不再依赖 HTML/选择器比对,
|
|
217
|
+
// 因为绑定就写在同一个属性对象里,交叉比对没必要也不可靠)
|
|
218
|
+
for (const b of jsxBtns) {
|
|
219
|
+
if (!b.blank) continue;
|
|
220
|
+
findings.push(makeFinding({
|
|
221
|
+
file, line: b.line, rule: 'button/unbound', kind: 'button-bind',
|
|
222
|
+
severity: 'warning',
|
|
223
|
+
message: `按钮「${b.text || '(无文本)'}」(行 ${b.line})用 jsx 工厂调用创建但属性里没有 onClick 等事件属性——若由父级事件委托处理请加豁免标记`,
|
|
224
|
+
dimensions: ['可维护性'], exemptHint: HINT_QUALITY, scoreImpact: 1,
|
|
225
|
+
}));
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
// 3b. HTML 字符串里的按钮
|
|
229
|
+
for (const btn of btns) {
|
|
230
|
+
// JSX/React 声明式事件:onClick 等驼峰属性 = 已绑定(React 虚拟 DOM 内声明式,非油猴场景)
|
|
231
|
+
if (btn.jsxBound) continue;
|
|
232
|
+
// inline onclick:有绑定但建议改(info)
|
|
233
|
+
if (btn.hasInline) {
|
|
234
|
+
findings.push(makeFinding({
|
|
235
|
+
file, line: btn.line, rule: 'button/inline-binding-in-string', kind: 'button-bind',
|
|
236
|
+
severity: 'notice',
|
|
237
|
+
message: `油猴脚本 HTML 字符串中的按钮含 inline onclick(行 ${btn.line}):通常无法访问闭包作用域且易违反 CSP,建议改 addEventListener/事件委托`,
|
|
238
|
+
dimensions: ['可读性'], exemptHint: HINT_QUALITY, scoreImpact: 0,
|
|
239
|
+
}));
|
|
240
|
+
continue;
|
|
241
|
+
}
|
|
242
|
+
// 事件委托覆盖:父级监听了 click(含 closest 分发)→ 默认视为已覆盖
|
|
243
|
+
if (hasDelegation) continue;
|
|
244
|
+
let matched = false;
|
|
245
|
+
if (btn.id && (binds.has(btn.id) || binds.has(`#${btn.id}`))) matched = true;
|
|
246
|
+
if (!matched && btn.class) {
|
|
247
|
+
for (const cls of btn.class.split(/\s+/)) {
|
|
248
|
+
if (cls && binds.has(`.${cls}`)) { matched = true; break; }
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
if (!matched && created.length) {
|
|
252
|
+
// createElement 按钮:要求同一文件存在 addEventListener/onclick 痕迹
|
|
253
|
+
matched = binds.has('__has_click_handler__');
|
|
254
|
+
}
|
|
255
|
+
if (!matched) {
|
|
256
|
+
findings.push(makeFinding({
|
|
257
|
+
file, line: btn.line, rule: 'button/unbound', kind: 'button-bind',
|
|
258
|
+
severity: 'warning',
|
|
259
|
+
message: `按钮「${btn.text || btn.id || '(无文本)'}」(行 ${btn.line})在 HTML 字符串中但未在 JS 中找到绑定证据——若通过事件委托/封装函数绑定请加豁免标记`,
|
|
260
|
+
dimensions: ['可维护性'], exemptHint: HINT_QUALITY, scoreImpact: 1,
|
|
261
|
+
}));
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
// createElement('button'/'input') 创建的按钮:文件无任何点击绑定痕迹 → 未绑定
|
|
265
|
+
// (jsx 工厂按钮已由 3a 单独判定,不参与此处兜底,避免互相掩盖)
|
|
266
|
+
if (created.length && !binds.has('__has_click_handler__')) {
|
|
267
|
+
const lineNos = [...new Set(created.map((c) => c.line))].sort((a, b) => a - b);
|
|
268
|
+
findings.push(makeFinding({
|
|
269
|
+
file, line: lineNos[0], rule: 'button/create-element-binding', kind: 'button-bind',
|
|
270
|
+
severity: 'warning',
|
|
271
|
+
message: `createElement('${created[0].tag}') 创建了按钮(行 ${lineNos.join('/')})但同文件未找到 addEventListener/onclick 绑定——请在 appendChild 前绑定事件`,
|
|
272
|
+
dimensions: ['可维护性'], exemptHint: HINT_QUALITY, scoreImpact: 1,
|
|
273
|
+
}));
|
|
274
|
+
}
|
|
275
|
+
return findings;
|
|
276
|
+
}
|