HTUP1/whale-desktop-pet-v2

README 摘要

鲸鱼桌宠 v2（Whale Desktop Pet v2） 一只游在网页上的 小鲸鱼桌宠 ：住在右下角的池塘里，会喷水、吃小鱼、跟着你的鼠标绕圈圈，还会根据 Agent 的工作状态说不同的台词、发出不同的声音。 v2 在 v1 的基础上新增： 池塘与随机游动的小鱼、鲸鱼喷水、饥饿觅食、点击后变小绕圈、正确的鱼类游动姿态 ，并且悬浮层级压过所有对话框。 鲸鱼造型源自 DeepSeek 网页端「探索未至之境」旁边的鲸鱼图案（其 SVG 路径数据）。 ✨ 功能 功能 说明 🐳 自由游动 平时在池塘附近随机游动，偶尔游遍整个页面 🐟 池塘与小鱼 右下角池塘，随机生成小鱼，小鱼会自然游动、寿终消失 🍽️ 饥饿觅食 小鲸会饿（饥饿值增长），饿了就游向最近的小鱼吃掉，吃完喷水庆祝 💦 喷水 每隔一会儿随机喷水，水柱和水滴有完整动画 🖱️ 点击绕圈 点击页面任意位置，小鲸快速游过去 → 变小 → 围着点击处绕一圈 → 恢复 💬 气泡台词 每种事件都有对应台词：开工、收工、报错、用户消息、各工具、批准等 🔊 Web Audio 音效 纯代码合成音效：开工、收工、点击、绕圈、进食、喷水、鲸歌……零音频文件 🤖 Agent 状态联动 实时感知 Agent 忙碌/空闲/出错/请求批准，切换动作、台词和音效 🎨 零依赖 纯原生 JS + SVG + CSS 动画 + Web Audio，无任何第三方库 🚀 快速开始 方式一：独立演示版（最简单） - 在线体验 （GitHub Pages）： - 本地运行 ：直接用浏览器打开 demo/index.html 即可。 演示页内置了模拟事件面板，可以手动触发「开工 / 收工 / 报错 / 工具调用 / 批准」等事件，观察小鲸的反应。 演示版与原版插件共用同一份源码：仅把 DSH 的 ctx / host 接口替换成了本地垫片（shim），其余代码一字未改。 方式二：作为 DeepSeek Harness 插件安装 本插件以 Cordis 插件 形式运行在 DeepSeek Harness（本地 AI 助手 Web 环境）中。 1. 打开 DeepSeek Harness Web 界面，找到插件定义（ cordis define ）入口； 2. 将 plugin/whale-pet-v2.define.json 中的内容作为定义提交； 3. 运行插件（ cordis run ），小鲸即出现在页面中。 源码拆分说明： - plugin/client.js —— 客户端（浏览器端）插件源码，桌宠的全部视觉与行为逻辑； - plugin/host.js —— 宿主端插件源码，采集 Agent 状态与事件（忙碌/空闲/出错/消息/工具/批准），供客户端轮询； - plugin/whale-pet-v2.define.json ——…

分类