dsh-git-push 2.20.11 → 2.20.18

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 (58) hide show
  1. package/README.md +10 -6
  2. package/cli-audit.mjs +141 -0
  3. package/cli-tool.mjs +86 -0
  4. package/cli.mjs +114 -335
  5. package/lib/app/command-registry.js +3 -2
  6. package/lib/app/constants.js +9 -0
  7. package/lib/app/handlers/clone.js +12 -3
  8. package/lib/app/handlers/http-constants.js +11 -2
  9. package/lib/app/handlers/npm.js +4 -2
  10. package/lib/app/handlers/repos.js +10 -1
  11. package/lib/app/handlers/settings.js +9 -1
  12. package/lib/app/http-handlers.js +24 -3
  13. package/lib/app/schema-audit.js +42 -0
  14. package/lib/app/schema.js +19 -19
  15. package/lib/app/settings-bridge.js +51 -0
  16. package/lib/app/tool-call.js +7 -5
  17. package/lib/audit-rules/audit-rules-paths.yml +7 -1
  18. package/lib/audit-ui-sdk/contract.js +117 -0
  19. package/lib/audit-ui-sdk/index.js +17 -0
  20. package/lib/checks/regex.js +6 -1
  21. package/lib/cli/commands-audit.mjs +12 -17
  22. package/lib/cli/commands-tool.mjs +93 -0
  23. package/lib/cli/commands-vcs.mjs +2 -1
  24. package/lib/cli/shared.mjs +448 -0
  25. package/lib/client-parts/{account.js → git/account.js} +1 -1
  26. package/lib/client-parts/{actions.js → git/actions.js} +26 -11
  27. package/lib/client-parts/{apply.js → git/apply.js} +1 -1
  28. package/lib/client-parts/{browser.js → git/browser.js} +1 -1
  29. package/lib/client-parts/{const.js → git/const.js} +6 -1
  30. package/lib/client-parts/{controller.js → git/controller.js} +23 -11
  31. package/lib/client-parts/{icons.js → git/icons.js} +1 -1
  32. package/lib/client-parts/{loader.js → git/loader.js} +1 -1
  33. package/lib/client-parts/{npm.js → git/npm.js} +1 -1
  34. package/lib/client-parts/{page.js → git/page.js} +11 -21
  35. package/lib/client-parts/{repo.js → git/repo.js} +1 -1
  36. package/lib/client-parts/{settings.js → git/settings.js} +1 -1
  37. package/lib/client-parts/{utils.js → git/utils.js} +1 -1
  38. package/lib/client.js +75 -354
  39. package/lib/commit-push/pre-commit-engine.js +388 -0
  40. package/lib/commit-push.js +42 -20
  41. package/lib/git/transport.js +31 -10
  42. package/lib/http/index.js +82 -10
  43. package/lib/npm/npmrc.js +22 -5
  44. package/lib/self/index.js +1 -1
  45. package/package.json +6 -2
  46. package/scripts/audit-gate.mjs +235 -0
  47. package/scripts/build-client.mjs +15 -8
  48. package/scripts/check.mjs +12 -3
  49. package/scripts/scan-file-io.mjs +5 -1
  50. package/scripts/scan-version.mjs +10 -7
  51. package/skills/dev/dsh-git-push.md +62 -0
  52. package/skills/guide/guide-audit.md +11 -11
  53. package/skills/guide/guide-cli-scripts.md +3 -3
  54. package/skills/guide/guide-commit-push.md +2 -2
  55. package/skills/guide/guide-inject-ui.md +0 -16
  56. package/assets/start.sh +0 -396
  57. package/scripts/scan-hardcoded-paths.mjs +0 -125
  58. /package/lib/client-parts/{audit.js → audit/audit.js} +0 -0
@@ -187,6 +187,12 @@ pnpm add github:EIGHTfs/dsh-git-push#<commit>
187
187
 
188
188
  ### 7.3 客户端 UI 三选项卡重写(2026-09-12)
189
189
 
190
+ > ⚠️ **现状变更(2026-11-08)**:UI 与审计解耦后,**审计 Tab 已移出构建**,页面现为**两选项卡**
191
+ > (账号信息 / 设置)。审计侧分片归档在 `lib/client-parts/audit/`(不参与构建),
192
+ > git 侧分片在 `lib/client-parts/git/`(13 片,参与构建)。**后端审计能力完全不变**
193
+ > (提交门禁、code_audit 等 5 个工具、4 个 HTTP 接口、审计设置键全部保留)。
194
+ > 下文的「三选项卡」描述的是当时形态,保留作历史记录。
195
+
190
196
  **用户决策**:删设置配置卡(`settings.plugin.item`),只保留侧边栏独立页(`settings.section`),页面重写为**三个大选项卡**(对齐插件市场 .tabs/.tab/.on,参考 skill 记分板):
191
197
 
192
198
  1. **账号信息**(纯展示):`GET /api/git-push/account-check` → GitHub 登录态/用户名/公钥指纹/套餐,`block` 文本直接展示。
@@ -317,8 +323,64 @@ pnpm add github:EIGHTfs/dsh-git-push#<commit>
317
323
  | 豁免写了没用 | 整文件豁免须在前 3 行;行级豁免须写在命中行 |
318
324
  | 函数/复杂度被报为 blocker | 规则 `severity` 是上限,检查器不越级;报 blocker 说明 yml 里写的就是 error/blocker |
319
325
  | 克隆大文件反复失败 | 失败项的分片必须保留(`.dsh-parts`)才能跨轮 Range 续传;同轮清理分片会让大文件永远从 0 重来 |
326
+ | **桌面端(`dsh-app://`)设置页保存全部失效、GET 正常** | 桌面壳 `forwardWebRequest` 转发 `/api/*` 时**显式剥离 Origin**(`headers.delete('origin')`,只补 cookie),插件写请求鉴权对无 Origin 一律 403。2.20.17 起放行「无 Origin + `Content-Type: application/json` + **本机来源**」,本机判定以 TCP 对端地址(`req.socket.remoteAddress`)为准、`Host` 只做兜底——`Host` 可被客户端伪造(`Host: 127.0.0.1`),且实测某些转发链路会丢 Host;仍不通就看 `<DSH_HOME>/git-push/http-rejects.log`(2.20.17 恢复,记 method/url/origin/host/code);**排查前先完全退出应用重开**——见下一行 |
327
+ | **补丁改了不生效,误判「补丁无效」** | DSH 宿主的 HMR `profileRoots` 只收集**符号链接**形式的插件包;**复制安装(真实目录)** 的插件在插件页开关切换只重启 fiber,**ESM 缓存仍是旧代码**。⇒ 验证服务端补丁必须**完全退出应用重开**,否则会把「缓存没刷新」误判成「改错了」(外部报告实测踩到,2026-11-13 记入) |
320
328
  | 建了远端但推送报「远端查不到分支 master(API 404 / ls-remote 无该分支)」 | `git_remote_create` 旧版把 origin 写成 **REST API 端点**(`https://api.github.com/repos/<o>/<r>` ✗ 那不是 git remote)⇒ `git push/fetch origin` 必然失败。2026-10-09 已修(`lib/git/remote.js`):origin 统一写 `https://github.com/<o>/<r>`,并**自愈**——仓库已存在但 origin 仍是 API 形态时 `set-url` 改回;返回体新增 `originAction`(`add`/`repair`/`keep`)。旧仓库手工修:`git remote set-url origin ssh://git@ssh.github.com:443/<o>/<r>.git` 再 `git push -u origin master`(凭据用插件 `id_rsa` + `-p 443`)。⚠️ `lib/git/clone.js` 仍写 API 形态 origin(设计如此,插件自身推送不受影响,但 `git push origin` 会失败) |
321
329
 
330
+ ## 附录 F、在测试环境真机验证插件改动(可复用步骤)
331
+
332
+ > 2026-11-13 实测走通(验证 2.20.17 的桌面端鉴权修复)。用途:改完插件要拿真实 HTTP 验证时,
333
+ > 不必影响主实例。**三个坑不处理就永远 404 / 加载失败**,按下面顺序做。
334
+
335
+ ### 步骤
336
+
337
+ ```
338
+ ① 起环境:test_env({ action:'start', plugin:'<插件根>' })
339
+ ⚠️ 坑 1:`plugin` 参数**不会真的安装插件**,local-plugins/ 仍为空 ⇒ API 全 404。
340
+ ② 显式安装 + 注册:
341
+ sync_plugin({ dshHome:'<测试环境目录>', pluginName:'<插件名>',
342
+ source:'<插件根>', write:true, register:true })
343
+ ③ 补运行时依赖(插件有静态 import 时必需):
344
+ cp -r <插件根>/node_modules <测试环境>/profiles/web/local-plugins/<插件名>/node_modules
345
+ ⚠️ 坑 2:不复制会在加载期缺 js-yaml / web-tree-sitter / tree-sitter-wasms。
346
+ (不要用软链把外部 node_modules 挂进项目——那是 no-symlink 禁止的形态)
347
+ ④ 建 bundle 解析路径:
348
+ mkdir -p <测试环境>/profiles/web/node_modules
349
+ ln -s ../local-plugins/<插件名> <测试环境>/profiles/web/node_modules/<插件名>
350
+ ⚠️ 坑 3:DSH 从 profiles/web/node_modules 解析 profile bundle,
351
+ 缺这条会报 `cannot resolve profile bundle "<插件名>"`。这是**部署安装形态**
352
+ (与主实例一致:dependencies 用 link:local-plugins/<插件名>),不是项目内软链。
353
+ ⑤ 重启环境:test_env({ action:'stop' }) → test_env({ action:'start' })
354
+ ⑥ 取访问令牌:`grep -oE 'token=[A-Za-z0-9._-]+' <测试环境>/dsh-env.log | tail -1`
355
+ (**不要把它打印到会话里**)
356
+ ⑦ 换 cookie:`curl -c /tmp/tc.txt "http://127.0.0.1:<port>/?token=<token>"`
357
+ —— 不带 cookie 直接打 API 会得到 401 unauthorized。
358
+ ⑧ 验证完停环境:test_env({ action:'stop' })
359
+ ```
360
+
361
+ ### 验证鉴权类改动时的请求形态对照
362
+
363
+ ```bash
364
+ # 桌面端转发形态(无 Origin + JSON)—— 期望 200
365
+ curl -b /tmp/tc.txt -X POST -H 'Content-Type: application/json' \
366
+ -d '{"key":"npmRegistry","value":"https://registry.npmjs.org/"}' \
367
+ http://127.0.0.1:<port>/api/git-push/settings-set
368
+
369
+ # 跨站表单形态(无 Origin + text/plain)—— 期望 403 NO_ORIGIN
370
+ curl -b /tmp/tc.txt -X POST -H 'Content-Type: text/plain' \
371
+ -d '{"key":"npmRegistry","value":"x"}' \
372
+ http://127.0.0.1:<port>/api/git-push/settings-set
373
+ ```
374
+
375
+ ### 判据与副作用
376
+
377
+ - **拒绝日志**:每次 403 都会写 `<测试环境>/git-push/http-rejects.log`(method/url/origin/host/code),
378
+ `cat` 它就能确认「拒绝确实发生、原因是什么」——这是验证可诊断性的唯一直接证据。
379
+ - **远端 socket 造不出来**:真机只能证明「本机 socket 放行」;
380
+ 「远端 socket + 伪造 Host ⇒ 拒」必须靠单测传 `remoteAddress` 断言(本仓库 `test-origin-desktop.mjs` 第 15 例)。
381
+ - **副作用**:测试环境是隔离 DSH_HOME,往里写假凭据无害;但它会占端口(3083–3182)与磁盘
382
+ (node_modules 副本约 50MB+),验证完按低负载纪律停掉。
383
+
322
384
  ## 端点:AI 自设工作区路径(workspace-paths)
323
385
 
324
386
  环境注入里的「当前工作目录 cwd」原先取自**会话文件**(`agent.session.header.cwd`),实测可能是**陈旧路径**
@@ -14,7 +14,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
14
14
 
15
15
  | 场景 | 必须做的 |
16
16
  |---|---|
17
- | 要审计一个仓库 | 会话内用工具 `code_audit`;只看聚合明细用 HTTP `/api/git-push/audit`;脱离 DSH 用 `git-sluice audit` |
17
+ | 要审计一个仓库 | 会话内用工具 `code_audit`;只看聚合明细用 HTTP `/api/git-push/audit`;脱离 DSH 用 `audit-sluice audit` |
18
18
  | 判断能否提交 | 门禁只认 `blocker`,命中即拦;`warning` / `notice` 只提示不拦 |
19
19
  | 遇到误报 | 先按判定类型选已有豁免机制;结构性误报优先修审计判定,不靠注释掩盖 |
20
20
  | 新增 / 停用规则 | 只改规则 yml(放文件即生效、删文件即移除),不改代码 |
@@ -28,7 +28,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
28
28
  |---|---|---|
29
29
  | 工具 | `code_audit` | 默认精简输出(评分 / 各级数量 / 豁免统计 / API 指引);`includeFindings=true` 出全量 |
30
30
  | HTTP | `GET/POST /api/git-push/audit` | 请求时聚合:分组 / 严重级过滤 / 条数截断;默认全量范围 |
31
- | CLI | `git-sluice audit <目录>` | 独立运行(零第三方依赖,Node ≥18 + 本机 git),`--json` 出全量 |
31
+ | CLI | `audit-sluice audit <目录>` | 独立运行(零第三方依赖,Node ≥18 + 本机 git),`--json` 出全量 |
32
32
 
33
33
  ### 2. 工具 `code_audit` 参数
34
34
 
@@ -61,16 +61,16 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
61
61
 
62
62
  返回:`ok`、`repo`、`scope`、`files`、`summary`、`quality{score,level}`、`groups[]`(按条数降序,每组含一条 `sample`)、`total`、`filtered`、`exemptStats`、`groupByTypes`、`blocked[]`。
63
63
 
64
- ### 4. CLI(`git-sluice audit`)
64
+ ### 4. CLI(`audit-sluice audit`)
65
65
 
66
66
  ```bash
67
- git-sluice audit . # 变动范围(非 git 目录自动全量)
68
- git-sluice audit . --full # 全量
69
- git-sluice audit . --ruleset <规则目录> # 自定规则目录
70
- git-sluice audit . --weights '{"安全性":25}' # 权重覆盖 JSON
71
- git-sluice audit . --include-ignored # 连 .gitignore 忽略的文件也扫
72
- git-sluice audit . --json # 全量 findings + yaml
73
- git-sluice audit . --history --since <提交> --until <提交> --out <目录>
67
+ audit-sluice audit . # 变动范围(非 git 目录自动全量)
68
+ audit-sluice audit . --full # 全量
69
+ audit-sluice audit . --ruleset <规则目录> # 自定规则目录
70
+ audit-sluice audit . --weights '{"安全性":25}' # 权重覆盖 JSON
71
+ audit-sluice audit . --include-ignored # 连 .gitignore 忽略的文件也扫
72
+ audit-sluice audit . --json # 全量 findings + yaml
73
+ audit-sluice audit . --history --since <提交> --until <提交> --out <目录>
74
74
  ```
75
75
 
76
76
  CLI 读与插件同一份配置(`$DSH_HOME/git-push/config.json`);权重优先级:显式 `--weights` > 配置 `weightOverrides` > 默认权重表。CLI 与插件用同一实现、同一配置,同一仓库同一参数结果一致。
@@ -133,7 +133,7 @@ console.log(x); // dsh-skip-residue: 本行为刻意保留的调试输出样本
133
133
 
134
134
  ### 10. 链接检查(link_check)
135
135
 
136
- 工具 `link_check`(`path` = 文件或目录,默认工作区)、CLI `git-sluice link-check <路径>`、斜杠命令 `/link-check [文件或目录]`。扫描 md / 文本内 URL 并访问验证:404 / 403 / 410 / 451 → 扣 3,DNS 失败 → 扣 2,超时 / 连接失败 / 5xx → 扣 1;只 warning,永不 blocker。配置 `linkCheckEnabled` 默认关(需要网络)。
136
+ 工具 `link_check`(`path` = 文件或目录,默认工作区)、CLI `audit-sluice link-check <路径>`、斜杠命令 `/link-check [文件或目录]`。扫描 md / 文本内 URL 并访问验证:404 / 403 / 410 / 451 → 扣 3,DNS 失败 → 扣 2,超时 / 连接失败 / 5xx → 扣 1;只 warning,永不 blocker。配置 `linkCheckEnabled` 默认关(需要网络)。
137
137
 
138
138
  ### 11. 文档漂移检查(函数列表 / 目录树 / 版本表)
139
139
 
@@ -41,11 +41,11 @@ CLI 是同一引擎的独立入口,**不另写一份逻辑**:
41
41
 
42
42
  ```bash
43
43
  git-sluice version
44
- git-sluice audit . --full --json
44
+ audit-sluice audit . --full --json
45
45
  git-sluice repos /path/to/workspace --max 50 --json
46
46
  git-sluice index /path/to/workspace --owner EIGHTfs --offline
47
- git-sluice commit /path/to/repo -m "fix: 修正 xx" --no-push
48
- git-sluice self-check
47
+ git-sluice commit /path/to/repo --message "fix: 修正 xx" --no-push
48
+ tool-sluice self-check
49
49
  ```
50
50
 
51
51
  ## 二、随插件发布的独立脚本
@@ -181,9 +181,9 @@ git_commit_push({ repo: "<仓库路径>", message: "chore: 重写历史后同步
181
181
  2. 需要 **why / verify 溯源**(评审时要能看出「为什么改」与「怎么验证的」✓)
182
182
 
183
183
  **不该硬用** ✗:一句话就能说清时用字符串即可 ✓(强行结构化只增加噪音)。
184
- CLI(`git-sluice commit <仓库> -m "msg"`)只支持字符串 ✓;`messageItems` 走工具/HTTP API ✓。
184
+ CLI(`git-sluice commit <仓库> --message "msg"`)只支持字符串 ✓;`messageItems` 走工具/HTTP API ✓。
185
185
 
186
186
  **该用却没用会怎样**:不会失败 ✓;但当单串信息偏长(>150 字符或含换行)时,工具结果会带
187
187
  `usageHint` 提醒改用 `messageItems` ✓;采用率留痕在 `<DSH_HOME>/git-push/commit-usage.log`
188
188
  (每行一条 JSON:`structured` / `items` / `msgLen` / `repo` ✓,可据此统计实际采用率)。
189
- | CLI | `git-sluice commit <仓库> -m "msg"` 与工具同源(审计门禁一致);CLI 默认只提交,加 `--push` 才推 |
189
+ | CLI | `git-sluice commit <仓库> --message "msg"` 与工具同源(审计门禁一致);CLI 默认只提交,加 `--push` 才推 |
@@ -17,7 +17,6 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
17
17
  | 判断「AI 为什么看得到/看不到插件功能」 | 先看总开关「注入系统提示词/上下文」;它同时门控两条通道(系统提示词 + 上下文),关掉后两条都不注入 |
18
18
  | 确认某个注入段是否生效 | 按生效条件逐项核对,不能只看总开关:要求清单段还要「提交前自动审计」+「↳ 注入开发者要求清单」同时开 |
19
19
  | 改插件配置/开关 | 只改插件私有 `config.json`(侧边栏保存即写它);不要写公共 `settings.yaml` |
20
- | 看界面上的真实数据 | 用 `assets/start.sh` 起预览反代(默认真实后端),不要只看静态 HTML 文件 |
21
20
  | 刷新账号信息 / 本地仓库列表 | 只在三种时机读取;不轮询、不监听索引文件,页面切 tab 不会刷新 |
22
21
  | 改了前端界面代码 | 先用 dsh-useful-tools 的 `preview` 工具(`action=gen`)重生成预览页再看,否则看的是旧界面 |
23
22
 
@@ -113,21 +112,6 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
113
112
 
114
113
  登录判定为「或」:SSH 或 token 任一有效即视为已登录,用户名取有效者。
115
114
 
116
- ### 2.6 界面预览页(assets/preview.html,真实后端数据)
117
-
118
- 预览页由 **dsh-useful-tools** 的 `preview` 工具生成(`action=gen`)(内联真实前端代码,只垫片宿主环境),界面与真实插件一致;用 `assets/start.sh` 起本地反代服务访问:
119
-
120
- ```bash
121
- ./assets/start.sh start [--port 31000] # 默认 30999;端口被别的项目占用时用 --port 错开
122
- ./assets/start.sh status / restart / stop
123
- ```
124
-
125
- - 访问 `http://<本机IP>:30999`(默认端口)。反代把 `/api/git-push/*` 全部转发到真实 DSH 后端(默认 `http://<本机IP>:30800`),并自动完成 token 认证——账号信息 / 本地仓库 / 云端仓库 / 规则包 / 审计结果 / 设置全部来自真实后端,读取与写入都真实。
126
- - 指定后端或直接跑:`preview` 工具 `action=serve`(port / backend 参数)(同一入口还有 `--direct` 直连插件 handleHttp、`--local` 每请求 fork 子进程跑工作区最新代码);token 解析顺序:`--token` > 环境变量 `DSH_PREVIEW_TOKEN` > 解析 `dsh-proxy.log` 兜底。
127
- - 离线调试:URL 加 `?mock=1` 切内置假数据(改动只留页面内、不写文件);跨后端实测:URL 加 `?backend=http://<本机IP>:端口`。
128
- - 全部可点:三选项卡切换、审计开关、注入系统提示词开关、注入要求清单子开关(含置灰联动)、规则包启停与调序、权重编辑、token/SSH 保存、邮箱一键生成 SSH 并回填。
129
- - 健康检查 `GET /preview-ping`;PID 落 `dsh-git-push.pid`(插件根);日志 `assets/preview-server.log`(超 10 MB 轮转)。
130
- - 改了前端代码后同步预览:`preview` 工具 `action=gen`。
131
115
 
132
116
  ### 2.7 配置持久化位置
133
117
 
package/assets/start.sh DELETED
@@ -1,396 +0,0 @@
1
- #!/usr/bin/env bash
2
- # ============================================================
3
- # dsh-git-push 预览服务器启停脚本(模板源:bench-template/server/lib/preview/start.sh,下发改自用)
4
- # 用法:
5
- # ./start.sh start [--port PORT]
6
- # ./start.sh restart [--port PORT] # 默认命令
7
- # ./start.sh stop
8
- # ./start.sh status
9
- # ./start.sh --port PORT # 兼容旧用法(等价 restart)
10
- # PID:插件根 / dsh-git-push.pid(见 pid-file-at-project-root)
11
- # ============================================================
12
- set -uo pipefail
13
-
14
- # 脚本落在 assets/;ROOT 上溯到插件根
15
- ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
16
- PROJECT_NAME="$(basename "$ROOT")"
17
- # 预览服务入口:scripts/preview-server.mjs(2026-10-13 合并后单入口;--local/--shot/--direct 均在其内部)
18
- # 服务工作目录仍取脚本所在目录(assets/),入口用绝对路径调用,与 cwd 无关。
19
- SERVER_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
20
- SERVER_ENTRY="$ROOT/scripts/preview-server.mjs"
21
- PID_FILE="$ROOT/${PROJECT_NAME}.pid"
22
- LOG_FILE="$SERVER_DIR/preview-server.log"
23
- DEFAULT_PORT="${DEFAULT_PORT:-30999}"
24
- LOG_ROTATE_BYTES=$((10 * 1024 * 1024))
25
- STOP_WAIT_SEC=10
26
- START_WAIT_SEC="${START_WAIT_SEC:-15}"
27
-
28
- # ---------- 颜色 ----------
29
- C_GREEN="" C_YELLOW="" C_RED="" C_DIM="" C_RESET=""
30
- if [ -t 1 ] && [ -z "${NO_COLOR:-}" ] && [ "${TERM:-}" != "dumb" ]; then
31
- C_GREEN=$'\033[32m'
32
- C_YELLOW=$'\033[33m'
33
- C_RED=$'\033[31m'
34
- C_DIM=$'\033[2m'
35
- C_RESET=$'\033[0m'
36
- fi
37
- ok() { printf '%s%s%s\n' "$C_GREEN" "$*" "$C_RESET"; }
38
- warn() { printf '%s%s%s\n' "$C_YELLOW" "$*" "$C_RESET"; }
39
- err() { printf '%s%s%s\n' "$C_RED" "$*" "$C_RESET"; }
40
- dim() { printf '%s%s%s\n' "$C_DIM" "$*" "$C_RESET"; }
41
-
42
- # 历史 PID 位置(迁移兼容)
43
- legacy_pid_files() {
44
- printf '%s\n' \
45
- "$SERVER_DIR/app.pid" \
46
- "$SERVER_DIR/${PROJECT_NAME}.pid" \
47
- "/tmp/${PROJECT_NAME}.pid" \
48
- "/tmp/start-${PROJECT_NAME}.pid"
49
- }
50
-
51
- # ---------- Node 定位(独立可搬运,内联不 source)----------
52
- find_node() {
53
- local c nvm
54
- for c in \
55
- "$ROOT/tool/node/bin/node" \
56
- /usr/local/bin/node \
57
- /opt/homebrew/bin/node \
58
- /opt/node/bin/node \
59
- /var/packages/Node.js_v24/target/usr/local/bin/node \
60
- /var/packages/Node.js_v22/target/usr/local/bin/node \
61
- /var/packages/Node.js_v20/target/usr/local/bin/node \
62
- /var/packages/DeepSeekHarness-NAS/target/bin/node \
63
- node; do
64
- if [ -x "$c" ]; then NODE_BIN="$c"; return 0; fi
65
- if command -v "$c" >/dev/null 2>&1; then NODE_BIN="$(command -v "$c")"; return 0; fi
66
- done
67
- for nvm in "$HOME"/.nvm/versions/node/*/bin/node; do
68
- if [ -x "$nvm" ]; then NODE_BIN="$nvm"; return 0; fi
69
- done
70
- return 1
71
- }
72
-
73
- if ! find_node; then
74
- err "❌ 找不到 node。请安装 Node.js,或把官方二进制解压到 tool/node/"
75
- exit 1
76
- fi
77
- ok "✓ Node: $NODE_BIN ($("$NODE_BIN" -v 2>/dev/null))"
78
-
79
- file_size() {
80
- local f="$1"
81
- [ -f "$f" ] || { echo 0; return; }
82
- stat -c%s "$f" 2>/dev/null || stat -f%z "$f" 2>/dev/null || wc -c < "$f"
83
- }
84
-
85
- human_size() {
86
- local n="$1"
87
- if [ "$n" -ge 1048576 ]; then awk -v n="$n" 'BEGIN{printf "%.1fMB", n/1048576}'; else awk -v n="$n" 'BEGIN{printf "%.1fKB", n/1024}'; fi
88
- }
89
-
90
- # ---------- token 解析:DSH_PREVIEW_TOKEN env > DSH_HOME 上级 DeepSeekHarness-NAS.log 最新 token ----------
91
- resolve_token() {
92
- if [ -n "${DSH_PREVIEW_TOKEN:-}" ]; then printf '%s' "$DSH_PREVIEW_TOKEN"; return 0; fi
93
- local dsh_home="${DSH_HOME:-}"
94
- [ -n "$dsh_home" ] || dsh_home="$HOME/.dsh"
95
- local log_file="$dsh_home/../DeepSeekHarness-NAS.log"
96
- if [ -f "$log_file" ]; then
97
- grep -o 'token=[a-zA-Z0-9_-]\{20,\}' "$log_file" 2>/dev/null | tail -n1 | sed 's/^token=//'
98
- return 0
99
- fi
100
- return 0 # 找不到就空,预览服务(scripts/preview-server.mjs)内部还有兜底
101
- }
102
-
103
- # ---------- 端口工具 ----------
104
- port_in_use() {
105
- local port="$1" out=""
106
- if command -v ss >/dev/null 2>&1; then
107
- out="$(ss -tln 2>/dev/null)"
108
- elif command -v netstat >/dev/null 2>&1; then
109
- out="$(netstat -tln 2>/dev/null)"
110
- fi
111
- [ -n "$out" ] || return 1
112
- printf '%s\n' "$out" | awk -v p="$port" '
113
- $4 ~ ("[.:]" p "$") { found = 1; exit }
114
- END { exit(found ? 0 : 1) }'
115
- }
116
-
117
- port_pids() {
118
- local port="$1" out=""
119
- if command -v ss >/dev/null 2>&1; then
120
- out="$(ss -tlnp 2>/dev/null | awk -v p="$port" '$4 ~ ("[.:]" p "$") {print}')"
121
- elif command -v netstat >/dev/null 2>&1; then
122
- out="$(netstat -tlnp 2>/dev/null | awk -v p="$port" '$4 ~ ("[.:]" p "$") {print}')"
123
- fi
124
- [ -n "$out" ] || return 0
125
- printf '%s\n' "$out" | grep -o 'pid=[0-9]*' | cut -d= -f2
126
- printf '%s\n' "$out" | awk '{n=split($NF,a,"/"); if (n>1 && a[1] ~ /^[0-9]+$/) print a[1]}'
127
- }
128
-
129
- wait_port_free() {
130
- local port="$1" timeout="${2:-10}" i=0
131
- while [ "$i" -lt "$((timeout * 2))" ]; do
132
- port_in_use "$port" || return 0
133
- sleep 0.5
134
- i=$((i + 1))
135
- done
136
- return 1
137
- }
138
-
139
- listen_line() {
140
- local port="$1"
141
- if command -v ss >/dev/null 2>&1; then
142
- ss -tln 2>/dev/null | awk -v p=":$port" '$0 ~ p {print; exit}'
143
- elif command -v netstat >/dev/null 2>&1; then
144
- netstat -tln 2>/dev/null | awk -v p=":$port" '$0 ~ p {print; exit}'
145
- fi
146
- }
147
-
148
- pid_alive() {
149
- local p="$1"
150
- [ -n "$p" ] && kill -0 "$p" 2>/dev/null
151
- }
152
-
153
- read_pid_file() {
154
- local f="$1"
155
- [ -f "$f" ] && [ -s "$f" ] || return 1
156
- tr -d ' \t\r\n' < "$f"
157
- }
158
-
159
- collect_live_pids() {
160
- # 2026-09-20 修:端口必须随调用方实际端口走(--port 覆盖时查 DEFAULT_PORT 会抓错
161
- # 别的项目同端口进程 → 误报「已在运行」)。缺省仍用 DEFAULT_PORT 兼容旧调用。
162
- local f p seen=" " port="${1:-$DEFAULT_PORT}"
163
- for f in "$PID_FILE" $(legacy_pid_files); do
164
- p="$(read_pid_file "$f" 2>/dev/null || true)"
165
- if pid_alive "$p"; then
166
- case "$seen" in
167
- *" $p "*) ;;
168
- *) seen="$seen$p "; printf '%s\n' "$p" ;;
169
- esac
170
- fi
171
- done
172
- local lp
173
- lp="$(port_pids "$port")"
174
- for p in $lp; do
175
- case "$seen" in
176
- *" $p "*) ;;
177
- *) seen="$seen$p "; printf '%s\n' "$p" ;;
178
- esac
179
- done
180
- }
181
-
182
- rotate_log() {
183
- [ -f "$LOG_FILE" ] || return 0
184
- local sz
185
- sz="$(file_size "$LOG_FILE")"
186
- [ "$sz" -gt "$LOG_ROTATE_BYTES" ] || return 0
187
- local ts dest
188
- ts="$(date +%Y%m%d-%H%M%S)"
189
- dest="${LOG_FILE}.${ts}"
190
- mv "$LOG_FILE" "$dest" || return 0
191
- if command -v gzip >/dev/null 2>&1; then
192
- gzip -f "$dest" && dest="${dest}.gz"
193
- fi
194
- warn "⚠️ 日志超过 10MB,已轮转: $dest ($(human_size "$sz"))"
195
- }
196
-
197
- start_server() {
198
- # --port 覆盖时全局 PORT 已在 main 入口解析(stop/restart/status 同端口语义),
199
- # 这里保留原内联解析兜底(兼容直接调用函数),但统一用全局 PORT。
200
- local port_opt=""
201
- while [ $# -gt 0 ]; do
202
- case "$1" in
203
- --port) port_opt="${2:-}"; shift 2 ;;
204
- *) shift ;;
205
- esac
206
- done
207
- local port="${PORT:-${port_opt:-$DEFAULT_PORT}}"
208
- local live
209
- live="$(collect_live_pids "$port" | head -n 1 || true)"
210
- if [ -n "$live" ]; then
211
- warn "⚠️ 已在运行 (PID $live, 端口 $port)。如需重启: ./start.sh restart"
212
- return 1
213
- fi
214
- if port_in_use "$port"; then
215
- warn "⏳ 端口 $port 仍被占用,等待释放(最多 ${START_WAIT_SEC}s)..."
216
- if ! wait_port_free "$port" "$START_WAIT_SEC"; then
217
- err "❌ 端口 $port 等待 ${START_WAIT_SEC}s 仍未释放,放弃启动。"
218
- err " 排查:netstat -tlnp | grep :$port 或换端口: ./start.sh --port <新端口>"
219
- return 1
220
- fi
221
- ok "✓ 端口 $port 已释放"
222
- fi
223
- rm -f "$PID_FILE"
224
- mkdir -p "$SERVER_DIR"
225
- rotate_log
226
- local token
227
- token="$(resolve_token)"
228
- local cmd=("$NODE_BIN" "$SERVER_ENTRY" --port "$port" --no-open)
229
- if [ -n "$token" ]; then cmd+=("--token" "$token"); fi
230
- cd "$SERVER_DIR" || exit 1
231
- if command -v setsid >/dev/null 2>&1; then
232
- setsid nohup "${cmd[@]}" >> "$LOG_FILE" 2>&1 < /dev/null &
233
- else
234
- nohup "${cmd[@]}" >> "$LOG_FILE" 2>&1 < /dev/null &
235
- fi
236
- echo $! > "$PID_FILE"
237
- local new_pid okflag=0 i
238
- new_pid="$(cat "$PID_FILE")"
239
-
240
- for i in $(seq 1 8); do
241
- sleep 1
242
- if curl -sf -m 3 "http://127.0.0.1:$port/preview-ping" > /dev/null 2>&1; then
243
- okflag=1
244
- break
245
- fi
246
- pid_alive "$new_pid" || break
247
- done
248
- if [ "$okflag" = 1 ]; then
249
- ok "✅ 启动成功 PID=$new_pid 端口=$port"
250
- echo " 页面: http://<本机IP>:$port"
251
- echo " 日志: $LOG_FILE"
252
- echo " PID: $PID_FILE"
253
- else
254
- err "❌ 启动失败(8 秒内未通过健康检查),最近日志:"
255
- tail -15 "$LOG_FILE" 2>/dev/null
256
- return 1
257
- fi
258
- }
259
-
260
- stop_one() {
261
- local pid="$1"
262
- warn "⏹ SIGTERM PID=$pid (最多等 ${STOP_WAIT_SEC}s)"
263
- kill "$pid" 2>/dev/null || true
264
- local i
265
- for i in $(seq 1 "$STOP_WAIT_SEC"); do
266
- if ! pid_alive "$pid"; then
267
- ok "✓ PID $pid 已在 ${i}s 内退出"
268
- return 0
269
- fi
270
- sleep 1
271
- done
272
- if pid_alive "$pid"; then
273
- warn "⚠️ ${STOP_WAIT_SEC}s 未退出,SIGKILL PID=$pid"
274
- kill -9 "$pid" 2>/dev/null || true
275
- sleep 1
276
- fi
277
- if pid_alive "$pid"; then
278
- err "❌ PID $pid 仍在,请检查"
279
- return 1
280
- fi
281
- ok "✓ PID $pid 已强制结束"
282
- }
283
-
284
- stop_server() {
285
- local pids
286
- pids="$(collect_live_pids "$PORT" || true)"
287
- if [ -z "$pids" ]; then
288
- warn "⚠️ 未运行(无有效 PID)"
289
- rm -f "$PID_FILE"
290
- local f
291
- for f in $(legacy_pid_files); do rm -f "$f"; done
292
- return 0
293
- fi
294
- local rc=0
295
- for p in $pids; do
296
- stop_one "$p" || rc=1
297
- done
298
- rm -f "$PID_FILE"
299
- local f
300
- for f in $(legacy_pid_files); do rm -f "$f"; done
301
- if [ "$rc" = 0 ]; then
302
- ok "✅ 已停止"
303
- else
304
- err "❌ 停止未完成"
305
- fi
306
- return "$rc"
307
- }
308
-
309
- status_server() {
310
- local port="${PORT:-$DEFAULT_PORT}"
311
- echo "======== $PROJECT_NAME 预览服务器 ========"
312
- echo "根目录: $ROOT"
313
- echo "PID文件: $PID_FILE$([ -f "$PID_FILE" ] && echo " (存在)" || echo " (无)")"
314
-
315
- local p
316
- p="$(read_pid_file "$PID_FILE" 2>/dev/null || true)"
317
- if pid_alive "$p"; then
318
- ok "进程: ✓ PID $p"
319
- ps -o pid=,ppid=,etime=,rss=,stat=,args= -p "$p" 2>/dev/null | while IFS= read -r line; do
320
- dim " $line"
321
- done
322
- elif [ -n "$p" ]; then
323
- err "进程: ✗ PID 文件有 $p 但进程已退出"
324
- else
325
- err "进程: ✗ 未运行"
326
- fi
327
-
328
- local lis
329
- lis="$(listen_line "$port")"
330
- if [ -n "$lis" ]; then
331
- ok "监听: ✓ 端口 $port"
332
- dim " $lis"
333
- else
334
- warn "监听: 未发现 :$port"
335
- fi
336
-
337
- local curlout code time
338
- curlout="$(curl -sS -m 5 -o /tmp/${PROJECT_NAME}-status.body -w '%{http_code} %{time_total}' "http://127.0.0.1:$port/preview-ping" 2>/dev/null || echo "000 0")"
339
- code="${curlout%% *}"
340
- time="${curlout#* }"
341
- if [ "$code" = "200" ]; then
342
- ok "HTTP: ✓ GET /preview-ping $code ${time}s"
343
- head -c 80 "/tmp/${PROJECT_NAME}-status.body" 2>/dev/null; echo
344
- else
345
- err "HTTP: ✗ GET /preview-ping HTTP $code"
346
- fi
347
- rm -f "/tmp/${PROJECT_NAME}-status.body"
348
-
349
- if [ -f "$LOG_FILE" ]; then
350
- local sz mtime
351
- sz="$(file_size "$LOG_FILE")"
352
- mtime="$(date -r "$LOG_FILE" '+%Y-%m-%d %H:%M:%S' 2>/dev/null || stat -c %y "$LOG_FILE" 2>/dev/null | cut -d. -f1)"
353
- echo "日志: $LOG_FILE $(human_size "$sz") 更新 $mtime"
354
- echo "-------- 最近 8 行 --------"
355
- tail -8 "$LOG_FILE" 2>/dev/null
356
- else
357
- warn "日志: 尚无 $LOG_FILE"
358
- fi
359
- }
360
-
361
- CMD="${1:-restart}"
362
- if [ "$CMD" = "--port" ]; then
363
- CMD="restart"
364
- elif [ "$CMD" = "start" ] || [ "$CMD" = "stop" ] || [ "$CMD" = "restart" ] || [ "$CMD" = "status" ]; then
365
- shift
366
- else
367
- CMD="restart"
368
- fi
369
-
370
- # 全局端口解析(2026-09-20 修):start/restart 带 --port 时,stop/status 必须按同一端口
371
- # 收集存活进程——否则 restart --port X 会先按默认端口停掉**别的项目**的同端口服务(SIGTERM→SIGKILL 误杀)。
372
- PORT="${DEFAULT_PORT:-30999}"
373
- if [ $# -ge 2 ]; then
374
- for ((i = 1; i <= $#; i++)); do
375
- if [ "${!i}" = "--port" ] && [ $((i + 1)) -le $# ]; then
376
- PORT="${@:$((i + 1)):1}"
377
- break
378
- fi
379
- done
380
- fi
381
-
382
- case "$CMD" in
383
- start) start_server "$@" ;;
384
- stop) stop_server ;;
385
- restart)
386
- stop_server
387
- sleep 1
388
- start_server "$@"
389
- ;;
390
- status) status_server ;;
391
- *)
392
- err "❌ 未知命令: $CMD"
393
- echo "可用命令: start, stop, restart, status"
394
- exit 1
395
- ;;
396
- esac