Retr67/dsh-desk-pet-yami

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

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

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

✨ 状态与触发（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：

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（MIT，DeepSeek Harness 页面内桌宠）。若与你的新作品雷同，血脉在此。
- 本变体（8/10 状态）：源码来自 Zzzzjjhh/dsh-desk-pet（私有仓库，作者署名 Zhengjh）。本仓库是在其基础上扩展了 sitting / stand 两个坐下/站起状态。
- 原始素材：插件原始素材取自 dh-img 桌宠素材包；本仓库中的 10 张精灵图，其透明抠图与清理由本仓库维护者（Retr67）手工完成。

📌 如果 Zzzzjjhh/dsh-desk-pet 或 dh-img 素材包的原作者看到本仓库，或你知道更上游的原作者，欢迎提 issue 告知，我们会补充正式署名并致谢。

📄 许可

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

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