英文原文: https://argusic.com/subject/knowledge-rag

knowledge-rag

面向 Claude Code 的本地 RAG MCP 服务器:混合搜索(语义 + BM25)、交叉编码器重排序、13 个 MCP 工具、20 个格式解析器。零外部服务器,零 API 密钥。

可运行来源:GitHub项目主页PythonMITcommit d3715d7ac224

Python,MIT 许可证. 项目的自我描述:antigravity、claude、claude code、claude code cli、codex、cursor ai、document search 和 hybrid search.

knowledge-rag 可以运行。一个 Argusic agent 在一台没有 GPU 的干净机器上用 2 分钟完成了安装,遇到 2 个错误,并在无人协助的情况下全部修复,整个会话都被记录了下来。

knowledge-rag v4.9.0 installed from source in a Python 3.12 venv; all 779 automated tests pass; the MCP server starts and responds to initialize and tools/list MCP protocol messages over stdio.

agent 在干净的机器上最终得到的结果,用它自己的话说。 测量方式

每一次都由 Argusic 在全新机器上实测。每个数字都链接到对应的证据。 Argusic 评分 100,满分 100(该项目各次运行得分的平均值)。

概览

结论
可运行
Argusic 评分
100 / 100
验证运行的成本
0.03 USD(实测)
已记录的运行次数
1
最近测试
星标
300
fork 数
49
未关闭的 issue
5
关注者
1
大小
3 MB
创建于
最近推送

项目数据来自 GitHub,链接见本页顶部,更新于 。测试数据由 Argusic 提供 (CC BY 4.0);每个数字都链接到一个运行页面,附完整的 log、录屏及其 sha256 哈希。

测量了什么

来自决定该结论的那次运行。 每一行都是记录下来的数值,而非估算。

测试 knowledge-rag 时每个故障耗费的时间,取自已记录的运行
每一根柱子都是 agent 记录的一次失败,以及它耗费的时间。数据仅取自本次运行。

哪里出了问题,用 agent 自己的话说

agent 的原话,最严重的排在最前,从不改写成建议。

  • system Python externally-managed-environment (PEP 668) prevented direct pip install1 分钟
  • onnxruntime pthread_setaffinity_np failed for thread — EINVAL during CPU core affinity (cosmetic)
安装时间
2 分钟
从冷启动机器到完成
5 分钟
遇到并修复的错误
遇到 2 个,在无人协助的情况下修复了 2 个
结果是如何证明的
pytest tests/ -v: 779 passed, 5 skipped, 5 deselected, 8 xfailed in 7.27s; echo JSON-RPC initialize/tools/list to 'knowledge-rag' via stdio returned valid MCP responses with 13 tools
使用的模型 token
56,282
测试的确切 commit
d3715d7ac224
容器镜像
sha256:cdd920bce783

没有测量什么

另一半内容,让你清楚看到这些证据能说明到什么程度。缺失的数据就标为缺失,从不填补。

GPU 显存峰值
本次运行在 CPU 机器上进行,没有可采样的 GPU
长时间运行的表现
每次尝试都使用文档中最小的设置和固定的时间预算,因此这里测量的是它能否运行,而不是它在负载下的表现

录屏的结尾

决定该结论的终端会话的最后几行,与录制时完全一致。

interrogate>=1.7.0             # docstring coverage (Pillar 7)
radon>=6.0.1                   # cyclomatic complexity
vulture>=2.16                  # dead-code detection
# ── Security & supply chain ─────────────────────────────────────────────────
bandit>=1.7.10                 # SAST (Pillar 1: Security)
pip-audit>=2.10.0               # CVE check on installed deps
# ── Memory + benchmarking (Pillar 3 + Pillar 5) ─────────────────────────────
psutil>=5.9.0                  # cross-platform RSS measurement for memory baselines
# ── Mutation testing (nightly only, optional locally) ───────────────────────
mutmut>=3.5.0                  # used by .github/workflows/nightly.yml
tokens used
56,282

回放完整会话,从干净的机器到此刻的每一条命令。

测试方式

一个 agent,一个容器,没有人工协助。它按照项目自身文档所写的方式安装项目,运行它,并修复出错的地方。下面的一切都按实际发生的过程记录:终端会话、log 和确切的 commit。 完整方法论.

优势与局限

均为实测事实,而非观点。内容是如何撰写的.

顺利的部分

  • 在干净的机器上达到了运行状态,会话有完整记录。
  • 用 2 分钟完成安装。
  • 在无人介入的情况下从全部 2 个错误中恢复,说明这些故障的文档足以让人解决。
  • 无需 GPU 即可运行,因此启动它并不需要 GPU。
  • 采用 MIT 许可证,以其托管平台报告的信息为准。

不顺利或尚不清楚的部分

  • 目前只测量过一次。单次尝试只能说明它可以运行,不能说明它能稳定运行。

适合用于

  • 在笔记本电脑或小型服务器上试用:它无需 GPU 即达到了运行状态。
  • 快速评估:克隆后 2 分钟它就已经运行起来。

同一领域中也测试过的项目

这里的每个项目都由 Argusic 在干净的机器上安装并运行过。未经测试的项目不会出现在这里。

运行历史

测试者尝试结果评分成本 USD时间
Argusic Runner1/3可运行100.000.03

主题 (来自 GitHub)

antigravityclaudeclaude-codeclaude-code-clicodexcursor-aidocument-searchhybrid-searchinteligencia-artificialknowledge-baselocal-aimcpmcp-serverragrag-chatbotrag-pipelinererankingretrieval-augmented-generationsemantic-searchvector-database

嵌入徽章

用于项目 README 的 Markdown。徽章链接回本页;使用条款见 条款页面.

[![Tested by Argusic](https://argusic.com/badge/knowledge-rag.svg)](https://argusic.com/subject/knowledge-rag)

常见问题

knowledge-rag 能运行吗?
是的。knowledge-rag 可以运行. Argusic 在一台干净的机器上安装并启动了它,用时 2 分钟,过程中遇到 2 个错误,并记录了整个会话。
Argusic 是如何测试 knowledge-rag 的?
在一台全新的一次性机器上进行,每条命令都被记录,仓库固定在 commit d3715d7ac224。共记录了 1 次尝试,完整方法见方法论页面。
测试 knowledge-rag 花了多少钱?
得出该结论的那次运行花费 0.03 USD:这是真实的算力和模型成本,而不是按每百万 token 计的标价。该数字记录在那次运行的页面上。
knowledge-rag 安装需要多长时间?
在决定该结论的那次运行中,从干净的机器到运行状态用了 2 分钟。这是一次实测的尝试,不是平均值。
knowledge-rag 需要 GPU 吗?
启动它不需要。Argusic 在一台没有 GPU 的机器上让它达到了运行状态。
安装 knowledge-rag 时会出现什么问题?
已记录的运行中出现了 2 个问题,其中 2 个在无人协助的情况下被修复。每个问题及其耗费的时间都列在本页上。
knowledge-rag 的证据在哪里?
这次已记录的运行都在本页上,每次都链接到完整的 log 和终端录屏,并连同 sha256 指纹一起保存,因此无法被悄悄篡改。

Discussion