P0 六项任务全部完成,1044 单测全绿,tsc 0 错。 - T01 真 createAgentSession boot 离线验证(e2e-runtime + e2e-smoke 71 测试) - T02 safety-gate 正则与 hex 归一联动,堵 devmem 十进制砖板漏洞;devmem-via-bash 硬门 - T03 reg-tool.ts:datasheet 地址校验寄存器工具,prepareArguments 接 hex 归一;barrel 22 工厂 - T04 src/core/tool-pipeline.ts:五段流水线 + 单调 guard 不变量;safety-gate 委托 decide();flash finalizeFlashContent - T05a sandbox-policy.ts:fail-closed unusable→exitCode126 不 spawn;board-link 包 argv - T05b native/landlock-run/landlock-run.c:C11 raw-landlock self-restrict-then-exec + Makefile + README;probeViaBinary 接线 测试方法:等价类/边界值/决策表/状态转换/变异/对抗/元蜕变(TDD test-first)。 文档:架构设计文档_v3.md 进度表 + Docs/postmortem/0001-e2e-smoke.md。 Co-Authored-By: Claude <noreply@anthropic.com>
landlock-run — 板侧命令沙箱 runner(T05b)
板侧 Landlock 沙箱真身,嫁接 dsh native/landlock-run(C11,self-restrict-then-exec)到 pba。
设计
src/core/sandbox-policy.ts的applySandboxToArgv产出 argv 形如["pba-board-sandbox","--ro",...,"--rw",...,"--",cmd,...];本程序即pba-board-sandbox真身。- 解析策略 → 建 Landlock ruleset(
LANDLOCK_RULE_PATH_ACCESS,ro=读+执行,rw=读+写+执行+建/删)→prctl(PR_SET_NO_NEW_PRIVS)→landlock_restrict_self→execvp(cmd)。 ruleset 跨 execve 继承(内核保证),子进程受同一围栏约束。 - fail-closed:landlock 不可用(内核 <5.13 / 未编入 / syscall 号缺失)或 ruleset 构建失败 →
拒绝 exec(exit 126),与
sandbox-policy.ts的unusable → exitCode 126对齐。 - probe 子命令:
landlock-run --probe→ exit code 映射SandboxCapability:0=full/1=partial/2=unusable。sandbox-policy.ts的probeViaBinary消费此契约。
构建
| 目标 | 命令 | 产物 | 用途 |
|---|---|---|---|
| 宿主 stub | make native |
landlock-run-stub |
macOS/Linux 契约测试(macOS 走 non-linux stub:probe 报 unusable) |
| 语法检查 | make syntax |
— | CI(clang -fsyntax-only) |
| aarch64 musl 静态 | make cross-aarch64 |
landlock-run-aarch64 |
真板部署(需 aarch64-linux-musl-gcc) |
| aarch64 gnu | make cross-aarch64-gnu |
landlock-run-aarch64-gnu |
板上有 glibc 时 |
交叉编译器安装:
- musl 静态:
brew install FiloSottile/musl-cross/musl-cross(aarch64 支持)或 Dockermuslcc/aarch64。 - gnu glibc:
brew install aarch64-elf-gcc不含 linux headers;推荐用 Dockerdockcross/linux-arm64。
用法
# 探能力
./landlock-run --probe # exit 0/1/2 = full/partial/unusable
# 沙箱执行
./landlock-run --ro / --ro /proc --rw /workspace -- /usr/bin/devmem 0x40020000 w
与 sandbox-policy.ts 的接线
src/core/sandbox-policy.ts 的 probeViaBinary(binaryPath) 执行 landlock-run --probe,
按 exit code 映射 SandboxCapability。板侧部署时 PBA_BOARD_SANDBOX_BINARY 环境变量指向
本二进制路径,resolveBoardSandbox 优先用 binary probe(真 landlock),否则退回 env-var 模拟。
当前状态
- ✅ C 源(landlock path
__linux__守卫 + raw syscall;macOS stub 语法检查 + 契约验证通过) - ✅ 宿主 stub:
make native+--probeexit 2 验证 - ⏳ aarch64 真二进制:本机无交叉编译器(无 aarch64-linux-musl-gcc / docker),真板部署需在
有 toolchain 的环境跑
make cross-aarch64。源码就绪,缺的只是 toolchain。