yetone/magpie

项目介绍

magpie 是一个本地模型网关加桌面应用，面向同时使用多个编码 Agent 和多个模型来源的开发者。每个 Agent 原本各自在配置文件里保存模型名、base URL 和密钥；magpie 把这些集中管理，选中模型后改写对应 Agent 的配置。网关监听 127.0.0.1:3425，在 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini 格式之间转换，流式输出、工具调用和推理内容都在转换范围内 README lines 98–107。

主要能力：

• 切换模型：从可搜索列表为任意已安装 Agent 选择 provider/model，配置以原子方式改写，并保留原有的注释、顺序和格式。Profile 可一次性保存和恢复所有 Agent 的选择 README lines 110–130。
• 供应商与订阅：预设覆盖 Anthropic、OpenAI、Gemini、Vertex、Bedrock、DeepSeek、Kimi、GLM、Qwen、OpenRouter、Ollama、LM Studio 以及任意 OpenAI/Anthropic 兼容地址。Claude、ChatGPT、Copilot、Gemini、Grok 等订阅登录也能作为供应商提供给其他 Agent README lines 151–174。
• 故障转移与路由组：把多个模型或账号合成一个组，按 smart、order、rotate、usage、pace 等策略分流请求 README lines 175–210。
• 隐私脱敏（默认关闭）：请求离开本机前把密钥和个人信息替换为占位符，回复中再还原，支持规则和可选的本地模型识别 README lines 131–150。
• 还提供用量统计、插件、局域网共享和基于 MCP 的搜索/图片工具。

README 列出了大量受支持的 Agent，包括 Claude Code、Codex、Cursor CLI、Gemini CLI、OpenCode、Zed、Cline 等 README lines 80–97。它适合同时使用多个 Agent、多个供应商或多个账号的用户；如果只用一个 Agent 且自带套餐够用，README 明确表示不需要它 README lines 36–48。

快速使用

1. 安装：从官网下载应用，或运行安装脚本 README lines 49–79：

   curl -fsSL https://usemagpie.ai/install.sh | sh
   

   也可以使用 go install github.com/yetone/magpie@latest 或 Docker 镜像 Docker 文档。Linux 下脚本会安装桌面应用，缺少 WebKitGTK 4.1 时先通过包管理器安装；没有桌面环境时安装终端版本。可用 --gui 或 --tui 指定，防火墙后可用 --proxy 或 --mirror。

2. 添加供应商：打开 magpie，进入 Providers → Add provider，选择预设并粘贴 API key，或通过订阅登录。

3. 选择模型：在 Agents 页面为每个已安装 Agent 选模型，新开会话即生效。

命令行也能完成同样的事：

magpie provider add deepseek sk-…
magpie claude deepseek/deepseek-v4-pro
magpie codex moonshot/kimi-k2.5
magpie group add "Opus anywhere" models=claude/claude-opus-5-5,copilot/claude-opus-5.5 routing=smart
magpie claude group/opus-anywhere
magpie quota

其他接受 base URL 的工具可直接指向网关，例如设置 OPENAI_BASE_URL=http://127.0.0.1:3425/v1 和 OPENAI_API_KEY=magpie README lines 92–96。

使用约束与隐私

• 支持 macOS、Windows 和 Linux，也可运行在 Docker 与 Termux；界面形式包括菜单栏应用、窗口、TUI、Web UI 和 CLI。
• 订阅发现会读取 Agent 的登录文件以及 macOS Keychain。可在 Settings → Privacy → Subscription accounts 关闭，或用 magpie accounts discovery off 持久关闭，MAGPIE_NO_ACCOUNTS=1 只对单次运行生效；仅用 API key 的供应商不受影响。
• 隐私脱敏默认关闭，需要手动开启。开启后若脱敏无法运行，请求会被拦截并返回 503，不会按原文发出；任务本身需要看到明文的敏感值应放入 Never mask。
• 应用每天发送一次使用情况上报（随机 id、版本、系统、Agent/供应商/模型 id 以及合作方交互计数），可在 Settings → Privacy 或通过 DO_NOT_TRACK=1 关闭；合作方链接经 usemagpie.ai/go/… 跳转并计数 README lines 297–300。
• 项目采用 MIT 许可证；仓库不接受 PR，反馈走 Discord。

HotRepo 点评

README 展示的是一个功能具体、可操作的项目：本地多协议网关、图形界面与 CLI 管理、故障转移组、脱敏和插件中间件都有说明。它明显面向同时使用多个 Agent 和订阅的重度用户，而不是单 Agent 工作流，配置改写和网关地址写到了可以直接尝试的程度。本站目前没有该仓库的榜单名次、Star 历史或讨论记录，无法据此判断热度趋势；实际评估应围绕上述功能覆盖与已披露的网络和隐私行为。