用途
xparse-parse 技能用于在智能体环境中调用已安装的 xparse-cli，完成图像与文档的解析、读取、搜索、导航、摘要、提取，以及图像/PDF 的篡改或 AI 生成检测。它强调：技能层不重建 xparse-cli 的 HTTP、OAuth、配额、PDF 拆分或结果合并逻辑，所有解析、认证、配额和文档导航均以 xparse-cli 为唯一执行内核。
主要能力
- 解析与导航：对单个文档或 URL 使用 parse，获得即时结果、格式转换或本地大纲/搜索导航。
- 多文档持久任务：对两个及以上本地文档，或需要持久 Task ID、后续状态检查、选择性结果读取、导出、调试或续跑时，使用 Task Runtime（
xparse-cli task run --files '<GLOB>' --api auto）。 - 结构化提取：通过
task run --task-type extract创建结构化提取 Task，保留用户原始提取指令，不本地生成最终字段值。 - 篡改检测：对受支持的图像或 PDF，使用
xparse-cli detect-manipulation <FILE|URL>检测是否被篡改或由 AI 生成（仅限国内服务）。
使用方式
- 免费/付费路由：默认
--api auto，优先使用每日免费额度，并使用服务端当前响应作为权威，而非技能快照。--api free强制免费端点；--api paid强制付费端点，仅在用户明确批准付费后使用。认证是身份，不是消费许可。 - 配额查询：用户询问配额、需要解释路由失败或准备提议付费重试时，运行
xparse-cli quota --output json，读取每日免费解析页数、重置时间、extraction_quota、是否已认证、free_package 的 free_remain_count、单请求最大页数与文件大小等返回事实。 - 任务上下文：每个新用户请求在首次 xParse 命令前创建一个 0600 私有 JSON 文件（schema_version 为 xparse_task_context.v1），包含原始语言用户意图与工具调用原因，仅首次调用传
--task-context <FILE>，随后删除。 - 命令完整性与错误门控：每条操作命令独立运行，不通过管道或其他命令替换其退出状态；失败时解析 stderr 的 xparse_error.v1 对象，依据 retryable 与 next_action 决定是否重试或停止。
适用场景
- 单文档/URL 的即时解析与格式转换。
- 多文档持久化处理、导出与续跑。
- 需要保留 Task ID 与 Run ID 的可追踪工作流。
- 图像或 PDF 的篡改/AI 生成检测（国内服务）。
限制
- 免费端点支持 PDF 与图像；Office、HTML、OFD 等格式可能需要
--api paid，切换前需解释并取得用户批准。 - 篡改检测为独立服务，其配额查询需使用
quota --service manipulation_detection；若 CLI 不识别--service，应更新 CLI，而不是用默认配额代替。 waiting_paid_authorization与waiting_funds是已接受的任务状态，不是 CLI 传输失败；此时必须停止发出更多 xParse 命令，待用户确认外部操作后，才对同一 Task 与 Run 调用一次task resume。- 任务读取或导出失败时，不得回退为新 Task、串行 parse、缓存结果、替代选择器或不同 Run。
- 关于具体收费标准、价格与平台覆盖范围，资料中暂未提供。