From edbb8560230d3d0166567f86b71048b938097312 Mon Sep 17 00:00:00 2001
From: Raven95676 <Raven95676@gmail.com>
Date: Fri, 4 Jul 2025 15:39:31 +0800
Subject: [PATCH] refactor: deprecate register_star decorator

---
 astrbot/core/star/__init__.py             | 10 +++++-
 astrbot/core/star/register/star.py        | 19 ++++-------
 astrbot/core/star/star.py                 | 39 +++++++++++++----------
 astrbot/core/star/star_manager.py         |  6 ++--
 packages/astrbot/main.py                  |  6 ----
 packages/astrbot/metadata.yaml            |  4 +++
 packages/python_interpreter/main.py       |  6 ----
 packages/python_interpreter/metadata.yaml |  4 +++
 packages/reminder/main.py                 |  3 --
 packages/reminder/metadata.yaml           |  4 +++
 packages/session_controller/main.py       |  9 +-----
 packages/session_controller/metadata.yaml |  5 +++
 packages/thinking_filter/main.py          |  9 +-----
 packages/thinking_filter/metadata.yaml    |  5 +++
 packages/web_searcher/main.py             |  6 ----
 packages/web_searcher/metadata.yaml       |  4 +++
 16 files changed, 69 insertions(+), 70 deletions(-)
 create mode 100644 packages/astrbot/metadata.yaml
 create mode 100644 packages/python_interpreter/metadata.yaml
 create mode 100644 packages/reminder/metadata.yaml
 create mode 100644 packages/session_controller/metadata.yaml
 create mode 100644 packages/thinking_filter/metadata.yaml
 create mode 100644 packages/web_searcher/metadata.yaml

diff --git a/astrbot/core/star/__init__.py b/astrbot/core/star/__init__.py
index d9f980e82..3337e4c25 100644
--- a/astrbot/core/star/__init__.py
+++ b/astrbot/core/star/__init__.py
@@ -1,4 +1,4 @@
-from .star import StarMetadata
+from .star import StarMetadata, star_map
 from .star_manager import PluginManager
 from .context import Context
 from astrbot.core.provider import Provider
@@ -14,6 +14,14 @@ class Star(CommandParserMixin):
         StarTools.initialize(context)
         self.context = context
 
+    def __init_subclass__(cls, **kwargs):
+        super().__init_subclass__(**kwargs)
+        metadata = StarMetadata(
+            star_cls_type=cls,
+            module_path=cls.__module__,
+        )
+        star_map[cls.__module__] = metadata
+
     @staticmethod
     async def text_to_image(text: str, return_url=True) -> str:
         """将文本转换为图片"""
diff --git a/astrbot/core/star/register/star.py b/astrbot/core/star/register/star.py
index 01ff9adaa..b1ef8550a 100644
--- a/astrbot/core/star/register/star.py
+++ b/astrbot/core/star/register/star.py
@@ -1,4 +1,4 @@
-from ..star import star_registry, StarMetadata, star_map
+import warnings
 
 
 def register_star(name: str, author: str, desc: str, version: str, repo: str = None):
@@ -21,18 +21,13 @@ def register_star(name: str, author: str, desc: str, version: str, repo: str = N
     帮助信息会被自动提取。使用 `/plugin <插件名> 可以查看帮助信息。`
     """
 
+    warnings.warn(
+        "The 'register_star' decorator is deprecated and will be removed in a future version.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+
     def decorator(cls):
-        star_metadata = StarMetadata(
-            name=name,
-            author=author,
-            desc=desc,
-            version=version,
-            repo=repo,
-            star_cls_type=cls,
-            module_path=cls.__module__,
-        )
-        star_registry.append(star_metadata)
-        star_map[cls.__module__] = star_metadata
         return cls
 
     return decorator
diff --git a/astrbot/core/star/star.py b/astrbot/core/star/star.py
index 10cf90c8b..bc8f3d404 100644
--- a/astrbot/core/star/star.py
+++ b/astrbot/core/star/star.py
@@ -1,12 +1,12 @@
 from __future__ import annotations
 
-from types import ModuleType
-from typing import List, Dict
 from dataclasses import dataclass, field
+from types import ModuleType
+
 from astrbot.core.config import AstrBotConfig
 
-star_registry: List[StarMetadata] = []
-star_map: Dict[str, StarMetadata] = {}
+star_registry: list[StarMetadata] = []
+star_map: dict[str, StarMetadata] = {}
 """key 是模块路径，__module__"""
 
 
@@ -18,22 +18,27 @@ class StarMetadata:
     当 activated 为 False 时，star_cls 可能为 None，请不要在插件未激活时调用 star_cls 的方法。
     """
 
-    name: str
-    author: str  # 插件作者
-    desc: str  # 插件简介
-    version: str  # 插件版本
-    repo: str = None  # 插件仓库地址
+    name: str | None = None
+    """插件名"""
+    author: str | None = None
+    """插件作者"""
+    desc: str | None = None
+    """插件简介"""
+    version: str | None = None
+    """插件版本"""
+    repo: str | None = None
+    """插件仓库地址"""
 
-    star_cls_type: type = None
+    star_cls_type: type | None = None
     """插件的类对象的类型"""
-    module_path: str = None
+    module_path: str | None = None
     """插件的模块路径"""
 
-    star_cls: object = None
+    star_cls: object | None = None
     """插件的类对象"""
-    module: ModuleType = None
+    module: ModuleType | None = None
     """插件的模块对象"""
-    root_dir_name: str = None
+    root_dir_name: str | None = None
     """插件的目录名称"""
     reserved: bool = False
     """是否是 AstrBot 的保留插件"""
@@ -41,13 +46,13 @@ class StarMetadata:
     activated: bool = True
     """是否被激活"""
 
-    config: AstrBotConfig = None
+    config: AstrBotConfig | None = None
     """插件配置"""
 
-    star_handler_full_names: List[str] = field(default_factory=list)
+    star_handler_full_names: list[str] = field(default_factory=list)
     """注册的 Handler 的全名列表"""
 
-    supported_platforms: Dict[str, bool] = field(default_factory=dict)
+    supported_platforms: dict[str, bool] = field(default_factory=dict)
     """插件支持的平台ID字典，key为平台ID，value为是否支持"""
 
     def __str__(self) -> str:
diff --git a/astrbot/core/star/star_manager.py b/astrbot/core/star/star_manager.py
index 2b0ed791a..12f91c6d8 100644
--- a/astrbot/core/star/star_manager.py
+++ b/astrbot/core/star/star_manager.py
@@ -11,7 +11,6 @@ import os
 import sys
 import traceback
 from types import ModuleType
-from typing import List
 
 import yaml
 
@@ -157,7 +156,7 @@ class PluginManager:
                     )
         return modules
 
-    def _get_plugin_modules(self) -> List[dict]:
+    def _get_plugin_modules(self) -> list[dict]:
         plugins = []
         if os.path.exists(self.plugin_store_path):
             plugins.extend(self._get_modules(self.plugin_store_path))
@@ -439,7 +438,7 @@ class PluginManager:
                         )
 
                 if path in star_map:
-                    # 通过装饰器的方式注册插件
+                    # 通过__init__subclass__注册插件
                     metadata = star_map[path]
 
                     try:
@@ -453,6 +452,7 @@ class PluginManager:
                             metadata.desc = metadata_yaml.desc
                             metadata.version = metadata_yaml.version
                             metadata.repo = metadata_yaml.repo
+                            star_registry.append(metadata)
                     except Exception:
                         pass
                     metadata.config = plugin_config
diff --git a/packages/astrbot/main.py b/packages/astrbot/main.py
index 0a3f8ba6c..1ec7dc032 100644
--- a/packages/astrbot/main.py
+++ b/packages/astrbot/main.py
@@ -55,12 +55,6 @@ class RstScene(Enum):
         return cls.PRIVATE
 
 
-@star.register(
-    name="astrbot",
-    desc="AstrBot 基础指令结合 + 拓展功能",
-    author="Soulter",
-    version="4.0.0",
-)
 class Main(star.Star):
     def __init__(self, context: star.Context) -> None:
         self.context = context
diff --git a/packages/astrbot/metadata.yaml b/packages/astrbot/metadata.yaml
new file mode 100644
index 000000000..81b1e5c7f
--- /dev/null
+++ b/packages/astrbot/metadata.yaml
@@ -0,0 +1,4 @@
+name: astrbot
+desc: AstrBot 基础指令结合 + 拓展功能
+author: Soulter
+version: 4.0.0
\ No newline at end of file
diff --git a/packages/python_interpreter/main.py b/packages/python_interpreter/main.py
index 84d431b36..411f26aaf 100644
--- a/packages/python_interpreter/main.py
+++ b/packages/python_interpreter/main.py
@@ -94,12 +94,6 @@ DEFAULT_CONFIG = {
 PATH = os.path.join(get_astrbot_data_path(), "config", "python_interpreter.json")
 
 
-@star.register(
-    name="astrbot-python-interpreter",
-    desc="Python 代码执行器",
-    author="Soulter",
-    version="0.0.1",
-)
 class Main(star.Star):
     """基于 Docker 沙箱的 Python 代码执行器"""
 
diff --git a/packages/python_interpreter/metadata.yaml b/packages/python_interpreter/metadata.yaml
new file mode 100644
index 000000000..4378f0ada
--- /dev/null
+++ b/packages/python_interpreter/metadata.yaml
@@ -0,0 +1,4 @@
+name: astrbot-python-interpreter
+desc: Python 代码执行器
+author: Soulter
+version: 0.0.1
\ No newline at end of file
diff --git a/packages/reminder/main.py b/packages/reminder/main.py
index b15add544..a600c20cf 100644
--- a/packages/reminder/main.py
+++ b/packages/reminder/main.py
@@ -11,9 +11,6 @@ from astrbot.api import llm_tool, logger
 from astrbot.core.utils.astrbot_path import get_astrbot_data_path
 
 
-@star.register(
-    name="astrbot-reminder", desc="使用 LLM 待办提醒", author="Soulter", version="0.0.1"
-)
 class Main(star.Star):
     """使用 LLM 待办提醒。只需对 LLM 说想要提醒的事情和时间即可。比如：`之后每天这个时候都提醒我做多邻国`"""
 
diff --git a/packages/reminder/metadata.yaml b/packages/reminder/metadata.yaml
new file mode 100644
index 000000000..fed835682
--- /dev/null
+++ b/packages/reminder/metadata.yaml
@@ -0,0 +1,4 @@
+name: astrbot-reminder
+desc: 使用 LLM 待办提醒
+author: Soulter
+version: 0.0.1
\ No newline at end of file
diff --git a/packages/session_controller/main.py b/packages/session_controller/main.py
index a34635228..131197643 100644
--- a/packages/session_controller/main.py
+++ b/packages/session_controller/main.py
@@ -2,7 +2,7 @@ import astrbot.api.message_components as Comp
 import copy
 from astrbot.api import logger
 from astrbot.api.event import AstrMessageEvent, filter
-from astrbot.api.star import Context, Star, register
+from astrbot.api.star import Context, Star
 from astrbot.core.utils.session_waiter import (
     SessionWaiter,
     USER_SESSIONS,
@@ -13,13 +13,6 @@ from astrbot.core.utils.session_waiter import (
 from sys import maxsize
 
 
-@register(
-    "session_controller",
-    "Cvandia & Soulter",
-    "为插件支持会话控制",
-    "v1.0.1",
-    "https://astrbot.app",
-)
 class Waiter(Star):
     """会话控制"""
 
diff --git a/packages/session_controller/metadata.yaml b/packages/session_controller/metadata.yaml
new file mode 100644
index 000000000..acb3192d6
--- /dev/null
+++ b/packages/session_controller/metadata.yaml
@@ -0,0 +1,5 @@
+name: session_controller
+desc: 为插件支持会话控制
+author: Cvandia & Soulter
+version: v1.0.1
+repo: https://astrbot.app
\ No newline at end of file
diff --git a/packages/thinking_filter/main.py b/packages/thinking_filter/main.py
index 26c2db9b9..612ab57e9 100644
--- a/packages/thinking_filter/main.py
+++ b/packages/thinking_filter/main.py
@@ -1,17 +1,10 @@
 import re
 from astrbot.api.event import filter, AstrMessageEvent
-from astrbot.api.star import Context, Star, register
+from astrbot.api.star import Context, Star
 from astrbot.api.provider import LLMResponse
 from openai.types.chat.chat_completion import ChatCompletion
 
 
-@register(
-    "thinking_filter",
-    "Soulter",
-    "可选择是否过滤推理模型的思考内容",
-    "1.0.0",
-    "https://astrbot.app",
-)
 class R1Filter(Star):
     def __init__(self, context: Context):
         super().__init__(context)
diff --git a/packages/thinking_filter/metadata.yaml b/packages/thinking_filter/metadata.yaml
new file mode 100644
index 000000000..8afbff1e0
--- /dev/null
+++ b/packages/thinking_filter/metadata.yaml
@@ -0,0 +1,5 @@
+name: thinking_filter
+desc: 可选择是否过滤推理模型的思考内容
+author: Soulter
+version: 1.0.0
+repo: https://astrbot.app
\ No newline at end of file
diff --git a/packages/web_searcher/main.py b/packages/web_searcher/main.py
index fa65ce1e5..3556fce92 100644
--- a/packages/web_searcher/main.py
+++ b/packages/web_searcher/main.py
@@ -12,12 +12,6 @@ from bs4 import BeautifulSoup
 from .engines import HEADERS, USER_AGENTS
 
 
-@star.register(
-    name="astrbot-web-searcher",
-    desc="让 LLM 具有网页检索能力",
-    author="Soulter",
-    version="1.14.514",
-)
 class Main(star.Star):
     """使用 /websearch on 或者 off 开启或者关闭网页搜索功能"""
 
diff --git a/packages/web_searcher/metadata.yaml b/packages/web_searcher/metadata.yaml
new file mode 100644
index 000000000..fc5309787
--- /dev/null
+++ b/packages/web_searcher/metadata.yaml
@@ -0,0 +1,4 @@
+name: astrbot-web-searcher
+desc: 让 LLM 具有网页检索能力
+author: Soulter
+version: 1.14.514
\ No newline at end of file