openpets

环境要求

• macOS / Windows / Linux 桌面系统（Windows 发布安装包已签名，macOS 可能未签名）
• 需要 Node.js 环境，用于运行 npx 形式的 CLI 与 MCP 服务
• 可选：支持 MCP 的编码智能体（如 Claude Code、Cursor）
• 可选：pnpm，仅在从源码构建打包桌面端时需要

安装与启动步骤

1. 1下载对应安装包

   打开 GitHub Releases 页面，按系统选择安装包：macOS 选 dmg（Apple Silicon 用 arm64、Intel 用 x64），Windows 用 setup.exe，Linux 用 AppImage。

2. 2安装并启动应用

   按各系统常规方式安装后启动 OpenPets。安装包通过官方 Releases 分发，无需连接任何 AI 智能体即可开箱使用。

3. 3macOS 解除隔离

   若 macOS 因未签名阻止运行，在终端执行命令移除隔离标记后重新打开应用；Windows 安装包已签名一般无此问题。

   xattr -dr com.apple.quarantine /Applications/OpenPets.app

   复制

4. 4诊断本地集成

   检查 Claude hook、项目 Cursor MCP 集成是否已安装、需更新或已损坏，以及桌面应用是否可达。仅当集成损坏时返回非零退出码。

   npx @open-pets/cli doctor

   复制

5. 5配置 MCP 服务

   把 OpenPets 作为 MCP 工具接入智能体：在智能体配置文件中加入 mcpServers 配置块，通过 npx 拉起 @open-pets/mcp。

   {
     "mcpServers": {
       "openpets": {
         "type": "stdio",
         "command": "npx",
         "args": ["-y", "@open-pets/mcp@latest"]
       }
     }
   }

   复制

6. 6源码构建打包

   如需自行构建安装包，在已安装依赖的项目目录执行打包命令，生成最终的安装器与分发包。

   pnpm package:desktop

   复制

关键配置

如何确认成功

运行 npx @open-pets/cli doctor 退出码为 0，且能确认桌面应用可达、宠物已出现在桌面。

常见问题

注意事项

• README 明确说明：使用桌面端不要求开发者身份，也不要求连接任何 AI 智能体。
• Windows 发布安装包已签名；macOS 构建可能仍未签名，需自行处理安全警告。
• npx 相关命令（doctor、MCP 服务）依赖本机已安装 Node.js。
• 项目本地优先设计，数据不出本机，但 README 未给出源码克隆地址，源码构建需自行获取仓库。