插件管理
本机插件是什么
普通安装不自带插件。“设置 → 本机插件”用于查看已安装包的名称、版本、状态,管理启停及插件提供的设置。插件具有与 GGEA 相同的本机权限,依赖隔离不是安全沙箱,只安装可信来源。
当前没有在线插件市场、自动下载、签名认证或热加载;插件包由其发行者提供。插件自己的游戏操作不等同于助手的普通设置,应另外核对其用途与资源消耗。
安装与启用
- 退出 GGEA,将完整插件包解压到程序目录的
plugins/<id>/。目录名必须与plugin.json中的id一致,保留 DLL、依赖和资源,避免多套一层文件夹。 - 启动助手,打开“设置 → 本机插件”,查看名称、版本和状态。
- 勾选要启用的插件并保存,退出并重新启动后加载。仅勾选而未保存或未重启不会完成启用。
未启用的插件只读取清单,不执行初始化。每次启动会检查插件 API 和最低宿主版本;不兼容或缺失的插件不会被当作正常插件加载。
设置、停用与卸载
- 插件设置:已加载且提供设置编辑器的插件会在设置中显示自己的选项。保存才调用插件的保存逻辑,取消不保存草稿。
- 停用:取消插件勾选、保存并重启。
- 更新:退出助手后替换对应的完整插件目录,再启动检查状态。不要在运行中覆盖 DLL。
- 卸载:先停用并正常退出,再删除对应插件目录。插件配置独立保存,删除包目录不等于清除其配置。
多个插件设置依次独立保存。若后面的插件保存失败,前面已保存的设置可能已经生效;请按错误提示逐项核对,不要假定整个设置窗口全部回滚。
配置与主程序更新
插件配置位于 config/plugins/<id>/settings.json,启用列表位于 config/plugins/enabled.json。更新插件前备份其配置,不用新插件包覆盖已有设置。
主程序更新保留已有插件与配置,新生成的普通安装包不携带你的插件。启用列表损坏时不会自动变成全部启用;请查看日志和设置中的实际状态。
插件无法加载或设备被阻止
先检查目录结构、版本兼容性与日志。插件初始化、设备回调或清理失败可能阻止后续设备操作;请在设置中停用并重启,确认停止完成后再执行任务。不能将插件失败理解为助手已安全忽略它。
开发协议与示例见桌面源码仓库的 插件开发与使用。