常见问题

识别需要联网吗？

不需要。模型安装完成后，识别完全在本机推理。联网只发生在下载清单、安装模型与检查更新时。断网状态下，缓存的清单与已安装的模型都可以正常使用。

我的文档会被上传吗？

不会。应用没有上传文档的通道，识别结果只写在本机的数据目录中。更新检查也只发送版本号与应用标识。

模型装在哪里，可以换磁盘吗？

模型、运行时、缓存与日志都在应用数据目录下：

平台	路径
Windows	%AppData%\Glyphix
macOS	~/Library/Application Support/Glyphix
Linux	$XDG_CONFIG_HOME/Glyphix

在「设置 → 存储」中可以把存储目录迁移到其他磁盘，迁移后已安装的模型会被移动而不是重新下载。

下载总是中断怎么办？

先检查代理配置：应用使用「设置 → 网络」中的代理，修改后对新建下载立即生效。下载支持断点续传，换源或重启应用后会从断点继续，已校验完成的文件会被复用。若某个地址持续失败，应用会按清单中的备用地址依次回退，并在日志中记录每次失败。

共享运行时需要装几次？

一次。MiniCPM-OCR、Xiaomi-OCR-0 与 PaddleOCR-VL 共用同一份 llama.cpp 运行时，安装一次即可被全部引用它的引擎使用。卸载运行时会影响所有引用它的引擎，应用会在确认对话框中列出受影响的引擎。

支持 arm64 吗？

支持。Windows arm64、macOS Apple Silicon、Linux arm64 都提供对应构建与模型包。第二梯队平台上的部分能力可能降级（如托盘、系统装饰），降级项会在引擎中心与设置页明确标注。

支持 PDF 吗？

支持导入 PDF 并按页识别。没有可用于渲染的页面图像时，原图视图只显示框选并给出提示，其他视图不受影响。

为什么导出的 Markdown 与预览有差异？

正常情况下两者同源，内容一致。出现差异通常是因为预览中的编辑尚未提交（失焦才会回写），或图片块裁剪缓存被清理。提交编辑后重新导出即可。

切换界面语言需要重启吗？

不需要。界面文案会即时刷新，正在执行的批量任务不受影响。识别语言与界面语言是两个独立设置：前者由批次参数控制。

可以在多台电脑上共用模型目录吗？

可以把存储目录指向移动硬盘或网络盘，但注意：不同平台的运行时与模型包按 RID 分发，Windows 的包不能给 macOS 使用。建议每台机器各自安装，或为每个平台准备独立目录。