Skip to content

README_CN.md

Latest commit

 

History

History
274 lines (206 loc) · 10.1 KB

README_CN.md

File metadata and controls

274 lines (206 loc) · 10.1 KB
Raw

Chat2API

Chat2API Logo

Release License
Electron React TypeScript Platform

English | 官网介绍 | 文档

多平台 AI 服务统一管理工具

Chat2API 通过驱动各大模型的官方 Web UI，实现 0 成本接入主流 AI 大模型。支持 DeepSeek、GLM、Kimi、MiniMax、Qwen、Z.ai 等渠道，可无缝连接 openlcaw、Cline、Roo-Code 等工具，让任何 OpenAI 兼容客户端即刻可用。

Product Preview

✨ 功能特性

  • OpenAI 兼容 API：提供标准 OpenAI 兼容接口，无缝对接现有工具
  • 多服务商支持：支持 DeepSeek (V4 Pro/Flash)、GLM、Kimi (K2.6)、MiniMax、Perplexity 🆕、Qwen、Z.ai 等
  • 🆕 上下文管理：智能对话上下文管理，支持滑动窗口、Token 限制和总结压缩策略
  • 🆕 多轮会话：自动会话复用，支持所有服务商的多轮对话
  • 🆕 工具调用支持：通过提示词工程为所有模型提供通用工具调用能力，兼容 Cherry Studio、Kilo Code 等客户端
  • 🆕 模型映射：灵活的模型名称映射，支持通配符和首选服务商/账户选择
  • 🆕 自定义参数：支持自定义 HTTP Header 开启联网搜索、深度思考、深度研究等功能
  • 🆕 权重负载均衡：账户级别加权随机选择，精细化流量控制
  • 🆕 凭证加密：可切换凭证加密存储
  • 仪表盘监控：实时请求流量、Token 使用量和成功率统计
  • API Key 管理：为本地代理生成和管理密钥
  • 模型管理：查看和管理所有服务商的可用模型
  • 请求日志：独立存储的详细请求日志，性能更优
  • 代理配置：灵活的代理设置和路由策略
  • 系统托盘集成：从菜单栏快速访问状态
  • 多语言支持：支持英文和简体中文
  • 现代界面：简洁响应式界面，支持深色/浅色主题
  • 设置草稿模式：预览设置变更后再保存

🤖 支持的服务商

服务商 认证类型 OAuth 模型
DeepSeek User Token 是 DeepSeek V4 Pro, DeepSeek V4 Flash, DeepSeek-V3.2, DeepSeek-R1
GLM Refresh Token 是 GLM-5
Kimi Cookie/Auth 是 Kimi-K2.6, Kimi-K2.5
MiniMax JWT Token 是 MiniMax-M2.5
🆕 Perplexity JWT Token 是 Sonar, Sonar Pro, Sonar Deep Research
Qwen (国内版) SSO Ticket 是 Qwen3.5-Plus, Qwen3-Max, Qwen3-Flash, Qwen3-Coder, qwen-max-latest
Qwen AI (国际版) JWT Token 是 Qwen3.5-Plus, Qwen3-Max, Qwen3-VL-Plus, Qwen3-Coder-Plus, Qwen-Plus, Qwen-Turbo
Z.ai JWT Token 是 GLM-5, GLM-4.7, GLM-4.6V, GLM-4.6

📥 安装

下载安装

从 GitHub Releases 下载最新版本：

平台 下载文件
macOS (Apple Silicon) Chat2API-x.x.x-arm64.dmg
macOS (Intel) Chat2API-x.x.x-x64.dmg
Windows Chat2API-x.x.x-x64-setup.exe
Linux Chat2API-x.x.x-x64.AppImage 或 .deb

从源码构建

环境要求：

  • Node.js 18+
  • npm
  • Git
# 克隆仓库
git clone https://github.com/leisvip/Chat2API.git
cd Chat2API

# 安装依赖
npm install

# 启动开发服务器
npx electron-vite dev 2>&1

构建生产版本

npm run build              # 构建应用
npm run build:mac          # 构建 macOS 版本 (dmg, zip)
npm run build:win          # 构建 Windows 版本 (nsis)
npm run build:linux        # 构建 Linux 版本 (AppImage, deb)
npm run build:all          # 构建所有平台

📖 使用方法

步骤 1：启动应用

安装完成后，启动 Chat2API。您将看到主仪表盘。

步骤 2：添加供应商

  1. 从侧边栏导航到供应商页面
  2. 点击添加供应商按钮
  3. 选择一个内置供应商（例如 DeepSeek）
  4. 输入您的认证凭证

例如，获取 DeepSeek Token：

  1. 访问 DeepSeek Chat
  2. 开始任意对话
  3. 按 F12 打开开发者工具
  4. 转到 Application > Local Storage
  5. 找到 userToken 并复制其值

步骤 3：配置代理

  1. 从侧边栏导航到代理设置页面
  2. 设置端口（默认：8080）
  3. 选择负载均衡策略：
    • 轮询：在账户间均匀分配请求
    • 填充优先：使用一个账户直到达到限制
    • 故障转移：失败时自动切换
  4. 点击启动代理

步骤 4：测试 API

使用 Python (OpenAI SDK)：

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="http://localhost:8080/v1"
)

response = client.chat.completions.create(
    model="DeepSeek-V3.2",
    messages=[
        {"role": "user", "content": "你好，你是谁？"}
    ]
)

print(response.choices[0].message.content)

步骤 5：管理 API Key（可选）

为了安全，您可以启用 API Key 认证：

  1. 转到 API Keys 页面
  2. 点击新建 API Key
  3. 输入名称和描述
  4. 复制生成的密钥

📸 截图

仪表盘 服务商
Dashboard Providers
代理设置 API Key
Proxy API Keys
模型管理 会话管理
Models Session

⚙️ 设置选项

  • 端口：更改代理监听端口（默认：8080）
  • 路由策略：轮询（Round Robin）或填充优先（Fill First）
  • 自动启动：应用启动时自动启动代理
  • 主题：浅色、深色或跟随系统
  • 语言：英文或简体中文

🏗️ 项目结构

Chat2API/
├── src/
│   ├── main/                    # Electron 主进程
│   │   ├── index.ts            # 应用入口
│   │   ├── tray.ts             # 系统托盘集成
│   │   ├── proxy/              # 代理服务器管理
│   │   ├── ipc/                # IPC 处理器
│   │   └── utils/              # 工具函数
│   ├── preload/                # 上下文桥接
│   └── renderer/               # React 前端
│       ├── components/         # UI 组件
│       ├── pages/              # 页面组件
│       ├── stores/             # Zustand 状态
│       └── hooks/              # 自定义 Hooks
├── build/                      # 构建资源
└── scripts/                    # 构建脚本

🔧 技术栈

组件 技术
框架 Electron 33+
前端 React 18 + TypeScript
样式 Tailwind CSS
状态管理 Zustand
构建工具 Vite + electron-vite
打包工具 electron-builder
服务器 Koa

📁 数据存储

应用数据存储在 ~/.chat2api/ 目录下：

  • config.json - 应用配置
  • providers.json - 服务商设置
  • accounts.json - 账户凭证（加密）
  • logs/ - 请求日志

❓ 常见问题

macOS 提示"应用已损坏，无法打开"？

由于 macOS 的安全机制，非 App Store 下载的应用可能会触发此提示。运行以下命令即可修复：

sudo xattr -rd com.apple.quarantine "/Applications/Chat2API.app"

如何更新？

在 关于 页面检查更新，或从 GitHub Releases 下载最新版本。

🤝 贡献

  1. Fork 本项目
  2. 创建功能分支 (git checkout -b feature/amazing-feature)
  3. 提交更改 (git commit -m 'Add amazing feature')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 提交 Pull Request

📄 许可证

GNU 通用公共许可证 v3.0。详见 LICENSE。

这意味着：

  • ✅ 可以自由使用、修改和分发
  • ✅ 衍生作品必须以相同许可证开源
  • ✅ 必须保留原始版权声明

🙏 致谢