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