开源项目拆解专题

这组文档不是仓库导览，也不是 README 翻译。目标是让你不打开仓库，也能先看明白三个问题：这个项目在系统里负责哪一层，它的主链路怎么跑，它有哪些设计值得借回自己的项目。

每篇拆解默认会交代六件事：项目解决什么问题、整体结构、典型执行链、值得学的设计、适合迁回自己项目的点、不要照抄的地方。这样读，开源项目才会变成工程判断，而不是收藏夹。

怎么读更顺

如果你现在主要在补 Go 服务入口，先看 gin-gonic/gin。

如果你在补模型接入和 AI 服务边界，先看 openai/openai-go 和 ollama/ollama。

如果你在补 RAG 的数据底座，先看 pgvector/pgvector。

如果你在补 Agent runtime，按这个顺序更顺：cloudwego/eino -> openai/openai-agents-python / openai/openai-agents-js -> langchain-ai/langgraph -> pydantic/pydantic-ai。

如果你在补 MCP 协议与工具接入，先看 modelcontextprotocol/go-sdk 和 modelcontextprotocol/typescript-sdk，最后再看 PrefectHQ/fastmcp。

读完一篇以后，至少确认三件事

• 这个项目在系统里替你接住了哪一层复杂度。
• 它最值得学的设计是什么，为什么这样设计。
• 如果只借一件事回自己的项目，应该借哪一件。