前言¶
在 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