用途:为开发者技术检索权威、最新的技术文档、API 参考、配置说明与代码示例,基于 Context7 CLI(ctx7)实现。
主要能力:支持两步工作流。第一步解析库名到 Context7 兼容的库 ID(格式 /org/project 或 /org/project/version),命令为 ctx7 library <name> <query>;第二步用该 ID 查询文档,命令为 ctx7 docs <libraryId> <query>。库解析结果包含库 ID、名称、描述、代码片段数量、来源信誉、基准分与可用版本。必须先执行 ctx7 library,除非用户已明确提供 /org/project 或 /org/project/version 格式的 ID。若指定版本,可用版本化 ID,如 /vercel/next.js/v14.3.0-canary.87。
使用方式:先更新 CLI,执行 npm install -g ctx7@latest,或不安装直接运行 npx ctx7@latest <command>。查询需带 query 参数,应具体描述意图,避免单字模糊查询。示例:ctx7 library react "How to clean up useEffect with async operations";ctx7 docs /facebook/react "How to clean up useEffect with async operations"。输出包含代码片段与信息片段两类。无需认证即可使用;如需更高速率限制,可通过环境变量 export CONTEXT7_API_KEY=your_key 或 OAuth 登录 ctx7 login。
限制:同一问题最多运行命令 3 次,超过后应使用已有最佳结果。查询中不得包含敏感或机密信息,如 API 密钥、密码、凭证、个人数据或专有代码。遇到配额错误应告知用户配额已耗尽,并建议认证;若无法认证,可基于训练知识回答但须注明可能过时,不得静默回退。常见错误包括库 ID 缺少 / 前缀、未先运行 ctx7 library、使用过于简短的查询。其他细节资料未提供。