【免费下载链接】fyagentFor You Agent——AI 时代的个人随身数字人格。把你的模型、AI 账号、技能、提示词和工作方式带到每一个 AI 工具里。项目地址https://gitcode.com/gh_mirrors/fy/fyagent点击查看免费下载FyAgent 是一款开源的本地桌面应用内置本地代理本地路由能力一键接管 Claude Code、Codex、Gemini CLI 的 API 请求并靠自动故障转移与熔断器机制在供应商故障时毫秒级切换备用供应商实现API 请求零中断。本文面向新手讲清楚它是什么、怎么配、怎么用最稳。一、为什么需要 FyAgent 本地代理日常使用 AI 命令行工具时最常见的痛点有三个供应商不可控主供应商限流、超时或宕机请求直接报错任务中断配置分散易改错Claude、Codex、Gemini 各自的配置文件格式不同手动改baseUrl风险高多供应商难调度想主供应商挂了自动切备用手动做不到。FyAgent 的解法是在127.0.0.1:15721启动一个本地 HTTP 代理服务器把各 CLI 工具的 API 端点指过来由它统一转发。这样故障转移、日志、健康监控都集中在一个面板里完成。相关实现位于 src-tauri/src/proxy/完整使用指南见 docs/guides/proxy-guide-zh.md。二、按应用接管只接管你要接管的那一个接管是 FyAgent 本地代理的核心概念把某个 CLI 应用的请求改道到本地代理。在设置 → 路由页的「路由启用」区域三个应用各自拥有独立开关Claude—— 接管 Claude Code 的 API 请求Codex—— 接管 Codex CLI 的 API 请求Gemini—— 接管 Gemini CLI 的 API 请求。三个开关互相独立你可以只接管 Codex让 Claude 继续走原始配置互不影响。以 Codex 接管 Kimi 为例路由面板会实时显示当前 Provider、活跃连接、请求数与成功率接管时发生了什么启用接管后FyAgent 会自动修改对应应用的配置文件把 API 端点指向本地代理应用被修改的配置文件修改内容Claude~/.claude/settings.jsonapiBaseUrl指向代理Codex~/.codex/config.toml[api] baseUrl指向代理Gemini~/.gemini/.envGEMINI_BASE_URL指向代理关键点原始配置会先安全备份到 FyAgent 数据库点击「停止代理」时一键恢复即使 FyAgent 异常退出重启后也能凭备份识别接管状态。所以不用担心改坏配置。三、自动故障转移熔断器如何守护每个请求这是 FyAgent 本地代理最硬核的部分。核心由三个模块协作供应商路由器provider_router.rs按队列优先级P1 → P2 → …筛选出当前可用的供应商列表熔断器circuit_breaker.rs实时监控每个供应商的健康状态故障转移切换管理器failover_switch.rs切换成功后同步更新托盘菜单与前端状态并做去重防止多个请求同时触发切换。熔断器工作原理熔断器采用经典的三态机Closed正常→ Open熔断→ HalfOpen试探恢复。默认参数如下参数默认值含义失败阈值4 次连续失败达到该次数后打开熔断器成功阈值2 次半开状态下成功 2 次后恢复正常超时时间60 秒熔断后等待多久进入半开试探错误率阈值0.6错误率超过 60% 触发熔断最小请求数10计算错误率前至少需要的请求数故障时的完整链路主供应商连续失败 → 熔断器打开暂停向其发请求 → 路由器自动切换到队列中的下一个供应商 → 请求无感续发 → 超时后进入半开状态试探恢复 → 恢复成功则关闸。整个过程无需人工介入本地转发延迟通常小于 1ms对使用体感几乎无影响。健康状态一目了然供应商卡片上的指示灯直观反映状态绿色为正常、红色为故障/熔断中、灰色为未接入代理或未检测。「运行状态」页还能查看安装、配置、代理等全维度检查项四、快速上手4 步开启零中断第 1 步打开本地路由总开关进入「设置 → 路由」打开「路由总开关」。代理默认监听127.0.0.1:15721端口被占用时可在此修改监听地址与端口第 2 步配置多个供应商在对应应用下添加至少 2 个供应商排成故障转移队列第一个为 P1 主供应商。供应商卡片上标注「需要路由」的需通过本地代理转发。第 3 步启用按应用接管打开「路由启用」中目标应用Claude / Codex / Gemini的开关。FyAgent 会自动备份并改写配置。第 4 步正常干活CLI 照常用请求已经自动经过本地路由。不再需要时点击「停止代理」FyAgent 会关闭服务、恢复所有原始配置并清除代理状态。五、常见问题速查Q故障转移没有生效确认三件事已配置至少 2 个供应商、代理已启动且对应应用接管已开启、该应用的自动故障转移开关已打开。故障转移只在代理模式下工作。Q启用接管后 CLI 报错依次检查代理是否正在运行路由面板状态、供应商 API Key 是否正确、本机网络是否通畅。Q会影响性能吗本地代理转发开销极小通常 1ms仅在开启请求日志且高频请求时会有少量性能影响。Q停止代理会还原配置吗会。「停止代理」会自动恢复所有被接管应用的原始配置若 FyAgent 异常退出重启后点击停止代理同样可恢复。六、小结FyAgent 本地代理把供应商切换这件原本麻烦的事变成了两个开关的事按应用接管决定谁走代理自动故障转移 熔断器决定谁来兜底。配合配置自动备份、健康指示灯与运行状态检查新手也能放心把 API 请求交给它守护。更多细节可参考 docs/guides/proxy-guide-zh.md 与 常见问题手册。赞分享【免费下载链接】fyagentFor You Agent——AI 时代的个人随身数字人格。把你的模型、AI 账号、技能、提示词和工作方式带到每一个 AI 工具里。项目地址https://gitcode.com/gh_mirrors/fy/fyagent点击查看免费下载相关推荐CC Switch v3.9.0 深度解析本地 API 代理、自动故障转移与 Universal Provider 的实现原理CC Switch v3.9.0 深度解析本地 API 代理、自动故障转移与 Universal Provider 的实现原理 CC Switch v3.9.AI 应用开发者工具桌面应用探索ContourView打造个性化的轮廓背景效果探索ContourView打造个性化的轮廓背景效果 在一个充满创意的世界里我们总希望能够让自己的应用与众不同。今天就让我们一起走进ContourView的AI 应用开发者工具桌面应用CC Switch v3.9.0 版本解析本地 API 代理、自动故障转移与统一供应商的完整落地CC Switch v3.9.0 版本解析本地 API 代理、自动故障转移与统一供应商的完整落地 本文基于 CC Switch 仓库中的 v3.9.0 英文版AI 应用开发者工具桌面应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考