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

快速上手

openpets (DSH 集成)

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @open-pets/dsh

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

— 源: plugins.install

关键要点

• 桌面宠物：在桌面上闲逛、漫游、做出反应，并防止您的工作空间显得空荡荡的动画伴侣。
• 官方插件：专注计时器、提醒、情绪记录、小游戏、启动快捷方式、喝水提醒和虚拟宠物属性。
• Plugin SDK v3：用于构建全新宠物能力的沙箱化 JavaScript/TypeScript 运行时，支持权限、配额、存储、计划任务、命令、面板、事件、音频、通知等功能。
• 可选智能体层：Claude Code、OpenCode、Cursor、Pi 和 MCP 客户端可以驱动本地的宠物反应，而无需在对话气泡中暴露提示词、代码、路径、日志或密钥。
• macOS Apple Silicon：OpenPets-*-mac-arm64.dmg

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件会被安装到 DSH 的哪里？

通过 dsh plugin --profile web add 按 profile 安装；要给多个 profile 启用就对每个 profile 重复执行。

启用后我的代码或提示词会被发给宠物吗？

不会。插件只读取 DSH 事件信封里的状态分类（如 running/idle/error），并且只从预置短句池里挑一句气泡文本，绝不转发提示词、工具结果、路径、URL 或密钥。

它和 OpenPets 自带的远程 MCP 有什么关系？

插件完全本地化运行，500ms 超时内通过本机 IPC 与桌面应用通信，且忽略 OPENPETS_REMOTE_ENDPOINT/TOKEN 环境变量；远程 MCP 仍可单独配置。

不会安装 Node 22 也能用吗？

源码中未声明最低 Node 版本，但本包为 ESM 模块、由 TS 编译并依赖 @deepseek-ai/cordis v4，DSH 宿主环境自带版本要求。

如何卸载？

用对应的 DSH profile 移除该 bundle 即可，建议参考 dsh plugin remove 的官方卸载流程。

为什么代理刚报完错，宠物要过几秒才显示"完成"？

出于体验设计，错误反应后 5 秒内会抑制 success/idle 气泡，避免报错状态被立刻覆盖。源码注释里写明这一行为。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: 未声明
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则