用途:在开发需要平台能力(相机、文件访问、通知、UI 控件、AI/ML 等)的功能时,帮助查找合适的 Windows API 并获取类型详情。
主要能力:搜索本地 WinMD 元数据缓存,覆盖 Windows Platform SDK 的 Windows.* WinRT API、WinAppSDK/WinUI 基线,以及还原项目中带 .winmd 的 NuGet 包和项目构建输出的 WinMD(C++/WinRT、C# 类库)。即使全新克隆、未还原或未构建,仍可获得 Platform SDK 与 WinAppSDK 的完整覆盖。支持按关键词搜索、按类型查成员、查枚举值、按命名空间列类型、浏览命名空间等。
使用方式:需 .NET SDK 8.0 或更高版本构建缓存生成器。首次使用前必须生成缓存,命令如:..github\skills\winmd-api-search\scripts\Update-WinMdCache.ps1,或对单个项目加 -ProjectDir <project-folder>。查询命令示例:..github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action search -Query "<keyword>";也可用 -Action members、-Action enums、-Action types、-Action namespaces、-Action projects、-Action packages、-Action stats 等。缓存存放于 Generated Files\winmd-cache\,应按包和版本去重,并建议加入 .gitignore。
适用场景:不确定该用哪个 API 时,把日常语言转成编程关键词并多次搜索;已知类型时直接查询成员或枚举;需要精确的方法、属性、事件或枚举值再写代码时使用。缓存仅含签名,不含描述和用法说明,需到 Microsoft Learn 查看解释与示例:Windows.* 用 https://learn.microsoft.com/uwp/api/{fully.qualified.typename},Microsoft.*(WinAppSDK)用 https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/{fully.qualified.typename}。
限制:搜索评分低或结果无关时,建议改用 Microsoft Learn 在线文档;缓存需在 NuGet 更新后重新生成;多项目缓存时需指定 -Project;类型未找到时用完全限定名;缓存目录为生成产物,不应提交到版本库。