DeepSeek Harness (DSH) 是一個以插件爲核心的開發環境。在構建複雜的交互界面時，確保語義正確和無障礙訪問是常見的挑戰。傳統的診斷工具往往難以覆蓋 DSH 特有的 DOM 結構和動態組件。@oh-my-dsh/dsh-accessibility 是爲此設計的配套工具，旨在輔助開發者進行屏幕閱讀器引導、語義診斷，並提供實驗性的對話閱讀視圖。
插件定位與維護者¶
該插件由 omdsh-dev 維護，屬於 admin-security 分類。它是一個可選的 DeepSeek Harness 伴侶，專注於無障礙支持。它利用 DSH 的插槽機制和結構化投影，不通過補丁修改或觀察哈希化的 DOM 類名。
核心功能¶
該插件提供以下能力：
- 屏幕閱讀器引導：提供快速指南，支持 VoiceOver、NVDA 和 JAWS。
- 語義診斷：運行 17 項結構檢查，覆蓋以下領域：
- 地標與應用標題
- 控件名稱與圖片替代文本
- 列表所有權與嵌套交互控件
- ARIA 引用、作曲家和日誌名稱
- 菜單、列表框、樹、單選組、標籤列表、對話框及可調整分隔線
- 實驗性對話閱讀視圖：通過 DSH 的官方
conversation.view插槽註冊。該視圖提供結構化的會話快照，按源順序展示已完成和進行中的記錄，保留語義化的 Markdown 和代碼，並明確披露上下文、推理、工具參數、命令輸入和錯誤信息。
安裝與啓用¶
使用 DSH CLI 進行安裝：
dsh plugin --profile web add @oh-my-dsh/dsh-accessibility@0.1.0-beta.8
安裝後，運行 dsh --profile web 啓動應用。
典型用法¶
- 進入應用的 Settings（設置）。
- 選擇 Accessibility（無障礙） 選項卡。
- 運行當前頁面的診斷，並閱讀屏幕閱讀器快速指南。
- 在對話界面中，如果僅選擇標籤頁而不加載視圖，內容可能不會保留。
- 點擊 Load reading view（加載閱讀視圖），以接入 DSH 的結構化會話快照。
適用場景與注意事項¶
- 證據而非聲明：診斷通過僅代表掛載的 DOM 滿足確定性契約，這是證據，而非對完整無障礙合規性的聲明。它無法證明語音輸出、瀏覽器映射、焦點時序或特定屏幕閱讀器行爲。
- 權限邊界：該插件不會修補 DSH 擁有的組件，也不能安全地替換外部組件的焦點陷阱、複合控件鍵盤行爲、地標或實時區域策略。
- 功能狀態：當前分支包含 DSH 0.1.7-alpha.1 的未發佈候選版本 0.1.2-alpha.1。對話閱讀視圖仍處於 Beta 階段，不支持穩定支持聲明。
總結¶
該工具適合需要在 DSH 環境中驗證界面語義的開發者。它通過結構化檢查提供診斷依據，並通過實驗性視圖輔助人工審查。更多關於工作組和驗證標準的信息，請參考其 GitHub 倉庫。
