Avalonia 无内置 PropertyGrid，推荐使用社区库 Avalonia.PropertyGrid，支持自动反射、类型编辑器、特性控制（Browsable/ReadOnly/Category等）、自定义编辑器及虚拟化优化。
Avalonia 本身不内置 PropertyGrid（属性网格）控件，但可通过第三方库或自定义方式实现类似 WPF 中 System.Windows.Forms.PropertyGrid 或 Microsoft.Toolkit.Wpf.UI.Controls.PropertyGrid 的功能。目前最成熟、广泛使用的方案是基于 Avalonia.PropertyGrid 开源库（由社区维护，GitHub 上可查）。
使用 Avalonia.PropertyGrid 第三方库
这是目前最接近原生体验的方案，支持属性自动发现、类型编辑器（如 bool 滑块、Color 选择器、枚举下拉等）、只读/可见性控制、自定义编辑器等。
- 安装 NuGet 包：
Avalonia.PropertyGrid（注意：需匹配你的 Avalonia 版本，如 Avalonia 11+ 推荐用Avalonia.PropertyGrid 11.0.0+） - 在
App.xaml中添加命名空间并注册资源：
在页面 XAML 中引用并使用：
openclaw-github-config-impact
下载
OpenClaw 技能 — 给定一个 GitHub 仓库 URL，自动解析出 owner/repo 名称，发现其中的 YAML/properties 配置文件及其配对的中文字段说明；在 `workspace/{repo}/` 目录下按同步日期（格式为 `YYYY-MM-DD`）创建时间戳子目录；写入 `.openclaw-config-state.json` 状态文件。每次用户提问前，先比对远程仓库当前 ref（如 `main` 或 `master`）的最新提交 SHA 与本地状态文件中记录的 SHA：
绑定对象与属性可见性控制
PropertyGrid 会自动反射 SelectedObject 的 public 属性。如需控制哪些属性显示、是否只读、排序或分组，可用特性标注：
-
[Browsable(true/false)]：控制是否出现在网格中 -
[ReadOnly(true/false)]：设置编辑状态 -
[Category("Appearance")]：按分类分组显示 -
[DisplayName("背景色")]：自定义显示名称 -
[Description("用于设置界面主色调")]：悬停提示文字
示例模型：
public class MySettings{
[Category("Display")]
[DisplayName("窗口宽度")]
public int Width { get; set; } = 800;
[Category("Display")]
[ReadOnly(true)]
public string Version => "1.2.0";
[Category("Theme")]
[DisplayName("主题颜色")]
public SolidColorBrush ThemeColor { get; set; } = new SolidColorBrush(Colors.Blue);
}
扩展自定义编辑器（如 ColorPicker、DateTimePicker）
默认已支持常见类型（string、int、bool、enum、Color、Brush 等），若需特殊编辑逻辑（例如用日期选择器编辑 DateTime），可注册自定义 ITypeEditor：
- 继承
ITypeEditor，实现CreateEditor返回对应Control - 在启动时注册：
PropertyGrid.TypeEditors.Add(typeof(DateTime), new DateTimeEditor()); - 也可通过
[Editor(typeof(MyDateTimeEditor), typeof(ITypeEditor))]特性为特定属性指定编辑器
注意事项与常见问题
- 确保绑定对象属性为 public get/set，且支持 INotifyPropertyChanged（否则值变更不会实时反映到 UI）
- 复杂嵌套对象（如子对象属性）默认不展开，需配合
[ExpandableObject]特性启用折叠/展开 - 中文显示异常？检查字体资源是否正确加载，或手动设置
FontFamily - 性能敏感场景（如大量属性）建议启用虚拟化（部分版本支持
EnableVirtualization="True"）
