1c837766cd
Add backend-driven assembly and simulation experiences, MAKE branding, mobile rendering budgets and desktop-only CAD/PCB routes. Improve logo loading progress, document image recovery and URDF request handling; include dev packaging and regression coverage.
606 lines
18 KiB
JSON
606 lines
18 KiB
JSON
{
|
|
"uiSpecVersion": 3,
|
|
"status": "implementation_contract_not_integrated",
|
|
"scope": "后台最低必传 + 选填功能,前台按已发布能力适配;这是交接配置,不是运行包或已上线接口。",
|
|
"normativeDocument": "../admin-walking-upload-generic-spec.md",
|
|
"defaultTitle": "行走演示",
|
|
"defaultDescription": "基础行走只需准备下面四项。其他动作按需添加,不用全部上传。",
|
|
"moduleOptional": true,
|
|
"selectionMode": "explicit_capability_selection",
|
|
"inferCapabilitiesFromRobotNameOrFilename": false,
|
|
"currentBaselineMode": "mjcf_onnx",
|
|
"minimumUploadSet": [
|
|
{
|
|
"id": "robot_config",
|
|
"label": "机器人控制配置",
|
|
"requirement": "required",
|
|
"entry": "robot.json",
|
|
"preparedBy": "机器人模型/算法工程提供;可由后台工具辅助配置",
|
|
"contents": [
|
|
"物理模型路径与依赖映射",
|
|
"关节对应关系与默认姿态",
|
|
"观测和动作契约",
|
|
"执行器及控制时序",
|
|
"基础行走技能",
|
|
"渲染方式与输入绑定"
|
|
]
|
|
},
|
|
{
|
|
"id": "physics_model",
|
|
"label": "物理模型 XML",
|
|
"requirement": "required",
|
|
"format": "mjcf",
|
|
"pathSource": "robot.model",
|
|
"fixedFilename": false
|
|
},
|
|
{
|
|
"id": "model_dependencies",
|
|
"label": "模型引用文件",
|
|
"requirement": "required_if_referenced",
|
|
"contents": [
|
|
"网格",
|
|
"贴图",
|
|
"include",
|
|
"递归引用资源"
|
|
],
|
|
"fixedCount": null,
|
|
"zeroFilesAllowedIfNoExternalReferences": true,
|
|
"validation": "配置映射与物理模型 VFS 的完整依赖闭包"
|
|
},
|
|
{
|
|
"id": "walk_policy",
|
|
"label": "基础行走策略",
|
|
"requirement": "required",
|
|
"format": "onnx",
|
|
"minimumPrimaryControllers": 1,
|
|
"initialGenericPrimaryControllers": 1,
|
|
"pathSource": "walk 能力绑定的 primary 技能 controller.policy",
|
|
"fixedFilename": false,
|
|
"validation": "同一机器人的控制配置、真实输入输出及运行效果匹配"
|
|
}
|
|
],
|
|
"platformProvided": [
|
|
{
|
|
"id": "publish_manifest",
|
|
"label": "发布清单",
|
|
"source": "后台生成",
|
|
"userUploadRequired": false,
|
|
"contents": [
|
|
"入口",
|
|
"发布功能",
|
|
"资源路径",
|
|
"实际字节数",
|
|
"SHA256",
|
|
"版本"
|
|
]
|
|
},
|
|
{
|
|
"id": "basic_scene",
|
|
"label": "基础场景",
|
|
"source": "平台内置",
|
|
"userUploadRequired": false,
|
|
"contents": [
|
|
"地面",
|
|
"灯光",
|
|
"相机",
|
|
"暂停与重置界面"
|
|
]
|
|
},
|
|
{
|
|
"id": "football",
|
|
"label": "标准足球",
|
|
"source": "平台内置外观及固定版本物理预设",
|
|
"userUploadRequired": false,
|
|
"userConfigurationRequiredIfUsed": "选择与该策略兼容且已验证的预设"
|
|
}
|
|
],
|
|
"notUniversallyRequired": [
|
|
"整机 GLB",
|
|
"kinematics.json",
|
|
"单独 controller.json",
|
|
"足球 GLB",
|
|
"球场素材",
|
|
"踢球策略",
|
|
"翻滚策略",
|
|
"起身策略",
|
|
"训练源码",
|
|
"训练日志"
|
|
],
|
|
"optionalCapabilities": [
|
|
{
|
|
"id": "head",
|
|
"label": "头部摆动",
|
|
"requires": [
|
|
"对应头部关节组",
|
|
"运行器支持的控制器及参数"
|
|
],
|
|
"skillBinding": true,
|
|
"policyRule": "controller=onnx 时引用策略必需;受支持的 oscillator 无需额外策略",
|
|
"controls": [
|
|
"头部摆动"
|
|
],
|
|
"props": [],
|
|
"dependsOn": [
|
|
"walk"
|
|
],
|
|
"defaultSelected": false,
|
|
"requirementWhenNotSelected": "none",
|
|
"requirementWhenSelected": "该功能的控制配置和全部实际引用必须完整,且当前运行器支持并试运行通过"
|
|
},
|
|
{
|
|
"id": "sit_stand",
|
|
"label": "坐下/站起",
|
|
"requires": [
|
|
"支持的姿态动作及触发/结束规则",
|
|
"对应控制配置及引用资源"
|
|
],
|
|
"skillBinding": true,
|
|
"controls": [
|
|
"已验证的坐下/站起操作"
|
|
],
|
|
"props": [],
|
|
"dependsOn": [
|
|
"walk"
|
|
],
|
|
"defaultSelected": false,
|
|
"requirementWhenNotSelected": "none",
|
|
"requirementWhenSelected": "该功能的控制配置和全部实际引用必须完整,且当前运行器支持并试运行通过",
|
|
"policyRule": "所选控制器引用的策略必须提供;允许复用文件,不强制每项另传一个策略"
|
|
},
|
|
{
|
|
"id": "roll",
|
|
"label": "翻滚",
|
|
"requires": [
|
|
"翻滚控制配置及引用资源",
|
|
"结束、取消与恢复行走规则"
|
|
],
|
|
"skillBinding": true,
|
|
"controls": [
|
|
"翻滚"
|
|
],
|
|
"props": [],
|
|
"dependsOn": [
|
|
"walk"
|
|
],
|
|
"defaultSelected": false,
|
|
"requirementWhenNotSelected": "none",
|
|
"requirementWhenSelected": "该功能的控制配置和全部实际引用必须完整,且当前运行器支持并试运行通过",
|
|
"policyRule": "所选控制器引用的策略必须提供;允许复用文件,不强制每项另传一个策略"
|
|
},
|
|
{
|
|
"id": "kick_left",
|
|
"label": "左脚踢球",
|
|
"requires": [
|
|
"左脚踢球控制配置及引用资源",
|
|
"与策略兼容的足球物理预设",
|
|
"结束、取消与恢复行走规则"
|
|
],
|
|
"skillBinding": true,
|
|
"controls": [
|
|
"左脚踢球"
|
|
],
|
|
"props": [
|
|
"football"
|
|
],
|
|
"dependsOn": [
|
|
"walk"
|
|
],
|
|
"doesNotRequire": [
|
|
"kick_right",
|
|
"自定义足球 GLB"
|
|
],
|
|
"defaultSelected": false,
|
|
"requirementWhenNotSelected": "none",
|
|
"requirementWhenSelected": "该功能的控制配置和全部实际引用必须完整,且当前运行器支持并试运行通过",
|
|
"policyRule": "所选控制器引用的策略必须提供;允许复用文件,不强制每项另传一个策略"
|
|
},
|
|
{
|
|
"id": "kick_right",
|
|
"label": "右脚踢球",
|
|
"requires": [
|
|
"右脚踢球控制配置及引用资源",
|
|
"与策略兼容的足球物理预设",
|
|
"结束、取消与恢复行走规则"
|
|
],
|
|
"skillBinding": true,
|
|
"controls": [
|
|
"右脚踢球"
|
|
],
|
|
"props": [
|
|
"football"
|
|
],
|
|
"dependsOn": [
|
|
"walk"
|
|
],
|
|
"doesNotRequire": [
|
|
"kick_left",
|
|
"自定义足球 GLB"
|
|
],
|
|
"defaultSelected": false,
|
|
"requirementWhenNotSelected": "none",
|
|
"requirementWhenSelected": "该功能的控制配置和全部实际引用必须完整,且当前运行器支持并试运行通过",
|
|
"policyRule": "所选控制器引用的策略必须提供;允许复用文件,不强制每项另传一个策略"
|
|
},
|
|
{
|
|
"id": "recovery",
|
|
"label": "跌倒起身",
|
|
"requires": [
|
|
"起身控制配置及引用资源",
|
|
"适用姿态、触发及结束规则"
|
|
],
|
|
"skillBinding": true,
|
|
"controls": [
|
|
"起身"
|
|
],
|
|
"props": [],
|
|
"dependsOn": [
|
|
"walk"
|
|
],
|
|
"autoTriggerDefault": false,
|
|
"defaultSelected": false,
|
|
"requirementWhenNotSelected": "none",
|
|
"requirementWhenSelected": "该功能的控制配置和全部实际引用必须完整,且当前运行器支持并试运行通过",
|
|
"policyRule": "所选控制器引用的策略必须提供;允许复用文件,不强制每项另传一个策略"
|
|
},
|
|
{
|
|
"id": "ground_pick",
|
|
"label": "俯身拾取",
|
|
"requires": [
|
|
"拾取控制配置及引用资源",
|
|
"拾取对象的经验证物理配置和道具绑定",
|
|
"结束、取消与恢复行走规则"
|
|
],
|
|
"skillBinding": true,
|
|
"controls": [
|
|
"拾取"
|
|
],
|
|
"props": [
|
|
"pickup_target"
|
|
],
|
|
"dependsOn": [
|
|
"walk"
|
|
],
|
|
"defaultSelected": false,
|
|
"requirementWhenNotSelected": "none",
|
|
"requirementWhenSelected": "该功能的控制配置和全部实际引用必须完整,且当前运行器支持并试运行通过",
|
|
"policyRule": "所选控制器引用的策略必须提供;允许复用文件,不强制每项另传一个策略"
|
|
},
|
|
{
|
|
"id": "rollers",
|
|
"label": "滚轮行驶",
|
|
"requires": [
|
|
"滚轮物理模型或模型变体及引用资源",
|
|
"滚轮行驶控制配置及引用策略",
|
|
"模式切换和重置规则"
|
|
],
|
|
"skillBinding": true,
|
|
"controls": [
|
|
"切换滚轮模式",
|
|
"配置支持的滚轮控制"
|
|
],
|
|
"props": [],
|
|
"dependsOn": [
|
|
"walk"
|
|
],
|
|
"doesNotRequire": [
|
|
"roller_crouch"
|
|
],
|
|
"defaultSelected": false,
|
|
"requirementWhenNotSelected": "none",
|
|
"requirementWhenSelected": "该功能的控制配置和全部实际引用必须完整,且当前运行器支持并试运行通过",
|
|
"policyRule": "所选控制器引用的策略必须提供;允许复用文件,不强制每项另传一个策略"
|
|
},
|
|
{
|
|
"id": "roller_crouch",
|
|
"label": "滚轮蹲伏",
|
|
"requires": [
|
|
"滚轮蹲伏控制配置及引用资源",
|
|
"结束与恢复行驶规则"
|
|
],
|
|
"skillBinding": true,
|
|
"controls": [
|
|
"滚轮蹲伏"
|
|
],
|
|
"props": [],
|
|
"dependsOn": [
|
|
"rollers"
|
|
],
|
|
"defaultSelected": false,
|
|
"requirementWhenNotSelected": "none",
|
|
"requirementWhenSelected": "该功能的控制配置和全部实际引用必须完整,且当前运行器支持并试运行通过",
|
|
"policyRule": "所选控制器引用的策略必须提供;允许复用文件,不强制每项另传一个策略"
|
|
},
|
|
{
|
|
"id": "visual_model",
|
|
"label": "高精度显示模型",
|
|
"requires": [
|
|
"显示 GLB",
|
|
"所选渲染器需要的节点/关节映射",
|
|
"显示与物理模型的匹配检查"
|
|
],
|
|
"skillBinding": false,
|
|
"renderBinding": "robot.render",
|
|
"controls": [],
|
|
"props": [],
|
|
"dependsOn": [
|
|
"walk"
|
|
],
|
|
"preserveSourceMaterials": true,
|
|
"defaultSelected": false,
|
|
"requirementWhenNotSelected": "none",
|
|
"requirementWhenSelected": "该功能的控制配置和全部实际引用必须完整,且当前运行器支持并试运行通过"
|
|
}
|
|
],
|
|
"featureBindingContract": {
|
|
"controllerConfigRequired": true,
|
|
"skillIdSource": "robot.skills[].id",
|
|
"requiredSemantics": [
|
|
"支持的控制器",
|
|
"关节所有权",
|
|
"观测与动作约定",
|
|
"触发与退出条件",
|
|
"取消/重置行为",
|
|
"与基础行走的切换规则"
|
|
],
|
|
"barePolicyFileIsSufficient": false,
|
|
"sharedPolicyFileAllowed": true,
|
|
"uploadedExecutableCodeAllowed": false,
|
|
"unsupportedControllerState": "needs_runtime_support"
|
|
},
|
|
"propRules": [
|
|
{
|
|
"id": "football",
|
|
"enabledWhenAnyReady": [
|
|
"kick_left",
|
|
"kick_right"
|
|
],
|
|
"maximumInstances": 1,
|
|
"platformDefaultVisual": true,
|
|
"physicsPresetRequired": true,
|
|
"physicsPresetVersionRequired": true,
|
|
"bothKicksMustShareCompatiblePhysics": true,
|
|
"customVisualUploadOptional": true,
|
|
"customVisualEnablesKick": false,
|
|
"relatedControls": [
|
|
"重置球",
|
|
"球视角(若播放器提供)"
|
|
]
|
|
},
|
|
{
|
|
"id": "pickup_target",
|
|
"enabledWhenAnyReady": [
|
|
"ground_pick"
|
|
],
|
|
"physicsBindingRequired": true,
|
|
"canShareFootballWhenExplicitlyBoundAndValidated": true
|
|
}
|
|
],
|
|
"uploadFlow": {
|
|
"primary": "individual_slots",
|
|
"alternative": "zip_import_to_same_draft",
|
|
"zipIsNotExecutable": true,
|
|
"relativePathsPreserved": true,
|
|
"extraUnboundFiles": "保留草稿,不启用动作,不进入发布依赖,不由前台加载",
|
|
"manifestGeneratedByBackend": true,
|
|
"unselectedCapabilities": "不产生缺资源错误",
|
|
"selectedInvalidCapabilities": "留草稿;用户明确选择仅发布已通过功能后,重新编译并校验所选配置",
|
|
"sharedBaseDependencyFailure": "基础失败,不能当作单个选填功能失败跳过"
|
|
},
|
|
"validation": {
|
|
"scopes": [
|
|
"base",
|
|
"feature"
|
|
],
|
|
"reportFields": [
|
|
"scope",
|
|
"capabilityId",
|
|
"code",
|
|
"path",
|
|
"status",
|
|
"message",
|
|
"assetVersion"
|
|
],
|
|
"stages": [
|
|
"uploaded",
|
|
"files_valid",
|
|
"control_contract_valid",
|
|
"runtime_supported",
|
|
"runtime_verified",
|
|
"published"
|
|
],
|
|
"errorCodes": [
|
|
"BASE_FILE_MISSING",
|
|
"FEATURE_FILE_MISSING",
|
|
"RESOURCE_IS_LFS_POINTER",
|
|
"CONFIG_REFERENCE_INVALID",
|
|
"POLICY_CONTRACT_MISMATCH",
|
|
"RUNTIME_CAPABILITY_UNSUPPORTED",
|
|
"FEATURE_DEPENDENCY_MISSING",
|
|
"PROP_CONFIG_CONFLICT",
|
|
"RUNTIME_PREVIEW_FAILED"
|
|
],
|
|
"publishedRevisionImmutable": true,
|
|
"newUploadsInvalidateOldReport": true,
|
|
"preservePreviousPublicationOnFailure": true
|
|
},
|
|
"publishContract": {
|
|
"status": "proposed_not_implemented",
|
|
"projectField": "walkingManifestUrl",
|
|
"noDemoValue": null,
|
|
"schemaVersion": 2,
|
|
"kind": "walking",
|
|
"runtimeProfile": "robot-package-v1",
|
|
"entry": "robot.json",
|
|
"autoWalk": false,
|
|
"capabilities": {
|
|
"minimum": [
|
|
"walk"
|
|
],
|
|
"uniqueIds": true,
|
|
"onlyValidatedSelectedFeatures": true,
|
|
"skillBindingsMustResolve": true
|
|
},
|
|
"props": "由已发布能力及经验证的道具绑定生成,含固定版本物理预设;踢球共享唯一 football",
|
|
"files": {
|
|
"mustNotBeEmpty": true,
|
|
"fields": [
|
|
"path",
|
|
"bytes",
|
|
"sha256"
|
|
],
|
|
"scope": "入口 + 基础 + 已发布选填功能的完整依赖;共享路径去重"
|
|
},
|
|
"exampleHeaderOnlyNotRunnable": {
|
|
"schemaVersion": 2,
|
|
"kind": "walking",
|
|
"runtimeProfile": "robot-package-v1",
|
|
"entry": "robot.json",
|
|
"autoWalk": false,
|
|
"capabilities": [
|
|
{
|
|
"id": "walk",
|
|
"skillIds": [
|
|
"walk"
|
|
]
|
|
},
|
|
{
|
|
"id": "head",
|
|
"skillIds": [
|
|
"head"
|
|
]
|
|
}
|
|
],
|
|
"props": [],
|
|
"files": []
|
|
}
|
|
},
|
|
"frontendRules": {
|
|
"availability": "按已发布且验证通过的能力与运行器支持生成操作;未下载显示待加载操作,加载完成才执行,失败时停用",
|
|
"loadBaseBeforeOptionalPolicies": true,
|
|
"optionalPolicies": "按需加载和缓存;使用前有加载状态",
|
|
"optionalFetchFailure": "只停用对应功能和无其他使用者的道具;基础资源完好时继续可用",
|
|
"actionExecutionFailure": "按已验证的退出逻辑恢复;无法恢复时暂停并重置",
|
|
"autoWalk": false,
|
|
"autoRunOptionalActions": false,
|
|
"clearInputOnBlurHideCloseCancel": true,
|
|
"controlsFromConfiguredAxesAndCapabilities": true,
|
|
"mobileOverflowActions": "更多动作面板",
|
|
"performance": [
|
|
"限制渲染分辨率和像素比",
|
|
"可选策略懒加载",
|
|
"关闭/离屏暂停",
|
|
"释放场景和推理资源",
|
|
"不随意修改控制步长或策略频率"
|
|
],
|
|
"preserveGlbMaterialsAndColors": true
|
|
},
|
|
"acceptanceScenarios": [
|
|
{
|
|
"id": "base_only",
|
|
"capabilities": [
|
|
"walk"
|
|
],
|
|
"expectedExtraControls": [],
|
|
"expectedProps": [],
|
|
"missingOptionalPoliciesAllowed": true
|
|
},
|
|
{
|
|
"id": "walk_head",
|
|
"capabilities": [
|
|
"walk",
|
|
"head"
|
|
],
|
|
"headController": "oscillator",
|
|
"extraOnnxRequired": false,
|
|
"expectedExtraControls": [
|
|
"头部摆动"
|
|
],
|
|
"expectedProps": []
|
|
},
|
|
{
|
|
"id": "left_kick_only",
|
|
"capabilities": [
|
|
"walk",
|
|
"kick_left"
|
|
],
|
|
"expectedExtraControls": [
|
|
"左脚踢球",
|
|
"重置球"
|
|
],
|
|
"expectedProps": [
|
|
"football"
|
|
],
|
|
"mustNotShow": [
|
|
"右脚踢球"
|
|
]
|
|
},
|
|
{
|
|
"id": "both_kicks",
|
|
"capabilities": [
|
|
"walk",
|
|
"kick_left",
|
|
"kick_right"
|
|
],
|
|
"expectedExtraControls": [
|
|
"左脚踢球",
|
|
"右脚踢球",
|
|
"重置球"
|
|
],
|
|
"expectedProps": [
|
|
"football"
|
|
],
|
|
"footballCount": 1
|
|
},
|
|
{
|
|
"id": "roll_without_kick",
|
|
"capabilities": [
|
|
"walk",
|
|
"roll"
|
|
],
|
|
"expectedExtraControls": [
|
|
"翻滚"
|
|
],
|
|
"expectedProps": []
|
|
}
|
|
],
|
|
"currentImplementation": {
|
|
"community": "旧 Microduck v1,尚未接入上述发布契约",
|
|
"downloadedGeneric": "一个 ONNX primary + 不重叠关节的 oscillator overlays;其他动作需运行器适配",
|
|
"downloadedMicroduck": "声明 9 个策略,旧基础启动依赖 7 个;需要拆分可选依赖才能只传基础行走",
|
|
"legacyV1CompatibilityRetained": true,
|
|
"newContractDoesNotRelaxLegacyLoaderAutomatically": true,
|
|
"dynamicAssetUrlsAndMobileIntegration": "pending"
|
|
},
|
|
"sourceExamples": [
|
|
{
|
|
"id": "microban",
|
|
"configExample": "microban.robot.json",
|
|
"baseOnnxCount": 1,
|
|
"modelMeshReferences": 25,
|
|
"optionalHeadUses": "oscillator",
|
|
"glbRequired": false,
|
|
"separateKinematicsRequired": false,
|
|
"separateControllerJsonRequired": false,
|
|
"downloadedState": "contains_26_lfs_pointers_not_runnable",
|
|
"inspection": "microban-download-inspection.json"
|
|
},
|
|
{
|
|
"id": "microduck-legs",
|
|
"status": "legacy_coupling_requires_refactor",
|
|
"declaredOnnxPolicyCount": 9,
|
|
"coreStartupPolicyCount": 7,
|
|
"notGlobalUploadRequirements": true
|
|
}
|
|
],
|
|
"uiLabels": {
|
|
"required": "必传",
|
|
"referenced": "有引用必传",
|
|
"optional": "选填",
|
|
"builtIn": "内置控制器,无需策略文件",
|
|
"generated": "系统生成,无需上传",
|
|
"unbound": "未用于展示",
|
|
"unsupported": "需要播放器适配",
|
|
"selectedOnly": "已选择,尚未上传"
|
|
}
|
|
}
|