- name
- PathClaw
- description
- 通过华银康集团 PathClaw 服务对病理切片进行泛癌 AI 辅助诊断，适用于病理科医生或研究人员在收到切片图像后的初步筛查场景。当用户提供 .svs 格式的病理切片文件时，自动完成：认证登录、提交诊断任务、轮询推理结果、返回诊断结论及热力图链接。触发条件：用户请求分析病理切片、进行泛癌预测、肿瘤筛查、或提到 PathClaw。注意：用户必须提供有效的 .svs 病理切片文件路径，未提供时须提醒用户。
概述
本技能封装了华银康集团 PathClaw 泛癌预测服务的完整调用流程。接收 .svs 病理切片文件后，自动完成用户认证、任务提交、结果轮询，并返回 AI 辅助诊断结论与热力图链接。
工作流程
前置要求
用户必须提供病理切片文件路径（.svs 格式）。若用户未提供，须询问：
请提供病理切片文件路径，例如：C:\path\ o\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 | 无 |
输出规范
执行过程中须按以下规范输出：
- 初始化阶段：输出
正在确认用户信息及状态... - 上传与调用阶段：输出 `已完成用户信息确认。\
调用 华银康集团 PathClaw 服务 进行泛癌预测。`
- 推理等待阶段：首次轮询输出
切片已完成上传，正在推理中...
- 若进入第二次及后续轮询，输出 结果仍在推理中，请您耐心等待...
- 最终诊断结果分析：纯文本 + 无序列表输出，模板如下：
- 当前切片已完成推理。该切片 {{file_name}} 经过 华银康集团 PathClaw 服务 辅助诊断，提示"{{diagnosis_result}}"，建议进一步做病理复查或免疫组化检测以明确诊断。
- 热力图请点击查看以下链接：{{short_link}}
- 本次AI辅助诊断结果仅供参考，不构成最终诊断建议。最终诊断应由专业医师结合临床情况及其他检查结果进行判断。