UserStringProperty

Rhino 插件，用于根据用户自定义 XML 配置，给 Block 实例附加构件属性（UserString）。

功能

• 根据 XML 配置文件动态生成属性编辑界面
• 支持 string 类型字段（TextBox）和 list 类型字段（ComboBox）
• 自动保存到 Rhino Block 的 UserString
• 支持多个 XML 模板同时加载、合并
• 模板自动持久化，Rhino 重启后自动恢复
• 导入时提供四种合并模式（追加、替代、合并更新、智能合并）

安装

编译

cd UserStringProperty
dotnet build

输出：UserStringProperty/bin/UserStringProperty.dll

加载到 Rhino

1. 将 bin/UserStringProperty.dll 重命名为 UserStringProperty.rhp
2. Rhino → Options → Plug-ins → Install → 选择 .rhp 文件

使用

1. 在 Rhino 中输入命令：UserstringProperty
2. 选择要编辑的 Block 实例
3. 默认模板首次启动自动加载；点 加载XML 导入自定义模板
4. 在下拉框中选择属性集，编辑各字段值
5. 点击 保存

模板导入模式

加载 XML 时，如果已有模板，会弹出对话框让选择导入模式：

模式	说明
添加为新属性集	追加到现有列表末尾
完全替代现有模板	清空所有现有属性集
合并更新	同名属性集覆盖，其他保留
智能合并	同名覆盖，同时追加新属性集

XML 配置格式

插件根据 XML 动态生成 UI。示例参见 Component_Property_base.xml 和 Component_Property_carbon.xml。

<?xml version="1.0" encoding="utf-8"?>
<cmig name="构件编码">
  <propertyset name="构件属性-基础" exclusive="false">
    <!-- string 类型 → TextBox -->
    <property name="0-00-02-年代" type="string" default="PRC"/>

    <!-- list 类型 → ComboBox -->
    <property name="0-00-06-构件类型" type="list" default="DS-JG">
      <option>DS-JG</option>
      <option>DS-WH</option>
      <option>DS-SB</option>
    </property>

    <!-- 分隔标题（default 值为一串 dash 且 type="string"） -->
    <property name="0-01-00-构件基本属性" type="string" default="--------------------" />
  </propertyset>
</cmig>

字段类型

type	控件	说明
string	TextBox	自由文本输入
list	ComboBox	下拉选项（通过 <option> 定义）

分隔标题

属性名的 default 值以 --- 开头时（即 default="--------------------"），该属性显示为分组标题栏。

模板存储

已加载的 XML 模板会复制一份保存到插件目录，重启 Rhino 后自动恢复：

%APPDATA%\McNeel\Rhinoceros\8.0\plugins\UserStringProperty\
├── template_index.txt   # 记录已加载的 XML 路径
└── *.xml               # 模板副本

项目结构

UserStringProperty/
├── CLAUDE.md                       # agent 指示（不要当作文档）
├── PLAN.md                        # 待办事项与开发计划
├── UserStringProperty.csproj
├── UserStringProperty.cs          # 插件主类
├── Core/
│   ├── XmlPropertyConfig.cs       # XML 解析器
│   └── TemplateManager.cs         # 模板管理与持久化
├── Commands/
│   └── CmdUserstringProperty.cs   # 命令入口
├── UI/
│   ├── MainDialog.cs              # 主窗口
│   └── XmlImportDialog.cs         # 导入模式选择对话框
└── Resources/
    └── EmbeddedTemplates.cs       # 内嵌默认 XML 模板

环境要求

• Rhino 8
• .NET Framework 4.8
• .NET SDK 8.0（编译用）

License

MIT