CareMax 医疗记录

需要将 caremax-auth 作为同级目录 (../caremax-auth/)。如果缺失，请告知用户先安装 caremax-auth（例如 npx skills add KittenYang/caremax-skills）。

前置条件 — 自动认证（必须）

bash
APICALL=bash ../caremax-auth/scripts/api-call.sh

如果 api-call.sh 返回 {error:nocredentials,...} → 立即运行 bash ../caremax-auth/scripts/auth-flow.sh [baseurl]（从本技能的根目录执行）。

智能搜索（推荐）

使用 searchText 进行自然语言查询。后端执行 4 层搜索：

1. 1. LLM 关键词提取（将喝酒映射为ALDH2 酒精代谢）
2. 对报告标题、摘要、章节、指标进行 LIKE 搜索
3. 语义向量搜索（BGE-M3 → Zilliz）
4. RAG：DeepSeek-V3.2 生成带引用的自然语言回答

bash
$APICALL POST /api/skill/records/query {searchText:我有哪个基因不能喝酒}
$APICALL POST /api/skill/records/query {searchText:我猝死的概率大吗}
$APICALL POST /api/skill/records/query {searchText:降压药建议}
$APICALL POST /api/skill/records/query {searchText:MTHFR}

响应：
json
{
type: search,
query: ...,
data: [...], // 匹配的记录（已丰富）
totalCount: 1,
semanticHits: [ // 向量相似度前 10 名
{text: ..., score: 0.61, recordId: xxx}
],
rag: { // AI 自然语言回答
answer: 根据您的基因检测报告...[来源1][来源2],
citations: [
{index: 1, source: 脑梗塞风险评估, relevance: 高}
]
}
}

向用户展示 rag.answer。 其中包含带引用来源的直接回答。

结构化查询

bash

按日期范围

$APICALL POST /api/skill/records/query {dateRange:[2025-01-01,2025-12-31]}

按指标名称

$APICALL POST /api/skill/records/query {indicatorName:血红蛋白}

按报告标题

$APICALL POST /api/skill/records/query {reportTitle:血常规}

按记录 ID（单条记录详情）

$APICALL POST /api/skill/records/query {recordId:uuid}

按成员 + 分页

$APICALL POST /api/skill/records/query {memberId:member-uuid,page:1,limit:20}

报告类型

系统支持多种报告类型：

• - lab：标准实验室报告（包含名称/数值/单位/参考范围的指标）
• genetic：基因检测报告（包含基因/SNP/基因型/风险等级的章节）
• imaging：影像学报告（包含部位/发现/印象的章节）
• pathology：病理报告（包含组织/分级/分期的章节）
• other：其他任何医疗文档

非实验室报告使用 report_type、summary 和 sections[] 字段，而非 indicators[]。

AI 对话（推荐）

使用 /api/skill/chat 进行 AI 对话。所有对话自动保存到历史记录。

bash

提问（自动搜索 + RAG + 保存历史）

$APICALL POST /api/skill/chat {question:我有哪个基因不能喝酒}
$APICALL POST /api/skill/chat {question:我的降压药应该怎么吃}

针对某份报告提问

$APICALL POST /api/skill/chat {question:这份报告有什么建议,recordId:uuid}

响应：
json
{
id: chat-uuid,
question: ...,
answer: 根据您的报告...[来源1],
citations: [{index:1,source:...,relevance:高,quote:原文...}],
recordId: null,
created_at: ...
}

向用户展示 answer。 引用中包含原始报告文本。

bash

获取历史记录

$APICALL GET /api/skill/chat/history

删除单条

$APICALL DELETE /api/skill/chat/

清空所有

$APICALL DELETE /api/skill/chat

推荐工作流程

用户：我的基因检测报告说了什么
bash
$APICALL POST /api/skill/chat {question:我的基因检测报告说了什么}

用户：show my recent check-up results
bash
$APICALL POST /api/skill/records/query {dateRange:[2025-01-01,2025-06-30]}

用户：我的降压药应该怎么吃
bash
$APICALL POST /api/skill/chat {question:我的降压药应该怎么吃}