dsh-git-push 2.20.19 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (196) hide show
  1. package/README.md +3 -2
  2. package/cli-tool.mjs +2 -4
  3. package/cli.mjs +7 -1
  4. package/lib/app/apply.js +4 -4
  5. package/lib/app/command-registry.js +22 -17
  6. package/lib/app/handlers/meta.js +2 -2
  7. package/lib/app/handlers/preprocess.js +107 -0
  8. package/lib/app/handlers/repo-actions.js +2 -2
  9. package/lib/app/http-handlers.js +13 -42
  10. package/lib/app/index.js +2 -1
  11. package/lib/app/inject-text.js +3 -3
  12. package/lib/app/preprocess-client.js +136 -0
  13. package/lib/app/repo-ownership.js +1 -1
  14. package/lib/app/schema.js +3 -3
  15. package/lib/app/severity.js +14 -0
  16. package/lib/app/slash-commands.js +5 -164
  17. package/lib/app/tool-call.js +73 -144
  18. package/lib/cli/commands-preprocess.mjs +74 -0
  19. package/lib/cli/commands-tool.mjs +3 -2
  20. package/lib/cli/commands-vcs.mjs +4 -4
  21. package/lib/cli/shared.mjs +35 -9
  22. package/lib/commit-push/pre-commit-engine.js +57 -10
  23. package/lib/commit-push.js +71 -27
  24. package/lib/{exempt/index.js → git/exempt-markers.js} +8 -1
  25. package/lib/git/ignore.js +1 -1
  26. package/lib/git/repos.js +2 -2
  27. package/lib/git/sensitive.js +1 -1
  28. package/lib/npm/publish.js +20 -5
  29. package/lib/plugin/auto-push.js +2 -2
  30. package/lib/preprocess/providers.js +191 -0
  31. package/lib/self/index.js +1 -1
  32. package/lib/skip-dirs.js +14 -55
  33. package/package.json +29 -37
  34. package/scripts/build-client.mjs +2 -0
  35. package/scripts/check.mjs +4 -2
  36. package/scripts/local-registry.mjs +2 -1
  37. package/cli-audit.mjs +0 -141
  38. package/lib/app/audit-api.js +0 -173
  39. package/lib/app/handlers/audit.js +0 -150
  40. package/lib/app/host-doc-checks.js +0 -25
  41. package/lib/app/scope-check.js +0 -69
  42. package/lib/ast/brace.js +0 -120
  43. package/lib/ast/callgraph.js +0 -135
  44. package/lib/ast/code-lines.js +0 -175
  45. package/lib/ast/consts.js +0 -12
  46. package/lib/ast/control-flow.js +0 -470
  47. package/lib/ast/credential.js +0 -315
  48. package/lib/ast/dataflow.js +0 -391
  49. package/lib/ast/dup-code.js +0 -165
  50. package/lib/ast/fs-hotspots.js +0 -154
  51. package/lib/ast/index.js +0 -38
  52. package/lib/ast/io-risk-const.js +0 -95
  53. package/lib/ast/io-risk-fn.js +0 -208
  54. package/lib/ast/io-risk-loop.js +0 -308
  55. package/lib/ast/io-risk.js +0 -314
  56. package/lib/ast/lang.js +0 -156
  57. package/lib/ast/line-count.js +0 -52
  58. package/lib/ast/magic-number.js +0 -272
  59. package/lib/ast/naming.js +0 -292
  60. package/lib/ast/perf.js +0 -488
  61. package/lib/ast/scope-collisions.js +0 -228
  62. package/lib/ast/scope.js +0 -241
  63. package/lib/ast/shell.js +0 -131
  64. package/lib/ast/size.js +0 -448
  65. package/lib/ast/symbol-index.js +0 -399
  66. package/lib/ast/tokenizer.js +0 -421
  67. package/lib/ast/treesitter.js +0 -413
  68. package/lib/audit/analysis-coverage.js +0 -98
  69. package/lib/audit/audit-file.js +0 -205
  70. package/lib/audit/auditignore-rules.js +0 -148
  71. package/lib/audit/checks.js +0 -17
  72. package/lib/audit/client-entry.js +0 -93
  73. package/lib/audit/collector.js +0 -610
  74. package/lib/audit/ext-runner.js +0 -80
  75. package/lib/audit/file-context.js +0 -391
  76. package/lib/audit/finding.js +0 -101
  77. package/lib/audit/gitignore-match.js +0 -113
  78. package/lib/audit/glob.js +0 -63
  79. package/lib/audit/history-report.js +0 -100
  80. package/lib/audit/history.js +0 -126
  81. package/lib/audit/ignore-blind.js +0 -102
  82. package/lib/audit/index.js +0 -33
  83. package/lib/audit/orchestrate.js +0 -672
  84. package/lib/audit/public.js +0 -24
  85. package/lib/audit/repo-level.js +0 -30
  86. package/lib/audit/report-yaml.js +0 -90
  87. package/lib/audit/scope-policy.js +0 -110
  88. package/lib/audit/slot.js +0 -66
  89. package/lib/audit-rules/audit-rules-comment.yml +0 -199
  90. package/lib/audit-rules/audit-rules-cpp.yml +0 -114
  91. package/lib/audit-rules/audit-rules-csharp.yml +0 -82
  92. package/lib/audit-rules/audit-rules-docs.yml +0 -32
  93. package/lib/audit-rules/audit-rules-dsh.yml +0 -177
  94. package/lib/audit-rules/audit-rules-filehealth.yml +0 -42
  95. package/lib/audit-rules/audit-rules-folder.yml +0 -99
  96. package/lib/audit-rules/audit-rules-frontend.yml +0 -335
  97. package/lib/audit-rules/audit-rules-go.yml +0 -103
  98. package/lib/audit-rules/audit-rules-i18n.yml +0 -45
  99. package/lib/audit-rules/audit-rules-java.yml +0 -105
  100. package/lib/audit-rules/audit-rules-nodejs.yml +0 -662
  101. package/lib/audit-rules/audit-rules-npm.yml +0 -187
  102. package/lib/audit-rules/audit-rules-paths.yml +0 -98
  103. package/lib/audit-rules/audit-rules-performance.yml +0 -245
  104. package/lib/audit-rules/audit-rules-php.yml +0 -101
  105. package/lib/audit-rules/audit-rules-private.yml +0 -24
  106. package/lib/audit-rules/audit-rules-python.yml +0 -106
  107. package/lib/audit-rules/audit-rules-robustness.yml +0 -31
  108. package/lib/audit-rules/audit-rules-rust.yml +0 -109
  109. package/lib/audit-rules/audit-rules-structure.yml +0 -158
  110. package/lib/audit-rules/audit-rules-swift.yml +0 -99
  111. package/lib/audit-rules/audit-rules-template.yml +0 -108
  112. package/lib/audit-ui-sdk/contract.js +0 -117
  113. package/lib/audit-ui-sdk/index.js +0 -17
  114. package/lib/checks/button-bind.js +0 -347
  115. package/lib/checks/common.js +0 -170
  116. package/lib/checks/credential-file.js +0 -43
  117. package/lib/checks/dataflow.js +0 -40
  118. package/lib/checks/dispatch.js +0 -117
  119. package/lib/checks/dup-code.js +0 -69
  120. package/lib/checks/dup-const.js +0 -232
  121. package/lib/checks/file-health.js +0 -150
  122. package/lib/checks/filter.js +0 -137
  123. package/lib/checks/folder.js +0 -173
  124. package/lib/checks/fs-scanner.js +0 -57
  125. package/lib/checks/hardcoded-path.js +0 -98
  126. package/lib/checks/index.js +0 -49
  127. package/lib/checks/io.js +0 -66
  128. package/lib/checks/magic-number.js +0 -42
  129. package/lib/checks/npm-json.js +0 -273
  130. package/lib/checks/private.js +0 -64
  131. package/lib/checks/regex.js +0 -298
  132. package/lib/checks/scope-collision.js +0 -68
  133. package/lib/checks/semantic.js +0 -134
  134. package/lib/checks/structural.js +0 -281
  135. package/lib/cli/commands-audit.mjs +0 -142
  136. package/lib/cli/commands-doc.mjs +0 -127
  137. package/lib/client-parts/audit/audit.js +0 -301
  138. package/lib/exempt/tool.js +0 -198
  139. package/lib/git/module-splitter.js +0 -47
  140. package/lib/link-check/index.js +0 -187
  141. package/lib/lint-adapter/detect.js +0 -161
  142. package/lib/lint-adapter/index.js +0 -50
  143. package/lib/lint-adapter/runner.js +0 -133
  144. package/lib/preprocess/audit.js +0 -98
  145. package/lib/preprocess/index.js +0 -78
  146. package/lib/rule/compilers/credential.js +0 -62
  147. package/lib/rule/compilers/dataflow.js +0 -38
  148. package/lib/rule/compilers/file-health.js +0 -75
  149. package/lib/rule/compilers/frontend.js +0 -86
  150. package/lib/rule/compilers/func.js +0 -35
  151. package/lib/rule/compilers/helpers.js +0 -71
  152. package/lib/rule/compilers/index.js +0 -29
  153. package/lib/rule/compilers/link-semantic.js +0 -45
  154. package/lib/rule/compilers/list-kinds.js +0 -12
  155. package/lib/rule/compilers/numeric-kinds.js +0 -73
  156. package/lib/rule/compilers/regex.js +0 -78
  157. package/lib/rule/compilers/structure.js +0 -107
  158. package/lib/rule/compilers.js +0 -17
  159. package/lib/rule/homoglyph.js +0 -45
  160. package/lib/rule/loader.js +0 -274
  161. package/lib/rule/registry.js +0 -122
  162. package/lib/rule/scope.js +0 -67
  163. package/lib/score/docs-score.js +0 -166
  164. package/lib/score/index.js +0 -234
  165. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  166. package/scripts/audit-ext/_example-readme-present.mjs +0 -34
  167. package/scripts/audit-ext/dsh-inject-declarations.mjs +0 -209
  168. package/scripts/audit-ext/variable-min-length.mjs +0 -102
  169. package/scripts/audit-gate.mjs +0 -235
  170. package/scripts/audit-runner.mjs +0 -35
  171. package/scripts/audit-runtime-check.mjs +0 -129
  172. package/scripts/browser-page-probe.mjs +0 -271
  173. package/scripts/check-js-scope.mjs +0 -87
  174. package/scripts/clean-date-comments.py +0 -102
  175. package/scripts/cpu-sample.mjs +0 -188
  176. package/scripts/doc-drift.mjs +0 -200
  177. package/scripts/hot-path-probe-cjs.cjs +0 -71
  178. package/scripts/hot-path-probe-fs-shim.mjs +0 -28
  179. package/scripts/hot-path-probe-fsp-shim.mjs +0 -31
  180. package/scripts/hot-path-probe.mjs +0 -153
  181. package/scripts/module-splitter.py +0 -800
  182. package/scripts/picker-repro.mjs +0 -115
  183. package/scripts/platform-scan.mjs +0 -168
  184. package/scripts/probe-recheck.mjs +0 -47
  185. package/scripts/rename-locator.mjs +0 -97
  186. package/scripts/rule-switch.mjs +0 -97
  187. package/scripts/rules-solo-audit.mjs +0 -173
  188. package/scripts/scan-file-io.mjs +0 -717
  189. package/scripts/scan-fs-hotspots.mjs +0 -107
  190. package/scripts/symbol-index.mjs +0 -85
  191. package/scripts/verify-prestep.mjs +0 -100
  192. package/skills/dev/audit-rule-authoring.md +0 -58
  193. package/skills/guide/guide-audit.md +0 -270
  194. /package/lib/{audit → app}/ownership.js +0 -0
  195. /package/lib/app/{schema-audit.js → schema-preprocess.js} +0 -0
  196. /package/lib/{audit-defaults.js → git/defaults.js} +0 -0
@@ -1,129 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * 三层审计 · L3 运行时检测
4
- *
5
- * 职责:兜住静态盲区——L2(AST 同函数数据流)看不到的跨文件引用、闭包捕获、
6
- * 异步时序(清空在 setTimeout/await 之后、访问在回调里)。本脚本用**运行时实测**
7
- * 确认「清空后访问」是否真的拿到 undefined / 空值。
8
- *
9
- * 用法:
10
- * node scripts/audit-runtime-check.mjs <被测 js 文件> [--obj 对象名] [--verbose]
11
- * node scripts/audit-runtime-check.mjs --all <目录> # 目录内所有 js 文件逐个测
12
- *
13
- * 原理(在测试沙箱里构造,不改被测文件):
14
- * ① 动态 import 被测模块(file:// URL),拿到模块导出的对象;
15
- * ② 若模块顶层有「清空动作」(clear()/reset()/=[]/=null/length=0)对应的方法,
16
- * 依次调用:先调清空方法,再调访问方法(get/first/peek/[0]),捕获返回值;
17
- * ③ 返回值是 undefined / null / 空数组 → 命中(L3 确认);否则不命中(L2 疑点排除)。
18
- *
19
- * 局限(如实标注):
20
- * - 只能测「模块导出」的入口;内部闭包/未导出的状态只能靠测试钩子;
21
- * - 依赖被测文件能安全 import(副作用不能炸进程,如连真 API/写文件);
22
- * - 异步时序无法在纯同步沙箱复现——异步场景建议用 node:test 写专门用例。
23
- *
24
- * 退出码:0 = 全部通过(无运行时命中);1 = 存在运行时命中(L3 确认的 bug);
25
- * 2 = 无法检测(文件不可 import / 无导出对象 / 用法错误)。
26
- */
27
-
28
- import { pathToFileURL } from 'node:url';
29
- import { statSync, readdirSync } from 'node:fs';
30
- import { join, resolve, basename } from 'node:path';
31
-
32
- const args = process.argv.slice(2);
33
-
34
- /** 解析 CLI 参数。 */
35
- function parseArgs() {
36
- const opts = { files: [], obj: null, verbose: false, all: false };
37
- for (let i = 0; i < args.length; i++) {
38
- const a = args[i];
39
- if (a === '--obj') { opts.obj = args[++i] || null; }
40
- else if (a === '--verbose') opts.verbose = true;
41
- else if (a === '--all') opts.all = true;
42
- else opts.files.push(a);
43
- }
44
- return opts;
45
- }
46
-
47
- /** 收集目录下所有 .js 文件(一层)。 */
48
- function collectJs(dir) {
49
- try {
50
- const st = statSync(dir);
51
- if (!st.isDirectory()) return [dir];
52
- return readdirSync(dir).filter((n) => n.endsWith('.js')).map((n) => join(dir, n)); // dsh-skip-residue(自检脚本一次性收集)
53
- } catch { return []; }
54
- }
55
-
56
- /**
57
- * 对单个文件做运行时检测。
58
- * @returns {Promise<{file:string, hits:Array<{op:string, result:string}>, error?:string}>}
59
- */
60
- async function runFile(file, obj) {
61
- const out = { file, hits: [], error: null };
62
- let mod;
63
- try {
64
- mod = await import(pathToFileURL(resolve(file)).href);
65
- } catch (e) {
66
- out.error = `无法 import(${String(e?.message || e).split('\n')[0]})`;
67
- return out;
68
- }
69
- const exp = mod?.default ?? mod;
70
- const cands = [];
71
- // 候选对象:指定 obj → 导出里找;否则导出里「看起来像容器」的值(对象/数组/Map/Set)
72
- for (const [name, val] of Object.entries(exp || {})) {
73
- if (typeof val !== 'object' || val === null) continue;
74
- if (obj && name !== obj) continue;
75
- cands.push({ name, val });
76
- }
77
- if (!cands.length) {
78
- out.error = '无候选容器对象(导出里没有对象/数组/Map/Set)';
79
- return out;
80
- }
81
- for (const { name, val } of cands) {
82
- const clearOps = ['clear', 'reset', 'flush', 'purge'].filter((m) => typeof val?.[m] === 'function');
83
- const accessOps = ['get', 'first', 'last', 'peek', 'head', 'at', 'shift', 'pop'].filter((m) => typeof val?.[m] === 'function');
84
- if (!clearOps.length) continue; // 无清空方法 → 本对象不适用
85
- for (const clearOp of clearOps) {
86
- let clearOk = true;
87
- try { val[clearOp](); } catch (e) { clearOk = false; out.hits.push({ op: `${name}.${clearOp}()`, result: `调用抛错:${String(e?.message || e).split('\n')[0]}` }); }
88
- if (!clearOk) continue;
89
- for (const a of accessOps) {
90
- let accessResult;
91
- try { accessResult = val[a](); } catch (e) { accessResult = `抛错:${String(e?.message || e).split('\n')[0]}`; }
92
- const isBad = accessResult === undefined || accessResult === null || (Array.isArray(accessResult) && accessResult.length === 0);
93
- if (isBad) out.hits.push({ op: `${name}.${clearOp}() 后 ${name}.${a}()`, result: `${typeof accessResult === 'object' ? JSON.stringify(accessResult) : String(accessResult)}` });
94
- }
95
- }
96
- }
97
- return out;
98
- }
99
-
100
- /** 主流程。 */
101
- async function main() {
102
- const opts = parseArgs();
103
- if (!opts.files.length) {
104
- console.error('用法: node scripts/audit-runtime-check.mjs <js 文件> [--obj 对象名] [--verbose]');
105
- console.error(' node scripts/audit-runtime-check.mjs --all <目录>');
106
- process.exitCode = 2;
107
- return;
108
- }
109
- const files = opts.all ? opts.files.flatMap((d) => collectJs(d)) : opts.files;
110
- let confirmed = 0;
111
- for (const f of files) {
112
- const r = await runFile(f, opts.obj);
113
- if (r.error) {
114
- console.log(`— ${f}: ${r.error}`);
115
- continue;
116
- }
117
- if (r.hits.length) {
118
- confirmed++;
119
- console.log(`✗ ${f} —— L3 确认「清空后访问」命中 ${r.hits.length} 处:`);
120
- for (const hit of r.hits) console.log(` ${hit.op} → ${hit.result}`);
121
- } else if (opts.verbose) {
122
- console.log(`✔ ${f}: 无运行时命中`);
123
- }
124
- }
125
- console.log(`\nL3 运行时检测完成:${confirmed} 个文件确认命中`);
126
- if (confirmed > 0) process.exitCode = 1;
127
- }
128
-
129
- await main();
@@ -1,271 +0,0 @@
1
- #!/usr/bin/env node
2
- // 浏览器页面探针(无头)——读「网页实际渲染出来的内容」+ 抓前端运行时错误。
3
- //
4
- // 用途(为什么需要它):
5
- // curl 只能拿到原始 HTML/响应,看不到 JS 渲染后的页面与前端异常。DSH 插件的前端
6
- // entry 激活失败时,页面只显示 `web boot: 1 entry did not activate` / `<插件>: failed`,
7
- // 真实异常只在浏览器控制台——本脚本把「渲染后文本 + console/pageerror」一起抓出来。
8
- //
9
- // 设计约束(硬要求):
10
- // - **零硬编码路径**:浏览器/运行库/字体/playwright 全部按
11
- // 「环境变量 → 自动探测」解析,探测结果打印出来可核对。
12
- // - **零必需依赖**:解析不到 playwright 时自动降级为 chrome `--dump-dom` 模式
13
- // (仍能读渲染后文本,只是拿不到 console 错误与点击能力)。
14
- //
15
- // 用法:
16
- // node scripts/browser-page-probe.mjs --url "http://127.0.0.1:30901/?token=XXX"
17
- // node scripts/browser-page-probe.mjs --port 30901 --token XXX --click Settings --click "Git 提交推送"
18
- // node scripts/browser-page-probe.mjs --url ... --out /tmp/page.txt --wait 15000
19
- //
20
- // 环境变量(可选,用于显式指定;不设则自动探测):
21
- // DSH_PAGE_SHARED_ROOT 共享根目录(其下含 pwviewer/ chromium-libs/ fonts/)
22
- // DSH_PAGE_CHROME 浏览器可执行文件
23
- // DSH_PAGE_LIBS 运行库目录(多个用 : 分隔,喂给 LD_LIBRARY_PATH)
24
- // DSH_PAGE_FONTCONF fontconfig 配置文件(中文字体,避免 CJK 渲染崩溃)
25
- // DSH_PAGE_PWROOT 含 node_modules/playwright 的目录
26
-
27
- import { existsSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
28
- import { dirname, join, resolve } from 'node:path';
29
- import { spawnSync } from 'node:child_process';
30
- import { createRequire } from 'node:module';
31
-
32
- // 解析命令行参数(--k v / --flag)。
33
- function parseArgv(argv) {
34
- const out = { click: [] };
35
- for (let i = 0; i < argv.length; i += 1) {
36
- const a = argv[i];
37
- if (!a.startsWith('--')) continue;
38
- const key = a.slice(2);
39
- const val = argv[i + 1] && !argv[i + 1].startsWith('--') ? argv[(i += 1)] : true;
40
- if (key === 'click') out.click.push(String(val));
41
- else out[key] = val;
42
- }
43
- return out;
44
- }
45
-
46
- const args = parseArgv(process.argv.slice(2));
47
- const WAIT_MS = Number(args.wait || 12000);
48
- /** 打印页面文本时的截断长度(避免整页文本把终端/日志刷爆)。 */
49
- const TEXT_PRINT_MAX = 6000;
50
- /** 无头浏览器视口尺寸(默认 1440×1000,够桌面布局;窄屏可另传参)。 */
51
- const VIEWPORT_W = 1440;
52
- const VIEWPORT_H = 1000;
53
- /** 每次点击后等待页面稳定的毫秒数(等前端异步渲染完成)。 */
54
- const CLICK_SETTLE_MS = 5000;
55
- const OUT = String(args.out || '');
56
- const URL = args.url
57
- ? String(args.url)
58
- : `http://127.0.0.1:${args.port || 30801}/?token=${args.token || ''}`;
59
-
60
- // 有界目录探测:在候选根下找子目录名。
61
- // 必须限深(maxDepth)——共享根下挂着大量卷/套件目录,无界遍历会扫全盘卡死
62
- // (实测:早期全盘 find 找 chromium 既慢又命中错根目录)。找到即返回,不做全量收集。
63
- // 只按「目录名」在候选根下找,不写任何绝对路径。
64
- // @param {string} root 候选根目录
65
- // @param {string[]} names 目标子目录名(如 ['pwviewer'] / ['chromium-libs'])
66
- // @param {number} [maxDepth] 最大下探层数(默认 4,防大目录树拖慢)
67
- // @returns {string|undefined} 命中目录的绝对路径
68
- function findDirUnder(root, names, maxDepth = 4) {
69
- const queue = [[root, 0]];
70
- while (queue.length) {
71
- const [dir, depth] = queue.shift();
72
- let entries = [];
73
- try { entries = readdirSync(dir, { withFileTypes: true }); } catch { continue; }
74
- for (const e of entries) {
75
- if (!e.isDirectory() && !e.isSymbolicLink()) continue;
76
- const full = join(dir, e.name);
77
- if (names.includes(e.name)) return full;
78
- if (depth < maxDepth && !e.name.startsWith('.')) queue.push([full, depth + 1]);
79
- }
80
- }
81
- return undefined;
82
- }
83
-
84
- // 候选共享根:环境变量 → DSH_HOME 上溯 → 常见共享挂载点(模式化,不写死绝对路径)。
85
- function sharedRootCandidates() {
86
- const list = [];
87
- if (process.env.DSH_PAGE_SHARED_ROOT) list.push(resolve(process.env.DSH_PAGE_SHARED_ROOT));
88
- if (process.env.DSH_HOME) {
89
- let dir = resolve(process.env.DSH_HOME);
90
- for (let i = 0; i < 6; i += 1) {
91
- list.push(dir);
92
- dir = dirname(dir);
93
- }
94
- }
95
- // 模式化候选:<卷>/VirtualDSM/* 与 <卷>/@appdata/*/all_shares/*/*(本机虚拟化共享目录的通用形态)
96
- for (const vol of ['/volume1', '/volume2', '/vol1']) {
97
- for (const name of ['VirtualDSM', 'virtualdsm']) {
98
- const base = join(vol, name);
99
- if (!existsSync(base)) continue;
100
- list.push(base);
101
- try {
102
- for (const sub of readdirSync(base)) list.push(join(base, sub));
103
- } catch { /* 读不到就跳过 */ }
104
- }
105
- }
106
- return [...new Set(list)];
107
- }
108
-
109
- // 读本机浏览器环境的**固定记录**:<DSH_HOME>/browser-env.json(无则返回 {})。
110
- // 为什么需要它:这些路径(chrome / 运行库 / 字体 / playwright 根)每次会话都重新探测一遍
111
- // 既慢又容易找错;记录一次后所有会话直接读,换机/换版本时改那个文件即可。
112
- // 优先级:环境变量 DSH_PAGE_* > 本文件 > 自动探测。
113
- function readBrowserEnvRecord() {
114
- const home = process.env.DSH_HOME;
115
- if (!home) return {};
116
- const p = join(home, 'browser-env.json');
117
- if (!existsSync(p)) return {};
118
- try { return JSON.parse(readFileSync(p, 'utf8')) || {}; } catch { return {}; }
119
- }
120
-
121
- // 探测浏览器运行环境(chrome / libs / fontconfig / playwright 根)。
122
- // 顺序:环境变量 DSH_PAGE_* → <DSH_HOME>/browser-env.json 固定记录 → 按候选共享根自动探测。
123
- // 探测结果全部打印,便于核对「到底用了哪份资源」。
124
- // 边界:探测不到 chrome 时直接报错退出并提示设 env(**不静默降级成假成功**);
125
- // libs/fonts 缺失只影响能否启动/中文渲染,交给调用方按报错处理。
126
- // @returns {{chrome:string, libs:string, fontconf:string, pwroot:string}}
127
- function discover() {
128
- const found = { chrome: '', libs: '', fontconf: '', pwroot: '' };
129
- if (process.env.DSH_PAGE_CHROME) found.chrome = resolve(process.env.DSH_PAGE_CHROME);
130
- if (process.env.DSH_PAGE_LIBS) found.libs = process.env.DSH_PAGE_LIBS;
131
- if (process.env.DSH_PAGE_FONTCONF) found.fontconf = resolve(process.env.DSH_PAGE_FONTCONF);
132
- if (process.env.DSH_PAGE_PWROOT) found.pwroot = resolve(process.env.DSH_PAGE_PWROOT);
133
-
134
- // 固定记录:一次记录、后续会话不再重新探测(env 已设的项不被覆盖)
135
- const rec = readBrowserEnvRecord();
136
- if (!found.chrome && rec.chrome) found.chrome = resolve(String(rec.chrome));
137
- if (!found.libs && rec.libs) found.libs = String(rec.libs);
138
- if (!found.fontconf && rec.fontconf) found.fontconf = resolve(String(rec.fontconf));
139
- if (!found.pwroot && rec.pwroot) found.pwroot = resolve(String(rec.pwroot));
140
-
141
- for (const root of sharedRootCandidates()) {
142
- if (!found.chrome) {
143
- const browsers = existsSync(join(root, 'pwviewer', 'browsers'))
144
- ? join(root, 'pwviewer', 'browsers')
145
- : findDirUnder(root, ['browsers'], 2);
146
- if (browsers) {
147
- for (const b of readdirSync(browsers)) {
148
- for (const rel of [
149
- ['chrome-headless-shell-linux64', 'chrome-headless-shell'],
150
- ['chrome-linux', 'chrome'],
151
- ]) {
152
- const p = join(browsers, b, ...rel);
153
- if (existsSync(p)) { found.chrome = p; break; }
154
- }
155
- if (found.chrome) break;
156
- }
157
- }
158
- }
159
- if (!found.libs) {
160
- const libs = findDirUnder(root, ['chromium-libs'], 3);
161
- if (libs) {
162
- const parts = [
163
- join(libs, 'root', 'usr', 'lib', 'x86_64-linux-gnu'),
164
- join(libs, 'root', 'lib', 'x86_64-linux-gnu'),
165
- join(libs, 'root', 'usr', 'lib'),
166
- ].filter((p) => existsSync(p));
167
- if (parts.length) found.libs = parts.join(':');
168
- }
169
- }
170
- if (!found.fontconf) {
171
- const fonts = findDirUnder(root, ['fonts'], 2);
172
- const conf = fonts ? join(fonts, 'fonts.conf') : '';
173
- if (conf && existsSync(conf)) found.fontconf = conf;
174
- }
175
- if (!found.pwroot) {
176
- const pw = findDirUnder(root, ['pwviewer'], 2);
177
- if (pw && existsSync(join(pw, 'node_modules', 'playwright'))) found.pwroot = pw;
178
- }
179
- if (found.chrome && found.libs) break;
180
- }
181
- return found;
182
- }
183
-
184
- // 解析 playwright(可缺省)。
185
- // playwright 只装在共享根的 `pwviewer/node_modules` 下,**不在本插件依赖里**——
186
- // 故用 createRequire 从「探测到的 pwroot」解析(而不是 import,避免把 playwright 变成硬依赖)。
187
- // 解析不到不报错:调用方降级为 chrome `--dump-dom`(仍能读渲染后文本)。
188
- // 边界:显式设了 DSH_PAGE_PWROOT 时只认它;否则依次试 pwroot → cwd → 本脚本位置。
189
- // @param {string} pwroot 含 node_modules/playwright 的目录(可为空)
190
- // @returns {object|null} playwright 模块,或 null(→ 降级模式)
191
- function loadPlaywright(pwroot) {
192
- const roots = [pwroot, process.cwd()].filter(Boolean);
193
- for (const root of roots) {
194
- try {
195
- return createRequire(join(root, 'noop.cjs'))('playwright');
196
- } catch { /* 换下一个候选根 */ }
197
- }
198
- try { return createRequire(import.meta.url)('playwright'); } catch { return null; }
199
- }
200
-
201
- // 从渲染后的 HTML 里剥离标签,取可见文本(降级模式用)。
202
- function stripHtml(html) {
203
- return html
204
- .replace(/<script[\s\S]*?<\/script>/gi, ' ')
205
- .replace(/<style[\s\S]*?<\/style>/gi, ' ')
206
- .replace(/<[^>]+>/g, '\n')
207
- .split('\n').map((s) => s.trim()).filter((s) => s.length > 1).join('\n');
208
- }
209
-
210
- const env = discover();
211
- console.log('[probe] 浏览器:', env.chrome || '(未找到,请设 DSH_PAGE_CHROME)');
212
- console.log('[probe] 运行库 :', env.libs || '(未找到,可能缺 libatk 等;请设 DSH_PAGE_LIBS)');
213
- console.log('[probe] 字体配置:', env.fontconf || '(未找到,中文页可能渲染崩溃)');
214
- console.log('[probe] 目标 URL:', URL.replace(/token=[^&]+/, 'token=***'));
215
-
216
- if (!env.chrome) {
217
- console.error('[probe] 找不到浏览器可执行文件:请设 DSH_PAGE_CHROME 或 DSH_PAGE_SHARED_ROOT 后重试');
218
- process.exit(2);
219
- }
220
-
221
- const childEnv = { ...process.env };
222
- if (env.libs) childEnv.LD_LIBRARY_PATH = env.libs;
223
- if (env.fontconf) childEnv.FONTCONFIG_FILE = env.fontconf;
224
-
225
- const playwright = loadPlaywright(env.pwroot);
226
- if (!playwright) {
227
- // ── 降级模式:chrome --dump-dom(无 console 捕获、无点击) ──
228
- console.log('[probe] 未解析到 playwright → 降级为 --dump-dom 模式(无 console 错误捕获)');
229
- const r = spawnSync(env.chrome, [
230
- '--headless', '--no-sandbox', '--disable-gpu', '--disable-dev-shm-usage',
231
- `--virtual-time-budget=${WAIT_MS}`, '--dump-dom', URL,
232
- ], { env: childEnv, encoding: 'utf8', timeout: 120000, maxBuffer: 64 * 1024 * 1024 });
233
- const text = stripHtml(r.stdout || '');
234
- if (OUT) writeFileSync(OUT, text);
235
- console.log('=== 页面可见文本 ===');
236
- console.log(text.slice(0, TEXT_PRINT_MAX));
237
- process.exit(r.status === 0 ? 0 : 1);
238
- }
239
-
240
- // ── 完整模式:playwright(console/pageerror 捕获 + 点击) ──
241
- const { chromium } = playwright;
242
- const browser = await chromium.launch({
243
- executablePath: env.chrome,
244
- headless: true,
245
- args: ['--no-sandbox', '--disable-gpu', '--disable-dev-shm-usage'],
246
- env: childEnv,
247
- });
248
- const page = await browser.newPage({ viewport: { width: VIEWPORT_W, height: VIEWPORT_H } });
249
- const errors = [];
250
- page.on('pageerror', (e) => errors.push('PAGEERROR: ' + e.message));
251
- page.on('console', (m) => { if (m.type() === 'error') errors.push('CONSOLE: ' + m.text().slice(0, 500)); });
252
-
253
- await page.goto(URL, { waitUntil: 'domcontentloaded', timeout: 60000 });
254
- await page.waitForTimeout(WAIT_MS);
255
- for (const text of args.click) {
256
- const hit = await page.evaluate((t) => {
257
- const els = [...document.querySelectorAll('button,a,div,span,li')];
258
- const el = els.find((e) => e.children.length === 0 && (e.textContent || '').trim() === t);
259
- if (el) { el.click(); return true; }
260
- return false;
261
- }, text);
262
- console.log(`[probe] 点击「${text}」:`, hit ? '成功' : '未找到');
263
- await page.waitForTimeout(CLICK_SETTLE_MS);
264
- }
265
- const body = await page.evaluate(() => document.body.innerText);
266
- if (OUT) { writeFileSync(OUT, body); writeFileSync(`${OUT}.errors`, errors.join('\n')); }
267
- console.log('=== 页面可见文本 ===');
268
- console.log(body.slice(0, TEXT_PRINT_MAX));
269
- console.log('=== 前端错误(pageerror / console.error)===');
270
- console.log(errors.join('\n').slice(0, 4000) || '(无)');
271
- await browser.close();
@@ -1,87 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * 拼接产物作用域撞名检查(独立 CLI;判定与策略逻辑在 lib/,与 `git-sluice scope-check` 同一份)。
4
- *
5
- * 用法:
6
- * node scripts/check-js-scope.mjs <file.js> [...] [--prefix=dshgp_] [--allowlist=a,b] [--top=true|false] [--json]
7
- * node scripts/check-js-scope.mjs --config package.json # 读该 package.json 的 dshScopeCheck.files
8
- *
9
- * 参数名与 `git-sluice scope-check` 对齐(allowlist,旧写法 --allow 仍认)。
10
- * 约定按**文件所属项目**取:别人项目没声明 dshScopeCheck 时只查「同帧重名」,
11
- * 不会拿本项目的 dshgp_ 前缀去要求它(实测:那会刷一屏与它无关的告警)。
12
- */
13
- import { readFileSync, existsSync } from 'node:fs';
14
- import { dirname, join, resolve } from 'node:path';
15
- import { fileURLToPath } from 'node:url';
16
-
17
- import { runScopeCheck } from '../lib/app/scope-check.js';
18
-
19
- const HERE = dirname(fileURLToPath(import.meta.url));
20
- const argv = process.argv.slice(2);
21
- const VALUE_FLAGS = new Set(['config', 'prefix', 'allowlist', 'allow', 'top']);
22
-
23
- const { flags, positional } = (() => {
24
- const out = { flags: new Map(), positional: [] };
25
- for (let i = 0; i < argv.length; i += 1) {
26
- const token = argv[i];
27
- if (!token.startsWith('--')) { out.positional.push(token); continue; }
28
- const body = token.slice(2);
29
- if (body.includes('=')) {
30
- const [k, ...rest] = body.split('=');
31
- out.flags.set(k, rest.join('='));
32
- continue;
33
- }
34
- if (VALUE_FLAGS.has(body) && i + 1 < argv.length && !argv[i + 1].startsWith('--')) {
35
- out.flags.set(body, argv[i + 1]);
36
- i += 1;
37
- continue;
38
- }
39
- out.flags.set(body, 'true');
40
- }
41
- return out;
42
- })();
43
- const wantJson = flags.has('json');
44
-
45
- /** --config 指定的项目:只用它的 files 列表,**不**把它的 prefix 套给别的项目文件。 */
46
- function filesFromConfig(path) {
47
- if (!path || !existsSync(path)) return [];
48
- try {
49
- const cfg = JSON.parse(readFileSync(path, 'utf8'))?.dshScopeCheck;
50
- const base = dirname(resolve(path));
51
- return Array.isArray(cfg?.files) ? cfg.files.map((f) => resolve(base, f)) : [];
52
- } catch { return []; }
53
- }
54
-
55
- const configPath = flags.get('config') || '';
56
- const targets = positional.length ? positional.map((f) => resolve(f)) : filesFromConfig(configPath);
57
- if (!targets.length) {
58
- console.error('用法:node scripts/check-js-scope.mjs <file.js> [...] [--prefix=dshgp_] [--allowlist=a,b] [--json]');
59
- console.error(' 或 node scripts/check-js-scope.mjs --config package.json(读 dshScopeCheck.files)');
60
- process.exit(2);
61
- }
62
-
63
- const topFlag = flags.get('top');
64
- const result = runScopeCheck({
65
- files: targets,
66
- prefix: flags.get('prefix') || '',
67
- // allowlist 为主名(与 git-sluice scope-check 对齐),allow 是旧写法别名
68
- allowlist: String(flags.get('allowlist') || flags.get('allow') || '').split(',').map((x) => x.trim()).filter(Boolean),
69
- ...(topFlag === 'true' || topFlag === 'false' ? { topLevelMustBeEmpty: topFlag === 'true' } : {}),
70
- });
71
-
72
- if (wantJson) {
73
- console.log(JSON.stringify(result, null, 2));
74
- } else {
75
- // 输出头自证策略来源:避免「继承了本项目默认值」被误读成对方的约定
76
- for (const src of result.policySources) console.log(`策略来源:${src}`);
77
- for (const r of result.reports) {
78
- const rel = r.file.replace(process.cwd() + '/', '');
79
- if (r.ok) {
80
- console.log(`✔ ${rel}:${r.declarations.length} 个声明,无同帧重名`);
81
- } else {
82
- console.error(`✗ ${rel}:`);
83
- for (const v of r.violations) console.error(` - ${v}`);
84
- }
85
- }
86
- }
87
- process.exit(result.ok ? 0 : 1);
@@ -1,102 +0,0 @@
1
- #!/usr/bin/env python3
2
- """清理代码注释里的日期(YYYY-MM-DD),保留解释文字。
3
- 用法:python3 clean-date-comments.py <root> [--dry-run] [--write]
4
- 规则(2026-10-05 扩展:注释内任意位置的标准日期都清,注释/字符串正文不动):
5
- 1. 行首注释日期前缀:^(\s*)(//|#|\*|/\*)\s*202\d[-/]\d{1,2}[-/]\d{1,2}\s*[::]?\s* → $1$2
6
- 2. 行内注释日期前缀:(//)\s*202\d... → $1
7
- 3. 行首注释内括号括注日期:(2026-09-13 修)→(修);(2026-09-13)→ 删括号
8
- 安全:
9
- - 只在注释行处理(行首 // # *,或行内含 // 的代码行尾注释);正文 "2026-01-01" 字符串不动
10
- - 只删注释里的日期;正文里的日期(数据值/版本号)不动
11
- - dry-run 默认(只统计不写盘)
12
- """
13
- import os
14
- import re
15
- import sys
16
-
17
- # 行首注释日期前缀(//、#、*、/* 后紧跟日期)
18
- LEADING_RE = re.compile(r'^(\s*)(//|#|\*|/\*)\s*20\d{2}[-/]\d{1,2}[-/]\d{1,2}\s*[::]?\s*')
19
- # 行内注释日期前缀(代码后 // 日期)
20
- INLINE_RE = re.compile(r'(//)\s*20\d{2}[-/]\d{1,2}[-/]\d{1,2}\s*[::]?\s*')
21
- # 行首注释内的括号括注日期(增):(修)→(修);→ 删括号
22
- PAREN_DATE = re.compile(r'[((]\s*20\d{2}[-/.]\d{1,2}[-/.]\d{1,2}\s*[))]') # (2026-09-13)
23
- PAREN_DATE_W = re.compile(r'[((]\s*(20\d{2}[-/.]\d{1,2}[-/.]\d{1,2})[,,、\s]+([^))]*?)\s*[))]') # (2026-09-13 修)/ (2026-10-02,非 dsh 插件误报消除)
24
- # 文件级豁免:这些文件允许日期(变更记录/版权)
25
- EXEMPT_FILES = {'CHANGELOG.md', 'LICENSE', 'README.md', 'FUNCTIONS.md'}
26
-
27
-
28
- def clean_line(line):
29
- changed = False
30
- new = line
31
- # 行首注释(独占注释行或行首)
32
- new, n1 = LEADING_RE.subn(r'\g<1>\g<2> ', new)
33
- changed = changed or n1 > 0
34
- if not changed:
35
- # 行内注释(代码行尾)——只在非行首位置找 // 日期
36
- new, n2 = INLINE_RE.subn(r'\g<1> ', new)
37
- changed = changed or n2 > 0
38
- # 行首注释里的括号括注日期(增:规则 comment/no-date-in-comment 匹配注释内任意日期)
39
- if new.lstrip().startswith(('//', '#', '*', '/*')):
40
- new3, n3 = PAREN_DATE_W.subn(r'(\2)', new)
41
- new3, n3b = PAREN_DATE_W.subn(r'(\2)', new3)
42
- new3, n4 = PAREN_DATE.subn('', new3)
43
- new3, n4b = PAREN_DATE.subn('', new3)
44
- if n3 + n3b + n4 + n4b > 0:
45
- new3 = re.sub(r'\s{2,}', ' ', new3).replace('( ', '(').replace('( ', '(')
46
- new = new3
47
- changed = True
48
- return new, changed
49
-
50
-
51
- def main():
52
- root = sys.argv[1] if len(sys.argv) > 1 else '.'
53
- dry_run = '--dry-run' in sys.argv or '--write' not in sys.argv
54
- write = '--write' in sys.argv
55
- total = 0
56
- changed_files = 0
57
- skipped = 0
58
- if os.path.isfile(root):
59
- # 单文件模式:直接处理该文件(不限扩展名白名单,方便单测)
60
- entries = [(os.path.dirname(root), [os.path.basename(root)])]
61
- else:
62
- entries = []
63
- for dirpath, dirnames, filenames in os.walk(root):
64
- dirnames[:] = [d for d in dirnames if d not in ('.git', 'node_modules', '.trash', 'dist', 'build')]
65
- entries.append((dirpath, filenames))
66
- for dirpath, filenames in entries:
67
- for fn in filenames:
68
- if not os.path.isfile(os.path.join(dirpath, fn)):
69
- continue
70
- if not (os.path.isfile(root) or fn.endswith(('.js', '.mjs', '.cjs', '.ts', '.tsx', '.jsx', '.py'))):
71
- continue
72
- if fn in EXEMPT_FILES:
73
- continue
74
- full = os.path.join(dirpath, fn)
75
- try:
76
- with open(full, 'r', encoding='utf-8') as f:
77
- lines = f.readlines()
78
- except (UnicodeDecodeError, PermissionError):
79
- skipped += 1
80
- continue
81
- new_lines = []
82
- file_changed = 0
83
- for line in lines:
84
- nl, c = clean_line(line)
85
- if c:
86
- file_changed += 1
87
- total += 1
88
- new_lines.append(nl)
89
- if file_changed:
90
- changed_files += 1
91
- if write:
92
- with open(full, 'w', encoding='utf-8') as f:
93
- f.writelines(new_lines)
94
- else:
95
- print(f' {full}: {file_changed} 处')
96
- print(f'{"[dry-run] " if dry_run else ""}共 {total} 处日期前缀,{changed_files} 个文件(跳过 {skipped} 不可读)')
97
- if dry_run:
98
- print('dry-run 未写盘;加 --write 应用')
99
-
100
-
101
- if __name__ == '__main__':
102
- main()