From b5cfa36832fc60ffe3202c4969e515c0264071c4 Mon Sep 17 00:00:00 2001 From: kicer Date: Wed, 11 Nov 2026 12:16:35 +0800 Subject: [PATCH] =?UTF-8?q?feat(local):=20=E4=BE=9D=E8=B5=96=E5=AE=89?= =?UTF-8?q?=E8=A3=85=E8=87=AA=E6=84=88=EF=BC=9A=E6=BA=90=E6=8E=A2=E6=B5=8B?= =?UTF-8?q?=20+=20=E6=8D=A2=E6=BA=90=E9=87=8D=E8=AF=95=20+=20=E6=9C=AC?= =?UTF-8?q?=E5=9C=B0=E7=BC=93=E5=AD=98=20+=20=E7=9C=8B=E9=97=A8=E7=8B=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 国内网络下首装依赖最容易卡死,启动器现在自己处理,用户不用懂环境: - 自动选源:并行探 npmmirror 与官方源(各 3s 超时)取最快,缓存一天; 只在命令行传 --registry,不写 ~/.npmrc、不改用户全局配置。 - 换源重试:公共源之间自动互换,换源成功即记住;显式指定或公司私有源不兜底 (乱兜底可能装错东西)。重试前清掉半成品 node_modules。 - 本地缓存:装成功后把 node_modules 打成 ~/.cache/agent-local/deps-<平台>-<架构>-abi-<依赖哈希>.tgz, 重启/删 node_modules/换 clone 都解压恢复(零网络),只留最近 3 份。 - 看门狗:npm 10 + Node 22 断网时既不报错也不退出(Exit handler never called), 超过 AGENT_LOCAL_NPM_TIMEOUT(默认 240s)直接 SIGKILL 整棵树再换源。 - 报错翻译:状态页只显示「网络没通 / 缺编译工具链 / 没有写权限 / 源没响应」, npm 原文仍完整落 npm-install.log。 同时修掉两个埋着的 bug: - kill_tree 先把参数赋给变量再递归,POSIX sh 无局部变量导致递归覆盖, 回到外层 kill 的是子进程,留下 PPID=1 的孤儿 npm。改为只用 $1。 - 看门狗不能先 TERM:TERM 先杀掉外壳会让 npm 变孤儿,kill -0 判不到。 改为直接递归 SIGKILL(先子后己)。 全部改动只在 local/ 与文档,app/ 未动。 --- docs/local-mode.md | 30 +++++ local/README.md | 26 +++- local/start.sh | 324 +++++++++++++++++++++++++++++++++++++++------ 3 files changed, 339 insertions(+), 41 deletions(-) diff --git a/docs/local-mode.md b/docs/local-mode.md index 8c2a93b..56232d7 100644 --- a/docs/local-mode.md +++ b/docs/local-mode.md @@ -213,6 +213,32 @@ 改成先看 `supervisor.pid`(子进程一启动就写,秒级就绪;`kill -0` + 命令行含 `start.sh` 防 pid 被回收), health 只作为「端口上有服务但不是本启动器拉起的」兜底提示。 +### 4.12 依赖安装:源探测 + 换源重试 + 本地缓存(只在 `local/` 里做) + +首装联网是逃不掉的,但「哪个源能用、卡住了怎么办」不该让用户想。启动器的策略: + +1. **已装齐 → 不联网**(逐包检查 + `.agent-installed` 时间戳,见 4.10); +2. **缓存命中 → 解压**:装成功后把 `node_modules` 打成 + `<平台>-<架构>-abi-<依赖哈希>.tgz` 放 `~/.cache/agent-local/`;原生模块与 ABI 绑定, + 所以文件名必须含 ABI(`process.versions.modules`)。换 clone / 删 `node_modules` 都走这里, + 秒级且零网络;只留最近 3 份。 +3. **缓存未命中 → 选源安装**:并行探 `npmmirror` 与官方源(各 3 秒超时),取最快的; + 结果缓存一天。**只用命令行参数传源,绝不写 `~/.npmrc`**。 +4. **失败换源**:仅当用的是公共源(npmmirror / 官方)时换下一个重试,换源成功就记住; + 用户显式指定或公司私有源不兜底(乱兜底可能装错东西)。重试前先删半成品 `node_modules`。 +5. **看门狗**:npm 10 + Node 22 在断网时既不报错也不退出(已知的 + `Exit handler never called`,实测卡死超过 2 分钟),所以每次 `npm install` 都带超时, + 超时就 `SIGKILL` 整棵树再换源。 +6. **报错翻译**:把 npm 原文归成「网络没通 / 缺编译工具链(`xcode-select --install`)/ + 没有写权限 / 源没响应」,状态页只显示这一句,原文仍完整落在 `npm-install.log`。 + +两个容易踩的实现细节(都踩过): + +- `kill_tree` 不能把参数先赋给变量再递归:POSIX sh 没有局部变量,递归会覆盖它,回到外层 + kill 的是子进程而不是原本那个。 +- 看门狗只用 `SIGKILL`:先 `TERM` 会先干掉外壳让 npm 变成孤儿(`PPID=1`),`kill -0` 判不到, + 再想硬杀就找不到它了。 + ## 5. 验证结果(macOS 12.7.6 / x86_64 / Node 22.21 / python3 3.10 / 本机无 ffmpeg) 静态检查:`sh -n local/start.sh`、`sh -n local/stop.sh`、`node --check` 均通过。 @@ -235,6 +261,10 @@ health 只作为「端口上有服务但不是本启动器拉起的」兜底提 | `stop.sh`:命中 pid 文件分支;pid 文件丢失时按 core 父进程/端口也能停;未运行时幂等返回 | 通过 | | 重复执行 `start.sh`:打印「已在运行(启动器 pid N)」+ 停止命令,exit 0,不起第二个进程 | 通过 | | 启动器被 `kill -9` 后的恢复:残留 pid 文件被清理,端口仍被占时明确提示先 `stop.sh` | 通过 | +| 依赖源自动探测:删依赖后启动,自动选中 `registry.npmmirror.com`(本机 npm 全局源也是它),状态页显示「依赖源」 | 通过 | +| 依赖缓存:装成功后生成 `~/.cache/agent-local/deps-...tgz`;删掉 `node_modules` 重启,日志为「使用本地依赖缓存」、`npm-install.log` 为空(零网络) | 通过 | +| 换源自愈:把缓存里的源改成不可达地址 → 看门狗超时 → 自动换到 npmmirror 装完,缓存里的源被改回可用值 | 通过 | +| 失败翻译:源不可用 + 冷 npm 缓存 → 状态页标题「依赖安装失败」、提示「源没有响应…(已自动换源重试)」,无 npm 残留进程 | 通过 | | 前台模式 `AGENT_LOCAL_DETACH=0`:阻塞运行,`TERM` 后端口全部释放 | 通过 | | 无 node(PATH 里剥掉 node/npm):入口直接拦下,**不** 先让选目录、不生成配置;终端打出安装方式;状态页列出自检项(X Node.js / X npm) | 通过 | | 失败时只开一个状态页标签(不再两个) | 通过 | diff --git a/local/README.md b/local/README.md index 8f27c62..86eea28 100644 --- a/local/README.md +++ b/local/README.md @@ -81,10 +81,27 @@ cd agent | 变量 | 默认 | 说明 | |---|---|---| | `PORT` | `8090` | core 端口(别撞下面的 MCP 端口) | -| `NPM_REGISTRY` | 空 | 首次装依赖时用的 npm 源,如 `https://registry.npmjs.org` | +| `NPM_REGISTRY` | 空 | 手动指定 npm 源(默认自动探测;指定后不再自动换源) | | `MCP_WEB_PORT` / `MCP_IMAGE_PORT` / `MCP_VIDEO_PORT` / `MCP_ASR_PORT` | 8091~8094 | 四个 MCP 的端口(同机跑必须各占一个;改这里还要同步改配置里的 url) | | `AGENT_LOCAL_UI` | `auto` | 是否自动打开状态页:`auto` = 仅 macOS,`1` 强制,`0` 关闭(页面无论如何都会生成) | | `AGENT_LOCAL_DETACH` | `1` | `1` = 后台启动后立即返回(用 `stop.sh` 停);`0` = 前台阻塞(看实时日志、`Ctrl-C` 停) | +| `AGENT_LOCAL_CACHE` | `~/.cache/agent-local` | 依赖缓存的存放位置(多个 clone 共享) | +| `AGENT_LOCAL_NPM_TIMEOUT` | `240` | 单次 `npm install` 的超时秒数,超过就换源重试 | + +## 依赖安装与网络(国内环境) + +首次启动要装一次 Node 依赖,启动器会自己处理环境问题,不需要你操心: + +- **自动选源**:并行探 `registry.npmmirror.com` 与官方源,用最快的那个(国内基本会选 npmmirror)。 + 结果缓存一天;不写你本机的 `~/.npmrc`,也不改全局配置。 +- **失败自动换源重试**:一个源不行就换下一个;换源成功会记住它。 +- **卡住有看门狗**:npm 在断网时可能既不报错也不退出,超过 `AGENT_LOCAL_NPM_TIMEOUT` 就结束它并换源。 +- **装完存缓存**:打成一张 tarball 放到 `~/.cache/agent-local/`。之后重启、删掉 `node_modules`、 + 再 clone 一份,都是解压恢复(秒级、零网络)。 +- **失败说人话**:状态页会直接告诉你「网络没通 / 缺编译工具链(`xcode-select --install`)/ 没有写权限」, + 不需要读 npm 日志。 + +要清缓存就删那个目录:`rm -rf ~/.cache/agent-local`(下次启动会重新装一次)。 ## 更新 @@ -119,9 +136,10 @@ git pull 模型调用该工具会得到明确的「未配置」错误。 - **技能依赖**:有 `requirements.txt` 的技能需要自己把包装进 `skills/deps` (服务器上这一步由 `agent-executor-init` 在构建期完成)。默认只保证纯标准库技能可用。 -- **首个 `npm install` 要联网**:源不可达时换一个重跑: - `NPM_REGISTRY=https://registry.npmjs.org ./local/start.sh`。中途失败留下的半成品 node_modules - 不用手删,下次启动会重新检测缺失的包。 +- **首个 `npm install` 要联网**:启动器会自动选源、换源重试、并把装好的依赖缓存到 + `~/.cache/agent-local/`;之后重启 / 换 clone 都是本地解压,不需要网络。真要手动指定源: + `NPM_REGISTRY=https://registry.npmmirror.com ./local/start.sh`。中途失败留下的半成品 + `node_modules` 不用手删(换源重试前会自动清)。 ## 排查 diff --git a/local/start.sh b/local/start.sh index 47d0ec2..83cb3a3 100755 --- a/local/start.sh +++ b/local/start.sh @@ -26,6 +26,14 @@ PORT="${PORT:-8090}" HOST_ADDR="127.0.0.1" NPM_REGISTRY="${NPM_REGISTRY:-}" +# 依赖缓存:装成功后把 node_modules 打一张 tarball 存这里,重启 / 换 clone / 删 node_modules +# 都能直接解压恢复,完全不走网络。放用户缓存目录(而不是仓库里)是为了多个 clone 共享; +# 卸载时删这一个目录就行(README 有写)。 +LOCAL_CACHE="${AGENT_LOCAL_CACHE:-${XDG_CACHE_HOME:-$HOME/.cache}/agent-local}" +REGISTRY_CACHE="$RUNTIME/registry" +# npm 源候选。并行探测、挑最快的,所以国内会选 npmmirror、海外会选官方,不用用户干预。 +REGISTRY_CANDIDATES='https://registry.npmmirror.com https://registry.npmjs.org' + # 四个同栈 MCP 服务在服务器上是各自独立的容器,都监听 3000 也不冲突; # 本地挤在同一台机器上,必须各占一个端口。默认紧跟 core 的 8090 往后排, # 所以 core 换端口时(PORT=xxx)要留意别撞上这四个——下面有冲突检查。 @@ -291,6 +299,16 @@ ui_busy() { fi } +# 只换「进行中」的文案,保留开始时间:换源重试时计时不该归零(否则看起来像卡死后重来)。 +ui_busy_relabel() { + if [ ! -f "$UI_DIR/busy" ]; then ui_busy "$1" "${2:-}"; return 0; fi + bsince=$(sed -n 2p "$UI_DIR/busy" 2>/dev/null) + case "${bsince:-}" in ''|*[!0-9]*) bsince=$(date +%s);; esac + printf '%s\n%s\n' "$1" "$bsince" > "$UI_DIR/busy" + [ -n "${2:-}" ] && printf '%s\n' "$2" > "$UI_DIR/logpath" + ui_render +} + # 必须显式收掉并清空 PID:心跳在 busy 文件消失后自己退出,但变量还留着旧的 PID, # 下一个步骤就不会再起心跳(页面会永远停在「已 0 秒」)。 ui_stop_ticker() { @@ -423,63 +441,285 @@ deps_resolvable() { ' "$1/package.json" "$1" >/dev/null 2>&1 } +# ---------- npm 源:自动探测 ---------- +# 国内直连 registry.npmjs.org 经常几十秒超时,而 npm 自己不会换源。用户不该被要求懂这些, +# 所以装之前并行探一次候选源、挑最快的,结果缓存一天。 +# 约束:只通过命令行参数传源,绝不写 ~/.npmrc —— 不为了装依赖改用户的全局配置。 +probe_registry() { + node -e ' + const ctl = (ms) => { const c = new AbortController(); setTimeout(() => c.abort(), ms); return c.signal; }; + const probe = async (r) => { + const t0 = Date.now(); + try { await fetch(r + "/-/ping", { signal: ctl(3000) }); return { r, ms: Date.now() - t0 }; } + catch { return null; } + }; + Promise.all(process.argv.slice(1).map(probe)).then((rs) => { + const ok = rs.filter(Boolean).sort((a, b) => a.ms - b.ms); + if (!ok.length) process.exit(1); + process.stdout.write(ok[0].r); + }); + ' $REGISTRY_CANDIDATES +} + +registry_cached() { + [ -f "$REGISTRY_CACHE" ] || return 1 + reg=$(sed -n 1p "$REGISTRY_CACHE" 2>/dev/null) + ts=$(sed -n 2p "$REGISTRY_CACHE" 2>/dev/null) + [ -n "${reg:-}" ] || return 1 + case "${ts:-}" in ''|*[!0-9]*) return 1;; esac + [ $(( $(date +%s) - ts )) -lt 86400 ] || return 1 + printf '%s' "$reg" +} + +registry_remember() { + { printf '%s\n' "$1"; date +%s; } > "$REGISTRY_CACHE" 2>/dev/null || true +} + +short_reg() { printf '%s' "${1#https://}" | sed -e 's|/$||'; } + +# 选出要用的源;返回 1 = 一个都连不上。 +pick_registry() { + # 用户显式指定的源优先级最高 + if [ -n "$NPM_REGISTRY" ]; then printf '%s' "$NPM_REGISTRY"; return 0; fi + # 有代理时探针不可信(node 的 fetch 不走 env 代理,npm 会走),交给 npm 自己 + if [ -n "${HTTPS_PROXY:-}${https_proxy:-}${HTTP_PROXY:-}${http_proxy:-}${ALL_PROXY:-}" ]; then + printf '%s' "$(npm config get registry 2>/dev/null || printf '')" + return 0 + fi + # npm 全局配置里显式改过源(公司私有源)→ 尊重它,不覆盖 + cfg=$(npm config get registry 2>/dev/null || printf '') + case "$cfg" in + ''|https://registry.npmjs.org|https://registry.npmjs.org/) : ;; + *) printf '%s' "$cfg"; return 0 ;; + esac + cached=$(registry_cached) && { printf '%s' "$cached"; return 0; } + reg=$(probe_registry) || return 1 + [ -n "${reg:-}" ] || return 1 + registry_remember "$reg" + printf '%s' "$reg" +} + +# ---------- 依赖缓存 ---------- +# 装成功之后把 node_modules 打一张 tarball 放到用户缓存目录:重启、删 node_modules、 +# 换一个 clone 都直接解压恢复,完全不走网络。文件名带平台 / 架构 / Node ABI / +# 依赖清单哈希 —— 原生模块(better-sqlite3 的 .node)与 ABI 绑定,不能混用。 +cache_key() { + node -e ' + const fs = require("fs"), crypto = require("crypto"); + const h = crypto.createHash("sha256"); + for (const f of process.argv.slice(1)) { try { h.update(fs.readFileSync(f)); } catch {} } + process.stdout.write(h.digest("hex").slice(0, 16)); + ' "$ROOT/app/package.json" "$ROOT/app/package-lock.json" "$ROOT"/mcp/*/package.json +} + +cache_file() { + abi=$(node -p 'process.versions.modules' 2>/dev/null || printf '0') + printf '%s/deps-%s-%s-abi%s-%s.tgz' "$LOCAL_CACHE" \ + "$(uname -s | tr 'A-Z' 'a-z')" "$(uname -m)" "$abi" "$(cache_key)" +} + +# 有依赖并且已经装好的目录(相对仓库根 + /node_modules),打包缓存用它。 +cache_dirs() { + for d in "$ROOT/app" "$ROOT"/mcp/*/; do + [ -f "$d/package.json" ] || continue + [ -d "$d/node_modules" ] || continue + node -e 'process.exit(Object.keys(require(process.argv[1]).dependencies||{}).length?0:1)' "$d/package.json" >/dev/null 2>&1 || continue + rel=${d#"$ROOT"/}; rel=${rel%/} + printf '%s\n' "$rel/node_modules" + done +} + +# 需要安装的目录(每行一个,容忍路径里有空格)。 +# 不能只看 node_modules 在不在:npm install 中途失败会留下「目录在、包不全」的半成品, +# 按「存在即已装」判断就会永远跳过安装,core 起来立刻 require 失败。 +need_dirs() { + for d in "$ROOT/app" "$ROOT"/mcp/*/; do + [ -f "$d/package.json" ] || continue + node -e 'process.exit(Object.keys(require(process.argv[1]).dependencies||{}).length?0:1)' "$d/package.json" >/dev/null 2>&1 || continue + if [ ! -d "$d/node_modules" ] || [ ! -f "$d/node_modules/.agent-installed" ] \ + || [ "$d/package.json" -nt "$d/node_modules/.agent-installed" ] \ + || ! deps_resolvable "$d"; then + printf '%s\n' "$d" + fi + done +} + +cache_restore() { + f=$(cache_file) + [ -f "$f" ] || return 1 + say "使用本地依赖缓存:$f" + ui_busy_relabel '恢复本地依赖缓存(不走网络)' + if ! tar -xzf "$f" -C "$ROOT" >>"$NPM_LOG" 2>&1; then + warn '缓存解压失败,改为联网安装' + return 1 + fi + return 0 +} + +cache_save() { + list=$(cache_dirs) + [ -n "$list" ] || return 0 + mkdir -p "$LOCAL_CACHE" 2>/dev/null || return 0 + f=$(cache_file) + tmp="$f.part" + # tar 里的路径相对仓库根,解压时 -C "$ROOT" 就能还原 + if printf '%s\n' "$list" | tar -czf "$tmp" -C "$ROOT" -T - >/dev/null 2>&1; then + mv -f "$tmp" "$f" 2>/dev/null || rm -f "$tmp" + # 只留最近 3 份:每次依赖变化都会产生新文件,不清理会一直涨 + ls -t "$LOCAL_CACHE"/deps-*.tgz 2>/dev/null | tail -n +4 | while IFS= read -r old; do rm -f "$old"; done + say "依赖缓存:$f" + else + rm -f "$tmp" 2>/dev/null || true + fi +} + # ---------- 依赖安装 ---------- +# 跑一次 npm install(输出落日志),带看门狗。 +# npm 10 + Node 22 在网络失败时既不退出也不报错(已知的 "Exit handler never called"): +# 没有超时用户就会干等到崩溃。超过上限就杀掉,交给外层换源重试。 +NPM_TIMEOUT="${AGENT_LOCAL_NPM_TIMEOUT:-240}" +npm_install_into() { + _dir=$1; _reg=$2 + ( cd "$_dir" && npm install --no-audit --no-fund --omit=dev \ + --registry "$_reg" --replace-registry-host=always \ + --fetch-retries=2 --fetch-timeout=20000 --prefer-offline ) >>"$NPM_LOG" 2>&1 & + _pid=$! + _waited=0 + NPM_TIMED_OUT=0 + while kill -0 "$_pid" 2>/dev/null; do + if [ "$_waited" -ge "$NPM_TIMEOUT" ]; then + warn "npm ${NPM_TIMEOUT} 秒没有响应,结束它并换源重试" + # 直接 KILL:npm 卡死时不理 TERM;kill_tree_hard 先递归子进程再杀自己, + # 不会像「先 TERM 后 KILL」那样把 npm 变成孤儿(PPID=1)漏在外面。 + NPM_TIMED_OUT=1 + kill_tree_hard "$_pid" + break + fi + sleep 2 + _waited=$((_waited + 2)) + # 前台模式下给个心跳,否则长时间没输出像是卡死了 + if [ $((_waited % 20)) -eq 0 ]; then printf ' ... %s 秒\n' "$_waited"; fi + done + wait "$_pid" 2>/dev/null +} + # 不只 app:mcp/image_task 与 mcp/video_task 也带 npm 依赖(@modelcontextprotocol/sdk + express), # 服务器上这些是镜像构建时装好的,本地得自己装。asr / web_search 是零依赖,自动跳过。 ensure_deps() { - NEED='' - for d in "$ROOT/app" "$ROOT"/mcp/*/; do - [ -f "$d/package.json" ] || continue - if node -e 'process.exit(Object.keys(require(process.argv[1]).dependencies||{}).length?0:1)' "$d/package.json" >/dev/null 2>&1; then - # 不能只看 node_modules 在不在:上次 npm install 中途失败会留下半成品目录, - # 目录在、包不全,再按「存在即已装」判断就会永远跳过安装,core 起来就 require 失败。 - # 所以逐个依赖 require.resolve 实测一遍(顺带覆盖手误删掉某个包的情况)。 - if [ ! -d "$d/node_modules" ] || [ ! -f "$d/node_modules/.agent-installed" ] \ - || [ "$d/package.json" -nt "$d/node_modules/.agent-installed" ] \ - || ! deps_resolvable "$d"; then - NEED="$NEED $d" - fi - fi - done - [ -z "$NEED" ] && { ui_step 'Node 依赖已就绪(无需安装)' ok; return 0; } + if ! need_dirs | grep -q .; then + ui_step 'Node 依赖已就绪(无需安装)' ok + return 0 + fi if [ "$NPM_OK" != 1 ]; then SETUP_TITLE='缺少 npm,无法安装依赖' SETUP_HINT='Node.js 一般自带 npm。若你是用系统包管理器装的 node,可能需要单独安装 npm。' return 1 fi - say '安装 Node 依赖(需要联网,通常 1~3 分钟;已装好的目录会跳过)' : > "$NPM_LOG" - # 长步骤:页面上会持续显示已用秒数 + npm 输出的尾巴(心跳每秒重绘)。 - ui_busy '安装 Node 依赖(npm install)' "$NPM_LOG" - ndir=0 - for d in $NEED; do - ndir=$((ndir + 1)) - say " npm install → ${d#$ROOT/}" - # 输出同时落盘(页面里要带日志)与终端(人盯着看进度)。 - # tee 会把 npm 的退出码吃掉,所以下面不靠退出码,而是直接实测依赖齐不齐。 - if [ -n "$NPM_REGISTRY" ]; then - ( cd "$d" && npm install --no-audit --no-fund --omit=dev --registry "$NPM_REGISTRY" ) 2>&1 | tee -a "$NPM_LOG" - else - ( cd "$d" && npm install --no-audit --no-fund --omit=dev ) 2>&1 | tee -a "$NPM_LOG" + + # 1) 本地缓存:装过一次后,重启 / 删 node_modules / 换 clone 都是解压,秒级且零网络 + if cache_restore; then + if ! need_dirs | grep -q .; then + ui_idle + ui_step 'Node 依赖已就绪(本地缓存恢复)' ok + return 0 fi - if ! deps_resolvable "$d"; then - install_failed "$d" + warn '缓存不完整,剩下的改为联网安装' + fi + + # 2) 选源。一个都连不上就别让 npm 重试三次刷屏,直接给结论。 + reg=$(pick_registry) || reg='' + if [ -z "$reg" ]; then + SETUP_TITLE='连不上任何 npm 源' + SETUP_HINT="npmmirror 与官方源都连不上,安装没法进行。检查代理 / VPN 后重跑;或在有网络的机器上装好,把缓存目录拷过来:$(html_escape "$LOCAL_CACHE")。" + return 1 + fi + # 什么情况不自动换源:用户显式指定了源,或用的是公司私有源(乱兜底到公网可能装错东西)。 + # 用公共源(npmmirror / 官方)时换源重试是安全的,也是国内环境最需要的。 + allow_fallback=0 + case "$reg" in + *registry.npmmirror.com*|*registry.npmjs.org*) allow_fallback=1 ;; + esac + [ -n "$NPM_REGISTRY" ] && allow_fallback=0 + REG_TRY="$reg" + if [ "$allow_fallback" = 1 ]; then + for c in $REGISTRY_CANDIDATES; do + [ "$c" = "$reg" ] || REG_TRY="$REG_TRY $c" + done + fi + ntry=0 + for t in $REG_TRY; do ntry=$((ntry + 1)); done + + say "安装 Node 依赖(源:$(short_reg "$reg"),通常 1~3 分钟;已装好的目录会跳过)" + # 长步骤:页面上会持续显示已用秒数 + npm 输出的尾巴(心跳每秒重绘)。 + ui_busy '安装 Node 依赖' "$NPM_LOG" + ui_step "依赖源:$(short_reg "$reg")" ok + TRIED_REGS='' + ndir=0 + need_dirs > "$RUNTIME/needs.txt" + while IFS= read -r d; do + [ -n "$d" ] || continue + ndir=$((ndir + 1)) + drel=${d#"$ROOT"/}; drel=${drel%/} + installed=0 + i=0 + for try_reg in $REG_TRY; do + i=$((i + 1)) + say " npm install → ${drel}($(short_reg "$try_reg"),第 $i/$ntry 次)" + ui_busy_relabel "安装依赖:${drel}($(short_reg "$try_reg"),第 $i/$ntry 次)" "$NPM_LOG" + # 上一轮失败会留下半成品,不清掉重试大概率还是失败 + [ "$i" -gt 1 ] && rm -rf "$d/node_modules" + npm_install_into "$d" "$try_reg" + TRIED_REGS="$TRIED_REGS $try_reg" + if deps_resolvable "$d"; then + installed=1 + # 换源成功就记住它,下次不用再探测 + [ -n "$NPM_REGISTRY" ] || registry_remember "$try_reg" + break + fi + done + if [ "$installed" != 1 ]; then + install_failed "$drel" return 1 fi # 打时间戳:npm 在「已经是最新」时不会更新 node_modules 的 mtime, # 只看目录 mtime 会导致每次启动都白跑一次 install。 touch "$d/node_modules/.agent-installed" - done + done < "$RUNTIME/needs.txt" ui_idle ui_step "Node 依赖已装好($ndir 个目录)" ok + cache_save return 0 } -# 安装失败时把「怎么再试」写进自检页。npm 自己在这种网络错误下只会吐一句 +# 把 npm 的输出翻译成一句人话:用户不该去读 gyp / ETIMEDOUT 这些字眼。 +# 原文仍然完整落在 npm-install.log,状态页只在尾巴里展示。 +npm_hint() { + tail -n 300 "$NPM_LOG" 2>/dev/null > "$RUNTIME/npm-tail.txt" + if grep -qiE 'gyp ERR!|xcrun: error|Command Line Tools|clang: error|cannot find Python' "$RUNTIME/npm-tail.txt"; then + printf '%s' '本机缺少编译工具链:某个依赖要现场编译原生模块。装一下 Xcode 命令行工具再重跑:xcode-select --install。' + elif grep -qiE 'EAI_AGAIN|ENOTFOUND|ETIMEDOUT|ECONNRESET|ECONNREFUSED|Exit handler never called|CERT_|self.signed|socket hang up|network' "$RUNTIME/npm-tail.txt"; then + printf '%s' '网络没通:npm 连不上源(已自动换源重试过)。多半是代理 / VPN,或公司网络拦截了 registry。' + elif grep -qiE 'EACCES|EPERM|permission denied' "$RUNTIME/npm-tail.txt"; then + printf '%s' '没有写权限:常见于以前用 sudo 装过依赖(目录属主变成 root)。删掉这些 node_modules 后重跑。' + elif [ "${NPM_TIMED_OUT:-0}" = 1 ]; then + printf '%s' '源没有响应:npm 卡住超过上限被终止(已自动换源重试)。多半是网络 / 代理 / 被墙。' + else + printf '%s' '依赖没有装成功,原因见下面的 npm 输出。' + fi +} + +# 安装失败时把「怎么再试」写进自检页。npm 在断网时只会吐一句 # "Exit handler never called!"(npm 10 + Node 22 的已知毛病),不提源就无从下手。 install_failed() { SETUP_TITLE='依赖安装失败' - SETUP_HINT="${1#$ROOT/} 的 npm install 没装成功,绝大多数是 npm 源不可达。先确认源:npm config get registry;如果指向你环境里解析不了的地址,换源重试:NPM_REGISTRY=https://registry.npmjs.org ./local/start.sh。半成品 node_modules 不用手删,下次启动会重新检测缺失的包。下面是 npm 自己的输出(完整日志见本页底部路径)。" + tried='' + for t in ${TRIED_REGS:-}; do + [ -n "$tried" ] && tried="${tried}、" + tried="$tried$(short_reg "$t" | esc)" + done + [ -n "$tried" ] || tried='(默认配置)' + SETUP_HINT="$(printf '%s' "$1" | esc):$(npm_hint)
已尝试的源:${tried}。也可以自己指定:NPM_REGISTRY=https://registry.npmmirror.com ./local/start.sh。下面是 npm 的原始输出。" } # ---------- 子进程 ---------- @@ -503,12 +743,22 @@ CORE_PID='' STOPPING=0 kill_tree() { - pid=$1 - [ -n "$pid" ] || return 0 + # 只用 $1,不先赋给变量:POSIX sh 没有局部变量,递归会覆盖它,回到外层时 + # kill 的就不是原本那个进程(踩过:看门狗杀了子进程,父进程和 npm 都留着)。 + [ -n "${1:-}" ] || return 0 if command -v pgrep >/dev/null 2>&1; then - for c in $(pgrep -P "$pid" 2>/dev/null); do kill_tree "$c"; done + for c in $(pgrep -P "$1" 2>/dev/null); do kill_tree "$c"; done fi - kill "$pid" 2>/dev/null || true + kill "$1" 2>/dev/null || true +} + +# 彻底送走(SIGKILL):npm 卡死时会忽略 TERM(就是 "Exit handler never called" 那个毛病)。 +kill_tree_hard() { + [ -n "${1:-}" ] || return 0 + if command -v pgrep >/dev/null 2>&1; then + for c in $(pgrep -P "$1" 2>/dev/null); do kill_tree_hard "$c"; done + fi + kill -KILL "$1" 2>/dev/null || true } do_cleanup() {