用途:GF-Viz 用于在终端中可视化 GateFlow 生成的代码库地图,把 .gateflow/map/ 中的数据渲染成交互式 ASCII/Unicode 图,便于浏览模块层级、状态机与模块细节。
前置条件:需先存在代码库地图,可用 ls .gateflow/map/CODEBASE.md 2>/dev/null 检查;若不存在,需先运行 /gf-map 生成。
主要视图:概览仪表盘(统计、紧凑层级、FSM 列表、健康状态与导航菜单);层级浏览器(完整模块树、参数、实例表,支持 show <module> 与 which modules use <module>);FSM 查看器(状态框、转移表、状态详情,支持 explain <S1→S2>);模块详情卡(参数、端口、内部时钟/复位/FSM/实例、连接与健康);另有信号路径追踪、时序图、差异视图、端口连接矩阵与搜索等视图。
使用方式:调用后默认渲染概览仪表盘;带参数如 /gf-viz uart_tx 可直接跳到该模块详情卡。支持菜单导航([H] 首页、[1][2][3] 切换视图、[↑] 父模块)与自然语言查询,如 show <module>、trace <signal> from <a> to <b>、explain <...>、add assertions to <module>、find modules with fsm、find unconnected ports、find cdc crossings 等。超出可视化的请求会转交 sv-understanding、sv-verification、sv-refactor 等代理。
限制:依赖已有地图数据,无地图时无法渲染;FSM 超过 7 个状态时仅用转移表;层级过深或过宽时只显示部分并提示聚焦;差异视图需要 .gateflow/map/.prev_* 快照。具体收费、平台与效果资料暂未提供。