用途:对已存在的 PDF 进行无障碍修复,自动添加 PDF/UA 语义结构,包括 H1–H6 标题、列表、表格(TR/TD/TH)、阅读顺序和 artifact 标记。脚本上传 PDF 后写回带标签的修复版 PDF。
主要能力:仅提供自动打标签(auto-tag)。DWS Accessibility API 目前不提供独立的一致性验证端点。可用随附的独立验证器检查输出:uv run scripts/verify-pdf.py --input doc-tagged.pdf --profile pdfua,它会检查 PDF/UA-1 结构信号,并在安装 veraPDF 时升级为完整审计;该结果不是认证。
使用方式:需单独申请 DWS Accessibility API 密钥(前缀 pdf_live_),导出为 NUTRIENT_ACCESSIBILITY_API_KEY。在包含 SKILL.md 的目录运行:uv run scripts/autotag.py --input doc.pdf --output doc-tagged.pdf,或使用 --url https://example.com/doc.pdf。请求以 multipart/form-data 发送到 https://api.nutrient.io/accessibility/autotag。--url 仅允许 https 且需解析为公网地址,由客户端下载后上传,后端不抓取 URL。
适用场景:让已有 PDF 可被屏幕阅读器读取、为 PDF/UA 打标签、为 Section 508 做标签准备。若需从 Markdown/HTML 生成新合规 PDF,应使用 make-pdf 技能;若已在做 /build 工作并希望 PDF/UA 作为输出目标之一,应使用 document-processor-api。
限制:自动打标签消耗每月 auto-tagged-pages 配额(免费层 20 页/月,不累积,达上限即阻止)。单请求最大 150 MiB,超出需先用 document-processor-api/split.py 拆分。不要对 2xx 响应自动重试,每次调用都消耗配额。自动打标签不保证 PDF/UA 完全合规(Nutrient 基准约 96.5%),输出应视为已修复而非已认证。不要用 Processor 或 Extraction 密钥调用该端点,会返回 401。密钥不得写入提交文件,应通过运行时环境注入。