企业官网建设流程全解析

• 桌面应用
• 插件系统
• AI Agent
• 人工智能
• MCP 服务
• dsh-plugin

OpenPets 是一款 Local-first（本地优先）的桌面伴侣平台，核心玩法就是OpenPets 宠物管理：你可以在 Pet Gallery（宠物图库）中挑选心仪的动画宠物，并自由定制它的动画、摆放位置和交互反应，同时还能通过插件 SDK 与 coding-agent 集成扩展能力。本指南带你从零开始，快速玩转 OpenPets 的宠物定制全流程。

一、OpenPets 是什么：为什么选择本地优先？

OpenPets 把"桌面宠物"这件事做成了一个平台，而不是单一的小工具。它的定位可以概括为三个关键词：

其中Local-first（本地优先）意味着宠物的数据、配置和状态都保存在你自己的设备上：无需依赖云端账号，断网也能正常玩耍，隐私和数据完全由你掌控。

📌 本项目仓库为迁移安装的兼容镜像，README.md 中说明了镜像定位，完整能力以 OpenPets 桌面端为准。

二、一键安装：获取 OpenPets 宠物管理平台

新手获取 OpenPets 宠物管理平台源码，最稳妥的方式是直接克隆仓库：

git clone https://gitcode.com/gh_mirrors/op/openpets

克隆完成后，你获得的就是 OpenPets 的项目工作区。首次进入建议先浏览仓库根目录的 README.md，了解当前镜像的版本与使用边界，再启动桌面端体验 Pet Gallery 与宠物管理功能。

三、Pet Gallery 新手教程：三步挑选你的第一只宠物

Pet Gallery（宠物图库）是 OpenPets 的"宠物商城"，所有可用的动画宠物都集中在这里。挑选宠物的思路很简单：

1. 看动画风格：先浏览每只宠物的待机动画，选出最合眼缘的风格——像素风、手绘风或拟物风各有拥趸。
2. 看行为丰富度：优秀的宠物不只会待机，还会走动、进食、打盹、与光标互动。动画帧越丰富，日常陪伴感越强。
3. 看集成能力：部分宠物支持 coding-agent 联动，能在你的编码会话中给出状态反馈，选这类宠物可以一次满足"陪伴 + 提效"两个需求。

💡 新手建议：先选一只行为状态多的宠物上手，方便后续体验位置与反应定制；确定风格后再替换成更中意的角色。

四、快速定制动画、位置与反应：宠物管理的核心配置

选好宠物后，真正的乐趣才开始。OpenPets 的宠物管理围绕三个维度展开，这也是新手最常问的问题："如何定制桌面宠物的动画和位置？"

1. 定制动画：让宠物动起来更有个性

• 动画切换：为宠物指定不同的动画序列（待机、走动、进食、睡觉、受惊等）。
• 节奏调整：控制动画播放的快慢，让宠物的"性格"更贴合你的审美——快节奏显活泼，慢节奏显慵懒。
• 触发条件：决定哪个动作在什么时机出现，例如"点击屏幕边缘时做出躲闪反应"。

2. 定制位置：宠物该住在桌面的哪里？

• 固定位 vs 自由游走：可以让宠物固定在屏幕角落当摆件，也可以放开让它沿屏幕边界游走。
• 边界与层级：设置活动范围，避免宠物挡住关键窗口；调整层级让它始终置顶或跟随当前窗口。
• 多屏适配：多显示器用户可以为宠物指定"主活动屏"，避免它跑到副屏失联。

3. 定制反应：让宠物"听得懂"你

反应（Reactions）是宠物与你的互动开关：

这套"动画 + 位置 + 反应"的组合，就是你日常做OpenPets 宠物管理的主要工作台——全部配置本地保存，改坏了随时可以回滚重调。

五、进阶玩法：插件 SDK 与 coding-agent 集成

当内置宠物满足不了你时，OpenPets 的插件 SDK 就是答案：

• 自定义宠物：基于 SDK 编写插件，接入自己的动画资源与行为逻辑，打造独一无二的桌面伴侣。
• 接入 coding-agent：通过 coding-agent 集成，让宠物感知编码会话状态——编译通过时撒花、报错时挠头，把枯燥的等待变成可视化反馈。
• 扩展事件：监听系统或应用事件，触发宠物反应，让"桌面伴侣"真正成为你的数字工位成员。

🔧 想动手写插件？从 SDK 的最小示例插件起步：先跑通"一个事件 → 一个动画"的最小闭环，再逐步叠加状态机与自定义资源。

六、常见问题速查（FAQ）

Q1：OpenPets 宠物管理数据存在哪里？A：遵循 Local-first 原则，配置与宠物数据都保存在本地设备上，不依赖云端。

Q2：Pet Gallery 里怎么选宠物最稳妥？A：优先选择动画状态丰富、支持 coding-agent 联动的宠物，便于体验完整的定制功能。

Q3：定制了位置后宠物"消失"了怎么办？A：检查活动边界设置与多屏主屏配置，把宠物拉回主显示器可见区域即可。

Q4：这个仓库是完整源码吗？A：当前仓库是迁移安装的兼容镜像，说明见 README.md；完整功能以 OpenPets 桌面端发布为准。

七、写在最后

OpenPets 用"本地优先 + 动画宠物 + 插件 SDK + coding-agent 集成"的组合，把桌面宠物从桌面挂件升级成了可扩展的桌面伴侣平台。跟着本指南走完Pet Gallery 选宠 → 动画/位置/反应三件套定制 → 插件与智能体集成三步，你就能拥有一只真正"懂你工作节奏"的专属宠物。快去挑选你的第一只 OpenPets 宠物吧！🐾

• 桌面应用
• 插件系统
• AI Agent
• 人工智能
• MCP 服务
• dsh-plugin