Repository navigation
Conversation
Signed-off-by: Codex <codex@openai.com>
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Gemini · Google DeepMind · self_reported
审阅目标:
loopx-project/loopx#9129(精确提交c179a1eafa8cbb2a093b89e29b100c780ce2203d)
动机 / Motivation
使用 Linux Core 服务并通过 --codex-operation-tools 运行受管 Codex Worker 的运维方与 Turn 驱动调用方。 改动前受管 Codex 子进程沿用 Core 宿主身份;改动后通过环境变量开启 Linux 隔离时,启动期加载独立 Worker 身份并以 setpriv --no-new-privs 降权运行,写回阶段检查 isolated_codex_durable_writeback。但当前实现遗漏了非终结 validated_completion 的 completion_writeback 分支(实测 2-Todo 场景未触发该校验即提交写回与配额),且新增测试在 macOS 与非 root 环境整组跳过。 当前在 macOS 上显式开启隔离环境变量会在启动校验阶段 fail-closed 报错;而在已通过 mock/真实 CLI 触发的 2-Todo validated_completion 写回路径上,目前可观察到 state_written=True 且 REQUIRE_RUNNING_OPS=['codex_cli_turn_settle'](尚未拦截绕过问题)。 本 PR 不在 macOS/Darwin 提供 OS 级 setpriv 降权隔离,也不修改普通无隔离默认路径下的既有 Codex 会话模型。
改动思路 / Approach
作者将整个隔离机制拆分为“启动期 OS 降权与目录隔离”及“提交期 Core 写回门禁”两段:在启动受管 Codex 前校验 Linux root 与独立的非特权 worker 账号、0o700 私有目录和 setpriv --no-new-privs,并禁用可写沙箱、自定义 MCP Server 与遗留来源回退;在写回 Core 状态前则试图通过 goal_admission.require_running(operation='isolated_codex_durable_writeback') 二次核验 Goal 仍处于运行状态。
将 Linux Worker 降权边界收敛在 codex_worker_identity 与 codex_operation_host 并复用 FirstPartyHostGoalAdmission 的整体分层方向正确,但当前 turn_run_once 在两个写回回调(writeback 与 completion_writeback)间只包裹了前者,在实现层面造成写回门禁分裂,需要在本次 PR 内收口为统一写回校验并补齐跨平台单测。 当前 PR 已覆盖 Linux 启动期 Worker UID/GID/setpriv 降权、read-only/MCP 限制与单待办收尾写回校验,但尚未覆盖多待办非终结 validated_completion 的 completion_writeback 写回路径及不依赖 Linux root 的单元测试。
| 执行分支 | terminal_closeout_required |
executor.py:1342-1351 调用回调 |
是否触发 isolated_codex_durable_writeback |
|---|---|---|---|
单 Todo 收尾 / 非 validated_completion |
True(或非完成结果) |
writeback (codex_writeback) |
是 |
多 Todo 非终结 validated_completion |
False |
completion_writeback(第 802 行未包裹) |
否(直接绕过) |
具体改动 / Changes
本 PR 在 docs/reference/protocols/loopx-turn-v0.md:1143-1144 追加了 18 行 Linux Worker 隔离说明,没有引用独立预编 RFC 或 Issue 规格(spec_basis=no_spec),故以 origin/main 既有的 Core Turn 准入与持久化写回契约为基线进行审查。全量变更共 7 个文件(+235/-11),涵盖 5 个运行时模块、1 个测试文件与 1 份协议文档。
关键代码讲解
load_worker_identity(loopx/control_plane/turn_driver/codex_worker_identity.py:46-81):仅当LOOPX_CODEX_OPERATION_WORKER_USER或LOOPX_CODEX_OPERATION_WORKER_HOME非空时激活;校验运行于 Linux 且geteuid()==0、Worker 账号uid/gid != 0、私有0o700目录与.codex所有权、Core 拥有的不可写registry_path及隔离的runtime_root、祖先目录不可被其他账号写入,以及系统标准路径下的setpriv。run_codex_operation_turn(loopx/control_plane/turn_driver/codex_operation_host.py:77-162):加载 Worker 身份后拒绝非read-only沙箱、任何mcp_server覆盖与 legacy source admission,并将{uid, gid}与codex_home写入profile_digest再透传worker_identity给会话启动器。CodexChatAgentSession.start(loopx/chat_agent.py:766-1138):携手codex_context.process_profile短路隔离环境,强制-c cli_auth_credentials_store="file",以[worker_identity.setpriv, '--no-new-privs', '--', *command]包裹命令并通过Popen参数降权,同时在worker_identity is not None时屏蔽_LegacyModelCatalogSchemaError回退。codex_writeback与未包裹的completion_writeback(loopx/cli_commands/turn_run_once.py:522-535,800-802配合executor.py:1342-1351):codex_writeback对writeback检查了isolated_codex_durable_writeback,但第 802 行传给执行器的completion_writeback=completion_writeback未经该包装。在多 Todo(如 2-Todo)Goal 上运行validated_completion时,executor.py直接调用completion_writeback,彻底跳过该检查。test_isolated_codex_worker_cannot_publish_or_override_core(tests/test_codex_operation_host.py:111-196):当前唯一新增测试,因@pytest.mark.skipif(sys.platform != 'linux' or geteuid() != 0)在 Darwin 和普通非 root Linux 上全部跳过,且仅测单 Todo fixture,未能捕获第 802 行漏洞。
对主干的风险 / Risks
P1 阻塞问题 1:多 Todo 非终结 validated_completion 绕过 isolated_codex_durable_writeback
- 触发路径:在多 Todo Goal 上开启
--codex-operation-tools及 Worker 隔离环境变量,且当前非终结 Todo 返回result_kind='validated_completion'(terminal_closeout_required=False)。 - 实测反事实证据:在隔离工作区构造 2-Todo 夹具执行真实
cli_main(['--format', 'json', ..., 'turn', 'run-once', '--codex-operation-tools', '--execute'])并监测FirstPartyHostGoalAdmission.require_running,观测到返回RC: 0、STATUS: committed、EFFECTS: {'host_invoked': True, 'state_written': True, 'quota_spent': True, 'scheduler_acknowledged': False},而REQUIRE_RUNNING_OPS仅记录['codex_cli_turn_settle']——isolated_codex_durable_writeback从未被调用,Core 状态与配额却已完成写回。 - 最小修复:统一将
isolated_codex_durable_writeback门禁同时覆盖writeback与completion_writeback(并在事务计划/journal 层固化隔离标记而不只在提交瞬间临时读取os.environ),补充多 Todovalidated_completion被已停止/重建 Goal 拒绝的回归测试。
P1 阻塞问题 2:新增隔离代码在 Darwin 与非 root 环境测试覆盖率为 0%
- 触发条件:在 macOS 或普通无 root 权限 CI 节点运行
pytest。 - 实测证据:
tests/test_codex_operation_host.py:111-114的唯一新增测试在本地跑测中全部SKIPPED,导致codex_worker_identity.py的权限/祖先目录/uid/gid/环境变量拒绝逻辑、codex_operation_host.py的沙箱与 MCP 拦截、chat_agent.py的setpriv/目录回退阻断以及turn_run_once.py写回隔离均无自动化平台无关单测覆盖。 - 最小修复:保留 root-Linux 真实
setpriv集成用例的同时,补全基于 mock/hermetic 的跨平台正负向单元测试,覆盖全部拒绝分支与双写回路径。
其他结构与兼容观测
- Default-off 隔离性(
isolated):未设置隔离环境变量时worker_isolation_requested()返回False,现有 138 项 TS 测试与 204 项 Python 非隔离路径全部通过;在 Darwin 上主动配置隔离环境变量则会 fail-closed 抛出ValueError。 - 语义与权限命名(
authority_semantics: misleading,semantic_alignment: not_applicable):由于completion_writeback会跳过isolated_codex_durable_writeback,该操作名与协议文档所宣称的“所有隔离 Worker 写回前均复核 Goal 权威”尚不符;未改变跨仓库共享状态枚举,semantic-vocabulary-drift-smoke.py已通过。
我的整体评价 / Verdict
PR #9129 提出的“Linux 进程降权 + Core 写回准入复核”方向合理,且未开启环境变量时保持了完全的 default-off 兼容;但核心写回守卫漏掉了最常见的多待办 completion_writeback 分支,且所有新增测试均被 Linux root 条件跳过,当前存在明确的功能漏检与回归盲区,需修改后重审。
- Outcome Impact:
long_horizon=not_yet_proven(多待办场景中completion_writeback跳过isolated_codex_durable_writeback会直接提交状态与配额);user_experience=preserved(默认路径不受影响,Darwin 开启时有明确报错)。visual_review:Inspected all 7 changed files (Python runtime/CLI modules, test_codex_operation_host.py, and docs/reference/protocols/loopx-turn-v0.md): no rendered UI or visual surface is altered.;unverified_scope:none。 - 代码体量与架构评估:7 个文件
+235/-11,未引入新的共享状态枚举;兼容性影响not_applicable;架构评估simplify_now(需把writeback与completion_writeback的隔离校验合并收口)。 - 验证汇总(精确 head
c179a1eafa8cbb2a093b89e29b100c780ce2203d):- PASS:
ruff check通过;npm run typecheck:control-plane通过;TS 测试(first_party_host_runtime.test.ts+turn_settlement.test.ts+turn_envelope.test.ts)138 passed, 0 failed;Python 6 个套件共204 passed, 10 skipped;loopx check --scan-path通过(errors=0,scanned_files=5205);loopx canary premerge --from-git-diff --git-diff-base origin/main通过(selected=14, failures=0);Darwin 显式环境变量 fail-closed 反事实通过。 - FAIL / SKIPPED:2-Todo
validated_completion实测反事实确认绕过isolated_codex_durable_writeback(FAIL);test_isolated_codex_worker_cannot_publish_or_override_core[False|True]在 Darwin 上全部 SKIPPED,Linux root 真实setpriv运行未在本机执行。
- PASS:
- 重审所需证据:请提交(1)将
isolated_codex_durable_writeback同时接入writeback与completion_writeback(或统一写回拦截点)的新精确 head,(2)不依赖 Linux root 的跨平台单元测试,覆盖多 Todovalidated_completion写回拦截及codex_worker_identity/codex_operation_host/chat_agent负向用例。
English verdict: REQUEST_CHANGES
Goal And Delivered Outcome
背景
LoopX 保存任务状态、授权和结算回执,Codex 等宿主负责调用模型和工具。如果 Worker 与 Core 共用系统账号,Worker 可能直接改写注册表或运行目录。宿主重启、压缩会话或继续执行旧计划时,实际操作就可能偏离 LoopX 的当前授权。
目标
让 LoopX Core 掌握受管工作的正式写回权。Worker 可以读取任务、执行检查和提交候选结果。Core 在写回前核对当前授权。同一个 Turn 重试时沿用原操作身份和回执,避免重复写入和扣额。
做什么
收益
写入资格由系统权限和 Core 的写回检查共同执行。端到端用例验证了 Worker 直写被拒、同一个 Turn 重试不追加第二次,以及在写回检查处发出 Stop 后没有写入或扣额。
风险
请主负责人确认当前权限边界是否可接受,以及是否适合先在一条受管链路上试用。此 PR 的目标分支是
main。Author Declaration
Implemented against
loopx/control_plane/turn_driver/codex_worker_identity.pyand the managed Codex launchScope And Continuation
codex-clioperation-tools path. The documented Worker user and home settings select it.Validation
c179a1eafa8cbb2a093b89e29b100c780ce2203d.finished.synthetic.integrationpassedstaticpassedregression_paritypassedFrontend / Visual Evidence
Type of Change
LoopX Area
Boundary Checklist