mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-04-21 03:40:31 +08:00
bbed2a1fe1
Reorganize docs/user-manual/ from flat structure to language subdirectories (zh/, en/, ja/) with shared assets/. Move existing Chinese docs into zh/, fix image paths, add multilingual navigation README, and translate all 23 markdown files (~4500 lines each) to English and Japanese.
171 lines
5.5 KiB
Markdown
171 lines
5.5 KiB
Markdown
# 1.3 Interface Overview
|
|
|
|
## Main Interface Layout
|
|
|
|
|
|
|
|
## Top Navigation Bar
|
|
|
|
| # | Element | Description |
|
|
|---|---------|-------------|
|
|
| 1 | Logo | Click to visit the GitHub project page |
|
|
| 2 | Settings Button | Open the settings page (shortcut `Cmd/Ctrl + ,`) |
|
|
| 3 | Proxy Toggle | Start/stop the local proxy service |
|
|
| 4 | App Switcher | Switch between Claude / Codex / Gemini / OpenCode / OpenClaw |
|
|
| 5 | Feature Area | Skills / Prompts / MCP entry points |
|
|
| 6 | Add Button | Add a new provider |
|
|
|
|
### App Switcher
|
|
|
|
Click the dropdown menu to switch the currently managed application:
|
|
|
|
- **Claude** - Manage Claude Code configuration
|
|
- **Codex** - Manage Codex configuration
|
|
- **Gemini** - Manage Gemini CLI configuration
|
|
- **OpenCode** - Manage OpenCode configuration
|
|
- **OpenClaw** - Manage OpenClaw configuration
|
|
|
|
After switching, the provider list displays the configurations for the selected application.
|
|
|
|
### Feature Area Buttons
|
|
|
|
| Button | Function | Visibility |
|
|
|--------|----------|------------|
|
|
| Skills | Skill extension management | Always visible |
|
|
| Prompts | System prompt management | Always visible |
|
|
| MCP | MCP server management | Always visible |
|
|
|
|
## Provider Cards
|
|
|
|
Each provider is displayed as a card, containing the following elements from left to right:
|
|
|
|
### Card Elements (Left to Right)
|
|
|
|
| # | Element | Icon | Description |
|
|
|---|---------|------|-------------|
|
|
| 1 | Drag Handle | ≡ | Hold and drag up/down to reorder providers |
|
|
| 2 | Provider Icon | - | Displays provider brand icon with customizable color |
|
|
| 3 | Provider Info | - | Name, notes/endpoint URL (clickable to open website) |
|
|
| 4 | Usage Info | - | Shows remaining balance; displays plan count for multi-plan |
|
|
| 5 | Enable Button | - | Switch to this provider |
|
|
| 6 | Edit Button | - | Edit provider configuration |
|
|
| 7 | Duplicate Button | - | Duplicate provider (create a copy) |
|
|
| 8 | Speed Test Button | - | Test model availability and response speed |
|
|
| 9 | Usage Query | - | Configure usage query script |
|
|
| 10 | Delete Button | - | Delete provider (disabled when currently active) |
|
|
|
|
> **Tip**: The action buttons area (5-10) appears on hover and is hidden by default to keep the interface clean.
|
|
|
|
### Button Details
|
|
|
|
| Button | State Changes | Notes |
|
|
|--------|---------------|-------|
|
|
| **Enable** | Shows checkmark and disables when active | Changes to "Join/Joined" in failover mode |
|
|
| **Edit** | Always available | Opens edit panel to modify configuration |
|
|
| **Duplicate** | Always available | Creates a copy with `copy` suffix |
|
|
| **Speed Test** | Shows loading animation during test | Only available when proxy service is running |
|
|
| **Usage Query** | Always available | Configure custom usage query script |
|
|
| **Delete** | Semi-transparent/disabled when active | Must switch to another provider first |
|
|
|
|
### Card States
|
|
|
|
| State | Border Color | Description |
|
|
|-------|--------------|-------------|
|
|
| **Currently Active** | Blue border | Current provider in normal mode |
|
|
| **Proxy Active** | Green border | Provider actually in use during proxy takeover mode |
|
|
| **Normal** | Default border | Inactive provider |
|
|
| **In Failover** | Shows priority badge | e.g., P1, P2 indicates failover priority |
|
|
|
|
### Health Status Badges
|
|
|
|
In proxy mode, providers in the failover queue display health status:
|
|
|
|
| Badge | Color | Description |
|
|
|-------|-------|-------------|
|
|
| Healthy | Green | 0 consecutive failures |
|
|
| Warning | Yellow | 1-2 consecutive failures |
|
|
| Unhealthy | Red | 3+ consecutive failures, may trigger circuit breaker |
|
|
|
|
|
|
## System Tray
|
|
|
|
CC Switch displays an icon in the system tray, providing quick access to operations.
|
|
|
|
### Tray Menu Structure
|
|
|
|
|
|
|
|
### Menu Functions
|
|
|
|
| Menu Item | Function |
|
|
|-----------|----------|
|
|
| Open Main Window | Show and focus the main window |
|
|
| App Groups | Providers grouped by Claude/Codex/Gemini/OpenCode/OpenClaw |
|
|
| Provider List | Click to switch; currently active one shows a checkmark |
|
|
| Quit | Fully exit the application |
|
|
|
|
### Multi-language Support
|
|
|
|
The tray menu supports three languages, automatically switching based on settings:
|
|
|
|
| Language | Open Main Window | Quit |
|
|
|----------|-----------------|------|
|
|
| Chinese | Open Main Window | Quit |
|
|
| English | Open main window | Quit |
|
|
| Japanese | Open main window | Quit |
|
|
|
|
### Use Cases
|
|
|
|
Switching providers via the tray menu doesn't require opening the main window, suitable for:
|
|
|
|
- Frequently switching providers
|
|
- Quick operations when the main window is minimized
|
|
- Managing configurations while running in the background
|
|
|
|
## Settings Page
|
|
|
|
The settings page is divided into multiple tabs:
|
|
|
|
### General Tab
|
|
|
|
- Language settings (Chinese/English/Japanese)
|
|
- Theme settings (System/Light/Dark)
|
|
- Window behavior (launch on startup, close behavior)
|
|
|
|
### Advanced Tab
|
|
|
|
- Configuration directory settings
|
|
- Proxy service configuration
|
|
- Failover settings
|
|
- Pricing configuration
|
|
- Data import/export
|
|
|
|
### Usage Tab
|
|
|
|
- Request statistics overview
|
|
- Trend charts
|
|
- Request logs
|
|
- Provider/model statistics
|
|
|
|
### About Tab
|
|
|
|
- Version information
|
|
- Update check
|
|
- Open source license
|
|
|
|
## Keyboard Shortcuts
|
|
|
|
| Shortcut | Function |
|
|
|----------|----------|
|
|
| `Cmd/Ctrl + ,` | Open Settings |
|
|
| `Cmd/Ctrl + F` | Search providers |
|
|
| `Esc` | Close dialog/search |
|
|
|
|
## Search
|
|
|
|
Press `Cmd/Ctrl + F` to open the search bar:
|
|
|
|
- Search by name, notes, or URL
|
|
- Real-time provider list filtering
|
|
- Press `Esc` to close search
|