前言¶

DeepSeek Harness（DSH）採用「一切皆插件」的設計理念。在開發智能體或調試複雜鏈路時，開發者通常需要通過日誌或事件監聽來追蹤組件狀態。dsh-evo-vis 是一個宿主側插件，它監聽 Harness 的 Cordis 事件流，將組件的活動實時映射到一個可視化面板上，把每一次組件活動變成一座會進化的深海生物圈。

核心功能¶

1. 實時可視化
   通過 SSE（Server-Sent Events）事件流推送組件狀態。支持對 core、llm、session、tools、memory、agent、plan 等類型的事件進行映射與展示。面板能實時顯示當前 Provider / Model，並在生成過程中提供脈動指示。

2. 組件進化系統
   組件根據活動能量積累進化。從 Lv.1 孢子 到 Lv.6 超新星。能量積累到閾值後，組件會升級、產生進化光環或衝擊波，並伴隨名字進化。

3. 零依賴與零構建
   面板採用純 ESM JavaScript 編寫，無需前端框架。dsh plugin add 命令即可安裝，無構建產物，無 TypeScript 編譯依賴。

4. 美觀的 UI
   使用深空鯨魚藍主題與玻璃擬態設計。包含 Canvas 粒子引擎，支持星雲、星點、熒光浮游、輝光節點等視覺效果。

安裝與啓用¶

在 DeepSeek Harness 的 Web profile 下安裝本插件：

dsh plugin --profile web add github:simplosophy/dsh-evo-vis

安裝完成後啓動 Web UI：

dsh web

啓動後訪問 http://127.0.0.1:3080/evo 即可看到可視化面板。也可以在 DeepSeek Harness Web UI 右下角找到 Evo Vis 懸浮入口。

配置¶

在 profile 的 cordis.patch.yml 中可以覆蓋配置項，控制面板路徑、事件保留數量和心跳間隔：

- update:
    - id: evo-vis
      config:
        path: /evo
        maxEvents: 400
        heartbeatMs: 15000

注意事項¶

1. 運行環境
   插件需要 ctx.webServer 環境才能掛載面板。在 headless 等無 Web Server 的 profile 下不會顯示面板，但會繼續監聽事件，不影響 Harness 運行。

2. 技術棧
   純 ESM JavaScript，無 TypeScript 編譯產物。

3. 零侵入
   插件不修改 Harness 核心，通過註冊 HTTP 路由和注入 UI 懸浮入口實現功能，卸載後完全還原。

總結¶

dsh-evo-vis 爲 DSH 開發者提供了一個直觀、實時且有趣的調試窗口，將抽象的事件流轉化爲具象的生態演化過程。通過這種方式，可以更清晰地觀察組件間的交互與能量流動。