用途：winapp find-api 用于在编写 Windows/WinRT/WinUI 代码或 XAML 前，查询项目实际引用的 API 表面，防止编造不存在的类型、属性或枚举值。它被设计为面向智能体的命令，也可由人直接运行。
主要能力：裸命令形式执行搜索，匹配类型与成员名，再匹配文档摘要；members 列出类型的属性、事件、方法（含继承）；check-property 校验属性是否存在，支持附加属性并给出近似拼写建议；enums 枚举枚举值；packages、stats 查看项目引用；refresh 重建索引。所有动词支持 --json，输出结构稳定，缺失主题时返回非零退出码，可用于门控代码生成。
使用方式：在已还原的项目目录运行，索引基于 project.assets.json 与已还原的 NuGet/SDK 包；未还原时先运行 winapp restore 或 dotnet restore。无项目目录下则从机器级 SDK 范围（Windows SDK + Windows App SDK）作答。首次查询自动建索引，之后走缓存。示例：winapp find-api "acrylic brush"；winapp find-api members NavigationView --filter selected；winapp find-api check-property InfoBar Severity IsOpen；winapp find-api enums Symbol；winapp find-api refresh --scan。
适用场景：发现所需类型或成员、写 XAML/代码前核对属性、枚举枚举值、排查 CS0246/CS0117/CS1061/CS0104 及 XAML 未知成员等编译错误、在无项目时探索 SDK。
限制：搜索为词法匹配而非语义，无嵌入向量，仅能搜索包实际附带的摘要；属性名区分大小写；--filter 为不区分大小写的子串匹配，不建议用于枚举；短名冲突时需用完全限定名；无项目时不含第三方 NuGet 包；ABI.* 投影类型不出现在搜索结果中。批量调用比逐次调用更省成本，建议一次调用验证多个主题。