安装 Koharu¶
下载发行版¶
从 Koharu releases 页面 下载最新发行版。
Koharu 提供以下平台的预构建二进制：
- Windows
- macOS
- Linux
如果你的平台没有发行版，请改用 从源码构建。
本地会安装什么¶
Koharu 是本地优先应用。桌面二进制只是安装内容的一部分。第一次真正运行时，还会在用户本地数据目录中创建以下内容：
llama.cpp与 GPU 后端所需的运行时库- 下载的视觉模型与 OCR 模型
- 你之后在设置中选择的可选本地翻译模型
Koharu 会把自己的文件放在 Koharu 应用数据根目录下，并将模型权重与程序二进制分开存放。
首次启动时的预期行为¶
首次启动时，Koharu 可能会：
- 解压或下载本地推理栈所需的运行时库
- 下载检测、分割、OCR、修复和字体估计所需的默认视觉模型
- 仅在你真正选择某个本地翻译模型时，才下载对应的 LLM
这属于正常现象，耗时取决于网络与硬件。
如果你想提前把运行时依赖拉下来，可以先用 --download 运行一次。这个路径会初始化运行时包与默认视觉栈，然后直接退出，不打开 GUI。
GPU 加速说明¶
Koharu 支持：
- 支持的 NVIDIA GPU 上使用 CUDA
- Apple Silicon Mac 上使用 Metal
- Windows 与 Linux 上用 Vulkan 做 OCR 与 LLM 推理
- 所有平台都可回退到 CPU
一些实际细节值得注意：
- 检测与修复阶段最受益于 CUDA 或 Metal
- Vulkan 主要是 OCR 与本地 LLM 推理的备用 GPU 路径
- 如果 Koharu 无法确认你的 NVIDIA 驱动支持 CUDA 13.1，它会回退到 CPU
对于支持 CUDA 的系统，Koharu 会自行初始化所需的运行时组件，而不是要求你手动配置一堆库路径。
Note
请保持 NVIDIA 驱动为较新版本。Koharu 会检查 CUDA 13.1 支持情况，驱动太旧时会自动回退到 CPU。
安装后下一步做什么¶
Koharu 成功启动后，通常接下来要决定的是：
- 使用桌面 GUI 还是 headless 模式
- 使用本地翻译模型还是远程提供商
- 导出渲染图还是分层 PSD
参见：
需要帮助？¶
如需支持，请加入 Discord 服务器。