@plusl/dsh-emotion-ball
v0.1.0
Published
Emotion Ball desktop pet for dsh web: a draggable overlay pet driven by DSH agent activity (thinking / working / done / error), built on the open-source Emotion Ball engine
Maintainers
Readme
@plusl/dsh-emotion-ball
An Emotion Ball desktop pet for DeepSeek Harness (DSH) — a draggable overlay pet that reacts to your AI agent's activity: it looks curious when a message arrives, thinks along with the model, celebrates with confetti when a task completes, and naps at the screen edge when everything is quiet.
Install
dsh plugin --profile web add @plusl/dsh-emotion-ballThen restart dsh web and refresh the page — the pet appears in the
top-right corner.
Behavior
| DSH activity | Pet reaction | | --- | --- | | User message received | 好奇 (curious), ~2s | | Model turn starts | 思考中 (thinking, head ring) | | Tool executing | 处理中忙碌 (busy), back to thinking after | | Turn error | 出错 (error), ~3s | | Turn complete | 任务完成 (done) + confetti, back to idle after 4s | | Idle | 待机 (standby) with breathing and blinking |
Interactions
| Action | Behavior | | --- | --- | | Left click | Poke: bounce + random cute reaction + speech bubble | | Double click | Celebrate: spin + confetti | | Right click | Context menu: 32 emotions, spin/bounce/confetti, skins, size, hide | | Drag | Move + magnetic edge snap; flick toward an edge to dock | | Docked click | Pull back out (a quick second click wakes it up angry) | | Quiet 90s / 4min | Auto doze (发呆) then sleep (zzZ); any activity wakes it | | DSH completes while docked | Peeks out to look, then tucks back in |
Settings live in the DSH settings page (follow toggle, bubble, auto-doze, body shape blob/wedge/gem, skin, size 100–240px). Settings are per-session.
Attribution & license
- The Emotion Ball engine is by sam70361, licensed Learning & Exchange (Non-Commercial) — personal, non-commercial use only. Commercial use of the engine requires the author's permission.
- The plugin glue code in this repository is MIT licensed.
@plusl/dsh-emotion-ball(中文)
基于开源项目 Emotion Ball (作者 sam70361)制作的 DeepSeek Harness (DSH) 桌宠插件:一个可拖拽的悬浮球,跟随 AI 代理的活动切换表情 —— 收到消息 好奇、模型思考时一起思考、任务完成撒花庆祝、安静时贴边打盹。
安装
dsh plugin --profile web add @plusl/dsh-emotion-ball重启 dsh web 并刷新页面,桌宠出现在右上角。
联动行为
| DSH 活动 | 表情 |
| --- | --- |
| 收到用户消息 | 好奇 (03),约 2 秒 |
| 模型回合开始(思考) | 思考中 (30,头顶环带) |
| 工具执行中 | 处理中忙碌 (32),结束后回到思考 (30) |
| 回合错误 | 出错 (34),约 3 秒 |
| 回合完成 | 任务完成 (33),4 秒后回待机 (02) |
| 平时 | 待机 (02),带呼吸与眨眼 |
交互
| 操作 | 行为 | | --- | --- | | 左键点击 | 戳一下:弹跳 + 随机可爱反应 + 头顶说话气泡 | | 双击 | 庆祝:自旋甩彩带 + 撒花 + 开心表情 | | 右键 | 上下文菜单:32 种表情、旋转/弹跳/撒花、皮肤、大小、躲起来 | | 拖动 | 移动位置,松手磁吸最近屏幕边缘;甩向边缘扔进边里藏 | | 点击露出部分 | 捞回;捞回后快速连点会被吵醒生气 | | 安静 90 秒 / 4 分钟 | 自动发呆 → 睡着(zzZ),任何活动自动唤醒 | | 躲藏中 DSH 完成 | 探头看一眼「诶?完成了!」,2 秒后缩回继续睡 |
设置面板单起一栏「Emotion Ball 桌宠」:跟随联动、对话气泡、自动打盹、 身体形态(blob / wedge / gem)、皮肤(默认米白 / 玄夜 / 蜜桃 / 薄荷 / 晴空)、大小 100–240px。设置为本会话临时状态。
致谢与许可
- 原项目 Emotion Ball 表情馆(sam70361),许可为 学习交流许可 (非商业):仅供学习交流,禁止商业用途。如需商业使用引擎,请联系 原作者获取商业许可。
- 本仓库插件代码以 MIT 许可发布。
