herta-villa-sdk 0.3.0

大别野「黑塔」Python SDK

Herta-villa-SDK

大别野「黑塔」Python SDK

特性

• aiohttp 客户端+服务端，完整异步支持
• 完整类型注解支持
• ...

安装

pip install herta-villa-sdk

快速开始

你需要拥有一个大别野机器人。可前往大别野「机器人开发者社区」（OpenVilla）申请。

from hertavilla import MessageChain, SendMessageEvent, VillaBot, run

bot = VillaBot(
    "bot_id",  # 这里填写 bot_id
    "bot_secret",  # 这里填写 secret
    "/",  # bot 回调 endpoint
)


@bot.startswith("/")  # 注册一个消息匹配器，匹配前缀为 / 的消息
async def _(event: SendMessageEvent, bot: VillaBot):
    message = event.message
    if str(message[1]) == "/hello":
        chain = MessageChain()
        chain.append("world")
        await bot.send(event.villa_id, event.room_id, chain)


run(bot)  # 运行 bot

可以向你的 bot 发送 @Bot /hello，bot 会回复 world。

示例

详见 examples 文件夹

Bug 反馈及建议

大别野 Bot 和 Herta SDK 均处于开发状态中，如遇到问题或有相关建议可通过 Issue 提出，感谢支持！

相关项目

• CMHopeSunshine/villa-py 米游社大别野 Bot Python SDK（非官方）

交流

• 前往大别野「斩尽芜杂」（aaUeZqd）