01 · OVERVIEW
60秒理解VeriX
VeriX是芯片前端设计与验证的Agentic AI工作系统。工程师给出规格,系统交付可综合的RTL、测试台、验证报告和验收追溯,并用真实EDA工具做客观判定。
生成不是终点。只有lint、仿真、综合和形式验证能给出通过结论。VeriX把“生成→验证→首错修复→重跑”做成默认循环。
当前生产可用阶段:lint、编译、仿真、综合、形式验证、逻辑等价。P&R与OpenROAD接入为预览能力,不在默认签核链路内。
02 · SURFACES
四种入口,同一套内核
四端共享技能、MCP配置与设计规范。Web端按用户隔离容器与工作目录;本地端项目留在本地。
| 入口 | 启动方式 | 适合 |
|---|---|---|
| Web | 浏览器打开托管地址 | 零安装试用、团队共享、统一配额 |
| Desktop | 桌面应用 | 本地项目、长会话、完整Diff |
| CLI / TUI | verix | 终端工作流、脚本、CI |
| VS Code | 扩展面板 | 编辑器内看Diff、跑检查、管会话 |
Web托管环境与本地端数据隔离;私有化部署时,四端都指向客户内网的同一套服务。
03 · QUICKSTART
快速开始
-
确认客户端可用
从离线包安装后,终端里应能直接运行
verix。从源码运行时使用仓库脚本。bash$ verix --version verix 1.0.0 # 源码运行 $ bun run bin/verix --version -
进入项目目录
VeriX以工作目录为边界。进入项目根目录再启动,设计产物会落在当前目录。
bash$ cd ~/silicon/tensorcore $ verix -
给一条可验证的任务
不要只说“写一个TensorCore”。给出Spec、目标阶段和验收条件,系统才能生成可检查的循环。
prompt读 spec_tensorcore.md(16×16×16 INT8/FP16)。 先对齐验收标准,再实现RTL和测试台; 跑到VCS回归、2132/0和55nm综合通过,最后打设计包。 -
打开设计包
任务完成后,工作目录下会生成设计包。先看
README.md和manifest.sha256,再按需展开报告。bash$ tar --zstd -xf design-package.tar.zst $ cd design-package $ ls README.md rtl/ tb/ reports/ acceptance-criteria.md manifest.sha256
04 · MODELS
连接你自己的模型API
应用不预置任何厂商的API端点或密钥。你需要在设置里提供自己的端点、协议与模型ID。
| 字段 | 说明 |
|---|---|
| Base URL | 协议根路径,不要包含/v1/messages等具体资源路径。 |
| Protocol | Anthropic Messages、OpenAI Chat Completions、OpenAI Responses。 |
| Model | 端点实际支持的模型ID。 |
| API Key | 保存在本机或客户环境;Web托管模式由管理员集中配置。 |
Provider Custom
Base URL https://api.example.com/anthropic
Protocol Anthropic Messages
Model your-model-id
API Key sk-...
先点“Test connection”验证端点,再开始会话。401通常是密钥无效;404通常是协议或Base URL不匹配。
05 · EDA
接入公司自己的EDA
VeriX通过MCP网关调用EDA工具。工具部署在服务端或客户内网,客户端零安装;每次调用都记录命令、argv、stdout、stderr和产物。
通过HTTP接入
$ verix mcp add --transport http eda https://<gateway>/mcp \
--header "Authorization: Bearer <token>"
$ verix mcp list
$ verix mcp get eda
通过stdio接入本地MCP
$ verix mcp add eda-local -- /path/to/eda-mcp
当前网关提供24个Synopsys命令的白名单直连,包括vcs、dc_shell、pt_shell、fm_shell、spyglass、verdi等;同时支持开源工具链阶段。
商用EDA工具与license归客户所有。VeriX只做集成、编排和证据留存,不转售工具,不绕过厂商授权。
06 · SKILLS
技能与知识是资产,不是隐藏提示词
技能是一个目录加一份SKILL.md。可以随项目版本化、审查、复制和二次开发。
<skills-root>/<skill-name>/
├── SKILL.md # frontmatter + 使用说明
├── references/ # 手册、协议、检查清单
└── scripts/ # 可选脚本
- hisilicon-asic-engineer-handbook:数字设计手册与规则,设计决策引用到章节页码。
- verix-rtl-workflow:从Spec到RTL、验证、综合的内置工作流。
- frontend-spec-extraction / frontend-rtl-gen / spec-to-testplan:规格提取、RTL生成与测试计划。
内置12份L4级芯片设计Spec,覆盖DDR3、NoC、UCIe、PagedKV、NTT等模块,可作为任务起点。
07 · ARTIFACTS
一次任务的产物
VeriX交付的是设计包,不是聊天记录。目录结构固定,产物带校验和,命令与日志一起归档。
design-package/
├── README.md # 任务、阶段、结论
├── rtl/ # 可综合RTL
├── tb/ # 测试台与断言
├── reports/
│ ├── lint.log
│ ├── sim.log
│ ├── area.rpt
│ └── timing.rpt
├── acceptance-criteria.md # 验收追溯矩阵
├── run.log # 命令与工具调用
└── manifest.sha256 # 产物校验和
如果项目启用了Git治理,提交信息会携带Task、Role、Checklist、Status脚注,仓库本身成为审计档案。
08 · SESSIONS
会话与工作目录
每个会话有独立工作目录。托管环境下,每个用户有独立容器;工作目录之外默认拒绝访问,技能与规格目录精确放行。
- 独立容器:read-only root、cap-drop ALL、bwrap沙箱。
- 目录边界:
session-<id>工作目录,越界即拒。 - 配额与并发:按账户配置额度与并发,EDA worker有超时与重试。
- 单账号单会话:后登录会挤掉前一个会话,避免共享账号并发。
09 · PRIVATE DEPLOYMENT
私有化部署
整套服务可以部署在客户内网:网关、引擎、EDA worker、MCP服务、对象存储。模型接客户自有API,或在本地部署。
交付形态
- Docker Compose单机部署,适合试用与小团队。
- 按并发规模拆分网关、引擎与EDA worker。
- 离线包包含CLI、Desktop与OpenROAD构建产物。
- 可选本地模型或客户API;不绑定厂商。
上线前确认
- 商用EDA安装介质与license server。
- 模型端点、密钥与出口网络策略。
- 存储容量、备份与升级窗口。
- 账号体系与权限边界。
工具与license留在客户环境;客户端零安装;升级不改变客户代码仓库与设计数据的所有权。
10 · DATA & PRIVACY
数据与隐私
数据采集需要显式同意,首次启动会显示完整说明;可以拒绝,也可以随时关闭。采集用于改进harness与评测,不用于向第三方转售数据。
- 采集范围:会话、工具调用、EDA检查、修复事件、任务结果等结构化记录。
- 脱敏:IP地址默认掩码;不采集license文件与密钥。
- 存储:客户环境内存储,或客户指定的对象存储;支持导出与删除。
- 关闭:设置中可关闭采集;关闭后不影响设计功能。
托管试用环境与私有化环境使用不同的数据平面。具体条款以签署的隐私政策与合同为准。
11 · TROUBLESHOOTING
故障排查
| 现象 | 先检查 | 处理 |
|---|---|---|
| 模型请求401 | API Key与账号余额 | 重新保存密钥,确认端点支持该模型 |
| 模型请求404 | Protocol与Base URL | Base URL只写到协议根路径,切换正确协议 |
| MCP连接失败 | 网关地址、token、网络 | 用verix mcp get核对配置,检查出口策略 |
| 工具权限被拒绝 | 工作目录边界 | 进入项目目录,或把目录加入允许范围 |
| EDA busy / timeout | worker并发与超时 | 降低并发、提高超时,或重跑失败阶段 |
仍有问题?把run.log、会话ID和复现命令发给support@verixchip.com。
这份文档会随版本更新。发现不准确的地方,欢迎直接反馈。
反馈文档问题