核心用法
本技能封装了 Sugon-Scnet 医疗发票识别 OCR 服务，通过简单的命令行或 AI 对话即可调用。用户只需指定 ocrType 为 MEDICAL_INVOICE 并提供本地图片路径（支持 jpg、png、pdf 等格式），即可获取结构化的识别结果。技能会自动处理图片上传、API 调用和结果解析，输出包含发票关键字段的 JSON 数据，置信度信息帮助判断识别可靠性。
在 AI 对话场景中，用户可直接说"帮我识别这张医疗发票，图片在 /Users/name/Downloads/invoice.jpg"，AI 会自动触发本技能完成识别。命令行用户可通过 python scripts/main.py MEDICAL_INVOICE /path/to/invoice.jpg 直接调用。
显著优点
识别精准专业：针对医疗发票场景优化，可自动提取医院名称、金额、日期、项目明细等关键字段，减少人工录入错误。接入便捷低门槛：单一接口覆盖完整能力，无需复杂配置，MIT 开源协议允许自由使用和二次开发。安全架构透明：代码结构清晰无危险函数，依赖极少（仅 requests），HTTPS 加密传输保障数据安全，SCNet T2 级可信来源提供背书。成本效益突出：相比自建 OCR 基础设施，直接调用云端服务大幅降低开发和运维成本。
潜在缺点与局限性
外部服务依赖：核心识别能力依赖 SCNet 云端 API，需稳定的网络连接，离线场景无法使用；存在 10 QPS 速率限制，高频批量处理需串行调用。隐私合规考量：医疗发票属于敏感个人健康信息（PHI），上传至第三方服务需用户明确知情同意，高隐私要求场景可能受限。功能边界明确：当前仅支持医疗发票单一类型，无法处理其他票据或通用 OCR 场景。配置管理成本：API Key 需手动申请和配置，Token 过期需人工更新，缺乏自动轮转机制。
适合的目标群体
保险理赔自动化场景：需要批量处理医疗发票进行理赔审核的保险公司或第三方TPA机构。企业费用管理系统：希望简化员工医疗报销流程、自动提取发票信息的财务和HR部门。医疗健康应用开发者：构建在线问诊、健康管理App时需要快速集成票据识别能力的开发团队。个人效率用户：经常需要整理医疗票据、进行保险报销或医疗费用统计的个人用户。
使用风险与注意事项
性能与稳定性风险：外部 API 调用存在网络延迟，单次识别通常耗时 1-3 秒；高峰期可能遇到 429 限流错误，技能内置 3 次重试机制但仍需合理设计调用节奏。凭证安全风险：API Key 以环境变量形式存储，需严格设置 .env 文件权限为 600，避免泄露导致账户被滥用。数据残留风险：用户医疗发票图片上传至 SCNet 服务器，需确认服务商的数据处理和删除政策，敏感场景建议优先使用本地处理方案。路径遍历风险：当前文件路径验证相对简单，处理不可信来源的文件路径时建议额外加固。