dsh-plugin-desktop 使用指南

把 DSH 装进 Electron 桌面应用，提供原生窗口、托盘、profile 切换、独立终端与更新检查，无需在浏览器里打开网页版。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add dsh-plugin-desktop

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

安装这个插件后就能直接双击打开桌面应用吗？

不一定。它需要 electron 才能启动；用 npm 全局安装会自动带上 electron，而在 profile 里安装时需要手动补装。缺少 electron 时命令只会打印安装提示。

桌面版和网页版看到的界面一样吗？

默认的兼容模式就是加载官方网页界面，只是套在带系统边框的原生窗口里。切到高级模式后，macOS 和 Windows 会换成毛玻璃/Mica 的原生外观。

怎么切换界面模式？

在托盘菜单里选择，或手工编辑 DSH home 的 settings.yaml 中的 dsh-desktop.mode 字段（compatibility 或 advanced）。切换必然会重启应用。

Linux 能用吗？

能用，但只支持兼容模式，高级模式会被直接拒绝；托盘里的"打开终端"命令在 Linux 上也不会出现，更新下载同样不提供。

切换 profile 会丢失聊天记录吗？

不会。官方 profile 默认共用同一个 DSH home 的会话、设置和存储，切换只是重启应用换一套插件组合，不复制也不迁移数据。

装完插件后新加的插件为什么没生效？

启动器不监听 profile 清单变化，增删插件后需要重启桌面应用；从托盘切换一次 profile 也会触发这次重启。

更新是自动安装的吗？

不是。打包版会在启动 60 秒后检查一次、之后每 6 小时再查，发现新版本时提示下载；macOS 需要你从 DMG 里手动替换应用，Windows 需要确认后运行安装器。

关掉窗口是不是就退出了？

不是。关闭窗口只是隐藏界面，后台仍在运行，可以从托盘重新打开；要真正退出需要在托盘里选择退出。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则