Context7 选用指南:新版文档写得对,也未必覆盖你的旧版
用三张虚构手册纸卡,区分只适用新版、明确覆盖旧版,以及版本范围没有写清的说明。
来源: upstash.com
2026年10月4日
2 min
遇到旧版软件,选一份最新版说明并不总能回答眼前的问题。Upstash 在 2025 年 3 月发布 Context7 时,介绍了按库版本提供文档上下文。这个方向适合版本混用的团队,但返回的资料还需读正文:一个标题写着新版,不代表里面每段都只能用于新版;没标适用范围也不等于通用。
先定读者的版本,再看说明里的范围
在纸上编一份「图形目录手册」。你的虚构项目使用 2.1,想查一张折页应该保留几个标签。A 卡标「仅适用于 3.0,留 3 个」;B 卡是 3.0 的手册附页,却明确写「本段适用于 2.0 至 2.2,留 2 个」;C 卡只写「留 2 个」,没有版本。没有真实软件、代码或检索请求。
按 2.1 的条件,B 有直接依据;A 内容可以正确,却对这版不适用;C 和 B 数字一致,也不能单靠这个一致证明适用。再把读者版本改为 2.3:三张纸现在都不能当成直接依据,应该留空待查,而不是从 2.2 推到 2.3。请读者说出用的是正文哪句、范围边界在哪;只会复述结果不能代替版本核对。
只有一个版本时,先把手册标清
需要频繁在多个版本间查阅公开文档,按版本提供上下文的能力才值得考虑。若团队长期只用一版,给原手册注明版本并保留适用章节,可能更省事。这个纸面案例没有验证 Context7 包含哪些真实版本,也没有保证定位到的资料一定完整。
内容说明:本文基于公开资料整理,仅供工具选型参考。产品功能、价格及相关政策可能随时调整,请以官方最新信息为准。
原文出处:upstash.com