核心用法
WiseOCR 是一款基于 WiseDiag 云端 API 的文档识别工具，专用于将单页 PDF 或图片（jpg、png、webp、tiff 等）转换为 Markdown 格式。用户通过命令行调用 wiseocr.py 脚本，传入输入文件路径即可完成 OCR，结果自动保存至 ~/.openclaw/workspace/WiseOCR/ 目录。脚本支持 -n 参数自定义输出文件名、--dpi 调整 PDF 渲染精度（72-600），以及 -o 指定输出目录，适合批量集成或自动化工作流。
显著优点
1. 高精度识别引擎：依托 WiseDiag 云端 OCR，对复杂表格、多栏排版、扫描件均有较好识别效果。
2. 多格式支持：原生兼容 PDF、常见图片格式及 TIFF，覆盖办公与档案数字化场景。
3. Markdown 原生输出：直接生成结构化 Markdown，省去二次排版，适合技术文档、论文、报告的快速入库。
4. 零本地依赖：无需本地安装 Tesseract 或深度学习框架，降低部署门槛。
潜在缺点与局限性
- 云端隐私风险：文件必须上传至 WiseDiag 服务器处理，存在数据跨境传输与临时存储风险，严禁用于含身份证、银行卡、密码等敏感信息的文档。
- 网络依赖：离线环境或弱网条件下无法使用，且 API 可用性受服务商 SLA 制约。
- 单文件限制：每次仅处理单个文件，批量场景需自行编写循环脚本。
- 密钥管理成本：需注册并妥善保管
WISEDIAG_API_KEY，存在泄露或被滥用的可能。
适合人群
- 需要将印刷版技术手册、学术论文、会议资料快速转为可编辑 Markdown 的开发者与知识管理者；
- 对本地 OCR 精度不满意、且文档不涉及敏感商业或个人隐私的团队；
- 希望在 CI/CD 或自动化脚本中集成文档数字化能力的 DevOps 工程师。
常规风险
- 数据外泄：上传文件可能被 WiseDiag 临时缓存或用于模型优化（需仔细阅读其隐私政策）；
- 合规隐患：处理含 PII（个人身份信息）或受监管行业数据时，可能违反 GDPR、CCPA 或企业内控规定；
- API 密钥泄露：若密钥硬编码于脚本或日志中，可能导致账号被盗用或产生额外费用。建议配合环境变量与密钥管理服务使用。