CLI

Aura CLI 是用于操作 AuraBoot 项目的命令行工具。它适用于本地开发、Plugin 校验、Plugin 发布、运行时检查与自动化脚本等场景。

常用命令

aura login
aura status
aura plugin validate plugins/my-plugin
aura plugin publish plugins/my-plugin --yes
aura query <modelCode>
aura exec <commandCode>

认证

交互式使用：

aura login

在脚本与 CI 中使用 token：

export AURA_TOKEN="<jwt>"
aura status

常用环境变量：

变量	用途
`AURA_API_URL`	后端 base URL
`AURA_TOKEN`	用于非交互式认证的 JWT token
`AURA_USER`	用于非交互式登录的用户名
`AURA_PASSWORD`	用于非交互式登录的密码
`AURA_DEBUG`	输出 debug 信息

健康检查

aura status

请在 Plugin 导入或自动化测试前执行此命令。它应当能确认后端可达且 token 有效。

Plugin 工作流

aura plugin validate plugins/project-tracker
aura plugin publish plugins/project-tracker --yes

应在 publish 之前先运行 validate，它能比手工 UI 测试更早地发现资源引用问题。

查询与 Command 执行

使用 query 命令检查数据：

aura query crm_lead --limit 10

使用 Command 执行命令在不点开 UI 的情况下测试后端行为：

aura exec crm:create_lead --set lead_name="Acme" --set source="website"

适合 Agent 的输出

对于自动化与 AI Agent 的工作流，请在可用时优先选择 JSON 输出。相比表格输出，JSON 更易解析且更稳定。可通过全局 --format json（或 --agent-mode）切换为 JSON 输出。

aura status --format json
aura query crm_lead --format json

MCP 服务

AuraBoot 可向兼容 MCP 的客户端暴露运行时工具：

aura mcp serve

请仅在已正确认证的环境中使用。工具调用应保持 Tenant 范围限定并可审计。

故障排查

现象	检查项
`401 Unauthorized`	Token 过期或选错了 Tenant
`Connection refused`	后端 URL 或服务状态
Plugin 本地校验通过但导入失败	运行时 schema 或引用不匹配
发布后菜单缺失	Permission 或角色 bootstrap 分配
CI 中输出不同	环境变量与工作目录

CLI