内容
# 最佳开源实现图谱
对于 **50个具有挑战性的、交叉的工程问题**，该项目为每个问题命名了一个最佳的开源产品，该产品是从 **100个克隆的生产代码库** 中选出的，并且给出了 **具体的可读文件** 和值得复制的模式。它以人类可读的参考、 可浏览的HTML图谱 和一个 **MCP服务器** 的形式提供，允许编码代理直接查询它。
这是一个 **用于模式提取的阅读清单**，而不是一个用于克隆的入门套件。
| | |
|---|---|
| 问题 | 50 |
| 分析的代码仓库 | 100 |
| 文件引用 | 536个唯一文件，589个引用（**535个机器验证**；其余1个是故意的`<locale>`占位符，从未链接） |
| RAG区块 | 717 |
| 构建者 | 3个生成批次中的63个子代理 |
排名靠前的代码仓库（多个问题获胜的代码仓库）：`directus`（6），`discourse` / `cal.com` / `n8n`（各4个）。
## 作为MCP服务器使用
```jsonc
// ~/.claude.json → mcpServers
"best-of-breed": {
"type": "stdio",
"command": "node",
"args": ["C:/dev/reference-repos/bob-mcp/server.mjs"],
"env": { "OLLAMA_HOST": "http://<host>:11434" } // 可选：启用混合RAG
}
```
七种工具：`list_concerns`，`get_best_implementation`，`semantic_search`，`answer_pack`，`search_patterns`，`get_repo_profile`，`list_repos`。
搜索在服务器内部运行（BM25，加上余弦相似度，当嵌入模型可达时）；生成由调用工具的模型完成 - 因此服务器本身运行成本为零。参见 [`bob-mcp/README.md`](bob-mcp/README.md)。
## 布局
```
bob-mcp/
server.mjs MCP服务器（7种工具）
source.json 真实来源 - 所有50个问题部分
build-data.mjs source.json -> data/catalog.json
merge-expansion.mjs 新生成批次的幂等合并
smoke.mjs 17项检查服务器烟雾测试
rag/ 索引构建器、检索、命中@3评估门控
data/ catalog.json, rag-index.json
BEST-OF-BREED-REFERENCE.md 完整人类可读参考（337 KB）
reference-artifact.html 可浏览图谱
SECURITY-REPORT.md 100个代码仓库的供应链扫描（0个恶意软件）
wf-*.js 多代理生成工作流
clone-all.sh, repo-list.txt 代码仓库重建
logs/ 按代码仓库扫描日志、清单、安全判决
```
100个克隆的代码仓库 **不** 在此代码仓库中（10 GB+，每个代码仓库都有自己的 `.git`）。使用 `repo-list.txt` + `clone-all.sh` 重建代码仓库。
## 重新生成
`source.json` 是真实来源。编辑完成后：
```bash
node bob-mcp/build-data.mjs # -> data/catalog.json
node bob-mcp/rag/build-index.mjs # -> data/rag-index.json (如果ollama启动，则为混合)
node bob-mcp/smoke.mjs # 17项检查
node bob-mcp/rag/eval.mjs # 命中@3质量门控（>= 0.85）
node build-reference-md.mjs # -> BEST-OF-BREED-REFERENCE.md
node build-artifact.js bob-mcp/source.json # -> reference-artifact.html
node verify-citations.js # 每个引用的路径必须存在
```
添加问题：复制 `wf-expand-concerns-3.js`，交换问题列表，运行它作为工作流，然后运行 `merge-expansion.mjs` 和上述步骤。
## 诚实的注意事项
- **引用链接到SHA固定的GitHub永久链接** （添加于2026-07-18）：参考和HTML图谱中的每个 `repo/path` 链接到 `github.com/<org>/<repo>/blob/<clone-HEAD-sha>/<path>`。535/535通过 `git cat-file` （`verify-permalinks.mjs`）验证为在固定的SHA处解析，因此链接不会失效。固定值位于 `bob-mcp/data/repo-pins.json`。
- **快照，而非实时索引。** 固定的SHA反映了2026年7月初克隆的代码仓库。链接将永远有效，但上游HEAD可能自此进行了重构。
- **漂移被监控，但不被假设为不存在。** 每月作业 （[`check-upstream.mjs`](check-upstream.mjs)，[工作流](.github/workflows/upstream-check.yml)）重新检查所有100个代码仓库的更名、存档和删除，以及每个引用的路径与上游HEAD的对比。只有当出现问题时，它才会开启一个问题 - 安静的跟踪器意味着检查运行并发现了什么。 它 **不** 重新评估选择；那需要重新生成，而不是定时任务。
- **引用经过验证；** **选择未经过验证。** 每个 `repo/path` 通过机器检查存在，一个对抗性验证过程修复了损坏的路径。但是，“为什么这个代码仓库赢得了这个问题”是模型的判断，而不是审查后的基准。将获胜者视为强有力的起点，而不是判决。
- **由LLM代理编写，然后机械验证。** 没有源代码被复制到参考中 - 它是纯文本和文件路径。
- **安全扫描是自动分诊，不是审计。** `SECURITY-REPORT.md` 反映了启发式扫描 + LLM对公共源代码的判断。判决（包括2个`review`标志）是用于健全检查的意见，而不是供应商确认的漏洞；没有联系维护者。
## 许可证
MIT（参见 [LICENSE](LICENSE)）。仅适用于此代码仓库中的文本、脚本和生成的数据 - 分析的上游项目不包括在内，仍受其自身许可证的约束。
