yztdtf/dsh-worktable-pet

DSH 桌宠插件（worktable-pet）

一个运行在 DeepSeek Harness Web 界面右下角的动画桌宠插件，基于 DSH 动态 Cordis 插件机制实现。图片素材来自 images/（白底 JPG 帧），插件运行时通过内置 HTTP 路由把处理好的透明帧提供给浏览器，无需外部静态服务器。

功能

- 🎬 12 帧透明背景动画循环（默认 2 秒/帧，点击互动时短暂加速）
- 💬 点击桌宠：随机气泡短语 + 兴奋跳跃动画
- ✕ 悬停显示隐藏按钮，可收起为小圆点（再点恢复）
- 🖱️ 悬停放大反馈，遵循系统「减少动态效果」设置
- 🌐 帧图片由插件自带 HTTP 路由提供，浏览器直接加载

文件结构

| 路径 | 说明 |
| --- | --- |
| plugin/host.js | 插件 Host 半段：帧列表 RPC + 帧图片 HTTP 路由 |
| plugin/client.js | 插件 Client 半段：右下角动画桌宠 UI |
| pet-frames/ | 处理好的透明背景帧（0.png ~ 11.png），运行时被插件读取 |
| images/ | 原始白底 JPG 素材（微信图片，帧 9~20） |
| scripts/preprocess.ps1 | JPG → 透明 PNG 帧预处理脚本（去白底、对齐裁剪、缩放） |

安装（在 DSH 中运行）

DSH 动态插件是进程级的，安装方式如下：

1. 把本仓库的 pet-frames/ 目录放到你的 DSH 工作区（或项目根目录）。
2. 在 DSH 会话中让 AI 助手用 cordis_define 定义插件：
- Host 代码 = plugin/host.js 的内容
- Client 代码 = plugin/client.js 的内容
3. 用 cordis_run 激活插件并批准运行。
4. 页面右下角出现动画桌宠即成功。

Host 端会自动按顺序尝试定位帧目录：当前工作区根目录下的 pet-frames/ → 仓库所在绝对路径 → 相对路径 pet-frames。也可以手动修改 plugin/host.js 中的候选路径列表。

帧图片路由

Host 注册的前缀路由：/worktable-pet-assets/.png，客户端通过 harness.handle('pet-frames') 获取帧列表后再拼接 URL 加载图片。

重新生成帧素材

如果替换了 images/ 里的 JPG（白底、按帧序号命名），运行：

powershell -ExecutionPolicy Bypass -File scripts/preprocess.ps1 -SrcDir images -DstDir pet-frames -TargetHeight 420

脚本会：去除白色背景（软阈值抠图）、按所有帧的可见区域联合裁剪对齐、等比缩放到指定高度，输出透明 PNG。

参数调整

- 动画速度：plugin/client.js 中 ctx.interval(..., excited ? 250 : 2000)，把 2000 改成你想要的毫秒数。
- 桌宠大小：plugin/client.js 样式里 .wtpet-img{width:160px}。
- 气泡文案：plugin/client.js 中的 PHRASES 数组。
- 位置：.wtpet-root{right:20px;bottom:18px}。

License

MIT