pi-dsh-pet 🐾

English

一只住在 pi 终端编程助手里的大肥鱼：待机呼吸、随机动作（含打瞌睡）、偶尔转向、屏幕漫游、点击反应、可拖拽。

Fork 自 dsh-pet（npm），本项目专为 pi 平台适配 —— 响应 pi agent 工作状态（思考/写代码/空闲），通过 Electron 全屏透明浮窗渲染。原 dsh-pet 用户请使用 npm 原版。

---

快速开始

npm install -g pi-dsh-pet

在 pi 中运行：

/pet             →  正常大小（400px）
/pet small       →  小号（260px）
/pet large       →  大号（540px）
/pet-stop        →  关闭所有宠物窗口

💡 首次运行时需下载 Electron ≈100MB，后续启动秒开。

宠物会出现在屏幕右下角，开始动画链。当你在 pi 里写代码或提问时，宠物会自动响应：

pi agent 状态	宠物动画
开始思考	深度思考碎碎念
调用工具（bash/edit/write）	写代码
空闲	恢复随机动画链

💡 思考/写代码状态中点击宠物 → 播放「点击回应-傲娇生气」→ 完整播完后自动回到当前状态动画。

---

目录结构

pi-dsh-pet/
├── pi/extensions/       # pi 扩展入口（HTTP + WebSocket + Electron 浮窗启动器）
├── pi/assets/           # Electron 窗口 UI（pet.html + pet.js + pet.css + preload）
├── assets/preview/      # 91 个预览 GIF
├── assets/thumb/        # 91 个透明 WebM 动画
├── assets/config.jsonc  # 动画到事件/标签的映射
├── package.json         # npm 包清单
├── DESIGN.md            # 设计与实现文档
├── LICENSE              # MIT
└── README.md

动画预览

全部 91 个动画（640×360 透明 WebM）：

待机 / 转向

移动

小动作

玩耍

吃什么

时节

文字

点击回应 / 拖拽

---

自定义大小

大小映射定义在 pi/assets/pet.js 第 589 行：

var SIZE_MAP = { small: 260, normal: 400, large: 540 };

• 改数字 — 修改小/中/大的 px 宽度（高度自动 = 宽 × 9/16）
• 加档位 — 添加 tiny、xlarge 等新条目，例如 { tiny: 180, ..., xlarge: 720 }

修改后重新 /pet 生效，新增命令（如 /pet tiny、/pet xlarge）自动可用。

文档

• 设计与实现 —— 架构、pi 事件映射、素材链

许可

• 代码：MIT
• 素材（动画/提示词/源视频）：允许开源使用，禁止商用