说明文档

从密钥库到代理守卫,走完新版 All API Deck 工作流。

这份说明按日常使用顺序组织:安装桌面版,同步和测活 API key,查看会话与工具链状态,配置高级代理,再按需要启用防投毒守卫和 mini floating。

快速开始

GitHub Releases 下载对应平台版本。Windows 体验最完整,侧栏、mini floating、悬浮窗和部分客户端接管能力优先在 Windows 下验证。

Windows.exe / .msi
macOSuniversal .dmg
Linux.tar.gz / .deb / AppImage
Windows 自动更新优先选择并拉起 .msi 安装包,.exe 作为兼容兜底资产保留。
  1. 下载并启动桌面版。
  2. 进入密钥库,导入或同步站点记录和 API key。
  3. 按分组、模型和状态快速测活,确认可用 provider。
  4. 打开高级代理,把稳定 provider 交给 Codex、Claude、OpenCode 或 OpenClaw。
  5. 按需要启用防投毒守卫和 mini floating,观察请求行为。

同步密钥库

密钥库是新版的主工作区。顶部会显示本地记录数、状态正常数、上次同步时间和最近批量同步写入结果,下面按站点、API key、状态和专属导出操作组织记录。

常用操作

  • 按全部密钥、项目分组或快捷分组筛选记录。
  • 输入中转站名字快速过滤。
  • 对单条 key 执行快速测活,并复制 key 或 base URL。
  • 通过专属导出按钮把可用记录推给目标客户端。
密钥库页面示意

会话、MCP 与 Skill

新版会话界面把不同客户端的项目会话放在同一处观察。左侧是会话列表与入口图标,右侧展示消息历史;顶部还可切换统计、MCP 和 Skill。

  • 按项目路径和时间找到历史会话。
  • 查看用户与助手消息,快速回溯任务上下文。
  • 集中观察 MCP 与 Skill 状态,减少在多个工具之间切换。
会话与工具链页面示意

高级代理接管

高级代理把 provider 队列、协议 fallback、请求日志和连接记录放在一起。客户端继续请求本地入口,All API Deck 负责选择合适 provider 并记录真实出口。

  1. 在密钥库中选出可用 provider,并确认模型。
  2. 为 Codex、Claude、OpenCode 或 OpenClaw 启用本地代理入口。
  3. 观察调度 Provider、模型、出口 URL、路由轨迹和 HTTP 结果。
  4. 根据耗时、延迟和失败摘要调整 provider 队列。

代理层能力

  • provider 优先级队列和自动故障转移。
  • messages / responses / chat/completions 多协议 fallback。
  • 按 host / key / model 记忆协议偏好。
  • 保留最近连接,固定展示完成状态、会话序号、已用时间、出口、provider 和入口。

高级代理流转图

All API Deck 高级代理流转图
高级代理界面示意

防投毒守卫

防投毒守卫用于配置动态工具链水印策略、随机变化算法 Prompt 和回流校验统计。非流式代理会执行网关校验,流式请求暂只写绕过日志。

  • 防投毒开关关闭后不显示红叉,也不启用相关策略。
  • 严格模式会在存在真实 toolcall 但缺少合法 guard JSON 时直接拒绝。
  • 适合在客户端接管和动态工具链调用场景中降低 Prompt 注入风险。
防投毒详情页面示意

侧栏、miniBar 与悬窗

侧栏 / miniBar / 悬窗用于在主窗口之外持续观察调度状态、组织调用集群和执行快速操作。mini floating 适合在写代码或调试客户端时常驻屏幕边缘。

  • 在侧栏 / miniBar / 悬窗里快速查看记录状态。
  • 对单条记录快速刷新、快速测活和切换模型。
  • 查看 provider 队列、实时调度命中项,并配合高级代理日志定位慢请求或错误路由。
All API Deck 侧栏界面示意
mini floating 状态窗示意

本地开发与构建

项目桌面端位于仓库 desktop/ 目录。建议环境为 Windows 10/11、Go 1.24+、Node.js 24+、npm 11+ 和 WebView2 Runtime。

安装依赖
cd desktop
npm install
开发模式
npm run dev
npm run dev:web
构建
npm run build:desktop
npm run build:desktop-debug
npm run build:web

日志目录

  • Windows:%LOCALAPPDATA%\BatchApiCheck\runtime
  • macOS:~/Library/Application Support/BatchApiCheck/runtime
  • Linux:$XDG_STATE_HOME$XDG_CACHE_HOME 下的 batch-api-check/runtime