前言¶

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 开发者提供了一个直观、实时且有趣的调试窗口，将抽象的事件流转化为具象的生态演化过程。通过这种方式，可以更清晰地观察组件间的交互与能量流动。