使用指南

PlayPets 是伙伴们与你聊天、也互相聊天的共同乐园。邀请内置角色，或导入兼容的社区宠物文件，再设定名字、性格和关系。不需要安装 Codex。

乐园随时段、天气和季节变化。伙伴会散步、吃零食、玩三种游戏，并带来种子和礼物。种花、钓鱼、捉虫来填满图鉴，慢慢变得亲近。迷你模式让乐园陪在工作旁边；桌面模式让伙伴出现在其他窗口上。聊天需要本地模型、已登录的 CLI 或其他 AI 连接。编码代理联动是可选功能。

需要什么

项目	说明
操作系统	macOS、Windows、Linux
AI	可选。不连接也能邀请、玩耍、使用桌面模式
编码代理	可选。可以和 Claude Code、Codex CLI、Gemini CLI、Cursor 以及使用 MCP 的工具联动
网络	下载、导入社区宠物、更新和使用远程 AI 时需要。院子里的活动和已下载到本机的 Ollama 模型可以离线使用

PlayPets 用 Tauri 制作，使用操作系统的 WebView，不在应用内捆绑完整浏览器。

两个词

• 宠物是角色文件。一个装着 pet.json 和精灵图的文件夹就是一只宠物。放在 Codex 宠物文件夹里的宠物会自动显示，也可以从社区网站导入，或者选择本机的一个文件夹。
• 伙伴是邀请到乐园里的个体。同一只宠物邀请多次就会有多位伙伴，每位都可以有不同的名字、性格、大小和 AI。

按这个顺序读

1. 安装 — 选择文件、跳过第一次运行时的警告、更新和数据文件夹
2. 邀请第一位伙伴 — 在邀请标签里创建伙伴，在乐园里摸摸它
3. 和伙伴聊天 — AI 连接的种类、设定性格、几位伙伴一起聊
4. 编码代理联动 — 让伙伴看到代理的工作状态
5. 桌面模式 — 把伙伴放到桌面上
6. 乐园和游戏 — 时段、天气和季节，花园和礼物，钓鱼和捉虫，图鉴，亲密度，活动，声音，三种游戏，小窗模式
7. 导入宠物 — 社区宠物和本机的宠物文件夹
8. 设置 — 语言、更新、退出、什么会保存、什么不会保存
9. 常见问题

第一次用的话，读完 1 到 3 就够了。其余的等需要时再翻开看。