智能问诊报告字段详解与页面映射
本文档详细列出**智能问诊报告(module_type = 1)**的所有返回字段定义、全景 JSON 示例树、前端 UI 组件映射关系,以及分片合并逻辑。
报告获取途径
- 方式一(推荐):调用
GET /medical-record?session_id=<SESSION_ID>或?report_id=<REPORT_ID>,直接获取聚合后的完整报告report对象。 - 方式二:通过轮询任务接口或详情接口读取
report_contents分片数组,前端自行执行 Deep Merge 组装(算法见文末)。
报告全景 JSON 树状标注示例(100% 完整结构)
以下展开了问诊报告的所有层级和叶子节点属性,前端可按此结构直接编写数据模型(TypeScript Interface)与页面绑定:
json5
{
/* ================= 1. 报告顶层元信息 (medical_record 主表) ================= */
"id": 10086, // [int] 报告唯一自增 ID (主键)
"session_id": "session_6407c5cc22f84c5a", // [string] 关联的问诊会话 ID
"pet_profile_id": 44, // [int] 关联的宠物档案 ID
"module_type": 1, // [int] 业务模块编号 (1: 智能问诊, 5: 宠物图片识别)
"report_type": "v1", // [int] 报告类型编号 (1: 主诉常规问诊报告)
"status": 2, // [int] 报告生成状态 (0: 未开始, 1: 生成中, 2: 已完成, 3: 失败)
"summary": "患宠出现频繁喷嚏伴水样鼻涕,初步诊断为猫上呼吸道感染...", // [string] 问诊对话全流程总结摘要
"report_time": "2026-09-16 14:30:00", // [string] 报告生成完成时间 (YYYY-MM-DD HH:mm:ss)
"lang": "zh-CN", // [string] 报告语言代码 (当前支持 zh-CN, en-US)
/* ================= 2. 宠物名片与基础体征 (pet_info 关联对象) ================= */
"pet_info": {
"id": 44, // [int] 宠物档案 ID
"name": "糯米", // [string] 宠物昵称
"avatar": "https://oss.example.com/pet.jpg", // [string] 宠物头像地址
"pet_type": 1, // [int] 宠物物种枚举 (1: 猫, 2: 狗, 3: 异宠)
"pet_variety": "英国短毛猫", // [string] 品种名称
"gender": 1, // [int] 性别 (1: 公, 2: 母, null: 未知)
"birthday": "2024-05-01", // [string] 出生日期 (YYYY-MM-DD)
"age": "1岁4个月", // [string] 换算后的展示年龄
"weight": "4.5", // [string] 登记体重数值 (kg)
"is_neutered": 1 // [int] 是否绝育 (0: 未绝育, 1: 已绝育, null: 未知)
},
/* ================= 3. 报告核心内容 (report 对象 / 各分片合并结果) ================= */
"report": {
/* --- 分片 1:病情回顾 (review · report_index = 1) --- */
"review": {
"chiefComplaint": "打喷嚏频繁,伴有清澈鼻涕,食欲轻微下降2天", // [string] 核心主诉 (就诊第一诉求)
"symptoms": "体温38.6℃正常,偶见干咳,精神尚可,无眼结膜红肿,未见呕吐腹泻" // [string] 症状详细特征与病程表现
},
/* --- 分片 2:初步诊断与检查项 (result · report_index = 2) --- */
"result": {
"diagnosis": {
"suspected": "猫上呼吸道感染(疑似疱疹病毒或支原体早期感染)", // [string] 首要疑似疾病大标题
"severity_of_the_illness": "Medium", // [string] 4 档病情严重度: Slight / Medium / Medium_high / Severe
"probability_level": "high", // [string] 诊断置信度: high(高) / medium(中) / low(低)
"description": "猫上呼吸道感染是猫常见呼吸系统病症,多由病毒或支原体引起...", // [string] 病症通俗医学科普说明
"basis": "结合未完全接种疫苗史,突发阵发性打喷嚏及水样分泌物,符合上呼吸道卡他性炎症特征。" // [string] AI 医学推导逻辑与判断依据
},
"externalImage": ["五官", "皮肤"], // [string[]] 体表高亮部位名称 (用于高亮前端体表插图)
"internalImage": ["气管", "肺部"], // [string[]] 内部器官高亮部位名称 (用于高亮内部器官图)
"skeletalImage": [], // [string[]] 骨骼系统高亮部位名称 (无异常则为空数组)
"EssentialCheckItems": "1. **猫呼吸道五联PCR核酸检测**:明确疱疹/杯状/衣原体感染源\n2. **血常规(CBC)**:评估全身白细胞与炎症状况", // [string] 必要检查项目 (支持 Markdown 渲染)
"RecommendCheckItems": "1. **SAA(猫淀粉样蛋白A)**:监测急性期炎症反应\n2. **胸腔DR拍片**:排查肺部是否有继发感染", // [string] 建议辅助检查项目 (支持 Markdown 渲染)
"other_suspected_diagnosis": [ // [object[]] 其他次要疑似诊断列表 (折叠面板展示)
{
"suspected": "过敏性鼻炎", // [string] 次要疑似疾病名称
"severity_of_the_illness": "Slight", // [string] 次要疾病严重度 (同 4 档枚举)
"description": "因吸入粉尘、花粉或刺激性气体导致的鼻腔黏膜变态反应。", // [string] 疾病简述
"basis": "若患宠近期使用粉尘较大的膨润土猫砂,存在过敏性诱发可能。" // [string] 鉴别诊断理由
}
]
},
/* --- 分片 3:分阶段治疗方案 (advice · report_index = 3) --- */
"advice": {
"is_urgent": "0", // [string] 是否需紧急送医标志 ("1": 紧急红标预警, "0": 常规居家)
/* [Tab 1] 初步治疗阶段 (居家应对 / 初期方案) */
"Initial_Treatment": {
"KeyPoint": "维持体温与室内适宜湿度,保持鼻腔清洁,对症控制继发细菌感染", // [string] 该阶段核心处理要点
"CheckPoint": "密切监测体温是否超过39.5℃,观察是否转为浓稠黄脓涕或出现拒食", // [string] 主人需重点观察的警惕体征
"medications": [ // [object[]] 推荐处置/药品/护理措施清单
{
"type": "药品", // [string] 项目类型标签 ("药品" / "饮食" / "护理" / "打针" / "手术")
"cause": "广谱抗敏抑菌,针对支原体及细菌性继发感染", // [string] 推荐该项目的医学原因
"Info": {
"name": "多西环素口服片(宠物专用)", // [string] 药品/项目通用名称
"form": "口服片剂", // [string|null] 剂型 (片剂 / 喷剂 / 膏剂 等)
"dosage": "5~10mg/kg,每次半片", // [string|null] 单次使用剂量 (已按体重适配)
"frequency": "每日 1 次", // [string|null] 给药/使用频次
"duration": "连续使用 5~7 天", // [string|null] 建议使用周期
"detail": null, // [string|null] 操作细节 (非药品项常用)
"additional_info": "饭后服用;喂药后建议喂 3~5ml 温水,防止药片黏附灼伤食道" // [string|null] 注意事项与禁忌说明
}
},
{
"type": "护理",
"cause": "湿化上呼吸道黏膜,软化鼻孔干燥分泌物,缓解鼻塞",
"Info": {
"name": "生理盐水雾化熏鼻",
"form": null,
"dosage": "医用生理盐水 5ml",
"frequency": "每日 2 次",
"duration": "每次 15 分钟",
"detail": "使用医用静音雾化机,将猫咪置入便携雾化箱中轻柔雾化",
"additional_info": "保持雾化箱通风,若猫咪极度抗拒应暂停避免应激"
}
}
]
},
/* [Tab 2] 持续加重阶段 (症状未缓解应对) */
"Persistent_Aggravation": {
"KeyPoint": "连续居家观察48小时未见好转、体温升高或精神萎靡,应及时就医调整用药",
"CheckPoint": "出现嗜睡不振、眼部有大量脓性分泌物导致睁眼困难、呼吸频率加快",
"medications": [
{
"type": "打针",
"cause": "提升机体抗病毒抗感染免疫应答",
"Info": {
"name": "重组猫干扰素皮下注射",
"form": "注射针剂",
"dosage": "30~50万单位/次",
"frequency": "隔日 1 次",
"duration": "连续使用 3 次",
"detail": "必须由线下正规宠物医院执业执业兽医执行皮下注射",
"additional_info": "切勿擅自在家购买针剂自行注射"
}
}
]
},
/* [Tab 3] 重度处理阶段 (危急情况紧急救治) */
"Intensive_Treatment": {
"KeyPoint": "患宠进入急性危重期,立即送医急诊救治,进行支持疗法并纠正脱水",
"CheckPoint": "张口呼吸、胸腹式呼吸起伏异常剧烈、牙龈黏膜发绀发白、完全拒食拒水超24小时",
"medications": [
{
"type": "护理",
"cause": "迅速缓解机体严重缺氧状态,稳定重要生命体征",
"Info": {
"name": "ICU 重症高压吸氧舱支持",
"form": null,
"dosage": null,
"frequency": "持续监护",
"duration": "急诊住院监护直到自主呼吸平稳",
"detail": "入住恒温恒湿医用氧舱,氧浓度维持在 35%~40%",
"additional_info": "运送途中头部保持平直,尽量避免颠簸与声光惊吓"
}
}
]
}
},
/* --- 分片 4:专业兽医嘱咐 (vet_order · report_index = 4) --- */
"vet_order": {
"vet_advise": "1. **环境温湿度**:保持室温在 23~26℃,避免空调直吹,湿度控制在 50%~60%。\n2. **多宠隔离**:呼吸道感染具有高传染性,若家中有多只猫咪,必须立即进行物理隔离,水盆食盆每日清洗沸水消毒。\n3. **饮食诱导**:生病期间嗅觉下降可能导致拒食,可微波温热高水分主食罐头或肉泥,提升适口性诱导主动进食。", // [string] 兽医综合护理指南 (Markdown 格式)
"follow_up": "若按初期方案用药 48 小时后精神明显好转、喷嚏频次下降,继续完成周期后随访;若用药 2 天内体温超过 39.5℃ 或出现喘息,请立即送医复查。" // [string] 复查节点与随访建议
},
/* --- 分片 7:营养与机体调理 (supplements · report_index = 7) --- */
"supplements": [
{
"cause": "补充必需氨基酸,与精氨酸竞争,抑制疱疹病毒复制与扩散",
"Info": {
"name": "猫用高纯度 L-赖氨酸营养膏",
"form": "膏剂",
"dosage": "每次约 2~3cm",
"frequency": "每日 1~2 次",
"duration": "急性发作期及康复期连续饲喂 2~3 周",
"detail": "可直接挤在鼻尖让猫自行舔食,或搅拌在主粮罐头中",
"additional_info": "保健品仅起辅助调节体质作用,不能代替处方抗感染药物"
}
}
]
}
}逐版块详细字段字典(Leaf-level Dictionary)
1. 报告头与名片信息
| 字段路径 | 数据类型 | 格式 / 枚举 | 中文解释 | 前端 UI 组件位置 |
|---|---|---|---|---|
id | integer | 正整数 | 报告唯一编号 | 顶部副标题(如 报告编号: #10086) |
session_id | string | 字符串 | 问诊会话编号 | 调试信息或右上方元数据栏 |
pet_profile_id | integer | 正整数 | 关联的宠物档案 ID | 跳转档案详情、埋点统计 |
module_type | integer | 1 智能问诊5 图片识别 | 业务模块编号 | 决定报告模板与渲染分支 |
report_type | string | 固定 "v1" | 报告版本标识(记录级);不是创建报告任务时传的数字 report_type | 版本兼容判断 |
lang | string | BCP 47,如 zh-CN | 报告语言 | 前端切换文案语言 |
status | integer | 0 未开始1 生成中2 已完成3 失败 | 报告生成状态 | 决定页面是渲染骨架屏/加载中/完成态/重试态 |
report_time | string | YYYY-MM-DD HH:mm:ss | 报告生成时间 | 报告创建时间戳显示 |
summary | string | 自由文本 | 问诊全过程总结摘要 | 顶部引言或“本次问诊小结”折叠横幅 |
pet_info.id | integer | 正整数 | 宠物档案 ID | 名片跳转与数据埋点 |
pet_info.avatar | string/null | URL | 宠物头像地址 | 名片圆角头像 |
pet_info.birthday | string/null | YYYY-MM-DD | 出生日期 | 用于计算并展示年龄 |
pet_info.name | string | 文本 | 宠物昵称 | 名片主标题加粗展示 |
pet_info.pet_type | integer | 1 猫2 狗3 异宠 | 宠物物种 | 决定名片物种图标(🐱 / 🐶 / 🐰) |
pet_info.pet_variety | string | 文本 | 品种名称 | 蓝色/灰色的品种标签(Tag) |
pet_info.gender | integer | 1 公2 母null 未知 | 性别枚举 | 性别角标(♂ 蓝 / ♀ 粉) |
pet_info.age | string | 文本 (如 "1岁4个月") | 计算后的展示年龄 | 年龄展示标签 |
pet_info.weight | string | 文本 (如 "4.5") | 登记体重 (单位 kg) | 体重展示标签 |
pet_info.is_neutered | integer | 0 未绝育1 已绝育null 未知 | 绝育状态 | “已绝育”或“未绝育”徽章 |
2. 病情回顾 (review · 分片 1)
| 字段路径 | 数据类型 | 格式说明 | 中文解释 | 前端 UI 组件位置 |
|---|---|---|---|---|
review.chiefComplaint | string | 文本 | 就诊核心主诉:主人最初反馈的核心不适。 | 回顾卡片第一行主标题(醒目引用样式) |
review.symptoms | string | 文本 | 详细症状与体征:伴随症状、病程持续时间。 | 主诉下方的详细叙述正文段落 |
3. 初步诊断与检查建议 (result · 分片 2)
核心诊断对象 (result.diagnosis)
| 字段路径 | 数据类型 | 格式 / 枚举 | 中文解释 | 前端 UI 组件位置 |
|---|---|---|---|---|
result.diagnosis.suspected | string | 疾病名称 | 疑似疾病名称:首要疑似病症。 | 诊断卡片主标题大字(如“猫上呼吸道感染”) |
result.diagnosis.severity_of_the_illness | string | Slight 轻微Medium 中等Medium_high 中高Severe 严重 | 病情严重程度等级(Prompt 严格限定为这 4 档,不会出现其他值) | 疾病标题旁的严重度彩色徽章(Badge): • Slight: 绿色 • Medium: 黄色 • Medium_high: 橙色 • Severe: 红色 |
result.diagnosis.probability_level | string | high 高medium 中low 低 | 诊断置信度 | 诊断卡片右上角置信度标签 |
result.diagnosis.description | string | Markdown / 文本 | 疾病科普说明:疾病成因与病理通俗解释。 | 诊断卡片第一段正文 |
result.diagnosis.basis | string | Markdown / 文本 | 判断依据:AI 推理逻辑与鉴别依据。 | 带背景色的“AI 医学推导依据”引用框 |
视觉部位高亮与检查项
| 字段路径 | 数据类型 | 说明 | 前端 UI 表现 |
|---|---|---|---|
result.externalImage | string[] | 严格限制在以下 7 个候选部位中:["五官", "颈部", "背部", "尾部", "四肢", "腹部", "皮肤"](可为空数组或多选) | 前端部位图点亮对应的体表热区层 |
result.internalImage | string[] | 严格限制在以下 12 个器官中:["肺部", "大脑", "气管", "心脏", "肝脏", "胃", "脾", "肾", "肠道", "生殖系统", "膀胱", "胰腺"] | 前端点亮对应的内部器官发光图 |
result.skeletalImage | string[] | 严格限制在以下 6 个骨骼部位中:["颅骨", "肋骨", "关节", "脊椎", "骨盆", "肢体骨"](为空数组则前端隐藏骨骼图) | 前端点亮对应的骨骼透视图 |
result.EssentialCheckItems | string | 必要检查项目清单(支持 Markdown) | “建议线下检查”中带必查红标的项目列表 |
result.RecommendCheckItems | string | 推荐辅助检查项目清单(支持 Markdown) | 辅助排查检查项目列表 |
次要疑似疾病列表 (result.other_suspected_diagnosis[])
数组长度 1~2 条(Prompt 要求最多 2 条,且必须与首要诊断 result.diagnosis.suspected 不同);信息不足时可能只返回 1 条。
| 字段路径 | 数据类型 | 中文解释 | 前端 UI 表现 |
|---|---|---|---|
[].suspected | string | 次要疑似疾病名称 | 折叠项标题 |
[].severity_of_the_illness | string | 该次要疾病严重程度(同 4 档枚举) | 折叠项右侧严重度小标签 |
[].description | string | 疾病简要概述 | 展开后第一段说明 |
[].basis | string | 鉴别诊断理由(为什么也有可能) | 展开后鉴别要点说明 |
4. 治疗与护理方案 (advice · 分片 3)
| 字段路径 | 数据类型 | 格式 / 枚举 | 中文解释与前端 UI 表现 |
|---|---|---|---|
advice.is_urgent | string | "1" 紧急"0" 不紧急 | 紧急就医红标:为 "1" 时在报告最上方弹出红色醒目就医 Alert 横幅,提示立即线下急诊。 |
advice.Initial_Treatment | object | 阶段对象 | 【初步治疗 / 居家初期】Tab 对应的数据对象。 |
advice.Persistent_Aggravation | object | 阶段对象 | 【持续加重处理】Tab 对应的数据对象。 |
advice.Intensive_Treatment | object | 阶段对象 | 【危急重度应对】Tab 对应的数据对象。 |
阶段对象内部属性(3 个阶段通用):
每个阶段对象内部均严格包含以下 3 个属性。注意 Initial_Treatment(初步治疗)阶段的用药被 Prompt 限定为 兽用非处方药,且该阶段不输出 "打针" 类型项目:
| 属性名 | 数据类型 | 中文解释 | 前端 UI 表现 |
|---|---|---|---|
KeyPoint | string | 处理要点 | 卡片顶部绿色/蓝色重点框,概述该阶段治疗原则。 |
CheckPoint | string | 观察重点 | 警示黄色/橙色重点框,提示主人重点留意的异常指标。 |
medications | object[] | 推荐项目列表 | 清单列表渲染,每一项结构见下方字典。 |
推荐处置项 (medications[]) 属性穿透:
| 字段路径 | 数据类型 | 说明 / 枚举 | 中文解释与 UI 表现 |
|---|---|---|---|
type | string | Prompt 规范值为 "药品" / "手术" / "饮食" / "打针";也可能出现 "护理" 等其他中文标签 | 项目类型标签:渲染为不同颜色的分类 Tag;未知值按默认样式降级,不要写死枚举判断分支。 |
cause | string | 文本 | 推荐原因 / 作用机制:药品名称下方的一句话说明。 |
Info.name | string | 文本 | 项目 / 药品通用名:清单粗体大标题。 |
Info.form | string | null | Prompt 示例值:口服 / 注射 / 外用 / 滴眼 / 滴耳 / 吸入(自由文本) | 剂型:药名右侧的小胶囊徽章。 |
Info.dosage | string | null | 如 "每次半片" | 单次使用剂量(根据宠物体重适配)。 |
Info.frequency | string | null | 如 "每日 1 次" | 使用频次。 |
Info.duration | string | null | 如 "连用 5~7 天";Prompt 要求不超过 8 个字 | 推荐使用周期。 |
Info.detail | string | null | 文本 | 具体实操步骤(护理、物理降温、吸氧等操作细则)。 |
Info.additional_info | string | null | 文本;药品项必须包含分类标签 【兽用处方药】 或 【兽用非处方药】 | 注意事项 / 禁忌说明:灰字小提示(如“饭后服用”);分类标签可单独渲染为徽章。 |
5. 专业兽医嘱咐 (vet_order · 分片 4)
| 字段路径 | 数据类型 | 格式 | 中文解释 | 前端 UI 组件位置 |
|---|---|---|---|---|
vet_order.vet_advise | string | Markdown 列表 | 兽医综合日常照料指南:环境温湿度、消毒隔离、日常饮食与饮水。 | 【兽医特别嘱咐】版块,支持多条序号渲染。 |
vet_order.follow_up | string | Markdown / 文本 | 复查节点与随访建议:好转时何时复诊、恶化时何时立刻送医。 | 【就诊与复查提醒】卡片。 |
6. 营养补充与辅助调理 (supplements · 分片 7)
若无营养建议,该字段返回空数组 [],前端整块隐藏。数组项属性结构如下:
| 字段路径 | 数据类型 | 说明 | 中文解释与 UI 表现 |
|---|---|---|---|
[].cause | string | 推荐理由 | 营养品作用机制解释。 |
[].Info.name | string | 营养品品名 | 保健品/营养剂名称。 |
[].Info.form | string | null | 剂型 | 膏剂、粉剂、滴剂等。 |
[].Info.dosage | string | null | 剂量 | 每次喂食量。 |
[].Info.frequency | string | null | 频次 | 每日喂食频次。 |
[].Info.duration | string | null | 周期 | 补充疗程。 |
[].Info.detail | string | null | 喂养细节 | 喂食方法说明(如“可混入主粮或罐头”)。 |
[].Info.additional_info | string | null | 注意事项;通常声明保健品不可代替处方药 | 与 medications[].Info 同结构,但不带处方/非处方分类标签。 |
前端数据合并与解析标准逻辑(参考代码)
接入方在拉取报告数据时,建议封装如下标准解析工具函数:
javascript
/**
* 格式化并组装完整的问诊报告对象
* @param {Object} responseData - API 返回的 data 对象
* @returns {Object} 具备完整层级的报告数据
*/
export function formatConsultationReport(responseData) {
if (!responseData) return null;
// 1. 初始化 report 基底对象
let report = responseData.report ? JSON.parse(JSON.stringify(responseData.report)) : {};
// 2. 如果存在分片列表 report_contents,按 report_index 顺序深合并
if (Array.isArray(responseData.report_contents)) {
const sortedContents = responseData.report_contents
.slice()
.sort((a, b) => (a.report_index || 0) - (b.report_index || 0));
for (const part of sortedContents) {
try {
const parsed = typeof part.content === 'string' ? JSON.parse(part.content) : part.content;
if (parsed && typeof parsed === 'object') {
// 合入各分片根属性 (review, result, advice, vet_order, supplements)
report = { ...report, ...parsed };
}
} catch (err) {
console.warn(`[Report] 解析分片 index=${part.report_index} 失败:`, err);
}
}
}
// 3. 将外层元数据和宠物名片打包进统一模型
return {
meta: {
id: responseData.id || responseData.report_id,
sessionId: responseData.session_id,
status: responseData.status,
reportTime: responseData.report_time || responseData.created_at,
summary: responseData.summary,
lang: responseData.lang || 'zh-CN'
},
petInfo: responseData.pet_info || {},
report: report
};
}