SVW 波形查看器 svcomplex-dev/dsh-svw-waveform

dsh-svw-waveform

为 DeepSeek Harness 提供原生 SVW 波形渲染。

插件注册 svw_wave_render。模型给出精确的 VCD 或 FST 路径、原生 tick 范围，以及一到十二个层次化信号名。在 DeepSeek Harness Web UI 里，结果会变成一个可交互的波形查看器，支持缩放、平移、标记、进制选择、边沿导航和 delta-cycle 标记。没有客户端插件的界面则回退到完整的 ANSI 终端波形卡片。

安装

把公开的 npm 包安装到 Web 配置档：

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

npm 包会为 Linux x64 或 macOS arm64 选择一个包内私有的 SVW 可执行文件。它不在使用方机器上编译，也没有 install、postinstall 或 prepare 脚本。设置 SVW_BIN=/absolute/path/to/svw 可以改用独立安装的二进制文件。在 macOS 上，已有的 Homebrew SVW 安装也可作为回退。

DeepSeek Harness 仍是开发者预览版。本包目前支持 @deepseek-ai/dsh 0.1.x 候选发布线，每次改动都会针对固定版本测试后再发布。

使用

先拿到精确的信号名：

svw agent design.vcd signals reset 20

然后让智能体显示一个有界窗口，或者用等价于下面的参数调用注册的工具：

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

内置的 svw-waveform 技能会教智能体完成整套工作流：发现、取值/变化、渲染、比较、语义设计、UVM 和覆盖率。

产物来源

SVW GitHub Releases 是唯一的二进制来源。本仓库从不重新构建 SVW。它的发布工作流会：

1. 下载精确的 release-X.Y.Z Linux 和 macOS 归档文件及 SHA256 校验文件；
2. 拒绝不安全的归档路径，只解压声明过的常规文件；
3. 冒烟测试 svw --version、波形元数据和一次真实渲染；
4. 在干净的 GitHub 托管 runner 上审计动态库；
5. 把字节完全一致的 bin/svw 文件打包进各平台的 npm 包，然后发布入口包。

平台包有：

- dsh-svw-waveform-linux-x64
- dsh-svw-waveform-darwin-arm64

每个包都带 svw-provenance.json，记录来源 Release 资产以及归档和二进制两个 SHA256 值。在同一个 SVW tag 下替换资产会生成新的、不可变的插件补丁版本，而不是覆盖某个 npm 版本。

宿主与浏览器的集成同步自同一个已验证 SVW 归档里带版本号的 share/svw/agents/dsh-extension 文件。svw-source.json 记录它们的原始哈希和少量下游打包转换。

发布配置

publish.yml 工作流接受 repository_dispatch 事件 svw-release-published，也接受手动输入 release-X.Y.Z。它支持临时用 NPM_TOKEN 为三个包名做引导。之后，为每个包配置 npm Trusted Publishing：

- GitHub 组织：svcomplex-dev
- 仓库：dsh-svw-waveform
- 工作流文件名：publish.yml
- 允许的操作：npm publish

三个 trusted publisher 都能正常工作后，删掉 NPM_TOKEN。工作流使用 GitHub OIDC，并自动发布 npm provenance。

开发

npm run verify
sh scripts/setup-git-hooks.sh

所有提交和带注释的包标签都必须使用 svcomplex-dev 。