tsugu 1.1.0

Tsugu Python Frontend

Chat Tsugu Py

✨ Python 编写的 TsuguBanGDreamBot 自然语言交互库 ✨

---

pip install tsugu

API powered by tsugu-api-python

Command matching provided by Alconna

---

handler

• handler 用于直接处理用户输入的自然语言并返回查询结果:

import tsugu

# 四个参数，分别意味着 消息内容 用户id 平台 频道id
for i in tsugu.handler(message='查卡 ars 1x', user_id='1528593481', platform='red', channel_id='666808414'):
    print('文本: ',i) if isinstance(i, str) else None
    print(f"[图片]") if isinstance(i, bytes) else None

import tsugu_async
...

在常用的qqbot中，群号就是 channel_id。
当你使用QQ号作为 user_id 时，platform 可以填写 red。

handler_raw

如果你方便使用 base64，handler_raw 方法或许会更好
tsugu 后端本身返回此数据结构，这个方法可以节省不必要的开销。

import tsugu

for i in tsugu.handler_raw(message='查卡 ars 1x', user_id='1528593481', platform='red', channel_id='666808414'):
    print('文本: ',i) if i['type'] == 'text' else None
    print(f"[图片]") if i['type'] == 'base64' else None

import tsugu_async
...

配置

tsugu config

• tsugu 在被导入时初始化 Alconna 命令匹配，避免了在多线程环境中使用，但同时无法支持配置项的修改。

tsugu_async config

from tsugu_async import config


config.compact = True
'''
是否允许命令与参数之间没有空格
'''

config.disable_gacha_simulate_group_ids = []
'''
需要关闭模拟抽卡的群
'''

---

友情文档：tsugu_api 文档

tsugu_api_core settings

from tsugu_api_core import settings

settings.timeout = 10
'''
请求超时时间
'''

settings.proxy = ''
'''
代理地址
'''

settings.backend_url = 'http://tsugubot.com:8080'
'''
后端地址
默认为 Tsugu 官方后端，若有自建后端服务器可进行修改。
'''

settings.backend_proxy = True
'''
是否使用后端代理
当设置代理地址后可修改此项以决定是否使用代理。
默认为 True，即使用后端代理。若使用代理时后端服务器无法访问，可将此项设置为 False。
'''

settings.userdata_backend_url = 'http://tsugubot.com:8080'
'''
用户数据后端地址
默认为 Tsugu 官方后端，若有自建后端服务器可进行修改。
'''

settings.userdata_backend_proxy = True
'''
是否使用用户数据后端代理
当设置代理地址后可修改此项以决定是否使用代理。
默认为 True，即使用后端代理。若使用代理时后端服务器无法访问，可将此项设置为 False。
'''

settings.use_easy_bg = True
'''
是否使用简易背景，使用可在降低背景质量的前提下加快响应速度。
默认为 True，即使用简易背景。若不使用简易背景，可将此项设置为 False。
'''

settings.compress = True
'''
是否压缩返回数据，压缩可减少返回数据大小。
默认为 True，即压缩返回数据。若不压缩返回数据，可将此项设置为 False。
'''

---