RuntimeError: Error during installation: error: File not found: `/Users/fred/Library/Application Support/krita/pykrita/ai_diffusion/backend/requirements/macos-mps.txt`

快速结论：该报错发生在 Krita AI Diffusion 插件从 1.50.0 升级到 1.51.0 时，提示找不到 macos-mps.txt 需求文件。优先排查插件版本是否已更新到 1.51.1，该版本已修复此问题。

问题场景

用户使用 Krita AI Diffusion 插件的本地托管服务器（Local Managed Server），从 v1.50.0 升级到 v1.51.0 时触发。macOS 系统用户报告 macos-mps.txt 文件缺失；Windows 系统用户报告 --index-strategy 选项不支持的错误。两个问题均出现在同一版本升级过程中。

报错原文

2026-05-31 12:21:11,826 ERROR Installation failed: Error during installation: error: File not found: `/Users/fred/Library/Application Support/krita/pykrita/ai_diffusion/backend/requirements/macos-mps.txt`
Traceback (most recent call last):
  File ".../backend/server.py", line 375, in install
    await self._install(cb)
  ...
RuntimeError: Error during installation: error: File not found: `/Users/fred/Library/Application Support/krita/pykrita/ai_diffusion/backend/requirements/macos-mps.txt`

原因分析

插件 1.51.0 版本的升级流程中，硬编码引用了 macos-mps.txt 需求文件，但该文件在分发包中不存在（实际存在的是 macos.txt）。此外，Windows 用户的报错是因为升级流程试图使用 --index-strategy 参数，而该参数仅 uv 包管理器支持，旧版安装的 pip 环境无法识别此选项。

环境排查

确认 Krita AI Diffusion 插件版本：在 Krita 中查看扩展版本号，若为 1.51.0 则受此 bug 影响。
确认包管理器：日志中显示“Using uv”时使用 uv，否则使用 pip。Windows 用户错误信息中出现了 pip install 选项用法说明，表明使用的是 pip 而非 uv。
检查需求文件路径：macOS 用户验证 /Users/[用户名]/Library/Application Support/krita/pykrita/ai_diffusion/backend/requirements/ 目录下是否存在 macos-mps.txt。
查看升级备份目录：升级时会在 ComfyUI 目录下创建 upgrade-1.51.0/ComfyUI 备份，若该目录为空则说明升级流程已中断。

解决步骤

推荐方案（已修复）：升级到插件 v1.51.1 或更高版本。开发者 Acly 已在 1.51.1 中修复此问题。通过 Krita 的扩展管理器或手动下载最新版安装。
macOS 临时绕行（可优先尝试）：如果暂时无法升级，可将 .../backend/requirements/macos.txt 重命名为 macos-mps.txt。完整路径根据报错末尾的目录确定，例如：/Users/fred/Library/Application Support/krita/pykrita/ai_diffusion/backend/requirements/。社区用户报告此方法可让安装继续完成。
Windows 用户：建议使用“重新安装”（Re-install）选项，这将强制使用 uv 重新搭建环境，避免 pip 与 --index-strategy 不兼容的问题。如果需要继续使用 1.50.0，可以回滚。
回滚操作：如果无法解决，可暂时恢复使用 v1.50.0。在 Krita 的 AI Diffusion 面板中选择“设置”→“服务器”→“本地托管服务器”，点击“重新安装”以恢复旧版本。

验证方法

升级完成后，在 Krita 中打开 AI Diffusion 面板，查看插件版本号应更新为 1.51.1 或更高。尝试运行一次文生图或图生图流程，确保无报错。检查日志（Krita 脚本错误控制台或 .../krita/logs/ 下）中不再出现文件缺失或参数错误的相关信息。

参考来源

Acly/krita-ai-diffusion #2505

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

RuntimeError: Error during installation: error: File not found: `/Users/fred/Library/Application Support/krita/pykrita/ai_diffusion/backend/requirements/macos-mps.txt`