---
docStatus: current
---

# 命令层级与能力发现

区分工作区管理、Bundle 作者资源和 Runtime 当前可调用能力。

业务入口按 `workspace`、`runtime`、`bundle` 组织，认证使用 `auth`。
准确命令与参数以安装版本的 `baijimu --help` 及逐级帮助为准；历史 CLI 的固定版本文档继续保留原命令。

| 入口          | 对象                                |
| ----------- | --------------------------------- |
| `workspace` | 工作区、源码项目和 Git、现有构建、设备、数据库与支撑资源    |
| `bundle`    | Bundle 作者定义、资源开发、不可变版本与分发         |
| `runtime`   | Runtime 实例、实际 Bundle 和资源、可调用服务及会话 |

## 发现可调用能力

`runtime list` 返回运行实例。查询可调用模块和方法使用 `runtime service`，按模块目录、方法目录、单方法合同逐级读取：

| 命令                                                       | 返回内容                           |
| -------------------------------------------------------- | ------------------------------ |
| `runtime service list`                                   | 所选 Runtime 的模块标识、名称和用途，不包含方法列表 |
| `runtime service get <businessId>`                       | 指定模块的方法名称和用途摘要，不包含参数和返回定义      |
| `runtime service get <businessId> --method <methodName>` | 指定方法的完整参数和返回定义，不附带其他方法         |

```bash
baijimu runtime service list --workspace-id <workspaceId>
baijimu runtime service get <businessId> --workspace-id <workspaceId>
baijimu runtime service get <businessId> --workspace-id <workspaceId> --method <methodName>
baijimu runtime service call <businessId> <methodName> --workspace-id <workspaceId> --params @parameters.json
```

未指定 `--application-runtime-id` 时选择该工作区的默认 Runtime。
需要限定一个 Bundle 时，同时提供 `--environment-key` 和 `--bundle-id`；它们是可选筛选条件。
`list --keyword` 可按模块信息或方法关键字定位模块，结果仍只返回模块目录；选择模块后再读取它的方法目录。
先读取方法合同，再按定义组织参数。服务发现失败保持显式错误，不能当作不存在相应能力。

## 实际资源与安装记录

```bash
baijimu runtime bundle list --workspace-id <workspaceId> --application-runtime-id <applicationRuntimeId>
baijimu runtime bundle resource list --workspace-id <workspaceId> --environment-key <environmentKey> --bundle-id <bundleId> --resource-type MODULE --all
baijimu runtime bundle installation list --workspace-id <workspaceId>
```

当前 Bundle 来源由资源 Owner 的实际库存汇总。Bundle 资源查询限定完整来源身份，资源版本和归属同样由对应 Owner 返回。
`installation` 查询安装记录、安装状态与审计；安装记录缺失或失败不代表 Owner 中没有资源。
任一实际库存 Owner 查询失败时返回错误，不以安装账或空列表代替。

## Bundle 作者资源

作者操作统一位于 `bundle resource`：Module、Skill、Workflow、Timer、Object 和 Platform Application
保留各自的作者协议与参数，使用相应资源类型子命令。登记通用作者协议的资源类型使用
`bundle resource list/create/get/update/version`，通过 `--resource-type` 选择。

Runtime 的资源操作位于 `runtime bundle resource`。应用用户重新授权属于应用使用流程；
内部资源凭据轮换不再提供普通用户 CLI 命令。

## 构建范围

当前版本只归组既有构建命令，保留 React 与 Rust 的现有请求合同。
项目类型 command 的定义、执行器绑定和统一构建路由暂未调整；不能据此推断项目服务已提供通用 command API。