Krita-AI-Diffusion本地服务器安装失败问题分析与解决方案

Krita-AI-Diffusion本地服务器安装失败问题分析与解决方案

krita-ai-diffusion Streamlined interface for generating images with AI in Krita. Inpaint and outpaint with optional text prompt, no tweaking required. 项目地址: https://gitcode.com/gh_mirrors/kr/krita-ai-diffusion

在使用Krita-AI-Diffusion插件时，部分用户在安装本地服务器过程中可能会遇到一个特定的错误：Python包哈希值不匹配。这个问题通常表现为安装过程中突然中断，并显示类似"THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE"的错误信息。

问题现象

用户在安装过程中会遇到torch包的哈希校验失败错误，具体表现为系统期望的sha256哈希值与实际下载文件的哈希值不一致。这种错误通常发生在下载PyTorch相关依赖包时，系统显示类似以下信息：

Expected sha256 bf1438aeb124fc36ae2d6b4b5c76d751d47a9fc3d7b15291b41f0caa8d5bf27b
Got f35f2b5c671e43a50857b0d854126ce239e78409eb7002d1392005e412110ed4

问题原因

这种哈希值不匹配的情况通常由以下几种原因导致：

1. 网络下载中断或不完整：在下载大型依赖包(如PyTorch)时，网络波动可能导致文件下载不完整
2. 缓存文件损坏：Pip包管理器的缓存中可能保存了损坏或不完整的包文件
3. 安装过程被意外中断：在之前的安装尝试中，安装过程被意外终止导致残留文件

解决方案

方法一：清除Pip缓存

1. 打开命令提示符(CMD)
2. 执行以下命令清除pip缓存：

   python -m pip cache purge
   

3. 重新启动Krita并尝试重新安装插件

方法二：手动删除缓存文件

如果上述方法无效，可以尝试手动删除缓存文件：

1. 导航至系统缓存目录：

   C:\Users\<用户名>\AppData\Local\pip\cache
   

2. 删除该目录下的所有文件
3. 重新启动安装过程

方法三：完全重新安装

1. 卸载Krita-AI-Diffusion插件
2. 手动删除相关目录：
   • %APPDATA%\krita\ai_diffusion (插件配置目录)
   • C:\Users\<用户名>\AppData\Local\pip\cache (pip缓存目录)
3. 重新安装插件

预防措施

为了避免类似问题再次发生，建议：

1. 确保网络连接稳定，特别是在下载大型依赖包时
2. 在安装过程中不要中断Krita或关闭计算机
3. 定期清理pip缓存，特别是在安装失败后
4. 考虑使用更稳定的网络环境进行下载

技术原理

Python的pip包管理器使用哈希校验来确保下载的包文件完整且未被篡改。当文件下载不完整或缓存损坏时，实际文件的哈希值就会与官方记录不符，导致安装失败。清除缓存可以强制pip重新下载完整的包文件，从而解决这个问题。

通过以上方法，大多数用户应该能够成功解决本地服务器安装失败的问题。如果问题仍然存在，可能需要进一步检查系统环境或寻求更专业的技术支持。

krita-ai-diffusion Streamlined interface for generating images with AI in Krita. Inpaint and outpaint with optional text prompt, no tweaking required. 项目地址: https://gitcode.com/gh_mirrors/kr/krita-ai-diffusion