项目介绍

Pestinha 是一只住在屏幕上的桌面宠物，目前有两个角色：Bryan 是一双眼睛，会掉落、弹跳、落在窗口标题栏上、追网球，也会在你写代码时抱着笔记本一起「工作」；Jorge 是对理财和 AI「导师」文化的讽刺角色，会朝你扔辅导传单。每个角色由一个 pets/<pet>.json 身份文件加一个存放台词、海报和梗图的文件夹构成，两者共用同一套神经网络，但记忆各自独立。

宠物感受和行动由 470 个神经元的脉冲神经网络（漏积分放电）驱动，输入来自电脑上发生的事以及你与它的互动。部分行为是手写规则而非学习得到，决策说明解释了哪些是学到的、哪些是规则。它学到的内容（抚摸、条件反射、哪些恶作剧奏效、从惩罚角逃跑等）保存在本地，并会随时间改变它的表现。

快速使用

运行要求：Windows 10/11、macOS（Quartz/pyobjc）或带 X11 的 Linux，Python 3.11 或更新版本。Linux 上需要安装 xdotool、wmctrl 和 xprintidle，宠物才能看到窗口和空闲时间；运行时约占 70 MB 内存。

pip install -r requirements.txt
python main.py

首次启动会有引导说明它能看见和看不见什么，随后打开权限设置页。想跳过该页面、直接使用已保存的选项：

python main.py --direto

互动方式包括：快速单击（戳一下）、在它身上来回移动鼠标（抚摸）、按住拖动或快速松开（带着走或扔出去）、滚轮（旋转），以及右键菜单里的抚摸、球、睡觉、恶作剧、工作、笔记本、惩罚角、面板、设置、隐藏和关闭。Ctrl + Alt + Shift + B 会立即关闭一切，直到你在设置里重新打开。

数据与权限

宠物完全在本机运行，不向互联网发送任何内容。它读取前台程序的名称、距离上次键鼠输入的时间、光标位置和窗口几何信息，但从不读取窗口内容或标题。记录的数据保存在 memory/，可在设置界面删除；细节见隐私说明。

自定义

Bryan 的梗图、留言和海报可在 pets/bryan/ 中编辑，宠物运行期间也可修改；共享的球、笔记本和个人照片放在 assets/comum/。个性由 pets/<pet>.json 初始化，行为数值在 pestinha/ajustes.py，启动时会校验。各宠物的代码路径和文件布局见包说明，架构与网络细节在 docs。

已知限制

macOS 和 Linux 上读取窗口和键盘的代码只在文本层面测试过，尚未在真机上验证。macOS 上全局快捷键需要「辅助功能」权限。Wayland 下宠物无法看到窗口和空闲时间，全局快捷键也不可用。屏幕缩放高于 100% 和多显示器场景测试较少，无边框窗口游戏可能无法被识别为全屏，预编译可执行文件未签名，Windows 首次运行时可能弹出警告。

许可证

代码采用 GPL-3.0-or-later：可自由使用、研究、修改和再分发，但分发版本必须继续开源并保持同一许可证。assets/ 下的图片和文本不在该许可证覆盖范围内。

HotRepo 点评

该项目在 2026-11-03 的 HotRepo 新项目榜上有记录，统计窗口内新增 26 颗星，累计 138 星、40 个 fork。站内没有全部语言日榜名次，也没有 Hacker News 讨论，因此可用的信号是短期的新项目快照，而不是长期走势。技术上比较突出的是几个部分的组合：明确的 470 神经元脉冲网络、手写规则层、每个宠物独立记忆，以及一组桌面环境集成；项目自述仍在开发中，其限制清单也明确标注 macOS 和 Linux 的窗口读取路径尚未在真机上测试。