Folder Fanatic 1.0.2

官方一句话：CREATE. MANAGE. SWITCH. ORGANISE.——Folder Fanatic 是给 AE 项目面板（Project Panel）用的文件夹整理扩展，作者 BPMograph，官方价 $20.00。

痛点很具体：工程一开，素材一多，项目面板根目录很快就堆满合成、预合成、视频、静帧、音频、3D 资产和各种格式的源文件。手工拖文件夹归类既费时又容易漏。

Folder Fanatic 的思路是结构存成预设，之后一键套用：选预设 → 选 Full / Used → 点 Organize，它自动建文件夹并按规则把条目归位。每条规则可以精确到「谁进哪个文件夹」。

官方帮助文档里最重要的一句定调：“It does not move, rename, delete, or alter source files on disk.”——它完全在 AE 项目面板内工作，硬盘上的源文件一根头发都不碰。

一、两种整理模式

点 Organize 之前先选文件夹创建模式：

• Full（完整）：创建预设里的每一个文件夹，哪怕当前工程里没有能进去的东西——适合想要结构统一、方便别人接手的工程。
• Used（按需）：只创建当前工程里确实有匹配条目的文件夹——日常推荐，面板更干净。

另有两条自动行为：匹配不上任何规则的条目会移到 Unsorted（名字可在偏好里改）；工程里有固态层时自动创建或复用顶层 Solids 文件夹。

二、预设编辑器：建结构与导入

紧凑面板上的齿轮按钮打开完整 Preset Editor。

建结构：文件夹按钮新建——没选中任何文件夹时加在顶层，选中了则建在它内部；拖拽文件夹互相嵌套，拖到左侧边 gutter 回到顶层；Enter 重命名，Delete / Backspace 删除；Save 写回选中预设。

导入现有结构：Preset Editor 里的 Import 直接读取当前 AE 工程的文件夹结构。官方说明：「这在 AE 里直接画结构更快时很有用，或者想把现有工程结构变成可复用预设时。」导入后路径匹配的文件夹上已分配的规则会尽量保留，官方仍提醒导入后要检查树、补齐缺失规则再保存。

三、规则体系：谁进哪个文件夹

选中树里的文件夹，右侧规则面板决定它的内容。

基础类型：主合成、预合成、视频、静帧图像、图像序列、音频、3D 资产。

格式：精确到源格式，官方举例 AI、PSD、PNG、MOV、MP4、WAV、JSON、OBJ、C4D。图像序列有专门规则（按源格式识别导入的静帧序列，让 PNG 序列和 EXR 序列进不同文件夹）。

名称 / 路径匹配：名称匹配同时检查项目面板条目名和源文件名；路径匹配检查源文件在磁盘上的位置——官方举例「磁盘文件夹名本身就有用，比如 VO、Music、Stock、Renders、Client Assets」。匹配方式有 contains / startsWith / endsWith，默认不区分大小写，勾 Match case 才区分。

元数据与诊断（默认隐藏，在 Rule Visibility 打开）：帧率、分辨率、宽高比、像素宽高比均支持自定义值，时长支持秒 / MM:SS / H:MM:SS；使用状态（是否被任何合成当源图层用，默认忽略合成与预合成，除非勾 Include comps）；代理（有 / 启用 / 禁用 / 缺失）；缺失源（源文件离线的条目，磁盘文件不动）；文件大小（只查单个源文件，图像序列被忽略，因为总大小分散在多文件上）；Alpha 解释方式（straight / premultiplied / ignored）；占位条目（静帧占位匹配静帧规则，定时占位匹配视频规则）。

四、规则优先级

官方说明：“More specific matches are checked before broader item-type matches. For example, a PSD rule with a name match is checked before a general Still Images rule.”

即更具体的匹配先于更宽泛的类型匹配——带名称匹配的 PSD 规则会先于通用的「静帧图像」规则被检查。

官方还提醒一个安全点：如果只用文本匹配、不挂任何类型或格式规则，它可以匹配任意条目，保存时 Folder Fanatic 会先警告你。

五、标签色与保护机制

标签色：文件夹可在编辑器指定标签色，应用预设时同步到对应文件夹；勾选「把此颜色应用到归类的条目」，移进去的条目也继承颜色。偏好里还有全局开关：让所有被整理条目继承目标文件夹的标签色。磁盘文件不受影响。

保护文件夹（Preferences › Settings › Advanced）：支持全局 + 每预设各自的保护列表。文件图标保护文件夹内直接条目不被移动；文件夹图标保护子文件夹结构在清理时保留；两个都开则直接条目、子文件夹及其内条目全部保护。

预设锁定：编辑器上的挂锁按钮。官方说明「受保护的预设可以加载和使用，但在解锁前不能编辑、重命名或删除」——团队共用工作流时很有用。

六、清理、可见性与其他

清理：偏好里可开启「整理后删除空文件夹」。官方安全说明：受保护的文件夹及其子层级不会被移动；空文件夹会被清理，除非属于生成的预设结构或被保护。

规则可见性：控制编辑器里显示哪些规则控件。隐藏只是减少视觉干扰，不会从已保存的预设里移除规则，隐藏的规则整理时照样生效。可保存个人默认可见集，也可 Show All / Clear All 重来。

其他：每一步 undo / redo、拖拽重排；界面内置英文与法文两套（Preferences › Appearance › Language）；预设文件 `.ffpreset`（兼容旧 `.json`），存放在 Documents/Adobe/After Effects/<版本>/Presets，偏好里可打开预设文件夹、导入导出、恢复内置预设。

版本核对：包内 CSXS/manifest.xml 的 ExtensionBundleVersion 为 1.0.2，与 psdly 标题 V1.0.2 一致。

技术信息：manifest Version 7.0、CSXS 11.0，HostList AEFT [15.0,99.9]（AE CC 2018 起）。两个扩展：FolderFanatic.panel（面板 190×190，最小 104×150，AutoVisible true，菜单名 Folder Fanatic）与 FolderFanatic.editor（Modeless 720×760，最大 1400×1100，最小 600×520）。MainPath 分别指向 ./folderfanatic/index.html 与 ./folderfanatic/editor.html，ScriptPath ./jsx/host.jsx，CEF 参数 --enable-nodejs --mixed-context --disable-gpu-compositing。随包 Quick Start 另写「Tested with Adobe After Effects CC 2024 or newer」，更早版本不推荐。

参数来源说明：功能描述与限制来自包内多语言界面词典（英文 + 法文两套，共 387 条英文条目）的完整帮助文档，以及官方 Quick Start PDF；规则类型、匹配模式、扩展名表、优先级算法等来自解包后 jsx/host.jsx 明文代码，非推测。

随包文件：FolderFanatic/（CEP 面板：manifest、jsx/host.jsx、assets 下两个混淆 bundle 与 CSS、public 图标）、Add Keys.reg（UTF-16 注册表，写 CSXS.5–15 的 PlayerDebugMode / LogLevel 调试开关，仅排障用）、install-as-admin.zip（macOS defaults write 免 sudo 写调试开关）、Win extensions.lnk、FolderFanatic-Quick_Start_v1.0.0.pdf。

如实说明：本包 jsx/host.jsx 中「新工程自动填充文件夹」的三个轮询函数体为 return;，即该版本的 Auto-Populate 未实装；但面板帮助文档完整描述了 Auto-Populate New Projects 功能及配置位置（Preferences › Settings › Advanced，配合 Default Preset）。若要使用自动填充，建议向作者确认当前版本的实装状态。

原产品页：https://aescripts.com/folder-fanatic/

封面图片来自作者官方产品页。本文为中文整理，功能与兼容性信息以作者官方页面与包内说明为准。资源仅供学习交流，商业使用请购买正版授权。