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
|
@@ -8,7 +8,7 @@ generatedBy: grok-4.6 · 2026-09-03
|
|
|
8
8
|
# 任务完成汇报(dsh-git-push 使用说明)
|
|
9
9
|
|
|
10
10
|
> 权威源 = `dsh-git-push/skills/task-completion-report.md`(插件 skill,随插件版本管理)。
|
|
11
|
-
> 同时是 dsh-git-push 插件的开发者要求:调用 `git_commit_push` 前必须按本格式收尾(或即将收尾),✅
|
|
11
|
+
> 同时是 dsh-git-push 插件的开发者要求:调用 `git_commit_push` 前必须按本格式收尾(或即将收尾),✅ 即提交推送授权。
|
|
12
12
|
> 本说明 skill 由插件作者从回复模板提取固化,作为 dsh-git-push 的使用说明与插件要求。
|
|
13
13
|
|
|
14
14
|
## 一、收尾格式(强制)
|
|
@@ -46,7 +46,7 @@ generatedBy: grok-4.6 · 2026-09-03
|
|
|
46
46
|
|
|
47
47
|
- 输出 `✅ 任务完成` 后,**默认即获授权**对改过的每个 git 仓 `git_commit_push`(commit + push),不必再问「可以提交吗」
|
|
48
48
|
- 配套 `commit-push-modified-projects`:漏仓不算完成
|
|
49
|
-
- 走插件工具 `git_commit_push`,不手敲 git
|
|
49
|
+
- 走插件工具 `git_commit_push`,不手敲 git(自动过提交前预处理门禁;门禁开关见 `preCommit.enabled`)
|
|
50
50
|
- **不在此授权内**:删远端仓库、force push、改生产配置、覆盖他人未拉取的历史、把凭据推进**公开**仓
|
|
51
51
|
|
|
52
52
|
## 四、推送后必须把远端最近 3 次发给用户
|
package/.auditignore
DELETED
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
# 审计豁免(不影响 git 跟踪,仅跳过审计扫描)
|
|
2
|
-
# 语法同 .gitignore;用于「要入库但不该被自家规则审」的内容。
|
|
3
|
-
|
|
4
|
-
# 第三方内置代码(vendor):构建产物、非本项目编写。
|
|
5
|
-
# 仓库内已不再内置任何第三方副本(tree-sitter 运行时/语法与 js-yaml 均改走 npm 依赖),
|
|
6
|
-
# 故此条不再需要;若将来重新引入 vendored 目录,按目录在此登记豁免。
|
|
7
|
-
|
|
8
|
-
# 评分参数表:DEFAULT_WEIGHTS / DIMENSION_K 的数字是「维度名 → 参数」映射值,
|
|
9
|
-
# 键名已表意,拆成 WEIGHT_X = 15 这类常量反而割裂表格、降低可读性;
|
|
10
|
-
# 权重另由侧边栏配置项可调,不是散落魔数。
|
|
11
|
-
# 2026-11-01 起改用**细粒度豁免**(路径 : 规则):只免魔数与冗长函数这两类
|
|
12
|
-
# 「表格本身固有」的命中,其余规则照常审——整文件豁免会让可读性/健壮性问题一起消失。
|
|
13
|
-
lib/score/index.js : readability/magic-number-smart, maintainability/max-function-length # 维度权重参数表,键名已表意
|
|
14
|
-
|
|
15
|
-
# 侧边栏设置 UI(lib/client.js,package.json 的 "./client" 入口):**不再整文件豁免**。
|
|
16
|
-
# 改为**规则声明降级**:audit-rules-nodejs.yml 的 readability/max-file-length 声明
|
|
17
|
-
# scope_rules: dsh-client-entry → downgrade(仍报、不扣分,不静默排除)。
|
|
18
|
-
# 文件级作用域由 lib/audit/client-entry.js 的 resolveDshClientEntries 读 package.json 推导。
|
|
19
|
-
# 理由:该文件是「零依赖单文件入口」的架构选择(拆分的固有代价),但「架构选择」不等于
|
|
20
|
-
# 「不该被看见」——降级保留可见性与可追溯性,豁免则让事实消失。
|
|
21
|
-
|
|
22
|
-
# 日期清理工具自身:注释/正则必须含日期示例(20\d{2}-... 匹配模式与示例),
|
|
23
|
-
# 否则工具失去文档价值——no-date-in-comment 对该文件豁免(工具本质)。
|
|
24
|
-
scripts/clean-date-comments.py
|
|
25
|
-
|
|
26
|
-
# archify 生成的架构图 HTML(按用户要求入库):它是 **archify 渲染器的产物**,不是本项目源码——
|
|
27
|
-
# 内含内联 <script>(被 security/script-unsafe-inline 拦)与压缩后的内联 JS(复杂度极高)。
|
|
28
|
-
# 这两类命中对生成物没有意义(改不动、也不该改),故整文件豁免审计;
|
|
29
|
-
# 数据源 .archify/*.architecture.json 仍照常受审(那是我们生成的、可改的结构数据)。
|
|
30
|
-
.archify/*.html
|
package/.gitignore
DELETED
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
node_modules/
|
|
2
|
-
node_modules.orig/
|
|
3
|
-
.tmp-build/
|
|
4
|
-
.tmp-run/
|
|
5
|
-
dist/
|
|
6
|
-
*.log
|
|
7
|
-
.DS_Store
|
|
8
|
-
.trash/
|
|
9
|
-
*.bak
|
|
10
|
-
*.bak-*
|
|
11
|
-
|
|
12
|
-
# 运行期 PID 文件(start.sh 启停脚本产生,不入库)
|
|
13
|
-
*.pid
|
|
14
|
-
|
|
15
|
-
__pycache__/
|
|
16
|
-
*.pyc
|
|
17
|
-
|
|
18
|
-
# 某同步流程留下的整仓临时副本(test-self 已修为同步清理;这里兜底防它再进审计范围)
|
|
19
|
-
.tmp-sync-write/
|
|
20
|
-
# CodeGraph local cache
|
|
21
|
-
.codegraph/
|
|
22
|
-
# code-review-graph(外部评审用知识图谱工具)的本地库与产物:本机分析用,不入库
|
|
23
|
-
.code-review-graph/
|
|
24
|
-
# 会话插话提出的新功能需求清单(本机待办,不入库)
|
|
25
|
-
任务.md
|
|
26
|
-
# 测试结果缓存(按「测试文件 + 依赖闭包」内容哈希跳过未变更的纯本地测试;本机缓存不入库)
|
|
27
|
-
.test-cache/
|
|
28
|
-
|
|
29
|
-
# 客户端构建产物(C8):源码是分片 lib/client-parts/**(入库),
|
|
30
|
-
# lib/client.js 由 scripts/build-client.mjs 按 PART_ORDER 拼接生成 —— 产物不入库。
|
|
31
|
-
# 安装侧靠 package.json 的 prepare / prepack 自动构建;本地改分片后跑 npm run build:client。
|
|
32
|
-
lib/client.js
|
|
33
|
-
|
|
34
|
-
# 预览页产物(1.4M 单文件):assets/preview.html 由 assets/preview-gen.mjs 生成
|
|
35
|
-
# (内联真 client.js + 垫片宿主,供离线 / 接真后端预览)——属**生成产物,不入库**。
|
|
36
|
-
# 生成:node scripts/preview-gen.mjs(或 node scripts/preview-gen.mjs --watch 自动重生成);
|
|
37
|
-
# 缺失时 scripts/gen-preview.mjs 与 test-rule-slots-render 会自动生成一次,保证新克隆可用。
|
|
38
|
-
assets/preview.html
|
|
39
|
-
|
|
40
|
-
# 外部 linter 委托层的工具副本(用户 2026-11-06 决定 git 忽略):
|
|
41
|
-
# tools/ruff 等二进制属本机/部署侧资产,不入库、不进 npm 发布包;部署副本由 sync_plugin 侧或手动放置。
|
|
42
|
-
/tools/
|
|
43
|
-
/tool/
|
package/cli-audit.mjs
DELETED
|
@@ -1,141 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
// dsh-skip-i18n: CLI 输出硬编码中文为产品行为(无 i18n 需求)
|
|
3
|
-
/**
|
|
4
|
-
* dsh-git-push 独立 CLI · **审计侧**(bin: audit-sluice)
|
|
5
|
-
* 不依赖 DSH 运行时,可独立运行。
|
|
6
|
-
*
|
|
7
|
-
* 为什么单独一个入口(而不是继续挂在 git-sluice 里):
|
|
8
|
-
* 审计引擎上一轮已经解耦成「可配置子进程」,但入口层如果还共用,用户仍得敲
|
|
9
|
-
* `git-sluice audit` 才能跑到审计——「审计侧独立」只做了一半。现在审计有自己的 CLI,
|
|
10
|
-
* 换引擎(含换语言重写)与换 CLI 组合互不影响。
|
|
11
|
-
*
|
|
12
|
-
* ⚠️⚠️ 两条**纯副作用 import** 是本入口的生命线(删了不报错、少了不报错,只会让功能静默失效):
|
|
13
|
-
* ① ./lib/app/host-doc-checks.js —— 目录树漂移 / 函数列表漂移两类检查器由宿主注入。
|
|
14
|
-
* 漏搬后果:同一棵树上这两类 finding **整类消失**(实测少 4 条),审计照常「通过」。
|
|
15
|
-
* ② ./lib/rule/compilers.js —— 规则编译函数注册(13 种)。
|
|
16
|
-
* 漏搬后果:`ruleset` 命令编译出 0 条规则却报「OK」。
|
|
17
|
-
* (`audit` 走 lib/audit/index.js,那条路径自身也会注册编译器;但 `ruleset` 不走审计编排,
|
|
18
|
-
* 必须靠本文件的显式 import。两处都留是刻意的冗余——这类静默失效不值得省一行 import。)
|
|
19
|
-
*
|
|
20
|
-
* 本文件只保留:命令表 + HELP 文本 + 薄壳。解析/打印/分发/跨侧提示都在 lib/cli/shared.mjs。
|
|
21
|
-
*/
|
|
22
|
-
import './lib/app/host-doc-checks.js'; // 副作用①:文档漂移检查器接线(审计专用)
|
|
23
|
-
import './lib/rule/compilers.js'; // 副作用②:规则编译函数注册(audit / ruleset 依赖)
|
|
24
|
-
|
|
25
|
-
import { VERSION } from './lib/self/index.js';
|
|
26
|
-
import { loadRuleFiles } from './lib/rule/loader.js';
|
|
27
|
-
import { compileAllRules } from './lib/rule/registry.js';
|
|
28
|
-
|
|
29
|
-
import {
|
|
30
|
-
cmdAudit, cmdScan, pluginEqualAuditOpts, pluginEqualWeights, cliPluginConfig,
|
|
31
|
-
} from './lib/cli/commands-audit.mjs';
|
|
32
|
-
import { cmdLinkCheck } from './lib/cli/commands-vcs.mjs';
|
|
33
|
-
import { cmdFileIo, cmdTreeDoc, cmdFunctions } from './lib/cli/commands-doc.mjs';
|
|
34
|
-
import {
|
|
35
|
-
CLI_AUDIT, CLI_ENTRIES, printToolResult, parseArgv, parseVia, runAsEntry, runCli,
|
|
36
|
-
} from './lib/cli/shared.mjs';
|
|
37
|
-
|
|
38
|
-
export const CLI_NAME = CLI_AUDIT;
|
|
39
|
-
|
|
40
|
-
/** parseArgv 认识的选项白名单(本侧 HELP 写着的那批;self-check 机器比对本表与 HELP 文本)。
|
|
41
|
-
* 注:**注册表驱动**命令(file-io / link-check / scope-check)的参数由
|
|
42
|
-
* lib/app/command-registry.js 的 params 校验,与本表无关;本侧 HELP 写了的 flag 必须在本表出现。 */
|
|
43
|
-
export const KNOWN_FLAGS = [
|
|
44
|
-
'--allowlist', '--files', '--full', '--history', '--include-ignored', '--json', '--out', '--prefix', '--readme',
|
|
45
|
-
'--repo', '--root', '--ruleset', '--since', '--skip-empty', '--top-level-must-be-empty', '--until', '--weights',
|
|
46
|
-
'--write', '--write-only',
|
|
47
|
-
];
|
|
48
|
-
|
|
49
|
-
const HELP = `audit-sluice v${VERSION} — ${CLI_ENTRIES[CLI_AUDIT].intro}
|
|
50
|
-
|
|
51
|
-
快速开始(第一次用——不用查源码):
|
|
52
|
-
audit-sluice audit . ① 审计当前仓库(默认只看本次改动)
|
|
53
|
-
audit-sluice audit . --full ② 全量审计(评分 + 问题明细)
|
|
54
|
-
audit-sluice ruleset ③ 规则包是否能编译(改规则后先跑它)
|
|
55
|
-
audit-sluice help 全部命令与参数
|
|
56
|
-
|
|
57
|
-
其它 CLI(本入口不含,敲错会给出替代命令):
|
|
58
|
-
git-sluice 提交/推送/克隆/账号/仓库扫描: scan commit clone remote-create rename set-visibility identity-rewrite account-check cred-env gen-ssh-key git api repos index npm-publish unpublish
|
|
59
|
-
tool-sluice 工具链: module-splitter yaml-template readme-template self-check
|
|
60
|
-
|
|
61
|
-
用法(每行写的参数就是该命令真实接受的写法,照抄即可):
|
|
62
|
-
audit-sluice version 查看版本
|
|
63
|
-
audit-sluice audit <root> [--full] [--ruleset <目录>] [--weights <JSON>] [--include-ignored] [--history [--since <提交>] [--until <提交>] [--out <目录>]] [--json]
|
|
64
|
-
审计目录(默认 diff 范围;--full=全量;--ruleset=自定规则目录;--weights=权重覆盖 JSON;
|
|
65
|
-
--include-ignored=连 .gitignore 忽略的文件也扫描;--history=历史提交审计——逐提交快照全量审计并落盘报告,
|
|
66
|
-
--since/--until 起始~结束提交(皆缺省=全部历史、含两端),--out 报告保存目录(缺省=git 根 audit-history/))
|
|
67
|
-
audit-sluice ruleset [槽位...] 编译规则包并输出统计(默认全部槽位)
|
|
68
|
-
audit-sluice file-io [路径] [--write-only]
|
|
69
|
-
文件读写调用扫描(同步 I/O 在异步路径会阻塞;写/删/改名涉及数据安全);--write-only=只看写操作。
|
|
70
|
-
按类型/操作/风险分组的明细走 code_audit 工具的 io_scan 结果
|
|
71
|
-
audit-sluice link-check <路径> 检查 md/文本中的链接有效性(只 warning,flaky 域名打折)
|
|
72
|
-
audit-sluice scope-check [文件...] [--files <文件,文件>] [--repo <目录>] [--prefix <前缀>] [--allowlist <名,名>] [--top-level-must-be-empty] [--json]
|
|
73
|
-
拼接产物作用域撞名(多段 JS 拼进同一作用域):同一函数帧内重名会让后者静默顶掉前者,运行期毫无线索;
|
|
74
|
-
判定按真实作用域帧(两个不同函数里的同名局部变量不算撞名);顶层声明与命名前缀按被查项目自己的 package.json(dshScopeCheck)判定,
|
|
75
|
-
没声明就只查同帧重名(不拿本项目的命名前缀去要求别人);不给文件时取该项目 dshScopeCheck.files
|
|
76
|
-
audit-sluice functions <analyze|apply> [目录] [--skip-empty] [--json]
|
|
77
|
-
函数索引与函数文档:analyze 生成 functions-index.json(含签名/注释槽位);
|
|
78
|
-
apply 读 JSON(人工补 comment 后)生成 docs/函数 下的 md(文件删除归档 _archived,注释不丢)
|
|
79
|
-
audit-sluice tree-doc <sync|gen|check|apply> [--root <目录>] [--readme <路径>] [--write]
|
|
80
|
-
README 目录结构维护:sync 索引同步(新增自动加键/删除自动删键);gen 生成树;
|
|
81
|
-
check 检查漂移;apply 覆盖 README/FILE-TREE 标记块(封装 scripts/doc-tree.mjs)
|
|
82
|
-
audit-sluice help 显示本帮助
|
|
83
|
-
`;
|
|
84
|
-
|
|
85
|
-
/** 子命令:ruleset — 编译规则包输出统计(依赖本文件顶部的 compilers 副作用 import)。 */
|
|
86
|
-
export function cmdRuleset(slots = []) {
|
|
87
|
-
const order = slots.length ? slots : null; // null=动态发现全部槽位
|
|
88
|
-
const { ok, merged, errors, files, order: effective } = loadRuleFiles(order);
|
|
89
|
-
const ctx = { errors: [] };
|
|
90
|
-
const compiled = compileAllRules(merged.rules, ctx);
|
|
91
|
-
if (!ok || ctx.errors.length) {
|
|
92
|
-
console.error('规则编译失败:');
|
|
93
|
-
for (const failure of [...errors, ...ctx.errors]) console.error(' ✗ ' + failure);
|
|
94
|
-
process.exitCode = 1;
|
|
95
|
-
return;
|
|
96
|
-
}
|
|
97
|
-
console.log(`规则包编译 OK(${effective.join('+')})`);
|
|
98
|
-
console.log(` 文件: ${files.length} 个槽位, 规则条目 ${merged.rules.length}, 编译成功 ${compiled.length}`);
|
|
99
|
-
const byKind = {};
|
|
100
|
-
for (const rule of compiled) {
|
|
101
|
-
const kind = rule.kind || rule.type || 'other';
|
|
102
|
-
byKind[kind] = (byKind[kind] || 0) + 1;
|
|
103
|
-
}
|
|
104
|
-
for (const [kind, count] of Object.entries(byKind)) console.log(` ${kind}: ${count}`);
|
|
105
|
-
}
|
|
106
|
-
|
|
107
|
-
/** 命令表(本侧独有的 COMMANDS;注册表驱动的 file-io / link-check / scope-check 由 shared 分发)。 */
|
|
108
|
-
export const COMMANDS = new Map([
|
|
109
|
-
['ruleset', (rest) => cmdRuleset(rest)],
|
|
110
|
-
// audit 不走注册表——CLI 独立审计需完整 findings(不依赖宿主 API);工具 code_audit 输出 API 指引
|
|
111
|
-
['audit', parseVia((flags, positional) => cmdAudit(positional[0] || '.', flags))],
|
|
112
|
-
['functions', parseVia((flags, positional) => cmdFunctions(positional[0] || '', positional[1] || '', flags))],
|
|
113
|
-
['tree-doc', parseVia((flags, positional) => cmdTreeDoc(positional[0] || '', flags))],
|
|
114
|
-
// 兼容:scan 属于 git 侧(注册表 git_scan);此处保留导出给老代码直调,不注册进命令表
|
|
115
|
-
]);
|
|
116
|
-
|
|
117
|
-
/**
|
|
118
|
-
* 入口 main。
|
|
119
|
-
* @param {string[]} argv
|
|
120
|
-
* @returns {Promise<number|undefined>}
|
|
121
|
-
*/
|
|
122
|
-
export async function main(argv = process.argv.slice(2)) {
|
|
123
|
-
return await runCli({
|
|
124
|
-
cliName: CLI_AUDIT,
|
|
125
|
-
argv,
|
|
126
|
-
commands: COMMANDS,
|
|
127
|
-
helpText: HELP,
|
|
128
|
-
getConfig: cliPluginConfig,
|
|
129
|
-
});
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
runAsEntry(import.meta.url, main);
|
|
133
|
-
|
|
134
|
-
// 兼容导出(审计侧实现的老引用路径)
|
|
135
|
-
export { cmdAudit, cmdScan, cmdLinkCheck, cmdFileIo, cmdTreeDoc, cmdFunctions };
|
|
136
|
-
export { pluginEqualAuditOpts, pluginEqualWeights, cliPluginConfig, parseArgv, printToolResult };
|
|
137
|
-
|
|
138
|
-
/** 子命令:version(三入口同一实现,只有名字不同)。 */
|
|
139
|
-
export function cmdVersion() {
|
|
140
|
-
console.log(`audit-sluice v${VERSION} — dsh-git-push(统一函数入口架构)`);
|
|
141
|
-
}
|
|
@@ -1,278 +0,0 @@
|
|
|
1
|
-
# 2026-09-14 Bug 修复说明(接手者必读)
|
|
2
|
-
|
|
3
|
-
> 本文档记录当天修复的三个实测 bug 的**完整根因链 / 改动点 / 验证 / 遗留坑**,
|
|
4
|
-
> 供后续 AI 接手本插件时对照(避免重复踩坑、避免误以为某个行为是设计)。
|
|
5
|
-
> 相关改动均已回归(npm test 559/559 全绿)。
|
|
6
|
-
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## Bug 1:提交推送实际全前台任务,会卡住 AI
|
|
10
|
-
|
|
11
|
-
### 现象
|
|
12
|
-
调用 `git_commit_push` 时 AI 长时间卡住(尤其大仓库),用户体感「提交推送是前台任务」。
|
|
13
|
-
|
|
14
|
-
### 根因(2026-09-14 实测)
|
|
15
|
-
`git_commit_push` 的后台化是「**审计同步即时拦截 + commit+push 丢后台**」(见 `lib/app/tool-call.js`
|
|
16
|
-
`case 'git_commit_push'` → `runAudit()` 同步执行 → `submitTask()` 后台 commit+push)。
|
|
17
|
-
**审计同步本身是设计**(保住提交门禁:blocker 立即拦截),但审计里有个隐藏的全仓扫描:
|
|
18
|
-
|
|
19
|
-
`lib/audit/orchestrate.js` 的 `auditChanged()`(diff 审计)为了收集 npm 规则的
|
|
20
|
-
「js-yaml 已引用但未声明」证据,**无条件**调用:
|
|
21
|
-
|
|
22
|
-
```js
|
|
23
|
-
detectRepoJsYamlImport(collectTextFiles(repoPath, { depth: 10, gitIgnoreRoot: repoPath, testExemptRoot: repoPath }))
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
`collectTextFiles` 全仓遍历目录 + `detectRepoJsYamlImport` 逐个读全文。
|
|
27
|
-
**实测**:0 变动文件的大仓库(DeepSeekHarness-NAS,2.1 万文本文件)仍扫 3.2s;
|
|
28
|
-
8 万文件仓库更久(遍历 3.6s + 读全文 1.3s+)。这就是每次提交都卡几秒的来源。
|
|
29
|
-
|
|
30
|
-
### 修复
|
|
31
|
-
`lib/audit/orchestrate.js`(auditChanged):js-yaml 证据收集从「全仓扫」改为「**只在本次变动文件
|
|
32
|
-
(targets)里检测**」——diff 审计的语义就是「本次变动」,引用证据同理按变动范围取;
|
|
33
|
-
全仓证据(历史遗留引用)由 `auditFull` 负责,diff 不重扫。
|
|
34
|
-
|
|
35
|
-
**验证**:同一大仓库 runAudit diff 耗时 3211ms → 274ms(约 11 倍提速),结果不变。
|
|
36
|
-
|
|
37
|
-
### 遗留(接手者可考虑)
|
|
38
|
-
- 审计同步仍可能慢于毫秒级:剩余耗时主要在 `checkPrivateFiles`(git ls-files 全量匹配私密
|
|
39
|
-
文件清单)——这是**安全红线**,故意保留全量,**不要**改成只匹配变动文件(否则漏私密文件)。
|
|
40
|
-
- 若想进一步提速:可给 `runAudit` 加超时/降级策略(超时跳过非安全类检查),但需谨慎,
|
|
41
|
-
安全类规则(private/secret)不可降级。
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
45
|
-
## Bug 2:审计「变动文件」开启没生效(敏感文件提交不拦截)
|
|
46
|
-
|
|
47
|
-
### 现象
|
|
48
|
-
用户开「审计变动文件(diff)」后,提交含 `.env` / 硬编码凭据的文件不被拦截;
|
|
49
|
-
前端也找不到「审计扫描范围」开关可开。
|
|
50
|
-
|
|
51
|
-
### 根因链(三层,全部实测确认)
|
|
52
|
-
|
|
53
|
-
**第 1 层:`.env` 等点文件被 diff 审计 targets 过滤掉(最致命)**
|
|
54
|
-
`lib/audit/collector.js` 的 `isTextFile()` 用 `extname()` 判定文本扩展名,
|
|
55
|
-
但 Node 的 `extname('.env')` 返回**空串**、`extname('.env.local')` 返回 **'.local'**(点文件
|
|
56
|
-
extname 只取最后一段)→ 点文件扩展名匹配不到 `TEXT_EXT`(含 'env')→ `isTextFile=false`
|
|
57
|
-
→ `auditChanged` 的 `targets = changed.filter(f => isTextFile(f.full))` 把 `.env` 丢弃
|
|
58
|
-
→ 凭据文件路径规则永远审不到它。
|
|
59
|
-
|
|
60
|
-
**第 2 层:credential-file 检查器读错字段**
|
|
61
|
-
`lib/checks/credential-file.js` 的 `checkCredentialFiles()` 只读
|
|
62
|
-
`rule.patterns || rule.pattern`,但 `lib/rule/compilers/credential.js` 对 `credfile-*` 规则
|
|
63
|
-
编译输出的是 **`pathPattern`**(取自 yml `path_pattern`)→ 字段不匹配,规则**永不触发**。
|
|
64
|
-
(`checkPathRegexRules` 在 `lib/checks/regex.js` 读的是 `rule.pathPattern`,是对的;
|
|
65
|
-
`checkCredentialFiles` 漏了。)
|
|
66
|
-
|
|
67
|
-
**第 3 层:error 级不升 blocker,runAudit 不拦**
|
|
68
|
-
`lib/rule/compilers/credential.js` 编译 `credfile-*` 时没设 `level`(ruleOut 默认 'warning'),
|
|
69
|
-
而文档契约(docs/DETAILS-EXEMPT-AND-RULES.md)规定「yml 写 `error` → 引擎级 `blocker`(拦截)」。
|
|
70
|
-
`checkCredentialFiles` 原来用 `capSeverity(rule.severity, 'blocker')`——capSeverity 对 'error'
|
|
71
|
-
**恒返回 'error'**,`runAudit`(lib/commit-push.js)只认 `severity === 'blocker'` → error 级凭据
|
|
72
|
-
文件不拦截。(对照:`checkPathRegexRules` 用 `rule.level === 'blocker' ? 'blocker' : rule.severity`,
|
|
73
|
-
因为 regex 编译器调了 `severityLevel()`。)
|
|
74
|
-
|
|
75
|
-
### 修复(三处对齐契约)
|
|
76
|
-
1. `lib/audit/collector.js` `isTextFile()`:点文件(base 以 `.` 开头)优先取
|
|
77
|
-
「去首点后第一段」作为扩展名(`.env` → env;`.env.local` → env;`.tmp-x.js` 仍按
|
|
78
|
-
extname 得 js,不误伤)。验证:`.env`/`.env.local`/`x/.env.local`/`.tmp-x.js` 全 true,
|
|
79
|
-
`a.png` false。
|
|
80
|
-
2. `lib/checks/credential-file.js` `checkCredentialFiles()`:`pathPattern` 优先,
|
|
81
|
-
`patterns/pattern` 兼容旧规则。
|
|
82
|
-
3. `lib/rule/compilers/credential.js`:`credfile-*` 编译补 `level: severityLevel(r.severity)`
|
|
83
|
-
(error → blocker);`checkCredentialFiles` severity 改读 `rule.level === 'blocker' ? 'blocker' : capSeverity(...)`
|
|
84
|
-
(与 `checkPathRegexRules` 同契约)。
|
|
85
|
-
|
|
86
|
-
**验证**:真实 `.env` / `.env.local` / `config/.env` 全部 `blocked: true`(审计拦截:1 个 blocker);
|
|
87
|
-
硬编码密码 / API key 测试恢复拦截;回归 553/553 全绿。
|
|
88
|
-
|
|
89
|
-
### 前端缺开关(未做,接手者可补)
|
|
90
|
-
`lib/client/index.js` 的 `SETTINGS_SCHEMA` 声明了 `auditScanScope`(diff|full)与
|
|
91
|
-
`hardcodeFullScan`,但 `client.js` 的 `dshgp_AuditTab` **没有渲染这两个开关**——用户想
|
|
92
|
-
「开启审计变动文件」无从下手(默认值就是 diff,但无 UI 可确认/切换)。
|
|
93
|
-
接手者可在审计 tab 加枚举开关(照 `toggleAudit` 模式:`scope.set('auditScanScope', v)`,
|
|
94
|
-
apply.js 的 `scope.watch` 已接 `cfg.auditScanScope`,保存即时生效)。
|
|
95
|
-
|
|
96
|
-
<!-- 2026-09-14 追加:本项已在下方 Bug 3 一并修复(审计 tab 加「审计扫描范围」按钮组) -->
|
|
97
|
-
|
|
98
|
-
---
|
|
99
|
-
|
|
100
|
-
## Bug 3:非 loopback(反代)访问时设置不落盘,重启全丢
|
|
101
|
-
|
|
102
|
-
### 现象
|
|
103
|
-
用户通过**反代地址**(http://10.10.10.4:3080 之类经 121000 进程转发到 127.0.0.1:30801)访问
|
|
104
|
-
主 GUI 设置页:勾选「注入开发者要求清单到系统提示词」等开关后,**每次重启都要重新打开**;
|
|
105
|
-
打开设置侧边栏时所有开关都是未勾选态。凭据类保存也「写不进 settings.yaml,只能手动写」
|
|
106
|
-
(这正是 apply.js 里 2026-09-13 注释记录的旧现象)。
|
|
107
|
-
|
|
108
|
-
### 根因(2026-09-14 实测,藏在宿主 DSH 源码里)
|
|
109
|
-
DSH web GUI 的 settings 持久化由 **client 侧**决定(`packages/client/ui-settings/src/client/index.ts:58`):
|
|
110
|
-
|
|
111
|
-
```ts
|
|
112
|
-
const persistence = ctx.remote.$host.isLoopback ? 'host' : 'memory'
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
- **loopback 直连**(浏览器访问 127.0.0.1:30801)→ `persistence='host'` → 前端
|
|
116
|
-
`scope.set()` 经 wire 发到宿主写盘 ✓
|
|
117
|
-
- **非 loopback**(经反代 10.10.10.4 访问 → host 判定 isLoopback=false)→
|
|
118
|
-
`persistence='memory'` → 前端 `scope.set()` **只改页面内存**:`settings-scope.ts`
|
|
119
|
-
的 `enqueue()` 对 memory persistence **直接 return(不发 wire、不写盘)**,且
|
|
120
|
-
Controller 构造时 `if (persistence === 'host')` 才订阅 mirror + derive → **store
|
|
121
|
-
恒 unavailable、读值恒 undefined**。
|
|
122
|
-
|
|
123
|
-
叠加 schemastery「未知键忽略」→ 前端 decode 不报错,但**每次打开设置页都读到默认值
|
|
124
|
-
(未勾选)**,设置从未真正落盘 settings.yaml → 重启全丢。这不是本插件 bug,是 DSH
|
|
125
|
-
宿主对「非 loopback 页面设置不持久化」的设计,任何第三方插件设置页都会中招。
|
|
126
|
-
|
|
127
|
-
### 修复(绕开 client persistence,走 host scope 真源)
|
|
128
|
-
1. **新增 `lib/app/settings-bridge.js`**:apply 时把 `settings.register('git-push')`
|
|
129
|
-
返回的 **host 侧 scope** 存模块级引用(`setSettingsScope`),暴露 `readSettings()`
|
|
130
|
-
与 `writeSettingsKey(key, value)`——host 侧 `scope.update()` 走宿主完整写盘链路
|
|
131
|
-
(settings-file provider,与 client isLoopback 判定**无关**)。
|
|
132
|
-
2. **http-handlers.js 新增两端点**:
|
|
133
|
-
- `GET /api/git-push/settings-get`:读 host scope 快照(redactConfig 掩码凭据)
|
|
134
|
-
- `POST /api/git-push/settings-set`:白名单键(含 auditEnabled/injectRequirements/
|
|
135
|
-
injectSystemPrompt/auditScanScope/auditLevel/weightOverrides/githubToken/sshPub 等)→
|
|
136
|
-
`writeSettingsKey` → `scope.update` → **真正写 settings.yaml + 触发 watch 同步 cfg**
|
|
137
|
-
- scope 未注册时 503(降级不崩)、非白名单键 400(防越权)。
|
|
138
|
-
3. **client.js**:
|
|
139
|
-
- 构造尾部新增 `loadSettingsFromHttp()`:启动即 `GET settings-get` 读回已落盘
|
|
140
|
-
开关/扫描范围/权重,覆盖前端字段 → **重启后勾选保持**;
|
|
141
|
-
- 新增 `persistSetting(key, value, okMsg)`:`scope.set`(loopback 兼容通道,静默)
|
|
142
|
-
+ `dshgp_postJson('/api/git-push/settings-set')`(可靠通道)双写;所有
|
|
143
|
-
toggle(audit/injectRequirements/injectSystemPrompt)+ editWeight + save 改写
|
|
144
|
-
走它(原 `scope.set().then(flashSaved)` 模式替换)。
|
|
145
|
-
4. **审计扫描范围按钮组**(原 Bug 2「前端缺开关」一并修复):`dshgp_AuditSwitchBlock`
|
|
146
|
-
「提交前自动审计」卡片下加 `diff=部分(本次变动)/ full=全量` 双按钮单击切换
|
|
147
|
-
(当前模式高亮),父开关关闭时整行置灰但仍可保留选择;持久化走 persistSetting。
|
|
148
|
-
Controller 新增 `toggleAuditScanScope(scope)`,inject()/AuditTab props 透传。
|
|
149
|
-
|
|
150
|
-
**验证**:新增 5 个 settings 端点单测(未注册 503、白名单 400、GET 空 key 400 等)
|
|
151
|
-
+ 1 个按钮接线源码断言;回归 **559/559 全绿**(基线 553 + 6 新增);
|
|
152
|
-
`node --check` 全通过;NM 主环境 19 个文件 md5 全一致。
|
|
153
|
-
|
|
154
|
-
### 遗留 / 接手者注意
|
|
155
|
-
- settings-set 白名单是硬编码集合,新增设置键时记得同步加进去(否则前端 save 404/400)。
|
|
156
|
-
- 前端 `persistSetting` 走 HTTP 的同时仍保留 `scope.set` 双通道:loopback 环境下
|
|
157
|
-
host 会收到两路写(幂等,无副作用);请不要为了「看起来干净」删掉其中一路,
|
|
158
|
-
那会让另一类访问方式(直连 or 反代)退回旧坑。
|
|
159
|
-
- `settings.yaml` 里 git-push 段的 `enabled: false` / `allowedModels` / `maxParallelToolCalls`
|
|
160
|
-
实际属于 `subagent-model-selection` / `agent-loop` 命名空间(awk 按行截取易误读);
|
|
161
|
-
段内 `qualityWeights`/`auditRuleWeights` 是 v1 旧键残留,无害但勿依赖。
|
|
162
|
-
- **2026-09-15 修正(重要)**:本 Bug 3 的初版方案是「host scope.update 写 settings.yaml」,
|
|
163
|
-
实测在用户环境发现**公共 settings.yaml 跨实例写锁竞争**(多 DSH 实例共享 DSH_HOME 时,
|
|
164
|
-
`atomic-write: timed out waiting for the writer lock`,任何写都失败)。处理方式:
|
|
165
|
-
**不写公共 settings.yaml,插件设置自管到插件私有 `$DSH_HOME/git-push/config.json`**
|
|
166
|
-
(0600,与凭据同级)。settings-bridge 已重写为纯文件读写(无 scope 依赖、无锁竞争),
|
|
167
|
-
详见下方 **Bug 4**。
|
|
168
|
-
|
|
169
|
-
---
|
|
170
|
-
|
|
171
|
-
## Bug 4:公共 settings.yaml 写锁竞争(跨实例)→ 设置迁插件私有 config.json
|
|
172
|
-
|
|
173
|
-
### 现象
|
|
174
|
-
Bug 3 修复后用户实测「**开关点了直接回弹**」(新改动回归)。curl 直打主实例
|
|
175
|
-
`POST /api/git-push/settings-set` 稳定复现:
|
|
176
|
-
|
|
177
|
-
```json
|
|
178
|
-
{ "ok": false, "code": "WRITE_FAIL",
|
|
179
|
-
"error": "settings 写入失败: atomic-write: timed out waiting for the writer lock at .../settings.yaml.lock" }
|
|
180
|
-
```
|
|
181
|
-
|
|
182
|
-
且写 **auditEnabled / injectSystemPrompt 等任意键都一样失败**——不是单个开关的问题。
|
|
183
|
-
|
|
184
|
-
### 根因(2026-09-15 实测)
|
|
185
|
-
`$DSH_HOME/.dsh/settings.yaml` 被**多个 DSH 实例共享**(主实例 30801 + 反代进程 121000 + 其他
|
|
186
|
-
实例 114009/5435 的 DSH_HOME 各自独立、但主实例自身的 settings-file 写锁与读侧竞争);
|
|
187
|
-
`packages/settings/settings-file` 的 atomic-write 用**跨进程 writer lock**(锁超时即失败),
|
|
188
|
-
任何 `scope.update` 都可能撞锁。这解释了「设置页保存后插件文件没写入」的旧现象——
|
|
189
|
-
不是 client memory 单点问题,而是 **settings.yaml 这把公共锁在并发下根本不可靠**。
|
|
190
|
-
(前端「回弹」的次级原因也有:`loadSettingsFromHttp()` 异步 GET 返回旧值、在用户点击后
|
|
191
|
-
覆盖本地新值——已用 `editedKeys` 集合守卫修复:用户编辑过的键 GET 不再覆盖。)
|
|
192
|
-
|
|
193
|
-
### 修复(用户 2026-09-15 拍板:不写公共 settings.yaml)
|
|
194
|
-
1. **`lib/app/settings-bridge.js` 重写为纯文件读写**:`readSettings()/writeSettingsKey(key,value)`
|
|
195
|
-
直接操作 `$DSH_HOME/git-push/config.json`(0600,`credentialsDir()`,与 github-token/id_rsa
|
|
196
|
-
同级)。无宿主 scope 依赖、无锁竞争、无 isLoopback 陷阱、重启读回。
|
|
197
|
-
新增 `applySettingsToCfg(cfg, patch)`:**三处共用同一张「键 → cfg 字段」映射表**
|
|
198
|
-
(apply.js 启动 merge / scope.watch / http settings-set),消除重复漂移;
|
|
199
|
-
新增 `appendSettingsLog()`:**UI 提交日志**(`settings-ui.log` 0600,凭据打码,
|
|
200
|
-
每次设置页提交留痕,重启后验证「提交确实发生」)。
|
|
201
|
-
2. **apply.js**:启动时 `readSettings()` merge 进 cfg(注入/审计设置重启保持);
|
|
202
|
-
`setSettingsScope` 删除(不再依赖 host scope 持久化);watch 改用 applySettingsToCfg。
|
|
203
|
-
3. **http-handlers.js**:settings-get 读 config.json、settings-set 写 config.json + 同步 cfg;
|
|
204
|
-
写盘后 appendSettingsLog。
|
|
205
|
-
4. **client.js**:
|
|
206
|
-
- 新增 `commitSetting(key,value,okMsg)` 公共入口(**消除 toggle 四件套重复**:
|
|
207
|
-
改字段→editedKeys→publish→persistSetting;injectSystemPrompt 原来的 toggle
|
|
208
|
-
漏了 editedKeys 标记也顺带修复);
|
|
209
|
-
- `loadSettingsFromHttp` 用 `editedKeys` 守卫跳过用户已编辑的键(防回弹);
|
|
210
|
-
- 审计扫描范围按钮组改为**单按钮单击切换**(标题/颜色随状态变,
|
|
211
|
-
diff=🟢 部分 / full=🟡 全量,父开关关闭置灰),不再双按钮。
|
|
212
|
-
|
|
213
|
-
### 验证
|
|
214
|
-
settings 单测从「依赖 scope」改为「config.json 临时目录」语义:200 闭环 / 白名单 400 /
|
|
215
|
-
日志落盘打码等 6 条;真实 git 场景验证「工作树脏 + 领先也能推」(见 Bug 5);
|
|
216
|
-
回归 **560/560 全绿**;NM 主环境 6 个改动文件 md5 全一致(可安装重启验证)。
|
|
217
|
-
|
|
218
|
-
### 遗留 / 接手者注意
|
|
219
|
-
- config.json 已有旧内容(用户曾手动维护 auditEnabled/auditScanScope/auditLevel)——
|
|
220
|
-
写入采用「读现有+合并」语义,不会清掉旧键;`applySettingsToCfg` 只认类型正确的键。
|
|
221
|
-
- `settings-ui.log` 会持续增长:按需加轮转(当前仅逐行追加,量很小,暂不需要)。
|
|
222
|
-
- 前端 `persistSetting` 仍保留 `scope.set` 双通道(loopback 兼容),核心落盘靠 HTTP。
|
|
223
|
-
|
|
224
|
-
---
|
|
225
|
-
|
|
226
|
-
## Bug 5:账号卡片「push 判定写反」——能推的不让推,不能推的按钮才能点
|
|
227
|
-
|
|
228
|
-
### 现象
|
|
229
|
-
设置侧边栏「账号 → 本地」面板:**能推的仓库按钮灰着,不能推的仓库按钮却亮着**。
|
|
230
|
-
|
|
231
|
-
### 根因(2026-09-15 实测)
|
|
232
|
-
判定把「**工作树干净**」(`changed === 0`) 当成了「能推」的条件——但 `git push` 推的是
|
|
233
|
-
**已提交**内容,工作树脏不脏与本次推送无关(未提交改动仍留本地,下次提交再推)。
|
|
234
|
-
真实数据印证:
|
|
235
|
-
- `ahead=0`(已同步、无新提交)的仓库按钮却亮 → 点了后端返回「未领先」no-op → **不能推的按钮才能点**;
|
|
236
|
-
- 有领先提交但工作树脏(`changed>0`)的仓库被拦 → **能推的不让推**。
|
|
237
|
-
|
|
238
|
-
### 修复
|
|
239
|
-
- **后端 `lib/git/push.js`**:删除 `if (changed > 0) return 先提交再推送` 拦截;
|
|
240
|
-
可推与否只由 `ahead>0`(有未推送提交)决定,工作树脏不再拦。
|
|
241
|
-
- **前端 `client.js`**:`canPush = hasRemote && (ahead === null || ahead > 0)`
|
|
242
|
-
(ahead=null 状态未知可点,交后端 ls-remote 判定;ahead=0 已同步灰置)。
|
|
243
|
-
- **`runAudit`(lib/commit-push.js)**:audit 结果带 `findings`,拦截时 error 直接列出
|
|
244
|
-
被拦文件+规则(和全量审计一致,不再只说「N 个 blocker」说不清是哪些);
|
|
245
|
-
blocker 过滤抽成一次 `blocked` 变量(消除重复 filter)。
|
|
246
|
-
|
|
247
|
-
### 验证
|
|
248
|
-
真实 git 场景:临时仓库 + bare remote,提交 2 个后弄脏工作树 → `pushCurrentBranch`
|
|
249
|
-
不再被「先提交再推送」拦截(放行到推送通道);测试改前 2 个失败文件恢复全绿。
|
|
250
|
-
|
|
251
|
-
---
|
|
252
|
-
|
|
253
|
-
## 测试改动
|
|
254
|
-
|
|
255
|
-
- `test/test-audit-bad-file.mjs`(新增,未跟踪):`.env` 拦截测试**必须用真实 `.env` 文件名**——
|
|
256
|
-
`credfile-common` 的 path_pattern `(^|[\\/])\.env` 要求「.env 前是路径开头或斜杠」,
|
|
257
|
-
`.tmp-test-bad.env` 这类前缀名会绕过规则模式(曾因此误以为修复无效)。
|
|
258
|
-
- `README.md` test/ 树补 `test-audit-bad-file.mjs` 条目(否则 `scripts/tree-doc.mjs` 的
|
|
259
|
-
checkDrift 报漂移,导致 test-tree-doc.mjs 两个测试失败——**新增文件后必须同步 README 树**)。
|
|
260
|
-
|
|
261
|
-
---
|
|
262
|
-
|
|
263
|
-
## 相关文件清单(本次改动)
|
|
264
|
-
|
|
265
|
-
| 文件 | 改动 |
|
|
266
|
-
|---|---|
|
|
267
|
-
| `lib/audit/orchestrate.js` | auditChanged 证据收集收窄到变动文件(Bug 1 提速) |
|
|
268
|
-
| `lib/audit/collector.js` | isTextFile 点文件扩展名(Bug 2 第 1 层) |
|
|
269
|
-
| `lib/checks/credential-file.js` | pathPattern 读取 + level 契约(Bug 2 第 2、3 层) |
|
|
270
|
-
| `lib/rule/compilers/credential.js` | credfile-* 补 level(Bug 2 第 3 层) |
|
|
271
|
-
| `lib/app/settings-bridge.js` | **新增**:host scope 设置读写桥(Bug 3) |
|
|
272
|
-
| `lib/app/http-handlers.js` | 新增 settings-get/settings-set 端点(Bug 3) |
|
|
273
|
-
| `lib/app/apply.js` | apply 时 setSettingsScope(scope)(Bug 3) |
|
|
274
|
-
| `client.js` | loadSettingsFromHttp + persistSetting + 扫描范围按钮组(Bug 3 + Bug 2 前端补开关) |
|
|
275
|
-
| `test/test-audit-bad-file.mjs` | .env 测试改用真实文件名 |
|
|
276
|
-
| `test/test-plugin.mjs` | 新增 5 个 settings 端点单测(Bug 3) |
|
|
277
|
-
| `test/test-inject-system-prompt.mjs` | 断言改 persistSetting + 新增扫描按钮接线断言(Bug 3) |
|
|
278
|
-
| `README.md` | lib/app 树补 settings-bridge.js + test 树条目 |
|