Nya AE.jsx Runner
让 AI 写脚本，在 VS Code 里测试，再切回 After Effects 查看效果。
从 VS Code 运行 .jsx / .jsxbin，查看执行结果和同步错误，把完整源码与问题描述整理给 AI，收藏常用脚本并手动备份。
Windows x64 公开测试版 · AE 2025 已实测 · AE 2026 待单独验收
快速开始
- 安装本扩展，启动 After Effects，只保留一个 AE 实例。
- 在 AE 首选项中启用“允许脚本写入文件和访问网络”，用于回传运行结果。扩展不会替你修改权限。
- 在 VS Code 打开你信任的本地脚本文件夹。左侧点击 Nya 图标，在“目标 AE”中选择本机 AfterFX.exe。
- 点击“打开本地脚本”选择 JSX / JSXBIN，或复制 AI 给出的完整 JSX 后点击“导入 AI 脚本”。
- 点击“运行当前脚本”或按 Ctrl+Alt+R，切回 AE 查看实际效果。脚本需要的合成、选中图层和素材由你提前准备。
打开或导入 → 运行 → 切回 AE 查看效果。打开、收藏和找回备份都不会自动运行脚本。
无需另外安装 Node.js、ExtendScript Toolkit、AE MCP 或常驻 AE 面板。支持本地 VS Code 1.95+；实际验收环境为 VS Code 1.142.0 与 AE 2025 25.6x101。
主要功能
- 运行与错误定位：顶层同步执行完成后显示结果；收到有效原文件路径与行号时，在 Problems 中定位。Ctrl+Alt+Shift+R 可再次运行上次脚本。
- 导入 AI 代码：从剪贴板提取纯代码或一个完整代码块，另存为新 JSX，不覆盖已有文件。
- 完整 AI 求助材料：填写希望的效果和实际现象，复制当前完整 JSX（最多 2 MB）及匹配入口的旧报错。未保存编辑、源码与错误的不同来源会明确标注；JSXBIN 不提供可读源码。
- 常用脚本与使用说明：收藏 JSX / JSXBIN，右键修改显示名称、填写用途 / 运行前准备 / 素材要求，或查看说明。取消收藏只移除记录，源文件仍保留。
- 手动保存可用版本：测试满意后保存当前 JSX，找回时另存为新文件。仅含该 JSX，不含相邻资源或 AE 工程，不自动保存每次测试版本。
- 有限资源检查：列出可识别的固定 include / File / Folder 引用；动态、范围外和搜索路径需要人工确认。相对路径只是候选位置，不是完整依赖分析或运行保证。
- 手动文件夹备份：选择只含该工具与素材的文件夹，预览范围后备份到新的外部目录；保留相对结构、空目录和 SHA-256 清单。限 2000 个文件、2000 个子文件夹、100 MB 总量、单文件 25 MB、20 层；不包含未保存编辑或范围外资源，不跟随链接。
- 原生侧栏：常用操作、收藏、最近 20 个测试脚本、手动可用版本、当前文件与运行状态，跟随 VS Code 主题。
更详细的操作、资源检查边界和文件夹恢复方法，可从工作台右上角问号打开随包附带的本地使用说明。
执行状态怎么理解
- 顶层执行完成：入口脚本已返回。效果是否符合预期，需要你在 AE 检查；不代表后续 ScriptUI 按钮回调、scheduleTask 或渲染完成。
- 脚本错误：收到 AE 的同步错误；有可靠行号时可以定位，没有行号时不伪造位置。
- 结果未确认：没有拿到可靠回传。扩展不自动重发，也不停止 AE；点击“处理未确认的运行”继续等待，或确认 AE 已结束处理后再解除保护。
同一 VS Code 配置档的窗口共用持久运行保护，重载后保留；其他配置档与独立用户目录不共享该保护。多 AE 实例、目标不匹配或进程路径不可读时拒绝发送。
支持范围
- 本次商店包仅面向 Windows x64 本地桌面 VS Code。
- 已在 AE 2025 测试正常运行、同步语法 / 运行错误、中文路径、相对 include、浮动 ScriptUI 初始化、只读连接诊断与受控真实 JSXBIN。
- AE 2026、其他 AE 版本、Windows ARM64、macOS、Linux、远程与网页版 VS Code 尚未验收。具体第三方脚本仍需逐个测试。
- 不提供断点 / 单步调试、选区执行或所有异步错误捕获。可停靠 ScriptUI 面板仍需按其作者说明安装到 AE；从 VS Code 执行不等于已安装停靠面板。
本机数据与隐私
Runner 的功能在本机处理，不调用外部 AI、上传脚本或发送遥测。收藏、手动备份与测试记录写入当前 VS Code 配置档的数据目录；完整 AI 材料只在你点击时写入系统剪贴板。材料可能含源码、路径和错误信息，请在粘贴给外部 AI 前自行检查。
完整说明随扩展附带在 PRIVACY.md。VS Code、Marketplace 和你自行选择的 AI 服务各自适用其隐私规则。
常见问题
JSXBIN 打开后全是长串字符？ 这是编译脚本的正常内容，无需编辑，手动运行即可。它可收藏和随文件夹备份，但不能做 JSX 源码分析或单文件可用版本备份。
侧栏不见了？ 按 Ctrl+Shift+P，执行“Nya AE.jsx Runner: 打开脚本测试工作台”。升级后可执行“Developer: Reload Window”。
运行没有响应？ 先检查 AE 是否忙碌、是否有弹窗、是否只开一个实例，以及脚本写文件权限，再运行“诊断 AE 连接”。结果未确认时先处理已有请求。
旧 Runner 也装着？ 如果有重复按钮，手动禁用旧 Runner 后测试本扩展。
反馈与许可
安装后可在本扩展 Marketplace 页面的 Q & A / 评论中反馈。请提供 Windows、VS Code 与 AE 版本、最短复现步骤、期望 / 实际结果，以及去掉隐私内容的日志。不要公开密码、Token 或未经授权的项目文件。
MIT License。Nya AE.jsx Runner 是独立工具，与 Adobe 官方无隶属关系。
