dsh-desk-pet

Readme

# dsh-desk-pet · 金色暗影 Yami 桌宠

DeepSeek Harness（DSH）Web 界面右下角的桌面宠物——**金色暗影 · Golden Darkness（ヤミ）**，出自漫画家**矢吹健太朗**×**长谷见沙贵**的《To Love-Ru》。它会根据当前 Agent 的工作状态自动切换动作/表情，可以用鼠标拖到界面任意位置。

> ## ⚠️ 重要声明
> **本仓库仅供学习与交流，无任何商业盈利目的。**
> - 角色「金色暗影 Yami」及其形象版权归《To Love-Ru》原作者（矢吹健太朗 / 长谷见沙贵）及出版社（集英社）所有；
> - 如涉及侵权，或原作者 / 版权方要求删除，请[提 issue](https://github.com/Retr67/dsh-desk-pet-yami/issues) 或邮件联系，我们会在收到通知后 **立即下架相关内容**。

## ✨ 状态与触发（10 个状态）

| 状态 | 触发时机 |
| --- | --- |
| 😴 `rest` 休息中 | Agent 空闲，且空闲未满 8 秒 |
| 🪑 `sitting` 坐下了 | Agent 连续空闲 **超过 8 秒**，自动坐下 |
| 🧍 `stand` 站起来了 | 从「坐下」恢复活动时，先站起约 0.7 秒再干活 |
| 🤔 `think` 思考中 | 模型正在流式生成 |
| 🛠 `work` 工作中 | 正在执行工具 / Agent 运行中 |
| ⏳ `wait` 等待中 | 有审批请求待处理 |
| ❌ `error` 出错了 | 某一步 / 回合报错（约 3 秒） |
| ✅ `done` 完成了 | 一个回合刚结束（约 2.5 秒） |
| 🐣 `greet` 你好呀 | 插件刚加载（约 2.6 秒） |
| ✋ `drag` 拖动中 | 你用鼠标拖动它 |

> 空闲坐下 / 站起的时长可在 `dsh/client.js` 顶部的 `SIT_AFTER_MS`（默认 8000ms）与 `WAKE_MS`（默认 700ms）调整。

## 📦 安装

这是一个 dsh bundle 插件，通过 vendor 链接安装到 web profile：

```pwsh
npx -y @deepseek-ai/dsh plugin --profile web add https://github.com/Retr67/dsh-desk-pet-yami.git
```

安装后**重启 dsh web**，刷新页面，右下角即可看到桌宠。

## 🧩 结构与实现

```
dsh-desk-pet/
├── dsh/
│   ├── index.js        # host 侧：监听 Agent 事件合成状态 + 提供 HTTP 路由
│   └── client.js       # 浏览器侧：渲染桌宠 + 轮询状态 + 拖动 + 空闲坐下
├── assets/sprites/     # 10 张状态切图（透明 PNG）
├── cordis.patch.yml    # bundle 补丁层
├── package.json        # dsh.bundle / dsh.client 声明
├── LICENSE
└── README.md
```

- Host 侧监听 `agent/status`、`agent/error`、`llm/stream`、`tools/execute`、`approval/request`，按优先级合成状态（error > wait > think > work > done > rest）。
- 状态通过 `/desk-pet/status`（JSON）暴露，素材通过 `/desk-pet/sprites/*.png` 直出（`Content-Type: image/png`，`no-cache`）。
- 浏览器侧为原生 DOM + `fetch`，零依赖、无构建步骤。

## 🙏 致谢与原作者溯源

本插件**并非从零开发**，而是社区流传的 DSH 桌面宠物实现的衍生版本，按可追溯的线索如实声明：

- **页面内桌宠流派原创**：本仓库所采用的「住在 DSH Web 界面右下角的桌宠」实现思路，衍生于 [PC2005-cloud/dsh-pet](https://github.com/PC2005-cloud/dsh-pet)（MIT，DeepSeek Harness 页面内桌宠）。若与你的新作品雷同，血脉在此。
- **本变体（8/10 状态）**：源码来自 **`Zzzzjjhh/dsh-desk-pet`**（私有仓库，作者署名 Zhengjh）。本仓库是在其基础上扩展了 `sitting` / `stand` 两个坐下/站起状态。
- **原始素材**：插件原始素材取自 **`dh-img` 桌宠素材包**；本仓库中的 10 张精灵图，其**透明抠图与清理**由本仓库维护者（Retr67）手工完成。

> 📌 如果 `Zzzzjjhh/dsh-desk-pet` 或 `dh-img` 素材包的原作者看到本仓库，或你知道更上游的原作者，欢迎[提 issue](https://github.com/Retr67/dsh-desk-pet-yami/issues) 告知，我们会补充正式署名并致谢。

## 📄 许可

- **代码**：MIT License（见 `LICENSE`）
- **角色与素材**：角色形象版权归《To Love-Ru》原作者 / 集英社所有；素材仅限个人学习，非商业用途。任何商业使用与再分发风险由使用者自负。

---
*非营利 · 仅供学习 · 侵权请联系下架*