Airtl for VS Code

作者：Airtl yu

联系邮箱：yuairtl@outlook.com

平时看动辄几千上万行的 RTL，纯靠文本一层层跳转去找例化，确实费眼。Airtl 在 VS Code 里把 Vivado 工程的模块层级、实例调用和端口连线直接画成图，再用 AI 帮你读代码、查仿真问题。

功能介绍

可视化审阅（主要功能）

• 架构拓扑直观呈现：直接把模块层级和实例调用生成图形化结构，理清工程整体框架，不再靠脑补。
• 接口连线直观走查：信号流向与端口匹配可视化展示，方便快速排查连线错漏与结构冗余。

AI 辅助

• 复杂代码深度解读：遇到生疏复杂的逻辑，支持由 AI 辅助剖析设计意图。
• 辅助仿真验证：在仿真与测试阶段提供智能分析支持，加速定位问题与排查流程。

支持范围

Airtl 在 VS Code 中展示 Vivado 工程的模块层次、设计源、仿真源、约束和模块连接图。 支持从 .xpr、指定顶层的 Tcl 脚本或 HDL 源文件选择工程来源。

推荐运行版本

• Visual Studio Code 1.126.0 或更高版本。1.126 于 2026 年 6 月 24 日发布，建议使用此版本之后的版本；旧版本未经过完整兼容性测试。
• OpenCode 1.18.35。这是当前完成集成验收的版本；其他版本未逐一验证。

RTL 解析、工程文件收集、模块图、端口与总线处理、布局和改线计算由编译后的 airtl.node 原生库完成。模块树与 BD 面板复用同一份原生工程快照。

安装

在 VS Code 扩展面板选择 Install from VSIX，打开对应的 Windows x64 安装包； 也可运行 code --install-extension airtl-<版本>-win32-x64.vsix。 原生库随安装包提供，无需单独安装 C/C++ 编译器或第三方 C 运行库。

使用

1. 打开包含 Vivado 工程或 HDL 源码的工作区。
2. 在源码树中选择工程来源；已有选择保存在工作区的 .vscode/vivado-project.json。
3. 查看 Design Sources、Simulation Sources 和 Constraints。
4. 打开模块连接图，查看模块、端口、总线与连线；通过节点命令跳转源码。

文件变更后刷新视图。RTL 改线通过 VS Code 的 WorkspaceEdit 应用，可用 Ctrl+Z 撤销。

界面语言

扩展界面跟随 VS Code 的显示语言：中文环境显示中文，其他语言环境显示英文。 在命令面板运行 Configure Display Language，选择语言后重启 VS Code 即可切换。

AI 资源

发布包中的 prompts/ 与 ref_skill/ 文件仅包含 需写入prompts 占位内容。 使用相应流程前需提供所需内容。运行时资源位于 C:/userconfig/rtlassistant/； 具体 AI 工具与模型在扩展设置中选择。

授权

部分代码开源

项目部分代码已开源。公开版本需要联网运行，目前全员免费开放试用。公开版本不包括 AI 辅助相关技能，使用者需要自行填写。

AI 技能与离线支持

如需 AI 辅助相关技能、AI 环境配置，或有离线使用需求，请联系 Airtl 提供。

Open-source and public version

Part of the project source code is open source. The public version requires an internet connection and is currently free for everyone to try. AI assistance skills are not included in the public version and must be provided by the user.

AI skills and offline use

Please contact Airtl for AI assistance skills, AI environment setup, or offline use.

发布内容

发布版本包含 VS Code 扩展运行文件与编译后的原生库。C/C++ 源码、构建工具、 测试、调试符号和开发期参考实现不随 VSIX 发布。

可读源码与文档按 Apache License 2.0 授权；编译后的原生核心按独立授权规则管理。 具体许可边界见 LICENSE 和 LICENSE-APACHE-2.0。

如有问题，请提供扩展版本、所选工程来源和 Output 面板中的错误信息。