SuperAPI AI 工具集

saury-revit

编程与开发

查看项目

更新于 10-19 01:10

技能介绍

用途 saury-revit 用于快速创建 Revit 插件项目。它基于 Saury.Revit.Template dotnet 模板,生成一个已配置好的 Revit 2026 插件工程,采用 MVVM + DI 架构,包含示例 About 功能、Ribbon 按钮、addin 清单、appsettings.json 等基础结构。

主要能力

  1. 交互式确认项目配置:项目名称(须为合法 C# 命名空间名,默认 RevitDemo 或 RevitTest)、项目创建目录(默认当前工作目录)、Revit 版本(默认 2026,通过 --RevitVersion 指定)。
  2. 检查 .NET 环境:检测 dotnet CLI 与 SDK 版本,要求 8.0 或更高;缺失时优先用 winget install Microsoft.DotNet.SDK.8 安装,失败则用官方 dotnet-install.ps1 脚本,再失败则提示手动下载。
  3. 安装模板:通过 dotnet new list saury-revit 检查是否已安装,未安装则执行 dotnet new install Saury.Revit.Template,需要更新时加 --force。
  4. 创建项目:执行 dotnet new saury-revit -n <项目名称> -o <输出目录> --RevitVersion 2026。模板会自动将 Saury.Revit.Template 全局替换为用户项目名、生成唯一 GUID 替换 ADDIN-GUID-PLACEHOLDER,并排除 .template.config/、bin/、obj/、.vs/、Logs/、*.user。
  5. 验证项目结构:生成后包含解决方案文件 .slnx,以及 Commands/AboutCommand.cs、Extensions/DataContextExtension.cs、Models/AboutInfo.cs、ViewModels/AboutViewModel.cs、Views/AboutView.xaml(.cs)、Resources/Icons/about.png、Resources/Styles/ButtonStyles.xaml、Services/Interfaces/、Application.cs、Host.cs、appsettings.json、<项目名称>.addin、<项目名称>.csproj。
  6. 构建验证:执行 dotnet restore 与 dotnet build --configuration Debug_R26。项目必须使用 Debug_R26 / Release_R26,不能使用标准 Debug / Release。构建成功后产物自动复制到 C:\ProgramData\Autodesk\Revit\Addins\2026\。

使用方式 按顺序执行:确认配置 → 检查/安装 .NET SDK → 安装模板 → 创建项目 → 验证结构 → 构建 → 告知使用说明。调试时用 Visual Studio 或 Rider 打开 .slnx,选择 Debug_R26 配置,按 F5 启动 Revit 并附加调试器;可在 <项目名称>.csproj 的 StartProgram 属性确认 Revit 路径。后续定制包括修改 .addin 中的厂商信息、Models/AboutInfo.cs 中的关于页信息,以及按 references/architecture.md 的 A→F 六步流程添加新功能(Model、ViewModel、View、Command、DI 注册、Ribbon 按钮)。

限制与约束 禁止使用 Debug / Release 配置,只能用 Debug_R26 / Release_R26;禁止手动 new View 或 ViewModel,必须通过 Host.GetService<T>() 获取;禁止在 View code-behind 中写业务逻辑;禁止在 ViewModel 中直接调用 MessageBox 或操作 Window;禁止硬编码配置值,应使用 appsettings.json + IOptions<T>;除非用户明确要求,不要删除示例 About 功能。默认面向 Revit 2026,其他版本需通过参数指定。