跳转到主要内容

VSCode or Trae 如何一键安装 ROSS 开发环境?

由 judy 提交于

文章来源:FPGA入门到精通

本文收获

✅ 只下一个包,MCP 二进制、49 个技能、11 个示例全在里面

✅ 分清「已安装」「已启用」「对当前会话生效」是三件事

✅ 认出哪两类报错属于版本差异,别误判成装坏了

前面2篇介绍了claude code 和 codex 安装ROSS 开发环境,这次分享如何在常用的VSCode  和 Trae IDE中安装,需要先安装codebuddy 插件。

一、安装准备

1、哪些安装包?

这个扩展不是那种「装个界面壳、还得自己去补依赖」的东西。二十九兆的包里,MCP 二进制(Windows 与 Linux 各一份)、49 个技能、11 个示例、内置文档站,全在。

2、 你的 Vivado 版本能不能跑

官方内置文档的测试基线是 2026.1,声明架构上兼容所有已发布版本。

多版本共存只有一个代价,必须显式指定驱动哪个。

3、 其他前置

配置根集中在一处,是这条路最舒服的地方。CLI 那边散在 ~/.claude.json、~/.codex/config.toml,还得记哪个 scope 写哪儿;这里 mcp.json、settings.json、plugins/ 全在 ~/.codebuddy/ 底下。

注意这里需要先安装codebuddy。

二、一句提示词安装

1、 提示词

我现在需要安装AMD ROSS的一整套开发环境,相关的安装程序文件位置:《路径》

把 《路径》 换成实际目录,形如 D:\downloads,剩下的交给它。

你要做的只有一件事,每步读一眼它说要干什么,然后点同意。

为什么一句就够:文件位置给准了,后面五步都是标准动作。装扩展、取二进制、注册 MCP、启用插件、逐项验证,官方文档里全有,不用你补参数。

想更精确一点,可以加一两句,不加就走默认值。

这里需要注意。插件面板把这件事拆得很细:安装和启用是两枚独立状态,作用域分三档,每档各有一套安装、启用、禁用、卸载。

⚠️ 这里是本篇第一个真坑。已安装不等于已启用,已启用也不等于对当前会话生效。

只把包装进来、面板显示「已安装」,却忘了点启用;或者装在了项目、本地作用域,也是同一个结果。新会话里一个 ROSS 技能都列不出来,面板却一直告诉你装好了。

实测就是这么撞上的,插件启用之前启动的那个会话,从头到尾看不到任何技能。这不是 bug,技能是会话启动时读的,「重载窗口」加「开新会话」这两步就是必须,不是建议。

稳妥做法只有一条。

装在用户作用域并启用,等价于往 settings.json 的 enabledPlugins 写一行,再重载窗口,开新会话。

2、它会做什么?

三、测试验证

分三层测,工具层、技能层、行为层,分开报。

1、 测试总览

2、 工具层

3、 技能层

plugins/marketplaces/<市场目录>/skills/ 下是 50 个目录条目,其中 hls-scripts/ 是给技能调用的脚本目录,里面 41 个 .py,不算技能。实际 49 个,跟官方宣称对得上。

按前缀分布,hls-* 22(含 hls-scripts)、vai-* 13、segcfg-* 7、vivado-* 6、hw-* 2。

4、 行为层

5、 云端文档检索

一次真实查询,问的是怎么用 synth_design -lint 跑 RTL lint。

命中了 UG901(Vivado Synthesis)和 UG895(System-Level Design Entry),每条都带 docs.amd.com 链接和版本标签,2024.1、2025.2、2026.1 三档都在。

零登录,零凭证。

它还支持 family、tool、version 三个过滤,version 的枚举里就有 2021.2,可以钉住版本查。机器版本老、官方文档早滚到新版的时候,这个过滤最实用。

顺便给了一个交叉印证。UG901 原文写的是 synth_design -top <top_level> -part <part> -lint,跟 3.5 第三条结论对得上。示例里那句多出来的 -file,官方语法里从来没有。

完整安装依赖文件:

https://pan.quark.cn/s/48dd67085b40