# Context7 — 最新文档

> 把智能体连接到它，智能体就会查阅所用库的最新、匹配版本的文档，而不是依赖训练时记住的内容。

Source: https://docs.neurosquad.ai/zh/plugins/context7-docs

模型只知道训练时的库。而 API 一直在变：Hook 换了签名、配置项改了名、框架换了新路由。**Context7**
插件为连接的智能体提供 [Context7](https://github.com/upstash/context7)（Upstash 的开源项目）的两个工具：
查找库，然后阅读它当前的文档和代码示例——针对项目实际使用的版本。

## 如何使用

1. 在添加卡片菜单中选择 **插件**，在 **插件** 标签页打开 **Context7 — 最新文档**，点击 **添加到画布**。
2. 从智能体向卡片画一条[箭头](https://docs.neurosquad.ai/zh/canvas/arrows)。

智能体就有了两个工具：

- `context7_resolve_library_id`——按名称（“React”“Next.js”“Django”）查找库，列出匹配项及其 Context7 id
（`/reactjs/react.dev`）、代码示例数量、来源可信度和已索引的版本。
- `context7_query_docs`——针对一个具体问题（“useEffect cleanup function”）返回某个库的文档和示例。

当任务涉及库的 API 时，大多数智能体会自己调用它们。你也可以直接要求：“先查一下 Next.js 文档”，或在
提示词里加上 **use context7**。移除箭头，工具随之消失。大多数 CLI 无需重启，也不会向 CLI 安装任何东西。

## 无需账号

Context7 的文档索引是免费的托管服务。没有密钥时请求限额较低；从 [Context7 控制台](https://context7.com/dashboard)
获取免费 API 密钥可以提高限额。把密钥粘贴到卡片的 **密钥与缓存** 面板——它加密保存在你的电脑上，不会再次
显示，也绝不会写入文件或命令行。所有 Context7 卡片共用一个密钥。

卡片会显示剩余请求数和限额重置时间。限额用完时，卡片显示 **已达限额**，智能体收到清楚的提示而不是错误，
并且在重置前不再发送请求——缓存中的答案仍然可用。

## 缓存

每个答案在你的电脑上保存 24 小时。两个智能体问了同一个问题，或同一个智能体再问一次，答案直接来自缓存，
不消耗请求。**密钥与缓存** 面板显示缓存了多少答案、服务了多少次查询，并可清除缓存。

## 自动文档

在卡片上打开 **自动文档**，智能体会在你的每条提示词之前得到帮助：

- 提示词提到项目的某个依赖（来自 `package.json`、`requirements.txt`、`pyproject.toml`、`Cargo.toml`
或 `go.mod`）时，智能体会收到一行提示：这个库有最新文档可查——并附上项目声明的版本。这一步不发送请求，
所以回合开始得一样快。同一个库每半小时最多提示一次。
- 提示词里有 **context7**（“use context7”）并提到某个依赖或库 id（`/vercel/next.js`）时，文档本身会直接
加入本轮。NeuroSquad 最多等待约一秒半；如果 Context7 更慢，智能体会收到提示，答案会缓存下来供下次使用。

自动文档支持 **Claude Code**、**Codex**、**Qwen Code**、**OpenCode**、**Kilo Code**、**MiMo Code**、**pi**、**omp**、
**Antigravity CLI** 和 **ZCode**。其他通过箭头连接的智能体同样获得这两个工具。

## WSL 和 SSH 工作区

位于 WSL 内或 SSH 主机上的工作区中的智能体照常通过箭头获得这两个工具——查询由这台电脑上的 NeuroSquad 发出。自动文档会从 WSL 或通过 SSH 连接读取项目的 `package.json` 和其他清单文件。

## 卡片显示什么

- 服务状态——**就绪**、**已达限额**、**离线** 或 **错误**——以及剩余请求数和重置日期。
- **试一次查询**：输入库和问题，看看智能体会得到什么。
- **最近的查询**：哪个库、什么问题、哪个智能体、什么时候，以及是否来自缓存。

> 库名和问题会发送到 Context7 的服务器（由 Upstash 运营）。不要在问题中写入机密、密码或专有代码——工具
> 描述也这样告诉智能体。项目的其余部分留在你的电脑上：自动文档在本地读取依赖列表，只发送库名和问题。

## 来源

这两个工具来自 Context7 官方 MCP 服务器（`@upstash/context7-mcp`，MIT 许可证），沿用其描述；NeuroSquad
直接调用同一个 Context7 API，因此不需要额外安装或启动任何东西。文档索引本身是 Context7 的托管服务。
如果你需要完全不离开电脑的文档查询，可以改为从目录的 **MCP** 标签页添加一个自托管的文档 MCP 服务器。
