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,191 @@
1
+ /**
2
+ * 插件入口层 · 注入文本
3
+ *
4
+ * FUNCTION_USAGE_HINT(插件功能用法注入——每个工具怎么用 + 凭据由插件托管,见需求:
5
+ * 「注入系统提示词可以注入插件每个功能怎么用,发现好多不用插件还到处找凭据的」)、
6
+ * buildRequirementsInjectionText(开发者要求清单注入,挂审计开关子开关)、
7
+ * formatAuditBlock(审计结果块)、README_CHECK_HINT(提交前 README 核对提醒)。
8
+ * 这些是「写进系统提示词/工具返回」的文本,与业务逻辑分开便于单独校对措辞。
9
+ */
10
+
11
+ import { networkInterfaces } from 'node:os';
12
+ import { join } from 'node:path';
13
+ import { loadRequirements } from '../git/index.js';
14
+ import { readAccountStatus } from '../git/account-status.js';
15
+ import { identityHintText, resolveCommitIdentity } from '../git/identity.js';
16
+
17
+ /**
18
+ * 插件功能用法注入(systemPrompt 段,order 990)。
19
+ *
20
+ * 目的:把「插件有哪些功能、每个怎么用、凭据谁管」常驻系统提示词,
21
+ * 避免 AI 不知道插件能力而绕开插件、甚至满盘检索 token/密钥文件。
22
+ *
23
+ * 三段:①工具清单与用途 ②凭据由插件托管(明确「不要到处找凭据」)③调用纪律。
24
+ * 纯静态文本,无 IO,同步返回。
25
+ */
26
+ export const FUNCTION_USAGE_HINT = [
27
+ '【dsh-git-push 功能用法】本插件的 git 操作请直接调用下列工具,不要手敲 git/curl 绕过(插件自带审计门禁、凭据管理、推送通道选择);**工作区没有改动 / 没有新提交时也照常调用,不会报错**(详见 git_commit_push 说明),不要因为「怕它报错」而绕开插件:',
28
+ '· git_scan —— 列工作区(含额外路径)所有 git 仓库:分支/remote/未提交与未推送数/最近活动。找「哪个仓库要提交」先用它。',
29
+ '· git_commit_push —— 一键提交并推送(一次调用 = 审计(可关)→ **有改动才** commit → **有可推内容才** push;审计同步拦截,通过后 commit+push 走宿主官方后台 job,立即返回 async:true + jobId,结果完成会自动返回、无需特意查询,可继续干别的)。参数:repo=仓库绝对路径、message=提交信息(必填,但**零改动时不会被用到**)、audit、dryRun、push、force、ignorePatterns;调用前逐条核对开发者特殊要求,达标才传 requirementsConfirmed=true(**只要配置里存在开发者要求清单,任何调用都要带——与有没有改动、是否推送无关**)。如需主动查结果:job_output <jobId>(job_list/job_kill 同理)。',
30
+ ' **零改动 = 正常成功路径,不是失败**(可以放心调用):工作区没改动 ⇒ 返回 ok:true + committed:false(job 状态 completed,文案写明「无需提交(正常)」);远端已最新 ⇒ ok:true + pushed:false;而「本地领先远端」的已提交内容**照样会推上去**。所以任何时候都直接用它,不要因为「没东西可提交」改去手敲 git。(**唯一例外**:配置里存在开发者要求清单时,仍要按上文带上 `requirementsConfirmed:true`——那是要求门禁,与「有没有改动」无关。)',
31
+ '· code_audit —— 审计仓库(L0 静态检查 + 质量评分):语法/敏感信息/凭据/大文件/文档措辞;scope=full 全量;可传 ruleset 自定规则目录、weights 覆盖权重。',
32
+ '· git_account_check —— 校验 GitHub 账号与凭据(token 在线校验 + SSH 公钥指纹),返回登录态/用户名/公钥数/套餐。想知道「现在能不能推、以谁的身份」,用它,不要自己去翻 token 文件。',
33
+ '· git_identity_rewrite —— 提交身份历史改写:把仓库里非规范身份(工具/AI 产生的 agent@dsh.local / eightfs@local / v2-clone@local,以及账号 noreply 的旧变体)统一成登录账号规范身份。默认 dryRun 只报告;真改写要传 dryRun:false(先建备份引用,自检通过才改写),要推远端再加 push:true(force-with-lease,远端动过自动拒绝)。只处理 origin 属于登录账号的仓库。',
34
+ '· git_gen_ssh_key —— 生成 SSH 密钥对(按邮箱,写入插件配置目录;公钥整行回传,私钥不出本机)。',
35
+ '· git_remote_create —— 按项目文件夹在 GitHub 建远端仓库(已存在则复用),并把 origin 指向它。',
36
+ '· git_set_visibility —— 切换仓库 public/private。',
37
+ '· git_clone —— 从 GitHub clone 到本地(走 GitHub API,不直连 github.com)。',
38
+ ' (README 生成已抽为独立脚本:`node scripts/readme-gen.mjs <repo> [--write <path>]`,见插件 skill 文档组织节)',
39
+ '· link_check —— 检查文档内链接有效性(只报 warning,不拦截)。',
40
+ '· npm_publish —— npm 发包(**后台 job**,返回 jobId 可用 job_output 查):默认 dryRun=true 只体检 + `npm publish --dry-run`(不写 registry ✗);真发必须同时传 confirm=true 与 dryRun=false(不可撤销,先 dryRun 看包内容)。参数:dir(目标包目录,缺省工作区)/ tag(默认 latest)/ otp(2FA)/ dryRun / confirm。',
41
+ '· git_sluice —— 浅包装 git 透传工具(AI 直接调用任意 git 命令,凭据自动注入):args 传与 git 完全一致的参数串(空格分隔,路径含空格用引号);例:git_sluice({args:"status --short"}) / git_sluice({args:"log --oneline -5"}) / git_sluice({args:"branch -a"})。返回 status + stdout/stderr。git 的其余能力(log/diff/branch/tag/remote 等)用它;高频写操作仍走 git_commit_push/git_clone 等专用工具(自带审计/门禁)。',
42
+ '【凭据由插件托管,不要到处找凭据】GitHub token 与 SSH 公钥存放在插件 config.json(git-push/config.json 的 githubToken、sshPub 键,0600);SSH 私钥仍为文件(git-push/id_rsa),由插件的推送/校验流程自动读取与选择通道(默认 SSH,token 401 回退 SSH)。',
43
+ '需要判断登录态 → 调 git_account_check;需要推送 → 调 git_commit_push。不要遍历用户目录找 token、不要把凭据抄进命令行或文档、不要在回复里明文输出凭据。',
44
+ '【调用纪律】提交类操作先 git_scan 确认目标仓库;提交前核对 README(功能表/版本记录/用法);审计拦截 blocker 时先修复再提交;用户未要求推送时不要 push。',
45
+ '(这些纪律只在**会产生新提交/要推送**时才起作用;工作区没改动时直接调用 git_commit_push 也不会报错——不要因为「没东西可提交」就绕开插件手敲 git。)',
46
+ ].join('\n');
47
+
48
+ /** 提交前提醒(systemPrompt 注入段,对照旧版 dsh-git-push-readme-check)。 */
49
+ export const README_CHECK_HINT = [
50
+ '【dsh-git-push 提交前提醒】会产生新提交时,先检查该仓库 README:',
51
+ '功能表 / 版本记录 / 用法是否与本次改动一致。需要更新则先改 README 再提交。',
52
+ '不要把过时 README 推进远端。',
53
+ '(零改动调用不产生提交,自然不涉及 README 核对——不要因此不敢调用。)',
54
+ ].join('');
55
+
56
+ /**
57
+ * 构造「开发者特殊要求」注入正文(systemPrompt 段,需开启提交前审计 + 本子开关)。
58
+ *
59
+ * 价值:清单常驻系统提示词,AI 一次读到即可持续遵守,不必走「提交被门禁拦截 →
60
+ * 读拦截信息里的清单 → 带 requirementsConfirmed 重试」的失败往返(每次省一轮工具调用)。
61
+ * 清单为空/未找到时返回空串(空段不注入)。
62
+ *
63
+ * @returns {string} 注入正文;无清单时返回空串
64
+ */
65
+ /**
66
+ * 提交身份行(注入给 AI 的一段)。
67
+ *
68
+ * 【为什么注入】实测 AI 经常不知道「该用什么身份提交」,只能自己编(本机曾出现 DSH Agent /
69
+ * eightfs@local / 小写 noreply 等多种身份)。这里直接告诉它:本机提交身份是谁、哪来的、
70
+ * 未配身份的仓库由插件自动写入局部配置 —— AI 不用猜、也不要手写身份。
71
+ * @returns {string} 单行文本;账号与兜底都拿不到时返回空串
72
+ */
73
+ export function buildIdentityInjectionText() {
74
+ const st = readAccountStatus();
75
+ const account = st?.token?.valid
76
+ ? { login: st.token.login || st.username || '', id: st.token.id || '' }
77
+ : null;
78
+ const identity = resolveCommitIdentity({ account });
79
+ if (!identity || !identity.name) return '';
80
+ return `本机 git 提交身份:${identityHintText(identity)};提交前不用手写 -c user.name/email,插件会自动带上。`
81
+ + '提交返回里若出现 legacyIdentity 提醒(该仓库历史里还有非规范身份提交),顺带告知用户即可,'
82
+ + '**不要擅自改写历史**;用户要统一历史时走 git_identity_rewrite(默认 dry-run 先预览)。';
83
+ }
84
+
85
+ export function buildRequirementsInjectionText() {
86
+ const req = loadRequirements();
87
+ const identityLine = buildIdentityInjectionText();
88
+ // 没有开发者要求清单时也把身份行注入(它是「AI 别猜身份」的唯一告知途径)
89
+ if (!req.found || !req.items.length) return identityLine;
90
+ const L = [
91
+ `【dsh-git-push 开发者要求(${req.user})】调用 git_commit_push / git_remote_create 前逐条核对,全部达标才传 requirementsConfirmed: true:`,
92
+ ];
93
+ req.items.forEach((it, i) => L.push(`${i + 1}. ${it}`));
94
+ L.push('(需要**推送**且未核对时才会被门禁拦截;零改动、或 push=false 只提交时不受影响。清单可用插件配置目录的 requirements.json 外挂覆盖)');
95
+ if (identityLine) L.push(identityLine);
96
+ return L.join('\n');
97
+ }
98
+
99
+ /**
100
+ * 审计结果格式化为可直接说给用户的总结块(对齐 git_account_check 的 block 模式)。
101
+ * code_audit 返回时附带,AI 拿到后直接转述——不依赖 systemPrompt/pre-step 注入。
102
+ * @param {object} r { scope, summary, quality, repo }
103
+ * @returns {string} 多行可读文本
104
+ */
105
+
106
+ /**
107
+ * 审计输出公共函数:只输出「级别数量 + 评分 + API 查询用法」——
108
+ * 审计结果改由聚合 API 查询(/api/git-push/audit),不再内联输出审计内容。
109
+ * code_audit 工具 / git_commit_push 提交后统一调用,避免各处输出漂移。
110
+ * @param {string} repo 仓库路径
111
+ * @param {object} [opts] { scope?: 'full'|'diff', summary?, quality? }
112
+ * @returns {string} 数量 + 评分 + API 用法文本
113
+ */
114
+ // 本机局域网 IP 缓存(detectHostIp 首次探测后复用——避免每次输出都 spawn)。
115
+ // os.networkInterfaces() 取第一个非 internal 的 IPv4(真实网卡地址——VirtualDSM 如 10.10.10.x);
116
+ // 不用 hostname spawn(沙箱内不可靠会回退 localhost)。探测失败回退 localhost。
117
+ let _hostIp = '';
118
+ function detectHostIp() {
119
+ if (_hostIp) return _hostIp;
120
+ try {
121
+ for (const list of Object.values(networkInterfaces())) {
122
+ for (const ni of list || []) {
123
+ if (ni.family === 'IPv4' && !ni.internal) { _hostIp = ni.address; break; }
124
+ }
125
+ if (_hostIp) break;
126
+ }
127
+ } catch { /* 回退 localhost */ }
128
+ return _hostIp || 'localhost';
129
+ }
130
+
131
+ /**
132
+ * 审计输出公共函数:只输出「级别数量 + 评分 + API 查询用法」——
133
+ * 聚合 API 参数由插件自动填充(repo/scope 实际值 + 本机 IP 探测),直接可用无需替换。
134
+ */
135
+ export function buildAuditApiGuide(repo = '', opts = {}) {
136
+ const s = opts.summary || {};
137
+ const quality = opts.quality || {};
138
+ const scope = (opts.scope || 'full') === 'full' ? 'full' : 'diff';
139
+ // 参数自动填充:repo 实际路径(encode)、scope 实际值、groupBy 默认 rule、severity 默认全级别
140
+ const qs = `repo=${encodeURIComponent(repo || '')}&scope=${scope}&groupBy=${opts.groupBy || 'rule'}`;
141
+ const base = `http://${detectHostIp()}:30800/api/git-push/audit`;
142
+ const L = [];
143
+ L.push(`审计:${repo || ''}(${scope === 'full' ? '全量' : '变动'})`);
144
+ L.push(`评分 ${quality.score ?? '?'}/${quality.level ?? '?'} · ${s.blocker ?? 0} 拦截 / ${s.warning ?? 0} 警告 / ${s.notice ?? 0} 提示`);
145
+ L.push('审计明细请用聚合 API 查询(参数已自动填充,直接复制使用):');
146
+ L.push(` ${base}?${qs}`);
147
+ L.push(` curl -L '${base}?${qs}'`); // -L:宿主反代一次 302 中转(不带 -L 会显示 302 误判失败)
148
+ L.push(`可选参数(默认已填,按需改 URL 即可):groupBy=${opts.groupBy ? '自定义' : 'rule'}(默认)<可选 rule|file|severity|slot> · severity 过滤(如 &severity=blocker,warning)`);
149
+ // 审计后提示增加——豁免类型统计 / 聚合类型 / 拦截列表(直接可见,不用查 API)
150
+ const es = opts.exemptStats;
151
+ if (es && es.total > 0) {
152
+ const parts = Object.entries(es.types || {}).map(([t, n]) => `${t} ${n}`).join(' / ');
153
+ L.push(`豁免:${es.total} 条(${parts})`);
154
+ }
155
+ const gb = Array.isArray(opts.groupByTypes) ? opts.groupByTypes.join('|') : '';
156
+ if (gb) L.push(`聚合类型:${gb}`);
157
+ const bl = Array.isArray(opts.blocked) ? opts.blocked : [];
158
+ if (bl.length) {
159
+ L.push(`拦截:${bl.length} 个 blocker → ${bl.map((b) => `${b.file || ''}${b.line ? ':' + b.line : ''}(${b.rule || b.message})`).join(';')}`);
160
+ }
161
+ return L.join('\n');
162
+ }
163
+
164
+ export function formatAuditBlock(r = {}) {
165
+ const quality = r.quality || {};
166
+ const s = r.summary || {};
167
+ const L = [];
168
+ L.push(`【dsh-git-push 审计】${r.repo || ''}(${r.scope === 'full' ? '全量' : '变动'}扫描)`);
169
+ if (quality.emptyResult) {
170
+ L.push(`评分:未评分(${quality.emptyReason || '未扫描到任何文件'})`);
171
+ } else {
172
+ L.push(`评分 ${quality.score ?? '?'}/${quality.level ?? '?'}(满分 100)`);
173
+ }
174
+ L.push(`问题 ${s.blocker ?? 0} 拦截 / ${s.warning ?? 0} 警告 / ${s.notice ?? 0} 提示(共 ${s.total ?? 0} 条)`);
175
+ // 维度短板 TOP3(分最低的三个维度,用户最关心扣分来源)
176
+ const dims = quality.dims || {};
177
+ const weak = Object.entries(dims).sort((a, b) => a[1] - b[1]).slice(0, 3);
178
+ if (weak.length) {
179
+ const parts = weak.map(([d, v]) => `${d} ${(Number(v) || 0).toFixed(1)}`).join(' / ');
180
+ L.push(`短板维度:${parts}`);
181
+ }
182
+ // 文档加分制(0 分起、上限 10)——结构信号 + 交叉验证;不进问题计数
183
+ const ds = r.docsScore;
184
+ if (ds && Array.isArray(ds.items)) {
185
+ const total = ds.items.filter((i) => i.hit).reduce((a, i) => a + (Number(i.score) || 0), 0);
186
+ L.push(`文档加分:命中 ${ds.hits?.length ?? 0}/${ds.items.length}(+${total.toFixed(1)}/10)`);
187
+ if (Array.isArray(ds.review) && ds.review.length) L.push(`建议人工复核:${ds.review.join(';')}`);
188
+ }
189
+ if ((s.blocker || 0) > 0) L.push('存在拦截级问题,建议先修复 blocker 再提交/推送。');
190
+ return L.join('\n');
191
+ }
@@ -0,0 +1,23 @@
1
+ /**
2
+ * 插件入口层 · 默认扫描根解析
3
+ *
4
+ * 账号卡片本地扫描 / git_scan 未指定路径时的默认根,优先级:
5
+ * ① 插件配置 cfg.defaultScanRoot(设备侧边栏写入,非空即用它,无需重启)
6
+ * ② 自动识别 DSH 家根:DSH_HOME 的上一级,或 workspaceRoot/.dsh-home
7
+ * (.dsh 目录同级/上一级,覆盖 工作区/用户/profiles/workspace 下全部 git 仓库)
8
+ * 全部动态来源,无写死绝对路径。
9
+ */
10
+ import { join, dirname, isAbsolute } from 'node:path';
11
+
12
+ /** 取默认扫描根。cfg 传插件配置(含 defaultScanRoot),未传时按自动识别。 */
13
+ export function getDefaultScanRoot(env = {}, cfg = {}) {
14
+ const configured = String(cfg?.defaultScanRoot || '').trim();
15
+ if (configured) return configured; // 侧边栏配置优先
16
+ if (env.dshHomeRoot) return env.dshHomeRoot;
17
+ if (process.env.DSH_HOME) {
18
+ const p = process.env.DSH_HOME; // 形如 <workspaceRoot>/.dsh-home/.dsh
19
+ if (p && isAbsolute(p)) return dirname(p); // .dsh 上一级 = DSH 家根
20
+ }
21
+ if (env.workspaceRoot) return join(env.workspaceRoot, '.dsh-home'); // DSH 根 → DSH 家根
22
+ return '.';
23
+ }
@@ -0,0 +1,150 @@
1
+ /**
2
+ * 插件入口层 · 配置 schema
3
+ *
4
+ * Schema 来自宿主提供的 schemastery;宿主没提供时用 makeFallbackSchema 兜一个最小实现,
5
+ * 保证插件在缺依赖的环境下也能加载(Config 是暴露给宿主的配置 schema)。
6
+ * 为什么单独成模块:兜底逻辑涉及 require 宿主模块,与工具定义/HTTP 处理混在一起
7
+ * 会让「插件为什么加载不起来」变得很难查。
8
+ */
9
+
10
+ import { createRequire } from 'node:module';
11
+
12
+ /**
13
+ * schemastery 条件加载(peerDependency 由 DSH 宿主提供):
14
+ * - DSH 插件运行期:宿主 node_modules 提供 → 用真实 Schema(Standard Schema v1)
15
+ * - 源码仓本地测试 / CLI(零依赖):缺失 → 降级为最小 schema(见 makeFallbackSchema)
16
+ * 零依赖仓库设计:不把 peer 依赖装进 v2,缺失时插件入口仍可 import 不崩。
17
+ */
18
+ const require2 = createRequire(import.meta.url);
19
+
20
+ /* ───────── 配置默认值常量 ───────── */
21
+ const DEFAULT_MAX_SCAN_FILES = 3000; // 全量审计文件数上限默认值
22
+
23
+ let Schema = null;
24
+
25
+ try {
26
+ Schema = require2('@deepseek-ai/schemastery');
27
+ } catch { Schema = null; }
28
+ if (Schema && typeof Schema.object !== 'function') Schema = null; // 防加载到残缺包
29
+
30
+ /** schemastery 缺失时的最小 schema(仅保留测试用到的语义:可调用返回默认值 + toJSON 形状)。 */
31
+ function makeFallbackSchema() {
32
+ const field = (meta = {}) => {
33
+ const fn = (v) => (v === undefined ? meta.default : v);
34
+ fn.meta = meta; // 让 toJSON 能读到 description(schemastery 的 refs 走 meta.description)
35
+ fn.default = (d) => field({ ...meta, default: d });
36
+ fn.description = (d) => field({ ...meta, description: d });
37
+ // role(r):与 schemastery 同名 API。fallback 路径必须也能链式调用——
38
+ // 否则缺 schemastery 的环境里 Config 定义到 .role('secret') 就抛错,整个插件起不来。
39
+ fn.role = (r) => { meta.role = r; return fn; };
40
+ return fn;
41
+ };
42
+ const objectSchema = (shape = {}) => {
43
+ const fn = (v = {}) => {
44
+ const out = {};
45
+ for (const [k, spec] of Object.entries(shape)) {
46
+ const s = typeof spec === 'function' ? spec : field();
47
+ out[k] = s(v[k]);
48
+ }
49
+ return out;
50
+ };
51
+ fn.toJSON = () => ({
52
+ type: 'object',
53
+ refs: Object.entries(shape).map(([k, s]) => ({ key: k, meta: s?.meta || {} })),
54
+ });
55
+ // 【修复 】fallback schema 必须带 ~standard 标记,否则 DSH cordis 的
56
+ // resolveConfig 读 Config['~standard'].validate 时 undefined 崩溃
57
+ // ("Cannot read properties of undefined (reading 'validate')")。
58
+ // 真实 schemastery 加载时自带该标记;fallback 路径补上等价实现,双路都稳。
59
+ fn['~standard'] = { version: 1, vendor: 'dsh-git-push', validate: fn };
60
+ return fn;
61
+ };
62
+ return {
63
+ object: objectSchema,
64
+ string: () => field({ type: 'string', default: '' }),
65
+ boolean: () => field({ type: 'boolean', default: false }),
66
+ array: () => field({ type: 'array', default: [] }),
67
+ number: () => field({ type: 'number', default: 0 }),
68
+ dict: () => field({ type: 'dict', default: {} }),
69
+ any: () => field({ default: undefined }),
70
+ union: (...fns) => field({ default: undefined }),
71
+ };
72
+ }
73
+
74
+ // 兼容旧引用:Schema 缺失时用 fallback(Config 定义处不感知)
75
+ if (!Schema) Schema = makeFallbackSchema();
76
+
77
+ /** 插件配置 schema(Standard Schema v1,DSH cordis 校验必需;schemastery 提供 ~standard 标记)。 */
78
+ export const Config = Schema.object({
79
+ // —— v2 特有字段 ——
80
+ enabled: Schema.boolean().default(true).description('启用插件'),
81
+ workspaceRoot: Schema.string().default('').description('扫描根目录(空=DSH workspaceRoot)'),
82
+ extraRepos: Schema.array(Schema.string()).default([]).description('额外仓库路径(数组)'),
83
+ extraReposFile: Schema.string().default('').description('额外仓库清单文件(每行一个绝对路径,# 注释;运行时实时读取)'),
84
+ auditEnabled: Schema.boolean().default(false).description('提交前审计(默认关)'),
85
+ // 提交前审计的子开关:开启后在系统提示词注入「开发者特殊要求」清单全文,AI 常驻可见、
86
+ // 不必等门禁拦截才去读清单(省一次失败的工具往返)。auditEnabled 关闭时本项不生效。
87
+ maxScanFiles: Schema.number().default(DEFAULT_MAX_SCAN_FILES).description('全量审计文件数上限(0=不限);超限按变动文件优先截断,防止弱机扫大仓卡死'),
88
+ injectRequirements: Schema.boolean().default(false).description('注入开发者要求清单到系统提示词(可直接勾选;父开关「提交前审计」关闭时置灰且不注入,勾选保留;默认关)'),
89
+ auditScanScope: Schema.string().default('diff').description('diff | full'),
90
+ maxCloneFileMB: Schema.number().default(10).description('clone 单文件体积上限(MB),0=不限'),
91
+ cloneConcurrency: Schema.number().default(6).description('clone 并发下载数'),
92
+ auditRuleOrder: Schema.array(Schema.string()).default([]).description('规则槽位加载顺序(后加载覆盖先加载;空=默认偏好顺序;private 恒末尾强制)'),
93
+ auditDisabledSlots: Schema.array(Schema.string()).default([]).description('UI 禁用的规则槽位(设置页单击切换;nodejs/private 安全红线不可禁用)'),
94
+ weightOverrides: Schema.string().default('').description('权重覆盖 JSON(如 {"安全性":100},空=默认权重表)'),
95
+ linkCheckEnabled: Schema.boolean().default(false).description('链接检查(默认关,需网络)'),
96
+ pushMethod: Schema.string().default('ssh').description('推送通道:ssh(默认,推本地 HEAD、远端 sha 与本地一致)| api(Git Data API 重建提交)| auto(有私钥走 ssh,否则 api)'),
97
+ // 推送门禁(类似会话指挥家写操作拦截)——开启后 AI 推送必须带 pushConfirmed:true
98
+ // (已显式放行 pushConfirmed:true),否则 git_commit_push 拦截推送步骤(commit 可做,push 被挡)。
99
+ pushGate: Schema.boolean().default(false).description('推送门禁(默认关):开启后 push 需显式放行(带 pushConfirmed:true 才推,否则拦截)'),
100
+ // —— 任务完成自动推送(内置自 dsh-task-completion)——
101
+ // 检测 AI 回复「✅任务完成」且本开关开启 → 自动 commit+push(复用 commitWithAudit 门禁,
102
+ // 不裸提交)。默认关(保守);开关/触发文本/范围经 config.json 持久化(settings-bridge)。
103
+ autoPushEnabled: Schema.boolean().default(false).description('任务完成自动推送(默认关):开启后 AI 回复「autoPushTriggerText」触发自动 commit+push'),
104
+ autoPushTriggerText: Schema.string().default('✅任务完成').description('完成触发文本(正则,可自定义;默认「✅任务完成」;在 UI 门禁开关旁设置)'),
105
+ autoPushScope: Schema.string().default('session').description('自动推送范围:session(默认,仅会话 cwd 仓库)| all(workspace 全部有变更仓库)'),
106
+ autoPushMessage: Schema.string().default('chore(ai): 任务完成自动提交').description('自动提交 message'),
107
+ // —— v1 全量移植字段(客户端完全移植 v1,Config 补全 v1 卡片读写键)——
108
+ // role('secret'):DSH 的远端读(settings-controller 一律 redactSecrets:true)不会把该字段值
109
+ // 下发给浏览器;host 侧 scope.get/watch 仍是明文,token 功能不受影响。
110
+ githubToken: Schema.string().role('secret').description('GitHub token(ghp_/github_pat_ 开头;存插件配置目录 0600;明文不下发浏览器)'),
111
+ sshPub: Schema.string().description('SSH 公钥整行(存同级仓 *.pub)'),
112
+ npmToken: Schema.string().role('secret').description('npm token(存插件配置目录 0600;明文不下发浏览器;与 githubToken 同文件,写入走原子读改写)'),
113
+ npmRegistry: Schema.string().default('https://registry.npmjs.org/').description('npm registry 地址(默认官方源;用私有源时改这里)'),
114
+ commentWordingEnabled: Schema.boolean().default(true).description('提交信息措辞检查'),
115
+ commentWordingCustom: Schema.string().default('').description('自定义措辞规则'),
116
+ commentWordingRulesFile: Schema.string().default('').description('措辞规则文件路径'),
117
+ commentWordingRulesUrl: Schema.string().default('').description('措辞规则 URL'),
118
+ auditRuleWeights: Schema.dict(Schema.any()).default({}).description('规则权重({ blacklist: { pattern: weight } })'),
119
+ qualityWeights: Schema.dict(Schema.number()).default({}).description('质量维度权重覆盖({ 维度名: weight })'),
120
+ // 注入总开关(侧边栏可勾)。拆分两通道:
121
+ // systemPrompt 注入三段(功能用法/skill 入口/要求清单);环境信息(工作区目录 + 工具
122
+ // 安装路径)改走上下文注入(agent/pre-step 首次注入)。工具探测清单 = lib/tool-probes.json
123
+ // 模板(只 key)→ 实测 → 结果落盘运行目录 tools.json。
124
+ // 原「注入全部 skill 正文 / 注入 repo-index 全文」两开关已废弃移除(不做全量注入)。
125
+ injectSystemPrompt: Schema.boolean().default(true).description('注入总开关(默认开):插件功能用法/提醒/要求清单走系统提示词,工作区目录/工具安装路径/skill 总入口走上下文首条注入'),
126
+ customIgnorePatterns: Schema.string().default('').description('自定义 gitignore 模式(逗号/换行分隔)'),
127
+ yamlCheckMode: Schema.string().default('js-yaml').description('YAML 检查模式:js-yaml(默认)| heuristic'),
128
+ });
129
+
130
+ /**
131
+ * 远端(浏览器/HTTP)可见的配置 = 全字段去掉 schema 声明为密钥的位。
132
+ *
133
+ * 为什么需要:`/api/git-push/status` 原先直接 `config: cfg` 整包回吐,GitHub token 随响应
134
+ * 明文出门(实测一条 curl 就能取到);而浏览器并不需要明文——它只用「是否已配置」渲染标签。
135
+ * 覆盖面:本函数只管插件自己的 HTTP 出口;浏览器读设置那条路径由 schema 的 role('secret')
136
+ * 负责(DSH settings-controller 的远端读一律 redactSecrets:true)。
137
+ * @param {object} cfg host 侧真实配置(含明文)
138
+ * @returns {object} 可安全下发的配置副本(密钥位删除 + 派生布尔位)
139
+ */
140
+ export const SECRET_CONFIG_FIELDS = ['githubToken', 'npmToken'];
141
+
142
+ export function redactConfig(cfg = {}) {
143
+ const out = { ...cfg };
144
+ for (const k of SECRET_CONFIG_FIELDS) delete out[k];
145
+ // 派生布尔位:浏览器拿不到明文,但需要知道「填没填」
146
+ out.tokenConfigured = !!(cfg.githubToken && String(cfg.githubToken).trim());
147
+ out.sshConfigured = !!(cfg.sshPub && String(cfg.sshPub).trim());
148
+ out.npmConfigured = !!(cfg.npmToken && String(cfg.npmToken).trim());
149
+ return out;
150
+ }
@@ -0,0 +1,167 @@
1
+ /**
2
+ * 设置读写桥 · settings-bridge
3
+ *
4
+ * 背景(大坑,见 lib/BUGFIX-NOTES-2026-09-14.md「Bug 3」):
5
+ * DSH web GUI 的 settings 持久化由 client 侧 `ctx.remote.$host.isLoopback` 决定(ui-settings
6
+ * src/client/index.ts:58):经反代地址访问时 isLoopback=false → persistence='memory' →
7
+ * 前端 scope.set 只改页面内存、不发 wire、不写盘、重启全丢;且公共 settings.yaml 存在
8
+ * **跨实例写锁竞争**(实测 atomic-write: timed out waiting for the writer lock——多个 DSH
9
+ * 实例共享 DSH_HOME 时互抢同一把锁,任何 scope.update 都可能失败)。
10
+ *
11
+ * 结论:**不写公共 settings.yaml**——插件设置自管到插件私有目录(设置命名空间独立,避免与宿主配置互相污染)
12
+ * `$DSH_HOME/git-push/config.json`(0600,凭据 token/公钥的唯一真源;SSH 私钥 id_rsa 仍为文件,见
13
+ * lib/git/credentials.js 的 credentialsDir())。读写直接走本模块的 JSON 文件操作:
14
+ * 无宿主 scope 依赖、无锁竞争、无 isLoopback 陷阱、重启从文件读回。
15
+ *
16
+ * 用法:
17
+ * apply.js:启动时 readSettings() 合并进运行期 cfg(注入/审计设置重启保持)
18
+ * http-handlers.js:GET /api/git-push/settings-get(读)/ POST /api/git-push/settings-set(写)
19
+ */
20
+ import { join } from 'node:path';
21
+ import { existsSync, appendFileSync, mkdirSync } from 'node:fs';
22
+ import { credentialsDir } from '../git/credentials.js';
23
+ import { readJson, writeJsonAtomic, updateJsonAtomic } from '../git/atomic-json.js';
24
+
25
+ /**
26
+ * 把设置快照(config.json 读回 / HTTP settings-set 单键补丁)合并进运行期 cfg。
27
+ * 两处调用点共用同一张「键 → cfg 字段」映射表,避免映射漂移:
28
+ * - apply.js 启动:readSettings() → applySettingsToCfg(cfg, ...)
29
+ * - http-handlers settings-set:applySettingsToCfg(cfg, { [key]: value })
30
+ * scope.watch **不再**走本函数(yaml 缺键会用 schema 默认值盖掉 config.json)。
31
+ * 统一类型守卫:boolean 键只在值是 boolean 时写;数组键只在是数组时写;githubToken/sshPub
32
+ * 只接受非空字符串(去空白)。返回 { changedSystemPrompt:boolean },调用方据此清环境注入缓存。
33
+ * @param {object} cfg 运行期配置对象(原地修改)
34
+ * @param {object} patch 设置快照/补丁
35
+ * @returns {{changedSystemPrompt:boolean}}
36
+ */
37
+ // 设置键映射表(模块级常量:与每次调用无关,放外面避免重复构造,也让 applySettingsToCfg 更短)
38
+ // 语义:类型收窄 / 枚举白名单 / 数字钳制,与 SETTINGS_SCHEMA 声明同步。
39
+ const BOOL_KEYS = ['injectSystemPrompt', 'auditEnabled', 'injectRequirements', 'pushGate', 'autoPushEnabled'];
40
+ const ENUM_KEYS = { auditScanScope: ['diff', 'full'], pushMethod: ['ssh', 'api', 'auto'], autoPushScope: ['session', 'all'] };
41
+ const STR_KEYS = ['weightOverrides', 'autoPushTriggerText', 'autoPushMessage', 'npmRegistry'];
42
+ const STR_TRIM_KEYS = ['githubToken', 'sshPub', 'npmToken'];
43
+ const ARR_KEYS = ['auditRuleOrder', 'auditDisabledSlots'];
44
+ const NUM_KEYS = ['maxScanFiles'];
45
+ // 数值钳制:min/max 边界,floor 先取整(clone 并发数不高于 16)
46
+ const CLAMP_KEYS = {
47
+ maxCloneFileMB: { min: 0 },
48
+ cloneConcurrency: { min: 1, max: 16, floor: true },
49
+ };
50
+
51
+ /**
52
+ * 按类型把 patch 里的键写进 cfg(布尔 / 枚举 / 字符串 / 去空白字符串 / 数组 / 有限数字)。
53
+ *
54
+ * 为什么单独成函数:原 applySettingsToCfg 把这六类循环与下面的钳制循环全放在一起,
55
+ * 圈复杂度 26(阈值 10,自审 max-cyclomatic-complexity 高风险)。
56
+ */
57
+ function applyTypedKeys(cfg, patch) {
58
+ for (const k of BOOL_KEYS) if (typeof patch[k] === 'boolean') cfg[k] = patch[k];
59
+ for (const [k, allowed] of Object.entries(ENUM_KEYS)) {
60
+ if (typeof patch[k] === 'string' && allowed.includes(patch[k])) cfg[k] = patch[k];
61
+ }
62
+ for (const k of STR_KEYS) if (typeof patch[k] === 'string') cfg[k] = patch[k];
63
+ for (const k of STR_TRIM_KEYS) if (typeof patch[k] === 'string' && patch[k].trim()) cfg[k] = patch[k].trim();
64
+ for (const k of ARR_KEYS) if (Array.isArray(patch[k])) cfg[k] = patch[k];
65
+ for (const k of NUM_KEYS) if (typeof patch[k] === 'number' && Number.isFinite(patch[k])) cfg[k] = patch[k];
66
+ }
67
+
68
+ /** 数值键钳制:非有限数字跳过;floor 先取整,再按 min/max 收敛。 */
69
+ function applyClampedNumbers(cfg, patch) {
70
+ for (const [k, c] of Object.entries(CLAMP_KEYS)) {
71
+ if (typeof patch[k] !== 'number' || !Number.isFinite(patch[k])) continue;
72
+ let v = c.floor ? Math.floor(patch[k]) : patch[k];
73
+ if (c.min != null) v = Math.max(c.min, v);
74
+ if (c.max != null) v = Math.min(c.max, v);
75
+ cfg[k] = v;
76
+ }
77
+ }
78
+
79
+ export function applySettingsToCfg(cfg, patch) {
80
+ const out = { changedSystemPrompt: false };
81
+ if (!cfg || !patch || typeof patch !== 'object') return out;
82
+ applyTypedKeys(cfg, patch);
83
+ applyClampedNumbers(cfg, patch);
84
+ if (typeof patch.injectSystemPrompt === 'boolean') out.changedSystemPrompt = patch.injectSystemPrompt;
85
+ return out;
86
+ }
87
+
88
+ /** 测试注入点:覆盖 config.json 路径(单测指向临时目录,避免污染真实配置)。 */
89
+ let settingsFileOverride = null;
90
+ export function setSettingsFileOverride(path) {
91
+ settingsFileOverride = path;
92
+ }
93
+
94
+ /** 插件的设置文件路径(默认 $DSH_HOME/git-push/config.json)。 */
95
+ export function settingsFilePath({ workspaceRoot = '' } = {}) {
96
+ if (settingsFileOverride) return settingsFileOverride;
97
+ return join(credentialsDir({ workspaceRoot }), 'config.json');
98
+ }
99
+
100
+ /**
101
+ * UI 提交日志文件(与 config.json 同级,0600,重启可见)。
102
+ * 用途:设置侧边栏每次写设置都追加一行——验证「UI 提交确实发生且落盘」,
103
+ * 与 config.json 内容互为证据(用户安装重启后拷问「提交为什么丢」时先看这里)。
104
+ * @param {{workspaceRoot?:string}} [env]
105
+ */
106
+ export function settingsLogFilePath({ workspaceRoot = '' } = {}) {
107
+ const base = settingsFileOverride || join(credentialsDir({ workspaceRoot }), 'config.json');
108
+ return join(base, '..', 'settings-ui.log');
109
+ }
110
+
111
+ /**
112
+ * 追加一条 UI 设置提交日志(凭据值打码,不写明文;失败静默不影响写盘)。
113
+ * @param {{key:string, value:unknown, via?:string, ok?:boolean, error?:string}} entry
114
+ * @param {{workspaceRoot?:string}} [env]
115
+ */
116
+ export function appendSettingsLog(entry, env = {}) {
117
+ try {
118
+ const file = settingsLogFilePath(env);
119
+ mkdirSync(join(file, '..'), { recursive: true, mode: 0o700 });
120
+ const sensitive = new Set(['githubToken', 'sshPub', 'npmToken']);
121
+ let logValue = entry.value;
122
+ if (sensitive.has(entry.key)) {
123
+ logValue = typeof entry.value === 'string' && entry.value.trim()
124
+ ? `(已配置 ${String(entry.value).length} 字符,内容打码)`
125
+ : '(空)';
126
+ }
127
+ const line = JSON.stringify({
128
+ ts: new Date().toISOString(),
129
+ key: entry.key,
130
+ value: logValue,
131
+ via: entry.via || 'http',
132
+ ok: entry.ok !== false,
133
+ ...(entry.error ? { error: entry.error } : {}),
134
+ });
135
+ appendFileSync(file, line + '\n', { mode: 0o600 });
136
+ return true;
137
+ } catch {
138
+ return false; // 日志失败绝不阻断设置写入
139
+ }
140
+ }
141
+
142
+ /**
143
+ * 读当前设置快照(config.json;文件不存在/坏 JSON 返回 null,不抛)。
144
+ * @param {{workspaceRoot?:string}} [env]
145
+ * @returns {object|null}
146
+ */
147
+ export function readSettings(env = {}) {
148
+ return readJson(settingsFilePath(env));
149
+ }
150
+
151
+ /**
152
+ * 写单个设置键(config.json 原子写回;与 client persistence / 宿主锁无关)。
153
+ * @param {string} key 设置键(非空字符串)
154
+ * @param {unknown} jsonValue 设置值(json 值)
155
+ * @param {{workspaceRoot?:string}} [env]
156
+ * @returns {{ok:boolean, code?:string, error?:string}}
157
+ */
158
+ export async function writeSettingsKey(key, jsonValue, env = {}) {
159
+ try {
160
+ if (typeof key !== 'string' || !key.trim()) return { ok: false, code: 'BAD_KEY', error: '设置键无效' };
161
+ const file = settingsFilePath(env);
162
+ const updated = updateJsonAtomic(file, (cur) => ({ ...cur, [key.trim()]: jsonValue }));
163
+ return updated.ok ? { ok: true, file: updated.file } : { ok: false, code: 'WRITE_FAIL', error: `配置写入失败: ${updated.error || '未知'}` };
164
+ } catch (e) {
165
+ return { ok: false, code: 'WRITE_FAIL', error: `配置写入失败: ${e?.message || e}` };
166
+ }
167
+ }