d-robotics d671f174fe feat(v3): P0 全落地 — T01-T05b 安全骨架 + 命门根治
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>
2026-08-14 12:12:24 +08:00
..

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 支持)或 Docker muslcc/aarch64。
  • gnu glibc:brew install aarch64-elf-gcc 不含 linux headers;推荐用 Docker dockcross/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 + --probe exit 2 验证
  • ⏳ aarch64 真二进制:本机无交叉编译器(无 aarch64-linux-musl-gcc / docker),真板部署需在 有 toolchain 的环境跑 make cross-aarch64。源码就绪,缺的只是 toolchain。