【Bug】Windows 桌面端：安装目录被第三方进程占用时更新必然失败，且失败静默（MoveFileExW error 32）

[xinming-chenniang]

• 适用版本：@deepseek-ai/dsh-desktop 0.2.0-rc.2（更新失败）→ 0.2.1-rc.2（手工装上）
• 平台：Windows 11 26200（10.0.26220），简体中文，per-user 安装
• 日期：2026-10-19
• 一句话：更新流程里"把整个安装目录改名成 …Harness.old-{GUID}"这一步要求目录可独占重命名；只要有任何进程以不含 FILE_SHARE_DELETE 的方式打开着该目录（本机实测是搜狗输入法的 SOGOUSmartAssistant.exe），MoveFileExW 就报 32、重试 10 次后放弃 —— 更新失败、用户看不到任何提示、应用被关掉后不自动回来。

二、环境

项	值
应用	@deepseek-ai/dsh-desktop，0.2.0-rc.2 → 0.2.1-rc.2，Electron 44
安装位置	%LOCALAPPDATA%\Programs\DeepSeek Harness（per-user NSIS，注册表 …\Uninstall\1bf39983-50d0-5fe0-9ef4-cece76f67c5e）
更新器	electron-updater 6.8.9（在 resources\app.asar 内），channel nightly
feed	https://download.deepseek.com/dsh-desk/feeds/win-x64/nightly.yml
安装包	deepseek-harness-0.2.1-rc.2-win-x64.exe，289,385,456 B，sha512 与本机文件逐字节一致，签名 Valid（CN="Hangzhou DeepSeek Artificial Intelligence Co., Ltd."）
更新缓存	%LOCALAPPDATA%\@deepseek-aidsh-desktop-updater\（installer.exe、pending\…exe、installer-logs\）

三、复现

A. 真实场景

1. 让任意常驻程序打开安装目录的句柄（本机是搜狗输入法自带组件 SOGOUSmartAssistant.exe，随输入法常驻）；
2. 在 GUI 里点更新，下载完成后点"重启并安装"；
3. 应用关闭 → 版本不变；%LOCALAPPDATA%\@deepseek-aidsh-desktop-updater\installer-logs\ 多出一份 directory-failure-<时间戳>.log。

B. 最小复现（与 DSH 无关，段 5 行；本机已实测）

Add-Type -Namespace Win32 -Name DirHold -MemberDefinition '[DllImport("kernel32.dll", SetLastError=true, CharSet=CharSet.Unicode)] public static extern Microsoft.Win32.SafeHandles.SafeFileHandle CreateFileW(string lpFileName, uint dwDesiredAccess, uint dwShareMode, IntPtr lpSecurityAttributes, uint dwCreationDisposition, uint dwFlagsAndAttributes, IntPtr hTemplateFile);'
New-Item -ItemType Directory -Force D:\t\d | Out-Null
# share=3 表示 FILE_SHARE_READ|WRITE（不含 DELETE）
$h = [Win32.DirHold]::CreateFileW('D:\t\d', [uint32]1, [uint32]3, [IntPtr]::Zero, [uint32]3, [uint32]0x02000000, [IntPtr]::Zero)
Rename-Item D:\t\d d2      # ← 报 “另一个程序正在使用此文件” / MoveFileExW error 32

share mode 扫描（2026-10-19 本机实测，每组都是新建目录 + 新句柄）：

share mode	含义	重命名该目录
0	无共享	FAILED win32 32
1	FILE_SHARE_READ	FAILED win32 32
3	READ|WRITE	FAILED win32 32
5	READ|DELETE	OK
7	READ|WRITE|DELETE	OK

结论：占用者没有给 FILE_SHARE_DELETE 时，目录就无法重命名。这也解释了为什么 Explorer 偶尔持有的句柄（全共享）不致命，而搜狗那个句柄必然卡死。

四、证据

4.1 三份失败日志（除 GUID/时间外逐字节一致，各 593 B）

Operation: MoveFileExW
Windows error: 32 (另一个程序正在使用此文件，进程无法访问。)
Source: C:\Users\<user>\AppData\Local\Programs\DeepSeek Harness
Destination: C:\Users\<user>\AppData\Local\Programs\DeepSeek Harness.old-{10A1B318-68A3-4C94-A7E9-7D62C5396E92}
Restoration error: 0
Time: 2026-10-19 00:49:39
Windows: 10.0.26220
Attempts:
backup: Windows error: 32   ×10

三份分别对应 00:08:10、00:11:35（用户点"重启并安装"）、00:49:39（应用已全部退出后手工跑安装包）。

4.2 关键对照：排除了"应用自己锁的目录"

• 00:49 那次：先确认 Get-Process -Name 'DeepSeek Harness' 为 0 个进程，且以 FILE_SHARE_NONE 打开 DeepSeek Harness.exe 成功（说明 exe 未被锁）→ 仍然同一个 error 32。
• handle64.exe -a "<安装目录>" 扫描（01:07:45 与 01:09:01 两次采样一致）：唯一持续持有该目录句柄的非 DSH 进程是

SOGOUSmartAssistant.exe pid: 11988  type: File  103C: C:\Users\<user>\AppData\Local\Programs\DeepSeek Harness
SOGOUSmartAssistant.exe pid: 6080   type: File    9C: C:\Users\<user>\AppData\Local\Programs\DeepSeek Harness

• 手工结束这两个进程后，同一目录立刻可以改名，安装包 deepseek-harness-0.2.1-rc.2-win-x64.exe /S --force-run 退出码 0，31.5 秒完成，版本变为 0.2.1-rc.2。

4.3 相关代码位置

• resources\app.asar → node_modules\electron-updater\out\BaseUpdater.js 第 13–27 行：quitAndInstall() 先 install()（spawn 安装器）再 app.quit()（setImmediate）—— 应用还没退出，安装器就已经开始改名了，这一条靠自己就能触发 4.1 的失败。
• 安装器侧是自定义 NSIS 插件：%TEMP%\ns*.tmp\window-frame.dll（161,256 B，sha256 E8E361AD93A5DC40EF7E39805D56A3CD2E691C8C8CC8A118271E43754EE6D6CA，无版本信息资源），.old-{GUID} 改名与 directory-failure-*.log 均由它输出。

五、影响面

1. 任何持有安装目录句柄的第三方程序（输入法助手、杀软/EDR、索引器、文件管理器增强、截图/OCR 工具）都会让桌面端永久无法自动更新，且用户无从判断原因；
2. 失败静默：无对话框、无托盘提示；00:08 与 00:11 两次应用被关闭后没有自动重启（--force-run 只在成功路径生效），用户只能自己发现版本没变；
3. 残留不清理：installer.exe 与 pending\*.exe 各 289 MB（同一安装包两份，共 578 MB）、三份失败日志、%TEMP%\ns*.tmp 三个目录。

六、建议修法（按优先级）

1. 去掉"整目录改名"：改用 electron-builder 默认的逐文件覆盖安装（只需文件级访问，不需要目录独占）；若必须保留旧版备份，改成"复制到 .old-{GUID}"（复制不要求独占），或在改名失败时降级为覆盖安装而不是中止更新。
2. 修 quitAndInstall() 时序：先退出应用，再由独立进程（或 app.on('quit') 之后）启动安装器。
3. 失败要可见：弹窗/通知 + 失败原因（含"哪个进程占用了目录"）+ 一键重试；失败路径也要把旧版本拉起来。
4. 清理残留：pending\、installer.exe、%TEMP%\ns*.tmp。

七、用户侧临时绕过

# 看谁占着安装目录
handle64.exe -a "$env:LOCALAPPDATA\Programs\DeepSeek Harness"
# 结束其中的非 DSH 进程（本机是 SOGOUSmartAssistant.exe，会自行重启，输入法本体不受影响）
# 然后要么在 GUI 里重试，要么手工：先把旧目录改名让位，再跑缓存里的安装包
Rename-Item "$env:LOCALAPPDATA\Programs\DeepSeek Harness" "DeepSeek Harness.old-manual"
& "$env:LOCALAPPDATA\@deepseek-aidsh-desktop-updater\pending\deepseek-harness-0.2.1-rc.2-win-x64.exe" /S --force-run

八、附件（同目录 evidence\）

文件	说明
directory-failure-20261019-00810.log / -01135.log / -04939.log	三份失败日志原文
handle64-scan-20261019-0104.txt	句柄扫描原始输出（含 DSH 自身句柄）
window-frame.dll	做改名的自定义 NSIS 插件（sha256 见 4.3）
apply-update.log	本机手工执行器的逐步日志：含"杀 DSH 后仍失败"与"杀掉占用者后成功"的完整对照
RESULT.txt	最终结论（verdict: updated）

apply-update.log
directory-failure-20261019-00810.log
directory-failure-20261019-01135.log
directory-failure-20261019-04939.log
handle64-scan-20261019-0104.txt
RESULT.txt

[poorlunch]

感谢这份报告。我遇到了几乎一模一样的问题，然后叫ai以此报告为参考对象，最终定位到的元凶是搜狗输入法。
省流版：搜狗官方的右键扩展管理菜单（设置》高级》最下方的“系统右键扩展管理”）会把四个dll强行绑定至系统的explorer，带来的结果是：1. 你使用dsh时，搜狗会往dsh的工作区里写debug.log；2. 关闭dsh准备更新时，explorer仍然占用dsh的主程序导致更新静默失败。

附件中是完整的事件报告。

dsh-update-failure-report-2026-10-25.md

[zhouwei929]

补充一份本机实测数据（Windows 11 22621，安装目录为非默认路径 D:\DEEPSEEK，0.2.2-rc.1 → 0.2.2-rc.2）。结论与原帖有一处重要出入。

1. 第三方占用为 0，这台机器是纯自锁

原帖把元凶定位到常驻第三方程序（搜狗 SOGOUSmartAssistant.exe）。本机实测结果不同：全系统句柄扫描下来，第三方占用为 0。

• 方法：NtQuerySystemInformation(SystemExtendedHandleInformation) 枚举全部句柄（约 16.8 万个），逐个 DuplicateHandle 后取 GetFinalPathNameByHandleW，筛选路径落在安装目录内的句柄。
• 结果：命中 40 个句柄，全部来自 DeepSeek Harness 自身的 7 个进程（主进程 / host / 渲染 / GPU / 网络 / 音频）。逐进程分布为 9 / 7 / 7 / 7 / 4 / 4 / 2。
• 补扫了 14 个 OpenProcess 被拒的受保护进程（Defender 相关、smss / csrss / wininit 等）：均不持有该目录。
• 同时排除：安装目录不是符号链接或 junction；D 盘 NTFS 健康；文件系统过滤驱动只有系统自带（WdFilter / CldFlt / luafv / Wof 等），无第三方。

也就是说，不需要任何第三方常驻程序，这个缺陷也能稳定复现。

2. quitAndInstall() 的时序问题可独立触发失败

原帖 4.3 已指出 BaseUpdater.js 是先 install() 再 app.quit()。本机把这个窗口抓到了：

时刻	事件
00:34:02	应用仍在写会话文件（进程还活着）
00:34:03	安装器被拉起（Prefetch 记录）
00:34:28	第 5 次 MoveFileExW error 32，25 秒内 10 次重试全部失败

安装器开工时旧进程尚未退完，目录必然被锁。这条不依赖第三方，靠自己就能触发。

3. 点窗口 × 不会退出，只是隐藏到托盘

这一点值得单独强调，因为它是「我已经退出了」这个误判的主要来源。主进程代码里窗口关闭被拦截后改为隐藏：

// resources/app.asar → lib/main.js
window.on("close", (event) => {
    if (quitting || shellInstallerOwnsQuit || sessionEnding) return;
    event.preventDefault();        // 拦掉关闭
    // ...
    hideMainWindow(window);        // 改为隐藏到托盘
});

真正的退出入口是托盘右键菜单里的「退出 DeepSeek Harness」。首次隐藏还会弹一次确认框，文案为「正在运行的任务不会中断，可在系统托盘中重新打开窗口」。

4. 判断「可以安装了」的正确标准

本机实测发现：进程数归零并不是充分条件。曾出现「退出应用后仍失败」，根因正是上面第 2 条的时序竞态。

建议改用安装器真正需要的条件来判断——目录能否以 DELETE 访问且按全共享打开（重命名要求持有者提供 FILE_SHARE_DELETE）：

Add-Type -Namespace Win32 -Name DirHold -MemberDefinition '[DllImport("kernel32.dll", SetLastError=true, CharSet=CharSet.Unicode)] public static extern IntPtr CreateFileW(string lpFileName, uint dwDesiredAccess, uint dwShareMode, IntPtr lpSecurityAttributes, uint dwCreationDisposition, uint dwFlagsAndAttributes, IntPtr hTemplateFile);'

$dir = 'D:\DEEPSEEK'
# DELETE 访问 + READ|WRITE|DELETE 共享(7)；返回 -1 表示有进程以不含 FILE_SHARE_DELETE 的方式占着
$h = [Win32.DirHold]::CreateFileW($dir, 0x00010000, 7, [IntPtr]::Zero, 3, 0x02000000, [IntPtr]::Zero)
if ($h -eq [IntPtr]::new(-1)) {
    $code = [Runtime.InteropServices.Marshal]::GetLastWin32Error()
    "仍被占用: win32 $code $([ComponentModel.Win32Exception]::new($code).Message)"
} else { '可重命名' }

本机结果很能说明问题：

目标	能否重命名
D:\DEEPSEEK（目录）	被占用，win32 32
D:\DEEPSEEK\resources\app.asar	被占用，win32 32
D:\DEEPSEEK\DeepSeek Harness.exe	可重命名

注意 DeepSeek Harness.exe 本身是自由的，被锁的是目录和 app.asar。安装器要改的是整个目录，所以照样失败。这也解释了为什么只检查「exe 有没有被锁」会误判。

5. 最终生效的做法

在应用外部用独立 PowerShell 完成：先结束 DSH 全部进程 → 轮询确认目录可独占重命名 → 再运行缓存中已校验的安装包。

本机对照：

• 00:34:03 安装器启动（此时应用还活着）→ 00:34:28 失败
• 00:58:54 安装器启动（进程已清空）→ 00:59:17 目录被替换 → 00:59:27 新版启动，0.2.2-rc.2 安装成功

安装包一直在本机缓存里，sha512 与 update-info.json 记录一致、签名 Valid，无需重新下载。

6. 两点补充

• 自定义 NSIS 插件在版本间有变化：本机 window-frame.dll 为 169,968 字节，sha256 9FBB8F40091CB73722E60348A3DF397B132F150ED7D7EC6CCB20E3CE68968032；原帖附件记录的是 161,256 字节 / E8E361AD…E6D6CA。但「整目录改名 + 10 次重试 + 失败静默」的行为一致。
• 残留未清理依然存在：本机 @deepseek-aidsh-desktop-updater 目录占 572.2 MB（installer.exe 与 pending\*.exe 是同一份 299,659,528 字节安装包的两份拷贝）。

原帖第六节的建议里，第 2 条（修 quitAndInstall() 时序）可以比现在更靠前——它不需要任何外部条件，靠自己就能触发失败；第 1 条（去掉整目录改名，或改名失败时降级为覆盖安装）依然是最彻底的修法。

[cphxj123]

用你的方法成功解决

[xinming-chenniang]

彳亍。快去我的主页随机选择一个幸运仓库点个star（