SoundLib - 音效管理系统

Adobe CEP 扩展面板 - After Effects / Premiere Pro 音效资源管理工具

功能概览

功能	说明
音效导入	支持 WAV、MP3、AIFF、FLAC、OGG、WMA、M4A 等主流音频格式导入
智能分类	基于文件名关键词自动归入 10 大音效类别
分类浏览	UI界面、环境氛围、冲击打击、呼啸过渡、上升蓄力、故障数码、音乐旋律、拟音自然、人声语音、自定义
音效预览	面板内置音频播放器，支持播放/暂停/进度/音量控制
搜索过滤	快速搜索音效名称定位所需资源
应用到时间轴	一键将音效插入 AE 合成或 PR 序列的当前播放头位置
音效详情编辑	编辑分类、标签、备注等元数据
收藏管理	星标收藏常用音效
导出音效库	将整个音效库导出到指定文件夹
双宿主支持	自动检测 AE / PR 环境，适配不同 API
暗色主题UI	匹配 Adobe Creative Cloud 暗色界面风格

目录结构

SoundLib/
├── CSXS/
│   └── manifest.xml        # CEP 扩展配置 (支持 AEFT + PPRO)
├── css/
│   └── style.css            # 面板样式（Adobe 暗色主题）
├── js/
│   ├── CSInterface.js       # Adobe CEP 接口库
│   └── main.js              # 面板前端逻辑（音效管理）
├── jsx/
│   └── host.jsx             # ExtendScript 核心引擎 (AE + PR)
├── icons/
│   └── icon.svg             # 图标
├── index.html               # 面板主页面
├── install.bat              # 安装脚本 (管理员运行)
├── install.ps1              # 安装脚本 (PowerShell 管理员运行)
├── uninstall.bat            # 卸载脚本
└── README.md

安装方法

自动安装（推荐）

右键以管理员身份运行 install.bat 或 install.ps1

手动安装

1. 将整个项目文件夹复制到：

C:\Program Files (x86)\Common Files\Adobe\CEP\extensions\soundlib\

2. 以管理员身份执行以下注册表命令启用调试模式：

reg add "HKCU\Software\Adobe\CSXS.6" /v "PlayerDebugMode" /t REG_SZ /d "1" /f

使用方法

初次使用

1. 启动 After Effects 或 Premiere Pro
2. 菜单栏 → 窗口 → 扩展 → SoundLib
3. 点击右上角齿轮图标打开设置
4. 选择一个文件夹作为音效库存储目录
5. 保存设置

导入音效

1. 点击底部「导入」按钮
2. 选择一个或多个音频文件（WAV/MP3/AIFF/FLAC/OGG 等）
3. 系统自动根据文件名进行智能分类
4. 可在详情弹窗中手动调整分类和标签

预览音效

• 点击列表中音效旁的播放按钮进行预览
• 底部播放器支持播放/暂停、快进、音量调节
• 按空格键快速播放/暂停当前音效

应用到项目

1. 在列表中选中一个音效（或点击音效卡片的快速应用按钮）
2. 在 AE 中打开一个合成，或在 PR 中打开一个序列
3. 点击「应用到时间轴」按钮
4. 音效将自动导入项目并放置在当前播放头位置

导出音效库

点击「导出」按钮，选择目标文件夹即可将整个音效库导出。

音效分类参考

分类	说明	关键词语义
UI界面	按钮、弹窗、通知等界面音效	click, pop, beep, notification
环境氛围	背景环境音、氛围音	ambient, wind, rain, drone
冲击打击	撞击、爆炸、击打	impact, boom, crash, hit
呼啸过渡	转场过渡音效	whoosh, swoosh, sweep
上升蓄力	累积上升音效	riser, buildup, tension
故障数码	数码故障、电子音效	glitch, digital, static
音乐旋律	旋律、乐句	melody, piano, note
拟音自然	脚步声、自然环境	foley, footstep, nature
人声语音	旁白、人声	voice, vocal, speech

支持的音频格式

• WAV (*.wav)
• MP3 (*.mp3)
• AIFF (*.aif, *.aiff)
• FLAC (*.flac)
• OGG (*.ogg)
• WMA (*.wma)
• M4A (*.m4a)

兼容性

• After Effects CC 2017+ (版本 >= 14.0)
• Premiere Pro CC 2018+ (版本 >= 12.0)
• Windows
• macOS (CEP 6.0 兼容)

技术架构

• 前端: HTML5 + CSS3 + Vanilla JavaScript (ES5 兼容)
• 宿主通信: Adobe CEP 6.0 (CSInterface)
• 后端逻辑: ExtendScript (Adobe 脚本引擎)
• 数据存储: localStorage (元数据) + 文件系统 (音频文件)
• 音频播放: HTML5 Audio API

更新日志

v1.0.0

• 初始版本
• 10 大音效分类 + 智能自动分类
• 内置音频播放器（播放/暂停/快进/音量）
• AE / PR 双宿主支持
• 音效导入、预览、应用、导出完整流程
• 收藏管理 + 详情编辑
• 暗色 Adobe 风格 UI