前言¶
在 DeepSeek Harness (DSH) 的開發與調試過程中,軌跡(trajectory)數據——包含工具調用、輪次切換、助手回覆等事件——是觀察智能體行爲的核心依據。然而,這些信息通常分散在對話流中,難以快速定位。dsh-danmaku 旨在通過可視化手段,將這些軌跡輸出以彈幕形式實時顯示在對話頁面,提供一種直觀的監控視角。
插件信息¶
- 插件名:
biggermax/dsh-danmaku - 維護者:BiggerMax
- 分類:趣味換裝
- 許可證:MIT
核心功能¶
該插件將 DSH 的軌跡事件渲染爲從右向左滾動的彈幕。
- 事件支持:支持用戶消息(僅直接人類輸入)、助手回覆、工具調用、工具結果、輪次切換等事件。
- 控制面板:提供右上角膠囊形控件,包含彈幕總開關、速度調節(60-350 px/s)以及貼邊收納功能。
- 技術實現:純客戶端插件,利用
pointer-events: none確保不干擾應用交互;採用 14 軌道調度與去重機制。
安裝與啓用¶
插件安裝與啓用依賴 DSH 的本地開發環境。
方式一:運行時注入(免重啓)
dev_inject_plugin /path/to/dsh-danmaku
方式二:持久化安裝(需重啓)
dev_install_package /path/to/dsh-danmaku
安裝完成後,刷新頁面即可看到彈幕效果。
典型用法¶
- 查看效果:安裝後刷新頁面,對話頁面上方會出現從右向左滾動的彈幕,展示當前的軌跡事件。
- 調節速度:拖動右上角控制面板的速度滑塊,可實時調節彈幕滾動速度(範圍 60-350 px/s)。
- 自動收納:將控制面板拖動到屏幕邊緣 48px 範圍內並鬆手,面板會自動貼邊收起爲小標籤,懸停或點擊可展開。
注意事項¶
- 數據持久化:設置(開關、位置、速度)會持久化到瀏覽器的
localStorage,鍵名爲dsh.trajectory-danmaku.settings。 - 去重機制:基於
buildViewNode返回的 key 進行去重,初始加載和歷史回填的數據不會觸發彈幕顯示。 - 消息過濾:用戶消息僅顯示直接的人類輸入,合成上下文中的消息會被跳過。
結語¶
dsh-danmaku 爲 DSH 用戶提供了將軌跡數據轉化爲實時視覺反饋的能力,適合需要在開發過程中高頻觀察智能體狀態變化的場景。
- 目錄頁:dsh-danmaku - SkillHub
- GitHub:biggermax/dsh-danmaku