Home

Awesome

MilkiBotFramework

简称Milki。易于使用与快速开发，基于.net 6的高性能机器人框架（内置OneBot实现）

本项目源自旧项目 https://github.com/Milkitic/daylily/tree/archived/v2 的彻底改造。

其基本的系统逻辑不变，但是提升了代码可维护度、工程合理度、拓展性、性能、稳定性，以及最重要的，将框架本身独立，并与Bot逻辑不相干。

现旧项目已基于本框架重构，可作为示例仓库，更多请见项目主页

特色

  1. 插件式开发。对于Bot编写者，只需完成插件类的开发。包含消息、事件、服务处理。（当然，也支持比较原始的EventHandler方式）
  2. 开箱即用。在不进行自定义设置的情况下，支持三行代码完成运行部署。
  3. 支持多平台统一API。这代表着若你编写插件是通用的（例如：不包括特定的CQ码如戳一戳），你可以将Bot功能快速转移至其他平台（例如：OneBot -> Discord）
  4. 框架层面的数据库管理(目前Migration仅支持ExecutingAssembly)、资源管理以及配置管理，插件之间统一。
  5. 完善的命令支持。将用户输入自动转换为对应插件方法的参数。
  6. 编写插件时，支持插件之间与框架本身功能的依赖注入，插件开发有着很高自由度。
  7. 若内置的一些逻辑无法满足你的需求，你可以自己进行部分中间件的继承与修改。
  8. 内置UI框架级的图形绘制功能。无需用户进行原始的绘图操作，支持Xaml设计器。
  9. 插件支持使用单点的ASP.NET Core Web框架（默认支持WebApi）。这意味着在你的程序集内，新增对应的ControllerBase类即可。同时支持在你的Controller内依赖注入MilkiBotFramework的各种单点模块（不支持插件的注入，因为两者的Scope不一致）。
  10. 内部事件完善，且关键模型本身支持属性更新通知。这代表着你将更容易制作GUI相关插件。

示例

前置条件： 将go-cqhttp配置为websocket连接，地址设置为ws://127.0.0.1:6700，运行并确认正常工作。

新建dotnet项目

dotnet new console --name MyBotApp

在Program.cs内编写:

using MilkiBotFramework;
using MilkiBotFramework.Messaging;
using MilkiBotFramework.Platforms.GoCqHttp;
using MilkiBotFramework.Plugining;
using MilkiBotFramework.Plugining.Attributes;

return await new BotBuilder()
      .UseGoCqHttp(GoCqConnection.WebSocket("ws://127.0.0.1:6700"))
      .Build()
      .RunAsync();

[PluginIdentifier(guid: "e4c18c40-afe0-447b-b7eb-b84f842520b4", name: "HelloWorld Demo")]
public class HelloWorld : BasicPlugin
{
    [CommandHandler]
    public IResponse Echo([Argument] string content) => Reply(content);
}

运行项目 dotnet run

控制台相关输出

11:06:13.92+08 info: MilkiBotFramework.Platforms.GoCqHttp.Connecting.GoCqClient[0]
      Connected to websocket server.
......
11:06:14.26+08 info: MilkiBotFramework.Plugining.PluginManager[0]
      Add plugin "HelloWorld Demo" (Scoped BasicPlugin)
11:06:14.28+08 info: MilkiBotFramework.Plugining.PluginManager[0]
      Plugin initialization done in 0.360s!

以上输出代表着bot已初始化完成。 下面私聊bot账号，输入/echo helloworld，若bot成功回复了helloworld，代表着你已成功完成了你的Hello World功能！

贡献

本项目十分欢迎contribute~因为对于各种平台适配需要大家的一起帮助才能更加的高效。

但是有以下几个很基本的点，在提交PR前请注意：

  1. 编译通过
  2. 代码本身足够的清晰，请使用现有的代码样式（变量命名基础原则、括号换行等），使用代码格式化工具完成过清理
  3. 尽可能的使git的提交记录足够清晰，避免无法区分更新内容的大面积更改
  4. 如果是较大的更新，请事先进行discussion，避免低效地重做等

框架本身设计文档待完善

TODO:

FINISHED:

NOT DETERMINED:

TBD:

是否支持同时多OneBot实例亦或是其他的客户端，以进行多平台互联？ 目前该框架设计没有考虑这一点，考虑到其实用性，大概率会以大版本号更新实现。

类似nonebot内置自然语言处理器？ 我认为没有必要内置，因为此类功能放入通用框架并不是足够的成熟稳定（存在各种概率因素）。可以继承ICommandLineAnalyzer，编写自己的命令分析器，将自然语言映射成对应命令。

第三方库

社区

官方