dsh-git-push 3.0.0 → 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.
Files changed (65) hide show
  1. package/README.md +76 -48
  2. package/cli.mjs +4 -3
  3. package/lib/app/apply.js +11 -9
  4. package/lib/app/command-registry.js +4 -2
  5. package/lib/app/handlers/http-constants.js +8 -0
  6. package/lib/app/handlers/preprocess.js +3 -6
  7. package/lib/app/handlers/repo-actions.js +0 -1
  8. package/lib/app/handlers/repos.js +137 -10
  9. package/lib/app/handlers/settings.js +34 -15
  10. package/lib/app/index.js +1 -1
  11. package/lib/app/inject-text.js +3 -18
  12. package/lib/app/schema.js +20 -10
  13. package/lib/app/settings-bridge.js +60 -8
  14. package/lib/app/tool-call.js +26 -22
  15. package/lib/cli/commands-vcs.mjs +35 -1
  16. package/lib/cli/shared.mjs +1 -1
  17. package/lib/client/index.js +11 -16
  18. package/lib/client-parts/git/account.js +21 -12
  19. package/lib/client-parts/git/actions.js +23 -77
  20. package/lib/client-parts/git/apply.js +8 -2
  21. package/lib/client-parts/git/browser.js +1 -1
  22. package/lib/client-parts/git/const.js +33 -1
  23. package/lib/client-parts/git/controller.js +175 -176
  24. package/lib/client-parts/git/icons.js +1 -1
  25. package/lib/client-parts/git/loader.js +1 -1
  26. package/lib/client-parts/git/npm.js +56 -37
  27. package/lib/client-parts/git/page.js +53 -1
  28. package/lib/client-parts/git/repo.js +8 -1
  29. package/lib/client-parts/git/settings.js +13 -1
  30. package/lib/client-parts/git/state.js +237 -0
  31. package/lib/client-parts/git/utils.js +1 -1
  32. package/lib/client.js +631 -312
  33. package/lib/commit-push/pre-commit-engine.js +584 -32
  34. package/lib/commit-push.js +63 -47
  35. package/lib/context/index.js +7 -5
  36. package/lib/core/config.js +1 -27
  37. package/lib/core/exec.js +2 -11
  38. package/lib/git/identity-rewrite.js +1 -1
  39. package/lib/git/index.js +1 -1
  40. package/lib/git/push.js +2 -17
  41. package/lib/git/repo-index.js +8 -3
  42. package/lib/npm/install.js +1 -1
  43. package/lib/npm/registry.js +2 -2
  44. package/lib/plugin/auto-push.js +3 -6
  45. package/lib/preprocess/providers.js +5 -1
  46. package/lib/self/index.js +1 -1
  47. package/package.json +4 -7
  48. package/skills/dev/dsh-git-push.md +9 -9
  49. package/skills/guide/guide-commit-push.md +11 -13
  50. package/skills/workflow/README.md +0 -1
  51. package/skills/workflow/task-completion-report.md +2 -2
  52. package/.auditignore +0 -30
  53. package/.gitignore +0 -43
  54. package/lib/BUGFIX-NOTES-2026-09-14.md +0 -278
  55. package/lib/app/schema-preprocess.js +0 -42
  56. package/lib/user-requirements.json +0 -15
  57. package/scripts/build-client.mjs +0 -133
  58. package/scripts/bump-version.mjs +0 -178
  59. package/scripts/check.mjs +0 -205
  60. package/scripts/doc-func.mjs +0 -212
  61. package/scripts/doc-tree.mjs +0 -458
  62. package/scripts/doc-version.mjs +0 -149
  63. package/scripts/local-registry.mjs +0 -38
  64. package/scripts/scan-version.mjs +0 -125
  65. package/scripts/version-source.mjs +0 -173
@@ -19,7 +19,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
19
19
  | 凭据托管 | GitHub token 与 SSH 公钥统一存在插件配置目录,推送时自动注入,无需手动配 git 凭据 |
20
20
  | 推送通道 | `ssh`(默认,推本地 HEAD,远端 sha 与本地一致)/ `api`(Git Data API 重建提交)/ `auto`(有私钥走 ssh,否则 api) |
21
21
  | 后台任务 | commit+push 注册为宿主官方后台 job,工具立即返回 `jobId`;宿主无 job 控制器时同步执行保底 |
22
- | 门禁开关 | `requirementsConfirmed`(开发者要求核对)、`pushConfirmed`(推送门禁放行)、`force`(强推)、`dryRun`(只预演) |
22
+ | 门禁开关 | `pushConfirmed`(推送门禁放行)、`force`(强推)、`dryRun`(只预演) |
23
23
  | 任务完成自动推送 | 开关开启后,AI 回合结束的回复里含指定完成文案,自动对目标仓库走同一套门禁提交推送 |
24
24
  | 私有库豁免 | 远端可见性 = private 时,审计只报告不拦截;敏感文件只扫描报告、不改写忽略配置 |
25
25
 
@@ -32,11 +32,10 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
32
32
  | `repo` | string | ✅ | — | 本地 git 仓库根目录路径 |
33
33
  | `message` | string | ✅ | — | commit message;空/纯空白直接拒绝 |
34
34
  | `push` | boolean | — | `true` | `false` = 只提交不推送 |
35
- | `audit` | boolean | — | 取配置 `auditEnabled`(默认关) | `true` 强制审计、`false` 跳过本次审计 |
35
+ | `audit` | boolean | — | 取配置 `preCommit.enabled`(默认关) | `true` 强制过门禁、`false` 跳过本次 |
36
36
  | `dryRun` | boolean | — | `false` | 只预演:跑门禁与流程、不写盘、不 commit、不 push |
37
37
  | `force` | boolean | — | `false` | 强推覆盖远端历史(SSH 用 `--force`;API 通道重建提交、不挂旧 parent) |
38
38
  | `ignorePatterns` | string | — | 空 | 追加进 `.gitignore` 的自定义忽略项(逗号/换行分隔,幂等) |
39
- | `requirementsConfirmed` | boolean | — | `false` | 开发者要求清单已逐条核对达标才置 `true`,否则被拦 |
40
39
  | `pushConfirmed` | boolean | — | `false` | 推送门禁(配置 `pushGate`)开启时,推必须显式放行 |
41
40
  | `paths` | string | — | 空 | 精确 add 路径(逗号分隔,相对仓库);空 = 全量暂存 |
42
41
 
@@ -50,7 +49,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
50
49
  | `jobFallback` | `true` = 宿主后台 job 不可用,已自动降级为同步执行(结果就在 `result`) |
51
50
  | `audit` | 审计摘要(`summary` 各级数量 / `quality` 评分 / `blocked` 拦截明细 / `privateExempt` 私有库豁免标记);未开审计时为 `null` |
52
51
  | `hint` | 查询提示文案 |
53
- | `error` / `blocked` / `code` | 失败或拦截说明;`code` 取值 `USER_REQUIREMENTS`、`PUSH_GATE` |
52
+ | `error` / `blocked` / `code` | 失败或拦截说明;`code` 取值如 `PUSH_GATE` |
54
53
 
55
54
  ### 返回字段(最终结果 `result`——后台 job 完成输出,或同步执行直接返回)
56
55
 
@@ -74,7 +73,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
74
73
  **① 标准提交推送**(要求清单存在时必须带核对标记)
75
74
 
76
75
  ```js
77
- git_commit_push({ repo: "<仓库路径>", message: "feat: 新增 XX 能力", requirementsConfirmed: true })
76
+ git_commit_push({ repo: "<仓库路径>", message: "feat: 新增 XX 能力" })
78
77
  ```
79
78
 
80
79
  预期:`{ ok:true, async:true, jobId:"git-push-1", audit:{ summary:{...}, quality:{...} } }`;job 完成后输出 `{ ok:true, commitSha:"a1b2c3d…", pushed:true, push:{ method:"ssh", branch:"master" }, indexUpdated:true }`。
@@ -82,12 +81,12 @@ git_commit_push({ repo: "<仓库路径>", message: "feat: 新增 XX 能力", req
82
81
  **② 只提交不推送 / 先预演 / 只提交指定文件**
83
82
 
84
83
  ```js
85
- git_commit_push({ repo: "<仓库路径>", message: "docs: 更新说明", push: false, requirementsConfirmed: true })
84
+ git_commit_push({ repo: "<仓库路径>", message: "docs: 更新说明", push: false })
86
85
  git_commit_push({ repo: "<仓库路径>", message: "feat: 试跑", dryRun: true })
87
86
  // 零改动也照样调用:没有新提交时同样返回 ok:true(committed:false),
88
87
  // 而「本地领先远端」的已提交内容会照常推上去 —— 不要因为「没东西可提交」改去手敲 git
89
- git_commit_push({ repo: "<仓库路径>", message: "(零改动时用不到)", requirementsConfirmed: true })
90
- git_commit_push({ repo: "<仓库路径>", message: "fix: 修正解析", paths: "src/parser.js,README.md", requirementsConfirmed: true })
88
+ git_commit_push({ repo: "<仓库路径>", message: "(零改动时用不到)" })
89
+ git_commit_push({ repo: "<仓库路径>", message: "fix: 修正解析", paths: "src/parser.js,README.md" })
91
90
  ```
92
91
 
93
92
  预演预期:`{ ok:true, async:true, jobId:"git-push-2" }`,完成后 `{ ok:true, dryRun:true, steps:["预检","commit","push"] }`(无任何写入)。
@@ -95,15 +94,15 @@ git_commit_push({ repo: "<仓库路径>", message: "fix: 修正解析", paths: "
95
94
  **③ 推送门禁已开启时显式放行 / 强推**
96
95
 
97
96
  ```js
98
- git_commit_push({ repo: "<仓库路径>", message: "chore: 同步", requirementsConfirmed: true, pushConfirmed: true })
99
- git_commit_push({ repo: "<仓库路径>", message: "chore: 重写历史后同步", force: true, requirementsConfirmed: true, pushConfirmed: true })
97
+ git_commit_push({ repo: "<仓库路径>", message: "chore: 同步", pushConfirmed: true })
98
+ git_commit_push({ repo: "<仓库路径>", message: "chore: 重写历史后同步", force: true, pushConfirmed: true })
100
99
  ```
101
100
 
102
101
  **④ 被拦后的典型返回**
103
102
 
104
103
  ```json
105
104
  { "ok": false, "blocked": true, "error": "审计拦截:2 个 blocker → src/a.js:12(凭据硬编码);docs/b.md:3(沟通措辞残留)" }
106
- { "ok": false, "blocked": true, "code": "USER_REQUIREMENTS", "error": "开发者特殊要求未核对:…" }
105
+ { "ok": false, "blocked": true, "code": "PUSH_GATE", "error": "推送门禁已开启,需 pushConfirmed:true 后重试" }
107
106
  { "ok": false, "blocked": true, "code": "PUSH_GATE", "commitSha": "a1b2c3d…", "push": { "pushed": false, "reason": "push-gate" } }
108
107
  ```
109
108
 
@@ -112,7 +111,6 @@ git_commit_push({ repo: "<仓库路径>", message: "chore: 重写历史后同步
112
111
  | 现象 | 原因 | 处理 |
113
112
  |---|---|---|
114
113
  | `ok:false, blocked:true`(审计拦截) | 审计命中 blocker(凭据硬编码、语法错误、沟通措辞等) | 先按 `audit.blocked` 列表修文件,再重调;`public`/`unknown` 可见性一律保守拦截 |
115
- | 返回 `code:"USER_REQUIREMENTS"` | 存在开发者要求清单,但未带 `requirementsConfirmed:true` | 逐条核对达标后置 `true` 重调 |
116
114
  | 返回 `code:"PUSH_GATE"` | 配置 `pushGate` 已开启,未带 `pushConfirmed:true` | 确认要推时带 `pushConfirmed:true` 重调(**可沿用本次 commit,不会重复提交**) |
117
115
  | `非 git 仓库` / `commit message 必填` | `repo` 下无 `.git`,或 `message` 为空 | 先确认仓库路径、补 message |
118
116
  | `HEAD 处于 detached 状态` | 当前在游离 HEAD 上 | 先 `git checkout <分支>` 再提交 |
@@ -168,7 +166,7 @@ git_commit_push({ repo: "<仓库路径>", message: "chore: 重写历史后同步
168
166
  "message": "fix(audit): 修 secret-email 把 @2x 资源名当邮箱的误报",
169
167
  "messageItems": [
170
168
  { "what": "pattern 增加资源后缀负向前瞻", "type": "fix", "scope": "audit-rules",
171
- "why": "视网膜文件名被当成 x@y.tld", "verify": "双向自测 6 例通过" },
169
+ "why": "视网膜文件名被当成邮箱地址", "verify": "双向自测 6 例通过" },
172
170
  "门禁四项绿;全量测试 0 失败"
173
171
  ]
174
172
  }
@@ -17,5 +17,4 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
17
17
 
18
18
  ## 已内置化
19
19
 
20
- - 开发者要求清单 → `lib/user-requirements.json`(随插件分发;v2 未移植,待验收)
21
20
  - 仓库索引 → 废弃 md 表格,改用 JSON 索引(生成于插件配置目录的 `dsh-repo-index.jsonl`)
@@ -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` 前必须按本格式收尾(或即将收尾),✅ 即提交推送授权(要求清单随插件内置 `lib/user-requirements.json`,原同级仓 requirements.md 废除)。
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;开发者要求清单(内置 `lib/user-requirements.json`,可外挂插件配置目录 `requirements.json`)逐条核对后带 `requirementsConfirmed:true`
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/
@@ -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 树条目 |
@@ -1,42 +0,0 @@
1
- /**
2
- * 插件入口层 · 配置 schema(审计侧)
3
- *
4
- * 为什么单独成文件(2026-11-08 UI 与审计解耦 · 文件隔离阶段):
5
- * 审计与 git 侧计划重构成两个独立项目,本阶段先把**文件边界**划清——
6
- * 审计相关设置键集中在本文件,git / 发布侧的键留在 `schema.js`。
7
- * 行为完全不变:`schema.js` 用 `...auditConfigShape(Schema)` 展开合并,
8
- * 产出的仍是同一个 Config 对象(同一批键、同一批默认值)。
9
- *
10
- * 边界判据:键的语义属于「静态检查 / 规则 / 评分 / 措辞」即归审计侧;
11
- * 属于「扫描仓库 / 克隆 / 推送 / 凭据 / 注入」留在 schema.js。
12
- * `injectRequirements` 归审计侧:它是「提交前审计」的子开关(注入开发者要求清单)。
13
- */
14
-
15
- /** 全量审计文件数上限默认值(0=不限)。 */
16
- const DEFAULT_MAX_SCAN_FILES = 3000;
17
-
18
- /**
19
- * 审计侧配置键形状。
20
- * @param {object} Schema schemastery(或 makeFallbackSchema 兜底实现)
21
- * @returns {object} 键名 → schema 字段
22
- */
23
- export function auditConfigShape(Schema) {
24
- return {
25
- auditEnabled: Schema.boolean().default(false).description('提交前审计(默认关)'),
26
- // 提交前审计的子开关:开启后在系统提示词注入「开发者特殊要求」清单全文,AI 常驻可见、
27
- // 不必等门禁拦截才去读清单(省一次失败的工具往返)。auditEnabled 关闭时本项不生效。
28
- maxScanFiles: Schema.number().default(DEFAULT_MAX_SCAN_FILES).description('全量审计文件数上限(0=不限);超限按变动文件优先截断,防止弱机扫大仓卡死'),
29
- injectRequirements: Schema.boolean().default(false).description('注入开发者要求清单到系统提示词(可直接勾选;父开关「提交前审计」关闭时置灰且不注入,勾选保留;默认关)'),
30
- auditScanScope: Schema.string().default('diff').description('diff | full'),
31
- auditRuleOrder: Schema.array(Schema.string()).default([]).description('规则槽位加载顺序(后加载覆盖先加载;空=默认偏好顺序;private 恒末尾强制)'),
32
- auditDisabledSlots: Schema.array(Schema.string()).default([]).description('UI 禁用的规则槽位(设置页单击切换;nodejs/private 安全红线不可禁用)'),
33
- weightOverrides: Schema.string().default('').description('权重覆盖 JSON(如 {"安全性":100},空=默认权重表)'),
34
- linkCheckEnabled: Schema.boolean().default(false).description('链接检查(默认关,需网络)'),
35
- commentWordingEnabled: Schema.boolean().default(true).description('提交信息措辞检查'),
36
- commentWordingCustom: Schema.string().default('').description('自定义措辞规则'),
37
- commentWordingRulesFile: Schema.string().default('').description('措辞规则文件路径'),
38
- commentWordingRulesUrl: Schema.string().default('').description('措辞规则 URL'),
39
- auditRuleWeights: Schema.dict(Schema.any()).default({}).description('规则权重({ blacklist: { pattern: weight } })'),
40
- qualityWeights: Schema.dict(Schema.number()).default({}).description('质量维度权重覆盖({ 维度名: weight })'),
41
- };
42
- }
@@ -1,15 +0,0 @@
1
- {
2
- "user": "默认开发者",
3
- "description": "默认开发者特殊要求(AI 调用 git_commit_push / git_remote_create 前必须逐条核对达标,全部达标才执行)",
4
- "items": [
5
- "提交信息写清做了什么:commit message 必须描述本次实际变更内容(做了什么),禁止空泛词(如 update、fix、改了点东西);格式建议 feat:/fix:/docs:/chore: 前缀 + 具体说明,先在会话和用户讨论经过用户确认",
6
- "单文件代码非必要不要超过 400 行,否则需要按功能拆分",
7
- "大文件/产物不入库:node_modules、lock 文件、构建产物、下载的图片/视频等若无引用不入库;如已入库需先清理(.gitignore + 必要时 git rm --cached),tools/tool 文件夹的二进制文件可以豁免,bin 文件夹新增文件第一次提交提醒用户确认是否需要提交",
8
- "敏感信息不入库:token/密钥/密码/凭据文件不入公开仓库;如涉及需先移出或豁免确认",
9
- "删除需可恢复:删除文件/目录前先确认有 git 历史或备份(禁 rm -rf 无痕删除),大删除先 commit 检查点",
10
- "文档对话类措辞:公开仓库文档只写做了什么,不含会话引用/决策来源/AI 许可表述/商量转述等沟通措辞(见 release-docs-rule)",
11
- "dryRun 先行:批量/破坏性操作(重建历史、删除、迁移)先 dryRun 预演,确认无误再执行",
12
- "版本号同步:功能变更时同步更新 package.json version 与 README 版本记录表",
13
- "提交信息结构化:提交信息含**多个要点**或需要 why/verify 溯源时,用 messageItems 传数组(元素为字符串或 {what,type?,scope?,why?,verify?,refs?},仅 what 必填)——message 只传字符串(宿主校验只认标量类型)并作标题,条目会渲染成要点与正文;简单一句话说清时用字符串即可,不必强行结构化"
14
- ]
15
- }