dsh-git-push 0.0.0-stage → 2.8.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (278) hide show
  1. package/.auditignore +30 -0
  2. package/.gitignore +39 -0
  3. package/LICENSE +21 -0
  4. package/README.md +1482 -2
  5. package/cli.mjs +360 -0
  6. package/cordis.patch.yml +14 -0
  7. package/lib/ARCHITECTURE.md +34 -0
  8. package/lib/BUGFIX-NOTES-2026-09-14.md +278 -0
  9. package/lib/app/apply.js +275 -0
  10. package/lib/app/audit-api.js +158 -0
  11. package/lib/app/command-registry.js +262 -0
  12. package/lib/app/constants.js +16 -0
  13. package/lib/app/handlers/account.js +166 -0
  14. package/lib/app/handlers/clone.js +168 -0
  15. package/lib/app/handlers/http-constants.js +9 -0
  16. package/lib/app/handlers/identity-rewrite.js +94 -0
  17. package/lib/app/handlers/meta.js +175 -0
  18. package/lib/app/handlers/npm.js +169 -0
  19. package/lib/app/handlers/repo-actions.js +143 -0
  20. package/lib/app/handlers/repos.js +231 -0
  21. package/lib/app/handlers/settings.js +62 -0
  22. package/lib/app/host-doc-checks.js +25 -0
  23. package/lib/app/http-handlers.js +131 -0
  24. package/lib/app/index.js +30 -0
  25. package/lib/app/inject-text.js +191 -0
  26. package/lib/app/scan-root.js +23 -0
  27. package/lib/app/schema.js +150 -0
  28. package/lib/app/settings-bridge.js +167 -0
  29. package/lib/app/slash-commands.js +395 -0
  30. package/lib/app/slot-stats.js +35 -0
  31. package/lib/app/tool-call.js +662 -0
  32. package/lib/app/tools.js +40 -0
  33. package/lib/ast/brace.js +105 -0
  34. package/lib/ast/callgraph.js +135 -0
  35. package/lib/ast/code-lines.js +114 -0
  36. package/lib/ast/consts.js +12 -0
  37. package/lib/ast/control-flow.js +461 -0
  38. package/lib/ast/credential.js +199 -0
  39. package/lib/ast/dataflow.js +274 -0
  40. package/lib/ast/dup-code.js +165 -0
  41. package/lib/ast/index.js +36 -0
  42. package/lib/ast/io-risk-const.js +95 -0
  43. package/lib/ast/io-risk-fn.js +208 -0
  44. package/lib/ast/io-risk-loop.js +308 -0
  45. package/lib/ast/io-risk.js +314 -0
  46. package/lib/ast/lang.js +156 -0
  47. package/lib/ast/line-count.js +52 -0
  48. package/lib/ast/magic-number.js +272 -0
  49. package/lib/ast/naming.js +284 -0
  50. package/lib/ast/perf.js +472 -0
  51. package/lib/ast/scope.js +241 -0
  52. package/lib/ast/shell.js +131 -0
  53. package/lib/ast/size.js +378 -0
  54. package/lib/ast/symbol-index.js +399 -0
  55. package/lib/ast/tokenizer.js +341 -0
  56. package/lib/audit/analysis-coverage.js +98 -0
  57. package/lib/audit/audit-file.js +182 -0
  58. package/lib/audit/checks.js +17 -0
  59. package/lib/audit/client-entry.js +93 -0
  60. package/lib/audit/collector.js +477 -0
  61. package/lib/audit/ext-runner.js +80 -0
  62. package/lib/audit/file-context.js +138 -0
  63. package/lib/audit/finding.js +50 -0
  64. package/lib/audit/gitignore-match.js +113 -0
  65. package/lib/audit/glob.js +63 -0
  66. package/lib/audit/history-report.js +100 -0
  67. package/lib/audit/history.js +126 -0
  68. package/lib/audit/ignore-blind.js +101 -0
  69. package/lib/audit/index.js +33 -0
  70. package/lib/audit/orchestrate.js +476 -0
  71. package/lib/audit/public.js +24 -0
  72. package/lib/audit/repo-level.js +30 -0
  73. package/lib/audit/report-yaml.js +86 -0
  74. package/lib/audit/slot.js +65 -0
  75. package/lib/audit-defaults.js +18 -0
  76. package/lib/audit-rules/audit-rules-comment.yml +247 -0
  77. package/lib/audit-rules/audit-rules-cpp.yml +22 -0
  78. package/lib/audit-rules/audit-rules-docs.yml +32 -0
  79. package/lib/audit-rules/audit-rules-dsh.yml +162 -0
  80. package/lib/audit-rules/audit-rules-filehealth.yml +42 -0
  81. package/lib/audit-rules/audit-rules-folder.yml +99 -0
  82. package/lib/audit-rules/audit-rules-frontend.yml +335 -0
  83. package/lib/audit-rules/audit-rules-go.yml +22 -0
  84. package/lib/audit-rules/audit-rules-i18n.yml +45 -0
  85. package/lib/audit-rules/audit-rules-java.yml +105 -0
  86. package/lib/audit-rules/audit-rules-nodejs.yml +647 -0
  87. package/lib/audit-rules/audit-rules-npm.yml +187 -0
  88. package/lib/audit-rules/audit-rules-paths.yml +92 -0
  89. package/lib/audit-rules/audit-rules-performance.yml +207 -0
  90. package/lib/audit-rules/audit-rules-php.yml +22 -0
  91. package/lib/audit-rules/audit-rules-private.yml +24 -0
  92. package/lib/audit-rules/audit-rules-python.yml +106 -0
  93. package/lib/audit-rules/audit-rules-robustness.yml +27 -0
  94. package/lib/audit-rules/audit-rules-rust.yml +22 -0
  95. package/lib/audit-rules/audit-rules-structure.yml +159 -0
  96. package/lib/audit-rules/audit-rules-swift.yml +22 -0
  97. package/lib/audit-rules/audit-rules-template.yml +108 -0
  98. package/lib/checks/button-bind.js +276 -0
  99. package/lib/checks/common.js +170 -0
  100. package/lib/checks/credential-file.js +43 -0
  101. package/lib/checks/dataflow.js +40 -0
  102. package/lib/checks/dispatch.js +112 -0
  103. package/lib/checks/dup-code.js +69 -0
  104. package/lib/checks/dup-const.js +232 -0
  105. package/lib/checks/file-health.js +150 -0
  106. package/lib/checks/filter.js +131 -0
  107. package/lib/checks/folder.js +173 -0
  108. package/lib/checks/hardcoded-path.js +98 -0
  109. package/lib/checks/index.js +46 -0
  110. package/lib/checks/io.js +66 -0
  111. package/lib/checks/magic-number.js +42 -0
  112. package/lib/checks/npm-json.js +273 -0
  113. package/lib/checks/private.js +63 -0
  114. package/lib/checks/regex.js +256 -0
  115. package/lib/checks/semantic.js +134 -0
  116. package/lib/checks/structural.js +274 -0
  117. package/lib/cli/commands-account.mjs +107 -0
  118. package/lib/cli/commands-audit.mjs +144 -0
  119. package/lib/cli/commands-doc.mjs +127 -0
  120. package/lib/cli/commands-vcs.mjs +175 -0
  121. package/lib/client/index.js +162 -0
  122. package/lib/client-parts/00-loader.js +33 -0
  123. package/lib/client-parts/01-const.js +207 -0
  124. package/lib/client-parts/02-utils.js +62 -0
  125. package/lib/client-parts/03-icons.js +12 -0
  126. package/lib/client-parts/10-account.js +83 -0
  127. package/lib/client-parts/11-browser.js +95 -0
  128. package/lib/client-parts/20-repo.js +374 -0
  129. package/lib/client-parts/21-audit.js +301 -0
  130. package/lib/client-parts/22-settings.js +146 -0
  131. package/lib/client-parts/23-npm.js +383 -0
  132. package/lib/client-parts/30-page.js +56 -0
  133. package/lib/client-parts/40-controller.js +1092 -0
  134. package/lib/client-parts/41-actions.js +279 -0
  135. package/lib/client-parts/99-apply.js +72 -0
  136. package/lib/client.js +3195 -0
  137. package/lib/commit-push.js +144 -0
  138. package/lib/context/index.js +363 -0
  139. package/lib/core/atomic-json.js +98 -0
  140. package/lib/core/config.js +40 -0
  141. package/lib/core/credentials.js +274 -0
  142. package/lib/core/endpoints.js +109 -0
  143. package/lib/core/exec.js +162 -0
  144. package/lib/exempt/index.js +292 -0
  145. package/lib/fs/edit-after-read.js +103 -0
  146. package/lib/fsx.js +87 -0
  147. package/lib/git/account-status.js +140 -0
  148. package/lib/git/account.js +233 -0
  149. package/lib/git/api.js +136 -0
  150. package/lib/git/atomic-json.js +6 -0
  151. package/lib/git/browse.js +38 -0
  152. package/lib/git/clone-download.js +397 -0
  153. package/lib/git/clone-history-mode.js +143 -0
  154. package/lib/git/clone-history.js +175 -0
  155. package/lib/git/clone-jobs.js +250 -0
  156. package/lib/git/clone-replay-io.js +172 -0
  157. package/lib/git/clone-replay.js +275 -0
  158. package/lib/git/clone.js +445 -0
  159. package/lib/git/cloud.js +46 -0
  160. package/lib/git/commit-message.js +141 -0
  161. package/lib/git/config.js +6 -0
  162. package/lib/git/cred-env.js +88 -0
  163. package/lib/git/credentials.js +6 -0
  164. package/lib/git/endpoints.js +6 -0
  165. package/lib/git/exec.js +6 -0
  166. package/lib/git/identity-rewrite.js +297 -0
  167. package/lib/git/identity.js +150 -0
  168. package/lib/git/ignore.js +69 -0
  169. package/lib/git/index.js +41 -0
  170. package/lib/git/module-splitter.js +47 -0
  171. package/lib/git/post-push.js +101 -0
  172. package/lib/git/push-diagnose.js +142 -0
  173. package/lib/git/push.js +470 -0
  174. package/lib/git/remote-resolve.js +146 -0
  175. package/lib/git/remote.js +128 -0
  176. package/lib/git/repo-index.js +512 -0
  177. package/lib/git/repos.js +235 -0
  178. package/lib/git/scan-runner.js +159 -0
  179. package/lib/git/sensitive.js +134 -0
  180. package/lib/git/transport.js +430 -0
  181. package/lib/git/visibility.js +35 -0
  182. package/lib/git/wrapped-git.js +68 -0
  183. package/lib/http/index.js +170 -0
  184. package/lib/index.js +24 -0
  185. package/lib/link-check/index.js +187 -0
  186. package/lib/npm/account.js +64 -0
  187. package/lib/npm/install.js +211 -0
  188. package/lib/npm/npmrc.js +56 -0
  189. package/lib/npm/publish.js +167 -0
  190. package/lib/npm/registry.js +147 -0
  191. package/lib/plugin/auto-detect.js +92 -0
  192. package/lib/plugin/auto-push.js +154 -0
  193. package/lib/plugin/index.js +250 -0
  194. package/lib/readme-templates/readme.yml +38 -0
  195. package/lib/rule/compilers/credential.js +62 -0
  196. package/lib/rule/compilers/dataflow.js +38 -0
  197. package/lib/rule/compilers/file-health.js +75 -0
  198. package/lib/rule/compilers/frontend.js +86 -0
  199. package/lib/rule/compilers/func.js +35 -0
  200. package/lib/rule/compilers/helpers.js +71 -0
  201. package/lib/rule/compilers/index.js +29 -0
  202. package/lib/rule/compilers/link-semantic.js +45 -0
  203. package/lib/rule/compilers/list-kinds.js +12 -0
  204. package/lib/rule/compilers/numeric-kinds.js +66 -0
  205. package/lib/rule/compilers/regex.js +78 -0
  206. package/lib/rule/compilers/structure.js +80 -0
  207. package/lib/rule/compilers.js +17 -0
  208. package/lib/rule/homoglyph.js +45 -0
  209. package/lib/rule/loader.js +270 -0
  210. package/lib/rule/registry.js +115 -0
  211. package/lib/rule/scope.js +67 -0
  212. package/lib/score/docs-score.js +166 -0
  213. package/lib/score/index.js +140 -0
  214. package/lib/self/index.js +193 -0
  215. package/lib/skip-dirs.js +64 -0
  216. package/lib/tool-probes.json +50 -0
  217. package/lib/user-requirements.json +14 -0
  218. package/lib/vendor/js-yaml/LICENSE +21 -0
  219. package/lib/vendor/js-yaml/js-yaml.mjs +3073 -0
  220. package/package.json +95 -4
  221. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  222. package/scripts/audit-ext/_example-readme-present.mjs +34 -0
  223. package/scripts/audit-ext/variable-min-length.mjs +102 -0
  224. package/scripts/audit-runner.mjs +35 -0
  225. package/scripts/audit-runtime-check.mjs +129 -0
  226. package/scripts/browser-page-probe.mjs +271 -0
  227. package/scripts/build-client.mjs +119 -0
  228. package/scripts/check.mjs +88 -0
  229. package/scripts/clean-date-comments.py +102 -0
  230. package/scripts/doc-drift.mjs +200 -0
  231. package/scripts/doc-func.mjs +212 -0
  232. package/scripts/doc-tree.mjs +456 -0
  233. package/scripts/doc-version.mjs +220 -0
  234. package/scripts/frontend-preview-check.mjs +124 -0
  235. package/scripts/hot-path-probe-cjs.cjs +71 -0
  236. package/scripts/hot-path-probe-fs-shim.mjs +28 -0
  237. package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
  238. package/scripts/hot-path-probe.mjs +153 -0
  239. package/scripts/module-splitter.py +800 -0
  240. package/scripts/platform-scan.mjs +168 -0
  241. package/scripts/preview-gen.mjs +489 -0
  242. package/scripts/preview-local-runner.mjs +55 -0
  243. package/scripts/preview-server-direct.mjs +116 -0
  244. package/scripts/preview-server.mjs +305 -0
  245. package/scripts/preview-slot-data.mjs +123 -0
  246. package/scripts/probe-recheck.mjs +47 -0
  247. package/scripts/readme-gen.mjs +268 -0
  248. package/scripts/rename-locator.mjs +97 -0
  249. package/scripts/rule-switch.mjs +97 -0
  250. package/scripts/rules-solo-audit.mjs +173 -0
  251. package/scripts/scan-file-io.mjs +713 -0
  252. package/scripts/scan-hardcoded-paths.mjs +125 -0
  253. package/scripts/scan-repos.mjs +167 -0
  254. package/scripts/scan-version.mjs +122 -0
  255. package/scripts/scrub-user-wording.mjs +420 -0
  256. package/scripts/symbol-index.mjs +85 -0
  257. package/scripts/sync-plugin-install.mjs +223 -0
  258. package/scripts/sync-plugin.mjs +279 -0
  259. package/scripts/verify-prestep.mjs +100 -0
  260. package/skills/dev/audit-rule-authoring.md +58 -0
  261. package/skills/dev/dsh-git-push.md +323 -0
  262. package/skills/dev/git-push-live-fix.md +45 -0
  263. package/skills/dsh-repo-index.md +35 -0
  264. package/skills/guide/guide-audit.md +167 -0
  265. package/skills/guide/guide-cli-scripts.md +104 -0
  266. package/skills/guide/guide-clone-repos.md +173 -0
  267. package/skills/guide/guide-commit-push.md +156 -0
  268. package/skills/guide/guide-inject-ui.md +166 -0
  269. package/skills/guide/guide-slash-completion.md +118 -0
  270. package/skills/workflow/README.md +21 -0
  271. package/skills/workflow/git-commit-discipline.md +68 -0
  272. package/skills/workflow/git-project-startup.md +85 -0
  273. package/skills/workflow/git-rebuild-process.md +57 -0
  274. package/skills/workflow/github-operations.md +91 -0
  275. package/skills/workflow/readme-sync-git-md.md +28 -0
  276. package/skills/workflow/task-completion-report.md +73 -0
  277. package/skills/workflow/tool-json-add-ask.md +35 -0
  278. package/skills/workflow/versioning-rule.md +211 -0
@@ -0,0 +1,278 @@
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 树条目 |
@@ -0,0 +1,275 @@
1
+ /**
2
+ * 插件入口层 · apply(插件装载入口)
3
+ *
4
+ * 宿主加载插件时调用:注册配置 schema、注册工具、注册 HTTP 路由、注册注入钩子。
5
+ * 本模块只做「注册编排」,具体处理逻辑在 handlers.js,工具声明在 tools.js。
6
+ */
7
+
8
+ import { VERSION } from '../self/index.js';
9
+ import { persistGithubToken, persistSshPub, credentialsDir } from '../git/index.js';
10
+ import { createEnvInjectionText, collectToolPaths, mapWorkspaceDirs } from '../context/index.js';
11
+ import { defaultConfig, resolveConfig } from '../client/index.js';
12
+ import { loadDefineTool, registerTools, registerContext, registerHttp, registerPreStepInjection } from '../plugin/index.js';
13
+ // 【2026-10-02 · DSH 0.2.0-rc.2 适配】0.2.0 删除了 settings.register / settings.get 旧 API
14
+ // (settings 服务改为 SettingsForms:describe/update/replace/mutate/configure,命名空间由
15
+ // Loader 条目派生)。本插件改为「特性检测自动切换」:旧宿主走 register 分支、0.2.0 走
16
+ // describe 分支,故 GIT_PUSH_SETTINGS_NS(命名空间名)与 Config(旧分支注册用 schema)
17
+ // 两个 import 仍需保留。按 comment-not-delete 保留原行注释,便于回退与对照。
18
+ // 【原代码】import { GIT_PUSH_SETTINGS_NS, name } from './constants.js';
19
+ import { GIT_PUSH_SETTINGS_NS } from './constants.js';
20
+ import { adaptHttpHandler } from './http-handlers.js';
21
+ import { readSettings, applySettingsToCfg, writeSettingsKey } from './settings-bridge.js';
22
+ import { FUNCTION_USAGE_HINT, README_CHECK_HINT, buildRequirementsInjectionText } from './inject-text.js';
23
+ // 【原代码】import { Config } from './schema.js';
24
+ import { Config } from './schema.js';
25
+ import { callTool } from './tool-call.js';
26
+ import { listTools } from './tools.js';
27
+ import { registerSlashCommands } from './slash-commands.js';
28
+ import { registerAutoPush } from '../plugin/auto-push.js';
29
+ import { join } from 'node:path';
30
+
31
+ /** 系统提示词注入段的排序号(越大越靠前;同段位相对顺序固定)。 */
32
+ // 运行环境段(ORDER_ENV=980)迁出 systemPrompt → 改用上下文注入
33
+ // (agent/pre-step,registerPreStepInjection,见下方 2.5 步);systemPrompt 只留三段。
34
+ const ORDER_USAGE = 990; // 功能用法(工具清单 + 凭据托管说明)
35
+ const ORDER_README_CHECK = 991; // 提交前必须核对 README 的提醒
36
+ const ORDER_REQUIREMENTS = 992; // 开发者要求清单(提交前逐条核对)
37
+
38
+ /**
39
+ * 插件应用入口(DSH 调用)。
40
+ * @param {object} ctx DSH 上下文(提供 inject / tools / http / log)
41
+ * @param {object} [config] 插件配置
42
+ */
43
+ export async function apply(ctx, config = {}) {
44
+ const cfg = resolveConfig(config);
45
+ // 【原实现·历史】早前以为 ctx.log 是服务属性、未 inject 直读会抛,故改用 ctx.get('log'):
46
+ // "cannot get property \"log\" without inject" 导致插件树加载失败、实例退出。
47
+ // 实测(0.1.6 / 0.2.0)宿主并无 log 服务 → 该读法恒 undefined(见下方修正)。
48
+ // 【修复】日志句柄:cordis 的 logger 是**内置属性** `ctx.logger`,不是服务——
49
+ // 修复背景:排查后台 job 降级时发现**降级原因完全看不到**——
50
+ // 插件所有日志被静默丢弃(ctx.get('log') 恒 undefined),故与 job 修复一并处理。
51
+ // 宿主(0.1.6 与 0.2.0 均实测)**没有名为 log 的服务**,`ctx.get('log')` 恒 undefined,
52
+ // 于是插件所有日志(接线信息、job 降级原因)被静默丢弃、排障时什么都看不到。
53
+ // 改为优先取内置 logger(属性读取包 try/catch 兜底),再退回 get('log') 兼容旧宿主。
54
+ let log;
55
+ try { log = ctx?.logger; } catch { /* 属性读取异常忽略 */ }
56
+ if (!log && typeof ctx?.get === 'function') {
57
+ try { log = ctx.get('log'); } catch { /* 无 log 服务 */ }
58
+ }
59
+ const env = {
60
+ version: VERSION,
61
+ // 【修复 】ctx.workspaceRoot 同为 cordis 服务属性,直读抛 without inject;
62
+ // 与 ctx.log 一样改 ctx.get() 防御式读取(缺失返回 undefined,回退到空串)。
63
+ workspaceRoot: config.workspaceRoot || ctx?.get?.('workspaceRoot') || '',
64
+ extraRepos: String(config.extraRepos || '').split(',').map((str) => str.trim()).filter(Boolean),
65
+ extraReposFile: String(config.extraReposFile || ''),
66
+ };
67
+
68
+ // 1) agent 工具:ctx.inject(['tools']) → get('tools').register(defineTool(spec))
69
+ // defineTool 动态加载:工作区自测环境没有 DSH 依赖,装在 profile 内必可解析。
70
+ const defineTool = await loadDefineTool(log);
71
+ // 宿主官方后台 job 服务(dsh-jobs-local):ctx.get 防御式读取,缺失时 git_commit_push 同步执行
72
+ const jobs = ctx?.get?.('jobs');
73
+ const toolCount = registerTools(ctx, {
74
+ defineTool,
75
+ tools: listTools(),
76
+ // 透传 exec(宿主执行工具时注入 exec.agent)——callTool 用它作 jobs.start 的
77
+ // owner(owner 对上了 scoped job 控制器才会放行,否则 start 抛 no controller serves)。
78
+ invoke: (toolName, args, exec) => callTool(toolName, args, env, cfg, log, jobs, exec),
79
+ log,
80
+ });
81
+
82
+ // 2) 系统提示词注入:callback 体内必须调用 section()(返回值不是注册);text 必须同步
83
+ //
84
+ // 改造:总开关 injectSystemPrompt(侧边栏可勾,默认开)控制整组注入;
85
+ // 环境段迁出:运行环境(工作区目录 + 工具安装路径 + skill 总入口)改走
86
+ // 上下文注入(agent/pre-step,见下方 2.5 步),systemPrompt 只留三段:
87
+ // ①功能用法(990,每个工具怎么用 + 凭据由插件托管,治「不用插件到处找凭据」)
88
+ // ②提交前 README 提醒(991)+ 开发者要求清单(992,挂审计子开关)
89
+ // 只注入目录/路径级信息,不注入 skill 正文、不列 skill 文件清单。
90
+ //
91
+ // 环境注入惰性缓存:探测(which + git rev-parse)是同步 spawn,首次注入时算一次,
92
+ // 避免每次读上下文都 spawn 一轮;开关切换时清缓存重算。
93
+ // 缓存按 root 键化(Map<root, text>)——注入 cwd 现在优先取**会话工作区**
94
+ // (agent.session.header.cwd),不同会话/agent 的工作目录不同,不能共用单条缓存。
95
+ let envInjectCache = null;
96
+ // @param {string} [cwdOverride] 会话工作区(agent.session.header.cwd,宿主 sandbox-policy 同源真源);
97
+ // 空 = 回退宿主全局 workspaceRoot(=DSH 安装根)
98
+ const envInjectText = (cwdOverride) => {
99
+ if (!cfg.injectSystemPrompt) return '';
100
+ const root = cwdOverride || env.workspaceRoot || process.cwd();
101
+ if (envInjectCache instanceof Map && envInjectCache.has(root)) return envInjectCache.get(root);
102
+ let text = '';
103
+ try {
104
+ // 工具清单:lib/tool-probes.json 模板(只 key,跨平台裸名)→ which/where 实测
105
+ // (Windows 自动补 .exe)→ 结果落盘运行目录 <配置目录>/tools.json
106
+ // (工具为 key、值为本机实测路径,不入库、可热改)。
107
+ const toolsFile = join(credentialsDir({ workspaceRoot: env.workspaceRoot }), 'tools.json');
108
+ const tools = collectToolPaths(null, { resultFile: toolsFile });
109
+ // cwd 一并传 root:git 根探测 / 子目录列举都发生在会话工作区,而不是宿主进程 cwd
110
+ const workspace = mapWorkspaceDirs({ workspaceRoot: root, cwd: root });
111
+ text = createEnvInjectionText({
112
+ cwd: root,
113
+ projectRoot: workspace.projectDir || root,
114
+ tools,
115
+ workspace,
116
+ });
117
+ } catch (e) {
118
+ // 探测失败降级为静态工具清单(注入不因探测异常而中断)
119
+ log?.warn?.(`环境注入探测失败,降级静态清单:${e?.message || e}`);
120
+ text = createEnvInjectionText({ cwd: root, projectRoot: root });
121
+ }
122
+ if (!(envInjectCache instanceof Map)) envInjectCache = new Map();
123
+ envInjectCache.set(root, text);
124
+ return text;
125
+ };
126
+
127
+ const sectionCount = registerContext(ctx, {
128
+ sections: [
129
+ // 功能用法(插件每个工具怎么用 + 凭据托管说明)
130
+ { name: 'dsh-git-push-usage', order: ORDER_USAGE, text: () => (cfg.injectSystemPrompt ? (cfg.injectUsageText || FUNCTION_USAGE_HINT) : '') }, // injectUsageText 配置覆盖默认注入文本
131
+ { name: 'dsh-git-push-readme-check', order: ORDER_README_CHECK, text: () => (cfg.injectSystemPrompt ? README_CHECK_HINT : '') },
132
+ // 开发者要求清单(子开关:注入总开关 且 提交前审计 且 injectRequirements 才注入)
133
+ { name: 'dsh-git-push-requirements', order: ORDER_REQUIREMENTS, text: () => (cfg.injectSystemPrompt && cfg.auditEnabled && cfg.injectRequirements ? buildRequirementsInjectionText() : '') },
134
+ ],
135
+ log,
136
+ });
137
+
138
+ // 2.5) 上下文注入(agent/pre-step):环境信息(工作区目录 + 工具安装路径 + skill 总入口)
139
+ // 每个 agent 首次 step 注入一次 user 消息(参考 dsh-skill-scoreboard v1.4.0 时机与形态:
140
+ // WeakSet 防重复 + createUserMessage 追加 + source 标记 plugin instructions)。
141
+ // 总开关 injectSystemPrompt 同时门控(关=完全不注入,含此通道)。
142
+ const preStepWired = registerPreStepInjection(ctx, { envInjectText, log });
143
+
144
+ // 3) HTTP API:ctx.inject(['webServer']) → register({kind:'prefix', path, handler})
145
+ const httpWired = registerHttp(ctx, {
146
+ path: '/api/git-push',
147
+ // 把宿主 jobs 传进 env(repos-local 等重端点用它做后台扫描,避免卡前台)
148
+ handler: (req, res) => adaptHttpHandler(req, res, { ...env, jobs }, cfg),
149
+ log,
150
+ });
151
+
152
+ // 4) 设置命名空间:settings.register('git-push') —— Host 必须注册命名空间,
153
+ // 配置卡(settings.plugin.item key=git-push)才会与 Host 命名空间相交显示
154
+ // (学 v1 plugin-setup.js registerSettings;补,此前配置卡空白根因)。
155
+ // 设置持久化**不写公共 settings.yaml**(跨实例写锁竞争 + client isLoopback=memory
156
+ // 陷阱,见 settings-bridge.js 头部)——插件私有 config.json 才是持久化真源。
157
+ // 启动时先 merge config.json 进运行期 cfg(注入/审计设置重启保持);
158
+ // 宿主 scope 仅用于让「设置 → 插件配置」卡与 Host 命名空间相交显示,不再承担持久化。
159
+ try {
160
+ const fileSettings = readSettings({ workspaceRoot: env.workspaceRoot }) || {};
161
+ // config.json → cfg 字段映射用共用函数(applySettingsToCfg,与 watch/HTTP
162
+ // settings-set 同一张映射表,避免三处重复漂移)
163
+ const changed = applySettingsToCfg(cfg, fileSettings);
164
+ // 配置化:注入系统提示词内容可配——config.json 的 injectUsageText(数组/字符串)覆盖默认功能用法注入文本
165
+ if (typeof fileSettings.injectUsageText === 'string' && fileSettings.injectUsageText.trim()) {
166
+ cfg.injectUsageText = fileSettings.injectUsageText;
167
+ } else if (Array.isArray(fileSettings.injectUsageText) && fileSettings.injectUsageText.length) {
168
+ cfg.injectUsageText = fileSettings.injectUsageText.join('\n');
169
+ }
170
+ if (changed.changedSystemPrompt) envInjectCache = null;
171
+ } catch (e) {
172
+ log?.warn?.(`config.json 设置回读跳过:${e?.message || e}`);
173
+ }
174
+ // 4) 设置命名空间接线(版本自适应 · 特性检测自动切换)
175
+ // ⚠️ 关键:inject 回调是「稍后异步执行」的,外层 try/catch 只包住注册调用、包不住回调体
176
+ // 内的异常(这正是此前失败被吞成一条 warn、不进启动失败列表的根因)→ 回调体自带
177
+ // try/catch 并同时 console.error,保证接线失败一定可见。
178
+ try {
179
+ ctx.inject(['settings'], (settingsCtx) => {
180
+ try {
181
+ // 【2026-10-02 · DSH 0.2.0-rc.2 适配】0.2.0 删除了 settings.register / settings.get:
182
+ // settings 服务改为 SettingsForms(describe/update/replace/mutate/configure),命名空间
183
+ // 由 Loader 条目派生(ns = 行 id,schema = 入口导出的 Config),无需命令式注册。
184
+ // 同款死法见 dsh-context-budget:TypeError: ctx.settings.register is not a function。
185
+ // 本插件设置/凭据真源是私有 config.json(settings-bridge),宿主命名空间只用于让
186
+ // 「设置 → 插件配置」卡与命名空间相交显示 → 两条分支都保留,旧宿主行为完全不变。
187
+ const settings = settingsCtx.settings;
188
+ // ── 0.2.0 分支:SettingsForms(无 register / 无 get / 无 watch)──
189
+ if (typeof settings?.register !== 'function') {
190
+ // ① 自带设置页(settings.section)→ 关闭宿主按 schema 自动生成表单(官方推荐写法)
191
+ try {
192
+ settings?.configure?.({ auto: false }, ctx.fiber);
193
+ } catch (e) {
194
+ log?.warn?.(`settings.configure 跳过:${e?.message || e}`);
195
+ }
196
+ // ② 凭据只读同步(等价旧 scope.get() 那段):0.2.0 无 get(),改从 describe() 找自己的
197
+ // 命名空间——ns 优先旧名 'git-push',兜底 0.2.0 行 id 'dsh-git-push',再兜底按值
198
+ // 特征(含 githubToken/sshPub)匹配;找不到就跳过,绝不阻断 apply。
199
+ try {
200
+ const rows = settings?.describe?.() || [];
201
+ const own = rows.find((r) => r?.ns === GIT_PUSH_SETTINGS_NS || r?.ns === 'dsh-git-push'
202
+ || (r?.value && typeof r.value === 'object' && ('githubToken' in r.value || 'sshPub' in r.value)));
203
+ const init = own?.value || {};
204
+ if (typeof init.githubToken === 'string') cfg.githubToken = init.githubToken;
205
+ if (typeof init.sshPub === 'string') cfg.sshPub = init.sshPub;
206
+ } catch (e) {
207
+ log?.warn?.(`0.2.0 命名空间凭据读取跳过:${e?.message || e}`);
208
+ }
209
+ // ③ 不做 watch:SettingsForms 无 watch;凭据落盘仍走 config.json + HTTP settings-set
210
+ return;
211
+ }
212
+ // ── 0.1.x 分支:宿主仍提供 register,走原逻辑(原代码原样保留)──
213
+ const scope = settings.register(GIT_PUSH_SETTINGS_NS, Config, { base: defaultConfig() });
214
+ // 初始同步一次(watch 不会立即回调):重启后第一次加载即拿到已保存的 token/SSH 公钥,
215
+ // 账号检查端点才能用设置页保存的凭据判断(修复误判未登录根因)
216
+ try {
217
+ const init = scope.get() || {};
218
+ if (typeof init.githubToken === 'string') cfg.githubToken = init.githubToken;
219
+ if (typeof init.sshPub === 'string') cfg.sshPub = init.sshPub;
220
+ } catch (e) {
221
+ log?.warn?.(`初始同步设置凭据跳过:${e?.message || e}`);
222
+ }
223
+ scope.watch(async (next) => {
224
+ if (!next || typeof next !== 'object') return;
225
+ // watch **只处理凭据**。开关/扫描范围/权重真源是插件私有
226
+ // config.json(启动 merge + HTTP settings-set)。yaml 缺键时 schema 默认
227
+ // injectRequirements=false,若把 yaml 整包灌进 cfg 会把 HTTP 刚写入的
228
+ // true 盖回去——开关点了不对的根因。
229
+ if (typeof next.githubToken === 'string' && next.githubToken.trim()) {
230
+ cfg.githubToken = next.githubToken.trim();
231
+ const r = persistGithubToken(next.githubToken, { workspaceRoot: env.workspaceRoot });
232
+ if (!r.ok) log?.warn?.(`dsh-git-push token 持久化失败: ${r.error || r}`);
233
+ }
234
+ if (typeof next.sshPub === 'string' && next.sshPub.trim()) {
235
+ cfg.sshPub = next.sshPub.trim();
236
+ const r = persistSshPub(next.sshPub, { workspaceRoot: env.workspaceRoot });
237
+ if (!r.ok) log?.warn?.(`dsh-git-push SSH 公钥持久化失败: ${r.error || r}`);
238
+ }
239
+ });
240
+ } catch (e) {
241
+ log?.warn?.(`settings 命名空间接线跳过:${e?.message || e}`);
242
+ console.error('[dsh-git-push] settings 接线失败:', e);
243
+ }
244
+ });
245
+ } catch (e) {
246
+ log?.warn?.(`settings 命名空间接线跳过:${e?.message || e}`);
247
+ console.error('[dsh-git-push] settings 接线失败:', e);
248
+ }
249
+
250
+ // 5) 用户输入框斜杠命令:ctx.inject(['commands']) → /git-audit(人直接跑审计,不进模型)
251
+ const slashCount = registerSlashCommands(ctx, { env, cfg, log });
252
+
253
+ // 5.5) 任务完成自动推送(内置自 dsh-task-completion):监听回合结束,
254
+ // 检测 AI 回复「✅任务完成」(UI 可自定义),autoPushEnabled 开启时自动 commit+push
255
+ // 交付物(复用 commitWithAudit 完整门禁——审计 blocker 拦截 / requirements / pushGate,
256
+ // 绝不裸提交绕过门禁)。开关/触发文本/范围经 config.json 持久化(settings-bridge 读回)。
257
+ const autoPush = registerAutoPush(ctx, {
258
+ cfg,
259
+ // 触发后记录最近一次自动推送结果(写入 config.json 供 UI/状态查询,evidence)
260
+ onPushAfterCommit: (outcome) => {
261
+ try {
262
+ writeSettingsKey('autoPushLast', outcome, { workspaceRoot: env.workspaceRoot });
263
+ } catch { /* 记录失败不影响自动推送 */ }
264
+ },
265
+ });
266
+
267
+ // 6) 客户端(设置卡片/侧边栏)不在 Host 注册:DSH 依据 package.json 的
268
+ // dsh.client + exports["./client"] 自动发现 client.js。
269
+
270
+ log?.info?.(`dsh-git-push v${VERSION} 已接线(工具 ${toolCount} 个 / 注入 ${sectionCount} 段 + ${preStepWired ? '上下文注入' : '上下文注入未接'} / HTTP ${httpWired ? '已注册' : '未注册'} / 斜杠 ${slashCount};审计默认${cfg.auditEnabled ? '开' : '关'} / 自动推送${autoPush.enabled ? '开(触发: ' + autoPush.trigger + ')' : '关'})`);
271
+ // 【修复 】cordis 的 apply 返回值只能是 disposer 函数 / Promise / undefined;
272
+ // 返回普通对象会抛 "Invalid effect" 导致插件树加载失败。插件内部注册均走 ctx.inject,
273
+ // 生命周期由 cordis 管理,因此 apply 返回 undefined(标准写法)。
274
+ return;
275
+ }