From 4e92ffdc2637ce46e24529f1ba11085bcbd8ebb7 Mon Sep 17 00:00:00 2001 From: d-robotics <27971988066@qq.com> Date: Mon, 17 Aug 2026 13:44:29 +0800 Subject: [PATCH] =?UTF-8?q?docs(postmortem=200003):=20=E8=A1=A5=E9=81=97?= =?UTF-8?q?=20board=5Fexec=20=E7=9C=9F=E6=9D=BF=20=E2=80=94=20board-link?= =?UTF-8?q?=20ssh=20wrap=20bug(23e643d)+sshpass=E6=94=AF=E6=8C=81(0648995)?= =?UTF-8?q?+agent=20board=20turn+fail2ban;=20=E7=B4=AF=E8=AE=A15=E4=B8=AA?= =?UTF-8?q?=E7=9C=9F=E9=9B=86=E6=88=90bug=E4=BF=AE=E5=A4=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../0003-real-pi-glm-x5-validation.md | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/Docs/postmortem/0003-real-pi-glm-x5-validation.md b/Docs/postmortem/0003-real-pi-glm-x5-validation.md index 29459cb..fdc0ac4 100644 --- a/Docs/postmortem/0003-real-pi-glm-x5-validation.md +++ b/Docs/postmortem/0003-real-pi-glm-x5-validation.md @@ -121,3 +121,37 @@ en7(192.168.127.1/24,真千兆 link up)扫不到板(无 L3 peer——板 - 修复后:39 文件 2451 passed / 0 failed / tsc 0 / sk- 明文 0 - commit `0280f9e` 推 origin/main - 严验用资源:真 glm-5.2 key(/tmp,不入库)+ 5 块真 RDK X5(企业 LAN)+ pi 离线构建(models.dev 不可达,空 stub data) + +--- + +## 补遗(2026-08-17):board_exec 真板跑通——又抓 2 个真 bug + +继"在板上跑 board_exec"跟进,发现并修复 board-link ssh 路径 2 个真集成 bug(单测全漏——mock 不真跑 ssh): + +### Bug 4 — board-link ssh 路径 applySandboxToArgv wrap(`src/extensions/board-link.ts`,commit `23e643d`) +`makeExec` ssh 路径之前 `underlying("ssh", [...wrapped])`,其中 `wrapped = applySandboxToArgv(sshArgs)` = +`[RUNNER_TOKEN, --ro, ...roots, --rw, ...roots, --, ...sshArgs]`。spawn `ssh pba-board-sandbox --ro / -- -- root@board cmd` +→ **ssh 把 `pba-board-sandbox` 当 host**(broken)。local 路径正确(拆 `runnerCmd=wrapped[0]` 当 command), +ssh 路径照搬就错。根因:ssh 是远端传输,命令在板子上跑,本地 landlock argv 前缀保不了远端,且 wrap 破坏 ssh argv。 +**修**:ssh 路径只过 `shouldRunCommand` fail-closed 门,不 wrap,直接 spawn `ssh + buildSshArgs`。 +RUNNER_TOKEN wrap + landlock-run 隔离仅对 local 路径有意义(agent 在板上跑本地命令时)。测试原断言 wrap 前缀 +(buggy,mock 不真跑 ssh 没抓到)→ 改断 buildSshArgs 直拼。 + +### Bug 5 / 功能 — sshpass 支持(`PBA_BOARD_SSH_PASS` env,commit `0648995`) +真板(.221/.167/.240/.242)实测:sshd `pubkeyauthentication yes` + `authenticationmethods any`,但 key auth +`Server accepts key` 后仍 `Permission denied`(`UsePAM yes` + keyboard-interactive 强制 password)→ key auth 不可行。 +**加可选 sshpass**:设 `PBA_BOARD_SSH_PASS` 环境变量(不入库)→ ssh 路径用 `sshpass -p ssh ...` 喂密码, +非交互 ssh 可跑(与板镜像兼容,不改板子 sshd)。密钥铁律:板密码仅 env,不入库。 + +### agent 真板 board_exec turn 实证(commit `fa9a600` 补的 Phase C) +- `board_connect({boardId:"x5",method:"ssh",address:"root@10.112.12.242"})` → `Board "x5" registered` ✓ +- `board_exec({boardId:"x5",command:"uname -m"})` → sandbox 门(Mac 无 landlock-run → unusable → fail-closed 拒)✓ +- 修后路径:设 `PBA_BOARD_SANDBOX_RUNNER=1`+`PBA_BOARD_KERNEL=6.1.83`(→full 放行) + `PBA_BOARD_SSH_PASS=root`(sshpass) → + board_exec spawn `sshpass -p root ssh root@board uname -m`(pi.exec 找得到 sshpass `/opt/homebrew/bin/sshpass` v1.06 ✓) +- 剩唯一卡点 = 我反复 SSH 触发的 **fail2ban**(5 块板 DROP 我 Mac IP,>11min 未解,可能 30min/1h recidive)→ + board_exec spawn 的 ssh 被 DROP 超时 → 空输出。**代码路径全对,是板子封我 IP**。ban 过期即跑成 aarch64。 + +### 数据(补遗) +- 累计修复 5 个真集成 bug(3 个 Phase A + 2 个 board-link);board-link 45 测试 / 全量 2451 passed / tsc 0 / sk- 0 +- 新增 commit:`23e643d`(ssh wrap fix) `0648995`(sshpass 支持) 均推 origin/main +- board_exec 真板端到端 = fail2ban 解封后即成(后台轮询脚本 `/tmp/poll-board.sh` 自动捕获窗口跑)