1. 安装与启用模型包
上传 .zip 包 / 启用 / 停用 / 卸载
模型包总览
「模型包」是 BangNiCMS 给内容模型做扩展的标准方式——把一组相关的字段、分组、视图打包成可安装的”包”。
后台入口：扩展市场 → 模型包 Tab
待补充截图 网格式展示所有模型包：每张卡片含名称 / 版本 / 描述 / 状态 / 安装/启用按钮
为什么需要模型包
Section titled “为什么需要模型包”回顾一下：内容模型扩展 让你给产品 / 文章追加字段（如给产品加”型号”、“规格”）。
模型包则是多个字段的成套打包：
模型包"工业设备字段"包含：- 型号字段（短文本）- 规格表（多行富文本）- 应用场景（标签多选）- 技术参数（结构化 JSON）- 认证证书（多文件上传）- 操作视频（视频字段）一次性打包安装 → 你的产品立刻多了 6 个字段，分组好、排版好、翻译好。
优势：
- ✅ 复用：开发一次，多个站点用
- ✅ 标准化：行业通用字段统一
- ✅ 升级：开发者出新版本，运营一键升级
- ✅ 回滚：卸载即恢复（数据保留可恢复）
模型包 vs 单字段扩展
Section titled “模型包 vs 单字段扩展”| 维度 | 单字段扩展 | 模型包 |
|---|---|---|
| 范围 | 1 个字段 | 多个字段（通常 5-20 个） |
| 来源 | 后台直接添加 | 上传 .zip 包安装 |
| 配置成本 | 低（添加即用） | 中（要先装包） |
| 复用 | 同一个字段不能跨站复用 | 包可以分发到多站点 |
| 升级 | 手动改 | 上传新版包，自动迁移 |
| 典型场景 | 临时加 1-2 个字段 | 行业标准字段成套引入 |
BangNiCMS 自带几个通用模型包：
| 模型包 | 适用 | 包含字段 |
|---|---|---|
| 基础 SEO | 所有内容类型 | meta_title / meta_description / og_image |
| B2B 询盘 | 产品 / 文章 | inquiry_button_text / inquiry_target_email |
| 多媒体增强 | 产品 / 文章 / 页面 | gallery / video_embed / audio |
| 行业标签 | 产品 / 文章 | industry_tags / region_tags |
特点：
- 默认未启用 → 你按需启用
- 可禁用 / 卸载（与第三方包对等）
- 官方维护
第三方模型包
Section titled “第三方模型包”社区 / 开发者打包的模型包，通常面向特定行业：
- 工业设备站（型号、规格、CAD 文件、认证）
- 美妆电商（成分、肤质、香调、容量）
- 旅游平台（行程、住宿、签证、保险）
- 金融服务（产品类型、风险等级、收益、起投）
- 房产（户型、面积、楼层、配套）
当前 BangNiCMS 还没有官方模型包市场——你可以：
- 联系官方索取行业模型包
- 让开发者按你的业务定制
- 等模型包市场上线
模型包的状态
Section titled “模型包的状态”跟主题 / 插件类似：
| 状态 | 含义 |
|---|---|
| 可用 | 已上传但未启用 |
| 已启用 | 包内字段在内容编辑页生效 |
| 已停用 | 装了但字段不显示 |
| 内置 | 系统自带 |
多个模型包可以同时启用——它们的字段会合并到目标内容类型上。
模型包卸载的两种模式
Section titled “模型包卸载的两种模式”跟单字段扩展一样：
- 归档卸载（默认推荐）—— 字段定义和已录入的数据保留，重装恢复
- 彻底删除 —— 字段定义 + 数据全删，无法恢复
2. 字段管理与可见性
启用包后字段在哪生效、按内容类型过滤、按角色控制
3. 模型包升级与版本
新版本上线 / 数据迁移 / 回滚操作
4. 何时该开发新模型包
给开发者的需求触发条件 + 何时该考虑做新包
模型包 vs 主题 vs 插件
Section titled “模型包 vs 主题 vs 插件”三者的协作关系：
主题（决定外观） └─ Slot（主题预留挂载点） └─ 插件（填充具体功能模块）
模型包（决定内容字段） └─ 字段定义 └─ 字段值（每条内容里）举例：
- 用一个 B2B 主题（决定整站视觉）
- 装”首页轮播图”插件（首页 hero 用插件，挂到
homepage-heroslot） - 装”工业设备字段”模型包（产品多了型号 / 规格等字段）
三者各自独立，又互相协作。
一个产品能同时受多个模型包影响吗？
Section titled “一个产品能同时受多个模型包影响吗？”可以——多个模型包启用时，它们的字段会合并到同一个产品的编辑页。
举例：
- 启用模型包 A（基础 SEO）→ 产品编辑页多 SEO 字段
- 同时启用模型包 B（B2B 询盘）→ 产品编辑页又多了询盘字段
- 这两组字段同时显示，互不干扰
模型包字段在前台主题里怎么显示？
Section titled “模型包字段在前台主题里怎么显示？”取决于主题是否实现了对应的渲染：
- 主题主动支持该模型包：在前台对应位置显示该字段值
- 主题不知道这个模型包：字段值只在后台可见，前台不显示
主题与模型包解耦——主题不关心你装了哪些模型包；模型包不关心你用哪个主题。需要前台展示时，让主题开发者对该模型包字段做渲染适配。
模型包能跨站点共享配置吗？
Section titled “模型包能跨站点共享配置吗？”可以——模型包就是为了”复用”设计的。
把同一个 .zip 安装到多个站点 → 每个站点的产品都自动多了那些字段。
装了模型包但字段没出现？
Section titled “装了模型包但字段没出现？”排查：
- 模型包是否启用？
- 模型包的字段是绑定到哪个内容类型的？（如只绑定产品，那文章里看不到）
- 浏览器缓存？硬刷新