DSH Plugins Marketplace

DSH Plugins

Plugins

/

Just for Fun

/

dsh-grok-ball

d

dsh-grok-ball

Identified

Grok Ball desktop pet for DeepSeek Harness: follows your cursor, switches emotion with the agent's run state, draggable with click feedback.

dsh-grok-ball

DSH 界面上的 Grok Ball 表情球挂件:圆球 + 一双会跟着鼠标看的眼睛,按 DSH 的运行状态换表情,可拖动,点一下有反馈。

表情引擎来自 tycoding/grok-ball(MIT,纯 SVG、零运行依赖),本仓库把它接进 DSH 的客户端插件体系。

它现在会做什么

DSH 状态表情
空闲 / 没有进行中的会话02 待机放空
空闲超过 10 分钟00 睡眠
一轮回复刚开始31 接收任务(0.65 秒)
正在跑(running)30 思考中
需要你回答 / 授权(pendingInteraction)35 等待输入
一轮刚跑完33 任务完成 + 撒花(2.6 秒)
点一下球10 开心 + 自旋甩彩带 + 弹跳(0.8 秒)
菜单里手动挑的表情盖过状态映射,直到点「跟随 DSH 状态」
  • 眼睛实时跟随鼠标(setGaze)。
  • 拖动摆位,位置记在 localStorage 的 dsh-grok-ball:pos,窗口缩放时自动夹回可视区,并且不会钻到底部输入框下面。
  • 单击球会在右上角短暂浮出「⋯」菜单按钮;点它拉出面板:
    • 大小:64–160px 滑块;
    • 表情:引擎里的全部表情按生命周期 / 情绪反应 / 代理状态分组,点一下立刻播放,也可以点「跟随 DSH 状态」交还给自动映射;
    • 隐藏菜单按钮:打开后单击只保留正常交互,右键唤出面板。
  • 挂载在 shell.overlay 槽位(order: 950),只有球本身接收指针事件,不挡聊天。

安装

dsh plugin --profile web add dsh-grok-ball

本地开发也可以先 link 自己的目录(profile 名按你实际用的填):

dsh plugin --profile desktop add "link:E:\Grok Ball"

装完需要重启 DSH(插件市场里的「重启」或关掉重开),新插件才会进宿主组合。

卸载

dsh plugin --profile web remove dsh-grok-ball

结构

package.json           # dsh.bundle.patch + dsh.client 声明
cordis.patch.yml       # 把插件 insert 进 profile 层栈
lib/index.js           # 宿主半边:空 apply(只为让 bundle 能挂载)
lib/client.js          # 浏览器半边:__ModuleLoader__ 包装 + 内联引擎 + 挂件逻辑(构建产物)
src/client-src.js      # 浏览器半边的可读源文件
vendor/grok-ball.js    # 上游引擎,未修改
scripts/build.mjs      # 把 vendor 引擎塞进 src 里的占位符,产出 lib/client.js
scripts/smoke-test.mjs # 无浏览器烟测:DOM/React 桩 + 状态映射断言
preview.html           # 纯前端预览页,不依赖 DSH

开发

$node = "$env:USERPROFILE\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe"
& $node scripts/build.mjs      # 改完 src/client-src.js 或换引擎后重新生成 lib/client.js
& $node scripts/smoke-test.mjs # 无浏览器烟测

改完 lib/client.js 后刷新页面即可(client-modules 按 mtime 热读 bundle);新增/移除插件才需要重启宿主。

状态从哪来

浏览器半边通过 ctx.inject(['slots', 'uiSession'], …) 拿到 uiSession,订阅:

  • uiSession.adapter.current:当前会话绑定(key / props.sessionId);
  • uiSession.sessionStatus:Map<sessionId, { running, pendingInteraction, completionUnread }>。

「任务完成」由插件自己观察当前会话的 running: true → false 得出(主会话的 completionUnread 会被宿主清掉,所以不依赖它)。

许可

MIT。引擎版权归 tycoding(见 vendor/LICENSE 与根目录 LICENSE)。

Comments

Loading…

Similar plugins

dsh-emotion-pet

by cpt-kenvie

Emotion Ball pet dock for the DeepSeek Harness Web composer

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 3

↓ 176/wk

NOASSERTION

JavaScript

Nov 2, 2026

dsh plugin --profile web add dsh-emotion-pet

by alybg

DeepSeek Harness 部署级桌宠:右下角随 Agent 工作状态切换 GIF 动画,气泡实时显示 DeepSeek 余额与语音台词,可拖动、可点击互动,任务完成随机播放语音。

Manifest valid

★ 4

↓ 86.4k/wk

JavaScript

Aug 17, 2026

dsh plugin --profile web add dsh-pet

by devzer0o0

Replaces the colored status dot in each DSH sidebar session row with the Grok Bot avatar, whose own expressions show the session's state: idle, thinking, streaming, running tools, waiting for your app

UI & ExperienceDevelopment & InfrastructureManifest valid

★ 2

NOASSERTION

JavaScript

Nov 10, 2026

dsh plugin --profile web add dsh-grok-buddy

by c-ling

DeepSeek Harness 桌面电子宠物插件:跟随 agent 状态变换心情的内置/自定义/Codex 精灵图伙伴。

Terminal & ClientsManifest valid

★ 4

↓ 53/wk

MIT

JavaScript

Oct 22, 2026

dsh plugin --profile web add dsh-plugin-pet

by takboo

Animated desktop companion, task notifications, and session chat for DeepSeek Harness.

Just for FunManifest valid

★ 20

↓ 2.2k/wk

AGPL-3.0

JavaScript

Nov 18, 2026

dsh plugin --profile web add @takboo/dsh-coopanion

by djornii

Grok-style animated starfield for the DeepSeek Harness new-session tab.

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 14, 2026

dsh plugin --profile web add dsh-grok-stars