update-codex-plugin

更新 Codex 插件

更新现有的公开 Remotion 插件，其标识为 plugins~Plugin_efd07789186881918253a50acfc32762。

• 控制面板：https://platform.openai.com/plugins/manage/plugins~Plugin_efd07789186881918253a50acfc32762
• 公开列表：https://chatgpt.com/plugins/plugins~Plugin_efd07789186881918253a50acfc32762
• 发布源：https://github.com/remotion-dev/codex-plugin

单体仓库的发布流水线会更新此 GitHub 仓库，但不会更新公开目录。codex plugin add 和市场升级管理的是本地安装，而非公开列表。上传时不要使用旧的 packages/codex-plugin 构建目录、openai/plugins 或可移植的 cursor-plugin 软件包。

截至 2026-10-08，OpenAI 文档说明了通过控制面板上传 ZIP 的工作流程，现有 CLI 没有发布到公开目录的命令。此步骤请使用浏览器工具。若有文档记载的发布 API 可用，请优先使用；不要重放控制面板的私有请求，也不要提取浏览器凭据。 当前参考：OpenAI 插件提交。

检查当前发布

使用已登录 OpenAI Platform 的浏览器会话。确认 Remotion 组织和现有插件标识。控制面板中的发布版本具有权威性；本地插件缓存可能落后于该版本。

上传前查看版本选择器和审核状态。如果请求的版本已发布，请报告这一情况。如果该版本的草稿或审核已存在，请继续处理该版本，而不要重复创建。不要仅为了再次上传而取消其他正在进行的审核。

在元数据与技能下选择已发布版本，然后使用更多插件操作 → 下载发布 ZIP。请使用实际下载文件的路径。这是保留列表文本、品牌信息和发布设置的基准。已安装的缓存不能替代已发布的软件包。

准备 ZIP

在单体仓库根目录运行：

python3 .agents/skills/update-codex-plugin/scripts/prepare-release.py \
  --published-zip /absolute/path/to/downloaded-release.zip

默认情况下，辅助程序会解析最新的 Remotion 稳定版 GitHub 发布。若要使用用户指定的版本，请添加 --version 4.0.534。它需要 gh 和 Python 3，会从 remotion-dev/codex-plugin 获取对应的标签、固定其提交，并在检出目录之外创建临时暂存目录和上传 ZIP。它不会发布、安装或修改单体仓库。

辅助程序使用已发布的软件包，并保留已发布的 interface、已分配的 id 和 OpenAI extensions，包括其中引用的列表资源。检查其 JSON 报告，尤其是 preserved_manifest_differences。更新技能时保留这些覆盖项；只有任务包含列表更改时才更改它们。如果源软件包结构发生不兼容的变化，请先调整辅助程序再上传，不要悄悄丢弃组件。

检查报告中的源提交、版本、技能名称和 ZIP 路径。安装好单体仓库依赖项后，使用现有的 Vally 库，从 packages/agent-plugin 对暂存的软件包运行 lint：

bun -e 'import {runLint, LintConsoleReporter} from "@microsoft/vally"; const result = await runLint({rootPath: process.argv[1]}); await new LintConsoleReporter({verbose: true}).report(result); if (!result.passed) process.exit(1);' /absolute/path/to/staged/remotion

@microsoft/vally 是一个库；它不提供 vally CLI。上传前修复实际的打包问题。不要仅为绕过安全检查而更改技能内容。

在浏览器中上传并发布

更新此已发布插件的指令涵盖其常规上传和发布工作流。对于准备 ZIP、创建技能或上传草稿等范围更窄的请求，应按要求处理；这些请求本身并未授权发布。

1. 打开现有插件，然后点击 Upload new version、Upload plugin to make changes 或 Upload plugin to fix issues，以控制面板显示的选项为准。
2. 在 Upload new version 中，保留现有已验证的 Remotion 开发者身份。使用浏览器工具的文件上传 API 选择助手的 ZIP，先阅读该 API 的上传文档。选择文件可能会立即开始上传；请先检查结果，再点击 Upload plugin 或重试。如果 Chrome 扩展上传要求启用 Allow access to file URLs，也可以使用原生文件选择器：通过原生应用工具选择正确的 Chrome 标签页，点击 Choose file，按 Command-Shift-G，读取新的无障碍状态，将路径字段设为 ZIP 的准确路径，按 Return，确认所选文件名，然后点击 Open。不要仅为此备用方案更改扩展权限。
3. 在 Metadata & Skills 下确认新版本。请读取该版本的元数据和技能检查结果，而不是较早的已发布版本。操作后刷新浏览器状态；不要重复使用过期的元素索引。
4. 按照显示的审核工作流操作。先阅读审核结果，再判断它们是否会阻止提交。技能可能显示 Needs attention，而版本显示 Approved 和 Ready to publish；仅有警告并不能证明审核未通过。如果需要新的 ZIP，请修复暂存包并重新创建，同时保留该版本的来源记录。不要为了重试待处理的扫描而反复上传同一个 ZIP。
5. 当请求的版本已获批准且发布已获授权时，选择 Publish plugin。如果政策确认事项包括接受法律条款，请先通过当前浏览器工具取得所需确认，再接受条款。不得声称执行过未执行的测试，也不得捏造审核信息。
6. 确认 Publication Version 显示目标版本为 Published。已选中的草稿、成功上传、批准或 GitHub 标签都不能证明已发布。使用当前工具支持的方式保存浏览器证据。

扫描和人工审核可能会持续到当前轮次之后。请报告准确的版本、状态、审核结果和控制面板 URL；保留控制面板可供后续操作。仅在用户要求时才安排定时跟进。上传结果不确定时，请先检查版本列表，再重试。

结束时说明已准备或已发布的版本、源代码提交、验证结果，以及控制面板中尚待完成的步骤。明确区分 已准备、已上传、审核中、已批准和已发布。