FAQ
A collection of common questions encountered when using the plugin.
🔐 Authentication Methods
What is the difference between Cookie Mode and Access Token method?
The plugin supports two authentication methods:
| Authentication Method | Features | Applicable Scenarios | Recommendation Level |
|---|---|---|---|
| Access Token | ✅ Supports multiple accounts ✅ Permanently valid, does not expire ✅ More secure and stable | Most standard relay sites | ⭐⭐⭐⭐⭐ Highly Recommended |
| Cookie | ⚠️ Single account ⚠️ May expire ✅ Good compatibility | Special sites with token restrictions Modified sites | ⭐⭐⭐ Use in special cases |
It is recommended to use the Access Token method, unless you encounter the following situations:
- The site does not support access tokens
- Using a modified version of the relay station
- Token functionality is disabled
How to switch authentication methods?
When adding an account, select the corresponding authentication method in the account dialog:
- Click "Add Account"
- Enter site URL
- Select
Access TokenorCookiefrom the "Authentication Method" dropdown - Click "Auto-recognize"
🔧 Special Site Issues
What to do if AnyRouter website reports an error?
AnyRouter is a modified relay station that does not support the standard Access Token method.
Solution:
- When adding an account, select Cookie Mode
- First log in to the AnyRouter site in your browser
- Then use the plugin's auto-recognize feature to add the account
Note
Because AnyRouter has modified the API, some functions may not work properly. If you encounter issues, it is recommended to contact the site administrator.
What to do if auto-recognition fails?
If auto-recognition fails, you can try the following methods:
- Switch authentication method: Try switching from Access Token to Cookie Mode
- Manually add: If auto-recognition fails, manually fill in the following information:
- Username
- User ID
- Access Token
- Recharge Ratio
- Check login status: Ensure you are logged in to the target site in your browser
- Check site compatibility: Confirm whether the site is based on supported projects (see below)
Which sites might not be compatible?
If the site has undergone deep secondary development and modified key interfaces (such as /api/user), the plugin may not function properly.
Common incompatibility situations:
- Modified user information API
- Disabled access token functionality
- Customized authentication method
- Modified API response format
🐛 Features and Bug-Related Issues
What to do if I encounter feature issues or bugs?
- Check Issues: Go to GitHub Issues to search for similar issues
- Use the latest version:
- Store versions update slowly; it is recommended to use GitHub Release versions
- Or use the development version from the main branch directly
How to get the latest version?
The plugin is released on multiple platforms, with varying update speeds:
| Platform | Update Speed | Get Version |
|---|---|---|
| GitHub Releases | ⚡ Fastest | Go to download |
| Chrome Web Store | 🐌 Slower (3-5 day review) | Go to install |
| Edge Add-ons | 🐌 Slower (3-5 day review) | Go to install |
| Firefox Add-ons | ⚡ Fast (few hours review) | Go to install |
Recommendation
If you encounter a fixed bug, it is recommended to download and manually install the latest version from GitHub Releases.
⚙️ Feature Usage Issues
How to use WebDAV backup?
WebDAV backup can help you synchronize data across multiple devices:
Configure WebDAV:
- Open "Settings" → "WebDAV Backup"
- Fill in WebDAV server address (full URL)
- Fill in username and password
Select sync strategy:
Merge(recommended): Smartly merges local and remote dataUpload only: Uploads local data to the server onlyDownload only: Downloads data from the server only
Enable auto-sync:
- Check "Enable auto-sync"
- Set sync interval (default 3600 seconds/1 hour)
Recommended Services
- Jianguoyun (fast access in China)
- Nextcloud (self-hosted)
- Synology NAS
How to export to CherryStudio / New API?
The quick export feature allows you to import site configurations to other platforms with one click:
Configuration Steps:
For New API:
- Open "Settings" → "Basic Settings"
- Configure New API server address
- Fill in Admin Token
- Fill in User ID
For CherryStudio:
- No additional configuration required
- Ensure CherryStudio is running
Export Process:
- Go to the "Key Management" page
- Find the site to export
- Click the operation menu
- Select "Export to CherryStudio" or "Export to New API"
Smart Detection
When exporting to New API, the plugin automatically detects if the same channel already exists to avoid duplicate additions.
For more complete export and integration instructions, please refer to Quick Export Site Configuration; if you wish to integrate with CLIProxyAPI management interface, please refer to CLIProxyAPI Integration.
How to use the site check-in feature?
Some relay stations support daily check-ins to receive rewards:
Enable check-in detection:
- Edit account
- Check "Enable check-in detection"
Custom check-in URL (optional):
- If the site's check-in page is not a standard path
- You can fill in "Custom Check-in URL"
- Fill in "Custom Recharge URL" (optional)
Perform check-in:
- Accounts requiring check-in will display a check-in icon
- Click the check-in button on the account card
- Automatically open the check-in page
How to customize account sorting?
The plugin supports priority settings for multiple sorting methods:
Go to sorting settings:
- Open "Settings" → "Sorting Priority Settings"
Adjust priority:
- Drag sorting conditions to adjust priority
- Check/uncheck to enable/disable conditions
Available sorting conditions:
- 📌 Current site pinned to top
- 🏥 Health status sorting (Error > Warning > Unknown > Normal)
- ✅ Accounts requiring check-in pinned to top
- 🔗 Accounts with custom check-in URL pinned to top
- 📊 User-defined field sorting (Balance/Consumption/Name)
For detailed meanings and example configurations of each sorting rule, please refer to Sorting Priority Settings.
How to set up auto-refresh?
Auto-refresh keeps account data up to date:
Enable auto-refresh:
- Open "Settings" → "Auto-Refresh"
- Check "Enable timed auto-refresh"
Set refresh interval:
- Default: 360 seconds (6 minutes)
- Minimum: 60 seconds (1 minute)
- Adjust based on the number of sites
Other options:
- ✅ Auto-refresh when opening the plugin
- ✅ Display health status
Note
A refresh interval that is too short may lead to frequent requests, so it is recommended not to set it below 60 seconds.
📱 Mobile Usage
How to use on mobile?
The plugin supports use on mobile devices:
Android Devices:
- Install Kiwi Browser (recommended)
- Perfectly compatible with Chrome extensions
- Supports all features
- Or install Firefox for Android
- Install from Firefox Add-ons
iOS Devices:
- Not supported yet (iOS restrictions)
Mobile usage recommendations
- Use sidebar mode: More suitable for mobile screens
- Enable auto-refresh: Avoid frequent manual refreshes
- Configure WebDAV sync: Synchronize data between computer and phone
🔒 Data Security
Where is the data stored?
- Local storage: All data is saved in the browser's local storage
- Completely offline: The plugin's core functions do not require an internet connection
- No data upload: No data is uploaded to any third-party servers
Will data be lost?
It is recommended to back up data regularly:
JSON Export:
- Go to "Settings" → "Data and Backup"
- Click "Export Data"
- Save the JSON file
WebDAV Sync (recommended):
- Automatically backs up to the cloud
- Supports multi-device synchronization
🆘 Other Issues
What is site duplicate detection?
When adding a site, the plugin automatically detects if the same site already exists:
- Based on site URL judgment
- If it already exists, it will prompt and allow quick modification
- Avoids adding the same site repeatedly
What does "Health Status" mean?
Health status indicates the availability of the account:
| Status | Icon | Meaning |
|---|---|---|
| 🟢 Normal | Healthy | Account is running normally |
| 🟡 Warning | Warning | Insufficient balance or needs attention |
| 🔴 Error | Error | API call failed or account anomaly |
| ⚪ Unknown | Unknown | Not yet detected or unable to retrieve status |
Does the plugin consume traffic?
- Only accesses site API when refreshing account data
- Request volume is very small (about a few KB per site)
- It is recommended to use auto-refresh in a WiFi environment
How to contribute code?
Pull Requests are welcome:
- Fork the project repository
- Create a feature branch
- Commit code
- Submit a Pull Request
For details: CONTRIBUTING.md
📚 Related Documentation
Can't find an answer?
If the above content does not solve your problem, feel free to ask on GitHub Issues.