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