Altifigence CLI

安装已签名的 Linux CLI,并选择原生 XLS、CUDA、DDS 或范围明确的 Cloud 操作。

概览

Altifigence CLI 提供本地设计引擎、Digital Design Studio 工作区操作,以及连接 Cloud 或已配置工作区服务的明确路径。此处描述的安装契约适用于Linux x86_64 上的 0.1.9。请检查官方下载页面了解发布可用情况;本指南不宣告版本推广发布。

下载与解压

首先验证归档文件与公共信任材料。运行任何下载的可执行文件(包括安装程序)前,验证 Ed25519 签名和固定公钥摘要。然后按照在 Linux 上安装操作:alti release install使用内置发布辅助程序创建已认证安装。它需要 Linux root 权限,不访问网络或构建,也不需要源代码检出。

载荷包含 26 个可执行文件:alti、alti-mcp及 24 个引擎运行器。安装程序将其契约、已签名目录和凭据放在一起。请运行已安装的PREFIX/bin/alti;仅复制一个二进制文件或手工制作凭据不会形成可信安装。

首次成功运行

安装并将PREFIX/bin加入您的PATH后:

Bash
alti version
alti capabilities
alti xls capabilities
alti ide workspace capabilities

CLI 首次成功运行包括一个小型本地 CPU XLS 计算和可选的离线作业预检。两者都不需要 Cloud 凭据。能力发现报告可用性和约束。请通过执行凭据和工作负载资格验证结果确认 GPU 内核或设计作业确实运行。

随附内容

接口

用途

xls

限定范围的原生 DSLX/XLS IR 检查、计算、优化、RTL 生成及结果存储

xls upstream

安装并使用独立固定版本的 Google XLS CPU 工具链,以获得更广泛的 DSLX 语言支持

compute

设备发现、显式 CPU/CUDA 打包 RTL 执行、限定范围的 Evolve 活动及结果验证

rtl、sv、physical、px、isa、evolve

各自具有输入和分析限制的本地引擎操作

ide init、ide workspace

项目创建、已保存文件、持久化编写计划、设置、Git 和本地搜索

ide cloud

浏览器 PKCE 登录、已验证身份、限定范围的 Cloud 工作区操作、已保存源代码搜索及终端连接

ide service

针对明确配置的旧版 DDS HTTP 服务的类型化操作,包括搜索和 CAS 替换

tcl evaluate

使用已安装且已签名的 Tcl 运行时组件进行限定范围计算

commands、job validate

操作清单发现及离线作业/源文件预检

设置 ALTI_MCP_MODE=local-xls,并运行 alti-mcp 或 alti mcp serve,以使用五个本地 XLS 工具。

当前限制

原生 XLS 计算限定范围的 1–64 位子集。Google XLS 路径根据所选上游工具支持导入、参数化、聚合类型和 proc;可选 IR/proc 求值器需要另行验证的软件包。两种路径都不保证每个 DSLX 设计都能综合或在 CUDA 上运行。

XLS 和打包 RTL 的 CUDA 使用必须明确指定。Evolve 使用 CUDA 进行限定范围的组合逻辑活动诊断;候选生成、正确性检查和搜索目标仍在 CPU 上处理。该工作流需要 Icarus。不承诺加速或通用 GPU/驱动资格验证。

原生 DDS 变更和安装程序属于 Linux 操作。浏览器面板、未保存编辑器缓冲区、Cloud 工作区和本地目录是不同上下文。请使用各后端自己的身份、权限和冲突证据。

ide cloud login是受支持的原生 Cloud 登录路径。旧的顶层login和whoami命令仍会拒绝未验证身份。账户成员资格和服务权限仍由服务器决定;安装 CLI 不会授予桌面许可证或 Cloud 授权。

继续查看命令参考、命令接口、引擎命令以及作业与 Cloud 命令。

升级现有安装

  1. 记录当前 CLI 版本和安装前缀。

  2. 下载新归档文件及其对应目录/签名材料并验证真实性。

  3. 对于 0.1.9,使用受支持的发布卸载程序移除现有 CLI 安装,然后使用Linux 安装中的已验证安装程序。保留项目文件和共享 Tcl 运行时。

  4. 运行已安装二进制文件,检查能力,并重复小型 CPU 示例。

  5. 在新安装通过检查之前,保留先前已验证的安装程序和项目文件。

CLI 更新不会更新独立安装的 DDS 桌面应用或外部工具链。在 CI 中,固定并验证准确的发布输入,不要依赖某个alti恰好最先出现在PATH。