核心用法
本技能为阿里巴巴旗下夸克扫描王官方提供的多场景 OCR 文字识别服务，需通过 SCAN_WEBSERVICE_KEY 环境变量配置 API 密钥后使用。支持三种图片输入方式：URL 链接、本地文件路径、BASE64 编码数据。采用"单一意图优先匹配"机制，按 17 个预设场景自上而下匹配用户意图，命中即执行对应场景识别。
执行流程：环境变量检查 → 输入类型识别 → 意图匹配确定 scene → 构建固定格式命令 → 原样返回结果。
显著优点
1. 场景覆盖全面：17 个专业识别场景，涵盖手写文档、表格、身份证、社保卡、港澳通行证、学位证、增值税发票、火车票、公式、题目、驾驶证、行驶证、英文发票、医疗报告、营业执照、商品图片及通用文字提取。
2. 识别精度高：针对中文场景优化，手写识别、复杂表格结构还原、证件关键字段提取均达到商用级别准确度。
3. 格式兼容广泛：支持 jpg/jpeg/png/gif/bmp/webp/tiff/wbmp 等主流图片格式。
4. 官方服务稳定：T2 可信来源（阿里巴巴/夸克官方），HTTPS 加密传输，服务可用性有保障。
潜在缺点与局限性
1. 强制数据外传：所有图片必须上传至夸克官方服务器 (scan-business.quark.cn) 处理，无法本地离线识别，存在数据隐私风险。
2. 单张处理限制：不支持批量图片处理，每次调用仅限单张图片，效率受限。
3. 文件大小限制：本地文件不超过 5MB，超大图片需预处理。
4. 外部依赖强：核心功能完全依赖夸克 API 可用性，网络中断或服务故障将导致不可用。
5. 无重试机制：当前实现请求失败直接返回，未内置网络波动容错。
适合人群
- 个人用户：快速提取手写笔记、截图文字、证件信息
- 财务人员：增值税发票、火车票、英文发票的自动化报销处理
- 教育工作者/学生：公式转 LaTeX、习题题目提取、试卷数字化
- 企业行政：营业执照、各类证件的批量信息录入（需自行循环调用）
- 医疗从业者：化验单、报告单的结构化数据提取
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **数据隐私泄露** | 敏感证件图片上传第三方服务器 | 避免上传含极高敏感信息的照片，使用可信网络环境 |
| **API 密钥泄露** | `SCAN_WEBSERVICE_KEY` 配置不当可能导致未授权使用 | 妥善保管密钥，不硬编码在代码中 |
| **服务可用性** | 依赖夸克服务器状态 | 关键业务需准备备用识别方案 |
| **合规风险** | 企业用户需评估是否符合内部数据出境规定 | 使用前咨询法务/安全团队 |