dsh-desktop-pet 使用指南

DSH 鲸鱼娘宠物的 Linux/Windows 桌面伴侣，通过本地 HTTP 反向连接运行中的 DSH Web 服务，显示会话活动并支持喂食互动。

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

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

快速上手

— 源: plugin_wiki.wiki_content

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

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

— 源: plugins.install

— 源: plugin_wiki.readme_zh (fallback readme_raw)

执行安装命令后会立刻在桌面上看到宠物吗？

不会。这条命令只在 DSH CLI 的 bundle 列表里登记这个插件，真正可运行的桌面应用需要去仓库 GitHub Releases 下载 AppImage / deb / RPM / NSIS / portable 二进制并手动启动。

必须在 DSH 运行时才能使用吗？

是。桌面端通过本地 HTTP 连接到运行中的 DSH Web 服务（默认 http://127.0.0.1:3080），DSH 没启动时窗口会显示「请启动 DSH Web 服务」。

能连远程 DSH 吗？

可以通过 --dsh-url 启动参数或 DSH_URL 环境变量指定地址，但地址必须指向本机（127.0.0.1 / localhost / ::1），非 loopback 主机会被 shared.cjs 的 normalizeDshUrl 拒绝。

同时打开网页端宠物会冲突吗？

不会。桌面端每 15 秒发一次 presence 心跳，桌面端在线时网页端鲸鱼娘自动隐藏；桌面端退出或崩溃后 45 秒 TTL 过期，网页端自动恢复。

Wayland 下能拖动宠物或让它散步吗？

不能。Wayland 下窗口移动由合成器接管，程序化 set_position 不可用，桌面端会自动禁用拖拽和散步功能，仅 X11 / XWayland 下可用。

为什么 Alt+F4 / 关闭按钮关不掉窗口？

设计如此。Ctrl+W、Alt+F4、窗口管理器关闭请求一律被拦截，只能从系统托盘菜单「退出」或窗口内 × 按钮退出，避免误关。

macOS 能用吗？

源码里 macOS 分支存在但未启用。package.json 没有 macOS 构建配置，CI release.yml 也没有 macOS 任务，README 未声明提供 macOS 包。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

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

— 来源：通用规则