v0.11.1 — 图片预览、MCP 指引与连接修复

v0.11.1

简体中文

• 修复 Codex 生图成功后聊天面板不显示图片的问题，支持内联预览、点击放大和历史会话重开。
• 补齐外部 MCP 客户端的操作指引：直接发现实例、绑定工程、读取技能和验证结果。
• 减少工具库候选较多时的重复扫描，保留逐项校验和现有保留上限。
• 修复 Windows AE 进程识别失败后工程占用无法可靠释放的问题。自动重试三次，仍失败时可在原面板点击“再试连接”；AE 运行时保持占用，确认退出后释放。

已有 0.11.0 用户只需手动更新 ZXP。 Windows AEX 和 macOS arm64 原生插件没有变化，本次沿用 0.11.0 的原始文件，不需要重新安装。npm 连接器继续使用 ae-mcp-jkdg@0.11.0。

English

• Fix missing native Codex image output in panel chat, including inline preview, zoom and reopened conversation history.
• Align external MCP guidance for direct instance discovery, workspace binding, skills and result verification.
• Reduce repeated Tool Library index reads while retaining artifact validation and existing retention limits.
• Fix missing Windows AE process identity that could leave project ownership stuck. PID discovery retries three times; Retry connection retries in the same panel. Live AE processes retain ownership, and confirmed exit releases it.

Existing 0.11.0 users only need to update the ZXP manually. The Windows AEX and macOS arm64 native plug-in are reused byte-for-byte from 0.11.0; no native reinstall is required. The npm connector remains ae-mcp-jkdg@0.11.0.

下载与验证说明 / Downloads and validation

• ae-mcp-panel-v0.11.1.zxp: signed CEP panel and MCP host; includes the pinned Windows OpenCode runtime.
• AeMcpNative-v0.11.0-windows-x64.aex: unchanged Windows x64 native asset.
• AeMcpNative-v0.11.0-macos-arm64.plugin.zip: unchanged macOS arm64 native asset.
• SHA256SUMS-v0.11.1.txt: checksums for all three program assets.

ZXP 沿用现有自签名证书，无 TSA 时间戳。Windows AEX 保留原有未做 Authenticode 签名的状态；Mac 原生包沿用 ad-hoc 签名，未做 Developer ID 签名或公证。原生资产来源及原有验证范围见 v0.11.0。

The ZXP retains the existing self-signed certificate without a TSA timestamp. The reused Windows AEX remains unsigned by Authenticode; the Mac native bundle retains its ad-hoc signature without Developer ID signing or notarization. See v0.11.0 for native provenance and previous validation limits.

Windows AE 26.5x89 / CEP 12.0.1：最终签名包完成 13 项改动回归（78 次公开 MCP 调用及一次真实 Codex 生图），包括直接编辑/读回/预览/真实 Undo、只读拒写、工具库候选、图片历史与缩放、面板生命周期及 PID 失败重试。完成 0.11.0 基线、升级、回滚和 0.11.1 干净文件安装检查，每站 720 个安装文件与对应签名包一致。三个 CI 检查全部通过。

On Windows AE 26.5x89 / CEP 12.0.1, the final signed package passed 13 changed-capability cases (78 public MCP calls and one real Codex image generation), including direct edit/readback/preview/real Undo, read-only refusal, Tool Library candidates, image history/zoom, panel lifecycle and PID recovery. The 0.11.0 baseline, upgrade, rollback and clean 0.11.1 file installation passed; each station matched all 720 installed files to its signed package. All three CI checks passed.

Windows 的本次实机结果不代表新的 macOS 面板实机验收。macOS 打包契约 CI 通过；复用的 Mac 原生文件与上版完全一致，本次没有重新构建或宣称扩展 AE/OS 支持范围。安装检查保留已有用户配置，不等于全新用户配置验收。

This release's Windows hardware results do not establish new macOS panel hardware coverage. The macOS packaging-contract CI passed; the reused Mac native file is identical to the previous release. No new AE/OS support is claimed. Installation checks preserve the existing user profile and are not fresh-profile acceptance.

AE 原生启动提示可能需要用户或 Computer Use 处理；不提供自动更新。#406 中的保留策略控制和配方执行未包含。依赖审计未清零，既有依赖及适用性评估见 发布准备记录。

Native AE startup prompts may require the user or Computer Use. Updates remain manual. Retention controls and recipe execution from #406 are not included. Dependency audit findings remain documented in the release-preparation record.

合并 / Merged: #409, #410, #411, #412, #413.

Source: 10b0154ca64f5ed15096b367f160129ee9ffe503. The signed payload was built from 23647e8701ccfc4ab419f4e1a0ae55886c2bbbc8, whose Git tree is identical to the release source. Assets are published without rebuilding or re-signing after acceptance.

v0.11.0 — 多实例、会话接管与 Undo 修复

v0.11.0

简体中文 | English

简体中文

1. MCP 连接器更新：外部 Agent 客户端现在可以同时拉起多个 AE 实例，对单个工程进行并行预览，或对多个工程同时预览和操作。同一工程的写入操作仍会串行执行。
2. 新增工作目录选项：用户可以指定 AI 的工作目录，避免工程经常被保存到 ~/Codex 目录。
3. 集中修复了一大批撤销组不匹配的问题。
4. 修复了原生插件懒加载的问题。
5. 修复了一批其他 Bug。

English

1. MCP connector update: external agent clients can now launch multiple AE instances for parallel previews of a single project, or concurrent previews and operations across multiple projects. Writes to the same project remain serialized.
2. New working directory option: users can choose the AI's working directory to help avoid projects repeatedly ending up in ~/Codex.
3. Fixed a wide range of Undo group mismatch issues.
4. Fixed the native plug-in's lazy-loading issue.
5. Fixed various other bugs.

下载与验证说明 / Downloads and verification details

中文说明

相关合并：#393、#396、#398、#399、#400。包含 #397 修复；#392 保留给原报告者确认。

下载与安装

• ae-mcp-panel-v0.11.0.zxp：签名 CEP 面板与 MCP host，内含 Windows OpenCode runtime。
• AeMcpNative-v0.11.0-windows-x64.aex：Windows x64 原生插件，需独立安装，不包含在 ZXP 内。
• AeMcpNative-v0.11.0-macos-arm64.plugin.zip：macOS arm64 原生插件，独立解压安装。
• SHA256SUMS-v0.11.0.txt：上述程序文件的 SHA-256 校验值。

安装方法见安装指南。stdio 连接器配套版本为 ae-mcp-jkdg@0.11.0；面板必须保持打开。

ZXP 沿用现有自签名证书，不含 TSA 时间戳；AEX 未做 Authenticode 签名。两份 Windows 程序文件与维护者手测的 C3 候选包完全一致，发布时未重建或重新签名。

验证范围与已知边界

• Windows AE 26.5x89：最终包完成选定的 24 项核心回归、真实原生写入及 GUI Undo、外接会话交接、双 worker 正常任务与运行中取消。渲染检查产生 50 帧 PSD；实际使用 Advanced 3D，不据合成名称推断其他渲染器覆盖。
• 完成 0.10.8 基线、升级到 0.11.0、回滚到 0.10.8、0.11.0 干净文件安装四站验证；720 个安装文件匹配最终 ZXP，冷启动首次原生诊断通过。保留已有用户状态，不代表全新用户环境安装。
• 维护者手测后批准发布。自动验收未完成“实际选择中文目录”和“worker 运行中关闭并重开面板”；保留未验证状态，不以开发版结果替代最终包实测。此前 Codex／OpenCode 正常回合与 Stop 有候选包实测；Claude 按维护者决定仅做代码及契约验证，后续以用户反馈补充。
• Windows 与 macOS arm64 原生资产均已提供。Mac 最终包完成下述指定实机与安装检查；资源受限的 Mac worker 场景仍等待公测，不计为通过。
• 同步 ExtendScript 的超时不能保证立即中断；静态守卫不覆盖任意动态 JSX。Guide 图层可能不出现在 PNG 预览中。
• Overlord 曾导致第二主实例退出卡住；约 350px 的窄面板可能遮挡 Stop，建议拉宽后操作。
• 依赖保留既有版本；已知依赖审计告警按当前本机单用户调用路径评估，相关触发配置未启用，不宣称依赖审计清零。

构建源码：50856219e09a78ede3b30c34b3e3046d1bcf9f4e。

English details

Merged work: #393, #396, #398, #399 and #400. Includes the fix for #397; #392 remains open for confirmation from the original reporter.

Downloads and installation

• ae-mcp-panel-v0.11.0.zxp: signed CEP panel and MCP host, including the Windows OpenCode runtime.
• AeMcpNative-v0.11.0-windows-x64.aex: Windows x64 native plug-in. Install it separately; it is not embedded in the ZXP.
• AeMcpNative-v0.11.0-macos-arm64.plugin.zip: macOS arm64 native plug-in, installed separately from the extracted ZIP.
• SHA256SUMS-v0.11.0.txt: SHA-256 checksums for the program assets above.

Follow the installation guide. The matching stdio connector is ae-mcp-jkdg@0.11.0. Keep the AE panel open while using MCP.

The ZXP uses the existing self-signed certificate without a TSA timestamp. The AEX is not Authenticode-signed. Both Windows program files are byte-identical to the maintainer-tested C3 candidate; they were not rebuilt or signed again for publication.

Verification scope and known limitations

• On Windows AE 26.5x89, the final package passed 24 selected core regression cases, actual native writes with GUI Undo, external-session handoff, and normal and in-flight cancellation paths with two workers. Rendering produced 50 PSD frames using Advanced 3D; composition names do not establish coverage of other renderers.
• Four installation stations passed: the 0.10.8 baseline, upgrade to 0.11.0, rollback to 0.10.8, and clean file installation of 0.11.0. All 720 installed files matched the final ZXP, and the first native diagnosis after a cold start passed. Existing user state was preserved; this does not establish installation in a fresh user profile.
• The maintainer approved publication after manual testing. Automated acceptance did not complete selecting a Chinese-named directory or closing and reopening the panel while workers were active. These remain unverified; development results are not substituted for final-package observations. Earlier candidate testing covered Codex/OpenCode normal completion and Stop. By the maintainer's decision, Claude coverage is limited to code and contract checks, with further hardware coverage awaiting user feedback.
• Windows and macOS arm64 native assets are available. The final Mac package completed the scoped hardware and installation checks below; resource-blocked Mac worker scenarios still await public beta testing and are not marked passed.
• A timeout cannot guarantee immediate interruption of synchronous ExtendScript, and static guards do not cover arbitrary dynamic JSX. Guide layers may be absent from PNG previews.
• Overlord has previously prevented a second primary instance from exiting. A narrow panel of around 350px may obscure Stop; widen the panel before using it.
• Existing dependency versions are retained. Known dependency audit findings were assessed against the supported local, single-user call paths, where the relevant trigger configurations are not enabled. This is not a claim of a clean dependency audit.

Build source: 50856219e09a78ede3b30c34b3e3046d1bcf9f4e.

macOS 原生资产补充 / macOS native asset supplement

简体中文

• AeMcpNative-v0.11.0-macos-arm64.plugin.zip：632,683 字节；macOS arm64，声明最低 macOS 14.0。配合上方同一签名 ZXP 使用，无额外 Mac OpenCode runtime。
• 从正式源码 50856219e09a78ede3b30c34b3e3046d1bcf9f4e、锁定 Adobe SDK 26.5 重新构建；沿用 ad-hoc 签名，未做 Developer ID 签名或公证。结构、入口/PiPL、版本、严格签名及 ZIP 解压完整性通过。
• AE 26.3x87 arm64 实测：首次原生诊断及读取、公开 MCP 分组写入与真实菜单 Undo 独立读回、render/evalFile/嵌套撤销组拒绝、2D 与摄像机/3D 单帧渲染、checkpoint 恢复、默认目录与原生中文空格目录选择/取消/恢复默认。完成从原 0.10.8 升级、回滚完整性检查和 0.11.0 干净文件安装后的加载/读取/Undo；原组件已恢复。
• 使用现有用户环境及权限，保留账户、配置与聊天；不是全新用户配置或浏览器下载 quarantine/Gatekeeper 信任验收。未测试 AE23、Mac worker、真实 unknown/reconcile、全部 provider/归档会话分支或所有 AE/OS 版本；不以旧开发证据填补。Claude 继续沿用代码/契约验证边界。
• SHA-256：f41a0c0bd8623d1ffe85feb8346627b432baaaa6c0467c149afe65f204986777。校验清单已追加 Mac 项，原 ZXP 与 Windows AEX 字节未变。

English

• AeMcpNative-v0.11.0-macos-arm64.plugin.zip: 632,683 bytes; macOS arm64, with a declared minimum of macOS 14.0. Use it with the same signed ZXP above; no additional Mac OpenCode runtime is included.
• Rebuilt from official source 50856219e09a78ede3b30c34b3e3046d1bcf9f4e with the locked Adobe SDK 26.5. Uses the existing ad-hoc signing approach, without Developer ID signing or notarization. Structure, entry point/PiPL, version, strict signature and ZIP extraction integrity checks passed.
• Tested on AE 26.3x87 arm64: first native diagnosis/read, public MCP grouped edits with real menu Undo and independent readback, render/evalFile/nested-Undo rejection, single-frame 2D and camera/3D renders, checkpoint restoration, default working directories, and native selection/cancel/reset of a directory containing Chinese characters and spaces. Upgrade from the original 0.10.8, rollback integrity, and loading/reading/Undo after a clean file installation of 0.11.0 were checked; original components were restored.
• Tests used the existing user environment and permissions, preserving accounts, configuration and chats. This does not establish a fresh-profile installation or browser-download quarantine/Gatekeeper trust acceptance. AE23, Mac workers, real unknown/reconcile, all provider/archive-session branches and all AE/OS versions remain untested; older development evidence is not substituted. Claude retains its code/contract-only coverage boundary.
• SHA-256: f41a0c0bd8623d1ffe85feb8346627b432baaaa6c0467c149afe65f204986777. The checksum list now includes the Mac entry; the original ZXP and Windows AEX bytes are unchanged.

v0.10.8

v0.10.8

• 聊天附件粘贴：复制文件或截图后可在聊天输入区粘贴。新增“设置 → 通用 → 剪贴板附件粘贴”开关，关闭后仍可粘贴文字、拖放和选择文件。
• 模型列表滚动：菜单最高占面板可视高度的 60%，并根据实际空余空间收缩；全部模型保留在内部滚动列表中。
• 安装提示词适配当前客户端：中英文提示词先检查本机文件、版本和 MCP 注册，只补缺失项，有新版时升级，保留已有设置，不再默认配置 Claude Code。
• 新模型与默认值：Claude 加入并默认 Opus 5.5；Codex 加入 GPT-6 Sol/Luna，默认优先 GPT-6 Astra。既有用户选择保留，实际可用模型以所选 CLI 的实时目录为准。

修复 #388、#389、#390；合并 PR #391。

下载与安装

• ae-mcp-panel-v0.10.8.zxp：签名 CEP 面板与 MCP host，内含 Windows OpenCode 1.18.23。
• AeMcpNative-v0.10.8-windows-x64.aex：Windows x64 原生插件，独立安装。
• SHA256SUMS-v0.10.8.txt：Windows 与 macOS 资产的 SHA-256。

已补充 macOS arm64 原生插件；macOS 原生插件已完成下述范围内的实机验证；完整 macOS 新功能矩阵尚未完成，不声明全产品 macOS release-accepted。npm 连接器维持 ae-mcp-jkdg@0.10.4，继续与产品 0.10.x 配对。

使用注意

• Opus 5.5 需要 Claude Code 2.1.280 或更新版本。该模型本次未完成成功调用实测，已保留最低版本检查；发布负责人批准暂缓该项。
• Codex 的旧 CLI 可能不列出 Sol/Luna；本机 0.155.0 已验证可用。面板不会用静态名称覆盖实时目录，也不会自动升级 CLI。
• TMC Clipboard 等插件可能抢先处理 Ctrl+V 并把文件导入 AE 项目。 本机停用 TMC 后标准粘贴已由维护者验证通过。遇到冲突可关闭面板附件粘贴，改用拖放或“添加文件”；该开关不会禁用第三方插件自身的导入行为。不增加备用热键。

验证范围

• 独立差异评审无阻塞；本地完整回归 1099 通过、93 按平台或条件跳过、0 失败。
• PR 与版本标签的 Windows、CEP Node 15、macOS 包装契约 CI 均通过。
• 维护者确认开发候选在真实 AE 中的附件粘贴、设置开关和模型列表通过；安装提示词按内容覆盖验收，不要求实际改写客户端配置。
• 最终 Windows 签名包完成 0.10.7 基线、升级至 0.10.8、回退至 0.10.7、0.10.8 干净文件安装四站检查，保留用户设置及会话。每站 706 个安装文件（包含签名元数据）与对应签名包一致，无调试配置；公开 ae_status、ae_read、ae_nativeExec 均成功。
• 最终原生调用返回产品版本 0.10.8、合并来源提交及已验证后置条件；没有写入或保存测试工程。一次退出操作未结束 AE，确认应用健康后经菜单正常退出再继续，未修改候选资产。
• 后台 Astra/Sol 的图片读取和 AE 只读调用通过；Luna 通道及工具调用通过，但一次图片数字漏读仍保留为质量观察。以上开发模型检查不冒充 Opus 的成功调用或完整模型质量保证。最终包的额外设置页复查因另一工程进入 AE 而停止，未计为通过；四站只读安装验证已在此前完成。

ZXP 沿用上一版同一自签名证书，不含 TSA 时间戳。构建来源：bcab87a。

macOS 原生资产补充

• AeMcpNative-v0.10.8-macos-arm64.plugin.zip：Apple Silicon 原生插件，解压后独立安装 AeMcpNative.plugin；最低 macOS 14。
• 从 v0.10.8 标签对应的 bcab87a0ec96b4409636ba6dd3ae5fb3f25d17c7 干净源码重新构建，产品版本 0.10.8。
• 26 项构建/版本契约测试通过；SDK 输入、包结构、arm64 架构、导出入口、PiPL、ad-hoc 签名及 ZIP 解压后的完整性验证通过。此资产未做 Developer ID 签名或公证。
• SHA256SUMS-v0.10.8.txt 已加入 macOS ZIP 校验值。现有 ZXP 仍内含 Windows OpenCode；此次原生插件与安装路径的实机验证见下文；不代表完整 macOS 面板功能矩阵或全产品 T5/T6 验收完成。

macOS 实机验证补充（2026-09-23）

• Apple Silicon / After Effects 26.3x87，直接使用此 Release 的 ZXP 与 macOS ZIP，下载 SHA-256 与安装后逐文件完整性均通过。每站 706 个面板文件、5 个原生 bundle 文件匹配对应安装源，最终 ad-hoc 签名验证通过。
• 0.10.7 基线、升级至 0.10.8、回退至 0.10.7、0.10.8 干净文件安装四站的公开 ae_status、ae_read、ae_nativeExec 均成功；保留现有用户状态，未将该结果解释为全新用户环境安装。
• 原生工程/合成/图层定位器、精确有理数时间和合成设置读取通过；返回版本 0.10.8、来源提交 bcab87a0ec96b4409636ba6dd3ae5fb3f25d17c7、wire v1、SDK 25.6.61，后置条件和审计证据完整。
• 唯一临时合成时长通过原生调用从 4 秒改为 6 秒，JSX 独立读回为 6 秒；经 AE 编辑菜单真实 Undo 后，JSX 与重新解析定位器的原生读取均确认时长和工作区域恢复到 4 秒。
• 共 22 次成功公开工具调用。另有 1 次预检参数错误在派发前被拒绝，更正后通过；文件打开对话框快捷键未生效后改用 AE“最近打开”完成工程重开，未修改候选资产。
• 临时工程创建 1、归档 1、长期保留 0、未分类 0；未打开或改写生产工程。最终保留 0.10.8 安装与空白工程。
• 验证范围为发布包原生功能、实际加载及安装/回退路径；未覆盖全部 macOS 面板新功能、模型调用或 OpenCode runtime，因此不声明完整 macOS release-accepted。Developer ID 签名、公证状态不变。

v0.10.7 — Panel previews and attachment recovery (Windows)

v0.10.7

本次完成六项面板体验改进：

• 自动检查稳定 Release；显示可关闭的新版本横幅，设置中可手动检查并打开发布页。
• 聊天工具卡片直接显示 Codex / Claude 返回的 preview 图片，可放大、切换帧并从历史会话恢复。
• 修复多媒体附件 MIME / 自定义模型模态误报，切换通道保留草稿；未派发的明确格式拒绝可修改重试，不确定结果仍保留防重发保护。
• Codex 使用实时模型目录，账号提供 GPT-6 Astra 时优先采用其能力；保留每个通道的模型偏好。
• 显示所选 CLI 的实际版本与对应更新提示，不自动安装或升级。
• 工具面板的脚本、参数和结果在文字区域内滚动，常用按钮保持可见；移除无效的专家指导开关，默认宿主指引和内置 Skill 保留。

PR：#373、#375、#377、#381、#382、#383；版本准备 #384，Windows 验收修复 #385、#386。

下载

• ae-mcp-panel-v0.10.7.zxp：CEP 面板与 MCP host，内含 Windows OpenCode 1.18.23。
• AeMcpNative-v0.10.7-windows-x64.aex：Windows x64 原生插件，独立安装。
• SHA256SUMS-v0.10.7.txt：上述资产的 SHA-256。

macOS arm64 原生资产已补充；macOS 实机验证尚未完成，本次不声明 macOS release-accepted。npm 连接器维持 ae-mcp-jkdg@0.10.4，与 0.10.x 产品配对。

支持范围

• 本版 preview 图像验收范围为 Codex / Claude。OpenCode preview 调用存在未解决的互斥参数冲突，暂不列入支持范围；这不影响 OpenCode 图片附件输入。
• 对输入通道明确拒绝的 WAV / MP4，本版提供准确的通道限制提示和草稿恢复，不将拒绝误报为模型本身没有多模态能力。
• ZXP 沿用现有自签名证书，不含 TSA 时间戳。原生 AEX 按现有独立资产流程构建。

Windows 验收修复

• 规范化 CEP 扩展目录，确保自动启动包内 OpenCode 1.18.23。
• 切回 OpenCode 时等待会话重置完成后再探测，避免启动被自身重置取消。
• 图片放大预览打开时注册 CEP Escape 按键，关闭后清理注册并恢复焦点。
• OpenCode 明确拒绝附件后，用户编辑草稿重试时从失败消息前保留上下文，避免被拒绝的附件继续污染后续请求，并保留所选模型。

最终 Windows 签名候选已达到 release-accepted：After Effects 2026（26.3x87）上整合验收 10/10 通过；0.10.6 基线、升级到 0.10.7、回退到 0.10.6、干净安装 0.10.7 四站均通过。公开 MCP 验收共 36 次，35 次直接通过，1 次只读端点发现失败在清理已退出测试进程的残留后单次复验通过。真实写入、独立读回和原生 Undo 恢复均已验证。

704 个安装文件与签名包完全一致，最终无临时调试配置。原有 50 条会话未变，3 条测试会话已归档，20 项偏好恢复后仅正常版本检查缓存自动刷新；唯一临时工程已转入短期恢复目录。

已知限制：跨通道切换后，部分历史记录的模型标签可能与当前选择不一致；这是 0.10.6 已存在的显示元数据问题，本轮实际模型请求、上下文和草稿恢复验收通过。测试还遇到同机既有 AE 退出挂起，恢复后完成了最终启动及接口复验；不将此记录为无异常首次通过。

构建来源：a8f5e61。

macOS 原生资产补充

• AeMcpNative-v0.10.7-macos-arm64.plugin.zip：Apple Silicon 原生插件，解压后独立安装 AeMcpNative.plugin；最低 macOS 14。
• 从 v0.10.7 标签对应的 a8f5e616f091a9ff56e3e5341ff9515284c002a7 干净源码重新构建，产品版本 0.10.7。
• 26 项构建/版本契约测试通过；包结构、arm64 架构、导出入口、PiPL 和 ad-hoc 签名验证通过。此资产未做 Developer ID 签名或公证。
• SHA256SUMS-v0.10.7.txt 已加入 macOS ZIP 校验值。现有 ZXP 仍内含 Windows OpenCode；此次仅补充原生插件，不代表 macOS 面板整包、T5/T6 或实机验收完成。

v0.10.6

让 AI 操控 After Effects 更稳、更顺、更省心 / Making AI-driven After Effects more reliable, smoother, and worry-free.

本版是 2026-09-02 全仓体检后的修复批：11 条 PR 覆盖 7 条 issue，全部附真机验收记录。
This release lands the 2026-09-02 full-repo review batch: 11 PRs across 7 issues, each with real-machine verification notes.

中文亮点

• ae_previewFrame 在 16 bpc 工程上可用，不再撞 Claude Code 的 16 MB 单事件上限（#352）——宿主解码 16-bit PNG，预览一律回传 8-bit；每次响应受 12 MiB 总量 / 4.5 MiB 单图预算约束，超限自动缩帧，装不下则返回路径加缩略图；旧的临时帧自动清理。
• Tool Library 密钥扫描不再误伤普通脚本（#353）——var key = prop.keyTime(1) 这类赋值不再被判为凭证；坏的 legacy skill 文件跳过并记日志，不再拖垮 ae_toolSearch。
• 宿主生命周期与恢复安全（#354）——改端口重启不再被在线 MCP 客户端卡死；恢复脚本先审批后写；ae_nativeExec 真正享有 30 秒时限且迟到应答不再断线；MCP 会话封顶 64 条；协议版本从 initialize 协商；Windows 原生管道读取不再丢字节，端点文件原子发布并在启动时清理损坏残留（原生插件已随本版重建）。
• 会话与模型选择（#355）——模型偏好按通道各存一份，作曲区芯片选的模型成为该通道默认；旧版 Claude Code 选 Fable 5.1 会得到明确的升级提示；跨后端打开历史会话不再被清空；OpenCode 收尾有超时、传输重建不再重放整轮。
• 中文版 AE 的报错不再乱码（#356）；模型清单换代——Claude 默认 Opus 5，提供 Fable 5.1 / Sonnet 5 / Haiku 4.5；Codex 默认 gpt-5.6-sol（#357）。
• 内置 Skill 第一轮迭代（#335）——cookbook 新增 5 条来自真实会话的条目，8 条触发文案统一，使用次数持久化。
• 工程卫生（#358）——CI 目录级跑齐 scripts 契约测试；删除腐烂测试、死发版脚本、死 workflow、遗留 Python 与零引用截图；打包时重算 opencode.exe 的 SHA-256。

English highlights

• ae_previewFrame works on 16 bpc projects and stays under Claude Code's 16 MB event cap (#352) — 16-bit PNG decoding, always-8-bit previews, a 12 MiB total / 4.5 MiB per-image budget with automatic downscaling, path + thumbnail as the last resort, stale temp frames pruned.
• Tool Library secret scanning no longer rejects ordinary scripts (#353); unreadable legacy skill files are skipped with a host-log warning.
• Host lifecycle and recovery safety (#354) — port restarts no longer hang behind live MCP streams; recovery scripts are written only after approval; ae_nativeExec gets its full 30 s window; MCP sessions capped at 64; protocol negotiated from initialize; Windows native IPC keeps bytes across cancellation races and publishes endpoint descriptors atomically (the native plug-in is rebuilt in this release).
• Sessions and model choice (#355) — per-channel model preferences, the composer chip becomes the channel default, a clear upgrade hint when an old Claude Code is asked for Fable 5.1, cross-backend session opens survive the probe, bounded OpenCode finalization, no replay after a transport rebuild.
• Localized AE errors arrive readable (#356); current-generation model catalogs — Claude defaults to Opus 5 with Fable 5.1 / Sonnet 5 / Haiku 4.5, Codex defaults to gpt-5.6-sol (#357).
• Bundled skills, round one (#335) and repository hygiene (#358).

完整变更见 / Full changelog: CHANGELOG.md

安装 / Install

• 面板 ZXP：ae-mcp-panel-v0.10.6.zxp（Windows x64，内置 OpenCode v1.18.23）。
• 原生插件 Windows：AeMcpNative-v0.10.6-windows-x64.aex（本版重建，含 #354 的原生修复；从发布提交干净构建，receipt 见资产内嵌版本信息）。
• 原生插件 macOS：AeMcpNative-v0.10.6-macos-arm64.plugin.zip —— 占位，待补。 macOS 产物将由 owner 稍后上传到本 release，届时同步更新 SHA256SUMS-v0.10.6.txt；在此之前 macOS 用户请沿用 v0.10.5 附带的 AeMcpNative-v0.10.0-macos-arm64.plugin.zip（原生面在 macOS 侧未变）。
• 校验 / Verify：SHA256SUMS-v0.10.6.txt（目前只含 Windows 两件）。
• 接入 / Connect：claude mcp add --transport http ae http://127.0.0.1:11488/mcp，stdio 客户端用 npx -y ae-mcp-jkdg。详见 docs/INSTALL.md。

已知事项 / Known notes：ZXP 为自签名证书、本机 TSA 不可用故无时间戳；真机验收在 AE 2026（Windows）上逐 PR 完成（见各 PR 评论），AE 2025 已装新原生插件但未单独启动验证；npm 连接器 ae-mcp-jkdg 按 major.minor 配对保持 0.10.4，无需更新。

v0.10.5

让 AI 操控 After Effects 更稳、更顺、更省心 / Making AI-driven After Effects more reliable, smoother, and worry-free.

中文亮点

• 成功脚本自动留底,压缩后一键重跑(#338)——ae_exec 成功即入库为 candidate,信封带 artifactId;占位符守卫直接列出可重跑条目与 ae_toolUse 用法,还配了断路器与遥测(#339),连环撞墙成为历史。
• Tool Library 全生命周期(#344/#340/#341/#342)——新写动词 ae_toolSave(沉淀/新建/更新/状态,工具面 12→13);用户 prompt-skill 统一进库;导出/导入(防篡改+防重)与「工具」页管理界面;useCount/lastUsedAt 使用度量与漏斗遥测。
• 测试不再读写真实 ~/.ae-mcp(#330)——状态目录经可注入 AE_MCP_STATE_DIR 统一解析。
• OpenCode 不再抱死重启前的连接(#333)——宿主代次门自动回收重建,-32000 自动重试一次。
• 「文档 / GitHub」按钮真的能打开了(#334);全量文档更新与 42 份过时文档归档(#343),新增 docs/TOOL_LIBRARY.md 开发者指南。

English highlights

• Successful scripts are captured and rerunnable after context compaction (#338) — candidates with envelope artifactId, guard-listed reruns via ae_toolUse, plus a circuit breaker and telemetry (#339).
• Full Tool Library lifecycle (#344/#340/#341/#342) — the ae_toolSave write verb (12→13 tools), user prompt-skills unified into the library, tamper-checked export/import with a Tools-screen manager, and useCount/lastUsedAt usage metering with funnel telemetry.
• Tests no longer touch your real ~/.ae-mcp (#330); OpenCode recovers from host restarts automatically (#333); the Docs/GitHub buttons actually open (#334); full docs refresh with a new docs/TOOL_LIBRARY.md developer guide and 42 stale docs archived (#343).

完整变更见 / Full changelog: CHANGELOG.md

安装 / Install

• 面板 ZXP:ae-mcp-panel-v0.10.5.zxp(Windows x64,内置 OpenCode v1.18.23);
• 原生插件沿用 v0.10.0(冻结面,哈希未变):AeMcpNative-v0.10.0-windows-x64.aex / AeMcpNative-v0.10.0-macos-arm64.plugin.zip;
• 校验 / Verify:SHA256SUMS-v0.10.5.txt;
• 接入 / Connect:claude mcp add --transport http ae http://127.0.0.1:11488/mcp,stdio 客户端用 npx -y ae-mcp-jkdg。详见 docs/INSTALL.md。

已知事项 / Known notes:ZXP 为自签名证书、本机 TSA 不可用故无时间戳;AE 2025/2026 Windows 真机验收随开发逐波完成(见各 PR 真机评论),统一真机回归由 owner 侧执行。

v0.10.3 — 零终端开箱:内置 OpenCode、一键登录与安装 / Zero-terminal setup

零终端开箱 + 更结实的执行回路 / Zero-terminal setup and a sturdier exec loop.

中文

• ZXP 内置 OpenCode(#321)——全新安装开箱即有可用通道:Windows 包随附经 SHA-256 校验的官方 OpenCode(v1.18.23),面板自动优先内置版;正式构建缺产物直接失败。
• 登录与安装不再需要终端——Claude「打开登录窗口」+ 自动刷新;Codex 一键登录(隔离环境代跑、自动开浏览器);向导一键代跑 Claude 官方安装器;可选「加入系统 PATH」;全新安装默认 OpenCode Provider 通道。
• AI 回复不再被工具卡撕裂(#322)——插卡前先完整落屏已生成文字,修复拆词与"答完题文字才冒出来"。
• AE 开着也能装好 CLI(#321)——重新检测重读注册表 PATH 并认识官方安装位置,无需重启 AE。
• exec 反馈回路四重修复(#323)——历史脱敏占位符绊线(终结 40+ 连败死循环)、错误提示补上异常主路径并新增四条实战 hint、undefined/预览参数报错给出正确写法、诊断可归因(工具名/通道/会话级客户端/MCP 判定/skill 留痕)。
• OpenCode 静默回合停顿看门狗(#327)——长时间无输出的回合明确终止并给原因,健康长任务不受影响。
• 移除恒 false 的 undo.verified(#310);OpenCode 内建工具不再被误标 mcp__ae__ 前缀(#324)。

完整明细见 CHANGELOG 的 [0.10.3] 段。

English

• OpenCode ships inside the ZXP (#321) — a fresh Windows install has a working channel out of the box (official v1.18.23, SHA-256-verified; release builds fail rather than ship without it).
• No terminal for sign-in or installs — Claude open-sign-in-window with auto-refresh, Codex one-click headless login, wizard-run official Claude installer, optional add-to-PATH, and OpenCode Provider as the fresh-install default.
• Replies no longer torn by tool cards (#322); CLIs installed while AE is open are detected (#321); four exec feedback-loop fixes incl. the history-placeholder tripwire and attributable diagnostics (#323); stall watchdog for silent OpenCode turns (#327); undo.verified removed (#310); OpenCode built-in tool names no longer mislabeled (#324).

See the [0.10.3] section of the CHANGELOG for details.

资产 / Assets

• ae-mcp-panel-v0.10.3.zxp — Windows 面板(内置 OpenCode,~59 MB)/ Windows panel with bundled OpenCode
• AeMcpNative-v0.10.0-windows-x64.aex、AeMcpNative-v0.10.0-macos-arm64.plugin.zip — 原生插件自 0.10.0 未变,沿用原产物(哈希与 0.10.2 发布一致)/ native plug-ins unchanged since 0.10.0, carried forward byte-identical
• SHA256SUMS-v0.10.3.txt

验证状态 / Verification

• 发版前门禁:Windows 真机 25 分钟长任务回合完整存活、零工具失败;#322 已在 macOS 真机验证;双套件与 CI 全绿。
• ZXP 为自签名、无时间戳(本机 TSA 不可达,证书有效期内验签正常)。
• 干净机「装 ZXP → 向导 → 内置 OpenCode 直接可用」的端到端验收建议在发布后按 #321 验收清单走一轮。

v0.10.2

v0.10.2

长会话与审批的可靠性修复版。 都是真实使用里暴露出来的问题：手动档的审批卡现在会真正显示、长任务全程有进度、任务运行中切换会话会先确认而不再静默中断、OpenCode 长会话第 6-7 轮之后请求不再膨胀、中文跨数据块不再乱码。原生插件自 v0.10.0 起未改动，本版沿用。

A reliability release for long sessions and approvals. All of it came out of real use: the approval card actually appears in manual tier, long turns report progress throughout, switching sessions mid-run asks before stopping the task instead of dropping it silently, OpenCode long sessions stop inflating their requests after the sixth or seventh turn, and chunked output no longer corrupts multi-byte text. The native plug-in is unchanged since v0.10.0 and is carried forward.

⚠️ 破坏性变更 / Breaking change

失败恢复从 ae_exec 拆了出来。ae_exec({recoveryId}) 不再受理，会返回一条指明改用 ae_execRecover 的错误；公开工具面从 11 个增加到 12 个。不提供兼容垫片——在同一个 schema 里并列两个可选字段，正是这次要消除的歧义来源（低档模型会把六位恢复编号当脚本传进 code）。拆开后两个工具各自只有一个必填字段。

Failure recovery is split out of ae_exec. The ae_exec({recoveryId}) shape is rejected with an error naming ae_execRecover, taking the public surface from 11 tools to 12. No compatibility shim is provided — two optional fields sharing one schema is precisely the ambiguity this change exists to remove (smaller models were passing the six-character recovery id as script text). Each tool now has exactly one required field.

主要变更 / What changed

• 审批卡会真正显示，档位与当前会话一致。 审批身份改用被调工具自身的名字（恢复显示为 ae_execRecover）；授权指纹按完整调用计算而非卡片上的 200 字预览；用户取消 / 对话框不可用 / 超时 / 明确拒绝现在是四条不同提示。
  The approval card actually appears and its tier matches the conversation.
• 长任务持续显示进度，运行中切换会话会先确认。「取消」让当前任务继续跑完，「停止并继续」才停止并切换。
  Long turns keep reporting progress; switching sessions mid-run asks first.
• OpenCode 失败后会话仍然可用。 provider / socket 失败保留真实原因并允许同会话重试。（自动重试尚未实现。）
  An OpenCode failure leaves the session usable.
• OpenCode 长会话请求不再膨胀。 发送前精简历史里已执行过的旧脚本正文，工具结果与 AE 回读不变。
  OpenCode long sessions stop inflating their requests.
• OpenCode 自定义模型可按模型设置上下文窗口。 32K / 64K / 128K（推荐）/ 200K 或自填。
  Per-model context windows for custom OpenCode models.
• 中文跨数据块不再乱码。 三条通道统一按完整 UTF-8 边界解码。
  Chunked output no longer corrupts multi-byte text.
• ae_read 接受按属性完整路径排序，低档模型的脚本返回要求也更明确。
  ae_read accepts full-match-path sorting; clearer script-result guidance for smaller models.

完整条目见 CHANGELOG。

资产 / Assets

文件 / File	说明 / What it is
ae-mcp-panel-v0.10.2.zxp	CEP 面板 + 宿主（Node，生产依赖 Express 4.22.2）+ JSX + 内置技能。Windows 与 macOS 通用，自签名，无嵌套原生二进制。The panel, host, JSX, and bundled skills — one ZXP for both systems, self-signed, no nested native binary.
AeMcpNative-v0.10.0-windows-x64.aex	Windows 原生 AEGP 插件。自 v0.10.0 未改动，本版沿用同一个文件（校验和与 v0.10.1 完全相同）。Windows native AEGP plug-in, unchanged since v0.10.0 and carried forward byte-for-byte.
AeMcpNative-v0.10.0-macos-arm64.plugin.zip	macOS arm64 原生 AEGP 插件 AeMcpNative.plugin，ad-hoc 签名、未公证；同样自 v0.10.0 未改动。macOS arm64 native AEGP plug-in, ad-hoc signed and not notarized; also carried forward.
SHA256SUMS-v0.10.2.txt	三个资产的校验和。Checksums for all three assets.

原生插件没有随本版重新构建——native/ 与 packaging/ 自 v0.10.0 起没有任何改动，而宿主与插件之间的协议版本两侧都固定为 wireVersion: 1，所以 v0.10.0 的插件与 v0.10.2 的宿主完全兼容。重新构建只会换掉校验和，不会带来任何行为差异。

The native plug-in was not rebuilt for this release. native/ and packaging/ are unchanged since v0.10.0, and the host/plug-in protocol is pinned to wireVersion: 1 on both sides, so the v0.10.0 plug-in is fully compatible with the v0.10.2 host. Rebuilding would only change the checksums.

已知限制 / Known limitations

• ZXP 为自签名、无时间戳（构建机上所有时间戳服务均不可用）。证书有效期内验签正常。
  The ZXP is self-signed and carries no timestamp; signature verification works within the certificate's validity window.
• macOS 原生插件为 ad-hoc 签名、未公证，首次加载需在系统设置中放行。
  The macOS native plug-in is ad-hoc signed and not notarized.

What's Changed

• fix(panel): stabilize provider-backed AE tasks across long sessions by @JUNKDOGE-JOE in #319
• release: bump the product version to 0.10.2 and cut its changelog section by @JUNKDOGE-JOE in #320

Full Changelog: v0.10.1...v0.10.2

ae-mcp v0.10.1 — 面板即 MCP 服务 / The panel is the MCP service

v0.10.1

v0.10.0 已撤下，0.10 线从本版开始——它与本版的差别只有上面那一条向导页改动。
v0.10.0 has been withdrawn; 0.10 starts here. The only difference between them is the wizard page entry above.

架构换代版：CEP 面板本身就是 MCP 服务。 Python / uv runtime、sidecar 与 Platform Helper 全部退役，ZXP 从 88 MB 降到约 1.5 MB、一次签名。这也是第一个 Windows 与 macOS 共用同一个 ZXP 的版本——签名载荷里已经没有任何平台二进制，按平台分别构建的只剩原生插件。
The architecture release: the CEP panel is the MCP service. The Python / uv runtime, sidecar, and Platform Helper are retired; the ZXP drops from 88 MB to about 1.5 MB and is signed once. It is also the first release where Windows and macOS share one ZXP — the signed payload contains no platform binaries, and only the native plug-in is still built per platform.

资产 / Assets

文件 / File	说明 / What it is
ae-mcp-panel-v0.10.1.zxp	CEP 面板 + 宿主（Node，生产依赖 Express 4.22.2）+ JSX + 内置技能。Windows 与 macOS 通用，自签名，无嵌套原生二进制。The panel, host, JSX, and bundled skills — one ZXP for both systems, self-signed, no nested native binary.
AeMcpNative-v0.10.0-windows-x64.aex	Windows 原生 AEGP 插件（AE 2023 套件基线单一构件，面向 AE 23–26，静态 CRT）。Windows native AEGP plug-in.
AeMcpNative-v0.10.0-macos-arm64.plugin.zip	macOS arm64 原生 AEGP 插件 AeMcpNative.plugin，ad-hoc 签名、未公证。macOS arm64 native AEGP plug-in, ad-hoc signed and not notarized.
SHA256SUMS-v0.10.1.txt	三个资产的校验和，一个文件——ZXP 是平台无关的，不再按平台分成两份。One checksum file for all three assets; the ZXP is platform-neutral, so the per-platform split of earlier releases is gone.

ZXP 构建自本 tag 指向的提交。两个原生插件是 v0.10.0 的原字节——本版只改了面板，native/ 一行没动，所以它们沿用自己的构建版本命名（构建自干净提交 5a85be7 + 钉死的 Adobe SDK 25.6.61），没有改名冒充 0.10.1。面板与原生插件之间靠 wire version 协商，产品版本号不参与兼容判定。
The ZXP is built from the commit this tag points at. The two native plug-ins are the v0.10.0 bytes: this release changes the panel only and does not touch native/, so they keep the version in their own filenames — built from the clean commit 5a85be7 with the pinned Adobe SDK 25.6.61 — rather than being renamed to claim 0.10.1. The panel and the plug-in negotiate a wire version; the product version plays no part in compatibility.

e9d32954a0748619cac5550d3797db6d5abb7a5f6b0e82d53c641877aaf84184  ae-mcp-panel-v0.10.1.zxp
2297169a235d9b7415763c493f442fb6b749cf45a5042cc2f7a80a4ec0290ecc  AeMcpNative-v0.10.0-windows-x64.aex
ff90d2ef2bb788db0731a8d53dae9d8283c4860e72e4e0cc4e73b88e8fc8193c  AeMcpNative-v0.10.0-macos-arm64.plugin.zip

原生插件只被 ae_nativeExec 一个工具使用；没有它，其余十个工具照常工作。
ae_nativeExec is the only tool that needs the native plug-in; the other ten work without it.

安装 / Install

1. 用受支持的 ZXP installer 安装 ae-mcp-panel-v0.10.1.zxp（两个系统同一个文件）。
2. 完全退出 After Effects 后安装原生插件：
   • Windows：以管理员权限把 .aex 复制为 Support Files\Plug-ins\Extensions\AeMcpNative.aex。
   • macOS：解压后把整个 AeMcpNative.plugin 放到
     ~/Library/Application Support/Adobe/Common/Plug-ins/7.0/MediaCore/ae-mcp/AeMcpNative.plugin，
     并去掉下载隔离属性：xattr -dr com.apple.quarantine <路径>/AeMcpNative.plugin。
3. 启动 AE，打开 窗口 > 扩展 > ae-mcp；面板必须保持打开，它持有 http://127.0.0.1:11488/mcp。
4. Claude Code：claude mcp add --transport http ae http://127.0.0.1:11488/mcp；Claude Desktop 用扩展目录里的 host/stdio-shim.js（需系统 Node ≥ 18）。详见 docs/INSTALL.md。

Install the ZXP with a supported installer (same file on both systems). With After Effects fully closed, install the native plug-in — copy the .aex into Support Files\Plug-ins\Extensions\ on Windows, or place the whole AeMcpNative.plugin under ~/Library/Application Support/Adobe/Common/Plug-ins/7.0/MediaCore/ae-mcp/ on macOS and clear the download quarantine with xattr -dr com.apple.quarantine. Then start AE, open Window > Extensions > ae-mcp, and keep the panel open — it owns the local endpoint. See docs/INSTALL.md for the client configuration.

依赖 / Requirements

组件 / Component	需要什么 / What you need
After Effects	Windows x64 或 macOS arm64；AE 2026 真机验证，AE 2025 同一代码线；AE 2023 / 2024 为代码侧就绪（manifest 23.0–26.9、CEP 11 polyfill、AEX 单一构件），真机未验证，见 #215
Claude Code	无额外依赖 / nothing extra — 一条 /mcp URL
Claude Desktop	系统 Node ≥ 18（只为扩展目录里的无依赖 stdio shim）
内置 Claude 通道（可选）	本机 claude CLI ≥ 2.0 且已登录
内置 Codex 通道（可选）	本机 codex CLI（app-server）；面板用独立 CODEX_HOME（~/.ae-mcp/codex-home），需在该目录登录一次
内置 OpenCode 通道（可选）	本机 opencode CLI（1.17+）；自定义 Provider（Base URL + API Key）经此通道
不再需要 / No longer needed	Python、uv、uv tool install ae-mcp 的 runtime、Platform Helper、系统 Node（除 Claude Desktop 外）

从 v0.9.x 升级 / Upgrading from v0.9.x

1. ZXP 与原生插件都要换——面板与宿主整体换代，旧 AEX / .plugin 与新的原生契约不匹配。Replace both; the old native plug-in does not match the new contract.
2. 重新注册 MCP 客户端——删掉旧的 stdio ae-mcp 启动器条目，改用 URL（Claude Code）或 shim（Claude Desktop）；MCP 工具只在新会话加载。Re-register clients and start a new session.
3. 可卸载旧 runtime：uv tool uninstall ae-mcp。The old Python runtime is unused.
4. Provider 的 API Key 需要重填——自定义 Provider 现在写进 OpenCode 自己的凭据存储，旧 helper 存储不迁移。Provider keys must be re-entered.
5. 保留的数据：~/.ae-mcp/tools 与 checkpoints 原样兼容；新增 ~/.ae-mcp/sessions、~/.ae-mcp/opencode、~/.ae-mcp/codex-home、~/.ae-mcp/logs。
6. 行为变化：ae.skillUse(execute=true) 恢复 v0.9.0 的顶层透传返回形状；ae_exec 非字符串结果改为结构化 JSON 信封。

本版清单 / What's in this release

完整条目见 CHANGELOG.md 的 [0.10.0] 段（中英双语）。按主题：
Full entries are in CHANGELOG.md under [0.10.0]; by theme:

架构 / Architecture（#260 #261 #262 #263 #264） — Phase 0 ExtendScript 超时契约与诊断包；Phase 1 MCP server 进面板宿主（每会话 /mcp/c/<token>、审批门、自动 checkpoint）；Phase 2 Tool Library 进宿主、MCP session 客户端身份与阻断、Claude Desktop stdio shim、claude 后端换 CLI，删除 Python / sidecar / platform-helper（约 -134k 行）；Phase 3 provider 收敛到 claude / codex / opencode 三通道。

工具能力 / Tools（#254 #265 #289 #290 #306） — ae_exec 结构化结果信封与失败恢复信封（recoveryId + 可编辑脚本 + 快照差分归因）；大结果 ASCII 转义提速（300 KB 从 5–6 s 到亚秒）；ae_previewFrame 区间采样、带时间码拼图、A/B 像素差分热力图；Provider 管理器一键探测模型。

面板 / Panel（#231 #233 #286 #287 #292 #297 #298 #299 #311） — 会话管理（新建 / 历史 / 切换 / 改名 / 归档 / 删除，真后端恢复）；三通道稳定错误类别码与双语指引；OpenCode 子进程生命周期闭环；冷启动阶段提示；npm audit 归零。 首跑向导的「连接外部客户端」页改成一段可复制的提示词（#311）：不再让你在三个客户端里单选再照抄配置，粘给你正在用的 AI 客户端由它自己完成注册，提示词里的地址与 stdio shim 路径取自本次安装的真实端口与扩展目录；下方保留裸 URL 作为手工出口。设置页的逐客户端配置作为高级入口保持不变。 The wizard's external-client page is now a single copyable prompt (#311) carrying this install's real port and extension root.

修复 / Fixes — ae.diagnose 忽略代理环境变量（#267）；Tool Library argsSchema 接受属性描述（#268）；ae.skillUse 返回形状（#269）；两处 macOS 专属的测试环境依赖（#302 #303）。

已知事项 / Known notes

• AE 2023 / 2024 未做真机验收（#215 众测中）。Not validated on AE 2023 / 2024 hardware.
• macOS 真机状态：AE 2026（26.3x87）上已验证——面板宿主报 0.10.0、11 个工具齐全，ae_status / ae_read / ae_previewFrame / ae_exec 通过，CEP 宿主与 AEGP 原生插件在 macOS AF_UNIX 通道上完成握手与 capabilities 往返（AE 2026 带 disable-library-validation 授权，ad-hoc 签名的插件可以被加载），完整的 ae_nativeExec 写路径也已跑通：两次 composition.duration.set 返回 effect: committed 与 postcondition verified: true，合成时长 25/2 s → 15 s；一次真实的 Cmd+Z 之后，经原生只读程序独立复核回到 25/2 s，工作区时长一并还原；往返 25–50 ms。撤销不由信封自证——undo.verified 在协议里恒为 false，还原是带外 Undo 加一次独立读证明的。 On macOS the panel host, the ten non-native tools, the host↔plug-in native handshake and the full ae_nativeExec write path are all verified on AE 2026: two composition.duration.set writes returned effect: committed with a verified postcondition, moving the comp duration 25/2 s → 15 s, and after a real Cmd+Z an independent native read-only program witnessed the restored 25/2 s, work-area duration included, at 25–50 ms per round trip. The envelope does not attest the undo itself: undo.verified is pinned false in the protocol, so restoration was proven out of band.
• macOS 原生插件为 ad-hoc 签名、未公证（本项目暂无 Apple Developer ID）。下载后请先核对 SHA-256，并按安装步骤去掉 com.apple.quarantine。The macOS plug-in is ad-hoc signed and not notarized; verify the checksum and clear the quarantine attribute.
• ZXP 自签名且未带时间戳（构建环境无法访问 TSA）；证书有效期内验签正常。The ZXP is self-signed without a timestamp.
• plugin/panel 的构建工具 esbuild 有一条仅影响开发服务器的通告；它不进 ZXP。The esbuild advisory is dev-server-only and not shipped.

ae-mcp v0.9.6 — Windows x64

v0.9.6

Windows x64 补丁版 / Windows x64 patch release. 修正 v0.9.5 的 MCP 工具 schema 与 Anthropic API / AWS Bedrock 的兼容问题（#273），并带上 v0.9.5 之后合入 main 的全部修复。
Fixes the v0.9.5 MCP tool-schema incompatibility with the Anthropic API / AWS Bedrock (#273) and carries every fix merged to main since v0.9.5.

资产 / Assets

• ae-mcp-panel-v0.9.6-windows-x64.zxp — CEP 面板 + 生产 Host 依赖 + Windows Platform Helper（自签名，ZXPSignCmd 验签通过，Windows 最小载荷校验通过）
• AeMcpNative-v0.9.6-windows-x64.aex — 原生 AEGP 插件，AE 2023 套件基线单一构件（面向 AE 23–26），构建自 369cf3b + 钉死 25.6 SDK；自 #235 起为静态 CRT（/MT）链接，不再依赖 VC++ 运行库
• SHA256SUMS-v0.9.6.txt

9051541e670a57a7a0ec06d46b69a632af25505dcceeffbb09c6ada682c0c4fa  ae-mcp-panel-v0.9.6-windows-x64.zxp
35942bed0eafba7fa10ae654d066428e36feeab0638168eb78f75296df21e359  AeMcpNative-v0.9.6-windows-x64.aex

安装：ZXP 用受支持的 ZXP installer；AEX 关闭 AE 后以管理员权限手动复制到 Support Files\Plug-ins\Extensions\AeMcpNative.aex。首跑向导会联网安装固定到 v0.9.6 tag 的 runtime（uv tool install）。
Install: ZXP via a supported ZXP installer; AEX copied manually (AE closed, admin) to Support Files\Plug-ins\Extensions\AeMcpNative.aex. The first-run wizard installs the runtime pinned to the v0.9.6 tag.

从 v0.9.5 升级 / Upgrading from v0.9.5

只遇到 input_schema does not support oneOf, allOf, or anyOf at the top level 的用户：修复在 Python runtime 里，重装 runtime 即可，ZXP/AEX 不必重装；之前按临时绕法 deny 掉 mcp__ae__ae_nativeExec 的，升级后可以去掉。
If you only hit the input_schema does not support oneOf, allOf, or anyOf at the top level error: the fix lives in the Python runtime — reinstall it and you are done; the ZXP/AEX can stay. If you denied mcp__ae__ae_nativeExec as a workaround, you can drop that now.

uv tool install --force --from "git+https://github.com/JUNKDOGE-JOE/after-effects-mcp@v0.9.6#subdirectory=packages/core" ae-mcp --with "git+https://github.com/JUNKDOGE-JOE/after-effects-mcp@v0.9.6#subdirectory=packages/bridge" --with "git+https://github.com/JUNKDOGE-JOE/after-effects-mcp@v0.9.6#subdirectory=packages/snapshot-mss"

然后新开一个客户端会话（MCP 工具只在会话启动时加载）。README 顶部的一行安装提示词已固定到 v0.9.6，可直接贴给你的 agent。
Then start a new client session (MCP tools load at session start). The one-line install prompt at the top of the README is pinned to v0.9.6 and can be pasted into your agent as-is.

本版修复清单 / Fixed in this release

模型接口兼容 / Model-API compatibility

• #273 ae_nativeExec 广告给 MCP 客户端的 inputSchema 不再在顶层带 allOf——Anthropic 直连与 Bedrock 会以 input_schema does not support oneOf, allOf, or anyOf at the top level 拒绝整个请求，经中转站接 Bedrock 的 Claude Code 用户首个请求即失败（新版 Claude Code 直连会悄悄剥掉顶层组合子，所以不是人人都能复现）。23 个原语的嵌套判别 schema、服务端完整的读/写程序校验与结构化错误契约不变；新增守卫测试禁止任何工具在 schema 顶层出现组合子；对安装件实测 tools/list：16 个工具顶层组合子 offender = 0。

AE 2023/2024 兼容 / AE 2023/2024 compatibility

• #235 AE 2023/2024 Windows 运行时补完：CEP 11（Node 15 / V8 8.8）缺 Object.hasOwn / Array.prototype.at / structuredClone，Host 与面板各注入无依赖 polyfill shim；node: 裸 specifier 禁用改为清单式合约测试；AEX、Platform Helper、传输 .node 插件统一静态 CRT（/MT）并由 PE 导入表校验强制（顺带修了 8 字节节名 .fptable 的验证器误报）。AE 2023/2024 真机矩阵仍在 #215 众测。

截图与预览 / Capture & preview

• #242 ae_previewFrame：尺寸改为从写出的 PNG 回读（查看器半分辨率不再报 "dimensions do not match"）；帧文件要等到 IEND + 大小稳定 + 可解码才算写完（不再间歇 "not a decodable image"）；预算按帧增长、times 上限 8；降采样捕获接受并在正文里给出警告。
• #243 ae_snapshot 无 out_path 时默认落到系统临时目录下的绝对路径（UUID 命名），不再解析到 MCP 进程的工作目录（[Errno 13] Permission denied: 'ae_viewer_….png'）。

面板 / Panel

• #243 输入框不再被"锁死"成 8px：composer 下限 72→96px、启动期非法测量值丢弃；CSXS MinSize 300×280、默认尺寸 480×420。（@tomaszteee 在 Windows 11 / AE 2026 上定位并验证）

文档与工程 / Docs & engineering

• #270 README 一行安装提示词重写：新装的 uv 用完整路径调用、启动器用绝对路径、MCP server 注册到用户级作用域（附 claude mcp add -s user … 原句）、不动其他 MCP 条目并回显最终配置、说明 MCP 工具只在新会话加载。
• #243 审批两道门默认方向相反的设计写进模块 docstring、调用点与 docs/REFERENCE.md（环境变量首次成文），三条测试钉住。
• #244 macOS 合并门现在跑完整 Python/JS 套件；bridge 的 Windows 生命周期探针测试不再改写共享 stdlib 模块。
• #245 新增 CONTRIBUTORS.md：记录 git 记不下来的贡献（根因分析、真机验证）。
• #266 / #272 docs/ARCHITECTURE_DIRECTION.md：两进程方向与 2026-08-19 的 owner 决策记录。

已知事项 / Known notes

• 本版自签名未带时间戳（构建环境无法访问 TSA）；证书有效期内验签正常。
• 不含 macOS 资产：macOS 用户可用 README 的一行安装提示词直接安装固定到 v0.9.6 的 runtime（#273 的修复在 runtime 侧）；面板/原生插件仍可沿用 v0.9.5 的 macOS 补充资产。
• 资产构建自 CI 全绿的 main 提交 369cf3b，ZXP 已验签并通过 Windows 最小载荷校验，AEX 已通过 PE/x64/入口/版本/源码提交校验；相对 v0.9.5，面板/原生侧的代码变化（#235 / #243）此前已在 AE 2026 真机验证，v0.9.6 最终字节本身未再做单独的 AE 真机安装验收——有真机反馈欢迎提 issue。
• AE 2023/2024 为代码侧就绪，真机验收矩阵在 #215 进行中——欢迎用 23/24 测试机反馈。