DeepInsight 系列 02：模型总览不是列表，而是模型资产台账#

模块定位#

推荐系统实验中，模型目录本身不能直接代表系统能力。一个模型可能只有代码，没有权重；可能有训练日志，但没有接入服务；也可能有指标文件，但缺少可对比的数据记录。模型总览页要把这些状态拆开展示。

最终报告里把模型总览放在系统设计与功能实现的前半部分，是因为它承担资产入口作用。后续接入测试、性能看板和可视分析工作台都依赖这里整理出的模型、数据和状态。

展示内容#

页面按模型卡片和详情区组织信息。卡片用于快速浏览模型名称、模型类型、可用状态和摘要指标；详情区展示数据集规模、用户数、物品数、交互数、稠密度、指标记录和接入证据。

系统覆盖 BSARec、BERT4Rec、DuoRec、FEARec、FMLP-Rec、RecBole、SASRec、TiSASRec 等推荐模型。对每个模型，页面需要尽量回答三个问题：资产是否存在，结果是否有来源，当前是否可以被调用。

数据来源#

模型总览的数据不应该写死在前端。后端负责扫描模型目录、权重、日志、metrics 文件和数据集统计信息，再返回脱敏后的模型状态。前端只展示模型名称、数据规模、指标字段和状态说明，不展示服务器物理路径。

这种设计可以减少两个问题。第一，页面不会因为目录迁移直接失效。第二，用户不会在前端看到后端文件路径、训练脚本路径或内部配置结构。

指标处理#

指标展示要保持克制。有 HR@10、NDCG@10、Recall@10、MRR 等记录时，页面可以展示；没有记录时，页面应标注“未记录”或不展示该字段。不能用 0 或随机数补齐空白，因为 0 可能被误解为模型表现极差，随机数则会直接破坏结果可信度。

模型总览页只给出摘要指标，不承担完整分析。完整对比应该放到性能看板和可视分析工作台中，这样模型资产信息和实验分析不会混在同一个页面里。

服务状态#

模型状态需要分层表达。已接入推理服务的模型可以显示可测试；只有代码和数据的模型应显示待接入；服务配置存在但当前不可访问时，应显示离线或异常。这个状态会直接影响接入测试页面的可用模型列表。

这种分层比“可用/不可用”更有价值。它告诉用户问题出在资产缺失、服务未登记、服务离线，还是接口返回异常。

页面结果#

当前模型总览页已经能承接课程展示中的模型资产说明。它把模型、数据、日志和指标组织到同一页面，并保留状态说明，使用户可以先理解平台管理了什么，再进入接入测试和性能看板。

后续改进#

后续可以继续补充模型版本、训练时间、评估批次和请求日志摘要。这样模型总览会从资产台账进一步变成实验记录入口，为后续追踪模型变更和评估结果提供更完整的上下文。