the-mindscape-of-bro-tsong/knowledge_assets/02_模型卡结构规范.md

1.5 KiB

模型卡结构规范

version: 0.1

last_updated: 2026-06-16

status: draft

Source Of Truth

本文件是长期知识资产摘要。

操作性 source of truth 位于:

  • docs/MODEL_CARD_CONTRACT.md
  • schemas/model_card.schema.json

基本原则

Markdown card 用于人读审查。

JSON model card 用于系统调用、selector、校验和未来应用集成。

字段名使用英文。

中文来源的字段值和 Markdown 内容保持中文,避免翻译漂移。

Markdown Card 必需章节

模型卡必须覆盖:

  • 模型名称
  • 模型 ID
  • 一句话定义
  • 模型类型
  • 所在流程位置
  • 来源文章
  • 来源证据片段
  • 核心问题
  • 核心机制
  • 输入类型
  • 输出类型
  • 适用场景
  • 不适用场景
  • 调用关键词
  • 负向触发条件
  • 相关模型
  • 冲突模型
  • 学科底座关联
  • 常见误用
  • 失败信号
  • 可信度等级
  • 稳固性状态
  • 稳定性评估
  • 回归测试状态
  • 示例输入
  • 示例输出
  • 输出契约
  • 深度控制
  • 产品化建议
  • 版本信息

JSON Model Card 必需方向

JSON model card 必须回答:

  • 什么时候调用?
  • 什么时候不调用?
  • 输入是什么?
  • 输出是什么?
  • 调用优先级是多少?
  • 位于流程哪里?
  • 前后相关模型是什么?
  • 冲突模型是什么?
  • 如何判断调用失败?
  • 稳固性如何?
  • 如何继续稳定化?

校验

使用:

python scripts\check_card_contract.py
python scripts\validate_model_library.py