模型管理说明文档
1. 概述
平台采用「平台公共模型 + 个人/团队自定义模型」双层管理架构，支持从不同入口添加模型，实现全平台共享与个人/团队私有模型的隔离管理。本文档统一说明模型的添加入口、配置字段、权限范围与使用规则。
2. 模型添加入口
2.1 平台管理后台（管理员）
- 入口位置：系统管理 → 模型管理 → 模型配置 → 添加模型
- 添加主体：平台管理员
- 生效范围：默认全平台所有用户、所有团队均可使用，开启管控后，根据角色或用户组进行授权使用
- 用途定位：配置平台级公共模型资源，为所有用户提供基础模型能力
2.2 个人/团队空间（普通用户）
- 入口位置：个人/团队空间 → 组件资源 → 模型管理 → 添加模型
- 添加主体：已登录的平台用户
- 生效范围：
- 个人空间：仅创建者本人可用
- 团队空间：仅所属团队空间成员可见、可用
- 用途定位：用户自定义模型、第三方私有模型、团队专属业务模型
3. 新增模型表单字段说明
无论是平台级还是个人/团队级新增模型，均需填写以下核心配置项：
| 字段 | 必填 | 说明 |
|---|---|---|
| 供应商 | ✅ | 模型服务提供方，如 Nuwax、DeepSeek、智谱、OpenAI等，用于快速匹配模型标识；如无可选择自定义 |
| 模型名称 | ✅ | 对外展示名称，支持自定义，便于用户识别 |
| 模型标识 | ✅ | 供应商对应的模型唯一标识，用于接口调用，不可随意修改 |
| 模型介绍 | ✅ | 模型能力说明、适用场景、限制等，支持最多 100 字 |
| 模型类型 | ✅ | 支持多选，用于标记模型的核心能力，决定其在平台中的可用场景（详见下文详细说明） |
| 是否启用 | ✅ | 启用：模型可被调用；禁用：模型不可被调用 |
| 可用范围 | ✅ | 选择模型支持的平台模块，可多选： 网页应用 / 通用智能体 / 问答智能体 / 工作流 / 外部API调用 |
| 接口协议 | ✅ | 模型接口通信协议，可选 OpenAI或者Anthropic 兼容协议 |
| 接口配置 | ✅ | 支持多组配置(多API KEY同时生效)，用于高可用与负载分发 以下为必填项： • URL：模型服务接口地址 • API KEY：调用鉴权密钥 • 权重：负载均衡权重，默认值为 1，值越大优先级越高 |
| 向量维度 | ✅ | 仅勾选文本向量类型时显示，需填写模型输出向量的维度（如 1536），用于知识库检索、语义匹配等场景 |
4. 模型类型详细说明
平台支持的模型类型标签如下，可多选组合，以精准匹配模型能力：
| 模型类型 | 说明与适用场景 |
|---|---|
| 文本生成 | 基础文本处理能力，适用于对话聊天、内容创作、代码生成、逻辑推理、文案撰写等纯文本交互场景 |
| 图像理解 | 多模态视觉能力，适用于图片解析、图文问答、图像识别、视觉推理、OCR等场景 |
| 语音识别 | 音频转文字能力，适用于语音转写、语音问答、音频内容分析等场景 |
| 视频理解 | 视频内容解析能力，适用于视频帧分析、视频问答、视频内容理解等场景 |
| 文本向量 | 文本向量化能力，适用于知识库召回、语义检索、文本相似度匹配、推荐系统等场景 |
| 深度思考 | 增强型逻辑推理能力，适用于复杂问题拆解、多步推理、数学计算、代码调试等需要深度思维链的场景 |
说明：模型类型支持多选，例如一个模型可以同时勾选「文本生成」和「深度思考」，以表示其具备增强的文本推理能力。
5. 平台模型列表与管控说明(仅管理员可见)
5.1 列表功能说明
- 支持按「类型」「状态」「管控」多维度筛选模型
- 列表字段包含：模型名称、类型标签、模型标识、模型介绍、状态、创建者、更新时间、管控开关、操作按钮
- 操作按钮：编辑、授权（仅管控开启时显示）、删除
5.2 启停管控规则
- 管控开关仅在系统管理后台生效：个人/团队空间添加的模型不支持平台级管控
- 管控关闭：全平台用户均可使用，「授权」按钮隐藏
- 管控开启：平台用户需根据授权规则使用该模型，「授权」按钮显示，可进行角色/用户组分配该模型的模型权限
- 管控状态变更后，需等待平台缓存刷新生效，期间可能存在短暂状态延迟
5.3 授权管理说明
- 授权入口：模型列表中「管控开启」的模型，点击「授权」按钮进入配置弹窗
- 授权维度：支持按「角色」和「用户组」进行授权
- 角色授权：给指定角色分配模型使用权限
- 用户组授权：给指定用户组分配模型使用权限
- 生效逻辑：用户只要属于任意一个已授权的角色或用户组，即可使用该模型
- 操作权限：仅平台管理员可配置模型授权规则，普通用户无法修改
6. 功能与操作说明
6.1 连通性测试
新增/修改模型配置后，可点击「模型连通性测试」验证接口可用性，避免因 URL、API KEY 错误导致调用失败。 
6.2 权限与数据隔离
- 平台模型、个人模型、团队模型三者数据完全隔离，互不覆盖
- 管理员无法查看/修改用户私有模型；用户无法修改平台公共模型配置
- 团队模型仅本团队成员可见，跨团队用户无法访问
7. 计费与使用规则
仅当「订阅与积分功能开关」开启时，全平台的定价、计费、积分扣除功能才会生效!
7.1 平台级计费体系说明
平台计费体系以「积分」为核心，由管理员在「订阅与积分」模块统一配置，包含以下关键规则：
- 积分与币值兑换比例：由管理员设置（例如 1元 = 1000积分），平台会自动换算并展示（如 100积分 ≈ 0.1元）。
- 用户积分获取渠道：支持管理员配置「新用户注册赠送」和「每日登录赠送」积分，赠送积分可设置有效期。
- 换算说明：可配置换算描述（如“1000积分等于1元，可以使用DeepSeek-V4-Flash模型100万输入token”），用于向用户说明积分消耗规则。
7.2 个人/团队模型定价与使用规则
- 个人/团队空间添加的模型也支持设置定价，但无法独立对外提供模型收费服务。
- 个人/团队模型定价仅用于平台内部消耗统计，可通过嵌入智能体、工作流等应用对外提供收费服务，由平台统一管理交易与结算。
- 调用个人/团队模型产生的费用，由创建者自行承担，平台仅转发请求，不参与模型级别的计费分成。
8. 重要注意事项
- 「模型标识」「URL」「API KEY」为调用核心参数，修改会直接导致模型调用失败。
- 接口配置支持多组 URL/KEY 与权重，用于实现负载均衡与故障转移。
- 可用范围配置决定模型在哪些平台模块中可见，需根据模型能力精准选择。
- 删除平台级模型前，需确认无用户正在使用，避免影响业务。
- 个人/团队模型的接口稳定性与费用风险由创建者自行承担。
- 授权配置仅在模型管控开启状态下有效，管控关闭后授权规则自动失效。
- 个人/团队模型定价仅在平台订阅与积分功能开启时生效，且不可脱离平台应用单独对外收费。
- 平台关闭「订阅与积分功能开关」后，所有模型定价规则自动失效，用户调用模型不再扣除积分。