dsh-git-push 2.9.4 → 2.10.1

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 (80) hide show
  1. package/README.md +42 -39
  2. package/lib/app/apply.js +8 -1
  3. package/lib/app/audit-api.js +4 -1
  4. package/lib/app/command-registry.js +18 -11
  5. package/lib/app/handlers/meta.js +38 -0
  6. package/lib/app/handlers/repo-actions.js +3 -1
  7. package/lib/app/handlers/repos.js +18 -2
  8. package/lib/app/handlers/settings.js +0 -0
  9. package/lib/app/http-handlers.js +3 -1
  10. package/lib/app/schema.js +0 -0
  11. package/lib/app/settings-bridge.js +0 -0
  12. package/lib/app/tool-call.js +32 -23
  13. package/lib/ast/brace.js +15 -0
  14. package/lib/ast/control-flow.js +12 -3
  15. package/lib/ast/size.js +73 -3
  16. package/lib/audit/audit-file.js +4 -2
  17. package/lib/audit/collector.js +13 -4
  18. package/lib/audit/file-context.js +89 -0
  19. package/lib/audit/finding.js +16 -2
  20. package/lib/audit/ignore-blind.js +5 -4
  21. package/lib/audit/index.js +2 -2
  22. package/lib/audit/orchestrate.js +2 -1
  23. package/lib/audit-rules/audit-rules-frontend.yml +4 -4
  24. package/lib/checks/button-bind.js +84 -13
  25. package/lib/checks/dispatch.js +1 -1
  26. package/lib/checks/private.js +2 -1
  27. package/lib/checks/structural.js +10 -3
  28. package/lib/client-parts/{10-account.js → account.js} +1 -1
  29. package/lib/client-parts/{41-actions.js → actions.js} +3 -2
  30. package/lib/client-parts/{99-apply.js → apply.js} +2 -1
  31. package/lib/client-parts/{21-audit.js → audit.js} +5 -5
  32. package/lib/client-parts/{11-browser.js → browser.js} +15 -4
  33. package/lib/client-parts/{01-const.js → const.js} +11 -5
  34. package/lib/client-parts/{40-controller.js → controller.js} +4 -4
  35. package/lib/client-parts/{03-icons.js → icons.js} +1 -1
  36. package/lib/client-parts/{00-loader.js → loader.js} +1 -0
  37. package/lib/client-parts/{23-npm.js → npm.js} +3 -2
  38. package/lib/client-parts/{30-page.js → page.js} +1 -1
  39. package/lib/client-parts/{20-repo.js → repo.js} +2 -2
  40. package/lib/client-parts/{22-settings.js → settings.js} +1 -1
  41. package/lib/client-parts/{02-utils.js → utils.js} +1 -1
  42. package/lib/client.js +51 -30
  43. package/lib/commit-push.js +20 -2
  44. package/lib/context/index.js +2 -1
  45. package/lib/core/atomic-json.js +1 -1
  46. package/lib/core/exec.js +6 -4
  47. package/lib/exempt/index.js +7 -2
  48. package/lib/exempt/tool.js +198 -0
  49. package/lib/git/clone-history-mode.js +24 -5
  50. package/lib/git/index-format.js +182 -0
  51. package/lib/git/index.js +1 -0
  52. package/lib/git/push.js +28 -13
  53. package/lib/git/repo-index.js +41 -30
  54. package/lib/git/scan-runner.js +1 -1
  55. package/lib/git/transport.js +49 -17
  56. package/lib/git/visibility.js +93 -9
  57. package/lib/npm/publish.js +30 -1
  58. package/lib/npm/registry.js +5 -2
  59. package/lib/self/index.js +1 -1
  60. package/package.json +2 -4
  61. package/scripts/build-client.mjs +19 -14
  62. package/scripts/picker-repro.mjs +115 -0
  63. package/skills/dev/dsh-git-push.md +1 -2
  64. package/skills/dsh-repo-index.md +1 -1
  65. package/skills/guide/guide-audit.md +77 -3
  66. package/skills/guide/guide-cli-scripts.md +4 -4
  67. package/skills/guide/guide-clone-repos.md +2 -2
  68. package/skills/guide/guide-inject-ui.md +6 -6
  69. package/skills/workflow/README.md +1 -1
  70. package/assets/minihost.sh +0 -35
  71. package/assets/preview.html +0 -36703
  72. package/lib/fs/edit-after-read.js +0 -142
  73. package/scripts/frontend-preview-check.mjs +0 -124
  74. package/scripts/preview-gen.mjs +0 -489
  75. package/scripts/preview-local-runner.mjs +0 -55
  76. package/scripts/preview-server-direct.mjs +0 -116
  77. package/scripts/preview-server.mjs +0 -305
  78. package/scripts/preview-slot-data.mjs +0 -123
  79. package/scripts/sync-plugin-install.mjs +0 -286
  80. package/scripts/sync-plugin.mjs +0 -284
@@ -75,9 +75,12 @@ export function runNpm(args = [], { timeoutMs = NPM_TIMEOUT_MS, env = {}, cwd =
75
75
  const merged = { ...process.env, ...env };
76
76
  // 关键:npm 的入口是 `#!/usr/bin/env node` 脚本 ⇒ 子进程 PATH 里必须有 node,
77
77
  // 否则即使找到 npm 也会报「env: 'node': No such file or directory」(最小 PATH 宿主实测)。
78
- // 这里把当前进程的 node 目录放到 PATH 最前,保证 npm 一定能起来。
78
+ // 插到 PATH **末尾**:既保证 node 可找到,又不覆盖调用方/测试注入的 PATH 优先级
79
+ // (插最前会在 GitHub runner 上让 nodeDir 自带的真 npm 抢先于测试注入的假 npm)。
79
80
  const nodeDir = dirname(String(process.execPath || ''));
80
- if (nodeDir) merged.PATH = `${nodeDir}${delimiter}${merged.PATH || ''}`;
81
+ if (nodeDir && !String(merged.PATH || '').split(delimiter).includes(nodeDir)) {
82
+ merged.PATH = `${merged.PATH || ''}${delimiter}${nodeDir}`;
83
+ }
81
84
  const bin = resolveNpmBin({ env: merged });
82
85
  // maxBuffer 可注入:默认 16MB;测试传极小值(如 1)即可**确定性触发** ENOBUFS 走重试分支 ✓
83
86
  const runNpmBuf = (buf) => spawnSync(bin, args, {
package/lib/self/index.js CHANGED
@@ -9,7 +9,7 @@
9
9
  */
10
10
 
11
11
 
12
- export const VERSION = '2.9.4'; // 2.9.4:修「文件头豁免提示的标记写了不生效」——判定口径抽成唯一函数(exemptForFinding 与反查提示共用)+ 补齐注册表缺口(quality 增加 semantic/dataflow/duplicate-const/repeated-string 与非安全类 regex 兜底、style 补 min-length/max-lines/max-complexity/max-depth、sensitive 补 semantic)+ 所有 finding 产出后统一校正提示为「真能豁免的标记」;自证:写了不生效的组合 24 → 0。历史:2.9.3:FS 热点扫描并入审计(判据②扩到函数体 + 仓库级 multi-file-scanners + 独立 CLI)。
12
+ export const VERSION = '2.10.1'; // 2.10.1:按插件架构修订审计规则(外部项目实测反馈,只修改判定逻辑、不以豁免代偿):①button-bind 按元素类型分流——button 要 click 类;input 接受 change/input/submit/pointerdown 等表单控件标准事件;<input type=file> 由原生 label.click() 触发、有程序化触发即视为接好;自定义分片目录(非标准 client-parts)降级 info,完整判定交产物。②函数范围识别补齐箭头函数/方法简写/asynс 体(此前只认 function 关键字 ⇒ maxFunctionLength 对纯箭头文件返回 0,导致 max-file-length 把聚合型文件误判成臃肿型且文案「最大函数 0 行(藏着超大函数)」自相矛盾);无函数时文案改为「顶层语句堆叠」。③button-bind 补进 dsh-skip-quality 的 blocked(此前该 kind 无任何标记可豁免,而规则 exemptHint 却指向它 ⇒ 提示写了不生效)。④guide-audit 增 §14 记录插件架构适配与性价比取舍。历史:2.10.0:仓库索引改 JSONL + 修 signal timed out。
13
13
  // 实测后果:该目录有 package.json ⇒ npm 去打包整棵 DSH 树、输出 2.1MB > spawnSync 默认 maxBuffer 1MB ⇒ ENOBUFS(npm_publish 的体检与真发全部失败);
14
14
  // 该目录没有 package.json 时报 ENOENT。现 publish 的两个调用点显式传 cwd=目标包目录,并给 runNpm 加 16MB maxBuffer。
15
15
  // 2.8.3:文案修正——「零改动 / 无新提交」明确为**正常成功路径**(注入用法、工具描述、README、skill 同批改),并修 job 输出自相矛盾(cleanSkipCommit 路径补 committed:false,不再显示「已提交,未推送」)
package/package.json CHANGED
@@ -1,7 +1,6 @@
1
1
  {
2
2
  "name": "dsh-git-push",
3
- "version": "2.9.4",
4
-
3
+ "version": "2.10.1",
5
4
  "description": "DSH git 自动提交推送插件——统一函数入口架构(规则/审计/git/自身/侧边栏/评分/豁免/上下文/HTTP/测试十大总入口)",
6
5
  "type": "module",
7
6
  "main": "lib/index.js",
@@ -92,7 +91,6 @@
92
91
  "test": "node test/run-tests.mjs",
93
92
  "check": "node scripts/check.mjs",
94
93
  "scan-version": "node scripts/scan-version.mjs",
95
- "check:drift": "node scripts/doc-drift.mjs",
96
- "sync-plugin": "node scripts/sync-plugin.mjs"
94
+ "check:drift": "node scripts/doc-drift.mjs"
97
95
  }
98
96
  }
@@ -32,22 +32,27 @@ export const OUT_FILE = join(ROOT, 'lib', 'client.js');
32
32
  * 拼接顺序 = 依赖顺序(先定义后使用)。
33
33
  * 函数声明会提升、但 `const`/`let` 不会——顺序错会在**运行时**才炸(静态查不出),
34
34
  * 所以这里与 client.js 的分节标记 `[N]` 一一对应,改分片必须同步改本表。
35
+ *
36
+ * 命名约定:分片文件名**不带数字序号**(顺序只由本表这一处权威声明)。
37
+ * 序号前缀看似方便,实则会漂移——重排/插片时新旧序号并存,扫目录看到的顺序
38
+ * 与真实拼接顺序不一致,比没有序号更坏。顺序信息集中在 PART_ORDER +
39
+ * 每个分片头注释的「第 N/14 片」锚点,改序只改这两处。
35
40
  */
36
41
  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 返回(必须末片)
42
+ 'loader.js', // [1] loader + factory 头 + require + NS(必须首片)
43
+ 'const.js', // [2] 常量区(BUSY/维度表/超时/样式串)
44
+ 'utils.js', // [3] 工具区(ensureCss/getJson/postJson/tokenConfigured/localGet…)
45
+ 'icons.js', // [4] 图标区
46
+ 'account.js', // [5] 账号信息 Tab
47
+ 'browser.js', // [6] 目录选择器
48
+ 'repo.js', // [7] 仓库管理卡
49
+ 'npm.js', // [7续] NPM 面板(账号卡 + 装包表单 + npm 凭据字段)
50
+ 'audit.js', // [8] 审计 Tab
51
+ 'settings.js', // [9] 设置 Tab
52
+ 'page.js', // [10] 页面装配(GitPushPage)
53
+ 'controller.js', // [11] Controller:状态机 + 数据加载
54
+ 'actions.js', // [11续] Controller:动作注入
55
+ 'apply.js', // [12] 收尾:注册 settings.section + factory 返回(必须末片)
51
56
  ];
52
57
 
53
58
  /** 读出全部分片内容(缺片直接报错,避免拼出半份产物当成功)。 */
@@ -0,0 +1,115 @@
1
+ // dsh-skip-quality: 本文件只生成**静态自检页**(用真实 CSS 拼一个最小复现,供人目测布局),
2
+ // 其中的按钮是布局样本、不承担交互,未绑事件属预期(规则判定无误,属「判对但不需要」)。
3
+ /**
4
+ * 目录选择器布局自检页生成器(无依赖、离线)。
5
+ *
6
+ * 为什么需要:选择器弹窗的「条目多时被压扁」是**纯布局缺陷**——CSS 文本看着没问题
7
+ * (`max-height` + `overflow-y:auto` 都在),只有真实渲染才暴露。实测 73 条目录在
8
+ * 1080px 视口下,行高从应有的 27px 被压到 10px、容器根本不滚动,而任何
9
+ * 「断言 CSS 里有某条声明」的单元测试都会通过。
10
+ *
11
+ * 本脚本用**真实 CSS**(直接从 lib/client-parts/const.js 抽取 .dshgp_* 规则)拼一个
12
+ * 最小复现页:只有 mask/dialog/path/up/list/foot 六层与 N 个目录行。
13
+ * 在浏览器里打开即可目测;配合一段测量脚本可拿到行高/可滚动性等硬指标。
14
+ *
15
+ * 用法:
16
+ * node scripts/picker-repro.mjs # 生成 /tmp/dshgp-picker-repro.html(默认 73 条)
17
+ * node scripts/picker-repro.mjs --count 300 # 指定条目数
18
+ * node scripts/picker-repro.mjs --out <路径>
19
+ * node scripts/picker-repro.mjs --serve # 生成后用本机 http 起服务并打印地址
20
+ *
21
+ * 判读标准(在浏览器控制台跑 MEASURE_SNIPPET):
22
+ * rowHeight 应 ≈ 26-28px(12px 字 + 上下 5px padding + 行高)
23
+ * listScrollable true(条目超容器时必须能滚,而不是压扁)
24
+ * footerInViewport true(「选择当前目录」必须留在视口内)
25
+ */
26
+ import { readFileSync, writeFileSync } from 'node:fs';
27
+ import { join, dirname } from 'node:path';
28
+ import { fileURLToPath } from 'node:url';
29
+ import { createServer } from 'node:http';
30
+
31
+ const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
32
+ const CONST_FILE = join(ROOT, 'lib', 'client-parts', 'const.js');
33
+ const DEFAULT_OUT = '/tmp/dshgp-picker-repro.html';
34
+ const DEFAULT_COUNT = 73;
35
+
36
+ /** 从 const.js 抽取全部 .dshgp_* 规则原文(保证自检页与真实样式同源)。 */
37
+ export function extractCss(src = readFileSync(CONST_FILE, 'utf8')) {
38
+ return [...src.matchAll(/'\.(dshgp_[a-z0-9_]+)\{([^}]*)\}'/g)]
39
+ .map((m) => `.${m[1]}{${m[2]}}`)
40
+ .join('\n');
41
+ }
42
+
43
+ /** 生成复现页 HTML。 */
44
+ export function buildReproHtml({ count = DEFAULT_COUNT, css = extractCss() } = {}) {
45
+ const rows = Array.from({ length: count }, (_, i) => {
46
+ const name = `项目目录-${String(i + 1).padStart(2, '0')}-很长的中文目录名用于测试挤压`;
47
+ return `<div class="dshgp_browsedir" data-path="/x/${name}">📁 ${name}</div>`;
48
+ }).join('');
49
+ // 暗色变量只是为了目测接近真实主题,不参与布局判定
50
+ const vars = ':root{--dsw-alias-border-l4:#444;--dsw-alias-border-l2:#333;'
51
+ + '--dsw-alias-bg-layer-3:#1b1b2a;--dsw-alias-bg-layer-2:#222;--dsw-alias-bg-base:#111;'
52
+ + '--dsw-alias-label-primary:#eee;--dsw-alias-label-secondary:#aaa;'
53
+ + '--dsw-alias-label-tertiary:#888;--dsw-alias-brand-primary:#7c5cff}';
54
+ return '<!doctype html><meta charset="utf-8"><title>picker repro</title>'
55
+ + `<style>${vars}${css}</style>`
56
+ + '<body style="margin:0;height:100vh;background:#0d0d14">'
57
+ + '<div class="dshgp_browsemask"><div class="dshgp_browsedialog">'
58
+ + '<div class="dshgp_browsehead"><span class="dshgp_browsetitle">选择目录</span>'
59
+ + '<button type="button" class="dshgp_browseclose">✕</button></div>'
60
+ + '<div class="dshgp_browsepath">/volume1/VirtualDSM/DeepSeekHarness/工作区</div>'
61
+ + '<div class="dshgp_browseup">⬆ 上级目录</div>'
62
+ + `<div class="dshgp_browselist" id="list">${rows}</div>`
63
+ + '<div class="dshgp_browsefoot"><button type="button" class="dshgp_keybtn">选择当前目录</button></div>'
64
+ + '</div></div></body>';
65
+ }
66
+
67
+ /** 浏览器控制台测量脚本(返回硬指标 JSON)。 */
68
+ export const MEASURE_SNIPPET = `(() => {
69
+ const list = document.getElementById('list');
70
+ const rows = [...list.children];
71
+ const lb = list.getBoundingClientRect();
72
+ const f = rows[0].getBoundingClientRect();
73
+ const foot = document.querySelector('.dshgp_browsefoot').getBoundingClientRect();
74
+ return {
75
+ rows: rows.length,
76
+ rowHeight: Math.round(f.height * 10) / 10,
77
+ rowFlexShrink: getComputedStyle(rows[0]).flexShrink,
78
+ listClientH: list.clientHeight,
79
+ listScrollH: list.scrollHeight,
80
+ listScrollable: list.scrollHeight > list.clientHeight,
81
+ visibleRows: Math.round(lb.height / f.height),
82
+ footerInViewport: foot.bottom <= innerHeight,
83
+ };
84
+ })()`;
85
+
86
+ function argOf(name, def) {
87
+ const i = process.argv.indexOf(name);
88
+ return i >= 0 && process.argv[i + 1] ? process.argv[i + 1] : def;
89
+ }
90
+
91
+ function main() {
92
+ const count = Number(argOf('--count', String(DEFAULT_COUNT))) || DEFAULT_COUNT;
93
+ const out = argOf('--out', DEFAULT_OUT);
94
+ const html = buildReproHtml({ count });
95
+ writeFileSync(out, html, 'utf8');
96
+ console.log(`✅ 已生成复现页:${out}(${count} 条目录,${html.length} 字节)`);
97
+ console.log('');
98
+ console.log('浏览器打开后,控制台粘贴以下脚本取硬指标:');
99
+ console.log(MEASURE_SNIPPET);
100
+ console.log('');
101
+ console.log('判读:rowHeight≈26-28px · listScrollable=true · footerInViewport=true');
102
+ if (!process.argv.includes('--serve')) return 0;
103
+ const port = Number(argOf('--port', '31399'));
104
+ const server = createServer((req, res) => {
105
+ res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
106
+ res.end(html);
107
+ });
108
+ server.listen(port, '127.0.0.1', () => console.log(`\n服务已启动:http://127.0.0.1:${port}/(Ctrl+C 结束)`));
109
+ return null; // 挂起,等待手动结束
110
+ }
111
+
112
+ if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
113
+ const code = main();
114
+ if (code !== null) process.exitCode = code;
115
+ }
@@ -24,7 +24,6 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
24
24
  | `link_check` | `repo?`, `paths?` | 检查文档链接:404/403→-3、DNS→-2、超时/5xx→-1;只 warning,永不 blocker |
25
25
  | `io_scan` | `repo?`, `writeOnly?` | I/O 风险扫描(AST 四级分级 high/medium/low/safe,与审计 io-risk 同标准) |
26
26
  | `git_clone_preview` | `target`, `branch?` | clone 预演(不落盘,报告将拉取什么) |
27
- | `edit_after_read` | `path`/`file_path`, `old`/`old_string`, `new`/`new_string`, `all?` | 读改合一编辑(读后文件被改动则拒绝;old 默认必须唯一匹配;字面匹配不做正则解释) |
28
27
  | `git_identity_rewrite` | `paths?`, `root?`, `dryRun?`, `push?` | 提交身份历史改写(默认 dryRun 只报告;真改写先建备份引用 + 自检,通过才 force-with-lease) |
29
28
  | `module_splitter` | `command`, `file`/`plan`, `dryRun?` | 巨型单文件拆分:analyze(先看依赖)→ split → verify(校验导出一致) |
30
29
  | `git_account_check` | `token?`, `sshPub?` | 校验 GitHub 账号与凭据(登录态/用户名/公钥数/套餐;token 不传自动解析) |
@@ -313,7 +312,7 @@ node scripts/readme-gen.mjs <repoPath> [--write <path>] [--template <path>]
313
312
 
314
313
  | 现象 | 原因 / 处理 |
315
314
  |------|-------------|
316
- | 插件改动刷新看不到 | 真实加载源是 `<profile>/local-plugins/<插件名>`,只同步 `node_modules/` 无效;用 `scripts/sync-plugin.mjs --write` 同步两处(多 profile 时加 `--profile <名>`) |
315
+ | 插件改动刷新看不到 | 真实加载源是 `<profile>/local-plugins/<插件名>`,只同步 `node_modules/` 无效;用 ``sync_plugin` 工具(write:true)` 同步两处(多 profile 时加 `--profile <名>`) |
317
316
  | 改插件代码必须重启才生效 | 免重启热重载要同时满足两条:① profile 的 `cordis.patch.yml` 里 `id: hmr` 显式配 `base` + `root`(默认 `root: []` = module roots are opt-in,一个模块目录都不 watch);② 插件本体在 `local-plugins/`(`node_modules/**` 被默认 `ignored` 整棵剪枝,想只放行其下某插件的否定写法无效)。`sync-plugin.mjs` 会直接报告该插件能否热重载,`--fix` 可修部署形态(改完形态需重启一次让解析路径生效) |
318
317
  | 规则不生效 | 槽位动态发现,确认文件名 `audit-rules-<名>.yml` 且在 `lib/audit-rules/` |
319
318
  | 统计数字矛盾(0 blocker 0 warning 但 total > 0) | error 级计入拦截级,看 findings 的 `severity` |
@@ -12,7 +12,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
12
12
 
13
13
  ## 一、权威文件
14
14
 
15
- 插件配置目录下的 `git-push/dsh-repo-index.json`(解析顺序:`DSH_HOME/git-push/` → `~/.dsh/git-push/`)
15
+ 插件配置目录下的 `git-push/dsh-repo-index.jsonl`(JSONL,每行一个仓库;解析顺序:`DSH_HOME/git-push/` → `~/.dsh/git-push/`)
16
16
 
17
17
  | 事实 | 说明 |
18
18
  |------|------|
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: guide-audit
3
- description: dsh-git-push 代码审计:三个入口、审计范围、10 维度评分、规则包槽位、豁免机制、严重级与报告聚合。处理代码审计/质量评分类请求时加载。
4
- whenToUse: 要审计仓库、看质量分与问题明细、加停审计规则、豁免误报、查审计 API 时。
5
- updated: 2026-10-02
3
+ description: dsh-git-push 代码审计:三个入口、审计范围、10 维度评分、规则包槽位、豁免机制、严重级与报告聚合,以及低成本整改(提取公共函数一次动作多规则清零)。处理代码审计/质量评分/整改提分类请求时加载。
4
+ whenToUse: 要审计仓库、看质量分与问题明细、加停审计规则、豁免误报、查审计 API 时;要把审计分从 B 提到 A、低成本消 warning、规划重构整改时。
5
+ updated: 2026-10-18
6
6
  generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
7
7
  ---
8
8
 
@@ -144,6 +144,45 @@ console.log(x); // dsh-skip-residue: 本行为刻意保留的调试输出样本
144
144
  - `groupBy` 四维度:`rule`(规则类型,默认)/ `file` / `severity` / `slot`(规则包);`groups` 按条数降序,每组带一条 `sample`;`severity` 白名单过滤 + `top` 截断(`0` = 全部),过滤后条数见 `filtered`。
145
145
  - `exemptStats` 输出本次被豁免的类型与数量;`blocked` 直接列出 blocker 明细(文件 / 行 / 规则 / 消息);YAML 报告:HTTP `withYaml=true` → `yaml` 字段,工具 `includeFindings=true` 时含 `yaml`。
146
146
 
147
+ ### 13. 低成本整改:提取公共函数 = 一次动作多规则清零
148
+
149
+ **先看计分口径(决定性价比)**
150
+
151
+ | 口径 | 事实 | 含义 |
152
+ |---|---|---|
153
+ | 计数去重 | warning/info 按「规则 × 维度 × 文件」每文件每规则只计 1 次(blocker 每次计 2) | 同一文件同类问题修**一个代表点**,该文件对该规则的扣分即清零;warning 列表条数不受去重影响(想清空列表要逐条修或逐条豁免) |
154
+ | scoreImpact | `0` 的 finding 不计分(魔数、嵌套深度、重复字面量、低风险 io-risk 等) | 冲分先修 `scoreImpact=1` 的规则;`0` 的只影响 warning 条数 |
155
+ | 豁免等价 | 豁免标记会让 finding 直接消失、不计数 | 「修代码」与「加豁免」在**计分上等价**;区别只在代码质量本身与列表展示 |
156
+ | 对数衰减 | 单维度 `max(0.1, 10 - k·ln(1+问题数))`(k:安全 1.5 / 可读·可维护·健壮 1.3 / 性能 1.1) | 计数从 20 降到 10 的收益远大于 10 降到 0;先处理计数高的维度 |
157
+
158
+ **为什么提取公共函数最划算**
159
+
160
+ 函数太长 / 嵌套太深 / 圈复杂度高 / 重复调用 / 重复代码,根因都是「没抽出公共函数」。抽一次,多条规则同时消失:
161
+
162
+ | 规则 | 覆盖方式 |
163
+ |---|---|
164
+ | max-cyclomatic-complexity、max-nesting-depth、max-function-length | 直接:拆成子函数 + 早返回 |
165
+ | repeat-identical-call | 直接:重复调用合并进一个 helper |
166
+ | vague-function-name、variable-min-length、vague-variable-name | 顺带:提取时给函数/参数/局部变量起具名;契约要求导出名不变时用 `export { 具名实现 as run }`(模块仍只导出约定名) |
167
+ | magic-number-smart、duplicate-constant-def、no-repeated-hardcoded-literals | 顺带:提取时把字面量提成命名常量 |
168
+ | mkdir-before-write | 顺带:写操作移进公共函数后,写目标来自形参 ⇒ 规则语义豁免 |
169
+ | comment/no-date、hardcoded-absolute-path、io-risk、memory-bomb | **不覆盖**:需单独处理(删日期 / 提候选常量+行级豁免 / 异步化或行级豁免 / 接受) |
170
+
171
+ 实测(一次全量整改,29 文件):评分 83.0/B → 97.9/A,warning 99 → 5;其中「提取函数 + 顺带命名/常量化」覆盖约 55/99 条,其余 44 条是注释/路径/IO/内存类。
172
+
173
+ **危险级不高的前提(照做才安全)**
174
+
175
+ 1. 只搬运结构、不改行为:判断、异常、短路 return、错误处理边界保持原样。
176
+ 2. 三类**不拆、改豁免**:
177
+ - 跨回调共享闭包状态(如子进程 stdout/stderr/error/close/超时五路共享 settled 标志);
178
+ - 字符级扫描器(字符串/注释/括号三态一次遍历,拆开反而割裂状态机);
179
+ - 单调用点且拆完没有更清楚(过度抽象)。
180
+ 3. 同步改异步会外溢:io-risk 真修成 async 会波及整条同步调用链(CLI/测试),多数场景行级 `dsh-skip-residue` 更划算。
181
+ 4. 拆完必须复跑审计:新函数名/变量名可能触发新规则(实测:`handleXxxCommand` 被 io-risk 判成「请求处理路径」,把整文件同步 IO 从 low 升到 medium/high;局部变量取通用词名(如 result)会触发 vague-variable-name)。改名(如 `dispatchXxxCommand` / `actionResult`)后恢复。
182
+ 5. 验证闭环:`node --test` + 重新全量审计,确认分数只升不降、无新 blocker。
183
+
184
+ **操作顺序**:`groupBy=rule` 看明细 → 按「文件 × 规则」挑代表点 → 提取函数/常量/改名 → 复跑审计 → 只剩 `scoreImpact=1` 的顽固项时才逐条修或逐条豁免。
185
+
147
186
  ## 三、边界与坑
148
187
 
149
188
  | 现象 | 原因 | 处理 |
@@ -165,3 +204,38 @@ console.log(x); // dsh-skip-residue: 本行为刻意保留的调试输出样本
165
204
  | skills/guide/guide-cli-scripts.md | 独立 CLI 与脚本(含 `git-sluice`、`rule-switch`) |
166
205
  | skills/guide/guide-slash-completion.md | 输入框斜杠命令(`/git-audit`、`/link-check`) |
167
206
  | skills/guide/guide-clone-repos.md | 克隆仓库与本地仓库扫描 |
207
+
208
+ ## 14. 按插件架构修订规则,且按性价比取舍误报
209
+
210
+ 规则不是通用前端 linter:它主要服务于 **DSH 插件**这种架构,判定要贴合插件真实形态,
211
+ 否则「按通用项目写的判据」在插件上系统性失真。
212
+
213
+ **已按插件架构落地的适配**
214
+
215
+ | 插件架构事实 | 通用判据为何失真 | 规则怎么改 |
216
+ |---|---|---|
217
+ | 客户端是**构建产物**(`dsh.client` 指向单文件) | 产物行数天然超阈值 | `dsh-client-entry` 作用域降级为 info(仍报不扣分,不用 exempt 藏掉事实) |
218
+ | 源码按**分片**维护(`lib/client-parts/**` → 拼接) | 分片是片段,单文件语法都不成立;创建元素与绑定事件可能在不同分片 | 标准 `client-parts/` 由 exclude_dirs 跳过且规模规则按 `dsh-client-fragment` 降级;自定义分片目录由 button-bind 降级 info(完整判定交给产物) |
219
+ | 插件 UI 常用**事件委托** + 原生触发(label.click() 开文件框) | 只认 `addEventListener('click')` ⇒ 表单控件/文件框全被判未绑 | 按元素类型分流:button 要 click 类;input 接受 change/input/submit 等;`type=file` 有程序化触发即视为原生接好 |
220
+ | 测试聚合文件(每条 `rec(...)` 一个用例) | 「文件长」被判臃肿,且只认 `function` ⇒ 箭头用例全部计 0 行 | 识别箭头/方法简写/asynс 体;最大函数≤阈值 → 聚合型 info;无函数时文案改成「顶层语句堆叠」而不是「藏着超大函数」 |
221
+
222
+ **性价比取舍(不追求零误报)**
223
+
224
+ 先算「修判定的成本 vs 这类误报的出现频率与危害」,再决定:
225
+
226
+ - **值得修**:判定明确、可静态判定、且形态高频——如上面四类(事件类型、函数形态、产物/分片、聚合型文案)。
227
+ 这类修一次,整类消失。
228
+ - **不值得修(用豁免兜底)**:需要数据流/跨文件调用图才能证伪的判定——例如「事件委托是否真的覆盖某个
229
+ `createElement` 出来的按钮」、跨文件(非分片)绑定、运行时动态注入。做精确分析的成本远超收益,
230
+ 保留启发式判定 + `dsh-skip-quality` 文件头豁免。
231
+ - **不算误报**:规则判对了事实、只是不想改(如自包含 151 行组件、静态自检页的装饰按钮)——
232
+ 走豁免,不要改判定逻辑(否则会连带放过真问题)。
233
+
234
+ **豁免的前提**:标记必须**真能生效**。历史上多次出现「规则 exemptHint 写着 `dsh-skip-quality`,
235
+ 但该 kind 不在任何标记的 blocked 里」⇒ 用户按提示写了完全不生效(button-bind 就是 2026-10-24 补上的)。
236
+ 新增 kind 时同步检查 `exemptHintForFinding({kind})` 是否返回标记。
237
+
238
+ **判定引用范围时 grep 要 `-i`**:同一概念会以 `camelCase`/`PascalCase`/`SCREAMING_CASE`/`snake_case`
239
+ 多种形态出现,小写搜会漏(实测:搜 `partFilter` 漏掉 `setPartFilter`,误判「零引用」而删掉底层实现)。
240
+ 注意这只针对「人工核查引用」;规则内部的**标识符匹配必须保持大小写敏感**(JS/Python 本身区分大小写,
241
+ 放宽只会引入新误报)。
@@ -20,7 +20,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
20
20
  | `ruleset [槽位...]` | 编译规则包并输出统计 | 槽位名(可多个) |
21
21
  | `scan <root>` | 全量扫描目录(非 git 目录也能查) | `--depth N` |
22
22
  | `repos <root>` | 扫描本地 git 仓库(尊重 `.gitignore`,被忽略目录整棵跳过) | `--depth N`、`--max N`、`--json` |
23
- | `index <root>` | 重建仓库索引 `dsh-repo-index.json` | `--owner <账号>`、`--depth N`、`--max N`、`--offline`、`--json` |
23
+ | `index <root>` | 重建仓库索引 `dsh-repo-index.jsonl` | `--owner <账号>`、`--depth N`、`--max N`、`--offline`、`--json` |
24
24
  | `audit <root>` | 审计并输出质量评分与 findings | `--full`、`--level quick\|standard\|deep`、`--ruleset <目录>`、`--weights <JSON>`、`--include-ignored`、`--json` |
25
25
  | `commit <repo>` | 提交(可选推送) | `-m <msg>`、`--push`/`--no-push`、`--dry-run`、`--force`、`--req-confirm`、`--json` |
26
26
  | `link-check <路径>` | 检查 md/文本里的链接有效性(只 warning) | — |
@@ -71,10 +71,10 @@ git-sluice self-check
71
71
  | `scripts/scan-version.mjs` | 版本一致性校验(三处版本号是否同步) |
72
72
  | `scripts/doc-func.mjs` / `doc-tree.mjs` / `doc-version.mjs` | 函数列表 / 目录树 / 版本记录 三份文档与代码同步(`check` 查漂移、`apply` 写回) |
73
73
  | `scripts/readme-gen.mjs` | README 生成 |
74
- | `scripts/preview-gen.mjs`(默认生成 / `--data-only` 只更数据段 / `check` 漂移门禁 / `--watch` 监听) / `scripts/preview-server.mjs`(默认反代真后端 / `--direct` 直连插件 / `--local` 免重启) | 界面预览页生成与漂移门禁、本地真实后端测试服务 |
74
+ | (已迁移)dsh-useful-tools 的 `preview` 工具(action=gen / 只更数据段 / check` 漂移门禁 / `--watch` 监听) / ``preview` 工具 action=serve(dsh-useful-tools)`(默认反代真后端 / `--direct` 直连插件 / `--local` 免重启) | 界面预览页生成与漂移门禁、本地真实后端测试服务 |
75
75
  | `scripts/browser-page-probe.mjs` | 无头浏览器探针:读页面真实渲染文本 + 抓前端运行时错误(零硬编码路径,自动探测环境) |
76
- | `scripts/sync-plugin.mjs` | 同步(工作区 → 安装副本;**安装位置 = local-plugins 真源**)+ 部署形态与免重启热重载自检:`--profile <名>` 指定 profile(多 profile 必给)、`--fix` 只修 local-plugins 侧形态(解软链 / 建真实目录)。node_modules 入口由 DSH 安装流程生成,本脚本不建链;若那里的副本**内容与真源不一致**会报警(实测会顶掉真源;同 inode 硬链接副本不报) |
77
- | `scripts/sync-plugin-install.mjs` | 安装形态 / HMR 自检的实现模块(`sync-plugin.mjs` 引用,非独立入口) |
76
+ | ``sync_plugin` 工具(dsh-useful-tools)` | 同步(工作区 → 安装副本;**安装位置 = local-plugins 真源**)+ 部署形态与免重启热重载自检:`--profile <名>` 指定 profile(多 profile 必给)、`--fix` 只修 local-plugins 侧形态(解软链 / 建真实目录)。node_modules 入口由 DSH 安装流程生成,本脚本不建链;若那里的副本**内容与真源不一致**会报警(实测会顶掉真源;同 inode 硬链接副本不报) |
77
+ | ``sync_plugin` 工具的实现(dsh-useful-tools/lib/core/plugin-sync/install.mjs)` | 安装形态 / HMR 自检的实现模块(`sync-plugin.mjs` 引用,非独立入口) |
78
78
  | `scripts/verify-prestep.mjs` | 上下文注入自检(真实触发 pre-step 校验注入内容) |
79
79
  | `scripts/rename-locator.mjs` | 变量重命名位置定位(按作用域聚合) |
80
80
  | `scripts/rules-solo-audit.mjs` | 单条 yml 规则的控制变量评估 |
@@ -22,7 +22,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
22
22
  | 本地仓库扫描 | `git_scan` 逐层下钻列仓库:分支 / 远端(脱敏)/ 未提交数 / 最近提交 / 领先落后 |
23
23
  | 远端仓库管理 | `git_remote_create` 建仓(默认 private,已存在则复用并设 origin);`git_set_visibility` 切 public/private |
24
24
  | 账号与配额 | 账号状态(离线读快照)/ 在线校验 / API 配额查询(`/rate_limit`,不消耗配额) |
25
- | 仓库索引 | 推送成功、云端加载、本地扫描时维护 `dsh-repo-index.json`;本地仓库列表据此标注每个仓库的 GitHub 归属 |
25
+ | 仓库索引 | 推送成功、云端加载、本地扫描时维护 `dsh-repo-index.jsonl`;本地仓库列表据此标注每个仓库的 GitHub 归属 |
26
26
 
27
27
  ## 二、怎么用(工具 + HTTP 接口参数表与返回字段)
28
28
 
@@ -169,5 +169,5 @@ git_set_visibility({ repo: "<本地仓库路径>", visibility: "private" })
169
169
  | `git_commit_push` | 克隆完成后的提交推送(审计门禁 + 凭据注入);推送成功会重建仓库索引 |
170
170
  | `git_sluice` | 在克隆下来的仓库里执行 log/diff/branch 等 git 命令(凭据自动注入) |
171
171
  | `git_account_check` / `git_cred_env` | 克隆私有库前先确认 token/SSH 可用;外部命令取凭据环境前缀 |
172
- | `dsh-repo-index.json` | 仓库索引(权威源码索引,存插件配置目录 `DSH_HOME/git-push/`):记录每个项目的仓库地址、可见性、恢复命令 `cloneCmd`、skills 与本地 `path`,`version` 恒为 1、`generatedAt` 每次刷新;源码丢失时按它 `git_clone` 恢复,本地列表据此标注仓库归属 |
172
+ | `dsh-repo-index.jsonl` | 仓库索引(权威源码索引,存插件配置目录 `DSH_HOME/git-push/`):记录每个项目的仓库地址、可见性、恢复命令 `cloneCmd`、skills 与本地 `path`,`version` 恒为 1、`generatedAt` 每次刷新;源码丢失时按它 `git_clone` 恢复,本地列表据此标注仓库归属 |
173
173
  | 侧边栏「账号信息 → 仓库管理」 | 本地子选项卡按索引标注归属并可 `push`;云端子选项卡「加载仓库列表」选目录后走同一套后台克隆 |
@@ -19,7 +19,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
19
19
  | 改插件配置/开关 | 只改插件私有 `config.json`(侧边栏保存即写它);不要写公共 `settings.yaml` |
20
20
  | 看界面上的真实数据 | 用 `assets/start.sh` 起预览反代(默认真实后端),不要只看静态 HTML 文件 |
21
21
  | 刷新账号信息 / 本地仓库列表 | 只在三种时机读取;不轮询、不监听索引文件,页面切 tab 不会刷新 |
22
- | 改了前端界面代码 | 先重新生成预览页(`node scripts/preview-gen.mjs`)再看,否则看的是旧界面 |
22
+ | 改了前端界面代码 | 先用 dsh-useful-tools 的 `preview` 工具(`action=gen`)重生成预览页再看,否则看的是旧界面 |
23
23
 
24
24
  ## 二、怎么做 / 命令 / 实例
25
25
 
@@ -107,7 +107,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
107
107
 
108
108
  | 时机 | 账号信息 | 本地仓库列表 |
109
109
  |---|---|---|
110
- | 插件启动(侧边栏加载) | 离线读 `account-status.json` | 离线读 `dsh-repo-index.json` |
110
+ | 插件启动(侧边栏加载) | 离线读 `account-status.json` | 离线读 `dsh-repo-index.jsonl` |
111
111
  | 云端 push 完成后 | 离线读(push 时已在线更新 json) | 离线读(push 时已重建索引) |
112
112
  | 手动刷新 | `重新检测` = 在线校验写 json,再离线读回 | `扫描` = 独立进程后台离线扫描,逐条追加 |
113
113
 
@@ -115,7 +115,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
115
115
 
116
116
  ### 2.6 界面预览页(assets/preview.html,真实后端数据)
117
117
 
118
- 预览页由 `scripts/preview-gen.mjs` 生成(内联真实前端代码,只垫片宿主环境),界面与真实插件一致;用 `assets/start.sh` 起本地反代服务访问:
118
+ 预览页由 **dsh-useful-tools** 的 `preview` 工具生成(`action=gen`)(内联真实前端代码,只垫片宿主环境),界面与真实插件一致;用 `assets/start.sh` 起本地反代服务访问:
119
119
 
120
120
  ```bash
121
121
  ./assets/start.sh start [--port 31000] # 默认 30999;端口被别的项目占用时用 --port 错开
@@ -123,11 +123,11 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
123
123
  ```
124
124
 
125
125
  - 访问 `http://<本机IP>:30999`(默认端口)。反代把 `/api/git-push/*` 全部转发到真实 DSH 后端(默认 `http://<本机IP>:30800`),并自动完成 token 认证——账号信息 / 本地仓库 / 云端仓库 / 规则包 / 审计结果 / 设置全部来自真实后端,读取与写入都真实。
126
- - 指定后端或直接跑:`node scripts/preview-server.mjs --port 30999 --dsh http://<本机IP>:30800 --token <launch-token>`(同一入口还有 `--direct` 直连插件 handleHttp、`--local` 每请求 fork 子进程跑工作区最新代码);token 解析顺序:`--token` > 环境变量 `DSH_PREVIEW_TOKEN` > 解析 `dsh-proxy.log` 兜底。
126
+ - 指定后端或直接跑:`preview` 工具 `action=serve`(port / backend 参数)(同一入口还有 `--direct` 直连插件 handleHttp、`--local` 每请求 fork 子进程跑工作区最新代码);token 解析顺序:`--token` > 环境变量 `DSH_PREVIEW_TOKEN` > 解析 `dsh-proxy.log` 兜底。
127
127
  - 离线调试:URL 加 `?mock=1` 切内置假数据(改动只留页面内、不写文件);跨后端实测:URL 加 `?backend=http://<本机IP>:端口`。
128
128
  - 全部可点:三选项卡切换、审计开关、注入系统提示词开关、注入要求清单子开关(含置灰联动)、规则包启停与调序、权重编辑、token/SSH 保存、邮箱一键生成 SSH 并回填。
129
129
  - 健康检查 `GET /preview-ping`;PID 落 `dsh-git-push.pid`(插件根);日志 `assets/preview-server.log`(超 10 MB 轮转)。
130
- - 改了前端代码后同步预览:`node scripts/preview-gen.mjs`。
130
+ - 改了前端代码后同步预览:`preview` 工具 `action=gen`。
131
131
 
132
132
  ### 2.7 配置持久化位置
133
133
 
@@ -137,7 +137,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
137
137
  |---|---|
138
138
  | `config.json` | 全部设置与凭据真源(0600):开关、扫描范围、文件上限、权重覆盖、规则包顺序、推送通道/门禁、自动推送、`githubToken`、`sshPub`,以及可选的 `injectUsageText` |
139
139
  | `account-status.json` | 账号快照:登录名、是否登录、token/SSH 各自有效性与校验时间 |
140
- | `dsh-repo-index.json` | 仓库索引:本地/云端仓库的归属、可见性、路径、默认分支、领先/落后等(自动生成,请勿手改) |
140
+ | `dsh-repo-index.jsonl` | 仓库索引:本地/云端仓库的归属、可见性、路径、默认分支、领先/落后等(自动生成,请勿手改) |
141
141
  | `scan-live.json` | 本地扫描进度:`version` / 已发现仓库 / 是否完成 |
142
142
  | `tools.json` | 工具探测结果(工具名 → 本机实测路径) |
143
143
  | `settings-ui.log` | 侧边栏每次保存设置的追加日志(凭据值打码) |
@@ -18,4 +18,4 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
18
18
  ## 已内置化
19
19
 
20
20
  - 开发者要求清单 → `lib/user-requirements.json`(随插件分发;v2 未移植,待验收)
21
- - 仓库索引 → 废弃 md 表格,改用 JSON 索引(生成于插件配置目录的 `dsh-repo-index.json`)
21
+ - 仓库索引 → 废弃 md 表格,改用 JSON 索引(生成于插件配置目录的 `dsh-repo-index.jsonl`)
@@ -1,35 +0,0 @@
1
- #!/usr/bin/env bash
2
- # dsh-plugin mini-host 一键启动 —— 本地跑本插件服务端代码,**改完代码刷新页面即生效**,
3
- # 既不用重启 DSH 宿主、也不用重启本服务(每个请求 fork 一次性子进程,插件模块天然新鲜)。
4
- #
5
- # 依赖通用工具:dsh-plugin-minihost.mjs(+ dsh-plugin-minihost-child.mjs)
6
- # 位置:技能仓库 ai-work-archive/skills/,或运行时目录 <DSH_HOME>/skills/
7
- # 用法:
8
- # bash assets/minihost.sh # 默认端口 31100
9
- # bash assets/minihost.sh --port 31200 # 换端口(其余参数透传给 mini-host)
10
- # 环境变量:
11
- # DSH_SKILLS_DIR 指定含通用工具的 skills 目录(默认 $DSH_HOME/skills 或 ~/.dsh/skills)
12
- # PORT 默认端口(默认 31100)
13
- # NODE_BIN 指定 node(默认 PATH 里的 node)
14
- set -uo pipefail
15
- ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
16
- SKILLS_DIR="${DSH_SKILLS_DIR:-${DSH_HOME:-$HOME/.dsh}/skills}"
17
- TOOL="$SKILLS_DIR/dsh-plugin-minihost.mjs"
18
- if [ ! -f "$TOOL" ]; then
19
- echo "找不到通用工具:$TOOL"
20
- echo "请设置 DSH_SKILLS_DIR 指向含 dsh-plugin-minihost.mjs 的 skills 目录"
21
- exit 2
22
- fi
23
- ARGS=(--plugin "$ROOT" --port "${PORT:-31100}")
24
- # 预览页是**生成产物**(.gitignore 已忽略,不入库):缺失时先自动生成一次,
25
- # 否则 --preview 分支会**静默跳过**(页面打开是 404/无预览页,且没有任何报错)。
26
- PREVIEW_HTML="$ROOT/assets/preview.html"
27
- PREVIEW_GEN="$ROOT/scripts/preview-gen.mjs"
28
- if [ ! -f "$PREVIEW_HTML" ] && [ -f "$PREVIEW_GEN" ]; then
29
- echo "[minihost] 预览页缺失,先生成一次:node scripts/preview-gen.mjs"
30
- "${NODE_BIN:-node}" "$PREVIEW_GEN" >/dev/null 2>&1 \
31
- || echo "[minihost] 预览页生成失败(继续启动,但不带预览页)"
32
- fi
33
- [ -f "$PREVIEW_HTML" ] && ARGS+=(--preview "$PREVIEW_HTML")
34
- [ -d "$ROOT/lib" ] && ARGS+=(--static "$ROOT/lib")
35
- exec "${NODE_BIN:-node}" "$TOOL" "${ARGS[@]}" "$@"