技能介绍

解决什么实际问题

在将 Eagle Doc API 接入到后端服务或自动化脚本时，开发者通常会面临两个具体痛点：一是缺乏直观的 API 用量与配额监控手段，容易在账单周期末尾才发现额度耗尽导致服务中断；二是财务票据（如发票、收据）的结构化提取流程繁琐，需要自行处理文件上传、轮询状态以及解析非结构化的 OCR 响应。

这个技能将这两项高频操作封装成了标准化的 CLI 动作。你不需要在代码中硬编码 API Key，也不需要针对 Eagle Doc 的鉴权机制写一堆样板代码。

核心能力与工作流

该技能基于 oo CLI 运行，通过 OOMOL 服务端注入凭据，这意味着你的本地环境或 CI/CD 管道中不会暴露明文 Token。它暴露了 5 个核心动作，主要分为两类：

用量与账单审计：通过 get_current_usage、get_quota 和 list_monthly_usage，你可以快速获取当前计费周期的调用计数、整体配额余量以及包含价格元数据的历史月度报表。list_usage_logs 则用于排查具体的请求日志和页数消耗。
财务文档 OCR：process_finance_document 动作允许你直接上传单张发票、收据或 PDF 文件，Eagle Doc 会返回结构化的提取结果，省去了手动拼接 HTTP 请求和处理回调的麻烦。

标准的调用逻辑非常直接：首先使用 oo connector schema 拉取最新的输入/输出契约，确认必填字段；然后构建符合规范的 JSON payload，通过 --data 参数传入。返回的响应中包含 meta.executionId，便于你在日志系统中追踪这次执行。

适用边界与工程注意点

在生产环境中集成时，请留意该技能默认假定 oo CLI 已经安装且账号处于已登录状态。如果遇到 command not found 或 Not signed in 错误，才需要引导用户进行一次性的初始化配置。

状态变更与破坏性操作需谨慎。读取类动作（如 get 或 list）可以直接运行，但涉及上传和 OCR 的动作会触发外部 API 调用并可能产生计费。在执行 process_finance_document 之前，应始终向用户确认具体的文件路径和预期效果。此外，如果遇到 HTTP 402 错误，说明 OOMOL 账户余额不足，需要先完成充值才能继续调用。