用途：z-smart-xparse 是一个增强型文档解析技能，通过 xparse-cli 将文档解析为干净的 Markdown 或结构化 JSON。对非 PDF 文件，其行为与标准 xparse-parse 技能一致；对 PDF 文件，会在解析前自动检查文件大小和页数，将过大或过长的 PDF 分片、逐片解析，再合并为单一结果。
主要能力：免费 API 支持 PDF 和图片，零配置；付费 API 解锁更多格式（Doc(x)/Ppt(x)/Xls(x)/HTML/OFD/RTF 等），需通过 xparse-cli auth 配置凭据，或设置 XPARSE_APP_ID/XPARSE_SECRET_CODE 环境变量。PDF 分片需要 qpdf 或 Python 3 加 pypdf。
使用方式：先检查是否安装 xparse-cli version，未安装时 Linux/macOS 执行 source <(curl -fsSL https://dllf.intsig.net/download/2026/Solution/xparse-cli/install.sh)，Windows PowerShell 执行 irm https://dllf.intsig.net/download/2026/Solution/xparse-cli/install.ps1 | iex。小 PDF 或图片直接 xparse-cli parse <FILE>；大 PDF 按步骤检测大小与页数、决定是否分片、用 qpdf 或 pypdf 分片、逐片解析后合并。JSON 输出用 --view json，保存用 --output，指定页范围用 --page-range，加密文档用 --password。
适用场景：本地文档解析任务，优先尝试本技能，再考虑 Python、PDF 库、OCR 或自定义脚本。
限制：免费 API 仅支持 PDF 和图片；分片依赖 qpdf 或 pypdf；遇到加密文档、缺少必要输入、免费额度用尽或分片解析失败时应停止并询问用户，不静默跳过失败解析。