核心用法
Context7 技能通过调用 Context7 REST API，允许用户以自然语言查询开源库的官方文档并获取结构化代码示例。使用时需在 .env 配置 API Key，通过 npx tsx query.ts 命令传入仓库标识（格式：owner/repo）和搜索关键词，即可返回相关文档片段与代码示例。
典型命令格式：
npx tsx query.ts "better-auth/better-auth" "signIn social redirect callback"
显著优点
1. 自然语言搜索：无需精确记忆 API 名称，用描述性语言即可定位文档内容
2. 官方文档溯源：直接检索项目官方文档，避免二手资料的不准确性
3. 代码示例即取即用：返回结果包含可复制的代码片段，提升开发效率
4. 覆盖主流框架：支持 Next.js、React、Better Auth 等热门开源项目
潜在缺点与局限性
- 依赖外部服务：Context7 为第三方商业 API，存在服务稳定性与持续运营风险
- 索引覆盖不全：部分小众或新发布仓库可能未被 Context7 收录
- API 调用限制：免费/付费层级存在查询次数限制，高频使用需关注配额
- Node.js 环境依赖：需要本地安装 Node 和 npm，对纯前端或非 JS 开发者不够友好
- 无实时更新保证：文档索引可能存在滞后，无法反映仓库最新 commit
适合人群
- 需要快速查阅技术文档的中高级开发者
- 学习新框架时希望获取官方示例的工程师
- 在 IDE 外需要命令行快速查文档的场景
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| API Key 泄露 | `.env` 文件若误提交会导致密钥暴露 | 确认 `.env` 已在 `.gitignore` 中，使用环境变量注入替代硬编码 |
| 第三方服务依赖 | Context7 服务中断或变更定价将影响技能可用性 | 关键文档建议本地备份或保留官方文档直达链接 |
| 网络请求安全 | API 调用通过 HTTPS，但需验证证书链完整性 | 避免在不可信网络环境使用，关注 TLS 版本 |
安全等级说明
评为 S 级：工具仅执行文档查询只读操作，无文件系统写入或代码执行风险；依赖官方 Context7 API，无恶意代码注入路径。主要风险为 API Key 管理问题，属于配置层面可控风险。