Published
Oct 20, 2026
3d ago
Total Downloads
2.4K
2,353
Install
dotnet add package HoshikawaKaguya.Sora.Core --version 3.2.1-gc48a0f0dc7
| Product | Versions |
|---|---|
| .NET |
README
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 |
框架应用层 |
HoshikawaKaguya.Sora.Entities |
共享实体 — 事件、消息段、API 接口 |
HoshikawaKaguya.Sora.Core |
核心工具库 |
HoshikawaKaguya.Sora.Command |
属性指令路由 |
HoshikawaKaguya.Sora.Adapter.Milky |
Milky 协议适配器 |
HoshikawaKaguya.Sora.Adapter.OneBot11 |
OneBot v11 协议适配器（支持截至 Sora 2.2） |
HoshikawaKaguya.Sora.Adapter.OneBot11 的支持范围截至 Sora 2.2；后续版本停止维护，并退出构建、测试和发布。源码、专属测试和示例仅作历史参考，使用
OB11 的项目应固定在 Sora 2.2 或迁移到 Milky。
文档与链接
Changes from Previous Version
No structural changes between v3.2.0 and v3.2.1-gc48a0f0dc7.
Adoption Assessment
A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.
This version is marked prerelease. Validate its API and upgrade path before production use.Compatibility metadata lists 1 target framework; confirm the exact target used by your application.
Related Guides & Workflows
Learn how to evaluate, integrate, or audit this package in your .NET project.