前言¶
DeepSeek Harness（DSH）提供了一个 AI 对话的工作窗口。在长时间使用或开发调试的过程中，窗口背景可能显得单调。laym0nd/dsh-labrador 插件通过引入一只基于照片和状态机的虚拟拉布拉多宠物，为窗口增加了低开销的陪伴元素。它不依赖复杂的渲染引擎，而是通过状态机控制行为，适合希望在开发或使用过程中获得视觉反馈的用户。
是什么¶
这是一只生活在 DeepSeek Harness 窗口角落的虚拟宠物。它的外观由 17 张特定照片驱动，通过内置的状态机决定行为逻辑。插件完全运行在 DSH 进程内部，没有独立的桌面窗口。项目采用 MIT 许可证，源代码托管在 GitHub。
核心功能¶
- 状态机控制：宠物拥有 7 个核心状态（空闲、行动、移动、睡眠、反应、拖拽、投掷）。状态机确保行为转换的连贯性，例如从睡眠状态醒来只会过渡到空闲状态，不会直接跳变到其他姿态。
- 姿势库：内置 17 种姿势，包括坐、站、向上看、在沙发上、睡觉、嗅、在车里、戴圆锥等。
- 物理交互：支持点击戳刺、拖拽移动。投掷功能包含重力、墙壁/地面反弹和落地摩擦力计算；每次撞击墙壁或地面时，宠物的面部表情会随之改变。
- 声音反馈：能够发出狗叫声（如 woof、hff、yip、grrr 等），以气泡形式显示在头部上方。
- 右键菜单：提供右键菜单，支持“抚摸”、“播放动作”或“送回角落”等操作。
- 设置页面：可在
Settings -> 拉布拉多 / Labrador中调整性格（平静、专注、活泼）、大小、不透明度，以及控制每个动作的权重和显示开关。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add dsh-labrador
安装完成后重启 Harness。宠物将出现在窗口的右下角。
典型用法¶
- 交互：点击宠物身体可进行戳刺。
- 移动：拖拽宠物可改变其在窗口内的位置。
- 投掷：将宠物扔向墙壁或地面，观察其反弹和表情变化。
- 菜单：右键点击宠物，选择“抚摸”、“播放动作”或“送回角落”。
- 配置：在设置页面调整行为参数，保存后会自动生效。
注意事项¶
- 移动限制：水平移动功能当前已禁用。插件需要专门的步行动作（包含多帧）才能展示滑行效果，当前姿势库不支持。
- 姿势缺陷：“嗅”姿势是一个残缺片段（缺失头部），以较低的权重包含在内。
- 窗口范围：宠物仅存在于 Harness 窗口内，没有脱离窗口的独立桌面窗口。
- 配置持久化：设置以原子方式写入
$DSH_HOME/dsh-labrador/main-config.json，非法值会被记录并回退到默认值。 - 源码查看：使用前建议查看源码，确认许可证与依赖兼容性。
结语¶
laym0nd/dsh-labrador 是一个轻量级的桌面宠物插件，通过状态机和物理交互为 DSH 窗口增添了趣味性。它适合希望自定义行为参数或仅仅是寻求视觉陪伴的开发者。更多细节可参考项目目录页或 GitHub 仓库。
