feat: update version to 4.9.0 in pyproject.toml, __init__.py, and uv.lock

Merge branch 'master' into feat/dbm20-rag

.pre-commit-config.yaml

@@ -9,14 +9,16 @@ repos:
       # Run the formatter of backend.
       - id: ruff-format
 
-  - repo: local
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v3.1.0
     hooks:
       - id: prettier
-        name: prettier
-        entry: npx --prefix web prettier --write --ignore-unknown
-        language: system
         types_or: [javascript, jsx, ts, tsx, css, scss]
+        additional_dependencies:
+          - prettier@3.1.0
 
+  - repo: local
+    hooks:
       - id: lint-staged
         name: lint-staged
         entry: cd web && pnpm lint-staged

README_CN.md

@@ -34,6 +34,8 @@
 
 ---
 
+## 什么是 LangBot？
+
 LangBot 是一个**开源的生产级平台**，用于构建 AI 驱动的即时通信机器人。它将大语言模型（LLM）连接到各种聊天平台，帮助你创建能够对话、执行任务、并集成到现有工作流程中的智能 Agent。
 
 ### 核心能力
@@ -41,7 +43,7 @@ LangBot 是一个**开源的生产级平台**，用于构建 AI 驱动的即时
 - **AI 对话与 Agent** — 多轮对话、工具调用、多模态、流式输出。自带 RAG（知识库），深度集成 [Dify](https://dify.ai)、[Coze](https://coze.com)、[n8n](https://n8n.io)、[Langflow](https://langflow.org) 等 LLMOps 平台。
 - **全平台支持** — 一套代码，覆盖 QQ、微信、企业微信、飞书、钉钉、Discord、Telegram、Slack、LINE、KOOK 等平台。
 - **生产就绪** — 访问控制、限速、敏感词过滤、全面监控与异常处理，已被多家企业采用。
-- **插件生态** — 数百个插件，跨进程的事件驱动架构，组件扩展，适配 [MCP 协议](https://modelcontextprotocol.io/)。
+- **插件生态** — 数百个插件，事件驱动架构，组件扩展，适配 [MCP 协议](https://modelcontextprotocol.io/)。
 - **Web 管理面板** — 通过浏览器直观地配置、管理和监控机器人，无需手动编辑配置文件。
 - **多流水线架构** — 不同机器人用于不同场景，具备全面的监控和异常处理能力。
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "langbot"
-version = "4.9.4"
+version = "4.9.0"
 description = "Production-grade platform for building agentic IM bots"
 readme = "README.md"
 license-files = ["LICENSE"]
@@ -61,10 +61,10 @@ dependencies = [
     "html2text>=2024.2.26",
     "langchain>=0.2.0",
     "langchain-text-splitters>=0.0.1",
-    "chromadb>=1.0.0,<2.0.0",
+    "chromadb>=0.4.24",
     "qdrant-client (>=1.15.1,<2.0.0)",
     "pyseekdb==1.1.0.post3",
-    "langbot-plugin==0.3.5",
+    "langbot-plugin==0.3.0",
     "asyncpg>=0.30.0",
     "line-bot-sdk>=3.19.0",
     "tboxsdk>=0.0.10",

src/langbot/__init__.py

@@ -1,3 +1,3 @@
 """LangBot - Production-grade platform for building agentic IM bots"""
 
-__version__ = '4.9.4'
+__version__ = '4.9.0'

src/langbot/libs/dingtalk_api/api.py

@@ -272,30 +272,15 @@ class DingTalkClient:
 
                 message_data['Type'] = 'audio'
             elif incoming_message.message_type == 'file':
-                # 获取原始数据字典并提取嵌套的文件信息
-                raw_data = incoming_message.to_dict()
-                file_info = raw_data.get('content', {})
-
-                # 兼容处理：如果 content 仍为 JSON 字符串则进行解析
-                if isinstance(file_info, str):
-                    try:
-                        file_info = json.loads(file_info)
-                    except (json.JSONDecodeError, TypeError):
-                        file_info = {}
-
-                download_code = file_info.get('downloadCode')
-                file_name = file_info.get('fileName')
-
-                if download_code and file_name:
-                    # 转换 downloadCode 为可下载的真实 URL
-                    message_data['File'] = await self.get_file_url(download_code)
-                    message_data['Name'] = file_name
+                down_list = incoming_message.get_down_list()
+                if len(down_list) >= 2:
+                    message_data['File'] = await self.get_file_url(down_list[0])
+                    message_data['Name'] = down_list[1]
                 else:
                     if self.logger:
-                        await self.logger.error(f'Failed to extract file info from message content: {file_info}')
+                        await self.logger.error(f'get_down_list() returned fewer than 2 elements: {down_list}')
                     message_data['File'] = None
                     message_data['Name'] = None
-
                 message_data['Type'] = 'file'
 
             copy_message_data = message_data.copy()

src/langbot/libs/openclaw_weixin_api/__init__.py

@@ -1,3 +0,0 @@
-from .client import OpenClawWeixinClient as OpenClawWeixinClient
-from .types import ApiError as ApiError
-from .types import LoginResult as LoginResult

src/langbot/libs/openclaw_weixin_api/client.py

@@ -1,807 +0,0 @@
-"""Async HTTP client for the OpenClaw WeChat API.
-
-Implements the iLink Bot API protocol.
-Reference: https://github.com/epiral/weixin-bot
-
-Endpoints: getUpdates (long-poll), sendMessage, getUploadUrl, getConfig, sendTyping.
-"""
-
-from __future__ import annotations
-
-import asyncio
-import base64
-import io
-import logging
-import os
-import struct
-import typing
-import uuid
-from typing import Optional
-from urllib.parse import quote
-
-import aiohttp
-
-from .types import (
-    ApiError,
-    CDNMedia,
-    FileItem,
-    GetConfigResponse,
-    GetUpdatesResponse,
-    GetUploadUrlResponse,
-    ImageItem,
-    LoginResult,
-    MessageItem,
-    QRCodeResponse,
-    QRStatusResponse,
-    RefMessage,
-    TextItem,
-    VideoItem,
-    VoiceItem,
-    WeixinMessage,
-)
-
-logger = logging.getLogger('openclaw-weixin-sdk')
-
-DEFAULT_BASE_URL = 'https://ilinkai.weixin.qq.com'
-CDN_BASE_URL = 'https://novac2c.cdn.weixin.qq.com/c2c'
-
-CHANNEL_VERSION = '1.0.0'
-
-DEFAULT_API_TIMEOUT = 15
-DEFAULT_LONG_POLL_TIMEOUT = 40
-DEFAULT_CONFIG_TIMEOUT = 10
-DEFAULT_QR_POLL_TIMEOUT = 35
-
-SESSION_EXPIRED_ERRCODE = -14
-
-DEFAULT_BOT_TYPE = '3'
-
-# Maximum text length per message chunk (WeChat limit)
-MAX_TEXT_CHUNK_SIZE = 2000
-
-
-def _random_wechat_uin() -> str:
-    """Generate the X-WECHAT-UIN header: random uint32 -> decimal string -> base64."""
-    rand_bytes = os.urandom(4)
-    uint32_val = struct.unpack('>I', rand_bytes)[0]
-    return base64.b64encode(str(uint32_val).encode('utf-8')).decode('utf-8')
-
-
-def _build_base_info() -> dict:
-    """Build the base_info payload included in every API request."""
-    return {'channel_version': CHANNEL_VERSION}
-
-
-def _chunk_text(text: str, max_size: int = MAX_TEXT_CHUNK_SIZE) -> list[str]:
-    """Split long text into chunks that fit within WeChat's message size limit."""
-    if len(text) <= max_size:
-        return [text]
-    chunks = []
-    while text:
-        chunks.append(text[:max_size])
-        text = text[max_size:]
-    return chunks
-
-
-class OpenClawWeixinClient:
-    """Async client for the OpenClaw WeChat HTTP JSON API."""
-
-    def __init__(self, base_url: str, token: str):
-        self.base_url = base_url.rstrip('/')
-        self.token = token
-        self._session: Optional[aiohttp.ClientSession] = None
-
-    async def _get_session(self) -> aiohttp.ClientSession:
-        if self._session is None or self._session.closed:
-            self._session = aiohttp.ClientSession()
-        return self._session
-
-    async def close(self):
-        if self._session and not self._session.closed:
-            await self._session.close()
-
-    def _build_headers(self) -> dict[str, str]:
-        headers = {
-            'Content-Type': 'application/json',
-            'AuthorizationType': 'ilink_bot_token',
-            'X-WECHAT-UIN': _random_wechat_uin(),
-        }
-        if self.token:
-            headers['Authorization'] = f'Bearer {self.token}'
-        return headers
-
-    async def _post(self, endpoint: str, payload: dict, timeout: float = DEFAULT_API_TIMEOUT) -> dict:
-        """Make a POST request and return the JSON response.
-
-        Raises ApiError on HTTP errors or when the response contains a non-zero errcode.
-        """
-        payload['base_info'] = _build_base_info()
-
-        session = await self._get_session()
-        url = f'{self.base_url}/{endpoint}'
-        headers = self._build_headers()
-
-        async with session.post(
-            url, json=payload, headers=headers, timeout=aiohttp.ClientTimeout(total=timeout)
-        ) as resp:
-            if resp.status != 200:
-                text = await resp.text()
-                raise ApiError(
-                    f'OpenClaw API error {resp.status}: {text}',
-                    status=resp.status,
-                )
-            data = await resp.json(content_type=None)
-
-        # Check for application-level errors in the response body
-        errcode = data.get('errcode') or data.get('ret')
-        if errcode and errcode != 0:
-            raise ApiError(
-                data.get('errmsg') or f'API errcode {errcode}',
-                status=200,
-                code=errcode,
-                payload=data,
-            )
-
-        return data
-
-    async def get_updates(
-        self, get_updates_buf: str = '', timeout: float = DEFAULT_LONG_POLL_TIMEOUT
-    ) -> GetUpdatesResponse:
-        """Long-poll for new messages.
-
-        Note: This method does NOT raise ApiError for errcode responses —
-        it returns them in the GetUpdatesResponse so the caller can handle
-        session expiry and other errors with full context.
-        """
-        try:
-            # Bypass the errcode check in _post since get_updates needs
-            # to return error info (e.g. session expired) to the caller.
-            payload: dict = {'get_updates_buf': get_updates_buf}
-            payload['base_info'] = _build_base_info()
-
-            session = await self._get_session()
-            url = f'{self.base_url}/ilink/bot/getupdates'
-            headers = self._build_headers()
-
-            async with session.post(
-                url,
-                json=payload,
-                headers=headers,
-                timeout=aiohttp.ClientTimeout(total=timeout),
-            ) as resp:
-                if resp.status != 200:
-                    text = await resp.text()
-                    raise ApiError(
-                        f'OpenClaw API error {resp.status}: {text}',
-                        status=resp.status,
-                    )
-                data = await resp.json(content_type=None)
-
-        except (asyncio.TimeoutError, aiohttp.ServerTimeoutError):
-            return GetUpdatesResponse(ret=0, msgs=[], get_updates_buf=get_updates_buf)
-        except ApiError:
-            raise
-        except Exception as e:
-            if 'timeout' in str(e).lower():
-                return GetUpdatesResponse(ret=0, msgs=[], get_updates_buf=get_updates_buf)
-            raise
-
-        return _parse_get_updates_response(data)
-
-    async def send_message(
-        self,
-        to_user_id: str,
-        item_list: list[MessageItem],
-        context_token: str = '',
-    ) -> None:
-        """Send a message to a user."""
-        items_payload = [_message_item_to_dict(item) for item in item_list]
-
-        payload = {
-            'msg': {
-                'from_user_id': '',
-                'to_user_id': to_user_id,
-                'client_id': f'langbot-{uuid.uuid4().hex[:16]}',
-                'message_type': WeixinMessage.TYPE_BOT,
-                'message_state': WeixinMessage.STATE_FINISH,
-                'item_list': items_payload,
-                'context_token': context_token or None,
-            }
-        }
-        await self._post('ilink/bot/sendmessage', payload)
-
-    async def send_text(self, to_user_id: str, text: str, context_token: str = '') -> None:
-        """Send a plain text message, automatically chunking if too long."""
-        chunks = _chunk_text(text)
-        for chunk in chunks:
-            item = MessageItem(type=MessageItem.TEXT, text_item=TextItem(text=chunk))
-            await self.send_message(to_user_id, [item], context_token)
-
-    async def get_config(self, ilink_user_id: str, context_token: str = '') -> GetConfigResponse:
-        """Get bot config including typing_ticket."""
-        data = await self._post(
-            'ilink/bot/getconfig',
-            {'ilink_user_id': ilink_user_id, 'context_token': context_token or None},
-            timeout=DEFAULT_CONFIG_TIMEOUT,
-        )
-        return GetConfigResponse(
-            ret=data.get('ret'),
-            errmsg=data.get('errmsg'),
-            typing_ticket=data.get('typing_ticket'),
-        )
-
-    async def send_typing(self, ilink_user_id: str, typing_ticket: str, status: int = 1) -> None:
-        """Send typing indicator. status: 1=typing, 2=cancel."""
-        await self._post(
-            'ilink/bot/sendtyping',
-            {
-                'ilink_user_id': ilink_user_id,
-                'typing_ticket': typing_ticket,
-                'status': status,
-            },
-            timeout=DEFAULT_CONFIG_TIMEOUT,
-        )
-
-    async def stop_typing(self, ilink_user_id: str, typing_ticket: str) -> None:
-        """Cancel the typing indicator for a user."""
-        await self.send_typing(ilink_user_id, typing_ticket, status=2)
-
-    async def download_media(
-        self,
-        media: CDNMedia,
-    ) -> bytes:
-        """Download and decrypt a file from the WeChat CDN.
-
-        Args:
-            media: CDNMedia object with encrypt_query_param and aes_key.
-
-        Returns:
-            Decrypted file bytes.
-        """
-        from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes
-        from cryptography.hazmat.primitives.padding import PKCS7
-
-        if not media.encrypt_query_param:
-            raise ApiError('CDN media has no encrypt_query_param', status=0)
-        if not media.aes_key:
-            raise ApiError('CDN media has no aes_key', status=0)
-
-        # Derive 16-byte AES key
-        # aes_key is base64-encoded; the decoded content may be:
-        #   - raw 16 bytes (direct AES key)
-        #   - 32-char hex string (decode hex to get 16 bytes)
-        raw = base64.b64decode(media.aes_key)
-        if len(raw) == 16:
-            aes_key = raw
-        elif len(raw) == 32:
-            # Hex-encoded 16-byte key
-            aes_key = bytes.fromhex(raw.decode('utf-8'))
-        else:
-            raise ApiError(f'Invalid AES key length: {len(raw)} (expected 16 or 32)', status=0)
-
-        # Download encrypted bytes from CDN
-        session = await self._get_session()
-        cdn_url = f'{CDN_BASE_URL}/download?encrypted_query_param={quote(media.encrypt_query_param, safe="")}'
-
-        async with session.get(cdn_url, timeout=aiohttp.ClientTimeout(total=120)) as resp:
-            if resp.status != 200:
-                text = await resp.text()
-                raise ApiError(f'CDN download failed: {resp.status} {text}', status=resp.status)
-            encrypted = await resp.read()
-
-        # Decrypt AES-128-ECB with PKCS7 padding
-        cipher = Cipher(algorithms.AES(aes_key), modes.ECB())
-        decryptor = cipher.decryptor()
-        padded = decryptor.update(encrypted) + decryptor.finalize()
-
-        unpadder = PKCS7(128).unpadder()
-        return unpadder.update(padded) + unpadder.finalize()
-
-    async def upload_media(
-        self,
-        file_bytes: bytes,
-        to_user_id: str,
-        media_type: int,
-    ) -> CDNMedia:
-        """Encrypt and upload media to WeChat CDN.
-
-        Args:
-            file_bytes: Raw file bytes to upload.
-            to_user_id: Recipient user ID.
-            media_type: 1=IMAGE, 2=VIDEO, 3=FILE, 4=VOICE.
-
-        Returns:
-            CDNMedia with encrypt_query_param and aes_key for use in sendMessage.
-        """
-        import hashlib
-
-        from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes
-        from cryptography.hazmat.primitives.padding import PKCS7
-
-        # 1. Generate random 16-byte AES key
-        raw_key = os.urandom(16)
-        aes_key_hex = raw_key.hex()  # 32-char hex string
-
-        # 2. Encode key for CDNMedia: base64(hex_string) — same for all media types
-        # Matches official SDK: Buffer.from(aeskey_hex).toString("base64")
-        encoded_key = base64.b64encode(aes_key_hex.encode('utf-8')).decode('utf-8')
-
-        # 3. Encrypt file with AES-128-ECB + PKCS7
-        padder = PKCS7(128).padder()
-        padded = padder.update(file_bytes) + padder.finalize()
-        cipher = Cipher(algorithms.AES(raw_key), modes.ECB())
-        encryptor = cipher.encryptor()
-        encrypted = encryptor.update(padded) + encryptor.finalize()
-
-        # 4. Get upload URL
-        raw_md5 = hashlib.md5(file_bytes).hexdigest()
-        filekey = os.urandom(16).hex()  # 32-char hex, matches official SDK
-
-        upload_resp = await self.get_upload_url(
-            filekey=filekey,
-            media_type=media_type,
-            to_user_id=to_user_id,
-            rawsize=len(file_bytes),
-            rawfilemd5=raw_md5,
-            filesize=len(encrypted),
-            aeskey=aes_key_hex,  # hex string, as expected by the API
-        )
-
-        if not upload_resp.upload_param:
-            raise ApiError('Failed to get upload URL', status=0)
-
-        # 5. Upload to CDN
-        # upload_param is an opaque token from the server — pass it as-is
-        session = await self._get_session()
-        cdn_url = f'{CDN_BASE_URL}/upload?encrypted_query_param={quote(upload_resp.upload_param, safe="")}&filekey={quote(filekey, safe="")}'
-        logger.debug(
-            'CDN upload: url=%s raw_size=%d encrypted_size=%d md5=%s aeskey=%s',
-            cdn_url,
-            len(file_bytes),
-            len(encrypted),
-            raw_md5,
-            encoded_key,
-        )
-
-        async with session.post(
-            cdn_url,
-            data=encrypted,
-            headers={'Content-Type': 'application/octet-stream'},
-            timeout=aiohttp.ClientTimeout(total=120),
-        ) as resp:
-            if resp.status != 200:
-                text = await resp.text()
-                logger.error('CDN upload failed: status=%d url=%s body=%s', resp.status, cdn_url, text[:500])
-                raise ApiError(f'CDN upload failed: {resp.status} {text}', status=resp.status)
-            download_param = resp.headers.get('x-encrypted-param', '')
-
-        if not download_param:
-            raise ApiError('CDN upload succeeded but no x-encrypted-param returned', status=0)
-
-        return CDNMedia(
-            encrypt_query_param=download_param,
-            aes_key=encoded_key,
-            encrypt_type=1,
-        )
-
-    async def send_image(
-        self,
-        to_user_id: str,
-        image_bytes: bytes,
-        context_token: str = '',
-    ) -> None:
-        """Upload an image to CDN and send it."""
-        media = await self.upload_media(image_bytes, to_user_id, media_type=1)
-        item = MessageItem(
-            type=MessageItem.IMAGE,
-            image_item=ImageItem(
-                media=media,
-                aeskey=media.aes_key,
-            ),
-        )
-        await self.send_message(to_user_id, [item], context_token)
-
-    async def send_file(
-        self,
-        to_user_id: str,
-        file_bytes: bytes,
-        file_name: str,
-        context_token: str = '',
-    ) -> None:
-        """Upload a file to CDN and send it."""
-        import hashlib
-
-        media = await self.upload_media(file_bytes, to_user_id, media_type=3)
-        item = MessageItem(
-            type=MessageItem.FILE,
-            file_item=FileItem(
-                media=media,
-                file_name=file_name,
-                md5=hashlib.md5(file_bytes).hexdigest(),
-                len=str(len(file_bytes)),
-            ),
-        )
-        await self.send_message(to_user_id, [item], context_token)
-
-    async def send_voice(
-        self,
-        to_user_id: str,
-        voice_bytes: bytes,
-        playtime: int = 0,
-        context_token: str = '',
-    ) -> None:
-        """Upload a voice message to CDN and send it."""
-        media = await self.upload_media(voice_bytes, to_user_id, media_type=4)
-        item = MessageItem(
-            type=MessageItem.VOICE,
-            voice_item=VoiceItem(
-                media=media,
-                playtime=playtime,
-            ),
-        )
-        await self.send_message(to_user_id, [item], context_token)
-
-    async def get_upload_url(
-        self,
-        filekey: str,
-        media_type: int,
-        to_user_id: str,
-        rawsize: int,
-        rawfilemd5: str,
-        filesize: int,
-        thumb_rawsize: Optional[int] = None,
-        thumb_rawfilemd5: Optional[str] = None,
-        thumb_filesize: Optional[int] = None,
-        aeskey: Optional[str] = None,
-    ) -> GetUploadUrlResponse:
-        """Get a pre-signed CDN upload URL."""
-        payload: dict = {
-            'filekey': filekey,
-            'media_type': media_type,
-            'to_user_id': to_user_id,
-            'rawsize': rawsize,
-            'rawfilemd5': rawfilemd5,
-            'filesize': filesize,
-            'no_need_thumb': True,
-        }
-        if thumb_rawsize is not None:
-            payload['thumb_rawsize'] = thumb_rawsize
-        if thumb_rawfilemd5 is not None:
-            payload['thumb_rawfilemd5'] = thumb_rawfilemd5
-        if thumb_filesize is not None:
-            payload['thumb_filesize'] = thumb_filesize
-        if aeskey is not None:
-            payload['aeskey'] = aeskey
-
-        data = await self._post('ilink/bot/getuploadurl', payload)
-        logger.debug('get_upload_url response: %s', data)
-        return GetUploadUrlResponse(
-            upload_param=data.get('upload_param'),
-            thumb_upload_param=data.get('thumb_upload_param'),
-        )
-
-    # -----------------------------------------------------------------------
-    # QR Code Login
-    # -----------------------------------------------------------------------
-
-    async def fetch_qrcode(self, bot_type: str = DEFAULT_BOT_TYPE) -> QRCodeResponse:
-        """Fetch a QR code for WeChat login authorization (GET, no auth needed)."""
-        session = await self._get_session()
-        url = f'{self.base_url}/ilink/bot/get_bot_qrcode?bot_type={bot_type}'
-
-        async with session.get(url, timeout=aiohttp.ClientTimeout(total=DEFAULT_API_TIMEOUT)) as resp:
-            if resp.status != 200:
-                text = await resp.text()
-                raise ApiError(
-                    f'Failed to fetch QR code: {resp.status} {text}',
-                    status=resp.status,
-                )
-            data = await resp.json(content_type=None)
-
-        logger.debug(
-            'fetch_qrcode response: qrcode=%s, img=%s', data.get('qrcode'), bool(data.get('qrcode_img_content'))
-        )
-
-        return QRCodeResponse(
-            qrcode=data.get('qrcode'),
-            qrcode_img_content=data.get('qrcode_img_content'),
-        )
-
-    async def _fetch_qr_image_base64(self, url: str) -> str:
-        """Generate a QR code image from the URL and return a data URI string.
-
-        The qrcode_img_content URL points to an HTML page (not a raw image),
-        so we generate the QR code locally using the qrcode library.
-        """
-        import qrcode
-
-        qr = qrcode.QRCode(error_correction=qrcode.constants.ERROR_CORRECT_L)
-        qr.add_data(url)
-        qr.make(fit=True)
-        img = qr.make_image(fill_color='black', back_color='white')
-
-        buf = io.BytesIO()
-        img.save(buf, format='PNG')
-        b64 = base64.b64encode(buf.getvalue()).decode('utf-8')
-        return f'data:image/png;base64,{b64}'
-
-    async def poll_qrcode_status(self, qrcode: str) -> QRStatusResponse:
-        """Long-poll the QR code scan status (GET with iLink-App-ClientVersion header)."""
-        session = await self._get_session()
-        url = f'{self.base_url}/ilink/bot/get_qrcode_status?qrcode={quote(qrcode, safe="")}'
-        headers = {'iLink-App-ClientVersion': '1'}
-
-        try:
-            async with session.get(
-                url, headers=headers, timeout=aiohttp.ClientTimeout(total=DEFAULT_QR_POLL_TIMEOUT)
-            ) as resp:
-                if resp.status != 200:
-                    text = await resp.text()
-                    raise ApiError(
-                        f'Failed to poll QR status: {resp.status} {text}',
-                        status=resp.status,
-                    )
-                data = await resp.json(content_type=None)
-                logger.debug('QR status poll response: %s', data)
-        except (asyncio.TimeoutError, aiohttp.ServerTimeoutError):
-            return QRStatusResponse(status='wait')
-
-        return QRStatusResponse(
-            status=data.get('status'),
-            bot_token=data.get('bot_token'),
-            ilink_bot_id=data.get('ilink_bot_id'),
-            baseurl=data.get('baseurl'),
-            ilink_user_id=data.get('ilink_user_id'),
-        )
-
-    async def login(
-        self,
-        max_retries: int = 5,
-        poll_timeout_ms: int = 480_000,
-        on_qrcode: Optional[typing.Callable[[str, str], typing.Any]] = None,
-        on_status: Optional[typing.Callable[[str], typing.Any]] = None,
-    ) -> LoginResult:
-        """Complete QR code login flow with auto-retry on expiry.
-
-        Args:
-            max_retries: Max number of QR code refreshes on expiry.
-            poll_timeout_ms: Timeout per QR code in milliseconds.
-            on_qrcode: Callback(qr_image_base64, qr_url) called each time a
-                        new QR code is fetched. Use this to display the QR code.
-            on_status: Callback(status_str) called on each status poll change.
-
-        Returns:
-            LoginResult with token, base_url, and account_id.
-
-        Raises:
-            ApiError: On unrecoverable API errors.
-            Exception: If all retries are exhausted.
-        """
-        last_qr_base64: Optional[str] = None
-
-        for attempt in range(max_retries):
-            qr_resp = await self.fetch_qrcode()
-            if not qr_resp.qrcode or not qr_resp.qrcode_img_content:
-                raise ApiError('Failed to get QR code from server', status=0)
-
-            # Convert QR image to base64 and notify caller
-            last_qr_base64 = await self._fetch_qr_image_base64(qr_resp.qrcode_img_content)
-            if on_qrcode:
-                try:
-                    result = on_qrcode(last_qr_base64, qr_resp.qrcode_img_content)
-                    if asyncio.iscoroutine(result) or asyncio.isfuture(result):
-                        await result
-                except Exception as e:
-                    logger.warning('on_qrcode callback error: %s', e)
-
-            # Poll until confirmed / expired / timeout
-            loop = asyncio.get_running_loop()
-            deadline = loop.time() + poll_timeout_ms / 1000.0
-
-            while loop.time() < deadline:
-                try:
-                    status_resp = await self.poll_qrcode_status(qr_resp.qrcode)
-                except Exception as e:
-                    logger.error('Error polling QR status: %s', e)
-                    await asyncio.sleep(2)
-                    continue
-
-                if on_status:
-                    try:
-                        cb_result = on_status(status_resp.status or 'unknown')
-                        if asyncio.iscoroutine(cb_result) or asyncio.isfuture(cb_result):
-                            await cb_result
-                    except Exception as e:
-                        logger.warning('on_status callback error: %s', e)
-
-                if status_resp.status == 'confirmed' and status_resp.bot_token:
-                    new_base_url = status_resp.baseurl or self.base_url
-                    # Update this client instance as well
-                    self.token = status_resp.bot_token
-                    self.base_url = new_base_url.rstrip('/')
-                    return LoginResult(
-                        token=status_resp.bot_token,
-                        base_url=new_base_url,
-                        account_id=status_resp.ilink_bot_id or '',
-                        qr_image_base64=last_qr_base64,
-                    )
-
-                if status_resp.status == 'expired':
-                    break  # retry with a new QR code
-
-                await asyncio.sleep(1)
-            else:
-                # While-loop ended without break → poll timeout, treat as expired
-                pass
-
-            remaining = max_retries - attempt - 1
-            if remaining > 0:
-                logger.info('QR code expired, refreshing... (%d retries left)', remaining)
-            else:
-                raise ApiError('QR code login failed: max retries exceeded', status=0)
-
-        # Should not reach here, but just in case
-        raise ApiError('QR code login failed', status=0)
-
-
-# ---------------------------------------------------------------------------
-# Parsing helpers
-# ---------------------------------------------------------------------------
-
-
-def _parse_cdn_media(data: Optional[dict]) -> Optional[CDNMedia]:
-    if not data:
-        return None
-    return CDNMedia(
-        encrypt_query_param=data.get('encrypt_query_param'),
-        aes_key=data.get('aes_key'),
-        encrypt_type=data.get('encrypt_type'),
-    )
-
-
-def _parse_message_item(data: dict) -> MessageItem:
-    item = MessageItem(
-        type=data.get('type'),
-        create_time_ms=data.get('create_time_ms'),
-        update_time_ms=data.get('update_time_ms'),
-        is_completed=data.get('is_completed'),
-        msg_id=data.get('msg_id'),
-    )
-
-    if data.get('text_item'):
-        item.text_item = TextItem(text=data['text_item'].get('text'))
-
-    if data.get('image_item'):
-        img = data['image_item']
-        item.image_item = ImageItem(
-            media=_parse_cdn_media(img.get('media')),
-            thumb_media=_parse_cdn_media(img.get('thumb_media')),
-            aeskey=img.get('aeskey'),
-            url=img.get('url'),
-            mid_size=img.get('mid_size'),
-        )
-
-    if data.get('voice_item'):
-        v = data['voice_item']
-        item.voice_item = VoiceItem(
-            media=_parse_cdn_media(v.get('media')),
-            encode_type=v.get('encode_type'),
-            playtime=v.get('playtime'),
-            text=v.get('text'),
-        )
-
-    if data.get('file_item'):
-        f = data['file_item']
-        item.file_item = FileItem(
-            media=_parse_cdn_media(f.get('media')),
-            file_name=f.get('file_name'),
-            md5=f.get('md5'),
-            len=f.get('len'),
-        )
-
-    if data.get('video_item'):
-        vid = data['video_item']
-        item.video_item = VideoItem(
-            media=_parse_cdn_media(vid.get('media')),
-            video_size=vid.get('video_size'),
-            play_length=vid.get('play_length'),
-            video_md5=vid.get('video_md5'),
-            thumb_media=_parse_cdn_media(vid.get('thumb_media')),
-        )
-
-    if data.get('ref_msg'):
-        ref = data['ref_msg']
-        item.ref_msg = RefMessage(
-            title=ref.get('title'),
-            message_item=_parse_message_item(ref['message_item']) if ref.get('message_item') else None,
-        )
-
-    return item
-
-
-def _parse_weixin_message(data: dict) -> WeixinMessage:
-    msg = WeixinMessage(
-        seq=data.get('seq'),
-        message_id=data.get('message_id'),
-        from_user_id=data.get('from_user_id'),
-        to_user_id=data.get('to_user_id'),
-        client_id=data.get('client_id'),
-        create_time_ms=data.get('create_time_ms'),
-        session_id=data.get('session_id'),
-        group_id=data.get('group_id'),
-        message_type=data.get('message_type'),
-        message_state=data.get('message_state'),
-        context_token=data.get('context_token'),
-    )
-    if data.get('item_list'):
-        msg.item_list = [_parse_message_item(item) for item in data['item_list']]
-    return msg
-
-
-def _parse_get_updates_response(data: dict) -> GetUpdatesResponse:
-    resp = GetUpdatesResponse(
-        ret=data.get('ret'),
-        errcode=data.get('errcode'),
-        errmsg=data.get('errmsg'),
-        get_updates_buf=data.get('get_updates_buf'),
-        longpolling_timeout_ms=data.get('longpolling_timeout_ms'),
-    )
-    if data.get('msgs'):
-        resp.msgs = [_parse_weixin_message(m) for m in data['msgs']]
-    return resp
-
-
-def _cdn_media_to_dict(media: Optional[CDNMedia]) -> Optional[dict]:
-    if not media:
-        return None
-    d: dict = {}
-    if media.encrypt_query_param is not None:
-        d['encrypt_query_param'] = media.encrypt_query_param
-    if media.aes_key is not None:
-        d['aes_key'] = media.aes_key
-    if media.encrypt_type is not None:
-        d['encrypt_type'] = media.encrypt_type
-    return d or None
-
-
-def _message_item_to_dict(item: MessageItem) -> dict:
-    d: dict = {'type': item.type}
-
-    if item.text_item:
-        d['text_item'] = {'text': item.text_item.text}
-
-    if item.image_item:
-        img_d: dict = {}
-        if item.image_item.media:
-            img_d['media'] = _cdn_media_to_dict(item.image_item.media)
-        if item.image_item.mid_size is not None:
-            img_d['mid_size'] = item.image_item.mid_size
-        d['image_item'] = img_d
-
-    if item.voice_item:
-        voice_d: dict = {}
-        if item.voice_item.media:
-            voice_d['media'] = _cdn_media_to_dict(item.voice_item.media)
-        if item.voice_item.playtime is not None:
-            voice_d['playtime'] = item.voice_item.playtime
-        d['voice_item'] = voice_d
-
-    if item.file_item:
-        file_d: dict = {}
-        if item.file_item.media:
-            file_d['media'] = _cdn_media_to_dict(item.file_item.media)
-        if item.file_item.file_name:
-            file_d['file_name'] = item.file_item.file_name
-        if item.file_item.len:
-            file_d['len'] = item.file_item.len
-        d['file_item'] = file_d
-
-    if item.video_item:
-        vid_d: dict = {}
-        if item.video_item.media:
-            vid_d['media'] = _cdn_media_to_dict(item.video_item.media)
-        if item.video_item.video_size is not None:
-            vid_d['video_size'] = item.video_item.video_size
-        d['video_item'] = vid_d
-
-    return d

src/langbot/libs/openclaw_weixin_api/types.py

@@ -1,200 +0,0 @@
-"""Type definitions for the OpenClaw WeChat API, mirroring the upstream protocol."""
-
-from __future__ import annotations
-
-from dataclasses import dataclass, field
-from typing import Any, Optional
-
-SESSION_EXPIRED_ERRCODE = -14
-
-
-class ApiError(Exception):
-    """Structured error raised by the OpenClaw WeChat API."""
-
-    def __init__(
-        self,
-        message: str,
-        *,
-        status: int = 0,
-        code: int | None = None,
-        payload: Any = None,
-    ):
-        super().__init__(message)
-        self.status = status
-        self.code = code
-        self.payload = payload
-
-    @property
-    def is_session_expired(self) -> bool:
-        return self.code == SESSION_EXPIRED_ERRCODE
-
-
-@dataclass
-class CDNMedia:
-    encrypt_query_param: Optional[str] = None
-    aes_key: Optional[str] = None
-    encrypt_type: Optional[int] = None
-
-
-@dataclass
-class TextItem:
-    text: Optional[str] = None
-
-
-@dataclass
-class ImageItem:
-    media: Optional[CDNMedia] = None
-    thumb_media: Optional[CDNMedia] = None
-    aeskey: Optional[str] = None
-    url: Optional[str] = None
-    mid_size: Optional[int] = None
-    thumb_size: Optional[int] = None
-    thumb_height: Optional[int] = None
-    thumb_width: Optional[int] = None
-    hd_size: Optional[int] = None
-    _downloaded_bytes: Optional[bytes] = field(default=None, repr=False)
-
-
-@dataclass
-class VoiceItem:
-    media: Optional[CDNMedia] = None
-    encode_type: Optional[int] = None
-    bits_per_sample: Optional[int] = None
-    sample_rate: Optional[int] = None
-    playtime: Optional[int] = None
-    text: Optional[str] = None
-    _downloaded_bytes: Optional[bytes] = field(default=None, repr=False)
-
-
-@dataclass
-class FileItem:
-    media: Optional[CDNMedia] = None
-    file_name: Optional[str] = None
-    md5: Optional[str] = None
-    len: Optional[str] = None
-    _downloaded_bytes: Optional[bytes] = field(default=None, repr=False)
-
-
-@dataclass
-class VideoItem:
-    media: Optional[CDNMedia] = None
-    video_size: Optional[int] = None
-    play_length: Optional[int] = None
-    video_md5: Optional[str] = None
-    thumb_media: Optional[CDNMedia] = None
-    thumb_size: Optional[int] = None
-    thumb_height: Optional[int] = None
-    thumb_width: Optional[int] = None
-    _downloaded_bytes: Optional[bytes] = field(default=None, repr=False)
-
-
-@dataclass
-class RefMessage:
-    message_item: Optional[MessageItem] = None
-    title: Optional[str] = None
-
-
-@dataclass
-class MessageItem:
-    """A single content item inside a WeixinMessage."""
-
-    # Item types
-    NONE = 0
-    TEXT = 1
-    IMAGE = 2
-    VOICE = 3
-    FILE = 4
-    VIDEO = 5
-
-    type: Optional[int] = None
-    create_time_ms: Optional[int] = None
-    update_time_ms: Optional[int] = None
-    is_completed: Optional[bool] = None
-    msg_id: Optional[str] = None
-    ref_msg: Optional[RefMessage] = None
-    text_item: Optional[TextItem] = None
-    image_item: Optional[ImageItem] = None
-    voice_item: Optional[VoiceItem] = None
-    file_item: Optional[FileItem] = None
-    video_item: Optional[VideoItem] = None
-
-
-@dataclass
-class WeixinMessage:
-    """Unified message from getUpdates or for sendMessage."""
-
-    # Message types
-    TYPE_USER = 1
-    TYPE_BOT = 2
-
-    # Message states
-    STATE_NEW = 0
-    STATE_GENERATING = 1
-    STATE_FINISH = 2
-
-    seq: Optional[int] = None
-    message_id: Optional[int] = None
-    from_user_id: Optional[str] = None
-    to_user_id: Optional[str] = None
-    client_id: Optional[str] = None
-    create_time_ms: Optional[int] = None
-    update_time_ms: Optional[int] = None
-    delete_time_ms: Optional[int] = None
-    session_id: Optional[str] = None
-    group_id: Optional[str] = None
-    message_type: Optional[int] = None
-    message_state: Optional[int] = None
-    item_list: Optional[list[MessageItem]] = None
-    context_token: Optional[str] = None
-
-
-@dataclass
-class GetUpdatesResponse:
-    ret: Optional[int] = None
-    errcode: Optional[int] = None
-    errmsg: Optional[str] = None
-    msgs: list[WeixinMessage] = field(default_factory=list)
-    get_updates_buf: Optional[str] = None
-    longpolling_timeout_ms: Optional[int] = None
-
-
-@dataclass
-class GetConfigResponse:
-    ret: Optional[int] = None
-    errmsg: Optional[str] = None
-    typing_ticket: Optional[str] = None
-
-
-@dataclass
-class GetUploadUrlResponse:
-    upload_param: Optional[str] = None
-    thumb_upload_param: Optional[str] = None
-
-
-@dataclass
-class QRCodeResponse:
-    """Response from get_bot_qrcode endpoint."""
-
-    qrcode: Optional[str] = None
-    qrcode_img_content: Optional[str] = None
-
-
-@dataclass
-class QRStatusResponse:
-    """Response from get_qrcode_status endpoint."""
-
-    status: Optional[str] = None  # "wait" | "scaned" | "confirmed" | "expired"
-    bot_token: Optional[str] = None
-    ilink_bot_id: Optional[str] = None
-    baseurl: Optional[str] = None
-    ilink_user_id: Optional[str] = None
-
-
-@dataclass
-class LoginResult:
-    """Result returned by the login flow."""
-
-    token: str
-    base_url: str
-    account_id: str
-    qr_image_base64: Optional[str] = None  # data URI of the last QR code shown

src/langbot/libs/wecom_ai_bot_api/api.py

@@ -6,8 +6,7 @@ import traceback
 import uuid
 import xml.etree.ElementTree as ET
 from dataclasses import dataclass, field
-import re
-from typing import Any, Callable, Optional, Tuple
+from typing import Any, Callable, Optional
 from urllib.parse import unquote
 
 import httpx
@@ -200,366 +199,6 @@ class StreamSessionManager:
                 self._msg_index.pop(msg_id, None)
 
 
-def _decrypt_file(encrypted_data: bytes, aes_key_str: str) -> bytes:
-    """Decrypt AES-256-CBC encrypted file data.
-
-    Aligned with the official WeCom AI Bot Python SDK (crypto_utils.py).
-
-    Args:
-        encrypted_data: The raw encrypted bytes.
-        aes_key_str: Base64-encoded AES key (may lack padding).
-
-    Returns:
-        Decrypted bytes with PKCS#7 padding removed.
-    """
-    if not encrypted_data:
-        raise ValueError('encrypted_data is empty')
-    if not aes_key_str:
-        raise ValueError('aes_key is empty')
-
-    # Python's base64.b64decode requires proper padding (length % 4 == 0).
-    # Node.js Buffer.from tolerates missing '=', so we must pad manually.
-    remainder = len(aes_key_str) % 4
-    if remainder != 0:
-        aes_key_str = aes_key_str + '=' * (4 - remainder)
-    key = base64.b64decode(aes_key_str)
-
-    iv = key[:16]
-
-    cipher = AES.new(key, AES.MODE_CBC, iv)
-
-    # Ensure encrypted data is aligned to AES block size (16 bytes).
-    # Node.js setAutoPadding(false) silently handles unaligned data,
-    # but PyCryptodome will raise an error.
-    block_size = 16
-    data_remainder = len(encrypted_data) % block_size
-    if data_remainder != 0:
-        encrypted_data = encrypted_data + b'\x00' * (block_size - data_remainder)
-
-    decrypted = cipher.decrypt(encrypted_data)
-
-    # Remove PKCS#7 padding with validation
-    if len(decrypted) == 0:
-        raise ValueError('Decrypted data is empty')
-
-    pad_len = decrypted[-1]
-    if pad_len < 1 or pad_len > 32 or pad_len > len(decrypted):
-        raise ValueError(f'Invalid PKCS#7 padding value: {pad_len}')
-
-    # Verify all padding bytes are consistent
-    for i in range(len(decrypted) - pad_len, len(decrypted)):
-        if decrypted[i] != pad_len:
-            raise ValueError('Invalid PKCS#7 padding: padding bytes mismatch')
-
-    return decrypted[: len(decrypted) - pad_len]
-
-
-def _extract_filename(content_disposition: str) -> Optional[str]:
-    """Extract filename from a Content-Disposition header value."""
-    if not content_disposition:
-        return None
-    # RFC 5987: filename*=UTF-8''xxx
-    utf8_match = re.search(r"filename\*=UTF-8''([^;\s]+)", content_disposition, re.IGNORECASE)
-    if utf8_match:
-        return unquote(utf8_match.group(1))
-    # Standard: filename="xxx" or filename=xxx
-    match = re.search(r'filename="?([^";\s]+)"?', content_disposition, re.IGNORECASE)
-    if match:
-        return unquote(match.group(1))
-    return None
-
-
-def _bytes_to_data_uri(data: bytes) -> str:
-    """Convert raw bytes to a data URI with auto-detected MIME type."""
-    if data.startswith(b'\xff\xd8'):
-        mime_type = 'image/jpeg'
-    elif data.startswith(b'\x89PNG'):
-        mime_type = 'image/png'
-    elif data.startswith((b'GIF87a', b'GIF89a')):
-        mime_type = 'image/gif'
-    elif data.startswith(b'BM'):
-        mime_type = 'image/bmp'
-    elif data.startswith(b'II*\x00') or data.startswith(b'MM\x00*'):
-        mime_type = 'image/tiff'
-    elif data[:4] == b'%PDF':
-        mime_type = 'application/pdf'
-    elif data[:4] == b'PK\x03\x04':
-        mime_type = 'application/zip'
-    else:
-        mime_type = 'application/octet-stream'
-
-    base64_str = base64.b64encode(data).decode('utf-8')
-    return f'data:{mime_type};base64,{base64_str}'
-
-
-async def download_encrypted_file(
-    download_url: str, aes_key: str, logger: EventLogger
-) -> Tuple[Optional[bytes], Optional[str]]:
-    """Download an AES-encrypted file from WeChat Work and decrypt it.
-
-    Args:
-        download_url: The encrypted file download URL.
-        aes_key: The AES key for decryption (base64-encoded, per-message aeskey
-                 or platform EncodingAESKey).
-        logger: Logger instance.
-
-    Returns:
-        A tuple of (decrypted_bytes, filename) or (None, None) on failure.
-    """
-    if not download_url:
-        return None, None
-    if not aes_key:
-        await logger.error('download_encrypted_file: aes_key is empty, cannot decrypt')
-        return None, None
-
-    filename: Optional[str] = None
-    try:
-        async with httpx.AsyncClient(timeout=30.0) as client:
-            response = await client.get(download_url)
-            if response.status_code != 200:
-                await logger.error(f'Failed to download file (HTTP {response.status_code}): {response.text[:200]}')
-                return None, None
-            encrypted_bytes = response.content
-            filename = _extract_filename(response.headers.get('content-disposition', ''))
-    except Exception:
-        await logger.error(f'Failed to download file: {traceback.format_exc()}')
-        return None, None
-
-    try:
-        decrypted = _decrypt_file(encrypted_bytes, aes_key)
-        return decrypted, filename
-    except Exception:
-        await logger.error(f'Failed to decrypt file: {traceback.format_exc()}')
-        return None, None
-
-
-async def parse_wecom_bot_message(
-    msg_json: dict[str, Any], encoding_aes_key: str, logger: EventLogger
-) -> dict[str, Any]:
-    """Parse a decrypted WeChat Work AI Bot message JSON into a unified message dict.
-
-    This is the shared message parsing logic used by both webhook and WebSocket modes.
-
-    Args:
-        msg_json: The decrypted message JSON from WeChat Work.
-        encoding_aes_key: AES key for file decryption.
-        logger: Logger instance.
-
-    Returns:
-        A dict suitable for constructing a WecomBotEvent.
-    """
-    message_data: dict[str, Any] = {}
-
-    msg_type = msg_json.get('msgtype', '')
-    if msg_type:
-        message_data['msgtype'] = msg_type
-
-    if msg_json.get('chattype', '') == 'single':
-        message_data['type'] = 'single'
-    elif msg_json.get('chattype', '') == 'group':
-        message_data['type'] = 'group'
-
-    max_inline_file_size = 5 * 1024 * 1024
-
-    async def _safe_download(url: str, per_msg_aeskey: str = '') -> Tuple[Optional[bytes], Optional[str]]:
-        """Download and decrypt a file, preferring per-message aeskey over platform key."""
-        if not url:
-            return None, None
-        key = per_msg_aeskey or encoding_aes_key
-        if not key:
-            await logger.warning('No AES key available for file decryption, skipping download')
-            return None, None
-        return await download_encrypted_file(url, key, logger)
-
-    async def _safe_download_as_data_uri(url: str, per_msg_aeskey: str = '') -> Optional[str]:
-        """Download, decrypt, and convert to data URI for backward compatibility."""
-        data, _filename = await _safe_download(url, per_msg_aeskey)
-        if data:
-            return _bytes_to_data_uri(data)
-        return None
-
-    if msg_type == 'text':
-        message_data['content'] = msg_json.get('text', {}).get('content')
-    elif msg_type == 'markdown':
-        message_data['content'] = msg_json.get('markdown', {}).get('content') or msg_json.get('text', {}).get(
-            'content', ''
-        )
-    elif msg_type == 'image':
-        image_info = msg_json.get('image', {})
-        picurl = image_info.get('url', '')
-        per_msg_aeskey = image_info.get('aeskey', '')
-        base64_data = await _safe_download_as_data_uri(picurl, per_msg_aeskey)
-        if base64_data:
-            message_data['picurl'] = base64_data
-            message_data['images'] = [base64_data]
-    elif msg_type == 'voice':
-        voice_info = msg_json.get('voice', {}) or {}
-        download_url = voice_info.get('url')
-        per_msg_aeskey = voice_info.get('aeskey', '')
-        message_data['voice'] = {
-            'url': download_url,
-            'md5sum': voice_info.get('md5sum') or voice_info.get('md5'),
-            'filesize': voice_info.get('filesize') or voice_info.get('size'),
-            'sdkfileid': voice_info.get('sdkfileid') or voice_info.get('fileid'),
-        }
-        if voice_info.get('content'):
-            message_data['content'] = voice_info.get('content')
-        if (message_data['voice'].get('filesize') or 0) <= max_inline_file_size:
-            voice_base64 = await _safe_download_as_data_uri(download_url, per_msg_aeskey)
-            if voice_base64:
-                message_data['voice']['base64'] = voice_base64
-    elif msg_type == 'video':
-        video_info = msg_json.get('video', {}) or {}
-        download_url = video_info.get('url')
-        per_msg_aeskey = video_info.get('aeskey', '')
-        video_data = {
-            'url': download_url,
-            'filesize': video_info.get('filesize') or video_info.get('size'),
-            'sdkfileid': video_info.get('sdkfileid') or video_info.get('fileid'),
-            'md5sum': video_info.get('md5sum') or video_info.get('md5'),
-            'filename': video_info.get('filename') or video_info.get('name'),
-        }
-        if (video_data.get('filesize') or 0) <= max_inline_file_size:
-            video_base64 = await _safe_download_as_data_uri(download_url, per_msg_aeskey)
-            if video_base64:
-                video_data['base64'] = video_base64
-        message_data['video'] = video_data
-    elif msg_type == 'file':
-        file_info = msg_json.get('file', {}) or {}
-        download_url = file_info.get('url') or file_info.get('fileurl')
-        per_msg_aeskey = file_info.get('aeskey', '')
-        file_data = {
-            'filename': file_info.get('filename') or file_info.get('name'),
-            'filesize': file_info.get('filesize') or file_info.get('size'),
-            'md5sum': file_info.get('md5sum') or file_info.get('md5'),
-            'sdkfileid': file_info.get('sdkfileid') or file_info.get('fileid'),
-            'download_url': download_url,
-            'extra': file_info,
-        }
-        if (file_data.get('filesize') or 0) <= max_inline_file_size:
-            file_bytes, dl_filename = await _safe_download(download_url, per_msg_aeskey)
-            if file_bytes:
-                file_data['base64'] = _bytes_to_data_uri(file_bytes)
-                if dl_filename and not file_data.get('filename'):
-                    file_data['filename'] = dl_filename
-        message_data['file'] = file_data
-    elif msg_type == 'link':
-        message_data['link'] = msg_json.get('link', {})
-        if not message_data.get('content'):
-            title = message_data['link'].get('title', '')
-            desc = message_data['link'].get('description') or message_data['link'].get('digest', '')
-            message_data['content'] = '\n'.join(filter(None, [title, desc]))
-    elif msg_type == 'mixed':
-        items = msg_json.get('mixed', {}).get('msg_item', [])
-        texts = []
-        images = []
-        files = []
-        voices = []
-        videos = []
-        links = []
-        for item in items:
-            item_type = item.get('msgtype')
-            if item_type == 'text':
-                texts.append(item.get('text', {}).get('content', ''))
-            elif item_type == 'image':
-                img_info = item.get('image', {})
-                img_url = img_info.get('url')
-                img_aeskey = img_info.get('aeskey', '')
-                base64_data = await _safe_download_as_data_uri(img_url, img_aeskey)
-                if base64_data:
-                    images.append(base64_data)
-            elif item_type == 'file':
-                file_info = item.get('file', {}) or {}
-                download_url = file_info.get('url') or file_info.get('fileurl')
-                item_aeskey = file_info.get('aeskey', '')
-                file_data = {
-                    'filename': file_info.get('filename') or file_info.get('name'),
-                    'filesize': file_info.get('filesize') or file_info.get('size'),
-                    'md5sum': file_info.get('md5sum') or file_info.get('md5'),
-                    'sdkfileid': file_info.get('sdkfileid') or file_info.get('fileid'),
-                    'download_url': download_url,
-                    'extra': file_info,
-                }
-                if (file_data.get('filesize') or 0) <= max_inline_file_size:
-                    file_bytes, dl_filename = await _safe_download(download_url, item_aeskey)
-                    if file_bytes:
-                        file_data['base64'] = _bytes_to_data_uri(file_bytes)
-                        if dl_filename and not file_data.get('filename'):
-                            file_data['filename'] = dl_filename
-                files.append(file_data)
-            elif item_type == 'voice':
-                voice_info = item.get('voice', {}) or {}
-                download_url = voice_info.get('url')
-                item_aeskey = voice_info.get('aeskey', '')
-                voice_data = {
-                    'url': download_url,
-                    'md5sum': voice_info.get('md5sum') or voice_info.get('md5'),
-                    'filesize': voice_info.get('filesize') or voice_info.get('size'),
-                    'sdkfileid': voice_info.get('sdkfileid') or voice_info.get('fileid'),
-                }
-                if voice_info.get('content'):
-                    texts.append(voice_info.get('content'))
-                if (voice_data.get('filesize') or 0) <= max_inline_file_size:
-                    voice_base64 = await _safe_download_as_data_uri(download_url, item_aeskey)
-                    if voice_base64:
-                        voice_data['base64'] = voice_base64
-                voices.append(voice_data)
-            elif item_type == 'video':
-                video_info = item.get('video', {}) or {}
-                download_url = video_info.get('url')
-                item_aeskey = video_info.get('aeskey', '')
-                video_data = {
-                    'url': download_url,
-                    'filesize': video_info.get('filesize') or video_info.get('size'),
-                    'sdkfileid': video_info.get('sdkfileid') or video_info.get('fileid'),
-                    'md5sum': video_info.get('md5sum') or video_info.get('md5'),
-                    'filename': video_info.get('filename') or video_info.get('name'),
-                }
-                if (video_data.get('filesize') or 0) <= max_inline_file_size:
-                    video_base64 = await _safe_download_as_data_uri(download_url, item_aeskey)
-                    if video_base64:
-                        video_data['base64'] = video_base64
-                videos.append(video_data)
-            elif item_type == 'link':
-                links.append(item.get('link', {}))
-
-        if texts:
-            message_data['content'] = ' '.join(texts)
-        if images:
-            message_data['images'] = images
-            message_data['picurl'] = images[0]
-        if files:
-            message_data['files'] = files
-            message_data['file'] = files[0]
-        if voices:
-            message_data['voices'] = voices
-            message_data['voice'] = voices[0]
-        if videos:
-            message_data['videos'] = videos
-            message_data['video'] = videos[0]
-        if links:
-            message_data['link'] = links[0]
-        if items:
-            message_data['attachments'] = items
-    else:
-        message_data['raw_msg'] = msg_json
-
-    from_info = msg_json.get('from', {})
-    message_data['userid'] = from_info.get('userid', '')
-    message_data['username'] = from_info.get('alias', '') or from_info.get('name', '') or from_info.get('userid', '')
-
-    if msg_json.get('chattype', '') == 'group':
-        message_data['chatid'] = msg_json.get('chatid', '')
-        message_data['chatname'] = msg_json.get('chatname', '') or msg_json.get('chatid', '')
-
-    message_data['msgid'] = msg_json.get('msgid', '')
-
-    if msg_json.get('aibotid'):
-        message_data['aibotid'] = msg_json.get('aibotid', '')
-
-    return message_data
-
-
 class WecomBotClient:
     def __init__(self, Token: str, EnCodingAESKey: str, Corpid: str, logger: EventLogger, unified_mode: bool = False):
         """企业微信智能机器人客户端。
@@ -816,7 +455,196 @@ class WecomBotClient:
         return await self._handle_post_initial_response(msg_json, nonce)
 
     async def get_message(self, msg_json):
-        return await parse_wecom_bot_message(msg_json, self.EnCodingAESKey, self.logger)
+        message_data = {}
+
+        msg_type = msg_json.get('msgtype', '')
+        if msg_type:
+            message_data['msgtype'] = msg_type
+
+        if msg_json.get('chattype', '') == 'single':
+            message_data['type'] = 'single'
+        elif msg_json.get('chattype', '') == 'group':
+            message_data['type'] = 'group'
+
+        max_inline_file_size = 5 * 1024 * 1024  # avoid decoding very large payloads by default
+
+        async def _safe_download(url: str):
+            if not url:
+                return None
+            return await self.download_url_to_base64(url, self.EnCodingAESKey)
+
+        if msg_type == 'text':
+            message_data['content'] = msg_json.get('text', {}).get('content')
+        elif msg_type == 'markdown':
+            message_data['content'] = msg_json.get('markdown', {}).get('content') or msg_json.get('text', {}).get(
+                'content', ''
+            )
+        elif msg_type == 'image':
+            picurl = msg_json.get('image', {}).get('url', '')
+            base64_data = await _safe_download(picurl)
+            if base64_data:
+                message_data['picurl'] = base64_data
+                message_data['images'] = [base64_data]
+        elif msg_type == 'voice':
+            voice_info = msg_json.get('voice', {}) or {}
+            download_url = voice_info.get('url')
+            message_data['voice'] = {
+                'url': download_url,
+                'md5sum': voice_info.get('md5sum') or voice_info.get('md5'),
+                'filesize': voice_info.get('filesize') or voice_info.get('size'),
+                'sdkfileid': voice_info.get('sdkfileid') or voice_info.get('fileid'),
+            }
+            # 企业微信智能转写文本（如果已有）直接复用，避免重复转写
+            if voice_info.get('content'):
+                message_data['content'] = voice_info.get('content')
+            if (message_data['voice'].get('filesize') or 0) <= max_inline_file_size:
+                voice_base64 = await _safe_download(download_url)
+                if voice_base64:
+                    message_data['voice']['base64'] = voice_base64
+        elif msg_type == 'video':
+            video_info = msg_json.get('video', {}) or {}
+            download_url = video_info.get('url')
+            video_data = {
+                'url': download_url,
+                'filesize': video_info.get('filesize') or video_info.get('size'),
+                'sdkfileid': video_info.get('sdkfileid') or video_info.get('fileid'),
+                'md5sum': video_info.get('md5sum') or video_info.get('md5'),
+                'filename': video_info.get('filename') or video_info.get('name'),
+            }
+            if (video_data.get('filesize') or 0) <= max_inline_file_size:
+                video_base64 = await _safe_download(download_url)
+                if video_base64:
+                    video_data['base64'] = video_base64
+            message_data['video'] = video_data
+        elif msg_type == 'file':
+            file_info = msg_json.get('file', {}) or {}
+            download_url = file_info.get('url') or file_info.get('fileurl')
+            file_data = {
+                'filename': file_info.get('filename') or file_info.get('name'),
+                'filesize': file_info.get('filesize') or file_info.get('size'),
+                'md5sum': file_info.get('md5sum') or file_info.get('md5'),
+                'sdkfileid': file_info.get('sdkfileid') or file_info.get('fileid'),
+                'download_url': download_url,
+                'extra': file_info,
+            }
+            if (file_data.get('filesize') or 0) <= max_inline_file_size:
+                file_base64 = await _safe_download(download_url)
+                if file_base64:
+                    file_data['base64'] = file_base64
+            message_data['file'] = file_data
+        elif msg_type == 'link':
+            message_data['link'] = msg_json.get('link', {})
+            if not message_data.get('content'):
+                title = message_data['link'].get('title', '')
+                desc = message_data['link'].get('description') or message_data['link'].get('digest', '')
+                message_data['content'] = '\n'.join(filter(None, [title, desc]))
+        elif msg_type == 'mixed':
+            items = msg_json.get('mixed', {}).get('msg_item', [])
+            texts = []
+            images = []
+            files = []
+            voices = []
+            videos = []
+            links = []
+            for item in items:
+                item_type = item.get('msgtype')
+                if item_type == 'text':
+                    texts.append(item.get('text', {}).get('content', ''))
+                elif item_type == 'image':
+                    img_url = item.get('image', {}).get('url')
+                    base64_data = await _safe_download(img_url)
+                    if base64_data:
+                        images.append(base64_data)
+                elif item_type == 'file':
+                    file_info = item.get('file', {}) or {}
+                    download_url = file_info.get('url') or file_info.get('fileurl')
+                    file_data = {
+                        'filename': file_info.get('filename') or file_info.get('name'),
+                        'filesize': file_info.get('filesize') or file_info.get('size'),
+                        'md5sum': file_info.get('md5sum') or file_info.get('md5'),
+                        'sdkfileid': file_info.get('sdkfileid') or file_info.get('fileid'),
+                        'download_url': download_url,
+                        'extra': file_info,
+                    }
+                    if (file_data.get('filesize') or 0) <= max_inline_file_size:
+                        file_base64 = await _safe_download(download_url)
+                        if file_base64:
+                            file_data['base64'] = file_base64
+                    files.append(file_data)
+                elif item_type == 'voice':
+                    voice_info = item.get('voice', {}) or {}
+                    download_url = voice_info.get('url')
+                    voice_data = {
+                        'url': download_url,
+                        'md5sum': voice_info.get('md5sum') or voice_info.get('md5'),
+                        'filesize': voice_info.get('filesize') or voice_info.get('size'),
+                        'sdkfileid': voice_info.get('sdkfileid') or voice_info.get('fileid'),
+                    }
+                    if voice_info.get('content'):
+                        texts.append(voice_info.get('content'))
+                    if (voice_data.get('filesize') or 0) <= max_inline_file_size:
+                        voice_base64 = await _safe_download(download_url)
+                        if voice_base64:
+                            voice_data['base64'] = voice_base64
+                    voices.append(voice_data)
+                elif item_type == 'video':
+                    video_info = item.get('video', {}) or {}
+                    download_url = video_info.get('url')
+                    video_data = {
+                        'url': download_url,
+                        'filesize': video_info.get('filesize') or video_info.get('size'),
+                        'sdkfileid': video_info.get('sdkfileid') or video_info.get('fileid'),
+                        'md5sum': video_info.get('md5sum') or video_info.get('md5'),
+                        'filename': video_info.get('filename') or video_info.get('name'),
+                    }
+                    if (video_data.get('filesize') or 0) <= max_inline_file_size:
+                        video_base64 = await _safe_download(download_url)
+                        if video_base64:
+                            video_data['base64'] = video_base64
+                    videos.append(video_data)
+                elif item_type == 'link':
+                    links.append(item.get('link', {}))
+
+            if texts:
+                message_data['content'] = ' '.join(texts)  # 拼接所有 text
+            if images:
+                message_data['images'] = images
+                message_data['picurl'] = images[0]  # 只保留第一个 image
+            if files:
+                message_data['files'] = files
+                message_data['file'] = files[0]
+            if voices:
+                message_data['voices'] = voices
+                message_data['voice'] = voices[0]
+            if videos:
+                message_data['videos'] = videos
+                message_data['video'] = videos[0]
+            if links:
+                message_data['link'] = links[0]
+            if items:
+                message_data['attachments'] = items
+        else:
+            message_data['raw_msg'] = msg_json
+
+        # Extract user information
+        from_info = msg_json.get('from', {})
+        message_data['userid'] = from_info.get('userid', '')
+        message_data['username'] = (
+            from_info.get('alias', '') or from_info.get('name', '') or from_info.get('userid', '')
+        )
+
+        # Extract chat/group information
+        if msg_json.get('chattype', '') == 'group':
+            message_data['chatid'] = msg_json.get('chatid', '')
+            # Try to get group name if available
+            message_data['chatname'] = msg_json.get('chatname', '') or msg_json.get('chatid', '')
+
+        message_data['msgid'] = msg_json.get('msgid', '')
+
+        if msg_json.get('aibotid'):
+            message_data['aibotid'] = msg_json.get('aibotid', '')
+
+        return message_data
 
     async def _handle_message(self, event: wecombotevent.WecomBotEvent):
         """
@@ -884,10 +712,39 @@ class WecomBotClient:
         return decorator
 
     async def download_url_to_base64(self, download_url, encoding_aes_key):
-        data, _filename = await download_encrypted_file(download_url, encoding_aes_key, self.logger)
-        if data:
-            return _bytes_to_data_uri(data)
-        return None
+        async with httpx.AsyncClient() as client:
+            response = await client.get(download_url)
+            if response.status_code != 200:
+                await self.logger.error(f'failed to get file: {response.text}')
+                return None
+
+            encrypted_bytes = response.content
+
+        aes_key = base64.b64decode(encoding_aes_key + '=')  # base64 补齐
+        iv = aes_key[:16]
+
+        cipher = AES.new(aes_key, AES.MODE_CBC, iv)
+        decrypted = cipher.decrypt(encrypted_bytes)
+
+        pad_len = decrypted[-1]
+        decrypted = decrypted[:-pad_len]
+
+        if decrypted.startswith(b'\xff\xd8'):  # JPEG
+            mime_type = 'image/jpeg'
+        elif decrypted.startswith(b'\x89PNG'):  # PNG
+            mime_type = 'image/png'
+        elif decrypted.startswith((b'GIF87a', b'GIF89a')):  # GIF
+            mime_type = 'image/gif'
+        elif decrypted.startswith(b'BM'):  # BMP
+            mime_type = 'image/bmp'
+        elif decrypted.startswith(b'II*\x00') or decrypted.startswith(b'MM\x00*'):  # TIFF
+            mime_type = 'image/tiff'
+        else:
+            mime_type = 'application/octet-stream'
+
+        # 转 base64
+        base64_str = base64.b64encode(decrypted).decode('utf-8')
+        return f'data:{mime_type};base64,{base64_str}'
 
     async def run_task(self, host: str, port: int, *args, **kwargs):
         """

src/langbot/libs/wecom_ai_bot_api/ws_client.py

@@ -1,596 +0,0 @@
-"""WeChat Work AI Bot WebSocket long connection client.
-
-Implements the WebSocket protocol for receiving messages and sending replies
-via a persistent connection to wss://openws.work.weixin.qq.com, as an
-alternative to the HTTP callback (webhook) mode.
-
-Protocol reference: https://developer.work.weixin.qq.com/document/path/101463
-Official Node.js SDK: https://github.com/WecomTeam/aibot-node-sdk
-"""
-
-from __future__ import annotations
-
-import asyncio
-import json
-import secrets
-import time
-import traceback
-from typing import Any, Callable, Optional
-
-import aiohttp
-
-from langbot.libs.wecom_ai_bot_api import wecombotevent
-from langbot.libs.wecom_ai_bot_api.api import parse_wecom_bot_message
-from langbot.pkg.platform.logger import EventLogger
-
-DEFAULT_WS_URL = 'wss://openws.work.weixin.qq.com'
-
-# WebSocket frame command constants
-CMD_SUBSCRIBE = 'aibot_subscribe'
-CMD_HEARTBEAT = 'ping'
-CMD_MSG_CALLBACK = 'aibot_msg_callback'
-CMD_EVENT_CALLBACK = 'aibot_event_callback'
-CMD_RESPOND_MSG = 'aibot_respond_msg'
-CMD_RESPOND_WELCOME = 'aibot_respond_welcome_msg'
-CMD_RESPOND_UPDATE = 'aibot_respond_update_msg'
-CMD_SEND_MSG = 'aibot_send_msg'
-
-
-def _generate_req_id(prefix: str) -> str:
-    """Generate a unique request ID in the format: {prefix}_{timestamp}_{random}."""
-    ts = int(time.time() * 1000)
-    rand = secrets.token_hex(4)
-    return f'{prefix}_{ts}_{rand}'
-
-
-class WecomBotWsClient:
-    """WeChat Work AI Bot WebSocket long connection client.
-
-    Provides message receiving, streaming reply, proactive message sending,
-    and event callback handling over a persistent WebSocket connection.
-    """
-
-    def __init__(
-        self,
-        bot_id: str,
-        secret: str,
-        logger: EventLogger,
-        encoding_aes_key: str = '',
-        ws_url: str = DEFAULT_WS_URL,
-        heartbeat_interval: float = 30.0,
-        max_reconnect_attempts: int = -1,
-        reconnect_base_delay: float = 1.0,
-        reconnect_max_delay: float = 30.0,
-    ):
-        self.bot_id = bot_id
-        self.secret = secret
-        self.logger = logger
-        self.encoding_aes_key = encoding_aes_key
-        self.ws_url = ws_url
-        self.heartbeat_interval = heartbeat_interval
-        self.max_reconnect_attempts = max_reconnect_attempts
-        self.reconnect_base_delay = reconnect_base_delay
-        self.reconnect_max_delay = reconnect_max_delay
-
-        self._ws: Optional[aiohttp.ClientWebSocketResponse] = None
-        self._session: Optional[aiohttp.ClientSession] = None
-        self._running = False
-        self._heartbeat_task: Optional[asyncio.Task] = None
-        self._missed_pong_count = 0
-        self._max_missed_pong = 2
-        self._reconnect_attempts = 0
-
-        # Message handler registry (same pattern as WecomBotClient)
-        self._message_handlers: dict[str, list[Callable]] = {}
-        # Message deduplication
-        self._msg_id_map: dict[str, int] = {}
-
-        # Pending ACK futures: req_id -> Future[dict]
-        self._pending_acks: dict[str, asyncio.Future] = {}
-        # Per-req_id serial reply queues
-        self._reply_queues: dict[str, asyncio.Queue] = {}
-        self._reply_workers: dict[str, asyncio.Task] = {}
-        self._reply_ack_timeout = 5.0
-
-        # Stream ID tracking for WebSocket mode
-        self._stream_ids: dict[str, str] = {}  # msg_id -> req_id|stream_id
-        # Dedup: skip sending when content hasn't changed
-        self._stream_last_content: dict[str, str] = {}  # msg_id -> last content sent
-
-    # ── Public API ──────────────────────────────────────────────────
-
-    async def connect(self):
-        """Connect to WebSocket server with automatic reconnection.
-
-        This method blocks until disconnect() is called or max reconnect
-        attempts are exhausted.
-        """
-        self._running = True
-        self._reconnect_attempts = 0
-
-        while self._running:
-            try:
-                await self._connect_once()
-            except Exception:
-                if not self._running:
-                    break
-                await self.logger.error(f'WebSocket connection error: {traceback.format_exc()}')
-
-            if not self._running:
-                break
-
-            # Reconnect with exponential backoff
-            if self.max_reconnect_attempts != -1 and self._reconnect_attempts >= self.max_reconnect_attempts:
-                await self.logger.error(f'Max reconnect attempts reached ({self.max_reconnect_attempts}), giving up')
-                break
-
-            self._reconnect_attempts += 1
-            delay = min(
-                self.reconnect_base_delay * (2 ** (self._reconnect_attempts - 1)),
-                self.reconnect_max_delay,
-            )
-            await self.logger.info(f'Reconnecting in {delay:.1f}s (attempt {self._reconnect_attempts})...')
-            await asyncio.sleep(delay)
-
-    async def disconnect(self):
-        """Gracefully disconnect from the WebSocket server."""
-        self._running = False
-        if self._heartbeat_task and not self._heartbeat_task.done():
-            self._heartbeat_task.cancel()
-        for task in self._reply_workers.values():
-            if not task.done():
-                task.cancel()
-        if self._ws and not self._ws.closed:
-            await self._ws.close()
-        self._ws = None
-        if self._session and not self._session.closed:
-            await self._session.close()
-        self._session = None
-
-    def on_message(self, msg_type: str) -> Callable:
-        """Decorator to register a message handler.
-
-        Same interface as WecomBotClient.on_message for compatibility.
-
-        Args:
-            msg_type: 'single', 'group', or specific message type.
-        """
-
-        def decorator(func: Callable[[wecombotevent.WecomBotEvent], Any]):
-            if msg_type not in self._message_handlers:
-                self._message_handlers[msg_type] = []
-            self._message_handlers[msg_type].append(func)
-            return func
-
-        return decorator
-
-    async def reply_stream(
-        self,
-        req_id: str,
-        stream_id: str,
-        content: str,
-        finish: bool = False,
-    ) -> Optional[dict]:
-        """Send a streaming reply frame.
-
-        Args:
-            req_id: The req_id from the original message frame (must be passed through).
-            stream_id: The stream ID for this streaming session.
-            content: The content to send (supports Markdown).
-            finish: Whether this is the final chunk.
-
-        Returns:
-            The ACK frame dict, or None on failure.
-        """
-        body = {
-            'msgtype': 'stream',
-            'stream': {
-                'id': stream_id,
-                'finish': finish,
-                'content': content,
-            },
-        }
-        return await self._send_reply(req_id, body)
-
-    async def reply_text(self, req_id: str, content: str) -> Optional[dict]:
-        """Send a non-streaming text reply.
-
-        Args:
-            req_id: The req_id from the original message frame.
-            content: The text content to reply.
-
-        Returns:
-            The ACK frame dict, or None on failure.
-        """
-        body = {
-            'msgtype': 'markdown',
-            'markdown': {
-                'content': content,
-            },
-        }
-        return await self._send_reply(req_id, body)
-
-    async def send_message(self, chat_id: str, content: str, msgtype: str = 'markdown') -> Optional[dict]:
-        """Proactively send a message to a specified chat.
-
-        Args:
-            chat_id: The chat ID (userid for single chat, chatid for group chat).
-            content: The message content.
-            msgtype: Message type, 'markdown' by default.
-
-        Returns:
-            The ACK frame dict, or None on failure.
-        """
-        req_id = _generate_req_id(CMD_SEND_MSG)
-        body: dict[str, Any] = {
-            'chatid': chat_id,
-            'msgtype': msgtype,
-        }
-        if msgtype == 'markdown':
-            body['markdown'] = {'content': content}
-        elif msgtype == 'text':
-            body['text'] = {'content': content}
-        return await self._send_reply(req_id, body, cmd=CMD_SEND_MSG)
-
-    async def push_stream_chunk(self, msg_id: str, content: str, is_final: bool = False) -> bool:
-        """Push a streaming chunk for a given message ID.
-
-        Compatible interface with WecomBotClient.push_stream_chunk.
-
-        Args:
-            msg_id: The original message ID.
-            content: The cumulative content from the pipeline.
-            is_final: Whether this is the final chunk.
-
-        Returns:
-            True if the stream session exists and chunk was sent.
-        """
-        key = self._stream_ids.get(msg_id)
-        if not key:
-            return False
-        req_id, stream_id = key.split('|', 1)
-        try:
-            # Skip sending if content hasn't changed (e.g. during tool call argument streaming)
-            if not is_final and content == self._stream_last_content.get(msg_id):
-                return True
-            await self.reply_stream(req_id, stream_id, content, finish=is_final)
-            self._stream_last_content[msg_id] = content
-            if is_final:
-                self._stream_ids.pop(msg_id, None)
-                self._stream_last_content.pop(msg_id, None)
-            return True
-        except Exception:
-            await self.logger.error(f'Failed to push stream chunk: {traceback.format_exc()}')
-            return False
-
-    async def set_message(self, msg_id: str, content: str):
-        """Fallback: send content as a final stream chunk or direct reply.
-
-        Compatible interface with WecomBotClient.set_message.
-        """
-        handled = await self.push_stream_chunk(msg_id, content, is_final=True)
-        if not handled:
-            await self.logger.warning(f'No active stream for msg_id={msg_id}, message dropped')
-
-    # ── Connection lifecycle ────────────────────────────────────────
-
-    async def _connect_once(self):
-        """Establish a single WebSocket connection, authenticate, and listen."""
-        await self.logger.info(f'Connecting to {self.ws_url}...')
-
-        self._session = aiohttp.ClientSession()
-        try:
-            self._ws = await self._session.ws_connect(self.ws_url)
-            self._missed_pong_count = 0
-            self._reconnect_attempts = 0
-            await self.logger.info('WebSocket connected, sending auth...')
-
-            await self._send_auth()
-
-            # Wait for auth response
-            auth_ok = await self._wait_for_auth()
-            if not auth_ok:
-                await self.logger.error('Authentication failed')
-                return
-
-            await self.logger.info('Authenticated successfully')
-
-            # Start heartbeat
-            self._heartbeat_task = asyncio.create_task(self._heartbeat_loop())
-
-            try:
-                await self._listen_loop()
-            finally:
-                if self._heartbeat_task and not self._heartbeat_task.done():
-                    self._heartbeat_task.cancel()
-                self._clear_pending_acks('Connection closed')
-        finally:
-            if self._ws and not self._ws.closed:
-                await self._ws.close()
-            self._ws = None
-            if self._session and not self._session.closed:
-                await self._session.close()
-            self._session = None
-
-    async def _send_auth(self):
-        """Send the authentication frame."""
-        frame = {
-            'cmd': CMD_SUBSCRIBE,
-            'headers': {'req_id': _generate_req_id(CMD_SUBSCRIBE)},
-            'body': {
-                'bot_id': self.bot_id,
-                'secret': self.secret,
-            },
-        }
-        await self._send_frame(frame)
-
-    async def _wait_for_auth(self) -> bool:
-        """Wait for and validate the authentication response."""
-        try:
-            msg = await asyncio.wait_for(self._ws.receive(), timeout=10.0)
-            if msg.type in (aiohttp.WSMsgType.TEXT,):
-                frame = json.loads(msg.data)
-                req_id = frame.get('headers', {}).get('req_id', '')
-                if req_id.startswith(CMD_SUBSCRIBE) and frame.get('errcode') == 0:
-                    return True
-                await self.logger.error(f'Auth response: errcode={frame.get("errcode")}, errmsg={frame.get("errmsg")}')
-                return False
-            elif msg.type in (aiohttp.WSMsgType.ERROR, aiohttp.WSMsgType.CLOSED, aiohttp.WSMsgType.CLOSING):
-                await self.logger.error(f'WebSocket closed during auth: {msg.type}')
-                return False
-            await self.logger.error(f'Unexpected message type during auth: {msg.type}')
-            return False
-        except asyncio.TimeoutError:
-            await self.logger.error('Auth response timeout')
-            return False
-
-    async def _heartbeat_loop(self):
-        """Periodically send heartbeat pings."""
-        try:
-            while self._running and self._ws and not self._ws.closed:
-                await asyncio.sleep(self.heartbeat_interval)
-                if not self._running or not self._ws or self._ws.closed:
-                    break
-
-                if self._missed_pong_count >= self._max_missed_pong:
-                    await self.logger.warning(
-                        f'No heartbeat ack for {self._missed_pong_count} consecutive pings, connection considered dead'
-                    )
-                    await self._ws.close()
-                    break
-
-                self._missed_pong_count += 1
-                frame = {
-                    'cmd': CMD_HEARTBEAT,
-                    'headers': {'req_id': _generate_req_id(CMD_HEARTBEAT)},
-                }
-                try:
-                    await self._send_frame(frame)
-                except Exception:
-                    break
-        except asyncio.CancelledError:
-            pass
-
-    async def _listen_loop(self):
-        """Listen for incoming WebSocket frames and dispatch them."""
-        async for msg in self._ws:
-            if not self._running:
-                break
-            if msg.type == aiohttp.WSMsgType.TEXT:
-                try:
-                    frame = json.loads(msg.data)
-                    await self._handle_frame(frame)
-                except json.JSONDecodeError:
-                    await self.logger.error(f'Failed to parse WebSocket message: {str(msg.data)[:200]}')
-                except Exception:
-                    await self.logger.error(f'Error handling frame: {traceback.format_exc()}')
-            elif msg.type == aiohttp.WSMsgType.BINARY:
-                try:
-                    frame = json.loads(msg.data)
-                    await self._handle_frame(frame)
-                except Exception:
-                    await self.logger.error(f'Error handling binary frame: {traceback.format_exc()}')
-            elif msg.type in (aiohttp.WSMsgType.ERROR, aiohttp.WSMsgType.CLOSED, aiohttp.WSMsgType.CLOSING):
-                await self.logger.warning(f'WebSocket connection closed: {msg.type}')
-                break
-
-    # ── Frame handling ──────────────────────────────────────────────
-
-    async def _handle_frame(self, frame: dict):
-        """Route an incoming frame to the appropriate handler."""
-        cmd = frame.get('cmd', '')
-
-        # Message push
-        if cmd == CMD_MSG_CALLBACK:
-            asyncio.create_task(self._handle_message_callback(frame))
-            return
-
-        # Event push
-        if cmd == CMD_EVENT_CALLBACK:
-            asyncio.create_task(self._handle_event_callback(frame))
-            return
-
-        # No cmd → response/ACK frame, dispatch by req_id prefix
-        req_id = frame.get('headers', {}).get('req_id', '')
-
-        # Check pending ACKs first
-        if req_id in self._pending_acks:
-            future = self._pending_acks.pop(req_id)
-            if not future.done():
-                future.set_result(frame)
-            return
-
-        # Heartbeat response
-        if req_id.startswith(CMD_HEARTBEAT):
-            if frame.get('errcode') == 0:
-                self._missed_pong_count = 0
-            return
-
-        # Unknown frame
-        await self.logger.warning(f'Unknown frame: {json.dumps(frame, ensure_ascii=False)[:200]}')
-
-    async def _handle_message_callback(self, frame: dict):
-        """Handle an incoming message callback frame."""
-        try:
-            body = frame.get('body', {})
-            req_id = frame.get('headers', {}).get('req_id', '')
-
-            # Parse message using shared logic
-            message_data = await parse_wecom_bot_message(body, self.encoding_aes_key, self.logger)
-            if not message_data:
-                return
-
-            # Generate stream_id for this message and store the mapping
-            stream_id = _generate_req_id('stream')
-            msg_id = message_data.get('msgid', '')
-            if msg_id:
-                self._stream_ids[msg_id] = f'{req_id}|{stream_id}'
-            message_data['stream_id'] = stream_id
-            message_data['req_id'] = req_id
-
-            event = wecombotevent.WecomBotEvent(message_data)
-            await self._dispatch_event(event)
-        except Exception:
-            await self.logger.error(f'Error in message callback: {traceback.format_exc()}')
-
-    async def _handle_event_callback(self, frame: dict):
-        """Handle an incoming event callback frame (enter_chat, template_card_event, etc.)."""
-        try:
-            body = frame.get('body', {})
-            req_id = frame.get('headers', {}).get('req_id', '')
-
-            event_info = body.get('event', {})
-            event_type = event_info.get('eventtype', '')
-
-            message_data = {
-                'msgtype': 'event',
-                'type': body.get('chattype', 'single'),
-                'event': event_info,
-                'eventtype': event_type,
-                'msgid': body.get('msgid', ''),
-                'aibotid': body.get('aibotid', ''),
-                'req_id': req_id,
-            }
-
-            from_info = body.get('from', {})
-            message_data['userid'] = from_info.get('userid', '')
-            message_data['username'] = from_info.get('alias', '') or from_info.get('userid', '')
-
-            if body.get('chatid'):
-                message_data['chatid'] = body.get('chatid', '')
-
-            event = wecombotevent.WecomBotEvent(message_data)
-
-            # Dispatch to event-specific handlers
-            if event_type in self._message_handlers:
-                for handler in self._message_handlers[event_type]:
-                    await handler(event)
-
-            # Also dispatch to generic 'event' handlers
-            if 'event' in self._message_handlers:
-                for handler in self._message_handlers['event']:
-                    await handler(event)
-
-        except Exception:
-            await self.logger.error(f'Error in event callback: {traceback.format_exc()}')
-
-    async def _dispatch_event(self, event: wecombotevent.WecomBotEvent):
-        """Dispatch a message event to registered handlers with deduplication."""
-        try:
-            message_id = event.message_id
-            if message_id in self._msg_id_map:
-                self._msg_id_map[message_id] += 1
-                return
-            self._msg_id_map[message_id] = 1
-
-            msg_type = event.type
-            if msg_type in self._message_handlers:
-                for handler in self._message_handlers[msg_type]:
-                    await handler(event)
-        except Exception:
-            await self.logger.error(f'Error dispatching event: {traceback.format_exc()}')
-
-    # ── Reply sending with serial queue ─────────────────────────────
-
-    async def _send_reply(
-        self,
-        req_id: str,
-        body: dict,
-        cmd: str = CMD_RESPOND_MSG,
-    ) -> Optional[dict]:
-        """Send a reply frame and wait for ACK.
-
-        Replies with the same req_id are serialized to maintain ordering.
-        """
-        if not self._ws or self._ws.closed:
-            return None
-
-        frame = {
-            'cmd': cmd,
-            'headers': {'req_id': req_id},
-            'body': body,
-        }
-
-        # Ensure serial delivery per req_id
-        if req_id not in self._reply_queues:
-            self._reply_queues[req_id] = asyncio.Queue()
-            self._reply_workers[req_id] = asyncio.create_task(self._reply_queue_worker(req_id))
-
-        future: asyncio.Future = asyncio.get_event_loop().create_future()
-        await self._reply_queues[req_id].put((frame, future))
-        return await future
-
-    async def _reply_queue_worker(self, req_id: str):
-        """Process reply queue items serially for a given req_id."""
-        queue = self._reply_queues[req_id]
-        try:
-            while self._running:
-                try:
-                    frame, future = await asyncio.wait_for(queue.get(), timeout=60.0)
-                except asyncio.TimeoutError:
-                    # Queue idle, clean up worker
-                    break
-
-                try:
-                    ack = await self._send_and_wait_ack(frame)
-                    if not future.done():
-                        future.set_result(ack)
-                except Exception as e:
-                    if not future.done():
-                        future.set_exception(e)
-        except asyncio.CancelledError:
-            pass
-        finally:
-            self._reply_queues.pop(req_id, None)
-            self._reply_workers.pop(req_id, None)
-
-    async def _send_and_wait_ack(self, frame: dict) -> Optional[dict]:
-        """Send a frame and wait for the corresponding ACK."""
-        req_id = frame['headers']['req_id']
-        ack_future: asyncio.Future = asyncio.get_event_loop().create_future()
-        self._pending_acks[req_id] = ack_future
-
-        try:
-            await self._send_frame(frame)
-            result = await asyncio.wait_for(ack_future, timeout=self._reply_ack_timeout)
-            if result.get('errcode', 0) != 0:
-                await self.logger.warning(
-                    f'Reply ACK error: errcode={result.get("errcode")}, errmsg={result.get("errmsg")}'
-                )
-            return result
-        except asyncio.TimeoutError:
-            self._pending_acks.pop(req_id, None)
-            await self.logger.warning(f'Reply ACK timeout ({self._reply_ack_timeout}s) for req_id={req_id}')
-            return None
-
-    async def _send_frame(self, frame: dict):
-        """Send a JSON frame over the WebSocket connection."""
-        if self._ws and not self._ws.closed:
-            await self._ws.send_str(json.dumps(frame, ensure_ascii=False))
-
-    def _clear_pending_acks(self, reason: str):
-        """Reject all pending ACK futures on disconnection."""
-        for req_id, future in self._pending_acks.items():
-            if not future.done():
-                future.set_exception(ConnectionError(reason))
-        self._pending_acks.clear()

src/langbot/libs/wecom_api/api.py

@@ -4,7 +4,6 @@ import base64
 import binascii
 import httpx
 import traceback
-from urllib.parse import quote
 from quart import Quart
 import xml.etree.ElementTree as ET
 from typing import Callable, Dict, Any
@@ -68,31 +67,6 @@ class WecomClient:
                 await self.logger.error(f'获取accesstoken失败:{response.json()}')
                 raise Exception(f'未获取access token: {data}')
 
-    async def get_user_info(self, userid: str) -> dict:
-        """
-        Get user information by user ID using the application secret.
-
-        Args:
-            userid: The user ID to look up.
-
-        Returns:
-            dict: User information including 'name' field.
-        """
-        if not await self.check_access_token():
-            self.access_token = await self.get_access_token(self.secret)
-
-        url = self.base_url + '/user/get?access_token=' + self.access_token + '&userid=' + quote(userid)
-        async with httpx.AsyncClient() as client:
-            response = await client.get(url)
-            data = response.json()
-            if data.get('errcode') == 40014 or data.get('errcode') == 42001:
-                self.access_token = await self.get_access_token(self.secret)
-                return await self.get_user_info(userid)
-            if data.get('errcode', 0) != 0:
-                await self.logger.error(f'获取用户信息失败:{data}')
-                return {}
-            return data
-
     async def get_users(self):
         if not self.check_access_token_for_contacts():
             self.access_token_for_contacts = await self.get_access_token(self.secret_for_contacts)

src/langbot/libs/wecom_customer_service_api/api.py

@@ -10,7 +10,6 @@ from typing import Callable
 from .wecomcsevent import WecomCSEvent
 import langbot_plugin.api.entities.builtin.platform.message as platform_message
 import aiofiles
-import time
 
 
 class WecomCSClient:
@@ -35,10 +34,6 @@ class WecomCSClient:
         self.unified_mode = unified_mode
         self.app = Quart(__name__)
 
-        # Customer info cache: {external_userid: (info_dict, timestamp)}
-        self._customer_cache: dict[str, tuple[dict, float]] = {}
-        self._cache_ttl = 60  # Cache TTL in seconds (1 minute)
-
         # 只有在非统一模式下才注册独立路由
         if not self.unified_mode:
             self.app.add_url_rule(
@@ -383,53 +378,3 @@ class WecomCSClient:
     async def get_media_id(self, image: platform_message.Image):
         media_id = await self.upload_to_work(image=image)
         return media_id
-
-    async def get_customer_info(self, external_userid: str) -> dict | None:
-        """
-        Get customer information by external_userid with caching.
-
-        Uses a 1-minute cache to avoid repeated API calls for the same user.
-
-        Args:
-            external_userid: The external user ID of the customer.
-
-        Returns:
-            Customer info dict with 'nickname', 'avatar', etc., or None if not found.
-        """
-        # Check cache first
-        current_time = time.time()
-        if external_userid in self._customer_cache:
-            cached_info, cached_time = self._customer_cache[external_userid]
-            if current_time - cached_time < self._cache_ttl:
-                return cached_info
-
-        # Cache miss or expired, fetch from API
-        if not await self.check_access_token():
-            self.access_token = await self.get_access_token(self.secret)
-
-        url = f'{self.base_url}/kf/customer/batchget?access_token={self.access_token}'
-
-        payload = {
-            'external_userid_list': [external_userid],
-        }
-
-        async with httpx.AsyncClient() as client:
-            response = await client.post(url, json=payload)
-            data = response.json()
-
-            if data.get('errcode') in [40014, 42001]:
-                self.access_token = await self.get_access_token(self.secret)
-                return await self.get_customer_info(external_userid)
-
-            if data.get('errcode', 0) != 0:
-                if self.logger:
-                    await self.logger.warning(f'Failed to get customer info: {data}')
-                return None
-
-            customer_list = data.get('customer_list', [])
-            if customer_list:
-                customer_info = customer_list[0]
-                # Store in cache
-                self._customer_cache[external_userid] = (customer_info, current_time)
-                return customer_info
-            return None

src/langbot/pkg/api/http/controller/groups/files.py

@@ -13,9 +13,9 @@ from .. import group
 @group.group_class('files', '/api/v1/files')
 class FilesRouterGroup(group.RouterGroup):
     async def initialize(self) -> None:
-        @self.route('/image/<path:image_key>', methods=['GET'], auth_type=group.AuthType.NONE)
+        @self.route('/image/<image_key>', methods=['GET'], auth_type=group.AuthType.NONE)
         async def _(image_key: str) -> quart.Response:
-            if '..' in image_key or '\\' in image_key:
+            if '/' in image_key or '\\' in image_key:
                 return quart.Response(status=404)
 
             if not await self.ap.storage_mgr.storage_provider.exists(image_key):

src/langbot/pkg/api/http/controller/main.py

@@ -105,28 +105,6 @@ class HTTPController:
             ):
                 if os.path.exists(os.path.join(frontend_path, path + '.html')):
                     path += '.html'
-                elif path.startswith('home/'):
-                    # SPA fallback for /home/* sub-routes.
-                    # Entity detail views use query params (e.g. /home/bots?id=uuid),
-                    # so the pre-rendered list page is served directly via path + '.html'.
-                    # This fallback handles any remaining unmatched sub-paths.
-                    segments = path.rstrip('/').split('/')
-
-                    # Walk up parent segments looking for matching .html files
-                    for i in range(len(segments) - 1, 0, -1):
-                        parent_path = '/'.join(segments[:i]) + '.html'
-                        if os.path.exists(os.path.join(frontend_path, parent_path)):
-                            response = await quart.send_from_directory(frontend_path, parent_path, mimetype='text/html')
-                            response.headers['Cache-Control'] = 'no-cache, no-store, must-revalidate'
-                            response.headers['Pragma'] = 'no-cache'
-                            response.headers['Expires'] = '0'
-                            return response
-                    # Final fallback to index.html for /home/* routes
-                    response = await quart.send_from_directory(frontend_path, 'index.html', mimetype='text/html')
-                    response.headers['Cache-Control'] = 'no-cache, no-store, must-revalidate'
-                    response.headers['Pragma'] = 'no-cache'
-                    response.headers['Expires'] = '0'
-                    return response
                 else:
                     return await quart.send_from_directory(frontend_path, '404.html')
 

src/langbot/pkg/api/http/service/bot.py

@@ -70,17 +70,12 @@ class BotService:
             'lark',
         ]:
             webhook_prefix = self.ap.instance_config.data['api'].get('webhook_prefix', 'http://127.0.0.1:5300')
-            extra_webhook_prefix = self.ap.instance_config.data['api'].get('extra_webhook_prefix', '')
             webhook_url = f'/bots/{bot_uuid}'
             adapter_runtime_values['webhook_url'] = webhook_url
             adapter_runtime_values['webhook_full_url'] = f'{webhook_prefix}{webhook_url}'
-            adapter_runtime_values['extra_webhook_full_url'] = (
-                f'{extra_webhook_prefix}{webhook_url}' if extra_webhook_prefix else ''
-            )
         else:
             adapter_runtime_values['webhook_url'] = None
             adapter_runtime_values['webhook_full_url'] = None
-            adapter_runtime_values['extra_webhook_full_url'] = None
 
         persistence_bot['adapter_runtime_values'] = adapter_runtime_values
 

src/langbot/pkg/api/http/service/model.py

@@ -105,16 +105,11 @@ class LLMModelsService:
                 )
             )
             pipeline = result.first()
-            if pipeline is not None:
-                model_config = pipeline.config.get('ai', {}).get('local-agent', {}).get('model', {})
-                if not model_config.get('primary', ''):
-                    pipeline_config = pipeline.config
-                    pipeline_config['ai']['local-agent']['model'] = {
-                        'primary': model_data['uuid'],
-                        'fallbacks': [],
-                    }
-                    pipeline_data = {'config': pipeline_config}
-                    await self.ap.pipeline_service.update_pipeline(pipeline.uuid, pipeline_data)
+            if pipeline is not None and pipeline.config['ai']['local-agent']['model'] == '':
+                pipeline_config = pipeline.config
+                pipeline_config['ai']['local-agent']['model'] = model_data['uuid']
+                pipeline_data = {'config': pipeline_config}
+                await self.ap.pipeline_service.update_pipeline(pipeline.uuid, pipeline_data)
 
         return model_data['uuid']
 

src/langbot/pkg/api/http/service/monitoring.py

@@ -16,57 +16,6 @@ class MonitoringService:
     def __init__(self, ap: app.Application) -> None:
         self.ap = ap
 
-    # ========== Cleanup Methods ==========
-
-    async def cleanup_expired_records(self, retention_days: int) -> dict[str, int]:
-        """Delete monitoring records older than the specified retention period.
-
-        Args:
-            retention_days: Number of days to retain records.
-
-        Returns:
-            A dict mapping table name to the number of deleted rows.
-        """
-        cutoff = datetime.datetime.now(datetime.timezone.utc).replace(tzinfo=None) - datetime.timedelta(
-            days=retention_days
-        )
-
-        tables_and_columns: list[tuple[str, type, sqlalchemy.Column]] = [
-            (
-                'monitoring_messages',
-                persistence_monitoring.MonitoringMessage,
-                persistence_monitoring.MonitoringMessage.timestamp,
-            ),
-            (
-                'monitoring_llm_calls',
-                persistence_monitoring.MonitoringLLMCall,
-                persistence_monitoring.MonitoringLLMCall.timestamp,
-            ),
-            (
-                'monitoring_embedding_calls',
-                persistence_monitoring.MonitoringEmbeddingCall,
-                persistence_monitoring.MonitoringEmbeddingCall.timestamp,
-            ),
-            (
-                'monitoring_errors',
-                persistence_monitoring.MonitoringError,
-                persistence_monitoring.MonitoringError.timestamp,
-            ),
-            (
-                'monitoring_sessions',
-                persistence_monitoring.MonitoringSession,
-                persistence_monitoring.MonitoringSession.last_activity,
-            ),
-        ]
-
-        deleted_counts: dict[str, int] = {}
-
-        for table_name, model_cls, ts_column in tables_and_columns:
-            result = await self.ap.persistence_mgr.execute_async(sqlalchemy.delete(model_cls).where(ts_column < cutoff))
-            deleted_counts[table_name] = result.rowcount
-
-        return deleted_counts
-
     # ========== Recording Methods ==========
 
     async def record_message(
@@ -81,7 +30,6 @@ class MonitoringService:
         level: str = 'info',
         platform: str | None = None,
         user_id: str | None = None,
-        user_name: str | None = None,
         runner_name: str | None = None,
         variables: str | None = None,
         role: str = 'user',
@@ -101,7 +49,6 @@ class MonitoringService:
             'level': level,
             'platform': platform,
             'user_id': user_id,
-            'user_name': user_name,
             'runner_name': runner_name,
             'variables': variables,
             'role': role,
@@ -205,7 +152,6 @@ class MonitoringService:
         pipeline_name: str,
         platform: str | None = None,
         user_id: str | None = None,
-        user_name: str | None = None,
     ) -> None:
         """Record a new session"""
         session_data = {
@@ -220,7 +166,6 @@ class MonitoringService:
             'is_active': True,
             'platform': platform,
             'user_id': user_id,
-            'user_name': user_name,
         }
 
         await self.ap.persistence_mgr.execute_async(

src/langbot/pkg/core/app.py

@@ -9,7 +9,6 @@ from ..platform import botmgr as im_mgr
 from ..platform.webhook_pusher import WebhookPusher
 from ..provider.session import sessionmgr as llm_session_mgr
 from ..provider.modelmgr import modelmgr as llm_model_mgr
-
 from langbot.pkg.provider.tools import toolmgr as llm_tool_mgr
 from ..config import manager as config_mgr
 from ..command import cmdmgr
@@ -31,7 +30,6 @@ from ..api.http.service import mcp as mcp_service
 from ..api.http.service import apikey as apikey_service
 from ..api.http.service import webhook as webhook_service
 from ..api.http.service import monitoring as monitoring_service
-
 from ..discover import engine as discover_engine
 from ..storage import mgr as storagemgr
 from ..utils import logcache
@@ -188,34 +186,6 @@ class Application:
                 scopes=[core_entities.LifecycleControlScope.APPLICATION],
             )
 
-            # Start monitoring data cleanup task if enabled
-            monitoring_cfg = self.instance_config.data.get('monitoring', {})
-            auto_cleanup_cfg = monitoring_cfg.get('auto_cleanup', {})
-            if auto_cleanup_cfg.get('enabled', True):
-                retention_days = auto_cleanup_cfg.get('retention_days', 30)
-                check_interval_hours = auto_cleanup_cfg.get('check_interval_hours', 1)
-
-                async def monitoring_cleanup_loop():
-                    check_interval_seconds = check_interval_hours * 3600
-                    while True:
-                        try:
-                            deleted = await self.monitoring_service.cleanup_expired_records(retention_days)
-                            total_deleted = sum(deleted.values())
-                            if total_deleted > 0:
-                                self.logger.info(
-                                    f'Monitoring auto-cleanup: deleted {total_deleted} expired records '
-                                    f'(retention={retention_days}d): {deleted}'
-                                )
-                        except Exception as e:
-                            self.logger.warning(f'Monitoring auto-cleanup error: {e}')
-                        await asyncio.sleep(check_interval_seconds)
-
-                self.task_mgr.create_task(
-                    monitoring_cleanup_loop(),
-                    name='monitoring-cleanup',
-                    scopes=[core_entities.LifecycleControlScope.APPLICATION],
-                )
-
             self.task_mgr.create_task(
                 never_ending(),
                 name='never-ending-task',

src/langbot/pkg/core/stages/load_config.py

@@ -74,26 +74,20 @@ def _apply_env_overrides_to_config(cfg: dict) -> dict:
         current = cfg
 
         for i, key in enumerate(keys):
-            if not isinstance(current, dict):
+            if not isinstance(current, dict) or key not in current:
                 break
 
             if i == len(keys) - 1:
-                # At the final key
-                if key in current:
-                    if isinstance(current[key], (dict, list)):
-                        # Skip dict and list types
-                        pass
-                    else:
-                        # Valid scalar value - convert and set it
-                        converted_value = convert_value(env_value, current[key])
-                        current[key] = converted_value
+                # At the final key - check if it's a scalar value
+                if isinstance(current[key], (dict, list)):
+                    # Skip dict and list types
+                    pass
                 else:
-                    # Key doesn't exist yet - create it as string
-                    current[key] = env_value
+                    # Valid scalar value - convert and set it
+                    converted_value = convert_value(env_value, current[key])
+                    current[key] = converted_value
             else:
-                # Navigate deeper - create intermediate dict if needed
-                if key not in current:
-                    current[key] = {}
+                # Navigate deeper
                 current = current[key]
 
     return cfg
@@ -152,50 +146,16 @@ class LoadConfigStage(stage.BootingStage):
         await ap.instance_config.dump_config()
 
         # load or generate instance id
-        # Priority:
-        # 1. system.instance_id from config.yaml (can be set via SYSTEM__INSTANCE_ID env var)
-        # 2. data/labels/instance_id.json (if file exists)
-        # 3. Generate new and save to file
-        config_instance_id = ap.instance_config.data.get('system', {}).get('instance_id', '')
+        ap.instance_id = await config.load_json_config(
+            'data/labels/instance_id.json',
+            template_data={
+                'instance_id': f'instance_{str(uuid.uuid4())}',
+                'instance_create_ts': int(time.time()),
+            },
+            completion=False,
+        )
 
-        if config_instance_id:
-            # Use the instance_id from config.yaml
-            constants.instance_id = config_instance_id
-            # Still load/create the file for backward compat, but don't use its value
-            ap.instance_id = await config.load_json_config(
-                'data/labels/instance_id.json',
-                template_data={
-                    'instance_id': f'instance_{str(uuid.uuid4())}',
-                    'instance_create_ts': int(time.time()),
-                },
-                completion=False,
-            )
-        else:
-            # Try loading file-based instance id
-            instance_id_path = os.path.join('data', 'labels', 'instance_id.json')
-            if os.path.exists(instance_id_path):
-                # File exists, read it
-                ap.instance_id = await config.load_json_config(
-                    'data/labels/instance_id.json',
-                    template_data={
-                        'instance_id': '',
-                        'instance_create_ts': 0,
-                    },
-                    completion=False,
-                )
-                constants.instance_id = ap.instance_id.data['instance_id']
-            else:
-                # Neither config nor file, generate new and save to file
-                new_id = f'instance_{str(uuid.uuid4())}'
-                ap.instance_id = await config.load_json_config(
-                    'data/labels/instance_id.json',
-                    template_data={
-                        'instance_id': new_id,
-                        'instance_create_ts': int(time.time()),
-                    },
-                    completion=False,
-                )
-                constants.instance_id = new_id
+        constants.instance_id = ap.instance_id.data['instance_id']
         constants.edition = ap.instance_config.data.get('system', {}).get('edition', 'community')
 
         print(f'LangBot instance id: {constants.instance_id}')

src/langbot/pkg/entity/persistence/monitoring.py

@@ -20,7 +20,6 @@ class MonitoringMessage(Base):
     level = sqlalchemy.Column(sqlalchemy.String(50), nullable=False)  # info, warning, error, debug
     platform = sqlalchemy.Column(sqlalchemy.String(255), nullable=True)
     user_id = sqlalchemy.Column(sqlalchemy.String(255), nullable=True)
-    user_name = sqlalchemy.Column(sqlalchemy.String(255), nullable=True)  # User display name
     runner_name = sqlalchemy.Column(sqlalchemy.String(255), nullable=True)  # Runner name for this query
     variables = sqlalchemy.Column(sqlalchemy.Text, nullable=True)  # Query variables as JSON string
     role = sqlalchemy.Column(sqlalchemy.String(50), nullable=True, default='user')  # user, assistant
@@ -65,7 +64,6 @@ class MonitoringSession(Base):
     is_active = sqlalchemy.Column(sqlalchemy.Boolean, nullable=False, default=True, index=True)
     platform = sqlalchemy.Column(sqlalchemy.String(255), nullable=True)
     user_id = sqlalchemy.Column(sqlalchemy.String(255), nullable=True)
-    user_name = sqlalchemy.Column(sqlalchemy.String(255), nullable=True)  # User display name
 
 
 class MonitoringError(Base):

src/langbot/pkg/persistence/mgr.py

@@ -2,16 +2,18 @@ from __future__ import annotations
 
 import datetime
 import typing
-
+import json
+import uuid
 
 import sqlalchemy.ext.asyncio as sqlalchemy_asyncio
 import sqlalchemy
 
 from . import database, migration
-from ..entity.persistence import base, metadata, model as persistence_model
+from ..entity.persistence import base, pipeline, metadata, model as persistence_model
 from ..entity import persistence
 from ..core import app
 from ..utils import constants, importutil
+from ..api.http.service import pipeline as pipeline_service
 from . import databases, migrations
 
 importutil.import_modules_in_pkg(databases)
@@ -76,6 +78,7 @@ class PersistenceManager:
 
             self.ap.logger.info(f'Successfully upgraded database to version {last_migration_number}.')
 
+        await self.write_default_pipeline()
         await self.write_space_model_providers()
 
     async def create_tables(self):
@@ -98,6 +101,29 @@ class PersistenceManager:
             if row is None:
                 await self.execute_async(sqlalchemy.insert(metadata.Metadata).values(item))
 
+    async def write_default_pipeline(self):
+        # write default pipeline
+        result = await self.execute_async(sqlalchemy.select(pipeline.LegacyPipeline))
+        default_pipeline_uuid = None
+        if result.first() is None:
+            self.ap.logger.info('Creating default pipeline...')
+
+            pipeline_config = json.loads(importutil.read_resource_file('templates/default-pipeline-config.json'))
+
+            default_pipeline_uuid = str(uuid.uuid4())
+            pipeline_data = {
+                'uuid': default_pipeline_uuid,
+                'for_version': self.ap.ver_mgr.get_current_version(),
+                'stages': pipeline_service.default_stage_order,
+                'is_default': True,
+                'name': 'ChatPipeline',
+                'description': 'Default pipeline, new bots will be bound to this pipeline | 默认提供的流水线，您配置的机器人将自动绑定到此流水线',
+                'config': pipeline_config,
+                'extensions_preferences': {},
+            }
+
+            await self.execute_async(sqlalchemy.insert(pipeline.LegacyPipeline).values(pipeline_data))
+
     async def write_space_model_providers(self):
         space_models_gateway_api_url = self.ap.instance_config.data.get('space', {}).get(
             'models_gateway_api_url', 'https://api.langbot.cloud/v1'

src/langbot/pkg/persistence/migrations/dbm021_merge_exception_handling.py

@@ -1,74 +0,0 @@
-from .. import migration
-
-import sqlalchemy
-import json
-
-
-@migration.migration_class(21)
-class DBMigrateMergeExceptionHandling(migration.DBMigration):
-    """Merge hide-exception and block-failed-request-output into a single exception-handling select option,
-    and add failure-hint field.
-
-    Conversion logic:
-    - block-failed-request-output=true  ->  exception-handling: hide
-    - hide-exception=true               ->  exception-handling: show-hint
-    - hide-exception=false              ->  exception-handling: show-error
-    """
-
-    async def upgrade(self):
-        """Upgrade"""
-        result = await self.ap.persistence_mgr.execute_async(
-            sqlalchemy.text('SELECT uuid, config FROM legacy_pipelines')
-        )
-        pipelines = result.fetchall()
-
-        current_version = self.ap.ver_mgr.get_current_version()
-
-        for pipeline_row in pipelines:
-            uuid = pipeline_row[0]
-            config = json.loads(pipeline_row[1]) if isinstance(pipeline_row[1], str) else pipeline_row[1]
-
-            if 'output' not in config:
-                config['output'] = {}
-            if 'misc' not in config['output']:
-                config['output']['misc'] = {}
-
-            misc = config['output']['misc']
-
-            # Determine new exception-handling value from legacy fields
-            hide_exception = misc.get('hide-exception', True)
-            block_failed = misc.get('block-failed-request-output', False)
-
-            if block_failed:
-                exception_handling = 'hide'
-            elif hide_exception:
-                exception_handling = 'show-hint'
-            else:
-                exception_handling = 'show-error'
-
-            misc['exception-handling'] = exception_handling
-
-            # Add failure-hint with default value
-            misc['failure-hint'] = 'Request failed.'
-
-            # Remove legacy fields
-            misc.pop('hide-exception', None)
-
-            if self.ap.persistence_mgr.db.name == 'postgresql':
-                await self.ap.persistence_mgr.execute_async(
-                    sqlalchemy.text(
-                        'UPDATE legacy_pipelines SET config = :config::jsonb, for_version = :for_version WHERE uuid = :uuid'
-                    ),
-                    {'config': json.dumps(config), 'for_version': current_version, 'uuid': uuid},
-                )
-            else:
-                await self.ap.persistence_mgr.execute_async(
-                    sqlalchemy.text(
-                        'UPDATE legacy_pipelines SET config = :config, for_version = :for_version WHERE uuid = :uuid'
-                    ),
-                    {'config': json.dumps(config), 'for_version': current_version, 'uuid': uuid},
-                )
-
-    async def downgrade(self):
-        """Downgrade"""
-        pass

src/langbot/pkg/persistence/migrations/dbm022_monitoring_user_name.py

@@ -1,73 +0,0 @@
-import sqlalchemy
-from .. import migration
-
-
-@migration.migration_class(22)
-class DBMigrateMonitoringUserId(migration.DBMigration):
-    """Add user_id and user_name columns to monitoring_sessions table
-
-    This migration adds the missing user_id column and also ensures user_name
-    column exists (in case migration 21 failed or was skipped).
-    """
-
-    async def _table_exists(self, table_name: str) -> bool:
-        """Check if a table exists (works for both SQLite and PostgreSQL)."""
-        if self.ap.persistence_mgr.db.name == 'postgresql':
-            result = await self.ap.persistence_mgr.execute_async(
-                sqlalchemy.text(
-                    'SELECT EXISTS (SELECT FROM information_schema.tables WHERE table_name = :table_name);'
-                ).bindparams(table_name=table_name)
-            )
-            return bool(result.scalar())
-        else:
-            result = await self.ap.persistence_mgr.execute_async(
-                sqlalchemy.text("SELECT name FROM sqlite_master WHERE type='table' AND name=:table_name;").bindparams(
-                    table_name=table_name
-                )
-            )
-            return result.first() is not None
-
-    async def _get_table_columns(self, table_name: str) -> list[str]:
-        """Get column names from a table (works for both SQLite and PostgreSQL)."""
-        if self.ap.persistence_mgr.db.name == 'postgresql':
-            result = await self.ap.persistence_mgr.execute_async(
-                sqlalchemy.text(
-                    'SELECT column_name FROM information_schema.columns WHERE table_name = :table_name;'
-                ).bindparams(table_name=table_name)
-            )
-            return [row[0] for row in result.fetchall()]
-        else:
-            if not table_name.isidentifier():
-                raise ValueError(f'Invalid table name: {table_name}')
-            result = await self.ap.persistence_mgr.execute_async(sqlalchemy.text(f'PRAGMA table_info({table_name});'))
-            return [row[1] for row in result.fetchall()]
-
-    async def _add_column_if_not_exists(self, table_name: str, column_name: str, column_type: str):
-        """Add a column to a table if it does not already exist."""
-        columns = await self._get_table_columns(table_name)
-        if column_name in columns:
-            self.ap.logger.debug('%s column already exists in %s.', column_name, table_name)
-            return
-        await self.ap.persistence_mgr.execute_async(
-            sqlalchemy.text(f'ALTER TABLE {table_name} ADD COLUMN {column_name} {column_type};')
-        )
-        self.ap.logger.info('Added %s column to %s table.', column_name, table_name)
-
-    async def upgrade(self):
-        # Check if monitoring_sessions table exists
-        if not await self._table_exists('monitoring_sessions'):
-            self.ap.logger.warning('monitoring_sessions table does not exist, skipping migration.')
-            return
-
-        # Add user_id column to monitoring_sessions table
-        await self._add_column_if_not_exists('monitoring_sessions', 'user_id', 'VARCHAR(255)')
-
-        # Add user_name column to monitoring_sessions table (in case migration 21 failed)
-        await self._add_column_if_not_exists('monitoring_sessions', 'user_name', 'VARCHAR(255)')
-
-        # Add user_name column to monitoring_messages table (in case migration 21 failed)
-        if await self._table_exists('monitoring_messages'):
-            await self._add_column_if_not_exists('monitoring_messages', 'user_name', 'VARCHAR(255)')
-
-    async def downgrade(self):
-        pass

src/langbot/pkg/persistence/migrations/dbm023_model_fallback_config.py

@@ -1,102 +0,0 @@
-from .. import migration
-
-import sqlalchemy
-import json
-
-
-@migration.migration_class(23)
-class DBMigrateModelFallbackConfig(migration.DBMigration):
-    """Convert model field from plain UUID string to object with primary/fallbacks"""
-
-    async def upgrade(self):
-        """Upgrade"""
-        result = await self.ap.persistence_mgr.execute_async(
-            sqlalchemy.text('SELECT uuid, config FROM legacy_pipelines')
-        )
-        pipelines = result.fetchall()
-
-        current_version = self.ap.ver_mgr.get_current_version()
-
-        for pipeline_row in pipelines:
-            uuid = pipeline_row[0]
-            config = json.loads(pipeline_row[1]) if isinstance(pipeline_row[1], str) else pipeline_row[1]
-
-            if 'ai' not in config or 'local-agent' not in config['ai']:
-                continue
-
-            local_agent = config['ai']['local-agent']
-            changed = False
-
-            # Convert model from string to object
-            model_value = local_agent.get('model', '')
-            if isinstance(model_value, str):
-                local_agent['model'] = {
-                    'primary': model_value,
-                    'fallbacks': [],
-                }
-                changed = True
-
-            # Remove leftover fallback-models field if present
-            if 'fallback-models' in local_agent:
-                del local_agent['fallback-models']
-                changed = True
-
-            if not changed:
-                continue
-
-            # Update using raw SQL with compatibility for both SQLite and PostgreSQL
-            if self.ap.persistence_mgr.db.name == 'postgresql':
-                await self.ap.persistence_mgr.execute_async(
-                    sqlalchemy.text(
-                        'UPDATE legacy_pipelines SET config = :config::jsonb, for_version = :for_version WHERE uuid = :uuid'
-                    ),
-                    {'config': json.dumps(config), 'for_version': current_version, 'uuid': uuid},
-                )
-            else:
-                await self.ap.persistence_mgr.execute_async(
-                    sqlalchemy.text(
-                        'UPDATE legacy_pipelines SET config = :config, for_version = :for_version WHERE uuid = :uuid'
-                    ),
-                    {'config': json.dumps(config), 'for_version': current_version, 'uuid': uuid},
-                )
-
-    async def downgrade(self):
-        """Downgrade"""
-        result = await self.ap.persistence_mgr.execute_async(
-            sqlalchemy.text('SELECT uuid, config FROM legacy_pipelines')
-        )
-        pipelines = result.fetchall()
-
-        current_version = self.ap.ver_mgr.get_current_version()
-
-        for pipeline_row in pipelines:
-            uuid = pipeline_row[0]
-            config = json.loads(pipeline_row[1]) if isinstance(pipeline_row[1], str) else pipeline_row[1]
-
-            if 'ai' not in config or 'local-agent' not in config['ai']:
-                continue
-
-            local_agent = config['ai']['local-agent']
-
-            # Convert model from object back to string
-            model_value = local_agent.get('model', '')
-            if isinstance(model_value, dict):
-                local_agent['model'] = model_value.get('primary', '')
-            else:
-                continue
-
-            # Update using raw SQL with compatibility for both SQLite and PostgreSQL
-            if self.ap.persistence_mgr.db.name == 'postgresql':
-                await self.ap.persistence_mgr.execute_async(
-                    sqlalchemy.text(
-                        'UPDATE legacy_pipelines SET config = :config::jsonb, for_version = :for_version WHERE uuid = :uuid'
-                    ),
-                    {'config': json.dumps(config), 'for_version': current_version, 'uuid': uuid},
-                )
-            else:
-                await self.ap.persistence_mgr.execute_async(
-                    sqlalchemy.text(
-                        'UPDATE legacy_pipelines SET config = :config, for_version = :for_version WHERE uuid = :uuid'
-                    ),
-                    {'config': json.dumps(config), 'for_version': current_version, 'uuid': uuid},
-                )

src/langbot/pkg/persistence/migrations/dbm024_wecombot_websocket_mode.py

@@ -1,49 +0,0 @@
-from .. import migration
-
-import sqlalchemy
-import json
-
-
-@migration.migration_class(24)
-class DBMigrateWecomBotWebSocketMode(migration.DBMigration):
-    """Add enable-webhook field to existing wecombot adapter configs.
-
-    Existing wecombot bots were all using webhook mode, so we set
-    enable-webhook=true to preserve their behavior after the new
-    WebSocket long connection mode is introduced as default.
-    """
-
-    async def upgrade(self):
-        """Upgrade"""
-        result = await self.ap.persistence_mgr.execute_async(
-            sqlalchemy.text("SELECT uuid, adapter_config FROM bots WHERE adapter = 'wecombot'")
-        )
-        bots = result.fetchall()
-
-        for bot_row in bots:
-            bot_uuid = bot_row[0]
-            adapter_config = json.loads(bot_row[1]) if isinstance(bot_row[1], str) else bot_row[1]
-
-            if 'enable-webhook' in adapter_config:
-                continue
-
-            # Determine mode based on existing config: if webhook fields are present, keep webhook mode
-            has_webhook_config = bool(
-                adapter_config.get('Token') and adapter_config.get('EncodingAESKey') and adapter_config.get('Corpid')
-            )
-            adapter_config['enable-webhook'] = has_webhook_config
-
-            if self.ap.persistence_mgr.db.name == 'postgresql':
-                await self.ap.persistence_mgr.execute_async(
-                    sqlalchemy.text('UPDATE bots SET adapter_config = :config::jsonb WHERE uuid = :uuid'),
-                    {'config': json.dumps(adapter_config), 'uuid': bot_uuid},
-                )
-            else:
-                await self.ap.persistence_mgr.execute_async(
-                    sqlalchemy.text('UPDATE bots SET adapter_config = :config WHERE uuid = :uuid'),
-                    {'config': json.dumps(adapter_config), 'uuid': bot_uuid},
-                )
-
-    async def downgrade(self):
-        """Downgrade"""
-        pass

src/langbot/pkg/pipeline/monitoring_helper.py

@@ -34,15 +34,6 @@ class MonitoringHelper:
             # Check if session exists, if not, record session start
             session_id = f'{query.launcher_type}_{query.launcher_id}'
 
-            # Get sender name from message event
-            sender_name = None
-            if hasattr(query, 'message_event'):
-                if hasattr(query.message_event, 'sender'):
-                    if hasattr(query.message_event.sender, 'nickname'):
-                        sender_name = query.message_event.sender.nickname
-                    elif hasattr(query.message_event.sender, 'member_name'):
-                        sender_name = query.message_event.sender.member_name
-
             # Try to record message
             # Use JSON serialization to preserve message chain structure (including image URLs, etc.)
             if hasattr(query, 'message_chain') and hasattr(query.message_chain, 'model_dump'):
@@ -66,7 +57,6 @@ class MonitoringHelper:
                 if hasattr(query.launcher_type, 'value')
                 else str(query.launcher_type),
                 user_id=query.sender_id,
-                user_name=sender_name,
                 runner_name=runner_name,
                 variables=None,  # Will be updated in record_query_success
             )
@@ -90,7 +80,6 @@ class MonitoringHelper:
                     if hasattr(query.launcher_type, 'value')
                     else str(query.launcher_type),
                     user_id=query.sender_id,
-                    user_name=sender_name,
                 )
 
             return message_id
@@ -139,15 +128,6 @@ class MonitoringHelper:
         try:
             session_id = f'{query.launcher_type}_{query.launcher_id}'
 
-            # Get sender name from message event
-            sender_name = None
-            if hasattr(query, 'message_event'):
-                if hasattr(query.message_event, 'sender'):
-                    if hasattr(query.message_event.sender, 'nickname'):
-                        sender_name = query.message_event.sender.nickname
-                    elif hasattr(query.message_event.sender, 'member_name'):
-                        sender_name = query.message_event.sender.member_name
-
             # Extract response content from resp_message_chain
             if hasattr(query, 'resp_message_chain') and query.resp_message_chain:
                 # Serialize the last response message chain
@@ -182,7 +162,6 @@ class MonitoringHelper:
                 if hasattr(query.launcher_type, 'value')
                 else str(query.launcher_type),
                 user_id=query.sender_id,
-                user_name=sender_name,
                 runner_name=runner_name,
                 role='assistant',
             )
@@ -204,15 +183,6 @@ class MonitoringHelper:
         try:
             session_id = f'{query.launcher_type}_{query.launcher_id}'
 
-            # Get sender name from message event
-            sender_name = None
-            if hasattr(query, 'message_event'):
-                if hasattr(query.message_event, 'sender'):
-                    if hasattr(query.message_event.sender, 'nickname'):
-                        sender_name = query.message_event.sender.nickname
-                    elif hasattr(query.message_event.sender, 'member_name'):
-                        sender_name = query.message_event.sender.member_name
-
             # Record error message
             message_id = await ap.monitoring_service.record_message(
                 bot_id=bot_id,
@@ -227,7 +197,6 @@ class MonitoringHelper:
                 if hasattr(query.launcher_type, 'value')
                 else str(query.launcher_type),
                 user_id=query.sender_id,
-                user_name=sender_name,
                 runner_name=runner_name,
             )
 

src/langbot/pkg/pipeline/preproc/preproc.py

@@ -36,36 +36,17 @@ class PreProcessor(stage.PipelineStage):
         session = await self.ap.sess_mgr.get_session(query)
 
         # When not local-agent, llm_model is None
-        llm_model = None
-        if selected_runner == 'local-agent':
-            # Read model config — new format is { primary: str, fallbacks: [str] },
-            # but handle legacy plain string for backward compatibility
-            model_config = query.pipeline_config['ai']['local-agent'].get('model', {})
-            if isinstance(model_config, str):
-                # Legacy format: plain UUID string
-                primary_uuid = model_config
-                fallback_uuids = []
-            else:
-                primary_uuid = model_config.get('primary', '')
-                fallback_uuids = model_config.get('fallbacks', [])
-
-            if primary_uuid:
-                try:
-                    llm_model = await self.ap.model_mgr.get_model_by_uuid(primary_uuid)
-                except ValueError:
-                    self.ap.logger.warning(f'LLM model {primary_uuid} not found or not configured')
-
-            # Resolve fallback model UUIDs
-            if fallback_uuids:
-                valid_fallbacks = []
-                for fb_uuid in fallback_uuids:
-                    try:
-                        await self.ap.model_mgr.get_model_by_uuid(fb_uuid)
-                        valid_fallbacks.append(fb_uuid)
-                    except ValueError:
-                        self.ap.logger.warning(f'Fallback model {fb_uuid} not found, skipping')
-                if valid_fallbacks:
-                    query.variables['_fallback_model_uuids'] = valid_fallbacks
+        try:
+            llm_model = (
+                await self.ap.model_mgr.get_model_by_uuid(query.pipeline_config['ai']['local-agent']['model'])
+                if selected_runner == 'local-agent'
+                else None
+            )
+        except ValueError:
+            self.ap.logger.warning(
+                f'LLM model {query.pipeline_config["ai"]["local-agent"]["model"] + " "}not found or not configured'
+            )
+            llm_model = None
 
         conversation = await self.ap.sess_mgr.get_conversation(
             query,
@@ -80,28 +61,20 @@ class PreProcessor(stage.PipelineStage):
         query.prompt = conversation.prompt.copy()
         query.messages = conversation.messages.copy()
 
-        if selected_runner == 'local-agent':
+        if selected_runner == 'local-agent' and llm_model:
             query.use_funcs = []
-            if llm_model:
-                query.use_llm_model_uuid = llm_model.model_entity.uuid
+            query.use_llm_model_uuid = llm_model.model_entity.uuid
 
-                if llm_model.model_entity.abilities.__contains__('func_call'):
-                    # Get bound plugins and MCP servers for filtering tools
-                    bound_plugins = query.variables.get('_pipeline_bound_plugins', None)
-                    bound_mcp_servers = query.variables.get('_pipeline_bound_mcp_servers', None)
-                    query.use_funcs = await self.ap.tool_mgr.get_all_tools(bound_plugins, bound_mcp_servers)
-
-                    self.ap.logger.debug(f'Bound plugins: {bound_plugins}')
-                    self.ap.logger.debug(f'Bound MCP servers: {bound_mcp_servers}')
-                    self.ap.logger.debug(f'Use funcs: {query.use_funcs}')
-
-            # If primary model doesn't support func_call but fallback models exist,
-            # load tools anyway since fallback models may support them
-            if not query.use_funcs and query.variables.get('_fallback_model_uuids'):
+            if llm_model.model_entity.abilities.__contains__('func_call'):
+                # Get bound plugins and MCP servers for filtering tools
                 bound_plugins = query.variables.get('_pipeline_bound_plugins', None)
                 bound_mcp_servers = query.variables.get('_pipeline_bound_mcp_servers', None)
                 query.use_funcs = await self.ap.tool_mgr.get_all_tools(bound_plugins, bound_mcp_servers)
 
+                self.ap.logger.debug(f'Bound plugins: {bound_plugins}')
+                self.ap.logger.debug(f'Bound MCP servers: {bound_mcp_servers}')
+                self.ap.logger.debug(f'Use funcs: {query.use_funcs}')
+
         sender_name = ''
 
         if isinstance(query.message_event, platform_events.GroupMessage):
@@ -176,16 +149,6 @@ class PreProcessor(stage.PipelineStage):
         query.variables['user_message_text'] = plain_text
 
         query.user_message = provider_message.Message(role='user', content=content_list)
-
-        # Extract knowledge base UUIDs into query variables so plugins can modify them
-        # during PromptPreProcessing before the runner performs retrieval.
-        kb_uuids = query.pipeline_config['ai']['local-agent'].get('knowledge-bases', [])
-        if not kb_uuids:
-            old_kb_uuid = query.pipeline_config['ai']['local-agent'].get('knowledge-base', '')
-            if old_kb_uuid and old_kb_uuid != '__none__':
-                kb_uuids = [old_kb_uuid]
-        query.variables['_knowledge_base_uuids'] = list(kb_uuids)
-
         # =========== 触发事件 PromptPreProcessing
 
         event = events.PromptPreProcessing(

src/langbot/pkg/pipeline/process/handlers/chat.py

@@ -149,19 +149,12 @@ class ChatMessageHandler(handler.MessageHandler):
                 self.ap.logger.error(f'Conversation({query.query_id}) Request Failed: {error_info}')
                 traceback.print_exc()
 
-                exception_handling = query.pipeline_config['output']['misc'].get('exception-handling', 'show-hint')
-
-                if exception_handling == 'show-error':
-                    user_notice = f'{e}'
-                elif exception_handling == 'show-hint':
-                    user_notice = query.pipeline_config['output']['misc'].get('failure-hint', 'Request failed.')
-                else:  # hide
-                    user_notice = None
+                hide_exception_info = query.pipeline_config['output']['misc']['hide-exception']
 
                 yield entities.StageProcessResult(
                     result_type=entities.ResultType.INTERRUPT,
                     new_query=query,
-                    user_notice=user_notice,
+                    user_notice='请求失败' if hide_exception_info else f'{e}',
                     error_notice=f'{e}',
                     debug_notice=traceback.format_exc(),
                 )

src/langbot/pkg/platform/sources/lark.py

@@ -575,127 +575,6 @@ class LarkMessageConverter(abstract_platform_adapter.AbstractMessageConverter):
 
 
 class LarkEventConverter(abstract_platform_adapter.AbstractEventConverter):
-    _processed_thread_quote_cache: typing.ClassVar[dict[str, float]] = {}
-    _processed_thread_quote_cache_max_size: typing.ClassVar[int] = 4096
-    _processed_thread_quote_cache_ttl_seconds: typing.ClassVar[int] = 86400
-
-    @classmethod
-    def _prune_processed_thread_quote_cache(cls, now: typing.Optional[float] = None) -> None:
-        if now is None:
-            now = time.time()
-
-        expire_before = now - cls._processed_thread_quote_cache_ttl_seconds
-        while cls._processed_thread_quote_cache:
-            oldest_key, oldest_ts = next(iter(cls._processed_thread_quote_cache.items()))
-            if oldest_ts >= expire_before:
-                break
-            cls._processed_thread_quote_cache.pop(oldest_key, None)
-
-        while len(cls._processed_thread_quote_cache) > cls._processed_thread_quote_cache_max_size:
-            oldest_key = next(iter(cls._processed_thread_quote_cache))
-            cls._processed_thread_quote_cache.pop(oldest_key, None)
-
-    @classmethod
-    def _mark_thread_quote_processed(cls, thread_id: str) -> None:
-        now = time.time()
-        cls._prune_processed_thread_quote_cache(now)
-        cls._processed_thread_quote_cache[thread_id] = now
-
-    @classmethod
-    def _extract_quote_message_id(cls, message: EventMessage) -> typing.Optional[str]:
-        """
-        Extract the message ID to quote from the given message.
-
-        Rules:
-        - First thread reply in a topic: return parent_id and mark topic as processed
-        - Follow-up thread replies in the same topic: return None
-        - Non-thread message: return parent_id if valid (non-empty, different from message_id)
-
-        Thread reply state is kept in a bounded TTL cache to avoid unbounded memory growth.
-        """
-        parent_id = getattr(message, 'parent_id', None)
-        if not parent_id:
-            return None
-
-        message_id = getattr(message, 'message_id', None)
-        if parent_id == message_id:
-            return None
-
-        thread_id = getattr(message, 'thread_id', None)
-        if thread_id:
-            cls._prune_processed_thread_quote_cache()
-            if thread_id in cls._processed_thread_quote_cache:
-                return None
-            cls._mark_thread_quote_processed(thread_id)
-
-        return parent_id
-
-    @staticmethod
-    def _build_event_message_from_message_item(message_item: Message) -> typing.Optional[EventMessage]:
-        """
-        Build EventMessage from SDK typed Message item.
-
-        Returns None if body or content is missing.
-        """
-        body = getattr(message_item, 'body', None)
-        if not body:
-            return None
-
-        content = getattr(body, 'content', None)
-        if not content:
-            return None
-
-        event_data = {
-            'message_id': message_item.message_id,
-            'message_type': message_item.msg_type,
-            'content': content,
-            'create_time': message_item.create_time,
-            'mentions': getattr(message_item, 'mentions', []) or [],
-        }
-
-        # Preserve thread-related fields
-        if hasattr(message_item, 'parent_id') and message_item.parent_id:
-            event_data['parent_id'] = message_item.parent_id
-        if hasattr(message_item, 'root_id') and message_item.root_id:
-            event_data['root_id'] = message_item.root_id
-        if hasattr(message_item, 'thread_id') and message_item.thread_id:
-            event_data['thread_id'] = message_item.thread_id
-        if hasattr(message_item, 'chat_id') and message_item.chat_id:
-            event_data['chat_id'] = message_item.chat_id
-
-        return EventMessage(event_data)
-
-    @staticmethod
-    async def _fetch_quoted_message(
-        quote_message_id: str,
-        api_client: lark_oapi.Client,
-    ) -> typing.Optional[platform_message.MessageChain]:
-        """
-        Fetch the quoted message and convert to MessageChain.
-
-        Returns None if:
-        - API call fails
-        - Response items is empty
-        - Message item normalization fails
-        """
-        request = GetMessageRequest.builder().message_id(quote_message_id).build()
-        response = await api_client.im.v1.message.aget(request)
-
-        if not response.success():
-            return None
-
-        items = getattr(response.data, 'items', None)
-        if not items:
-            return None
-
-        message_item = items[0]
-        event_message = LarkEventConverter._build_event_message_from_message_item(message_item)
-        if event_message is None:
-            return None
-
-        quote_chain = await LarkMessageConverter.target2yiri(event_message, api_client)
-        return quote_chain
-
     @staticmethod
     async def yiri2target(
         event: platform_events.MessageEvent,
@@ -708,23 +587,6 @@ class LarkEventConverter(abstract_platform_adapter.AbstractEventConverter):
     ) -> platform_events.Event:
         message_chain = await LarkMessageConverter.target2yiri(event.event.message, api_client)
 
-        # Check for quote/reply message
-        quote_message_id = LarkEventConverter._extract_quote_message_id(event.event.message)
-        if quote_message_id:
-            quote_chain = await LarkEventConverter._fetch_quoted_message(quote_message_id, api_client)
-            if quote_chain:
-                # Filter out Source component from quoted chain, keep only content
-                quote_origin = platform_message.MessageChain(
-                    [comp for comp in quote_chain if not isinstance(comp, platform_message.Source)]
-                )
-                if quote_origin:
-                    message_chain.append(
-                        platform_message.Quote(
-                            message_id=quote_message_id,
-                            origin=quote_origin,
-                        )
-                    )
-
         if event.event.message.chat_type == 'p2p':
             return platform_events.FriendMessage(
                 sender=platform_entities.Friend(
@@ -908,32 +770,6 @@ class LarkAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
             self.request_tenant_access_token(tenant_key)
         return self.tenant_access_tokens.get(tenant_key)['token'] if self.tenant_access_tokens.get(tenant_key) else None
 
-    def get_launcher_id(self, event: platform_events.MessageEvent) -> str | None:
-        """
-        Get topic-scoped launcher_id for thread-aware session isolation.
-
-        For group thread messages, returns "{group_id}_{thread_id}"
-        to ensure conversation context stays stable per topic.
-
-        Returns None for non-thread messages or P2P messages.
-        """
-        source_event = getattr(event.source_platform_object, 'event', None)
-        if not source_event:
-            return None
-
-        message = getattr(source_event, 'message', None)
-        if not message:
-            return None
-
-        thread_id = getattr(message, 'thread_id', None)
-        if not thread_id:
-            return None
-
-        if isinstance(event, platform_events.GroupMessage):
-            return f'{event.group.id}_{thread_id}'
-
-        return None
-
     def build_api_client(self, config):
         app_id = config['app_id']
         app_secret = config['app_secret']

src/langbot/pkg/platform/sources/openclaw_weixin.py

@@ -1,577 +0,0 @@
-"""OpenClaw WeChat adapter for LangBot.
-
-Uses the OpenClaw WeChat HTTP JSON API (long-poll getUpdates + sendMessage)
-to integrate personal WeChat accounts with LangBot.
-
-Reference: https://github.com/epiral/weixin-bot
-"""
-
-from __future__ import annotations
-
-import asyncio
-import base64
-import traceback
-import typing
-
-import pydantic
-import sqlalchemy
-
-from langbot.libs.openclaw_weixin_api.client import (
-    DEFAULT_BASE_URL,
-    SESSION_EXPIRED_ERRCODE,
-    OpenClawWeixinClient,
-)
-from langbot.libs.openclaw_weixin_api.types import (
-    MessageItem,
-    WeixinMessage,
-)
-from langbot.pkg.entity.persistence import bot as persistence_bot
-
-import langbot_plugin.api.definition.abstract.platform.adapter as abstract_platform_adapter
-import langbot_plugin.api.definition.abstract.platform.event_logger as abstract_platform_logger
-import langbot_plugin.api.entities.builtin.platform.entities as platform_entities
-import langbot_plugin.api.entities.builtin.platform.events as platform_events
-import langbot_plugin.api.entities.builtin.platform.message as platform_message
-
-
-class OpenClawWeixinMessageConverter(abstract_platform_adapter.AbstractMessageConverter):
-    """Converts between LangBot MessageChain and OpenClaw WeChat message items."""
-
-    @staticmethod
-    async def yiri2target(message_chain: platform_message.MessageChain) -> list[dict]:
-        """Convert LangBot MessageChain to a list of OpenClaw message item dicts."""
-        items = []
-        for component in message_chain:
-            if isinstance(component, platform_message.Plain):
-                items.append({'type': MessageItem.TEXT, 'text_item': {'text': component.text}})
-            elif isinstance(component, platform_message.Image):
-                # OpenClaw WeChat only supports text messages without CDN upload.
-                # For images, we send a placeholder text with the URL if available.
-                if component.url:
-                    items.append(
-                        {
-                            'type': MessageItem.TEXT,
-                            'text_item': {'text': f'[Image: {component.url}]'},
-                        }
-                    )
-                elif component.base64:
-                    items.append(
-                        {
-                            'type': MessageItem.TEXT,
-                            'text_item': {'text': '[Image]'},
-                        }
-                    )
-            elif isinstance(component, platform_message.File):
-                if component.name:
-                    items.append(
-                        {
-                            'type': MessageItem.TEXT,
-                            'text_item': {'text': f'[File: {component.name}]'},
-                        }
-                    )
-            elif isinstance(component, platform_message.Forward):
-                for node in component.node_list:
-                    if node.message_chain:
-                        items.extend(await OpenClawWeixinMessageConverter.yiri2target(node.message_chain))
-        return items
-
-    @staticmethod
-    async def target2yiri(
-        msg: WeixinMessage,
-    ) -> platform_message.MessageChain:
-        """Convert an OpenClaw WeixinMessage to LangBot MessageChain."""
-        components: list[platform_message.MessageComponent] = []
-
-        if not msg.item_list:
-            return platform_message.MessageChain(components)
-
-        for item in msg.item_list:
-            if item.type == MessageItem.TEXT and item.text_item and item.text_item.text:
-                text = item.text_item.text
-
-                # Handle quoted messages
-                if item.ref_msg:
-                    ref_parts = []
-                    if item.ref_msg.title:
-                        ref_parts.append(item.ref_msg.title)
-                    if item.ref_msg.message_item:
-                        ref_item = item.ref_msg.message_item
-                        if ref_item.text_item and ref_item.text_item.text:
-                            ref_parts.append(ref_item.text_item.text)
-                    if ref_parts:
-                        components.append(
-                            platform_message.Quote(
-                                sender_id='',
-                                origin=platform_message.MessageChain(
-                                    [platform_message.Plain(text=' | '.join(ref_parts))]
-                                ),
-                            )
-                        )
-
-                components.append(platform_message.Plain(text=text))
-
-            elif item.type == MessageItem.IMAGE and item.image_item:
-                if hasattr(item.image_item, '_downloaded_bytes') and item.image_item._downloaded_bytes:
-                    b64 = base64.b64encode(item.image_item._downloaded_bytes).decode('utf-8')
-                    components.append(platform_message.Image(base64=f'data:image/jpeg;base64,{b64}'))
-                else:
-                    components.append(platform_message.Unknown(text='[Image]'))
-
-            elif item.type == MessageItem.VOICE and item.voice_item:
-                # Voice with speech-to-text: use the transcribed text
-                if item.voice_item.text:
-                    components.append(platform_message.Plain(text=item.voice_item.text))
-                else:
-                    components.append(platform_message.Unknown(text='[Voice]'))
-
-            # TODO: enable after full testing
-            # elif item.type == MessageItem.VOICE and item.voice_item:
-            #     if item.voice_item.text:
-            #         components.append(platform_message.Plain(text=item.voice_item.text))
-            #     elif hasattr(item.voice_item, '_downloaded_bytes') and item.voice_item._downloaded_bytes:
-            #         b64 = base64.b64encode(item.voice_item._downloaded_bytes).decode('utf-8')
-            #         components.append(
-            #             platform_message.Voice(
-            #                 base64=b64,
-            #                 length=item.voice_item.playtime or 0,
-            #             )
-            #         )
-            #     else:
-            #         components.append(
-            #             platform_message.Voice(
-            #                 length=item.voice_item.playtime or 0,
-            #             )
-            #         )
-
-            elif item.type == MessageItem.FILE and item.file_item:
-                components.append(platform_message.Unknown(text=f'[File: {item.file_item.file_name or ""}]'))
-
-            # TODO: enable after full testing
-            # elif item.type == MessageItem.FILE and item.file_item:
-            #     file_name = item.file_item.file_name or ''
-            #     file_size = int(item.file_item.len) if item.file_item.len else 0
-            #     if hasattr(item.file_item, '_downloaded_bytes') and item.file_item._downloaded_bytes:
-            #         b64 = base64.b64encode(item.file_item._downloaded_bytes).decode('utf-8')
-            #         components.append(
-            #             platform_message.File(
-            #                 name=file_name,
-            #                 size=file_size,
-            #                 base64=b64,
-            #             )
-            #         )
-            #     else:
-            #         components.append(
-            #             platform_message.File(
-            #                 name=file_name,
-            #                 size=file_size,
-            #             )
-            #         )
-
-            elif item.type == MessageItem.VIDEO and item.video_item:
-                components.append(platform_message.Unknown(text='[Video]'))
-
-            # TODO: enable after full testing
-            # elif item.type == MessageItem.VIDEO and item.video_item:
-            #     if hasattr(item.video_item, '_downloaded_bytes') and item.video_item._downloaded_bytes:
-            #         b64 = base64.b64encode(item.video_item._downloaded_bytes).decode('utf-8')
-            #         components.append(
-            #             platform_message.File(
-            #                 name='video.mp4',
-            #                 size=item.video_item.video_size or 0,
-            #                 base64=b64,
-            #             )
-            #         )
-            #     else:
-            #         components.append(
-            #             platform_message.File(
-            #                 name='video.mp4',
-            #                 size=item.video_item.video_size or 0,
-            #             )
-            #         )
-
-            else:
-                components.append(platform_message.Unknown(text='[Unknown message type]'))
-
-        return platform_message.MessageChain(components)
-
-
-class OpenClawWeixinEventConverter(abstract_platform_adapter.AbstractEventConverter):
-    """Converts OpenClaw WeChat messages to LangBot events."""
-
-    @staticmethod
-    async def yiri2target(event: platform_events.MessageEvent) -> dict:
-        return event.source_platform_object
-
-    @staticmethod
-    async def target2yiri(msg: WeixinMessage) -> typing.Optional[platform_events.MessageEvent]:
-        """Convert an inbound WeixinMessage to a LangBot event."""
-        if msg.message_type != WeixinMessage.TYPE_USER:
-            return None
-
-        from_user_id = msg.from_user_id or ''
-        if not from_user_id:
-            return None
-
-        message_chain = await OpenClawWeixinMessageConverter.target2yiri(msg)
-        if not message_chain:
-            return None
-
-        timestamp = (msg.create_time_ms or 0) / 1000.0
-
-        return platform_events.FriendMessage(
-            sender=platform_entities.Friend(
-                id=from_user_id,
-                nickname=from_user_id,
-                remark='',
-            ),
-            message_chain=message_chain,
-            time=timestamp,
-            source_platform_object=msg,
-        )
-
-
-class OpenClawWeixinAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
-    """LangBot adapter for OpenClaw WeChat (long-poll based)."""
-
-    name: str = 'openclaw-weixin'
-
-    client: OpenClawWeixinClient = pydantic.Field(exclude=True)
-
-    config: dict
-
-    message_converter: OpenClawWeixinMessageConverter = OpenClawWeixinMessageConverter()
-    event_converter: OpenClawWeixinEventConverter = OpenClawWeixinEventConverter()
-
-    # context_token cache: from_user_id -> context_token
-    _context_tokens: dict[str, str] = pydantic.PrivateAttr(default_factory=dict)
-
-    _polling: bool = pydantic.PrivateAttr(default=False)
-    _poll_task: typing.Optional[asyncio.Task] = pydantic.PrivateAttr(default=None)
-    _bot_uuid: typing.Optional[str] = pydantic.PrivateAttr(default=None)
-
-    listeners: typing.Dict[
-        typing.Type[platform_events.Event],
-        typing.Callable[[platform_events.Event, abstract_platform_adapter.AbstractMessagePlatformAdapter], None],
-    ] = {}
-
-    def __init__(self, config: dict, logger: abstract_platform_logger.AbstractEventLogger):
-        client = OpenClawWeixinClient(
-            base_url=config.get('base_url', DEFAULT_BASE_URL),
-            token=config.get('token', ''),
-        )
-        super().__init__(
-            config=config,
-            logger=logger,
-            client=client,
-            bot_account_id='',
-            listeners={},
-            name='openclaw-weixin',
-        )
-
-    def set_bot_uuid(self, bot_uuid: str):
-        """Called by BotManager to provide the bot's UUID for config persistence."""
-        self._bot_uuid = bot_uuid
-
-    async def _persist_config(self) -> None:
-        """Persist current self.config to the database so token survives restart."""
-        if not self._bot_uuid:
-            return
-        try:
-            ap = self.logger.ap
-            await ap.persistence_mgr.execute_async(
-                sqlalchemy.update(persistence_bot.Bot)
-                .where(persistence_bot.Bot.uuid == self._bot_uuid)
-                .values(adapter_config=self.config)
-            )
-        except Exception as e:
-            await self.logger.warning(f'Failed to persist adapter config: {e}')
-
-    async def _do_login(self) -> None:
-        """Run the QR code login flow via client.login() and update config."""
-        adapter_logger = self.logger
-
-        async def _on_qrcode(qr_base64: str, _qr_url: str):
-            await adapter_logger.info(
-                f'Please scan the QR code to login WeChat: {_qr_url}',
-                images=[platform_message.Image(base64=qr_base64)],
-            )
-
-        login_result = await self.client.login(
-            on_qrcode=_on_qrcode,
-        )
-
-        # client.login() already updates client.token and client.base_url
-        self.config['token'] = login_result.token
-        self.config['base_url'] = login_result.base_url
-        if login_result.account_id:
-            self.config['account_id'] = login_result.account_id
-
-        await self.logger.info(f'WeChat login successful! account_id={login_result.account_id}')
-
-        # Persist token to database so it survives restart
-        await self._persist_config()
-
-    async def send_message(
-        self,
-        target_type: str,
-        target_id: str,
-        message: platform_message.MessageChain,
-    ):
-        """Send a message to a user."""
-        context_token = self._context_tokens.get(target_id, '')
-
-        for component in message:
-            try:
-                if isinstance(component, platform_message.Plain):
-                    if component.text:
-                        await self.client.send_text(target_id, component.text, context_token)
-
-                elif isinstance(component, platform_message.Image):
-                    img_bytes, _ = await component.get_bytes()
-                    await self.client.send_image(target_id, img_bytes, context_token)
-
-                elif isinstance(component, platform_message.File):
-                    file_bytes = await self._get_component_bytes(component)
-                    if file_bytes:
-                        await self.client.send_file(target_id, file_bytes, component.name or 'file', context_token)
-
-                elif isinstance(component, platform_message.Voice):
-                    voice_bytes = await self._get_component_bytes(component)
-                    if voice_bytes:
-                        await self.client.send_voice(target_id, voice_bytes, component.length or 0, context_token)
-
-                elif isinstance(component, platform_message.Forward):
-                    for node in component.node_list:
-                        if node.message_chain:
-                            await self.send_message(target_type, target_id, node.message_chain)
-
-            except Exception:
-                await self.logger.error(
-                    f'Failed to send component {type(component).__name__}: {traceback.format_exc()}'
-                )
-
-    async def reply_message(
-        self,
-        message_source: platform_events.MessageEvent,
-        message: platform_message.MessageChain,
-        quote_origin: bool = False,
-    ):
-        """Reply to a received message."""
-        source_msg = message_source.source_platform_object
-        if isinstance(source_msg, WeixinMessage):
-            target_id = source_msg.from_user_id or ''
-            if target_id:
-                await self.send_message('friend', target_id, message)
-
-    async def is_muted(self, group_id: int) -> bool:
-        return False
-
-    @staticmethod
-    async def _get_component_bytes(component: platform_message.MessageComponent) -> typing.Optional[bytes]:
-        """Extract raw bytes from a File or Voice component."""
-        b64_val = getattr(component, 'base64', None)
-        url_val = getattr(component, 'url', None)
-        path_val = getattr(component, 'path', None)
-
-        if b64_val:
-            return base64.b64decode(b64_val)
-        elif url_val and url_val.startswith(('http://', 'https://')):
-            import aiohttp
-
-            async with aiohttp.ClientSession() as session:
-                async with session.get(url_val) as resp:
-                    if resp.status == 200:
-                        return await resp.read()
-        elif path_val:
-            import asyncio
-
-            with open(path_val, 'rb') as f:
-                return await asyncio.to_thread(f.read)
-        return None
-
-    def register_listener(
-        self,
-        event_type: typing.Type[platform_events.Event],
-        callback: typing.Callable[
-            [platform_events.Event, abstract_platform_adapter.AbstractMessagePlatformAdapter],
-            None,
-        ],
-    ):
-        self.listeners[event_type] = callback
-
-    def unregister_listener(
-        self,
-        event_type: typing.Type[platform_events.Event],
-        callback: typing.Callable[
-            [platform_events.Event, abstract_platform_adapter.AbstractMessagePlatformAdapter],
-            None,
-        ],
-    ):
-        self.listeners.pop(event_type, None)
-
-    async def run_async(self):
-        """Start the adapter. If no token is configured, trigger QR code login first."""
-        base_url = self.config.get('base_url', DEFAULT_BASE_URL)
-        token = self.config.get('token', '')
-
-        await self.logger.info('OpenClaw WeChat adapter starting...')
-
-        # QR code login flow when no token is provided
-        if not token:
-            await self.logger.info('No token configured, starting QR code login...')
-            try:
-                await self._do_login()
-            except Exception as e:
-                await self.logger.error(f'QR code login failed: {e}')
-                raise
-
-        # Rebuild client with the (possibly updated) config
-        self.client = OpenClawWeixinClient(
-            base_url=self.config.get('base_url', base_url),
-            token=self.config.get('token', token),
-        )
-        self.bot_account_id = self.config.get('account_id', 'openclaw-weixin')
-        self._polling = True
-
-        # Start the long-poll loop
-        self._poll_task = asyncio.create_task(self._poll_loop())
-        await self.logger.info('OpenClaw WeChat adapter running')
-
-        try:
-            await self._poll_task
-        except asyncio.CancelledError:
-            pass
-
-    async def _poll_loop(self):
-        """Long-poll loop: call getUpdates continuously.
-
-        Error handling follows the weixin-bot SDK pattern:
-        - Exponential backoff (1s -> 10s max) on failures
-        - Session expired (errcode -14) triggers automatic re-login
-        """
-        get_updates_buf = ''
-        poll_timeout = float(self.config.get('poll_timeout', 35))
-
-        backoff_delay = 1.0
-        max_backoff = 10.0
-
-        while self._polling:
-            try:
-                resp = await self.client.get_updates(
-                    get_updates_buf=get_updates_buf,
-                    timeout=poll_timeout + 5,
-                )
-
-                if resp.longpolling_timeout_ms and resp.longpolling_timeout_ms > 0:
-                    poll_timeout = resp.longpolling_timeout_ms / 1000.0
-
-                is_api_error = (resp.ret is not None and resp.ret != 0) or (
-                    resp.errcode is not None and resp.errcode != 0
-                )
-                if is_api_error:
-                    is_session_expired = resp.errcode == SESSION_EXPIRED_ERRCODE or resp.ret == SESSION_EXPIRED_ERRCODE
-
-                    if is_session_expired:
-                        await self.logger.error('OpenClaw WeChat session expired, attempting re-login...')
-                        try:
-                            await self._do_login()
-                            # Rebuild client with new credentials
-                            self.client = OpenClawWeixinClient(
-                                base_url=self.config.get('base_url', DEFAULT_BASE_URL),
-                                token=self.config.get('token', ''),
-                            )
-                            self._context_tokens.clear()
-                            get_updates_buf = ''
-                            backoff_delay = 1.0
-                            continue
-                        except Exception:
-                            await self.logger.error(f'Re-login failed: {traceback.format_exc()}')
-                            break
-
-                    await self.logger.error(
-                        f'OpenClaw getUpdates failed: ret={resp.ret} errcode={resp.errcode} errmsg={resp.errmsg}'
-                    )
-                    await asyncio.sleep(backoff_delay)
-                    backoff_delay = min(backoff_delay * 2, max_backoff)
-                    continue
-
-                backoff_delay = 1.0
-
-                if resp.get_updates_buf:
-                    get_updates_buf = resp.get_updates_buf
-
-                for msg in resp.msgs:
-                    try:
-                        await self._handle_inbound_message(msg)
-                    except Exception:
-                        await self.logger.error(f'Error handling message: {traceback.format_exc()}')
-
-            except asyncio.CancelledError:
-                break
-            except Exception:
-                await self.logger.error(f'OpenClaw poll error: {traceback.format_exc()}')
-                await asyncio.sleep(backoff_delay)
-                backoff_delay = min(backoff_delay * 2, max_backoff)
-
-    async def _handle_inbound_message(self, msg: WeixinMessage):
-        """Process a single inbound message from getUpdates."""
-        if msg.context_token and msg.from_user_id:
-            self._context_tokens[msg.from_user_id] = msg.context_token
-
-        # Download CDN media (files, images) before converting to LangBot events
-        await self._download_media_items(msg)
-
-        event = await OpenClawWeixinEventConverter.target2yiri(msg)
-        if event is None:
-            return
-
-        if type(event) in self.listeners:
-            await self.listeners[type(event)](event, self)
-
-    async def _download_media_items(self, msg: WeixinMessage):
-        """Download CDN media for image items in the message."""
-        if not msg.item_list:
-            return
-
-        for item in msg.item_list:
-            try:
-                if item.type == MessageItem.IMAGE and item.image_item:
-                    if (
-                        item.image_item.media
-                        and item.image_item.media.encrypt_query_param
-                        and item.image_item.media.aes_key
-                    ):
-                        img_bytes = await self.client.download_media(item.image_item.media)
-                        item.image_item._downloaded_bytes = img_bytes
-
-                # TODO: enable after full testing
-                # elif item.type == MessageItem.FILE and item.file_item and item.file_item.media:
-                #     if item.file_item.media.encrypt_query_param and item.file_item.media.aes_key:
-                #         file_bytes = await self.client.download_media(item.file_item.media)
-                #         item.file_item._downloaded_bytes = file_bytes
-                #
-                # elif item.type == MessageItem.VOICE and item.voice_item and item.voice_item.media:
-                #     if item.voice_item.media.encrypt_query_param and item.voice_item.media.aes_key:
-                #         voice_bytes = await self.client.download_media(item.voice_item.media)
-                #         item.voice_item._downloaded_bytes = voice_bytes
-                #
-                # elif item.type == MessageItem.VIDEO and item.video_item and item.video_item.media:
-                #     if item.video_item.media.encrypt_query_param and item.video_item.media.aes_key:
-                #         video_bytes = await self.client.download_media(item.video_item.media)
-                #         item.video_item._downloaded_bytes = video_bytes
-
-            except Exception:
-                await self.logger.warning(f'Failed to download CDN media: {traceback.format_exc()}')
-
-    async def kill(self) -> bool:
-        """Stop the adapter."""
-        self._polling = False
-        if self._poll_task and not self._poll_task.done():
-            self._poll_task.cancel()
-            try:
-                await self._poll_task
-            except asyncio.CancelledError:
-                pass
-        await self.client.close()
-        await self.logger.info('OpenClaw WeChat adapter stopped')
-        return True

src/langbot/pkg/platform/sources/openclaw_weixin.yaml

@@ -1,57 +0,0 @@
-apiVersion: v1
-kind: MessagePlatformAdapter
-metadata:
-  name: openclaw-weixin
-  label:
-    en_US: OpenClaw WeChat
-    zh_Hans: OpenClaw 微信
-  description:
-    en_US: OpenClaw WeChat adapter, supports personal WeChat via QR code login
-    zh_Hans: OpenClaw 微信适配器，通过扫码登录支持个人微信
-  icon: wechat.png
-spec:
-  config:
-    - name: base_url
-      label:
-        en_US: API Base URL
-        zh_Hans: API 基础地址
-      description:
-        en_US: The base URL of the OpenClaw WeChat backend API
-        zh_Hans: OpenClaw 微信后端 API 的基础地址
-      type: string
-      required: true
-      default: "https://ilinkai.weixin.qq.com"
-    - name: token
-      label:
-        en_US: Token
-        zh_Hans: 令牌
-      description:
-        en_US: Bearer token obtained after QR code login authorization. Leave empty to trigger QR code login on startup.
-        zh_Hans: 扫码登录授权后获取的 Bearer 令牌。留空则启动时自动触发扫码登录。
-      type: string
-      required: false
-      default: ""
-    - name: account_id
-      label:
-        en_US: Account ID
-        zh_Hans: 账号标识
-      description:
-        en_US: A label for this WeChat account (used for display purposes)
-        zh_Hans: 此微信账号的标识（用于显示）
-      type: string
-      required: false
-      default: "openclaw-weixin"
-    - name: poll_timeout
-      label:
-        en_US: Poll Timeout (seconds)
-        zh_Hans: 轮询超时（秒）
-      description:
-        en_US: Long-poll timeout for getUpdates, the server may hold the request up to this duration
-        zh_Hans: getUpdates 长轮询超时时间，服务端最多持有请求的时长
-      type: integer
-      required: false
-      default: 35
-execution:
-  python:
-    path: ./openclaw_weixin.py
-    attr: OpenClawWeixinAdapter

src/langbot/pkg/platform/sources/telegram.py

@@ -42,25 +42,6 @@ class TelegramMessageConverter(abstract_platform_adapter.AbstractMessageConverte
                         photo_bytes = f.read()
 
                 components.append({'type': 'photo', 'photo': photo_bytes})
-            elif isinstance(component, platform_message.File):
-                file_bytes = None
-
-                if component.base64:
-                    # Strip data URI prefix if present (e.g. "data:application/pdf;base64,...")
-                    b64_data = component.base64
-                    if ';base64,' in b64_data:
-                        b64_data = b64_data.split(';base64,', 1)[1]
-                    file_bytes = base64.b64decode(b64_data)
-                elif component.url:
-                    session = httpclient.get_session()
-                    async with session.get(component.url) as response:
-                        file_bytes = await response.read()
-                elif component.path:
-                    with open(component.path, 'rb') as f:
-                        file_bytes = f.read()
-
-                file_name = getattr(component, 'name', None) or 'file'
-                components.append({'type': 'document', 'document': file_bytes, 'filename': file_name})
             elif isinstance(component, platform_message.Forward):
                 for node in component.node_list:
                     components.extend(await TelegramMessageConverter.yiri2target(node.message_chain, bot))
@@ -123,27 +104,6 @@ class TelegramMessageConverter(abstract_platform_adapter.AbstractMessageConverte
                 )
             )
 
-        if message.document:
-            if message.caption:
-                message_components.extend(parse_message_text(message.caption))
-
-            file = await message.document.get_file()
-            file_name = message.document.file_name or 'document'
-            file_size = message.document.file_size or 0
-            file_format = message.document.mime_type or 'application/octet-stream'
-
-            file_bytes = None
-            async with httpclient.get_session(trust_env=True).get(file.file_path) as response:
-                file_bytes = await response.read()
-
-            message_components.append(
-                platform_message.File(
-                    name=file_name,
-                    size=file_size,
-                    base64=f'data:{file_format};base64,{base64.b64encode(file_bytes).decode("utf-8")}',
-                )
-            )
-
         return platform_message.MessageChain(message_components)
 
 
@@ -219,10 +179,7 @@ class TelegramAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
         application = ApplicationBuilder().token(config['token']).build()
         bot = application.bot
         application.add_handler(
-            MessageHandler(
-                filters.TEXT | (filters.COMMAND) | filters.PHOTO | filters.VOICE | filters.Document.ALL,
-                telegram_callback,
-            )
+            MessageHandler(filters.TEXT | (filters.COMMAND) | filters.PHOTO | filters.VOICE, telegram_callback)
         )
         super().__init__(
             config=config,
@@ -261,13 +218,6 @@ class TelegramAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
                     continue
                 args['photo'] = telegram.InputFile(photo)
                 await self.bot.send_photo(**args)
-            elif component_type == 'document':
-                doc = component.get('document')
-                if doc is None:
-                    continue
-                filename = component.get('filename', 'file')
-                args['document'] = telegram.InputFile(doc, filename=filename)
-                await self.bot.send_document(**args)
 
     async def reply_message(
         self,

src/langbot/pkg/platform/sources/wecom.py

@@ -148,54 +148,51 @@ class WecomEventConverter(abstract_platform_adapter.AbstractEventConverter):
             pass
 
         if type(event) is platform_events.FriendMessage:
-            return event.source_platform_object
+            payload = {
+                'MsgType': 'text',
+                'Content': '',
+                'FromUserName': event.sender.id,
+                'ToUserName': bot_account_id,
+                'CreateTime': int(datetime.datetime.now().timestamp()),
+                'AgentID': event.sender.nickname,
+            }
+            wecom_event = WecomEvent.from_payload(payload=payload)
+            if not wecom_event:
+                raise ValueError('无法从 message_data 构造 WecomEvent 对象')
+
+            return wecom_event
 
     @staticmethod
-    async def target2yiri(event: WecomEvent, bot: WecomClient = None):
+    async def target2yiri(event: WecomEvent):
         """
         将 WecomEvent 转换为平台的 FriendMessage 对象。
 
         Args:
             event (WecomEvent): 企业微信事件。
-            bot (WecomClient): 企业微信客户端，用于获取用户信息。
 
         Returns:
             platform_events.FriendMessage: 转换后的 FriendMessage 对象。
         """
-        # Try to get the user's real name from the WeCom API
-        nickname = str(event.user_id)
-        if bot and event.user_id:
-            try:
-                user_info = await bot.get_user_info(event.user_id)
-                if user_info and user_info.get('name'):
-                    nickname = user_info.get('name')
-            except Exception:
-                pass  # Fall back to user_id as nickname
-
         # 转换消息链
         if event.type == 'text':
             yiri_chain = await WecomMessageConverter.target2yiri(event.message, event.message_id)
             friend = platform_entities.Friend(
                 id=f'u{event.user_id}',
-                nickname=nickname,
+                nickname=str(event.agent_id),
                 remark='',
             )
 
-            return platform_events.FriendMessage(
-                sender=friend, message_chain=yiri_chain, time=event.timestamp, source_platform_object=event
-            )
+            return platform_events.FriendMessage(sender=friend, message_chain=yiri_chain, time=event.timestamp)
         elif event.type == 'image':
             friend = platform_entities.Friend(
                 id=f'u{event.user_id}',
-                nickname=nickname,
+                nickname=str(event.agent_id),
                 remark='',
             )
 
             yiri_chain = await WecomMessageConverter.target2yiri_image(picurl=event.picurl, message_id=event.message_id)
 
-            return platform_events.FriendMessage(
-                sender=friend, message_chain=yiri_chain, time=event.timestamp, source_platform_object=event
-            )
+            return platform_events.FriendMessage(sender=friend, message_chain=yiri_chain, time=event.timestamp)
 
 
 class WecomAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
@@ -213,6 +210,7 @@ class WecomAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
             'secret',
             'token',
             'EncodingAESKey',
+            'contacts_secret',
         ]
 
         missing_keys = [key for key in required_keys if key not in config]
@@ -225,7 +223,7 @@ class WecomAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
             secret=config['secret'],
             token=config['token'],
             EncodingAESKey=config['EncodingAESKey'],
-            contacts_secret=config.get('contacts_secret', ''),  # Optional, kept for backward compatibility
+            contacts_secret=config['contacts_secret'],
             logger=logger,
             unified_mode=True,
             api_base_url=config.get('api_base_url', 'https://qyapi.weixin.qq.com/cgi-bin'),
@@ -250,17 +248,18 @@ class WecomAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
     ):
         Wecom_event = await WecomEventConverter.yiri2target(message_source, self.bot_account_id, self.bot)
         content_list = await WecomMessageConverter.yiri2target(message, self.bot)
-        # user_id is the original FromUserName from WecomEvent
-        user_id = Wecom_event.user_id
+        fixed_user_id = Wecom_event.user_id
+        # 删掉开头的u
+        fixed_user_id = fixed_user_id[1:]
         for content in content_list:
             if content['type'] == 'text':
-                await self.bot.send_private_msg(user_id, Wecom_event.agent_id, content['content'])
+                await self.bot.send_private_msg(fixed_user_id, Wecom_event.agent_id, content['content'])
             elif content['type'] == 'image':
-                await self.bot.send_image(user_id, Wecom_event.agent_id, content['media_id'])
+                await self.bot.send_image(fixed_user_id, Wecom_event.agent_id, content['media_id'])
             elif content['type'] == 'voice':
-                await self.bot.send_voice(user_id, Wecom_event.agent_id, content['media_id'])
+                await self.bot.send_voice(fixed_user_id, Wecom_event.agent_id, content['media_id'])
             elif content['type'] == 'file':
-                await self.bot.send_file(user_id, Wecom_event.agent_id, content['media_id'])
+                await self.bot.send_file(fixed_user_id, Wecom_event.agent_id, content['media_id'])
 
     async def send_message(self, target_type: str, target_id: str, message: platform_message.MessageChain):
         content_list = await WecomMessageConverter.yiri2target(message, self.bot)
@@ -288,7 +287,7 @@ class WecomAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
         async def on_message(event: WecomEvent):
             self.bot_account_id = event.receiver_id
             try:
-                return await callback(await self.event_converter.target2yiri(event, self.bot), self)
+                return await callback(await self.event_converter.target2yiri(event), self)
             except Exception:
                 await self.logger.error(f'Error in wecom callback: {traceback.format_exc()}')
 

src/langbot/pkg/platform/sources/wecom.yaml

@@ -39,6 +39,13 @@ spec:
       type: string
       required: true
       default: ""
+    - name: contacts_secret
+      label:
+        en_US: Contacts Secret
+        zh_Hans: 通讯录密钥
+      type: string
+      required: true
+      default: ""
     - name: api_base_url
       label:
         en_US: API Base URL

src/langbot/pkg/platform/sources/wecombot.py

@@ -11,7 +11,6 @@ import langbot_plugin.api.entities.builtin.platform.entities as platform_entitie
 from ..logger import EventLogger
 from langbot.libs.wecom_ai_bot_api.wecombotevent import WecomBotEvent
 from langbot.libs.wecom_ai_bot_api.api import WecomBotClient
-from langbot.libs.wecom_ai_bot_api.ws_client import WecomBotWsClient
 
 
 class WecomBotMessageConverter(abstract_platform_adapter.AbstractMessageConverter):
@@ -24,18 +23,14 @@ class WecomBotMessageConverter(abstract_platform_adapter.AbstractMessageConverte
         return content
 
     @staticmethod
-    async def target2yiri(event: WecomBotEvent, bot_name: str = ''):
+    async def target2yiri(event: WecomBotEvent):
         yiri_msg_list = []
         if event.type == 'group':
             yiri_msg_list.append(platform_message.At(target=event.ai_bot_id))
-
         yiri_msg_list.append(platform_message.Source(id=event.message_id, time=datetime.datetime.now()))
 
         if event.content:
-            content = event.content
-            if bot_name:
-                content = content.replace(f'@{bot_name}', '').strip()
-            yiri_msg_list.append(platform_message.Plain(text=content))
+            yiri_msg_list.append(platform_message.Plain(text=event.content))
 
         images = []
         if event.images:
@@ -138,15 +133,13 @@ class WecomBotMessageConverter(abstract_platform_adapter.AbstractMessageConverte
 
 
 class WecomBotEventConverter(abstract_platform_adapter.AbstractEventConverter):
-    def __init__(self, bot_name: str = ''):
-        self.bot_name = bot_name
-
     @staticmethod
     async def yiri2target(event: platform_events.MessageEvent):
         return event.source_platform_object
 
-    async def target2yiri(self, event: WecomBotEvent):
-        message_chain = await WecomBotMessageConverter.target2yiri(event, bot_name=self.bot_name)
+    @staticmethod
+    async def target2yiri(event: WecomBotEvent):
+        message_chain = await WecomBotMessageConverter.target2yiri(event)
         if event.type == 'single':
             return platform_events.FriendMessage(
                 sender=platform_entities.Friend(
@@ -183,53 +176,34 @@ class WecomBotEventConverter(abstract_platform_adapter.AbstractEventConverter):
 
 
 class WecomBotAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
-    bot: typing.Union[WecomBotClient, WecomBotWsClient]
+    bot: WecomBotClient
     bot_account_id: str
     message_converter: WecomBotMessageConverter = WecomBotMessageConverter()
-    event_converter: WecomBotEventConverter
+    event_converter: WecomBotEventConverter = WecomBotEventConverter()
     config: dict
     bot_uuid: str = None
-    _ws_mode: bool = False
-    bot_name: str = ''
-    listeners: dict = {}
 
     def __init__(self, config: dict, logger: EventLogger):
-        enable_webhook = config.get('enable-webhook', False)
-        bot_name = config.get('robot_name', '')
+        required_keys = ['Token', 'EncodingAESKey', 'Corpid', 'BotId']
+        missing_keys = [key for key in required_keys if key not in config]
+        if missing_keys:
+            raise Exception(f'WecomBot 缺少配置项: {missing_keys}')
 
-        if not enable_webhook:
-            bot = WecomBotWsClient(
-                bot_id=config['BotId'],
-                secret=config['Secret'],
-                logger=logger,
-                encoding_aes_key=config.get('EncodingAESKey', ''),
-            )
-        else:
-            # Webhook callback mode
-            required_keys = ['Token', 'EncodingAESKey', 'Corpid']
-            missing_keys = [key for key in required_keys if key not in config or not config[key]]
-            if missing_keys:
-                raise Exception(f'WecomBot webhook mode missing config: {missing_keys}')
+        bot = WecomBotClient(
+            Token=config['Token'],
+            EnCodingAESKey=config['EncodingAESKey'],
+            Corpid=config['Corpid'],
+            logger=logger,
+            unified_mode=True,
+        )
+        bot_account_id = config['BotId']
 
-            bot = WecomBotClient(
-                Token=config['Token'],
-                EnCodingAESKey=config['EncodingAESKey'],
-                Corpid=config['Corpid'],
-                logger=logger,
-                unified_mode=True,
-            )
-
-        bot_account_id = config.get('BotId', '')
-        event_converter = WecomBotEventConverter(bot_name=bot_name)
         super().__init__(
             config=config,
             logger=logger,
             bot=bot,
             bot_account_id=bot_account_id,
-            bot_name=bot_name,
-            event_converter=event_converter,
         )
-        self.listeners = {}
 
     async def reply_message(
         self,
@@ -238,17 +212,7 @@ class WecomBotAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
         quote_origin: bool = False,
     ):
         content = await self.message_converter.yiri2target(message)
-        _ws_mode = not self.config.get('enable-webhook', False)
-
-        if _ws_mode:
-            event = message_source.source_platform_object
-            req_id = event.get('req_id', '')
-            if req_id:
-                await self.bot.reply_text(req_id, content)
-            else:
-                await self.bot.set_message(event.message_id, content)
-        else:
-            await self.bot.set_message(message_source.source_platform_object.message_id, content)
+        await self.bot.set_message(message_source.source_platform_object.message_id, content)
 
     async def reply_message_chunk(
         self,
@@ -258,44 +222,44 @@ class WecomBotAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
         quote_origin: bool = False,
         is_final: bool = False,
     ):
+        """将流水线增量输出写入企业微信 stream 会话。
+
+        Args:
+            message_source: 流水线提供的原始消息事件。
+            bot_message: 当前片段对应的模型元信息（未使用）。
+            message: 需要回复的消息链。
+            quote_origin: 是否引用原消息（企业微信暂不支持）。
+            is_final: 标记当前片段是否为最终回复。
+
+        Returns:
+            dict: 包含 `stream` 键，标识写入是否成功。
+
+        Example:
+            在流水线 `reply_message_chunk` 调用中自动触发，无需手动调用。
+        """
+        # 转换为纯文本（智能机器人当前协议仅支持文本流）
         content = await self.message_converter.yiri2target(message)
         msg_id = message_source.source_platform_object.message_id
-        _ws_mode = not self.config.get('enable-webhook', False)
 
-        if _ws_mode:
-            success = await self.bot.push_stream_chunk(msg_id, content, is_final=is_final)
-            if not success and is_final:
-                event = message_source.source_platform_object
-                req_id = event.get('req_id', '')
-                if req_id:
-                    await self.bot.reply_text(req_id, content)
-            return {'stream': success}
-        else:
-            success = await self.bot.push_stream_chunk(msg_id, content, is_final=is_final)
-            if not success and is_final:
-                await self.bot.set_message(msg_id, content)
-            return {'stream': success}
+        # 将片段推送到 WecomBotClient 中的队列，返回值用于判断是否走降级逻辑
+        success = await self.bot.push_stream_chunk(msg_id, content, is_final=is_final)
+        if not success and is_final:
+            # 未命中流式队列时使用旧有 set_message 兜底
+            await self.bot.set_message(msg_id, content)
+        return {'stream': success}
 
     async def is_stream_output_supported(self) -> bool:
-        """Whether streaming output is enabled for this bot instance."""
-        return self.config.get('enable-stream-reply', True)
+        """智能机器人侧默认开启流式能力。
+
+        Returns:
+            bool: 恒定返回 True。
+
+        Example:
+            流水线执行阶段会调用此方法以确认是否启用流式。"""
+        return True
 
     async def send_message(self, target_type, target_id, message):
-        _ws_mode = not self.config.get('enable-webhook', False)
-        if _ws_mode:
-            content = await self.message_converter.yiri2target(message)
-            await self.bot.send_message(target_id, content)
-        else:
-            pass
-
-    async def on_message(self, event: WecomBotEvent):
-        try:
-            lb_event = await self.event_converter.target2yiri(event)
-            if lb_event:
-                await self.listeners[type(lb_event)](lb_event, self)
-        except Exception:
-            await self.logger.error(f'Error in wecombot callback: {traceback.format_exc()}')
-            print(traceback.format_exc())
+        pass
 
     def register_listener(
         self,
@@ -304,13 +268,18 @@ class WecomBotAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
             [platform_events.Event, abstract_platform_adapter.AbstractMessagePlatformAdapter], None
         ],
     ):
-        self.listeners[event_type] = callback
+        async def on_message(event: WecomBotEvent):
+            try:
+                return await callback(await self.event_converter.target2yiri(event), self)
+            except Exception:
+                await self.logger.error(f'Error in wecombot callback: {traceback.format_exc()}')
+                print(traceback.format_exc())
 
         try:
             if event_type == platform_events.FriendMessage:
-                self.bot.on_message('single')(self.on_message)
+                self.bot.on_message('single')(on_message)
             elif event_type == platform_events.GroupMessage:
-                self.bot.on_message('group')(self.on_message)
+                self.bot.on_message('group')(on_message)
         except Exception:
             print(traceback.format_exc())
 
@@ -319,28 +288,29 @@ class WecomBotAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
         self.bot_uuid = bot_uuid
 
     async def handle_unified_webhook(self, bot_uuid: str, path: str, request):
-        _ws_mode = not self.config.get('enable-webhook', False)
-        if _ws_mode:
-            return None
+        """处理统一 webhook 请求。
+
+        Args:
+            bot_uuid: Bot 的 UUID
+            path: 子路径（如果有的话）
+            request: Quart Request 对象
+
+        Returns:
+            响应数据
+        """
         return await self.bot.handle_unified_webhook(request)
 
     async def run_async(self):
-        _ws_mode = not self.config.get('enable-webhook', False)
-        if _ws_mode:
-            await self.bot.connect()
-        else:
+        # 统一 webhook 模式下，不启动独立的 Quart 应用
+        # 保持运行但不启动独立端口
 
-            async def keep_alive():
-                while True:
-                    await asyncio.sleep(1)
+        async def keep_alive():
+            while True:
+                await asyncio.sleep(1)
 
-            await keep_alive()
+        await keep_alive()
 
     async def kill(self) -> bool:
-        _ws_mode = not self.config.get('enable-webhook', False)
-        if _ws_mode:
-            await self.bot.disconnect()
-            return True
         return False
 
     async def unregister_listener(

src/langbot/pkg/platform/sources/wecombot.yaml

@@ -11,93 +11,35 @@ metadata:
   icon: wecombot.png
 spec:
   config:
-    - name: BotId
-      label:
-        en_US: BotId
-        zh_Hans: 机器人ID (BotId)
-      type: string
-      required: true
-      default: ""
-    - name: robot_name
-      label:
-        en_US: Robot Name
-        zh_Hans: 机器人名称
-      type: string
-      required: true
-      default: ""
-    - name: enable-webhook
-      label:
-        en_US: Enable Webhook Mode
-        zh_Hans: 启用Webhook模式
-      description:
-        en_US: If enabled, the bot will use webhook mode to receive messages. Otherwise, it will use WS long connection mode
-        zh_Hans: 如果启用，机器人将使用 Webhook 模式接收消息。否则，将使用 WS 长连接模式
-      type: boolean
-      required: true
-      default: false
-    - name: Secret
-      label:
-        en_US: Secret
-        zh_Hans: 机器人密钥 (Secret)
-      description:
-        en_US: Required for WebSocket long connection mode
-        zh_Hans: 使用 WS 长连接模式时必填
-      type: string
-      required: false
-      default: ""
     - name: Corpid
       label:
         en_US: Corpid
         zh_Hans: 企业ID
-      description:
-        en_US: Required for Webhook mode
-        zh_Hans: 使用 Webhook 模式时必填
       type: string
-      required: false
+      required: true
       default: ""
-      show_if:
-        field: enable-webhook
-        operator: eq
-        value: true
     - name: Token
       label:
         en_US: Token
         zh_Hans: 令牌 (Token)
-      description:
-        en_US: Required for Webhook mode
-        zh_Hans: 使用 Webhook 模式时必填
       type: string
-      required: false
+      required: true
       default: ""
-      show_if:
-        field: enable-webhook
-        operator: eq
-        value: true
     - name: EncodingAESKey
       label:
         en_US: EncodingAESKey
         zh_Hans: 消息加解密密钥 (EncodingAESKey)
-      description:
-        en_US: Required for Webhook mode. Optional for WebSocket mode (used for file decryption)
-        zh_Hans: 使用 Webhook 模式时必填。WebSocket 模式下可选（用于文件解密）
+      type: string
+      required: true
+      default: ""
+    - name: BotId
+      label:
+        en_US: BotId
+        zh_Hans: 机器人ID
       type: string
       required: false
       default: ""
-      show_if:
-        field: enable-webhook
-        operator: eq
-        value: true
-    - name: enable-stream-reply
-      label:
-        en_US: Enable Stream Reply
-        zh_Hans: 启用流式回复
-      description:
-        en_US: If enabled, the bot will use streaming mode to reply messages
-        zh_Hans: 如果启用，机器人将使用流式模式回复消息
-      type: boolean
-      required: false
-      default: true
 execution:
   python:
     path: ./wecombot.py
-    attr: WecomBotAdapter
+    attr: WecomBotAdapter

src/langbot/pkg/platform/sources/wecomcs.py

@@ -81,33 +81,22 @@ class WecomEventConverter(abstract_platform_adapter.AbstractEventConverter):
             return event.source_platform_object
 
     @staticmethod
-    async def target2yiri(event: WecomCSEvent, bot: WecomCSClient = None):
+    async def target2yiri(event: WecomCSEvent):
         """
         将 WecomEvent 转换为平台的 FriendMessage 对象。
 
         Args:
             event (WecomEvent): 企业微信客服事件。
-            bot (WecomCSClient): 企业微信客服客户端，用于获取用户信息。
 
         Returns:
             platform_events.FriendMessage: 转换后的 FriendMessage 对象。
         """
-        # Try to get customer nickname from WeChat API
-        nickname = str(event.user_id)
-        if bot and event.user_id:
-            try:
-                customer_info = await bot.get_customer_info(event.user_id)
-                if customer_info and customer_info.get('nickname'):
-                    nickname = customer_info.get('nickname')
-            except Exception:
-                pass  # Fall back to user_id as nickname
-
         # 转换消息链
         if event.type == 'text':
             yiri_chain = await WecomMessageConverter.target2yiri(event.message, event.message_id)
             friend = platform_entities.Friend(
                 id=f'u{event.user_id}',
-                nickname=nickname,
+                nickname=str(event.user_id),
                 remark='',
             )
 
@@ -117,7 +106,7 @@ class WecomEventConverter(abstract_platform_adapter.AbstractEventConverter):
         elif event.type == 'image':
             friend = platform_entities.Friend(
                 id=f'u{event.user_id}',
-                nickname=nickname,
+                nickname=str(event.user_id),
                 remark='',
             )
 
@@ -198,7 +187,7 @@ class WecomCSAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
         async def on_message(event: WecomCSEvent):
             self.bot_account_id = event.receiver_id
             try:
-                return await callback(await self.event_converter.target2yiri(event, self.bot), self)
+                return await callback(await self.event_converter.target2yiri(event), self)
             except Exception:
                 await self.logger.error(f'Error in wecomcs callback: {traceback.format_exc()}')
 

src/langbot/pkg/plugin/handler.py

@@ -314,11 +314,11 @@ class RuntimeConnectionHandler(handler.Handler):
 
         @self.action(PluginToRuntimeAction.GET_LLM_MODELS)
         async def get_llm_models(data: dict[str, Any]) -> handler.ActionResponse:
-            """Get llm models, returns list of UUID strings"""
+            """Get llm models"""
             llm_models = await self.ap.llm_model_service.get_llm_models(include_secret=False)
             return handler.ActionResponse.success(
                 data={
-                    'llm_models': [m['uuid'] for m in llm_models],
+                    'llm_models': llm_models,
                 },
             )
 
@@ -531,7 +531,6 @@ class RuntimeConnectionHandler(handler.Handler):
             filters = data.get('filters')
             search_type = data.get('search_type', 'vector')
             query_text = data.get('query_text', '')
-            vector_weight = data.get('vector_weight')
             try:
                 results = await self.ap.rag_runtime_service.vector_search(
                     collection_id,
@@ -540,7 +539,6 @@ class RuntimeConnectionHandler(handler.Handler):
                     filters,
                     search_type,
                     query_text,
-                    vector_weight=vector_weight,
                 )
                 return handler.ActionResponse.success(data={'results': results})
             except Exception as e:
@@ -557,18 +555,6 @@ class RuntimeConnectionHandler(handler.Handler):
             except Exception as e:
                 return _make_rag_error_response(e, 'VectorStoreError', collection_id=collection_id)
 
-        @self.action(PluginToRuntimeAction.VECTOR_LIST)
-        async def vector_list(data: dict[str, Any]) -> handler.ActionResponse:
-            collection_id = data['collection_id']
-            filters = data.get('filters')
-            limit = data.get('limit', 20)
-            offset = data.get('offset', 0)
-            try:
-                items, total = await self.ap.rag_runtime_service.vector_list(collection_id, filters, limit, offset)
-                return handler.ActionResponse.success(data={'items': items, 'total': total})
-            except Exception as e:
-                return _make_rag_error_response(e, 'VectorStoreError', collection_id=collection_id)
-
         @self.action(PluginToRuntimeAction.GET_KNOWLEDEGE_FILE_STREAM)
         async def get_knowledge_file_stream(data: dict[str, Any]) -> handler.ActionResponse:
             storage_path = data['storage_path']
@@ -579,16 +565,6 @@ class RuntimeConnectionHandler(handler.Handler):
             except Exception as e:
                 return _make_rag_error_response(e, 'FileServiceError', storage_path=storage_path)
 
-        @self.action(PluginToRuntimeAction.LIST_PARSERS)
-        async def list_parsers(data: dict[str, Any]) -> handler.ActionResponse:
-            """Plugin requests host to list available parser plugins."""
-            mime_type = data.get('mime_type')
-            try:
-                parsers = await self.ap.knowledge_service.list_parsers(mime_type)
-                return handler.ActionResponse.success(data={'parsers': parsers})
-            except Exception as e:
-                return _make_rag_error_response(e, 'ParserDiscoveryError', mime_type=mime_type)
-
         @self.action(PluginToRuntimeAction.INVOKE_PARSER)
         async def invoke_parser(data: dict[str, Any]) -> handler.ActionResponse:
             """Plugin requests host to invoke a parser plugin."""
@@ -613,139 +589,6 @@ class RuntimeConnectionHandler(handler.Handler):
             except Exception as e:
                 return _make_rag_error_response(e, 'ParserError')
 
-        # ================= Knowledge Base Query APIs =================
-
-        @self.action(PluginToRuntimeAction.LIST_KNOWLEDGE_BASES)
-        async def list_knowledge_bases(data: dict[str, Any]) -> handler.ActionResponse:
-            """List all knowledge bases available in the LangBot instance (unrestricted)."""
-            knowledge_bases = []
-            for kb_uuid, kb in self.ap.rag_mgr.knowledge_bases.items():
-                knowledge_bases.append(
-                    {
-                        'uuid': kb.get_uuid(),
-                        'name': kb.get_name(),
-                        'description': kb.knowledge_base_entity.description or '',
-                    }
-                )
-            return handler.ActionResponse.success(data={'knowledge_bases': knowledge_bases})
-
-        @self.action(PluginToRuntimeAction.RETRIEVE_KNOWLEDGE)
-        async def retrieve_knowledge(data: dict[str, Any]) -> handler.ActionResponse:
-            """Retrieve documents from any knowledge base (unrestricted)."""
-            kb_id = data['kb_id']
-            query_text = data['query_text']
-            top_k = data.get('top_k', 5)
-            filters = data.get('filters', {})
-
-            kb = await self.ap.rag_mgr.get_knowledge_base_by_uuid(kb_id)
-            if not kb:
-                return handler.ActionResponse.error(
-                    message=f'Knowledge base {kb_id} not found',
-                )
-
-            try:
-                entries = await kb.retrieve(
-                    query_text,
-                    settings={
-                        'top_k': top_k,
-                        'filters': filters,
-                    },
-                )
-                results = [entry.model_dump(mode='json') for entry in entries]
-                return handler.ActionResponse.success(data={'results': results})
-            except Exception as e:
-                return _make_rag_error_response(e, 'RetrievalError', kb_id=kb_id)
-
-        @self.action(PluginToRuntimeAction.LIST_PIPELINE_KNOWLEDGE_BASES)
-        async def list_pipeline_knowledge_bases(data: dict[str, Any]) -> handler.ActionResponse:
-            """List knowledge bases configured for the current query's pipeline."""
-            query_id = data['query_id']
-
-            if query_id not in self.ap.query_pool.cached_queries:
-                return handler.ActionResponse.error(
-                    message=f'Query with query_id {query_id} not found',
-                )
-
-            query = self.ap.query_pool.cached_queries[query_id]
-
-            kb_uuids = []
-            if query.pipeline_config:
-                local_agent_config = query.pipeline_config.get('ai', {}).get('local-agent', {})
-                kb_uuids = local_agent_config.get('knowledge-bases', [])
-                # Backward compatibility
-                if not kb_uuids:
-                    old_kb_uuid = local_agent_config.get('knowledge-base', '')
-                    if old_kb_uuid and old_kb_uuid != '__none__':
-                        kb_uuids = [old_kb_uuid]
-
-            knowledge_bases = []
-            for kb_uuid in kb_uuids:
-                kb = await self.ap.rag_mgr.get_knowledge_base_by_uuid(kb_uuid)
-                if kb:
-                    knowledge_bases.append(
-                        {
-                            'uuid': kb.get_uuid(),
-                            'name': kb.get_name(),
-                            'description': kb.knowledge_base_entity.description or '',
-                        }
-                    )
-
-            return handler.ActionResponse.success(data={'knowledge_bases': knowledge_bases})
-
-        @self.action(PluginToRuntimeAction.RETRIEVE_KNOWLEDGE_BASE)
-        async def retrieve_knowledge_base(data: dict[str, Any]) -> handler.ActionResponse:
-            """Retrieve documents from a knowledge base within the pipeline's scope."""
-            query_id = data['query_id']
-            kb_id = data['kb_id']
-            query_text = data['query_text']
-            top_k = data.get('top_k', 5)
-            filters = data.get('filters', {})
-
-            if query_id not in self.ap.query_pool.cached_queries:
-                return handler.ActionResponse.error(
-                    message=f'Query with query_id {query_id} not found',
-                )
-
-            query = self.ap.query_pool.cached_queries[query_id]
-
-            # Validate kb_id is in pipeline's allowed list
-            allowed_kb_uuids = []
-            if query.pipeline_config:
-                local_agent_config = query.pipeline_config.get('ai', {}).get('local-agent', {})
-                allowed_kb_uuids = local_agent_config.get('knowledge-bases', [])
-                if not allowed_kb_uuids:
-                    old_kb_uuid = local_agent_config.get('knowledge-base', '')
-                    if old_kb_uuid and old_kb_uuid != '__none__':
-                        allowed_kb_uuids = [old_kb_uuid]
-
-            if kb_id not in allowed_kb_uuids:
-                return handler.ActionResponse.error(
-                    message=f'Knowledge base {kb_id} is not configured for this pipeline',
-                )
-
-            kb = await self.ap.rag_mgr.get_knowledge_base_by_uuid(kb_id)
-            if not kb:
-                return handler.ActionResponse.error(
-                    message=f'Knowledge base {kb_id} not found',
-                )
-
-            try:
-                session_name = f'{query.session.launcher_type.value}_{query.session.launcher_id}'
-                entries = await kb.retrieve(
-                    query_text,
-                    settings={
-                        'top_k': top_k,
-                        'filters': filters,
-                        'session_name': session_name,
-                        'bot_uuid': query.bot_uuid or '',
-                        'sender_id': str(query.sender_id),
-                    },
-                )
-                results = [entry.model_dump(mode='json') for entry in entries]
-                return handler.ActionResponse.success(data={'results': results})
-            except Exception as e:
-                return _make_rag_error_response(e, 'RetrievalError', kb_id=kb_id)
-
         @self.action(CommonAction.PING)
         async def ping(data: dict[str, Any]) -> handler.ActionResponse:
             """Ping"""
@@ -1052,7 +895,7 @@ class RuntimeConnectionHandler(handler.Handler):
         result = await self.call_action(
             LangBotToRuntimeAction.RAG_INGEST_DOCUMENT,
             {'plugin_author': plugin_author, 'plugin_name': plugin_name, 'context': context_data},
-            timeout=1200,  # Ingestion can be slow for large documents
+            timeout=300,  # Ingestion can be slow
         )
         return result
 

src/langbot/pkg/provider/modelmgr/requesters/anthropicmsgs.py

@@ -288,10 +288,10 @@ class AnthropicMessages(requester.ProviderAPIRequester):
             think_started = False
             think_ended = False
             finish_reason = False
+            content = ''
             tool_name = ''
             tool_id = ''
             async for chunk in await self.client.messages.create(**args):
-                content = ''
                 tool_call = {'id': None, 'function': {'name': None, 'arguments': None}, 'type': 'function'}
                 if isinstance(
                     chunk, anthropic.types.raw_content_block_start_event.RawContentBlockStartEvent

src/langbot/pkg/provider/runners/difysvapi.py

@@ -441,7 +441,6 @@ class DifyServiceAPIRunner(runner.RequestRunner):
         is_final = False
         think_start = False
         think_end = False
-        yielded_final = False
 
         remove_think = self.pipeline_config['output'].get('misc', '').get('remove-think')
 
@@ -494,19 +493,13 @@ class DifyServiceAPIRunner(runner.RequestRunner):
                     if answer:
                         basic_mode_pending_chunk = answer
 
-            if (
-                not yielded_final
-                and (is_final or message_idx % 8 == 0)
-                and (basic_mode_pending_chunk != '' or is_final)
-            ):
+            if (is_final or message_idx % 8 == 0) and (basic_mode_pending_chunk != '' or is_final):
                 # content, _ = self._process_thinking_content(basic_mode_pending_chunk)
                 yield provider_message.MessageChunk(
                     role='assistant',
                     content=basic_mode_pending_chunk,
                     is_final=is_final,
                 )
-                if is_final:
-                    yielded_final = True
 
         if chunk is None:
             raise errors.DifyAPIError('Dify API 没有返回任何响应，请检查网络连接和API配置')

src/langbot/pkg/provider/runners/localagent.py

@@ -4,7 +4,6 @@ import json
 import copy
 import typing
 from .. import runner
-from ..modelmgr import requester as modelmgr_requester
 import langbot_plugin.api.entities.builtin.pipeline.query as pipeline_query
 import langbot_plugin.api.entities.builtin.provider.message as provider_message
 import langbot_plugin.api.entities.builtin.rag.context as rag_context
@@ -27,114 +26,29 @@ Respond in the same language as the user's input.
 
 @runner.runner_class('local-agent')
 class LocalAgentRunner(runner.RequestRunner):
-    """Local agent request runner"""
+    """本地Agent请求运行器"""
 
-    async def _get_model_candidates(
-        self,
-        query: pipeline_query.Query,
-    ) -> list[modelmgr_requester.RuntimeLLMModel]:
-        """Build ordered list of models to try: primary model + fallback models."""
-        candidates = []
+    class ToolCallTracker:
+        """工具调用追踪器"""
 
-        # Primary model
-        if query.use_llm_model_uuid:
-            try:
-                primary = await self.ap.model_mgr.get_model_by_uuid(query.use_llm_model_uuid)
-                candidates.append(primary)
-            except ValueError:
-                self.ap.logger.warning(f'Primary model {query.use_llm_model_uuid} not found')
-
-        # Fallback models
-        fallback_uuids = (query.variables or {}).get('_fallback_model_uuids', [])
-        for fb_uuid in fallback_uuids:
-            try:
-                fb_model = await self.ap.model_mgr.get_model_by_uuid(fb_uuid)
-                candidates.append(fb_model)
-            except ValueError:
-                self.ap.logger.warning(f'Fallback model {fb_uuid} not found, skipping')
-
-        return candidates
-
-    async def _invoke_with_fallback(
-        self,
-        query: pipeline_query.Query,
-        candidates: list[modelmgr_requester.RuntimeLLMModel],
-        messages: list,
-        funcs: list,
-        remove_think: bool,
-    ) -> tuple[provider_message.Message, modelmgr_requester.RuntimeLLMModel]:
-        """Try non-streaming invocation with sequential fallback. Returns (message, model_used)."""
-        last_error = None
-        for model in candidates:
-            try:
-                msg = await model.provider.invoke_llm(
-                    query,
-                    model,
-                    messages,
-                    funcs if model.model_entity.abilities.__contains__('func_call') else [],
-                    extra_args=model.model_entity.extra_args,
-                    remove_think=remove_think,
-                )
-                return msg, model
-            except Exception as e:
-                last_error = e
-                self.ap.logger.warning(f'Model {model.model_entity.name} failed: {e}, trying next fallback...')
-        raise last_error or RuntimeError('No model candidates available')
-
-    async def _invoke_stream_with_fallback(
-        self,
-        query: pipeline_query.Query,
-        candidates: list[modelmgr_requester.RuntimeLLMModel],
-        messages: list,
-        funcs: list,
-        remove_think: bool,
-    ) -> tuple[typing.AsyncGenerator, modelmgr_requester.RuntimeLLMModel]:
-        """Try streaming invocation with sequential fallback. Returns (stream_generator, model_used).
-
-        Fallback is only possible before any chunks have been yielded to the client.
-        Once streaming starts, the model is committed.
-        """
-        last_error = None
-        for model in candidates:
-            try:
-                stream = model.provider.invoke_llm_stream(
-                    query,
-                    model,
-                    messages,
-                    funcs if model.model_entity.abilities.__contains__('func_call') else [],
-                    extra_args=model.model_entity.extra_args,
-                    remove_think=remove_think,
-                )
-                # Attempt to get the first chunk to verify the stream works
-                first_chunk = await stream.__anext__()
-
-                async def _chain_stream(first, rest):
-                    yield first
-                    async for chunk in rest:
-                        yield chunk
-
-                return _chain_stream(first_chunk, stream), model
-            except StopAsyncIteration:
-                # Empty stream — treat as success (model returned nothing)
-                async def _empty_stream():
-                    return
-                    yield  # make it a generator
-
-                return _empty_stream(), model
-            except Exception as e:
-                last_error = e
-                self.ap.logger.warning(f'Model {model.model_entity.name} stream failed: {e}, trying next fallback...')
-        raise last_error or RuntimeError('No model candidates available')
+        def __init__(self):
+            self.active_calls: dict[str, dict] = {}
+            self.completed_calls: list[provider_message.ToolCall] = []
 
     async def run(
         self, query: pipeline_query.Query
     ) -> typing.AsyncGenerator[provider_message.Message | provider_message.MessageChunk, None]:
-        """Run request"""
+        """运行请求"""
         pending_tool_calls = []
 
-        # Get knowledge bases list from query variables (set by PreProcessor,
-        # may have been modified by plugins during PromptPreProcessing)
-        kb_uuids = query.variables.get('_knowledge_base_uuids', [])
+        # Get knowledge bases list (new field)
+        kb_uuids = query.pipeline_config['ai']['local-agent'].get('knowledge-bases', [])
+
+        # Fallback to old field for backward compatibility
+        if not kb_uuids:
+            old_kb_uuid = query.pipeline_config['ai']['local-agent'].get('knowledge-base', '')
+            if old_kb_uuid and old_kb_uuid != '__none__':
+                kb_uuids = [old_kb_uuid]
 
         user_message = copy.deepcopy(query.user_message)
 
@@ -160,14 +74,7 @@ class LocalAgentRunner(runner.RequestRunner):
                     self.ap.logger.warning(f'Knowledge base {kb_uuid} not found, skipping')
                     continue
 
-                result = await kb.retrieve(
-                    user_message_text,
-                    settings={
-                        'bot_uuid': query.bot_uuid or '',
-                        'sender_id': str(query.sender_id),
-                        'session_name': f'{query.session.launcher_type.value}_{query.session.launcher_id}',
-                    },
-                )
+                result = await kb.retrieve(user_message_text)
 
                 if result:
                     all_results.extend(result)
@@ -206,51 +113,51 @@ class LocalAgentRunner(runner.RequestRunner):
 
         remove_think = query.pipeline_config['output'].get('misc', '').get('remove-think')
 
-        # Build ordered candidate list (primary + fallbacks)
-        candidates = await self._get_model_candidates(query)
-        if not candidates:
-            raise RuntimeError('No LLM model configured for local-agent runner')
+        use_llm_model = await self.ap.model_mgr.get_model_by_uuid(query.use_llm_model_uuid)
 
         self.ap.logger.debug(
-            f'localagent req: query={query.query_id} req_messages={req_messages} '
-            f'candidates={[m.model_entity.name for m in candidates]}'
+            f'localagent req: query={query.query_id} req_messages={req_messages} use_llm_model={query.use_llm_model_uuid}'
         )
 
         if not is_stream:
-            # Non-streaming: invoke with fallback
-            msg, use_llm_model = await self._invoke_with_fallback(
+            # 非流式输出，直接请求
+
+            msg = await use_llm_model.provider.invoke_llm(
                 query,
-                candidates,
+                use_llm_model,
                 req_messages,
                 query.use_funcs,
-                remove_think,
+                extra_args=use_llm_model.model_entity.extra_args,
+                remove_think=remove_think,
             )
             yield msg
             final_msg = msg
         else:
-            # Streaming: invoke with fallback
+            # 流式输出，需要处理工具调用
             tool_calls_map: dict[str, provider_message.ToolCall] = {}
             msg_idx = 0
-            accumulated_content = ''
+            accumulated_content = ''  # 从开始累积的所有内容
             last_role = 'assistant'
             msg_sequence = 1
-
-            stream_src, use_llm_model = await self._invoke_stream_with_fallback(
+            async for msg in use_llm_model.provider.invoke_llm_stream(
                 query,
-                candidates,
+                use_llm_model,
                 req_messages,
                 query.use_funcs,
-                remove_think,
-            )
-            async for msg in stream_src:
+                extra_args=use_llm_model.model_entity.extra_args,
+                remove_think=remove_think,
+            ):
                 msg_idx = msg_idx + 1
 
+                # 记录角色
                 if msg.role:
                     last_role = msg.role
 
+                # 累积内容
                 if msg.content:
                     accumulated_content += msg.content
 
+                # 处理工具调用
                 if msg.tool_calls:
                     for tool_call in msg.tool_calls:
                         if tool_call.id not in tool_calls_map:
@@ -262,18 +169,21 @@ class LocalAgentRunner(runner.RequestRunner):
                                 ),
                             )
                         if tool_call.function and tool_call.function.arguments:
+                            # 流式处理中，工具调用参数可能分多个chunk返回，需要追加而不是覆盖
                             tool_calls_map[tool_call.id].function.arguments += tool_call.function.arguments
-
+                # continue
+                # 每8个chunk或最后一个chunk时，输出所有累积的内容
                 if msg_idx % 8 == 0 or msg.is_final:
                     msg_sequence += 1
                     yield provider_message.MessageChunk(
                         role=last_role,
-                        content=accumulated_content,
+                        content=accumulated_content,  # 输出所有累积内容
                         tool_calls=list(tool_calls_map.values()) if (tool_calls_map and msg.is_final) else None,
                         is_final=msg.is_final,
                         msg_sequence=msg_sequence,
                     )
 
+            # 创建最终消息用于后续处理
             final_msg = provider_message.MessageChunk(
                 role=last_role,
                 content=accumulated_content,
@@ -288,8 +198,7 @@ class LocalAgentRunner(runner.RequestRunner):
 
         req_messages.append(final_msg)
 
-        # Once a model succeeds, commit to it for the tool call loop
-        # (no fallback mid-conversation — different models may interpret tool results differently)
+        # 持续请求，只要还有待处理的工具调用就继续处理调用
         while pending_tool_calls:
             for tool_call in pending_tool_calls:
                 try:
@@ -330,6 +239,7 @@ class LocalAgentRunner(runner.RequestRunner):
 
                     req_messages.append(msg)
                 except Exception as e:
+                    # 工具调用出错，添加一个报错信息到 req_messages
                     err_msg = provider_message.Message(role='tool', content=f'err: {e}', tool_call_id=tool_call.id)
 
                     yield err_msg
@@ -337,38 +247,39 @@ class LocalAgentRunner(runner.RequestRunner):
                     req_messages.append(err_msg)
 
             self.ap.logger.debug(
-                f'localagent req: query={query.query_id} req_messages={req_messages} '
-                f'use_llm_model={use_llm_model.model_entity.name}'
+                f'localagent req: query={query.query_id} req_messages={req_messages} use_llm_model={query.use_llm_model_uuid}'
             )
 
             if is_stream:
                 tool_calls_map = {}
                 msg_idx = 0
-                accumulated_content = ''
+                accumulated_content = ''  # 从开始累积的所有内容
                 last_role = 'assistant'
                 msg_sequence = first_end_sequence
 
-                tool_stream_src = use_llm_model.provider.invoke_llm_stream(
+                async for msg in use_llm_model.provider.invoke_llm_stream(
                     query,
                     use_llm_model,
                     req_messages,
-                    query.use_funcs if use_llm_model.model_entity.abilities.__contains__('func_call') else [],
+                    query.use_funcs,
                     extra_args=use_llm_model.model_entity.extra_args,
                     remove_think=remove_think,
-                )
-                async for msg in tool_stream_src:
+                ):
                     msg_idx += 1
 
+                    # 记录角色
                     if msg.role:
                         last_role = msg.role
 
-                    # Prepend first-round content on first chunk of tool-call round
+                    # 第一次请求工具调用时的内容
                     if msg_idx == 1:
                         accumulated_content = first_content if first_content is not None else accumulated_content
 
+                    # 累积内容
                     if msg.content:
                         accumulated_content += msg.content
 
+                    # 处理工具调用
                     if msg.tool_calls:
                         for tool_call in msg.tool_calls:
                             if tool_call.id not in tool_calls_map:
@@ -380,13 +291,15 @@ class LocalAgentRunner(runner.RequestRunner):
                                     ),
                                 )
                             if tool_call.function and tool_call.function.arguments:
+                                # 流式处理中，工具调用参数可能分多个chunk返回，需要追加而不是覆盖
                                 tool_calls_map[tool_call.id].function.arguments += tool_call.function.arguments
 
+                    # 每8个chunk或最后一个chunk时，输出所有累积的内容
                     if msg_idx % 8 == 0 or msg.is_final:
                         msg_sequence += 1
                         yield provider_message.MessageChunk(
                             role=last_role,
-                            content=accumulated_content,
+                            content=accumulated_content,  # 输出所有累积内容
                             tool_calls=list(tool_calls_map.values()) if (tool_calls_map and msg.is_final) else None,
                             is_final=msg.is_final,
                             msg_sequence=msg_sequence,
@@ -399,12 +312,12 @@ class LocalAgentRunner(runner.RequestRunner):
                     msg_sequence=msg_sequence,
                 )
             else:
-                # Non-streaming: use committed model directly (no fallback in tool loop)
+                # 处理完所有调用，再次请求
                 msg = await use_llm_model.provider.invoke_llm(
                     query,
                     use_llm_model,
                     req_messages,
-                    query.use_funcs if use_llm_model.model_entity.abilities.__contains__('func_call') else [],
+                    query.use_funcs,
                     extra_args=use_llm_model.model_entity.extra_args,
                     remove_think=remove_think,
                 )

src/langbot/pkg/rag/knowledge/kbmgr.py

@@ -321,19 +321,13 @@ class RuntimeKnowledgeBase(KnowledgeBaseInterface):
         if not plugin_id:
             raise ValueError(f'No RAG plugin ID configured for KB {kb.uuid}. Retrieval failed.')
 
-        # Session context (e.g. session_name) stays in retrieval_settings
-        # for plugins that need it. Do NOT move them into filters, as filters
-        # are passed directly to vector_search by some plugins (e.g. LangRAG)
-        # and would cause empty results when the metadata field doesn't exist.
-        filters = settings.pop('filters', {})
-
         retrieval_context = {
             'query': query,
             'knowledge_base_id': kb.uuid,
             'collection_id': kb.collection_id or kb.uuid,
             'retrieval_settings': settings,
             'creation_settings': kb.creation_settings or {},
-            'filters': filters,
+            'filters': settings.pop('filters', {}),
         }
 
         result = await self.ap.plugin_connector.call_rag_retrieve(

src/langbot/pkg/rag/service/runtime.py

@@ -41,7 +41,6 @@ class RAGRuntimeService:
         filters: dict[str, Any] | None = None,
         search_type: str = 'vector',
         query_text: str = '',
-        vector_weight: float | None = None,
     ) -> list[dict[str, Any]]:
         """Handle VECTOR_SEARCH action."""
         return await self.ap.vector_db_mgr.search(
@@ -51,7 +50,6 @@ class RAGRuntimeService:
             filter=filters,
             search_type=search_type,
             query_text=query_text,
-            vector_weight=vector_weight,
         )
 
     async def vector_delete(
@@ -77,31 +75,6 @@ class RAGRuntimeService:
             count = await self.ap.vector_db_mgr.delete_by_filter(collection_name=collection_id, filter=filters)
         return count
 
-    async def vector_list(
-        self,
-        collection_id: str,
-        filters: dict[str, Any] | None = None,
-        limit: int = 20,
-        offset: int = 0,
-    ) -> tuple[list[dict[str, Any]], int]:
-        """Handle VECTOR_LIST action.
-
-        Args:
-            collection_id: The collection to list from.
-            filters: Optional metadata filters.
-            limit: Maximum number of items to return.
-            offset: Number of items to skip.
-
-        Returns:
-            Tuple of (items, total).
-        """
-        return await self.ap.vector_db_mgr.list_by_filter(
-            collection_name=collection_id,
-            filter=filters,
-            limit=limit,
-            offset=offset,
-        )
-
     async def get_file_stream(self, storage_path: str) -> bytes:
         """Handle GET_KNOWLEDEGE_FILE_STREAM action.
 

src/langbot/pkg/utils/constants.py

@@ -2,7 +2,7 @@ import langbot
 
 semantic_version = f'v{langbot.__version__}'
 
-required_database_version = 24
+required_database_version = 20
 """Tag the version of the database schema, used to check if the database needs to be migrated"""
 
 debug_mode = False

src/langbot/pkg/vector/filter_utils.py

@@ -49,25 +49,17 @@ def normalize_filter(
 def strip_unsupported_fields(
     triples: list[tuple[str, str, Any]],
     supported_fields: set[str],
-    field_aliases: dict[str, str] | None = None,
 ) -> list[tuple[str, str, Any]]:
     """Return only triples whose field is in *supported_fields*.
 
-    If *field_aliases* is provided, aliased field names are mapped to the
-    canonical backend name before the support check.  For example,
-    ``{'uuid': 'chunk_uuid'}`` allows callers to use ``uuid`` which is
-    transparently rewritten to ``chunk_uuid``.
-
     Dropped fields are logged at WARNING level so the caller knows they were
     silently ignored (useful for Milvus / pgvector which only store a fixed
     schema).
     """
-    aliases = field_aliases or {}
     kept: list[tuple[str, str, Any]] = []
     for field, op, value in triples:
-        resolved = aliases.get(field, field)
-        if resolved in supported_fields:
-            kept.append((resolved, op, value))
+        if field in supported_fields:
+            kept.append((field, op, value))
         else:
             logger.warning(
                 'Filter field %r is not supported by this backend and will be ignored (supported: %s)',

src/langbot/pkg/vector/mgr.py

@@ -97,11 +97,10 @@ class VectorDBManager:
         filter: dict | None = None,
         search_type: str = 'vector',
         query_text: str = '',
-        vector_weight: float | None = None,
     ) -> list[dict]:
         """Proxy: Search vectors.
 
-        Returns a list of dicts with keys: 'id', 'distance', 'metadata'.
+        Returns a list of dicts with keys: 'id', 'score', 'metadata'.
         The underlying VectorDatabase.search returns Chroma-style format:
         { 'ids': [['id1']], 'distances': [[0.1]], 'metadatas': [[{}]] }
         """
@@ -112,7 +111,6 @@ class VectorDBManager:
             search_type=search_type,
             query_text=query_text,
             filter=filter,
-            vector_weight=vector_weight,
         )
 
         if not results or 'ids' not in results or not results['ids']:
@@ -132,7 +130,7 @@ class VectorDBManager:
             parsed_results.append(
                 {
                     'id': id_val,
-                    'distance': r_dists[i] if r_dists and i < len(r_dists) else 0.0,
+                    'score': r_dists[i] if r_dists and i < len(r_dists) else 0.0,
                     'metadata': r_metas[i] if r_metas and i < len(r_metas) else {},
                 }
             )
@@ -159,17 +157,3 @@ class VectorDBManager:
             Number of deleted vectors (best-effort; some backends return 0).
         """
         return await self.vector_db.delete_by_filter(collection_name, filter)
-
-    async def list_by_filter(
-        self,
-        collection_name: str,
-        filter: dict | None = None,
-        limit: int = 20,
-        offset: int = 0,
-    ) -> tuple[list[dict], int]:
-        """Proxy: List vectors by metadata filter with pagination.
-
-        Returns:
-            Tuple of (items, total).
-        """
-        return await self.vector_db.list_by_filter(collection_name, filter, limit, offset)

src/langbot/pkg/vector/vdb.py

@@ -53,7 +53,6 @@ class VectorDatabase(abc.ABC):
         search_type: str = 'vector',
         query_text: str = '',
         filter: dict[str, Any] | None = None,
-        vector_weight: float | None = None,
     ) -> Dict[str, Any]:
         """Search for the most similar vectors in the specified collection.
 
@@ -71,8 +70,6 @@ class VectorDatabase(abc.ABC):
                     {"file_id": "abc"}
                     {"created_at": {"$gte": 1700000000}}
                     {"file_type": {"$in": ["pdf", "docx"]}}
-            vector_weight: Weight for vector search in hybrid mode (0.0–1.0).
-                ``None`` means use equal weights (backward compatible).
         """
         pass
 
@@ -95,28 +92,6 @@ class VectorDatabase(abc.ABC):
         """
         pass
 
-    async def list_by_filter(
-        self,
-        collection: str,
-        filter: dict[str, Any] | None = None,
-        limit: int = 20,
-        offset: int = 0,
-    ) -> tuple[list[dict[str, Any]], int]:
-        """List vectors matching the given metadata filter with pagination.
-
-        Args:
-            collection: Collection name.
-            filter: Optional metadata filter dict in canonical format.
-            limit: Maximum number of items to return.
-            offset: Number of items to skip.
-
-        Returns:
-            Tuple of (items, total) where items is a list of dicts with
-            keys 'id', 'document', 'metadata', and total is the best-effort
-            count of all matching vectors (-1 if unknown).
-        """
-        return [], -1
-
     @abc.abstractmethod
     async def get_or_create_collection(self, collection: str):
         """Get or create collection."""

src/langbot/pkg/vector/vdbs/chroma.py

@@ -2,14 +2,11 @@ from __future__ import annotations
 import asyncio
 from typing import Any
 from chromadb import PersistentClient
-from langbot.pkg.vector.vdb import VectorDatabase, SearchType
+from langbot.pkg.vector.vdb import VectorDatabase
 from langbot.pkg.core import app
 import chromadb
 import chromadb.errors
 
-# RRF smoothing constant (standard value from the literature)
-_RRF_K = 60
-
 
 class ChromaVectorDatabase(VectorDatabase):
     def __init__(self, ap: app.Application, base_path: str = './data/chroma'):
@@ -17,10 +14,6 @@ class ChromaVectorDatabase(VectorDatabase):
         self.client = PersistentClient(path=base_path)
         self._collections = {}
 
-    @classmethod
-    def supported_search_types(cls) -> list[SearchType]:
-        return [SearchType.VECTOR, SearchType.FULL_TEXT, SearchType.HYBRID]
-
     async def get_or_create_collection(self, collection: str) -> chromadb.Collection:
         if collection not in self._collections:
             self._collections[collection] = await asyncio.to_thread(
@@ -41,8 +34,8 @@ class ChromaVectorDatabase(VectorDatabase):
         kwargs: dict[str, Any] = dict(embeddings=embeddings_list, ids=ids, metadatas=metadatas)
         if documents is not None:
             kwargs['documents'] = documents
-        await asyncio.to_thread(col.upsert, **kwargs)
-        self.ap.logger.info(f"Upserted {len(ids)} embeddings to Chroma collection '{collection}'.")
+        await asyncio.to_thread(col.add, **kwargs)
+        self.ap.logger.info(f"Added {len(ids)} embeddings to Chroma collection '{collection}'.")
 
     async def search(
         self,
@@ -52,28 +45,8 @@ class ChromaVectorDatabase(VectorDatabase):
         search_type: str = 'vector',
         query_text: str = '',
         filter: dict[str, Any] | None = None,
-        vector_weight: float | None = None,
     ) -> dict[str, Any]:
         col = await self.get_or_create_collection(collection)
-
-        if search_type == SearchType.FULL_TEXT:
-            return await self._full_text_search(col, collection, k, query_text, filter)
-        elif search_type == SearchType.HYBRID:
-            return await self._hybrid_search(
-                col, collection, query_embedding, k, query_text, filter, vector_weight=vector_weight
-            )
-
-        # Default: vector search
-        return await self._vector_search(col, collection, query_embedding, k, filter)
-
-    async def _vector_search(
-        self,
-        col: chromadb.Collection,
-        collection: str,
-        query_embedding: list[float],
-        k: int,
-        filter: dict[str, Any] | None,
-    ) -> dict[str, Any]:
         query_kwargs: dict[str, Any] = dict(
             query_embeddings=query_embedding,
             n_results=k,
@@ -82,154 +55,9 @@ class ChromaVectorDatabase(VectorDatabase):
         if filter:
             query_kwargs['where'] = filter
         results = await asyncio.to_thread(col.query, **query_kwargs)
-        self.ap.logger.info(
-            f"Chroma vector search in '{collection}' returned {len(results.get('ids', [[]])[0])} results."
-        )
+        self.ap.logger.info(f"Chroma search in '{collection}' returned {len(results.get('ids', [[]])[0])} results.")
         return results
 
-    async def _full_text_search(
-        self,
-        col: chromadb.Collection,
-        collection: str,
-        k: int,
-        query_text: str,
-        filter: dict[str, Any] | None,
-    ) -> dict[str, Any]:
-        if not query_text:
-            return {'ids': [[]], 'metadatas': [[]], 'distances': [[]], 'documents': [[]]}
-
-        get_kwargs: dict[str, Any] = dict(
-            where_document={'$contains': query_text},
-            include=['metadatas', 'documents'],
-            limit=k,
-        )
-        if filter:
-            get_kwargs['where'] = filter
-        results = await asyncio.to_thread(col.get, **get_kwargs)
-
-        # col.get returns flat lists; wrap into column-major format.
-        # Distances are all 0.0 because Chroma's local $contains is a boolean
-        # filter with no relevance scoring.  Chroma's BM25 sparse embedding
-        # function (ChromaBm25EmbeddingFunction) can generate scored sparse
-        # vectors, but sparse vector *indexing* is only available on Chroma
-        # Cloud, not locally.  For ranked results, use hybrid mode or apply a
-        # reranker in a downstream stage.
-        ids = results.get('ids', [])
-        metadatas = results.get('metadatas', []) or [None] * len(ids)
-        documents = results.get('documents', []) or [None] * len(ids)
-        distances = [0.0] * len(ids)
-
-        self.ap.logger.info(f"Chroma full-text search in '{collection}' returned {len(ids)} results.")
-        return {'ids': [ids], 'metadatas': [metadatas], 'distances': [distances], 'documents': [documents]}
-
-    async def _hybrid_search(
-        self,
-        col: chromadb.Collection,
-        collection: str,
-        query_embedding: list[float],
-        k: int,
-        query_text: str,
-        filter: dict[str, Any] | None,
-        vector_weight: float | None = None,
-    ) -> dict[str, Any]:
-        # Fall back to pure vector search when no text is provided
-        if not query_text:
-            return await self._vector_search(col, collection, query_embedding, k, filter)
-
-        # Run vector search and full-text search in parallel
-        vector_task = self._vector_search(col, collection, query_embedding, k, filter)
-        text_task = self._full_text_search(col, collection, k, query_text, filter)
-        vector_results, text_results = await asyncio.gather(vector_task, text_task)
-
-        vector_ids = vector_results.get('ids', [[]])[0]
-        text_ids = text_results.get('ids', [[]])[0]
-
-        if not vector_ids and not text_ids:
-            return {'ids': [[]], 'metadatas': [[]], 'distances': [[]], 'documents': [[]]}
-
-        # RRF fusion
-        weights = None
-        if vector_weight is not None:
-            weights = [vector_weight, 1.0 - vector_weight]
-        self.ap.logger.info(
-            f"Chroma hybrid fusion config in '{collection}': "
-            f'vector_weight={vector_weight}, weights={weights or [1.0, 1.0]}, '
-            f'vector_hits={len(vector_ids)}, text_hits={len(text_ids)}'
-        )
-        fused = self._rrf_fuse([vector_ids, text_ids], k, weights=weights)
-        if not fused:
-            return {'ids': [[]], 'metadatas': [[]], 'distances': [[]], 'documents': [[]]}
-
-        fused_ids = [doc_id for doc_id, _ in fused]
-
-        # Fetch full metadata and documents for fused results
-        fetched = await asyncio.to_thread(col.get, ids=fused_ids, include=['metadatas', 'documents'])
-
-        # col.get returns results in arbitrary order; re-order to match fused ranking
-        fetched_map: dict[str, tuple] = {}
-        for i, fid in enumerate(fetched.get('ids', [])):
-            meta = (fetched.get('metadatas') or [None] * len(fetched['ids']))[i]
-            doc = (fetched.get('documents') or [None] * len(fetched['ids']))[i]
-            fetched_map[fid] = (meta, doc)
-
-        ordered_ids = []
-        ordered_metas = []
-        ordered_docs = []
-        ordered_dists = []
-
-        # Normalize RRF scores to 0~1 distances via min-max scaling.
-        # Raw RRF scores are tiny (e.g. 0.016~0.033 with k=60) so a naive
-        # ``1 - score`` would compress all distances into a narrow 0.96~0.98
-        # band with almost no discriminative power.  Min-max normalization
-        # spreads them across the full 0~1 range (0.0 = best match).
-        max_score = fused[0][1]
-        min_score = fused[-1][1]
-        score_range = max_score - min_score
-
-        for doc_id, score in fused:
-            if doc_id in fetched_map:
-                meta, doc = fetched_map[doc_id]
-                ordered_ids.append(doc_id)
-                ordered_metas.append(meta)
-                ordered_docs.append(doc)
-                if score_range > 0:
-                    ordered_dists.append(1.0 - (score - min_score) / score_range)
-                else:
-                    ordered_dists.append(0.0)
-
-        self.ap.logger.info(
-            f"Chroma hybrid search in '{collection}' returned {len(ordered_ids)} results "
-            f'(vector={len(vector_ids)}, text={len(text_ids)}).'
-        )
-        return {
-            'ids': [ordered_ids],
-            'metadatas': [ordered_metas],
-            'distances': [ordered_dists],
-            'documents': [ordered_docs],
-        }
-
-    @staticmethod
-    def _rrf_fuse(result_lists: list[list[str]], k: int, weights: list[float] | None = None) -> list[tuple[str, float]]:
-        """Reciprocal Rank Fusion over multiple ranked ID lists.
-
-        Returns a list of (doc_id, rrf_score) sorted by descending score,
-        truncated to *k* entries.
-
-        Args:
-            result_lists: Ranked ID lists from different search methods.
-            k: Number of results to return.
-            weights: Per-list weights.  ``None`` means equal weight (1.0 each).
-        """
-        if weights is None:
-            weights = [1.0] * len(result_lists)
-        scores: dict[str, float] = {}
-        for list_idx, ranked_ids in enumerate(result_lists):
-            w = weights[list_idx]
-            for rank, doc_id in enumerate(ranked_ids):
-                scores[doc_id] = scores.get(doc_id, 0.0) + w / (_RRF_K + rank + 1)
-        sorted_results = sorted(scores.items(), key=lambda x: x[1], reverse=True)
-        return sorted_results[:k]
-
     async def delete_by_file_id(self, collection: str, file_id: str) -> None:
         col = await self.get_or_create_collection(collection)
         await asyncio.to_thread(col.delete, where={'file_id': file_id})
@@ -241,41 +69,6 @@ class ChromaVectorDatabase(VectorDatabase):
         self.ap.logger.info(f"Deleted embeddings from Chroma collection '{collection}' by filter")
         return 0  # Chroma delete does not return a count
 
-    async def list_by_filter(
-        self,
-        collection: str,
-        filter: dict[str, Any] | None = None,
-        limit: int = 20,
-        offset: int = 0,
-    ) -> tuple[list[dict[str, Any]], int]:
-        col = await self.get_or_create_collection(collection)
-        get_kwargs: dict[str, Any] = dict(
-            include=['metadatas', 'documents'],
-            limit=limit,
-            offset=offset,
-        )
-        if filter:
-            get_kwargs['where'] = filter
-        results = await asyncio.to_thread(col.get, **get_kwargs)
-
-        ids = results.get('ids', [])
-        metadatas = results.get('metadatas', []) or [None] * len(ids)
-        documents = results.get('documents', []) or [None] * len(ids)
-
-        items = []
-        for i, vid in enumerate(ids):
-            items.append(
-                {
-                    'id': vid,
-                    'document': documents[i] if i < len(documents) else None,
-                    'metadata': metadatas[i] if i < len(metadatas) else {},
-                }
-            )
-
-        # Chroma col.count() gives total in collection; filtered count not available
-        total = await asyncio.to_thread(col.count) if not filter else -1
-        return items, total
-
     async def delete_collection(self, collection: str):
         if collection in self._collections:
             del self._collections[collection]

src/langbot/pkg/vector/vdbs/milvus.py

@@ -11,14 +11,11 @@ from langbot.pkg.core import app
 # silently dropped with a warning.
 _MILVUS_SUPPORTED_FIELDS = {'text', 'file_id', 'chunk_uuid'}
 
-# Callers use canonical metadata key 'uuid' but Milvus stores it as 'chunk_uuid'.
-_MILVUS_FIELD_ALIASES = {'uuid': 'chunk_uuid'}
-
 
 def _build_milvus_expr(filter_dict: dict[str, Any]) -> str:
     """Translate canonical filter dict into a Milvus boolean expression string."""
     triples = normalize_filter(filter_dict)
-    triples = strip_unsupported_fields(triples, _MILVUS_SUPPORTED_FIELDS, _MILVUS_FIELD_ALIASES)
+    triples = strip_unsupported_fields(triples, _MILVUS_SUPPORTED_FIELDS)
     if not triples:
         return ''
 
@@ -255,7 +252,6 @@ class MilvusVectorDatabase(VectorDatabase):
         search_type: str = 'vector',
         query_text: str = '',
         filter: dict[str, Any] | None = None,
-        vector_weight: float | None = None,
     ) -> Dict[str, Any]:
         """Search for similar vectors in Milvus collection
 
@@ -344,62 +340,6 @@ class MilvusVectorDatabase(VectorDatabase):
         self.ap.logger.info(f"Deleted embeddings from Milvus collection '{collection}' by filter")
         return 0  # Milvus delete does not return a count
 
-    async def list_by_filter(
-        self,
-        collection: str,
-        filter: dict[str, Any] | None = None,
-        limit: int = 20,
-        offset: int = 0,
-    ) -> tuple[list[dict[str, Any]], int]:
-        collection = self._normalize_collection_name(collection)
-        await self.get_or_create_collection(collection)
-
-        query_kwargs: dict[str, Any] = dict(
-            collection_name=collection,
-            output_fields=['text', 'file_id', 'chunk_uuid'],
-            limit=limit,
-            offset=offset,
-        )
-        if filter:
-            expr = _build_milvus_expr(filter)
-            if expr:
-                query_kwargs['filter'] = expr
-
-        results = await asyncio.to_thread(self.client.query, **query_kwargs)
-
-        items = []
-        for row in results:
-            items.append(
-                {
-                    'id': row.get('id', ''),
-                    'document': row.get('text'),
-                    'metadata': {
-                        'text': row.get('text', ''),
-                        'file_id': row.get('file_id', ''),
-                        'uuid': row.get('chunk_uuid', ''),
-                    },
-                }
-            )
-
-        # Milvus query with count(*)
-        total = -1
-        try:
-            count_kwargs: dict[str, Any] = dict(
-                collection_name=collection,
-                output_fields=['count(*)'],
-            )
-            if filter:
-                expr = _build_milvus_expr(filter)
-                if expr:
-                    count_kwargs['filter'] = expr
-            count_result = await asyncio.to_thread(self.client.query, **count_kwargs)
-            if count_result:
-                total = count_result[0].get('count(*)', -1)
-        except Exception:
-            pass
-
-        return items, total
-
     async def delete_collection(self, collection: str):
         """Delete a Milvus collection
 

src/langbot/pkg/vector/vdbs/pgvector_db.py

@@ -13,9 +13,6 @@ Base = declarative_base()
 # pgvector schema only stores these metadata fields.
 _PG_SUPPORTED_FIELDS = {'text', 'file_id', 'chunk_uuid'}
 
-# Callers use canonical metadata key 'uuid' but pgvector stores it as 'chunk_uuid'.
-_PG_FIELD_ALIASES = {'uuid': 'chunk_uuid'}
-
 # Map schema field names to SQLAlchemy columns (resolved lazily from PgVectorEntry).
 _PG_COLUMN_MAP = {
     'text': 'text',
@@ -40,7 +37,7 @@ class PgVectorEntry(Base):
 def _build_pg_conditions(filter_dict: dict[str, Any]) -> list:
     """Translate canonical filter dict into a list of SQLAlchemy conditions."""
     triples = normalize_filter(filter_dict)
-    triples = strip_unsupported_fields(triples, _PG_SUPPORTED_FIELDS, _PG_FIELD_ALIASES)
+    triples = strip_unsupported_fields(triples, _PG_SUPPORTED_FIELDS)
 
     conditions = []
     for field, op, value in triples:
@@ -192,7 +189,6 @@ class PgVectorDatabase(VectorDatabase):
         search_type: str = 'vector',
         query_text: str = '',
         filter: dict[str, Any] | None = None,
-        vector_weight: float | None = None,
     ) -> Dict[str, Any]:
         """Search for similar vectors using cosine distance
 
@@ -313,65 +309,6 @@ class PgVectorDatabase(VectorDatabase):
                 self.ap.logger.error(f'Error deleting from pgvector by filter: {e}')
                 raise
 
-    async def list_by_filter(
-        self,
-        collection: str,
-        filter: dict[str, Any] | None = None,
-        limit: int = 20,
-        offset: int = 0,
-    ) -> tuple[list[dict[str, Any]], int]:
-        await self.get_or_create_collection(collection)
-
-        async with self.AsyncSessionLocal() as session:
-            try:
-                from sqlalchemy import select, func
-
-                stmt = (
-                    select(
-                        PgVectorEntry.id,
-                        PgVectorEntry.text,
-                        PgVectorEntry.file_id,
-                        PgVectorEntry.chunk_uuid,
-                    )
-                    .filter(PgVectorEntry.collection == collection)
-                    .offset(offset)
-                    .limit(limit)
-                )
-
-                count_stmt = (
-                    select(func.count()).select_from(PgVectorEntry).filter(PgVectorEntry.collection == collection)
-                )
-
-                if filter:
-                    for cond in _build_pg_conditions(filter):
-                        stmt = stmt.filter(cond)
-                        count_stmt = count_stmt.filter(cond)
-
-                result = await session.execute(stmt)
-                rows = result.fetchall()
-
-                count_result = await session.execute(count_stmt)
-                total = count_result.scalar() or 0
-
-                items = []
-                for row in rows:
-                    items.append(
-                        {
-                            'id': row.id,
-                            'document': row.text or '',
-                            'metadata': {
-                                'text': row.text or '',
-                                'file_id': row.file_id or '',
-                                'uuid': row.chunk_uuid or '',
-                            },
-                        }
-                    )
-
-                return items, total
-            except Exception as e:
-                self.ap.logger.error(f'Error listing from pgvector: {e}')
-                raise
-
     async def delete_collection(self, collection: str):
         """Delete all vectors in a collection
 

src/langbot/pkg/vector/vdbs/qdrant.py

@@ -100,7 +100,6 @@ class QdrantVectorDatabase(VectorDatabase):
         search_type: str = 'vector',
         query_text: str = '',
         filter: dict[str, Any] | None = None,
-        vector_weight: float | None = None,
     ) -> dict[str, Any]:
         exists = await self.client.collection_exists(collection)
         if not exists:
@@ -151,97 +150,6 @@ class QdrantVectorDatabase(VectorDatabase):
         self.ap.logger.info(f"Deleted embeddings from Qdrant collection '{collection}' by filter")
         return 0  # Qdrant delete does not return a count
 
-    async def list_by_filter(
-        self,
-        collection: str,
-        filter: dict[str, Any] | None = None,
-        limit: int = 20,
-        offset: int = 0,
-    ) -> tuple[list[dict[str, Any]], int]:
-        exists = await self.client.collection_exists(collection)
-        if not exists:
-            return [], 0
-
-        qdrant_filter = _build_qdrant_filter(filter) if filter else None
-
-        # Qdrant scroll uses cursor-based pagination (offset = point ID),
-        # not numeric skip.  To support numeric offset we scroll through
-        # `offset + limit` items and discard the first `offset`.
-        remaining_to_skip = offset
-        remaining_to_collect = limit
-        cursor: int | str | None = None
-        collected: list[dict[str, Any]] = []
-
-        while remaining_to_skip > 0 or remaining_to_collect > 0:
-            batch_size = remaining_to_skip + remaining_to_collect if remaining_to_skip > 0 else remaining_to_collect
-            scroll_kwargs: dict[str, Any] = dict(
-                collection_name=collection,
-                limit=min(batch_size, 256),
-                with_payload=True if remaining_to_skip == 0 else False,
-                with_vectors=False,
-            )
-            if qdrant_filter:
-                scroll_kwargs['scroll_filter'] = qdrant_filter
-            if cursor is not None:
-                scroll_kwargs['offset'] = cursor
-
-            points, next_cursor = await self.client.scroll(**scroll_kwargs)
-            if not points:
-                break
-
-            for point in points:
-                if remaining_to_skip > 0:
-                    remaining_to_skip -= 1
-                    continue
-                if remaining_to_collect <= 0:
-                    break
-                # Re-fetch payload if we skipped it during the skip phase
-                payload = point.payload or {}
-                collected.append(
-                    {
-                        'id': str(point.id),
-                        'document': payload.get('text') or payload.get('document'),
-                        'metadata': payload,
-                    }
-                )
-                remaining_to_collect -= 1
-
-            if next_cursor is None:
-                break
-            cursor = next_cursor
-
-        # If we skipped without payload, re-fetch the collected items' payloads
-        # (only needed when offset > 0 and items were collected in a skip batch)
-        if offset > 0 and collected:
-            refetch_ids = [item['id'] for item in collected if not item.get('metadata')]
-            if refetch_ids:
-                fetched_points = await self.client.retrieve(
-                    collection_name=collection,
-                    ids=refetch_ids,
-                    with_payload=True,
-                    with_vectors=False,
-                )
-                payload_map = {str(p.id): p.payload or {} for p in fetched_points}
-                for item in collected:
-                    if item['id'] in payload_map:
-                        payload = payload_map[item['id']]
-                        item['metadata'] = payload
-                        item['document'] = payload.get('text') or payload.get('document')
-
-        # Use count() for accurate total (supports filter)
-        total = -1
-        try:
-            count_result = await self.client.count(
-                collection_name=collection,
-                count_filter=qdrant_filter,
-                exact=True,
-            )
-            total = count_result.count
-        except Exception:
-            pass
-
-        return collected, total
-
     async def delete_collection(self, collection: str):
         try:
             await self.client.delete_collection(collection)

src/langbot/pkg/vector/vdbs/seekdb.py

@@ -1,8 +1,6 @@
 from __future__ import annotations
 
 import asyncio
-from decimal import Decimal
-import re
 from typing import Any, Dict, List
 
 
@@ -103,28 +101,8 @@ class SeekDBVectorDatabase(VectorDatabase):
             }
         )
 
-    def _normalize_collection_name(self, collection: str) -> str:
-        """SeekDB only accepts [a-zA-Z0-9_], while LangBot uses UUID-like KB IDs."""
-        normalized = re.sub(r'[^A-Za-z0-9_]', '_', collection)
-        if normalized != collection:
-            self.ap.logger.info(f"Normalized SeekDB collection name: '{collection}' -> '{normalized}'")
-        return normalized
-
-    def _json_safe(self, value: Any) -> Any:
-        """Convert SeekDB result values into JSON-serializable Python primitives."""
-        if isinstance(value, Decimal):
-            return float(value)
-        if isinstance(value, dict):
-            return {k: self._json_safe(v) for k, v in value.items()}
-        if isinstance(value, list):
-            return [self._json_safe(v) for v in value]
-        if isinstance(value, tuple):
-            return [self._json_safe(v) for v in value]
-        return value
-
     async def _get_or_create_collection_internal(self, collection: str, vector_size: int = None) -> Any:
         """Internal method to get or create a collection with proper configuration."""
-        collection = self._normalize_collection_name(collection)
         if collection in self._collections:
             return self._collections[collection]
 
@@ -195,7 +173,6 @@ class SeekDBVectorDatabase(VectorDatabase):
         if not embeddings_list:
             return
 
-        collection = self._normalize_collection_name(collection)
         # Ensure collection exists with correct dimension
         vector_size = len(embeddings_list[0])
         coll = await self._get_or_create_collection_internal(collection, vector_size)
@@ -217,7 +194,6 @@ class SeekDBVectorDatabase(VectorDatabase):
         search_type: str = 'vector',
         query_text: str = '',
         filter: Dict[str, Any] | None = None,
-        vector_weight: float | None = None,
     ) -> Dict[str, Any]:
         """Search for the most similar vectors in the specified collection.
 
@@ -234,7 +210,6 @@ class SeekDBVectorDatabase(VectorDatabase):
         Returns:
             Dictionary with 'ids', 'metadatas', 'distances' keys
         """
-        collection = self._normalize_collection_name(collection)
         # Check if collection exists
         exists = await asyncio.to_thread(self.client.has_collection, collection)
         if not exists:
@@ -296,17 +271,6 @@ class SeekDBVectorDatabase(VectorDatabase):
                     query_cfg['where'] = filter
                     knn_cfg['where'] = filter
 
-                # Apply vector_weight via pyseekdb's native boost parameter
-                if vector_weight is not None:
-                    knn_cfg['boost'] = vector_weight
-                    query_cfg['boost'] = 1.0 - vector_weight
-                self.ap.logger.info(
-                    f"SeekDB hybrid fusion config in '{collection}': "
-                    f'vector_weight={vector_weight}, '
-                    f'knn_boost={knn_cfg.get("boost", 1.0)}, '
-                    f'query_boost={query_cfg.get("boost", 1.0)}'
-                )
-
                 results = await asyncio.to_thread(
                     coll.hybrid_search,
                     query=query_cfg,
@@ -315,9 +279,6 @@ class SeekDBVectorDatabase(VectorDatabase):
                     n_results=k,
                     include=['documents', 'metadatas'],
                 )
-                self.ap.logger.info(
-                    f"SeekDB hybrid search in '{collection}' returned {len(results.get('ids', [[]])[0])} results."
-                )
         else:
             # Default: vector search via query()
             query_kwargs = {'n_results': k, 'query_embeddings': query_embedding}
@@ -325,7 +286,6 @@ class SeekDBVectorDatabase(VectorDatabase):
                 query_kwargs['where'] = filter
             results = await asyncio.to_thread(coll.query, **query_kwargs)
 
-        results = self._json_safe(results)
         self.ap.logger.info(
             f"SeekDB {search_type} search in '{collection}' returned {len(results.get('ids', [[]])[0])} results"
         )
@@ -339,7 +299,6 @@ class SeekDBVectorDatabase(VectorDatabase):
             collection: Collection name
             file_id: File ID to delete
         """
-        collection = self._normalize_collection_name(collection)
         # Check if collection exists
         exists = await asyncio.to_thread(self.client.has_collection, collection)
         if not exists:
@@ -366,7 +325,6 @@ class SeekDBVectorDatabase(VectorDatabase):
             collection: Collection name
             filter: Chroma-style ``where`` filter dict
         """
-        collection = self._normalize_collection_name(collection)
         exists = await asyncio.to_thread(self.client.has_collection, collection)
         if not exists:
             self.ap.logger.warning(f"SeekDB collection '{collection}' not found for deletion")
@@ -382,59 +340,12 @@ class SeekDBVectorDatabase(VectorDatabase):
         self.ap.logger.info(f"Deleted embeddings from SeekDB collection '{collection}' by filter")
         return 0  # SeekDB delete does not return a count
 
-    async def list_by_filter(
-        self,
-        collection: str,
-        filter: Dict[str, Any] | None = None,
-        limit: int = 20,
-        offset: int = 0,
-    ) -> tuple[list[Dict[str, Any]], int]:
-        collection = self._normalize_collection_name(collection)
-        exists = await asyncio.to_thread(self.client.has_collection, collection)
-        if not exists:
-            return [], 0
-
-        if collection not in self._collections:
-            coll = await asyncio.to_thread(self.client.get_collection, collection, embedding_function=None)
-            self._collections[collection] = coll
-        else:
-            coll = self._collections[collection]
-
-        get_kwargs: Dict[str, Any] = dict(
-            include=['metadatas', 'documents'],
-            limit=limit,
-            offset=offset,
-        )
-        if filter:
-            get_kwargs['where'] = filter
-
-        results = await asyncio.to_thread(coll.get, **get_kwargs)
-
-        results = self._json_safe(results)
-        ids = results.get('ids', [])
-        metadatas = results.get('metadatas', []) or [None] * len(ids)
-        documents = results.get('documents', []) or [None] * len(ids)
-
-        items = []
-        for i, vid in enumerate(ids):
-            items.append(
-                {
-                    'id': vid,
-                    'document': documents[i] if i < len(documents) else None,
-                    'metadata': metadatas[i] if i < len(metadatas) else {},
-                }
-            )
-
-        total = await asyncio.to_thread(coll.count) if not filter else -1
-        return items, total
-
     async def delete_collection(self, collection: str):
         """Delete the entire collection.
 
         Args:
             collection: Collection name
         """
-        collection = self._normalize_collection_name(collection)
         # Remove from cache
         if collection in self._collections:
             del self._collections[collection]

src/langbot/templates/config.yaml

@@ -2,7 +2,6 @@ admins: []
 api:
     port: 5300
     webhook_prefix: 'http://127.0.0.1:5300'
-    extra_webhook_prefix: ''
 command:
     enable: true
     prefix:
@@ -16,7 +15,6 @@ proxy:
     http: ''
     https: ''
 system:
-    instance_id: ''
     edition: community
     recovery_key: ''
     allow_modify_login_info: true
@@ -78,14 +76,6 @@ plugin:
     runtime_ws_url: 'ws://langbot_plugin_runtime:5400/control/ws'
     enable_marketplace: true
     display_plugin_debug_url: 'ws://localhost:5401/plugin/debug/ws'
-monitoring:
-    auto_cleanup:
-        # Enable automatic cleanup of expired monitoring records
-        enabled: true
-        # Retention period in days, records older than this will be deleted
-        retention_days: 30
-        # Cleanup check interval in hours
-        check_interval_hours: 1
 space:
     # Space service URL for OAuth and API
     url: 'https://space.langbot.app'

src/langbot/templates/default-pipeline-config.json

@@ -41,10 +41,7 @@
             "runner": "local-agent"
         },
         "local-agent": {
-            "model": {
-                "primary": "",
-                "fallbacks": []
-            },
+            "model": "",
             "max-round": 10,
             "prompt": [
                 {
@@ -98,12 +95,11 @@
             "max": 0
         },
         "misc": {
-            "exception-handling": "show-hint",
-            "failure-hint": "Request failed.",
+            "hide-exception": true,
             "at-sender": true,
             "quote-origin": true,
             "track-function-calls": false,
             "remove-think": false
         }
     }
-}
+}

src/langbot/templates/metadata/pipeline/ai.yaml

@@ -59,11 +59,8 @@ stages:
         label:
           en_US: Model
           zh_Hans: 模型
-        type: model-fallback-selector
+        type: llm-model-selector
         required: true
-        default:
-          primary: ''
-          fallbacks: []
       - name: max-round
         label:
           en_US: Max Round
@@ -74,10 +71,6 @@ stages:
         type: integer
         required: true
         default: 10
-        show_if:
-          field: __system.is_wizard
-          operator: neq
-          value: true
       - name: prompt
         label:
           en_US: Prompt
@@ -87,9 +80,6 @@ stages:
           zh_Hans: 除非您了解消息结构，否则请只使用 system 单提示词
         type: prompt-editor
         required: true
-        default:
-          - role: system
-            content: "You are a helpful assistant."
       - name: knowledge-bases
         label:
           en_US: Knowledge Bases
@@ -100,10 +90,6 @@ stages:
         type: knowledge-base-multi-selector
         required: false
         default: []
-        show_if:
-          field: __system.is_wizard
-          operator: neq
-          value: true
   - name: tbox-app-api
     label:
       en_US: Tbox App API
@@ -118,14 +104,12 @@ stages:
           zh_Hans: API 密钥
         type: string
         required: true
-        default: ''
       - name: app-id
         label:
           en_US: App ID
           zh_Hans: 应用 ID
         type: string
         required: true
-        default: ''
   - name: dify-service-api
     label:
       en_US: Dify Service API
@@ -140,7 +124,6 @@ stages:
           zh_Hans: 基础 URL
         type: string
         required: true
-        default: 'https://api.dify.ai/v1'
       - name: base-prompt
         label:
           en_US: Base PROMPT
@@ -177,7 +160,6 @@ stages:
           zh_Hans: API 密钥
         type: string
         required: true
-        default: 'your-api-key'
   - name: dashscope-app-api
     label:
       en_US: Aliyun Dashscope App API
@@ -208,14 +190,12 @@ stages:
           zh_Hans: API 密钥
         type: string
         required: true
-        default: 'your-api-key'
       - name: app-id
         label:
           en_US: App ID
           zh_Hans: 应用 ID
         type: string
         required: true
-        default: 'your-app-id'
       - name: references_quote
         label:
           en_US: References Quote
@@ -243,7 +223,6 @@ stages:
           zh_Hans: n8n 工作流的 webhook URL
         type: string
         required: true
-        default: 'http://your-n8n-webhook-url'
       - name: auth-type
         label:
           en_US: Authentication Type
@@ -281,10 +260,6 @@ stages:
         type: string
         required: false
         default: ''
-        show_if:
-          field: auth-type
-          operator: eq
-          value: 'basic'
       - name: basic-password
         label:
           en_US: Password
@@ -295,10 +270,6 @@ stages:
         type: string
         required: false
         default: ''
-        show_if:
-          field: auth-type
-          operator: eq
-          value: 'basic'
       - name: jwt-secret
         label:
           en_US: Secret
@@ -309,10 +280,6 @@ stages:
         type: string
         required: false
         default: ''
-        show_if:
-          field: auth-type
-          operator: eq
-          value: 'jwt'
       - name: jwt-algorithm
         label:
           en_US: Algorithm
@@ -323,10 +290,6 @@ stages:
         type: string
         required: false
         default: 'HS256'
-        show_if:
-          field: auth-type
-          operator: eq
-          value: 'jwt'
       - name: header-name
         label:
           en_US: Header Name
@@ -337,10 +300,6 @@ stages:
         type: string
         required: false
         default: ''
-        show_if:
-          field: auth-type
-          operator: eq
-          value: 'header'
       - name: header-value
         label:
           en_US: Header Value
@@ -351,10 +310,6 @@ stages:
         type: string
         required: false
         default: ''
-        show_if:
-          field: auth-type
-          operator: eq
-          value: 'header'
       - name: timeout
         label:
           en_US: Timeout
@@ -392,7 +347,6 @@ stages:
           zh_Hans: Langflow 服务器的基础 URL
         type: string
         required: true
-        default: 'http://localhost:7860'
       - name: api-key
         label:
           en_US: API Key
@@ -402,7 +356,6 @@ stages:
           zh_Hans: Langflow 服务器的 API 密钥
         type: string
         required: true
-        default: 'your-api-key'
       - name: flow-id
         label:
           en_US: Flow ID
@@ -412,7 +365,6 @@ stages:
           zh_Hans: 要运行的流程 ID
         type: string
         required: true
-        default: 'your-flow-id'
       - name: input-type
         label:
           en_US: Input Type
@@ -460,7 +412,6 @@ stages:
           zh_Hans: Coze服务器的 API 密钥
         type: string
         required: true
-        default: ''
       - name: bot-id
         label:
           en_US: Bot ID
@@ -470,7 +421,6 @@ stages:
           zh_Hans: 要运行的机器人 ID
         type: string
         required: true
-        default: ''
       - name: api-base
         label:
           en_US: API Base URL

src/langbot/templates/metadata/pipeline/output.yaml

@@ -78,39 +78,13 @@ stages:
       en_US: Misc
       zh_Hans: 杂项
     config:
-      - name: exception-handling
+      - name: hide-exception
         label:
-          en_US: Exception Handling Strategy
-          zh_Hans: 异常处理策略
-        description:
-          en_US: Controls how error messages are displayed to the user when an AI request fails
-          zh_Hans: 控制 AI 请求失败时向用户展示错误信息的方式
-        type: select
+          en_US: Hide Exception
+          zh_Hans: 不输出异常信息给用户
+        type: boolean
         required: true
-        default: show-hint
-        options:
-          - name: show-error
-            label:
-              en_US: Show Full Error
-              zh_Hans: 显示完整报错信息
-          - name: show-hint
-            label:
-              en_US: Show Failure Hint
-              zh_Hans: 仅文字提示
-          - name: hide
-            label:
-              en_US: Hide All
-              zh_Hans: 不显示任何异常信息
-      - name: failure-hint
-        label:
-          en_US: Failure Hint Text
-          zh_Hans: 失败提示文本
-        description:
-          en_US: The text to display when a request fails. Only effective when Exception Handling Strategy is set to "Show Failure Hint"
-          zh_Hans: 请求失败时显示的提示文本，仅在异常处理策略设置为"仅文字提示"时生效
-        type: string
-        required: false
-        default: 'Request failed.'
+        default: true
       - name: at-sender
         label:
           en_US: At Sender
@@ -145,4 +119,3 @@ stages:
         type: boolean
         required: true
         default: false
-

src/langbot/templates/metadata/sensitive-words.json

@@ -2,5 +2,77 @@
     "说明": "mask将替换敏感词中的每一个字，若mask_word值不为空，则将敏感词整个替换为mask_word的值",
     "mask": "*",
     "mask_word": "",
-    "words": []
+    "words": [
+        "习近平",
+        "胡锦涛",
+        "江泽民",
+        "温家宝",
+        "李克强",
+        "李长春",
+        "毛泽东",
+        "邓小平",
+        "周恩来",
+        "马克思",
+        "社会主义",
+        "共产党",
+        "共产主义",
+        "大陆官方",
+        "北京政权",
+        "中华帝国",
+        "中国政府",
+        "共狗",
+        "六四事件",
+        "天安门",
+        "六四",
+        "政治局常委",
+        "两会",
+        "共青团",
+        "学潮",
+        "八九",
+        "二十大",
+        "民进党",
+        "台独",
+        "台湾独立",
+        "台湾国",
+        "国民党",
+        "台湾民国",
+        "中华民国",
+        "pornhub",
+        "Pornhub",
+        "[Yy]ou[Pp]orn",
+        "porn",
+        "Porn",
+        "[Xx][Vv]ideos",
+        "[Rr]ed[Tt]ube",
+        "[Xx][Hh]amster",
+        "[Ss]pank[Ww]ire",
+        "[Ss]pank[Bb]ang",
+        "[Tt]ube8",
+        "[Yy]ou[Jj]izz",
+        "[Bb]razzers",
+        "[Nn]aughty[ ]?[Aa]merica",
+        "作爱",
+        "做爱",
+        "性交",
+        "性爱",
+        "自慰",
+        "阴茎",
+        "淫妇",
+        "肛交",
+        "交配",
+        "性关系",
+        "性活动",
+        "色情",
+        "色图",
+        "涩图",
+        "裸体",
+        "小穴",
+        "淫荡",
+        "性爱",
+        "翻墙",
+        "VPN",
+        "科学上网",
+        "挂梯子",
+        "GFW"
+    ]
 }

tests/unit_tests/config/test_webhook_display_prefix.py

@@ -91,15 +91,14 @@ class TestWebhookDisplayPrefix:
 
     def test_default_webhook_prefix(self):
         """Test that the default webhook display prefix is correctly set"""
-        cfg = {'api': {'port': 5300, 'webhook_prefix': 'http://127.0.0.1:5300', 'extra_webhook_prefix': ''}}
+        cfg = {'api': {'port': 5300, 'webhook_prefix': 'http://127.0.0.1:5300'}}
 
         # Should have the default value
         assert cfg['api']['webhook_prefix'] == 'http://127.0.0.1:5300'
-        assert cfg['api']['extra_webhook_prefix'] == ''
 
     def test_webhook_prefix_env_override(self):
         """Test overriding webhook_prefix via environment variable"""
-        cfg = {'api': {'port': 5300, 'webhook_prefix': 'http://127.0.0.1:5300', 'extra_webhook_prefix': ''}}
+        cfg = {'api': {'port': 5300, 'webhook_prefix': 'http://127.0.0.1:5300'}}
 
         # Set environment variable
         os.environ['API__WEBHOOK_PREFIX'] = 'https://example.com:8080'
@@ -113,7 +112,7 @@ class TestWebhookDisplayPrefix:
 
     def test_webhook_prefix_with_custom_domain(self):
         """Test webhook_prefix with custom domain"""
-        cfg = {'api': {'port': 5300, 'webhook_prefix': 'http://127.0.0.1:5300', 'extra_webhook_prefix': ''}}
+        cfg = {'api': {'port': 5300, 'webhook_prefix': 'http://127.0.0.1:5300'}}
 
         # Set to a custom domain
         os.environ['API__WEBHOOK_PREFIX'] = 'https://bot.mycompany.com'
@@ -127,7 +126,7 @@ class TestWebhookDisplayPrefix:
 
     def test_webhook_prefix_with_subdirectory(self):
         """Test webhook_prefix with subdirectory path"""
-        cfg = {'api': {'port': 5300, 'webhook_prefix': 'http://127.0.0.1:5300', 'extra_webhook_prefix': ''}}
+        cfg = {'api': {'port': 5300, 'webhook_prefix': 'http://127.0.0.1:5300'}}
 
         # Set to a URL with subdirectory
         os.environ['API__WEBHOOK_PREFIX'] = 'https://example.com/langbot'
@@ -139,37 +138,6 @@ class TestWebhookDisplayPrefix:
         # Cleanup
         del os.environ['API__WEBHOOK_PREFIX']
 
-    def test_extra_webhook_prefix_default_empty(self):
-        """Test that extra_webhook_prefix defaults to empty string"""
-        cfg = {'api': {'port': 5300, 'webhook_prefix': 'http://127.0.0.1:5300', 'extra_webhook_prefix': ''}}
-
-        bot_uuid = 'test-bot-uuid'
-        webhook_prefix = cfg['api'].get('webhook_prefix', 'http://127.0.0.1:5300')
-        extra_webhook_prefix = cfg['api'].get('extra_webhook_prefix', '')
-        webhook_url = f'/bots/{bot_uuid}'
-
-        assert f'{webhook_prefix}{webhook_url}' == 'http://127.0.0.1:5300/bots/test-bot-uuid'
-        # extra should be empty when not configured
-        assert extra_webhook_prefix == ''
-
-    def test_extra_webhook_prefix_env_override(self):
-        """Test overriding extra_webhook_prefix via environment variable"""
-        cfg = {'api': {'port': 5300, 'webhook_prefix': 'http://127.0.0.1:5300', 'extra_webhook_prefix': ''}}
-
-        os.environ['API__EXTRA_WEBHOOK_PREFIX'] = 'https://extra.example.com'
-
-        result = _apply_env_overrides_to_config(cfg)
-
-        assert result['api']['extra_webhook_prefix'] == 'https://extra.example.com'
-
-        bot_uuid = 'test-bot-uuid'
-        extra_prefix = result['api']['extra_webhook_prefix']
-        webhook_url = f'/bots/{bot_uuid}'
-        assert f'{extra_prefix}{webhook_url}' == 'https://extra.example.com/bots/test-bot-uuid'
-
-        # Cleanup
-        del os.environ['API__EXTRA_WEBHOOK_PREFIX']
-
 
 if __name__ == '__main__':
     pytest.main([__file__, '-v'])

tests/unit_tests/pipeline/conftest.py

@@ -194,7 +194,7 @@ def sample_query(sample_message_chain, sample_message_event, mock_adapter):
         pipeline_config={
             'ai': {
                 'runner': {'runner': 'local-agent'},
-                'local-agent': {'model': {'primary': 'test-model-uuid', 'fallbacks': []}, 'prompt': 'test-prompt'},
+                'local-agent': {'model': 'test-model-uuid', 'prompt': 'test-prompt'},
             },
             'output': {'misc': {'at-sender': False, 'quote-origin': False}},
             'trigger': {'misc': {'combine-quote-message': False}},
@@ -219,7 +219,7 @@ def sample_pipeline_config():
     return {
         'ai': {
             'runner': {'runner': 'local-agent'},
-            'local-agent': {'model': {'primary': 'test-model-uuid', 'fallbacks': []}, 'prompt': 'test-prompt'},
+            'local-agent': {'model': 'test-model-uuid', 'prompt': 'test-prompt'},
         },
         'output': {'misc': {'at-sender': False, 'quote-origin': False}},
         'trigger': {'misc': {'combine-quote-message': False}},

uv.lock

@@ -1112,7 +1112,7 @@ wheels = [
 
 [[package]]
 name = "flask"
-version = "3.1.3"
+version = "3.1.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "blinker" },
@@ -1122,9 +1122,9 @@ dependencies = [
     { name = "markupsafe" },
     { name = "werkzeug" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/26/00/35d85dcce6c57fdc871f3867d465d780f302a175ea360f62533f12b27e2b/flask-3.1.3.tar.gz", hash = "sha256:0ef0e52b8a9cd932855379197dd8f94047b359ca0a78695144304cb45f87c9eb", size = 759004, upload-time = "2026-02-19T05:00:57.678Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/dc/6d/cfe3c0fcc5e477df242b98bfe186a4c34357b4847e87ecaef04507332dab/flask-3.1.2.tar.gz", hash = "sha256:bf656c15c80190ed628ad08cdfd3aaa35beb087855e2f494910aa3774cc4fd87", size = 720160, upload-time = "2025-08-19T21:03:21.205Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/7f/9c/34f6962f9b9e9c71f6e5ed806e0d0ff03c9d1b0b2340088a0cf4bce09b18/flask-3.1.3-py3-none-any.whl", hash = "sha256:f4bcbefc124291925f1a26446da31a5178f9483862233b23c0c96a20701f670c", size = 103424, upload-time = "2026-02-19T05:00:56.027Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/f9/7f9263c5695f4bd0023734af91bedb2ff8209e8de6ead162f35d8dc762fd/flask-3.1.2-py3-none-any.whl", hash = "sha256:ca1d8112ec8a6158cc29ea4858963350011b5c846a414cdb7a954aa9e967d03c", size = 103308, upload-time = "2025-08-19T21:03:19.499Z" },
 ]
 
 [[package]]
@@ -1832,7 +1832,7 @@ wheels = [
 
 [[package]]
 name = "langbot"
-version = "4.9.4"
+version = "4.9.0"
 source = { editable = "." }
 dependencies = [
     { name = "aiocqhttp" },
@@ -1928,7 +1928,7 @@ requires-dist = [
     { name = "botocore", specifier = ">=1.42.39" },
     { name = "certifi", specifier = ">=2025.4.26" },
     { name = "chardet", specifier = ">=5.2.0" },
-    { name = "chromadb", specifier = ">=1.0.0,<2.0.0" },
+    { name = "chromadb", specifier = ">=0.4.24" },
     { name = "colorlog", specifier = "~=6.6.0" },
     { name = "cryptography", specifier = ">=44.0.3" },
     { name = "dashscope", specifier = ">=1.25.10" },
@@ -1937,7 +1937,7 @@ requires-dist = [
     { name = "ebooklib", specifier = ">=0.18" },
     { name = "gewechat-client", specifier = ">=0.1.5" },
     { name = "html2text", specifier = ">=2024.2.26" },
-    { name = "langbot-plugin", specifier = "==0.3.5" },
+    { name = "langbot-plugin", specifier = "==0.3.0" },
     { name = "langchain", specifier = ">=0.2.0" },
     { name = "langchain-text-splitters", specifier = ">=0.0.1" },
     { name = "lark-oapi", specifier = ">=1.4.15" },
@@ -1993,7 +1993,7 @@ dev = [
 
 [[package]]
 name = "langbot-plugin"
-version = "0.3.5"
+version = "0.3.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "aiofiles" },
@@ -2011,28 +2011,28 @@ dependencies = [
     { name = "watchdog" },
     { name = "websockets" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/1c/8f/0a22e4461b0893ac2afb1b6aaebafe04c921df6dbbf4b8bd6c83cf6a97b2/langbot_plugin-0.3.5.tar.gz", hash = "sha256:79c7feb08f788f480435de8cdefc3cfed4de2dfb03978a460251b8c9d1c271d3", size = 171927, upload-time = "2026-03-25T13:53:18.334Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/8d/e5/3686b3225e5f2ee6e19a6050bb981b49a91f2450dff83deb5dfba13b3a2a/langbot_plugin-0.3.0.tar.gz", hash = "sha256:9add2d6e81c8cc7281863e4a92a33ed6228dcc0243f4327ac4062edc962dbf98", size = 169751, upload-time = "2026-03-08T09:54:27.102Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/cd/93/fdd4eb54434a358a3917aec74190e2e1b64351a5bb955677f634d29fc4fd/langbot_plugin-0.3.5-py3-none-any.whl", hash = "sha256:4d31f92338e1e2dc343ae00982e4facbe7abae84f4d1c4e1375cdcac9d7155d7", size = 146575, upload-time = "2026-03-25T13:53:16.987Z" },
+    { url = "https://files.pythonhosted.org/packages/72/51/18f0c1446bcb6712ff3d31d81ea708e3f0e671fde5da69598204a1df977d/langbot_plugin-0.3.0-py3-none-any.whl", hash = "sha256:37bfd3ce507448a6ec4444bec1bc6da1c9911c9df144dfd428febb71122077a6", size = 144096, upload-time = "2026-03-08T09:54:25.581Z" },
 ]
 
 [[package]]
 name = "langchain"
-version = "1.2.12"
+version = "1.2.7"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "langchain-core" },
     { name = "langgraph" },
     { name = "pydantic" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/d8/1d/1af2fc0ac084d4781778b7846b1aed62e05006bf2d73fdf84ac3a8f5225c/langchain-1.2.12.tar.gz", hash = "sha256:ed705b5b293799f7e3e394387f398a1b71707542758283206c8c21415759d991", size = 566444, upload-time = "2026-03-11T22:21:00.712Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/47/f2/478ca9f3455b5d66402066d287eae7e8d6c722acfb8553937e06af708334/langchain-1.2.7.tar.gz", hash = "sha256:ba40e8d5b069a22f7085f54f405973da3d87cfdebf116282e77c692271432ecb", size = 556837, upload-time = "2026-01-23T15:22:10.817Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ca/51/09bb1cfb0b57ae9440ca56cc576e4dc792f83d030eef7637d2c516dcb0a0/langchain-1.2.12-py3-none-any.whl", hash = "sha256:60eff184b8f92c2610f5a4c9a97ad339a891adb01901e83e4df8e6c9c69cf852", size = 112373, upload-time = "2026-03-11T22:20:59.508Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/c8/9ce37ae34870834c7d00bb14ff4876b700db31b928635e3307804dc41d74/langchain-1.2.7-py3-none-any.whl", hash = "sha256:1d643c8ca569bcde2470b853807f74f0768b3982d25d66d57db21a166aabda72", size = 108827, upload-time = "2026-01-23T15:22:09.771Z" },
 ]
 
 [[package]]
 name = "langchain-core"
-version = "1.2.18"
+version = "1.2.7"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "jsonpatch" },
@@ -2044,9 +2044,9 @@ dependencies = [
     { name = "typing-extensions" },
     { name = "uuid-utils" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/18/b7/8bbd0d99a6441b35d891e4b79e7d24c67722cdd363893ae650f24808cf5a/langchain_core-1.2.18.tar.gz", hash = "sha256:ffe53eec44636d092895b9fe25d28af3aaf79060e293fa7cda2a5aaa50c80d21", size = 836725, upload-time = "2026-03-09T20:40:07.229Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/a2/0e/664d8d81b3493e09cbab72448d2f9d693d1fa5aa2bcc488602203a9b6da0/langchain_core-1.2.7.tar.gz", hash = "sha256:e1460639f96c352b4a41c375f25aeb8d16ffc1769499fb1c20503aad59305ced", size = 837039, upload-time = "2026-01-09T17:44:25.505Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/1f/d8/9418564ed4ab4f150668b25cf8c188266267d829362e9c9106946afa628b/langchain_core-1.2.18-py3-none-any.whl", hash = "sha256:cccb79523e0045174ab826054e555fddc973266770e427588c8f1ec9d9d6212b", size = 503048, upload-time = "2026-03-09T20:40:06.115Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/6f/34a9fba14d191a67f7e2ee3dbce3e9b86d2fa7310e2c7f2c713583481bd2/langchain_core-1.2.7-py3-none-any.whl", hash = "sha256:452f4fef7a3d883357b22600788d37e3d8854ef29da345b7ac7099f33c31828b", size = 490232, upload-time = "2026-01-09T17:44:24.236Z" },
 ]
 
 [[package]]
@@ -2063,7 +2063,7 @@ wheels = [
 
 [[package]]
 name = "langgraph"
-version = "1.1.1"
+version = "1.0.7"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "langchain-core" },
@@ -2073,9 +2073,9 @@ dependencies = [
     { name = "pydantic" },
     { name = "xxhash" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/6d/1a/6dbad0c87fb39a58e5ced85297511cc4bcad06cc420b20898eecafece2a2/langgraph-1.1.1.tar.gz", hash = "sha256:cd6282efc657c955b41bff6bd9693de58137ad18f7e7f16b4d17c7d2118d53e1", size = 544040, upload-time = "2026-03-11T22:14:47.845Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/5b/f72655717c04e33d3b62f21b166dc063d192b53980e9e3be0e2a117f1c9f/langgraph-1.0.7.tar.gz", hash = "sha256:0cfdfee51e6e8cfe503ecc7367c73933437c505b03fa10a85c710975c8182d9a", size = 497098, upload-time = "2026-01-22T16:57:47.303Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/dc/c1/572187bb61a534050ef2d5030e7abe46b19694ec106604fe12ddcb8672c7/langgraph-1.1.1-py3-none-any.whl", hash = "sha256:d0cc8d347131cbfc010e65aad9b0f1afbd0e151f470c288bec1f3df8336c50c6", size = 167502, upload-time = "2026-03-11T22:14:46.121Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/0e/fe80144e3e4048e5d19ccdb91ac547c1a7dc3da8dbd1443e210048194c14/langgraph-1.0.7-py3-none-any.whl", hash = "sha256:9d68e8f8dd8f3de2fec45f9a06de05766d9b075b78fb03171779893b7a52c4d2", size = 157353, upload-time = "2026-01-22T16:57:45.997Z" },
 ]
 
 [[package]]
@@ -2093,15 +2093,15 @@ wheels = [
 
 [[package]]
 name = "langgraph-prebuilt"
-version = "1.0.8"
+version = "1.0.7"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "langchain-core" },
     { name = "langgraph-checkpoint" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/0d/06/dd61a5c2dce009d1b03b1d56f2a85b3127659fdddf5b3be5d8f1d60820fb/langgraph_prebuilt-1.0.8.tar.gz", hash = "sha256:0cd3cf5473ced8a6cd687cc5294e08d3de57529d8dd14fdc6ae4899549efcf69", size = 164442, upload-time = "2026-02-19T18:14:39.083Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/a7/59/711aecd1a50999456850dc328f3cad72b4372d8218838d8d5326f80cb76f/langgraph_prebuilt-1.0.7.tar.gz", hash = "sha256:38e097e06de810de4d0e028ffc0e432bb56d1fb417620fb1dfdc76c5e03e4bf9", size = 163692, upload-time = "2026-01-22T16:45:22.801Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/dc/41/ec966424ad3f2ed3996d24079d3342c8cd6c0bd0653c12b2a917a685ec6c/langgraph_prebuilt-1.0.8-py3-none-any.whl", hash = "sha256:d16a731e591ba4470f3e313a319c7eee7dbc40895bcf15c821f985a3522a7ce0", size = 35648, upload-time = "2026-02-19T18:14:37.611Z" },
+    { url = "https://files.pythonhosted.org/packages/47/49/5e37abb3f38a17a3487634abc2a5da87c208cc1d14577eb8d7184b25c886/langgraph_prebuilt-1.0.7-py3-none-any.whl", hash = "sha256:e14923516504405bb5edc3977085bc9622c35476b50c1808544490e13871fe7c", size = 35324, upload-time = "2026-01-22T16:45:21.784Z" },
 ]
 
 [[package]]
@@ -5374,12 +5374,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/0f/8b/4b61d6e13f7108f36910df9ab4b58fd389cc2520d54d81b88660804aad99/torch-2.10.0-2-cp311-none-macosx_11_0_arm64.whl", hash = "sha256:418997cb02d0a0f1497cf6a09f63166f9f5df9f3e16c8a716ab76a72127c714f", size = 79423467, upload-time = "2026-02-10T21:44:48.711Z" },
     { url = "https://files.pythonhosted.org/packages/d3/54/a2ba279afcca44bbd320d4e73675b282fcee3d81400ea1b53934efca6462/torch-2.10.0-2-cp312-none-macosx_11_0_arm64.whl", hash = "sha256:13ec4add8c3faaed8d13e0574f5cd4a323c11655546f91fbe6afa77b57423574", size = 79498202, upload-time = "2026-02-10T21:44:52.603Z" },
     { url = "https://files.pythonhosted.org/packages/ec/23/2c9fe0c9c27f7f6cb865abcea8a4568f29f00acaeadfc6a37f6801f84cb4/torch-2.10.0-2-cp313-none-macosx_11_0_arm64.whl", hash = "sha256:e521c9f030a3774ed770a9c011751fb47c4d12029a3d6522116e48431f2ff89e", size = 79498254, upload-time = "2026-02-10T21:44:44.095Z" },
-    { url = "https://files.pythonhosted.org/packages/36/ab/7b562f1808d3f65414cd80a4f7d4bb00979d9355616c034c171249e1a303/torch-2.10.0-3-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:ac5bdcbb074384c66fa160c15b1ead77839e3fe7ed117d667249afce0acabfac", size = 915518691, upload-time = "2026-03-11T14:15:43.147Z" },
-    { url = "https://files.pythonhosted.org/packages/b3/7a/abada41517ce0011775f0f4eacc79659bc9bc6c361e6bfe6f7052a6b9363/torch-2.10.0-3-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:98c01b8bb5e3240426dcde1446eed6f40c778091c8544767ef1168fc663a05a6", size = 915622781, upload-time = "2026-03-11T14:17:11.354Z" },
-    { url = "https://files.pythonhosted.org/packages/ab/c6/4dfe238342ffdcec5aef1c96c457548762d33c40b45a1ab7033bb26d2ff2/torch-2.10.0-3-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:80b1b5bfe38eb0e9f5ff09f206dcac0a87aadd084230d4a36eea5ec5232c115b", size = 915627275, upload-time = "2026-03-11T14:16:11.325Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/f0/72bf18847f58f877a6a8acf60614b14935e2f156d942483af1ffc081aea0/torch-2.10.0-3-cp313-cp313t-manylinux_2_28_x86_64.whl", hash = "sha256:46b3574d93a2a8134b3f5475cfb98e2eb46771794c57015f6ad1fb795ec25e49", size = 915523474, upload-time = "2026-03-11T14:17:44.422Z" },
-    { url = "https://files.pythonhosted.org/packages/f4/39/590742415c3030551944edc2ddc273ea1fdfe8ffb2780992e824f1ebee98/torch-2.10.0-3-cp314-cp314-manylinux_2_28_x86_64.whl", hash = "sha256:b1d5e2aba4eb7f8e87fbe04f86442887f9167a35f092afe4c237dfcaaef6e328", size = 915632474, upload-time = "2026-03-11T14:15:13.666Z" },
-    { url = "https://files.pythonhosted.org/packages/b6/8e/34949484f764dde5b222b7fe3fede43e4a6f0da9d7f8c370bb617d629ee2/torch-2.10.0-3-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:0228d20b06701c05a8f978357f657817a4a63984b0c90745def81c18aedfa591", size = 915523882, upload-time = "2026-03-11T14:14:46.311Z" },
     { url = "https://files.pythonhosted.org/packages/78/89/f5554b13ebd71e05c0b002f95148033e730d3f7067f67423026cc9c69410/torch-2.10.0-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:3282d9febd1e4e476630a099692b44fdc214ee9bf8ee5377732d9d9dfe5712e4", size = 145992610, upload-time = "2026-01-21T16:25:26.327Z" },
     { url = "https://files.pythonhosted.org/packages/ae/30/a3a2120621bf9c17779b169fc17e3dc29b230c29d0f8222f499f5e159aa8/torch-2.10.0-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:a2f9edd8dbc99f62bc4dfb78af7bf89499bca3d753423ac1b4e06592e467b763", size = 915607863, upload-time = "2026-01-21T16:25:06.696Z" },
     { url = "https://files.pythonhosted.org/packages/6f/3d/c87b33c5f260a2a8ad68da7147e105f05868c281c63d65ed85aa4da98c66/torch-2.10.0-cp311-cp311-win_amd64.whl", hash = "sha256:29b7009dba4b7a1c960260fc8ac85022c784250af43af9fb0ebafc9883782ebd", size = 113723116, upload-time = "2026-01-21T16:25:21.916Z" },
@@ -5872,14 +5866,14 @@ wheels = [
 
 [[package]]
 name = "werkzeug"
-version = "3.1.6"
+version = "3.1.5"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "markupsafe" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/61/f1/ee81806690a87dab5f5653c1f146c92bc066d7f4cebc603ef88eb9e13957/werkzeug-3.1.6.tar.gz", hash = "sha256:210c6bede5a420a913956b4791a7f4d6843a43b6fcee4dfa08a65e93007d0d25", size = 864736, upload-time = "2026-02-19T15:17:18.884Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/5a/70/1469ef1d3542ae7c2c7b72bd5e3a4e6ee69d7978fa8a3af05a38eca5becf/werkzeug-3.1.5.tar.gz", hash = "sha256:6a548b0e88955dd07ccb25539d7d0cc97417ee9e179677d22c7041c8f078ce67", size = 864754, upload-time = "2026-01-08T17:49:23.247Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/4d/ec/d58832f89ede95652fd01f4f24236af7d32b70cab2196dfcc2d2fd13c5c2/werkzeug-3.1.6-py3-none-any.whl", hash = "sha256:7ddf3357bb9564e407607f988f683d72038551200c704012bb9a4c523d42f131", size = 225166, upload-time = "2026-02-19T15:17:17.475Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/e4/8d97cca767bcc1be76d16fb76951608305561c6e056811587f36cb1316a8/werkzeug-3.1.5-py3-none-any.whl", hash = "sha256:5111e36e91086ece91f93268bb39b4a35c1e6f1feac762c9c822ded0a4e322dc", size = 225025, upload-time = "2026-01-08T17:49:21.859Z" },
 ]
 
 [[package]]

web/package.json

@@ -25,7 +25,6 @@
     "@dnd-kit/utilities": "^3.2.2",
     "@hookform/resolvers": "^5.0.1",
     "@radix-ui/react-alert-dialog": "^1.1.15",
-    "@radix-ui/react-avatar": "^1.1.11",
     "@radix-ui/react-checkbox": "^1.3.1",
     "@radix-ui/react-collapsible": "^1.1.12",
     "@radix-ui/react-context-menu": "^2.2.15",
@@ -103,10 +102,5 @@
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.31.1"
   },
-  "packageManager": "pnpm@8.9.2+sha512.b9d35fe91b2a5854dadc43034a3e7b2e675fa4b56e20e8e09ef078fa553c18f8aed44051e7b36e8b8dd435f97eb0c44c4ff3b44fc7c6fa7d21e1fac17bbe661e",
-  "pnpm": {
-    "overrides": {
-      "minimatch": "3.1.3"
-    }
-  }
-}
+  "packageManager": "pnpm@8.9.2+sha512.b9d35fe91b2a5854dadc43034a3e7b2e675fa4b56e20e8e09ef078fa553c18f8aed44051e7b36e8b8dd435f97eb0c44c4ff3b44fc7c6fa7d21e1fac17bbe661e"
+}

web/src/app/auth/space/callback/page.tsx

@@ -46,12 +46,8 @@ function SpaceOAuthCallbackContent() {
         }
         setStatus('success');
         toast.success(t('common.spaceLoginSuccess'));
-
-        // If wizard state exists, redirect back to wizard instead of home
-        const wizardState = localStorage.getItem('langbot_wizard_state');
-        const redirectTo = wizardState ? '/wizard' : '/home';
         setTimeout(() => {
-          router.push(redirectTo);
+          router.push('/home');
         }, 1000);
       } catch (err) {
         setStatus('error');

web/src/app/global.css

@@ -114,23 +114,22 @@
   --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
   --color-sidebar-border: var(--sidebar-border);
   --color-sidebar-ring: var(--sidebar-ring);
-  --animate-twinkle: twinkle 1.5s ease-in-out infinite;
 }
 
 .dark {
-  --background: oklch(0.17 0.003 285.823);
+  --background: oklch(0.08 0.002 285.823);
   --foreground: oklch(0.985 0 0);
-  --card: oklch(0.16 0.004 285.885);
+  --card: oklch(0.12 0.004 285.885);
   --card-foreground: oklch(0.985 0 0);
-  --popover: oklch(0.16 0.004 285.885);
+  --popover: oklch(0.12 0.004 285.885);
   --popover-foreground: oklch(0.985 0 0);
   --primary: oklch(0.62 0.2 255);
   --primary-foreground: oklch(1 0 0);
-  --secondary: oklch(0.27 0.005 286.033);
+  --secondary: oklch(0.18 0.004 286.033);
   --secondary-foreground: oklch(0.985 0 0);
-  --muted: oklch(0.27 0.005 286.033);
+  --muted: oklch(0.18 0.004 286.033);
   --muted-foreground: oklch(0.705 0.015 286.067);
-  --accent: oklch(0.27 0.005 286.033);
+  --accent: oklch(0.18 0.004 286.033);
   --accent-foreground: oklch(0.985 0 0);
   --destructive: oklch(0.704 0.191 22.216);
   --border: oklch(1 0 0 / 8%);
@@ -141,7 +140,7 @@
   --chart-3: oklch(0.769 0.188 70.08);
   --chart-4: oklch(0.627 0.265 303.9);
   --chart-5: oklch(0.645 0.246 16.439);
-  --sidebar: oklch(0.05 0.002 285.885);
+  --sidebar: oklch(0.1 0.003 285.885);
   --sidebar-foreground: oklch(0.985 0 0);
   --sidebar-primary: oklch(0.62 0.2 255);
   --sidebar-primary-foreground: oklch(1 0 0);
@@ -159,23 +158,3 @@
     @apply bg-background text-foreground;
   }
 }
-
-@keyframes twinkle {
-  0%,
-  100% {
-    opacity: 1;
-    transform: scale(1) rotate(0deg);
-  }
-  25% {
-    opacity: 0.6;
-    transform: scale(0.85) rotate(-8deg);
-  }
-  50% {
-    opacity: 1;
-    transform: scale(1.15) rotate(4deg);
-  }
-  75% {
-    opacity: 0.7;
-    transform: scale(0.95) rotate(-4deg);
-  }
-}

web/src/app/home/bots/BotDetailContent.tsx

@@ -1,319 +0,0 @@
-'use client';
-
-import { useState, useEffect, useRef, useCallback } from 'react';
-import { useRouter } from 'next/navigation';
-import { Tabs, TabsList, TabsTrigger, TabsContent } from '@/components/ui/tabs';
-import { Button } from '@/components/ui/button';
-import { Switch } from '@/components/ui/switch';
-import { Label } from '@/components/ui/label';
-import {
-  Card,
-  CardContent,
-  CardDescription,
-  CardHeader,
-  CardTitle,
-} from '@/components/ui/card';
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-  DialogDescription,
-  DialogFooter,
-} from '@/components/ui/dialog';
-import BotForm from '@/app/home/bots/components/bot-form/BotForm';
-import { BotLogListComponent } from '@/app/home/bots/components/bot-log/view/BotLogListComponent';
-import BotSessionMonitor from '@/app/home/bots/components/bot-session/BotSessionMonitor';
-import type { BotSessionMonitorHandle } from '@/app/home/bots/components/bot-session/BotSessionMonitor';
-import { httpClient } from '@/app/infra/http/HttpClient';
-import { useSidebarData } from '@/app/home/components/home-sidebar/SidebarDataContext';
-import { useTranslation } from 'react-i18next';
-import { Settings, FileText, Users, RefreshCw, Trash2 } from 'lucide-react';
-import { cn } from '@/lib/utils';
-import { toast } from 'sonner';
-
-export default function BotDetailContent({ id }: { id: string }) {
-  const isCreateMode = id === 'new';
-  const router = useRouter();
-  const { t } = useTranslation();
-  const { refreshBots, bots, setDetailEntityName } = useSidebarData();
-
-  // Set breadcrumb entity name
-  useEffect(() => {
-    if (isCreateMode) {
-      setDetailEntityName(t('bots.createBot'));
-    } else {
-      const bot = bots.find((b) => b.id === id);
-      setDetailEntityName(bot?.name ?? id);
-    }
-    return () => setDetailEntityName(null);
-  }, [id, isCreateMode, bots, setDetailEntityName, t]);
-
-  const [activeTab, setActiveTab] = useState('config');
-  const [showDeleteConfirm, setShowDeleteConfirm] = useState(false);
-  const [isRefreshingSessions, setIsRefreshingSessions] = useState(false);
-  const sessionMonitorRef = useRef<BotSessionMonitorHandle>(null);
-
-  // Track whether the form has unsaved changes
-  const [formDirty, setFormDirty] = useState(false);
-
-  // Enable state managed here so the header switch works
-  const [botEnabled, setBotEnabled] = useState(true);
-  const [enableLoaded, setEnableLoaded] = useState(false);
-
-  // Fetch bot enable state
-  useEffect(() => {
-    if (!isCreateMode) {
-      httpClient.getBot(id).then((res) => {
-        setBotEnabled(res.bot.enable ?? true);
-        setEnableLoaded(true);
-      });
-    }
-  }, [id, isCreateMode]);
-
-  const handleEnableToggle = useCallback(
-    async (checked: boolean) => {
-      const prev = botEnabled;
-      setBotEnabled(checked);
-      try {
-        // Fetch current bot data to send a complete update
-        const res = await httpClient.getBot(id);
-        const bot = res.bot;
-        await httpClient.updateBot(id, {
-          name: bot.name,
-          description: bot.description,
-          adapter: bot.adapter,
-          adapter_config: bot.adapter_config,
-          enable: checked,
-        });
-        refreshBots();
-      } catch {
-        setBotEnabled(prev);
-        toast.error(t('bots.setBotEnableError'));
-      }
-    },
-    [id, botEnabled, refreshBots, t],
-  );
-
-  function handleFormSubmit() {
-    // Re-sync enable state after form save (form may update enable too)
-    httpClient.getBot(id).then((res) => {
-      setBotEnabled(res.bot.enable ?? true);
-    });
-    refreshBots();
-  }
-
-  function handleBotDeleted() {
-    refreshBots();
-    router.push('/home/bots');
-  }
-
-  function handleNewBotCreated(newBotId: string) {
-    refreshBots();
-    router.push(`/home/bots?id=${encodeURIComponent(newBotId)}`);
-  }
-
-  function confirmDelete() {
-    httpClient
-      .deleteBot(id)
-      .then(() => {
-        setShowDeleteConfirm(false);
-        toast.success(t('bots.deleteSuccess'));
-        handleBotDeleted();
-      })
-      .catch((err) => {
-        toast.error(t('bots.deleteError') + err.msg);
-      });
-  }
-
-  // ==================== Create Mode ====================
-  if (isCreateMode) {
-    return (
-      <div className="flex h-full flex-col">
-        {/* Header */}
-        <div className="flex items-center justify-between pb-4 shrink-0">
-          <h1 className="text-xl font-semibold">{t('bots.createBot')}</h1>
-          <Button type="submit" form="bot-form">
-            {t('common.submit')}
-          </Button>
-        </div>
-
-        {/* Content */}
-        <div className="flex-1 overflow-y-auto min-h-0">
-          <div className="mx-auto max-w-3xl pb-8">
-            <BotForm
-              initBotId={undefined}
-              onFormSubmit={handleFormSubmit}
-              onNewBotCreated={handleNewBotCreated}
-            />
-          </div>
-        </div>
-      </div>
-    );
-  }
-
-  // ==================== Edit Mode ====================
-  return (
-    <>
-      <div className="flex h-full flex-col">
-        {/* Sticky Header: title + enable switch + save button */}
-        <div className="flex items-center justify-between pb-4 shrink-0">
-          <div className="flex items-center gap-4">
-            <h1 className="text-xl font-semibold">{t('bots.editBot')}</h1>
-            {enableLoaded && (
-              <div className="flex items-center gap-2">
-                <Switch
-                  id="bot-enable-switch"
-                  checked={botEnabled}
-                  onCheckedChange={handleEnableToggle}
-                />
-                <Label
-                  htmlFor="bot-enable-switch"
-                  className="text-sm text-muted-foreground cursor-pointer"
-                >
-                  {t('common.enable')}
-                </Label>
-              </div>
-            )}
-          </div>
-          <Button type="submit" form="bot-form" disabled={!formDirty}>
-            {t('common.save')}
-          </Button>
-        </div>
-
-        {/* Horizontal Tabs */}
-        <Tabs
-          key={id}
-          value={activeTab}
-          onValueChange={setActiveTab}
-          className="flex flex-1 flex-col min-h-0"
-        >
-          <TabsList className="shrink-0">
-            <TabsTrigger value="config" className="gap-1.5">
-              <Settings className="size-3.5" />
-              {t('bots.configuration')}
-            </TabsTrigger>
-            <TabsTrigger value="logs" className="gap-1.5">
-              <FileText className="size-3.5" />
-              {t('bots.logs')}
-            </TabsTrigger>
-            <TabsTrigger value="sessions" className="gap-1.5">
-              <Users className="size-3.5" />
-              {t('bots.sessionMonitor.title')}
-              {activeTab === 'sessions' && (
-                <button
-                  type="button"
-                  className="inline-flex items-center justify-center ml-0.5"
-                  onPointerDown={(e) => e.stopPropagation()}
-                  onClick={(e) => {
-                    e.stopPropagation();
-                    e.preventDefault();
-                    if (isRefreshingSessions) return;
-                    setIsRefreshingSessions(true);
-                    const minDelay = new Promise((r) => setTimeout(r, 500));
-                    Promise.all([
-                      sessionMonitorRef.current?.refreshSessions(),
-                      minDelay,
-                    ]).finally(() => setIsRefreshingSessions(false));
-                  }}
-                >
-                  <RefreshCw
-                    className={cn(
-                      'size-3 text-muted-foreground hover:text-foreground transition-colors',
-                      isRefreshingSessions && 'animate-spin',
-                    )}
-                  />
-                </button>
-              )}
-            </TabsTrigger>
-          </TabsList>
-
-          {/* Tab: Configuration */}
-          <TabsContent
-            value="config"
-            className="flex-1 min-h-0 overflow-y-auto mt-4"
-          >
-            <div className="mx-auto max-w-3xl space-y-6 pb-8">
-              <BotForm
-                initBotId={id}
-                onFormSubmit={handleFormSubmit}
-                onNewBotCreated={handleNewBotCreated}
-                onDirtyChange={setFormDirty}
-              />
-
-              {/* Card: Danger Zone */}
-              <Card className="border-destructive/50">
-                <CardHeader>
-                  <CardTitle className="text-destructive">
-                    {t('bots.dangerZone')}
-                  </CardTitle>
-                  <CardDescription>
-                    {t('bots.dangerZoneDescription')}
-                  </CardDescription>
-                </CardHeader>
-                <CardContent>
-                  <div className="flex items-center justify-between">
-                    <div className="space-y-1">
-                      <p className="text-sm font-medium">
-                        {t('bots.deleteBotAction')}
-                      </p>
-                      <p className="text-sm text-muted-foreground">
-                        {t('bots.deleteBotHint')}
-                      </p>
-                    </div>
-                    <Button
-                      type="button"
-                      variant="destructive"
-                      size="sm"
-                      onClick={() => setShowDeleteConfirm(true)}
-                    >
-                      <Trash2 className="size-4 mr-1.5" />
-                      {t('common.delete')}
-                    </Button>
-                  </div>
-                </CardContent>
-              </Card>
-            </div>
-          </TabsContent>
-
-          {/* Tab: Logs */}
-          <TabsContent
-            value="logs"
-            className="flex-1 min-h-0 overflow-y-auto mt-4"
-          >
-            <BotLogListComponent botId={id} />
-          </TabsContent>
-
-          {/* Tab: Sessions */}
-          <TabsContent value="sessions" className="flex-1 min-h-0 mt-4">
-            <BotSessionMonitor ref={sessionMonitorRef} botId={id} />
-          </TabsContent>
-        </Tabs>
-      </div>
-
-      {/* Delete confirmation dialog */}
-      <Dialog open={showDeleteConfirm} onOpenChange={setShowDeleteConfirm}>
-        <DialogContent>
-          <DialogHeader>
-            <DialogTitle>{t('common.confirmDelete')}</DialogTitle>
-            <DialogDescription className="sr-only">
-              {t('bots.deleteConfirmation')}
-            </DialogDescription>
-          </DialogHeader>
-          <div className="py-4">{t('bots.deleteConfirmation')}</div>
-          <DialogFooter>
-            <Button
-              variant="outline"
-              onClick={() => setShowDeleteConfirm(false)}
-            >
-              {t('common.cancel')}
-            </Button>
-            <Button variant="destructive" onClick={confirmDelete}>
-              {t('common.confirmDelete')}
-            </Button>
-          </DialogFooter>
-        </DialogContent>
-      </Dialog>
-    </>
-  );
-}

web/src/app/home/bots/BotDetailDialog.tsx

@@ -0,0 +1,297 @@
+'use client';
+
+import { useState, useEffect } from 'react';
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogDescription,
+  DialogTitle,
+  DialogFooter,
+} from '@/components/ui/dialog';
+import {
+  Sidebar,
+  SidebarContent,
+  SidebarGroup,
+  SidebarGroupContent,
+  SidebarMenu,
+  SidebarMenuButton,
+  SidebarMenuItem,
+  SidebarProvider,
+} from '@/components/ui/sidebar';
+import { Button } from '@/components/ui/button';
+import BotForm from '@/app/home/bots/components/bot-form/BotForm';
+import { BotLogListComponent } from '@/app/home/bots/components/bot-log/view/BotLogListComponent';
+import BotSessionMonitor from '@/app/home/bots/components/bot-session/BotSessionMonitor';
+import { useTranslation } from 'react-i18next';
+import { z } from 'zod';
+import { httpClient } from '@/app/infra/http/HttpClient';
+
+interface BotDetailDialogProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  botId?: string;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  onFormSubmit: (value: z.infer<any>) => void;
+  onFormCancel: () => void;
+  onBotDeleted: () => void;
+  onNewBotCreated: (botId: string) => void;
+}
+
+export default function BotDetailDialog({
+  open,
+  onOpenChange,
+  botId: propBotId,
+  onFormSubmit,
+  onFormCancel,
+  onBotDeleted,
+  onNewBotCreated,
+}: BotDetailDialogProps) {
+  const { t } = useTranslation();
+  const [botId, setBotId] = useState<string | undefined>(propBotId);
+  const [activeMenu, setActiveMenu] = useState('config');
+  const [showDeleteConfirm, setShowDeleteConfirm] = useState(false);
+
+  useEffect(() => {
+    setBotId(propBotId);
+    setActiveMenu('config');
+  }, [propBotId, open]);
+
+  const menu = [
+    {
+      key: 'config',
+      label: t('bots.configuration'),
+      icon: (
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          viewBox="0 0 24 24"
+          fill="currentColor"
+        >
+          <path d="M5 7C5 6.17157 5.67157 5.5 6.5 5.5C7.32843 5.5 8 6.17157 8 7C8 7.82843 7.32843 8.5 6.5 8.5C5.67157 8.5 5 7.82843 5 7ZM6.5 3.5C4.567 3.5 3 5.067 3 7C3 8.933 4.567 10.5 6.5 10.5C8.433 10.5 10 8.933 10 7C10 5.067 8.433 3.5 6.5 3.5ZM12 8H20V6H12V8ZM16 17C16 16.1716 16.6716 15.5 17.5 15.5C18.3284 15.5 19 16.1716 19 17C19 17.8284 18.3284 18.5 17.5 18.5C16.6716 18.5 16 17.8284 16 17ZM17.5 13.5C15.567 13.5 14 15.067 14 17C14 18.933 15.567 20.5 17.5 20.5C19.433 20.5 21 18.933 21 17C21 15.067 19.433 13.5 17.5 13.5ZM4 16V18H12V16H4Z"></path>
+        </svg>
+      ),
+    },
+    {
+      key: 'logs',
+      label: t('bots.logs'),
+      icon: (
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          viewBox="0 0 24 24"
+          fill="currentColor"
+        >
+          <path d="M21 8V20.9932C21 21.5501 20.5552 22 20.0066 22H3.9934C3.44495 22 3 21.556 3 21.0082V2.9918C3 2.45531 3.4487 2 4.00221 2H14.9968L21 8ZM19 9H14V4H5V20H19V9ZM8 7H11V9H8V7ZM8 11H16V13H8V11ZM8 15H16V17H8V15Z"></path>
+        </svg>
+      ),
+    },
+    {
+      key: 'sessions',
+      label: t('bots.sessionMonitor.title'),
+      icon: (
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          viewBox="0 0 24 24"
+          fill="currentColor"
+        >
+          <path d="M2 22C2 17.5817 5.58172 14 10 14C14.4183 14 18 17.5817 18 22H16C16 18.6863 13.3137 16 10 16C6.68629 16 4 18.6863 4 22H2ZM10 13C6.685 13 4 10.315 4 7C4 3.685 6.685 1 10 1C13.315 1 16 3.685 16 7C16 10.315 13.315 13 10 13ZM10 11C12.21 11 14 9.21 14 7C14 4.79 12.21 3 10 3C7.79 3 6 4.79 6 7C6 9.21 7.79 11 10 11ZM18.2837 14.7028C21.0644 15.9561 23 18.752 23 22H21C21 19.564 19.5483 17.4671 17.4628 16.5271L18.2837 14.7028ZM17.5962 3.41321C19.5944 4.23703 21 6.20361 21 8.5C21 11.3702 18.8042 13.7252 16 13.9776V11.9646C17.6967 11.7222 19 10.264 19 8.5C19 7.11935 18.2016 5.92603 17.041 5.35635L17.5962 3.41321Z"></path>
+        </svg>
+      ),
+    },
+  ];
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const handleFormSubmit = (value: any) => {
+    onFormSubmit(value);
+  };
+
+  const handleFormCancel = () => {
+    onFormCancel();
+  };
+
+  const handleBotDeleted = () => {
+    httpClient.deleteBot(botId ?? '').then(() => {
+      onBotDeleted();
+    });
+  };
+
+  const handleNewBotCreated = (newBotId: string) => {
+    setBotId(newBotId);
+    setActiveMenu('config');
+    onNewBotCreated(newBotId);
+  };
+
+  const handleDelete = () => {
+    setShowDeleteConfirm(true);
+  };
+
+  const confirmDelete = () => {
+    handleBotDeleted();
+    setShowDeleteConfirm(false);
+  };
+
+  if (!botId) {
+    return (
+      <>
+        <Dialog open={open} onOpenChange={onOpenChange}>
+          <DialogContent className="overflow-hidden p-0 !max-w-[40vw] max-h-[70vh] flex">
+            <main className="flex flex-1 flex-col h-[70vh]">
+              <DialogHeader className="px-6 pt-6 pb-4 shrink-0">
+                <DialogTitle>{t('bots.createBot')}</DialogTitle>
+                <DialogDescription className="sr-only">
+                  {t('bots.createBot')}
+                </DialogDescription>
+              </DialogHeader>
+              <div className="flex-1 overflow-y-auto px-6 pb-6">
+                <BotForm
+                  initBotId={undefined}
+                  onFormSubmit={handleFormSubmit}
+                  onBotDeleted={handleBotDeleted}
+                  onNewBotCreated={handleNewBotCreated}
+                />
+              </div>
+              <DialogFooter className="px-6 py-4 border-t shrink-0">
+                <div className="flex justify-end gap-2">
+                  <Button type="submit" form="bot-form">
+                    {t('common.submit')}
+                  </Button>
+                  <Button
+                    type="button"
+                    variant="outline"
+                    onClick={handleFormCancel}
+                  >
+                    {t('common.cancel')}
+                  </Button>
+                </div>
+              </DialogFooter>
+            </main>
+          </DialogContent>
+        </Dialog>
+      </>
+    );
+  }
+
+  return (
+    <>
+      <Dialog open={open} onOpenChange={onOpenChange}>
+        <DialogContent className="overflow-hidden p-0 !max-w-[70rem] max-h-[75vh] flex">
+          <SidebarProvider className="items-start w-full flex">
+            <Sidebar
+              collapsible="none"
+              className="hidden md:flex h-[80vh] w-40 min-w-[120px] border-r bg-white dark:bg-black"
+            >
+              <SidebarContent>
+                <SidebarGroup>
+                  <SidebarGroupContent>
+                    <SidebarMenu>
+                      {menu.map((item) => (
+                        <SidebarMenuItem key={item.key}>
+                          <SidebarMenuButton
+                            asChild
+                            isActive={activeMenu === item.key}
+                            onClick={() => setActiveMenu(item.key)}
+                          >
+                            <a href="#">
+                              {item.icon}
+                              <span>{item.label}</span>
+                            </a>
+                          </SidebarMenuButton>
+                        </SidebarMenuItem>
+                      ))}
+                    </SidebarMenu>
+                  </SidebarGroupContent>
+                </SidebarGroup>
+              </SidebarContent>
+            </Sidebar>
+            <main className="flex flex-1 flex-col h-[75vh]">
+              <DialogHeader className="px-6 pt-6 pb-4 shrink-0">
+                <DialogTitle>
+                  {activeMenu === 'config'
+                    ? t('bots.editBot')
+                    : activeMenu === 'logs'
+                      ? t('bots.botLogTitle')
+                      : t('bots.sessionMonitor.title')}
+                </DialogTitle>
+                <DialogDescription className="sr-only">
+                  {activeMenu === 'config'
+                    ? t('bots.editBot')
+                    : activeMenu === 'logs'
+                      ? t('bots.botLogTitle')
+                      : t('bots.sessionMonitor.title')}
+                </DialogDescription>
+              </DialogHeader>
+              <div
+                className={
+                  activeMenu === 'sessions'
+                    ? 'flex-1 min-h-0'
+                    : 'flex-1 overflow-y-auto px-6 pb-6'
+                }
+              >
+                {activeMenu === 'config' && (
+                  <BotForm
+                    initBotId={botId}
+                    onFormSubmit={handleFormSubmit}
+                    onBotDeleted={handleBotDeleted}
+                    onNewBotCreated={handleNewBotCreated}
+                  />
+                )}
+                {activeMenu === 'logs' && botId && (
+                  <BotLogListComponent botId={botId} />
+                )}
+                {activeMenu === 'sessions' && botId && (
+                  <BotSessionMonitor botId={botId} />
+                )}
+              </div>
+              {activeMenu === 'config' && (
+                <DialogFooter className="px-6 py-4 border-t shrink-0">
+                  <div className="flex justify-end gap-2">
+                    <Button
+                      type="button"
+                      variant="destructive"
+                      onClick={handleDelete}
+                    >
+                      {t('common.delete')}
+                    </Button>
+                    <Button type="submit" form="bot-form">
+                      {t('common.save')}
+                    </Button>
+                    <Button
+                      type="button"
+                      variant="outline"
+                      onClick={handleFormCancel}
+                    >
+                      {t('common.cancel')}
+                    </Button>
+                  </div>
+                </DialogFooter>
+              )}
+            </main>
+          </SidebarProvider>
+        </DialogContent>
+      </Dialog>
+
+      {/* 删除确认对话框 */}
+      <Dialog open={showDeleteConfirm} onOpenChange={setShowDeleteConfirm}>
+        <DialogContent>
+          <DialogHeader>
+            <DialogTitle>{t('common.confirmDelete')}</DialogTitle>
+            <DialogDescription className="sr-only">
+              {t('bots.deleteConfirmation')}
+            </DialogDescription>
+          </DialogHeader>
+          <div className="py-4">{t('bots.deleteConfirmation')}</div>
+          <DialogFooter>
+            <Button
+              variant="outline"
+              onClick={() => setShowDeleteConfirm(false)}
+            >
+              {t('common.cancel')}
+            </Button>
+            <Button variant="destructive" onClick={confirmDelete}>
+              {t('common.confirmDelete')}
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+    </>
+  );
+}

web/src/app/home/bots/components/bot-card/botCard.module.css

@@ -3,7 +3,7 @@
   height: 10rem;
   background-color: #fff;
   border-radius: 10px;
-  border: 1px solid #e4e4e7;
+  box-shadow: 0px 2px 2px 0 rgba(0, 0, 0, 0.2);
   padding: 1.2rem;
   cursor: pointer;
   transition: all 0.2s ease;
@@ -11,15 +11,15 @@
 
 :global(.dark) .cardContainer {
   background-color: #1f1f22;
-  border-color: #27272a;
+  box-shadow: 0;
 }
 
 .cardContainer:hover {
-  border-color: #a1a1aa;
+  box-shadow: 0px 2px 8px 0 rgba(0, 0, 0, 0.1);
 }
 
 :global(.dark) .cardContainer:hover {
-  border-color: #3f3f46;
+  box-shadow: 0;
 }
 
 .iconBasicInfoContainer {

web/src/app/home/bots/components/bot-form/BotForm.tsx

@@ -1,4 +1,4 @@
-import React, { useEffect, useMemo, useRef, useState } from 'react';
+import React, { useEffect, useState } from 'react';
 import {
   IChooseAdapterEntity,
   IPipelineEntity,
@@ -21,11 +21,18 @@ import { toast } from 'sonner';
 import { useTranslation } from 'react-i18next';
 import { Copy, Check } from 'lucide-react';
 
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogHeader,
+  DialogTitle,
+  DialogFooter,
+} from '@/components/ui/dialog';
 import { Button } from '@/components/ui/button';
 import {
   Form,
   FormControl,
-  FormDescription,
   FormField,
   FormItem,
   FormLabel,
@@ -40,20 +47,16 @@ import {
   SelectTrigger,
   SelectValue,
 } from '@/components/ui/select';
-import {
-  Card,
-  CardContent,
-  CardDescription,
-  CardHeader,
-  CardTitle,
-} from '@/components/ui/card';
+import { Switch } from '@/components/ui/switch';
 import { extractI18nObject } from '@/i18n/I18nProvider';
 import { CustomApiError } from '@/app/infra/entities/common';
 
 const getFormSchema = (t: (key: string) => string) =>
   z.object({
     name: z.string().min(1, { message: t('bots.botNameRequired') }),
-    description: z.string().optional(),
+    description: z
+      .string()
+      .min(1, { message: t('bots.botDescriptionRequired') }),
     adapter: z.string().min(1, { message: t('bots.adapterRequired') }),
     adapter_config: z.record(z.string(), z.any()),
     enable: z.boolean().optional(),
@@ -63,13 +66,13 @@ const getFormSchema = (t: (key: string) => string) =>
 export default function BotForm({
   initBotId,
   onFormSubmit,
+  onBotDeleted,
   onNewBotCreated,
-  onDirtyChange,
 }: {
   initBotId?: string;
   onFormSubmit: (value: z.infer<ReturnType<typeof getFormSchema>>) => void;
+  onBotDeleted: () => void;
   onNewBotCreated: (botId: string) => void;
-  onDirtyChange?: (dirty: boolean) => void;
 }) {
   const { t } = useTranslation();
   const formSchema = getFormSchema(t);
@@ -78,7 +81,7 @@ export default function BotForm({
     resolver: zodResolver(formSchema),
     defaultValues: {
       name: '',
-      description: '',
+      description: t('bots.defaultDescription'),
       adapter: '',
       adapter_config: {},
       enable: true,
@@ -86,16 +89,19 @@ export default function BotForm({
     },
   });
 
-  // Track whether initial data loading is complete.
-  // setValue calls during init should NOT mark the form as dirty.
-  const isInitializing = useRef(true);
+  const [showDeleteConfirmModal, setShowDeleteConfirmModal] = useState(false);
 
   const [adapterNameToDynamicConfigMap, setAdapterNameToDynamicConfigMap] =
     useState(new Map<string, IDynamicFormItemSchema[]>());
+  // const [form] = Form.useForm<IBotFormEntity>();
   const [showDynamicForm, setShowDynamicForm] = useState<boolean>(false);
+  // const [dynamicForm] = Form.useForm();
   const [adapterNameList, setAdapterNameList] = useState<
     IChooseAdapterEntity[]
   >([]);
+  const [adapterIconList, setAdapterIconList] = useState<
+    Record<string, string>
+  >({});
   const [adapterDescriptionList, setAdapterDescriptionList] = useState<
     Record<string, string>
   >({});
@@ -107,134 +113,165 @@ export default function BotForm({
   const [dynamicFormConfigList, setDynamicFormConfigList] = useState<
     IDynamicFormItemSchema[]
   >([]);
+  const [filteredDynamicFormConfigList, setFilteredDynamicFormConfigList] =
+    useState<IDynamicFormItemSchema[]>([]);
   const [, setIsLoading] = useState<boolean>(false);
   const [webhookUrl, setWebhookUrl] = useState<string>('');
-  const [extraWebhookUrl, setExtraWebhookUrl] = useState<string>('');
+  const webhookInputRef = React.useRef<HTMLInputElement>(null);
   const [copied, setCopied] = useState<boolean>(false);
-  const [extraCopied, setExtraCopied] = useState<boolean>(false);
 
   // Watch adapter and adapter_config for filtering
   const currentAdapter = form.watch('adapter');
   const currentAdapterConfig = form.watch('adapter_config');
 
-  // Derive the filtered config list via useMemo instead of useEffect+setState
-  // to avoid creating new array references that would cause DynamicFormComponent
-  // to re-subscribe its form.watch, re-emit values, and trigger an infinite loop.
-  // Only depend on the specific field we care about (enable-webhook) rather than
-  // the entire currentAdapterConfig object, which changes on every emission.
-  const enableWebhook = currentAdapterConfig?.['enable-webhook'];
-  const filteredDynamicFormConfigList = useMemo(() => {
-    if (currentAdapter === 'lark' && enableWebhook === false) {
-      // Hide encrypt-key field when webhook is disabled
-      return dynamicFormConfigList.filter(
-        (config) => config.name !== 'encrypt-key',
-      );
-    }
-    // For non-Lark adapters or when webhook is enabled/undefined, show all fields
-    return dynamicFormConfigList;
-  }, [currentAdapter, enableWebhook, dynamicFormConfigList]);
-
-  // Notify parent when dirty state changes
-  const { isDirty } = form.formState;
-  useEffect(() => {
-    onDirtyChange?.(isDirty);
-  }, [isDirty, onDirtyChange]);
+  // Serialize adapter_config to a stable string so it can be used as a
+  // useEffect dependency without triggering on every render.  form.watch()
+  // returns a new object reference each time, which would otherwise cause
+  // the filtering effect below to loop indefinitely.
+  const adapterConfigJson = JSON.stringify(currentAdapterConfig);
 
   useEffect(() => {
     setBotFormValues();
   }, []);
 
-  const copyToClipboard = (
-    text: string,
-    setStatus: React.Dispatch<React.SetStateAction<boolean>>,
-  ) => {
-    if (navigator.clipboard && navigator.clipboard.writeText) {
-      navigator.clipboard
-        .writeText(text)
-        .then(() => {
-          setStatus(true);
-          setTimeout(() => setStatus(false), 2000);
-        })
-        .catch(() => {
-          fallbackCopy(text, setStatus);
-        });
+  // Filter dynamic form config list based on enable-webhook status for Lark adapter
+  useEffect(() => {
+    if (currentAdapter === 'lark') {
+      const enableWebhook = currentAdapterConfig?.['enable-webhook'];
+      if (enableWebhook === false) {
+        // Hide encrypt-key field when webhook is disabled
+        setFilteredDynamicFormConfigList(
+          dynamicFormConfigList.filter(
+            (config) => config.name !== 'encrypt-key',
+          ),
+        );
+      } else {
+        // Show all fields when webhook is enabled or undefined
+        setFilteredDynamicFormConfigList(dynamicFormConfigList);
+      }
     } else {
-      fallbackCopy(text, setStatus);
+      // For non-Lark adapters, show all fields
+      setFilteredDynamicFormConfigList(dynamicFormConfigList);
     }
-  };
+  }, [currentAdapter, adapterConfigJson, dynamicFormConfigList]);
 
-  const fallbackCopy = (
-    text: string,
-    setStatus: React.Dispatch<React.SetStateAction<boolean>>,
-  ) => {
-    const textarea = document.createElement('textarea');
-    textarea.value = text;
-    textarea.style.position = 'fixed';
-    textarea.style.opacity = '0';
-    document.body.appendChild(textarea);
-    textarea.select();
-    const successful = document.execCommand('copy');
-    document.body.removeChild(textarea);
-    if (successful) {
-      setStatus(true);
-      setTimeout(() => setStatus(false), 2000);
+  // 复制到剪贴板的辅助函数 - 使用页面上的真实input元素
+  const copyToClipboard = () => {
+    console.log('[Copy] Attempting to copy from input element');
+
+    const inputElement = webhookInputRef.current;
+    if (!inputElement) {
+      console.error('[Copy] Input element not found');
+      return;
+    }
+
+    try {
+      // 确保input元素可见且未被禁用
+      inputElement.disabled = false;
+      inputElement.readOnly = false;
+
+      // 聚焦并选中所有文本
+      inputElement.focus();
+      inputElement.select();
+
+      // 尝试使用现代API
+      if (navigator.clipboard && navigator.clipboard.writeText) {
+        console.log(
+          '[Copy] Using Clipboard API with input value:',
+          inputElement.value,
+        );
+        navigator.clipboard
+          .writeText(inputElement.value)
+          .then(() => {
+            console.log('[Copy] Clipboard API success');
+            inputElement.blur(); // 取消选中
+            inputElement.readOnly = true;
+            setCopied(true);
+            setTimeout(() => setCopied(false), 2000);
+          })
+          .catch((err) => {
+            console.error(
+              '[Copy] Clipboard API failed, trying execCommand:',
+              err,
+            );
+            // 降级到execCommand
+            const successful = document.execCommand('copy');
+            console.log('[Copy] execCommand result:', successful);
+            inputElement.blur();
+            inputElement.readOnly = true;
+            if (successful) {
+              setCopied(true);
+              setTimeout(() => setCopied(false), 2000);
+            }
+          });
+      } else {
+        // 直接使用execCommand
+        console.log(
+          '[Copy] Using execCommand with input value:',
+          inputElement.value,
+        );
+        const successful = document.execCommand('copy');
+        console.log('[Copy] execCommand result:', successful);
+        inputElement.blur();
+        inputElement.readOnly = true;
+        if (successful) {
+          setCopied(true);
+          setTimeout(() => setCopied(false), 2000);
+        }
+      }
+    } catch (err) {
+      console.error('[Copy] Copy failed:', err);
+      inputElement.readOnly = true;
     }
   };
 
   function setBotFormValues() {
-    isInitializing.current = true;
     initBotFormComponent().then(() => {
+      // 拉取初始化表单信息
       if (initBotId) {
         getBotConfig(initBotId)
           .then((val) => {
-            // Use form.reset() to set values AND update the dirty baseline,
-            // so isDirty stays false after initial load.
-            form.reset({
-              name: val.name,
-              description: val.description,
-              adapter: val.adapter,
-              adapter_config: val.adapter_config,
-              enable: val.enable,
-              use_pipeline_uuid: val.use_pipeline_uuid || '',
-            });
+            form.setValue('name', val.name);
+            form.setValue('description', val.description);
+            form.setValue('adapter', val.adapter);
+            form.setValue('adapter_config', val.adapter_config);
+            form.setValue('enable', val.enable);
+            form.setValue('use_pipeline_uuid', val.use_pipeline_uuid || '');
             handleAdapterSelect(val.adapter);
+            // dynamicForm.setFieldsValue(val.adapter_config);
 
+            // 设置 webhook 地址（如果有）
             if (val.webhook_full_url) {
               setWebhookUrl(val.webhook_full_url);
             } else {
               setWebhookUrl('');
             }
-            setExtraWebhookUrl(val.extra_webhook_full_url || '');
           })
           .catch((err) => {
             toast.error(
               t('bots.getBotConfigError') + (err as CustomApiError).msg,
             );
-          })
-          .finally(() => {
-            isInitializing.current = false;
           });
       } else {
         form.reset();
         setWebhookUrl('');
-        setExtraWebhookUrl('');
-        isInitializing.current = false;
       }
     });
   }
 
   async function initBotFormComponent() {
+    // 初始化流水线列表
     const pipelinesRes = await httpClient.getPipelines();
     setPipelineNameList(
       pipelinesRes.pipelines.map((item) => {
         return {
           label: item.name,
           value: item.uuid ?? '',
-          emoji: item.emoji,
         };
       }),
     );
 
+    // 拉取adapter
     const adaptersRes = await httpClient.getAdapters();
     setAdapterNameList(
       adaptersRes.adapters.map((item) => {
@@ -245,6 +282,18 @@ export default function BotForm({
       }),
     );
 
+    // 初始化适配器图标列表
+    setAdapterIconList(
+      adaptersRes.adapters.reduce(
+        (acc, item) => {
+          acc[item.name] = httpClient.getAdapterIconURL(item.name);
+          return acc;
+        },
+        {} as Record<string, string>,
+      ),
+    );
+
+    // 初始化适配器描述列表
     setAdapterDescriptionList(
       adaptersRes.adapters.reduce(
         (acc, item) => {
@@ -255,6 +304,7 @@ export default function BotForm({
       ),
     );
 
+    // 初始化适配器表单map
     adaptersRes.adapters.forEach((rawAdapter) => {
       adapterNameToDynamicConfigMap.set(
         rawAdapter.name,
@@ -277,20 +327,14 @@ export default function BotForm({
     setAdapterNameToDynamicConfigMap(adapterNameToDynamicConfigMap);
   }
 
-  async function getBotConfig(botId: string): Promise<
-    z.infer<typeof formSchema> & {
-      webhook_full_url?: string;
-      extra_webhook_full_url?: string;
-    }
-  > {
+  async function getBotConfig(
+    botId: string,
+  ): Promise<z.infer<typeof formSchema> & { webhook_full_url?: string }> {
     return new Promise((resolve, reject) => {
       httpClient
         .getBot(botId)
         .then((res) => {
           const bot = res.bot;
-          const runtimeValues = bot.adapter_runtime_values as
-            | Record<string, unknown>
-            | undefined;
           resolve({
             adapter: bot.adapter,
             description: bot.description,
@@ -298,12 +342,10 @@ export default function BotForm({
             adapter_config: bot.adapter_config,
             enable: bot.enable ?? true,
             use_pipeline_uuid: bot.use_pipeline_uuid ?? '',
-            webhook_full_url: runtimeValues?.webhook_full_url as
-              | string
-              | undefined,
-            extra_webhook_full_url: runtimeValues?.extra_webhook_full_url as
-              | string
-              | undefined,
+            webhook_full_url: bot.adapter_runtime_values
+              ? ((bot.adapter_runtime_values as Record<string, unknown>)
+                  .webhook_full_url as string)
+              : undefined,
           });
         })
         .catch((err) => {
@@ -331,13 +373,15 @@ export default function BotForm({
     }
   }
 
+  // 只有通过外层固定表单验证才会走到这里，真正的提交逻辑在这里
   function onDynamicFormSubmit() {
     setIsLoading(true);
     if (initBotId) {
+      // 编辑提交
       const updateBot: Bot = {
         uuid: initBotId,
         name: form.getValues().name,
-        description: form.getValues().description ?? '',
+        description: form.getValues().description,
         adapter: form.getValues().adapter,
         adapter_config: form.getValues().adapter_config,
         enable: form.getValues().enable,
@@ -346,8 +390,6 @@ export default function BotForm({
       httpClient
         .updateBot(initBotId, updateBot)
         .then(() => {
-          // Reset dirty baseline to current values so isDirty becomes false
-          form.reset(form.getValues());
           onFormSubmit(form.getValues());
           toast.success(t('bots.saveSuccess'));
         })
@@ -356,11 +398,14 @@ export default function BotForm({
         })
         .finally(() => {
           setIsLoading(false);
+          // form.reset();
+          // dynamicForm.resetFields();
         });
     } else {
+      // 创建提交
       const newBot: Bot = {
         name: form.getValues().name,
-        description: form.getValues().description ?? '',
+        description: form.getValues().description,
         adapter: form.getValues().adapter,
         adapter_config: form.getValues().adapter_config,
       };
@@ -380,30 +425,154 @@ export default function BotForm({
         .finally(() => {
           setIsLoading(false);
           form.reset();
+          // dynamicForm.resetFields();
         });
     }
   }
 
-  // --- Webhook URL display helper ---
-  const showWebhook =
-    initBotId &&
-    webhookUrl &&
-    (currentAdapter !== 'lark' || enableWebhook !== false);
+  function deleteBot() {
+    if (initBotId) {
+      httpClient
+        .deleteBot(initBotId)
+        .then(() => {
+          onBotDeleted();
+          toast.success(t('bots.deleteSuccess'));
+        })
+        .catch((err) => {
+          toast.error(t('bots.deleteError') + err.msg);
+        });
+    }
+  }
 
   return (
-    <Form {...form}>
-      <form
-        id="bot-form"
-        onSubmit={form.handleSubmit(onDynamicFormSubmit)}
-        className="space-y-6"
+    <div>
+      <Dialog
+        open={showDeleteConfirmModal}
+        onOpenChange={setShowDeleteConfirmModal}
       >
-        {/* Card 1: Basic Information */}
-        <Card>
-          <CardHeader>
-            <CardTitle>{t('bots.basicInfo')}</CardTitle>
-            <CardDescription>{t('bots.basicInfoDescription')}</CardDescription>
-          </CardHeader>
-          <CardContent className="space-y-4">
+        <DialogContent>
+          <DialogHeader>
+            <DialogTitle>{t('common.confirmDelete')}</DialogTitle>
+          </DialogHeader>
+          <DialogDescription>{t('bots.deleteConfirmation')}</DialogDescription>
+          <DialogFooter>
+            <Button
+              variant="outline"
+              onClick={() => setShowDeleteConfirmModal(false)}
+            >
+              取消
+            </Button>
+            <Button
+              variant="destructive"
+              onClick={() => {
+                deleteBot();
+                setShowDeleteConfirmModal(false);
+              }}
+            >
+              {t('common.confirmDelete')}
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+
+      <Form {...form}>
+        <form
+          id="bot-form"
+          onSubmit={form.handleSubmit(onDynamicFormSubmit)}
+          className="space-y-8"
+        >
+          <div className="space-y-4">
+            {/* 是否启用 & 绑定流水线  仅在编辑模式 */}
+            {initBotId && (
+              <>
+                <div className="flex items-center gap-6">
+                  <FormField
+                    control={form.control}
+                    name="enable"
+                    render={({ field }) => (
+                      <FormItem className="flex flex-col justify-start gap-[0.8rem] h-[3.8rem]">
+                        <FormLabel>{t('common.enable')}</FormLabel>
+                        <FormControl>
+                          <Switch
+                            checked={field.value}
+                            onCheckedChange={field.onChange}
+                          />
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+
+                  <FormField
+                    control={form.control}
+                    name="use_pipeline_uuid"
+                    render={({ field }) => (
+                      <FormItem className="flex flex-col justify-start gap-[0.8rem] h-[3.8rem]">
+                        <FormLabel>{t('bots.bindPipeline')}</FormLabel>
+                        <FormControl>
+                          <Select onValueChange={field.onChange} {...field}>
+                            <SelectTrigger className="bg-[#ffffff] dark:bg-[#2a2a2e]">
+                              <SelectValue
+                                placeholder={t('bots.selectPipeline')}
+                              />
+                            </SelectTrigger>
+                            <SelectContent className="fixed z-[1000]">
+                              <SelectGroup>
+                                {pipelineNameList.map((item) => (
+                                  <SelectItem
+                                    key={item.value}
+                                    value={item.value}
+                                  >
+                                    {item.label}
+                                  </SelectItem>
+                                ))}
+                              </SelectGroup>
+                            </SelectContent>
+                          </Select>
+                        </FormControl>
+                      </FormItem>
+                    )}
+                  />
+                </div>
+
+                {/* Webhook 地址显示（统一 Webhook 模式） */}
+                {webhookUrl &&
+                  (currentAdapter !== 'lark' ||
+                    currentAdapterConfig?.['enable-webhook'] !== false) && (
+                    <FormItem>
+                      <FormLabel>{t('bots.webhookUrl')}</FormLabel>
+                      <div className="flex items-center gap-2">
+                        <Input
+                          ref={webhookInputRef}
+                          value={webhookUrl}
+                          readOnly
+                          className="flex-1 bg-gray-50 dark:bg-gray-900"
+                          onClick={(e) => {
+                            // 点击输入框时自动全选
+                            (e.target as HTMLInputElement).select();
+                          }}
+                        />
+                        <Button
+                          type="button"
+                          variant="outline"
+                          size="sm"
+                          onClick={copyToClipboard}
+                        >
+                          {copied ? (
+                            <Check className="h-4 w-4 text-green-600 mr-2" />
+                          ) : (
+                            <Copy className="h-4 w-4 mr-2" />
+                          )}
+                          {t('common.copy')}
+                        </Button>
+                      </div>
+                      <p className="text-sm text-gray-500 mt-1">
+                        {t('bots.webhookUrlHint')}
+                      </p>
+                    </FormItem>
+                  )}
+              </>
+            )}
+
             <FormField
               control={form.control}
               name="name"
@@ -411,7 +580,7 @@ export default function BotForm({
                 <FormItem>
                   <FormLabel>
                     {t('bots.botName')}
-                    <span className="text-destructive">*</span>
+                    <span className="text-red-500">*</span>
                   </FormLabel>
                   <FormControl>
                     <Input {...field} />
@@ -425,7 +594,10 @@ export default function BotForm({
               name="description"
               render={({ field }) => (
                 <FormItem>
-                  <FormLabel>{t('bots.botDescription')}</FormLabel>
+                  <FormLabel>
+                    {t('bots.botDescription')}
+                    <span className="text-red-500">*</span>
+                  </FormLabel>
                   <FormControl>
                     <Input {...field} />
                   </FormControl>
@@ -433,84 +605,7 @@ export default function BotForm({
                 </FormItem>
               )}
             />
-          </CardContent>
-        </Card>
 
-        {/* Card 2: Pipeline Binding (edit mode only) */}
-        {initBotId && (
-          <Card>
-            <CardHeader>
-              <CardTitle>{t('bots.routingConnection')}</CardTitle>
-              <CardDescription>
-                {t('bots.routingConnectionDescription')}
-              </CardDescription>
-            </CardHeader>
-            <CardContent>
-              <FormField
-                control={form.control}
-                name="use_pipeline_uuid"
-                render={({ field }) => (
-                  <FormItem>
-                    <FormLabel>{t('bots.bindPipeline')}</FormLabel>
-                    <FormControl>
-                      <Select onValueChange={field.onChange} {...field}>
-                        <SelectTrigger>
-                          {field.value ? (
-                            (() => {
-                              const pipeline = pipelineNameList.find(
-                                (p) => p.value === field.value,
-                              );
-                              return (
-                                <div className="flex items-center gap-2">
-                                  {pipeline?.emoji && (
-                                    <span className="text-sm shrink-0">
-                                      {pipeline.emoji}
-                                    </span>
-                                  )}
-                                  <span>{pipeline?.label ?? field.value}</span>
-                                </div>
-                              );
-                            })()
-                          ) : (
-                            <SelectValue
-                              placeholder={t('bots.selectPipeline')}
-                            />
-                          )}
-                        </SelectTrigger>
-                        <SelectContent>
-                          <SelectGroup>
-                            {pipelineNameList.map((item) => (
-                              <SelectItem key={item.value} value={item.value}>
-                                <div className="flex items-center gap-2">
-                                  {item.emoji && (
-                                    <span className="text-sm shrink-0">
-                                      {item.emoji}
-                                    </span>
-                                  )}
-                                  <span>{item.label}</span>
-                                </div>
-                              </SelectItem>
-                            ))}
-                          </SelectGroup>
-                        </SelectContent>
-                      </Select>
-                    </FormControl>
-                  </FormItem>
-                )}
-              />
-            </CardContent>
-          </Card>
-        )}
-
-        {/* Card 3: Adapter Configuration */}
-        <Card>
-          <CardHeader>
-            <CardTitle>{t('bots.adapterConfig')}</CardTitle>
-            <CardDescription>
-              {t('bots.adapterConfigDescription')}
-            </CardDescription>
-          </CardHeader>
-          <CardContent className="space-y-4">
             <FormField
               control={form.control}
               name="adapter"
@@ -518,136 +613,76 @@ export default function BotForm({
                 <FormItem>
                   <FormLabel>
                     {t('bots.platformAdapter')}
-                    <span className="text-destructive">*</span>
+                    <span className="text-red-500">*</span>
                   </FormLabel>
                   <FormControl>
-                    <Select
-                      onValueChange={(value) => {
-                        field.onChange(value);
-                        handleAdapterSelect(value);
-                      }}
-                      value={field.value}
-                    >
-                      <SelectTrigger className="w-[240px]">
-                        {field.value ? (
-                          <div className="flex items-center gap-2">
-                            <img
-                              src={httpClient.getAdapterIconURL(field.value)}
-                              alt=""
-                              className="h-5 w-5 rounded"
-                            />
-                            <span>
-                              {adapterNameList.find(
-                                (a) => a.value === field.value,
-                              )?.label ?? field.value}
-                            </span>
-                          </div>
-                        ) : (
+                    <div className="relative">
+                      <Select
+                        onValueChange={(value) => {
+                          field.onChange(value);
+                          handleAdapterSelect(value);
+                        }}
+                        value={field.value}
+                      >
+                        <SelectTrigger className="w-[180px] bg-[#ffffff] dark:bg-[#2a2a2e]">
                           <SelectValue placeholder={t('bots.selectAdapter')} />
-                        )}
-                      </SelectTrigger>
-                      <SelectContent>
-                        <SelectGroup>
-                          {adapterNameList.map((item) => (
-                            <SelectItem key={item.value} value={item.value}>
-                              <div className="flex items-center gap-2">
-                                <img
-                                  src={httpClient.getAdapterIconURL(item.value)}
-                                  alt=""
-                                  className="h-5 w-5 rounded"
-                                />
-                                <span>{item.label}</span>
-                              </div>
-                            </SelectItem>
-                          ))}
-                        </SelectGroup>
-                      </SelectContent>
-                    </Select>
+                        </SelectTrigger>
+                        <SelectContent className="fixed z-[1000]">
+                          <SelectGroup>
+                            {adapterNameList.map((item) => (
+                              <SelectItem key={item.value} value={item.value}>
+                                {item.label}
+                              </SelectItem>
+                            ))}
+                          </SelectGroup>
+                        </SelectContent>
+                      </Select>
+                    </div>
                   </FormControl>
-                  {currentAdapter && adapterDescriptionList[currentAdapter] && (
-                    <FormDescription>
-                      {adapterDescriptionList[currentAdapter]}
-                    </FormDescription>
-                  )}
                   <FormMessage />
                 </FormItem>
               )}
             />
 
-            {/* Webhook URL: shown after adapter is selected (edit mode only) */}
-            {showWebhook && (
-              <FormItem>
-                <FormLabel>{t('bots.webhookUrl')}</FormLabel>
-                <div className="flex items-center gap-2">
-                  <Input
-                    value={webhookUrl}
-                    readOnly
-                    className="flex-1 bg-muted"
-                    onClick={(e) => {
-                      (e.target as HTMLInputElement).select();
-                    }}
-                  />
-                  <Button
-                    type="button"
-                    variant="outline"
-                    size="sm"
-                    onClick={() => copyToClipboard(webhookUrl, setCopied)}
-                  >
-                    {copied ? (
-                      <Check className="h-4 w-4 text-green-600" />
-                    ) : (
-                      <Copy className="h-4 w-4" />
-                    )}
-                  </Button>
-                </div>
-                {extraWebhookUrl && (
-                  <div className="flex items-center gap-2 mt-2">
-                    <Input
-                      value={extraWebhookUrl}
-                      readOnly
-                      className="flex-1 bg-muted"
-                      onClick={(e) => {
-                        (e.target as HTMLInputElement).select();
-                      }}
-                    />
-                    <Button
-                      type="button"
-                      variant="outline"
-                      size="sm"
-                      onClick={() =>
-                        copyToClipboard(extraWebhookUrl, setExtraCopied)
-                      }
-                    >
-                      {extraCopied ? (
-                        <Check className="h-4 w-4 text-green-600" />
-                      ) : (
-                        <Copy className="h-4 w-4" />
-                      )}
-                    </Button>
+            {form.watch('adapter') && (
+              <div className="flex items-start gap-3 p-4 rounded-lg border">
+                <img
+                  src={adapterIconList[form.watch('adapter')]}
+                  alt="adapter icon"
+                  className="w-12 h-12 rounded-[8%]"
+                />
+                <div className="flex flex-col gap-1">
+                  <div className="font-medium">
+                    {
+                      adapterNameList.find(
+                        (item) => item.value === form.watch('adapter'),
+                      )?.label
+                    }
                   </div>
-                )}
-                <FormDescription>
-                  {extraWebhookUrl
-                    ? t('bots.webhookUrlHintEither')
-                    : t('bots.webhookUrlHint')}
-                </FormDescription>
-              </FormItem>
+                  <div className="text-sm text-gray-500">
+                    {adapterDescriptionList[form.watch('adapter')]}
+                  </div>
+                </div>
+              </div>
             )}
 
             {showDynamicForm && filteredDynamicFormConfigList.length > 0 && (
-              <DynamicFormComponent
-                itemConfigList={filteredDynamicFormConfigList}
-                initialValues={currentAdapterConfig}
-                onSubmit={(values) => {
-                  form.setValue('adapter_config', values, {
-                    shouldDirty: !isInitializing.current,
-                  });
-                }}
-              />
+              <div className="space-y-4">
+                <div className="text-lg font-medium">
+                  {t('bots.adapterConfig')}
+                </div>
+                <DynamicFormComponent
+                  itemConfigList={filteredDynamicFormConfigList}
+                  initialValues={form.watch('adapter_config')}
+                  onSubmit={(values) => {
+                    form.setValue('adapter_config', values);
+                  }}
+                />
+              </div>
             )}
-          </CardContent>
-        </Card>
-      </form>
-    </Form>
+          </div>
+        </form>
+      </Form>
+    </div>
   );
 }

web/src/app/home/bots/components/bot-form/ChooseEntity.ts

@@ -6,5 +6,4 @@ export interface IChooseAdapterEntity {
 export interface IPipelineEntity {
   label: string;
   value: string;
-  emoji?: string;
 }

web/src/app/home/bots/components/bot-log/view/BotLogCard.tsx

@@ -2,187 +2,220 @@
 
 import { useState } from 'react';
 import { BotLog } from '@/app/infra/http/requestParam/bots/GetBotLogsResponse';
+import styles from './botLog.module.css';
 import { httpClient } from '@/app/infra/http/HttpClient';
 import { PhotoProvider } from 'react-photo-view';
 import { useTranslation } from 'react-i18next';
-import { Check, ChevronDown, ChevronRight, Copy } from 'lucide-react';
+import { Check, ChevronDown, ChevronRight } from 'lucide-react';
 import { toast } from 'sonner';
-import { cn } from '@/lib/utils';
 
-const LEVEL_STYLES: Record<string, string> = {
-  error: 'bg-red-100 text-red-700 dark:bg-red-900/30 dark:text-red-400',
-  warning:
-    'bg-orange-100 text-orange-700 dark:bg-orange-900/30 dark:text-orange-400',
-  info: 'bg-blue-100 text-blue-700 dark:bg-blue-900/30 dark:text-blue-400',
-  debug: 'bg-muted text-muted-foreground',
-};
-
-const SHORT_TEXT_LIMIT = 120;
-
-export function BotLogCard({
-  botLog,
-  defaultExpanded = false,
-}: {
-  botLog: BotLog;
-  defaultExpanded?: boolean;
-}) {
+export function BotLogCard({ botLog }: { botLog: BotLog }) {
   const { t } = useTranslation();
   const baseURL = httpClient.getBaseUrl();
   const [copied, setCopied] = useState(false);
-  const [expanded, setExpanded] = useState(defaultExpanded);
-
-  function copySessionId() {
-    const text = botLog.message_session_id;
-    if (navigator.clipboard?.writeText) {
-      navigator.clipboard
-        .writeText(text)
-        .then(() => {
-          setCopied(true);
-          setTimeout(() => setCopied(false), 2000);
-          toast.success(t('common.copySuccess'));
-        })
-        .catch(() => fallbackCopy(text));
-    } else {
-      fallbackCopy(text);
-    }
-  }
+  const [expanded, setExpanded] = useState(false);
 
+  // Fallback 复制方法，用于不支持 clipboard API 的环境
   function fallbackCopy(text: string) {
-    const ta = document.createElement('textarea');
-    ta.value = text;
-    ta.style.cssText = 'position:fixed;left:-9999px;top:-9999px';
-    document.body.appendChild(ta);
-    ta.focus();
-    ta.select();
+    const textArea = document.createElement('textarea');
+    textArea.value = text;
+    textArea.style.position = 'fixed';
+    textArea.style.left = '-9999px';
+    textArea.style.top = '-9999px';
+    document.body.appendChild(textArea);
+    textArea.focus();
+    textArea.select();
     try {
       document.execCommand('copy');
-      setCopied(true);
-      setTimeout(() => setCopied(false), 2000);
       toast.success(t('common.copySuccess'));
     } catch {
       toast.error(t('common.copyFailed'));
     }
-    document.body.removeChild(ta);
+    document.body.removeChild(textArea);
   }
 
   function formatTime(timestamp: number) {
     const now = new Date();
     const date = new Date(timestamp * 1000);
+
+    // 获取各个时间部分
+    const year = date.getFullYear();
+    const month = date.getMonth() + 1; // 月份从0开始，需要+1
+    const day = date.getDate();
     const hours = date.getHours().toString().padStart(2, '0');
     const minutes = date.getMinutes().toString().padStart(2, '0');
 
+    // 判断时间范围
     const isToday = now.toDateString() === date.toDateString();
-    const yesterday = new Date(now);
-    yesterday.setDate(yesterday.getDate() - 1);
-    const isYesterday = yesterday.toDateString() === date.toDateString();
-    const isThisYear = now.getFullYear() === date.getFullYear();
+    const isYesterday =
+      new Date(now.setDate(now.getDate() - 1)).toDateString() ===
+      date.toDateString();
+    const isThisYear = now.getFullYear() === year;
 
-    if (isToday) return `${hours}:${minutes}`;
-    if (isYesterday) return `${t('bots.yesterday')} ${hours}:${minutes}`;
-    if (isThisYear)
-      return t('bots.dateFormat', {
-        month: date.getMonth() + 1,
-        day: date.getDate(),
-      });
-    return t('bots.earlier');
+    if (isToday) {
+      return `${hours}:${minutes}`; // 今天的消息：小时:分钟
+    } else if (isYesterday) {
+      return `${t('bots.yesterday')} ${hours}:${minutes}`; // 昨天的消息：昨天 小时:分钟
+    } else if (isThisYear) {
+      return t('bots.dateFormat', { month, day }); // 本年消息：x月x日
+    } else {
+      return t('bots.earlier'); // 更早的消息：更久之前
+    }
   }
 
-  const needsExpand =
-    botLog.text.length > SHORT_TEXT_LIMIT || botLog.images.length > 0;
-  const levelStyle =
-    LEVEL_STYLES[botLog.level.toLowerCase()] ?? LEVEL_STYLES.debug;
+  function getSubChatId(str: string) {
+    const strArr = str.split('');
+    return strArr;
+  }
+
+  // 根据日志级别返回对应的样式类
+  function getLevelStyles(level: string) {
+    switch (level.toLowerCase()) {
+      case 'error':
+        return 'bg-red-100 text-red-800 dark:bg-red-900/30 dark:text-red-400';
+      case 'warning':
+        return 'bg-orange-100 text-orange-800 dark:bg-orange-900/30 dark:text-orange-400';
+      case 'info':
+        return 'bg-blue-100 text-blue-800 dark:bg-blue-900/30 dark:text-blue-400';
+      case 'debug':
+        return 'bg-gray-100 text-gray-800 dark:bg-gray-900/30 dark:text-gray-400';
+      default:
+        return 'bg-gray-100 text-gray-800 dark:bg-gray-900/30 dark:text-gray-400';
+    }
+  }
+
+  // 截取文本的简短版本
+  function getShortText(text: string, maxLength: number = 100) {
+    if (text.length <= maxLength) return text;
+    return text.substring(0, maxLength) + '...';
+  }
+
+  // 判断是否需要展开按钮
+  const needsExpand = botLog.text.length > 100 || botLog.images.length > 0;
 
   return (
-    <div className="rounded-lg border bg-card px-3.5 py-3 transition-colors hover:border-border/80">
-      {/* Header: level badge, session id, expand toggle, timestamp */}
-      <div className="flex items-center justify-between gap-2">
-        <div className="flex items-center gap-2 min-w-0">
-          {/* Level badge */}
-          <span
-            className={cn(
-              'inline-flex shrink-0 items-center rounded px-1.5 py-0.5 text-[11px] font-semibold uppercase leading-none',
-              levelStyle,
-            )}
+    <div className={`${styles.botLogCardContainer}`}>
+      {/* 头部标签，时间 */}
+      <div className={`${styles.cardTitleContainer}`}>
+        <div className={`flex flex-row gap-2 items-center`}>
+          <div
+            className={`px-2 py-1 rounded text-xs font-medium uppercase ${getLevelStyles(
+              botLog.level,
+            )}`}
           >
             {botLog.level}
-          </span>
-
-          {/* Session ID */}
+          </div>
           {botLog.message_session_id && (
-            <button
-              type="button"
+            <div
+              className={`${styles.tag} ${styles.chatTag} relative`}
               onClick={(e) => {
                 e.stopPropagation();
-                copySessionId();
+                // 兼容性更好的复制方法
+                if (navigator.clipboard && navigator.clipboard.writeText) {
+                  navigator.clipboard
+                    .writeText(botLog.message_session_id)
+                    .then(() => {
+                      setCopied(true);
+                      setTimeout(() => setCopied(false), 2000);
+                      toast.success(t('common.copySuccess'));
+                    })
+                    .catch(() => {
+                      // fallback
+                      fallbackCopy(botLog.message_session_id);
+                    });
+                } else {
+                  fallbackCopy(botLog.message_session_id);
+                }
               }}
               title={t('common.clickToCopy')}
-              className="inline-flex items-center gap-1 rounded bg-muted px-1.5 py-0.5 text-[11px] font-mono text-muted-foreground hover:bg-accent hover:text-accent-foreground transition-colors truncate max-w-48 cursor-pointer"
             >
               {copied ? (
-                <Check className="size-3 shrink-0 text-green-600" />
+                <Check className="w-4 h-4 text-green-600" />
               ) : (
-                <Copy className="size-3 shrink-0" />
+                <svg
+                  className="icon"
+                  viewBox="0 0 1024 1024"
+                  version="1.1"
+                  xmlns="http://www.w3.org/2000/svg"
+                  p-id="1664"
+                  width="16"
+                  height="16"
+                  fill="currentColor"
+                >
+                  <path
+                    d="M96.1 575.7a32.2 32.1 0 1 0 64.4 0 32.2 32.1 0 1 0-64.4 0Z"
+                    p-id="1665"
+                    fill="currentColor"
+                  ></path>
+                  <path
+                    d="M742.1 450.7l-269.5-2.1c-14.3-0.1-26 13.8-26 31s11.7 31.3 26 31.4l269.5 2.1c14.3 0.1 26-13.8 26-31s-11.7-31.3-26-31.4zM742.1 577.7l-269.5-2.1c-14.3-0.1-26 13.8-26 31s11.7 31.3 26 31.4l269.5 2.1c14.3 0.2 26-13.8 26-31s-11.7-31.3-26-31.4z"
+                    p-id="1666"
+                    fill="currentColor"
+                  ></path>
+                  <path
+                    d="M736.1 63.9H417c-70.4 0-128 57.6-128 128h-64.9c-70.4 0-128 57.6-128 128v128c-0.1 17.7 14.4 32 32.2 32 17.8 0 32.2-14.4 32.2-32.1V320c0-35.2 28.8-64 64-64H289v447.8c0 70.4 57.6 128 128 128h255.1c-0.1 35.2-28.8 63.8-64 63.8H224.5c-35.2 0-64-28.8-64-64V703.5c0-17.7-14.4-32.1-32.2-32.1-17.8 0-32.3 14.4-32.3 32.1v128.3c0 70.4 57.6 128 128 128h384.1c70.4 0 128-57.6 128-128h65c70.4 0 128-57.6 128-128V255.9l-193-192z m0.1 63.4l127.7 128.3H800c-35.2 0-64-28.8-64-64v-64.3h0.2z m64 641H416.1c-35.2 0-64-28.8-64-64v-513c0-35.2 28.8-64 64-64H671V191c0 70.4 57.6 128 128 128h65.2v385.3c0 35.2-28.8 64-64 64z"
+                    p-id="1667"
+                    fill="currentColor"
+                  ></path>
+                </svg>
               )}
-              <span className="truncate">{botLog.message_session_id}</span>
-            </button>
+
+              <span className={`${styles.chatId}`}>
+                {getSubChatId(botLog.message_session_id)}
+              </span>
+            </div>
           )}
         </div>
-
-        <div className="flex items-center gap-2 shrink-0">
+        <div className="flex items-center gap-2">
           {needsExpand && (
             <button
-              type="button"
               onClick={() => setExpanded(!expanded)}
-              className="flex items-center gap-0.5 text-[11px] text-muted-foreground hover:text-foreground transition-colors"
+              className="flex items-center gap-1 text-xs text-blue-600 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-300 transition-colors"
             >
               {expanded ? (
                 <>
-                  <ChevronDown className="size-3" />
+                  <ChevronDown className="w-3 h-3" />
                   {t('bots.collapse')}
                 </>
               ) : (
                 <>
-                  <ChevronRight className="size-3" />
+                  <ChevronRight className="w-3 h-3" />
                   {t('bots.viewDetails')}
                 </>
               )}
             </button>
           )}
-          <span className="text-[11px] text-muted-foreground tabular-nums">
+          <div className={`${styles.timestamp}`}>
             {formatTime(botLog.timestamp)}
-          </span>
+          </div>
         </div>
       </div>
 
-      {/* Log text */}
-      <div className="mt-2 text-sm leading-relaxed text-foreground whitespace-pre-wrap break-words overflow-wrap-anywhere">
-        {expanded
-          ? botLog.text
-          : botLog.text.length > SHORT_TEXT_LIMIT
-            ? botLog.text.slice(0, SHORT_TEXT_LIMIT) + '...'
-            : botLog.text}
+      {/* 日志内容 - 简化显示 */}
+      <div className={`${styles.cardText}`}>
+        {expanded ? botLog.text : getShortText(botLog.text)}
       </div>
 
-      {/* Images (expanded) */}
+      {/* 图片 - 只在展开时显示 */}
       {expanded && botLog.images.length > 0 && (
         <PhotoProvider>
-          <div className="flex flex-wrap gap-2 mt-2.5">
+          <div className={`flex flex-wrap gap-2 mt-3`}>
             {botLog.images.map((item) => (
               <img
                 key={item}
                 src={`${baseURL}/api/v1/files/image/${item}`}
                 alt=""
-                className="max-w-xs rounded-md cursor-pointer hover:opacity-90 transition-opacity"
+                className="max-w-xs rounded cursor-pointer hover:opacity-90 transition-opacity"
               />
             ))}
           </div>
         </PhotoProvider>
       )}
 
-      {/* Image count hint (collapsed) */}
+      {/* 图片数量提示 - 未展开时显示 */}
       {!expanded && botLog.images.length > 0 && (
-        <div className="mt-1.5 text-[11px] text-muted-foreground">
-          {botLog.images.length} {t('bots.imagesAttached')}
+        <div className="mt-2 text-xs text-gray-500 dark:text-gray-400">
+          📷 {botLog.images.length} {t('bots.imagesAttached')}
         </div>
       )}
     </div>

web/src/app/home/bots/components/bot-log/view/BotLogListComponent.tsx

@@ -4,6 +4,7 @@ import { BotLogManager } from '@/app/home/bots/components/bot-log/BotLogManager'
 import { useCallback, useEffect, useRef, useState, useMemo } from 'react';
 import { BotLog } from '@/app/infra/http/requestParam/bots/GetBotLogsResponse';
 import { BotLogCard } from '@/app/home/bots/components/bot-log/view/BotLogCard';
+import styles from './botLog.module.css';
 import { Switch } from '@/components/ui/switch';
 import {
   Popover,
@@ -17,20 +18,7 @@ import { debounce } from 'lodash';
 import { useTranslation } from 'react-i18next';
 import { useRouter } from 'next/navigation';
 
-export function BotLogListComponent({
-  botId,
-  autoExpandImages = false,
-  hideDetailedLogsLink = false,
-  hideToolbar = false,
-}: {
-  botId: string;
-  /** When true, log entries with images are rendered expanded by default */
-  autoExpandImages?: boolean;
-  /** When true, hides the "View Detailed Logs" navigation button */
-  hideDetailedLogsLink?: boolean;
-  /** When true, hides the entire toolbar (auto-refresh, level filter, detailed logs link) */
-  hideToolbar?: boolean;
-}) {
+export function BotLogListComponent({ botId }: { botId: string }) {
   const { t } = useTranslation();
   const router = useRouter();
   const manager = useRef(new BotLogManager(botId)).current;
@@ -62,6 +50,7 @@ export function BotLogListComponent({
     botLogListRef.current = botLogList;
   }, [botLogList]);
 
+  // 根据级别过滤日志
   const filteredLogs = useMemo(() => {
     if (selectedLevels.length === 0) {
       return botLogList;
@@ -86,15 +75,18 @@ export function BotLogListComponent({
     if (selectedLevels.length === logLevels.length) {
       return t('bots.allLevels');
     }
+    // 如果选中3个或以上，显示数量
     if (selectedLevels.length >= 3) {
       return `${selectedLevels.length} ${t('bots.levelsSelected')}`;
     }
+    // 显示选中级别的标签（大写形式）
     return logLevels
       .filter((level) => selectedLevels.includes(level.value))
       .map((level) => level.label)
       .join(', ');
   };
 
+  // 观测自动刷新状态
   useEffect(() => {
     if (autoFlush) {
       manager.startListenServerPush();
@@ -107,10 +99,13 @@ export function BotLogListComponent({
   }, [autoFlush]);
 
   function initComponent() {
+    // 订阅日志推送
     manager.subscribeLogPush(handleBotLogPush);
+    // 加载第一页日志
     manager.loadFirstPage().then((response) => {
       setBotLogList(response.reverse());
     });
+    // 监听滚动
     listenScroll();
   }
 
@@ -120,19 +115,28 @@ export function BotLogListComponent({
   }
 
   function listenScroll() {
-    if (!listContainerRef.current) return;
-    listContainerRef.current.addEventListener('scroll', handleScroll);
+    if (!listContainerRef.current) {
+      return;
+    }
+    const list = listContainerRef.current;
+    list.addEventListener('scroll', handleScroll);
   }
 
   function removeScrollListener() {
-    if (!listContainerRef.current) return;
-    listContainerRef.current.removeEventListener('scroll', handleScroll);
+    if (!listContainerRef.current) {
+      return;
+    }
+    const list = listContainerRef.current;
+    list.removeEventListener('scroll', handleScroll);
   }
 
   function loadMore() {
+    // 加载更多日志
     const list = botLogListRef.current;
     const lastSeq = list[list.length - 1].seq_id;
-    if (lastSeq === 0) return;
+    if (lastSeq === 0) {
+      return;
+    }
     manager.loadMore(lastSeq - 1, 10).then((response) => {
       setBotLogList([...list, ...response.reverse()]);
     });
@@ -161,101 +165,63 @@ export function BotLogListComponent({
       if (!isTop && !isBottom) {
         setAutoFlush(false);
       }
-    }, 300),
-    [botLogList],
+    }, 300), // 防抖延迟 300ms
+    [botLogList], // 依赖项为空
   );
 
   return (
-    <div
-      className="flex flex-col h-full min-h-0 overflow-y-auto"
-      ref={listContainerRef}
-    >
-      {/* Toolbar */}
-      {!hideToolbar && (
-        <div className="flex items-center gap-3 pb-3 shrink-0 flex-wrap">
-          {/* Auto-refresh toggle */}
-          <div className="flex items-center gap-1.5">
-            <span className="text-sm text-muted-foreground">
-              {t('bots.enableAutoRefresh')}
-            </span>
-            <Switch
-              checked={autoFlush}
-              onCheckedChange={(v) => setAutoFlush(v)}
-            />
-          </div>
-
-          {/* Level filter */}
-          <div className="flex items-center gap-1.5">
-            <span className="text-sm text-muted-foreground">
-              {t('bots.logLevel')}
-            </span>
-            <Popover>
-              <PopoverTrigger asChild>
-                <Button
-                  variant="outline"
-                  size="sm"
-                  className="w-[160px] justify-between"
-                >
-                  <span className="text-sm truncate">{getDisplayText()}</span>
-                  <ChevronDownIcon className="size-3.5 shrink-0 opacity-50" />
-                </Button>
-              </PopoverTrigger>
-              <PopoverContent className="w-[160px] p-2">
-                <div className="flex flex-col gap-2">
-                  {logLevels.map((level) => (
-                    <div
-                      key={level.value}
-                      className="flex items-center space-x-2"
-                    >
-                      <Checkbox
-                        id={level.value}
-                        checked={selectedLevels.includes(level.value)}
-                        onCheckedChange={() => handleLevelToggle(level.value)}
-                      />
-                      <label
-                        htmlFor={level.value}
-                        className="text-sm font-medium leading-none cursor-pointer"
-                      >
-                        {level.label}
-                      </label>
-                    </div>
-                  ))}
-                </div>
-              </PopoverContent>
-            </Popover>
-          </div>
-
-          {/* Link to detailed logs */}
-          {!hideDetailedLogsLink && (
+    <div className={`${styles.botLogListContainer}`} ref={listContainerRef}>
+      <div className={`${styles.listHeader}`}>
+        <div className={'mr-2'}>{t('bots.enableAutoRefresh')}</div>
+        <Switch checked={autoFlush} onCheckedChange={(e) => setAutoFlush(e)} />
+        <div className={'ml-4 mr-2'}>{t('bots.logLevel')}</div>
+        <Popover>
+          <PopoverTrigger asChild>
             <Button
               variant="outline"
               size="sm"
-              className="gap-1"
-              onClick={() => router.push(`/home/monitoring?botId=${botId}`)}
+              className="w-[180px] flex items-center justify-between"
             >
-              <ExternalLink className="size-3.5" />
-              <span className="text-sm">{t('bots.viewDetailedLogs')}</span>
+              <span className="text-sm truncate flex-1 text-left">
+                {getDisplayText()}
+              </span>
+              <ChevronDownIcon className="ml-2 h-4 w-4 flex-shrink-0" />
             </Button>
-          )}
-        </div>
-      )}
+          </PopoverTrigger>
+          <PopoverContent className="w-[180px] p-2">
+            <div className="flex flex-col gap-2">
+              {logLevels.map((level) => (
+                <div key={level.value} className="flex items-center space-x-2">
+                  <Checkbox
+                    id={level.value}
+                    checked={selectedLevels.includes(level.value)}
+                    onCheckedChange={() => handleLevelToggle(level.value)}
+                  />
+                  <label
+                    htmlFor={level.value}
+                    className="text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70 cursor-pointer"
+                  >
+                    {level.label}
+                  </label>
+                </div>
+              ))}
+            </div>
+          </PopoverContent>
+        </Popover>
+        <Button
+          variant="outline"
+          size="sm"
+          className="ml-4 flex items-center gap-1"
+          onClick={() => router.push(`/home/monitoring?botId=${botId}`)}
+        >
+          <ExternalLink className="h-4 w-4" />
+          <span className="text-sm">{t('bots.viewDetailedLogs')}</span>
+        </Button>
+      </div>
 
-      {/* Log cards */}
-      {filteredLogs.length === 0 ? (
-        <div className="flex-1 flex items-center justify-center py-12">
-          <p className="text-sm text-muted-foreground">{t('bots.noLogs')}</p>
-        </div>
-      ) : (
-        <div className="flex flex-col gap-2">
-          {filteredLogs.map((botLog) => (
-            <BotLogCard
-              botLog={botLog}
-              key={botLog.seq_id}
-              defaultExpanded={autoExpandImages && botLog.images.length > 0}
-            />
-          ))}
-        </div>
-      )}
+      {filteredLogs.map((botLog) => {
+        return <BotLogCard botLog={botLog} key={botLog.seq_id} />;
+      })}
     </div>
   );
 }

web/src/app/home/bots/components/bot-log/view/botLog.module.css

@@ -0,0 +1,142 @@
+.botLogListContainer {
+  width: 100%;
+  max-width: 100%;
+  min-height: 10rem;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: flex-start;
+  overflow-y: auto;
+  overflow-x: hidden;
+  box-sizing: border-box;
+}
+
+.botLogCardContainer {
+  width: 100%;
+  max-width: 100%;
+  background-color: #fff;
+  border-radius: 8px;
+  border: 1px solid #e2e8f0;
+  padding: 1rem;
+  margin-bottom: 0.75rem;
+  transition: all 0.2s ease;
+  overflow: hidden;
+  box-sizing: border-box;
+}
+
+.botLogCardContainer:hover {
+  border-color: #cbd5e1;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.05);
+}
+
+:global(.dark) .botLogCardContainer {
+  background-color: #1f1f22;
+  border: 1px solid #2a2a2e;
+}
+
+:global(.dark) .botLogCardContainer:hover {
+  border-color: #3a3a3e;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
+}
+
+.listHeader {
+  width: 100%;
+  height: 2.5rem;
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  margin-bottom: 0.5rem;
+}
+
+.tag {
+  display: inline-flex;
+  flex-direction: row;
+  align-items: center;
+  justify-content: center;
+  gap: 0.25rem;
+  height: auto;
+  padding: 0.25rem 0.5rem;
+  border-radius: 4px;
+  background-color: #dbeafe;
+  color: #1e40af;
+  font-size: 0.75rem;
+  font-weight: 500;
+  max-width: 16rem;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  text-transform: uppercase;
+  letter-spacing: 0.025em;
+}
+
+:global(.dark) .tag {
+  background-color: #1e3a8a;
+  color: #93c5fd;
+}
+
+.chatTag {
+  color: #4b5563;
+  background-color: #f3f4f6;
+  text-transform: none;
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.chatTag:hover {
+  background-color: #e5e7eb;
+}
+
+:global(.dark) .chatTag {
+  color: #9ca3af;
+  background-color: #374151;
+}
+
+:global(.dark) .chatTag:hover {
+  background-color: #4b5563;
+}
+
+.chatId {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-family: 'SF Mono', Monaco, 'Cascadia Code', 'Roboto Mono', Consolas,
+    'Courier New', monospace;
+  font-size: 0.7rem;
+}
+
+.cardTitleContainer {
+  width: 100%;
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  justify-content: space-between;
+  margin-bottom: 0.5rem;
+}
+
+.cardText {
+  color: #1e293b;
+  font-size: 0.875rem;
+  line-height: 1.7;
+  white-space: pre-wrap;
+  word-wrap: break-word;
+  word-break: break-all;
+  overflow-wrap: anywhere;
+  hyphens: auto;
+  max-width: 100%;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
+    'Ubuntu', 'Cantarell', sans-serif;
+}
+
+:global(.dark) .cardText {
+  color: #e2e8f0;
+}
+
+.timestamp {
+  color: #64748b;
+  font-size: 0.75rem;
+  white-space: nowrap;
+}
+
+:global(.dark) .timestamp {
+  color: #64748b;
+}

web/src/app/home/bots/components/bot-session/BotSessionMonitor.tsx

@@ -1,18 +1,11 @@
 'use client';
 
-import React, {
-  useState,
-  useEffect,
-  useRef,
-  useCallback,
-  forwardRef,
-  useImperativeHandle,
-} from 'react';
+import React, { useState, useEffect, useRef, useCallback } from 'react';
 import { useTranslation } from 'react-i18next';
 import { httpClient } from '@/app/infra/http/HttpClient';
 import { ScrollArea } from '@/components/ui/scroll-area';
+import { Button } from '@/components/ui/button';
 import { cn } from '@/lib/utils';
-import { Copy, Check } from 'lucide-react';
 import {
   MessageChainComponent,
   Plain,
@@ -34,7 +27,6 @@ interface SessionInfo {
   is_active: boolean;
   platform?: string | null;
   user_id?: string | null;
-  user_name?: string | null;
 }
 
 interface SessionMessage {
@@ -55,18 +47,11 @@ interface SessionMessage {
   role?: string | null;
 }
 
-export interface BotSessionMonitorHandle {
-  refreshSessions: () => Promise<void>;
-}
-
 interface BotSessionMonitorProps {
   botId: string;
 }
 
-const BotSessionMonitor = forwardRef<
-  BotSessionMonitorHandle,
-  BotSessionMonitorProps
->(function BotSessionMonitor({ botId }, ref) {
+export default function BotSessionMonitor({ botId }: BotSessionMonitorProps) {
   const { t } = useTranslation();
   const [sessions, setSessions] = useState<SessionInfo[]>([]);
   const [selectedSessionId, setSelectedSessionId] = useState<string | null>(
@@ -75,29 +60,8 @@ const BotSessionMonitor = forwardRef<
   const [messages, setMessages] = useState<SessionMessage[]>([]);
   const [loadingSessions, setLoadingSessions] = useState(false);
   const [loadingMessages, setLoadingMessages] = useState(false);
-  const [copiedUserId, setCopiedUserId] = useState(false);
   const messagesContainerRef = useRef<HTMLDivElement>(null);
 
-  const parseSessionType = (sessionId: string): string | null => {
-    const idx = sessionId.indexOf('_');
-    if (idx === -1) return null;
-    const type = sessionId.slice(0, idx);
-    if (type === 'person' || type === 'group') return type;
-    return null;
-  };
-
-  const abbreviateId = (id: string): string => {
-    if (id.length <= 10) return id;
-    return `${id.slice(0, 4)}..${id.slice(-4)}`;
-  };
-
-  const copyUserId = (userId: string) => {
-    navigator.clipboard.writeText(userId).then(() => {
-      setCopiedUserId(true);
-      setTimeout(() => setCopiedUserId(false), 2000);
-    });
-  };
-
   const loadSessions = useCallback(async () => {
     setLoadingSessions(true);
     try {
@@ -110,14 +74,6 @@ const BotSessionMonitor = forwardRef<
     }
   }, [botId]);
 
-  useImperativeHandle(
-    ref,
-    () => ({
-      refreshSessions: loadSessions,
-    }),
-    [loadSessions],
-  );
-
   const loadMessages = useCallback(async (sessionId: string) => {
     setLoadingMessages(true);
     try {
@@ -256,7 +212,7 @@ const BotSessionMonitor = forwardRef<
         return (
           <div
             key={index}
-            className="mb-2 pl-2.5 border-l-2 border-muted-foreground/50 opacity-80"
+            className="mb-2 pl-2.5 border-l-2 border-gray-300 dark:border-gray-600 opacity-80"
           >
             <div className="text-sm">
               {quote.origin?.map((comp, idx) =>
@@ -299,17 +255,9 @@ const BotSessionMonitor = forwardRef<
     );
   };
 
-  // Backend timestamps may lack timezone indicator; treat as UTC
-  const parseTimestamp = (timestamp: string): Date => {
-    if (!timestamp) return new Date(0);
-    const hasTimezone =
-      timestamp.endsWith('Z') || /[+-]\d{2}:?\d{2}$/.test(timestamp);
-    return new Date(hasTimezone ? timestamp : timestamp + 'Z');
-  };
-
   const formatTime = (timestamp: string): string => {
     if (!timestamp) return '';
-    const date = parseTimestamp(timestamp);
+    const date = new Date(timestamp);
     const hours = date.getHours().toString().padStart(2, '0');
     const minutes = date.getMinutes().toString().padStart(2, '0');
     return `${hours}:${minutes}`;
@@ -317,7 +265,7 @@ const BotSessionMonitor = forwardRef<
 
   const formatRelativeTime = (timestamp: string): string => {
     if (!timestamp) return '';
-    const date = parseTimestamp(timestamp);
+    const date = new Date(timestamp);
     const now = new Date();
     const diffMs = now.getTime() - date.getTime();
     const diffMins = Math.floor(diffMs / 60000);
@@ -335,9 +283,36 @@ const BotSessionMonitor = forwardRef<
   );
 
   return (
-    <div className="flex flex-col md:flex-row h-full min-h-0 rounded-lg border overflow-hidden">
+    <div className="flex h-full min-h-0">
       {/* Left Panel: Session List */}
-      <div className="max-h-48 md:max-h-none md:w-60 flex-shrink-0 border-b md:border-b-0 md:border-r flex flex-col min-h-0">
+      <div className="w-64 flex-shrink-0 border-r flex flex-col min-h-0">
+        {/* Refresh Button */}
+        <div className="px-2 py-2 border-b shrink-0">
+          <Button
+            variant="ghost"
+            className="w-full h-9 text-sm text-muted-foreground"
+            onClick={loadSessions}
+            disabled={loadingSessions}
+          >
+            <svg
+              xmlns="http://www.w3.org/2000/svg"
+              viewBox="0 0 24 24"
+              fill="none"
+              stroke="currentColor"
+              strokeWidth={2}
+              strokeLinecap="round"
+              strokeLinejoin="round"
+              className={cn(
+                'w-3.5 h-3.5 mr-1.5',
+                loadingSessions && 'animate-spin',
+              )}
+            >
+              <path d="M21.5 2v6h-6M2.5 22v-6h6M2 11.5a10 10 0 0 1 18.8-4.3M22 12.5a10 10 0 0 1-18.8 4.2" />
+            </svg>
+            {t('bots.sessionMonitor.refresh')}
+          </Button>
+        </div>
+
         {/* Session List */}
         <ScrollArea className="flex-1 min-h-0">
           {loadingSessions && sessions.length === 0 ? (
@@ -349,51 +324,38 @@ const BotSessionMonitor = forwardRef<
               {t('bots.sessionMonitor.noSessions')}
             </div>
           ) : (
-            <div className="p-1.5">
+            <div className="p-1">
               {sessions.map((session) => {
                 const isSelected = selectedSessionId === session.session_id;
                 return (
                   <button
                     key={session.session_id}
-                    type="button"
                     className={cn(
-                      'w-full text-left px-2.5 py-2 rounded-md transition-colors',
+                      'w-full text-left px-3 py-2.5 rounded-md transition-colors',
                       isSelected ? 'bg-accent' : 'hover:bg-accent/50',
                     )}
                     onClick={() => setSelectedSessionId(session.session_id)}
                   >
                     <div className="flex items-center justify-between mb-0.5">
                       <span className="text-sm font-medium truncate mr-2">
-                        {session.user_name ||
-                          session.user_id ||
-                          session.session_id.slice(0, 12)}
+                        {session.user_id || session.session_id.slice(0, 12)}
                       </span>
                       <span className="text-[11px] text-muted-foreground tabular-nums flex-shrink-0">
                         {formatRelativeTime(session.last_activity)}
                       </span>
                     </div>
                     <div className="flex items-center gap-1.5 text-xs text-muted-foreground">
-                      {parseSessionType(session.session_id) && (
-                        <span className="px-1 py-0.5 rounded bg-muted text-[10px]">
-                          {parseSessionType(session.session_id)}
-                        </span>
-                      )}
                       {session.platform && (
                         <span className="px-1 py-0.5 rounded bg-muted text-[10px]">
                           {session.platform}
                         </span>
                       )}
-                      {session.user_id && (
-                        <span className="truncate text-[10px]">
-                          {abbreviateId(session.user_id)}
-                        </span>
-                      )}
                       {session.is_active && (
                         <span className="flex items-center gap-0.5 text-green-600 dark:text-green-400">
                           <span className="w-1.5 h-1.5 rounded-full bg-green-500 inline-block" />
                         </span>
                       )}
-                      <span className="truncate">{session.pipeline_name}</span>
+                      <span>{session.pipeline_name}</span>
                     </div>
                   </button>
                 );
@@ -406,52 +368,24 @@ const BotSessionMonitor = forwardRef<
       {/* Right Panel: Messages */}
       <div className="flex-1 flex flex-col min-h-0 min-w-0">
         {!selectedSessionId ? (
-          <div className="text-center text-muted-foreground text-sm flex-1 flex items-center justify-center">
+          <div className="text-center text-muted-foreground py-12 text-lg flex-1 flex items-center justify-center">
             {t('bots.sessionMonitor.selectSession')}
           </div>
         ) : (
           <>
             {/* Chat Header */}
-            <div className="px-4 py-2.5 border-b shrink-0">
+            <div className="px-6 py-3 border-b shrink-0 flex items-center justify-between">
               <div className="min-w-0">
                 <div className="text-sm font-medium truncate">
-                  {selectedSession?.user_name ||
-                    selectedSession?.user_id ||
-                    selectedSessionId.slice(0, 20)}
+                  {selectedSession?.user_id || selectedSessionId.slice(0, 20)}
                 </div>
-                <div className="flex items-center gap-1.5 text-xs text-muted-foreground mt-0.5">
-                  {parseSessionType(selectedSessionId) && (
-                    <span>{parseSessionType(selectedSessionId)}</span>
-                  )}
+                <div className="flex items-center gap-2 text-xs text-muted-foreground">
                   {selectedSession?.platform && (
-                    <>
-                      {parseSessionType(selectedSessionId) && <span>·</span>}
-                      <span>{selectedSession.platform}</span>
-                    </>
-                  )}
-                  {selectedSession?.user_id && (
-                    <>
-                      <span>·</span>
-                      <span className="font-mono">
-                        {selectedSession.user_id}
-                      </span>
-                      <button
-                        type="button"
-                        onClick={() => copyUserId(selectedSession.user_id!)}
-                        className="inline-flex items-center text-muted-foreground hover:text-foreground transition-colors"
-                        title={t('common.copy')}
-                      >
-                        {copiedUserId ? (
-                          <Check className="w-3 h-3 text-green-600" />
-                        ) : (
-                          <Copy className="w-3 h-3" />
-                        )}
-                      </button>
-                    </>
+                    <span>{selectedSession.platform}</span>
                   )}
                   {selectedSession?.pipeline_name && (
                     <>
-                      <span>·</span>
+                      {selectedSession?.platform && <span>·</span>}
                       <span>{selectedSession.pipeline_name}</span>
                     </>
                   )}
@@ -466,20 +400,40 @@ const BotSessionMonitor = forwardRef<
                   )}
                 </div>
               </div>
+              <Button
+                variant="ghost"
+                size="icon"
+                className="w-8 h-8"
+                onClick={() => loadMessages(selectedSessionId)}
+                disabled={loadingMessages}
+              >
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  viewBox="0 0 24 24"
+                  fill="none"
+                  stroke="currentColor"
+                  strokeWidth={2}
+                  strokeLinecap="round"
+                  strokeLinejoin="round"
+                  className={cn('w-4 h-4', loadingMessages && 'animate-spin')}
+                >
+                  <path d="M21.5 2v6h-6M2.5 22v-6h6M2 11.5a10 10 0 0 1 18.8-4.3M22 12.5a10 10 0 0 1-18.8 4.2" />
+                </svg>
+              </Button>
             </div>
 
-            {/* Messages Area */}
+            {/* Messages Area — matches DebugDialog style */}
             <ScrollArea
               ref={messagesContainerRef}
-              className="flex-1 px-4 py-4 overflow-y-auto min-h-0"
+              className="flex-1 p-6 overflow-y-auto min-h-0 bg-white dark:bg-black"
             >
-              <div className="space-y-4">
+              <div className="space-y-6">
                 {loadingMessages ? (
-                  <div className="text-center text-muted-foreground py-12 text-sm">
+                  <div className="text-center text-muted-foreground py-12 text-lg">
                     {t('bots.sessionMonitor.loading')}
                   </div>
                 ) : messages.length === 0 ? (
-                  <div className="text-center text-muted-foreground py-12 text-sm">
+                  <div className="text-center text-muted-foreground py-12 text-lg">
                     {t('bots.sessionMonitor.noMessages')}
                   </div>
                 ) : (
@@ -495,18 +449,21 @@ const BotSessionMonitor = forwardRef<
                       >
                         <div
                           className={cn(
-                            'max-w-3xl px-4 py-2.5 rounded-2xl text-sm',
+                            'max-w-3xl px-5 py-3 rounded-2xl',
                             isUser
-                              ? 'bg-primary/10 rounded-br-sm'
-                              : 'bg-muted rounded-bl-sm',
+                              ? 'bg-blue-100 dark:bg-blue-900 text-gray-900 dark:text-gray-100 rounded-br-none'
+                              : 'bg-gray-100 dark:bg-gray-800 text-gray-900 dark:text-gray-100 rounded-bl-none',
                             msg.status === 'error' && 'ring-1 ring-red-400/50',
                           )}
                         >
                           {renderMessageContent(msg)}
-                          {/* Role label + timestamp */}
+                          {/* Role label + timestamp inside bubble, matching DebugDialog */}
                           <div
                             className={cn(
-                              'text-[11px] mt-1.5 flex items-center gap-1.5 text-muted-foreground',
+                              'text-xs mt-2 flex items-center gap-2',
+                              isUser
+                                ? 'text-gray-600 dark:text-gray-300'
+                                : 'text-gray-500 dark:text-gray-400',
                             )}
                           >
                             <span>
@@ -542,6 +499,4 @@ const BotSessionMonitor = forwardRef<
       </div>
     </div>
   );
-});
-
-export default BotSessionMonitor;
+}

web/src/app/home/bots/page.tsx

@@ -1,21 +1,144 @@
 'use client';
 
-import { useSearchParams } from 'next/navigation';
+import { useEffect, useState } from 'react';
+import styles from './botConfig.module.css';
+import { BotCardVO } from '@/app/home/bots/components/bot-card/BotCardVO';
+import BotCard from '@/app/home/bots/components/bot-card/BotCard';
+import CreateCardComponent from '@/app/infra/basic-component/create-card-component/CreateCardComponent';
+import { httpClient } from '@/app/infra/http/HttpClient';
+import { Bot, Adapter } from '@/app/infra/entities/api';
+import { toast } from 'sonner';
 import { useTranslation } from 'react-i18next';
-import BotDetailContent from './BotDetailContent';
+import { extractI18nObject } from '@/i18n/I18nProvider';
+import BotDetailDialog from '@/app/home/bots/BotDetailDialog';
+import { CustomApiError } from '@/app/infra/entities/common';
+import { systemInfo } from '@/app/infra/http';
 
 export default function BotConfigPage() {
   const { t } = useTranslation();
-  const searchParams = useSearchParams();
-  const detailId = searchParams.get('id');
+  // 机器人详情dialog
+  const [detailDialogOpen, setDetailDialogOpen] = useState<boolean>(false);
+  const [botList, setBotList] = useState<BotCardVO[]>([]);
+  const [selectedBotId, setSelectedBotId] = useState<string>('');
 
-  if (detailId) {
-    return <BotDetailContent id={detailId} />;
+  useEffect(() => {
+    getBotList();
+  }, []);
+
+  async function getBotList() {
+    const adapterListResp = await httpClient.getAdapters();
+    const adapterList = adapterListResp.adapters.map((adapter: Adapter) => {
+      return {
+        label: extractI18nObject(adapter.label),
+        value: adapter.name,
+      };
+    });
+
+    httpClient
+      .getBots()
+      .then((resp) => {
+        const botList: BotCardVO[] = resp.bots.map((bot: Bot) => {
+          return new BotCardVO({
+            id: bot.uuid || '',
+            iconURL: httpClient.getAdapterIconURL(bot.adapter),
+            name: bot.name,
+            description: bot.description,
+            adapter: bot.adapter,
+            adapterConfig: bot.adapter_config,
+            adapterLabel:
+              adapterList.find((item) => item.value === bot.adapter)?.label ||
+              bot.adapter.substring(0, 10),
+            usePipelineName: bot.use_pipeline_name || '',
+            enable: bot.enable || false,
+          });
+        });
+        setBotList(botList);
+      })
+      .catch((err) => {
+        console.error('get bot list error', err);
+        toast.error(t('bots.getBotListError') + (err as CustomApiError).msg);
+      });
+  }
+
+  function handleCreateBotClick() {
+    const maxBots = systemInfo.limitation?.max_bots ?? -1;
+    if (maxBots >= 0 && botList.length >= maxBots) {
+      toast.error(t('limitation.maxBotsReached', { max: maxBots }));
+      return;
+    }
+    setSelectedBotId('');
+    setDetailDialogOpen(true);
+  }
+
+  function selectBot(botUUID: string) {
+    setSelectedBotId(botUUID);
+    setDetailDialogOpen(true);
+  }
+
+  function handleFormSubmit() {
+    getBotList();
+    // setDetailDialogOpen(false);
+  }
+
+  function handleFormCancel() {
+    setDetailDialogOpen(false);
+  }
+
+  function handleBotDeleted() {
+    getBotList();
+    setDetailDialogOpen(false);
+  }
+
+  function handleNewBotCreated(botId: string) {
+    getBotList();
+    setSelectedBotId(botId);
   }
 
   return (
-    <div className="flex h-full items-center justify-center text-muted-foreground">
-      <p>{t('bots.selectFromSidebar')}</p>
+    <div>
+      <BotDetailDialog
+        open={detailDialogOpen}
+        onOpenChange={setDetailDialogOpen}
+        botId={selectedBotId || undefined}
+        onFormSubmit={handleFormSubmit}
+        onFormCancel={handleFormCancel}
+        onBotDeleted={handleBotDeleted}
+        onNewBotCreated={handleNewBotCreated}
+      />
+
+      {/* 注意：其余的返回内容需要保持在Spin组件外部 */}
+      <div className={`${styles.botListContainer}`}>
+        <CreateCardComponent
+          width={'100%'}
+          height={'10rem'}
+          plusSize={'90px'}
+          onClick={handleCreateBotClick}
+        />
+        {botList.map((cardVO) => {
+          return (
+            <div
+              key={cardVO.id}
+              onClick={() => {
+                selectBot(cardVO.id);
+              }}
+            >
+              <BotCard
+                botCardVO={cardVO}
+                setBotEnableCallback={(id, enable) => {
+                  setBotList(
+                    botList.map((bot) => {
+                      if (bot.id === id) {
+                        return { ...bot, enable: enable };
+                      }
+                      return bot;
+                    }),
+                  );
+                }}
+              />
+            </div>
+          );
+        })}
+      </div>
     </div>
   );
 }

web/src/app/home/components/dynamic-form/DynamicFormComponent.tsx

@@ -11,34 +11,9 @@ import {
   FormMessage,
 } from '@/components/ui/form';
 import DynamicFormItemComponent from '@/app/home/components/dynamic-form/DynamicFormItemComponent';
-import { useEffect, useRef } from 'react';
+import { useCallback, useEffect, useRef } from 'react';
 import { extractI18nObject } from '@/i18n/I18nProvider';
 import { useTranslation } from 'react-i18next';
-import { cn } from '@/lib/utils';
-
-/**
- * Resolve the value referenced by a `show_if.field` string.
- *
- * Fields prefixed with `__system.` are looked up in the caller-supplied
- * `systemContext` dictionary (e.g. `__system.is_wizard` → `systemContext.is_wizard`).
- * All other field names are resolved from the live form values first, then
- * fall back to `externalDependentValues`.
- */
-function resolveShowIfValue(
-  field: string,
-  watchedValues: Record<string, unknown>,
-  externalDependentValues?: Record<string, unknown>,
-  systemContext?: Record<string, unknown>,
-): unknown {
-  if (field.startsWith('__system.')) {
-    const key = field.slice('__system.'.length);
-    return systemContext?.[key];
-  }
-  if (watchedValues[field] !== undefined) {
-    return watchedValues[field];
-  }
-  return externalDependentValues?.[field];
-}
 
 export default function DynamicFormComponent({
   itemConfigList,
@@ -47,7 +22,6 @@ export default function DynamicFormComponent({
   onFileUploaded,
   isEditing,
   externalDependentValues,
-  systemContext,
 }: {
   itemConfigList: IDynamicFormItemSchema[];
   onSubmit?: (val: object) => unknown;
@@ -55,50 +29,11 @@ export default function DynamicFormComponent({
   onFileUploaded?: (fileKey: string) => void;
   isEditing?: boolean;
   externalDependentValues?: Record<string, unknown>;
-  /** Extra variables accessible via the `__system.*` namespace in show_if conditions.
-   *  e.g. `{ is_wizard: true }` makes `show_if: { field: "__system.is_wizard", ... }` work. */
-  systemContext?: Record<string, unknown>;
 }) {
   const isInitialMount = useRef(true);
   const previousInitialValues = useRef(initialValues);
   const { t } = useTranslation();
 
-  // Normalize a form value according to its field type.
-  // This ensures legacy/malformed data (e.g. a plain string for
-  // model-fallback-selector) is coerced to the expected shape
-  // so that downstream components never crash.
-  const normalizeFieldValue = (
-    item: IDynamicFormItemSchema,
-    value: unknown,
-  ): unknown => {
-    if (item.type === 'model-fallback-selector') {
-      if (value != null && typeof value === 'object' && !Array.isArray(value)) {
-        const obj = value as Record<string, unknown>;
-        return {
-          primary: typeof obj.primary === 'string' ? obj.primary : '',
-          fallbacks: Array.isArray(obj.fallbacks)
-            ? (obj.fallbacks as unknown[]).filter(
-                (v): v is string => typeof v === 'string',
-              )
-            : [],
-        };
-      }
-      // Legacy string format or any other unexpected type
-      return {
-        primary: typeof value === 'string' ? value : '',
-        fallbacks: [],
-      };
-    }
-    if (item.type === 'prompt-editor') {
-      if (Array.isArray(value)) {
-        return value;
-      }
-      // Default to a single empty system prompt entry
-      return [{ role: 'system', content: '' }];
-    }
-    return value;
-  };
-
   // 根据 itemConfigList 动态生成 zod schema
   const formSchema = z.object(
     itemConfigList.reduce(
@@ -138,12 +73,6 @@ export default function DynamicFormComponent({
           case 'bot-selector':
             fieldSchema = z.string();
             break;
-          case 'model-fallback-selector':
-            fieldSchema = z.object({
-              primary: z.string(),
-              fallbacks: z.array(z.string()),
-            });
-            break;
           case 'prompt-editor':
             fieldSchema = z.array(
               z.object({
@@ -181,10 +110,10 @@ export default function DynamicFormComponent({
     resolver: zodResolver(formSchema),
     defaultValues: itemConfigList.reduce((acc, item) => {
       // 优先使用 initialValues，如果没有则使用默认值
-      const rawValue = initialValues?.[item.name] ?? item.default;
+      const value = initialValues?.[item.name] ?? item.default;
       return {
         ...acc,
-        [item.name]: normalizeFieldValue(item, rawValue),
+        [item.name]: value,
       };
     }, {} as FormValues),
   });
@@ -209,8 +138,7 @@ export default function DynamicFormComponent({
       // 合并默认值和初始值
       const mergedValues = itemConfigList.reduce(
         (acc, item) => {
-          const rawValue = initialValues[item.name] ?? item.default;
-          acc[item.name] = normalizeFieldValue(item, rawValue) as object;
+          acc[item.name] = initialValues[item.name] ?? item.default;
           return acc;
         },
         {} as Record<string, object>,
@@ -232,56 +160,53 @@ export default function DynamicFormComponent({
   const onSubmitRef = useRef(onSubmit);
   onSubmitRef.current = onSubmit;
 
-  // 监听表单值变化
-  useEffect(() => {
-    // Emit initial form values immediately so the parent always has a valid snapshot,
-    // even if the user saves without modifying any field.
-    // form.watch(callback) only fires on subsequent changes, not on mount.
+  // Track the last emitted values to avoid emitting identical snapshots,
+  // which would cause the parent to call setValue with an equivalent object,
+  // triggering a re-render loop.
+  const lastEmittedRef = useRef<string>('');
+
+  const emitValues = useCallback(() => {
     const formValues = form.getValues();
-    const initialFinalValues = itemConfigList.reduce(
+    const finalValues = itemConfigList.reduce(
       (acc, item) => {
         acc[item.name] = formValues[item.name] ?? item.default;
         return acc;
       },
       {} as Record<string, object>,
     );
-    onSubmitRef.current?.(initialFinalValues);
+    const serialized = JSON.stringify(finalValues);
+    if (serialized !== lastEmittedRef.current) {
+      lastEmittedRef.current = serialized;
+      onSubmitRef.current?.(finalValues);
+    }
+  }, [form, itemConfigList]);
 
-    // Update previousInitialValues to the emitted snapshot so that if the
-    // parent writes these values back as new initialValues, the deep
-    // comparison in the initialValues-sync useEffect won't detect a change
-    // and won't trigger an infinite update loop.
-    previousInitialValues.current = initialFinalValues as Record<
-      string,
-      object
-    >;
+  // 监听表单值变化
+  useEffect(() => {
+    // Emit initial form values immediately so the parent always has a valid snapshot,
+    // even if the user saves without modifying any field.
+    // form.watch(callback) only fires on subsequent changes, not on mount.
+    emitValues();
 
     const subscription = form.watch(() => {
-      const formValues = form.getValues();
-      const finalValues = itemConfigList.reduce(
-        (acc, item) => {
-          acc[item.name] = formValues[item.name] ?? item.default;
-          return acc;
-        },
-        {} as Record<string, object>,
-      );
-      onSubmitRef.current?.(finalValues);
-      previousInitialValues.current = finalValues as Record<string, object>;
+      emitValues();
     });
     return () => subscription.unsubscribe();
-  }, [form, itemConfigList]);
+  }, [form, itemConfigList, emitValues]);
 
   return (
     <Form {...form}>
       <div className="space-y-4">
         {itemConfigList.map((config) => {
           if (config.show_if) {
-            const dependValue = resolveShowIfValue(
-              config.show_if.field,
-              watchedValues as Record<string, unknown>,
-              externalDependentValues,
-              systemContext,
-            );
+            const dependValue =
+              watchedValues[
+                config.show_if.field as keyof typeof watchedValues
+              ] !== undefined
+                ? watchedValues[
+                    config.show_if.field as keyof typeof watchedValues
+                  ]
+                : externalDependentValues?.[config.show_if.field];
 
             if (
               config.show_if.operator === 'eq' &&
@@ -306,47 +231,6 @@ export default function DynamicFormComponent({
 
           // All fields are disabled when editing (creation_settings are immutable)
           const isFieldDisabled = !!isEditing;
-
-          // Boolean fields use a special inline layout
-          if (config.type === 'boolean') {
-            return (
-              <FormField
-                key={config.id}
-                control={form.control}
-                name={config.name as keyof FormValues}
-                render={({ field }) => (
-                  <FormItem>
-                    <div
-                      className={cn(
-                        'flex flex-row items-center justify-between rounded-lg border p-4 max-w-2xl',
-                        isFieldDisabled && 'pointer-events-none opacity-60',
-                      )}
-                    >
-                      <div className="space-y-0.5">
-                        <FormLabel className="text-base">
-                          {extractI18nObject(config.label)}
-                        </FormLabel>
-                        {config.description && (
-                          <p className="text-sm text-muted-foreground">
-                            {extractI18nObject(config.description)}
-                          </p>
-                        )}
-                      </div>
-                      <FormControl>
-                        <DynamicFormItemComponent
-                          config={config}
-                          field={field}
-                          onFileUploaded={onFileUploaded}
-                        />
-                      </FormControl>
-                    </div>
-                    <FormMessage />
-                  </FormItem>
-                )}
-              />
-            );
-          }
-
           return (
             <FormField
               key={config.id}

web/src/app/home/components/dynamic-form/DynamicFormItemComponent.tsx

@@ -37,7 +37,7 @@ import {
   DialogFooter,
 } from '@/components/ui/dialog';
 import { Checkbox } from '@/components/ui/checkbox';
-import { Plus, X, Eye, Wrench, Trash2 } from 'lucide-react';
+import { Plus, X, Eye, Wrench } from 'lucide-react';
 
 export default function DynamicFormItemComponent({
   config,
@@ -124,28 +124,6 @@ export default function DynamicFormItemComponent({
     }
   }, [config.type]);
 
-  useEffect(() => {
-    if (config.type === DynamicFormItemType.MODEL_FALLBACK_SELECTOR) {
-      httpClient
-        .getProviderLLMModels()
-        .then((resp) => {
-          let models = resp.models;
-          if (
-            systemInfo.disable_models_service ||
-            userInfo?.account_type !== 'space'
-          ) {
-            models = models.filter(
-              (m) => m.provider?.requester !== 'space-chat-completions',
-            );
-          }
-          setLlmModels(models);
-        })
-        .catch((err) => {
-          toast.error('Failed to get LLM model list: ' + err.msg);
-        });
-    }
-  }, [config.type]);
-
   useEffect(() => {
     if (
       config.type === DynamicFormItemType.KNOWLEDGE_BASE_SELECTOR ||
@@ -181,28 +159,32 @@ export default function DynamicFormItemComponent({
       return (
         <Input
           type="number"
-          className="max-w-xs"
           {...field}
           onChange={(e) => field.onChange(Number(e.target.value))}
         />
       );
 
     case DynamicFormItemType.STRING:
-      return <Input className="max-w-md" {...field} />;
+      return <Input {...field} />;
 
     case DynamicFormItemType.TEXT:
-      return <Textarea {...field} className="min-h-[120px] max-w-2xl" />;
+      return <Textarea {...field} className="min-h-[120px]" />;
 
     case DynamicFormItemType.BOOLEAN:
-      return <Switch checked={field.value} onCheckedChange={field.onChange} />;
+      return (
+        <Switch
+          checked={field.value ?? false}
+          onCheckedChange={field.onChange}
+        />
+      );
 
     case DynamicFormItemType.STRING_ARRAY:
       return (
-        <div className="space-y-2 max-w-md">
+        <div className="space-y-2">
           {field.value.map((item: string, index: number) => (
-            <div key={index} className="flex gap-1.5 items-center">
+            <div key={index} className="flex gap-2 items-center">
               <Input
-                className="flex-1"
+                className="w-[200px]"
                 value={item}
                 onChange={(e) => {
                   const newValue = [...field.value];
@@ -210,11 +192,9 @@ export default function DynamicFormItemComponent({
                   field.onChange(newValue);
                 }}
               />
-              <Button
+              <button
                 type="button"
-                variant="ghost"
-                size="icon"
-                className="shrink-0 text-muted-foreground hover:text-destructive"
+                className="p-2 hover:bg-gray-100 rounded"
                 onClick={() => {
                   const newValue = field.value.filter(
                     (_: string, i: number) => i !== index,
@@ -222,19 +202,24 @@ export default function DynamicFormItemComponent({
                   field.onChange(newValue);
                 }}
               >
-                <Trash2 className="size-4" />
-              </Button>
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  viewBox="0 0 24 24"
+                  fill="currentColor"
+                  className="w-5 h-5 text-red-500"
+                >
+                  <path d="M7 4V2H17V4H22V6H20V21C20 21.5523 19.5523 22 19 22H5C4.44772 22 4 21.5523 4 21V6H2V4H7ZM6 6V20H18V6H6ZM9 9H11V17H9V9ZM13 9H15V17H13V9Z"></path>
+                </svg>
+              </button>
             </div>
           ))}
           <Button
             type="button"
             variant="outline"
-            className="w-full border-dashed text-muted-foreground hover:text-foreground"
             onClick={() => {
               field.onChange([...field.value, '']);
             }}
           >
-            <Plus className="size-4 mr-1.5" />
             {t('common.add')}
           </Button>
         </div>
@@ -242,8 +227,8 @@ export default function DynamicFormItemComponent({
 
     case DynamicFormItemType.SELECT:
       return (
-        <Select value={field.value} onValueChange={field.onChange}>
-          <SelectTrigger className="max-w-md bg-[#ffffff] dark:bg-[#2a2a2e]">
+        <Select value={field.value ?? ''} onValueChange={field.onChange}>
+          <SelectTrigger className="bg-[#ffffff] dark:bg-[#2a2a2e]">
             <SelectValue placeholder={t('common.select')} />
           </SelectTrigger>
           <SelectContent>
@@ -272,33 +257,31 @@ export default function DynamicFormItemComponent({
       );
 
       return (
-        <div className="max-w-md">
-          <Select value={field.value} onValueChange={field.onChange}>
-            <SelectTrigger className="bg-[#ffffff] dark:bg-[#2a2a2e]">
-              <SelectValue placeholder={t('models.selectModel')} />
-            </SelectTrigger>
-            <SelectContent>
-              {Object.entries(groupedModels).map(([providerName, models]) => (
-                <SelectGroup key={providerName}>
-                  <SelectLabel>{providerName}</SelectLabel>
-                  {models.map((model) => (
-                    <SelectItem key={model.uuid} value={model.uuid}>
-                      <span className="inline-flex items-center gap-1">
-                        {model.name}
-                        {model.abilities?.includes('vision') && (
-                          <Eye className="h-3 w-3 text-muted-foreground" />
-                        )}
-                        {model.abilities?.includes('func_call') && (
-                          <Wrench className="h-3 w-3 text-muted-foreground" />
-                        )}
-                      </span>
-                    </SelectItem>
-                  ))}
-                </SelectGroup>
-              ))}
-            </SelectContent>
-          </Select>
-        </div>
+        <Select value={field.value} onValueChange={field.onChange}>
+          <SelectTrigger className="bg-[#ffffff] dark:bg-[#2a2a2e]">
+            <SelectValue placeholder={t('models.selectModel')} />
+          </SelectTrigger>
+          <SelectContent>
+            {Object.entries(groupedModels).map(([providerName, models]) => (
+              <SelectGroup key={providerName}>
+                <SelectLabel>{providerName}</SelectLabel>
+                {models.map((model) => (
+                  <SelectItem key={model.uuid} value={model.uuid}>
+                    <span className="inline-flex items-center gap-1">
+                      {model.name}
+                      {model.abilities?.includes('vision') && (
+                        <Eye className="h-3 w-3 text-muted-foreground" />
+                      )}
+                      {model.abilities?.includes('func_call') && (
+                        <Wrench className="h-3 w-3 text-muted-foreground" />
+                      )}
+                    </span>
+                  </SelectItem>
+                ))}
+              </SelectGroup>
+            ))}
+          </SelectContent>
+        </Select>
       );
 
     case DynamicFormItemType.EMBEDDING_MODEL_SELECTOR:
@@ -314,93 +297,18 @@ export default function DynamicFormItemComponent({
       );
 
       return (
-        <div className="max-w-md">
-          <Select value={field.value} onValueChange={field.onChange}>
-            <SelectTrigger className="bg-[#ffffff] dark:bg-[#2a2a2e]">
-              <SelectValue placeholder={t('knowledge.selectEmbeddingModel')} />
-            </SelectTrigger>
-            <SelectContent>
-              {Object.entries(groupedEmbeddingModels).map(
-                ([providerName, models]) => (
-                  <SelectGroup key={providerName}>
-                    <SelectLabel>{providerName}</SelectLabel>
-                    {models.map((model) => (
-                      <SelectItem key={model.uuid} value={model.uuid}>
-                        {model.name}
-                      </SelectItem>
-                    ))}
-                  </SelectGroup>
-                ),
-              )}
-            </SelectContent>
-          </Select>
-        </div>
-      );
-
-    case DynamicFormItemType.MODEL_FALLBACK_SELECTOR: {
-      // Group models by provider
-      const groupedModelsForFallback = llmModels.reduce(
-        (acc, model) => {
-          const providerName =
-            model.provider?.name || model.provider?.requester || 'Unknown';
-          if (!acc[providerName]) acc[providerName] = [];
-          acc[providerName].push(model);
-          return acc;
-        },
-        {} as Record<string, LLMModel[]>,
-      );
-
-      const rawModelValue = field.value;
-      const modelValue: { primary: string; fallbacks: string[] } =
-        rawModelValue != null &&
-        typeof rawModelValue === 'object' &&
-        !Array.isArray(rawModelValue)
-          ? {
-              primary:
-                typeof (rawModelValue as Record<string, unknown>).primary ===
-                'string'
-                  ? ((rawModelValue as Record<string, unknown>)
-                      .primary as string)
-                  : '',
-              fallbacks: Array.isArray(
-                (rawModelValue as Record<string, unknown>).fallbacks,
-              )
-                ? (
-                    (rawModelValue as Record<string, unknown>)
-                      .fallbacks as unknown[]
-                  ).filter((v): v is string => typeof v === 'string')
-                : [],
-            }
-          : {
-              primary: typeof rawModelValue === 'string' ? rawModelValue : '',
-              fallbacks: [],
-            };
-
-      const renderModelSelect = (
-        value: string,
-        onChange: (val: string) => void,
-        placeholder: string,
-      ) => (
-        <Select value={value} onValueChange={onChange}>
+        <Select value={field.value} onValueChange={field.onChange}>
           <SelectTrigger className="bg-[#ffffff] dark:bg-[#2a2a2e]">
-            <SelectValue placeholder={placeholder} />
+            <SelectValue placeholder={t('knowledge.selectEmbeddingModel')} />
           </SelectTrigger>
           <SelectContent>
-            {Object.entries(groupedModelsForFallback).map(
+            {Object.entries(groupedEmbeddingModels).map(
               ([providerName, models]) => (
                 <SelectGroup key={providerName}>
                   <SelectLabel>{providerName}</SelectLabel>
                   {models.map((model) => (
                     <SelectItem key={model.uuid} value={model.uuid}>
-                      <span className="inline-flex items-center gap-1">
-                        {model.name}
-                        {model.abilities?.includes('vision') && (
-                          <Eye className="h-3 w-3 text-muted-foreground" />
-                        )}
-                        {model.abilities?.includes('func_call') && (
-                          <Wrench className="h-3 w-3 text-muted-foreground" />
-                        )}
-                      </span>
+                      {model.name}
                     </SelectItem>
                   ))}
                 </SelectGroup>
@@ -410,120 +318,6 @@ export default function DynamicFormItemComponent({
         </Select>
       );
 
-      const updateValue = (patch: Partial<typeof modelValue>) => {
-        field.onChange({ ...modelValue, ...patch });
-      };
-
-      const addFallbackModel = () => {
-        updateValue({ fallbacks: [...modelValue.fallbacks, ''] });
-      };
-
-      const updateFallbackModel = (index: number, value: string) => {
-        const updated = [...modelValue.fallbacks];
-        updated[index] = value;
-        updateValue({ fallbacks: updated });
-      };
-
-      const removeFallbackModel = (index: number) => {
-        const updated = [...modelValue.fallbacks];
-        updated.splice(index, 1);
-        updateValue({ fallbacks: updated });
-      };
-
-      const moveFallbackModel = (index: number, direction: 'up' | 'down') => {
-        const updated = [...modelValue.fallbacks];
-        const newIndex = direction === 'up' ? index - 1 : index + 1;
-        if (newIndex < 0 || newIndex >= updated.length) return;
-        [updated[index], updated[newIndex]] = [
-          updated[newIndex],
-          updated[index],
-        ];
-        updateValue({ fallbacks: updated });
-      };
-
-      return (
-        <div className="space-y-3">
-          {/* Primary model selector */}
-          <div>
-            <p className="text-xs text-muted-foreground mb-1">
-              {t('models.fallback.primary')}
-            </p>
-            {renderModelSelect(
-              modelValue.primary,
-              (val) => updateValue({ primary: val }),
-              t('models.selectModel'),
-            )}
-          </div>
-
-          {/* Fallback models */}
-          {modelValue.fallbacks.length > 0 && (
-            <div className="space-y-2">
-              <p className="text-xs text-muted-foreground">
-                {t('models.fallback.fallbackList')}
-              </p>
-              {modelValue.fallbacks.map((fbUuid: string, index: number) => (
-                <div key={index} className="flex items-center gap-2">
-                  <span className="text-xs text-muted-foreground w-4 shrink-0">
-                    {index + 1}.
-                  </span>
-                  <div className="flex-1">
-                    {renderModelSelect(
-                      fbUuid,
-                      (val) => updateFallbackModel(index, val),
-                      t('models.selectModel'),
-                    )}
-                  </div>
-                  <div className="flex gap-1 shrink-0">
-                    <Button
-                      type="button"
-                      variant="ghost"
-                      size="sm"
-                      className="h-8 w-8 p-0"
-                      onClick={() => moveFallbackModel(index, 'up')}
-                      disabled={index === 0}
-                    >
-                      ↑
-                    </Button>
-                    <Button
-                      type="button"
-                      variant="ghost"
-                      size="sm"
-                      className="h-8 w-8 p-0"
-                      onClick={() => moveFallbackModel(index, 'down')}
-                      disabled={index === modelValue.fallbacks.length - 1}
-                    >
-                      ↓
-                    </Button>
-                    <Button
-                      type="button"
-                      variant="ghost"
-                      size="icon"
-                      className="h-8 w-8 text-muted-foreground hover:text-destructive"
-                      onClick={() => removeFallbackModel(index)}
-                    >
-                      <Trash2 className="size-4" />
-                    </Button>
-                  </div>
-                </div>
-              ))}
-            </div>
-          )}
-
-          {/* Add fallback button */}
-          <Button
-            type="button"
-            variant="outline"
-            size="sm"
-            className="w-full border-dashed text-muted-foreground hover:text-foreground"
-            onClick={addFallbackModel}
-          >
-            <Plus className="size-4 mr-1.5" />
-            {t('models.fallback.addFallback')}
-          </Button>
-        </div>
-      );
-    }
-
     case DynamicFormItemType.KNOWLEDGE_BASE_SELECTOR:
       // Group KBs by Knowledge Engine name
       const kbsByEngine = knowledgeBases.reduce(
@@ -543,25 +337,7 @@ export default function DynamicFormItemComponent({
       return (
         <Select value={field.value} onValueChange={field.onChange}>
           <SelectTrigger className="bg-[#ffffff] dark:bg-[#2a2a2e]">
-            {field.value && field.value !== '__none__' ? (
-              (() => {
-                const selectedKb = knowledgeBases.find(
-                  (kb) => kb.uuid === field.value,
-                );
-                return (
-                  <div className="flex items-center gap-2">
-                    {selectedKb?.emoji && (
-                      <span className="text-sm shrink-0">
-                        {selectedKb.emoji}
-                      </span>
-                    )}
-                    <span>{selectedKb?.name ?? field.value}</span>
-                  </div>
-                );
-              })()
-            ) : (
-              <SelectValue placeholder={t('knowledge.selectKnowledgeBase')} />
-            )}
+            <SelectValue placeholder={t('knowledge.selectKnowledgeBase')} />
           </SelectTrigger>
           <SelectContent>
             <SelectGroup>
@@ -573,12 +349,7 @@ export default function DynamicFormItemComponent({
                 <SelectLabel>{engineName}</SelectLabel>
                 {kbs.map((base) => (
                   <SelectItem key={base.uuid} value={base.uuid ?? ''}>
-                    <div className="flex items-center gap-2">
-                      {base.emoji && (
-                        <span className="text-sm shrink-0">{base.emoji}</span>
-                      )}
-                      <span>{base.name}</span>
-                    </div>
+                    {base.name}
                   </SelectItem>
                 ))}
               </SelectGroup>
@@ -622,11 +393,6 @@ export default function DynamicFormItemComponent({
                       <div className="flex items-center gap-2 flex-1">
                         <div className="flex-1 min-w-0">
                           <div className="font-medium flex items-center gap-2">
-                            {currentKb.emoji && (
-                              <span className="text-sm shrink-0">
-                                {currentKb.emoji}
-                              </span>
-                            )}
                             {currentKb.name}
                             {currentKb.knowledge_engine?.name && (
                               <span className="text-xs px-2 py-0.5 rounded-full bg-purple-100 text-purple-700 dark:bg-purple-900 dark:text-purple-300">
@@ -716,14 +482,7 @@ export default function DynamicFormItemComponent({
                             aria-label={`Select ${base.name}`}
                           />
                           <div className="flex-1">
-                            <div className="font-medium flex items-center gap-2">
-                              {base.emoji && (
-                                <span className="text-sm shrink-0">
-                                  {base.emoji}
-                                </span>
-                              )}
-                              {base.name}
-                            </div>
+                            <div className="font-medium">{base.name}</div>
                             {base.description && (
                               <div className="text-sm text-muted-foreground">
                                 {base.description}
@@ -775,18 +534,10 @@ export default function DynamicFormItemComponent({
         </Select>
       );
 
-    case DynamicFormItemType.PROMPT_EDITOR: {
-      // Guard: field.value may be undefined when the form resets or
-      // initialValues haven't propagated yet. Fall back to a default
-      // single system-prompt entry to prevent the .map() crash.
-      const promptItems: { role: string; content: string }[] = Array.isArray(
-        field.value,
-      )
-        ? field.value
-        : [{ role: 'system', content: '' }];
+    case DynamicFormItemType.PROMPT_EDITOR:
       return (
         <div className="space-y-2">
-          {promptItems.map(
+          {field.value.map(
             (item: { role: string; content: string }, index: number) => (
               <div key={index} className="flex gap-2 items-center">
                 {/* 角色选择 */}
@@ -798,7 +549,7 @@ export default function DynamicFormItemComponent({
                   <Select
                     value={item.role}
                     onValueChange={(value) => {
-                      const newValue = [...(field.value ?? promptItems)];
+                      const newValue = [...field.value];
                       newValue[index] = { ...newValue[index], role: value };
                       field.onChange(newValue);
                     }}
@@ -819,7 +570,7 @@ export default function DynamicFormItemComponent({
                   className="w-[300px]"
                   value={item.content}
                   onChange={(e) => {
-                    const newValue = [...(field.value ?? promptItems)];
+                    const newValue = [...field.value];
                     newValue[index] = {
                       ...newValue[index],
                       content: e.target.value,
@@ -833,7 +584,7 @@ export default function DynamicFormItemComponent({
                     type="button"
                     className="p-2 hover:bg-gray-100 rounded"
                     onClick={() => {
-                      const newValue = (field.value ?? promptItems).filter(
+                      const newValue = field.value.filter(
                         // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         (_: any, i: number) => i !== index,
                       );
@@ -857,17 +608,13 @@ export default function DynamicFormItemComponent({
             type="button"
             variant="outline"
             onClick={() => {
-              field.onChange([
-                ...(field.value ?? promptItems),
-                { role: 'user', content: '' },
-              ]);
+              field.onChange([...field.value, { role: 'user', content: '' }]);
             }}
           >
             {t('common.addRound')}
           </Button>
         </div>
       );
-    }
 
     case DynamicFormItemType.FILE:
       return (

web/src/app/home/components/home-sidebar/HomeSidebar.module.css

@@ -0,0 +1,159 @@
+.sidebarContainer {
+  box-sizing: border-box;
+  width: 11rem;
+  height: 100vh;
+  background-color: #eee;
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  justify-content: space-between;
+  padding-block: 1rem;
+  padding-left: 0.4rem;
+  user-select: none;
+  /* box-shadow: 0 0 5px 0 rgba(0, 0, 0, 0.1); */
+}
+
+:global(.dark) .sidebarContainer {
+  background-color: #0a0a0b !important;
+}
+
+.langbotIconContainer {
+  width: 200px;
+  height: 70px;
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  justify-content: center;
+  gap: 0.8rem;
+}
+
+.langbotIcon {
+  width: 2.8rem;
+  height: 2.8rem;
+  box-shadow: 0 0 10px 0 rgba(0, 0, 0, 0.1);
+  border-radius: 8px;
+}
+
+:global(.dark) .langbotIcon {
+  box-shadow: 0 0 10px 0 rgba(255, 255, 255, 0.1);
+}
+
+.langbotTextContainer {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  justify-content: flex-start;
+  gap: 0.1rem;
+}
+
+.langbotText {
+  font-size: 1.4rem;
+  font-weight: 500;
+  color: #1a1a1a;
+}
+
+:global(.dark) .langbotText {
+  font-size: 1.4rem;
+  font-weight: 500;
+  color: #f0f0f0 !important;
+}
+
+.langbotVersion {
+  font-size: 0.8rem;
+  font-weight: 700;
+  color: #6c6c6c;
+}
+
+:global(.dark) .langbotVersion {
+  font-size: 0.8rem;
+  font-weight: 700;
+  color: #a0a0a0 !important;
+}
+
+.sidebarTopContainer {
+  width: 100%;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 0.8rem;
+}
+
+.sidebarItemsContainer {
+  display: flex;
+  flex-direction: column;
+  gap: 0.8rem;
+}
+
+.sidebarChildContainer {
+  width: 9.8rem;
+  height: 3rem;
+  padding-left: 1.6rem;
+  font-size: 1rem;
+  border-radius: 12px;
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  justify-content: flex-start;
+  cursor: pointer;
+  gap: 0.5rem;
+  transition: all 0.2s ease;
+  /* background-color: aqua; */
+}
+
+.sidebarSelected {
+  background-color: #2288ee;
+  color: white;
+  box-shadow: 0 0 10px 0 rgba(0, 0, 0, 0.1);
+}
+
+:global(.dark) .sidebarSelected {
+  background-color: #2288ee;
+  color: white;
+  box-shadow: 0 0 10px 0 rgba(34, 136, 238, 0.3);
+}
+
+.sidebarUnselected {
+  color: #6c6c6c;
+}
+
+:global(.dark) .sidebarUnselected {
+  color: #a0a0a0 !important;
+}
+
+.sidebarUnselected:hover {
+  background-color: rgba(34, 136, 238, 0.1);
+  color: #2288ee;
+}
+
+:global(.dark) .sidebarUnselected:hover {
+  background-color: rgba(34, 136, 238, 0.2);
+  color: #66baff;
+}
+
+.sidebarChildIcon {
+  width: 20px;
+  height: 20px;
+  background-color: rgba(96, 149, 209, 0);
+}
+
+.sidebarChildName {
+  color: inherit;
+}
+
+.sidebarBottomContainer {
+  width: 100%;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  margin-top: auto;
+  padding-bottom: 1rem;
+}
+
+.sidebarBottomChildContainer {
+  width: 100%;
+  height: 50px;
+  display: flex;
+  flex-direction: row;
+}

web/src/app/home/components/home-sidebar/HomeSidebarChild.tsx

@@ -1,7 +1,6 @@
+import styles from './HomeSidebar.module.css';
 import { I18nObject } from '@/app/infra/entities/common';
 
-export type SidebarSection = 'home' | 'extensions' | 'standalone';
-
 export interface ISidebarChildVO {
   id: string;
   icon: React.ReactNode;
@@ -9,7 +8,6 @@ export interface ISidebarChildVO {
   route: string;
   description: string;
   helpLink: I18nObject;
-  section?: SidebarSection;
 }
 
 export class SidebarChildVO {
@@ -19,7 +17,6 @@ export class SidebarChildVO {
   route: string;
   description: string;
   helpLink: I18nObject;
-  section: SidebarSection;
 
   constructor(props: ISidebarChildVO) {
     this.id = props.id;
@@ -28,6 +25,29 @@ export class SidebarChildVO {
     this.route = props.route;
     this.description = props.description;
     this.helpLink = props.helpLink;
-    this.section = props.section ?? 'home';
   }
 }
+
+export function SidebarChild({
+  icon,
+  name,
+  isSelected,
+  onClick,
+}: {
+  icon: React.ReactNode;
+  name: string;
+  isSelected: boolean;
+  onClick: () => void;
+}) {
+  return (
+    <div
+      className={`${styles.sidebarChildContainer} ${
+        isSelected ? styles.sidebarSelected : styles.sidebarUnselected
+      }`}
+      onClick={onClick}
+    >
+      <div className={`${styles.sidebarChildIcon}`}>{icon}</div>
+      <span className={`${styles.sidebarChildName}`}>{name}</span>
+    </div>
+  );
+}

web/src/app/home/components/home-sidebar/SidebarDataContext.tsx

@@ -1,242 +0,0 @@
-'use client';
-
-import React, {
-  createContext,
-  useContext,
-  useState,
-  useEffect,
-  useCallback,
-} from 'react';
-import { httpClient, getCloudServiceClientSync } from '@/app/infra/http';
-import { extractI18nObject } from '@/i18n/I18nProvider';
-import { isNewerVersion } from '@/app/utils/versionCompare';
-
-// Lightweight entity item for sidebar display
-export interface SidebarEntityItem {
-  id: string;
-  name: string;
-  description?: string;
-  emoji?: string;
-  iconURL?: string;
-  updatedAt?: string; // ISO timestamp for sorting by most recently edited
-  // Bot-specific fields
-  enabled?: boolean;
-  // MCP-specific fields
-  runtimeStatus?: 'connecting' | 'connected' | 'error';
-  // Plugin-specific fields
-  installSource?: string;
-  installInfo?: Record<string, unknown>;
-  hasUpdate?: boolean;
-  debug?: boolean;
-}
-
-// Install action types that can be triggered from sidebar
-export type PluginInstallAction = 'local' | 'github' | null;
-
-// Entity lists and refresh functions exposed via context
-export interface SidebarDataContextValue {
-  bots: SidebarEntityItem[];
-  pipelines: SidebarEntityItem[];
-  knowledgeBases: SidebarEntityItem[];
-  plugins: SidebarEntityItem[];
-  mcpServers: SidebarEntityItem[];
-  refreshBots: () => Promise<void>;
-  refreshPipelines: () => Promise<void>;
-  refreshKnowledgeBases: () => Promise<void>;
-  refreshPlugins: () => Promise<void>;
-  refreshMCPServers: () => Promise<void>;
-  refreshAll: () => Promise<void>;
-  // Breadcrumb: entity name shown when viewing a detail page
-  detailEntityName: string | null;
-  setDetailEntityName: (name: string | null) => void;
-  // Pending plugin install action triggered from sidebar
-  pendingPluginInstallAction: PluginInstallAction;
-  setPendingPluginInstallAction: (action: PluginInstallAction) => void;
-}
-
-const SidebarDataContext = createContext<SidebarDataContextValue | null>(null);
-
-export function SidebarDataProvider({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
-  const [bots, setBots] = useState<SidebarEntityItem[]>([]);
-  const [pipelines, setPipelines] = useState<SidebarEntityItem[]>([]);
-  const [knowledgeBases, setKnowledgeBases] = useState<SidebarEntityItem[]>([]);
-  const [plugins, setPlugins] = useState<SidebarEntityItem[]>([]);
-  const [mcpServers, setMCPServers] = useState<SidebarEntityItem[]>([]);
-  const [detailEntityName, setDetailEntityName] = useState<string | null>(null);
-  const [pendingPluginInstallAction, setPendingPluginInstallAction] =
-    useState<PluginInstallAction>(null);
-
-  const refreshBots = useCallback(async () => {
-    try {
-      const resp = await httpClient.getBots();
-      setBots(
-        resp.bots.map((bot) => ({
-          id: bot.uuid || '',
-          name: bot.name,
-          description: bot.description,
-          iconURL: httpClient.getAdapterIconURL(bot.adapter),
-          updatedAt: bot.updated_at,
-          enabled: bot.enable ?? true,
-        })),
-      );
-    } catch (error) {
-      console.error('Failed to fetch bots for sidebar:', error);
-    }
-  }, []);
-
-  const refreshPipelines = useCallback(async () => {
-    try {
-      const resp = await httpClient.getPipelines();
-      setPipelines(
-        resp.pipelines.map((p) => ({
-          id: p.uuid || '',
-          name: p.name,
-          description: p.description,
-          emoji: p.emoji,
-          updatedAt: p.updated_at,
-        })),
-      );
-    } catch (error) {
-      console.error('Failed to fetch pipelines for sidebar:', error);
-    }
-  }, []);
-
-  const refreshKnowledgeBases = useCallback(async () => {
-    try {
-      const resp = await httpClient.getKnowledgeBases();
-      setKnowledgeBases(
-        resp.bases.map((kb) => ({
-          id: kb.uuid || '',
-          name: kb.name,
-          description: kb.description,
-          emoji: kb.emoji,
-          updatedAt: kb.updated_at,
-        })),
-      );
-    } catch (error) {
-      console.error('Failed to fetch knowledge bases for sidebar:', error);
-    }
-  }, []);
-
-  const refreshPlugins = useCallback(async () => {
-    try {
-      const [pluginsResp, marketplaceResp] = await Promise.all([
-        httpClient.getPlugins(),
-        getCloudServiceClientSync()
-          .getMarketplacePlugins(1, 100)
-          .catch(() => ({ plugins: [] })),
-      ]);
-
-      // Build marketplace version lookup: "author/name" -> latest_version
-      const marketplaceVersions = new Map<string, string>();
-      for (const mp of marketplaceResp.plugins) {
-        if (mp.latest_version) {
-          marketplaceVersions.set(`${mp.author}/${mp.name}`, mp.latest_version);
-        }
-      }
-
-      setPlugins(
-        pluginsResp.plugins.map((plugin) => {
-          const meta = plugin.manifest.manifest.metadata;
-          const author = meta.author ?? '';
-          const name = meta.name;
-          const compositeKey = `${author}/${name}`;
-          const installedVersion = meta.version ?? '';
-
-          let hasUpdate = false;
-          if (plugin.install_source === 'marketplace') {
-            const latestVersion = marketplaceVersions.get(compositeKey);
-            if (latestVersion) {
-              hasUpdate = isNewerVersion(latestVersion, installedVersion);
-            }
-          }
-
-          return {
-            id: compositeKey,
-            name: extractI18nObject(meta.label),
-            iconURL: httpClient.getPluginIconURL(author, name),
-            installSource: plugin.install_source,
-            installInfo: plugin.install_info,
-            hasUpdate,
-            debug: plugin.debug,
-          };
-        }),
-      );
-    } catch (error) {
-      console.error('Failed to fetch plugins for sidebar:', error);
-    }
-  }, []);
-
-  const refreshMCPServers = useCallback(async () => {
-    try {
-      const resp = await httpClient.getMCPServers();
-      setMCPServers(
-        resp.servers.map((server) => ({
-          id: server.name,
-          name: server.name,
-          enabled: server.enable,
-          runtimeStatus: server.runtime_info?.status,
-        })),
-      );
-    } catch (error) {
-      console.error('Failed to fetch MCP servers for sidebar:', error);
-    }
-  }, []);
-
-  const refreshAll = useCallback(async () => {
-    await Promise.all([
-      refreshBots(),
-      refreshPipelines(),
-      refreshKnowledgeBases(),
-      refreshPlugins(),
-      refreshMCPServers(),
-    ]);
-  }, [
-    refreshBots,
-    refreshPipelines,
-    refreshKnowledgeBases,
-    refreshPlugins,
-    refreshMCPServers,
-  ]);
-
-  // Fetch all entity lists on mount
-  useEffect(() => {
-    refreshAll();
-  }, [refreshAll]);
-
-  return (
-    <SidebarDataContext.Provider
-      value={{
-        bots,
-        pipelines,
-        knowledgeBases,
-        plugins,
-        mcpServers,
-        refreshBots,
-        refreshPipelines,
-        refreshKnowledgeBases,
-        refreshPlugins,
-        refreshMCPServers,
-        refreshAll,
-        detailEntityName,
-        setDetailEntityName,
-        pendingPluginInstallAction,
-        setPendingPluginInstallAction,
-      }}
-    >
-      {children}
-    </SidebarDataContext.Provider>
-  );
-}
-
-export function useSidebarData(): SidebarDataContextValue {
-  const ctx = useContext(SidebarDataContext);
-  if (!ctx) {
-    throw new Error('useSidebarData must be used within a SidebarDataProvider');
-  }
-  return ctx;
-}

web/src/app/home/components/home-sidebar/sidbarConfigList.tsx

@@ -1,4 +1,5 @@
 import { SidebarChildVO } from '@/app/home/components/home-sidebar/HomeSidebarChild';
+import styles from './HomeSidebar.module.css';
 import i18n from '@/i18n';
 
 const t = (key: string) => {
@@ -6,54 +7,12 @@ const t = (key: string) => {
 };
 
 export const sidebarConfigList = [
-  // ── Quick Start ──
-  new SidebarChildVO({
-    id: 'wizard',
-    name: t('sidebar.quickStart'),
-    icon: (
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        viewBox="0 0 24 24"
-        fill="currentColor"
-      >
-        <path d="M13 9H21L11 24V15H4L13 0V9ZM11 11V7.22063L7.53238 13H13V17.3944L17.263 11H11Z"></path>
-      </svg>
-    ),
-    route: '/wizard',
-    description: t('wizard.sidebarDescription'),
-    helpLink: {
-      en_US: '',
-      zh_Hans: '',
-    },
-    section: 'standalone',
-  }),
-
-  // ── Home section ──
-  new SidebarChildVO({
-    id: 'monitoring',
-    name: t('monitoring.title'),
-    icon: (
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        viewBox="0 0 24 24"
-        fill="currentColor"
-      >
-        <path d="M2 3.9934C2 3.44476 2.45531 3 2.9918 3H21.0082C21.556 3 22 3.44495 22 3.9934V20.0066C22 20.5552 21.5447 21 21.0082 21H2.9918C2.44405 21 2 20.5551 2 20.0066V3.9934ZM4 5V19H20V5H4ZM6 7H18V9H6V7ZM6 11H18V13H6V11ZM6 15H12V17H6V15Z"></path>
-      </svg>
-    ),
-    route: '/home/monitoring',
-    description: t('monitoring.description'),
-    helpLink: {
-      en_US: '',
-      zh_Hans: '',
-    },
-    section: 'home',
-  }),
   new SidebarChildVO({
     id: 'bots',
     name: t('bots.title'),
     icon: (
       <svg
+        className={`${styles.sidebarChildIcon}`}
         xmlns="http://www.w3.org/2000/svg"
         viewBox="0 0 24 24"
         fill="currentColor"
@@ -64,17 +23,17 @@ export const sidebarConfigList = [
     route: '/home/bots',
     description: t('bots.description'),
     helpLink: {
-      en_US: 'https://docs.langbot.app/en/usage/platforms/readme',
-      zh_Hans: 'https://docs.langbot.app/zh/usage/platforms/readme',
-      ja_JP: 'https://docs.langbot.app/ja/usage/platforms/readme',
+      en_US: 'https://docs.langbot.app/en/usage/platforms/readme.html',
+      zh_Hans: 'https://docs.langbot.app/zh/usage/platforms/readme.html',
+      ja_JP: 'https://docs.langbot.app/ja/usage/platforms/readme.html',
     },
-    section: 'home',
   }),
   new SidebarChildVO({
     id: 'pipelines',
     name: t('pipelines.title'),
     icon: (
       <svg
+        className={`${styles.sidebarChildIcon}`}
         xmlns="http://www.w3.org/2000/svg"
         viewBox="0 0 24 24"
         fill="currentColor"
@@ -85,11 +44,30 @@ export const sidebarConfigList = [
     route: '/home/pipelines',
     description: t('pipelines.description'),
     helpLink: {
-      en_US: 'https://docs.langbot.app/en/usage/pipelines/readme',
-      zh_Hans: 'https://docs.langbot.app/zh/usage/pipelines/readme',
-      ja_JP: 'https://docs.langbot.app/ja/usage/pipelines/readme',
+      en_US: 'https://docs.langbot.app/en/usage/pipelines/readme.html',
+      zh_Hans: 'https://docs.langbot.app/zh/usage/pipelines/readme.html',
+      ja_JP: 'https://docs.langbot.app/ja/usage/pipelines/readme.html',
+    },
+  }),
+  new SidebarChildVO({
+    id: 'monitoring',
+    name: t('monitoring.title'),
+    icon: (
+      <svg
+        className={`${styles.sidebarChildIcon}`}
+        xmlns="http://www.w3.org/2000/svg"
+        viewBox="0 0 24 24"
+        fill="currentColor"
+      >
+        <path d="M2 3.9934C2 3.44476 2.45531 3 2.9918 3H21.0082C21.556 3 22 3.44495 22 3.9934V20.0066C22 20.5552 21.5447 21 21.0082 21H2.9918C2.44405 21 2 20.5551 2 20.0066V3.9934ZM4 5V19H20V5H4ZM6 7H18V9H6V7ZM6 11H18V13H6V11ZM6 15H12V17H6V15Z"></path>
+      </svg>
+    ),
+    route: '/home/monitoring',
+    description: t('monitoring.description'),
+    helpLink: {
+      en_US: 'https://docs.langbot.app/en/features/monitoring.html',
+      zh_Hans: 'https://docs.langbot.app/zh/features/monitoring.html',
     },
-    section: 'home',
   }),
   new SidebarChildVO({
     id: 'knowledge',
@@ -106,19 +84,17 @@ export const sidebarConfigList = [
     route: '/home/knowledge',
     description: t('knowledge.description'),
     helpLink: {
-      en_US: 'https://docs.langbot.app/en/usage/knowledge/readme',
-      zh_Hans: 'https://docs.langbot.app/zh/usage/knowledge/readme',
-      ja_JP: 'https://docs.langbot.app/ja/usage/knowledge/readme',
+      en_US: 'https://docs.langbot.app/en/usage/knowledge/readme.html',
+      zh_Hans: 'https://docs.langbot.app/zh/usage/knowledge/readme.html',
+      ja_JP: 'https://docs.langbot.app/ja/usage/knowledge/readme.html',
     },
-    section: 'home',
   }),
-
-  // ── Extensions section ──
   new SidebarChildVO({
     id: 'plugins',
-    name: t('sidebar.installedPlugins'),
+    name: t('plugins.title'),
     icon: (
       <svg
+        className={`${styles.sidebarChildIcon}`}
         xmlns="http://www.w3.org/2000/svg"
         viewBox="0 0 24 24"
         fill="currentColor"
@@ -129,51 +105,9 @@ export const sidebarConfigList = [
     route: '/home/plugins',
     description: t('plugins.description'),
     helpLink: {
-      en_US: 'https://docs.langbot.app/en/usage/plugin/plugin-intro',
-      zh_Hans: 'https://docs.langbot.app/zh/usage/plugin/plugin-intro',
-      ja_JP: 'https://docs.langbot.app/ja/usage/plugin/plugin-intro',
+      en_US: 'https://docs.langbot.app/en/usage/plugin/plugin-intro.html',
+      zh_Hans: 'https://docs.langbot.app/zh/usage/plugin/plugin-intro.html',
+      ja_JP: 'https://docs.langbot.app/ja/usage/plugin/plugin-intro.html',
     },
-    section: 'extensions',
-  }),
-  new SidebarChildVO({
-    id: 'market',
-    name: t('sidebar.pluginMarket'),
-    icon: (
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        viewBox="0 0 24 24"
-        fill="currentColor"
-      >
-        <path d="M21 13.242V20H22V22H2V20H3V13.242C1.79401 12.435 1 11.0602 1 9.5C1 8.67286 1.25027 7.90335 1.67755 7.2612L4.5547 2.36088C4.80513 1.93859 5.26028 1.67578 5.76 1.67578H18.24C18.7397 1.67578 19.1949 1.93859 19.4453 2.36088L22.3225 7.2612C22.7497 7.90335 23 8.67286 23 9.5C23 11.0602 22.206 12.435 21 13.242ZM19 13.972C18.4511 14.0706 17.8794 14.0706 17.3305 13.972C16.1644 13.7566 15.1377 13.0712 14.5 12.1C13.8623 13.0712 12.8356 13.7566 11.6695 13.972C11.1206 14.0706 10.5489 14.0706 10 13.972C9.45108 14.0706 8.87938 14.0706 8.33053 13.972C7.16437 13.7566 6.13771 13.0712 5.5 12.1C4.86229 13.0712 3.83563 13.7566 2.66947 13.972C2.44883 14.0124 2.22434 14.0352 2 14.0404V20H5V15H10V20H19V13.972Z"></path>
-      </svg>
-    ),
-    route: '/home/market',
-    description: t('plugins.description'),
-    helpLink: {
-      en_US: 'https://docs.langbot.app/en/usage/plugin/plugin-intro',
-      zh_Hans: 'https://docs.langbot.app/zh/usage/plugin/plugin-intro',
-      ja_JP: 'https://docs.langbot.app/ja/usage/plugin/plugin-intro',
-    },
-    section: 'extensions',
-  }),
-  new SidebarChildVO({
-    id: 'mcp',
-    name: t('sidebar.mcpServers'),
-    icon: (
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        viewBox="0 0 24 24"
-        fill="currentColor"
-      >
-        <path d="M4.5 7.65311V16.3469L12 20.689L19.5 16.3469V7.65311L12 3.311L4.5 7.65311ZM12 1L21.5 6.5V17.5L12 23L2.5 17.5V6.5L12 1ZM6.49896 9.97065L11 12.5765V17.625H13V12.5765L17.501 9.97066L16.499 8.2398L12 10.8445L7.50104 8.2398L6.49896 9.97065Z"></path>
-      </svg>
-    ),
-    route: '/home/mcp',
-    description: t('mcp.title'),
-    helpLink: {
-      en_US: '',
-      zh_Hans: '',
-    },
-    section: 'extensions',
   }),
 ];

web/src/app/home/components/home-titlebar/HomeTitleBar.tsx

@@ -0,0 +1,39 @@
+import { extractI18nObject } from '@/i18n/I18nProvider';
+import styles from './HomeTittleBar.module.css';
+import { I18nObject } from '@/app/infra/entities/common';
+
+export default function HomeTitleBar({
+  title,
+  subtitle,
+  helpLink,
+}: {
+  title: string;
+  subtitle: string;
+  helpLink: I18nObject;
+}) {
+  return (
+    <div className={`${styles.titleBarContainer}`}>
+      <div className={`${styles.titleText}`}>{title}</div>
+      <div className={`${styles.subtitleText}`}>
+        {subtitle}
+        <span className={`${styles.helpLink}`}>
+          <div
+            onClick={() => {
+              window.open(extractI18nObject(helpLink), '_blank');
+            }}
+            className="cursor-pointer"
+          >
+            <svg
+              className="w-[1rem] h-[1rem]"
+              xmlns="http://www.w3.org/2000/svg"
+              viewBox="0 0 24 24"
+              fill="currentColor"
+            >
+              <path d="M12 22C6.47715 22 2 17.5228 2 12C2 6.47715 6.47715 2 12 2C17.5228 2 22 6.47715 22 12C22 17.5228 17.5228 22 12 22ZM12 20C16.4183 20 20 16.4183 20 12C20 7.58172 16.4183 4 12 4C7.58172 4 4 7.58172 4 12C4 16.4183 7.58172 20 12 20ZM11 15H13V17H11V15ZM13 13.3551V14H11V12.5C11 11.9477 11.4477 11.5 12 11.5C12.8284 11.5 13.5 10.8284 13.5 10C13.5 9.17157 12.8284 8.5 12 8.5C11.2723 8.5 10.6656 9.01823 10.5288 9.70577L8.56731 9.31346C8.88637 7.70919 10.302 6.5 12 6.5C13.933 6.5 15.5 8.067 15.5 10C15.5 11.5855 14.4457 12.9248 13 13.3551Z"></path>
+            </svg>
+          </div>
+        </span>
+      </div>
+    </div>
+  );
+}

web/src/app/home/components/home-titlebar/HomeTittleBar.module.css

@@ -0,0 +1,44 @@
+.titleBarContainer {
+  width: 100%;
+  padding-top: 1rem;
+  height: 4rem;
+  opacity: 1;
+  font-size: 20px;
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  justify-content: center;
+}
+
+.titleText {
+  margin-left: 3.2rem;
+  font-size: 1.4rem;
+  font-weight: 500;
+  color: #585858;
+}
+
+:global(.dark) .titleText {
+  color: #e0e0e0;
+}
+
+.subtitleText {
+  margin-left: 3.2rem;
+  font-size: 0.8rem;
+  color: #808080;
+  display: flex;
+  align-items: center;
+}
+
+:global(.dark) .subtitleText {
+  color: #b0b0b0;
+}
+
+.helpLink {
+  margin-left: 0.2rem;
+  font-size: 0.8rem;
+  color: #8b8b8b;
+}
+
+:global(.dark) .helpLink {
+  color: #a0a0a0;
+}

web/src/app/home/components/models-dialog/ModelsDialog.tsx

@@ -463,16 +463,14 @@ export default function ModelsDialog({
                     )
                   : t('models.providerCount', { count: otherProviders.length })}
               </span>
-              <div className="flex gap-2">
-                <Button
-                  size="sm"
-                  variant="outline"
-                  onClick={handleCreateProvider}
-                >
-                  <Plus className="h-4 w-4 mr-1" />
-                  {t('models.addProvider')}
-                </Button>
-              </div>
+              <Button
+                size="sm"
+                variant="outline"
+                onClick={handleCreateProvider}
+              >
+                <Plus className="h-4 w-4 mr-1" />
+                {t('models.addProvider')}
+              </Button>
             </div>
 
             {/* Provider List */}

web/src/app/home/components/new-version-dialog/NewVersionDialog.tsx

@@ -36,11 +36,11 @@ export default function NewVersionDialog({
   const getUpdateDocsUrl = () => {
     const language = i18n.language;
     if (language === 'zh-Hans' || language === 'zh-Hant') {
-      return 'https://docs.langbot.app/zh/deploy/update';
+      return 'https://docs.langbot.app/zh/deploy/update.html';
     } else if (language === 'ja-JP') {
-      return 'https://docs.langbot.app/ja/deploy/update';
+      return 'https://docs.langbot.app/ja/deploy/update.html';
     } else {
-      return 'https://docs.langbot.app/en/deploy/update';
+      return 'https://docs.langbot.app/en/deploy/update.html';
     }
   };
 

web/src/app/home/knowledge/KBDetailContent.tsx

@@ -1,279 +0,0 @@
-'use client';
-
-import { useState, useEffect, useCallback } from 'react';
-import { useRouter } from 'next/navigation';
-import { Tabs, TabsList, TabsTrigger, TabsContent } from '@/components/ui/tabs';
-import { Button } from '@/components/ui/button';
-import {
-  Card,
-  CardContent,
-  CardDescription,
-  CardHeader,
-  CardTitle,
-} from '@/components/ui/card';
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-  DialogDescription,
-  DialogFooter,
-} from '@/components/ui/dialog';
-import KBForm from '@/app/home/knowledge/components/kb-form/KBForm';
-import KBDoc from '@/app/home/knowledge/components/kb-docs/KBDoc';
-import KBRetrieveGeneric from '@/app/home/knowledge/components/kb-retrieve/KBRetrieveGeneric';
-import { httpClient } from '@/app/infra/http/HttpClient';
-import { useSidebarData } from '@/app/home/components/home-sidebar/SidebarDataContext';
-import { useTranslation } from 'react-i18next';
-import { KnowledgeBase } from '@/app/infra/entities/api';
-import { CustomApiError } from '@/app/infra/entities/common';
-import { toast } from 'sonner';
-import { FileText, FolderOpen, Search, Trash2 } from 'lucide-react';
-
-export default function KBDetailContent({ id }: { id: string }) {
-  const isCreateMode = id === 'new';
-  const router = useRouter();
-  const { t } = useTranslation();
-  const { refreshKnowledgeBases, knowledgeBases, setDetailEntityName } =
-    useSidebarData();
-
-  // Set breadcrumb entity name
-  useEffect(() => {
-    if (isCreateMode) {
-      setDetailEntityName(t('knowledge.createKnowledgeBase'));
-    } else {
-      const kb = knowledgeBases.find((k) => k.id === id);
-      setDetailEntityName(kb?.name ?? id);
-    }
-    return () => setDetailEntityName(null);
-  }, [id, isCreateMode, knowledgeBases, setDetailEntityName, t]);
-
-  const [activeTab, setActiveTab] = useState('metadata');
-  const [showDeleteConfirm, setShowDeleteConfirm] = useState(false);
-  const [kbInfo, setKbInfo] = useState<KnowledgeBase | null>(null);
-  const [formDirty, setFormDirty] = useState(false);
-
-  const loadKbInfo = useCallback(
-    async (kbId: string) => {
-      try {
-        const resp = await httpClient.getKnowledgeBase(kbId);
-        setKbInfo(resp.base);
-      } catch (e) {
-        console.error('Failed to load KB info:', e);
-        toast.error(
-          t('knowledge.loadKnowledgeBaseFailed') + (e as CustomApiError).msg,
-        );
-      }
-    },
-    [t],
-  );
-
-  // Load KB info for determining capabilities (e.g. doc_ingestion)
-  useEffect(() => {
-    if (!isCreateMode) {
-      loadKbInfo(id);
-    }
-  }, [id, isCreateMode, loadKbInfo]);
-
-  const hasDocumentCapability = (): boolean => {
-    if (!kbInfo || !kbInfo.knowledge_engine) return false;
-    return (
-      kbInfo.knowledge_engine.capabilities?.includes('doc_ingestion') ?? false
-    );
-  };
-
-  function handleKbDeleted() {
-    refreshKnowledgeBases();
-    router.push('/home/knowledge');
-  }
-
-  function handleNewKbCreated(newKbId: string) {
-    refreshKnowledgeBases();
-    router.push(`/home/knowledge?id=${encodeURIComponent(newKbId)}`);
-  }
-
-  function handleKbUpdated() {
-    refreshKnowledgeBases();
-    loadKbInfo(id);
-  }
-
-  async function confirmDelete() {
-    try {
-      await httpClient.deleteKnowledgeBase(id);
-      setShowDeleteConfirm(false);
-      handleKbDeleted();
-    } catch (e) {
-      toast.error(
-        t('knowledge.deleteKnowledgeBaseFailed') + (e as CustomApiError).msg,
-      );
-    }
-  }
-
-  const retrieveFunction = async (kbId: string, query: string) => {
-    return await httpClient.retrieveKnowledgeBase(kbId, query);
-  };
-
-  // ==================== Create Mode ====================
-  if (isCreateMode) {
-    return (
-      <div className="flex h-full flex-col">
-        <div className="flex items-center justify-between pb-4 shrink-0">
-          <h1 className="text-xl font-semibold">
-            {t('knowledge.createKnowledgeBase')}
-          </h1>
-          <Button type="submit" form="kb-form">
-            {t('common.submit')}
-          </Button>
-        </div>
-
-        <div className="flex-1 overflow-y-auto min-h-0">
-          <div className="mx-auto max-w-3xl pb-8">
-            <KBForm
-              initKbId={undefined}
-              onNewKbCreated={handleNewKbCreated}
-              onKbUpdated={handleKbUpdated}
-            />
-          </div>
-        </div>
-      </div>
-    );
-  }
-
-  // ==================== Edit Mode ====================
-  return (
-    <>
-      <div className="flex h-full flex-col">
-        {/* Sticky Header: title + save button */}
-        <div className="flex items-center justify-between pb-4 shrink-0">
-          <h1 className="text-xl font-semibold">
-            {t('knowledge.editKnowledgeBase')}
-          </h1>
-          <Button type="submit" form="kb-form" disabled={!formDirty}>
-            {t('common.save')}
-          </Button>
-        </div>
-
-        {/* Horizontal Tabs */}
-        <Tabs
-          key={id}
-          value={activeTab}
-          onValueChange={setActiveTab}
-          className="flex flex-1 flex-col min-h-0"
-        >
-          <TabsList className="shrink-0">
-            <TabsTrigger value="metadata" className="gap-1.5">
-              <FileText className="size-3.5" />
-              {t('knowledge.metadata')}
-            </TabsTrigger>
-            {hasDocumentCapability() && (
-              <TabsTrigger value="documents" className="gap-1.5">
-                <FolderOpen className="size-3.5" />
-                {t('knowledge.documents')}
-              </TabsTrigger>
-            )}
-            <TabsTrigger value="retrieve" className="gap-1.5">
-              <Search className="size-3.5" />
-              {t('knowledge.retrieve')}
-            </TabsTrigger>
-          </TabsList>
-
-          {/* Tab: Metadata */}
-          <TabsContent
-            value="metadata"
-            className="flex-1 min-h-0 overflow-y-auto mt-4"
-          >
-            <div className="mx-auto max-w-3xl space-y-6 pb-8">
-              <KBForm
-                initKbId={id}
-                onNewKbCreated={handleNewKbCreated}
-                onKbUpdated={handleKbUpdated}
-                onDirtyChange={setFormDirty}
-              />
-
-              {/* Danger Zone Card */}
-              <Card className="border-destructive/50">
-                <CardHeader>
-                  <CardTitle className="text-destructive">
-                    {t('knowledge.dangerZone')}
-                  </CardTitle>
-                  <CardDescription>
-                    {t('knowledge.dangerZoneDescription')}
-                  </CardDescription>
-                </CardHeader>
-                <CardContent>
-                  <div className="flex items-center justify-between">
-                    <div className="space-y-1">
-                      <p className="text-sm font-medium">
-                        {t('knowledge.deleteKbAction')}
-                      </p>
-                      <p className="text-sm text-muted-foreground">
-                        {t('knowledge.deleteKbHint')}
-                      </p>
-                    </div>
-                    <Button
-                      type="button"
-                      variant="destructive"
-                      size="sm"
-                      onClick={() => setShowDeleteConfirm(true)}
-                    >
-                      <Trash2 className="size-4 mr-1.5" />
-                      {t('common.delete')}
-                    </Button>
-                  </div>
-                </CardContent>
-              </Card>
-            </div>
-          </TabsContent>
-
-          {/* Tab: Documents */}
-          {hasDocumentCapability() && (
-            <TabsContent
-              value="documents"
-              className="flex-1 min-h-0 overflow-y-auto mt-4"
-            >
-              <KBDoc
-                kbId={id}
-                ragEngineName={kbInfo?.knowledge_engine?.name}
-                ragEngineCapabilities={kbInfo?.knowledge_engine?.capabilities}
-              />
-            </TabsContent>
-          )}
-
-          {/* Tab: Retrieve */}
-          <TabsContent
-            value="retrieve"
-            className="flex-1 min-h-0 overflow-y-auto mt-4"
-          >
-            <KBRetrieveGeneric kbId={id} retrieveFunction={retrieveFunction} />
-          </TabsContent>
-        </Tabs>
-      </div>
-
-      {/* Delete confirmation dialog */}
-      <Dialog open={showDeleteConfirm} onOpenChange={setShowDeleteConfirm}>
-        <DialogContent>
-          <DialogHeader>
-            <DialogTitle>{t('common.confirmDelete')}</DialogTitle>
-            <DialogDescription className="sr-only">
-              {t('knowledge.deleteKnowledgeBaseConfirmation')}
-            </DialogDescription>
-          </DialogHeader>
-          <div className="py-4">
-            {t('knowledge.deleteKnowledgeBaseConfirmation')}
-          </div>
-          <DialogFooter>
-            <Button
-              variant="outline"
-              onClick={() => setShowDeleteConfirm(false)}
-            >
-              {t('common.cancel')}
-            </Button>
-            <Button variant="destructive" onClick={confirmDelete}>
-              {t('common.confirmDelete')}
-            </Button>
-          </DialogFooter>
-        </DialogContent>
-      </Dialog>
-    </>
-  );
-}

web/src/app/home/knowledge/KBDetailDialog.tsx

@@ -0,0 +1,305 @@
+'use client';
+
+import { useEffect, useState } from 'react';
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+  DialogFooter,
+} from '@/components/ui/dialog';
+import {
+  Sidebar,
+  SidebarContent,
+  SidebarGroup,
+  SidebarGroupContent,
+  SidebarMenu,
+  SidebarMenuButton,
+  SidebarMenuItem,
+  SidebarProvider,
+} from '@/components/ui/sidebar';
+import { Button } from '@/components/ui/button';
+import { useTranslation } from 'react-i18next';
+import { httpClient } from '@/app/infra/http/HttpClient';
+import { KnowledgeBase } from '@/app/infra/entities/api';
+import { CustomApiError } from '@/app/infra/entities/common';
+import { toast } from 'sonner';
+import KBForm from '@/app/home/knowledge/components/kb-form/KBForm';
+import KBDoc from '@/app/home/knowledge/components/kb-docs/KBDoc';
+import KBRetrieveGeneric from '@/app/home/knowledge/components/kb-retrieve/KBRetrieveGeneric';
+
+interface KBDetailDialogProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  kbId?: string;
+  onFormCancel: () => void;
+  onKbDeleted: () => void;
+  onNewKbCreated: (kbId: string) => void;
+  onKbUpdated: (kbId: string) => void;
+}
+
+export default function KBDetailDialog({
+  open,
+  onOpenChange,
+  kbId: propKbId,
+  onFormCancel,
+  onKbDeleted,
+  onNewKbCreated,
+  onKbUpdated,
+}: KBDetailDialogProps) {
+  const { t } = useTranslation();
+  const [kbId, setKbId] = useState<string | undefined>(propKbId);
+  const [activeMenu, setActiveMenu] = useState('metadata');
+  const [showDeleteConfirm, setShowDeleteConfirm] = useState(false);
+  const [kbInfo, setKbInfo] = useState<KnowledgeBase | null>(null);
+
+  useEffect(() => {
+    setKbId(propKbId);
+    setActiveMenu('metadata');
+    if (propKbId) {
+      loadKbInfo(propKbId);
+    } else {
+      setKbInfo(null);
+    }
+  }, [propKbId, open]);
+
+  async function loadKbInfo(id: string) {
+    try {
+      const resp = await httpClient.getKnowledgeBase(id);
+      setKbInfo(resp.base);
+    } catch (e) {
+      console.error('Failed to load KB info:', e);
+      toast.error(
+        t('knowledge.loadKnowledgeBaseFailed') + (e as CustomApiError).msg,
+      );
+    }
+  }
+
+  // Check if this KB supports document management
+  const hasDocumentCapability = (): boolean => {
+    if (!kbInfo || !kbInfo.knowledge_engine) {
+      return false;
+    }
+    return (
+      kbInfo.knowledge_engine.capabilities?.includes('doc_ingestion') ?? false
+    );
+  };
+
+  // Build menu based on KB capabilities
+  const menu = [
+    {
+      key: 'metadata',
+      label: t('knowledge.metadata'),
+      icon: (
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          viewBox="0 0 24 24"
+          fill="currentColor"
+        >
+          <path d="M5 7C5 6.17157 5.67157 5.5 6.5 5.5C7.32843 5.5 8 6.17157 8 7C8 7.82843 7.32843 8.5 6.5 8.5C5.67157 8.5 5 7.82843 5 7ZM6.5 3.5C4.567 3.5 3 5.067 3 7C3 8.933 4.567 10.5 6.5 10.5C8.433 10.5 10 8.933 10 7C10 5.067 8.433 3.5 6.5 3.5ZM12 8H20V6H12V8ZM16 17C16 16.1716 16.6716 15.5 17.5 15.5C18.3284 15.5 19 16.1716 19 17C19 17.8284 18.3284 18.5 17.5 18.5C16.6716 18.5 16 17.8284 16 17ZM17.5 13.5C15.567 13.5 14 15.067 14 17C14 18.933 15.567 20.5 17.5 20.5C19.433 20.5 21 18.933 21 17C21 15.067 19.433 13.5 17.5 13.5ZM4 16V18H12V16H4Z"></path>
+        </svg>
+      ),
+    },
+    // Show documents only if capability is present
+    ...(hasDocumentCapability()
+      ? [
+          {
+            key: 'documents',
+            label: t('knowledge.documents'),
+            icon: (
+              <svg
+                xmlns="http://www.w3.org/2000/svg"
+                viewBox="0 0 24 24"
+                fill="currentColor"
+              >
+                <path d="M21 8V20.9932C21 21.5501 20.5552 22 20.0066 22H3.9934C3.44495 22 3 21.556 3 21.0082V2.9918C3 2.45531 3.4487 2 4.00221 2H14.9968L21 8ZM19 9H14V4H5V20H19V9ZM8 7H11V9H8V7ZM8 11H16V13H8V11ZM8 15H16V17H8V15Z"></path>
+              </svg>
+            ),
+          },
+        ]
+      : []),
+    {
+      key: 'retrieve',
+      label: t('knowledge.retrieve'),
+      icon: (
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          viewBox="0 0 24 24"
+          fill="currentColor"
+        >
+          <path d="M18.031 16.617l4.283 4.282-1.415 1.415-4.282-4.283A8.96 8.96 0 0 1 11 20c-4.968 0-9-4.032-9-9s4.032-9 9-9 9 4.032 9 9a8.96 8.96 0 0 1-1.969 5.617zm-2.006-.742A6.977 6.977 0 0 0 18 11c0-3.868-3.133-7-7-7-3.868 0-7 3.132-7 7 0 3.867 3.132 7 7 7a6.977 6.977 0 0 0 4.875-1.975l.15-.15z"></path>
+        </svg>
+      ),
+    },
+  ];
+
+  const confirmDelete = async () => {
+    try {
+      await httpClient.deleteKnowledgeBase(kbId ?? '');
+      onKbDeleted();
+    } catch (e) {
+      console.error('Failed to delete KB:', e);
+      toast.error(
+        t('knowledge.deleteKnowledgeBaseFailed') + (e as CustomApiError).msg,
+      );
+    } finally {
+      setShowDeleteConfirm(false);
+    }
+  };
+
+  // Retrieve function
+  const retrieveFunction = async (id: string, query: string) => {
+    return await httpClient.retrieveKnowledgeBase(id, query);
+  };
+
+  if (!kbId) {
+    // New KB creation
+    return (
+      <Dialog open={open} onOpenChange={onOpenChange}>
+        <DialogContent className="overflow-hidden p-0 !max-w-[40vw] max-h-[70vh] flex">
+          <main className="flex flex-1 flex-col h-[70vh]">
+            <DialogHeader className="px-6 pt-6 pb-4 shrink-0">
+              <DialogTitle>{t('knowledge.createKnowledgeBase')}</DialogTitle>
+            </DialogHeader>
+            <div className="flex-1 overflow-y-auto px-6 pb-6">
+              <KBForm
+                initKbId={undefined}
+                onNewKbCreated={onNewKbCreated}
+                onKbUpdated={onKbUpdated}
+              />
+            </div>
+            <DialogFooter className="px-6 py-4 border-t shrink-0">
+              <div className="flex justify-end gap-2">
+                <Button type="submit" form="kb-form">
+                  {t('common.save')}
+                </Button>
+                <Button type="button" variant="outline" onClick={onFormCancel}>
+                  {t('common.cancel')}
+                </Button>
+              </div>
+            </DialogFooter>
+          </main>
+        </DialogContent>
+      </Dialog>
+    );
+  }
+
+  return (
+    <>
+      <Dialog open={open} onOpenChange={onOpenChange}>
+        <DialogContent className="overflow-hidden p-0 !max-w-[50rem] max-h-[75vh] flex">
+          <SidebarProvider className="items-start w-full flex">
+            <Sidebar
+              collapsible="none"
+              className="hidden md:flex h-[80vh] w-40 min-w-[120px] border-r bg-white dark:bg-black"
+            >
+              <SidebarContent>
+                <SidebarGroup>
+                  <SidebarGroupContent>
+                    <SidebarMenu>
+                      {menu.map((item) => (
+                        <SidebarMenuItem key={item.key}>
+                          <SidebarMenuButton
+                            asChild
+                            isActive={activeMenu === item.key}
+                            onClick={() => setActiveMenu(item.key)}
+                          >
+                            <a href="#">
+                              {item.icon}
+                              <span>{item.label}</span>
+                            </a>
+                          </SidebarMenuButton>
+                        </SidebarMenuItem>
+                      ))}
+                    </SidebarMenu>
+                  </SidebarGroupContent>
+                </SidebarGroup>
+              </SidebarContent>
+            </Sidebar>
+            <main className="flex flex-1 flex-col h-[75vh] min-w-0 overflow-x-hidden">
+              <DialogHeader className="px-6 pt-6 pb-4 shrink-0">
+                <DialogTitle>
+                  {activeMenu === 'metadata'
+                    ? t('knowledge.editKnowledgeBase')
+                    : activeMenu === 'documents'
+                      ? t('knowledge.editDocument')
+                      : t('knowledge.retrieveTest')}
+                </DialogTitle>
+              </DialogHeader>
+              <div className="flex-1 overflow-y-auto px-6 pb-6">
+                {activeMenu === 'metadata' && (
+                  <KBForm
+                    initKbId={kbId}
+                    onNewKbCreated={onNewKbCreated}
+                    onKbUpdated={onKbUpdated}
+                  />
+                )}
+                {activeMenu === 'documents' && hasDocumentCapability() && (
+                  <KBDoc
+                    kbId={kbId}
+                    ragEngineName={kbInfo?.knowledge_engine?.name}
+                    ragEngineCapabilities={
+                      kbInfo?.knowledge_engine?.capabilities
+                    }
+                  />
+                )}
+                {activeMenu === 'retrieve' && (
+                  <KBRetrieveGeneric
+                    kbId={kbId}
+                    retrieveFunction={retrieveFunction}
+                  />
+                )}
+              </div>
+              {activeMenu === 'metadata' && (
+                <DialogFooter className="px-6 py-4 border-t shrink-0">
+                  <div className="flex justify-end gap-2">
+                    <Button
+                      type="button"
+                      variant="destructive"
+                      onClick={() => setShowDeleteConfirm(true)}
+                    >
+                      {t('common.delete')}
+                    </Button>
+                    <Button type="submit" form="kb-form">
+                      {t('common.save')}
+                    </Button>
+                    <Button
+                      type="button"
+                      variant="outline"
+                      onClick={onFormCancel}
+                    >
+                      {t('common.cancel')}
+                    </Button>
+                  </div>
+                </DialogFooter>
+              )}
+            </main>
+          </SidebarProvider>
+        </DialogContent>
+      </Dialog>
+
+      {/* Delete confirmation dialog */}
+      <Dialog open={showDeleteConfirm} onOpenChange={setShowDeleteConfirm}>
+        <DialogContent>
+          <DialogHeader>
+            <DialogTitle>{t('common.confirmDelete')}</DialogTitle>
+          </DialogHeader>
+          <div className="py-4">
+            {t('knowledge.deleteKnowledgeBaseConfirmation')}
+          </div>
+          <DialogFooter>
+            <Button
+              variant="outline"
+              onClick={() => setShowDeleteConfirm(false)}
+            >
+              {t('common.cancel')}
+            </Button>
+            <Button variant="destructive" onClick={confirmDelete}>
+              {t('common.confirmDelete')}
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+    </>
+  );
+}

web/src/app/home/knowledge/components/kb-card/KBCard.module.css

@@ -3,7 +3,7 @@
   height: 10rem;
   background-color: #fff;
   border-radius: 10px;
-  border: 1px solid #e4e4e7;
+  box-shadow: 0px 2px 2px 0 rgba(0, 0, 0, 0.2);
   padding: 1rem;
   cursor: pointer;
   display: flex;
@@ -15,15 +15,15 @@
 
 :global(.dark) .cardContainer {
   background-color: #1f1f22;
-  border-color: #27272a;
+  box-shadow: 0;
 }
 
 .cardContainer:hover {
-  border-color: #a1a1aa;
+  box-shadow: 0px 2px 8px 0 rgba(0, 0, 0, 0.1);
 }
 
 :global(.dark) .cardContainer:hover {
-  border-color: #3f3f46;
+  box-shadow: 0;
 }
 
 .basicInfoContainer {

web/src/app/home/knowledge/components/kb-form/KBForm.tsx

@@ -1,5 +1,4 @@
-import { useEffect, useMemo, useRef, useState } from 'react';
-import Link from 'next/link';
+import { useEffect, useState } from 'react';
 import { useForm } from 'react-hook-form';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { z } from 'zod';
@@ -15,13 +14,6 @@ import {
   FormMessage,
   FormDescription,
 } from '@/components/ui/form';
-import {
-  Card,
-  CardContent,
-  CardDescription,
-  CardHeader,
-  CardTitle,
-} from '@/components/ui/card';
 import { httpClient } from '@/app/infra/http/HttpClient';
 import {
   Select,
@@ -46,7 +38,9 @@ import { UUID } from 'uuidjs';
 const getFormSchema = (t: (key: string) => string) =>
   z.object({
     name: z.string().min(1, { message: t('knowledge.kbNameRequired') }),
-    description: z.string().optional(),
+    description: z
+      .string()
+      .min(1, { message: t('knowledge.kbDescriptionRequired') }),
     emoji: z.string().optional(),
     ragEngineId: z
       .string()
@@ -55,13 +49,17 @@ const getFormSchema = (t: (key: string) => string) =>
 
 /**
  * Parse creation schema from Knowledge Engine to IDynamicFormItemSchema[]
+ * Same pattern as ExternalKBForm uses for retriever config
  */
 function parseCreationSchema(
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   schemaItems: any | any[] | undefined,
 ): IDynamicFormItemSchema[] {
   if (!schemaItems) return [];
+
+  // Handle wrapped schema (e.g. { schema: [...] }) which might be returned by the API
   const items = Array.isArray(schemaItems) ? schemaItems : schemaItems.schema;
+
   if (!items || !Array.isArray(items)) return [];
 
   return items.map(
@@ -84,12 +82,10 @@ export default function KBForm({
   initKbId,
   onNewKbCreated,
   onKbUpdated,
-  onDirtyChange,
 }: {
   initKbId?: string;
   onNewKbCreated: (kbId: string) => void;
   onKbUpdated: (kbId: string) => void;
-  onDirtyChange?: (dirty: boolean) => void;
 }) {
   const { t } = useTranslation();
   const [ragEngines, setRagEngines] = useState<KnowledgeEngine[]>([]);
@@ -103,17 +99,13 @@ export default function KBForm({
   const [isEditing, setIsEditing] = useState(false);
   const [loading, setLoading] = useState(true);
 
-  // Dirty tracking: snapshot of saved state for comparison
-  const savedSnapshotRef = useRef<string>('');
-  const isInitializing = useRef(true);
-
   const formSchema = getFormSchema(t);
 
   const form = useForm<z.infer<typeof formSchema>>({
     resolver: zodResolver(formSchema),
     defaultValues: {
       name: '',
-      description: '',
+      description: t('knowledge.defaultDescription'),
       emoji: '📚',
       ragEngineId: '',
     },
@@ -124,27 +116,6 @@ export default function KBForm({
     (e) => e.plugin_id === selectedEngineId,
   );
 
-  // Dirty tracking: compare current form + dynamic settings against saved snapshot
-  const watchedFormValues = form.watch();
-  useEffect(() => {
-    if (!savedSnapshotRef.current || isInitializing.current) return;
-    const currentSnapshot = JSON.stringify({
-      form: watchedFormValues,
-      config: configSettings,
-      retrieval: retrievalSettings,
-    });
-    const dirty = currentSnapshot !== savedSnapshotRef.current;
-    onDirtyChange?.(dirty);
-  }, [watchedFormValues, configSettings, retrievalSettings, onDirtyChange]);
-
-  const captureSnapshot = () => {
-    savedSnapshotRef.current = JSON.stringify({
-      form: form.getValues(),
-      config: configSettings,
-      retrieval: retrievalSettings,
-    });
-  };
-
   useEffect(() => {
     loadRagEngines().then(() => {
       if (initKbId) {
@@ -159,6 +130,7 @@ export default function KBForm({
       const firstEngine = ragEngines[0];
       setSelectedEngineId(firstEngine.plugin_id);
       form.setValue('ragEngineId', firstEngine.plugin_id);
+      // Initialize config settings with defaults
       const formItems = parseCreationSchema(firstEngine.creation_schema);
       if (formItems.length > 0) {
         setConfigSettings(getDefaultValues(formItems));
@@ -184,7 +156,6 @@ export default function KBForm({
 
   const loadKbConfig = async (kbId: string) => {
     try {
-      isInitializing.current = true;
       setIsEditing(true);
 
       const res = await httpClient.getKnowledgeBase(kbId);
@@ -193,24 +164,15 @@ export default function KBForm({
       const engineId = kb.knowledge_engine_plugin_id || '';
       setSelectedEngineId(engineId);
 
-      form.reset({
-        name: kb.name,
-        description: kb.description,
-        emoji: kb.emoji || '📚',
-        ragEngineId: engineId,
-      });
+      form.setValue('name', kb.name);
+      form.setValue('description', kb.description);
+      form.setValue('emoji', kb.emoji || '📚');
+      form.setValue('ragEngineId', engineId);
 
       setConfigSettings(kb.creation_settings || {});
       setRetrievalSettings(kb.retrieval_settings || {});
-
-      // Capture snapshot after a tick so dynamic forms have emitted initial values
-      setTimeout(() => {
-        captureSnapshot();
-        isInitializing.current = false;
-      }, 500);
     } catch (err) {
       console.error('Failed to load KB config:', err);
-      isInitializing.current = false;
     }
   };
 
@@ -218,6 +180,7 @@ export default function KBForm({
     setSelectedEngineId(engineId);
     form.setValue('ragEngineId', engineId);
 
+    // Find engine and initialize config settings with defaults from schema
     const engine = ragEngines.find((e) => e.plugin_id === engineId);
     if (engine) {
       const formItems = parseCreationSchema(engine.creation_schema);
@@ -238,7 +201,7 @@ export default function KBForm({
   const onSubmit = (data: z.infer<typeof formSchema>) => {
     const kbData: KnowledgeBase = {
       name: data.name,
-      description: data.description ?? '',
+      description: data.description,
       emoji: data.emoji,
       knowledge_engine_plugin_id: selectedEngineId,
       creation_settings: configSettings,
@@ -246,11 +209,10 @@ export default function KBForm({
     };
 
     if (initKbId) {
+      // Update knowledge base
       httpClient
         .updateKnowledgeBase(initKbId, kbData)
         .then((res) => {
-          captureSnapshot();
-          onDirtyChange?.(false);
           onKbUpdated(res.uuid);
           toast.success(t('knowledge.updateKnowledgeBaseSuccess'));
         })
@@ -262,6 +224,7 @@ export default function KBForm({
           );
         });
     } else {
+      // Create knowledge base
       httpClient
         .createKnowledgeBase(kbData)
         .then((res) => {
@@ -277,14 +240,12 @@ export default function KBForm({
     }
   };
 
-  const configFormItems = useMemo(
-    () => parseCreationSchema(selectedEngine?.creation_schema),
-    [selectedEngine?.creation_schema],
-  );
+  // Convert creation schema to dynamic form items (same as ExternalKBForm)
+  const configFormItems = parseCreationSchema(selectedEngine?.creation_schema);
 
-  const retrievalFormItems = useMemo(
-    () => parseCreationSchema(selectedEngine?.retrieval_schema),
-    [selectedEngine?.retrieval_schema],
+  // Convert retrieval schema to dynamic form items
+  const retrievalFormItems = parseCreationSchema(
+    selectedEngine?.retrieval_schema,
   );
 
   // Show loading state
@@ -303,32 +264,73 @@ export default function KBForm({
         <p className="text-muted-foreground">
           {t('knowledge.noEnginesAvailable')}
         </p>
-        <Link
-          href="/home/plugins"
-          className="text-sm text-primary hover:underline"
-        >
+        <p className="text-sm text-muted-foreground">
           {t('knowledge.installEngineHint')}
-        </Link>
+        </p>
       </div>
     );
   }
 
   return (
-    <Form {...form}>
-      <form
-        onSubmit={form.handleSubmit(onSubmit)}
-        id="kb-form"
-        className="space-y-6"
-      >
-        {/* Card 1: Basic Information */}
-        <Card>
-          <CardHeader>
-            <CardTitle>{t('knowledge.basicInfo')}</CardTitle>
-            <CardDescription>
-              {t('knowledge.basicInfoDescription')}
-            </CardDescription>
-          </CardHeader>
-          <CardContent className="space-y-4">
+    <>
+      <Form {...form}>
+        <form
+          onSubmit={form.handleSubmit(onSubmit)}
+          id="kb-form"
+          className="space-y-8"
+        >
+          <div className="space-y-4">
+            {/* Knowledge Engine Selector */}
+            <FormField
+              control={form.control}
+              name="ragEngineId"
+              render={({ field }) => (
+                <FormItem>
+                  <FormLabel>
+                    {t('knowledge.knowledgeEngine')}
+                    <span className="text-red-500">*</span>
+                  </FormLabel>
+                  <FormControl>
+                    <Select
+                      disabled={isEditing}
+                      onValueChange={(value) => {
+                        field.onChange(value);
+                        handleEngineChange(value);
+                      }}
+                      value={field.value}
+                    >
+                      <SelectTrigger className="w-full bg-[#ffffff] dark:bg-[#2a2a2e]">
+                        <SelectValue
+                          placeholder={t('knowledge.selectKnowledgeEngine')}
+                        />
+                      </SelectTrigger>
+                      <SelectContent className="fixed z-[1000]">
+                        {ragEngines.map((engine) => (
+                          <SelectItem
+                            key={engine.plugin_id}
+                            value={engine.plugin_id}
+                          >
+                            {extractI18nObject(engine.name)}
+                          </SelectItem>
+                        ))}
+                      </SelectContent>
+                    </Select>
+                  </FormControl>
+                  {selectedEngine?.description && (
+                    <FormDescription>
+                      {extractI18nObject(selectedEngine.description)}
+                    </FormDescription>
+                  )}
+                  {isEditing && (
+                    <FormDescription>
+                      {t('knowledge.cannotChangeKnowledgeEngine')}
+                    </FormDescription>
+                  )}
+                  <FormMessage />
+                </FormItem>
+              )}
+            />
+
             {/* Name and Emoji in same row */}
             <div className="flex gap-4 items-start">
               <FormField
@@ -338,7 +340,7 @@ export default function KBForm({
                   <FormItem className="flex-1">
                     <FormLabel>
                       {t('knowledge.kbName')}
-                      <span className="text-destructive">*</span>
+                      <span className="text-red-500">*</span>
                     </FormLabel>
                     <FormControl>
                       <Input {...field} />
@@ -371,7 +373,10 @@ export default function KBForm({
               name="description"
               render={({ field }) => (
                 <FormItem>
-                  <FormLabel>{t('knowledge.kbDescription')}</FormLabel>
+                  <FormLabel>
+                    {t('knowledge.kbDescription')}
+                    <span className="text-red-500">*</span>
+                  </FormLabel>
                   <FormControl>
                     <Input {...field} />
                   </FormControl>
@@ -380,143 +385,47 @@ export default function KBForm({
               )}
             />
 
-            {/* Knowledge Engine Selector */}
-            <FormField
-              control={form.control}
-              name="ragEngineId"
-              render={({ field }) => (
-                <FormItem>
-                  <FormLabel>
-                    {t('knowledge.knowledgeEngine')}
-                    <span className="text-destructive">*</span>
-                  </FormLabel>
-                  <FormControl>
-                    <Select
-                      disabled={isEditing}
-                      onValueChange={(value) => {
-                        field.onChange(value);
-                        handleEngineChange(value);
-                      }}
-                      value={field.value}
-                    >
-                      <SelectTrigger className="w-full bg-[#ffffff] dark:bg-[#2a2a2e]">
-                        {field.value ? (
-                          (() => {
-                            const [author, name] = field.value.split('/');
-                            const engine = ragEngines.find(
-                              (e) => e.plugin_id === field.value,
-                            );
-                            return (
-                              <div className="flex items-center gap-2">
-                                <img
-                                  src={httpClient.getPluginIconURL(
-                                    author,
-                                    name,
-                                  )}
-                                  alt=""
-                                  className="h-5 w-5 rounded"
-                                />
-                                <span>
-                                  {engine
-                                    ? extractI18nObject(engine.name)
-                                    : field.value}
-                                </span>
-                              </div>
-                            );
-                          })()
-                        ) : (
-                          <SelectValue
-                            placeholder={t('knowledge.selectKnowledgeEngine')}
-                          />
-                        )}
-                      </SelectTrigger>
-                      <SelectContent className="fixed z-[1000]">
-                        {ragEngines.map((engine) => {
-                          const [author, name] = engine.plugin_id.split('/');
-                          return (
-                            <SelectItem
-                              key={engine.plugin_id}
-                              value={engine.plugin_id}
-                            >
-                              <div className="flex items-center gap-2">
-                                <img
-                                  src={httpClient.getPluginIconURL(
-                                    author,
-                                    name,
-                                  )}
-                                  alt=""
-                                  className="h-5 w-5 rounded"
-                                />
-                                <span>{extractI18nObject(engine.name)}</span>
-                              </div>
-                            </SelectItem>
-                          );
-                        })}
-                      </SelectContent>
-                    </Select>
-                  </FormControl>
-                  {selectedEngine?.description && (
-                    <FormDescription>
-                      {extractI18nObject(selectedEngine.description)}
-                    </FormDescription>
-                  )}
-                  {isEditing && (
-                    <FormDescription>
-                      {t('knowledge.cannotChangeKnowledgeEngine')}
-                    </FormDescription>
-                  )}
-                  <FormMessage />
-                </FormItem>
-              )}
-            />
-          </CardContent>
-        </Card>
+            {/* Engine specific fields (dynamic form from creation_schema) */}
+            {configFormItems.length > 0 && (
+              <div className="space-y-4 pt-2 border-t">
+                <div className="text-sm font-medium text-muted-foreground">
+                  {t('knowledge.engineSettings')}
+                </div>
+                <div>
+                  <DynamicFormComponent
+                    itemConfigList={configFormItems}
+                    initialValues={configSettings as Record<string, object>}
+                    onSubmit={(val) =>
+                      setConfigSettings(val as Record<string, unknown>)
+                    }
+                    isEditing={isEditing}
+                    externalDependentValues={retrievalSettings}
+                  />
+                </div>
+              </div>
+            )}
 
-        {/* Card 2: Engine Settings (dynamic form from creation_schema) */}
-        {configFormItems.length > 0 && (
-          <Card>
-            <CardHeader>
-              <CardTitle>{t('knowledge.engineSettings')}</CardTitle>
-              <CardDescription>
-                {t('knowledge.engineSettingsDescription')}
-              </CardDescription>
-            </CardHeader>
-            <CardContent>
-              <DynamicFormComponent
-                itemConfigList={configFormItems}
-                initialValues={configSettings as Record<string, object>}
-                onSubmit={(val) =>
-                  setConfigSettings(val as Record<string, unknown>)
-                }
-                isEditing={isEditing}
-                externalDependentValues={retrievalSettings}
-              />
-            </CardContent>
-          </Card>
-        )}
-
-        {/* Card 3: Retrieval Settings (dynamic form from retrieval_schema) */}
-        {retrievalFormItems.length > 0 && (
-          <Card>
-            <CardHeader>
-              <CardTitle>{t('knowledge.retrievalSettings')}</CardTitle>
-              <CardDescription>
-                {t('knowledge.retrievalSettingsDescription')}
-              </CardDescription>
-            </CardHeader>
-            <CardContent>
-              <DynamicFormComponent
-                itemConfigList={retrievalFormItems}
-                initialValues={retrievalSettings as Record<string, object>}
-                onSubmit={(val) =>
-                  setRetrievalSettings(val as Record<string, unknown>)
-                }
-                externalDependentValues={configSettings}
-              />
-            </CardContent>
-          </Card>
-        )}
-      </form>
-    </Form>
+            {/* Retrieval settings (dynamic form from retrieval_schema) */}
+            {retrievalFormItems.length > 0 && (
+              <div className="space-y-4 pt-2 border-t">
+                <div className="text-sm font-medium text-muted-foreground">
+                  {t('knowledge.retrievalSettings')}
+                </div>
+                <div>
+                  <DynamicFormComponent
+                    itemConfigList={retrievalFormItems}
+                    initialValues={retrievalSettings as Record<string, object>}
+                    onSubmit={(val) =>
+                      setRetrievalSettings(val as Record<string, unknown>)
+                    }
+                    externalDependentValues={configSettings}
+                  />
+                </div>
+              </div>
+            )}
+          </div>
+        </form>
+      </Form>
+    </>
   );
 }

web/src/app/home/knowledge/knowledgeBase.module.css

@@ -5,6 +5,7 @@
 
 .knowledgeListContainer {
   width: 100%;
+  margin-top: 2rem;
   padding-left: 0.8rem;
   padding-right: 0.8rem;
   display: grid;

web/src/app/home/knowledge/page.tsx

@@ -1,25 +1,31 @@
 'use client';
 
-import { useSearchParams } from 'next/navigation';
+import CreateCardComponent from '@/app/infra/basic-component/create-card-component/CreateCardComponent';
+import styles from './knowledgeBase.module.css';
 import { useTranslation } from 'react-i18next';
 import { useEffect, useState } from 'react';
-import { httpClient } from '@/app/infra/http/HttpClient';
+import { KnowledgeBaseVO } from '@/app/home/knowledge/components/kb-card/KBCardVO';
+import KBCard from '@/app/home/knowledge/components/kb-card/KBCard';
+import KBDetailDialog from '@/app/home/knowledge/KBDetailDialog';
 import KBMigrationDialog from '@/app/home/knowledge/components/kb-migration-dialog/KBMigrationDialog';
-import { useSidebarData } from '@/app/home/components/home-sidebar/SidebarDataContext';
-import KBDetailContent from './KBDetailContent';
+import { httpClient } from '@/app/infra/http/HttpClient';
+import { KnowledgeBase } from '@/app/infra/entities/api';
 
 export default function KnowledgePage() {
   const { t } = useTranslation();
-  const searchParams = useSearchParams();
-  const detailId = searchParams.get('id');
-  const { refreshKnowledgeBases } = useSidebarData();
+  const [knowledgeBaseList, setKnowledgeBaseList] = useState<KnowledgeBaseVO[]>(
+    [],
+  );
+  const [selectedKbId, setSelectedKbId] = useState<string>('');
+  const [detailDialogOpen, setDetailDialogOpen] = useState(false);
 
-  // Migration dialog state — checked on page load regardless of detail view
+  // Migration dialog state
   const [migrationDialogOpen, setMigrationDialogOpen] = useState(false);
   const [migrationInternalCount, setMigrationInternalCount] = useState(0);
   const [migrationExternalCount, setMigrationExternalCount] = useState(0);
 
   useEffect(() => {
+    getKnowledgeBaseList();
     checkMigrationStatus();
   }, []);
 
@@ -36,27 +42,75 @@ export default function KnowledgePage() {
     }
   }
 
-  function handleMigrationComplete() {
-    refreshKnowledgeBases();
+  async function getKnowledgeBaseList() {
+    const resp = await httpClient.getKnowledgeBases();
+
+    const currentTime = new Date();
+
+    const kbs = resp.bases.map((kb: KnowledgeBase) => {
+      const lastUpdatedTimeAgo = Math.floor(
+        (currentTime.getTime() -
+          new Date(kb.updated_at ?? currentTime.getTime()).getTime()) /
+          1000 /
+          60 /
+          60 /
+          24,
+      );
+
+      const lastUpdatedTimeAgoText =
+        lastUpdatedTimeAgo > 0
+          ? ` ${lastUpdatedTimeAgo} ${t('knowledge.daysAgo')}`
+          : t('knowledge.today');
+
+      return new KnowledgeBaseVO({
+        id: kb.uuid || '',
+        name: kb.name,
+        description: kb.description,
+        emoji: kb.emoji,
+        lastUpdatedTimeAgo: lastUpdatedTimeAgoText,
+        ragEngine: kb.knowledge_engine,
+        ragEnginePluginId: kb.knowledge_engine_plugin_id,
+      });
+    });
+
+    setKnowledgeBaseList(kbs);
   }
 
-  if (detailId) {
-    return (
-      <>
-        <KBMigrationDialog
-          open={migrationDialogOpen}
-          onOpenChange={setMigrationDialogOpen}
-          internalKbCount={migrationInternalCount}
-          externalKbCount={migrationExternalCount}
-          onMigrationComplete={handleMigrationComplete}
-        />
-        <KBDetailContent id={detailId} />
-      </>
-    );
-  }
+  const handleKBCardClick = (kbId: string) => {
+    setSelectedKbId(kbId);
+    setDetailDialogOpen(true);
+  };
+
+  const handleCreateKBClick = () => {
+    setSelectedKbId('');
+    setDetailDialogOpen(true);
+  };
+
+  const handleFormCancel = () => {
+    setDetailDialogOpen(false);
+  };
+
+  const handleKbDeleted = () => {
+    getKnowledgeBaseList();
+    setDetailDialogOpen(false);
+  };
+
+  const handleNewKbCreated = (newKbId: string) => {
+    getKnowledgeBaseList();
+    setSelectedKbId(newKbId);
+    setDetailDialogOpen(true);
+  };
+
+  const handleKbUpdated = () => {
+    getKnowledgeBaseList();
+  };
+
+  const handleMigrationComplete = () => {
+    getKnowledgeBaseList();
+  };
 
   return (
-    <>
+    <div>
       <KBMigrationDialog
         open={migrationDialogOpen}
         onOpenChange={setMigrationDialogOpen}
@@ -64,9 +118,33 @@ export default function KnowledgePage() {
         externalKbCount={migrationExternalCount}
         onMigrationComplete={handleMigrationComplete}
       />
-      <div className="flex h-full items-center justify-center text-muted-foreground">
-        <p>{t('knowledge.selectFromSidebar')}</p>
+
+      <KBDetailDialog
+        open={detailDialogOpen}
+        onOpenChange={setDetailDialogOpen}
+        kbId={selectedKbId || undefined}
+        onFormCancel={handleFormCancel}
+        onKbDeleted={handleKbDeleted}
+        onNewKbCreated={handleNewKbCreated}
+        onKbUpdated={handleKbUpdated}
+      />
+
+      <div className={styles.knowledgeListContainer}>
+        <CreateCardComponent
+          width={'100%'}
+          height={'10rem'}
+          plusSize={'90px'}
+          onClick={handleCreateKBClick}
+        />
+
+        {knowledgeBaseList.map((kb) => {
+          return (
+            <div key={kb.id} onClick={() => handleKBCardClick(kb.id)}>
+              <KBCard kbCardVO={kb} />
+            </div>
+          );
+        })}
       </div>
-    </>
+    </div>
   );
 }

web/src/app/home/layout.module.css

@@ -0,0 +1,54 @@
+/* 主布局容器 */
+.homeLayoutContainer {
+  width: 100vw;
+  height: 100vh;
+  display: flex;
+  flex-direction: row;
+  background-color: #eee;
+}
+
+:global(.dark) .homeLayoutContainer {
+  background-color: #0a0a0b;
+}
+
+/* 侧边栏区域 */
+.sidebar {
+  background-color: #eee;
+}
+
+:global(.dark) .sidebar {
+  background-color: #0a0a0b;
+}
+
+/* 主内容区域 */
+.main {
+  background-color: #fafafa;
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  /* height: 100vh; */
+  width: calc(100% - 1.2rem);
+  height: calc(100% - 1.2rem);
+  overflow: hidden;
+  border-radius: 1.5rem 0 0 1.5rem;
+  margin-left: 0.6rem;
+  margin-top: 0.6rem;
+  box-shadow: 0 0 6px 0 rgba(0, 0, 0, 0.05);
+}
+
+:global(.dark) .main {
+  background-color: #151518;
+  box-shadow: 0 0 6px 0 rgba(255, 255, 255, 0.05);
+}
+
+.mainContent {
+  padding: 1.5rem;
+  padding-left: 2rem;
+  flex: 1;
+  overflow-y: auto;
+  background-color: #fafafa;
+}
+
+:global(.dark) .mainContent {
+  background-color: #151518;
+}

web/src/app/home/layout.tsx

@@ -1,6 +1,8 @@
 'use client';
 
+import styles from './layout.module.css';
 import HomeSidebar from '@/app/home/components/home-sidebar/HomeSidebar';
+import HomeTitleBar from '@/app/home/components/home-titlebar/HomeTitleBar';
 import SurveyWidget from '@/app/home/components/survey/SurveyWidget';
 import React, {
   useState,
@@ -10,46 +12,21 @@ import React, {
   Suspense,
 } from 'react';
 import { SidebarChildVO } from '@/app/home/components/home-sidebar/HomeSidebarChild';
-import {
-  SidebarDataProvider,
-  useSidebarData,
-} from '@/app/home/components/home-sidebar/SidebarDataContext';
 import { I18nObject } from '@/app/infra/entities/common';
 import { userInfo, initializeUserInfo } from '@/app/infra/http';
-import { usePathname } from 'next/navigation';
-import Link from 'next/link';
-import { extractI18nObject } from '@/i18n/I18nProvider';
-import { CircleHelp } from 'lucide-react';
-import { useTranslation } from 'react-i18next';
-import {
-  SidebarInset,
-  SidebarProvider,
-  SidebarTrigger,
-} from '@/components/ui/sidebar';
-import { Separator } from '@/components/ui/separator';
-import {
-  Breadcrumb,
-  BreadcrumbItem,
-  BreadcrumbLink,
-  BreadcrumbList,
-  BreadcrumbPage,
-  BreadcrumbSeparator,
-} from '@/components/ui/breadcrumb';
-
-// Routes that belong to the "Extensions" section
-const EXTENSIONS_ROUTES = ['/home/plugins', '/home/market', '/home/mcp'];
-
-function isExtensionsRoute(pathname: string): boolean {
-  return EXTENSIONS_ROUTES.some(
-    (route) => pathname === route || pathname.startsWith(route + '/'),
-  );
-}
 
 export default function HomeLayout({
   children,
 }: Readonly<{
   children: React.ReactNode;
 }>) {
+  const [title, setTitle] = useState<string>('');
+  const [subtitle, setSubtitle] = useState<string>('');
+  const [helpLink, setHelpLink] = useState<I18nObject>({
+    en_US: '',
+    zh_Hans: '',
+  });
+
   // Initialize user info if not already initialized
   useEffect(() => {
     if (!userInfo) {
@@ -57,96 +34,30 @@ export default function HomeLayout({
     }
   }, []);
 
-  return (
-    <SidebarDataProvider>
-      <HomeLayoutInner>{children}</HomeLayoutInner>
-    </SidebarDataProvider>
-  );
-}
-
-function HomeLayoutInner({ children }: { children: React.ReactNode }) {
-  const [title, setTitle] = useState<string>('');
-  const [helpLink, setHelpLink] = useState<I18nObject>({
-    en_US: '',
-    zh_Hans: '',
-  });
-  const { detailEntityName } = useSidebarData();
-  const pathname = usePathname();
-  const { t } = useTranslation();
-
   const onSelectedChangeAction = useCallback((child: SidebarChildVO) => {
     setTitle(child.name);
+    setSubtitle(child.description);
     setHelpLink(child.helpLink);
   }, []);
 
   // Memoize the main content area to prevent re-renders when sidebar state changes
   const mainContent = useMemo(() => children, [children]);
 
-  const resolvedHelpLink = extractI18nObject(helpLink);
-
-  // Determine breadcrumb section label and default link based on current route
-  const isExtensions = isExtensionsRoute(pathname);
-  const sectionLabel = isExtensions
-    ? t('sidebar.extensions')
-    : t('sidebar.home');
-  const sectionLink = isExtensions ? '/home/plugins' : '/home/monitoring';
-
   return (
-    <SidebarProvider>
-      <Suspense fallback={<div />}>
-        <HomeSidebar onSelectedChangeAction={onSelectedChangeAction} />
-      </Suspense>
+    <div className={styles.homeLayoutContainer}>
+      <aside className={styles.sidebar}>
+        <Suspense fallback={<div />}>
+          <HomeSidebar onSelectedChangeAction={onSelectedChangeAction} />
+        </Suspense>
+      </aside>
 
-      <SidebarInset>
-        <header className="flex h-16 shrink-0 items-center gap-2 transition-[width,height] ease-linear group-has-data-[collapsible=icon]/sidebar-wrapper:h-12">
-          <div className="flex items-center gap-2 px-4">
-            <SidebarTrigger className="-ml-1" />
-            <Separator
-              orientation="vertical"
-              className="mr-2 data-[orientation=vertical]:h-4"
-            />
-            <Breadcrumb>
-              <BreadcrumbList>
-                <BreadcrumbItem className="hidden md:block">
-                  <BreadcrumbLink asChild>
-                    <Link href={sectionLink}>{sectionLabel}</Link>
-                  </BreadcrumbLink>
-                </BreadcrumbItem>
-                <BreadcrumbSeparator className="hidden md:block" />
-                <BreadcrumbItem>
-                  <BreadcrumbPage>{title}</BreadcrumbPage>
-                </BreadcrumbItem>
-                {detailEntityName && (
-                  <>
-                    <BreadcrumbSeparator />
-                    <BreadcrumbItem>
-                      <BreadcrumbPage>{detailEntityName}</BreadcrumbPage>
-                    </BreadcrumbItem>
-                  </>
-                )}
-                {resolvedHelpLink && (
-                  <>
-                    <BreadcrumbItem>
-                      <a
-                        href={resolvedHelpLink}
-                        target="_blank"
-                        rel="noopener noreferrer"
-                        className="text-muted-foreground hover:text-foreground transition-colors"
-                      >
-                        <CircleHelp className="size-3.5" />
-                      </a>
-                    </BreadcrumbItem>
-                  </>
-                )}
-              </BreadcrumbList>
-            </Breadcrumb>
-          </div>
-        </header>
+      <div className={styles.main}>
+        <HomeTitleBar title={title} subtitle={subtitle} helpLink={helpLink} />
 
-        <div className="flex-1 overflow-hidden p-4 pt-0">{mainContent}</div>
+        <main className={styles.mainContent}>{mainContent}</main>
 
         <SurveyWidget />
-      </SidebarInset>
-    </SidebarProvider>
+      </div>
+    </div>
   );
 }

web/src/app/home/market/page.tsx

@@ -1,196 +0,0 @@
-'use client';
-
-import MarketPage from '@/app/home/plugins/components/plugin-market/PluginMarketComponent';
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-  DialogFooter,
-} from '@/components/ui/dialog';
-import { Button } from '@/components/ui/button';
-import { Download } from 'lucide-react';
-import React, { useState, useCallback } from 'react';
-import { httpClient } from '@/app/infra/http/HttpClient';
-import { systemInfo } from '@/app/infra/http/HttpClient';
-import { toast } from 'sonner';
-import { useTranslation } from 'react-i18next';
-import { PluginV4 } from '@/app/infra/entities/plugin';
-import { useSidebarData } from '@/app/home/components/home-sidebar/SidebarDataContext';
-
-enum PluginInstallStatus {
-  ASK_CONFIRM = 'ask_confirm',
-  INSTALLING = 'installing',
-  ERROR = 'error',
-}
-
-export default function MarketplacePage() {
-  const { t } = useTranslation();
-
-  if (!systemInfo?.enable_marketplace) {
-    return (
-      <div className="flex flex-col items-center justify-center h-[60vh] text-center">
-        <p className="text-muted-foreground">{t('plugins.marketplace')}</p>
-      </div>
-    );
-  }
-
-  return <MarketplaceContent />;
-}
-
-function MarketplaceContent() {
-  const { t } = useTranslation();
-  const { refreshPlugins } = useSidebarData();
-  const [modalOpen, setModalOpen] = useState(false);
-  const [installInfo, setInstallInfo] = useState<Record<string, string>>({});
-  const [pluginInstallStatus, setPluginInstallStatus] =
-    useState<PluginInstallStatus>(PluginInstallStatus.ASK_CONFIRM);
-  const [installError, setInstallError] = useState<string | null>(null);
-
-  async function checkExtensionsLimit(): Promise<boolean> {
-    const maxExtensions = systemInfo.limitation?.max_extensions ?? -1;
-    if (maxExtensions < 0) return true;
-    try {
-      const [pluginsResp, mcpResp] = await Promise.all([
-        httpClient.getPlugins(),
-        httpClient.getMCPServers(),
-      ]);
-      const total =
-        (pluginsResp.plugins?.length ?? 0) + (mcpResp.servers?.length ?? 0);
-      if (total >= maxExtensions) {
-        toast.error(
-          t('limitation.maxExtensionsReached', { max: maxExtensions }),
-        );
-        return false;
-      }
-    } catch {
-      // If we can't check, let backend handle it
-    }
-    return true;
-  }
-
-  function watchTask(taskId: number) {
-    let alreadySuccess = false;
-
-    const interval = setInterval(() => {
-      httpClient.getAsyncTask(taskId).then((resp) => {
-        if (resp.runtime.done) {
-          clearInterval(interval);
-          if (resp.runtime.exception) {
-            setInstallError(resp.runtime.exception);
-            setPluginInstallStatus(PluginInstallStatus.ERROR);
-          } else {
-            if (!alreadySuccess) {
-              toast.success(t('plugins.installSuccess'));
-              alreadySuccess = true;
-            }
-            setModalOpen(false);
-            refreshPlugins();
-          }
-        }
-      });
-    }, 1000);
-  }
-
-  const handleInstallPlugin = useCallback(
-    async (plugin: PluginV4) => {
-      if (!(await checkExtensionsLimit())) return;
-      setInstallInfo({
-        plugin_author: plugin.author,
-        plugin_name: plugin.name,
-        plugin_version: plugin.latest_version,
-      });
-      setPluginInstallStatus(PluginInstallStatus.ASK_CONFIRM);
-      setInstallError(null);
-      setModalOpen(true);
-    },
-    [t],
-  );
-
-  function handleModalConfirm() {
-    setPluginInstallStatus(PluginInstallStatus.INSTALLING);
-    httpClient
-      .installPluginFromMarketplace(
-        installInfo.plugin_author,
-        installInfo.plugin_name,
-        installInfo.plugin_version,
-      )
-      .then((resp) => {
-        const taskId = resp.task_id;
-        watchTask(taskId);
-      })
-      .catch((err) => {
-        setInstallError(err.msg);
-        setPluginInstallStatus(PluginInstallStatus.ERROR);
-      });
-  }
-
-  return (
-    <>
-      <div className="h-full overflow-y-auto">
-        <MarketPage installPlugin={handleInstallPlugin} />
-      </div>
-
-      <Dialog
-        open={modalOpen}
-        onOpenChange={(open) => {
-          setModalOpen(open);
-          if (!open) {
-            setInstallError(null);
-          }
-        }}
-      >
-        <DialogContent className="w-[500px] max-h-[80vh] p-6 bg-white dark:bg-[#1a1a1e] overflow-y-auto">
-          <DialogHeader>
-            <DialogTitle className="flex items-center gap-4">
-              <Download className="size-6" />
-              <span>{t('plugins.installPlugin')}</span>
-            </DialogTitle>
-          </DialogHeader>
-
-          {pluginInstallStatus === PluginInstallStatus.ASK_CONFIRM && (
-            <div className="mt-4">
-              <p className="mb-2">
-                {t('plugins.askConfirm', {
-                  name: installInfo.plugin_name,
-                  version: installInfo.plugin_version,
-                })}
-              </p>
-            </div>
-          )}
-
-          {pluginInstallStatus === PluginInstallStatus.INSTALLING && (
-            <div className="mt-4">
-              <p className="mb-2">{t('plugins.installing')}</p>
-            </div>
-          )}
-
-          {pluginInstallStatus === PluginInstallStatus.ERROR && (
-            <div className="mt-4">
-              <p className="mb-2">{t('plugins.installFailed')}</p>
-              <p className="mb-2 text-red-500">{installError}</p>
-            </div>
-          )}
-
-          <DialogFooter>
-            {pluginInstallStatus === PluginInstallStatus.ASK_CONFIRM && (
-              <>
-                <Button variant="outline" onClick={() => setModalOpen(false)}>
-                  {t('common.cancel')}
-                </Button>
-                <Button onClick={handleModalConfirm}>
-                  {t('common.confirm')}
-                </Button>
-              </>
-            )}
-            {pluginInstallStatus === PluginInstallStatus.ERROR && (
-              <Button variant="default" onClick={() => setModalOpen(false)}>
-                {t('common.close')}
-              </Button>
-            )}
-          </DialogFooter>
-        </DialogContent>
-      </Dialog>
-    </>
-  );
-}

web/src/app/home/mcp/MCPDetailContent.tsx

@@ -1,301 +0,0 @@
-'use client';
-
-import { useState, useEffect, useCallback, useRef } from 'react';
-import { useRouter } from 'next/navigation';
-import { Button } from '@/components/ui/button';
-import { Switch } from '@/components/ui/switch';
-import { Label } from '@/components/ui/label';
-import {
-  Card,
-  CardContent,
-  CardDescription,
-  CardHeader,
-  CardTitle,
-} from '@/components/ui/card';
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-  DialogDescription,
-  DialogFooter,
-} from '@/components/ui/dialog';
-import MCPForm from '@/app/home/mcp/components/mcp-form/MCPForm';
-import type { MCPFormHandle } from '@/app/home/mcp/components/mcp-form/MCPForm';
-import { httpClient, systemInfo } from '@/app/infra/http/HttpClient';
-import { useSidebarData } from '@/app/home/components/home-sidebar/SidebarDataContext';
-import { useTranslation } from 'react-i18next';
-import { Trash2 } from 'lucide-react';
-import { toast } from 'sonner';
-
-export default function MCPDetailContent({ id }: { id: string }) {
-  const isCreateMode = id === 'new';
-  const router = useRouter();
-  const { t } = useTranslation();
-  const { refreshMCPServers, mcpServers, setDetailEntityName } =
-    useSidebarData();
-
-  // Set breadcrumb entity name
-  useEffect(() => {
-    if (isCreateMode) {
-      setDetailEntityName(t('mcp.createServer'));
-    } else {
-      const server = mcpServers.find((s) => s.id === id);
-      setDetailEntityName(server?.name ?? id);
-    }
-    return () => setDetailEntityName(null);
-  }, [id, isCreateMode, mcpServers, setDetailEntityName, t]);
-
-  const [showDeleteConfirm, setShowDeleteConfirm] = useState(false);
-
-  // Track whether the form has unsaved changes
-  const [formDirty, setFormDirty] = useState(false);
-
-  // Ref to MCPForm for triggering test from header
-  const formRef = useRef<MCPFormHandle>(null);
-  const [mcpTesting, setMcpTesting] = useState(false);
-
-  // Enable state managed here so the header switch works
-  const [serverEnabled, setServerEnabled] = useState(true);
-  const [enableLoaded, setEnableLoaded] = useState(false);
-
-  // Fetch server enable state
-  useEffect(() => {
-    if (!isCreateMode) {
-      httpClient.getMCPServer(id).then((res) => {
-        const server = res.server ?? res;
-        setServerEnabled(server.enable ?? true);
-        setEnableLoaded(true);
-      });
-    }
-  }, [id, isCreateMode]);
-
-  const handleEnableToggle = useCallback(
-    async (checked: boolean) => {
-      const prev = serverEnabled;
-      setServerEnabled(checked);
-      try {
-        await httpClient.toggleMCPServer(id, checked);
-        refreshMCPServers();
-      } catch {
-        setServerEnabled(prev);
-        toast.error(t('mcp.modifyFailed'));
-      }
-    },
-    [id, serverEnabled, refreshMCPServers, t],
-  );
-
-  function handleFormSubmit() {
-    // Re-sync enable state after form save
-    httpClient.getMCPServer(id).then((res) => {
-      const server = res.server ?? res;
-      setServerEnabled(server.enable ?? true);
-    });
-    refreshMCPServers();
-  }
-
-  function handleServerDeleted() {
-    refreshMCPServers();
-    router.push('/home/mcp');
-  }
-
-  function handleNewServerCreated(serverName: string) {
-    refreshMCPServers();
-    router.push(`/home/mcp?id=${encodeURIComponent(serverName)}`);
-  }
-
-  function confirmDelete() {
-    httpClient
-      .deleteMCPServer(id)
-      .then(() => {
-        setShowDeleteConfirm(false);
-        toast.success(t('mcp.deleteSuccess'));
-        handleServerDeleted();
-      })
-      .catch((err) => {
-        toast.error(t('mcp.deleteFailed') + (err.msg || ''));
-      });
-  }
-
-  // Check extensions limit before creating
-  async function checkExtensionsLimit(): Promise<boolean> {
-    const maxExtensions = systemInfo.limitation?.max_extensions ?? -1;
-    if (maxExtensions < 0) return true;
-    try {
-      const [pluginsResp, mcpResp] = await Promise.all([
-        httpClient.getPlugins(),
-        httpClient.getMCPServers(),
-      ]);
-      const total =
-        (pluginsResp.plugins?.length ?? 0) + (mcpResp.servers?.length ?? 0);
-      if (total >= maxExtensions) {
-        toast.error(
-          t('limitation.maxExtensionsReached', { max: maxExtensions }),
-        );
-        return false;
-      }
-    } catch {
-      // If we can't check, let backend handle it
-    }
-    return true;
-  }
-
-  // ==================== Create Mode ====================
-  if (isCreateMode) {
-    return (
-      <div className="flex h-full flex-col">
-        {/* Header */}
-        <div className="flex items-center justify-between pb-4 shrink-0">
-          <h1 className="text-xl font-semibold">{t('mcp.createServer')}</h1>
-          <div className="flex items-center gap-2">
-            <Button
-              type="button"
-              variant="outline"
-              onClick={() => formRef.current?.testMcp()}
-              disabled={mcpTesting}
-            >
-              {t('common.test')}
-            </Button>
-            <Button
-              type="submit"
-              form="mcp-form"
-              onClick={async (e) => {
-                if (!(await checkExtensionsLimit())) {
-                  e.preventDefault();
-                }
-              }}
-            >
-              {t('common.submit')}
-            </Button>
-          </div>
-        </div>
-
-        {/* Content */}
-        <div className="flex-1 overflow-y-auto min-h-0">
-          <div className="mx-auto max-w-3xl pb-8">
-            <MCPForm
-              ref={formRef}
-              initServerName={undefined}
-              onFormSubmit={handleFormSubmit}
-              onNewServerCreated={handleNewServerCreated}
-              onTestingChange={setMcpTesting}
-            />
-          </div>
-        </div>
-      </div>
-    );
-  }
-
-  // ==================== Edit Mode ====================
-  return (
-    <>
-      <div className="flex h-full flex-col">
-        {/* Header: title + enable switch + save button */}
-        <div className="flex items-center justify-between pb-4 shrink-0">
-          <div className="flex items-center gap-4">
-            <h1 className="text-xl font-semibold">{t('mcp.editServer')}</h1>
-            {enableLoaded && (
-              <div className="flex items-center gap-2">
-                <Switch
-                  id="mcp-enable-switch"
-                  checked={serverEnabled}
-                  onCheckedChange={handleEnableToggle}
-                />
-                <Label
-                  htmlFor="mcp-enable-switch"
-                  className="text-sm text-muted-foreground cursor-pointer"
-                >
-                  {t('common.enable')}
-                </Label>
-              </div>
-            )}
-          </div>
-          <div className="flex items-center gap-2">
-            <Button
-              type="button"
-              variant="outline"
-              onClick={() => formRef.current?.testMcp()}
-              disabled={mcpTesting}
-            >
-              {t('common.test')}
-            </Button>
-            <Button type="submit" form="mcp-form" disabled={!formDirty}>
-              {t('common.save')}
-            </Button>
-          </div>
-        </div>
-
-        {/* Content */}
-        <div className="flex-1 overflow-y-auto min-h-0">
-          <div className="mx-auto max-w-3xl space-y-6 pb-8">
-            <MCPForm
-              ref={formRef}
-              initServerName={id}
-              onFormSubmit={handleFormSubmit}
-              onNewServerCreated={handleNewServerCreated}
-              onDirtyChange={setFormDirty}
-              onTestingChange={setMcpTesting}
-            />
-
-            {/* Card: Danger Zone */}
-            <Card className="border-destructive/50">
-              <CardHeader>
-                <CardTitle className="text-destructive">
-                  {t('mcp.dangerZone')}
-                </CardTitle>
-                <CardDescription>
-                  {t('mcp.dangerZoneDescription')}
-                </CardDescription>
-              </CardHeader>
-              <CardContent>
-                <div className="flex items-center justify-between">
-                  <div className="space-y-1">
-                    <p className="text-sm font-medium">
-                      {t('mcp.deleteMCPAction')}
-                    </p>
-                    <p className="text-sm text-muted-foreground">
-                      {t('mcp.deleteMCPHint')}
-                    </p>
-                  </div>
-                  <Button
-                    type="button"
-                    variant="destructive"
-                    size="sm"
-                    onClick={() => setShowDeleteConfirm(true)}
-                  >
-                    <Trash2 className="size-4 mr-1.5" />
-                    {t('common.delete')}
-                  </Button>
-                </div>
-              </CardContent>
-            </Card>
-          </div>
-        </div>
-      </div>
-
-      {/* Delete confirmation dialog */}
-      <Dialog open={showDeleteConfirm} onOpenChange={setShowDeleteConfirm}>
-        <DialogContent>
-          <DialogHeader>
-            <DialogTitle>{t('mcp.confirmDeleteTitle')}</DialogTitle>
-            <DialogDescription className="sr-only">
-              {t('mcp.confirmDeleteServer')}
-            </DialogDescription>
-          </DialogHeader>
-          <div className="py-4">{t('mcp.confirmDeleteServer')}</div>
-          <DialogFooter>
-            <Button
-              variant="outline"
-              onClick={() => setShowDeleteConfirm(false)}
-            >
-              {t('common.cancel')}
-            </Button>
-            <Button variant="destructive" onClick={confirmDelete}>
-              {t('common.confirmDelete')}
-            </Button>
-          </DialogFooter>
-        </DialogContent>
-      </Dialog>
-    </>
-  );
-}

web/src/app/home/mcp/components/mcp-form/MCPForm.tsx

@@ -1,926 +0,0 @@
-'use client';
-
-import React, {
-  useState,
-  useEffect,
-  useRef,
-  forwardRef,
-  useImperativeHandle,
-} from 'react';
-import { useTranslation } from 'react-i18next';
-import { Resolver, useForm } from 'react-hook-form';
-import { zodResolver } from '@hookform/resolvers/zod';
-import { z } from 'zod';
-import { toast } from 'sonner';
-import {
-  Card,
-  CardContent,
-  CardHeader,
-  CardTitle,
-  CardDescription,
-} from '@/components/ui/card';
-import {
-  Form,
-  FormControl,
-  FormDescription,
-  FormField,
-  FormItem,
-  FormLabel,
-  FormMessage,
-} from '@/components/ui/form';
-import {
-  Select,
-  SelectTrigger,
-  SelectValue,
-  SelectContent,
-  SelectItem,
-} from '@/components/ui/select';
-import { Input } from '@/components/ui/input';
-import { Button } from '@/components/ui/button';
-import { httpClient } from '@/app/infra/http/HttpClient';
-import {
-  MCPServerRuntimeInfo,
-  MCPTool,
-  MCPServer,
-  MCPSessionStatus,
-  MCPServerExtraArgsSSE,
-  MCPServerExtraArgsHttp,
-  MCPServerExtraArgsStdio,
-} from '@/app/infra/entities/api';
-import { CustomApiError } from '@/app/infra/entities/common';
-
-// Status display for test / connecting / error states
-function StatusDisplay({
-  testing,
-  runtimeInfo,
-  t,
-}: {
-  testing: boolean;
-  runtimeInfo: MCPServerRuntimeInfo;
-  t: (key: string) => string;
-}) {
-  if (testing) {
-    return (
-      <div className="flex items-center gap-2 text-blue-600">
-        <svg
-          className="w-5 h-5 animate-spin"
-          xmlns="http://www.w3.org/2000/svg"
-          fill="none"
-          viewBox="0 0 24 24"
-        >
-          <circle
-            className="opacity-25"
-            cx="12"
-            cy="12"
-            r="10"
-            stroke="currentColor"
-            strokeWidth="4"
-          />
-          <path
-            className="opacity-75"
-            fill="currentColor"
-            d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"
-          />
-        </svg>
-        <span className="font-medium">{t('mcp.testing')}</span>
-      </div>
-    );
-  }
-
-  if (runtimeInfo.status === MCPSessionStatus.CONNECTING) {
-    return (
-      <div className="flex items-center gap-2 text-blue-600">
-        <svg
-          className="w-5 h-5 animate-spin"
-          xmlns="http://www.w3.org/2000/svg"
-          fill="none"
-          viewBox="0 0 24 24"
-        >
-          <circle
-            className="opacity-25"
-            cx="12"
-            cy="12"
-            r="10"
-            stroke="currentColor"
-            strokeWidth="4"
-          />
-          <path
-            className="opacity-75"
-            fill="currentColor"
-            d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"
-          />
-        </svg>
-        <span className="font-medium">{t('mcp.connecting')}</span>
-      </div>
-    );
-  }
-
-  return (
-    <div className="space-y-1">
-      <div className="flex items-center gap-2 text-red-600">
-        <svg
-          className="w-5 h-5"
-          xmlns="http://www.w3.org/2000/svg"
-          fill="none"
-          viewBox="0 0 24 24"
-          stroke="currentColor"
-        >
-          <path
-            strokeLinecap="round"
-            strokeLinejoin="round"
-            strokeWidth={2}
-            d="M10 14l2-2m0 0l2-2m-2 2l-2-2m2 2l2 2m7-2a9 9 0 11-18 0 9 9 0 0118 0z"
-          />
-        </svg>
-        <span className="font-medium">{t('mcp.connectionFailed')}</span>
-      </div>
-      {runtimeInfo.error_message && (
-        <div className="text-sm text-red-500 pl-7">
-          {runtimeInfo.error_message}
-        </div>
-      )}
-    </div>
-  );
-}
-
-// Tools list component
-function ToolsList({ tools }: { tools: MCPTool[] }) {
-  return (
-    <div className="space-y-2 max-h-[300px] overflow-y-auto">
-      {tools.map((tool, index) => (
-        <Card key={index} className="py-3 shadow-none">
-          <CardHeader>
-            <CardTitle className="text-sm">{tool.name}</CardTitle>
-            {tool.description && (
-              <CardDescription className="text-xs">
-                {tool.description}
-              </CardDescription>
-            )}
-          </CardHeader>
-        </Card>
-      ))}
-    </div>
-  );
-}
-
-const getFormSchema = (t: (key: string) => string) =>
-  z
-    .object({
-      name: z
-        .string({ required_error: t('mcp.nameRequired') })
-        .min(1, { message: t('mcp.nameRequired') }),
-      mode: z.enum(['sse', 'stdio', 'http']),
-      timeout: z
-        .number({ invalid_type_error: t('mcp.timeoutMustBeNumber') })
-        .positive({ message: t('mcp.timeoutMustBePositive') })
-        .default(30),
-      ssereadtimeout: z
-        .number({ invalid_type_error: t('mcp.sseTimeoutMustBeNumber') })
-        .positive({ message: t('mcp.timeoutMustBePositive') })
-        .default(300),
-      url: z.string().optional(),
-      command: z.string().optional(),
-      args: z.array(z.object({ value: z.string() })).optional(),
-      extra_args: z
-        .array(
-          z.object({
-            key: z.string(),
-            type: z.enum(['string', 'number', 'boolean']),
-            value: z.string(),
-          }),
-        )
-        .optional(),
-    })
-    .superRefine((data, ctx) => {
-      if (data.mode === 'sse' || data.mode === 'http') {
-        if (!data.url || data.url.length === 0) {
-          ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: t('mcp.urlRequired'),
-            path: ['url'],
-          });
-        }
-      } else if (data.mode === 'stdio') {
-        if (!data.command || data.command.length === 0) {
-          ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: t('mcp.commandRequired'),
-            path: ['command'],
-          });
-        }
-      }
-    });
-
-type FormValues = z.infer<ReturnType<typeof getFormSchema>> & {
-  timeout: number;
-  ssereadtimeout: number;
-};
-
-interface MCPFormProps {
-  initServerName?: string;
-  onFormSubmit: () => void;
-  onNewServerCreated: (serverName: string) => void;
-  onDirtyChange?: (dirty: boolean) => void;
-  onTestingChange?: (testing: boolean) => void;
-}
-
-// Handle exposed to parent via ref
-export interface MCPFormHandle {
-  testMcp: () => void;
-  isTesting: boolean;
-}
-
-const MCPForm = forwardRef<MCPFormHandle, MCPFormProps>(function MCPForm(
-  {
-    initServerName,
-    onFormSubmit,
-    onNewServerCreated,
-    onDirtyChange,
-    onTestingChange,
-  },
-  ref,
-) {
-  const { t } = useTranslation();
-  const formSchema = getFormSchema(t);
-  const isEditMode = !!initServerName;
-
-  const form = useForm<FormValues>({
-    resolver: zodResolver(formSchema) as unknown as Resolver<FormValues>,
-    defaultValues: {
-      name: '',
-      mode: 'sse',
-      url: '',
-      command: '',
-      args: [],
-      timeout: 30,
-      ssereadtimeout: 300,
-      extra_args: [],
-    },
-  });
-
-  // Track whether initial data loading is complete (to avoid marking form dirty)
-  const isInitializing = useRef(true);
-
-  const [extraArgs, setExtraArgs] = useState<
-    { key: string; type: 'string' | 'number' | 'boolean'; value: string }[]
-  >([]);
-  const [stdioArgs, setStdioArgs] = useState<{ value: string }[]>([]);
-  const [mcpTesting, setMcpTesting] = useState(false);
-  const [runtimeInfo, setRuntimeInfo] = useState<MCPServerRuntimeInfo | null>(
-    null,
-  );
-  const pollingIntervalRef = useRef<NodeJS.Timeout | null>(null);
-
-  const watchMode = form.watch('mode');
-
-  // Notify parent when dirty state changes
-  const { isDirty } = form.formState;
-  useEffect(() => {
-    onDirtyChange?.(isDirty);
-  }, [isDirty, onDirtyChange]);
-
-  // Notify parent when testing state changes
-  useEffect(() => {
-    onTestingChange?.(mcpTesting);
-  }, [mcpTesting, onTestingChange]);
-
-  // Expose test action and testing state to parent
-  useImperativeHandle(
-    ref,
-    () => ({
-      testMcp: () => testMcp(),
-      isTesting: mcpTesting,
-    }),
-    [mcpTesting],
-  );
-
-  // Load server data
-  useEffect(() => {
-    isInitializing.current = true;
-    if (isEditMode && initServerName) {
-      loadServerForEdit(initServerName).finally(() => {
-        isInitializing.current = false;
-      });
-    } else {
-      form.reset({
-        name: '',
-        mode: 'sse',
-        url: '',
-        command: '',
-        args: [],
-        timeout: 30,
-        ssereadtimeout: 300,
-        extra_args: [],
-      });
-      setExtraArgs([]);
-      setStdioArgs([]);
-      setRuntimeInfo(null);
-      isInitializing.current = false;
-    }
-
-    return () => {
-      if (pollingIntervalRef.current) {
-        clearInterval(pollingIntervalRef.current);
-        pollingIntervalRef.current = null;
-      }
-    };
-  }, [initServerName]);
-
-  // Poll for updates when runtime_info status is CONNECTING
-  useEffect(() => {
-    if (
-      !isEditMode ||
-      !initServerName ||
-      !runtimeInfo ||
-      runtimeInfo.status !== MCPSessionStatus.CONNECTING
-    ) {
-      if (pollingIntervalRef.current) {
-        clearInterval(pollingIntervalRef.current);
-        pollingIntervalRef.current = null;
-      }
-      return;
-    }
-
-    if (!pollingIntervalRef.current) {
-      pollingIntervalRef.current = setInterval(() => {
-        loadServerForEdit(initServerName);
-      }, 3000);
-    }
-
-    return () => {
-      if (pollingIntervalRef.current) {
-        clearInterval(pollingIntervalRef.current);
-        pollingIntervalRef.current = null;
-      }
-    };
-  }, [isEditMode, initServerName, runtimeInfo?.status]);
-
-  async function loadServerForEdit(serverName: string) {
-    try {
-      const resp = await httpClient.getMCPServer(serverName);
-      const server = resp.server ?? resp;
-
-      const formValues: FormValues = {
-        name: server.name,
-        mode: server.mode,
-        url: '',
-        command: '',
-        args: [],
-        timeout: 30,
-        ssereadtimeout: 300,
-        extra_args: [],
-      };
-
-      let newExtraArgs: {
-        key: string;
-        type: 'string' | 'number' | 'boolean';
-        value: string;
-      }[] = [];
-      let newStdioArgs: { value: string }[] = [];
-
-      if (server.mode === 'sse' || server.mode === 'http') {
-        formValues.url = server.extra_args.url;
-        formValues.timeout = server.extra_args.timeout;
-
-        if (server.mode === 'sse') {
-          formValues.ssereadtimeout = server.extra_args.ssereadtimeout;
-        }
-
-        if (server.extra_args.headers) {
-          newExtraArgs = Object.entries(server.extra_args.headers).map(
-            ([key, value]) => ({
-              key,
-              type: 'string' as const,
-              value: String(value),
-            }),
-          );
-          formValues.extra_args = newExtraArgs;
-        }
-      } else if (server.mode === 'stdio') {
-        formValues.command = server.extra_args.command;
-        newStdioArgs = (server.extra_args.args || []).map((arg: string) => ({
-          value: arg,
-        }));
-        formValues.args = newStdioArgs;
-
-        if (server.extra_args.env) {
-          newExtraArgs = Object.entries(server.extra_args.env).map(
-            ([key, value]) => ({
-              key,
-              type: 'string' as const,
-              value: String(value),
-            }),
-          );
-          formValues.extra_args = newExtraArgs;
-        }
-      }
-
-      setExtraArgs(newExtraArgs);
-      setStdioArgs(newStdioArgs);
-
-      // Use form.reset so isDirty stays false after initial load
-      form.reset(formValues);
-
-      if (server.runtime_info) {
-        setRuntimeInfo(server.runtime_info);
-      } else {
-        setRuntimeInfo(null);
-      }
-    } catch (error) {
-      console.error('Failed to load server:', error);
-      toast.error(t('mcp.loadFailed'));
-    }
-  }
-
-  async function handleFormSubmit(value: z.infer<typeof formSchema>) {
-    try {
-      let serverConfig: MCPServer;
-
-      if (value.mode === 'sse' || value.mode === 'http') {
-        const headers: Record<string, string> = {};
-        value.extra_args?.forEach((arg) => {
-          headers[arg.key] = String(arg.value);
-        });
-
-        if (value.mode === 'sse') {
-          serverConfig = {
-            name: value.name,
-            mode: 'sse',
-            enable: true,
-            extra_args: {
-              url: value.url!,
-              headers: headers,
-              timeout: value.timeout,
-              ssereadtimeout: value.ssereadtimeout,
-            },
-          };
-        } else {
-          serverConfig = {
-            name: value.name,
-            mode: 'http',
-            enable: true,
-            extra_args: {
-              url: value.url!,
-              headers: headers,
-              timeout: value.timeout,
-            },
-          };
-        }
-      } else {
-        const env: Record<string, string> = {};
-        value.extra_args?.forEach((arg) => {
-          env[arg.key] = String(arg.value);
-        });
-        const args = value.args?.map((arg) => arg.value) || [];
-
-        serverConfig = {
-          name: value.name,
-          mode: 'stdio',
-          enable: true,
-          extra_args: {
-            command: value.command!,
-            args: args,
-            env: env,
-          },
-        };
-      }
-
-      if (isEditMode && initServerName) {
-        await httpClient.updateMCPServer(initServerName, serverConfig);
-        toast.success(t('mcp.updateSuccess'));
-        // Reset dirty baseline to current values
-        form.reset(form.getValues());
-        onFormSubmit();
-      } else {
-        await httpClient.createMCPServer(serverConfig);
-        toast.success(t('mcp.createSuccess'));
-        onNewServerCreated(value.name);
-      }
-    } catch (error) {
-      console.error('Failed to save MCP server:', error);
-      const errMsg = (error as CustomApiError).msg || '';
-      toast.error(
-        (isEditMode ? t('mcp.updateFailed') : t('mcp.createFailed')) + errMsg,
-      );
-    }
-  }
-
-  async function testMcp() {
-    setMcpTesting(true);
-
-    try {
-      const mode = form.getValues('mode');
-      let extraArgsData:
-        | MCPServerExtraArgsSSE
-        | MCPServerExtraArgsHttp
-        | MCPServerExtraArgsStdio;
-
-      if (mode === 'sse') {
-        extraArgsData = {
-          url: form.getValues('url')!,
-          timeout: form.getValues('timeout'),
-          headers: Object.fromEntries(
-            extraArgs.map((arg) => [arg.key, arg.value]),
-          ),
-          ssereadtimeout: form.getValues('ssereadtimeout'),
-        };
-      } else if (mode === 'http') {
-        extraArgsData = {
-          url: form.getValues('url')!,
-          timeout: form.getValues('timeout'),
-          headers: Object.fromEntries(
-            extraArgs.map((arg) => [arg.key, arg.value]),
-          ),
-        };
-      } else {
-        extraArgsData = {
-          command: form.getValues('command')!,
-          args: stdioArgs.map((arg) => arg.value),
-          env: Object.fromEntries(extraArgs.map((arg) => [arg.key, arg.value])),
-        };
-      }
-
-      const { task_id } = await httpClient.testMCPServer('_', {
-        name: form.getValues('name'),
-        mode: mode,
-        enable: true,
-        extra_args: extraArgsData,
-      } as MCPServer);
-
-      if (!task_id) {
-        throw new Error(t('mcp.noTaskId'));
-      }
-
-      const interval = setInterval(async () => {
-        try {
-          const taskResp = await httpClient.getAsyncTask(task_id);
-
-          if (taskResp.runtime?.done) {
-            clearInterval(interval);
-            setMcpTesting(false);
-
-            if (taskResp.runtime.exception) {
-              const errorMsg =
-                taskResp.runtime.exception || t('mcp.unknownError');
-              toast.error(`${t('mcp.testError')}: ${errorMsg}`);
-              setRuntimeInfo({
-                status: MCPSessionStatus.ERROR,
-                error_message: errorMsg,
-                tool_count: 0,
-                tools: [],
-              });
-            } else {
-              if (isEditMode) {
-                await loadServerForEdit(form.getValues('name'));
-              }
-              toast.success(t('mcp.testSuccess'));
-            }
-          }
-        } catch (err) {
-          clearInterval(interval);
-          setMcpTesting(false);
-          const errorMsg =
-            (err as CustomApiError).msg || t('mcp.getTaskFailed');
-          toast.error(`${t('mcp.testError')}: ${errorMsg}`);
-        }
-      }, 1000);
-    } catch (err) {
-      setMcpTesting(false);
-      const errorMsg = (err as Error).message || t('mcp.unknownError');
-      toast.error(`${t('mcp.testError')}: ${errorMsg}`);
-    }
-  }
-
-  const addExtraArg = () => {
-    const newArgs = [
-      ...extraArgs,
-      { key: '', type: 'string' as const, value: '' },
-    ];
-    setExtraArgs(newArgs);
-    form.setValue('extra_args', newArgs, {
-      shouldDirty: !isInitializing.current,
-    });
-  };
-
-  const removeExtraArg = (index: number) => {
-    const newArgs = extraArgs.filter((_, i) => i !== index);
-    setExtraArgs(newArgs);
-    form.setValue('extra_args', newArgs, {
-      shouldDirty: !isInitializing.current,
-    });
-  };
-
-  const updateExtraArg = (
-    index: number,
-    field: 'key' | 'type' | 'value',
-    value: string,
-  ) => {
-    const newArgs = [...extraArgs];
-    newArgs[index] = { ...newArgs[index], [field]: value };
-    setExtraArgs(newArgs);
-    form.setValue('extra_args', newArgs, {
-      shouldDirty: !isInitializing.current,
-    });
-  };
-
-  const addStdioArg = () => {
-    const newArgs = [...stdioArgs, { value: '' }];
-    setStdioArgs(newArgs);
-    form.setValue('args', newArgs, { shouldDirty: !isInitializing.current });
-  };
-
-  const removeStdioArg = (index: number) => {
-    const newArgs = stdioArgs.filter((_, i) => i !== index);
-    setStdioArgs(newArgs);
-    form.setValue('args', newArgs, { shouldDirty: !isInitializing.current });
-  };
-
-  const updateStdioArg = (index: number, value: string) => {
-    const newArgs = [...stdioArgs];
-    newArgs[index] = { value };
-    setStdioArgs(newArgs);
-    form.setValue('args', newArgs, { shouldDirty: !isInitializing.current });
-  };
-
-  return (
-    <Form {...form}>
-      <form
-        id="mcp-form"
-        onSubmit={form.handleSubmit(handleFormSubmit)}
-        className="space-y-6"
-      >
-        {/* Runtime info: status + tools (edit mode only) */}
-        {isEditMode && runtimeInfo && (
-          <Card>
-            <CardHeader>
-              <CardTitle className="text-sm">{t('mcp.title')}</CardTitle>
-            </CardHeader>
-            <CardContent className="space-y-3">
-              {(mcpTesting ||
-                runtimeInfo.status !== MCPSessionStatus.CONNECTED) && (
-                <div className="p-3 rounded-lg border">
-                  <StatusDisplay
-                    testing={mcpTesting}
-                    runtimeInfo={runtimeInfo}
-                    t={t}
-                  />
-                </div>
-              )}
-
-              {!mcpTesting &&
-                runtimeInfo.status === MCPSessionStatus.CONNECTED &&
-                runtimeInfo.tools?.length > 0 && (
-                  <>
-                    <div className="text-sm font-medium">
-                      {t('mcp.toolCount', {
-                        count: runtimeInfo.tools?.length || 0,
-                      })}
-                    </div>
-                    <ToolsList tools={runtimeInfo.tools} />
-                  </>
-                )}
-            </CardContent>
-          </Card>
-        )}
-
-        {/* Server configuration */}
-        <Card>
-          <CardHeader>
-            <CardTitle>
-              {isEditMode ? t('mcp.editServer') : t('mcp.createServer')}
-            </CardTitle>
-            <CardDescription>
-              {t('mcp.extraParametersDescription')}
-            </CardDescription>
-          </CardHeader>
-          <CardContent className="space-y-4">
-            <FormField
-              control={form.control}
-              name="name"
-              render={({ field }) => (
-                <FormItem>
-                  <FormLabel>
-                    {t('mcp.name')}
-                    <span className="text-destructive">*</span>
-                  </FormLabel>
-                  <FormControl>
-                    <Input {...field} disabled={isEditMode} />
-                  </FormControl>
-                  <FormMessage />
-                </FormItem>
-              )}
-            />
-
-            <FormField
-              control={form.control}
-              name="mode"
-              render={({ field }) => (
-                <FormItem>
-                  <FormLabel>{t('mcp.serverMode')}</FormLabel>
-                  <Select
-                    onValueChange={field.onChange}
-                    defaultValue={field.value}
-                    value={field.value}
-                  >
-                    <FormControl>
-                      <SelectTrigger>
-                        <SelectValue placeholder={t('mcp.selectMode')} />
-                      </SelectTrigger>
-                    </FormControl>
-                    <SelectContent>
-                      <SelectItem value="http">{t('mcp.http')}</SelectItem>
-                      <SelectItem value="stdio">{t('mcp.stdio')}</SelectItem>
-                      <SelectItem value="sse">{t('mcp.sse')}</SelectItem>
-                    </SelectContent>
-                  </Select>
-                  <FormMessage />
-                </FormItem>
-              )}
-            />
-
-            {(watchMode === 'sse' || watchMode === 'http') && (
-              <>
-                <FormField
-                  control={form.control}
-                  name="url"
-                  render={({ field }) => (
-                    <FormItem>
-                      <FormLabel>
-                        {t('mcp.url')}
-                        <span className="text-destructive">*</span>
-                      </FormLabel>
-                      <FormControl>
-                        <Input {...field} />
-                      </FormControl>
-                      <FormMessage />
-                    </FormItem>
-                  )}
-                />
-
-                <FormField
-                  control={form.control}
-                  name="timeout"
-                  render={({ field }) => (
-                    <FormItem>
-                      <FormLabel>{t('mcp.timeout')}</FormLabel>
-                      <FormControl>
-                        <Input
-                          type="number"
-                          placeholder={t('mcp.timeout')}
-                          {...field}
-                          onChange={(e) =>
-                            field.onChange(Number(e.target.value))
-                          }
-                        />
-                      </FormControl>
-                      <FormMessage />
-                    </FormItem>
-                  )}
-                />
-
-                {watchMode === 'sse' && (
-                  <FormField
-                    control={form.control}
-                    name="ssereadtimeout"
-                    render={({ field }) => (
-                      <FormItem>
-                        <FormLabel>{t('mcp.sseTimeout')}</FormLabel>
-                        <FormControl>
-                          <Input
-                            type="number"
-                            placeholder={t('mcp.sseTimeoutDescription')}
-                            {...field}
-                            onChange={(e) =>
-                              field.onChange(Number(e.target.value))
-                            }
-                          />
-                        </FormControl>
-                        <FormMessage />
-                      </FormItem>
-                    )}
-                  />
-                )}
-              </>
-            )}
-
-            {watchMode === 'stdio' && (
-              <>
-                <FormField
-                  control={form.control}
-                  name="command"
-                  render={({ field }) => (
-                    <FormItem>
-                      <FormLabel>
-                        {t('mcp.command')}
-                        <span className="text-destructive">*</span>
-                      </FormLabel>
-                      <FormControl>
-                        <Input {...field} />
-                      </FormControl>
-                      <FormMessage />
-                    </FormItem>
-                  )}
-                />
-
-                <FormItem>
-                  <FormLabel>{t('mcp.args')}</FormLabel>
-                  <div className="space-y-2">
-                    {stdioArgs.map((arg, index) => (
-                      <div key={index} className="flex gap-2">
-                        <Input
-                          placeholder={t('mcp.args')}
-                          value={arg.value}
-                          onChange={(e) =>
-                            updateStdioArg(index, e.target.value)
-                          }
-                        />
-                        <Button
-                          type="button"
-                          variant="ghost"
-                          size="icon"
-                          className="shrink-0 text-red-500 hover:text-red-600"
-                          onClick={() => removeStdioArg(index)}
-                        >
-                          <svg
-                            xmlns="http://www.w3.org/2000/svg"
-                            viewBox="0 0 24 24"
-                            fill="currentColor"
-                            className="w-5 h-5"
-                          >
-                            <path d="M7 4V2H17V4H22V6H20V21C20 21.5523 19.5523 22 19 22H5C4.44772 22 4 21.5523 4 21V6H2V4H7ZM6 6V20H18V6H6ZM9 9H11V17H9V9ZM13 9H15V17H13V9Z" />
-                          </svg>
-                        </Button>
-                      </div>
-                    ))}
-                    <Button
-                      type="button"
-                      variant="outline"
-                      onClick={addStdioArg}
-                    >
-                      {t('mcp.addArgument')}
-                    </Button>
-                  </div>
-                </FormItem>
-              </>
-            )}
-
-            <FormItem>
-              <FormLabel>
-                {watchMode === 'sse' || watchMode === 'http'
-                  ? t('mcp.headers')
-                  : t('mcp.env')}
-              </FormLabel>
-              <div className="space-y-2">
-                {extraArgs.map((arg, index) => (
-                  <div key={index} className="flex gap-2">
-                    <Input
-                      placeholder={t('models.keyName')}
-                      value={arg.key}
-                      onChange={(e) =>
-                        updateExtraArg(index, 'key', e.target.value)
-                      }
-                    />
-                    <Input
-                      placeholder={t('models.value')}
-                      value={arg.value}
-                      onChange={(e) =>
-                        updateExtraArg(index, 'value', e.target.value)
-                      }
-                    />
-                    <Button
-                      type="button"
-                      variant="ghost"
-                      size="icon"
-                      className="shrink-0 text-red-500 hover:text-red-600"
-                      onClick={() => removeExtraArg(index)}
-                    >
-                      <svg
-                        xmlns="http://www.w3.org/2000/svg"
-                        viewBox="0 0 24 24"
-                        fill="currentColor"
-                        className="w-5 h-5"
-                      >
-                        <path d="M7 4V2H17V4H22V6H20V21C20 21.5523 19.5523 22 19 22H5C4.44772 22 4 21.5523 4 21V6H2V4H7ZM6 6V20H18V6H6ZM9 9H11V17H9V9ZM13 9H15V17H13V9Z" />
-                      </svg>
-                    </Button>
-                  </div>
-                ))}
-                <Button type="button" variant="outline" onClick={addExtraArg}>
-                  {watchMode === 'sse' || watchMode === 'http'
-                    ? t('mcp.addHeader')
-                    : t('mcp.addEnvVar')}
-                </Button>
-              </div>
-              <FormDescription>
-                {t('mcp.extraParametersDescription')}
-              </FormDescription>
-              <FormMessage />
-            </FormItem>
-          </CardContent>
-        </Card>
-      </form>
-    </Form>
-  );
-});
-
-export default MCPForm;

web/src/app/home/mcp/page.tsx

@@ -1,21 +0,0 @@
-'use client';
-
-import { useSearchParams } from 'next/navigation';
-import { useTranslation } from 'react-i18next';
-import MCPDetailContent from './MCPDetailContent';
-
-export default function MCPPage() {
-  const { t } = useTranslation();
-  const searchParams = useSearchParams();
-  const detailId = searchParams.get('id');
-
-  if (detailId) {
-    return <MCPDetailContent id={detailId} />;
-  }
-
-  return (
-    <div className="flex h-full items-center justify-center text-muted-foreground">
-      <p>{t('mcp.selectFromSidebar')}</p>
-    </div>
-  );
-}

web/src/app/home/monitoring/components/ExportDropdown.tsx

@@ -172,7 +172,7 @@ export function ExportDropdown({ filterState }: ExportDropdownProps) {
         <Button
           variant="outline"
           size="sm"
-          className="shadow-sm flex-shrink-0"
+          className="bg-white dark:bg-[#2a2a2e] hover:bg-gray-50 dark:hover:bg-gray-800 border-gray-300 dark:border-gray-600 shadow-sm flex-shrink-0"
           disabled={exporting !== null}
         >
           {exporting ? (

web/src/app/home/monitoring/components/MessageContentRenderer.tsx

@@ -76,7 +76,7 @@ export function MessageContentRenderer({
           return (
             <span
               key={index}
-              className="inline-flex items-center px-1.5 py-0.5 mx-0.5 rounded bg-muted text-muted-foreground text-sm"
+              className="inline-flex items-center px-1.5 py-0.5 mx-0.5 rounded bg-gray-100 dark:bg-gray-800 text-gray-600 dark:text-gray-400 text-sm"
             >
               [Image]
             </span>
@@ -87,8 +87,8 @@ export function MessageContentRenderer({
           <span key={index} className="inline-block align-middle mx-1">
             <img
               src={imageUrl}
-              alt="Message attachment"
-              className="w-20 h-20 object-cover rounded cursor-pointer hover:opacity-80 transition-opacity border"
+              alt="Image"
+              className="w-20 h-20 object-cover rounded cursor-pointer hover:opacity-80 transition-opacity border border-gray-200 dark:border-gray-700"
               onClick={(e) => {
                 e.stopPropagation();
                 setPreviewImageUrl(imageUrl);
@@ -104,7 +104,7 @@ export function MessageContentRenderer({
         return (
           <span
             key={index}
-            className="inline-flex items-center px-1.5 py-0.5 mx-0.5 rounded bg-muted text-muted-foreground text-sm"
+            className="inline-flex items-center px-1.5 py-0.5 mx-0.5 rounded bg-gray-100 dark:bg-gray-800 text-gray-600 dark:text-gray-400 text-sm"
           >
             <svg
               className="w-3.5 h-3.5 mr-1"
@@ -123,7 +123,7 @@ export function MessageContentRenderer({
         return (
           <span
             key={index}
-            className="inline-flex items-center px-1.5 py-0.5 mx-0.5 rounded bg-muted text-muted-foreground text-sm"
+            className="inline-flex items-center px-1.5 py-0.5 mx-0.5 rounded bg-gray-100 dark:bg-gray-800 text-gray-600 dark:text-gray-400 text-sm"
           >
             <svg
               className="w-3.5 h-3.5 mr-1"
@@ -142,7 +142,7 @@ export function MessageContentRenderer({
         return (
           <span
             key={index}
-            className="inline-flex items-center px-1.5 py-0.5 mx-0.5 rounded bg-muted text-muted-foreground text-sm border-l-2 border-muted-foreground/50"
+            className="inline-flex items-center px-1.5 py-0.5 mx-0.5 rounded bg-gray-100 dark:bg-gray-800 text-gray-500 dark:text-gray-400 text-sm border-l-2 border-gray-400"
           >
             {quote.origin
               ?.filter((c) => (c as MessageChainComponent).type === 'Plain')
@@ -159,7 +159,7 @@ export function MessageContentRenderer({
         return (
           <span
             key={index}
-            className="inline-flex items-center px-1.5 py-0.5 mx-0.5 rounded bg-muted text-muted-foreground text-sm"
+            className="inline-flex items-center px-1.5 py-0.5 mx-0.5 rounded bg-gray-100 dark:bg-gray-800 text-gray-600 dark:text-gray-400 text-sm"
           >
             [{component.type}]
           </span>
@@ -188,7 +188,9 @@ export function MessageContentRenderer({
     // If no visible components, show placeholder
     if (visibleComponents.length === 0) {
       return (
-        <span className="text-muted-foreground italic">[Empty message]</span>
+        <span className="text-gray-400 dark:text-gray-500 italic">
+          [Empty message]
+        </span>
       );
     }
 
@@ -217,7 +219,9 @@ export function MessageContentRenderer({
     content === '""'
   ) {
     return (
-      <span className="text-muted-foreground italic">[Empty message]</span>
+      <span className="text-gray-400 dark:text-gray-500 italic">
+        [Empty message]
+      </span>
     );
   }