SuncodeSoftware.SuperSDK.Talk 4.1.0

SuperSDK.Talk

SuperSDK AI 对话组件库，提供开箱即用的聊天消息体系，原生集成 SuperSDK MessageBus。

功能

• 可扩展消息模型：抽象基类 + 内置 Text / Image / PDF / System 四种类型
• ChatBox 控件：Avalonia 控件，自动订阅 MessageBus，自动渲染消息
• 渲染注册表：新增消息类型只需新增一个渲染器类，无需修改现有代码
• 引用/回复：内置气泡引用展示，支持跨类型引用
• 软删除：删除后显示占位符，不影响引用链
• 状态显示：Pending / Sent / Delivered / Read / Failed 五级状态图标
• 混淆 + 签名保护：DLL 完整性验证，防止篡改

安装

dotnet add package SuncodeSoftware.SuperSDK.Talk

快速开始

using SuperSDK.Talk.Controls;
using SuperSDK.Talk.Messages;

// 1. 创建控件并放入界面
var chatBox = new ChatBox();

// 2. 订阅 MessageBus（任意通道均可）
chatBox.SubscribeGlobal();
// 或: chatBox.SubscribeFixture(0);
// 或: chatBox.SubscribeSlot(0, 1);

// 3. 发布消息（由 AI 响应模块或其他地方调用）
MessageBus.Pub(new ChatMessageReceived {
    Message = TextChatMessage.Inbound("ai", "Assistant", "你好，有什么可以帮你的？")
});

// 4. 直接推送（不走 MessageBus）
chatBox.PostMessage(TextChatMessage.Outbound("user", "我", "帮我解释一下 GPT"));

消息类型一览

扩展新消息类型

// 1. 定义消息模型
public class AudioChatMessage : ChatMessage {
    public string AudioPath { get; set; } = "";
    public TimeSpan Duration { get; set; }
    public override string ContentType => "audio";
    public override string GetPreviewText() => $"[语音] {Duration:mm\\:ss}";
}

// 2. 定义 ViewModel
public class AudioChatMessageViewModel : ChatMessageViewModel {
    public AudioChatMessageViewModel(AudioChatMessage m) : base(m) { ... }
    public override string ContentType => "audio";
    protected override void ExecuteCopy() { ... }
}

// 3. 定义渲染器（继承 ChatMessageCellRendererBase）
public class AudioMessageCellRenderer : ChatMessageCellRendererBase {
    public override string ContentType => "audio";
    protected override Control BuildContentArea(ChatMessageViewModel vm) {
        // 只需构建内容区，基类负责引用气泡、删除状态、时间戳等
        var audioVm = (AudioChatMessageViewModel)vm;
        return new Button { Content = $"▶  {audioVm.DurationText}" };
    }
}

// 4. 注册（程序启动时执行一次）
ChatMessageViewModelFactory.Register("audio", m => new AudioChatMessageViewModel((AudioChatMessage)m));
chatBox.RendererRegistry.Register(new AudioMessageCellRenderer());

架构层次

Messages/           ← 纯数据模型（无 UI 依赖）
  ChatMessage       ← 抽象基类：Id、时间、发送方、方向、状态、删除、引用
  TextChatMessage   ← 文本内容
  ImageChatMessage  ← 图片（路径、格式、缩略图）
  PdfChatMessage    ← PDF（路径、页数、缩略图）
  SystemChatMessage ← 系统通知

ViewModels/         ← ReactiveUI ViewModel（大量逻辑在基类）
  ChatMessageViewModel     ← 抽象基类：时间格式化、引用状态、删除命令、状态图标
  TextChatMessageViewModel
  ImageChatMessageViewModel ← 懒加载 Bitmap、OpenOriginal
  PdfChatMessageViewModel   ← 懒加载缩略图、OpenPdf
  ChatBoxViewModel          ← 集合管理 + MessageBus 订阅

Renderers/          ← 渲染器（Template Method 模式）
  IChatMessageCellRenderer       ← 接口
  ChatMessageCellRendererBase    ← 抽象基类：公共布局（头、引用、状态行、删除层）
  TextMessageCellRenderer        ← 只实现内容区
  ImageMessageCellRenderer       ← 只实现内容区
  PdfMessageCellRenderer         ← 只实现内容区
  ChatCellRendererRegistry       ← 注册表，支持运行时扩展

Controls/
  ChatBox            ← Avalonia UserControl，集成 ViewModel + Registry