用途:按仓库的 runtime-provider 契约新增或审查一个原生托管运行时提供者,并完成其激活或资格认证;明确排除可移植实验性配置(portable experimental profile)。
主要能力与要求:实现前须通过 AGENTS.md 中的产品范围门禁,需有已接受的 issue 或设计决策,定义所有权、生命周期、兼容性、安全与验证;有效 bundle 或通过测试不等于受支持面。保持可移植实验性配置独立,不得因原生托管提供者变更而改动其选择、生命周期或兼容行为。
使用方式:先阅读 src/lib/onboard/runtime-provider/contract.ts、registry.ts、activation.ts、current.ts、native-qualification-authority.ts,以及候选提供者工厂与其自有辅助模块;追踪 SandboxEntry.openshellDriver 在 onboarding 与各生命周期动作中的路径;阅读契约、激活、提供者、架构与 E2E 支持测试。以签入源码与测试为行为权威。
交付状态:候选 bundle(注册表接受一个完整 14-surface 对象,可选 surface 可声明 supported: false 并附原因,不可生产选择);已激活提供者(所有必需 surface 与资格字段通过当前激活契约,经 createCurrentRuntimeProviderBundles(...) 进入);激活契约扩展(拓扑无法满足当前契约时须停止实现,等待维护者接受契约变更及验证)。审查时只评估所声称状态。
实现约束:配置解析为单一不透明 provider ID,注册一个 RuntimeProviderBundle,所有 surface、receipt、资源句柄与持久化沙箱记录绑定该身份;提供者自有模块负责其命令、端点或 socket 权威、运行时资源身份、网络准备、生命周期、恢复与清理;通用编排只消费 bundle surface,不得导入提供者实现或按提供者名分支。将所选 provider ID 持久化到 SandboxEntry.openshellDriver,启动、停止、重建、快照、恢复、推理变更与销毁须从持久状态解析同一 bundle,变更前拒绝缺失、未知、复用或漂移的权威。
验证与报告:运行受 diff 影响的类型、仓库、契约、激活、提供者与架构检查;本地与 CI 检查不替代受保护资格认证或针对待审提交的完整受支持实时 E2E 矩阵。报告需包含产品范围与目标交付状态、provider ID/拓扑/权威模型/持久状态边界、已实现与不支持及扩展的 bundle surface、通用编排中残留的提供者名分支、与提交绑定的聚焦验证、受保护资格与完整 E2E 证据或缺失门禁,以及凭据、恢复、清理与所有权义务。
限制:资料未提供具体命令、安装方式、收费与平台信息。