4.2 插件系统：装上与卸下

4.2 插件系统：装上与卸下

本节摘要：插件管理器背后是一条完整的生命周期线：获取、安装、启用、停用、升级、卸载，每个环节各动各的东西。本节把生命周期拆到机制层，讲清启停语义、数据去留、商业与社区插件的取舍，帮你把「装插件」从点按钮升级为有章法的运维动作。

4.1 看完骨架，这一节看零件怎么换。插件管理器你在 1.3 已经打开过，当时关注的是「有什么」，现在关注「动了它会发生什么」——后者才是车间安全的要害。

一、插件的一生

一个插件从进入实例到离开，走六站。获取：从插件市场或私有仓库拿到插件包。安装：包落盘，清单被内核读取，依赖被校验——缺依赖时安装直接失败并给出缺失清单。启用：内核加载插件代码，执行迁移脚本（建表、加字段），注册资源与组件，界面随之出现新配置项。停用：反向操作——代码不再加载、资源与组件注销，但数据不删，插件建的表原样保留。升级：新包替换旧包，差异迁移脚本执行，前后版本的数据结构平稳演进。卸载：从实例中移除插件本体，是否连带删数据由卸载选项决定，默认保守。

生命周期里最值得刻进脑子的是「停用不删数据」。这意味着试错成本极低：任何插件都可以停用观察，界面回到从前，数据原地不动，随时再启用回来。也意味着另一件事：停用一堆不再用的插件后，它们的表还躺在库里——定期做「卸载」清理，别让插件坟场占用备份窗口。

二、启停语义的三张底牌

第一张底牌：启用是「代码加迁移」的原子动作。迁移脚本失败时启用回滚，不会出现「表建了一半」的状态——这也是升级必须走插件机制而不能手动改库的原因。第二张底牌：界面选项随启停增减。启用插件后，配置面板、新建字段类型列表、区块类型列表都会长出新条目；停用后这些条目消失，但已经用了这些组件的页面会显示「组件缺失」的占位——所以停用前先盘点有没有页面在用它。第三张底牌：商业插件校验许可证，过期或迁移授权时整个插件停摆，涉及核心业务的商业插件要把许可证续期纳入运维日历。

把三张底牌用成一个操作规程：

插件启停操作规程（生产实例）：
  1. 装前：核对插件版本与实例版本的兼容区间，读更新日志
  2. 装时：先在测试实例装并试运转，记录它新建了哪些表
  3. 启用：选业务低峰，启用后把核心页面挨个点一遍
  4. 停用：先全站搜「组件缺失」风险（哪些页面用了它的区块或字段）
  5. 升级：备份数据库 → 升级 → 检查迁移日志有无警告
  6. 清理：确认不再回头的插件执行卸载，回收存储
​

三、货架分区：商业、官方与社区

插件货架的三个分区各有性格。官方商业插件由平台团队维护，质量与兼容性有保障，适合审批、数据可视化这类核心业务件，成本是许可证费。官方免费插件覆盖大多数通用需求，随版本同步演进，是默认首选。社区插件百花齐放，捡漏常有意外的惊喜，但维护活跃度参差——判据三看：最近提交时间、开放问题的响应速度、版本兼容声明是否跟进。三条里有一条不过，就只装在非关键链路。

还有一个容易忽略的分区：你自己写的插件。4.3 会完整走一遍开发流程。从生命周期管理看，自研插件与外来插件走完全相同的六站——这也是框架级平台的好处：你的扩展件与官方件享受同等的启停、升级与备份待遇。

四、版本策略：跟多紧是个问题

平台版本升级会带动插件生态整体换代，于是有了「跟多紧」的问题。现场经验是双轨制：生产实例落后稳定版一到两个小版本，等生态插件普遍声明兼容后再升；试验实例紧跟新版，提前踩坑。升级窗口与插件兼容核对联动——第 5 章会把这套节奏展开成完整的升级工序，本节先记住原则：实例的版本决策要跟插件货架联动做，不要单方面抢跑。

⚠️ 常见坑：卸载插件时勾了「同时删除数据」。某个试装过的插件被随手卸载清理，三个月后才发现某个页面引用的数据源没了。规程化的说法是：卸载动作只允许出现在「确认无数据价值」的清单核对之后。

💡 关键直觉：插件管理的成熟度标志，是团队有一份「插件台账」——装了什么、为什么装、谁申请的、数据落在哪。台账在，试错的每一步都有人认账。

深入一格：插件台账的样子

4.2 反复说的台账，落到底就是一张表。给一份可抄的台账样例，字段不多，条条有用：

插件台账（团队共享文档，随装随记）：
  插件名：approval（审批）
  分区：官方商业    版本：1.x    许可证：有效期至年底，续期责任人：运维甲
  为什么装：行政部请假与报销审批（工单 2024-018）
  数据落点：自建两张表，附件目录新增子目录
  兼容核对：当前实例版本兼容，4.2 三看通过
  上次升级：x 月 x 日，迁移日志无警告
  停用预案：请假流程依赖它，停用前须先下线流程
​

台账的精髓在「停用预案」这一栏：装的时候写下怎么退，退的时候就不用临场发明。许可证责任人一栏同样关键——商业插件停摆最常见的剧本不是技术故障，而是许可证过期无人记得续。把这些散落在各人脑子里的信息固化成一行行记录，插件管理就从个人记忆升级为团队机制，这正是本节标题里「装上与卸下」背后真正的手艺。

试装清单：装任何插件前的五个动作

把装前核对压缩成五个动作，两分钟完成，换来的是极低的返工率：

试装五动作：
  1. 看兼容声明：插件版本区间是否覆盖实例版本
  2. 看最近更新：超过半年未动的社区件，只进非关键链路
  3. 看数据落点：它建哪些表、写哪个目录，记进台账
  4. 看退出口径：停用后界面会不会缺组件，哪些页面受影响
  5. 看许可证：商业件的有效期与授权范围，责任人落名
​

五个动作里第四个最容易被跳过，也最容易咬人：停用一个插件之前，先想清楚哪些页面正在用它的区块与字段——占了坑再拔桩，页面上的窟窿就是用户眼里的「系统坏了」。装与卸从来不是孤立的按钮，是一条有来路有去路的完整工序。

装配要点回顾

• 六站生命周期：获取、安装、启用、停用、升级、卸载，各站动的东西不同；
• 停用不删数据：试错成本低，但也要求定期清理插件坟场；
• 三张底牌：启用原子性、界面随启停增减、商业插件看许可证——启停规程由这三张牌推出；
• 分区性格：商业件稳妥收费、官方免费件默认首选、社区件三看再装；
• 双轨版本：生产落后一两个小版本，试验抢先踩坑，与插件兼容性联动决策；
• 下一步：4.3 进车间动手，从脚手架开始造第一枚自己的零件。