拓展功能

果核看图的主程序只有 4M 左右。为了不让所有人都为用不到的功能付出体积，部分能力做成了可选插件：不装不影响主程序，装了重启即用。

插件都放在程序目录下的 plugins 文件夹里，按类型分子目录：

GuoheView.exe
plugins\
  decoder\    解码器插件（扩展可打开的图片格式）
  ocr\        文字识别插件（OCR）

安装版的程序目录默认是 C:\Program Files\GuoheView；便携版就是你解压出来的那个文件夹。两个子目录在安装/解压后就已经存在，里面各有一份 readme.txt。

插件均从下载页获取，官方单独提供，不随主程序附带。

解码器插件

用来扩展可以打开的图片格式。主程序已内置绝大多数常见与专业格式，少数格式因为体积或授权原因做成插件，例如 JPEG XL。

安装步骤

在下载页的「插件下载 → 解码器插件」里下载需要的插件（例如 jxl.7z）。
解压，把里面的 .dll 文件放进程序目录的 plugins\decoder\。
重启果核看图，即可打开对应格式的图片。

装好后目录大致是这样：

plugins\decoder\
  jxl.dll
  readme.txt

让资源管理器也显示缩略图

解码器插件同时对缩略图扩展生效。装好插件后进入「设置 → 文件缩略图」，勾选对应的扩展名（如 .jxl），资源管理器里的这类文件也会显示缩略图。

卸载

删掉对应的 .dll 即可停用该格式支持，不影响主程序和其他插件。

文字识别（OCR）插件

给软件增加图片文字识别能力：识别在本机完成，图片不会上传。识别结果左图右文对照排布，可以在图片上拖动划词复制，也可以在右侧文本里选中，两边选区同步。

引擎是 RapidOCR（PP-OCRv3 中英文模型），支持中英混排、竖排与倾斜文本。因为要带模型文件，整个插件包约 20M，所以默认不附带。

安装步骤

在下载页的「插件下载 → 文字识别 (OCR) 插件」里下载插件压缩包。
解压到程序目录的 plugins\ocr\。压缩包内自带 plugins\ocr\ 目录结构，直接解压到程序根目录也可以。
重启果核看图。

装好后目录应当是这样：

plugins\ocr\
  gv-ocr.dll
  onnxruntime.dll
  models\
    ch_PP-OCRv3_det_infer.ort
    ch_PP-OCRv3_rec_infer.ort
    ch_ppocr_mobile_v2.0_cls_infer.ort
    ppocr_keys_v1.txt
  readme.txt

少了 models 文件夹或任一 .ort 文件，识别会启动失败。

开始使用

装好重启后，主窗口右上角图片序号的左边会出现「OCR」徽章，点它就会弹出识别窗口，用当前图片可用的最大分辨率进行识别。

识别窗口里：

左边是图片：在文字上拖动划词，双击选词，三击选整行；Ctrl+C 复制选中文本
右边是识别文本：可跨行拖选，同样能 Ctrl+C；点「复制全部」一次拿走整段
两边选区同步：图上划到哪一行，右边就选中那一行；反之亦然
工具条依次是：重新识别、适应窗口、原始大小、旋转 90°，最右侧是复制全部
底部状态栏显示识别用时与行数；图片过大被降采样时也会在这里说明

识别窗口打开期间主窗口暂停操作，关闭窗口（Esc 或右上角关闭）即可回到浏览。

开关与管理

进入「设置 → 拓展功能」可以看到插件状态：

已安装：提供「显示在首页」开关，关掉后主窗口不再显示「OCR」徽章
未安装：显示前往官网下载的入口

关于识别质量

识别结果来自模型推理，并非 100% 准确，尤其是艺术字、极小字号、强背景干扰的图片。软件会自动过滤明显的乱码行（置信度过低、通篇符号等），所以有时你会发现图上某些"看起来像字"的区域没有结果——那通常是引擎误识别被拦掉了。

卸载

删掉 plugins\ocr\ 里的文件即可停用，主程序会自动隐藏 OCR 入口。

常见问题

装了插件但没反应？ 先确认是否重启了软件，插件只在启动时加载。其次确认文件放对了位置——是程序目录下的 plugins\decoder\ 或 plugins\ocr\，不是 plugins\ 根目录。

能不能装到便携版里？ 可以，便携版与安装版的插件目录结构完全一致，解压到便携版文件夹即可。

升级主程序后插件会丢吗？ 不会。更新只覆盖主程序文件，plugins 目录不受影响。

插件会联网吗？ 不会。解码器插件只做本地解码；OCR 插件的模型也在本机运行，图片不会上传到任何服务器。