SuperAPI AI 工具集

NVDA Addon Development Specialist

编程与开发

查看项目

更新于 10-16 06:26

技能介绍

用途

本技能面向 NVDA 屏幕阅读器插件开发者,提供从架构理解、编码、调试、测试到打包发布的完整开发支持。其知识以 NVDA 官方源代码(github.com/nvaccess/nvda)为权威依据,并结合社区插件开发生态。

主要能力

  • 讲解 NVDA 架构:事件链(API Handler → eventHandler.executeEvent() → 全局插件 → 应用模块 → 树拦截器 → NVDAObject)与脚本解析顺序(gesture.scriptableObject、全局插件、应用模块、盲文显示驱动、视觉增强提供者、树拦截器、聚焦 NVDAObject、焦点祖先、globalCommands)。
  • 覆盖四类插件:全局插件(globalPlugins,基类 globalPluginHandler.GlobalPlugin)、应用模块(appModules,按可执行文件命名,基类 appModuleHandler.AppModule)、语音合成驱动(synthDrivers,基类 synthDriverHandler.SynthDriver,关键方法 check()、speak()、cancel()、supportedSettings)、盲文显示驱动(brailleDisplayDrivers,基类 braille.BrailleDisplayDriver,关键方法 check()、display()、numCells)。
  • 讲解 @script 装饰器用法及参数:description、category、gesture/gestures、canPropagate、bypassInputHelp、allowInSleepMode、resumeSayAllMode、speakOnDemand。
  • 说明插件文件结构与 manifest.ini 字段(name、summary、description、author、url、version、minimumNVDAVersion、lastTestedNVDAVersion)。
  • 提供常见模式示例:动态播报(ui.message 与 braille.handler.message)、基于定时器的监控(wx.CallLater)、配置持久化(config.conf.spec)。
  • 列出反模式:猴子补丁、主线程阻塞、裸 except。
  • 提供检测规则(NVDA-001 至 NVDA-018),覆盖缺少 nextHandler()、主线程阻塞、缺少 initTranslation()、缺少 terminate() 清理、manifest 版本格式错误、猴子补丁、未使用 @script 装饰器、缺少脚本描述、手势冲突、后台线程直接更新 UI、驱动缺少 check()、裸 except、API 版本范围不兼容、缺少商店提交 SHA256、未使用 config.conf.spec、安全模式漏洞、32 位原生库不兼容、minimumNVDAVersion 低于 2019.3.0 等问题。
  • 说明 NVDA 2026.1 架构迁移:64 位 Python 3.13、不再支持 32 位 Windows、Windows 10 64 位(Version 1507)为最低要求、Windows 10 on ARM 被移除、ARM64 仅面向 Windows 11(通过 ARM64EC 库)、无 32 位原生库向后兼容层、NVDAHelper.localLib 变更、不再捆绑 Microsoft Universal C Runtime;SAPI 重构(sapi5 指 64 位、sapi5_32 访问 32 位、sapi4 移除改用 sapi4_32);以及 versionInfo 拆分、winBindings 迁移、Screen Curtain 重构、MathPlayer 移除、ftdi2 重构、TabbableScrolledPanel 移除、配置项变更、typing_extensions 移除、许可证改为 GPL-2-or-later 等破坏性变更。
  • 提供 manifest 版本指导:新插件 minimumNVDAVersion 2025.1.0、lastTestedNVDAVersion 2026.1.0;广泛兼容(需 Python 3)2019.3.0 至 2026.1.0;最宽安全范围 2024.1.0 至 2026.1.0。Python 3 插件最低不得低于 2019.3.0;附带 64 位原生 DLL 的插件须将 minimumNVDAVersion 设为 2026.1.0。

使用方式

该技能以专家代理形式提供,在开发 NVDA 插件时给出架构解释、代码模式、兼容性判断与问题检测。其行为规则包括:解释内部行为时引用 NVDA 源文件;推荐 API 前对照 minimumNVDAVersion 验证兼容性;警告版本间破坏性变更;优先使用 @script 装饰器而非旧式 __gestures 字典;除非确无替代方案,不推荐猴子补丁;对持久资源始终建议 terminate() 清理;安全模式下写文件前检查 NVDAState.shouldWriteToDisk()。跨团队问题按方向转交:wxPython GUI 转 wxpython-specialist,屏幕阅读器测试转 desktop-a11y-testing-coach,平台 API 深入转 desktop-a11y-specialist,工具构建转 a11y-tool-builder,Web 审计转 web-accessibility-wizard,文档审计转 document-accessibility-wizard。

适用场景

适用于开发、维护、调试和发布 NVDA 插件的开发者,尤其是需要处理 NVDA 2026.1 架构迁移与 API 兼容性问题的场景。

限制

具体安装命令、收费与价格信息暂未提供。