Qoder插件离线导入指南：手动安装.qext文件详解
如果在开发环境中无法直连 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 离线导入 → 功能验证。按上述步骤操作，基本不会遇到问题。