Revit 2026 API 参考是一套面向 Revit 二次开发的文档查询技能,文档范围基于 RevitAPI.dll v26.0.4.0,覆盖 30 个命名空间、2724 个类型。
【用途】 用于回答 Revit API 相关问题,包括:查询特定类/接口的成员与用法;搜索实现某功能所需的 API;查看方法签名和参数说明;浏览命名空间下的类型列表;跨类查找某成员属于哪个类型;以及速查常见开发模式。
【主要能力】
- 搜索定位:通过 search 命令按关键词查找 API。
- 类成员概览:通过 class 命令查看指定类的成员概览。
- 类型完整文档:extract_page.py --type 可获取签名、Remarks、继承链。
- 成员级详情:--id 支持 T(类型)、P(属性)、M(方法)、E(事件)前缀,例如 P:Autodesk.Revit.DB.Wall.Flipped、M:Autodesk.Revit.DB.Wall.Flip、M:Autodesk.Revit.DB.FilteredElementCollector.#ctor(Autodesk.Revit.DB.Document),并支持 Overload: 前缀展开重载列表。
- 命名空间导航:namespaces 列出全部命名空间,namespace 查看指定命名空间的类型,也可读取 references/namespace-overview.md。
- 成员归属查找:member 命令跨类搜索成员名称,无命中时会提示可能的类型候选与替代命令。
- 开发模式速查:references/core-patterns.md 含 11 个核心模式的 C# 代码示例。
【使用方式】 技能内置查询流程:第 0 步需求预研——当问题不含明确类名、方法名或命名空间时,先解析业务意图、用 WebSearch 以 Revit API + 技术概念验证核心类与命名空间、提取 2-5 个具体标识符,再进入后续查询。第 1 步判断问题类型(查询特定 API、浏览命名空间、查找成员归属、通用开发问题),第 2 步执行对应路径(路径 A-D),第 3 步组织回答,优先给出直接相关的签名与用法并附简要代码示例。
脚本基于 Python 标准库,无需额外安装依赖;脚本路径相对于技能目录,使用 scripts/ 前缀。数据已预提取为按命名空间的 JSON 文件(data/pages/*.json),索引文件 data/api_index.json 由 build_index.py 生成。extract_page.py 在 _lookup 缺失或不完整时会尝试从 Help ID 推断命名空间并直查对应 JSON;查询失败时输出同命名空间候选 ID 以便修正拼写或参数签名。
【适用场景】 Revit 插件开发者查询 API 用法、确认签名参数、定位实现某功能所需类与方法、以及按命名空间了解可用类型时使用。文档还提供核心类速查(Document、Element、ElementId、FilteredElementCollector、Transaction、Wall、Floor、FamilyInstance、FamilySymbol、Parameter、XYZ、曲线与几何、Level、View、UIApplication、UIDocument、ExternalCommandData、TaskDialog、Selection)与命名空间导航(DB、UI、ApplicationServices、Creation、Attributes,以及 Architecture、Structure、Mechanical、Electrical、Plumbing 等专业领域和 ExtensibleStorage、ExternalService、Events、DirectContext3D、Visual、Exceptions 等高级命名空间)。
【限制】 仅覆盖 Revit 2026(v26.0.4.0)版本,不适用于其它 Revit 版本;禁止跳过模糊问题的预研步骤、禁止猜测 API 名称或签名、禁止直接编辑 data/ 目录下的 JSON 数据文件、禁止提供文档中未出现的 API 用法,文档不足时应明确说明。