👁 Image
GoesSoftware.SuperSDK.Editor 7.23.7

SuperSDK.Editor

Avalonia 编辑器组件库，提供 VSCode 风格的文件浏览器、代码编辑器、版本控制面板。

🎯 核心功能

1. GzExplorerBox - 文件浏览器

• VSCode 风格的文件树展示
• 文件/文件夹图标自动识别
• 点击文件发出 EditorFileSelectedMsg 消息
• 自动过滤 bin/obj/node_modules 等目录

2. GzEditorBox - 代码编辑器

• 等宽字体代码编辑（Cascadia Code / Consolas）
• 行号显示
• 语言自动检测
• Ctrl+S 保存（发出 EditorFileSavedMsg 消息）
• Diff 对比模式（左右分栏）
• 修改标记（Tab 标题 ● 提示）
• VSCode 风格状态栏

3. GzSourceControlBox - 版本控制面板

• Git Graph 提交历史可视化
• 分支/标签标记展示
• Staged Changes / Changes 分区展示
• 点击变更文件自动切换到 Diff 模式
• 文件状态标记（M/A/D/R/U）

📨 消息系统 (GzMessageBus)

� 支持的文件类型

可编辑/预览的文件（编辑器全功能支持，含行号、光标、Ctrl+S 保存）

大文件限制：超过 5 MB 的文件不加载，仅显示路径信息。超过 100,000 行的文件只加载前 10 万行。

不支持的文件（仅显示路径，不加载内容）

�🚀 快速使用

XAML 引用

<Window xmlns:editor="clr-namespace:SuperSDK.Editor.Controls;assembly=SuperSDK.Editor">
 <Grid ColumnDefinitions="250,*,300">
 
 <editor:GzExplorerBox Grid.Column="0" x:Name="Explorer" />
 
 
 <editor:GzEditorBox Grid.Column="1" />
 
 
 <editor:GzSourceControlBox Grid.Column="2" />
 </Grid>
</Window>

代码初始化

// 方式一：直接设置属性（自动发出 EditorFolderChangedMsg）
Explorer.RootPath = @"C:\MyProject";

// 方式二：调用 API（等价于设置 RootPath，同样广播消息）
Explorer.SetFolder(@"C:\MyProject");

// 切换文件夹时：
// - Explorer 自动刷新文件树
// - Editor 自动清空所有已打开的 Tab
// - SourceControl 自动检测新目录的 Git 仓库并刷新状态

监听消息

// 监听文件选择
MessageBus.Subscribe<EditorFileSelectedMsg>(this, msg =>
{
 Console.WriteLine($"选中文件: {msg.FilePath}");
});

// 监听文件保存
MessageBus.Subscribe<EditorFileSavedMsg>(this, msg =>
{
 Console.WriteLine($"文件已保存: {msg.FilePath}");
});

🎨 主题支持

所有控件遵循 SuperSDK.UI 标准：

• 无主题属性，始终跟随全局主题 (ThemeManager)
• 使用 Semi.Avalonia DynamicResource 颜色系统
• 支持 Dark/Light 模式自动切换

📦 依赖

• SuperSDK.Core (MessageBus)
• SuperSDK.UI (ThemeManager, ViewModelBase)
• SuperSDK.Data (数据模型)
• SuperSDK.License (DLL 完整性验证)
• Avalonia
• ReactiveUI