dsh-git-push 0.0.0-stage → 2.8.6

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 (279) hide show
  1. package/.auditignore +30 -0
  2. package/.gitignore +39 -0
  3. package/LICENSE +21 -0
  4. package/README.md +1486 -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 +266 -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 +192 -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 +672 -0
  32. package/lib/app/tools.js +34 -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 +215 -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 +137 -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 +148 -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 +476 -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 +171 -0
  190. package/lib/npm/registry.js +168 -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 +196 -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/cpu-sample.mjs +188 -0
  231. package/scripts/doc-drift.mjs +200 -0
  232. package/scripts/doc-func.mjs +212 -0
  233. package/scripts/doc-tree.mjs +456 -0
  234. package/scripts/doc-version.mjs +220 -0
  235. package/scripts/frontend-preview-check.mjs +124 -0
  236. package/scripts/hot-path-probe-cjs.cjs +71 -0
  237. package/scripts/hot-path-probe-fs-shim.mjs +28 -0
  238. package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
  239. package/scripts/hot-path-probe.mjs +153 -0
  240. package/scripts/module-splitter.py +800 -0
  241. package/scripts/platform-scan.mjs +168 -0
  242. package/scripts/preview-gen.mjs +489 -0
  243. package/scripts/preview-local-runner.mjs +55 -0
  244. package/scripts/preview-server-direct.mjs +116 -0
  245. package/scripts/preview-server.mjs +305 -0
  246. package/scripts/preview-slot-data.mjs +123 -0
  247. package/scripts/probe-recheck.mjs +47 -0
  248. package/scripts/readme-gen.mjs +268 -0
  249. package/scripts/rename-locator.mjs +97 -0
  250. package/scripts/rule-switch.mjs +97 -0
  251. package/scripts/rules-solo-audit.mjs +173 -0
  252. package/scripts/scan-file-io.mjs +713 -0
  253. package/scripts/scan-hardcoded-paths.mjs +125 -0
  254. package/scripts/scan-repos.mjs +167 -0
  255. package/scripts/scan-version.mjs +122 -0
  256. package/scripts/scrub-user-wording.mjs +420 -0
  257. package/scripts/symbol-index.mjs +85 -0
  258. package/scripts/sync-plugin-install.mjs +223 -0
  259. package/scripts/sync-plugin.mjs +279 -0
  260. package/scripts/verify-prestep.mjs +100 -0
  261. package/skills/dev/audit-rule-authoring.md +58 -0
  262. package/skills/dev/dsh-git-push.md +323 -0
  263. package/skills/dev/git-push-live-fix.md +45 -0
  264. package/skills/dsh-repo-index.md +35 -0
  265. package/skills/guide/guide-audit.md +167 -0
  266. package/skills/guide/guide-cli-scripts.md +104 -0
  267. package/skills/guide/guide-clone-repos.md +173 -0
  268. package/skills/guide/guide-commit-push.md +156 -0
  269. package/skills/guide/guide-inject-ui.md +166 -0
  270. package/skills/guide/guide-slash-completion.md +118 -0
  271. package/skills/workflow/README.md +21 -0
  272. package/skills/workflow/git-commit-discipline.md +68 -0
  273. package/skills/workflow/git-project-startup.md +85 -0
  274. package/skills/workflow/git-rebuild-process.md +57 -0
  275. package/skills/workflow/github-operations.md +91 -0
  276. package/skills/workflow/readme-sync-git-md.md +28 -0
  277. package/skills/workflow/task-completion-report.md +73 -0
  278. package/skills/workflow/tool-json-add-ask.md +35 -0
  279. package/skills/workflow/versioning-rule.md +211 -0
@@ -0,0 +1,271 @@
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();
@@ -0,0 +1,119 @@
1
+ /**
2
+ * 客户端分片构建(C8 前提①:构建链落地)
3
+ *
4
+ * 背景与目标(任务.md C8):`lib/client.js` 2585 行整文件入库、没有构建脚本,
5
+ * 维护它是「改一处要看整份 2500 行」。改为**分片源码 + 拼接构建**:
6
+ * 源码在 `lib/client-parts/**.js`(git 维护),`lib/client.js` 是**产物**。
7
+ *
8
+ * ⛔ 形态铁律(client-modules 聚合 bundle 兼容,见 client.js 头部注释):
9
+ * 1. `window.__ModuleLoader__.load` 必须是产物里的**第一条语句**;
10
+ * 2. 全部代码在 `factory` 函数体内,文件顶层【零声明】(防 combo 拼接撞名);
11
+ * 3. 内部命名统一 `dshgp_` 前缀。
12
+ * ⇒ 分片是**片段**(fragment):单个分片不是合法 JS(首片开工厂、尾片收工厂),
13
+ * 只有按 PART_ORDER 拼起来才是完整文件。因此 `scripts/check.mjs` 必须排除
14
+ * `lib/client-parts/`,语法检查只对**产物**做。
15
+ *
16
+ * 产物**逐字节可复现**:分片是原文件的精确切片,拼接即原样还原(`--check` 可校验)。
17
+ *
18
+ * 用法:
19
+ * node scripts/build-client.mjs # 校验产物与分片是否一致,不一致则写回
20
+ * node scripts/build-client.mjs --check # 只校验(CI/提交门禁用;不一致 exit 1)
21
+ * node scripts/build-client.mjs --print # 只打印产物到 stdout(不落盘)
22
+ */
23
+ import { readFileSync, writeFileSync, existsSync, readdirSync } from 'node:fs';
24
+ import { join, dirname } from 'node:path';
25
+ import { fileURLToPath } from 'node:url';
26
+
27
+ export const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
28
+ export const PARTS_DIR = join(ROOT, 'lib', 'client-parts');
29
+ export const OUT_FILE = join(ROOT, 'lib', 'client.js');
30
+
31
+ /**
32
+ * 拼接顺序 = 依赖顺序(先定义后使用)。
33
+ * 函数声明会提升、但 `const`/`let` 不会——顺序错会在**运行时**才炸(静态查不出),
34
+ * 所以这里与 client.js 的分节标记 `[N]` 一一对应,改分片必须同步改本表。
35
+ */
36
+ export const PART_ORDER = [
37
+ '00-loader.js', // loader + factory 头 + require + NS(必须首片)
38
+ '01-const.js', // [1] 常量区(BUSY/维度表/超时/样式串)
39
+ '02-utils.js', // [2] 工具区(ensureCss/getJson/postJson/tokenConfigured/localGet…)
40
+ '03-icons.js', // [3] 图标区
41
+ '10-account.js', // [4] 账号信息 Tab
42
+ '11-browser.js', // [5] 目录选择器
43
+ '20-repo.js', // [6] 仓库管理卡
44
+ '23-npm.js', // [6续] NPM 面板(账号卡 + 装包表单 + npm 凭据字段)
45
+ '21-audit.js', // [7] 审计 Tab
46
+ '22-settings.js', // [8] 设置 Tab
47
+ '30-page.js', // [9] 页面装配(GitPushPage)
48
+ '40-controller.js', // [10] Controller:状态机 + 数据加载
49
+ '41-actions.js', // [10续] Controller:动作注入
50
+ '99-apply.js', // 收尾:注册 settings.section + factory 返回(必须末片)
51
+ ];
52
+
53
+ /** 读出全部分片内容(缺片直接报错,避免拼出半份产物当成功)。 */
54
+ export function readParts(order = PART_ORDER, dir = PARTS_DIR) {
55
+ const missing = order.filter((f) => !existsSync(join(dir, f)));
56
+ if (missing.length) throw new Error(`缺分片:${missing.join(' / ')}(先按 PART_ORDER 建齐,再构建)`);
57
+ const extra = readdirSync(dir).filter((f) => f.endsWith('.js') && !order.includes(f));
58
+ if (extra.length) throw new Error(`分片未登记进 PART_ORDER:${extra.join(' / ')}(未登记 = 不会进入产物,属静默丢失)`);
59
+ return order.map((f) => readFileSync(join(dir, f), 'utf8'));
60
+ }
61
+
62
+ /** 拼接产物。分片自带行尾,直接相接即为完整文件(**零加工**:不加头尾换行/不加分隔符)。
63
+ * ⚠️ 原文件不以换行结尾(163020 字节,末行无 \n)——构建若补换行会导致产物比原文多一字节,
64
+ * cmp 直接抓到。等价性要求「拼接 = 原文」,任何后处理都会破坏它。 */
65
+ export function buildClient(order = PART_ORDER, dir = PARTS_DIR) {
66
+ const parts = readParts(order, dir);
67
+ return parts.join('');
68
+ }
69
+
70
+ /** 形态铁律自检:产物第一条语句必须是 __ModuleLoader__.load,且含 factory 收尾。 */
71
+ export function checkShape(code) {
72
+ const errs = [];
73
+ const firstStmt = code.replace(/^\/\*\*[\s\S]*?\*\/\s*/, '').trimStart();
74
+ if (!/^window\.__ModuleLoader__\.load\(/.test(firstStmt)) {
75
+ errs.push('产物第一条语句不是 window.__ModuleLoader__.load(...)(第 1 条形态铁律)');
76
+ }
77
+ if (!/^\}\)\(\);\s*$/m.test(code.trimEnd().split('\n').slice(-3).join('\n') + '\n')) {
78
+ // 宽松校验:末尾应能闭合 factory 调用
79
+ if (!/\)\s*;?\s*$/.test(code.trimEnd())) errs.push('产物末尾不像闭合的 load({...}) 调用');
80
+ }
81
+ return errs;
82
+ }
83
+
84
+ function main(argv = process.argv.slice(2)) {
85
+ const checkOnly = argv.includes('--check');
86
+ const printOnly = argv.includes('--print');
87
+ let built;
88
+ try {
89
+ built = buildClient();
90
+ } catch (e) {
91
+ console.error(`❌ ${e.message}`);
92
+ return 1;
93
+ }
94
+ const errs = checkShape(built);
95
+ if (errs.length) {
96
+ console.error('❌ 形态铁律自检失败:');
97
+ for (const e of errs) console.error(` · ${e}`);
98
+ return 1;
99
+ }
100
+ if (printOnly) { process.stdout.write(built); return 0; }
101
+ const current = existsSync(OUT_FILE) ? readFileSync(OUT_FILE, 'utf8') : '';
102
+ if (current === built) {
103
+ console.log(`✅ 产物与分片一致(${built.split('\n').length - 1} 行,${PART_ORDER.length} 个分片)`);
104
+ return 0;
105
+ }
106
+ if (checkOnly) {
107
+ const a = current.split('\n').length - 1;
108
+ const b = built.split('\n').length - 1;
109
+ console.error(`❌ 产物与分片不一致(现存 ${a} 行 / 应为 ${b} 行)——请跑 node scripts/build-client.mjs 重新生成`);
110
+ return 1;
111
+ }
112
+ writeFileSync(OUT_FILE, built, 'utf8');
113
+ console.log(`✅ 已生成 lib/client.js(${built.split('\n').length - 1} 行,${PART_ORDER.length} 个分片)`);
114
+ return 0;
115
+ }
116
+
117
+ if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
118
+ process.exitCode = main();
119
+ }
@@ -0,0 +1,88 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * 语法检查脚本(npm run check)
4
+ * 递归检查 lib/****.js + cli.mjs 语法;任一失败退出 1(checkSyncInAsync 的脚本侧实现)。
5
+ *
6
+ * 2026-10-09(任务.md C8 分片改造)新增两条:
7
+ * ① **跳过 `lib/client-parts/`**:那是客户端**分片源码**——单个分片是片段(首片开 `factory`、
8
+ * 尾片收尾),单独 `node --check` 必然失败;语法检查只对**产物** `lib/client.js` 做。
9
+ * ② **产物新鲜度门禁**:`lib/client.js` 必须与分片按 PART_ORDER 拼出来的一致,
10
+ * 防止有人直接手改产物(下次构建就被覆盖,改动静默丢失)。
11
+ */
12
+ import { execFileSync } from 'node:child_process';
13
+ import { readdirSync, statSync, readFileSync } from 'node:fs';
14
+ import { join, dirname } from 'node:path';
15
+ import { fileURLToPath } from 'node:url';
16
+ import { buildClient } from './build-client.mjs';
17
+
18
+ const __dirname = dirname(fileURLToPath(import.meta.url));
19
+ const ROOT = join(__dirname, '..');
20
+
21
+ /** 递归收集 .js 文件(跳过 node_modules、点开头目录,以及分片目录 client-parts)。 */
22
+ function collectJs(dir, acc = []) {
23
+ for (const name of readdirSync(dir)) {
24
+ if (name === 'node_modules' || name.startsWith('.')) continue;
25
+ if (name === 'client-parts') continue; // 分片是片段,见文件头 ①
26
+ const p = join(dir, name);
27
+ if (statSync(p).isDirectory()) collectJs(p, acc);
28
+ else if (name.endsWith('.js')) acc.push(p);
29
+ }
30
+ return acc;
31
+ }
32
+
33
+ /** 递归收集 .json(同样的跳过规则,但不跳过 client-parts——那里没有 .json)。 */
34
+ function collectJson(dir, acc = []) {
35
+ for (const name of readdirSync(dir)) {
36
+ if (name === 'node_modules' || name.startsWith('.')) continue;
37
+ const p = join(dir, name);
38
+ if (statSync(p).isDirectory()) collectJson(p, acc);
39
+ else if (name.endsWith('.json')) acc.push(p);
40
+ }
41
+ return acc;
42
+ }
43
+
44
+ const files = [...collectJs(join(ROOT, 'lib')), join(ROOT, 'cli.mjs')];
45
+ // docs/*.json 也必须能解析:版本表与发版说明直接依赖 docs/releases.json,
46
+ // 而它曾在 2.8.4 因一个尾随逗号变成非法 JSON 却**四项门禁全绿**(缺口)——这类错误必须在门禁里变红 ✗
47
+ const jsonFiles = [...collectJson(join(ROOT, 'lib')), ...collectJson(join(ROOT, 'docs'))];
48
+ let fail = 0;
49
+ let jsonFail = 0;
50
+ for (const f of files) {
51
+ try {
52
+ execFileSync(process.execPath, ['--check', f], { stdio: 'pipe', encoding: 'utf8' });
53
+ console.log(`✔ ${f.replace(ROOT + '/', '')}`);
54
+ } catch (e) {
55
+ fail++;
56
+ console.error(`✗ ${f.replace(ROOT + '/', '')}: ${String(e?.stderr || e).trim().split('\n')[0]}`);
57
+ }
58
+ }
59
+
60
+ // JSON 可解析性门禁(独立计数,不并入上面的语法通过率)
61
+ for (const f of jsonFiles) {
62
+ try {
63
+ JSON.parse(readFileSync(f, 'utf8'));
64
+ console.log(`✔ ${f.replace(ROOT + '/', '')}`);
65
+ } catch (e) {
66
+ jsonFail++;
67
+ console.error(`✗ ${f.replace(ROOT + '/', '')}: JSON 解析失败——${String(e?.message || e).split('\n')[0]}`);
68
+ }
69
+ }
70
+
71
+ // 产物新鲜度:client.js 必须是分片构建出来的那一份
72
+ try {
73
+ const built = buildClient();
74
+ const current = readFileSync(join(ROOT, 'lib', 'client.js'), 'utf8');
75
+ if (built === current) {
76
+ console.log('✔ lib/client.js 与分片一致(构建产物新鲜)');
77
+ } else {
78
+ fail++;
79
+ console.error('✗ lib/client.js 与分片不一致——请运行 node scripts/build-client.mjs 重新生成(不要手改产物)');
80
+ }
81
+ } catch (e) {
82
+ fail++;
83
+ console.error(`✗ 分片构建校验失败:${e.message}`);
84
+ }
85
+
86
+ console.log(`\n${files.length - fail}/${files.length} 文件语法通过`);
87
+ console.log(`${jsonFiles.length - jsonFail}/${jsonFiles.length} 个 JSON 可解析`);
88
+ process.exitCode = (fail > 0 || jsonFail > 0) ? 1 : 0;
@@ -0,0 +1,102 @@
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()