net10.0
Sora 机器人框架 - 属性指令路由
Published
Sep 9, 2026
1mo ago
Total Downloads
1.5K
1,539
Install
dotnet add package HoshikawaKaguya.Sora.Command --version 2.1.2-gff090182ed
| 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 协议
dotnet add package HoshikawaKaguya.Sora.Adapter.OneBot11 # 或 OneBot v11 协议
快速开始
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 协议适配器 |
文档与链接
Changes from Previous Version
No structural changes between v2.1.2-g1a4d4fb064 and v2.1.2-gff090182ed.
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.