Skip to content

Yoan98/ai-key-manage

Repository files navigation

AI Key Vault

一个更适合自己长期用的 AI API Key 管理小工具。

它不是那种花里胡哨的大平台,核心思路就一件事: 把手上的 Key、地址、模型先收整齐,再用最省事的方式判断它现在到底还能不能用、能看到哪些模型、哪个模型更适合拿来当默认模型。

如果你手里经常有多套 OpenAI 兼容渠道,或者总在不同平台之间来回复制 Key,这个项目基本就是为这种场景准备的。

现在已经支持什么

🔐 配置管理

  • 本地保存多组配置,包含名称、Base URL、API Key、默认模型
  • 自动兼容旧版本本地数据,打开页面后会尽量把历史配置接回来
  • 支持复制单条配置,也支持复制全部配置
  • 支持导出 .txt.md

📥 导入解析

  • 支持粘贴解析,能识别 curl、JSON、环境变量风格文本、结构化文本块、ccswitch:// 链接
  • 支持导入 cc-switch 导出的 .sql 文件,也支持直接粘贴 SQL 文本
  • 支持一次粘贴多个配置,解析后可批量直接新增
  • 支持把解析结果先回填到表单,再决定要不要保存

✅ 可用性测试

  • 支持单条测试,也支持一键测试全部配置
  • 测试结果会记录状态、错误详情、最近测试时间
  • 适合先快速判断某个 Key 和地址现在还能不能打通

🧠 模型识别

  • 支持读取当前 Key 在该渠道下能看到的模型列表
  • 识别完成后会给出推荐模型,并支持复制模型列表
  • 支持在识别结果里直接切换当前模型

⚡ 性能评测

  • 支持按模型做 1 到 3 轮测速
  • 会展示平均耗时、中位耗时、首字时间、成功率、稳定性
  • 支持按模型名或 tag 搜索模型,方便从长列表里筛选
  • 会自动汇总最快模型、首字最快模型、最稳模型,并给出一个默认推荐模型
  • 会自动跳过明显不适合做对话测速的模型,比如 embedding、rerank、部分图像类模型

🔗 CC Switch 联动

  • 支持导出到 CC Switch,也支持直接唤起 CC Switch 导入
  • 当前已适配的目标 App 包括 ClaudeCodexGeminiOpenCodeOpenClaw

这个项目适合谁

  • 手上有多套 AI API Key,想统一收纳的人
  • 经常会忘记某个渠道地址、模型名、Key 放哪了的人
  • 想快速判断某个 Key 还能不能打通的人
  • 想先识别模型,再挑一个更稳、更快默认模型的人
  • 想要一个轻量、自己部署、自己掌控数据的小工具的人

隐私和数据说明

这个项目默认把配置数据保存在浏览器本地的 localStorage 里,不接数据库,也不会帮你托管 Key。

但有一点要说明白: 连通性测试、模型识别、性能评测这类真实联网请求,还是会经过项目自己的同源后端接口转发。这样做主要是为了绕开浏览器直连上游时常见的 CORS 问题。

简单理解就是:

  • 配置数据默认存在你自己的浏览器里
  • 项目没有做数据库存储逻辑
  • 真正发请求测试时,Key 会参与当前这次后端转发请求

快速开始

npm install
npm run dev

打开 http://localhost:3000 就能开始用。

打包部署

npm run build
npm run start

部署到支持 Next.js 的平台也没问题,比如 Vercel、Netlify 等。

Docker 一键部署

项目已经带好 Dockerfiledocker-compose.yml,本机装好 Docker 后,直接执行:

npm run docker:deploy

默认会自动构建镜像并在后台启动容器,然后访问 http://localhost:3000

常用命令:

npm run docker:logs
npm run docker:down

如果你不想走 npm 脚本,也可以直接用:

docker compose up -d --build

使用方式很简单

  1. 填一条配置,或者直接把现成的 curl / JSON / 文本块粘进来
  2. 点“保存配置”或者“粘贴并直接新增”
  3. 先做连通性测试,确认地址和 Key 没问题
  4. 再做模型识别,看看这个渠道到底开放了哪些模型
  5. 如果模型很多,就打开性能评测,跑几轮后挑一个更适合日常使用的默认模型

技术栈

  • Next.js 16
  • React 19
  • TypeScript
  • Tailwind CSS 4
  • ECharts

友链

About

Resources

Stars

202 stars

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors