# 插件使用指南
ASG.Director 拥有灵活的插件系统,允许你通过安装插件来扩展软件的功能。
# 什么是插件?
插件是由社区或开发者制作的小程序,可以:
- 增加新的界面元素(比如新的倒计时皮肤)。
- 添加新的功能(比如自动上传战报)。
- 修改现有行为。
# 安装插件
目前支持两种安装方式:
- 插件商店(推荐):在启动台一键浏览、安装。
- 手动安装:把插件文件夹放到插件目录中(适合内测包/离线分发)。
你可以在文档图片目录放截图:
vuepress-docs/.vuepress/public/images/,然后在文档里用引用。
# 方式一:插件商店(推荐)
- 打开 启动台(主窗口)。
- 点击 “插件商店”。
- 选择插件并安装。
- 安装完成后,通常无需重启;如果插件提示需要重载/重启,按提示操作即可。
(可选)你可以放一张截图:

# 方式二:手动安装(Windows)
- 获取插件包(通常是一个文件夹)。
- 按下
Win + R键,输入%APPDATA%\asg-director\plugins并回车。- 如果文件夹不存在,请手动创建它。
- 将插件文件夹复制到打开的目录中。
- 重启 ASG.Director。
# 方式二:手动安装(macOS)
- 打开 Finder。
- 前往
~/Library/Application Support/asg-director/plugins。 - 将插件文件夹放入其中。
- 重启软件。
# 启用与管理
插件管理器已经内置在 ASG.Director 中:
- 打开 启动台(主窗口)。
- 点击 “插件管理” 进入插件管理器。
在插件管理器里,你通常可以完成:
- 启用/禁用:用于临时关闭某个插件(排查冲突也很有用)。
- 重载插件:开发/调试时无需重启主程序即可加载新代码。
- 查看/修改插件设置:若插件提供设置项,会在此处展示并可保存。
- 查看并执行插件命令:部分插件会注册命令供按钮/菜单/快捷入口调用。
(可选)你可以放一张截图:

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