本章进度 15 / 19
79%
正文已完成
L034写一份可直接验收的输出契约
把字段、顺序、长度、空值和异常结果写成输出契约，并用样例验证。
现在把“输出格式”用于一次具体操作，检查你能否独立做出并修正结果。
建议先完成同主题的理解与判断；本页不会锁课，可以边做边回补。
- 按本课练习说明准备真实材料
- 保留练习与复盘记录
输出契约让生成者、界面和下游程序对同一结果形态达成一致，也让格式失败可以被测试。
能提交一份包含正常与异常样例的输出契约。
核心概念
先把关键判断说清楚
字段写语义
字段契约要定义字符串或数字，也要说明值代表什么、单位和来源。
边界写进契约
最大条数、长度、枚举、空值与额外字段规则都应显式定义。
版本变化可识别
结构升级保留版本号或兼容策略，避免旧消费者静默误读。
案例拆解
风险分数单位不一致
模型有时输出0.82，有时输出82，界面统一当百分制展示，造成风险等级混乱。
- 01
把 risk_score 定义为0到1小数
- 02
增加 risk_level 枚举与映射规则
- 03
用0、0.82、1和1.2做边界测试
案例结果
单位和越界处理都可自动验证，前端不再猜测数值含义。
提交前练习
现在轮到你
为客户风险列表写一个小型输出契约。
完成本课需要：完成以下内容用于本课收口。
内容会自动保存在当前设备
查看参考答案与评分标准
参考答案
customer_id 字符串必填；risk_score 取 0 到 1；evidence 是含 1 到 3 条记录的数组；未知分数为 null 并进入待审；契约 v1 禁止额外字段，升级时用 schema_version 区分。
评分标准
- 字段语义无歧义
- 至少覆盖数值与空值边界
- 失败样例能被明确拒绝
本课收口 · 学习证据
留下完整学习证据
读完内容、完成练习、通过理解检查并留下 12 字以上总结，才记为已验证。
你现在更接近哪一种状态？
尚有必填项未完成，请补齐后再继续。
资料来源
继续核对与延伸阅读
本课内容最近更新于 。
- JSON Schema Core Specification 2020-12↗standard · 核对日期 2026-08-23
- Evals↗official-docs · 核对日期 2026-08-23