JohnXu22786/docs-retriever

README excerpt

doctrove — 版本化库文档检索（agent 工具集） doctrove 是一个面向编码 agent 的 版本化文档检索 插件：它维护一份「库文档目录索引」， 让 agent 在写代码时 按需拉取准确、带版本、可溯源 的 API 文档片段， 而不是凭训练记忆猜测 API 用法——从而避免「文档里没有的 API」「过时的签名」「臆造的参数」。 - 零运行时依赖 ：只用 Node.js 自带能力（ fetch 、 node:test ），无需安装任何包即可运行； - 标准 MCP stdio server ：任何支持 MCP 的客户端（dsh、Claude Code、Codex、opencode 等）都能接入； - 为 dsh 而生 ：自带 dsh bundle（ cordis.patch.yml + 自研桥接插件）， dsh plugin add 一步接入， 工具自动出现在模型工具列表里（ mcp doctrove ）； - 版本化 ：每个条目带多版本文档卷，支持「最新稳定版 / 精确版本 / 前缀版本（ 4 → 4.21.x）」选择； - 结果评分排序 ：条目检索与文档片段都带 0–1 相关度评分与命中信号，模型可核查「为什么排前面」； - 离线可用 ：内置本地示范索引（ data/index.json ），不联网、不配远程源即可运行； - 远程索引可自建 ：索引是开放 JSON 格式，可架设在任意静态托管上（附零依赖托管脚本）； - 智能缓存 ：TTL + LRU 内存缓存，远程索引与查询结果按配置自动失效， --no-cache 一键关闭； - 降级容错 ：远程索引不可达时自动回退到本地索引，结果带 source 标注，agent 可感知数据来源。 快速开始 方式 A：任意 MCP 客户端直接连接 以 dsh 官方桥接为例的配置行（也适用于 Claude Code / Codex 的 MCP 配置）： 连接后模型即可看到 3 个工具： catalog lookup 、 catalog releases 、 doc extract （通用 MCP 客户端看到的是裸名；dsh 场景下带 mcp doctrove 前缀，见下）。 方式 B：作为 dsh 插件 bundle 安装（推荐） 本插件已声明为 dsh bundle（ package.json 的 dsh.bundle 字段）。在插件 checkout 目录执行： - 首次使用会自动初始化 web profile，并把本包加入 dsh.profile.bundles ； - 包内 cordis.patch.yml 定义的 doctrove/bridge 插件会在 dsh 进程内直接拉起本 MCP server， 完成握手后把全部工具注册进 ctx.tools ， 无需手动改任何配置 ； - 离线可…

Category