从 SDK 开始 (developTools)
嫌弃 Eridanus 完整本体里那堆繁复的 AI 人设、绘图工具、几十个插件和庞大配置太厚重?没关系!为了让大家能用最干净、最轻量的方式手搓自己的小机器人,我们把最纯粹的通信基座和事件总线单独抽离了出来——这就是 developTools SDK!
通过 SDK,你不需要背负任何框架包袱,纯异步、极简依赖、几行代码就能搭建一个响应飞快的 OneBot v11 机器人应用。
为什么选择轻量 SDK?
- 极致轻量无死重:纯异步
asyncio+websockets+pydantic构建,毫秒级冷启动,哪怕在几百兆内存的超微型 VPS 上也能欢快奔跑; - 完整 OneBot v11 规范支持:完美对接首选推荐的 SnowLuma,或者 NapCat、LLOneBot 等正向 WebSocket 协议端;
- 强类型事件总线 (EventBus):
GroupMessageEvent、PrivateMessageEvent、PokeNotifyEvent等所有事件均为结构化 Pydantic 模型,IDE 自动补全丝滑; - 富有表达力的消息链 (MessageChain):告别原始丑陋的 CQ 码拼接,用
MessageChain([At(...), Text(...), Image(...)])像拼积木一样组装图文; - 无缝平滑升级:SDK 里的事件处理语法与 Eridanus 完整插件体系 100% 兼容,未来随时可以把你写的小脚本直接丢进
run/变成框架插件!
极简 10 秒体验脚本
创建一个名为 quick_bot.py 的文件:
python
import asyncio
from developTools.adapters.websocket_adapter import WebSocketBot
from developTools.event.events import GroupMessageEvent
from developTools.message.message_chain import MessageChain
from developTools.message.message_components import Text, At
# 1. 连接协议端正向 WebSocket
bot = WebSocketBot(uri="ws://127.0.0.1:3001")
# 2. 注册群消息监听器
@bot.on(GroupMessageEvent)
async def handle_group_msg(event: GroupMessageEvent):
# 提取纯文本内容
text = event.pure_text.strip()
if text == "ping":
# 组装一条艾特回复消息链
reply = MessageChain([
At(qq=event.sender.user_id),
Text(" pong! 我是轻量 SDK 驱动的猫娘小助手喵~ ✨")
])
await bot.send(event, reply)
# 3. 阻塞运行
if __name__ == "__main__":
bot.run()只需在终端运行 python quick_bot.py,向你的机器人所在的群里发一句 ping,它就会立刻艾特你并欢快地回上一句 pong! 啦!