SuperAPI AI 工具集

docs-manage

编程与开发

查看项目

更新于 10-16 09:49

技能介绍

用途:这是 Grounded Docs MCP Server 的文档索引管理命令集,用于在本地存储中建立、更新和清理库文档索引,供后续搜索使用。适用于:库尚未收录需初次建索引;文档可能过时需拉取更新;需删除某库或版本释放空间;删除后存储文件仍偏大需压实。

主要能力与用法: scrape:从 URL 或本地目录下载并建立索引。命令为 npx @arabold/docs-mcp-server@latest scrape <library> <url> [options]。常用选项含 --version/-v(版本标签)、--max-pages/-p、--max-depth/-d、--max-concurrency/-c、--scope(subpages|hostname|domain,默认 subpages)、--scrape-mode(auto|fetch|playwright)、--include-pattern/--exclude-pattern(exclude 优先)、--header、--clean(默认 true)、--replace、--quiet、--verbose。本地文件须用 file:// 方案(如 file:///绝对路径)。 refresh:对已索引版本重新抓取,借 HTTP ETag 跳过未变页面,须该库版本已索引。npx @arabold/docs-mcp-server@latest refresh <library> [--version <ver>]。 remove:删除库或指定版本。npx @arabold/docs-mcp-server@latest remove <library> [--version <ver>]。此为破坏性且不可撤销,需重新 scrape 才能恢复。 compact:回收空闲 SQLite 页并截断 WAL 以缩小存储;执行时获取排他锁,可能阻塞搜索。npx @arabold/docs-mcp-server@latest compact [--force]。删除文档不会缩小主库文件,宜在空闲时执行。

输出:命令向 stdout 写纯文本状态,诊断信息写 stderr。全局 --output 被接受但无效。非交互会话默认抑制诊断,可用 --verbose 或 LOG_LEVEL=INFO 启用,--quiet 抑制全部非错误诊断。

限制:抓取可能耗时,大站点可运行数分钟,建议用 --max-pages/--max-depth 限定范围。scrape 不会意外覆盖:目标库版本已存在会失败且不动原内容,需 --replace 重建、refresh 就地更新或 --no-clean 追加。库名保留大小写但大小写不敏感匹配;名称中无特殊字符含义,应写 --version 18 而非 react@18。refresh 仅适用于已索引内容。