Mac / Linux 下载 Electron 后桌宠仍起不来怎么办
把错误平台的运行时与 ZIP 解压失败分开排查；网页正常时先使用仅网页模式。
你会看到什么
- macOS 的
~/.dsh/electron/里出现electron.exe和 DLL，下载完成却无法运行。 - Linux 下载完成后出现
tar: This does not look like a tar archive、failed to extract Electron zip，网页宠物仍正常。
为什么会这样
#28 在 macOS Apple Silicon、dsh-pet 0.2.2 中报告误下载 Windows 运行时。#29 在 Linux x64、0.2.3 中报告平台包已选对，但解压仍依赖不适合该 ZIP 的命令。#29 对 macOS 符号链接的讨论没有真机验证；不能据此断言你的 macOS 解压问题一定相同。
解决步骤
- 先停止反复下载。
在桌宠设置将显示位置改成「仅网页」，正常退出并重启 DSH。找不到设置入口时备份现有配置，按配置说明把目标宠物的
display改为"web"，保留其他字段。无头服务器直接看容器排查。 - 收集实际运行时信息。
从启动日志记下下载 ZIP 名称、平台架构、落盘目录和解压错误。Mac 出现 win32 包是有用线索；不要为了让检查通过把 electron.exe 改名为 electron。
- 需要桌面模式时核对已安装版本的官方说明。
#29 日志提及
DSH_PET_ELECTRON_PATH可指向已有 Electron，但正文没有适用于所有平台的完整安装方案。只有已有经验证的平台匹配运行时并明确可执行文件路径时再按该版本说明配置；不要复制 Windows 路径到 Linux，也不要反复清空缓存触发大文件重下。
怎么确认有效
仅网页模式下网页宠物能显示，日志不再持续尝试启动桌面助手或重复下载。若之后恢复桌面模式，应确认平台包正确、解压无错、助手实际启动且窗口可见。
如果还不行
保留网页模式，附日志向官方反馈。不要手动删除整个 ~/.dsh；它还包含其他 DSH 数据。网页也不显示时转显示排查，本文未确认具体修复版本。
来源与适用范围
原始报告：#28、#29。本文依据已保存的 issue 正文整理，并对照官方 INSTALL 与 CONFIG 文档；未核查后续评论、当前源码与发布记录；报告中的分析和版本仅用于定位，不能据此认定当前版本仍有同样问题或已有修复。
官方参考：安装说明、配置说明（2026-11-03 查阅的上游快照）。配置和运行时目录应以该实例实际使用的 DSH_HOME 为准，~/.dsh 只是默认路径示例。官方安装文档要求安装后重开 DSH；网页实例则重启 dsh web。
旧版切为仅网页后若留下不可点击的红色配置条，参考#130 红条恢复说明；不要因此认定 web 是非法值。