dsh-git-push 2.20.19 → 3.1.0
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/README.md +76 -47
- package/cli-tool.mjs +2 -4
- package/cli.mjs +11 -4
- package/lib/app/apply.js +15 -13
- package/lib/app/command-registry.js +26 -19
- package/lib/app/handlers/http-constants.js +8 -0
- package/lib/app/handlers/meta.js +2 -2
- package/lib/app/handlers/preprocess.js +104 -0
- package/lib/app/handlers/repo-actions.js +2 -3
- package/lib/app/handlers/repos.js +137 -10
- package/lib/app/handlers/settings.js +34 -15
- package/lib/app/http-handlers.js +13 -42
- package/lib/app/index.js +3 -2
- package/lib/app/inject-text.js +6 -21
- package/lib/app/preprocess-client.js +136 -0
- package/lib/app/repo-ownership.js +1 -1
- package/lib/app/schema.js +20 -10
- package/lib/app/settings-bridge.js +60 -8
- package/lib/app/severity.js +14 -0
- package/lib/app/slash-commands.js +5 -164
- package/lib/app/tool-call.js +96 -163
- package/lib/cli/commands-preprocess.mjs +74 -0
- package/lib/cli/commands-tool.mjs +3 -2
- package/lib/cli/commands-vcs.mjs +39 -5
- package/lib/cli/shared.mjs +36 -10
- package/lib/client/index.js +11 -16
- package/lib/client-parts/git/account.js +21 -12
- package/lib/client-parts/git/actions.js +23 -77
- package/lib/client-parts/git/apply.js +8 -2
- package/lib/client-parts/git/browser.js +1 -1
- package/lib/client-parts/git/const.js +33 -1
- package/lib/client-parts/git/controller.js +175 -176
- package/lib/client-parts/git/icons.js +1 -1
- package/lib/client-parts/git/loader.js +1 -1
- package/lib/client-parts/git/npm.js +56 -37
- package/lib/client-parts/git/page.js +53 -1
- package/lib/client-parts/git/repo.js +8 -1
- package/lib/client-parts/git/settings.js +13 -1
- package/lib/client-parts/git/state.js +237 -0
- package/lib/client-parts/git/utils.js +1 -1
- package/lib/client.js +631 -312
- package/lib/commit-push/pre-commit-engine.js +629 -30
- package/lib/commit-push.js +127 -67
- package/lib/context/index.js +7 -5
- package/lib/core/config.js +1 -27
- package/lib/core/exec.js +2 -11
- package/lib/{exempt/index.js → git/exempt-markers.js} +8 -1
- package/lib/git/identity-rewrite.js +1 -1
- package/lib/git/ignore.js +1 -1
- package/lib/git/index.js +1 -1
- package/lib/git/push.js +2 -17
- package/lib/git/repo-index.js +8 -3
- package/lib/git/repos.js +2 -2
- package/lib/git/sensitive.js +1 -1
- package/lib/npm/install.js +1 -1
- package/lib/npm/publish.js +20 -5
- package/lib/npm/registry.js +2 -2
- package/lib/plugin/auto-push.js +5 -8
- package/lib/preprocess/providers.js +195 -0
- package/lib/self/index.js +1 -1
- package/lib/skip-dirs.js +14 -55
- package/package.json +31 -42
- package/skills/dev/dsh-git-push.md +9 -9
- package/skills/guide/guide-commit-push.md +11 -13
- package/skills/workflow/README.md +0 -1
- package/skills/workflow/task-completion-report.md +2 -2
- package/.auditignore +0 -30
- package/.gitignore +0 -43
- package/cli-audit.mjs +0 -141
- package/lib/BUGFIX-NOTES-2026-09-14.md +0 -278
- package/lib/app/audit-api.js +0 -173
- package/lib/app/handlers/audit.js +0 -150
- package/lib/app/host-doc-checks.js +0 -25
- package/lib/app/schema-audit.js +0 -42
- package/lib/app/scope-check.js +0 -69
- package/lib/ast/brace.js +0 -120
- package/lib/ast/callgraph.js +0 -135
- package/lib/ast/code-lines.js +0 -175
- package/lib/ast/consts.js +0 -12
- package/lib/ast/control-flow.js +0 -470
- package/lib/ast/credential.js +0 -315
- package/lib/ast/dataflow.js +0 -391
- package/lib/ast/dup-code.js +0 -165
- package/lib/ast/fs-hotspots.js +0 -154
- package/lib/ast/index.js +0 -38
- package/lib/ast/io-risk-const.js +0 -95
- package/lib/ast/io-risk-fn.js +0 -208
- package/lib/ast/io-risk-loop.js +0 -308
- package/lib/ast/io-risk.js +0 -314
- package/lib/ast/lang.js +0 -156
- package/lib/ast/line-count.js +0 -52
- package/lib/ast/magic-number.js +0 -272
- package/lib/ast/naming.js +0 -292
- package/lib/ast/perf.js +0 -488
- package/lib/ast/scope-collisions.js +0 -228
- package/lib/ast/scope.js +0 -241
- package/lib/ast/shell.js +0 -131
- package/lib/ast/size.js +0 -448
- package/lib/ast/symbol-index.js +0 -399
- package/lib/ast/tokenizer.js +0 -421
- package/lib/ast/treesitter.js +0 -413
- package/lib/audit/analysis-coverage.js +0 -98
- package/lib/audit/audit-file.js +0 -205
- package/lib/audit/auditignore-rules.js +0 -148
- package/lib/audit/checks.js +0 -17
- package/lib/audit/client-entry.js +0 -93
- package/lib/audit/collector.js +0 -610
- package/lib/audit/ext-runner.js +0 -80
- package/lib/audit/file-context.js +0 -391
- package/lib/audit/finding.js +0 -101
- package/lib/audit/gitignore-match.js +0 -113
- package/lib/audit/glob.js +0 -63
- package/lib/audit/history-report.js +0 -100
- package/lib/audit/history.js +0 -126
- package/lib/audit/ignore-blind.js +0 -102
- package/lib/audit/index.js +0 -33
- package/lib/audit/orchestrate.js +0 -672
- package/lib/audit/public.js +0 -24
- package/lib/audit/repo-level.js +0 -30
- package/lib/audit/report-yaml.js +0 -90
- package/lib/audit/scope-policy.js +0 -110
- package/lib/audit/slot.js +0 -66
- package/lib/audit-rules/audit-rules-comment.yml +0 -199
- package/lib/audit-rules/audit-rules-cpp.yml +0 -114
- package/lib/audit-rules/audit-rules-csharp.yml +0 -82
- package/lib/audit-rules/audit-rules-docs.yml +0 -32
- package/lib/audit-rules/audit-rules-dsh.yml +0 -177
- package/lib/audit-rules/audit-rules-filehealth.yml +0 -42
- package/lib/audit-rules/audit-rules-folder.yml +0 -99
- package/lib/audit-rules/audit-rules-frontend.yml +0 -335
- package/lib/audit-rules/audit-rules-go.yml +0 -103
- package/lib/audit-rules/audit-rules-i18n.yml +0 -45
- package/lib/audit-rules/audit-rules-java.yml +0 -105
- package/lib/audit-rules/audit-rules-nodejs.yml +0 -662
- package/lib/audit-rules/audit-rules-npm.yml +0 -187
- package/lib/audit-rules/audit-rules-paths.yml +0 -98
- package/lib/audit-rules/audit-rules-performance.yml +0 -245
- package/lib/audit-rules/audit-rules-php.yml +0 -101
- package/lib/audit-rules/audit-rules-private.yml +0 -24
- package/lib/audit-rules/audit-rules-python.yml +0 -106
- package/lib/audit-rules/audit-rules-robustness.yml +0 -31
- package/lib/audit-rules/audit-rules-rust.yml +0 -109
- package/lib/audit-rules/audit-rules-structure.yml +0 -158
- package/lib/audit-rules/audit-rules-swift.yml +0 -99
- package/lib/audit-rules/audit-rules-template.yml +0 -108
- package/lib/audit-ui-sdk/contract.js +0 -117
- package/lib/audit-ui-sdk/index.js +0 -17
- package/lib/checks/button-bind.js +0 -347
- package/lib/checks/common.js +0 -170
- package/lib/checks/credential-file.js +0 -43
- package/lib/checks/dataflow.js +0 -40
- package/lib/checks/dispatch.js +0 -117
- package/lib/checks/dup-code.js +0 -69
- package/lib/checks/dup-const.js +0 -232
- package/lib/checks/file-health.js +0 -150
- package/lib/checks/filter.js +0 -137
- package/lib/checks/folder.js +0 -173
- package/lib/checks/fs-scanner.js +0 -57
- package/lib/checks/hardcoded-path.js +0 -98
- package/lib/checks/index.js +0 -49
- package/lib/checks/io.js +0 -66
- package/lib/checks/magic-number.js +0 -42
- package/lib/checks/npm-json.js +0 -273
- package/lib/checks/private.js +0 -64
- package/lib/checks/regex.js +0 -298
- package/lib/checks/scope-collision.js +0 -68
- package/lib/checks/semantic.js +0 -134
- package/lib/checks/structural.js +0 -281
- package/lib/cli/commands-audit.mjs +0 -142
- package/lib/cli/commands-doc.mjs +0 -127
- package/lib/client-parts/audit/audit.js +0 -301
- package/lib/exempt/tool.js +0 -198
- package/lib/git/module-splitter.js +0 -47
- package/lib/link-check/index.js +0 -187
- package/lib/lint-adapter/detect.js +0 -161
- package/lib/lint-adapter/index.js +0 -50
- package/lib/lint-adapter/runner.js +0 -133
- package/lib/preprocess/audit.js +0 -98
- package/lib/preprocess/index.js +0 -78
- package/lib/rule/compilers/credential.js +0 -62
- package/lib/rule/compilers/dataflow.js +0 -38
- package/lib/rule/compilers/file-health.js +0 -75
- package/lib/rule/compilers/frontend.js +0 -86
- package/lib/rule/compilers/func.js +0 -35
- package/lib/rule/compilers/helpers.js +0 -71
- package/lib/rule/compilers/index.js +0 -29
- package/lib/rule/compilers/link-semantic.js +0 -45
- package/lib/rule/compilers/list-kinds.js +0 -12
- package/lib/rule/compilers/numeric-kinds.js +0 -73
- package/lib/rule/compilers/regex.js +0 -78
- package/lib/rule/compilers/structure.js +0 -107
- package/lib/rule/compilers.js +0 -17
- package/lib/rule/homoglyph.js +0 -45
- package/lib/rule/loader.js +0 -274
- package/lib/rule/registry.js +0 -122
- package/lib/rule/scope.js +0 -67
- package/lib/score/docs-score.js +0 -166
- package/lib/score/index.js +0 -234
- package/lib/user-requirements.json +0 -15
- package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
- package/scripts/audit-ext/_example-readme-present.mjs +0 -34
- package/scripts/audit-ext/dsh-inject-declarations.mjs +0 -209
- package/scripts/audit-ext/variable-min-length.mjs +0 -102
- package/scripts/audit-gate.mjs +0 -235
- package/scripts/audit-runner.mjs +0 -35
- package/scripts/audit-runtime-check.mjs +0 -129
- package/scripts/browser-page-probe.mjs +0 -271
- package/scripts/build-client.mjs +0 -131
- package/scripts/bump-version.mjs +0 -178
- package/scripts/check-js-scope.mjs +0 -87
- package/scripts/check.mjs +0 -203
- package/scripts/clean-date-comments.py +0 -102
- package/scripts/cpu-sample.mjs +0 -188
- package/scripts/doc-drift.mjs +0 -200
- package/scripts/doc-func.mjs +0 -212
- package/scripts/doc-tree.mjs +0 -458
- package/scripts/doc-version.mjs +0 -149
- package/scripts/hot-path-probe-cjs.cjs +0 -71
- package/scripts/hot-path-probe-fs-shim.mjs +0 -28
- package/scripts/hot-path-probe-fsp-shim.mjs +0 -31
- package/scripts/hot-path-probe.mjs +0 -153
- package/scripts/local-registry.mjs +0 -37
- package/scripts/module-splitter.py +0 -800
- package/scripts/picker-repro.mjs +0 -115
- package/scripts/platform-scan.mjs +0 -168
- package/scripts/probe-recheck.mjs +0 -47
- package/scripts/rename-locator.mjs +0 -97
- package/scripts/rule-switch.mjs +0 -97
- package/scripts/rules-solo-audit.mjs +0 -173
- package/scripts/scan-file-io.mjs +0 -717
- package/scripts/scan-fs-hotspots.mjs +0 -107
- package/scripts/scan-version.mjs +0 -125
- package/scripts/symbol-index.mjs +0 -85
- package/scripts/verify-prestep.mjs +0 -100
- package/scripts/version-source.mjs +0 -173
- package/skills/dev/audit-rule-authoring.md +0 -58
- package/skills/guide/guide-audit.md +0 -270
- /package/lib/{audit → app}/ownership.js +0 -0
- /package/lib/{audit-defaults.js → git/defaults.js} +0 -0
|
@@ -1,82 +0,0 @@
|
|
|
1
|
-
# ============================================================
|
|
2
|
-
# C# 代码审计规则集(首版 · 语言专项)
|
|
3
|
-
# 版本:0.1.0
|
|
4
|
-
# 适用:C# 项目(.cs)
|
|
5
|
-
# 描述:本槽位首版规则。选型依据是真实 C# 语料上的**两档计数**(正则初筛命中 / 精筛后命中),
|
|
6
|
-
# 只收「精筛后仍是真命中且形态可静态确认」的项;靠正则数量堆砌的候选一律不收。
|
|
7
|
-
# 未收清单与理由见 docs/2026-10-29-多语言AST接通实测记录.MD「M3-B 收规则与不收清单」。
|
|
8
|
-
# 口径:exts 只认 .cs;astConfirm 走 token 级行列判定(注释/字符串里的同名文本不算代码)。
|
|
9
|
-
# ============================================================
|
|
10
|
-
|
|
11
|
-
metadata:
|
|
12
|
-
name: "C# 审计规则集(首版 · 语言专项)"
|
|
13
|
-
version: "0.1.0"
|
|
14
|
-
language: "csharp"
|
|
15
|
-
author: "DeepSeek"
|
|
16
|
-
description: "C# 项目语言专用规则(首版:throw ex / 抛通用 Exception / 显式 GC.Collect / lock(this|typeof))"
|
|
17
|
-
last_updated: "2026-10-29"
|
|
18
|
-
|
|
19
|
-
rules:
|
|
20
|
-
# ----- 1. 健壮性 -----
|
|
21
|
-
|
|
22
|
-
- id: csharp/throw-ex
|
|
23
|
-
name: "C# 重抛异常不要用 throw ex"
|
|
24
|
-
category: "robustness"
|
|
25
|
-
severity: "warning"
|
|
26
|
-
dimensions: ["健壮性"]
|
|
27
|
-
description: "`throw ex;` 会把异常栈重置到当前行,原始抛出点丢失;应写 `throw;` 保留栈,或包成带 innerException 的新异常"
|
|
28
|
-
# astConfirm + astConfirmSpan:行级 + **列级**双重判定。
|
|
29
|
-
# 只写 astConfirm 时按「行」判,`const string S = "throw ex;";` 这种行仍是代码行 ⇒ 字符串里的文本会被报出来;
|
|
30
|
-
# 加 astConfirmSpan 后按命中列判(有语法树时用 c_sharp 树,无树时回退 token 列级),才算真排除。
|
|
31
|
-
astConfirm: true
|
|
32
|
-
astConfirmSpan: true
|
|
33
|
-
patterns:
|
|
34
|
-
- "\\bthrow\\s+[A-Za-z_]\\w*\\s*;"
|
|
35
|
-
exts: ["cs"]
|
|
36
|
-
exclude_paths:
|
|
37
|
-
- "test/"
|
|
38
|
-
- "tests/"
|
|
39
|
-
- "examples/"
|
|
40
|
-
- "example/"
|
|
41
|
-
fixable: false
|
|
42
|
-
|
|
43
|
-
- id: csharp/generic-exception
|
|
44
|
-
name: "C# 不要抛通用 Exception"
|
|
45
|
-
category: "robustness"
|
|
46
|
-
severity: "warning"
|
|
47
|
-
dimensions: ["健壮性"]
|
|
48
|
-
description: "抛 `System.Exception` 让调用方无法按类型区分处置,且容易与框架异常混淆;应抛具体异常类型(ArgumentException/InvalidOperationException 或自定义异常)"
|
|
49
|
-
# 只匹配直接 new 通用 Exception 的形态:new ArgumentException(...) 等子类不在命中范围
|
|
50
|
-
# astConfirmSpan:同 throw-ex,字符串/注释里的示例文本按列级排除
|
|
51
|
-
astConfirm: true
|
|
52
|
-
astConfirmSpan: true
|
|
53
|
-
patterns:
|
|
54
|
-
- "throw\\s+new\\s+(?:System\\s*\\.\\s*)?Exception\\s*\\("
|
|
55
|
-
exts: ["cs"]
|
|
56
|
-
exclude_paths:
|
|
57
|
-
- "test/"
|
|
58
|
-
- "tests/"
|
|
59
|
-
- "examples/"
|
|
60
|
-
- "example/"
|
|
61
|
-
fixable: false
|
|
62
|
-
|
|
63
|
-
# ----- 3. 并发安全 -----
|
|
64
|
-
|
|
65
|
-
- id: csharp/lock-on-self-or-type
|
|
66
|
-
name: "C# 不要在 this / typeof(T) 上加锁"
|
|
67
|
-
category: "robustness"
|
|
68
|
-
severity: "warning"
|
|
69
|
-
dimensions: ["健壮性"]
|
|
70
|
-
description: "锁 this 或 typeof(T) 会和外部代码共享同一把锁(外部也能锁同一个对象/类型),易造成死锁与不可控争用;应使用私有 readonly 锁对象"
|
|
71
|
-
astConfirm: true
|
|
72
|
-
astConfirmSpan: true
|
|
73
|
-
patterns:
|
|
74
|
-
- "lock\\s*\\(\\s*this\\s*\\)"
|
|
75
|
-
- "lock\\s*\\(\\s*typeof\\s*\\("
|
|
76
|
-
exts: ["cs"]
|
|
77
|
-
exclude_paths:
|
|
78
|
-
- "test/"
|
|
79
|
-
- "tests/"
|
|
80
|
-
- "examples/"
|
|
81
|
-
- "example/"
|
|
82
|
-
fixable: false
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
# dsh-skip-doc: 链接规则定义文件含 URL 模式示范(非真实待检链接)
|
|
2
|
-
# dsh-git-push 审计规则(docs 槽位):链接判断(link-check)+ 文档加分制(docs-score)
|
|
3
|
-
# link-check kind 由 lib/link-check/index.js 实现。
|
|
4
|
-
# 文档加分制(docs-score)**不是规则**:由 lib/score/docs-score.js 实现(结构信号 + 版本交叉验证,
|
|
5
|
-
# 0 分起上限 10,不进 findings/扣分维度/门禁,scoreQuality context.docsScore 单独加分)——
|
|
6
|
-
# 故不在本 yml 声明(声明会被当规则 kind 编译报错)。
|
|
7
|
-
metadata:
|
|
8
|
-
name: "docs 审计规则(链接判断槽位)"
|
|
9
|
-
version: "1.1.0"
|
|
10
|
-
|
|
11
|
-
rules:
|
|
12
|
-
- id: link-check
|
|
13
|
-
kind: link-check
|
|
14
|
-
name: "链接有效性"
|
|
15
|
-
category: "documentation"
|
|
16
|
-
severity: "warning" # 只 warning 永不 blocker:网络不可靠不应拦提交
|
|
17
|
-
description: "检查 md 文档中的 http(s) 链接:404/403 大扣分、DNS 中扣分、超时/5xx 小扣分;flaky 域名网络错误 ×0.2"
|
|
18
|
-
status_dead: [404, 403, 410, 451]
|
|
19
|
-
status_transient: [408, 425, 429, 500, 502, 503, 504]
|
|
20
|
-
flaky_hosts:
|
|
21
|
-
- github.com
|
|
22
|
-
- api.github.com
|
|
23
|
-
- raw.githubusercontent.com
|
|
24
|
-
- registry.npmjs.org
|
|
25
|
-
flaky_factor: 0.2
|
|
26
|
-
score_dead: -3
|
|
27
|
-
score_dns: -2
|
|
28
|
-
score_transient: -1
|
|
29
|
-
timeouts_ms: 5000
|
|
30
|
-
concurrency: 10
|
|
31
|
-
max_links: 200
|
|
32
|
-
|
|
@@ -1,177 +0,0 @@
|
|
|
1
|
-
# dsh 插件专属审计规则(默认加载槽位)
|
|
2
|
-
# 依据:DeepSeek Harness 官方文档(https://deepseekdocs.com/docs/learn/core/plugin-anatomy 等)
|
|
3
|
-
# ① 插件 = cordis 插件 + package.json dsh 字段(dsh.bundle.patch / dsh.client / dsh.profile.bundles)
|
|
4
|
-
# ② capability 安全:依赖必须静态声明(export const inject / static inject),未声明访问被 Proxy 拒绝
|
|
5
|
-
# ③ 装载闭包只含 @deepseek-ai/* scoped 包;裸名 cordis/schemastery 解析失败
|
|
6
|
-
# ④ 工具契约:output.render 必填(dsh-tools rc.6 起缺省抛 userRender is not a function)
|
|
7
|
-
# ⑤ cordis.patch.yml 顶层数组:insert 或按 id 覆盖;config 整行替换非深合并;name 不符 warn 跳过
|
|
8
|
-
# ⑥ Client 半部:exports["./client"] + dsh.client 声明,懒 CJS 模块表
|
|
9
|
-
# 适用:dsh 插件项目(含 dsh-git-push 自身)——非插件项目命中率低,成本可忽略。
|
|
10
|
-
# 引擎约束:styleRules regex 逐行扫描新增行,因此全部规则设计为「单行命中即违规」的正向模式;
|
|
11
|
-
# 跨行/缺失类检查(如 inject 缺声明、output 缺 render)请用 code_audit 的 LLM 深度审查兜底。
|
|
12
|
-
metadata:
|
|
13
|
-
name: "dsh 插件专属审计规则集"
|
|
14
|
-
author: "EIGHTfs"
|
|
15
|
-
version: "1.0.0"
|
|
16
|
-
description: "针对 DeepSeek Harness 插件(cordis 形态)的结构、依赖、工具契约、patch 语义审计;单行正则可执行"
|
|
17
|
-
|
|
18
|
-
rules:
|
|
19
|
-
# ── ① 依赖与导入(文档:装载闭包只含 @deepseek-ai/*)──
|
|
20
|
-
- id: dsh/import-bare-cordis
|
|
21
|
-
name: "禁止裸名导入 cordis"
|
|
22
|
-
category: "dsh"
|
|
23
|
-
severity: "error"
|
|
24
|
-
description: "必须 import from '@deepseek-ai/cordis'(框架被 vendor 化只发布为 @deepseek-ai/* scoped 包);裸名 cordis 在新 loader 装载闭包中解析失败"
|
|
25
|
-
patterns:
|
|
26
|
-
- "import\\s+.*?\\s+from\\s+['\"]cordis['\"]"
|
|
27
|
-
- "require\\s*\\(\\s*['\"]cordis['\"]\\s*\\)"
|
|
28
|
-
fixable: true
|
|
29
|
-
mitigation: "改为 import ... from '@deepseek-ai/cordis';若已依赖裸名 cordis 需在插件目录自身安装该依赖"
|
|
30
|
-
- id: dsh/import-bare-schemastery
|
|
31
|
-
name: "禁止裸名导入 schemastery"
|
|
32
|
-
category: "dsh"
|
|
33
|
-
severity: "error"
|
|
34
|
-
description: "配置 schema 必须 z from '@deepseek-ai/schemastery';裸名 schemastery 解析失败"
|
|
35
|
-
patterns:
|
|
36
|
-
- "import\\s+.*?\\s+from\\s+['\"]schemastery['\"]"
|
|
37
|
-
- "require\\s*\\(\\s*['\"]schemastery['\"]\\s*\\)"
|
|
38
|
-
fixable: true
|
|
39
|
-
mitigation: "改为 import z from '@deepseek-ai/schemastery'"
|
|
40
|
-
|
|
41
|
-
# ── ② 工具契约:output.render 空实现/缺失等价(dsh-tools 契约)──
|
|
42
|
-
- id: dsh/tool-render-empty-body
|
|
43
|
-
name: "工具 render 空实现(返回 null/undefined/空体)"
|
|
44
|
-
category: "dsh"
|
|
45
|
-
severity: "error"
|
|
46
|
-
description: "dsh-tools 契约要求 render 返回内容块数组;空实现/返回 null 使工具结果无法回显(等效缺失)"
|
|
47
|
-
patterns:
|
|
48
|
-
- "render\\s*\\([^)]*\\)\\s*\\{\\s*\\}"
|
|
49
|
-
- "render\\s*\\([^)]*\\)\\s*\\{\\s*return\\s+null\\s*;?\\s*\\}"
|
|
50
|
-
- "render\\s*\\([^)]*\\)\\s*\\{\\s*return\\s+undefined\\s*;?\\s*\\}"
|
|
51
|
-
fixable: false
|
|
52
|
-
mitigation: "render(_args, value) { return [{ type: 'text', text: String(value) }] }"
|
|
53
|
-
- id: dsh/client-node-builtin-require
|
|
54
|
-
name: "Client 半部 require Node 内置模块"
|
|
55
|
-
category: "dsh"
|
|
56
|
-
severity: "error"
|
|
57
|
-
description: "浏览器 client 半部无 Node 运行时;require('fs'/'path'/'os'/'child_process'/'net'/'http'(无 window)) 必然运行失败"
|
|
58
|
-
patterns:
|
|
59
|
-
- "require\\s*\\(\\s*['\"](?:node:)?(?:fs|path|os|child_process|net|dgram|tls|http|https|worker_threads|cluster)['\"]\\s*\\)"
|
|
60
|
-
# 2026-09-13 误报修复:本规则只查浏览器侧代码(crx/、client/、public/ 等)。
|
|
61
|
-
# 纯正则无法区分 server/ 与 client/ 目录(exts 只按扩展名),漏掉会误伤 Node 后端
|
|
62
|
-
# require('fs'/'path') 等正常用法——exclude_paths 声明排除 Node 侧目录,
|
|
63
|
-
# 引擎按 relPath 前缀过滤(见 lib/audit/checks.js filterRulesByExt + runChecks)。
|
|
64
|
-
# 补充:crx/native-host/ 是浏览器扩展的 Node 原生宿主(host 半部),require 正常;
|
|
65
|
-
# exts 限 JS 类排除 .sh/.py 等非 JS 文件(start.sh 内嵌 node -e 的 require 也正常)。
|
|
66
|
-
# 2026-09-20 误报修复(根目录 Node 构建脚本):
|
|
67
|
-
# · exts 去掉 cjs——`.cjs` 是 CommonJS/Node 专属模块格式,浏览器 client 半部不可能
|
|
68
|
-
# 是 .cjs 文件(浏览器只加载 .js/.mjs/.ts 编译产物),根目录构建脚本(build.cjs
|
|
69
|
-
# /webpack.config.cjs 等)的 require('fs') 属正常 Node 用法,不再误报;
|
|
70
|
-
# · exclude_paths 补根级 Node 构建/配置脚本文件名前缀(build./gulpfile/webpack.config/
|
|
71
|
-
# rollup.config/vite.config/tsup.config/eslint.config/jest.config/babel.config 等)——
|
|
72
|
-
# 这类工具脚本与配置文件放仓库根、require Node 内置模块是常态,同样不该被当 client。
|
|
73
|
-
exts: ["js", "mjs", "ts", "tsx", "jsx"]
|
|
74
|
-
exclude_paths:
|
|
75
|
-
- "server/"
|
|
76
|
-
- "test/"
|
|
77
|
-
- "tests/"
|
|
78
|
-
- "scripts/"
|
|
79
|
-
- "tool/"
|
|
80
|
-
- "tools/"
|
|
81
|
-
- "lib/"
|
|
82
|
-
- "utils/"
|
|
83
|
-
- "crx/native-host/"
|
|
84
|
-
- "build."
|
|
85
|
-
- "gulpfile"
|
|
86
|
-
- "gruntfile"
|
|
87
|
-
- "webpack.config"
|
|
88
|
-
- "rollup.config"
|
|
89
|
-
- "vite.config"
|
|
90
|
-
- "tsup.config"
|
|
91
|
-
- "eslint.config"
|
|
92
|
-
- "jest.config"
|
|
93
|
-
- "babel.config"
|
|
94
|
-
- "cli.js"
|
|
95
|
-
- "cli.mjs"
|
|
96
|
-
fixable: false
|
|
97
|
-
mitigation: "浏览器侧改用 fetch/WebSocket/indexedDB 等 web API;Node 侧能力留在 host 半部经 RPC 暴露"
|
|
98
|
-
|
|
99
|
-
# ── ③ 配置 schema:凭据字段应 role('secret')(落盘脱敏)──
|
|
100
|
-
- id: dsh/schema-secret-field-role
|
|
101
|
-
name: "配置凭据字段未标注 role('secret')"
|
|
102
|
-
category: "dsh"
|
|
103
|
-
severity: "warning"
|
|
104
|
-
description: "配置 schema 中的 token/secret/apiKey/password 字段应 z.string().role('secret'),凭据才不进 settings 明文/日志;缺 role 有泄露风险"
|
|
105
|
-
patterns:
|
|
106
|
-
- "(?:token|secret|apiKey|password|credential)[A-Za-z0-9_]*\\s*:\\s*z\\.string\\(\\)(?!\\s*\\.\\s*role)"
|
|
107
|
-
fixable: true
|
|
108
|
-
mitigation: "改为 z.string().role('secret');凭据值落插件配置目录(0600),不回写 settings.yaml"
|
|
109
|
-
|
|
110
|
-
# ── ④ patch 语义(cordis.patch.yml):insert 与按 id 覆盖冲突 ──
|
|
111
|
-
- id: dsh/patch-insert-unique-id
|
|
112
|
-
name: "patch insert 行 id 应与被覆盖行区分"
|
|
113
|
-
category: "dsh"
|
|
114
|
-
severity: "warning"
|
|
115
|
-
kind: "patch-insert"
|
|
116
|
-
description: "cordis.patch.yml 中 insert 新建的行若与后续按 id 覆盖行同 id 会 duplicate-id 双挂;insert 行 id 应唯一(除非刻意二次配置,需确认覆盖语义)"
|
|
117
|
-
exts: ["yml", "yaml"]
|
|
118
|
-
fixable: false
|
|
119
|
-
mitigation: "insert 行与按 id 覆盖行避免同 id;核对 dsh web --dump-config 组合树"
|
|
120
|
-
|
|
121
|
-
# ── ⑤ 结构红线:Client 半部入口规范 ──
|
|
122
|
-
- id: dsh/client-module-loader-id
|
|
123
|
-
name: "Client 半部入口应使用统一 ModuleLoader 契约"
|
|
124
|
-
category: "dsh"
|
|
125
|
-
severity: "warning"
|
|
126
|
-
description: "client 半部应通过 window.__ModuleLoader__.load({ id, factory (模块表) }) 注册懒加载入口;直接顶层副作用写法不生效"
|
|
127
|
-
patterns:
|
|
128
|
-
- "window\\.__ModuleLoader__\\.load\\s*\\([^)]{0,80}"
|
|
129
|
-
fixable: false
|
|
130
|
-
mitigation: "window.__ModuleLoader__.load({ id: '<pkg>', factory: (require) => ({ apply }) })"
|
|
131
|
-
|
|
132
|
-
# ── ⑥ 插件运行时铁律(来源:2026-10-10 dsh-file-path-tracker 真实事故,两条都实测触发过)──
|
|
133
|
-
# 事故链 A:读 ctx.sessionId ⇒ 事件处理器抛 inject 错 ⇒ tools/pre-execute 每次工具调用都触发
|
|
134
|
-
# ⇒ 宿主**所有工具**全部失败(现场:任何工具都返回 cannot get property "sessionId" without inject)。
|
|
135
|
-
# 事故链 B:HTTP 路由用猜测 API 兜底链(x.addRoute || x.route || x.use)+ 静默 return
|
|
136
|
-
# ⇒ 路由从未注册、页面一直 404,却没有任何报错(靠查反代日志才发现)。
|
|
137
|
-
# 说明:只收「与 DSH 插件强关联」且**单行可判定**的两条;部署卫生类检查(local-plugins 里混入
|
|
138
|
-
# 备份目录、profile patch 内同一 loader id 重复)不是单行内容匹配,属脚本层检查,见 SPEC 待办。
|
|
139
|
-
- id: dsh/ctx-undeclared-property-read
|
|
140
|
-
name: "读 ctx 上未注入的属性(cordis 严格代理会抛,可打挂宿主全部工具)"
|
|
141
|
-
category: "dsh"
|
|
142
|
-
severity: "blocker"
|
|
143
|
-
description: "cordis 的 Context 是严格代理:访问未声明/未注入的属性直接抛 cannot get property \"<name>\" without inject。事件处理器(尤其 tools/pre-execute 这类每次工具调用都触发的事件)里抛错会把宿主所有工具调用打挂。下面列的是实测致命且**不是** cordis 服务的标识字段。"
|
|
144
|
-
exts: ["js", "mjs", "cjs", "ts", "mts", "cts"]
|
|
145
|
-
# 引擎只在 blacklist 式规则上应用 whitelist(纯 patterns 规则不吃白名单),故这里用 blacklist。
|
|
146
|
-
blacklist:
|
|
147
|
-
- pattern: "ctx\\.(sessionId|sessionID|conversationId|agentId|workspaceRoot|dshHome|DSH_HOME)\\b"
|
|
148
|
-
# 注释里**提到**这些字段名属正常(本项目就在注释里写明这条铁律),整行豁免,避免自我误报。
|
|
149
|
-
whitelist:
|
|
150
|
-
- pattern: "^\\s*(?://|\\*|/\\*)"
|
|
151
|
-
fixable: true
|
|
152
|
-
mitigation: "从事件负载取,或 ctx.get('<已在 inject 里声明的服务>') 取;取不到用空值兜底,绝不假定 ctx 上有该字段;事件回调整体包 try/catch 作纵深防御"
|
|
153
|
-
- id: dsh/host-api-guessed-fallback-chain
|
|
154
|
-
name: "猜宿主 API 的兜底链(A || B || C)"
|
|
155
|
-
category: "dsh"
|
|
156
|
-
severity: "error"
|
|
157
|
-
description: "注册/接线代码里用 x.addRoute || x.route || x.use 这类**猜测**的 API 兜底链;真实 API 不匹配时静默 return ⇒ 功能整体失效却没有任何报错(实测:HTTP 路由从未注册,页面一直 404,直到查反代日志才发现)。DSH 宿主真实 API 形如 webServer.register({ kind:'prefix', path, handler })。"
|
|
158
|
-
exts: ["js", "mjs", "cjs", "ts", "mts", "cts"]
|
|
159
|
-
patterns:
|
|
160
|
-
- "\\b(addRoute|addHandler|registerRoute|useRoute)\\s*\\|\\|"
|
|
161
|
-
fixable: true
|
|
162
|
-
mitigation: "按官方真实 API 写(webServer.register({ kind:'prefix', path, handler }));接线失败必须 return false 并告警,不得静默吞掉"
|
|
163
|
-
# ── ⑦ 分片拼接作用域(多段 JS 拼成单文件产物时 var/function 同名静默覆盖)──
|
|
164
|
-
# 为什么不用 patterns:这是**跨声明**的语义判定(同名次数 + 真实作用域帧),
|
|
165
|
-
# 单行正则做不到;由 kind=scope-collision 的编译器 + lib/ast/scope-collisions.js 执行。
|
|
166
|
-
# 契约来源:前缀 / 顶层零声明 / 产物文件清单一律取自**被审项目自己**的 package.json
|
|
167
|
-
# (dshScopeCheck,读在 lib/audit/scope-policy.js)——规则包跨仓库共享,
|
|
168
|
-
# 把 dshgp_ 写在这里会让所有被审项目都收到「缺少 dshgp_ 前缀」这类无关告警。
|
|
169
|
-
- id: dsh/scope-collision
|
|
170
|
-
kind: "scope-collision"
|
|
171
|
-
name: "分片拼接作用域撞名(var/function 静默覆盖)"
|
|
172
|
-
category: "structure"
|
|
173
|
-
severity: "error"
|
|
174
|
-
description: "多段 JS 拼进同一作用域(分片拼 factory / 多个 <script> 引入 / cat a.js b.js > bundle.js)时,同一函数帧内 function/const/let/class 同名会让后者顶掉前者或让整份产物 SyntaxError,且运行期可能毫无报错线索;判定按真实作用域帧,两个不同函数里的同名局部变量不算撞名。顶层声明与裸名在拼接场景还会与其它脚本撞名(该两项只有项目自己在 package.json 声明 dshScopeCheck 时才查)。"
|
|
175
|
-
exts: ["js", "mjs", "cjs"]
|
|
176
|
-
fixable: false
|
|
177
|
-
mitigation: "① 同帧重名必须改名(function/const/let/class 是真缺陷,纯 var 重复至少应合并);② 拼接产物保持文件顶层零声明;③ 共享作用域内的声明加项目约定的前缀,并把该约定写进项目 package.json 的 dshScopeCheck(files/prefix/allowlist/topLevelMustBeEmpty)"
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
# ============================================================
|
|
2
|
-
# 文件健康度矩阵评分规则集
|
|
3
|
-
# 作者:DeepSeek
|
|
4
|
-
# 版本:1.0.0
|
|
5
|
-
# 适用:所有源代码文件(豁免见下)
|
|
6
|
-
# 描述:行数 + 大小 + 行长 三维独立分级,矩阵组合后扣分
|
|
7
|
-
# 最后更新:2026-09-12
|
|
8
|
-
# 算法来源:用户提供《文件健康度矩阵评分算法》1.0.0
|
|
9
|
-
# ============================================================
|
|
10
|
-
|
|
11
|
-
metadata:
|
|
12
|
-
name: "文件健康度矩阵评分规则集"
|
|
13
|
-
version: "1.0.0"
|
|
14
|
-
author: "DeepSeek"
|
|
15
|
-
description: "单文件健康度评估(行数40% + 大小35% + 行长25%),score<9 提示、<5 blocker"
|
|
16
|
-
last_updated: "2026-09-12"
|
|
17
|
-
|
|
18
|
-
rules:
|
|
19
|
-
# ----- 文件健康度矩阵评分(kind: file-health) -----
|
|
20
|
-
- id: maintainability/file-health
|
|
21
|
-
name: "文件健康度矩阵评分(行数/大小/行长三维)"
|
|
22
|
-
category: "maintainability"
|
|
23
|
-
kind: "file-health"
|
|
24
|
-
severity: "warning"
|
|
25
|
-
# 只对代码文件评健康度(2026-09-13):md/txt 等文档的「行数/行长」不是代码健康问题
|
|
26
|
-
#(README 表格行天然超长、文档天然几百行),不声明 exts 时会对文档误报。
|
|
27
|
-
exts: ["js", "mjs", "cjs", "ts", "tsx", "jsx", "py", "go", "rs", "java", "kt", "swift", "php", "rb", "sh", "bash"]
|
|
28
|
-
description: "按文件健康度矩阵算法评估:三维独立分级(行数≤200/400/800/1500;大小KB≤30/100/300/1000;行长≤120/200/300/500),加权等级=行数×0.40+大小×0.35+行长×0.25,按扣分表(0/1.0/2.5/4.5/7.0)线性插值,score=max(0.1, 10-penalty);score≥9 健康,<9 提示拆分,<5 blocker。豁免:*.generated.* / *.min.* / locales/ 整文件跳过;constants/ 行数豁免(大小/行长仍评);routes/ 行数阈值放宽"
|
|
29
|
-
dimensions:
|
|
30
|
-
- 可维护性
|
|
31
|
-
- 可读性
|
|
32
|
-
# 参数(缺省即内置默认值;可按需覆盖)
|
|
33
|
-
# weight_lines: 0.40
|
|
34
|
-
# weight_size: 0.35
|
|
35
|
-
# weight_line_length: 0.25
|
|
36
|
-
# base_score: 10
|
|
37
|
-
# lines_levels: [200, 400, 800, 1500]
|
|
38
|
-
# size_levels: [30, 100, 300, 1000]
|
|
39
|
-
# line_length_levels: [120, 200, 300, 500]
|
|
40
|
-
# level_penalties: [0, 1.0, 2.5, 4.5, 7.0]
|
|
41
|
-
# warn_score: 9
|
|
42
|
-
# block_score: 5
|
|
@@ -1,99 +0,0 @@
|
|
|
1
|
-
# dsh-skip-sensitive: 规则定义文件含符号示范文本(package/ dist/ 等非真实数据)
|
|
2
|
-
# dsh-skip-residue: 规则定义文件含 debugger/console 模式串示范(规则定义本身)
|
|
3
|
-
# dsh-git-push 审计规则(folder 槽位,1.0.3)
|
|
4
|
-
# 目录级审计规则:由 checkFolderRules 在 auditFull 目录层消费(非文件行级)。
|
|
5
|
-
# 字段:threshold / exclude_dirs / signatures / required_patterns 由 folder 编译函数认领。
|
|
6
|
-
metadata:
|
|
7
|
-
name: "文件夹数量审计规则(防止解包/依赖/构建产物入库)"
|
|
8
|
-
version: "1.0.1"
|
|
9
|
-
|
|
10
|
-
rules:
|
|
11
|
-
# ----- 规则 1:目录总数异常(正常项目源码目录 ≤ 30)-----
|
|
12
|
-
- id: folder/total-count
|
|
13
|
-
name: "项目源码目录总数异常"
|
|
14
|
-
category: "folder"
|
|
15
|
-
severity: "warning"
|
|
16
|
-
description: "正常项目源码目录(不含 node_modules/.git/dist 等)应 ≤ 30 个,超过可能是解包产物混入"
|
|
17
|
-
threshold: 30
|
|
18
|
-
# 排除项在遍历时剪枝(不含其子目录)——见 lib/checks/folder.js 的 excludedNames。
|
|
19
|
-
# .trash:安全删除约定的回收站(gitignore),是回收站不是源码,计入会虚增目录数。
|
|
20
|
-
# ⚠️ 工程/资源目录(gradle/docs/res 等)不在此列:exclude_dirs 会被 collector 的
|
|
21
|
-
# SKIP_DIRS 消费(loadYamlBlacklistDirs)→ 全局跳过审计。工程目录的 total-count
|
|
22
|
-
# 排除在 folder.js 按名称过滤(只影响计数,不影响 collector 遍历)。
|
|
23
|
-
exclude_dirs:
|
|
24
|
-
# 客户端分片目录(C8:分片源码 → 构建拼接成 lib/client.js):分片是同一个客户端入口的
|
|
25
|
-
# 组成部分,与产物一起算**一个**逻辑模块 ⇒ 不计入目录类计数,否则恒定多报 1 个。
|
|
26
|
-
- "client-parts"
|
|
27
|
-
- "node_modules"
|
|
28
|
-
- "node_modules.orig"
|
|
29
|
-
- ".git"
|
|
30
|
-
- ".svn"
|
|
31
|
-
- "dist"
|
|
32
|
-
- "build"
|
|
33
|
-
- "out"
|
|
34
|
-
- "coverage"
|
|
35
|
-
- "__pycache__"
|
|
36
|
-
- ".next"
|
|
37
|
-
- ".nuxt"
|
|
38
|
-
- "vendor"
|
|
39
|
-
- ".dsh"
|
|
40
|
-
- ".trash"
|
|
41
|
-
message: "项目源码目录数 {count} 超过阈值 {threshold},可能混入解包产物"
|
|
42
|
-
|
|
43
|
-
# ----- 规则 2:单目录文件数量异常(> 500 极可能是依赖/解包)-----
|
|
44
|
-
- id: folder/file-count-per-dir
|
|
45
|
-
name: "单目录文件数量异常"
|
|
46
|
-
category: "folder"
|
|
47
|
-
severity: "warning"
|
|
48
|
-
description: "单个目录下文件数量 > 500,极可能是解包产物或依赖目录"
|
|
49
|
-
threshold: 500
|
|
50
|
-
exclude_dirs:
|
|
51
|
-
# 客户端分片目录(C8:分片源码 → 构建拼接成 lib/client.js):分片是同一个客户端入口的
|
|
52
|
-
# 组成部分,与产物一起算**一个**逻辑模块 ⇒ 不计入目录类计数,否则恒定多报 1 个。
|
|
53
|
-
- "client-parts"
|
|
54
|
-
- "node_modules"
|
|
55
|
-
- ".git"
|
|
56
|
-
- "dist"
|
|
57
|
-
- "build"
|
|
58
|
-
- "out"
|
|
59
|
-
- "coverage"
|
|
60
|
-
- "__pycache__"
|
|
61
|
-
- ".dsh"
|
|
62
|
-
- ".trash"
|
|
63
|
-
message: "目录 {path} 包含 {count} 个文件,超过阈值 {threshold},疑似解包产物"
|
|
64
|
-
|
|
65
|
-
# ----- 规则 3:解包产物特征目录(package/package.json、dist/、build/、.tgz 等)-----
|
|
66
|
-
- id: folder/unpacked-artifact-signature
|
|
67
|
-
name: "检测解包产物特征目录"
|
|
68
|
-
category: "folder"
|
|
69
|
-
severity: "error"
|
|
70
|
-
description: "检测 tar 解包后的典型目录结构(package/ + package.json、dist/、build/、临时构建目录)"
|
|
71
|
-
signatures:
|
|
72
|
-
- pattern: "package/package.json"
|
|
73
|
-
message: "检测到 tar 解包产物:package/ 子目录含 package.json"
|
|
74
|
-
- pattern: "dist/**"
|
|
75
|
-
message: "检测到构建产物目录 dist/ 被提交"
|
|
76
|
-
- pattern: "build/**"
|
|
77
|
-
message: "检测到构建产物目录 build/ 被提交"
|
|
78
|
-
- pattern: "**/.tmp-build/**"
|
|
79
|
-
message: "检测到临时构建目录 .tmp-build/ 被提交"
|
|
80
|
-
|
|
81
|
-
# ----- 规则 4:.gitignore 未覆盖常见产物目录 -----
|
|
82
|
-
- id: folder/gitignore-missing-artifacts
|
|
83
|
-
name: ".gitignore 未覆盖产物目录"
|
|
84
|
-
category: "folder"
|
|
85
|
-
severity: "warning"
|
|
86
|
-
description: "常见产物目录(node_modules/dist/build/coverage 等)应出现在 .gitignore 中"
|
|
87
|
-
required_patterns:
|
|
88
|
-
- "node_modules"
|
|
89
|
-
- "dist"
|
|
90
|
-
- "build"
|
|
91
|
-
- "coverage"
|
|
92
|
-
- "*.log"
|
|
93
|
-
- ".env"
|
|
94
|
-
message: ".gitignore 中缺少必要忽略项:{missing}"
|
|
95
|
-
|
|
96
|
-
# 规则 5/6(folder/cd-to-maybe-missing、folder/write-into-gitignored-dir)已于 2026-10-11
|
|
97
|
-
# **迁移到 lib/audit-rules/audit-rules-paths.yml**(路径类规则集中一处,避免同一检测两处实现)。
|
|
98
|
-
# 规则 id 与 astConfirmKind 未变 ⇒ 精筛实现(lib/ast/shell.js 的 shell-cd-dynamic /
|
|
99
|
-
# write-into-gitignored)无需改动;此处不再保留副本。
|