dsh-real-fish-pet

Readme

# DSH-RealFish-Pet

在 DeepSeek Harness **web 界面**里游动的 3D 渲染鲸鱼桌面宠物（个人用插件）。

鲸鱼模型为原创 Blender 作品（受 DeepSeek 标志启发），所有动画帧由 Blender 头less 逐帧渲染，行为全部由本插件自定义实现（不依赖 dsh-pet 状态机）。

## 行为

- **默认状态**：在屏幕右下 1/4 区域（52–84vw / 54–78vh）内随机连续游动，出界自动折返；鼠标悬停时原地冻结，移开后继续。
- **attention（任务事件提示）**：模型任务完成 / 出错 / 需要手动处理（批准请求）等事件触发跳跃 attention 动画 + 随机播放鲸吟 1/2/3.mp3（两次事件间隔 ≥6s 防轰炸；声音需先与页面有过一次交互才会自动播放）。
- **交互**：
  - 单击：停下游动 + 反应动画 + 气泡
  - 双击：位置不变，直接恢复自由游动
  - 拖拽：可拖到任意位置，松手后从新位置继续游动
  - 右键菜单（宠物头上 `⋮`）：开心一下 / 原地睡觉 / **回家睡觉**（游到右下角 HOME 然后睡 5 分钟后自动醒来游动）/ 自由游动 / 隐藏宠物
  - 隐藏后右下角出现「召唤宠物」按钮

## 结构

```
lib/index.js    host 半：资源静态路由 + 事件队列 HTTP API（node:fs，无额外依赖）
lib/client.js   browser 半：ModuleLoader bundle（手写，无构建步骤）
assets/         帧图（idle/react/drag/swimL/swimR/turn）+ 鲸吟音效
cordis.patch.yml  一行插件行挂载
```

- 资源路由：`/dsh-real-fish/assets/...`（PNG/MP3，`Cache-Control: public, max-age=86400`）
- 事件 API：`GET /dsh-real-fish/api/poll`（client 每 2s 轮询）、`/api/stats`

## 安装（本地开发）

```bash
dsh plugin --profile web add link:<本目录绝对路径>
# 重启 dsh web 后宠物自动出现（无需手动运行插件）
```

## 发布

1. `npm pack` 产出 tarball（或直接推 GitHub 仓库）。
2. 发布到 npm registry（需 npm 账号）后即可被市场 / `dsh plugin add` 安装。

## 许可

- 代码与资产：CC-BY-4.0（详见 LICENSE）。
- 鲸鱼为原创模型二次创作（灵感来自 DeepSeek 标志），与 DeepSeek 官方无关联。