桌面拉布拉多 laym0nd/dsh-labrador

dsh-labrador

一只住在 DeepSeek Harness 窗口里的拉布拉多。

她由十七张我家狗狗 DaiDai 的抠图照片拼成，靠一个小状态机驱动。她自己决定要做什么，可以被戳、被拖、被扔，用狗语说话，还能在设置页里调教。

这些帧是一只特定狗狗的照片。 装上这个插件，就是把那只狗放进你的窗口。想要自己的狗，就替换帧——见用你自己的照片。

安装

dsh plugin --profile web add dsh-labrador

然后重启 harness。她会出现在窗口右下角。

她会做什么

- 自己做决定。 状态机在七个阶段之间切换——idle、acting、moving、sleeping、reacting、dragging 和 thrown——并从加权姿势池里抽取。不存在从当前姿势到不可达姿势的过渡：睡着的狗会醒到 idle，绝不会直接跳进某个姿势。
- 姿势。 十七个动作，其中十二个能站在地板上：坐着、站着、抬头看、趴在沙发上、睡着、嗅东西、在车里、戴伊丽莎白圈。
- 被摆弄。 点一下戳她。拖动她，她会留在窗口内。把她扔出去，她会飞——有重力、撞墙撞地板会弹、落地有摩擦——而且每次撞击都会换表情。
- 说狗语。 woof. hff. woof woof! yip! grrr. 等等，冒在她头顶的气泡里。只有叫声，没有词，所以也没什么可翻译的。
- 右键弹出菜单：摸摸他、立刻播放任意动作，或者把她送回自己的角落。
- 只在她自己身上响应指针，周围透明边距不算。

设置

Settings → 拉布拉多 / Labrador

性格（calm、attentive、lively）、大小、不透明度，以及每个动作各自的权重和显示/隐藏开关。保存会原子写入 $DSH_HOME/dsh-labrador/main-config.json，狗狗无需重载就会跟上。

{
"temperament": "attentive",
"size": 1,
"opacity": 1,
"weights": { "sleep": 2 },
"disabledActions": []
}

非法值会记进日志，并回退到文档里写的默认值；不会有任何东西被悄悄忽略。

怎么搭出来的

- lib/index.js —— 宿主那一半：构建动作库，并通过一条 HTTP 路由提供帧和设置。
- lib/client.js —— 客户端那一半：状态机、地板几何、物理和 UI。状态机是纯的——没有 React、没有 DOM、没有定时器——测试直接驱动它。
- lib/repertoire.js —— 十七个动作，以数据形式存在。调他的行为就是改这里，不是改引擎。
- lib/library.js —— 解析帧，对任何坏掉的东西大声报警，绝不悄悄丢掉一只狗。
- assets/frames/ — 归一化后的帧。每一帧都是同样的 445×328 画布，狗的大小相同、站在同一条地平线上、位置也在同一个中心，所以换姿势不会让它跳起来或者改变大小。

使用你自己的照片

在 $DSH_HOME/dsh-labrador/actions/ 放一个文件夹。里面每个子文件夹就是一个动作；里面的图片就是它的帧；可选的 action.json 可以覆盖默认值：

// $DSH_HOME/dsh-labrador/actions/sit/action.json
{
"category": "ambient", // idle | ambient | move | click | event
"weight": 20,
"loop": "hold",
"bust": false // true if head-and-shoulders: it cannot stand on the floor
}

帧直接从那个文件夹提供，所以不需要重新构建任何东西。

测试

npm test

四十四项测试覆盖状态机和物理，六项覆盖配置，三十六项冒烟检查覆盖两半。它们直接执行运行，而不是通过 node --test，因为那个运行器会为每个文件生成子进程，在某些沙箱环境里会被阻塞。

已知限制

- 移动被禁用。 它需要一个带好几帧的走路动作才能展示步态，而只有一张走路的照片，所以她待在原地，而不是横向滑动。加载时会有一条警告说明这一点。
- 有一帧是碎片。 sniff 姿势在抠图时丢了头，所以看起来像一块狗。它还是被包含了进来，权重很低。
- 宠物只活在 harness 窗口里。没有独立的、始终置顶的桌面窗口。

许可证

MIT