# Desktop Pet

> 把任何角色或動物的圖片變成互動式桌面寵物（桌寵）。分析圖片、自動去背、產生個性化設定，並啟動一隻會在桌面走動的透明置頂寵物，支援餵食、撫摸、呼喚主人、Ctrl+點擊召喚、拖曳等互動。當使用者提供圖片並想做成桌寵時使用。Turn any character/animal image into an interactive desktop pet with auto background removal, feeding, petting, call-owner and Ctrl+click summon. Use when the user provides an image and wants a desktop pet (e.g. "make a desktop pet from this image", "把這張圖做成桌寵"), or wants to launch/manage existing pets.

- Skill: `yuchi-chang/desktop-pet` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add yuchi-chang/desktop-pet`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yuchi-chang/desktop-pet/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yuchi-chang (https://skillmd.com/u/yuchi-chang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yuchi-chang/desktop-pet

---


# Desktop Pet（桌寵產生器）

把一張圖片變成會在桌面上活動的互動式桌寵。流程：分析圖片 → 去背製作 sprite → 產生個性 config → 啟動 Electron 引擎。

## 目錄結構

```
desktop-pet/
├── engine/            # Electron 桌寵引擎（共用，只需 npm install 一次）
├── scripts/
│   └── prepare_sprite.py   # 去背 + 裁切 + 縮放
└── pets/<slug>/       # 每隻寵物一個資料夾
    ├── sprite.png     # 去背後的圖
    └── config.json    # 名字、個性、台詞
```

## 建立新桌寵的流程

### 1. 確認環境（第一次才需要）

- `engine/node_modules` 不存在 → 在 `engine/` 執行 `npm install`
- `python -c "import rembg"` 失敗 → `pip install rembg onnxruntime pillow`

### 2. 取得並分析圖片

需要圖片的**檔案路徑**（使用者只貼圖沒給路徑時，請他提供路徑）。
用 Read 工具看圖，判斷：

- **物種與個性**：決定名字（向使用者提議，可自訂）、叫聲、食物 emoji、台詞風格
- **facing**：圖中角色面向哪邊（`left` / `right`，正面朝前就填 `right`）
- 適合的 `callSound`：`bark`（狗）/ `meow`（貓）/ `chirp`（鳥）/ `squeak`（小動物、史萊姆等）

### 3. 製作 sprite

```
python scripts/prepare_sprite.py <輸入圖片> pets/<slug>/sprite.png
```

- 輸出 JSON：`width`、`height`、`skipped_rembg`（圖片本身已有透明背景時會跳過去背）
- 第一次執行會下載 u2net 模型（約 170MB），需要一點時間
- 去背品質差（主體破碎）時，建議使用者換一張主體清晰、背景乾淨的圖

### 4. 撰寫 config.json

```json
{
  "name": "小柴",
  "species": "dog",
  "sprite": "sprite.png",
  "scale": 0.6,
  "facing": "right",
  "food": "🍖",
  "callSound": "bark",
  "phrases": {
    "greet": ["嗨！主人～"],
    "call": ["主人～我在這裡！"],
    "lonely": ["主人…你在忙嗎？"],
    "arrive": ["我來了！"],
    "feedStart": ["哇！有吃的！"],
    "feedDone": ["好好吃～謝謝主人！"],
    "petted": ["好舒服～"],
    "sleep": ["晚安…"],
    "wake": ["醒來了！"]
  }
}
```

- **scale**：目標是螢幕上高度約 120～180px → `scale = 150 / sprite高度`（取一位小數）
- **phrases**：用**使用者慣用的語言**撰寫（跟使用者對話是中文就寫繁中，英文就寫英文），依角色個性撰寫（每類 2～3 句更生動）；省略的類別有預設值（繁中）

### 5. 啟動

```powershell
Set-Location <skill目錄>\engine
npm start -- --pet "<pets/<slug> 的絕對路徑>"
```

用 run_in_background 啟動。多隻桌寵 = 啟動多個 process（各指定不同 `--pet`）。

也可以告訴使用者不靠指令的啟動方式：雙擊 skill 根目錄的 `start-pet.bat`（啟動第一隻寵物）或 `start-pet.bat <寵物名>`；把它的捷徑放到 `shell:startup` 資料夾可開機自動啟動。

### 6. 告訴使用者怎麼玩

| 互動 | 操作 |
|------|------|
| 撫摸 | 滑鼠移到寵物身上輕輕來回移動（會冒愛心） |
| 餵食 | 在寵物身上按右鍵 → 🍽️ 餵食（食物掉下來，牠會走過去吃） |
| 呼喚主人 | 右鍵 → 📣 呼喚主人（講話＋叫聲） |
| 召喚過來 | **Ctrl + 左鍵**點桌面任意處；備用熱鍵 **Ctrl+Alt+P**（叫到滑鼠位置） |
| 拖曳 | 按住左鍵把牠拎起來，放開會掉回地面 |
| 睡覺/離開 | 右鍵選單 |

牠也會自己閒逛、無聊時呼喚主人、太久沒人理會睡著。

## 疑難排解

- **Ctrl+點擊沒反應**：uiohook-napi 載入失敗（主程序 console 有警告），改用 Ctrl+Alt+P；或重新 `npm install`
- **寵物擋住桌面點擊**：只有滑鼠懸停在寵物上時視窗才攔截滑鼠，其餘區域皆穿透；若異常，重啟該寵物
- **關閉某隻寵物**：右鍵選單「離開」，或結束對應的 electron process
- **除錯**：設環境變數 `PET_DEBUG=1` 再啟動，會開 DevTools 並輸出狀態轉換 log，renderer 提供 `window.__pet`（state/feed/call/summon）