Desktop Pet

一个可悬浮在桌面的 AI 宠物，支持账号登录、好友协作与 MCP。

安装

# 公网包（发布后）
npm install --global desktop-pet-app

# 或本地 tgz
npm install --global ./desktop-pet-app-0.1.1.tgz

国内网络若拉不到 Electron 二进制，加镜像：

ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm install --global ./desktop-pet-app-0.1.1.tgz

安装后直接启动：

desktop-pet

客户端默认连接 https://api.xinbit.top/desktop-pet（登录/注册门户仍由 https://deskpalai.com 提供），会自动推导 WebSocket、登录和更新接口。只有本地开发或私有部署时才需要设置 DESKTOP_PET_HOST（可含路径前缀）。应用内更新仅接受 HTTPS 地址。

打包发布时可通过环境变量覆盖官方地址（构建期内联，见 src/shared/service-addresses.ts）：DESKTOP_PET_SERVER_ROOT（服务根）、DESKTOP_PET_PORTAL_ORIGIN（门户）、DESKTOP_PET_LEGACY_HOSTS（需无缝迁移的旧服务器 hostname，逗号分隔）。

首次启动后，在宠物右键菜单中选择“登录账号”或“注册账号”。

更新

通过 npm 安装的 macOS 版本可以直接使用应用内更新，首次更新会安装并切换到 /Applications/Desktop Pet.app。也可以继续使用 npm 更新：

npm update --global desktop-pet-app

desktop-pet 会比较 npm 包与 /Applications/Desktop Pet.app 的版本并启动较新者，同版本优先原生应用。两者共享 ~/Library/Application Support/Desktop Pet 中的用户数据；该目录不是程序安装目录。npm 不会绕过系统安装器直接写入 /Applications。

如果使用 macOS .pkg 或 Windows 安装包安装，桌宠会从服务器的更新接口发现、下载并安装新版本。

发布者命令

npm run typecheck
npm test
npm run pack:check
npm publish

macOS 原生安装包：

npm run package:mac

发布前请为正式包配置 Apple Developer 签名和公证凭据。