百积木文档
CLI

命令层级与能力发现

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

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

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

发现可调用能力

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

命令返回内容
runtime service list所选 Runtime 的模块标识、名称和用途,不包含方法列表
runtime service get <businessId>指定模块的方法名称和用途摘要,不包含参数和返回定义
runtime service get <businessId> --method <methodName>指定方法的完整参数和返回定义,不附带其他方法
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 可按模块信息或方法关键字定位模块,结果仍只返回模块目录;选择模块后再读取它的方法目录。 先读取方法合同,再按定义组织参数。服务发现失败保持显式错误,不能当作不存在相应能力。

实际资源与安装记录

baijimu runtime bundle list --workspace-id <workspaceId>
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。

本页内容