核心概念

在你深入之前，这是一份 Subaya 的简短心智地图。

CLI 优先

suya CLI 是主要接口——服务于人类、AI agent 和 CI。位于 subaya-dev.com 的 Web 控制台用于结果：波形、报告、项目管理和审查。而思考的部分——设计、仿真、验证——通过 CLI 以及驱动它的 agent 来发生。

suya 之于 subaya-dev.com，正如 gh 之于 github.com。

租户层级：org → workspace → project

• 组织 — 你账户的顶层租户。计费、成员和许可证都在这里。
• 工作区 — 组织内项目的分组（例如一个团队或一条产品线）。
• 项目 — 工作单元：一个带类型（fpga 或 embedded）的设计，拥有自己的需求、仿真、仓库和阶段。

项目类型

类型	用于	工具链
fpga	RTL / FPGA 设计	RyuSim、Verilator、Icarus、Questa、Vivado xsim、Quartus
embedded	MCU 固件（例如 STM32）	CubeMX 引脚规划、Renode

阶段

每个项目都会经历一系列阶段，这些阶段塑造 UI 和可用的工具：

概念 → 规划 → 实现 → 仿真 → 验证

使用 suya project phase 获取或设置当前阶段。

云端托管的工具

繁重的工具在 Subaya 的后端运行，而非你的笔记本：Quartus、RyuSim、Renode、 BitCrucible，以及一个无头 CubeMX 引擎。你通过 CLI 驱动它们，并且只为你使用的计算秒数 付费——参见计费与用量。

认证

两种模式，详见认证与 API 密钥：

• SUBAYA_API_KEY — 用于 agent 和 CI，无需浏览器。
• suya auth login — 面向人类开发者的 OAuth 浏览器流程。