本文介绍行业包的安装、整包升级、回滚和整体卸载操作。平台定位、包来源与兼容性规则见《插件化是什么》。

说明：本文截图提取自用户手册，用于说明操作位置。部分截图沿用旧版包类型名称、按钮及提示文案，包类型、操作规则和提示信息以正文说明为准。

---

首次安装官方行业包

前置条件：已获取官方行业包安装文件；当前插件化底座版本满足包要求。

1. 进入 插件化管理 → 行业包管理。未安装时点击「上传插件包」。

2. 选择官方行业包文件，系统开始校验：格式、完整性、签名、包版本、最低底座版本及已知兼容性例外。

   • 校验失败：页面提示「行业包校验未通过，无法继续安装或升级」，按失败原因处理后重新上传；此时不会创建安装任务。

3. 校验通过后确认包类型为「官方行业包」，点击「进入安装向导」。

4. 按向导完成配置：

   步骤	操作	注意事项
   ① 选择行业包	勾选本项目需要的行业能力	未选择时无法进入下一步
   ② 配置偏好	按项目需要对所选行业能力进行配置	重复能力合并去重，只安装一次
   ③ 确认清单	核对本次安装的能力清单和待配置项	存在阻断项时需先按修复说明处理
   ④ 加载行业包	等待全部加载与健康检查	全部成功后一次性生效

   选择行业包：

   

   选择需要启用的能力并配置偏好：

   

5. 安装完成后，已安装列表展示包类型、包版本和底座满足状态。

   

安全退出：加载成功前所有修改均为草稿。配置期间可前后返回；退出需二次确认并丢弃草稿，当前运行配置不受影响。首次安装不创建回滚快照。

---

安装生态行业包

前置条件：已获取生态开发者交付的生态行业包文件。

1. 点击「上传插件包」，选择生态行业包文件，等待校验。

2. 校验通过后，页面显示「生态行业包」及提示「该生态行业包已完成定制，将安装包内全部内容。」

   

3. 查看全量安装清单和资源影响。清单内全部内容默认选中且不可反选，不进入逐项配置向导。

4. 点击「立即开始安装」，等待加载与健康检查完成后一次性生效。

说明：若包内容不能完整安装，系统会阻断并说明原因。

---

整包升级

前置条件：已安装行业包；已获取目标版本包（版本必须高于当前版本）。

1. 在已安装行业包页点击「升级」，弹出上传窗口。
2. 上传目标版本包，等待格式、版本、包类型和兼容性校验。
   • 校验被拒绝（格式错误、版本低于或等于当前版本、底座不满足等）：页面显示明确失败原因，已安装配置不变，不创建快照。
3. 校验通过后按包类型进入后续路径：

   • 官方行业包：点击「进入升级向导」。已安装能力默认选中且锁定（「已安装能力将随整包升级，不可取消。」），新版本新增能力可选择安装或不安装。

     

   • 生态行业包：显示全量清单（全部默认选中且不可反选），点击「立即开始安装」。

4. 确认能力清单并开始升级。系统先自动备份当前运行版本（提示「正在备份当前版本。」），随后进入加载阶段。
5. 全部加载与健康检查成功后，新版本和能力配置一次性生效；已安装列表展示新版本。
6. 若升级失败或中途退出：目标版本不提交，原包版本、已安装能力和工作台保持不变。提示：「升级失败，当前已安装版本和能力未发生变化。」

---

回滚到历史版本

适用场景：升级后出现问题，需要恢复到升级前的版本。

1. 在已安装行业包页打开回滚入口，查看当前版本及最多 1 条可回滚的历史快照。

2. 选择目标快照，系统二次确认：「回滚以后会丢失从上次升级以后的所有变更，确定进行回滚吗？」

   

3. 确认后执行回滚。执行中版本不会提前改变。

4. 回滚完成后停留在结果页，点击「继续」返回已安装行业包页，查看恢复后的版本。

注意：回滚本身不新增快照；回滚会丢失上次升级以后的所有变更，请谨慎操作。

---

整体卸载

⚠️ 这是破坏性操作：卸载作用于当前全部已安装行业包，不支持单包卸载，完成后无法通过行业包管理恢复。

1. 在已安装行业包页工具栏点击「卸载」。

2. 阅读不可恢复提示：「卸载将删除全部行业包、能力模块、数据库、存储桶和回滚快照，完成后无法通过行业包管理恢复。确定继续吗？」

   

3. 二次确认后，系统按阶段清理：插件文件 → 数据库 → 存储桶 → 快照 → 残留资源。

4. 全部阶段完成后才标记卸载成功，页面回到未安装空状态，回滚列表清空。

5. 若某一阶段失败：页面展示已完成 / 未完成清单、失败原因，支持重试或人工处置；系统不会误报成功。

---

开启开发者模式调试插件（面向生态开发者）

说明：开发者模式将在下一个版本提供，本版本暂不开放。

适用对象：行业生态开发者。普通业务用户无需开启。

1. 在行业工作台右上角打开开发者模式开关。
2. 阅读用途说明并二次确认：「开启以后，本页面会展示详细的插件调试内容，仅面向开发者，如果非生态开发者，无需启用本页面。」
3. 确认后，能力包底部默认展开插件列表，每条插件展示：
   • 插件类型（前端 / 后端 / 其他）
   • 插件 ID
   • 插件版本
   • 启用 / 禁用状态及对应启停操作
4. 按需启用或禁用插件进行调试；插件启停结果会记录并刷新状态。
5. 调试完成后关闭开发者模式，页面恢复普通模式。

---

常见提示信息速查

提示信息	含义	处理方式
「所需最低插件化版本 1.0，当前插件化版本满足」	底座版本满足要求	可继续安装 / 升级
「当前插件化底座版本不满足该插件包要求，请先升级底座。」	底座版本低于包要求	先升级插件化底座，再安装插件包
「当前司空与该插件版本存在兼容性风险，请根据项目兼容性结论处理后再继续。」	命中已知司空兼容性例外	按项目兼容性结论处置后再继续
「行业包校验未通过，无法继续安装或升级。」	格式 / 完整性 / 签名 / 版本校验失败	按失败原因修复后重新上传
「已安装能力将随整包升级，不可取消。」	官方包升级时已安装能力锁定	如需调整已安装能力，请联系官方支持
「生态行业包内容将全部安装。」	生态包全量安装	确认清单后直接安装
「升级失败，当前已安装版本和能力未发生变化。」	升级失败，原版本保留	根据失败阶段提示修复后重试
「卸载将删除全部行业包……确定继续吗？」	整体卸载二次确认	确认前请确认不再需要任何已装数据