DeepSeek Harness 插件：dsh-svw-waveform

DeepSeek Harness（DSH）的核心设计理念是“一切皆插件”。对于从事系统级验证的开发者来说，波形查看是高频需求。现有的终端波形卡片功能有限，难以满足复杂的交互分析。dsh-svw-waveform 插件通过注册 svw_wave_render，在 Web 端实现了与 SVW 的原生对接。

插件概况¶

该插件属于 DSH 的客户端组件，由 svcomplex-dev 维护。它的核心作用是在 DSH Web 界面中提供原生的 SVW 波形渲染能力。模型只需提供 VCD 或 FST 文件路径、精确的时间范围以及分层信号名称，即可在浏览器中获得交互式波形视图。

核心功能¶

原生渲染：直接调用 SVW 引擎进行波形绘制，而非简单的文本映射。
交互查看器：在 Web UI 中支持缩放、平移、标记、基数选择、边沿导航以及 Delta-cycle 标记。
信号支持：支持 1 到 12 个分层信号名称。
文件格式：支持 VCD 或 FST 路径。

安装与启用¶

插件以 npm 包的形式分发，安装到 DSH 的 Web 配置文件中即可生效：

dsh plugin --profile web add dsh-svw-waveform
dsh --profile web --dump-config
dsh --profile web

安装过程中，npm 包会自动选择对应平台的预构建二进制文件（Linux x64 或 macOS arm64）。该插件不会在消费级机器上编译，因此无需编写构建脚本。

使用方法¶

使用该插件通常分为两步。

首先，需要获取精确的信号名称。可以通过 agent 命令获取：

svw agent design.vcd signals reset 20

获取信号列表后，模型可以在回复中调用注册的工具，或者直接在对话中指定波形参数。一个典型的调用参数如下：

{
  "waveform": "design.vcd",
  "start": 100,
  "end": 160,
  "hier": ["top.clk", "top.reset_n"],
  "width": 120,
  "height": 24
}

环境与注意事项¶

DSH 版本：当前该插件仅支持 @deepseek-ai/dsh 0.1.x release-candidate 系列版本。
自定义路径：如果需要使用独立安装的 SVW 二进制文件，需设置环境变量 SVW_BIN 为绝对路径。
macOS 环境：在 macOS 上，如果 npm 包未找到，系统会尝试接受 Homebrew 安装的 SVW 作为后备方案。
权限与来源：由于插件在 DSH 进程权限下运行，安装前应检查源码与许可证。

总结¶

dsh-svw-waveform 为 DeepSeek Harness 提供了从终端到 Web 端的波形分析能力补全。它将复杂的 SVW 引擎封装在插件中，让智能体能够直接处理 VCD/FST 数据。

插件目录：https://www.skillhub.cn/plugins/svcomplex-dev/dsh-svw-waveform
GitHub 仓库：https://github.com/svcomplex-dev/dsh-svw-waveform