dsh-bird-bike:DSH Web GUI 底部的像素小雞騎行帶

在 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 槽位,該槽位自該版本起提供。

卸載

  1. 在 GUI 的 Plugins 頁面移除插件。
  2. 或手動在 profile 目錄下執行 pnpm remove dsh-bird-bike,並從 dsh.profile.bundles 配置中移除相關條目。

總結

dsh-bird-bike 展示瞭如何在不增加複雜性的前提下,通過簡單的代碼爲 DSH Web GUI 增添動態視覺元素。其基於 Canvas 的像素渲染和物理模擬細節,爲插件化開發提供了參考。更多信息和源碼,請訪問 GitHub。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜