MrXCQ / yasuo-desktop-pet

🐉 Yasuo Desktop Pet (亚索桌宠) — DSH Cordis Plugin

一个运行在 DeepSeek Harness (DSH) Web 界面右下角的亚索桌宠插件。它会跟随当前 Agent 的工作状态做出不同动作，任务完成时播放「搜累呀给冬」音效并庆祝。

A desktop pet for the DeepSeek Harness Web UI. It lives in the bottom-right corner, reacts to the Agent's working status, and plays a voice line + celebration whenever a task completes.

---

功能特性 / Features

状态	桌宠动作
Agent 工作中 (running)	快速抖动 + 气泡「正在干活！💪」
Agent 空闲 (idle)	缓慢呼吸漂浮 + 气泡「摸鱼中… Zzz」
任务完成 (running → idle)	播放音效 + 跳跃旋转庆祝 + 彩带 + 气泡「搜累呀给冬！！！」

• 🖱 拖动：把亚索拖到任意位置
• 🖱 点击：播放一次音效（顺带解锁浏览器自动播放限制）
• 🔊/🔇：右上角小圆钮静音 / 取消静音
• 📦 单文件自包含：图标与音效已内嵌进 plugin.js，零配置开箱即用；也支持替换为自己的素材

---

安装 / Install

要求：一个 DSH（DeepSeek Harness）会话。

1. 下载本仓库，或只下载 plugin.js（约 84KB，自包含）。

2. 把 plugin.js 放进你的 DSH 工作区，然后对你的 Agent 说：

   “安装 plugin.js 里的 cordis 插件。”

   Agent 会执行 cordis_define + cordis_run。

3. 首次运行需要在 Web 界面的运行卡片 / 插件面板里点一次「批准」（浏览器端插件需要用户授权一次）。

4. 右下角出现亚索即安装成功。

卸载 / Uninstall

• 暂时停用：让 Agent 执行 cordis_stop <pluginId>
• 永久移除：让 Agent 执行 cordis_undefine <pluginId>

---

自定义素材 / Custom Assets

默认使用内嵌素材。想换成自己的图标/声音：

1. 编辑 source/host.js 顶部的配置：

   const ASSET_DIR = '';              // 填你的素材目录，例如 '/Users/me/pet-assets'
   const IMAGE_FILENAME = '亚索图标.png';
   const AUDIO_FILENAME = '音效.mp3';
   

2. 把同名文件放进 ASSET_DIR。插件会优先读取外部文件，读取失败自动回退到内置素材。

3. 把改好的代码交给 Agent 重新 cordis_define（existing mode）并 cordis_run（update）。

assets/ 目录里是当前内置素材的原始副本。

---

文件结构 / Layout

yasuo-desktop-pet/
├── plugin.js          # 自包含安装包：{ name, purpose, pluginIdPrefix, host, client }
├── source/
│   ├── host.js        # Host 半源码（素材读取 + agent/status 状态机 + RPC）
│   └── client.js      # Client 半源码（shell.overlay 桌宠 UI + 动画 + 音效）
├── assets/
│   ├── 亚索图标.png
│   └── 音效.mp3
├── LICENSE            # 代码 MIT
└── README.md

---

工作原理 / How it works

• Host 半：监听 agent/status 事件，维护 idle ⇄ running 状态，并在每次 running → idle（任务完成）时递增完成计数；通过 harness.handle 暴露包私有 RPC yasuo-assets / yasuo-state。
• Client 半：注册进 shell.overlay 槽位，每 600ms 轮询状态；根据状态切换动画，完成时用浏览器 Audio 播放音效。

---

版权声明 / Notices

• 代码（plugin.js / source/）：MIT License，可自由使用、修改、分发。
• 内置素材（亚索图标.png、音效.mp3）：为《英雄联盟》相关素材，版权归 Riot Games 所有。本插件仅作个人 / 粉丝用途，请勿用于商业用途；如用于公开分发，请遵循 Riot Games 粉丝内容政策。删除 / 替换为自有素材即可完全规避版权风险。
• 本项目与 Riot Games 无关联，非官方作品。

致谢 / Credit

• 基于 DeepSeek Harness 的动态 Cordis 插件机制开发。
• 素材来源：英雄联盟（Riot Games）。