AllPet 是一款开源（MIT 许可证）的跨平台桌面宠物应用，目标是把多个 AI 编码工具的进度与完成通知汇聚到一个桌面视图中。它读取各平台已经保存在本地的会话日志，不需要账号、密码或额外 API 密钥。
【主要能力】
- 九平台监控：支持 Codex、Claude Code / Desktop、DeepSeek Harness（DSH）、Grok、Cursor、WorkBuddy、Qoder、pi 和 Z Code。Cursor、Qoder 提供可选的 observer 钩子以获取完整生命周期事件。
- 实时状态动画：宠物根据任务进度在 idle、running、waiting、done、failed 之间切换动画。
- 任务气泡：分三级（摘要 → 平台 → 会话），每个平台使用自己的品牌色。标题显示稳定的会话名称，副标题显示当前动作与进度。
- 安全的任务唤醒：经过验证的 Codex Desktop 会话使用深链交接；不支持的 CLI、Claude 和 Grok 目标在缺乏安全精确定位能力时 fail-closed，避免重复启动任务；DSH 任务链接携带精确的 session ID。
- 跨平台 CLI：status / watch 可在 macOS、Linux、Windows 上构建运行；依赖 AppKit 的完整自测目前仅在 macOS 上运行。
- 跨平台桌面外壳：Electron 外壳（desktop/）在 Windows、Linux、macOS 上显示宠物和图形化宠物管理器；本地多格式转换目前仅 macOS 可用，标准宠物包的安装、切换、删除在跨平台上均可用。
- 宠物自定义：支持从 GitHub 安装标准包，macOS 还可导入并规范化本地 Codex / OpenPets / cc-haha / clawd-on-desk / LingChat / 单图宠物。
- 宠物创作工具包：宠物生成标准包/ 提供从零制作宠物的引导套件，包含角色设计指南、各状态文生图提示模板，以及将标准 8×11 精灵表组装、校验、打包为可导入的 pet.json + spritesheet.webp 的 Python 脚本。
【使用方式】 安装：在已安装 Node.js 24.18+（含 npm 11.16+/npx）和 Git 的情况下，可在 macOS、Windows PowerShell/CMD 或 Linux 上运行同一条命令。该命令会检测操作系统与 CPU、下载最新稳定版 GitHub Release、校验 SHA-256 并安装；再次运行即可更新。添加 --dry-run 可仅预览版本和目标位置而不安装。也可直接从 GitHub Releases 下载安装包：macOS 使用 AllPet-<version>-arm64.dmg，Windows 使用 AllPet-Setup-<version>.exe，Linux 使用 AllPet-<version>.AppImage 或 allpet-desktop_<version>_amd64.deb。安装包已内置 Swift 核心、运行时和 5 只内置宠物，无需安装 Node.js 或 Swift。
更换宠物：方式一，点击 macOS 菜单栏的 🐾，每个已安装宠物显示缩略图，点击即时切换；方式二，选择 🐾 → Pet → Install pet from GitHub… 输入预设名称或兼容仓库 URL，也可使用各条 CLI 命令列出、安装与切换；方式三，选择 🐾 → Pet → Import local pet… 或运行导入命令。GitHub 资源只会克隆到本地 ~/.config/all-pet/pet-sources/，不会打包进 AllPet 仓库。
气泡交互：点击折叠摘要可查看平台；选择九平台之一后，多任务打开会话列表，单任务直接尝试导航。点击已完成/失败任务会立即确认并持久化该决定，然后尝试导航；运行/思考/等待中的任务保持可见。× 按钮关闭通知。未确认的终端任务 24 小时后过期，新任务活动可再次出现。
返回任务：Codex Desktop 使用任务深链，但接受链接并不证明目标页面可见；Claude Desktop 激活现有应用，需要时在侧边栏选择任务；DSH 尝试原始会话；终端目标在支持时复用现有标签页；macOS 原生 CLI 恢复需要确认。Cursor、WorkBuddy、Qoder 和 Z Code 目前打开应用以供手动选择会话；pi 从不自动启动重复任务。关闭气泡只表示通知已确认，不代表导航成功。
状态来源：AllPet 读取各平台本地已存储的会话日志；日志中的明确任务事件优先，无明确事件时回退到最近写入时间推断 running / waiting / idle。扫描、缓存与 zstd 解压均在后台运行，避免宠物动画卡顿。
配置文件：~/.config/all-pet/config.json（参见 config.example.json），包含 scale（宠物大小）、anchor（bottom-right、bottom-left、top-right、top-left）、bundlePath（当前宠物目录）、hiddenBubblePlatforms（顶层隐藏提供方键列表，如 ["grok", "pi"]）。
从源码构建：原生 GUI 需要 macOS 14+ 与 Xcode Command Line Tools；status / watch / help / pet list CLI 可在 Linux（Swift 5.10+）和 Windows 上构建运行。首次启动自动构建，之后直接运行 ./allpet。
【平台差异与限制】
- 平台成熟度：macOS 适配与测试覆盖最好，包含原生 AppKit GUI 和更丰富的任务聚焦行为；Windows 和 Linux 安装包受支持，但使用 Electron 外壳，操作系统/桌面环境差异更多。
- 透明窗口：Windows / macOS 原生支持；Linux 需要桌面合成器（Wayland 或带合成器的 X11），无合成器时宠物背景显示为黑色。
- 托盘图标：Windows / macOS 原生支持；Linux GNOME 默认无系统托盘，需安装 AppIndicator 扩展（KDE / XFCE 等自带）。
- 全空间置顶：仅 macOS / Linux 支持所有工作区可见，Windows 无此概念（自动跳过）。
- 本地导入：AppKit/ImageIO 多格式转换目前仅 macOS 可用，Windows/Linux 入口明确禁用，但仍可安装标准宠物包。
- 原生 GUI：仅 macOS 提供 AppKit GUI，Windows/Linux 使用 Electron 壳 + Swift core sidecar；原生托盘自定义视图、Spaces 和精确终端会话聚焦按平台降级。
- 尚未打包：Intel Mac（x86_64）、Windows on ARM、Linux ARM（aarch64）目前没有现成安装包，需从源码构建或贡献打包。
- 无需后台自动更新器，需重新运行一键安装命令检查更新，或从 GitHub Releases 下载新版本；Linux DEB 用户应继续使用其包安装渠道。
- macOS 安装包为 ad-hoc 签名，无 Developer ID 签名或 Apple 公证，Gatekeeper 可能阻止首次启动，需按 macOS 隐私与安全提示操作。
【制作自己的宠物】 宠物生成标准包/ 是从零创建宠物的自包含套件（目前文档为中文），流程为：设计角色 → 用文生图提示模板生成 9 种状态 + 16 个朝向 → 用 Python 脚本（需 Python 3.9+ 与 Pillow）组装、校验并打包标准 1536×2288（8×11）精灵表，最终得到可用 ./allpet pet import 导入的 pet.json + spritesheet.webp 文件夹。
