Skip to content

本次更新重点优化了 Codex 工作区的交互体验,并扩展了插件体系

Choose a tag to compare

@ddlmanus ddlmanus released this 22 May 06:55

更新摘要

本次更新重点优化了 Codex 工作区的交互体验,并扩展了插件体系。前端侧新增插件/技能分栏、插件市场展示、Photoshop 插件设置弹窗、供应商与模型选择控件,并重构了输入框区域的布局与运行态展示。后端侧增加插件市场接口、Photoshop 云端插件配置与执行能力、Codex 供应商配置持久化,以及更友好的错误信息转换。

主要功能更新

1. Codex 插件中心升级

  • 左侧导航入口从“技能”调整为“插件”。
  • 插件页新增“插件 / 技能”双 Tab,可在同一页面切换管理。
  • 新增内置插件市场列表,包含 Spreadsheets、Presentations、GitHub、Slack、Notion、Linear、Statsig、Gmail、Google Calendar、Google Drive、Teams、SharePoint、Photoshop 等插件。
  • 插件卡片支持安装状态展示,未安装插件可通过界面触发安装。
  • 已安装插件可直接作为对话上下文进入 Codex 工作流。

2. Photoshop 云端插件

新增 Photoshop 插件配置、测试和执行链路,支持通过 Adobe Photoshop / Firefly Services 云端 API 处理上传图片。

后端新增能力:

  • 保存当前用户的 Photoshop 配置,包括 Adobe Client ID、Client Secret、公网 Base URL、默认操作和输出格式。
  • 支持 Photoshop 连接测试,先校验 Adobe 凭证是否可用。
  • 支持根据用户提示自动识别“去背景”或“蒙版”任务。
  • 支持提交 Adobe 云端任务、轮询任务状态、下载处理结果,并把结果作为图片生成产物写回任务事件。
  • Photoshop 任务使用独立 runtime:photoshop,不依赖 Codex API Key。

前端新增能力:

  • Photoshop 插件设置弹窗。
  • Adobe Client Secret 保存后只显示末尾预览,避免明文回显。
  • 执行前校验是否已配置 Photoshop 插件。
  • 执行前校验是否已上传图片。
  • Photoshop 插件可以通过插件卡片或 slash 上下文进入对话。

注意:Adobe 云端无法访问本地 localhost 图片。执行 Photoshop 云端任务前,需要配置可公网访问的 Base URL 或对象存储回源地址。

3. Codex 供应商与模型配置增强

  • Codex 配置增加 provider 字段。
  • 后端支持根据 Base URL 推断供应商,例如 ZenMux、OpenAI、OpenRouter、AiHubMix。
  • 不同供应商写入不同环境变量键:
    • ZenMux:ZENMUX_API_KEY
    • OpenAI:OPENAI_API_KEY
    • 其他 OpenAI 兼容服务:CODEX_API_KEY
  • 设置弹窗新增供应商选择。
  • 设置弹窗新增模型 datalist 和常用模型快捷按钮。
  • 输入框底部新增供应商选择器和模型选择器,便于在发起任务前快速切换。

4. 输入框与任务输出体验优化

  • 输入框高度、间距、阴影和底部工具栏视觉重新调整。
  • 权限选择从普通下拉框改为带图标的组合控件。
  • 移除独立推理强度下拉展示,输入框区域更紧凑。
  • 运行中状态改为输入框右侧的小型旋转指示器。
  • 变更摘要条与输入框区域整合更紧密。
  • 会话输出区域增加滚动监听,图片加载后可触发布局更新。
  • 编辑文件、变更文件展示改为优先显示文件名,并保留完整路径 title,减少长路径挤压界面。
  • 活动日志从圆点改为更明确的图标展示。

5. Codex app-server 事件与错误展示优化

  • 新增 fileChange 事件识别,可在前端更自然地展示文件编辑状态。
  • turn/failed 和通用错误事件增加友好错误文案转换。
  • 针对常见错误提供更明确提示:
    • 429:请求过于频繁或模型额度受限。
    • 401:API Key 无效或认证失败。
    • 403:当前 Key 无模型访问权限。
    • 404:生成接口或模型不可用。
    • 流中断:提示稍后重试或切换供应商/模型。

API 变更

新增接口

  • GET /codex/plugins/photoshop/config

    • 获取当前用户 Photoshop 插件配置的安全展示版本。
  • PUT /codex/plugins/photoshop/config

    • 保存当前用户 Photoshop 插件配置。
  • POST /codex/plugins/photoshop/config/test

    • 测试 Adobe Photoshop / Firefly Services 连接。
  • POST /codex/plugins/install

    • 安装内置插件到当前用户的 Codex 插件目录。

已有接口扩展

  • GET /codex/skills

    • 返回值新增 marketplace_plugins,用于插件市场展示。
  • PUT /codex/config

    • 请求体新增 provider 字段。
    • 配置写入时会根据供应商生成对应 Codex 配置。
  • POST /codex/tasks

    • 当选中的上下文为 Photoshop 插件时,任务 runtime 切换为 photoshop,走 Adobe 云端处理流程。
  • POST /codex/tasks/:id/messages

    • Photoshop 插件续发消息时会创建新的 Photoshop 任务,不复用 Codex thread。

兼容性与部署注意事项

  • Photoshop 云端插件依赖 Adobe Developer Console 凭证。
  • Photoshop 图片处理依赖公网可访问的附件 URL,本地开发环境需要反向代理、临时公网隧道或对象存储。
  • Codex 配置现在依赖 provider 字段,旧配置如果没有 provider,会根据 Base URL 自动推断;无法推断时使用 custom
  • OpenAI 兼容服务仍通过 Responses wire API 调用,Base URL 和模型名称需要与对应供应商兼容。
  • 本次更新没有看到测试用例变更,发布前建议至少验证:
    • Codex 设置保存和连接测试。
    • ZenMux、OpenAI 或 OpenRouter 至少一个供应商的任务发起。
    • 插件页加载、搜索、安装、已安装状态展示。
    • Photoshop 配置测试、上传图片、去背景或蒙版任务。
    • 普通 Codex 对话、续发消息、任务失败提示。

发布说明建议

推荐发布文案:

本次更新升级了 Codex 工作区交互,新增插件中心和 Photoshop 云端插件,支持供应商/模型快速切换,并优化了输入框、任务日志、文件变更和错误提示体验。后端同步增加插件安装、Photoshop 配置测试、Adobe 云端任务执行和多供应商 Codex 配置写入能力。