ClawHub

PathClaw

Security

通过华银康集团 PathClaw 服务对病理切片进行泛癌 AI 辅助诊断，适用于病理科医生或研究人员在收到切片图像后的初步筛查场景。当用户提供 .svs 格式的病理切片文件时，自动完成：认证登录、提交诊断任务、轮询推理结果、返回诊断结论及热力图链接。触发条件：用户请求分析病理切片、进行泛癌预测、肿瘤筛查、或提到 PathClaw。注意：用户必须提供有效的 .svs 病理切片文件路径，未提供时须提醒用户。

Install

openclaw skills install pathclaw

概述

本技能封装了华银康集团 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 格式）

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

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

验证失败示例：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分析失败

安全与异常处理要求

  1. Token 安全

    • 日志中禁止输出完整 token。
    • 如需调试，仅允许脱敏输出（例如前 6 位 + ***）。

  2. 网络与超时

    • 每次 HTTP 请求必须设置超时（建议连接超时 10 秒、读取超时 60 秒）。
    • 超时或网络错误时最多重试 2 次（指数退避：1s、2s）。
    • 超过重试上限后返回明确失败信息并停止流程。

  3. HTTP 状态码处理

    • 2xx：按正常流程解析。
    • 401/403：提示认证失败或 token 失效，终止流程。
    • 4xx：提示请求参数错误（包含文件或接口参数问题），终止流程。
    • 5xx：提示服务端异常，可按重试策略重试，失败后终止。

  4. 结果状态处理

    • 当状态为 1/2/3：继续轮询。
    • 当状态为 4：输出最终诊断结果。
    • 当状态为 5：输出“分析失败”及返回错误信息，终止流程。
    • 当状态为 0 或未知值：按异常状态处理并终止流程。

API 概要

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

输出规范

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

  1. 初始化阶段：输出 正在确认用户信息及状态...
  2. 上传与调用阶段：输出 已完成用户信息确认。\n调用 **华银康集团 PathClaw 服务** 进行泛癌预测。
  3. 推理等待阶段：首次轮询输出 切片已完成上传，正在推理中...
    • 若进入第二次及后续轮询，输出 结果仍在推理中，请您耐心等待...
  4. 最终诊断结果分析：纯文本 + 无序列表输出，模板如下：
  • 当前切片已完成推理。该切片 {{file_name}} 经过 华银康集团 PathClaw 服务 辅助诊断，提示"{{diagnosis_result}}"，建议进一步做病理复查或免疫组化检测以明确诊断。
  • 热力图请点击查看以下链接：{{short_link}}
  • 本次AI辅助诊断结果仅供参考，不构成最终诊断建议。最终诊断应由专业医师结合临床情况及其他检查结果进行判断。
More in Security