# 模型卡结构规范

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 必须回答：

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

## 校验

使用：

```powershell
python scripts\check_card_contract.py
python scripts\validate_model_library.py
```