[BUG]: incapable of updating

快速结论：[BUG]: incapable of updating 这个报错通常发生在 AnythingLLM 桌面版安装目录或 AppData 数据目录被移动、创建符号链接（symlink）指向其他位置之后，更新器无法正常工作。优先排查安装目录是否被手动改动过。

适用环境：AnythingLLM 桌面版（Windows），通过 NSIS 安装器 + electron-updater 安装和更新。涉及目录：%APPDATA%\anythingllm-desktop、%LOCALAPPDATA%\anythingllm-desktop-updater、%LOCALAPPDATA%\Programs\AnythingLLM。

最快修复方案：暂无确认的一步修复方案。官方确认 NSIS 安装器和 electron-updater 不支持重定位或符号链接的 AppData 目录，属于不受支持的配置。

注意事项：官方给出的推荐做法是先卸载，再更改 Windows 默认应用安装位置，然后全新安装。此方案是“规避手段”而非修复；如果完全没有移动或符号链接目录仍出现更新失败，需要按官方要求提供 %LOCALAPPDATA%\anythingllm-desktop-updater 的日志。

问题场景

用户在 Windows 上使用 AnythingLLM 桌面版。为了释放 C 盘空间，将 %APPDATA%\anythingllm-desktop 和 %LOCALAPPDATA%\anythingllm-desktop-updater 等目录移动到其他磁盘，并在原位置创建符号链接。之后点击更新时，应用会错误地声称“已在运行”或更新失败，导致无法完成更新。

用户进一步测试发现：即使完全卸载（部分情况下用 Revo Uninstaller 清理），重新安装后直接更新也可能会失败；安装到非 C 盘同样复现。该问题持续数月甚至一年以上。

报错原文

[BUG]: incapable of updating
The installer simply fails.
It appears stuck once again.
This program is incapable of being updated.

原因分析

可能原因：NSIS 安装器和 electron-updater 不是为配合重定位或符号链接的 AppData 目录设计的。AnythingLLM 桌面版从 %APPDATA%\anythingllm-desktop 和 %LOCALAPPDATA%\Programs\AnythingLLM 读取/写入版本标记、引擎文件以及更新器状态，并期望这些是真实目录，而不是指向其他位置的符号链接。当检测到路径异常或无法按预期访问时，更新流程会卡住或报错。

注意：Issue 中也有用户反馈在移除符号链接后执行全新安装，更新仍然“卡住”或失败。这可能意味着除符号链接外还存在其他干扰因素（如旧版本残留、安装驱动器不同等），但官方在 Issue 中未给出针对该场景的额外修复方案，仅封闭为“不支持配置”。

环境排查

检查 %APPDATA%\anythingllm-desktop 和 %LOCALAPPDATA%\anythingllm-desktop-updater 是否被移动过或为符号链接（使用命令 dir 查看是否有 <SYMLINK> 属性）。
确认 %LOCALAPPDATA%\Programs\AnythingLLM 是否存在于真实磁盘位置且无链接指向。
确认 Windows 系统默认应用安装位置是否被改过（Settings → System → Storage → Change where new content is saved）。
确认安装 AnythingLLM 的磁盘分区格式（NTFS 等）以及是否启用了压缩或加密属性。
检查系统中是否有残留的 AnythingLLM 进程——用户已确认卸载后无任何实例在运行，但仍会失败，因此不要仅依赖“没有提示正在运行”来判断。

解决步骤

备份重要数据后，彻底卸载 AnythingLLM 桌面版。如果常规卸载不干净，可使用 Revo Uninstaller 等工具清理注册表和残留目录（Issue 用户验证过用 Revo 清理，但并不能修复问题）。
在卸载完成后，手动检查并删除以下目录（如果存在）：%APPDATA%\anythingllm-desktop、%LOCALAPPDATA%\anythingllm-desktop-updater、%LOCALAPPDATA%\Programs\AnythingLLM。
确保 %APPDATA% 和 %LOCALAPPDATA% 路径下的 AnythingLLM 相关目录是真实目录，不是符号链接或 junction。如果有链接，删除并移除链接，让应用重建真实目录。
如果目标是将应用安装到非 C 盘：先卸载，然后在 Windows 设置中更改“新内容保存位置”或默认应用安装路径，再进行全新安装（官方给出的可用规避方案）。
重新安装最新版 AnythingLLM 桌面版，安装完成后立即测试更新功能（Check for Updates）。
如果完全没有移动或符号链接但仍出现更新失败，请收集 %LOCALAPPDATA%\anythingllm-desktop-updater 目录下的日志，前往 GitHub 提交新 Issue，并附上日志（官方在 Issue 中明确要求提供这些日志）。

验证方法

安装完成后，打开 AnythingLLM 桌面版，手动触发“检查更新”（Check for Updates），确认不再出现“[BUG]: incapable of updating”或更新器卡死的情况；如果有新版本，确认可以正常下载并完成安装。也可以尝试执行一次“卸载 → 重装最新版”来验证是否为一次性问题。