QClaw插件在JetBrains IDE中可通过Marketplace在线安装、本地ZIP手动安装或插件目录直接部署三种方式安装，需确保IDE版本兼容、驱动与依赖环境就绪，并完成微信扫码绑定方可启用全部功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 IntelliJ IDEA 或其他 JetBrains IDE 中使用 QClaw 插件，但插件未出现在 Marketplace 中或安装失败，则可能是由于插件源不可达、IDE 版本不兼容或手动安装路径错误。以下是多种可行的安装方式：
一、通过 JetBrains Marketplace 在线安装
该方法适用于已联网且插件已上架官方插件市场的情况，无需下载文件，操作最简捷。
1、启动 IntelliJ IDEA 或目标 JetBrains IDE（如 PyCharm、WebStorm 等）。
2、点击 File → Settings（Windows/Linux）或 IntelliJ IDEA → Preferences（macOS）。
3、在左侧导航栏中选择 Plugins。
4、确保顶部选项卡为 Marketplace，在搜索框中输入 QClaw。
5、若插件显示在结果中，点击右侧的 Install 按钮。
6、安装完成后，点击 OK 并重启 IDE 以激活插件。
二、通过本地 ZIP 文件手动安装
当 QClaw 尚未发布至 Marketplace，或您已获取官方发布的离线包（如 qclaw-1.2.0.zip），可采用此方式绕过网络限制与版本校验异常。
1、确认插件 ZIP 文件完整，解压后根目录应包含 plugin.xml 或 META-INF/plugin.xml。
2、在 IDE 中打开 Settings → Plugins。
3、点击右上角的 ⚙️ 图标，选择 Install plugin from disk…。
4、在文件选择对话框中定位并选中该 ZIP 文件，点击 OK。
5、IDE 将校验插件元信息；若提示 Plugin is incompatible with current IDE version，请检查插件支持的 IDE 版本范围是否覆盖您的 IDE（例如：要求 2025.1+，而您运行的是 2024.3）。
6、校验通过后点击 Restart IDE 完成启用。
多模态论文可视化引擎，自动从 PDF 或纯文本生成学术插图，支持全篇扫描识别可图化内容、双编码器架构图/算法流程图/动机图生成、自校核、LaTeX/Word 图注输出、Matplotlib 精确绘图，并提供独立 PDF→Text 提取工具。
三、通过插件目录直接部署（高级用户）
适用于批量部署、CI/CD 环境或需规避 GUI 安装流程的场景，本质是将插件文件复制至 IDE 的 plugins 目录并由启动时自动加载。
1、关闭所有 JetBrains IDE 实例。
2、根据操作系统定位 IDE 插件目录：
Windows：%USERPROFILE%\.JetBrains\IntelliJIdea
macOS：~/Library/Caches/JetBrains/IntelliJIdea
Linux：~/.cache/JetBrains/IntelliJIdea
3、将 QClaw ZIP 文件解压后的整个文件夹（非 ZIP 本身）复制到上述 plugins 目录下，文件夹名建议为 qclaw。
4、重新启动 IDE，进入 Settings → Plugins 查看是否已列出并启用 QClaw。
四、验证插件兼容性与依赖配置
部分 QClaw 功能可能依赖特定语言服务或外部 CLI 工具，仅安装插件不足以启用全部能力，需同步检查运行时环境。
1、确认当前 IDE 版本不低于 QClaw 所需最低版本（例如：要求 2025.3+，可在插件页面或其 GitHub README 中查得）。
2、进入 Settings → Languages & Frameworks → QClaw（若该菜单存在），检查是否出现配置入口。
3、若插件提供命令行集成，需在系统 PATH 中确保 qclaw-cli 可执行；若缺失，需单独下载并配置其二进制路径。
4、对于需要认证的服务端连接，检查插件设置中是否已填入有效的 API Token 或 Endpoint URL。
