从零到 OpenAI/Anthropic 官方水准 — 24 节点完整参考架构
覆盖 Monorepo → ReAct Loop → MCP → Multi-Agent → RAG → Guardrals → 产品化全链路
AI 最爱手搓。本参考告诉你每一层都有什么现成方案,以及怎么把方案连接起来。
每一层对应一张"用什么"清单。MCP 有官方 SDK、编排有 LangGraph、RAG 有 LlamaIndex、沙箱有 E2B。直接接,不要重写。
每个节点内含 🤖 AI 避坑注释:列出 LLM 最常犯的错误模式,防止 AI 生成代码时走偏。可被 ESLint AST 自动检查。
每个架构决策标注 🔗 工程逻辑:告诉你"为什么不那样做"——不是 taste trade-off,而是有真实的性能/安全理由。
"Dify + 自建前端"、"LangGraph + MCP 工具"、"Open WebUI + 自研 Agent"——9 种常见组合的对接方案,直接抄。
明令禁止旧技术栈:不用 HTML jQuery、不用 Express 裸写、不用 Vue 2、不用 Webpack/CJS。全部用最成熟的现代方案。
不是 demo 代码。包含错误处理、边界条件、类型守卫、幂等设计、超时控制——每行都经真实工程考量。
每一层都用最成熟的现代方案
按需加载、渐进叠加。每一层依赖前序节点,绝不循环依赖。
Turborepo · ReAct Loop · SSE · Next.js · Electron
Token Budget · ToolRegistry · MCP Client · Skills
3-Tier Memory · Hybrid Retrieval · Vector DB
Docker · Secure Code Execution · 7-Layer Defense
Supervisor+Worker · LangGraph · Orchestration
4-Tier Approval · LLM-as-Judge Self-Reflection
Prompt Injection Defense · Guardrails · Sandbox Escape
Eval Framework · OpenTelemetry · Langfuse Tracing
Docker Compose · K8s · CI/CD · Electron Signing
5-Layer Prompt · Template Engine · Versioning
Multi-Provider Adapter · Retry · Parallel Dispatch
Qdrant + Milvus + Chroma · Embedding · Rerank
Zod Schema · Loose Parser · Error Injection Retry
Stdio+SSE Transports · Resources · Prompts · Debug
Multi-Format RAG · Delta Indexing · Citation
Modality Router · Image Pipeline · TTS/STT
TTFT/TPOT · Sub-Token · Smart Reconnect
LangGraph/CrewAI/AutoGen/CAMEL/MetaGPT
RLS/DB-per-Tenant · RBAC · Audit · Billing
Publishing API · Security Scan · Revenue Share
State Snapshots · Idempotent Tools · Model Fallback
Input/Output/Tool Guardrails · Langfuse · Spans
Artifact Renderer · CLI/Headless · Ask User Q
Playground · Routing · Rate Limit · Webhooks
开源产品能覆盖的,直接用;覆盖不了的,用我们的节点补充
| 场景 | 现成产品 | 本 Skill 补充 |
|---|---|---|
| 5 分钟上线 | Dify / Coze | — 直接用 |
| 类 ChatGPT 前端 | Open WebUI | — 直接用 |
| 知识库问答 | RAGFlow / FastGPT | — 直接用 |
| 自定义品牌 UI | 无现成 | 参考 01/17 + Dify API |
| 深度 Electron 桌面 | 无现成 | 参考 01 + 09 |
| 多 Agent 编排 | LangGraph | 参考 02/05 + MCP 连接 |
| 全自托管离线 | 无现成 | 参考全部 + Ollama/vLLM |