HouYunFei
afd9631735
- 将公开设置中的模型相关字段统一收拢到 modelChannel 配置组 - 更新 AdminPublicSettings 类型定义为 AdminPublicModelChannelSettings - 在前端表单中调整模型配置字段路径到 public.modelChannel 下 - 更新设置规范化函数以适配新的嵌套配置结构 - 修改依赖注入和文档以反映配置结构变化 - 添加系统配置数据结构文档说明新的配置格式
77 lines
2.1 KiB
Markdown
77 lines
2.1 KiB
Markdown
# 系统配置数据结构
|
|
|
|
系统配置保存在 `settings` 表中，目前只使用两行：
|
|
|
|
| key | 说明 |
|
|
| --- | --- |
|
|
| `public` | 公开配置，前端可以读取 |
|
|
| `private` | 私有配置，只给后端和管理员使用 |
|
|
|
|
## public.value
|
|
|
|
```json
|
|
{
|
|
"modelChannel": {
|
|
"availableModels": ["gpt-5.5", "gpt-image-2"],
|
|
"defaultModel": "gpt-image-2",
|
|
"defaultImageModel": "gpt-image-2",
|
|
"defaultTextModel": "gpt-5.5",
|
|
"systemPrompt": "",
|
|
"allowCustomChannel": false
|
|
}
|
|
}
|
|
```
|
|
|
|
| 字段 | 类型 | 说明 |
|
|
| --- | --- | --- |
|
|
| `modelChannel` | object | 模型渠道公开配置组 |
|
|
|
|
`modelChannel` 字段：
|
|
|
|
| 字段 | 类型 | 说明 |
|
|
| --- | --- | --- |
|
|
| `availableModels` | string[] | 系统可用模型，由管理员手动选择；页面下拉选项可来自私有渠道模型 |
|
|
| `defaultModel` | string | 默认模型，从 `availableModels` 中选择 |
|
|
| `defaultImageModel` | string | 默认图片模型，从 `availableModels` 中选择 |
|
|
| `defaultTextModel` | string | 默认文本模型，从 `availableModels` 中选择 |
|
|
| `systemPrompt` | string | 系统提示词 |
|
|
| `allowCustomChannel` | boolean | 是否允许用户自定义渠道 |
|
|
|
|
## private.value
|
|
|
|
```json
|
|
{
|
|
"channels": [
|
|
{
|
|
"protocol": "openai",
|
|
"name": "默认渠道",
|
|
"baseUrl": "https://api.example.com",
|
|
"apiKey": "sk-xxx",
|
|
"models": ["gpt-5.5", "gpt-image-2"],
|
|
"weight": 1,
|
|
"enabled": true,
|
|
"remark": ""
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
| 字段 | 类型 | 说明 |
|
|
| --- | --- | --- |
|
|
| `channels` | object[] | 模型渠道列表 |
|
|
|
|
`channels` 每项字段：
|
|
|
|
| 字段 | 类型 | 说明 |
|
|
| --- | --- | --- |
|
|
| `protocol` | string | 协议，当前为 `openai` |
|
|
| `name` | string | 渠道名称 |
|
|
| `baseUrl` | string | OpenAI 兼容接口地址 |
|
|
| `apiKey` | string | 渠道密钥 |
|
|
| `models` | string[] | 该渠道可用模型 |
|
|
| `weight` | number | 渠道权重；同一模型有多个可用渠道时按权重随机 |
|
|
| `enabled` | boolean | 是否启用 |
|
|
| `remark` | string | 备注 |
|
|
|
|
后端调用模型时，会从已启用、已配置 `baseUrl` 和 `apiKey`、且 `models` 包含目标模型的渠道中选择一个。
|