multi-agent-wiki-cn

多智能体（Multi-Agent）交互模式、分类与工程实现的实用参考

一个面向工程师的多智能体系统设计模式知识库：29 种交互模式，按五维工程分类法组织，外加 6 篇生产级实现指南和一份术语表。

每一种模式都回答四个问题：解决什么问题、控制结构如何、怎样落地、何时不该用。多数模式页还内嵌一个实时动画可视化，逐步演示消息在智能体之间的流转。

不按框架名称分类，而是按工程维度分类——任何真实系统通常都同时组合多种模式。

✨ 特性

• 五维分类法 — 控制结构 / 信息流 / 决策 / 执行环境 / 协议互联（外加专项模式），把 29 种模式按工程关注点组织。
• 结构化模式页 — 每页包含：拓扑图、适用 / 不适用场景、最小化伪代码、推荐追踪事件、常见失败模式、落地检查清单、参考资料。
• 实时可视化 — 一套手写动画引擎，逐步高亮节点与连线、演示消息流转；封面的全景星座、首页的分类切换器、模式页内嵌动画共用同一套引擎。
• Observatory 视觉风格 — 暗色画布、节点呼吸、连线脉冲、发光粒子；支持明暗双主题。
• ⌘K 命令面板 — 全站全文检索，快速跳转任意模式 / 指南 / 术语。
• 移动端适配 — 抽屉式导航、阅读进度、紧凑控制条，手机上同样好用。
• Agent 友好 — 提供 /llms.txt、/llms-full.txt 端点，方便大模型抓取整站内容。
• 内容即代码 — 所有内容都是 content/wiki/ 下的 Markdown，唯一数据源，易于贡献。

🛠 技术栈

• 框架：Next.js 16（App Router）+ React 19 + TypeScript
• 样式：Tailwind CSS v4（shadcn 风格设计 token，next-themes 明暗主题）
• 动画：framer-motion + 手写 SVG 动画引擎
• 内容渲染：react-markdown + remark-gfm + rehype-highlight
• 图表：mermaid + @xyflow/react（React Flow）+ dagre 自动布局
• 字体：Geist Sans / Geist Mono
• 测试：Playwright（E2E）

🚀 本地开发

打开 即可预览。

📝 新增一个模式页

• 在 content/wiki/patterns/.md 新建文件，参考 content/wiki/implementation/pattern-page-template.md 模板。
• 在 lib/pattern-map.ts 把该 slug 登记到对应的分类维度，使其出现在侧栏与分类法中。
• （可选）若该模式有动画版本，在 data/patterns.ts 添加动画数据，模式页会自动内嵌实时可视化。

🤖 Agent 友好端点

两者均在构建时由 content/wiki/ 静态生成，HTML 也声明了 便于发现。