@oh-my-dsh/dsh-accessibility:DeepSeek Harness 的无障碍辅助与诊断插件

DeepSeek Harness (DSH) 是一个以插件为核心的开发环境。在构建复杂的交互界面时,确保语义正确和无障碍访问是常见的挑战。传统的诊断工具往往难以覆盖 DSH 特有的 DOM 结构和动态组件。@oh-my-dsh/dsh-accessibility 是为此设计的配套工具,旨在辅助开发者进行屏幕阅读器引导、语义诊断,并提供实验性的对话阅读视图。

插件定位与维护者

该插件由 omdsh-dev 维护,属于 admin-security 分类。它是一个可选的 DeepSeek Harness 伴侣,专注于无障碍支持。它利用 DSH 的插槽机制和结构化投影,不通过补丁修改或观察哈希化的 DOM 类名。

核心功能

该插件提供以下能力:

  1. 屏幕阅读器引导:提供快速指南,支持 VoiceOver、NVDA 和 JAWS。
  2. 语义诊断:运行 17 项结构检查,覆盖以下领域:
    • 地标与应用标题
    • 控件名称与图片替代文本
    • 列表所有权与嵌套交互控件
    • ARIA 引用、作曲家和日志名称
    • 菜单、列表框、树、单选组、标签列表、对话框及可调整分隔线
  3. 实验性对话阅读视图:通过 DSH 的官方 conversation.view 插槽注册。该视图提供结构化的会话快照,按源顺序展示已完成和进行中的记录,保留语义化的 Markdown 和代码,并明确披露上下文、推理、工具参数、命令输入和错误信息。

安装与启用

使用 DSH CLI 进行安装:

dsh plugin --profile web add @oh-my-dsh/dsh-accessibility@0.1.0-beta.8

安装后,运行 dsh --profile web 启动应用。

典型用法

  1. 进入应用的 Settings(设置)。
  2. 选择 Accessibility(无障碍) 选项卡。
  3. 运行当前页面的诊断,并阅读屏幕阅读器快速指南。
  4. 在对话界面中,如果仅选择标签页而不加载视图,内容可能不会保留。
  5. 点击 Load reading view(加载阅读视图),以接入 DSH 的结构化会话快照。

适用场景与注意事项

  • 证据而非声明:诊断通过仅代表挂载的 DOM 满足确定性契约,这是证据,而非对完整无障碍合规性的声明。它无法证明语音输出、浏览器映射、焦点时序或特定屏幕阅读器行为。
  • 权限边界:该插件不会修补 DSH 拥有的组件,也不能安全地替换外部组件的焦点陷阱、复合控件键盘行为、地标或实时区域策略。
  • 功能状态:当前分支包含 DSH 0.1.7-alpha.1 的未发布候选版本 0.1.2-alpha.1。对话阅读视图仍处于 Beta 阶段,不支持稳定支持声明。

总结

该工具适合需要在 DSH 环境中验证界面语义的开发者。它通过结构化检查提供诊断依据,并通过实验性视图辅助人工审查。更多关于工作组和验证标准的信息,请参考其 GitHub 仓库。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜