1 开始使用

欢迎来到 Qoder Switcher！本教程将帮助您快速上手这款高效的账号管理工具。在开始之前，请确保您已经从官网下载并安装了最新版本。

⚠️ 重要提示

在使用 Qoder Switcher 前，请务必注意：Qoder 版本必须是国际服版本由于技术架构差异，Qoder Switcher 目前仅支持国际服版本的 Qoder，尚未适配 CN 版。如果您使用的是 CN 版将无法建立连接并正常使用服务。

同时，请确保您已经成功在 Qoder 编辑器中登录了一个账号。Qoder Switcher 需要基于已登录的账号进行中转加速，如果尚未登录或检测到未授权状态，相关功能将无法正常工作。请先打开 Qoder 并完成账号登录流程后，再使用本工具进行多账号管理。

查看前置登录配置截图

首次启动

安装完成后，双击桌面图标启动 Qoder Switcher。首次启动时，程序会自动检测系统环境并完成初始化配置。

💡 提示

首次启动可能需要 10-20 秒的时间，请耐心等待初始化完成。

2 安装指南

💡 快速上手

所有平台的操作流程统一:

  1. 卡券登录: 输入你的卡券代码并登录
  2. 启动 Qoder: 直接打开 Qoder 编辑器，无需额外配置
  3. 无感加速: Qoder Switcher 会自动监控和切换账号 (每个 300 Credits)

macOS

  1. 卡券登录:
    1. 首次打开会出现登录界面
    2. 在输入框中填入你的卡券代码
    3. 点击「登录」按钮
  2. 打开 Qoder 代码编辑器:
    1. 无需任何额外配置，Qoder 会自动通过 Qoder Switcher 进行加速
    2. 当前账号的 300 Credits 用完后，Qoder Switcher 会自动切换到下一个可用账号
    3. 整个过程完全无感,你不需要做任何操作
  3. 首次运行注意事项:
    ⚠️ 重要: 由于 macOS 的安全机制，首次运行时可能会看到
    "Qoder Switcher" 已损坏，无法打开
    或者
    "来自身份不明开发者的应用，无法验证"

    解决方法:
    1. 打开「系统设置」→「隐私与安全性」(或「安全性与隐私」)
    2. 在「通用」标签页底部，你会看到相关提示
    3. 点击「仍要打开」按钮
    4. 确认后，下次即可正常启动

Windows

  1. 卡券登录:
    1. 首次打开会出现登录界面
    2. 在输入框中填入你的卡券代码
    3. 点击「登录」按钮

    2. 查看卡券绑定界面截图

  2. 打开 Qoder 代码编辑器:
    1. 无需任何额外配置，Qoder 会自动通过 Qoder Switcher 进行加速
    2. 当前账号的 300 Credits 用完后，Qoder Switcher 会自动切换到下一个可用账号
    3. 整个过程完全无感,你不需要做任何操作

    3. 查看 Qoder 编辑器启动界面截图

    Linux

    1. 访问官网下载页面,根据系统版本选择合适的安装包:
    2. 新系统 (推荐) - AppImage 版本:
      1. 下载 .AppImage 文件
      2. 赋予执行权限: 
        chmod +x QoderSwitcher-*-x86_64.appimage
      3. 直接双击运行，或创建桌面快捷方式
    3. 旧系统 - compat 版本:
      1. 下载兼容包 (.tar.xz 格式)
      2. 解压到任意目录 
        tar -xvf QoderSwitcher-*-x86_64_compat.tar.xz
      3. 进入解压目录，赋予执行权限: 
        chmod +x qoder-switcher
      4. 运行 ./qoder-switcher 启动应用

    3 仪表盘介绍

    仪表盘是 Qoder Switcher 的核心界面，这里展示了所有关键信息。

    主要功能区域

    • 顶部导航栏: 包含仪表盘、账号、统计、SSH、公告等核心功能入口
    • 状态显示区: 显示当前服务的运行状态和请求数
    • 账号概览: 展示已添加账号的基本信息和状态
    • 额度统计: 实时显示各账号的额度使用情况

    4 账号管理

    账号管理模块是您维护和管理多个账号的中心。

    添加新账号

    1. 点击顶部导航栏的"账号"选项卡
    2. 点击右上角的"添加账号"按钮
    3. 按照向导提示输入账号信息
    4. 点击"保存"即可完成添加

    切换账号

    在账号列表中选择任意账号，点击"切换"即可快速切换到该账号。切换过程无需重新登录，无缝衔接。

    ⚡ 快速切换

    支持快捷键 Ctrl+Shift+A 快速打开账号切换面板。

    5 SSH 连接配置

    Qoder Switcher 的 SSH 功能允许您通过远端服务器管理您的账号和资源。

    配置 SSH 连接

    1. 点击顶部导航栏的"SSH"选项卡
    2. 点击"新增连接"按钮
    3. 填写远程服务器地址、端口、用户名和密码
    4. 点击"测试连接"验证配置
    5. 确认无误后点击"保存"
    # SSH 连接示例
host remote-server
    HostName your.server.com
    Port 22
    User your_username
    IdentityFile ~/.ssh/id_rsa
    🔒 安全提示

    SSH 连接完全基于您的本地密钥与配置，Qoder Switcher 不会上传或存储任何敏感信息。

    6 额度监控

    实时监控各账号的额度使用情况，避免超额消耗。

    查看额度详情

    在仪表盘中可以看到每个账号的额度进度条，红色表示即将用完，黄色表示剩余不多，绿色表示充足。

    设置提醒阈值

    1. 进入"账号"设置页面
    2. 找到"额度提醒"选项
    3. 设置提醒您提前消耗的百分比
    4. 系统将自动通过通知提醒

    7 常见问题

    问：为什么无法切换到某个账号？

    答：可能是该账号的令牌已过期，建议重新登录或使用"刷新令牌"功能更新认证信息。

    问：如何导出账号数据备份？

    答：在"设置"中可以选择"导出数据"，会将所有账号信息加密打包成备份文件。

    问：额度为什么会突然减少很多？

    答：检查是否有其他设备或应用在同时使用该账号，建议开启"异常操作警告"功能监控使用行为。

    问：如何提高切换速度？

    答：在"设置"中可以启用"预加载缓存"功能，显著加快账号切换速度。