Files
infinite-canvas/docs/system-settings.md
T
HouYunFei 593feddc3f refactor(canvas): 优化模型选择器和定时同步配置
- 将模型选择器替换为统一的 shadcn 风格下拉组件
- 移除原生数字输入框的步进箭头样式
- 更新默认定时同步配置为每5分钟执行
- 修复画布助手和节点配置中的模型选择逻辑
- 统一各页面中的模型选择器样式和交互行为
2026-05-23 15:56:17 +08:00

2.9 KiB

系统配置数据结构

系统配置保存在 settings 表中,目前只使用两行:

key 说明
public 公开配置,前端可以读取
private 私有配置,只给后端和管理员使用

public.value

{
  "modelChannel": {
    "availableModels": ["gpt-5.5", "gpt-image-2"],
    "defaultModel": "gpt-image-2",
    "defaultImageModel": "gpt-image-2",
    "defaultTextModel": "gpt-5.5",
    "systemPrompt": "",
    "allowCustomChannel": true
  }
}
字段 类型 说明
modelChannel object 模型渠道公开配置组

modelChannel 字段:

字段 类型 说明
availableModels string[] 系统可用模型,由管理员手动选择;页面下拉选项可来自私有渠道模型
defaultModel string 默认模型,从 availableModels 中选择
defaultImageModel string 默认图片模型,从 availableModels 中选择
defaultTextModel string 默认文本模型,从 availableModels 中选择
systemPrompt string 系统提示词
allowCustomChannel boolean 是否允许用户在配置弹窗中切换为本地直连渠道,默认允许

用户侧请求模式:

模式 说明
云端渠道 使用后端 /api/v1/* 代理接口,请求会按模型名匹配 private.value.channels 中的可用渠道
本地直连 默认可选;allowCustomChannel 关闭后不可选,用户在浏览器本地配置 baseUrlapiKey 和模型列表后直接请求模型接口

private.value

{
  "channels": [
    {
      "protocol": "openai",
      "name": "默认渠道",
      "baseUrl": "https://api.example.com",
      "apiKey": "sk-xxx",
      "models": ["gpt-5.5", "gpt-image-2"],
      "weight": 1,
      "enabled": true,
      "remark": ""
    }
  ],
  "promptSync": {
    "enabled": true,
    "cron": "*/5 * * * *"
  }
}
字段 类型 说明
channels object[] 模型渠道列表
promptSync object GitHub 远程提示词定时同步配置

channels 每项字段:

字段 类型 说明
protocol string 协议,当前为 openai
name string 渠道名称
baseUrl string OpenAI 兼容接口地址
apiKey string 渠道密钥
models string[] 该渠道可用模型
weight number 渠道权重;同一模型有多个可用渠道时按权重随机
enabled boolean 是否启用
remark string 备注

后端调用模型时,会从已启用、已配置 baseUrlapiKey、且 models 包含目标模型的渠道中选择一个。

promptSync 字段:

字段 类型 说明
enabled boolean 是否开启定时同步,默认开启
cron string Cron 表达式,默认每 5 分钟