COMPATIBILITY / RUNTIMES AND VERSIONS

选择运行时并声明兼容目标

扩展清单、guest API、宿主 ABI 和客户端版本描述不同层面的兼容关系。先按包类型选择运行时，再检查该包所需的宿主能力。

已验证到哪一步？

2026-10-08，公开目录 GET /api/marketplace/plugins 在默认 Cloud origin https://newapi.tradingai.app 返回 HTTP 200 和业务成功码 0；下载包内的 Python 目录脚本也已实测运行成功。

资源示例已通过独立解压、编辑、校验和归档打包检查。其余 Cloud 操作按源码整理；受保护功能是否启用，以及扩展在已发布客户端中的实际运行情况，仍需在对应环境核对。

运行时适用范围

当前公开契约的运行时路径
运行时	包内容	适用说明
`resource`	根清单；`apiVersion: 1`	声明式资源，不携带 guest 程序。自选列表、静态视图和受宿主约束的贡献按清单权限与功能校验。
`wasm`	`manifest.json` 与 `main.wasm`	一般 quote 示例使用 guest API v1；交互式 guest 使用 API v2，需宿主声明相应原生 ABI 特性。
`managedModel`	受信的托管模型扩展	当前清单合同要求发布者为 TradingAI Official 且信任状态已验证；TimesFM 是官方示例。
`webApp`	静态 HTML 资源及哈希清单；`apiVersion: 3`	当前清单合同要求 TradingAI Official、已验证信任和明确的 `minHostVersion`；示例清单声明 3.0.0。

managedModel 和 webApp 的当前清单合同要求官方身份与已验证信任。第三方开发者可先从公开的 resource 或受限 Wasm 包开始；能通过本地 schema/结构校验，不代表该运行时可作为任意第三方 Marketplace 包发布。

不要混用这几个版本

清单 `apiVersion`

描述包所采用的清单与 guest 合同。例如资源包是 1，Wasm 交互 API 是 2，WebApp 清单是 3。

Wasm 原生 ABI

描述 Wasmtime 宿主提供的导入与 feature bits。guest API v1 和 v2 的编号都不等同于原生 ABI v3。

`minHostVersion`

描述一个具体包要求的最低客户端版本。以该发布包的签名清单为准；WebApp 示例中的 3.0.0 只适用于该示例，不要从它推断其他包的要求。

扩展版本与 Cloud 契约版本

扩展自己的版本号用于发布升级；Cloud OpenAPI 和 SDK reference 快照有独立文档版本。

发布前核对目标客户端

确定清单的 runtime 与 apiVersion 组合符合相应契约。
确认目标宿主实现了包使用的导入、feature bit、权限和贡献类型。
按每个待发布版本填写 minHostVersion，不要使用尚未验证的最低版本。
用目标客户端做实际安装和激活验收；源目录预览只检查声明，Wasm 显示的是模拟输入。

Marketplace 按请求中的 host_version 和 channel 解析版本；channel 默认是 stable。服务端只返回已审核、有效且信任状态合格的版本，并检查该版本自己的 minHostVersion。stable 请求不会解析 beta，beta 请求可包含 stable 和 beta。

发布前可查看SDK reference、manifest schema，并按契约版本记录核对快照。契约文件说明源码合同，不证明某个生产环境或客户端版本已经启用这些能力。