hyper-bot 1.0.1__tar.gz → 2.0.0__tar.gz

hyper_bot-2.0.0/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: hyper-bot
+Version: 2.0.0
+Summary: 稳定高效、易于开发的QQ Bot框架
+Author-email: Harcic <harcic@outlook.com>
+Project-URL: repository, https://github.com/HarcicYang/HyperBotCore
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx~=0.28.1
+Requires-Dist: websockets~=17.0.1
+Requires-Dist: fastapi~=0.141.1
+Requires-Dist: uvicorn~=0.52.0
+Requires-Dist: ucfgr>=0.0.5
+Requires-Dist: typing_extensions>=4.9
+Requires-Dist: pydantic>=2.11
+Requires-Dist: packaging>=24.0
+Dynamic: license-file
+
+![banner](./ban.png)
+
+<div align="center">
+<h1>HypeR Core</h1>
+</div>
+
+<p align="center">基于 Python asyncio 的 QQ 机器人框架。V2 采用协议无关核心与独立适配器，V1 继续可用。</p>
+
+<div align="center">
+<img src="https://img.shields.io/badge/Python-3.11%2B-blue" alt="Python 3.11+">
+<img src="https://img.shields.io/static/v1?label=LICENSE&message=GPL-3.0&color=lightrey" alt="GPL-3.0">
+<img src="https://img.shields.io/pypi/v/hyper-bot?label=pypi&color=blue" alt="Pypi">
+</div>
+
+## 概览
+
+HypeR Core 是一个基于 Python asyncio 的 QQ 机器人框架，提供事件系统、消息构建和类型化 API。
+
+V1 继续保留原有接口和内置协议支持。V2 使用独立的 `hyperot.v2` 命名空间，把框架核心和协议适配器分开维护：
+
+- 框架本体只负责事件、消息、API 和生命周期。
+- 具体协议通过独立适配器包接入。
+- 不同适配器有自己的连接配置、事件映射和扩展能力。
+- 业务代码优先使用协议无关的公共事件和 `client.api`。
+
+## V2
+
+V2 使用一个 `Client` 管理一个适配器：
+
+```python
+import asyncio
+
+from hyperot.v2 import Client
+from hyperot.v2.events import MessageReceivedEvent
+
+
+async def on_message(event: MessageReceivedEvent, client: Client) -> None:
+    if str(event.message) == ".ping":
+        await client.api.scene(event.scene_type, event.scene_id).send("pong")
+
+
+async def main() -> None:
+    client = Client.from_appconfig("appconfig.json")
+    client.subscribe(MessageReceivedEvent, on_message)
+    await client.run()
+
+
+asyncio.run(main())
+```
+
+适配器单独安装。例如使用 OneBot v11：
+
+```shell
+pip install hyper-bot hyperot-adapter-onebot
+```
+
+具体安装、连接配置和扩展能力见[适配器文档](./documents/adapters/index.md)。
+
+---
+
+## 文档
+
+- [V2 文档](./documents/v2/index.md)：配置、Client、事件、消息、API 和迁移。
+- [适配器文档](./documents/adapters/index.md)：各适配器的安装和使用说明。
+- [V1 中文文档](./documents/zh.md)：旧版接口和内置协议。
+
+## 安装
+
+需要 Python 3.11 或更高版本。
+
+框架本体：
+
+```shell
+pip install hyper-bot
+```
+
+再安装一个适配器，例如：
+
+```shell
+pip install hyperot-adapter-onebot
+```
+
+## 开发
+
+开发和构建使用 [uv](https://docs.astral.sh/uv/)：
+
+```shell
+git clone https://github.com/HarcicYang/HyperBotCore
+cd HyperBotCore
+uv sync
+```
+
+## 许可
+
+GPL-3.0 License

{hyper_bot-1.0.1 → hyper_bot-2.0.0}/pyproject.toml

@@ -4,12 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hyper-bot"
-version = "1.0.1"
+version = "2.0.0"
 description = "稳定高效、易于开发的QQ Bot框架"
+readme = "readme.md"
 authors = [
     { name = "Harcic", email = "harcic@outlook.com" },
 ]
-urls = { repository = "https://github.com/HarcicYang/HypeR_Bot" }
+urls = { repository = "https://github.com/HarcicYang/HyperBotCore" }
 requires-python = ">=3.11"
 dependencies = [
     "httpx~=0.28.1",
@@ -18,6 +19,8 @@ dependencies = [
     "uvicorn~=0.52.0",
     "ucfgr>=0.0.5",
     "typing_extensions>=4.9",
+    "pydantic>=2.11",
+    "packaging>=24.0",
 ]
 
 [tool.setuptools.packages.find]
@@ -38,7 +41,19 @@ dev = [
     "pytest>=9.1.1",
     "ruff>=0.16.1",
     "pyrefly>=1.2.0",
+    "hyperot-adapter-onebot",
 ]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
+markers = [
+    "euler_live: tests requiring a live local EulerOneBot account",
+    "euler_destructive: destructive live QQ operations",
+]
+
+[tool.uv.workspace]
+members = ["adapters/onebot"]
+
+[tool.uv.sources]
+hyper-bot = { workspace = true }
+hyperot-adapter-onebot = { workspace = true }

hyper_bot-2.0.0/readme.md

@@ -0,0 +1,95 @@
+![banner](./ban.png)
+
+<div align="center">
+<h1>HypeR Core</h1>
+</div>
+
+<p align="center">基于 Python asyncio 的 QQ 机器人框架。V2 采用协议无关核心与独立适配器，V1 继续可用。</p>
+
+<div align="center">
+<img src="https://img.shields.io/badge/Python-3.11%2B-blue" alt="Python 3.11+">
+<img src="https://img.shields.io/static/v1?label=LICENSE&message=GPL-3.0&color=lightrey" alt="GPL-3.0">
+<img src="https://img.shields.io/pypi/v/hyper-bot?label=pypi&color=blue" alt="Pypi">
+</div>
+
+## 概览
+
+HypeR Core 是一个基于 Python asyncio 的 QQ 机器人框架，提供事件系统、消息构建和类型化 API。
+
+V1 继续保留原有接口和内置协议支持。V2 使用独立的 `hyperot.v2` 命名空间，把框架核心和协议适配器分开维护：
+
+- 框架本体只负责事件、消息、API 和生命周期。
+- 具体协议通过独立适配器包接入。
+- 不同适配器有自己的连接配置、事件映射和扩展能力。
+- 业务代码优先使用协议无关的公共事件和 `client.api`。
+
+## V2
+
+V2 使用一个 `Client` 管理一个适配器：
+
+```python
+import asyncio
+
+from hyperot.v2 import Client
+from hyperot.v2.events import MessageReceivedEvent
+
+
+async def on_message(event: MessageReceivedEvent, client: Client) -> None:
+    if str(event.message) == ".ping":
+        await client.api.scene(event.scene_type, event.scene_id).send("pong")
+
+
+async def main() -> None:
+    client = Client.from_appconfig("appconfig.json")
+    client.subscribe(MessageReceivedEvent, on_message)
+    await client.run()
+
+
+asyncio.run(main())
+```
+
+适配器单独安装。例如使用 OneBot v11：
+
+```shell
+pip install hyper-bot hyperot-adapter-onebot
+```
+
+具体安装、连接配置和扩展能力见[适配器文档](./documents/adapters/index.md)。
+
+---
+
+## 文档
+
+- [V2 文档](./documents/v2/index.md)：配置、Client、事件、消息、API 和迁移。
+- [适配器文档](./documents/adapters/index.md)：各适配器的安装和使用说明。
+- [V1 中文文档](./documents/zh.md)：旧版接口和内置协议。
+
+## 安装
+
+需要 Python 3.11 或更高版本。
+
+框架本体：
+
+```shell
+pip install hyper-bot
+```
+
+再安装一个适配器，例如：
+
+```shell
+pip install hyperot-adapter-onebot
+```
+
+## 开发
+
+开发和构建使用 [uv](https://docs.astral.sh/uv/)：
+
+```shell
+git clone https://github.com/HarcicYang/HyperBotCore
+cd HyperBotCore
+uv sync
+```
+
+## 许可
+
+GPL-3.0 License

hyper_bot-2.0.0/src/hyper_bot.egg-info/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: hyper-bot
+Version: 2.0.0
+Summary: 稳定高效、易于开发的QQ Bot框架
+Author-email: Harcic <harcic@outlook.com>
+Project-URL: repository, https://github.com/HarcicYang/HyperBotCore
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx~=0.28.1
+Requires-Dist: websockets~=17.0.1
+Requires-Dist: fastapi~=0.141.1
+Requires-Dist: uvicorn~=0.52.0
+Requires-Dist: ucfgr>=0.0.5
+Requires-Dist: typing_extensions>=4.9
+Requires-Dist: pydantic>=2.11
+Requires-Dist: packaging>=24.0
+Dynamic: license-file
+
+![banner](./ban.png)
+
+<div align="center">
+<h1>HypeR Core</h1>
+</div>
+
+<p align="center">基于 Python asyncio 的 QQ 机器人框架。V2 采用协议无关核心与独立适配器，V1 继续可用。</p>
+
+<div align="center">
+<img src="https://img.shields.io/badge/Python-3.11%2B-blue" alt="Python 3.11+">
+<img src="https://img.shields.io/static/v1?label=LICENSE&message=GPL-3.0&color=lightrey" alt="GPL-3.0">
+<img src="https://img.shields.io/pypi/v/hyper-bot?label=pypi&color=blue" alt="Pypi">
+</div>
+
+## 概览
+
+HypeR Core 是一个基于 Python asyncio 的 QQ 机器人框架，提供事件系统、消息构建和类型化 API。
+
+V1 继续保留原有接口和内置协议支持。V2 使用独立的 `hyperot.v2` 命名空间，把框架核心和协议适配器分开维护：
+
+- 框架本体只负责事件、消息、API 和生命周期。
+- 具体协议通过独立适配器包接入。
+- 不同适配器有自己的连接配置、事件映射和扩展能力。
+- 业务代码优先使用协议无关的公共事件和 `client.api`。
+
+## V2
+
+V2 使用一个 `Client` 管理一个适配器：
+
+```python
+import asyncio
+
+from hyperot.v2 import Client
+from hyperot.v2.events import MessageReceivedEvent
+
+
+async def on_message(event: MessageReceivedEvent, client: Client) -> None:
+    if str(event.message) == ".ping":
+        await client.api.scene(event.scene_type, event.scene_id).send("pong")
+
+
+async def main() -> None:
+    client = Client.from_appconfig("appconfig.json")
+    client.subscribe(MessageReceivedEvent, on_message)
+    await client.run()
+
+
+asyncio.run(main())
+```
+
+适配器单独安装。例如使用 OneBot v11：
+
+```shell
+pip install hyper-bot hyperot-adapter-onebot
+```
+
+具体安装、连接配置和扩展能力见[适配器文档](./documents/adapters/index.md)。
+
+---
+
+## 文档
+
+- [V2 文档](./documents/v2/index.md)：配置、Client、事件、消息、API 和迁移。
+- [适配器文档](./documents/adapters/index.md)：各适配器的安装和使用说明。
+- [V1 中文文档](./documents/zh.md)：旧版接口和内置协议。
+
+## 安装
+
+需要 Python 3.11 或更高版本。
+
+框架本体：
+
+```shell
+pip install hyper-bot
+```
+
+再安装一个适配器，例如：
+
+```shell
+pip install hyperot-adapter-onebot
+```
+
+## 开发
+
+开发和构建使用 [uv](https://docs.astral.sh/uv/)：
+
+```shell
+git clone https://github.com/HarcicYang/HyperBotCore
+cd HyperBotCore
+uv sync
+```
+
+## 许可
+
+GPL-3.0 License

{hyper_bot-1.0.1 → hyper_bot-2.0.0}/src/hyper_bot.egg-info/SOURCES.txt

@@ -1,5 +1,6 @@
 LICENSE
 pyproject.toml
+readme.md
 src/hyper_bot.egg-info/PKG-INFO
 src/hyper_bot.egg-info/SOURCES.txt
 src/hyper_bot.egg-info/dependency_links.txt
@@ -35,6 +36,42 @@ src/hyperot/utils/errors.py
 src/hyperot/utils/hypetyping.py
 src/hyperot/utils/screens.py
 src/hyperot/utils/typextensions.py
+src/hyperot/v2/__init__.py
+src/hyperot/v2/hyperogger.py
+src/hyperot/v2/logging.py
+src/hyperot/v2/style.py
+src/hyperot/v2/actions/__init__.py
+src/hyperot/v2/actions/base.py
+src/hyperot/v2/actions/formatting.py
+src/hyperot/v2/actions/models.py
+src/hyperot/v2/actions/result.py
+src/hyperot/v2/adapter/__init__.py
+src/hyperot/v2/adapter/loader.py
+src/hyperot/v2/adapter/manifest.py
+src/hyperot/v2/adapter/protocol.py
+src/hyperot/v2/adapter/registry.py
+src/hyperot/v2/api/__init__.py
+src/hyperot/v2/api/base.py
+src/hyperot/v2/api/context.py
+src/hyperot/v2/client/__init__.py
+src/hyperot/v2/client/client.py
+src/hyperot/v2/client/executor.py
+src/hyperot/v2/client/runtime.py
+src/hyperot/v2/common/__init__.py
+src/hyperot/v2/common/enums.py
+src/hyperot/v2/common/errors.py
+src/hyperot/v2/common/ids.py
+src/hyperot/v2/common/models.py
+src/hyperot/v2/config/__init__.py
+src/hyperot/v2/config/loader.py
+src/hyperot/v2/config/models.py
+src/hyperot/v2/events/__init__.py
+src/hyperot/v2/events/base.py
+src/hyperot/v2/events/dispatcher.py
+src/hyperot/v2/events/formatting.py
+src/hyperot/v2/events/models.py
+src/hyperot/v2/messages/__init__.py
+src/hyperot/v2/messages/segments.py
 tests/test_configurator.py
 tests/test_events.py
 tests/test_listener.py

{hyper_bot-1.0.1 → hyper_bot-2.0.0}/src/hyper_bot.egg-info/requires.txt

@@ -4,3 +4,5 @@ fastapi~=0.141.1
 uvicorn~=0.52.0
 ucfgr>=0.0.5
 typing_extensions>=4.9
+pydantic>=2.11
+packaging>=24.0

{hyper_bot-1.0.1 → hyper_bot-2.0.0}/src/hyperot/adapters/milky/translator.py

@@ -112,9 +112,9 @@ def message_translator(milky_message: list[dict], peer_id: int, scene: int = 0)
             case "xml":
                 builder.json({"service_id": seg_data.get("service_id", 0), "payload": seg_data.get("xml_payload", "")})
             case "file":
-                logger.debug(f"忽略不支持的文件消息段：{seg_data}")
+                logger.trace(f"忽略不支持的文件消息段：{seg_data}")
             case _:
-                logger.debug(f"忽略未知消息段：{seg_type}")
+                logger.trace(f"忽略未知消息段：{seg_type}")
 
     return builder.build()
 
@@ -253,7 +253,7 @@ class MilkyHttpConnection(WebsocketConnection):
                         .build()
                     )
                 if scene == "temp":
-                    logger.debug(f"临时会话消息按私聊消息处理：{milky_data}")
+                    logger.trace(f"临时会话消息按私聊消息处理：{milky_data}")
                     return (
                         builder.init(milky_time, milky_self_id, milky_data["sender_id"], 0)
                         .as_private_message(
@@ -263,7 +263,7 @@ class MilkyHttpConnection(WebsocketConnection):
                         .private_sender("", "unknown", 0)
                         .build()
                     )
-                logger.debug(f"忽略未知消息场景：{scene}")
+                logger.trace(f"忽略未知消息场景：{scene}")
                 return None
             case "bot_offline":
                 return (
@@ -407,7 +407,7 @@ class MilkyHttpConnection(WebsocketConnection):
                     .build()
                 )
             case _:
-                logger.debug(f"忽略未知事件类型：{milky_event_type}")
+                logger.trace(f"忽略未知事件类型：{milky_event_type}")
                 return None
 
     async def http_send(self, endpoint: str, data: dict) -> dict:

hyper_bot-2.0.0/src/hyperot/v2/__init__.py

@@ -0,0 +1,75 @@
+from .api import ClientAPI
+from .client import Client
+from .common import (
+    FileId,
+    GroupId,
+    MemberRole,
+    MessageId,
+    RequestId,
+    SceneId,
+    SceneType,
+    UserId,
+)
+from .events import (
+    BotOfflineEvent,
+    BotOnlineEvent,
+    ClientStartedEvent,
+    ClientStoppedEvent,
+    Event,
+    MessageReceivedEvent,
+    SceneEvent,
+)
+from .messages import (
+    Audio,
+    Face,
+    File,
+    Forward,
+    ForwardNode,
+    Image,
+    Markdown,
+    Mention,
+    MentionAll,
+    Message,
+    Quote,
+    Segment,
+    Text,
+    UnknownSegment,
+    Video,
+)
+
+__version__ = "2.0.0"
+
+__all__ = [
+    "Audio",
+    "BotOfflineEvent",
+    "BotOnlineEvent",
+    "Client",
+    "ClientAPI",
+    "ClientStartedEvent",
+    "ClientStoppedEvent",
+    "Event",
+    "Face",
+    "File",
+    "FileId",
+    "Forward",
+    "ForwardNode",
+    "GroupId",
+    "Image",
+    "Markdown",
+    "MemberRole",
+    "Mention",
+    "MentionAll",
+    "Message",
+    "MessageId",
+    "MessageReceivedEvent",
+    "Quote",
+    "RequestId",
+    "SceneEvent",
+    "SceneId",
+    "SceneType",
+    "Segment",
+    "Text",
+    "UnknownSegment",
+    "UserId",
+    "Video",
+]

hyper_bot-2.0.0/src/hyperot/v2/actions/__init__.py

@@ -0,0 +1,103 @@
+from .base import Action
+from .models import (
+    ApproveFriendRequestAction,
+    ApproveGroupRequestAction,
+    DownloadFileAction,
+    FetchMessageAction,
+    GetBotProfileAction,
+    GetBotStatusAction,
+    GetCookieAction,
+    GetCsrfTokenAction,
+    GetFileInfoAction,
+    GetFriendListAction,
+    GetGroupListAction,
+    GetGroupMemberAction,
+    GetGroupMemberListAction,
+    GetGroupProfileAction,
+    GetUserProfileAction,
+    GetVersionAction,
+    KickMemberAction,
+    LeaveGroupAction,
+    MuteMemberAction,
+    PokeAction,
+    RawAction,
+    ReactMessageAction,
+    RecallMessageAction,
+    RejectFriendRequestAction,
+    RejectGroupRequestAction,
+    SendLikeAction,
+    SendMessageAction,
+    SetEssenceAction,
+    SetGroupMuteAction,
+    SetGroupNameAction,
+    SetMemberCardAction,
+    SetMemberRoleAction,
+    SetMemberTitleAction,
+    UnmuteMemberAction,
+)
+from .result import (
+    BotProfile,
+    BotStatus,
+    CookieInfo,
+    CsrfTokenInfo,
+    FileReference,
+    FileUrl,
+    FriendInfo,
+    GroupMemberProfile,
+    GroupProfile,
+    RawResult,
+    SendResult,
+    UserProfile,
+    VersionInfo,
+)
+
+__all__ = [
+    "Action",
+    "ApproveFriendRequestAction",
+    "ApproveGroupRequestAction",
+    "BotProfile",
+    "BotStatus",
+    "CookieInfo",
+    "CsrfTokenInfo",
+    "DownloadFileAction",
+    "FetchMessageAction",
+    "FileReference",
+    "FileUrl",
+    "FriendInfo",
+    "GetBotProfileAction",
+    "GetBotStatusAction",
+    "GetCookieAction",
+    "GetCsrfTokenAction",
+    "GetFileInfoAction",
+    "GetFriendListAction",
+    "GetGroupListAction",
+    "GetGroupMemberAction",
+    "GetGroupMemberListAction",
+    "GetGroupProfileAction",
+    "GetUserProfileAction",
+    "GetVersionAction",
+    "GroupMemberProfile",
+    "GroupProfile",
+    "KickMemberAction",
+    "LeaveGroupAction",
+    "MuteMemberAction",
+    "PokeAction",
+    "RawAction",
+    "RawResult",
+    "ReactMessageAction",
+    "RecallMessageAction",
+    "RejectFriendRequestAction",
+    "RejectGroupRequestAction",
+    "SendLikeAction",
+    "SendMessageAction",
+    "SendResult",
+    "SetEssenceAction",
+    "SetGroupMuteAction",
+    "SetGroupNameAction",
+    "SetMemberCardAction",
+    "SetMemberRoleAction",
+    "SetMemberTitleAction",
+    "UnmuteMemberAction",
+    "UserProfile",
+    "VersionInfo",
+]

hyper_bot-2.0.0/src/hyperot/v2/actions/base.py

@@ -0,0 +1,23 @@
+from typing import ClassVar, Generic, TypeVar
+
+from pydantic import BaseModel, ConfigDict
+
+from .formatting import format_value
+
+ResultT = TypeVar("ResultT")
+
+
+class Action(BaseModel, Generic[ResultT]):
+    model_config = ConfigDict(frozen=True, extra="forbid", strict=True)
+
+    log_level: ClassVar[str] = "INFO"
+
+    def log_summary(self) -> str:
+        fields = [
+            f"{name}={format_value(value)}"
+            for name in type(self).model_fields
+            if (value := getattr(self, name)) is not None
+        ]
+        if not fields:
+            return type(self).__name__
+        return f"{type(self).__name__} {' '.join(fields)}"