MinecraftConnectTool NPUBoost

MinecraftConnectTool NPUBoost 是 MinecraftConnectTool 的本地 AI 日志分析增强版本，重点加入 OpenVINO GenAI 本地推理、Intel NPU 优先调度、自动 Runtime 构建和离线规则兜底。

功能概览

• 基于 Avalonia UI 和 .NET 8 的 Windows 桌面工具。
• 支持 Minecraft 联机辅助、P2P/Link 页面、房间状态和本地日志分析。
• AI 分析运行在本机，不需要上传日志到远程服务。
• 自动构建 OpenVINO GenAI Runtime：Python Embed、pip、OpenVINO、Optimum Intel、PyTorch CPU 依赖和 TinyLlama OpenVINO IR 模型。
• 优先尝试 OpenVINO NPU 设备；无 NPU 或 NPU 编译失败时自动 fallback 到 AUTO、GPU、CPU 或本地规则引擎。
• 下载窗口支持复制完整初始化日志，方便排查模型导出和设备调用问题。

AI Runtime 说明

默认自动构建源：

mct-ai-runtime://openvino-genai-tinyllama-int4

当前固定 Runtime profile：

openvino-genai-2026.2.1-tinyllama-int4-sym-gs128-torch2.6-v3

主要依赖版本：

模型导出参数：

optimum-cli export openvino --model TinyLlama/TinyLlama-1.1B-Chat-v1.0 --task text-generation-with-past --weight-format int4 --sym --ratio 1.0 --group-size 128 --trust-remote-code .\model

推理配置：

• do_sample=False
• MAX_PROMPT_LEN=1024
• MIN_RESPONSE_LEN=128
• GENERATE_HINT=BEST_PERF
• CACHE_DIR=<Temp>/OpenVINOModelCache

系统要求

• Windows 10/11 x64。
• .NET 8 Desktop Runtime。
• 如果要使用 Intel NPU，需要系统中 OpenVINO 能检测到 NPU 设备。
• Intel NPU 需要正确安装 Intel NPU Driver，并在设备管理器中可见。
• 无 NPU 时仍可使用 CPU/GPU/OpenVINO 或本地规则引擎兜底。

构建

dotnet restore MinecraftConnectTool.csproj
dotnet build MinecraftConnectTool.csproj -c Release

发布

dotnet publish MinecraftConnectTool.csproj -c Release -r win-x64 --self-contained false -o .\publish /p:PublishSingleFile=true /p:PublishReadyToRun=false
Rename-Item .\publish\MinecraftConnectTool.exe AiVer.exe -Force

发布产物位于：

./publish/AiVer.exe

运行时目录

AI Runtime 默认写入应用配置目录下的临时目录，例如：

<ConfigRoot>/Temp/AiRuntime

其中包含：

python/
model/
.download/runtime.profile

如果切换 Runtime profile 或重新导出模型，删除 Temp/AiRuntime/model 后重新点击默认源初始化即可。

关键配置项

故障排查

如果任务管理器中的 Intel AI Boost 没有动，先复制分析日志中的诊断行：

OpenVINO 诊断: available_devices=...; requested_device=...; selected_device=...

判断方式：

• available_devices 没有 NPU：当前 OpenVINO 环境没有暴露 Intel NPU，检查驱动和设备管理器。
• selected_device=NPU：程序已请求 NPU，首次编译可能耗时较长，后续会走缓存。
• selected_device=CPU/GPU/AUTO：NPU 不可用或已 fallback。
• 出现 _attention_scale 导入失败：PyTorch 版本不对，当前代码会强制安装并验证 torch==2.6.0+cpu。
• 出现模型 XML 缺失：删除 Temp/AiRuntime/model 后重新初始化。

仓库内容

• Services/AiRuntimeDownloadService.cs：Runtime 下载、依赖安装、模型导出、profile 校验。
• Services/LocalAiLogAnalyzerService.cs：本地规则分析、OpenVINO GenAI 推理、设备 fallback 和日志清洗。
• Views/AiRuntimeDownloadWindow.*：Runtime 初始化下载窗口和日志复制。
• Views/RightPage/PanelAiAnalyze.*：AI 分析面板。

许可证

MIT License。详见 LICENSE。