docs(postmortem 0003): 补遗 board_exec 真板 — board-link ssh wrap bug(23e643d)+sshpass支持(0648995)+agent board turn+fail2ban; 累计5个真集成bug修复
Some checks are pending
CI / quality-gate (push) Waiting to run
CI / type-drift (push) Waiting to run

This commit is contained in:
d-robotics 2026-08-17 13:44:29 +08:00
parent 0648995bac
commit 4e92ffdc26

View File

@ -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 <pass> 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` 自动捕获窗口跑)