使用 NextPDF Connect（Pro）檢查結構無障礙

概覽

在 NextPDF Connect 上執行結構無障礙分析。此工具是 check_accessibility；經重新核對 Pro 工具供應器，該供應器會以協定名稱 check_accessibility 註冊 new CheckAccessibilityTool()。此工具本身的描述已界定範圍：它分析 PDF 的結構無障礙——標題、表格、圖片，以及閱讀順序指標。它會呈現指標與修正提示。它並不會認證 PDF/UA 或 WCAG 符合性。符合性判定來自檢查器——例如 veraPDF 或 PDF/UA 測試工具——而不是此工具。check_accessibility 是 Pro 層級的工具。 NextPDF 會在啟動時以 class_exists() 探測它，且只有在已安裝 Pro 套件時才會註冊。

安裝

composer require nextpdf/server
composer require nextpdf/pro

綁定一種傳輸，並以 diagnostic.capabilities 確認此工具。

概念總覽

無障礙結構奠基於兩件事：由結構元素組成的邏輯結構樹（ISO 32000-2 §14.7），以及透過目錄 Lang 項目設定的已宣告文件語言（ISO 32000-2 §14.9；PDF/UA-2 §8.4.4）。check_accessibility 會檢視這些結構指標，並回傳發現事項報告；每一項發現都附有嚴重程度與修正指引。報告中的任何數值分數或 pass/fail 都是指標摘要，而非認證——請將它解讀為分流訊號。

API 介面

工具	層級	角色	風險層級
`create_pdf`, `add_text`	Core	建立要檢視的內容	Safe / Caution
`check_accessibility`	Pro	結構無障礙分析	Safe
`output_pdf`	Core	算繪並回傳該 PDF	Approval Required / Review（base64）

工具名稱就是註冊表中的協定名稱。工具型錄是正式型錄。可用工具取決於已安裝的層級。

程式碼範例——快速開始

create_pdf → 以 add_text 加入內容。
以該 document_id 執行 check_accessibility。
閱讀各項發現：嚴重程度、指標、受影響的頁面，以及修正提示。
視需要執行 output_pdf（base64），以便與報告一起進行人工審查。

程式碼範例——正式環境

請將報告視為分流輸入，而非最終裁定。請把每一項發現對應到具體修正：啟用標記化輸出、設定文件語言、加入標題結構。若要作為符合性把關，請執行外部檢查器，並以它的裁定——而非此工具的分數——為準。請在帶有 destroy: true 的 output_pdf 之前執行檢查，否則此工具將無法存取該文件。

邊界案例與陷阱

沒有內容。 空白文件會產生一項「無內容」發現，而非認證。
大型文件。 分析會受到逾時限制；請切分大型輸入或限定範圍。
工作階段已銷毀。 請在輸出銷毀工作階段之前執行檢查。
來源已加密。 請提供密碼。
缺少 Pro。 若僅安裝 Core，check_accessibility 不會註冊。

效能

預算中的逾時設定會限制分析範圍。設定檔為 semantic：報告是結構分析輸出，因此有意義的比較應針對各項發現，而不是位元組輸出。

安全性說明

報告描述的是結構，而不是內容機密。受分析的文件仍可能屬於敏感資料，因此請將它保留在你的信任邊界內。分析路徑不會向檔案系統寫入任何內容。

符合性

陳述	規格	條款
邏輯結構是由結構元素組成的樹。	ISO 32000-2	§14.7
文件語言透過 `Lang` 項目宣告。	ISO 32000-2	§14.9
為了無障礙撰寫，必須指定自然語言。	PDF/UA-2	§8.4.4

check_accessibility 會回報支援無障礙撰寫的結構指標。它並不主張 PDF/UA 或 WCAG 符合性——該判定由獨立檢查器負責。

商業情境

check_accessibility 是 Pro 層級的工具，只有在伺服器啟動時成功解析 Pro 套件時才會註冊。

PDF/UA-2 對應

此工具檢視的結構指標與 PDF/UA-2 撰寫需求一致：一棵標記化結構樹（ISO 32000-2 §14.7），以及已宣告的文件語言（PDF/UA-2 §8.4.4）。此工具會回報這些指標存在或缺少。PDF/UA-2 符合性由 PDF/UA 檢查器判定，而不是由此工具的報告判定。

標籤 → ISO 32000-2 §14 交叉參照

標題與表格相關發現對應到 ISO 32000-2 §14.7 結構樹中的邏輯結構元素。語言相關發現對應到 §14.9 的 Lang 項目。此工具會呈現這些結構錨點是否存在。它並不會驗證每一條 §14 標籤規則——那是檢查器的工作。

WCAG 2.2 對應

對比與閱讀順序相關發現會對應到 WCAG 成功準則，例如對比與有意義的順序。此工具會回報指標值，例如量測到的對比比例。若要主張 WCAG 符合性，需要完整的 WCAG 評估；此工具既不執行，也不主張此事。

傳輸可用性

傳輸	可用	備註
MCP (stdio)	是（Pro）	報告會作為一筆工具結果。
REST	是（Pro）	報告會作為回應主體。
gRPC	是（Pro）	一元式；報告位於回應訊息中。

HITL 風險層級

check_accessibility 屬於 Safe（唯讀分析），且絕不會進行把關。將 output_pdf 輸出至檔案屬於 Approval Required，base64 模式則屬於 Review（HITL 風險層級）。

確認把關 JSON 封套

此分析絕不會進行把關：

{ "allowed": true }