chore: improve documentation for extra_user_content_parts in Provider classes

.github/copilot-instructions.md

@@ -15,6 +15,7 @@ Always reference these instructions first and fallback to search or bash command
 ### Running the Application
 - Run main application: `uv run main.py` -- starts in ~3 seconds
 - Application creates WebUI on http://localhost:6185 (default credentials: `astrbot`/`astrbot`)
+- Application loads plugins automatically from `packages/` and `data/plugins/` directories
 
 ### Dashboard Build (Vue.js/Node.js)
 - **Prerequisites**: Node.js 20+ and npm 10+ required
@@ -34,7 +35,7 @@ Always reference these instructions first and fallback to search or bash command
 - **ALWAYS** run `uv run ruff check .` and `uv run ruff format .` before committing changes
 
 ### Plugin Development
-- Plugins load from `astrbot/builtin_stars/` (built-in) and `data/plugins/` (user-installed)
+- Plugins load from `packages/` (built-in) and `data/plugins/` (user-installed)
 - Plugin system supports function tools and message handlers
 - Key plugins: python_interpreter, web_searcher, astrbot, reminder, session_controller
 

.github/workflows/stale.yml

@@ -1,64 +1,27 @@
-# 本工作流用于标记并关闭长期不活跃的 Issue。
-# 目前仅针对带 `bug` 标签的 Issue 生效，不会处理 PR。
+# This workflow warns and then closes issues and PRs that have had no activity for a specified amount of time.
 #
-# 文档: https://github.com/actions/stale
-name: Mark stale bug issues
+# You can adjust the behavior by modifying this file.
+# For more information, see:
+# https://github.com/actions/stale
+name: Mark stale issues and pull requests
 
 on:
   schedule:
-    # 每天 UTC 08:30 执行 (北京时间 16:30)
-    - cron: '30 8 * * *'
-  workflow_dispatch:
-    inputs:
-      dry-run:
-        description: '仅预览, 不实际执行 (Dry run mode)'
-        required: false
-        default: true
-        type: boolean
+  - cron: '21 23 * * *'
 
 jobs:
   stale:
+
     runs-on: ubuntu-latest
     permissions:
       issues: write
+      pull-requests: write
 
     steps:
-      - uses: actions/stale@v10
-        with:
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
-          operations-per-run: 200
-
-          # 只处理带 bug 标签的 Issue
-          any-of-labels: 'bug'
-
-          # 不处理 PR
-          days-before-pr-stale: -1
-          days-before-pr-close: -1
-
-          # 不活跃判定与关闭策略: 先标记 stale, 再延迟关闭
-          days-before-issue-stale: 60
-          days-before-issue-close: 30
-
-          stale-issue-label: 'stale'
-          stale-issue-message: |
-            This issue has been automatically marked as **stale** because it has not had any activity.
-            It will be closed in a certain period of time if no further activity occurs.
-            If this issue is still relevant, please leave a comment.
-
-            ---
-
-            该 Issue 已较长时间无活动, 已被标记为 `stale`。
-            如无后续活动, 将在一段时间后自动关闭。
-            如仍需跟进, 请回复评论。
-          close-issue-message: |
-            This issue has been automatically closed due to inactivity.
-            If the problem still exists, feel free to reopen or create a new issue with updated information.
-
-            ---
-
-            该 Issue 因长期无活动已自动关闭。
-            如问题仍存在, 欢迎补充复现信息并重新打开或新建 Issue。
-
-          remove-stale-when-updated: true
-
-          debug-only: ${{ github.event_name == 'workflow_dispatch' && inputs.dry-run }}
+    - uses: actions/stale@v10
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-issue-message: 'Stale issue message'
+        stale-pr-message: 'Stale pull request message'
+        stale-issue-label: 'no-issue-activity'
+        stale-pr-label: 'no-pr-activity'

.gitignore

@@ -24,9 +24,9 @@ configs/session
 configs/config.yaml
 cmd_config.json
 
-# Plugins
+# Plugins and packages
 addons/plugins
-astrbot/builtin_stars/python_interpreter/workplace
+packages/python_interpreter/workplace
 tests/astrbot_plugin_openai
 
 # Dashboard

README.md

@@ -1,4 +1,4 @@
-![AstrBot-Logo-Simplified](https://github.com/user-attachments/assets/ffd99b6b-3272-4682-beaa-6fe74250f7d9)
+![astrbot-banner-xmas](https://github.com/user-attachments/assets/bf2341de-ec7a-45a7-a04a-02ad36450e99)
 
 <div align="center">
 
@@ -132,7 +132,6 @@ uv run main.py
 
 **社区维护**
 
-- [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
 - [Bilibili 私信](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)
@@ -209,7 +208,6 @@ pre-commit install
 - 5 群：822130018
 - 6 群：753075035
 - 7 群：743746109
-- 8 群：1030353265
 - 开发者群：975206796
 
 ### Telegram 群组

README_en.md

@@ -134,7 +134,6 @@ Or refer to the official documentation: [Deploy AstrBot from Source](https://ast
 
 **Community Maintained**
 
-- [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
 - [Bilibili Direct Messages](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)

README_fr.md

@@ -134,7 +134,6 @@ Ou consultez la documentation officielle : [Déployer AstrBot depuis les sources
 
 **Maintenues par la communauté**
 
-- [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
 - [Messages directs Bilibili](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)

README_ja.md

@@ -134,7 +134,6 @@ uv run main.py
 
 **コミュニティメンテナンス**
 
-- [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
 - [Bilibili ダイレクトメッセージ](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)

README_ru.md

@@ -134,7 +134,6 @@ uv run main.py
 
 **Поддерживаемые сообществом**
 
-- [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
 - [Личные сообщения Bilibili](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)

README_zh-TW.md

@@ -134,7 +134,6 @@ uv run main.py
 
 **社群維護**
 
-- [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
 - [Bilibili 私訊](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)

astrbot/api/event/filter/__init__.py

@@ -21,9 +21,6 @@ from astrbot.core.star.register import (
 from astrbot.core.star.register import register_on_llm_request as on_llm_request
 from astrbot.core.star.register import register_on_llm_response as on_llm_response
 from astrbot.core.star.register import register_on_platform_loaded as on_platform_loaded
-from astrbot.core.star.register import (
-    register_on_waiting_llm_request as on_waiting_llm_request,
-)
 from astrbot.core.star.register import register_permission_type as permission_type
 from astrbot.core.star.register import (
     register_platform_adapter_type as platform_adapter_type,
@@ -49,7 +46,6 @@ __all__ = [
     "on_llm_request",
     "on_llm_response",
     "on_platform_loaded",
-    "on_waiting_llm_request",
     "permission_type",
     "platform_adapter_type",
     "regex",

astrbot/cli/__init__.py

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

astrbot/core/agent/context/compressor.py

@@ -1,243 +0,0 @@
-from typing import TYPE_CHECKING, Protocol, runtime_checkable
-
-from ..message import Message
-
-if TYPE_CHECKING:
-    from astrbot import logger
-else:
-    try:
-        from astrbot import logger
-    except ImportError:
-        import logging
-
-        logger = logging.getLogger("astrbot")
-
-if TYPE_CHECKING:
-    from astrbot.core.provider.provider import Provider
-
-from ..context.truncator import ContextTruncator
-
-
-@runtime_checkable
-class ContextCompressor(Protocol):
-    """
-    Protocol for context compressors.
-    Provides an interface for compressing message lists.
-    """
-
-    def should_compress(
-        self, messages: list[Message], current_tokens: int, max_tokens: int
-    ) -> bool:
-        """Check if compression is needed.
-
-        Args:
-            messages: The message list to evaluate.
-            current_tokens: The current token count.
-            max_tokens: The maximum allowed tokens for the model.
-
-        Returns:
-            True if compression is needed, False otherwise.
-        """
-        ...
-
-    async def __call__(self, messages: list[Message]) -> list[Message]:
-        """Compress the message list.
-
-        Args:
-            messages: The original message list.
-
-        Returns:
-            The compressed message list.
-        """
-        ...
-
-
-class TruncateByTurnsCompressor:
-    """Truncate by turns compressor implementation.
-    Truncates the message list by removing older turns.
-    """
-
-    def __init__(self, truncate_turns: int = 1, compression_threshold: float = 0.82):
-        """Initialize the truncate by turns compressor.
-
-        Args:
-            truncate_turns: The number of turns to remove when truncating (default: 1).
-            compression_threshold: The compression trigger threshold (default: 0.82).
-        """
-        self.truncate_turns = truncate_turns
-        self.compression_threshold = compression_threshold
-
-    def should_compress(
-        self, messages: list[Message], current_tokens: int, max_tokens: int
-    ) -> bool:
-        """Check if compression is needed.
-
-        Args:
-            messages: The message list to evaluate.
-            current_tokens: The current token count.
-            max_tokens: The maximum allowed tokens.
-
-        Returns:
-            True if compression is needed, False otherwise.
-        """
-        if max_tokens <= 0 or current_tokens <= 0:
-            return False
-        usage_rate = current_tokens / max_tokens
-        return usage_rate > self.compression_threshold
-
-    async def __call__(self, messages: list[Message]) -> list[Message]:
-        truncator = ContextTruncator()
-        truncated_messages = truncator.truncate_by_dropping_oldest_turns(
-            messages,
-            drop_turns=self.truncate_turns,
-        )
-        return truncated_messages
-
-
-def split_history(
-    messages: list[Message], keep_recent: int
-) -> tuple[list[Message], list[Message], list[Message]]:
-    """Split the message list into system messages, messages to summarize, and recent messages.
-
-    Ensures that the split point is between complete user-assistant pairs to maintain conversation flow.
-
-    Args:
-        messages: The original message list.
-        keep_recent: The number of latest messages to keep.
-
-    Returns:
-        tuple: (system_messages, messages_to_summarize, recent_messages)
-    """
-    # keep the system messages
-    first_non_system = 0
-    for i, msg in enumerate(messages):
-        if msg.role != "system":
-            first_non_system = i
-            break
-
-    system_messages = messages[:first_non_system]
-    non_system_messages = messages[first_non_system:]
-
-    if len(non_system_messages) <= keep_recent:
-        return system_messages, [], non_system_messages
-
-    # Find the split point, ensuring recent_messages starts with a user message
-    # This maintains complete conversation turns
-    split_index = len(non_system_messages) - keep_recent
-
-    # Search backward from split_index to find the first user message
-    # This ensures recent_messages starts with a user message (complete turn)
-    while split_index > 0 and non_system_messages[split_index].role != "user":
-        # TODO: +=1 or -=1 ? calculate by tokens
-        split_index -= 1
-
-    # If we couldn't find a user message, keep all messages as recent
-    if split_index == 0:
-        return system_messages, [], non_system_messages
-
-    messages_to_summarize = non_system_messages[:split_index]
-    recent_messages = non_system_messages[split_index:]
-
-    return system_messages, messages_to_summarize, recent_messages
-
-
-class LLMSummaryCompressor:
-    """LLM-based summary compressor.
-    Uses LLM to summarize the old conversation history, keeping the latest messages.
-    """
-
-    def __init__(
-        self,
-        provider: "Provider",
-        keep_recent: int = 4,
-        instruction_text: str | None = None,
-        compression_threshold: float = 0.82,
-    ):
-        """Initialize the LLM summary compressor.
-
-        Args:
-            provider: The LLM provider instance.
-            keep_recent: The number of latest messages to keep (default: 4).
-            instruction_text: Custom instruction for summary generation.
-            compression_threshold: The compression trigger threshold (default: 0.82).
-        """
-        self.provider = provider
-        self.keep_recent = keep_recent
-        self.compression_threshold = compression_threshold
-
-        self.instruction_text = instruction_text or (
-            "Based on our full conversation history, produce a concise summary of key takeaways and/or project progress.\n"
-            "1. Systematically cover all core topics discussed and the final conclusion/outcome for each; clearly highlight the latest primary focus.\n"
-            "2. If any tools were used, summarize tool usage (total call count) and extract the most valuable insights from tool outputs.\n"
-            "3. If there was an initial user goal, state it first and describe the current progress/status.\n"
-            "4. Write the summary in the user's language.\n"
-        )
-
-    def should_compress(
-        self, messages: list[Message], current_tokens: int, max_tokens: int
-    ) -> bool:
-        """Check if compression is needed.
-
-        Args:
-            messages: The message list to evaluate.
-            current_tokens: The current token count.
-            max_tokens: The maximum allowed tokens.
-
-        Returns:
-            True if compression is needed, False otherwise.
-        """
-        if max_tokens <= 0 or current_tokens <= 0:
-            return False
-        usage_rate = current_tokens / max_tokens
-        return usage_rate > self.compression_threshold
-
-    async def __call__(self, messages: list[Message]) -> list[Message]:
-        """Use LLM to generate a summary of the conversation history.
-
-        Process:
-        1. Divide messages: keep the system message and the latest N messages.
-        2. Send the old messages + the instruction message to the LLM.
-        3. Reconstruct the message list: [system message, summary message, latest messages].
-        """
-        if len(messages) <= self.keep_recent + 1:
-            return messages
-
-        system_messages, messages_to_summarize, recent_messages = split_history(
-            messages, self.keep_recent
-        )
-
-        if not messages_to_summarize:
-            return messages
-
-        # build payload
-        instruction_message = Message(role="user", content=self.instruction_text)
-        llm_payload = messages_to_summarize + [instruction_message]
-
-        # generate summary
-        try:
-            response = await self.provider.text_chat(contexts=llm_payload)
-            summary_content = response.completion_text
-        except Exception as e:
-            logger.error(f"Failed to generate summary: {e}")
-            return messages
-
-        # build result
-        result = []
-        result.extend(system_messages)
-
-        result.append(
-            Message(
-                role="user",
-                content=f"Our previous history conversation summary: {summary_content}",
-            )
-        )
-        result.append(
-            Message(
-                role="assistant",
-                content="Acknowledged the summary of our previous conversation history.",
-            )
-        )
-
-        result.extend(recent_messages)
-
-        return result

astrbot/core/agent/context/config.py

@@ -1,35 +0,0 @@
-from dataclasses import dataclass
-from typing import TYPE_CHECKING
-
-from .compressor import ContextCompressor
-from .token_counter import TokenCounter
-
-if TYPE_CHECKING:
-    from astrbot.core.provider.provider import Provider
-
-
-@dataclass
-class ContextConfig:
-    """Context configuration class."""
-
-    max_context_tokens: int = 0
-    """Maximum number of context tokens. <= 0 means no limit."""
-    enforce_max_turns: int = -1  # -1 means no limit
-    """Maximum number of conversation turns to keep. -1 means no limit. Executed before compression."""
-    truncate_turns: int = 1
-    """Number of conversation turns to discard at once when truncation is triggered.
-    Two processes will use this value:
-
-    1. Enforce max turns truncation.
-    2. Truncation by turns compression strategy.
-    """
-    llm_compress_instruction: str | None = None
-    """Instruction prompt for LLM-based compression."""
-    llm_compress_keep_recent: int = 0
-    """Number of recent messages to keep during LLM-based compression."""
-    llm_compress_provider: "Provider | None" = None
-    """LLM provider used for compression tasks. If None, truncation strategy is used."""
-    custom_token_counter: TokenCounter | None = None
-    """Custom token counting method. If None, the default method is used."""
-    custom_compressor: ContextCompressor | None = None
-    """Custom context compression method. If None, the default method is used."""

astrbot/core/agent/context/manager.py

@@ -1,120 +0,0 @@
-from astrbot import logger
-
-from ..message import Message
-from .compressor import LLMSummaryCompressor, TruncateByTurnsCompressor
-from .config import ContextConfig
-from .token_counter import EstimateTokenCounter
-from .truncator import ContextTruncator
-
-
-class ContextManager:
-    """Context compression manager."""
-
-    def __init__(
-        self,
-        config: ContextConfig,
-    ):
-        """Initialize the context manager.
-
-        There are two strategies to handle context limit reached:
-        1. Truncate by turns: remove older messages by turns.
-        2. LLM-based compression: use LLM to summarize old messages.
-
-        Args:
-            config: The context configuration.
-        """
-        self.config = config
-
-        self.token_counter = config.custom_token_counter or EstimateTokenCounter()
-        self.truncator = ContextTruncator()
-
-        if config.custom_compressor:
-            self.compressor = config.custom_compressor
-        elif config.llm_compress_provider:
-            self.compressor = LLMSummaryCompressor(
-                provider=config.llm_compress_provider,
-                keep_recent=config.llm_compress_keep_recent,
-                instruction_text=config.llm_compress_instruction,
-            )
-        else:
-            self.compressor = TruncateByTurnsCompressor(
-                truncate_turns=config.truncate_turns
-            )
-
-    async def process(
-        self, messages: list[Message], trusted_token_usage: int = 0
-    ) -> list[Message]:
-        """Process the messages.
-
-        Args:
-            messages: The original message list.
-
-        Returns:
-            The processed message list.
-        """
-        try:
-            result = messages
-
-            # 1. 基于轮次的截断 (Enforce max turns)
-            if self.config.enforce_max_turns != -1:
-                result = self.truncator.truncate_by_turns(
-                    result,
-                    keep_most_recent_turns=self.config.enforce_max_turns,
-                    drop_turns=self.config.truncate_turns,
-                )
-
-            # 2. 基于 token 的压缩
-            if self.config.max_context_tokens > 0:
-                total_tokens = self.token_counter.count_tokens(
-                    result, trusted_token_usage
-                )
-
-                if self.compressor.should_compress(
-                    result, total_tokens, self.config.max_context_tokens
-                ):
-                    result = await self._run_compression(result, total_tokens)
-
-            return result
-        except Exception as e:
-            logger.error(f"Error during context processing: {e}", exc_info=True)
-            return messages
-
-    async def _run_compression(
-        self, messages: list[Message], prev_tokens: int
-    ) -> list[Message]:
-        """
-        Compress/truncate the messages.
-
-        Args:
-            messages: The original message list.
-            prev_tokens: The token count before compression.
-
-        Returns:
-            The compressed/truncated message list.
-        """
-        logger.debug("Compress triggered, starting compression...")
-
-        messages = await self.compressor(messages)
-
-        # double check
-        tokens_after_summary = self.token_counter.count_tokens(messages)
-
-        # calculate compress rate
-        compress_rate = (tokens_after_summary / self.config.max_context_tokens) * 100
-        logger.info(
-            f"Compress completed."
-            f" {prev_tokens} -> {tokens_after_summary} tokens,"
-            f" compression rate: {compress_rate:.2f}%.",
-        )
-
-        # last check
-        if self.compressor.should_compress(
-            messages, tokens_after_summary, self.config.max_context_tokens
-        ):
-            logger.info(
-                "Context still exceeds max tokens after compression, applying halving truncation..."
-            )
-            # still need compress, truncate by half
-            messages = self.truncator.truncate_by_halving(messages)
-
-        return messages

astrbot/core/agent/context/token_counter.py

@@ -1,64 +0,0 @@
-import json
-from typing import Protocol, runtime_checkable
-
-from ..message import Message, TextPart
-
-
-@runtime_checkable
-class TokenCounter(Protocol):
-    """
-    Protocol for token counters.
-    Provides an interface for counting tokens in message lists.
-    """
-
-    def count_tokens(
-        self, messages: list[Message], trusted_token_usage: int = 0
-    ) -> int:
-        """Count the total tokens in the message list.
-
-        Args:
-            messages: The message list.
-            trusted_token_usage: The total token usage that LLM API returned.
-                For some cases, this value is more accurate.
-                But some API does not return it, so the value defaults to 0.
-
-        Returns:
-            The total token count.
-        """
-        ...
-
-
-class EstimateTokenCounter:
-    """Estimate token counter implementation.
-    Provides a simple estimation of token count based on character types.
-    """
-
-    def count_tokens(
-        self, messages: list[Message], trusted_token_usage: int = 0
-    ) -> int:
-        if trusted_token_usage > 0:
-            return trusted_token_usage
-
-        total = 0
-        for msg in messages:
-            content = msg.content
-            if isinstance(content, str):
-                total += self._estimate_tokens(content)
-            elif isinstance(content, list):
-                # 处理多模态内容
-                for part in content:
-                    if isinstance(part, TextPart):
-                        total += self._estimate_tokens(part.text)
-
-            # 处理 Tool Calls
-            if msg.tool_calls:
-                for tc in msg.tool_calls:
-                    tc_str = json.dumps(tc if isinstance(tc, dict) else tc.model_dump())
-                    total += self._estimate_tokens(tc_str)
-
-        return total
-
-    def _estimate_tokens(self, text: str) -> int:
-        chinese_count = len([c for c in text if "\u4e00" <= c <= "\u9fff"])
-        other_count = len(text) - chinese_count
-        return int(chinese_count * 0.6 + other_count * 0.3)

astrbot/core/agent/context/truncator.py

@@ -1,141 +0,0 @@
-from ..message import Message
-
-
-class ContextTruncator:
-    """Context truncator."""
-
-    def fix_messages(self, messages: list[Message]) -> list[Message]:
-        fixed_messages = []
-        for message in messages:
-            if message.role == "tool":
-                # tool block 前面必须要有 user 和 assistant block
-                if len(fixed_messages) < 2:
-                    # 这种情况可能是上下文被截断导致的
-                    # 我们直接将之前的上下文都清空
-                    fixed_messages = []
-                else:
-                    fixed_messages.append(message)
-            else:
-                fixed_messages.append(message)
-        return fixed_messages
-
-    def truncate_by_turns(
-        self,
-        messages: list[Message],
-        keep_most_recent_turns: int,
-        drop_turns: int = 1,
-    ) -> list[Message]:
-        """截断上下文列表，确保不超过最大长度。
-        一个 turn 包含一个 user 消息和一个 assistant 消息。
-        这个方法会保证截断后的上下文列表符合 OpenAI 的上下文格式。
-
-        Args:
-            messages: 上下文列表
-            keep_most_recent_turns: 保留最近的对话轮数
-            drop_turns: 一次性丢弃的对话轮数
-
-        Returns:
-            截断后的上下文列表
-        """
-        if keep_most_recent_turns == -1:
-            return messages
-
-        first_non_system = 0
-        for i, msg in enumerate(messages):
-            if msg.role != "system":
-                first_non_system = i
-                break
-
-        system_messages = messages[:first_non_system]
-        non_system_messages = messages[first_non_system:]
-
-        if len(non_system_messages) // 2 <= keep_most_recent_turns:
-            return messages
-
-        num_to_keep = keep_most_recent_turns - drop_turns + 1
-        if num_to_keep <= 0:
-            truncated_contexts = []
-        else:
-            truncated_contexts = non_system_messages[-num_to_keep * 2 :]
-
-        # 找到第一个 role 为 user 的索引，确保上下文格式正确
-        index = next(
-            (i for i, item in enumerate(truncated_contexts) if item.role == "user"),
-            None,
-        )
-        if index is not None and index > 0:
-            truncated_contexts = truncated_contexts[index:]
-
-        result = system_messages + truncated_contexts
-
-        return self.fix_messages(result)
-
-    def truncate_by_dropping_oldest_turns(
-        self,
-        messages: list[Message],
-        drop_turns: int = 1,
-    ) -> list[Message]:
-        """丢弃最旧的 N 个对话轮次。"""
-        if drop_turns <= 0:
-            return messages
-
-        first_non_system = 0
-        for i, msg in enumerate(messages):
-            if msg.role != "system":
-                first_non_system = i
-                break
-
-        system_messages = messages[:first_non_system]
-        non_system_messages = messages[first_non_system:]
-
-        if len(non_system_messages) // 2 <= drop_turns:
-            truncated_non_system = []
-        else:
-            truncated_non_system = non_system_messages[drop_turns * 2 :]
-
-        index = next(
-            (i for i, item in enumerate(truncated_non_system) if item.role == "user"),
-            None,
-        )
-        if index is not None:
-            truncated_non_system = truncated_non_system[index:]
-        elif truncated_non_system:
-            truncated_non_system = []
-
-        result = system_messages + truncated_non_system
-
-        return self.fix_messages(result)
-
-    def truncate_by_halving(
-        self,
-        messages: list[Message],
-    ) -> list[Message]:
-        """对半砍策略，删除 50% 的消息"""
-        if len(messages) <= 2:
-            return messages
-
-        first_non_system = 0
-        for i, msg in enumerate(messages):
-            if msg.role != "system":
-                first_non_system = i
-                break
-
-        system_messages = messages[:first_non_system]
-        non_system_messages = messages[first_non_system:]
-
-        messages_to_delete = len(non_system_messages) // 2
-        if messages_to_delete == 0:
-            return messages
-
-        truncated_non_system = non_system_messages[messages_to_delete:]
-
-        index = next(
-            (i for i, item in enumerate(truncated_non_system) if item.role == "user"),
-            None,
-        )
-        if index is not None:
-            truncated_non_system = truncated_non_system[index:]
-
-        result = system_messages + truncated_non_system
-
-        return self.fix_messages(result)

astrbot/core/agent/message.py

@@ -12,7 +12,7 @@ class ContentPart(BaseModel):
 
     __content_part_registry: ClassVar[dict[str, type["ContentPart"]]] = {}
 
-    type: Literal["text", "think", "image_url", "audio_url"]
+    type: str
 
     def __init_subclass__(cls, **kwargs: Any) -> None:
         super().__init_subclass__(**kwargs)
@@ -63,28 +63,6 @@ class TextPart(ContentPart):
     text: str
 
 
-class ThinkPart(ContentPart):
-    """
-    >>> ThinkPart(think="I think I need to think about this.").model_dump()
-    {'type': 'think', 'think': 'I think I need to think about this.', 'encrypted': None}
-    """
-
-    type: str = "think"
-    think: str
-    encrypted: str | None = None
-    """Encrypted thinking content, or signature."""
-
-    def merge_in_place(self, other: Any) -> bool:
-        if not isinstance(other, ThinkPart):
-            return False
-        if self.encrypted:
-            return False
-        self.think += other.think
-        if other.encrypted:
-            self.encrypted = other.encrypted
-        return True
-
-
 class ImageURLPart(ContentPart):
     """
     >>> ImageURLPart(image_url="http://example.com/image.jpg").model_dump()
@@ -191,15 +169,6 @@ class Message(BaseModel):
             )
         return self
 
-    @model_serializer(mode="wrap")
-    def serialize(self, handler):
-        data = handler(self)
-        if self.tool_calls is None:
-            data.pop("tool_calls", None)
-        if self.tool_call_id is None:
-            data.pop("tool_call_id", None)
-        return data
-
 
 class AssistantMessageSegment(Message):
     """A message segment from the assistant."""

astrbot/core/agent/runners/tool_loop_agent_runner.py

@@ -13,7 +13,6 @@ from mcp.types import (
 )
 
 from astrbot import logger
-from astrbot.core.agent.message import TextPart, ThinkPart
 from astrbot.core.message.components import Json
 from astrbot.core.message.message_event_result import (
     MessageChain,
@@ -25,10 +24,6 @@ from astrbot.core.provider.entities import (
 )
 from astrbot.core.provider.provider import Provider
 
-from ..context.compressor import ContextCompressor
-from ..context.config import ContextConfig
-from ..context.manager import ContextManager
-from ..context.token_counter import TokenCounter
 from ..hooks import BaseAgentRunHooks
 from ..message import AssistantMessageSegment, Message, ToolCallMessageSegment
 from ..response import AgentResponseData, AgentStats
@@ -51,47 +46,10 @@ class ToolLoopAgentRunner(BaseAgentRunner[TContext]):
         run_context: ContextWrapper[TContext],
         tool_executor: BaseFunctionToolExecutor[TContext],
         agent_hooks: BaseAgentRunHooks[TContext],
-        streaming: bool = False,
-        # enforce max turns, will discard older turns when exceeded BEFORE compression
-        # -1 means no limit
-        enforce_max_turns: int = -1,
-        # llm compressor
-        llm_compress_instruction: str | None = None,
-        llm_compress_keep_recent: int = 0,
-        llm_compress_provider: Provider | None = None,
-        # truncate by turns compressor
-        truncate_turns: int = 1,
-        # customize
-        custom_token_counter: TokenCounter | None = None,
-        custom_compressor: ContextCompressor | None = None,
         **kwargs: T.Any,
     ) -> None:
         self.req = request
-        self.streaming = streaming
-        self.enforce_max_turns = enforce_max_turns
-        self.llm_compress_instruction = llm_compress_instruction
-        self.llm_compress_keep_recent = llm_compress_keep_recent
-        self.llm_compress_provider = llm_compress_provider
-        self.truncate_turns = truncate_turns
-        self.custom_token_counter = custom_token_counter
-        self.custom_compressor = custom_compressor
-        # we will do compress when:
-        # 1. before requesting LLM
-        # TODO: 2. after LLM output a tool call
-        self.context_config = ContextConfig(
-            # <=0 will never do compress
-            max_context_tokens=provider.provider_config.get("max_context_tokens", 0),
-            # enforce max turns before compression
-            enforce_max_turns=self.enforce_max_turns,
-            truncate_turns=self.truncate_turns,
-            llm_compress_instruction=self.llm_compress_instruction,
-            llm_compress_keep_recent=self.llm_compress_keep_recent,
-            llm_compress_provider=self.llm_compress_provider,
-            custom_token_counter=self.custom_token_counter,
-            custom_compressor=self.custom_compressor,
-        )
-        self.context_manager = ContextManager(self.context_config)
-
+        self.streaming = kwargs.get("streaming", False)
         self.provider = provider
         self.final_llm_resp = None
         self._state = AgentState.IDLE
@@ -151,12 +109,6 @@ class ToolLoopAgentRunner(BaseAgentRunner[TContext]):
         self._transition_state(AgentState.RUNNING)
         llm_resp_result = None
 
-        # do truncate and compress
-        token_usage = self.req.conversation.token_usage if self.req.conversation else 0
-        self.run_context.messages = await self.context_manager.process(
-            self.run_context.messages, trusted_token_usage=token_usage
-        )
-
         async for llm_response in self._iter_llm_responses():
             if llm_response.is_chunk:
                 # update ttft
@@ -217,20 +169,13 @@ class ToolLoopAgentRunner(BaseAgentRunner[TContext]):
             self.final_llm_resp = llm_resp
             self._transition_state(AgentState.DONE)
             self.stats.end_time = time.time()
-
             # record the final assistant message
-            parts = []
-            if llm_resp.reasoning_content or llm_resp.reasoning_signature:
-                parts.append(
-                    ThinkPart(
-                        think=llm_resp.reasoning_content,
-                        encrypted=llm_resp.reasoning_signature,
-                    )
-                )
-            parts.append(TextPart(text=llm_resp.completion_text or "*No response*"))
-            self.run_context.messages.append(Message(role="assistant", content=parts))
-
-            # call the on_agent_done hook
+            self.run_context.messages.append(
+                Message(
+                    role="assistant",
+                    content=llm_resp.completion_text or "*No response*",
+                ),
+            )
             try:
                 await self.agent_hooks.on_agent_done(self.run_context, llm_resp)
             except Exception as e:
@@ -269,19 +214,10 @@ class ToolLoopAgentRunner(BaseAgentRunner[TContext]):
                         data=AgentResponseData(chain=result),
                     )
             # 将结果添加到上下文中
-            parts = []
-            if llm_resp.reasoning_content or llm_resp.reasoning_signature:
-                parts.append(
-                    ThinkPart(
-                        think=llm_resp.reasoning_content,
-                        encrypted=llm_resp.reasoning_signature,
-                    )
-                )
-            parts.append(TextPart(text=llm_resp.completion_text or "*No response*"))
             tool_calls_result = ToolCallsResult(
                 tool_calls_info=AssistantMessageSegment(
                     tool_calls=llm_resp.to_openai_to_calls_model(),
-                    content=parts,
+                    content=llm_resp.completion_text,
                 ),
                 tool_calls_result=tool_call_result_blocks,
             )

astrbot/core/astr_agent_hooks.py

@@ -13,12 +13,6 @@ from astrbot.core.star.star_handler import EventType
 class MainAgentHooks(BaseAgentRunHooks[AstrAgentContext]):
     async def on_agent_done(self, run_context, llm_response):
         # 执行事件钩子
-        if llm_response and llm_response.reasoning_content:
-            # we will use this in result_decorate stage to inject reasoning content to chain
-            run_context.context.event.set_extra(
-                "_llm_reasoning_content", llm_response.reasoning_content
-            )
-
         await call_event_hook(
             run_context.context.event,
             EventType.OnLLMResponseEvent,

astrbot/core/backup/__init__.py

@@ -1,26 +0,0 @@
-"""AstrBot 备份与恢复模块
-
-提供数据导出和导入功能，支持用户在服务器迁移时一键备份和恢复所有数据。
-"""
-
-# 从 constants 模块导入共享常量
-from .constants import (
-    BACKUP_MANIFEST_VERSION,
-    KB_METADATA_MODELS,
-    MAIN_DB_MODELS,
-    get_backup_directories,
-)
-
-# 导入导出器和导入器
-from .exporter import AstrBotExporter
-from .importer import AstrBotImporter, ImportPreCheckResult
-
-__all__ = [
-    "AstrBotExporter",
-    "AstrBotImporter",
-    "ImportPreCheckResult",
-    "MAIN_DB_MODELS",
-    "KB_METADATA_MODELS",
-    "get_backup_directories",
-    "BACKUP_MANIFEST_VERSION",
-]

astrbot/core/backup/constants.py

@@ -1,77 +0,0 @@
-"""AstrBot 备份模块共享常量
-
-此文件定义了导出器和导入器共享的常量，确保两端配置一致。
-"""
-
-from sqlmodel import SQLModel
-
-from astrbot.core.db.po import (
-    Attachment,
-    CommandConfig,
-    CommandConflict,
-    ConversationV2,
-    Persona,
-    PlatformMessageHistory,
-    PlatformSession,
-    PlatformStat,
-    Preference,
-)
-from astrbot.core.knowledge_base.models import (
-    KBDocument,
-    KBMedia,
-    KnowledgeBase,
-)
-from astrbot.core.utils.astrbot_path import (
-    get_astrbot_config_path,
-    get_astrbot_plugin_data_path,
-    get_astrbot_plugin_path,
-    get_astrbot_t2i_templates_path,
-    get_astrbot_temp_path,
-    get_astrbot_webchat_path,
-)
-
-# ============================================================
-# 共享常量 - 确保导出和导入端配置一致
-# ============================================================
-
-# 主数据库模型类映射
-MAIN_DB_MODELS: dict[str, type[SQLModel]] = {
-    "platform_stats": PlatformStat,
-    "conversations": ConversationV2,
-    "personas": Persona,
-    "preferences": Preference,
-    "platform_message_history": PlatformMessageHistory,
-    "platform_sessions": PlatformSession,
-    "attachments": Attachment,
-    "command_configs": CommandConfig,
-    "command_conflicts": CommandConflict,
-}
-
-# 知识库元数据模型类映射
-KB_METADATA_MODELS: dict[str, type[SQLModel]] = {
-    "knowledge_bases": KnowledgeBase,
-    "kb_documents": KBDocument,
-    "kb_media": KBMedia,
-}
-
-
-def get_backup_directories() -> dict[str, str]:
-    """获取需要备份的目录列表
-
-    使用 astrbot_path 模块动态获取路径，支持通过环境变量 ASTRBOT_ROOT 自定义根目录。
-
-    Returns:
-        dict: 键为备份文件中的目录名称，值为目录的绝对路径
-    """
-    return {
-        "plugins": get_astrbot_plugin_path(),  # 插件本体
-        "plugin_data": get_astrbot_plugin_data_path(),  # 插件数据
-        "config": get_astrbot_config_path(),  # 配置目录
-        "t2i_templates": get_astrbot_t2i_templates_path(),  # T2I 模板
-        "webchat": get_astrbot_webchat_path(),  # WebChat 数据
-        "temp": get_astrbot_temp_path(),  # 临时文件
-    }
-
-
-# 备份清单版本号
-BACKUP_MANIFEST_VERSION = "1.1"

astrbot/core/backup/exporter.py

@@ -1,477 +0,0 @@
-"""AstrBot 数据导出器
-
-负责将所有数据导出为 ZIP 备份文件。
-导出格式为 JSON，这是数据库无关的方案，支持未来向 MySQL/PostgreSQL 迁移。
-"""
-
-import hashlib
-import json
-import os
-import zipfile
-from datetime import datetime, timezone
-from pathlib import Path
-from typing import TYPE_CHECKING, Any
-
-from sqlalchemy import select
-
-from astrbot.core import logger
-from astrbot.core.config.default import VERSION
-from astrbot.core.db import BaseDatabase
-from astrbot.core.utils.astrbot_path import (
-    get_astrbot_backups_path,
-    get_astrbot_data_path,
-)
-
-# 从共享常量模块导入
-from .constants import (
-    BACKUP_MANIFEST_VERSION,
-    KB_METADATA_MODELS,
-    MAIN_DB_MODELS,
-    get_backup_directories,
-)
-
-if TYPE_CHECKING:
-    from astrbot.core.knowledge_base.kb_mgr import KnowledgeBaseManager
-
-CMD_CONFIG_FILE_PATH = os.path.join(get_astrbot_data_path(), "cmd_config.json")
-
-
-class AstrBotExporter:
-    """AstrBot 数据导出器
-
-    导出内容：
-    - 主数据库所有表（data/data_v4.db）
-    - 知识库元数据（data/knowledge_base/kb.db）
-    - 每个知识库的向量文档数据
-    - 配置文件（data/cmd_config.json）
-    - 附件文件
-    - 知识库多媒体文件
-    - 插件目录（data/plugins）
-    - 插件数据目录（data/plugin_data）
-    - 配置目录（data/config）
-    - T2I 模板目录（data/t2i_templates）
-    - WebChat 数据目录（data/webchat）
-    - 临时文件目录（data/temp）
-    """
-
-    def __init__(
-        self,
-        main_db: BaseDatabase,
-        kb_manager: "KnowledgeBaseManager | None" = None,
-        config_path: str = CMD_CONFIG_FILE_PATH,
-    ):
-        self.main_db = main_db
-        self.kb_manager = kb_manager
-        self.config_path = config_path
-        self._checksums: dict[str, str] = {}
-
-    async def export_all(
-        self,
-        output_dir: str | None = None,
-        progress_callback: Any | None = None,
-    ) -> str:
-        """导出所有数据到 ZIP 文件
-
-        Args:
-            output_dir: 输出目录
-            progress_callback: 进度回调函数，接收参数 (stage, current, total, message)
-
-        Returns:
-            str: 生成的 ZIP 文件路径
-        """
-        if output_dir is None:
-            output_dir = get_astrbot_backups_path()
-
-        # 确保输出目录存在
-        Path(output_dir).mkdir(parents=True, exist_ok=True)
-
-        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
-        zip_filename = f"astrbot_backup_{timestamp}.zip"
-        zip_path = os.path.join(output_dir, zip_filename)
-
-        logger.info(f"开始导出备份到 {zip_path}")
-
-        try:
-            with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zf:
-                # 1. 导出主数据库
-                if progress_callback:
-                    await progress_callback("main_db", 0, 100, "正在导出主数据库...")
-                main_data = await self._export_main_database()
-                main_db_json = json.dumps(
-                    main_data, ensure_ascii=False, indent=2, default=str
-                )
-                zf.writestr("databases/main_db.json", main_db_json)
-                self._add_checksum("databases/main_db.json", main_db_json)
-                if progress_callback:
-                    await progress_callback("main_db", 100, 100, "主数据库导出完成")
-
-                # 2. 导出知识库数据
-                kb_meta_data: dict[str, Any] = {
-                    "knowledge_bases": [],
-                    "kb_documents": [],
-                    "kb_media": [],
-                }
-                if self.kb_manager:
-                    if progress_callback:
-                        await progress_callback(
-                            "kb_metadata", 0, 100, "正在导出知识库元数据..."
-                        )
-                    kb_meta_data = await self._export_kb_metadata()
-                    kb_meta_json = json.dumps(
-                        kb_meta_data, ensure_ascii=False, indent=2, default=str
-                    )
-                    zf.writestr("databases/kb_metadata.json", kb_meta_json)
-                    self._add_checksum("databases/kb_metadata.json", kb_meta_json)
-                    if progress_callback:
-                        await progress_callback(
-                            "kb_metadata", 100, 100, "知识库元数据导出完成"
-                        )
-
-                    # 导出每个知识库的文档数据
-                    kb_insts = self.kb_manager.kb_insts
-                    total_kbs = len(kb_insts)
-                    for idx, (kb_id, kb_helper) in enumerate(kb_insts.items()):
-                        if progress_callback:
-                            await progress_callback(
-                                "kb_documents",
-                                idx,
-                                total_kbs,
-                                f"正在导出知识库 {kb_helper.kb.kb_name} 的文档数据...",
-                            )
-                        doc_data = await self._export_kb_documents(kb_helper)
-                        doc_json = json.dumps(
-                            doc_data, ensure_ascii=False, indent=2, default=str
-                        )
-                        doc_path = f"databases/kb_{kb_id}/documents.json"
-                        zf.writestr(doc_path, doc_json)
-                        self._add_checksum(doc_path, doc_json)
-
-                        # 导出 FAISS 索引文件
-                        await self._export_faiss_index(zf, kb_helper, kb_id)
-
-                        # 导出知识库多媒体文件
-                        await self._export_kb_media_files(zf, kb_helper, kb_id)
-
-                    if progress_callback:
-                        await progress_callback(
-                            "kb_documents", total_kbs, total_kbs, "知识库文档导出完成"
-                        )
-
-                # 3. 导出配置文件
-                if progress_callback:
-                    await progress_callback("config", 0, 100, "正在导出配置文件...")
-                if os.path.exists(self.config_path):
-                    with open(self.config_path, encoding="utf-8") as f:
-                        config_content = f.read()
-                    zf.writestr("config/cmd_config.json", config_content)
-                    self._add_checksum("config/cmd_config.json", config_content)
-                if progress_callback:
-                    await progress_callback("config", 100, 100, "配置文件导出完成")
-
-                # 4. 导出附件文件
-                if progress_callback:
-                    await progress_callback("attachments", 0, 100, "正在导出附件...")
-                await self._export_attachments(zf, main_data.get("attachments", []))
-                if progress_callback:
-                    await progress_callback("attachments", 100, 100, "附件导出完成")
-
-                # 5. 导出插件和其他目录
-                if progress_callback:
-                    await progress_callback(
-                        "directories", 0, 100, "正在导出插件和数据目录..."
-                    )
-                dir_stats = await self._export_directories(zf)
-                if progress_callback:
-                    await progress_callback("directories", 100, 100, "目录导出完成")
-
-                # 6. 生成 manifest
-                if progress_callback:
-                    await progress_callback("manifest", 0, 100, "正在生成清单...")
-                manifest = self._generate_manifest(main_data, kb_meta_data, dir_stats)
-                manifest_json = json.dumps(manifest, ensure_ascii=False, indent=2)
-                zf.writestr("manifest.json", manifest_json)
-                if progress_callback:
-                    await progress_callback("manifest", 100, 100, "清单生成完成")
-
-            logger.info(f"备份导出完成: {zip_path}")
-            return zip_path
-
-        except Exception as e:
-            logger.error(f"备份导出失败: {e}")
-            # 清理失败的文件
-            if os.path.exists(zip_path):
-                os.remove(zip_path)
-            raise
-
-    async def _export_main_database(self) -> dict[str, list[dict]]:
-        """导出主数据库所有表"""
-        export_data: dict[str, list[dict]] = {}
-
-        async with self.main_db.get_db() as session:
-            for table_name, model_class in MAIN_DB_MODELS.items():
-                try:
-                    result = await session.execute(select(model_class))
-                    records = result.scalars().all()
-                    export_data[table_name] = [
-                        self._model_to_dict(record) for record in records
-                    ]
-                    logger.debug(
-                        f"导出表 {table_name}: {len(export_data[table_name])} 条记录"
-                    )
-                except Exception as e:
-                    logger.warning(f"导出表 {table_name} 失败: {e}")
-                    export_data[table_name] = []
-
-        return export_data
-
-    async def _export_kb_metadata(self) -> dict[str, list[dict]]:
-        """导出知识库元数据库"""
-        if not self.kb_manager:
-            return {"knowledge_bases": [], "kb_documents": [], "kb_media": []}
-
-        export_data: dict[str, list[dict]] = {}
-
-        async with self.kb_manager.kb_db.get_db() as session:
-            for table_name, model_class in KB_METADATA_MODELS.items():
-                try:
-                    result = await session.execute(select(model_class))
-                    records = result.scalars().all()
-                    export_data[table_name] = [
-                        self._model_to_dict(record) for record in records
-                    ]
-                    logger.debug(
-                        f"导出知识库表 {table_name}: {len(export_data[table_name])} 条记录"
-                    )
-                except Exception as e:
-                    logger.warning(f"导出知识库表 {table_name} 失败: {e}")
-                    export_data[table_name] = []
-
-        return export_data
-
-    async def _export_kb_documents(self, kb_helper: Any) -> dict[str, Any]:
-        """导出知识库的文档块数据"""
-        try:
-            from astrbot.core.db.vec_db.faiss_impl.vec_db import FaissVecDB
-
-            vec_db: FaissVecDB = kb_helper.vec_db
-            if not vec_db or not vec_db.document_storage:
-                return {"documents": []}
-
-            # 获取所有文档
-            docs = await vec_db.document_storage.get_documents(
-                metadata_filters={},
-                offset=0,
-                limit=None,  # 获取全部
-            )
-
-            return {"documents": docs}
-        except Exception as e:
-            logger.warning(f"导出知识库文档失败: {e}")
-            return {"documents": []}
-
-    async def _export_faiss_index(
-        self,
-        zf: zipfile.ZipFile,
-        kb_helper: Any,
-        kb_id: str,
-    ) -> None:
-        """导出 FAISS 索引文件"""
-        try:
-            index_path = kb_helper.kb_dir / "index.faiss"
-            if index_path.exists():
-                archive_path = f"databases/kb_{kb_id}/index.faiss"
-                zf.write(str(index_path), archive_path)
-                logger.debug(f"导出 FAISS 索引: {archive_path}")
-        except Exception as e:
-            logger.warning(f"导出 FAISS 索引失败: {e}")
-
-    async def _export_kb_media_files(
-        self, zf: zipfile.ZipFile, kb_helper: Any, kb_id: str
-    ) -> None:
-        """导出知识库的多媒体文件"""
-        try:
-            media_dir = kb_helper.kb_medias_dir
-            if not media_dir.exists():
-                return
-
-            for root, _, files in os.walk(media_dir):
-                for file in files:
-                    file_path = Path(root) / file
-                    # 计算相对路径
-                    rel_path = file_path.relative_to(kb_helper.kb_dir)
-                    archive_path = f"files/kb_media/{kb_id}/{rel_path}"
-                    zf.write(str(file_path), archive_path)
-        except Exception as e:
-            logger.warning(f"导出知识库媒体文件失败: {e}")
-
-    async def _export_directories(
-        self, zf: zipfile.ZipFile
-    ) -> dict[str, dict[str, int]]:
-        """导出插件和其他数据目录
-
-        Returns:
-            dict: 每个目录的统计信息 {dir_name: {"files": count, "size": bytes}}
-        """
-        stats: dict[str, dict[str, int]] = {}
-        backup_directories = get_backup_directories()
-
-        for dir_name, dir_path in backup_directories.items():
-            full_path = Path(dir_path)
-            if not full_path.exists():
-                logger.debug(f"目录不存在，跳过: {full_path}")
-                continue
-
-            file_count = 0
-            total_size = 0
-
-            try:
-                for root, dirs, files in os.walk(full_path):
-                    # 跳过 __pycache__ 目录
-                    dirs[:] = [d for d in dirs if d != "__pycache__"]
-
-                    for file in files:
-                        # 跳过 .pyc 文件
-                        if file.endswith(".pyc"):
-                            continue
-
-                        file_path = Path(root) / file
-                        try:
-                            # 计算相对路径
-                            rel_path = file_path.relative_to(full_path)
-                            archive_path = f"directories/{dir_name}/{rel_path}"
-                            zf.write(str(file_path), archive_path)
-                            file_count += 1
-                            total_size += file_path.stat().st_size
-                        except Exception as e:
-                            logger.warning(f"导出文件 {file_path} 失败: {e}")
-
-                stats[dir_name] = {"files": file_count, "size": total_size}
-                logger.debug(
-                    f"导出目录 {dir_name}: {file_count} 个文件, {total_size} 字节"
-                )
-            except Exception as e:
-                logger.warning(f"导出目录 {dir_path} 失败: {e}")
-                stats[dir_name] = {"files": 0, "size": 0}
-
-        return stats
-
-    async def _export_attachments(
-        self, zf: zipfile.ZipFile, attachments: list[dict]
-    ) -> None:
-        """导出附件文件"""
-        for attachment in attachments:
-            try:
-                file_path = attachment.get("path", "")
-                if file_path and os.path.exists(file_path):
-                    # 使用 attachment_id 作为文件名
-                    attachment_id = attachment.get("attachment_id", "")
-                    ext = os.path.splitext(file_path)[1]
-                    archive_path = f"files/attachments/{attachment_id}{ext}"
-                    zf.write(file_path, archive_path)
-            except Exception as e:
-                logger.warning(f"导出附件失败: {e}")
-
-    def _model_to_dict(self, record: Any) -> dict:
-        """将 SQLModel 实例转换为字典
-
-        这是数据库无关的序列化方式，支持未来迁移到其他数据库。
-        """
-        # 使用 SQLModel 内置的 model_dump 方法（如果可用）
-        if hasattr(record, "model_dump"):
-            data = record.model_dump(mode="python")
-            # 处理 datetime 类型
-            for key, value in data.items():
-                if isinstance(value, datetime):
-                    data[key] = value.isoformat()
-            return data
-
-        # 回退到手动提取
-        data = {}
-        # 使用 inspect 获取表信息
-        from sqlalchemy import inspect as sa_inspect
-
-        mapper = sa_inspect(record.__class__)
-        for column in mapper.columns:
-            value = getattr(record, column.name)
-            # 处理 datetime 类型 - 统一转为 ISO 格式字符串
-            if isinstance(value, datetime):
-                value = value.isoformat()
-            data[column.name] = value
-        return data
-
-    def _add_checksum(self, path: str, content: str | bytes) -> None:
-        """计算并添加文件校验和"""
-        if isinstance(content, str):
-            content = content.encode("utf-8")
-        checksum = hashlib.sha256(content).hexdigest()
-        self._checksums[path] = f"sha256:{checksum}"
-
-    def _generate_manifest(
-        self,
-        main_data: dict[str, list[dict]],
-        kb_meta_data: dict[str, list[dict]],
-        dir_stats: dict[str, dict[str, int]] | None = None,
-    ) -> dict:
-        """生成备份清单"""
-        if dir_stats is None:
-            dir_stats = {}
-        # 收集知识库 ID
-        kb_document_tables = {}
-        if self.kb_manager:
-            for kb_id in self.kb_manager.kb_insts.keys():
-                kb_document_tables[kb_id] = "documents"
-
-        # 收集附件文件列表
-        attachment_files = []
-        for attachment in main_data.get("attachments", []):
-            attachment_id = attachment.get("attachment_id", "")
-            path = attachment.get("path", "")
-            if attachment_id and path:
-                ext = os.path.splitext(path)[1]
-                attachment_files.append(f"{attachment_id}{ext}")
-
-        # 收集知识库媒体文件
-        kb_media_files: dict[str, list[str]] = {}
-        if self.kb_manager:
-            for kb_id, kb_helper in self.kb_manager.kb_insts.items():
-                media_files: list[str] = []
-                media_dir = kb_helper.kb_medias_dir
-                if media_dir.exists():
-                    for root, _, files in os.walk(media_dir):
-                        for file in files:
-                            media_files.append(file)
-                if media_files:
-                    kb_media_files[kb_id] = media_files
-
-        manifest = {
-            "version": BACKUP_MANIFEST_VERSION,
-            "astrbot_version": VERSION,
-            "exported_at": datetime.now(timezone.utc).isoformat(),
-            "origin": "exported",  # 标记备份来源：exported=本实例导出, uploaded=用户上传
-            "schema_version": {
-                "main_db": "v4",
-                "kb_db": "v1",
-            },
-            "tables": {
-                "main_db": list(main_data.keys()),
-                "kb_metadata": list(kb_meta_data.keys()),
-                "kb_documents": kb_document_tables,
-            },
-            "files": {
-                "attachments": attachment_files,
-                "kb_media": kb_media_files,
-            },
-            "directories": list(dir_stats.keys()),
-            "checksums": self._checksums,
-            "statistics": {
-                "main_db": {
-                    table: len(records) for table, records in main_data.items()
-                },
-                "kb_metadata": {
-                    table: len(records) for table, records in kb_meta_data.items()
-                },
-                "directories": dir_stats,
-            },
-        }
-
-        return manifest

astrbot/core/backup/importer.py

@@ -1,761 +0,0 @@
-"""AstrBot 数据导入器
-
-负责从 ZIP 备份文件恢复所有数据。
-导入时进行版本校验：
-- 主版本（前两位）不同时直接拒绝导入
-- 小版本（第三位）不同时提示警告，用户可选择强制导入
-- 版本匹配时也需要用户确认
-"""
-
-import json
-import os
-import shutil
-import zipfile
-from dataclasses import dataclass, field
-from datetime import datetime
-from pathlib import Path
-from typing import TYPE_CHECKING, Any
-
-from sqlalchemy import delete
-
-from astrbot.core import logger
-from astrbot.core.config.default import VERSION
-from astrbot.core.db import BaseDatabase
-from astrbot.core.utils.astrbot_path import (
-    get_astrbot_data_path,
-    get_astrbot_knowledge_base_path,
-)
-from astrbot.core.utils.version_comparator import VersionComparator
-
-# 从共享常量模块导入
-from .constants import (
-    KB_METADATA_MODELS,
-    MAIN_DB_MODELS,
-    get_backup_directories,
-)
-
-if TYPE_CHECKING:
-    from astrbot.core.knowledge_base.kb_mgr import KnowledgeBaseManager
-
-
-def _get_major_version(version_str: str) -> str:
-    """提取版本的主版本部分（前两位）
-
-    Args:
-        version_str: 版本字符串，如 "4.9.1", "4.10.0-beta"
-
-    Returns:
-        主版本字符串，如 "4.9", "4.10"
-    """
-    if not version_str:
-        return "0.0"
-    # 移除 v 前缀和预发布标签
-    version = version_str.lower().replace("v", "").split("-")[0].split("+")[0]
-    parts = [p for p in version.split(".") if p]  # 过滤空字符串
-    if len(parts) >= 2:
-        return f"{parts[0]}.{parts[1]}"
-    elif len(parts) == 1 and parts[0]:
-        return f"{parts[0]}.0"
-    return "0.0"
-
-
-CMD_CONFIG_FILE_PATH = os.path.join(get_astrbot_data_path(), "cmd_config.json")
-KB_PATH = get_astrbot_knowledge_base_path()
-
-
-@dataclass
-class ImportPreCheckResult:
-    """导入预检查结果
-
-    用于在实际导入前检查备份文件的版本兼容性，
-    并返回确认信息让用户决定是否继续导入。
-    """
-
-    # 检查是否通过（文件有效且版本可导入）
-    valid: bool = False
-    # 是否可以导入（版本兼容）
-    can_import: bool = False
-    # 版本状态: match（完全匹配）, minor_diff（小版本差异）, major_diff（主版本不同，拒绝）
-    version_status: str = ""
-    # 备份文件中的 AstrBot 版本
-    backup_version: str = ""
-    # 当前运行的 AstrBot 版本
-    current_version: str = VERSION
-    # 备份创建时间
-    backup_time: str = ""
-    # 确认消息（显示给用户）
-    confirm_message: str = ""
-    # 警告消息列表
-    warnings: list[str] = field(default_factory=list)
-    # 错误消息（如果检查失败）
-    error: str = ""
-    # 备份包含的内容摘要
-    backup_summary: dict = field(default_factory=dict)
-
-    def to_dict(self) -> dict:
-        return {
-            "valid": self.valid,
-            "can_import": self.can_import,
-            "version_status": self.version_status,
-            "backup_version": self.backup_version,
-            "current_version": self.current_version,
-            "backup_time": self.backup_time,
-            "confirm_message": self.confirm_message,
-            "warnings": self.warnings,
-            "error": self.error,
-            "backup_summary": self.backup_summary,
-        }
-
-
-class ImportResult:
-    """导入结果"""
-
-    def __init__(self):
-        self.success = True
-        self.imported_tables: dict[str, int] = {}
-        self.imported_files: dict[str, int] = {}
-        self.imported_directories: dict[str, int] = {}
-        self.warnings: list[str] = []
-        self.errors: list[str] = []
-
-    def add_warning(self, msg: str) -> None:
-        self.warnings.append(msg)
-        logger.warning(msg)
-
-    def add_error(self, msg: str) -> None:
-        self.errors.append(msg)
-        self.success = False
-        logger.error(msg)
-
-    def to_dict(self) -> dict:
-        return {
-            "success": self.success,
-            "imported_tables": self.imported_tables,
-            "imported_files": self.imported_files,
-            "imported_directories": self.imported_directories,
-            "warnings": self.warnings,
-            "errors": self.errors,
-        }
-
-
-class AstrBotImporter:
-    """AstrBot 数据导入器
-
-    导入备份文件中的所有数据，包括：
-    - 主数据库所有表
-    - 知识库元数据和文档
-    - 配置文件
-    - 附件文件
-    - 知识库多媒体文件
-    - 插件目录（data/plugins）
-    - 插件数据目录（data/plugin_data）
-    - 配置目录（data/config）
-    - T2I 模板目录（data/t2i_templates）
-    - WebChat 数据目录（data/webchat）
-    - 临时文件目录（data/temp）
-    """
-
-    def __init__(
-        self,
-        main_db: BaseDatabase,
-        kb_manager: "KnowledgeBaseManager | None" = None,
-        config_path: str = CMD_CONFIG_FILE_PATH,
-        kb_root_dir: str = KB_PATH,
-    ):
-        self.main_db = main_db
-        self.kb_manager = kb_manager
-        self.config_path = config_path
-        self.kb_root_dir = kb_root_dir
-
-    def pre_check(self, zip_path: str) -> ImportPreCheckResult:
-        """预检查备份文件
-
-        在实际导入前检查备份文件的有效性和版本兼容性。
-        返回检查结果供前端显示确认对话框。
-
-        Args:
-            zip_path: ZIP 备份文件路径
-
-        Returns:
-            ImportPreCheckResult: 预检查结果
-        """
-        result = ImportPreCheckResult()
-        result.current_version = VERSION
-
-        if not os.path.exists(zip_path):
-            result.error = f"备份文件不存在: {zip_path}"
-            return result
-
-        try:
-            with zipfile.ZipFile(zip_path, "r") as zf:
-                # 读取 manifest
-                try:
-                    manifest_data = zf.read("manifest.json")
-                    manifest = json.loads(manifest_data)
-                except KeyError:
-                    result.error = "备份文件缺少 manifest.json，不是有效的 AstrBot 备份"
-                    return result
-                except json.JSONDecodeError as e:
-                    result.error = f"manifest.json 格式错误: {e}"
-                    return result
-
-                # 提取基本信息
-                result.backup_version = manifest.get("astrbot_version", "未知")
-                result.backup_time = manifest.get("exported_at", "未知")
-                result.valid = True
-
-                # 构建备份摘要
-                result.backup_summary = {
-                    "tables": list(manifest.get("tables", {}).keys()),
-                    "has_knowledge_bases": manifest.get("has_knowledge_bases", False),
-                    "has_config": manifest.get("has_config", False),
-                    "directories": manifest.get("directories", []),
-                }
-
-                # 检查版本兼容性
-                version_check = self._check_version_compatibility(result.backup_version)
-                result.version_status = version_check["status"]
-                result.can_import = version_check["can_import"]
-
-                # 版本信息由前端根据 version_status 和 i18n 生成显示
-                # 不再将版本消息添加到 warnings 列表中，避免中文硬编码
-                # warnings 列表保留用于其他非版本相关的警告
-
-                return result
-
-        except zipfile.BadZipFile:
-            result.error = "无效的 ZIP 文件"
-            return result
-        except Exception as e:
-            result.error = f"检查备份文件失败: {e}"
-            return result
-
-    def _check_version_compatibility(self, backup_version: str) -> dict:
-        """检查版本兼容性
-
-        规则：
-        - 主版本（前两位，如 4.9）必须一致，否则拒绝
-        - 小版本（第三位，如 4.9.1 vs 4.9.2）不同时，警告但允许导入
-
-        Returns:
-            dict: {status, can_import, message}
-        """
-        if not backup_version:
-            return {
-                "status": "major_diff",
-                "can_import": False,
-                "message": "备份文件缺少版本信息",
-            }
-
-        # 提取主版本（前两位）进行比较
-        backup_major = _get_major_version(backup_version)
-        current_major = _get_major_version(VERSION)
-
-        # 比较主版本
-        if VersionComparator.compare_version(backup_major, current_major) != 0:
-            return {
-                "status": "major_diff",
-                "can_import": False,
-                "message": (
-                    f"主版本不兼容: 备份版本 {backup_version}, 当前版本 {VERSION}。"
-                    f"跨主版本导入可能导致数据损坏，请使用相同主版本的 AstrBot。"
-                ),
-            }
-
-        # 比较完整版本
-        version_cmp = VersionComparator.compare_version(backup_version, VERSION)
-        if version_cmp != 0:
-            return {
-                "status": "minor_diff",
-                "can_import": True,
-                "message": (
-                    f"小版本差异: 备份版本 {backup_version}, 当前版本 {VERSION}。"
-                ),
-            }
-
-        return {
-            "status": "match",
-            "can_import": True,
-            "message": "版本匹配",
-        }
-
-    async def import_all(
-        self,
-        zip_path: str,
-        mode: str = "replace",  # "replace" 清空后导入
-        progress_callback: Any | None = None,
-    ) -> ImportResult:
-        """从 ZIP 文件导入所有数据
-
-        Args:
-            zip_path: ZIP 备份文件路径
-            mode: 导入模式，目前仅支持 "replace"（清空后导入）
-            progress_callback: 进度回调函数，接收参数 (stage, current, total, message)
-
-        Returns:
-            ImportResult: 导入结果
-        """
-        result = ImportResult()
-
-        if not os.path.exists(zip_path):
-            result.add_error(f"备份文件不存在: {zip_path}")
-            return result
-
-        logger.info(f"开始从 {zip_path} 导入备份")
-
-        try:
-            with zipfile.ZipFile(zip_path, "r") as zf:
-                # 1. 读取并验证 manifest
-                if progress_callback:
-                    await progress_callback("validate", 0, 100, "正在验证备份文件...")
-
-                try:
-                    manifest_data = zf.read("manifest.json")
-                    manifest = json.loads(manifest_data)
-                except KeyError:
-                    result.add_error("备份文件缺少 manifest.json")
-                    return result
-                except json.JSONDecodeError as e:
-                    result.add_error(f"manifest.json 格式错误: {e}")
-                    return result
-
-                # 版本校验
-                try:
-                    self._validate_version(manifest)
-                except ValueError as e:
-                    result.add_error(str(e))
-                    return result
-
-                if progress_callback:
-                    await progress_callback("validate", 100, 100, "验证完成")
-
-                # 2. 导入主数据库
-                if progress_callback:
-                    await progress_callback("main_db", 0, 100, "正在导入主数据库...")
-
-                try:
-                    main_data_content = zf.read("databases/main_db.json")
-                    main_data = json.loads(main_data_content)
-
-                    if mode == "replace":
-                        await self._clear_main_db()
-
-                    imported = await self._import_main_database(main_data)
-                    result.imported_tables.update(imported)
-                except Exception as e:
-                    result.add_error(f"导入主数据库失败: {e}")
-                    return result
-
-                if progress_callback:
-                    await progress_callback("main_db", 100, 100, "主数据库导入完成")
-
-                # 3. 导入知识库
-                if self.kb_manager and "databases/kb_metadata.json" in zf.namelist():
-                    if progress_callback:
-                        await progress_callback("kb", 0, 100, "正在导入知识库...")
-
-                    try:
-                        kb_meta_content = zf.read("databases/kb_metadata.json")
-                        kb_meta_data = json.loads(kb_meta_content)
-
-                        if mode == "replace":
-                            await self._clear_kb_data()
-
-                        await self._import_knowledge_bases(zf, kb_meta_data, result)
-                    except Exception as e:
-                        result.add_warning(f"导入知识库失败: {e}")
-
-                    if progress_callback:
-                        await progress_callback("kb", 100, 100, "知识库导入完成")
-
-                # 4. 导入配置文件
-                if progress_callback:
-                    await progress_callback("config", 0, 100, "正在导入配置文件...")
-
-                if "config/cmd_config.json" in zf.namelist():
-                    try:
-                        config_content = zf.read("config/cmd_config.json")
-                        # 备份现有配置
-                        if os.path.exists(self.config_path):
-                            backup_path = f"{self.config_path}.bak"
-                            shutil.copy2(self.config_path, backup_path)
-
-                        with open(self.config_path, "wb") as f:
-                            f.write(config_content)
-                        result.imported_files["config"] = 1
-                    except Exception as e:
-                        result.add_warning(f"导入配置文件失败: {e}")
-
-                if progress_callback:
-                    await progress_callback("config", 100, 100, "配置文件导入完成")
-
-                # 5. 导入附件文件
-                if progress_callback:
-                    await progress_callback("attachments", 0, 100, "正在导入附件...")
-
-                attachment_count = await self._import_attachments(
-                    zf, main_data.get("attachments", [])
-                )
-                result.imported_files["attachments"] = attachment_count
-
-                if progress_callback:
-                    await progress_callback("attachments", 100, 100, "附件导入完成")
-
-                # 6. 导入插件和其他目录
-                if progress_callback:
-                    await progress_callback(
-                        "directories", 0, 100, "正在导入插件和数据目录..."
-                    )
-
-                dir_stats = await self._import_directories(zf, manifest, result)
-                result.imported_directories = dir_stats
-
-                if progress_callback:
-                    await progress_callback("directories", 100, 100, "目录导入完成")
-
-            logger.info(f"备份导入完成: {result.to_dict()}")
-            return result
-
-        except zipfile.BadZipFile:
-            result.add_error("无效的 ZIP 文件")
-            return result
-        except Exception as e:
-            result.add_error(f"导入失败: {e}")
-            return result
-
-    def _validate_version(self, manifest: dict) -> None:
-        """验证版本兼容性 - 仅允许相同主版本导入
-
-        注意：此方法仅在 import_all 中调用，用于双重校验。
-        前端应先调用 pre_check 获取详细的版本信息并让用户确认。
-        """
-        backup_version = manifest.get("astrbot_version")
-        if not backup_version:
-            raise ValueError("备份文件缺少版本信息")
-
-        # 使用新的版本兼容性检查
-        version_check = self._check_version_compatibility(backup_version)
-
-        if version_check["status"] == "major_diff":
-            raise ValueError(version_check["message"])
-
-        # minor_diff 和 match 都允许导入
-        if version_check["status"] == "minor_diff":
-            logger.warning(f"版本差异警告: {version_check['message']}")
-
-    async def _clear_main_db(self) -> None:
-        """清空主数据库所有表"""
-        async with self.main_db.get_db() as session:
-            async with session.begin():
-                for table_name, model_class in MAIN_DB_MODELS.items():
-                    try:
-                        await session.execute(delete(model_class))
-                        logger.debug(f"已清空表 {table_name}")
-                    except Exception as e:
-                        logger.warning(f"清空表 {table_name} 失败: {e}")
-
-    async def _clear_kb_data(self) -> None:
-        """清空知识库数据"""
-        if not self.kb_manager:
-            return
-
-        # 清空知识库元数据表
-        async with self.kb_manager.kb_db.get_db() as session:
-            async with session.begin():
-                for table_name, model_class in KB_METADATA_MODELS.items():
-                    try:
-                        await session.execute(delete(model_class))
-                        logger.debug(f"已清空知识库表 {table_name}")
-                    except Exception as e:
-                        logger.warning(f"清空知识库表 {table_name} 失败: {e}")
-
-        # 删除知识库文件目录
-        for kb_id in list(self.kb_manager.kb_insts.keys()):
-            try:
-                kb_helper = self.kb_manager.kb_insts[kb_id]
-                await kb_helper.terminate()
-                if kb_helper.kb_dir.exists():
-                    shutil.rmtree(kb_helper.kb_dir)
-            except Exception as e:
-                logger.warning(f"清理知识库 {kb_id} 失败: {e}")
-
-        self.kb_manager.kb_insts.clear()
-
-    async def _import_main_database(
-        self, data: dict[str, list[dict]]
-    ) -> dict[str, int]:
-        """导入主数据库数据"""
-        imported: dict[str, int] = {}
-
-        async with self.main_db.get_db() as session:
-            async with session.begin():
-                for table_name, rows in data.items():
-                    model_class = MAIN_DB_MODELS.get(table_name)
-                    if not model_class:
-                        logger.warning(f"未知的表: {table_name}")
-                        continue
-
-                    count = 0
-                    for row in rows:
-                        try:
-                            # 转换 datetime 字符串为 datetime 对象
-                            row = self._convert_datetime_fields(row, model_class)
-                            obj = model_class(**row)
-                            session.add(obj)
-                            count += 1
-                        except Exception as e:
-                            logger.warning(f"导入记录到 {table_name} 失败: {e}")
-
-                    imported[table_name] = count
-                    logger.debug(f"导入表 {table_name}: {count} 条记录")
-
-        return imported
-
-    async def _import_knowledge_bases(
-        self,
-        zf: zipfile.ZipFile,
-        kb_meta_data: dict[str, list[dict]],
-        result: ImportResult,
-    ) -> None:
-        """导入知识库数据"""
-        if not self.kb_manager:
-            return
-
-        # 1. 导入知识库元数据
-        async with self.kb_manager.kb_db.get_db() as session:
-            async with session.begin():
-                for table_name, rows in kb_meta_data.items():
-                    model_class = KB_METADATA_MODELS.get(table_name)
-                    if not model_class:
-                        continue
-
-                    count = 0
-                    for row in rows:
-                        try:
-                            row = self._convert_datetime_fields(row, model_class)
-                            obj = model_class(**row)
-                            session.add(obj)
-                            count += 1
-                        except Exception as e:
-                            logger.warning(f"导入知识库记录到 {table_name} 失败: {e}")
-
-                    result.imported_tables[f"kb_{table_name}"] = count
-
-        # 2. 导入每个知识库的文档和文件
-        for kb_data in kb_meta_data.get("knowledge_bases", []):
-            kb_id = kb_data.get("kb_id")
-            if not kb_id:
-                continue
-
-            # 创建知识库目录
-            kb_dir = Path(self.kb_root_dir) / kb_id
-            kb_dir.mkdir(parents=True, exist_ok=True)
-
-            # 导入文档数据
-            doc_path = f"databases/kb_{kb_id}/documents.json"
-            if doc_path in zf.namelist():
-                try:
-                    doc_content = zf.read(doc_path)
-                    doc_data = json.loads(doc_content)
-
-                    # 导入到文档存储数据库
-                    await self._import_kb_documents(kb_id, doc_data)
-                except Exception as e:
-                    result.add_warning(f"导入知识库 {kb_id} 的文档失败: {e}")
-
-            # 导入 FAISS 索引
-            faiss_path = f"databases/kb_{kb_id}/index.faiss"
-            if faiss_path in zf.namelist():
-                try:
-                    target_path = kb_dir / "index.faiss"
-                    with zf.open(faiss_path) as src, open(target_path, "wb") as dst:
-                        dst.write(src.read())
-                except Exception as e:
-                    result.add_warning(f"导入知识库 {kb_id} 的 FAISS 索引失败: {e}")
-
-            # 导入媒体文件
-            media_prefix = f"files/kb_media/{kb_id}/"
-            for name in zf.namelist():
-                if name.startswith(media_prefix):
-                    try:
-                        rel_path = name[len(media_prefix) :]
-                        target_path = kb_dir / rel_path
-                        target_path.parent.mkdir(parents=True, exist_ok=True)
-                        with zf.open(name) as src, open(target_path, "wb") as dst:
-                            dst.write(src.read())
-                    except Exception as e:
-                        result.add_warning(f"导入媒体文件 {name} 失败: {e}")
-
-        # 3. 重新加载知识库实例
-        await self.kb_manager.load_kbs()
-
-    async def _import_kb_documents(self, kb_id: str, doc_data: dict) -> None:
-        """导入知识库文档到向量数据库"""
-        from astrbot.core.db.vec_db.faiss_impl.document_storage import DocumentStorage
-
-        kb_dir = Path(self.kb_root_dir) / kb_id
-        doc_db_path = kb_dir / "doc.db"
-
-        # 初始化文档存储
-        doc_storage = DocumentStorage(str(doc_db_path))
-        await doc_storage.initialize()
-
-        try:
-            documents = doc_data.get("documents", [])
-            for doc in documents:
-                try:
-                    await doc_storage.insert_document(
-                        doc_id=doc.get("doc_id", ""),
-                        text=doc.get("text", ""),
-                        metadata=json.loads(doc.get("metadata", "{}")),
-                    )
-                except Exception as e:
-                    logger.warning(f"导入文档块失败: {e}")
-        finally:
-            await doc_storage.close()
-
-    async def _import_attachments(
-        self,
-        zf: zipfile.ZipFile,
-        attachments: list[dict],
-    ) -> int:
-        """导入附件文件"""
-        count = 0
-
-        attachments_dir = Path(self.config_path).parent / "attachments"
-        attachments_dir.mkdir(parents=True, exist_ok=True)
-
-        attachment_prefix = "files/attachments/"
-        for name in zf.namelist():
-            if name.startswith(attachment_prefix) and name != attachment_prefix:
-                try:
-                    # 从附件记录中找到原始路径
-                    attachment_id = os.path.splitext(os.path.basename(name))[0]
-                    original_path = None
-                    for att in attachments:
-                        if att.get("attachment_id") == attachment_id:
-                            original_path = att.get("path")
-                            break
-
-                    if original_path:
-                        target_path = Path(original_path)
-                    else:
-                        target_path = attachments_dir / os.path.basename(name)
-
-                    target_path.parent.mkdir(parents=True, exist_ok=True)
-                    with zf.open(name) as src, open(target_path, "wb") as dst:
-                        dst.write(src.read())
-                    count += 1
-                except Exception as e:
-                    logger.warning(f"导入附件 {name} 失败: {e}")
-
-        return count
-
-    async def _import_directories(
-        self,
-        zf: zipfile.ZipFile,
-        manifest: dict,
-        result: ImportResult,
-    ) -> dict[str, int]:
-        """导入插件和其他数据目录
-
-        Args:
-            zf: ZIP 文件对象
-            manifest: 备份清单
-            result: 导入结果对象
-
-        Returns:
-            dict: 每个目录导入的文件数量
-        """
-        dir_stats: dict[str, int] = {}
-
-        # 检查备份版本是否支持目录备份（需要版本 >= 1.1）
-        backup_version = manifest.get("version", "1.0")
-        if VersionComparator.compare_version(backup_version, "1.1") < 0:
-            logger.info("备份版本不支持目录备份，跳过目录导入")
-            return dir_stats
-
-        backed_up_dirs = manifest.get("directories", [])
-        backup_directories = get_backup_directories()
-
-        for dir_name in backed_up_dirs:
-            if dir_name not in backup_directories:
-                result.add_warning(f"未知的目录类型: {dir_name}")
-                continue
-
-            target_dir = Path(backup_directories[dir_name])
-            archive_prefix = f"directories/{dir_name}/"
-
-            file_count = 0
-
-            try:
-                # 获取该目录下的所有文件
-                dir_files = [
-                    name
-                    for name in zf.namelist()
-                    if name.startswith(archive_prefix) and name != archive_prefix
-                ]
-
-                if not dir_files:
-                    continue
-
-                # 备份现有目录（如果存在）
-                if target_dir.exists():
-                    backup_path = Path(f"{target_dir}.bak")
-                    if backup_path.exists():
-                        shutil.rmtree(backup_path)
-                    shutil.move(str(target_dir), str(backup_path))
-                    logger.debug(f"已备份现有目录 {target_dir} 到 {backup_path}")
-
-                # 创建目标目录
-                target_dir.mkdir(parents=True, exist_ok=True)
-
-                # 解压文件
-                for name in dir_files:
-                    try:
-                        # 计算相对路径
-                        rel_path = name[len(archive_prefix) :]
-                        if not rel_path:  # 跳过目录条目
-                            continue
-
-                        target_path = target_dir / rel_path
-                        target_path.parent.mkdir(parents=True, exist_ok=True)
-
-                        with zf.open(name) as src, open(target_path, "wb") as dst:
-                            dst.write(src.read())
-                        file_count += 1
-                    except Exception as e:
-                        result.add_warning(f"导入文件 {name} 失败: {e}")
-
-                dir_stats[dir_name] = file_count
-                logger.debug(f"导入目录 {dir_name}: {file_count} 个文件")
-
-            except Exception as e:
-                result.add_warning(f"导入目录 {dir_name} 失败: {e}")
-                dir_stats[dir_name] = 0
-
-        return dir_stats
-
-    def _convert_datetime_fields(self, row: dict, model_class: type) -> dict:
-        """转换 datetime 字符串字段为 datetime 对象"""
-        result = row.copy()
-
-        # 获取模型的 datetime 字段
-        from sqlalchemy import inspect as sa_inspect
-
-        try:
-            mapper = sa_inspect(model_class)
-            for column in mapper.columns:
-                if column.name in result and result[column.name] is not None:
-                    # 检查是否是 datetime 类型的列
-                    from sqlalchemy import DateTime
-
-                    if isinstance(column.type, DateTime):
-                        value = result[column.name]
-                        if isinstance(value, str):
-                            # 解析 ISO 格式的日期时间字符串
-                            result[column.name] = datetime.fromisoformat(value)
-        except Exception:
-            pass
-
-        return result

astrbot/core/config/astrbot_config.py

@@ -80,8 +80,6 @@ class AstrBotConfig(dict):
                 if v["type"] == "object":
                     conf[k] = {}
                     _parse_schema(v["items"], conf[k])
-                elif v["type"] == "template_list":
-                    conf[k] = default
                 else:
                     conf[k] = default
 

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.2"
+VERSION = "4.10.2"
 DB_PATH = os.path.join(get_astrbot_data_path(), "data_v4.db")
 
 WEBHOOK_SUPPORTED_PLATFORMS = [
@@ -83,16 +83,6 @@ DEFAULT_CONFIG = {
         "default_personality": "default",
         "persona_pool": ["*"],
         "prompt_prefix": "{{prompt}}",
-        "context_limit_reached_strategy": "truncate_by_turns",  # or llm_compress
-        "llm_compress_instruction": (
-            "Based on our full conversation history, produce a concise summary of key takeaways and/or project progress.\n"
-            "1. Systematically cover all core topics discussed and the final conclusion/outcome for each; clearly highlight the latest primary focus.\n"
-            "2. If any tools were used, summarize tool usage (total call count) and extract the most valuable insights from tool outputs.\n"
-            "3. If there was an initial user goal, state it first and describe the current progress/status.\n"
-            "4. Write the summary in the user's language.\n"
-        ),
-        "llm_compress_keep_recent": 4,
-        "llm_compress_provider_id": "",
         "max_context_length": -1,
         "dequeue_context_length": 1,
         "streaming_response": False,
@@ -189,7 +179,6 @@ class ChatProviderTemplate(TypedDict):
     model: str
     modalities: list
     custom_extra_body: dict[str, Any]
-    max_context_tokens: int
 
 
 CHAT_PROVIDER_TEMPLATE = {
@@ -198,7 +187,6 @@ CHAT_PROVIDER_TEMPLATE = {
     "model": "",
     "modalities": [],
     "custom_extra_body": {},
-    "max_context_tokens": 0,
 }
 
 """
@@ -239,7 +227,7 @@ CONFIG_METADATA_2 = {
                         "callback_server_host": "0.0.0.0",
                         "port": 6196,
                     },
-                    "OneBot v11 (QQ 个人号等)": {
+                    "OneBot v11": {
                         "id": "default",
                         "type": "aiocqhttp",
                         "enable": False,
@@ -247,6 +235,16 @@ CONFIG_METADATA_2 = {
                         "ws_reverse_port": 6199,
                         "ws_reverse_token": "",
                     },
+                    "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,
+                    },
                     "微信公众平台": {
                         "id": "weixin_official_account",
                         "type": "weixin_official_account",
@@ -907,7 +905,6 @@ CONFIG_METADATA_2 = {
                         "key": [],
                         "api_base": "https://api.anthropic.com/v1",
                         "timeout": 120,
-                        "anth_thinking_config": {"budget": 0},
                     },
                     "Moonshot": {
                         "id": "moonshot",
@@ -923,7 +920,7 @@ CONFIG_METADATA_2 = {
                     "xAI": {
                         "id": "xai",
                         "provider": "xai",
-                        "type": "xai_chat_completion",
+                        "type": "openai_chat_completion",
                         "provider_type": "chat_completion",
                         "enable": True,
                         "key": [],
@@ -1289,7 +1286,7 @@ CONFIG_METADATA_2 = {
                         "minimax-is-timber-weight": False,
                         "minimax-voice-id": "female-shaonv",
                         "minimax-timber-weight": '[\n    {\n        "voice_id": "Chinese (Mandarin)_Warm_Girl",\n        "weight": 25\n    },\n    {\n        "voice_id": "Chinese (Mandarin)_BashfulGirl",\n        "weight": 50\n    }\n]',
-                        "minimax-voice-emotion": "auto",
+                        "minimax-voice-emotion": "neutral",
                         "minimax-voice-latex": False,
                         "minimax-voice-english-normalization": False,
                         "timeout": 20,
@@ -1453,32 +1450,7 @@ CONFIG_METADATA_2 = {
                         "description": "自定义请求体参数",
                         "type": "dict",
                         "items": {},
-                        "hint": "用于在请求时添加额外的参数，如 temperature、top_p、max_tokens 等。",
-                        "template_schema": {
-                            "temperature": {
-                                "name": "Temperature",
-                                "description": "温度参数",
-                                "hint": "控制输出的随机性，范围通常为 0-2。值越高越随机。",
-                                "type": "float",
-                                "default": 0.6,
-                                "slider": {"min": 0, "max": 2, "step": 0.1},
-                            },
-                            "top_p": {
-                                "name": "Top-p",
-                                "description": "Top-p 采样",
-                                "hint": "核采样参数，范围通常为 0-1。控制模型考虑的概率质量。",
-                                "type": "float",
-                                "default": 1.0,
-                                "slider": {"min": 0, "max": 1, "step": 0.01},
-                            },
-                            "max_tokens": {
-                                "name": "Max Tokens",
-                                "description": "最大令牌数",
-                                "hint": "生成的最大令牌数。",
-                                "type": "int",
-                                "default": 8192,
-                            },
-                        },
+                        "hint": "此处添加的键值对将被合并到发送给 API 的 extra_body 中。值可以是字符串、数字或布尔值。",
                     },
                     "provider": {
                         "type": "string",
@@ -1815,17 +1787,6 @@ CONFIG_METADATA_2 = {
                             },
                         },
                     },
-                    "anth_thinking_config": {
-                        "description": "Thinking Config",
-                        "type": "object",
-                        "items": {
-                            "budget": {
-                                "description": "Thinking Budget",
-                                "type": "int",
-                                "hint": "Anthropic thinking.budget_tokens param. Must >= 1024. See: https://platform.claude.com/docs/en/build-with-claude/extended-thinking",
-                            },
-                        },
-                    },
                     "minimax-group-id": {
                         "type": "string",
                         "description": "用户组",
@@ -1897,18 +1858,15 @@ CONFIG_METADATA_2 = {
                     "minimax-voice-emotion": {
                         "type": "string",
                         "description": "情绪",
-                        "hint": "控制合成语音的情绪。当为 auto 时，将根据文本内容自动选择情绪。",
+                        "hint": "控制合成语音的情绪",
                         "options": [
-                            "auto",
                             "happy",
                             "sad",
                             "angry",
                             "fearful",
                             "disgusted",
                             "surprised",
-                            "calm",
-                            "fluent",
-                            "whisper",
+                            "neutral",
                         ],
                     },
                     "minimax-voice-latex": {
@@ -2035,11 +1993,6 @@ CONFIG_METADATA_2 = {
                         "type": "string",
                         "hint": "模型名称，如 gpt-4o-mini, deepseek-chat。",
                     },
-                    "max_context_tokens": {
-                        "description": "模型上下文窗口大小",
-                        "type": "int",
-                        "hint": "模型最大上下文 Token 大小。如果为 0，则会自动从模型元数据填充（如有），也可手动修改。",
-                    },
                     "dify_api_key": {
                         "description": "API Key",
                         "type": "string",
@@ -2547,66 +2500,6 @@ CONFIG_METADATA_3 = {
             #         "provider_settings.enable": True,
             #     },
             # },
-            "truncate_and_compress": {
-                "description": "上下文管理策略",
-                "type": "object",
-                "items": {
-                    "provider_settings.max_context_length": {
-                        "description": "最多携带对话轮数",
-                        "type": "int",
-                        "hint": "超出这个数量时丢弃最旧的部分，一轮聊天记为 1 条，-1 为不限制",
-                        "condition": {
-                            "provider_settings.agent_runner_type": "local",
-                        },
-                    },
-                    "provider_settings.dequeue_context_length": {
-                        "description": "丢弃对话轮数",
-                        "type": "int",
-                        "hint": "超出最多携带对话轮数时, 一次丢弃的聊天轮数",
-                        "condition": {
-                            "provider_settings.agent_runner_type": "local",
-                        },
-                    },
-                    "provider_settings.context_limit_reached_strategy": {
-                        "description": "超出模型上下文窗口时的处理方式",
-                        "type": "string",
-                        "options": ["truncate_by_turns", "llm_compress"],
-                        "labels": ["按对话轮数截断", "由 LLM 压缩上下文"],
-                        "condition": {
-                            "provider_settings.agent_runner_type": "local",
-                        },
-                        "hint": "",
-                    },
-                    "provider_settings.llm_compress_instruction": {
-                        "description": "上下文压缩提示词",
-                        "type": "text",
-                        "hint": "如果为空则使用默认提示词。",
-                        "condition": {
-                            "provider_settings.context_limit_reached_strategy": "llm_compress",
-                            "provider_settings.agent_runner_type": "local",
-                        },
-                    },
-                    "provider_settings.llm_compress_keep_recent": {
-                        "description": "压缩时保留最近对话轮数",
-                        "type": "int",
-                        "hint": "始终保留的最近 N 轮对话。",
-                        "condition": {
-                            "provider_settings.context_limit_reached_strategy": "llm_compress",
-                            "provider_settings.agent_runner_type": "local",
-                        },
-                    },
-                    "provider_settings.llm_compress_provider_id": {
-                        "description": "用于上下文压缩的模型提供商 ID",
-                        "type": "string",
-                        "_special": "select_provider",
-                        "hint": "留空时将降级为“按对话轮数截断”的策略。",
-                        "condition": {
-                            "provider_settings.context_limit_reached_strategy": "llm_compress",
-                            "provider_settings.agent_runner_type": "local",
-                        },
-                    },
-                },
-            },
             "others": {
                 "description": "其他配置",
                 "type": "object",
@@ -2671,6 +2564,22 @@ CONFIG_METADATA_3 = {
                             "provider_settings.streaming_response": True,
                         },
                     },
+                    "provider_settings.max_context_length": {
+                        "description": "最多携带对话轮数",
+                        "type": "int",
+                        "hint": "超出这个数量时丢弃最旧的部分，一轮聊天记为 1 条，-1 为不限制",
+                        "condition": {
+                            "provider_settings.agent_runner_type": "local",
+                        },
+                    },
+                    "provider_settings.dequeue_context_length": {
+                        "description": "丢弃对话轮数",
+                        "type": "int",
+                        "hint": "超出最多携带对话轮数时, 一次丢弃的聊天轮数",
+                        "condition": {
+                            "provider_settings.agent_runner_type": "local",
+                        },
+                    },
                     "provider_settings.wake_prefix": {
                         "description": "LLM 聊天额外唤醒前缀 ",
                         "type": "string",
@@ -3140,5 +3049,4 @@ DEFAULT_VALUE_MAP = {
     "text": "",
     "list": [],
     "object": {},
-    "template_list": [],
 }

astrbot/core/conversation_mgr.py

@@ -69,7 +69,6 @@ class ConversationManager:
             persona_id=conv_v2.persona_id,
             created_at=created_at,
             updated_at=updated_at,
-            token_usage=conv_v2.token_usage,
         )
 
     async def new_conversation(
@@ -257,7 +256,6 @@ class ConversationManager:
         history: list[dict] | None = None,
         title: str | None = None,
         persona_id: str | None = None,
-        token_usage: int | None = None,
     ) -> None:
         """更新会话的对话.
 
@@ -265,7 +263,6 @@ class ConversationManager:
             unified_msg_origin (str): 统一的消息来源字符串。格式为 platform_name:message_type:session_id
             conversation_id (str): 对话 ID, 是 uuid 格式的字符串
             history (List[Dict]): 对话历史记录, 是一个字典列表, 每个字典包含 role 和 content 字段
-            token_usage (int | None): token 使用量。None 表示不更新
 
         """
         if not conversation_id:
@@ -277,7 +274,6 @@ class ConversationManager:
                 title=title,
                 persona_id=persona_id,
                 content=history,
-                token_usage=token_usage,
             )
 
     async def update_conversation_title(

astrbot/core/core_lifecycle.py

@@ -90,7 +90,6 @@ class AstrBotCoreLifecycle:
 
         # 初始化 UMOP 配置路由器
         self.umop_config_router = UmopConfigRouter(sp=sp)
-        await self.umop_config_router.initialize()
 
         # 初始化 AstrBot 配置管理器
         self.astrbot_config_mgr = AstrBotConfigManager(

astrbot/core/db/__init__.py

@@ -152,7 +152,6 @@ class BaseDatabase(abc.ABC):
         title: str | None = None,
         persona_id: str | None = None,
         content: list[dict] | None = None,
-        token_usage: int | None = None,
     ) -> None:
         """Update a conversation's history."""
         ...

astrbot/core/db/migration/migra_token_usage.py

@@ -1,61 +0,0 @@
-"""Migration script to add token_usage column to conversations table.
-
-This migration adds the token_usage field to track token consumption for each conversation.
-
-Changes:
-- Adds token_usage column to conversations table (default: 0)
-"""
-
-from sqlalchemy import text
-
-from astrbot.api import logger, sp
-from astrbot.core.db import BaseDatabase
-
-
-async def migrate_token_usage(db_helper: BaseDatabase):
-    """Add token_usage column to conversations table.
-
-    This migration adds a new column to track token consumption in conversations.
-    """
-    # 检查是否已经完成迁移
-    migration_done = await db_helper.get_preference(
-        "global", "global", "migration_done_token_usage_1"
-    )
-    if migration_done:
-        return
-
-    logger.info("开始执行数据库迁移（添加 conversations.token_usage 列）...")
-
-    # 这里只适配了 SQLite。因为截止至这一版本，AstrBot 仅支持 SQLite。
-
-    try:
-        async with db_helper.get_db() as session:
-            # 检查列是否已存在
-            result = await session.execute(text("PRAGMA table_info(conversations)"))
-            columns = result.fetchall()
-            column_names = [col[1] for col in columns]
-
-            if "token_usage" in column_names:
-                logger.info("token_usage 列已存在，跳过迁移")
-                await sp.put_async(
-                    "global", "global", "migration_done_token_usage_1", True
-                )
-                return
-
-            # 添加 token_usage 列
-            await session.execute(
-                text(
-                    "ALTER TABLE conversations ADD COLUMN token_usage INTEGER NOT NULL DEFAULT 0"
-                )
-            )
-            await session.commit()
-
-            logger.info("token_usage 列添加成功")
-
-        # 标记迁移完成
-        await sp.put_async("global", "global", "migration_done_token_usage_1", True)
-        logger.info("token_usage 迁移完成")
-
-    except Exception as e:
-        logger.error(f"迁移过程中发生错误: {e}", exc_info=True)
-        raise

astrbot/core/db/po.py

@@ -54,11 +54,6 @@ class ConversationV2(SQLModel, table=True):
     )
     title: str | None = Field(default=None, max_length=255)
     persona_id: str | None = Field(default=None)
-    token_usage: int = Field(default=0, nullable=False)
-    """content is a list of OpenAI-formated messages in list[dict] format.
-    token_usage is the total token value of the messages.
-    when 0, will use estimated token counter.
-    """
 
     __table_args__ = (
         UniqueConstraint(
@@ -318,8 +313,6 @@ class Conversation:
     persona_id: str | None = ""
     created_at: int = 0
     updated_at: int = 0
-    token_usage: int = 0
-    """对话的总 token 数量。AstrBot 会保留最近一次 LLM 请求返回的总 token 数，方便统计。token_usage 可能为 0，表示未知。"""
 
 
 class Personality(TypedDict):

astrbot/core/db/sqlite.py

@@ -241,9 +241,7 @@ class SQLiteDatabase(BaseDatabase):
                 session.add(new_conversation)
                 return new_conversation
 
-    async def update_conversation(
-        self, cid, title=None, persona_id=None, content=None, token_usage=None
-    ):
+    async def update_conversation(self, cid, title=None, persona_id=None, content=None):
         async with self.get_db() as session:
             session: AsyncSession
             async with session.begin():
@@ -257,8 +255,6 @@ class SQLiteDatabase(BaseDatabase):
                     values["persona_id"] = persona_id
                 if content is not None:
                     values["content"] = content
-                if token_usage is not None:
-                    values["token_usage"] = token_usage
                 if not values:
                     return None
                 query = query.values(**values)

astrbot/core/knowledge_base/chunking/recursive.py

@@ -149,16 +149,8 @@ class RecursiveCharacterChunker(BaseChunker):
             分割后的文本块列表
 
         """
-        if chunk_size is None:
-            chunk_size = self.chunk_size
-        if overlap is None:
-            overlap = self.chunk_overlap
-        if chunk_size <= 0:
-            raise ValueError("chunk_size must be greater than 0")
-        if overlap < 0:
-            raise ValueError("chunk_overlap must be non-negative")
-        if overlap >= chunk_size:
-            raise ValueError("chunk_overlap must be less than chunk_size")
+        chunk_size = chunk_size or self.chunk_size
+        overlap = overlap or self.chunk_overlap
         result = []
         for i in range(0, len(text), chunk_size - overlap):
             end = min(i + chunk_size, len(text))

astrbot/core/log.py

@@ -58,7 +58,7 @@ def is_plugin_path(pathname):
         return False
 
     norm_path = os.path.normpath(pathname)
-    return ("data/plugins" in norm_path) or ("astrbot/builtin_stars/" in norm_path)
+    return ("data/plugins" in norm_path) or ("packages/" in norm_path)
 
 
 def get_short_level_name(level_name):

astrbot/core/pipeline/process_stage/method/agent_request.py

@@ -38,7 +38,7 @@ class AgentRequestSubStage(Stage):
             )
             return
 
-        if not await SessionServiceManager.should_process_llm_request(event):
+        if not SessionServiceManager.should_process_llm_request(event):
             logger.debug(
                 f"The session {event.unified_msg_origin} has disabled AI capability, skipping processing."
             )

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

@@ -1,12 +1,11 @@
 """本地 Agent 模式的 LLM 调用 Stage"""
 
 import asyncio
+import copy
 import json
 from collections.abc import AsyncGenerator
 
 from astrbot.core import logger
-from astrbot.core.agent.message import Message
-from astrbot.core.agent.response import AgentStats
 from astrbot.core.agent.tool import ToolSet
 from astrbot.core.astr_agent_context import AstrAgentContext
 from astrbot.core.conversation_mgr import Conversation
@@ -24,7 +23,6 @@ from astrbot.core.provider.entities import (
 )
 from astrbot.core.star.star_handler import EventType, star_map
 from astrbot.core.utils.file_extract import extract_file_moonshotai
-from astrbot.core.utils.llm_metadata import LLM_METADATAS
 from astrbot.core.utils.metrics import Metric
 from astrbot.core.utils.session_lock import session_lock_manager
 
@@ -42,6 +40,11 @@ class InternalAgentSubStage(Stage):
         self.ctx = ctx
         conf = ctx.astrbot_config
         settings = conf["provider_settings"]
+        self.max_context_length = settings["max_context_length"]  # int
+        self.dequeue_context_length: int = min(
+            max(1, settings["dequeue_context_length"]),
+            self.max_context_length - 1,
+        )
         self.streaming_response: bool = settings["streaming_response"]
         self.unsupported_streaming_strategy: str = settings[
             "unsupported_streaming_strategy"
@@ -61,25 +64,6 @@ class InternalAgentSubStage(Stage):
             "moonshotai_api_key", ""
         )
 
-        # 上下文管理相关
-        self.context_limit_reached_strategy: str = settings.get(
-            "context_limit_reached_strategy", "truncate_by_turns"
-        )
-        self.llm_compress_instruction: str = settings.get(
-            "llm_compress_instruction", ""
-        )
-        self.llm_compress_keep_recent: int = settings.get("llm_compress_keep_recent", 4)
-        self.llm_compress_provider_id: str = settings.get(
-            "llm_compress_provider_id", ""
-        )
-        self.max_context_length = settings["max_context_length"]  # int
-        self.dequeue_context_length: int = min(
-            max(1, settings["dequeue_context_length"]),
-            self.max_context_length - 1,
-        )
-        if self.dequeue_context_length <= 0:
-            self.dequeue_context_length = 1
-
         self.conv_manager = ctx.plugin_manager.context.conversation_manager
 
     def _select_provider(self, event: AstrMessageEvent):
@@ -182,6 +166,34 @@ class InternalAgentSubStage(Stage):
                 },
             )
 
+    def _truncate_contexts(
+        self,
+        contexts: list[dict],
+    ) -> list[dict]:
+        """截断上下文列表，确保不超过最大长度"""
+        if self.max_context_length == -1:
+            return contexts
+
+        if len(contexts) // 2 <= self.max_context_length:
+            return contexts
+
+        truncated_contexts = contexts[
+            -(self.max_context_length - self.dequeue_context_length + 1) * 2 :
+        ]
+        # 找到第一个role 为 user 的索引，确保上下文格式正确
+        index = next(
+            (
+                i
+                for i, item in enumerate(truncated_contexts)
+                if item.get("role") == "user"
+            ),
+            None,
+        )
+        if index is not None and index > 0:
+            truncated_contexts = truncated_contexts[index:]
+
+        return truncated_contexts
+
     def _modalities_fix(
         self,
         provider: Provider,
@@ -282,8 +294,6 @@ class InternalAgentSubStage(Stage):
         event: AstrMessageEvent,
         req: ProviderRequest,
         llm_response: LLMResponse | None,
-        all_messages: list[Message],
-        runner_stats: AgentStats | None,
     ):
         if (
             not req
@@ -297,265 +307,222 @@ class InternalAgentSubStage(Stage):
             logger.debug("LLM 响应为空，不保存记录。")
             return
 
-        # using agent context messages to save to history
-        message_to_save = []
-        for message in all_messages:
-            if message.role == "system":
-                # we do not save system messages to history
-                continue
-            if message.role in ["assistant", "user"] and getattr(
-                message, "_no_save", None
-            ):
-                # we do not save user and assistant messages that are marked as _no_save
-                continue
-            message_to_save.append(message.model_dump())
-
-        # get token usage from agent runner stats
-        token_usage = None
-        if runner_stats:
-            token_usage = runner_stats.token_usage.total
+        if req.contexts is None:
+            req.contexts = []
 
+        # 历史上下文
+        messages = copy.deepcopy(req.contexts)
+        # 这一轮对话请求的用户输入
+        messages.append(await req.assemble_context())
+        # 这一轮对话的 LLM 响应
+        if req.tool_calls_result:
+            if not isinstance(req.tool_calls_result, list):
+                messages.extend(req.tool_calls_result.to_openai_messages())
+            elif isinstance(req.tool_calls_result, list):
+                for tcr in req.tool_calls_result:
+                    messages.extend(tcr.to_openai_messages())
+        messages.append(
+            {
+                "role": "assistant",
+                "content": llm_response.completion_text or "*No response*",
+            }
+        )
+        messages = list(filter(lambda item: "_no_save" not in item, messages))
         await self.conv_manager.update_conversation(
             event.unified_msg_origin,
             req.conversation.cid,
-            history=message_to_save,
-            token_usage=token_usage,
+            history=messages,
         )
 
-    def _get_compress_provider(self) -> Provider | None:
-        if not self.llm_compress_provider_id:
-            return None
-        if self.context_limit_reached_strategy != "llm_compress":
-            return None
-        provider = self.ctx.plugin_manager.context.get_provider_by_id(
-            self.llm_compress_provider_id,
-        )
-        if provider is None:
-            logger.warning(
-                f"未找到指定的上下文压缩模型 {self.llm_compress_provider_id}，将跳过压缩。",
-            )
-            return None
-        if not isinstance(provider, Provider):
-            logger.warning(
-                f"指定的上下文压缩模型 {self.llm_compress_provider_id} 不是对话模型，将跳过压缩。"
-            )
-            return None
-        return provider
+    def _fix_messages(self, messages: list[dict]) -> list[dict]:
+        """验证并且修复上下文"""
+        fixed_messages = []
+        for message in messages:
+            if message.get("role") == "tool":
+                # tool block 前面必须要有 user 和 assistant block
+                if len(fixed_messages) < 2:
+                    # 这种情况可能是上下文被截断导致的
+                    # 我们直接将之前的上下文都清空
+                    fixed_messages = []
+                else:
+                    fixed_messages.append(message)
+            else:
+                fixed_messages.append(message)
+        return fixed_messages
 
     async def process(
         self, event: AstrMessageEvent, provider_wake_prefix: str
     ) -> AsyncGenerator[None, None]:
         req: ProviderRequest | None = None
 
-        try:
-            provider = self._select_provider(event)
-            if provider is None:
-                return
-            if not isinstance(provider, Provider):
-                logger.error(
-                    f"选择的提供商类型无效({type(provider)})，跳过 LLM 请求处理。"
+        provider = self._select_provider(event)
+        if provider is None:
+            return
+        if not isinstance(provider, Provider):
+            logger.error(f"选择的提供商类型无效({type(provider)})，跳过 LLM 请求处理。")
+            return
+
+        streaming_response = self.streaming_response
+        if (enable_streaming := event.get_extra("enable_streaming")) is not None:
+            streaming_response = bool(enable_streaming)
+
+        logger.debug("ready to request llm provider")
+        async with session_lock_manager.acquire_lock(event.unified_msg_origin):
+            logger.debug("acquired session lock for llm request")
+            if event.get_extra("provider_request"):
+                req = event.get_extra("provider_request")
+                assert isinstance(req, ProviderRequest), (
+                    "provider_request 必须是 ProviderRequest 类型。"
                 )
-                return
 
-            streaming_response = self.streaming_response
-            if (enable_streaming := event.get_extra("enable_streaming")) is not None:
-                streaming_response = bool(enable_streaming)
+                if req.conversation:
+                    req.contexts = json.loads(req.conversation.history)
 
-            # 检查消息内容是否有效，避免空消息触发钩子
-            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（在获取锁之前）
-            await call_event_hook(event, EventType.OnWaitingLLMRequestEvent)
-
-            async with session_lock_manager.acquire_lock(event.unified_msg_origin):
-                logger.debug("acquired session lock for llm request")
-                if event.get_extra("provider_request"):
-                    req = event.get_extra("provider_request")
-                    assert isinstance(req, ProviderRequest), (
-                        "provider_request 必须是 ProviderRequest 类型。"
-                    )
-
-                    if req.conversation:
-                        req.contexts = json.loads(req.conversation.history)
-
-                else:
-                    req = ProviderRequest()
-                    req.prompt = ""
-                    req.image_urls = []
-                    if sel_model := event.get_extra("selected_model"):
-                        req.model = sel_model
-                    if provider_wake_prefix and not event.message_str.startswith(
-                        provider_wake_prefix
-                    ):
-                        return
-
-                    req.prompt = event.message_str[len(provider_wake_prefix) :]
-                    # func_tool selection 现在已经转移到 astrbot/builtin_stars/astrbot 插件中进行选择。
-                    # req.func_tool = self.ctx.plugin_manager.context.get_llm_tool_manager()
-                    for comp in event.message_obj.message:
-                        if isinstance(comp, Image):
-                            image_path = await comp.convert_to_file_path()
-                            req.image_urls.append(image_path)
-
-                    conversation = await self._get_session_conv(event)
-                    req.conversation = conversation
-                    req.contexts = json.loads(conversation.history)
-
-                    event.set_extra("provider_request", req)
-
-                # fix contexts json str
-                if isinstance(req.contexts, str):
-                    req.contexts = json.loads(req.contexts)
-
-                # apply file extract
-                if self.file_extract_enabled:
-                    try:
-                        await self._apply_file_extract(event, req)
-                    except Exception as e:
-                        logger.error(f"Error occurred while applying file extract: {e}")
-
-                if not req.prompt and not req.image_urls:
+            else:
+                req = ProviderRequest()
+                req.prompt = ""
+                req.image_urls = []
+                if sel_model := event.get_extra("selected_model"):
+                    req.model = sel_model
+                if provider_wake_prefix and not event.message_str.startswith(
+                    provider_wake_prefix
+                ):
                     return
 
-                # call event hook
-                if await call_event_hook(event, EventType.OnLLMRequestEvent, req):
-                    return
+                req.prompt = event.message_str[len(provider_wake_prefix) :]
+                # func_tool selection 现在已经转移到 packages/astrbot 插件中进行选择。
+                # req.func_tool = self.ctx.plugin_manager.context.get_llm_tool_manager()
+                for comp in event.message_obj.message:
+                    if isinstance(comp, Image):
+                        image_path = await comp.convert_to_file_path()
+                        req.image_urls.append(image_path)
 
-                # apply knowledge base feature
-                await self._apply_kb(event, req)
+                conversation = await self._get_session_conv(event)
+                req.conversation = conversation
+                req.contexts = json.loads(conversation.history)
 
-                # truncate contexts to fit max length
-                # NOW moved to ContextManager inside ToolLoopAgentRunner
-                # if req.contexts:
-                #     req.contexts = self._truncate_contexts(req.contexts)
-                #     self._fix_messages(req.contexts)
+                event.set_extra("provider_request", req)
 
-                # session_id
-                if not req.session_id:
-                    req.session_id = event.unified_msg_origin
+            # fix contexts json str
+            if isinstance(req.contexts, str):
+                req.contexts = json.loads(req.contexts)
 
-                # check provider modalities, if provider does not support image/tool_use, clear them in request.
-                self._modalities_fix(provider, req)
+            # apply file extract
+            if self.file_extract_enabled:
+                try:
+                    await self._apply_file_extract(event, req)
+                except Exception as e:
+                    logger.error(f"Error occurred while applying file extract: {e}")
 
-                # filter tools, only keep tools from this pipeline's selected plugins
-                self._plugin_tool_fix(event, req)
+            if not req.prompt and not req.image_urls:
+                return
 
-                stream_to_general = (
-                    self.unsupported_streaming_strategy == "turn_off"
-                    and not event.platform_meta.support_streaming_message
-                )
+            # call event hook
+            if await call_event_hook(event, EventType.OnLLMRequestEvent, req):
+                return
 
-                # run agent
-                agent_runner = AgentRunner()
-                logger.debug(
-                    f"handle provider[id: {provider.provider_config['id']}] request: {req}",
-                )
-                astr_agent_ctx = AstrAgentContext(
-                    context=self.ctx.plugin_manager.context,
-                    event=event,
-                )
+            # apply knowledge base feature
+            await self._apply_kb(event, req)
 
-                # inject model context length limit
-                if provider.provider_config.get("max_context_tokens", 0) <= 0:
-                    model = provider.get_model()
-                    if model_info := LLM_METADATAS.get(model):
-                        provider.provider_config["max_context_tokens"] = model_info[
-                            "limit"
-                        ]["context"]
+            # truncate contexts to fit max length
+            if req.contexts:
+                req.contexts = self._truncate_contexts(req.contexts)
+                self._fix_messages(req.contexts)
 
-                await agent_runner.reset(
-                    provider=provider,
-                    request=req,
-                    run_context=AgentContextWrapper(
-                        context=astr_agent_ctx,
-                        tool_call_timeout=self.tool_call_timeout,
-                    ),
-                    tool_executor=FunctionToolExecutor(),
-                    agent_hooks=MAIN_AGENT_HOOKS,
-                    streaming=streaming_response,
-                    llm_compress_instruction=self.llm_compress_instruction,
-                    llm_compress_keep_recent=self.llm_compress_keep_recent,
-                    llm_compress_provider=self._get_compress_provider(),
-                    truncate_turns=self.dequeue_context_length,
-                    enforce_max_turns=self.max_context_length,
-                )
+            # session_id
+            if not req.session_id:
+                req.session_id = event.unified_msg_origin
 
-                if streaming_response and not stream_to_general:
-                    # 流式响应
-                    event.set_result(
-                        MessageEventResult()
-                        .set_result_content_type(ResultContentType.STREAMING_RESULT)
-                        .set_async_stream(
-                            run_agent(
-                                agent_runner,
-                                self.max_step,
-                                self.show_tool_use,
-                                show_reasoning=self.show_reasoning,
-                            ),
-                        ),
-                    )
-                    yield
-                    if agent_runner.done():
-                        if final_llm_resp := agent_runner.get_final_llm_resp():
-                            if final_llm_resp.completion_text:
-                                chain = (
-                                    MessageChain()
-                                    .message(final_llm_resp.completion_text)
-                                    .chain
-                                )
-                            elif final_llm_resp.result_chain:
-                                chain = final_llm_resp.result_chain.chain
-                            else:
-                                chain = MessageChain().chain
-                            event.set_result(
-                                MessageEventResult(
-                                    chain=chain,
-                                    result_content_type=ResultContentType.STREAMING_FINISH,
-                                ),
-                            )
-                else:
-                    async for _ in run_agent(
-                        agent_runner,
-                        self.max_step,
-                        self.show_tool_use,
-                        stream_to_general,
-                        show_reasoning=self.show_reasoning,
-                    ):
-                        yield
+            # check provider modalities, if provider does not support image/tool_use, clear them in request.
+            self._modalities_fix(provider, req)
 
-                # 检查事件是否被停止，如果被停止则不保存历史记录
-                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,
-                    )
+            # filter tools, only keep tools from this pipeline's selected plugins
+            self._plugin_tool_fix(event, req)
 
-            # 异步处理 WebChat 特殊情况
-            if event.get_platform_name() == "webchat":
-                asyncio.create_task(self._handle_webchat(event, req, provider))
+            stream_to_general = (
+                self.unsupported_streaming_strategy == "turn_off"
+                and not event.platform_meta.support_streaming_message
+            )
+            # 备份 req.contexts
+            backup_contexts = copy.deepcopy(req.contexts)
 
-            asyncio.create_task(
-                Metric.upload(
-                    llm_tick=1,
-                    model_name=agent_runner.provider.get_model(),
-                    provider_type=agent_runner.provider.meta().type,
+            # run agent
+            agent_runner = AgentRunner()
+            logger.debug(
+                f"handle provider[id: {provider.provider_config['id']}] request: {req}",
+            )
+            astr_agent_ctx = AstrAgentContext(
+                context=self.ctx.plugin_manager.context,
+                event=event,
+            )
+            await agent_runner.reset(
+                provider=provider,
+                request=req,
+                run_context=AgentContextWrapper(
+                    context=astr_agent_ctx,
+                    tool_call_timeout=self.tool_call_timeout,
                 ),
+                tool_executor=FunctionToolExecutor(),
+                agent_hooks=MAIN_AGENT_HOOKS,
+                streaming=streaming_response,
             )
 
-        except Exception as e:
-            logger.error(f"Error occurred while processing agent: {e}")
-            await event.send(
-                MessageChain().message(
-                    f"Error occurred while processing agent request: {e}"
+            if streaming_response and not stream_to_general:
+                # 流式响应
+                event.set_result(
+                    MessageEventResult()
+                    .set_result_content_type(ResultContentType.STREAMING_RESULT)
+                    .set_async_stream(
+                        run_agent(
+                            agent_runner,
+                            self.max_step,
+                            self.show_tool_use,
+                            show_reasoning=self.show_reasoning,
+                        ),
+                    ),
                 )
-            )
+                yield
+                if agent_runner.done():
+                    if final_llm_resp := agent_runner.get_final_llm_resp():
+                        if final_llm_resp.completion_text:
+                            chain = (
+                                MessageChain()
+                                .message(final_llm_resp.completion_text)
+                                .chain
+                            )
+                        elif final_llm_resp.result_chain:
+                            chain = final_llm_resp.result_chain.chain
+                        else:
+                            chain = MessageChain().chain
+                        event.set_result(
+                            MessageEventResult(
+                                chain=chain,
+                                result_content_type=ResultContentType.STREAMING_FINISH,
+                            ),
+                        )
+            else:
+                async for _ in run_agent(
+                    agent_runner,
+                    self.max_step,
+                    self.show_tool_use,
+                    stream_to_general,
+                    show_reasoning=self.show_reasoning,
+                ):
+                    yield
+
+            # 恢复备份的 contexts
+            req.contexts = backup_contexts
+
+            await self._save_to_history(event, req, agent_runner.get_final_llm_resp())
+
+        # 异步处理 WebChat 特殊情况
+        if event.get_platform_name() == "webchat":
+            asyncio.create_task(self._handle_webchat(event, req, provider))
+
+        asyncio.create_task(
+            Metric.upload(
+                llm_tick=1,
+                model_name=agent_runner.provider.get_model(),
+                provider_type=agent_runner.provider.meta().type,
+            ),
+        )

astrbot/core/pipeline/result_decorate/stage.py

@@ -98,9 +98,6 @@ class ResultDecorateStage(Stage):
                     self.content_safe_check_stage = stage_cls()
                     await self.content_safe_check_stage.initialize(ctx)
 
-        provider_cfg = ctx.astrbot_config.get("provider_settings", {})
-        self.show_reasoning = provider_cfg.get("display_reasoning_text", False)
-
     def _split_text_by_words(self, text: str) -> list[str]:
         """使用分段词列表分段文本"""
         if not self.split_words_pattern:
@@ -257,75 +254,70 @@ class ResultDecorateStage(Stage):
                 event.unified_msg_origin,
             )
 
-            should_tts = (
-                bool(self.ctx.astrbot_config["provider_tts_settings"]["enable"])
+            if (
+                self.ctx.astrbot_config["provider_tts_settings"]["enable"]
                 and result.is_llm_result()
-                and await SessionServiceManager.should_process_tts_request(event)
-                and random.random() <= self.tts_trigger_probability
-                and tts_provider
-            )
-            if should_tts and not tts_provider:
-                logger.warning(
-                    f"会话 {event.unified_msg_origin} 未配置文本转语音模型。",
+                and SessionServiceManager.should_process_tts_request(event)
+            ):
+                should_tts = self.tts_trigger_probability >= 1.0 or (
+                    self.tts_trigger_probability > 0.0
+                    and random.random() <= self.tts_trigger_probability
                 )
 
-            if (
-                not should_tts
-                and self.show_reasoning
-                and event.get_extra("_llm_reasoning_content")
-            ):
-                # inject reasoning content to chain
-                reasoning_content = event.get_extra("_llm_reasoning_content")
-                result.chain.insert(0, Plain(f"🤔 思考: {reasoning_content}\n"))
+                if not should_tts:
+                    logger.debug("跳过 TTS：触发概率未命中。")
+                elif not tts_provider:
+                    logger.warning(
+                        f"会话 {event.unified_msg_origin} 未配置文本转语音模型。",
+                    )
+                else:
+                    new_chain = []
+                    for comp in result.chain:
+                        if isinstance(comp, Plain) and len(comp.text) > 1:
+                            try:
+                                logger.info(f"TTS 请求: {comp.text}")
+                                audio_path = await tts_provider.get_audio(comp.text)
+                                logger.info(f"TTS 结果: {audio_path}")
+                                if not audio_path:
+                                    logger.error(
+                                        f"由于 TTS 音频文件未找到，消息段转语音失败: {comp.text}",
+                                    )
+                                    new_chain.append(comp)
+                                    continue
 
-            if should_tts and tts_provider:
-                new_chain = []
-                for comp in result.chain:
-                    if isinstance(comp, Plain) and len(comp.text) > 1:
-                        try:
-                            logger.info(f"TTS 请求: {comp.text}")
-                            audio_path = await tts_provider.get_audio(comp.text)
-                            logger.info(f"TTS 结果: {audio_path}")
-                            if not audio_path:
-                                logger.error(
-                                    f"由于 TTS 音频文件未找到，消息段转语音失败: {comp.text}",
+                                use_file_service = self.ctx.astrbot_config[
+                                    "provider_tts_settings"
+                                ]["use_file_service"]
+                                callback_api_base = self.ctx.astrbot_config[
+                                    "callback_api_base"
+                                ]
+                                dual_output = self.ctx.astrbot_config[
+                                    "provider_tts_settings"
+                                ]["dual_output"]
+
+                                url = None
+                                if use_file_service and callback_api_base:
+                                    token = await file_token_service.register_file(
+                                        audio_path,
+                                    )
+                                    url = f"{callback_api_base}/api/file/{token}"
+                                    logger.debug(f"已注册：{url}")
+
+                                new_chain.append(
+                                    Record(
+                                        file=url or audio_path,
+                                        url=url or audio_path,
+                                    ),
                                 )
+                                if dual_output:
+                                    new_chain.append(comp)
+                            except Exception:
+                                logger.error(traceback.format_exc())
+                                logger.error("TTS 失败，使用文本发送。")
                                 new_chain.append(comp)
-                                continue
-
-                            use_file_service = self.ctx.astrbot_config[
-                                "provider_tts_settings"
-                            ]["use_file_service"]
-                            callback_api_base = self.ctx.astrbot_config[
-                                "callback_api_base"
-                            ]
-                            dual_output = self.ctx.astrbot_config[
-                                "provider_tts_settings"
-                            ]["dual_output"]
-
-                            url = None
-                            if use_file_service and callback_api_base:
-                                token = await file_token_service.register_file(
-                                    audio_path,
-                                )
-                                url = f"{callback_api_base}/api/file/{token}"
-                                logger.debug(f"已注册：{url}")
-
-                            new_chain.append(
-                                Record(
-                                    file=url or audio_path,
-                                    url=url or audio_path,
-                                ),
-                            )
-                            if dual_output:
-                                new_chain.append(comp)
-                        except Exception:
-                            logger.error(traceback.format_exc())
-                            logger.error("TTS 失败，使用文本发送。")
+                        else:
                             new_chain.append(comp)
-                    else:
-                        new_chain.append(comp)
-                result.chain = new_chain
+                    result.chain = new_chain
 
             # 文本转图片
             elif (

astrbot/core/pipeline/session_status_check/stage.py

@@ -21,7 +21,7 @@ class SessionStatusCheckStage(Stage):
         event: AstrMessageEvent,
     ) -> None | AsyncGenerator[None, None]:
         # 检查会话是否整体启用
-        if not await SessionServiceManager.is_session_enabled(event.unified_msg_origin):
+        if not SessionServiceManager.is_session_enabled(event.unified_msg_origin):
             logger.debug(f"会话 {event.unified_msg_origin} 已被关闭，已终止事件传播。")
 
             # workaround for #2309

astrbot/core/pipeline/waking_check/stage.py

@@ -1,10 +1,9 @@
-from collections.abc import AsyncGenerator, Callable
+from collections.abc import AsyncGenerator
 
 from astrbot import logger
 from astrbot.core.message.components import At, AtAll, Reply
 from astrbot.core.message.message_event_result import MessageChain, MessageEventResult
 from astrbot.core.platform.astr_message_event import AstrMessageEvent
-from astrbot.core.platform.message_type import MessageType
 from astrbot.core.star.filter.command_group import CommandGroupFilter
 from astrbot.core.star.filter.permission import PermissionTypeFilter
 from astrbot.core.star.session_plugin_manager import SessionPluginManager
@@ -14,22 +13,6 @@ from astrbot.core.star.star_handler import EventType, star_handlers_registry
 from ..context import PipelineContext
 from ..stage import Stage, register_stage
 
-UNIQUE_SESSION_ID_BUILDERS: dict[str, Callable[[AstrMessageEvent], str | None]] = {
-    "aiocqhttp": lambda e: f"{e.get_sender_id()}_{e.get_group_id()}",
-    "slack": lambda e: f"{e.get_sender_id()}_{e.get_group_id()}",
-    "dingtalk": lambda e: e.get_sender_id(),
-    "qq_official": lambda e: e.get_sender_id(),
-    "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()}",
-}
-
-
-def build_unique_session_id(event: AstrMessageEvent) -> str | None:
-    platform = event.get_platform_name()
-    builder = UNIQUE_SESSION_ID_BUILDERS.get(platform)
-    return builder(event) if builder else None
-
 
 @register_stage
 class WakingCheckStage(Stage):
@@ -70,27 +53,18 @@ class WakingCheckStage(Stage):
         self.disable_builtin_commands = self.ctx.astrbot_config.get(
             "disable_builtin_commands", False
         )
-        platform_settings = self.ctx.astrbot_config.get("platform_settings", {})
-        self.unique_session = platform_settings.get("unique_session", False)
 
     async def process(
         self,
         event: AstrMessageEvent,
     ) -> None | AsyncGenerator[None, None]:
-        # apply unique session
-        if self.unique_session and event.message_obj.type == MessageType.GROUP_MESSAGE:
-            sid = build_unique_session_id(event)
-            if sid:
-                event.session_id = sid
-
-        # ignore bot self message
         if (
             self.ignore_bot_self_message
             and event.get_self_id() == event.get_sender_id()
         ):
+            # 忽略机器人自己发送的消息
             event.stop_event()
             return
-
         # 设置 sender 身份
         event.message_str = event.message_str.strip()
         for admin_id in self.ctx.astrbot_config["admins_id"]:
@@ -162,8 +136,7 @@ class WakingCheckStage(Stage):
         ):
             if (
                 self.disable_builtin_commands
-                and handler.handler_module_path
-                == "astrbot.builtin_stars.builtin_commands.main"
+                and handler.handler_module_path == "packages.builtin_commands.main"
             ):
                 logger.debug("skipping builtin command")
                 continue
@@ -226,7 +199,7 @@ class WakingCheckStage(Stage):
             event._extras.pop("parsed_params", None)
 
         # 根据会话配置过滤插件处理器
-        activated_handlers = await SessionPluginManager.filter_handlers_by_session(
+        activated_handlers = SessionPluginManager.filter_handlers_by_session(
             event,
             activated_handlers,
         )

astrbot/core/platform/manager.py

@@ -70,6 +70,10 @@ 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/aiocqhttp/aiocqhttp_platform_adapter.py

@@ -41,6 +41,7 @@ class AiocqhttpAdapter(Platform):
         super().__init__(platform_config, event_queue)
 
         self.settings = platform_settings
+        self.unique_session = platform_settings["unique_session"]
         self.host = platform_config["ws_reverse_host"]
         self.port = platform_config["ws_reverse_port"]
 
@@ -135,11 +136,14 @@ class AiocqhttpAdapter(Platform):
             abm.group_id = str(event.group_id)
         else:
             abm.type = MessageType.FRIEND_MESSAGE
-        abm.session_id = (
-            str(event.group_id)
-            if abm.type == MessageType.GROUP_MESSAGE
-            else abm.sender.user_id
-        )
+        if self.unique_session and abm.type == MessageType.GROUP_MESSAGE:
+            abm.session_id = str(abm.sender.user_id) + "_" + str(event.group_id)
+        else:
+            abm.session_id = (
+                str(event.group_id)
+                if abm.type == MessageType.GROUP_MESSAGE
+                else abm.sender.user_id
+            )
         abm.message_str = ""
         abm.message = []
         abm.timestamp = int(time.time())
@@ -160,11 +164,16 @@ class AiocqhttpAdapter(Platform):
             abm.type = MessageType.GROUP_MESSAGE
         else:
             abm.type = MessageType.FRIEND_MESSAGE
-        abm.session_id = (
-            str(event.group_id)
-            if abm.type == MessageType.GROUP_MESSAGE
-            else abm.sender.user_id
-        )
+        if self.unique_session and abm.type == MessageType.GROUP_MESSAGE:
+            abm.session_id = (
+                str(abm.sender.user_id) + "_" + str(event.group_id)
+            )  # 也保留群组 id
+        else:
+            abm.session_id = (
+                str(event.group_id)
+                if abm.type == MessageType.GROUP_MESSAGE
+                else abm.sender.user_id
+            )
         abm.message_str = ""
         abm.message = []
         abm.raw_message = event
@@ -201,11 +210,16 @@ class AiocqhttpAdapter(Platform):
             abm.group.group_name = event.get("group_name", "N/A")
         elif event["message_type"] == "private":
             abm.type = MessageType.FRIEND_MESSAGE
-        abm.session_id = (
-            str(event.group_id)
-            if abm.type == MessageType.GROUP_MESSAGE
-            else abm.sender.user_id
-        )
+        if self.unique_session and abm.type == MessageType.GROUP_MESSAGE:
+            abm.session_id = (
+                abm.sender.user_id + "_" + str(event.group_id)
+            )  # 也保留群组 id
+        else:
+            abm.session_id = (
+                str(event.group_id)
+                if abm.type == MessageType.GROUP_MESSAGE
+                else abm.sender.user_id
+            )
 
         abm.message_id = str(event.message_id)
         abm.message = []

astrbot/core/platform/sources/dingtalk/dingtalk_adapter.py

@@ -50,6 +50,8 @@ class DingtalkPlatformAdapter(Platform):
     ) -> None:
         super().__init__(platform_config, event_queue)
 
+        self.unique_session = platform_settings["unique_session"]
+
         self.client_id = platform_config["client_id"]
         self.client_secret = platform_config["client_secret"]
 
@@ -127,7 +129,10 @@ class DingtalkPlatformAdapter(Platform):
                     if id := self._id_to_sid(user.dingtalk_id):
                         abm.message.append(At(qq=id))
             abm.group_id = message.conversation_id
-            abm.session_id = abm.group_id
+            if self.unique_session:
+                abm.session_id = abm.sender.user_id
+            else:
+                abm.session_id = abm.group_id
         else:
             abm.session_id = abm.sender.user_id
 

astrbot/core/platform/sources/dingtalk/dingtalk_event.py

@@ -25,20 +25,6 @@ class DingtalkMessageEvent(AstrMessageEvent):
         client: dingtalk_stream.ChatbotHandler,
         message: MessageChain,
     ):
-        icm = cast(dingtalk_stream.ChatbotMessage, self.message_obj.raw_message)
-        ats = []
-        # fixes: #4218
-        # 钉钉 at 机器人需要使用 sender_staff_id 而不是 sender_id
-        for i in message.chain:
-            if isinstance(i, Comp.At):
-                print(i.qq, icm.sender_id, icm.sender_staff_id)
-                if str(i.qq) in str(icm.sender_id or ""):
-                    # 适配器会将开头的 $:LWCP_v1:$ 去掉，因此我们用 in 判断
-                    ats.append(f"@{icm.sender_staff_id}")
-                else:
-                    ats.append(f"@{i.qq}")
-        at_str = " ".join(ats)
-
         for segment in message.chain:
             if isinstance(segment, Comp.Plain):
                 segment.text = segment.text.strip()
@@ -46,7 +32,7 @@ class DingtalkMessageEvent(AstrMessageEvent):
                     None,
                     client.reply_markdown,
                     segment.text,
-                    f"{at_str} {segment.text}".strip(),
+                    segment.text,
                     cast(dingtalk_stream.ChatbotMessage, self.message_obj.raw_message),
                 )
             elif isinstance(segment, Comp.Image):

astrbot/core/platform/sources/lark/lark_adapter.py

@@ -44,6 +44,8 @@ class LarkPlatformAdapter(Platform):
     ) -> None:
         super().__init__(platform_config, event_queue)
 
+        self.unique_session = platform_settings["unique_session"]
+
         self.appid = platform_config["app_id"]
         self.appsecret = platform_config["app_secret"]
         self.domain = platform_config.get("domain", lark.FEISHU_DOMAIN)
@@ -315,8 +317,14 @@ class LarkPlatformAdapter(Platform):
             user_id=event.event.sender.sender_id.open_id,
             nickname=event.event.sender.sender_id.open_id[:8],
         )
-        if abm.type == MessageType.GROUP_MESSAGE:
-            abm.session_id = abm.group_id
+        # 独立会话
+        if not self.unique_session:
+            if abm.type == MessageType.GROUP_MESSAGE:
+                abm.session_id = abm.group_id
+            else:
+                abm.session_id = abm.sender.user_id
+        elif abm.type == MessageType.GROUP_MESSAGE:
+            abm.session_id = f"{abm.sender.user_id}%{abm.group_id}"  # 也保留群组id
         else:
             abm.session_id = abm.sender.user_id
 

astrbot/core/platform/sources/misskey/misskey_adapter.py

@@ -91,6 +91,8 @@ class MisskeyPlatformAdapter(Platform):
         except Exception:
             self.max_download_bytes = None
 
+        self.unique_session = platform_settings["unique_session"]
+
         self.api: MisskeyAPI | None = None
         self._running = False
         self.client_self_id = ""
@@ -639,6 +641,7 @@ class MisskeyPlatformAdapter(Platform):
             sender_info,
             self.client_self_id,
             is_chat=False,
+            unique_session=self.unique_session,
         )
         cache_user_info(
             self._user_cache,
@@ -687,6 +690,7 @@ class MisskeyPlatformAdapter(Platform):
             sender_info,
             self.client_self_id,
             is_chat=True,
+            unique_session=self.unique_session,
         )
         cache_user_info(
             self._user_cache,
@@ -716,6 +720,7 @@ class MisskeyPlatformAdapter(Platform):
             self.client_self_id,
             is_chat=False,
             room_id=room_id,
+            unique_session=self.unique_session,
         )
 
         cache_user_info(

astrbot/core/platform/sources/misskey/misskey_utils.py

@@ -338,6 +338,7 @@ def create_base_message(
     client_self_id: str,
     is_chat: bool = False,
     room_id: str | None = None,
+    unique_session: bool = False,
 ) -> AstrBotMessage:
     """创建基础消息对象"""
     message = AstrBotMessage()
@@ -352,6 +353,8 @@ def create_base_message(
     if room_id:
         session_prefix = "room"
         session_id = f"{session_prefix}%{room_id}"
+        if unique_session:
+            session_id += f"_{sender_info['sender_id']}"
         message.type = MessageType.GROUP_MESSAGE
         message.group_id = room_id
     elif is_chat:

astrbot/core/platform/sources/qqofficial/qqofficial_platform_adapter.py

@@ -44,8 +44,11 @@ class botClient(Client):
             message,
             MessageType.GROUP_MESSAGE,
         )
-        abm.group_id = cast(str, message.group_openid)
-        abm.session_id = abm.group_id
+        abm.session_id = (
+            abm.sender.user_id
+            if self.platform.unique_session
+            else cast(str, message.group_openid)
+        )
         self._commit(abm)
 
     # 收到频道消息
@@ -54,8 +57,9 @@ class botClient(Client):
             message,
             MessageType.GROUP_MESSAGE,
         )
-        abm.group_id = message.channel_id
-        abm.session_id = abm.group_id
+        abm.session_id = (
+            abm.sender.user_id if self.platform.unique_session else message.channel_id
+        )
         self._commit(abm)
 
     # 收到私聊消息
@@ -100,6 +104,7 @@ class QQOfficialPlatformAdapter(Platform):
 
         self.appid = platform_config["appid"]
         self.secret = platform_config["secret"]
+        self.unique_session: bool = platform_settings["unique_session"]
         qq_group = platform_config["enable_group_c2c"]
         guild_dm = platform_config["enable_guild_direct_message"]
 

astrbot/core/platform/sources/qqofficial_webhook/qo_webhook_adapter.py

@@ -35,8 +35,11 @@ class botClient(Client):
             message,
             MessageType.GROUP_MESSAGE,
         )
-        abm.group_id = cast(str, message.group_openid)
-        abm.session_id = abm.group_id
+        abm.session_id = (
+            abm.sender.user_id
+            if self.platform.unique_session
+            else cast(str, message.group_openid)
+        )
         self._commit(abm)
 
     # 收到频道消息
@@ -45,8 +48,9 @@ class botClient(Client):
             message,
             MessageType.GROUP_MESSAGE,
         )
-        abm.group_id = message.channel_id
-        abm.session_id = abm.group_id
+        abm.session_id = (
+            abm.sender.user_id if self.platform.unique_session else message.channel_id
+        )
         self._commit(abm)
 
     # 收到私聊消息
@@ -91,6 +95,7 @@ class QQOfficialWebhookPlatformAdapter(Platform):
 
         self.appid = platform_config["appid"]
         self.secret = platform_config["secret"]
+        self.unique_session = platform_settings["unique_session"]
         self.unified_webhook_mode = platform_config.get("unified_webhook_mode", False)
 
         intents = botpy.Intents(

astrbot/core/platform/sources/satori/satori_adapter.py

@@ -142,12 +142,7 @@ class SatoriPlatformAdapter(Platform):
             raise ValueError(f"WebSocket URL必须以ws://或wss://开头: {self.endpoint}")
 
         try:
-            websocket = await connect(
-                self.endpoint,
-                additional_headers={},
-                max_size=10 * 1024 * 1024,  # 10MB
-            )
-
+            websocket = await connect(self.endpoint, additional_headers={})
             self.ws = websocket
 
             await asyncio.sleep(0.1)

astrbot/core/platform/sources/slack/slack_adapter.py

@@ -41,6 +41,7 @@ class SlackAdapter(Platform):
     ) -> None:
         super().__init__(platform_config, event_queue)
         self.settings = platform_settings
+        self.unique_session = platform_settings.get("unique_session", False)
 
         self.bot_token = platform_config.get("bot_token")
         self.app_token = platform_config.get("app_token")
@@ -146,10 +147,12 @@ class SlackAdapter(Platform):
             abm.group_id = channel_id
 
         # 设置会话ID
-        if abm.type == MessageType.GROUP_MESSAGE:
-            abm.session_id = abm.group_id
+        if self.unique_session and abm.type == MessageType.GROUP_MESSAGE:
+            abm.session_id = f"{user_id}_{channel_id}"
         else:
-            abm.session_id = user_id
+            abm.session_id = (
+                channel_id if abm.type == MessageType.GROUP_MESSAGE else user_id
+            )
 
         abm.message_id = event.get("client_msg_id", uuid.uuid4().hex)
         abm.timestamp = int(float(event.get("ts", time.time())))

astrbot/core/platform/sources/webchat/webchat_adapter.py

@@ -79,6 +79,7 @@ class WebChatAdapter(Platform):
         super().__init__(platform_config, event_queue)
 
         self.settings = platform_settings
+        self.unique_session = platform_settings["unique_session"]
         self.imgs_dir = os.path.join(get_astrbot_data_path(), "webchat", "imgs")
         os.makedirs(self.imgs_dir, exist_ok=True)
 

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

@@ -0,0 +1,942 @@
+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.unique_session = platform_settings.get("unique_session", False)
+
+        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
+
+            # 对于群聊，session_id 可以是群聊 ID 或发送者 ID + 群聊 ID (如果 unique_session 为 True)
+            if self.unique_session:
+                abm.session_id = f"{from_user_name}#{abm.sender.user_id}"
+            else:
+                abm.session_id = from_user_name
+
+            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

@@ -0,0 +1,178 @@
+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

@@ -0,0 +1,159 @@
+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/platform/sources/weixin_official_account/weixin_offacc_adapter.py

@@ -191,7 +191,7 @@ class WeixinOfficialAccountPlatformAdapter(Platform):
                 if self.active_send_mode:
                     await self.convert_message(msg, None)
                 else:
-                    if str(msg.id) in self.wexin_event_workers:
+                    if msg.id in self.wexin_event_workers:
                         future = self.wexin_event_workers[str(cast(str | int, msg.id))]
                         logger.debug(f"duplicate message id checked: {msg.id}")
                     else:

astrbot/core/provider/entities.py

@@ -94,7 +94,7 @@ class ProviderRequest:
     image_urls: list[str] = field(default_factory=list)
     """图片 URL 列表"""
     extra_user_content_parts: list[ContentPart] = field(default_factory=list)
-    """额外的用户消息内容部分列表，用于在用户消息后添加额外的内容块（如系统提醒、指令等）。支持 dict 或 ContentPart 对象"""
+    """额外的用户消息内容部分列表，用于在用户消息后添加额外的内容块（如系统提醒、指令等）。"""
     func_tool: ToolSet | None = None
     """可用的函数工具"""
     contexts: list[dict] = field(default_factory=list)
@@ -272,8 +272,6 @@ class LLMResponse:
     """Tool call extra content. tool_call_id -> extra_content dict"""
     reasoning_content: str = ""
     """The reasoning content extracted from the LLM, if any."""
-    reasoning_signature: str | None = None
-    """The signature of the reasoning content, if any."""
 
     raw_completion: (
         ChatCompletion | GenerateContentResponse | AnthropicMessage | None
@@ -294,14 +292,12 @@ class LLMResponse:
     def __init__(
         self,
         role: str,
-        completion_text: str | None = None,
+        completion_text: str = "",
         result_chain: MessageChain | None = None,
         tools_call_args: list[dict[str, Any]] | None = None,
         tools_call_name: list[str] | None = None,
         tools_call_ids: list[str] | None = None,
         tools_call_extra_content: dict[str, dict[str, Any]] | None = None,
-        reasoning_content: str | None = None,
-        reasoning_signature: str | None = None,
         raw_completion: ChatCompletion
         | GenerateContentResponse
         | AnthropicMessage
@@ -321,8 +317,6 @@ class LLMResponse:
             raw_completion (ChatCompletion, optional): 原始响应, OpenAI 格式. Defaults to None.
 
         """
-        if reasoning_content is None:
-            reasoning_content = ""
         if tools_call_args is None:
             tools_call_args = []
         if tools_call_name is None:
@@ -339,16 +333,9 @@ class LLMResponse:
         self.tools_call_name = tools_call_name
         self.tools_call_ids = tools_call_ids
         self.tools_call_extra_content = tools_call_extra_content
-        self.reasoning_content = reasoning_content
-        self.reasoning_signature = reasoning_signature
         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/provider/manager.py

@@ -119,34 +119,19 @@ class ProviderManager:
             TTSProvider,
         ):
             self.curr_tts_provider_inst = prov
-            await sp.put_async(
-                key="curr_provider_tts",
-                value=provider_id,
-                scope="global",
-                scope_id="global",
-            )
+            sp.put("curr_provider_tts", provider_id, scope="global", scope_id="global")
         elif provider_type == ProviderType.SPEECH_TO_TEXT and isinstance(
             prov,
             STTProvider,
         ):
             self.curr_stt_provider_inst = prov
-            await sp.put_async(
-                key="curr_provider_stt",
-                value=provider_id,
-                scope="global",
-                scope_id="global",
-            )
+            sp.put("curr_provider_stt", provider_id, scope="global", scope_id="global")
         elif provider_type == ProviderType.CHAT_COMPLETION and isinstance(
             prov,
             Provider,
         ):
             self.curr_provider_inst = prov
-            await sp.put_async(
-                key="curr_provider",
-                value=provider_id,
-                scope="global",
-                scope_id="global",
-            )
+            sp.put("curr_provider", provider_id, scope="global", scope_id="global")
 
     async def get_provider_by_id(self, provider_id: str) -> Providers | None:
         """根据提供商 ID 获取提供商实例"""
@@ -221,21 +206,21 @@ class ProviderManager:
                 logger.error(traceback.format_exc())
                 logger.error(e)
 
-        selected_provider_id = await sp.get_async(
-            key="curr_provider",
-            default=self.provider_settings.get("default_provider_id"),
+        selected_provider_id = sp.get(
+            "curr_provider",
+            self.provider_settings.get("default_provider_id"),
             scope="global",
             scope_id="global",
         )
-        selected_stt_provider_id = await sp.get_async(
-            key="curr_provider_stt",
-            default=self.provider_stt_settings.get("provider_id"),
+        selected_stt_provider_id = sp.get(
+            "curr_provider_stt",
+            self.provider_stt_settings.get("provider_id"),
             scope="global",
             scope_id="global",
         )
-        selected_tts_provider_id = await sp.get_async(
-            key="curr_provider_tts",
-            default=self.provider_tts_settings.get("provider_id"),
+        selected_tts_provider_id = sp.get(
+            "curr_provider_tts",
+            self.provider_tts_settings.get("provider_id"),
             scope="global",
             scope_id="global",
         )

astrbot/core/provider/provider.py

@@ -115,7 +115,7 @@ class Provider(AbstractProvider):
             tools: tool set
             contexts: 上下文，和 prompt 二选一使用
             tool_calls_result: 回传给 LLM 的工具调用结果。参考: https://platform.openai.com/docs/guides/function-calling
-            extra_user_content_parts: 额外的内容块列表，用于在用户消息后添加额外的文本块（如系统提醒、指令等）
+            extra_user_content_parts: 额外的用户内容块列表，用于在用户消息后添加额外的文本块（如系统提醒、指令等）
             kwargs: 其他参数
 
         Notes:
@@ -135,6 +135,7 @@ class Provider(AbstractProvider):
         system_prompt: str | None = None,
         tool_calls_result: ToolCallsResult | list[ToolCallsResult] | None = None,
         model: str | None = None,
+        extra_user_content_parts: list[ContentPart] | None = None,
         **kwargs,
     ) -> AsyncGenerator[LLMResponse, None]:
         """获得 LLM 的流式文本对话结果。会使用当前的模型进行对话。在生成的最后会返回一次完整的结果。
@@ -146,6 +147,7 @@ class Provider(AbstractProvider):
             tools: tool set
             contexts: 上下文，和 prompt 二选一使用
             tool_calls_result: 回传给 LLM 的工具调用结果。参考: https://platform.openai.com/docs/guides/function-calling
+            extra_user_content_parts: 额外的用户内容块列表，用于在用户消息后添加额外的文本块（如系统提醒、指令等）
             kwargs: 其他参数
 
         Notes:

astrbot/core/provider/sources/anthropic_source.py

@@ -11,7 +11,7 @@ from anthropic.types.usage import Usage
 
 from astrbot import logger
 from astrbot.api.provider import Provider
-from astrbot.core.agent.message import ContentPart, ImageURLPart, TextPart
+from astrbot.core.agent.message import ContentPart
 from astrbot.core.provider.entities import LLMResponse, TokenUsage
 from astrbot.core.provider.func_tool_manager import ToolSet
 from astrbot.core.utils.io import download_image_by_url
@@ -48,8 +48,6 @@ class ProviderAnthropic(Provider):
             base_url=self.base_url,
         )
 
-        self.thinking_config = provider_config.get("anth_thinking_config", {})
-
         self.set_model(provider_config.get("model", "unknown"))
 
     def _prepare_payload(self, messages: list[dict]):
@@ -66,33 +64,12 @@ class ProviderAnthropic(Provider):
         new_messages = []
         for message in messages:
             if message["role"] == "system":
-                system_prompt = message["content"] or "<empty system prompt>"
+                system_prompt = message["content"]
             elif message["role"] == "assistant":
                 blocks = []
-                reasoning_content = ""
-                thinking_signature = ""
-                if isinstance(message["content"], str) and message["content"].strip():
+                if isinstance(message["content"], str):
                     blocks.append({"type": "text", "text": message["content"]})
-                elif isinstance(message["content"], list):
-                    for part in message["content"]:
-                        if part.get("type") == "think":
-                            # only pick the last think part for now
-                            reasoning_content = part.get("think")
-                            thinking_signature = part.get("encrypted")
-                        else:
-                            blocks.append(part)
-
-                if reasoning_content and thinking_signature:
-                    blocks.insert(
-                        0,
-                        {
-                            "type": "thinking",
-                            "thinking": reasoning_content,
-                            "signature": thinking_signature,
-                        },
-                    )
-
-                if "tool_calls" in message and isinstance(message["tool_calls"], list):
+                if "tool_calls" in message:
                     for tool_call in message["tool_calls"]:
                         blocks.append(  # noqa: PERF401
                             {
@@ -123,7 +100,7 @@ class ProviderAnthropic(Provider):
                             {
                                 "type": "tool_result",
                                 "tool_use_id": message["tool_call_id"],
-                                "content": message["content"] or "<empty response>",
+                                "content": message["content"],
                             },
                         ],
                     },
@@ -156,14 +133,6 @@ class ProviderAnthropic(Provider):
 
         extra_body = self.provider_config.get("custom_extra_body", {})
 
-        if "max_tokens" not in payloads:
-            payloads["max_tokens"] = 1024
-        if self.thinking_config.get("budget"):
-            payloads["thinking"] = {
-                "budget_tokens": self.thinking_config.get("budget"),
-                "type": "enabled",
-            }
-
         completion = await self.client.messages.create(
             **payloads, stream=False, extra_body=extra_body
         )
@@ -181,11 +150,6 @@ class ProviderAnthropic(Provider):
                 completion_text = str(content_block.text).strip()
                 llm_response.completion_text = completion_text
 
-            if content_block.type == "thinking":
-                reasoning_content = str(content_block.thinking).strip()
-                llm_response.reasoning_content = reasoning_content
-                llm_response.reasoning_signature = content_block.signature
-
             if content_block.type == "tool_use":
                 llm_response.tools_call_args.append(content_block.input)
                 llm_response.tools_call_name.append(content_block.name)
@@ -217,16 +181,6 @@ class ProviderAnthropic(Provider):
         id = None
         usage = TokenUsage()
         extra_body = self.provider_config.get("custom_extra_body", {})
-        reasoning_content = ""
-        reasoning_signature = ""
-
-        if "max_tokens" not in payloads:
-            payloads["max_tokens"] = 1024
-        if self.thinking_config.get("budget"):
-            payloads["thinking"] = {
-                "budget_tokens": self.thinking_config.get("budget"),
-                "type": "enabled",
-            }
 
         async with self.client.messages.stream(
             **payloads, extra_body=extra_body
@@ -266,21 +220,6 @@ class ProviderAnthropic(Provider):
                             usage=usage,
                             id=id,
                         )
-                    elif event.delta.type == "thinking_delta":
-                        # 思考增量
-                        reasoning = event.delta.thinking
-                        if reasoning:
-                            yield LLMResponse(
-                                role="assistant",
-                                reasoning_content=reasoning,
-                                is_chunk=True,
-                                usage=usage,
-                                id=id,
-                                reasoning_signature=reasoning_signature or None,
-                            )
-                            reasoning_content += reasoning
-                    elif event.delta.type == "signature_delta":
-                        reasoning_signature = event.delta.signature
                     elif event.delta.type == "input_json_delta":
                         # 工具调用参数增量
                         if event.index in tool_use_buffer:
@@ -337,8 +276,6 @@ class ProviderAnthropic(Provider):
             is_chunk=False,
             usage=usage,
             id=id,
-            reasoning_content=reasoning_content,
-            reasoning_signature=reasoning_signature or None,
         )
 
         if final_tool_calls:
@@ -409,11 +346,11 @@ class ProviderAnthropic(Provider):
 
     async def text_chat_stream(
         self,
-        prompt=None,
+        prompt,
         session_id=None,
-        image_urls=None,
+        image_urls=...,
         func_tool=None,
-        contexts=None,
+        contexts=...,
         system_prompt=None,
         tool_calls_result=None,
         model=None,
@@ -465,39 +402,6 @@ class ProviderAnthropic(Provider):
         extra_user_content_parts: list[ContentPart] | None = None,
     ):
         """组装上下文，支持文本和图片"""
-
-        async def resolve_image_url(image_url: str) -> dict | None:
-            if image_url.startswith("http"):
-                image_path = await download_image_by_url(image_url)
-                image_data = await self.encode_image_bs64(image_path)
-            elif image_url.startswith("file:///"):
-                image_path = image_url.replace("file:///", "")
-                image_data = await self.encode_image_bs64(image_path)
-            else:
-                image_data = await self.encode_image_bs64(image_url)
-
-            if not image_data:
-                logger.warning(f"图片 {image_url} 得到的结果为空，将忽略。")
-                return None
-
-            # Get mime type for the image
-            mime_type, _ = guess_type(image_url)
-            if not mime_type:
-                mime_type = "image/jpeg"  # Default to JPEG if can't determine
-
-            return {
-                "type": "image",
-                "source": {
-                    "type": "base64",
-                    "media_type": mime_type,
-                    "data": (
-                        image_data.split("base64,")[1]
-                        if "base64," in image_data
-                        else image_data
-                    ),
-                },
-            }
-
         content = []
 
         # 1. 用户原始发言（OpenAI 建议：用户发言在前）
@@ -513,21 +417,82 @@ class ProviderAnthropic(Provider):
         # 2. 额外的内容块（系统提醒、指令等）
         if extra_user_content_parts:
             for block in extra_user_content_parts:
-                if isinstance(block, TextPart):
-                    content.append({"type": "text", "text": block.text})
-                elif isinstance(block, ImageURLPart):
-                    image_dict = await resolve_image_url(block.image_url.url)
-                    if image_dict:
-                        content.append(image_dict)
+                block_type = block.get("type")
+
+                if block_type == "text":
+                    # 文本直接添加
+                    content.append(block)
+
+                elif block_type == "image_url":
+                    # 转换 OpenAI 格式的图片为 Anthropic 格式
+                    image_url_data = block.get("image_url", {})
+                    if isinstance(image_url_data, dict):
+                        url = image_url_data.get("url", "")
+                    else:
+                        # 兼容直接传 URL 字符串的情况
+                        url = str(image_url_data)
+
+                    if url and url.startswith("data:"):
+                        try:
+                            # 提取 MIME 类型和 base64 数据
+                            mime_type = url.split(":")[1].split(";")[0]
+                            base64_data = (
+                                url.split("base64,")[1] if "base64," in url else url
+                            )
+                            content.append(
+                                {
+                                    "type": "image",
+                                    "source": {
+                                        "type": "base64",
+                                        "media_type": mime_type,
+                                        "data": base64_data,
+                                    },
+                                }
+                            )
+                        except Exception as e:
+                            logger.warning(f"转换 image_url 到 Anthropic 格式失败: {e}")
+                    else:
+                        logger.warning(f"image_url 不是有效的 data URI: {url[:50]}...")
+
                 else:
-                    raise ValueError(f"不支持的额外内容块类型: {type(block)}")
+                    # 其他类型（如 audio_url）Anthropic 不支持，记录警告
+                    logger.debug(f"Anthropic 不支持的内容类型 '{block_type}'，已忽略")
 
         # 3. 图片内容
         if image_urls:
             for image_url in image_urls:
-                image_dict = await resolve_image_url(image_url)
-                if image_dict:
-                    content.append(image_dict)
+                if image_url.startswith("http"):
+                    image_path = await download_image_by_url(image_url)
+                    image_data = await self.encode_image_bs64(image_path)
+                elif image_url.startswith("file:///"):
+                    image_path = image_url.replace("file:///", "")
+                    image_data = await self.encode_image_bs64(image_path)
+                else:
+                    image_data = await self.encode_image_bs64(image_url)
+
+                if not image_data:
+                    logger.warning(f"图片 {image_url} 得到的结果为空，将忽略。")
+                    continue
+
+                # Get mime type for the image
+                mime_type, _ = guess_type(image_url)
+                if not mime_type:
+                    mime_type = "image/jpeg"  # Default to JPEG if can't determine
+
+                content.append(
+                    {
+                        "type": "image",
+                        "source": {
+                            "type": "base64",
+                            "media_type": mime_type,
+                            "data": (
+                                image_data.split("base64,")[1]
+                                if "base64," in image_data
+                                else image_data
+                            ),
+                        },
+                    },
+                )
 
         # 如果只有主文本且没有额外内容块和图片，返回简单格式以保持向后兼容
         if (

astrbot/core/provider/sources/fishaudio_tts_api_source.py

@@ -56,14 +56,10 @@ class ProviderFishAudioTTSAPI(TTSProvider):
             "api_base",
             "https://api.fish-audio.cn/v1",
         )
-        try:
-            self.timeout: int = int(provider_config.get("timeout", 20))
-        except ValueError:
-            self.timeout = 20
         self.headers = {
             "Authorization": f"Bearer {self.chosen_api_key}",
         }
-        self.set_model(provider_config.get("model", None))
+        self.set_model(provider_config["model"])
 
     async def _get_reference_id_by_character(self, character: str) -> str | None:
         """获取角色的reference_id
@@ -139,21 +135,17 @@ class ProviderFishAudioTTSAPI(TTSProvider):
         path = os.path.join(temp_dir, f"fishaudio_tts_api_{uuid.uuid4()}.wav")
         self.headers["content-type"] = "application/msgpack"
         request = await self._generate_request(text)
-        async with AsyncClient(base_url=self.api_base, timeout=self.timeout).stream(
+        async with AsyncClient(base_url=self.api_base).stream(
             "POST",
             "/tts",
             headers=self.headers,
             content=ormsgpack.packb(request, option=ormsgpack.OPT_SERIALIZE_PYDANTIC),
         ) as response:
-            if response.status_code == 200 and response.headers.get(
-                "content-type", ""
-            ).startswith("audio/"):
+            if response.headers["content-type"] == "audio/wav":
                 with open(path, "wb") as f:
                     async for chunk in response.aiter_bytes():
                         f.write(chunk)
                 return path
-            error_bytes = await response.aread()
-            error_text = error_bytes.decode("utf-8", errors="replace")[:1024]
-            raise Exception(
-                f"Fish Audio API请求失败: 状态码 {response.status_code}, 响应内容: {error_text}"
-            )
+            body = await response.aread()
+            text = body.decode("utf-8", errors="replace")
+            raise Exception(f"Fish Audio API请求失败: {text}")

astrbot/core/provider/sources/gemini_source.py

@@ -13,7 +13,7 @@ from google.genai.errors import APIError
 import astrbot.core.message.components as Comp
 from astrbot import logger
 from astrbot.api.provider import Provider
-from astrbot.core.agent.message import ContentPart, ImageURLPart, TextPart
+from astrbot.core.agent.message import ContentPart
 from astrbot.core.message.message_event_result import MessageChain
 from astrbot.core.provider.entities import LLMResponse, TokenUsage
 from astrbot.core.provider.func_tool_manager import ToolSet
@@ -321,37 +321,9 @@ class ProviderGoogleGenAI(Provider):
                 append_or_extend(gemini_contents, parts, types.UserContent)
 
             elif role == "assistant":
-                if isinstance(content, str):
+                if content:
                     parts = [types.Part.from_text(text=content)]
                     append_or_extend(gemini_contents, parts, types.ModelContent)
-                elif isinstance(content, list):
-                    parts = []
-                    thinking_signature = None
-                    text = ""
-                    for part in content:
-                        # for most cases, assistant content only contains two parts: think and text
-                        if part.get("type") == "think":
-                            thinking_signature = part.get("encrypted") or None
-                        else:
-                            text += str(part.get("text"))
-
-                    if thinking_signature and isinstance(thinking_signature, str):
-                        try:
-                            thinking_signature = base64.b64decode(thinking_signature)
-                        except Exception as e:
-                            logger.warning(
-                                f"Failed to decode google gemini thinking signature: {e}",
-                                exc_info=True,
-                            )
-                            thinking_signature = None
-                    parts.append(
-                        types.Part(
-                            text=text,
-                            thought_signature=thinking_signature,
-                        )
-                    )
-                    append_or_extend(gemini_contents, parts, types.ModelContent)
-
                 elif not native_tool_enabled and "tool_calls" in message:
                     parts = []
                     for tool in message["tool_calls"]:
@@ -469,8 +441,7 @@ class ProviderGoogleGenAI(Provider):
         for part in result_parts:
             if part.text:
                 chain.append(Comp.Plain(part.text))
-
-            if (
+            elif (
                 part.function_call
                 and part.function_call.name is not None
                 and part.function_call.args is not None
@@ -487,18 +458,13 @@ class ProviderGoogleGenAI(Provider):
                     llm_response.tools_call_extra_content[tool_call_id] = {
                         "google": {"thought_signature": ts_bs64}
                     }
-
-            if (
+            elif (
                 part.inline_data
                 and part.inline_data.mime_type
                 and part.inline_data.mime_type.startswith("image/")
                 and part.inline_data.data
             ):
                 chain.append(Comp.Image.fromBytes(part.inline_data.data))
-
-            if ts := part.thought_signature:
-                # only keep the last thinking signature
-                llm_response.reasoning_signature = base64.b64encode(ts).decode("utf-8")
         return MessageChain(chain=chain)
 
     async def _query(self, payloads: dict, tools: ToolSet | None) -> LLMResponse:
@@ -845,24 +811,6 @@ class ProviderGoogleGenAI(Provider):
         extra_user_content_parts: list[ContentPart] | None = None,
     ):
         """组装上下文。"""
-
-        async def resolve_image_part(image_url: str) -> dict | None:
-            if image_url.startswith("http"):
-                image_path = await download_image_by_url(image_url)
-                image_data = await self.encode_image_bs64(image_path)
-            elif image_url.startswith("file:///"):
-                image_path = image_url.replace("file:///", "")
-                image_data = await self.encode_image_bs64(image_path)
-            else:
-                image_data = await self.encode_image_bs64(image_url)
-            if not image_data:
-                logger.warning(f"图片 {image_url} 得到的结果为空，将忽略。")
-                return None
-            return {
-                "type": "image_url",
-                "image_url": {"url": image_data},
-            }
-
         # 构建内容块列表
         content_blocks = []
 
@@ -879,21 +827,28 @@ class ProviderGoogleGenAI(Provider):
         # 2. 额外的内容块（系统提醒、指令等）
         if extra_user_content_parts:
             for part in extra_user_content_parts:
-                if isinstance(part, TextPart):
-                    content_blocks.append({"type": "text", "text": part.text})
-                elif isinstance(part, ImageURLPart):
-                    image_part = await resolve_image_part(part.image_url.url)
-                    if image_part:
-                        content_blocks.append(image_part)
-                else:
-                    raise ValueError(f"不支持的额外内容块类型: {type(part)}")
+                content_blocks.append(part.model_dump())
 
         # 3. 图片内容
         if image_urls:
             for image_url in image_urls:
-                image_part = await resolve_image_part(image_url)
-                if image_part:
-                    content_blocks.append(image_part)
+                if image_url.startswith("http"):
+                    image_path = await download_image_by_url(image_url)
+                    image_data = await self.encode_image_bs64(image_path)
+                elif image_url.startswith("file:///"):
+                    image_path = image_url.replace("file:///", "")
+                    image_data = await self.encode_image_bs64(image_path)
+                else:
+                    image_data = await self.encode_image_bs64(image_url)
+                if not image_data:
+                    logger.warning(f"图片 {image_url} 得到的结果为空，将忽略。")
+                    continue
+                content_blocks.append(
+                    {
+                        "type": "image_url",
+                        "image_url": {"url": image_data},
+                    },
+                )
 
         # 如果只有主文本且没有额外内容块和图片，返回简单格式以保持向后兼容
         if (

astrbot/core/provider/sources/minimax_tts_api_source.py

@@ -51,7 +51,7 @@ class ProviderMiniMaxTTSAPI(TTSProvider):
             "voice_id": ""
             if self.is_timber_weight
             else provider_config.get("minimax-voice-id", ""),
-            "emotion": provider_config.get("minimax-voice-emotion", "auto"),
+            "emotion": provider_config.get("minimax-voice-emotion", "neutral"),
             "latex_read": provider_config.get("minimax-voice-latex", False),
             "english_normalization": provider_config.get(
                 "minimax-voice-english-normalization",
@@ -59,9 +59,6 @@ class ProviderMiniMaxTTSAPI(TTSProvider):
             ),
         }
 
-        if self.voice_setting["emotion"] == "auto":
-            self.voice_setting.pop("emotion", None)
-
         self.audio_setting: dict = {
             "sample_rate": 32000,
             "bitrate": 128000,

astrbot/core/provider/sources/openai_source.py

@@ -17,7 +17,7 @@ from openai.types.completion_usage import CompletionUsage
 import astrbot.core.message.components as Comp
 from astrbot import logger
 from astrbot.api.provider import Provider
-from astrbot.core.agent.message import ContentPart, ImageURLPart, Message, TextPart
+from astrbot.core.agent.message import ContentPart, Message
 from astrbot.core.agent.tool import ToolSet
 from astrbot.core.message.message_event_result import MessageChain
 from astrbot.core.provider.entities import LLMResponse, TokenUsage, ToolCallsResult
@@ -74,6 +74,28 @@ class ProviderOpenAIOfficial(Provider):
 
         self.reasoning_key = "reasoning_content"
 
+    def _maybe_inject_xai_search(self, payloads: dict, **kwargs):
+        """当开启 xAI 原生搜索时，向请求体注入 Live Search 参数。
+
+        - 仅在 provider_config.xai_native_search 为 True 时生效
+        - 默认注入 {"mode": "auto"}
+        - 允许通过 kwargs 使用 xai_search_mode 覆盖（on/auto/off）
+        """
+        if not bool(self.provider_config.get("xai_native_search", False)):
+            return
+
+        mode = kwargs.get("xai_search_mode", "auto")
+        mode = str(mode).lower()
+        if mode not in ("auto", "on", "off"):
+            mode = "auto"
+
+        # off 时不注入，保持与未开启一致
+        if mode == "off":
+            return
+
+        # OpenAI SDK 不识别的字段会在 _query/_query_stream 中放入 extra_body
+        payloads["search_parameters"] = {"mode": mode}
+
     async def get_models(self):
         try:
             models_str = []
@@ -112,6 +134,10 @@ class ProviderOpenAIOfficial(Provider):
 
         model = payloads.get("model", "").lower()
 
+        # 针对 deepseek 模型的特殊处理：deepseek-reasoner调用必须移除 tools ，否则将被切换至 deepseek-chat
+        if model == "deepseek-reasoner" and "tools" in payloads:
+            del payloads["tools"]
+
         completion = await self.client.chat.completions.create(
             **payloads,
             stream=False,
@@ -225,14 +251,10 @@ class ProviderOpenAIOfficial(Provider):
     def _extract_usage(self, usage: CompletionUsage) -> TokenUsage:
         ptd = usage.prompt_tokens_details
         cached = ptd.cached_tokens if ptd and ptd.cached_tokens else 0
-        prompt_tokens = 0 if usage.prompt_tokens is None else usage.prompt_tokens
-        completion_tokens = (
-            0 if usage.completion_tokens is None else usage.completion_tokens
-        )
         return TokenUsage(
-            input_other=prompt_tokens - cached,
-            input_cached=cached,
-            output=completion_tokens,
+            input_other=usage.prompt_tokens - cached,
+            input_cached=ptd.cached_tokens if ptd and ptd.cached_tokens else 0,
+            output=usage.completion_tokens,
         )
 
     async def _parse_openai_completion(
@@ -359,28 +381,11 @@ class ProviderOpenAIOfficial(Provider):
 
         payloads = {"messages": context_query, "model": model}
 
-        self._finally_convert_payload(payloads)
+        # xAI origin search tool inject
+        self._maybe_inject_xai_search(payloads, **kwargs)
 
         return payloads, context_query
 
-    def _finally_convert_payload(self, payloads: dict):
-        """Finally convert the payload. Such as think part conversion, tool inject."""
-        for message in payloads.get("messages", []):
-            if message.get("role") == "assistant" and isinstance(
-                message.get("content"), list
-            ):
-                reasoning_content = ""
-                new_content = []  # not including think part
-                for part in message["content"]:
-                    if part.get("type") == "think":
-                        reasoning_content += str(part.get("think"))
-                    else:
-                        new_content.append(part)
-                message["content"] = new_content
-                # reasoning key is "reasoning_content"
-                if reasoning_content:
-                    message["reasoning_content"] = reasoning_content
-
     async def _handle_api_error(
         self,
         e: Exception,
@@ -539,6 +544,7 @@ class ProviderOpenAIOfficial(Provider):
         system_prompt=None,
         tool_calls_result=None,
         model=None,
+        extra_user_content_parts=None,
         **kwargs,
     ) -> AsyncGenerator[LLMResponse, None]:
         """流式对话，与服务商交互并逐步返回结果"""
@@ -549,6 +555,7 @@ class ProviderOpenAIOfficial(Provider):
             system_prompt,
             tool_calls_result,
             model=model,
+            extra_user_content_parts=extra_user_content_parts,
             **kwargs,
         )
 
@@ -627,24 +634,6 @@ class ProviderOpenAIOfficial(Provider):
         extra_user_content_parts: list[ContentPart] | None = None,
     ) -> dict:
         """组装成符合 OpenAI 格式的 role 为 user 的消息段"""
-
-        async def resolve_image_part(image_url: str) -> dict | None:
-            if image_url.startswith("http"):
-                image_path = await download_image_by_url(image_url)
-                image_data = await self.encode_image_bs64(image_path)
-            elif image_url.startswith("file:///"):
-                image_path = image_url.replace("file:///", "")
-                image_data = await self.encode_image_bs64(image_path)
-            else:
-                image_data = await self.encode_image_bs64(image_url)
-            if not image_data:
-                logger.warning(f"图片 {image_url} 得到的结果为空，将忽略。")
-                return None
-            return {
-                "type": "image_url",
-                "image_url": {"url": image_data},
-            }
-
         # 构建内容块列表
         content_blocks = []
 
@@ -661,21 +650,28 @@ class ProviderOpenAIOfficial(Provider):
         # 2. 额外的内容块（系统提醒、指令等）
         if extra_user_content_parts:
             for part in extra_user_content_parts:
-                if isinstance(part, TextPart):
-                    content_blocks.append({"type": "text", "text": part.text})
-                elif isinstance(part, ImageURLPart):
-                    image_part = await resolve_image_part(part.image_url.url)
-                    if image_part:
-                        content_blocks.append(image_part)
-                else:
-                    raise ValueError(f"不支持的额外内容块类型: {type(part)}")
+                content_blocks.append(part.model_dump())
 
         # 3. 图片内容
         if image_urls:
             for image_url in image_urls:
-                image_part = await resolve_image_part(image_url)
-                if image_part:
-                    content_blocks.append(image_part)
+                if image_url.startswith("http"):
+                    image_path = await download_image_by_url(image_url)
+                    image_data = await self.encode_image_bs64(image_path)
+                elif image_url.startswith("file:///"):
+                    image_path = image_url.replace("file:///", "")
+                    image_data = await self.encode_image_bs64(image_path)
+                else:
+                    image_data = await self.encode_image_bs64(image_url)
+                if not image_data:
+                    logger.warning(f"图片 {image_url} 得到的结果为空，将忽略。")
+                    continue
+                content_blocks.append(
+                    {
+                        "type": "image_url",
+                        "image_url": {"url": image_data},
+                    },
+                )
 
         # 如果只有主文本且没有额外内容块和图片，返回简单格式以保持向后兼容
         if (

astrbot/core/provider/sources/xai_source.py

@@ -1,29 +0,0 @@
-from ..register import register_provider_adapter
-from .openai_source import ProviderOpenAIOfficial
-
-
-@register_provider_adapter(
-    "xai_chat_completion", "xAI Chat Completion Provider Adapter"
-)
-class ProviderXAI(ProviderOpenAIOfficial):
-    def __init__(
-        self,
-        provider_config: dict,
-        provider_settings: dict,
-    ) -> None:
-        super().__init__(provider_config, provider_settings)
-
-    def _maybe_inject_xai_search(self, payloads: dict):
-        """当开启 xAI 原生搜索时，向请求体注入 Live Search 参数。
-
-        - 仅在 provider_config.xai_native_search 为 True 时生效
-        - 默认注入 {"mode": "auto"}
-        """
-        if not bool(self.provider_config.get("xai_native_search", False)):
-            return
-        # OpenAI SDK 不识别的字段会在 _query/_query_stream 中放入 extra_body
-        payloads["search_parameters"] = {"mode": "auto"}
-
-    def _finally_convert_payload(self, payloads: dict):
-        self._maybe_inject_xai_search(payloads)
-        super()._finally_convert_payload(payloads)

astrbot/core/provider/sources/xinference_stt_provider.py

@@ -8,10 +8,7 @@ from xinference_client.client.restful.async_restful_client import (
 
 from astrbot.core import logger
 from astrbot.core.utils.astrbot_path import get_astrbot_data_path
-from astrbot.core.utils.tencent_record_helper import (
-    convert_to_pcm_wav,
-    tencent_silk_to_wav,
-)
+from astrbot.core.utils.tencent_record_helper import tencent_silk_to_wav
 
 from ..entities import ProviderType
 from ..provider import STTProvider
@@ -114,22 +111,17 @@ class ProviderXinferenceSTT(STTProvider):
                 return ""
 
             # 2. Check for conversion
-            conversion_type = None
-
-            if b"SILK" in audio_bytes[:8]:
-                conversion_type = "silk"
-            elif b"#!AMR" in audio_bytes[:6]:
-                conversion_type = "amr"
-            elif audio_url.endswith(".silk") or is_tencent:
-                conversion_type = "silk"
-            elif audio_url.endswith(".amr"):
-                conversion_type = "amr"
+            needs_conversion = False
+            if (
+                audio_url.endswith((".amr", ".silk"))
+                or is_tencent
+                or b"SILK" in audio_bytes[:8]
+            ):
+                needs_conversion = True
 
             # 3. Perform conversion if needed
-            if conversion_type:
-                logger.info(
-                    f"Audio requires conversion ({conversion_type}), using temporary files..."
-                )
+            if needs_conversion:
+                logger.info("Audio requires conversion, using temporary files...")
                 temp_dir = os.path.join(get_astrbot_data_path(), "temp")
                 os.makedirs(temp_dir, exist_ok=True)
 
@@ -140,12 +132,8 @@ class ProviderXinferenceSTT(STTProvider):
                 with open(input_path, "wb") as f:
                     f.write(audio_bytes)
 
-                if conversion_type == "silk":
-                    logger.info("Converting silk to wav ...")
-                    await tencent_silk_to_wav(input_path, output_path)
-                elif conversion_type == "amr":
-                    logger.info("Converting amr to wav ...")
-                    await convert_to_pcm_wav(input_path, output_path)
+                logger.info("Converting silk/amr file to wav ...")
+                await tencent_silk_to_wav(input_path, output_path)
 
                 with open(output_path, "rb") as f:
                     audio_bytes = f.read()

astrbot/core/star/context.py

@@ -149,12 +149,9 @@ class Context:
             contexts: context messages for the LLM
             max_steps: Maximum number of tool calls before stopping the loop
             **kwargs: Additional keyword arguments. The kwargs will not be passed to the LLM directly for now, but can include:
-                stream: bool - whether to stream the LLM response
                 agent_hooks: BaseAgentRunHooks[AstrAgentContext] - hooks to run during agent execution
                 agent_context: AstrAgentContext - context to use for the agent
 
-                other kwargs will be DIRECTLY passed to the runner.reset() method
-
         Returns:
             The final LLMResponse after tool calls are completed.
 
@@ -197,15 +194,6 @@ class Context:
             )
         agent_runner = ToolLoopAgentRunner()
         tool_executor = FunctionToolExecutor()
-
-        streaming = kwargs.get("stream", False)
-
-        other_kwargs = {
-            k: v
-            for k, v in kwargs.items()
-            if k not in ["stream", "agent_hooks", "agent_context"]
-        }
-
         await agent_runner.reset(
             provider=prov,
             request=request,
@@ -215,8 +203,7 @@ class Context:
             ),
             tool_executor=tool_executor,
             agent_hooks=agent_hooks,
-            streaming=streaming,
-            **other_kwargs,
+            streaming=kwargs.get("stream", False),
         )
         async for _ in agent_runner.step_until_done(max_steps):
             pass
@@ -390,7 +377,7 @@ class Context:
             if not module_path:
                 _parts = []
                 module_part = tool.__module__.split(".")
-                flags = ["builtin_stars", "plugins"]
+                flags = ["packages", "plugins"]
                 for i, part in enumerate(module_part):
                     _parts.append(part)
                     if part in flags and i + 1 < len(module_part):

astrbot/core/star/filter/platform_adapter_type.py

@@ -12,6 +12,7 @@ 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()
@@ -26,6 +27,7 @@ class PlatformAdapterType(enum.Flag):
         | TELEGRAM
         | WECOM
         | LARK
+        | WECHATPADPRO
         | DINGTALK
         | DISCORD
         | SLACK
@@ -47,6 +49,7 @@ 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/register/__init__.py

@@ -12,7 +12,6 @@ from .star_handler import (
     register_on_llm_request,
     register_on_llm_response,
     register_on_platform_loaded,
-    register_on_waiting_llm_request,
     register_permission_type,
     register_platform_adapter_type,
     register_regex,
@@ -31,7 +30,6 @@ __all__ = [
     "register_on_llm_request",
     "register_on_llm_response",
     "register_on_platform_loaded",
-    "register_on_waiting_llm_request",
     "register_permission_type",
     "register_platform_adapter_type",
     "register_regex",

astrbot/core/star/register/star_handler.py

@@ -339,30 +339,6 @@ def register_on_platform_loaded(**kwargs):
     return decorator
 
 
-def register_on_waiting_llm_request(**kwargs):
-    """当等待调用 LLM 时的通知事件（在获取锁之前）
-
-    此钩子在消息确定要调用 LLM 但还未开始排队等锁时触发，
-    适合用于发送"正在思考中..."等用户反馈提示。
-
-    Examples:
-    ```py
-    @on_waiting_llm_request()
-    async def on_waiting_llm(self, event: AstrMessageEvent) -> None:
-        await event.send("🤔 正在思考中...")
-    ```
-
-    """
-
-    def decorator(awaitable):
-        _ = get_handler_or_create(
-            awaitable, EventType.OnWaitingLLMRequestEvent, **kwargs
-        )
-        return awaitable
-
-    return decorator
-
-
 def register_on_llm_request(**kwargs):
     """当有 LLM 请求时的事件
 

astrbot/core/star/session_llm_manager.py

@@ -12,7 +12,7 @@ class SessionServiceManager:
     # =============================================================================
 
     @staticmethod
-    async def is_llm_enabled_for_session(session_id: str) -> bool:
+    def is_llm_enabled_for_session(session_id: str) -> bool:
         """检查LLM是否在指定会话中启用
 
         Args:
@@ -23,11 +23,11 @@ class SessionServiceManager:
 
         """
         # 获取会话服务配置
-        session_services = await sp.get_async(
+        session_services = sp.get(
+            "session_service_config",
+            {},
             scope="umo",
             scope_id=session_id,
-            key="session_service_config",
-            default={},
         )
 
         # 如果配置了该会话的LLM状态，返回该状态
@@ -39,7 +39,7 @@ class SessionServiceManager:
         return True
 
     @staticmethod
-    async def set_llm_status_for_session(session_id: str, enabled: bool) -> None:
+    def set_llm_status_for_session(session_id: str, enabled: bool) -> None:
         """设置LLM在指定会话中的启停状态
 
         Args:
@@ -48,24 +48,18 @@ class SessionServiceManager:
 
         """
         session_config = (
-            await sp.get_async(
-                scope="umo",
-                scope_id=session_id,
-                key="session_service_config",
-                default={},
-            )
-            or {}
+            sp.get("session_service_config", {}, scope="umo", scope_id=session_id) or {}
         )
         session_config["llm_enabled"] = enabled
-        await sp.put_async(
+        sp.put(
+            "session_service_config",
+            session_config,
             scope="umo",
             scope_id=session_id,
-            key="session_service_config",
-            value=session_config,
         )
 
     @staticmethod
-    async def should_process_llm_request(event: AstrMessageEvent) -> bool:
+    def should_process_llm_request(event: AstrMessageEvent) -> bool:
         """检查是否应该处理LLM请求
 
         Args:
@@ -76,14 +70,14 @@ class SessionServiceManager:
 
         """
         session_id = event.unified_msg_origin
-        return await SessionServiceManager.is_llm_enabled_for_session(session_id)
+        return SessionServiceManager.is_llm_enabled_for_session(session_id)
 
     # =============================================================================
     # TTS 相关方法
     # =============================================================================
 
     @staticmethod
-    async def is_tts_enabled_for_session(session_id: str) -> bool:
+    def is_tts_enabled_for_session(session_id: str) -> bool:
         """检查TTS是否在指定会话中启用
 
         Args:
@@ -94,11 +88,11 @@ class SessionServiceManager:
 
         """
         # 获取会话服务配置
-        session_services = await sp.get_async(
+        session_services = sp.get(
+            "session_service_config",
+            {},
             scope="umo",
             scope_id=session_id,
-            key="session_service_config",
-            default={},
         )
 
         # 如果配置了该会话的TTS状态，返回该状态
@@ -110,7 +104,7 @@ class SessionServiceManager:
         return True
 
     @staticmethod
-    async def set_tts_status_for_session(session_id: str, enabled: bool) -> None:
+    def set_tts_status_for_session(session_id: str, enabled: bool) -> None:
         """设置TTS在指定会话中的启停状态
 
         Args:
@@ -119,20 +113,14 @@ class SessionServiceManager:
 
         """
         session_config = (
-            await sp.get_async(
-                scope="umo",
-                scope_id=session_id,
-                key="session_service_config",
-                default={},
-            )
-            or {}
+            sp.get("session_service_config", {}, scope="umo", scope_id=session_id) or {}
         )
         session_config["tts_enabled"] = enabled
-        await sp.put_async(
+        sp.put(
+            "session_service_config",
+            session_config,
             scope="umo",
             scope_id=session_id,
-            key="session_service_config",
-            value=session_config,
         )
 
         logger.info(
@@ -140,7 +128,7 @@ class SessionServiceManager:
         )
 
     @staticmethod
-    async def should_process_tts_request(event: AstrMessageEvent) -> bool:
+    def should_process_tts_request(event: AstrMessageEvent) -> bool:
         """检查是否应该处理TTS请求
 
         Args:
@@ -151,14 +139,14 @@ class SessionServiceManager:
 
         """
         session_id = event.unified_msg_origin
-        return await SessionServiceManager.is_tts_enabled_for_session(session_id)
+        return SessionServiceManager.is_tts_enabled_for_session(session_id)
 
     # =============================================================================
     # 会话整体启停相关方法
     # =============================================================================
 
     @staticmethod
-    async def is_session_enabled(session_id: str) -> bool:
+    def is_session_enabled(session_id: str) -> bool:
         """检查会话是否整体启用
 
         Args:
@@ -169,11 +157,11 @@ class SessionServiceManager:
 
         """
         # 获取会话服务配置
-        session_services = await sp.get_async(
+        session_services = sp.get(
+            "session_service_config",
+            {},
             scope="umo",
             scope_id=session_id,
-            key="session_service_config",
-            default={},
         )
 
         # 如果配置了该会话的整体状态，返回该状态

astrbot/core/star/session_plugin_manager.py

@@ -8,10 +8,7 @@ class SessionPluginManager:
     """管理会话级别的插件启停状态"""
 
     @staticmethod
-    async def is_plugin_enabled_for_session(
-        session_id: str,
-        plugin_name: str,
-    ) -> bool:
+    def is_plugin_enabled_for_session(session_id: str, plugin_name: str) -> bool:
         """检查插件是否在指定会话中启用
 
         Args:
@@ -23,11 +20,11 @@ class SessionPluginManager:
 
         """
         # 获取会话插件配置
-        session_plugin_config = await sp.get_async(
+        session_plugin_config = sp.get(
+            "session_plugin_config",
+            {},
             scope="umo",
             scope_id=session_id,
-            key="session_plugin_config",
-            default={},
         )
         session_config = session_plugin_config.get(session_id, {})
 
@@ -46,10 +43,7 @@ class SessionPluginManager:
         return True
 
     @staticmethod
-    async def filter_handlers_by_session(
-        event: AstrMessageEvent,
-        handlers: list,
-    ) -> list:
+    def filter_handlers_by_session(event: AstrMessageEvent, handlers: list) -> list:
         """根据会话配置过滤处理器列表
 
         Args:
@@ -65,15 +59,6 @@ class SessionPluginManager:
         session_id = event.unified_msg_origin
         filtered_handlers = []
 
-        session_plugin_config = await sp.get_async(
-            scope="umo",
-            scope_id=session_id,
-            key="session_plugin_config",
-            default={},
-        )
-        session_config = session_plugin_config.get(session_id, {})
-        disabled_plugins = session_config.get("disabled_plugins", [])
-
         for handler in handlers:
             # 获取处理器对应的插件
             plugin = star_map.get(handler.handler_module_path)
@@ -91,11 +76,14 @@ class SessionPluginManager:
                 continue
 
             # 检查插件是否在当前会话中启用
-            if plugin.name in disabled_plugins:
+            if SessionPluginManager.is_plugin_enabled_for_session(
+                session_id,
+                plugin.name,
+            ):
+                filtered_handlers.append(handler)
+            else:
                 logger.debug(
                     f"插件 {plugin.name} 在会话 {session_id} 中被禁用，跳过处理器 {handler.handler_name}",
                 )
-            else:
-                filtered_handlers.append(handler)
 
         return filtered_handlers

astrbot/core/star/star_handler.py

@@ -184,7 +184,6 @@ class EventType(enum.Enum):
     OnPlatformLoadedEvent = enum.auto()  # 平台加载完成
 
     AdapterMessageEvent = enum.auto()  # 收到适配器发来的消息
-    OnWaitingLLMRequestEvent = enum.auto()  # 等待调用 LLM（在获取锁之前，仅通知）
     OnLLMRequestEvent = enum.auto()  # 收到 LLM 请求（可以是用户也可以是插件）
     OnLLMResponseEvent = enum.auto()  # LLM 响应后
     OnDecoratingResultEvent = enum.auto()  # 发送消息前

astrbot/core/star/star_manager.py

@@ -18,11 +18,9 @@ from astrbot.core.config.astrbot_config import AstrBotConfig
 from astrbot.core.provider.register import llm_tools
 from astrbot.core.utils.astrbot_path import (
     get_astrbot_config_path,
-    get_astrbot_path,
     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
@@ -51,10 +49,13 @@ class PluginManager:
         """存储插件的路径。即 data/plugins"""
         self.plugin_config_path = get_astrbot_config_path()
         """存储插件配置的路径。data/config"""
-        self.reserved_plugin_path = os.path.join(
-            get_astrbot_path(), "astrbot", "builtin_stars"
+        self.reserved_plugin_path = os.path.abspath(
+            os.path.join(
+                os.path.dirname(os.path.abspath(__file__)),
+                "../../../packages",
+            ),
         )
-        """保留插件的路径。在 astrbot/builtin_stars 目录下"""
+        """保留插件的路径。在 packages 目录下"""
         self.conf_schema_fname = "_conf_schema.json"
         self.logo_fname = "logo.png"
         """插件配置 Schema 文件名"""
@@ -251,7 +252,7 @@ class PluginManager:
             list[str]: 与该插件相关的模块名列表
 
         """
-        prefix = "astrbot.builtin_stars." if is_reserved else "data.plugins."
+        prefix = "packages." if is_reserved else "data.plugins."
         return [
             key
             for key in list(sys.modules.keys())
@@ -269,7 +270,7 @@ class PluginManager:
         可以基于模块名模式或插件目录名移除模块，用于清理插件相关的模块缓存
 
         Args:
-            module_patterns: 要移除的模块名模式列表（例如 ["data.plugins", "astrbot.builtin_stars"]）
+            module_patterns: 要移除的模块名模式列表（例如 ["data.plugins", "packages"]）
             root_dir_name: 插件根目录名，用于移除与该插件相关的所有模块
             is_reserved: 插件是否为保留插件（影响模块路径前缀）
 
@@ -381,9 +382,9 @@ class PluginManager:
                 reserved = plugin_module.get(
                     "reserved",
                     False,
-                )  # 是否是保留插件。目前在 astrbot/builtin_stars 目录下的都是保留插件。保留插件不可以卸载。
+                )  # 是否是保留插件。目前在 packages/ 目录下的都是保留插件。保留插件不可以卸载。
 
-                path = "data.plugins." if not reserved else "astrbot.builtin_stars."
+                path = "data.plugins." if not reserved else "packages."
                 path += root_dir_name + "." + module_str
 
                 # 检查是否需要载入指定的插件
@@ -657,14 +658,6 @@ 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
@@ -836,7 +829,7 @@ class PluginManager:
             if (
                 mp
                 and mp.startswith(plugin_module_path)
-                and not mp.endswith(("astrbot.builtin_stars", "data.plugins"))
+                and not mp.endswith(("packages", "data.plugins"))
             ):
                 to_remove.append(func_tool)
         for func_tool in to_remove:
@@ -891,7 +884,7 @@ class PluginManager:
                     plugin.module_path
                     and mp
                     and plugin.module_path.startswith(mp)
-                    and not mp.endswith(("astrbot.builtin_stars", "data.plugins"))
+                    and not mp.endswith(("packages", "data.plugins"))
                 ):
                     func_tool.active = False
                     if func_tool.name not in inactivated_llm_tools:
@@ -940,7 +933,7 @@ class PluginManager:
                 plugin.module_path
                 and mp
                 and plugin.module_path.startswith(mp)
-                and not mp.endswith(("astrbot.builtin_stars", "data.plugins"))
+                and not mp.endswith(("packages", "data.plugins"))
                 and func_tool.name in inactivated_llm_tools
             ):
                 inactivated_llm_tools.remove(func_tool.name)
@@ -953,49 +946,8 @@ class PluginManager:
         dir_name = os.path.basename(zip_file_path).replace(".zip", "")
         dir_name = dir_name.removesuffix("-master").removesuffix("-main").lower()
         desti_dir = os.path.join(self.plugin_store_path, dir_name)
-
-        # 第一步：检查是否已安装同目录名的插件，先终止旧插件
-        existing_plugin = None
-        for star in self.context.get_all_stars():
-            if star.root_dir_name == dir_name:
-                existing_plugin = star
-                break
-
-        if existing_plugin:
-            logger.info(f"检测到插件 {existing_plugin.name} 已安装，正在终止旧插件...")
-            try:
-                await self._terminate_plugin(existing_plugin)
-            except Exception:
-                logger.warning(traceback.format_exc())
-            if existing_plugin.name and existing_plugin.module_path:
-                await self._unbind_plugin(
-                    existing_plugin.name, existing_plugin.module_path
-                )
-
         self.updator.unzip_file(zip_file_path, desti_dir)
 
-        # 第二步：解压后，读取新插件的 metadata.yaml，检查是否存在同名但不同目录的插件
-        try:
-            new_metadata = self._load_plugin_metadata(desti_dir)
-            if new_metadata and new_metadata.name:
-                for star in self.context.get_all_stars():
-                    if (
-                        star.name == new_metadata.name
-                        and star.root_dir_name != dir_name
-                    ):
-                        logger.warning(
-                            f"检测到同名插件 {star.name} 存在于不同目录 {star.root_dir_name}，正在终止..."
-                        )
-                        try:
-                            await self._terminate_plugin(star)
-                        except Exception:
-                            logger.warning(traceback.format_exc())
-                        if star.name and star.module_path:
-                            await self._unbind_plugin(star.name, star.module_path)
-                        break  # 只处理第一个匹配的
-        except Exception as e:
-            logger.debug(f"读取新插件 metadata.yaml 失败，跳过同名检查: {e!s}")
-
         # remove the zip
         try:
             os.remove(zip_file_path)
@@ -1034,12 +986,4 @@ 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/core/umop_config_router.py

@@ -1,5 +1,3 @@
-import fnmatch
-
 from astrbot.core.utils.shared_preferences import SharedPreferences
 
 
@@ -11,15 +9,14 @@ class UmopConfigRouter:
         """UMOP 到配置文件 ID 的映射"""
         self.sp = sp
 
-    async def initialize(self):
-        await self._load_routing_table()
+        self._load_routing_table()
 
-    async def _load_routing_table(self):
+    def _load_routing_table(self):
         """加载路由表"""
         # 从 SharedPreferences 中加载 umop_to_conf_id 映射
-        sp_data = await self.sp.get_async(
-            key="umop_config_routing",
-            default={},
+        sp_data = self.sp.get(
+            "umop_config_routing",
+            {},
             scope="global",
             scope_id="global",
         )
@@ -33,7 +30,7 @@ class UmopConfigRouter:
         if len(p1_ls) != 3 or len(p2_ls) != 3:
             return False  # 非法格式
 
-        return all(p == "" or fnmatch.fnmatchcase(t, p) for p, t in zip(p1_ls, p2_ls))
+        return all(p == "" or p == "*" or p == t for p, t in zip(p1_ls, p2_ls))
 
     def get_conf_id_for_umop(self, umo: str) -> str | None:
         """根据 UMO 获取对应的配置文件 ID

astrbot/core/utils/astrbot_path.py

@@ -5,10 +5,6 @@
 数据目录路径：固定为根目录下的 data 目录
 配置文件路径：固定为数据目录下的 config 目录
 插件目录路径：固定为数据目录下的 plugins 目录
-插件数据目录路径：固定为数据目录下的 plugin_data 目录
-T2I 模板目录路径：固定为数据目录下的 t2i_templates 目录
-WebChat 数据目录路径：固定为数据目录下的 webchat 目录
-临时文件目录路径：固定为数据目录下的 temp 目录
 """
 
 import os
@@ -41,33 +37,3 @@ def get_astrbot_config_path() -> str:
 def get_astrbot_plugin_path() -> str:
     """获取Astrbot插件目录路径"""
     return os.path.realpath(os.path.join(get_astrbot_data_path(), "plugins"))
-
-
-def get_astrbot_plugin_data_path() -> str:
-    """获取Astrbot插件数据目录路径"""
-    return os.path.realpath(os.path.join(get_astrbot_data_path(), "plugin_data"))
-
-
-def get_astrbot_t2i_templates_path() -> str:
-    """获取Astrbot T2I 模板目录路径"""
-    return os.path.realpath(os.path.join(get_astrbot_data_path(), "t2i_templates"))
-
-
-def get_astrbot_webchat_path() -> str:
-    """获取Astrbot WebChat 数据目录路径"""
-    return os.path.realpath(os.path.join(get_astrbot_data_path(), "webchat"))
-
-
-def get_astrbot_temp_path() -> str:
-    """获取Astrbot临时文件目录路径"""
-    return os.path.realpath(os.path.join(get_astrbot_data_path(), "temp"))
-
-
-def get_astrbot_knowledge_base_path() -> str:
-    """获取Astrbot知识库根目录路径"""
-    return os.path.realpath(os.path.join(get_astrbot_data_path(), "knowledge_base"))
-
-
-def get_astrbot_backups_path() -> str:
-    """获取Astrbot备份目录路径"""
-    return os.path.realpath(os.path.join(get_astrbot_data_path(), "backups"))

astrbot/core/utils/migra_helper.py

@@ -3,7 +3,6 @@ import traceback
 from astrbot.core import astrbot_config, logger
 from astrbot.core.astrbot_config_mgr import AstrBotConfig, AstrBotConfigManager
 from astrbot.core.db.migration.migra_45_to_46 import migrate_45_to_46
-from astrbot.core.db.migration.migra_token_usage import migrate_token_usage
 from astrbot.core.db.migration.migra_webchat_session import migrate_webchat_session
 
 
@@ -140,13 +139,6 @@ async def migra(
         logger.error(f"Migration for webchat session failed: {e!s}")
         logger.error(traceback.format_exc())
 
-    # migration for token_usage column
-    try:
-        await migrate_token_usage(db)
-    except Exception as e:
-        logger.error(f"Migration for token_usage column failed: {e!s}")
-        logger.error(traceback.format_exc())
-
     # migra third party agent runner configs
     _c = False
     providers = astrbot_config["provider"]

astrbot/core/utils/pip_installer.py

@@ -1,29 +1,10 @@
 import asyncio
-import locale
 import logging
 import sys
 
 logger = logging.getLogger("astrbot")
 
 
-def _robust_decode(line: bytes) -> str:
-    """解码字节流，兼容不同平台的编码"""
-    try:
-        return line.decode("utf-8").strip()
-    except UnicodeDecodeError:
-        pass
-    try:
-        return line.decode(locale.getpreferredencoding(False)).strip()
-    except UnicodeDecodeError:
-        pass
-    if sys.platform.startswith("win"):
-        try:
-            return line.decode("gbk").strip()
-        except UnicodeDecodeError:
-            pass
-    return line.decode("utf-8", errors="replace").strip()
-
-
 class PipInstaller:
     def __init__(self, pip_install_arg: str, pypi_index_url: str | None = None):
         self.pip_install_arg = pip_install_arg
@@ -61,7 +42,7 @@ class PipInstaller:
 
             assert process.stdout is not None
             async for line in process.stdout:
-                logger.info(_robust_decode(line))
+                logger.info(line.decode().strip())
 
             await process.wait()
 

astrbot/dashboard/routes/__init__.py

@@ -1,5 +1,4 @@
 from .auth import AuthRoute
-from .backup import BackupRoute
 from .chat import ChatRoute
 from .command import CommandRoute
 from .config import ConfigRoute
@@ -18,7 +17,6 @@ from .update import UpdateRoute
 
 __all__ = [
     "AuthRoute",
-    "BackupRoute",
     "ChatRoute",
     "CommandRoute",
     "ConfigRoute",

astrbot/dashboard/routes/config.py

@@ -46,46 +46,6 @@ def try_cast(value: Any, type_: str):
             return None
 
 
-def _expect_type(value, expected_type, path_key, errors, expected_name=None):
-    if not isinstance(value, expected_type):
-        errors.append(
-            f"错误的类型 {path_key}: 期望是 {expected_name or expected_type.__name__}, "
-            f"得到了 {type(value).__name__}"
-        )
-        return False
-    return True
-
-
-def _validate_template_list(value, meta, path_key, errors, validate_fn):
-    if not _expect_type(value, list, path_key, errors, "list"):
-        return
-
-    templates = meta.get("templates")
-    if not isinstance(templates, dict):
-        templates = {}
-
-    for idx, item in enumerate(value):
-        item_path = f"{path_key}[{idx}]"
-        if not _expect_type(item, dict, item_path, errors, "dict"):
-            continue
-
-        template_key = item.get("__template_key") or item.get("template")
-        if not template_key:
-            errors.append(f"缺少模板选择 {item_path}: 需要 __template_key")
-            continue
-
-        template_meta = templates.get(template_key)
-        if not template_meta:
-            errors.append(f"未知模板 {item_path}: {template_key}")
-            continue
-
-        validate_fn(
-            item,
-            template_meta.get("items", {}),
-            path=f"{item_path}.",
-        )
-
-
 def validate_config(data, schema: dict, is_core: bool) -> tuple[list[str], dict]:
     errors = []
 
@@ -101,11 +61,6 @@ def validate_config(data, schema: dict, is_core: bool) -> tuple[list[str], dict]
             if value is None:
                 data[key] = DEFAULT_VALUE_MAP[meta["type"]]
                 continue
-
-            if meta["type"] == "template_list":
-                _validate_template_list(value, meta, f"{path}{key}", errors, validate)
-                continue
-
             if meta["type"] == "list" and not isinstance(value, list):
                 errors.append(
                     f"错误的类型 {path}{key}: 期望是 list, 得到了 {type(value).__name__}",
@@ -625,7 +580,7 @@ class ConfigRoute(Route):
         provider_list = []
         ps = self.core_lifecycle.provider_manager.providers_config
         p_source_pt = {
-            psrc["id"]: psrc.get("provider_type", "chat_completion")
+            psrc["id"]: psrc["provider_type"]
             for psrc in self.core_lifecycle.provider_manager.provider_sources_config
         }
         for provider in ps:
@@ -640,7 +595,7 @@ class ConfigRoute(Route):
                     provider
                 )
                 provider_list.append(prov)
-            elif not ps_id and provider.get("provider_type", "") in provider_type_ls:
+            elif not ps_id and provider.get("provider_type", None) in provider_type_ls:
                 # agent runner, embedding, etc
                 provider_list.append(provider)
         return Response().ok(provider_list).__dict__

astrbot/dashboard/routes/log.py

@@ -1,26 +1,15 @@
 import asyncio
 import json
-import time
-from collections.abc import AsyncGenerator
 from typing import cast
 
 from quart import Response as QuartResponse
-from quart import make_response, request
+from quart import make_response
 
 from astrbot.core import LogBroker, logger
 
 from .route import Response, Route, RouteContext
 
 
-def _format_log_sse(log: dict, ts: float) -> str:
-    """辅助函数：格式化 SSE 消息"""
-    payload = {
-        "type": "log",
-        **log,
-    }
-    return f"id: {ts}\ndata: {json.dumps(payload, ensure_ascii=False)}\n\n"
-
-
 class LogRoute(Route):
     def __init__(self, context: RouteContext, log_broker: LogBroker) -> None:
         super().__init__(context)
@@ -32,44 +21,21 @@ class LogRoute(Route):
             methods=["GET"],
         )
 
-    async def _replay_cached_logs(
-        self, last_event_id: str
-    ) -> AsyncGenerator[str, None]:
-        """辅助生成器：重放缓存的日志"""
-        try:
-            last_ts = float(last_event_id)
-            cached_logs = list(self.log_broker.log_cache)
-
-            for log_item in cached_logs:
-                log_ts = float(log_item.get("time", 0))
-
-                if log_ts > last_ts:
-                    yield _format_log_sse(log_item, log_ts)
-
-        except ValueError:
-            pass
-        except Exception as e:
-            logger.error(f"Log SSE 补发历史错误: {e}")
-
-    async def log(self) -> QuartResponse:
-        last_event_id = request.headers.get("Last-Event-ID")
-
+    async def log(self):
         async def stream():
             queue = None
             try:
-                if last_event_id:
-                    async for event in self._replay_cached_logs(last_event_id):
-                        yield event
-
                 queue = self.log_broker.register()
                 while True:
                     message = await queue.get()
-                    current_ts = message.get("time", time.time())
-                    yield _format_log_sse(message, current_ts)
-
+                    payload = {
+                        "type": "log",
+                        **message,  # see astrbot/core/log.py
+                    }
+                    yield f"data: {json.dumps(payload, ensure_ascii=False)}\n\n"
             except asyncio.CancelledError:
                 pass
-            except Exception as e:
+            except BaseException as e:
                 logger.error(f"Log SSE 连接错误: {e}")
             finally:
                 if queue:
@@ -87,7 +53,7 @@ class LogRoute(Route):
                 },
             ),
         )
-        response.timeout = None  # type: ignore
+        response.timeout = None
         return response
 
     async def log_history(self):
@@ -103,6 +69,6 @@ class LogRoute(Route):
                 )
                 .__dict__
             )
-        except Exception as e:
+        except BaseException as e:
             logger.error(f"获取日志历史失败: {e}")
             return Response().error(f"获取日志历史失败: {e}").__dict__

astrbot/dashboard/routes/plugin.py

@@ -55,7 +55,6 @@ 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),
         }
@@ -616,55 +615,6 @@ 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", [])

astrbot/dashboard/server.py

@@ -19,7 +19,6 @@ from astrbot.core.utils.astrbot_path import get_astrbot_data_path
 from astrbot.core.utils.io import get_local_ip_addresses
 
 from .routes import *
-from .routes.backup import BackupRoute
 from .routes.platform import PlatformRoute
 from .routes.route import Response, RouteContext
 from .routes.session_management import SessionManagementRoute
@@ -86,7 +85,6 @@ class AstrBotDashboard:
         self.t2i_route = T2iRoute(self.context, core_lifecycle)
         self.kb_route = KnowledgeBaseRoute(self.context, core_lifecycle)
         self.platform_route = PlatformRoute(self.context, core_lifecycle)
-        self.backup_route = BackupRoute(self.context, db, core_lifecycle)
 
         self.app.add_url_rule(
             "/api/plug/<path:subpath>",
@@ -110,13 +108,7 @@ class AstrBotDashboard:
     async def auth_middleware(self):
         if not request.path.startswith("/api"):
             return None
-        allowed_endpoints = [
-            "/api/auth/login",
-            "/api/file",
-            "/api/platform/webhook",
-            "/api/stat/start-time",
-            "/api/backup/download",  # 备份下载使用 URL 参数传递 token
-        ]
+        allowed_endpoints = ["/api/auth/login", "/api/file", "/api/platform/webhook"]
         if any(request.path.startswith(prefix) for prefix in allowed_endpoints):
             return None
         # 声明 JWT

changelogs/v4.10.3.md

@@ -1,18 +0,0 @@
-## What's Changed
-
-### 修复
-
-1. 修复 FishAudio TTS 不可用的问题；
-2. 修复 Anthropic API Chat Provider 部分情况下请求报错的问题；
-3. 修复部分情况下 WebUI 日志重建连接之后丢失日志的问题；
-4. 修复部分情况下 /provider 指令报错 index out of range 的问题；
-5. 修复通过 `uv` 或者 cli 方式启动 AstrBot，缺少所有内置插件的问题。
-
-### 优化
-
-1. 丢弃值为 None 的 `tool_call_id` 和 `tool_calls` 字段，提高接口兼容性。
-
-### 新增
-
-1. 支持备份 AstrBot 数据和导入数据功能（Beta）。入口：WebUi -> 设置 -> 备份。
-2. text_chat 和 text_chat_stream 接口支持额外用户内容块参数 `extra_user_content_parts`，用于在用户消息后添加额外的内容块（如系统提醒、指令等）。

changelogs/v4.10.4.md

@@ -1,25 +0,0 @@
-## What's Changed
-
-### 修复
-
-- 修复钉钉适配器中"回复消息 At 发送人"功能失效的问题
-- 修复 Xinference STT 在部分情况下无法使用的问题
-- 修复"会话隔离"功能在非默认配置下无法生效的问题
-- 修复部分 LLM 中转商因 token 使用情况不符合 OpenAI 标准接口规范导致请求报错的问题
-- 修复 Deepseek 模型开启思考模式后工具调用报错的问题
-- 修复部分操作系统环境下 pip 安装依赖时出现 `UnicodeDecodeError` 错误的问题
-
-### 优化
-
-- 全面优化对思考型模型的支持（如 Anthropic Extended Thinking、Deepseek 思考模式），完整回传 thinking 内容，提升模型推理性能
-- 优化 WebUI 记忆侧边栏中"更多功能"和"平台日志"模块的展开状态记忆
-- 为 MiniMax TTS 新增 "auto" 音色情绪选项，支持模型根据文本内容自动选择情绪
-- 优化备份功能，支持大文件分片下载
-- 为 WebSocket 连接添加 max_size 参数，以处理更大的消息并防止接收来自 Satori 平台的大负载时连接断开
-- 优化插件安装流程，通过文件安装插件时，若插件已加载则先终止再重新加载，避免重复加载
-- 知识库支持将 overlap 参数设置为 0
-
-### 新增
-
-- 为 `dict` 类型的 Schema 新增 JSON value 和 template schema 功能。详见 [dict-类型的-schema](https://docs.astrbot.app/dev/star/guides/plugin-config.html#dict-%E7%B1%BB%E5%9E%8B%E7%9A%84-schema)。
-- 新增 `template_list` 类型的 Schema，支持渲染指定 template 下的列表。详见 [template-list-类型的-schema](https://docs.astrbot.app/dev/star/guides/plugin-config.html#template-list-%E7%B1%BB%E5%9E%8B%E7%9A%84-schema)。

changelogs/v4.10.5.md

@@ -1,5 +0,0 @@
-## What's Changed
-
-hotfix of v4.10.4
-
-fix: 部分配置项的输入框不显示，如飞书机器人配置的部分配置项。（#4268）

changelogs/v4.10.6.md

@@ -1,11 +0,0 @@
-## What's Changed
-
-hotfix of v4.10.4
-
-fix: 
-
-1. ‼️ 部分情况下使用 OpenAI 接口报错与 reasoning_content 有关的问题；
-
-feat:
-
-1. WebUI 已安装插件页支持记忆视图类型（列表/卡片），列表视图显示插件的人类友好名称和 logo。

changelogs/v4.11.0.md

@@ -1,19 +0,0 @@
-## What's Changed
-
-### 新增
-
-- 支持上下文自动压缩功能。入口：配置文件 -> 上下文管理策略 -> 超出模型上下文窗口时的处理方式。详情请查看： [自动上下文压缩](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.1.md

@@ -1,26 +0,0 @@
-## 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

@@ -1,15 +0,0 @@
-## 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/package.json

@@ -22,7 +22,6 @@
     "axios-mock-adapter": "^1.22.0",
     "chance": "1.1.11",
     "date-fns": "2.30.0",
-    "event-source-polyfill": "^1.0.31",
     "highlight.js": "^11.11.1",
     "js-md5": "^0.8.3",
     "katex": "^0.16.27",

dashboard/src/components/provider/ProviderModelsPanel.vue

@@ -44,16 +44,14 @@
     >
       <template v-if="entries.length > 0">
         <template v-for="entry in entries" :key="entry.type === 'configured' ? `provider-${entry.provider.id}` : `model-${entry.model}`">
-          <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
+            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-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">
@@ -84,7 +82,7 @@
                   {{ tm('availability.test') }}
                   <template #activator="{ props }">
                     <v-btn
-                      icon="mdi-connection"
+                      icon="mdi-wrench"
                       size="small"
                       variant="text"
                       :disabled="!entry.provider.enable"
@@ -95,34 +93,13 @@
                   </template>
                 </v-tooltip>
 
-                <v-tooltip location="top" max-width="300">
-                  {{ tm('models.configure') }}
-                  <template #activator="{ props }">
-                    <v-btn
-                      icon="mdi-cog"
-                      size="small"
-                      variant="text"
-                      v-bind="props"
-                      @click.stop="emit('open-provider-edit', entry.provider)"
-                    ></v-btn>
-                  </template>
-                </v-tooltip>
-
                 <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>
-            </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-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 v-else 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">
@@ -138,15 +115,10 @@
                 {{ formatContextLimit(entry.metadata) }}
               </span>
             </v-list-item-subtitle>
-                <template #append>
-                  <v-btn icon="mdi-plus" size="small" variant="text" color="primary"></v-btn>
-                </template>
-              </v-list-item>
+            <template #append>
+              <v-btn icon="mdi-plus" size="small" variant="text" color="primary"></v-btn>
             </template>
-            <div>
-              <div><strong>{{ tm('models.tooltips.modelId') }}:</strong> {{ entry.model }}</div>
-            </div>
-          </v-tooltip>
+          </v-list-item>
         </template>
       </template>
       <template v-else>

dashboard/src/components/shared/AstrBotConfig.vue

@@ -1,8 +1,11 @@
 <script setup>
 import { VueMonacoEditor } from '@guolao/vue-monaco-editor'
 import { ref, computed } from 'vue'
-import ConfigItemRenderer from './ConfigItemRenderer.vue'
-import TemplateListEditor from './TemplateListEditor.vue'
+import ListConfigItem from './ListConfigItem.vue'
+import ObjectEditor from './ObjectEditor.vue'
+import ProviderSelector from './ProviderSelector.vue'
+import PersonaSelector from './PersonaSelector.vue'
+import KnowledgeBaseSelector from './KnowledgeBaseSelector.vue'
 import { useI18n } from '@/i18n/composables'
 import axios from 'axios'
 import { useToast } from '@/utils/toast'
@@ -156,30 +159,6 @@ function hasVisibleItemsAfter(items, currentIndex) {
           </div>
         </div>
 
-        <!-- Template List -->
-        <div v-else-if="metadata[metadataKey].items[key]?.type === 'template_list'" class="nested-object w-100">
-          <div v-if="!metadata[metadataKey].items[key]?.invisible && shouldShowItem(metadata[metadataKey].items[key], key)" class="nested-container">
-            <div class="config-section mb-2">
-              <v-list-item-title class="config-title">
-                <span v-if="metadata[metadataKey].items[key]?.description">
-                  {{ metadata[metadataKey].items[key]?.description }}
-                  <span class="property-key">({{ key }})</span>
-                </span>
-                <span v-else>{{ key }}</span>
-              </v-list-item-title>
-              <v-list-item-subtitle class="config-hint">
-                <span v-if="metadata[metadataKey].items[key]?.obvious_hint && metadata[metadataKey].items[key]?.hint" class="important-hint">‼️</span>
-                {{ metadata[metadataKey].items[key]?.hint }}
-              </v-list-item-subtitle>
-            </div>
-            <TemplateListEditor
-              v-model="iterable[key]"
-              :templates="metadata[metadataKey].items[key]?.templates || {}"
-              class="config-field"
-            />
-          </div>
-        </div>
-
         <!-- Regular Property -->
         <template v-else>
           <v-row v-if="!metadata[metadataKey].items[key]?.invisible && shouldShowItem(metadata[metadataKey].items[key], key)" class="config-row">
@@ -202,14 +181,202 @@ function hasVisibleItemsAfter(items, currentIndex) {
             </v-col>
 
             <v-col cols="12" sm="6" class="config-input">
-              <ConfigItemRenderer
-                v-model="iterable[key]"
-                :item-meta="metadata[metadataKey].items[key] || null"
-                :loading="loadingEmbeddingDim"
-                :show-fullscreen-btn="!!metadata[metadataKey].items[key]?.editor_mode"
-                @get-embedding-dim="getEmbeddingDimensions(iterable)"
-                @open-fullscreen="openEditorDialog(key, iterable, metadata[metadataKey].items[key]?.editor_theme, metadata[metadataKey].items[key]?.editor_language)"
-              />
+              <div v-if="metadata[metadataKey].items[key]" class="w-100">
+                <!-- Special handling for specific metadata types -->
+                <div v-if="metadata[metadataKey].items[key]?._special === 'select_provider'">
+                  <ProviderSelector
+                    v-model="iterable[key]"
+                    :provider-type="'chat_completion'"
+                  />
+                </div>
+                <div v-else-if="metadata[metadataKey].items[key]?._special === 'select_provider_stt'">
+                  <ProviderSelector
+                    v-model="iterable[key]"
+                    :provider-type="'speech_to_text'"
+                  />
+                </div>
+                <div v-else-if="metadata[metadataKey].items[key]?._special === 'select_provider_tts'">
+                  <ProviderSelector
+                    v-model="iterable[key]"
+                    :provider-type="'text_to_speech'"
+                  />
+                </div>
+                <div v-else-if="metadata[metadataKey].items[key]?._special === 'select_persona'">
+                  <PersonaSelector
+                    v-model="iterable[key]"
+                  />
+                </div>
+                <div v-else-if="metadata[metadataKey].items[key]?._special === 'select_knowledgebase'">
+                  <KnowledgeBaseSelector
+                    v-model="iterable[key]"
+                  />
+                </div>
+                <!-- Numeric input with get_embedding_dim button -->
+                <div v-else-if="metadata[metadataKey].items[key]?._special === 'get_embedding_dim'"
+                  class="d-flex align-center gap-2">
+                  <v-text-field
+                    v-model="iterable[key]"
+                    density="compact"
+                    variant="outlined"
+                    class="config-field"
+                    type="number"
+                    hide-details
+                  ></v-text-field>
+                  <v-btn
+                    color="primary"
+                    variant="tonal"
+                    size="small"
+                    @click="getEmbeddingDimensions(iterable)"
+                    :loading="loadingEmbeddingDim"
+                    class="ml-2"
+                  >
+                    自动检测
+                  </v-btn>
+                </div>
+
+                <!-- List item with options-->
+                <div v-else-if="metadata[metadataKey].items[key]?.type === 'list' && metadata[metadataKey].items[key]?.options && !metadata[metadataKey].items[key]?.invisible && metadata[metadataKey].items[key]?.render_type === 'checkbox'"
+                  class="d-flex flex-wrap gap-20">
+                  <v-checkbox
+                    v-for="(option, index) in metadata[metadataKey].items[key]?.options"
+                    v-model="iterable[key]"
+                    :label="metadata[metadataKey].items[key]?.labels ? metadata[metadataKey].items[key].labels[index] : option"
+                    :value="option"
+                    class="mr-2"
+                    color="primary"
+                    hide-details
+                  ></v-checkbox>
+                </div>
+                <!-- List item with options-->
+                <v-combobox
+                  v-else-if="metadata[metadataKey].items[key]?.type === 'list' && metadata[metadataKey].items[key]?.options && !metadata[metadataKey].items[key]?.invisible"
+                  v-model="iterable[key]"
+                  :items="metadata[metadataKey].items[key]?.options"
+                  :disabled="metadata[metadataKey].items[key]?.readonly"
+                  density="compact"
+                  variant="outlined"
+                  class="config-field"
+                  hide-details
+                  chips
+                  multiple
+                ></v-combobox>
+                <!-- Select input -->
+                <v-select
+                  v-else-if="metadata[metadataKey].items[key]?.options && !metadata[metadataKey].items[key]?.invisible"
+                  v-model="iterable[key]"
+                  :items="metadata[metadataKey].items[key]?.options"
+                  :disabled="metadata[metadataKey].items[key]?.readonly"
+                  density="compact"
+                  variant="outlined"
+                  class="config-field"
+                  hide-details
+                ></v-select>
+
+                <!-- Code Editor with Full Screen Option -->
+                <div v-else-if="metadata[metadataKey].items[key]?.editor_mode && !metadata[metadataKey].items[key]?.invisible" class="editor-container">
+                  <VueMonacoEditor
+                    :theme="metadata[metadataKey].items[key]?.editor_theme || 'vs-light'"
+                    :language="metadata[metadataKey].items[key]?.editor_language || 'json'"
+                    style="min-height: 100px; flex-grow: 1; border: 1px solid rgba(0, 0, 0, 0.1);"
+                    v-model:value="iterable[key]"
+                  >
+                  </VueMonacoEditor>
+                  <v-btn
+                    icon
+                    size="small"
+                    variant="text"
+                    color="primary"
+                    class="editor-fullscreen-btn"
+                    @click="openEditorDialog(key, iterable, metadata[metadataKey].items[key]?.editor_theme, metadata[metadataKey].items[key]?.editor_language)"
+                    :title="t('core.common.editor.fullscreen')"
+                  >
+                    <v-icon>mdi-fullscreen</v-icon>
+                  </v-btn>
+                </div>
+
+                <!-- String input -->
+                <v-text-field
+                  v-else-if="metadata[metadataKey].items[key]?.type === 'string' && !metadata[metadataKey].items[key]?.invisible"
+                  v-model="iterable[key]"
+                  density="compact"
+                  variant="outlined"
+                  class="config-field"
+                  hide-details
+                ></v-text-field>
+
+                <!-- Numeric input with optional slider -->
+                <div
+                  v-else-if="(metadata[metadataKey].items[key]?.type === 'int' || metadata[metadataKey].items[key]?.type === 'float') && !metadata[metadataKey]?.invisible"
+                  class="d-flex align-center gap-3"
+                >
+                  <v-slider
+                    v-if="metadata[metadataKey].items[key]?.slider"
+                    v-model.number="iterable[key]"
+                    :min="metadata[metadataKey].items[key]?.slider?.min ?? 0"
+                    :max="metadata[metadataKey].items[key]?.slider?.max ?? 100"
+                    :step="metadata[metadataKey].items[key]?.slider?.step ?? 1"
+                    color="primary"
+                    density="compact"
+                    hide-details
+                    class="flex-grow-1"
+                  ></v-slider>
+                  <v-text-field
+                    v-model.number="iterable[key]"
+                    density="compact"
+                    variant="outlined"
+                    class="config-field"
+                    type="number"
+                    hide-details
+                    style="max-width: 140px;"
+                  ></v-text-field>
+                </div>
+
+                <!-- Text area -->
+                <v-textarea
+                  v-else-if="metadata[metadataKey].items[key]?.type === 'text' && !metadata[metadataKey].items[key]?.invisible"
+                  v-model="iterable[key]"
+                  variant="outlined"
+                  rows="3"
+                  class="config-field"
+                  hide-details
+                ></v-textarea>
+
+                <!-- Boolean switch -->
+                <v-switch
+                  v-else-if="metadata[metadataKey].items[key]?.type === 'bool' && !metadata[metadataKey].items[key]?.invisible"
+                  v-model="iterable[key]"
+                  color="primary"
+                  inset
+                  density="compact"
+                  hide-details
+                ></v-switch>
+
+                <!-- List item -->
+                <ListConfigItem
+                  v-else-if="metadata[metadataKey].items[key]?.type === 'list' && !metadata[metadataKey].items[key]?.invisible"
+                  v-model="iterable[key]"
+                  class="config-field"
+                />
+
+                <!-- Dict item (key-value editor) -->
+                <ObjectEditor
+                  v-else-if="metadata[metadataKey].items[key]?.type === 'dict' && !metadata[metadataKey].items[key]?.invisible"
+                  v-model="iterable[key]"
+                  class="config-field"
+                />
+              </div>
+
+              <!-- Fallback for unknown metadata -->
+              <div v-else class="w-100">
+                <v-text-field
+                  v-model="iterable[key]"
+                  :label="key"
+                  density="compact"
+                  variant="outlined"
+                  class="config-field"
+                  hide-details
+                ></v-text-field>
+              </div>
             </v-col>
           </v-row>
 
@@ -239,17 +406,84 @@ function hasVisibleItemsAfter(items, currentIndex) {
         </v-col>
 
         <v-col cols="12" sm="5" class="config-input">
-          <TemplateListEditor
-            v-if="metadata[metadataKey]?.type === 'template_list' && !metadata[metadataKey]?.invisible"
-            v-model="iterable[metadataKey]"
-            :templates="metadata[metadataKey]?.templates || {}"
-            class="config-field"
-          />
-          <ConfigItemRenderer
-            v-else
-            v-model="iterable[metadataKey]"
-            :item-meta="metadata[metadataKey]"
-          />
+          <div class="w-100">
+            <!-- Select input -->
+            <v-select
+              v-if="metadata[metadataKey]?.options && !metadata[metadataKey]?.invisible"
+              v-model="iterable[metadataKey]"
+              :items="metadata[metadataKey]?.options"
+              :disabled="metadata[metadataKey]?.readonly"
+              density="compact"
+              variant="outlined"
+              class="config-field"
+              hide-details
+            ></v-select>
+
+            <!-- String input -->
+            <v-text-field
+              v-else-if="metadata[metadataKey]?.type === 'string' && !metadata[metadataKey]?.invisible"
+              v-model="iterable[metadataKey]"
+              density="compact"
+              variant="outlined"
+              class="config-field"
+              hide-details
+            ></v-text-field>
+
+            <!-- Numeric input with optional slider -->
+            <div
+              v-else-if="(metadata[metadataKey]?.type === 'int' || metadata[metadataKey]?.type === 'float') && !metadata[metadataKey]?.invisible"
+              class="d-flex align-center gap-3"
+            >
+              <v-slider
+                v-if="metadata[metadataKey]?.slider"
+                v-model.number="iterable[metadataKey]"
+                :min="metadata[metadataKey]?.slider?.min ?? 0"
+                :max="metadata[metadataKey]?.slider?.max ?? 100"
+                :step="metadata[metadataKey]?.slider?.step ?? 1"
+                color="primary"
+                density="compact"
+                hide-details
+                class="flex-grow-1"
+              ></v-slider>
+              <v-text-field
+                v-model.number="iterable[metadataKey]"
+                density="compact"
+                variant="outlined"
+                class="config-field"
+                type="number"
+                hide-details
+                style="max-width: 140px;"
+              ></v-text-field>
+            </div>
+
+            <!-- Text area -->
+            <v-textarea
+              v-else-if="metadata[metadataKey]?.type === 'text' && !metadata[metadataKey]?.invisible"
+              v-model="iterable[metadataKey]"
+              variant="outlined"
+              auto-grow
+              rows="3"
+              class="config-field"
+              hide-details
+            ></v-textarea>
+
+            <!-- Boolean switch -->
+            <v-switch
+              v-else-if="metadata[metadataKey]?.type === 'bool' && !metadata[metadataKey]?.invisible"
+              v-model="iterable[metadataKey]"
+              color="primary"
+              inset
+              density="compact"
+              hide-details
+            ></v-switch>
+
+            <!-- List item -->
+            <ListConfigItem
+              v-else-if="metadata[metadataKey]?.type === 'list' && !metadata[metadataKey]?.invisible"
+              v-model="iterable[metadataKey]"
+              class="config-field"
+            />
+          </div>
         </v-col>
       </v-row>
 

dashboard/src/components/shared/AstrBotConfigV4.vue

@@ -1,8 +1,13 @@
 <script setup>
 import { VueMonacoEditor } from '@guolao/vue-monaco-editor'
 import { ref, computed } from 'vue'
-import ConfigItemRenderer from './ConfigItemRenderer.vue'
-import TemplateListEditor from './TemplateListEditor.vue'
+import ListConfigItem from './ListConfigItem.vue'
+import ObjectEditor from './ObjectEditor.vue'
+import ProviderSelector from './ProviderSelector.vue'
+import PersonaSelector from './PersonaSelector.vue'
+import KnowledgeBaseSelector from './KnowledgeBaseSelector.vue'
+import PluginSetSelector from './PluginSetSelector.vue'
+import T2ITemplateEditor from './T2ITemplateEditor.vue'
 import { useI18n, useModuleI18n } from '@/i18n/composables'
 
 
@@ -210,19 +215,118 @@ function getSpecialSubtype(value) {
               </v-list-item>
             </v-col>
             <v-col cols="12" sm="6" class="config-input">
-              <TemplateListEditor
-                v-if="itemMeta?.type === 'template_list'"
-                v-model="createSelectorModel(itemKey).value"
-                :templates="itemMeta?.templates || {}"
-                class="config-field"
-              />
-              <ConfigItemRenderer
-                v-else
-                v-model="createSelectorModel(itemKey).value"
-                :item-meta="itemMeta || null"
-                :show-fullscreen-btn="!!itemMeta?.editor_mode"
-                @open-fullscreen="openEditorDialog(itemKey, iterable, itemMeta?.editor_theme, itemMeta?.editor_language)"
-              />
+              <div class="w-100" v-if="!itemMeta?._special">
+                <!-- Select input for JSON selector -->
+                <v-select v-if="itemMeta?.options" v-model="createSelectorModel(itemKey).value"
+                  :items="(() => {
+                    const labels = getTranslatedLabels(itemMeta);
+                    return labels 
+                      ? itemMeta.options.map((value, index) => ({ title: labels[index] || value, value: value }))
+                      : itemMeta.options;
+                  })()" 
+                  :disabled="itemMeta?.readonly" density="compact" variant="outlined"
+                  class="config-field" hide-details></v-select>
+
+                <!-- Code Editor for JSON selector -->
+                <div v-else-if="itemMeta?.editor_mode" class="editor-container">
+                  <VueMonacoEditor :theme="itemMeta?.editor_theme || 'vs-light'"
+                    :language="itemMeta?.editor_language || 'json'"
+                    style="min-height: 100px; flex-grow: 1; border: 1px solid rgba(0, 0, 0, 0.1);"
+                    v-model:value="createSelectorModel(itemKey).value">
+                  </VueMonacoEditor>
+                  <v-btn icon size="small" variant="text" color="primary" class="editor-fullscreen-btn"
+                    @click="openEditorDialog(itemKey, iterable, itemMeta?.editor_theme, itemMeta?.editor_language)"
+                    :title="t('core.common.editor.fullscreen')">
+                    <v-icon>mdi-fullscreen</v-icon>
+                  </v-btn>
+                </div>
+
+                <!-- String input for JSON selector -->
+                <v-text-field v-else-if="itemMeta?.type === 'string'" v-model="createSelectorModel(itemKey).value"
+                  density="compact" variant="outlined" class="config-field" hide-details></v-text-field>
+
+                <!-- Numeric input with optional slider for JSON selector -->
+                <div v-else-if="itemMeta?.type === 'int' || itemMeta?.type === 'float'" class="d-flex align-center gap-3">
+                  <v-slider
+                    v-if="itemMeta?.slider"
+                    v-model.number="createSelectorModel(itemKey).value"
+                    :min="itemMeta?.slider?.min ?? 0"
+                    :max="itemMeta?.slider?.max ?? 100"
+                    :step="itemMeta?.slider?.step ?? 1"
+                    color="primary"
+                    density="compact"
+                    hide-details
+                    style="flex: 3"
+                  ></v-slider>
+                  <v-text-field
+                    v-model.number="createSelectorModel(itemKey).value"
+                    density="compact"
+                    variant="outlined"
+                    class="config-field"
+                    style="flex: 2"
+                    type="number"
+                    hide-details
+                  ></v-text-field>
+                </div>
+
+                <!-- Text area for JSON selector -->
+                <v-textarea v-else-if="itemMeta?.type === 'text'" v-model="createSelectorModel(itemKey).value"
+                  variant="outlined" rows="3" class="config-field" hide-details></v-textarea>
+
+                <!-- Boolean switch for JSON selector -->
+                <v-switch v-else-if="itemMeta?.type === 'bool'" v-model="createSelectorModel(itemKey).value"
+                  color="primary" inset density="compact" hide-details
+                  style="display: flex; justify-content: end;"></v-switch>
+
+                <!-- List item for JSON selector -->
+                <ListConfigItem v-else-if="itemMeta?.type === 'list'" v-model="createSelectorModel(itemKey).value"
+                  button-text="修改" class="config-field" />
+
+                <!-- Object editor for JSON selector -->
+                <ObjectEditor v-else-if="itemMeta?.type === 'dict'" v-model="createSelectorModel(itemKey).value"
+                  class="config-field" />
+
+                <!-- Fallback for JSON selector -->
+                <v-text-field v-else v-model="createSelectorModel(itemKey).value" density="compact" variant="outlined"
+                  class="config-field" hide-details></v-text-field>
+              </div>
+
+              <!-- Special handling for specific metadata types -->
+              <div v-else-if="itemMeta?._special === 'select_provider'">
+                <ProviderSelector v-model="createSelectorModel(itemKey).value" :provider-type="'chat_completion'" />
+              </div>
+              <div v-else-if="itemMeta?._special === 'select_provider_stt'">
+                <ProviderSelector v-model="createSelectorModel(itemKey).value" :provider-type="'speech_to_text'" />
+              </div>
+              <div v-else-if="itemMeta?._special === 'select_provider_tts'">
+                <ProviderSelector v-model="createSelectorModel(itemKey).value" :provider-type="'text_to_speech'" />
+              </div>
+              <div v-else-if="getSpecialName(itemMeta?._special) === 'select_agent_runner_provider'">
+                <ProviderSelector
+                  v-model="createSelectorModel(itemKey).value"
+                  :provider-type="'agent_runner'"
+                  :provider-subtype="getSpecialSubtype(itemMeta?._special)"
+                />
+              </div>
+              <div v-else-if="itemMeta?._special === 'provider_pool'">
+                <ProviderSelector v-model="createSelectorModel(itemKey).value" :provider-type="'chat_completion'"
+                  button-text="选择提供商池..." />
+              </div>
+              <div v-else-if="itemMeta?._special === 'select_persona'">
+                <PersonaSelector v-model="createSelectorModel(itemKey).value" />
+              </div>
+              <div v-else-if="itemMeta?._special === 'persona_pool'">
+                <PersonaSelector v-model="createSelectorModel(itemKey).value" button-text="选择人格池..." />
+              </div>
+              <div v-else-if="itemMeta?._special === 'select_knowledgebase'">
+                <KnowledgeBaseSelector v-model="createSelectorModel(itemKey).value" />
+              </div>
+              <div v-else-if="itemMeta?._special === 'select_plugin_set'">
+                <PluginSetSelector v-model="createSelectorModel(itemKey).value" />
+              </div>
+              <div v-else-if="itemMeta?._special === 't2i_template'">
+                <T2ITemplateEditor />
+              </div>
             </v-col>
           </v-row>
 
@@ -233,12 +337,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">{{ t('core.shared.pluginSetSelector.selectedPluginsLabel') }}</small>
+                  <small class="text-grey">已选择的插件：</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 === '*' ? t('core.shared.pluginSetSelector.allPluginsLabel') : plugin }}
+                    {{ plugin === '*' ? '所有插件' : plugin }}
                   </v-chip>
                 </div>
               </div>

dashboard/src/components/shared/BackupDialog.vue

@@ -1,995 +0,0 @@
-<template>
-    <v-dialog v-model="isOpen" persistent max-width="700" scrollable>
-        <v-card>
-            <v-card-title class="d-flex align-center">
-                <v-icon class="mr-2">mdi-backup-restore</v-icon>
-                {{ t('features.settings.backup.dialog.title') }}
-            </v-card-title>
-
-            <v-card-text class="pa-6">
-                <!-- 选项卡 -->
-                <v-tabs v-model="activeTab" color="primary" class="mb-4">
-                    <v-tab value="export">
-                        <v-icon class="mr-2">mdi-export</v-icon>
-                        {{ t('features.settings.backup.tabs.export') }}
-                    </v-tab>
-                    <v-tab value="import">
-                        <v-icon class="mr-2">mdi-import</v-icon>
-                        {{ t('features.settings.backup.tabs.import') }}
-                    </v-tab>
-                    <v-tab value="list">
-                        <v-icon class="mr-2">mdi-format-list-bulleted</v-icon>
-                        {{ t('features.settings.backup.tabs.list') }}
-                    </v-tab>
-                </v-tabs>
-
-                <v-window v-model="activeTab">
-                    <!-- 导出标签页 -->
-                    <v-window-item value="export">
-                        <div v-if="exportStatus === 'idle'" class="text-center py-8">
-                            <v-icon size="64" color="primary" class="mb-4">mdi-cloud-upload</v-icon>
-                            <h3 class="mb-4">{{ t('features.settings.backup.export.title') }}</h3>
-                            <p class="mb-4 text-grey">{{ t('features.settings.backup.export.description') }}</p>
-                            <v-alert type="info" variant="tonal" class="mb-4 text-left">
-                                <template v-slot:prepend>
-                                    <v-icon>mdi-information</v-icon>
-                                </template>
-                                {{ t('features.settings.backup.export.includes') }}
-                            </v-alert>
-                            <v-btn color="primary" size="large" @click="startExport" :loading="exportStatus === 'processing'">
-                                <v-icon class="mr-2">mdi-export</v-icon>
-                                {{ t('features.settings.backup.export.button') }}
-                            </v-btn>
-                        </div>
-
-                        <div v-else-if="exportStatus === 'processing'" class="text-center py-8">
-                            <v-progress-circular indeterminate color="primary" size="64" class="mb-4"></v-progress-circular>
-                            <h3 class="mb-4">{{ t('features.settings.backup.export.processing') }}</h3>
-                            <p class="text-grey">{{ exportProgress.message || t('features.settings.backup.export.wait') }}</p>
-                            <v-progress-linear :model-value="exportProgress.current" :max="exportProgress.total" class="mt-4" color="primary"></v-progress-linear>
-                        </div>
-
-                        <div v-else-if="exportStatus === 'completed'" class="text-center py-8">
-                            <v-icon size="64" color="success" class="mb-4">mdi-check-circle</v-icon>
-                            <h3 class="mb-4">{{ t('features.settings.backup.export.completed') }}</h3>
-                            <p class="mb-4">{{ exportResult?.filename }}</p>
-                            <v-btn color="primary" @click="downloadBackup(exportResult?.filename)" class="mr-2">
-                                <v-icon class="mr-2">mdi-download</v-icon>
-                                {{ t('features.settings.backup.export.download') }}
-                            </v-btn>
-                            <v-btn color="grey" variant="text" @click="resetExport">
-                                {{ t('features.settings.backup.export.another') }}
-                            </v-btn>
-                        </div>
-
-                        <div v-else-if="exportStatus === 'failed'" class="text-center py-8">
-                            <v-icon size="64" color="error" class="mb-4">mdi-alert-circle</v-icon>
-                            <h3 class="mb-4">{{ t('features.settings.backup.export.failed') }}</h3>
-                            <v-alert type="error" variant="tonal" class="mb-4">
-                                {{ exportError }}
-                            </v-alert>
-                            <v-btn color="primary" @click="resetExport">
-                                {{ t('features.settings.backup.export.retry') }}
-                            </v-btn>
-                        </div>
-                    </v-window-item>
-
-                    <!-- 导入标签页 -->
-                    <v-window-item value="import">
-                        <!-- 步骤1: 选择文件 -->
-                        <div v-if="importStatus === 'idle'" class="py-4">
-                            <v-alert type="warning" variant="tonal" class="mb-4">
-                                <template v-slot:prepend>
-                                    <v-icon>mdi-alert</v-icon>
-                                </template>
-                                {{ t('features.settings.backup.import.warning') }}
-                            </v-alert>
-
-                            <v-file-input
-                                v-model="importFile"
-                                :label="t('features.settings.backup.import.selectFile')"
-                                accept=".zip"
-                                prepend-icon="mdi-file-upload"
-                                show-size
-                                class="mb-4"
-                            ></v-file-input>
-
-                            <div class="d-flex justify-center">
-                                <v-btn
-                                    color="primary"
-                                    size="large"
-                                    @click="uploadAndCheck"
-                                    :disabled="!importFile"
-                                    :loading="importStatus === 'uploading'"
-                                >
-                                    <v-icon class="mr-2">mdi-upload</v-icon>
-                                    {{ t('features.settings.backup.import.uploadAndCheck') }}
-                                </v-btn>
-                            </div>
-                        </div>
-
-                        <!-- 步骤1.5: 上传中 -->
-                        <div v-else-if="importStatus === 'uploading'" class="text-center py-8">
-                            <v-icon size="64" color="primary" class="mb-4">mdi-cloud-upload</v-icon>
-                            <h3 class="mb-4">{{ t('features.settings.backup.import.uploading') }}</h3>
-                            <p class="text-grey mb-2">
-                                {{ uploadProgress.message || t('features.settings.backup.import.uploadWait') }}
-                            </p>
-                            <p class="text-grey-darken-1 mb-4">
-                                {{ formatFileSize(uploadProgress.uploaded) }} / {{ formatFileSize(uploadProgress.total) }}
-                                ({{ uploadProgress.percent }}%)
-                            </p>
-                            <v-progress-linear
-                                :model-value="uploadProgress.percent"
-                                :max="100"
-                                class="mt-2"
-                                color="primary"
-                                height="8"
-                                rounded
-                            ></v-progress-linear>
-                        </div>
-
-                        <!-- 步骤2: 确认导入 -->
-                        <div v-else-if="importStatus === 'confirm'" class="py-4">
-                            <v-alert
-                                :type="versionAlertType"
-                                variant="tonal"
-                                class="mb-4"
-                            >
-                                <template v-slot:prepend>
-                                    <v-icon>{{ versionAlertIcon }}</v-icon>
-                                </template>
-                                <div class="confirm-message">
-                                    <div class="text-h6 mb-2">{{ versionAlertTitle }}</div>
-                                    <div class="mb-2">
-                                        <strong>{{ t('features.settings.backup.import.version.backupVersion') }}:</strong> {{ checkResult?.backup_version }}<br>
-                                        <strong>{{ t('features.settings.backup.import.version.currentVersion') }}:</strong> {{ checkResult?.current_version }}
-                                    </div>
-                                    <div v-if="checkResult?.backup_time && checkResult?.backup_time !== '未知'" class="mb-2">
-                                        <strong>{{ t('features.settings.backup.import.version.backupTime') }}:</strong> {{ formatISODate(checkResult?.backup_time) }}
-                                    </div>
-                                    <div class="mt-3" style="white-space: pre-line;">{{ versionAlertMessage }}</div>
-                                </div>
-                            </v-alert>
-
-                            <!-- 备份摘要 -->
-                            <v-card variant="outlined" class="mb-4" v-if="checkResult?.backup_summary">
-                                <v-card-title class="text-subtitle-1">
-                                    <v-icon class="mr-2">mdi-package-variant</v-icon>
-                                    {{ t('features.settings.backup.import.backupContents') }}
-                                </v-card-title>
-                                <v-card-text>
-                                    <div class="d-flex flex-wrap ga-2">
-                                        <v-chip v-if="checkResult.backup_summary.tables?.length" size="small" color="primary" variant="tonal" :ripple="false" class="non-interactive-chip">
-                                            {{ checkResult.backup_summary.tables.length }} {{ t('features.settings.backup.import.tables') }}
-                                        </v-chip>
-                                        <v-chip v-if="checkResult.backup_summary.has_knowledge_bases" size="small" color="success" variant="tonal" :ripple="false" class="non-interactive-chip">
-                                            {{ t('features.settings.backup.import.knowledgeBases') }}
-                                        </v-chip>
-                                        <v-chip v-if="checkResult.backup_summary.has_config" size="small" color="info" variant="tonal" :ripple="false" class="non-interactive-chip">
-                                            {{ t('features.settings.backup.import.configFiles') }}
-                                        </v-chip>
-                                        <v-chip v-for="dir in (checkResult.backup_summary.directories || [])" :key="dir" size="small" color="warning" variant="tonal" :ripple="false" class="non-interactive-chip">
-                                            {{ dir }}
-                                        </v-chip>
-                                    </div>
-                                </v-card-text>
-                            </v-card>
-
-                            <!-- 警告信息 -->
-                            <v-alert v-if="checkResult?.warnings?.length" type="warning" variant="tonal" class="mb-4">
-                                <div v-for="(warning, idx) in checkResult.warnings" :key="idx">{{ warning }}</div>
-                            </v-alert>
-
-                            <div class="d-flex justify-center align-center mt-4" style="gap: 16px;">
-                                <v-btn
-                                    color="grey-darken-1"
-                                    variant="outlined"
-                                    size="large"
-                                    @click="resetImport"
-                                >
-                                    <v-icon class="mr-2">mdi-close</v-icon>
-                                    {{ t('core.common.cancel') }}
-                                </v-btn>
-                                <v-btn
-                                    v-if="checkResult?.can_import"
-                                    color="error"
-                                    size="large"
-                                    variant="flat"
-                                    @click="confirmImport"
-                                >
-                                    <v-icon class="mr-2">mdi-alert</v-icon>
-                                    {{ t('features.settings.backup.import.confirmImport') }}
-                                </v-btn>
-                            </div>
-                        </div>
-
-                        <!-- 步骤3: 导入进行中 -->
-                        <div v-else-if="importStatus === 'processing'" class="text-center py-8">
-                            <v-progress-circular indeterminate color="primary" size="64" class="mb-4"></v-progress-circular>
-                            <h3 class="mb-4">{{ t('features.settings.backup.import.processing') }}</h3>
-                            <p class="text-grey">{{ importProgress.message || t('features.settings.backup.import.wait') }}</p>
-                            <v-progress-linear :model-value="importProgress.current" :max="importProgress.total" class="mt-4" color="primary"></v-progress-linear>
-                        </div>
-
-                        <div v-else-if="importStatus === 'completed'" class="text-center py-8">
-                            <v-icon size="64" color="success" class="mb-4">mdi-check-circle</v-icon>
-                            <h3 class="mb-4">{{ t('features.settings.backup.import.completed') }}</h3>
-                            <v-alert type="info" variant="tonal" class="mb-4">
-                                {{ t('features.settings.backup.import.restartRequired') }}
-                            </v-alert>
-                            <v-btn color="primary" @click="restartAstrBot" class="mr-2">
-                                <v-icon class="mr-2">mdi-restart</v-icon>
-                                {{ t('features.settings.backup.import.restartNow') }}
-                            </v-btn>
-                            <v-btn color="grey" variant="text" @click="resetImport">
-                                {{ t('core.common.close') }}
-                            </v-btn>
-                        </div>
-
-                        <div v-else-if="importStatus === 'failed'" class="text-center py-8">
-                            <v-icon size="64" color="error" class="mb-4">mdi-alert-circle</v-icon>
-                            <h3 class="mb-4">{{ t('features.settings.backup.import.failed') }}</h3>
-                            <v-alert type="error" variant="tonal" class="mb-4">
-                                {{ importError }}
-                            </v-alert>
-                            <v-btn color="primary" @click="resetImport">
-                                {{ t('features.settings.backup.import.retry') }}
-                            </v-btn>
-                        </div>
-                    </v-window-item>
-
-                    <!-- 备份列表标签页 -->
-                    <v-window-item value="list">
-                        <div v-if="loadingList" class="text-center py-8">
-                            <v-progress-circular indeterminate color="primary"></v-progress-circular>
-                        </div>
-
-                        <div v-else-if="backupList.length === 0" class="text-center py-8">
-                            <v-icon size="64" color="grey" class="mb-4">mdi-folder-open-outline</v-icon>
-                            <p class="text-grey">{{ t('features.settings.backup.list.empty') }}</p>
-                        </div>
-
-                        <v-list v-else lines="two">
-                            <v-list-item
-                                v-for="backup in backupList"
-                                :key="backup.filename"
-                            >
-                                <template v-slot:prepend>
-                                    <v-icon :color="backup.type === 'uploaded' ? 'orange' : 'primary'">
-                                        {{ backup.type === 'uploaded' ? 'mdi-upload' : 'mdi-zip-box' }}
-                                    </v-icon>
-                                </template>
-
-                                <v-list-item-title>{{ backup.filename }}</v-list-item-title>
-                                <v-list-item-subtitle>
-                                    {{ formatFileSize(backup.size) }} · {{ formatDate(backup.created_at) }}
-                                    <v-chip size="x-small" color="primary" variant="tonal" class="ml-2">
-                                        v{{ backup.astrbot_version }}
-                                    </v-chip>
-                                    <v-chip v-if="backup.type === 'uploaded'" size="x-small" color="orange" variant="tonal" class="ml-1">
-                                        {{ t('features.settings.backup.list.uploaded') }}
-                                    </v-chip>
-                                </v-list-item-subtitle>
-
-                                <template v-slot:append>
-                                    <v-btn
-                                        icon="mdi-restore"
-                                        variant="text"
-                                        size="small"
-                                        color="success"
-                                        :title="t('features.settings.backup.list.restore')"
-                                        @click="restoreFromList(backup.filename)"
-                                    ></v-btn>
-                                    <v-btn
-                                        icon="mdi-pencil"
-                                        variant="text"
-                                        size="small"
-                                        :title="t('features.settings.backup.list.rename')"
-                                        @click="openRenameDialog(backup.filename)"
-                                    ></v-btn>
-                                    <v-btn icon="mdi-download" variant="text" size="small" @click="downloadBackup(backup.filename)"></v-btn>
-                                    <v-btn icon="mdi-delete" variant="text" size="small" color="error" @click="deleteBackup(backup.filename)"></v-btn>
-                                </template>
-                            </v-list-item>
-                        </v-list>
-
-                        <div class="d-flex justify-center mt-4">
-                            <v-btn color="primary" variant="text" @click="loadBackupList">
-                                <v-icon class="mr-2">mdi-refresh</v-icon>
-                                {{ t('features.settings.backup.list.refresh') }}
-                            </v-btn>
-                        </div>
-
-                        <!-- 提示信息 -->
-                        <p class="text-caption text-grey text-center mt-4">
-                            <v-icon size="small" class="mr-1">mdi-information-outline</v-icon>
-                            {{ t('features.settings.backup.list.ftpHint') }}
-                        </p>
-                    </v-window-item>
-                </v-window>
-            </v-card-text>
-
-            <v-card-actions class="px-6 py-4">
-                <v-spacer></v-spacer>
-                <v-btn color="grey" variant="text" @click="handleClose" :disabled="isProcessing">
-                    {{ t('core.common.close') }}
-                </v-btn>
-            </v-card-actions>
-        </v-card>
-    </v-dialog>
-
-    <!-- 重命名对话框 -->
-    <v-dialog v-model="renameDialogOpen" max-width="450" persistent>
-        <v-card>
-            <v-card-title>
-                <v-icon class="mr-2">mdi-pencil</v-icon>
-                {{ t('features.settings.backup.list.renameTitle') }}
-            </v-card-title>
-            <v-card-text>
-                <v-text-field
-                    v-model="renameNewName"
-                    :label="t('features.settings.backup.list.newName')"
-                    :rules="[renameValidationRule]"
-                    :error-messages="renameError"
-                    variant="outlined"
-                    density="comfortable"
-                    autofocus
-                    @keyup.enter="confirmRename"
-                >
-                    <template v-slot:append-inner>
-                        <span class="text-grey">.zip</span>
-                    </template>
-                </v-text-field>
-                <p class="text-caption text-grey mt-1">
-                    {{ t('features.settings.backup.list.renameHint') }}
-                </p>
-            </v-card-text>
-            <v-card-actions>
-                <v-spacer></v-spacer>
-                <v-btn color="grey" variant="text" @click="closeRenameDialog">
-                    {{ t('core.common.cancel') }}
-                </v-btn>
-                <v-btn
-                    color="primary"
-                    variant="flat"
-                    @click="confirmRename"
-                    :loading="renameLoading"
-                    :disabled="!renameNewName || !!renameError"
-                >
-                    {{ t('core.common.confirm') }}
-                </v-btn>
-            </v-card-actions>
-        </v-card>
-    </v-dialog>
-
-    <WaitingForRestart ref="wfr"></WaitingForRestart>
-</template>
-
-<script setup>
-import { ref, computed, watch } from 'vue'
-import axios from 'axios'
-import { useI18n } from '@/i18n/composables'
-import WaitingForRestart from './WaitingForRestart.vue'
-
-const { t } = useI18n()
-
-const isOpen = ref(false)
-const activeTab = ref('export')
-const wfr = ref(null)
-
-// 导出状态
-const exportStatus = ref('idle') // idle, processing, completed, failed
-const exportTaskId = ref(null)
-const exportProgress = ref({ current: 0, total: 100, message: '' })
-const exportResult = ref(null)
-const exportError = ref('')
-
-// 导入状态
-const importStatus = ref('idle') // idle, uploading, confirm, processing, completed, failed
-const importFile = ref(null)
-const importTaskId = ref(null)
-const importProgress = ref({ current: 0, total: 100, message: '' })
-const importError = ref('')
-const uploadedFilename = ref('')  // 已上传的文件名
-const checkResult = ref(null)     // 预检查结果
-
-// 分片上传状态
-const CONCURRENT_UPLOADS = 5     // 并发上传数
-const uploadId = ref('')
-const chunkSize = ref(0)         // 分片大小（从后端获取）
-const uploadProgress = ref({
-    uploaded: 0,
-    total: 0,
-    percent: 0,
-    message: ''
-})
-
-// 备份列表
-const loadingList = ref(false)
-const backupList = ref([])
-
-// 重命名对话框状态
-const renameDialogOpen = ref(false)
-const renameOldFilename = ref('')
-const renameNewName = ref('')
-const renameLoading = ref(false)
-const renameError = ref('')
-
-// 计算属性
-const isProcessing = computed(() => {
-    return exportStatus.value === 'processing' ||
-           importStatus.value === 'processing' ||
-           importStatus.value === 'uploading'
-})
-
-// 版本检查相关的计算属性
-const versionAlertType = computed(() => {
-    const status = checkResult.value?.version_status
-    if (status === 'major_diff') return 'error'
-    if (status === 'minor_diff') return 'warning'
-    return 'info'
-})
-
-const versionAlertIcon = computed(() => {
-    const status = checkResult.value?.version_status
-    if (status === 'major_diff') return 'mdi-close-circle'
-    if (status === 'minor_diff') return 'mdi-alert'
-    return 'mdi-check-circle'
-})
-
-const versionAlertTitle = computed(() => {
-    const status = checkResult.value?.version_status
-    if (status === 'major_diff') return t('features.settings.backup.import.version.majorDiffTitle')
-    if (status === 'minor_diff') return t('features.settings.backup.import.version.minorDiffTitle')
-    return t('features.settings.backup.import.version.matchTitle')
-})
-
-const versionAlertMessage = computed(() => {
-    const status = checkResult.value?.version_status
-    if (status === 'major_diff') return t('features.settings.backup.import.version.majorDiffMessage')
-    if (status === 'minor_diff') return t('features.settings.backup.import.version.minorDiffMessage')
-    return t('features.settings.backup.import.version.matchMessage')
-})
-
-// 监听对话框打开
-watch(isOpen, (newVal) => {
-    if (newVal) {
-        loadBackupList()
-    } else {
-        resetAll()
-    }
-})
-
-// 监听标签页切换
-watch(activeTab, (newVal) => {
-    if (newVal === 'list') {
-        loadBackupList()
-    }
-})
-
-// 加载备份列表
-const loadBackupList = async () => {
-    loadingList.value = true
-    try {
-        const response = await axios.get('/api/backup/list')
-        if (response.data.status === 'ok') {
-            backupList.value = response.data.data.items || []
-        }
-    } catch (error) {
-        console.error('Failed to load backup list:', error)
-    } finally {
-        loadingList.value = false
-    }
-}
-
-// 开始导出
-const startExport = async () => {
-    exportStatus.value = 'processing'
-    exportProgress.value = { current: 0, total: 100, message: '' }
-
-    try {
-        const response = await axios.post('/api/backup/export')
-        if (response.data.status === 'ok') {
-            exportTaskId.value = response.data.data.task_id
-            pollExportProgress()
-        } else {
-            throw new Error(response.data.message)
-        }
-    } catch (error) {
-        exportStatus.value = 'failed'
-        exportError.value = error.message || 'Export failed'
-    }
-}
-
-// 轮询导出进度
-const pollExportProgress = async () => {
-    if (!exportTaskId.value) return
-
-    try {
-        const response = await axios.get('/api/backup/progress', {
-            params: { task_id: exportTaskId.value }
-        })
-
-        if (response.data.status === 'ok') {
-            const data = response.data.data
-            
-            if (data.status === 'processing' && data.progress) {
-                exportProgress.value = {
-                    current: data.progress.current || 0,
-                    total: data.progress.total || 100,
-                    message: data.progress.message || ''
-                }
-                setTimeout(pollExportProgress, 1000)
-            } else if (data.status === 'completed') {
-                exportStatus.value = 'completed'
-                exportResult.value = data.result
-                loadBackupList()
-            } else if (data.status === 'failed') {
-                exportStatus.value = 'failed'
-                exportError.value = data.error || 'Export failed'
-            } else {
-                setTimeout(pollExportProgress, 1000)
-            }
-        }
-    } catch (error) {
-        exportStatus.value = 'failed'
-        exportError.value = error.message || 'Failed to get export progress'
-    }
-}
-
-// 重置导出状态
-const resetExport = () => {
-    exportStatus.value = 'idle'
-    exportTaskId.value = null
-    exportProgress.value = { current: 0, total: 100, message: '' }
-    exportResult.value = null
-    exportError.value = ''
-}
-
-/**
- * 并发上传分片
- *
- * 使用并发控制同时上传多个分片，提升上传速度。
- * 后端按分片索引命名文件（如 0.part, 1.part），合并时按顺序读取，
- * 因此分片到达顺序不影响最终结果。
- */
-const uploadChunksInParallel = async (file, totalChunks, currentUploadId, currentChunkSize) => {
-    // 跟踪已完成的字节数（使用原子操作避免并发问题）
-    let completedBytes = 0
-    const chunkSizes = []
-    
-    // 预计算每个分片的大小（使用后端返回的 chunk_size）
-    for (let i = 0; i < totalChunks; i++) {
-        const start = i * currentChunkSize
-        const end = Math.min(start + currentChunkSize, file.size)
-        chunkSizes[i] = end - start
-    }
-
-    // 上传单个分片的函数
-    const uploadSingleChunk = async (chunkIndex) => {
-        const start = chunkIndex * currentChunkSize
-        const end = Math.min(start + currentChunkSize, file.size)
-        const chunk = file.slice(start, end)
-
-        const formData = new FormData()
-        formData.append('upload_id', currentUploadId)
-        formData.append('chunk_index', chunkIndex.toString())
-        formData.append('chunk', chunk)
-
-        const response = await axios.post('/api/backup/upload/chunk', formData, {
-            headers: { 'Content-Type': 'multipart/form-data' }
-        })
-
-        if (response.data.status !== 'ok') {
-            throw new Error(response.data.message)
-        }
-
-        // 更新进度（累加已完成字节）
-        completedBytes += chunkSizes[chunkIndex]
-        uploadProgress.value.uploaded = completedBytes
-        uploadProgress.value.percent = Math.round((completedBytes / file.size) * 100)
-
-        return response
-    }
-
-    // 创建分片索引队列
-    const pendingChunks = Array.from({ length: totalChunks }, (_, i) => i)
-    const activePromises = []
-
-    // 处理队列中的分片
-    while (pendingChunks.length > 0 || activePromises.length > 0) {
-        // 填充并发槽位
-        while (pendingChunks.length > 0 && activePromises.length < CONCURRENT_UPLOADS) {
-            const chunkIndex = pendingChunks.shift()
-            const promise = uploadSingleChunk(chunkIndex).then(() => {
-                // 完成后从活动列表移除
-                const idx = activePromises.indexOf(promise)
-                if (idx > -1) activePromises.splice(idx, 1)
-            })
-            activePromises.push(promise)
-        }
-
-        // 等待至少一个完成
-        if (activePromises.length > 0) {
-            await Promise.race(activePromises)
-        }
-    }
-}
-
-// 上传并检查
-const uploadAndCheck = async () => {
-    if (!importFile.value) return
-
-    importStatus.value = 'uploading'
-    const file = importFile.value
-
-    try {
-        // 初始化上传进度
-        uploadProgress.value = {
-            uploaded: 0,
-            total: file.size,
-            percent: 0,
-            message: t('features.settings.backup.import.uploadInit')
-        }
-
-        // 步骤1: 初始化分片上传（后端计算并返回 chunk_size 和 total_chunks）
-        const initResponse = await axios.post('/api/backup/upload/init', {
-            filename: file.name,
-            total_size: file.size
-        })
-
-        if (initResponse.data.status !== 'ok') {
-            throw new Error(initResponse.data.message)
-        }
-
-        uploadId.value = initResponse.data.data.upload_id
-        chunkSize.value = initResponse.data.data.chunk_size
-        const totalChunks = initResponse.data.data.total_chunks
-
-        // 步骤2: 并行分片上传（5个并发连接）
-        uploadProgress.value.message = t('features.settings.backup.import.uploadingChunks')
-        
-        await uploadChunksInParallel(file, totalChunks, uploadId.value, chunkSize.value)
-
-        // 步骤3: 完成上传
-        uploadProgress.value.message = t('features.settings.backup.import.uploadComplete')
-
-        const completeResponse = await axios.post('/api/backup/upload/complete', {
-            upload_id: uploadId.value
-        })
-
-        if (completeResponse.data.status !== 'ok') {
-            throw new Error(completeResponse.data.message)
-        }
-
-        uploadedFilename.value = completeResponse.data.data.filename
-
-        // 步骤4: 预检查
-        uploadProgress.value.message = t('features.settings.backup.import.checking')
-
-        const checkResponse = await axios.post('/api/backup/check', {
-            filename: uploadedFilename.value
-        })
-
-        if (checkResponse.data.status !== 'ok') {
-            throw new Error(checkResponse.data.message)
-        }
-
-        checkResult.value = checkResponse.data.data
-        
-        // 检查是否有效
-        if (!checkResult.value.valid) {
-            importStatus.value = 'failed'
-            importError.value = checkResult.value.error || t('features.settings.backup.import.invalidBackup')
-            return
-        }
-
-        // 显示确认对话框
-        importStatus.value = 'confirm'
-
-    } catch (error) {
-        // 上传失败时尝试清理已上传的分片
-        if (uploadId.value) {
-            try {
-                await axios.post('/api/backup/upload/abort', {
-                    upload_id: uploadId.value
-                })
-            } catch (abortError) {
-                console.error('Failed to abort upload:', abortError)
-            }
-        }
-        
-        importStatus.value = 'failed'
-        importError.value = error.response?.data?.message || error.message || 'Upload failed'
-    }
-}
-
-// 确认导入
-const confirmImport = async () => {
-    if (!uploadedFilename.value) return
-
-    importStatus.value = 'processing'
-    importProgress.value = { current: 0, total: 100, message: '' }
-
-    try {
-        const response = await axios.post('/api/backup/import', {
-            filename: uploadedFilename.value,
-            confirmed: true
-        })
-
-        if (response.data.status === 'ok') {
-            importTaskId.value = response.data.data.task_id
-            pollImportProgress()
-        } else {
-            throw new Error(response.data.message)
-        }
-    } catch (error) {
-        importStatus.value = 'failed'
-        importError.value = error.response?.data?.message || error.message || 'Import failed'
-    }
-}
-
-// 轮询导入进度
-const pollImportProgress = async () => {
-    if (!importTaskId.value) return
-
-    try {
-        const response = await axios.get('/api/backup/progress', {
-            params: { task_id: importTaskId.value }
-        })
-
-        if (response.data.status === 'ok') {
-            const data = response.data.data
-            
-            if (data.status === 'processing' && data.progress) {
-                importProgress.value = {
-                    current: data.progress.current || 0,
-                    total: data.progress.total || 100,
-                    message: data.progress.message || ''
-                }
-                setTimeout(pollImportProgress, 1000)
-            } else if (data.status === 'completed') {
-                importStatus.value = 'completed'
-            } else if (data.status === 'failed') {
-                importStatus.value = 'failed'
-                importError.value = data.error || 'Import failed'
-            } else {
-                setTimeout(pollImportProgress, 1000)
-            }
-        }
-    } catch (error) {
-        importStatus.value = 'failed'
-        importError.value = error.message || 'Failed to get import progress'
-    }
-}
-
-// 重置导入状态
-const resetImport = async () => {
-    // 如果有进行中的上传，先取消
-    if (uploadId.value && importStatus.value === 'uploading') {
-        try {
-            await axios.post('/api/backup/upload/abort', {
-                upload_id: uploadId.value
-            })
-        } catch (error) {
-            console.error('Failed to abort upload:', error)
-        }
-    }
-    
-    importStatus.value = 'idle'
-    importFile.value = null
-    importTaskId.value = null
-    importProgress.value = { current: 0, total: 100, message: '' }
-    importError.value = ''
-    uploadedFilename.value = ''
-    checkResult.value = null
-    uploadId.value = ''
-    chunkSize.value = 0
-    uploadProgress.value = { uploaded: 0, total: 0, percent: 0, message: '' }
-}
-
-// 下载备份（使用浏览器原生下载，可显示下载进度）
-const downloadBackup = (filename) => {
-    // 获取 token 用于鉴权（因为浏览器原生下载无法携带 Authorization header）
-    const token = localStorage.getItem('token')
-    if (!token) {
-        alert(t('core.common.unauthorized'))
-        return
-    }
-    
-    // 直接使用浏览器下载，这样可以看到原生下载进度条
-    const downloadUrl = `/api/backup/download?filename=${encodeURIComponent(filename)}&token=${encodeURIComponent(token)}`
-    
-    // 创建隐藏的 a 标签触发下载
-    const link = document.createElement('a')
-    link.href = downloadUrl
-    link.download = filename
-    link.style.display = 'none'
-    document.body.appendChild(link)
-    link.click()
-    document.body.removeChild(link)
-}
-
-// 从列表中恢复备份
-const restoreFromList = async (filename) => {
-    // 切换到导入标签页并设置文件名
-    uploadedFilename.value = filename
-    
-    // 预检查
-    try {
-        const checkResponse = await axios.post('/api/backup/check', {
-            filename: filename
-        })
-
-        if (checkResponse.data.status !== 'ok') {
-            throw new Error(checkResponse.data.message)
-        }
-
-        checkResult.value = checkResponse.data.data
-        
-        if (!checkResult.value.valid) {
-            alert(checkResult.value.error || t('features.settings.backup.import.invalidBackup'))
-            return
-        }
-
-        // 切换到导入标签页并显示确认
-        activeTab.value = 'import'
-        importStatus.value = 'confirm'
-
-    } catch (error) {
-        alert(error.response?.data?.message || error.message || 'Check failed')
-    }
-}
-
-// 删除备份
-const deleteBackup = async (filename) => {
-    if (!confirm(t('features.settings.backup.list.confirmDelete'))) return
-
-    try {
-        const response = await axios.post('/api/backup/delete', { filename })
-        if (response.data.status === 'ok') {
-            loadBackupList()
-        } else {
-            alert(response.data.message || 'Delete failed')
-        }
-    } catch (error) {
-        alert(error.message || 'Delete failed')
-    }
-}
-
-// 重命名相关函数
-const openRenameDialog = (filename) => {
-    renameOldFilename.value = filename
-    // 移除 .zip 后缀，只显示文件名部分
-    renameNewName.value = filename.replace(/\.zip$/i, '')
-    renameError.value = ''
-    renameDialogOpen.value = true
-}
-
-const closeRenameDialog = () => {
-    renameDialogOpen.value = false
-    renameOldFilename.value = ''
-    renameNewName.value = ''
-    renameError.value = ''
-}
-
-// 文件名验证规则
-const renameValidationRule = (value) => {
-    if (!value) return t('features.settings.backup.list.renameRequired')
-    // 检查是否包含非法字符
-    if (/[\\/:*?"<>|]/.test(value)) {
-        return t('features.settings.backup.list.renameInvalidChars')
-    }
-    // 检查是否包含路径遍历字符
-    if (value.includes('..')) {
-        return t('features.settings.backup.list.renameInvalidChars')
-    }
-    return true
-}
-
-const confirmRename = async () => {
-    if (!renameNewName.value || renameError.value) return
-    
-    // 前端验证
-    const validationResult = renameValidationRule(renameNewName.value)
-    if (validationResult !== true) {
-        renameError.value = validationResult
-        return
-    }
-
-    renameLoading.value = true
-    renameError.value = ''
-
-    try {
-        const response = await axios.post('/api/backup/rename', {
-            filename: renameOldFilename.value,
-            new_name: renameNewName.value
-        })
-
-        if (response.data.status === 'ok') {
-            closeRenameDialog()
-            loadBackupList()
-        } else {
-            renameError.value = response.data.message || t('features.settings.backup.list.renameFailed')
-        }
-    } catch (error) {
-        renameError.value = error.response?.data?.message || error.message || t('features.settings.backup.list.renameFailed')
-    } finally {
-        renameLoading.value = false
-    }
-}
-
-// 格式化文件大小
-const formatFileSize = (bytes) => {
-    if (bytes === 0) return '0 B'
-    const k = 1024
-    const sizes = ['B', 'KB', 'MB', 'GB']
-    const i = Math.floor(Math.log(bytes) / Math.log(k))
-    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i]
-}
-
-// 格式化日期（从时间戳）
-const formatDate = (timestamp) => {
-    return new Date(timestamp * 1000).toLocaleString()
-}
-
-// 格式化 ISO 日期字符串
-const formatISODate = (isoString) => {
-    if (!isoString) return ''
-    try {
-        return new Date(isoString).toLocaleString()
-    } catch {
-        return isoString
-    }
-}
-
-// 重启 AstrBot
-const restartAstrBot = () => {
-    axios.post('/api/stat/restart-core').then(() => {
-        if (wfr.value) {
-            wfr.value.check()
-        }
-    })
-}
-
-// 重置所有状态
-const resetAll = async () => {
-    resetExport()
-    await resetImport()
-    activeTab.value = 'export'
-}
-
-// 关闭对话框
-const handleClose = () => {
-    if (isProcessing.value) return
-    isOpen.value = false
-}
-
-// 打开对话框
-const open = () => {
-    isOpen.value = true
-}
-
-defineExpose({ open })
-</script>
-
-<style scoped>
-.v-list-item {
-    border-bottom: 1px solid rgba(0, 0, 0, 0.08);
-}
-
-.v-list-item:last-child {
-    border-bottom: none;
-}
-
-/* 禁用 Chip 的交互效果 */
-.non-interactive-chip {
-    pointer-events: none;
-    cursor: default;
-}
-
-.non-interactive-chip:hover {
-    box-shadow: none !important;
-}
-</style>

dashboard/src/components/shared/ConfigItemRenderer.vue

@@ -1,332 +0,0 @@
-<template>
-  <div class="w-100">
-    <!-- Special handling for specific metadata types -->
-    <template v-if="itemMeta?._special === 'select_provider'">
-      <ProviderSelector :model-value="modelValue" @update:model-value="emitUpdate" :provider-type="'chat_completion'" />
-    </template>
-    <template v-else-if="itemMeta?._special === 'select_provider_stt'">
-      <ProviderSelector :model-value="modelValue" @update:model-value="emitUpdate" :provider-type="'speech_to_text'" />
-    </template>
-    <template v-else-if="itemMeta?._special === 'select_provider_tts'">
-      <ProviderSelector :model-value="modelValue" @update:model-value="emitUpdate" :provider-type="'text_to_speech'" />
-    </template>
-    <template v-else-if="getSpecialName(itemMeta?._special) === 'select_agent_runner_provider'">
-      <ProviderSelector
-        :model-value="modelValue"
-        @update:model-value="emitUpdate"
-        :provider-type="'agent_runner'"
-        :provider-subtype="getSpecialSubtype(itemMeta?._special)"
-      />
-    </template>
-    <template v-else-if="itemMeta?._special === 'provider_pool'">
-      <ProviderSelector :model-value="modelValue" @update:model-value="emitUpdate" :provider-type="'chat_completion'"
-        :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="t('core.shared.personaSelector.selectPersonaPool')" />
-    </template>
-    <template v-else-if="itemMeta?._special === 'select_knowledgebase'">
-      <KnowledgeBaseSelector :model-value="modelValue" @update:model-value="emitUpdate" />
-    </template>
-    <template v-else-if="itemMeta?._special === 'select_plugin_set'">
-      <PluginSetSelector :model-value="modelValue" @update:model-value="emitUpdate" />
-    </template>
-    <template v-else-if="itemMeta?._special === 't2i_template'">
-      <T2ITemplateEditor />
-    </template>
-    <template v-else-if="itemMeta?._special === 'get_embedding_dim'">
-      <div class="d-flex align-center gap-2">
-        <v-text-field
-          :model-value="modelValue"
-          @update:model-value="emitUpdate"
-          density="compact"
-          variant="outlined"
-          class="config-field"
-          type="number"
-          hide-details
-        ></v-text-field>
-        <v-btn
-          color="primary"
-          variant="tonal"
-          size="small"
-          @click="$emit('get-embedding-dim')"
-          :loading="loading"
-          class="ml-2"
-        >
-          {{ t('core.common.autoDetect') }}
-        </v-btn>
-      </div>
-    </template>
-
-    <div
-      v-else-if="itemMeta?.type === 'list' && itemMeta?.options && itemMeta?.render_type === 'checkbox'"
-      class="d-flex flex-wrap gap-20"
-    >
-      <v-checkbox
-        v-for="(option, optionIndex) in itemMeta.options"
-        :key="optionIndex"
-        :model-value="modelValue"
-        @update:model-value="emitUpdate"
-        :label="getLabel(itemMeta, optionIndex, option)"
-        :value="option"
-        class="mr-2"
-        color="primary"
-        hide-details
-      ></v-checkbox>
-    </div>
-
-    <v-combobox
-      v-else-if="itemMeta?.type === 'list' && itemMeta?.options"
-      :model-value="modelValue"
-      @update:model-value="emitUpdate"
-      :items="itemMeta.options"
-      :disabled="itemMeta?.readonly"
-      density="compact"
-      variant="outlined"
-      class="config-field"
-      hide-details
-      chips
-      multiple
-    ></v-combobox>
-
-    <v-select
-      v-else-if="itemMeta?.options"
-      :model-value="modelValue"
-      @update:model-value="emitUpdate"
-      :items="getSelectItems(itemMeta)"
-      :disabled="itemMeta?.readonly"
-      density="compact"
-      variant="outlined"
-      class="config-field"
-      hide-details
-    ></v-select>
-
-    <div v-else-if="itemMeta?.editor_mode" class="editor-container">
-      <VueMonacoEditor
-        :theme="itemMeta?.editor_theme || 'vs-light'"
-        :language="itemMeta?.editor_language || 'json'"
-        style="min-height: 100px; flex-grow: 1; border: 1px solid rgba(0, 0, 0, 0.1);"
-        :value="modelValue"
-        @update:value="emitUpdate"
-      >
-      </VueMonacoEditor>
-      <v-btn v-if="showFullscreenBtn" icon size="small" variant="text" color="primary" class="editor-fullscreen-btn"
-        @click="$emit('open-fullscreen')"
-        :title="t('core.common.editor.fullscreen')">
-        <v-icon>mdi-fullscreen</v-icon>
-      </v-btn>
-    </div>
-
-    <v-text-field
-      v-else-if="itemMeta?.type === 'string'"
-      :model-value="modelValue"
-      @update:model-value="emitUpdate"
-      density="compact"
-      variant="outlined"
-      class="config-field"
-      hide-details
-    ></v-text-field>
-
-    <div
-      v-else-if="itemMeta?.type === 'int' || itemMeta?.type === 'float'"
-      class="d-flex align-center gap-3"
-    >
-      <v-slider
-        v-if="itemMeta?.slider"
-        :model-value="toNumber(modelValue)"
-        @update:model-value="val => emitUpdate(toNumber(val))"
-        :min="itemMeta?.slider?.min ?? 0"
-        :max="itemMeta?.slider?.max ?? 100"
-        :step="itemMeta?.slider?.step ?? 1"
-        color="primary"
-        density="compact"
-        hide-details
-        style="flex: 1"
-      ></v-slider>
-      <v-text-field
-        :model-value="modelValue"
-        @update:model-value="val => emitUpdate(toNumber(val))"
-        density="compact"
-        variant="outlined"
-        class="config-field"
-        type="number"
-        hide-details
-        style="flex: 1"
-      ></v-text-field>
-    </div>
-
-    <v-textarea
-      v-else-if="itemMeta?.type === 'text'"
-      :model-value="modelValue"
-      @update:model-value="emitUpdate"
-      variant="outlined"
-      rows="3"
-      class="config-field"
-      hide-details
-    ></v-textarea>
-
-    <v-switch
-      v-else-if="itemMeta?.type === 'bool'"
-      :model-value="modelValue"
-      @update:model-value="emitUpdate"
-      color="primary"
-      inset
-      density="compact"
-      hide-details
-    ></v-switch>
-
-    <ListConfigItem
-      v-else-if="itemMeta?.type === 'list'"
-      :model-value="modelValue"
-      @update:model-value="emitUpdate"
-      class="config-field"
-    />
-
-    <ObjectEditor
-      v-else-if="itemMeta?.type === 'dict'"
-      :model-value="modelValue"
-      :item-meta="itemMeta"
-      @update:model-value="emitUpdate"
-      class="config-field"
-    />
-
-    <v-text-field
-      v-else
-      :model-value="modelValue"
-      @update:model-value="emitUpdate"
-      density="compact"
-      variant="outlined"
-      class="config-field"
-      hide-details
-    ></v-text-field>
-  </div>
-</template>
-
-<script setup>
-import { VueMonacoEditor } from '@guolao/vue-monaco-editor'
-import ListConfigItem from './ListConfigItem.vue'
-import ObjectEditor from './ObjectEditor.vue'
-import ProviderSelector from './ProviderSelector.vue'
-import PersonaSelector from './PersonaSelector.vue'
-import KnowledgeBaseSelector from './KnowledgeBaseSelector.vue'
-import PluginSetSelector from './PluginSetSelector.vue'
-import T2ITemplateEditor from './T2ITemplateEditor.vue'
-import { useI18n, useModuleI18n } from '@/i18n/composables'
-
-const props = defineProps({
-  modelValue: {
-    type: [String, Number, Boolean, Array, Object],
-    default: null
-  },
-  itemMeta: {
-    type: Object,
-    default: null
-  },
-  loading: {
-    type: Boolean,
-    default: false
-  },
-  showFullscreenBtn: {
-    type: Boolean,
-    default: false
-  }
-})
-
-const emit = defineEmits(['update:modelValue', 'get-embedding-dim', 'open-fullscreen'])
-const { t } = useI18n()
-const { getRaw } = useModuleI18n('features/config-metadata')
-
-function emitUpdate(val) {
-  emit('update:modelValue', val)
-}
-
-function toNumber(val) {
-  const n = parseFloat(val)
-  return isNaN(n) ? 0 : n
-}
-
-function getLabel(itemMeta, index, option) {
-  const labels = getTranslatedLabels(itemMeta)
-  return labels ? labels[index] : option
-}
-
-function getTranslatedLabels(itemMeta) {
-  if (!itemMeta?.labels) return null
-  if (typeof itemMeta.labels === 'string') {
-    const translatedLabels = getRaw(itemMeta.labels)
-    if (Array.isArray(translatedLabels)) {
-      return translatedLabels
-    }
-  }
-  if (Array.isArray(itemMeta.labels)) {
-    return itemMeta.labels
-  }
-  return null
-}
-
-function getSelectItems(itemMeta) {
-  const labels = getTranslatedLabels(itemMeta)
-  if (labels && itemMeta.options) {
-    return itemMeta.options.map((value, index) => ({
-      title: labels[index] || value,
-      value: value
-    }))
-  }
-  return itemMeta.options || []
-}
-
-function parseSpecialValue(value) {
-  if (!value || typeof value !== 'string') {
-    return { name: '', subtype: '' }
-  }
-  const [name, ...rest] = value.split(':')
-  return {
-    name,
-    subtype: rest.join(':') || ''
-  }
-}
-
-function getSpecialName(value) {
-  return parseSpecialValue(value).name
-}
-
-function getSpecialSubtype(value) {
-  return parseSpecialValue(value).subtype
-}
-</script>
-
-<style scoped>
-.config-field {
-  margin-bottom: 0;
-}
-
-.editor-container {
-  position: relative;
-  display: flex;
-  width: 100%;
-}
-
-.editor-fullscreen-btn {
-  position: absolute;
-  top: 4px;
-  right: 4px;
-  z-index: 10;
-  background-color: rgba(0, 0, 0, 0.3);
-  border-radius: 4px;
-}
-
-.editor-fullscreen-btn:hover {
-  background-color: rgba(0, 0, 0, 0.5);
-}
-
-.gap-20 {
-  gap: 20px;
-}
-
-:deep(.v-field__input) {
-  font-size: 14px;
-}
-</style>

dashboard/src/components/shared/ConsoleDisplayer.vue

@@ -1,11 +1,12 @@
 <script setup>
 import { useCommonStore } from '@/stores/common';
+import { storeToRefs } from 'pinia';
 import axios from 'axios';
-import { EventSourcePolyfill } from 'event-source-polyfill';
 </script>
 
 <template>
   <div>
+    <!-- 添加筛选级别控件 -->
     <div class="filter-controls mb-2" v-if="showLevelBtns">
       <v-chip-group v-model="selectedLevels" column multiple>
         <v-chip v-for="level in logLevels" :key="level" :color="getLevelColor(level)" filter variant="flat" size="small"
@@ -25,19 +26,20 @@ export default {
   name: 'ConsoleDisplayer',
   data() {
     return {
-      autoScroll: true,
+      autoScroll: true,  // 默认开启自动滚动
       logColorAnsiMap: {
-        '\u001b[1;34m': 'color: #0000FF; font-weight: bold;',
-        '\u001b[1;36m': 'color: #00FFFF; font-weight: bold;',
-        '\u001b[1;33m': 'color: #FFFF00; font-weight: bold;',
-        '\u001b[31m': 'color: #FF0000;',
-        '\u001b[1;31m': 'color: #FF0000; font-weight: bold;',
-        '\u001b[0m': 'color: inherit; font-weight: normal;',
-        '\u001b[32m': 'color: #00FF00;',
+        '\u001b[1;34m': 'color: #0000FF; font-weight: bold;', // bold_blue
+        '\u001b[1;36m': 'color: #00FFFF; font-weight: bold;', // bold_cyan
+        '\u001b[1;33m': 'color: #FFFF00; font-weight: bold;', // bold_yellow
+        '\u001b[31m': 'color: #FF0000;', // red
+        '\u001b[1;31m': 'color: #FF0000; font-weight: bold;', // bold_red
+        '\u001b[0m': 'color: inherit; font-weight: normal;', // reset
+        '\u001b[32m': 'color: #00FF00;',  // green
         'default': 'color: #FFFFFF;'
       },
+      historyNum_: -1,
       logLevels: ['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL'],
-      selectedLevels: [0, 1, 2, 3, 4],
+      selectedLevels: [0, 1, 2, 3, 4], // 默认选中所有级别
       levelColors: {
         'DEBUG': 'grey',
         'INFO': 'blue-lighten-3',
@@ -45,19 +47,17 @@ export default {
         'ERROR': 'red',
         'CRITICAL': 'purple'
       },
-      localLogCache: [],
-      eventSource: null,
-      retryTimer: null,
-      retryAttempts: 0,           
-      maxRetryAttempts: 10,       
-      baseRetryDelay: 1000,       
-      lastEventId: null,          
+      lastProcessedTime: 0, // 记录最后处理的日志时间戳
+      localLogCache: [], // 本地日志缓存
     }
   },
   computed: {
     commonStore() {
       return useCommonStore();
     },
+    logCache() {
+      return this.commonStore.log_cache;
+    }
   },
   props: {
     historyNum: {
@@ -70,6 +70,41 @@ export default {
     }
   },
   watch: {
+    logCache: {
+      handler(newVal) {
+        // 基于 timestamp 处理新增的日志
+        if (newVal && newVal.length > 0) {
+          // 确保 DOM 已经准备好
+          this.$nextTick(() => {
+            // 合并到本地缓存并按时间排序
+            const newLogs = newVal.filter(log => log.time > this.lastProcessedTime);
+            
+            if (newLogs.length > 0) {
+              this.localLogCache.push(...newLogs);
+              // 按时间戳排序
+              this.localLogCache.sort((a, b) => a.time - b.time);
+              
+              // 只保留最新的 log_cache_max_len 条
+              if (this.localLogCache.length > this.commonStore.log_cache_max_len) {
+                this.localLogCache.splice(0, this.localLogCache.length - this.commonStore.log_cache_max_len);
+              }
+              
+              // 显示新日志
+              newLogs.forEach(logItem => {
+                if (this.isLevelSelected(logItem.level)) {
+                  this.printLog(logItem.data);
+                }
+              });
+              
+              // 更新最后处理时间
+              this.lastProcessedTime = Math.max(...newLogs.map(log => log.time));
+            }
+          });
+        }
+      },
+      deep: true,
+      immediate: false
+    },
     selectedLevels: {
       handler() {
         this.refreshDisplay();
@@ -78,142 +113,30 @@ export default {
     }
   },
   async mounted() {
+    // 请求历史日志
     await this.fetchLogHistory();
-    this.connectSSE();
-  },
-  beforeUnmount() {
-    if (this.eventSource) {
-      this.eventSource.close();
-      this.eventSource = null;
-    }
-    if (this.retryTimer) {
-      clearTimeout(this.retryTimer);
-      this.retryTimer = null;
-    }
-    this.retryAttempts = 0;
+    
+    // 等待 DOM 准备好后，显示历史日志
+    this.$nextTick(() => {
+      if (this.localLogCache.length > 0) {
+        this.localLogCache.forEach(logItem => {
+          if (this.isLevelSelected(logItem.level)) {
+            this.printLog(logItem.data);
+          }
+        });
+        // 更新最后处理时间
+        this.lastProcessedTime = Math.max(...this.localLogCache.map(log => log.time));
+      }
+    });
   },
   methods: {
-    connectSSE() {
-      if (this.eventSource) {
-        this.eventSource.close();
-        this.eventSource = null;
-      }
-
-      console.log(`正在连接日志流... (尝试次数: ${this.retryAttempts})`);
-      
-      const token = localStorage.getItem('token');
-
-      this.eventSource = new EventSourcePolyfill('/api/live-log', {
-        headers: {
-            'Authorization': token ? `Bearer ${token}` : ''
-        },
-        heartbeatTimeout: 300000, 
-        withCredentials: true 
-      });
-
-      this.eventSource.onopen = () => {
-        console.log('日志流连接成功！');
-        this.retryAttempts = 0;
-
-        if (!this.lastEventId) {
-            this.fetchLogHistory();
-        }
-      };
-
-      this.eventSource.onmessage = (event) => {
-        try {
-          if (event.lastEventId) {
-            this.lastEventId = event.lastEventId;
-          }
-
-          const payload = JSON.parse(event.data);
-          this.processNewLogs([payload]);
-        } catch (e) {
-          console.error('解析日志失败:', e);
-        }
-      };
-
-      this.eventSource.onerror = (err) => {
-
-        if (err.status === 401) {
-            console.error('鉴权失败 (401)，可能是 Token 过期了。');
-
-        } else {
-            console.warn('日志流连接错误:', err);
-        }
-        
-        if (this.eventSource) {
-            this.eventSource.close();
-            this.eventSource = null;
-        }
-
-        if (this.retryAttempts >= this.maxRetryAttempts) {
-            console.error('❌ 已达到最大重试次数，停止重连。请刷新页面重试。');
-            return; 
-        }
-
-        const delay = Math.min(
-            this.baseRetryDelay * Math.pow(2, this.retryAttempts),
-            30000
-        );
-        
-        console.log(`⏳ ${delay}ms 后尝试第 ${this.retryAttempts + 1} 次重连...`);
-
-        if (this.retryTimer) {
-          clearTimeout(this.retryTimer);
-          this.retryTimer = null;
-        }
-
-        this.retryTimer = setTimeout(async () => {
-          this.retryAttempts++;
-          
-          if (!this.lastEventId) {
-             await this.fetchLogHistory();
-          }
-          
-          this.connectSSE();
-        }, delay);
-      };
-    },
-
-    processNewLogs(newLogs) {
-      if (!newLogs || newLogs.length === 0) return;
-
-      let hasUpdate = false;
-
-      newLogs.forEach(log => {
-
-        const exists = this.localLogCache.some(existing => 
-          existing.time === log.time && 
-          existing.data === log.data &&
-          existing.level === log.level
-        );
-        
-        if (!exists) {
-            this.localLogCache.push(log);
-            hasUpdate = true;
-            
-            if (this.isLevelSelected(log.level)) {
-              this.printLog(log.data);
-            }
-        }
-      });
-
-      if (hasUpdate) {
-        this.localLogCache.sort((a, b) => a.time - b.time);
-        
-        const maxSize = this.commonStore.log_cache_max_len || 200;
-        if (this.localLogCache.length > maxSize) {
-           this.localLogCache.splice(0, this.localLogCache.length - maxSize);
-        }
-      }
-    },
-
     async fetchLogHistory() {
       try {
         const res = await axios.get('/api/log-history');
         if (res.data.data.logs && res.data.data.logs.length > 0) {
-          this.processNewLogs(res.data.data.logs);
+          this.localLogCache = [...res.data.data.logs];
+          // 按时间戳排序
+          this.localLogCache.sort((a, b) => a.time - b.time);
         }
       } catch (err) {
         console.error('Failed to fetch log history:', err);
@@ -239,6 +162,7 @@ export default {
       if (termElement) {
         termElement.innerHTML = '';
         
+        // 重新显示所有符合筛选条件的日志
         if (this.localLogCache && this.localLogCache.length > 0) {
           this.localLogCache.forEach(logItem => {
             if (this.isLevelSelected(logItem.level)) {
@@ -249,13 +173,16 @@ export default {
       }
     },
 
+
     toggleAutoScroll() {
       this.autoScroll = !this.autoScroll;
     },
 
     printLog(log) {
+      // append 一个 span 标签到 term，block 的方式
       let ele = document.getElementById('term')
       if (!ele) {
+        console.warn('term element not found, skipping log print');
         return;
       }
       
@@ -269,11 +196,11 @@ export default {
         }
       }
 
-      span.style = style + 'display: block; font-size: 12px; font-family: Consolas, monospace; white-space: pre-wrap; margin-bottom: 2px;'
+      span.style = style + 'display: block; font-size: 12px; font-family: Consolas, monospace; white-space: pre-wrap;'
       span.classList.add('fade-in')
       span.innerText = `${log}`;
       ele.appendChild(span)
-      if (this.autoScroll) {
+      if (this.autoScroll ) {
         ele.scrollTop = ele.scrollHeight
       }
     }
@@ -303,4 +230,4 @@ export default {
     opacity: 1;
   }
 }
-</style>
+</style>

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,114 +21,80 @@ const props = defineProps({
 
 // 定义要发送到父组件的事件
 const emit = defineEmits([
-  "configure",
-  "update",
-  "reload",
-  "install",
-  "uninstall",
-  "toggle-activation",
-  "view-handlers",
-  "view-readme",
-  "view-changelog",
+  'configure',
+  'update',
+  'reload',
+  'install',
+  'uninstall',
+  'toggle-activation',
+  'view-handlers',
+  'view-readme'
 ]);
 
 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);
-};
-
-const viewChangelog = () => {
-  emit("view-changelog", props.extension);
+  emit('view-readme', 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">
@@ -138,30 +104,16 @@ const viewChangelog = () => {
 
             <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" @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 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 -->
@@ -170,49 +122,32 @@ const viewChangelog = () => {
               <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 @click="updateExtension" :disabled="!extension?.has_update">
                   <v-list-item-title>
-                    {{
-                      extension.has_update
-                        ? tm("card.actions.updateTo") +
-                          " " +
-                          extension.online_version
-                        : tm("card.actions.reinstall")
-                    }}
+                    {{ tm('card.actions.updateTo') }} {{ extension.online_version || extension.version }}
                   </v-list-item-title>
                 </v-list-item>
               </template>
@@ -220,59 +155,23 @@ const viewChangelog = () => {
           </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>
@@ -283,58 +182,34 @@ const viewChangelog = () => {
               <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>
@@ -344,6 +219,7 @@ const viewChangelog = () => {
     v-model="showUninstallDialog"
     @confirm="handleUninstallConfirm"
   />
+
 </template>
 
 <style scoped>
@@ -363,7 +239,7 @@ const viewChangelog = () => {
   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 || tm('knowledgeBaseSelector.buttonText') }}
+      {{ buttonText }}
     </v-btn>
   </div>
 
@@ -105,7 +105,7 @@ const props = defineProps({
   },
   buttonText: {
     type: String,
-    default: ''
+    default: '选择知识库...'
   }
 })
 

dashboard/src/components/shared/ListConfigItem.vue

@@ -23,7 +23,7 @@
       </div>
     </div>
     <v-btn size="small" color="primary" variant="tonal" @click="openDialog">
-      {{ preferSingleItem ? t('core.common.list.addMore') : (buttonText || t('core.common.list.modifyButton')) }}
+      {{ preferSingleItem ? '添加更多' : (buttonText || t('core.common.list.modifyButton')) }}
     </v-btn>
   </div>
 
@@ -48,14 +48,6 @@
             :placeholder="t('core.common.list.inputPlaceholder')"
             class="flex-grow-1">
           </v-text-field>
-          <v-btn
-            @click="addItem"
-            variant="tonal"
-            color="primary"
-            size="small"
-            :disabled="!newItem.trim()">
-            {{ t('core.common.list.addButton') }}
-          </v-btn>
           <v-btn 
             @click="showBatchImport = true" 
             variant="tonal" 
@@ -175,11 +167,11 @@ const props = defineProps({
   },
   buttonText: {
     type: String,
-    default: ''
+    default: '修改'
   },
   dialogTitle: {
     type: String,
-    default: ''
+    default: '修改列表项'
   },
   maxDisplayItems: {
     type: Number,
@@ -326,4 +318,4 @@ function cancelBatchImport() {
 .v-chip {
   margin: 2px;
 }
-</style>
+</style>

dashboard/src/components/shared/ObjectEditor.vue

@@ -26,9 +26,8 @@
       </v-card-title>
 
       <v-card-text class="pa-4" style="max-height: 400px; overflow-y: auto;">
-        <!-- Regular key-value pairs (non-template) -->
-        <div v-if="nonTemplatePairs.length > 0">
-          <div v-for="(pair, index) in nonTemplatePairs" :key="index" class="key-value-pair">
+        <div v-if="localKeyValuePairs.length > 0">
+          <div v-for="(pair, index) in localKeyValuePairs" :key="index" class="key-value-pair">
             <v-row no-gutters align="center" class="mb-2">
               <v-col cols="4">
                 <v-text-field
@@ -49,29 +48,15 @@
                   hide-details
                   placeholder="字符串值"
                 ></v-text-field>
-                <div v-else-if="pair.type === 'number' || pair.type === 'float' || pair.type === 'int'" class="d-flex align-center gap-2 flex-grow-1">
-                  <v-slider
-                    v-if="pair.slider"
-                    :model-value="Number(pair.value) || 0"
-                    @update:model-value="pair.value = $event"
-                    :min="pair.slider.min"
-                    :max="pair.slider.max"
-                    :step="pair.slider.step"
-                    color="primary"
-                    density="compact"
-                    hide-details
-                    class="flex-grow-1"
-                  ></v-slider>
-                  <v-text-field
-                    v-model.number="pair.value"
-                    type="number"
-                    density="compact"
-                    variant="outlined"
-                    hide-details
-                    placeholder="数值"
-                    :style="pair.slider ? 'max-width: 120px;' : ''"
-                  ></v-text-field>
-                </div>
+                <v-text-field
+                  v-else-if="pair.type === 'number'"
+                  v-model.number="pair.value"
+                  type="number"
+                  density="compact"
+                  variant="outlined"
+                  hide-details
+                  placeholder="数值"
+                ></v-text-field>
                 <v-switch
                   v-else-if="pair.type === 'boolean'"
                   v-model="pair.value"
@@ -79,16 +64,6 @@
                   hide-details
                   color="primary"
                 ></v-switch>
-                <v-text-field
-                  v-if="pair.type === 'json'"
-                  v-model="pair.value"
-                  density="compact"
-                  variant="outlined"
-                  hide-details="auto"
-                  placeholder="JSON"
-                  @blur="updateJSON(index, pair.value)"
-                  :error-messages="pair.jsonError"
-                ></v-text-field>
               </v-col>
               <v-col cols="1" class="pl-2">
                 <v-btn
@@ -96,7 +71,7 @@
                   variant="text"
                   size="small"
                   color="error"
-                  @click="removeKeyValuePairByKey(pair.key)"
+                  @click="removeKeyValuePair(index)"
                 >
                   <v-icon>mdi-delete</v-icon>
                 </v-btn>
@@ -104,79 +79,7 @@
             </v-row>
           </div>
         </div>
-
-        <!-- Template schema fields -->
-        <div v-if="hasTemplateSchema" class="mt-4">
-          <v-divider class="mb-3"></v-divider>
-          <div class="text-caption text-grey mb-2">预设</div>
-          <div v-for="(template, templateKey) in templateSchema" :key="templateKey" class="template-field" :class="{ 'template-field-inactive': !isTemplateKeyAdded(templateKey) }">
-            <v-row no-gutters align="center" class="mb-2">
-              <v-col cols="4">
-                <div class="d-flex flex-column">
-                  <span class="text-caption font-weight-medium">{{ template.name || template.description || templateKey }}</span>
-                  <span v-if="template.hint" class="text-caption text-grey" style="font-size: 0.7rem;">{{ template.hint }}</span>
-                </div>
-              </v-col>
-              <v-col cols="7" class="pl-2 d-flex align-center justify-end">
-                <v-text-field
-                  v-if="template.type === 'string'"
-                  :model-value="getTemplateValue(templateKey)"
-                  @update:model-value="updateTemplateValue(templateKey, $event)"
-                  density="compact"
-                  variant="outlined"
-                  hide-details
-                  placeholder="字符串值"
-                ></v-text-field>
-                <div v-else-if="template.type === 'number' || template.type === 'float' || template.type === 'int'" class="d-flex align-center ga-4 flex-grow-1">
-                  <v-slider
-                    v-if="template.slider"
-                    :model-value="Number(getTemplateValue(templateKey)) || 0"
-                    @update:model-value="updateTemplateValue(templateKey, $event)"
-                    :min="template.slider.min"
-                    :max="template.slider.max"
-                    :step="template.slider.step"
-                    color="primary"
-                    density="compact"
-                    hide-details
-                    class="flex-grow-1"
-                  ></v-slider>
-                  <v-text-field
-                    :model-value="getTemplateValue(templateKey)"
-                    @update:model-value="updateTemplateValue(templateKey, $event)"
-                    type="number"
-                    density="compact"
-                    variant="outlined"
-                    hide-details
-                    placeholder="数值"
-                    :style="template.slider ? 'max-width: 120px;' : ''"
-                  ></v-text-field>
-                </div>
-                <v-switch
-                  v-else-if="template.type === 'boolean' || template.type === 'bool'"
-                  :model-value="getTemplateValue(templateKey)"
-                  @update:model-value="updateTemplateValue(templateKey, $event)"
-                  density="compact"
-                  hide-details
-                  color="primary"
-                ></v-switch>
-              </v-col>
-              <v-col cols="1" class="pl-2">
-                <v-btn
-                  v-if="isTemplateKeyAdded(templateKey)"
-                  icon
-                  variant="text"
-                  size="small"
-                  color="error"
-                  @click="removeTemplateKey(templateKey)"
-                >
-                  <v-icon>mdi-close</v-icon>
-                </v-btn>
-              </v-col>
-            </v-row>
-          </div>
-        </div>
-
-        <div v-if="localKeyValuePairs.length === 0 && !hasTemplateSchema" class="text-center py-8">
+        <div v-else class="text-center py-8">
           <v-icon size="64" color="grey-lighten-1">mdi-code-json</v-icon>
           <p class="text-grey mt-4">暂无参数</p>
         </div>
@@ -195,7 +98,7 @@
           ></v-text-field>
           <v-select
             v-model="newValueType"
-            :items="['string', 'number', 'boolean', 'json']"
+            :items="['string', 'number', 'boolean']"
             label="值类型"
             density="compact"
             variant="outlined"
@@ -229,10 +132,6 @@ const props = defineProps({
     type: Object,
     required: true
   },
-  itemMeta: {
-    type: Object,
-    default: null
-  },
   buttonText: {
     type: String,
     default: '修改'
@@ -255,25 +154,11 @@ const originalKeyValuePairs = ref([])
 const newKey = ref('')
 const newValueType = ref('string')
 
-// Template schema support
-const templateSchema = computed(() => {
-  return props.itemMeta?.template_schema || {}
-})
-
-const hasTemplateSchema = computed(() => {
-  return Object.keys(templateSchema.value).length > 0
-})
-
 // 计算要显示的键名
 const displayKeys = computed(() => {
   return Object.keys(props.modelValue).slice(0, props.maxDisplayItems)
 })
 
-// 分离模板字段和普通字段
-const nonTemplatePairs = computed(() => {
-  return localKeyValuePairs.value.filter(pair => !templateSchema.value[pair.key])
-})
-
 // 监听 modelValue 变化，主要用于初始化
 watch(() => props.modelValue, (newValue) => {
   // This watch is primarily for initialization or external changes
@@ -283,26 +168,10 @@ watch(() => props.modelValue, (newValue) => {
 function initializeLocalKeyValuePairs() {
   localKeyValuePairs.value = []
   for (const [key, value] of Object.entries(props.modelValue)) {
-    let _type = (typeof value) === 'object' ? 'json':(typeof value)
-    let _value = _type === 'json'?JSON.stringify(value):value
-    
-    // Check if this key has a template schema
-    const template = templateSchema.value[key]
-    if (template) {
-      // Use template type if available
-      _type = template.type || _type
-      // Use template default if value is missing
-      if (_value === undefined || _value === null) {
-        _value = template.default !== undefined ? template.default : _value
-      }
-    }
-    
     localKeyValuePairs.value.push({
       key: key,
-      value: _value,
-      type: _type,
-      slider: template?.slider,
-      template: template
+      value: value,
+      type: typeof value // Store the original type
     })
   }
 }
@@ -332,9 +201,6 @@ function addKeyValuePair() {
       case 'boolean':
         defaultValue = false
         break
-      case 'json':
-        defaultValue = "{}"
-        break
       default: // string
         defaultValue = ""
         break
@@ -349,20 +215,8 @@ function addKeyValuePair() {
   }
 }
 
-function updateJSON(index, newValue) {
-  try {
-    JSON.parse(newValue)
-    localKeyValuePairs.value[index].jsonError = ''
-  } catch (e) {
-    localKeyValuePairs.value[index].jsonError = 'JSON 格式错误'
-  }
-}
-
-function removeKeyValuePairByKey(key) {
-  const index = localKeyValuePairs.value.findIndex(pair => pair.key === key)
-  if (index >= 0) {
-    localKeyValuePairs.value.splice(index, 1)
-  }
+function removeKeyValuePair(index) {
+  localKeyValuePairs.value.splice(index, 1)
 }
 
 function updateKey(index, newKey) {
@@ -380,110 +234,28 @@ function updateKey(index, newKey) {
     return
   }
 
-  // 检查新键名是否有模板
-  const template = templateSchema.value[newKey]
-  if (template) {
-    // 更新类型和默认值
-    localKeyValuePairs.value[index].type = template.type || localKeyValuePairs.value[index].type
-    if (localKeyValuePairs.value[index].value === undefined || localKeyValuePairs.value[index].value === null || localKeyValuePairs.value[index].value === '') {
-      localKeyValuePairs.value[index].value = template.default !== undefined ? template.default : localKeyValuePairs.value[index].value
-    }
-    localKeyValuePairs.value[index].slider = template.slider
-    localKeyValuePairs.value[index].template = template
-  } else {
-    // 清除模板信息
-    localKeyValuePairs.value[index].slider = undefined
-    localKeyValuePairs.value[index].template = undefined
-  }
-
   // 更新本地副本
   localKeyValuePairs.value[index].key = newKey
 }
 
-function isTemplateKeyAdded(templateKey) {
-  return localKeyValuePairs.value.some(pair => pair.key === templateKey)
-}
-
-function getTemplateValue(templateKey) {
-  const pair = localKeyValuePairs.value.find(pair => pair.key === templateKey)
-  if (pair) {
-    return pair.value
-  }
-  const template = templateSchema.value[templateKey]
-  return template?.default !== undefined ? template.default : getDefaultValueForType(template?.type || 'string')
-}
-
-function updateTemplateValue(templateKey, newValue) {
-  const existingIndex = localKeyValuePairs.value.findIndex(pair => pair.key === templateKey)
-  const template = templateSchema.value[templateKey]
-  
-  if (existingIndex >= 0) {
-    // 更新现有值
-    localKeyValuePairs.value[existingIndex].value = newValue
-  } else {
-    // 添加新字段
-    let valueType = template?.type || 'string'
-    localKeyValuePairs.value.push({
-      key: templateKey,
-      value: newValue,
-      type: valueType,
-      slider: template?.slider,
-      template: template
-    })
-  }
-}
-
-function removeTemplateKey(templateKey) {
-  const index = localKeyValuePairs.value.findIndex(pair => pair.key === templateKey)
-  if (index >= 0) {
-    localKeyValuePairs.value.splice(index, 1)
-  }
-}
-
-function getDefaultValueForType(type) {
-  switch (type) {
-    case 'int':
-    case 'float':
-    case 'number':
-      return 0
-    case 'bool':
-    case 'boolean':
-      return false
-    case 'json':
-      return "{}"
-    case 'string':
-    default:
-      return ""
-  }
-}
-
 function confirmDialog() {
   const updatedValue = {}
   for (const pair of localKeyValuePairs.value) {
-    if (pair.type === 'json' && pair.jsonError) return
     let convertedValue = pair.value
     // 根据声明的类型进行转换
     switch (pair.type) {
-      case 'int':
-        convertedValue = parseInt(pair.value) || 0
-        break
-      case 'float':
       case 'number':
         // 尝试转换为数字，如果失败则保持原值（或设为默认值0）
         convertedValue = Number(pair.value)
         // 可选：检查是否为有效数字，无效则设为0或报错
         // if (isNaN(convertedValue)) convertedValue = 0;
         break
-      case 'bool':
       case 'boolean':
         // 布尔值通常由 v-switch 正确处理，但为保险起见可以显式转换
         // 注意：在 JavaScript 中，只有严格的 false, 0, "", null, undefined, NaN 会被转换为 false
         // 这里直接赋值 pair.value 应该是安全的，因为 v-model 绑定的就是布尔值
         // convertedValue = Boolean(pair.value)
         break
-      case 'json':
-        convertedValue = JSON.parse(pair.value)
-        break
       case 'string':
       default:
         // 默认转换为字符串
@@ -507,12 +279,4 @@ function cancelDialog() {
 .key-value-pair {
   width: 100%;
 }
-
-.template-field {
-  transition: opacity 0.2s;
-}
-
-.template-field-inactive {
-  opacity: 0.8;
-}
 </style>