LAGcomcom / zen-gate

# ZEN—GATE
**把 OpenCode Zen 免费模型，装进你所有的 AI Agent。**
一个桌面托盘程序（Windows 10/11、macOS 13+ 与 Linux）：本地起一个 OpenAI / Anthropic
兼容网关，自动探测并接入你机器上已安装的 AI Agent——模型选择器里直接出现免费模型。
下载最新版 · 问题反馈
---
## 这是什么
OpenCode Zen 提供了一批**免登录、免计费**的模型车道，但它们没有标准的 API Key 体系，
一般客户端接不上。Zen Gate 在本机把这条车道封装成**标准 OpenAI / Anthropic 兼容接口**，
并自动完成所有 Agent 的配置注入：
- **全自动适配**：检测到 ZCode / OpenCode / Codex / Claude Code / DeepSeek Harness /
 Crush / ChatBox / Aider / Qwen Code / Continue / WorkBuddy / Qoder 后，一键注入配置（先备份，关闭即还原），
 重启对应 Agent 就能在模型选择器里看到免费模型（WorkBuddy 无需重启，保存后自动热加载；Qoder 注入
 `~/.qoder-cn/settings.json` 自定义供应商，IDE 本地直连）；
- **自定义 API 接入**：免费车道之外，可添加任意 OpenAI / Anthropic 兼容上游——
 内置 NVIDIA NIM、Google Gemini、GitHub Models、Groq、Cerebras、Mistral、OpenRouter、
 HuggingFace、硅基流动、魔搭、智谱、LongCat、书生 Intern 等 14 个免费商预设一键填充，
 填上自己的 Key 后自动检索模型列表，模型以 `供应商ID/模型名` 出现在所有 Agent 选择器里；
- **协议层实测打磨**：会话铸造、指纹门、三种线协议（chat / responses / messages），
 断流续写、空停续写、截断自动续写三重兜底——全部按真实客户端行为逐项实测；
- **Kilo 免费池**：第二条免凭据免费源直接并入目录，与免费车道共用路由、
 限流切换与探测看板；免费池提示词可能被上游记录，别交机密内容；
- **单模型体检**：每个模型可单独探测可用性与首字延迟，探测历史持久化、跨重启可查。
## 亮点
| | |
|---|---|
| 🧭 **多模态智能路由** | 请求带图 / 音频 / 文件时，限流切换只会落到支持该模态的模型；模型能力三层打标（内置精选表 → 免费车道大模型 AI 标注 → 一键实测），徽章直接标在模型页 |
| 🎯 **路由策略** | 智能路由总开关随时启停；failover 候选链按「目录顺序 / 首字延迟优先」排序；免费车道全部耗尽可单向回落到你的自定义 API（默认关，消耗自己的 Key） |
| 🔄 **限流自动切换** | 模型被限流时自动换下一个可用模型接住请求，响应头标注实际模型 |
| 📢 **公告系统** | 编辑仓库根目录 `announcements.json` 即向所有用户发公告（info/warn/critical 分级、生效时段、已读跟踪），总览页每 6 小时同步 |
| 🔌 **自定义 API** | 免费商预设一键填充 + 自动检索模型列表，自己的 Key 自己填，用量照常入账 |
| 📖 **能力元数据进标准接口** | `GET /v1/models` 每条模型除 OpenAI 字段外附带 `context_window`、`max_output_tokens`、`input_modalities`、`reasoning`、`supported_reasoning_levels` 与 `capability_source`（实测 > 上游声明 > AI标注 > 规则 / 未标注）——一键实测的结论不用打开面板也能被 Agent、SDK 或任意脚本读到；重启后实测结论仍随 `tags.json` 生效 |
| 🌐 **订阅轮询** | 粘贴代理订阅（vless / vmess / ss / trojan / hy2 / tuic），内嵌 sing-box 侧车转成本地 socks 池，**每个请求轮换一个健康出口**——免费车道额度按出口 IP 计，多节点就是多份额度；节点健康探测 + 拨号失败自动跳下一节点 |
| 📊 **额度测算** | 无官方余额 API 也能估：限额时段追踪 + 恢复时间预估 + 日额度进度条 |
| ⏱ **首字历史** | 每次探测的首字延迟入样本环，重启不丢，模型页直接看平均首字 |
| 🌡 **GitHub 式热力图** | 365 天用量热力图 + 多模型趋势折线 + 每 / 周 / 累计三种视图 |
| 🖥 **托盘常驻** | 关窗即进托盘/菜单栏、开机自启（注册表 / launchd）、系统通知、跟随系统代理（WinINET / `scutil --proxy`） |
| 🛡 **只听本机** | 网关默认仅绑定 127.0.0.1；设置里可放开局域网给同网段设备调用（接口仍必须带 API Key，管理端固定只接受本机），另有同源护栏、配置先备份再改 |
## 快速开始
**Windows** — 从 Releases 下载
`zen-gate.exe`，双击运行（托盘出现图标）。机器没装 WebView2 Runtime 时会自动改用
默认浏览器打开管理页，网关功能不受影响；想要内嵌窗口装一下
WebView2 Runtime 即可。
`ZEN_GATE_NO_WEBVIEW2=1` 可强制浏览器模式（排障用）。
**macOS** — `tools/build-macos.sh` 产出 `dist/Zen Gate.app`，安装并启动：
 [code] 
**Linux** — `tools/build-linux.sh` 产出 `dist/Zen_Gate-x86_64.AppImage`
（自包含 GTK3 + appindicator，无需安装依赖），下载后 `chmod +x` 双击运行即可：
 [code] 
Linux 版没有原生内嵌窗口：管理页在默认浏览器打开，托盘常驻（AppImage 内的
`zen-gate.desktop` 也支持「开机自启」开关，写入 `~/.config/autostart`）。
**Debian / Ubuntu / Deepin 等** — `tools/build-deb.sh` 产出 `dist/zen-gate_*.deb`
（依赖系统 `libgtk-3-0` 与 `libayatana-appindicator3-1`，体积更小），安装：
 [code] 
两边都是：到「Agent 适配」页打开你装的 Agent 开关 → 重启该 Agent →
模型选择器里出现免费模型。
> 想接 ChatBox / Cherry