【开源自荐】为了能让 Pi Agent 快速切换模型 + 故障转移，我做了 pi-switch

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

• 我的帖子已经打上 开源推广 标签： 是


• 我的开源项目完整开源，无未开源部分： 是


• 我的开源项目已链接认可 LINUX DO 社区： 是


• 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是


• 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

一周前我发帖问 pi agent 目前是否有类似 cc-switch 的切换工具， pi agent 目前是否有类似 cc-switch 的切换工具

发现当前似乎没有直接可供 pi 使用的，带快速切换、并且带故障转移的小工具（当然 PI 本身可以通过配置文件放多个模型进行快速切换）

于是花了几天搓了这个 pi-switch

它做什么，核心就一个：故障转移。当你的主供应商 429/5xx 或者挂了，自动切到备选供应商，带断路器保护（连续 3 次失败冷却 60s，半开探测恢复）。切换供应商和模型反而是附带的基础功能。

其他顺手做的：

• TUI 交互界面（↑↓ 选择，Enter 确认，支持鼠标）


• OpenAI / Anthropic 格式自动转换（透明代理，无感切换）


• 加密备份（AES-256-CBC），每次修改自动生成带时间戳的备份


• 统计面板：按供应商 / 模型统计请求量、成功率、延迟


• 双语支持（EN / 中文）

安装并快速开始

  npm install -g @cokefenta/pi-switch



  # 进入 TUI

  pi-switch tui



  # 或者 CLI

  pi-switch provider add deepseek --preset deepseek --api-key $DEEPSEEK_KEY

  pi-switch provider add siliconflow --preset siliconflow --api-key $SF_KEY

  pi-switch proxy target deepseek

  pi-switch proxy failover siliconflow

  pi-switch proxy start --daemon

详细文档，可以查看：pi-switch

致谢

本项目大量借鉴了 cc-switch 和 cc-switch-cli 的设计思路。感谢这些项目的作者。