find-docslisted

# 文档检索 使用 Context7 CLI 获取任意库的最新文档与代码示例。 执行命令前，先确保 CLI 为最新版本： ```bash npm install -g ctx7@latest ``` 或者无需安装，直接运行： ```bash npx ctx7@latest <command> ``` ## 工作流 采用两步流程：先把库名解析为 ID，再用该 ID 查询文档。 ```bash # 第一步：解析库 ID ctx7 library <name> <query> # 第二步：查询文档 ctx7 docs <libraryId> <query> ``` 你必须先调用 `ctx7 library` 获取合法的库 ID，除非用户已经明确提供了 `/org/project` 或 `/org/project/version` 格式的库 ID。 重要：每个问题最多执行 3 次相关命令。如果 3 次后仍无法找到理想结果，使用当前最佳结果作答。 ## 第一步：解析库 将包名/产品名解析为 Context7 兼容的库 ID，并返回候选库。 ```bash ctx7 library react "How to clean up useEffect with async operations" ctx7 library nextjs "How to set up app router with middleware" ctx7 library prisma "How to define one-to-many relations with cascade delete" ``` 必须始终提供 `query` 参数。该参数是必填项，并且会直接影响结果排序。请根据用户意图构造 query，帮助在同名或近似名称库之间做出区分。query 中不要包含任何敏感或机密信息，例如 API Key、密码、凭据、个人数据或私有代码。 ### 返回字段 每条结果包含： - **Library ID** — Context7 兼容标识（格式：`/org/project`） - **Name** — 库或包名称 - **Description** — 简短描述 - **Code Snippets** — 可用代码示例数量 - **Source Reputation** — 来源权威性（High、Medium、Low 或 Unknown） - **Benchmark Score** — 质量评分（满分 100） - **Versions** — 可用版本列表。若用户指定了版本，请优先使用列表中的对应版本（格式：`/org/project/version`）。 ### 选择流程 1. 分析 query，明确用户要找的是哪个库/包 2. 按以下维度选择最相关结果： - 名称与 query 的相似度（优先精确匹配） - 描述与用户意图的相关性 - 文档覆盖度（优先 Code Snippets 数量更多者） - 来源权威性（优先 High 或 Medium） - Benchmark Score（越高越好，满分 100） 3. 若有多个高质量候选，需说明这一点，但继续使用最相关的一个 4. 若没有合适候选，需明确告知并建议用户优化 query 5. 若 query 含糊不清，先向用户澄清，再决定是否用最可能匹配继续 ### 版本化 ID 若用户提到特定版本，应使用带版本的库 ID： ```bash # 通用（索引中的最新