feat(codex): enable embedded_context (@file mention) — phase 2

[KevinZhao]

概述

codex backend 的第一个 Phase-2 Feature：embedded_context（@file mention）。承接 PR #2216（codex backend Phase-1 已合并）。

实现路线 方案 A：借 codex 原生 agentic 读取（用户确认）。

实测决策（codex 0.141，详见 docs/rfc/codex-backend-phase2-feasibility.md §6）

初判"用结构化 mention UserInput"被探针推翻：

探针	沙箱	结果
单独 mention（cwd-相对 / 绝对 path）	read-only	❌ 未解析
text+text_elements+mention（TUI 线格式）	read-only	❌ "can't determine without reading the file"
纯 text 含 @path	workspace-write	✅ codex 解析 @path 并发 commandExecution 读文件

结论：codex 的 @path 不是 claude 式静态内联，而是靠 agentic shell 工具读取；结构化 mention 在 0.141 对内联无帮助 → 不发 mention 条目（避免投机复杂度）。

改动（最小正确，零协议码）

• internal/cli/backend/profile_codex.go：Features["embedded_context"] = true + 诚实注释。@path 已随 text 透传进 turn/start 的 text UserInput，WriteMessage 无需改。dashboard 闸门 featureForCurrent('embedded_context')（dashboard.js:4136）只要求"后端能从 prompt 内读路径"，codex 满足。
• 测试：TestCodexProtocol_WriteMessage_AtMentionVerbatim（@path 逐字进 text UserInput，不被 strip/rewrite）+ profile_test 断言 embedded_context=true、askuser/passthrough 仍 false。
• docs/rfc/codex-backend-phase2-feasibility.md §6：探针矩阵 + 决策 + 与 claude 的诚实差异。

与 claude 的诚实差异

	claude	codex
机制	CLI 静态内联文件内容	agentic shell 读取
read-only 沙箱	✅ 总能内联	⚠️ 读不到（需沙箱许可，codex 默认 workspace-write 可读）
naozhi 侧	纯透传	纯透传（零文件读取，零新增安全面）

弱于 claude 静态保证，但匹配 dashboard 契约。claude 式强保证需 naozhi 服务端内联（路径穿越/大小限制/workspace confine 安全面），留独立 RFC。

测试计划

• go build ./...
• gofmt -l（无 diff）
• go test ./internal/cli/ ./internal/cli/backend/ ./internal/server/
• codex 0.141 真实 app-server 探针（§6 矩阵）

后续 Phase-2（不在本 PR）

• passthrough（MODERATE，实测原语齐备：clientUserMessageId↔clientId + turn/steer）
• askuser（HARD，阻塞式 RPC，需先 live 捕获 requestUserInput schema）

🤖 Generated with Claude Code