87 lines
1.5 KiB
Markdown
87 lines
1.5 KiB
Markdown
# 模型卡结构规范
|
|
|
|
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
|
|
```
|