# 桌宠

**Repository Path**: dys168/desk-pet

## Basic Information

- **Project Name**: 桌宠
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-27
- **Last Updated**: 2026-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 袋鼠桌宠 - 源码工程

黄色卡通袋鼠 Windows 桌面宠物，基于 Electron 构建。

## 快速开始（Windows）

### 环境要求
- Windows 10/11 64位
- Node.js 16+（推荐 18/20 LTS）
- 约 500MB 磁盘空间

### 一键构建

双击运行 `build.bat`，脚本会自动：
1. 检测 Node.js 环境
2. 安装依赖（使用国内镜像加速）
3. 构建便携版 exe

构建完成后，产物位于 `release\袋鼠桌宠.exe`，双击即可运行。

### 手动构建

```bash
# 安装依赖
npm install

# 构建便携版 exe（单文件，双击运行）
npm run build:win

# 或构建安装版（NSIS 安装包）
npm run build:win:nsis

# 开发模式运行（调试用）
npm start
```

## 功能说明

| 功能 | 操作 |
|------|------|
| 拖动位置 | 鼠标左键按住袋鼠拖动 |
| 切换动画 | 单击袋鼠（idle→jumping→waving→running-left→running-right 循环） |
| 缩放大小 | 鼠标滚轮 |
| 右键菜单 | 调整大小 / 置顶开关 / 退出 |
| 托盘菜单 | 显示隐藏 / 调整大小 / 退出 |
| 对话气泡 | 每次切换动画随机弹出 |

## 工程结构

```
kangaroo-pet/
├── main.js              # Electron 主进程（窗口、托盘、IPC、菜单）
├── preload.js           # 预加载脚本（安全暴露 API）
├── package.json         # 项目配置与构建脚本
├── build.bat            # Windows 一键构建脚本
├── process_assets.py    # 素材去白底处理脚本（可选）
├── renderer/
│   ├── index.html       # 渲染页面
│   ├── style.css        # 样式与动画
│   └── app.js           # 状态机、交互、气泡逻辑
└── assets/
    ├── icon.png         # 应用图标（256x256）
    ├── icon-32.png      # 托盘图标（32x32）
    └── pet/             # 去白底后的角色动作图（512x512 透明PNG）
        ├── idle.png
        ├── jumping.png
        ├── waving.png
        ├── running-left.png
        ├── running-right.png
        └── ...
```

## 自定义修改

### 修改对话气泡文案

编辑 `renderer/app.js` 中的 `BUBBLES` 数组，添加或修改中文文案。

### 修改动画状态顺序

编辑 `renderer/app.js` 中的 `STATES` 数组，调整顺序或增删状态。
新增状态需在 `assets/pet/` 中放入对应 PNG，并在 `style.css` 中添加 `.state-xxx` 动画类。

### 修改默认窗口大小

编辑 `main.js` 中的 `BASE_SIZE` 常量（默认 200px）。

### 更换角色素材

1. 将新角色的各动作 PNG 放入 `assets/pet/`（建议 512x512 透明背景）
2. 如有白底图，可运行 `python process_assets.py` 自动去白底
3. 更新 `renderer/app.js` 中 `STATES` 的图片路径
4. 重新构建

## 注意事项

- 构建产物为未签名 exe，首次运行 Windows SmartScreen 可能提示，选择「更多信息 → 仍要运行」即可。
- 便携版 exe 运行时会自解压到系统临时目录，关闭后自动清理。
- 如需开机自启，将 exe 快捷方式放入 `shell:startup` 目录。