LCU安全设计全解:如何防止Agent批准自己的宿主应用,诊断日志的fail-closed哲学
LCU安全设计全解:如何防止Agent批准自己的宿主应用,诊断日志的fail-closed哲学
LCU 把 Codex 的 computer use 运行时从官方应用中解耦出来,让 Claude Code、Codex CLI、Pi、Hermes 等任意 harness 都能安全地控制桌面应用。但"能操作任何已批准应用"也暗藏致命风险:Agent 可能反过来批准控制自己的宿主应用,实现自我放行。本文完整拆解 LCU 安全设计:host-guard 如何确保"Agent 永远无法批准自己的宿主应用",以及诊断日志如何贯彻 fail-closed 哲学——只记元数据、任何失败即静默、绝不改变调用结果。
为什么"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,官方明确声明它仅用于测试审批流程,日常使用切勿开启。
诊断日志的 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 试图自己运行这些命令,也会被系统提示拦住。
另一个 fail-closed 细节:当宿主根本无法呈现审批请求时(例如 Linux 上的原始运行时没有逐应用审批,或某个宿主不支持 elicitation),LCU 选择拒绝放行,而不是静默跳过——详见 docs/ADAPTERS.md。
小结:LCU 安全设计的三条主线
- 🛡️ 宿主保护:动态进程树检测 + 静态宿主名单双保险,在任何审批弹窗出现之前拒绝 Agent 控制其宿主应用,模型与用户都无法绕过;
- 元数据日志:只记可验证的行为事实,字符串截断、数组截尾,隐私内容一律不落盘,且永不离开本机;
- fail-closed 哲学:日志写不进就关掉、宿主进程查不到就退回静态名单、审批呈现不了就拒绝放行——所有不确定性都倒向"更安全的一侧"。
相关实现与测试:adapters/host-guard.mjs、adapters/diagnostics.mjs、adapters/test/host-guard.test.mjs、adapters/test/diagnostics.test.mjs,以及设计文档 docs/ADAPTERS.md。



