安装与管理插件 ​

插件可以为 HarmoFlow 添加操作面板和图像滤镜。本页介绍如何使用获得的插件文件。如果想自己制作，请参阅制作插件；如需使用开箱即用的色彩校正、色调曲线和渐变映射，请参阅内置调整功能。

首先确认文件类型 ​

即使扩展名同为 .lua，普通脚本和用于插件的扩展也不相同。 作为插件添加的 Lua 文件需要使用 hf.register_panel 注册面板。将普通脚本交给添加界面，并不会生成预期的插件面板。

从添加到启动 ​

1. 打开顶部的“插件 → 添加／浏览插件...”。
2. 点击“添加插件...”，选择获得的 .lua 或 .dll 文件。
3. 文件会被复制到应用的存储位置，并开始加载。Lua 扩展会在绘画及其他正在进行的操作结束后注册。即使已显示添加成功，也请在 Lua 扩展列表中确认注册结果。
4. 再次打开顶部的“插件”菜单，选择已注册的项目。添加与浏览界面用于管理，启动插件则通过插件菜单进行。
5. 在小型测试场景中确认处理结果。如果扩展会添加图层，也请检查图层列表中是否生成了预期内容。

添加的文件会在下次启动时成为加载对象。如果启动菜单中没有对应项目，请参阅无法正常加载时。

当前实现启动时只会按文件名顺序尝试加载前16个Lua文件。运行期间最多可加载32个扩展，但如果希望重启后全部自动加载，请将 extensions/ 目录下的 .lua 文件控制在16个以内。

文件保存在哪里？ ​

通过应用添加时，文件会保存在 HarmoFlow 可执行文件所在目录下的以下文件夹中，不应放在项目文件夹中。

HarmoFlow 可执行文件所在的文件夹/
├─ extensions/
│  └─ my_panel.lua
└─ plugins/
   └─ my_filter.dll

手动放置时也使用相同位置。启动时只会查找各文件夹直接包含的文件。请解压 ZIP，不要将文件放入更深层的子文件夹，并使用小写的 .lua／.dll 扩展名。通过添加界面复制时，扩展名会统一转换为小写。

添加界面不提供覆盖同名文件的操作。如果已经存在同名文件，请使用下面的更新步骤。

更新或删除 ​

1. 保存场景并退出 HarmoFlow。
2. 找到目标文件：Lua 扩展位于 extensions/，DLL 位于 plugins/。
3. 如需更新，先将旧文件备份到其他位置，再替换为新文件。如不再使用，将文件移出对应文件夹。
4. 重新启动 HarmoFlow，确认列表中的加载状态和菜单项目。

应用没有在运行中重新加载、卸载或删除插件的专用操作。再次加载同一个 DLL，或将具有相同面板 ID 的 Lua 扩展改名后重新添加，都不能实现更新。如果将备份以 .dll／.lua 扩展名留在同一文件夹中，启动时也会尝试加载，因此请将备份保存在其他位置。

无法正常加载时 ​

在从其他网站寻找并添加来源不明的 DLL 之前，请先确认发布方列出的要求。报告问题时，请附上 HarmoFlow 和插件的版本、文件名、显示的错误，以及添加时的操作步骤，以便定位原因。

接下来阅读 ​

• 制作插件：Lua 最小示例、DLL 结构与测试
• 内置调整功能：色彩校正、色调曲线与渐变映射
• 偏好设置与 Lua 脚本