Skip to content

feat: 完善 Codex 登录、连接诊断与交互体验 - #204

Merged
lidingm merged 1 commit into
ZJU-REAL:mainfrom
zzx060828:fix/codex-harness-entry
Nov 17, 2026
Merged

lidingm merged 1 commit into
ZJU-REAL:mainfrom
zzx060828:fix/codex-harness-entry

Conversation

@zzx060828

@zzx060828 zzx060828 commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

变更摘要

主分支已经支持 Codex Harness,包括原生 App Server 对话、工具执行、会话创建与恢复、模型列表、沙箱和执行授权。本 PR 基于现有适配器,补充网页端登录、连接诊断、推理强度选择、图片输入和执行反馈。

用户可以从设置页完成 Codex 授权并测试所选模型,减少切换终端进行配置和排查的步骤。

本次新增与增强

  • 新增网页浏览器登录、设备验证码登录、取消登录和退出登录,调用 Codex 原生账号接口。
  • 新增账号状态和额度窗口查询,以及使用独立临时会话的只读连接测试。
  • 扩展现有模型列表,读取模型支持的推理强度、默认强度和输入模态;增加推理强度选择和保存。
  • 将通过会话归属与路径校验的图片附件以原生 localImage 传入 Codex。
  • 在已有流式活动提示上,增加命令开始/结束、退出码、文件变更、计划进度和原生报告的累计 Token 用量。
  • 分类提示认证、额度、限流、模型、上下文、网络和超时错误;新增诊断接口仅返回筛选后的账号字段和错误提示,stderr 不回显原文,活动详情增加凭证脱敏。
  • 为“本机 Agent”中的 Codex 增加独立底座配置入口,避免将“不支持作为 OpenClaw provider”误解为“不支持 Codex Harness”。
  • 调整工作台和侧栏提示文案,补充使用文档及后端、前端回归测试。

兼容性与边界

  • 沿用现有会话管理、工具执行、授权和取消机制,不自动切换已有底座。
  • Codex 凭证继续由原生 CLI 管理,不复制到 OpenClaw 配置中;保留其他底座配置。
  • 登录和退出登录作用于运行 Easel 的操作系统账户,不提供多用户认证隔离。
  • 连接测试会消耗少量模型用量,但不创建 Easel 对话记录或保存预览配置。
  • 媒体生成通道仍独立配置,Codex 登录不替代这些通道所需的 API 凭证。

验证情况

  • 开发过程中的 Python 全量测试:2124 passed, 21 skipped;该结果早于最后的退出登录改动,不代表最终提交的全量测试结果。
  • 退出登录改动后的相关后端测试:120 passed。
  • 相关前端回归测试、生产构建和 lint 通过。
  • 本地实际验证:原生模型探测、图片输入、会话续接、工具执行和报告文件生成。
  • 浏览器登录和设备码登录验证了发起与取消流程,使用临时凭证存储;未以重新授权替换已有账号。
  • 退出登录通过模拟原生协议的回归测试验证,未注销日常使用的真实账号。
  • 最后一次沙箱内后端复跑未完成并已停止,因此不将其计为通过;最终跨平台结果以本 PR 的 CI 为准。

使用方式

安装 Codex CLI 后,在 Easel 设置中选择 Codex,使用已有 CLI 登录态或点击网页登录。拉取模型、选择推理强度并测试连接,保存底座后新建对话。

可用模型、推理强度、登录方式和额度信息取决于 Codex CLI 版本及账号支持情况。

Add native Codex app-server sessions with model and reasoning controls, image input, diagnostics, login/logout flows, safe error handling, and frontend settings. Extend coverage and document local Codex setup without changing existing harness credentials.
@zzx060828 zzx060828 changed the title feat: 新增原生 Codex Agent Harness 支持 feat: 完善 Codex 登录、连接诊断与交互体验 Nov 12, 2026
@lidingm

lidingm commented Nov 17, 2026

Copy link
Copy Markdown
Collaborator

感谢基于现有 Codex Harness 补齐登录、诊断、推理强度、图片输入和执行反馈!这些功能有独立价值,能减少用户切到终端排查的问题,且保留原生凭证、多 Harness、现有会话和权限机制,本轮准备合入并补修。

我在隔离源码中运行原 PR 相关后端测试,141 passed / 2 skipped。复查补充用例分别复现了退出登录时并发登录仍可开始、未知账号类型误报已认证/异常响应未安全处理,以及命令里临时凭证出现在活动详情的问题。补修后的相关组合为 151 passed / 2 skipped;最后的账号状态同步调整又定向复跑 33 项通过,相关前端 29 项通过。

合并时一并带入这些补修:

  • 退出登录从发起到原生 RPC/连接清理结束期间占有账号操作状态,阻止并发登录、重复退出、诊断和新 Codex 任务;底座设置变更也不能在期间关闭连接。另一窗口可跟踪退出进度,不能取消退出操作,完成后刷新账号状态。
  • 账号与诊断会话/轮次的异常响应返回安全的 unknown/失败,不以缺失或未知类型证明登录成功。
  • 活动详情覆盖临时命令中的密钥赋值、认证头、密码参数和 URL 凭证脱敏,不依赖这些凭证已经存在于启动环境。
  • 解决主线冲突时保留已合入的 Hermes、多底座 UI、任务账本和 fix: escape surrogates in RPC pool signature #136 的环境 surrogate 签名修复,不回退既有功能。

原生登录/退出、设备码、图片和推理参数的字段已按本机 Codex CLI 0.162.1 生成的协议 schema 核对。官方文档站本机返回 403/访问超时,未将未打开的文档当证据。本轮只跑 schema 生成和替身 RPC/界面测试,没有登录、注销日常真实账号,也没有调用实际模型或平台;真实连接测试的少量用量继续在按钮旁明确说明。之后会在组合主线上做完整验证并 push。再次感谢贡献!

@lidingm
lidingm merged commit b6a2889 into ZJU-REAL:main Nov 17, 2026
@lidingm

lidingm commented Nov 17, 2026

Copy link
Copy Markdown
Collaborator

已合入并推送 main,最终提交 011e10d。组合验证又发现并修复了无附件、无浏览器会话 ID 的纯文本请求被图片逻辑误拦截的问题;现有任务中断/恢复回归已通过。

最终本机全量 Python 2447 passed / 29 skipped,前端 221 项、lint、生产构建及技能/命令/文档路径检查通过。Python 测试子进程峰值约 299 MiB。新提交的主线 CI 已 success,包括 Windows/Linux pytest、六组底座配置、前端、安装脚本与 PowerShell;真实安装按条件 skipped。

本轮验证为本机协议 schema、替身 RPC/界面及离线故障回归,没有登录或注销日常账号,也没有调用真实模型和平台。感谢贡献!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants