Поверхность команд CLI — Altifigence Documentation

Узнайте, как поставляемый alti направляет командную строку, какие пространства имен доступны в этом выпуске, что означают коды выхода и где выполняется каждая команда.

Обзор

Эта страница индексирует нативный CLI, манифест пользовательских действий и соединения отдельных бэкендов. Используйте Команды движка для локального проектирования и Команды заданий и Cloud для сервисных операций. Примеры относятся к интерфейсу 0.1.9.

Два парсера, один исполняемый файл

Нативный парсер обрабатывает release, capabilities, rtl, sv, verification, trace, labs, tcl, eidb, eda, reports, physical, px, isa, ide, job, xls, а также compute. Он также обрабатывает analyze run и явные формы Evolve capabilities, analyze, run, cx-search, measured-ppa, а также artifact. Остальные пользовательские команды используют встроенный манифест действий. mcp serve запускает сервер MCP через stdio.

Что исключает эта маршрутизация

eda inspect, reports parse, ide init, а также перечисленные формы Evolve — маршрутизируемые нативные команды. Их доступность больше не ограничивается пропусками диспетчеризации старого архива. Возможности движка по-прежнему определяют поддерживаемые входы и операции.

Однословное пользовательское действие evolve отдельно от нативных evolve run и compute rtl-evolve. Их схемы запросов не взаимозаменяемы. Однословное действие манифеста trace по-прежнему перекрывается нативным пространством имен trace; используйте нативные подкоманды, не предполагая, что перечисление в манифесте гарантирует соответствующее написание CLI.

Глобальные флаги

Используйте ведущий --json для нативного структурированного вывода, например alti --json xls capabilities. Ставьте его перед пространством имен или после полной нативной подкоманды, а не между словами маршрутизируемой формы Evolve. Используйте alti --help для общей сводки и --help у конечной операции для допустимых аргументов и ограничений. Нативные конечные команды также принимают -h.

Вывод JSON зависит от команды. Конверты движка содержат результат дочернего процесса как строку, сервисные команды возвращают подтверждения, а подключения терминала передают поток байтов. См. Справочник команд.

Мета-команды и команды учетной записи

Команда	Поведение
`alti` `version`, `alti` `--version`	Вывести версию CLI
`alti` `commands`	Вывести манифест из 25 пользовательских действий
`alti` `capabilities`	Исследовать аутентифицированную установку и ее возможности
`alti` `auth` `status`	Сообщить конфигурацию среды без проверки идентичности сервера
`alti` `login`, `alti` `whoami`	Устаревшие команды верхнего уровня отклоняют непроверенную идентичность с кодом выхода `4`
`alti` `logout`	Устаревшая команда не может удалить учетные данные, унаследованные от родительского процесса
`alti` `ide` `cloud` `login`	Запустить нативный браузерный процесс PKCE и сохранить частную сессию CLI
`alti` `ide` `cloud` `whoami`	Запросить у сервера текущую идентичность сессии
`alti` `ide` `cloud` `refresh`, `alti` `ide` `cloud` `logout`	Обновить или отозвать нативную сессию CLI
`alti` `mcp` `serve`	Обслуживать MCP через stdio в выбранном пользовательском или локальном режиме XLS

Сессии Cloud и устаревшие учетные данные среды различны. См. Аутентификация CLI.

Коды выхода

Считайте каждый ненулевой результат ошибкой, если контракт конкретной команды не определяет восстановление. Разбор и допуск обычно возвращают 2, ошибки среды и HTTP — 1, недоступные движки — 127, а недопустимое установленное выполнение или сбои запуска — 126. Движки могут передавать собственные коды. Пользовательский манифест отдельно использует 3 для отклонения класса и 4 для отказа до диспетчеризации. Один номер состояния не определяет его источник.

Где выполняются операции

Поверхность	Выполнение и полномочия
`xls`, `compute`, типизированные команды локального движка	Упакованные нативные движки на текущей машине
`xls` `upstream`	Отдельно установленные закрепленные инструменты Google XLS на текущей машине Linux
`ide` `workspace`	Выбранный локальный каталог, включая восстановление и сериализованные нативные изменения
`ide` `cloud`	Нативные маршруты API с выданной браузером bearer-сессией и проверяемыми сервером разрешениями организации/проекта
`ide` `service`	Выбранный оператором устаревший HTTP-сервис DDS с существующим контрактом сервисного секрета
`job` `validate`	Только офлайн-проверка исходного кода и конверта
`job` `...` `--runner` `cloud`, `analyze` `run`	Настроенный сервис заданий Cloud с учетом готовности и разрешений
Пользовательский MCP по умолчанию	Диспетчеризация клиента Cloud; транспорт stdio не делает выполнение локальным
`ALTI_MCP_MODE=local-xls` MCP	Фиксированные локальные инструменты XLS без пользовательской диспетчеризации Cloud

Какие подкоманды имеют –runner

Команды совместимости rtl compile, rtl synthesize, physical run, px analyze, а также isa run по умолчанию используют local. Выбор cloud или private в этих командах создает каркасный план диспетчеризации; это не удаленное выполнение. Их аргументы движка -- принимаются только для локальной диспетчеризации.

У семейства job параметр --runner выбирает Job Service и является другим контрактом. Удаленный адаптер alti-engine-job отсутствует в составе выпуска с 24 исполнителями; не считайте принимаемый синтаксис local/private предоставленным сервисом.

Как находится локальный движок

Сохраняйте установленный выпуск целым. XLS, compute, упакованный RTL, нативный DDS и типизированные пути PX/CX требуют своего соседнего исполняемого файла. Проверка доверия установки связывает защищенные исполнители с хэшами каталога и подтверждениями; ни резервный PATH, ни пользовательское подтверждение не исправляют эту границу. Старые механизмы разрешения совместимости могут сообщать sibling или path; изучайте подтверждение именно выполненной операции. Внешние инструменты, например Icarus, имеют отдельную конфигурацию хоста.

Какой движок обслуживает пространство имен

Поставка содержит alti, alti-mcp, а также следующие 24 исполнителя движков:

Команды	Упакованные движки
RTL, анализ, SV, проверка	`alti-rtlc`, `alti-rtl`, `alti-rtl-analyze`, `alti-sv-frontend`, `alti-sv-immediate-review`, `alti-sv-interprocess-review`, `alti-golden-diff`
ISA, Evolve	`alti-cx`, `alti-evolve`
Физическое проектирование, PX	`alti-physical-runner`, `alti-px-runner`, `alti-px-sta-graph-check`
Трассировка, Labs	`alti-trace`, `alti-lab`
Tcl, EIDB, EDA, отчеты	`alti-tcl`, `alti-tcl-local-runner`, `alti-eidb-local-runner`, `alti-eda-artifact-inspect`, `alti-reports`
XLS и вычисления	`alti-xls`, `alti-compute`, `alti-packed-cuda`, `alti-rtl-cuda`
Нативный DDS	`alti-ide-workspace`

alti-rtl-runner не поставляется. Команды совместимости с зафиксированной идентичностью, запрашивающие его, не получают поддержку лишь из-за наличия справки. Настольный исполняемый файл, используемый ide open, распространяется отдельно.

Конверты подтверждений

Схема или вывод	Толкование
`altifigence.local-engine-execution.v1`	С `--json` — команда, исполняемый файл, разрешение, состояние, `exitCode`, а также захваченные потоки движка
`altifigence.cli.engine-job-preflight.v1`	Офлайн-проверка; `submitted` и `server_authority_verified` остаются false
`altifigence.cli.tcl-evaluation.v1`	Ограниченный результат установленного вычисления Tcl
`altifigence.ide-launcher-receipt.v1`	Состояние запуска настольного процесса, а не доказательство завершения загрузки проекта
`altifigence.dds.service-receipt.v1`	Состояние HTTP устаревшего сервиса и ограниченное тело ответа
`altifigence.cli.release-bootstrap.v1`	Состояние завершения установщика/деинсталлятора с диагностикой помощника в stderr
stdout терминала Cloud	Поток байтов терминала, а не одно подтверждение JSON

Поле конверта движка stdout — строка с нативным результатом. Без --json этот нативный вывод можно сохранить напрямую и целиком передать подходящей команде применения DDS. Никогда не сокращайте план редактирования до одного хэша.

Переменные среды

Переменная	Область
`ALTI_TOKEN`, `ALTI_ORG_ID`	Учетные данные устаревшего клиента пользовательских действий/заданий и область организации
`ALTI_API_BASE`	Переопределение адреса устаревшего API; по умолчанию `https://api.altifigence.com`
`ALTI_BYO`	Выбор типа устаревшего субъекта; не разрешение на выполнение
`ALTI_ALLOW_SOURCE_UPLOAD`	Согласие на загрузку исходного кода для пользовательских действий MCP
`ALTI_MCP_MODE`	`customer` по умолчанию или явный `local-xls`
`ALTI_STUDIO_ENDPOINT`	Явный адрес устаревшего сервиса DDS; нативный Cloud использует собственные аргументы конечной точки/сессии
`ALTI_STUDIO_SERVICE_SECRET`	Существующая аутентификация устаревшего сервиса; не нативная bearer-сессия Cloud
`ALTIF_RTL_IVERILOG`, `ALTIF_RTL_VVP`	Управляемые хостом расположения внешних инструментов Icarus для нативного вычислителя RTL

Нативный Cloud использует --session-dir, по умолчанию ~/.local/state/altifigence/cloud-cli. Не копируйте в него файлы настольных сессий, не записывайте токены в журналы и не отправляйте сервисные секреты произвольным конечным точкам.

Результаты движка

Читайте фактический результат движка и его ограничения. Обнаружение GPU не означает выполнение на GPU, дайджест содержимого не является подписью, а оценка временных характеристик без signoff не является signoff реализации. Следующая страница перечисляет соответствующие команды движка.

Разрешите команду перед написанием скрипта

alti --version
alti --help
alti ide cloud --help
alti xls run --help

Проверьте справку именно конечной операции, которую собираетесь вызвать. Совпадающее имя в alti commands не заменяет справку нативного парсера, установленные возможности или доступность среды. Храните версию CLI вместе со скриптами, поскольку схемы запросов и подтверждения версионируются.