# 插件使用指南

ASG.Director 拥有灵活的插件系统,允许你通过安装插件来扩展软件的功能。

新手提示

先把离线模式跑通再折腾插件会更顺:

# 什么是插件?

插件是由社区或开发者制作的小程序,可以:

  • 增加新的界面元素(比如新的倒计时皮肤)。
  • 添加新的功能(比如自动上传战报)。
  • 修改现有行为。

# 安装插件

目前支持两种安装方式:

  1. 插件商店(推荐):在启动台一键浏览、安装。
  2. 手动安装:把插件文件夹放到插件目录中(适合内测包/离线分发)。

你可以在文档图片目录放截图:vuepress-docs/.vuepress/public/images/,然后在文档里用 ![](/images/xxx.png) 引用。

# 方式一:插件商店(推荐)

  1. 打开 启动台(主窗口)
  2. 点击 “插件商店”
  3. 选择插件并安装。
  4. 安装完成后,通常无需重启;如果插件提示需要重载/重启,按提示操作即可。

(可选)你可以放一张截图:

  • ![](/images/plugin-store.png)

# 方式二:手动安装(Windows)

  1. 获取插件包(通常是一个文件夹)。
  2. 按下 Win + R 键,输入 %APPDATA%\asg-director\plugins 并回车。
    • 如果文件夹不存在,请手动创建它。
  3. 将插件文件夹复制到打开的目录中。
  4. 重启 ASG.Director

# 方式二:手动安装(macOS)

  1. 打开 Finder。
  2. 前往 ~/Library/Application Support/asg-director/plugins
  3. 将插件文件夹放入其中。
  4. 重启软件。

# 启用与管理

插件管理器已经内置在 ASG.Director 中:

  1. 打开 启动台(主窗口)
  2. 点击 “插件管理” 进入插件管理器。

在插件管理器里,你通常可以完成:

  • 启用/禁用:用于临时关闭某个插件(排查冲突也很有用)。
  • 重载插件:开发/调试时无需重启主程序即可加载新代码。
  • 查看/修改插件设置:若插件提供设置项,会在此处展示并可保存。
  • 查看并执行插件命令:部分插件会注册命令供按钮/菜单/快捷入口调用。

(可选)你可以放一张截图:

  • ![](/images/plugin-manager.png)

# 常见问题

# 插件安装了但列表里看不到?

  • 先确认插件文件夹是否位于正确目录(Windows:%APPDATA%\asg-director\plugins)。
  • 尝试在插件管理器中点击 重载,或直接重启 ASG.Director。
  • 如果仍然没有,插件可能被加载失败:建议打开开发者工具/日志查看报错(也欢迎把报错贴出来我帮你定位)。