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 的執行流，同時提供了靈活的配置與交互手段。
