首页 / 开源热榜 / koharu / 使用教程

Koharu 中文教程：安装 0.83.5 并完成第一张漫画翻译

更新于 2026-09-23 · NGJOO AI 实验室 · 约 9 分钟

Koharu 把漫画翻译拆成检测、OCR、翻译、文字清除和排版几步，并让用户在桌面画布中逐层修改。它强调本地优先，但也支持托管 LLM 和机器翻译服务；是否离线取决于你实际选择的模型与 provider。

官方仓库已经从 mayocream/koharu 迁移到 koharu-rs/koharu。截至 2026-09-23，最新正式版是 0.83.5，发布于 2026-09-22。

1. 安装前先看设备路径

官方 release 提供 Windows、Apple silicon macOS 与 Linux 安装资产。Windows 可以使用 winget install koharu，macOS 可以使用 brew install --cask koharu，Linux 则从 release 选择对应架构的 deb、rpm 或 AppImage。

# Windows
winget install koharu

# Apple silicon macOS
brew install --cask koharu

官方硬件说明列出 Metal、CUDA 13.3、ROCm/HIP、Vulkan 和 CPU 路径。CUDA 需要 Turing 或更新架构及 R610 系列或更新驱动；CPU 可以回退，但速度明显更慢。即使推理走 CPU，编辑画布仍要可用的 WebGPU 适配器和显卡驱动。

首次启动会按需下载 Torch、llama.cpp、diffusion runtime 和模型权重。运行时可能来自 GitHub release、PyPI 或 AMD 仓库，模型权重来自 Hugging Face。安装包能打开，不代表所选模型已经准备好。

2. 用一张页面建立项目

按官方首张页面教程，准备一张清晰且有权处理的 PNG、JPEG 或 WebP。在开始页输入项目名，Koharu 会在 Documents/Koharu 下创建独立的 .khrproj 目录。导入时页面会被复制进项目，之后可以移动原文件。

在画布上方选择翻译模型、目标语言和指令。若使用托管模型，先在 Settings → Providers 保存连接。随后选择 Current page，勾选 detection、OCR、translation 和 inpainting 四个阶段并运行。

3. 理解四个阶段的依赖

Detection 找文本区域、气泡和清理掩码；OCR 读取文字；Translation 写入目标文本；Inpainting 重建原文字下的画面。官方文档提醒，省略的前置阶段不会自动补上。只运行 Inpainting 会组合检测与修补，不会自动做 OCR 或翻译。

完成后逐个文字层比较原文和译文，检查专名、断行和漏字。清字区域有残留时用 Remove 补掩码，再调整字体、字号、自动适配、对齐、书写方向、填充与描边。整章批处理之前，先用一页确认模型质量和显存占用。

4. 导出时保留 .khrproj

PNG 是扁平结果，适合审阅和交付；PSD 会保留原图、清理层和可编辑文字层，方便继续排版。不过官方说明 PSD 不保存全部 OCR 语义、模型来源、修订历史和渲染器行为，超过单边 30,000 像素的页面也不能导出 PSD。.khrproj 才是应备份的编辑源。

验证状态：本轮只核对迁移后的官方仓库、0.83.5 release、安装、硬件、处理与导出文档。没有下载安装包或模型，没有创建项目，也没有实测 OCR、翻译、inpainting、GPU 加速和导出。文中的操作结果属于 docs-only 边界。

5. 本地优先和费用边界

本地视觉模型和本地 GGUF LLM 可以让页面留在电脑上。若选择 OpenAI、Claude、Gemini、DeepL 等托管 provider，相关请求会发送给对应服务，隐私、内容政策和费用也随 provider 变化。

6. 与 manga-image-translator 对比

manga-image-translator 官方项目 以 Python CLI、目录批处理、Web/API server 和配置项为主，适合接入脚本或服务。Koharu 更强调桌面项目、可视化画布、逐层校对和分层 PSD。要批量命令行处理时先看前者；要边看页面边修字、清图和排版时，Koharu 更顺手。

这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。

先判断这个项目是否适合你

适合谁用

适合在桌面端完成漫画页的半自动翻译、人工校对、清字和排版，也适合需要保留文字图层继续在图像编辑器中加工的流程。首次试用应只处理一张有权使用的页面；OCR、译文、字体和修补都需要人工复核，批量处理前先确定模型、显存和版权边界。

采用建议

Koharu 适合需要桌面可视化校对和分层交付的漫画翻译流程。先用单页确认设备、模型下载、OCR、译文和清字质量，再决定是否批量处理；选择远程 provider 前单独评估内容隐私与调用费用。

原教程未展开的系统信息

核心功能

  • 四阶段页面处理

    官方工作流按检测、OCR、翻译和 inpainting 处理页面。用户可以选当前页、选中页、整个项目或选中图层，并按需要重跑阶段。

  • 可编辑画布与多语言排版

    WebGPU 画布用于修补、文字放置和页面合成，排版支持自动适配、字体回退、竖排 CJK 与从右到左文字。

常见问题

Koharu 现在的官方仓库还是 mayocream/koharu 吗？

旧地址会跳转，当前官方仓库是 koharu-rs/koharu。引用 release、Issue 和源码时应使用迁移后的地址。

Koharu 必须有 NVIDIA 显卡才能运行吗？

不是。官方支持 Metal、CUDA、ROCm/HIP、Vulkan 和 CPU 路径，但具体模型与平台必须有对应 runtime；CPU 会明显更慢。

Koharu 的本地优先是否代表所有内容都不会上传？

不是。使用本地模型时可留在本机；选择托管 LLM 或机器翻译 provider 时，请求会发往对应服务。

导出 PSD 后可以删除 .khrproj 项目吗？

不建议。PSD 不保存全部 OCR 语义、模型来源、修订历史和渲染器行为，.khrproj 才是完整编辑源。

来源：Koharu 官方仓库、0.83.5 release 与 koharu.rs 文档，manga-image-translator 官方仓库。本轮没有本机安装。