Senpi Task 生产环境 RPC 路由充分性验证:process 执行模式到 RPC Runner 的端到端证据链

原创2026-09-18 17:00:521,357 阅读
文章标签:人工智能AI Agent代码智能体多智能体Agent 编排工具调用MCP 服务MCP ClientsAI 技能Agent 记忆GUI 自动化CLI开发工具

Senpi Task 生产环境 RPC 路由充分性验证:process 执行模式到 RPC Runner 的端到端证据链

导读:本文围绕 omo 项目 senpi-task 生产任务驱动中 execution_mode: "process" 是否真正被路由到 RPC runner 这一核心验收项,完整解读 .omo/evidence/20260816-pr-6858-brutal-review/routing-sufficiency.md 及配套原始工件 routing-green.json 的十二项观测,并结合仓库源码(执行模式解析链、RPC 子进程 spawn 参数构造、会话/凭据隔离、reconcile 生命周期)说明每条观测背后的实现机制。读完本文,你将掌握如何用「原始工件 + 源码佐证 + 聚合解读」三层证据来证明一条生产路由路径的充分性,以及如何在聚合结果为 FAIL 的情况下仍能准确圈定 blocker 相关路由为 GREEN。

一、背景:评审阻塞项要求生产路由自证

在 PR #6858 的评审中,内联评论 3790854397 提出了一项必须被证明的阻塞项(Required blocker):生产环境 Senpi 任务驱动必须证明 execution_mode: "process" 确实到达了 RPC runner,并且满足两个关键条件:

  • wiringFixed: true:路由接线已修复,进程模式不再被错误地当作 in-process 处理;
  • 存在真实的子进程 PID:路由不是模拟或桩实现,而是真正拉起了一个独立的 RPC 子进程。

这项要求的背景可以从仓库源码中看到。执行模式在 senpi-task 中有明确的解析链(execution-mode.ts):

// Precedence: spec.execution_mode ?? agentDef.executionMode ?? omo.json task.default_execution_mode
// ?? "in-process".
export function resolveExecutionMode(sources: ExecutionModeSources): ExecutionMode {
  return sources.specMode ?? sources.agentMode ?? sources.configMode ?? "in-process"
}

也就是说,一个任务节点的执行模式最终由四层决定:任务规格(spec)中的 execution_mode、Agent 定义中的 executionMode、omo.json 中 task.default_execution_mode,以及兜底值 "in-process"。因此,评审要求证明的实质是:当上述链路解析出 "process" 时,调度器确实把该节点交给了 RPC runner,而不是静默降级为进程内执行——这正是 "production routing sufficiency" 的含义。

二、原始工件:routing-green.json 的完整观测

本验证对应的原始证据工件是 routing-green.json。这是一份真实的驱动运行产物,其顶层字段同时记录了聚合结论与关键事实:

{
  "result": "FAIL",
  "realCredentialsUntouched": true,
  "wholeDirDigestStable": true,
  "leakedPids": 0,
  "providedAgentDir": "IGNORED",
  "sandboxAgentDir": "/var/folders/h6/.../omo-senpi-qa-4qab4h/agent",
  "sandboxCwd": "/var/folders/h6/.../omo-senpi-qa-4qab4h/project",
  "wiringFixed": true,
  "interpretation": "The production process route and RPC child PID proof are GREEN. The aggregate result is FAIL only because the unrelated reconcile check did not record lostWithPid even though the orphan was dead."
}

工件内共 8 项 check,逐项给出 verdict 与事实。下文按 routing-sufficiency.md 所列的 12 项观测逐一展开。

三、十二项观测逐条解读与源码佐证

1. wiringFixed: true

顶层字段确认路由接线已修复。结合源码,这条观测对应的是「process 模式必须落到 RPC runner」这一接线逻辑的最终生效标志——只有 resolveExecutionMode 链返回 "process" 且调度器按该模式选择 RPC runner 时,该标志才可能为真。

2. process_mode_routes_to_rpc_runner: PASS

对应工件中的首个关键 check:

{
  "check": "process_mode_routes_to_rpc_runner",
  "verdict": "PASS",
  "facts": { "task_id": "st_01a008a4", "pid": 29366, "status": "completed", "error_excerpt": "" }
}

它证明 process 模式确实路由到了 RPC runner。从源码侧看,RPC runner 的接口契约定义在 runners/types.ts 的 RpcRunnerSpec 与 runners/types.ts 的 RpcChildHandle 中——后者暴露 pid、steer、followUp、abort、terminate、waitForExit 等能力,是路由层与真实子进程交互的统一句柄。

3. 真实任务 st_01a008a4

观测确认这是一个真实运行的任务(task_id 为 st_01a008a4),而非测试桩。任务记录中会携带该 id,生命周期与 reconcile 逻辑均以其为主键进行追踪。

4. 真实 RPC 子进程 PID 29366

工件在 spawn_process_pid_and_session_jsonl check 中记录了 "pid": 29366。这是独立进程的真实 PID,证明 RPC 子进程确实被拉起。RPC 子进程的 spawn 构造位于 spawn.ts 的 buildRpcSpawn:它优先使用 senpi 可执行文件以 --mode rpc 方式启动子进程,找不到可执行文件时才回退到 execPath + rpc-entry 路径,从而避免 loader 别名劫持破坏子进程解析。

5. Residency 状态 rpc_detached

spawn_process_pid_and_session_jsonl 同时记录了 "residency_state": "rpc_detached"。该状态在 residency.ts 中被归类为"需要新 residency 槽位"的挂起态之一(SUSPENDED_RESIDENCIES = new Set(["persisted_only", "rpc_detached"])),即子进程脱离父进程内存、以独立进程常驻,父进程通过 RPC 句柄与它通信。

6. 子会话 JSONL 存在

"sessionJsonl": true 证明子进程的会话转录文件真实落盘。源码侧,子会话目录被刻意隔离在 senpi-task 自己的 state 目录下(spawn.ts):

export function resolveChildSessionDir(stateDir: string, taskId: string): string {
  return `${join(stateDir, "sessions", taskId)}${sep}`
}

注释明确写道:会话 JSONL 必须落在 senpi-task 命名空间内,绝不写入用户的真实 ~/.senpi sessions,这是凭据与隐私隔离的第一道防线。

7. 运行中途 steer 确认通过

steer_ack_mid_run: PASS。它证明子进程运行中途仍可被父进程引导(steer)。对应 ChildHandle.steer(text): Promise<void> 接口(runners/types.ts)在真实 RPC 链路上的往返可用性——路由层不仅能拉起子进程,还能在运行期间持续控制它。

8. Completion push 到达

completion_push_arrives: PASS,且记录了 "statusSnapshotCount": 10,即完成推送到达前已观测到 10 次状态快照。这说明子进程的完成事件能通过 RPC 通道回传父进程,父进程据此推进任务状态机。

9. Kill 行为产生 killed: true

kill_marks_error_killed_true: PASS,其事实为:

{ "pid": 30331, "killed": true, "error_excerpt": "RPC child killed by signal SIGKILL (pid=30331)" }

注意这里出现了第二个 PID 30331——这是 kill 场景中实际被终止的子进程 PID(与主路由观测的 29366 分属不同运行实例)。源码侧,退出结果被规范化为四种 kind(runners/types.ts):clean、killed、crashed、spawn_error;kill 行为对应 "killed" 分支,并附带 ChildExitFacts(pid、code、signal、stderrTail),killed: true 正是该分支被正确选中的证据。

10. 真实凭据文件与整个 agent 目录 digest 不变

real_credentials_untouched_and_caller_env_ignored: PASS,其事实:

{
  "realCredentialsUntouched": true,
  "providedAgentDir": "IGNORED",
  "sandboxAgentDir": "/var/folders/.../omo-senpi-qa-4qab4h/agent",
  "credentialFiles": ["auth.json", "models.json", "settings.json", "trust.json"]
}

顶层另有 "wholeDirDigestStable": true,证明验证前后整个 agent 目录的 digest 完全一致。源码侧,这一隔离由 spawn.ts 的 buildChildProfile 支撑:子进程继承父进程 env,但会删除成员身份相关的 env 变量(MEMBER_PROCESS_ENV_NAMES 与 WORKPOOL_PROCESS_ENV_NAMES),再注入显式的 memberEnv,并为子进程设置独立的 SENPI_CODING_AGENT_SESSION_DIR。

11. 调用方提供的 agent 目录被忽略,改用沙箱目录

"providedAgentDir": "IGNORED" 且实际使用 sandboxAgentDir。这验证了安全边界:调用方传入的 agent 目录不会进入子进程解析路径,真实凭据文件(auth/models/settings/trust 四件套)按正常方式从沙箱 agent 目录解析,杜绝了外部目录注入。

12. leakedPids: 0

顶层字段 "leakedPids": 0 且 no_leaked_rpc_child_pids: PASS("leakedPids": []),证明验证结束后没有任何 RPC 子进程残留。这是进程生命周期完整性的最终确认:拉起、steer、completion、kill 全链路走完后,所有子进程都被回收,无孤儿泄漏。

四、聚合结果解读:为什么 FAIL 与 GREEN 可以并存

这是本验证最容易被误读的一点,原文档给出了明确结论:

原始驱动工件保留其真实的聚合结果 "result": "FAIL",因为其中一项独立的 reconcile 场景没有记录 lostWithPid,尽管孤儿进程实际上已经死亡。该项检查与提交的进程路由阻塞项无关,且未被重贴标签或隐藏。

工件中对应的是 reconcile_lost_terminates_orphan: FAIL,其原因为:

{ "reason": "relaunchOk=true lostWithPid=false orphanDead=true", "facts": { "orphanPid": 31070, "orphanDead": true, "breadcrumb": "" } }

也就是说:孤儿进程(orphanPid: 31070)确实已死(orphanDead: true),relaunch 也成功(relaunchOk: true),但该检查期望记录 lostWithPid: true 而未满足,因此该项标 FAIL。这与路由充分性无关——路由验证关心的 observable 全部通过。

这一设计体现了证据纪律:聚合结果不得被"修正"以粉饰局部失败,阻塞项相关的子路由单独判定为 GREEN,而无关的独立场景保留其真实 FAIL。从源码侧看,reconcile 逻辑确实区分了多种孤儿处置路径(reconcile.ts):当记录非 resident 时会走 reconcileLegacyRecordExclusive,遇到存活的孤儿且在 reattach_on_reconcile === false 时直接终止(lost_and_terminated),终止失败则 markLost——不同分支会产生不同的 outcome 事实,lostWithPid 只是其中一个观测维度。该验证恰好落在"孤儿已死、未走标记路径"的分支上,因此该 check 如实 FAIL。

五、从验证反推实现:执行模式解析链与路由选择

5.1 四层解析链与兜底

前文已给出 execution-mode.ts 的四层优先链。测试用例完整覆盖了各层组合(execution-mode.test.ts):

  • 无任何来源时兜底 "in-process";
  • task.default_execution_mode: "process" 时配置层生效;
  • Agent 级 executionMode 覆盖配置层;
  • 内置只读 Agent(如 explore)即使显式配置 process 也会被强制回退 in-process。

5.2 DAG 节点的模式解析差异

对于 DAG 节点,解析走 resolveDagNodeExecutionMode(dag/execution-mode.ts),语义与全局链一致,但有一个严格约束:不存在 dag.default_execution_mode 配置键,因为严格的任务 schema 会拒绝 task.dag 内的未知键。测试用例 #given a config carrying task.dag.default_execution_mode ... #then the strict schema rejects it 专门验证了这一点(execution-mode.test.ts)。

这意味着 "process" 模式的合法来源只有三处:节点 spec、Agent 定义、task.default_execution_mode——本验证中的 execution_mode: "process" 正是通过这条受限链路解析出来并被路由到 RPC runner 的。

5.3 子进程 argv 的构造细节

一旦路由到 RPC runner,子进程的启动参数由 spawn.ts 的 buildChildArgs 构造,其关键设计:

  • 始终携带 --no-extensions 与 --no-ask-user:分离子进程不会自动加载父进程的整套包,也不会注册仅父进程可用的问题工具;
  • 显式 -e 注入父进程注册的扩展(DAG 拥有的任务会去掉 launcher 前缀扩展,防止子进程自举任务引擎);
  • --model 透传 provider/modelId——独立 OS 进程无法共享父进程内存中的模型注册表,因此模型必须落到子进程命令行;
  • --thinking 透传推理等级(取自 spec.reasoning ?? spec.variant)。

这些细节正是"真实 RPC 子进程"(PID 29366)能够独立完成模型解析、运行并回传完成事件的底层保证,与观测 2、4、8 一一对应。

六、证据管理与可复验性

本验证并非孤立文档,而是 PR #6858 证据充分性映射(sufficiency-map.md)中"Production Senpi RPC routing"一栏的 GREEN 工件,其 RED 对照物为 routing-red.txt(评审质疑"process 路由被当作 in-process 驳回"),GREEN 由 routing-green.json + routing-sufficiency.md 共同构成。

证据管理还遵循了以下纪律:

  • 真实凭据内容、auth 头、模型 token、私有配置体一律不落盘;
  • 不保留环境 dump;
  • 每次本地门禁(125 个可运行 Senpi runner 测试、senpi-task/omo-senpi/omo-codex 类型检查、Bun 1.3.12 生成的 bundle 校验等)均有 local-verification.txt 记录。

同一目录下的 review-green.json、review-red.json、review-response.json 等工件完整保留了评审提交与应答的闭环,便于回溯每个阻塞项从 RED 到 GREEN 的演进。

七、小结:如何证明一条生产路由的充分性

从本验证可以提炼出可复用的验证方法论:

  1. 把评审要求翻译成可观测谓词:阻塞项"process 到达 RPC runner"被拆解为 wiringFixed、route-to-rpc、真实 PID、会话 JSONL、residency 状态、steer、completion、kill、凭据不变、目录隔离、无泄漏共 12 项观测;
  2. 用真实工件而非断言说话:所有观测都落在 routing-green.json 的可审计字段上,并保留原始聚合结果不改写;
  3. 源码佐证每条观测:PID 对应 runners/types.ts 的 RpcChildHandle,residency 对应 residency.ts 的 rpc_detached,argv 构造对应 spawn.ts,孤儿处置对应 reconcile.ts;
  4. 区分"阻塞项路由"与"无关场景":聚合 FAIL 不掩盖阻塞项相关的 GREEN,反之亦然——把每个结论限定在其真正覆盖的观测集合内。

对于 senpi-task 的生产任务驱动而言,execution_mode: "process" 不再是配置文件里一个可能被静默忽略的字符串,而是一条被端到端证据链锁定的真实执行路径:从解析链(spec → agent → config → 兜底)到 RPC 子进程的 spawn 参数、会话目录隔离、凭据保护、运行期 steer、完成回传与终止回收,每一环都有实现与测试可循(核心验证入口见 dag/execution-mode.test.ts 与 runners/rpc 目录下的 terminate、handle、spawn 等测试)。

登录后查看全文
oh-my-openagent