本次更新围绕 AI 短剧创作流程、专业 Agent 制作体系、角色库与场景库、模型配置、积分展示、图片任务同步和整体创作体验进行升级，让用户在创建短剧、生成角色形象、制作场景图、拆解分镜和批量生成素材时获得更统一、更专业、更清晰的体验。

更新说明

更新时间：2026-05-23

本次更新围绕 AI 短剧创作流程、专业 Agent 制作体系、角色库与场景库、模型配置、积分展示、图片任务同步和整体创作体验进行升级，让用户在创建短剧、生成角色形象、制作场景图、拆解分镜和批量生成素材时获得更统一、更专业、更清晰的体验。

AI 短剧创作流程

• 短剧创建流程已根据用户选择的类型和风格进行统一约束。
• 剧本、角色、场景、分镜、图片和视频制作会围绕同一项目风格保持一致。
• 用户选择 3D 动画、动漫、漫剧等不同风格后，系统会使用对应方向的专业制作要求。
• 剧本内容、角色形象、场景画面和分镜脚本会共同遵循项目风格，减少风格漂移。
• 下一步流程保持在新版短剧创作页面中完成，流程衔接更加连贯。

专业 Agent 能力

• 短剧制作流程接入更专业的 Agent 制作约束。
• 剧本改写新增“Agent 改写”入口，用户可以输入原始想法或文本，由 Agent 根据所选类型和风格改写成更专业的短剧剧本。
• 剧本改写会按照资深导演级创作标准组织剧情、节奏、人物行动、情绪推进和画面表达。
• 分镜提取升级为商业级分镜制作方向，根据用户选择的短剧类型和风格输出匹配的分镜脚本。
• 分镜脚本会服务于后续图片、视频、配音、音效和合成流程，便于直接进入制作阶段。

角色库与场景库

• 角色库定位为用户自己的公共角色素材库。
• 新增角色库素材时不再要求绑定剧本。
• 场景库定位为用户自己的公共场景素材库。
• 新增场景库素材时不再要求绑定剧本。
• 用户上传到角色库和场景库的图片，可以在创建短剧、选择角色图或选择场景图时复用。
• 角色库和场景库的新增弹框与短剧创作中的新增角色、场景弹框保持一致，包括尺寸、布局和交互体验。

角色与场景生成

• “一键生成形象”会结合剧本中的角色描述和项目风格类型生成。
• 角色图片生成会遵循角色身份、外貌、服装、气质和剧情设定。
• 场景图片生成会遵循剧本场景描述、时代环境、空间氛围和项目风格。
• 角色图、场景图和分镜图之间会保持统一的风格方向。

分镜素材生成

• 分镜图片生成支持按用户选择的素材类型执行。
• 用户选择关键帧、首帧、尾帧或动作序列时，系统会按所选类型生成对应素材。
• 批量生成会为分镜脚本批量创建生成任务。
• 生成中的任务会在界面展示生成状态。
• 生成完成后，素材会回填到对应分镜卡片中。
• 已有角色图和场景图会作为分镜素材制作的重要参考，帮助分镜画面延续角色与场景一致性。

图片任务同步

• 图片任务列表会同步平台任务状态。
• 平台侧完成的图片任务会自动下载图片并写入本地任务记录。
• 分镜关键帧完成后会回填到对应分镜脚本卡片。
• 任务状态会根据平台结果展示为进行中、已完成或失败。
• APIMart 图片尺寸会自动处理为平台支持的规格，提升图片任务提交兼容性。

模型与供应商配置

• OpenAI 兼容类型和 Google 相关供应商支持填写 Base URL。
• 其他供应商保持固定平台配置，减少用户误填中转地址带来的使用偏差。
• 图片、视频、音频、文本模型选择继续按用户配置和平台模型统一展示。
• 生成流程会根据当前选择的模型和配置动态计算展示信息。

积分展示与消耗预估

• 顶部积分展示使用当前登录用户的真实总积分。
• 短剧页面会从用户信息接口读取积分余额。
• 图片生成消耗会根据所选模型、分辨率和生成数量动态计算。
• 使用用户自有 API 模型时，不展示平台积分消耗。
• 使用平台或官网模型时，会按照后台配置的模型计费规则展示预计消耗。
• 批量生成会根据需要生成的图片总数和分辨率计算预计积分。

页面体验

• 顶部任务入口、积分展示和操作按钮布局进行了整理。
• 任务入口在不同宽度下保持清晰展示。
• 图片生成、批量生成、任务状态和素材回填的界面反馈更加明确。
• 加载状态和按钮状态保持一致，用户可以清楚看到当前正在执行的制作流程。

验证情况

• 后端类型检查已通过。
• 图片任务同步已通过本地接口验证。
• 分镜关键帧任务已完成回填验证。
• 任务列表状态展示已完成验证。

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

更新摘要

本次更新重点优化了 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 配置写入能力。