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》原作者 / 集英社所有；素材仅限个人学习，非商业用途。任何商业使用与再分发风险由使用者自负。
非营利 · 仅供学习 · 侵权请联系下架
