当您的开发环境无法直接连接 JetBrains 插件市场，或因公司内网策略受限时，无需慌张——通过手动导入经过官方签名的 .qext 文件即可顺利完成部署。以下是详细的离线安装指南：
第一步：获取官方签名的 .qext 文件
此环节至关重要：唯有经过官方签名的文件才能获得 IDE 的信任并正常加载。自行压缩 ZIP 包或直接修改文件后缀名均无效，必须借助 Qoder 官方签名工具 signer-cli 生成合法签名文件。
具体操作：
1. 访问 Qoder 开发者门户（https://developer.qoder.com），登录后进入「插件签名中心」
2. 上传您的插件文件夹（需包含 manifest.json 与 main.js），选定目标 IDE 版本及签名类型 Production
3. 下载生成的 qoder-enhancer-v1.2.0.qext 文件（请勿更改文件名与版本号）
4. 将文件复制至加密 U 盘等安全介质，确保传输过程中未被杀毒软件拦截或意外重命名
第二步：在 JetBrains IDE 中离线导入插件
此步骤将绕过网络校验，直接把本地 .qext 文件注册为已安装插件。要求 IDE 版本不低于 2020.3，且未开启强制签名验证策略。
具体步骤：
1. 启动目标 IDE（例如 IntelliJ IDEA 2023.3），进入 Settings → Plugins
2. 点击右上角齿轮图标，选择 Install Plugin from Disk…
3. 在弹出的文件选择对话框中，定位到您复制过来的 qoder-enhancer-v1.2.0.qext
4. 点击 OK，等待 IDE 解析插件元数据（将显示名称、作者、版本及权限声明）
5. 勾选插件条目左侧的复选框，点击 Apply，根据提示重启 IDE
第三步：验证插件加载状态与基础功能
此步骤用于确认插件已成功注入运行时上下文，并能正常响应初始化事件。避免因 manifest.json 字段缺失或路径配置错误导致无声失败。
具体验证方法：
1. 重启后进入 Help → Find Action（快捷键 Ctrl+Shift+A），输入 Plugins 并回车
2. 在插件列表中找到已安装项，确保其状态为 Enabled，而非 Disabled 或 Corrupted
3. 打开任意代码文件，按下快捷键 Ctrl+Shift+L（Windows/Linux）或 ⌘⇧L（macOS）
4. 观察右侧工具窗口是否弹出 Qoder 面板，且顶部导航栏出现 Quest 标签
5. 在面板输入框中输入 /status 并回车，检查返回信息中是否包含 Agent mode: active
如果您身处企业内网或受限于网络环境，无法通过 JetBrains 插件市场在线安装 Qoder 插件，则必须采用手动导入已签名 .qext 文件的方式完成部署。操作流程可归纳为三步：获取签名文件 → IDE 离线导入 → 功能验证。按照上述步骤执行，基本不会遇到障碍。