mu-zi-lee/magpie-our-free-model

选用指南

AI 根据 README 整理 · 2026/10/17 09:11:24

使用方式

通过Magpie插件方式使用，安装后自动启动服务并接入模型，无需手动启动或编译。

查看 README 依据

[首次打开管理页面](#在-magpie-中打开管理页面) · [服务器访问](#服务器部署与浏览器控制台) · [页面打不开](#页面打不开时) · [更新](#更新已有版本) · [卸载清理](#卸载与自动清理) ## 安装与首次使用 不需要手动启动 Our Free Model，也不需要 `npm install` 或编译。插件会准备运行环境、启动服务，并把模型接入 Magpie。 ```sh git clone https://github.com/mu-zi-lee/magpie-our-free-model.git magpie plugin add ./magpie-our-free-model ``` 也可以在本仓库 **Code → Download ZIP** 下载并解压，然后在 Magpie 的 **插件（Plugins）** 页面添加解压后的项目目录、启用插件。安装目录需要保持固定。

部署要求

需要Magpie环境，首次使用自动下载Node.js、cloudflared等组件，需要访问nodejs.org和GitHub。

查看 README 依据

Gemini 强制刷新配额和图片计价修复，增加本机 Anthropic Messages 接口。 本插件补充账号渠道对 Anthropic 消息与工具格式的适配，保留模型停用、思考档位和输出上限校验。 上游 2.1 的聚合供应商、回退链与 Token 节省模块随核心保留，但当前上游独立控制台没有完整配置入口； 本版不宣称这些 DSH 设置已迁移到 Magpie。同步范围和后续维护步骤见 `UPSTREAM_SYNC.md`。 ### Node 自动安装 Magpie 提供 Bun，但原项目渠道 Worker 需要 Node。插件先使用可用的 **Node.js 22.19+ 或 24+**； 服务器没有合适的 Node 时，首次启用自动从 **nodejs.org** 下载固定版本 **24.21.0**， 使用代码中固定的官方 SHA-256 校验，通过后解压并检查能否运行，再启动服务。 安装到数据目录的 `runtime/`，之后直接复用；无需 root、不改系统 Node/PATH、不执行远程安装脚本。 首次下载约 50–65 MB，需要访问 nodejs.org，解压后占用更多磁盘空间。 Linux/macOS 需要系统自带的 `tar`。支持 Linux x64/arm64、macOS x64/arm64 和 Windows x64/arm64；

按上面的[Magpie 操作步骤](#在-magpie-中打开管理页面)选择远程入口：先完成供应商启用，若首次没有跳转，再点开 **Our Free Model** 并重新选择同一入口。 无需 Cloudflare 账号、登录、域名或 Tailscale；客户端连接后会给出随机的 `https://随机名称.trycloudflare.com/open/…`，在自己电脑浏览器中打开。 临时域名可能需要一两分钟才能访问，实测首次约 80 秒；遇到 DNS 错误时先稍等再刷新。 插件优先使用已有 `cloudflared`。缺少可用客户端时，自动从 [Cloudflare 官方发行页](https://github.com/cloudflare/cloudflared/releases/tag/2026.10.0) 下载固定 **2026.10.0**，校验固定大小和 SHA-256，再缓存到插件数据目录 `runtime/`。 自动下载支持 **Linux/macOS x64、arm64 和 Windows x64**，macOS 解压需要 `tar`。 首次下载约 20–55 MB；不需要 root，不修改系统 PATH，不安装系统服务。 完成账号管理后点击页面顶部 **结束远程访问**。退出控制台登录、通道启动后满 **30 分钟**、

已知限制

远程通道最多保持30分钟，链接十分钟内有效且只能使用一次；管理界面不能嵌入Magpie窗口；部分功能如公告推送、插件自更新等尚未迁移。

查看 README 依据

**Magpie 显示供应商已连接，只表示插件已启用。** 匿名 Zen/Kilo 模型可直接刷新使用；EAC 还需要在网页完成 GitHub 授权与 Star 校验，账号渠道则要分别登录厂商账号。 “远程控制台免登录”指无需 Cloudflare 账号；渠道本身的登录要求仍由原项目和厂商决定。 ### 以后如何重新打开 回到 Magpie 的 **供应商 → Our Free Model → 登录／连接入口**，再次选择本机或远程控制台方式。 该入口也用于重新打开管理页，无需卸载插件或退出已有渠道账号。界面的按钮文字可能随 Magpie 版本、语言和连接状态略有变化。 使用本次生成的完整 `/open/…` 链接，不要只打开域名首页，也不要反复打开旧链接。 链接十分钟内有效、只能使用一次；它换取浏览器管理会话，服务 API Key 不进入 URL。 远程通道最多保持 30 分钟，结束后重新从 Magpie 生成入口。 ### 使用时保持 Magpie 运行 桌面 Magpie、`magpie web` 或 `magpie serve` 需要持续运行，内置服务随插件宿主运行。 终端的 `magpie plugin login our-free-model` 是短命命令，命令退出后服务也会关闭； 完成网页里的渠道登录，请优先使用正在运行的 Magpie 界面。

| Chat Completions / Responses / Anthropic Messages | 内置服务支持三种；Magpie 插件使用 Chat 接口；其他本机客户端可用原生 `/v1/messages`（普通/流式回复及工具调用） | | 本机 API 转发 | 控制台 API 接入页复制地址和密钥；其他本机工具可调用 | | 生命周期与密钥轮换 | 插件启动/停止服务；控制台轮换密钥后，插件下次请求自动读取新密钥 | **覆盖范围：**管理界面在独立浏览器页面中打开；服务器部署使用临时 HTTPS 地址访问。Magpie 没有插件自定义页面接口，管理界面不能嵌入 Magpie 窗口。 原 DSH 的公告推送、插件自更新/热重载、宿主 Agent 自动续跑和局域网中继尚未迁移。 本机服务只监听回环地址；更新此仓库后需通过 Magpie 重载插件或重启。 原项目的 OpenCode 账号渠道仍默认停用。 没有逐家使用真实账号验收，也不保证上游模型、登录接口和免费额度一直有效。 ### 本次上游同步 0.9.0 同步至上游 `e9c4b70d913116284692d7b206a63f39ad6fe8cc`： 更新独立控制台的主题、模型批量开关与余额查询反馈，吸收 Gemini/Cline 的环境代理及 Windows 系统代理修复、