Skip to main content
先读取启动界面、活动中心或对话框中的完整错误。更改项目文件或缓存前，确认出错的阶段。
首次启动可能需要先下载原生软件包，再显示项目列表。等待活动下载完成，确认仓库可访问。反复失败时，关闭所有 Koharu 进程，更新显卡驱动并重启电脑，再用稳定网络重试。保留完整错误。进程可能仍加载原生库时不要删除运行时目录。
检查 Hugging Face 模型仓库访问和缓存磁盘空间。代理、地区限制、认证、杀毒扫描或写入中断都可能阻止下载。重试同一模型一次；若同一文件仍失败，报告仓库、文件名和完整错误。
检测到 GPU 仍不足够，还需要兼容的驱动、后端与运行时。查看资源监视器和启动日志中的实际设备。没有完整加速路径时，CPU 回退是预期行为。详见硬件。
确认页面正向且清晰。更换 OCR 前先检查检测区域，在多页上谨慎调整阈值，日文可尝试漫画专用识别模型。重新翻译前先修正原文。
使用更小的移除蒙版，避开气泡边缘和线稿。先尝试直接修复模型，再考虑更重的生成模型。手动修补请放在独立栅格图层。
在设置 → 服务商核对凭据、基础 URL 与专用字段，再打开模型列表。兼容服务器需确认聊天端点；只有所选模型支持图片时才启用视觉输入。
先取消已有登录或请求再重试。确认浏览器授权使用了目标 ChatGPT 账号。Agent 登录与 OpenAI 翻译服务密钥互相独立。
确认图层有译文、可见、不透明度非零，且字体覆盖目标文字。大幅修改文本后重置自动适配。只有原文的图层不会被渲染。
保存项目修订号、页面、格式、画布截图和导出图片。两者来自同一预备帧，明显差异应作为问题报告。

​
收集详细日志

从终端启动 Koharu，才能为新进程启用详细日志。终端是运行输入或粘贴命令的窗口，复现期间请保持打开。
先保存工作并关闭所有 Koharu 窗口。日志设置只对新启动的进程生效。
1

打开 PowerShell

在开始菜单搜索 PowerShell，打开 Windows PowerShell。Windows Terminal 的 PowerShell 标签也可以。不要在命令提示符中运行这些命令。
2

启动 Koharu

使用 Ctrl+V 或右键粘贴，然后按 Enter。不要复制窗口中的 PS C:\Users\YourName> 提示符。
3

需要时使用完整路径

如果无法识别命令，在开始菜单搜索 Koharu，右键选择打开文件所在的位置。打开快捷方式的属性并复制目标。替换下方示例路径，保留 & 和引号。
环境变量仅在这个 PowerShell 窗口中有效，关闭窗口即可清除。
用这次启动的 Koharu 复现问题。应用关闭前，终端可能一直输出而不出现新提示符。保留错误前后的内容，不要只复制最后一行。之后正常关闭应用；如果启动的进程卡住，可在终端按一次 Ctrl+C。

​
保存日志文件

打开新终端，运行对应平台的命令，复现问题后关闭 Koharu。日志会保存到用户主目录。如果短命令不可用，替换为之前使用的完整可执行文件路径。
共享前，把凭据、私密文件名和页面文本替换为 [removed]，保留周围诊断信息。同时附上操作系统、Koharu 版本、目标操作、复现步骤和错误的大致时间。 将文本日志附到 GitHub issue，或在 Discord寻求帮助。