🐱 桌宠工坊 - 使用手册

把你的宠物照片变成 Windows 桌面宠物，双击就能用！

---

📋 你的桌宠能做什么

功能	怎么用	效果
拖动	鼠标左键按住拖动	把宠物拖到屏幕任意位置
聊天	左键单击宠物	宠物说话 + 弹跳动画
摸摸头	右键 → 🤚摸摸头	飘心形 + 满足台词
喂猫粮	右键 → 🍖喂猫粮	出现猫粮碗 + 吃饭台词
逗猫棒	右键 → 🎪逗猫棒	鼠标变逗猫棒，宠物追着跑！按 ESC 或 右键 退出
换 pose	右键 → 🔄换pose	切换不同照片造型
调大小	右键 → 📏调整大小，或鼠标滚轮	放大缩小
置顶	右键 → 📌始终置顶	开关窗口置顶
退出	右键 → ❌退出	关闭宠物

---

🚀 快速开始（3 步搞定）

前提条件

你需要一台电脑（Windows / Mac / Linux 都行）来制作桌宠， 最终生成的 .exe 在 Windows 上双击运行。

请确保已安装：

1. Python 3.8+（下载地址，安装时勾选 "Add to PATH"）
2. Docker（下载地址，用来打包 EXE）

没装 Docker？也能用！完成步骤 1-2 后，找一台有 Docker 的电脑做步骤 3 即可。

---

第 1 步：准备照片 📷

1. 在 photos/ 文件夹里创建一个以宠物名字命名的子文件夹
2. 把宠物的照片放进去（JPG 或 PNG 都行，建议 3~30 张）

桌宠工坊/
  photos/
    我的猫/          ← 在这里放照片
      照片1.jpg
      照片2.jpg
      ...

照片小贴士：

• 宠物主体越清晰，抠图效果越好
• 各种姿势、角度都可以，会变成"换 pose"功能
• 背景复杂也没关系，AI 会自动去除

---

第 2 步：一键制作 🛠️

打开终端（Windows 用 PowerShell / CMD，Mac 用终端），进入项目目录：

cd 桌宠工坊
bash make.sh

脚本会引导你输入：

🐾 宠物名字（如：湾湾）： 我的猫
💬 问候语（回车用默认）： 
📁 照片文件夹路径（如 photos/my_cat）： photos/我的猫

然后自动完成：

1. ✂️ AI 自动抠图去背景（每张照片约 5 秒）
2. ⚙️ 生成配置和图标
3. 📦 打包成 Windows EXE（需要几分钟）

---

第 3 步：使用你的桌宠 🎉

制作完成后，在 dist/ 文件夹里找到你的桌宠：

桌宠工坊/dist/我的猫桌宠.exe

把这个 .exe 文件拷到 Windows 电脑上，双击运行就行了！

Windows 安全提示： 首次运行可能弹出 SmartScreen 提示，点击「更多信息」→「仍要运行」即可。

---

🔧 分步操作（高级）

如果一键脚本不方便，也可以手动分步执行：

步骤 1：安装 Python 依赖

pip install -r requirements.txt

步骤 2：下载 AI 模型（仅首次）

python download_model.py

步骤 3：抠图

python 01_cutout.py photos/我的猫 我的猫_assets

步骤 4：生成配置

python 02_prepare.py 我的猫 "喵～我是我的猫！" 我的猫_assets

步骤 5：打包

bash 03_build.sh 我的猫桌宠

---

❓ 常见问题

Q：制作出来的桌宠双击闪退？

检查是否被杀毒软件拦截。PyInstaller 打包的未签名程序偶尔会被误报，加白名单即可。

Q：抠图效果不好，边缘有残留？

AI 抠图对复杂背景效果有限。建议使用背景简洁、主体突出的照片。照片中宠物占比越大效果越好。

Q：打包很慢？

首次打包需要下载 Docker 镜像（约 3.8GB）和安装依赖，后续会快很多。

Q：没有 Docker 怎么办？

可以只做步骤 1-2（抠图 + 配置），然后在有 Docker 的电脑上做步骤 3。或者直接在 Windows 上安装 Python + PyQt5 + PyInstaller，用 pyinstaller 本地打包（不需要 Docker）。

Q：可以给多个宠物分别做桌宠吗？

当然！每个宠物用不同的照片文件夹，分别运行 make.sh 即可。

Q：怎么修改宠物说的话？

编辑 pet_main.py 文件顶部的台词库（IDLE_LINES、CLICK_LINES 等），重新打包。

---

📂 项目结构说明

桌宠工坊/
├── 使用手册.md          ← 你正在看的这个
├── make.sh              ← 一键制作入口
├── download_model.py    ← 下载 AI 模型（首次自动调用）
├── 01_cutout.py         ← 步骤 1：AI 抠图
├── 02_prepare.py        ← 步骤 2：生成配置 + 图标
├── 03_build.sh          ← 步骤 3：打包 EXE
├── pet_main.py          ← 桌宠主程序（通用引擎）
├── pet_config.json      ← 配置文件（制作时自动生成）
├── requirements.txt     ← Python 依赖列表
├── assets/              ← 互动素材（逗猫棒/心形/猫粮碗）
│   ├── wand_toy.png
│   ├── heart.png
│   └── food_bowl.png
├── model/
│   └── u2net.onnx       ← AI 抠图模型（176MB，首次自动下载）
├── photos/              ← 放宠物照片的地方
│   └── 你的宠物名/
└── dist/                ← 生成的 EXE 在这里（打包后出现）

---

祝你和你的桌宠玩得开心！🐱