镜像自 HugoXK/LaunchPad@5cfa983 · upstream · 在 GitHub 上编辑 docs/models-ui.md ↗

模型连接与供应商编辑

项目模型与部署共享模型复用同一个供应商列表、编辑器和版本事务。部署共享模型默认对所有项目可用,项目管理员可以直接在项目「模型」页选用;超级管理员可以经 PUT /api/models/:id/projects 把某个共享模型限定给部分项目(#850,见 API)。升级时已授权给全部项目的共享模型改为对所有项目可用,只授权了部分项目的保持原来的限定。列表可按供应商地址或模型名搜索,显示 Key 配置状态、项目/共享来源、每百万 token 的单价、项目默认/工作类型引用(仅列可见项目,无引用时明确显示「无项目默认或工作类型引用」),以及当前项目默认和工作类型显式引用。只读共享列表仍可在本地搜索,搜索只改变可见条目,不发送写请求,也不提供连接或凭据编辑。没有价格时显示未定价,不按 0 估算;实际角色模型与继承来源仍从角色设置查看。

编辑器依次展示连接信息、模型选择、测试及保存影响。模型列表与已选项各自限高滚动,显示已选数量;手机使用全屏编辑器,输入至少 16px、底部操作区与内容滚动分开。URL 保留用户填写的路径,实际请求地址由既有端点解析接口给出,不自动添加或删除 /v1。

在线目录与手动覆盖

项目「模型 → 模型目录」和「全局设置 → 模型」显示 models.dev 快照时间与刷新状态。超级管理员可立即刷新,后台每 6 小时更新;失败保留旧快照,页面显示失败。没有可用快照时使用现有默认能力,费用保持未知。

每条模型显示目录 provider/model、有效上下文、最大输出、推理能力和单价来源。「能力与目录」可保留自动匹配、搜索并指定条目,或取消匹配;能力字段留空继承目录,没有匹配时使用默认值。供应商 API/官方域名匹配其自身条目,中转按官方模型名匹配,名字的 provider/ 前缀、大小写以及点/横线差异不影响匹配;有多个候选时不会任意选择。

「计费单价」只填写需要覆盖的字段,其余继承同币种目录价格;清除手填单价后回退到目录。目录价格为 USD/百万 token,中转价格仅供参考,不自动换算 CNY。旧请求继续使用原价格快照,金额只用于统计。项目管理员可编辑本项目专属模型,共享模型只能由超级管理员修改。

测试草稿

「测试当前连接」使用当前表单 URL、待测试模型名和新填写 Key;编辑已有供应商时,Key 留空由服务端复用已保存的 Key。读取响应不会返回 Key,测试不保存 URL、模型名、凭据或计费信息。测试只证明这一条模型和本次请求的结果,获取模型列表不证明所有模型可用。

已有模型的 POST /api/models/<id>/test 保留空正文测试已保存配置的兼容行为。若提交草稿字段,必须带当前模型 version,可包含 api_url、api_key 和 model_name。版本失配在请求上游前拒绝;草稿字段和保存的 Key 均受原模型编辑权限限制,项目管理员不能测试共享 Key 或其他项目的 Key。

版本冲突

供应商 URL、Key 与模型增加仍通过原有 provider transaction 原子保存,提交成员与版本集合。冲突时保留表单和待添加模型;「读取最新版本并比较」读取同一项目或共享范围内的最新供应商,列出服务器地址及模型名称,保留用户字段,明确核对后才再次保存。该操作不混入同地址的其他项目或共享模型。

撤销 Key、删除模型仍是独立危险操作。删除前另读当前已保存角色的显式模型引用,包含停用角色;项目角色、平台服务角色和接入默认模型分别说明影响,历史版本和运行快照不计为当前引用。完整摘要缺失时不开放确认,取消不写入。取消编辑不保存字段;关闭编辑器会清空内存中的 Key 输入。价格保存只影响新请求,已有成本继续使用历史快照。

验证

真实页面预览

截图来自独立控制面与本地模型协议夹具,包含 1440px 项目模型页和 390×600 编辑器的实际选择/测试流程,不使用线上数据。

供应商与模型桌面页

供应商手机编辑器