NVSHMEM 文档技能（nvshmem-docs）用于查找并总结带版本信息的官方 NVSHMEM 与 NVSHMEM4Py 文档。其核心要求是：只依据实时抓取的官方页面作答并引用链接，不凭记忆、搜索片段或内置主题图做技术断言。
用途 面向需要查询 NVSHMEM 或 NVSHMEM4Py 官方文档的场景，包括发行说明、安装、API、运行时设置、传输方式、容器等主题。技能会先解析用户请求的主题与可选版本，再通过主题图路由到候选页面。
主要能力
- 版本感知：支持指定 MAJOR.MINOR.PATCH 精确版本，优先使用对应归档；未指定版本时使用 latest。
- 双文档集：API 参考、概念、用法与运行时设置，以及发行说明、安装、最佳实践与支持，分别有 latest 与归档入口。
- 版本门控检查：当主题图行带有 introduced_in 或 removed_in 时，会从实时官方证据核对并报告门控结果，例如“Version gate: introduced in 3.7; requested 3.5 — mismatch”。
- NVSHMEM4Py 处理：无版本时用最新文档；请求 NVSHMEM 版本时使用该版本文档集，不解析 NVSHMEM4Py 包版本；仅当请求 NVSHMEM4Py 版本或版本兼容性时，才从实时兼容指南解析独立版本对，不推断或硬编码。
- 容器相关：NVIDIA HPC SDK 容器使用官方 NGC 目录与 HPC SDK 文档，不根据镜像标签推断内置 NVSHMEM 版本，除非官方页面明确说明。
使用方式 需具备 topic-map.md 和可访问 NVIDIA 公开 HTTPS 文档的检索工具，无需 API 密钥或账号。每次请求都读取主题图以解析主题与候选页面，但主题图仅用于路由，不作为证据。选择文档版本时，规范化可选的前导 v；精确版本先使用其归档，将归档 URL 中的 VERSION 替换为规范化版本（例如 3.7.1 对应 https://archive.docs.nvidia.com/nvshmem/api/3.7.1/index.html）。对于 MAJOR.MINOR 值，仅在需要精确归档版本时才询问补丁号。从选定根开始并跟随其目录，因为内部路径可能因版本而异。跨领域问题使用同一版本的两套文档。
当精确归档不可用时，检查相关 latest 根及其官方发行/版本信息：若其标识请求版本为当前发行版，则使用该 latest 文档并说明请求版本由 latest 提供而非归档；若 latest 标识不同版本，则报告请求归档不可用，仅将不同版本的 latest 文档作为明确标注的当前上下文提供，绝不静默用 latest 文档替代其他版本。
回答时简洁给出直接官方链接，并在请求了版本或适用性重要时说明文档版本。若无法检索实时页面，返回相应根链接，说明内容未经验证，并避免基于文档的技术断言。回答保持面向用户，不披露内部检索机制或尝试来源细节，只报告结论、适用版本、证据链接与重大不确定性。
适用场景
- 解释 NVSHMEM_THREAD_SERIALIZED 等 API 或运行时设置。
- 查找指定 NVSHMEM 版本（如 3.5.21）的 NVSHMEM4Py 安装文档。
- 检查 NVSHMEM4Py 0.2.2 与 NVSHMEM 3.6.5 的兼容性。
限制
- 文档不能证明已安装的二进制、容器内容、配置、运行时行为或性能。
- 缺失页面、符号或搜索结果不能证明不可用。
- 技术答案需要检索到的实时官方证据；主题图仅为路由索引。
- 仅支持主版本 3 及以上的 NVSHMEM 文档版本，低于 3.0 的请求会被拒绝，不搜索归档或 latest 文档。
- 版本不明确时（未指明组件）需询问是 NVSHMEM 还是 NVSHMEM4Py 版本；兼容性无法唯一确定时报告候选或不确定性，不推断版本对。
故障处理
- 主题图路由失败：文档已迁移，改为浏览所选版本的实时目录。
- 精确归档失败：该版本不可用、为当前未归档发行版或检索失败；检查 latest 以识别其版本，仅在匹配请求时使用，否则报告失败并仅作为明确标注的当前上下文提供。
- 请求版本低于 3.0：不支持的文档版本，拒绝请求。
- 版本不明确：询问是 NVSHMEM 还是 NVSHMEM4Py 版本。
- 兼容性未解决：不存在唯一实时兼容行，报告候选或不确定性，不推断版本对。