查看“︁Ardour/Working-with-plugins/Plugin-manager”︁的源代码

'''Plugin Manager''' 提供操作 plugins 的便捷界面，是 plugins 出问题时的主要排查工具。它同时操作 plugin files 与 plugins index。

## Plugins Index 是什么？
每种 plugin 类型（如 VST3、AU）都有预配置的路径来存放这些 plugins。每次 Ardour 运行时，它会重新扫描这些路径中的 plugins 并重建一个 index——即可用 plugins 的清单。打开 [[Ardour/Working-with-plugins/Plugin-selector|Plugin Selector]] 对话框时，Ardour 从该 index 读取可用 plugins 列表供选择。

重新扫描路径很重要，因为 plugins 经常在磁盘上变化（如安装了更新版本）或被移除。有时 plugins 还会因硬件故障损坏。频繁索引有助于尽早发现问题，Plugin Manager 也便于审查 plugins 的整体状态。Ardour 对 LV2 plugins 稍有不同处理：启动时无条件扫描。VST2、VST3 与 AU plugins 的扫描可在 *Preferences* 对话框中完全禁用。

## Plugins Info
Plugin Manager 窗口主体是一个列出所有已知 plugins 的表格，既可查看 plugin 信息也可控制其部分属性：

* '''Status'''：每个 plugin file 的状态（见下）
* '''Ign'''：完全不加载此 plugin file
* '''Fav'''：设置或取消 plugin 的 Favorite 状态
* '''Hide'''：加载此 plugin file，但不显示在 Plugin Selector 中
* '''Type'''：plugin 使用的 API：VST2、VST3、AU、LADSPA、LV2
* '''File/ID'''：LADSPA/VST2/VST3 显示文件名，LV2/AU 显示 ID
* '''Name'''：用户可见的 plugin 名称
* '''Creator'''：plugin 开发者或团队
* '''Tags'''：按类型分类的 metadata，如 `instrument|synth` 或 `analyzer`

'''Status''' 字段的具体选项：

* '''OK'''：plugin file 加载无误，缓存信息最新
* '''New'''：plugin file 刚被发现且首次成功加载
* '''Updated'''：plugin file 在磁盘上变化，plugin cache 已相应更新并成功加载
* '''Concealed'''：若存在对应的 VST3，则 VST2 plugin 会从 Plugin Selector 隐藏。LV1 (LADSPA) 与 LV2 同理
* '''Error'''：plugin file 加载时出现问题
* '''Stale'''：plugin 在磁盘上变化但 Ardour 尚未重新扫描
* '''Incompatible'''：扫描失败，典型原因是 32/64-bit 不匹配，或在 Linux 上加载 .dll、在 Windows 上加载 .dylib

sidebar 中的 *Plugin Count* 部分提供可用 plugins 的基本信息：所有受支持类型各有多少、多少加载失败、多少缺失。

## Searching
把光标放到左上角输入框内即可搜索特定 plugin 或一组 plugins，Ardour 在 index 中搜索。默认搜索 plugin 名称、maker 与文件名，还可按 Type、Tags、Paths 搜索。

## Scan Actions
sidebar 此部分包含操作 plugins index 的命令：

* '''Discover New/Updated'''：对所有受支持类型的所有已知 plugin 路径执行完整扫描
* '''Update Index Only'''：检查哪些 plugins 已更新，但不扫描
* '''Re-scan Selected'''：重新扫描窗口主体中已选中的 plugin files
* '''Re-scan Faulty'''：仅重新扫描此前加载失败的 plugins
* '''Re-scan All'''：重新扫描所有已知 plugins
* '''Clear Staled Scan Log'''：移除 index 中所有已变化但尚未重新扫描的 plugin 条目

## Preferences
sidebar 此部分可设置 VST2 与 VST3 plugins 的路径，也可快速打开 *Preferences* 对话框的 *Plugins* 页面，在其中设置扫描 plugins 与默认行为的各项选项。

== 相关页面 ==
* [[Ardour/Working-with-plugins|Working-with-plugins]]
* [[Ardour/Working-with-plugins/Plugin-selector|Plugin-selector]]
* [[Ardour/Term List|Term List]]