云湖平台事件转换模块 (YunhuAdapter4OneBot12)
功能概述
本模块用于将云湖(即时通讯平台)的事件数据转换为标准的OneBot12格式。支持消息、通知等多种事件类型
安装方法
pip install yunhu2onebot12
使用方法
基本使用
from yunhu2onebot12 import Converter
# 创建转换器实例
converter = Converter()
# 云湖平台原始事件数据
yunhu_event = {
"version": "1.0",
"header": {
"eventId": "c192ccc83d5147f2859ca77bcfafc9f9",
"eventType": "message.receive.normal",
"eventTime": 1748613099002
},
"event": {
# ... 事件数据 ...
}
}
# 转换为OneBot12格式
onebot_event = converter.convert(yunhu_event)
支持的事件类型
| 云湖事件类型 |
|---|
| message.receive.normal |
| message.receive.instruction |
| bot.followed |
| bot.unfollowed |
| group.join |
| group.leave |
| button.report.inline |
| bot.shortcut.menu |
消息类型支持
支持以下内容类型的消息转换：
- 文本(text)
- 图片(image)
- 视频(video)
- 文件(file)
- 表单指令(form)
特殊字段处理
部分云湖特有字段会在转换后的OneBot事件中以yunhu_前缀的非标准字段形式保留：
yunhu_form: 表单类型指令数据yunhu_button: 按钮相关数据yunhu_menu: 快捷菜单数据
错误处理
- 如果传入不支持的事件类型，方法会返回
None - 当事件数据格式错误时会抛出
ValueError
注意事项
- 使用 Python 3.7 及更高版本
- 本模块仅处理事件格式转换，不包含网络通信功能
- 云湖特有字段在OneBot12标准中可能不被其他组件识别
- 表单消息/按钮/快捷菜单 事件是云湖平台特有功能，转换后会添加
yunhu_前缀
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file yunhu2onebot12-1.2.0.tar.gz.
File metadata
- Download URL: yunhu2onebot12-1.2.0.tar.gz
- Upload date:
- Size: 5.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c6ef6cd78e0d1a2269d5c073a2102c6e9bb68014c712df4054577a05a42dc54c
|
|
| MD5 |
4cf1d556f5eb7b3d2efdc3a80f14f243
|
|
| BLAKE2b-256 |
dd038a9ab4eb6fd1527a5376cf30c6f1fed4d7e2e863937d4ce12bfb5f9c732e
|
Provenance
The following attestation bundles were made for yunhu2onebot12-1.2.0.tar.gz:
Publisher:
python-publish.yml on wsu2059q/YunhuAdapter4OneBot12
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yunhu2onebot12-1.2.0.tar.gz -
Subject digest:
c6ef6cd78e0d1a2269d5c073a2102c6e9bb68014c712df4054577a05a42dc54c - Sigstore transparency entry: 864431460
- Sigstore integration time:
-
Permalink:
wsu2059q/YunhuAdapter4OneBot12@d3964762a76e7b2145665f23b544dcbad4e832b1 -
Branch / Tag:
refs/heads/master - Owner: https://github.com/wsu2059q
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@d3964762a76e7b2145665f23b544dcbad4e832b1 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file yunhu2onebot12-1.2.0-py3-none-any.whl.
File metadata
- Download URL: yunhu2onebot12-1.2.0-py3-none-any.whl
- Upload date:
- Size: 6.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c7ddfeecfabdb955496fa607162de041f0ac36a80000401c48ce8b0da23ab2a7
|
|
| MD5 |
e6751295798dd7f9ed928640ff2e449a
|
|
| BLAKE2b-256 |
bb8ae680941728217e7a7ffce40fe6629db520f4cc67d9e3a89956b001094342
|
Provenance
The following attestation bundles were made for yunhu2onebot12-1.2.0-py3-none-any.whl:
Publisher:
python-publish.yml on wsu2059q/YunhuAdapter4OneBot12
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yunhu2onebot12-1.2.0-py3-none-any.whl -
Subject digest:
c7ddfeecfabdb955496fa607162de041f0ac36a80000401c48ce8b0da23ab2a7 - Sigstore transparency entry: 864431502
- Sigstore integration time:
-
Permalink:
wsu2059q/YunhuAdapter4OneBot12@d3964762a76e7b2145665f23b544dcbad4e832b1 -
Branch / Tag:
refs/heads/master - Owner: https://github.com/wsu2059q
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@d3964762a76e7b2145665f23b544dcbad4e832b1 -
Trigger Event:
workflow_dispatch
-
Statement type:
