用途:当需要为某种语言选择最新已发布的 OpenTelemetry SDK 或包版本时使用该技能,帮助确定与项目兼容的版本。
主要能力:提供按语言与包组织的版本索引;支持判断最新版本是否兼容,并在不兼容时选用最新兼容版本;可解析同生态的配套包(导出器、仪表化、资源检测器)版本;提供发布源、设置文档与示例等后续参考链接。
使用方式:先打开 references/generated/otel-version-index.md,找到对应语言与包所在行,将该捆绑表格作为默认来源;优先选用最新已发布且与项目兼容的版本,若不兼容则改用最新兼容版本并明确说明原因,并在后续任务中沿用该决定,除非语言、包或约束变化。配套包版本需从发布源单独查询确认,不得直接推断或复用主包版本。需要时使用索引中的 Release Source 列核对包或仓库,Setup Docs 列获取 SDK 配置指引,Examples 列获取实现参考。
适用场景:为多语言项目选定 OpenTelemetry SDK 及配套组件版本;需要交叉核对发布源与官方文档时。
限制:索引每个语言仅覆盖一个主 SDK 包;捆绑表格为上次每日再生成时的快照,离线时应将其作为快照而非当前最新版本呈现;若所查语言或包未被索引覆盖,应说明未覆盖并回退到官方发布源与官方文档,且不得在未说明的情况下假定未发布、预发布或不兼容版本可用。