Skip to content

fix(memory): MCP 宿主改用独立进程名,修复「重启并更新」装不上(NSIS 错误码 2) - #186

Merged
MUHUIX merged 2 commits into
MUHUIX:mainfrom
re-skylar:fix/mcp-host-distinct-name
Nov 19, 2026
Merged

MUHUIX merged 2 commits into
MUHUIX:mainfrom
re-skylar:fix/mcp-host-distinct-name

Conversation

@re-skylar

@re-skylar re-skylar commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

现象

更新中心点「立即重启安装」(或退出时自动安装)后弹窗:

Failed to uninstall old application files. Please try running the installer again.: 2

版本纹丝不动,且每次必现,只能手动关掉应用、手动跑卸载器再手动安装。

根因

不是更新链路的问题——crash.log 显示主进程退得很干净:

[10:00:18.091] before-quit pendingInstall=false
[10:00:18.492] quit exitCode=0                          ← 主进程正常退出
[10:00:19.189] updater-install quit 时刻拉起 pid=23632   ← 安装器随后退拉起
(之后无任何新 boot 记录 → 应用没有偷偷重启)

真正的阻塞者是记忆中枢的 MCP 桥:它被 DSH / Cursor / Claude 等客户端长期持有,而注入给它们的 command 就是应用主程序本身:

# ~/.dsh/profiles/desktop/cordis.patch.yml
- insert:
    - id: agenthub-memory-mcp
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        command: 'D:\AgentHub\AgentHub.exe'        # ← 主程序
        args: [ 'D:\AgentHub\resources\mcp\mcp-memory-server.cjs' ]
        env:
          ELECTRON_RUN_AS_NODE: '1'

electron-builder 的 NSIS 安装/卸载阶段按映像名(AgentHub.exe)判定「应用是否仍在运行」,不看路径、不看命令行。于是一个只在跑 mcp-memory-server.cjs 的子进程被当成主程序 → 卸载旧文件被拒 → 安装器拿到非 0 退出码 → 升级永远装不上。

实证:出问题时进程表里同时有 AgentHub-Setup-2.4.1.exe 和
D:\AgentHub\AgentHub.exe D:\AgentHub\resources\mcp\mcp-memory-server.cjs(~37MB,父进程是 DSH)。
把包括它在内的所有 AgentHub.exe 清零后,手动跑 Uninstall AgentHub.exe /currentuser /S → ExitCode=0,安装随即成功。

修法

给 MCP 宿主一个独立名字 agenthub-mcp.exe——内容仍是同一份 Electron(MCP 桥走 ELECTRON_RUN_AS_NODE,只借它的 Node 运行时),但进程名不再与主程序撞车。

文件 改动
memory/verify.cjs 新增 resolveMcpHostExe():在主程序同目录建 agenthub-mcp.exe。优先硬链接(同卷、毫秒级、零字节拷贝);跨卷/非 NTFS/目录不可写时退回复制;都失败则保持旧行为不阻断接入。以 inode+size 判新鲜度——应用升级换过主程序后自动重建;旧宿主仍被占用时(指向运行中映像的链接删不掉,EPERM)继续用旧链接,不制造新文件名。connectionCommand() 改用该宿主
memory/inject.cjs 新增 cordisManagedCommand():只读我们自己的受控块,取出当前 command
memory/access.cjs 新增 convergeHost():把旧版写入的「宿主=主程序」收敛成独立命名;仅当块内 command 仍是 AgentHub.exe 时才重写,用户手改过的命令不碰
memory/index.cjs 记忆服务启动时收敛一次(失败只 warn,不阻塞启动)

验证(本机真实安装目录,非 mock)

[1] connectionCommand  → D:\AgentHub\agenthub-mcp.exe
    ✅ 不再是主程序  ✅ 与主程序同 inode(硬链接、零空间)  ✅ hostExists  ✅ 幂等
[2] 模拟主程序升级(换文件)
    ✅ 链接自动重建  ✅ size/inode 跟随新主程序  ✅ 文件名保持稳定(不堆积)
[3] cordisManagedCommand
    ✅ 未注入返回 null   ✅ 注入后读回旧命令 = 主程序 exe
[4] 收敛
    ✅ 判定待收敛  ✅ 重写成功  ✅ 重写后 command = 独立宿主  ✅ 受控块仍只有一份
[5] 边界
    ✅ 非 exe 路径原样返回  ✅ 不存在的路径原样返回

全部通过(19 项)

其它校验:

  • tools/memory-qoder-inject-selftest.cjs、tools/memory-runtime-path-selftest.cjs(24 通过)、tools/memory-manifest-worker-selftest.cjs(7 通过)全通过
  • tools/verify/m-run-all.cjs 的 2 项失败为既有问题:git stash 后在干净 main 上同样失败(basic 档 21 项、SyncView WebDAV 入口),与本次改动无关

升级后

旧配置里的 AgentHub.exe 会在下次启动时自动收敛为 agenthub-mcp.exe;若不想等,在记忆中枢页点一次「修复 / 重新接入」。

注:这项修复只能让下一个版本的升级不再撞车;已经被挡住的这次升级仍需手动跑一次卸载器(或杀掉那个 MCP 子进程)才能装上本版。


追加:兼容「受控注释之前」的旧版插入块

# agenthub-memory:begin/end 是后来才引入的。更早的版本写进 cordis.patch.yml 的块没有标记,形如:

- insert:
    - id: agenthub-memory-mcp
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        command: 'D:\AgentHub\AgentHub.exe'

只认受控注释的话,这类存量块完全看不见,升级依旧被挡住——我本机实测就是这个形态(grep -c "agenthub-memory:begin" = 0)。

补上的处理(commit 60b6545):

  • inject.cjs:legacyCordisCommand() / rewriteLegacyCordisCommand()。以 - id: agenthub-memory-mcp 定位旧块,只在其后有限窗口内替换 command: 一行;块内其它字段(args/env/cwd)与用户 patch 的其余条目原样保留;写前备份。
  • access.cjs:convergeHost() 在受控块缺失时改走旧块路径,同样只收敛 command 仍是 AgentHub.exe 的形态。

自测从 19 项增至 24 项,全通过,新增 5 项覆盖:识别旧块 → 改写 → command 变为独立宿主 → 其它条目与 args 未被破坏 → 不会凭空生成受控注释块。

本机落地结果(真机)

  • D:\AgentHub\agenthub-mcp.exe 已生成,与主程序同 inode(links=2,零空间占用)
  • ~/.dsh/profiles/desktop/cordis.patch.yml 的 command 已由 D:\AgentHub\AgentHub.exe 收敛为 D:\AgentHub\agenthub-mcp.exe(自动备份 cordis.patch.yml.bak.1795013720060),其余 41 个 patch 条目与块内 args/env/cwd 未变
  • DSH 重启 MCP 后,当前记忆中枢进程已是 agenthub-mcp.exe(pid 19772),系统内不再有任何 AgentHub.exe 常驻进程
  • 以该宿主跑 mcp-memory-server.cjs 实测存活正常(ELECTRON_RUN_AS_NODE=1,3 秒无退出、stderr 为空)

现象:点更新中心的「立即重启安装」/ 退出时自动安装后,弹出
「Failed to uninstall old application files. Please try running the installer again.: 2」,
版本停在旧版不动,且每次必现。

根因不在更新链路本身——crash.log 显示主进程退得很干净:
  before-quit pendingInstall=false → quit exitCode=0 → updater-install quit 时刻拉起安装器
之后没有任何新的 boot 记录,说明应用没有偷偷重启、安装器也确实被拉起了。

真正的阻塞者是记忆中枢的 MCP 桥:它被 DSH / Cursor / Claude 等客户端长期持有,
而注入进这些客户端配置的 command 就是**应用主程序本身**(AgentHub.exe)。
electron-builder 的 NSIS 安装/卸载阶段按**映像名**判定「应用是否仍在运行」,不看路径也不看
命令行——于是一个只管跑 mcp-memory-server.cjs 的子进程被当成主程序,卸载旧文件被拒,
安装器拿到非 0 退出码,升级永远装不上。

修法:给 MCP 宿主一个独立名字 agenthub-mcp.exe,内容仍是同一份 Electron(MCP 桥走
ELECTRON_RUN_AS_NODE,只借它的 Node 运行时),进程名不再与主程序撞车。

- verify.cjs:新增 resolveMcpHostExe(),在主程序同目录建 agenthub-mcp.exe。
  优先硬链接(同卷、毫秒级、零字节拷贝);跨卷/非 NTFS/目录不可写时退回复制;
  都失败则保持旧行为不阻断接入。以 inode+size 判新鲜度:应用升级换过主程序后自动重建;
  旧宿主仍被占用(指向运行中映像的链接删不掉,EPERM)时继续用旧链接,不制造新文件名。
  connectionCommand() 改用该宿主。
- inject.cjs:新增 cordisManagedCommand(),只读我们自己的受控块,取出当前 command。
- access.cjs:新增 convergeHost(),把旧版写入的「宿主=主程序」收敛成独立命名;
  仅当块内 command 仍是 AgentHub.exe 时才重写,用户手改过的命令不碰。
- index.cjs:记忆服务启动时收敛一次(失败只 warn,不阻塞启动)。

验证(本机真实安装目录):
- connectionCommand 返回 agenthub-mcp.exe,与主程序同 inode(零空间占用)
- 模拟主程序升级(换文件):链接自动重建,inode/size 跟随新主程序,文件名保持稳定
- 注入 → 读回旧命令 → 收敛重写,受控块仍只有一份,其余 patch 内容不受影响
- 19 项自测全通过;tools/memory-*-selftest 全通过
- tools/verify/m-run-all.cjs:2 项失败为既有问题(在干净 main 上同样失败:basic 档 21 项、
  SyncView WebDAV 入口),与本次改动无关

升级完成后旧配置里的 AgentHub.exe 会在下次启动时自动收敛为 agenthub-mcp.exe;
若不想等,在记忆中枢页点一次「修复/重新接入」即可。
受控注释(# agenthub-memory:begin/end)是后来才引入的。此前版本写进
cordis.patch.yml 的块没有标记,形如:

  - insert:
      - id: agenthub-memory-mcp
        name: '@deepseek-ai/dsh-mcp-client'
        config:
          command: 'D:\AgentHub\AgentHub.exe'

这类存量块同样把 MCP 宿主指成主程序,收敛如果只认受控注释就完全看不到它,
升级依旧被 NSIS 的映像名判定挡住(实测本机就是这个形态)。

- inject.cjs:新增 legacyCordisCommand() / rewriteLegacyCordisCommand()。
  以 `- id: agenthub-memory-mcp` 定位旧块,只在其后有限窗口内改 command 一行;
  块内其它字段、用户 patch 的其余条目原样保留;写前备份。
- access.cjs:convergeHost() 在受控块缺失时改走旧块路径,同样只收敛
  「command 仍是 AgentHub.exe」的形态。

自测补充 5 项(共 24 项全通过):识别旧块 → 改写 → command 变为独立宿主 →
其它条目与 args 未被破坏 → 且不会凭空生成受控注释块。
@MUHUIX
MUHUIX merged commit 1cb53fc into MUHUIX:main Nov 19, 2026
1 check passed
@MUHUIX

MUHUIX commented Nov 19, 2026

Copy link
Copy Markdown
Owner

已合并,感谢!根因分析我们核对过了: updater.cjs 里早有真机取证写明 NSIS 按映像名判活,你这条因果链和它完全对得上,硬链接宿主零成本、失败路径全部回退旧行为,改动很干净。

三个小提醒(不追改,留作后续):

  1. 收敛只覆盖了 DSH 的 yml 块,Cursor/Claude 这类 json/toml 配置里指向旧 AgentHub.exe 的存量 MCP 进程还会撞同样的坑,下个版本可以补上;
  2. 复制回退路径用 inode+size 判新鲜,非 NTFS 装目录时复制件 inode 永远不等于主程序,会每次启动重拷一遍整个 Electron,建议加个「用过的就是它」的标记或退化成 size+mtime 判定;
  3. - id: agenthub-memory-mcp 这种无标记块我们查了全仓 git 历史,产品代码从来没写过这个形态([Bug] DSH 自动接入无效:把 MCP 配置写入 ~/.dsh/mcp.json,但 DSH 不读该文件 #170 之前写的是 JSON),应该是手动配置的存量——改写它超出了「只动我们自己的块」的边界,好在你写了备份,风险可控。

注:这次修复只能保证下一个版本的升级不再撞车;已经被挡住的用户仍需手动清一次同名进程。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants