Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

三三 · 33 — Desktop Pet

三三 33

三三(33) · 一位护食系傲娇桌面伙伴
奶白卫衣 · 琥珀圆眼 · 举勺警告 · 「不准偷喝冰可乐!!」

Python License Platform Sprite


她是谁

三三今年 21 岁,身高刚好够趴在你的窗口边。
碎发盖眉,左眼角有一颗淡褐色泪痣;生气时会鼓起腮帮子,把白瓷勺指向你。

喜欢 热食、红薯干、小馄饨、暖暖的房间
讨厌 冬天穿短袖、偷吃她东西的人
口头禅 「再敢偷喝冰可乐试试看?」
技能 举勺警告 / 护食结界 / 暖食攻击

三种表情循环播放——待机轻晃、炸毛举勺、吃到红薯干就笑开花。


快速开始

环境:Windows · Python 3.10+ · Pillow

# 安装依赖
pip install Pillow

# 启动桌宠(项目根目录)
python pet_33_desktop.py

# 或双击
start-33.bat

她会出现在屏幕右下角,无边框、置顶、背景透明。

操作

操作 效果
左键拖拽 把她拎到任意角落
单击 切换表情:待机 → 炸毛 → 开心
双击 立刻傻笑(开心)
右键 菜单:切换动作 / 换位置 / 退出

动画一览

spritesheet

动画 行 帧数 FPS 说明
idle 0 8 8 呼吸轻晃,偶尔眨眼,勺子端在胸前
angry 1 8 10 鼓腮怒视,勺子前指,头顶冒十字筋
happy 2 8 8 眯眼傻笑,抱着红薯干 / 小馄饨

帧规格:240 × 240 · 网格 8 列 × 3 行 · 透明背景 WebP


项目结构

san-san-33/
├── pet_33_desktop.py       # 桌宠主程序(tkinter + Pillow)
├── start-33.bat            # Windows 一键启动
├── pack/
│   └── san-san-33/         # Mate 风格资源包(可独立分发)
│       ├── manifest.json   # 动画元数据
│       └── spritesheet.webp
├── assets/                 # README 预览图
├── tools/
│   ├── clean_purple.py     # 去品红/紫边
│   └── smoke_pet.py        # 无界面自检
├── LICENSE                 # GPL-3.0
└── README.md

Manifest 约定

{
  "id": "san-san-33",
  "name": "33",
  "frameWidth": 240,
  "frameHeight": 240,
  "columns": 8,
  "totalFrames": 24,
  "animations": {
    "idle":  { "row": 0, "frames": 8, "fps": 8,  "loop": true },
    "angry": { "row": 1, "frames": 8, "fps": 10, "loop": true },
    "happy": { "row": 2, "frames": 8, "fps": 8,  "loop": true }
  }
}

透明色键使用 #ff00ff,运行时会做硬 alpha + 邻色扩边 + 去色溢,避免紫边。


自定义

  1. 换图:替换 pack/san-san-33/spritesheet.webp,保持 240×240 网格与透明通道。
  2. 改速度:编辑 manifest.json 里的 fps。
  3. 改大小:pet_33_desktop.py 中的 SCALE(默认 0.55)。
  4. 去紫边:对精灵表运行 python tools/clean_purple.py。

程序会优先读取项目内 pack/san-san-33/,找不到时回退到:

%APPDATA%\Xiaomi MiMo\pets\san-san-33\

设计笔记

  • 角色取自「护食娘」设定:暖奶油色系(#F5E6D3 / #3D2B1F / #C48A3A)。
  • 精灵表经品红底生成 → 色键抠像 → 去紫边,边缘使用邻色填充,杜绝透明色键混色。
  • 桌宠窗口 overrideredirect + -topmost + -transparentcolor,零依赖运行时(仅 Pillow)。

License

本项目以 GNU General Public License v3.0 发布。

三三 · 33 — Desktop Pet
Copyright (C) 2026  Bronsan

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

自由软件,欢迎 fork 与贡献——但请保持开源,把她的好运分给下一个人。


「吃饱饱,才有力气骂你。」 —— 三三

About

三三 · 33 — 护食系傲娇桌面伙伴 / A cozy tsundere desktop pet with sprite animations (GPL-3.0)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages