feat：可以查看转发消息，新增复杂消息，修复表情包缓存，修改bot自己的消息回调msg_id

src/maisaka/builtin_tool/__init__.py

@@ -17,6 +17,8 @@ from .reply import get_tool_spec as get_reply_tool_spec
 from .reply import handle_tool as handle_reply_tool
 from .send_emoji import get_tool_spec as get_send_emoji_tool_spec
 from .send_emoji import handle_tool as handle_send_emoji_tool
+from .view_complex_message import get_tool_spec as get_view_complex_message_tool_spec
+from .view_complex_message import handle_tool as handle_view_complex_message_tool
 from .wait import get_tool_spec as get_wait_tool_spec
 from .wait import handle_tool as handle_wait_tool
 
@@ -29,6 +31,7 @@ def get_builtin_tool_specs() -> List[ToolSpec]:
     return [
         get_wait_tool_spec(),
         get_reply_tool_spec(),
+        get_view_complex_message_tool_spec(),
         get_query_jargon_tool_spec(),
         get_no_reply_tool_spec(),
         get_send_emoji_tool_spec(),
@@ -41,6 +44,7 @@ def get_all_builtin_tool_specs() -> List[ToolSpec]:
     return [
         get_wait_tool_spec(),
         get_reply_tool_spec(),
+        get_view_complex_message_tool_spec(),
         get_query_jargon_tool_spec(),
         get_query_person_info_tool_spec(),
         get_no_reply_tool_spec(),
@@ -68,4 +72,9 @@ def build_builtin_tool_handlers(tool_ctx: BuiltinToolRuntimeContext) -> Dict[str
         ),
         "wait": lambda invocation, context=None: handle_wait_tool(tool_ctx, invocation, context),
         "send_emoji": lambda invocation, context=None: handle_send_emoji_tool(tool_ctx, invocation, context),
+        "view_complex_message": lambda invocation, context=None: handle_view_complex_message_tool(
+            tool_ctx,
+            invocation,
+            context,
+        ),
     }

src/maisaka/builtin_tool/send_emoji.py

@@ -5,6 +5,7 @@ from typing import Any, Dict, Optional
 from src.chat.emoji_system.maisaka_tool import send_emoji_for_maisaka
 from src.common.logger import get_logger
 from src.core.tooling import ToolExecutionContext, ToolExecutionResult, ToolInvocation, ToolSpec
+from src.maisaka.context_messages import LLMContextMessage
 
 from .context import BuiltinToolRuntimeContext
 
@@ -42,9 +43,9 @@ async def handle_tool(
     del context
     emotion = str(invocation.arguments.get("emotion") or "").strip()
     context_texts = [
-        message.get_history_text()
+        message.processed_plain_text.strip()
         for message in tool_ctx.runtime._chat_history[-5:]
-        if message.get_history_text().strip()
+        if isinstance(message, LLMContextMessage) and message.processed_plain_text.strip()
     ]
     structured_result: Dict[str, Any] = {
         "success": False,

src/maisaka/builtin_tool/view_complex_message.py

@@ -0,0 +1,99 @@
+"""view_complex_message 内置工具。"""
+
+from typing import Optional
+
+from src.common.logger import get_logger
+from src.core.tooling import ToolExecutionContext, ToolExecutionResult, ToolInvocation, ToolSpec
+
+from ..context_messages import build_full_complex_message_content, contains_complex_message
+from .context import BuiltinToolRuntimeContext
+
+logger = get_logger("maisaka_builtin_view_complex_message")
+
+
+def get_tool_spec() -> ToolSpec:
+    """获取 view_complex_message 工具声明。"""
+
+    return ToolSpec(
+        name="view_complex_message",
+        brief_description="根据 msg_id 查看复杂消息的完整内容，适用于 Prompt 中标记为 [消息类型]复杂消息 的消息。",
+        detailed_description=(
+            "参数说明：\n"
+            "- msg_id：string，必填。要查看完整内容的目标消息编号。\n\n"
+            "当你在上下文中看到 [消息类型]复杂消息 时，可调用本工具查看对应转发消息的完整展开内容。"
+        ),
+        parameters_schema={
+            "type": "object",
+            "properties": {
+                "msg_id": {
+                    "type": "string",
+                    "description": "要查看完整内容的目标消息编号。",
+                },
+            },
+            "required": ["msg_id"],
+        },
+        provider_name="maisaka_builtin",
+        provider_type="builtin",
+    )
+
+
+async def handle_tool(
+    tool_ctx: BuiltinToolRuntimeContext,
+    invocation: ToolInvocation,
+    context: Optional[ToolExecutionContext] = None,
+) -> ToolExecutionResult:
+    """执行 view_complex_message 内置工具。"""
+
+    del context
+    target_message_id = str(invocation.arguments.get("msg_id") or "").strip()
+    if not target_message_id:
+        return tool_ctx.build_failure_result(
+            invocation.tool_name,
+            "查看复杂消息工具需要提供有效的 `msg_id` 参数。",
+        )
+
+    target_message = tool_ctx.runtime._source_messages_by_id.get(target_message_id)
+    if target_message is None:
+        return tool_ctx.build_failure_result(
+            invocation.tool_name,
+            f"未找到目标复杂消息，msg_id={target_message_id}",
+        )
+
+    if not contains_complex_message(target_message.raw_message):
+        return tool_ctx.build_failure_result(
+            invocation.tool_name,
+            f"目标消息不是可展开查看的转发消息，msg_id={target_message_id}",
+        )
+
+    logger.info(
+        f"{tool_ctx.runtime.log_prefix} 触发复杂消息查看工具，目标消息编号={target_message_id}"
+    )
+    try:
+        full_content = await build_full_complex_message_content(target_message)
+    except Exception as exc:
+        logger.exception(
+            f"{tool_ctx.runtime.log_prefix} 查看复杂消息时发生异常: 目标消息编号={target_message_id} 异常={exc}"
+        )
+        return tool_ctx.build_failure_result(
+            invocation.tool_name,
+            "查看复杂消息完整内容时发生异常。",
+        )
+
+    if not full_content:
+        return tool_ctx.build_failure_result(
+            invocation.tool_name,
+            f"复杂消息内容为空，msg_id={target_message_id}",
+        )
+
+    return tool_ctx.build_success_result(
+        invocation.tool_name,
+        full_content,
+        structured_content={
+            "msg_id": target_message_id,
+            "message_type": "forward",
+            "full_content": full_content,
+        },
+        metadata={
+            "record_display_prompt": f"你查看了复杂消息 {target_message_id} 的完整内容。",
+        },
+    )