LinJun CLAUDE.md

linjun - 跨平台 CLIProxyAPI 管理工具

项目概述

基于 CLIProxyAPI 构建的跨平台桌面应用，提供类似 Quotio 的功能，支持 Windows / macOS / Linux 三端。

参考项目

• Quotio - macOS 原生 Swift 实现（仅 macOS）
• CLIProxyAPI - 核心代理服务器（Go 实现）
• ProxyPilot - Windows 原生实现
• ZeroLimit - Tauri + React 实现（参考 UI 设计）

---

技术选型

方案：Electron + React + TypeScript

组件	技术栈	说明
框架	Electron 33+	跨平台桌面应用框架
前端	React 18 + TypeScript	UI 开发
样式	Tailwind CSS	快速 UI 开发
构建	Vite + electron-builder	开发构建工具链
进程管理	child_process	管理 CLIProxyAPI 二进制
系统托盘	Electron Tray API	原生托盘支持

Electron 优势

1. 成熟生态：丰富的 npm 包支持，大量学习资源
2. 开发效率：JavaScript/TypeScript 开发，热重载支持
3. 跨平台一致：一套代码，三端运行
4. 原生能力：完整的系统托盘、通知、菜单支持

CLIProxyAPI 集成方式

由于 CLIProxyAPI 是 Go 编写的，Electron 通过以下方式集成：

1. 内嵌二进制：将 CLIProxyAPI 二进制打包到应用中
2. 进程管理：使用 child_process 启动/停止代理进程
3. HTTP 通信：通过 Management API 与代理交互

---

核心功能规划

Phase 1 - MVP

• 内嵌 CLIProxyAPI 二进制，启动/停止代理服务
• 系统托盘图标 + 基础菜单
• 单账户 OAuth 登录（Claude/Gemini/OpenAI）
• 基础状态显示（运行中/已停止）
• 开机自启动

Phase 2 - 多账户管理

• 多账户管理界面
• Quota 用量追踪（实时刷新）
• 账户切换/负载均衡策略配置（Round Robin / Fill First）
• 自动 Failover 配置

Phase 3 - Agent 配置

• 自动检测已安装的 CLI Agent（Claude Code, OpenCode, Gemini CLI, Amp CLI）
• 一键配置 Agent 使用本地代理
• 配置备份/恢复

Phase 4 - 高级功能

• 请求日志查看
• 实时流量监控图表
• 多语言支持（中/英）
• 自动更新（electron-updater）
• API Key 管理

---

项目结构

cliPlus/
├── package.json
├── electron.vite.config.ts     # Vite + Electron 配置
├── electron-builder.yml        # 打包配置
├── tsconfig.json
│
├── src/
│   ├── main/                   # Electron 主进程
│   │   ├── index.ts            # 主进程入口
│   │   ├── tray.ts             # 系统托盘
│   │   ├── proxy/              # CLIProxyAPI 管理
│   │   │   ├── manager.ts      # 进程管理
│   │   │   ├── api.ts          # Management API 封装
│   │   │   └── binary.ts       # 二进制路径处理
│   │   ├── ipc/                # IPC 通信
│   │   │   └── handlers.ts
│   │   └── utils/
│   │       ├── store.ts        # electron-store 配置存储
│   │       └── autoLaunch.ts   # 开机自启动
│   │
│   ├── preload/                # 预加载脚本
│   │   └── index.ts
│   │
│   └── renderer/               # 渲染进程（React）
│       ├── index.html
│       ├── main.tsx
│       ├── App.tsx
│       ├── components/
│       │   ├── Dashboard/
│       │   ├── Providers/
│       │   ├── Agents/
│       │   ├── Quota/
│       │   └── Settings/
│       ├── hooks/
│       ├── stores/             # Zustand 状态管理
│       ├── services/           # API 调用
│       └── styles/
│
├── resources/                  # 静态资源
│   ├── icon.png
│   ├── icon.ico
│   ├── icon.icns
│   └── binaries/               # CLIProxyAPI 二进制
│       ├── darwin-arm64/
│       ├── darwin-x64/
│       ├── win32-x64/
│       └── linux-x64/
│
└── scripts/
    └── download-binary.ts      # 下载 CLIProxyAPI 二进制