技能：Audition 自动化 (Audition Automation)

name: Audition Automation id: audition-automation description: Adobe Audition 通用自动化工具包 trigger: /setup-lab, 自动化构建, 初始化环境, 导入素材, 创建轨道

← 来源: .agent/manifest.json → skills[id="audition-automation"]

概述

核心架构：工具包 (Toolkit)

本技能的核心不再是脚本，而是 Lib。所有的能力都封装在 stateless 的 .jsx 库中。

Audition.jsx

原子能力库，提供以下命名空间：

• •Audition.IO
  • •importFile(path): 智能兼容导入 (Smart Import)。
    • •Audition 2024+: 自动检测并使用 new DocumentOpenParameter() 封装路径，解决 Illegal Parameter 错误。
    • •Legacy: 对旧版本保留 app.openDocument(string) 回退。
    • •Nuclear Fix: 对 .sesx 会话文件，若 API 均失败，尝试 OS 级打开。
    • •对音频素材：如果所有策略失败，返回 null 以触发手动导入提示。
• •Audition.Session
  • •findFirst(): 查找首个多轨会话。
  • •openTemplate(path): 打开模板文件。
• •Audition.Track
  • •getOrCreate(session, index): 获取或创建指定索引的轨道。
    • •Safe-Fail: 如果 audioTracks.add() 崩溃 (Audition 2024 Bug)，捕获异常并返回 null。开发逻辑应处理此 null。
  • •setControls(track, mute, solo): 设置轨道状态。
• •Audition.Clip
  • •addToTrack(track, doc, time): 将素材放置到时间轴。
  • •setColor(clip, colorObj): 设置颜色。
• •Audition.Markers
  • •addCycle(session, name, start, duration): 添加循环标记。
• •Audition.State
  • •getOpenDocuments(): 获取当前所有打开文档的列表（包含 Name, Ref, Path, Type）。
  • •closeAll(force): 强制清理工作区。
    • •使用多重回退策略（close, closeDocument, activeDocument 切换）清除所有文档。
    • •force=true 时不保存更改。
• •Audition.Log (New)
  • •sentinel(msg): 静默日志输出。
    • •将 JSON 或字符串写入标准监控文件 logs/sentinel_simple.txt。
    • •配合 fast_run.sh 使用，可实现无弹窗 (no-alert)、无盲目等待 (no-sleep) 的快速执行。

场景构建器 (Universal Lab Builder)

• •定义: lib/Universal_Lab_Builder.jsx
• •角色: Toolkit 的消费者 (Consumer)。
• •用途: 为课程实验提供一个简便的 JSON 驱动的构建方式。它解析 manifest 对象，然后调用 Audition.Key API 执行操作。

🚀 高效调试指南 (Fast Debug Protocol)

为了避免 Alert 弹窗和 Sleep 盲等，请遵循以下开发模式：

1. •脚本输出: 在脚本末尾使用 Audition.Log.sentinel(resultObject) 输出结果。
   javascript

   try {
       // ... logic ...
       Audition.Log.sentinel({status: "success", data: ...});
   } catch(e) {
       Audition.Log.sentinel({status: "error", msg: e.message});
   }
   

2. •快速执行: 使用 fast_run.sh 启动脚本。它会监控日志文件并在写入完成时立即返回。
   bash

   ./fast_run.sh your_script.jsx
   

使用策略 (Manifest-Include)

不要直接运行此目录下的脚本。 这里的代码是库 (Library)，不是可执行文件。

正确的开发流程：

1. •在 docs/course_materials/ 下创建脚本 (例如 Setup_MyLab.jsx)。
2. •引用工具包:
   javascript

   #include "../../../../../.agent/skills/lab-factory/lib/Universal_Lab_Builder.jsx" // 引用构建器
   // 或者
   #include "../../../../../.agent/skills/lab-factory/lib/Audition.jsx" // 直接引用库
   

3. •编写逻辑:
   • •方式 A (推荐): 定义 manifest 对象并调用 UniversalLabBuilder.build(manifest).
   • •方式 B (高级): 直接调用 Audition.IO.importFile(...) 等 API 编写自定义逻辑。

📌 依赖文件

• •lib/Audition.jsx - 核心原子库
• •lib/Universal_Lab_Builder.jsx - 通用场景构建器
• •lib/env_context.jsx - 环境上下文解析
• •lib/time_utils.jsx - 时间单位转换工具

⚠️ 已知局限 (Known Limitations)

基于 Adobe Audition ExtendScript API 的底层特性，本技能包不支持以下操作。请勿尝试编写相关脚本，以免浪费时间。

1. •

   视图控制 (View Control)

   • •❌ 不支持: 切换波形视图 (Waveform) / 频谱视图 (Spectral Display)。
   • •❌ 不支持: 缩放 (Zoom) 或滚动 (Scroll) 视图。
   • •原因: API 未暴露 View 对象或属性。
2. •

   工具交互 (Tool Interaction)

   • •❌ 不支持: 切换鼠标工具 (如 Spot Healing Brush, Razor Tool)。
   • •❌ 不支持: 模拟鼠标点击或涂抹操作。
   • •原因: ExtendScript 仅支持数据层 (Data Layer) 操作，不支持 GUI 模拟。
3. •

   效果器交互 (Interactive Effects)

   • •❌ 不支持: 打开效果器面板并等待用户输入 (如 "Output Noise Only")。
   • •原因: 脚本调用 Effect 时为阻塞式直接执行，无法暂停脚本等待 UI 交互。

🛡️ 鲁棒性协议 (Robustness Protocol)

为了应对 Audition API 的不稳定性，本技能采用 "红绿灯 (Traffic Light)" 降级策略：

最佳实践: 将脚本定位为 "Hybrid Navigator" (混合导航者)。

• •能自动做的（如建轨道、打标记），脚本自动做。
• •做不到的（如复杂 Effect 设置、不稳定的导入），脚本生成"操作指引"，让用户来做。
• •永远不要让脚本在报错中崩溃。