在 DeepSeek Harness (DSH) 的 Web GUI 中，底部栏通常是一个固定的占位区域。dsh-bird-bike 插件将这一区域改造成了一个动态的、像素风格的场景，为开发者提供了即时的视觉反馈和交互趣味。
插件简介¶
dsh-bird-bike 是一个趣味换装插件，由用户 blackstar-baba 维护。它解决的是 Web GUI 界面静态、缺乏动态细节的问题。该插件在 DSH 的 ui-layout 基础上挂载了一个 2D 像素艺术动画，包含物理模拟和交互逻辑，无需构建即可运行。
核心功能¶
1. 像素小鸡骑士与自行车¶
- 角色与动画：小鸡佩戴蓝绿头盔，具备 IK 反向动力学蹬腿动画、2 帧扑翅动画和眨眼效果。
- 自行车细节：包含辐条车轮、链条和踏板曲柄。
2. 昼夜循环与环境¶
- 循环机制：约 80 秒为一个昼夜周期。黄昏与黎明阶段按 8 级色阶平滑切换。
- 夜间效果：夜晚会出现星星、方形月亮和车头灯光锥。
3. 交互与事件¶
- 按铃与加速：点击骑行带可触发芯片音“叮铃”以及 MC 风格的彩色音符粒子，同时小鸡会进行短暂加速冲刺（伴随扬尘）。
- 跳跃：执行方块感的小跳，落地时产生扬尘。
- 怪物出没：
- 白天：苦力怕会向小鸡走来，接近 2m 时触发闪烁加速预警，随后爆炸将小鸡炸上天空。
- 夜晚：僵尸会缓缓逼近，接触瞬间将小鸡撞飞（伴随旋转飞出和闷响）。
4. UI 与状态管理¶
- 骑行统计：实时显示里程、车速和骑行时长（仅累计实际骑行时间）。数字采用固定宽度等宽数字槽，显示稳定不抖动。
- 可收起：骑行带可收起为 40px 的迷你车道，状态会本地持久化保存。
- 无障碍支持：尊重系统
prefers-reduced-motion设置，在静止模式下仍保持交互可用。
安装与启用¶
使用官方 CLI 安装插件：
dsh plugin --profile web add dsh-bird-bike
安装完成后，插件会自动挂载到 Web GUI 底部，无需额外配置即可看到像素小鸡骑行。
操作方式¶
- 点击骑行带：触发按铃加速、音符粒子效果。
- 跳跃：小鸡执行跳跃动作。
- 切换昼夜：点击切换到黄昏或黎明阶段。
- 收起/展开：通过按钮或状态切换，将骑行带收起为 40px 迷你车道，或展开为完整场景。
技术实现与兼容性¶
- 技术栈：纯 JavaScript 编写，零依赖、零构建。通过
window.__ModuleLoader__注册懒工厂，挂入ui-layout的shell.bottom槽位。 - 渲染方式：在低分辨率离屏画布上绘制，使用硬像素原语（矩形、Bresenham 线、扫描线椭圆等），最后通过最近邻放大渲染。
- 兼容性要求：需要 DSH 版本 >= 0.2.1-alpha。该插件依赖
shell.bottom槽位，该槽位自该版本起提供。
卸载¶
- 在 GUI 的 Plugins 页面移除插件。
- 或手动在 profile 目录下执行
pnpm remove dsh-bird-bike，并从dsh.profile.bundles配置中移除相关条目。
总结¶
dsh-bird-bike 展示了如何在不增加复杂性的前提下，通过简单的代码为 DSH Web GUI 增添动态视觉元素。其基于 Canvas 的像素渲染和物理模拟细节，为插件化开发提供了参考。更多信息和源码，请访问 GitHub。
