chore: bump version to 4.11.2

* fix:修复waitingllmrequest没有检查消息有效性的问题

* 进行ruff修复

astrbot/cli/__init__.py

@@ -1 +1 @@
-__version__ = "4.11.0"
+__version__ = "4.11.2"

astrbot/core/config/default.py

@@ -5,7 +5,7 @@ from typing import Any, TypedDict
 
 from astrbot.core.utils.astrbot_path import get_astrbot_data_path
 
-VERSION = "4.11.0"
+VERSION = "4.11.2"
 DB_PATH = os.path.join(get_astrbot_data_path(), "data_v4.db")
 
 WEBHOOK_SUPPORTED_PLATFORMS = [
@@ -376,16 +376,6 @@ CONFIG_METADATA_2 = {
                         "satori_heartbeat_interval": 10,
                         "satori_reconnect_delay": 5,
                     },
-                    "WeChatPadPro": {
-                        "id": "wechatpadpro",
-                        "type": "wechatpadpro",
-                        "enable": False,
-                        "admin_key": "stay33",
-                        "host": "这里填写你的局域网IP或者公网服务器IP",
-                        "port": 8059,
-                        "wpp_active_message_poll": False,
-                        "wpp_active_message_poll_interval": 3,
-                    },
                     # "WebChat": {
                     #     "id": "webchat",
                     #     "type": "webchat",

astrbot/core/pipeline/process_stage/method/agent_sub_stages/internal.py

@@ -361,6 +361,14 @@ class InternalAgentSubStage(Stage):
             if (enable_streaming := event.get_extra("enable_streaming")) is not None:
                 streaming_response = bool(enable_streaming)
 
+            # 检查消息内容是否有效，避免空消息触发钩子
+            has_provider_request = event.get_extra("provider_request") is not None
+            has_valid_message = bool(event.message_str and event.message_str.strip())
+
+            if not has_provider_request and not has_valid_message:
+                logger.debug("skip llm request: empty message and no provider_request")
+                return
+
             logger.debug("ready to request llm provider")
 
             # 通知等待调用 LLM（在获取锁之前）
@@ -522,13 +530,15 @@ class InternalAgentSubStage(Stage):
                     ):
                         yield
 
-                await self._save_to_history(
-                    event,
-                    req,
-                    agent_runner.get_final_llm_resp(),
-                    agent_runner.run_context.messages,
-                    agent_runner.stats,
-                )
+                # 检查事件是否被停止，如果被停止则不保存历史记录
+                if not event.is_stopped():
+                    await self._save_to_history(
+                        event,
+                        req,
+                        agent_runner.get_final_llm_resp(),
+                        agent_runner.run_context.messages,
+                        agent_runner.stats,
+                    )
 
             # 异步处理 WebChat 特殊情况
             if event.get_platform_name() == "webchat":

astrbot/core/pipeline/waking_check/stage.py

@@ -22,7 +22,6 @@ UNIQUE_SESSION_ID_BUILDERS: dict[str, Callable[[AstrMessageEvent], str | None]]
     "qq_official_webhook": lambda e: e.get_sender_id(),
     "lark": lambda e: f"{e.get_sender_id()}%{e.get_group_id()}",
     "misskey": lambda e: f"{e.get_session_id()}_{e.get_sender_id()}",
-    "wechatpadpro": lambda e: f"{e.get_group_id()}#{e.get_sender_id()}",
 }
 
 

astrbot/core/platform/manager.py

@@ -70,10 +70,6 @@ class PlatformManager:
                     from .sources.qqofficial_webhook.qo_webhook_adapter import (
                         QQOfficialWebhookPlatformAdapter,  # noqa: F401
                     )
-                case "wechatpadpro":
-                    from .sources.wechatpadpro.wechatpadpro_adapter import (
-                        WeChatPadProAdapter,  # noqa: F401
-                    )
                 case "lark":
                     from .sources.lark.lark_adapter import (
                         LarkPlatformAdapter,  # noqa: F401

astrbot/core/platform/sources/wechatpadpro/wechatpadpro_adapter.py

@@ -1,940 +0,0 @@
-import asyncio
-import base64
-import json
-import os
-import time
-import traceback
-from typing import cast
-
-import aiohttp
-import anyio
-import websockets
-
-from astrbot import logger
-from astrbot.api.message_components import At, Image, Plain, Record
-from astrbot.api.platform import Platform, PlatformMetadata
-from astrbot.core.message.message_event_result import MessageChain
-from astrbot.core.platform.astr_message_event import MessageSesion
-from astrbot.core.platform.astrbot_message import (
-    AstrBotMessage,
-    MessageMember,
-    MessageType,
-)
-from astrbot.core.utils.astrbot_path import get_astrbot_data_path
-
-from ...register import register_platform_adapter
-from .wechatpadpro_message_event import WeChatPadProMessageEvent
-
-try:
-    from .xml_data_parser import GeweDataParser
-except ImportError as e:
-    logger.warning(
-        f"警告: 可能未安装 defusedxml 依赖库，将导致无法解析微信的 表情包、引用 类型的消息: {e!s}",
-    )
-
-
-@register_platform_adapter(
-    "wechatpadpro", "WeChatPadPro 消息平台适配器", support_streaming_message=False
-)
-class WeChatPadProAdapter(Platform):
-    def __init__(
-        self,
-        platform_config: dict,
-        platform_settings: dict,
-        event_queue: asyncio.Queue,
-    ) -> None:
-        super().__init__(platform_config, event_queue)
-        self._shutdown_event = None
-        self.wxnewpass = None
-        self.settings = platform_settings
-
-        self.metadata = PlatformMetadata(
-            name="wechatpadpro",
-            description="WeChatPadPro 消息平台适配器",
-            id=self.config.get("id", "wechatpadpro"),
-            support_streaming_message=False,
-        )
-
-        # 保存配置信息
-        self.admin_key = self.config.get("admin_key")
-        self.host = self.config.get("host")
-        self.port = self.config.get("port")
-        self.active_mesasge_poll: bool = self.config.get(
-            "wpp_active_message_poll",
-            False,
-        )
-        self.active_message_poll_interval: int = self.config.get(
-            "wpp_active_message_poll_interval",
-            5,
-        )
-        self.base_url = f"http://{self.host}:{self.port}"
-        self.auth_key = None  # 用于保存生成的授权码
-        self.wxid: str | None = None  # 用于保存登录成功后的 wxid
-        self.credentials_file = os.path.join(
-            get_astrbot_data_path(),
-            "wechatpadpro_credentials.json",
-        )  # 持久化文件路径
-        self.ws_handle_task = None
-
-        # 添加图片消息缓存，用于引用消息处理
-        self.cached_images = {}
-        """缓存图片消息。key是NewMsgId (对应引用消息的svrid)，value是图片的base64数据"""
-        # 设置缓存大小限制，避免内存占用过大
-        self.max_image_cache = 50
-
-        # 添加文本消息缓存，用于引用消息处理
-        self.cached_texts = {}
-        """缓存文本消息。key是NewMsgId (对应引用消息的svrid)，value是消息文本内容"""
-        # 设置文本缓存大小限制
-        self.max_text_cache = 100
-
-    async def run(self) -> None:
-        """启动平台适配器的运行实例。"""
-        logger.info("WeChatPadPro 适配器正在启动...")
-
-        if loaded_credentials := self.load_credentials():
-            self.auth_key = loaded_credentials.get("auth_key")
-            self.wxid = loaded_credentials.get("wxid")
-
-        isLoginIn = await self.check_online_status()
-
-        # 检查在线状态
-        if self.auth_key and isLoginIn:
-            logger.info("WeChatPadPro 设备已在线，凭据存在，跳过扫码登录。")
-            # 如果在线，连接 WebSocket 接收消息
-            self.ws_handle_task = asyncio.create_task(self.connect_websocket())
-        else:
-            # 1. 生成授权码
-            if not self.auth_key:
-                logger.info("WeChatPadPro 无可用凭据，将生成新的授权码。")
-                await self.generate_auth_key()
-
-            # 2. 获取登录二维码
-            if not isLoginIn:
-                logger.info("WeChatPadPro 设备已离线，开始扫码登录。")
-                qr_code_url = await self.get_login_qr_code()
-
-                if qr_code_url:
-                    logger.info(f"请扫描以下二维码登录: {qr_code_url}")
-                else:
-                    logger.error("无法获取登录二维码。")
-                    return
-
-                # 3. 检测扫码状态
-                login_successful = await self.check_login_status()
-
-                if login_successful:
-                    logger.info("登录成功，WeChatPadPro适配器已连接。")
-                else:
-                    logger.warning("登录失败或超时，WeChatPadPro 适配器将关闭。")
-                    await self.terminate()
-                    return
-
-            # 登录成功后，连接 WebSocket 接收消息
-            self.ws_handle_task = asyncio.create_task(self.connect_websocket())
-
-        self._shutdown_event = asyncio.Event()
-        await self._shutdown_event.wait()
-        logger.info("WeChatPadPro 适配器已停止。")
-
-    def load_credentials(self):
-        """从文件中加载 auth_key 和 wxid。"""
-        if os.path.exists(self.credentials_file):
-            try:
-                with open(self.credentials_file) as f:
-                    credentials = json.load(f)
-                    logger.info("成功加载 WeChatPadPro 凭据。")
-                    return credentials
-            except Exception as e:
-                logger.error(f"加载 WeChatPadPro 凭据失败: {e}")
-        return None
-
-    def save_credentials(self):
-        """将 auth_key 和 wxid 保存到文件。"""
-        credentials = {
-            "auth_key": self.auth_key,
-            "wxid": self.wxid,
-        }
-        try:
-            # 确保数据目录存在
-            data_dir = os.path.dirname(self.credentials_file)
-            os.makedirs(data_dir, exist_ok=True)
-            with open(self.credentials_file, "w") as f:
-                json.dump(credentials, f)
-        except Exception as e:
-            logger.error(f"保存 WeChatPadPro 凭据失败: {e}")
-
-    async def check_online_status(self):
-        """检查 WeChatPadPro 设备是否在线。"""
-        if not self.auth_key:
-            return False
-        url = f"{self.base_url}/login/GetLoginStatus"
-        params = {"key": self.auth_key}
-
-        async with aiohttp.ClientSession() as session:
-            try:
-                async with session.get(url, params=params) as response:
-                    response_data = await response.json()
-                    # 根据提供的在线接口返回示例，成功状态码是 200，loginState 为 1 表示在线
-                    if response.status == 200 and response_data.get("Code") == 200:
-                        login_state = response_data.get("Data", {}).get("loginState")
-                        if login_state == 1:
-                            logger.info("WeChatPadPro 设备当前在线。")
-                            return True
-                        # login_state == 3 为离线状态
-                        if login_state == 3:
-                            logger.info("WeChatPadPro 设备不在线。")
-                            return False
-                        logger.error(f"未知的在线状态: {response_data}")
-                        return False
-                    # Code == 300 为微信退出状态。
-                    if response.status == 200 and response_data.get("Code") == 300:
-                        logger.info("WeChatPadPro 设备已退出。")
-                        return False
-                    if response.status == 200 and response_data.get("Code") == -2:
-                        # 该链接不存在
-                        self.auth_key = None
-                        return False
-                    logger.error(
-                        f"检查在线状态失败: {response.status}, {response_data}",
-                    )
-                    return False
-
-            except aiohttp.ClientConnectorError as e:
-                logger.error(f"连接到 WeChatPadPro 服务失败: {e}")
-                return False
-            except Exception as e:
-                logger.error(f"检查在线状态时发生错误: {e}")
-                logger.error(traceback.format_exc())
-                return False
-
-    def _extract_auth_key(self, data):
-        """Helper method to extract auth_key from response data."""
-        if isinstance(data, dict):
-            auth_keys = data.get("authKeys")  # 新接口
-            if isinstance(auth_keys, list) and auth_keys:
-                return auth_keys[0]
-        elif isinstance(data, list) and data:  # 旧接口
-            return data[0]
-        return None
-
-    async def generate_auth_key(self):
-        """生成授权码。"""
-        url = f"{self.base_url}/admin/GenAuthKey1"
-        params = {"key": self.admin_key}
-        payload = {"Count": 1, "Days": 365}  # 生成一个有效期365天的授权码
-
-        self.auth_key = None  # Reset auth_key before generating a new one
-
-        async with aiohttp.ClientSession() as session:
-            try:
-                async with session.post(url, params=params, json=payload) as response:
-                    if response.status != 200:
-                        logger.error(
-                            f"生成授权码失败: {response.status}, {await response.text()}",
-                        )
-                        return
-
-                    response_data = await response.json()
-                    if response_data.get("Code") == 200:
-                        if data := response_data.get("Data"):
-                            self.auth_key = self._extract_auth_key(data)
-
-                        if self.auth_key:
-                            logger.info("成功获取授权码")
-                        else:
-                            logger.error(
-                                f"生成授权码成功但未找到授权码: {response_data}",
-                            )
-                    else:
-                        logger.error(f"生成授权码失败: {response_data}")
-            except aiohttp.ClientConnectorError as e:
-                logger.error(f"连接到 WeChatPadPro 服务失败: {e}")
-            except Exception as e:
-                logger.error(f"生成授权码时发生错误: {e}")
-
-    async def get_login_qr_code(self):
-        """获取登录二维码地址。"""
-        url = f"{self.base_url}/login/GetLoginQrCodeNew"
-        params = {"key": self.auth_key}
-        payload = {}  # 根据文档，这个接口的 body 可以为空
-
-        async with aiohttp.ClientSession() as session:
-            try:
-                async with session.post(url, params=params, json=payload) as response:
-                    response_data = await response.json()
-                    if response.status == 200 and response_data.get("Code") == 200:
-                        # 二维码地址在 Data.QrCodeUrl 字段中
-                        if response_data.get("Data") and response_data["Data"].get(
-                            "QrCodeUrl",
-                        ):
-                            return response_data["Data"]["QrCodeUrl"]
-                        logger.error(
-                            f"获取登录二维码成功但未找到二维码地址: {response_data}",
-                        )
-                        return None
-                    if "该 key 无效" in response_data.get("Text"):
-                        logger.error(
-                            "授权码无效，已经清除。请重新启动 AstrBot 或者本消息适配器。原因也可能是 WeChatPadPro 的 MySQL 服务没有启动成功，请检查 WeChatPadPro 服务的日志。",
-                        )
-                        self.auth_key = None
-                        self.save_credentials()
-                        return None
-                    logger.error(
-                        f"获取登录二维码失败: {response.status}, {response_data}",
-                    )
-                    return None
-            except aiohttp.ClientConnectorError as e:
-                logger.error(f"连接到 WeChatPadPro 服务失败: {e}")
-                return None
-            except Exception as e:
-                logger.error(f"获取登录二维码时发生错误: {e}")
-                return None
-
-    async def check_login_status(self):
-        """循环检测扫码状态。
-        尝试 6 次后跳出循环，添加倒计时。
-        返回 True 如果登录成功，否则返回 False。
-        """
-        url = f"{self.base_url}/login/CheckLoginStatus"
-        params = {"key": self.auth_key}
-
-        attempts = 0  # 初始化尝试次数
-        max_attempts = 36  # 最大尝试次数
-        countdown = 180  # 倒计时时长
-        logger.info(f"请在 {countdown} 秒内扫码登录。")
-        while attempts < max_attempts:
-            async with aiohttp.ClientSession() as session:
-                try:
-                    async with session.get(url, params=params) as response:
-                        response_data = await response.json()
-                        # 成功判断条件和数据提取路径
-                        if response.status == 200 and response_data.get("Code") == 200:
-                            if (
-                                response_data.get("Data")
-                                and response_data["Data"].get("state") is not None
-                            ):
-                                status = response_data["Data"]["state"]
-                                logger.info(
-                                    f"第 {attempts + 1} 次尝试，当前登录状态: {status}，还剩{countdown - attempts * 5}秒",
-                                )
-                                if status == 2:  # 状态 2 表示登录成功
-                                    self.wxid = response_data["Data"].get("wxid")
-                                    self.wxnewpass = response_data["Data"].get(
-                                        "wxnewpass",
-                                    )
-                                    logger.info(
-                                        f"登录成功，wxid: {self.wxid}, wxnewpass: {self.wxnewpass}",
-                                    )
-                                    self.save_credentials()  # 登录成功后保存凭据
-                                    return True
-                                if status == -2:  # 二维码过期
-                                    logger.error("二维码已过期，请重新获取。")
-                                    return False
-                            else:
-                                logger.error(
-                                    f"检测登录状态成功但未找到登录状态: {response_data}",
-                                )
-                        elif response_data.get("Code") == 300:
-                            # "不存在状态"
-                            pass
-                        else:
-                            logger.info(
-                                f"检测登录状态失败: {response.status}, {response_data}",
-                            )
-
-                except aiohttp.ClientConnectorError as e:
-                    logger.error(f"连接到 WeChatPadPro 服务失败: {e}")
-                    await asyncio.sleep(5)
-                    attempts += 1
-                    continue
-                except Exception as e:
-                    logger.error(f"检测登录状态时发生错误: {e}")
-                    attempts += 1
-                    continue
-
-            attempts += 1
-            await asyncio.sleep(5)  # 每隔5秒检测一次
-        logger.warning("登录检测超过最大尝试次数，退出检测。")
-        return False
-
-    async def connect_websocket(self):
-        """建立 WebSocket 连接并处理接收到的消息。"""
-        os.environ["no_proxy"] = f"localhost,127.0.0.1,{self.host}"
-        ws_url = f"ws://{self.host}:{self.port}/ws/GetSyncMsg?key={self.auth_key}"
-        logger.info(
-            f"正在连接 WebSocket: ws://{self.host}:{self.port}/ws/GetSyncMsg?key=***",
-        )
-        while True:
-            try:
-                async with websockets.connect(ws_url) as websocket:
-                    logger.debug("WebSocket 连接成功。")
-                    # 设置空闲超时重连
-                    wait_time = (
-                        self.active_message_poll_interval
-                        if self.active_mesasge_poll
-                        else 120
-                    )
-                    while True:
-                        try:
-                            message = await asyncio.wait_for(
-                                websocket.recv(),
-                                timeout=wait_time,
-                            )
-                            # logger.debug(message) # 不显示原始消息内容
-                            asyncio.create_task(self.handle_websocket_message(message))
-                        except asyncio.TimeoutError:
-                            logger.debug(f"WebSocket 连接空闲超过 {wait_time} s")
-                            break
-                        except websockets.exceptions.ConnectionClosedOK:
-                            logger.info("WebSocket 连接正常关闭。")
-                            break
-                        except Exception as e:
-                            logger.error(f"处理 WebSocket 消息时发生错误: {e}")
-                            break
-            except Exception as e:
-                logger.error(
-                    f"WebSocket 连接失败: {e}, 请检查WeChatPadPro服务状态，或尝试重启WeChatPadPro适配器。",
-                )
-                await asyncio.sleep(5)
-
-    async def handle_websocket_message(self, message: str | bytes):
-        """处理从 WebSocket 接收到的消息。"""
-        logger.debug(f"收到 WebSocket 消息: {message}")
-        try:
-            message_data = json.loads(message)
-            if (
-                message_data.get("msg_id") is not None
-                and message_data.get("from_user_name") is not None
-            ):
-                abm = await self.convert_message(message_data)
-                if abm:
-                    # 创建 WeChatPadProMessageEvent 实例
-                    message_event = WeChatPadProMessageEvent(
-                        message_str=abm.message_str,
-                        message_obj=abm,
-                        platform_meta=self.meta(),
-                        session_id=abm.session_id,
-                        # 传递适配器实例，以便在事件中调用 send 方法
-                        adapter=self,
-                    )
-                    # 提交事件到事件队列
-                    self.commit_event(message_event)
-            else:
-                logger.warning(f"收到未知结构的 WebSocket 消息: {message_data}")
-
-        except json.JSONDecodeError:
-            logger.error(f"无法解析 WebSocket 消息为 JSON: {message}")
-        except Exception as e:
-            logger.error(f"处理 WebSocket 消息时发生错误: {e}")
-
-    async def convert_message(self, raw_message: dict) -> AstrBotMessage | None:
-        """将 WeChatPadPro 原始消息转换为 AstrBotMessage。"""
-        if self.wxid is None:
-            logger.error("WeChatPadPro 适配器未登录或未获取到 wxid，无法处理消息。")
-            return None
-        abm = AstrBotMessage()
-        abm.raw_message = raw_message
-        abm.message_id = str(raw_message.get("msg_id"))
-        abm.timestamp = cast(int, raw_message.get("create_time"))
-        abm.self_id = self.wxid
-
-        if int(time.time()) - abm.timestamp > 180:
-            logger.warning(
-                f"忽略 3 分钟前的旧消息：消息时间戳 {abm.timestamp} 超过当前时间 {int(time.time())}。",
-            )
-            return None
-
-        from_user_name = raw_message.get("from_user_name", {}).get("str", "")
-        to_user_name = raw_message.get("to_user_name", {}).get("str", "")
-        content = raw_message.get("content", {}).get("str", "")
-        push_content = raw_message.get("push_content", "")
-        msg_type = cast(int, raw_message.get("msg_type"))
-
-        abm.message_str = ""
-        abm.message = []
-
-        # 如果是机器人自己发送的消息、回显消息或系统消息，忽略
-        if from_user_name == self.wxid:
-            logger.info("忽略来自自己的消息。")
-            return None
-
-        if from_user_name in ["weixin", "newsapp", "newsapp_wechat"]:
-            logger.info("忽略来自微信团队的消息。")
-            return None
-
-        # 先判断群聊/私聊并设置基本属性
-        if await self._process_chat_type(
-            abm,
-            raw_message,
-            from_user_name,
-            to_user_name,
-            content,
-            push_content,
-        ):
-            # 再根据消息类型处理消息内容
-            await self._process_message_content(abm, raw_message, msg_type, content)
-
-            return abm
-        return None
-
-    async def _process_chat_type(
-        self,
-        abm: AstrBotMessage,
-        raw_message: dict,
-        from_user_name: str,
-        to_user_name: str,
-        content: str,
-        push_content: str,
-    ):
-        """判断消息是群聊还是私聊，并设置 AstrBotMessage 的基本属性。"""
-        if from_user_name == "weixin":
-            return False
-        at_me = False
-        if "@chatroom" in from_user_name:
-            abm.type = MessageType.GROUP_MESSAGE
-            abm.group_id = from_user_name
-
-            parts = content.split(":\n", 1)
-            sender_wxid = parts[0] if len(parts) == 2 else ""
-            abm.sender = MessageMember(user_id=sender_wxid, nickname="")
-
-            # 获取群聊发送者的nickname
-            if sender_wxid:
-                accurate_nickname = await self._get_group_member_nickname(
-                    abm.group_id,
-                    sender_wxid,
-                )
-                if accurate_nickname:
-                    abm.sender.nickname = accurate_nickname
-
-            if abm.type == MessageType.GROUP_MESSAGE:
-                abm.session_id = abm.group_id
-            else:
-                abm.session_id = abm.sender.user_id
-
-            msg_source = raw_message.get("msg_source", "")
-            if self.wxid in msg_source:
-                at_me = True
-            if "在群聊中@了你" in raw_message.get("push_content", ""):
-                at_me = True
-            if at_me:
-                abm.message.insert(0, At(qq=abm.self_id, name=""))
-        else:
-            abm.type = MessageType.FRIEND_MESSAGE
-            abm.group_id = ""
-            nick_name = ""
-            if push_content and " : " in push_content:
-                nick_name = push_content.split(" : ")[0]
-            abm.sender = MessageMember(user_id=from_user_name, nickname=nick_name)
-            abm.session_id = from_user_name
-        return True
-
-    async def _get_group_member_nickname(
-        self,
-        group_id: str,
-        member_wxid: str,
-    ) -> str | None:
-        """通过接口获取群成员的昵称。"""
-        url = f"{self.base_url}/group/GetChatroomMemberDetail"
-        params = {"key": self.auth_key}
-        payload = {
-            "ChatRoomName": group_id,
-        }
-
-        async with aiohttp.ClientSession() as session:
-            try:
-                async with session.post(url, params=params, json=payload) as response:
-                    response_data = await response.json()
-                    if response.status == 200 and response_data.get("Code") == 200:
-                        # 从返回数据中查找对应成员的昵称
-                        member_list = (
-                            response_data.get("Data", {})
-                            .get("member_data", {})
-                            .get("chatroom_member_list", [])
-                        )
-                        for member in member_list:
-                            if member.get("user_name") == member_wxid:
-                                return member.get("nick_name")
-                        logger.warning(
-                            f"在群 {group_id} 中未找到成员 {member_wxid} 的昵称",
-                        )
-                    else:
-                        logger.error(
-                            f"获取群成员详情失败: {response.status}, {response_data}",
-                        )
-                    return None
-            except aiohttp.ClientConnectorError as e:
-                logger.error(f"连接到 WeChatPadPro 服务失败: {e}")
-                return None
-            except Exception as e:
-                logger.error(f"获取群成员详情时发生错误: {e}")
-                return None
-
-    async def _download_raw_image(
-        self,
-        from_user_name: str,
-        to_user_name: str,
-        msg_id: int,
-    ) -> dict | None:
-        """下载原始图片。"""
-        url = f"{self.base_url}/message/GetMsgBigImg"
-        params = {"key": self.auth_key}
-        payload = {
-            "CompressType": 0,
-            "FromUserName": from_user_name,
-            "MsgId": msg_id,
-            "Section": {"DataLen": 61440, "StartPos": 0},
-            "ToUserName": to_user_name,
-            "TotalLen": 0,
-        }
-        async with aiohttp.ClientSession() as session:
-            try:
-                async with session.post(url, params=params, json=payload) as response:
-                    if response.status == 200:
-                        return await response.json()
-                    logger.error(f"下载图片失败: {response.status}")
-                    return None
-            except aiohttp.ClientConnectorError as e:
-                logger.error(f"连接到 WeChatPadPro 服务失败: {e}")
-                return None
-            except Exception as e:
-                logger.error(f"下载图片时发生错误: {e}")
-                return None
-
-    async def download_voice(
-        self,
-        to_user_name: str,
-        new_msg_id: str,
-        bufid: str,
-        length: int,
-    ):
-        """下载原始音频。"""
-        url = f"{self.base_url}/message/GetMsgVoice"
-        params = {"key": self.auth_key}
-        payload = {
-            "Bufid": bufid,
-            "ToUserName": to_user_name,
-            "NewMsgId": new_msg_id,
-            "Length": length,
-        }
-        async with aiohttp.ClientSession() as session:
-            try:
-                async with session.post(url, params=params, json=payload) as response:
-                    if response.status == 200:
-                        return await response.json()
-                    logger.error(f"下载音频失败: {response.status}")
-                    return None
-            except aiohttp.ClientConnectorError as e:
-                logger.error(f"连接到 WeChatPadPro 服务失败: {e}")
-                return None
-            except Exception as e:
-                logger.error(f"下载音频时发生错误: {e}")
-                return None
-
-    async def _process_message_content(
-        self,
-        abm: AstrBotMessage,
-        raw_message: dict,
-        msg_type: int,
-        content: str,
-    ):
-        """根据消息类型处理消息内容，填充 AstrBotMessage 的 message 列表。"""
-        if msg_type == 1:  # 文本消息
-            abm.message_str = content
-            if abm.type == MessageType.GROUP_MESSAGE:
-                parts = content.split(":\n", 1)
-                if len(parts) == 2:
-                    message_content = parts[1]
-                    abm.message_str = message_content
-
-                    # 检查是否@了机器人，参考 gewechat 的实现方式
-                    # 微信大部分客户端在@用户昵称后面，紧接着是一个\u2005字符（四分之一空格）
-                    at_me = False
-
-                    # 检查 msg_source 中是否包含机器人的 wxid
-                    # wechatpadpro 的格式: <atuserlist>wxid</atuserlist>
-                    # gewechat 的格式: <atuserlist><![CDATA[wxid]]></atuserlist>
-                    msg_source = raw_message.get("msg_source", "")
-                    if (
-                        f"<atuserlist>{abm.self_id}</atuserlist>" in msg_source
-                        or f"<atuserlist>{abm.self_id}," in msg_source
-                        or f",{abm.self_id}</atuserlist>" in msg_source
-                    ):
-                        at_me = True
-
-                    # 也检查 push_content 中是否有@提示
-                    push_content = raw_message.get("push_content", "")
-                    if "在群聊中@了你" in push_content:
-                        at_me = True
-
-                    if at_me:
-                        # 被@了，在消息开头插入At组件（参考gewechat的做法）
-                        bot_nickname = await self._get_group_member_nickname(
-                            abm.group_id,
-                            abm.self_id,
-                        )
-                        abm.message.insert(
-                            0,
-                            At(qq=abm.self_id, name=bot_nickname or abm.self_id),
-                        )
-
-                        # 只有当消息内容不仅仅是@时才添加Plain组件
-                        if "\u2005" in message_content:
-                            # 检查@之后是否还有其他内容
-                            parts = message_content.split("\u2005")
-                            if len(parts) > 1 and any(
-                                part.strip() for part in parts[1:]
-                            ):
-                                abm.message.append(Plain(message_content))
-                        else:
-                            # 检查是否只包含@机器人
-                            is_pure_at = False
-                            if (
-                                bot_nickname
-                                and message_content.strip() == f"@{bot_nickname}"
-                            ):
-                                is_pure_at = True
-                            if not is_pure_at:
-                                abm.message.append(Plain(message_content))
-                    else:
-                        # 没有@机器人，作为普通文本处理
-                        abm.message.append(Plain(message_content))
-                else:
-                    abm.message.append(Plain(abm.message_str))
-            else:  # 私聊消息
-                abm.message.append(Plain(abm.message_str))
-
-            # 缓存文本消息，以便引用消息可以查找
-            try:
-                # 获取msg_id作为缓存的key
-                new_msg_id = raw_message.get("new_msg_id")
-                if new_msg_id:
-                    # 限制缓存大小
-                    if (
-                        len(self.cached_texts) >= self.max_text_cache
-                        and self.cached_texts
-                    ):
-                        # 删除最早的一条缓存
-                        oldest_key = next(iter(self.cached_texts))
-                        self.cached_texts.pop(oldest_key)
-
-                    logger.debug(f"缓存文本消息，new_msg_id={new_msg_id}")
-                    self.cached_texts[str(new_msg_id)] = content
-            except Exception as e:
-                logger.error(f"缓存文本消息失败: {e}")
-        elif msg_type == 3:
-            # 图片消息
-            from_user_name = raw_message.get("from_user_name", {}).get("str", "")
-            to_user_name = raw_message.get("to_user_name", {}).get("str", "")
-            msg_id = cast(int, raw_message.get("msg_id"))
-            image_resp = await self._download_raw_image(
-                from_user_name,
-                to_user_name,
-                msg_id,
-            )
-            if image_resp is None:
-                logger.error(f"下载图片失败: msg_id={msg_id}")
-                return
-            image_bs64_data = (
-                image_resp.get("Data", {}).get("Data", {}).get("Buffer", None)
-            )
-            if image_bs64_data:
-                abm.message.append(Image.fromBase64(image_bs64_data))
-                # 缓存图片，以便引用消息可以查找
-                try:
-                    # 获取msg_id作为缓存的key
-                    new_msg_id = raw_message.get("new_msg_id")
-                    if new_msg_id:
-                        # 限制缓存大小
-                        if (
-                            len(self.cached_images) >= self.max_image_cache
-                            and self.cached_images
-                        ):
-                            # 删除最早的一条缓存
-                            oldest_key = next(iter(self.cached_images))
-                            self.cached_images.pop(oldest_key)
-
-                        logger.debug(f"缓存图片消息，new_msg_id={new_msg_id}")
-                        self.cached_images[str(new_msg_id)] = image_bs64_data
-                except Exception as e:
-                    logger.error(f"缓存图片消息失败: {e}")
-        elif msg_type == 47:
-            # 视频消息 (注意：表情消息也是 47，需要区分)
-            data_parser = GeweDataParser(
-                content=content,
-                is_private_chat=(abm.type != MessageType.GROUP_MESSAGE),
-                raw_message=raw_message,
-            )
-            emoji_message = data_parser.parse_emoji()
-            if emoji_message is not None:
-                abm.message.append(emoji_message)
-        elif msg_type == 50:
-            logger.warning("收到语音/视频消息，待实现。")
-        elif msg_type == 34:
-            # 语音消息
-            bufid = 0
-            to_user_name = raw_message.get("to_user_name", {}).get("str", "")
-            new_msg_id = raw_message.get("new_msg_id")
-            if new_msg_id is None:
-                logger.error("语音消息缺少 new_msg_id")
-                return
-            data_parser = GeweDataParser(
-                content=content,
-                is_private_chat=(abm.type != MessageType.GROUP_MESSAGE),
-                raw_message=raw_message,
-            )
-
-            voicemsg = data_parser._format_to_xml().find("voicemsg")
-            if voicemsg is None:
-                logger.error("无法从 XML 解析 voicemsg 节点")
-                return
-            bufid = voicemsg.get("bufid") or "0"
-            length = int(voicemsg.get("length") or 0)
-            voice_resp = await self.download_voice(
-                to_user_name=to_user_name,
-                new_msg_id=new_msg_id,
-                bufid=bufid,
-                length=length,
-            )
-            if voice_resp is None:
-                logger.error(f"下载语音失败: new_msg_id={new_msg_id}")
-                return
-            voice_bs64_data = voice_resp.get("Data", {}).get("Base64", None)
-            if voice_bs64_data:
-                voice_bs64_data = base64.b64decode(voice_bs64_data)
-                temp_dir = os.path.join(get_astrbot_data_path(), "temp")
-                file_path = os.path.join(
-                    temp_dir,
-                    f"wechatpadpro_voice_{abm.message_id}.silk",
-                )
-
-                async with await anyio.open_file(file_path, "wb") as f:
-                    await f.write(voice_bs64_data)
-                abm.message.append(Record(file=file_path, url=file_path))
-        elif msg_type == 49:
-            try:
-                parser = GeweDataParser(
-                    content=content,
-                    is_private_chat=(abm.type != MessageType.GROUP_MESSAGE),
-                    cached_texts=self.cached_texts,
-                    cached_images=self.cached_images,
-                    raw_message=raw_message,
-                    downloader=self._download_raw_image,
-                )
-                components = await parser.parse_mutil_49()
-                if components:
-                    abm.message.extend(components)
-                    abm.message_str = "\n".join(
-                        c.text for c in components if isinstance(c, Plain)
-                    )
-            except Exception as e:
-                logger.warning(f"msg_type 49 处理失败: {e}")
-                abm.message.append(Plain("[XML 消息处理失败]"))
-                abm.message_str = "[XML 消息处理失败]"
-        else:
-            logger.warning(f"收到未处理的消息类型: {msg_type}。")
-
-    async def terminate(self):
-        """终止一个平台的运行实例。"""
-        logger.info("终止 WeChatPadPro 适配器。")
-        try:
-            if self.ws_handle_task:
-                self.ws_handle_task.cancel()
-            if self._shutdown_event is not None:
-                self._shutdown_event.set()
-        except Exception:
-            pass
-
-    def meta(self) -> PlatformMetadata:
-        """得到一个平台的元数据。"""
-        return self.metadata
-
-    async def send_by_session(
-        self,
-        session: MessageSesion,
-        message_chain: MessageChain,
-    ):
-        dummy_message_obj = AstrBotMessage()
-        dummy_message_obj.session_id = session.session_id
-        # 根据 session_id 判断消息类型
-        if "@chatroom" in session.session_id:
-            dummy_message_obj.type = MessageType.GROUP_MESSAGE
-            if "#" in session.session_id:
-                dummy_message_obj.group_id = session.session_id.split("#")[0]
-            else:
-                dummy_message_obj.group_id = session.session_id
-            dummy_message_obj.sender = MessageMember(user_id="", nickname="")
-        else:
-            dummy_message_obj.type = MessageType.FRIEND_MESSAGE
-            dummy_message_obj.group_id = ""
-            dummy_message_obj.sender = MessageMember(user_id="", nickname="")
-        sending_event = WeChatPadProMessageEvent(
-            message_str="",
-            message_obj=dummy_message_obj,
-            platform_meta=self.meta(),
-            session_id=session.session_id,
-            adapter=self,
-        )
-        # 调用实例方法 send
-        await sending_event.send(message_chain)
-
-    async def get_contact_list(self):
-        """获取联系人列表。"""
-        url = f"{self.base_url}/friend/GetContactList"
-        params = {"key": self.auth_key}
-        payload = {"CurrentChatRoomContactSeq": 0, "CurrentWxcontactSeq": 0}
-        async with aiohttp.ClientSession() as session:
-            try:
-                async with session.post(url, params=params, json=payload) as response:
-                    if response.status != 200:
-                        logger.error(f"获取联系人列表失败: {response.status}")
-                        return None
-                    result = await response.json()
-                    if result.get("Code") == 200 and result.get("Data"):
-                        contact_list = (
-                            result.get("Data", {})
-                            .get("ContactList", {})
-                            .get("contactUsernameList", [])
-                        )
-                        return contact_list
-                    logger.error(f"获取联系人列表失败: {result}")
-                    return None
-            except aiohttp.ClientConnectorError as e:
-                logger.error(f"连接到 WeChatPadPro 服务失败: {e}")
-                return None
-            except Exception as e:
-                logger.error(f"获取联系人列表时发生错误: {e}")
-                return None
-
-    async def get_contact_details_list(
-        self,
-        room_wx_id_list: list[str] | None = None,
-        user_names: list[str] | None = None,
-    ) -> dict | None:
-        """获取联系人详情列表。"""
-        if room_wx_id_list is None:
-            room_wx_id_list = []
-        if user_names is None:
-            user_names = []
-        url = f"{self.base_url}/friend/GetContactDetailsList"
-        params = {"key": self.auth_key}
-        payload = {"RoomWxIDList": room_wx_id_list, "UserNames": user_names}
-        async with aiohttp.ClientSession() as session:
-            try:
-                async with session.post(url, params=params, json=payload) as response:
-                    if response.status != 200:
-                        logger.error(f"获取联系人详情列表失败: {response.status}")
-                        return None
-                    result = await response.json()
-                    if result.get("Code") == 200 and result.get("Data"):
-                        contact_list = result.get("Data", {}).get("contactList", {})
-                        return contact_list
-                    logger.error(f"获取联系人详情列表失败: {result}")
-                    return None
-            except aiohttp.ClientConnectorError as e:
-                logger.error(f"连接到 WeChatPadPro 服务失败: {e}")
-                return None
-            except Exception as e:
-                logger.error(f"获取联系人详情列表时发生错误: {e}")
-                return None

astrbot/core/platform/sources/wechatpadpro/wechatpadpro_message_event.py

@@ -1,178 +0,0 @@
-import asyncio
-import base64
-import io
-from collections.abc import AsyncGenerator
-from typing import TYPE_CHECKING
-
-import aiohttp
-from PIL import Image as PILImage  # 使用别名避免冲突
-
-from astrbot import logger
-from astrbot.core.message.components import (
-    Image,
-    Plain,
-    Record,
-    WechatEmoji,
-)  # Import Image
-from astrbot.core.message.message_event_result import MessageChain
-from astrbot.core.platform.astr_message_event import AstrMessageEvent
-from astrbot.core.platform.astrbot_message import AstrBotMessage, MessageType
-from astrbot.core.platform.platform_metadata import PlatformMetadata
-from astrbot.core.utils.tencent_record_helper import audio_to_tencent_silk_base64
-
-if TYPE_CHECKING:
-    from .wechatpadpro_adapter import WeChatPadProAdapter
-
-
-class WeChatPadProMessageEvent(AstrMessageEvent):
-    def __init__(
-        self,
-        message_str: str,
-        message_obj: AstrBotMessage,
-        platform_meta: PlatformMetadata,
-        session_id: str,
-        adapter: "WeChatPadProAdapter",  # 传递适配器实例
-    ):
-        super().__init__(message_str, message_obj, platform_meta, session_id)
-        self.message_obj = message_obj  # Save the full message object
-        self.adapter = adapter  # Save the adapter instance
-
-    async def send(self, message: MessageChain):
-        async with aiohttp.ClientSession() as session:
-            for comp in message.chain:
-                await asyncio.sleep(1)
-                if isinstance(comp, Plain):
-                    await self._send_text(session, comp.text)
-                elif isinstance(comp, Image):
-                    await self._send_image(session, comp)
-                elif isinstance(comp, WechatEmoji):
-                    await self._send_emoji(session, comp)
-                elif isinstance(comp, Record):
-                    await self._send_voice(session, comp)
-        await super().send(message)
-
-    async def send_streaming(
-        self, generator: AsyncGenerator[MessageChain, None], use_fallback: bool = False
-    ):
-        buffer = None
-        async for chain in generator:
-            if not buffer:
-                buffer = chain
-            else:
-                buffer.chain.extend(chain.chain)
-        if not buffer:
-            return None
-        buffer.squash_plain()
-        await self.send(buffer)
-        return await super().send_streaming(generator, use_fallback)
-
-    async def _send_image(self, session: aiohttp.ClientSession, comp: Image):
-        b64 = await comp.convert_to_base64()
-        raw = self._validate_base64(b64)
-        b64c = self._compress_image(raw)
-        payload = {
-            "MsgItem": [
-                {"ImageContent": b64c, "MsgType": 3, "ToUserName": self.session_id},
-            ],
-        }
-        url = f"{self.adapter.base_url}/message/SendImageNewMessage"
-        await self._post(session, url, payload)
-
-    async def _send_text(self, session: aiohttp.ClientSession, text: str):
-        if (
-            self.message_obj.type == MessageType.GROUP_MESSAGE  # 确保是群聊消息
-            and self.adapter.settings.get(
-                "reply_with_mention",
-                False,
-            )  # 检查适配器设置是否启用 reply_with_mention
-            and self.message_obj.sender  # 确保有发送者信息
-            and (
-                self.message_obj.sender.user_id or self.message_obj.sender.nickname
-            )  # 确保发送者有 ID 或昵称
-        ):
-            # 优先使用 nickname，如果没有则使用 user_id
-            mention_text = (
-                self.message_obj.sender.nickname or self.message_obj.sender.user_id
-            )
-            message_text = f"@{mention_text} {text}"
-            # logger.info(f"已添加 @ 信息: {message_text}")
-        else:
-            message_text = text
-        if self.get_group_id() and "#" in self.session_id:
-            session_id = self.session_id.split("#")[0]
-        else:
-            session_id = self.session_id
-        payload = {
-            "MsgItem": [
-                {
-                    "MsgType": 1,
-                    "TextContent": message_text,
-                    "ToUserName": session_id,
-                },
-            ],
-        }
-        url = f"{self.adapter.base_url}/message/SendTextMessage"
-        await self._post(session, url, payload)
-
-    async def _send_emoji(self, session: aiohttp.ClientSession, comp: WechatEmoji):
-        payload = {
-            "EmojiList": [
-                {
-                    "EmojiMd5": comp.md5,
-                    "EmojiSize": comp.md5_len,
-                    "ToUserName": self.session_id,
-                },
-            ],
-        }
-        url = f"{self.adapter.base_url}/message/SendEmojiMessage"
-        await self._post(session, url, payload)
-
-    async def _send_voice(self, session: aiohttp.ClientSession, comp: Record):
-        record_path = await comp.convert_to_file_path()
-        # 默认已经存在 data/temp 中
-        b64, duration = await audio_to_tencent_silk_base64(record_path)
-        payload = {
-            "ToUserName": self.session_id,
-            "VoiceData": b64,
-            "VoiceFormat": 4,
-            "VoiceSecond": duration,
-        }
-        url = f"{self.adapter.base_url}/message/SendVoice"
-        await self._post(session, url, payload)
-
-    @staticmethod
-    def _validate_base64(b64: str) -> bytes:
-        return base64.b64decode(b64, validate=True)
-
-    @staticmethod
-    def _compress_image(data: bytes) -> str:
-        img = PILImage.open(io.BytesIO(data))
-        buf = io.BytesIO()
-        if img.format == "JPEG":
-            img.save(buf, "JPEG", quality=80)
-        else:
-            if img.mode in ("RGBA", "P"):
-                img = img.convert("RGB")
-            img.save(buf, "JPEG", quality=80)
-        # logger.info("图片处理完成！！！")
-        return base64.b64encode(buf.getvalue()).decode()
-
-    async def _post(self, session, url, payload):
-        params = {"key": self.adapter.auth_key}
-        try:
-            async with session.post(url, params=params, json=payload) as resp:
-                data = await resp.json()
-                if resp.status != 200 or data.get("Code") != 200:
-                    logger.error(f"{url} failed: {resp.status} {data}")
-        except Exception as e:
-            logger.error(f"{url} error: {e}")
-
-
-# TODO: 添加对其他消息组件类型的处理 (Record, Video, At等)
-# elif isinstance(component, Record):
-#     pass
-# elif isinstance(component, Video):
-#     pass
-# elif isinstance(component, At):
-#     pass
-# ...

astrbot/core/platform/sources/wechatpadpro/xml_data_parser.py

@@ -1,159 +0,0 @@
-from defusedxml import ElementTree as eT
-
-from astrbot.api import logger
-from astrbot.api.message_components import (
-    BaseMessageComponent,
-    Image,
-    Plain,
-)
-from astrbot.api.message_components import (
-    WechatEmoji as Emoji,
-)
-
-
-class GeweDataParser:
-    def __init__(
-        self,
-        content: str,
-        is_private_chat: bool = False,
-        cached_texts=None,
-        cached_images=None,
-        raw_message: dict | None = None,
-        downloader=None,
-    ):
-        self._xml = None
-        self.content = content
-        self.is_private_chat = is_private_chat
-        self.cached_texts = cached_texts or {}
-        self.cached_images = cached_images or {}
-        self.downloader = downloader
-
-        raw_message = raw_message or {}
-        self.from_user_name = raw_message.get("from_user_name", {}).get("str", "")
-        self.to_user_name = raw_message.get("to_user_name", {}).get("str", "")
-        self.msg_id = raw_message.get("msg_id", "")
-
-    def _format_to_xml(self):
-        if self._xml:
-            return self._xml
-
-        try:
-            msg_str = self.content
-            if not self.is_private_chat:
-                parts = self.content.split(":\n", 1)
-                msg_str = parts[1] if len(parts) == 2 else self.content
-
-            self._xml = eT.fromstring(msg_str)
-            return self._xml
-        except Exception as e:
-            logger.error(f"[XML解析失败] {e}")
-            raise
-
-    async def parse_mutil_49(self) -> list[BaseMessageComponent] | None:
-        """处理 msg_type == 49 的多种 appmsg 类型（目前支持 type==57）"""
-        try:
-            appmsg_type = self._format_to_xml().findtext(".//appmsg/type")
-            if appmsg_type == "57":
-                return await self.parse_reply()
-        except Exception as e:
-            logger.warning(f"[parse_mutil_49] 解析失败: {e}")
-        return None
-
-    async def parse_reply(self) -> list[BaseMessageComponent]:
-        """处理 type == 57 的引用消息：支持文本（1）、图片（3）、嵌套49（49）"""
-        components = []
-
-        try:
-            appmsg = self._format_to_xml().find("appmsg")
-            if appmsg is None:
-                return [Plain("[引用消息解析失败]")]
-
-            refermsg = appmsg.find("refermsg")
-            if refermsg is None:
-                return [Plain("[引用消息解析失败]")]
-
-            quote_type = int(refermsg.findtext("type", "0"))
-            nickname = refermsg.findtext("displayname", "未知发送者")
-            quote_content = refermsg.findtext("content", "")
-            svrid = refermsg.findtext("svrid")
-
-            match quote_type:
-                case 1:  # 文本引用
-                    quoted_text = self.cached_texts.get(str(svrid), quote_content)
-                    components.append(Plain(f"[引用] {nickname}: {quoted_text}"))
-
-                case 3:  # 图片引用
-                    quoted_image_b64 = self.cached_images.get(str(svrid))
-                    if not quoted_image_b64:
-                        try:
-                            quote_xml = eT.fromstring(quote_content)
-                            img = quote_xml.find("img")
-                            cdn_url = (
-                                img.get("cdnbigimgurl") or img.get("cdnmidimgurl")
-                                if img is not None
-                                else None
-                            )
-                            if cdn_url and self.downloader:
-                                image_resp = await self.downloader(
-                                    self.from_user_name,
-                                    self.to_user_name,
-                                    self.msg_id,
-                                )
-                                quoted_image_b64 = (
-                                    image_resp.get("Data", {})
-                                    .get("Data", {})
-                                    .get("Buffer")
-                                )
-                        except Exception as e:
-                            logger.warning(f"[引用图片解析失败] svrid={svrid} err={e}")
-
-                    if quoted_image_b64:
-                        components.extend(
-                            [
-                                Image.fromBase64(quoted_image_b64),
-                                Plain(f"[引用] {nickname}: [引用的图片]"),
-                            ],
-                        )
-                    else:
-                        components.append(
-                            Plain(f"[引用] {nickname}: [引用的图片 - 未能获取]"),
-                        )
-
-                case 49:  # 嵌套引用
-                    try:
-                        nested_root = eT.fromstring(quote_content)
-                        nested_title = nested_root.findtext(".//appmsg/title", "")
-                        components.append(Plain(f"[引用] {nickname}: {nested_title}"))
-                    except Exception as e:
-                        logger.warning(f"[嵌套引用解析失败] err={e}")
-                        components.append(Plain(f"[引用] {nickname}: [嵌套引用消息]"))
-
-                case _:  # 其他未识别类型
-                    logger.info(f"[未知引用类型] quote_type={quote_type}")
-                    components.append(Plain(f"[引用] {nickname}: [不支持的引用类型]"))
-
-            # 主消息标题
-            title = appmsg.findtext("title", "")
-            if title:
-                components.append(Plain(title))
-
-        except Exception as e:
-            logger.error(f"[parse_reply] 总体解析失败: {e}")
-            return [Plain("[引用消息解析失败]")]
-
-        return components
-
-    def parse_emoji(self) -> Emoji | None:
-        """处理 msg_type == 47 的表情消息（emoji）"""
-        try:
-            emoji_element = self._format_to_xml().find(".//emoji")
-            if emoji_element is not None:
-                return Emoji(
-                    md5=emoji_element.get("md5"),
-                    md5_len=emoji_element.get("len"),
-                    cdnurl=emoji_element.get("cdnurl"),
-                )
-        except Exception as e:
-            logger.error(f"[parse_emoji] 解析失败: {e}")
-
-        return None

astrbot/core/provider/entities.py

@@ -344,6 +344,11 @@ class LLMResponse:
         self.raw_completion = raw_completion
         self.is_chunk = is_chunk
 
+        if id is not None:
+            self.id = id
+        if usage is not None:
+            self.usage = usage
+
     @property
     def completion_text(self):
         if self.result_chain:

astrbot/core/star/filter/platform_adapter_type.py

@@ -12,7 +12,6 @@ class PlatformAdapterType(enum.Flag):
     TELEGRAM = enum.auto()
     WECOM = enum.auto()
     LARK = enum.auto()
-    WECHATPADPRO = enum.auto()
     DINGTALK = enum.auto()
     DISCORD = enum.auto()
     SLACK = enum.auto()
@@ -27,7 +26,6 @@ class PlatformAdapterType(enum.Flag):
         | TELEGRAM
         | WECOM
         | LARK
-        | WECHATPADPRO
         | DINGTALK
         | DISCORD
         | SLACK
@@ -49,7 +47,6 @@ ADAPTER_NAME_2_TYPE = {
     "discord": PlatformAdapterType.DISCORD,
     "slack": PlatformAdapterType.SLACK,
     "kook": PlatformAdapterType.KOOK,
-    "wechatpadpro": PlatformAdapterType.WECHATPADPRO,
     "vocechat": PlatformAdapterType.VOCECHAT,
     "weixin_official_account": PlatformAdapterType.WEIXIN_OFFICIAL_ACCOUNT,
     "satori": PlatformAdapterType.SATORI,

astrbot/core/star/star_manager.py

@@ -22,6 +22,7 @@ from astrbot.core.utils.astrbot_path import (
     get_astrbot_plugin_path,
 )
 from astrbot.core.utils.io import remove_dir
+from astrbot.core.utils.metrics import Metric
 
 from . import StarMetadata
 from .command_management import sync_command_configs
@@ -656,6 +657,14 @@ class PluginManager:
                 如果找不到插件元数据则返回 None。
 
         """
+        # this metric is for displaying plugins installation count in webui
+        asyncio.create_task(
+            Metric.upload(
+                et="install_star",
+                repo=repo_url,
+            ),
+        )
+
         async with self._pm_lock:
             plugin_path = await self.updator.install(repo_url, proxy)
             # reload the plugin
@@ -1025,4 +1034,12 @@ class PluginManager:
                 "name": plugin.name,
             }
 
+            if plugin.repo:
+                asyncio.create_task(
+                    Metric.upload(
+                        et="install_star_f",  # install star
+                        repo=plugin.repo,
+                    ),
+                )
+
         return plugin_info

astrbot/dashboard/routes/backup.py

@@ -993,6 +993,7 @@ class BackupRoute(Route):
                 file_path,
                 as_attachment=True,
                 attachment_filename=filename,
+                conditional=True,  # 启用 Range 请求支持（断点续传）
             )
         except Exception as e:
             logger.error(f"下载备份失败: {e}")

astrbot/dashboard/routes/config.py

@@ -625,7 +625,7 @@ class ConfigRoute(Route):
         provider_list = []
         ps = self.core_lifecycle.provider_manager.providers_config
         p_source_pt = {
-            psrc["id"]: psrc["provider_type"]
+            psrc["id"]: psrc.get("provider_type", "chat_completion")
             for psrc in self.core_lifecycle.provider_manager.provider_sources_config
         }
         for provider in ps:
@@ -640,7 +640,7 @@ class ConfigRoute(Route):
                     provider
                 )
                 provider_list.append(prov)
-            elif not ps_id and provider.get("provider_type", None) in provider_type_ls:
+            elif not ps_id and provider.get("provider_type", "") in provider_type_ls:
                 # agent runner, embedding, etc
                 provider_list.append(provider)
         return Response().ok(provider_list).__dict__

astrbot/dashboard/routes/plugin.py

@@ -55,6 +55,7 @@ class PluginRoute(Route):
             "/plugin/on": ("POST", self.on_plugin),
             "/plugin/reload": ("POST", self.reload_plugins),
             "/plugin/readme": ("GET", self.get_plugin_readme),
+            "/plugin/changelog": ("GET", self.get_plugin_changelog),
             "/plugin/source/get": ("GET", self.get_custom_source),
             "/plugin/source/save": ("POST", self.save_custom_source),
         }
@@ -615,6 +616,55 @@ class PluginRoute(Route):
             logger.error(f"/api/plugin/readme: {traceback.format_exc()}")
             return Response().error(f"读取README文件失败: {e!s}").__dict__
 
+    async def get_plugin_changelog(self):
+        """获取插件更新日志
+
+        读取插件目录下的 CHANGELOG.md 文件内容。
+        """
+        plugin_name = request.args.get("name")
+        logger.debug(f"正在获取插件 {plugin_name} 的更新日志")
+
+        if not plugin_name:
+            return Response().error("插件名称不能为空").__dict__
+
+        # 查找插件
+        plugin_obj = None
+        for plugin in self.plugin_manager.context.get_all_stars():
+            if plugin.name == plugin_name:
+                plugin_obj = plugin
+                break
+
+        if not plugin_obj:
+            return Response().error(f"插件 {plugin_name} 不存在").__dict__
+
+        if not plugin_obj.root_dir_name:
+            return Response().error(f"插件 {plugin_name} 目录不存在").__dict__
+
+        plugin_dir = os.path.join(
+            self.plugin_manager.plugin_store_path,
+            plugin_obj.root_dir_name,
+        )
+
+        # 尝试多种可能的文件名
+        changelog_names = ["CHANGELOG.md", "changelog.md", "CHANGELOG", "changelog"]
+        for name in changelog_names:
+            changelog_path = os.path.join(plugin_dir, name)
+            if os.path.isfile(changelog_path):
+                try:
+                    with open(changelog_path, encoding="utf-8") as f:
+                        changelog_content = f.read()
+                    return (
+                        Response()
+                        .ok({"content": changelog_content}, "成功获取更新日志")
+                        .__dict__
+                    )
+                except Exception as e:
+                    logger.error(f"/api/plugin/changelog: {traceback.format_exc()}")
+                    return Response().error(f"读取更新日志失败: {e!s}").__dict__
+
+        # 没有找到 changelog 文件，返回 ok 但 content 为 null
+        return Response().ok({"content": None}, "该插件没有更新日志文件").__dict__
+
     async def get_custom_source(self):
         """获取自定义插件源"""
         sources = await sp.global_get("custom_plugin_sources", [])

changelogs/v4.11.1.md

@@ -0,0 +1,26 @@
+## What's Changed
+
+hotfix of v4.11.0
+
+修复：
+
+1. 修复: 部分情况下选择提供商的时候出现”暂无可用提供商的问题“，即使实际上配置了模型（提供商）。
+2. 优化：提供商源 ID、提供商 ID 和模型 ID 的提示信息，帮助用户更好理解各个 ID 的含义。
+
+### 新增
+
+- 支持上下文自动压缩功能。入口：配置文件 -> 上下文管理策略 -> 超出模型上下文窗口时的处理方式。详情请查看： [自动上下文压缩](https://docs.astrbot.app/use/context-compress.html) ([#4322](https://github.com/AstrBotDevs/AstrBot/issues/4322))
+- 新增 `on_waiting_llm_request` 事件钩子 ([#4319](https://github.com/AstrBotDevs/AstrBot/issues/4319))
+- WebUI 支持强制更新插件 ([#4293](https://github.com/AstrBotDevs/AstrBot/issues/4293))
+- 社区已提供适用于 [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter) 平台的适配器插件
+
+### 修复
+
+- 修复微信公众号中由于 msg.id 数据类型不匹配导致的重试失败问题 ([#4292](https://github.com/AstrBotDevs/AstrBot/issues/4292))
+- 修复调用 TTS 命令时出现的数据库锁定错误 ([#4313](https://github.com/AstrBotDevs/AstrBot/issues/4313))
+- 修复 Anthropic 提供商中 token 用量始终为 0 的问题 ([#4328](https://github.com/AstrBotDevs/AstrBot/issues/4328))
+
+### 优化
+
+- 完善共享组件的国际化支持 ([#4327](https://github.com/AstrBotDevs/AstrBot/issues/4327))
+- 优化下载大型备份文件时的稳定性，减少失败情况 ([#4329](https://github.com/AstrBotDevs/AstrBot/issues/4329))

changelogs/v4.11.2.md

@@ -0,0 +1,15 @@
+## What's Changed
+
+### Features
+
+- feat: supports to display plugin CHANGELOG.md ([#4337](https://github.com/AstrBotDevs/AstrBot/issues/4337))
+
+### Fixes
+
+- fix: conversation was still saved to the context after `stop_event` ([#4345](https://github.com/AstrBotDevs/AstrBot/issues/4345))
+- fix: on_waiting_llm_request hook did not check message validity ([#4349](https://github.com/AstrBotDevs/AstrBot/issues/4349))
+fix(webui): maintain international consistency of the 'repo' button ([#4358](https://github.com/AstrBotDevs/AstrBot/issues/4358))
+
+### Improvements
+
+- plugin marketplace search supports matching display names. ([#4332](https://github.com/AstrBotDevs/AstrBot/issues/4332))

dashboard/src/components/provider/ProviderModelsPanel.vue

@@ -44,14 +44,16 @@
     >
       <template v-if="entries.length > 0">
         <template v-for="entry in entries" :key="entry.type === 'configured' ? `provider-${entry.provider.id}` : `model-${entry.model}`">
-          <v-list-item
-            v-if="entry.type === 'configured'"
-            class="provider-compact-item"
-            @click="emit('open-provider-edit', entry.provider)"
-          >
-            <v-list-item-title class="font-weight-medium text-truncate">
-              {{ entry.provider.id }}
-            </v-list-item-title>
+          <v-tooltip location="top" max-width="400" v-if="entry.type === 'configured'">
+            <template #activator="{ props }">
+              <v-list-item
+                v-bind="props"
+                class="provider-compact-item"
+                @click="emit('open-provider-edit', entry.provider)"
+              >
+                <v-list-item-title class="font-weight-medium text-truncate">
+                  {{ entry.provider.id }}
+                </v-list-item-title>
             <v-list-item-subtitle class="text-caption text-grey d-flex align-center ga-1" style="font-family: monospace;">
               <span>{{ entry.provider.model }}</span>
               <v-icon v-if="supportsImageInput(entry.metadata)" size="14" color="grey">
@@ -109,10 +111,18 @@
                 <v-btn icon="mdi-delete" size="small" variant="text" color="error" @click.stop="emit('delete-provider', entry.provider)"></v-btn>
               </div>
             </template>
-          </v-list-item>
+              </v-list-item>
+            </template>
+            <div>
+              <div><strong>{{ tm('models.tooltips.providerId') }}:</strong> {{ entry.provider.id }}</div>
+              <div><strong>{{ tm('models.tooltips.modelId') }}:</strong> {{ entry.provider.model }}</div>
+            </div>
+          </v-tooltip>
 
-          <v-list-item v-else class="cursor-pointer" @click="emit('add-model-provider', entry.model)">
-            <v-list-item-title>{{ entry.model }}</v-list-item-title>
+          <v-tooltip location="top" max-width="400" v-else>
+            <template #activator="{ props }">
+              <v-list-item v-bind="props" class="cursor-pointer" @click="emit('add-model-provider', entry.model)">
+                <v-list-item-title>{{ entry.model }}</v-list-item-title>
             <v-list-item-subtitle class="text-caption text-grey d-flex align-center ga-1">
               <span>{{ entry.model }}</span>
               <v-icon v-if="supportsImageInput(entry.metadata)" size="14" color="grey">
@@ -128,10 +138,15 @@
                 {{ formatContextLimit(entry.metadata) }}
               </span>
             </v-list-item-subtitle>
-            <template #append>
-              <v-btn icon="mdi-plus" size="small" variant="text" color="primary"></v-btn>
+                <template #append>
+                  <v-btn icon="mdi-plus" size="small" variant="text" color="primary"></v-btn>
+                </template>
+              </v-list-item>
             </template>
-          </v-list-item>
+            <div>
+              <div><strong>{{ tm('models.tooltips.modelId') }}:</strong> {{ entry.model }}</div>
+            </div>
+          </v-tooltip>
         </template>
       </template>
       <template v-else>

dashboard/src/components/shared/AstrBotConfigV4.vue

@@ -233,12 +233,12 @@ function getSpecialSubtype(value) {
               <div v-if="createSelectorModel(itemKey).value && createSelectorModel(itemKey).value.length > 0"
                 class="selected-plugins-full-width">
                 <div class="plugins-header">
-                  <small class="text-grey">已选择的插件：</small>
+                  <small class="text-grey">{{ t('core.shared.pluginSetSelector.selectedPluginsLabel') }}</small>
                 </div>
                 <div class="d-flex flex-wrap ga-2 mt-2">
                   <v-chip v-for="plugin in (createSelectorModel(itemKey).value || [])" :key="plugin" size="small" label
                     color="primary" variant="outlined">
-                    {{ plugin === '*' ? '所有插件' : plugin }}
+                    {{ plugin === '*' ? t('core.shared.pluginSetSelector.allPluginsLabel') : plugin }}
                   </v-chip>
                 </div>
               </div>

dashboard/src/components/shared/ConfigItemRenderer.vue

@@ -20,13 +20,13 @@
     </template>
     <template v-else-if="itemMeta?._special === 'provider_pool'">
       <ProviderSelector :model-value="modelValue" @update:model-value="emitUpdate" :provider-type="'chat_completion'"
-        button-text="选择提供商池..." />
+        :button-text="t('core.shared.providerSelector.selectProviderPool')" />
     </template>
     <template v-else-if="itemMeta?._special === 'select_persona'">
       <PersonaSelector :model-value="modelValue" @update:model-value="emitUpdate" />
     </template>
     <template v-else-if="itemMeta?._special === 'persona_pool'">
-      <PersonaSelector :model-value="modelValue" @update:model-value="emitUpdate" button-text="选择人格池..." />
+      <PersonaSelector :model-value="modelValue" @update:model-value="emitUpdate" :button-text="t('core.shared.personaSelector.selectPersonaPool')" />
     </template>
     <template v-else-if="itemMeta?._special === 'select_knowledgebase'">
       <KnowledgeBaseSelector :model-value="modelValue" @update:model-value="emitUpdate" />
@@ -56,7 +56,7 @@
           :loading="loading"
           class="ml-2"
         >
-          自动检测
+          {{ t('core.common.autoDetect') }}
         </v-btn>
       </div>
     </template>

dashboard/src/components/shared/ExtensionCard.vue

@@ -1,8 +1,8 @@
 <script setup lang="ts">
-import { ref, computed, inject } from 'vue';
+import { ref, computed, inject } from "vue";
 import { useCustomizerStore } from "@/stores/customizer";
-import { useModuleI18n } from '@/i18n/composables';
-import UninstallConfirmDialog from './UninstallConfirmDialog.vue';
+import { useModuleI18n } from "@/i18n/composables";
+import UninstallConfirmDialog from "./UninstallConfirmDialog.vue";
 
 const props = defineProps({
   extension: {
@@ -21,80 +21,114 @@ const props = defineProps({
 
 // 定义要发送到父组件的事件
 const emit = defineEmits([
-  'configure',
-  'update',
-  'reload',
-  'install',
-  'uninstall',
-  'toggle-activation',
-  'view-handlers',
-  'view-readme'
+  "configure",
+  "update",
+  "reload",
+  "install",
+  "uninstall",
+  "toggle-activation",
+  "view-handlers",
+  "view-readme",
+  "view-changelog",
 ]);
 
 const reveal = ref(false);
 const showUninstallDialog = ref(false);
 
 // 国际化
-const { tm } = useModuleI18n('features/extension');
+const { tm } = useModuleI18n("features/extension");
 
 // 操作函数
 const configure = () => {
-  emit('configure', props.extension);
+  emit("configure", props.extension);
 };
 
 const updateExtension = () => {
-  emit('update', props.extension);
+  emit("update", props.extension);
 };
 
 const reloadExtension = () => {
-  emit('reload', props.extension);
+  emit("reload", props.extension);
 };
 
 const $confirm = inject("$confirm");
 
 const installExtension = async () => {
-  emit('install', props.extension);
+  emit("install", props.extension);
 };
 
 const uninstallExtension = async () => {
   showUninstallDialog.value = true;
 };
 
-const handleUninstallConfirm = (options: { deleteConfig: boolean; deleteData: boolean }) => {
+const handleUninstallConfirm = (options: {
+  deleteConfig: boolean;
+  deleteData: boolean;
+}) => {
   emit("uninstall", props.extension, options);
 };
 
 const toggleActivation = () => {
-  emit('toggle-activation', props.extension);
+  emit("toggle-activation", props.extension);
 };
 
 const viewHandlers = () => {
-  emit('view-handlers', props.extension);
+  emit("view-handlers", props.extension);
 };
 
 const viewReadme = () => {
-  emit('view-readme', props.extension);
+  emit("view-readme", props.extension);
+};
+
+const viewChangelog = () => {
+  emit("view-changelog", props.extension);
 };
 </script>
 
 <template>
-  <v-card class="mx-auto d-flex flex-column" elevation="0" :style="{
-    position: 'relative',
-    backgroundColor: useCustomizerStore().uiTheme === 'PurpleTheme' ? marketMode ? '#f8f0dd' : '#ffffff' : '#282833',
-    color: useCustomizerStore().uiTheme === 'PurpleTheme' ? '#000000dd' : '#ffffff'
-  }">
-    <v-card-text style="padding: 16px; padding-bottom: 0px; display: flex; gap: 16px; width: 100%;">
+  <v-card
+    class="mx-auto d-flex flex-column"
+    elevation="0"
+    :style="{
+      position: 'relative',
+      backgroundColor:
+        useCustomizerStore().uiTheme === 'PurpleTheme'
+          ? marketMode
+            ? '#f8f0dd'
+            : '#ffffff'
+          : '#282833',
+      color:
+        useCustomizerStore().uiTheme === 'PurpleTheme'
+          ? '#000000dd'
+          : '#ffffff',
+    }"
+  >
+    <v-card-text
+      style="
+        padding: 16px;
+        padding-bottom: 0px;
+        display: flex;
+        gap: 16px;
+        width: 100%;
+      "
+    >
       <div v-if="extension?.logo">
-        <img :src="extension.logo" :alt="extension.name" cover width="100"/>
+        <img :src="extension.logo" :alt="extension.name" cover width="100" />
       </div>
 
-      <div style="overflow-x: auto;">
+      <div style="overflow-x: auto">
         <!-- Top-right three-dot menu -->
-        <div style="position: absolute; right: 8px; top: 8px; z-index: 5;">
+        <div style="position: absolute; right: 8px; top: 8px; z-index: 5">
           <v-menu offset-y>
             <template v-slot:activator="{ props: menuProps }">
-              <v-btn icon variant="text" aria-label="more" v-if="extension?.repo" :href="extension?.repo"
-                target="_blank">
+              <v-btn
+                icon
+                variant="text"
+                aria-label="more"
+                v-if="extension?.repo"
+                :href="extension?.repo"
+                target="_blank"
+              >
                 <v-icon icon="mdi-github"></v-icon>
               </v-btn>
               <v-btn v-bind="menuProps" icon variant="text" aria-label="more">
@@ -104,16 +138,30 @@ const viewReadme = () => {
 
             <v-list>
               <v-list-item @click="viewReadme">
-                <v-list-item-title>📄 {{ tm('buttons.viewDocs') }}</v-list-item-title>
+                <v-list-item-title
+                  >📄 {{ tm("buttons.viewDocs") }}</v-list-item-title
+                >
               </v-list-item>
 
-              <v-list-item v-if="marketMode && !extension?.installed" @click="installExtension">
+              <v-list-item v-if="!marketMode" @click="viewChangelog">
+                <v-list-item-title
+                  >📝 {{ tm("pluginChangelog.menuTitle") }}</v-list-item-title
+                >
+              </v-list-item>
+
+              <v-list-item
+                v-if="marketMode && !extension?.installed"
+                @click="installExtension"
+              >
                 <v-list-item-title>
-                  {{ tm('buttons.install') }}</v-list-item-title>
+                  {{ tm("buttons.install") }}</v-list-item-title
+                >
               </v-list-item>
 
               <v-list-item v-if="marketMode && extension?.installed">
-                <v-list-item-title class="text--disabled">{{ tm('status.installed') }}</v-list-item-title>
+                <v-list-item-title class="text--disabled">{{
+                  tm("status.installed")
+                }}</v-list-item-title>
               </v-list-item>
 
               <!-- Divider between market actions and plugin actions -->
@@ -122,34 +170,49 @@ const viewReadme = () => {
               <template v-if="!marketMode">
                 <v-list-item @click="configure">
                   <v-list-item-title>
-                    {{ tm('card.actions.pluginConfig') }}</v-list-item-title>
+                    {{ tm("card.actions.pluginConfig") }}</v-list-item-title
+                  >
                 </v-list-item>
 
                 <v-list-item @click="uninstallExtension">
-                  <v-list-item-title class="text-error">{{ tm('card.actions.uninstallPlugin') }}</v-list-item-title>
+                  <v-list-item-title class="text-error">{{
+                    tm("card.actions.uninstallPlugin")
+                  }}</v-list-item-title>
                 </v-list-item>
 
                 <v-list-item @click="reloadExtension">
-                  <v-list-item-title>{{ tm('card.actions.reloadPlugin') }}</v-list-item-title>
+                  <v-list-item-title>{{
+                    tm("card.actions.reloadPlugin")
+                  }}</v-list-item-title>
                 </v-list-item>
 
                 <v-list-item @click="toggleActivation">
                   <v-list-item-title>
-                    {{ extension.activated ? tm('buttons.disable') : tm('buttons.enable') }}{{
-                      tm('card.actions.togglePlugin') }}
+                    {{
+                      extension.activated
+                        ? tm("buttons.disable")
+                        : tm("buttons.enable")
+                    }}{{ tm("card.actions.togglePlugin") }}
                   </v-list-item-title>
                 </v-list-item>
 
                 <v-list-item @click="viewHandlers">
-                  <v-list-item-title>{{ tm('card.actions.viewHandlers') }} ({{ extension.handlers.length
-                  }})</v-list-item-title>
+                  <v-list-item-title
+                    >{{ tm("card.actions.viewHandlers") }} ({{
+                      extension.handlers.length
+                    }})</v-list-item-title
+                  >
                 </v-list-item>
 
                 <v-list-item @click="updateExtension">
                   <v-list-item-title>
-                    {{ extension.has_update 
-                        ? tm('card.actions.updateTo') + ' ' + extension.online_version 
-                        : tm('card.actions.reinstall') }}
+                    {{
+                      extension.has_update
+                        ? tm("card.actions.updateTo") +
+                          " " +
+                          extension.online_version
+                        : tm("card.actions.reinstall")
+                    }}
                   </v-list-item-title>
                 </v-list-item>
               </template>
@@ -157,23 +220,59 @@ const viewReadme = () => {
           </v-menu>
         </div>
 
-        <div style="width: 100%; margin-bottom: 24px;">
+        <div style="width: 100%; margin-bottom: 24px">
           <!-- 最多一行 -->
-          <div class="text-caption"
-            style="color: gray; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; margin-right: 84px;">
+          <div
+            class="text-caption"
+            style="
+              color: gray;
+              white-space: nowrap;
+              overflow: hidden;
+              text-overflow: ellipsis;
+              margin-right: 84px;
+            "
+          >
             {{ extension.author }} / {{ extension.name }}
           </div>
-          <p class="text-h3 font-weight-black extension-title" :class="{ 'text-h4': $vuetify.display.xs }">
-            <span class="extension-title__text">{{ extension.display_name?.length ? extension.display_name : extension.name }}</span>
-            <v-tooltip location="top" v-if="extension?.has_update && !marketMode">
+          <p
+            class="text-h3 font-weight-black extension-title"
+            :class="{ 'text-h4': $vuetify.display.xs }"
+          >
+            <span class="extension-title__text">{{
+              extension.display_name?.length
+                ? extension.display_name
+                : extension.name
+            }}</span>
+            <v-tooltip
+              location="top"
+              v-if="extension?.has_update && !marketMode"
+            >
               <template v-slot:activator="{ props: tooltipProps }">
-                <v-icon v-bind="tooltipProps" color="warning" class="ml-2" icon="mdi-update" size="small"></v-icon>
+                <v-icon
+                  v-bind="tooltipProps"
+                  color="warning"
+                  class="ml-2"
+                  icon="mdi-update"
+                  size="small"
+                ></v-icon>
               </template>
-              <span>{{ tm("card.status.hasUpdate") }}: {{ extension.online_version }}</span>
+              <span
+                >{{ tm("card.status.hasUpdate") }}:
+                {{ extension.online_version }}</span
+              >
             </v-tooltip>
-            <v-tooltip location="top" v-if="!extension.activated && !marketMode">
+            <v-tooltip
+              location="top"
+              v-if="!extension.activated && !marketMode"
+            >
               <template v-slot:activator="{ props: tooltipProps }">
-                <v-icon v-bind="tooltipProps" color="error" class="ml-2" icon="mdi-cancel" size="small"></v-icon>
+                <v-icon
+                  v-bind="tooltipProps"
+                  color="error"
+                  class="ml-2"
+                  icon="mdi-cancel"
+                  size="small"
+                ></v-icon>
               </template>
               <span>{{ tm("card.status.disabled") }}</span>
             </v-tooltip>
@@ -184,34 +283,58 @@ const viewReadme = () => {
               <v-icon icon="mdi-source-branch" start></v-icon>
               {{ extension.version }}
             </v-chip>
-            <v-chip v-if="extension?.has_update" color="warning" label size="small" class="ml-2">
+            <v-chip
+              v-if="extension?.has_update"
+              color="warning"
+              label
+              size="small"
+              class="ml-2"
+            >
               <v-icon icon="mdi-arrow-up-bold" start></v-icon>
               {{ extension.online_version }}
             </v-chip>
-            <v-chip color="primary" label size="small" class="ml-2" v-if="extension.handlers?.length" @click="viewHandlers" style="cursor: pointer;">
+            <v-chip
+              color="primary"
+              label
+              size="small"
+              class="ml-2"
+              v-if="extension.handlers?.length"
+              @click="viewHandlers"
+              style="cursor: pointer"
+            >
               <v-icon icon="mdi-cogs" start></v-icon>
-              {{ extension.handlers?.length }}{{ tm("card.status.handlersCount") }}
+              {{ extension.handlers?.length
+              }}{{ tm("card.status.handlersCount") }}
             </v-chip>
-            <v-chip v-for="tag in extension.tags" :key="tag" :color="tag === 'danger' ? 'error' : 'primary'" label
-              size="small" class="ml-2">
-              {{ tag === 'danger' ? tm('tags.danger') : tag }}
+            <v-chip
+              v-for="tag in extension.tags"
+              :key="tag"
+              :color="tag === 'danger' ? 'error' : 'primary'"
+              label
+              size="small"
+              class="ml-2"
+            >
+              {{ tag === "danger" ? tm("tags.danger") : tag }}
             </v-chip>
           </div>
 
-          <div class="mt-2" :class="{ 'text-caption': $vuetify.display.xs }" style="overflow-y: auto; height: 70px; font-size: 90%;">
+          <div
+            class="mt-2"
+            :class="{ 'text-caption': $vuetify.display.xs }"
+            style="overflow-y: auto; height: 70px; font-size: 90%"
+          >
             {{ extension.desc }}
           </div>
         </div>
       </div>
-
     </v-card-text>
 
     <v-card-actions class="extension-actions">
       <v-btn color="primary" size="small" @click="viewReadme">
-        {{ tm('buttons.viewDocs') }}
+        {{ tm("buttons.viewDocs") }}
       </v-btn>
-      <v-btn v-if="!marketMode" color="primary"  size="small" @click="configure">
-        {{ tm('card.actions.pluginConfig') }}
+      <v-btn v-if="!marketMode" color="primary" size="small" @click="configure">
+        {{ tm("card.actions.pluginConfig") }}
       </v-btn>
     </v-card-actions>
   </v-card>
@@ -221,7 +344,6 @@ const viewReadme = () => {
     v-model="showUninstallDialog"
     @confirm="handleUninstallConfirm"
   />
-
 </template>
 
 <style scoped>
@@ -241,7 +363,7 @@ const viewReadme = () => {
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
-  padding-top: 6px
+  padding-top: 6px;
 }
 
 @media (max-width: 600px) {

dashboard/src/components/shared/KnowledgeBaseSelector.vue

@@ -20,7 +20,7 @@
       </div>
     </div>
     <v-btn size="small" color="primary" variant="tonal" @click="openDialog" style="flex-shrink: 0;">
-      {{ buttonText }}
+      {{ buttonText || tm('knowledgeBaseSelector.buttonText') }}
     </v-btn>
   </div>
 
@@ -105,7 +105,7 @@ const props = defineProps({
   },
   buttonText: {
     type: String,
-    default: '选择知识库...'
+    default: ''
   }
 })
 

dashboard/src/components/shared/ListConfigItem.vue

@@ -175,11 +175,11 @@ const props = defineProps({
   },
   buttonText: {
     type: String,
-    default: '修改'
+    default: ''
   },
   dialogTitle: {
     type: String,
-    default: '修改列表项'
+    default: ''
   },
   maxDisplayItems: {
     type: Number,

dashboard/src/components/shared/PersonaSelector.vue

@@ -1,13 +1,13 @@
 <template>
   <div class="d-flex align-center justify-space-between">
     <span v-if="!modelValue" style="color: rgb(var(--v-theme-primaryText));">
-      未选择
+      {{ tm('personaSelector.notSelected') }}
     </span>
     <span v-else>
-      {{ modelValue === 'default' ? '默认人格' : modelValue }}
+      {{ modelValue === 'default' ? tm('personaSelector.defaultPersona') : modelValue }}
     </span>
     <v-btn size="small" color="primary" variant="tonal" @click="openDialog">
-      {{ buttonText }}
+      {{ buttonText || tm('personaSelector.buttonText') }}
     </v-btn>
   </div>
 
@@ -15,7 +15,7 @@
   <v-dialog v-model="dialog" max-width="600px">
     <v-card>
       <v-card-title class="text-h3 py-4" style="font-weight: normal;">
-        选择人格
+        {{ tm('personaSelector.dialogTitle') }}
       </v-card-title>
       
       <v-card-text class="pa-2" style="max-height: 400px; overflow-y: auto;">
@@ -30,9 +30,9 @@
             :active="selectedPersona === persona.persona_id"
             rounded="md"
             class="ma-1">
-            <v-list-item-title>{{ persona.persona_id === 'default' ? '默认人格' : persona.persona_id }}</v-list-item-title>
+            <v-list-item-title>{{ persona.persona_id === 'default' ? tm('personaSelector.defaultPersona') : persona.persona_id }}</v-list-item-title>
             <v-list-item-subtitle>
-              {{ persona.system_prompt ? persona.system_prompt.substring(0, 50) + '...' : '无描述' }}
+              {{ persona.system_prompt ? persona.system_prompt.substring(0, 50) + '...' : tm('personaSelector.noDescription') }}
             </v-list-item-subtitle>
             
             <template v-slot:append>
@@ -43,21 +43,21 @@
         
         <div v-else-if="!loading && personaList.length === 0" class="text-center py-8">
           <v-icon size="64" color="grey-lighten-1">mdi-account-off</v-icon>
-          <p class="text-grey mt-4">暂无可用的人格</p>
+          <p class="text-grey mt-4">{{ tm('personaSelector.noPersonas') }}</p>
         </div>
       </v-card-text>
       
       <v-card-actions class="pa-4">
         <v-btn variant="text" color="primary" prepend-icon="mdi-plus" @click="openCreatePersona">
-          创建新人格
+          {{ tm('personaSelector.createPersona') }}
         </v-btn>
         <v-spacer></v-spacer>
-        <v-btn variant="text" @click="cancelSelection">取消</v-btn>
-        <v-btn 
-          color="primary" 
+        <v-btn variant="text" @click="cancelSelection">{{ t('core.common.cancel') }}</v-btn>
+        <v-btn
+          color="primary"
           @click="confirmSelection"
           :disabled="!selectedPersona">
-          确认选择
+          {{ t('core.common.confirm') }}
         </v-btn>
       </v-card-actions>
     </v-card>
@@ -78,6 +78,7 @@
 import { ref, watch } from 'vue'
 import axios from 'axios'
 import PersonaForm from './PersonaForm.vue'
+import { useI18n, useModuleI18n } from '@/i18n/composables'
 
 const props = defineProps({
   modelValue: {
@@ -86,11 +87,13 @@ const props = defineProps({
   },
   buttonText: {
     type: String,
-    default: '选择人格...'
+    default: ''
   }
 })
 
 const emit = defineEmits(['update:modelValue'])
+const { t } = useI18n()
+const { tm } = useModuleI18n('core.shared')
 
 const dialog = ref(false)
 const personaList = ref([])

dashboard/src/components/shared/PluginSetSelector.vue

@@ -14,7 +14,7 @@
         </span>
       </div>
       <v-btn size="small" color="primary" variant="tonal" @click="openDialog">
-        {{ buttonText }}
+        {{ buttonText || tm('pluginSetSelector.buttonText') }}
       </v-btn>
     </div>
   </div>
@@ -113,7 +113,7 @@ const props = defineProps({
   },
   buttonText: {
     type: String,
-    default: '选择插件集合...'
+    default: ''
   },
   maxDisplayItems: {
     type: Number,

dashboard/src/components/shared/ProviderSelector.vue

@@ -7,7 +7,7 @@
       {{ modelValue }}
     </span>
     <v-btn size="small" color="primary" variant="tonal" @click="openDialog">
-      {{ buttonText }}
+      {{ buttonText || tm('providerSelector.buttonText') }}
     </v-btn>
   </div>
 
@@ -134,7 +134,7 @@ const props = defineProps({
   },
   buttonText: {
     type: String,
-    default: '选择提供商...'
+    default: ''
   }
 })
 

dashboard/src/components/shared/ProxySelector.vue

@@ -1,13 +1,13 @@
 <template>
-    <h5>GitHub 加速</h5>
+    <h5>{{ tm('network.proxySelector.title') }}</h5>
     <v-radio-group class="mt-2" v-model="radioValue" hide-details="true">
-        <v-radio label="不使用 GitHub 加速" value="0"></v-radio>
+        <v-radio :label="tm('network.proxySelector.noProxy')" value="0"></v-radio>
         <v-radio value="1">
             <template v-slot:label>
-                <span>使用 GitHub 加速</span>
+                <span>{{ tm('network.proxySelector.useProxy') }}</span>
                 <v-btn v-if="radioValue === '1'" class="ml-2" @click="testAllProxies" size="x-small"
                     variant="tonal" :loading="loadingTestingConnection">
-                    测试代理连通性
+                    {{ tm('network.proxySelector.testConnection') }}
                 </v-btn>
             </template>
         </v-radio>
@@ -20,15 +20,15 @@
                         <div class="d-flex align-center">
                             <span class="mr-2">{{ proxy }}</span>
                             <div v-if="proxyStatus[idx]">
-                                <v-chip 
-                                    :color="proxyStatus[idx].available ? 'success' : 'error'" 
-                                    size="x-small" 
+                                <v-chip
+                                    :color="proxyStatus[idx].available ? 'success' : 'error'"
+                                    size="x-small"
                                     class="mr-1">
-                                    {{ proxyStatus[idx].available ? '可用' : '不可用' }}
+                                    {{ proxyStatus[idx].available ? tm('network.proxySelector.available') : tm('network.proxySelector.unavailable') }}
                                 </v-chip>
-                                <v-chip 
-                                    v-if="proxyStatus[idx].available" 
-                                    color="info" 
+                                <v-chip
+                                    v-if="proxyStatus[idx].available"
+                                    color="info"
                                     size="x-small">
                                     {{ proxyStatus[idx].latency }}ms
                                 </v-chip>
@@ -36,10 +36,10 @@
                         </div>
                     </template>
                 </v-radio>
-                <v-radio color="primary" value="-1" label="自定义">
+                <v-radio color="primary" value="-1" :label="tm('network.proxySelector.custom')">
                     <template v-slot:label v-if="githubProxyRadioControl === '-1'">
                         <v-text-field density="compact" v-model="selectedGitHubProxy" variant="outlined"
-                            style="width: 100vw;" placeholder="自定义" hide-details="true">
+                            style="width: 100vw;" :placeholder="tm('network.proxySelector.custom')" hide-details="true">
                         </v-text-field>
                     </template>
                 </v-radio>

dashboard/src/components/shared/ReadmeDialog.vue

@@ -1,11 +1,11 @@
 <script setup>
-import { ref, watch, onMounted, computed } from 'vue';
-import axios from 'axios';
-import { MarkdownRender, enableKatex, enableMermaid } from 'markstream-vue';
-import 'markstream-vue/index.css';
-import 'katex/dist/katex.min.css';
-import 'highlight.js/styles/github.css';
-import { useI18n } from '@/i18n/composables';
+import { ref, watch, onMounted, computed } from "vue";
+import axios from "axios";
+import { MarkdownRender, enableKatex, enableMermaid } from "markstream-vue";
+import "markstream-vue/index.css";
+import "katex/dist/katex.min.css";
+import "highlight.js/styles/github.css";
+import { useI18n } from "@/i18n/composables";
 
 enableKatex();
 enableMermaid();
@@ -13,19 +13,25 @@ enableMermaid();
 const props = defineProps({
   show: {
     type: Boolean,
-    default: false
+    default: false,
   },
   pluginName: {
     type: String,
-    default: ''
+    default: "",
   },
   repoUrl: {
     type: String,
-    default: null
-  }
+    default: null,
+  },
+  // 模式: 'readme' 或 'changelog'
+  mode: {
+    type: String,
+    default: "readme",
+    validator: (value) => ["readme", "changelog"].includes(value),
+  },
 });
 
-const emit = defineEmits(['update:show']);
+const emit = defineEmits(["update:show"]);
 
 // 国际化
 const { t } = useI18n();
@@ -33,39 +39,83 @@ const { t } = useI18n();
 const content = ref(null);
 const error = ref(null);
 const loading = ref(false);
+const isEmpty = ref(false); // 请求成功但无内容
+
+// 根据模式返回不同的配置
+const modeConfig = computed(() => {
+  if (props.mode === "changelog") {
+    return {
+      title: t("core.common.changelog.title"),
+      loading: t("core.common.changelog.loading"),
+      emptyTitle: t("core.common.changelog.empty.title"),
+      emptySubtitle: t("core.common.changelog.empty.subtitle"),
+      apiPath: "/api/plugin/changelog",
+    };
+  }
+  return {
+    title: t("core.common.readme.title"),
+    loading: t("core.common.readme.loading"),
+    emptyTitle: t("core.common.readme.empty.title"),
+    emptySubtitle: t("core.common.readme.empty.subtitle"),
+    apiPath: "/api/plugin/readme",
+  };
+});
 
 // 监听show的变化，当显示对话框时加载内容
-watch(() => props.show, (newVal) => {
-  if (newVal && props.pluginName) {
-    fetchReadme();
-  }
-});
+watch(
+  () => props.show,
+  (newVal) => {
+    if (newVal && props.pluginName) {
+      fetchContent();
+    }
+  },
+);
 
 // 监听pluginName的变化
-watch(() => props.pluginName, (newVal) => {
-  if (props.show && newVal) {
-    fetchReadme();
-  }
-});
+watch(
+  () => props.pluginName,
+  (newVal) => {
+    if (props.show && newVal) {
+      fetchContent();
+    }
+  },
+);
 
-// 获取README内容
-async function fetchReadme() {
+// 监听mode的变化
+watch(
+  () => props.mode,
+  () => {
+    if (props.show && props.pluginName) {
+      fetchContent();
+    }
+  },
+);
+
+// 获取内容
+async function fetchContent() {
   if (!props.pluginName) return;
-  
+
   loading.value = true;
   content.value = null;
   error.value = null;
-  
+  isEmpty.value = false;
+
   try {
-    // 从本地文件获取README
-    const res = await axios.get(`/api/plugin/readme?name=${props.pluginName}`);
-    if (res.data.status === 'ok') {
-      content.value = res.data.data.content;
+    const res = await axios.get(
+      `${modeConfig.value.apiPath}?name=${props.pluginName}`,
+    );
+    if (res.data.status === "ok") {
+      if (res.data.data.content) {
+        content.value = res.data.data.content;
+      } else {
+        // 请求成功但无内容
+        isEmpty.value = true;
+      }
     } else {
-      error.value = res.data.message || t('core.common.readme.errors.fetchFailed');
+      error.value = res.data.message;
     }
   } catch (err) {
-    error.value = err.message || t('core.common.readme.errors.fetchError');
+    error.value = err.message;
   } finally {
     loading.value = false;
   }
@@ -74,14 +124,13 @@ async function fetchReadme() {
 // 打开GitHub中的仓库
 function openRepoInNewTab() {
   if (props.repoUrl) {
-    window.open(props.repoUrl, '_blank');
+    window.open(props.repoUrl, "_blank");
   }
 }
 
-
-// 刷新README内容
-function refreshReadme() {
-  fetchReadme();
+// 刷新内容
+function refreshContent() {
+  fetchContent();
 }
 
 // 计算属性处理双向绑定
@@ -90,8 +139,8 @@ const _show = computed({
     return props.show;
   },
   set(value) {
-    emit('update:show', value);
-  }
+    emit("update:show", value);
+  },
 });
 </script>
 
@@ -99,59 +148,98 @@ const _show = computed({
   <v-dialog v-model="_show" width="800">
     <v-card>
       <v-card-title class="d-flex justify-space-between align-center">
-        <span class="text-h5">{{ t('core.common.readme.title') }}</span>
+        <span class="text-h5">{{ modeConfig.title }}</span>
         <v-btn icon @click="$emit('update:show', false)" variant="text">
           <v-icon>mdi-close</v-icon>
         </v-btn>
       </v-card-title>
       <v-divider></v-divider>
-      <v-card-text style="height: 70vh; overflow-y: auto;">
+      <v-card-text style="height: 70vh; overflow-y: auto">
         <div class="d-flex justify-space-between mb-4">
-          <v-btn 
+          <v-btn
             v-if="repoUrl"
-            color="primary" 
+            color="primary"
             prepend-icon="mdi-github"
-            @click="openRepoInNewTab()" 
+            @click="openRepoInNewTab()"
           >
-            {{ t('core.common.readme.buttons.viewOnGithub') }}
+            {{ t("core.common.readme.buttons.viewOnGithub") }}
           </v-btn>
           <v-btn
             color="secondary"
             prepend-icon="mdi-refresh"
-            @click="refreshReadme()"
+            @click="refreshContent()"
           >
-            {{ t('core.common.readme.buttons.refresh') }}
+            {{ t("core.common.readme.buttons.refresh") }}
           </v-btn>
         </div>
-        
+
         <!-- 加载中 -->
-        <div v-if="loading" class="d-flex flex-column align-center justify-center" style="height: 100%;">
-          <v-progress-circular indeterminate color="primary" size="64" class="mb-4"></v-progress-circular>
-          <p class="text-body-1 text-center">{{ t('core.common.readme.loading') }}</p>
+        <div
+          v-if="loading"
+          class="d-flex flex-column align-center justify-center"
+          style="height: 100%"
+        >
+          <v-progress-circular
+            indeterminate
+            color="primary"
+            size="64"
+            class="mb-4"
+          ></v-progress-circular>
+          <p class="text-body-1 text-center">{{ modeConfig.loading }}</p>
         </div>
-        
+
         <!-- 内容显示 -->
         <div v-else-if="content" class="markdown-body">
-          <MarkdownRender :content="content" :typewriter="false" class="markdown-content" />
+          <MarkdownRender
+            :content="content"
+            :typewriter="false"
+            class="markdown-content"
+          />
         </div>
-        
+
         <!-- 错误提示 -->
-        <div v-else-if="error" class="d-flex flex-column align-center justify-center" style="height: 100%;">
-          <v-icon size="64" color="error" class="mb-4">mdi-alert-circle-outline</v-icon>
-          <p class="text-body-1 text-center mb-4">{{ error }}</p>
+        <div
+          v-else-if="error"
+          class="d-flex flex-column align-center justify-center"
+          style="height: 100%"
+        >
+          <v-icon size="64" color="error" class="mb-4"
+            >mdi-alert-circle-outline</v-icon
+          >
+          <p class="text-body-1 text-center mb-2">
+            {{ t("core.common.error") }}
+          </p>
+          <p class="text-body-2 text-center text-medium-emphasis">
+            {{ error }}
+          </p>
         </div>
-        
+
         <!-- 无内容提示 -->
-        <div v-else class="d-flex flex-column align-center justify-center" style="height: 100%;">
-          <v-icon size="64" color="warning" class="mb-4">mdi-file-question-outline</v-icon>
-          <p class="text-body-1 text-center mb-4">{{ t('core.common.readme.empty.title') }}<br>{{ t('core.common.readme.empty.subtitle') }}</p>
+        <div
+          v-else-if="isEmpty"
+          class="d-flex flex-column align-center justify-center"
+          style="height: 100%"
+        >
+          <v-icon size="64" color="warning" class="mb-4"
+            >mdi-file-question-outline</v-icon
+          >
+          <p class="text-body-1 text-center mb-2">
+            {{ modeConfig.emptyTitle }}
+          </p>
+          <p class="text-body-2 text-center text-medium-emphasis">
+            {{ modeConfig.emptySubtitle }}
+          </p>
         </div>
       </v-card-text>
       <v-divider></v-divider>
       <v-card-actions>
         <v-spacer></v-spacer>
-        <v-btn color="primary" variant="tonal" @click="$emit('update:show', false)">
-          {{ t('core.common.close') }}
+        <v-btn
+          color="primary"
+          variant="tonal"
+          @click="$emit('update:show', false)"
+        >
+          {{ t("core.common.close") }}
         </v-btn>
       </v-card-actions>
     </v-card>
@@ -160,10 +248,11 @@ const _show = computed({
 
 <style>
 .markdown-body {
-    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
-    line-height: 1.6;
-    padding: 8px 0;
-    color: var(--v-theme-secondaryText);
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial,
+    sans-serif;
+  line-height: 1.6;
+  padding: 8px 0;
+  color: var(--v-theme-secondaryText);
 }
 
 .markdown-body h1,
@@ -172,120 +261,120 @@ const _show = computed({
 .markdown-body h4,
 .markdown-body h5,
 .markdown-body h6 {
-    margin-top: 24px;
-    margin-bottom: 16px;
-    font-weight: 600;
-    line-height: 1.25;
+  margin-top: 24px;
+  margin-bottom: 16px;
+  font-weight: 600;
+  line-height: 1.25;
 }
 
 .markdown-body h1 {
-    font-size: 2em;
-    border-bottom: 1px solid var(--v-theme-border);
-    padding-bottom: 0.3em;
+  font-size: 2em;
+  border-bottom: 1px solid var(--v-theme-border);
+  padding-bottom: 0.3em;
 }
 
 .markdown-body h2 {
-    font-size: 1.5em;
-    border-bottom: 1px solid var(--v-theme-border);
-    padding-bottom: 0.3em;
+  font-size: 1.5em;
+  border-bottom: 1px solid var(--v-theme-border);
+  padding-bottom: 0.3em;
 }
 
 .markdown-body p {
-    margin-top: 0;
-    margin-bottom: 16px;
+  margin-top: 0;
+  margin-bottom: 16px;
 }
 
 .markdown-body code {
-    padding: 0.2em 0.4em;
-    margin: 0;
-    background-color: var(--v-theme-codeBg);
-    border-radius: 3px;
-    font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace;
-    font-size: 85%;
+  padding: 0.2em 0.4em;
+  margin: 0;
+  background-color: var(--v-theme-codeBg);
+  border-radius: 3px;
+  font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace;
+  font-size: 85%;
 }
 
 .markdown-body pre {
-    padding: 16px;
-    overflow: auto;
-    font-size: 85%;
-    line-height: 1.45;
-    background-color: var(--v-theme-containerBg);
-    border-radius: 3px;
-    margin-bottom: 16px;
+  padding: 16px;
+  overflow: auto;
+  font-size: 85%;
+  line-height: 1.45;
+  background-color: var(--v-theme-containerBg);
+  border-radius: 3px;
+  margin-bottom: 16px;
 }
 
 .markdown-body pre code {
-    background-color: transparent;
-    padding: 0;
+  background-color: transparent;
+  padding: 0;
 }
 
 .markdown-body ul,
 .markdown-body ol {
-    padding-left: 2em;
-    margin-bottom: 16px;
+  padding-left: 2em;
+  margin-bottom: 16px;
 }
 
 .markdown-body img {
-    max-width: 100%;
-    margin: 8px 0;
-    box-sizing: border-box;
-    background-color: var(--v-theme-background);
-    border-radius: 3px;
+  max-width: 100%;
+  margin: 8px 0;
+  box-sizing: border-box;
+  background-color: var(--v-theme-background);
+  border-radius: 3px;
 }
 
 .markdown-body blockquote {
-    padding: 0 1em;
-    color: var(--v-theme-secondaryText);
-    border-left: 0.25em solid var(--v-theme-border);
-    margin-bottom: 16px;
+  padding: 0 1em;
+  color: var(--v-theme-secondaryText);
+  border-left: 0.25em solid var(--v-theme-border);
+  margin-bottom: 16px;
 }
 
 .markdown-body a {
-    color: var(--v-theme-primary);
-    text-decoration: none;
+  color: var(--v-theme-primary);
+  text-decoration: none;
 }
 
 .markdown-body a:hover {
-    text-decoration: underline;
+  text-decoration: underline;
 }
 
 .markdown-body table {
-    border-spacing: 0;
-    border-collapse: collapse;
-    width: 100%;
-    overflow: auto;
-    margin-bottom: 16px;
+  border-spacing: 0;
+  border-collapse: collapse;
+  width: 100%;
+  overflow: auto;
+  margin-bottom: 16px;
 }
 
 .markdown-body table th,
 .markdown-body table td {
-    padding: 6px 13px;
-    border: 1px solid var(--v-theme-background);
+  padding: 6px 13px;
+  border: 1px solid var(--v-theme-background);
 }
 
 .markdown-body table tr {
-    background-color: var(--v-theme-surface);
-    border-top: 1px solid var(--v-theme-border);
+  background-color: var(--v-theme-surface);
+  border-top: 1px solid var(--v-theme-border);
 }
 
 .markdown-body table tr:nth-child(2n) {
-    background-color: var(--v-theme-background);
+  background-color: var(--v-theme-background);
 }
 
 .markdown-body hr {
-    height: 0.25em;
-    padding: 0;
-    margin: 24px 0;
-    background-color: var(--v-theme-containerBg);
-    border: 0;
+  height: 0.25em;
+  padding: 0;
+  margin: 24px 0;
+  background-color: var(--v-theme-containerBg);
+  border: 0;
 }
 </style>
 
 <script>
 export default {
-  name: 'ReadmeDialog',
+  name: "ReadmeDialog",
   components: {
-    MarkdownRender
+    MarkdownRender,
   },
   computed: {
     _show: {
@@ -293,9 +382,9 @@ export default {
         return this.show;
       },
       set(value) {
-        this.$emit('update:show', value);
-      }
-    }
-  }
-}
-</script> 
+        this.$emit("update:show", value);
+      },
+    },
+  },
+};
+</script>

dashboard/src/components/shared/T2ITemplateEditor.vue

@@ -1,32 +1,32 @@
 <template>
   <v-dialog v-model="dialog" max-width="1400px" persistent scrollable>
     <template v-slot:activator="{ props }">
-      <v-btn 
+      <v-btn
         v-bind="props"
-        variant="outlined" 
-        color="primary" 
+        variant="outlined"
+        color="primary"
         size="small"
         :loading="loading"
       >
-        自定义 T2I 模板
+        {{ tm('t2iTemplateEditor.buttonText') }}
       </v-btn>
     </template>
     
     <v-card>
       <v-card-title class="d-flex align-center justify-space-between">
-        <span>自定义文转图 HTML 模板</span>
+        <span>{{ tm('t2iTemplateEditor.dialogTitle') }}</span>
         <v-spacer></v-spacer>
         <div class="d-flex align-center gap-2" style="width: 60%">
           <v-text-field
             v-if="isCreatingNew"
             v-model="editingName"
-            label="输入新模板名称"
+            :label="tm('t2iTemplateEditor.newTemplateNameLabel')"
             density="compact"
             hide-details
             variant="outlined"
             class="flex-grow-1"
             autofocus
-            :rules="[v => !!v || '名称不能为空']"
+            :rules="[v => !!v || tm('t2iTemplateEditor.nameRequired')]"
           ></v-text-field>
           <v-select
             v-else
@@ -34,7 +34,7 @@
             :items="templates"
             item-title="name"
             item-value="name"
-            label="选择模板"
+            :label="tm('t2iTemplateEditor.selectTemplateLabel')"
             density="compact"
             hide-details
             variant="outlined"
@@ -51,7 +51,7 @@
                     size="small"
                     class="ml-2"
                   >
-                    已应用
+                    {{ tm('t2iTemplateEditor.applied') }}
                   </v-chip>
                   <v-btn
                     v-else
@@ -62,7 +62,7 @@
                     @click.stop="setActiveTemplate(item.raw.name)"
                     :loading="applyLoading"
                   >
-                    应用
+                    {{ tm('t2iTemplateEditor.apply') }}
                   </v-btn>
                 </template>
               </v-list-item>
@@ -83,7 +83,7 @@
           <!-- 左侧编辑器 -->
           <v-col cols="6" class="d-flex flex-column">
             <v-toolbar density="compact" color="surface-variant">
-              <v-toolbar-title class="text-subtitle-2">模板编辑器</v-toolbar-title>
+              <v-toolbar-title class="text-subtitle-2">{{ tm('t2iTemplateEditor.templateEditor') }}</v-toolbar-title>
               <v-spacer></v-spacer>
               <div class="d-flex align-center pa-1" style="border: 1px solid rgba(0,0,0,0.1); border-radius: 8px;">
                 <v-btn
@@ -93,7 +93,7 @@
                   color="success"
                 >
                   <v-icon left>mdi-plus</v-icon>
-                  新建
+                  {{ tm('t2iTemplateEditor.new') }}
                 </v-btn>
                 <v-divider vertical class="mx-1"></v-divider>
                 <v-btn
@@ -103,7 +103,7 @@
                   :loading="resetLoading"
                   color="warning"
                 >
-                  重置Base
+                  {{ tm('t2iTemplateEditor.resetBase') }}
                 </v-btn>
                 <v-btn
                   variant="text"
@@ -112,7 +112,7 @@
                   color="error"
                   :disabled="isCreatingNew || selectedTemplate === 'base' || !selectedTemplate"
                 >
-                  删除
+                  {{ tm('t2iTemplateEditor.delete') }}
                 </v-btn>
                 <v-divider vertical class="mx-1"></v-divider>
                 <v-btn
@@ -123,7 +123,7 @@
                   color="primary"
                   :disabled="(isCreatingNew && !editingName) || (!isCreatingNew && !selectedTemplate)"
                 >
-                  保存
+                  {{ tm('t2iTemplateEditor.save') }}
                 </v-btn>
               </div>
             </v-toolbar>
@@ -141,15 +141,15 @@
           <!-- 右侧预览 -->
           <v-col cols="6" class="d-flex flex-column">
             <v-toolbar density="compact" color="surface-variant">
-              <v-toolbar-title class="text-subtitle-2">实时预览(可能有差异)</v-toolbar-title>
+              <v-toolbar-title class="text-subtitle-2">{{ tm('t2iTemplateEditor.livePreview') }}</v-toolbar-title>
               <v-spacer></v-spacer>
-              <v-btn 
-                variant="text" 
-                size="small" 
+              <v-btn
+                variant="text"
+                size="small"
                 @click="refreshPreview"
                 :loading="previewLoading"
               >
-                刷新预览
+                {{ tm('t2iTemplateEditor.refreshPreview') }}
               </v-btn>
             </v-toolbar>
             <div class="flex-grow-1 preview-container">
@@ -168,7 +168,7 @@
           <v-col>
             <div class="text-caption text-grey">
               <v-icon size="16" class="mr-1">mdi-information</v-icon>
-              支持 jinja2 语法。可用变量：<code> text | safe </code>（要渲染的文本）, <code> version </code>（AstrBot 版本）
+              {{ tm('t2iTemplateEditor.syntaxHint') }}
             </div>
           </v-col>
           <v-col cols="auto">
@@ -176,7 +176,7 @@
               variant="text"
               @click="closeDialog"
             >
-              取消
+              {{ t('core.common.cancel') }}
             </v-btn>
             <v-btn
               color="primary"
@@ -184,7 +184,7 @@
               :loading="saveLoading"
               :disabled="isCreatingNew || !selectedTemplate"
             >
-              保存应用当前编辑模板
+              {{ tm('t2iTemplateEditor.saveAndApply') }}
             </v-btn>
           </v-col>
         </v-row>
@@ -194,14 +194,14 @@
     <!-- 确认重置对话框 -->
     <v-dialog v-model="resetDialog" max-width="400px">
       <v-card>
-        <v-card-title>确认重置</v-card-title>
+        <v-card-title>{{ tm('t2iTemplateEditor.confirmReset') }}</v-card-title>
         <v-card-text>
-          确定要将 'base' 模板恢复为默认内容吗？当前编辑器中的任何未保存更改将丢失。此操作无法撤销。
+          {{ tm('t2iTemplateEditor.confirmResetMessage') }}
         </v-card-text>
         <v-card-actions>
           <v-spacer></v-spacer>
-          <v-btn text @click="resetDialog = false">取消</v-btn>
-          <v-btn color="warning" @click="confirmReset" :loading="resetLoading">确认重置</v-btn>
+          <v-btn text @click="resetDialog = false">{{ t('core.common.cancel') }}</v-btn>
+          <v-btn color="warning" @click="confirmReset" :loading="resetLoading">{{ tm('t2iTemplateEditor.confirmResetButton') }}</v-btn>
         </v-card-actions>
       </v-card>
     </v-dialog>
@@ -209,14 +209,14 @@
     <!-- 删除确认对话框 -->
     <v-dialog v-model="deleteDialog" max-width="400px">
       <v-card>
-        <v-card-title>确认删除</v-card-title>
+        <v-card-title>{{ tm('t2iTemplateEditor.confirmDelete') }}</v-card-title>
         <v-card-text>
-          确定要删除模板 '{{ selectedTemplate }}' 吗？此操作无法撤销。
+          {{ tm('t2iTemplateEditor.confirmDeleteMessage', { name: selectedTemplate }) }}
         </v-card-text>
         <v-card-actions>
           <v-spacer></v-spacer>
-          <v-btn text @click="deleteDialog = false">取消</v-btn>
-          <v-btn color="error" @click="confirmDelete" :loading="saveLoading">确认删除</v-btn>
+          <v-btn text @click="deleteDialog = false">{{ t('core.common.cancel') }}</v-btn>
+          <v-btn color="error" @click="confirmDelete" :loading="saveLoading">{{ tm('t2iTemplateEditor.confirmDeleteButton') }}</v-btn>
         </v-card-actions>
       </v-card>
     </v-dialog>
@@ -224,14 +224,14 @@
     <!-- 保存并应用确认对话框 -->
     <v-dialog v-model="applyAndCloseDialog" max-width="500px">
       <v-card>
-        <v-card-title>确认操作</v-card-title>
+        <v-card-title>{{ tm('t2iTemplateEditor.confirmAction') }}</v-card-title>
         <v-card-text>
-          确定要保存对 '{{ selectedTemplate }}' 的修改，并将其设为新的活动模板吗？
+          {{ tm('t2iTemplateEditor.confirmApplyMessage', { name: selectedTemplate }) }}
         </v-card-text>
         <v-card-actions>
           <v-spacer></v-spacer>
-          <v-btn text @click="applyAndCloseDialog = false">取消</v-btn>
-          <v-btn color="primary" @click="confirmApplyAndClose" :loading="saveLoading">确认</v-btn>
+          <v-btn text @click="applyAndCloseDialog = false">{{ t('core.common.cancel') }}</v-btn>
+          <v-btn color="primary" @click="confirmApplyAndClose" :loading="saveLoading">{{ t('core.common.confirm') }}</v-btn>
         </v-card-actions>
       </v-card>
     </v-dialog>
@@ -242,10 +242,11 @@
 <script setup>
 import { ref, computed, nextTick, watch } from 'vue'
 import { VueMonacoEditor } from '@guolao/vue-monaco-editor'
-import { useI18n } from '@/i18n/composables'
+import { useI18n, useModuleI18n } from '@/i18n/composables'
 import axios from 'axios'
 
 const { t } = useI18n()
+const { tm } = useModuleI18n('core.shared')
 
 // --- 响应式数据 ---
 const dialog = ref(false)

dashboard/src/composables/useProviderSources.ts

@@ -241,6 +241,24 @@ export function useProviderSources(options: UseProviderSourcesOptions) {
     return providers.value.filter((provider: any) => getProviderType(provider) === selectedProviderType.value)
   })
 
+  const providerSourceSchema = computed(() => {
+    if (!configSchema.value || !configSchema.value.provider) {
+      return configSchema.value
+    }
+
+    // 创建一个深拷贝以避免修改原始 schema
+    const customSchema = JSON.parse(JSON.stringify(configSchema.value))
+
+    // 为 provider source 的 id 字段添加自定义 hint
+    if (customSchema.provider?.items?.id) {
+      customSchema.provider.items.id.hint = tm('providerSources.hints.id')
+      customSchema.provider.items.key.hint = tm('providerSources.hints.key')
+      customSchema.provider.items.api_base.hint = tm('providerSources.hints.apiBase')
+    }
+
+    return customSchema
+  })
+
   // ===== Watches =====
   watch(editableProviderSource, () => {
     if (suppressSourceWatch) return
@@ -646,6 +664,7 @@ export function useProviderSources(options: UseProviderSourcesOptions) {
     basicSourceConfig,
     advancedSourceConfig,
     manualProviderId,
+    providerSourceSchema,
 
     // helpers
     resolveSourceIcon,

dashboard/src/i18n/locales/en-US/core/common.json

@@ -35,6 +35,7 @@
   "yes": "Yes",
   "no": "No",
   "imagePreview": "Image Preview",
+  "autoDetect": "Auto Detect",
   "dialog": {
     "confirmTitle": "Confirm Action",
     "confirmMessage": "Are you sure you want to perform this action?",
@@ -61,6 +62,14 @@
       "subtitle": "Please check the extension marketplace or contact the extension author for more information."
     }
   },
+  "changelog": {
+    "title": "Changelog",
+    "loading": "Loading changelog...",
+    "empty": {
+      "title": "No changelog available for this plugin",
+      "subtitle": "Developers can add a CHANGELOG.md file in the plugin directory to provide changelog"
+    }
+  },
   "editor": {
     "fullscreen": "Fullscreen Edit",
     "editingTitle": "Editing Content"

dashboard/src/i18n/locales/en-US/core/shared.json

@@ -28,7 +28,9 @@
     "cancelSelection": "Cancel",
     "noDescription": "No description",
     "notActivated": "Not activated",
-    "note": "*System plugins and disabled plugins are not shown."
+    "note": "*System plugins and disabled plugins are not shown.",
+    "selectedPluginsLabel": "Selected Plugins:",
+    "allPluginsLabel": "All Plugins"
   },
   "providerSelector": {
     "notSelected": "Not selected",
@@ -42,6 +44,45 @@
     "clearSelectionSubtitle": "Clear current selection",
     "unknownType": "Unknown type",
     "createProvider": "Create Provider",
-    "manageProviders": "Provider Management"
+    "manageProviders": "Provider Management",
+    "selectProviderPool": "Select Provider Pool..."
+  },
+  "personaSelector": {
+    "notSelected": "Not selected",
+    "defaultPersona": "Default Persona",
+    "buttonText": "Select Persona...",
+    "dialogTitle": "Select Persona",
+    "noDescription": "No description",
+    "noPersonas": "No personas available",
+    "createPersona": "Create New Persona",
+    "cancelSelection": "Cancel",
+    "confirmSelection": "Confirm Selection",
+    "selectPersonaPool": "Select Persona Pool..."
+  },
+  "t2iTemplateEditor": {
+    "buttonText": "Customize T2I Template",
+    "dialogTitle": "Customize Text-to-Image HTML Template",
+    "newTemplateNameLabel": "Enter new template name",
+    "nameRequired": "Name is required",
+    "selectTemplateLabel": "Select Template",
+    "applied": "Applied",
+    "apply": "Apply",
+    "templateEditor": "Template Editor",
+    "new": "New",
+    "resetBase": "Reset Base",
+    "delete": "Delete",
+    "save": "Save",
+    "livePreview": "Live Preview (may differ)",
+    "refreshPreview": "Refresh Preview",
+    "syntaxHint": "Supports jinja2 syntax. Available variables: text | safe (text to render), version (AstrBot version)",
+    "saveAndApply": "Save and Apply Current Template",
+    "confirmReset": "Confirm Reset",
+    "confirmResetMessage": "Are you sure you want to reset the 'base' template to default content? Any unsaved changes in the editor will be lost. This action cannot be undone.",
+    "confirmResetButton": "Confirm Reset",
+    "confirmDelete": "Confirm Delete",
+    "confirmDeleteMessage": "Are you sure you want to delete template '{name}'? This action cannot be undone.",
+    "confirmDeleteButton": "Confirm Delete",
+    "confirmAction": "Confirm Action",
+    "confirmApplyMessage": "Are you sure you want to save changes to '{name}' and set it as the active template?"
   }
 }

dashboard/src/i18n/locales/en-US/features/extension.json

@@ -27,6 +27,7 @@
     "configure": "Configure",
     "viewInfo": "Handlers",
     "viewDocs": "Documentation",
+    "viewRepo": "Repository",
     "close": "Close",
     "save": "Save",
     "saveAndClose": "Save and Close",
@@ -212,5 +213,8 @@
     "pairs": "command conflicts",
     "goToManage": "Go to Manage",
     "later": "Later"
+  },
+  "pluginChangelog": {
+    "menuTitle": "View Changelog"
   }
-}
+}

dashboard/src/i18n/locales/en-US/features/provider.json

@@ -108,6 +108,11 @@
       "name": "Name",
       "apiKey": "API Key",
       "baseUrl": "Base URL"
+    },
+    "hints": {
+      "id": "Provider source ID (not provider ID)",
+      "key": "API key for authentication",
+      "apiBase": "Custom API endpoint URL"
     }
   },
   "models": {
@@ -130,6 +135,10 @@
     "manualDialogPreviewHint": "Generated as sourceId/modelId",
     "manualModelRequired": "Please enter a model ID",
     "manualModelExists": "Model already exists",
-    "configure": "Configure"
+    "configure": "Configure",
+    "tooltips": {
+      "providerId": "Provider ID",
+      "modelId": "Model ID"
+    }
   }
 } 

dashboard/src/i18n/locales/en-US/features/settings.json

@@ -5,6 +5,15 @@
       "title": "GitHub Proxy Address",
       "subtitle": "Set the GitHub proxy address used when downloading plugins or updating AstrBot. This is effective in mainland China's network environment. Can be customized, input takes effect in real time. All addresses do not guarantee stability. If errors occur when updating plugins/projects, please first check if the proxy address is working properly.",
       "label": "Select GitHub Proxy Address"
+    },
+    "proxySelector": {
+      "title": "GitHub Proxy",
+      "noProxy": "Don't use GitHub Proxy",
+      "useProxy": "Use GitHub Proxy",
+      "testConnection": "Test Connection",
+      "available": "Available",
+      "unavailable": "Unavailable",
+      "custom": "Custom"
     }
   },
   "system": {

dashboard/src/i18n/locales/zh-CN/core/common.json

@@ -35,6 +35,7 @@
   "yes": "是",
   "no": "否",
   "imagePreview": "图片预览",
+  "autoDetect": "自动检测",
   "dialog": {
     "confirmTitle": "确认操作",
     "confirmMessage": "你确定要执行此操作吗？",
@@ -61,6 +62,14 @@
       "subtitle": "请查看插件市场或联系插件作者获取更多信息。"
     }
   },
+  "changelog": {
+    "title": "更新日志",
+    "loading": "正在加载更新日志...",
+    "empty": {
+      "title": "该插件未提供更新日志",
+      "subtitle": "开发者可在插件目录下添加 CHANGELOG.md 文件来提供更新日志"
+    }
+  },
   "editor": {
     "fullscreen": "全屏编辑",
     "editingTitle": "编辑内容"

dashboard/src/i18n/locales/zh-CN/core/shared.json

@@ -28,7 +28,9 @@
     "cancelSelection": "取消",
     "noDescription": "无描述",
     "notActivated": "未激活",
-    "note": "*不显示系统插件和已经在插件页禁用的插件。"
+    "note": "*不显示系统插件和已经在插件页禁用的插件。",
+    "selectedPluginsLabel": "已选择的插件：",
+    "allPluginsLabel": "所有插件"
   },
   "providerSelector": {
     "notSelected": "未选择",
@@ -42,6 +44,45 @@
     "clearSelectionSubtitle": "清除当前选择",
     "unknownType": "未知类型",
     "createProvider": "创建提供商",
-    "manageProviders": "提供商管理"
+    "manageProviders": "提供商管理",
+    "selectProviderPool": "选择提供商池..."
+  },
+  "personaSelector": {
+    "notSelected": "未选择",
+    "defaultPersona": "默认人格",
+    "buttonText": "选择人格...",
+    "dialogTitle": "选择人格",
+    "noDescription": "无描述",
+    "noPersonas": "暂无可用的人格",
+    "createPersona": "创建新人格",
+    "cancelSelection": "取消",
+    "confirmSelection": "确认选择",
+    "selectPersonaPool": "选择人格池..."
+  },
+  "t2iTemplateEditor": {
+    "buttonText": "自定义 T2I 模板",
+    "dialogTitle": "自定义文转图 HTML 模板",
+    "newTemplateNameLabel": "输入新模板名称",
+    "nameRequired": "名称不能为空",
+    "selectTemplateLabel": "选择模板",
+    "applied": "已应用",
+    "apply": "应用",
+    "templateEditor": "模板编辑器",
+    "new": "新建",
+    "resetBase": "重置Base",
+    "delete": "删除",
+    "save": "保存",
+    "livePreview": "实时预览(可能有差异)",
+    "refreshPreview": "刷新预览",
+    "syntaxHint": "支持 jinja2 语法。可用变量：text | safe（要渲染的文本）, version（AstrBot 版本）",
+    "saveAndApply": "保存应用当前编辑模板",
+    "confirmReset": "确认重置",
+    "confirmResetMessage": "确定要将 'base' 模板恢复为默认内容吗？当前编辑器中的任何未保存更改将丢失。此操作无法撤销。",
+    "confirmResetButton": "确认重置",
+    "confirmDelete": "确认删除",
+    "confirmDeleteMessage": "确定要删除模板 '{name}' 吗？此操作无法撤销。",
+    "confirmDeleteButton": "确认删除",
+    "confirmAction": "确认操作",
+    "confirmApplyMessage": "确定要保存对 '{name}' 的修改，并将其设为新的活动模板吗？"
   }
 }

dashboard/src/i18n/locales/zh-CN/features/extension.json

@@ -27,6 +27,7 @@
     "configure": "配置",
     "viewInfo": "行为",
     "viewDocs": "文档",
+    "viewRepo": "仓库",
     "close": "关闭",
     "save": "保存",
     "saveAndClose": "保存并关闭",
@@ -212,5 +213,8 @@
     "pairs": "对指令冲突",
     "goToManage": "前往处理",
     "later": "稍后处理"
+  },
+  "pluginChangelog": {
+    "menuTitle": "查看更新日志"
   }
 }

dashboard/src/i18n/locales/zh-CN/features/provider.json

@@ -109,6 +109,11 @@
       "name": "名称",
       "apiKey": "API Key",
       "baseUrl": "Base URL"
+    },
+    "hints": {
+      "id": "提供商源唯一 ID（不是提供商 ID）",
+      "key": "API 密钥",
+      "apiBase": "自定义 API 端点 URL"
     }
   },
   "models": {
@@ -131,6 +136,10 @@
     "manualDialogPreviewHint": "生成规则：源ID/模型ID",
     "manualModelRequired": "请输入模型 ID",
     "manualModelExists": "该模型已存在",
-    "configure": "配置"
+    "configure": "配置",
+    "tooltips": {
+      "providerId": "提供商 ID",
+      "modelId": "模型 ID"
+    }
   }
 } 

dashboard/src/i18n/locales/zh-CN/features/settings.json

@@ -5,6 +5,15 @@
       "title": "GitHub 加速地址",
       "subtitle": "设置下载插件或者更新 AstrBot 时所用的 GitHub 加速地址。这在中国大陆的网络环境有效。可以自定义，输入结果实时生效。所有地址均不保证稳定性，如果在更新插件/项目时出现报错，请首先检查加速地址是否能正常使用。",
       "label": "选择 GitHub 加速地址"
+    },
+    "proxySelector": {
+      "title": "GitHub 加速",
+      "noProxy": "不使用 GitHub 加速",
+      "useProxy": "使用 GitHub 加速",
+      "testConnection": "测试代理连通性",
+      "available": "可用",
+      "unavailable": "不可用",
+      "custom": "自定义"
     }
   },
   "system": {

dashboard/src/utils/platformUtils.js

@@ -14,8 +14,6 @@ export function getPlatformIcon(name) {
     return new URL('@/assets/images/platform_logos/qq.png', import.meta.url).href
   } else if (name === 'wecom' || name === 'wecom_ai_bot') {
     return new URL('@/assets/images/platform_logos/wecom.png', import.meta.url).href
-  } else if (name === 'wechatpadpro' || name === 'weixin_official_account' || name === 'wechat') {
-    return new URL('@/assets/images/platform_logos/wechat.png', import.meta.url).href
   } else if (name === 'lark') {
     return new URL('@/assets/images/platform_logos/lark.png', import.meta.url).href
   } else if (name === 'dingtalk') {
@@ -52,7 +50,6 @@ export function getTutorialLink(platformType) {
     "lark": "https://docs.astrbot.app/deploy/platform/lark.html",
     "telegram": "https://docs.astrbot.app/deploy/platform/telegram.html",
     "dingtalk": "https://docs.astrbot.app/deploy/platform/dingtalk.html",
-    "wechatpadpro": "https://docs.astrbot.app/deploy/platform/wechat/wechatpadpro.html",
     "weixin_official_account": "https://docs.astrbot.app/deploy/platform/weixin-official-account.html",
     "discord": "https://docs.astrbot.app/deploy/platform/discord.html",
     "slack": "https://docs.astrbot.app/deploy/platform/slack.html",

dashboard/src/views/ProviderPage.vue

@@ -67,7 +67,7 @@
                 <v-card-text>
                   <template v-if="selectedProviderSource">
                     <div>
-                      <AstrBotConfig v-if="basicSourceConfig" :iterable="basicSourceConfig" :metadata="configSchema"
+                      <AstrBotConfig v-if="basicSourceConfig" :iterable="basicSourceConfig" :metadata="providerSourceSchema"
                         metadataKey="provider" :is-editing="true" />
                     </div>
 
@@ -78,7 +78,7 @@
                         </v-expansion-panel-title>
                         <v-expansion-panel-text>
                           <AstrBotConfig v-if="advancedSourceConfig" :iterable="advancedSourceConfig"
-                            :metadata="configSchema" metadataKey="provider" :is-editing="true" />
+                            :metadata="providerSourceSchema" metadataKey="provider" :is-editing="true" />
                         </v-expansion-panel-text>
                       </v-expansion-panel>
                     </v-expansion-panels>
@@ -208,7 +208,7 @@
     <v-dialog v-model="showProviderEditDialog" width="800">
       <v-card :title="providerEditData?.id || tm('dialogs.config.editTitle')">
         <v-card-text class="py-4">
-          <small style="color: gray;">不建议修改 ID，可能会导致指向该模型的相关配置（如默认模型、插件相关配置等）失效。</small>
+          <small style="color: gray;">不建议修改 ID，可能会导致指向该模型的相关配置（如默认模型、插件相关配置等）失效。旧版本 AstrBot 的 “提供商 ID” 是下方的 “ID”。</small>
           <AstrBotConfig v-if="providerEditData" :iterable="providerEditData" :metadata="configSchema"
             metadataKey="provider" :is-editing="true" />
         </v-card-text>
@@ -299,6 +299,7 @@ const {
   testingProviders,
   isSourceModified,
   configSchema,
+  providerSourceSchema,
   manualModelId,
   modelSearch,
   providerTypes,

dashboard/src/views/SessionManagementPage.vue

@@ -986,7 +986,6 @@ export default {
     getPlatformColor(platform) {
       const colors = {
         'aiocqhttp': 'blue',
-        'wechatpadpro': 'green',
         'qq_official': 'purple',
         'telegram': 'light-blue',
         'discord': 'indigo',

k8s/astrbot_with_napcat/01-pvc.yaml

@@ -43,4 +43,21 @@ spec:
   resources:
     requests:
       storage: 5Gi
+  # storageClassName: standard
+
+---
+# 持久化 machine-id，保持设备标识不变
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: napcat-machine-id-pvc
+  namespace: astrbot-ns
+  labels:
+    app: astrbot-stack
+spec:
+  accessModes:
+    - ReadWriteOnce
+  resources:
+    requests:
+      storage: 10Mi  # 只需存储一个 32 字节的文件
   # storageClassName: standard

k8s/astrbot_with_napcat/02-deployment.yaml

@@ -17,6 +17,32 @@ spec:
       labels:
         app: astrbot-stack
     spec:
+      # 设置固定主机名，避免 Pod 重启后主机名变化触发风控
+      hostname: napcat-host
+      subdomain: astrbot-stack
+      # 优雅关闭时间，给 NapCat 足够时间保存状态
+      terminationGracePeriodSeconds: 60
+      
+      # 初始化容器：首次生成随机 machine-id，后续复用
+      initContainers:
+        - name: init-machine-id
+          image: busybox:latest
+          command:
+            - /bin/sh
+            - -c
+            - |
+              # 仅在 machine-id 不存在时随机生成一个
+              if [ ! -f /machine-id-data/machine-id ]; then
+                # 使用 /dev/urandom 生成随机 UUID (32位十六进制)
+                cat /proc/sys/kernel/random/uuid | tr -d '-' > /machine-id-data/machine-id
+                echo "Machine ID generated: $(cat /machine-id-data/machine-id)"
+              else
+                echo "Machine ID exists: $(cat /machine-id-data/machine-id)"
+              fi
+          volumeMounts:
+            - name: machine-id-data
+              mountPath: /machine-id-data
+      
       containers:
         - name: napcat
           image: mlikiowa/napcat-docker:latest
@@ -28,9 +54,19 @@ spec:
               value: "1000"
             - name: MODE
               value: "astrbot"
+            - name: TZ
+              value: "Asia/Shanghai"
           ports:
             - containerPort: 6099
               name: napcat-web
+          # 资源限制：确保 Guaranteed QoS，减少被驱逐的可能
+          resources:
+            requests:
+              memory: "512Mi"
+              cpu: "250m"
+            limits:
+              memory: "1Gi"
+              cpu: "1000m"
           volumeMounts:
             - name: shared-data
               mountPath: /AstrBot/data
@@ -38,6 +74,14 @@ spec:
               mountPath: /app/napcat/config
             - name: napcat-qq
               mountPath: /app/.config/QQ
+            # 挂载持久化的 machine-id
+            - name: machine-id-data
+              mountPath: /etc/machine-id
+              subPath: machine-id
+              readOnly: true
+            - name: localtime
+              mountPath: /etc/localtime
+              readOnly: true
         
         - name: astrbot
           image: soulter/astrbot:latest
@@ -48,9 +92,19 @@ spec:
           ports:
             - containerPort: 6185
               name: astrbot-web
+          resources:
+            requests:
+              memory: "256Mi"
+              cpu: "100m"
+            limits:
+              memory: "512Mi"
+              cpu: "500m"
           volumeMounts:
             - name: shared-data
               mountPath: /AstrBot/data
+            - name: localtime
+              mountPath: /etc/localtime
+              readOnly: true
 
       volumes:
         - name: shared-data
@@ -61,4 +115,12 @@ spec:
             claimName: napcat-config-pvc
         - name: napcat-qq
           persistentVolumeClaim:
-            claimName: napcat-qq-pvc
+            claimName: napcat-qq-pvc
+        # 持久化 machine-id（首次随机生成，后续复用）
+        - name: machine-id-data
+          persistentVolumeClaim:
+            claimName: napcat-machine-id-pvc
+        - name: localtime
+          hostPath:
+            path: /etc/localtime
+            type: File

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "AstrBot"
-version = "4.11.0"
+version = "4.11.2"
 description = "Easy-to-use multi-platform LLM chatbot and development framework"
 readme = "README.md"
 requires-python = ">=3.10"