说明文档
从密钥库到代理守卫,走完新版 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 作为兼容兜底资产保留。
- 下载并启动桌面版。
- 进入密钥库,导入或同步站点记录和 API key。
- 按分组、模型和状态快速测活,确认可用 provider。
- 打开高级代理,把稳定 provider 交给 Codex、Claude、OpenCode 或 OpenClaw。
- 按需要启用防投毒守卫和 mini floating,观察请求行为。
同步密钥库
密钥库是新版的主工作区。顶部会显示本地记录数、状态正常数、上次同步时间和最近批量同步写入结果,下面按站点、API key、状态和专属导出操作组织记录。
常用操作
- 按全部密钥、项目分组或快捷分组筛选记录。
- 输入中转站名字快速过滤。
- 对单条 key 执行快速测活,并复制 key 或 base URL。
- 通过专属导出按钮把可用记录推给目标客户端。
会话、MCP 与 Skill
新版会话界面把不同客户端的项目会话放在同一处观察。左侧是会话列表与入口图标,右侧展示消息历史;顶部还可切换统计、MCP 和 Skill。
- 按项目路径和时间找到历史会话。
- 查看用户与助手消息,快速回溯任务上下文。
- 集中观察 MCP 与 Skill 状态,减少在多个工具之间切换。
高级代理接管
高级代理把 provider 队列、协议 fallback、请求日志和连接记录放在一起。客户端继续请求本地入口,All API Deck 负责选择合适 provider 并记录真实出口。
- 在密钥库中选出可用 provider,并确认模型。
- 为 Codex、Claude、OpenCode 或 OpenClaw 启用本地代理入口。
- 观察调度 Provider、模型、出口 URL、路由轨迹和 HTTP 结果。
- 根据耗时、延迟和失败摘要调整 provider 队列。
代理层能力
- provider 优先级队列和自动故障转移。
messages/responses/chat/completions多协议 fallback。- 按 host / key / model 记忆协议偏好。
- 保留最近连接,固定展示完成状态、会话序号、已用时间、出口、provider 和入口。
高级代理流转图
防投毒守卫
防投毒守卫用于配置动态工具链水印策略、随机变化算法 Prompt 和回流校验统计。非流式代理会执行网关校验,流式请求暂只写绕过日志。
- 防投毒开关关闭后不显示红叉,也不启用相关策略。
- 严格模式会在存在真实 toolcall 但缺少合法 guard JSON 时直接拒绝。
- 适合在客户端接管和动态工具链调用场景中降低 Prompt 注入风险。
侧栏、miniBar 与悬窗
侧栏 / miniBar / 悬窗用于在主窗口之外持续观察调度状态、组织调用集群和执行快速操作。mini floating 适合在写代码或调试客户端时常驻屏幕边缘。
- 在侧栏 / miniBar / 悬窗里快速查看记录状态。
- 对单条记录快速刷新、快速测活和切换模型。
- 查看 provider 队列、实时调度命中项,并配合高级代理日志定位慢请求或错误路由。
本地开发与构建
项目桌面端位于仓库 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