[Desktop/Windows] 应用内更新静默失败：缺少 HKCU\Software\<GUID>\InstallLocation 时安装器 preflight 直接 exit 2，手动安装也拒绝原目录

[FIXUAI]

Summary / 摘要

中文：这台机器上 DSH 桌面端的旧安装从未在注册表写入 HKCU\Software\<GUID>\InstallLocation。而 apps/desktop/installer/path.nsh 的 InstallerPreflight 正是用这个值判断“目标目录是不是已注册的安装目录”，取不到就把目录判为“不属于本产品”：

• 应用内更新（electron-updater spawn pending\...exe --updated /S --force-run，静默）→ preflight 失败 → SetErrorLevel 2 + Quit，UI 无任何错误、没有日志、没有任何文件被写，界面停在 ready，用户只能反复点“安装并重启”；
• 手动运行同一个安装包（GUI） → 点“安装”弹 INSTALLER_PATH_OWNERSHIP（“请选择空文件夹，或 DeepSeek Harness 原来的安装目录”），退出码 2，安装目录原封不动。

把旧目录改名使目标路径变空后，同一个安装包一次装成功（exit 0），并把私有键和卸载项的 InstallLocation 都写入了。

English TL;DR：On this machine the previous DSH install had no HKCU\Software\<GUID>\InstallLocation (private electron-builder key). InstallerPreflight (apps/desktop/installer/path.nsh:120-141) treats a directory as "not ours" whenever that value is absent, even if $INSTDIR\DeepSeek Harness.exe exists. Consequences: (a) silent in-app update (--updated /S --force-run) exits with code 2 at .onInit before touching anything — no dialog, no log, version never changes; (b) the same installer run with the GUI rejects the real installation folder with INSTALLER_PATH_OWNERSHIP. Renaming the old folder (so the target is empty) makes the same installer succeed immediately.

Reproduction / 复现步骤

1. 在一台“安装目录里有完整 DSH 文件、但注册表没有 HKCU\Software\<GUID>\InstallLocation”的机器上启动 0.2.2-rc.1（per-user 安装，C:\Users\<user>\AppData\Local\Programs\DeepSeek Harness）。
2. 等夜间通道发现 0.2.2-rc.2 并下载完成（状态变 ready）。
3. 点“安装并重启”。应用会正常退出，安装器也会被拉起（%TEMP% 下出现 NSIS 插件目录），但安装目录没有任何文件被替换；重开后仍是 rc.1。
4. 重复第 3 步，结果完全一致。
5. 手动运行 %LOCALAPPDATA%\@deepseek-aidsh-desktop-updater\pending\deepseek-harness-0.2.2-rc.2-win-x64.exe（GUI）：目录页已经识别出原安装目录，点“安装”立即弹 INSTALLER_PATH_OWNERSHIP，退出码 2。

关于“注册表项缺失”的来源：本机不是通过解压 app-64.7z 安装的（目录内有安装器写入的 Uninstall DeepSeek Harness.exe，时间戳与安装目录一致），但实测两个键都不存在（见 §Evidence）。这条 issue 描述的是这一类状态造成的结果——无论该状态是安装器异常退出、注册表被清理，还是上游 §Root cause 提到的键不对称造成，症状与修复路径相同。

Current behavior / 实际结果

• 应用内更新：零反馈静默失败。DesktopUpdateCoordinator.install() 已经把状态置为 installing，beforeRestart() 也全部通过（应用确实退出、安装器确实被 spawn），失败发生在安装器进程内部，外壳拿不到任何信号，UI 回到 ready，用户除了“再点一次”没有别的可做。
• 唯一的失败足迹是 %TEMP%\ns*.tmp 里残留的 $PLUGINSDIR\window-frame.dll；@deepseek-aidsh-desktop-updater\installer-logs\ 下没有任何 preflight 报告（该目录只在 extract/directory 阶段失败时才写）。
• 手动安装：INSTALLER_PATH_OWNERSHIP 拒绝真实安装目录，退出码 2。

Expected behavior / 期望结果

1. 静默 preflight 失败必须留痕：写 %LOCALAPPDATA%\@deepseek-aidsh-desktop-updater\installer-logs\preflight-failure-*.log（含 InstallLocation 的期望值/实际值、$INSTDIR、exit code），并把安装器的退出码回传为 UI 上的可见失败（现在 install 阶段只有 error 分支才提示，而这条路径不产生 error）。
2. 所有权判断增加文件凭据回退：当 InstallLocation 缺失但 $INSTDIR 等于默认安装目录、且 $INSTDIR\DeepSeek Harness.exe 与 $INSTDIR\resources\app-update.yml 都存在时，视为既有安装（至少提示“修复注册表并继续”），不要要求用户改名目录才能升级。
3. 键不对称：customInstall 显式写的是 ${UNINSTALL_REGISTRY_KEY} 的 InstallLocation（scripts/installer.nsh:253），而 preflight 读的是 ${INSTALL_REGISTRY_KEY}（path.nsh:127）；建议两处都写，避免私有键缺失时永远无法自愈。
4. 应用内更新失败默认落盘日志：DesktopUpdateJournal 目前仅在 DSH_DESKTOP_UPDATE_JOURNAL_DIR 存在时创建，导致这类事故“零证据”。

Environment / 环境

项	值
产品	DeepSeek Harness Desktop（Electron 壳 + 内置 dsh 运行时）
出问题版本	0.2.2-rc.1（app.asar!package.json = 0.2.2-rc.1，exe FileVersion = 0.2.2-rc.1）
目标版本	0.2.2-rc.2（安装后 exe FileVersion = 0.2.2-rc.2，dshBuildCommit = a6b1b85f44891ee1484bed6a9fc08acaae777d90）
通道 / feed	nightly，https://download.deepseek.com/dsh-desk/feeds/win-x64/
OS	Windows 10 家庭中文版 25H2，10.0.26200.9711，x64
安装方式	per-user，目录 C:\Users\<user>\AppData\Local\Programs\DeepSeek Harness（路径无空格以外特殊字符，本地固定磁盘 NTFS）
安装包	deepseek-harness-0.2.2-rc.2-win-x64.exe，299,659,528 B；Authenticode Valid（CN="Hangzhou DeepSeek Artificial Intelligence Co., Ltd."）；SHA-512(base64) 与 pending\update-info.json 完全一致：5rRAkVruKkm4KELAbTqV8ZFrMwSo3oESnzXb9ebkJWPCMe6WuHORQZR63uY+BqAc6sBdyBtwSelsCGh0k1NcJA==
分辨率	100%（GUI 与静默两种方式同样失败）

Evidence / 证据

时间线（UTC+8，2026-11-12）：

时间	事件
09:04:43	@deepseek-aidsh-desktop-updater\current.blockmap 写入
09:05:05	pending\deepseek-harness-0.2.2-rc.2-win-x64.exe（299,659,528 B）落盘
09:05:07	pending\update-info.json（sha512 如上，校验通过）
09:05:17	%TEMP%\nsaEFFB.tmp 出现，内含且仅含 $PLUGINSDIR\window-frame.dll（169,968 B）→ 应用内更新 spawn 的安装器
10:17:45	%TEMP%\nso47ED.tmp，同上 → 第二次点“安装并重启”
之后	安装目录内所有文件 mtime 仍为 11-04 17:30:40，DeepSeek Harness.exe FileVersion 仍为 0.2.2-rc.1
11:05:27	手动运行同一安装包（GUI，不带 /S）：8 秒后退出码 2，目录未变
12:54:11	旧目录改名（DeepSeek Harness.rc1-backup-*），目标路径为空
12:54:33	同一安装包 GUI 安装，退出码 0
12:54:34	DeepSeek Harness.exe FileVersion = 0.2.2-rc.2，app.asar 内 package.json = 0.2.2-rc.2 ✅

注册表（安装前，HKCU，全部为只读扫描）：

• HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall 下没有 DeepSeek Harness 项；
• 枚举 HKCU\Software 两级，只有 OpenCode、MinerU 的 GUID 键带 InstallLocation，没有任何键指向 DSH 安装目录。

注册表（12:54 安装成功后新增）：

HKCU\Software\1bf39983-50d0-5fe0-9ef4-cece76f67c5e
    InstallLocation = C:\Users\<user>\AppData\Local\Programs\DeepSeek Harness
    KeepShortcuts   = true
    ShortcutName    = DeepSeek Harness
HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall\1bf39983-50d0-5fe0-9ef4-cece76f67c5e
    DisplayName     = DeepSeek Harness
    DisplayVersion  = 0.2.2-rc.2

Root cause / 源码定位

apps/desktop/installer/path.nsh（L120–141）：

; A new installation requires an empty directory; updates require the registered executable.
Function InstallerPreflight
    Call InstallerValidatePath
    ${If} $InstallerError != ""
        Return
    ${EndIf}
    StrCpy $INSTDIR $InstallerPath
    ReadRegStr $0 HKCU "${INSTALL_REGISTRY_KEY}" "InstallLocation"
    ${If} $0 != $INSTDIR
    ${OrIfNot} ${FileExists} "$INSTDIR\${APP_EXECUTABLE_FILENAME}"
        FindFirst $0 $1 "$INSTDIR\*.*"
        ${DoWhile} $1 != ""
            ...
                FindClose $0
                StrCpy $InstallerError "$(INSTALLER_PATH_OWNERSHIP)"
                Return

关键点：InstallLocation 为空时 $0 != $INSTDIR 恒成立，于是直接进入“非空目录 → 拒绝”的分支——$INSTDIR\DeepSeek Harness.exe 存在并不能救场（那个 FileExists 是 OrIfNot，只会让条件更容易成立）。唯一的凭据就是注册表相等。

静默路径把它变成“零反馈”（apps/desktop/scripts/installer.nsh L75–82）：

  Call InstallerCheckAppRunning
  ${If} ${Silent}
    Call InstallerPreflight
    ${If} $InstallerError != ""
      SetErrorLevel 2
      Quit
    ${EndIf}
  ${EndIf}

Quit 发生在 InitPluginsDir 之后，所以 %TEMP%\ns*.tmp 会留下 window-frame.dll，而 preflight 阶段还没有任何 report 写入 → 用户侧零线索。这也解释了为什么“应用正常退出 + 安装器确实被拉起”的机器仍然永远升级不了。

次要观察（不确定性已在文中标注）：scripts/installer.nsh L253 的 customInstall 只写了 ${UNINSTALL_REGISTRY_KEY} 的 InstallLocation，preflight 读的是 ${INSTALL_REGISTRY_KEY}；私有键若因任何原因缺失，安装器无法通过“再装一次”自愈，只能把目录清空重装。

Workaround / 规避（本机已验证）

1. 完全退出 DSH（托盘退出，确认任务管理器里没有 DeepSeek Harness.exe）。
2. 把安装目录改名（例如 DeepSeek Harness.old），使目标路径不存在或为空。
3. 运行 %LOCALAPPDATA%\@deepseek-aidsh-desktop-updater\pending\deepseek-harness-<version>-win-x64.exe，目录填回原路径，正常 GUI 安装。
4. 装完确认 HKCU\Software\<GUID>\InstallLocation 与卸载项都已写入 → 之后应用内更新可以过 preflight。

（同一思路也可用 /S /D=<安装目录> 静默完成，/D 必须放最后且不加引号。）

Related / 相关讨论

• 官网下载的windows客户端无法安装 #8338：安装器卡在“无法关闭”，每次失败后 %TEMP%\ns*.tmp 里只剩 window-frame.dll——足迹相同，但失败点不同（那条是 InstallerCheckAppRunning）。
• Windows desktop installer rejects every install directory (INSTALLER_PATH_INVALID) on a machine with redirected AppData #12317：INSTALLER_PATH_INVALID 全拒（AppData 被重定向的机器），最终也是“解出 app-64.7z 直接用”，代价同样是丢注册项。
• Windows 桌面端点「安装并重启」永久卡在「正在准备重启…」，安装器从未启动（0.2.1-rc.2 → rc.3） #10973 / [Bug] Desktop auto-updater fails with "desktop update: task inspection timed out" due to live renderer connection deadlock in installDesktopUpdateTaskControl #10003 / [Bug] 桌面版更新被永久拒绝：Host 已确认 shutdown-complete，却因 10 秒内未退出被 SIGTERM（0.2.0-rc.2 → 0.2.1-rc.2） #10204：beforeRestart() / update-tasks / teardown 相关的失败；本例不涉及——日志与进程时间线显示应用正常退出、安装器确实被 spawn。