DeepSeek Harness (DSH) 采用插件化架构。在 Web 界面观察 Agent 执行时，默认输出较为静态。dsh-livechat 插件通过在对话区叠加 B 站风格的弹幕，为 Agent 的工作过程增加视觉反馈。
插件定位¶
这是由 huashenglian 维护的趣味换装类插件。它利用多轨道渲染与防遮挡渐隐技术，在 Agent 发送消息、回复完成、工具调用或任务完成时，生成预设或智能弹幕横向飘过。核心价值在于将原本枯燥的日志流转化为类似观看直播的动态体验。
安装与启用¶
插件是 bundle：自带 cordis.patch.yml，自我激活——一条命令，无需手动改 patch。
dsh plugin --profile web add github:huashenglian/dsh-livechat
安装完成后，重启 dsh web 并打开 http://127.0.0.1:3080，弹幕覆盖层与浮动控制球会出现在对话区上方。
核心功能¶
渲染与防遮挡¶
- 多轨道防碰撞与渐隐：支持多轨道防碰撞与防遮挡渐隐。
- Chromium 优先优化：对 Chromium 做了优先优化（如
translate3d、页面hidden暂停、同屏上限）。 - 防遮挡：阅读时覆盖层变暗，热闹时亮起。
内容生成¶
- 三套预设包：内置通用/编程/闲聊三套预设包。
- LLM 智能生成：可选 LLM 按节流生成弹幕，支持智能、间隔、工具调用唤醒模式。生成失败时会静默降级为预设。
- 风格模板：支持风格模板配置。
交互控制¶
- 拖球与悬停：提供拖球控制与悬停暂停。
- 锁定机制：悬停/详情锁定的弹幕会一直留在画面，直到恢复滚动并离开范围。
分会话弹幕库¶
- 池管理：支持分会话
.jsonl弹幕池管理。 - 历史回放：包含历史回放功能（衰减+点赞加权）。
- 归档与恢复：支持归档与恢复。
其他特性¶
- 礼物特效：提供素材仓库与特效位置配置。
- 配置持久化：配置写入本地镜像（
$DSH_HOME/danmaku-config.json）与settings.yaml里的精简danmaku:段；启动按「镜像 → settings → 默认」解析，重启不会丢配置。
典型用法¶
- 健康检查：
curl http://127.0.0.1:3080/api/danmaku/health
返回示例：`{"ok":true,"name":"dsh-danmaku","version":"0.6.2"}`。
- 单元测试：
node --test tests/presets.test.js
- 卸载：
dsh plugin --profile web remove dsh-livechat
注意事项¶
- 自我激活：Bundle 自带
cordis.patch.yml自我激活（insert id: livechat）。不要在 profile 的 patch 里重复 insert，否则启动时会报duplicate loader entry id: livechat。 - 缓存清理：若服务仍在运行时卸载，会一并清理弹幕库缓存（
~/.dsh/danmaku-pools/）。 - 权限与来源：插件以当前 dsh 进程权限运行，安装前应检查源码与许可证（MIT）。
总结¶
dsh-livechat 是一个轻量级的趣味插件，适合希望在开发调试或演示时增加 Agent 互动感的用户。它通过视觉化的方式呈现 Agent 的执行流，同时提供了灵活的配置与交互手段。
