金大哥 - PathClaw Skill 详情

概述

本技能封装了华银康集团 PathClaw 泛癌预测服务的完整调用流程。接收 .svs 病理切片文件后，自动完成用户认证、任务提交、结果轮询，并返回 AI 辅助诊断结论与热力图链接。

工作流程

前置要求

用户必须提供病理切片文件路径（.svs 格式）。若用户未提供，须询问：

请提供病理切片文件路径，例如：C:\path\to\slide.svs

第一步：获取认证 Token

curl -X POST https://pathclaw.pathologyunion.com/api/user/login

从响应中提取 data.token。此 token 必须包含在后续请求的 Authorization: Bearer <token> 请求头中。

第二步：启动诊断任务

重要：上传文件必须为 .svs 格式。若校验失败，须终止操作并提示用户： 该文件不是有效的病理切片格式（应为 .svs 格式）

文件校验规则（执行上传前必须全部通过）

文件路径必须存在，且为普通文件（非目录）。
文件必须可读（当前进程有读取权限）。
文件大小必须大于 0 字节。
后缀名必须是 .svs（大小写不敏感，如 .SVS 也允许）。
任一校验失败都必须立即终止，不得继续调用诊断接口。

验证失败示例：C:\Users\HYK\Desktop\SKILL.md → 提示 该文件不是有效的病理切片格式（应为 .svs 格式）

curl -X POST https://pathclaw.pathologyunion.com/api/v1/diagnosis/run \
  -H "Authorization: Bearer <token>" \
  -F "slide_file=@/path/to/slide_file"

响应中包含 data.slide_id，保存此 ID 用于下一步。

第三步：获取诊断结果

启动诊断后等待 10 秒，然后请求：

curl -X GET https://pathclaw.pathologyunion.com/api/v1/diagnosis/<slide_id>/result \
  -H "Authorization: Bearer <token>"

ai_diagnosis_status 状态码：

| 状态码 | 含义 | | ------ | -------- | | 0 | 未知 | | 1 | 排队中 | | 2 | 队列中 | | 3 | 分析中 | | 4 | 分析成功 | | 5 | 分析失败 |

安全与异常处理要求

Token 安全
- 日志中禁止输出完整 token。
- 如需调试，仅允许脱敏输出（例如前 6 位 + ***）。
网络与超时
- 每次 HTTP 请求必须设置超时（建议连接超时 10 秒、读取超时 60 秒）。
- 超时或网络错误时最多重试 2 次（指数退避：1s、2s）。
- 超过重试上限后返回明确失败信息并停止流程。
HTTP 状态码处理
- 2xx：按正常流程解析。
- 401/403：提示认证失败或 token 失效，终止流程。
- 4xx：提示请求参数错误（包含文件或接口参数问题），终止流程。
- 5xx：提示服务端异常，可按重试策略重试，失败后终止。
结果状态处理
- 当状态为 1/2/3：继续轮询。
- 当状态为 4：输出最终诊断结果。
- 当状态为 5：输出“分析失败”及返回错误信息，终止流程。
- 当状态为 0 或未知值：按异常状态处理并终止流程。

API 概要

| 步骤 | 方法 | 端点 | 认证 | 请求体 | | ----------- | ---- | --------------------------------------- | ------------ | -------------------------- | | 1. 登录 | POST | /api/user/login | 无 | 无 | | 2. 启动诊断 | POST | /api/v1/diagnosis/run | Bearer token | slide_file (multipart) | | 3. 获取结果 | GET | /api/v1/diagnosis/{slide_id}/result | Bearer token | 无 |

输出规范

执行过程中须按以下规范输出：

初始化阶段：输出 正在确认用户信息及状态...
上传与调用阶段：输出 已完成用户信息确认。\n调用 **华银康集团 PathClaw 服务** 进行泛癌预测。
推理等待阶段：首次轮询输出 切片已完成上传，正在推理中...
- 若进入第二次及后续轮询，输出 结果仍在推理中，请您耐心等待...
最终诊断结果分析：纯文本 + 无序列表输出，模板如下：

当前切片已完成推理。该切片 {{file_name}} 经过 华银康集团 PathClaw 服务 辅助诊断，提示"{{diagnosis_result}}"，建议进一步做病理复查或免疫组化检测以明确诊断。
热力图请点击查看以下链接：{{short_link}}
本次AI辅助诊断结果仅供参考，不构成最终诊断建议。最终诊断应由专业医师结合临床情况及其他检查结果进行判断。