Skip to content
项目

Ninthless/StackFerry has 30 GitHub stars and 5 forks. GitHot measured 0 stars in 24 hours, 0 in 7 days, and 0 in 15 days. Last checked 2026-11-15 19:55 UTC. Last push 2026-11-02.

这些数字如何统计

实测星标增长

24小时
0
7天
0
15天
0
1个月
正在收集历史

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

Desktop provider manager and local failover router for Codex, Claude Code, and Grok.

开发工具

README.zh-CN.md

原文

StackFerry

StackFerry

English · 简体中文

Release License Platforms X @ninthless

给 Coding CLI 用的桌面控制面。供应商、本地 failover、Skills 和 MCP 收在一处,再写进你启用的那个 CLI。现在可用的是 Codex、Claude Code、Grok 和 Pi。以后会按同样的方式加入更多 CLI。

StackFerry 首页,欢迎说明盖在 Codex 页面上

演示

https://github.com/user-attachments/assets/d73a89a6-6dde-4cb2-8d1f-55257e16d8b3

StackFerry 不替代这些 CLI。它放在旁边:官方登录或自定义网关,写入前先备份,队列非空时在 127.0.0.1 做 failover。

目录

CLI

现在 Codex、Claude Code、Grok、Pi
以后 更多 Coding CLI。每一家都走同一套供应商、路由、Skills 和 MCP。

集成 / 支持的供应商

它做什么

  • 供应商。 每个 CLI 可以是官方登录,也可以是自定义网关。启用时先备份,再写 live 配置。中转站可以发 stackferry:// 导入链接,字段见 docs/provider-import.zh-CN.md。
  • 本地路由。 每个 CLI 一条 failover 队列。队列非空时,请求走本机代理,并带熔断。官方登录不进队列。
  • Skills。 从 GitHub 仓库或本地文件夹导入 SKILL.md,在 StackFerry 里留一份,再投影到 Claude、Codex、Grok、DeepSeek Harness 和 Pi。
  • MCP。 添加 stdio 或 HTTP 服务器,或从 CLI 已有定义导入,并应用到 Claude、Codex、Grok 和/或 Pi。
  • CLI 程序。 检测、安装、更新、卸载本机的 Codex、Claude Code、Grok Build 和 Pi。卸载 CLI 不会删掉 StackFerry 里的供应商数据。
  • 桌面。 简体中文和 English、主题、Windows 11 Mica、首次启动指引、托盘。关窗口是隐藏。退出时把路由写回的配置还原成直连。

已打包的 Windows 和 Linux 会检查 GitHub Releases 并安装更新。macOS 发现新版本时会提示,并打开发布页下载 DMG。

安装

从 Releases 下载最新构建。

平台 安装包 应用内更新
Windows NSIS *-Setup.exe(x64 / arm64) 可用。SmartScreen 可能拦截未签名安装包,选 仍要运行。
Linux AppImage、deb(x64 / arm64) 可用。AppImage 先 chmod +x。AppImageUpdate 也可以从 GitHub Releases 更新 AppImage。deb 更新时可能弹出系统密码框。
macOS ad-hoc 签名 DMG(arm64 / x64) 提示新版本,并打开发布页。安装方式见 macOS。

使用

  1. 打开 StackFerry,选择 Codex、Claude 或 Grok。
  2. 添加自定义网关,或继续用官方登录。
  3. 启用要用的供应商。StackFerry 写入该 CLI 的配置。Codex 的 auth.json 不会被覆盖,切回官方时 ChatGPT 登录还在。
  4. 重启那个 CLI 或它的终端。
  5. 需要时再排 failover 队列。官方登录不会进队列。
  6. 导入 Skills 和 MCP,并应用到你在用的 CLI。

关闭窗口会藏到托盘。退出 会把路由写回的配置还原成直连。

网关可以把人直接带到导入确认:

stackferry://import/providers?v=1&data=<base64url(JSON)>

应用会先弹出确认,只新增自定义供应商,不会自动启用,也不会覆盖同名条目。字段说明见 docs/provider-import.zh-CN.md。

macOS

CI 打出的是 ad-hoc 签名 DMG,不是公证过的 Developer ID 包。Gatekeeper 常会提示已损坏。这是隔离标记(quarantine),不是文件坏了。

  1. 下载 arm64(Apple 芯片)或 x64(Intel)。
  2. 打开 DMG,把 StackFerry.app 拖到 /Applications。不要从 DMG 里直接运行。
  3. 去掉隔离属性:
xattr -dr com.apple.quarantine /Applications/StackFerry.app
  1. 在 Finder 里对应用 按住 Control 再点按 → 打开。若仍被拦,到 系统设置 → 隐私与安全性 → 仍要打开。

不要用 spctl --master-disable 关掉整机 Gatekeeper。换版本后重新做第 3、4 步。

配置落点

CLI 启用时写入
Codex ~/.codex/config.toml(Windows 为 %USERPROFILE%\.codex\config.toml)。不覆盖 auth.json。
Claude Code / Desktop Claude Code settings.json,并同步 Claude Desktop(LOCALAPPDATA / ~/Library/Application Support / XDG_CONFIG_HOME)。
Grok ~/.grok/config.toml
Pi ~/.pi/agent/models.json 和 settings.json(设置了 PI_CODING_AGENT_DIR 时用该目录)。不覆盖 auth.json。

供应商列表、路由队列、Skills、MCP 在应用 userData 目录,不在各 CLI 自己的目录里。

开发

需要 Node >=22.12 和 pnpm 11。

pnpm install
pnpm test
pnpm typecheck
pnpm dev

本机 pnpm build 只打当前平台。

pnpm build:win     # NSIS
pnpm build:mac     # ad-hoc DMG(须 macOS 或 CI)
pnpm build:linux   # AppImage + deb

要发三端包:在 CHANGELOG.md 写好新版本一节,同一节里要有 ### English 和 ### 中文,改 package.json 的 version,再推匹配的 v* 标签(1.0.8 对应标签 v1.0.8)。GitHub Actions 会打 Windows、macOS 和 Linux,用该节作为 Latest Release 说明,并写出 Windows / Linux 应用内更新用的 latest.yml / latest-linux.yml。Linux 任务还会把 AppImage 更新信息写进包内,并在每个 AppImage 旁上传 .zsync。应用按当前语言只显示其中一段。也可手动跑 Release 工作流,只上传产物、不发版。

目录:

  • CHANGELOG.md — 面向用户的更新说明
  • electron/main — 窗口、托盘;各 CLI 的 IPC 和写盘、路由、Skills、MCP、CLI 安装
  • electron/preload — window.stackferry
  • shared — 类型、IPC 名、预设
  • src/features — 各 CLI 工作区(codex、claude、grok)、共用供应商控件、Skills、MCP、设置
  • test — Vitest

参与贡献

问题与缺陷请开 GitHub Issues。欢迎 Pull Request。较大改动请先开 issue。

许可证

GPL-3.0