Reported issues for ae-mcp
Pod holds 24 of 160 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.
Back to ae-mcp.
Most discussed
epic(native-sdk): build the AE AEGP execution plane and capability set
Confirmed scope
Here, AE SDK means the compiled Adobe After Effects C/C++ Plug-in SDK: AEGP/general plug-ins and, where appropriate, Effect/IO/GPU suites. It does not mean CEP/HTML5 Panel SDK, ExtendScript, JSX, or a typed MCP schema whose implementation still renders JSX.
The CC 2015 Panel SDK remains relevant to the UI layer only. The 2018 SensorManager SDK is MGJSON-specific and is not a general AE project-control API.
Product principle
AEGP is a means to obtain a higher cap
Read the thread · 2026-07-13 · closed · 47 comments
epic(macos): deliver production-ready macOS support in auditable phases
Outcome
Deliver production-ready macOS support without treating it as one undifferentiated change. Work must proceed through independently testable phases with explicit exit criteria and linked child issues after the current-state audit.
Phase breakdown
Phase 0 — Current-state audit and support contract
- Inventory what is already implemented on current
mainversus stubs, Windows assumptions, or unverified paths. - Freeze supported macOS versions, CPU architectures, After Effects
Read the thread · 2026-07-13 · open · 8 comments
feat(native): add Layer Transform Editing capability package
Parent / priority
- Parent Epic: #61
- Depends on: #162 / PR #163 clean-main closure and #164 workflow-rule closure
- Priority: P1 — next user-visible native editing package
- Baseline:
1f322375bdb8754b70cf5a128074f5d5b02743b4 - Delivery unit: one branch/worktree, one PR, one candidate T5, one clean-main T6
User outcome
Let models read and edit the transform fields used in nearly every After Effects layout/animation task without discovering paginated property locators, supplying SDK m
Read the thread · 2026-07-22 · closed · 7 comments
arch: 把 MCP server 手写进 CEP Node 上下文,消掉环形依赖与双运行时
方向背景:docs/ARCHITECTURE_DIRECTION.md §6.2 + Phase 1
目标
把 MCP server 从独立 Python 进程搬进 CEP 面板的 Node 上下文,消掉环形调用链。
现状是环:面板 spawn agent → agent 走 MCP → Python 进程 → HTTP 打回面板 :11488。
目标是线:面板内 /mcp ← agent CLI 子进程直连;/mcp、/exec、/native/* 同进程。
一次性解决:环形依赖、双运行时(Node + Python)、打包闭合(plugin/shared 缺件类事故)、AE_MCP_PLUGIN_URL 单点绑定、一次对话两份 ae-mcp 子进程。
硬约束:必须手写,不能用官方 SDK
plugin/host/cep-runtime-compat.js:3-5 已写明:CEP 11(AE 2023/2024)是 **Node
Read the thread · 2026-08-15 · closed · 6 comments
panel(windows): ZXP 缺少 runtime/windows-x64/node/sidecar 载荷,Claude 侧车必然 ENOENT——api 通道聊天在 Windows 上结构性不可用
实证(2026-08-12,Windows 11 x64,全新安装 v0.9.5 ZXP + AEX)
Claude 通用 Provider(api 通道)发消息,聊天区永远只有一句 Provider sidecar request failed.,日志导出里 sidecar stderr 段是 [provider-sidecar-stderr-redacted](见 #233)。进程表里从来没有出现过 agent-sidecar 进程。
根因:Windows 生产路径指向一个 ZXP 里不存在的文件
client/dist/app.js(安装后的 0.9.5 bundle,行号为该文件)resolveSidecarPath:
// app.js:40531-40548
const developmentMarker = join([root, ".debug"]);
const developmentSidecar = join([root, "sidecar", "agent-sidecar.mjs"]);
[Read the thread](https://github.com/JUNKDOGE-JOE/after-effects-mcp/issues/239) · 2026-08-12 · closed · 6 comments
### feat(native-tools): add bounded AEGP layer property stream inspection
Parent epic: #77\nDepends on: #99\nPriority: P0 native capability path\n\n## Goal\n\nAdd one real, bounded layer property/stream inspection capability backed by verified After Effects C/C++ AEGP suites and exposed through the public MCP surface. This slice must make useful native AE state discoverable to an AI without evalScript or silent JSX fallback.\n\n## Scope\n\n- Audit the fixed After Effects SDK 25.6.61 suites before locking the contract.\n- Reuse the opaque project, composition, and laye
[Read the thread](https://github.com/JUNKDOGE-JOE/after-effects-mcp/issues/101) · 2026-07-15 · closed · 6 comments
### feat(native-tools): ship the first macOS read-only AEGP capability slice
Parent epic: #61
## Outcome
The first **macOS arm64** read-only AEGP capability slice is complete. This issue is now deliberately scoped to the platform and capability slices that were actually built and accepted; it is not a permanent catch-all for future tools.
The public path proven by the slices is:
```text
public MCP -> Core -> native RPC -> AEGP main-thread dispatcher -> real AE state
-> typed native-aegp result -> audit/postcondition evidence
Completed slices
- [x]
Read the thread · 2026-07-13 · closed · 5 comments
Feature plan: Tools library panel for generated scripts, skills, and expressions
背景
需要在面板下方栏新增一个 Tools 列,用于管理 agent 在执行历史中产生的脚本、skill、表达式等可复用资产。所有保存后的 tools 应在插件启动时通过统一入口逐层暴露给模型,避免模型每次凭记忆重写脚本或一次性加载过多模板。
Provider 请求头 / wire API 兼容性独立跟进在 #49,本 issue 只讨论 Tools 管理与模型暴露入口。
当前基础
- 底部 tab 当前在
plugin/panel/src/app/App.jsx:818,只有chat / activity / settings。 - Activity tab 在
plugin/panel/src/screens/ActivityScreen.jsx:54。 - Activity 订阅在
plugin/panel/src/cep/useActivity.js:3,目前主要保留最近事件,不是持久资产库。 - 已有 skill CRUD:
packages/core/ae_mcp/handlers/skills.py:114到:118。
Read the thread · 2026-07-07 · closed · 5 comments
Most recent
tool-library: 新增 ae_toolSave——创建/沉淀/更新/状态管理,库首个写动词(12→13)
背景
JS host 中 Tool Library 是只读的:saveArtifact 全仓库零生产调用方(只有测试在调),12 工具面上只有 ae_toolSearch / ae_toolUse / ae_skillUse 三个读・跑动词。创建、沉淀、更新、归档——一个写动词都不存在。本 issue 补上库的首个写动词。
任务
- 新增
ae_toolSave(工具面 12→13),三种用法:- 沉淀:
name传 candidate id,status→saved,可同时改 name / description / tags; - 新建:直接给 kind / content / argsSchema / name / description;
- 更新:对已有条目改内容或元数据,revision+1,contentHash 随之变化。
- 沉淀:
- 状态管理并入同一动词:status 参数支持 saved / pinned / archived / deprecated(避免动词爆炸)
- [ ]
Read the thread · 2026-08-27 · closed · 0 comments
docs: v0.10.5 全量文档更新——过时归档、路线图/开发者文档对齐(功能开发收尾后执行)
背景
v0.10.5 落完后工具面 12→13、信封新增 artifactId、Tool Library 子系统成型——文档面需要一次全量对齐,而不是零散补丁。同时 docs/ 里积累了过时内容需要归档。
执行时点:本版全部功能 issue 关闭后、发版前,作为收尾单执行。
任务
- docs/ 全量盘点:过时文档归档(移入 docs/archive/ 或删除,git 历史保留),主导航不再出现归档内容
- 路线图刷新:ARCHITECTURE_DIRECTION.md 及相关 phase/规划文档对齐本版决策(库子系统成型、占位符死循环根治、身份戳等已裁决不做项)
- 开发者文档:13 工具动词表、capture→replay→save 工作流、
artifactId信封字段、ae_toolSave契约、candidate 生命周期(保留 20/TTL 7 天)、分发(导出/导入/bundled)机制 - README(中英)与 INSTALL 对齐:工具数、动词表、接入口径(npx 连接器 /
/mcp直连
Read the thread · 2026-08-27 · closed · 0 comments
tool-library: 采用与度量——工作流指引接线、lastUsedAt/useCount 落地、使用漏斗可诊断
背景
建成≠会用。实证两条:历史 candidates 自 7 月入库以来没有被任何会话搜索或重放过;lastUsedAt 字段有定义、有校验、有展示——但全仓库没有任何代码写它,ae_toolUse 跑完工具不留痕。没有引导和度量,库建完就是吃灰。
任务
-
ae_toolUse/ae_skillUse执行后更新lastUsedAt,新增 useCount -
instructions与内置 ae-execution-guide 增加路径指引:重复性操作先ae_toolSearch→ 命中即ae_toolUse→ 值得留的ae_toolSave -
ae_toolSearch/ae_toolUse/ae_toolSave的 description 重写为工作流导向(description 是模型唯一的常驻感知面,现在只解释机制、不推销工作流) - 活动日志/诊断导出能回答"捕获→重放→沉淀"漏斗:多少 candidate 被重放、多少被沉淀、多少 saved
Read the thread · 2026-08-27 · closed · 0 comments
tool-library: 分发与面板库管理页——导出/导入、bundled 清单生成入口
背景
库的分发通道现状:产品级 bundled 签名清单(构建期)是唯一渠道;无导出/导入;面板没有任何库管理界面。artifact 模型已预留 source:"imported",从未被使用。
任务
- 导出:saved/pinned 工具导出为自包含 JSON(含 contentHash、schemaVersion)
- 导入:source=imported、verified=false;进库前
assertSecretFree+ 审批;contentHash 校验 - bundled 入口:构建脚本支持从本机 saved 工具生成
skills_bundled清单条目(签名流程维持现状) - 面板库管理页:candidates / saved 两个列表;收藏(沉淀)、归档、删除、导入导出、一键清空 candidates;展示使用统计(数据来自同批"采用与度量"issue)
验收
- 导出 → 另一环境导入 → 审批 → 可跑,全链真机过;
- 面板操作真机过;host/pa
Read the thread · 2026-08-27 · closed · 0 comments
tool-library: 用户 skill 统一进库——ae_toolSave(kind=prompt-skill)、ae_skillUse 列表纳入
背景
用户 skill 目前只能手放 JSON 文件进 ~/.ae-mcp/skills(legacy wire 格式),没有任何创建工具;bundled skill 走签名清单只读。skill 的创建/保存应与工具库统一走 ae_toolSave。
任务
-
ae_toolSave支持 kind=prompt-skill,落用户库(与 legacy 目录兼容读,不做迁移) -
ae_skillUse列表纳入用户新建的 skill;明确并写死重名规则(现状listSkills()为 user 覆盖 bundled,保持并在文档注释里写明) - 明确两个 kind 的生命周期差异:jsx 有 candidate→saved 沉淀链,prompt-skill 直接创建;在开发者文档/注释中写清
- bundled 维持签名清单只读,不受本 issue 影响
验收
- 真机创建一个用户 skill →
ae_skillUse列表可见、可渲染、可执行;host 套件绿。
关联
同批 `ae_
Read the thread · 2026-08-27 · closed · 0 comments
host: ae_exec 成功脚本自动入库 candidate——信封回 artifactId、守卫列可重放条目、会话保留 20/TTL 7 天
背景
0.10.3 的 #323 把"占位符当代码回放"拦下来了,但只有拦截、没有出路:2026-08-27 实测单会话 13+ 连拒——上下文压缩后模型手里只剩占位符,守卫要求"从头重写"一段已丢失的 11K 生成物,模型唯一可做的动作只剩重试,死循环是结构必然。
Python 时代本有解法:成功的 ae.exec 自动捕获进 Tool Library(~/.ae-mcp/tools 里仍留有 status:"candidate"、sourceType:"chat-tool-call"、description:"Captured from a successful MCP tool call." 的历史工件,最后一条 2026-08-02)。JS 重写时该链路遗失:现在 host 中 candidate/chat-tool-call 仅剩常量定义,全仓库无任何写入方。本 issue 是把它接回来并补齐当年缺的配套。
任务
-
ae_exec/ae_execRecover成功后自动入库:kind=jsx、status=c
Read the thread · 2026-08-27 · closed · 0 comments
skills: 内置 Skill 持续优化(内容迭代 / 触发命中 / typed-verb 待定项 / 使用度量)
背景
宿主内置 8 个 bundled skill(plugin/host/mcp/skills_bundled/):ae-execution-guide、extendscript-cookbook,加 6 个创作类(kinetic-typography / ease-and-timing / grade-stack / render-order / project-organization / glow-recipes),经 ae_skillList / ae_skillUse 暴露,AE_MCP_EXPERT_GUIDANCE 默认开。owner 意向:下个版本继续优化一轮。
候选方向(具体范围待 owner 圈定排序,可拆子任务)
- 内容迭代:按真实会话回放补盲区——高频 ExtendScript 报错沉淀进
extendscript-cookbook;创作类技能补配方、参数手感与更多风格变体。 - 触发与发现性:优化各 skill 的 description / 触发词,让模型在正确时机
Read the thread · 2026-08-26 · open · 0 comments
panel: 「文档 / GitHub」按钮真机点击无反应;接通后按语言路由到正式文档(中文→飞书,英文→Notion/GitHub 托管)
现状(2026-08-26 于 main 核实)
- 设置页「关于」区有两个按钮:文档 / GitHub(
plugin/panel/src/screens/SettingsScreen.jsx:487-488)。 - 源码里 onClick 已接
openExternal():优先window.cep.util.openURLInDefaultBrowser,回落window.open(同文件 21–29 行)。 - 但真机 CEP 面板里两个按钮自始至终点击无任何反应——两层调用都在 try/catch 里被静默吞掉,无日志无提示。
- 目标 URL 也只是占位:
DOCS_URL= 仓库 README 锚点(#readme),并无正式文档;REPO_URL= 仓库首页。 - 另:同文件 245 行还有一处
<a target="_blank">(client.docsUrl),在 CEF 里同样不可靠,应一并收敛到修好的打开函数。
待做
- 修通外链打开:排查 CEP 环境里 `cep.u
Read the thread · 2026-08-26 · closed · 0 comments
opencode: 常驻实例在宿主重启后抱着死 MCP 连接——ae 工具报 -32000 后整组静默消失,永不重连
现象(测试机实录,面板内会话)
- 会话内首次调用
ae_status→MCP error -32000: Connection closed;紧接着ae_read→Not connected; - 此后 ae 工具从会话的工具列表整组消失,模型只剩内建工具,开始用 bash/curl 乱撞(还把 /mcp 握手 404 等误导性结果当线索);
- 期间宿主实际健康:AE 开着、11488 有 CEPHtmlEngine 监听、host 日志有当日
Host ready; - 用户无从知晓发生了什么,也没有任何可见的恢复指引。
机制(代码核实)
- 面板给 opencode 写配置时注入
{ type: 'remote', url: <host>/mcp }(openCodeBackend.js writeConfig ~L896),并按设计跨回合/跨面板重载复用常驻 opencode 实例(instance marker + alive 探测,#286 修复引入); - CEP 宿主一旦重启(面板重载、AE
Read the thread · 2026-08-26 · closed · 1 comment
test(host): 集成测试读写用户真实 ~/.ae-mcp 状态,本机状态可让套件必败
现象
发版 v0.10.3 前本机跑 plugin/host 套件,server-integration.test.js 的 MCP ae_exec 集成用例三连必败:initialize 不返回 Mcp-Session-Id。同一装配的直连探针却全通。
根因
用户真实状态文件 ~/.ae-mcp/blocked-clients.json 里存着 ["mcp-exec-integration"]——恰是该测试的 clientInfo.name(推测为早前测试面板拉黑功能时的残留)。宿主测试 fixture 直接 require 真实 server.js,client-blocklist 读的是真实用户目录 → initialize 被 CLIENT_BLOCKED 拒绝。CI 无恙(干净 home),只在开发机上踩雷,且极难排查(报错形态是 header undefined 的 TypeError,与黑名单毫无表面关联)。
风险
- 本机任何面板操作留下的状态(黑名单、migrations、checkpoints)都可能让测试套件
Read the thread · 2026-08-26 · closed · 0 comments
panel(opencode): 内建工具被误标为 mcp__ae__ 前缀,干扰事故还原
现象
OpenCode 通道的会话里,OpenCode 自带的内建工具在面板 UI 与导出转录中被显示为我们的 MCP 工具:
apply_patch→ 显示为mcp__ae__apply_patchread→ 显示为mcp__ae__readtodowrite→ 显示为mcp__ae__todowrite
真实的 ae 工具(ae_ae_execRecover → mcp__ae__ae_execRecover)与这些假前缀混在一起,排障时会把"模型在改本地文件"误读成"模型在调 ae-mcp 工具",严重干扰事故还原(0825 滚动数字会话转录实测)。
根因
openCodeBackend.js:139 prefixedToolName() 对一切不以 mcp__ 开头的名字无条件冠 mcp__ae__ 前缀:
if (text.startsWith('mcp__')) re
[Read the thread](https://github.com/JUNKDOGE-JOE/after-effects-mcp/issues/324) · 2026-08-25 · closed · 0 comments
### fix(opencode): 流式文本被工具/问题事件截断并发生显示顺序错乱
## 环境
- Windows x64
- After Effects 2026 v26.3
- ae-mcp v0.10.2
- OpenCode CLI v1.18.22
- OpenCode Provider 通道
## 现象
OpenCode 在流式回复期间调用工具并弹出问题卡时:
1. 工具状态会插入助手正文中间。
2. 同一段文字会在任意字符位置断开。
3. 用户已经回答问题后,问题之前应当显示的文字才继续出现。
4. UI 仍可能显示“等待模型回复”。
实际会话中,同一个单词被拆开:
- `ai-text :15` 结尾:`globalA`
- `question :16`:状态已经是 `answered`
- `ai-text :17` 开头:`lpha 0.7 ... 两件事需要你拍板`
因此最终显示顺序变成:
```text
globalA
[问题卡:已回答]
lpha 0.7 ... 两件事需要你拍板
可能根因
createDeltaRedactor() 会根据敏感值长度保留一段尾部缓冲。
OpenCode 的 `messa
Read the thread · 2026-08-25 · closed · external user · 1 comment
feat(windows): ZXP 至少内置 OpenCode,并让“重新检测”无需重启 AE
问题
在 Windows x64 + After Effects 2026 v26.3 上安装 v0.10.2 ZXP/AEX 后,面板虽然提供 Claude Code、Codex CLI、OpenCode 三个通道,但全新环境中可能一个都不可用,首次配置成本较高。
实际遇到的流程:
- Claude Code 安装到
%USERPROFILE%\.local\bin\claude.exe后,还需要用户手动修改 PATH。 - OpenCode 官网首先给出的是
curl ... | bash,无法直接在原生 PowerShell/CMD 中使用;改用 Chocolatey/Scoop/npm 又要求用户预先安装额外工具。 - 安装 CLI 或修改用户 PATH 后,面板点击“重新检测”仍检测不到新环境;必须完全退出并重新启动 After Effects 后才能识别。
最后一点可能是因为 CEP/After Effects 进程一直使用启动时继承的旧环境变量,而“重新检测”只读取了当前进程的 process.env.PATH。
建议
- **ZX
Read the thread · 2026-08-25 · closed · external user · 0 comments
panel: 子进程 stdout 未设 utf8,中文在 chunk 边界被静默腐蚀
现象
面板 spawn 的 CLI(claude / codex / opencode)的 stdout 流从未调用 setEncoding('utf8'),NDJSON 拼接直接对 Buffer 做字符串拼接。当一个多字节 UTF-8 字符恰好横跨两个 chunk 边界时,字符被腐蚀成替换字符。
对中文场景影响直接——本仓的典型用法就是中文提示词与中文图层文本。
根因
plugin/panel/src/lib/ndjson.js:9:
return function push(chunk) {
buffer += String(chunk || ''); // Buffer -> string,按 chunk 边界独立解码
...
而 plugin/panel/src/cep/claudeAgentBackend.js:1107 挂的是原始流:
spawnedProc.stdout?.on?.('data', reader);
全仓 grep setEncoding,只有 `plu
Read the thread · 2026-08-22 · closed · 0 comments
exec: ae_exec.recoveryId 有 pattern 无描述诱导模型编造,且该字段一旦存在就吞掉 code
现象
两个不同模型族(kimi-k3 与 gpt-5.6-luna)在各自独立的会话里犯了完全相同的错误:往 ae_exec 塞进凭空编造的 recoveryId,导致整次调用白跑。
[tool] mcp__ae__ae_exec -> {"ok":false,"error":"unknown recoveryId: 5x5x5x"}
[tool] mcp__ae__ae_exec -> {"ok":false,"error":"unknown recoveryId: 000000"}
同批次里 ae_read 也连续两次被传空的 comp.id:
[tool] mcp__ae__ae_read -> {"ok":false,"error":"`comp.id` must be a non-empty string"}
[tool] mcp__ae__ae_read -> {"ok":false,"error":"`comp.id` must be a non-empty string"}
两个模型族独立犯
Read the thread · 2026-08-22 · closed · 0 comments
panel(opencode): 上游 socket 中断的真因被吞成 Failed to process error response,且流断无重试导致会话永久报废
现象
opencode 通道每轮都以同一条毫无信息量的错误收场,且一旦发生,整个会话永久报废——之后每次「继续」都在几十到几百毫秒内立刻再次失败。
面板显示与落盘记录都只有:
{"code":"UPSTREAM_ERROR","kind":"model",
"message":"Failed to process error response",
"detail":{"errorName":"APIError"}}
真因被吞掉了
真正的原因写在 opencode 自己的日志里(~/.local/share/opencode/log/opencode.log):
AI_APICallError: Failed to process error response
(cause: Error: The socket connection was closed unexpectedly.
For more information, pass `verbose: true` in the second arg
[Read the thread](https://github.com/JUNKDOGE-JOE/after-effects-mcp/issues/316) · 2026-08-22 · closed · 0 comments
The remaining reports are on [the project's issue tracker](https://github.com/JUNKDOGE-JOE/after-effects-mcp/issues).