跳转至

参与 Koharu

感谢你对 Koharu 的兴趣。Koharu 是一个本地优先、基于 Rust 的 ML 漫画翻译工具，我们非常欢迎你加入。

快速开始

最快上手的方式是从 good first issues 选一件。我们会精心挑选适合新贡献者的任务放在那里。

需要指引？来 Discord 找维护者和社区聊。

贡献方式

我们欢迎任何形式的贡献。

Bug 报告

  • 检测、OCR、修复、翻译流水线的问题
  • 崩溃、回归、性能下降
  • 渲染、PSD 导出、Provider 集成中的边界情况

功能开发

  • 新增 OCR、检测、修复或 LLM 后端
  • 改进文本渲染器、HTTP API 或 MCP Server
  • 扩展 UI 面板、快捷键与工作流

文档

  • 完善入门指南与 How-To
  • 增加示例、截图或小教程
  • 翻译到其他语言

测试

  • 为 workspace 各 crate 增加 Rust 单元测试
  • 扩展 tests/ 下的 Playwright E2E 覆盖
  • 贡献真实漫画页样本用于 OCR 与检测

基础设施

  • 改进构建与 CI
  • 调优模型下载、运行时缓存、加速路径
  • 保持 Windows、macOS、Linux 打包健康

认识代码库

Koharu 是一个 Rust workspace，外壳是 Tauri，UI 是 Next.js：

  • koharu/ — Tauri 桌面外壳
  • koharu-app/ — 应用后端与流水线编排
  • koharu-core/ — 共享类型、事件、工具
  • koharu-ml/ — 检测、OCR、修复、字体分析
  • koharu-llm/ — llama.cpp 绑定与 LLM Provider
  • koharu-renderer/ — 文本 Shape 与渲染
  • koharu-psd/ — 分层 PSD 导出
  • koharu-rpc/ — HTTP API 与 MCP Server
  • koharu-runtime/ — 运行时与模型下载管理
  • ui/ — Next.js Web UI
  • tests/ — Playwright E2E 测试
  • docs/ — 文档站 (English、日本語、简体中文、Português)

第一次贡献

  1. 浏览 Issue — 从 good first issue 标签开始。
  2. 放心提问 — 在 Discord 或 GitHub 上直接问没关系。
  3. 从小做起 — 文档修订和范围明确的小修复最容易合入。
  4. 先读代码 — 按所编辑文件里的既有写法来。

社区

沟通渠道

AI 使用政策

在为 Koharu 贡献时使用 AI 工具 (ChatGPT、Claude、Copilot 等 LLM)：

  • 请声明使用了 AI — 减轻维护者的审核负担
  • 你对提交的内容负全责 — 自己提交的 Issue 或 PR 都算你的
  • 低质量或未审阅的 AI 内容会直接被关闭
  • 反复提交低质量 ("slop") PR 的贡献者将在无预警情况下被封禁。 如果你承诺按此政策贡献，封禁可以解除。解封请到 Discord 申请。

我们欢迎用 AI 辅助开发，但在提交前贡献者本人必须充分审阅并测试。AI 生成的代码要读懂、验证，并调整到符合 Koharu 的标准。

下一步

准备好了就从这里出发：