Merge commit 'a27635cc7821e1b5475be06dab363301dc3329fb' into feat/sdk-integration

whatevertogo · whatevertogo · commit 5df1b3cc233a · 2026-03-30T09:57:25.000+08:00
diff --git a/astrbot-sdk/pyproject.toml b/astrbot-sdk/pyproject.toml
@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 [project]
 name = "astrbot-sdk"
 version = "0.1.0"
-description = "AstrBot SDK with v4 runtime, worker protocol, and plugin tooling"
+description = "AstrBot SDK with s5r runtime, worker protocol, and plugin tooling"
 readme = "README.md"
 requires-python = ">=3.12"
 classifiers = [
diff --git a/astrbot-sdk/src/astrbot_sdk/__init__.py b/astrbot-sdk/src/astrbot_sdk/__init__.py
@@ -1,12 +1,12 @@
 """AstrBot SDK 的顶层公共 API。
 
-这里仅重新导出 v4 推荐直接导入的稳定入口。
+这里仅重新导出 astrbot-sdk 推荐直接导入的稳定入口。
 
 新插件应直接使用此模块的导出：
     from astrbot_sdk import Star, Context, MessageEvent
     from astrbot_sdk.decorators import on_command, on_message
 
-迁移期适配入口位于独立模块；此处只暴露 v4 原生主入口。
+迁移期适配入口位于独立模块；此处只暴露 astrbot-sdk 原生主入口。
 """
 
 from .clients.managers import (
diff --git a/astrbot-sdk/src/astrbot_sdk/cli.py b/astrbot-sdk/src/astrbot_sdk/cli.py
@@ -719,7 +719,7 @@ def _render_init_readme(*, plugin_name: str) -> str:
         f"""\
         # {plugin_name}
 
-        一个最小可运行的 AstrBot SDK v4 插件。
+        一个最小可运行的 AstrBot SDK 插件。
 
         ## 目录结构
 
diff --git a/astrbot-sdk/src/astrbot_sdk/clients/__init__.py b/astrbot-sdk/src/astrbot_sdk/clients/__init__.py
@@ -1,4 +1,4 @@
-"""原生v4能力客户端
+"""原生 astrbot-sdk 能力客户端
 
 这些客户端为 Context 提供了用于调用远程能力的狭窄且具类型化 (typed) 的接口。
 它们负责处理能力名称、载荷格式化（payload shaping）以及结果解码，且不会暴露协议或传输层的具体细节。
diff --git a/astrbot-sdk/src/astrbot_sdk/clients/llm.py b/astrbot-sdk/src/astrbot_sdk/clients/llm.py
@@ -1,6 +1,6 @@
 """大语言模型客户端模块。
 
-提供 v4 原生的 LLM 能力调用接口。
+提供 astrbot-sdk 原生的 LLM 能力调用接口。
 
 设计边界：
     - `chat()` 是便捷文本接口，返回最终文本
diff --git a/astrbot-sdk/src/astrbot_sdk/clients/platform.py b/astrbot-sdk/src/astrbot_sdk/clients/platform.py
@@ -1,6 +1,6 @@
 """平台客户端模块。
 
-提供 v4 原生的平台能力调用。
+提供 astrbot-sdk 原生的平台能力调用。
 
 设计边界：
     - `PlatformClient` 只负责直接的平台 capability
diff --git a/astrbot-sdk/src/astrbot_sdk/context.py b/astrbot-sdk/src/astrbot_sdk/context.py
@@ -1,4 +1,4 @@
-"""v4 原生运行时上下文。
+"""astrbot-sdk 原生运行时上下文。
 
 `Context` 是插件与 AstrBot Core 交互的主要入口，
 负责组合所有 capability 客户端并提供统一的访问接口。
diff --git a/astrbot-sdk/src/astrbot_sdk/decorators.py b/astrbot-sdk/src/astrbot_sdk/decorators.py
@@ -1,4 +1,4 @@
-"""v4 原生装饰器。
+"""astrbot-sdk 原生装饰器。
 
 提供声明式的方法来注册 handler 和 capability。
 装饰器会在方法上附加元数据，由 Star.__init_subclass__ 自动收集。
diff --git a/astrbot-sdk/src/astrbot_sdk/errors.py b/astrbot-sdk/src/astrbot_sdk/errors.py
@@ -32,7 +32,7 @@
 
 
 class ErrorCodes:
-    """AstrBot v4 的稳定错误码常量。
+    """AstrBot SDK 的稳定错误码常量。
 
     这些错误码在协议层稳定，不应随意更改。
     新增错误码应放在对应分类的末尾。
diff --git a/astrbot-sdk/src/astrbot_sdk/events.py b/astrbot-sdk/src/astrbot_sdk/events.py
@@ -1,6 +1,6 @@
-"""v4 原生事件对象。
+"""astrbot-sdk 原生事件对象。
 
-顶层 ``MessageEvent`` 保持精简，只承载 v4 运行时真正需要的基础能力。
+顶层 ``MessageEvent`` 保持精简，只承载 astrbot-sdk 运行时真正需要的基础能力。
 迁移期扩展事件能力放在独立模块中，而不是继续塞回顶层事件类型。
 
 MessageEvent 是 handler 接收的主要事件类型，封装了：
diff --git a/astrbot-sdk/src/astrbot_sdk/protocol/__init__.py b/astrbot-sdk/src/astrbot_sdk/protocol/__init__.py
@@ -1,6 +1,6 @@
-"""AstrBot v4 协议公共入口。
+"""AstrBot s5r 协议公共入口。
 
-这里暴露 v4 原生协议的消息模型、描述符和解析函数。
+这里暴露 s5r 原生协议的消息模型、描述符和解析函数。
 
 握手阶段由 `InitializeMessage` 发起，返回值不是另一条 initialize 消息，而是
 `ResultMessage(kind="initialize_result")`，其 `output` 负载可解析为
diff --git a/astrbot-sdk/src/astrbot_sdk/protocol/_builtin_schemas.py b/astrbot-sdk/src/astrbot_sdk/protocol/_builtin_schemas.py
@@ -1,6 +1,6 @@
 """Builtin protocol schema constants.
 
-本模块定义了 AstrBot SDK v4 协议中所有内置能力的 JSON Schema。
+本模块定义了 AstrBot SDK s5r 协议中所有内置能力的 JSON Schema。
 这些 Schema 用于：
 1. 验证能力调用的输入参数是否符合预期格式
 2. 生成能力描述文档，供插件开发者参考
diff --git a/astrbot-sdk/src/astrbot_sdk/protocol/descriptors.py b/astrbot-sdk/src/astrbot_sdk/protocol/descriptors.py
@@ -1,6 +1,6 @@
-"""v4 协议描述符模型。
+"""s5r 协议描述符模型。
 
-`protocol` 是 v4 新引入的协议层抽象，不对应旧树(圣诞树)中的一个同名目录。这里
+`protocol` 是 s5r 新引入的协议层抽象，不对应旧树(圣诞树)中的一个同名目录。这里
 定义的是跨进程握手和调度时使用的声明式元数据，而不是运行时的具体处理器/
 能力实现。
 """
@@ -68,7 +68,7 @@ def normalize_required_role(self) -> Permissions:
 class SessionRef(_DescriptorBase):
     """结构化会话目标。
 
-    v4 运行时内部仍然保留 legacy `session` 字符串作为最低兼容层，
+    s5r 运行时内部仍然保留 legacy `session` 字符串作为最低兼容层，
     但对外模型允许同时携带平台与原始寻址信息，避免平台发送接口长期
     只依赖一个不透明字符串。
     """
diff --git a/astrbot-sdk/src/astrbot_sdk/protocol/messages.py b/astrbot-sdk/src/astrbot_sdk/protocol/messages.py
@@ -1,4 +1,4 @@
-"""v4 协议消息模型。
+"""s5r 协议消息模型。
 
 这些模型描述的是 `Peer` 与 `Peer` 之间的线协议。握手阶段通过
 `InitializeMessage` 发起，再由 `ResultMessage(kind="initialize_result")`
diff --git a/astrbot-sdk/src/astrbot_sdk/runtime/environment_groups.py b/astrbot-sdk/src/astrbot_sdk/runtime/environment_groups.py
@@ -1,4 +1,4 @@
-"""v4 runtime 的插件共享环境规划模块。
+"""astrbot-sdk runtime 的插件共享环境规划模块。
 
 这个模块负责“多个插件，共享较少数量 Python 环境”的策略。核心约束是：
 
diff --git a/astrbot-sdk/src/astrbot_sdk/runtime/loader.py b/astrbot-sdk/src/astrbot_sdk/runtime/loader.py
@@ -1,7 +1,7 @@
 """插件加载模块。
 
 定义插件发现、环境管理和加载的核心逻辑。
-仅支持 v4 新版 Star 组件。
+仅支持 astrbot-sdk 新版 Star 组件。
 
 核心概念：
     PluginSpec: 插件规范，描述插件的基本信息
@@ -741,7 +741,7 @@ def load_plugin_config(
 
 
 def _is_new_star_component(cls: type[Any]) -> bool:
-    """检查组件类是否为 v4 新版 Star。"""
+    """检查组件类是否为 astrbot-sdk 新版 Star。"""
     return bool(getattr(cls, "__astrbot_is_new_star__", False))
 
 
@@ -1102,7 +1102,7 @@ def _load_component_instance(
         raise ValueError(
             f"{_component_context(plugin, class_path=resolved_component.class_path, index=resolved_component.index)} "
             f"解析到的类 {component_cls.__module__}.{component_cls.__qualname__} "
-            "不是 v4 Star 组件。请继承 astrbot_sdk.Star。"
+            "不是 astrbot-sdk Star 组件。请继承 astrbot_sdk.Star。"
         )
     try:
         instance = component_cls()
@@ -1257,7 +1257,7 @@ def _collect_component_members(
 def load_plugin(plugin: PluginSpec) -> LoadedPlugin:
     """加载插件，返回处理器和能力列表。
 
-    仅支持 v4 新版 Star 组件（无参构造函数）。
+    仅支持 astrbot-sdk 新版 Star 组件（无参构造函数）。
     """
     with _PLUGIN_IMPORT_LOCK:
         logger.debug("Loading SDK plugin {} from {}", plugin.name, plugin.plugin_dir)
diff --git a/astrbot-sdk/src/astrbot_sdk/runtime/peer.py b/astrbot-sdk/src/astrbot_sdk/runtime/peer.py
@@ -54,7 +54,7 @@
     - 入站任务在收到 CancelMessage 时被取消
     - 早到取消：在任务执行前检查 cancel_token，避免竞态条件
 
-`Peer` 把 `Transport` 和 v4 协议消息模型接起来，负责：
+`Peer` 把 `Transport` 和 s5r 协议消息模型接起来，负责：
 
 - 握手与远端元数据缓存
 - 请求 ID 关联
diff --git a/astrbot-sdk/src/astrbot_sdk/runtime/supervisor.py b/astrbot-sdk/src/astrbot_sdk/runtime/supervisor.py
@@ -193,7 +193,7 @@ async def start(self) -> None:
         transport = self._build_transport()
         self.peer = Peer(
             transport=transport,
-            peer_info=PeerInfo(name="astrbot-core", role="core", version="v4"),
+            peer_info=PeerInfo(name="astrbot-core", role="core", version="s5r"),
         )
         self.peer.set_initialize_handler(self._handle_initialize)
         self.peer.set_invoke_handler(self._handle_capability_invoke)
@@ -504,7 +504,7 @@ async def cancel(self, request_id: str) -> None:
 
     async def _handle_initialize(self, _message) -> InitializeOutput:
         return InitializeOutput(
-            peer=PeerInfo(name="astrbot-supervisor", role="core", version="v4"),
+            peer=PeerInfo(name="astrbot-supervisor", role="core", version="s5r"),
             capabilities=self.capability_router.all_descriptors(),
             metadata={
                 "worker_id": self.worker_id,
@@ -548,7 +548,7 @@ def __init__(
         self.capability_router = CapabilityRouter()
         self.peer = Peer(
             transport=self.transport,
-            peer_info=PeerInfo(name="astrbot-supervisor", role="plugin", version="v4"),
+            peer_info=PeerInfo(name="astrbot-supervisor", role="plugin", version="s5r"),
         )
         self.peer.set_invoke_handler(self._handle_upstream_invoke)
         self.peer.set_cancel_handler(self._handle_upstream_cancel)
diff --git a/astrbot-sdk/src/astrbot_sdk/runtime/worker.py b/astrbot-sdk/src/astrbot_sdk/runtime/worker.py
@@ -196,7 +196,7 @@ def __init__(
         self.transport = transport
         self.peer = Peer(
             transport=self.transport,
-            peer_info=PeerInfo(name=self.worker_id, role="plugin", version="v4"),
+            peer_info=PeerInfo(name=self.worker_id, role="plugin", version="s5r"),
         )
         self.skipped_plugins: dict[str, str] = {}
         self.issues: list[PluginDiscoveryIssue] = []
@@ -426,7 +426,7 @@ def __init__(
         self.loaded_plugin = load_plugin(self.plugin)
         self.peer = Peer(
             transport=self.transport,
-            peer_info=PeerInfo(name=self.worker_id, role="plugin", version="v4"),
+            peer_info=PeerInfo(name=self.worker_id, role="plugin", version="s5r"),
         )
         self.dispatcher = HandlerDispatcher(
             plugin_id=self.plugin.name,
diff --git a/astrbot-sdk/src/astrbot_sdk/star.py b/astrbot-sdk/src/astrbot_sdk/star.py
@@ -1,4 +1,4 @@
-"""v4 原生插件基类。"""
+"""astrbot-sdk 原生插件基类。"""
 
 from __future__ import annotations
 
@@ -16,7 +16,7 @@
 
 
 class Star(PluginKVStoreMixin):
-    """v4 原生插件基类。"""
+    """astrbot-sdk 原生插件基类。"""
 
     __handlers__: tuple[str, ...] = ()
 

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-"""原生v4能力客户端`
	`1`	`+"""原生 astrbot-sdk 能力客户端`
`2`	`2`
`3`	`3`	`这些客户端为 Context 提供了用于调用远程能力的狭窄且具类型化 (typed) 的接口。`
`4`	`4`	`它们负责处理能力名称、载荷格式化（payload shaping）以及结果解码，且不会暴露协议或传输层的具体细节。`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-"""v4 原生运行时上下文。`
	`1`	`+"""astrbot-sdk 原生运行时上下文。`
`2`	`2`
`3`	`3`	`Context` 是插件与 AstrBot Core 交互的主要入口，
`4`	`4`	`负责组合所有 capability 客户端并提供统一的访问接口。`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-"""v4 原生装饰器。`
	`1`	`+"""astrbot-sdk 原生装饰器。`
`2`	`2`
`3`	`3`	`提供声明式的方法来注册 handler 和 capability。`
`4`	`4`	`装饰器会在方法上附加元数据，由 Star.__init_subclass__ 自动收集。`