Files
vibemake/docs/model-examples/walking-upload-profiles.json
Jerry 1c837766cd feat: integrate robot assembly and simulation with resilient loading
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.
2026-10-30 18:38:39 +08:00

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": "已选择,尚未上传"
}
}