SuperAPI AI 工具集

gf-errors

写作与研究

查看项目

更新于 10-15 20:13

技能介绍

gf-errors 是 GateFlow 插件(来源 codejunkie99/gateflow-plugin)中的错误翻译层,用途是把硬件工具产生的晦涩报错转换为用户可理解的三层解释。资料明确要求:任何工具报错在呈现给用户前都必须经过翻译,绝不直接展示原始工具输出。

主要能力:针对 Verilator、Yosys、GHDL 和仿真错误,按三层协议输出。第一层 WHAT:用一句不含术语和工具名的平实语言说明发生了什么,例如把“Cannot find signal: 'clk_in'”翻译为“该模块中不存在信号 clk_in”。第二层 WHY:用一到两句结合具体行号和名称解释原因,例如模块在第 5 行把时钟输入声明为 clk,而第 15 行的 always 块引用了 clk_in,两者必须一致。第三层 FIX:给出可执行的具体修改,包含文件、行号和改动内容,例如把 counter.sv 第 15 行的 clk_in 改为 clk。

资料还列出了常见错误的翻译模板:Verilator 的 UNUSED、UNDRIVEN、WIDTH、CASEINCOMPLETE、LATCH、BLKSEQ、PINMISSING;仿真中的输出含 X 值、仿真挂起、断言失败、输出错误;Yosys 的模块未找到、不支持的结构、组合逻辑环路。

使用方式:当 /gf 编排器从 gf-lint 或 gf-sim 收到 FAIL 状态时,必须先解析原始错误输出、匹配上述表格、向用户呈现三层翻译,然后再用原始错误启动修复代理(sv-refactor 或 sv-debug)。修复代理拿到原始错误,用户拿到翻译版本。

限制:资料未提供安装命令、独立调用方式、收费信息或支持平台,这些暂未提供。