文档 · 指南

让 Aside 用任意模型

Aside（aside 命令）每个账号都有自己的一套设置、模型列表和登录信息。magpie 在账号的 models.json 里加一个名为 magpie 的供应商，再通过 Aside 自己把默认模型设成它，Aside 就能用 DeepSeek、GLM、Kimi、Qwen、Claude 或 ChatGPT 订阅等 magpie 里的任意模型，生图也能用 magpie 里的图片模型。

接入 Aside

1. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
2. 在 Agent 页给 Aside 选模型选一个 via magpie 的默认模型，需要的话再选思考强度、各个分类和生图模型。
3. 在 Aside 里接着用magpie 让 Aside 自己改设置，并读回来确认已经生效。

magpie aside deepseek/deepseek-v4-pro

models.json

Aside 的每个账号有一个文件夹 ~/.aside/u/<id>，里面有 settings.json、models.json 和登录信息。magpie 在 models.json 里写 providers.magpie，格式和 Pi 的一样：baseUrl 是网关的 /v1，apiKey 是 magpie 给 Aside 的专用 Key，models 里是 magpie 的模型。

// ~/.aside/u//models.json
{
  "providers": {
    "magpie": {
      "baseUrl": "http://127.0.0.1:3425/v1",
      "api": "…",
      "apiKey": "",
      "models": [ { "id": "deepseek/deepseek-v4-pro", … } ]
    }
  }
}

magpie 只改它自己的条目。已有的 magpie 条目没有 Key、用的是别的 Key，magpie 都不会覆盖；条目指向另一个网关时，要你明确重新接入才改。

Aside 自己的设置

默认模型这类设置，magpie 不直接改 settings.json，而是用 aside repl --account <id> --host local 让 Aside 自己去设，设完再读回来。读回来的值不一样，magpie 会直接报错，不会假装成功。默认模型写成 provider 加 modelId，magpie 的模型就是 provider 为 magpie 的那些。思考强度跟着默认模型，只列出这个模型支持的级别。

分类和生图模型

Aside 的 modelCategories 有 fast、standard、deep、visual 四个分类，每个都可以单独选模型；不选时跟着默认模型。imageGenerationModel 是生图用的模型，可以选 magpie 的图片模型；在供应商编辑页取消勾选的不会列出，但已经选上的照常能用。

多个账号

~/.aside/accounts.json 的 currentAccountId 记着 Aside 正在用哪个账号。magpie 配置的是你在 magpie 里选的账号，没选就用 Aside 当前的账号，都读不到时用 u0。每个账号的设置，以及 magpie 记下的原值，都跟着各自的账号。换账号只改 magpie 配置哪一个，Aside 里什么都不会变。

magpie aside account u1

切回

magpie 每改一项设置前都会记下原来的值。切回时只还原它自己改过的那几项，其他设置不动。

magpie aside default

常见问题

Aside 能用 DeepSeek、GLM 或 ChatGPT 订阅吗？

能。在 magpie 的 Agent 页给 Aside 选一个 via magpie 的默认模型即可，magpie 会让 Aside 自己应用这个设置。

fast、standard、deep、visual 能分别用不同的模型吗？

能。每个分类都可以单独选 magpie 的模型，不选时跟着默认模型。

Aside 有多个账号时，magpie 改的是哪一个？

默认是 Aside 当前的账号；也可以在 magpie 里选一个，例如 magpie aside account u1。

切回后原来的设置会恢复吗？

会。magpie 只还原它改过的设置，用的是改之前记下的值。

更多 Agent 用同样的模型：让 Ante 用任意模型、让 omp 用任意模型、让 Pi 用任意模型、让 fx 用任意模型。遇到报错？见 常见错误排查，或到 Discord 提问。