设置
通过菜单 → 设置、⌘/Ctrl ,，或托盘里的**设置…**打开。设置面板浮在乐园上，点击外侧或按Esc关闭。共有四组：通用（语言和登录时启动）、乐园（季节、自动聊天和声音）、编码代理联动、关于 PlayPets（标志、版本、更新和项目链接）。编码代理联动另有说明。
标题和分组菜单保持固定，只有当前分组的正文滚动。选择另一个分组即可切换内容；再次打开设置时会记住上次查看的分组。退出应用位于关于 PlayPets中。
季节
打开设置 → 乐园 → 季节，选择自动、春、夏、秋或冬。自动跟随本地日历。选择会保存，并应用到普通与小窗模式的景色和伙伴服装。桌面伙伴也会同步，最长可能需要一分钟。春秋使用原有的日常叠穿服装。节庆仍按真实日期举行。
语言 0.1.0 起
可以在 한국어、English、日本語、简体中文 中选择。一开始跟随系统语言；更改后，乐园和桌面窗口都会用新语言重新载入。托盘菜单和窗口标题也会一起改变。所选语言保存在 state.json 的 language 里。
伙伴的自言自语和问候使用所选语言。AI默认也使用该语言，你可以在新消息中明确要求改用其他语言。更换语言会取消正在生成的回复，之前的对话会保留原文，不会自动翻译。应用与编程代理及终端使用英语交流。
启动时给出环境变量 PLAYPETS_LANG=ko|en|ja|zh-hans，它会优先于保存的语言。这是测试用的。
登录时启动 PlayPets 0.1.0 起
打开后，每次登录电脑时 PlayPets 都会一起启动。默认是关闭的。桌面模式开着时，登录时不会打开乐园窗口，只有伙伴们出现在桌面上，窗口在托盘里等着。这个选择由系统保存（macOS 的登录项、Windows 的启动项、Linux 的自动启动项），所以在哪一边关掉都算关掉。
偶尔让伙伴们自己聊聊 0.1.0 起
打开“乐园”里的这个开关后，每 20 分钟，接上 AI 的伙伴们会短短地聊几句。默认是关闭的。这些调用会消耗套餐额度或按提供商的政策计费；本地 Ollama 模型没有服务器推理费用。需要时再打开。窗口隐藏或有人正在回答时，那一轮会跳过。
乐园声音 0.1.0 起
乐园有自己的声音：微风、湖边的细浪、拂过树叶的阵风、白天的鸟鸣（早晨最多）、夏秋夜里的蟋蟀，下雨时还有雨声。伙伴们也会发出小小的声音：抚摸时一个轻柔的音、鱼咬钩时“扑通”一声、钓上来时水花四溅，收到礼物或亲密度升级时响起一段小旋律。声音会随时段、天气和季节变化。
- 默认以较小的音量打开，在你第一次点击窗口之后开始播放。
- 只在乐园可见时播放。窗口隐藏或最小化、或者只有桌面上的伙伴出来时，乐园是安静的。小窗模式下会继续播放。
- 要关掉或打开，可以用菜单里的喇叭、托盘里的乐园声音开关、这个开关、macOS 菜单栏的显示 → 乐园声音，或 ⌘/Ctrl Shift S。开关下面的音量滑块用来调节大小。
关于 PlayPets 0.1.0 起
设置标签的最后一组显示版本和应用更新，还可以打开本站和 GitHub 上的项目：网站、使用指南、版本记录、GitHub、反馈问题（新建 issue）和许可证（MIT），都会在浏览器中打开。
应用更新 0.1.0 起
这一行显示当前版本。点击检查更新，应用会读取 GitHub 发布页的 latest.json；已是最新时会提示“已是最新版本”。
有新版本时（无论是这次检查、应用启动 20 秒后的静默检查，还是从菜单发起的检查发现的）：
- 新版本按钮会一直显示在乐园底部操作栏的最左边、地点选择之前；菜单里的设置也会出现小圆点。
- 点按钮会打开更新窗口：查看新内容打开本站该版本的页面；稍后会把更新按钮收起，直到下次启动（那一行和小圆点会保留）。点击安装并重启后，窗口会依次显示下载进度、签名验证和安装状态，再重启应用。如果无法取得下载大小，进度条会在没有百分比的情况下继续运行。失败时可在同一窗口查看原因并重试。伙伴和设置都会保留。重启成功后，通知位置会短暂显示已安装的版本。
- “关于”里的那一行也有查看新内容，安装前会打开同一个更新窗口。
如果没能检查成功，请看看网络，并记住 Windows 便携版 zip 不在自动更新范围内。详细内容见安装。
完全退出应用 0.1.0 起
乐园窗口的关闭按钮只会隐藏窗口，应用仍留在托盘里。桌面上的伙伴和代理联动会继续运行。
要真正结束，请点击菜单 → 设置 → 关于 PlayPets里的完全退出应用。会弹出“要退出 PlayPets 吗？”的确认框。对话不会保存，桌面上的伙伴也会一起消失。托盘菜单里的退出也是一样的。
菜单与快捷键 0.1.0 起
- 托盘菜单（菜单栏或任务栏里的小猫）：打开乐园、有伙伴时的伙伴、邀请伙伴…、小窗模式、在桌面上显示、桌面模式开启时的在桌面上散步、乐园声音、设置…、检查更新…、关于 PlayPets和退出。没有伙伴时会省略显示开关，但邀请和声音仍可用。声音开启时显示勾选标记。有新版本时，更新项会改为更新到 v…。Windows 上左键打开乐园，右键打开菜单。代理等待你回应或遇到问题时会显示蓝点或红点，提示文字里显示伙伴名字。
- macOS 菜单栏：PlayPets → 关于 PlayPets、检查更新…、设置…、隐藏和退出 PlayPets；在输入框里剪切、拷贝、粘贴用的编辑；显示 → 伙伴、邀请伙伴…，以及用勾选标记开关的小窗模式和在桌面上显示（还没有伙伴时是灰的），以及用勾选标记开关的乐园声音；以及窗口。
- 快捷键（macOS 用 ⌘，Windows 和 Linux 用 Ctrl）：
| 按键 | 作用 |
|---|---|
| ⌘ 1 | 打开伙伴标签 |
| ⌘ 2 | 打开邀请标签 |
| ⌘ , | 打开设置 |
| ⌘ Shift M | 开关小窗模式 |
| ⌘ Shift D | 开关在桌面上显示 |
| ⌘ Shift S | 开关乐园声音 |
| ⌘ Q | 退出（macOS） |
数据文件夹 0.1.0 起
| 操作系统 | 位置 |
|---|---|
| macOS | ~/Library/Application Support/app.playpets/ |
| Windows | %APPDATA%\app.playpets\ |
| Linux | ~/.local/share/app.playpets/ |
| 文件 | 内容 |
|---|---|
state.json | 伙伴（名字、性格及其来源、关系、对我的称呼、大小、位置、所选的 AI 连接）、AI 连接列表（不含密钥）、语言、桌面模式和散步、各代理负责的伙伴、自动聊天、乐园声音和音量、小窗的位置和大小（miniRect）、花园和摆设（garden）、图鉴（album）、亲密度（bonds）、手动选择的宠物文件夹、文件格式编号（schema）。旧版本打开新版本写的文件时，会先留一份副本，只读取自己认识的部分 |
bridge.json | 代理联动用的端口和令牌。每次启动应用都会重新写入 |
pets/ | 通过地址导入的宠物文件夹 |
builtin/ | 三个内置宠物，每次启动检查并解压。每位伙伴都有独立的基础图像 |
环境变量
| 变量 | 作用 |
|---|---|
PLAYPETS_DATA | 把数据文件夹换到别的位置。终端命令（playpets say 等）也读同一个值 |
CODEX_HOME | Codex 的主文件夹。邀请标签里的 Codex 宠物文件夹会变成 $CODEX_HOME/pets |
PLAYPETS_LANG | 强制指定语言（ko、en、ja、zh-hans） |
PLAYPETS_PET | 终端命令的默认伙伴。和 --pet 选项相同 |
PLAYPETS_BRIDGE | 终端命令要读取的 bridge.json 路径。和 --bridge 选项相同 |
变量需要放在运行应用的环境里。可以从终端打开应用，或使用操作系统的环境变量设置。
会保存与不会保存的内容 0.1.0 起
会保存
- 伙伴的名字、性格、关系、对我的称呼、大小、在乐园里的位置
- 每位伙伴的亲密度
- 花园、乐园里的摆设和图鉴
- AI 连接的类型、服务器地址、模型名称
- 语言、桌面模式和散步、小窗模式以及小窗的位置和大小、所选的时段、天气和季节
- 导入的宠物文件及其来源
以另一种方式保存
- API 密钥不会写进
state.json。它只保存在这台电脑的安全存储里（macOS 钥匙串、Windows 凭据管理器、Linux Secret Service），删除连接时会一起删除。
不会保存
- 和伙伴的对话。只存在内存里，关闭应用就会消失。
- 编码代理最近活动的记忆。关闭应用就会消失。
- 游戏中的位置。游戏结束后会回到原来的地方。
卸载应用后若想清除所有痕迹，请把数据文件夹和安全存储里的 PlayPets 条目一起删除。