本页目录
全部文档
插件使用
插件是为 SeatFlow 增加额外功能的扩展包，由社区或第三方开发者制作。你可以把它理解为手机的 App——安装后就能获得新的功能。(WIP 插件功能仍在开发中，此页文档不作任何引导)
[截图：插件管理页面概览]
什么是插件？
简单来说，插件就是别人写好的排座规则。
SeatFlow 自带了 7 种内置排座策略（如固定座位、同桌分组等）。如果你有特殊的排座需求（比如：按视力排座、按班干部职责排座），可以通过安装插件来实现，无需等待软件更新。
插件文件以 .ap-plugin 为扩展名（例如 视力排座插件.ap-plugin）。
插件由第三方开发：请确认插件的来源可信后再安装。
如何获取插件
插件文件（.ap-plugin）可以通过以下途径获取：
- 官方网站：访问 SeatFlow 插件市场 下载
- 学校或同事分享：其他教师制作的排座插件
- 自行开发：如果你会编程，可以按照 插件 SDK 文档 开发自己的插件
安装插件
SeatFlow 提供了两种插件安装方式。
方式一：通过插件管理页面导入
- 点击左侧导航栏的「插件管理」
- 将
.ap-plugin文件拖放到页面区域，或点击「导入插件」按钮选择文件 - 确认导入后，插件会自动安装并出现在列表中
方式二：手动放置后刷新
你也可以直接将插件文件放入 SeatFlow 的插件目录：
- 在「设置」页面点击「打开数据目录」
- 找到或创建
Plugins文件夹 - 将
.ap-plugin文件复制到该文件夹 - 返回「插件管理」页面，点击「刷新」
[截图：将插件文件放入 Plugins 文件夹]
提示：安装后如果插件未立即显示，请点击「刷新」按钮重新扫描插件目录。
查看已安装的插件
- 点击左侧导航栏的「插件管理」
- 页面左侧会列出所有已安装的插件（按优先级排序）
- 每个插件显示：名称、版本号、加载类型
- 点击某个插件，右侧会显示详细信息
插件详情
选中插件后，右侧面板会显示：
- 名称：插件名称
- 版本：插件版本号
- 作者：开发者信息
- 描述：插件功能介绍
- 优先级：排座时的执行顺序（数值越大越先执行）
- 启用/禁用开关：控制插件是否参与排座
[截图：插件详情面板]
启用和禁用插件
每个插件都可以独立控制是否启用：
- 在「插件管理」页面点击一个插件
- 在右侧详情面板中找到「启用/禁用」开关
- 点击开关切换状态：
- 启用（绿色）：插件的排座规则会在生成排座时执行
- 禁用（灰色）：插件不参与排座，但保留其配置
为什么禁用一个插件？ 如果你暂时不需要某个规则，但又不想删除它，可以先禁用。后续需要时再启用即可。
插件配置
某些插件允许你修改配置参数：
- 选中已安装的插件
- 在右侧详情面板下方找到「配置 JSON」编辑框
- 按照插件说明修改配置内容
- 点击「保存配置」按钮
配置格式必须为 JSON：如果格式错误（如缺少逗号或引号不匹配），保存时会提示错误。请仔细核对插件说明中的配置示例。
卸载插件
不需要某个插件时，可以将其卸载：
- 在「插件管理」页面选中要卸载的插件
- 点击「卸载」按钮
- 确认后，插件文件会被删除，插件将不再显示在列表中
卸载不可恢复：卸载后如需重新使用，需要重新安装插件文件。
插件启用状态（包级管理）
当插件包中包含多个策略时，你可以：
- 整体启用/禁用：在顶部选择插件包名称，通过开关控制包内所有策略
- 单独控制：展开后分别控制每个策略的启用状态
[截图：插件包级别的启用开关]
注意事项
来源可信：插件由第三方开发者制作，请确认插件来源可靠后再安装。不要从未知网站下载插件。
版本兼容：插件是为特定版本的 SeatFlow 开发的。如果更新了 SeatFlow 后发现插件不可用，请检查插件是否有新版本。
排座结果受插件影响：安装并启用的插件会像内置策略一样参与排座。如果排座结果异常，可以尝试禁用新安装的插件后重新排座，排查是哪个插件导致的问题。
排座策略执行顺序
所有策略（内置策略和插件策略）统一按优先级降序排序。优先级数值越大越先执行，与策略是内置还是插件无关。
插件开发者可以在打包时设置优先级。如需调整插件优先级，需要在插件源代码中修改。
常见问题
为什么安装后插件列表中看不到？ 先点击「刷新」按钮，如果仍然没有，请检查插件文件是否放置在正确的目录中，或者插件版本是否与当前 SeatFlow 兼容。
插件导致排座出错怎么办？ 在「策略配置」页面中禁用该插件，然后重新排座。如果问题消失，说明该插件可能与当前环境不兼容。
插件会影响软件性能吗？ 插件在排座时运行，可能会稍微增加排座时间，具体取决于插件的复杂度。正常情况下影响很小。