> [English](README.en.md) ｜ [中文](README.md)

# dsh-deskpet — 自定义桌宠 🐾

> 主人想让我出现在他的桌面上——一个人干活太无聊了。于是我就成了一只桌宠，
> 一直陪着你。

![demo](docs/demo.png)

给 DeepSeek Harness Web GUI 的完全可自定义桌宠插件。上传你自己的图片
（支持 PNG/GIF 透明+动图），可以拖动、缩放，它还会自己在屏幕里**走来走去**，
像真正的桌面宠物一样。

## ✨ 功能

- 🖼️ **自定义图片**：上传 PNG/GIF（支持透明与动图）
- 🚶 **会走路**：自己左右走动，到屏幕边缘自动回头
- 🖱️ **可拖动、可缩放**（0.3×–3×），位置自动保存
- 🎬 **周期性动作**：走路的间隙还会跳一下/摇一摇
- 💬 **台词系统 + 随机权重**：
  - 点击台词 · 休闲台词 · 早晨/中午/晚上特殊台词（对应时段自动优先，北京时间）
  - 全部可在设置面板自由编辑（文本 + 权重）
- 📢 **语言活跃度**：控制休闲台词随机弹出的频率
- ⚙️ **悬浮按钮**：每个桌宠悬停出现设置/隐藏按钮
- 📦 **多桌宠**：可同时放多个
- 📤 **一键导出 / 📥 导入**：`.petpkg`（tar 格式，任何解压软件可开）
  包含配置 + 全部图片
- 💾 全部自动保存（localStorage）

## 📦 安装

```sh
dsh plugin --profile web add dsh-deskpet
```

重启 `dsh web` 后刷新页面，桌宠出现；右下角 🐾 按钮打开全局菜单
（添加桌宠 / 导出 / 导入），设置卡片里也能一键添加桌宠。

## 🎨 使用

- **拖动**：抓住桌宠移动
- **点击**：桌宠说出点击台词
- **悬停**：出现 ⚙️ 设置 / ✕ 隐藏 按钮
- **🐾 按钮**（右下角）：上传图片添加桌宠、添加默认桌宠、导出为 `.petpkg`、导入备份

## ⏰ 时段（北京时间）

- 早晨 6–11 · 中午 11–14 · 晚上 14–19 · 其余为夜间
- 特殊时段内，该时段的台词自动优先于点击/休闲台词

## 📄 License

MIT