# 48488_rtlagent **Repository Path**: sycamoreing/48488_rtlagent ## Basic Information - **Project Name**: 48488_rtlagent - **Description**: 本文设计了一套基于本地大模型与Vivado工具反馈的RTL系统 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-29 - **Last Updated**: 2026-11-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # RTL 自修复智能体 这是 RTL 赛道的参赛方案包。智能体读取题面,生成 Verilog,经 Vivado 分阶段检查后在预算内修复候选。推理使用本地 `Qwen3.8-27B-AWQ-INT4`;正式解题不读取隐藏参考测试台。 --- ## 一、目录 | 文件 / 目录 | 作用 | 使用说明 | | --- | --- | --- | | `run.sh` | 单题入口 | 裁剪输入并输出 `solution.v`、`trace.jsonl`;`sN` 目录会偏移采样种子 | | `run_baseline.sh`、`baseline.py` | 赛事方基线 | 使用同一模型,不经过智能体;不得修改 | | `agent/main.py`、`agent/state_machine.py` | 主入口与控制流 | 管理生成、工具、自检、修复和截止时间 | | `agent/spec.py`、`agent/generate_first.py` | 题面与接口处理 | 提取端口、组装并规范化 RTL | | `agent/llm.py`、`agent/prompt_builder.py` | 模型调用与提示 | 连接 OpenAI 兼容的本地 vLLM | | `agent/tools_vivado.py` | EDA 工具封装 | 调用 `xvlog`、`xelab`、`xsim`、`synth_design` | | `agent/self_tb.py`、`agent/truth_table.py`、`agent/reference_models.py` | 有界自检与辅助分析 | 无可靠期望值时明确记录功能未验证 | | `agent/skill_router.py`、`skill/` | 技能选择与技能卡 | 按题面、端口及错误路由,正文在 `SKILL.md` | | `serve/vllm.sh`、`serve/start.sh` | 常驻推理服务 | 监听 `127.0.0.1:8000`,就绪后返回 | | `serve/serve_api.py`、`serve/run_api.sh` | HTTP 投题服务 | 后台守护 `127.0.0.1:7860` | | `model/MODEL.md`、`manifest.json` | 模型与方案声明 | 记录权重来源、版本和推理配置 | | `Dockerfile`、`requirements.txt` | 镜像及依赖 | 构建前确认基础镜像和权重交付方式 | | `REPORT.md`、`architecture.svg` | 报告与架构图 | 设计、跑测和限制详见报告 | 输入目录至少有 `prompt.txt`,可另有 `interface.txt`。`run.sh` 保证输出目录存在 `solution.v` 和 `trace.jsonl`;失败时 `solution.v` 可以为空,具体原因见 trace 和 `result.json`。 --- ## 二、怎么跑起来 以下步骤在具备赛事基础镜像、Vivado 和本地权重的云端实例上执行。`run.sh` 使用的 `python3` 应与安装依赖的 `/opt/python/bin/python3` 为同一环境。 ### 第 1 步:检查依赖 ```bash cd /workspace/48488_rtlagent source /workspace/env.sh /opt/python/bin/python3 -m pip install -r requirements.txt test -d /workspace/models/Qwen3.8-27B-AWQ-INT4 command -v xvlog command -v vivado ``` 当前 `Dockerfile` 中复制权重的 `COPY models/` 仍被注释。断网镜像重建前须确认权重已打入镜像,或由评测环境在启动前提供。 ### 第 2 步:启动本地模型 ```bash export MODEL=/workspace/models/Qwen3.8-27B-AWQ-INT4 export MAX_LEN=32768 MAX_SEQS=16 VRAM_BUDGET_GB=30 START_TIMEOUT_S=1800 ./serve/start.sh curl -fsS http://127.0.0.1:8000/v1/models ``` `start.sh` 以独立会话启动 vLLM,探活成功后返回;已有就绪服务时不会再起一份。 ### 第 3 步:单题运行与投题服务 ```bash export LLM_BACKEND=openai export LLM_BASE_URL=http://127.0.0.1:8000/v1 export LLM_API_KEY=dummy export LLM_MODEL=Qwen3.8-27B-AWQ-INT4 export MODEL_NAME=Qwen3.8-27B-AWQ-INT4 export LLM_MAX_NEW_TOKENS=8192 ./run.sh ./serve/run_api.sh start ./serve/run_api.sh status curl -i -H "Authorization: Bearer ${FPGACHINA_TOKEN}" http://127.0.0.1:7860/v1/health ``` `FPGACHINA_TOKEN` 从实例环境取得。`run_api.sh` 后台守护服务,主动停止用 `./serve/run_api.sh stop`;公网隧道仅暴露 7860。接口详情见 `serve/README.md`。 ### 另外:跑一次基线 ```bash ./run_baseline.sh ``` 基线使用相同的本地模型服务,但不使用智能体控制流和技能包。 --- ## 三、智能体的验证与修复流程 | 阶段 | 实现 | 能确认什么 | | --- | --- | --- | | 解析与路由 | `spec.py`、`skill_router.py` | 提取接口事实并选择生成提示 | | 生成与静态分析 | `llm.py`、`generate_first.py`、`rtl_structure.py` | 得到完整 RTL,提示结构问题 | | 编译与展开 | `xvlog`、`xelab` | 发现语法、声明及部分接口错误 | | 有界自检 | `self_tb.py`、`xsim` | 仅在期望值可靠时提供有限功能证据 | | 综合 | Vivado `synth_design` | 确认候选可综合,不证明功能正确 | | 修复与收尾 | `state_machine.py`、`retry.py` | 依阶段反馈修复,保留最佳候选并在预算耗尽时退出 | 参考测试台不会下发给正式解题过程;`spec_only` 辅助参考模型不是可执行 oracle。模型调用、技能选择、工具结果与停止原因记录在 `trace.jsonl`。 --- ## 四、环境变量 | 变量 | 当前默认值或部署值 | 说明 | | --- | --- | --- | | `MODEL` | `/workspace/models/Qwen3.8-27B-AWQ-INT4` | 本地权重路径 | | `LLM_BASE_URL` | `http://127.0.0.1:8000/v1` | 本地推理接口 | | `LLM_MODEL`、`MODEL_NAME` | `Qwen3.8-27B-AWQ-INT4` | 模型请求与健康检查名称 | | `LLM_API_KEY` | 本地服务设为 `dummy` | 模型接口鉴权字段 | | `LLM_MAX_NEW_TOKENS` | 镜像配置 `8192` | 智能体单次输出上限;基线另有固定上限 | | `MAX_LEN`、`MAX_SEQS` | `32768`、`16` | vLLM 上下文和并发序列数 | | `VRAM_BUDGET_GB` | `30` | 启动脚本换算显存利用率 | | `AGENT_MODEL_DEADLINE_SECONDS` | `780` | 停止新模型调用的单题截止时间 | | `AGENT_DEADLINE_S`、`AGENT_RESERVE_S` | `900`、`30` | 自检预算与收尾预留 | | `AGENT_SELF_TB_MIN_REMAINING_S` | `180` | 剩余时间不足时跳过自检 | | `LLM_SEED` | `42` | `run.sh` 按 `sN` 目录偏移 | | `EDA_TMP`、`AGENT_TMP` | 镜像配置 `/var/tmp/eda`、`/var/tmp` | 本地 EDA 工程和投题临时文件 | | `RTL_PART` | `xczu3eg-sbva484-1-e` | 综合目标器件,默认时钟周期 5 ns | | `FPGACHINA_TOKEN` | 无 | 投题令牌,不写入仓库 | `LLM_ENABLE_THINKING` 默认关闭,应与 `manifest.json` 一致。`run.sh` 在有 `XILINX_VIVADO` 时设置 `VIVADO_BIN`;Vivado 授权由实例环境提供。 --- ## 五、接下来可以做什么 当前主要限制是功能判定:编译与综合通过的 RTL 仍可能在外部参考仿真中停在 L1。应优先从题面能明确确定的复位、真值表、状态转移和计数边界构造可审计的逐拍检查,同时区分可靠失配、诊断信息与无判定结果。 技能包的收益需要在同模型、同题集、同工具版本下做逐卡开关对照。现有跑测、真实注入记录、失败样本与环境差异见 `REPORT.md`;不能把技能命中次数或内部综合通过数直接当作外部功能收益。