DeepSeek Harness 桌面端更新失败怎么办？DSH plugin 恢复操作、事务锁与重置代价

DeepSeek Harness 桌面端更新失败不会自动回滚：更新与插件包操作在停止 Host 后直接修改当前 profile，失败时保留已修改的文件并报告错误，未完成的操作留下标记供下次启动重试（来源）。

「更新失败」在桌面端有两类：一类是应用自身的更新失败，另一类是更新应用时顺带触发的插件包操作失败。本篇讲这两类失败在桌面端的恢复语义——为什么不回滚、加载页和错误页给什么、重置 Desktop 的代价到底多大。如果你用的是命令行安装方式，失败处理完全不同，见《DSH 更新失败怎么解决》。

DeepSeek Harness 桌面端更新失败为什么不回滚

桌面端不创建 staging 目录、激活日志或回滚副本，它选择「直接改 + 可重试」而不是「改不动就退回」，所以失败的代价是保留现场并等待下一次启动收敛（来源）。

理解这套语义要看五个动作：

1. 停止 Host 后直接改当前 profile — 插件变更不复制到临时目录，而是在当前 profile 上就地执行。预期：改动的就是最终生效的位置，没有「激活」这一步。
2. 失败保留已修改文件并报告错误 — 操作中断时不清理、不还原，错误信息指向失败的那一步。预期：你能看到到底卡在装依赖、链接还是构建。
3. 未完成操作留标记，下次启动重试 — App 启动时会对 profile 运行事务恢复。预期：重新打开应用后，桌面端自动尝试完成或收敛上次的操作，不需要你手动删文件。
4. 没有 staging 目录可回退 — 桌面端不建 staging 目录、不写激活日志、不留回滚副本。预期：界面上找不到「回滚到上一版」的按钮，也别自己手工拼一个来用。
5. 事务锁把并发挡在外面 — 包事务独占持有 $DSH_HOME/profiles/desktop/lock 直到 pnpm 进程退出。预期：另一个进程想改同一个 profile 只能等待，而不是两边同时写坏。

这套「不回滚」与命令行安装方式恰好相反：CLI 侧失败通常靠锁版本或重装收敛，见《DSH 更新失败怎么解决》。桌面端的选择是保留现场，让下一次启动自己收敛。

DeepSeek Harness 桌面端加载页和错误页提供哪些恢复操作

加载页不依赖 Host，所以 Host 起不来它也能显示，并给出重启与重装指导；错误页则给出可用的恢复操作，只有已打包应用的资源支持恢复时，才会提供「禁用插件」和「重置 Desktop」（来源）。

按代价从小到大走这五步：

1. 先重启应用 — 关掉再打开，让启动时的事务恢复有机会处理未完成操作。预期：多数可自愈的失败在这一步就恢复。
2. 读错误页的恢复指引 — 错误页会列出当前可用的恢复动作，照着做。预期：知道下一步该禁用插件还是该重装。
3. 禁用插件自查 — 如果有「禁用插件」，先用它把插件停下再启动，判断是不是某个 DSH plugin 把启动搞挂。预期：能启动 = 问题指向插件；仍失败 = 问题在更底层。
4. 做一次只读体检 — 在终端 ls -l "$DSH_HOME/profiles/desktop" 看目录结构、cat "$DSH_HOME/profiles/desktop/package.json" 看依赖清单是否完整。预期：能分清是依赖缺失还是共享链接失效，再决定下一步动作。
5. 重装应用 — 按加载页的重装指导重新安装桌面端。预期：安装到同一位置后继续使用原有 profile 数据，而不是从零开始。

重置 Desktop 会删掉什么：DeepSeek Harness 的代价与边界

重置 Desktop 会从 $DSH_HOME/profiles/desktop 删除除所持事务锁外的所有条目，且不保留备份；但共享的任务、设置与 $DSH_HOME/.env 保持不变（来源）。

重置前先看清代价：

1. 会被删的 — profiles/desktop 下的条目（含该 profile 内安装的插件），事务锁保留。预期：重置后该 profile 的插件需要重新安装。
2. 不会丢的 — 共享任务、设置与 $DSH_HOME/.env 不在删除范围内。预期：你的会话与凭据等共享数据仍在。
3. 没有备份 — 重置不保留副本，删掉即不可从这里找回。预期：动手前先确认插件是否都能重装。
4. 想留后路就自己先复制一份 — macOS / Linux 执行 cp -R "$DSH_HOME/profiles/desktop" "$DSH_HOME/profiles/desktop.bak"，Windows 用 robocopy "<源>" "<目标>" /E。预期：重置后再想查某些插件配置时，副本里还留着。
5. 重置是最后一步 — 因为不回滚、不备份，重置只应在重启、禁用插件、重装都无效后使用。预期：把它当最后的恢复手段，而不是首选。

DeepSeek Harness 桌面端更新失败的注意事项

1. 别在更新中途强杀应用 — 桌面端靠启动时事务恢复收敛未完成操作，反复强杀只会让恢复反复重来。
2. 区分两类失败 — 应用更新失败看加载页 / 错误页；插件包操作失败看错误信息指向的那一步。命令行安装方式的失败处理见《DSH 更新失败怎么解决》。
3. 更新前先停 CLI — 安装程序不与运行中的命令行协调，两端同时操作更容易卡住。
4. 重置前记录插件清单 — 因为重置不备份，先把要重装的 DSH plugin 列出来，重装时更省事。
5. 记住失败卡在哪一步 — 装依赖、链接宿主包、构建三个阶段对应不同处置，错误信息里的步骤词就是线索，恢复前先看清。
6. 恢复后核对插件版本 — 能重新打开不等于插件都回到原位，用已安装列表核对一遍版本，缺哪个补哪个。

如果你的失败其实是「DSH插件 没跟上新运行时」，与其一个个排查，不如用 DSH Plugin Hub：已安装列表里能直接看到哪些插件可更新，确认弹窗后才动手，恢复后重新装回来也快。

来源：DeepSeek Harness 桌面端 README（官方仓库）、Electron 桌面端打包与更新 Agent Note