Revit 2026 API 参考
基于 RevitAPI.dll v26.0.4.0 的完整 API 文档，覆盖 30 个命名空间、2724 个类型。
查询流程
第 0 步：需求预研（模糊问题必须执行）
当用户提出的问题不包含明确的类名、方法名或命名空间时（如"实现 DMU"、"链接更新阶段"、"怎么监听模型变化"、"做一个参数化族"），必须先完成预研，再进入后续查询。
判断标准：用户问题中是否包含可直接搜索的 Revit API 标识符（如 IUpdater、DocumentChanged、FilteredElementCollector）。如果没有，执行以下步骤：
- 解析业务意图：将用户的模糊需求拆解为具体的技术概念。
- 示例："实现 DMU" → Dynamic Model Update 机制 → 需要 IUpdater 接口、UpdaterRegistry 类 - 示例："链接更新阶段" → Revit 链接文档的加载/更新事件 → 需要 LinkedFileStatus、RevitLinkType、TransmissionData
- 网络搜索验证：使用 WebSearch 搜索
Revit API + <技术概念>确认涉及的核心类和命名空间。搜索示例："Revit API Dynamic Model Update IUpdater" 搜索示例："Revit API linked file update phase event" - 提取关键词列表：从搜索结果中提取 2-5 个具体的类名/接口名/方法名，作为后续查询的输入。
- 进入第 1 步：带着明确的 API 标识符继续。
重要：禁止跳过预研直接凭经验回答模糊问题。即使你认为自己知道答案，也必须通过预研确认后再用本知识库验证。
第 1 步：判断问题类型
| 问题类型 | 示例 | 执行路径 |
|---|---|---|
| 查询特定 API | "XX 类怎么用"、"XX 方法的参数" | 路径 A |
| 浏览命名空间 | "XX 命名空间有什么"、"XX 模块的类" | 路径 B |
| 查找成员归属 | "哪个类有 XX 方法"、"XX 属性在哪里" | 路径 C |
| 通用开发问题 | "怎么创建墙"、"事务怎么用" | 路径 D |
第 2 步：执行对应路径
路径 A：搜索特定 API（最常用）
- 先搜索定位：
python scripts/search_api.py search "关键词"- 查看类的成员概览：
python scripts/search_api.py class "Autodesk.Revit.DB.ClassName"- 需要完整文档时（签名、Remarks、继承链）：
python scripts/extract_page.py --type "Autodesk.Revit.DB.ClassName"- 查看成员级详情（属性/方法签名）：
python scripts/extract_page.py --id "P:Autodesk.Revit.DB.Wall.Flipped"
python scripts/extract_page.py --id "M:Autodesk.Revit.DB.Wall.Flip"
python scripts/extract_page.py --id "M:Autodesk.Revit.DB.FilteredElementCollector.#ctor(Autodesk.Revit.DB.Document)"
python scripts/extract_page.py --id "Overload:Autodesk.Revit.DB.FilteredElementCollector.#ctor"- 当
member命令返回空结果时，优先检查是否把“类型名”当成了“成员名”：
python scripts/search_api.py member "FilteredElementCollector" # 会提示改用 class/search
python scripts/search_api.py class "Autodesk.Revit.DB.FilteredElementCollector"路径 B：浏览命名空间
- 列出所有命名空间：
python scripts/search_api.py namespaces- 查看特定命名空间的类型列表：
python scripts/search_api.py namespace "Autodesk.Revit.DB"- 或直接读取 references/namespace-overview.md 获取完整导航。
路径 C：查找成员归属
- 跨类搜索成员名称：
python scripts/search_api.py member "GetParameters"- 从结果中定位目标类后，按路径 A 的第 2-4 步获取详情。
路径 D：开发模式速查
- 直接读取 references/core-patterns.md，包含 11 个核心模式的 C# 代码示例。
- 若需进一步查看模式中涉及的 API 细节，按路径 A 继续查询。
第 3 步：组织回答
- 优先展示与用户问题直接相关的 API 签名和用法。
- 附带简要的代码示例（参考 core-patterns.md 中的模式）。
- 如有相关联的类或方法，补充提示。
核心类速查
| 类 | 命名空间 | 用途 |
|---|---|---|
Document | DB | 当前 Revit 文档，所有操作的入口 |
Element | DB | 所有模型元素的基类 |
ElementId | DB | 元素的唯一标识符 |
FilteredElementCollector | DB | 元素查询/过滤器（必学） |
Transaction | DB | 模型修改的事务管理 |
Wall | DB | 墙体元素 |
Floor | DB | 楼板元素 |
FamilyInstance | DB | 族实例（门窗等） |
FamilySymbol | DB | 族类型定义 |
Parameter | DB | 元素参数读写 |
XYZ | DB | 三维坐标点 |
Line / Arc / CurveLoop | DB | 几何曲线 |
Solid / Face / Edge | DB | 几何实体 |
Level | DB | 标高 |
View / ViewPlan / View3D | DB | 视图 |
UIApplication | UI | UI 层应用对象 |
UIDocument | UI | UI 层文档（选择交互） |
ExternalCommandData | UI | Command 执行上下文 |
TaskDialog | UI | 消息对话框 |
Selection | UI.Selection | 用户选择交互 |
命名空间导航
核心（每天用）:
Autodesk.Revit.DB— 数据库核心：元素、几何、参数、事务Autodesk.Revit.UI— 用户界面：Ribbon、对话框、选择Autodesk.Revit.ApplicationServices— 应用服务：Application、ControlledApplicationAutodesk.Revit.Creation— 工厂方法：创建文档、几何对象Autodesk.Revit.Attributes— 特性标记：Transaction、Regeneration
专业领域:
DB.Architecture— 建筑：房间、楼梯、栏杆DB.Structure— 结构：梁、柱、基础DB.Mechanical— 暖通：风管、设备DB.Electrical— 电气：线路、配电盘DB.Plumbing— 给排水：管道、卫浴
高级:
DB.ExtensibleStorage— 自定义数据存储DB.ExternalService— 外部服务框架DB.Events/UI.Events— 事件系统DB.DirectContext3D— 自定义 3D 渲染DB.Visual— 材质与渲染外观Autodesk.Revit.Exceptions— 异常类型
禁止事项
- 禁止对模糊问题跳过第 0 步预研，直接凭记忆回答 API 细节
- 禁止在未经搜索验证的情况下猜测 API 名称或签名，必须通过预研 + 脚本查询确认
- 禁止直接编辑
data/目录下的 JSON 数据文件 - 禁止向用户提供未在文档中出现的 API 用法，若文档不足应明确说明
- 禁止混淆不同 Revit 版本的 API，本文档仅覆盖 Revit 2026（v26.0.4.0）
注意事项
- 所有脚本基于 Python 标准库，无需额外安装依赖
- 脚本路径相对于此 skill 目录，使用
scripts/前缀 - 数据已预提取为按命名空间的 JSON 文件（
data/pages/*.json），无需原始 HTML - 索引文件
data/api_index.json由build_index.py生成 extract_page.py支持--id参数直接查询成员级文档（前缀：T=类型, P=属性, M=方法, E=事件）
脚本增强（v1.1.1）
extract_page.py支持Overload:前缀，能自动展开到一个可渲染重载并列出全部重载 ID。- 当
_lookup缺失或不完整时，extract_page.py会尝试从 Help ID 推断命名空间并直查data/pages/<namespace>.json。 extract_page.py查询失败时会输出同命名空间的候选 ID，便于快速修正拼写/参数签名。search_api.py member在无成员命中时，会提示可能的类型候选和替代命令（class/search）。