Skip to content

智能问诊报告字段详解与页面映射 ​

本文档详细列出**智能问诊报告(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 组件位置
idinteger正整数报告唯一编号顶部副标题(如 报告编号: #10086)
session_idstring字符串问诊会话编号调试信息或右上方元数据栏
pet_profile_idinteger正整数关联的宠物档案 ID跳转档案详情、埋点统计
module_typeinteger1 智能问诊
5 图片识别
业务模块编号决定报告模板与渲染分支
report_typestring固定 "v1"报告版本标识(记录级);不是创建报告任务时传的数字 report_type版本兼容判断
langstringBCP 47,如 zh-CN报告语言前端切换文案语言
statusinteger0 未开始
1 生成中
2 已完成
3 失败
报告生成状态决定页面是渲染骨架屏/加载中/完成态/重试态
report_timestringYYYY-MM-DD HH:mm:ss报告生成时间报告创建时间戳显示
summarystring自由文本问诊全过程总结摘要顶部引言或“本次问诊小结”折叠横幅
pet_info.idinteger正整数宠物档案 ID名片跳转与数据埋点
pet_info.avatarstring/nullURL宠物头像地址名片圆角头像
pet_info.birthdaystring/nullYYYY-MM-DD出生日期用于计算并展示年龄
pet_info.namestring文本宠物昵称名片主标题加粗展示
pet_info.pet_typeinteger1 猫
2 狗
3 异宠
宠物物种决定名片物种图标(🐱 / 🐶 / 🐰)
pet_info.pet_varietystring文本品种名称蓝色/灰色的品种标签(Tag)
pet_info.genderinteger1 公
2 母
null 未知
性别枚举性别角标(♂ 蓝 / ♀ 粉)
pet_info.agestring文本 (如 "1岁4个月")计算后的展示年龄年龄展示标签
pet_info.weightstring文本 (如 "4.5")登记体重 (单位 kg)体重展示标签
pet_info.is_neuteredinteger0 未绝育
1 已绝育
null 未知
绝育状态“已绝育”或“未绝育”徽章

2. 病情回顾 (review · 分片 1) ​

字段路径数据类型格式说明中文解释前端 UI 组件位置
review.chiefComplaintstring文本就诊核心主诉:主人最初反馈的核心不适。回顾卡片第一行主标题(醒目引用样式)
review.symptomsstring文本详细症状与体征:伴随症状、病程持续时间。主诉下方的详细叙述正文段落

3. 初步诊断与检查建议 (result · 分片 2) ​

核心诊断对象 (result.diagnosis) ​

字段路径数据类型格式 / 枚举中文解释前端 UI 组件位置
result.diagnosis.suspectedstring疾病名称疑似疾病名称:首要疑似病症。诊断卡片主标题大字(如“猫上呼吸道感染”)
result.diagnosis.severity_of_the_illnessstringSlight 轻微
Medium 中等
Medium_high 中高
Severe 严重
病情严重程度等级(Prompt 严格限定为这 4 档,不会出现其他值)疾病标题旁的严重度彩色徽章(Badge):
• Slight: 绿色
• Medium: 黄色
• Medium_high: 橙色
• Severe: 红色
result.diagnosis.probability_levelstringhigh 高
medium 中
low 低
诊断置信度诊断卡片右上角置信度标签
result.diagnosis.descriptionstringMarkdown / 文本疾病科普说明:疾病成因与病理通俗解释。诊断卡片第一段正文
result.diagnosis.basisstringMarkdown / 文本判断依据:AI 推理逻辑与鉴别依据。带背景色的“AI 医学推导依据”引用框

视觉部位高亮与检查项 ​

字段路径数据类型说明前端 UI 表现
result.externalImagestring[]严格限制在以下 7 个候选部位中:["五官", "颈部", "背部", "尾部", "四肢", "腹部", "皮肤"](可为空数组或多选)前端部位图点亮对应的体表热区层
result.internalImagestring[]严格限制在以下 12 个器官中:["肺部", "大脑", "气管", "心脏", "肝脏", "胃", "脾", "肾", "肠道", "生殖系统", "膀胱", "胰腺"]前端点亮对应的内部器官发光图
result.skeletalImagestring[]严格限制在以下 6 个骨骼部位中:["颅骨", "肋骨", "关节", "脊椎", "骨盆", "肢体骨"](为空数组则前端隐藏骨骼图)前端点亮对应的骨骼透视图
result.EssentialCheckItemsstring必要检查项目清单(支持 Markdown)“建议线下检查”中带必查红标的项目列表
result.RecommendCheckItemsstring推荐辅助检查项目清单(支持 Markdown)辅助排查检查项目列表

次要疑似疾病列表 (result.other_suspected_diagnosis[]) ​

数组长度 1~2 条(Prompt 要求最多 2 条,且必须与首要诊断 result.diagnosis.suspected 不同);信息不足时可能只返回 1 条。

字段路径数据类型中文解释前端 UI 表现
[].suspectedstring次要疑似疾病名称折叠项标题
[].severity_of_the_illnessstring该次要疾病严重程度(同 4 档枚举)折叠项右侧严重度小标签
[].descriptionstring疾病简要概述展开后第一段说明
[].basisstring鉴别诊断理由(为什么也有可能)展开后鉴别要点说明

4. 治疗与护理方案 (advice · 分片 3) ​

字段路径数据类型格式 / 枚举中文解释与前端 UI 表现
advice.is_urgentstring"1" 紧急
"0" 不紧急
紧急就医红标:为 "1" 时在报告最上方弹出红色醒目就医 Alert 横幅,提示立即线下急诊。
advice.Initial_Treatmentobject阶段对象【初步治疗 / 居家初期】Tab 对应的数据对象。
advice.Persistent_Aggravationobject阶段对象【持续加重处理】Tab 对应的数据对象。
advice.Intensive_Treatmentobject阶段对象【危急重度应对】Tab 对应的数据对象。

阶段对象内部属性(3 个阶段通用): ​

每个阶段对象内部均严格包含以下 3 个属性。注意 Initial_Treatment(初步治疗)阶段的用药被 Prompt 限定为 兽用非处方药,且该阶段不输出 "打针" 类型项目:

属性名数据类型中文解释前端 UI 表现
KeyPointstring处理要点卡片顶部绿色/蓝色重点框,概述该阶段治疗原则。
CheckPointstring观察重点警示黄色/橙色重点框,提示主人重点留意的异常指标。
medicationsobject[]推荐项目列表清单列表渲染,每一项结构见下方字典。

推荐处置项 (medications[]) 属性穿透: ​

字段路径数据类型说明 / 枚举中文解释与 UI 表现
typestringPrompt 规范值为 "药品" / "手术" / "饮食" / "打针";也可能出现 "护理" 等其他中文标签项目类型标签:渲染为不同颜色的分类 Tag;未知值按默认样式降级,不要写死枚举判断分支。
causestring文本推荐原因 / 作用机制:药品名称下方的一句话说明。
Info.namestring文本项目 / 药品通用名:清单粗体大标题。
Info.formstring | nullPrompt 示例值:口服 / 注射 / 外用 / 滴眼 / 滴耳 / 吸入(自由文本)剂型:药名右侧的小胶囊徽章。
Info.dosagestring | null如 "每次半片"单次使用剂量(根据宠物体重适配)。
Info.frequencystring | null如 "每日 1 次"使用频次。
Info.durationstring | null如 "连用 5~7 天";Prompt 要求不超过 8 个字推荐使用周期。
Info.detailstring | null文本具体实操步骤(护理、物理降温、吸氧等操作细则)。
Info.additional_infostring | null文本;药品项必须包含分类标签 【兽用处方药】 或 【兽用非处方药】注意事项 / 禁忌说明:灰字小提示(如“饭后服用”);分类标签可单独渲染为徽章。

5. 专业兽医嘱咐 (vet_order · 分片 4) ​

字段路径数据类型格式中文解释前端 UI 组件位置
vet_order.vet_advisestringMarkdown 列表兽医综合日常照料指南:环境温湿度、消毒隔离、日常饮食与饮水。【兽医特别嘱咐】版块,支持多条序号渲染。
vet_order.follow_upstringMarkdown / 文本复查节点与随访建议:好转时何时复诊、恶化时何时立刻送医。【就诊与复查提醒】卡片。

6. 营养补充与辅助调理 (supplements · 分片 7) ​

若无营养建议,该字段返回空数组 [],前端整块隐藏。数组项属性结构如下:

字段路径数据类型说明中文解释与 UI 表现
[].causestring推荐理由营养品作用机制解释。
[].Info.namestring营养品品名保健品/营养剂名称。
[].Info.formstring | null剂型膏剂、粉剂、滴剂等。
[].Info.dosagestring | null剂量每次喂食量。
[].Info.frequencystring | null频次每日喂食频次。
[].Info.durationstring | null周期补充疗程。
[].Info.detailstring | null喂养细节喂食方法说明(如“可混入主粮或罐头”)。
[].Info.additional_infostring | 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
  };
}
最近更新

栖界开放平台 · API Documentation