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 仓库。