feat(local): 依赖安装自愈:源探测 + 换源重试 + 本地缓存 + 看门狗

国内网络下首装依赖最容易卡死,启动器现在自己处理,用户不用懂环境:

- 自动选源:并行探 npmmirror 与官方源(各 3s 超时)取最快,缓存一天;
  只在命令行传 --registry,不写 ~/.npmrc、不改用户全局配置。
- 换源重试:公共源之间自动互换,换源成功即记住;显式指定或公司私有源不兜底
  (乱兜底可能装错东西)。重试前清掉半成品 node_modules。
- 本地缓存:装成功后把 node_modules 打成
  ~/.cache/agent-local/deps-<平台>-<架构>-abi<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/ 未动。
This commit is contained in:
2026-11-11 12:16:35 +08:00
parent f451027729
commit b5cfa36832
3 changed files with 339 additions and 41 deletions
+22 -4
View File
@@ -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` 不用手删(换源重试前会自动清)。
## 排查
+287 -37
View File
@@ -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,可能需要单独安装 <code>npm</code>。'
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 后重跑;或在有网络的机器上装好,把缓存目录拷过来:<code>$(html_escape "$LOCAL_CACHE")</code>。"
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' '<b>本机缺少编译工具链</b>:某个依赖要现场编译原生模块。装一下 Xcode 命令行工具再重跑:<code>xcode-select --install</code>。'
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' '<b>网络没通</b>:npm 连不上源(已自动换源重试过)。多半是代理 / VPN,或公司网络拦截了 registry。'
elif grep -qiE 'EACCES|EPERM|permission denied' "$RUNTIME/npm-tail.txt"; then
printf '%s' '<b>没有写权限</b>:常见于以前用 <code>sudo</code> 装过依赖(目录属主变成 root)。删掉这些 <code>node_modules</code> 后重跑。'
elif [ "${NPM_TIMED_OUT:-0}" = 1 ]; then
printf '%s' '<b>源没有响应</b>:npm 卡住超过上限被终止(已自动换源重试)。多半是网络 / 代理 / 被墙。'
else
printf '%s' '依赖没有装成功,原因见下面的 npm 输出。'
fi
}
# 安装失败时把「怎么再试」写进自检页。npm 在断网时只会吐一句
# "Exit handler never called!"(npm 10 + Node 22 的已知毛病),不提源就无从下手。
install_failed() {
SETUP_TITLE='依赖安装失败'
SETUP_HINT="<code>${1#$ROOT/}</code> 的 npm install 没装成功,绝大多数是 npm 源不可达。先确认源:<code>npm config get registry</code>;如果指向你环境里解析不了的地址,换源重试:<code>NPM_REGISTRY=https://registry.npmjs.org ./local/start.sh</code>。半成品 node_modules 不用手删,下次启动会重新检测缺失的包。下面是 npm 自己的输出(完整日志见本页底部路径)。"
tried=''
for t in ${TRIED_REGS:-}; do
[ -n "$tried" ] && tried="${tried}、"
tried="$tried<code>$(short_reg "$t" | esc)</code>"
done
[ -n "$tried" ] || tried='(默认配置)'
SETUP_HINT="<code>$(printf '%s' "$1" | esc)</code>:$(npm_hint)<br>已尝试的源:${tried}。也可以自己指定:<code>NPM_REGISTRY=https://registry.npmmirror.com ./local/start.sh</code>。下面是 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() {