文档 · 指南

让 miniQ 用任意模型

miniQ 是一个桌面 AI 助手，也有 miniq 终端客户端，两者都连同一个 miniq-daemon。它的模型来自一个 OpenAI 或 Anthropic 兼容的端点，就是 settings.json 里的 provider。magpie 把这个 provider 换成本机网关，miniQ 就能用 DeepSeek、GLM、Kimi、Qwen、GPT 或 ChatGPT 订阅等 magpie 里的任意模型。

接入 miniQ

  1. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
  2. 在 Agent 页给 miniQ 选模型miniQ 一行的列表里有你当前的 miniQ 模型，也有 via magpie 的模型。选后者。
  3. 直接开始用daemon 在运行时，magpie 会通知它换上新 provider，已打开的对话也跟着换模型，不用重启。
终端
magpie miniq deepseek/deepseek-v4-pro

在 Windows 上，WSL 发行版里的 miniQ 也会被找到，接入方式相同。

settings.json 在哪

settings.json 在 daemon 的数据目录里。magpie 按 miniQ 自己的规则找它：先看 MINIQ_DATA_DIR；没有的话，看默认目录旁的 miniq-data-dir.json（你在 miniQ 设置里移动过数据目录时会有）；再不然就是默认目录。macOS 也用 ~/.local/share/miniq。

终端
macOS / Linux: ~/.local/share/miniq/settings.json
Windows:       %LOCALAPPDATA%\miniq\settings.json
MINIQ_DATA_DIR set: $MINIQ_DATA_DIR/settings.json

写了哪些内容

终端
{
  "provider": {
    "baseUrl": "http://127.0.0.1:3425/v1",
    "apiKey": "",
    "model": "deepseek/deepseek-v4-pro",
    "apiProtocol": "chat_completions"
  }
}

baseUrl 是网关的 /v1，apiKey 是 magpie 给 miniQ 的专用 Key，因为 miniQ 不发自己的 User-Agent，magpie 靠这个 Key 认出它。model 是模型的目录 id。apiProtocol 固定为 chat_completions：如果是 auto，miniQ 会按模型名去猜用 Responses 还是 Anthropic Messages。

magpie 只改 provider。你原来的 provider 会整份记下来。settings.json 里的其他内容都保持原样，包括 MCP 服务器、审批、hooks 和远程访问。文件不存在时，magpie 会用 0600 权限新建，和 miniQ 自己的做法一样。

正在运行的 daemon

daemon 只在启动时读 settings.json，之后每次设置变化都会写回自己的一份。所以 magpie 写完文件，还会通过 daemon.json 里的本地 WebSocket 调用 settings.update，和 miniQ 桌面版的设置页走同一条路。如果 daemon 联系不上，它会一直用旧的 provider，直到重启。这种情况下 magpie 会提示重启 miniQ。

切回

切回默认时，magpie 把你原来的 provider 整份放回，并通知 daemon。如果你原来没有 provider，就删掉 magpie 写的那个，miniQ 回到它自己的默认设置。如果 settings.json 是 magpie 新建的，删完后文件为空就整个删掉。也可以在 magpie 里直接选你自己的 miniQ 模型，magpie 会把它放进你原来的 provider。

终端
magpie miniq default

常见问题

miniQ 怎么用 DeepSeek、GLM 或 ChatGPT 订阅？

在 magpie 的 Agent 页给 miniQ 选一个 via magpie 的模型。magpie 把 settings.json 的 provider 设成本机网关的 /v1，并通知正在运行的 miniq-daemon。

要重启 miniQ 吗？

一般不用。magpie 会通过 settings.update 通知运行中的 daemon，已打开的对话也会换到新模型。只有 daemon 联系不上时才需要重启，magpie 会提示。

为什么 apiProtocol 是 chat_completions 而不是 auto？

auto 会按模型名猜协议，可能误选 Responses 或 Anthropic Messages。magpie 网关的 /v1 走 Chat Completions，固定下来最稳。

我的 MCP 服务器和其他设置会被改吗？

不会。magpie 只改 settings.json 的 provider，切回时还原原来的 provider。

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