用途:为任意开发技术检索当前最新的技术文档、API 参考、配置细节与代码示例。
主要能力:基于 Context7 CLI,采用两步流程——先将库名解析为 Context7 兼容的库 ID,再用该 ID 查询文档。
使用方式:先确保 CLI 为最新版本,运行 npm install -g ctx7@latest;也可不安装直接运行 npx ctx7@latest <command>。第一步解析库:ctx7 library <name> <query>;第二步查询:ctx7 docs <libraryId> <query>。除非用户已显式提供 /org/project 或 /org/project/version 格式的库 ID,否则必须先调用 ctx7 library 获取有效 ID。
查询要点:库名解析必须传 query 参数,且查询会影响排序;应使用具体、含细节的查询(如 "React useEffect cleanup function with async operations"),避免单词式查询。每个问题最多运行这些命令 3 次,超过则使用已有最佳结果。若用户指定版本,可使用版本化 ID,如 /vercel/next.js/v14.3.0-canary.87。
结果字段:库 ID、名称、描述、代码片段数量、来源声誉(High/Medium/Low/Unknown)、基准分(满分 100)、可用版本列表。
认证:无需认证即可使用;如需更高速率上限,可设置环境变量 export CONTEXT7_API_KEY=your_key,或运行 ctx7 login 进行 OAuth 登录。
限制与错误处理:若出现配额错误("Monthly quota reached" 或 "quota exceeded"),应告知用户配额已耗尽,建议认证以获得更高上限;若用户无法或不认证,可基于训练知识回答并明确说明可能过时。不得静默回退到训练数据。常见错误包括库 ID 缺少 / 前缀、未先运行 ctx7 library、使用单字查询,以及严禁在查询中包含 API 密钥、密码、凭证、个人数据或专有代码等敏感信息。