ProxyPilot 是做什么的？
ProxyPilot 在你的 Mac 上运行本地控制层，让 Xcode Agent 请求可以路由到你选择的上游端点：云端 API、本地 Ollama 或 LM Studio、GitHub Copilot sidecar，以及自定义 OpenAI 兼容端点。
面向 Xcode Agent 的端点路由
把 Xcode Agent 工作路由到你真正想用的模型。
v1.9.4
CLI v1.9.4
15 个提供商
ProxyPilot 是 Mac 应用、无头 CLI 和 MCP 控制层，用本地代理路由 Xcode Agent 流量。v1.9.4 会说明当前提供商是否真的报告了 prompt cache，用提供商返回的数据展示缓存 token，并在按保留策略删除旧 prompt/output 后给出诚实状态。
$ curl -fsSL https://micah.chat/downloads/proxypilot-install.sh | bash
v1.9.4 更新内容
可以信任的缓存可见性。
ProxyPilot 现在不只告诉你 prompt caching 是否已开启。它会区分当前提供商是否返回了缓存遥测，展示被报告为 cached、uncached 或写入缓存的 token，并在没有可靠缓存信号时明确说明。Session History 也会在本地保留期后标出内容已过期，而不是误导性地说没有记录输入或输出。
v1.9.4
缓存已开启、已报告，或不可用
Home 仪表盘、最近请求和 Session History 现在可以显示缓存只是已配置，还是当前提供商确实返回了缓存数据。如果模型没有返回缓存字段，ProxyPilot 不会编造节省金额。
v1.9.4
cached、uncached 和 cache write token
当提供商在响应中报告缓存使用量时，ProxyPilot 会把 cached read、uncached input 和 cache write 计数带到可见的会话界面。只有提供商明确给出节省金额时，界面才会显示节省金额。
v1.9.4
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 --mcp13 个 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 | 无需云端 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 只会把模型请求转发到你配置的上游提供商。应用运行在本机 127.0.0.1，更广泛的调试分析仍然需要主动开启。
支持哪些提供商？
ProxyPilot 支持 z.ai、OpenRouter、OpenAI、Google Gemini、xAI、Chutes、Groq、DeepSeek、Mistral、MiniMax、MiniMax CN、Qwen、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 路径，同时让不同提供商的凭据保持隔离。
具体上游
常见模型家族和路由方式。
如何用 Xcode Agent 调用 GLM？
选择 z.ai 作为提供商，添加 z.ai API key，选择你想用的 GLM 模型，然后通过 ProxyPilot 安装 Xcode Agent 配置。
如何用 Xcode Agent 调用 DeepSeek？
选择托管 DeepSeek 的提供商，例如 Chutes 或 OpenRouter，添加提供商 key，让 ProxyPilot 把 Xcode Agent 请求翻译到所选 OpenAI 兼容模型路由。
可以用 ProxyPilot 调用 Qwen 吗？
可以。Qwen 可以通过阿里云 Model Studio 的 OpenAI 兼容 DashScope 路由作为直接提供商使用，也仍然可以通过 OpenRouter 或其他兼容上游使用。
如何使用 Llama 模型？
可以用 Groq 获得快速托管 Llama 推理，用 OpenRouter 获得更广模型覆盖，或使用任何提供目标 Llama 模型的 OpenAI 兼容端点。
ProxyPilot 支持 Mistral 模型吗？
支持。可以通过 OpenRouter、Groq、Mistral 兼容网关，或暴露 Mistral 模型的自定义 OpenAI 兼容端点路由。
ProxyPilot 可以路由 GPT-5.x 或 o-series 模型吗？
可以。选择 OpenAI 作为提供商，添加 OpenAI API key，然后选择目标 GPT 或 o-series 模型。ProxyPilot 处理翻译后的 Xcode Agent 请求路径。
如何使用 Grok？
选择 xAI 作为提供商，添加 xAI API key，选择 Grok 模型，然后安装或刷新 Xcode Agent 路由。
可以使用 Gemini 模型吗？
可以。直接选择 Google Gemini，或通过 OpenRouter 路由 Gemini，然后从实时模型列表中选择需要的 Gemini 版本。
路由和边界
本地、sidecar 和自定义路由分别适合哪里。
支持哪些 Xcode 版本？
ProxyPilot 面向当前 Xcode Agent 配置路径，并在设置过程中验证支持情况，而不是假设每个 Xcode 安装都暴露同样的 agent 功能。
本地提供商需要 API key 吗？
不需要。Ollama 和 LM Studio 是本地 no-key 流程。ProxyPilot 会检测 localhost 提供商，避免无关的云端 key 提示。
GitHub Copilot sidecar 路由是什么？
ProxyPilot 可以通过 xcode-copilot-server sidecar 路由到 OpenAI 兼容的 Copilot 访问路径，并明确 GitHub 的计费和访问边界。
可以使用自定义端点吗？
可以。私有网关、实验室服务器、公司代理或提供商预览端点都可以，只要它暴露 OpenAI 兼容端点。
获取 ProxyPilot
安装公开应用或 CLI。
已签名、已 notarize，并带有 Gatekeeper 验证的 stapled ticket。未来版本启用 Sparkle 自动更新。
macOS 菜单栏应用
设置界面、Xcode Agent 设置、提供商 key、Home 仪表盘、会话统计、Sparkle 更新和菜单栏控制。
$ curl -fsSL https://micah.chat/downloads/proxypilot-install.sh | bash无头 CLI
用于终端工作流和 MCP 控制的单文件二进制。适合在不打开 GUI 的情况下完成设置、代理控制、日志和状态查看。
$ curl -fsSL https://micah.chat/downloads/proxypilot-cli-install.sh | bash