mcpField
M
model-architecture-diagram

model-architecture-diagram

github.com/bbuf开发1.1k78 次安装今天更新
代码仓库

关于 model-architecture-diagram

用于查找已索引模型架构图原图的技能，面向需要模型专属图示的用户。它返回原始图片链接并保留来源署名；若没有匹配项，则说明未收录。

主要功能

  1. 01解析模型名称与别名
  2. 02返回架构图原图链接
  3. 03保留来源署名
  4. 04列出已知图示别名

适用场景

  1. 01查找某个模型的架构图
  2. 02获取直接匹配的多张图示
  3. 03确认模型是否有已索引图示

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bbuf/ai-infra-auto-driven-skills --skill model-architecture-diagram

安装后在 Claude Code 中输入/model-architecture-diagram确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
diagram-index.json
source-notes.md
scripts/
model_architecture_diagram.py

详细介绍

模型架构图

工作流

仅返回此技能索引中的公开原始图。

  1. 运行附带的解析器：
python3 skills/model-architecture-diagram/scripts/model_architecture_diagram.py "<model name>"
  1. 如果解析器返回 kind: existing，则返回它输出的原始图片 Markdown，并保留来源注明行。
  2. 如果解析器返回 kind: no_match，则告知用户没有为该模型索引公开的原始架构图。

来源优先级

以 references/diagram-index.json 为准。该文件存储原始 GitHub 图片 URL、官方供应商/CDN URL，或固定版本的 Hugging Face resolve/<sha> URL。官方来源包括 Qwen 和 XiaomiMiMo；GitHub 来源包括：

  • datawhalechina/self-llm
  • CalvinXKY/InfraTech
  • Tongyi-MAI/Z-Image
  • Wan-Video/Wan2.1
  • Wan-Video/Wan2.2
  • Tencent-Hunyuan/HunyuanVideo
  • Tencent-Hunyuan/Hunyuan3D-2
  • brayevalerien/Flux.1-Architecture-Diagram

优先选择详细的实现图、教程图或架构卡图，而不是论文插图。优质来源应展示模块边界、数据流、MoE / 注意力 / 缓存路径，或特定模型的运行时结构，而非只有高层论文概览。官方仓库图和精选实现图应优先；仅当没有索引到更详细的公开原始图时，才将论文插图作为备用选项。

不要将远程图片二进制文件复制到此技能中。返回索引中的原始 URL，以便聊天渲染器显示原始图片。

现有图规则

对于直接匹配的结果，展示原始图片。优质的直接匹配包括：

  • 来自 InfraTech 的 DeepSeek V3/V3.2/V4、GLM-5、Kimi K2/K2.5/K3、MiniMax M2.5、Qwen3.5、Qwen3-VL 和 Step 3.5 Flash。
  • Qwen3.8-Flash-Next 有官方图（在运行时代码中也称为 qwen4_exp）。普通 Qwen3.8 2.4T 仍为 no_match；它们是不同的架构。
  • MiMo V2.6、MiMo V2.5 Pro 和 GLM-5.2 有已索引的原始图。GLM-5.3 仍为 no_match，因为尚未验证到直接匹配的图。
  • 来自 self-llm 的 Hunyuan-A13B、Kimi-VL、Qwen3、Qwen3-VL 详细流程、MiniMax M2，以及 Llama 4 架构/模块图。
  • 来自公开 GitHub 来源的 Z-Image、Wan2.1、Wan2.2、HunyuanVideo、Hunyuan3D 2.0 和 FLUX.1 扩散架构/模块图。

如果有多个匹配图，则展示所有高置信度匹配项，最多不超过解析器的默认上限。例如，DeepSeek V3 可能会返回完整架构图，以及 MLA MHA/MQA 图。

托管的原始图图库

不要将 sgl-cookbook-model-architecture-images/ 图库提交到仓库。公开原始图片集托管为 GitHub Release 资源，并通过 GitHub Issue 编入索引。

当前托管资源：

该图库是 2026-05-02 的快照，包含 44 个公开原始架构图文件；它并非当前索引的镜像，还包含轻量级的 index.html、index.md、manifest.json、HTML 联系表和 architecture-audit.md。

要在本地检查图库：

curl -L -o /tmp/sgl-cookbook-model-architecture-images-2026-05-02.zip \
  https://github.com/BBuf/AI-Infra-Auto-Driven-SKILLS/releases/download/sgl-cookbook-architecture-images-2026-05-02/sgl-cookbook-model-architecture-images-2026-05-02.zip
unzip -q /tmp/sgl-cookbook-model-architecture-images-2026-05-02.zip -d /tmp
open /tmp/sgl-cookbook-model-architecture-images/index.html

实用命令

列出已知的原始图别名：

python3 skills/model-architecture-diagram/scripts/model_architecture_diagram.py --list-known

输出用于自动化处理的 JSON：

python3 skills/model-architecture-diagram/scripts/model_architecture_diagram.py "GLM-5" --format json

参考资料

  • references/diagram-index.json：原始图链接索引和别名。
  • references/source-notes.md：已审核的来源仓库和本地缓存路径。

评论

支持 Markdown