tsugu 1.1.0rc5

Tsugu Python Frontend

Chat Tsugu Py

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

---

• tsugu

• tsugu_async

• tsugu_thread

• tsugu_thread 中避免了在多线程环境中使用 Alconna，但同时不再支持 'compact' 配置项，tsugu_thread 不一定会一直维护。

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_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。
'''

tsugu config

from tsugu import config


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

config.remote_data_max_retry = 3
'''
获取远程用户数据最大重试次数
'''

config.bandori_station_token_name = "Tsugu"
'''
bandori station token
'''
config.bandori_station_token = "ZtV4EX2K9Onb"
'''
bandori station token
'''

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

tsugu_async config

from tsugu_async import config
...
# 与 tsugu config 相同

---

客服🐱指导(这里可以点击)

注意，如果你不知道什么是BanGDream，请不要随意加群
本群还是欢迎加群的（
BanGDreamBot开发聊天群
温馨的聊天环境～

---