LCU安全设计全解:如何防止Agent批准自己的宿主应用,诊断日志的fail-closed哲学

原创2026-10-16 06:52:021,336 阅读

LCU安全设计全解:如何防止Agent批准自己的宿主应用,诊断日志的fail-closed哲学

LCU 把 Codex 的 computer use 运行时从官方应用中解耦出来,让 Claude Code、Codex CLI、Pi、Hermes 等任意 harness 都能安全地控制桌面应用。但"能操作任何已批准应用"也暗藏致命风险:Agent 可能反过来批准控制自己的宿主应用,实现自我放行。本文完整拆解 LCU 安全设计:host-guard 如何确保"Agent 永远无法批准自己的宿主应用",以及诊断日志如何贯彻 fail-closed 哲学——只记元数据、任何失败即静默、绝不改变调用结果。

LCU 项目演示海报:Codex computer use 从官方应用解耦

为什么"Agent 批准宿主"是最危险的漏洞

Computer use 的核心能力是:在任何已批准的应用里读取窗口、点击按钮、输入文字。LCU 保留了逐应用审批——无论 harness 处于哪种权限模式,第一次控制某个应用前,运行时都会先询问用户。

问题在于:如果用户批准了"承载 Agent 的那个应用"(比如运行 Claude Code 的终端、打开了 Agent 扩展的编辑器),Agent 就能直接点击那个界面上的"Allow"按钮,等于自己批准了自己。审批机制瞬间形同虚设,安全边界彻底崩塌。

LCU 用两道防线堵死了这条路 🛡️

防止Agent批准自己的宿主应用:host-guard 双保险

核心实现位于 adapters/host-guard.mjs,被 Claude relay、Codex relay 和共享客户端(Pi、Oh My Pi、Hermes)共同调用,在运行时把审批请求转发给用户之前就介入。

动态检测:沿进程树向上找"谁在运行我"

findHostApps(adapters/host-guard.mjs#L80-L107)从适配器进程自身出发,逐级用 ps 查询父进程并读取各 .app 包的 CFBundleIdentifier,收集所有祖先应用。例如这条进程链:

ChatGPT 应用内 Node → claude CLI → zsh → Zed → Claude 桌面应用

会被依次认出 Claude Code CLI、Zed 和 Claude 桌面。这意味着 VS Code、Cursor、Zed 这类常见的 computer-use 目标,只要当前会话确实由其中的 Agent 扩展承载,也会被动态识别并拒绝——无需写死在名单里。LCU 自身运行所在的官方应用 Node 运行时则会被跳过,避免误伤。

静态名单:已知 Agent 宿主与终端兜底

KNOWN_AGENT_HOSTS 内置 16 项"专属 Agent 宿主与终端":Claude 桌面、Claude Code、Codex、OpenCode、Factory、Hermes,以及 Terminal、iTerm2、Ghostty、Warp、WezTerm、Alacritty、kitty、Hyper、Rio、Wave。当进程查询失败或不可用时(比如宿主环境限制),这张名单就是最后一道兜底防线——检测降级,但拒绝不停。

拒绝发生在"提问"之前

declineAgentHostApp(adapters/host-guard.mjs#L141-L148)命中宿主应用后直接返回 decline:

  • 不打扰用户:审批弹窗根本不会弹出,也不存在被误点"Allow"的机会;
  • 模型不知情:elicitation 回复无法携带文字,模型只能看到运行时原生的 "Computer Use was not approved to use <app>" 错误,无从得知拒绝原因;
  • 留痕可查:Claude/Codex relay 会在 stderr 打印 LCU does not allow computer use to control the app hosting this agent (...),共享客户端则在诊断日志中记一条 agent_host_refused 审批事件。

唯一的旁路是环境变量 LCU_ALLOW_AGENT_HOST_APPROVAL=1,官方明确声明它仅用于测试审批流程,日常使用切勿开启。

LCU 原生 Computer use 审批面板:Allow this conversation / Always allow / Deny

LCU 0.9.1 原生 computer-use 审批演示

诊断日志的 fail-closed 哲学

"某次调用挂起了,为什么?"——为此,每个适配器进程都会写一份本地诊断日志,由 adapters/diagnostics.mjs 实现,常量在 lcu/diagnostic_log.mjs#L5-L7 中镜像。它的每条设计决策都遵循同一原则:日志功能一旦失败,永远倒向"不记录",而不是改变或中断任何调用。

只记元数据,永不记内容

✅ 会记录:适配器名、LCU 版本、平台、pid;工具名、请求超时、耗时毫秒、结果(ok / tool_error / timeout / aborted / error);审批类型(native_app、browser_origin、agent_host_refused、other)、被审批应用的标识、提供的持久化范围、用户的选择;回合结束事件。

🚫 永不记录:工具参数(模型执行的 JavaScript)、工具结果(文本或图片)、审批消息、窗口/UI/辅助功能文本、错误消息文本、上游 stderr 原文、文件内容、原始 session/turn/tool 标识。

即使是被记录的字段也有硬性截断:字符串最长 200 字符,字符串数组最多 8 项(adapters/diagnostics.mjs#L64-L75)。

任何失败 → 日志静默退出

  • event() 永不抛异常:任何文件系统错误会让该进程的日志立即关闭(stderr 提示 LCU diagnostic log disabled: ...),后续事件直接丢弃;
  • 日志打不开、写不进去,工具调用照常进行——日志从不参与任何调用的成败判定;
  • 目录权限 0700、文件权限 0600,仅当前用户可读写;文件只留在本机,永不上传。

有界的保留策略

约束 值
保留时长 7 天(打开新日志时清理过期文件)
总大小上限 20 MB(超出从最旧文件开始删除)
单进程文件上限 2 MB(写一条 log_full 后停止写入)

日志文件按 <adapter>-<UTC 时间戳>-<pid>.jsonl 命名,macOS 位于 ~/Library/Logs/LCU/,Linux 位于 ~/.local/state/lcu/logs/。lcu status 与 lcu doctor 会直接打印目录与策略;设置 LCU_DIAGNOSTIC_LOG=0 则完全关闭——不建目录、不写文件、不做清理。

配套的安全边界:审批最小授权

宿主保护之外,LCU 的审批配置同样贯彻"最小授权",实现见 lcu/approval.mjs:

  • 逐应用审批在所有权限模式下始终生效。可选的 lcu setup --approval auto 只针对无人值守机器(VM、CI):它仅预放行 js 和 js_reset 这两个模型可见工具,从不放行整个 lcu 服务器——将来新增的任何工具(尤其是需要用户确认的工具)都不会被旧的 auto 意外放行;
  • 只动自己的记录:LCU 的每处改动都记在 approval.json 中,切回 ask 时精确还原它自己加过的条目,用户自己的同名配置永远不会被删除;
  • 管理已批准应用需要你本人在场:lcu apps 随时可查"Always allow"列表,allow / revoke 需要 Touch ID 或密码,所以即使 Agent 试图自己运行这些命令,也会被系统提示拦住。

LCU Approved apps 面板:逐个应用的批准与撤销管理

另一个 fail-closed 细节:当宿主根本无法呈现审批请求时(例如 Linux 上的原始运行时没有逐应用审批,或某个宿主不支持 elicitation),LCU 选择拒绝放行,而不是静默跳过——详见 docs/ADAPTERS.md。

小结:LCU 安全设计的三条主线

  1. 🛡️ 宿主保护:动态进程树检测 + 静态宿主名单双保险,在任何审批弹窗出现之前拒绝 Agent 控制其宿主应用,模型与用户都无法绕过;
  2. 元数据日志:只记可验证的行为事实,字符串截断、数组截尾,隐私内容一律不落盘,且永不离开本机;
  3. fail-closed 哲学:日志写不进就关掉、宿主进程查不到就退回静态名单、审批呈现不了就拒绝放行——所有不确定性都倒向"更安全的一侧"。

相关实现与测试:adapters/host-guard.mjs、adapters/diagnostics.mjs、adapters/test/host-guard.test.mjs、adapters/test/diagnostics.test.mjs,以及设计文档 docs/ADAPTERS.md。

登录后查看全文
lcu