pixelpets

pixelpets 是一款适用于 Windows 10/11 的 Electron 桌面伴侣应用，并提供 macOS 12+ 的 beta 移植版本（代码已完成且经过临时签名，但根据 README 尚未在真实的 Apple 硬件上运行）。该应用明确不支持 Linux，因为其覆盖层和全局输入钩子仅限 Windows/macOS 使用。用户可以通过预构建的 Windows 安装程序安装，或使用 git、Node 20 或更高版本以及 `npm install` / `npm start` 从源码运行；此外，浏览器演示版运行相同的渲染器，无需安装。由于构建版本未签名，Windows SmartScreen 和 macOS Gatekeeper 在首次启动时会发出警告，且安装后会自动注册为登录启动（可通过 `npm run autostart:off` 禁用）。 功能特性 宠物生活在所有窗口之上的透明、可点击穿透的覆盖层中；只有宠物本身可被点击。它会对抚摸、拖拽、打字、滚动和光标互动做出反应，其响应由一个从“平静”到“亢奋 (zoomies)”的内部情绪模型控制。拖拽会使其拉伸，释放点将成为它在底线上的新家。右键点击可切换皮毛；轻点会产生开心眼、爱心并发出叫声；将光标停在头部或身体上会有不同的抚摸反应。在任何地方打字都会触发前爪揉捏（快速打字会导致其过热），而在带有绘画艺术的皮毛上滚动则会使其拍打叶子或爬毛线绳。托盘图标提供设置、休息启动、皮毛选择、活动区域、声音/狩猎/情绪开关以及退出选项。 视觉与音频 该应用内置 14 种猫皮毛和一种黑拉布拉多，所有颜色在绘制时均由单个角色编码的精灵图 (sprite) 重新着色。包括肢体在内的所有动画都组合在同一个精灵图中，因此每种皮毛和两种物种都能以各自的颜色呈现所有姿势，无需额外的图像文件。用户可以设计、导入和导出皮毛。应用中完全没有音频文件：喵喵声、吠叫、打呼噜、喘息以及即兴的 lo-fi 音乐循环均由 Web Audio 实时合成。 生产力功能 除了宠物行为，它还提供休息和番茄钟计时器、重复提醒、固定便签、IMAP 未读邮件提醒和日历提醒。Focus Guard 可从实时日历事件、静音时间或工作模式中读取“忙碌”状态，此时宠物会进入停泊状态并暂存消息，以免干扰屏幕共享；一旦您空闲，暂存的消息将以单行摘要形式呈现。设置持久化存储在用户应用数据文件夹的 `settings.json` 中，且支持项目更名前的安装迁移。计时器和提醒仅在应用运行时生效，并使用本地时钟。 AI 代理集成 pixelpets 可以对编程代理的工作状态做出反应：当代理思考时，它会用爪子托腮沉思；工作时，它会随着加载图标一起轻拍；出错时会惊跳；完成时则会跳跃并喵喵叫。任何工具都可以通过运行 `agent-hook.js` 并传递状态（如 thinking, editing, error, done 或 idle）来向其发送信号，宠物会监听一个小型状态文件。应用内置了针对 Claude Code, Codex CLI, Cursor, Antigravity 和 Kiro 的预设配置，且该助手具有钩子安全性：它会排空标准输入并回复 `{"continue": true}`，因此不会阻塞或改变代理的行为。 隐私 由于需要对打字和滚动做出反应，该应用会监听全局输入事件。README 指出，输入仅用于在本地机器上实时触发动画：按键绝不会被记录、存储或传输。没有遥测，没有自动更新，除非配置可选的邮件或日历提醒（这些提醒通过隔离的工作进程仅与您指定的服务器通信），否则完全没有网络连接。IMAP 应用密码使用 Electron `safeStorage` 在静态状态下加密存储，而非存储在 `settings.json` 中。 开发与文档 文档涵盖了功能、自定义皮毛、架构、开发指南、用于手绘和导入姿势的帧包、代理钩子以及一个小型 iPad 终端工具。`npm test` 可在无需 Electron 或 GPU 的情况下运行测试套件，`npm run lint` 与 CI 运行的检查一致，`npm run poses:cat` 为每种皮毛的所有活动生成接触表以进行视觉 QA，`npm run demo:all` 则重新生成 README 媒体文件。由于覆盖层是 GPU 合成的，普通截图无法捕捉，因此视觉审查依赖于这些接触表。 该项目采用 MIT 许可；艺术、代码和声音均被描述为原创，并引用了两个开源桌面宠物作为灵感，同时声明未使用任何第三方资产、精灵图、音频或品牌。项目欢迎贡献，并提供了贡献指南、私有安全报告策略、自定义皮毛和桌面设置讨论区，以及一份旨在吸引 Mac 用户参与的 beta 测试清单。