fix(longtext): avoid split interfering with multi-chain agent responses

Use query variable '_longtext_split_extra_chains' to pass extra split
segments instead of appending to resp_message_chain directly. This
prevents agent tool-call multi-round responses from being misidentified
as split results and sent repeatedly.

respback.py reverts to original single-chain logic and appends split
extra chains after the main response.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "langbot"
-version = "4.9.0"
+version = "4.8.7"
 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.0",
+    "pyseekdb==1.0.0b7",
+    "langbot-plugin==0.3.0rc1",
     "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.0'
+__version__ = '4.8.7'

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/knowledge/migration.py

@@ -1,372 +0,0 @@
-import asyncio
-import json
-
-import httpx
-import quart
-import sqlalchemy
-
-from ... import group
-from ......core import taskmgr
-from ......entity.persistence import metadata as persistence_metadata
-from langbot_plugin.runtime.plugin.mgr import PluginInstallSource
-
-LANGRAG_PLUGIN_AUTHOR = 'langbot-team'
-LANGRAG_PLUGIN_NAME = 'LangRAG'
-LANGRAG_PLUGIN_ID = f'{LANGRAG_PLUGIN_AUTHOR}/{LANGRAG_PLUGIN_NAME}'
-DEFAULT_SPACE_URL = 'https://space.langbot.app'
-
-# Old Retriever plugin_name -> New Connector plugin_name
-EXTERNAL_PLUGIN_NAME_MAPPING = {
-    'DifyDatasetsRetriever': 'DifyDatasetsConnector',
-    'RAGFlowRetriever': 'RAGFlowConnector',
-    'FastGPTRetriever': 'FastGPTConnector',
-}
-
-# Per-plugin: which old retriever_config fields belong to creation_settings.
-# Remaining fields go to retrieval_settings.
-# None means ALL fields go to creation_settings (no retrieval_schema).
-EXTERNAL_PLUGIN_CREATION_FIELDS: dict[str, set[str] | None] = {
-    'langbot-team/DifyDatasetsConnector': {'api_base_url', 'dify_apikey', 'dataset_id'},
-    'langbot-team/RAGFlowConnector': {'api_base_url', 'api_key', 'dataset_ids'},
-    'langbot-team/FastGPTConnector': None,  # all fields -> creation_settings
-}
-
-
-@group.group_class('knowledge/migration', '/api/v1/knowledge/migration')
-class KnowledgeMigrationRouterGroup(group.RouterGroup):
-    async def _get_migration_flag(self) -> bool:
-        """Check if rag_plugin_migration_needed flag is set."""
-        result = await self.ap.persistence_mgr.execute_async(
-            sqlalchemy.select(persistence_metadata.Metadata).where(
-                persistence_metadata.Metadata.key == 'rag_plugin_migration_needed'
-            )
-        )
-        row = result.first()
-        return row is not None and row.value == 'true'
-
-    async def _set_migration_flag(self, value: str):
-        """Set rag_plugin_migration_needed flag."""
-        await self.ap.persistence_mgr.execute_async(
-            sqlalchemy.update(persistence_metadata.Metadata)
-            .where(persistence_metadata.Metadata.key == 'rag_plugin_migration_needed')
-            .values(value=value)
-        )
-
-    async def _table_exists(self, table_name: str) -> bool:
-        """Check if a table exists."""
-        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 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 _install_plugin_from_marketplace(
-        self, plugin_id: str, task_context: taskmgr.TaskContext, space_url: str
-    ) -> None:
-        """Install a single plugin from the marketplace."""
-        p_author, p_name = plugin_id.split('/', 1)
-        self.ap.logger.info(f'RAG migration: installing plugin {plugin_id} from marketplace...')
-        task_context.trace(f'Installing plugin {plugin_id} from marketplace...')
-
-        async with httpx.AsyncClient(trust_env=True, timeout=15) as client:
-            resp = await client.get(f'{space_url}/api/v1/marketplace/plugins/{p_author}/{p_name}')
-            resp.raise_for_status()
-            p_data = resp.json().get('data', {}).get('plugin', {})
-            p_version = p_data.get('latest_version')
-            if not p_version:
-                raise Exception(f'Could not determine latest version for {plugin_id}')
-
-        await self.ap.plugin_connector.install_plugin(
-            PluginInstallSource.MARKETPLACE,
-            {
-                'plugin_author': p_author,
-                'plugin_name': p_name,
-                'plugin_version': p_version,
-            },
-            task_context=task_context,
-        )
-        self.ap.logger.info(f'RAG migration: plugin {plugin_id} install request sent.')
-
-    async def _execute_rag_migration(self, task_context: taskmgr.TaskContext, install_plugin: bool = True):
-        """Execute RAG migration: install required plugins and restore backup data."""
-        warnings = []
-
-        # Collect all plugins we need: LangRAG (always) + connector plugins (from external KBs)
-        needed_plugins: dict[str, str] = {
-            LANGRAG_PLUGIN_ID: LANGRAG_PLUGIN_NAME,
-        }
-
-        has_external = await self._table_exists('external_knowledge_bases')
-        if has_external:
-            result = await self.ap.persistence_mgr.execute_async(
-                sqlalchemy.text('SELECT DISTINCT plugin_author, plugin_name FROM external_knowledge_bases;')
-            )
-            for row in result.fetchall():
-                plugin_author = row[0] or ''
-                plugin_name = row[1] or ''
-                mapped_name = EXTERNAL_PLUGIN_NAME_MAPPING.get(plugin_name, plugin_name)
-                plugin_id = f'{plugin_author}/{mapped_name}'
-                if plugin_id not in needed_plugins:
-                    needed_plugins[plugin_id] = mapped_name
-
-        self.ap.logger.info(f'RAG migration: plugins needed: {list(needed_plugins.keys())}')
-
-        if install_plugin:
-            # Step 1: Install all required plugins from marketplace
-            task_context.trace('Installing required plugins...', action='install-plugin')
-            space_url = self.ap.instance_config.data.get('space', {}).get('url', DEFAULT_SPACE_URL).rstrip('/')
-
-            for plugin_id in needed_plugins:
-                try:
-                    await self._install_plugin_from_marketplace(plugin_id, task_context, space_url)
-                except Exception as e:
-                    self.ap.logger.warning(f'RAG migration: plugin {plugin_id} install returned: {e}')
-                    task_context.trace(f'Plugin install note ({plugin_id}): {e}')
-
-            # Step 2: Wait for all plugins to become available as knowledge engines
-            task_context.trace(
-                f'Waiting for plugins to become available: {list(needed_plugins.keys())}...',
-                action='wait-plugin',
-            )
-            max_retries = 30
-            engine_id_set: set[str] = set()
-            for i in range(max_retries):
-                try:
-                    engines = await self.ap.plugin_connector.list_knowledge_engines()
-                    engine_id_set = {e.get('plugin_id') for e in engines}
-                except Exception:
-                    pass
-                if all(pid in engine_id_set for pid in needed_plugins):
-                    self.ap.logger.info(f'RAG migration: all plugins ready: {engine_id_set}')
-                    task_context.trace('All required plugins are ready.')
-                    break
-                if i == max_retries - 1:
-                    still_missing = [pid for pid in needed_plugins if pid not in engine_id_set]
-                    warning = f'Plugin(s) {still_missing} did not become available after {max_retries} retries'
-                    self.ap.logger.warning(f'RAG migration: {warning}')
-                    warnings.append(warning)
-                    task_context.trace(warning)
-                await asyncio.sleep(2)
-        else:
-            try:
-                engines = await self.ap.plugin_connector.list_knowledge_engines()
-                engine_id_set = {e.get('plugin_id') for e in engines}
-            except Exception:
-                engine_id_set = set()
-
-        # Step 3: Restore internal knowledge bases from backup
-        task_context.trace('Restoring internal knowledge bases...', action='restore-internal')
-        if await self._table_exists('knowledge_bases_backup'):
-            result = await self.ap.persistence_mgr.execute_async(
-                sqlalchemy.text('SELECT * FROM knowledge_bases_backup;')
-            )
-            rows = result.fetchall()
-            columns = result.keys()
-
-            for row in rows:
-                row_dict = dict(zip(columns, row))
-                kb_uuid = row_dict.get('uuid')
-                name = row_dict.get('name', 'Untitled')
-                description = row_dict.get('description', '')
-                emoji = row_dict.get('emoji', '\U0001f4da')
-                embedding_model_uuid = row_dict.get('embedding_model_uuid', '')
-                top_k = row_dict.get('top_k', 5)
-                created_at = row_dict.get('created_at')
-                updated_at = row_dict.get('updated_at')
-
-                creation_settings = json.dumps({'embedding_model_uuid': embedding_model_uuid})
-                retrieval_settings = json.dumps({'top_k': top_k})
-
-                await self.ap.persistence_mgr.execute_async(
-                    sqlalchemy.text(
-                        'INSERT INTO knowledge_bases '
-                        '(uuid, name, description, emoji, created_at, updated_at, '
-                        'knowledge_engine_plugin_id, collection_id, creation_settings, retrieval_settings) '
-                        'VALUES (:uuid, :name, :description, :emoji, :created_at, :updated_at, '
-                        ':plugin_id, :collection_id, :creation_settings, :retrieval_settings);'
-                    ).bindparams(
-                        uuid=kb_uuid,
-                        name=name,
-                        description=description,
-                        emoji=emoji,
-                        created_at=created_at,
-                        updated_at=updated_at,
-                        plugin_id=LANGRAG_PLUGIN_ID,
-                        collection_id=kb_uuid,
-                        creation_settings=creation_settings,
-                        retrieval_settings=retrieval_settings,
-                    )
-                )
-
-                try:
-                    config = {'embedding_model_uuid': embedding_model_uuid}
-                    await self.ap.plugin_connector.rag_on_kb_create(LANGRAG_PLUGIN_ID, kb_uuid, config)
-                    task_context.trace(f'Restored internal KB: {name} ({kb_uuid})')
-                except Exception as e:
-                    warning = f'Failed to notify plugin for KB {name} ({kb_uuid}): {e}'
-                    warnings.append(warning)
-                    task_context.trace(warning)
-
-            await self.ap.rag_mgr.load_knowledge_bases_from_db()
-
-        # Step 4: Restore external knowledge bases
-        task_context.trace('Restoring external knowledge bases...', action='restore-external')
-        if has_external:
-            result = await self.ap.persistence_mgr.execute_async(
-                sqlalchemy.text('SELECT * FROM external_knowledge_bases;')
-            )
-            rows = result.fetchall()
-            columns = result.keys()
-
-            self.ap.logger.info(
-                f'RAG migration: {len(rows)} external KB(s) to restore. Available engines: {engine_id_set}'
-            )
-            task_context.trace(f'Found {len(rows)} external KB(s). Available engines: {engine_id_set}')
-
-            for row in rows:
-                row_dict = dict(zip(columns, row))
-                kb_uuid = row_dict.get('uuid')
-                name = row_dict.get('name', 'Untitled')
-                description = row_dict.get('description', '')
-                emoji = row_dict.get('emoji', '\U0001f517')
-                plugin_author = row_dict.get('plugin_author', '')
-                plugin_name = row_dict.get('plugin_name', '')
-                retriever_config = row_dict.get('retriever_config', {})
-                created_at = row_dict.get('created_at')
-
-                mapped_plugin_name = EXTERNAL_PLUGIN_NAME_MAPPING.get(plugin_name, plugin_name)
-                external_plugin_id = f'{plugin_author}/{mapped_plugin_name}'
-
-                self.ap.logger.info(
-                    f'RAG migration: processing external KB "{name}" ({kb_uuid}), '
-                    f'plugin: {plugin_author}/{plugin_name} -> {external_plugin_id}'
-                )
-
-                if isinstance(retriever_config, str):
-                    try:
-                        retriever_config = json.loads(retriever_config)
-                    except (json.JSONDecodeError, TypeError):
-                        retriever_config = {}
-
-                creation_fields = EXTERNAL_PLUGIN_CREATION_FIELDS.get(external_plugin_id)
-                if creation_fields is None:
-                    creation_settings_dict = retriever_config
-                    retrieval_settings_dict = {}
-                else:
-                    creation_settings_dict = {k: v for k, v in retriever_config.items() if k in creation_fields}
-                    retrieval_settings_dict = {k: v for k, v in retriever_config.items() if k not in creation_fields}
-
-                await self.ap.persistence_mgr.execute_async(
-                    sqlalchemy.text(
-                        'INSERT INTO knowledge_bases '
-                        '(uuid, name, description, emoji, created_at, updated_at, '
-                        'knowledge_engine_plugin_id, collection_id, creation_settings, retrieval_settings) '
-                        'VALUES (:uuid, :name, :description, :emoji, :created_at, :updated_at, '
-                        ':plugin_id, :collection_id, :creation_settings, :retrieval_settings);'
-                    ).bindparams(
-                        uuid=kb_uuid,
-                        name=name,
-                        description=description,
-                        emoji=emoji,
-                        created_at=created_at,
-                        updated_at=created_at,
-                        plugin_id=external_plugin_id,
-                        collection_id=kb_uuid,
-                        creation_settings=json.dumps(creation_settings_dict),
-                        retrieval_settings=json.dumps(retrieval_settings_dict),
-                    )
-                )
-
-                if external_plugin_id not in engine_id_set:
-                    warning = (
-                        f'External KB "{name}" ({kb_uuid}) record saved, but plugin {external_plugin_id} '
-                        f'is not installed yet. Install the connector plugin to use it.'
-                    )
-                    warnings.append(warning)
-                    task_context.trace(warning)
-                else:
-                    try:
-                        await self.ap.plugin_connector.rag_on_kb_create(
-                            external_plugin_id, kb_uuid, creation_settings_dict
-                        )
-                        task_context.trace(f'Restored external KB: {name} ({kb_uuid})')
-                    except Exception as e:
-                        warning = f'Failed to notify plugin for external KB {name} ({kb_uuid}): {e}'
-                        warnings.append(warning)
-                        task_context.trace(warning)
-
-            await self.ap.rag_mgr.load_knowledge_bases_from_db()
-
-        # Step 5: Clear migration flag
-        await self._set_migration_flag('false')
-        task_context.trace('RAG migration completed.', action='done')
-
-        if warnings:
-            task_context.trace(f'Completed with {len(warnings)} warning(s).')
-
-    async def initialize(self) -> None:
-        @self.route('/status', methods=['GET'], auth_type=group.AuthType.USER_TOKEN)
-        async def _() -> str:
-            needed = await self._get_migration_flag()
-
-            internal_kb_count = 0
-            external_kb_count = 0
-
-            if needed:
-                if await self._table_exists('knowledge_bases_backup'):
-                    result = await self.ap.persistence_mgr.execute_async(
-                        sqlalchemy.text('SELECT COUNT(*) FROM knowledge_bases_backup;')
-                    )
-                    internal_kb_count = result.scalar() or 0
-
-                if await self._table_exists('external_knowledge_bases'):
-                    result = await self.ap.persistence_mgr.execute_async(
-                        sqlalchemy.text('SELECT COUNT(*) FROM external_knowledge_bases;')
-                    )
-                    external_kb_count = result.scalar() or 0
-
-            return self.success(
-                data={
-                    'needed': needed,
-                    'internal_kb_count': internal_kb_count,
-                    'external_kb_count': external_kb_count,
-                }
-            )
-
-        @self.route('/execute', methods=['POST'], auth_type=group.AuthType.USER_TOKEN)
-        async def _() -> str:
-            needed = await self._get_migration_flag()
-            if not needed:
-                return self.http_status(400, -1, 'RAG migration is not needed')
-
-            data = await quart.request.get_json(silent=True) or {}
-            install_plugin = data.get('install_plugin', True)
-
-            ctx = taskmgr.TaskContext.new()
-            wrapper = self.ap.task_mgr.create_user_task(
-                self._execute_rag_migration(task_context=ctx, install_plugin=install_plugin),
-                kind='rag-migration',
-                name='rag-migration-execute',
-                label='Migrating knowledge bases to plugin architecture',
-                context=ctx,
-            )
-
-            return self.success(data={'task_id': wrapper.id})
-
-        @self.route('/dismiss', methods=['POST'], auth_type=group.AuthType.USER_TOKEN)
-        async def _() -> str:
-            needed = await self._get_migration_flag()
-            if not needed:
-                return self.http_status(400, -1, 'RAG migration is not needed')
-
-            await self._set_migration_flag('false')
-            return self.success()

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

@@ -30,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',
@@ -50,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,
@@ -154,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 = {
@@ -169,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

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/migrations/dbm020_knowledge_engine_plugin_architecture.py

@@ -1,3 +1,5 @@
+import json
+
 import sqlalchemy
 from .. import migration
 
@@ -7,22 +9,20 @@ class DBMigrateKnowledgeEnginePluginArchitecture(migration.DBMigration):
     """Migrate to unified Knowledge Engine plugin architecture.
 
     Changes:
-    - Backup existing knowledge_bases data to knowledge_bases_backup
-    - Clear knowledge_bases table and add new plugin architecture columns
-    - Drop old columns (PostgreSQL only; SQLite leaves them unmapped)
-    - Preserve external_knowledge_bases table as-is for future migration
-    - Set rag_plugin_migration_needed flag in metadata if old data exists
+    - Add knowledge_engine_plugin_id, collection_id, creation_settings, retrieval_settings columns to knowledge_bases
+    - Migrate existing top_k values into retrieval_settings JSON
+    - Migrate existing embedding_model_uuid into creation_settings JSON
+    - Drop embedding_model_uuid and top_k columns (PostgreSQL only; SQLite leaves them unmapped)
+    - Drop external_knowledge_bases table (no longer needed; external KB data is not migrated)
     """
 
     async def upgrade(self):
         """Upgrade"""
-        has_internal_data = await self._backup_knowledge_bases()
-        has_external_data = await self._check_external_knowledge_bases()
-        await self._clear_knowledge_bases()
         await self._add_columns_to_knowledge_bases()
+        await self._migrate_top_k_to_retrieval_settings()
+        await self._migrate_embedding_model_uuid_to_creation_settings()
         await self._drop_old_columns()
-        if has_internal_data or has_external_data:
-            await self._set_migration_flag()
+        await self._drop_external_knowledge_bases_table()
 
     async def _get_table_columns(self, table_name: str) -> list[str]:
         """Get column names from a table (works for both SQLite and PostgreSQL)."""
@@ -57,50 +57,6 @@ class DBMigrateKnowledgeEnginePluginArchitecture(migration.DBMigration):
             )
             return result.first() is not None
 
-    async def _backup_knowledge_bases(self) -> bool:
-        """Backup knowledge_bases data. Returns True if data was backed up."""
-        result = await self.ap.persistence_mgr.execute_async(sqlalchemy.text('SELECT COUNT(*) FROM knowledge_bases;'))
-        count = result.scalar()
-        if count == 0:
-            return False
-
-        # Drop backup table if it already exists (from a previous failed migration)
-        if await self._table_exists('knowledge_bases_backup'):
-            await self.ap.persistence_mgr.execute_async(sqlalchemy.text('DROP TABLE knowledge_bases_backup;'))
-
-        await self.ap.persistence_mgr.execute_async(
-            sqlalchemy.text('CREATE TABLE knowledge_bases_backup AS SELECT * FROM knowledge_bases;')
-        )
-        self.ap.logger.info(
-            'Backed up %d knowledge base(s) to knowledge_bases_backup table.',
-            count,
-        )
-        return True
-
-    async def _check_external_knowledge_bases(self) -> bool:
-        """Check if external_knowledge_bases table exists and has data.
-
-        The table is preserved as-is (not dropped) for future migration.
-        """
-        if not await self._table_exists('external_knowledge_bases'):
-            return False
-
-        result = await self.ap.persistence_mgr.execute_async(
-            sqlalchemy.text('SELECT COUNT(*) FROM external_knowledge_bases;')
-        )
-        count = result.scalar()
-        if count > 0:
-            self.ap.logger.info(
-                'Found %d external knowledge base(s) in external_knowledge_bases table. '
-                'Table preserved for future migration.',
-                count,
-            )
-        return count > 0
-
-    async def _clear_knowledge_bases(self):
-        """Clear all rows from knowledge_bases table (preserve table structure)."""
-        await self.ap.persistence_mgr.execute_async(sqlalchemy.text('DELETE FROM knowledge_bases;'))
-
     async def _add_columns_to_knowledge_bases(self):
         """Add new RAG plugin architecture columns to knowledge_bases table."""
         columns = await self._get_table_columns('knowledge_bases')
@@ -118,6 +74,73 @@ class DBMigrateKnowledgeEnginePluginArchitecture(migration.DBMigration):
                     sqlalchemy.text(f'ALTER TABLE knowledge_bases ADD COLUMN {col_name} {col_type};')
                 )
 
+        # For existing knowledge bases without knowledge_engine_plugin_id,
+        # set collection_id = uuid (same default as new KBs)
+        await self.ap.persistence_mgr.execute_async(
+            sqlalchemy.text('UPDATE knowledge_bases SET collection_id = uuid WHERE collection_id IS NULL;')
+        )
+
+    async def _migrate_top_k_to_retrieval_settings(self):
+        """Migrate existing top_k values into retrieval_settings JSON."""
+        columns = await self._get_table_columns('knowledge_bases')
+        if 'top_k' not in columns:
+            return
+
+        result = await self.ap.persistence_mgr.execute_async(
+            sqlalchemy.text(
+                'SELECT uuid, top_k FROM knowledge_bases WHERE top_k IS NOT NULL AND retrieval_settings IS NULL;'
+            )
+        )
+        rows = result.fetchall()
+
+        for row in rows:
+            kb_uuid = row[0]
+            top_k = row[1]
+            retrieval_settings = json.dumps({'top_k': top_k})
+            await self.ap.persistence_mgr.execute_async(
+                sqlalchemy.text('UPDATE knowledge_bases SET retrieval_settings = :rs WHERE uuid = :uuid;').bindparams(
+                    rs=retrieval_settings, uuid=kb_uuid
+                )
+            )
+
+    async def _migrate_embedding_model_uuid_to_creation_settings(self):
+        """Migrate existing embedding_model_uuid into creation_settings JSON."""
+        columns = await self._get_table_columns('knowledge_bases')
+        if 'embedding_model_uuid' not in columns:
+            return
+
+        result = await self.ap.persistence_mgr.execute_async(
+            sqlalchemy.text(
+                'SELECT uuid, embedding_model_uuid, creation_settings FROM knowledge_bases '
+                "WHERE embedding_model_uuid IS NOT NULL AND embedding_model_uuid != '';"
+            )
+        )
+        rows = result.fetchall()
+
+        for row in rows:
+            kb_uuid = row[0]
+            emb_uuid = row[1]
+            existing_settings = row[2]
+
+            if existing_settings and isinstance(existing_settings, str):
+                try:
+                    settings = json.loads(existing_settings)
+                except (json.JSONDecodeError, TypeError):
+                    settings = {}
+            elif isinstance(existing_settings, dict):
+                settings = existing_settings
+            else:
+                settings = {}
+
+            if 'embedding_model_uuid' not in settings:
+                settings['embedding_model_uuid'] = emb_uuid
+                new_settings = json.dumps(settings)
+                await self.ap.persistence_mgr.execute_async(
+                    sqlalchemy.text(
+                        'UPDATE knowledge_bases SET creation_settings = :cs WHERE uuid = :uuid;'
+                    ).bindparams(cs=new_settings, uuid=kb_uuid)
+                )
+
     async def _drop_old_columns(self):
         """Drop embedding_model_uuid and top_k columns (PostgreSQL only).
 
@@ -139,22 +162,22 @@ class DBMigrateKnowledgeEnginePluginArchitecture(migration.DBMigration):
                 sqlalchemy.text('ALTER TABLE knowledge_bases DROP COLUMN top_k;')
             )
 
-    async def _set_migration_flag(self):
-        """Set rag_plugin_migration_needed flag in metadata table."""
-        # Check if the key already exists
-        result = await self.ap.persistence_mgr.execute_async(
-            sqlalchemy.text("SELECT value FROM metadata WHERE key = 'rag_plugin_migration_needed';")
-        )
-        row = result.first()
-        if row is not None:
-            await self.ap.persistence_mgr.execute_async(
-                sqlalchemy.text("UPDATE metadata SET value = 'true' WHERE key = 'rag_plugin_migration_needed';")
+    async def _drop_external_knowledge_bases_table(self):
+        """Drop the external_knowledge_bases table if it exists."""
+        if await self._table_exists('external_knowledge_bases'):
+            # Log existing external KBs before dropping, so users are aware of data loss
+            rows = await self.ap.persistence_mgr.execute_async(
+                sqlalchemy.text('SELECT * FROM external_knowledge_bases;')
             )
-        else:
-            await self.ap.persistence_mgr.execute_async(
-                sqlalchemy.text("INSERT INTO metadata (key, value) VALUES ('rag_plugin_migration_needed', 'true');")
-            )
-        self.ap.logger.info('Set rag_plugin_migration_needed=true in metadata.')
+            existing = rows.fetchall()
+            if existing:
+                self.ap.logger.warning(
+                    'Dropping external_knowledge_bases table with %d existing record(s). '
+                    'These external KB configurations will be removed: %s',
+                    len(existing),
+                    [dict(row._mapping) for row in existing],
+                )
+            await self.ap.persistence_mgr.execute_async(sqlalchemy.text('DROP TABLE external_knowledge_bases;'))
 
     async def downgrade(self):
         """Downgrade"""

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/pipeline/config_coercion.py

@@ -1,105 +0,0 @@
-from __future__ import annotations
-
-import logging
-
-logger = logging.getLogger(__name__)
-
-# metadata type -> coercion function
-_COERCE_MAP = {
-    'integer': lambda v: int(v),
-    'number': lambda v: float(v),
-    'float': lambda v: float(v),
-}
-
-
-def _coerce_bool(v):
-    if isinstance(v, bool):
-        return v
-    if isinstance(v, str):
-        if v.lower() == 'true':
-            return True
-        if v.lower() == 'false':
-            return False
-        raise ValueError(f'Cannot convert string {v!r} to bool')
-    return bool(v)
-
-
-def _coerce_value(value, expected_type: str):
-    """Convert a single value to the expected type.
-
-    Returns the converted value, or the original value if no conversion needed.
-    """
-    if value is None:
-        return value
-
-    if expected_type == 'boolean':
-        if isinstance(value, bool):
-            return value
-        return _coerce_bool(value)
-
-    coerce_fn = _COERCE_MAP.get(expected_type)
-    if coerce_fn is None:
-        return value
-
-    # Already the correct type
-    if expected_type == 'integer' and isinstance(value, int) and not isinstance(value, bool):
-        return value
-    if expected_type in ('number', 'float') and isinstance(value, (int, float)) and not isinstance(value, bool):
-        return float(value)
-
-    return coerce_fn(value)
-
-
-def coerce_pipeline_config(
-    config: dict,
-    *metadata_list: dict,
-) -> None:
-    """Coerce pipeline config values according to metadata type definitions.
-
-    Walks each metadata dict (trigger, safety, ai, output) and converts
-    config values in-place so that strings coming from the JSON column are
-    cast to their declared types (integer, number/float, boolean).
-
-    Args:
-        config: The pipeline config dict to modify in-place.
-        *metadata_list: Metadata dicts loaded from the YAML templates.
-    """
-    for meta in metadata_list:
-        section_name = meta.get('name')
-        if not section_name or section_name not in config:
-            continue
-
-        section = config[section_name]
-        if not isinstance(section, dict):
-            continue
-
-        for stage_def in meta.get('stages', []):
-            stage_name = stage_def.get('name')
-            if not stage_name or stage_name not in section:
-                continue
-
-            stage_config = section[stage_name]
-            if not isinstance(stage_config, dict):
-                continue
-
-            for field_def in stage_def.get('config', []):
-                field_name = field_def.get('name')
-                field_type = field_def.get('type')
-                if not field_name or not field_type or field_name not in stage_config:
-                    continue
-
-                old_value = stage_config[field_name]
-                try:
-                    new_value = _coerce_value(old_value, field_type)
-                    if new_value is not old_value:
-                        stage_config[field_name] = new_value
-                except (ValueError, TypeError) as e:
-                    logger.warning(
-                        'Failed to coerce config %s.%s.%s (%r) to %s: %s',
-                        section_name,
-                        stage_name,
-                        field_name,
-                        old_value,
-                        field_type,
-                        e,
-                    )

src/langbot/pkg/pipeline/longtext/longtext.py

@@ -22,10 +22,13 @@ class LongTextProcessStage(stage.PipelineStage):
     """
 
     strategy_impl: strategy.LongTextStrategy | None
+    is_split: bool
 
     async def initialize(self, pipeline_config: dict):
         config = pipeline_config['output']['long-text-processing']
 
+        self.is_split = config['strategy'] == 'split'
+
         if config['strategy'] == 'none':
             self.strategy_impl = None
             return
@@ -90,8 +93,23 @@ class LongTextProcessStage(stage.PipelineStage):
             len(str(query.resp_message_chain[-1]))
             > query.pipeline_config['output']['long-text-processing']['threshold']
         ):
-            query.resp_message_chain[-1] = platform_message.MessageChain(
-                await self.strategy_impl.process(str(query.resp_message_chain[-1]), query)
-            )
+            if self.is_split:
+                original_text = str(query.resp_message_chain[-1])
+                threshold = query.pipeline_config['output']['long-text-processing']['threshold']
+                segments = self.strategy_impl.split_text(original_text, threshold)
+                # Replace the last chain with the first segment, store extra segments separately
+                # to avoid interfering with existing multi-chain scenarios (e.g. agent tool calls)
+                query.resp_message_chain[-1] = platform_message.MessageChain(
+                    [platform_message.Plain(text=segments[0])]
+                )
+                if len(segments) > 1:
+                    query.set_variable(
+                        '_longtext_split_extra_chains',
+                        [platform_message.MessageChain([platform_message.Plain(text=seg)]) for seg in segments[1:]],
+                    )
+            else:
+                query.resp_message_chain[-1] = platform_message.MessageChain(
+                    await self.strategy_impl.process(str(query.resp_message_chain[-1]), query)
+                )
 
         return entities.StageProcessResult(result_type=entities.ResultType.CONTINUE, new_query=query)

src/langbot/pkg/pipeline/longtext/strategies/split.py

@@ -0,0 +1,224 @@
+from __future__ import annotations
+
+import re
+
+from .. import strategy as strategy_model
+
+import langbot_plugin.api.entities.builtin.pipeline.query as pipeline_query
+import langbot_plugin.api.entities.builtin.platform.message as platform_message
+
+
+@strategy_model.strategy_class('split')
+class SplitStrategy(strategy_model.LongTextStrategy):
+    """Split long text into multiple message segments with Markdown awareness."""
+
+    async def process(self, message: str, query: pipeline_query.Query) -> list[platform_message.MessageComponent]:
+        segments = self.split_text(
+            message,
+            query.pipeline_config['output']['long-text-processing']['threshold'],
+        )
+        return [platform_message.Plain(text=segments[0])] if segments else []
+
+    def split_text(self, text: str, max_length: int) -> list[str]:
+        """Split text into segments respecting Markdown structure.
+
+        Priority:
+            1. Markdown structural boundaries (headings, code blocks, horizontal rules)
+            2. Paragraph breaks (blank lines)
+            3. List item boundaries
+            4. Line breaks
+            5. Hard cut (fallback)
+        """
+        if len(text) <= max_length:
+            return [text]
+
+        blocks = self._parse_markdown_blocks(text)
+        return self._merge_blocks(blocks, max_length)
+
+    def _parse_markdown_blocks(self, text: str) -> list[str]:
+        """Parse text into Markdown-aware blocks.
+
+        Keeps code blocks intact and splits the rest by structural elements.
+        """
+        blocks: list[str] = []
+        lines = text.split('\n')
+        current_block: list[str] = []
+        in_code_block = False
+
+        for line in lines:
+            stripped = line.strip()
+
+            # Toggle fenced code block state
+            if stripped.startswith('```'):
+                if in_code_block:
+                    # End of code block - close it as one block
+                    current_block.append(line)
+                    blocks.append('\n'.join(current_block))
+                    current_block = []
+                    in_code_block = False
+                    continue
+                else:
+                    # Start of code block - flush current block first
+                    if current_block:
+                        blocks.append('\n'.join(current_block))
+                        current_block = []
+                    current_block.append(line)
+                    in_code_block = True
+                    continue
+
+            if in_code_block:
+                current_block.append(line)
+                continue
+
+            # Heading (# ...) - start a new block
+            if re.match(r'^#{1,6}\s', stripped):
+                if current_block:
+                    blocks.append('\n'.join(current_block))
+                    current_block = []
+                current_block.append(line)
+                continue
+
+            # Horizontal rule (---, ***, ___) - start a new block
+            if re.match(r'^(-{3,}|\*{3,}|_{3,})\s*$', stripped):
+                if current_block:
+                    blocks.append('\n'.join(current_block))
+                    current_block = []
+                blocks.append(line)
+                continue
+
+            # Blank line - paragraph boundary
+            if stripped == '':
+                if current_block:
+                    current_block.append(line)
+                    blocks.append('\n'.join(current_block))
+                    current_block = []
+                continue
+
+            current_block.append(line)
+
+        # Flush remaining (including unclosed code blocks)
+        if current_block:
+            blocks.append('\n'.join(current_block))
+
+        return [b for b in blocks if b.strip()]
+
+    def _merge_blocks(self, blocks: list[str], max_length: int) -> list[str]:
+        """Merge small blocks greedily until approaching max_length.
+
+        If a single block exceeds max_length, split it by lines as fallback.
+        """
+        segments: list[str] = []
+        current = ''
+
+        for block in blocks:
+            candidate = (current + '\n\n' + block) if current else block
+
+            if len(candidate) <= max_length:
+                current = candidate
+            else:
+                # Flush current segment
+                if current:
+                    segments.append(current)
+
+                # Check if this single block fits
+                if len(block) <= max_length:
+                    current = block
+                else:
+                    # Block too large - split it by lines
+                    for part in self._split_large_block(block, max_length):
+                        segments.append(part)
+                    current = ''
+
+        if current:
+            segments.append(current)
+
+        return [s for s in segments if s.strip()]
+
+    def _split_large_block(self, block: str, max_length: int) -> list[str]:
+        """Split an oversized block by lines, preserving code block fences.
+
+        For single-line plain text (no newlines), falls back to splitting at
+        natural language boundaries (spaces, punctuation).
+        """
+        lines = block.split('\n')
+
+        # Single long line with no newlines - use plain text splitting
+        if len(lines) == 1:
+            return self._split_plain_text(block, max_length)
+
+        is_code_block = lines[0].strip().startswith('```')
+
+        segments: list[str] = []
+        current_lines: list[str] = []
+        current_len = 0
+
+        # For code blocks, track the opening fence to re-apply on continuations
+        code_fence = lines[0] if is_code_block else ''
+
+        for i, line in enumerate(lines):
+            line_len = len(line) + 1  # +1 for newline
+
+            # Single line exceeds limit on its own - split it first
+            if line_len > max_length:
+                if current_lines:
+                    seg = '\n'.join(current_lines)
+                    if is_code_block and not seg.rstrip().endswith('```'):
+                        seg += '\n```'
+                    segments.append(seg)
+                    current_lines = []
+                    current_len = 0
+
+                for part in self._split_plain_text(line, max_length):
+                    segments.append(part)
+                continue
+
+            if current_len + line_len > max_length and current_lines:
+                segment = '\n'.join(current_lines)
+                # Close code block fence if splitting mid-code-block
+                if is_code_block and not segment.rstrip().endswith('```'):
+                    segment += '\n```'
+                segments.append(segment)
+
+                current_lines = []
+                current_len = 0
+                # Re-open code block fence for continuation
+                if is_code_block and i < len(lines) - 1 and not line.strip().startswith('```'):
+                    current_lines.append(code_fence)
+                    current_len = len(code_fence) + 1
+
+            current_lines.append(line)
+            current_len += line_len
+
+        if current_lines:
+            segments.append('\n'.join(current_lines))
+
+        return segments
+
+    def _split_plain_text(self, text: str, max_length: int) -> list[str]:
+        """Split a long plain text string (no newlines) at word/space boundaries."""
+        if len(text) <= max_length:
+            return [text]
+
+        segments: list[str] = []
+        remaining = text
+
+        while remaining:
+            if len(remaining) <= max_length:
+                segments.append(remaining)
+                break
+
+            chunk = remaining[:max_length]
+            min_pos = int(max_length * 0.3)
+
+            # Try to find a space to split at
+            pos = chunk.rfind(' ')
+            if pos >= min_pos:
+                split_pos = pos
+            else:
+                # Hard cut as last resort
+                split_pos = max_length
+
+            segments.append(remaining[:split_pos].rstrip())
+            remaining = remaining[split_pos:].lstrip()
+
+        return [s for s in segments if s]

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/pipelinemgr.py

@@ -13,7 +13,6 @@ import langbot_plugin.api.entities.builtin.platform.message as platform_message
 import langbot_plugin.api.entities.builtin.platform.events as platform_events
 import langbot_plugin.api.entities.events as events
 from ..utils import importutil
-from .config_coercion import coerce_pipeline_config
 
 import langbot_plugin.api.entities.builtin.provider.session as provider_session
 import langbot_plugin.api.entities.builtin.pipeline.query as pipeline_query
@@ -421,14 +420,6 @@ class PipelineManager:
         elif isinstance(pipeline_entity, dict):
             pipeline_entity = persistence_pipeline.LegacyPipeline(**pipeline_entity)
 
-        coerce_pipeline_config(
-            pipeline_entity.config,
-            getattr(self.ap, 'pipeline_config_meta_trigger', {'name': 'trigger', 'stages': []}),
-            getattr(self.ap, 'pipeline_config_meta_safety', {'name': 'safety', 'stages': []}),
-            getattr(self.ap, 'pipeline_config_meta_ai', {'name': 'ai', 'stages': []}),
-            getattr(self.ap, 'pipeline_config_meta_output', {'name': 'output', 'stages': []}),
-        )
-
         # initialize stage containers according to pipeline_entity.stages
         stage_containers: list[StageInstContainer] = []
         for stage_name in pipeline_entity.stages:

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):

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/pipeline/respback/respback.py

@@ -55,4 +55,15 @@ class SendResponseBackStage(stage.PipelineStage):
                 quote_origin=quote_origin,
             )
 
+        # Send extra chains produced by long text split strategy
+        extra_chains = query.get_variable('_longtext_split_extra_chains')
+        if extra_chains:
+            for chain in extra_chains:
+                await query.adapter.reply_message(
+                    message_source=query.message_event,
+                    message=chain,
+                    quote_origin=False,
+                )
+            query.set_variable('_longtext_split_extra_chains', None)
+
         return entities.StageProcessResult(result_type=entities.ResultType.CONTINUE, new_query=query)

src/langbot/pkg/platform/botmgr.py

@@ -282,8 +282,6 @@ class PlatformManager:
         return runtime_bot
 
     async def get_bot_by_uuid(self, bot_uuid: str) -> RuntimeBot | None:
-        if self.websocket_proxy_bot and self.websocket_proxy_bot.bot_entity.uuid == bot_uuid:
-            return self.websocket_proxy_bot
         for bot in self.bots:
             if bot.bot_entity.uuid == bot_uuid:
                 return bot

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

@@ -37,24 +37,16 @@ class WebSocketSession:
     id: str
     message_lists: dict[str, list[WebSocketMessage]] = {}
     """消息列表 {pipeline_uuid: [messages]}"""
-    stream_message_indexes: dict[str, dict[str, int]] = {}
-    """流式消息索引 {pipeline_uuid: {resp_message_id: message_index}}"""
 
     def __init__(self, id: str):
         self.id = id
         self.message_lists = {}
-        self.stream_message_indexes = {}
 
     def get_message_list(self, pipeline_uuid: str) -> list[WebSocketMessage]:
         if pipeline_uuid not in self.message_lists:
             self.message_lists[pipeline_uuid] = []
         return self.message_lists[pipeline_uuid]
 
-    def get_stream_message_indexes(self, pipeline_uuid: str) -> dict[str, int]:
-        if pipeline_uuid not in self.stream_message_indexes:
-            self.stream_message_indexes[pipeline_uuid] = {}
-        return self.stream_message_indexes[pipeline_uuid]
-
 
 class WebSocketAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter):
     """WebSocket适配器 - 支持双向实时通信"""
@@ -97,46 +89,20 @@ class WebSocketAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter)
         target_id: str,
         message: platform_message.MessageChain,
     ) -> dict:
-        """发送消息 - 这里用于主动推送消息到前端
+        """发送消息 - 这里用于主动推送消息到前端"""
+        message_data = {
+            'type': 'bot_message',
+            'target_type': target_type,
+            'target_id': target_id,
+            'content': str(message),
+            'message_chain': [component.__dict__ for component in message],
+            'timestamp': datetime.now().isoformat(),
+        }
 
-        对于 WebSocket 适配器，我们需要将消息广播到正确的 pipeline 连接。
-        target_id 可能是 launcher_id（如 websocket_xxx）或 pipeline_uuid。
-        我们需要尝试两种方式来确保消息能够送达。
-        """
-        # 获取当前的 pipeline_uuid
-        pipeline_uuid = self.ap.platform_mgr.websocket_proxy_bot.bot_entity.use_pipeline_uuid
-        session_type = 'group' if target_type == 'group' else 'person'
+        # 推送到所有相关连接
+        await self.outbound_message_queue.put(message_data)
 
-        # 选择会话
-        session = self.websocket_group_session if session_type == 'group' else self.websocket_person_session
-
-        # 生成唯一消息ID
-        msg_id = len(session.get_message_list(pipeline_uuid)) + 1
-
-        message_data = WebSocketMessage(
-            id=msg_id,
-            role='assistant',
-            content=str(message),
-            message_chain=[component.__dict__ for component in message],
-            timestamp=datetime.now().isoformat(),
-            is_final=True,
-        )
-
-        # 保存到历史记录
-        session.get_message_list(pipeline_uuid).append(message_data)
-
-        # 直接广播到当前pipeline的连接
-        await ws_connection_manager.broadcast_to_pipeline(
-            pipeline_uuid,
-            {
-                'type': 'response',
-                'session_type': session_type,
-                'data': message_data.model_dump(),
-            },
-            session_type=session_type,
-        )
-
-        return message_data.model_dump()
+        return message_data
 
     async def reply_message(
         self,
@@ -203,16 +169,10 @@ class WebSocketAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter)
         pipeline_uuid = self.ap.platform_mgr.websocket_proxy_bot.bot_entity.use_pipeline_uuid
         session_type = 'group' if isinstance(message_source, platform_events.GroupMessage) else 'person'
         message_list = session.get_message_list(pipeline_uuid)
-        stream_message_indexes = session.get_stream_message_indexes(pipeline_uuid)
 
-        # Streaming messages in LangBot have a stable resp_message_id during the same assistant reply.
-        # Use it as the primary key to avoid overwriting an old card from a previous reply.
-        resp_message_id = str(getattr(bot_message, 'resp_message_id', '') or '')
-        existing_index = stream_message_indexes.get(resp_message_id) if resp_message_id else None
-
-        message_is_final = is_final and bot_message.tool_calls is None
-
-        if existing_index is None or existing_index >= len(message_list):
+        # 检查是否是新的流式消息（通过bot_message对象判断）
+        # 如果列表为空，或者最后一条消息已经is_final=True，则创建新消息
+        if not message_list or message_list[-1].is_final:
             # 创建新消息
             msg_id = len(message_list) + 1
             message_data = WebSocketMessage(
@@ -221,31 +181,27 @@ class WebSocketAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter)
                 content=str(message),
                 message_chain=[component.__dict__ for component in message],
                 timestamp=datetime.now().isoformat(),
-                is_final=message_is_final,
+                is_final=is_final and bot_message.tool_calls is None,
             )
 
-            # 立即添加到历史记录（即使is_final=False），以便后续块可以更新它
-            message_list.append(message_data)
-            if resp_message_id:
-                stream_message_indexes[resp_message_id] = len(message_list) - 1
+            # 只有在is_final时才保存到历史记录
+            if is_final and bot_message.tool_calls is None:
+                message_list.append(message_data)
         else:
-            # 更新同一条流式消息
-            old_message = message_list[existing_index]
-            msg_id = old_message.id
+            # 更新最后一条消息
+            msg_id = message_list[-1].id
             message_data = WebSocketMessage(
                 id=msg_id,
                 role='assistant',
                 content=str(message),
                 message_chain=[component.__dict__ for component in message],
-                timestamp=old_message.timestamp,  # 保持原始时间戳
-                is_final=message_is_final,
+                timestamp=message_list[-1].timestamp,  # 保持原始时间戳
+                is_final=is_final and bot_message.tool_calls is None,
             )
 
-            # 更新历史记录中的对应消息
-            message_list[existing_index] = message_data
-
-        if message_is_final and resp_message_id:
-            stream_message_indexes.pop(resp_message_id, None)
+            # 如果是final，更新历史记录中的最后一条
+            if is_final and bot_message.tool_calls is None:
+                message_list[-1] = message_data
 
         # 直接广播到所有该pipeline的连接，包含session_type信息
         await ws_connection_manager.broadcast_to_pipeline(
@@ -454,10 +410,6 @@ class WebSocketAdapter(abstract_platform_adapter.AbstractMessagePlatformAdapter)
         if session_type == 'person':
             if pipeline_uuid in self.websocket_person_session.message_lists:
                 self.websocket_person_session.message_lists[pipeline_uuid] = []
-            if pipeline_uuid in self.websocket_person_session.stream_message_indexes:
-                self.websocket_person_session.stream_message_indexes[pipeline_uuid] = {}
         else:
             if pipeline_uuid in self.websocket_group_session.message_lists:
                 self.websocket_group_session.message_lists[pipeline_uuid] = []
-            if pipeline_uuid in self.websocket_group_session.stream_message_indexes:
-                self.websocket_group_session.stream_message_indexes[pipeline_uuid] = {}

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

@@ -337,14 +337,7 @@ class RuntimeConnectionHandler(handler.Handler):
                 )
 
             messages_obj = [provider_message.Message.model_validate(message) for message in messages]
-
-            # The func field is excluded during model_dump() in plugin side (marked as exclude=True),
-            # but it's a required field for LLMTool validation. We need to provide a placeholder
-            # function when reconstructing the LLMTool objects from serialized data.
-            async def _placeholder_func(**kwargs):
-                pass
-
-            funcs_obj = [resource_tool.LLMTool.model_validate({**func, 'func': _placeholder_func}) for func in funcs]
+            funcs_obj = [resource_tool.LLMTool.model_validate(func) for func in funcs]
 
             result = await llm_model.provider.invoke_llm(
                 query=None,

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

@@ -2,10 +2,8 @@ from __future__ import annotations
 
 import json
 import copy
-import asyncio
 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
@@ -28,109 +26,19 @@ 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 (new field)
@@ -166,13 +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={
-                        '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)
@@ -211,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:
@@ -267,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,
@@ -293,40 +198,30 @@ 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:
-            # Execute all tool calls in parallel (they are independent within the same batch)
-            async def _execute_single_tool(tc):
-                """Execute a single tool call and return (tool_call, content, error)."""
+            for tool_call in pending_tool_calls:
                 try:
-                    func = tc.function
-                    parameters = json.loads(func.arguments) if func.arguments else {}
+                    func = tool_call.function
+
+                    if func.arguments:
+                        parameters = json.loads(func.arguments)
+                    else:
+                        parameters = {}
+
                     func_ret = await self.ap.tool_mgr.execute_func_call(func.name, parameters, query=query)
 
                     # Handle return value content
+                    tool_content = None
                     if (
                         isinstance(func_ret, list)
                         and len(func_ret) > 0
                         and isinstance(func_ret[0], provider_message.ContentElement)
                     ):
-                        return tc, func_ret, None
+                        tool_content = func_ret
                     else:
-                        return tc, json.dumps(func_ret, ensure_ascii=False), None
-                except Exception as e:
-                    return tc, None, e
+                        tool_content = json.dumps(func_ret, ensure_ascii=False)
 
-            tool_results = await asyncio.gather(*[_execute_single_tool(tc) for tc in pending_tool_calls])
-
-            # Yield results in order and append to messages
-            for tool_call, tool_content, tool_error in tool_results:
-                if tool_error is not None:
-                    err_msg = provider_message.Message(
-                        role='tool', content=f'err: {tool_error}', tool_call_id=tool_call.id
-                    )
-                    yield err_msg
-                    req_messages.append(err_msg)
-                else:
                     if is_stream:
                         msg = provider_message.MessageChunk(
                             role='tool',
@@ -339,42 +234,52 @@ class LocalAgentRunner(runner.RequestRunner):
                             content=tool_content,
                             tool_call_id=tool_call.id,
                         )
+
                     yield msg
+
                     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
+
+                    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:
@@ -386,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,
@@ -405,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/utils/constants.py

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

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,
@@ -54,23 +47,6 @@ class ChromaVectorDatabase(VectorDatabase):
         filter: dict[str, Any] | 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)
-
-        # 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,
@@ -79,137 +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,
-    ) -> 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
-        fused = self._rrf_fuse([vector_ids, text_ids], k)
-        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) -> 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.
-        """
-        scores: dict[str, float] = {}
-        for ranked_ids in result_lists:
-            for rank, doc_id in enumerate(ranked_ids):
-                scores[doc_id] = scores.get(doc_id, 0.0) + 1.0 / (_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})

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

@@ -95,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

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

@@ -37,6 +37,10 @@ stages:
             label:
               en_US: Convert to Image
               zh_Hans: 转换为图片
+          - name: split
+            label:
+              en_US: Split into Multiple Messages
+              zh_Hans: 分割为多条消息发送
           - name: none
             label:
               en_US: None
@@ -78,39 +82,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 +123,3 @@ stages:
         type: boolean
         required: true
         default: false
-

tests/unit_tests/pipeline/test_config_coercion.py

@@ -1,113 +0,0 @@
-"""Unit tests for config_coercion module"""
-
-from __future__ import annotations
-
-import pytest
-
-from langbot.pkg.pipeline.config_coercion import _coerce_value, coerce_pipeline_config
-
-
-class TestCoerceValue:
-    """Tests for _coerce_value function"""
-
-    def test_none_passthrough(self):
-        assert _coerce_value(None, 'integer') is None
-        assert _coerce_value(None, 'boolean') is None
-
-    def test_string_to_integer(self):
-        assert _coerce_value('120', 'integer') == 120
-        assert _coerce_value('0', 'integer') == 0
-        assert _coerce_value('-5', 'integer') == -5
-
-    def test_integer_passthrough(self):
-        assert _coerce_value(42, 'integer') == 42
-
-    def test_string_to_float(self):
-        assert _coerce_value('3.14', 'number') == 3.14
-        assert _coerce_value('3.14', 'float') == 3.14
-
-    def test_int_to_float(self):
-        assert _coerce_value(3, 'number') == 3.0
-        assert isinstance(_coerce_value(3, 'number'), float)
-
-    def test_float_passthrough(self):
-        assert _coerce_value(3.14, 'float') == 3.14
-
-    def test_string_to_bool(self):
-        assert _coerce_value('true', 'boolean') is True
-        assert _coerce_value('True', 'boolean') is True
-        assert _coerce_value('false', 'boolean') is False
-        assert _coerce_value('False', 'boolean') is False
-
-    def test_bool_passthrough(self):
-        assert _coerce_value(True, 'boolean') is True
-        assert _coerce_value(False, 'boolean') is False
-
-    def test_invalid_bool_string_raises(self):
-        with pytest.raises(ValueError):
-            _coerce_value('notabool', 'boolean')
-
-    def test_unknown_type_passthrough(self):
-        assert _coerce_value('hello', 'string') == 'hello'
-        assert _coerce_value('hello', 'unknown') == 'hello'
-
-    def test_invalid_integer_raises(self):
-        with pytest.raises(ValueError):
-            _coerce_value('abc', 'integer')
-
-
-class TestCoercePipelineConfig:
-    """Tests for coerce_pipeline_config function"""
-
-    def _make_meta(self, section_name: str, stage_name: str, fields: list[dict]) -> dict:
-        return {
-            'name': section_name,
-            'stages': [{'name': stage_name, 'config': fields}],
-        }
-
-    def test_coerce_integer_in_config(self):
-        config = {'trigger': {'misc': {'timeout': '120'}}}
-        meta = self._make_meta('trigger', 'misc', [{'name': 'timeout', 'type': 'integer'}])
-        coerce_pipeline_config(config, meta)
-        assert config['trigger']['misc']['timeout'] == 120
-
-    def test_coerce_boolean_in_config(self):
-        config = {'output': {'misc': {'at-sender': 'true'}}}
-        meta = self._make_meta('output', 'misc', [{'name': 'at-sender', 'type': 'boolean'}])
-        coerce_pipeline_config(config, meta)
-        assert config['output']['misc']['at-sender'] is True
-
-    def test_missing_section_skipped(self):
-        config = {'ai': {}}
-        meta = self._make_meta('trigger', 'misc', [{'name': 'x', 'type': 'integer'}])
-        coerce_pipeline_config(config, meta)  # should not raise
-
-    def test_missing_field_skipped(self):
-        config = {'trigger': {'misc': {}}}
-        meta = self._make_meta('trigger', 'misc', [{'name': 'nonexistent', 'type': 'integer'}])
-        coerce_pipeline_config(config, meta)  # should not raise
-
-    def test_invalid_value_logs_warning(self, caplog):
-        config = {'trigger': {'misc': {'timeout': 'abc'}}}
-        meta = self._make_meta('trigger', 'misc', [{'name': 'timeout', 'type': 'integer'}])
-        import logging
-
-        with caplog.at_level(logging.WARNING):
-            coerce_pipeline_config(config, meta)
-        assert config['trigger']['misc']['timeout'] == 'abc'  # unchanged
-        assert 'Failed to coerce' in caplog.text
-
-    def test_empty_metadata(self):
-        config = {'trigger': {'misc': {'timeout': '120'}}}
-        coerce_pipeline_config(config)  # no metadata args, should not raise
-
-    def test_multiple_metadata(self):
-        config = {
-            'trigger': {'misc': {'timeout': '120'}},
-            'output': {'misc': {'at-sender': 'false'}},
-        }
-        meta_trigger = self._make_meta('trigger', 'misc', [{'name': 'timeout', 'type': 'integer'}])
-        meta_output = self._make_meta('output', 'misc', [{'name': 'at-sender', 'type': 'boolean'}])
-        coerce_pipeline_config(config, meta_trigger, meta_output)
-        assert config['trigger']['misc']['timeout'] == 120
-        assert config['output']['misc']['at-sender'] is False

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

@@ -124,6 +124,12 @@ export default function BotForm({
   const currentAdapter = form.watch('adapter');
   const currentAdapterConfig = form.watch('adapter_config');
 
+  // 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();
   }, []);
@@ -147,7 +153,7 @@ export default function BotForm({
       // For non-Lark adapters, show all fields
       setFilteredDynamicFormConfigList(dynamicFormConfigList);
     }
-  }, [currentAdapter, currentAdapterConfig, dynamicFormConfigList]);
+  }, [currentAdapter, adapterConfigJson, dynamicFormConfigList]);
 
   // 复制到剪贴板的辅助函数 - 使用页面上的真实input元素
   const copyToClipboard = () => {

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

@@ -6,7 +6,6 @@ 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,
@@ -28,7 +27,6 @@ interface SessionInfo {
   is_active: boolean;
   platform?: string | null;
   user_id?: string | null;
-  user_name?: string | null;
 }
 
 interface SessionMessage {
@@ -62,29 +60,8 @@ export default function BotSessionMonitor({ botId }: BotSessionMonitorProps) {
   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 {
@@ -361,36 +338,24 @@ export default function BotSessionMonitor({ botId }: BotSessionMonitorProps) {
                   >
                     <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>
                 );
@@ -412,42 +377,15 @@ export default function BotSessionMonitor({ botId }: BotSessionMonitorProps) {
             <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-2 text-xs text-muted-foreground">
-                  {parseSessionType(selectedSessionId) && (
-                    <span>{parseSessionType(selectedSessionId)}</span>
-                  )}
                   {selectedSession?.platform && (
-                    <>
-                      {parseSessionType(selectedSessionId) && <span>·</span>}
-                      <span>{selectedSession.platform}</span>
-                    </>
-                  )}
-                  {selectedSession?.user_id && (
-                    <>
-                      <span>·</span>
-                      <span className="font-mono">
-                        {selectedSession.user_id}
-                      </span>
-                      <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>
                     </>
                   )}

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

@@ -11,7 +11,7 @@ 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';
 
@@ -73,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({
@@ -166,34 +160,39 @@ 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]);
+
+  // 监听表单值变化
+  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);
+      emitValues();
     });
     return () => subscription.unsubscribe();
-  }, [form, itemConfigList]);
+  }, [form, itemConfigList, emitValues]);
 
   return (
     <Form {...form}>
@@ -232,7 +231,6 @@ export default function DynamicFormComponent({
 
           // All fields are disabled when editing (creation_settings are immutable)
           const isFieldDisabled = !!isEditing;
-
           return (
             <FormField
               key={config.id}

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

@@ -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 ||
@@ -193,7 +171,12 @@ export default function DynamicFormItemComponent({
       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 (
@@ -244,7 +227,7 @@ export default function DynamicFormItemComponent({
 
     case DynamicFormItemType.SELECT:
       return (
-        <Select value={field.value} onValueChange={field.onChange}>
+        <Select value={field.value ?? ''} onValueChange={field.onChange}>
           <SelectTrigger className="bg-[#ffffff] dark:bg-[#2a2a2e]">
             <SelectValue placeholder={t('common.select')} />
           </SelectTrigger>
@@ -335,172 +318,6 @@ export default function DynamicFormItemComponent({
         </Select>
       );
 
-    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 modelValue = field.value as {
-        primary: string;
-        fallbacks: string[];
-      };
-
-      const renderModelSelect = (
-        value: string,
-        onChange: (val: string) => void,
-        placeholder: string,
-      ) => (
-        <Select value={value} onValueChange={onChange}>
-          <SelectTrigger className="bg-[#ffffff] dark:bg-[#2a2a2e]">
-            <SelectValue placeholder={placeholder} />
-          </SelectTrigger>
-          <SelectContent>
-            {Object.entries(groupedModelsForFallback).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>
-      );
-
-      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="sm"
-                      className="h-8 w-8 p-0 text-destructive"
-                      onClick={() => removeFallbackModel(index)}
-                    >
-                      <X className="h-4 w-4" />
-                    </Button>
-                  </div>
-                </div>
-              ))}
-            </div>
-          )}
-
-          {/* Add fallback button */}
-          <Button
-            type="button"
-            variant="outline"
-            size="sm"
-            className="w-full"
-            onClick={addFallbackModel}
-          >
-            <Plus className="h-4 w-4 mr-1" />
-            {t('models.fallback.addFallback')}
-          </Button>
-        </div>
-      );
-    }
-
     case DynamicFormItemType.KNOWLEDGE_BASE_SELECTOR:
       // Group KBs by Knowledge Engine name
       const kbsByEngine = knowledgeBases.reduce(

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

@@ -422,12 +422,12 @@ export default function HomeSidebar({
                   const language = localStorage.getItem('langbot_language');
                   if (language === 'zh-Hans' || language === 'zh-Hant') {
                     window.open(
-                      'https://docs.langbot.app/zh/insight/guide',
+                      'https://docs.langbot.app/zh/insight/guide.html',
                       '_blank',
                     );
                   } else {
                     window.open(
-                      'https://docs.langbot.app/en/insight/guide',
+                      'https://docs.langbot.app/en/insight/guide.html',
                       '_blank',
                     );
                   }

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

@@ -23,9 +23,9 @@ 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',
     },
   }),
   new SidebarChildVO({
@@ -44,9 +44,9 @@ 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({
@@ -65,8 +65,8 @@ export const sidebarConfigList = [
     route: '/home/monitoring',
     description: t('monitoring.description'),
     helpLink: {
-      en_US: '',
-      zh_Hans: '',
+      en_US: 'https://docs.langbot.app/en/features/monitoring.html',
+      zh_Hans: 'https://docs.langbot.app/zh/features/monitoring.html',
     },
   }),
   new SidebarChildVO({
@@ -84,9 +84,9 @@ 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',
     },
   }),
   new SidebarChildVO({
@@ -105,9 +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',
     },
   }),
 ];

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/KBDetailDialog.tsx

@@ -22,7 +22,6 @@ 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';
@@ -69,9 +68,7 @@ export default function KBDetailDialog({
       setKbInfo(resp.base);
     } catch (e) {
       console.error('Failed to load KB info:', e);
-      toast.error(
-        t('knowledge.loadKnowledgeBaseFailed') + (e as CustomApiError).msg,
-      );
+      toast.error(t('knowledge.loadKnowledgeBaseFailed'));
     }
   }
 
@@ -139,9 +136,7 @@ export default function KBDetailDialog({
       onKbDeleted();
     } catch (e) {
       console.error('Failed to delete KB:', e);
-      toast.error(
-        t('knowledge.deleteKnowledgeBaseFailed') + (e as CustomApiError).msg,
-      );
+      toast.error(t('knowledge.deleteKnowledgeBaseFailed'));
     } finally {
       setShowDeleteConfirm(false);
     }

web/src/app/home/knowledge/components/kb-docs/FileUploadZone.tsx

@@ -12,7 +12,7 @@ import { httpClient } from '@/app/infra/http/HttpClient';
 import { toast } from 'sonner';
 import { useTranslation } from 'react-i18next';
 import { ParserInfo } from '@/app/infra/entities/api';
-import { CustomApiError, I18nObject } from '@/app/infra/entities/common';
+import { I18nObject } from '@/app/infra/entities/common';
 import { extractI18nObject } from '@/i18n/I18nProvider';
 
 interface FileUploadZoneProps {
@@ -97,9 +97,7 @@ export default function FileUploadZone({
         onUploadSuccess();
       } catch (error) {
         console.error('File upload failed:', error);
-        const errorMessage =
-          t('knowledge.documentsTab.uploadError') +
-          (error as CustomApiError).msg;
+        const errorMessage = t('knowledge.documentsTab.uploadError');
         toast.error(errorMessage, { id: toastId });
         onUploadError(errorMessage);
       } finally {

web/src/app/home/knowledge/components/kb-docs/KBDoc.tsx

@@ -1,7 +1,7 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
 import { httpClient } from '@/app/infra/http/HttpClient';
 import { KnowledgeBaseFile } from '@/app/infra/entities/api';
-import { I18nObject, CustomApiError } from '@/app/infra/entities/common';
+import { I18nObject } from '@/app/infra/entities/common';
 import { columns, DocumentFile } from './documents/columns';
 import { DataTable } from './documents/data-table';
 import FileUploadZone from './FileUploadZone';
@@ -87,10 +87,7 @@ export default function KBDoc({
       })
       .catch((error) => {
         console.error('Delete failed:', error);
-        toast.error(
-          t('knowledge.documentsTab.fileDeleteFailed') +
-            (error as CustomApiError).msg,
-        );
+        toast.error(t('knowledge.documentsTab.fileDeleteFailed'));
       });
   };
 

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

@@ -1,5 +1,4 @@
 import { useEffect, useState } from 'react';
-import Link from 'next/link';
 import { useForm } from 'react-hook-form';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { z } from 'zod';
@@ -24,7 +23,6 @@ import {
   SelectValue,
 } from '@/components/ui/select';
 import { KnowledgeBase, KnowledgeEngine } from '@/app/infra/entities/api';
-import { CustomApiError } from '@/app/infra/entities/common';
 import { toast } from 'sonner';
 import { extractI18nObject } from '@/i18n/I18nProvider';
 import DynamicFormComponent from '@/app/home/components/dynamic-form/DynamicFormComponent';
@@ -219,10 +217,7 @@ export default function KBForm({
         })
         .catch((err) => {
           console.error('update knowledge base failed', err);
-          toast.error(
-            t('knowledge.updateKnowledgeBaseFailed') +
-              (err as CustomApiError).msg,
-          );
+          toast.error(t('knowledge.updateKnowledgeBaseFailed'));
         });
     } else {
       // Create knowledge base
@@ -233,10 +228,7 @@ export default function KBForm({
         })
         .catch((err) => {
           console.error('create knowledge base failed', err);
-          toast.error(
-            t('knowledge.createKnowledgeBaseFailed') +
-              (err as CustomApiError).msg,
-          );
+          toast.error(t('knowledge.createKnowledgeBaseFailed'));
         });
     }
   };
@@ -265,12 +257,9 @@ 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>
     );
   }

web/src/app/home/knowledge/components/kb-migration-dialog/KBMigrationDialog.tsx

@@ -1,157 +0,0 @@
-'use client';
-
-import { useState } from 'react';
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-  DialogDescription,
-  DialogFooter,
-} from '@/components/ui/dialog';
-import { Button } from '@/components/ui/button';
-import { useTranslation } from 'react-i18next';
-import { httpClient } from '@/app/infra/http/HttpClient';
-import { useAsyncTask, AsyncTaskStatus } from '@/hooks/useAsyncTask';
-import { toast } from 'sonner';
-import { Loader2 } from 'lucide-react';
-
-interface KBMigrationDialogProps {
-  open: boolean;
-  onOpenChange: (open: boolean) => void;
-  internalKbCount: number;
-  externalKbCount: number;
-  onMigrationComplete: () => void;
-}
-
-export default function KBMigrationDialog({
-  open,
-  onOpenChange,
-  internalKbCount,
-  externalKbCount,
-  onMigrationComplete,
-}: KBMigrationDialogProps) {
-  const { t } = useTranslation();
-  const [dismissing, setDismissing] = useState(false);
-
-  const asyncTask = useAsyncTask({
-    onSuccess: () => {
-      toast.success(t('knowledge.migration.success'));
-      onOpenChange(false);
-      onMigrationComplete();
-    },
-    onError: (error) => {
-      toast.error(`${t('knowledge.migration.error')}${error}`);
-    },
-  });
-
-  const handleMigration = async (installPlugin: boolean) => {
-    try {
-      const resp = await httpClient.executeRagMigration(installPlugin);
-      asyncTask.startTask(resp.task_id);
-    } catch {
-      toast.error(t('knowledge.migration.error'));
-    }
-  };
-
-  const handleDismiss = async () => {
-    setDismissing(true);
-    try {
-      await httpClient.dismissRagMigration();
-      onOpenChange(false);
-    } catch {
-      toast.error(t('knowledge.migration.dismissError'));
-    } finally {
-      setDismissing(false);
-    }
-  };
-
-  const isRunning = asyncTask.status === AsyncTaskStatus.RUNNING;
-  const isError = asyncTask.status === AsyncTaskStatus.ERROR;
-  const totalCount = internalKbCount + externalKbCount;
-
-  return (
-    <Dialog
-      open={open}
-      onOpenChange={(v) => {
-        if (!isRunning) onOpenChange(v);
-      }}
-    >
-      <DialogContent className="sm:max-w-md">
-        <DialogHeader>
-          <DialogTitle>{t('knowledge.migration.title')}</DialogTitle>
-          <DialogDescription>
-            {t('knowledge.migration.description')}
-          </DialogDescription>
-        </DialogHeader>
-
-        <div className="py-4 space-y-3">
-          {!isRunning && !isError && (
-            <p className="text-sm text-muted-foreground">
-              {t('knowledge.migration.detected', {
-                total: totalCount,
-                internal: internalKbCount,
-                external: externalKbCount,
-              })}
-            </p>
-          )}
-
-          {isRunning && (
-            <div className="flex items-center gap-3">
-              <Loader2 className="h-5 w-5 animate-spin text-primary" />
-              <p className="text-sm">{t('knowledge.migration.running')}</p>
-            </div>
-          )}
-
-          {isError && (
-            <div className="space-y-2">
-              <p className="text-sm text-destructive">
-                {t('knowledge.migration.error')}
-              </p>
-              {asyncTask.error && (
-                <p className="text-xs text-muted-foreground bg-muted p-2 rounded">
-                  {asyncTask.error}
-                </p>
-              )}
-            </div>
-          )}
-        </div>
-
-        <DialogFooter className="flex flex-col gap-2 sm:flex-col">
-          {!isRunning && !isError && (
-            <>
-              <Button onClick={() => handleMigration(true)} className="w-full">
-                {t('knowledge.migration.startWithInstall')}
-              </Button>
-              <Button
-                variant="outline"
-                onClick={() => handleMigration(false)}
-                className="w-full"
-              >
-                {t('knowledge.migration.startDataOnly')}
-              </Button>
-              <p className="text-xs text-muted-foreground text-center">
-                {t('knowledge.migration.dataOnlyHint')}
-              </p>
-            </>
-          )}
-          {isError && (
-            <Button onClick={() => handleMigration(true)} className="w-full">
-              {t('knowledge.migration.retry')}
-            </Button>
-          )}
-          {!isRunning && (
-            <Button
-              variant="ghost"
-              onClick={handleDismiss}
-              disabled={dismissing}
-              className="w-full text-destructive hover:text-destructive"
-            >
-              {t('knowledge.migration.dismiss')}
-            </Button>
-          )}
-        </DialogFooter>
-      </DialogContent>
-    </Dialog>
-  );
-}

web/src/app/home/knowledge/components/kb-retrieve/KBRetrieveGeneric.tsx

@@ -6,7 +6,6 @@ import { Button } from '@/components/ui/button';
 import { Input } from '@/components/ui/input';
 import { useTranslation } from 'react-i18next';
 import { RetrieveResult } from '@/app/infra/entities/api';
-import { CustomApiError } from '@/app/infra/entities/common';
 import { toast } from 'sonner';
 
 interface KBRetrieveGenericProps {
@@ -42,7 +41,7 @@ export default function KBRetrieveGeneric({
       setResults(response.results);
     } catch (error) {
       console.error('Retrieve failed:', error);
-      toast.error(t('knowledge.retrieveError') + (error as CustomApiError).msg);
+      toast.error(t('knowledge.retrieveError'));
     } finally {
       setLoading(false);
     }

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

@@ -7,7 +7,6 @@ import { useEffect, useState } from 'react';
 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 { httpClient } from '@/app/infra/http/HttpClient';
 import { KnowledgeBase } from '@/app/infra/entities/api';
 
@@ -19,29 +18,10 @@ export default function KnowledgePage() {
   const [selectedKbId, setSelectedKbId] = useState<string>('');
   const [detailDialogOpen, setDetailDialogOpen] = useState(false);
 
-  // Migration dialog state
-  const [migrationDialogOpen, setMigrationDialogOpen] = useState(false);
-  const [migrationInternalCount, setMigrationInternalCount] = useState(0);
-  const [migrationExternalCount, setMigrationExternalCount] = useState(0);
-
   useEffect(() => {
     getKnowledgeBaseList();
-    checkMigrationStatus();
   }, []);
 
-  async function checkMigrationStatus() {
-    try {
-      const resp = await httpClient.getRagMigrationStatus();
-      if (resp.needed) {
-        setMigrationInternalCount(resp.internal_kb_count);
-        setMigrationExternalCount(resp.external_kb_count);
-        setMigrationDialogOpen(true);
-      }
-    } catch {
-      // Silently ignore - migration check is non-critical
-    }
-  }
-
   async function getKnowledgeBaseList() {
     const resp = await httpClient.getKnowledgeBases();
 
@@ -105,20 +85,8 @@ export default function KnowledgePage() {
     getKnowledgeBaseList();
   };
 
-  const handleMigrationComplete = () => {
-    getKnowledgeBaseList();
-  };
-
   return (
     <div>
-      <KBMigrationDialog
-        open={migrationDialogOpen}
-        onOpenChange={setMigrationDialogOpen}
-        internalKbCount={migrationInternalCount}
-        externalKbCount={migrationExternalCount}
-        onMigrationComplete={handleMigrationComplete}
-      />
-
       <KBDetailDialog
         open={detailDialogOpen}
         onOpenChange={setDetailDialogOpen}

web/src/app/home/pipelines/components/pipeline-form/PipelineFormComponent.tsx

@@ -120,8 +120,6 @@ export default function PipelineFormComponent({
 
   // Track unsaved changes by comparing current form values against a saved snapshot
   const savedSnapshotRef = useRef<string>('');
-  // Track which dynamic form stages have completed their initial mount emission.
-  const initializedStagesRef = useRef<Set<string>>(new Set());
   const watchedValues = form.watch();
   const hasUnsavedChanges = useMemo(() => {
     if (!isEditMode || !savedSnapshotRef.current) return false;
@@ -162,7 +160,6 @@ export default function PipelineFormComponent({
           };
           form.reset(loadedValues);
           savedSnapshotRef.current = JSON.stringify(loadedValues);
-          initializedStagesRef.current.clear();
         });
     }
   }, []);
@@ -238,33 +235,6 @@ export default function PipelineFormComponent({
       });
   }
 
-  // Called from DynamicFormComponent/N8nAuthFormComponent onSubmit callbacks.
-  // On the first emission for a stage (mount-time default filling), the
-  // snapshot is synchronously re-captured so that hasUnsavedChanges stays false.
-  function handleDynamicFormEmit(
-    formName: keyof FormValues,
-    stageName: string,
-    values: object,
-  ) {
-    const stageKey = `${String(formName)}.${stageName}`;
-    const isFirstEmission = !initializedStagesRef.current.has(stageKey);
-
-    const currentValues =
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      (form.getValues(formName) as Record<string, any>) || {};
-    form.setValue(formName, {
-      ...currentValues,
-      [stageName]: values,
-    });
-
-    if (isFirstEmission) {
-      initializedStagesRef.current.add(stageKey);
-      // Synchronously re-capture snapshot so that the useMemo comparison
-      // in the same render cycle still returns false.
-      savedSnapshotRef.current = JSON.stringify(form.getValues());
-    }
-  }
-
   function renderDynamicForms(
     stage: PipelineConfigStage,
     formName: keyof FormValues,
@@ -294,7 +264,13 @@ export default function PipelineFormComponent({
                 {}
               }
               onSubmit={(values) => {
-                handleDynamicFormEmit(formName, stage.name, values);
+                const currentValues =
+                  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                  (form.getValues(formName) as Record<string, any>) || {};
+                form.setValue(formName, {
+                  ...currentValues,
+                  [stage.name]: values,
+                });
               }}
             />
           </div>
@@ -326,7 +302,13 @@ export default function PipelineFormComponent({
                 {}
               }
               onSubmit={(values) => {
-                handleDynamicFormEmit(formName, stage.name, values);
+                const currentValues =
+                  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                  (form.getValues(formName) as Record<string, any>) || {};
+                form.setValue(formName, {
+                  ...currentValues,
+                  [stage.name]: values,
+                });
               }}
             />
           </div>
@@ -351,7 +333,13 @@ export default function PipelineFormComponent({
             (form.watch(formName) as Record<string, any>)?.[stage.name] || {}
           }
           onSubmit={(values) => {
-            handleDynamicFormEmit(formName, stage.name, values);
+            const currentValues =
+              // eslint-disable-next-line @typescript-eslint/no-explicit-any
+              (form.getValues(formName) as Record<string, any>) || {};
+            form.setValue(formName, {
+              ...currentValues,
+              [stage.name]: values,
+            });
           }}
         />
       </div>

web/src/app/home/plugins/components/plugin-market/PluginMarketComponent.tsx

@@ -1,6 +1,13 @@
 'use client';
 
-import { useState, useEffect, useCallback, useRef, Suspense } from 'react';
+import {
+  useState,
+  useEffect,
+  useCallback,
+  useRef,
+  Suspense,
+  useMemo,
+} from 'react';
 import { Input } from '@/components/ui/input';
 import {
   Select,
@@ -63,7 +70,7 @@ function MarketPageContent({
     RecommendationList[]
   >([]);
 
-  const pageSize = 12; // 每页12个
+  const pageSize = 16; // 每页16个，4行x4列
   const searchTimeoutRef = useRef<NodeJS.Timeout | null>(null);
   const scrollContainerRef = useRef<HTMLDivElement | null>(null);
 
@@ -323,7 +330,38 @@ function MarketPageContent({
     };
   }, []);
 
-  const visiblePlugins = plugins;
+  // 计算所有推荐插件的 ID 集合
+  const recommendedPluginIds = useMemo(() => {
+    const ids = new Set<string>();
+    recommendationLists.forEach((list) => {
+      list.plugins.forEach((plugin) => {
+        ids.add(`${plugin.author} / ${plugin.name}`);
+      });
+    });
+    return ids;
+  }, [recommendationLists]);
+
+  // 过滤掉已在推荐列表中展示的插件
+  // 仅在显示推荐列表的条件下（无搜索、无筛选、第一页或后续页的累积数据中）进行过滤
+  // 注意：如果用户翻页，我们希望一直保持去重，否则推荐过的插件会在第二页出现
+  // 但是推荐列表只在第一页且无筛选时显示。
+  // 如果用户进行了筛选/搜索，推荐列表不显示，此时不需要去重。
+  const visiblePlugins = useMemo(() => {
+    const showRecommendations =
+      !searchQuery && componentFilter === 'all' && selectedTags.length === 0;
+
+    if (!showRecommendations) {
+      return plugins;
+    }
+
+    return plugins.filter((p) => !recommendedPluginIds.has(p.pluginId));
+  }, [
+    plugins,
+    recommendedPluginIds,
+    searchQuery,
+    componentFilter,
+    selectedTags,
+  ]);
 
   // 加载更多
   const loadMore = useCallback(() => {
@@ -524,7 +562,8 @@ function MarketPageContent({
         {/* Recommendation Lists */}
         {!searchQuery &&
           componentFilter === 'all' &&
-          selectedTags.length === 0 && (
+          selectedTags.length === 0 &&
+          currentPage === 1 && (
             <div className="pt-4">
               <RecommendationLists
                 lists={recommendationLists}

web/src/app/home/plugins/components/plugin-market/RecommendationLists.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { useState, useRef, useEffect, useCallback } from 'react';
+import { useState } from 'react';
 import { ChevronLeft, ChevronRight, Star } from 'lucide-react';
 import { Button } from '@/components/ui/button';
 import PluginMarketCardComponent from './plugin-market-card/PluginMarketCardComponent';
@@ -18,7 +18,7 @@ export interface RecommendationList {
   plugins: PluginV4[];
 }
 
-// Match the main plugin grid: grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 2xl:grid-cols-4
+const PAGE_SIZE = 4; // plugins per page in a recommendation row
 
 function pluginToVO(
   plugin: PluginV4,
@@ -47,53 +47,18 @@ function RecommendationListRow({
   list,
   tagNames,
   onInstall,
-  isLast,
 }: {
   list: RecommendationList;
   tagNames: Record<string, string>;
   onInstall: (author: string, pluginName: string) => void;
-  isLast: boolean;
 }) {
   const { t } = useTranslation();
   const [page, setPage] = useState(0);
-  const [perPage, setPerPage] = useState(4);
-  const gridRef = useRef<HTMLDivElement>(null);
 
   const plugins = list.plugins || [];
-
-  // Measure how many columns the CSS grid actually renders
-  const measureCols = useCallback(() => {
-    if (!gridRef.current) return;
-    const style = window.getComputedStyle(gridRef.current);
-    const cols = style.gridTemplateColumns.split(' ').length;
-    setPerPage(cols);
-  }, []);
-
-  useEffect(() => {
-    measureCols();
-    const observer = new ResizeObserver(measureCols);
-    if (gridRef.current) observer.observe(gridRef.current);
-    return () => observer.disconnect();
-  }, [measureCols]);
-
-  // Auto-advance every 5 seconds
-  useEffect(() => {
-    if (plugins.length <= perPage) return;
-    const timer = setInterval(() => {
-      setPage((p) => {
-        const tp = Math.max(1, Math.ceil(plugins.length / perPage));
-        return p >= tp - 1 ? 0 : p + 1;
-      });
-    }, 5000);
-    return () => clearInterval(timer);
-  }, [plugins.length, perPage]);
-
-  const totalPages = Math.max(1, Math.ceil(plugins.length / perPage));
-  const safePage = Math.min(page, totalPages - 1);
-  if (safePage !== page) setPage(safePage);
-
-  const start = safePage * perPage;
-  const visiblePlugins = plugins.slice(start, start + perPage);
+  const totalPages = Math.ceil(plugins.length / PAGE_SIZE);
+  const start = page * PAGE_SIZE;
+  const visiblePlugins = plugins.slice(start, start + PAGE_SIZE);
 
   if (plugins.length === 0) return null;
 
@@ -112,19 +77,19 @@ function RecommendationListRow({
               variant="ghost"
               size="sm"
               onClick={() => setPage((p) => Math.max(0, p - 1))}
-              disabled={safePage === 0}
+              disabled={page === 0}
               className="h-7 w-7 p-0"
             >
               <ChevronLeft className="w-4 h-4" />
             </Button>
             <span className="text-xs text-muted-foreground px-1">
-              {safePage + 1} / {totalPages}
+              {page + 1} / {totalPages}
             </span>
             <Button
               variant="ghost"
               size="sm"
               onClick={() => setPage((p) => Math.min(totalPages - 1, p + 1))}
-              disabled={safePage >= totalPages - 1}
+              disabled={page >= totalPages - 1}
               className="h-7 w-7 p-0"
             >
               <ChevronRight className="w-4 h-4" />
@@ -132,10 +97,7 @@ function RecommendationListRow({
           </div>
         )}
       </div>
-      <div
-        ref={gridRef}
-        className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 2xl:grid-cols-4 gap-6"
-      >
+      <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 2xl:grid-cols-4 gap-6">
         {visiblePlugins.map((plugin) => (
           <PluginMarketCardComponent
             key={plugin.author + ' / ' + plugin.name}
@@ -145,9 +107,7 @@ function RecommendationListRow({
           />
         ))}
       </div>
-      {totalPages > 1 && !isLast && (
-        <div className="border-b border-border mt-6" />
-      )}
+      {totalPages > 1 && <div className="border-b border-border mt-6" />}
     </div>
   );
 }
@@ -165,13 +125,12 @@ export function RecommendationLists({
 
   return (
     <div className="mt-6">
-      {lists.map((list, index) => (
+      {lists.map((list) => (
         <RecommendationListRow
           key={list.uuid}
           list={list}
           tagNames={tagNames}
           onInstall={onInstall}
-          isLast={index === lists.length - 1}
         />
       ))}
       <div className="border-b border-border mb-6" />

web/src/app/home/plugins/components/plugin-market/plugin-market-card/PluginMarketCardComponent.tsx

@@ -1,12 +1,6 @@
 import { PluginMarketCardVO } from './PluginMarketCardVO';
 import { useTranslation } from 'react-i18next';
 import { Badge } from '@/components/ui/badge';
-import {
-  Tooltip,
-  TooltipContent,
-  TooltipProvider,
-  TooltipTrigger,
-} from '@/components/ui/tooltip';
 import {
   Wrench,
   AudioWaveform,
@@ -15,9 +9,8 @@ import {
   ExternalLink,
   Book,
   FileText,
-  Info,
 } from 'lucide-react';
-import { useState, useRef, useEffect } from 'react';
+import { useState } from 'react';
 import { Button } from '@/components/ui/button';
 
 export default function PluginMarketCardComponent({
@@ -31,43 +24,6 @@ export default function PluginMarketCardComponent({
 }) {
   const { t } = useTranslation();
   const [isHovered, setIsHovered] = useState(false);
-  const bottomRef = useRef<HTMLDivElement>(null);
-  const [visibleTags, setVisibleTags] = useState(2);
-
-  // Measure how many tags fit in the bottom row
-  useEffect(() => {
-    const tags = cardVO.tags;
-    if (!bottomRef.current || !tags || tags.length === 0) return;
-
-    const measure = () => {
-      const container = bottomRef.current;
-      if (!container) return;
-      const width = container.offsetWidth;
-      const availableForTags = width - 140 - 80;
-      if (availableForTags <= 0) {
-        setVisibleTags(0);
-        return;
-      }
-      const tagWidth = 80;
-      const plusBadgeWidth = 40;
-      const maxTags = Math.max(
-        0,
-        Math.floor((availableForTags - plusBadgeWidth) / tagWidth),
-      );
-      if (maxTags >= tags.length) {
-        setVisibleTags(tags.length);
-      } else {
-        setVisibleTags(Math.max(1, maxTags));
-      }
-    };
-
-    measure();
-    const observer = new ResizeObserver(measure);
-    observer.observe(bottomRef.current);
-    return () => observer.disconnect();
-  }, [cardVO.tags]);
-
-  const remainingTags = cardVO.tags ? cardVO.tags.length - visibleTags : 0;
 
   function handleInstallClick(e: React.MouseEvent) {
     e.stopPropagation();
@@ -90,13 +46,6 @@ export default function PluginMarketCardComponent({
     Parser: <FileText className="w-4 h-4" />,
   };
 
-  // Plugins that only contain KnowledgeRetriever components are deprecated
-  const isDeprecated = (() => {
-    if (!cardVO.components) return false;
-    const keys = Object.keys(cardVO.components);
-    return keys.length > 0 && keys.every((k) => k === 'KnowledgeRetriever');
-  })();
-
   return (
     <div
       className="w-[100%] h-auto min-h-[8rem] sm:min-h-[9rem] bg-white rounded-[10px] shadow-[0px_0px_4px_0_rgba(0,0,0,0.2)] p-3 sm:p-[1rem] hover:shadow-[0px_3px_6px_0_rgba(0,0,0,0.12)] transition-all duration-200 hover:scale-[1.005] dark:bg-[#1f1f22] relative"
@@ -117,34 +66,8 @@ export default function PluginMarketCardComponent({
               <div className="text-[0.65rem] sm:text-[0.7rem] text-[#666] dark:text-[#999] truncate w-full">
                 {cardVO.pluginId}
               </div>
-              <div className="flex items-center gap-1.5 w-full min-w-0">
-                <div className="text-base sm:text-[1.2rem] text-black dark:text-[#f0f0f0] truncate">
-                  {cardVO.label}
-                </div>
-                {isDeprecated && (
-                  <TooltipProvider delayDuration={200}>
-                    <Tooltip>
-                      <TooltipTrigger
-                        asChild
-                        onClick={(e) => e.preventDefault()}
-                      >
-                        <Badge
-                          variant="outline"
-                          className="text-[0.6rem] px-1.5 py-0 h-4 flex-shrink-0 border-red-400 text-red-500 dark:border-red-500 dark:text-red-400 gap-0.5 cursor-help"
-                        >
-                          {t('market.deprecated')}
-                          <Info className="w-2.5 h-2.5" />
-                        </Badge>
-                      </TooltipTrigger>
-                      <TooltipContent
-                        side="top"
-                        className="max-w-[240px] text-xs"
-                      >
-                        {t('market.deprecatedTooltip')}
-                      </TooltipContent>
-                    </Tooltip>
-                  </TooltipProvider>
-                )}
+              <div className="text-base sm:text-[1.2rem] text-black dark:text-[#f0f0f0] truncate w-full">
+                {cardVO.label}
               </div>
             </div>
 
@@ -172,13 +95,10 @@ export default function PluginMarketCardComponent({
         </div>
 
         {/* 下部分：下载量、标签和组件列表 */}
-        <div
-          ref={bottomRef}
-          className="w-full flex flex-row items-center justify-between gap-2 px-0 sm:px-[0.4rem] flex-shrink-0 overflow-hidden"
-        >
-          <div className="flex flex-row items-center justify-start gap-2 min-w-0 overflow-hidden">
+        <div className="w-full flex flex-row items-center justify-between gap-2 px-0 sm:px-[0.4rem] flex-shrink-0">
+          <div className="flex flex-row items-center justify-start gap-2 flex-wrap">
             {/* 下载数量 */}
-            <div className="flex flex-row items-center gap-[0.3rem] sm:gap-[0.4rem] flex-shrink-0">
+            <div className="flex flex-row items-center gap-[0.3rem] sm:gap-[0.4rem]">
               <svg
                 className="w-4 h-4 sm:w-[1.2rem] sm:h-[1.2rem] text-[#2563eb] dark:text-[#5b8def] flex-shrink-0"
                 xmlns="http://www.w3.org/2000/svg"
@@ -196,14 +116,14 @@ export default function PluginMarketCardComponent({
               </div>
             </div>
 
-            {/* Tags - adaptive */}
-            {cardVO.tags && cardVO.tags.length > 0 && visibleTags > 0 && (
-              <div className="flex flex-row items-center gap-1.5 overflow-hidden flex-shrink min-w-0">
-                {cardVO.tags.slice(0, visibleTags).map((tag) => (
+            {/* Tags */}
+            {cardVO.tags && cardVO.tags.length > 0 && (
+              <div className="flex flex-wrap gap-1.5">
+                {cardVO.tags.slice(0, 2).map((tag) => (
                   <Badge
                     key={tag}
                     variant="secondary"
-                    className="text-[0.65rem] sm:text-[0.7rem] px-2 py-0.5 h-5 flex items-center gap-1 flex-shrink-0 whitespace-nowrap"
+                    className="text-[0.65rem] sm:text-[0.7rem] px-2 py-0.5 h-5 flex items-center gap-1 flex-shrink-0"
                   >
                     <svg
                       className="w-2.5 h-2.5 flex-shrink-0"
@@ -218,17 +138,15 @@ export default function PluginMarketCardComponent({
                       <path d="M20.59 13.41l-7.17 7.17a2 2 0 0 1-2.83 0L2 12V2h10l8.59 8.59a2 2 0 0 1 0 2.82z" />
                       <line x1="7" y1="7" x2="7.01" y2="7" />
                     </svg>
-                    <span className="truncate max-w-[5rem]">
-                      {tagNames[tag] || tag}
-                    </span>
+                    <span className="truncate">{tagNames[tag] || tag}</span>
                   </Badge>
                 ))}
-                {remainingTags > 0 && (
+                {cardVO.tags.length > 2 && (
                   <Badge
                     variant="outline"
-                    className="text-[0.65rem] sm:text-[0.7rem] px-1.5 py-0.5 h-5 flex items-center flex-shrink-0 whitespace-nowrap"
+                    className="text-[0.65rem] sm:text-[0.7rem] px-2 py-0.5 h-5 flex items-center flex-shrink-0"
                   >
-                    +{remainingTags}
+                    +{cardVO.tags.length - 2}
                   </Badge>
                 )}
               </div>

web/src/app/infra/entities/api/index.ts

@@ -262,12 +262,6 @@ export interface ApiRespSystemInfo {
   limitation: SystemLimitation;
 }
 
-export interface RagMigrationStatusResp {
-  needed: boolean;
-  internal_kb_count: number;
-  external_kb_count: number;
-}
-
 export interface ApiRespPluginSystemStatus {
   is_enable: boolean;
   is_connected: boolean;

web/src/app/infra/entities/form/dynamic.ts

@@ -35,7 +35,6 @@ export enum DynamicFormItemType {
   SELECT = 'select',
   LLM_MODEL_SELECTOR = 'llm-model-selector',
   EMBEDDING_MODEL_SELECTOR = 'embedding-model-selector',
-  MODEL_FALLBACK_SELECTOR = 'model-fallback-selector',
   PROMPT_EDITOR = 'prompt-editor',
   UNKNOWN = 'unknown',
   KNOWLEDGE_BASE_SELECTOR = 'knowledge-base-selector',

web/src/app/infra/http/BackendClient.ts

@@ -40,7 +40,6 @@ import {
   ModelProvider,
   ApiRespKnowledgeEngines,
   ApiRespParsers,
-  RagMigrationStatusResp,
 } from '@/app/infra/entities/api';
 import { Plugin } from '@/app/infra/entities/plugin';
 import { GetBotLogsRequest } from '@/app/infra/http/requestParam/bots/GetBotLogsRequest';
@@ -356,7 +355,6 @@ export class BackendClient extends BaseHttpClient {
       is_active: boolean;
       platform: string | null;
       user_id: string | null;
-      user_name: string | null;
     }>;
     total: number;
   }> {
@@ -385,7 +383,6 @@ export class BackendClient extends BaseHttpClient {
       level: string;
       platform: string | null;
       user_id: string | null;
-      user_name: string | null;
       runner_name: string | null;
       variables: string | null;
       role: string | null;
@@ -713,23 +710,6 @@ export class BackendClient extends BaseHttpClient {
     return this.get('/api/v1/system/status/plugin-system');
   }
 
-  // ============ RAG Migration API ============
-  public getRagMigrationStatus(): Promise<RagMigrationStatusResp> {
-    return this.get('/api/v1/knowledge/migration/status');
-  }
-
-  public executeRagMigration(
-    installPlugin: boolean = true,
-  ): Promise<AsyncTaskCreatedResp> {
-    return this.post('/api/v1/knowledge/migration/execute', {
-      install_plugin: installPlugin,
-    });
-  }
-
-  public dismissRagMigration(): Promise<object> {
-    return this.post('/api/v1/knowledge/migration/dismiss');
-  }
-
   public getPluginDebugInfo(): Promise<{
     debug_url: string;
     plugin_debug_key: string;

web/src/app/login/page.tsx

@@ -284,27 +284,6 @@ export default function Login() {
               </form>
             </Form>
           )}
-
-          <p className="text-xs text-center text-muted-foreground">
-            {t('common.agreementNotice')}{' '}
-            <a
-              href="https://langbot.app/privacy"
-              target="_blank"
-              rel="noopener noreferrer"
-              className="underline hover:text-foreground transition-colors"
-            >
-              {t('common.privacyPolicy')}
-            </a>{' '}
-            {t('common.and')}{' '}
-            <a
-              href={t('common.dataCollectionPolicyUrl')}
-              target="_blank"
-              rel="noopener noreferrer"
-              className="underline hover:text-foreground transition-colors"
-            >
-              {t('common.dataCollectionPolicy')}
-            </a>
-          </p>
         </CardContent>
       </Card>
     </div>

web/src/app/register/page.tsx

@@ -253,27 +253,6 @@ export default function Register() {
               </Button>
             </form>
           </Form>
-
-          <p className="text-xs text-center text-muted-foreground">
-            {t('common.agreementNotice')}{' '}
-            <a
-              href="https://langbot.app/privacy"
-              target="_blank"
-              rel="noopener noreferrer"
-              className="underline hover:text-foreground transition-colors"
-            >
-              {t('common.privacyPolicy')}
-            </a>{' '}
-            {t('common.and')}{' '}
-            <a
-              href={t('common.dataCollectionPolicyUrl')}
-              target="_blank"
-              rel="noopener noreferrer"
-              className="underline hover:text-foreground transition-colors"
-            >
-              {t('common.dataCollectionPolicy')}
-            </a>
-          </p>
         </CardContent>
       </Card>
     </div>

web/src/i18n/locales/en-US.ts

@@ -47,12 +47,6 @@ const enUS = {
     copyFailed: 'Copy Failed',
     test: 'Test',
     forgotPassword: 'Forgot Password?',
-    agreementNotice: 'By continuing, you agree to our',
-    privacyPolicy: 'Privacy Policy',
-    and: 'and',
-    dataCollectionPolicy: 'Data Collection Policy',
-    dataCollectionPolicyUrl:
-      'https://docs.langbot.app/en/insight/data-collection-policy',
     loading: 'Loading...',
     fieldRequired: 'This field is required',
     or: 'or',
@@ -236,11 +230,6 @@ const enUS = {
     modelsCount: '{{count}} model(s)',
     expandModels: 'Expand',
     collapseModels: 'Collapse',
-    fallback: {
-      primary: 'Primary Model',
-      fallbackList: 'Fallback Models',
-      addFallback: 'Add Fallback Model',
-    },
   },
   bots: {
     title: 'Bots',
@@ -494,9 +483,6 @@ const enUS = {
     allComponents: 'All Components',
     requestPlugin: 'Request Plugin',
     viewDetails: 'View Details',
-    deprecated: 'Deprecated',
-    deprecatedTooltip:
-      'Please install the corresponding Knowledge Engine plugin.',
     tags: {
       filterByTags: 'Filter by Tags',
       selected: 'selected',
@@ -721,7 +707,7 @@ const enUS = {
     cannotChangeEmbeddingModel:
       'Knowledge base created cannot be modified embedding model',
     updateKnowledgeBaseSuccess: 'Knowledge base updated successfully',
-    updateKnowledgeBaseFailed: 'Knowledge base update failed: ',
+    updateKnowledgeBaseFailed: 'Knowledge base update failed',
     documentsTab: {
       name: 'Name',
       status: 'Status',
@@ -731,14 +717,14 @@ const enUS = {
       supportedFormats:
         'Supports PDF, Word, TXT, Markdown, HTML, ZIP and other document formats',
       uploadSuccess: 'File uploaded successfully!',
-      uploadError: 'File upload failed: ',
+      uploadError: 'File upload failed, please try again',
       uploadingFile: 'Uploading file...',
       fileSizeExceeded:
         'File size exceeds 10MB limit. Please split into smaller files.',
       actions: 'Actions',
       delete: 'Delete File',
       fileDeleteSuccess: 'File deleted successfully',
-      fileDeleteFailed: 'File deletion failed: ',
+      fileDeleteFailed: 'File deletion failed',
       processing: 'Processing',
       completed: 'Completed',
       failed: 'Failed',
@@ -759,7 +745,7 @@ const enUS = {
     content: 'Content',
     fileName: 'File Name',
     noResults: 'No results',
-    retrieveError: 'Retrieve failed: ',
+    retrieveError: 'Retrieve failed',
     unknownEngine: 'Unknown Engine',
     knowledgeEngine: 'Knowledge Engine',
     knowledgeEngineRequired: 'Knowledge engine is required',
@@ -771,10 +757,10 @@ const enUS = {
     engineSettingsReadonly: 'read-only in edit mode',
     retrievalSettings: 'Retrieval Settings',
     noEnginesAvailable: 'No knowledge base engines available',
-    installEngineHint: 'Please install a "Knowledge Engine" plugin first',
-    createKnowledgeBaseFailed: 'Failed to create knowledge base: ',
-    loadKnowledgeBaseFailed: 'Failed to load knowledge base: ',
-    deleteKnowledgeBaseFailed: 'Failed to delete knowledge base: ',
+    installEngineHint: 'Please install a knowledge base plugin first',
+    createKnowledgeBaseFailed: 'Failed to create knowledge base',
+    loadKnowledgeBaseFailed: 'Failed to load knowledge base',
+    deleteKnowledgeBaseFailed: 'Failed to delete knowledge base',
     getKnowledgeBaseListError: 'Failed to get knowledge base list: ',
     embeddingModel: 'Embedding Model',
     embeddingModelRequired: 'Embedding model is required for this engine',
@@ -787,23 +773,6 @@ const enUS = {
     retrieverConfiguration: 'Retriever Configuration',
     retrieverInstallInfo: 'You can install Knowledge Retriever plugins from',
     retrieverMarketLink: 'here',
-    migration: {
-      title: 'Knowledge Base Migration',
-      description:
-        'The new version has refactored the knowledge base into a plugin-based architecture, unifying built-in and external knowledge bases as "Knowledge Engine" plugins. Migration of legacy knowledge base data is required. Your old data has been automatically backed up in the database.',
-      detected:
-        'Found {{total}} knowledge base(s) to migrate ({{internal}} internal, {{external}} external).',
-      startWithInstall: 'Auto-install Plugin & Migrate',
-      startDataOnly: 'Migrate Data Only',
-      dataOnlyHint:
-        '"Migrate Data Only" is for offline/intranet environments. Please install the corresponding plugin manually after migration.',
-      dismiss: 'Discard Original Data',
-      running: 'Migrating knowledge bases, please wait...',
-      success: 'Knowledge base migration completed',
-      error: 'Knowledge base migration failed: ',
-      dismissError: 'Operation failed',
-      retry: 'Retry',
-    },
   },
   register: {
     title: 'Initialize LangBot 👋',

web/src/i18n/locales/ja-JP.ts

@@ -1,4 +1,4 @@
-const jaJP = {
+const jaJP = {
   common: {
     login: 'ログイン',
     logout: 'ログアウト',
@@ -48,12 +48,6 @@
     copyFailed: 'コピーに失敗しました',
     test: 'テスト',
     forgotPassword: 'パスワードを忘れた？',
-    agreementNotice: '続行することで、以下に同意したものとみなされます：',
-    privacyPolicy: 'プライバシーポリシー',
-    and: 'および',
-    dataCollectionPolicy: 'データ収集ポリシー',
-    dataCollectionPolicyUrl:
-      'https://docs.langbot.app/ja/insight/data-collection-policy',
     loading: '読み込み中...',
     fieldRequired: 'この項目は必須です',
     or: 'または',
@@ -241,11 +235,6 @@
     modelsCount: '{{count}} 個のモデル',
     expandModels: '展開',
     collapseModels: '折りたたむ',
-    fallback: {
-      primary: 'プライマリモデル',
-      fallbackList: 'フォールバックモデル',
-      addFallback: 'フォールバックモデルを追加',
-    },
   },
   bots: {
     title: 'ボット',
@@ -502,9 +491,6 @@
       noTags: 'タグがありません',
     },
     viewDetails: '詳細を表示',
-    deprecated: '非推奨',
-    deprecatedTooltip:
-      '対応する「ナレッジエンジン」プラグインをインストールしてください。',
   },
   mcp: {
     title: 'MCP',
@@ -723,7 +709,7 @@
     cannotChangeEmbeddingModel:
       '知識ベース作成後は埋め込みモデルを変更できません',
     updateKnowledgeBaseSuccess: '知識ベースの更新に成功しました',
-    updateKnowledgeBaseFailed: '知識ベースの更新に失敗しました：',
+    updateKnowledgeBaseFailed: '知識ベースの更新に失敗しました',
     documentsTab: {
       name: '名前',
       status: 'ステータス',
@@ -734,14 +720,14 @@
       supportedFormats:
         'PDF、Word、TXT、Markdownなどのドキュメントファイルをサポートしています',
       uploadSuccess: 'ファイルのアップロードに成功しました！',
-      uploadError: 'ファイルのアップロードに失敗しました：',
+      uploadError: 'ファイルのアップロードに失敗しました。再度お試しください',
       uploadingFile: 'ファイルをアップロード中...',
       fileSizeExceeded:
         'ファイルサイズが10MBの制限を超えています。より小さいファイルに分割してください。',
       actions: 'アクション',
       delete: 'ドキュメントを削除',
       fileDeleteSuccess: 'ドキュメントの削除に成功しました',
-      fileDeleteFailed: 'ドキュメントの削除に失敗しました：',
+      fileDeleteFailed: 'ドキュメントの削除に失敗しました',
       processing: '処理中',
       completed: '完了',
       failed: '失敗',
@@ -762,13 +748,10 @@
     content: '内容',
     fileName: 'ファイル名',
     noResults: '検索結果がありません',
-    retrieveError: '検索に失敗しました：',
-    noEnginesAvailable: '利用可能なナレッジエンジンがありません',
-    installEngineHint:
-      '先に「ナレッジエンジン」プラグインをインストールしてください',
+    retrieveError: '検索に失敗しました',
     unknownEngine: '不明なエンジン',
-    loadKnowledgeBaseFailed: 'ナレッジベースの読み込みに失敗しました：',
-    deleteKnowledgeBaseFailed: 'ナレッジベースの削除に失敗しました：',
+    loadKnowledgeBaseFailed: 'ナレッジベースの読み込みに失敗しました',
+    deleteKnowledgeBaseFailed: 'ナレッジベースの削除に失敗しました',
     getKnowledgeBaseListError: 'ナレッジベース一覧の取得に失敗しました：',
     addExternal: '外部ナレッジベースを追加',
     createExternalSuccess: '外部ナレッジベースが正常に作成されました',
@@ -779,23 +762,6 @@
     retrieverConfiguration: '検索器設定',
     retrieverInstallInfo: 'ナレッジ検索器プラグインは',
     retrieverMarketLink: 'こちらからインストールできます',
-    migration: {
-      title: 'ナレッジベースの移行',
-      description:
-        '新バージョンではナレッジベースをプラグインベースのアーキテクチャに再構築し、内蔵ナレッジベースと外部ナレッジベースを「ナレッジエンジン」プラグインとして統合しました。旧ナレッジベースデータの移行が必要です。旧データはデータベースに自動的にバックアップされています。',
-      detected:
-        '移行が必要なナレッジベースが{{total}}件見つかりました（内部{{internal}}件、外部{{external}}件）。',
-      startWithInstall: 'プラグインを自動インストールして移行',
-      startDataOnly: 'データのみ移行',
-      dataOnlyHint:
-        '「データのみ移行」はオフライン環境向けです。移行完了後に対応するプラグインを手動でインストールしてください。',
-      dismiss: '元データを破棄',
-      running: 'ナレッジベースを移行中です。しばらくお待ちください...',
-      success: 'ナレッジベースの移行が完了しました',
-      error: 'ナレッジベースの移行に失敗しました：',
-      dismissError: '操作に失敗しました',
-      retry: 'リトライ',
-    },
   },
   register: {
     title: 'LangBot を初期化 👋',

web/src/i18n/locales/zh-Hans.ts

@@ -47,12 +47,6 @@ const zhHans = {
     copyFailed: '复制失败',
     test: '测试',
     forgotPassword: '忘记密码？',
-    agreementNotice: '继续即表示您同意我们的',
-    privacyPolicy: '隐私政策',
-    and: '和',
-    dataCollectionPolicy: '数据收集政策',
-    dataCollectionPolicyUrl:
-      'https://docs.langbot.app/zh/insight/data-collection-policy',
     loading: '加载中...',
     fieldRequired: '此字段为必填项',
     or: '或',
@@ -227,11 +221,6 @@ const zhHans = {
     modelsCount: '{{count}} 个模型',
     expandModels: '展开',
     collapseModels: '收起',
-    fallback: {
-      primary: '主模型',
-      fallbackList: '备用模型',
-      addFallback: '添加备用模型',
-    },
   },
   bots: {
     title: '机器人',
@@ -479,8 +468,6 @@ const zhHans = {
       noTags: '暂无标签',
     },
     viewDetails: '查看详情',
-    deprecated: '已弃用',
-    deprecatedTooltip: '请安装对应「知识引擎」插件',
   },
   mcp: {
     title: 'MCP',
@@ -692,7 +679,7 @@ const zhHans = {
     updateTime: '更新于',
     cannotChangeEmbeddingModel: '知识库创建后不可修改嵌入模型',
     updateKnowledgeBaseSuccess: '知识库更新成功',
-    updateKnowledgeBaseFailed: '知识库更新失败：',
+    updateKnowledgeBaseFailed: '知识库更新失败',
     documentsTab: {
       name: '名称',
       status: '状态',
@@ -701,13 +688,13 @@ const zhHans = {
       uploading: '上传中...',
       supportedFormats: '支持 PDF、Word、TXT、Markdown、HTML、ZIP 等文档格式',
       uploadSuccess: '文件上传成功！',
-      uploadError: '文件上传失败：',
+      uploadError: '文件上传失败，请重试',
       uploadingFile: '上传文件中...',
       fileSizeExceeded: '文件大小超过 10MB 限制，请分割成较小的文件后上传',
       actions: '操作',
       delete: '删除文件',
       fileDeleteSuccess: '文件删除成功',
-      fileDeleteFailed: '文件删除失败：',
+      fileDeleteFailed: '文件删除失败',
       processing: '处理中',
       completed: '完成',
       failed: '失败',
@@ -728,7 +715,7 @@ const zhHans = {
     content: '内容',
     fileName: '文件名',
     noResults: '暂无结果',
-    retrieveError: '检索失败：',
+    retrieveError: '检索失败',
     unknownEngine: '未知引擎',
     knowledgeEngine: '知识引擎',
     knowledgeEngineRequired: '知识引擎不能为空',
@@ -739,10 +726,10 @@ const zhHans = {
     engineSettingsReadonly: '编辑模式下不可修改',
     retrievalSettings: '检索设置',
     noEnginesAvailable: '没有可用的知识库引擎',
-    installEngineHint: '请先安装「知识引擎」插件',
-    createKnowledgeBaseFailed: '知识库创建失败：',
-    loadKnowledgeBaseFailed: '知识库加载失败：',
-    deleteKnowledgeBaseFailed: '知识库删除失败：',
+    installEngineHint: '请先安装知识库插件',
+    createKnowledgeBaseFailed: '知识库创建失败',
+    loadKnowledgeBaseFailed: '知识库加载失败',
+    deleteKnowledgeBaseFailed: '知识库删除失败',
     getKnowledgeBaseListError: '获取知识库列表失败：',
     embeddingModel: '嵌入模型',
     embeddingModelRequired: '此引擎需要选择嵌入模型',
@@ -755,23 +742,6 @@ const zhHans = {
     retrieverConfiguration: '检索器配置',
     retrieverInstallInfo: '您可以从',
     retrieverMarketLink: '此处安装知识检索器插件',
-    migration: {
-      title: '知识库迁移',
-      description:
-        '新版本已将知识库重构为插件化架构，并统一内置知识库和外部知识库为「知识引擎」插件，需要对旧知识库数据进行迁移。您的旧数据已自动备份在数据库中。',
-      detected:
-        '共检测到 {{total}} 个知识库需要迁移（{{internal}} 个内置知识库，{{external}} 个外部知识库）。',
-      startWithInstall: '自动安装插件并迁移',
-      startDataOnly: '仅迁移数据',
-      dataOnlyHint:
-        '「仅迁移数据」适合内网环境使用，请在迁移完成后自行安装对应插件',
-      dismiss: '丢弃原数据',
-      running: '正在迁移知识库，请稍候...',
-      success: '知识库迁移完成',
-      error: '知识库迁移失败：',
-      dismissError: '操作失败',
-      retry: '重试',
-    },
   },
   register: {
     title: '初始化 LangBot 👋',

web/src/i18n/locales/zh-Hant.ts

@@ -47,12 +47,6 @@ const zhHant = {
     copyFailed: '複製失敗',
     test: '測試',
     forgotPassword: '忘記密碼？',
-    agreementNotice: '繼續即表示您同意我們的',
-    privacyPolicy: '隱私政策',
-    and: '和',
-    dataCollectionPolicy: '數據收集政策',
-    dataCollectionPolicyUrl:
-      'https://docs.langbot.app/zh/insight/data-collection-policy',
     loading: '載入中...',
     fieldRequired: '此欄位為必填',
     or: '或',
@@ -226,11 +220,6 @@ const zhHant = {
     modelsCount: '{{count}} 個模型',
     expandModels: '展開',
     collapseModels: '收起',
-    fallback: {
-      primary: '主模型',
-      fallbackList: '備用模型',
-      addFallback: '新增備用模型',
-    },
   },
   bots: {
     title: '機器人',
@@ -472,8 +461,6 @@ const zhHant = {
       noTags: '暫無標籤',
     },
     viewDetails: '查看詳情',
-    deprecated: '已棄用',
-    deprecatedTooltip: '請安裝對應「知識引擎」插件',
   },
   mcp: {
     title: 'MCP',
@@ -685,7 +672,7 @@ const zhHant = {
     updateTime: '更新於',
     cannotChangeEmbeddingModel: '知識庫建立後不可修改嵌入模型',
     updateKnowledgeBaseSuccess: '知識庫更新成功',
-    updateKnowledgeBaseFailed: '知識庫更新失敗：',
+    updateKnowledgeBaseFailed: '知識庫更新失敗',
     documentsTab: {
       name: '名稱',
       status: '狀態',
@@ -694,13 +681,13 @@ const zhHant = {
       uploading: '上傳中...',
       supportedFormats: '支援 PDF、Word、TXT、Markdown 等文檔格式',
       uploadSuccess: '文檔上傳成功！',
-      uploadError: '文檔上傳失敗：',
+      uploadError: '文檔上傳失敗，請重試',
       uploadingFile: '上傳文檔中...',
       fileSizeExceeded: '檔案大小超過 10MB 限制，請分割成較小的檔案後上傳',
       actions: '操作',
       delete: '刪除文檔',
       fileDeleteSuccess: '文檔刪除成功',
-      fileDeleteFailed: '文檔刪除失敗：',
+      fileDeleteFailed: '文檔刪除失敗',
       processing: '處理中',
       completed: '完成',
       failed: '失敗',
@@ -721,12 +708,10 @@ const zhHant = {
     content: '內容',
     fileName: '文檔名稱',
     noResults: '暫無結果',
-    retrieveError: '檢索失敗：',
-    noEnginesAvailable: '沒有可用的知識庫引擎',
-    installEngineHint: '請先安裝「知識引擎」插件',
+    retrieveError: '檢索失敗',
     unknownEngine: '未知引擎',
-    loadKnowledgeBaseFailed: '知識庫載入失敗：',
-    deleteKnowledgeBaseFailed: '知識庫刪除失敗：',
+    loadKnowledgeBaseFailed: '知識庫載入失敗',
+    deleteKnowledgeBaseFailed: '知識庫刪除失敗',
     getKnowledgeBaseListError: '取得知識庫列表失敗：',
     addExternal: '添加外部知識庫',
     createExternalSuccess: '外部知識庫創建成功',
@@ -737,23 +722,6 @@ const zhHant = {
     retrieverConfiguration: '檢索器配置',
     retrieverInstallInfo: '您可以從',
     retrieverMarketLink: '此處安裝知識檢索器插件',
-    migration: {
-      title: '知識庫遷移',
-      description:
-        '新版本已將知識庫重構為插件化架構，並統一內建知識庫和外部知識庫為「知識引擎」插件，需要對舊知識庫資料進行遷移。您的舊資料已自動備份在資料庫中。',
-      detected:
-        '共檢測到 {{total}} 個知識庫需要遷移（{{internal}} 個內建知識庫，{{external}} 個外部知識庫）。',
-      startWithInstall: '自動安裝插件並遷移',
-      startDataOnly: '僅遷移資料',
-      dataOnlyHint:
-        '「僅遷移資料」適合內網環境使用，請在遷移完成後自行安裝對應插件',
-      dismiss: '丟棄原數據',
-      running: '正在遷移知識庫，請稍候...',
-      success: '知識庫遷移完成',
-      error: '知識庫遷移失敗：',
-      dismissError: '操作失敗',
-      retry: '重試',
-    },
   },
   register: {
     title: '初始化 LangBot 👋',