mille-okws/pestinha

选用指南

AI 根据 README 整理 · 2026/11/2 10:06:10

使用方式

通过命令行运行：先安装依赖（pip install -r requirements.txt），然后执行 python main.py；支持 --direto 参数跳过首次引导。可通过鼠标手势和右键菜单交互，Ctrl+Alt+Shift+B 可紧急关闭。

查看 README 依据

pip install -r requirements.txt ``` ```bash python main.py ``` Na primeira vez, um passo a passo explica o que ele vê e não vê, e depois abre a tela de permissões. Para pular a tela e usar as opções salvas: ```bash python main.py --direto ``` ### Como interagir | Gesto | Efeito | |---|---| | Clique rápido | Cutucada | | Passar o mouse de um lado para o outro em cima dele | Carinho | | Segurar e arrastar / soltar rápido | Leva junto / arremessa | | Rodinha do mouse | Gira |

| Botão direito | Menu: cutucar, carinho, bolinha, dormir, travessura, trabalhar, notebook, cantinho do castigo, painéis, configurações, esconder, fechar | ### Pânico `Ctrl + Alt + Shift + B` desliga tudo na hora, e ele continua desligado até você religar em Configurações. ### Modo teste Desligado por padrão. Ligado, os tempos ficam curtos (emoções, travessuras e protesto acontecem em segundos), os painéis de desenvolvimento ficam na tela (monitor neural e painel de protesto) e o terminal mostra as decisões. ## Privacidade

部署要求

需要 Windows 10/11、macOS 或 Linux (X11)，Python 3.11 或更高版本，约 70 MB 内存；Linux 下需安装 xdotool、wmctrl 和 xprintidle 才能识别窗口。

查看 README 依据

| **Sono e fogos** | Dorme quando a energia acaba. Muito feliz, solta fogos de artifício. | Tudo o que ele aprende (carinho, condicionamento, o que deu certo nas travessuras, fugas do castigo) fica salvo localmente e muda o jeito dele com o tempo. ## Requisitos - Windows 10 ou 11, macOS (Quartz/pyobjc) ou Linux com X11. - Python 3.11 ou mais novo. - No Linux, para as janelas e o tempo ocioso: `xdotool`, `wmctrl` e `xprintidle`. Sem eles, o pet continua andando, mas não enxerga as janelas. - Cerca de 70 MB de RAM com ele rodando. ## Instalação e uso ```bash

已知限制

macOS 和 Linux 未在真实机器上测试，Wayland 下无法识别窗口或快捷键，高分屏和多显示器支持有限，无边框窗口游戏可能不被识别为全屏，可执行文件未签名。

查看 README 依据

O código do Pestinha é software livre, sob a [GNU General Public License v3.0 ou posterior](LICENSE) (GPL-3.0-or-later). Você pode usar, estudar, modificar e redistribuir, mas toda versão distribuída, modificada ou não, precisa continuar aberta e sob a mesma licença. As imagens e os textos de `assets/` não estão cobertos por esta licença ## Limitações conhecidas - macOS e Linux ainda não foram testados numa máquina real: a parte de leitura das janelas e do teclado foi escrita e testada só nas partes de texto (ver `tests/test_plataforma.py`).

- No macOS, o pet precisa da permissão de Acessibilidade para o atalho Ctrl+Alt+Shift+B funcionar. - No Linux com Wayland, o pet não enxerga janelas nem o tempo ocioso, e o atalho global não funciona. - Pouco testado com escala de tela acima de 100% e com vários monitores. - Jogos em janela sem borda podem não ser detectados como tela cheia. - O executável não é assinado; o Windows pode avisar na primeira execução.