HoshikawaKaguya.Sora.Entities

Sora

一个基于 C#/.NET 10 的多协议异步机器人开发框架

特性

• 协议适配：Milky（维护中）；OneBot v11 适配器已废弃并停止维护
• 模块化架构
• 属性指令路由（[CommandGroup] + [Command]）
• 事件管线过滤器（前置/命令/后置）
• 完整的事件分发与消息等待机制
• 简单直接的 API 设计

安装

dotnet add package HoshikawaKaguya.Sora
dotnet add package HoshikawaKaguya.Sora.Adapter.Milky    # Milky 协议

快速开始

using Sora;
using Sora.Adapter.Milky;

SoraService service = SoraServiceFactory.Instance.CreateMilkyService(
    new MilkyConfig
        {
            Host        = "localhost",
            Port        = 3010,
            AccessToken = "your-token"
        });

service.Events.OnMessageReceived += async e =>
{
    if (e.Message.Body.GetText() == "ping")
        await e.Api.SendGroupMessageAsync(e.Message.GroupId, new MessageBody("pong"));
};

await service.StartAsync();
await Task.Delay(-1);

项目模块

HoshikawaKaguya.Sora.Adapter.OneBot11 的支持范围截至 Sora 2.2；后续版本停止维护，并退出构建、测试和发布。源码、专属测试和示例仅作历史参考，使用 OB11 的项目应固定在 Sora 2.2 或迁移到 Milky。

文档与链接

• GitHub 仓库
• 开源协议 (Apache-2.0)