模型服务¶

这个页面讲机器人如何选择和使用模型。

一句话解释¶

YesImBot 不内置任何模型公司。它通过“模型服务插件”连接模型 API；仓库预置了 OpenAI-compatible、Anthropic、DeepSeek、Google 等 Provider。Provider 不是厂商绑定，可以通过 baseURL 接任意兼容 API，也可以克隆多开。

模型 ID¶

每个模型有一个完整 ID，写法是“Provider ID:模型”。Provider ID 是 Provider 实例配置里的 id，不一定是厂商名：

openai:gpt-4o
anthropic:claude-sonnet-4-6
deepseek:deepseek-v4-pro
google:gemini-2.5-pro

在 yesimbot 配置里，chatModel 填这个 ID。

models.json 是什么¶

models.json 是模型能力的补充配置文件，主要用来告诉系统：

默认使用哪个模型；
某个 ID 可以叫一个更短的名字；
模型是否支持图片；
模型的上下文和输出长度。

普通用户如果只做文本聊天，通常不需要修改它。

{
  "defaults": {
    "chat": "openai:gpt-4o"
  },
  "aliases": {
    "main": "openai:gpt-4o"
  },
  "chat": {
    "openai:gpt-4o": {
      "modalities": { "input": ["image"] },
      "limit": { "context": 128000, "output": 16384 }
    }
  }
}

图片能力¶

想让机器人看图，需要：

模型本身支持图片；
models.json 里声明支持图片；
imageInput 没有关闭。

模型不会自动翻看历史图片，只会读取当前步骤中明确读取的图片。

一步步启用图片¶

如果你希望机器人能看图，按下面的步骤操作：

先确认模型服务插件里的模型 ID，例如 openai:gpt-4o。
打开 data/yesimbot/models.json。如果文件不存在，就创建一个空文件，内容为 {}。
在 chat 下添加这个模型，并声明图片输入：

{
  "chat": {
    "openai:gpt-4o": {
      "modalities": {
        "input": ["image"]
      }
    }
  }
}

保存文件，然后重启 Koishi。
确认 imageInput 没有设为 false。

模型 ID 不能写错

models.json 里的键必须是完整的“Provider ID:模型”格式。写错会被忽略，并在启动日志里出现警告。

控制图片预算¶

修改模型后¶

模型、图片能力和相关配置会在频道开始时被固定下来。修改后建议重启 Koishi，让新设置完整生效。