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,55 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * 预览服务「本地模式」执行器(--local)。
4
+ *
5
+ * 用途:让预览页在**不重启 DSH 宿主**的前提下跑**工作区当前的插件代码**。
6
+ * 做法:预览服务对每个 `/api/git-push/*` 请求 fork 一个本脚本(一次性子进程)——
7
+ * 子进程冷启动 → 插件模块(含其全部子模块)都是磁盘上最新版本,天然绕开 ESM 模块缓存;
8
+ * 执行完把 {status, body} 以 JSON 写到 stdout 后退出。
9
+ *
10
+ * 为什么用「一次性子进程」而不是「进程内带 ?t= 时间戳重新 import」:
11
+ * ESM 的模块缓存键是 URL,只给**入口**加时间戳时,入口 import 的子模块(handlers/*.js、
12
+ * git/*.js 等)仍命中旧缓存——改了子模块不生效。子进程方案对整个模块图都新鲜,代价是
13
+ * 每次请求多一次进程启动(约 100ms,预览场景可接受)。
14
+ *
15
+ * 输入(stdin JSON):{ method, url, headers, workspaceRoot? }
16
+ * 输出(stdout JSON):{ status, body }
17
+ */
18
+ import { readFileSync } from 'node:fs';
19
+ import { dirname, resolve } from 'node:path';
20
+ import { fileURLToPath, pathToFileURL } from 'node:url';
21
+
22
+ const HERE = dirname(fileURLToPath(import.meta.url));
23
+ const ROOT = resolve(HERE, '..');
24
+ /** 以绝对 file URL 加载插件模块(相对本脚本解析,避免 cwd 影响)。 */
25
+ const load = (rel) => import(pathToFileURL(resolve(ROOT, rel)).href);
26
+
27
+ let payload = {};
28
+ try { payload = JSON.parse(readFileSync(0, 'utf8') || '{}'); } catch { payload = {}; }
29
+
30
+ const { handleHttp } = await load('lib/app/http-handlers.js');
31
+ const { defaultConfig } = await load('lib/client/index.js');
32
+ const { VERSION } = await load('lib/self/index.js');
33
+
34
+ const headers = payload.headers || {};
35
+ // env 形状与插件 apply() 里构造的一致(HTTP 层只用到这几项);
36
+ // workspaceRoot 决定凭据/索引等数据目录——缺省取项目根的上一级(工作区)。
37
+ const env = {
38
+ version: VERSION,
39
+ workspaceRoot: payload.workspaceRoot || resolve(ROOT, '..'),
40
+ extraRepos: [],
41
+ extraReposFile: '',
42
+ };
43
+ const req = {
44
+ method: payload.method || 'GET',
45
+ url: payload.url || '/',
46
+ headers,
47
+ origin: `http://${headers.host || '127.0.0.1'}`,
48
+ };
49
+
50
+ try {
51
+ const r = await handleHttp(req, env, defaultConfig());
52
+ process.stdout.write(JSON.stringify({ status: r?.status || 200, body: r?.body }));
53
+ } catch (e) {
54
+ process.stdout.write(JSON.stringify({ status: 500, body: { ok: false, error: String(e?.message || e) } }));
55
+ }
@@ -0,0 +1,116 @@
1
+ /**
2
+ * dsh-git-push — 本地真实后端测试服务
3
+ *
4
+ * 起一个真实 HTTP 服务,直接调插件 handleHttp(走真实代码路径:repos-local 真实扫描、
5
+ * browse 真实目录、repo-push 真实推送、后台任务等等),供 preview.html 用
6
+ * `?backend=<此地址>` 接真实后端测试(区别于纯 mock 离线预览)。
7
+ *
8
+ * 用法:
9
+ * node scripts/preview-server.mjs --port 8090 [--root <默认扫描根>]
10
+ * 浏览器访问:http://<本机局域网IP>:8090 (推荐,手机/其他设备也可开)
11
+ * 本机回环 http://127.0.0.1:8090 亦可用(自动接真实后端)
12
+ *
13
+ * 说明:
14
+ * - 仅服务本机调试(回环信任 + 全 ENABLE CORS),非生产宿主;不经 DSH 宿主
15
+ * 的鉴权会话(账号卡片 token/SSH 凭据仍从插件配置目录自探测,与实例一致)。
16
+ * - GET / 自动 serve preview.html(注入 backend 指向本服务,免手动拼 URL)。
17
+ */
18
+ import http from 'node:http';
19
+ import os from 'node:os';
20
+ import { readFileSync, existsSync } from 'node:fs';
21
+ import { dirname, join, resolve } from 'node:path';
22
+ import { fileURLToPath } from 'node:url';
23
+
24
+ import { readJsonBody } from '../lib/http/index.js';
25
+ import { handleHttp } from '../lib/app/http-handlers.js';
26
+ import { defaultConfig, resolveConfig } from '../lib/client/index.js';
27
+
28
+ /** 探测本机局域网 IPv4(非回环、非容器网桥):优先 10.x/192.168.x/172.16-31.x。 */
29
+ function detectLanIp() {
30
+ try {
31
+ const cands = [];
32
+ for (const list of Object.values(os.networkInterfaces())) {
33
+ for (const ni of list || []) {
34
+ if (ni.family !== 'IPv4' || ni.internal) continue;
35
+ cands.push(ni.address);
36
+ }
37
+ }
38
+ // 优先私网段(排除 docker/网桥常见的 172.17-172.31 次级地址,首选项仍按出现顺序)
39
+ return cands.find((a) => /^10\./.test(a)) || cands.find((a) => /^192\.168\./.test(a)) || cands[0] || '';
40
+ } catch { return ''; }
41
+ }
42
+
43
+ const __root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
44
+ const argv = process.argv.slice(2);
45
+ const DEFAULT_PORT = 8090; // --port 默认监听端口
46
+ const port = Number((argv.find((a) => a.startsWith('--port')) || '').split('=')[1] || argv[argv.indexOf('--port') + 1] || DEFAULT_PORT);
47
+ const rootArgIdx = argv.indexOf('--root');
48
+ const root = rootArgIdx !== -1 ? argv[rootArgIdx + 1]
49
+ : (process.env.DSH_HOME ? dirname(process.env.DSH_HOME) : __root);
50
+
51
+ // 配置:若部署副本有持久化 config(status 端点会脱敏读),这里用默认配置 + 本地覆盖。
52
+ const cfg = defaultConfig();
53
+ const cfgPath = join(process.env.DSH_HOME || '', 'git-push', 'config.json');
54
+ try {
55
+ if (existsSync(cfgPath)) {
56
+ const persisted = JSON.parse(readFileSync(cfgPath, 'utf8'));
57
+ Object.assign(cfg, resolveConfig(persisted));
58
+ }
59
+ } catch { /* 无持久化配置 → 用默认 */ }
60
+
61
+ const env = {
62
+ workspaceRoot: root,
63
+ extraRepos: [],
64
+ dshHomeRoot: root,
65
+ };
66
+
67
+ // 读 preview.html 模板(注入 backend 指向本服务,用户打开即接真实后端)
68
+ const previewPath = join(__root, 'assets', 'preview.html');
69
+ let previewHtml = '';
70
+ try { previewHtml = readFileSync(previewPath, 'utf8'); } catch { /* preview.html 不存在则不 serve 首页 */ }
71
+ // 在 </head> 前注入 <script> 设置 backend(preview.html fetch mock 优先读 location.search,
72
+ // fallback 读 window.__DSHGP_BACKEND__,两者都自动接本服务)
73
+ // 修复:注入**同源地址**(location.origin),不再硬编码 127.0.0.1——
74
+ // 经局域网地址(如 http://10.10.10.63:8090)打开页面时,硬编码回环会让浏览器把请求
75
+ // 打到访问设备自己(连不上);同源地址则本机/局域网都正确指向本服务。
76
+ const injectScript = `<script>window.__DSHGP_BACKEND__=location.origin;</script>`;
77
+ const injectedHtml = previewHtml.replace('</head>', injectScript + '\n</head>');
78
+
79
+ const server = http.createServer((req, res) => {
80
+ const optFlag = req.method === 'OPTIONS';
81
+ res.setHeader('Access-Control-Allow-Origin', '*');
82
+ res.setHeader('Access-Control-Allow-Methods', 'GET,POST,OPTIONS');
83
+ res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
84
+ if (optFlag) { res.writeHead(204); res.end(); return; }
85
+ // GET / → serve preview.html(注入 backend)
86
+ if (req.method === 'GET' && (req.url === '/' || req.url === '/index.html')) {
87
+ if (!injectedHtml) { res.writeHead(404, { 'Content-Type': 'text/plain' }); res.end('preview.html 不存在'); return; }
88
+ res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
89
+ res.end(injectedHtml);
90
+ return;
91
+ }
92
+ // 其他请求 → handleHttp(/api/git-push/* 等)
93
+ readJsonBody(req, async (body) => {
94
+ // 本地信任:预览页跨端口,覆写 origin 为**请求实际 Host**(本机访问=回环地址,
95
+ // 局域网访问=局域网地址)以过 CSRF 校验;不再固定 127.0.0.1,否则局域网访问被判跨源。
96
+ const reqHost = String(req.headers.host || `127.0.0.1:${port}`);
97
+ const origin = `http://${reqHost}`;
98
+ const r = await handleHttp(
99
+ { method: req.method, url: req.url, origin, host: reqHost, headers: req.headers, body },
100
+ env,
101
+ cfg,
102
+ );
103
+ res.writeHead(r.status || 200, { 'Content-Type': 'application/json' });
104
+ res.end(JSON.stringify(r.body));
105
+ });
106
+ });
107
+
108
+ server.listen(port, '0.0.0.0', () => {
109
+ // 优先给**局域网地址**(远程/手机也能打开),本机回环降为备选;
110
+ // IP 用 os.networkInterfaces() 动态探测(不写死某台机器的地址)。
111
+ const lan = detectLanIp();
112
+ console.log('dsh-git-push 预览服务已启动:');
113
+ if (lan) console.log(` 局域网访问: http://${lan}:${port} ← 推荐(本机/手机/其他设备)`);
114
+ console.log(` 本机回环: http://127.0.0.1:${port}`);
115
+ console.log(' (自动接真实后端,免手动拼 ?backend=)');
116
+ });
@@ -0,0 +1,305 @@
1
+ // dsh-skip-sensitive: 本文件为预览反代服务器,含 token 认证逻辑(--token/环境变量/dsh-proxy.log 运行时解析),无硬编码凭据,安全类规则整文件豁免(文件头前 3 行生效)。
2
+ /**
3
+ * dsh-git-push 侧边栏独立预览服务(默认反代 DSH 真实后端;同入口还支持 --direct 直连插件 handleHttp、--local 免重启、--shot 截图)
4
+ *
5
+ * 用途:把任意 DSH 插件的预览页(preview.html,垫片执行真实 client 代码)独立跑起来,
6
+ * 并接 **DSH 真实后端**——预览页里的数据全部来自真后端(读与写都真实)。
7
+ *
8
+ * 复制到目标项目后,改「配置区」即可:
9
+ * - PROJECT_LABEL 启动横幅显示名(如 "dsh-git-push 设置侧边栏预览")
10
+ * - PREVIEW_FILE 预览页文件名(相对项目根;默认 preview.html,如 assets/preview.html)
11
+ * - SERVE_DIRS 本地静态服务目录(相对项目根;预览页相对资源走这里)
12
+ * - PROXY_PREFIX 转发到 DSH 后端的 URL 前缀(默认 /api/;插件后端前缀改如 /api/git-push/)
13
+ * - HEALTH_PATH 健康检查路径(默认 /preview-ping;配套 start.sh 用它判启动成功)
14
+ * - DSH_BASE 默认后端(可 --dsh 覆盖)
15
+ *
16
+ * 逻辑部分(勿改):token 认证(--token > 环境变量 DSH_PREVIEW_TOKEN > dsh-proxy.log 兜底,
17
+ * GET /?token= → dsh-auth cookie)+ 反向代理 + 静态服务 + playwright 自检骨架。
18
+ *
19
+ * 用法:
20
+ * node scripts/preview-server.mjs --port 30999 # 起本地反代服务器(默认模式:反代 DSH 真实后端)
21
+ * node scripts/preview-server.mjs --direct --port 8090 # 直连模式:不起 DSH 宿主,直接调插件 handleHttp
22
+ * #(原 scripts/preview-server.mjs,2026-10-13 并入本入口)
23
+ * node scripts/preview-server.mjs --local # 免重启:每个 /api 请求 fork 一次性子进程跑工作区最新代码
24
+ * node scripts/preview-server.mjs --dsh http://127.0.0.1:30800 --token <launch-token>
25
+ * node scripts/preview-server.mjs --shot preview.png # playwright 截图自检(需 pwviewer)
26
+ */
27
+ import { createServer } from 'node:http';
28
+ import { request as httpRequest } from 'node:http';
29
+ import { spawn } from 'node:child_process';
30
+ import { createReadStream, existsSync, statSync, readFileSync } from 'node:fs';
31
+ import { access } from 'node:fs/promises';
32
+ import { join, normalize, extname, dirname } from 'node:path';
33
+ import { fileURLToPath } from 'node:url';
34
+ import os from 'node:os';
35
+
36
+ /* ─────────────── 配置区(各项目按需修改) ─────────────── */
37
+ const PROJECT_LABEL = 'dsh-git-push 设置侧边栏预览(接真实后端)';
38
+ const PREVIEW_FILE = 'assets/preview.html'; // 预览页文件名(相对项目根,preview-gen 生成)
39
+ const SERVE_DIRS = ['lib']; // 本地静态服务目录(相对项目根)
40
+ const PROXY_PREFIX = '/api/git-push/'; // 转发到 DSH 后端的 URL 前缀(插件后端)
41
+ const HEALTH_PATH = '/preview-ping'; // 健康检查路径(start.sh 启动判定用)
42
+ const DSH_BASE = process.env.DSH_PREVIEW_TARGET || 'http://127.0.0.1:30800'; // DSH 反代
43
+ const SHOT_ROOT_SELECTOR = '.dshgp_page'; // playwright 自检的根元素选择器(侧边栏页根)
44
+ /* ─────────────── 配置区结束 ─────────────── */
45
+
46
+ const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url)); // 本脚本所在目录
47
+ const PROJECT_ROOT = normalize(join(SCRIPT_DIR, '..')); // 项目根(脚本在 <根>/preview 或 <根>/assets 下一级)
48
+ const PROXY_LOG = process.env.DSH_PROXY_LOG || join(process.env.DSH_HOME || join(os.homedir(), '.dsh'), 'dsh-proxy.log');
49
+
50
+ const MIME = {
51
+ '.html': 'text/html; charset=utf-8', '.js': 'text/javascript; charset=utf-8', '.css': 'text/css; charset=utf-8',
52
+ '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.webp': 'image/webp',
53
+ '.gif': 'image/gif', '.svg': 'image/svg+xml', '.ico': 'image/x-icon',
54
+ '.json': 'application/json; charset=utf-8',
55
+ };
56
+ // 纯文本响应类型(脚本自身产生的 404/502 文本——修:此前三处引用该常量但未定义,
57
+ // 任何走 send() 的请求(如 favicon 404)都会抛 ReferenceError 使服务进程整体崩溃)。
58
+ const TEXT_PLAIN_UTF8 = 'text/plain; charset=utf-8';
59
+ /** playwright 自检参数(截图窗口 / 加载超时 / 渲染等待 / 错误消息截断长度)。 */
60
+ const SHOT_VIEWPORT = { width: 1400, height: 900 };
61
+ const SHOT_NAV_TIMEOUT_MS = 30_000;
62
+ const SHOT_SETTLE_MS = 4000;
63
+ const SHOT_ERR_SNIPPET = 80;
64
+ /** 启动横幅宽度(字符数,与 padEnd 对齐)。 */
65
+ const BANNER_WIDTH = 46;
66
+
67
+ // ── CLI 参数 ──
68
+ const args = process.argv.slice(2);
69
+ const PORT = parseInt(args.find(a => a.startsWith('--port'))?.split('=')[1] || args[args.indexOf('--port') + 1] || '30999', 10);
70
+ const noOpen = args.includes('--no-open');
71
+ const shotPath = args.find(a => a.startsWith('--shot'))?.split('=')[1] || (args.includes('--shot') ? args[args.indexOf('--shot') + 1] : null);
72
+ const dshArg = args.find(a => a.startsWith('--dsh'))?.split('=')[1] || (args.includes('--dsh') ? args[args.indexOf('--dsh') + 1] : null);
73
+ const tokenArg = args.find(a => a.startsWith('--token'))?.split('=')[1] || (args.includes('--token') ? args[args.indexOf('--token') + 1] : null);
74
+ // ── 本地模式(--local)──
75
+ // 不反代 DSH 宿主,改为**直接执行工作区当前的插件代码**(每个请求 fork 一次性子进程,
76
+ // 子进程模块天然新鲜)——这样改完代码刷新页面即生效,既不用重启宿主、也不用重启本服务。
77
+ // 用于开发自检;真实宿主 UI/工具仍需宿主重启才生效(DSH 插件在启动时 import 并注册路由)。
78
+ const LOCAL_MODE = args.includes('--local') || process.env.DSH_PREVIEW_LOCAL === '1';
79
+
80
+ // ── 直连模式(--direct,合并 2026-10-13)──
81
+ // 原 scripts/preview-server.mjs(不起 DSH 宿主,直接调插件 handleHttp 走真实代码路径)已并入本入口:
82
+ // 这里转交 scripts/preview-server-direct.mjs 子进程(stdio 透传 + 信号转发),
83
+ // 于是本入口一个命令两种模式:默认 = 反代 DSH 真实后端;--direct = 直连插件真实代码。
84
+ if (args.includes('--direct')) {
85
+ const { spawn } = await import('node:child_process');
86
+ const { existsSync } = await import('node:fs');
87
+ const direct = join(SCRIPT_DIR, 'preview-server-direct.mjs');
88
+ if (!existsSync(direct)) {
89
+ console.error(`找不到直连实现:${direct}`);
90
+ process.exit(2);
91
+ }
92
+ const rest = args.filter((a) => a !== '--direct');
93
+ console.log(`[preview] --direct 模式:转交 ${direct}`);
94
+ const child = spawn(process.execPath, [direct, ...rest], { cwd: PROJECT_ROOT, stdio: 'inherit' });
95
+ for (const sig of ['SIGINT', 'SIGTERM']) {
96
+ process.on(sig, () => { try { child.kill(sig); } catch { /* 子进程已退出 */ } });
97
+ }
98
+ child.on('exit', (code) => process.exit(code ?? 0));
99
+ await new Promise(() => {}); // 常驻:不继续走下面的反代流程
100
+ }
101
+ const LOCAL_WORKSPACE = process.env.DSH_PREVIEW_WORKSPACE || '';
102
+ const LOCAL_RUNNER = 'preview-local-runner.mjs';
103
+ const LOCAL_TIMEOUT_MS = 120_000;
104
+ const TARGET = dshArg || DSH_BASE;
105
+
106
+ // ── token 解析:--token > env > dsh-proxy.log ──
107
+ function resolveToken() {
108
+ if (tokenArg) return tokenArg;
109
+ if (process.env.DSH_PREVIEW_TOKEN) return process.env.DSH_PREVIEW_TOKEN;
110
+ try {
111
+ if (!existsSync(PROXY_LOG)) return null;
112
+ const txt = readFileSync(PROXY_LOG, 'utf8');
113
+ const matches = txt.match(/token=([a-zA-Z0-9_-]{20,})/g);
114
+ if (matches && matches.length) {
115
+ const last = matches[matches.length - 1].replace('token=', '');
116
+ return last;
117
+ }
118
+ } catch { /* 读不到就 null */ }
119
+ return null;
120
+ }
121
+
122
+ // ── DSH 会话:认证 cookie 缓存 ──
123
+ let authCookie = null; // 已认证的 cookie 串
124
+ const COOKIE_RE = /(dsh-auth|_DSH|dsh_)[^;]*/i;
125
+
126
+ async function ensureAuthCookie() {
127
+ if (authCookie) return authCookie;
128
+ const token = resolveToken();
129
+ if (!token) return null;
130
+ // GET /?token=xxx → 303 + Set-Cookie
131
+ return new Promise((resolve) => {
132
+ const target = new URL(TARGET);
133
+ // dsh-skip-sensitive(token 来自 --token 参数/环境变量/日志兜底,运行时解析,非硬编码凭据)
134
+ const req = httpRequest({
135
+ hostname: target.hostname, port: target.port, path: '/?token=' + encodeURIComponent(token), method: 'GET',
136
+ headers: { host: target.host, connection: 'close' }, // 强制新连接,避免复用反代坏 keep-alive
137
+ }, (res) => {
138
+ const setCookies = res.headers['set-cookie'] || [];
139
+ const cookieStr = setCookies.map(s => s.split(';')[0]).join('; ');
140
+ if (cookieStr) { authCookie = cookieStr; }
141
+ res.resume();
142
+ resolve(authCookie);
143
+ });
144
+ req.on('error', () => resolve(null));
145
+ req.end();
146
+ });
147
+ }
148
+
149
+ /** 转发一个浏览器请求到 DSH 真实后端。 */
150
+ function proxyToDsh(req, res, upstreamPath) {
151
+ const t0 = Date.now();
152
+ let bodyBytes = 0;
153
+ req.on('data', (c) => { bodyBytes += c.length; });
154
+ ensureAuthCookie().then((cookie) => {
155
+ if (!cookie) {
156
+ console.log(`[proxy] ${req.method} ${upstreamPath} → 502 no-cookie (${Date.now() - t0}ms)`);
157
+ res.writeHead(502, { 'content-type': TEXT_PLAIN_UTF8 });
158
+ res.end('preview: 无法认证 DSH 后端(未提供 --token 且 proxy.log 无 token)');
159
+ return;
160
+ }
161
+ const target = new URL(TARGET);
162
+ const headers = { ...req.headers, host: target.host, cookie, connection: 'close' };
163
+ // 流式转发:删除 content-length 让 Node 用 chunked 处理,避免长度不匹配挂起
164
+ delete headers['content-length'];
165
+ const upstream = httpRequest({
166
+ hostname: target.hostname, port: target.port, path: upstreamPath, method: req.method, headers,
167
+ }, (up) => {
168
+ const outHeaders = { ...up.headers };
169
+ delete outHeaders['set-cookie']; // 不把 DSH cookie 回给预览页
170
+ delete outHeaders['content-length'];
171
+ res.writeHead(up.statusCode || 502, outHeaders);
172
+ up.pipe(res);
173
+ up.on('end', () => {
174
+ console.log(`[proxy] ${req.method} ${upstreamPath} → ${up.statusCode} body=${bodyBytes}B ${Date.now() - t0}ms`);
175
+ });
176
+ up.on('close', () => {
177
+ console.log(`[proxy] ${req.method} ${upstreamPath} → CLOSE(no-response?) body=${bodyBytes}B ${Date.now() - t0}ms`);
178
+ });
179
+ });
180
+ upstream.on('error', (e) => {
181
+ console.log(`[proxy] ${req.method} ${upstreamPath} → ERROR ${e.message} body=${bodyBytes}B ${Date.now() - t0}ms`);
182
+ res.writeHead(502, { 'content-type': TEXT_PLAIN_UTF8 });
183
+ res.end('preview: 转发 DSH 失败 ' + e.message);
184
+ });
185
+ req.pipe(upstream);
186
+ });
187
+ }
188
+
189
+ function send(res, status, body, type) {
190
+ res.writeHead(status, { 'content-type': type || TEXT_PLAIN_UTF8, 'cache-control': 'no-cache' });
191
+ res.end(body);
192
+ }
193
+
194
+ function serveFile(res, file) {
195
+ if (!existsSync(file) || !statSync(file).isFile()) { send(res, 404, 'not found'); return; }
196
+ const mime = MIME[extname(file).toLowerCase()] || 'application/octet-stream';
197
+ res.writeHead(200, { 'content-type': mime, 'cache-control': 'no-cache' });
198
+ createReadStream(file).pipe(res);
199
+ }
200
+
201
+ const server = createServer((req, res) => {
202
+ const url = new URL(req.url ?? '/', 'http://x');
203
+ const pathname = decodeURIComponent(url.pathname);
204
+
205
+ // 健康检查(start.sh 启动判定用;不转发后端)
206
+ if (pathname === HEALTH_PATH) { send(res, 200, 'pong', 'text/plain'); return; }
207
+
208
+ // 根 → 预览页
209
+ if (pathname === '/' || pathname === '/index.html') { serveFile(res, join(PROJECT_ROOT, PREVIEW_FILE)); return; }
210
+
211
+ // 配置的本地静态目录(如 /lib/* → 项目根 lib/;预览页相对资源走这里)
212
+ for (const dir of SERVE_DIRS) {
213
+ if (pathname.startsWith('/' + dir + '/')) {
214
+ const file = normalize(join(PROJECT_ROOT, pathname.replace(new RegExp('^/' + dir + '/'), dir + '/')));
215
+ if (file.startsWith(join(PROJECT_ROOT, dir))) { serveFile(res, file); return; }
216
+ send(res, 403, 'forbidden'); return;
217
+ }
218
+ }
219
+
220
+ // 代理前缀 → --local 时直跑工作区插件代码,否则转发 DSH 真实后端(读与写都真实)
221
+ if (pathname.startsWith(PROXY_PREFIX)) {
222
+ if (LOCAL_MODE) { serveLocalApi(req, res); return; }
223
+ proxyToDsh(req, res, req.url); // 原样转发(保留 query)
224
+ return;
225
+ }
226
+
227
+ // 其余 → 404
228
+ send(res, 404, 'not found');
229
+ });
230
+
231
+ async function openBrowser() {
232
+ // 异步函数内同步 existsSync 改 fs.promises.access,消除阻塞事件循环
233
+ let hasPlaywright = false;
234
+ try { await access(join(PROJECT_ROOT, '..', '..', 'pwviewer', 'node_modules', 'playwright')); hasPlaywright = true; } catch { hasPlaywright = false; }
235
+ if (noOpen || !hasPlaywright) return;
236
+ try {
237
+ const { chromium } = await import('/volume1/VirtualDSM/DeepSeekHarness/pwviewer/node_modules/playwright/index.mjs');
238
+ const CHROME = '/volume1/VirtualDSM/DeepSeekHarness/pwviewer/browsers/chromium_headless_shell-1243/chrome-headless-shell-linux64/chrome-headless-shell';
239
+ const browser = await chromium.launch({ executablePath: CHROME, headless: true, args: ['--no-sandbox','--disable-dev-shm-usage','--disable-gpu','--disable-software-rasterizer','--no-zygote','--single-process','--disable-fontconfig'] });
240
+ const page = await browser.newPage({ viewport: SHOT_VIEWPORT });
241
+ await page.goto('http://127.0.0.1:' + PORT + '/', { waitUntil: 'load', timeout: SHOT_NAV_TIMEOUT_MS });
242
+ await page.waitForTimeout(SHOT_SETTLE_MS);
243
+ const state = await page.evaluate((sel) => ({
244
+ root: !!document.querySelector(sel),
245
+ buttons: document.querySelector(sel) ? document.querySelector(sel).querySelectorAll('button').length : 0,
246
+ }), SHOT_ROOT_SELECTOR);
247
+ console.log('[shot] 预览渲染:', JSON.stringify(state));
248
+ if (shotPath) await page.screenshot({ path: shotPath });
249
+ await browser.close();
250
+ if (shotPath) console.log('[shot] 截图已存:', shotPath);
251
+ } catch (e) {
252
+ console.log('[shot] playwright 自检跳过(', e.message?.slice(0, SHOT_ERR_SNIPPET), ')——真实浏览器打开即可预览');
253
+ }
254
+ }
255
+
256
+ server.listen(PORT, '0.0.0.0', async () => {
257
+ const token = resolveToken();
258
+ console.log('╔══════════════════════════════════════════════════╗');
259
+ console.log('║ ' + PROJECT_LABEL.padEnd(BANNER_WIDTH) + '║');
260
+ console.log('╚══════════════════════════════════════════════════╝');
261
+ console.log(' 预览页: http://127.0.0.1:' + PORT + '/');
262
+ console.log(' 后端: ' + TARGET + '(' + PROXY_PREFIX + '* 转发,数据真实)');
263
+ console.log(' token: ' + (token ? '已自动获取(' + token.slice(0, 8) + '…)' : '⚠ 未找到,预览将不可用(用 --token 指定)'));
264
+ console.log(' 停止: Ctrl+C 或 start.sh stop');
265
+ await openBrowser();
266
+ });
267
+ /**
268
+ * --local 模式:fork 一次性子进程执行**工作区当前的插件代码**,把 {status, body} 回写给浏览器。
269
+ *
270
+ * 为什么每次请求都 fork:子进程冷启动会让整个插件模块图(含 handlers/*、git/* 等子模块)都
271
+ * 从磁盘重新加载,天然绕开 ESM 模块缓存——于是「改代码 → 刷新页面」立即生效,
272
+ * 既不用重启 DSH 宿主,也不用重启本预览服务。代价是每请求约 100ms 进程启动开销。
273
+ */
274
+ function serveLocalApi(req, res) {
275
+ const t0 = Date.now();
276
+ const child = spawn(process.execPath, [join(SCRIPT_DIR, LOCAL_RUNNER)], { stdio: ['pipe', 'pipe', 'pipe'] });
277
+ let out = '';
278
+ let err = '';
279
+ let settled = false;
280
+ const finish = (status, body, tag) => {
281
+ if (settled) return;
282
+ settled = true;
283
+ if (!res.writableEnded) {
284
+ res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-cache' });
285
+ res.end(typeof body === 'string' ? body : JSON.stringify(body));
286
+ }
287
+ console.log(`[local] ${req.method} ${req.url} → ${status} ${Date.now() - t0}ms${tag ? ' ' + tag : ''}`);
288
+ };
289
+ const timer = setTimeout(() => {
290
+ try { child.kill('SIGKILL'); } catch { /* 已退出 */ }
291
+ finish(504, { ok: false, error: `本地执行超时(${LOCAL_TIMEOUT_MS}ms)` }, 'timeout');
292
+ }, LOCAL_TIMEOUT_MS);
293
+ child.stdout.on('data', (d) => { out += d; });
294
+ child.stderr.on('data', (d) => { err += d; });
295
+ child.on('error', (e) => { clearTimeout(timer); finish(500, { ok: false, error: '本地执行器启动失败: ' + (e?.message || e) }); });
296
+ child.on('close', (code) => {
297
+ clearTimeout(timer);
298
+ if (settled) return;
299
+ if (code !== 0) { finish(500, { ok: false, error: `本地执行器退出码 ${code}${err ? ':' + err.slice(0, 300) : ''}` }); return; }
300
+ let parsed;
301
+ try { parsed = JSON.parse(out); } catch { finish(500, { ok: false, error: '本地执行器输出非 JSON:' + out.slice(0, 200) }); return; }
302
+ finish(parsed.status || 200, parsed.body ?? {});
303
+ });
304
+ child.stdin.end(JSON.stringify({ method: req.method, url: req.url, headers: req.headers, workspaceRoot: LOCAL_WORKSPACE }));
305
+ }
@@ -0,0 +1,123 @@
1
+ /**
2
+ * preview.html 数据自动生成器(新增——此前 __SLOTS__/__FAKE__ 数据手工维护,
3
+ * 每次新增规则槽位都要手改 33K 行的 JSON 串,漏改即 test-rule-slots-render 失败)。
4
+ *
5
+ * 数据契约:与 test/test-rule-slots-render.mjs 的「预览页:槽位数据取自真实规则文件」
6
+ * 断言一致——preview.html 的 __SLOTS__(槽位 meta)与 __FAKE__._order(槽位顺序)
7
+ * 必须等于真实 listRuleSlots() 的结果。本脚本从同一数据源(lib/app/handlers/meta.js
8
+ * 的 listRuleSlots)生成,保证永远一致。
9
+ *
10
+ * 命令:
11
+ * node scripts/gen-preview.mjs # 打印将生成的 __SLOTS__/__FAKE__(不写盘)
12
+ * node scripts/gen-preview.mjs --write # 同步 preview.html(替换两段数据)
13
+ * node scripts/gen-preview.mjs check # 查漂移:preview.html 与真实数据不一致则报错
14
+ *
15
+ * 什么时候跑:新增/删除/改名规则槽位(audit-rules-*.yml)后跑 --write;
16
+ * 提交前跑 check 防漏(门禁不拦,warning 提示)。
17
+ */
18
+ import { readFileSync, writeFileSync, existsSync } from 'node:fs';
19
+ import { spawnSync } from 'node:child_process';
20
+ import { join, dirname } from 'node:path';
21
+ import { fileURLToPath } from 'node:url';
22
+ import { listRuleSlots } from '../lib/app/handlers/meta.js';
23
+
24
+ const __dirname = dirname(fileURLToPath(import.meta.url));
25
+ const ROOT = join(__dirname, '..');
26
+ const PREVIEW = join(ROOT, 'assets', 'preview.html');
27
+
28
+ /** 从真实规则文件生成槽位数据(与测试同一数据源)。 */
29
+ export function buildPreviewSlotData() {
30
+ const real = listRuleSlots(undefined, [], null);
31
+ const realOrder = real.order.filter((s) => s !== 'template');
32
+ const slotsJson = JSON.stringify(real.meta);
33
+ // __FAKE__ 保留原快照字段,只更新 _order(新槽位追加/顺序对齐真实生效顺序)
34
+ const fake = { _order: realOrder };
35
+ return { slotsJson, order: realOrder, fakeJson: JSON.stringify(fake), meta: real.meta, realOrder };
36
+ }
37
+
38
+ /** 读当前 preview.html 里的 __SLOTS__/__FAKE__(供 check 比对)。 */
39
+ export function readPreviewSlotData(html = readPreviewHtml()) {
40
+ const metaMatch = html.match(/window\.__SLOTS__ = (\{.*?\});/s);
41
+ const fakeMatch = html.match(/window\.__FAKE__ = (\{.*?\});/s);
42
+ if (!metaMatch || !fakeMatch) return null;
43
+ try {
44
+ return {
45
+ meta: JSON.parse(metaMatch[1]),
46
+ order: JSON.parse(fakeMatch[1])._order || [],
47
+ };
48
+ } catch { return null; }
49
+ }
50
+
51
+ /**
52
+ * 预览页不入库(见 .gitignore):缺失时先跑一次生成器,保证「漂移门禁 + 单元测试」
53
+ * 在**新克隆 / CI** 上同样可用(否则 readPreviewHtml 返回空 ⇒ 测试以“缺失”失败)。
54
+ * 只在首次缺失时尝试一次,避免每次调用都生成;生成失败按空处理并让调用方给出明确错误。
55
+ */
56
+ let previewEnsureTried = false;
57
+ export function ensurePreviewHtml() {
58
+ if (existsSync(PREVIEW)) return { ok: true, generated: false };
59
+ if (!previewEnsureTried) {
60
+ previewEnsureTried = true;
61
+ const gen = join(ROOT, 'scripts', 'preview-gen.mjs');
62
+ if (existsSync(gen)) {
63
+ const r = spawnSync(process.execPath, [gen], { cwd: ROOT, timeout: 300000, encoding: 'utf8' });
64
+ if (r.status !== 0) {
65
+ return { ok: false, generated: true, error: `生成 assets/preview.html 失败:${String(r.stderr || r.stdout || '').slice(-400)}` };
66
+ }
67
+ }
68
+ }
69
+ return { ok: existsSync(PREVIEW), generated: true };
70
+ }
71
+
72
+ /** 读预览页正文(缺失则先自动生成一次)。导出供测试复用,避免测试直接 readFileSync 抛错。 */
73
+ export function readPreviewHtmlText() {
74
+ if (!existsSync(PREVIEW)) {
75
+ const e = ensurePreviewHtml();
76
+ if (!e.ok) return '';
77
+ }
78
+ return readFileSync(PREVIEW, 'utf8');
79
+ }
80
+
81
+ function readPreviewHtml() {
82
+ return readPreviewHtmlText();
83
+ }
84
+
85
+ /** 生成(打印)或写盘。 */
86
+ export function genPreview({ write = false } = {}) {
87
+ const slotData = buildPreviewSlotData();
88
+ const html = readPreviewHtml();
89
+ if (!html) return { ok: false, error: `preview.html 缺失: ${PREVIEW}` };
90
+ const cur = readPreviewSlotData(html);
91
+ const drift = cur && (JSON.stringify(cur.meta) !== slotData.slotsJson || JSON.stringify(cur.order) !== slotData.fakeJson);
92
+ if (write) {
93
+ const out = html
94
+ .replace(/window\.__SLOTS__ = \{.*?\};/s, 'window.__SLOTS__ = ' + slotData.slotsJson + ';')
95
+ .replace(/window\.__FAKE__ = \{.*?\};/s, 'window.__FAKE__ = ' + slotData.fakeJson + ';');
96
+ writeFileSync(PREVIEW, out, 'utf8');
97
+ }
98
+ return { ok: true, write, drift, order: slotData.realOrder, metaCount: Object.keys(slotData.meta).length };
99
+ }
100
+
101
+ /** check:preview.html 数据与真实规则文件是否漂移。 */
102
+ export function checkPreviewDrift() {
103
+ const html = readPreviewHtml();
104
+ if (!html) return { ok: false, drift: true, message: `preview.html 缺失: ${PREVIEW}` };
105
+ const cur = readPreviewSlotData(html);
106
+ if (!cur) return { ok: false, drift: true, message: 'preview.html 缺少 __SLOTS__/__FAKE__ 数据段' };
107
+ const slotData = buildPreviewSlotData();
108
+ const keysDrift = JSON.stringify(Object.keys(cur.meta).sort()) !== JSON.stringify(Object.keys(slotData.meta).sort());
109
+ const orderDrift = JSON.stringify(cur.order) !== JSON.stringify(slotData.realOrder);
110
+ const nameDrift = slotData.realOrder.some((s) => cur.meta[s]?.name !== slotData.meta[s]?.name);
111
+ if (keysDrift || orderDrift || nameDrift) {
112
+ const msg = `preview.html 槽位数据与真实规则文件漂移:`
113
+ + `${keysDrift ? `槽位集合 ${Object.keys(cur.meta).length} vs ${Object.keys(slotData.meta).length};` : ''}`
114
+ + `${orderDrift ? '顺序不一致;' : ''}${nameDrift ? '显示名不一致;' : ''}`
115
+ + `运行 node scripts/gen-preview.mjs --write 重新生成`;
116
+ return { ok: false, drift: true, message: msg };
117
+ }
118
+ return { ok: true, drift: false, message: `preview.html 槽位数据与真实一致(${slotData.realOrder.length} 槽位)` };
119
+ }
120
+
121
+ // (合并 2026-10-13)本文件原来的 CLI 入口(`node scripts/gen-preview.mjs [check|--write]`)已并入
122
+ // 统一入口 scripts/preview-gen.mjs 的模式分发(check / --data-only);本文件只保留纯函数导出,
123
+ // 供统一入口与 test-rule-slots-render.mjs 复用。原 CLI 行为(打印/写盘/退出码)不变。
@@ -0,0 +1,47 @@
1
+ /**
2
+ * 探针:「重新检测」按钮链路实测(联网,需服务已启动)。
3
+ * 运行:node test/probe-recheck-live.mjs
4
+ */
5
+ const BASE = process.env.DSH_PROBE_BASE || 'http://127.0.0.1:8090';
6
+ const ORIGIN = 'http://127.0.0.1:30801';
7
+ // 超时兜底:/account-check 内部要联网校验 token 与 SSH,服务端异常或网络悬挂时
8
+ // 无超时的 fetch 会**永久挂起**,探针既不报错也不退出(只能 Ctrl+C),
9
+ // 排查时看不到任何有用信息。60s 与 lib/git/api.js 的网络出口默认值一致。
10
+ const TIMEOUT_MS = 60_000;
11
+ const ACCOUNT_CHECK_PATH = '/api/git-push/account-check'; // 账号状态检测端点
12
+ const post = (p, b) => fetch(BASE + p, {
13
+ method: 'POST',
14
+ headers: { 'Content-Type': 'application/json', Origin: ORIGIN },
15
+ body: JSON.stringify(b),
16
+ signal: AbortSignal.timeout(TIMEOUT_MS),
17
+ }).then(r => r.json());
18
+ const get = (p) => fetch(BASE + p, {
19
+ headers: { Origin: ORIGIN },
20
+ signal: AbortSignal.timeout(TIMEOUT_MS),
21
+ }).then(r => r.json());
22
+
23
+ console.log('══ 「重新检测」按钮链路实测 ══\n');
24
+
25
+ console.log('① 按钮行为 POST /account-check(与 client.js recheckAccount 一致)');
26
+ const resp = await post(ACCOUNT_CHECK_PATH, { checkSsh: true, confirm: false });
27
+ const ts = resp.tokenStatus || {}, ss = resp.sshStatus || {};
28
+ const tv = ts.valid ? '✅ 有效' : (ts.timeout ? '⏳ 超时未测成(不是失效)' : '❌ 无效');
29
+ const sv = ss.valid ? '✅ 有效' : (ss.timeout ? '⏳ 超时未测成' : '❌ 无效');
30
+ console.log(' Token:', tv, ts.login ? `(${ts.login})` : '');
31
+ console.log(' SSH :', sv, ss.login ? `(${ss.login})` : '');
32
+
33
+ console.log('\n② 写回后读回(页面渲染依据)');
34
+ const s = await get('/api/git-push/account-status');
35
+ console.log(' ' + (s.block || '').split('\n').join('\n '));
36
+ console.log('\n 字段: tokenTimeout=' + s.tokenStatus?.timeout, '| sshTimeout=' + s.sshStatus?.timeout);
37
+
38
+ console.log('\n③ 防抖验证:连发两次(第二次应被前端忽略,后端仍应稳定)');
39
+ const [r1, r2] = await Promise.all([
40
+ post(ACCOUNT_CHECK_PATH, { checkSsh: false, confirm: false }),
41
+ post(ACCOUNT_CHECK_PATH, { checkSsh: false, confirm: false }),
42
+ ]);
43
+ console.log(' 两次返回 tokenStatus.valid:', r1.tokenStatus?.valid, '/', r2.tokenStatus?.valid);
44
+ console.log(' (前端有 accountLoading 防抖,真实点击不会连发)');
45
+
46
+ console.log('\n══ 结论 ══');
47
+ console.log(ts.valid || ss.valid ? '✅ 按钮有效:在线校验成功并写回状态' : '⏳ 本次未测成(网络超时),状态已如实标注 timeout=true');