AKT Relay Hub 使用帮助

Akt Relay Hub · 2026-08-10 05:33:01 · 10 min

AKT Relay Hub 使用帮助
从安装、接入中转站，到模式标签、CLI 托管与智能 Failover 的全流程中文使用指南。

AKT Relay Hub 使用说明

AKT Relay Hub 是一款免费的 AI Key 管理与本地中转站 Windows 桌面工具。它能集中管理多家 AI 提供商的 API Key，并把你的电脑变成一个 OpenAI 兼容（以及 Anthropic 兼容）的本地中转服务，让任意客户端 / CLI 一键接入你配置好的模型。

目录

  1. 安装与启动
  2. 界面总览
  3. 账户 / Key 管理
  4. 本地中转站（核心）
  5. 路由与后端
  6. 模式标签（Mode Tag）
  7. 智能 Failover
  8. 多模态与 AUTO 模式
  9. CLI 工具托管
  10. HUD 桌面灵动岛
  11. 设置详解
  12. 更新 / 公告 / 反馈 / 赞助
  13. 常见问题（FAQ）
  14. 附录：API 端点与环境变量参考

1. 安装与启动

  • 系统要求：Windows 10 / 11 64 位。
  • 获取：前往 GitHub Releases，下载最新 akt_relay_hub_v*_win64.zip。
  • 安装：解压到任意目录，双击 akt_relay_hub.exe 即可运行——绿色便携，无需安装。更新时使用内置 update.exe，不会覆盖你的 config/ 与 debuglog/ 用户数据。
  • 托盘常驻：关闭窗口时应用会收进系统托盘（右下角任务栏图标），中转站继续在后台运行。

2. 界面总览

主界面（Dashboard）是一个一体化面板，主要包含：

区域 说明
账户列表 所有 AI 提供商账号，支持搜索、筛选（状态 / 档位 / 模式标签）、排序、批量测试
实时监控 各后端的总额度、可用 Token、限流等实时状态
中转站状态 本地中转是否开启、监听端口、自动恢复开关、随系统自启
最近请求 最近的请求历史记录
快捷入口 「新建账户」「批量测试」「数据管理」「CLI 管理」「中转服务」等

3. 账户 / Key 管理

这是工具的基础：把你使用的各家 AI API Key 集中录入，统一管理。

  • 新建账户：点击「新建账户」，按向导选择提供商（OpenAI / Anthropic / 各类中转 / 自定 Base URL），填入 API Key、模型、档位与备注。
  • 批量测试：一键对多个 Key 做连通性 / 额度测试，快速筛出失效或额度不足的账号。
  • 配额检测与自动恢复：工具定期探测账号状态；发现额度耗尽 / 失败会自动标记，并在恢复后自动切回。
  • OAuth 自动刷新：对 Codex 等登录型账号（非纯 Key），token 过期后自动刷新，免手动维护。
  • 模型档位：可为每个账号标注模型档位，便于路由分发时按档位匹配。
  • 搜索 / 筛选：按关键词、状态、档位、模式标签过滤，多账号时快速定位。

4. 本地中转站（核心）

中转站把本机变成一个 API 网关：客户端把请求发给 127.0.0.1:10086，中转站按路由分发到上游 AI 提供商，再把结果返回给客户端。

  • 默认监听：127.0.0.1:10086
  • 兼容协议：
    • OpenAI Compatible：/v1/chat/completions、/v1/responses
    • Anthropic Compatible：/v1/messages（供 Claude Code / Claude 桌面版）
  • 开启方式：在主界面「中转站状态」区域启动，或进入「设置 → 中转设置」。可修改监听端口（需重启中转）。
  • 随系统自启：可开启「开机自动启动」，开机即自动拉起中转。

客户端接入方法

任何 OpenAI 兼容客户端，把 Base URL 指向 http://127.0.0.1:10086/v1，API Key 填一个自己账号下的 Key 即可。

5. 路由与后端

路由（Route） 定义"请求怎么分"，后端（Backend） 定义"分到哪家上游"。

  • 一个网关多条路由，每条路由对应一种用途（如聊天、写代码、识别图片）。
  • 一个路由多个后端：同一用途可配多个上游账号，按顺序逐个尝试（配合 Failover）。
  • 自由切换模型：客户端可通过模型名 / 模式标签选择走哪条路由。

提示：为某个路由添加后端时，工具会读取该账号的可选模型，方便你从中选择要暴露的模型 ID。

6. 模式标签（Mode Tag）

给路由打上「模式标签」，把不同对话分发到对应后端，也便于统计与筛选。

配置：新建 / 编辑路由时填写，格式 = 基础模式[/子类]（如 chat、code、code/a）。同一网关内标签不可重复（大小写不敏感）。特殊约定：vision（图片，AUTO 依赖）、audio（音频）。

触发：在消息里以 ~ 或 # 开头带上标签即切换：

~chat 你好，今天天气如何？ #code 帮我写一个排序函数 ~code/a 用 Python 重写上面这段 ~vision 这张图里有什么？

规则：

  • 支持子标签，如 ~code/a；大小写不敏感（~CHAT = ~chat）。
  • ~codexxx（标签后紧跟无空格不触发，按普通文本处理。
  • ~help、~usage 单独使用可查看帮助 / 用量。
  • 只发标签不带内容时，会记住该模式，后续免重复输入。

界面联动：健康面板 / 统计 / 日志按模式分组或筛选；HUD 实时显示当前会话模式；账号列表可按模式标签筛选。

7. 智能 Failover

当某个后端额度耗尽或请求失败时，中转站会自动切换到下一个后端逐个尝试，客户端完全无感。

  • 只要还有可用后端，请求就不会失败。
  • 全部后端都失败才向客户端报错。
  • 切换轨迹可查，方便定位问题。

8. 多模态与 AUTO 模式

  • Vision / 多模态：支持图片（Vision）与音频（Audio）路由。
  • AUTO 多模型串行协同：开启 AUTO 后，多种模型按序分工协作（例如先由视觉模型分析图片、再由代码模型写代码），并把分析结果注入上下文。
    • vision 模式是 AUTO 依赖的特殊标签。
    • 依赖「模式标签」触发：在对话里用 ~vision 或 ~code 等切换。

9. CLI 工具托管

工具能自动发现本机安装的 AI CLI 工具，并可视化配置，省去手改各工具的 jsonc / toml。

支持：Codex · Claude (Claude Code) · opencode · grok · kilo · crush · omp · pi

  • 一键扫描本机已安装 CLI（自动识别可执行文件与配置目录）。
  • 图形化配置：API Key、模型、代理、权限等。
  • 配置写入各工具原生位置（/.codex/、/.config/opencode/、~/.grok/ 等），与工具完全兼容。
  • 深度适配：kilo 自动压缩策略、crush 权限模式等专项设置。

Claude 专属说明（CLI / 桌面版）

  • 地址：只需填 http://127.0.0.1:10086/，Claude Code CLI 与 Claude 桌面版会自动拼接 /v1/messages。
  • 模型 ID（两档）：中转站暴露两个 Claude 模型档位——
    • claude-sonnet-5
    • claude-sonnet-5[1m]（1M 上下文）
  • 支持 Claude 桌面版 1M 上下文档，识别并应用你配置的上下文窗口。

10. HUD 桌面灵动岛

桌面上方一个浮动状态栏，实时显示当前会话模式（~chat、~code 等），类似 iOS 灵动岛。切换模式时一眼可见。在设置中可控制 HUD 显示与否。

11. 设置详解

点击右上角「设置」进入，按分类管理：

安全（Security）

  • 修改密码 / 安全问题：为应用数据设置访问保护；修改时会提示影响。
  • 剪贴板安全：控制是否允许复制 Key / 敏感信息时的安全提醒或拦截。
  • 忘记密码：通过安全问题找回 / 重置。

界面（Interface）

  • 主题：内置多套科幻风主题（aurora / crt / default / flat / forest / ink / mono / neo / neon / ocean / space / sunset 等），一键切换。
  • 界面语言：中文 / English 自由切换（更新说明、公告等会随语言切换）。
  • 仪表盘刷新频率：控制实时监控的刷新间隔。

高级（Advanced）

  • 空闲节能模式：空闲时降低轮询频率，省电省资源；可设空闲扫描间隔。
  • 数据备份：设置备份间隔与备份目录、手动备份、从备份恢复。
  • 数据清理：清空请求历史、统计、全部历史记录。
  • 代理：配置代理（某些网络环境访问上游需要）。
  • 隐私 / 遥测：匿名遥测开关（默认可关，不上传业务数据）。

关于（About）

  • 应用信息 / 构建信息：版本号、Flutter 版本、一键复制信息。
  • 软件更新：点击「检查更新」，自动检测并升级（见下节）。
  • 开发者 / 官网 / 赞助：官网 https://jalpei.com/ ，联系方式，赞助入口。

12. 更新 / 公告 / 反馈 / 赞助

  • 检查更新：设置 → 关于 → 检查更新。检测到新版本会下载 zip、校验 SHA-256，再由内置 update.exe 完成备份 → 解压 → 重启。更新保留 config/ 与 debuglog/。
  • 公告中心：应用右上角喇叭图标，实时接收新功能 / 通知（支持多语言）。
  • 意见反馈：应用内提交使用建议或问题。
  • 赞助支持：关于 → 赞助支持，支持 PayPal（跳转打赏）与支付宝 / 微信（扫码）。

13. 常见问题（FAQ）

Q1：客户端连不上 127.0.0.1:10086？ 确认中转站已在「中转站状态」中开启，端口未被占用（可进入设置改端口），且客户端 Base URL 填对。

Q2：Claude Code 用哪个地址？ 填 http://127.0.0.1:10086/（根路径即可，自动拼 /v1/messages），选 claude-sonnet-5 或 claude-sonnet-5[1m]。

Q3：OpenAI 兼容客户端用哪个地址？ http://127.0.0.1:10086/v1，Key 填你自己账号下的任意 Key。

Q4：不小心登出 / 忘记密码怎么办？ 通过设置里的安全问题找回；或从桌面前面做过的数据备份恢复。

Q5：升级后数据还在吗？ 在，更新器会跳过 config/ 与 debuglog/，你的配置、账号、历史都保留。

Q6：为什么会显示"显示的是缓存数据"？ 公告 / 更新信息在断网或拉取失败时回退到上缓存，属正常兜底。

Q7：想换回某个旧版本 Claude CLI？ 这是 Claude Code 自带版本管理，本工具只负责配置中转地址。若遇到 Claude Code 渲染层问题，可在其官方 issue 中查看（与中转站无关）。

14. 附录：API 端点与环境变量参考

本地中转端点

端点 协议 适用客户端
http://127.0.0.1:10086/v1/chat/completions OpenAI Compatible ChatGPT 系 / Cline / Continue 等
http://127.0.0.1:10086/v1/responses OpenAI Compatible (Responses) Codex CLI 等
http://127.0.0.1:10086/v1/messages Anthropic Compatible Claude Code CLI / Claude 桌面版

上游响应格式约定（面向开发者）

  • 中转站会按上游实际的流式 / 非流式行为对齐请求与响应，避免协议不匹配导致 502。
  • 对严格校验的客户端（如 Codex CLI），若解析报错，多为它解析到了错误信封而非适配层漏字段，可先查客户端侧解析。

作者：jalpei · 官网：https://jalpei.com/ · 联系：guiwork@foxmail.com