简体中文 | English

---

AI Vault · 密钥金库

一个本地优先、端到端加密的 AI API 密钥管理工具。把散落在各家的大模型 API Key 收进一个加密的 .aivault 文件里统一管理——哪个项目在用哪把 key、哪把还能用、余额还剩多少，一目了然。

数据只存本机（或你自己的金库文件），密码经 Argon2id + AES-256-GCM 派生加密，明文密钥永不落盘、绝不上传。

English: AI Vault is a local-first, end-to-end encrypted manager for AI API keys. Keys live in a single encrypted .aivault file (Argon2id + AES-256-GCM). It tracks which project uses which key, key validity, balances and spend — with a built-in local service so the desktop app also serves a mobile-friendly web UI over LAN or Tailscale. Windows 10/11, no runtime dependencies required.

---

✨ 主要特性

• 加密保管：AES-256-GCM 加密，密钥由金库密码经 Argon2id（64 MiB / 3 轮）派生；明文只在解锁后的内存里。
• 层级建模：厂商 → 账号 → 密钥、软件 → 项目，用「主用 / 备用」绑定。
• 余额 / 花费：DeepSeek、Moonshot、OpenRouter、硅基流动直接查；OpenAI / Anthropic 用「管理密钥」查本月花费；通义千问走官方 CLI（可一键安装登录）。
• 有效性检测：逐把 key 调免费接口判断是否失效。
• 余额快照 / 趋势：只在余额变化时记录，能看真实曲线、日消耗、预计可用天数。
• 文件即金库：金库就是一个 .aivault 文件（类似 PSD），改动立即写盘，关软件前再保存一次。
• 手机可用：内置本地服务，手机浏览器连同一 WiFi 即可用；配合 Tailscale 可跨网络（异地）访问。
• 后台运行 / 开机自启：关窗收进右下角托盘继续跑；设置里可开关开机自启。
• .aivault 文件图标：双击即可用本软件打开。
• 便携：免安装文件夹版，拷到任意 Windows 电脑即可运行。

---

🖥 概览 · 一站式看板

数据卡（密钥总数 / 有效密钥 / 即将过期 / 折算余额）、需要关注（会员到期、密钥失效与即将过期）、 以及按账号去重的余额总览。所有数字都来自真实查询，没有假数据。

---

🔑 密钥库 · 随时复制与查看

卡片 / 列表两种视图，按厂商、账号或状态筛选与搜索。每张卡片显示账号余额、日消耗、预计可用天数， 一键复制密钥（30 秒后自动清空剪贴板）。

---

🔎 密钥详情 · 账号、余额与使用位置

点开任意密钥 → 右侧抽屉：所属账号、同一账号下的其他密钥、账号余额（同账号共用）、 余额变化曲线（真实采样）、以及「检测有效性 / 编辑 / 删除」。点曲线还能打开余额变化明细 （大图 + 每次采样的「时间 / 余额 / 变化」表格）。

---

🗂 软件与项目 · 看清每把 key 用在哪

按 软件 → 项目 归类：每个软件下有哪些项目、每个项目正在用哪几把密钥（主用 / 备用）。 编辑项目时可直接搜索并绑定密钥，立即生效。

---

📱 手机端 · 手机浏览器即可用

桌面版内置本地服务：手机浏览器连同一个 WiFi 打开即可用全部功能，电脑与手机共用同一份数据 （密码仍在手机端解密）。配合 Tailscale（免费）还能跨网络、异地访问；支持「添加到主屏幕」当 App 用。

---

⬇️ 下载

到 Releases 下载 AI-Vault-v1.0.0-win-x64.zip：

1. 解压到任意可写目录（别放 C:\Program Files）。
2. 双击 AI Vault.exe。
3. 首次运行若提示「未知发布者」，点「更多信息 → 仍要运行」（未做代码签名）。

无需安装 .NET / Node / Python —— Electron 运行时已打包在内。

🔐 安全

• Argon2id 派生密钥 + AES-256-GCM 加密；明文密钥永不落盘。
• 复制密钥 30 秒后自动清空剪贴板；无操作 10 分钟自动锁定。
• 金库密码只在本机使用，不上传、无遥测。

🛠 开发

npm install
npm run dev          # 开发服务（热更新）
npm run build        # 类型检查 + 打包到 dist/
npm run app:build    # 打桌面版文件夹版 → release/win-unpacked
npm run app          # 直接跑 Electron（开发）
node cli/aivault.mjs selftest   # 命令行端到端自测

技术栈：React 19 + TypeScript + Vite、Tailwind CSS v4、Zustand、Electron。

📄 许可

本项目基于 Apache License 2.0 开源，详见 LICENSE。第三方组件声明见 THIRD-PARTY-NOTICES.md。