Skip to content

README.md

Latest commit

 

History

History
77 lines (53 loc) · 3.18 KB

README.md

File metadata and controls

77 lines (53 loc) · 3.18 KB
Raw

API Manager Lite

基于 Cherry Studio 1.9.12 精简，并使用 Tauri 2 + React + Rust 重新构建的 macOS API 管理器。

当前版本：2.1.0

保留功能

  • 管理 OpenAI 兼容、Anthropic 和 Google Gemini 接口
  • 内置常用服务商，也可以添加自定义服务商
  • 每个服务商可以保存一个默认密钥和多个备用密钥
  • API 密钥保存在 API Manager Lite 本机数据文件中，不依赖系统 Keychain
  • 可以复制密钥、选择当前使用的密钥并检查连接
  • 从服务商的 /models 接口获取、搜索和复制模型 ID
  • 服务商地址与模型列表仅保存在本机
  • 服务商配置与每个服务商的模型缓存分开保存，减少编辑配置时的同步写入
  • 大型模型列表仍可完整搜索，界面最多同时渲染前 50 个匹配项

已从运行时与安装包移除

  • 对话、助手和 Agent
  • 知识库、向量数据库和文档预处理
  • OCR
  • MCP
  • 迷你应用与 WebView
  • API Server、同步、备份、分析、托盘和后台更新服务

本仓库是独立的精简源码，只包含 API Manager Lite 所需代码；上述模块没有进入源码包、编译依赖图或最终安装包。

技术架构

  • 前端：React 19、Vite、Ant Design
  • 桌面外壳与后台：Tauri 2、Rust
  • 系统 WebView：macOS WKWebView
  • 不再打包 Chromium、Node.js、Electron 主进程或 Electron preload

本地开发

需要 Node.js 20.19 或更高版本、pnpm 10 或更高版本，以及 Rust stable 工具链。

pnpm install
pnpm dev

校验与构建

pnpm build:check
pnpm build:zip
pnpm build:mac

macOS 应用与 DMG 输出在 src-tauri/target/release/bundle/。本地发行版使用 ad-hoc 签名，未经 Apple 公证；首次打开时可能需要在 Finder 中右键选择“打开”。

测试阶段使用 pnpm build:zip，只生成免安装 ZIP；最终发布时使用 pnpm build:mac，同时生成 DMG 和 免安装 ZIP。两个流程都会重映射本机编译路径，并校验应用签名和 ZIP 完整性。

数据位置

  • 服务商配置：应用的浏览器本地存储
  • API 密钥：~/Library/Application Support/app.api-manager.lite/api-vault.json

密钥文件权限为 0600，仅当前 macOS 用户可读写。密钥以明文保存，方便复制和管理，请勿共享该文件。复制密钥时，Rust 后台会直接把密钥写入系统剪贴板，不会把已保存的明文密钥返回 React 页面。

API Manager Lite 首次启动时会自动复制 API Manager 1.2.x 的本地密钥文件；旧文件不会被修改。由于 Electron 与 WKWebView 使用不同的浏览器存储，自定义服务商若无法恢复名称与地址，会以待恢复项目显示，密钥仍可复制。

1.1.0 及更早版本使用的 Keychain 加密密钥不会继续显示，需要先在 1.2.x 中重新保存一次。

项目来源与许可证

本项目修改自 Cherry Studio 1.9.12，主要精简与改造工作完成于 2026 年 7 月。项目依据上游许可证继续使用 GNU AGPL-3.0 发布，详细来源和修改说明见 NOTICE.md。

本项目不是 Cherry Studio 官方版本，也不代表 CherryHQ。