命令族
| 命令族 | 目的 |
|---|---|
fastsim config ... |
validate、expand、explain、diff、lock 与 verify-lock |
fastsim plugins ... |
不导入列出/检查已编译实例，或按需 diagnose factory |
fastsim run ... |
以已编译 Plan 启动 Application |
fastsim outputs ... |
在可信输出根内发现、检查、打开或清理产物 |
fastsim settings ... |
管理严格可选的用户设置 |
机器可读输出
自动化与 CI 应优先使用各命令的 --json 结果，并根据进程退出码判断成功。面向人的彩色文本不应被正则解析为协议。
配置检查
bash
fastsim config validate run.yaml --json
fastsim config expand run.yaml
fastsim config explain run.yaml scenario.scene.robots.arm.use
fastsim config lock run.yaml --output run.lock --json
插件诊断
plugins list 与 plugins inspect 读取编译元数据而不导入插件代码；plugins diagnose 只导入 Run 选中的 factory，用于定位安装、entry point 或契约错误。
输出安全
输出操作始终限制在解析后的可信根中。清理前先 inspect；不要把用户主目录、项目根或未解析环境变量作为递归删除目标。输出完整性由 staging、校验、原子发布与失败清理共同保证。