DOCUMENTATION · V1.0

把一条Spec,
跑成可评审的设计包。

安装、配置、EDA接入与私有化部署。这里只写产品当前的真实能力;预览能力会单独标注。

更新于2026-11 适用于Web / Desktop / CLI / VS Code 文档反馈

01 · OVERVIEW

60秒理解VeriX

VeriX是芯片前端设计与验证的Agentic AI工作系统。工程师给出规格,系统交付可综合的RTL、测试台、验证报告和验收追溯,并用真实EDA工具做客观判定。

工程事实

生成不是终点。只有lint、仿真、综合和形式验证能给出通过结论。VeriX把“生成→验证→首错修复→重跑”做成默认循环。

01Spec验收条目
02RTL可综合代码
03Verify工具判定
04Package设计包

当前生产可用阶段:lint、编译、仿真、综合、形式验证、逻辑等价。P&R与OpenROAD接入为预览能力,不在默认签核链路内。

02 · SURFACES

四种入口,同一套内核

四端共享技能、MCP配置与设计规范。Web端按用户隔离容器与工作目录;本地端项目留在本地。

入口启动方式适合
Web浏览器打开托管地址零安装试用、团队共享、统一配额
Desktop桌面应用本地项目、长会话、完整Diff
CLI / TUIverix终端工作流、脚本、CI
VS Code扩展面板编辑器内看Diff、跑检查、管会话

Web托管环境与本地端数据隔离;私有化部署时,四端都指向客户内网的同一套服务。

03 · QUICKSTART

快速开始

  1. 确认客户端可用

    从离线包安装后,终端里应能直接运行verix。从源码运行时使用仓库脚本。

    bash
    $ verix --version
    verix 1.0.0
    
    # 源码运行
    $ bun run bin/verix --version
  2. 进入项目目录

    VeriX以工作目录为边界。进入项目根目录再启动,设计产物会落在当前目录。

    bash
    $ cd ~/silicon/tensorcore
    $ verix
  3. 给一条可验证的任务

    不要只说“写一个TensorCore”。给出Spec、目标阶段和验收条件,系统才能生成可检查的循环。

    prompt
    读 spec_tensorcore.md(16×16×16 INT8/FP16)。
    先对齐验收标准,再实现RTL和测试台;
    跑到VCS回归、2132/0和55nm综合通过,最后打设计包。
  4. 打开设计包

    任务完成后,工作目录下会生成设计包。先看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等具体资源路径。
ProtocolAnthropic 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和产物。

CLIDesktopWebVS Code
VeriX Engine会话 · 技能 · 权限
EDA MCP Gateway白名单 · 审计 · 实时日志
VCSDCVerilatorYosysOpenROAD

通过HTTP接入

bash
$ verix mcp add --transport http eda https://<gateway>/mcp \
    --header "Authorization: Bearer <token>"

$ verix mcp list
$ verix mcp get eda

通过stdio接入本地MCP

bash
$ 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
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

故障排查

现象先检查处理
模型请求401API Key与账号余额重新保存密钥,确认端点支持该模型
模型请求404Protocol与Base URLBase URL只写到协议根路径,切换正确协议
MCP连接失败网关地址、token、网络用verix mcp get核对配置,检查出口策略
工具权限被拒绝工作目录边界进入项目目录,或把目录加入允许范围
EDA busy / timeoutworker并发与超时降低并发、提高超时,或重跑失败阶段

仍有问题?把run.log、会话ID和复现命令发给support@verixchip.com。

这份文档会随版本更新。发现不准确的地方,欢迎直接反馈。

反馈文档问题