前言¶
读一篇新的大模型论文，往往要先在脑子里把「这一层到底是 MLA、DSA 还是 MoE」拼起来，再对照公式查张量维度。表格和示意图分散在 PDF 里，层与层之间的变体（例如每 N 层换一种注意力）也不容易一眼对齐。DeepSeek Harness（DSH）把能力拆成可安装插件；若你已经在用 DSH 做推理或智能体开发，把「架构理解」放进同一套 Web 界面，比单独开看图工具更顺手。
下面介绍社区插件 Arch Lab（npm 包 @powehig/dsh-arch-lab，仓库 PowehiG/dsh-arch-lab），维护者为 PowehiG。它在 DSH 侧边栏提供「架构显微镜」：把论文里的每一层展开成可旋转、可点击的 3D 结构剖视，并保留原有的 2D 宏观与层内视图；张量形状、LaTeX 公式与符号解释与模块一一对应。分类上可归入模型推理相关工具——侧重结构可视化与参数量估算，而非直接跑 forward。
这是什么¶
Arch Lab 的定位是：面向 2025–2026 前沿 LLM 论文的逐层 3D 架构显微镜。残差主干、Q/KV 投影、MLA latent cache、DSA indexer / top-k、稀疏注意力、MoE 路由与专家等，以带 shape 标注的 3D 模块呈现；点击模块可在右侧检查器查看公式与逐符号说明。语言跟随 DSH locale（中文 / English），主题跟随 DSH 深/浅色；默认视图为 3D 逐层结构，工具栏可随时切 3D / 2D，选择记在 localStorage。
内置约 16 个模型的结构化数据（如 DeepSeek-V3.2、GLM-5、Kimi K3 等），并附带设计要点卡片、参数 / KV 计算器、最多 4 路模型对比，以及从 arXiv 页面解析并导入草稿的能力。许可为 MIT（Three.js r128 内嵌于 vendor/，见 vendor/THREE-LICENSE）。
核心功能¶
3D 逐层结构剖视¶
中间画布展示的是当前层的 3D 架构图，而非一叠层片。左侧层轨与底部滑杆覆盖 1..N 层；切换层时，场景中的模块、连线、张量形状与公式同步替换。
- 模块为真实 3D 几何体（投影/注意力为发光 box，KV cache 为圆柱，专家为 3×3 网格等），类型对应固定色板。
- 数据流以不同曲率与颜色的管道表示主干、分支、残差 skip、top-k、状态更新；主路径上可有粒子动画（可暂停）。
- 每个模块 label 显示 shape；点击后在检查器展示完整输入/输出形状、说明、公式与符号表。
- 支持拖拽旋转、滚轮缩放、
fit重置取景；不支持 WebGL 时降级为纵向模块列表，2D 视图仍可用。
层内变体由 src/03-data.js 按模型标签推导（例如 Kimi K3 每 4 层 1 层 MLA、其余 KDA；DeepSeek-V3.2 / GLM-5 全层 DSA 等），张量形状由 config 计算而非硬编码文案。
2D 视图（与 3D 共享状态）¶
工具栏切到 2D 后：
- 宏观结构：embedding → N×Transformer Block → final norm → LM head。
- 层内结构：双击带
×N的重复块下钻，查看 pre-norm、注意力变体、MoE、残差等数据流。
2D 与 3D 共用模型数据、检查器、对比、计算器与论文解析，不会维护两套状态。
论文与 Agent 侧扩展¶
- 论文解析：粘贴 arXiv HTML / abs URL 或正文，抽取标题、hidden size、层数、专家数、top-k、上下文与公式，生成可导入草稿（可存
localStorage，带IMPORT标记）。 paper_lab工具（Host 半注册）：Agent 可fetch论文 URL、publish结构化 spec 到面板，或list/clear。publish的stack可省略，客户端会据config生成宏观结构，3D 场景从config、tags、stack推导。
支持的 LaTeX 子集为插件自带小型解析器（不依赖 KaTeX/MathJax）；不支持 \begin{aligned}、\tag、TikZ 等。
安装与启用¶
在 DSH 环境中安装官方 bundle（命令来自项目 README，勿自行拼接 github:owner/repo）：
plugin_manager install_bundle @powehig/dsh-arch-lab
安装完成后，在 DSH Web 侧边栏找到 「架构显微镜」 入口（order: 12）。当前 npm 版本为 2.0.0（见 package.json）。发布渠道：GitHub PowehiG/dsh-arch-lab 与 npm @powehig/dsh-arch-lab。
插件以 DSH 进程权限运行。安装前应自行审阅源码与 MIT 许可证；社区目录页 skillhub.cn 上的 dsh-arch-lab 为独立生态站点，与 DeepSeek / 幻方无官方从属关系。
典型用法¶
从 UI 浏览 DeepSeek-V3.2 的 DSA 层¶
- 点击左侧模型卡选中
DeepSeek-V3.2。 - 默认进入 3D 视图；用层轨或
←→切换层号。 - 点击例如「DSA Indexer」「Top-k 选择」「MLA + DSA」等模块，在右侧查看形状与公式（如稀疏注意力
y_t = softmax(q_t K_{I_t}^T / sqrt(d_h)) V_{I_t}）。 - 需要宏观图时，工具栏切
2D；需要参数量时，点顶部计算器图标调整层数、hidden size、专家数等。
Agent 推送自定义 spec（可选）¶
若 Host 已暴露 paper_lab，可向面板发布草稿，例如：
{"action":"fetch","url":"https://arxiv.org/abs/2606.xxxxx","maxChars":80000}
{"action":"publish","spec":{"name":"...","summary":"...","config":{...},"ideas":[...],"stack":[...]}}
fetch 会尝试 arXiv HTML 全文并转换 MathML / LaTeX 注解；publish 写入 Host 内存，面板约每 4.2 秒轮询 /paper-lab/api/custom，几秒内出现并带 AGENT 标记。
适用场景与注意¶
适合：需要在同一界面里对照论文理解 MLA / DSA / MoE / 混合注意力层序的开发者；写技术笔记或做模型选型时，用内置计算器与对比视图估算参数量与 KV 成本。
注意：
- 展示的层序与张量形状据公开配置与标签推导；论文未给出的字段可能用
?或默认值，UI 不冒充官方逐层表。DSA indexer 等细节因论文版本而异，插件展示的是公开结构脉络而非某篇的逐行伪代码。 - 无 WebGL 时自动降级列表视图，结构信息仍保留。
- 导入的 Agent / 本地模型草稿需自行核对与论文一致性。
结尾¶
Arch Lab 把「读论文时的结构拼图」收进 DSH：默认 3D 逐层剖视，兼顾 2D 下钻、公式检查器、计算与对比，并预留 paper_lab 供 Agent 灌入 spec。若你要在 Harness 里系统看前沿 LLM 架构，可先执行上面的 install_bundle，再从侧边栏「架构显微镜」进入。
