前言¶
在 DeepSeek Harness(DSH)的会话窗口里加一只像素风格的桌宠,可以在写代码或跟 AI 对话时多一个安静的陪伴。DSH 的插件生态允许在会话容器内做自定义界面,但需要自己处理定位、鼠标事件、图层层级等细节。蕾克桌宠(dsh-leike-pet)用一套纯 DOM 方案把「会呼吸的像素角色」封装起来,让它沿着输入框上沿走动、对鼠标做出反应,并内置了睡觉、眨眼、转身等动作。
是什么¶
这是给 DSH 会话窗口用的像素桌宠插件,维护者是 Zyr147258。核心能力是:在输入框上沿左右走动、对鼠标靠近做出转头反应、双击睡觉、右键调整大小(2×~7×),同时保证透明背景、无边框、始终置顶,不会挡住输入框或消息。精灵图由原始四格立绘自动生成,前端按整数倍放大,2×~7× 的任意尺寸都是锐利的像素块。
核心功能¶
- 透明无边框、始终置顶:使用
position:fixed的覆盖层,只有精灵本体接收鼠标事件,不会干扰输入框或消息点击。 - 在会话窗口内散步:利用 DSH 会话容器的稳定属性(
[data-conversation-content]/[data-composer-seat])计算地面与左右边界,在输入框上沿来回走动,速度 26px/s;走到边界时掉头,走一会儿随机停下待机。 - 会呼吸的小动作:走动时两步一拍上下起伏;待机时左右张望、偶尔蹦一下;随机眨眼(单独闭眼帧),睡觉时直接闭眼;掉头时先露出背影,模拟转身。
- 鼠标靠近会看你:鼠标进入头部 220px 半径时停下,切换三向姿势(左 / 正 / 右);鼠标离开或停住超过 2.6 秒后继续走动。
- 双击睡觉:闭眼 + 呼吸起伏 + 头顶
Zzz,再双击恢复走动。 - 右键调整大小:面板里可设置 2×~7× 的整数倍放大,使用
image-rendering:pixelated保持像素清晰,选择记在localStorage,下次打开自动应用。 - 不挑主题:亮色 / 暗色主题下都能看清;设置面板用深色半透明底,与像素风一致。
安装与启用¶
从 npm 安装(推荐):
dsh plugin --profile web add dsh-leike-pet
从 GitHub 安装:
dsh plugin --profile web add github:Zyr147258/dsh-leike-pet
本地开发:
git clone https://github.com/Zyr147258/dsh-leike-pet.git
dsh plugin --profile web add link:$PWD
安装完成后重启 dsh web,浏览器刷新(Ctrl+F5)即可看到效果。
典型用法¶
- 什么都不做:蕾克会在会话窗口底部左右缓慢走动,偶尔停下张望、蹦一下或眨眼。
- 鼠标靠近:它会在头部 220px 半径内停下,转向鼠标方向;鼠标离开或停住不动约 2.6 秒后继续走动。
- 双击精灵:原地睡觉(闭眼 + Zzz),再双击恢复走动。
- 右键精灵:打开/关闭设置面板,调整大小(2×~7×)。
- Esc / 点击面板外部:关闭设置面板。
如需调整手感,可修改 lib/pet.js 顶部的常量(刷新页面生效):
var SPEED = 26 // 走动速度 px/s
var ALERT_RADIUS = 220 // 鼠标靠近多少像素开始转头
var ALERT_HOLD_MS = 2600 // 鼠标停住多久后继续走动
var IDLE_MIN / IDLE_MAX // 每次停下待机的时长
var WALK_BURST_MIN / MAX // 连续走多久后随机停一下
var BLINK_MIN / BLINK_MAX // 眨眼间隔
var LOOK_MIN / LOOK_MAX // 待机张望间隔
var HOP_CHANCE // 待机时蹦一下的概率
var SCALE_MIN / SCALE_MAX // 面板里可调的大小范围(整数倍)
适用场景与注意¶
- 适合想在 DSH 会话窗口里增加一点陪伴感的用户,例如写代码、调试或长时间对话时,有角色在旁边走动会显得不那么单调。
- 插件以当前 dsh 进程的权限运行,安装前建议查看源码与许可证(MIT)。
- 这是应用窗口内的桌宠,不是系统级桌面宠物;插件只提供静态资源,不读写凭据,走动位置等状态在内存中,刷新页面会重置。
- 没有会话窗口时(例如停留在设置页),桌宠会退化成沿主面板底部走动。
短结尾¶
蕾克桌宠用一套纯 DOM 方案,把「会呼吸的像素角色」放进 DSH 会话窗口,支持散步、转头、睡觉、调整大小等交互,适合想在对话时多一点陪伴感的用户。插件仓库见 https://github.com/Zyr147258/dsh-leike-pet