mirror of
https://github.com/router-for-me/Cli-Proxy-API-Management-Center.git
synced 2026-02-03 11:20:50 +08:00
Compare commits
31 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
fe11bfb48f | ||
|
|
ee0d8f82d7 | ||
|
|
0bbb397df5 | ||
|
|
27948b3d5c | ||
|
|
dff28db227 | ||
|
|
34b16ca886 | ||
|
|
fa86f76289 | ||
|
|
41ca99978f | ||
|
|
6ef674487f | ||
|
|
2be7ced21a | ||
|
|
b61155d215 | ||
|
|
5488d6153d | ||
|
|
30f5300bb4 | ||
|
|
52169200f1 | ||
|
|
80b2597611 | ||
|
|
04f21eea98 | ||
|
|
f6a4bae8c6 | ||
|
|
c9f09ccf37 | ||
|
|
5b8fd04ba3 | ||
|
|
3c791a2313 | ||
|
|
2ef64d8064 | ||
|
|
f2dc4bcf98 | ||
|
|
5f597afb42 | ||
|
|
e5bef7e2b0 | ||
|
|
d8df9ce680 | ||
|
|
44594220b2 | ||
|
|
86fc9fe86e | ||
|
|
67f009b81c | ||
|
|
6618312360 | ||
|
|
9e49824c52 | ||
|
|
015754237b |
61
.github/workflows/release.yml
vendored
Normal file
61
.github/workflows/release.yml
vendored
Normal file
@@ -0,0 +1,61 @@
|
|||||||
|
name: Build and Release
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
tags:
|
||||||
|
- 'v*'
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
build-and-release:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: write
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Node.js
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: '18'
|
||||||
|
cache: 'npm'
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci
|
||||||
|
|
||||||
|
- name: Build all-in-one HTML
|
||||||
|
run: npm run build
|
||||||
|
|
||||||
|
- name: Prepare release assets
|
||||||
|
run: |
|
||||||
|
cd dist
|
||||||
|
mv index.html management.html
|
||||||
|
ls -lh management.html
|
||||||
|
|
||||||
|
- name: Create Release
|
||||||
|
uses: softprops/action-gh-release@v1
|
||||||
|
with:
|
||||||
|
files: dist/management.html
|
||||||
|
body: |
|
||||||
|
## CLI Proxy API Management Center - ${{ github.ref_name }}
|
||||||
|
|
||||||
|
### Download and Usage
|
||||||
|
1. Download the `management.html` file
|
||||||
|
2. Open it directly in your browser
|
||||||
|
3. All assets (CSS, JavaScript, images) are bundled into this single file
|
||||||
|
|
||||||
|
### Features
|
||||||
|
- Single file, no external dependencies required
|
||||||
|
- Complete management interface for CLI Proxy API
|
||||||
|
- Support for local and remote connections
|
||||||
|
- Multi-language support (Chinese/English)
|
||||||
|
- Dark/Light theme support
|
||||||
|
|
||||||
|
---
|
||||||
|
🤖 Generated with GitHub Actions
|
||||||
|
draft: false
|
||||||
|
prerelease: false
|
||||||
|
env:
|
||||||
|
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
22
.gitignore
vendored
Normal file
22
.gitignore
vendored
Normal file
@@ -0,0 +1,22 @@
|
|||||||
|
# Node modules
|
||||||
|
node_modules/
|
||||||
|
|
||||||
|
# Build output
|
||||||
|
dist/
|
||||||
|
|
||||||
|
# Temporary build files
|
||||||
|
index.build.html
|
||||||
|
|
||||||
|
# npm lock files
|
||||||
|
package-lock.json
|
||||||
|
|
||||||
|
# IDE and editor files
|
||||||
|
.vscode/
|
||||||
|
.idea/
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
*~
|
||||||
|
|
||||||
|
# OS files
|
||||||
|
.DS_Store
|
||||||
|
Thumbs.db
|
||||||
69
BUILD_RELEASE.md
Normal file
69
BUILD_RELEASE.md
Normal file
@@ -0,0 +1,69 @@
|
|||||||
|
# Build and Release Instructions
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
This project uses webpack to bundle all HTML, CSS, JavaScript, and images into a single all-in-one HTML file. The GitHub workflow automatically builds and releases this file when you create a new tag.
|
||||||
|
|
||||||
|
## How to Create a Release
|
||||||
|
|
||||||
|
1. Make sure all your changes are committed
|
||||||
|
2. Create and push a new tag:
|
||||||
|
```bash
|
||||||
|
git tag v1.0.0
|
||||||
|
git push origin v1.0.0
|
||||||
|
```
|
||||||
|
3. The GitHub workflow will automatically:
|
||||||
|
- Install dependencies
|
||||||
|
- Build the all-in-one HTML file using webpack
|
||||||
|
- Create a new release with the tag
|
||||||
|
- Upload the bundled HTML file to the release
|
||||||
|
|
||||||
|
## Manual Build
|
||||||
|
|
||||||
|
To build locally:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Install dependencies
|
||||||
|
npm install
|
||||||
|
|
||||||
|
# Build the all-in-one HTML file
|
||||||
|
npm run build
|
||||||
|
```
|
||||||
|
|
||||||
|
The output will be in the `dist/` directory as `index.html`.
|
||||||
|
|
||||||
|
## How It Works
|
||||||
|
|
||||||
|
1. **build-scripts/prepare-html.js**: Pre-build script
|
||||||
|
- Reads the original `index.html`
|
||||||
|
- Removes local CSS and JavaScript references
|
||||||
|
- Generates temporary `index.build.html` for webpack
|
||||||
|
|
||||||
|
2. **webpack.config.js**: Configures webpack to bundle all assets
|
||||||
|
- Uses `style-loader` to inline CSS
|
||||||
|
- Uses `asset/inline` to embed images as base64
|
||||||
|
- Uses `html-inline-script-webpack-plugin` to inline JavaScript
|
||||||
|
- Uses `index.build.html` as template (generated dynamically)
|
||||||
|
|
||||||
|
3. **bundle-entry.js**: Entry point that imports all resources
|
||||||
|
- Imports CSS files
|
||||||
|
- Imports JavaScript modules
|
||||||
|
- Imports and sets logo image
|
||||||
|
|
||||||
|
4. **package.json scripts**:
|
||||||
|
- `prebuild`: Automatically runs before build to generate `index.build.html`
|
||||||
|
- `build`: Runs webpack to bundle everything
|
||||||
|
- `postbuild`: Cleans up temporary `index.build.html` file
|
||||||
|
|
||||||
|
5. **.github/workflows/release.yml**: GitHub workflow
|
||||||
|
- Triggers on tag push
|
||||||
|
- Builds the project (prebuild → build → postbuild)
|
||||||
|
- Creates a release with the bundled HTML file
|
||||||
|
|
||||||
|
## External Dependencies
|
||||||
|
|
||||||
|
The bundled HTML file still relies on these CDN resources:
|
||||||
|
- Font Awesome (icons)
|
||||||
|
- Chart.js (charts and graphs)
|
||||||
|
|
||||||
|
These are loaded from CDN to keep the file size reasonable and leverage browser caching.
|
||||||
279
README.md
279
README.md
@@ -1,145 +1,210 @@
|
|||||||
# Cli-Proxy-API-Management-Center
|
# Cli-Proxy-API-Management-Center
|
||||||
这是一个用于管理 CLI Proxy API 的现代化 Web 界面。
|
This is a modern web interface for managing the CLI Proxy API.
|
||||||
|
|
||||||
## 功能特点
|
[中文文档](README_CN.md)
|
||||||
|
|
||||||
### 认证管理
|
Main Project:
|
||||||
- 支持管理密钥认证
|
https://github.com/router-for-me/CLIProxyAPI
|
||||||
- 可配置 API 基础地址
|
|
||||||
- 实时连接状态检测
|
|
||||||
|
|
||||||
### 基础设置
|
Example URL:
|
||||||
- **调试模式**: 开启/关闭调试功能
|
https://remote.router-for.me/
|
||||||
- **代理设置**: 配置代理服务器 URL
|
|
||||||
- **请求重试**: 设置请求重试次数
|
|
||||||
- **配额管理**: 配置超出配额时的行为
|
|
||||||
- **本地访问**: 允许本地未认证访问
|
|
||||||
|
|
||||||
### API 密钥管理
|
Minimum required version: ≥ 6.0.0
|
||||||
- **代理服务认证密钥**: 管理用于代理服务的 API 密钥
|
Recommended version: ≥ 6.0.19
|
||||||
- **Gemini API**: 管理 Google Gemini 生成式语言 API 密钥
|
|
||||||
- **Codex API**: 管理 OpenAI Codex API 配置
|
|
||||||
- **Claude API**: 管理 Anthropic Claude API 配置
|
|
||||||
- **OpenAI 兼容提供商**: 管理 OpenAI 兼容的第三方提供商
|
|
||||||
|
|
||||||
### 认证文件管理
|
Since version 6.0.19, the WebUI has been rolled into the main program. You can access it by going to `/management.html` on the external port after firing up the main project.
|
||||||
- 上传认证 JSON 文件
|
|
||||||
- 下载现有认证文件
|
|
||||||
- 删除单个或所有认证文件
|
|
||||||
- 显示文件详细信息
|
|
||||||
|
|
||||||
### 系统监控
|
## Features
|
||||||
- 实时 API 连接状态
|
|
||||||
- 最后更新时间跟踪
|
|
||||||
- 详细的错误信息提示
|
|
||||||
|
|
||||||
## 使用方法
|
### Authentication Management
|
||||||
|
- Supports management key authentication
|
||||||
|
- Configurable API base address
|
||||||
|
- Real-time connection status detection
|
||||||
|
- Auto-login with saved credentials
|
||||||
|
- Language and theme switching
|
||||||
|
|
||||||
### 1. 直接使用(推荐)
|
### Basic Settings
|
||||||
直接用浏览器打开 `index.html` 文件即可使用。
|
- **Debug Mode**: Enable/disable debugging
|
||||||
|
- **Proxy Settings**: Configure proxy server URL
|
||||||
|
- **Request Retries**: Set the number of request retries
|
||||||
|
- **Quota Management**: Configure behavior when the quota is exceeded
|
||||||
|
- Auto-switch project when quota exceeded
|
||||||
|
- Switch to preview models when quota exceeded
|
||||||
|
|
||||||
### 2. 使用本地服务器
|
### API Key Management
|
||||||
|
- **Proxy Service Authentication Key**: Manage API keys for the proxy service
|
||||||
|
- **Gemini API**: Manage Google Gemini generative language API keys
|
||||||
|
- **Codex API**: Manage OpenAI Codex API configuration
|
||||||
|
- **Claude API**: Manage Anthropic Claude API configuration
|
||||||
|
- **OpenAI-Compatible Providers**: Manage OpenAI-compatible third-party providers
|
||||||
|
|
||||||
|
### Authentication File Management
|
||||||
|
- Upload authentication JSON files
|
||||||
|
- Download existing authentication files
|
||||||
|
- Delete single or all authentication files
|
||||||
|
- Display file details
|
||||||
|
- **Gemini Web Token**: Direct authentication using browser cookies
|
||||||
|
|
||||||
|
### Usage Statistics
|
||||||
|
- **Real-time Analytics**: Track API usage with interactive charts
|
||||||
|
- **Request Trends**: Visualize request patterns by hour/day
|
||||||
|
- **Token Usage**: Monitor token consumption over time
|
||||||
|
- **API Details**: Detailed statistics for each API endpoint
|
||||||
|
- **Success/Failure Rates**: Track API reliability metrics
|
||||||
|
|
||||||
|
### System Information
|
||||||
|
- **Connection Status**: Real-time connection monitoring
|
||||||
|
- **Configuration Status**: Track configuration loading state
|
||||||
|
- **Server Information**: Display server address and management key
|
||||||
|
- **Last Update**: Show when data was last refreshed
|
||||||
|
|
||||||
|
|
||||||
|
## How to Use
|
||||||
|
|
||||||
|
### 1. Using After CLI Proxy API Program Launch (Recommended)
|
||||||
|
Once the CLI Proxy API program is up and running, you can access the WebUI at `http://your-server-IP:8317/management.html`.
|
||||||
|
|
||||||
|
### 2. Direct Use
|
||||||
|
Simply open the `index.html` file directly in your browser to use it.
|
||||||
|
|
||||||
|
### 3. Use a Local Server
|
||||||
|
|
||||||
|
#### Option A: Using Node.js (npm)
|
||||||
```bash
|
```bash
|
||||||
# 安装依赖
|
# Install dependencies
|
||||||
npm install
|
npm install
|
||||||
|
|
||||||
# 使用默认端口(3000)
|
# Start the server on the default port (3000)
|
||||||
npm start
|
npm start
|
||||||
```
|
```
|
||||||
|
|
||||||
### 3. 配置 API 连接
|
#### Option B: Using Python
|
||||||
1. 打开管理界面
|
```bash
|
||||||
2. 在认证配置区域输入:
|
# Python 3.x
|
||||||
- **API 地址**: `http://localhost:8317`/v0/management将会自动为您补全
|
python -m http.server 8000
|
||||||
- **管理密钥**: 您的管理密钥
|
|
||||||
3. 点击"测试连接"按钮
|
|
||||||
4. 连接成功后即可使用所有功能
|
|
||||||
|
|
||||||
## 界面说明
|
```
|
||||||
|
|
||||||
### 导航菜单
|
Then open `http://localhost:8000` in your browser.
|
||||||
- **基础设置**: 调试、代理、重试等基本配置
|
|
||||||
- **API 密钥**: 各种 API 服务的密钥管理
|
|
||||||
- **AI 提供商**: AI 服务提供商配置
|
|
||||||
- **认证文件**: 认证文件的上传下载管理
|
|
||||||
- **系统信息**: 连接状态和系统信息
|
|
||||||
|
|
||||||
### 操作按钮
|
### 3. Configure Connection
|
||||||
- **刷新全部**: 重新加载所有配置数据
|
1. Open the management interface.
|
||||||
- **连接状态**: 检查 API 连接状态
|
2. On the login screen, enter:
|
||||||
- **添加**: 添加新的配置项
|
- **Remote Address**: The current version automatically picks up the remote address from where you're connecting. But you can also set your own address if you prefer.
|
||||||
- **编辑**: 编辑现有配置
|
- **Management Key**: Your management key
|
||||||
- **删除**: 删除配置项
|
3. Click the "Connect" button.
|
||||||
|
4. Once connected successfully, all features will be available.
|
||||||
|
|
||||||
## 特性亮点
|
## Interface Description
|
||||||
|
|
||||||
### 现代化 UI
|
### Navigation Menu
|
||||||
- 响应式设计,支持各种屏幕尺寸
|
- **Basic Settings**: Basic configurations like debugging, proxy, retries, etc.
|
||||||
- 美观的渐变色彩和阴影效果
|
- **API Keys**: Management of keys for various API services.
|
||||||
- 流畅的动画和过渡效果
|
- **AI Providers**: Configuration for AI service providers.
|
||||||
- 直观的图标和状态指示
|
- **Auth Files**: Upload and download management for authentication files.
|
||||||
|
- **Usage Stats**: Real-time analytics and usage statistics with interactive charts.
|
||||||
|
- **System Info**: Connection status and system information.
|
||||||
|
|
||||||
### 实时更新
|
### Login Interface
|
||||||
- 配置更改立即生效
|
- **Auto-connection**: Automatically attempts to connect using saved credentials
|
||||||
- 实时状态反馈
|
- **Custom Connection**: Manual configuration of API base address
|
||||||
- 自动数据刷新
|
- **Current Address Detection**: Automatically detects and uses current access address
|
||||||
|
- **Language Switching**: Support for multiple languages (English/Chinese)
|
||||||
|
- **Theme Switching**: Light and dark theme support
|
||||||
|
|
||||||
### 安全特性
|
## Feature Highlights
|
||||||
- 密钥遮蔽显示
|
|
||||||
|
|
||||||
### 响应式设计
|
### Modern UI
|
||||||
- 完美适配桌面和移动设备
|
- Responsive design, supports all screen sizes
|
||||||
- 自适应布局
|
- Beautiful gradient colors and shadow effects
|
||||||
- 触摸友好的交互
|
- Smooth animations and transition effects
|
||||||
|
- Intuitive icons and status indicators
|
||||||
|
- Dark/Light theme support with system preference detection
|
||||||
|
- Mobile-friendly sidebar with overlay
|
||||||
|
|
||||||
## 技术栈
|
### Real-time Updates
|
||||||
|
- Configuration changes take effect immediately
|
||||||
|
- Real-time status feedback
|
||||||
|
- Automatic data refresh
|
||||||
|
- Live usage statistics with interactive charts
|
||||||
|
- Real-time connection status monitoring
|
||||||
|
|
||||||
- **前端**: 纯 HTML、CSS、JavaScript
|
### Security Features
|
||||||
- **样式**: CSS3 + Flexbox/Grid
|
- Masked display for keys
|
||||||
- **图标**: Font Awesome 6.4.0
|
- Secure credential storage
|
||||||
- **字体**: Segoe UI 系统字体
|
- Auto-login with encrypted local storage
|
||||||
- **API**: RESTful API 调用
|
|
||||||
|
|
||||||
## 故障排除
|
### Responsive Design
|
||||||
|
- Perfectly adapts to desktop and mobile devices
|
||||||
|
- Adaptive layout with collapsible sidebar
|
||||||
|
- Touch-friendly interactions
|
||||||
|
- Mobile menu with overlay
|
||||||
|
|
||||||
### 连接问题
|
### Analytics & Monitoring
|
||||||
1. 确认 CLI Proxy API 服务正在运行
|
- Interactive charts powered by Chart.js
|
||||||
2. 检查 API 地址是否正确
|
- Real-time usage statistics
|
||||||
3. 验证管理密钥是否有效
|
- Request trend visualization
|
||||||
4. 确认防火墙设置允许连接
|
- Token consumption tracking
|
||||||
|
- API performance metrics
|
||||||
|
|
||||||
### 数据不更新
|
## Tech Stack
|
||||||
1. 点击"刷新全部"按钮
|
|
||||||
2. 检查网络连接
|
|
||||||
3. 查看浏览器控制台错误信息
|
|
||||||
|
|
||||||
## 开发说明
|
- **Frontend**: Plain HTML, CSS, JavaScript (ES6+)
|
||||||
|
- **Styling**: CSS3 + Flexbox/Grid with CSS Variables
|
||||||
|
- **Icons**: Font Awesome 6.4.0
|
||||||
|
- **Charts**: Chart.js for interactive data visualization
|
||||||
|
- **Fonts**: Segoe UI system font
|
||||||
|
- **API**: RESTful API calls with automatic authentication
|
||||||
|
- **Internationalization**: Custom i18n system with English/Chinese support
|
||||||
|
- **Theme System**: CSS custom properties for dynamic theming
|
||||||
|
- **Storage**: LocalStorage for user preferences and credentials
|
||||||
|
|
||||||
### 文件结构
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Connection Issues
|
||||||
|
1. Confirm that the CLI Proxy API service is running.
|
||||||
|
2. Check if the API address is correct.
|
||||||
|
3. Verify that the management key is valid.
|
||||||
|
4. Ensure your firewall settings allow the connection.
|
||||||
|
|
||||||
|
### Data Not Updating
|
||||||
|
1. Click the "Refresh All" button.
|
||||||
|
2. Check your network connection.
|
||||||
|
3. Check the browser's console for any error messages.
|
||||||
|
|
||||||
|
## Development Information
|
||||||
|
|
||||||
|
### File Structure
|
||||||
```
|
```
|
||||||
webui/
|
webui/
|
||||||
├── index.html # 主页面
|
├── index.html # Main page with responsive layout
|
||||||
├── styles.css # 样式文件
|
├── styles.css # Stylesheet with theme support
|
||||||
├── app.js # 应用逻辑
|
├── app.js # Application logic and API management
|
||||||
├── package.json # 项目配置
|
├── i18n.js # Internationalization support (EN/CN)
|
||||||
└── README.md # 说明文档
|
├── package.json # Project configuration
|
||||||
|
├── build.js # Build script for production
|
||||||
|
├── bundle-entry.js # Entry point for bundling
|
||||||
|
├── build-scripts/ # Build utilities
|
||||||
|
│ └── prepare-html.js # HTML preparation script
|
||||||
|
├── logo.jpg # Application logo
|
||||||
|
├── LICENSE # MIT License
|
||||||
|
├── README.md # English documentation
|
||||||
|
├── README_CN.md # Chinese documentation
|
||||||
|
└── BUILD_RELEASE.md # Build and release notes
|
||||||
```
|
```
|
||||||
|
|
||||||
### API 调用
|
### API Calls
|
||||||
所有 API 调用都通过 `CLIProxyManager` 类的 `makeRequest` 方法处理,包含:
|
All API calls are handled through the `makeRequest` method of the `ManagerAPI` class, which includes:
|
||||||
- 自动添加认证头
|
- Automatic addition of authentication headers
|
||||||
- 错误处理
|
- Error handling
|
||||||
- JSON 响应解析
|
- JSON response parsing
|
||||||
|
|
||||||
### 状态管理
|
### State Management
|
||||||
- 本地存储保存 API 地址和密钥
|
- API address and key are saved in local storage
|
||||||
- 内存中维护连接状态
|
- Connection status is maintained in memory
|
||||||
- 实时数据刷新机制
|
- Real-time data refresh mechanism
|
||||||
|
|
||||||
## 许可证
|
## Contributing
|
||||||
|
We welcome Issues and Pull Requests to improve this project! We encourage more developers to contribute to the enhancement of this WebUI!
|
||||||
|
|
||||||
MIT License
|
This project is licensed under the MIT License.
|
||||||
|
|
||||||
## 贡献
|
|
||||||
|
|
||||||
欢迎提交 Issue 和 Pull Request 来改进这个项目!
|
|
||||||
|
|||||||
207
README_CN.md
Normal file
207
README_CN.md
Normal file
@@ -0,0 +1,207 @@
|
|||||||
|
# Cli-Proxy-API-Management-Center
|
||||||
|
这是一个用于管理 CLI Proxy API 的现代化 Web 界面。
|
||||||
|
|
||||||
|
主项目
|
||||||
|
https://github.com/router-for-me/CLIProxyAPI
|
||||||
|
|
||||||
|
示例网站:
|
||||||
|
https://remote.router-for.me/
|
||||||
|
|
||||||
|
最低可用版本 ≥ 6.0.0
|
||||||
|
推荐版本 ≥ 6.0.19
|
||||||
|
自6.0.19起WebUI已经集成在主程序中 可以通过主项目开启的外部端口的`/management.html`访问
|
||||||
|
|
||||||
|
## 功能特点
|
||||||
|
|
||||||
|
### 认证管理
|
||||||
|
- 支持管理密钥认证
|
||||||
|
- 可配置 API 基础地址
|
||||||
|
- 实时连接状态检测
|
||||||
|
- 自动登录保存的凭据
|
||||||
|
- 语言和主题切换
|
||||||
|
|
||||||
|
### 基础设置
|
||||||
|
- **调试模式**: 开启/关闭调试功能
|
||||||
|
- **代理设置**: 配置代理服务器 URL
|
||||||
|
- **请求重试**: 设置请求重试次数
|
||||||
|
- **配额管理**: 配置超出配额时的行为
|
||||||
|
- 超出配额时自动切换项目
|
||||||
|
- 超出配额时切换到预览模型
|
||||||
|
|
||||||
|
### API 密钥管理
|
||||||
|
- **代理服务认证密钥**: 管理用于代理服务的 API 密钥
|
||||||
|
- **Gemini API**: 管理 Google Gemini 生成式语言 API 密钥
|
||||||
|
- **Codex API**: 管理 OpenAI Codex API 配置
|
||||||
|
- **Claude API**: 管理 Anthropic Claude API 配置
|
||||||
|
- **OpenAI 兼容提供商**: 管理 OpenAI 兼容的第三方提供商
|
||||||
|
|
||||||
|
### 认证文件管理
|
||||||
|
- 上传认证 JSON 文件
|
||||||
|
- 下载现有认证文件
|
||||||
|
- 删除单个或所有认证文件
|
||||||
|
- 显示文件详细信息
|
||||||
|
- **Gemini Web Token**: 使用浏览器 Cookie 直接认证
|
||||||
|
|
||||||
|
### 使用统计
|
||||||
|
- **实时分析**: 通过交互式图表跟踪 API 使用情况
|
||||||
|
- **请求趋势**: 按小时/天可视化请求模式
|
||||||
|
- **Token 使用**: 监控 Token 消耗随时间变化
|
||||||
|
- **API 详情**: 每个 API 端点的详细统计
|
||||||
|
- **成功率/失败率**: 跟踪 API 可靠性指标
|
||||||
|
|
||||||
|
### 系统信息
|
||||||
|
- **连接状态**: 实时连接监控
|
||||||
|
- **配置状态**: 跟踪配置加载状态
|
||||||
|
- **服务器信息**: 显示服务器地址和管理密钥
|
||||||
|
- **最后更新**: 显示数据最后刷新时间
|
||||||
|
|
||||||
|
|
||||||
|
## 使用方法
|
||||||
|
|
||||||
|
### 1. 在CLI Proxy API程序启动后使用 (推荐)
|
||||||
|
在启动了CLI Proxy API程序后 访问`http://您的服务器IP:8317/management.html`使用
|
||||||
|
|
||||||
|
### 2. 直接使用
|
||||||
|
直接用浏览器打开 `index.html` 文件即可使用。
|
||||||
|
|
||||||
|
### 3. 使用本地服务器
|
||||||
|
|
||||||
|
#### 方法A:使用 Node.js (npm)
|
||||||
|
```bash
|
||||||
|
# 安装依赖
|
||||||
|
npm install
|
||||||
|
|
||||||
|
# 使用默认端口(3000)
|
||||||
|
npm start
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 方法B:使用 Python
|
||||||
|
```bash
|
||||||
|
# Python 3.x
|
||||||
|
python -m http.server 8000
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
然后在浏览器中打开 `http://localhost:8000`。
|
||||||
|
|
||||||
|
### 3. 配置连接
|
||||||
|
1. 打开管理界面
|
||||||
|
2. 在登录界面上输入:
|
||||||
|
- **远程地址**: 现版本远程地址将会自动从您的访问地址中获取 当然您也可以自定义
|
||||||
|
- **管理密钥**: 您的管理密钥
|
||||||
|
3. 点击"连接"按钮
|
||||||
|
4. 连接成功后即可使用所有功能
|
||||||
|
|
||||||
|
## 界面说明
|
||||||
|
|
||||||
|
### 导航菜单
|
||||||
|
- **基础设置**: 调试、代理、重试等基本配置
|
||||||
|
- **API 密钥**: 各种 API 服务的密钥管理
|
||||||
|
- **AI 提供商**: AI 服务提供商配置
|
||||||
|
- **认证文件**: 认证文件的上传下载管理
|
||||||
|
- **使用统计**: 实时分析和使用统计,包含交互式图表
|
||||||
|
- **系统信息**: 连接状态和系统信息
|
||||||
|
|
||||||
|
### 登录界面
|
||||||
|
- **自动连接**: 使用保存的凭据自动尝试连接
|
||||||
|
- **自定义连接**: 手动配置 API 基础地址
|
||||||
|
- **当前地址检测**: 自动检测并使用当前访问地址
|
||||||
|
- **语言切换**: 支持多种语言(英文/中文)
|
||||||
|
- **主题切换**: 支持明暗主题
|
||||||
|
|
||||||
|
## 特性亮点
|
||||||
|
|
||||||
|
### 现代化 UI
|
||||||
|
- 响应式设计,支持各种屏幕尺寸
|
||||||
|
- 美观的渐变色彩和阴影效果
|
||||||
|
- 流畅的动画和过渡效果
|
||||||
|
- 直观的图标和状态指示
|
||||||
|
- 明暗主题支持,自动检测系统偏好
|
||||||
|
- 移动端友好的侧边栏和遮罩
|
||||||
|
|
||||||
|
### 实时更新
|
||||||
|
- 配置更改立即生效
|
||||||
|
- 实时状态反馈
|
||||||
|
- 自动数据刷新
|
||||||
|
- 实时使用统计和交互式图表
|
||||||
|
- 实时连接状态监控
|
||||||
|
|
||||||
|
### 安全特性
|
||||||
|
- 密钥遮蔽显示
|
||||||
|
- 安全凭据存储
|
||||||
|
- 加密本地存储自动登录
|
||||||
|
|
||||||
|
### 响应式设计
|
||||||
|
- 完美适配桌面和移动设备
|
||||||
|
- 自适应布局,可折叠侧边栏
|
||||||
|
- 触摸友好的交互
|
||||||
|
- 移动端菜单和遮罩
|
||||||
|
|
||||||
|
### 分析与监控
|
||||||
|
- Chart.js 驱动的交互式图表
|
||||||
|
- 实时使用统计
|
||||||
|
- 请求趋势可视化
|
||||||
|
- Token 消耗跟踪
|
||||||
|
- API 性能指标
|
||||||
|
|
||||||
|
## 技术栈
|
||||||
|
|
||||||
|
- **前端**: 纯 HTML、CSS、JavaScript (ES6+)
|
||||||
|
- **样式**: CSS3 + Flexbox/Grid,支持 CSS 变量
|
||||||
|
- **图标**: Font Awesome 6.4.0
|
||||||
|
- **图表**: Chart.js 交互式数据可视化
|
||||||
|
- **字体**: Segoe UI 系统字体
|
||||||
|
- **API**: RESTful API 调用,自动认证
|
||||||
|
- **国际化**: 自定义 i18n 系统,支持中英文
|
||||||
|
- **主题系统**: CSS 自定义属性动态主题
|
||||||
|
- **存储**: LocalStorage 用户偏好和凭据存储
|
||||||
|
|
||||||
|
## 故障排除
|
||||||
|
|
||||||
|
### 连接问题
|
||||||
|
1. 确认 CLI Proxy API 服务正在运行
|
||||||
|
2. 检查 API 地址是否正确
|
||||||
|
3. 验证管理密钥是否有效
|
||||||
|
4. 确认防火墙设置允许连接
|
||||||
|
|
||||||
|
### 数据不更新
|
||||||
|
1. 点击"刷新全部"按钮
|
||||||
|
2. 检查网络连接
|
||||||
|
3. 查看浏览器控制台错误信息
|
||||||
|
|
||||||
|
## 开发说明
|
||||||
|
|
||||||
|
### 文件结构
|
||||||
|
```
|
||||||
|
webui/
|
||||||
|
├── index.html # 主页面,响应式布局
|
||||||
|
├── styles.css # 样式文件,支持主题
|
||||||
|
├── app.js # 应用逻辑和 API 管理
|
||||||
|
├── i18n.js # 国际化支持(中英文)
|
||||||
|
├── package.json # 项目配置
|
||||||
|
├── build.js # 生产环境构建脚本
|
||||||
|
├── bundle-entry.js # 打包入口文件
|
||||||
|
├── build-scripts/ # 构建工具
|
||||||
|
│ └── prepare-html.js # HTML 准备脚本
|
||||||
|
├── logo.jpg # 应用图标
|
||||||
|
├── LICENSE # MIT 许可证
|
||||||
|
├── README.md # 英文文档
|
||||||
|
├── README_CN.md # 中文文档
|
||||||
|
└── BUILD_RELEASE.md # 构建和发布说明
|
||||||
|
```
|
||||||
|
|
||||||
|
### API 调用
|
||||||
|
所有 API 调用都通过 `ManagerAPI` 类的 `makeRequest` 方法处理,包含:
|
||||||
|
- 自动添加认证头
|
||||||
|
- 错误处理
|
||||||
|
- JSON 响应解析
|
||||||
|
|
||||||
|
### 状态管理
|
||||||
|
- 本地存储保存 API 地址和密钥
|
||||||
|
- 内存中维护连接状态
|
||||||
|
- 实时数据刷新机制
|
||||||
|
|
||||||
|
## 贡献
|
||||||
|
欢迎提交 Issue 和 Pull Request 来改进这个项目!我们欢迎更多的大佬来对这个WebUI进行更新!
|
||||||
|
|
||||||
|
本项目采用MIT许可
|
||||||
30
build-scripts/prepare-html.js
Normal file
30
build-scripts/prepare-html.js
Normal file
@@ -0,0 +1,30 @@
|
|||||||
|
const fs = require('fs');
|
||||||
|
const path = require('path');
|
||||||
|
|
||||||
|
// Read the original index.html
|
||||||
|
const indexPath = path.resolve(__dirname, '../index.html');
|
||||||
|
const outputPath = path.resolve(__dirname, '../index.build.html');
|
||||||
|
|
||||||
|
let htmlContent = fs.readFileSync(indexPath, 'utf8');
|
||||||
|
|
||||||
|
// Remove local CSS reference
|
||||||
|
htmlContent = htmlContent.replace(
|
||||||
|
/<link rel="stylesheet" href="styles\.css">\n?/g,
|
||||||
|
''
|
||||||
|
);
|
||||||
|
|
||||||
|
// Remove local JavaScript references
|
||||||
|
htmlContent = htmlContent.replace(
|
||||||
|
/<script src="i18n\.js"><\/script>\n?/g,
|
||||||
|
''
|
||||||
|
);
|
||||||
|
|
||||||
|
htmlContent = htmlContent.replace(
|
||||||
|
/<script src="app\.js"><\/script>\n?/g,
|
||||||
|
''
|
||||||
|
);
|
||||||
|
|
||||||
|
// Write the modified HTML to a temporary build file
|
||||||
|
fs.writeFileSync(outputPath, htmlContent, 'utf8');
|
||||||
|
|
||||||
|
console.log('✓ Generated index.build.html for webpack processing');
|
||||||
132
build.js
Normal file
132
build.js
Normal file
@@ -0,0 +1,132 @@
|
|||||||
|
'use strict';
|
||||||
|
|
||||||
|
const fs = require('fs');
|
||||||
|
const path = require('path');
|
||||||
|
|
||||||
|
const projectRoot = __dirname;
|
||||||
|
const distDir = path.join(projectRoot, 'dist');
|
||||||
|
|
||||||
|
const sourceFiles = {
|
||||||
|
html: path.join(projectRoot, 'index.html'),
|
||||||
|
css: path.join(projectRoot, 'styles.css'),
|
||||||
|
i18n: path.join(projectRoot, 'i18n.js'),
|
||||||
|
app: path.join(projectRoot, 'app.js')
|
||||||
|
};
|
||||||
|
|
||||||
|
const logoCandidates = ['logo.png', 'logo.jpg', 'logo.jpeg', 'logo.svg', 'logo.webp', 'logo.gif'];
|
||||||
|
const logoMimeMap = {
|
||||||
|
'.png': 'image/png',
|
||||||
|
'.jpg': 'image/jpeg',
|
||||||
|
'.jpeg': 'image/jpeg',
|
||||||
|
'.svg': 'image/svg+xml',
|
||||||
|
'.webp': 'image/webp',
|
||||||
|
'.gif': 'image/gif'
|
||||||
|
};
|
||||||
|
|
||||||
|
function readFile(filePath) {
|
||||||
|
try {
|
||||||
|
return fs.readFileSync(filePath, 'utf8');
|
||||||
|
} catch (err) {
|
||||||
|
console.error(`读取文件失败: ${filePath}`);
|
||||||
|
throw err;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function readBinary(filePath) {
|
||||||
|
try {
|
||||||
|
return fs.readFileSync(filePath);
|
||||||
|
} catch (err) {
|
||||||
|
console.error(`读取文件失败: ${filePath}`);
|
||||||
|
throw err;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function escapeForScript(content) {
|
||||||
|
return content.replace(/<\/(script)/gi, '<\\/$1');
|
||||||
|
}
|
||||||
|
|
||||||
|
function escapeForStyle(content) {
|
||||||
|
return content.replace(/<\/(style)/gi, '<\\/$1');
|
||||||
|
}
|
||||||
|
|
||||||
|
function ensureDistDir() {
|
||||||
|
if (fs.existsSync(distDir)) {
|
||||||
|
fs.rmSync(distDir, { recursive: true, force: true });
|
||||||
|
}
|
||||||
|
fs.mkdirSync(distDir);
|
||||||
|
}
|
||||||
|
|
||||||
|
function loadLogoDataUrl() {
|
||||||
|
for (const candidate of logoCandidates) {
|
||||||
|
const filePath = path.join(projectRoot, candidate);
|
||||||
|
if (!fs.existsSync(filePath)) continue;
|
||||||
|
|
||||||
|
const ext = path.extname(candidate).toLowerCase();
|
||||||
|
const mime = logoMimeMap[ext];
|
||||||
|
if (!mime) {
|
||||||
|
console.warn(`未知 Logo 文件类型,跳过内联: ${candidate}`);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
const buffer = readBinary(filePath);
|
||||||
|
const base64 = buffer.toString('base64');
|
||||||
|
return `data:${mime};base64,${base64}`;
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
function build() {
|
||||||
|
ensureDistDir();
|
||||||
|
|
||||||
|
let html = readFile(sourceFiles.html);
|
||||||
|
const css = escapeForStyle(readFile(sourceFiles.css));
|
||||||
|
const i18n = escapeForScript(readFile(sourceFiles.i18n));
|
||||||
|
const app = escapeForScript(readFile(sourceFiles.app));
|
||||||
|
|
||||||
|
html = html.replace(
|
||||||
|
'<link rel="stylesheet" href="styles.css">',
|
||||||
|
`<style>
|
||||||
|
${css}
|
||||||
|
</style>`
|
||||||
|
);
|
||||||
|
|
||||||
|
html = html.replace(
|
||||||
|
'<script src="i18n.js"></script>',
|
||||||
|
`<script>
|
||||||
|
${i18n}
|
||||||
|
</script>`
|
||||||
|
);
|
||||||
|
|
||||||
|
html = html.replace(
|
||||||
|
'<script src="app.js"></script>',
|
||||||
|
`<script>
|
||||||
|
${app}
|
||||||
|
</script>`
|
||||||
|
);
|
||||||
|
|
||||||
|
const logoDataUrl = loadLogoDataUrl();
|
||||||
|
if (logoDataUrl) {
|
||||||
|
const logoScript = `<script>window.__INLINE_LOGO__ = "${logoDataUrl}";</script>`;
|
||||||
|
if (html.includes('</body>')) {
|
||||||
|
html = html.replace('</body>', `${logoScript}\n</body>`);
|
||||||
|
} else {
|
||||||
|
html += `\n${logoScript}`;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
console.warn('未找到可内联的 Logo 文件,将保持运行时加载。');
|
||||||
|
}
|
||||||
|
|
||||||
|
const outputPath = path.join(distDir, 'index.html');
|
||||||
|
fs.writeFileSync(outputPath, html, 'utf8');
|
||||||
|
|
||||||
|
console.log('构建完成: dist/index.html');
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
build();
|
||||||
|
} catch (error) {
|
||||||
|
console.error('构建失败:', error);
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
25
bundle-entry.js
Normal file
25
bundle-entry.js
Normal file
@@ -0,0 +1,25 @@
|
|||||||
|
// Import CSS
|
||||||
|
import './styles.css';
|
||||||
|
|
||||||
|
// Import JavaScript modules
|
||||||
|
import './i18n.js';
|
||||||
|
import './app.js';
|
||||||
|
|
||||||
|
// Import logo image
|
||||||
|
import logoImg from './logo.jpg';
|
||||||
|
|
||||||
|
// Set logo after DOM is loaded
|
||||||
|
document.addEventListener('DOMContentLoaded', () => {
|
||||||
|
const loginLogo = document.getElementById('login-logo');
|
||||||
|
const siteLogo = document.getElementById('site-logo');
|
||||||
|
|
||||||
|
if (loginLogo) {
|
||||||
|
loginLogo.src = logoImg;
|
||||||
|
loginLogo.style.display = 'block';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (siteLogo) {
|
||||||
|
siteLogo.src = logoImg;
|
||||||
|
siteLogo.style.display = 'block';
|
||||||
|
}
|
||||||
|
});
|
||||||
1098
index.html
1098
index.html
File diff suppressed because it is too large
Load Diff
1064
package-lock.json
generated
Normal file
1064
package-lock.json
generated
Normal file
File diff suppressed because it is too large
Load Diff
@@ -6,7 +6,7 @@
|
|||||||
"scripts": {
|
"scripts": {
|
||||||
"start": "npx serve .",
|
"start": "npx serve .",
|
||||||
"dev": "npx serve . --port 3000",
|
"dev": "npx serve . --port 3000",
|
||||||
"build": "echo '无需构建,直接使用静态文件'",
|
"build": "node build.js",
|
||||||
"lint": "echo '使用浏览器开发者工具检查代码'"
|
"lint": "echo '使用浏览器开发者工具检查代码'"
|
||||||
},
|
},
|
||||||
"keywords": [
|
"keywords": [
|
||||||
|
|||||||
2171
styles.css
2171
styles.css
File diff suppressed because it is too large
Load Diff
64
webpack.config.js
Normal file
64
webpack.config.js
Normal file
@@ -0,0 +1,64 @@
|
|||||||
|
const HtmlWebpackPlugin = require('html-webpack-plugin');
|
||||||
|
const HtmlInlineScriptPlugin = require('html-inline-script-webpack-plugin');
|
||||||
|
const path = require('path');
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
mode: 'production',
|
||||||
|
entry: {
|
||||||
|
main: './bundle-entry.js'
|
||||||
|
},
|
||||||
|
output: {
|
||||||
|
path: path.resolve(__dirname, 'dist'),
|
||||||
|
filename: '[name].bundle.js',
|
||||||
|
clean: true
|
||||||
|
},
|
||||||
|
module: {
|
||||||
|
rules: [
|
||||||
|
{
|
||||||
|
test: /\.css$/i,
|
||||||
|
use: ['style-loader', 'css-loader']
|
||||||
|
},
|
||||||
|
{
|
||||||
|
test: /\.(png|jpg|jpeg|gif|svg)$/i,
|
||||||
|
type: 'asset/inline'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
test: /\.html$/i,
|
||||||
|
loader: 'html-loader',
|
||||||
|
options: {
|
||||||
|
sources: {
|
||||||
|
list: [
|
||||||
|
{
|
||||||
|
tag: 'img',
|
||||||
|
attribute: 'src',
|
||||||
|
type: 'src'
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
plugins: [
|
||||||
|
new HtmlWebpackPlugin({
|
||||||
|
template: './index.build.html',
|
||||||
|
filename: 'index.html',
|
||||||
|
inject: 'body',
|
||||||
|
minify: {
|
||||||
|
collapseWhitespace: true,
|
||||||
|
removeComments: true,
|
||||||
|
removeRedundantAttributes: true,
|
||||||
|
removeScriptTypeAttributes: true,
|
||||||
|
removeStyleLinkTypeAttributes: true,
|
||||||
|
useShortDoctype: true
|
||||||
|
}
|
||||||
|
}),
|
||||||
|
new HtmlInlineScriptPlugin({
|
||||||
|
htmlMatchPattern: [/index.html$/],
|
||||||
|
scriptMatchPattern: [/.js$/]
|
||||||
|
})
|
||||||
|
],
|
||||||
|
optimization: {
|
||||||
|
minimize: true
|
||||||
|
}
|
||||||
|
};
|
||||||
Reference in New Issue
Block a user