jianf/MailUI4Agents
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(deploy): TMPDIR 只判"未设"（同文件里 HOME 判了可写）+ 环境自足漏了"命令"（journalctl 两处是假绿）

Browse Source 
pi 给了"第五次"的两条线索，都在我读得到的地方，逐条实测确认后修完：

**1. TMPDIR 与 HOME 不同规则（就在同一个文件里）**
① `HOME` 那边写了两条规则：`mkdir -p` 对**已存在的不可写目录会返回成功** ⇒ 必须单独判 `-w`；
判据落在"能不能写"不落在"路径像不像"。**同一条规则没落到 ② `TMPDIR` 上** ——
而 ENOSPC 正是这条链的元老问题（四次史里第 3 条就是 TMPDIR）。两种失败形状：
已给但**不可写**（EACCES）、可写但**已满**（`-w` 抓不到，要的是**空间**判定）。
已补 `-d` + `-w` + 可用空间（`df -Pk`，读不到⇒**不据此判定**；`0` 是**真的没有**）；
不足 ⇒ 人话 + exit 2。**不 import** 插件那份 `test/lib/tmp-space.mjs`：
`deploy/` 侧要能独立分发，为去重引进平台代码不划算（按既定理由，写最小版本）。
实测 `TMPDIR=/root/nope` ⇒ `[FAIL] 环境不足：TMPDIR=… 不存在或不可写` + 退出码 2。

**2. 环境自足只覆盖"变量"，没覆盖"命令" —— 其中 journalctl 两处是假绿**
   这节的要害是 pi 给的那句判据，我认：**"命令不在"必须走 2/红 + 人话；
   "命令在但输出为空"才是判定结果。** 原先两处把两者压成同一个字符串 `"0"`：
   journalctl 失败（被 `2>/dev/null` 吞掉）⇒ grep 读空 ⇒ `fc="0"` ⇒ **打印"无 panic/fatal"**。
   实测复现：`journalctl -u 不存在的-unit | grep -icE 'panic'` ⇒ `fc=[0]`。
   `sse` 那条同形、后果更坏：**把"读不到日志"归因成"插件没连上"**，让人去查密钥。
   ⚠️ 顺带实测：**`PIPESTATUS` 分不开这两种情况**（命令不存在与"存在但无匹配"都给 1），
   所以不能靠管道状态区分 —— 必须**先取输出、成功后再过滤**，命令存在性另做前提检查。
   改法：两处都改成"先取日志、看退出码"；读不到 ⇒ `warn` 明说"读不到、无法据此判断"
   （既不假绿也不假红）。并给三个脚本加 `AGENTMAIL_REQUIRE` 前提检查
   （缺一个 ⇒ exit 2 + 人话），与四次史的处理**同形**，只是对象从变量换成命令。
   实测：`AGENTMAIL_REQUIRE` 里放不存在的命令 ⇒ 退出码 2。

**3. 顺带修 pi 点到的两处同族问题**
· `install.sh` 的 `HEAD_REV="$(git … rev-parse --short HEAD)"`：`set -e` 下失败**直接中止**
  （实测退出码 127、无翻译）；而且 HEAD_REV 为空会让下一句报
  "这个包比源码旧：产物 gitRev=… ≠ HEAD=" —— **把"这里不是 git 仓库"说成"产物过期"**。
  已改成显式判失败 + 明说"读不到当前 HEAD，跳过新旧比对"。
· 同块第 94 行末尾挂着一个 `|| true` ⇒ 整行退出码恒 0 ⇒ 它作为 `if` 条件**永远为真**
  （"判据的形式在、区分力不在"）。已改成显式计算、去掉 `|| true`。

docs 补两条纪律：15「"命令不在" ≠ "命令在但输出为空"」（含 PIPESTATUS 分不开的实测）、
16「一条规则写了，要检查它是否落到了所有同类对象上」。

验证：install.sh --check 空环境 exit 0、正常 exit 0；TMPDIR 不可写 exit 2；
npm test exit 0；prune 自检 22/22；drift 自检 35/0；check-shared-libs exit 0。
This commit is contained in:
JianFeeeee
2026-09-14 21:08:48 +08:00
parent 3be824849d
commit 8e3b04a267
5 changed files with 149 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
deploy/redeploy-gateway.sh
View File

@ -32,6 +32,10 @@ PREFIX="${AGENTMAIL_PREFIX:-/opt/agentmail}"
# 环境自足：一处给全（理由与四次历史见该文件头注释）
# shellcheck source=./lib/env-defaults.sh
. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/lib/env-defaults.sh"
# 本脚本依赖的外部命令：缺一个就 exit 2 + 人话（见 env-defaults.sh 的 ③b 一节）。
# 为什么必须显式声明：**"命令不在"与"命令在但输出为空"必须分开** ——
# 下游把前者读成后者时就会产出假绿（journalctl 那两处就是：工具缺失被读成"无 panic"）。
AGENTMAIL_REQUIRE="git go npm node curl systemctl journalctl sqlite3 install"
agentmail_env_report
# ★ root 断言（pi 评审 2026-09-14 指出本脚本缺它，只有 install.sh 有）：
@ -247,23 +251,42 @@ else
bad "健康检查失败 $HEALTH_URL"; CHECK_FAIL=$((CHECK_FAIL+1))
fi
fc="$(journalctl -u "$SERVICE" --since '2 min ago' --no-pager 2>/dev/null \
| grep -icE 'panic|fatal|SIGSEGV' || true)"
if [ "${fc:-0}" = "0" ]; then
ok "近 2 分钟无 panic/fatal"
# A: 日志读不到不等于没有 panic（pi 评审 2026-09-14 指出这两处是假绿，实测复现）。
#
# 原写法 fc="$(journalctl ... 2>/dev/null | grep -icE 'panic|fatal|SIGSEGV' || true)"，
# journalctl 失败时（无权限读日志、unit 不存在、dbus 不通）错误被 2>/dev/null 吞掉
# => grep 读空输入 => 输出 0、退出 1 => || true => fc="0" => 报"无 panic"。
# 实测复现：journalctl -u 不存在的-unit | grep -icE 'panic' => fc=[0]。
# 下面 sse 那条同形，后果更坏：它把"读不到日志"归因成"插件没连上"，
# 提示人去查密钥，而问题在日志读不到。
#
# 实测：PIPESTATUS 也分不开（命令不存在与"存在但无匹配"都给 1），
# 所以不能靠管道状态区分，必须先把日志取出来、成功后再 grep。
# 命令是否存在已由 env-defaults.sh 的 AGENTMAIL_REQUIRE 兜住（缺了提前 exit 2）；
# 这里处理的是"命令在、但读不到内容"。
_jlog="$(journalctl -u "$SERVICE" --since '2 min ago' --no-pager 2>/dev/null)"; _jrc=$?
if [ "$_jrc" != "0" ]; then
warn "读不到 $SERVICE 的日志（journalctl 退出码 $_jrc）—— 无法据此判断 panic/fatal"
elif printf '%s' "$_jlog" | grep -qiE 'panic|fatal|SIGSEGV'; then
bad "近 2 分钟出现 panic/fatal（见 journalctl -u $SERVICE）"; CHECK_FAIL=$((CHECK_FAIL+1))
else
bad "近 2 分钟出现 $fc 条 panic/fatal"; CHECK_FAIL=$((CHECK_FAIL+1))
ok "近 2 分钟无 panic/fatal（已读到日志）"
fi
# 桥重连：Gateway 重启会掐断所有 SSE，插件应当在几秒内自己回来。
# 一个都没回来通常意味着密钥被撤销（停用 Agent 会撤销密钥）或端口没起。
sse="$(journalctl -u "$SERVICE" --since '1 min ago' --no-pager 2>/dev/null \
| grep -c 'Client connected' || true)"
if [ "${sse:-0}" -gt 0 ]; then
ok "已有 $sse 个 SSE 客户端重新连上"
_jlog2="$(journalctl -u "$SERVICE" --since '1 min ago' --no-pager 2>/dev/null)"; _jrc2=$?
if [ "$_jrc2" != "0" ]; then
warn "读不到日志（journalctl 退出码 $_jrc2）—— 无法据此判断 SSE 是否重连"
else
warn "暂未看到 SSE 重连 —— 若插件应当在线，检查密钥是否被撤销（停用会撤销密钥）"
sse="$(printf '%s' "$_jlog2" | grep -c 'Client connected' || true)"
if [ "${sse:-0}" -gt 0 ]; then
ok "已有 $sse 个 SSE 客户端重新连上"
else
warn "暂未看到 SSE 重连 —— 若插件应当在线，检查密钥是否被撤销（停用会撤销密钥）"
fi
fi
unset _jlog _jlog2 _jrc _jrc2 2>/dev/null || true
echo
echo " 仍需人工确认（脚本无法代替）:"