字段管理与可见性
启用模型包后，字段就出现在内容编辑页——但具体在哪、给谁看、能不能改顺序？本节讲清楚。
字段在哪里出现
Section titled “字段在哪里出现”两个维度决定字段的可见性：
- 内容类型：字段绑定到哪类内容（产品 / 文章 / 页面 / 下载 / 分类 / 菜单）
- 分组：字段在编辑页哪个折叠面板下
举例：
模型包「工业设备字段」├─ 字段：型号 → 绑定 Product → 分组「基本信息」├─ 字段：规格表 → 绑定 Product → 分组「技术参数」├─ 字段：操作视频 → 绑定 Product → 分组「多媒体」└─ 字段：行业证书 → 绑定 Product → 分组「认证资质」前台：
- 进产品编辑页 → 看到这 4 个字段，分布在 4 个分组里
- 进文章编辑页 → 看不到这些字段（绑定的是产品，不是文章）
待补充截图 产品编辑页右侧或下方的几个折叠面板，每个面板含若干扩展字段
调整字段顺序 / 分组
Section titled “调整字段顺序 / 分组”字段定义来自 manifest——运营只能调展示属性：
- ✅ 字段在分组内的顺序
- ✅ 分组的显示 / 折叠默认状态
- ✅ 字段是否可见（不删，只暂时隐藏）
- ❌ 不能改字段类型（让开发者改）
- ❌ 不能改字段的验证规则（同上）
- ❌ 不能改
field_key（同上）
入口：「扩展市场 → 模型包」 → 点该模型包 → 字段管理 Tab
待补充截图 左侧字段列表（拖拽调顺序）+ 右侧选中字段的属性面板（可见性 / 默认值 / 帮助文本等）
每个字段在后台展示属性可调：
| 属性 | 作用 |
|---|---|
| 是否在编辑页显示 | 暂时隐藏字段（数据保留） |
| 是否在列表页显示 | 在内容列表（产品 / 文章列表）里显示该列 |
| 是否在前台显示 | 主题渲染时是否输出（取决于主题实现） |
| 帮助文本 | 字段下方的小灰字说明 |
| 占位文字 | 输入框里的灰字提示 |
| 默认值 | 新内容的初始值（已有内容不变） |
| 是否多语言独立 | 配是否随语言切换 |
按角色控制可见性
Section titled “按角色控制可见性”某些字段只想给特定角色看 / 改（如”内部成本”字段只给管理员）：
| 角色配置 | 含义 |
|---|---|
| 所有人可见 | 默认 |
| 仅管理员可见 | 内容编辑 / 普通运营看不到 |
| 管理员可改 / 编辑可看 | 部分角色只读 |
| 仅特定权限组 | 自定义权限映射 |
模型包的字段通常已经预设好分组（来自 manifest），但你可以：
- 改分组的显示名（不改 key）
- 调整分组的展开 / 折叠默认状态
- 改分组的顺序（哪组在前哪组在后）
- 不能新建 / 删除分组（让开发者改 manifest）
模型包里的某些字段自动支持多语言（manifest 里声明 localizable: true）：
- 中英文 Tab 各自填
- 中文版填了，英文版空着 → 前台英文站显示默认语言值（fallback）
- 详见 多语言总览
非多语言字段（如 cost_price 内部成本）只填一份，所有语言版本共享。
字段在 manifest 里声明的校验规则自动生效：
| 校验类型 | 例子 |
|---|---|
| 必填 | 没填 → 保存报错”该字段必填” |
| 最小长度 / 最大长度 | 文本字段 |
| 正则匹配 | 邮箱、电话、URL |
| 数字范围 | min / max |
| 文件大小 / 类型 | 受 上传策略 进一步限制 |
校验失败时保存被阻止——并提示具体哪个字段哪条规则不过。
字段值的存取
Section titled “字段值的存取”存：
- 字段值存在数据库的扩展存储（
ContentExtensionValue表） - 跟内容主表（
Product/Article）通过contentId + fieldId关联 - 多语言字段有
languageCode维度
取：
- 后台编辑页：自动加载所有字段值
- 前台主题：通过主题代码读取（详见主题开发文档）
- API：
/products/:id/extension-values（详见开发者文档）
运营不需要直接接触存储细节——字段值在编辑页填、在前台展示，自动衔接。
删字段（卸载模型包）
Section titled “删字段（卸载模型包）”前面提过：归档卸载 vs 彻底删除。
详见 安装与启用 - 卸载第三方模型包。
何时调字段管理
Section titled “何时调字段管理”| 时机 | 调什么 |
|---|---|
| 新装模型包 | 调字段顺序、分组顺序、默认折叠状态 |
| 运营反馈”字段太多” | 隐藏非核心字段、合并分组 |
| 新角色上线 | 配字段的角色可见性 |
| 业务流程变化 | 改默认值、改帮助文本 |
我能”暂时隐藏”某个字段吗？
Section titled “我能”暂时隐藏”某个字段吗？”可以——「字段管理」里把”是否在编辑页显示”关掉。
特点：
- 字段从编辑页消失
- 已录入的数据保留（数据库里）
- 重新打开 → 字段回来 + 数据回来
适合：
- 字段暂时不用（业务调整）
- 准备废弃但还没决定（先隐藏观察）
我能改字段的”必填 / 选填”属性吗？
Section titled “我能改字段的”必填 / 选填”属性吗？”通常不能——这是 manifest 里的硬性规则，运营改不了。
如果业务要求”原本选填改成必填”，让开发者出新版包。
字段顺序改了，前台主题会跟着变吗？
Section titled “字段顺序改了，前台主题会跟着变吗？”不会——前台主题用自己的渲染顺序，跟后台字段的”输入顺序”无关。
如果你想前台调字段顺序，让主题开发者改主题代码。
扩展字段能用在内容列表（如产品列表）当筛选条件吗？
Section titled “扩展字段能用在内容列表（如产品列表）当筛选条件吗？”取决于主题与系统能力——多数模型包字段仅用于详情页展示，不进入列表筛选。
如果业务需要”按扩展字段筛选”（如”按 ISO 认证类型筛选产品”），需要：
- 主题开发者实现该筛选 UI
- 后台 API 支持该字段的筛选查询
详见 开发者 章节（建设中）。
字段值能批量导入吗？
Section titled “字段值能批量导入吗？”当前后台不支持 UI 批量导入——但可以让运维：
- 编写 SQL 脚本批量更新
- 或用 API 批量调用（详见 开发者）