dsh-git-push 2.18.2 → 2.20.17

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 (90) hide show
  1. package/.gitignore +4 -0
  2. package/README.md +12 -5
  3. package/cli-audit.mjs +141 -0
  4. package/cli-tool.mjs +86 -0
  5. package/cli.mjs +116 -324
  6. package/lib/ARCHITECTURE.md +3 -0
  7. package/lib/app/audit-api.js +1 -1
  8. package/lib/app/command-registry.js +16 -3
  9. package/lib/app/constants.js +9 -0
  10. package/lib/app/handlers/clone.js +12 -3
  11. package/lib/app/handlers/http-constants.js +11 -2
  12. package/lib/app/handlers/npm.js +4 -2
  13. package/lib/app/handlers/repos.js +10 -1
  14. package/lib/app/handlers/settings.js +9 -1
  15. package/lib/app/http-handlers.js +24 -3
  16. package/lib/app/inject-text.js +1 -0
  17. package/lib/app/schema-audit.js +42 -0
  18. package/lib/app/schema.js +19 -19
  19. package/lib/app/scope-check.js +69 -0
  20. package/lib/app/settings-bridge.js +51 -0
  21. package/lib/app/tool-call.js +56 -7
  22. package/lib/ast/credential.js +130 -14
  23. package/lib/ast/dataflow.js +127 -10
  24. package/lib/ast/index.js +2 -0
  25. package/lib/ast/naming.js +9 -1
  26. package/lib/ast/scope-collisions.js +228 -0
  27. package/lib/ast/treesitter.js +142 -1
  28. package/lib/audit/history.js +1 -1
  29. package/lib/audit/orchestrate.js +93 -6
  30. package/lib/audit/scope-policy.js +110 -0
  31. package/lib/audit-rules/audit-rules-dsh.yml +16 -1
  32. package/lib/audit-rules/audit-rules-nodejs.yml +21 -6
  33. package/lib/audit-rules/audit-rules-paths.yml +7 -1
  34. package/lib/audit-ui-sdk/contract.js +117 -0
  35. package/lib/audit-ui-sdk/index.js +17 -0
  36. package/lib/checks/common.js +4 -4
  37. package/lib/checks/dispatch.js +5 -0
  38. package/lib/checks/index.js +2 -0
  39. package/lib/checks/regex.js +8 -3
  40. package/lib/checks/scope-collision.js +68 -0
  41. package/lib/cli/commands-audit.mjs +13 -18
  42. package/lib/cli/commands-tool.mjs +93 -0
  43. package/lib/cli/commands-vcs.mjs +2 -1
  44. package/lib/cli/shared.mjs +448 -0
  45. package/lib/client-parts/{account.js → git/account.js} +1 -1
  46. package/lib/client-parts/{actions.js → git/actions.js} +26 -11
  47. package/lib/client-parts/{apply.js → git/apply.js} +1 -1
  48. package/lib/client-parts/{browser.js → git/browser.js} +1 -1
  49. package/lib/client-parts/{const.js → git/const.js} +6 -1
  50. package/lib/client-parts/{controller.js → git/controller.js} +23 -11
  51. package/lib/client-parts/{icons.js → git/icons.js} +1 -1
  52. package/lib/client-parts/{loader.js → git/loader.js} +1 -1
  53. package/lib/client-parts/{npm.js → git/npm.js} +1 -1
  54. package/lib/client-parts/{page.js → git/page.js} +11 -21
  55. package/lib/client-parts/{repo.js → git/repo.js} +1 -1
  56. package/lib/client-parts/{settings.js → git/settings.js} +1 -1
  57. package/lib/client-parts/{utils.js → git/utils.js} +1 -1
  58. package/lib/client.js +75 -354
  59. package/lib/commit-push/pre-commit-engine.js +388 -0
  60. package/lib/commit-push.js +44 -17
  61. package/lib/exempt/index.js +5 -2
  62. package/lib/git/ignore.js +6 -4
  63. package/lib/git/init-compat.js +83 -4
  64. package/lib/git/push.js +25 -2
  65. package/lib/git/sensitive.js +30 -1
  66. package/lib/git/transport.js +31 -10
  67. package/lib/http/index.js +82 -10
  68. package/lib/lint-adapter/detect.js +161 -0
  69. package/lib/lint-adapter/index.js +50 -0
  70. package/lib/lint-adapter/runner.js +133 -0
  71. package/lib/npm/npmrc.js +22 -5
  72. package/lib/rule/compilers/structure.js +24 -0
  73. package/lib/score/index.js +36 -4
  74. package/lib/self/index.js +1 -1
  75. package/package.json +25 -2
  76. package/scripts/audit-gate.mjs +235 -0
  77. package/scripts/build-client.mjs +15 -8
  78. package/scripts/bump-version.mjs +20 -5
  79. package/scripts/check-js-scope.mjs +87 -0
  80. package/scripts/check.mjs +51 -4
  81. package/scripts/scan-file-io.mjs +5 -1
  82. package/scripts/scan-version.mjs +10 -7
  83. package/skills/dev/dsh-git-push.md +70 -2
  84. package/skills/guide/guide-audit.md +11 -11
  85. package/skills/guide/guide-cli-scripts.md +3 -3
  86. package/skills/guide/guide-commit-push.md +2 -2
  87. package/skills/guide/guide-inject-ui.md +0 -16
  88. package/assets/start.sh +0 -396
  89. package/scripts/scan-hardcoded-paths.mjs +0 -125
  90. /package/lib/client-parts/{audit.js → audit/audit.js} +0 -0
@@ -22,8 +22,9 @@
22
22
  * 因此降级路径 = 手写 `.git/{HEAD,config}` + 空 `objects/refs/info` 目录,绕开 git 的
23
23
  * config 写入流程;config 里预先写死 `filemode = false`。
24
24
  */
25
- import { existsSync, mkdirSync, writeFileSync, chmodSync, rmSync, realpathSync } from 'node:fs';
26
- import { join } from 'node:path';
25
+ import { existsSync, mkdirSync, writeFileSync, readFileSync, chmodSync, rmSync, realpathSync } from 'node:fs';
26
+ import { join, resolve } from 'node:path';
27
+ import { statSync } from 'node:fs';
27
28
  import { runGit } from './exec.js';
28
29
 
29
30
  /**
@@ -79,9 +80,53 @@ export function writeMinimalGitDir(dir, { branch = 'master', remoteName = 'origi
79
80
  if (remoteUrl) {
80
81
  lines.push(`[remote "${remoteName}"]`, `\turl = ${remoteUrl}`, `\tfetch = +refs/heads/*:refs/remotes/${remoteName}/*`);
81
82
  }
83
+ // 注意:**不要**在这里写仓库级 [safe] directory —— 实测(git 2.55)所有权检查发生在
84
+ // 读取该仓库 config **之前**,被检查的目录无法自证可信,写了也不生效。
85
+ // 对外可用由 registerTrustedRepo() 走 global 配置解决,见该函数说明。
82
86
  writeFileSync(join(g, 'config'), lines.join('\n') + '\n');
83
87
  }
84
88
 
89
+ /**
90
+ * 把仓库登记进**用户 global** 的 safe.directory,使这个目录对裸 git(用户/外部工具/CI)也可用。
91
+ *
92
+ * 为什么必须走 global 而不是仓库 config(三条实测事实,git 2.55.0):
93
+ * ① 仓库级 `[safe] directory` **不生效**——所有权检查发生在读取该仓库 config 之前,
94
+ * 被检查目录无法自证可信(实测:仓库 config 含该段,裸 git status 仍 fatal)。
95
+ * ② `-c safe.directory=<绝对路径>` 生效;global 写同一条同样生效(实测通过)。
96
+ * ③ 需要它的场景真实存在:CIFS/SMB 挂载带 forceuid 时目录属主被映射成挂载用户
97
+ * (本机 `杜渊`(1026))而进程 uid 是套件用户(284371),于是 git 对**任何**命令报
98
+ * `detected dubious ownership`。插件内部走 runGit(GIT_GLOBAL_ARGS 已带 safe.directory=*)
99
+ * 感觉不到,但建完仓交出去,用户一敲 git 就挂 ——「建仓成功、仓库不可用」是历史事故同型。
100
+ *
101
+ * 只登记**这一个具体路径**(不是 `*`):范围最小,不改用户对所有仓库的信任策略。
102
+ * 幂等:已在列表里就不重复追加。同 uid 的本地盘不需要登记,跳过以免污染用户配置。
103
+ * @param {string} dir 仓库目录(会归一成绝对路径)
104
+ * @param {(args: string[], opts: object) => {ok:boolean, stdout?:string, stderr?:string}} [exec] 注入点(测试用)
105
+ * @returns {{registered: boolean, needed: boolean, skipped?: string, stderr?: string}}
106
+ */
107
+ export function registerTrustedRepo(dir, exec) {
108
+ const run = typeof exec === 'function' ? exec : (args, opts) => runGit(args, opts);
109
+ // 无 getuid 的平台(Windows)git 不做所有权检查,直接跳过
110
+ if (typeof process.getuid !== 'function') {
111
+ return { registered: false, needed: false, skipped: '该平台无 uid 概念,git 不做所有权检查' };
112
+ }
113
+ const abs = resolve(String(dir || ''));
114
+ if (!abs) return { registered: false, needed: false, skipped: '空路径' };
115
+ let ownerUid = null;
116
+ try { ownerUid = statSync(abs).uid; } catch { /* 拿不到属主时保守当作需要登记 */ }
117
+ if (ownerUid !== null && ownerUid === process.getuid()) {
118
+ return { registered: false, needed: false, skipped: '属主与当前进程一致,git 不会判 dubious' };
119
+ }
120
+ // safe.directory 是可重复键:读现有列表判幂等,避免每次建仓堆一条
121
+ const cur = run(['config', '--global', '--get-all', 'safe.directory'], {});
122
+ const list = String(cur && cur.stdout || '').split('\n').map((x) => x.trim()).filter(Boolean);
123
+ if (list.includes(abs)) return { registered: false, needed: true, skipped: '已登记' };
124
+ const r = run(['config', '--global', '--add', 'safe.directory', abs], {});
125
+ return r && r.ok
126
+ ? { registered: true, needed: true }
127
+ : { registered: false, needed: true, stderr: (r && r.stderr) || '写 global safe.directory 失败' };
128
+ }
129
+
85
130
  /**
86
131
  * 初始化 git 仓库(自动适配不支持 chmod 的文件系统)。
87
132
  *
@@ -112,6 +157,32 @@ export function initRepoCompat(dir, { branch = 'master', remoteUrl = '', chmodOk
112
157
  }
113
158
  }
114
159
 
160
+ /**
161
+ * 撤销 registerTrustedRepo 的登记(删除 global 里**该具体路径**那一条,不动其它条目)。
162
+ *
163
+ * 为什么成对提供:registerTrustedRepo 写的是用户 global 配置,仓库被删/迁移后条目会变死路径。
164
+ * 不自动清理别人的条目(用户可能有意保留暂时未挂载的路径),只把「谁登记谁注销」的能力交出去——
165
+ * 测试用它做到零污染(不留死条目在真实配置里),运维也可用它收拾残留。
166
+ * @param {string} dir 之前登记过的目录
167
+ * @returns {{removed: boolean, stderr?: string}}
168
+ */
169
+ export function unregisterTrustedRepo(dir, exec) {
170
+ const run = typeof exec === 'function' ? exec : (args, opts) => runGit(args, opts);
171
+ const abs = resolve(String(dir || ''));
172
+ if (!abs) return { removed: false, stderr: '空路径' };
173
+ // git config --unset-all 的 value 参数按**正则**匹配:路径里的 . \ 等须转义,否则会过宽命中他项
174
+ const pattern = abs.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
175
+ const r = run(['config', '--global', '--unset-all', 'safe.directory', pattern], {});
176
+ // 键不存在/无匹配时 git 返回非 0:语义上是「本来就没登记」,视为成功
177
+ if (!r?.ok && !/invalid section|key does not match|no section/i.test(String(r?.stderr || ''))) {
178
+ const cur = run(['config', '--global', '--get-all', 'safe.directory'], {});
179
+ if (String(cur?.stdout || '').split('\n').map((x) => x.trim()).includes(abs)) {
180
+ return { removed: false, stderr: r?.stderr || '注销失败' };
181
+ }
182
+ }
183
+ return { removed: true };
184
+ }
185
+
115
186
  /**
116
187
  * 现有 .git 是否**真的可用**(不是"目录存在"就算)。
117
188
  *
@@ -149,11 +220,19 @@ export function isUsableRepo(dir) {
149
220
  */
150
221
  export function ensureUsableLocalRepo(dir, { branch = 'master', remoteUrl = '', remoteName = 'origin', chmodOk, gitInit } = {}) {
151
222
  const exec = typeof gitInit === 'function' ? gitInit : (args, opts) => runGit(args, opts);
152
- if (isUsableRepo(dir)) return { ok: true, action: 'keep', via: 'existing', filemode: null };
223
+ if (isUsableRepo(dir)) {
224
+ // keep:不动用户既有仓库结构,但「对外可用」该登记还得登记——
225
+ // 历史建仓与标准 git init 都没写过 global safe.directory,CIFS 卷上外部 git 一直不可用。
226
+ const trusted = registerTrustedRepo(dir, exec);
227
+ return { ok: true, action: 'keep', via: 'existing', filemode: null, trusted };
228
+ }
153
229
  const hadPartial = hasGitDir(dir);
154
230
  const r = initRepoCompat(dir, { branch, remoteUrl, remoteName, chmodOk, gitInit: exec });
155
231
  if (!r.ok) return { ok: false, action: 'failed', via: r.via, filemode: r.filemode, stderr: r.stderr };
156
- return { ok: true, action: hadPartial ? 'repair' : 'create', via: r.via, filemode: r.filemode };
232
+ // 两条 init 路径(标准 git init / 手写降级)都不保证外部裸 git 可用:
233
+ // CIFS forceuid 卷上属主 uid 与进程 uid 不一致,需登记 global safe.directory 才交得出可用仓库。
234
+ const trusted = registerTrustedRepo(dir, exec);
235
+ return { ok: true, action: hadPartial ? 'repair' : 'create', via: r.via, filemode: r.filemode, trusted };
157
236
  }
158
237
 
159
238
  /** .git 目录是否已存在(续跑判断:已 init 过就不再重复写)。 */
package/lib/git/push.js CHANGED
@@ -62,6 +62,9 @@ export async function commitAndPush({
62
62
  pushGate = false, pushConfirmed = false, paths = '', remote = '',
63
63
  // 推送后是否等 CI 结果(默认不等:多数推送不需要阻塞);ciTimeoutSec 为等待上限
64
64
  waitCi = false, ciTimeoutSec = 900,
65
+ // 敏感文件扫描是否执行:**与审计同一开关**(audit 关 ⇒ 不扫),不再享有「强制全仓」特权。
66
+ // 缺省 true 仅为兼容直接调用方(CLI/测试);工具路径由 tool-call 按 cfg.auditEnabled 显式传入。
67
+ scanSensitive = true,
65
68
  } = {}) {
66
69
  const steps = [];
67
70
  if (!repoPath || !existsSync(join(repoPath, '.git'))) return { ok: false, steps: ['预检'], error: `非 git 仓库: ${repoPath || '(空)'}` };
@@ -140,9 +143,29 @@ export async function commitAndPush({
140
143
  const vis = await resolveRepoVisibility(repoPath, token);
141
144
  const privateExempt = vis.visibility === 'private';
142
145
  const visReason = privateExempt ? `private(${vis.owner}/${vis.repo})` : '';
146
+ // ★ 敏感扫描的**作用面**:只扫「本次将提交的文件」,不递归全仓。
147
+ // 为什么(2026-11-06 实测,另一个会话在 CIFS 仓库上复现):scanSensitiveFiles 原实现递归
148
+ // 读全仓每个文件的内容;在 CIFS/SMB 上每文件一次网络往返 ≈ 1 秒 ⇒ 724 文件的仓库 =
149
+ // 分钟级(实测单文件改动卡满 15 分钟仍未返回,而同仓 0 改动秒回——因为零改动会整段跳过)。
150
+ // 且与「改动文件数」无关(扫的是全仓),这正对应用户观察到的「单文件也一样慢」。
151
+ // 提交只关心将要入库的内容 ⇒ 扫变更集即可,语义更准、代价骤降。
152
+ // 变更集来源:paths 精确模式用 pathList;否则解析 preStatus(git status --porcelain)。
153
+ const changedForScan = pathList.length
154
+ ? pathList
155
+ : String(preStatus.stdout || '')
156
+ .split('\n')
157
+ .map((l) => l.replace(/\r$/, ''))
158
+ .filter(Boolean)
159
+ .map((line) => {
160
+ const body = line.slice(2).trim(); // 去掉 XY 状态位
161
+ const arrow = body.indexOf(' -> '); // 重命名取新名
162
+ return (arrow >= 0 ? body.slice(arrow + 4) : body).replace(/^"|"$/g, '');
163
+ })
164
+ .filter((rel) => rel && !rel.endsWith('/'));
165
+ // 敏感扫描与审计同地位:审计关闭时不扫(此前无论 audit 开关都会全仓扫,等于特权步骤)。
143
166
  const gi = privateExempt
144
- ? { added: 0, files: (await scanSensitiveFiles(repoPath)).map((h) => h.path), baseline: 0, custom: 0, tracked: [], unstaged: [], skipped: 'private-repo-exempt' }
145
- : await ensureGitignore(repoPath, { customIgnorePatterns });
167
+ ? { added: 0, files: scanSensitive ? (await scanSensitiveFiles(repoPath, { onlyPaths: changedForScan })).map((h) => h.path) : [], baseline: 0, custom: 0, tracked: [], unstaged: [], skipped: 'private-repo-exempt' }
168
+ : await ensureGitignore(repoPath, { customIgnorePatterns, onlyPaths: changedForScan, scanSensitive });
146
169
  // 敏感文件只报告不动作(既定行为:扫描到不改动 git 忽略,由仓库方自行处理)
147
170
  if (gi.files.length) steps.push(`sensitive-scan(${gi.files.length}文件, 只报告)`);
148
171
  else if (gi?.added > 0) steps.push(`.gitignore(+${gi.added}条)`);
@@ -109,7 +109,36 @@ async function scanOneSensitiveFile(dir, it, relPath) {
109
109
  return fields.length ? { path: relPath, fields } : null;
110
110
  }
111
111
 
112
- export async function scanSensitiveFiles(repoPath) {
112
+ /**
113
+ * 扫描敏感文件。
114
+ * @param {string} repoPath 仓库根
115
+ * @param {{onlyPaths?: string[]|null}} [opts]
116
+ * onlyPaths:**只扫这些相对路径**(提交路径用)。给了就不递归全仓——
117
+ * 提交时关心的只是"将要入库的内容",把全仓 700+ 文件逐个 readFile 在 CIFS/SMB 上
118
+ * 是分钟级开销(实测:单文件改动 commit 卡 2 分 41 秒,而 0 改动秒回 ——
119
+ * 因为零改动会整段跳过本函数,有改动则必然全仓扫一遍)。
120
+ * 缺省(不传/空)= 原行为:递归全仓。
121
+ */
122
+ export async function scanSensitiveFiles(repoPath, { onlyPaths = null } = {}) {
123
+ if (Array.isArray(onlyPaths)) {
124
+ const hits = [];
125
+ for (const rel0 of onlyPaths) {
126
+ const rel = String(rel0 || '').replace(/\\/g, '/').replace(/^\.\//, '').trim();
127
+ if (!rel || rel.endsWith('/')) continue; // 目录项跳过
128
+ const abs = join(repoPath, rel);
129
+ try {
130
+ const st = await stat(abs);
131
+ if (!st.isFile()) continue;
132
+ } catch { continue; } // 已删除/不可读:跳过
133
+ const slash = rel.lastIndexOf('/');
134
+ const dir = slash >= 0 ? join(repoPath, rel.slice(0, slash)) : repoPath;
135
+ const name = slash >= 0 ? rel.slice(slash + 1) : rel;
136
+ // scanOneSensitiveFile 只看 it.name + dir 拼路径,这里给一个最小 Dirent 形状
137
+ const hit = await scanOneSensitiveFile(dir, { name }, rel);
138
+ if (hit) hits.push(hit);
139
+ }
140
+ return hits;
141
+ }
113
142
  const hits = [];
114
143
  // 递归扫描:改异步以免在大仓库上逐文件阻塞事件循环
115
144
  // (readdir 带 withFileTypes,目录项类型一次带回;内容读取与 stat 同样异步化)
@@ -466,33 +466,54 @@ async function uploadBlobsAndBuildTree({ repoPath, entries, remoteBlobShas, api
466
466
  * (ControlMaster)把 N 仓总耗时压到接近单仓。
467
467
  * @returns {Promise<{ok:boolean, sha:string, via?:string}>}
468
468
  */
469
- export async function liveRemoteHeadAsync({ repoPath = '', branch = '', remote = '' } = {}) {
469
+ export async function liveRemoteHeadAsync({ repoPath = '', branch = '', remote = '', budgetMs = 0 } = {}) {
470
470
  if (process.env.DSH_GIT_PUSH_OFFLINE === '1') return { ok: false, sha: '', via: 'offline' };
471
+ // 预算传播(2026-11-13):调用方给的**总预算**要逐级摊到每一步 git 调用上。
472
+ // 为什么必须这么做:本地列表的「整表预算」只在**每次探测前**检查一次,
473
+ // 单次探测内部若有一句不带超时的 git 调用(`remote get-url` / `branch --show-current`
474
+ // 在冷启动首次 SSH 建连、CIFS 大目录 stat 时可能挂很久),整个请求就会穿透预算
475
+ // —— 实测症状:DSH 启动后第一次打开「本地」页报 `读取失败: signal timed out`
476
+ // (前端 fetch 30s 超时先炸,而服务端 15s 预算形同虚设)。
477
+ // 做法:每一步的 timeoutMs = min(单步语义上限, 剩余预算),总时长因此被预算界定;
478
+ // 这不是「超时兜底」,是给外部 I/O 定可界定的语义上限(对端不可控)。
479
+ const startedAt = Date.now();
480
+ const budgetDeadline = budgetMs > 0 ? startedAt + budgetMs : Infinity;
481
+ // 每一步的可用时长:剩余预算与单步上限取小;预算耗尽返回 1ms(让调用立刻失败而不是继续等)
482
+ const stepTimeout = (capMs) => {
483
+ const remain = budgetDeadline - Date.now();
484
+ if (!Number.isFinite(remain)) return capMs;
485
+ if (remain <= 0) return 1;
486
+ return Math.max(1, Math.min(capMs, remain));
487
+ };
488
+ const META_STEP_TIMEOUT = 3_000; // 读 remote / 当前分支:本地读 config,3s 足够
489
+ const LS_TIMEOUT = 8_000; // 单次 ls-remote(含 SSH 建连)
471
490
  // 指定 remote 时核验它(与推送同源);否则沿用 origin
472
491
  const origin = remote
473
- ? (await runGitAsync(['remote', 'get-url', remote], { cwd: repoPath })).stdout
474
- : (await runGitAsync(['remote', 'get-url', 'origin'], { cwd: repoPath })).stdout;
492
+ ? (await runGitAsync(['remote', 'get-url', remote], { cwd: repoPath, timeoutMs: stepTimeout(META_STEP_TIMEOUT) })).stdout
493
+ : (await runGitAsync(['remote', 'get-url', 'origin'], { cwd: repoPath, timeoutMs: stepTimeout(META_STEP_TIMEOUT) })).stdout;
475
494
  const pr = parseGithubOwnerRepo(origin);
476
- const target = branch || (await runGitAsync(['branch', '--show-current'], { cwd: repoPath })).stdout;
495
+ const target = branch || (await runGitAsync(['branch', '--show-current'], { cwd: repoPath, timeoutMs: stepTimeout(META_STEP_TIMEOUT) })).stdout;
477
496
  if (!pr || !target) return { ok: false, sha: '' };
478
497
  const sshUrl = sshUrlOf(pr);
479
498
  const known = knownHostsPath();
480
- const LS_TIMEOUT = 8_000;
481
499
  let tried = 0;
482
500
  for (const { keyPath, kind } of resolveSshKeys()) {
483
501
  if (tried >= 2) break; // 最多试 2 个 key,避免多 key 串行放大耗时
502
+ if (budgetDeadline - Date.now() <= 0) break; // 预算耗尽就别再启新的 SSH 尝试
484
503
  tried += 1;
485
504
  const sshCmd = buildLsRemoteSshCmd(keyPath, known);
486
- const r = await runGitAsync(['ls-remote', sshUrl, `${REFS_HEADS_PREFIX}${target}`], { cwd: repoPath, env: { GIT_SSH_COMMAND: sshCmd }, timeoutMs: LS_TIMEOUT });
505
+ const r = await runGitAsync(['ls-remote', sshUrl, `${REFS_HEADS_PREFIX}${target}`], { cwd: repoPath, env: { GIT_SSH_COMMAND: sshCmd }, timeoutMs: stepTimeout(LS_TIMEOUT) });
487
506
  if (r.ok) {
488
507
  const sha = (r.stdout || '').trim().split(/\s+/)[0] || '';
489
508
  if (sha) return { ok: true, sha, via: kind };
490
509
  }
491
510
  }
492
- const lr = await runGitAsync(['ls-remote', rr.remote || 'origin', `${REFS_HEADS_PREFIX}${target}`], { cwd: repoPath, timeoutMs: LS_TIMEOUT });
493
- if (lr.ok) {
494
- const sha = (lr.stdout || '').trim().split(/\s+/)[0] || '';
495
- if (sha) return { ok: true, sha, via: 'origin' };
511
+ if (budgetDeadline - Date.now() > 0) {
512
+ const lr = await runGitAsync(['ls-remote', rr.remote || 'origin', `${REFS_HEADS_PREFIX}${target}`], { cwd: repoPath, timeoutMs: stepTimeout(LS_TIMEOUT) });
513
+ if (lr.ok) {
514
+ const sha = (lr.stdout || '').trim().split(/\s+/)[0] || '';
515
+ if (sha) return { ok: true, sha, via: 'origin' };
516
+ }
496
517
  }
497
518
  return { ok: false, sha: '' };
498
519
  }
package/lib/http/index.js CHANGED
@@ -19,6 +19,55 @@ export const READ_METHODS = new Set(['GET', 'HEAD', 'OPTIONS']);
19
19
 
20
20
  export const ALLOWED_ORIGINS = new Set(['http://127.0.0.1', 'http://localhost', 'http://[::1]']);
21
21
 
22
+ /**
23
+ * 从 Origin / Host 值里取主机名:去 scheme、去端口、剥 IPv6 方括号。
24
+ * 为什么不用简单的 `^([^/:]+)`:那会在 `http://[::1]:3080` 上止步于 `[`,
25
+ * 把 IPv6 回环判成未知主机(同源判定失效)。
26
+ * @param {string} value 如 "http://127.0.0.1:3080" / "10.10.10.4:3080" / "dsh-app://app"
27
+ * @returns {string} 主机名(取不到返回空串)
28
+ */
29
+ export function hostNameOf(value = '') {
30
+ const text = String(value || '').trim().replace(/^[a-z][a-z0-9+.-]*:\/\//i, '');
31
+ if (!text) return '';
32
+ if (text.startsWith('[')) {
33
+ const end = text.indexOf(']');
34
+ return end > 0 ? text.slice(1, end) : '';
35
+ }
36
+ const match = /^([^/:]+)(?::\d+)?/.exec(text);
37
+ return match ? match[1] : '';
38
+ }
39
+
40
+ /**
41
+ * 是否本机回环主机(127.0.0.1 / localhost / ::1)。
42
+ * 用途:无 Origin 的写请求只允许来自「本机」——桌面壳转发的目标恒是回环地址,
43
+ * 而局域网直连(Host 是 10.x/192.168.x)不享受该放行,避免给局域网开 CSRF 口子。
44
+ * @param {string} value Origin 或 Host 值
45
+ * @returns {boolean}
46
+ */
47
+ export function isLoopbackHost(value = '') {
48
+ const LOOPBACK = new Set(['127.0.0.1', 'localhost', '::1']);
49
+ // ① 先按**裸地址**判:`socket.remoteAddress` 给的就是裸形态(`127.0.0.1` / `::1` /
50
+ // `::ffff:127.0.0.1`),没有 scheme、没有方括号、IPv6 也不带端口。
51
+ // hostNameOf 的 `^([^/:]+)` 对裸 IPv6(以 `:` 开头)会解析成空串 ⇒ 必须先在这里判。
52
+ const raw = String(value || '').trim().toLowerCase();
53
+ const bare = raw.startsWith('::ffff:') ? raw.slice('::ffff:'.length) : raw;
54
+ if (LOOPBACK.has(bare)) return true;
55
+ // ② 再退回 hostNameOf:处理带 scheme / 端口 / IPv6 方括号的 Origin 与 Host 头。
56
+ let name = hostNameOf(value).toLowerCase();
57
+ if (name.startsWith('::ffff:')) name = name.slice('::ffff:'.length);
58
+ return LOOPBACK.has(name);
59
+ }
60
+
61
+ /**
62
+ * 是否 JSON 请求体(忽略 charset 等参数)。
63
+ * 用途:无 Origin 写请求的放行判据——跨站表单设不出 application/json。
64
+ * @param {string} contentType Content-Type 头值
65
+ * @returns {boolean}
66
+ */
67
+ export function isJsonContentType(contentType = '') {
68
+ return String(contentType || '').toLowerCase().split(';')[0].trim() === 'application/json';
69
+ }
70
+
22
71
  /**
23
72
  * Origin 校验:写请求必须带同源 Origin(可信页面来源),否则 403(防 CSRF)。
24
73
  * GET/OPTIONS 等只读请求免校验(读不产生副作用)。
@@ -32,10 +81,12 @@ export const ALLOWED_ORIGINS = new Set(['http://127.0.0.1', 'http://localhost',
32
81
  * @param {string} [origin] Origin 请求头值(可能 undefined)
33
82
  * @param {Set<string>} [allowed] 允许的源集合(默认本机回环,测试可注入)
34
83
  * @param {string} [host] 请求 Host 头值(如 "10.10.10.4:3080";同源放行依据)
84
+ * @param {string} [contentType] Content-Type 请求头值(无 Origin 时的放行判据之一)
85
+ * @param {string} [remoteAddress] TCP 对端地址(`req.socket.remoteAddress`;**比 Host 头可信**)
35
86
  * @returns {{ok: boolean, status?: number, code?: string, message?: string}}
36
87
  * ok=true 放行;ok=false 时带 status/code/message
37
88
  */
38
- export function checkOrigin(method = '', origin = '', allowed = ALLOWED_ORIGINS, host = '') {
89
+ export function checkOrigin(method = '', origin = '', allowed = ALLOWED_ORIGINS, host = '', contentType = '', remoteAddress = '') {
39
90
  const methodUpper = String(method || '').toUpperCase();
40
91
  if (!WRITE_METHODS.has(methodUpper) && !READ_METHODS.has(methodUpper)) {
41
92
  return { ok: false, status: 405, code: 'METHOD', message: `不支持的 HTTP 方法: ${method}` };
@@ -43,14 +94,33 @@ export function checkOrigin(method = '', origin = '', allowed = ALLOWED_ORIGINS,
43
94
  if (READ_METHODS.has(methodUpper)) return { ok: true }; // 只读免校验
44
95
  const originStr = String(origin || '').trim();
45
96
  if (!originStr) {
97
+ // 桌面端(dsh-app:// 自定义协议)放行通道。
98
+ // 桌面壳 forwardWebRequest 转发 /api/* 到后端时**显式剥离 Origin**
99
+ // (headers.delete('origin'),只补 cookie),于是写请求到这里 Origin 恒为空。
100
+ // 若不特判,桌面版设置页的**所有保存/开关/按钮**都会 403,而 GET 免校验照常
101
+ // —— 表现为「页面能打开、保存永不生效、回显旧值」,且拒绝发生在 handler 之前
102
+ // 连日志都不留,用户无从自查(外部报告已完整复现并定位到桌面壳源码)。
103
+ // 放行判据取三条同时成立,CSRF 防护不降级:
104
+ // ① **Content-Type 是 application/json**:浏览器跨站表单(text/plain /
105
+ // urlencoded / multipart)设不出这个 CT;fetch/XHR 设 JSON CT 属非简单请求 →
106
+ // 触发 CORS 预检,而本 API 从不回 CORS 许可头 ⇒ 预检失败,真实请求发不出去。
107
+ // ② **Host 是回环地址**:桌面壳转发目标是 127.0.0.1:<port>;服务若监听
108
+ // 0.0.0.0,局域网上的机器发「无 Origin + JSON」的写请求仍会被拒,CSRF 面不扩大。
109
+ // ③ 浏览器发起的写请求**必带 Origin** ⇒ 走下方既有同源/跨源判定,不受本分支影响。
110
+ // ②' **本机判定以 TCP 对端地址为准,Host 只作补充**:
111
+ // Host 头是客户端可控的(构造 `Host: 127.0.0.1` 即可伪造),
112
+ // 而 `socket.remoteAddress` 由内核给出、无法伪造 ⇒ 有 remoteAddress 时以它定论。
113
+ // 只在拿不到 remoteAddress(进程内/测试调用)时才退回看 Host。
114
+ // 顺带覆盖「某些转发链路会丢 Host」的场景(实测宿主转发后 host 可能为空)。
115
+ const fromLoopback = remoteAddress
116
+ ? isLoopbackHost(remoteAddress)
117
+ : isLoopbackHost(host);
118
+ if (isJsonContentType(contentType) && fromLoopback) return { ok: true };
46
119
  return { ok: false, status: 403, code: 'NO_ORIGIN', message: '写请求缺少 Origin 头——拒绝(防 CSRF)' };
47
120
  }
48
121
  // 主机名解析:兼容带协议(Origin)与不带协议(Host 头)两种输入,忽略端口
49
- const hostOf = (u) => {
50
- const s = String(u || '').trim().replace(/^https?:\/\//i, '');
51
- const match = /^([^/:]+)(?::\d+)?/.exec(s);
52
- return match ? match[1] : '';
53
- };
122
+ // 用模块级 hostNameOf(支持 IPv6 方括号与任意 scheme,如 dsh-app://)
123
+ const hostOf = hostNameOf;
54
124
  const oHost = hostOf(originStr);
55
125
  // 同源放行(1.0.5):Origin 主机与请求 Host 一致 = 可信页面自身发起的请求(防跨站 CSRF 的核心)
56
126
  const hHost = hostOf(host);
@@ -105,12 +175,13 @@ export function httpOk(ok = true, extra = {}) {
105
175
 
106
176
  /**
107
177
  * 统一鉴权流水线:Origin → 方法 → 写确认 → 体大小,全部通过返回 {ok:true}。
108
- * @param {object} req { method, origin, contentLength, isWriteConfirmOp }
178
+ * @param {object} req { method, origin, host, contentType, contentLength, isWriteConfirmOp }
109
179
  * @param {object} [opts] { allowedOrigins, bodyLimit, isWriteConfirmOp }
110
180
  * @returns {{ok: boolean, status?: number, code?: string, message?: string}}
111
181
  */
112
- export function authPipeline({ method = '', origin = '', contentLength = 0, isWriteConfirmOp = false } = {}, opts = {}) {
113
- const originCheck = checkOrigin(method, origin, opts.allowedOrigins);
182
+ export function authPipeline({ method = '', origin = '', host = '', contentType = '', contentLength = 0, isWriteConfirmOp = false } = {}, opts = {}) {
183
+ // host / contentType 一并传入:无 Origin 的桌面端转发判据需要它们(见 checkOrigin)
184
+ const originCheck = checkOrigin(method, origin, opts.allowedOrigins, host, contentType);
114
185
  if (!originCheck.ok) return originCheck;
115
186
  if (opts.isWriteConfirmOp ?? isWriteConfirmOp) {
116
187
  // 写确认由调用方在解析 body 后判定(body.confirm),这里只占位返回 ok
@@ -161,7 +232,8 @@ export function routeRequest(req = {}, handlers = {}) {
161
232
  if (!handler) {
162
233
  return { status: 404, body: { ok: false, code: 'NOT_FOUND', message: `无此端点: ${method} ${path}` } };
163
234
  }
164
- const originCheck = checkOrigin(method, req.origin);
235
+ // host / content-type 一并传入:桌面端(dsh-app://)转发剥离 Origin,靠这两个头判定放行
236
+ const originCheck = checkOrigin(method, req.origin, undefined, req.headers?.host, req.headers?.['content-type']);
165
237
  if (!originCheck.ok) return { status: originCheck.status, body: { ok: false, ...originCheck } };
166
238
  const sizeCheck = checkBodySize(Number(req.headers?.['content-length']) || 0);
167
239
  if (!sizeCheck.ok) return { status: sizeCheck.status, body: { ok: false, ...sizeCheck } };
@@ -0,0 +1,161 @@
1
+ /**
2
+ * 外部 linter 委托层 · 探测
3
+ *
4
+ * 职责:判断被审项目是否**自带官方 linter**(配置存在),并**自探测**出可执行的工具路径。
5
+ *
6
+ * 设计口径(docs/2026-11-06-审计插件本体审视与优化方向讨论.案例d3dx.md 方向 A):
7
+ * · 委托层只负责「外部有权威判定源时用它」,绝不在外部工具缺失时硬失败——探测不到即返回 null,
8
+ * 调用方(runner)据此**降级跳过**,交回自研规则(D5:增强件坏了不能拖垮门禁)。
9
+ * · 工具副本按 project-self-tools 存项目 tools/ 目录;本机/CI 没有 tools 副本时回退 PATH 与常见路径。
10
+ *
11
+ * 路径探测四律(tool-self-detection):环境变量覆盖 → 项目 tools/ 自带 → PATH → 常见绝对路径;
12
+ * 每条候选都必须校验**可执行**(-x),仅存在不够(CIFS/noexec 上会存在但跑不了)。
13
+ */
14
+ import { existsSync, readFileSync, constants, accessSync } from 'node:fs';
15
+ import { join } from 'node:path';
16
+ import { execFileSync } from 'node:child_process';
17
+
18
+ // 插件根:与 ext-runner 同源——统一从 lib/core/config.js 导入,不自行 resolve
19
+ // (两处各算一次是 duplicate-constant,换了目录层级就会不一致;见 ext-runner 同款修复)。
20
+ import { PLUGIN_ROOT } from '../core/config.js';
21
+
22
+ /** 支持的 linter 与其**配置指纹**(探测「项目是否用了它」的依据,均为项目根级文件/字段)。 */
23
+ export const LINTERS = [
24
+ {
25
+ key: 'ruff',
26
+ lang: 'py',
27
+ // 命中任一即认为项目在用 ruff
28
+ configHits: ['ruff.toml', '.ruff.toml'],
29
+ tomlTable: '[tool.ruff',
30
+ // 工具可执行名(PATH 与 tools/ 下同名查找)
31
+ bin: 'ruff',
32
+ envOverride: 'DSH_GIT_PUSH_RUFF',
33
+ },
34
+ ];
35
+
36
+ /** 是否可执行(存在 + x 位;Windows 下 existsSync 即可,无 x 位概念)。 */
37
+ function isExecutable(p) {
38
+ try {
39
+ if (!existsSync(p)) return false;
40
+ // process.platform === 'win32' 时不校验 mode(NTFS 无 POSIX x 位)
41
+ if (process.platform === 'win32') return true;
42
+ accessSync(p, constants.X_OK);
43
+ return true;
44
+ } catch {
45
+ return false;
46
+ }
47
+ }
48
+
49
+ /** 项目根是否存在该 linter 的配置(ruff:独立 toml 或 pyproject 的 [tool.ruff] 段)。 */
50
+ function hasConfig(repoRoot, linter) {
51
+ for (const f of linter.configHits) {
52
+ if (existsSync(join(repoRoot, f))) return true;
53
+ }
54
+ const pyproject = join(repoRoot, 'pyproject.toml');
55
+ if (existsSync(pyproject)) {
56
+ try {
57
+ const txt = readFileSync(pyproject, 'utf8');
58
+ // 粗略匹配 [tool.ruff] / [tool.ruff.lint] 等段头(配置指纹,非语义解析)
59
+ if (txt.includes(linter.tomlTable)) return true;
60
+ } catch { /* 读不动就当没配置 */ }
61
+ }
62
+ return false;
63
+ }
64
+
65
+ /**
66
+ * 自探测 linter 可执行路径(简版:只要「有没有」,不要「为什么没有」)。
67
+ * 候选清单唯一来源是 binCandidates —— 与 resolveBinDetailed 共用,
68
+ * 避免四律改一处漏一处导致「详版找得到、简版找不到」的自相矛盾。
69
+ * @returns {string|null} 首个可执行候选;全落空 null(调用方降级)
70
+ */
71
+ export function resolveBin(repoRoot, linter) {
72
+ for (const c of binCandidates(repoRoot, linter)) {
73
+ if (c && isExecutable(c)) return c;
74
+ }
75
+ return null;
76
+ }
77
+
78
+ /** PATH 里找可执行(不依赖 which 命令,扫 PATH 各段)。 */
79
+ function tryWhich(bin) {
80
+ const paths = (process.env.PATH || '').split(process.platform === 'win32' ? ';' : ':');
81
+ const exts = process.platform === 'win32' ? ['.exe', '.cmd', ''] : [''];
82
+ for (const dir of paths) {
83
+ if (!dir) continue;
84
+ for (const e of exts) {
85
+ const p = join(dir, bin + e);
86
+ if (isExecutable(p)) return p;
87
+ }
88
+ }
89
+ return null;
90
+ }
91
+
92
+ /**
93
+ * 探测结果:项目内所有「有配置且工具可执行」的 linter,附版本(拿不到版本不阻断)。
94
+ * @returns {Array<{key,lang,bin,version}>}
95
+ */
96
+ export function detectLinters(repoRoot) {
97
+ return detectLinterStatus(repoRoot).ok;
98
+ }
99
+
100
+ /**
101
+ * 探测状态全貌(委托层可观测性 bugfix):
102
+ * ok = 可委托(有配置 + 工具可执行)
103
+ * unavailable = **项目声明了要用的 linter,但工具不可用**——必须与「项目根本没配置」区分开。
104
+ *
105
+ * 为什么单列(实测事故):部署副本迁移时 tools/ruff 丢了可执行位(cp/同步不保 mode),
106
+ * 旧行为是静默返回 [],报告里与「项目没装 ruff」完全无法区分——委托层宣称要防的静默空转,
107
+ * 恰恰发生在它自己身上(灯下黑)。unavailable 让这类问题当场可见、且给出修复动作。
108
+ * @returns {{ok: Array<{key,lang,bin,version}>, unavailable: Array<{key,reason}>}}
109
+ */
110
+ export function detectLinterStatus(repoRoot) {
111
+ const ok = [];
112
+ const unavailable = [];
113
+ for (const linter of LINTERS) {
114
+ if (!hasConfig(repoRoot, linter)) continue;
115
+ const r = resolveBinDetailed(repoRoot, linter);
116
+ if (r.bin) ok.push({ key: linter.key, lang: linter.lang, bin: r.bin, version: tryVersion(r.bin) });
117
+ else unavailable.push({ key: linter.key, reason: r.reason });
118
+ }
119
+ return { ok, unavailable };
120
+ }
121
+
122
+ /** 候选路径清单(四律:env 覆盖 → 插件 tools/ → 项目 tools/ → PATH → 常见绝对路径)。 */
123
+ function binCandidates(repoRoot, linter) {
124
+ const out = [];
125
+ if (process.env[linter.envOverride]) out.push(process.env[linter.envOverride]);
126
+ for (const d of ['tools', 'tool']) {
127
+ out.push(join(PLUGIN_ROOT, d, linter.bin));
128
+ out.push(join(PLUGIN_ROOT, d, linter.bin, linter.bin)); // tools/ruff/ruff(pip --target 装法)
129
+ }
130
+ for (const d of ['tools', 'tool']) out.push(join(repoRoot, d, linter.bin));
131
+ const which = tryWhich(linter.bin);
132
+ if (which) out.push(which);
133
+ out.push('/usr/local/bin/' + linter.bin, '/usr/bin/' + linter.bin);
134
+ return out;
135
+ }
136
+
137
+ /** resolveBin 的详版:落空时给出可诊断原因(区分「存在但缺 +x」与「压根没有」)。 */
138
+ function resolveBinDetailed(repoRoot, linter) {
139
+ const candidates = binCandidates(repoRoot, linter);
140
+ let existsOnly = null;
141
+ for (const c of candidates) {
142
+ if (!c) continue;
143
+ if (isExecutable(c)) return { bin: c };
144
+ if (existsOnly === null && existsSync(c)) existsOnly = c;
145
+ }
146
+ if (existsOnly) {
147
+ return { bin: null, reason: '文件存在但不可执行(疑似同步/拷贝丢了可执行位):' + existsOnly + ';修复:chmod 755 该文件' };
148
+ }
149
+ const n = candidates.filter(Boolean).length;
150
+ return { bin: null, reason: '未找到可执行(探测 ' + n + ' 个候选路径);修复:把 ' + linter.bin + ' 放入 tools/,或 export ' + linter.envOverride + '=路径,或装进 PATH' };
151
+ }
152
+
153
+ /** 取 `bin --version` 首行(失败返回空串,不影响委托)。 */
154
+ function tryVersion(bin) {
155
+ try {
156
+ const out = execFileSync(bin, ['--version'], { encoding: 'utf8', timeout: 8000, stdio: ['ignore', 'pipe', 'ignore'] });
157
+ return String(out).split('\n')[0].trim().slice(0, 40);
158
+ } catch {
159
+ return '';
160
+ }
161
+ }
@@ -0,0 +1,50 @@
1
+ /**
2
+ * 外部 linter 委托层 · 入口(方向 A)
3
+ *
4
+ * 一次调用完成「探测项目自带 linter → 逐个委托执行 → 聚合 finding」。
5
+ * 与 ext-runner 同构:auditFull/auditWithScope 末尾并入其产出,任何环节失败都降级为空数组。
6
+ *
7
+ * 输出契约(供编排层与测试消费):
8
+ * { findings: Array, linted: Array<{key,bin,version,count,note}> }
9
+ * —— linted 记录「本次委托了哪些外部 linter、各产出多少」,让「用没用上外部权威源」在报告里可见
10
+ * (与 treeUsage 同一防再哑思路:委托层若长期空转,报告能看到,不至于误以为外部精度已生效)。
11
+ */
12
+ import { detectLinters, detectLinterStatus } from './detect.js';
13
+ import { runLinter } from './runner.js';
14
+
15
+ /**
16
+ * @param {string} repoRoot 仓库根
17
+ * @param {object} [opts] { linters?: 覆盖探测结果(测试注入用), log? }
18
+ */
19
+ export async function runLintAdapters(repoRoot, opts = {}) {
20
+ // let:未注入时由探测结果赋值(对 const 赋值会在运行期抛 TypeError,node --check 抓不到)
21
+ let linters = opts.linters;
22
+ const unavailable = [];
23
+ if (!linters) {
24
+ // 走真实探测:unavailable(项目声明了 linter 但工具不可用)必须进 linted,
25
+ // 否则「部署副本迁移丢了 +x」这类问题与「项目压根没配 ruff」在报告里同样沉默——
26
+ // 委托层宣称防静默空转,自己不能再有灯下黑。
27
+ const st = detectLinterStatus(repoRoot);
28
+ linters = st.ok;
29
+ unavailable.push(...st.unavailable);
30
+ }
31
+ const findings = [];
32
+ const linted = [];
33
+ // 不可用项也记一条(count=0 + reason 含修复动作),使「为什么没委托成」可读。
34
+ for (const u of unavailable) {
35
+ linted.push({ key: u.key, bin: '', version: '', count: 0, unavailable: true, note: `未委托:${u.reason}` });
36
+ }
37
+ for (const linter of linters) {
38
+ let res;
39
+ try {
40
+ res = await runLinter(linter, repoRoot);
41
+ } catch (e) {
42
+ res = { findings: [], note: `执行异常降级跳过:${(e && e.message) || e}` };
43
+ }
44
+ findings.push(...res.findings);
45
+ linted.push({ key: linter.key, bin: linter.bin, version: linter.version || '', count: res.findings.length, note: res.note });
46
+ }
47
+ return { findings, linted };
48
+ }
49
+
50
+ export { detectLinters } from './detect.js';