核心用法
EasyLink EasyDoc Parse 是一个用于调用 EasyDoc 异步文档解析 API 的 Skill，主要功能是将 PDF、Word 等非结构化文档转换为结构化的 JSON 或 Markdown 格式，供下游 LLM 流程消费。
双平台支持：
- 中国版（cn）：基于
https://api.easylink-ai.com，提供easydoc-parse-flash（快速）和easydoc-parse-premium（高精度）两种解析模式，文件字段为files。 - 全球版（global）：基于
https://api.easydoc.sh，提供lite单一模式，文件字段为file。
标准生命周期：选择平台 → 验证输入（API key、文件类型/大小 ≤100MB、解析模式）→ 提交异步任务 → 轮询结果 → 标准化输出。若用户未指定平台，需主动询问；若缺少 API key，提供对应平台的注册与密钥管理指引。
输出标准化：无论平台差异，统一返回包含 task_id、status、files（含 file_name、markdown、nodes）的稳定信封格式，原始响应保留在 raw 字段中便于调试。
显著优点
1. 平台抽象统一：通过单一接口屏蔽中国版与全球版的端点、字段命名、状态值差异，降低多端适配成本。
2. 异步任务管理内置：封装提交-轮询-超时处理逻辑，避免调用方自行实现状态机。
3. LLM 友好输出：直接输出 Markdown 与结构化节点，无需二次转换即可接入 RAG、知识库等场景。
4. 多模式可选：中国版提供速度与精度的权衡选项，适应不同业务场景。
潜在缺点与局限性
1. 平台差异仍需人工决策：用户必须明确选择 cn 或 global，无法自动路由；两平台密钥环境变量名不同（EASYLINK_API_KEY vs EASYDOC_API_KEY），增加配置复杂度。
2. 文件限制刚性：100MB 上限与特定扩展名列表可能阻塞大文档或特殊格式场景。
3. 轮询策略未细化：Skill 描述中未明确轮询间隔、最大重试次数、退避策略等参数，实际实现可能因频繁请求触发限流。
4. 错误恢复有限：虽建议「模式切换或重新提交」，但未提供具体的重试模板或指数退避机制。
适合人群
- 需将批量文档接入 AI 流程的开发者与数据工程师
- 构建 RAG、知识库、文档问答系统的工程团队
- 已在 EasyLink/EasyDoc 平台开户的企业用户
常规风险
- 密钥泄露风险：API key 需存储于环境变量，硬编码或日志打印可能导致凭证泄露。
- 数据出境合规：全球版服务器位于境外，敏感文档需评估跨境传输合规性。
- 任务悬挂：异步任务可能因网络抖动进入死循环轮询，需设置绝对超时与熔断。
- 模式误选成本：中国版
premium与flash在精度与成本间存在权衡，选错可能导致额外费用或质量不达标。