DSH 桌宠安装指南:Desktop、Web 与回滚

作者
DeepSeekAgent.io 编辑部
发布
更新

DSH 桌宠可能以 GitHub 插件源、Release ZIP、Profile 依赖或旧版 Web 注入脚本分发。安装方式看起来相似,实际加载位置和升级路径并不相同。

安装前先确认四件事

  1. 当前使用 Desktop 还是独立 Web Profile;
  2. DSH 的准确版本与插件 engines.dsh 范围;
  3. 插件是否在真实 Electron 宿主上测试过;
  4. Profile、养成数据和设置的备份位置。

Desktop 与 Web 的 origin 不同,localStorage 通常不互通。从 Web 迁到 Desktop 时,养成数据可能从零开始,这不代表安装失败。

优先使用插件管理器

支持当前插件契约的项目,应通过 DSH 插件管理器添加 GitHub 源或本地包。安装后完全退出 Desktop,再重新打开,确认设置页、侧边栏或右下角入口出现。

不要把旧版“修改宿主文件”的教程直接用于新版 Desktop。覆盖内置文件会让升级、卸载和完整性检查变得不可预测。

安装后的验收

  • 待机、工作、完成和失败状态能正确切换;
  • 关闭插件后事件监听和动画停止;
  • 重启后设置保留,Session 正常打开;
  • 无额外外网请求,或联网功能有独立开关;
  • 卸载后宿主页面和内置包恢复原状。

回滚方法

先在插件管理器停用,再卸载插件;不要直接删除整个 Profile。若冷启动出现 Preset 错误,应检查插件是否带入第二套 DSH Runtime,可参考Runtime Hoisting 故障分析。恢复备份时只还原对应插件和设置,避免覆盖新的 Session 数据。

参考资料

常见问题

安装后为什么看不到桌宠?

确认插件装入了正在使用的 Profile,并完全退出后重启宿主。热重载不一定能替换已经注入的页面脚本。

Web 版养成数据会自动迁到 Desktop 吗?

通常不会。不同 origin 的本地存储彼此隔离,需由插件提供导出与导入功能。

可以直接复制别人整个 Profile 吗?

风险较高。Profile 可能包含版本锁定、其他插件和本地配置,建议只安装明确需要的插件。