xiaobai-switch

skill
Guvenlik Denetimi
Basarisiz
Health Uyari
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 11 GitHub stars
Code Basarisiz
  • spawnSync — Synchronous process spawning in scripts/generate-icons.mjs
  • process.env — Environment variable access in scripts/generate-updater-manifest.mjs
  • network request — Outbound network request in scripts/generate-updater-manifest.mjs
  • process.env — Environment variable access in scripts/validate-updater-signing-secret.mjs
  • crypto private key — Private key handling in scripts/validate-updater-signing-secret.mjs
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

小白也能上手的 Claude Code / Codex 上游配置切换桌面应用 | A cross-platform, site-driven desktop app for switching Claude Code & Codex providers. Only official website: xiaobaiswitch.com

README.md

中文 · English

XiaoBaiSwitch

XiaoBaiSwitch

官网:https://xiaobaiswitch.com

小白也能上手的,以站点驱动的 Claude Code / Codex 上游配置桌面应用。

以「上游站点」为中心:填好 Base URL 与 API Key,拉取或手输模型,再一键应用到 Claude Code 或 Codex。

功能

  • 站点中心:管理多个上游中转,支持多条线路、测速与一键切换
  • 模型管理:从站点拉取模型,也可手输、测试可用性
  • 应用中心:分别为 Claude Code、Codex 选择站点、模型与能力后写入
  • 线路切换:切换后可同步已应用到工具里的地址
  • 配置备份:应用前自动备份,可在应用中心还原
  • 链接导入:通过 xiaobaiswitch:// 链接一键导入站点,不会自动应用到工具
  • 桌面体验:托盘常驻、开机启动、浅色 / 深色主题、简体中文与 English

软件截图

欢迎页 测试模型
欢迎页 测试模型
站点中心 应用中心
站点中心 应用中心

快速开始

  1. 添加一个上游站点,填写名称、Base URL 和 API Key
  2. 拉取模型,或手动添加要用的模型 id
  3. 打开应用中心,选择 Claude Code 或 Codex,确认模型与选项后点击应用
  4. 重启终端或重新打开对应 CLI,使配置生效

同一站点可配置多条线路,第一项为当前默认线路,可随时测速并切换。

从链接导入站点

安装桌面端后,浏览器或其它应用可以打开 xiaobaiswitch:// 链接,拉起 XiaoBaiSwitch 并导入上游站点;导入不会自动应用到 Claude Code / Codex,需在应用中心手动确认。

  1. 安装并打开桌面端
  2. 点击导入链接,应用会切到站点页并弹出确认框
  3. 核对名称、线路、协议、备注和 API Key 前缀后确认
  4. 若链接没有 apikey,确认后会打开预填的添加站点表单,补全密钥再保存

同一协议且线路集合相同(顺序无关)视为同一站点:密钥相同则复用,密钥不同则更新密钥;线路多一条或少一条会新建站点,不会自动合并。

链接格式

xiaobaiswitch://sites?name=<name>&baseurls=<url>[&baseurls=<url>…][&apikey=<key>][&protocol=openai_compatible|anthropic][&notes=<notes>][&codex-compact=1][&codex-vision=1][&codex-imagegen=1][&codex-search=1]
参数 必填 说明
name 站点名称,最长 128
baseurls 线路 Base URL,可写多条,最多 20 条
apikey API Key;省略则确认后打开预填表单,由用户补全
protocol openai_compatible(默认)或 anthropic
notes 备注,最长 2000
codex-compact Codex 远程压缩预设,1 / true / on / yes 为开
codex-vision Codex 识图预设
codex-imagegen Codex 生图预设
codex-search Codex 内置搜索预设

别名:baseurl = baseurlstype=openai / type=anthropic = protocol;其它符合 平台-能力 的 kebab 键会原样存入站点,当前界面只展示 Codex 四个;链接里只要出现任一能力参数,即视为一套完整 Codex 预设(未写的已知键为关);老链接不加这些参数,不会覆盖站点里已有的预设。

多条线路怎么写

第一项是当前 / 默认线路;推荐重复写 baseurls,避免 URL 本身带逗号时被拆错:

xiaobaiswitch://sites?name=Example%20Relay&baseurls=https://a.example.com/v1&baseurls=https://b.example.com/v1&apikey=sk-xxx&protocol=openai_compatible

也接受写在同一个参数里,用逗号或 | 分隔:

xiaobaiswitch://sites?name=Example&baseurls=https://a.example.com/v1,https://b.example.com/v1
xiaobaiswitch://sites?name=Example&baseurls=https://a.example.com/v1|https://b.example.com/v1

baseurlbaseurls 可以混用,按查询串出现顺序合并:

xiaobaiswitch://sites?name=Mix&baseurl=https://first.example.com/v1&baseurls=https://second.example.com/v1

URL 中携带 API Key 可能被浏览器历史、扩展或系统日志记录,不要把真实密钥写在公开页面;推荐登录后的私有后台按需生成,或省略 apikey 让用户在应用内补全。

下载与安装

支持 macOS(Apple Silicon / Intel)与 Windows(x64 / ARM64),请到 Releases 下载对应安装包。

macOS 安装包是 ad-hoc 签名(未使用 Apple Developer ID,也未公证);浏览器下载后,系统可能提示「已损坏」——这是隔离属性,不是文件坏了,「隐私与安全性」不会出现「仍要打开」;把应用拖到「应用程序」后执行:

xattr -cr /Applications/XiaoBaiSwitch.app

然后右键点应用 → 打开。

自动更新

正式发布的桌面端会检查更新,并支持在应用内下载安装;可在 设置 → 关于 手动检查,或开启自动检查。

安全提示

API Key 在应用内加密存储;应用到 Claude Code / Codex 后会以明文写入对应工具的配置,请勿把这些配置同步到不可信云盘。

社区支持

License

MIT

Yorumlar (0)

Sonuc bulunamadi