Skip to main content
Koharu 会下载所用功能需要的原生库与模型文件。运行发行版不需要安装完整的 CUDA 或 ROCm SDK。

​
设备选择

启动时会从可用后端中选择统一的 ML 设备：Apple 芯片上使用 Metal，其他环境按支持情况选择 CUDA、ROCm/HIP、Vulkan 或 CPU。操作系统、驱动、模型后端和已发布运行时必须同时支持该路径。
Windows 和 Linux 支持 CUDA 13.0，需要 Turing 架构或更新的 GPU，以及 R580 系列或更新的驱动。查看 NVIDIA 的驱动与架构对应表并下载驱动。
编辑器画布使用内置 CEF WebView 的 WebGPU。即使 ML 推理在 CPU 上运行，画布仍需要可用的 WebGPU 适配器和显卡驱动。

​
下载与缓存

软件包位于系统缓存目录的 koharu/packages，项目位于 Documents/Koharu，设置位于 ~/.koharu/config.toml。详见数据位置。 下载会先暂存，再发布到缓存。中断后可以在下次启动或使用模型时重试。

​
内存与模型驻留

资源监视器显示主机内存、计算活动和模型驻留情况。模型按需加载，并可能保留以便复用。后续阶段需要内存时，Koharu 可以驱逐空闲模型。 从中等量化开始。较小的文件通常更省内存，但可能影响质量。磁盘能存下模型，并不代表设备内存也能容纳它。 启动失败时，检查软件包仓库访问与驱动，重试一次。如果仍然失败，保留完整错误并查看故障排除。