[qiyinxi]

发 ModAVDManager v0.4.1。这一版随 ModAVD 0.38.1 进包。

代码是现在的 main（73954b3），相对 v0.4.0 带 #77、#74、#75、#81、#82；#79 只改测试。这个 PR 有三个提交：

• 把 buildinfo.Version 改成 0.4.1（f045229）；
• 加上 release/0.4.1.md（Release 的说明）和 release/0.4.1.SHA256SUMS.txt（01e3f6a）；
• README 改回一句（ce479e8）。components fetch：下载前说明这次用哪个下载源 #82 写进去的「0.38.1 起补全组件.bat 调命令行、先问下载源」不成立了：0.38.1 只修 补全组件.bat 装系统镜像必然失败（0.37.0–0.38.0） ModAVD#118，随包批处理照旧调 fetch-components.ps1。「下载源」那一行的说明照留。

顺序

1. 合这个 PR；
2. 在合并提交上打 tag v0.4.1，发版 workflow 编出 exe 和 zip，逐个核对这里的 SHA256SUMS，再建草稿 Release；
3. 核对草稿以后发布；
4. 0.4.1 发布以后再打 ModAVD 0.38.1。

哈希

在 main（73954b3）上先提交版本号，再用 Go 1.26.5、GOTOOLCHAIN=local 连编两次，两次结果相同：

• ModAVD.exe：5448c8b6e30d3839fe8243c546f85a2ea5fdd63cea2709f55511d27d1aa36380
• tools/modavd.exe：7a7b43a0ce2bfd076bb6080d19568efa4b34340ae03f4880fbab0b0b05291054
• ModAVDManager-0.4.1-win-x64.zip（go run ./internal/tools/mkzip -version 0.4.1，两次打包结果相同）：a9021792a3d3f4e282b7c8fa977ca1660c91cff7c79263c16a086f29f1a8dc4d

本机 Defender 静态扫描，两个 exe 和 zip 都干净。README 那个提交只改文档，不影响编出来的字节。

说明的来源

release/0.4.1.md 写的是相对 v0.4.0 的改动，逐条对照了 v0.4.0..main 的提交：

• fix(update): 修复退出竞态并重试短管理器占用 #77：换包时，读不到路径或命令行的进程先确认还在不在，已经退出的不算占用；碰上本根目录的短命令会重扫两次；
• fix: 清理执行桥日志并按实例归类问题包 #74：执行桥日志并进清理，问题包里按实例归类；
• fix(gui): --help 用信息框显示用法，退出码 0 #81：ModAVD.exe --help 用信息框显示用法，退出码 0；
• components fetch：下载前说明这次用哪个下载源 #82：components fetch 下载前说明这次用哪个下载源；
• 补充 busy 原因和启动、新建失败状态的机读细节 #75：给调用方那一节，error.details 多了 reason、lock、instance_status、qemu_running、instance_exists。

protocol 还是 2。#77 那条写明了：换包由当前装着的那份 modavd 来做，所以从 0.38.0 升 0.38.1 的那一次还是旧逻辑。

测过什么

• fix(update): 修复退出竞态并重试短管理器占用 #77 主场景：ModAVD 0.37.1 根目录换上含 fix(update): 修复退出竞态并重试短管理器占用 #77 的候选版。实例正常关机后马上 update install 装 0.38.0，当时 emulator.exe 的关机辅助进程还在，23.7 秒装好，退出码 0。
• fix(gui): --help 用信息框显示用法，退出码 0 #81、components fetch：下载前说明这次用哪个下载源 #82：各自的 PR 里有单测和变异检查；全量 go test 在这个分支上本机另跑一遍。

Refs ModAVD/ModAVD#77、ModAVD/ModAVD#97、ModAVD/ModAVD#105、ModAVD/ModAVD#115、ModAVD/ModAVD#45