面向 Xcode Agent 的端点路由

把 Xcode Agent 工作路由到你真正想用的模型。

v1.12.1 CLI v1.12.1 16 个提供商

ProxyPilot 是 Mac 应用、无头 CLI 和 MCP 控制层，用于路由 Xcode Agent 流量。v1.12.1 新增了从应用图标提取的品牌标识和布局菜单，无需调整窗口大小即可强制使用侧边栏或紧凑布局，并修复了 7 天和 30 天保留窗口下输入/输出日志无法保存新记录的问题。

下载 v1.12.1 更新内容 查看源码 
$ curl -fsSL https://micah.chat/downloads/proxypilot-install.sh | bash
ProxyPilot Home 仪表盘，显示深色外观下真实运行状态的应用界面、会话指标、ProxyPilot Agent 状态和会话报告控件。
v1.12.1 更新内容

工具栏中的品牌标识、布局菜单，以及一项日志修复。

ProxyPilot 现在在工具栏红绿灯按钮旁显示从应用图标提取的品牌标识，并带有以应用图标配色渲染的柔和背景，同时新增布局菜单（自动/侧边栏/紧凑），无需调整窗口大小即可强制使用某种布局。本次更新还修复了 7 天和 30 天保留窗口下输入/输出日志无法保存新记录的问题。

v1.12.1

应用图标品牌标识、布局菜单与 I/O 日志修复

工具栏红绿灯按钮旁新增了从应用图标提取的品牌标识，并带有以应用图标配色渲染的柔和背景。新的布局菜单可强制使用自动、侧边栏或紧凑布局，无需调整窗口大小。7 天和 30 天保留窗口下的输入/输出日志不再静默丢弃新记录，隐私对话框和设置文案现在会显示实际选择的保留窗口。

v1.11.7

交互式程序坞图标、会话计数修复与模型列表滚动

新增的可选"交互式程序坞图标"设置会在代理运行时于程序坞中显示实时 LED 风格的模型跑马灯。Home 仪表盘和菜单栏在长会话中不再将会话请求计数卡在 500，Proxy 页面的模型列表现在可以在 OpenRouter 等大型目录下正常滚动，上游错误信息包含更多提供商细节，Home 仪表盘的智能体卡片现已显示 ProxyPilot Agent。

v1.11.3

I/O 日志控制、导出格式与 CLI 会话可见性

输入/输出日志保留期现已延长至 30 天，并支持可选的外部保存位置，在不可访问时自动回退。Session History 支持 CSV 和 JSON 文件导出。新增的 proxypilot sessions CLI 命令和 MCP 工具可直接读取会话历史与日志。

v1.11.2

本地及自定义提供商修复，Copilot sidecar 更新

Ollama、LM Studio 及自定义 OpenAI 兼容提供商现在能可靠地将检测到的模型提供给 Xcode。GitHub Copilot sidecar 在 Keys & Providers 中新增版本检查与一键更新功能。

v1.11.1

更快的仪表盘启动和更清晰的可靠性边界

大型已保存会话现在只需一次仪表盘更新即可载入，而不是触发数百次更新。模型和价格元数据也不再反复扫描完整目录，自定义提供商在激活时保持响应。

v1.11.0

面向 Xcode 27 的托管 ProxyPilot Agent

可以在应用中或使用 proxypilot agent 安装、检查、修复和移除 ProxyPilot Agent。启动器可以启动所选代理路由，把提供商凭据留在钥匙串中，并同时支持 Apple Silicon 与 Intel。

v1.9.6

9Router 作为内置本地提供商

把 ProxyPilot 指向一个 9Router 网关，就能通过它路由 Xcode Agent 流量。9Router 按本地/辅助提供商处理，使用它的本地 /v1 端点，默认不需要上游 key，并且在网关要求时可以可选地保存一个端点 token。

v1.9.5

真正可以选择的自定义提供商

保存的自定义 OpenAI 兼容提供商现在会出现在上游选择器里，在 Keys & Providers 中显示激活状态，重启后保持，并用各自的 base URL 和已保存的 key 路由。自定义提供商的模型列表和默认值与内置 OpenAI 提供商保持隔离。

v1.9.5

大日志下 Session History 依然流畅

Session History 先加载报告卡元数据，只为你打开的会话解密 prompt 和 output 记录，而不是进入界面时就加载每一条保存的内容。报告导入现在也作为后台任务运行，不占用主线程。

v1.9.1–1.9.3

Qwen 成为直接提供商

Qwen 现在可以通过阿里云 Model Studio 的 OpenAI 兼容 DashScope 路由直接选择。ProxyPilot 会区分国际区和中国区 key 指引，并让 Qwen 在自定义提供商列表中保持可见。

v1.8.9

DeepSeek 会话计费

DeepSeek 请求会把 token 和费用数据送入共享会话界面；当提供商返回缓存拆分时，也会带上缓存相关 token。Home 和菜单栏会区分计算得到的提供商成本与估算值。

v1.8.7

会话费用目录缓存

已获取的上游模型价格现在按 provider 持久化，并在应用启动和切换 provider 时重新加载，因此 OpenRouter 请求（如 google/gemini-3.1-pro-preview）在重新构建后仍能解析出费用，不再退回到 N/A。Home 仪表盘的当前会话卡不再因为更新的 GUI 会话进入共享 report store 而退回到较旧的 CLI 会话。

v1.8.3–1.8.5

OpenRouter 费用统计 + Gemini schema 强化

流式请求现在启用 stream_options.include_usage，让 OpenRouter 和其他 OpenAI 兼容 provider 在 stream 块中真正发出 token 计数，从而可以计算会话费用。带 enum 的 object 或 array 节点的 MCP 工具 schema 已为直接 Google 路由和 OpenRouter→Gemini 路由清理。经 OpenRouter→Gemini 的结构化输出保留其 schema 约束，而不是返回 Markdown 包裹的 JSON。Fetch Live Models 获得搜索 + provider + tier 筛选栏。

v1.8.1–1.8.2

Heartbeat 遥测、Copilot 登录 + 审计修复

Keys & Providers 会引导未登录的 Copilot 用户运行 copilot login 或 gh auth login，在 GitHub 已登录但缺少 Copilot 权限时给出明确说明，并提供真实的 streaming tool-call sidecar 检查。本地错误和日志界面也收得更紧。

v1.7.7–1.7.14

Agent 可靠性和安全强化

GUI 现在可以停止由 CLI 拥有的代理。CLI 会话指标通过共享事件存储进入 GUI 的 Session Report Card。Z.ai 凭据会在 agent 启动前验证，已保存但被拒绝的 key 会在打开 Claude Code 前停止会话。严格的 MCP 参数验证会为错误类型、越界端口和无效过滤器返回结构化错误。缺少 PID 文件时的进程发现也能确保状态正确。Z.ai API key 最短长度（20 字符）在 GUI、CLI 和 MCP auth 路径中统一执行。内置代理会在返回任何响应前拒绝非 loopback 客户端。

v1.7.4–1.7.6

路由可见性和证据

实时 Xcode 可见模型面板会刷新 /v1/models 并显示数量和来源。Home 仪表盘现在会显示运行中代理的活动模型，并把 picker 变更标记为等待重启。Last Xcode Agent Live Proof 面板会显示当前会话中最近一次 agent 请求的模型、状态和时间戳。

v1.7.3

Loopback 安全强制执行

内置 GUI 代理现在会在解析任何请求前拒绝非 loopback 客户端连接，因此代理不会在 Mac 的局域网地址上响应 /v1/models。

v1.6.5–1.6.7

原生 Mac 外壳和自定义中心

应用迁移到 NavigationSplitView 侧边栏和原生分组工具栏；支持的系统使用 macOS 26 Liquid Glass，同时提供稳妥的 macOS 15 回退。自定义中心可控制外观、强调色、默认区域、Home 区块可见性、Launch at Login 和菜单栏组成。

v1.6.0–1.6.3

Home 仪表盘和 agent-first 契约

完整的 Home 仪表盘显示运行状态、当前提供商/模型、请求数、token、成本估算、延迟、问题状态、最近请求、CSV 导出和重置。CLI/MCP 契约新增带 schema 版本的 JSON 输出、preflight 和 auth_status MCP 工具，以及面向本地提供商设置的 Xcode 26.5 Locally Hosted 文案。

v1.5.3–1.5.4

GitHub Copilot sidecar 和 OpenAI 兼容性

GitHub Copilot 提供商通过 xcode-copilot-server 路由，支持 launchd/socket 激活、安装/移除控制，并明确 GitHub 计费边界。直接 OpenAI GPT-5.x 和 o-series token 参数兼容性确保翻译后的 Xcode 流量能正确到达新模型家族。

工作原理

让 Xcode 指向 ProxyPilot。上游由你选择。

Xcode 与本地代理端点通信。ProxyPilot 负责路由层：翻译协议形态、重映射模型名、保存提供商 key、检查设置，并让所选上游保持可检查。

Xcode Agent

使用 Xcode Agent 配置，将模型请求发送到你 Mac 上的 ProxyPilot 端点。

->

ProxyPilot

运行在 127.0.0.1:4000，翻译 Anthropic 和 OpenAI 形态的流量，重映射请求的模型名，并跟踪路由状态。

->

你的上游

路由到 z.ai、OpenRouter、OpenAI、Gemini、Ollama/LM Studio、Copilot sidecar，或你自己的 OpenAI 兼容端点。

GUI 界面

围绕当前会话构建的 Mac 应用，而不是一堆隐藏设置。

Home 仪表盘

在同一个首屏查看运行状态、当前提供商/模型、Xcode 路由状态、问题状态、最近请求、token、延迟、成本估算和 CSV 导出。

Key 和提供商

每个提供商都有独立的 Keychain 凭据状态。本地提供商不会要求云端 key，自定义提供商可以指向你自己的 OpenAI 兼容端点。

自定义

选择外观、强调色处理、默认窗口区域、Home 仪表盘区块、Launch at Login、Liquid Glass 控制条行为和菜单栏组成。

自动化

CLI 和 MCP 是一等功能，不是事后补丁。

ProxyPilot 可以为终端工作流无头运行；MCP server 给 agent 明确的恢复路径，而不是让它们从人类文本里猜状态。

无头 CLI

在脚本或 agent 工作流中使用 start、stop、status --json --require-running、auth、config、models --metadata、logs、launch 和 update。

$ proxypilot status --json --require-running
$ proxypilot models --metadata --filter tool-calling
$ proxypilot serve --mcp

13 个 MCP 工具

Agent 可以执行 setup preflight、检查 auth 状态、安全保存 secret、验证本地路由、启动/停止/重启代理、安装/移除 Xcode 配置、列出上游模型、读取日志并查看会话统计。

提供商矩阵

云端 API、本地服务器、sidecar 和自定义路由。

ProxyPilot 让提供商选择保持明确。它不会假装每个上游行为都一样，并把本地/无 key 路由与云端 key 流程分开。

路由 提供商 适合场景
云端 API z.ai, OpenRouter, OpenAI, Google Gemini, xAI, Chutes, Groq, DeepSeek, Mistral, MiniMax, MiniMax CN, Qwen 使用你自己的提供商 key 快速设置，并支持实时模型发现。
本地模型 Ollama, LM Studio, 9Router 无需云端 API key。ProxyPilot 会检测 localhost，避免不相关的 key 提示。
Helper sidecar 通过 xcode-copilot-server 接入的 GitHub Copilot sidecar OpenAI 兼容的 Copilot 路由，并明确计费/访问边界。
自带端点 自定义 OpenAI 兼容端点 私有网关、本地实验环境、公司代理或提供商预览端点。
信任边界

应用只陈述它知道的事，并把本地检查留在本地。

路由状态有明确范围

GUI 拥有的代理状态与 CLI/外部 listener 会分开标记，因此端口 listener 不会被夸大成 GUI 代理拥有该路由的证明。

Telemetry 保持克制

最小化的 app-open 版本采用信号与更广泛的调试分析分开。面向用户的提示现在遵循真实的 onboarding 选择。

Secret 不进普通文件

提供商 key 通过 macOS Keychain 存储。文件回退使用受限权限，日志和诊断会遮蔽 bearer token。

FAQ

先显示最有用的问题。模型细节放在另一个标签里。

默认视图保持简短。需要确认具体上游路径时，模型路由答案仍然可以直接打开。

先看这里

最能减少犹豫的问题。

ProxyPilot 是做什么的？

ProxyPilot 在你的 Mac 上运行本地控制层，让 Xcode Agent 请求可以路由到你选择的上游端点：云端 API、本地 Ollama 或 LM Studio、GitHub Copilot sidecar，以及自定义 OpenAI 兼容端点。

ProxyPilot 会自行把我的代码发送到别处吗？

不会。ProxyPilot 只会把模型请求转发到你配置的上游提供商。应用运行在本机 127.0.0.1，更广泛的调试分析仍然需要主动开启。

支持哪些提供商？

ProxyPilot 支持 z.ai、OpenRouter、OpenAI、Google Gemini、xAI、Chutes、Groq、DeepSeek、Mistral、MiniMax、MiniMax CN、Qwen、9Router、Ollama、LM Studio、通过 sidecar 接入的 GitHub Copilot，以及自定义 OpenAI 兼容端点。

ProxyPilot 免费吗？

是的。ProxyPilot 免费下载和使用。你可以提供自己的上游提供商 key，也可以使用 Ollama 和 LM Studio 这类无需云端 key 的本地提供商。

Agent 可以从终端控制 ProxyPilot 吗？

可以。CLI 提供 start、stop、status、auth、config、models、logs、launch、update 和 MCP server 命令，适合 agent 工作流。

ProxyPilot 支持 Claude Agent 和 OpenAI 兼容提供商吗？

支持。ProxyPilot 会把 Anthropic 风格的 agent 流量翻译到 OpenAI 兼容上游，包括流式传输和 tool-call 路径，同时让不同提供商的凭据保持隔离。

获取 ProxyPilot

安装公开应用或 CLI。

已签名、已 notarize，并带有 Gatekeeper 验证的 stapled ticket。未来版本启用 Sparkle 自动更新。

macOS 菜单栏应用

设置界面、Xcode Agent 设置、提供商 key、Home 仪表盘、会话统计、Sparkle 更新和菜单栏控制。

下载 v1.12.1 DMG 
$ curl -fsSL https://micah.chat/downloads/proxypilot-install.sh | bash

无头 CLI

用于终端工作流和 MCP 控制的单文件二进制。适合在不打开 GUI 的情况下完成设置、代理控制、日志和状态查看。

$ curl -fsSL https://micah.chat/downloads/proxypilot-cli-install.sh | bash
浏览源码
下载已开始。请检查“下载”文件夹。