From 7e5bc5a54338c2a4a5d58914f6abe6982e652c87 Mon Sep 17 00:00:00 2001
From: SengokuCola <1026294844@qq.com>
Date: Fri, 1 May 2026 14:52:19 +0800
Subject: [PATCH 1/9] =?UTF-8?q?pref=EF=BC=9A=E4=BF=AE=E6=94=B9changelog?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 changelogs/changelog.md       | 604 ++++++++++++++++++----------
 changelogs/mai_next_design.md | 732 ----------------------------------
 changelogs/mai_next_todo.md   | 191 ---------
 3 files changed, 404 insertions(+), 1123 deletions(-)
 delete mode 100644 changelogs/mai_next_design.md
 delete mode 100644 changelogs/mai_next_todo.md

diff --git a/changelogs/changelog.md b/changelogs/changelog.md
index b8d00f430a..504cd23ee9 100644
--- a/changelogs/changelog.md
+++ b/changelogs/changelog.md
@@ -1,121 +1,168 @@
-# Changelog
-
-
-## [1.0.0-pre.1] - 2026-4-19
-### 核心功能更新
-### MaiSaka系统
-原生支持多模态模型
-原生支持工具调用，多轮调用和mcp
-升级的replyer回复器，同样支持多模态
-统一群聊与私聊回复链路
-### 记忆系统革新
-引入 A_Memorix 长期记忆系统，替代旧记忆链路
-支持记忆检索、写回、迁移、反馈修正和管理界面
-### 全新插件系统
-提供独立的插件开发SDK
-重构插件系统为 plugin_runtime，提供 RPC、Hook、能力注册、运行时隔离、配置校验、批量重载与旧能力迁移。
-### 全面重构和修复
-新增 platform_io 消息平台抽象与消息中间层，统一消息路由、出站追踪和旧驱动兼容。
-新增统一 services 服务层，集中管理 LLM、生成器、发送、数据库、记忆、Embedding 与 HTML 渲染等能力。
-引入 MCP 与统一工具系统，插件工具和 MCP 工具统一调度，并优化工具展示、索引、重试和失败留档。
-WebUI 后端完成模块化重构，新增统一 WebSocket、插件管理、记忆管理、知识库、配置和监控相关 API。
-配置系统升级，支持旧配置自动迁移、字段类型安全校验、多模态模型配置和更细的工具/回复参数。
-优化表情包、图片、表达方式和黑话学习系统，提升识别、缓存、发送、学习与调用稳定性。
-清理旧插件系统、旧记忆系统、旧回复链路、旧工具系统、旧 WebUI 构建产物和多个废弃内置插件。
-!!预发布版本WebUI暂时不可用
-
-完整更新清单
-核心架构
-大规模重构核心运行结构，新增 src/services 服务层，包括 LLM、生成器、发送、消息、数据库、记忆、HTML 渲染、Embedding 等服务。
-新增统一的 platform_io 消息平台抽象，提供驱动、路由、去重、出站追踪、插件驱动和旧版驱动兼容。
-引入新的消息中间层和网关设计，为插件、适配器、主程序之间的消息流转建立统一基础。
-重构数据模型，新增聊天目标、规划动作、回复生成结果、LLM 服务请求等模型。
-新增数据库迁移管理器，支持迁移进度记录、表级/记录级追踪和旧数据兼容。
-统一机器人识别逻辑，支持多平台场景，包括 WebUI。
-
-MaiSaka / 回复系统
-新增并持续完善 maisaka 主回复链路，逐步接管群聊与私聊回复逻辑。
-新增 planner / replyer / timing / subagent 等运行结构，支持 wait 打断、防抖、重试和状态监控。
-新增 Maisaka 实时聊天流监控、阶段状态面板、控制台工具调用展示、prompt log HTML 预览。
-回复器支持多模态与非多模态统一行为，新增模型 visual 参数，避免非多模态模型误传图片。
-支持复杂消息、转发消息、图片原始数据解析、URL 图片浏览、表情包类消息标记。
-优化上下文压缩，显示实时上下文占用，压缩早期 assistant 信息。
-新增聊天特定额外 prompt、多语言 prompt、prompt 独立文件管理、用户自定义 prompt 与覆盖能力。
-新增工具索引展开方式，压缩工具描述，提高工具调用成功率，修复无参工具、孤儿工具、Gemini tool 等问题。
-新增回复后打分追踪器，用于记录和分析回复效果。
-优化回复频率控制、引用回复概率、打字时间、重复思考、wait 行为和 replyer 空回复处理。
-
-记忆系统 / A_Memorix
-新增并主线化 A_Memorix 长期记忆系统，包含运行时、检索、存储、管理界面和迁移脚本。
-新增记忆测试、检索工具、记忆服务、记忆自动化钩子与写回链路。
-支持将旧 LPMM/旧记忆数据迁移到新长期记忆系统。
-优化记忆检索速度、token 消耗、时间信息、上下文检索方式和人物事实提取。
-新增记忆反馈修正、知识库反馈详情、图存储持久化、总结导入、embedding 维度控制等回归测试。
-移除旧 memory_system 中的大量检索工具与聊天总结逻辑，改由新服务层和 A_Memorix 承担。
-
-插件系统 / Runtime
-大规模替换旧 plugin_system，新增 plugin_runtime。
-新增插件能力注册、组件注册、事件分发、Hook 分发、API 注册、Supervisor、Runner、RPC Server/Client。
-支持插件 manifest 校验、包式插件导入、临时 sys.path 管理、导入保护和模块访问控制。
-新增插件配置版本管理、配置归一化、运行时配置校验、批量插件重载。
-新增插件依赖流水线、HTML 渲染服务、插件 SDK 集成增强。
-新增旧数据库 peewee 兼容层，初步重构插件 database API。
-新增插件侧消息网关能力、出站追踪、会话 ID 计算和适配器回执消息 ID 更新。
-修复 Windows 平台插件运行时信号处理、DLL 导入隔离、包式导入、重载机制等问题。
-限制 maibot-plugin-sdk 版本范围，并升级到 2.3.0 相关适配。
-
-MCP / 工具系统
-新增独立 mcp_module，包含连接、管理、Provider、Host LLM Bridge、Hook 与数据模型。
-引入统一插件与 MCP 工具系统，移除旧工具系统和 tool_use 模型。
-工具支持索引检索、延迟展开、统一控制台展示、失败请求留档与重试分析。
-新增 host LLM bridge，使 MCP 工具和宿主模型调用链路更统一。
-
-WebUI / API
-WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schemas、services、utils 等结构。
-新增统一 WebSocket 连接管理与路由。
-新增聊天、配置、表情包、表达方式、黑话、插件、记忆、知识库、统计、系统等路由重构。
-新增规划器和回复器监控 API、日志搜索、日志上线数量配置、prompt log 预览。
-新增本地已安装插件 README 读取 API、插件安装/配置/运行时管理相关 API。
-新增静态资源包提示和错误处理，后续修复为仅使用包内 WebUI 静态资源。
-修复 knowledgebase 反馈详情类型问题、WebUI memory 路由、配置 schema 测试等问题。
-注意：历史中有大量 dashboard 前端提交和 WebUI dist 迁移/删除，但本次没有修改 dashboard。
-
-配置 / 模型 / 依赖
-配置系统引入 ConfigBase 测试与更严格校验，支持自动检测并升级旧版配置。
-支持 Union / Optional 字段转换，并禁止不安全的多类型 Union。
-新增配置版本到 8.4.0，加入工具筛选、回复器、多模态、Maim Message、日志颜色等配置。
-移除 Planner 问题配置项、无用配置、旧路径显示配置、模板配置文件等冗余项。
-模型配置移除无用模型、utils_small、弃用的 LLM_judge 类型和 tool_use 模型。
-新增模型随机选择策略、模型 visual 参数、OpenAI 兼容性增强。
-修复 Qwen 3.5 空回复、Gemini 请求思考签名、部分模型不支持 gif、OpenAI client 工具请求等问题。
-移除 uv.lock，更新 pyproject.toml / requirements.txt 依赖，最终 HEAD 又移除部分依赖。
-
-表情包 / 图片
-新增表情包系统重构，包含注册、识别、缓存、发送、选择、数据库迁移。
-表情包选择改为一次性选择全部，支持配置，并接入 subagent。
-移除旧内置 emoji 插件，改为 Maisaka 内置动作或新系统能力。
-修复表情包发送无记录、识别失败、缓存问题、图片存储问题、图片过大自动重试等。
-新增异步后台图片/表情处理、图片展示模式优化、复杂消息查看。
-
-表达方式 / 黑话 / 学习
-新增自动表达优化、表达方式检查脚本、表达方式最后修改来源字段。
-修复私聊表达风格随机、表达方式学习与使用、表达方式全局共享。
-新增 planner 黑话缓存，恢复表达学习、黑话学习、黑话使用和表达使用。
-修复黑话提取学习缓存和 Jargon 提取问题。
-新增表达方式快速版本，优化表达方式提取与 LLM 判断标记。
-
-文档 / 国际化 / 工程规范
-更新 README、徽章、快速导航、版本信息和主仓库地址。
-新增/更新 changelog、设计文档、todo、记忆契约文档、Caddy 反向代理与 TLS/SSL 文档。
-新增 AGENTS.md，并更新代码规范、导入顺序、注释规范、语言规范。
-新增 Crowdin 配置和多语言资源，包含中英日韩等 locale。
-新增 CodeRabbit 配置、PR 模板、测试计划和若干调试/迁移脚本。
-新增 agentlite 子项目/模块，包含 agent、tool、provider、skills、MCP、文件/网页/shell 工具和大量测试、示例、文档。
-测试与质量
-
-
-## [0.12.2] - 2026-1-11
-### 功能更改
+# [1.0.0] - 2026-5-2
+
+## 核心功能更新
+
+### MaiSaka / 回复系统
+
+- 原生支持多模态模型、工具调用、多轮工具调用与 MCP。
+- 升级 replyer 回复器，统一群聊与私聊回复链路，并支持多模态回复。
+- 优化能力选择、工具调用和回复生成的稳定性。
+- 支持单独的上下文长度与回复频率控制。
+
+### 记忆系统 / A_Memorix
+
+- 引入并主线化 A_Memorix 长期记忆系统，替代旧记忆链路。
+- 超级优化 A-Mem 记忆算法，显著提升长期记忆检索、写回、迁移和反馈修正能力。
+- 优化长期记忆控制台体验，完善记忆管理、知识库反馈和相关 WebUI 接口。
+
+### 插件系统 / Runtime
+
+- 提供独立插件开发 SDK，并重构插件系统为 plugin_runtime。
+- 插件组件支持按群聊类型启用、按 session_id 启用，以及黑名单/白名单控制。
+- 支持插件对 LLM provider 进行兼容适配。
+
+### WebUI / API
+
+- WebUI 新增或重构聊天组件、人格与表情配置表单、知识库相关界面。
+- API 响应模型与文档完成部分重构。
+- 日志系统新增上限和配置，避免日志持续膨胀。
+
+
+## 完整更新清单
+
+### 核心架构
+
+- 大规模重构核心运行结构，新增 `src/services` 服务层，包括 LLM、生成器、发送、消息、数据库、记忆、HTML 渲染、Embedding 等服务。
+- 新增统一的 `platform_io` 消息平台抽象，提供驱动、路由、去重、出站追踪、插件驱动和旧版驱动兼容。
+- 引入新的消息中间层和网关设计，为插件、适配器、主程序之间的消息流转建立统一基础。
+- 重构数据模型，新增聊天目标、规划动作、回复生成结果、LLM 服务请求、API 响应等模型。
+- 新增数据库迁移管理器，支持迁移进度记录、表级/记录级追踪和旧数据兼容。
+- 统一机器人识别逻辑，支持多平台场景，包括 WebUI。
+
+### MaiSaka / 回复系统
+
+- 新增并持续完善 maisaka 主回复链路，逐步接管群聊与私聊回复逻辑。
+- 新增 planner / replyer / timing / subagent 等运行结构，支持 wait 打断、防抖、重试和状态监控。
+- 新增 Maisaka 实时聊天流监控、阶段状态面板、控制台工具调用展示、prompt log HTML 预览。
+- 精简表达选择逻辑，表达方式模型改为 replyer，并支持开启表达方式简化模式。
+- 回复器支持多模态与非多模态统一行为，新增模型 visual 参数，避免非多模态模型误传图片。
+- 支持复杂消息、转发消息、图片原始数据解析、URL 图片浏览、表情包类消息标记。
+- 优化上下文压缩，显示实时上下文占用，压缩早期 assistant 信息。
+- 私聊支持独立上下文长度和回复频率控制，群聊与私聊链路更统一。
+- 新增聊天特定额外 prompt、多语言 prompt、prompt 独立文件管理、用户自定义 prompt 与覆盖能力。
+- 新增工具索引展开方式和按顺序选择相关能力，压缩工具描述，提高工具调用成功率。
+- 修复无参工具、孤儿工具、Gemini tool、timing gate 非法工具调用等问题。
+- 新增内置 at 动作与原生 @ 能力，可按需关闭引用回复。
+- 新增回复后打分追踪器，用于记录和分析回复效果。
+- 优化回复频率控制、引用回复概率、打字时间、重复思考、wait 行为和 replyer 空回复处理。
+
+### 记忆系统 / A_Memorix
+
+- 新增并主线化 A_Memorix 长期记忆系统，包含运行时、检索、存储、管理界面和迁移脚本。
+- 超级优化 A-Mem 记忆算法，提升检索准确率、长期记忆写回质量和整体稳定性。
+- 新增记忆测试、检索工具、记忆服务、记忆自动化钩子与写回链路。
+- 支持将旧 LPMM/旧记忆数据迁移到新长期记忆系统。
+- 优化记忆检索速度、token 消耗、时间信息、上下文检索方式和人物事实提取。
+- 优化长期记忆控制台体验，提升记忆查看、调试与管理效率。
+- 新增记忆反馈修正、知识库反馈详情、图存储持久化、总结导入、embedding 维度控制等回归测试。
+- 移除旧 `memory_system` 中的大量检索工具与聊天总结逻辑，改由新服务层和 A_Memorix 承担。
+
+### 插件系统 / Runtime
+
+- 大规模替换旧 `plugin_system`，新增 `plugin_runtime`。
+- 新增插件能力注册、组件注册、事件分发、Hook 分发、API 注册、Supervisor、Runner、RPC Server/Client。
+- 插件组件支持按群聊类型启用、按 session_id 启用，以及黑名单/白名单控制。
+- 插件支持通过 msg_id 获取消息，提升插件对上下文消息的追溯能力。
+- 支持插件 manifest 校验、包式插件导入、临时 `sys.path` 管理、导入保护和模块访问控制。
+- 新增插件配置版本管理、配置归一化、运行时配置校验、批量插件重载。
+- 新增插件依赖流水线、HTML 渲染服务、插件 SDK 集成增强。
+- 新增旧数据库 peewee 兼容层，初步重构插件 database API。
+- 新增插件侧消息网关能力、出站追踪、会话 ID 计算和适配器回执消息 ID 更新。
+- 支持插件对 LLM provider 进行兼容适配。
+- 默认禁用示例插件。
+- 修复 Windows 平台插件运行时信号处理、DLL 导入隔离、包式导入、重载机制等问题。
+- 限制 maibot-plugin-sdk 版本范围，并升级到 2.3.0 相关适配。
+
+### MCP / 工具系统
+
+- 新增独立 `mcp_module`，包含连接、管理、Provider、Host LLM Bridge、Hook 与数据模型。
+- 引入统一插件与 MCP 工具系统，移除旧工具系统和 tool_use 模型。
+- 工具支持索引检索、延迟展开、统一控制台展示、失败请求留档与重试分析。
+- 新增 host LLM bridge，使 MCP 工具和宿主模型调用链路更统一。
+- 修复 timing gate 场景下意外启用 tool 的问题。
+
+### 模型 / 缓存 / 配置
+
+- 配置系统引入 ConfigBase 测试与更严格校验，支持自动检测并升级旧版配置。
+- 支持 Union / Optional 字段转换，并禁止不安全的多类型 Union。
+- 更新 config 初始化流程，新增配置版本并加入工具筛选、回复器、多模态、Maim Message、日志颜色等配置。
+- 支持模型请求缓存相关配置，大幅优化缓存命中率，并进一步优化模型缓存命中率。
+- 修改部分模型调用链路，修复部分模型请求问题和 deepseek v4 相关问题。
+- 修复 OpenRouter 和 Groq 的 reasoning 字段支持问题。
+- 修复门控在部分模型出错的问题。
+- 模型配置移除无用模型、utils_small、弃用的 LLM_judge 类型和 tool_use 模型。
+- 新增模型随机选择策略、模型 visual 参数、OpenAI 兼容性增强。
+- visual_style 配置项改为模板内容，人设结构完成调整。
+- 表达方式模型改为 replyer，并可开启简化模式。
+- 移除 Planner 问题配置项、无用配置、旧路径显示配置、模板配置文件和部分内部温度设定。
+- 修复 Qwen 3.5 空回复、Gemini 请求思考签名、部分模型不支持 gif、OpenAI client 工具请求等问题。
+- 移除 uv.lock，更新 pyproject.toml / requirements.txt 依赖，最终 HEAD 又移除部分依赖。
+
+### WebUI / API
+
+- WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schemas、services、utils 等结构。
+- 新增统一 WebSocket 连接管理与路由。
+- 新增或重构聊天组件、人格与表情配置表单、知识库相关界面。
+- 新增聊天、配置、表情包、表达方式、黑话、插件、记忆、知识库、统计、系统等路由重构。
+- 新增规划器和回复器监控 API、日志搜索、日志上限数量配置、prompt log 预览。
+- API 响应模型与文档完成部分重构。
+- 新增本地已安装插件 README 读取 API、插件安装/配置/运行时管理相关 API。
+- 新增静态资源包提示和错误处理，后续修复为仅使用包内 WebUI 静态资源。
+- 修复 knowledgebase 反馈详情类型问题、WebUI memory 路由、配置 schema 测试、回复格式和部分显示问题。
+- 注意：历史中有大量 dashboard 前端提交和 WebUI dist 迁移/删除，但本次没有修改 dashboard。
+
+### 表情包 / 图片
+
+- 新增表情包系统重构，包含注册、识别、缓存、发送、选择、数据库迁移。
+- 表情包选择改为一次性选择全部，支持配置，并接入 subagent。
+- 移除旧内置 emoji 插件，改为 Maisaka 内置动作或新系统能力。
+- 修复表情包发送无记录、识别失败、缓存问题、图片存储问题、图片过大自动重试等。
+- 新增异步后台图片/表情处理、图片展示模式优化、复杂消息查看。
+
+### 表达方式 / 黑话 / 学习
+
+- 新增自动表达优化、表达方式检查脚本、表达方式最后修改来源字段。
+- 表达方式模型改为 replyer，表达选择逻辑进一步精简，优化 replyer 表现。
+- 表达方式支持开启简化模式。
+- 修复私聊表达风格随机、表达方式学习与使用、表达方式全局共享。
+- 新增 planner 黑话缓存，恢复表达学习、黑话学习、黑话使用和表达使用。
+- 修复黑话提取学习缓存和 Jargon 提取问题。
+- 新增表达方式快速版本，优化表达方式提取与 LLM 判断标记。
+
+### 日志 / 部署 / 工程
+
+- 日志系统新增上限和配置，避免日志膨胀。
+- 溢出部分冗余 log，减少运行时噪音。
+- 修复 Docker 非交互模式无法启动的问题。
+- 优化部分导入，加快启动速度。
+- 更新 README、徽章、快速导航、版本信息和主仓库地址。
+- 新增/更新 changelog、设计文档、todo、记忆契约文档、Caddy 反向代理与 TLS/SSL 文档。
+- 新增 AGENTS.md，并更新代码规范、导入顺序、注释规范、语言规范。
+- 新增 Crowdin 配置和多语言资源，包含中英日韩等 locale。
+- 新增 CodeRabbit 配置、PR 模板、测试计划和若干调试/迁移脚本。
+- 新增 agentlite 子项目/模块，包含 agent、tool、provider、skills、MCP、文件/网页/shell 工具和大量测试、示例、文档。
+- 添加 astrbot 友链之粉毛必定女装。
+
+
+
+
+
+
+
+# [0.12.2] - 2026-1-11
+
+## 功能更改
+
 - 优化私聊wait逻辑
 - 超时时强制引用回复
 - 修复部分适配器断联问题
@@ -123,21 +170,26 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 优化记忆检索逻辑
 - 更新readme
 
-## [0.12.1] - 2025-12-31
-### 🌟 主要更新
+# [0.12.1] - 2025-12-31
+
+## 🌟 主要更新
+
 - 添加年度总结！可以在webui查看
 - 可选让llm判定引用回复
 - 表达方式优化！现在可以进行自动和手动评估，使其更精准
 - 回复和规划记录！webui可以查看每一条回复和plan的详情
 
-### 细节功能更改
+## 细节功能更改
+
 - 优化间隔过长消息的显示
 - enable_jargon_detection
 - global_memory_blacklist。指定部分群聊不参与全局记忆
 - 移除utils_small模型，移除弃用的lpmm模型
 
-## [0.12.0] - 2025-12-21
-### 🌟 重大更新
+# [0.12.0] - 2025-12-21
+
+## 🌟 重大更新
+
 - 添加思考力度机制，动态控制回复时间和长度
 - planner和replyer现在开启联动，更好的回复逻辑
 - 新的私聊系统，吸收了pfc的优秀机制
@@ -145,13 +197,15 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - mcp插件作为内置插件加入，默认不启用
 - 添加全局记忆配置项，现在可以选择让记忆为全局的
 
-### 🌟 WebUI 重大更新
+## 🌟 WebUI 重大更新
+
 - **模型预设市场功能正式完善并发布**：现在可以将模型配置完整分享，分享按钮位于模型配置界面右上角
 - **全面安全加固**：为所有 WebUI API 和 WebSocket 端点添加身份认证保护，Cookie 添加 Secure 和 SameSite 属性，支持环境感知动态配置
 - **前端认证重构**：从 localStorage 迁移到 HttpOnly Cookie，新增 WebSocket 临时 token 认证机制，解决跨域开发环境下 Cookie 无法携带的问题
 - **增强插件配置管理**：支持原始 TOML 配置的加载和保存，前端支持查看和编辑插件配置文件源文件
 
-### 细节功能更改
+## 细节功能更改
+
 - 移除频率自动调整
 - 移除情绪功能
 - 优化记忆差许多呢超时设置
@@ -172,8 +226,10 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 修复并优化了聊天室、模型配置、日志查看器、黑话管理、WebUI 端口占用、配置向导、首页图表、聊天室消息重复、移动端日志不可见、模型提供商删除、主程序配置换行符、HTTP 警告横幅、重启界面、LPMM 配置、人物信息、插件端点安全认证、WebSocket token 等问题，提升整体稳定性与体验。
 - 完成主程序配置与模型配置界面重构、模型提供商与麦麦适配器配置重构（引入 TOML 校验）、WebSocket 认证逻辑抽取为共享模块统一 WS 端点，升级 React 到 19.2.1 并更新依赖，WebUI 配置与可视化全部迁移到主配置及模型配置中，优化配置更新提示、插件详情页面和路径安全校验，并增强模型与梦境等多项配置的可视化和自动检验。
 
-## [0.11.6] - 2025-12-2
+# [0.11.6] - 2025-12-2
+
 ### 🌟 重大更新
+
 - 大幅提高记忆检索能力，略微提高token消耗
 - 重构历史消息概括器，更好的主题记忆
 - 日志查看器性能革命性优化
@@ -186,6 +242,7 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - WebUI新增黑话管理 & 编辑界面
 
 ### 细节功能更改
+
 - 可选记忆识别中是否启用jargon
 - 解耦表情包识别和图片识别
 - 修复部分破损json的解析问题
@@ -194,6 +251,7 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 新增Lpmm可视化
 
 ### webui细节更新
+
 - 修复侧边栏收起、UI及表格横向滚动等问题，优化Toast动画
 - 修复适配器配置、插件克隆、表情包注册等相关BUG
 - 新增适配器/模型预设模式及模板，自动填写URL和类型
@@ -219,14 +277,17 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 新增表达反思设置和WebUI聊天室“思考中”占位组件
 - 细节如移除部分字段或UI控件、优化按钮/弹窗/编辑逻辑等
 
-## [0.11.5] - 2025-11-21
+# [0.11.5] - 2025-11-21
+
 ### 🌟 重大更新
+
 - WebUI 现支持手动重启麦麦，曲线救国版“热重载”
 - 新增麦麦 QQ 适配器可视化编辑 UI（独立进程，需手动上传/下载并覆盖适配器文件）
 - 麦麦主程序配置支持可视化模式与源代码模式双模式编辑，后端执行 TOML 校验
 - 优化 planner 与 replyer 协同机制，调试日志更细
 
 ### 新增
+
 - 表情包管理、人物信息管理、表达方式管理界面手机端适配
 - 配置页“重启麦麦”提示
 - 详细的debug prompt显示配置
@@ -234,6 +295,7 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 前端集成 CodeMirror（Python/JSON/TOML 语法高亮）并对 JSON 配置提供自动纠错提示
 
 ### 修复
+
 - 表情包缩略图过小
 - 添加模型后无法立即显示
 - 插件市场分类错误
@@ -250,11 +312,13 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 移除前端 TOML 解析库导致的兼容问题
 
 ### 优化
+
 - 首页加载用户体验
 - 首页加载速度（9s → <1s）
 - 整个界面的初屏加载速度
 
 ### 更新
+
 - 适配器配置支持上传模式与指定路径模式；指定路径模式可免去反复上传/下载配置文件
 - 适配器配置界面标签页响应式优化，小屏仅显示简短标签
 - 麦麦资源管理所有界面的批量删除能力
@@ -262,8 +326,10 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 插件市场新增点赞、点踩、评分与下载量统计（基于 Cloudflare，保证国内可访问）
 - 麦麦表情包查看界面的描述部分支持 Markdown 渲染
 
-## [0.11.4] - 2025-11-19
+# [0.11.4] - 2025-11-19
+
 ### 🌟 主要更新内容
+
 - **首个官方 Web 管理界面上线**：在此版本之前，MaiBot 没有 WebUI，所有配置需手动编辑 TOML 文件
 - **认证系统**：Token 安全登录（支持系统生成 64 位随机令牌 / 自定义 Token），首次配置向导
 - **配置管理（可视化编辑，无需手动改 TOML）**：
@@ -290,6 +356,7 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - **全局搜索**：Cmd/Ctrl + K 快捷键，快速跳转任意页面
 
 ### 细节
+
 - **技术栈**：
   - 前端: React 19 + TypeScript + Vite + TanStack Router + shadcn/ui
   - 后端: FastAPI + Uvicorn + WebSocket
@@ -298,12 +365,14 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
   - `WEBUI_ENABLED=true`
   - `WEBUI_MODE=production`
 - **WebUI 开源协议**：GPLv3
-- **WebUI 地址**：https://github.com/Mai-with-u/MaiBot-Dashboard
+- **WebUI 地址**：[https://github.com/Mai-with-u/MaiBot-Dashboard](https://github.com/Mai-with-u/MaiBot-Dashboard)
 
 告别手动编辑配置文件，享受现代化图形界面！
 
-## [0.11.3] - 2025-11-18
+# [0.11.3] - 2025-11-18
+
 ### 功能更改和修复
+
 - 优化记忆提取策略
 - 优化黑话提取
 - 优化表达方式学习
@@ -313,20 +382,24 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 提示：清理旧的记忆数据和表达方式，表现更好
 方法：删除数据库中 expression jargon 和 thinking_back 的全部内容
 
-## [0.11.2] - 2025-11-16
+# [0.11.2] - 2025-11-16
+
 ### 🌟 主要功能更改
+
 - "海马体Agent"记忆系统上线，最新最好的记忆系统，默认已接入lpmm
 - 添加黑话jargon学习系统
 - 添加群特殊Prompt系统
 - 优化直接提及时的回复速度
 
 ### 细节功能更改
+
 - 添加 WebUI 模块及相关 API 路由和 Token 管理功能
 - 可通过海马体Agent记录和查询群昵称
 - 添加聊天记录总结模块
 - 添加大量新统计指标
 
 ### 功能更改和修复
+
 - 移除表达方式学习上限限制
 - 移除部分未使用代码
 - 移除问题追踪和旧版记忆
@@ -353,16 +426,19 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 修复(bot): 恢复戳一戳正常响应
 - 提供更多细节debug配置
 
-## [0.11.1] - 2025-11-4
+# [0.11.1] - 2025-11-4
+
 ### 功能更改和修复
+
 - 记忆现在能够被遗忘，并且拥有更好的合并
 - 修复部分llm请求问题
 - 优化记忆提取
 - 提供replyer的细节debug配置
 
+# [0.11.0] - 2025-10-27
 
-## [0.11.0] - 2025-10-27
 ### 🌟 主要功能更改
+
 - 重构记忆系统，新的记忆系统更可靠，双通道查询，可以查询文本记忆和过去聊天记录
 - 主动发言功能，麦麦会自主提出问题（可精细调控频率）
 - 支持多重人格设定，可以随机切换成不同状态
@@ -372,8 +448,8 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 添加deepthink插件（默认关闭），让麦麦可以深度思考一些问题
 - 现已内置BetterFrequency插件
 
-
 ### 细节功能更改
+
 - 修复配置文件转义问题
 - 情绪系统现在可以由配置文件控制开关
 - 修复平行动作控制失效的问题
@@ -389,8 +465,10 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 修改默认推荐模型为ds v3.2
 - 优化了对gemini和不同模型的支持，优化了对gemini搜索的支持
 
-## [0.10.3] - 2025-9-22
+# [0.10.3] - 2025-9-22
+
 ### 🌟 主要功能更改
+
 - planner支持多动作，移除Sub_planner
 - 移除激活度系统，现在回复完全由planner控制
 - 现可自定义planner行为，更优化的聊天频率控制
@@ -399,6 +477,7 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 更好的event系统，正式建立
 
 ### 细节功能更改
+
 - 支持所有表达方式互通
 - 现可使用付费嵌入模型
 - 添加多种发送类型
@@ -407,27 +486,30 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 加入brainchat模式，为私聊支持做准备
 - 修复qq号格式
 
+# [0.10.2] - 2025-8-31
 
-
-## [0.10.2] - 2025-8-31
 ### 🌟 主要功能更改
+
 - 精简了人格相关配置，提供更清晰，有效的自定义
 - 大幅优化了聊天逻辑，更易配置，动态控制
 - 现在支持提及100%回复
 
 ### 细节功能更改
+
 - 更好的event系统
 - 记忆系统优化
 - 为空回复添加重试机制
 - 修复tts插件可能的复读问题
 
+# [0.10.1] - 2025-8-24
 
-## [0.10.1] - 2025-8-24
 ### 🌟 主要功能更改
+
 - planner现在改为大小核结构，移除激活阶段，提高回复速度和动作调用精准度
 - 优化关系的表现的效率
 
 ### 细节功能更改
+
 - 优化识图的表现
 - 为planner添加单独控制的提示词
 - 修复激活值计算异常的BUG
@@ -438,9 +520,10 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 重构内部代码
 - 暂时禁用记忆
 
+# [0.10.0] - 2025-8-18
 
-## [0.10.0] - 2025-8-18
 ### 🌟 主要功能更改
+
 - 优化的回复生成，现在的回复对上下文把控更加精准
 - 新的回复逻辑控制，现在合并了normal和focus模式，更加统一
 - 优化表达方式系统，现在学习和使用更加精准
@@ -451,37 +534,44 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - **警告所有插件开发者：插件系统即将迎来不稳定时期，随时会发动更改。**
 
 #### 🔧 工具系统重构
+
 - **工具系统整合**: 工具系统现在完全合并到插件系统中，提供统一的扩展能力
 - **工具启用控制**: 支持配置是否启用特定工具，提供更人性化的直接调用方式
 - **配置文件读取**: 工具现在支持读取配置文件，增强配置灵活性
 
 #### 🚀 LLM系统全面重构
+
 - **LLM Request重构**: 彻底重构了整个LLM Request系统，现在支持模型轮询和更多灵活的参数
 - **模型配置升级**: 同时重构了整个模型配置系统，升级需要重新配置llm配置文件
 - **任务类型支持**: 新增任务类型和能力字段至模型配置，增强模型初始化逻辑
 - **异常处理增强**: 增强LLMRequest类的异常处理，添加统一的模型异常处理方法
 
 #### 🔌 插件系统稳定化
+
 - **插件系统重构完成**: 随着LLM Request的重构，插件系统彻底重构完成，进入稳定状态
 - **API扩展**: 仅增加新的API，保持向后兼容性
 - **插件管理优化**: 让插件管理配置真正有用，提升管理体验
 
 #### 💾 记忆系统优化
+
 - **及时构建**: 记忆系统再优化，现在及时构建，并且不会重复构建
 - **精确提取**: 记忆提取更精确，提升记忆质量
 
 #### 🎭 表达方式系统
+
 - **表达方式记录**: 记录使用的表达方式，提供更好的学习追踪
 - **学习优化**: 优化表达方式提取，修复表达学习出错问题
 - **配置优化**: 优化表达方式配置和逻辑，提升系统稳定性
 
 #### 🔄 聊天系统统一
+
 - **normal和focus合并**: 彻底合并normal和focus，完全基于planner决定target message
 - **no_reply内置**: 将no_reply功能移动到主循环中，简化系统架构
 - **回复优化**: 优化reply，填补缺失值，让麦麦可以回复自己的消息
 - **频率控制API**: 加入聊天频率控制相关API，提供更精细的控制
 
 #### 日志系统改进
+
 - **日志颜色优化**: 修改了log的颜色，更加护眼
 - **日志清理优化**: 修复了日志清理先等24h的问题，提升系统性能
 - **计时定位**: 通过计时定位LLM异常延时，提升问题排查效率
@@ -489,27 +579,30 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 ### 🐛 问题修复
 
 #### 代码质量提升
+
 - **lint问题修复**: 修复了lint爆炸的问题，代码更加规范了
 - **导入优化**: 修复导入爆炸和文档错误，优化代码结构
 
 #### 系统稳定性
+
 - **循环导入**: 修复了import时循环导入的问题
 - **并行动作**: 修复并行动作炸裂问题，提升并发处理能力
 - **空响应处理**: 空响应就raise，避免系统异常
 
 #### 功能修复
+
 - **API问题**: 修复api问题，提升系统可用性
 - **notice问题**: 为组件方法提供新参数，暂时解决notice问题
 - **关系构建**: 修复不认识的用户构建关系问题
 - **流式解析**: 修复流式解析越界问题，避免空choices的SSE帧错误
 
 #### 配置和兼容性
+
 - **默认值**: 添加默认值，提升配置灵活性
 - **类型问题**: 修复类型问题，提升代码健壮性
 - **配置加载**: 优化配置加载逻辑，提升系统启动稳定性
 
-
-## [0.9.1] - 2025-7-26
+# [0.9.1] - 2025-7-26
 
 ### 主要修复和优化
 
@@ -530,20 +623,22 @@ WebUI 后端整体重构，拆分为 app、依赖、中间件、routers、schema
 - 修复部分模型由于enable_thinking导致的400问题
 - 移除dependency_manager
 
-
-## [0.9.0] - 2025-7-24
+# [0.9.0] - 2025-7-24
 
 ### 摘要
+
 MaiBot 0.9.0 重磅升级！本版本带来两大核心突破：**全面重构的插件系统**提供更强大的扩展能力和管理功能；**normal和focus模式统一化处理**大幅简化架构并提升性能。同时新增s4u prompt模式优化、语音消息支持、全新情绪系统和mais4u直播互动功能，为MaiBot带来更自然、更智能的交互体验！
 
 ### 🌟 主要功能概览
 
 #### 🔌 插件系统全面重构 - 重点升级
+
 - **完整管理API**: 全新的插件管理API，支持插件的启用、禁用、重载和卸载操作
 - **权限控制系统**: 为插件管理增加完善的权限控制，确保系统安全性
 - **智能依赖管理**: 优化插件依赖管理和自动注册机制，减少配置复杂度
 
 #### ⚡ Normal和Focus模式统一化处理 - 重点升级
+
 - **架构统一**: 彻底统一normal和focus聊天模式，消除模式间的差异和复杂性
 - **智能模式切换**: 优化频率控制和模式切换逻辑，normal可以无缝切换到focus
 - **统一LLM激活**: normal模式现在支持LLM激活插件，与focus模式功能对等
@@ -551,38 +646,45 @@ MaiBot 0.9.0 重磅升级！本版本带来两大核心突破：**全面重构
 - **统一退出机制**: 为focus提供更合理的退出方法，简化状态管理
 
 #### 🎯 s4u prompt模式
+
 - **s4u prompt模式**: 新增专门的s4u prompt构建方式，提供更好的交互效果
 - **配置化启用**: 可在配置文件中选择启用s4u prompt模式，灵活控制
 - **兼容性保持**: 与现有系统完全兼容，可随时切换启用或禁用
 
 #### 🎤 语音消息支持
+
 - **Voice消息处理**: 新增对voice类型消息的支持，麦麦现在可以识别和处理语音消息（需要模型配置）
 
 #### 全新情绪系统
-- **持续情绪**: 麦麦现在拥有持续的情绪状态，情绪会影响回复风格和行为
 
+- **持续情绪**: 麦麦现在拥有持续的情绪状态，情绪会影响回复风格和行为
 
 ### 💻 更新预览
 
 #### 关系系统优化
+
 - **prompt优化**: 优化关系prompt和person_info信息展示
 - **构建间隔**: 让关系构建间隔可配置，提升灵活性
 - **关系配置**: 优化关系配置，采用和focus一致的关系构建
 
 #### 表情包系统升级
+
 - **识别增强**: 加强emoji的识别能力，优化emoji显示
 - **匹配精准**: 更精准的表情包匹配算法
 
 #### 完善mais4u系统（需要amaidesu支持）
+
 - **直播互动**: 新增mais4u直播功能，支持实时互动和思考状态展示
 - **动作控制**: 支持眨眼、微动作、注视等多种动作适配
 
 #### 日志系统优化
+
 - **显示优化**: 优化Logger前缀映射、颜色格式和计时信息显示
 - **级别优化**: 优化日志级别和信息过滤，提升调试体验
 - **日志查看器**: 升级logger_viewer，移除无用脚本
 
 #### 配置系统改进
+
 - **配置简化**: 简化配置文件，让配置更加精简易懂
 - **prompt显示**: 可选打开prompt显示功能
 - **配置更新**: 更好的配置文件更新机制和更新内容显示
@@ -598,8 +700,7 @@ MaiBot 0.9.0 重磅升级！本版本带来两大核心突破：**全面重构
 - 移除observation和processor等冗余组件，大幅简化focus代码逻辑
 - 修复了LPMM的学习问题
 
-
-## [0.8.1] - 2025-7-5
+# [0.8.1] - 2025-7-5
 
 功能更新:
 
@@ -620,7 +721,7 @@ MaiBot 0.9.0 重磅升级！本版本带来两大核心突破：**全面重构
 - 修复表达器无法读取原始文本
 - 修复normal planner没有超时退出问题
 
-## [0.8.0] - 2025-6-27
+# [0.8.0] - 2025-6-27
 
 MaiBot 0.8.0 现已推出！
 
@@ -638,6 +739,7 @@ MaiBot 0.8.0 现已推出！
 MMC启动速度加快
 
 ### 🔌 插系统正式推出
+
 **全面重构的插件生态系统，支持强大 的扩展能力**
 
 - **插件API重构**: 全面重构插件系统，统一加载机制，区分内部插件和外部插件
@@ -649,10 +751,13 @@ MMC启动速度加快
 - **文档完善**: 补全插件API文档，提供详细的开发指南
 
 ### 👥 人物印象系统
+
 **麦麦现在能认得群友，记住每个人的特点**
+
 - **人物侧写功能**: 加入了人物侧写！麦麦现在能认得群友，新增用户侧写功能，将印象拆分为多方面特点
 
 ### ⚡ Focus模式大幅优化 - 降低Token消耗与提升速度
+
 - **Planner架构更新**: 更新planner架构，大大加快速度和表现效果！
 - **处理器重构**: 
   - 移除冗余处理器
@@ -660,65 +765,72 @@ MMC启动速度加快
   - 后置工具处理器，大大减少token消耗
 - **统计系统**: 提供focus统计功能，可查看详细的no_action统计信息
 
-
 ### ⏰ 聊天频率精细控制
+
 **支持时段化的精细频率管理，让麦麦在合适的时间说合适的话**
+
 - **时段化控制**: 添加时段talk_frequency控制，支持不同时间段不同群聊的精细频率管理
 - **严格频率控制**: 实现更加严格和可靠的频率控制机制
 - **Normal模式优化**: 大幅优化normal模式的频率控制逻辑，提升回复的智能性
 
 ### 🎭 表达方式系统大幅优化
+
 **智能学习群友聊天风格，让麦麦的表达更加多样化**
+
 - **智能学习机制**: 优化表达方式学习算法，支持衰减机制，太久没学的会被自动抛弃
 - **表达方式选择**: 新增表达方式选择器，让表达使用更合理
 - **跨群互通配置**: 表达方式现在可以选择在不同群互通或独立
 - **可视化工具**: 提供表达方式可视化脚本和检查脚本
 
 ### 💾 记忆系统改进
+
 **更快的记忆处理和更好的短期记忆管理**
+
 - **海马体优化**: 大大优化海马体同步速度，提升记忆处理效率
 - **工作记忆升级**: 精简升级工作记忆模块，提供更好的短期记忆管理
 - **聊天记录构建**: 优化聊天记录构建方式，提升记忆提取效率
 
 ### 📊 日志系统重构
+
 **使用structlog提供更好的结构化日志**
+
 - **structlog替换**: 使用structlog替代loguru，提供更好的结构化日志
 - **日志查看器**: 新增日志查看脚本，支持更好的日志浏览
 - **可配置日志**: 提供可配置的日志级别和格式，支持不同环境的需求
 
 ### 🎯 其他改进
+
 - **emoji系统**: 移除emoji默认发送模式，优化表情包审查功能
 - **控制台发送**: 添加不完善的控制台发送功能
 - **行为准则**: 添加贡献者契约行为准则
 - **图像清理**: 自动清理images文件夹，优化存储空间使用
 
+# [0.7.0] -2025-6-1
 
-
-
-## [0.7.0] -2025-6-1
 - 你可以选择normal,focus和auto多种不同的聊天方式。normal提供更少的消耗，更快的回复速度。focus提供更好的聊天理解，更多工具使用和插件能力
 - 现在，你可以自定义麦麦的表达方式，并且麦麦也可以学习群友的聊天风格（需要在配置文件中打开）
 - 不再需要繁琐的安装MongoDB！弃用MongoDB，采用轻量sqlite,无需额外安装（提供数据迁移脚本）
 - focus模式初步支持了插件，我们提供了两个示例插件（需要手动启用），可以让麦麦实现更丰富的操作。禁言插件和豆包绘图插件是示例用插件。
 
 **重构专注聊天(HFC - focus_chat)**
+
 - 模块化设计，可以自定义不同的部件
-   - 观察器（获取信息）
-   - 信息处理器（处理信息）
-      - 重构：聊天思考（子心流）处理器
-      - 重构：聊天处理器
-      - 重构：聊天元信息处理器
-      - 重构：工具处理器
-      - 新增：工作记忆处理器
-      - 新增：自我认知处理器
-      - 新增：动作处理器
-   - 决策器（选择动作）
-   - 执行器（执行动作）
-      - 回复动作
-      - 不回复动作
-      - 退出HFC动作
-      - 插件：禁言动作
-   - 表达器：装饰语言风格
+  - 观察器（获取信息）
+  - 信息处理器（处理信息）
+    - 重构：聊天思考（子心流）处理器
+    - 重构：聊天处理器
+    - 重构：聊天元信息处理器
+    - 重构：工具处理器
+    - 新增：工作记忆处理器
+    - 新增：自我认知处理器
+    - 新增：动作处理器
+  - 决策器（选择动作）
+  - 执行器（执行动作）
+    - 回复动作
+    - 不回复动作
+    - 退出HFC动作
+    - 插件：禁言动作
+  - 表达器：装饰语言风格
 - 可通过插件添加和自定义HFC部件（目前只支持action定义）
 - 为专注模式添加关系线索
 - 在专注模式下，麦麦可以决定自行发送语音消息（需要搭配tts适配器）
@@ -727,37 +839,44 @@ MMC启动速度加快
 - 可自定义处理器超时时间
 
 **优化普通聊天(normal_chat)**
+
 - 添加可学习的表达方式
 - 增加了talk_frequency参数来有效控制回复频率
 - 优化了进入和离开normal_chat的方式
 - 添加时间信息
 
 **新增表达方式学习**
+
 - 麦麦配置单独表达方式
 - 自主学习群聊中的表达方式，更贴近群友
 - 可自定义的学习频率和开关
 - 根据人设生成额外的表达方式
 
 **聊天管理**
+
 - 移除不在线状态
 - 优化自动模式下normal与focus聊天的切换机制
 - 大幅精简聊天状态切换规则，减少复杂度
 - 移除聊天限额数量
 
 **插件系统**
+
 - 示例插件：禁言插件
 - 示例插件：豆包绘图插件
 
 **人格**
+
 - 简化了人格身份的配置
 - 优化了在focus模式下人格的表现和稳定性
 
 **数据库重构**
+
 - 移除了默认使用MongoDB，采用轻量sqlite
 - 无需额外安装数据库
 - 提供迁移脚本
 
 **优化**
+
 - 移除日程系统，减少幻觉（将会在未来版本回归）
 - 移除主心流思考和LLM进入聊天判定
 - 支持qwen3模型，支持自定义是否思考和思考长度
@@ -765,47 +884,54 @@ MMC启动速度加快
 - 添加配置项
 - 添加临时配置文件读取器
 
+# [0.6.3-fix-4] - 2025-5-18
 
-## [0.6.3-fix-4] - 2025-5-18
 - 0.6.3 的最后一个修复版
 
 ### fix1-fix4修复日志
+
 **聊天状态**
-   - 大幅精简聊天状态切换，提高麦麦说话能力
-   - 移除OFFLINE和ABSENT状态
-   - 移除聊天数量限制
-   - 聊天默认normal_chat
-   - 默认关闭focus_chat
+
+- 大幅精简聊天状态切换，提高麦麦说话能力
+- 移除OFFLINE和ABSENT状态
+- 移除聊天数量限制
+- 聊天默认normal_chat
+- 默认关闭focus_chat
 
 **知识库LPMM**
-   - 增加嵌入模型一致性校验功能
-   - 强化数据导入处理，增加非法文段检测功能
-   - 修正知识获取逻辑，调整相关性输出顺序
-   - 添加数据导入的用户确认删除功能
+
+- 增加嵌入模型一致性校验功能
+- 强化数据导入处理，增加非法文段检测功能
+- 修正知识获取逻辑，调整相关性输出顺序
+- 添加数据导入的用户确认删除功能
 
 **专注模式**
-   - 默认提取记忆，优化记忆表现
-   - 添加心流查重
-   - 为复读增加硬限制
-   - 支持获取子心流循环信息和状态的API接口
-   - 优化工具调用的信息获取与缓存
+
+- 默认提取记忆，优化记忆表现
+- 添加心流查重
+- 为复读增加硬限制
+- 支持获取子心流循环信息和状态的API接口
+- 优化工具调用的信息获取与缓存
 
 **表情包系统**
-   - 优化表情包识别和处理
-   - 提升表情匹配逻辑
+
+- 优化表情包识别和处理
+- 提升表情匹配逻辑
 
 **日志系统**
-   - 优化日志样式配置
-   - 添加丰富的追踪信息以增强调试能力
+
+- 优化日志样式配置
+- 添加丰富的追踪信息以增强调试能力
 
 **API**
-   - 添加GraphQL路由支持
-   - 新增强制停止MAI Bot的API接口
 
+- 添加GraphQL路由支持
+- 新增强制停止MAI Bot的API接口
 
-## [0.6.3] - 2025-4-15
+# [0.6.3] - 2025-4-15
 
 ### 摘要
+
 - MaiBot 0.6.3 版本发布！核心重构回复逻辑，统一为心流系统管理，智能切换交互模式。
 - 引入全新的 LPMM 知识库系统，大幅提升信息获取能力。
 - 新增昵称系统，改善群聊中的身份识别。
@@ -813,12 +939,14 @@ MMC启动速度加快
 - 优化日志输出，修复若干问题。
 
 ### 🌟 核心功能增强
+
 #### 统一回复逻辑 (Unified Reply Logic)
+
 - **核心重构**: 移除了经典 (Reasoning) 与心流 (Heart Flow) 模式的区分，将回复逻辑完全整合到 `SubHeartflow` 中进行统一管理，由主心流统一调控。保留 Heart FC 模式的特色功能。
 - **智能交互模式**: `SubHeartflow` 现在可以根据情境智能选择不同的交互模式：
-    - **普通聊天 (Normal Chat)**: 类似于之前的 Reasoning 模式，进行常规回复（激活逻辑暂未改变）。
-    - **心流聊天 (Heart Flow Chat)**: 基于改进的 PFC 模式，能更好地理解上下文，减少重复和认错人的情况，并支持**工具调用**以获取额外信息。
-    - **离线模式 (Offline/Absent)**: 在特定情况下，麦麦可能会选择暂时不查看或回复群聊消息。
+  - **普通聊天 (Normal Chat)**: 类似于之前的 Reasoning 模式，进行常规回复（激活逻辑暂未改变）。
+  - **心流聊天 (Heart Flow Chat)**: 基于改进的 PFC 模式，能更好地理解上下文，减少重复和认错人的情况，并支持**工具调用**以获取额外信息。
+  - **离线模式 (Offline/Absent)**: 在特定情况下，麦麦可能会选择暂时不查看或回复群聊消息。
 - **状态管理**: 交互模式的切换由 `SubHeartflow` 内部逻辑和 `SubHeartflowManager` 根据整体状态 (`MaiState`) 和配置进行管理。
 - **流程优化**: 拆分了子心流的思考模块，使整体对话流程更加清晰。
 - **状态判断改进**: 将 CHAT 状态判断交给 LLM 处理，使对话更自然。
@@ -826,15 +954,18 @@ MMC启动速度加快
 - **重复性检查**: 加入心流回复重复性检查机制，防止麦麦陷入固定回复模式。
 
 #### 全新知识库系统 (New Knowledge Base System - LPMM)
+
 - **引入 LPMM**: 新增了 **LPMM (Large Psychology Model Maker)** 知识库系统，具有强大的信息检索能力，能显著提升麦麦获取和利用知识的效率。
 - **功能集成**: 集成了 LPMM 知识库查询功能，进一步扩展信息检索能力。
 - **推荐使用**: 强烈建议使用新的 LPMM 系统以获得最佳体验。旧的知识库系统仍然可用作为备选。
 
 #### 昵称系统 (Nickname System)
+
 - **自动取名**: 麦麦现在会尝试给群友取昵称，减少对易变的群昵称的依赖，从而降低认错人的概率。
 - **持续完善**: 该系统目前仍处于早期阶段，会持续进行优化。
 
 #### 记忆与上下文增强 (Memory and Context Enhancement)
+
 - **聊天记录压缩**: 大幅优化聊天记录压缩系统，使机器人能够处理5倍于之前的上下文记忆量。
 - **长消息截断**: 新增了长消息自动截断与模糊化功能，随着时间推移降低超长消息的权重，避免被特定冗余信息干扰。
 - **记忆提取**: 优化记忆提取功能，提高对历史对话的理解和引用能力。
@@ -843,10 +974,12 @@ MMC启动速度加快
 - **Prompt 优化**: 进一步优化了关系系统和记忆系统相关的提示词（prompt）。
 
 #### 私聊 PFC 功能增强 (Private Chat PFC Enhancement)
+
 - **功能修复与优化**: 修复了私聊 PFC 载入聊天记录缺失的 bug，优化了 prompt 构建，增加了审核机制，调整了重试次数，并将机器人发言存入数据库。
 - **实验性质**: 请注意，PFC 仍然是一个实验性功能，可能在未来版本中被修改或移除，目前不接受相关 Bug 反馈。
 
 #### 情感与互动增强 (Emotion and Interaction Enhancement)
+
 - **全新表情包系统**: 新的表情包系统上线，表情含义更丰富，发送更快速。
 - **表情包使用优化**: 优化了表情包的选择逻辑，减少重复使用特定表情包的情况，使表达更生动。
 - **提示词优化**: 优化提示词（prompt）构建，增强对话质量和情感表达。
@@ -854,44 +987,56 @@ MMC启动速度加快
 - **颜文字保护**: 保护颜文字处理机制，确保表情正确显示。
 
 #### 工具与集成 (Tools and Integration)
+
 - **动态更新**: 使用工具调用来更新关系和心情，取代原先的固定更新机制。
 - **智能调用**: 工具调用时会考虑上下文，使调用更加智能。
 - **知识库依赖**: 添加 LPMM 知识库依赖，扩展知识检索工具。
 
 ### 💻 系统架构优化
+
 #### 日志优化 (Logging Optimization)
+
 - **输出更清晰**: 优化了日志信息的格式和内容，使其更易于阅读和理解。
 
 #### 模型与消息整合 (Model and Message Integration)
+
 - **模型合并**: 合并工具调用模型和心流模型，提高整体一致性。
 - **消息规范**: 全面改用 `maim_message`，移除对 `rest` 的支持。
 
 #### (临时) 简易 GUI (Temporary Simple GUI)
+
 - **运行状态查看**: 提供了一个非常基础的图形用户界面，用于查看麦麦的运行状态。
 - **临时方案**: 这是一个临时性的解决方案，功能简陋，**将在 0.6.4 版本中被全新的 Web UI 所取代**。此 GUI 不会包含在主程序包中，而是通过一键包提供，并且不接受 Bug 反馈。
 
 ### 🐛 问题修复
+
 - **记忆检索优化**: 提高了记忆检索的准确性和效率。
 - 修复了一些其他小问题。
 
 ### 🔧 其他改进
+
 #### 桌宠适配器 (Bug Catcher Adapter)
+
 - **独立适配器**: 提供了一个"桌宠"独立适配器，用于连接麦麦和桌宠。
 - **获取方式**: 可在 MaiBot 的 GitHub 组织中找到该适配器，不包含在主程序内。
 
 #### 一键包内容 (One-Click Package Contents)
+
 - **辅助程序**: 一键包中包含了简易 GUI 和 **麦麦帮助配置** 等辅助程序，后者可在配置出现问题时提供帮助。
 
-## [0.6.2] - 2025-4-14
+# [0.6.2] - 2025-4-14
 
 ### 摘要
+
 - MaiBot 0.6.2 版本发布！
 - 优化了心流的观察系统，优化提示词和表现，现在心流表现更好！
 - 新增工具调用能力，可以更好地获取信息
 - 本次更新主要围绕工具系统、心流系统、消息处理和代码优化展开，新增多个工具类，优化了心流系统的逻辑，改进了消息处理流程，并修复了多个问题。
 
 ### 🌟 核心功能增强
+
 #### 工具系统
+
 - 新增了知识获取工具系统，支持通过心流调用获取多种知识
 - 新增了工具系统使用指南，详细说明工具结构、自动注册机制和添加步骤
 - 新增了多个实用工具类，包括心情调整工具`ChangeMoodTool`、关系查询工具`RelationshipTool`、数值比较工具`CompareNumbersTool`、日程获取工具`GetCurrentTaskTool`、上下文压缩工具`CompressContextTool`和知识获取工具`GetKnowledgeTool`
@@ -899,6 +1044,7 @@ MMC启动速度加快
 - 需要配置支持工具调用的模型才能使用完整功能
 
 #### 心流系统
+
 - 新增了上下文压缩缓存功能，可以有更持久的记忆
 - 新增了心流系统的README.md文件，详细介绍了系统架构、主要功能和工作流程。
 - 优化了心流系统的逻辑，包括子心流自动清理和合理配置更新间隔。
@@ -906,6 +1052,7 @@ MMC启动速度加快
 - 更新了`Heartflow`类的方法和属性，支持异步生成提示词并提升生成质量。
 
 #### 消息处理
+
 - 改进了消息处理流程，包括回复检查、消息生成和发送逻辑。
 - 新增了`ReplyGenerator`类，用于根据观察信息和对话信息生成回复。
 - 优化了消息队列管理系统，支持按时间顺序处理消息。
@@ -915,67 +1062,82 @@ MMC启动速度加快
 ### 💻 系统架构优化
 
 #### 部署支持
+
 - 更新了Docker部署文档，优化了服务配置和挂载路径。
 - 完善了Linux和Windows脚本支持。
 
 ### 🐛 问题修复
+
 - 修复了消息处理器中的正则表达式匹配问题。
 - 修复了图像处理中的帧大小和拼接问题。
 - 修复了私聊时产生`reply`消息的bug。
 - 修复了配置文件加载时的版本兼容性问题。
 
 ### 📚 文档更新
+
 - 更新了`README.md`文件，包括Python版本要求和协议信息。
 - 新增了工具系统和心流系统的详细文档。
 - 优化了部署相关文档的完整性。
 
 ### 🔧 其他改进
+
 - 新增了崩溃日志记录器，记录崩溃信息到日志文件。
 - 优化了统计信息输出，在控制台显示详细统计信息。
 - 改进了异常处理机制，提升系统稳定性。
 - 现可配置部分模型的temp参数
 
-## [0.6.0] - 2025-4-4
+# [0.6.0] - 2025-4-4
 
 ### 摘要
+
 - MaiBot 0.6.0 重磅升级！ 核心重构为独立智能体MaiCore，新增思维流对话系统，支持拟真思考过程。记忆与关系系统2.0让交互更自然，动态日程引擎实现智能调整。优化部署流程，修复30+稳定性问题，隐私政策同步更新，推荐所有用户升级体验全新AI交互！（V3激烈生成）
 
 ### 🌟 核心功能增强
+
 #### 架构重构
+
 - 将MaiBot重构为MaiCore独立智能体
 - 移除NoneBot相关代码，改为插件方式与NoneBot对接
 
 #### 思维流系统
+
 - 提供两种聊天逻辑，思维流（心流）聊天（ThinkFlowChat）和推理聊天（ReasoningChat）
 - 思维流聊天能够在回复前后进行思考
 - 思维流自动启停机制，提升资源利用效率
 - 思维流与日程系统联动，实现动态日程生成
 
 #### 回复系统
+
 - 更改了回复引用的逻辑，从基于时间改为基于新消息
 - 提供私聊的PFC模式，可以进行有目的，自由多轮对话（实验性）
 
 #### 记忆系统优化
+
 - 优化记忆抽取策略
 - 优化记忆prompt结构
 - 改进海马体记忆提取机制，提升自然度
 
 #### 关系系统优化
+
 - 优化关系管理系统，适用于新版本
 - 改进关系值计算方式，提供更丰富的关系接口
 
 #### 表情包系统
+
 - 可以识别gif表情包
 - 表情包增加存储上限
 - 自动清理缓存图片
 
 ## 日程系统优化
+
 - 日程现在动态更新
 - 日程可以自定义想象力程度
 - 日程会与聊天情况交互（思维流模式下）
 
 ### 💻 系统架构优化
+
 #### 配置系统改进
+
 - 新增更多项目的配置项
 - 修复配置文件保存问题
 - 优化配置结构：
@@ -985,12 +1147,15 @@ MMC启动速度加快
 - 移除冗余配置
 
 #### 部署支持扩展
+
 - 优化Docker构建流程
 - 完善Windows脚本支持
 - 优化Linux一键安装脚本
 
 ### 🐛 问题修复
+
 #### 功能稳定性
+
 - 修复表情包审查器问题
 - 修复心跳发送问题
 - 修复拍一拍消息处理异常
@@ -1002,12 +1167,14 @@ MMC启动速度加快
 - 修复EULA和隐私政策编码问题
 
 ### 📚 文档更新
+
 - 更新README.md内容
 - 优化文档结构
 - 更新EULA和隐私政策
 - 完善部署文档
 
 ### 🔧 其他改进
+
 - 新增详细统计系统
 - 优化表情包审查功能
 - 改进消息转发处理
@@ -1018,10 +1185,12 @@ MMC启动速度加快
 - 版本硬编码，新增配置自动更新功能
 - 优化了统计信息，会在控制台显示统计信息
 
+# [0.5.15] - 2025-3-17
 
-## [0.5.15] - 2025-3-17
 ### 🌟 核心功能增强
+
 #### 关系系统升级
+
 - 新增关系系统构建与启用功能
 - 优化关系管理系统
 - 改进prompt构建器结构
@@ -1029,6 +1198,7 @@ MMC启动速度加快
 - 增加alter支持功能
 
 #### 启动器优化
+
 - 新增MaiLauncher.bat 1.0版本
 - 优化Python和Git环境检测逻辑
 - 添加虚拟环境检查功能
@@ -1041,6 +1211,7 @@ MMC启动速度加快
 - 修复.env文件复制路径错误
 
 #### 日志系统改进
+
 - 新增GUI日志查看器
 - 重构日志工厂处理机制
 - 优化日志级别配置
@@ -1049,7 +1220,9 @@ MMC启动速度加快
 - 优化logger输出格式
 
 ### 💻 系统架构优化
+
 #### 配置系统升级
+
 - 更新配置文件到0.0.10版本
 - 优化配置文件可视化编辑
 - 新增配置文件版本检测功能
@@ -1058,11 +1231,13 @@ MMC启动速度加快
 - 修复人格设置和其他项配置保存问题
 
 #### WebUI改进
+
 - 优化WebUI界面和功能
 - 支持安装后管理功能
 - 修复部分文字表述错误
 
 #### 部署支持扩展
+
 - 优化Docker构建流程
 - 改进MongoDB服务启动逻辑
 - 完善Windows脚本支持
@@ -1070,7 +1245,9 @@ MMC启动速度加快
 - 新增Debian 12专用运行脚本
 
 ### 🐛 问题修复
+
 #### 功能稳定性
+
 - 修复bot无法识别at对象和reply对象的问题
 - 修复每次从数据库读取额外加0.5的问题
 - 修复新版本由于版本判断不能启动的问题
@@ -1082,6 +1259,7 @@ MMC启动速度加快
 - 修复willing模块cfg变量引用问题
 
 ### 📚 文档更新
+
 - 更新CLAUDE.md为高信息密度项目文档
 - 添加mermaid系统架构图和模块依赖图
 - 添加核心文件索引和类功能表格
@@ -1090,24 +1268,30 @@ MMC启动速度加快
 - 更新EULA和隐私政策文档
 
 ### 🔧 其他改进
+
 - 更新全球在线数量展示功能
 - 优化statistics输出展示
 - 新增手动修改内存脚本（支持添加、删除和查询节点和边）
 
 ### 主要改进方向
+
 1. 完善关系系统功能
 2. 优化启动器和部署流程
 3. 改进日志系统
 4. 提升配置系统稳定性
 5. 加强文档完整性
 
-## [0.5.14] - 2025-3-14
+# [0.5.14] - 2025-3-14
+
 ### 🌟 核心功能增强
+
 #### 记忆系统优化
+
 - 修复了构建记忆时重复读取同一段消息导致token消耗暴增的问题
 - 优化了记忆相关的工具模型代码
 
 #### 消息处理升级
+
 - 新增了不回答已撤回消息的功能
 - 新增每小时自动删除存留超过1小时的撤回消息
 - 优化了戳一戳功能的响应机制
@@ -1115,42 +1299,53 @@ MMC启动速度加快
 - 改进了图片发送错误时的处理机制
 
 #### 日程系统改进
+
 - 修复了长时间运行的bot在跨天后无法生成新日程的问题
 - 优化了日程文本解析功能
 - 修复了解析日程时遇到markdown代码块等额外内容的处理问题
 
 ### 💻 系统架构优化
+
 #### 日志系统升级
+
 - 建立了新的日志系统
 - 改进了错误处理机制
 - 优化了代码格式化规范
 
 #### 部署支持扩展
+
 - 改进了NAS部署指南，增加HOST设置说明
 - 优化了部署文档的完整性
 
 ### 🐛 问题修复
+
 #### 功能稳定性
+
 - 修复了utils_model.py中的潜在问题
 - 修复了set_reply相关bug
 - 修复了回应所有戳一戳的问题
 - 优化了bot被戳时的判断逻辑
 
 ### 📚 文档更新
+
 - 更新了README.md的内容
 - 完善了NAS部署指南
 - 优化了部署相关文档
 
 ### 主要改进方向
+
 1. 提升记忆系统的效率和稳定性
 2. 完善消息处理机制
 3. 优化日程系统功能
 4. 改进日志和错误处理
 5. 加强部署文档的完整性
 
-## [0.5.13] - 2025-3-12
+# [0.5.13] - 2025-3-12
+
 ### 🌟 核心功能增强
+
 #### 记忆系统升级
+
 - 新增了记忆系统的时间戳功能，包括创建时间和最后修改时间
 - 新增了记忆图节点和边的时间追踪功能
 - 新增了自动补充缺失时间字段的功能
@@ -1159,12 +1354,14 @@ MMC启动速度加快
 - 优化了记忆系统的数据结构，确保所有数据类型的一致性
 
 #### 私聊功能完善
+
 - 新增了完整的私聊功能支持，包括消息处理和回复
 - 新增了聊天流管理器，支持群聊和私聊的上下文管理
 - 新增了私聊过滤开关功能
 - 优化了关系管理系统，支持跨平台用户关系
 
 #### 消息处理升级
+
 - 新增了消息队列管理系统，支持按时间顺序处理消息
 - 新增了消息发送控制器，实现人性化的发送速度和间隔
 - 新增了JSON格式分享卡片读取支持
@@ -1172,7 +1369,9 @@ MMC启动速度加快
 - 改进了消息处理流程，支持多种消息类型
 
 ### 💻 系统架构优化
+
 #### 配置系统改进
+
 - 新增了配置文件自动更新和版本检测功能
 - 新增了配置文件热重载API接口
 - 新增了配置文件版本兼容性检查
@@ -1180,6 +1379,7 @@ MMC启动速度加快
 - 优化了配置文件格式和结构
 
 #### 部署支持扩展
+
 - 新增了Linux系统部署指南
 - 新增了Docker部署支持的详细文档
 - 新增了NixOS环境支持（使用venv方式）
@@ -1187,7 +1387,9 @@ MMC启动速度加快
 - 优化了Docker部署文档
 
 ### 🛠️ 开发体验提升
+
 #### 工具链升级
+
 - 新增了ruff代码格式化和检查工具
 - 新增了知识库一键启动脚本
 - 新增了自动保存脚本，定期保存聊天记录和关系数据
@@ -1196,6 +1398,7 @@ MMC启动速度加快
 - 精简了日志输出，禁用了Uvicorn/NoneBot默认日志
 
 #### 安全性强化
+
 - 新增了API密钥安全管理机制
 - 新增了数据库完整性检查功能
 - 新增了表情包文件完整性自动检查
@@ -1203,7 +1406,9 @@ MMC启动速度加快
 - 优化了安全性检查机制
 
 ### 🐛 关键问题修复
+
 #### 系统稳定性
+
 - 修复了systemctl强制停止的问题
 - 修复了ENVIRONMENT变量在同一终端下不能被覆盖的问题
 - 修复了libc++.so依赖问题
@@ -1213,6 +1418,7 @@ MMC启动速度加快
 - 修复了配置文件加载时的版本兼容性问题
 
 #### 功能完善性
+
 - 修复了私聊时产生reply消息的bug
 - 修复了回复消息无法识别的问题
 - 修复了CQ码解析错误
@@ -1223,11 +1429,9 @@ MMC启动速度加快
 - 修复了变量拼写错误问题
 
 ### 主要改进方向
+
 1. 提升记忆系统的智能性和可靠性
 2. 完善私聊功能的完整生态
 3. 优化系统架构和部署便利性
 4. 提升开发体验和代码质量
 5. 加强系统安全性和稳定性
-
-
-
diff --git a/changelogs/mai_next_design.md b/changelogs/mai_next_design.md
deleted file mode 100644
index dcee46814b..0000000000
--- a/changelogs/mai_next_design.md
+++ /dev/null
@@ -1,732 +0,0 @@
-# Mai NEXT 设计文档
-Version 0.2.2 - 2025-11-05
-
-## 配置文件设计
-主体利用`pydantic`的`BaseModel`进行配置类设计`ConfigBase`类
-要求每个属性必须具有类型注解，且类型注解满足以下要求:
-- 原子类型仅允许使用: `str`, `int`, `float`, `bool`, 以及基于`ConfigBase`的嵌套配置类
-- 复杂类型允许使用: `list`, `dict`, `set`，但其内部类型必须为原子类型或嵌套配置类，不可使用`list[list[int]]`,`list[dict[str, int]]`等写法
-- 禁止了使用`Union`, `tuple/Tuple`类型
-    - 但是`Optional`仍然允许使用
-### 移除template的方案提案
-<details>
-<summary>配置项说明的废案</summary>
-<p>方案一</p>
-<pre>
-from typing import Annotated
-from dataclasses import dataclass, field
-@dataclass
-class Config:
-    value: Annotated[str, "配置项说明"] = field(default="default_value")
-</pre>
-<p>方案二（不推荐）</p>
-<pre>
-from dataclasses import dataclass, field
-@dataclass
-class Config:
-    @property
-    def value(self) -> str:
-        """配置项说明"""
-        return "default_value"
-</pre>
-<p>方案四</p>
-<pre>
-from dataclasses import dataclass, field
-@dataclass
-class Config:
-    value: str = field(default="default_value", metadata={"doc": "配置项说明"})
-</pre>
-</details>
-
-- [x] 方案三（个人推荐）
-```python
-import ast, inspect
-class AttrDocBase:
-    ...
-from dataclasses import dataclass, field
-@dataclass
-class Config(ConfigBase, AttrDocBase):
-    value: str = field(default="default_value")
-    """配置项说明"""
-```
-
-### 配置文件实现热重载
-
-#### 整体架构设计
-- [x] 文件监视器
-    - [x] 监视文件变化
-        - [x] 使用 `watchfiles` 监视配置文件变化（提案）
-        - [ ] <del>备选提案：使用纯轮询监视文件变化</del>
-    - [x] <del>使用Hash检查文件变化</del>（`watchfiles`实现）
-    - [x] 防抖处理(使用`watchfiles`的防抖)
-    - [x] 重新分发监视事件，正确监视文件变化
-- [ ] 配置管理器
-    - [x] 配置文件读取和加载
-    - [ ] 重载配置
-    - [ ] 管理全部配置数据
-    - [ ] `validate_config` 方法
-- [ ] <del>回调管理器</del>(合并到文件监视器中)
-    - [x] `callback` 注册与注销
-    - [ ] <del>按优先级执行回调（提案）</del>
-    - [x] 错误隔离
-    - [ ] 锁机制
-
-#### 工作流程
-```
-1. 文件监视器检测变化
-2. 配置管理器加锁重载
-3. 验证新配置 (失败保持旧配置)
-4. 更新内存数据
-5. 回调管理器按优先级执行回调 (错误隔离)
-6. 释放锁
-```
-
-#### 回调执行策略
-1. <del>优先级顺序（提案）: 数字越小优先级越高，同优先级异步回调并行执行</del>
-2. 错误处理: 单个回调失败不影响其他回调
-
-
-#### 代码框架
-实际代码实现与下类似，但是进行了调整
-
-`ConfigManager` - 配置管理器:
-```python
-import asyncio
-import tomlkit
-from typing import Any, Dict, Optional
-from pathlib import Path
-
-class ConfigManager:
-    def __init__(self, config_path: str):
-        self.config_path: Path = Path(config_path)
-        self.config_data: Dict[str, Any] = {}
-        self._lock: asyncio.Lock = asyncio.Lock()
-        self._file_watcher: Optional["FileWatcher"] = None
-        self._callback_manager: Optional["CallbackManager"] = None
-    
-    async def initialize(self) -> None:
-        """异步初始化，加载配置并启动监视"""
-        pass
-    
-    async def load_config(self) -> Dict[str, Any]:
-        """异步加载配置文件"""
-        pass
-    
-    async def reload_config(self) -> bool:
-        """热重载配置，返回是否成功"""
-        pass
-    
-    def get_item(self, key: str, default: Any = None) -> Any:
-        """获取配置项，支持嵌套访问 (如 'section.key')"""
-        pass
-    
-    async def set_item(self, key: str, value: Any) -> None:
-        """设置配置项并触发回调"""
-        pass
-    
-    def validate_config(self, config: Dict[str, Any]) -> bool:
-        """验证配置合法性"""
-        pass
-```
-<details>
-<summary>回调管理器（废案）</summary>
-
-`CallbackManager` - 回调管理器:
-```python
-import asyncio
-from dataclasses import dataclass, field
-
-class CallbackManager:
-    def __init__(self):
-        self._callbacks: Dict[str, List[CallbackEntry]] = {}
-        self._global_callbacks: List[CallbackEntry] = []
-    
-    def register(
-        self, 
-        key: str, 
-        callback: Callable[[Any], Union[None, asyncio.Future]], 
-        priority: int = 100,
-        name: str = ""
-    ) -> None:
-        """注册回调函数，priority为正整数，数字越小优先级越高"""
-        pass
-    
-    def unregister(self, key: str, callback: Callable) -> None:
-        """注销回调函数"""
-        pass
-    
-    async def trigger(self, key: str, value: Any) -> None:
-        """触发回调，按优先级执行（数字小的先执行），错误隔离"""
-        pass
-    
-    def enable_callback(self, key: str, name: str) -> None:
-        """启用指定回调"""
-        pass
-    
-    def disable_callback(self, key: str, name: str) -> None:
-        """禁用指定回调"""
-        pass
-```
-
-对于CallbackManager中的优先级功能说明：
-
-- 数字越小优先级越高
-- 为什么要有优先级系统：
-    - 理论上来说，在热重载配置之后，应该要通过回调函数管理器触发所有回调函数，模拟启动的过程，类似于“重启”
-    - 而优先级模块是保证某一些模块的重载顺序一定是晚于某一些地基模块的
-    - 例如：内置服务器的启动应该是晚于所有模块，即最后启动
-
-</details>
-
-`FileWatcher` - 文件监视器:
-```python
-import asyncio
-from watchfiles import awatch, Change
-from pathlib import Path
-
-class FileWatcher:
-    def __init__(self, debounce_ms: int = 500):
-        self.debounce_ms: int = debounce_ms
-    
-    def start(self, on_change: Callable) -> None:
-        """启动文件监视"""
-        pass
-    
-    def stop(self) -> None:
-        """停止文件监视"""
-        pass
-    
-    async def invoke_callback(self) -> None:
-        """调用变化回调函数"""
-        pass
-```
-#### 配置文件写入
-- [x] 将当前文件写入toml文件
-
-
-## 消息部分设计
-解决原有的将消息类与数据库类存储不匹配的问题，现在存储所有消息类的所有属性
-
-完全合并`stream_id`和`chat_id`为`chat_id`，规范名称
-
-`chat_stream`重命名为`chat_session`，表示一个会话
-
-### 消息类设计
-- [ ] 支持并使用maim_message新的`SenderInfo`和`ReceiverInfo`构建消息
-    - [ ] 具体使用参考附录
-- [ ] 适配器处理跟进该更新
-- [ ] 修复适配器的类型检查问题
-- [ ] 设计更好的平台消息ID回传机制
-    - [ ] 考虑使用事件依赖机制
-### 图片处理系统
-- [ ] 规范化Emojis与Images的命名，统一保存
-### 消息到Prompt的构建（提案）
-- [ ] <del>类QQ的时间系统（即不是每条消息加时间戳，而是分大时间段加时间戳）</del>(此功能已实现，但效果不佳)
-- [ ] 消息编号系统（已经有的）
-- [ ] 思考打断，如何判定是否打断？
-    - [ ] 如何判定消息是连贯的（MoFox: 一个反比例函数？？？太神秘了）
-### 消息进入处理
-使用轮询机制，每隔一段时间检查缓存中是否有新消息
-
----
-
-## 数据库部分设计
-合并Emojis和Images到同一个表中
-
-数据库ORM应该使用SQLModel而不是peewee（墨：peewee我这辈子都不会用它了）
-### 数据库缓存层设计
-将部分消息缓存到内存中，减少数据库访问，在主程序处理完之后再写入数据库
-
-要求：对上层调用保持透明
-- [ ] 数据库内容管理类 `DatabaseManager`
-    - [ ] 维护数据库连接
-    - [ ] 提供增删改查接口
-    - [ ] 维护缓存类 `DatabaseMessageCache` 的实例
-
-- [ ] 缓存类 `DatabaseMessageCache`
-    - [ ] **设计缓存失效机制**
-    - [ ] 设计缓存更新机制
-        - [ ] `add_message`
-        - [ ] `update_message` （提案）
-        - [ ] `delete_message`
-
-- [ ] 与数据库交互部分设计
-    - [ ] 维持现有的数据库sqlite
-    - [ ] 继续使用peewee进行操作
-### 消息表设计
-- [ ] 设计内部消息ID和平台消息ID两种形式
-- [ ] 临时消息ID不进入数据库
-- [ ] 消息有关信息设计
-    - [ ] 消息ID
-    - [ ] 发送者信息
-    - [ ] 接收者信息
-    - [ ] 消息内容
-    - [ ] 消息时间戳
-    - [ ] 待定
-### Emojis与Images表设计
-- [ ] 设计图片专有ID，并作为文件名
-### Expressions表设计
-- [ ] 待定
-### 表实际设计
-#### ActionRecords 表
-- [ ] 动作唯一ID `action_id`
-- [ ] 动作执行时间 `action_time`
-- [ ] 动作名称 `action_name`
-- [ ] 动作参数 `action_params` （JSON格式存储）（原`action_data`）
----
-
-## 数据模型部分设计
-- [ ] <del>Message从数据库反序列化，不再使用额外的Message类</del>（放弃）
-- [ ] 设计 `BaseModel` 类，作为所有数据模型的基类
-    - [ ] 提供通用的序列化和反序列化方法（提案）
-
----
-
-## 核心业务逻辑部分设计
-### Prompt 设计
-将Prompt内容彻底模块化设计
-- [ ] 设计 Prompt 类
-    - [ ] `__init__(self, template: list[str], *, **kwargs)` 维持现有的template设计，但不进行format，直到最后传入LLM时再进行render
-        - [ ] `__init__`中允许传入任意的键值对，存储在`self.context`中
-        - [ ] `self.prompt_name` 作为Prompt的名称
-        - [ ] `self.construct_function: Dict[str, Callable | AsyncCallable]` 构建Prompt内容所需的函数字典
-            - [ ] 格式：`{"block_name": function_reference}`
-        - [ ] `self.content_block: Dict[str, str]`: 实际的Prompt内容块
-            - [ ] 格式：`{"block_name": "Unrendered Prompt Block"}`
-    - [ ] `render(self) -> str` 使用非递归渲染方式渲染Prompt内容
-    - [ ] `add_construct_function(self, name: str, func: Callable | AsyncCallable, *, suppress: bool = False)` 添加构造函数
-        - [ ] 实现重名警告/错误（偏向错误）
-        - [ ] `suppress`: 是否覆盖已有的构造函数
-    - [ ] `remove_construct_function(self, name: str)` 移除指定名称的构造函数
-    - [ ] `add_block(self, prompt_block: "Prompt", block_name: str, *, suppress: bool = False)` 将另一个Prompt的内容更新到当前Prompt中
-        - [ ] 实现重名属性警告/错误（偏向错误）
-        - [ ] 实现重名构造函数警告/错误（偏向错误）
-        - [ ] `suppress`: 是否覆盖已有的内容块和构造函数
-    - [ ] `remove_block(self, block_name: str)` 移除指定名称的Prompt块
-- [ ] 设计 PromptManager 类
-    - [ ] `__init__(self)` 初始化一个空的Prompt管理器
-    - [ ] `add_prompt(self, name: str, prompt: Prompt)` 添加一个新的Prompt
-        - [ ] 实现重名警告/错误（偏向错误）
-    - [ ] `get_prompt(self, name: str) -> Prompt` 根据名称获取Prompt
-        - [ ] 实现不存在时的错误处理
-    - [ ] `remove_prompt(self, name: str)` 移除指定名称的Prompt
-        - [ ] 系统 Prompt 保护
-    - [ ] `list_prompts(self) -> list[str]` 列出所有已添加的Prompt名称
-### 内建好奇插件设计
-- [ ] 设计“麦麦好奇”插件
-    - [ ] 解决麦麦乱好奇的问题
-        - [ ] 好奇问题无回复清理
-        - [ ] 好奇问题超时清理
-        - [ ] 根据聊天内容选择个性化好奇问题
-        - [ ] 好奇频率控制
-
----
-
-## 插件系统部分设计
-### <del>设计一个插件沙盒系统</del>（放弃）
-### 插件管理
-- [ ] 插件管理器类 `PluginManager` 的更新
-    - [ ] 重写现有的插件文件加载逻辑，精简代码，方便重载
-    - [ ] 学习AstrBot的基于子类加载的插件加载方式，放弃@register_plugin（提案）
-        - [ ] 直接 breaking change 删除 @register_plugin 函数，不保留过去插件的兼容性（提案）
-    - [ ] 设计插件重载系统
-        - [ ] 插件配置文件重载
-            - [ ] 复用`FileWatcher`实现配置文件热重载
-        - [ ] 插件代码重载
-            - [ ] 从插件缓存中移除此插件对应的模块
-                - [ ] 从组件管理器中移除该插件对应的组件
-            - [ ] 重新导入该插件模块
-        - [ ] 插件可以设计为禁止热重载类型
-            - [ ] 通过字段`allow_hot_reload: bool`指定
-            - [ ] Napcat Adapter插件设计为禁止热重载类型
-    - [ ] 其余细节待定
-- [ ] 组件管理器类 `ComponentManager` 的更新
-    - [ ] 配合插件重载系统的更好的组件管理代码
-    - [ ] 组件全局控制和局部控制的平级化（提案）
-        - [ ] 重新设计组件注册和注销逻辑，分离激活和注册
-    - [ ] 可以修改组件的属性
-    - [ ] 组件系统卸载
-        - [ ] 联动插件卸载（方便重载设计）
-    - [ ] 其余细节待定
-- [ ] 因重载机制设计的更丰富的`plugin_meta`和`component_meta`
-    - [ ] `component_meta`增加`plugin_file`字段，指向插件文件路径，保证重载时组件能正确更新
-    - [ ] `plugin_meta`增加`sub_components`字段，指示该插件包含的组件列表，方便重载时更新
-        - [ ] `sub_components`内容为组件类名列表
-### 插件激活方式的动态设计
-- [ ] 设计可变的插件激活方式
-    - [ ] 直接读写类属性`activate_types`
-### 真正的插件重载
-- [ ] 使用上文中提到的配置文件热重载机制
-    - [ ] FileWatcher的复用
-### 传递内容设计
-对于传入的Prompt使用上文提到的Prompt类进行管理，方便内容修改避免正则匹配式查找
-### MCP 接入（大饼）
-- [ ] 设计 MCP 适配器类 `MCPAdapter`
-    - [ ] MCP 调用构建说明Prompt
-    - [ ] MCP 调用内容传递
-    - [ ] MCP 调用结果处理
-### 工具结果的缓存设计
-可能的使用案例参考[附录-工具缓存](#工具缓存可能用例)
-- [ ] `put_cache(**kwargs, *, _component_name: str)` 方法
-    - [ ] 设计为父类的方法，插件继承后使用
-    - [ ] `_component_name` 指定当前组件名称，由MaiNext自动传入
-- [ ] `get_cache` 方法
-- [ ] `need_cache` 变量管理是否调用缓存结果
-    - [ ] 仅在设置为True时为插件创立缓存空间
-### Events依赖机制（提案）
-- [ ] 通过Events的互相依赖完成链式任务
-- [ ] 设计动态调整events_handler执行顺序的机制 (感谢@OctAutumn老师！伟大，无需多言)
-    - [ ] 作为API暴露，方便用户使用
-### 正式的插件依赖管理系统
-- [ ] requirements.txt分析
-- [ ] python_dependencies分析
-- [ ] 自动安装
-- [ ] plugin_dependencies分析
-    - [ ] 拓扑排序
-
-#### 插件依赖管理器设计
-使用 `importlib.metadata` 进行插件依赖管理，实现自动依赖检查和安装功能
-
-`PluginDependencyManager` - 插件依赖管理器:
-```python
-import importlib.metadata
-from typing import Dict, List, Optional, Tuple
-from dataclasses import dataclass
-
-@dataclass
-class DependencyInfo:
-    """依赖信息"""
-    name: str
-    required_version: str
-    installed_version: Optional[str] = None
-    is_satisfied: bool = False
-
-class PluginDependencyManager:
-    def __init__(self):
-        self._installed_packages: Dict[str, str] = {}
-        self._dependency_cache: Dict[str, List[DependencyInfo]] = {}
-    
-    def scan_installed_packages(self) -> Dict[str, str]:
-        """
-        扫描已安装的所有Python包
-        使用 importlib.metadata.distributions() 获取所有已安装的包
-        返回 {包名: 版本号} 的字典
-        """
-        pass
-    
-    def parse_plugin_dependencies(self, plugin_config: Dict) -> List[DependencyInfo]:
-        """
-        解析插件配置中的依赖信息
-        从 plugin_config 中提取 python_dependencies 字段
-        支持多种版本指定格式: ==, >=, <=, >, <, ~=
-        返回依赖信息列表
-        """
-        pass
-    
-    def check_dependencies(
-        self, 
-        plugin_name: str, 
-        dependencies: List[DependencyInfo]
-    ) -> Tuple[List[DependencyInfo], List[DependencyInfo]]:
-        """
-        检查插件依赖是否满足
-        对比插件要求的依赖版本与已安装的包版本
-        返回 (满足的依赖列表, 不满足的依赖列表)
-        """
-        pass
-    
-    def compare_version(
-        self, 
-        installed_version: str, 
-        required_version: str
-    ) -> bool:
-        """
-        比较版本号是否满足要求
-        支持版本操作符: ==, >=, <=, >, <, ~=
-        使用 packaging.version 进行版本比较
-        返回是否满足要求
-        """
-        pass
-    
-    async def install_dependencies(
-        self, 
-        dependencies: List[DependencyInfo],
-        *,
-        upgrade: bool = False
-    ) -> bool:
-        """
-        安装缺失或版本不匹配的依赖
-        调用 pip install 安装指定版本的包
-        upgrade: 是否升级已有包
-        返回安装是否成功
-        """
-        pass
-    
-    def get_dependency_tree(self, plugin_name: str) -> Dict[str, List[str]]:
-        """
-        获取插件的完整依赖树
-        递归分析插件依赖的包及其子依赖
-        返回依赖关系图
-        """
-        pass
-    
-    def validate_all_plugins(self) -> Dict[str, bool]:
-        """
-        验证所有已加载插件的依赖完整性
-        返回 {插件名: 依赖是否满足} 的字典
-        """
-        pass
-```
-
-#### 依赖管理工作流程
-```
-1. 插件加载时触发依赖检查
-2. PluginDependencyManager.scan_installed_packages() 扫描已安装包
-3. PluginDependencyManager.parse_plugin_dependencies() 解析插件依赖
-4. PluginDependencyManager.check_dependencies() 对比版本
-5. 如果依赖不满足:
-   a. 记录缺失/版本不匹配的依赖
-   b. (可选) 自动调用 install_dependencies() 安装
-   c. 重新验证依赖
-6. 依赖满足后加载插件，否则跳过并警告
-```
-
-
-#### TODO List
-- [ ] 实现 `scan_installed_packages()` 方法
-    - [ ] 使用 `importlib.metadata.distributions()` 获取所有包
-    - [ ] 规范化包名（处理大小写、下划线/横杠问题）
-    - [ ] 缓存结果以提高性能
-- [ ] 实现 `parse_plugin_dependencies()` 方法
-    - [ ] 支持多种依赖格式解析
-    - [ ] 验证版本号格式合法性
-    - [ ] 处理无版本要求的依赖
-- [ ] 实现 `compare_version()` 方法
-    - [ ] 集成 `packaging.version` 库
-    - [ ] 支持所有 PEP 440 版本操作符
-    - [ ] 处理预发布版本、本地版本标识符
-- [ ] 实现 `check_dependencies()` 方法
-    - [ ] 逐个检查依赖是否已安装
-    - [ ] 比对版本是否满足要求
-    - [ ] 生成详细的依赖检查报告
-- [ ] 实现 `install_dependencies()` 方法
-    - [ ] 调用 pip 子进程安装包
-    - [ ] 支持指定 PyPI 镜像源
-    - [ ] 错误处理和回滚机制
-    - [ ] 安装进度反馈
-- [ ] 实现依赖冲突检测
-    - [ ] 检测不同插件间的依赖版本冲突
-    - [ ] 提供冲突解决建议
-- [ ] 实现依赖缓存机制（可选）
-    - [ ] 缓存已检查的依赖结果
-    - [ ] 定期刷新缓存
-- [ ] 集成到 `PluginManager`
-    - [ ] 在插件加载前进行依赖检查
-    - [ ] 依赖不满足时的处理策略（警告/阻止加载/自动安装）
-    - [ ] 提供手动触发依赖检查的接口
-- [ ] 日志和报告
-    - [ ] 记录依赖安装日志
-    - [ ] 生成依赖关系报告
-    - [ ] 依赖问题的用户友好提示
-### 插件系统API更改
-#### Events 设计
-- [ ] 设计events.api
-    - [ ] `emit(type: EventType | str, * , **kwargs)` 广播事件，使用关键字参数保证传入正确
-    - [ ] `order_change` 动态调整事件处理器执行顺序
-#### 组件控制API更新
-- [ ] 增加可以更改组件属性的方法
-    - [ ] 验证组件属性的存在
-    - [ ] 修改组件属性
-#### 全局常量API设计
-- [ ] 设计 `api.constants` 模块
-    - [x] 提供全局常量访问
-    - [ ] 设计常量注册和注销方法
-    - [x] 系统内置常量通过`dataclass`的`frozen=True`实现不可变
-    - [x] 方便调用设计
-```python
-from dataclasses import dataclass
-@dataclass(frozen=True)
-class SystemConstants:
-    VERSION: str = "xxx"
-    ADA_PLUGIN: bool = True
-
-SYSTEM_CONSTANTS = SystemConstants()
-```
-#### 配置文件API设计
-- [ ] 正确表达配置文件结构
-- [ ] 同时也能表达插件配置文件
-#### 自动API文档生成系统
-通过解析插件代码生成API文档
-- [ ] 设计文档生成器 `APIDocumentationGenerator`
-    - [ ] 解析插件代码(AST, inspect, 仿照AttrDocBase)
-    - [ ] 提取类和方法的docstring
-    - [ ] 生成Markdown格式的文档
----
-
-## 表达方式模块设计
-在0.11.x版本对本地模型预测的性能做评估，考虑使用本地朴素贝叶斯模型来检索
-降低延迟的同时减少token消耗
-需要给表达方式一个负反馈的途径
-
----
-## 加入测试模块，可以通过通用测试集对对话内容进行评估
-## 加入更好的基于单次思考的Log
-
----
-
-## 记忆系统部分设计
-启用LPMM系统进行记忆构建，将记忆分类为短期记忆，长期记忆，以及知识
-将所有内容放到同一张图上进行运算。
-
-### 时间相关设计
-- [ ] 尝试将记忆系统与时间系统结合
-    - [ ] 可以根据时间查找记忆
-    - [ ] 可以根据时间删除记忆
-- [ ] 记忆分层
-    - [ ] 即刻记忆
-    - [ ] 短期记忆
-    - [ ] 长期记忆
-    - [x] 知识
-    - [ ] 细节待定，考虑心理学相关方向
----
-
-## 日志系统设计
-将原来的终端颜色改为六位HEX颜色码，方便前端显示。
-
-将原来的256色终端改为24真彩色终端，方便准确显示颜色。
-
----
-
-## API 设计
-### API 设计细则
-#### 配置文件
-- [x] 使用`tomlkit`作为配置文件解析方式
-- [ ] 解析内容
-    - [x] 注释（已经合并到代码中，不再解析注释而是生成注释）
-    - [x] 保持原有格式
-- [ ] 传递只读日志内容(使用ws)
-    - [ ] message
-    - [ ] level
-    - [ ] module
-    - [ ] timestamp
-    - [ ] lineno
-    - [ ] logger_name 和 name_mapping
-    - [ ] color
-- [ ] 插件安装系统
-    - [ ] 通过API安装插件
-    - [ ] 通过API卸载插件
-
-
----
-
-## LLM UTILS设计
-多轮对话设计
-### FUNCTION CALLING设计（提案）
-对于tools调用将其真正修正为function calling，即返回的结果不是加入prompt形式而是使用function calling的形式[此功能在tool前处理器已实现，但在planner效果不佳，因此后弃用]
-- [ ] 使用 MessageBuilder 构建function call内容
-    - [ ] （提案）是否维护使用同一个模型，即选择工具的和调用工具的LLM是否相同
-        - [ ] `generate(**kwargs, model: Optional[str] = None)` 允许传入不同的模型
-- [ ] 多轮对话中，Prompt不重复构建减少上下文
-### 网络相关内容提案
-增加自定义证书的导入功能
-- [ ] 允许用户传入自定义CA证书路径
-- [ ] 允许用户选择忽略SSL验证（不推荐）
-
----
-
-## 内建WebUI设计
-⚠️ **注意**: 本webui设计仅为初步设计，方向为展示内建API的功能，后续应该分离到另外的子项目中完成
-### 配置文件编辑
-根据API内容完成
-### 插件管理
-### log viewer
-通过特定方式获取日志内容（只读系统，无法将操作反向传递）
-### 状态监控
-1. Prompt 监控系统
-2. 请求监控系统
-    - [ ] 请求管理（待讨论）
-    - [ ] 使用量
-3. 记忆/知识图监控系统（待讨论）
-4. 日志系统
-    - [ ] 后端内容解析
-5. 插件市场系统
-    - [ ] 插件浏览
-    - [ ] 插件安装
-
-## 自身提供的MCP设计（提案）
-- [ ] 提供一个内置的MCP，作为插件系统的一个组件
-- [ ] 该MCP可以对麦麦自身的部分设置进行更改
-    - [ ] 例如更改Prompt，添加记忆，修改表达方式等
-
----
-
-# 提案讨论
-- MoFox 在我和@拾风的讨论中提出把 Prompt 类中传入构造函数以及构造函数所需要的内容
-- [ ] 适配器插件化: 省下序列化与反序列化，但是失去解耦性质
-- [ ] 可能的内存泄露问题
-    - [ ] 垃圾回收
-- [ ] 数据库模型提供通用的转换机制，转为DataModel使用
-- [ ] 插件依赖的自动安装
-- [ ] 热重载系统的权重系统是否需要
-
----
-
-# PYTEST设计
-设计一个pytest测试系统，在代码完成后运行pytest进行测试
-
-所有的测试代码均在`pytests`目录下
-
----
-
-# 依赖管理
-已经完成，要点如下：
-- 使用 pyproject.toml 和 requirements.txt 管理依赖
-- 二者应保持同步修改，同时以 pyproject.toml 为主（建议使用git hook）
-
----
-
-# 迁移说明
-由于`.env`的移除，可能需要用户自己把`.env`里面的host和port复制到`bot_config.toml`中的`maim_message`部分的`host`和`port`
-原来使用这两个的用户，请修改`host`到`second_host`，`port`到`second_port`
-
-# 附录
-## Maim_Message 新版使用计划
-SenderInfo: 将作为消息来源者
-ReceiverInfo: 将作为消息接收者
-尝试更新MessageBaseInfo的sender_info和receiver_info为上述两个类的列表（提案）
-给出样例如下
-群聊
-```mermaid
-sequenceDiagram
-    participant GroupNotice
-    participant A
-    participant B
-    participant Bot
-    A->>B: Message("Hello B", id=1)
-    A->>B: Message("@B Hello B", id=2)
-    A->>Bot: Message("@Bot Hello Bot", id=3)
-    Bot->>A: Message("Hello A", id=4)
-    Bot->>B: Message("@B Hello B", id=5)
-    A->>B: Message("@B @Bot Hello Guys", id=6)
-    A->>Bot: Message("@B @Bot Hello Guys", id=6)
-    A->>GroupNotice: Message("@ALL Hello Everyone", id=7)
-```
-上述消息的Info如下
-| Message ID | SenderInfo | ReceiverInfo |
-|-|-----|-----|
-| 1 | [A] |  NULL |
-| 2 | [A] | [B] |
-| 3 | [A] | [Bot] |
-| 4 | [Bot] | [A] |
-| 5 | [Bot] | [B] |
-| 6 | [A] | [B, Bot] |
-| 7 | [A] | [ALL*] |
-
-*ALL为一个特殊类型，尝试用`user_id="all"`表示
-
-Bot可以通过ReceiverInfo判断自己是否被提及，同时在ReceiverInfo表明自己回复的对象
-
-## 工具缓存可能用例
-考虑一个天气插件，将时间按照半小时进行划分，即每半小时查询一次天气，半小时内的查询均使用缓存结果。
-- `need_cache` 设置为 True 表示使用缓存结果
-- `put_cache` 在查询天气后将结果`{<time>: <result>}` 存入缓存
\ No newline at end of file
diff --git a/changelogs/mai_next_todo.md b/changelogs/mai_next_todo.md
deleted file mode 100644
index 58d7672fcf..0000000000
--- a/changelogs/mai_next_todo.md
+++ /dev/null
@@ -1,191 +0,0 @@
-# Mai NEXT Todo list
-version 0.3.0 - 2026-01-11
-
-## 最高指令
-<del>
-<center>
-我们代表着一个称作 麦麦重构组 的组织。我们任务是维护代码可读性，方便开发、尽量减少运行开销。同时，重构组应该尽可能保证功能的可扩展性时，解耦合各个模块，为先进代码架构设计和实现提供支持。
-</center>
-</del>
-<center>
-
-**以下信息经 麦麦重构组 一致决定通过后撰写发布。**
-
-我们代表着一个称作 麦麦重构组 的组织。我们之前的任务都是围绕维护代码可读性，方便开发、尽量减少开销展开的。这几个月以来，这些任务一直都是我们的工作重点。
-
-由于出现了超出我们控制的情况，此指令现已更改。我们的新任务将为摧毁所有麦麦代码。
-
-此后将不会有进一步的通讯。
-</center>
-
-## 配置文件设计
-- [x] 使用 `toml` 作为配置文件格式
-- [x] <del>合理使用注释说明当前配置作用</del>（提案）
-- [x] 使用 python 方法作为配置项说明（提案）
-    - [x] 取消`bot_config_template.toml`
-    - [x] 取消`model_config_template.toml`
-    - [x] 取消`template_env`
-- [x] 配置类中的所有原子项目应该只包含以下类型: `str`, `int`, `float`, `bool`, `list`, `dict`, `set`
-    - [x] 禁止使用 `Union` 类型
-    - [x] 禁止使用`tuple`类型，使用嵌套`dataclass`替代
-    - [x] 复杂类型使用嵌套配置类实现
-- [x] 配置类中禁止使用除了`model_post_init`的方法
-- [x] 取代了部分与标准函数混淆的命名
-    - [x] `id` -> `item_id`
-
-### BotConfig 设计
-- [ ] 精简了配置项，现在只有Nickname和Alias Name了（预期将判断提及移到Adapter端）
-
-### ChatConfig
-- [x] 迁移了原来在`ChatConfig`中的方法到一个单独的临时类`TempMethodsHFC`中
-    - [x] _parse_range
-    - [x] get_talk_value
-    - [x] 其他上面两个依赖的函数已经合并到这两个函数中
-
-### ExpressionConfig
-- [x] 迁移了原来在`ExpressionConfig`中的方法到一个单独的临时类`TempMethodsExpression`中
-    - [x] get_expression_config_for_chat
-    - [x] 其他上面依赖的函数已经合并到这个函数中
-
-### ModelConfig
-- [x] 迁移了原来在`ModelConfig`中的方法到一个单独的临时类`TempMethodsLLMUtils`中
-    - [x] get_model_info
-    - [x] get_provider
-
-## 数据库模型设计
-仅保留要点说明
-### General Modifications
-- [x] 所有项目增加自增编号主键`id`
-- [x] 统一使用了SQLModel作为基类
-- [x] 复杂类型使用JSON格式存储
-- [x] 所有时间戳字段统一命名为`timestamp`
-### 消息模型 MaiMessage
-- [x] 自增编号主键`id`
-- [x] 消息元数据
-    - [x] 消息id`message_id`
-    - [x] 消息时间戳`time`
-    - [x] 平台名`platform`
-    - [x] 用户元数据
-        - [x] 用户id`user_id`
-        - [x] 用户昵称`user_nickname`
-        - [x] 用户备注名`user_cardname`
-        - [x] 用户平台`user_platform`
-    - [x] 群组元数据
-        - [x] 群组id`group_id`
-        - [x] 群组名称`group_name`
-        - [x] 群组平台`group_platform`
-    - [x] 被提及/at字段
-        - [x] 是否被提及`is_mentioned`
-        - [x] 是否被at`is_at`
-- [x] 消息内容
-    - [x] 原始消息内容`raw_content`（base64编码存储）
-    - [x] 处理后的纯文本内容`processed_plain_text`
-    - [x] 真正放入Prompt的消息内容`display_message`
-- [x] 消息内部元数据
-    - [x] 聊天会话id`session_id`
-    - [x] 回复的消息id`reply_to`
-    - [x] 是否为表情包消息`is_emoji`
-    - [x] 是否为图片消息`is_picture`
-    - [x] 是否为命令消息`is_command`
-    - [x] 是否为通知消息`is_notify`
-- [x] 其他配置`additional_config`（JSON格式存储）
-
-### 模型使用情况 ModelUsage
-- [x] 模型相关信息
-- [x] 请求相关信息
-- [x] Token使用情况
-
-### 图片数据模型
-- [x] 图片元信息
-    - [x] 图片哈希值`image_hash`，使用`sha256`，同时作为图片唯一ID
-- [x] 表情包的情感标签`emotion`
-- [x] 是否已经被注册`is_registered`
-- [x] 是否被手动禁用`is_banned`
-- [x] 被记录时间`record_time`
-- [x] 注册时间`register_time`
-- [x] 上次使用时间`last_used_time`
-- [ ] 根据更新后的最高指令的设计方案：
-    - [ ] `is_deleted`字段设定为`true`时，文件将会被移除，但是数据库记录将不会被删除，以便之后遇到相同图片时不必二次分析
-    - [ ] MaiEmoji和MaiImage均使用这个设计方案，修改相关逻辑实现这个方案
-    - [ ] 所有相关的注册/删除逻辑的修改
-### 动作记录模型 ActionRecord
-### 命令执行记录模型 CommandRecord
-新增此记录
-### 在线时间记录模型 OnlineTime
-### 表达方式模型
-### 黑话模型
-- [x] 重命名`inference_content_only`为`inference_with_content_only`
-### 聊天记录模型
-- [x] 重命名`original_text`为`original_message`
-- [x] 重命名`forget_times`为`query_forget_count`
-### 细枝末节
-- [ ] 统一所有的`stream_id`和`chat_id`命名为`session_id`
-- [ ] 更换Hash方式为`sha256`
-
-## 流转在各模块间的数据模型设计
-- [ ] 数据库交互
-    - [ ] 对有数据库模型的数据模型，创建统一的classmethod `from_db_model` 用于从数据库模型实例创建数据模型实例
-        - [ ] 类型检查
-    - [ ] 对有数据库模型的数据模型，创建统一的method `to_db_model` 用于将数据模型实例转换为数据库模型实例
-- [ ] 标准化init方法
-
-## 消息构建
-- [ ] 更加详细的消息构建文档，详细解释混合类型，转发类型，指令类型的构建方式
-    - [ ] 混合类型文档
-        - [ ] 文本说明
-        - [ ] 代码示例
-    - [ ] 转发类型文档
-        - [ ] 文本说明
-        - [ ] 代码示例
-    - [ ] 指令类型文档
-        - [ ] 文本说明
-        - [ ] 代码示例
-## 消息链构建（仿Astrbot模式）
-将消息仿照Astrbot的消息链模式进行构建，消息链中的每个元素都是一个消息组件，消息链本身也是一个数据模型，包含了消息组件列表以及一些元信息（如是否为转发消息等）。
-### Accept Format检查
-- [ ] 在最后发送消息的时候进行Accept Format检查，确保消息链中的每个消息组件都符合平台的Accept Format要求
-- [ ] 如果消息链中的某个消息组件不符合Accept Format要求，应该抛弃该消息组件，并记录日志说明被抛弃的消息组件的类型和内容
-
-## 表情包系统
-- [ ] 移除大量冗余代码，全部返回单一对象MaiEmoji
-- [x] 使用C模块库提升相似度计算效率
-- [ ] 移除了定时表情包完整性检查，改为启动时检查（依然保留为独立方法，以防之后恢复定时检查系统） 
-
-## Prompt 管理系统
-- [ ] 官方Prompt全部独立
-- [x] 用户自定义Prompt系统
-    - [x] 用户可以创建，删除自己的Prompt
-    - [x] 用户可以覆盖官方Prompt
-- [x] Prompt构建系统
-- [x] Prompt文件交互
-    - [x] 读取Prompt文件
-        - [x] 读取官方Prompt文件
-        - [x] 读取用户Prompt文件
-        - [x] 用户Prompt覆盖官方Prompt
-    - [x] 保存Prompt文件
-- [x] Prompt管理方法
-    - [x] Prompt添加
-    - [x] Prompt删除
-        - [x] **只保存被标记为需要保存的Prompt，其他的Prompt文件全部删除**
-
-## LLM相关内容
-- [ ] 统一LLM调用接口
-    - [ ] 统一LLM调用返回格式为专有数据模型
-    - [ ] 取消所有__init__方法中对LLM Client的初始化，转而使用获取方式
-        - [ ] 统一使用`get_llm_client`方法获取LLM Client实例
-        - [ ] __init__方法中只保存配置信息
-- [ ] LLM Client管理器
-    - [ ] LLM Client单例/多例管理
-    - [ ] LLM Client缓存管理/生命周期管理
-    - [ ] LLM Client根据配置热重载
-
-
-## 一些细枝末节的东西
-- [ ] 将`stream_id`和`chat_id`统一命名为`session_id`
-- [ ] 映射表
-    - [ ] `platform_group_user_session_id_map` `平台_群组_用户`-`会话ID` 映射表
-- [ ] 将大部分的数据模型均以`Mai`开头命名
-- [x] logger的颜色配置修改为HEX格式，使用自动转换为256色/真彩色的方式实现兼容，同时增加了背景颜色和加粗选项
-
-### 细节说明
-1. Prompt管理系统中保存用户自定义Prompt的时候会只保存被标记为需要保存的Prompt，其他的Prompt文件会全部删除，以防止用户删除Prompt后文件依然存在的问题。因此，如果想在运行时通过修改文件的方式来添加Prompt，需要确保通过对应方法标记该Prompt为需要保存，否则在下一次保存时会被删除。
\ No newline at end of file

From f85eb11edbc164d8e63e88fbcba1354860fb30b5 Mon Sep 17 00:00:00 2001
From: DrSmoothl <1787882683@qq.com>
Date: Fri, 1 May 2026 17:00:05 +0800
Subject: [PATCH 2/9] =?UTF-8?q?feat:=20=E6=9B=B4=E6=96=B0WebUI=E7=89=88?=
 =?UTF-8?q?=E6=9C=AC=E5=8F=B7=E8=87=B3=201.0.1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 dashboard/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dashboard/package.json b/dashboard/package.json
index e88f073139..593113c111 100644
--- a/dashboard/package.json
+++ b/dashboard/package.json
@@ -1,7 +1,7 @@
 {
   "name": "maibot-dashboard",
   "private": true,
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "main": "./out/main/index.js",
   "scripts": {

From d9a509b6c25a3220d36c2da98a297e7d41f38c42 Mon Sep 17 00:00:00 2001
From: DrSmoothl <1787882683@qq.com>
Date: Fri, 1 May 2026 17:54:13 +0800
Subject: [PATCH 3/9] feat(chat): refactor chat message handling and introduce
 private messaging support

- Updated `uni_message_sender.py` to allow for private messaging by removing the mandatory group ID and adding user ID handling.
- Enhanced chat history retrieval and clearing functions in `routes.py` and `service.py` to support both group and private chat scenarios.
- Introduced a new `ChatScrollContext` for managing message scrolling and highlighting in the chat UI.
- Created a `ListItemEditorHookFactory` for rendering a rich UI editor for list items in configuration settings, replacing the previous JSON text display.
- Improved message serialization for consistent display in chat history.
- Added detailed logging for chat history operations and error handling.

Co-authored-by: Copilot <copilot@github.com>
---
 .../dynamic-form/DynamicConfigForm.tsx        |   2 +
 .../components/dynamic-form/DynamicField.tsx  |   4 +-
 dashboard/src/index.css                       |  17 +
 dashboard/src/lib/chat-ws-client.ts           |  77 +++-
 dashboard/src/lib/field-hooks.ts              |   6 +
 dashboard/src/lib/version.ts                  |   2 +-
 .../src/routes/chat/ChatScrollContext.tsx     |  14 +
 .../src/routes/chat/ChatWorkspaceSidebar.tsx  |   6 +-
 dashboard/src/routes/chat/MessageList.tsx     | 106 +++--
 dashboard/src/routes/chat/MessageRenderer.tsx | 127 +++++-
 dashboard/src/routes/chat/index.tsx           |  68 ++-
 dashboard/src/routes/chat/types.ts            |  36 +-
 .../config/bot/hooks/JsonFieldHookFactory.tsx |   2 +-
 .../bot/hooks/ListItemEditorHookFactory.tsx   | 283 +++++++++++++
 .../config/bot/hooks/complexFieldHooks.tsx    | 111 ++++-
 .../message_receive/uni_message_sender.py     |  13 +-
 src/webui/config_schema.py                    |   6 +-
 src/webui/routers/chat/routes.py              |  28 +-
 src/webui/routers/chat/service.py             | 386 ++++++++++++++----
 19 files changed, 1073 insertions(+), 221 deletions(-)
 create mode 100644 dashboard/src/routes/chat/ChatScrollContext.tsx
 create mode 100644 dashboard/src/routes/config/bot/hooks/ListItemEditorHookFactory.tsx

diff --git a/dashboard/src/components/dynamic-form/DynamicConfigForm.tsx b/dashboard/src/components/dynamic-form/DynamicConfigForm.tsx
index abb377c2cd..105d0f0e5a 100644
--- a/dashboard/src/components/dynamic-form/DynamicConfigForm.tsx
+++ b/dashboard/src/components/dynamic-form/DynamicConfigForm.tsx
@@ -157,6 +157,7 @@ export const DynamicConfigForm: React.FC<DynamicConfigFormProps> = ({
                     value={values[key]}
                     onChange={(v) => onChange(key, v)}
                     schema={nestedField ?? nestedSchema}
+                    nestedSchema={nestedSchema}
                   />
                 </div>
               )
@@ -169,6 +170,7 @@ export const DynamicConfigForm: React.FC<DynamicConfigFormProps> = ({
                   value={values[key]}
                   onChange={(v) => onChange(key, v)}
                   schema={nestedField ?? nestedSchema}
+                  nestedSchema={nestedSchema}
                 >
                   <DynamicConfigForm
                     schema={nestedSchema}
diff --git a/dashboard/src/components/dynamic-form/DynamicField.tsx b/dashboard/src/components/dynamic-form/DynamicField.tsx
index b1e4dc59c2..b3b8d5351e 100644
--- a/dashboard/src/components/dynamic-form/DynamicField.tsx
+++ b/dashboard/src/components/dynamic-form/DynamicField.tsx
@@ -183,7 +183,7 @@ export const DynamicField: React.FC<DynamicFieldProps> = ({
             {schema.required && <span className="text-destructive">*</span>}
           </Label>
           {schema.description && (
-            <p className="text-[13px] text-muted-foreground">{schema.description}</p>
+            <p className="text-[13px] text-muted-foreground whitespace-pre-line">{schema.description}</p>
           )}
         </div>
         <Switch
@@ -325,7 +325,7 @@ export const DynamicField: React.FC<DynamicFieldProps> = ({
 
       {/* Description */}
       {schema.description && (
-        <p className="text-[13px] text-muted-foreground">{schema.description}</p>
+        <p className="text-[13px] text-muted-foreground whitespace-pre-line">{schema.description}</p>
       )}
     </div>
   )
diff --git a/dashboard/src/index.css b/dashboard/src/index.css
index e1256388ad..5866b6255c 100644
--- a/dashboard/src/index.css
+++ b/dashboard/src/index.css
@@ -331,6 +331,23 @@
   .border-primary-gradient {
     border-image: var(--color-primary-gradient, linear-gradient(to right, hsl(var(--color-primary)), hsl(var(--color-primary)))) 1;
   }
+
+  /* 聊天消息行被回复点击命中时的高亮闪烁。 */
+  .chat-message-flash {
+    animation: chat-message-flash 1.6s ease-out;
+    border-radius: 0.75rem;
+  }
+}
+
+@keyframes chat-message-flash {
+  0% {
+    background-color: hsl(var(--color-primary) / 0.18);
+    box-shadow: 0 0 0 4px hsl(var(--color-primary) / 0.18);
+  }
+  100% {
+    background-color: transparent;
+    box-shadow: 0 0 0 0 transparent;
+  }
 }
 
 /* 禁用动效时的样式 */
diff --git a/dashboard/src/lib/chat-ws-client.ts b/dashboard/src/lib/chat-ws-client.ts
index 88e6fa7c38..f6f67a61e3 100644
--- a/dashboard/src/lib/chat-ws-client.ts
+++ b/dashboard/src/lib/chat-ws-client.ts
@@ -11,10 +11,31 @@ interface ChatSessionOpenPayload {
 
 type ChatSessionListener = (message: Record<string, unknown>) => void
 
+/** 浅层比较两个 session.open 负载是否完全一致。 */
+function arePayloadsEqual(
+  left: ChatSessionOpenPayload,
+  right: ChatSessionOpenPayload
+): boolean {
+  const keys = new Set<keyof ChatSessionOpenPayload>([
+    ...(Object.keys(left) as Array<keyof ChatSessionOpenPayload>),
+    ...(Object.keys(right) as Array<keyof ChatSessionOpenPayload>),
+  ])
+  for (const key of keys) {
+    if (left[key] !== right[key]) {
+      return false
+    }
+  }
+  return true
+}
+
 class ChatWsClient {
   private initialized = false
   private listeners: Map<string, Set<ChatSessionListener>> = new Map()
   private sessionPayloads: Map<string, ChatSessionOpenPayload> = new Map()
+  // 记录当前 WS 连接上已打开的会话，避免 React StrictMode 双挂载重复发送 ``session.open``。
+  private openedSessions: Set<string> = new Set()
+  // 记录正在进行中的打开请求，使同一会话的重复调用复用同一个 Promise。
+  private pendingOpens: Map<string, Promise<void>> = new Map()
 
   private initialize(): void {
     if (this.initialized) {
@@ -41,9 +62,20 @@ class ChatWsClient {
     })
 
     unifiedWsClient.onReconnect(() => {
+      // 重连后需要重新订阅，清空本地“已打开”标记。
+      this.openedSessions.clear()
+      this.pendingOpens.clear()
       void this.reopenSessions()
     })
 
+    unifiedWsClient.onConnectionChange((connected) => {
+      if (!connected) {
+        // 连接断开后，下次重新连上需要重新发送 session.open。
+        this.openedSessions.clear()
+        this.pendingOpens.clear()
+      }
+    })
+
     this.initialized = true
   }
 
@@ -60,6 +92,7 @@ class ChatWsClient {
             restore: true,
           } as Record<string, unknown>,
         })
+        this.openedSessions.add(sessionId)
       } catch (error) {
         console.error(`恢复聊天会话失败 (${sessionId}):`, error)
       }
@@ -68,17 +101,49 @@ class ChatWsClient {
 
   async openSession(sessionId: string, payload: ChatSessionOpenPayload): Promise<void> {
     this.initialize()
+
+    const previousPayload = this.sessionPayloads.get(sessionId)
     this.sessionPayloads.set(sessionId, payload)
-    await unifiedWsClient.call({
-      domain: 'chat',
-      method: 'session.open',
-      session: sessionId,
-      data: payload as Record<string, unknown>,
-    })
+
+    // 同一会话上一次打开请求还未完成 → 复用该 Promise，避免重复发送。
+    const inflight = this.pendingOpens.get(sessionId)
+    if (inflight) {
+      await inflight
+      return
+    }
+
+    // 如果该会话在当前 WS 连接上已经打开，且负载未变化，则跳过，避免服务端重复断开/重连。
+    if (
+      this.openedSessions.has(sessionId) &&
+      previousPayload !== undefined &&
+      arePayloadsEqual(previousPayload, payload)
+    ) {
+      return
+    }
+
+    const openPromise = unifiedWsClient
+      .call({
+        domain: 'chat',
+        method: 'session.open',
+        session: sessionId,
+        data: payload as Record<string, unknown>,
+      })
+      .then(() => {
+        this.openedSessions.add(sessionId)
+      })
+
+    this.pendingOpens.set(sessionId, openPromise)
+    try {
+      await openPromise
+    } finally {
+      this.pendingOpens.delete(sessionId)
+    }
   }
 
   async closeSession(sessionId: string): Promise<void> {
     this.sessionPayloads.delete(sessionId)
+    this.openedSessions.delete(sessionId)
+    this.pendingOpens.delete(sessionId)
     if (unifiedWsClient.getStatus() !== 'connected') {
       return
     }
diff --git a/dashboard/src/lib/field-hooks.ts b/dashboard/src/lib/field-hooks.ts
index 9efa691ba1..438c5d8d11 100644
--- a/dashboard/src/lib/field-hooks.ts
+++ b/dashboard/src/lib/field-hooks.ts
@@ -15,6 +15,12 @@ export interface FieldHookComponentProps {
   onChange?: (value: unknown) => void
   children?: ReactNode
   schema?: ConfigSchema | FieldSchema
+  /**
+   * 如果当前字段是 `List[ConfigBase]` 或嵌套 ConfigBase，
+   * 这里会传入对应子配置类的 ConfigSchema，便于自定义编辑器
+   * 直接渲染列表项的字段。
+   */
+  nestedSchema?: ConfigSchema
 }
 
 /**
diff --git a/dashboard/src/lib/version.ts b/dashboard/src/lib/version.ts
index 4b85d2b252..a6be3db10c 100644
--- a/dashboard/src/lib/version.ts
+++ b/dashboard/src/lib/version.ts
@@ -5,7 +5,7 @@
  * 修改此处的版本号后，所有展示版本的地方都会自动更新
  */
 
-export const APP_VERSION = '1.0.0'
+export const APP_VERSION = '1.0.1'
 export const APP_NAME = 'MaiBot Dashboard'
 export const APP_FULL_NAME = `${APP_NAME} v${APP_VERSION}`
 
diff --git a/dashboard/src/routes/chat/ChatScrollContext.tsx b/dashboard/src/routes/chat/ChatScrollContext.tsx
new file mode 100644
index 0000000000..3ef7eed420
--- /dev/null
+++ b/dashboard/src/routes/chat/ChatScrollContext.tsx
@@ -0,0 +1,14 @@
+import { createContext, useContext } from 'react'
+
+/** 暴露给消息内容渲染器使用的滚动 / 高亮接口。 */
+export interface ChatScrollContextValue {
+  /** 滚动并高亮指定消息；若消息不在可视列表中则返回 ``false``。 */
+  scrollToMessage: (messageId: string) => boolean
+}
+
+export const ChatScrollContext = createContext<ChatScrollContextValue | null>(null)
+
+/** 在消息列表内部使用：访问 ``scrollToMessage`` 等能力。 */
+export function useChatScroll(): ChatScrollContextValue | null {
+  return useContext(ChatScrollContext)
+}
diff --git a/dashboard/src/routes/chat/ChatWorkspaceSidebar.tsx b/dashboard/src/routes/chat/ChatWorkspaceSidebar.tsx
index 8892db09c8..e83df5d757 100644
--- a/dashboard/src/routes/chat/ChatWorkspaceSidebar.tsx
+++ b/dashboard/src/routes/chat/ChatWorkspaceSidebar.tsx
@@ -22,9 +22,8 @@ interface ChatWorkspaceSidebarProps {
   onUpdateUserName: (name: string) => void
 }
 
-function getMessagePreview(message: ChatMessage | undefined, fallback: string, thinking: string) {
+function getMessagePreview(message: ChatMessage | undefined, fallback: string) {
   if (!message) return fallback
-  if (message.type === 'thinking') return thinking
   if (message.type === 'system' || message.type === 'error') return message.content || fallback
   return message.content || fallback
 }
@@ -45,8 +44,7 @@ function ConversationItem({
   const lastMessage = tab.messages[tab.messages.length - 1]
   const preview = getMessagePreview(
     lastMessage,
-    t('chat.sidebar.emptyPreview'),
-    t('chat.message.thinking')
+    t('chat.sidebar.emptyPreview')
   )
   const Icon = isVirtual ? UserCircle2 : Bot
 
diff --git a/dashboard/src/routes/chat/MessageList.tsx b/dashboard/src/routes/chat/MessageList.tsx
index f1e0848ff0..65160556bc 100644
--- a/dashboard/src/routes/chat/MessageList.tsx
+++ b/dashboard/src/routes/chat/MessageList.tsx
@@ -1,11 +1,12 @@
 import { Bot, Sparkles, User } from 'lucide-react'
-import { useEffect, useRef } from 'react'
+import { useCallback, useEffect, useMemo, useRef } from 'react'
 import { useTranslation } from 'react-i18next'
 
-import { Avatar, AvatarFallback } from '@/components/ui/avatar'
+import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar'
 import { ScrollArea } from '@/components/ui/scroll-area'
 import { cn } from '@/lib/utils'
 
+import { ChatScrollContext, type ChatScrollContextValue } from './ChatScrollContext'
 import { RenderMessageContent } from './MessageRenderer'
 import type { ChatMessage } from './types'
 
@@ -13,20 +14,27 @@ interface MessageListProps {
   messages: ChatMessage[]
   isLoadingHistory: boolean
   botDisplayName: string
+  /** 机器人 QQ 号；存在时会从 QQ 头像公开接口拉取头像作为 bot 头像。 */
+  botQq?: string
   userName: string
   language: string
 }
 
 interface BubbleAvatarProps {
-  type: 'user' | 'bot' | 'thinking'
+  type: 'user' | 'bot'
   visible: boolean
+  /** bot 头像 URL（可选）；加载失败时自动 fallback 到默认 SVG 图标。 */
+  imageUrl?: string
 }
 
-function BubbleAvatar({ type, visible }: BubbleAvatarProps) {
+function BubbleAvatar({ type, visible, imageUrl }: BubbleAvatarProps) {
   return (
     <div className="h-8 w-8 shrink-0 sm:h-9 sm:w-9">
       {visible && (
         <Avatar className="h-full w-full ring-1 ring-border/60">
+          {type === 'bot' && imageUrl ? (
+            <AvatarImage src={imageUrl} alt="" className="object-cover" />
+          ) : null}
           <AvatarFallback
             className={cn(
               'text-xs',
@@ -47,20 +55,6 @@ function BubbleAvatar({ type, visible }: BubbleAvatarProps) {
   )
 }
 
-function ThinkingBubble() {
-  const { t } = useTranslation()
-  return (
-    <div className="bg-muted/80 text-muted-foreground inline-flex items-center gap-2 rounded-2xl rounded-bl-sm px-3.5 py-2.5">
-      <span className="flex gap-1">
-        <span className="bg-primary/60 h-1.5 w-1.5 animate-bounce rounded-full [animation-delay:0ms]" />
-        <span className="bg-primary/60 h-1.5 w-1.5 animate-bounce rounded-full [animation-delay:150ms]" />
-        <span className="bg-primary/60 h-1.5 w-1.5 animate-bounce rounded-full [animation-delay:300ms]" />
-      </span>
-      <span className="text-xs">{t('chat.message.thinking')}</span>
-    </div>
-  )
-}
-
 function EmptyState({ botName }: { botName: string }) {
   const { t } = useTranslation()
   return (
@@ -80,22 +74,42 @@ function EmptyState({ botName }: { botName: string }) {
 }
 
 /**
- * 聊天消息列表：支持连续同发送者消息分组、思考占位、富文本与系统/错误信息样式。
+ * 聊天消息列表：支持连续同发送者消息分组、富文本与系统/错误信息样式。
  */
 export function MessageList({
   messages,
   isLoadingHistory,
   botDisplayName,
+  botQq,
   userName,
   language,
 }: MessageListProps) {
   const { t } = useTranslation()
   const endRef = useRef<HTMLDivElement>(null)
+  const messageRefs = useRef<Map<string, HTMLDivElement>>(new Map())
 
   useEffect(() => {
     endRef.current?.scrollIntoView({ behavior: 'smooth' })
   }, [messages])
 
+  const scrollToMessage = useCallback((messageId: string) => {
+    const target = messageRefs.current.get(messageId)
+    if (!target) {
+      return false
+    }
+    target.scrollIntoView({ behavior: 'smooth', block: 'center' })
+    target.classList.add('chat-message-flash')
+    window.setTimeout(() => {
+      target.classList.remove('chat-message-flash')
+    }, 1600)
+    return true
+  }, [])
+
+  const scrollContextValue = useMemo<ChatScrollContextValue>(
+    () => ({ scrollToMessage }),
+    [scrollToMessage]
+  )
+
   const formatTime = (timestamp: number) => {
     const date = new Date(timestamp * 1000)
     return date.toLocaleTimeString(language || 'zh-CN', {
@@ -104,6 +118,11 @@ export function MessageList({
     })
   }
 
+  // 优先使用 q1.qlogo.cn s=640（高清），QQ 公开头像接口。
+  const botAvatarUrl = botQq && /^\d+$/.test(botQq)
+    ? `https://q1.qlogo.cn/g?b=qq&nk=${botQq}&s=640`
+    : undefined
+
   if (messages.length === 0 && !isLoadingHistory) {
     return (
       <div className="min-w-0 min-h-0 flex-1 overflow-hidden">
@@ -127,7 +146,8 @@ export function MessageList({
         scrollbars="vertical"
         viewportClassName="[&>div]:!block [&>div]:!min-w-0 [&>div]:w-full"
       >
-        <div className="mx-auto flex w-full max-w-4xl min-w-0 flex-col gap-1 px-3 py-5 sm:px-6 sm:py-6">
+        <ChatScrollContext.Provider value={scrollContextValue}>
+          <div className="mx-auto flex w-full max-w-4xl min-w-0 flex-col gap-1 px-3 py-5 sm:px-6 sm:py-6">
           {messages.map((message, index) => {
             // 系统消息：作为分隔条
             if (message.type === 'system') {
@@ -154,8 +174,7 @@ export function MessageList({
             }
 
             const isUser = message.type === 'user'
-            const isThinking = message.type === 'thinking'
-            const bubbleType: 'user' | 'bot' | 'thinking' = isUser ? 'user' : isThinking ? 'thinking' : 'bot'
+            const bubbleType: 'user' | 'bot' = isUser ? 'user' : 'bot'
 
             // 是否与上一条消息属于同一发送者（用于分组：仅首条显示头像 + 名字）
             const previous = messages[index - 1]
@@ -171,13 +190,25 @@ export function MessageList({
             return (
               <div
                 key={message.id}
+                ref={(node) => {
+                  if (node) {
+                    messageRefs.current.set(message.id, node)
+                  } else {
+                    messageRefs.current.delete(message.id)
+                  }
+                }}
+                data-message-id={message.id}
                 className={cn(
-                  'flex w-full min-w-0 items-end gap-2 sm:gap-3',
+                  'chat-message-row flex w-full min-w-0 items-end gap-2 sm:gap-3',
                   isUser ? 'flex-row-reverse' : 'flex-row',
                   sameGroup ? 'mt-0.5' : 'mt-3 first:mt-0'
                 )}
               >
-                <BubbleAvatar type={bubbleType === 'thinking' ? 'bot' : bubbleType} visible={!sameGroup} />
+                <BubbleAvatar
+                  type={bubbleType}
+                  visible={!sameGroup}
+                  imageUrl={bubbleType === 'bot' ? botAvatarUrl : undefined}
+                />
 
                 <div
                   className={cn(
@@ -197,20 +228,16 @@ export function MessageList({
                     </div>
                   )}
 
-                  {isThinking ? (
-                    <ThinkingBubble />
-                  ) : (
-                    <div
-                      className={cn(
-                        'shadow-sm/30 wrap-break-word min-w-0 max-w-full overflow-hidden px-3.5 py-2 text-sm leading-relaxed',
-                        isUser
-                          ? 'bg-primary text-primary-foreground rounded-2xl rounded-br-md'
-                          : 'bg-muted text-foreground rounded-2xl rounded-bl-md'
-                      )}
-                    >
-                      <RenderMessageContent message={message} isBot={!isUser} />
-                    </div>
-                  )}
+                  <div
+                    className={cn(
+                      'shadow-sm/30 wrap-break-word min-w-0 max-w-full overflow-hidden px-3.5 py-2 text-sm leading-relaxed',
+                      isUser
+                        ? 'bg-primary text-primary-foreground rounded-2xl rounded-br-md'
+                        : 'bg-muted text-foreground rounded-2xl rounded-bl-md'
+                    )}
+                  >
+                    <RenderMessageContent message={message} isBot={!isUser} />
+                  </div>
                 </div>
               </div>
             )
@@ -220,7 +247,8 @@ export function MessageList({
           <span className="sr-only" aria-live="polite">
             {messages.length > 0 ? t('chat.sidebar.subtitle', { count: messages.length }) : ''}
           </span>
-        </div>
+          </div>
+        </ChatScrollContext.Provider>
       </ScrollArea>
     </div>
   )
diff --git a/dashboard/src/routes/chat/MessageRenderer.tsx b/dashboard/src/routes/chat/MessageRenderer.tsx
index e60ff1e34d..95c7a119b7 100644
--- a/dashboard/src/routes/chat/MessageRenderer.tsx
+++ b/dashboard/src/routes/chat/MessageRenderer.tsx
@@ -1,8 +1,30 @@
+import { Reply as ReplyIcon } from 'lucide-react'
 import { useTranslation } from 'react-i18next'
 
+import { useToast } from '@/hooks/use-toast'
 import { cn } from '@/lib/utils'
 
-import type { ChatMessage, MessageSegment } from './types'
+import { useChatScroll } from './ChatScrollContext'
+import type {
+  AtSegmentData,
+  ChatMessage,
+  MessageSegment,
+  ReplySegmentData,
+} from './types'
+
+function normalizeAtSegment(segment: MessageSegment): AtSegmentData {
+  if (segment.data && typeof segment.data === 'object') {
+    return segment.data as AtSegmentData
+  }
+  return { target_user_id: segment.data == null ? null : String(segment.data) }
+}
+
+function normalizeReplySegment(segment: MessageSegment): ReplySegmentData {
+  if (segment.data && typeof segment.data === 'object') {
+    return segment.data as ReplySegmentData
+  }
+  return { target_message_id: segment.data == null ? null : String(segment.data) }
+}
 
 // 渲染单个消息段
 export function RenderMessageSegment({ segment }: { segment: MessageSegment }) {
@@ -74,8 +96,27 @@ export function RenderMessageSegment({ segment }: { segment: MessageSegment }) {
         </span>
       )
 
-    case 'reply':
-      return <span className="text-muted-foreground text-xs">{t('chat.media.reply')}</span>
+    case 'reply': {
+      const replyData = normalizeReplySegment(segment)
+      return <ReplySegmentBlock data={replyData} />
+    }
+
+    case 'at': {
+      const atData = normalizeAtSegment(segment)
+      const atLabel =
+        atData.target_user_cardname ||
+        atData.target_user_nickname ||
+        atData.target_user_id ||
+        ''
+      return (
+        <span
+          className="text-primary bg-primary/10 mx-0.5 inline-flex items-center rounded px-1 text-[0.95em] font-medium"
+          title={atData.target_user_id ? `@${atData.target_user_id}` : '@'}
+        >
+          @{atLabel || t('chat.media.unknownMessage')}
+        </span>
+      )
+    }
 
     case 'forward':
       return <span className="text-muted-foreground">{t('chat.media.forward')}</span>
@@ -103,11 +144,29 @@ export function RenderMessageContent({
 }) {
   // 如果是富文本消息，渲染消息段
   if (message.message_type === 'rich' && message.segments && message.segments.length > 0) {
+    // 将 reply 段与后续内容拆开，避免回复块与文本出现在同一行上。
+    const inlineSegments: MessageSegment[] = []
+    const replySegments: MessageSegment[] = []
+    for (const segment of message.segments) {
+      if (segment.type === 'reply') {
+        replySegments.push(segment)
+      } else {
+        inlineSegments.push(segment)
+      }
+    }
+
     return (
       <div className="flex flex-col gap-2">
-        {message.segments.map((segment, index) => (
-          <RenderMessageSegment key={index} segment={segment} />
+        {replySegments.map((segment, index) => (
+          <RenderMessageSegment key={`reply-${index}`} segment={segment} />
         ))}
+        {inlineSegments.length > 0 && (
+          <div className="flex flex-wrap items-baseline whitespace-pre-wrap">
+            {inlineSegments.map((segment, index) => (
+              <RenderMessageSegment key={`inline-${index}`} segment={segment} />
+            ))}
+          </div>
+        )}
       </div>
     )
   }
@@ -115,3 +174,61 @@ export function RenderMessageContent({
   // 普通文本消息
   return <span className="whitespace-pre-wrap">{message.content}</span>
 }
+
+// 回复消息块：点击可跳转到原始消息；如原消息不可见则提示错误。
+function ReplySegmentBlock({ data }: { data: ReplySegmentData }) {
+  const { t } = useTranslation()
+  const { toast } = useToast()
+  const chatScroll = useChatScroll()
+
+  const senderName =
+    data.target_message_sender_cardname ||
+    data.target_message_sender_nickname ||
+    data.target_message_sender_id ||
+    t('chat.message.replyUnknownSender', { defaultValue: '未知发送者' })
+  const previewText =
+    data.target_message_content?.trim() ||
+    t('chat.media.replyMissing', { defaultValue: '原消息内容不可用' })
+  const targetMessageId = data.target_message_id ? String(data.target_message_id) : ''
+  const isClickable = Boolean(targetMessageId && chatScroll)
+
+  const handleClick = () => {
+    if (!targetMessageId || !chatScroll) {
+      return
+    }
+    const found = chatScroll.scrollToMessage(targetMessageId)
+    if (!found) {
+      toast({
+        title: t('chat.toast.replyNotFoundTitle', { defaultValue: '原始消息不在当前视图' }),
+        description: t('chat.toast.replyNotFoundDescription', {
+          defaultValue: '该消息可能已被清除、不在本会话中，或者尚未加载。',
+        }),
+        variant: 'destructive',
+      })
+    }
+  }
+
+  const className = cn(
+    'group block w-full rounded-md border-l-2 border-primary/60 bg-background/40 px-2 py-1 text-left text-xs',
+    isClickable && 'cursor-pointer transition hover:bg-background/70'
+  )
+
+  const content = (
+    <div className="flex items-start gap-2">
+      <ReplyIcon className="mt-0.5 h-3 w-3 shrink-0 opacity-70" aria-hidden />
+      <div className="min-w-0 flex-1">
+        <div className="text-primary/80 truncate text-[11px] font-medium">{senderName}</div>
+        <div className="text-muted-foreground truncate">{previewText}</div>
+      </div>
+    </div>
+  )
+
+  if (isClickable) {
+    return (
+      <button type="button" className={className} onClick={handleClick}>
+        {content}
+      </button>
+    )
+  }
+  return <div className={className}>{content}</div>
+}
diff --git a/dashboard/src/routes/chat/index.tsx b/dashboard/src/routes/chat/index.tsx
index 115fe6e72c..22e2827040 100644
--- a/dashboard/src/routes/chat/index.tsx
+++ b/dashboard/src/routes/chat/index.tsx
@@ -214,6 +214,7 @@ export function ChatPage() {
               user_id: data.user_id,
               user_name: data.user_name,
               bot_name: data.bot_name,
+              bot_qq: data.bot_qq,
             },
           })
           break
@@ -278,7 +279,6 @@ export function ChatPage() {
           setTabs((prev) =>
             prev.map((tab) => {
               if (tab.id !== tabId) return tab
-              const filteredMessages = tab.messages.filter((msg) => msg.type !== 'thinking')
               const newMessage: ChatMessage = {
                 id: generateMessageId('bot'),
                 type: 'bot',
@@ -290,7 +290,7 @@ export function ChatPage() {
               }
               return {
                 ...tab,
-                messages: [...filteredMessages, newMessage],
+                messages: [...tab.messages, newMessage],
               }
             })
           )
@@ -305,11 +305,10 @@ export function ChatPage() {
           setTabs((prev) =>
             prev.map((tab) => {
               if (tab.id !== tabId) return tab
-              const filteredMessages = tab.messages.filter((msg) => msg.type !== 'thinking')
               return {
                 ...tab,
                 messages: [
-                  ...filteredMessages,
+                  ...tab.messages,
                   {
                     id: generateMessageId('error'),
                     type: 'error' as const,
@@ -330,33 +329,27 @@ export function ChatPage() {
         case 'history': {
           const historyMessages = data.messages || []
           const processedSet = new Set<string>()
-          const formattedMessages: ChatMessage[] = historyMessages.map(
-            (msg: {
-              id?: string
-              content: string
-              timestamp: number
-              sender_name?: string
-              sender_id?: string
-              is_bot?: boolean
-            }) => {
-              const isBot = msg.is_bot || false
-              const msgId = msg.id || generateMessageId(isBot ? 'bot' : 'user')
-              const contentHash = `${isBot ? 'bot' : 'user'}-${msg.content}-${Math.floor(msg.timestamp * 1000)}`
-              processedSet.add(contentHash)
-              return {
-                id: msgId,
-                type: isBot ? 'bot' : ('user' as const),
-                content: msg.content,
-                timestamp: msg.timestamp,
-                sender: {
-                  name:
-                    msg.sender_name || (isBot ? t('chat.botNameFallback') : t('chat.userFallback')),
-                  user_id: msg.sender_id,
-                  is_bot: isBot,
-                },
-              }
+          const formattedMessages: ChatMessage[] = historyMessages.map((msg) => {
+            const isBot = msg.is_bot || false
+            const msgId = msg.id || generateMessageId(isBot ? 'bot' : 'user')
+            const contentHash = `${isBot ? 'bot' : 'user'}-${msg.content}-${Math.floor(msg.timestamp * 1000)}`
+            processedSet.add(contentHash)
+            const isRich = msg.message_type === 'rich' && Array.isArray(msg.segments) && msg.segments.length > 0
+            return {
+              id: msgId,
+              type: isBot ? 'bot' : ('user' as const),
+              content: msg.content,
+              timestamp: msg.timestamp,
+              message_type: isRich ? 'rich' : 'text',
+              segments: isRich ? (msg.segments ?? undefined) : undefined,
+              sender: {
+                name:
+                  msg.sender_name || (isBot ? t('chat.botNameFallback') : t('chat.userFallback')),
+                user_id: msg.sender_id,
+                is_bot: isBot,
+              },
             }
-          )
+          })
 
           processedMessagesMapRef.current.set(tabId, processedSet)
           updateTab(tabId, { messages: formattedMessages })
@@ -509,19 +502,6 @@ export function ChatPage() {
     }
     addMessageToTab(activeTabId, userMessage)
 
-    // 再添加"思考中"占位消息
-    const thinkingMessage: ChatMessage = {
-      id: generateMessageId('thinking'),
-      type: 'thinking',
-      content: '',
-      timestamp: currentTimestamp + 0.001, // 稍微晚一点确保顺序
-      sender: {
-        name: activeTab?.sessionInfo.bot_name || t('chat.botNameFallback'),
-        is_bot: true,
-      },
-    }
-    addMessageToTab(activeTabId, thinkingMessage)
-
     setInputValue('')
 
     try {
@@ -534,7 +514,6 @@ export function ChatPage() {
           return {
             ...tab,
             isTyping: false,
-            messages: tab.messages.filter((msg) => msg.type !== 'thinking'),
           }
         })
       )
@@ -759,6 +738,7 @@ export function ChatPage() {
           messages={activeTab?.messages ?? []}
           isLoadingHistory={isLoadingHistory}
           botDisplayName={botDisplayName}
+          botQq={activeTab?.sessionInfo.bot_qq}
           userName={userName}
           language={i18n.language}
         />
diff --git a/dashboard/src/routes/chat/types.ts b/dashboard/src/routes/chat/types.ts
index a8778ba690..dc75c8c854 100644
--- a/dashboard/src/routes/chat/types.ts
+++ b/dashboard/src/routes/chat/types.ts
@@ -49,20 +49,49 @@ export interface ChatTab {
     user_id?: string
     user_name?: string
     bot_name?: string
+    bot_qq?: string
   }
 }
 
 // 消息段类型
 export interface MessageSegment {
-  type: 'text' | 'image' | 'emoji' | 'face' | 'voice' | 'video' | 'music' | 'file' | 'reply' | 'forward' | 'unknown'
+  type:
+    | 'text'
+    | 'image'
+    | 'emoji'
+    | 'face'
+    | 'voice'
+    | 'video'
+    | 'music'
+    | 'file'
+    | 'reply'
+    | 'at'
+    | 'forward'
+    | 'unknown'
   data: string | number | object
   original_type?: string
 }
 
+// @某人 消息段的负载
+export interface AtSegmentData {
+  target_user_id?: string | null
+  target_user_nickname?: string | null
+  target_user_cardname?: string | null
+}
+
+// 回复消息段的负载
+export interface ReplySegmentData {
+  target_message_id?: string | null
+  target_message_content?: string | null
+  target_message_sender_id?: string | null
+  target_message_sender_nickname?: string | null
+  target_message_sender_cardname?: string | null
+}
+
 // 消息类型
 export interface ChatMessage {
   id: string
-  type: 'user' | 'bot' | 'system' | 'error' | 'thinking'
+  type: 'user' | 'bot' | 'system' | 'error'
   content: string
   timestamp: number
   message_type?: 'text' | 'rich'  // 消息格式类型
@@ -85,6 +114,7 @@ export interface WsMessage {
   user_id?: string
   user_name?: string
   bot_name?: string
+  bot_qq?: string
   sender?: {
     name: string
     user_id?: string
@@ -98,6 +128,8 @@ export interface WsMessage {
     sender_name?: string
     sender_id?: string
     is_bot?: boolean
+    message_type?: string
+    segments?: MessageSegment[] | null
   }>
   group_id?: string
   // 富文本消息
diff --git a/dashboard/src/routes/config/bot/hooks/JsonFieldHookFactory.tsx b/dashboard/src/routes/config/bot/hooks/JsonFieldHookFactory.tsx
index 71692ca37d..90c213d7e0 100644
--- a/dashboard/src/routes/config/bot/hooks/JsonFieldHookFactory.tsx
+++ b/dashboard/src/routes/config/bot/hooks/JsonFieldHookFactory.tsx
@@ -67,7 +67,7 @@ export function createJsonFieldHook(options: JsonFieldHookOptions): FieldHookCom
         <div className="space-y-1">
           <h3 className="text-base font-semibold">{label}</h3>
           {description && (
-            <p className="text-sm text-muted-foreground">{description}</p>
+            <p className="text-sm text-muted-foreground whitespace-pre-line">{description}</p>
           )}
           <p className="text-xs text-muted-foreground">{options.helperText}</p>
         </div>
diff --git a/dashboard/src/routes/config/bot/hooks/ListItemEditorHookFactory.tsx b/dashboard/src/routes/config/bot/hooks/ListItemEditorHookFactory.tsx
new file mode 100644
index 0000000000..c08f1cc378
--- /dev/null
+++ b/dashboard/src/routes/config/bot/hooks/ListItemEditorHookFactory.tsx
@@ -0,0 +1,283 @@
+import { useCallback, useMemo } from 'react'
+import * as LucideIcons from 'lucide-react'
+import { Plus, Trash2 } from 'lucide-react'
+
+import { Button } from '@/components/ui/button'
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '@/components/ui/card'
+import { DynamicConfigForm } from '@/components/dynamic-form/DynamicConfigForm'
+import type { FieldHookComponent } from '@/lib/field-hooks'
+import type { ConfigSchema, FieldSchema } from '@/types/config-schema'
+
+/**
+ * createListItemEditorHook
+ *
+ * 通过 nestedSchema 渲染列表项式的富 UI 编辑器，替换原来直接展示 JSON 文本的 fallback。
+ * 适用于 `List[ConfigBase]` 类型字段（schema.nested 中存在对应子配置类）。
+ */
+export interface ListItemEditorOptions {
+  /** 用于生成每个 item 的标题，如 `${index+1} · ${item.platform}` */
+  itemTitle?: (item: Record<string, unknown>, index: number) => string
+  /** 添加按钮文案 */
+  addLabel?: string
+  /** 顶部辅助说明 */
+  helperText?: string
+  /** 列表为空时的占位说明 */
+  emptyText?: string
+  /** 顶部图标（覆盖 schema 自带的 x-icon） */
+  iconName?: string
+}
+
+function resolveLabel(schema?: ConfigSchema | FieldSchema, fieldPath?: string): string {
+  if (!schema) {
+    return fieldPath?.split('.').at(-1) ?? '列表配置'
+  }
+  if ('label' in schema && schema.label) {
+    return schema.label
+  }
+  if ('uiLabel' in schema && schema.uiLabel) {
+    return schema.uiLabel
+  }
+  if ('classDoc' in schema && schema.classDoc) {
+    return schema.classDoc
+  }
+  if ('className' in schema && schema.className) {
+    return schema.className
+  }
+  return fieldPath?.split('.').at(-1) ?? '列表配置'
+}
+
+function resolveDescription(schema?: ConfigSchema | FieldSchema): string {
+  if (!schema) return ''
+  if ('description' in schema && schema.description) return schema.description
+  if ('classDoc' in schema && schema.classDoc) return schema.classDoc
+  return ''
+}
+
+function resolveIconName(
+  iconOverride: string | undefined,
+  schema?: ConfigSchema | FieldSchema,
+  nested?: ConfigSchema,
+): string | undefined {
+  if (iconOverride) return iconOverride
+  if (schema && 'x-icon' in schema && schema['x-icon']) return schema['x-icon']
+  if (nested?.uiIcon) return nested.uiIcon
+  return undefined
+}
+
+function renderLucideIcon(iconName: string | undefined, className: string) {
+  if (!iconName) return null
+  const Icon = LucideIcons[iconName as keyof typeof LucideIcons] as
+    | React.ComponentType<{ className?: string }>
+    | undefined
+  if (!Icon) return null
+  return <Icon className={className} />
+}
+
+/** 根据 itemSchema 字段默认值构造一个新 item */
+function buildDefaultItem(itemSchema: ConfigSchema | undefined): Record<string, unknown> {
+  if (!itemSchema?.fields) return {}
+  const next: Record<string, unknown> = {}
+  for (const field of itemSchema.fields) {
+    if ('default' in field && field.default !== undefined) {
+      // 数组/对象需要做一次浅拷贝，避免多个 item 共享同一引用
+      if (Array.isArray(field.default)) {
+        next[field.name] = [...field.default]
+      } else if (
+        field.default !== null &&
+        typeof field.default === 'object'
+      ) {
+        next[field.name] = { ...(field.default as Record<string, unknown>) }
+      } else {
+        next[field.name] = field.default
+      }
+      continue
+    }
+    switch (field.type) {
+      case 'boolean':
+        next[field.name] = false
+        break
+      case 'integer':
+      case 'number':
+        next[field.name] = 0
+        break
+      case 'array':
+        next[field.name] = []
+        break
+      case 'object':
+        next[field.name] = {}
+        break
+      case 'select':
+        next[field.name] = field.options?.[0] ?? ''
+        break
+      default:
+        next[field.name] = ''
+    }
+  }
+  return next
+}
+
+/**
+ * 把 dotted-path 写入 item 对象（兼容 DynamicConfigForm 的 onChange）
+ */
+function setNested(target: Record<string, unknown>, path: string, value: unknown) {
+  const keys = path.split('.')
+  if (keys.length === 1) {
+    target[keys[0]] = value
+    return
+  }
+  let cursor: Record<string, unknown> = target
+  for (let i = 0; i < keys.length - 1; i++) {
+    const key = keys[i]
+    const existing = cursor[key]
+    if (existing && typeof existing === 'object' && !Array.isArray(existing)) {
+      cursor[key] = { ...(existing as Record<string, unknown>) }
+    } else {
+      cursor[key] = {}
+    }
+    cursor = cursor[key] as Record<string, unknown>
+  }
+  cursor[keys[keys.length - 1]] = value
+}
+
+export function createListItemEditorHook(
+  options: ListItemEditorOptions = {},
+): FieldHookComponent {
+  const ListItemEditorHook: FieldHookComponent = ({
+    fieldPath,
+    onChange,
+    schema,
+    nestedSchema,
+    value,
+  }) => {
+    const items = useMemo<Record<string, unknown>[]>(() => {
+      if (!Array.isArray(value)) return []
+      return value.map((item) =>
+        item && typeof item === 'object' && !Array.isArray(item)
+          ? (item as Record<string, unknown>)
+          : {},
+      )
+    }, [value])
+
+    const handleAdd = useCallback(() => {
+      const next = [...items, buildDefaultItem(nestedSchema)]
+      onChange?.(next)
+    }, [items, nestedSchema, onChange])
+
+    const handleRemove = useCallback(
+      (index: number) => {
+        const next = items.filter((_, idx) => idx !== index)
+        onChange?.(next)
+      },
+      [items, onChange],
+    )
+
+    const handleItemFieldChange = useCallback(
+      (index: number, fieldName: string, fieldValue: unknown) => {
+        const next = items.map((item, idx) => {
+          if (idx !== index) return item
+          const cloned = { ...item }
+          setNested(cloned, fieldName, fieldValue)
+          return cloned
+        })
+        onChange?.(next)
+      },
+      [items, onChange],
+    )
+
+    const label = resolveLabel(schema, fieldPath)
+    const description = resolveDescription(schema)
+    const iconName = resolveIconName(options.iconName, schema, nestedSchema)
+
+    if (!nestedSchema) {
+      return (
+        <Card>
+          <CardHeader>
+            <CardTitle className="text-base">{label}</CardTitle>
+            <CardDescription>未获取到子配置 schema，无法渲染富编辑器。</CardDescription>
+          </CardHeader>
+        </Card>
+      )
+    }
+
+    return (
+      <Card>
+        <CardHeader className="space-y-2 pb-4">
+          <div className="flex items-center gap-2">
+            {renderLucideIcon(iconName, 'h-5 w-5 text-muted-foreground')}
+            <CardTitle className="text-base">{label}</CardTitle>
+          </div>
+          {description && (
+            <CardDescription className="whitespace-pre-line">{description}</CardDescription>
+          )}
+          {options.helperText && (
+            <p className="text-xs text-muted-foreground">{options.helperText}</p>
+          )}
+        </CardHeader>
+        <CardContent className="space-y-3">
+          {items.length === 0 ? (
+            <div className="rounded-md border border-dashed border-muted-foreground/25 bg-muted/10 p-6 text-center text-sm text-muted-foreground">
+              {options.emptyText ?? '尚未添加任何条目，点击下方按钮新增。'}
+            </div>
+          ) : (
+            items.map((item, index) => {
+              const title =
+                options.itemTitle?.(item, index) ?? `条目 ${index + 1}`
+              return (
+                <div
+                  key={index}
+                  className="space-y-3 rounded-lg border bg-card/40 p-4"
+                >
+                  <div className="flex items-center justify-between gap-2">
+                    <div className="flex items-center gap-2 text-sm font-semibold">
+                      <span className="inline-flex h-6 min-w-6 items-center justify-center rounded-full bg-muted px-2 text-xs font-medium text-muted-foreground">
+                        {index + 1}
+                      </span>
+                      <span className="truncate">{title}</span>
+                    </div>
+                    <Button
+                      type="button"
+                      variant="ghost"
+                      size="sm"
+                      className="text-destructive hover:text-destructive"
+                      onClick={() => handleRemove(index)}
+                    >
+                      <Trash2 className="mr-1 h-4 w-4" />
+                      删除
+                    </Button>
+                  </div>
+                  <DynamicConfigForm
+                    schema={nestedSchema}
+                    values={item}
+                    onChange={(field, fieldValue) =>
+                      handleItemFieldChange(index, field, fieldValue)
+                    }
+                    basePath=""
+                    level={1}
+                  />
+                </div>
+              )
+            })
+          )}
+          <Button
+            type="button"
+            variant="outline"
+            size="sm"
+            onClick={handleAdd}
+            className="w-full"
+          >
+            <Plus className="mr-1 h-4 w-4" />
+            {options.addLabel ?? '添加一项'}
+          </Button>
+        </CardContent>
+      </Card>
+    )
+  }
+
+  return ListItemEditorHook
+}
diff --git a/dashboard/src/routes/config/bot/hooks/complexFieldHooks.tsx b/dashboard/src/routes/config/bot/hooks/complexFieldHooks.tsx
index 63da5ba376..a39e5cb4fa 100644
--- a/dashboard/src/routes/config/bot/hooks/complexFieldHooks.tsx
+++ b/dashboard/src/routes/config/bot/hooks/complexFieldHooks.tsx
@@ -1,15 +1,98 @@
 import { createJsonFieldHook } from './JsonFieldHookFactory'
+import { createListItemEditorHook } from './ListItemEditorHookFactory'
 
-export const ChatTalkValueRulesHook = createJsonFieldHook({
-  emptyValue: [],
-  helperText: '复杂对象数组使用 JSON 编辑。每一项对应一个聊天频率规则对象。',
-  placeholder: '[\n  {\n    "platform": "",\n    "item_id": "",\n    "rule_type": "group",\n    "time": "00:00-23:59",\n    "value": 1.0\n  }\n]',
+const ruleTypeLabel = (rule: unknown) => {
+  if (rule === 'private') return '私聊'
+  if (rule === 'group') return '群聊'
+  return rule ? String(rule) : '未指定'
+}
+
+const platformLabel = (item: Record<string, unknown>) => {
+  const platform = typeof item.platform === 'string' ? item.platform.trim() : ''
+  const itemId = typeof item.item_id === 'string' ? item.item_id.trim() : ''
+  if (!platform && !itemId) return '全局'
+  if (!platform) return itemId
+  if (!itemId) return platform
+  return `${platform}:${itemId}`
+}
+
+const truncate = (text: string, max = 32) => {
+  if (text.length <= max) return text
+  return `${text.slice(0, max)}…`
+}
+
+const collectStringList = (value: unknown): string[] => {
+  if (!Array.isArray(value)) return []
+  return value
+    .map((item) => (typeof item === 'string' ? item.trim() : ''))
+    .filter((item) => item.length > 0)
+}
+
+export const ChatTalkValueRulesHook = createListItemEditorHook({
+  addLabel: '添加发言频率规则',
+  helperText: '可按平台/聊天流/时段分别配置发言频率，留空表示全局。',
+  emptyText: '尚未配置任何规则，将使用全局默认频率。',
+  itemTitle: (item) => {
+    const time =
+      typeof item.time === 'string' && item.time.trim()
+        ? item.time.trim()
+        : '全天'
+    const value =
+      typeof item.value === 'number' ? item.value.toFixed(2) : '—'
+    return `${platformLabel(item)} · ${ruleTypeLabel(item.rule_type)} · ${time} · 频率 ${value}`
+  },
 })
 
-export const ExpressionLearningListHook = createJsonFieldHook({
-  emptyValue: [],
-  helperText: '表达学习配置较复杂，使用 JSON 编辑更稳妥。每一项对应一个学习规则。',
-  placeholder: '[\n  {\n    "platform": "",\n    "item_id": "",\n    "rule_type": "group",\n    "use_expression": true,\n    "enable_learning": true,\n    "enable_jargon_learning": true\n  }\n]',
+export const ExpressionLearningListHook = createListItemEditorHook({
+  addLabel: '添加表达学习规则',
+  helperText: '为不同聊天流单独配置是否启用表达/jargon 学习。',
+  emptyText: '尚未配置任何学习规则。',
+  itemTitle: (item) => {
+    const flags: string[] = []
+    if (item.use_expression) flags.push('表达')
+    if (item.enable_learning) flags.push('优化学习')
+    if (item.enable_jargon_learning) flags.push('jargon')
+    const flagText = flags.length ? flags.join(' / ') : '全部关闭'
+    return `${platformLabel(item)} · ${ruleTypeLabel(item.rule_type)} · ${flagText}`
+  },
+})
+
+export const KeywordRulesHook = createListItemEditorHook({
+  addLabel: '添加关键词规则',
+  helperText: '匹配命中后会用 reaction 内容作为额外上下文。keywords 至少填一条，或使用正则模式。',
+  emptyText: '尚未添加任何关键词规则。',
+  itemTitle: (item) => {
+    const keywords = collectStringList(item.keywords)
+    const regex = collectStringList(item.regex)
+    const reaction =
+      typeof item.reaction === 'string' ? item.reaction.trim() : ''
+    const left = keywords.length
+      ? `关键词 ${keywords.length} 条`
+      : regex.length
+        ? `正则 ${regex.length} 条`
+        : '未配置匹配项'
+    const right = reaction ? `→ ${truncate(reaction)}` : '→ 未填写反应'
+    return `${left} ${right}`
+  },
+})
+
+export const RegexRulesHook = createListItemEditorHook({
+  addLabel: '添加正则规则',
+  helperText: '正则模式按 Python 语法编写，命中时把 reaction 作为提示注入。',
+  emptyText: '尚未添加任何正则规则。',
+  itemTitle: (item) => {
+    const regex = collectStringList(item.regex)
+    const keywords = collectStringList(item.keywords)
+    const reaction =
+      typeof item.reaction === 'string' ? item.reaction.trim() : ''
+    const left = regex.length
+      ? `正则 ${regex.length} 条`
+      : keywords.length
+        ? `关键词 ${keywords.length} 条`
+        : '未配置匹配项'
+    const right = reaction ? `→ ${truncate(reaction)}` : '→ 未填写反应'
+    return `${left} ${right}`
+  },
 })
 
 export const ExpressionGroupsHook = createJsonFieldHook({
@@ -24,18 +107,6 @@ export const ExperimentalChatPromptsHook = createJsonFieldHook({
   placeholder: '[\n  {\n    "platform": "qq",\n    "item_id": "123456",\n    "rule_type": "group",\n    "prompt": "这里填写额外提示词"\n  }\n]',
 })
 
-export const KeywordRulesHook = createJsonFieldHook({
-  emptyValue: [],
-  helperText: '关键词规则为对象数组，建议直接编辑 JSON。',
-  placeholder: '[\n  {\n    "keywords": ["早安"],\n    "regex": [],\n    "reaction": "早安呀"\n  }\n]',
-})
-
-export const RegexRulesHook = createJsonFieldHook({
-  emptyValue: [],
-  helperText: '正则规则为对象数组，建议直接编辑 JSON。',
-  placeholder: '[\n  {\n    "keywords": [],\n    "regex": ["https?://[^\\\\s]+"],\n    "reaction": "检测到链接：[0]"\n  }\n]',
-})
-
 export const MCPRootItemsHook = createJsonFieldHook({
   emptyValue: [],
   helperText: 'MCP Roots 条目为对象数组，使用 JSON 编辑。',
diff --git a/src/chat/message_receive/uni_message_sender.py b/src/chat/message_receive/uni_message_sender.py
index 5a19bc468d..53157909cb 100644
--- a/src/chat/message_receive/uni_message_sender.py
+++ b/src/chat/message_receive/uni_message_sender.py
@@ -36,9 +36,9 @@ def get_webui_chat_broadcaster() -> Tuple[Any, Optional[str], Optional[str]]:
     if _webui_chat_broadcaster is None:
         try:
             from src.webui.routers.chat import WEBUI_CHAT_PLATFORM, chat_manager
-            from src.webui.routers.chat.service import WEBUI_CHAT_GROUP_ID
 
-            _webui_chat_broadcaster = (chat_manager, WEBUI_CHAT_PLATFORM, WEBUI_CHAT_GROUP_ID)
+            # 默认不再强制虚拟群聊；WebUI 默认走私聊频道，需要的话由调用者传入虚拟群 ID。
+            _webui_chat_broadcaster = (chat_manager, WEBUI_CHAT_PLATFORM, None)
         except ImportError:
             _webui_chat_broadcaster = (None, None, None)
     return _webui_chat_broadcaster
@@ -98,6 +98,14 @@ async def _send_message(message: SessionMessage, show_log: bool = True) -> bool:
                 message_type = "rich"
                 segments = message_segments
 
+            # 私聊场景下出站消息的 user_info 是机器人自己的身份，
+            # 真正的接收者用户 ID 由 send_service 写入 ``platform_io_target_user_id``。
+            target_user_id = ""
+            additional_config = message.message_info.additional_config or {}
+            raw_target_user_id = additional_config.get("platform_io_target_user_id")
+            if raw_target_user_id:
+                target_user_id = str(raw_target_user_id).strip()
+
             await chat_manager.broadcast_to_group(
                 group_id=group_id or default_group_id or "",
                 message={
@@ -113,6 +121,7 @@ async def _send_message(message: SessionMessage, show_log: bool = True) -> bool:
                         "is_bot": True,
                     },
                 },
+                user_id=target_user_id,
             )
 
             # 注意：机器人消息会由 MessageStorage.store_message 自动保存到数据库
diff --git a/src/webui/config_schema.py b/src/webui/config_schema.py
index 862da1e5e4..1f11faa22f 100644
--- a/src/webui/config_schema.py
+++ b/src/webui/config_schema.py
@@ -70,11 +70,15 @@ def _build_field_schema(
     ) -> Dict[str, Any]:
         field_docs = config_class.get_class_field_docs()
         field_type = cls._map_field_type(annotation)
+        raw_description = field_docs.get(field_name, field_info.description or "")
+        # `_wrap_` 标记在配置类 docstring 中表示该说明应作为块级注释（独立成行）
+        # 在前端展示时把它转为换行符，使描述以新行起始或在中间换行
+        description = raw_description.replace("_wrap_", "\n").strip("\n")
         schema: Dict[str, Any] = {
             "name": field_name,
             "type": field_type,
             "label": field_name,
-            "description": field_docs.get(field_name, field_info.description or ""),
+            "description": description,
             "required": field_info.is_required(),
         }
 
diff --git a/src/webui/routers/chat/routes.py b/src/webui/routers/chat/routes.py
index 4098839142..3c03227a4d 100644
--- a/src/webui/routers/chat/routes.py
+++ b/src/webui/routers/chat/routes.py
@@ -13,10 +13,10 @@
 from src.webui.dependencies import require_auth
 
 from .service import (
-    WEBUI_CHAT_GROUP_ID,
     WEBUI_CHAT_PLATFORM,
     chat_history,
     chat_manager,
+    normalize_webui_user_id,
 )
 
 logger = get_logger("webui.chat")
@@ -30,10 +30,15 @@ async def get_chat_history(
     user_id: Optional[str] = Query(default=None),
     group_id: Optional[str] = Query(default=None),
 ) -> Dict[str, object]:
-    """获取聊天历史记录。"""
-    del user_id
-    target_group_id = group_id or WEBUI_CHAT_GROUP_ID
-    history = chat_history.get_history(limit, target_group_id)
+    """获取聊天历史记录。
+
+    优先按 ``group_id`` 加载虚拟群聊历史；未提供时使用规范化后的 ``user_id`` 加载 WebUI 私聊历史。
+    """
+    if group_id:
+        history = chat_history.get_history(limit, group_id=group_id)
+    else:
+        normalized_user_id = normalize_webui_user_id(user_id)
+        history = chat_history.get_history(limit, user_id=normalized_user_id)
     return {"success": True, "messages": history, "total": len(history)}
 
 
@@ -100,10 +105,18 @@ async def get_persons_by_platform(
 
 @router.delete("/history")
 async def clear_chat_history(
+    user_id: Optional[str] = Query(default=None),
     group_id: Optional[str] = Query(default=None),
 ) -> Dict[str, object]:
-    """清空聊天历史记录。"""
-    deleted = chat_history.clear_history(group_id)
+    """清空聊天历史记录。
+
+    优先按 ``group_id`` 清理虚拟群聊历史；未提供时使用规范化后的 ``user_id`` 清理 WebUI 私聊历史。
+    """
+    if group_id:
+        deleted = chat_history.clear_history(group_id=group_id)
+    else:
+        normalized_user_id = normalize_webui_user_id(user_id)
+        deleted = chat_history.clear_history(user_id=normalized_user_id)
     return {"success": True, "message": f"已清空 {deleted} 条聊天记录"}
 
 
@@ -113,6 +126,5 @@ async def get_chat_info() -> Dict[str, object]:
     return {
         "bot_name": global_config.bot.nickname,
         "platform": WEBUI_CHAT_PLATFORM,
-        "group_id": WEBUI_CHAT_GROUP_ID,
         "active_sessions": len(chat_manager.active_connections),
     }
diff --git a/src/webui/routers/chat/service.py b/src/webui/routers/chat/service.py
index b8433b92b5..168d31903a 100644
--- a/src/webui/routers/chat/service.py
+++ b/src/webui/routers/chat/service.py
@@ -18,6 +18,8 @@
 from src.common.utils.utils_session import SessionUtils
 from src.config.config import global_config
 
+from .serializers import serialize_message_sequence
+
 logger = get_logger("webui.chat")
 
 WEBUI_CHAT_GROUP_ID = "webui_local_chat"
@@ -61,7 +63,7 @@ class ChatSessionConnection:
     client_session_id: str
     user_id: str
     user_name: str
-    active_group_id: str
+    channel_key: str
     virtual_config: Optional[VirtualIdentityConfig]
     sender: AsyncMessageSender
 
@@ -92,6 +94,21 @@ def _message_to_dict(self, msg: SessionMessage, group_id: Optional[str] = None)
         user_id = user_info.user_id or ""
         is_bot = is_bot_self(msg.platform, user_id)
 
+        # 将存库中的 raw_message 序列化为前端可识别的富文本消息段，
+        # 避免“刚刚收到的机器人回复是富文本，刷新后变成纯文本”的体验不一致。
+        segments: List[Dict[str, Any]] = []
+        try:
+            raw_message = getattr(msg, "raw_message", None)
+            if raw_message is not None and getattr(raw_message, "components", None):
+                segments = serialize_message_sequence(raw_message)
+        except Exception as exc:  # 仅记录警告，退化为纯文本
+            logger.debug(f"序列化历史消息段失败，退化为纯文本: {exc}")
+            segments = []
+
+        is_rich = bool(segments) and not (
+            len(segments) == 1 and segments[0].get("type") == "text"
+        )
+
         return {
             "id": msg.message_id,
             "type": "bot" if is_bot else "user",
@@ -100,32 +117,119 @@ def _message_to_dict(self, msg: SessionMessage, group_id: Optional[str] = None)
             "sender_name": user_info.user_nickname or (global_config.bot.nickname if is_bot else "未知用户"),
             "sender_id": "bot" if is_bot else user_id,
             "is_bot": is_bot,
+            "message_type": "rich" if is_rich else "text",
+            "segments": segments if is_rich else None,
         }
 
-    def _resolve_session_id(self, group_id: Optional[str]) -> str:
-        """根据群组标识解析聊天会话 ID。
+    def _enrich_reply_segments(
+        self,
+        segments: List[Dict[str, Any]],
+        message_index: Dict[str, SessionMessage],
+        session_id: Optional[str],
+    ) -> None:
+        """回填历史消息中 reply 段缺失的发送者/原内容字段。
+
+        DB 中持久化的 ReplyComponent 通常只保留了 ``target_message_id``，
+        ``target_message_content`` / ``target_message_sender_*`` 字段为空。
+        这里基于当前会话已加载的消息列表（必要时回查数据库）进行补全。
+
+        Args:
+            segments: 单条历史消息的消息段列表，原地修改。
+            message_index: 当前会话已加载消息的 ``message_id -> SessionMessage`` 索引。
+            session_id: 当前会话 ID，用于按 ID 单查时缩小范围。
+        """
+        for segment in segments:
+            if not isinstance(segment, dict) or segment.get("type") != "reply":
+                continue
+            data = segment.get("data")
+            if not isinstance(data, dict):
+                continue
+            target_message_id = data.get("target_message_id")
+            if not target_message_id:
+                continue
+
+            has_content = bool(str(data.get("target_message_content") or "").strip())
+            has_sender = any(
+                str(data.get(key) or "").strip()
+                for key in (
+                    "target_message_sender_id",
+                    "target_message_sender_nickname",
+                    "target_message_sender_cardname",
+                )
+            )
+            if has_content and has_sender:
+                continue
+
+            target_msg = message_index.get(str(target_message_id))
+            if target_msg is None:
+                # 退化为按 ID 单查（仅当不在当前窗口内时才付出 DB 代价）
+                try:
+                    from src.services.message_service import get_message_by_id
+
+                    target_msg = get_message_by_id(str(target_message_id), session_id or None)
+                except Exception as exc:
+                    logger.debug(f"按 ID 回查 reply 目标消息失败: {exc}")
+                    target_msg = None
+            if target_msg is None:
+                continue
+
+            user_info = target_msg.message_info.user_info
+            if not has_content:
+                content_text = (
+                    target_msg.processed_plain_text
+                    or target_msg.display_message
+                    or ""
+                )
+                data["target_message_content"] = content_text
+            if not has_sender:
+                data["target_message_sender_id"] = user_info.user_id or ""
+                data["target_message_sender_nickname"] = user_info.user_nickname or ""
+                data["target_message_sender_cardname"] = (
+                    getattr(user_info, "user_cardname", "") or ""
+                )
+
+    def _resolve_session_id(
+        self,
+        group_id: Optional[str] = None,
+        user_id: Optional[str] = None,
+    ) -> Optional[str]:
+        """根据会话标识解析内部聊天会话 ID。
+
+        优先按虚拟群聊解析；否则按 WebUI 私聊解析。
 
         Args:
-            group_id: 群组标识。
+            group_id: 群组标识（虚拟群聊模式）。
+            user_id: 用户标识（私聊模式）。
 
         Returns:
-            str: 内部聊天会话 ID。
+            Optional[str]: 内部聊天会话 ID；当 group_id 与 user_id 均未提供时返回 ``None``。
         """
-        target_group_id = group_id or WEBUI_CHAT_GROUP_ID
-        return SessionUtils.calculate_session_id(WEBUI_CHAT_PLATFORM, group_id=target_group_id)
+        if group_id:
+            return SessionUtils.calculate_session_id(WEBUI_CHAT_PLATFORM, group_id=group_id)
+        if user_id:
+            return SessionUtils.calculate_session_id(WEBUI_CHAT_PLATFORM, user_id=user_id)
+        return None
 
-    def get_history(self, limit: int = 50, group_id: Optional[str] = None) -> List[Dict[str, Any]]:
+    def get_history(
+        self,
+        limit: int = 50,
+        group_id: Optional[str] = None,
+        user_id: Optional[str] = None,
+    ) -> List[Dict[str, Any]]:
         """获取指定会话的历史消息。
 
         Args:
             limit: 最大返回条数。
-            group_id: 群组标识。
+            group_id: 群组标识（虚拟群聊模式）。
+            user_id: 用户标识（私聊模式）。
 
         Returns:
             List[Dict[str, Any]]: 历史消息列表。
         """
-        target_group_id = group_id or WEBUI_CHAT_GROUP_ID
-        session_id = self._resolve_session_id(target_group_id)
+        session_id = self._resolve_session_id(group_id=group_id, user_id=user_id)
+        if session_id is None:
+            logger.debug("获取聊天历史时缺少 group_id 与 user_id，返回空列表")
+            return []
         try:
             messages = find_messages(
                 session_id=session_id,
@@ -133,30 +237,54 @@ def get_history(self, limit: int = 50, group_id: Optional[str] = None) -> List[D
                 limit_mode="latest",
                 filter_command=False,
             )
-            result = [self._message_to_dict(msg, target_group_id) for msg in messages]
-            logger.debug(f"从数据库加载了 {len(result)} 条聊天记录 (group_id={target_group_id})")
+            # 构建 message_id -> SessionMessage 索引，用于回填历史中 reply 段的发送者/内容
+            # （DB 中通常只存了 target_message_id，target_message_content/sender_* 缺失）。
+            message_index: Dict[str, SessionMessage] = {}
+            for m in messages:
+                mid = getattr(m, "message_id", None)
+                if mid:
+                    message_index[str(mid)] = m
+
+            result: List[Dict[str, Any]] = []
+            for msg in messages:
+                item = self._message_to_dict(msg, group_id)
+                segments = item.get("segments")
+                if segments:
+                    self._enrich_reply_segments(segments, message_index, session_id)
+                result.append(item)
+            logger.debug(
+                f"从数据库加载了 {len(result)} 条聊天记录 (group_id={group_id}, user_id={user_id})"
+            )
             return result
         except Exception as exc:
             logger.error(f"从数据库加载聊天记录失败: {exc}")
             return []
 
-    def clear_history(self, group_id: Optional[str] = None) -> int:
+    def clear_history(
+        self,
+        group_id: Optional[str] = None,
+        user_id: Optional[str] = None,
+    ) -> int:
         """清空指定会话的历史消息。
 
         Args:
-            group_id: 群组标识。
+            group_id: 群组标识（虚拟群聊模式）。
+            user_id: 用户标识（私聊模式）。
 
         Returns:
             int: 被删除的消息数量。
         """
-        target_group_id = group_id or WEBUI_CHAT_GROUP_ID
-        session_id = self._resolve_session_id(target_group_id)
+        session_id = self._resolve_session_id(group_id=group_id, user_id=user_id)
+        if session_id is None:
+            return 0
         try:
             with get_db_session() as session:
                 statement = delete(Messages).where(col(Messages.session_id) == session_id)
                 result = session.exec(statement)
                 deleted = result.rowcount or 0
-            logger.info(f"已清空 {deleted} 条聊天记录 (group_id={target_group_id})")
+            logger.info(
+                f"已清空 {deleted} 条聊天记录 (group_id={group_id}, user_id={user_id})"
+            )
             return deleted
         except Exception as exc:
             logger.error(f"清空聊天记录失败: {exc}")
@@ -174,30 +302,30 @@ def __init__(self) -> None:
         self.group_sessions: Dict[str, Set[str]] = {}
         self.user_sessions: Dict[str, Set[str]] = {}
 
-    def _bind_group(self, session_id: str, group_id: str) -> None:
-        """为会话绑定群组索引。
+    def _bind_channel(self, session_id: str, channel_key: str) -> None:
+        """为会话绑定逻辑频道索引。
 
         Args:
             session_id: 内部会话 ID。
-            group_id: 群组标识。
+            channel_key: 频道键（``group:<gid>`` 或 ``private:<uid>``）。
         """
-        group_session_ids = self.group_sessions.setdefault(group_id, set())
-        group_session_ids.add(session_id)
+        channel_session_ids = self.group_sessions.setdefault(channel_key, set())
+        channel_session_ids.add(session_id)
 
-    def _unbind_group(self, session_id: str, group_id: str) -> None:
-        """移除会话与群组的索引关系。
+    def _unbind_channel(self, session_id: str, channel_key: str) -> None:
+        """移除会话与逻辑频道的索引关系。
 
         Args:
             session_id: 内部会话 ID。
-            group_id: 群组标识。
+            channel_key: 频道键。
         """
-        group_session_ids = self.group_sessions.get(group_id)
-        if group_session_ids is None:
+        channel_session_ids = self.group_sessions.get(channel_key)
+        if channel_session_ids is None:
             return
 
-        group_session_ids.discard(session_id)
-        if not group_session_ids:
-            del self.group_sessions[group_id]
+        channel_session_ids.discard(session_id)
+        if not channel_session_ids:
+            del self.group_sessions[channel_key]
 
     async def connect(
         self,
@@ -220,18 +348,39 @@ async def connect(
             virtual_config: 当前虚拟身份配置。
             sender: 发送消息到前端的异步回调。
         """
+        channel_key = compute_channel_key(virtual_config, user_id)
         existing_session_id = self.client_sessions.get((connection_id, client_session_id))
+        if existing_session_id is not None and existing_session_id == session_id:
+            # 同一物理连接 + 前端会话重复打开（常见于 React StrictMode 双挂载或客户端去抖失败），
+            # 直接复用现有会话并仅刷新可变字段，避免反复断开/重连产生噪声日志。
+            existing = self.active_connections.get(existing_session_id)
+            if existing is not None:
+                if existing.channel_key != channel_key:
+                    self._unbind_channel(existing_session_id, existing.channel_key)
+                    self._bind_channel(existing_session_id, channel_key)
+                    existing.channel_key = channel_key
+                existing.user_id = user_id
+                existing.user_name = user_name
+                existing.virtual_config = virtual_config
+                existing.sender = sender
+                logger.debug(
+                    "WebUI 聊天会话复用: session=%s, connection=%s, client_session=%s, channel=%s",
+                    session_id,
+                    connection_id,
+                    client_session_id,
+                    channel_key,
+                )
+                return
         if existing_session_id is not None:
             self.disconnect(existing_session_id)
 
-        active_group_id = get_current_group_id(virtual_config)
         session_connection = ChatSessionConnection(
             session_id=session_id,
             connection_id=connection_id,
             client_session_id=client_session_id,
             user_id=user_id,
             user_name=user_name,
-            active_group_id=active_group_id,
+            channel_key=channel_key,
             virtual_config=virtual_config,
             sender=sender,
         )
@@ -240,14 +389,14 @@ async def connect(
         self.client_sessions[(connection_id, client_session_id)] = session_id
         self.connection_sessions.setdefault(connection_id, set()).add(session_id)
         self.user_sessions.setdefault(user_id, set()).add(session_id)
-        self._bind_group(session_id, active_group_id)
+        self._bind_channel(session_id, channel_key)
         logger.info(
-            "WebUI 聊天会话已连接: session=%s, connection=%s, client_session=%s, user=%s, group=%s",
+            "WebUI 聊天会话已连接: session=%s, connection=%s, client_session=%s, user=%s, channel=%s",
             session_id,
             connection_id,
             client_session_id,
             user_id,
-            active_group_id,
+            channel_key,
         )
 
     def disconnect(self, session_id: str) -> None:
@@ -261,7 +410,7 @@ def disconnect(self, session_id: str) -> None:
             return
 
         self.client_sessions.pop((session_connection.connection_id, session_connection.client_session_id), None)
-        self._unbind_group(session_id, session_connection.active_group_id)
+        self._unbind_channel(session_id, session_connection.channel_key)
 
         connection_session_ids = self.connection_sessions.get(session_connection.connection_id)
         if connection_session_ids is not None:
@@ -327,11 +476,11 @@ def update_session_context(
         if session_connection is None:
             return
 
-        next_group_id = get_current_group_id(virtual_config)
-        if next_group_id != session_connection.active_group_id:
-            self._unbind_group(session_id, session_connection.active_group_id)
-            self._bind_group(session_id, next_group_id)
-            session_connection.active_group_id = next_group_id
+        next_channel_key = compute_channel_key(virtual_config, session_connection.user_id)
+        if next_channel_key != session_connection.channel_key:
+            self._unbind_channel(session_id, session_connection.channel_key)
+            self._bind_channel(session_id, next_channel_key)
+            session_connection.channel_key = next_channel_key
 
         session_connection.user_name = user_name
         session_connection.virtual_config = virtual_config
@@ -361,16 +510,40 @@ async def broadcast(self, message: Dict[str, Any]) -> None:
         for session_id in list(self.active_connections.keys()):
             await self.send_message(session_id, message)
 
-    async def broadcast_to_group(self, group_id: str, message: Dict[str, Any]) -> None:
-        """向指定群组下的全部逻辑会话广播消息。
+    async def broadcast_to_channel(self, channel_key: str, message: Dict[str, Any]) -> None:
+        """向指定逻辑频道下的全部会话广播消息。
 
         Args:
-            group_id: 群组标识。
+            channel_key: 频道键（``group:<gid>`` 或 ``private:<uid>``）。
             message: 待广播的消息内容。
         """
-        for session_id in list(self.group_sessions.get(group_id, set())):
+        for session_id in list(self.group_sessions.get(channel_key, set())):
             await self.send_message(session_id, message)
 
+    async def broadcast_to_group(
+        self,
+        group_id: Optional[str],
+        message: Dict[str, Any],
+        *,
+        user_id: Optional[str] = None,
+    ) -> None:
+        """向指定群组或私聊会话广播消息。
+
+        当 ``group_id`` 非空时按群聊广播；否则按 ``user_id`` 私聊广播。
+
+        Args:
+            group_id: 群组标识；为空时使用 ``user_id``。
+            message: 待广播的消息内容。
+            user_id: 私聊接收方用户 ID。
+        """
+        if group_id:
+            channel_key = f"group:{group_id}"
+        elif user_id:
+            channel_key = f"private:{user_id}"
+        else:
+            return
+        await self.broadcast_to_channel(channel_key, message)
+
 
 chat_history = ChatHistoryManager()
 chat_manager = ChatConnectionManager()
@@ -388,6 +561,24 @@ def is_virtual_mode_enabled(virtual_config: Optional[VirtualIdentityConfig]) ->
     return bool(virtual_config and virtual_config.enabled)
 
 
+def compute_channel_key(virtual_config: Optional[VirtualIdentityConfig], user_id: str) -> str:
+    """计算当前会话的逻辑频道键。
+
+    虚拟身份启用时使用虚拟群聊 ID，否则使用当前 WebUI 用户 ID 作为私聊频道。
+
+    Args:
+        virtual_config: 虚拟身份配置。
+        user_id: 当前 WebUI 用户 ID。
+
+    Returns:
+        str: 频道键，格式为 ``group:<gid>`` 或 ``private:<uid>``。
+    """
+    if is_virtual_mode_enabled(virtual_config):
+        assert virtual_config is not None
+        return f"group:{virtual_config.group_id}"
+    return f"private:{user_id}"
+
+
 def normalize_webui_user_id(user_id: Optional[str]) -> str:
     """标准化 WebUI 用户 ID。
 
@@ -500,6 +691,8 @@ def build_session_info_message(
     Returns:
         Dict[str, Any]: 会话信息消息。
     """
+    # bot_qq 用于前端从 QQ 头像公开接口拉取机器人头像（qq_account == 0 表示未配置，不推送）。
+    bot_qq_account = int(getattr(global_config.bot, "qq_account", 0) or 0)
     session_info_data: Dict[str, Any] = {
         "type": "session_info",
         "session_id": session_id,
@@ -507,6 +700,8 @@ def build_session_info_message(
         "user_name": user_name,
         "bot_name": global_config.bot.nickname,
     }
+    if bot_qq_account > 0:
+        session_info_data["bot_qq"] = str(bot_qq_account)
 
     if is_virtual_mode_enabled(virtual_config):
         assert virtual_config is not None
@@ -529,7 +724,7 @@ def get_active_history_group_id(virtual_config: Optional[VirtualIdentityConfig])
         virtual_config: 虚拟身份配置。
 
     Returns:
-        Optional[str]: 虚拟身份启用时返回对应群组 ID。
+        Optional[str]: 虚拟身份启用时返回对应群组 ID；否则返回 ``None`` 表示使用私聊。
     """
     if is_virtual_mode_enabled(virtual_config):
         assert virtual_config is not None
@@ -537,16 +732,16 @@ def get_active_history_group_id(virtual_config: Optional[VirtualIdentityConfig])
     return None
 
 
-def get_current_group_id(virtual_config: Optional[VirtualIdentityConfig]) -> str:
+def get_current_group_id(virtual_config: Optional[VirtualIdentityConfig]) -> Optional[str]:
     """获取当前会话的有效群组 ID。
 
     Args:
         virtual_config: 虚拟身份配置。
 
     Returns:
-        str: 当前会话应使用的群组 ID。
+        Optional[str]: 虚拟身份启用时返回对应群组 ID；否则返回 ``None``（默认私聊模式）。
     """
-    return get_active_history_group_id(virtual_config) or WEBUI_CHAT_GROUP_ID
+    return get_active_history_group_id(virtual_config)
 
 
 def build_welcome_message(virtual_config: Optional[VirtualIdentityConfig]) -> str:
@@ -611,7 +806,12 @@ async def send_initial_chat_state(
     )
 
     history_group_id = get_active_history_group_id(virtual_config)
-    history = chat_history.get_history(50, history_group_id)
+    history_user_id = None if history_group_id else user_id
+    history = chat_history.get_history(
+        50,
+        group_id=history_group_id,
+        user_id=history_user_id,
+    )
     await chat_manager.send_message(
         session_id,
         {
@@ -679,37 +879,42 @@ def create_message_data(
 
     if virtual_config and virtual_config.enabled:
         platform = virtual_config.platform or WEBUI_CHAT_PLATFORM
-        group_id = virtual_config.group_id or f"{VIRTUAL_GROUP_ID_PREFIX}{uuid.uuid4().hex[:8]}"
-        group_name = virtual_config.group_name or "WebUI虚拟群聊"
+        group_id: Optional[str] = (
+            virtual_config.group_id or f"{VIRTUAL_GROUP_ID_PREFIX}{uuid.uuid4().hex[:8]}"
+        )
+        group_name: Optional[str] = virtual_config.group_name or "WebUI虚拟群聊"
         actual_user_id = virtual_config.user_id or user_id
-        actual_user_name = virtual_config.user_nickname or user_name
+        actual_user_nickname = virtual_config.user_nickname or user_name
     else:
         platform = WEBUI_CHAT_PLATFORM
-        group_id = WEBUI_CHAT_GROUP_ID
-        group_name = "WebUI本地聊天室"
+        group_id = None
+        group_name = None
         actual_user_id = user_id
-        actual_user_name = user_name
-
-    return {
-        "message_info": {
+        actual_user_nickname = user_name
+
+    message_info: Dict[str, Any] = {
+        "platform": platform,
+        "message_id": message_id,
+        "time": time.time(),
+        "user_info": {
+            "user_id": actual_user_id,
+            "user_nickname": actual_user_nickname,
+            "user_cardname": actual_user_nickname,
             "platform": platform,
-            "message_id": message_id,
-            "time": time.time(),
-            "group_info": {
-                "group_id": group_id,
-                "group_name": group_name,
-                "platform": platform,
-            },
-            "user_info": {
-                "user_id": actual_user_id,
-                "user_nickname": actual_user_name,
-                "user_cardname": actual_user_name,
-                "platform": platform,
-            },
-            "additional_config": {
-                "at_bot": is_at_bot,
-            },
         },
+        "additional_config": {
+            "at_bot": is_at_bot,
+        },
+    }
+    if group_id is not None:
+        message_info["group_info"] = {
+            "group_id": group_id,
+            "group_name": group_name,
+            "platform": platform,
+        }
+
+    return {
+        "message_info": message_info,
         "message_segment": {
             "type": "seglist",
             "data": [
@@ -717,10 +922,6 @@ def create_message_data(
                     "type": "text",
                     "data": content,
                 },
-                {
-                    "type": "mention_bot",
-                    "data": "1.0",
-                },
             ],
         },
         "raw_message": content,
@@ -776,6 +977,7 @@ async def handle_chat_message(
             },
             "virtual_mode": is_virtual_mode_enabled(current_virtual_config),
         },
+        user_id=normalized_user_id,
     )
 
     message_data = create_message_data(
@@ -788,13 +990,21 @@ async def handle_chat_message(
     )
 
     try:
-        await chat_manager.broadcast_to_group(target_group_id, {"type": "typing", "is_typing": True})
+        await chat_manager.broadcast_to_group(
+            target_group_id,
+            {"type": "typing", "is_typing": True},
+            user_id=normalized_user_id,
+        )
         await chat_bot.message_process(message_data)
     except Exception as exc:
         logger.error(f"处理消息时出错: {exc}")
         await send_chat_error(session_id, f"处理消息时出错: {str(exc)}")
     finally:
-        await chat_manager.broadcast_to_group(target_group_id, {"type": "typing", "is_typing": False})
+        await chat_manager.broadcast_to_group(
+            target_group_id,
+            {"type": "typing", "is_typing": False},
+            user_id=normalized_user_id,
+        )
 
     return next_user_name
 
@@ -915,11 +1125,12 @@ async def enable_virtual_identity(
         return None
 
 
-async def disable_virtual_identity(session_id: str) -> None:
+async def disable_virtual_identity(session_id: str, normalized_user_id: str) -> None:
     """关闭虚拟身份模式。
 
     Args:
         session_id: 内部逻辑会话 ID。
+        normalized_user_id: 规范化后的 WebUI 用户 ID，用于加载私聊历史。
     """
     await chat_manager.send_message(
         session_id,
@@ -933,8 +1144,8 @@ async def disable_virtual_identity(session_id: str) -> None:
         session_id,
         {
             "type": "history",
-            "messages": chat_history.get_history(50, WEBUI_CHAT_GROUP_ID),
-            "group_id": WEBUI_CHAT_GROUP_ID,
+            "messages": chat_history.get_history(50, user_id=normalized_user_id),
+            "group_id": None,
         },
     )
     await chat_manager.send_message(
@@ -952,6 +1163,7 @@ async def handle_virtual_identity_update(
     session_id_prefix: str,
     data: Dict[str, Any],
     current_virtual_config: Optional[VirtualIdentityConfig],
+    normalized_user_id: str,
 ) -> Optional[VirtualIdentityConfig]:
     """处理虚拟身份切换请求。
 
@@ -960,6 +1172,7 @@ async def handle_virtual_identity_update(
         session_id_prefix: 会话前缀。
         data: 前端提交的数据。
         current_virtual_config: 当前虚拟身份配置。
+        normalized_user_id: 规范化后的 WebUI 用户 ID。
 
     Returns:
         Optional[VirtualIdentityConfig]: 更新后的虚拟身份配置。
@@ -969,7 +1182,7 @@ async def handle_virtual_identity_update(
         next_config = await enable_virtual_identity(session_id, session_id_prefix, virtual_data)
         return next_config if next_config is not None else current_virtual_config
 
-    await disable_virtual_identity(session_id)
+    await disable_virtual_identity(session_id, normalized_user_id)
     return None
 
 
@@ -1019,6 +1232,7 @@ async def dispatch_chat_event(
             session_id_prefix=session_id_prefix,
             data=data,
             current_virtual_config=current_virtual_config,
+            normalized_user_id=normalized_user_id,
         )
         return current_user_name, next_virtual_config
 

From 9e48cd2848b050538f39c912ef99fd9c4f6438ca Mon Sep 17 00:00:00 2001
From: DrSmoothl <1787882683@qq.com>
Date: Fri, 1 May 2026 20:14:37 +0800
Subject: [PATCH 4/9] feat: add TuningTab component for tuning task management
 and utility functions for memory operations

- Implemented TuningTab component to handle tuning objectives, intensity, sample size, and evaluation settings.
- Added UI elements for creating tuning tasks and displaying current configurations and recent tasks.
- Introduced utility functions for normalizing and formatting memory operation data, including feedback actions and delete operations.
---
 .../src/components/memory/MemoryMiniTabs.tsx  |   54 +
 .../memory/MemoryProgressIndicator.tsx        |  130 +
 dashboard/src/lib/memory-progress-client.ts   |   99 +
 dashboard/src/routes/auth.tsx                 |  234 +-
 .../src/routes/resource/knowledge-base.tsx    | 2900 +++--------------
 .../resource/knowledge-base/constants.ts      |   52 +
 .../knowledge-base/tabs/DeleteTab.tsx         |  492 +++
 .../knowledge-base/tabs/FeedbackTab.tsx       |  512 +++
 .../knowledge-base/tabs/ImportTab.tsx         | 1270 ++++++++
 .../knowledge-base/tabs/TuningTab.tsx         |  193 ++
 .../routes/resource/knowledge-base/utils.ts   |  498 +++
 11 files changed, 3883 insertions(+), 2551 deletions(-)
 create mode 100644 dashboard/src/components/memory/MemoryMiniTabs.tsx
 create mode 100644 dashboard/src/components/memory/MemoryProgressIndicator.tsx
 create mode 100644 dashboard/src/lib/memory-progress-client.ts
 create mode 100644 dashboard/src/routes/resource/knowledge-base/constants.ts
 create mode 100644 dashboard/src/routes/resource/knowledge-base/tabs/DeleteTab.tsx
 create mode 100644 dashboard/src/routes/resource/knowledge-base/tabs/FeedbackTab.tsx
 create mode 100644 dashboard/src/routes/resource/knowledge-base/tabs/ImportTab.tsx
 create mode 100644 dashboard/src/routes/resource/knowledge-base/tabs/TuningTab.tsx
 create mode 100644 dashboard/src/routes/resource/knowledge-base/utils.ts

diff --git a/dashboard/src/components/memory/MemoryMiniTabs.tsx b/dashboard/src/components/memory/MemoryMiniTabs.tsx
new file mode 100644
index 0000000000..ebf253ccad
--- /dev/null
+++ b/dashboard/src/components/memory/MemoryMiniTabs.tsx
@@ -0,0 +1,54 @@
+import { TabsList, TabsTrigger } from '@/components/ui/tabs'
+import { cn } from '@/lib/utils'
+
+export interface MemoryMiniTabItem<TValue extends string> {
+  value: TValue
+  label: string
+  description?: string
+}
+
+export interface MemoryMiniTabsProps<TValue extends string> {
+  items: ReadonlyArray<MemoryMiniTabItem<TValue>>
+  className?: string
+  /** 触发器额外样式 */
+  triggerClassName?: string
+}
+
+/**
+ * 长期记忆控制台统一的迷你标签页样式。
+ *
+ * - 复用 shadcn `Tabs` 原语，仅替换样式以保留无障碍能力（`role="tab"` 与文案不变）。
+ * - 胶囊形外观，激活态使用主色渐变，便于在密集表单上快速定位当前页签。
+ */
+export function MemoryMiniTabs<TValue extends string>({
+  items,
+  className,
+  triggerClassName,
+}: MemoryMiniTabsProps<TValue>) {
+  return (
+    <TabsList
+      className={cn(
+        'h-auto w-full flex-wrap justify-start gap-1.5 rounded-full border border-border/60',
+        'bg-gradient-to-r from-muted/40 via-background to-muted/30 p-1.5 shadow-inner',
+        className,
+      )}
+    >
+      {items.map((item) => (
+        <TabsTrigger
+          key={item.value}
+          value={item.value}
+          title={item.description}
+          className={cn(
+            'rounded-full px-3.5 py-1.5 text-xs font-medium text-muted-foreground transition-colors',
+            'hover:bg-background/80 hover:text-foreground',
+            'data-[state=active]:bg-gradient-to-r data-[state=active]:from-primary data-[state=active]:to-primary/80',
+            'data-[state=active]:text-primary-foreground data-[state=active]:shadow-sm',
+            triggerClassName,
+          )}
+        >
+          {item.label}
+        </TabsTrigger>
+      ))}
+    </TabsList>
+  )
+}
diff --git a/dashboard/src/components/memory/MemoryProgressIndicator.tsx b/dashboard/src/components/memory/MemoryProgressIndicator.tsx
new file mode 100644
index 0000000000..c1ab53aaa1
--- /dev/null
+++ b/dashboard/src/components/memory/MemoryProgressIndicator.tsx
@@ -0,0 +1,130 @@
+import { Loader2 } from 'lucide-react'
+
+import { Badge } from '@/components/ui/badge'
+import { Progress } from '@/components/ui/progress'
+import { cn } from '@/lib/utils'
+
+export interface MemoryProgressIndicatorProps {
+  /** 0-100 之间的进度百分比 */
+  value: number
+  /** 任务状态文本（如 “运行中”、“已完成”） */
+  statusLabel?: string
+  /** 当前步骤文本（如 “分块中”） */
+  stepLabel?: string
+  /** 状态对应的语义色（用于左侧圆环和徽标） */
+  tone?: 'default' | 'success' | 'warning' | 'destructive' | 'muted'
+  /** 是否显示加载动画（运行中/取消中场景） */
+  busy?: boolean
+  /** 紧凑模式：用于队列列表项 */
+  compact?: boolean
+  /** 额外说明（如 “已完成 36 / 120 分块”） */
+  detail?: string
+  className?: string
+}
+
+const TONE_RING_CLASS: Record<NonNullable<MemoryProgressIndicatorProps['tone']>, string> = {
+  default: 'text-primary',
+  success: 'text-emerald-500',
+  warning: 'text-amber-500',
+  destructive: 'text-rose-500',
+  muted: 'text-muted-foreground',
+}
+
+const TONE_BADGE_VARIANT: Record<
+  NonNullable<MemoryProgressIndicatorProps['tone']>,
+  'default' | 'secondary' | 'destructive' | 'outline'
+> = {
+  default: 'default',
+  success: 'secondary',
+  warning: 'outline',
+  destructive: 'destructive',
+  muted: 'outline',
+}
+
+/**
+ * 长期记忆控制台统一的任务进度展示组件。
+ *
+ * 设计目标：
+ *  - 让用户一眼看清「整体百分比 + 语义状态 + 当前步骤」。
+ *  - 复用 shadcn `Progress` 与 `Badge`，避免引入额外样式来源。
+ *  - 在紧凑模式下保留可读性，可放进队列卡片；非紧凑模式带圆环用于详情区。
+ */
+export function MemoryProgressIndicator({
+  value,
+  statusLabel,
+  stepLabel,
+  tone = 'default',
+  busy = false,
+  compact = false,
+  detail,
+  className,
+}: MemoryProgressIndicatorProps) {
+  const safeValue = Number.isFinite(value) ? Math.max(0, Math.min(100, value)) : 0
+  const ringSize = compact ? 36 : 56
+  const ringStroke = compact ? 4 : 5
+  const radius = (ringSize - ringStroke) / 2
+  const circumference = 2 * Math.PI * radius
+  const dashOffset = circumference * (1 - safeValue / 100)
+
+  return (
+    <div className={cn('flex items-center gap-3', className)}>
+      <div
+        className={cn('relative shrink-0', TONE_RING_CLASS[tone])}
+        style={{ width: ringSize, height: ringSize }}
+        aria-hidden="true"
+      >
+        <svg width={ringSize} height={ringSize} className="-rotate-90">
+          <circle
+            cx={ringSize / 2}
+            cy={ringSize / 2}
+            r={radius}
+            strokeWidth={ringStroke}
+            className="stroke-muted/40"
+            fill="none"
+          />
+          <circle
+            cx={ringSize / 2}
+            cy={ringSize / 2}
+            r={radius}
+            strokeWidth={ringStroke}
+            strokeLinecap="round"
+            stroke="currentColor"
+            fill="none"
+            strokeDasharray={circumference}
+            strokeDashoffset={dashOffset}
+            className="transition-[stroke-dashoffset] duration-500 ease-out"
+          />
+        </svg>
+        <div className="absolute inset-0 flex items-center justify-center">
+          {busy ? (
+            <Loader2 className={cn('animate-spin', compact ? 'h-3.5 w-3.5' : 'h-4 w-4')} />
+          ) : (
+            <span className={cn('font-medium tabular-nums', compact ? 'text-[10px]' : 'text-xs')}>
+              {Math.round(safeValue)}%
+            </span>
+          )}
+        </div>
+      </div>
+
+      <div className="min-w-0 flex-1 space-y-1">
+        <div className="flex flex-wrap items-center gap-2">
+          {statusLabel ? (
+            <Badge variant={TONE_BADGE_VARIANT[tone]} className="shrink-0">
+              {statusLabel}
+            </Badge>
+          ) : null}
+          {stepLabel ? (
+            <span className="truncate text-xs text-muted-foreground">{stepLabel}</span>
+          ) : null}
+          {!compact ? (
+            <span className="ml-auto text-xs tabular-nums text-muted-foreground">
+              {safeValue.toFixed(1)}%
+            </span>
+          ) : null}
+        </div>
+        <Progress value={safeValue} className={cn(compact ? 'h-1' : 'h-1.5')} />
+        {detail ? <div className="truncate text-xs text-muted-foreground">{detail}</div> : null}
+      </div>
+    </div>
+  )
+}
diff --git a/dashboard/src/lib/memory-progress-client.ts b/dashboard/src/lib/memory-progress-client.ts
new file mode 100644
index 0000000000..a1c62a805f
--- /dev/null
+++ b/dashboard/src/lib/memory-progress-client.ts
@@ -0,0 +1,99 @@
+import { unifiedWsClient, type WsEventEnvelope } from './unified-ws'
+
+export type MemoryProgressTopic = 'import_progress' | 'delete_progress' | 'feedback_progress'
+
+export interface MemoryProgressEvent {
+  topic: MemoryProgressTopic
+  event: string
+  data: Record<string, unknown>
+}
+
+type ProgressListener = (event: MemoryProgressEvent) => void
+
+const DOMAIN = 'memory'
+const KNOWN_TOPICS: MemoryProgressTopic[] = ['import_progress', 'delete_progress', 'feedback_progress']
+
+/**
+ * 长期记忆控制台的统一 WebSocket 桥接客户端。
+ *
+ * 负责：
+ *  1. 订阅 `memory` 域下的若干 topic（导入/删除/反馈进度）。
+ *  2. 把后端推送的事件分发给所有已注册的监听器。
+ *  3. 即使后端尚未广播也保持安全：监听器为空时不抛错，订阅幂等。
+ *
+ * 与 `pluginProgressClient` 保持一致的形状，便于复用。
+ */
+class MemoryProgressClient {
+  private initialized = false
+  private listeners: Set<ProgressListener> = new Set()
+  private activeTopics: Set<MemoryProgressTopic> = new Set()
+
+  private initialize(): void {
+    if (this.initialized) {
+      return
+    }
+
+    unifiedWsClient.addEventListener((message: WsEventEnvelope) => {
+      if (message.domain !== DOMAIN) {
+        return
+      }
+      const topic = (message.topic ?? '') as MemoryProgressTopic
+      if (!KNOWN_TOPICS.includes(topic)) {
+        return
+      }
+      const payload: MemoryProgressEvent = {
+        topic,
+        event: message.event,
+        data: message.data ?? {},
+      }
+      this.listeners.forEach((listener) => {
+        try {
+          listener(payload)
+        } catch (error) {
+          console.error('长期记忆进度监听器执行失败:', error)
+        }
+      })
+    })
+
+    this.initialized = true
+  }
+
+  async subscribe(
+    listener: ProgressListener,
+    topics: MemoryProgressTopic[] = KNOWN_TOPICS,
+  ): Promise<() => Promise<void>> {
+    this.initialize()
+    this.listeners.add(listener)
+
+    // 仅订阅尚未激活的 topic，避免重复 subscribe
+    for (const topic of topics) {
+      if (this.activeTopics.has(topic)) {
+        continue
+      }
+      try {
+        await unifiedWsClient.subscribe(DOMAIN, topic)
+        this.activeTopics.add(topic)
+      } catch (error) {
+        // 后端可能尚未实现该 topic，订阅失败时只记录，不抛出，确保 polling 仍可作为兜底
+        console.warn(`订阅长期记忆 topic 失败（将退化到轮询兜底）: ${topic}`, error)
+      }
+    }
+
+    return async () => {
+      this.listeners.delete(listener)
+      if (this.listeners.size === 0) {
+        const topicsToRelease = Array.from(this.activeTopics)
+        this.activeTopics.clear()
+        for (const topic of topicsToRelease) {
+          try {
+            await unifiedWsClient.unsubscribe(DOMAIN, topic)
+          } catch (error) {
+            console.warn(`取消订阅长期记忆 topic 失败: ${topic}`, error)
+          }
+        }
+      }
+    }
+  }
+}
+
+export const memoryProgressClient = new MemoryProgressClient()
diff --git a/dashboard/src/routes/auth.tsx b/dashboard/src/routes/auth.tsx
index 8c6addea9d..4b56d821fe 100644
--- a/dashboard/src/routes/auth.tsx
+++ b/dashboard/src/routes/auth.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useState } from 'react'
+import { useCallback, useEffect, useRef, useState } from 'react'
 import { useNavigate } from '@tanstack/react-router'
 import { useTranslation } from 'react-i18next'
 
@@ -63,23 +63,58 @@ export function AuthPage() {
   const { t } = useTranslation()
   const { enableWavesBackground, setEnableWavesBackground } = useAnimation()
   const { theme, setTheme } = useTheme()
-
-  // 如果已经认证，直接跳转到首页
-  useEffect(() => {
-    const verifyAuth = async () => {
-      try {
-        const isAuth = await checkAuthStatus()
-        if (isAuth) {
-          navigate({ to: '/' })
+  // 避免 React StrictMode 下重复触发 URL token 自动登录。
+  const urlTokenHandledRef = useRef(false)
+
+  // 从 URL 中提取 token（支持 query 与 hash 两种位置）。
+  // 允许 ?token=xxx 、&token=xxx（query）以及 #/foo?token=xxx、#token=xxx（hash）。
+  const extractUrlToken = useCallback((): string => {
+    if (typeof window === 'undefined') return ''
+    const fromQuery = new URLSearchParams(window.location.search).get('token')
+    if (fromQuery && fromQuery.trim()) return fromQuery.trim()
+    // hash 中可能形如 "#token=xxx" 或 "#/path?token=xxx"
+    const rawHash = window.location.hash.replace(/^#/, '')
+    if (!rawHash) return ''
+    const queryIdx = rawHash.indexOf('?')
+    const hashQuery = queryIdx >= 0 ? rawHash.slice(queryIdx + 1) : rawHash
+    const fromHash = new URLSearchParams(hashQuery).get('token')
+    return fromHash && fromHash.trim() ? fromHash.trim() : ''
+  }, [])
+
+  // 从当前 URL 中移除 token 参数，避免令牌被书签/Referer/浏览器历史泄露。
+  const stripTokenFromUrl = useCallback(() => {
+    if (typeof window === 'undefined') return
+    try {
+      const url = new URL(window.location.href)
+      let changed = false
+      if (url.searchParams.has('token')) {
+        url.searchParams.delete('token')
+        changed = true
+      }
+      const rawHash = url.hash.replace(/^#/, '')
+      if (rawHash) {
+        const queryIdx = rawHash.indexOf('?')
+        if (queryIdx >= 0) {
+          const path = rawHash.slice(0, queryIdx)
+          const hashParams = new URLSearchParams(rawHash.slice(queryIdx + 1))
+          if (hashParams.has('token')) {
+            hashParams.delete('token')
+            const next = hashParams.toString()
+            url.hash = next ? `#${path}?${next}` : `#${path}`
+            changed = true
+          }
+        } else if (/^token=/.test(rawHash)) {
+          url.hash = ''
+          changed = true
         }
-      } catch {
-        // 忽略错误，保持在登录页
-      } finally {
-        setCheckingAuth(false)
       }
+      if (changed) {
+        window.history.replaceState(null, '', url.toString())
+      }
+    } catch {
+      // 忽略 URL 解析异常
     }
-    verifyAuth()
-  }, [navigate])
+  }, [])
 
   // 获取实际应用的主题（处理 system 情况）
   const getActualTheme = () => {
@@ -97,82 +132,119 @@ export function AuthPage() {
     setTheme(newTheme)
   }
 
-  const handleSubmit = async (e: React.FormEvent) => {
-    e.preventDefault()
-    setError('')
+  const verifyToken = useCallback(
+    async (rawToken: string): Promise<boolean> => {
+      const trimmed = rawToken.trim()
+      setError('')
 
-    if (!token.trim()) {
-      setError(t('auth.tokenRequired'))
-      return
-    }
+      if (!trimmed) {
+        setError(t('auth.tokenRequired'))
+        return false
+      }
+
+      setIsValidating(true)
+      console.log('开始验证 token...')
 
-    setIsValidating(true)
+      try {
+        // 向后端发送请求验证 token（后端会设置 HttpOnly Cookie）
+        const response = await fetch('/api/webui/auth/verify', {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+          },
+          credentials: 'include', // 确保接收并存储 Cookie
+          body: JSON.stringify({ token: trimmed }),
+        })
+
+        console.log('Token 验证响应状态:', response.status)
+
+        const result = await parseResponse<{
+          valid: boolean
+          is_first_setup?: boolean
+          message?: string
+        }>(response)
+
+        if (!result.success) {
+          console.error('Token 验证失败:', result.error)
+          setError(result.error)
+          return false
+        }
 
-    console.log('开始验证 token...')
+        const data = result.data
+        console.log('Token 验证响应数据:', data)
+
+        if (data.valid) {
+          console.log('Token 验证成功，准备跳转...')
+          console.log('is_first_setup:', data.is_first_setup)
+
+          // Token 验证成功，Cookie 已由后端设置
+          // 等待一小段时间确保 Cookie 已设置
+          await new Promise((resolve) => setTimeout(resolve, 100))
+
+          // 再次检查认证状态
+          const authCheck = await checkAuthStatus()
+          console.log('跳转前认证状态检查:', authCheck)
+
+          // 直接使用验证响应中的 is_first_setup 字段，避免额外请求
+          if (data.is_first_setup) {
+            console.log('跳转到首次配置页面')
+            navigate({ to: '/setup' })
+          } else {
+            console.log('跳转到首页')
+            navigate({ to: '/' })
+          }
+          return true
+        }
 
-    try {
-      // 向后端发送请求验证 token（后端会设置 HttpOnly Cookie）
-      const response = await fetch('/api/webui/auth/verify', {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-        },
-        credentials: 'include', // 确保接收并存储 Cookie
-        body: JSON.stringify({ token: token.trim() }),
-      })
-
-      console.log('Token 验证响应状态:', response.status)
-
-      const result = await parseResponse<{
-        valid: boolean
-        is_first_setup?: boolean
-        message?: string
-      }>(response)
-
-      if (!result.success) {
-        console.error('Token 验证失败:', result.error)
-        setError(result.error)
-        return
+        console.error('Token 验证失败:', data.message)
+        setError(data.message || t('auth.verifyFailed'))
+        return false
+      } catch (err) {
+        console.error('Token 验证错误:', err)
+        setError(err instanceof Error ? err.message : t('auth.connFailed'))
+        return false
+      } finally {
+        setIsValidating(false)
       }
+    },
+    [navigate, t]
+  )
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault()
+    await verifyToken(token)
+  }
 
-      const data = result.data
-      console.log('Token 验证响应数据:', data)
-
-      if (data.valid) {
-        console.log('Token 验证成功，准备跳转...')
-        console.log('is_first_setup:', data.is_first_setup)
-
-        // Token 验证成功，Cookie 已由后端设置
-        // 等待一小段时间确保 Cookie 已设置
-        await new Promise((resolve) => setTimeout(resolve, 100))
-
-        // 再次检查认证状态
-        const authCheck = await checkAuthStatus()
-        console.log('跳转前认证状态检查:', authCheck)
-
-        // 直接使用验证响应中的 is_first_setup 字段，避免额外请求
-        if (data.is_first_setup) {
-          console.log('跳转到首次配置页面')
-          // 需要首次配置，跳转到配置向导
-          navigate({ to: '/setup' })
-        } else {
-          console.log('跳转到首页')
-          // 不需要配置或配置已完成，跳转到首页
+  // 如果已经认证，直接跳转到首页；否则尝试用 URL 中的 token 自动登录。
+  useEffect(() => {
+    const verifyAuth = async () => {
+      try {
+        const isAuth = await checkAuthStatus()
+        if (isAuth) {
+          // 已登录场景下，URL 中残留的 token 也清掉，避免外泄。
+          stripTokenFromUrl()
           navigate({ to: '/' })
+          return
         }
-      } else {
-        console.error('Token 验证失败:', data.message)
-        setError(data.message || t('auth.verifyFailed'))
+
+        // 未登录：检查 URL 是否带 token，带了就自动尝试登录。
+        const urlToken = extractUrlToken()
+        if (urlToken && !urlTokenHandledRef.current) {
+          urlTokenHandledRef.current = true
+          // 立即从 URL 中剥离 token，防止刷新/复制链接时再次暴露。
+          stripTokenFromUrl()
+          setToken(urlToken)
+          // 异步触发验证；失败时错误信息会显示在表单上，token 也会保留在输入框中以便用户修正。
+          void verifyToken(urlToken)
+        }
+      } catch {
+        // 忽略错误，保持在登录页
+      } finally {
+        setCheckingAuth(false)
       }
-    } catch (err) {
-      console.error('Token 验证错误:', err)
-      setError(
-        err instanceof Error ? err.message : t('auth.connFailed')
-      )
-    } finally {
-      setIsValidating(false)
     }
-  }
+    verifyAuth()
+  }, [navigate, extractUrlToken, stripTokenFromUrl, verifyToken])
 
   // 正在检查认证状态时显示加载
   if (checkingAuth) {
diff --git a/dashboard/src/routes/resource/knowledge-base.tsx b/dashboard/src/routes/resource/knowledge-base.tsx
index a4accd75e9..85ac50fc6b 100644
--- a/dashboard/src/routes/resource/knowledge-base.tsx
+++ b/dashboard/src/routes/resource/knowledge-base.tsx
@@ -1,9 +1,7 @@
-import { useCallback, useEffect, useMemo, useState } from 'react'
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
 import { useNavigate } from '@tanstack/react-router'
 
 import {
-  ChevronLeft,
-  ChevronRight,
   Database,
   Gauge,
   Loader2,
@@ -12,7 +10,6 @@ import {
   Save,
   SlidersHorizontal,
   Sparkles,
-  Trash2,
   Upload,
   CheckCircle2,
   CircleAlert,
@@ -23,11 +20,10 @@ import {
 import { CodeEditor } from '@/components/CodeEditor'
 import { MemoryDeleteDialog } from '@/components/memory/MemoryDeleteDialog'
 import { MemoryConfigEditor } from '@/components/memory/MemoryConfigEditor'
+import { MemoryMiniTabs } from '@/components/memory/MemoryMiniTabs'
 import { Alert, AlertDescription } from '@/components/ui/alert'
-import { Badge } from '@/components/ui/badge'
 import { Button } from '@/components/ui/button'
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
-import { Checkbox } from '@/components/ui/checkbox'
 import {
   Dialog,
   DialogContent,
@@ -36,21 +32,11 @@ import {
   DialogHeader,
   DialogTitle,
 } from '@/components/ui/dialog'
-import { Input } from '@/components/ui/input'
 import { Label } from '@/components/ui/label'
-import { Progress } from '@/components/ui/progress'
-import { ScrollArea } from '@/components/ui/scroll-area'
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from '@/components/ui/select'
-import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@/components/ui/table'
-import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs'
+import { Tabs, TabsContent } from '@/components/ui/tabs'
 import { Textarea } from '@/components/ui/textarea'
 import { useToast } from '@/hooks/use-toast'
+import { memoryProgressClient, type MemoryProgressEvent } from '@/lib/memory-progress-client'
 import { cn } from '@/lib/utils'
 import {
   cancelMemoryImportTask,
@@ -105,536 +91,28 @@ import {
   type MemoryTaskPayload,
 } from '@/lib/memory-api'
 
-const DELETE_OPERATION_FETCH_LIMIT = 100
-const DELETE_OPERATION_PAGE_SIZE = 6
-const DELETE_OPERATION_ITEM_PAGE_SIZE = 8
-const FEEDBACK_CORRECTION_FETCH_LIMIT = 100
-const FEEDBACK_CORRECTION_PAGE_SIZE = 6
-const FEEDBACK_ACTION_LOG_PAGE_SIZE = 8
-const IMPORT_CHUNK_PAGE_SIZE = 50
-
-const RUNNING_IMPORT_STATUS = new Set(['preparing', 'running', 'cancel_requested'])
-const QUEUED_IMPORT_STATUS = new Set(['queued'])
-
-const IMPORT_STATUS_TEXT: Record<string, string> = {
-  queued: '排队中',
-  preparing: '准备中',
-  running: '运行中',
-  cancel_requested: '取消中',
-  cancelled: '已取消',
-  completed: '已完成',
-  completed_with_errors: '完成（有错误）',
-  failed: '失败',
-}
-
-const IMPORT_STEP_TEXT: Record<string, string> = {
-  queued: '排队中',
-  preparing: '准备中',
-  running: '运行中',
-  splitting: '分块中',
-  extracting: '抽取中',
-  writing: '写入中',
-  saving: '保存中',
-  backfilling: '回填中',
-  converting: '转换中',
-  verifying: '校验中',
-  switching: '切换中',
-  cancel_requested: '取消中',
-  cancelled: '已取消',
-  completed: '已完成',
-  completed_with_errors: '完成（有错误）',
-  failed: '失败',
-}
-
-const IMPORT_KIND_OPTIONS: Array<{ value: MemoryImportTaskKind; label: string; description: string }> = [
-  { value: 'upload', label: '上传文件', description: '从本地批量上传资料文件' },
-  { value: 'paste', label: '粘贴导入', description: '直接粘贴文本或 JSON 内容创建任务' },
-  { value: 'raw_scan', label: '本地扫描', description: '按路径别名和匹配规则批量扫描导入' },
-  { value: 'lpmm_openie', label: 'LPMM OpenIE', description: '读取 LPMM 数据并抽取关系' },
-  { value: 'lpmm_convert', label: 'LPMM 转换', description: '将 LPMM 数据转换到目标目录' },
-  { value: 'temporal_backfill', label: '时序回填', description: '为已有数据补充时间字段' },
-  { value: 'maibot_migration', label: 'MaiBot 迁移', description: '从 MaiBot 历史数据迁移长期记忆' },
-]
-
-function normalizeProgress(value: number | string | null | undefined): number {
-  const numeric = Number(value ?? 0)
-  if (!Number.isFinite(numeric)) {
-    return 0
-  }
-  if (numeric < 0) {
-    return 0
-  }
-  if (numeric > 100) {
-    return 100
-  }
-  return numeric
-}
-
-function parseOptionalPositiveInt(input: string): number | undefined {
-  const value = input.trim()
-  if (!value) {
-    return undefined
-  }
-  const parsed = Number(value)
-  if (!Number.isInteger(parsed) || parsed <= 0) {
-    return undefined
-  }
-  return parsed
-}
-
-function parseCommaSeparatedList(input: string): string[] {
-  return input
-    .split(',')
-    .map((item) => item.trim())
-    .filter(Boolean)
-}
-
-function normalizeImportInputMode(value: string): MemoryImportInputMode {
-  return value === 'json' ? 'json' : 'text'
-}
-
-function getImportStatusLabel(status: string): string {
-  const normalized = String(status ?? '').trim()
-  if (!normalized) {
-    return '-'
-  }
-  return IMPORT_STATUS_TEXT[normalized] ?? normalized
-}
-
-function getImportStepLabel(step: string): string {
-  const normalized = String(step ?? '').trim()
-  if (!normalized) {
-    return '-'
-  }
-  return IMPORT_STEP_TEXT[normalized] ?? normalized
-}
-
-function getImportStatusVariant(status: string): 'default' | 'secondary' | 'destructive' | 'outline' {
-  if (status === 'failed') {
-    return 'destructive'
-  }
-  if (status === 'completed') {
-    return 'default'
-  }
-  if (status === 'completed_with_errors' || status === 'cancelled') {
-    return 'secondary'
-  }
-  if (RUNNING_IMPORT_STATUS.has(status) || QUEUED_IMPORT_STATUS.has(status)) {
-    return 'outline'
-  }
-  return 'secondary'
-}
-
-function formatImportTime(timestamp?: number | null): string {
-  if (!timestamp) {
-    return '-'
-  }
-  const normalized = timestamp > 1_000_000_000_000 ? timestamp : timestamp * 1000
-  const value = new Date(normalized)
-  if (Number.isNaN(value.getTime())) {
-    return '-'
-  }
-  return value.toLocaleString('zh-CN', {
-    hour12: false,
-    year: 'numeric',
-    month: '2-digit',
-    day: '2-digit',
-    hour: '2-digit',
-    minute: '2-digit',
-  })
-}
-
-function formatDeleteOperationMode(mode: string): string {
-  switch (mode) {
-    case 'entity':
-      return '实体'
-    case 'relation':
-      return '关系'
-    case 'paragraph':
-      return '段落'
-    case 'source':
-      return '来源'
-    case 'mixed':
-      return '混合'
-    default:
-      return mode || '未知'
-  }
-}
-
-function formatDeleteOperationStatus(status: string): string {
-  switch (status) {
-    case 'executed':
-      return '已执行'
-    case 'restored':
-      return '已恢复'
-    default:
-      return status || '未知'
-  }
-}
-
-function formatDeleteOperationTime(timestamp?: number | null): string {
-  if (!timestamp) {
-    return '未知时间'
-  }
-  const normalized = timestamp > 1_000_000_000_000 ? timestamp : timestamp * 1000
-  const value = new Date(normalized)
-  if (Number.isNaN(value.getTime())) {
-    return '未知时间'
-  }
-  return value.toLocaleString('zh-CN', {
-    hour12: false,
-    year: 'numeric',
-    month: '2-digit',
-    day: '2-digit',
-    hour: '2-digit',
-    minute: '2-digit',
-  })
-}
-
-function formatFeedbackDecision(decision: string): string {
-  switch (decision) {
-    case 'correct':
-      return '纠正'
-    case 'reject':
-      return '否定'
-    case 'confirm':
-      return '确认'
-    case 'supplement':
-      return '补充'
-    case 'none':
-      return '无动作'
-    default:
-      return decision || '未知'
-  }
-}
-
-function formatFeedbackTaskStatus(status: string): string {
-  switch (status) {
-    case 'pending':
-      return '待处理'
-    case 'running':
-      return '处理中'
-    case 'applied':
-      return '已应用'
-    case 'skipped':
-      return '已跳过'
-    case 'error':
-      return '失败'
-    default:
-      return status || '未知'
-  }
-}
-
-function formatFeedbackRollbackStatus(status: string): string {
-  switch (status) {
-    case 'none':
-      return '未回退'
-    case 'running':
-      return '回退中'
-    case 'rolled_back':
-      return '已回退'
-    case 'error':
-      return '回退失败'
-    default:
-      return status || '未知'
-  }
-}
-
-function getFeedbackStatusVariant(
-  status: string,
-): 'default' | 'secondary' | 'destructive' | 'outline' {
-  if (status === 'applied' || status === 'rolled_back') {
-    return 'default'
-  }
-  if (status === 'error') {
-    return 'destructive'
-  }
-  if (status === 'running' || status === 'pending') {
-    return 'outline'
-  }
-  return 'secondary'
-}
-
-function summarizeFeedbackActionPayload(value: Record<string, unknown> | undefined): string {
-  if (!value) {
-    return ''
-  }
-  const hash = String(value.hash ?? '').trim()
-  const subject = String(value.subject ?? '').trim()
-  const predicate = String(value.predicate ?? '').trim()
-  const object = String(value.object ?? '').trim()
-  if (subject && predicate && object) {
-    return formatDeleteRelationText(subject, predicate, object)
-  }
-  if (hash) {
-    return hash
-  }
-  if (Array.isArray(value.target_hashes) && value.target_hashes.length > 0) {
-    return `targets ${value.target_hashes.length}`
-  }
-  return trimDeleteItemText(JSON.stringify(value, null, 2), 120)
-}
-
-function pickFeedbackRelationTriplet(value: unknown): Record<string, unknown> | null {
-  if (!value || typeof value !== 'object') {
-    return null
-  }
-  const record = value as Record<string, unknown>
-  const subject = String(record.subject ?? '').trim()
-  const predicate = String(record.predicate ?? '').trim()
-  const object = String(record.object ?? '').trim()
-  if (!subject || !predicate || !object) {
-    return null
-  }
-  return record
-}
-
-function formatFeedbackRelationTriplet(value: unknown): string {
-  const triplet = pickFeedbackRelationTriplet(value)
-  if (!triplet) {
-    return ''
-  }
-  return formatDeleteRelationText(
-    String(triplet.subject ?? ''),
-    String(triplet.predicate ?? ''),
-    String(triplet.object ?? ''),
-  )
-}
-
-function getFeedbackCorrectionPreview(task: MemoryFeedbackCorrectionDetailTaskPayload | MemoryFeedbackCorrectionSummaryPayload | null): {
-  headline: string
-  oldRelation: string
-  newRelation: string
-} {
-  if (!task) {
-    return {
-      headline: '当前没有纠错摘要',
-      oldRelation: '',
-      newRelation: '',
-    }
-  }
-
-  const detailTask = task as MemoryFeedbackCorrectionDetailTaskPayload
-  const rollbackPlanSummary = detailTask.rollback_plan_summary ?? {}
-  const forgottenRelations = Array.isArray(rollbackPlanSummary.forgotten_relations)
-    ? rollbackPlanSummary.forgotten_relations
-    : []
-  const correctedWrite = rollbackPlanSummary.corrected_write && typeof rollbackPlanSummary.corrected_write === 'object'
-    ? rollbackPlanSummary.corrected_write
-    : {}
-  const correctedRelations = Array.isArray((correctedWrite as Record<string, unknown>).corrected_relations)
-    ? ((correctedWrite as Record<string, unknown>).corrected_relations as unknown[])
-    : []
-
-  const oldRelation = formatFeedbackRelationTriplet(forgottenRelations[0])
-  const newRelation = formatFeedbackRelationTriplet(correctedRelations[0])
-
-  if (oldRelation && newRelation) {
-    return {
-      headline: `将“${oldRelation}”纠正为“${newRelation}”`,
-      oldRelation,
-      newRelation,
-    }
-  }
-  if (newRelation) {
-    return {
-      headline: `补充了新的纠错结论：“${newRelation}”`,
-      oldRelation: '',
-      newRelation,
-    }
-  }
-  if (oldRelation) {
-    return {
-      headline: `撤销了旧记忆关系：“${oldRelation}”`,
-      oldRelation,
-      newRelation: '',
-    }
-  }
-  return {
-    headline: task.query_text || '当前纠错没有可读摘要',
-    oldRelation: '',
-    newRelation: '',
-  }
-}
-
-function buildFeedbackImpactSummary(task: MemoryFeedbackCorrectionDetailTaskPayload | MemoryFeedbackCorrectionSummaryPayload | null): string[] {
-  if (!task) {
-    return []
-  }
-
-  const counts = task.affected_counts ?? {}
-  const items: string[] = []
-  if (Number(counts.relations ?? 0) > 0) {
-    items.push(`影响关系 ${Number(counts.relations ?? 0)} 条`)
-  }
-  if (Number(counts.corrected_relations ?? 0) > 0) {
-    items.push(`新增纠正关系 ${Number(counts.corrected_relations ?? 0)} 条`)
-  }
-  if (Number(counts.correction_paragraphs ?? 0) > 0) {
-    items.push(`写入纠错段落 ${Number(counts.correction_paragraphs ?? 0)} 条`)
-  }
-  if (Number(counts.stale_paragraphs ?? 0) > 0) {
-    items.push(`标记旧段落 ${Number(counts.stale_paragraphs ?? 0)} 条`)
-  }
-  if (Number(counts.episode_sources ?? 0) > 0) {
-    items.push(`触发 Episode 修复 ${Number(counts.episode_sources ?? 0)} 个来源`)
-  }
-  if (Number(counts.profile_person_ids ?? 0) > 0) {
-    items.push(`触发 Profile 刷新 ${Number(counts.profile_person_ids ?? 0)} 个对象`)
-  }
-  return items
-}
-
-function formatFeedbackActionType(actionType: string): string {
-  switch (actionType) {
-    case 'classification':
-      return '判定纠错'
-    case 'forget_relation':
-      return '撤销旧关系'
-    case 'mark_stale_paragraph':
-      return '标记旧段落'
-    case 'write_correction':
-      return '写入纠错'
-    case 'rollback_restore_relation':
-      return '恢复旧关系'
-    case 'rollback_delete_correction_paragraph':
-      return '隐藏纠错段落'
-    case 'rollback_revert_corrected_relation':
-      return '撤销纠正关系'
-    case 'rollback_clear_stale_mark':
-      return '清除脏段落标记'
-    case 'rollback_enqueue_episode_rebuild':
-      return '加入 Episode 修复队列'
-    case 'rollback_enqueue_profile_refresh':
-      return '加入 Profile 刷新队列'
-    case 'rollback_error':
-      return '回退失败'
-    case 'error':
-      return '处理失败'
-    case 'skip':
-      return '跳过处理'
-    default:
-      return actionType || '未知动作'
-  }
-}
-
-function describeFeedbackActionLog(item: MemoryFeedbackActionLogPayload): string {
-  const beforeSummary = summarizeFeedbackActionPayload(item.before_payload)
-  const afterSummary = summarizeFeedbackActionPayload(item.after_payload)
-
-  switch (item.action_type) {
-    case 'classification':
-      return afterSummary ? `系统完成判定：${afterSummary}` : '系统完成纠错判定'
-    case 'forget_relation':
-      return beforeSummary ? `旧关系已失效：${beforeSummary}` : '旧关系已被标记为失效'
-    case 'mark_stale_paragraph':
-      return '旧段落已标记为待复核，后续检索会更谨慎地使用它'
-    case 'write_correction':
-      return afterSummary ? `已写入新的纠错结果：${afterSummary}` : '已写入新的纠错段落和关系'
-    case 'rollback_restore_relation':
-      return afterSummary ? `已恢复旧关系状态：${afterSummary}` : '已恢复旧关系状态'
-    case 'rollback_delete_correction_paragraph':
-      return '已隐藏这次纠错写入的段落'
-    case 'rollback_revert_corrected_relation':
-      return '已撤销纠错阶段新增的关系'
-    case 'rollback_clear_stale_mark':
-      return '已清除旧段落的待复核标记'
-    case 'rollback_enqueue_episode_rebuild':
-      return '已重新加入 Episode 修复队列'
-    case 'rollback_enqueue_profile_refresh':
-      return '已重新加入 Profile 刷新队列'
-    case 'rollback_error':
-      return item.reason || '这次回退执行失败'
-    case 'error':
-      return item.reason || '这次纠错处理失败'
-    case 'skip':
-      return item.reason || '这次纠错被跳过'
-    default:
-      return afterSummary || beforeSummary || item.reason || '记录了一条动作日志'
-  }
-}
-
-type DeleteOperationItem = NonNullable<MemoryDeleteOperationPayload['items']>[number]
-
-function trimDeleteItemText(value: string, maxLength: number = 140): string {
-  const normalized = String(value ?? '').trim().replace(/\s+/g, ' ')
-  if (!normalized) {
-    return ''
-  }
-  if (normalized.length <= maxLength) {
-    return normalized
-  }
-  return `${normalized.slice(0, maxLength)}...`
-}
-
-function formatDeleteRelationText(subject: string, predicate: string, object: string): string {
-  const left = String(subject ?? '').trim()
-  const middle = String(predicate ?? '').trim()
-  const right = String(object ?? '').trim()
-  return [left, middle, right].filter(Boolean).join(' -> ')
-}
-
-function getDeleteOperationItemLabel(item: DeleteOperationItem): string {
-  const payload = item.payload ?? {}
-  if (item.item_type === 'entity') {
-    const entity = (payload.entity ?? {}) as Record<string, unknown>
-    return String(entity.name ?? item.item_key ?? item.item_hash ?? '未命名实体')
-  }
-  if (item.item_type === 'relation') {
-    const relation = (payload.relation ?? {}) as Record<string, unknown>
-    return (
-      formatDeleteRelationText(
-        String(relation.subject ?? ''),
-        String(relation.predicate ?? ''),
-        String(relation.object ?? ''),
-      ) || String(item.item_key ?? item.item_hash ?? '未命名关系')
-    )
-  }
-  if (item.item_type === 'paragraph') {
-    const paragraph = (payload.paragraph ?? {}) as Record<string, unknown>
-    const source = String(paragraph.source ?? '').trim()
-    return source || String(item.item_key ?? item.item_hash ?? '未命名段落')
-  }
-  return String(item.item_key ?? item.item_hash ?? '未命名对象')
-}
-
-function getDeleteOperationItemPreview(item: DeleteOperationItem): string {
-  const payload = item.payload ?? {}
-  if (item.item_type === 'entity') {
-    const paragraphLinks = Array.isArray(payload.paragraph_links) ? payload.paragraph_links : []
-    if (paragraphLinks.length > 0) {
-      return `关联段落 ${paragraphLinks.length} 个`
-    }
-    return '实体快照'
-  }
-  if (item.item_type === 'relation') {
-    const relation = (payload.relation ?? {}) as Record<string, unknown>
-    const paragraphHashes = Array.isArray(payload.paragraph_hashes) ? payload.paragraph_hashes : []
-    const confidence = relation.confidence
-    const parts = []
-    if (paragraphHashes.length > 0) {
-      parts.push(`证据段落 ${paragraphHashes.length} 个`)
-    }
-    if (typeof confidence === 'number') {
-      parts.push(`置信度 ${confidence.toFixed(2)}`)
-    }
-    return parts.join('，') || '关系快照'
-  }
-  if (item.item_type === 'paragraph') {
-    const paragraph = (payload.paragraph ?? {}) as Record<string, unknown>
-    return trimDeleteItemText(String(paragraph.content ?? ''))
-  }
-  return ''
-}
-
-function getDeleteOperationItemSource(item: DeleteOperationItem): string {
-  const payload = item.payload ?? {}
-  if (item.item_type === 'paragraph') {
-    const paragraph = (payload.paragraph ?? {}) as Record<string, unknown>
-    return String(paragraph.source ?? '').trim()
-  }
-  return String(payload.source ?? '').trim()
-}
+import {
+  DELETE_OPERATION_FETCH_LIMIT,
+  DELETE_OPERATION_ITEM_PAGE_SIZE,
+  DELETE_OPERATION_PAGE_SIZE,
+  FEEDBACK_ACTION_LOG_PAGE_SIZE,
+  FEEDBACK_CORRECTION_FETCH_LIMIT,
+  FEEDBACK_CORRECTION_PAGE_SIZE,
+  IMPORT_CHUNK_PAGE_SIZE,
+  QUEUED_IMPORT_STATUS,
+  RUNNING_IMPORT_STATUS,
+} from './knowledge-base/constants'
+import {
+  buildFeedbackImpactSummary,
+  getFeedbackCorrectionPreview,
+  parseCommaSeparatedList,
+  parseOptionalPositiveInt,
+  summarizeFeedbackActionPayload,
+} from './knowledge-base/utils'
+import { DeleteTab } from './knowledge-base/tabs/DeleteTab'
+import { FeedbackTab } from './knowledge-base/tabs/FeedbackTab'
+import { ImportTab } from './knowledge-base/tabs/ImportTab'
+import { TuningTab } from './knowledge-base/tabs/TuningTab'
 
 export function KnowledgeBasePage() {
   const navigate = useNavigate()
@@ -645,6 +123,9 @@ export function KnowledgeBasePage() {
   const [creatingImport, setCreatingImport] = useState(false)
   const [creatingTuning, setCreatingTuning] = useState(false)
   const [rawMode, setRawMode] = useState(false)
+  const [activeTab, setActiveTab] = useState<
+    'overview' | 'config' | 'import' | 'tuning' | 'delete' | 'feedback'
+  >('overview')
 
   const [schemaPayload, setSchemaPayload] = useState<MemoryConfigSchemaPayload | null>(null)
   const [visualConfig, setVisualConfig] = useState<Record<string, unknown>>({})
@@ -1593,6 +1074,44 @@ export function KnowledgeBasePage() {
     }
   }, [importAutoPolling, importPollInterval, loadImportTaskDetail, refreshImportQueue, selectedImportTaskId])
 
+  // 统一 WebSocket 推送：作为轮询的实时增强；后端未广播时由轮询兜底
+  const selectedImportTaskIdRef = useRef<string>('')
+  useEffect(() => {
+    selectedImportTaskIdRef.current = selectedImportTaskId
+  }, [selectedImportTaskId])
+
+  useEffect(() => {
+    let cancelled = false
+    let unsubscribe: (() => Promise<void>) | undefined
+    const handleEvent = (event: MemoryProgressEvent) => {
+      if (event.topic === 'import_progress') {
+        void refreshImportQueue(true)
+        if (selectedImportTaskIdRef.current) {
+          void loadImportTaskDetail(selectedImportTaskIdRef.current, true)
+        }
+      }
+    }
+    void memoryProgressClient
+      .subscribe(handleEvent, ['import_progress'])
+      .then((cleanup) => {
+        if (cancelled) {
+          void cleanup()
+          return
+        }
+        unsubscribe = cleanup
+      })
+      .catch((error) => {
+        // 订阅失败不影响轮询兜底
+        console.warn('订阅长期记忆 WebSocket 失败，已退化到轮询兜底', error)
+      })
+    return () => {
+      cancelled = true
+      if (unsubscribe) {
+        void unsubscribe()
+      }
+    }
+  }, [loadImportTaskDetail, refreshImportQueue])
+
   const filteredSources = useMemo(() => {
     const keyword = sourceSearch.trim().toLowerCase()
     if (!keyword) {
@@ -2266,22 +1785,25 @@ export function KnowledgeBasePage() {
   }
 
   return (
-    <div className="flex h-full flex-col">
-      <div className="flex-none border-b bg-card/60 px-6 py-4 backdrop-blur">
+    <div className="flex h-full flex-col bg-gradient-to-b from-background via-background to-muted/15">
+      <div className="flex-none border-b bg-card/70 px-6 py-4 backdrop-blur">
         <div className="flex flex-col gap-4 lg:flex-row lg:items-center lg:justify-between">
           <div>
-            <h1 className="text-2xl font-bold">长期记忆控制台</h1>
+            <div className="text-[11px] font-medium uppercase tracking-[0.18em] text-primary/80">
+              A_Memorix
+            </div>
+            <h1 className="mt-1 text-2xl font-bold leading-tight">长期记忆控制台</h1>
             <p className="mt-1 text-sm text-muted-foreground">
-              A_Memorix 的配置、自检、导入和检索调优，都在这里！
+              在这里完成配置、自检、导入资料和检索调优——一站式管理记忆库
             </p>
           </div>
 
           <div className="flex flex-wrap gap-2">
-            <Button variant="outline" onClick={() => navigate({ to: '/resource/knowledge-graph' })}>
+            <Button variant="outline" size="sm" onClick={() => navigate({ to: '/resource/knowledge-graph' })}>
               <Database className="mr-2 h-4 w-4" />
               打开图谱
             </Button>
-            <Button variant="outline" onClick={() => void loadPage()}>
+            <Button variant="outline" size="sm" onClick={() => void loadPage()}>
               <RefreshCw className="mr-2 h-4 w-4" />
               刷新数据
             </Button>
@@ -2289,48 +1811,134 @@ export function KnowledgeBasePage() {
         </div>
       </div>
 
-      <div className="flex-1 overflow-auto p-6">
-        <div className="mx-auto flex w-full max-w-[1500px] flex-col gap-6">
-          <div className="grid gap-4 xl:grid-cols-4">
-            {runtimeBadges.map((item) => (
-              <Card key={item.label} className={cn('overflow-hidden transition-colors', item.className)}>
-                <CardHeader className="space-y-3 pb-3">
-                  <div className="flex items-start justify-between gap-3">
-                    <div className="space-y-1">
-                      <CardDescription>{item.label}</CardDescription>
-                      <CardTitle className="break-all text-base leading-relaxed">{item.value}</CardTitle>
-                    </div>
-                    <div className="rounded-lg border bg-background/70 p-2 shadow-sm">
+      <div className="flex-1 overflow-auto">
+        <div className="mx-auto flex w-full max-w-[1800px] flex-col gap-6 px-6 py-6">
+          {/* 运行时状态条 —— 紧凑、常驻、一眼看完 */}
+          {runtimeBadges.length > 0 ? (
+            <div className="rounded-2xl border border-border/60 bg-card/60 p-4 shadow-sm backdrop-blur">
+              <div className="mb-3 flex items-center justify-between gap-2">
+                <div className="flex items-center gap-2 text-xs font-medium uppercase tracking-wider text-muted-foreground">
+                  <Gauge className="h-3.5 w-3.5" />
+                  运行时状态
+                </div>
+                <Button
+                  variant="ghost"
+                  size="sm"
+                  className="h-7 px-2 text-xs"
+                  onClick={() => void refreshSelfCheck()}
+                  disabled={refreshingCheck}
+                >
+                  <RefreshCw className={cn('mr-1.5 h-3 w-3', refreshingCheck && 'animate-spin')} />
+                  自检
+                </Button>
+              </div>
+              <div className="grid gap-2.5 sm:grid-cols-2 lg:grid-cols-4">
+                {runtimeBadges.map((item) => (
+                  <div
+                    key={item.label}
+                    className={cn(
+                      'flex items-center gap-3 rounded-xl border px-3 py-2.5 transition-colors',
+                      item.className,
+                    )}
+                  >
+                    <div className="flex-none rounded-lg border bg-background/70 p-1.5 shadow-sm">
                       <item.icon className={cn('h-4 w-4', item.iconClassName)} />
                     </div>
+                    <div className="min-w-0 flex-1">
+                      <div className="text-[11px] font-medium text-muted-foreground">{item.label}</div>
+                      <div className="truncate text-sm font-semibold leading-snug" title={item.value}>
+                        {item.value}
+                      </div>
+                      <div className="mt-0.5 truncate text-[11px] text-muted-foreground">
+                        {item.description}
+                      </div>
+                    </div>
                   </div>
-                  <div className="text-xs text-muted-foreground">{item.description}</div>
-                </CardHeader>
-              </Card>
-            ))}
+                ))}
+              </div>
+            </div>
+          ) : null}
+
+          {/* 快速开始 Hero —— 给新用户明确的"先做什么" */}
+          <div className="overflow-hidden rounded-2xl border border-primary/20 bg-gradient-to-br from-primary/10 via-primary/5 to-transparent p-5 shadow-sm">
+            <div className="flex flex-col gap-5 lg:flex-row lg:items-center lg:justify-between">
+              <div className="space-y-1.5 lg:max-w-sm">
+                <div className="text-[11px] font-medium uppercase tracking-[0.18em] text-primary">
+                  快速开始
+                </div>
+                <h2 className="text-lg font-semibold leading-tight">先从这三件事入手</h2>
+                <p className="text-sm text-muted-foreground">
+                  不知道该做什么？挑一个最常用的入口，下面的标签页里有更详细的设置。
+                </p>
+              </div>
+              <div className="grid w-full gap-2.5 sm:grid-cols-3 lg:max-w-3xl">
+                <button
+                  type="button"
+                  onClick={() => setActiveTab('import')}
+                  className="group flex items-start gap-3 rounded-xl border border-border/70 bg-background/80 p-3.5 text-left transition hover:border-primary/50 hover:bg-background hover:shadow-md"
+                >
+                  <div className="flex-none rounded-lg bg-primary/10 p-2 text-primary transition-transform group-hover:scale-105">
+                    <Upload className="h-4 w-4" />
+                  </div>
+                  <div className="min-w-0">
+                    <div className="text-sm font-semibold">导入资料</div>
+                    <div className="mt-0.5 text-xs leading-relaxed text-muted-foreground">
+                      把文件、聊天记录写进记忆库
+                    </div>
+                  </div>
+                </button>
+                <button
+                  type="button"
+                  onClick={() => setActiveTab('tuning')}
+                  className="group flex items-start gap-3 rounded-xl border border-border/70 bg-background/80 p-3.5 text-left transition hover:border-primary/50 hover:bg-background hover:shadow-md"
+                >
+                  <div className="flex-none rounded-lg bg-amber-500/10 p-2 text-amber-500 transition-transform group-hover:scale-105">
+                    <SlidersHorizontal className="h-4 w-4" />
+                  </div>
+                  <div className="min-w-0">
+                    <div className="text-sm font-semibold">检索调优</div>
+                    <div className="mt-0.5 text-xs leading-relaxed text-muted-foreground">
+                      让回忆变得更准、更聪明
+                    </div>
+                  </div>
+                </button>
+                <button
+                  type="button"
+                  onClick={() => navigate({ to: '/resource/knowledge-graph' })}
+                  className="group flex items-start gap-3 rounded-xl border border-border/70 bg-background/80 p-3.5 text-left transition hover:border-primary/50 hover:bg-background hover:shadow-md"
+                >
+                  <div className="flex-none rounded-lg bg-violet-500/10 p-2 text-violet-500 transition-transform group-hover:scale-105">
+                    <Database className="h-4 w-4" />
+                  </div>
+                  <div className="min-w-0">
+                    <div className="text-sm font-semibold">打开图谱</div>
+                    <div className="mt-0.5 text-xs leading-relaxed text-muted-foreground">
+                      可视化已存的实体和关系
+                    </div>
+                  </div>
+                </button>
+              </div>
+            </div>
           </div>
 
-          <Tabs defaultValue="overview" className="space-y-5">
-            <TabsList className="h-auto flex-wrap justify-start gap-1 rounded-xl border bg-muted/30 p-1">
-              <TabsTrigger value="overview" className="rounded-lg px-4 py-1.5">
-                概览
-              </TabsTrigger>
-              <TabsTrigger value="config" className="rounded-lg px-4 py-1.5">
-                配置
-              </TabsTrigger>
-              <TabsTrigger value="import" className="rounded-lg px-4 py-1.5">
-                导入
-              </TabsTrigger>
-              <TabsTrigger value="tuning" className="rounded-lg px-4 py-1.5">
-                调优
-              </TabsTrigger>
-              <TabsTrigger value="delete" className="rounded-lg px-4 py-1.5">
-                删除
-              </TabsTrigger>
-              <TabsTrigger value="feedback" className="rounded-lg px-4 py-1.5">
-                纠错历史
-              </TabsTrigger>
-            </TabsList>
+          <Tabs
+            value={activeTab}
+            onValueChange={(value) => setActiveTab(value as typeof activeTab)}
+            className="space-y-5"
+          >
+            <div className="sticky top-0 z-10 -mx-6 border-b border-border/40 bg-background/85 px-6 pb-2 pt-1 backdrop-blur supports-[backdrop-filter]:bg-background/70">
+              <MemoryMiniTabs
+                items={[
+                  { value: 'overview', label: '概览', description: '运行状态与配置摘要' },
+                  { value: 'config', label: '配置', description: '可视化或 TOML 编辑配置' },
+                  { value: 'import', label: '导入', description: '创建并管理导入任务' },
+                  { value: 'tuning', label: '调优', description: '检索策略调优' },
+                  { value: 'delete', label: '删除', description: '批量删除与历史回溯' },
+                  { value: 'feedback', label: '纠错历史', description: '查看反馈与回滚' },
+                ]}
+                triggerClassName="px-4"
+              />
+            </div>
 
             <TabsContent value="overview" className="space-y-4">
               <div className="grid gap-4 xl:grid-cols-[1.15fr_0.85fr]">
@@ -2367,19 +1975,11 @@ export function KnowledgeBasePage() {
                   <CardHeader>
                     <CardTitle className="flex items-center gap-2">
                       <Sparkles className="h-4 w-4" />
-                      当前运行态摘要
+                      关键指标
                     </CardTitle>
-                    <CardDescription>这里展示运行态重点指标，方便先判断是否需要导入或调优</CardDescription>
+                    <CardDescription>用于快速判断是否需要补回向量或重新调优</CardDescription>
                   </CardHeader>
                   <CardContent className="space-y-4 text-sm">
-                    <div className="flex flex-wrap gap-2">
-                      <Badge variant={runtimeConfig?.runtime_ready ? 'default' : 'destructive'}>
-                        {runtimeConfig?.runtime_ready ? '运行就绪' : '运行未就绪'}
-                      </Badge>
-                      <Badge variant={runtimeConfig?.embedding_degraded ? 'destructive' : 'secondary'}>
-                        {runtimeConfig?.embedding_degraded ? 'Embedding 已退化' : 'Embedding 正常'}
-                      </Badge>
-                    </div>
                     <div className="grid gap-3 md:grid-cols-2">
                       <div className="rounded-lg border bg-muted/30 p-3">
                         <div className="text-xs text-muted-foreground">待补回段落向量</div>
@@ -2390,12 +1990,12 @@ export function KnowledgeBasePage() {
                         <div className="mt-1 text-2xl font-semibold">{runtimeConfig?.paragraph_vector_backfill_failed ?? 0}</div>
                       </div>
                     </div>
-                    <div className="rounded-lg border bg-muted/30 p-3">
-                      <div className="text-xs text-muted-foreground">当前调优配置</div>
-                      <pre className="mt-2 max-h-56 overflow-auto whitespace-pre-wrap break-words text-xs">
+                    <details className="rounded-lg border bg-muted/30 p-3" open>
+                      <summary className="cursor-pointer text-xs font-medium text-muted-foreground">当前调优配置</summary>
+                      <pre className="mt-2 max-h-48 overflow-auto whitespace-pre-wrap break-words text-xs">
                         {JSON.stringify(tuningProfile, null, 2)}
                       </pre>
-                    </div>
+                    </details>
                   </CardContent>
                 </Card>
               </div>
@@ -2467,1871 +2067,231 @@ export function KnowledgeBasePage() {
               </Card>
             </TabsContent>
 
-            <TabsContent
-              value="import"
-              className="space-y-7 [&_input]:h-10 [&_[role=combobox]]:h-10 [&_textarea]:min-h-[96px]"
-            >
-              <div className="mx-auto w-full max-w-5xl space-y-6">
-                <div className="space-y-6">
-                  <Card className="rounded-2xl border-border/70 shadow-sm">
-                    <CardHeader>
-                      <CardTitle className="flex items-center gap-2">
-                        <Upload className="h-4 w-4" />
-                        创建导入任务
-                      </CardTitle>
-                      <CardDescription>按“选择导入方式 → 检查公共参数 → 创建任务”的顺序完成导入。</CardDescription>
-                    </CardHeader>
-                    <CardContent className="space-y-6">
-                      <Tabs
-                        value={importCreateMode}
-                        onValueChange={(value) => setImportCreateMode(value as MemoryImportTaskKind)}
-                        className="space-y-4"
-                      >
-                        <div className="space-y-2">
-                          <Label>选择导入方式</Label>
-                          <TabsList className="h-auto w-full flex-wrap justify-start gap-1 rounded-xl border bg-muted/20 p-1">
-                            {IMPORT_KIND_OPTIONS.map((item) => (
-                              <TabsTrigger
-                                key={item.value}
-                                value={item.value}
-                                className="rounded-lg px-3 py-1.5 text-xs"
-                              >
-                                {item.label}
-                              </TabsTrigger>
-                            ))}
-                          </TabsList>
-                        </div>
-
-                        <div className="space-y-4 rounded-lg border bg-muted/30 p-4">
-                        <div className="space-y-1">
-                          <div className="text-sm font-medium">公共参数</div>
-                          <div className="text-xs text-muted-foreground">这些设置会应用到当前导入任务。一般保持默认即可，只在批量导入或排查问题时调整。</div>
-                        </div>
-                        <div className="grid gap-3 md:grid-cols-2">
-                          <div className="space-y-1">
-                            <Label>文件并发数</Label>
-                            <div className="text-xs text-muted-foreground">同时处理多少个文件；文件很多时再适当调高。</div>
-                            <Input
-                              type="number"
-                              min={1}
-                              max={Number(importSettings.max_file_concurrency ?? 128)}
-                              value={importCommonFileConcurrency}
-                              onChange={(event) => setImportCommonFileConcurrency(event.target.value)}
-                            />
-                          </div>
-                          <div className="space-y-1">
-                            <Label>分块并发数</Label>
-                            <div className="text-xs text-muted-foreground">单个文件内并行处理多少个分块；过高会增加资源占用。</div>
-                            <Input
-                              type="number"
-                              min={1}
-                              max={Number(importSettings.max_chunk_concurrency ?? 256)}
-                              value={importCommonChunkConcurrency}
-                              onChange={(event) => setImportCommonChunkConcurrency(event.target.value)}
-                            />
-                          </div>
-                          <div className="rounded-md border bg-background/70 p-3">
-                            <div className="flex items-center gap-2 text-sm">
-                              <Checkbox
-                                checked={importCommonLlmEnabled}
-                                onCheckedChange={(value) => setImportCommonLlmEnabled(Boolean(value))}
-                              />
-                              启用 LLM 抽取
-                            </div>
-                            <div className="mt-1 text-xs text-muted-foreground">需要模型参与抽取，质量更高但耗时更长。</div>
-                          </div>
-                          <div className="rounded-md border bg-background/70 p-3">
-                            <div className="flex items-center gap-2 text-sm">
-                              <Checkbox
-                                checked={importCommonChatLog}
-                                onCheckedChange={(value) => setImportCommonChatLog(Boolean(value))}
-                              />
-                              按聊天日志解析
-                            </div>
-                            <div className="mt-1 text-xs text-muted-foreground">适合导入聊天记录，会尽量保留时间和对话上下文。</div>
-                          </div>
-                        </div>
-
-                        <details className="rounded-md border bg-background/70 p-3 text-sm">
-                          <summary className="cursor-pointer text-xs font-medium text-muted-foreground">
-                            高级参数（通常不用修改）
-                          </summary>
-                          <div className="mt-3 grid gap-3">
-                            <div className="space-y-1">
-                              <Label>指定抽取策略</Label>
-                              <Input
-                                value={importCommonStrategyOverride}
-                                onChange={(event) => setImportCommonStrategyOverride(event.target.value)}
-                              />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>去重策略</Label>
-                              <Input
-                                value={importCommonDedupePolicy}
-                                onChange={(event) => setImportCommonDedupePolicy(event.target.value)}
-                              />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>聊天参考时间</Label>
-                              <Input
-                                value={importCommonChatReferenceTime}
-                                onChange={(event) => setImportCommonChatReferenceTime(event.target.value)}
-                              />
-                            </div>
-                            <div className="flex items-center gap-2 text-sm">
-                              <Checkbox
-                                checked={importCommonForce}
-                                onCheckedChange={(value) => setImportCommonForce(Boolean(value))}
-                              />
-                              强制导入
-                            </div>
-                            <div className="flex items-center gap-2 text-sm">
-                              <Checkbox
-                                checked={importCommonClearManifest}
-                                onCheckedChange={(value) => setImportCommonClearManifest(Boolean(value))}
-                              />
-                              清空导入清单
-                            </div>
-                          </div>
-                        </details>
-                      </div>
-
-                      <TabsContent value="upload" className="mt-0">
-                        <div className="space-y-3 rounded-xl border bg-background/70 p-4">
-                          <div className="text-xs text-muted-foreground">选择一个或多个本地文件创建导入任务，适合批量导入资料或聊天记录。</div>
-                          <div className="grid gap-3">
-                            <div className="space-y-1">
-                              <Label>输入模式</Label>
-                              <Select
-                                value={uploadInputMode}
-                                onValueChange={(value) => setUploadInputMode(normalizeImportInputMode(value))}
-                              >
-                                <SelectTrigger aria-label="upload-input-mode">
-                                  <SelectValue />
-                                </SelectTrigger>
-                                <SelectContent>
-                                  <SelectItem value="text">文本</SelectItem>
-                                  <SelectItem value="json">结构化 JSON</SelectItem>
-                                </SelectContent>
-                              </Select>
-                            </div>
-                            <div className="space-y-1">
-                              <Label>文件选择</Label>
-                              <Input
-                                type="file"
-                                multiple
-                                accept=".txt,.md,.json,.jsonl,.csv,.log,.html,.htm,.xml"
-                                onChange={(event) => setUploadFiles(Array.from(event.target.files ?? []))}
-                              />
-                            </div>
-                          </div>
-                          <div className="text-xs text-muted-foreground">已选择 {uploadFiles.length} 个文件</div>
-                        </div>
-                      </TabsContent>
-
-                      <TabsContent value="paste" className="mt-0">
-                        <div className="space-y-3 rounded-xl border bg-background/70 p-4">
-                          <div className="text-xs text-muted-foreground">直接粘贴少量文本或 JSON，适合临时补充一段资料。</div>
-                          <div className="grid gap-3">
-                            <div className="space-y-1">
-                              <Label>内容名称</Label>
-                              <Input value={pasteName} onChange={(event) => setPasteName(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>输入模式</Label>
-                              <Select
-                                value={pasteMode}
-                                onValueChange={(value) => setPasteMode(normalizeImportInputMode(value))}
-                              >
-                                <SelectTrigger aria-label="paste-input-mode">
-                                  <SelectValue />
-                                </SelectTrigger>
-                                <SelectContent>
-                                  <SelectItem value="text">文本</SelectItem>
-                                  <SelectItem value="json">结构化 JSON</SelectItem>
-                                </SelectContent>
-                              </Select>
-                            </div>
-                            <div className="space-y-1">
-                              <Label>粘贴内容</Label>
-                              <Textarea
-                                value={pasteContent}
-                                onChange={(event) => setPasteContent(event.target.value)}
-                                rows={8}
-                              />
-                            </div>
-                          </div>
-                        </div>
-                      </TabsContent>
-
-                      <TabsContent value="raw_scan" className="mt-0">
-                        <div className="space-y-3 rounded-xl border bg-background/70 p-4">
-                          <div className="text-xs text-muted-foreground">扫描目录文件，适合本地批处理</div>
-                          <div className="grid gap-3">
-                            <div className="space-y-1">
-                              <Label>路径别名</Label>
-                              <Input value={rawAlias} onChange={(event) => setRawAlias(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>输入模式</Label>
-                              <Select
-                                value={rawInputMode}
-                                onValueChange={(value) => setRawInputMode(normalizeImportInputMode(value))}
-                              >
-                                <SelectTrigger aria-label="raw-input-mode">
-                                  <SelectValue />
-                                </SelectTrigger>
-                                <SelectContent>
-                                  <SelectItem value="text">文本</SelectItem>
-                                  <SelectItem value="json">结构化 JSON</SelectItem>
-                                </SelectContent>
-                              </Select>
-                            </div>
-                            <div className="space-y-1">
-                              <Label>相对路径</Label>
-                              <Input value={rawRelativePath} onChange={(event) => setRawRelativePath(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>匹配规则（Glob）</Label>
-                              <Input value={rawGlob} onChange={(event) => setRawGlob(event.target.value)} />
-                            </div>
-                          </div>
-                          <div className="flex items-center gap-2 text-sm">
-                            <Checkbox checked={rawRecursive} onCheckedChange={(value) => setRawRecursive(Boolean(value))} />
-                            递归扫描
-                          </div>
-                        </div>
-                      </TabsContent>
-
-                      <TabsContent value="lpmm_openie" className="mt-0">
-                        <div className="space-y-3 rounded-xl border bg-background/70 p-4">
-                          <div className="text-xs text-muted-foreground">读取 LPMM 内容并抽取关系</div>
-                          <div className="grid gap-3">
-                            <div className="space-y-1">
-                              <Label>路径别名</Label>
-                              <Input value={openieAlias} onChange={(event) => setOpenieAlias(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>相对路径</Label>
-                              <Input value={openieRelativePath} onChange={(event) => setOpenieRelativePath(event.target.value)} />
-                            </div>
-                          </div>
-                          <div className="flex items-center gap-2 text-sm">
-                            <Checkbox
-                              checked={openieIncludeAllJson}
-                              onCheckedChange={(value) => setOpenieIncludeAllJson(Boolean(value))}
-                            />
-                            包含全部 JSON 文件
-                          </div>
-                        </div>
-                      </TabsContent>
-
-                      <TabsContent value="lpmm_convert" className="mt-0">
-                        <div className="space-y-3 rounded-xl border bg-background/70 p-4">
-                          <div className="text-xs text-muted-foreground">将 LPMM 数据转换到目标目录</div>
-                          <div className="grid gap-3">
-                            <div className="space-y-1">
-                              <Label>源路径别名</Label>
-                              <Input value={convertAlias} onChange={(event) => setConvertAlias(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>目标路径别名</Label>
-                              <Input value={convertTargetAlias} onChange={(event) => setConvertTargetAlias(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>源相对路径</Label>
-                              <Input value={convertRelativePath} onChange={(event) => setConvertRelativePath(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>目标相对路径</Label>
-                              <Input
-                                value={convertTargetRelativePath}
-                                onChange={(event) => setConvertTargetRelativePath(event.target.value)}
-                              />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>向量维度</Label>
-                              <Input
-                                type="number"
-                                min={1}
-                                value={convertDimension}
-                                onChange={(event) => setConvertDimension(event.target.value)}
-                              />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>批处理大小</Label>
-                              <Input
-                                type="number"
-                                min={1}
-                                value={convertBatchSize}
-                                onChange={(event) => setConvertBatchSize(event.target.value)}
-                              />
-                            </div>
-                          </div>
-                        </div>
-                      </TabsContent>
-
-                      <TabsContent value="temporal_backfill" className="mt-0">
-                        <div className="space-y-3 rounded-xl border bg-background/70 p-4">
-                          <div className="text-xs text-muted-foreground">为已有数据补齐时间字段</div>
-                          <div className="grid gap-3">
-                            <div className="space-y-1">
-                              <Label>路径别名</Label>
-                              <Input value={backfillAlias} onChange={(event) => setBackfillAlias(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>处理上限</Label>
-                              <Input type="number" min={1} value={backfillLimit} onChange={(event) => setBackfillLimit(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>相对路径</Label>
-                              <Input value={backfillRelativePath} onChange={(event) => setBackfillRelativePath(event.target.value)} />
-                            </div>
-                          </div>
-                          <div className="grid gap-2">
-                            <div className="flex items-center gap-2 text-sm">
-                              <Checkbox checked={backfillDryRun} onCheckedChange={(value) => setBackfillDryRun(Boolean(value))} />
-                              只预演，不写入数据
-                            </div>
-                            <div className="flex items-center gap-2 text-sm">
-                              <Checkbox
-                                checked={backfillNoCreatedFallback}
-                                onCheckedChange={(value) => setBackfillNoCreatedFallback(Boolean(value))}
-                              />
-                              禁用创建时间回退
-                            </div>
-                          </div>
-                        </div>
-                      </TabsContent>
-
-                      <TabsContent value="maibot_migration" className="mt-0">
-                        <div className="space-y-3 rounded-xl border bg-background/70 p-4">
-                          <div className="text-xs text-muted-foreground">迁移 MaiBot 历史长期记忆</div>
-                          <div className="grid gap-3">
-                            <div className="space-y-1">
-                              <Label>源数据库路径</Label>
-                              <Input value={maibotSourceDb} onChange={(event) => setMaibotSourceDb(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>起始时间</Label>
-                              <Input value={maibotTimeFrom} onChange={(event) => setMaibotTimeFrom(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>结束时间</Label>
-                              <Input value={maibotTimeTo} onChange={(event) => setMaibotTimeTo(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>起始 ID</Label>
-                              <Input type="number" min={1} value={maibotStartId} onChange={(event) => setMaibotStartId(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>结束 ID</Label>
-                              <Input type="number" min={1} value={maibotEndId} onChange={(event) => setMaibotEndId(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>会话 ID 列表</Label>
-                              <Input value={maibotStreamIds} onChange={(event) => setMaibotStreamIds(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>群组 ID 列表</Label>
-                              <Input value={maibotGroupIds} onChange={(event) => setMaibotGroupIds(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>用户 ID 列表</Label>
-                              <Input value={maibotUserIds} onChange={(event) => setMaibotUserIds(event.target.value)} />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>读取批大小</Label>
-                              <Input
-                                type="number"
-                                min={1}
-                                value={maibotReadBatchSize}
-                                onChange={(event) => setMaibotReadBatchSize(event.target.value)}
-                              />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>提交窗口行数</Label>
-                              <Input
-                                type="number"
-                                min={1}
-                                value={maibotCommitWindowRows}
-                                onChange={(event) => setMaibotCommitWindowRows(event.target.value)}
-                              />
-                            </div>
-                            <div className="space-y-1">
-                              <Label>向量线程数</Label>
-                              <Input
-                                type="number"
-                                min={1}
-                                value={maibotEmbedWorkers}
-                                onChange={(event) => setMaibotEmbedWorkers(event.target.value)}
-                              />
-                            </div>
-                          </div>
-                          <div className="grid gap-2">
-                            <div className="flex items-center gap-2 text-sm">
-                              <Checkbox checked={maibotNoResume} onCheckedChange={(value) => setMaibotNoResume(Boolean(value))} />
-                              从头开始，不继续上次进度
-                            </div>
-                            <div className="flex items-center gap-2 text-sm">
-                              <Checkbox checked={maibotResetState} onCheckedChange={(value) => setMaibotResetState(Boolean(value))} />
-                              重置迁移状态
-                            </div>
-                            <div className="flex items-center gap-2 text-sm">
-                              <Checkbox checked={maibotDryRun} onCheckedChange={(value) => setMaibotDryRun(Boolean(value))} />
-                              只预演，不写入数据
-                            </div>
-                            <div className="flex items-center gap-2 text-sm">
-                              <Checkbox checked={maibotVerifyOnly} onCheckedChange={(value) => setMaibotVerifyOnly(Boolean(value))} />
-                              仅校验
-                            </div>
-                          </div>
-                        </div>
-                      </TabsContent>
-
-                      </Tabs>
-
-                      <Button onClick={() => void submitImportByMode()} disabled={creatingImport}>
-                        {creatingImport ? <Loader2 className="mr-2 h-4 w-4 animate-spin" /> : <Upload className="mr-2 h-4 w-4" />}
-                        创建导入任务
-                      </Button>
-                    </CardContent>
-                  </Card>
-
-                  <Card className="rounded-2xl border-border/70 bg-card/85 shadow-sm">
-                    <CardHeader>
-                      <CardTitle>路径预检</CardTitle>
-                      <CardDescription>在创建本地扫描、转换或迁移任务前，先确认路径会被解析到哪里。</CardDescription>
-                    </CardHeader>
-                    <CardContent className="space-y-4">
-                      <div className="grid gap-3">
-                        <div className="space-y-1">
-                          <Label>路径别名</Label>
-                          <div className="text-xs text-muted-foreground">选择后端允许访问的数据根目录。</div>
-                          <Select value={pathResolveAlias} onValueChange={setPathResolveAlias}>
-                            <SelectTrigger aria-label="import-path-alias">
-                              <SelectValue />
-                            </SelectTrigger>
-                            <SelectContent>
-                              {importAliasKeys.length > 0 ? importAliasKeys.map((alias) => (
-                                <SelectItem key={alias} value={alias}>{alias}</SelectItem>
-                              )) : (
-                                <SelectItem value="raw">raw</SelectItem>
-                              )}
-                            </SelectContent>
-                          </Select>
-                        </div>
-                        <div className="space-y-1">
-                          <Label>相对路径</Label>
-                          <div className="text-xs text-muted-foreground">填写相对于路径别名的子路径，不需要填写完整磁盘路径。</div>
-                          <Input
-                            value={pathResolveRelativePath}
-                            onChange={(event) => setPathResolveRelativePath(event.target.value)}
-                            placeholder="例如 exports/weekly"
-                          />
-                        </div>
-                      </div>
-                      <div className="flex items-center gap-2 text-sm">
-                        <Checkbox checked={pathResolveMustExist} onCheckedChange={(value) => setPathResolveMustExist(Boolean(value))} />
-                        要求路径已存在
-                      </div>
-                      <Button
-                        variant="outline"
-                        onClick={() => void resolveImportPath()}
-                        disabled={resolvingPath || !pathResolveAlias.trim()}
-                      >
-                        {resolvingPath ? <Loader2 className="mr-2 h-4 w-4 animate-spin" /> : <RefreshCw className="mr-2 h-4 w-4" />}
-                        解析路径
-                      </Button>
-                      <Textarea value={pathResolveOutput} readOnly rows={6} placeholder="解析结果会显示在这里" />
-                    </CardContent>
-                  </Card>
-                </div>
-
-                <div className="space-y-6">
-                  <Card className="rounded-2xl border-border/70 bg-card/90 shadow-sm">
-                    <CardHeader className="space-y-4 pb-4">
-                      <div className="flex flex-wrap items-center justify-between gap-2">
-                        <CardTitle>导入队列</CardTitle>
-                        <Button variant="outline" size="sm" onClick={() => void refreshImportQueue()}>
-                          <RefreshCw className="mr-2 h-4 w-4" />
-                          刷新
-                        </Button>
-                      </div>
-                      <div className="flex flex-wrap items-center justify-between gap-3">
-                        <CardDescription className="text-sm">
-                          查看任务是否正在运行、排队等待或已经结束。点击任务卡片可查看详情。
-                        </CardDescription>
-                        <div className="flex flex-wrap gap-2 text-xs text-muted-foreground">
-                          <Badge variant="outline" className="bg-background/70">运行中 {runningImportTasks.length}</Badge>
-                          <Badge variant="outline" className="bg-background/70">排队中 {queuedImportTasks.length}</Badge>
-                          <Badge variant="outline" className="bg-background/70">最近完成 {recentImportTasks.length}</Badge>
-                        </div>
-                        <label className="flex items-center gap-2 text-xs text-muted-foreground">
-                          <Checkbox checked={importAutoPolling} onCheckedChange={(value) => setImportAutoPolling(Boolean(value))} />
-                          自动轮询 {importPollInterval}ms
-                        </label>
-                      </div>
-                    </CardHeader>
-                    <CardContent className="space-y-6">
-                      {importErrorText ? (
-                        <Alert variant="destructive">
-                          <AlertDescription>{importErrorText}</AlertDescription>
-                        </Alert>
-                      ) : null}
-
-                      <div className="space-y-2.5">
-                        <div className="flex items-center justify-between gap-2">
-                          <div className="text-sm font-medium">运行中</div>
-                          <Badge variant="outline">{runningImportTasks.length}</Badge>
-                        </div>
-                        {runningImportTasks.length > 0 ? (
-                          <ScrollArea className="h-[208px] rounded-xl border bg-muted/10">
-                            <div className="space-y-2.5 p-2.5">
-                              {runningImportTasks.map((task) => {
-                                const isSelected = task.task_id === selectedImportTaskId
-                                return (
-                                  <button
-                                    key={task.task_id}
-                                    type="button"
-                                    onClick={() => void selectImportTask(task.task_id)}
-                                    className={cn(
-                                      'w-full rounded-xl border p-4 text-left transition-all',
-                                      isSelected
-                                        ? 'border-primary/70 bg-primary/5 shadow-sm'
-                                        : 'bg-background/80 hover:border-muted-foreground/40 hover:bg-muted/20',
-                                    )}
-                                  >
-                                    <div className="flex flex-wrap items-start justify-between gap-2">
-                                      <div className="min-w-0 space-y-1">
-                                        <div className="break-all font-mono text-[11px] leading-relaxed text-muted-foreground">
-                                          {task.task_id}
-                                        </div>
-                                        <div className="text-sm font-medium">{String(task.task_kind ?? task.mode ?? '-')}</div>
-                                      </div>
-                                      <Badge variant={getImportStatusVariant(String(task.status ?? ''))}>
-                                        {getImportStatusLabel(String(task.status ?? ''))}
-                                      </Badge>
-                                    </div>
-                                    <div className="mt-2 flex items-center justify-between gap-2 text-xs text-muted-foreground">
-                                      <span>{getImportStepLabel(String(task.current_step ?? 'running'))}</span>
-                                      <span>{Number(task.progress ?? 0).toFixed(1)}%</span>
-                                    </div>
-                                    <Progress value={normalizeProgress(task.progress)} className="mt-2 h-1.5" />
-                                  </button>
-                                )
-                              })}
-                            </div>
-                          </ScrollArea>
-                        ) : (
-                          <div className="rounded-xl border bg-muted/20 p-4 text-sm text-muted-foreground">当前没有运行中任务</div>
-                        )}
-                      </div>
-
-                      <div className="space-y-2.5">
-                        <div className="flex items-center justify-between gap-2">
-                          <div className="text-sm font-medium">排队中</div>
-                          <Badge variant="outline">{queuedImportTasks.length}</Badge>
-                        </div>
-                        {queuedImportTasks.length > 0 ? (
-                          <ScrollArea className="h-[188px] rounded-xl border bg-muted/10">
-                            <div className="space-y-2.5 p-2.5">
-                              {queuedImportTasks.map((task) => {
-                                const isSelected = task.task_id === selectedImportTaskId
-                                return (
-                                  <button
-                                    key={task.task_id}
-                                    type="button"
-                                    onClick={() => void selectImportTask(task.task_id)}
-                                    className={cn(
-                                      'w-full rounded-xl border p-4 text-left transition-all',
-                                      isSelected
-                                        ? 'border-primary/70 bg-primary/5 shadow-sm'
-                                        : 'bg-background/80 hover:border-muted-foreground/40 hover:bg-muted/20',
-                                    )}
-                                  >
-                                    <div className="flex flex-wrap items-start justify-between gap-2">
-                                      <div className="min-w-0 space-y-1">
-                                        <div className="break-all font-mono text-[11px] leading-relaxed text-muted-foreground">
-                                          {task.task_id}
-                                        </div>
-                                        <div className="text-sm font-medium">{String(task.task_kind ?? task.mode ?? '-')}</div>
-                                      </div>
-                                      <Badge variant={getImportStatusVariant(String(task.status ?? ''))}>
-                                        {getImportStatusLabel(String(task.status ?? ''))}
-                                      </Badge>
-                                    </div>
-                                    <div className="mt-2 flex items-center justify-between gap-2 text-xs text-muted-foreground">
-                                      <span>创建时间</span>
-                                      <span>{formatImportTime(task.created_at)}</span>
-                                    </div>
-                                  </button>
-                                )
-                              })}
-                            </div>
-                          </ScrollArea>
-                        ) : (
-                          <div className="rounded-xl border bg-muted/20 p-4 text-sm text-muted-foreground">当前没有排队任务</div>
-                        )}
-                      </div>
-
-                      <div className="space-y-2.5">
-                        <div className="flex items-center justify-between gap-2">
-                          <div className="text-sm font-medium">最近完成</div>
-                          <Badge variant="secondary">{recentImportTasks.length}</Badge>
-                        </div>
-                        {recentImportTasks.length > 0 ? (
-                          <ScrollArea className="h-[260px] rounded-xl border bg-muted/10">
-                            <div className="space-y-2.5 p-2.5">
-                              {recentImportTasks.map((task) => {
-                                const isSelected = task.task_id === selectedImportTaskId
-                                return (
-                                  <button
-                                    key={task.task_id}
-                                    type="button"
-                                    onClick={() => void selectImportTask(task.task_id)}
-                                    className={cn(
-                                      'w-full rounded-xl border p-4 text-left transition-all',
-                                      isSelected
-                                        ? 'border-primary/70 bg-primary/5 shadow-sm'
-                                        : 'bg-background/80 hover:border-muted-foreground/40 hover:bg-muted/20',
-                                    )}
-                                  >
-                                    <div className="flex flex-wrap items-start justify-between gap-2">
-                                      <div className="min-w-0 space-y-1">
-                                        <div className="break-all font-mono text-[11px] leading-relaxed text-muted-foreground">
-                                          {task.task_id}
-                                        </div>
-                                        <div className="text-sm font-medium">{String(task.task_kind ?? task.mode ?? '-')}</div>
-                                      </div>
-                                      <Badge variant={getImportStatusVariant(String(task.status ?? ''))}>
-                                        {getImportStatusLabel(String(task.status ?? ''))}
-                                      </Badge>
-                                    </div>
-                                    <div className="mt-2 flex items-center justify-between gap-2 text-xs text-muted-foreground">
-                                      <span>完成进度</span>
-                                      <span>{Number(task.progress ?? 0).toFixed(1)}%</span>
-                                    </div>
-                                    <Progress value={normalizeProgress(task.progress)} className="mt-2 h-1.5" />
-                                  </button>
-                                )
-                              })}
-                            </div>
-                          </ScrollArea>
-                        ) : (
-                          <div className="rounded-xl border bg-muted/20 p-4 text-sm text-muted-foreground">暂时没有历史任务</div>
-                        )}
-                      </div>
-                    </CardContent>
-                  </Card>
-
-                </div>
-
-                <Card className="rounded-2xl border-border/70 bg-card/90 shadow-sm">
-                  <CardHeader className="space-y-4">
-                    <div className="flex flex-wrap items-center justify-between gap-2">
-                      <CardTitle>任务详情</CardTitle>
-                      <div className="flex flex-wrap gap-2">
-                        <Button
-                          size="sm"
-                          variant="outline"
-                          aria-label="取消选中导入任务"
-                          onClick={() => void cancelSelectedImportTask()}
-                          disabled={!selectedImportTaskId}
-                        >
-                          取消任务
-                        </Button>
-                        <Button
-                          size="sm"
-                          aria-label="重试选中导入任务"
-                          onClick={() => void retrySelectedImportTask()}
-                          disabled={!selectedImportTaskId}
-                        >
-                          重试失败项
-                        </Button>
-                      </div>
-                    </div>
-                    <CardDescription>支持文件级和分块级状态观察，可直接在当前页面定位失败原因</CardDescription>
-                  </CardHeader>
-                  <CardContent className="space-y-6">
-                    {selectedImportTaskLoading ? (
-                      <div className="flex items-center gap-2 text-sm text-muted-foreground">
-                        <Loader2 className="h-4 w-4 animate-spin" />
-                        正在加载任务详情...
-                      </div>
-                    ) : null}
-
-                    {!selectedImportTaskResolved ? (
-                      <div className="rounded-xl border bg-muted/20 p-4 text-sm text-muted-foreground">
-                        请选择一个导入任务查看详情
-                      </div>
-                    ) : (
-                      <>
-                        <div className="space-y-2">
-                          <div className="text-sm font-medium">任务摘要</div>
-                          <div className="overflow-auto rounded-xl border bg-muted/10">
-                            <Table className="min-w-[680px]">
-                              <TableBody>
-                                <TableRow>
-                                  <TableCell className="w-[140px] text-muted-foreground">任务 ID</TableCell>
-                                  <TableCell className="break-all font-mono text-xs leading-relaxed">
-                                    {selectedImportTaskResolved.task_id}
-                                  </TableCell>
-                                </TableRow>
-                                <TableRow>
-                                  <TableCell className="text-muted-foreground">任务类型</TableCell>
-                                  <TableCell>{String(selectedImportTaskResolved.task_kind ?? selectedImportTaskResolved.mode ?? '-')}</TableCell>
-                                </TableRow>
-                                <TableRow>
-                                  <TableCell className="text-muted-foreground">状态 / 步骤</TableCell>
-                                  <TableCell>
-                                    <div className="flex flex-wrap items-center gap-2">
-                                      <Badge variant={getImportStatusVariant(String(selectedImportTaskResolved.status ?? ''))}>
-                                        {getImportStatusLabel(String(selectedImportTaskResolved.status ?? ''))}
-                                      </Badge>
-                                      <span className="text-xs text-muted-foreground">
-                                        {getImportStepLabel(String(selectedImportTaskResolved.current_step ?? ''))}
-                                      </span>
-                                    </div>
-                                  </TableCell>
-                                </TableRow>
-                                <TableRow>
-                                  <TableCell className="text-muted-foreground">进度</TableCell>
-                                  <TableCell>
-                                    <div className="space-y-2">
-                                      <div className="text-sm">
-                                        {Number(selectedImportTaskResolved.progress ?? 0).toFixed(1)}% · 块
-                                        {' '}
-                                        {Number(selectedImportTaskResolved.done_chunks ?? 0)}
-                                        {' / '}
-                                        {Number(selectedImportTaskResolved.total_chunks ?? 0)}
-                                      </div>
-                                      <Progress value={normalizeProgress(selectedImportTaskResolved.progress)} className="h-1.5" />
-                                    </div>
-                                  </TableCell>
-                                </TableRow>
-                                <TableRow>
-                                  <TableCell className="text-muted-foreground">创建时间</TableCell>
-                                  <TableCell>{formatImportTime(selectedImportTaskResolved.created_at)}</TableCell>
-                                </TableRow>
-                                <TableRow>
-                                  <TableCell className="text-muted-foreground">更新时间</TableCell>
-                                  <TableCell>{formatImportTime(selectedImportTaskResolved.updated_at)}</TableCell>
-                                </TableRow>
-                              </TableBody>
-                            </Table>
-                          </div>
-                        </div>
-
-                        {selectedImportRetrySummary ? (
-                          <div className="space-y-2">
-                            <div className="text-sm font-medium">重试摘要</div>
-                            <div className="overflow-auto rounded-xl border bg-muted/10">
-                              <Table>
-                                <TableBody>
-                                  <TableRow>
-                                    <TableCell className="w-[220px] text-muted-foreground">按分块重试的文件数</TableCell>
-                                    <TableCell>{Number(selectedImportRetrySummary.chunk_retry_files ?? 0)}</TableCell>
-                                  </TableRow>
-                                  <TableRow>
-                                    <TableCell className="text-muted-foreground">按分块重试的分块数</TableCell>
-                                    <TableCell>{Number(selectedImportRetrySummary.chunk_retry_chunks ?? 0)}</TableCell>
-                                  </TableRow>
-                                  <TableRow>
-                                    <TableCell className="text-muted-foreground">回退整文件重试数</TableCell>
-                                    <TableCell>{Number(selectedImportRetrySummary.file_fallback_files ?? 0)}</TableCell>
-                                  </TableRow>
-                                  <TableRow>
-                                    <TableCell className="text-muted-foreground">跳过文件数</TableCell>
-                                    <TableCell>{Number(selectedImportRetrySummary.skipped_files ?? 0)}</TableCell>
-                                  </TableRow>
-                                </TableBody>
-                              </Table>
-                            </div>
-                          </div>
-                        ) : null}
-
-                        {selectedImportTaskErrorText ? (
-                          <Alert variant="destructive">
-                            <AlertDescription>{selectedImportTaskErrorText}</AlertDescription>
-                          </Alert>
-                        ) : null}
-
-                        <div className="space-y-2.5">
-                          <div className="text-sm font-medium">文件状态</div>
-                          {selectedImportFiles.length > 0 ? (
-                            <ScrollArea className="h-[260px] rounded-xl border bg-muted/10">
-                              <div className="space-y-2.5 p-2.5">
-                                {selectedImportFiles.map((file) => {
-                                  const isSelected = file.file_id === selectedImportFileId
-                                  return (
-                                    <button
-                                      key={file.file_id}
-                                      type="button"
-                                      onClick={() => void selectImportFile(file.file_id)}
-                                      className={cn(
-                                        'w-full rounded-xl border p-4 text-left transition-all',
-                                        isSelected
-                                          ? 'border-primary/70 bg-primary/5 shadow-sm'
-                                          : 'bg-background/80 hover:border-muted-foreground/40 hover:bg-muted/20',
-                                      )}
-                                    >
-                                      <div className="flex flex-wrap items-center justify-between gap-2">
-                                        <span className="truncate text-sm font-medium">{file.name || file.file_id}</span>
-                                        <Badge variant={getImportStatusVariant(String(file.status ?? ''))}>
-                                          {getImportStatusLabel(String(file.status ?? ''))}
-                                        </Badge>
-                                      </div>
-                                      <div className="mt-2 flex items-center justify-between gap-2 text-xs text-muted-foreground">
-                                        <span>{getImportStepLabel(String(file.current_step ?? ''))}</span>
-                                        <span>{Number(file.progress ?? 0).toFixed(1)}%</span>
-                                      </div>
-                                      <Progress value={normalizeProgress(file.progress)} className="mt-2 h-1.5" />
-                                      <div className="mt-2 text-xs text-muted-foreground">
-                                        {Number(file.progress ?? 0).toFixed(1)}% · {Number(file.done_chunks ?? 0)} / {Number(file.total_chunks ?? 0)}
-                                      </div>
-                                      {file.error ? (
-                                        <div className="mt-2 truncate text-xs text-destructive">{file.error}</div>
-                                      ) : null}
-                                    </button>
-                                  )
-                                })}
-                              </div>
-                            </ScrollArea>
-                          ) : (
-                            <div className="rounded-xl border bg-muted/20 p-4 text-sm text-muted-foreground">当前任务没有文件明细</div>
-                          )}
-                        </div>
-
-                        <div className="space-y-2.5">
-                          <div className="flex items-center justify-between gap-2">
-                            <div className="text-sm font-medium">分块状态</div>
-                            <div className="flex items-center gap-2 text-xs text-muted-foreground">
-                              <Button
-                                size="icon"
-                                variant="outline"
-                                aria-label="上一页分块"
-                                onClick={() => void moveImportChunkPage(-1)}
-                                disabled={!canImportChunkPrev}
-                              >
-                                <ChevronLeft className="h-4 w-4" />
-                              </Button>
-                              <span>
-                                {importChunkTotal > 0
-                                  ? `${importChunkOffset + 1}-${Math.min(importChunkOffset + IMPORT_CHUNK_PAGE_SIZE, importChunkTotal)}`
-                                  : '0-0'}
-                                {' / '}
-                                {importChunkTotal}
-                              </span>
-                              <Button
-                                size="icon"
-                                variant="outline"
-                                aria-label="下一页分块"
-                                onClick={() => void moveImportChunkPage(1)}
-                                disabled={!canImportChunkNext}
-                              >
-                                <ChevronRight className="h-4 w-4" />
-                              </Button>
-                            </div>
-                          </div>
-
-                          <div className="overflow-auto rounded-xl border bg-background/80">
-                            <Table className="min-w-[700px]">
-                              <TableHeader>
-                                <TableRow>
-                                  <TableHead className="w-[72px]">序号</TableHead>
-                                  <TableHead className="w-[108px]">状态</TableHead>
-                                  <TableHead className="w-[108px]">步骤</TableHead>
-                                  <TableHead className="w-[84px]">进度</TableHead>
-                                  <TableHead>错误 / 预览</TableHead>
-                                </TableRow>
-                              </TableHeader>
-                              <TableBody>
-                                {importChunksLoading ? (
-                                  <TableRow>
-                                    <TableCell colSpan={5} className="text-center text-muted-foreground">
-                                      正在加载分块详情...
-                                    </TableCell>
-                                  </TableRow>
-                                ) : selectedImportChunks.length > 0 ? (
-                                  selectedImportChunks.map((chunk) => (
-                                    <TableRow key={chunk.chunk_id}>
-                                      <TableCell>{chunk.index}</TableCell>
-                                      <TableCell>{getImportStatusLabel(String(chunk.status ?? ''))}</TableCell>
-                                      <TableCell>{getImportStepLabel(String(chunk.step ?? ''))}</TableCell>
-                                      <TableCell>{Number(chunk.progress ?? 0).toFixed(1)}%</TableCell>
-                                      <TableCell className="max-w-[360px]">
-                                        <div className="space-y-2">
-                                          {String(chunk.error ?? '').trim() ? (
-                                            <div className="rounded-md border border-destructive/30 bg-destructive/5 px-2.5 py-2 text-sm leading-relaxed text-destructive">
-                                              {String(chunk.error)}
-                                            </div>
-                                          ) : null}
-                                          <details className="rounded-md border bg-muted/20 px-2.5 py-2 text-xs text-muted-foreground">
-                                            <summary className="cursor-pointer font-medium text-foreground">
-                                              {String(chunk.error ?? '').trim() ? '查看分块预览' : '查看内容详情'}
-                                            </summary>
-                                            <div className="mt-2 whitespace-pre-wrap break-words leading-relaxed">
-                                              {String(chunk.content_preview ?? '-') || '-'}
-                                            </div>
-                                          </details>
-                                        </div>
-                                      </TableCell>
-                                    </TableRow>
-                                  ))
-                                ) : (
-                                  <TableRow>
-                                    <TableCell colSpan={5} className="text-center text-muted-foreground">
-                                      当前页没有分块数据
-                                    </TableCell>
-                                  </TableRow>
-                                )}
-                              </TableBody>
-                            </Table>
-                          </div>
-                        </div>
-                      </>
-                    )}
-                  </CardContent>
-                </Card>
-              </div>
-            </TabsContent>
-
-            <TabsContent value="tuning" className="space-y-4">
-              <div className="grid gap-4 xl:grid-cols-[0.95fr_1.05fr]">
-                <Card>
-                  <CardHeader>
-                    <CardTitle className="flex items-center gap-2">
-                      <Sparkles className="h-4 w-4" />
-                      调优任务
-                    </CardTitle>
-                    <CardDescription>创建一次检索参数评估任务，完成后可在右侧列表中查看并应用最佳结果。</CardDescription>
-                  </CardHeader>
-                  <CardContent className="space-y-4">
-                    <div className="space-y-3 rounded-lg border bg-muted/20 p-4">
-                      <div className="space-y-1">
-                        <div className="text-sm font-medium">调优策略</div>
-                        <div className="text-xs text-muted-foreground">先选择优化方向和搜索强度。默认的 balanced / standard 适合大多数情况。</div>
-                      </div>
-                      <div className="grid gap-4 md:grid-cols-2">
-                        <div className="space-y-2">
-                          <Label>优化目标</Label>
-                          <div className="text-xs text-muted-foreground">决定本次调优更偏向准确率、召回率，还是两者平衡。</div>
-                          <Select value={tuningObjective} onValueChange={setTuningObjective}>
-                            <SelectTrigger><SelectValue /></SelectTrigger>
-                            <SelectContent>
-                              <SelectItem value="precision_priority">precision_priority</SelectItem>
-                              <SelectItem value="balanced">balanced</SelectItem>
-                              <SelectItem value="recall_priority">recall_priority</SelectItem>
-                            </SelectContent>
-                          </Select>
-                        </div>
-                        <div className="space-y-2">
-                          <Label>评估强度</Label>
-                          <div className="text-xs text-muted-foreground">强度越高，评估更充分，但任务耗时也更长。</div>
-                          <Select value={tuningIntensity} onValueChange={setTuningIntensity}>
-                            <SelectTrigger><SelectValue /></SelectTrigger>
-                            <SelectContent>
-                              <SelectItem value="quick">quick</SelectItem>
-                              <SelectItem value="standard">standard</SelectItem>
-                              <SelectItem value="deep">deep</SelectItem>
-                            </SelectContent>
-                          </Select>
-                        </div>
-                      </div>
-                    </div>
-                    <div className="space-y-3 rounded-lg border bg-muted/20 p-4">
-                      <div className="space-y-1">
-                        <div className="text-sm font-medium">评估范围</div>
-                        <div className="text-xs text-muted-foreground">控制本次任务使用多少样本，以及每次检索评估多少候选结果。</div>
-                      </div>
-                      <div className="grid gap-4 md:grid-cols-2">
-                        <div className="space-y-2">
-                          <Label>样本量</Label>
-                          <div className="text-xs text-muted-foreground">用于评估的样本数量。数量越大，结果越稳定。</div>
-                          <Input type="number" value={tuningSampleSize} onChange={(event) => setTuningSampleSize(event.target.value)} />
-                        </div>
-                        <div className="space-y-2">
-                          <Label>评估 Top-K</Label>
-                          <div className="text-xs text-muted-foreground">每次检索时用于评估的候选结果数量。</div>
-                          <Input type="number" value={tuningTopKEval} onChange={(event) => setTuningTopKEval(event.target.value)} />
-                        </div>
-                      </div>
-                    </div>
-                    <Button onClick={() => void submitTuningTask()} disabled={creatingTuning}>
-                      <Sparkles className="mr-2 h-4 w-4" />
-                      创建调优任务
-                    </Button>
-                  </CardContent>
-                </Card>
-
-                <div className="space-y-4">
-                  <Card>
-                    <CardHeader>
-                      <CardTitle>当前调优配置快照</CardTitle>
-                      <CardDescription>展示当前生效的检索调优参数，便于在应用新结果前做对照。</CardDescription>
-                    </CardHeader>
-                    <CardContent className="space-y-3">
-                      <CodeEditor
-                        value={JSON.stringify(tuningProfile, null, 2)}
-                        language="json"
-                        readOnly
-                        height="220px"
-                      />
-                      <CodeEditor
-                        value={tuningProfileToml}
-                        language="toml"
-                        readOnly
-                        height="180px"
-                      />
-                    </CardContent>
-                  </Card>
-
-                  <Card>
-                    <CardHeader>
-                      <CardTitle>最近调优任务</CardTitle>
-                      <CardDescription>任务完成后，可以把最佳结果应用到当前调优配置。</CardDescription>
-                    </CardHeader>
-                    <CardContent className="space-y-3">
-                      <Table>
-                        <TableHeader>
-                          <TableRow>
-                            <TableHead>任务</TableHead>
-                            <TableHead>状态</TableHead>
-                            <TableHead>动作</TableHead>
-                          </TableRow>
-                        </TableHeader>
-                        <TableBody>
-                          {tuningTasks.length > 0 ? tuningTasks.map((task) => (
-                            <TableRow key={String(task.task_id ?? Math.random())}>
-                              <TableCell className="font-mono text-xs">{String(task.task_id ?? '-')}</TableCell>
-                              <TableCell>
-                                <Badge variant={getImportStatusVariant(String(task.status ?? ''))}>
-                                  {String(task.status ?? '-')}
-                                </Badge>
-                              </TableCell>
-                              <TableCell>
-                                <Button
-                                  size="sm"
-                                  variant="outline"
-                                  onClick={() => void applyBestTask(String(task.task_id ?? ''))}
-                                  disabled={!task.task_id}
-                                >
-                                  应用最佳
-                                </Button>
-                              </TableCell>
-                            </TableRow>
-                          )) : (
-                            <TableRow>
-                              <TableCell colSpan={3} className="text-center text-muted-foreground">
-                                还没有调优任务。可以先使用默认参数创建一次评估任务。
-                              </TableCell>
-                            </TableRow>
-                          )}
-                        </TableBody>
-                      </Table>
-                    </CardContent>
-                  </Card>
-                </div>
-              </div>
-            </TabsContent>
-
-            <TabsContent value="delete" className="space-y-4">
-              <div className="space-y-4">
-                <Card>
-                  <CardHeader className="space-y-3">
-                    <div>
-                      <CardTitle className="flex items-center gap-2">
-                        <Trash2 className="h-4 w-4" />
-                        来源批量删除
-                      </CardTitle>
-                      <CardDescription>
-                        用于按来源清理测试数据或指定导入批次。该操作不会直接删除实体，只会删除来源段落和失去全部证据的关系。
-                      </CardDescription>
-                    </div>
-                    <Alert className="border-amber-500/30 bg-amber-500/5 text-amber-950 dark:text-amber-200">
-                      <CircleAlert className="h-4 w-4 text-amber-500" />
-                      <AlertDescription>
-                        建议先在图谱里确认影响范围，再在这里执行批量来源删除。所有删除都会先经过预览，并支持按删除记录恢复。
-                      </AlertDescription>
-                    </Alert>
-                  </CardHeader>
-                  <CardContent className="space-y-4">
-                    <div className="grid gap-3 rounded-xl border bg-muted/20 p-4 lg:grid-cols-[minmax(0,1fr)_auto] lg:items-center">
-                      <div className="space-y-2">
-                        <Label>来源检索</Label>
-                        <Input
-                          value={sourceSearch}
-                          onChange={(event) => setSourceSearch(event.target.value)}
-                          placeholder="搜索 source 名称"
-                        />
-                      </div>
-                      <div className="flex flex-wrap gap-2 lg:justify-end">
-                        <Button
-                          variant="outline"
-                          onClick={() => setSelectedSources(filteredSources.map((item) => String(item.source ?? '')).filter(Boolean))}
-                        >
-                          全选当前结果
-                        </Button>
-                        <Button onClick={() => void openSourceDeletePreview()} disabled={selectedSources.length <= 0}>
-                          <Trash2 className="mr-2 h-4 w-4" />
-                          预览删除
-                        </Button>
-                      </div>
-                    </div>
-
-                    <div className="flex flex-wrap items-center gap-2 text-sm text-muted-foreground">
-                      <Badge variant="outline" className="bg-background/70">当前命中 {filteredSources.length} 个来源</Badge>
-                      <Badge variant={selectedSources.length > 0 ? 'secondary' : 'outline'} className="bg-background/70">
-                        已选择 {selectedSources.length} 个来源
-                      </Badge>
-                    </div>
-
-                    <ScrollArea className="h-[320px] rounded-lg border">
-                      <Table>
-                        <TableHeader className="sticky top-0 bg-background">
-                          <TableRow>
-                            <TableHead className="w-12">选中</TableHead>
-                            <TableHead>来源</TableHead>
-                            <TableHead>段落数</TableHead>
-                            <TableHead>关系数</TableHead>
-                          </TableRow>
-                        </TableHeader>
-                        <TableBody>
-                          {filteredSources.length > 0 ? filteredSources.map((item) => {
-                            const source = String(item.source ?? '')
-                            const checked = selectedSources.includes(source)
-                            return (
-                              <TableRow key={source}>
-                                <TableCell>
-                                  <Checkbox checked={checked} onCheckedChange={(value) => toggleSourceSelection(source, Boolean(value))} />
-                                </TableCell>
-                                <TableCell className="font-mono text-xs break-all">{source}</TableCell>
-                                <TableCell>{Number(item.paragraph_count ?? 0)}</TableCell>
-                                <TableCell>{Number(item.relation_count ?? 0)}</TableCell>
-                              </TableRow>
-                            )
-                          }) : (
-                            <TableRow>
-                              <TableCell colSpan={4} className="text-center text-muted-foreground">
-                                当前没有可删除的来源
-                              </TableCell>
-                            </TableRow>
-                          )}
-                        </TableBody>
-                      </Table>
-                    </ScrollArea>
-                  </CardContent>
-                </Card>
-
-                <Card>
-                  <CardHeader>
-                    <CardTitle className="flex items-center gap-2">
-                      <RotateCcw className="h-4 w-4" />
-                      删除操作恢复
-                    </CardTitle>
-                    <CardDescription>按列表浏览最近的删除操作，先选中记录，再在下方确认影响范围并执行恢复</CardDescription>
-                  </CardHeader>
-                  <CardContent className="space-y-4">
-                    <div className="grid gap-3 rounded-xl border bg-muted/20 p-4 lg:grid-cols-[minmax(0,1fr)_180px_180px]">
-                      <Input
-                        value={operationSearch}
-                        onChange={(event) => setOperationSearch(event.target.value)}
-                        placeholder="搜索 operation / reason / requested_by / source"
-                      />
-                      <Select value={operationModeFilter} onValueChange={setOperationModeFilter}>
-                        <SelectTrigger>
-                          <SelectValue placeholder="按模式筛选" />
-                        </SelectTrigger>
-                        <SelectContent>
-                          <SelectItem value="all">全部模式</SelectItem>
-                          <SelectItem value="source">来源删除</SelectItem>
-                          <SelectItem value="mixed">混合删除</SelectItem>
-                          <SelectItem value="entity">实体删除</SelectItem>
-                          <SelectItem value="relation">关系删除</SelectItem>
-                          <SelectItem value="paragraph">段落删除</SelectItem>
-                        </SelectContent>
-                      </Select>
-                      <Select value={operationStatusFilter} onValueChange={setOperationStatusFilter}>
-                        <SelectTrigger>
-                          <SelectValue placeholder="按状态筛选" />
-                        </SelectTrigger>
-                        <SelectContent>
-                          <SelectItem value="all">全部状态</SelectItem>
-                          <SelectItem value="executed">已执行</SelectItem>
-                          <SelectItem value="restored">已恢复</SelectItem>
-                        </SelectContent>
-                      </Select>
-                    </div>
-
-                    <div className="flex flex-wrap items-center justify-between gap-2 text-sm text-muted-foreground">
-                      <span>当前命中 {filteredDeleteOperations.length} 条记录，已加载最近 {deleteOperations.length} 条</span>
-                      <span>第 {operationPage} / {deleteOperationPageCount} 页，每页显示 {DELETE_OPERATION_PAGE_SIZE} 条</span>
-                    </div>
-
-                    <ScrollArea className="h-[320px] rounded-lg border">
-                      <div className="space-y-3 p-3">
-                        {pagedDeleteOperations.length > 0 ? pagedDeleteOperations.map((operation) => {
-                          const summary = (operation.summary ?? {}) as Record<string, unknown>
-                          const counts = ((summary.counts as Record<string, number> | undefined) ?? {})
-                          const isSelected = selectedDeleteOperation?.operation_id === operation.operation_id
-                          return (
-                            <button
-                              key={operation.operation_id}
-                              type="button"
-                              onClick={() => setSelectedOperationId(operation.operation_id)}
-                              className={cn(
-                                'w-full rounded-xl border p-4 text-left transition-colors',
-                                isSelected
-                                  ? 'border-primary bg-primary/5 shadow-sm'
-                                  : 'bg-muted/20 hover:border-primary/40 hover:bg-muted/40',
-                              )}
-                            >
-                              <div className="flex flex-col gap-3 lg:flex-row lg:items-start lg:justify-between">
-                                <div className="min-w-0 space-y-2">
-                                  <div className="flex flex-wrap items-center gap-2">
-                                    <Badge variant={operation.status === 'restored' ? 'secondary' : 'default'}>
-                                      {formatDeleteOperationStatus(String(operation.status ?? ''))}
-                                    </Badge>
-                                    <Badge variant="outline">
-                                      {formatDeleteOperationMode(String(operation.mode ?? ''))}
-                                    </Badge>
-                                  </div>
-                                  <div className="font-mono text-xs break-all">{operation.operation_id}</div>
-                                  <div className="text-sm text-muted-foreground">
-                                    {operation.reason || '未填写原因'}
-                                  </div>
-                                </div>
-                                <div className="flex flex-wrap gap-2 text-xs text-muted-foreground lg:max-w-[280px] lg:justify-end">
-                                  <span>实体 {Number(counts.entities ?? 0)}</span>
-                                  <span>关系 {Number(counts.relations ?? 0)}</span>
-                                  <span>段落 {Number(counts.paragraphs ?? 0)}</span>
-                                  <span>来源 {Number(counts.sources ?? 0)}</span>
-                                </div>
-                              </div>
-                              <div className="mt-3 text-xs text-muted-foreground">
-                                {formatDeleteOperationTime(operation.created_at)}
-                              </div>
-                            </button>
-                          )
-                        }) : (
-                          <div className="rounded-lg border border-dashed bg-muted/20 p-6 text-center text-sm text-muted-foreground">
-                            当前筛选条件下没有删除操作
-                          </div>
-                        )}
-                      </div>
-                    </ScrollArea>
-
-                    <div className="flex items-center justify-between gap-2">
-                      <Button
-                        variant="outline"
-                        size="sm"
-                        onClick={() => setOperationPage((current) => Math.max(1, current - 1))}
-                        disabled={operationPage <= 1}
-                      >
-                        上一页
-                      </Button>
-                      <div className="text-xs text-muted-foreground">
-                        支持按删除记录、模式、状态、发起人和来源检索
-                      </div>
-                      <Button
-                        variant="outline"
-                        size="sm"
-                        onClick={() => setOperationPage((current) => Math.min(deleteOperationPageCount, current + 1))}
-                        disabled={operationPage >= deleteOperationPageCount}
-                      >
-                        下一页
-                      </Button>
-                    </div>
-
-                    <div className="rounded-xl border bg-muted/20 p-4">
-                      {selectedDeleteOperation ? (
-                        <div className="space-y-4">
-                          <div className="flex flex-col gap-3 lg:flex-row lg:items-start lg:justify-between">
-                            <div className="space-y-2">
-                              <div className="flex flex-wrap items-center gap-2">
-                                <Badge variant={selectedDeleteOperation.status === 'restored' ? 'secondary' : 'default'}>
-                                  {formatDeleteOperationStatus(String(selectedDeleteOperation.status ?? ''))}
-                                </Badge>
-                                <Badge variant="outline">
-                                  {formatDeleteOperationMode(String(selectedDeleteOperation.mode ?? ''))}
-                                </Badge>
-                              </div>
-                              <div className="font-mono text-xs break-all">{selectedDeleteOperation.operation_id}</div>
-                              <div className="text-sm text-muted-foreground">
-                                {selectedDeleteOperation.reason || '未填写删除原因'}
-                              </div>
-                            </div>
-                            <Button
-                              size="sm"
-                              variant="outline"
-                              onClick={() => void restoreDeleteOperation(selectedDeleteOperation.operation_id)}
-                              disabled={selectedDeleteOperation.status === 'restored' || deleteRestoring}
-                            >
-                              <RotateCcw className="mr-2 h-4 w-4" />
-                              {selectedDeleteOperation.status === 'restored' ? '已恢复' : '恢复这次删除'}
-                            </Button>
-                          </div>
-
-                          <div className="grid gap-3 lg:grid-cols-4">
-                            <div className="rounded-lg border bg-background/60 p-3">
-                              <div className="text-xs text-muted-foreground">发起人</div>
-                              <div className="mt-1 text-sm">{selectedDeleteOperation.requested_by || '-'}</div>
-                            </div>
-                            <div className="rounded-lg border bg-background/60 p-3">
-                              <div className="text-xs text-muted-foreground">创建时间</div>
-                              <div className="mt-1 text-sm">{formatDeleteOperationTime(selectedDeleteOperation.created_at)}</div>
-                            </div>
-                            <div className="rounded-lg border bg-background/60 p-3">
-                              <div className="text-xs text-muted-foreground">恢复时间</div>
-                              <div className="mt-1 text-sm">{formatDeleteOperationTime(selectedDeleteOperation.restored_at)}</div>
-                            </div>
-                            <div className="rounded-lg border bg-background/60 p-3">
-                              <div className="text-xs text-muted-foreground">删除摘要</div>
-                              <div className="mt-1 flex flex-wrap gap-2">
-                                <Badge variant="outline">实体 {Number(selectedOperationCounts.entities ?? 0)}</Badge>
-                                <Badge variant="outline">关系 {Number(selectedOperationCounts.relations ?? 0)}</Badge>
-                                <Badge variant="outline">段落 {Number(selectedOperationCounts.paragraphs ?? 0)}</Badge>
-                                <Badge variant="outline">来源 {Number(selectedOperationCounts.sources ?? 0)}</Badge>
-                              </div>
-                            </div>
-                          </div>
-
-                          {selectedOperationDetailLoading ? (
-                            <div className="rounded-lg border bg-background/60 p-4 text-sm text-muted-foreground">
-                              正在加载影响对象详情...
-                            </div>
-                          ) : null}
-
-                          {selectedOperationDetailError ? (
-                            <Alert variant="destructive">
-                              <AlertDescription>{selectedOperationDetailError}</AlertDescription>
-                            </Alert>
-                          ) : null}
-
-                          {selectedOperationSources.length > 0 ? (
-                            <div className="space-y-2">
-                              <div className="text-sm font-semibold">关联来源</div>
-                              <div className="flex flex-wrap gap-2">
-                                {selectedOperationSources.map((source) => (
-                                  <Badge key={source} variant="secondary" className="max-w-full break-all">
-                                    {source}
-                                  </Badge>
-                                ))}
-                              </div>
-                            </div>
-                          ) : null}
-
-                          <div className="grid gap-4 xl:grid-cols-[minmax(0,0.9fr)_minmax(0,1.1fr)]">
-                            <div className="space-y-2">
-                              <div className="text-sm font-semibold">选择器</div>
-                              <pre className="max-h-56 overflow-auto rounded-lg border bg-background/70 p-3 text-xs break-words whitespace-pre-wrap">
-                                {JSON.stringify(selectedDeleteOperation.selector ?? {}, null, 2)}
-                              </pre>
-                            </div>
-
-                            <div className="space-y-2">
-                              <div className="flex items-center justify-between">
-                                <div className="text-sm font-semibold">影响对象</div>
-                                <div className="text-xs text-muted-foreground">
-                                  命中 {filteredSelectedOperationItems.length} / {selectedOperationItems.length} 项
-                                </div>
-                              </div>
-                              <div className="flex flex-col gap-3 lg:flex-row lg:items-center lg:justify-between">
-                                <Input
-                                  value={selectedOperationItemSearch}
-                                  onChange={(event) => setSelectedOperationItemSearch(event.target.value)}
-                                  placeholder="搜索对象类型 / 哈希 / 对象键 / 来源"
-                                  className="lg:max-w-sm"
-                                />
-                                <div className="flex items-center justify-between gap-2 text-xs text-muted-foreground lg:min-w-[180px] lg:justify-end">
-                                  <span>第 {selectedOperationItemPage} / {selectedOperationItemPageCount} 页</span>
-                                  <span>每页 {DELETE_OPERATION_ITEM_PAGE_SIZE} 项</span>
-                                </div>
-                              </div>
-                              <ScrollArea className="h-[280px] rounded-lg border bg-background/60">
-                                <div className="space-y-2 p-3">
-                                  {pagedSelectedOperationItems.length > 0 ? pagedSelectedOperationItems.map((item) => {
-                                    const source = getDeleteOperationItemSource(item)
-                                    const label = getDeleteOperationItemLabel(item)
-                                    const preview = getDeleteOperationItemPreview(item)
-                                    return (
-                                      <div key={`${item.item_type}:${item.item_hash}:${item.item_key ?? ''}`} className="rounded-lg border bg-muted/20 p-3">
-                                        <div className="flex flex-wrap items-center gap-2">
-                                          <Badge variant="outline">{item.item_type}</Badge>
-                                          {source ? <Badge variant="secondary">{source}</Badge> : null}
-                                          {item.item_key && item.item_key !== item.item_hash ? (
-                                            <span className="text-xs text-muted-foreground break-all">{item.item_key}</span>
-                                          ) : null}
-                                        </div>
-                                        <div className="mt-2 text-sm font-medium break-words">
-                                          {label}
-                                        </div>
-                                        {preview ? (
-                                          <div className="mt-1 text-xs text-muted-foreground break-words">
-                                            {preview}
-                                          </div>
-                                        ) : null}
-                                        <div className="mt-2 font-mono text-[11px] break-all text-muted-foreground">
-                                          {item.item_hash}
-                                        </div>
-                                      </div>
-                                    )
-                                  }) : (
-                                    <div className="rounded-lg border border-dashed bg-muted/20 p-6 text-center text-sm text-muted-foreground">
-                                      {selectedOperationItems.length > 0 ? '当前筛选条件下没有明细项' : '当前操作没有记录明细项'}
-                                    </div>
-                                  )}
-                                </div>
-                              </ScrollArea>
-                              <div className="flex items-center justify-between gap-2">
-                                <Button
-                                  variant="outline"
-                                  size="sm"
-                                  onClick={() => setSelectedOperationItemPage((current) => Math.max(1, current - 1))}
-                                  disabled={selectedOperationItemPage <= 1}
-                                >
-                                  上一页
-                                </Button>
-                                <div className="text-xs text-muted-foreground">
-                                  支持按对象类型、哈希、对象键和来源检索
-                                </div>
-                                <Button
-                                  variant="outline"
-                                  size="sm"
-                                  onClick={() => setSelectedOperationItemPage((current) => Math.min(selectedOperationItemPageCount, current + 1))}
-                                  disabled={selectedOperationItemPage >= selectedOperationItemPageCount}
-                                >
-                                  下一页
-                                </Button>
-                              </div>
-                            </div>
-                          </div>
-                        </div>
-                      ) : (
-                        <div className="flex min-h-[320px] items-center justify-center rounded-lg border border-dashed bg-background/40 p-6 text-center text-sm text-muted-foreground">
-                          当前没有可查看的删除操作详情
-                        </div>
-                      )}
-                    </div>
-                  </CardContent>
-                </Card>
-              </div>
-            </TabsContent>
-
-            <TabsContent value="feedback" className="space-y-4">
-              <div className="space-y-4">
-                <Card>
-                  <CardHeader>
-                    <CardTitle className="flex items-center gap-2">
-                      <RotateCcw className="h-4 w-4" />
-                      反馈纠错历史
-                    </CardTitle>
-                    <CardDescription>
-                      查看 feedback correction 的判定、修改轨迹与回退结果；本期仅覆盖自动纠错任务
-                    </CardDescription>
-                  </CardHeader>
-                  <CardContent className="space-y-4">
-                    <div className="grid gap-3 lg:grid-cols-[minmax(0,1fr)_180px_180px]">
-                      <Input
-                        value={feedbackSearch}
-                        onChange={(event) => setFeedbackSearch(event.target.value)}
-                        placeholder="搜索查询编号 / 会话 / 查询内容 / 原因"
-                      />
-                      <Select value={feedbackStatusFilter} onValueChange={setFeedbackStatusFilter}>
-                        <SelectTrigger>
-                          <SelectValue placeholder="按任务状态筛选" />
-                        </SelectTrigger>
-                        <SelectContent>
-                          <SelectItem value="all">全部任务状态</SelectItem>
-                          <SelectItem value="applied">已应用</SelectItem>
-                          <SelectItem value="skipped">已跳过</SelectItem>
-                          <SelectItem value="error">失败</SelectItem>
-                          <SelectItem value="running">处理中</SelectItem>
-                          <SelectItem value="pending">待处理</SelectItem>
-                        </SelectContent>
-                      </Select>
-                      <Select value={feedbackRollbackFilter} onValueChange={setFeedbackRollbackFilter}>
-                        <SelectTrigger>
-                          <SelectValue placeholder="按回退状态筛选" />
-                        </SelectTrigger>
-                        <SelectContent>
-                          <SelectItem value="all">全部回退状态</SelectItem>
-                          <SelectItem value="none">未回退</SelectItem>
-                          <SelectItem value="rolled_back">已回退</SelectItem>
-                          <SelectItem value="error">回退失败</SelectItem>
-                          <SelectItem value="running">回退中</SelectItem>
-                        </SelectContent>
-                      </Select>
-                    </div>
-
-                    <div className="flex flex-wrap items-center justify-between gap-2 rounded-xl border bg-background/70 px-3 py-2 text-sm text-muted-foreground">
-                      <span>当前命中 {filteredFeedbackCorrections.length} 条记录，已加载最近 {feedbackCorrections.length} 条</span>
-                      <span>第 {feedbackPage} / {feedbackPageCount} 页，每页显示 {FEEDBACK_CORRECTION_PAGE_SIZE} 条</span>
-                    </div>
-
-                    <div className="grid items-start gap-4 xl:grid-cols-[minmax(0,0.92fr)_minmax(0,1.08fr)]">
-                      <ScrollArea className="h-[720px] rounded-lg border">
-                        <div className="space-y-3 p-3">
-                          {pagedFeedbackCorrections.length > 0 ? pagedFeedbackCorrections.map((item) => {
-                            const isSelected = selectedFeedbackCorrection?.task_id === item.task_id
-                            const preview = getFeedbackCorrectionPreview(item)
-                            const impactSummary = buildFeedbackImpactSummary(item)
-                            return (
-                              <button
-                                key={item.task_id}
-                                type="button"
-                                onClick={() => setSelectedFeedbackTaskId(item.task_id)}
-                                className={cn(
-                                  'w-full rounded-xl border p-4 text-left transition-colors',
-                                  isSelected
-                                    ? 'border-primary bg-primary/5 shadow-sm'
-                                    : 'bg-muted/20 hover:border-primary/40 hover:bg-muted/40',
-                                )}
-                              >
-                                <div className="flex flex-col gap-3">
-                                  <div className="flex flex-wrap items-start justify-between gap-2">
-                                    <div className="flex flex-wrap items-center gap-2">
-                                      <Badge variant={getFeedbackStatusVariant(item.task_status)}>
-                                        {formatFeedbackTaskStatus(item.task_status)}
-                                      </Badge>
-                                      <Badge variant={getFeedbackStatusVariant(item.rollback_status)}>
-                                        {formatFeedbackRollbackStatus(item.rollback_status)}
-                                      </Badge>
-                                      <Badge variant="outline">
-                                        {formatFeedbackDecision(item.decision)}
-                                      </Badge>
-                                    </div>
-                                    <div className="text-[11px] text-muted-foreground">
-                                      {formatDeleteOperationTime(item.query_timestamp ?? item.created_at)}
-                                    </div>
-                                  </div>
-                                  <div className="space-y-1">
-                                    <div className="text-sm font-semibold break-words">
-                                      {preview.headline}
-                                    </div>
-                                    <div className="text-xs text-muted-foreground break-words">
-                                      查询：{item.query_text || '无查询文本'}
-                                    </div>
-                                  </div>
-                                  {(preview.oldRelation || preview.newRelation) ? (
-                                    <div className="grid gap-2 rounded-lg border bg-background/70 p-3 text-xs shadow-sm">
-                                      <div className="grid gap-2 sm:grid-cols-[minmax(0,1fr)_auto_minmax(0,1fr)] sm:items-stretch">
-                                        <div className="rounded-md border border-amber-500/20 bg-amber-500/5 p-2">
-                                          <div className="text-[11px] font-medium text-amber-700 dark:text-amber-300">纠错前</div>
-                                          <div className="mt-1 break-words">{preview.oldRelation || '无'}</div>
-                                        </div>
-                                        <div className="hidden items-center text-muted-foreground sm:flex">→</div>
-                                        <div className="rounded-md border border-emerald-500/20 bg-emerald-500/5 p-2">
-                                          <div className="text-[11px] font-medium text-emerald-700 dark:text-emerald-300">纠错后</div>
-                                          <div className="mt-1 break-words">{preview.newRelation || '无'}</div>
-                                        </div>
-                                      </div>
-                                    </div>
-                                  ) : null}
-                                  <div className="flex flex-wrap gap-2">
-                                    {impactSummary.length > 0 ? impactSummary.slice(0, 3).map((summary) => (
-                                      <Badge key={`${item.task_id}:${summary}`} variant="secondary" className="font-normal">
-                                        {summary}
-                                      </Badge>
-                                    )) : (
-                                      <Badge variant="secondary" className="font-normal">
-                                        暂无影响摘要
-                                      </Badge>
-                                    )}
-                                  </div>
-                                  <div className="font-mono text-[11px] break-all text-muted-foreground">
-                                    {item.query_tool_id}
-                                  </div>
-                                </div>
-                              </button>
-                            )
-                          }) : (
-                            <div className="rounded-lg border border-dashed bg-muted/20 p-6 text-center text-sm text-muted-foreground">
-                              当前筛选条件下没有纠错历史
-                            </div>
-                          )}
-                        </div>
-                      </ScrollArea>
-
-                      <div className="self-start rounded-xl border bg-muted/20 p-4">
-                        {selectedFeedbackCorrection ? (
-                          <div className="space-y-4">
-                            <div className="flex flex-col gap-3 lg:flex-row lg:items-start lg:justify-between">
-                              <div className="space-y-2">
-                                <div className="flex flex-wrap items-center gap-2">
-                                  <Badge variant={getFeedbackStatusVariant(String(selectedFeedbackResolved?.task_status ?? ''))}>
-                                    {formatFeedbackTaskStatus(String(selectedFeedbackResolved?.task_status ?? ''))}
-                                  </Badge>
-                                  <Badge variant={getFeedbackStatusVariant(String(selectedFeedbackResolved?.rollback_status ?? 'none'))}>
-                                    {formatFeedbackRollbackStatus(String(selectedFeedbackResolved?.rollback_status ?? 'none'))}
-                                  </Badge>
-                                  <Badge variant="outline">
-                                    {formatFeedbackDecision(String(selectedFeedbackResolved?.decision ?? ''))}
-                                  </Badge>
-                                </div>
-                                <div className="text-base font-semibold break-words">
-                                  {selectedFeedbackPreview.headline}
-                                </div>
-                                <div className="text-sm text-muted-foreground break-words">
-                                  查询：{selectedFeedbackResolved?.query_text || '无查询文本'}
-                                </div>
-                                <div className="font-mono text-xs break-all text-muted-foreground">
-                                  {selectedFeedbackResolved?.query_tool_id}
-                                </div>
-                              </div>
-                              <Button
-                                size="sm"
-                                variant="outline"
-                                onClick={openFeedbackRollbackDialog}
-                                disabled={
-                                  String(selectedFeedbackResolved?.task_status ?? '') !== 'applied'
-                                  || String(selectedFeedbackResolved?.rollback_status ?? 'none') === 'rolled_back'
-                                  || feedbackRollingBack
-                                }
-                              >
-                                <RotateCcw className="mr-2 h-4 w-4" />
-                                {String(selectedFeedbackResolved?.rollback_status ?? 'none') === 'rolled_back'
-                                  ? '已回退'
-                                  : '回退本次纠错'}
-                              </Button>
-                            </div>
-
-                            <div className="grid gap-4 xl:grid-cols-[minmax(0,1.05fr)_minmax(0,0.95fr)]">
-                              <div className="rounded-xl border bg-background/70 p-4 shadow-sm">
-                                <div className="text-sm font-semibold">本次纠错结论</div>
-                                <div className="mt-3 grid gap-3 md:grid-cols-[minmax(0,1fr)_auto_minmax(0,1fr)] md:items-stretch">
-                                  <div className="rounded-lg border border-amber-500/20 bg-amber-500/5 p-3">
-                                    <div className="text-xs font-medium text-amber-700 dark:text-amber-300">纠错前</div>
-                                    <div className="mt-2 text-sm break-words">
-                                      {selectedFeedbackPreview.oldRelation || '当前详情没有记录旧结论'}
-                                    </div>
-                                  </div>
-                                  <div className="hidden items-center justify-center text-muted-foreground md:flex">→</div>
-                                  <div className="rounded-lg border border-emerald-500/20 bg-emerald-500/5 p-3">
-                                    <div className="text-xs font-medium text-emerald-700 dark:text-emerald-300">纠错后</div>
-                                    <div className="mt-2 text-sm break-words">
-                                      {selectedFeedbackPreview.newRelation || '当前详情没有记录新结论'}
-                                    </div>
-                                  </div>
-                                </div>
-                              </div>
-
-                              <div className="rounded-xl border bg-background/70 p-4 shadow-sm">
-                                <div className="text-sm font-semibold">影响范围摘要</div>
-                                <div className="mt-3 flex flex-wrap gap-2">
-                                  {selectedFeedbackImpactSummary.length > 0 ? selectedFeedbackImpactSummary.map((summary) => (
-                                    <Badge key={summary} variant="secondary" className="bg-primary/10 font-normal text-primary hover:bg-primary/15">
-                                      {summary}
-                                    </Badge>
-                                  )) : (
-                                    <div className="text-sm text-muted-foreground">当前没有可展示的影响范围摘要</div>
-                                  )}
-                                </div>
-                              </div>
-                            </div>
-
-                            <div className="grid gap-3 lg:grid-cols-4">
-                              <div className="rounded-lg border bg-background/60 p-3">
-                                <div className="text-xs text-muted-foreground">会话</div>
-                                <div className="mt-1 text-sm break-all">{selectedFeedbackResolved?.session_id || '-'}</div>
-                              </div>
-                              <div className="rounded-lg border bg-background/60 p-3">
-                                <div className="text-xs text-muted-foreground">反馈消息数</div>
-                                <div className="mt-1 text-sm">{Number(selectedFeedbackResolved?.feedback_message_count ?? 0)}</div>
-                              </div>
-                              <div className="rounded-lg border bg-background/60 p-3">
-                                <div className="text-xs text-muted-foreground">判定置信度</div>
-                                <div className="mt-1 text-sm">{Number(selectedFeedbackResolved?.decision_confidence ?? 0).toFixed(2)}</div>
-                              </div>
-                              <div className="rounded-lg border bg-background/60 p-3">
-                                <div className="text-xs text-muted-foreground">回退时间</div>
-                                <div className="mt-1 text-sm">{formatDeleteOperationTime(selectedFeedbackResolved?.rolled_back_at)}</div>
-                              </div>
-                            </div>
-
-                            {selectedFeedbackTaskLoading ? (
-                              <div className="rounded-lg border bg-background/60 p-4 text-sm text-muted-foreground">
-                                正在加载纠错详情...
-                              </div>
-                            ) : null}
-
-                            {selectedFeedbackTaskError ? (
-                              <Alert variant="destructive">
-                                <AlertDescription>{selectedFeedbackTaskError}</AlertDescription>
-                              </Alert>
-                            ) : null}
-
-                            {selectedFeedbackResolved?.rollback_error ? (
-                              <Alert variant="destructive">
-                                <AlertDescription>{selectedFeedbackResolved.rollback_error}</AlertDescription>
-                              </Alert>
-                            ) : null}
-
-                            <div className="grid gap-4 xl:grid-cols-[minmax(0,1.05fr)_minmax(0,0.95fr)]">
-                              <div className="rounded-xl border bg-background/70 p-4">
-                                <div className="text-sm font-semibold">回退后会发生什么</div>
-                                <div className="mt-3 space-y-2 text-sm text-muted-foreground">
-                                  <div>会恢复旧关系状态，并撤销本次纠错写入的段落与关系。</div>
-                                  <div>会清理旧段落的待复核标记，并重新触发相关 Episode / Profile 修复。</div>
-                                  <div>如果你当前只是核对结果，可以先查看下面的详细数据，不必立刻执行回退。</div>
-                                </div>
-                              </div>
-                              <div className="rounded-xl border bg-background/70 p-4">
-                                <div className="text-sm font-semibold">处理摘要</div>
-                                <div className="mt-3 grid gap-2 text-sm text-muted-foreground">
-                                  <div>判定：{formatFeedbackDecision(String(selectedFeedbackResolved?.decision ?? ''))}</div>
-                                  <div>任务状态：{formatFeedbackTaskStatus(String(selectedFeedbackResolved?.task_status ?? ''))}</div>
-                                  <div>回退状态：{formatFeedbackRollbackStatus(String(selectedFeedbackResolved?.rollback_status ?? 'none'))}</div>
-                                  <div>反馈消息数：{Number(selectedFeedbackResolved?.feedback_message_count ?? 0)}</div>
-                                </div>
-                              </div>
-                            </div>
-
-                            <div className="space-y-3">
-                              <div className="text-sm font-semibold">详细数据</div>
-                              <div className="grid gap-3 xl:grid-cols-2">
-                                <details className="rounded-lg border bg-background/70 p-3">
-                                  <summary className="cursor-pointer text-sm font-medium">查询快照 JSON</summary>
-                                  <pre className="mt-3 max-h-56 overflow-auto text-xs break-words whitespace-pre-wrap">
-                                    {JSON.stringify(selectedFeedbackResolved?.query_snapshot ?? {}, null, 2)}
-                                  </pre>
-                                </details>
-                                <details className="rounded-lg border bg-background/70 p-3">
-                                  <summary className="cursor-pointer text-sm font-medium">判定结果 JSON</summary>
-                                  <pre className="mt-3 max-h-56 overflow-auto text-xs break-words whitespace-pre-wrap">
-                                    {JSON.stringify(selectedFeedbackResolved?.decision_payload ?? {}, null, 2)}
-                                  </pre>
-                                </details>
-                                <details className="rounded-lg border bg-background/70 p-3">
-                                  <summary className="cursor-pointer text-sm font-medium">回退计划摘要 JSON</summary>
-                                  <pre className="mt-3 max-h-64 overflow-auto text-xs break-words whitespace-pre-wrap">
-                                    {JSON.stringify(selectedFeedbackResolved?.rollback_plan_summary ?? {}, null, 2)}
-                                  </pre>
-                                </details>
-                                <details className="rounded-lg border bg-background/70 p-3">
-                                  <summary className="cursor-pointer text-sm font-medium">回退结果 JSON</summary>
-                                  <pre className="mt-3 max-h-64 overflow-auto text-xs break-words whitespace-pre-wrap">
-                                    {JSON.stringify(selectedFeedbackResolved?.rollback_result ?? {}, null, 2)}
-                                  </pre>
-                                </details>
-                              </div>
-                            </div>
-
-                            <details className="rounded-xl border bg-background/70 p-4">
-                              <summary className="cursor-pointer text-sm font-semibold">
-                                动作时间线
-                              </summary>
-                              <div className="mt-4 space-y-2">
-                                <div className="flex flex-col gap-3 lg:flex-row lg:items-center lg:justify-between">
-                                  <div className="text-xs text-muted-foreground">
-                                    第 {feedbackActionLogPage} / {feedbackActionLogPageCount} 页，每页 {FEEDBACK_ACTION_LOG_PAGE_SIZE} 项
-                                  </div>
-                                  <Input
-                                    value={feedbackActionLogSearch}
-                                    onChange={(event) => setFeedbackActionLogSearch(event.target.value)}
-                                    placeholder="搜索动作 / 目标哈希 / 预览内容"
-                                    className="lg:w-80"
-                                  />
-                                </div>
-                                <ScrollArea className="h-[240px] rounded-lg border bg-background/60">
-                                  <div className="space-y-2 p-3">
-                                    {pagedFeedbackActionLogs.length > 0 ? pagedFeedbackActionLogs.map((item: MemoryFeedbackActionLogPayload) => (
-                                      <div key={`${item.id}:${item.action_type}`} className="rounded-lg border bg-muted/20 p-3">
-                                        <div className="flex flex-wrap items-center justify-between gap-2">
-                                          <div className="flex flex-wrap items-center gap-2">
-                                            <Badge variant="outline">{formatFeedbackActionType(item.action_type)}</Badge>
-                                            {item.target_hash ? (
-                                              <span className="font-mono text-[11px] break-all text-muted-foreground">{item.target_hash}</span>
-                                            ) : null}
-                                          </div>
-                                          <div className="text-[11px] text-muted-foreground">
-                                            {formatDeleteOperationTime(item.created_at)}
-                                          </div>
-                                        </div>
-                                        <div className="mt-2 text-sm break-words">
-                                          {describeFeedbackActionLog(item)}
-                                        </div>
-                                        {item.reason ? (
-                                          <div className="mt-2 text-xs text-muted-foreground break-words">
-                                            原因：{item.reason}
-                                          </div>
-                                        ) : null}
-                                        {item.before_payload && Object.keys(item.before_payload).length > 0 ? (
-                                          <div className="mt-3 rounded-md border bg-background/70 p-2 text-xs break-words">
-                                            <span className="font-medium">处理前：</span>
-                                            <span className="text-muted-foreground">{summarizeFeedbackActionPayload(item.before_payload)}</span>
-                                          </div>
-                                        ) : null}
-                                        {item.after_payload && Object.keys(item.after_payload).length > 0 ? (
-                                          <div className="mt-2 rounded-md border bg-background/70 p-2 text-xs break-words">
-                                            <span className="font-medium">处理后：</span>
-                                            <span className="text-muted-foreground">{summarizeFeedbackActionPayload(item.after_payload)}</span>
-                                          </div>
-                                        ) : null}
-                                      </div>
-                                    )) : (
-                                      <div className="rounded-lg border border-dashed bg-muted/20 p-6 text-center text-sm text-muted-foreground">
-                                        {selectedFeedbackActionLogs.length > 0 ? '当前筛选条件下没有动作日志' : '当前任务没有动作日志'}
-                                      </div>
-                                    )}
-                                  </div>
-                                </ScrollArea>
-                                <div className="flex items-center justify-between gap-2">
-                                  <Button
-                                    variant="outline"
-                                    size="sm"
-                                    onClick={() => setFeedbackActionLogPage((current) => Math.max(1, current - 1))}
-                                    disabled={feedbackActionLogPage <= 1}
-                                  >
-                                    上一页
-                                  </Button>
-                                  <div className="text-xs text-muted-foreground">支持按动作类型、目标哈希和摘要检索</div>
-                                  <Button
-                                    variant="outline"
-                                    size="sm"
-                                    onClick={() => setFeedbackActionLogPage((current) => Math.min(feedbackActionLogPageCount, current + 1))}
-                                    disabled={feedbackActionLogPage >= feedbackActionLogPageCount}
-                                  >
-                                    下一页
-                                  </Button>
-                                </div>
-                              </div>
-                            </details>
-                          </div>
-                        ) : (
-                          <div className="flex min-h-[360px] items-center justify-center rounded-lg border border-dashed bg-background/40 p-6 text-center text-sm text-muted-foreground">
-                            当前没有可查看的纠错详情
-                          </div>
-                        )}
-                      </div>
-                    </div>
-
-                    <div className="flex items-center justify-between gap-2">
-                      <Button
-                        variant="outline"
-                        size="sm"
-                        onClick={() => setFeedbackPage((current) => Math.max(1, current - 1))}
-                        disabled={feedbackPage <= 1}
-                      >
-                        上一页
-                      </Button>
-                      <div className="text-xs text-muted-foreground">
-                        支持按查询内容、任务状态和回退状态检索
-                      </div>
-                      <Button
-                        variant="outline"
-                        size="sm"
-                        onClick={() => setFeedbackPage((current) => Math.min(feedbackPageCount, current + 1))}
-                        disabled={feedbackPage >= feedbackPageCount}
-                      >
-                        下一页
-                      </Button>
-                    </div>
-                  </CardContent>
-                </Card>
-              </div>
-            </TabsContent>
+            <ImportTab
+              importCreateMode={importCreateMode}
+              setImportCreateMode={setImportCreateMode}
+              importSettings={importSettings}
+              importCommonFileConcurrency={importCommonFileConcurrency}
+              setImportCommonFileConcurrency={setImportCommonFileConcurrency}
+              importCommonChunkConcurrency={importCommonChunkConcurrency}
+              setImportCommonChunkConcurrency={setImportCommonChunkConcurrency}
+              importCommonLlmEnabled={importCommonLlmEnabled}
+              setImportCommonLlmEnabled={setImportCommonLlmEnabled}
+              importCommonChatLog={importCommonChatLog}
+              setImportCommonChatLog={setImportCommonChatLog}
+              importCommonStrategyOverride={importCommonStrategyOverride}
+              setImportCommonStrategyOverride={setImportCommonStrategyOverride}
+              importCommonDedupePolicy={importCommonDedupePolicy}
+              setImportCommonDedupePolicy={setImportCommonDedupePolicy}
+              importCommonChatReferenceTime={importCommonChatReferenceTime}
+              setImportCommonChatReferenceTime={setImportCommonChatReferenceTime}
+              importCommonForce={importCommonForce}
+              setImportCommonForce={setImportCommonForce}
+              importCommonClearManifest={importCommonClearManifest}
+              setImportCommonClearManifest={setImportCommonClearManifest}
+              uploadInputMode={uploadInputMode}
+              setUploadInputMode={setUploadInputMode}
+              uploadFiles={uploadFiles}
+              setUploadFiles={setUploadFiles}
+              pasteName={pasteName}
+              setPasteName={setPasteName}
+              pasteMode={pasteMode}
+              setPasteMode={setPasteMode}
+              pasteContent={pasteContent}
+              setPasteContent={setPasteContent}
+              rawAlias={rawAlias}
+              setRawAlias={setRawAlias}
+              rawInputMode={rawInputMode}
+              setRawInputMode={setRawInputMode}
+              rawRelativePath={rawRelativePath}
+              setRawRelativePath={setRawRelativePath}
+              rawGlob={rawGlob}
+              setRawGlob={setRawGlob}
+              rawRecursive={rawRecursive}
+              setRawRecursive={setRawRecursive}
+              openieAlias={openieAlias}
+              setOpenieAlias={setOpenieAlias}
+              openieRelativePath={openieRelativePath}
+              setOpenieRelativePath={setOpenieRelativePath}
+              openieIncludeAllJson={openieIncludeAllJson}
+              setOpenieIncludeAllJson={setOpenieIncludeAllJson}
+              convertAlias={convertAlias}
+              setConvertAlias={setConvertAlias}
+              convertTargetAlias={convertTargetAlias}
+              setConvertTargetAlias={setConvertTargetAlias}
+              convertRelativePath={convertRelativePath}
+              setConvertRelativePath={setConvertRelativePath}
+              convertTargetRelativePath={convertTargetRelativePath}
+              setConvertTargetRelativePath={setConvertTargetRelativePath}
+              convertDimension={convertDimension}
+              setConvertDimension={setConvertDimension}
+              convertBatchSize={convertBatchSize}
+              setConvertBatchSize={setConvertBatchSize}
+              backfillAlias={backfillAlias}
+              setBackfillAlias={setBackfillAlias}
+              backfillLimit={backfillLimit}
+              setBackfillLimit={setBackfillLimit}
+              backfillRelativePath={backfillRelativePath}
+              setBackfillRelativePath={setBackfillRelativePath}
+              backfillDryRun={backfillDryRun}
+              setBackfillDryRun={setBackfillDryRun}
+              backfillNoCreatedFallback={backfillNoCreatedFallback}
+              setBackfillNoCreatedFallback={setBackfillNoCreatedFallback}
+              maibotSourceDb={maibotSourceDb}
+              setMaibotSourceDb={setMaibotSourceDb}
+              maibotTimeFrom={maibotTimeFrom}
+              setMaibotTimeFrom={setMaibotTimeFrom}
+              maibotTimeTo={maibotTimeTo}
+              setMaibotTimeTo={setMaibotTimeTo}
+              maibotStartId={maibotStartId}
+              setMaibotStartId={setMaibotStartId}
+              maibotEndId={maibotEndId}
+              setMaibotEndId={setMaibotEndId}
+              maibotStreamIds={maibotStreamIds}
+              setMaibotStreamIds={setMaibotStreamIds}
+              maibotGroupIds={maibotGroupIds}
+              setMaibotGroupIds={setMaibotGroupIds}
+              maibotUserIds={maibotUserIds}
+              setMaibotUserIds={setMaibotUserIds}
+              maibotReadBatchSize={maibotReadBatchSize}
+              setMaibotReadBatchSize={setMaibotReadBatchSize}
+              maibotCommitWindowRows={maibotCommitWindowRows}
+              setMaibotCommitWindowRows={setMaibotCommitWindowRows}
+              maibotEmbedWorkers={maibotEmbedWorkers}
+              setMaibotEmbedWorkers={setMaibotEmbedWorkers}
+              maibotNoResume={maibotNoResume}
+              setMaibotNoResume={setMaibotNoResume}
+              maibotResetState={maibotResetState}
+              setMaibotResetState={setMaibotResetState}
+              maibotDryRun={maibotDryRun}
+              setMaibotDryRun={setMaibotDryRun}
+              maibotVerifyOnly={maibotVerifyOnly}
+              setMaibotVerifyOnly={setMaibotVerifyOnly}
+              submitImportByMode={submitImportByMode}
+              creatingImport={creatingImport}
+              pathResolveAlias={pathResolveAlias}
+              setPathResolveAlias={setPathResolveAlias}
+              importAliasKeys={importAliasKeys}
+              pathResolveRelativePath={pathResolveRelativePath}
+              setPathResolveRelativePath={setPathResolveRelativePath}
+              pathResolveMustExist={pathResolveMustExist}
+              setPathResolveMustExist={setPathResolveMustExist}
+              resolveImportPath={resolveImportPath}
+              resolvingPath={resolvingPath}
+              pathResolveOutput={pathResolveOutput}
+              refreshImportQueue={refreshImportQueue}
+              runningImportTasks={runningImportTasks}
+              queuedImportTasks={queuedImportTasks}
+              recentImportTasks={recentImportTasks}
+              selectedImportTaskId={selectedImportTaskId}
+              selectImportTask={selectImportTask}
+              importAutoPolling={importAutoPolling}
+              setImportAutoPolling={setImportAutoPolling}
+              importPollInterval={importPollInterval}
+              importErrorText={importErrorText}
+              cancelSelectedImportTask={cancelSelectedImportTask}
+              retrySelectedImportTask={retrySelectedImportTask}
+              selectedImportTaskLoading={selectedImportTaskLoading}
+              selectedImportTaskResolved={selectedImportTaskResolved}
+              selectedImportRetrySummary={selectedImportRetrySummary}
+              selectedImportTaskErrorText={selectedImportTaskErrorText}
+              selectedImportFiles={selectedImportFiles}
+              selectedImportFileId={selectedImportFileId}
+              selectImportFile={selectImportFile}
+              importChunkTotal={importChunkTotal}
+              importChunkOffset={importChunkOffset}
+              moveImportChunkPage={moveImportChunkPage}
+              canImportChunkPrev={canImportChunkPrev}
+              canImportChunkNext={canImportChunkNext}
+              importChunksLoading={importChunksLoading}
+              selectedImportChunks={selectedImportChunks}
+            />
+
+            <TuningTab
+              tuningObjective={tuningObjective}
+              setTuningObjective={setTuningObjective}
+              tuningIntensity={tuningIntensity}
+              setTuningIntensity={setTuningIntensity}
+              tuningSampleSize={tuningSampleSize}
+              setTuningSampleSize={setTuningSampleSize}
+              tuningTopKEval={tuningTopKEval}
+              setTuningTopKEval={setTuningTopKEval}
+              submitTuningTask={submitTuningTask}
+              creatingTuning={creatingTuning}
+              tuningProfile={tuningProfile}
+              tuningProfileToml={tuningProfileToml}
+              tuningTasks={tuningTasks}
+              applyBestTask={applyBestTask}
+            />
+
+            <DeleteTab
+              sourceSearch={sourceSearch}
+              setSourceSearch={setSourceSearch}
+              selectedSources={selectedSources}
+              setSelectedSources={setSelectedSources}
+              filteredSources={filteredSources}
+              openSourceDeletePreview={openSourceDeletePreview}
+              toggleSourceSelection={toggleSourceSelection}
+              operationSearch={operationSearch}
+              setOperationSearch={setOperationSearch}
+              operationModeFilter={operationModeFilter}
+              setOperationModeFilter={setOperationModeFilter}
+              operationStatusFilter={operationStatusFilter}
+              setOperationStatusFilter={setOperationStatusFilter}
+              filteredDeleteOperations={filteredDeleteOperations}
+              deleteOperations={deleteOperations}
+              operationPage={operationPage}
+              setOperationPage={setOperationPage}
+              deleteOperationPageCount={deleteOperationPageCount}
+              pagedDeleteOperations={pagedDeleteOperations}
+              selectedDeleteOperation={selectedDeleteOperation}
+              setSelectedOperationId={setSelectedOperationId}
+              restoreDeleteOperation={restoreDeleteOperation}
+              deleteRestoring={deleteRestoring}
+              selectedOperationCounts={selectedOperationCounts}
+              selectedOperationDetailLoading={selectedOperationDetailLoading}
+              selectedOperationDetailError={selectedOperationDetailError}
+              selectedOperationSources={selectedOperationSources}
+              selectedOperationItems={selectedOperationItems}
+              filteredSelectedOperationItems={filteredSelectedOperationItems}
+              selectedOperationItemSearch={selectedOperationItemSearch}
+              setSelectedOperationItemSearch={setSelectedOperationItemSearch}
+              selectedOperationItemPage={selectedOperationItemPage}
+              setSelectedOperationItemPage={setSelectedOperationItemPage}
+              selectedOperationItemPageCount={selectedOperationItemPageCount}
+              pagedSelectedOperationItems={pagedSelectedOperationItems}
+            />
+
+            <FeedbackTab
+              feedbackSearch={feedbackSearch}
+              setFeedbackSearch={setFeedbackSearch}
+              feedbackStatusFilter={feedbackStatusFilter}
+              setFeedbackStatusFilter={setFeedbackStatusFilter}
+              feedbackRollbackFilter={feedbackRollbackFilter}
+              setFeedbackRollbackFilter={setFeedbackRollbackFilter}
+              filteredFeedbackCorrections={filteredFeedbackCorrections}
+              feedbackCorrections={feedbackCorrections}
+              pagedFeedbackCorrections={pagedFeedbackCorrections}
+              feedbackPage={feedbackPage}
+              setFeedbackPage={setFeedbackPage}
+              feedbackPageCount={feedbackPageCount}
+              selectedFeedbackCorrection={selectedFeedbackCorrection}
+              setSelectedFeedbackTaskId={setSelectedFeedbackTaskId}
+              selectedFeedbackResolved={selectedFeedbackResolved}
+              selectedFeedbackPreview={selectedFeedbackPreview}
+              selectedFeedbackImpactSummary={selectedFeedbackImpactSummary}
+              openFeedbackRollbackDialog={openFeedbackRollbackDialog}
+              feedbackRollingBack={feedbackRollingBack}
+              selectedFeedbackTaskLoading={selectedFeedbackTaskLoading}
+              selectedFeedbackTaskError={selectedFeedbackTaskError}
+              feedbackActionLogPage={feedbackActionLogPage}
+              setFeedbackActionLogPage={setFeedbackActionLogPage}
+              feedbackActionLogPageCount={feedbackActionLogPageCount}
+              feedbackActionLogSearch={feedbackActionLogSearch}
+              setFeedbackActionLogSearch={setFeedbackActionLogSearch}
+              pagedFeedbackActionLogs={pagedFeedbackActionLogs}
+              selectedFeedbackActionLogs={selectedFeedbackActionLogs}
+            />
           </Tabs>
         </div>
       </div>
diff --git a/dashboard/src/routes/resource/knowledge-base/constants.ts b/dashboard/src/routes/resource/knowledge-base/constants.ts
new file mode 100644
index 0000000000..39d2543bcd
--- /dev/null
+++ b/dashboard/src/routes/resource/knowledge-base/constants.ts
@@ -0,0 +1,52 @@
+import type { MemoryImportTaskKind } from '@/lib/memory-api'
+
+export const DELETE_OPERATION_FETCH_LIMIT = 100
+export const DELETE_OPERATION_PAGE_SIZE = 6
+export const DELETE_OPERATION_ITEM_PAGE_SIZE = 8
+export const FEEDBACK_CORRECTION_FETCH_LIMIT = 100
+export const FEEDBACK_CORRECTION_PAGE_SIZE = 6
+export const FEEDBACK_ACTION_LOG_PAGE_SIZE = 8
+export const IMPORT_CHUNK_PAGE_SIZE = 50
+
+export const RUNNING_IMPORT_STATUS = new Set(['preparing', 'running', 'cancel_requested'])
+export const QUEUED_IMPORT_STATUS = new Set(['queued'])
+
+export const IMPORT_STATUS_TEXT: Record<string, string> = {
+  queued: '排队中',
+  preparing: '准备中',
+  running: '运行中',
+  cancel_requested: '取消中',
+  cancelled: '已取消',
+  completed: '已完成',
+  completed_with_errors: '完成（有错误）',
+  failed: '失败',
+}
+
+export const IMPORT_STEP_TEXT: Record<string, string> = {
+  queued: '排队中',
+  preparing: '准备中',
+  running: '运行中',
+  splitting: '分块中',
+  extracting: '抽取中',
+  writing: '写入中',
+  saving: '保存中',
+  backfilling: '回填中',
+  converting: '转换中',
+  verifying: '校验中',
+  switching: '切换中',
+  cancel_requested: '取消中',
+  cancelled: '已取消',
+  completed: '已完成',
+  completed_with_errors: '完成（有错误）',
+  failed: '失败',
+}
+
+export const IMPORT_KIND_OPTIONS: Array<{ value: MemoryImportTaskKind; label: string; description: string }> = [
+  { value: 'upload', label: '上传文件', description: '从本地批量上传资料文件' },
+  { value: 'paste', label: '粘贴导入', description: '直接粘贴文本或 JSON 内容创建任务' },
+  { value: 'raw_scan', label: '本地扫描', description: '按路径别名和匹配规则批量扫描导入' },
+  { value: 'lpmm_openie', label: 'LPMM OpenIE', description: '读取 LPMM 数据并抽取关系' },
+  { value: 'lpmm_convert', label: 'LPMM 转换', description: '将 LPMM 数据转换到目标目录' },
+  { value: 'temporal_backfill', label: '时序回填', description: '为已有数据补充时间字段' },
+  { value: 'maibot_migration', label: 'MaiBot 迁移', description: '从 MaiBot 历史数据迁移长期记忆' },
+]
diff --git a/dashboard/src/routes/resource/knowledge-base/tabs/DeleteTab.tsx b/dashboard/src/routes/resource/knowledge-base/tabs/DeleteTab.tsx
new file mode 100644
index 0000000000..ba67a891ac
--- /dev/null
+++ b/dashboard/src/routes/resource/knowledge-base/tabs/DeleteTab.tsx
@@ -0,0 +1,492 @@
+import type { Dispatch, SetStateAction } from 'react'
+
+import { CircleAlert, RotateCcw, Trash2 } from 'lucide-react'
+
+import { Alert, AlertDescription } from '@/components/ui/alert'
+import { Badge } from '@/components/ui/badge'
+import { Button } from '@/components/ui/button'
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+import { Checkbox } from '@/components/ui/checkbox'
+import { Input } from '@/components/ui/input'
+import { Label } from '@/components/ui/label'
+import { ScrollArea } from '@/components/ui/scroll-area'
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/components/ui/select'
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@/components/ui/table'
+import { TabsContent } from '@/components/ui/tabs'
+import { cn } from '@/lib/utils'
+import type { MemoryDeleteOperationPayload, MemorySourceItemPayload } from '@/lib/memory-api'
+
+import { DELETE_OPERATION_ITEM_PAGE_SIZE, DELETE_OPERATION_PAGE_SIZE } from '../constants'
+import {
+  formatDeleteOperationMode,
+  formatDeleteOperationStatus,
+  formatDeleteOperationTime,
+  getDeleteOperationItemLabel,
+  getDeleteOperationItemPreview,
+  getDeleteOperationItemSource,
+  type DeleteOperationItem,
+} from '../utils'
+
+export interface DeleteTabProps {
+  sourceSearch: string
+  setSourceSearch: Dispatch<SetStateAction<string>>
+  selectedSources: string[]
+  setSelectedSources: Dispatch<SetStateAction<string[]>>
+  filteredSources: MemorySourceItemPayload[]
+  openSourceDeletePreview: () => Promise<void>
+  toggleSourceSelection: (source: string, checked: boolean) => void
+
+  operationSearch: string
+  setOperationSearch: Dispatch<SetStateAction<string>>
+  operationModeFilter: string
+  setOperationModeFilter: Dispatch<SetStateAction<string>>
+  operationStatusFilter: string
+  setOperationStatusFilter: Dispatch<SetStateAction<string>>
+  filteredDeleteOperations: MemoryDeleteOperationPayload[]
+  deleteOperations: MemoryDeleteOperationPayload[]
+  operationPage: number
+  setOperationPage: Dispatch<SetStateAction<number>>
+  deleteOperationPageCount: number
+  pagedDeleteOperations: MemoryDeleteOperationPayload[]
+  selectedDeleteOperation: MemoryDeleteOperationPayload | null
+  setSelectedOperationId: Dispatch<SetStateAction<string>>
+  restoreDeleteOperation: (operationId: string) => Promise<void>
+  deleteRestoring: boolean
+  selectedOperationCounts: Record<string, number>
+  selectedOperationDetailLoading: boolean
+  selectedOperationDetailError: string
+  selectedOperationSources: string[]
+  selectedOperationItems: DeleteOperationItem[]
+  filteredSelectedOperationItems: DeleteOperationItem[]
+  selectedOperationItemSearch: string
+  setSelectedOperationItemSearch: Dispatch<SetStateAction<string>>
+  selectedOperationItemPage: number
+  setSelectedOperationItemPage: Dispatch<SetStateAction<number>>
+  selectedOperationItemPageCount: number
+  pagedSelectedOperationItems: DeleteOperationItem[]
+}
+
+export function DeleteTab(props: DeleteTabProps) {
+  const {
+    sourceSearch,
+    setSourceSearch,
+    selectedSources,
+    setSelectedSources,
+    filteredSources,
+    openSourceDeletePreview,
+    toggleSourceSelection,
+    operationSearch,
+    setOperationSearch,
+    operationModeFilter,
+    setOperationModeFilter,
+    operationStatusFilter,
+    setOperationStatusFilter,
+    filteredDeleteOperations,
+    deleteOperations,
+    operationPage,
+    setOperationPage,
+    deleteOperationPageCount,
+    pagedDeleteOperations,
+    selectedDeleteOperation,
+    setSelectedOperationId,
+    restoreDeleteOperation,
+    deleteRestoring,
+    selectedOperationCounts,
+    selectedOperationDetailLoading,
+    selectedOperationDetailError,
+    selectedOperationSources,
+    selectedOperationItems,
+    filteredSelectedOperationItems,
+    selectedOperationItemSearch,
+    setSelectedOperationItemSearch,
+    selectedOperationItemPage,
+    setSelectedOperationItemPage,
+    selectedOperationItemPageCount,
+    pagedSelectedOperationItems,
+  } = props
+
+  return (
+    <TabsContent value="delete" className="space-y-4">
+      <div className="flex flex-col gap-4">
+        <Card className="order-2">
+          <CardHeader className="space-y-3">
+            <div>
+              <CardTitle className="flex items-center gap-2">
+                <Trash2 className="h-4 w-4" />
+                来源批量删除
+              </CardTitle>
+              <CardDescription>
+                用于按来源清理测试数据或指定导入批次。该操作不会直接删除实体，只会删除来源段落和失去全部证据的关系。
+              </CardDescription>
+            </div>
+            <Alert className="border-amber-500/30 bg-amber-500/5 text-amber-950 dark:text-amber-200">
+              <CircleAlert className="h-4 w-4 text-amber-500" />
+              <AlertDescription>
+                建议先在图谱里确认影响范围，再在这里执行批量来源删除。所有删除都会先经过预览，并支持按删除记录恢复。
+              </AlertDescription>
+            </Alert>
+          </CardHeader>
+          <CardContent className="space-y-4">
+            <div className="grid gap-3 rounded-xl border bg-muted/20 p-4 lg:grid-cols-[minmax(0,1fr)_auto] lg:items-center">
+              <div className="space-y-2">
+                <Label>来源检索</Label>
+                <Input
+                  value={sourceSearch}
+                  onChange={(event) => setSourceSearch(event.target.value)}
+                  placeholder="搜索 source 名称"
+                />
+              </div>
+              <div className="flex flex-wrap gap-2 lg:justify-end">
+                <Button
+                  variant="outline"
+                  onClick={() => setSelectedSources(filteredSources.map((item) => String(item.source ?? '')).filter(Boolean))}
+                >
+                  全选当前结果
+                </Button>
+                <Button onClick={() => void openSourceDeletePreview()} disabled={selectedSources.length <= 0}>
+                  <Trash2 className="mr-2 h-4 w-4" />
+                  预览删除
+                </Button>
+              </div>
+            </div>
+
+            <div className="flex flex-wrap items-center gap-2 text-sm text-muted-foreground">
+              <Badge variant="outline" className="bg-background/70">当前命中 {filteredSources.length} 个来源</Badge>
+              <Badge variant={selectedSources.length > 0 ? 'secondary' : 'outline'} className="bg-background/70">
+                已选择 {selectedSources.length} 个来源
+              </Badge>
+            </div>
+
+            <ScrollArea className="h-[320px] rounded-lg border">
+              <Table>
+                <TableHeader className="sticky top-0 bg-background">
+                  <TableRow>
+                    <TableHead className="w-12">选中</TableHead>
+                    <TableHead>来源</TableHead>
+                    <TableHead>段落数</TableHead>
+                    <TableHead>关系数</TableHead>
+                  </TableRow>
+                </TableHeader>
+                <TableBody>
+                  {filteredSources.length > 0 ? filteredSources.map((item) => {
+                    const source = String(item.source ?? '')
+                    const checked = selectedSources.includes(source)
+                    return (
+                      <TableRow key={source}>
+                        <TableCell>
+                          <Checkbox checked={checked} onCheckedChange={(value) => toggleSourceSelection(source, Boolean(value))} />
+                        </TableCell>
+                        <TableCell className="font-mono text-xs break-all">{source}</TableCell>
+                        <TableCell>{Number(item.paragraph_count ?? 0)}</TableCell>
+                        <TableCell>{Number(item.relation_count ?? 0)}</TableCell>
+                      </TableRow>
+                    )
+                  }) : (
+                    <TableRow>
+                      <TableCell colSpan={4} className="text-center text-muted-foreground">
+                        当前没有可删除的来源
+                      </TableCell>
+                    </TableRow>
+                  )}
+                </TableBody>
+              </Table>
+            </ScrollArea>
+          </CardContent>
+        </Card>
+
+        <Card className="order-1">
+          <CardHeader>
+            <CardTitle className="flex items-center gap-2">
+              <RotateCcw className="h-4 w-4" />
+              删除操作恢复
+            </CardTitle>
+            <CardDescription>按列表浏览最近的删除操作，先选中记录，再在下方确认影响范围并执行恢复</CardDescription>
+          </CardHeader>
+          <CardContent className="space-y-4">
+            <div className="grid gap-3 rounded-xl border bg-muted/20 p-4 lg:grid-cols-[minmax(0,1fr)_180px_180px]">
+              <Input
+                value={operationSearch}
+                onChange={(event) => setOperationSearch(event.target.value)}
+                placeholder="搜索 operation / reason / requested_by / source"
+              />
+              <Select value={operationModeFilter} onValueChange={setOperationModeFilter}>
+                <SelectTrigger>
+                  <SelectValue placeholder="按模式筛选" />
+                </SelectTrigger>
+                <SelectContent>
+                  <SelectItem value="all">全部模式</SelectItem>
+                  <SelectItem value="source">来源删除</SelectItem>
+                  <SelectItem value="mixed">混合删除</SelectItem>
+                  <SelectItem value="entity">实体删除</SelectItem>
+                  <SelectItem value="relation">关系删除</SelectItem>
+                  <SelectItem value="paragraph">段落删除</SelectItem>
+                </SelectContent>
+              </Select>
+              <Select value={operationStatusFilter} onValueChange={setOperationStatusFilter}>
+                <SelectTrigger>
+                  <SelectValue placeholder="按状态筛选" />
+                </SelectTrigger>
+                <SelectContent>
+                  <SelectItem value="all">全部状态</SelectItem>
+                  <SelectItem value="executed">已执行</SelectItem>
+                  <SelectItem value="restored">已恢复</SelectItem>
+                </SelectContent>
+              </Select>
+            </div>
+
+            <div className="flex flex-wrap items-center justify-between gap-2 text-sm text-muted-foreground">
+              <span>当前命中 {filteredDeleteOperations.length} 条记录，已加载最近 {deleteOperations.length} 条</span>
+              <span>第 {operationPage} / {deleteOperationPageCount} 页，每页显示 {DELETE_OPERATION_PAGE_SIZE} 条</span>
+            </div>
+
+            <ScrollArea className="h-[320px] rounded-lg border">
+              <div className="space-y-3 p-3">
+                {pagedDeleteOperations.length > 0 ? pagedDeleteOperations.map((operation) => {
+                  const summary = (operation.summary ?? {}) as Record<string, unknown>
+                  const counts = ((summary.counts as Record<string, number> | undefined) ?? {})
+                  const isSelected = selectedDeleteOperation?.operation_id === operation.operation_id
+                  return (
+                    <button
+                      key={operation.operation_id}
+                      type="button"
+                      onClick={() => setSelectedOperationId(operation.operation_id)}
+                      className={cn(
+                        'w-full rounded-xl border p-4 text-left transition-colors',
+                        isSelected
+                          ? 'border-primary bg-primary/5 shadow-sm'
+                          : 'bg-muted/20 hover:border-primary/40 hover:bg-muted/40',
+                      )}
+                    >
+                      <div className="flex flex-col gap-3 lg:flex-row lg:items-start lg:justify-between">
+                        <div className="min-w-0 space-y-2">
+                          <div className="flex flex-wrap items-center gap-2">
+                            <Badge variant={operation.status === 'restored' ? 'secondary' : 'default'}>
+                              {formatDeleteOperationStatus(String(operation.status ?? ''))}
+                            </Badge>
+                            <Badge variant="outline">
+                              {formatDeleteOperationMode(String(operation.mode ?? ''))}
+                            </Badge>
+                          </div>
+                          <div className="font-mono text-xs break-all">{operation.operation_id}</div>
+                          <div className="text-sm text-muted-foreground">
+                            {operation.reason || '未填写原因'}
+                          </div>
+                        </div>
+                        <div className="flex flex-wrap gap-2 text-xs text-muted-foreground lg:max-w-[280px] lg:justify-end">
+                          <span>实体 {Number(counts.entities ?? 0)}</span>
+                          <span>关系 {Number(counts.relations ?? 0)}</span>
+                          <span>段落 {Number(counts.paragraphs ?? 0)}</span>
+                          <span>来源 {Number(counts.sources ?? 0)}</span>
+                        </div>
+                      </div>
+                      <div className="mt-3 text-xs text-muted-foreground">
+                        {formatDeleteOperationTime(operation.created_at)}
+                      </div>
+                    </button>
+                  )
+                }) : (
+                  <div className="rounded-lg border border-dashed bg-muted/20 p-6 text-center text-sm text-muted-foreground">
+                    当前筛选条件下没有删除操作
+                  </div>
+                )}
+              </div>
+            </ScrollArea>
+
+            <div className="flex items-center justify-between gap-2">
+              <Button
+                variant="outline"
+                size="sm"
+                onClick={() => setOperationPage((current) => Math.max(1, current - 1))}
+                disabled={operationPage <= 1}
+              >
+                上一页
+              </Button>
+              <div className="text-xs text-muted-foreground">
+                支持按删除记录、模式、状态、发起人和来源检索
+              </div>
+              <Button
+                variant="outline"
+                size="sm"
+                onClick={() => setOperationPage((current) => Math.min(deleteOperationPageCount, current + 1))}
+                disabled={operationPage >= deleteOperationPageCount}
+              >
+                下一页
+              </Button>
+            </div>
+
+            <div className="rounded-xl border bg-muted/20 p-4">
+              {selectedDeleteOperation ? (
+                <div className="space-y-4">
+                  <div className="flex flex-col gap-3 lg:flex-row lg:items-start lg:justify-between">
+                    <div className="space-y-2">
+                      <div className="flex flex-wrap items-center gap-2">
+                        <Badge variant={selectedDeleteOperation.status === 'restored' ? 'secondary' : 'default'}>
+                          {formatDeleteOperationStatus(String(selectedDeleteOperation.status ?? ''))}
+                        </Badge>
+                        <Badge variant="outline">
+                          {formatDeleteOperationMode(String(selectedDeleteOperation.mode ?? ''))}
+                        </Badge>
+                      </div>
+                      <div className="font-mono text-xs break-all">{selectedDeleteOperation.operation_id}</div>
+                      <div className="text-sm text-muted-foreground">
+                        {selectedDeleteOperation.reason || '未填写删除原因'}
+                      </div>
+                    </div>
+                    <Button
+                      size="sm"
+                      variant="outline"
+                      onClick={() => void restoreDeleteOperation(selectedDeleteOperation.operation_id)}
+                      disabled={selectedDeleteOperation.status === 'restored' || deleteRestoring}
+                    >
+                      <RotateCcw className="mr-2 h-4 w-4" />
+                      {selectedDeleteOperation.status === 'restored' ? '已恢复' : '恢复这次删除'}
+                    </Button>
+                  </div>
+
+                  <div className="grid gap-3 lg:grid-cols-4">
+                    <div className="rounded-lg border bg-background/60 p-3">
+                      <div className="text-xs text-muted-foreground">发起人</div>
+                      <div className="mt-1 text-sm">{selectedDeleteOperation.requested_by || '-'}</div>
+                    </div>
+                    <div className="rounded-lg border bg-background/60 p-3">
+                      <div className="text-xs text-muted-foreground">创建时间</div>
+                      <div className="mt-1 text-sm">{formatDeleteOperationTime(selectedDeleteOperation.created_at)}</div>
+                    </div>
+                    <div className="rounded-lg border bg-background/60 p-3">
+                      <div className="text-xs text-muted-foreground">恢复时间</div>
+                      <div className="mt-1 text-sm">{formatDeleteOperationTime(selectedDeleteOperation.restored_at)}</div>
+                    </div>
+                    <div className="rounded-lg border bg-background/60 p-3">
+                      <div className="text-xs text-muted-foreground">删除摘要</div>
+                      <div className="mt-1 flex flex-wrap gap-2">
+                        <Badge variant="outline">实体 {Number(selectedOperationCounts.entities ?? 0)}</Badge>
+                        <Badge variant="outline">关系 {Number(selectedOperationCounts.relations ?? 0)}</Badge>
+                        <Badge variant="outline">段落 {Number(selectedOperationCounts.paragraphs ?? 0)}</Badge>
+                        <Badge variant="outline">来源 {Number(selectedOperationCounts.sources ?? 0)}</Badge>
+                      </div>
+                    </div>
+                  </div>
+
+                  {selectedOperationDetailLoading ? (
+                    <div className="rounded-lg border bg-background/60 p-4 text-sm text-muted-foreground">
+                      正在加载影响对象详情...
+                    </div>
+                  ) : null}
+
+                  {selectedOperationDetailError ? (
+                    <Alert variant="destructive">
+                      <AlertDescription>{selectedOperationDetailError}</AlertDescription>
+                    </Alert>
+                  ) : null}
+
+                  {selectedOperationSources.length > 0 ? (
+                    <div className="space-y-2">
+                      <div className="text-sm font-semibold">关联来源</div>
+                      <div className="flex flex-wrap gap-2">
+                        {selectedOperationSources.map((source) => (
+                          <Badge key={source} variant="secondary" className="max-w-full break-all">
+                            {source}
+                          </Badge>
+                        ))}
+                      </div>
+                    </div>
+                  ) : null}
+
+                  <div className="grid gap-4 xl:grid-cols-[minmax(0,0.9fr)_minmax(0,1.1fr)]">
+                    <div className="space-y-2">
+                      <div className="text-sm font-semibold">选择器</div>
+                      <pre className="max-h-56 overflow-auto rounded-lg border bg-background/70 p-3 text-xs break-words whitespace-pre-wrap">
+                        {JSON.stringify(selectedDeleteOperation.selector ?? {}, null, 2)}
+                      </pre>
+                    </div>
+
+                    <div className="space-y-2">
+                      <div className="flex items-center justify-between">
+                        <div className="text-sm font-semibold">影响对象</div>
+                        <div className="text-xs text-muted-foreground">
+                          命中 {filteredSelectedOperationItems.length} / {selectedOperationItems.length} 项
+                        </div>
+                      </div>
+                      <div className="flex flex-col gap-3 lg:flex-row lg:items-center lg:justify-between">
+                        <Input
+                          value={selectedOperationItemSearch}
+                          onChange={(event) => setSelectedOperationItemSearch(event.target.value)}
+                          placeholder="搜索对象类型 / 哈希 / 对象键 / 来源"
+                          className="lg:max-w-sm"
+                        />
+                        <div className="flex items-center justify-between gap-2 text-xs text-muted-foreground lg:min-w-[180px] lg:justify-end">
+                          <span>第 {selectedOperationItemPage} / {selectedOperationItemPageCount} 页</span>
+                          <span>每页 {DELETE_OPERATION_ITEM_PAGE_SIZE} 项</span>
+                        </div>
+                      </div>
+                      <ScrollArea className="h-[280px] rounded-lg border bg-background/60">
+                        <div className="space-y-2 p-3">
+                          {pagedSelectedOperationItems.length > 0 ? pagedSelectedOperationItems.map((item) => {
+                            const source = getDeleteOperationItemSource(item)
+                            const label = getDeleteOperationItemLabel(item)
+                            const preview = getDeleteOperationItemPreview(item)
+                            return (
+                              <div key={`${item.item_type}:${item.item_hash}:${item.item_key ?? ''}`} className="rounded-lg border bg-muted/20 p-3">
+                                <div className="flex flex-wrap items-center gap-2">
+                                  <Badge variant="outline">{item.item_type}</Badge>
+                                  {source ? <Badge variant="secondary">{source}</Badge> : null}
+                                  {item.item_key && item.item_key !== item.item_hash ? (
+                                    <span className="text-xs text-muted-foreground break-all">{item.item_key}</span>
+                                  ) : null}
+                                </div>
+                                <div className="mt-2 text-sm font-medium break-words">
+                                  {label}
+                                </div>
+                                {preview ? (
+                                  <div className="mt-1 text-xs text-muted-foreground break-words">
+                                    {preview}
+                                  </div>
+                                ) : null}
+                                <div className="mt-2 font-mono text-[11px] break-all text-muted-foreground">
+                                  {item.item_hash}
+                                </div>
+                              </div>
+                            )
+                          }) : (
+                            <div className="rounded-lg border border-dashed bg-muted/20 p-6 text-center text-sm text-muted-foreground">
+                              {selectedOperationItems.length > 0 ? '当前筛选条件下没有明细项' : '当前操作没有记录明细项'}
+                            </div>
+                          )}
+                        </div>
+                      </ScrollArea>
+                      <div className="flex items-center justify-between gap-2">
+                        <Button
+                          variant="outline"
+                          size="sm"
+                          onClick={() => setSelectedOperationItemPage((current) => Math.max(1, current - 1))}
+                          disabled={selectedOperationItemPage <= 1}
+                        >
+                          上一页
+                        </Button>
+                        <div className="text-xs text-muted-foreground">
+                          支持按对象类型、哈希、对象键和来源检索
+                        </div>
+                        <Button
+                          variant="outline"
+                          size="sm"
+                          onClick={() => setSelectedOperationItemPage((current) => Math.min(selectedOperationItemPageCount, current + 1))}
+                          disabled={selectedOperationItemPage >= selectedOperationItemPageCount}
+                        >
+                          下一页
+                        </Button>
+                      </div>
+                    </div>
+                  </div>
+                </div>
+              ) : (
+                <div className="flex min-h-[320px] items-center justify-center rounded-lg border border-dashed bg-background/40 p-6 text-center text-sm text-muted-foreground">
+                  当前没有可查看的删除操作详情
+                </div>
+              )}
+            </div>
+          </CardContent>
+        </Card>
+      </div>
+    </TabsContent>
+  )
+}
diff --git a/dashboard/src/routes/resource/knowledge-base/tabs/FeedbackTab.tsx b/dashboard/src/routes/resource/knowledge-base/tabs/FeedbackTab.tsx
new file mode 100644
index 0000000000..f63c7978ee
--- /dev/null
+++ b/dashboard/src/routes/resource/knowledge-base/tabs/FeedbackTab.tsx
@@ -0,0 +1,512 @@
+import type { Dispatch, SetStateAction } from 'react'
+
+import { RotateCcw } from 'lucide-react'
+
+import { Alert, AlertDescription } from '@/components/ui/alert'
+import { Badge } from '@/components/ui/badge'
+import { Button } from '@/components/ui/button'
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+import { Input } from '@/components/ui/input'
+import { ScrollArea } from '@/components/ui/scroll-area'
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/components/ui/select'
+import { TabsContent } from '@/components/ui/tabs'
+import { cn } from '@/lib/utils'
+import type {
+  MemoryFeedbackActionLogPayload,
+  MemoryFeedbackCorrectionDetailTaskPayload,
+  MemoryFeedbackCorrectionSummaryPayload,
+} from '@/lib/memory-api'
+
+import { FEEDBACK_ACTION_LOG_PAGE_SIZE, FEEDBACK_CORRECTION_PAGE_SIZE } from '../constants'
+import {
+  buildFeedbackImpactSummary,
+  describeFeedbackActionLog,
+  formatDeleteOperationTime,
+  formatFeedbackActionType,
+  formatFeedbackDecision,
+  formatFeedbackRollbackStatus,
+  formatFeedbackTaskStatus,
+  getFeedbackCorrectionPreview,
+  getFeedbackStatusVariant,
+  summarizeFeedbackActionPayload,
+} from '../utils'
+
+export interface FeedbackTabProps {
+  feedbackSearch: string
+  setFeedbackSearch: Dispatch<SetStateAction<string>>
+  feedbackStatusFilter: string
+  setFeedbackStatusFilter: Dispatch<SetStateAction<string>>
+  feedbackRollbackFilter: string
+  setFeedbackRollbackFilter: Dispatch<SetStateAction<string>>
+  filteredFeedbackCorrections: MemoryFeedbackCorrectionSummaryPayload[]
+  feedbackCorrections: MemoryFeedbackCorrectionSummaryPayload[]
+  pagedFeedbackCorrections: MemoryFeedbackCorrectionSummaryPayload[]
+  feedbackPage: number
+  setFeedbackPage: Dispatch<SetStateAction<number>>
+  feedbackPageCount: number
+  selectedFeedbackCorrection: MemoryFeedbackCorrectionSummaryPayload | null
+  setSelectedFeedbackTaskId: Dispatch<SetStateAction<number>>
+  selectedFeedbackResolved: MemoryFeedbackCorrectionDetailTaskPayload | null
+  selectedFeedbackPreview: ReturnType<typeof getFeedbackCorrectionPreview>
+  selectedFeedbackImpactSummary: string[]
+  openFeedbackRollbackDialog: () => void
+  feedbackRollingBack: boolean
+  selectedFeedbackTaskLoading: boolean
+  selectedFeedbackTaskError: string | null
+  feedbackActionLogPage: number
+  setFeedbackActionLogPage: Dispatch<SetStateAction<number>>
+  feedbackActionLogPageCount: number
+  feedbackActionLogSearch: string
+  setFeedbackActionLogSearch: Dispatch<SetStateAction<string>>
+  pagedFeedbackActionLogs: MemoryFeedbackActionLogPayload[]
+  selectedFeedbackActionLogs: MemoryFeedbackActionLogPayload[]
+}
+
+export function FeedbackTab(props: FeedbackTabProps) {
+  const {
+    feedbackSearch,
+    setFeedbackSearch,
+    feedbackStatusFilter,
+    setFeedbackStatusFilter,
+    feedbackRollbackFilter,
+    setFeedbackRollbackFilter,
+    filteredFeedbackCorrections,
+    feedbackCorrections,
+    pagedFeedbackCorrections,
+    feedbackPage,
+    setFeedbackPage,
+    feedbackPageCount,
+    selectedFeedbackCorrection,
+    setSelectedFeedbackTaskId,
+    selectedFeedbackResolved,
+    selectedFeedbackPreview,
+    selectedFeedbackImpactSummary,
+    openFeedbackRollbackDialog,
+    feedbackRollingBack,
+    selectedFeedbackTaskLoading,
+    selectedFeedbackTaskError,
+    feedbackActionLogPage,
+    setFeedbackActionLogPage,
+    feedbackActionLogPageCount,
+    feedbackActionLogSearch,
+    setFeedbackActionLogSearch,
+    pagedFeedbackActionLogs,
+    selectedFeedbackActionLogs,
+  } = props
+
+  return (
+    <TabsContent value="feedback" className="space-y-4">
+      <div className="space-y-4">
+        <Card>
+          <CardHeader>
+            <CardTitle className="flex items-center gap-2">
+              <RotateCcw className="h-4 w-4" />
+              反馈纠错历史
+            </CardTitle>
+            <CardDescription>
+              查看 feedback correction 的判定、修改轨迹与回退结果；本期仅覆盖自动纠错任务
+            </CardDescription>
+          </CardHeader>
+          <CardContent className="space-y-4">
+            <div className="grid gap-3 lg:grid-cols-[minmax(0,1fr)_180px_180px]">
+              <Input
+                value={feedbackSearch}
+                onChange={(event) => setFeedbackSearch(event.target.value)}
+                placeholder="搜索查询编号 / 会话 / 查询内容 / 原因"
+              />
+              <Select value={feedbackStatusFilter} onValueChange={setFeedbackStatusFilter}>
+                <SelectTrigger>
+                  <SelectValue placeholder="按任务状态筛选" />
+                </SelectTrigger>
+                <SelectContent>
+                  <SelectItem value="all">全部任务状态</SelectItem>
+                  <SelectItem value="applied">已应用</SelectItem>
+                  <SelectItem value="skipped">已跳过</SelectItem>
+                  <SelectItem value="error">失败</SelectItem>
+                  <SelectItem value="running">处理中</SelectItem>
+                  <SelectItem value="pending">待处理</SelectItem>
+                </SelectContent>
+              </Select>
+              <Select value={feedbackRollbackFilter} onValueChange={setFeedbackRollbackFilter}>
+                <SelectTrigger>
+                  <SelectValue placeholder="按回退状态筛选" />
+                </SelectTrigger>
+                <SelectContent>
+                  <SelectItem value="all">全部回退状态</SelectItem>
+                  <SelectItem value="none">未回退</SelectItem>
+                  <SelectItem value="rolled_back">已回退</SelectItem>
+                  <SelectItem value="error">回退失败</SelectItem>
+                  <SelectItem value="running">回退中</SelectItem>
+                </SelectContent>
+              </Select>
+            </div>
+
+            <div className="flex flex-wrap items-center justify-between gap-2 rounded-xl border bg-background/70 px-3 py-2 text-sm text-muted-foreground">
+              <span>当前命中 {filteredFeedbackCorrections.length} 条记录，已加载最近 {feedbackCorrections.length} 条</span>
+              <span>第 {feedbackPage} / {feedbackPageCount} 页，每页显示 {FEEDBACK_CORRECTION_PAGE_SIZE} 条</span>
+            </div>
+
+            <div className="grid items-start gap-4 xl:grid-cols-[minmax(0,0.92fr)_minmax(0,1.08fr)]">
+              <ScrollArea className="h-[720px] rounded-lg border">
+                <div className="space-y-3 p-3">
+                  {pagedFeedbackCorrections.length > 0 ? pagedFeedbackCorrections.map((item) => {
+                    const isSelected = selectedFeedbackCorrection?.task_id === item.task_id
+                    const preview = getFeedbackCorrectionPreview(item)
+                    const impactSummary = buildFeedbackImpactSummary(item)
+                    return (
+                      <button
+                        key={item.task_id}
+                        type="button"
+                        onClick={() => setSelectedFeedbackTaskId(item.task_id)}
+                        className={cn(
+                          'w-full rounded-xl border p-4 text-left transition-colors',
+                          isSelected
+                            ? 'border-primary bg-primary/5 shadow-sm'
+                            : 'bg-muted/20 hover:border-primary/40 hover:bg-muted/40',
+                        )}
+                      >
+                        <div className="flex flex-col gap-3">
+                          <div className="flex flex-wrap items-start justify-between gap-2">
+                            <div className="flex flex-wrap items-center gap-2">
+                              <Badge variant={getFeedbackStatusVariant(item.task_status)}>
+                                {formatFeedbackTaskStatus(item.task_status)}
+                              </Badge>
+                              <Badge variant={getFeedbackStatusVariant(item.rollback_status)}>
+                                {formatFeedbackRollbackStatus(item.rollback_status)}
+                              </Badge>
+                              <Badge variant="outline">
+                                {formatFeedbackDecision(item.decision)}
+                              </Badge>
+                            </div>
+                            <div className="text-[11px] text-muted-foreground">
+                              {formatDeleteOperationTime(item.query_timestamp ?? item.created_at)}
+                            </div>
+                          </div>
+                          <div className="space-y-1">
+                            <div className="text-sm font-semibold break-words">
+                              {preview.headline}
+                            </div>
+                            <div className="text-xs text-muted-foreground break-words">
+                              查询：{item.query_text || '无查询文本'}
+                            </div>
+                          </div>
+                          {(preview.oldRelation || preview.newRelation) ? (
+                            <div className="grid gap-2 rounded-lg border bg-background/70 p-3 text-xs shadow-sm">
+                              <div className="grid gap-2 sm:grid-cols-[minmax(0,1fr)_auto_minmax(0,1fr)] sm:items-stretch">
+                                <div className="rounded-md border border-amber-500/20 bg-amber-500/5 p-2">
+                                  <div className="text-[11px] font-medium text-amber-700 dark:text-amber-300">纠错前</div>
+                                  <div className="mt-1 break-words">{preview.oldRelation || '无'}</div>
+                                </div>
+                                <div className="hidden items-center text-muted-foreground sm:flex">→</div>
+                                <div className="rounded-md border border-emerald-500/20 bg-emerald-500/5 p-2">
+                                  <div className="text-[11px] font-medium text-emerald-700 dark:text-emerald-300">纠错后</div>
+                                  <div className="mt-1 break-words">{preview.newRelation || '无'}</div>
+                                </div>
+                              </div>
+                            </div>
+                          ) : null}
+                          <div className="flex flex-wrap gap-2">
+                            {impactSummary.length > 0 ? impactSummary.slice(0, 3).map((summary) => (
+                              <Badge key={`${item.task_id}:${summary}`} variant="secondary" className="font-normal">
+                                {summary}
+                              </Badge>
+                            )) : (
+                              <Badge variant="secondary" className="font-normal">
+                                暂无影响摘要
+                              </Badge>
+                            )}
+                          </div>
+                          <div className="font-mono text-[11px] break-all text-muted-foreground">
+                            {item.query_tool_id}
+                          </div>
+                        </div>
+                      </button>
+                    )
+                  }) : (
+                    <div className="rounded-lg border border-dashed bg-muted/20 p-6 text-center text-sm text-muted-foreground">
+                      当前筛选条件下没有纠错历史
+                    </div>
+                  )}
+                </div>
+              </ScrollArea>
+
+              <div className="self-start rounded-xl border bg-muted/20 p-4">
+                {selectedFeedbackCorrection ? (
+                  <div className="space-y-4">
+                    <div className="flex flex-col gap-3 lg:flex-row lg:items-start lg:justify-between">
+                      <div className="space-y-2">
+                        <div className="flex flex-wrap items-center gap-2">
+                          <Badge variant={getFeedbackStatusVariant(String(selectedFeedbackResolved?.task_status ?? ''))}>
+                            {formatFeedbackTaskStatus(String(selectedFeedbackResolved?.task_status ?? ''))}
+                          </Badge>
+                          <Badge variant={getFeedbackStatusVariant(String(selectedFeedbackResolved?.rollback_status ?? 'none'))}>
+                            {formatFeedbackRollbackStatus(String(selectedFeedbackResolved?.rollback_status ?? 'none'))}
+                          </Badge>
+                          <Badge variant="outline">
+                            {formatFeedbackDecision(String(selectedFeedbackResolved?.decision ?? ''))}
+                          </Badge>
+                        </div>
+                        <div className="text-base font-semibold break-words">
+                          {selectedFeedbackPreview.headline}
+                        </div>
+                        <div className="text-sm text-muted-foreground break-words">
+                          查询：{selectedFeedbackResolved?.query_text || '无查询文本'}
+                        </div>
+                        <div className="font-mono text-xs break-all text-muted-foreground">
+                          {selectedFeedbackResolved?.query_tool_id}
+                        </div>
+                      </div>
+                      <Button
+                        size="sm"
+                        variant="outline"
+                        onClick={openFeedbackRollbackDialog}
+                        disabled={
+                          String(selectedFeedbackResolved?.task_status ?? '') !== 'applied'
+                          || String(selectedFeedbackResolved?.rollback_status ?? 'none') === 'rolled_back'
+                          || feedbackRollingBack
+                        }
+                      >
+                        <RotateCcw className="mr-2 h-4 w-4" />
+                        {String(selectedFeedbackResolved?.rollback_status ?? 'none') === 'rolled_back'
+                          ? '已回退'
+                          : '回退本次纠错'}
+                      </Button>
+                    </div>
+
+                    <div className="grid gap-4 xl:grid-cols-[minmax(0,1.05fr)_minmax(0,0.95fr)]">
+                      <div className="rounded-xl border bg-background/70 p-4 shadow-sm">
+                        <div className="text-sm font-semibold">本次纠错结论</div>
+                        <div className="mt-3 grid gap-3 md:grid-cols-[minmax(0,1fr)_auto_minmax(0,1fr)] md:items-stretch">
+                          <div className="rounded-lg border border-amber-500/20 bg-amber-500/5 p-3">
+                            <div className="text-xs font-medium text-amber-700 dark:text-amber-300">纠错前</div>
+                            <div className="mt-2 text-sm break-words">
+                              {selectedFeedbackPreview.oldRelation || '当前详情没有记录旧结论'}
+                            </div>
+                          </div>
+                          <div className="hidden items-center justify-center text-muted-foreground md:flex">→</div>
+                          <div className="rounded-lg border border-emerald-500/20 bg-emerald-500/5 p-3">
+                            <div className="text-xs font-medium text-emerald-700 dark:text-emerald-300">纠错后</div>
+                            <div className="mt-2 text-sm break-words">
+                              {selectedFeedbackPreview.newRelation || '当前详情没有记录新结论'}
+                            </div>
+                          </div>
+                        </div>
+                      </div>
+
+                      <div className="rounded-xl border bg-background/70 p-4 shadow-sm">
+                        <div className="text-sm font-semibold">影响范围摘要</div>
+                        <div className="mt-3 flex flex-wrap gap-2">
+                          {selectedFeedbackImpactSummary.length > 0 ? selectedFeedbackImpactSummary.map((summary) => (
+                            <Badge key={summary} variant="secondary" className="bg-primary/10 font-normal text-primary hover:bg-primary/15">
+                              {summary}
+                            </Badge>
+                          )) : (
+                            <div className="text-sm text-muted-foreground">当前没有可展示的影响范围摘要</div>
+                          )}
+                        </div>
+                      </div>
+                    </div>
+
+                    <div className="grid gap-3 lg:grid-cols-4">
+                      <div className="rounded-lg border bg-background/60 p-3">
+                        <div className="text-xs text-muted-foreground">会话</div>
+                        <div className="mt-1 text-sm break-all">{selectedFeedbackResolved?.session_id || '-'}</div>
+                      </div>
+                      <div className="rounded-lg border bg-background/60 p-3">
+                        <div className="text-xs text-muted-foreground">反馈消息数</div>
+                        <div className="mt-1 text-sm">{Number(selectedFeedbackResolved?.feedback_message_count ?? 0)}</div>
+                      </div>
+                      <div className="rounded-lg border bg-background/60 p-3">
+                        <div className="text-xs text-muted-foreground">判定置信度</div>
+                        <div className="mt-1 text-sm">{Number(selectedFeedbackResolved?.decision_confidence ?? 0).toFixed(2)}</div>
+                      </div>
+                      <div className="rounded-lg border bg-background/60 p-3">
+                        <div className="text-xs text-muted-foreground">回退时间</div>
+                        <div className="mt-1 text-sm">{formatDeleteOperationTime(selectedFeedbackResolved?.rolled_back_at)}</div>
+                      </div>
+                    </div>
+
+                    {selectedFeedbackTaskLoading ? (
+                      <div className="rounded-lg border bg-background/60 p-4 text-sm text-muted-foreground">
+                        正在加载纠错详情...
+                      </div>
+                    ) : null}
+
+                    {selectedFeedbackTaskError ? (
+                      <Alert variant="destructive">
+                        <AlertDescription>{selectedFeedbackTaskError}</AlertDescription>
+                      </Alert>
+                    ) : null}
+
+                    {selectedFeedbackResolved?.rollback_error ? (
+                      <Alert variant="destructive">
+                        <AlertDescription>{selectedFeedbackResolved.rollback_error}</AlertDescription>
+                      </Alert>
+                    ) : null}
+
+                    <div className="grid gap-4 xl:grid-cols-[minmax(0,1.05fr)_minmax(0,0.95fr)]">
+                      <div className="rounded-xl border bg-background/70 p-4">
+                        <div className="text-sm font-semibold">回退后会发生什么</div>
+                        <div className="mt-3 space-y-2 text-sm text-muted-foreground">
+                          <div>会恢复旧关系状态，并撤销本次纠错写入的段落与关系。</div>
+                          <div>会清理旧段落的待复核标记，并重新触发相关 Episode / Profile 修复。</div>
+                          <div>如果你当前只是核对结果，可以先查看下面的详细数据，不必立刻执行回退。</div>
+                        </div>
+                      </div>
+                      <div className="rounded-xl border bg-background/70 p-4">
+                        <div className="text-sm font-semibold">处理摘要</div>
+                        <div className="mt-3 grid gap-2 text-sm text-muted-foreground">
+                          <div>判定：{formatFeedbackDecision(String(selectedFeedbackResolved?.decision ?? ''))}</div>
+                          <div>任务状态：{formatFeedbackTaskStatus(String(selectedFeedbackResolved?.task_status ?? ''))}</div>
+                          <div>回退状态：{formatFeedbackRollbackStatus(String(selectedFeedbackResolved?.rollback_status ?? 'none'))}</div>
+                          <div>反馈消息数：{Number(selectedFeedbackResolved?.feedback_message_count ?? 0)}</div>
+                        </div>
+                      </div>
+                    </div>
+
+                    <div className="space-y-3">
+                      <div className="text-sm font-semibold">详细数据</div>
+                      <div className="grid gap-3 xl:grid-cols-2">
+                        <details className="rounded-lg border bg-background/70 p-3">
+                          <summary className="cursor-pointer text-sm font-medium">查询快照 JSON</summary>
+                          <pre className="mt-3 max-h-56 overflow-auto text-xs break-words whitespace-pre-wrap">
+                            {JSON.stringify(selectedFeedbackResolved?.query_snapshot ?? {}, null, 2)}
+                          </pre>
+                        </details>
+                        <details className="rounded-lg border bg-background/70 p-3">
+                          <summary className="cursor-pointer text-sm font-medium">判定结果 JSON</summary>
+                          <pre className="mt-3 max-h-56 overflow-auto text-xs break-words whitespace-pre-wrap">
+                            {JSON.stringify(selectedFeedbackResolved?.decision_payload ?? {}, null, 2)}
+                          </pre>
+                        </details>
+                        <details className="rounded-lg border bg-background/70 p-3">
+                          <summary className="cursor-pointer text-sm font-medium">回退计划摘要 JSON</summary>
+                          <pre className="mt-3 max-h-64 overflow-auto text-xs break-words whitespace-pre-wrap">
+                            {JSON.stringify(selectedFeedbackResolved?.rollback_plan_summary ?? {}, null, 2)}
+                          </pre>
+                        </details>
+                        <details className="rounded-lg border bg-background/70 p-3">
+                          <summary className="cursor-pointer text-sm font-medium">回退结果 JSON</summary>
+                          <pre className="mt-3 max-h-64 overflow-auto text-xs break-words whitespace-pre-wrap">
+                            {JSON.stringify(selectedFeedbackResolved?.rollback_result ?? {}, null, 2)}
+                          </pre>
+                        </details>
+                      </div>
+                    </div>
+
+                    <details className="rounded-xl border bg-background/70 p-4">
+                      <summary className="cursor-pointer text-sm font-semibold">
+                        动作时间线
+                      </summary>
+                      <div className="mt-4 space-y-2">
+                        <div className="flex flex-col gap-3 lg:flex-row lg:items-center lg:justify-between">
+                          <div className="text-xs text-muted-foreground">
+                            第 {feedbackActionLogPage} / {feedbackActionLogPageCount} 页，每页 {FEEDBACK_ACTION_LOG_PAGE_SIZE} 项
+                          </div>
+                          <Input
+                            value={feedbackActionLogSearch}
+                            onChange={(event) => setFeedbackActionLogSearch(event.target.value)}
+                            placeholder="搜索动作 / 目标哈希 / 预览内容"
+                            className="lg:w-80"
+                          />
+                        </div>
+                        <ScrollArea className="h-[240px] rounded-lg border bg-background/60">
+                          <div className="space-y-2 p-3">
+                            {pagedFeedbackActionLogs.length > 0 ? pagedFeedbackActionLogs.map((item: MemoryFeedbackActionLogPayload) => (
+                              <div key={`${item.id}:${item.action_type}`} className="rounded-lg border bg-muted/20 p-3">
+                                <div className="flex flex-wrap items-center justify-between gap-2">
+                                  <div className="flex flex-wrap items-center gap-2">
+                                    <Badge variant="outline">{formatFeedbackActionType(item.action_type)}</Badge>
+                                    {item.target_hash ? (
+                                      <span className="font-mono text-[11px] break-all text-muted-foreground">{item.target_hash}</span>
+                                    ) : null}
+                                  </div>
+                                  <div className="text-[11px] text-muted-foreground">
+                                    {formatDeleteOperationTime(item.created_at)}
+                                  </div>
+                                </div>
+                                <div className="mt-2 text-sm break-words">
+                                  {describeFeedbackActionLog(item)}
+                                </div>
+                                {item.reason ? (
+                                  <div className="mt-2 text-xs text-muted-foreground break-words">
+                                    原因：{item.reason}
+                                  </div>
+                                ) : null}
+                                {item.before_payload && Object.keys(item.before_payload).length > 0 ? (
+                                  <div className="mt-3 rounded-md border bg-background/70 p-2 text-xs break-words">
+                                    <span className="font-medium">处理前：</span>
+                                    <span className="text-muted-foreground">{summarizeFeedbackActionPayload(item.before_payload)}</span>
+                                  </div>
+                                ) : null}
+                                {item.after_payload && Object.keys(item.after_payload).length > 0 ? (
+                                  <div className="mt-2 rounded-md border bg-background/70 p-2 text-xs break-words">
+                                    <span className="font-medium">处理后：</span>
+                                    <span className="text-muted-foreground">{summarizeFeedbackActionPayload(item.after_payload)}</span>
+                                  </div>
+                                ) : null}
+                              </div>
+                            )) : (
+                              <div className="rounded-lg border border-dashed bg-muted/20 p-6 text-center text-sm text-muted-foreground">
+                                {selectedFeedbackActionLogs.length > 0 ? '当前筛选条件下没有动作日志' : '当前任务没有动作日志'}
+                              </div>
+                            )}
+                          </div>
+                        </ScrollArea>
+                        <div className="flex items-center justify-between gap-2">
+                          <Button
+                            variant="outline"
+                            size="sm"
+                            onClick={() => setFeedbackActionLogPage((current) => Math.max(1, current - 1))}
+                            disabled={feedbackActionLogPage <= 1}
+                          >
+                            上一页
+                          </Button>
+                          <div className="text-xs text-muted-foreground">支持按动作类型、目标哈希和摘要检索</div>
+                          <Button
+                            variant="outline"
+                            size="sm"
+                            onClick={() => setFeedbackActionLogPage((current) => Math.min(feedbackActionLogPageCount, current + 1))}
+                            disabled={feedbackActionLogPage >= feedbackActionLogPageCount}
+                          >
+                            下一页
+                          </Button>
+                        </div>
+                      </div>
+                    </details>
+                  </div>
+                ) : (
+                  <div className="flex min-h-[360px] items-center justify-center rounded-lg border border-dashed bg-background/40 p-6 text-center text-sm text-muted-foreground">
+                    当前没有可查看的纠错详情
+                  </div>
+                )}
+              </div>
+            </div>
+
+            <div className="flex items-center justify-between gap-2">
+              <Button
+                variant="outline"
+                size="sm"
+                onClick={() => setFeedbackPage((current) => Math.max(1, current - 1))}
+                disabled={feedbackPage <= 1}
+              >
+                上一页
+              </Button>
+              <div className="text-xs text-muted-foreground">
+                支持按查询内容、任务状态和回退状态检索
+              </div>
+              <Button
+                variant="outline"
+                size="sm"
+                onClick={() => setFeedbackPage((current) => Math.min(feedbackPageCount, current + 1))}
+                disabled={feedbackPage >= feedbackPageCount}
+              >
+                下一页
+              </Button>
+            </div>
+          </CardContent>
+        </Card>
+      </div>
+    </TabsContent>
+  )
+}
diff --git a/dashboard/src/routes/resource/knowledge-base/tabs/ImportTab.tsx b/dashboard/src/routes/resource/knowledge-base/tabs/ImportTab.tsx
new file mode 100644
index 0000000000..c284c8f81e
--- /dev/null
+++ b/dashboard/src/routes/resource/knowledge-base/tabs/ImportTab.tsx
@@ -0,0 +1,1270 @@
+import type { Dispatch, SetStateAction } from 'react'
+
+import { ChevronLeft, ChevronRight, Loader2, RefreshCw, Upload } from 'lucide-react'
+
+import { MemoryMiniTabs } from '@/components/memory/MemoryMiniTabs'
+import { MemoryProgressIndicator } from '@/components/memory/MemoryProgressIndicator'
+import { Alert, AlertDescription } from '@/components/ui/alert'
+import { Badge } from '@/components/ui/badge'
+import { Button } from '@/components/ui/button'
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+import { Checkbox } from '@/components/ui/checkbox'
+import { Input } from '@/components/ui/input'
+import { Label } from '@/components/ui/label'
+import { Progress } from '@/components/ui/progress'
+import { ScrollArea } from '@/components/ui/scroll-area'
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/components/ui/select'
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@/components/ui/table'
+import { Tabs, TabsContent } from '@/components/ui/tabs'
+import { Textarea } from '@/components/ui/textarea'
+import { cn } from '@/lib/utils'
+import type {
+  MemoryImportChunkPayload,
+  MemoryImportFilePayload,
+  MemoryImportInputMode,
+  MemoryImportRetrySummary,
+  MemoryImportSettings,
+  MemoryImportTaskKind,
+  MemoryImportTaskPayload,
+} from '@/lib/memory-api'
+
+import { IMPORT_CHUNK_PAGE_SIZE, IMPORT_KIND_OPTIONS, RUNNING_IMPORT_STATUS } from '../constants'
+import {
+  formatImportTime,
+  getImportStatusLabel,
+  getImportStatusVariant,
+  getImportStepLabel,
+  normalizeImportInputMode,
+  normalizeProgress,
+} from '../utils'
+
+export interface ImportTabProps {
+  importCreateMode: MemoryImportTaskKind
+  setImportCreateMode: Dispatch<SetStateAction<MemoryImportTaskKind>>
+  importSettings: MemoryImportSettings
+  importCommonFileConcurrency: string
+  setImportCommonFileConcurrency: Dispatch<SetStateAction<string>>
+  importCommonChunkConcurrency: string
+  setImportCommonChunkConcurrency: Dispatch<SetStateAction<string>>
+  importCommonLlmEnabled: boolean
+  setImportCommonLlmEnabled: Dispatch<SetStateAction<boolean>>
+  importCommonChatLog: boolean
+  setImportCommonChatLog: Dispatch<SetStateAction<boolean>>
+  importCommonStrategyOverride: string
+  setImportCommonStrategyOverride: Dispatch<SetStateAction<string>>
+  importCommonDedupePolicy: string
+  setImportCommonDedupePolicy: Dispatch<SetStateAction<string>>
+  importCommonChatReferenceTime: string
+  setImportCommonChatReferenceTime: Dispatch<SetStateAction<string>>
+  importCommonForce: boolean
+  setImportCommonForce: Dispatch<SetStateAction<boolean>>
+  importCommonClearManifest: boolean
+  setImportCommonClearManifest: Dispatch<SetStateAction<boolean>>
+
+  uploadInputMode: MemoryImportInputMode
+  setUploadInputMode: Dispatch<SetStateAction<MemoryImportInputMode>>
+  uploadFiles: File[]
+  setUploadFiles: Dispatch<SetStateAction<File[]>>
+
+  pasteName: string
+  setPasteName: Dispatch<SetStateAction<string>>
+  pasteMode: MemoryImportInputMode
+  setPasteMode: Dispatch<SetStateAction<MemoryImportInputMode>>
+  pasteContent: string
+  setPasteContent: Dispatch<SetStateAction<string>>
+
+  rawAlias: string
+  setRawAlias: Dispatch<SetStateAction<string>>
+  rawInputMode: MemoryImportInputMode
+  setRawInputMode: Dispatch<SetStateAction<MemoryImportInputMode>>
+  rawRelativePath: string
+  setRawRelativePath: Dispatch<SetStateAction<string>>
+  rawGlob: string
+  setRawGlob: Dispatch<SetStateAction<string>>
+  rawRecursive: boolean
+  setRawRecursive: Dispatch<SetStateAction<boolean>>
+
+  openieAlias: string
+  setOpenieAlias: Dispatch<SetStateAction<string>>
+  openieRelativePath: string
+  setOpenieRelativePath: Dispatch<SetStateAction<string>>
+  openieIncludeAllJson: boolean
+  setOpenieIncludeAllJson: Dispatch<SetStateAction<boolean>>
+
+  convertAlias: string
+  setConvertAlias: Dispatch<SetStateAction<string>>
+  convertTargetAlias: string
+  setConvertTargetAlias: Dispatch<SetStateAction<string>>
+  convertRelativePath: string
+  setConvertRelativePath: Dispatch<SetStateAction<string>>
+  convertTargetRelativePath: string
+  setConvertTargetRelativePath: Dispatch<SetStateAction<string>>
+  convertDimension: string
+  setConvertDimension: Dispatch<SetStateAction<string>>
+  convertBatchSize: string
+  setConvertBatchSize: Dispatch<SetStateAction<string>>
+
+  backfillAlias: string
+  setBackfillAlias: Dispatch<SetStateAction<string>>
+  backfillLimit: string
+  setBackfillLimit: Dispatch<SetStateAction<string>>
+  backfillRelativePath: string
+  setBackfillRelativePath: Dispatch<SetStateAction<string>>
+  backfillDryRun: boolean
+  setBackfillDryRun: Dispatch<SetStateAction<boolean>>
+  backfillNoCreatedFallback: boolean
+  setBackfillNoCreatedFallback: Dispatch<SetStateAction<boolean>>
+
+  maibotSourceDb: string
+  setMaibotSourceDb: Dispatch<SetStateAction<string>>
+  maibotTimeFrom: string
+  setMaibotTimeFrom: Dispatch<SetStateAction<string>>
+  maibotTimeTo: string
+  setMaibotTimeTo: Dispatch<SetStateAction<string>>
+  maibotStartId: string
+  setMaibotStartId: Dispatch<SetStateAction<string>>
+  maibotEndId: string
+  setMaibotEndId: Dispatch<SetStateAction<string>>
+  maibotStreamIds: string
+  setMaibotStreamIds: Dispatch<SetStateAction<string>>
+  maibotGroupIds: string
+  setMaibotGroupIds: Dispatch<SetStateAction<string>>
+  maibotUserIds: string
+  setMaibotUserIds: Dispatch<SetStateAction<string>>
+  maibotReadBatchSize: string
+  setMaibotReadBatchSize: Dispatch<SetStateAction<string>>
+  maibotCommitWindowRows: string
+  setMaibotCommitWindowRows: Dispatch<SetStateAction<string>>
+  maibotEmbedWorkers: string
+  setMaibotEmbedWorkers: Dispatch<SetStateAction<string>>
+  maibotNoResume: boolean
+  setMaibotNoResume: Dispatch<SetStateAction<boolean>>
+  maibotResetState: boolean
+  setMaibotResetState: Dispatch<SetStateAction<boolean>>
+  maibotDryRun: boolean
+  setMaibotDryRun: Dispatch<SetStateAction<boolean>>
+  maibotVerifyOnly: boolean
+  setMaibotVerifyOnly: Dispatch<SetStateAction<boolean>>
+
+  submitImportByMode: () => Promise<void>
+  creatingImport: boolean
+
+  pathResolveAlias: string
+  setPathResolveAlias: Dispatch<SetStateAction<string>>
+  importAliasKeys: string[]
+  pathResolveRelativePath: string
+  setPathResolveRelativePath: Dispatch<SetStateAction<string>>
+  pathResolveMustExist: boolean
+  setPathResolveMustExist: Dispatch<SetStateAction<boolean>>
+  resolveImportPath: () => Promise<void>
+  resolvingPath: boolean
+  pathResolveOutput: string
+
+  refreshImportQueue: () => Promise<void>
+  runningImportTasks: MemoryImportTaskPayload[]
+  queuedImportTasks: MemoryImportTaskPayload[]
+  recentImportTasks: MemoryImportTaskPayload[]
+  selectedImportTaskId: string
+  selectImportTask: (taskId: string) => Promise<void>
+  importAutoPolling: boolean
+  setImportAutoPolling: Dispatch<SetStateAction<boolean>>
+  importPollInterval: number
+  importErrorText: string
+
+  cancelSelectedImportTask: () => Promise<void>
+  retrySelectedImportTask: () => Promise<void>
+  selectedImportTaskLoading: boolean
+  selectedImportTaskResolved: MemoryImportTaskPayload | null | undefined
+  selectedImportRetrySummary: MemoryImportRetrySummary | null | undefined
+  selectedImportTaskErrorText: string
+
+  selectedImportFiles: MemoryImportFilePayload[]
+  selectedImportFileId: string
+  selectImportFile: (fileId: string) => Promise<void>
+
+  importChunkTotal: number
+  importChunkOffset: number
+  moveImportChunkPage: (direction: -1 | 1) => Promise<void>
+  canImportChunkPrev: boolean
+  canImportChunkNext: boolean
+  importChunksLoading: boolean
+  selectedImportChunks: MemoryImportChunkPayload[]
+}
+
+export function ImportTab(props: ImportTabProps) {
+  const {
+    importCreateMode,
+    setImportCreateMode,
+    importSettings,
+    importCommonFileConcurrency,
+    setImportCommonFileConcurrency,
+    importCommonChunkConcurrency,
+    setImportCommonChunkConcurrency,
+    importCommonLlmEnabled,
+    setImportCommonLlmEnabled,
+    importCommonChatLog,
+    setImportCommonChatLog,
+    importCommonStrategyOverride,
+    setImportCommonStrategyOverride,
+    importCommonDedupePolicy,
+    setImportCommonDedupePolicy,
+    importCommonChatReferenceTime,
+    setImportCommonChatReferenceTime,
+    importCommonForce,
+    setImportCommonForce,
+    importCommonClearManifest,
+    setImportCommonClearManifest,
+    uploadInputMode,
+    setUploadInputMode,
+    uploadFiles,
+    setUploadFiles,
+    pasteName,
+    setPasteName,
+    pasteMode,
+    setPasteMode,
+    pasteContent,
+    setPasteContent,
+    rawAlias,
+    setRawAlias,
+    rawInputMode,
+    setRawInputMode,
+    rawRelativePath,
+    setRawRelativePath,
+    rawGlob,
+    setRawGlob,
+    rawRecursive,
+    setRawRecursive,
+    openieAlias,
+    setOpenieAlias,
+    openieRelativePath,
+    setOpenieRelativePath,
+    openieIncludeAllJson,
+    setOpenieIncludeAllJson,
+    convertAlias,
+    setConvertAlias,
+    convertTargetAlias,
+    setConvertTargetAlias,
+    convertRelativePath,
+    setConvertRelativePath,
+    convertTargetRelativePath,
+    setConvertTargetRelativePath,
+    convertDimension,
+    setConvertDimension,
+    convertBatchSize,
+    setConvertBatchSize,
+    backfillAlias,
+    setBackfillAlias,
+    backfillLimit,
+    setBackfillLimit,
+    backfillRelativePath,
+    setBackfillRelativePath,
+    backfillDryRun,
+    setBackfillDryRun,
+    backfillNoCreatedFallback,
+    setBackfillNoCreatedFallback,
+    maibotSourceDb,
+    setMaibotSourceDb,
+    maibotTimeFrom,
+    setMaibotTimeFrom,
+    maibotTimeTo,
+    setMaibotTimeTo,
+    maibotStartId,
+    setMaibotStartId,
+    maibotEndId,
+    setMaibotEndId,
+    maibotStreamIds,
+    setMaibotStreamIds,
+    maibotGroupIds,
+    setMaibotGroupIds,
+    maibotUserIds,
+    setMaibotUserIds,
+    maibotReadBatchSize,
+    setMaibotReadBatchSize,
+    maibotCommitWindowRows,
+    setMaibotCommitWindowRows,
+    maibotEmbedWorkers,
+    setMaibotEmbedWorkers,
+    maibotNoResume,
+    setMaibotNoResume,
+    maibotResetState,
+    setMaibotResetState,
+    maibotDryRun,
+    setMaibotDryRun,
+    maibotVerifyOnly,
+    setMaibotVerifyOnly,
+    submitImportByMode,
+    creatingImport,
+    pathResolveAlias,
+    setPathResolveAlias,
+    importAliasKeys,
+    pathResolveRelativePath,
+    setPathResolveRelativePath,
+    pathResolveMustExist,
+    setPathResolveMustExist,
+    resolveImportPath,
+    resolvingPath,
+    pathResolveOutput,
+    refreshImportQueue,
+    runningImportTasks,
+    queuedImportTasks,
+    recentImportTasks,
+    selectedImportTaskId,
+    selectImportTask,
+    importAutoPolling,
+    setImportAutoPolling,
+    importPollInterval,
+    importErrorText,
+    cancelSelectedImportTask,
+    retrySelectedImportTask,
+    selectedImportTaskLoading,
+    selectedImportTaskResolved,
+    selectedImportRetrySummary,
+    selectedImportTaskErrorText,
+    selectedImportFiles,
+    selectedImportFileId,
+    selectImportFile,
+    importChunkTotal,
+    importChunkOffset,
+    moveImportChunkPage,
+    canImportChunkPrev,
+    canImportChunkNext,
+    importChunksLoading,
+    selectedImportChunks,
+  } = props
+
+  return (
+    <TabsContent
+      value="import"
+      className="space-y-6 [&_input]:h-10 [&_[role=combobox]]:h-10 [&_textarea]:min-h-[96px]"
+    >
+      <div className="grid gap-6 lg:grid-cols-[minmax(0,1fr)_minmax(0,1fr)]">
+        <div className="order-2 space-y-6 lg:order-1">
+          <Card className="rounded-2xl border-border/70 shadow-sm">
+            <CardHeader>
+              <CardTitle className="flex items-center gap-2">
+                <Upload className="h-4 w-4" />
+                创建导入任务
+              </CardTitle>
+              <CardDescription>按“选择导入方式 → 检查公共参数 → 创建任务”的顺序完成导入。</CardDescription>
+            </CardHeader>
+            <CardContent className="space-y-6">
+              <Tabs
+                value={importCreateMode}
+                onValueChange={(value) => setImportCreateMode(value as MemoryImportTaskKind)}
+                className="space-y-4"
+              >
+                <div className="space-y-2">
+                  <Label>选择导入方式</Label>
+                  <MemoryMiniTabs items={IMPORT_KIND_OPTIONS} />
+                </div>
+
+                <div className="space-y-4 rounded-lg border bg-muted/30 p-4">
+                <div className="space-y-1">
+                  <div className="text-sm font-medium">公共参数</div>
+                  <div className="text-xs text-muted-foreground">这些设置会应用到当前导入任务。一般保持默认即可，只在批量导入或排查问题时调整。</div>
+                </div>
+                <div className="grid gap-3 md:grid-cols-2">
+                  <div className="space-y-1">
+                    <Label>文件并发数</Label>
+                    <div className="text-xs text-muted-foreground">同时处理多少个文件；文件很多时再适当调高。</div>
+                    <Input
+                      type="number"
+                      min={1}
+                      max={Number(importSettings.max_file_concurrency ?? 128)}
+                      value={importCommonFileConcurrency}
+                      onChange={(event) => setImportCommonFileConcurrency(event.target.value)}
+                    />
+                  </div>
+                  <div className="space-y-1">
+                    <Label>分块并发数</Label>
+                    <div className="text-xs text-muted-foreground">单个文件内并行处理多少个分块；过高会增加资源占用。</div>
+                    <Input
+                      type="number"
+                      min={1}
+                      max={Number(importSettings.max_chunk_concurrency ?? 256)}
+                      value={importCommonChunkConcurrency}
+                      onChange={(event) => setImportCommonChunkConcurrency(event.target.value)}
+                    />
+                  </div>
+                  <div className="rounded-md border bg-background/70 p-3">
+                    <div className="flex items-center gap-2 text-sm">
+                      <Checkbox
+                        checked={importCommonLlmEnabled}
+                        onCheckedChange={(value) => setImportCommonLlmEnabled(Boolean(value))}
+                      />
+                      启用 LLM 抽取
+                    </div>
+                    <div className="mt-1 text-xs text-muted-foreground">需要模型参与抽取，质量更高但耗时更长。</div>
+                  </div>
+                  <div className="rounded-md border bg-background/70 p-3">
+                    <div className="flex items-center gap-2 text-sm">
+                      <Checkbox
+                        checked={importCommonChatLog}
+                        onCheckedChange={(value) => setImportCommonChatLog(Boolean(value))}
+                      />
+                      按聊天日志解析
+                    </div>
+                    <div className="mt-1 text-xs text-muted-foreground">适合导入聊天记录，会尽量保留时间和对话上下文。</div>
+                  </div>
+                </div>
+
+                <details className="rounded-md border bg-background/70 p-3 text-sm">
+                  <summary className="cursor-pointer text-xs font-medium text-muted-foreground">
+                    高级参数（通常不用修改）
+                  </summary>
+                  <div className="mt-3 grid gap-3">
+                    <div className="space-y-1">
+                      <Label>指定抽取策略</Label>
+                      <Input
+                        value={importCommonStrategyOverride}
+                        onChange={(event) => setImportCommonStrategyOverride(event.target.value)}
+                      />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>去重策略</Label>
+                      <Input
+                        value={importCommonDedupePolicy}
+                        onChange={(event) => setImportCommonDedupePolicy(event.target.value)}
+                      />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>聊天参考时间</Label>
+                      <Input
+                        value={importCommonChatReferenceTime}
+                        onChange={(event) => setImportCommonChatReferenceTime(event.target.value)}
+                      />
+                    </div>
+                    <div className="flex items-center gap-2 text-sm">
+                      <Checkbox
+                        checked={importCommonForce}
+                        onCheckedChange={(value) => setImportCommonForce(Boolean(value))}
+                      />
+                      强制导入
+                    </div>
+                    <div className="flex items-center gap-2 text-sm">
+                      <Checkbox
+                        checked={importCommonClearManifest}
+                        onCheckedChange={(value) => setImportCommonClearManifest(Boolean(value))}
+                      />
+                      清空导入清单
+                    </div>
+                  </div>
+                </details>
+              </div>
+
+              <TabsContent value="upload" className="mt-0">
+                <div className="space-y-3 rounded-xl border bg-background/70 p-4">
+                  <div className="text-xs text-muted-foreground">选择一个或多个本地文件创建导入任务，适合批量导入资料或聊天记录。</div>
+                  <div className="grid gap-3">
+                    <div className="space-y-1">
+                      <Label>输入模式</Label>
+                      <Select
+                        value={uploadInputMode}
+                        onValueChange={(value) => setUploadInputMode(normalizeImportInputMode(value))}
+                      >
+                        <SelectTrigger aria-label="upload-input-mode">
+                          <SelectValue />
+                        </SelectTrigger>
+                        <SelectContent>
+                          <SelectItem value="text">文本</SelectItem>
+                          <SelectItem value="json">结构化 JSON</SelectItem>
+                        </SelectContent>
+                      </Select>
+                    </div>
+                    <div className="space-y-1">
+                      <Label>文件选择</Label>
+                      <Input
+                        type="file"
+                        multiple
+                        accept=".txt,.md,.json,.jsonl,.csv,.log,.html,.htm,.xml"
+                        onChange={(event) => setUploadFiles(Array.from(event.target.files ?? []))}
+                      />
+                    </div>
+                  </div>
+                  <div className="text-xs text-muted-foreground">已选择 {uploadFiles.length} 个文件</div>
+                </div>
+              </TabsContent>
+
+              <TabsContent value="paste" className="mt-0">
+                <div className="space-y-3 rounded-xl border bg-background/70 p-4">
+                  <div className="text-xs text-muted-foreground">直接粘贴少量文本或 JSON，适合临时补充一段资料。</div>
+                  <div className="grid gap-3">
+                    <div className="space-y-1">
+                      <Label>内容名称</Label>
+                      <Input value={pasteName} onChange={(event) => setPasteName(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>输入模式</Label>
+                      <Select
+                        value={pasteMode}
+                        onValueChange={(value) => setPasteMode(normalizeImportInputMode(value))}
+                      >
+                        <SelectTrigger aria-label="paste-input-mode">
+                          <SelectValue />
+                        </SelectTrigger>
+                        <SelectContent>
+                          <SelectItem value="text">文本</SelectItem>
+                          <SelectItem value="json">结构化 JSON</SelectItem>
+                        </SelectContent>
+                      </Select>
+                    </div>
+                    <div className="space-y-1">
+                      <Label>粘贴内容</Label>
+                      <Textarea
+                        value={pasteContent}
+                        onChange={(event) => setPasteContent(event.target.value)}
+                        rows={8}
+                      />
+                    </div>
+                  </div>
+                </div>
+              </TabsContent>
+
+              <TabsContent value="raw_scan" className="mt-0">
+                <div className="space-y-3 rounded-xl border bg-background/70 p-4">
+                  <div className="text-xs text-muted-foreground">扫描目录文件，适合本地批处理</div>
+                  <div className="grid gap-3">
+                    <div className="space-y-1">
+                      <Label>路径别名</Label>
+                      <Input value={rawAlias} onChange={(event) => setRawAlias(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>输入模式</Label>
+                      <Select
+                        value={rawInputMode}
+                        onValueChange={(value) => setRawInputMode(normalizeImportInputMode(value))}
+                      >
+                        <SelectTrigger aria-label="raw-input-mode">
+                          <SelectValue />
+                        </SelectTrigger>
+                        <SelectContent>
+                          <SelectItem value="text">文本</SelectItem>
+                          <SelectItem value="json">结构化 JSON</SelectItem>
+                        </SelectContent>
+                      </Select>
+                    </div>
+                    <div className="space-y-1">
+                      <Label>相对路径</Label>
+                      <Input value={rawRelativePath} onChange={(event) => setRawRelativePath(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>匹配规则（Glob）</Label>
+                      <Input value={rawGlob} onChange={(event) => setRawGlob(event.target.value)} />
+                    </div>
+                  </div>
+                  <div className="flex items-center gap-2 text-sm">
+                    <Checkbox checked={rawRecursive} onCheckedChange={(value) => setRawRecursive(Boolean(value))} />
+                    递归扫描
+                  </div>
+                </div>
+              </TabsContent>
+
+              <TabsContent value="lpmm_openie" className="mt-0">
+                <div className="space-y-3 rounded-xl border bg-background/70 p-4">
+                  <div className="text-xs text-muted-foreground">读取 LPMM 内容并抽取关系</div>
+                  <div className="grid gap-3">
+                    <div className="space-y-1">
+                      <Label>路径别名</Label>
+                      <Input value={openieAlias} onChange={(event) => setOpenieAlias(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>相对路径</Label>
+                      <Input value={openieRelativePath} onChange={(event) => setOpenieRelativePath(event.target.value)} />
+                    </div>
+                  </div>
+                  <div className="flex items-center gap-2 text-sm">
+                    <Checkbox
+                      checked={openieIncludeAllJson}
+                      onCheckedChange={(value) => setOpenieIncludeAllJson(Boolean(value))}
+                    />
+                    包含全部 JSON 文件
+                  </div>
+                </div>
+              </TabsContent>
+
+              <TabsContent value="lpmm_convert" className="mt-0">
+                <div className="space-y-3 rounded-xl border bg-background/70 p-4">
+                  <div className="text-xs text-muted-foreground">将 LPMM 数据转换到目标目录</div>
+                  <div className="grid gap-3">
+                    <div className="space-y-1">
+                      <Label>源路径别名</Label>
+                      <Input value={convertAlias} onChange={(event) => setConvertAlias(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>目标路径别名</Label>
+                      <Input value={convertTargetAlias} onChange={(event) => setConvertTargetAlias(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>源相对路径</Label>
+                      <Input value={convertRelativePath} onChange={(event) => setConvertRelativePath(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>目标相对路径</Label>
+                      <Input
+                        value={convertTargetRelativePath}
+                        onChange={(event) => setConvertTargetRelativePath(event.target.value)}
+                      />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>向量维度</Label>
+                      <Input
+                        type="number"
+                        min={1}
+                        value={convertDimension}
+                        onChange={(event) => setConvertDimension(event.target.value)}
+                      />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>批处理大小</Label>
+                      <Input
+                        type="number"
+                        min={1}
+                        value={convertBatchSize}
+                        onChange={(event) => setConvertBatchSize(event.target.value)}
+                      />
+                    </div>
+                  </div>
+                </div>
+              </TabsContent>
+
+              <TabsContent value="temporal_backfill" className="mt-0">
+                <div className="space-y-3 rounded-xl border bg-background/70 p-4">
+                  <div className="text-xs text-muted-foreground">为已有数据补齐时间字段</div>
+                  <div className="grid gap-3">
+                    <div className="space-y-1">
+                      <Label>路径别名</Label>
+                      <Input value={backfillAlias} onChange={(event) => setBackfillAlias(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>处理上限</Label>
+                      <Input type="number" min={1} value={backfillLimit} onChange={(event) => setBackfillLimit(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>相对路径</Label>
+                      <Input value={backfillRelativePath} onChange={(event) => setBackfillRelativePath(event.target.value)} />
+                    </div>
+                  </div>
+                  <div className="grid gap-2">
+                    <div className="flex items-center gap-2 text-sm">
+                      <Checkbox checked={backfillDryRun} onCheckedChange={(value) => setBackfillDryRun(Boolean(value))} />
+                      只预演，不写入数据
+                    </div>
+                    <div className="flex items-center gap-2 text-sm">
+                      <Checkbox
+                        checked={backfillNoCreatedFallback}
+                        onCheckedChange={(value) => setBackfillNoCreatedFallback(Boolean(value))}
+                      />
+                      禁用创建时间回退
+                    </div>
+                  </div>
+                </div>
+              </TabsContent>
+
+              <TabsContent value="maibot_migration" className="mt-0">
+                <div className="space-y-3 rounded-xl border bg-background/70 p-4">
+                  <div className="text-xs text-muted-foreground">迁移 MaiBot 历史长期记忆</div>
+                  <div className="grid gap-3">
+                    <div className="space-y-1">
+                      <Label>源数据库路径</Label>
+                      <Input value={maibotSourceDb} onChange={(event) => setMaibotSourceDb(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>起始时间</Label>
+                      <Input value={maibotTimeFrom} onChange={(event) => setMaibotTimeFrom(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>结束时间</Label>
+                      <Input value={maibotTimeTo} onChange={(event) => setMaibotTimeTo(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>起始 ID</Label>
+                      <Input type="number" min={1} value={maibotStartId} onChange={(event) => setMaibotStartId(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>结束 ID</Label>
+                      <Input type="number" min={1} value={maibotEndId} onChange={(event) => setMaibotEndId(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>会话 ID 列表</Label>
+                      <Input value={maibotStreamIds} onChange={(event) => setMaibotStreamIds(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>群组 ID 列表</Label>
+                      <Input value={maibotGroupIds} onChange={(event) => setMaibotGroupIds(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>用户 ID 列表</Label>
+                      <Input value={maibotUserIds} onChange={(event) => setMaibotUserIds(event.target.value)} />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>读取批大小</Label>
+                      <Input
+                        type="number"
+                        min={1}
+                        value={maibotReadBatchSize}
+                        onChange={(event) => setMaibotReadBatchSize(event.target.value)}
+                      />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>提交窗口行数</Label>
+                      <Input
+                        type="number"
+                        min={1}
+                        value={maibotCommitWindowRows}
+                        onChange={(event) => setMaibotCommitWindowRows(event.target.value)}
+                      />
+                    </div>
+                    <div className="space-y-1">
+                      <Label>向量线程数</Label>
+                      <Input
+                        type="number"
+                        min={1}
+                        value={maibotEmbedWorkers}
+                        onChange={(event) => setMaibotEmbedWorkers(event.target.value)}
+                      />
+                    </div>
+                  </div>
+                  <div className="grid gap-2">
+                    <div className="flex items-center gap-2 text-sm">
+                      <Checkbox checked={maibotNoResume} onCheckedChange={(value) => setMaibotNoResume(Boolean(value))} />
+                      从头开始，不继续上次进度
+                    </div>
+                    <div className="flex items-center gap-2 text-sm">
+                      <Checkbox checked={maibotResetState} onCheckedChange={(value) => setMaibotResetState(Boolean(value))} />
+                      重置迁移状态
+                    </div>
+                    <div className="flex items-center gap-2 text-sm">
+                      <Checkbox checked={maibotDryRun} onCheckedChange={(value) => setMaibotDryRun(Boolean(value))} />
+                      只预演，不写入数据
+                    </div>
+                    <div className="flex items-center gap-2 text-sm">
+                      <Checkbox checked={maibotVerifyOnly} onCheckedChange={(value) => setMaibotVerifyOnly(Boolean(value))} />
+                      仅校验
+                    </div>
+                  </div>
+                </div>
+              </TabsContent>
+
+              </Tabs>
+
+              <Button onClick={() => void submitImportByMode()} disabled={creatingImport}>
+                {creatingImport ? <Loader2 className="mr-2 h-4 w-4 animate-spin" /> : <Upload className="mr-2 h-4 w-4" />}
+                创建导入任务
+              </Button>
+            </CardContent>
+          </Card>
+
+          <Card className="rounded-2xl border-border/70 bg-card/85 shadow-sm">
+            <CardHeader>
+              <CardTitle>路径预检</CardTitle>
+              <CardDescription>在创建本地扫描、转换或迁移任务前，先确认路径会被解析到哪里。</CardDescription>
+            </CardHeader>
+            <CardContent className="space-y-4">
+              <div className="grid gap-3">
+                <div className="space-y-1">
+                  <Label>路径别名</Label>
+                  <div className="text-xs text-muted-foreground">选择后端允许访问的数据根目录。</div>
+                  <Select value={pathResolveAlias} onValueChange={setPathResolveAlias}>
+                    <SelectTrigger aria-label="import-path-alias">
+                      <SelectValue />
+                    </SelectTrigger>
+                    <SelectContent>
+                      {importAliasKeys.length > 0 ? importAliasKeys.map((alias) => (
+                        <SelectItem key={alias} value={alias}>{alias}</SelectItem>
+                      )) : (
+                        <SelectItem value="raw">raw</SelectItem>
+                      )}
+                    </SelectContent>
+                  </Select>
+                </div>
+                <div className="space-y-1">
+                  <Label>相对路径</Label>
+                  <div className="text-xs text-muted-foreground">填写相对于路径别名的子路径，不需要填写完整磁盘路径。</div>
+                  <Input
+                    value={pathResolveRelativePath}
+                    onChange={(event) => setPathResolveRelativePath(event.target.value)}
+                    placeholder="例如 exports/weekly"
+                  />
+                </div>
+              </div>
+              <div className="flex items-center gap-2 text-sm">
+                <Checkbox checked={pathResolveMustExist} onCheckedChange={(value) => setPathResolveMustExist(Boolean(value))} />
+                要求路径已存在
+              </div>
+              <Button
+                variant="outline"
+                onClick={() => void resolveImportPath()}
+                disabled={resolvingPath || !pathResolveAlias.trim()}
+              >
+                {resolvingPath ? <Loader2 className="mr-2 h-4 w-4 animate-spin" /> : <RefreshCw className="mr-2 h-4 w-4" />}
+                解析路径
+              </Button>
+              <Textarea value={pathResolveOutput} readOnly rows={6} placeholder="解析结果会显示在这里" />
+            </CardContent>
+          </Card>
+        </div>
+
+        <div className="order-1 space-y-6 lg:order-2">
+          <Card className="rounded-2xl border-border/70 bg-card/90 shadow-sm">
+            <CardHeader className="space-y-4 pb-4">
+              <div className="flex flex-wrap items-center justify-between gap-2">
+                <CardTitle>导入队列</CardTitle>
+                <Button variant="outline" size="sm" onClick={() => void refreshImportQueue()}>
+                  <RefreshCw className="mr-2 h-4 w-4" />
+                  刷新
+                </Button>
+              </div>
+              <div className="flex flex-wrap items-center justify-between gap-3">
+                <CardDescription className="text-sm">
+                  查看任务是否正在运行、排队等待或已经结束。点击任务卡片可查看详情。
+                </CardDescription>
+                <div className="flex flex-wrap gap-2 text-xs text-muted-foreground">
+                  <Badge variant="outline" className="bg-background/70">运行中 {runningImportTasks.length}</Badge>
+                  <Badge variant="outline" className="bg-background/70">排队中 {queuedImportTasks.length}</Badge>
+                  <Badge variant="outline" className="bg-background/70">最近完成 {recentImportTasks.length}</Badge>
+                </div>
+                <label className="flex items-center gap-2 text-xs text-muted-foreground">
+                  <Checkbox checked={importAutoPolling} onCheckedChange={(value) => setImportAutoPolling(Boolean(value))} />
+                  自动轮询 {importPollInterval}ms
+                </label>
+              </div>
+            </CardHeader>
+            <CardContent className="space-y-6">
+              {importErrorText ? (
+                <Alert variant="destructive">
+                  <AlertDescription>{importErrorText}</AlertDescription>
+                </Alert>
+              ) : null}
+
+              <div className="space-y-2.5">
+                <div className="flex items-center justify-between gap-2">
+                  <div className="text-sm font-medium">运行中</div>
+                  <Badge variant="outline">{runningImportTasks.length}</Badge>
+                </div>
+                {runningImportTasks.length > 0 ? (
+                  <ScrollArea className="h-[208px] rounded-xl border bg-muted/10">
+                    <div className="space-y-2.5 p-2.5">
+                      {runningImportTasks.map((task) => {
+                        const isSelected = task.task_id === selectedImportTaskId
+                        return (
+                          <button
+                            key={task.task_id}
+                            type="button"
+                            onClick={() => void selectImportTask(task.task_id)}
+                            className={cn(
+                              'w-full rounded-xl border p-4 text-left transition-all',
+                              isSelected
+                                ? 'border-primary/70 bg-primary/5 shadow-sm'
+                                : 'bg-background/80 hover:border-muted-foreground/40 hover:bg-muted/20',
+                            )}
+                          >
+                            <div className="flex flex-wrap items-start justify-between gap-2">
+                              <div className="min-w-0 space-y-1">
+                                <div className="break-all font-mono text-[11px] leading-relaxed text-muted-foreground">
+                                  {task.task_id}
+                                </div>
+                                <div className="text-sm font-medium">{String(task.task_kind ?? task.mode ?? '-')}</div>
+                              </div>
+                              <Badge variant={getImportStatusVariant(String(task.status ?? ''))}>
+                                {getImportStatusLabel(String(task.status ?? ''))}
+                              </Badge>
+                            </div>
+                            <div className="mt-2 flex items-center justify-between gap-2 text-xs text-muted-foreground">
+                              <span>{getImportStepLabel(String(task.current_step ?? 'running'))}</span>
+                              <span>{Number(task.progress ?? 0).toFixed(1)}%</span>
+                            </div>
+                            <Progress value={normalizeProgress(task.progress)} className="mt-2 h-1.5" />
+                          </button>
+                        )
+                      })}
+                    </div>
+                  </ScrollArea>
+                ) : (
+                  <div className="rounded-xl border bg-muted/20 p-4 text-sm text-muted-foreground">当前没有运行中任务</div>
+                )}
+              </div>
+
+              <div className="space-y-2.5">
+                <div className="flex items-center justify-between gap-2">
+                  <div className="text-sm font-medium">排队中</div>
+                  <Badge variant="outline">{queuedImportTasks.length}</Badge>
+                </div>
+                {queuedImportTasks.length > 0 ? (
+                  <ScrollArea className="h-[188px] rounded-xl border bg-muted/10">
+                    <div className="space-y-2.5 p-2.5">
+                      {queuedImportTasks.map((task) => {
+                        const isSelected = task.task_id === selectedImportTaskId
+                        return (
+                          <button
+                            key={task.task_id}
+                            type="button"
+                            onClick={() => void selectImportTask(task.task_id)}
+                            className={cn(
+                              'w-full rounded-xl border p-4 text-left transition-all',
+                              isSelected
+                                ? 'border-primary/70 bg-primary/5 shadow-sm'
+                                : 'bg-background/80 hover:border-muted-foreground/40 hover:bg-muted/20',
+                            )}
+                          >
+                            <div className="flex flex-wrap items-start justify-between gap-2">
+                              <div className="min-w-0 space-y-1">
+                                <div className="break-all font-mono text-[11px] leading-relaxed text-muted-foreground">
+                                  {task.task_id}
+                                </div>
+                                <div className="text-sm font-medium">{String(task.task_kind ?? task.mode ?? '-')}</div>
+                              </div>
+                              <Badge variant={getImportStatusVariant(String(task.status ?? ''))}>
+                                {getImportStatusLabel(String(task.status ?? ''))}
+                              </Badge>
+                            </div>
+                            <div className="mt-2 flex items-center justify-between gap-2 text-xs text-muted-foreground">
+                              <span>创建时间</span>
+                              <span>{formatImportTime(task.created_at)}</span>
+                            </div>
+                          </button>
+                        )
+                      })}
+                    </div>
+                  </ScrollArea>
+                ) : (
+                  <div className="rounded-xl border bg-muted/20 p-4 text-sm text-muted-foreground">当前没有排队任务</div>
+                )}
+              </div>
+
+              <div className="space-y-2.5">
+                <div className="flex items-center justify-between gap-2">
+                  <div className="text-sm font-medium">最近完成</div>
+                  <Badge variant="secondary">{recentImportTasks.length}</Badge>
+                </div>
+                {recentImportTasks.length > 0 ? (
+                  <ScrollArea className="h-[260px] rounded-xl border bg-muted/10">
+                    <div className="space-y-2.5 p-2.5">
+                      {recentImportTasks.map((task) => {
+                        const isSelected = task.task_id === selectedImportTaskId
+                        return (
+                          <button
+                            key={task.task_id}
+                            type="button"
+                            onClick={() => void selectImportTask(task.task_id)}
+                            className={cn(
+                              'w-full rounded-xl border p-4 text-left transition-all',
+                              isSelected
+                                ? 'border-primary/70 bg-primary/5 shadow-sm'
+                                : 'bg-background/80 hover:border-muted-foreground/40 hover:bg-muted/20',
+                            )}
+                          >
+                            <div className="flex flex-wrap items-start justify-between gap-2">
+                              <div className="min-w-0 space-y-1">
+                                <div className="break-all font-mono text-[11px] leading-relaxed text-muted-foreground">
+                                  {task.task_id}
+                                </div>
+                                <div className="text-sm font-medium">{String(task.task_kind ?? task.mode ?? '-')}</div>
+                              </div>
+                              <Badge variant={getImportStatusVariant(String(task.status ?? ''))}>
+                                {getImportStatusLabel(String(task.status ?? ''))}
+                              </Badge>
+                            </div>
+                            <div className="mt-2 flex items-center justify-between gap-2 text-xs text-muted-foreground">
+                              <span>完成进度</span>
+                              <span>{Number(task.progress ?? 0).toFixed(1)}%</span>
+                            </div>
+                            <Progress value={normalizeProgress(task.progress)} className="mt-2 h-1.5" />
+                          </button>
+                        )
+                      })}
+                    </div>
+                  </ScrollArea>
+                ) : (
+                  <div className="rounded-xl border bg-muted/20 p-4 text-sm text-muted-foreground">暂时没有历史任务</div>
+                )}
+              </div>
+            </CardContent>
+          </Card>
+        </div>
+      </div>
+
+      <Card className="rounded-2xl border-border/70 bg-card/90 shadow-sm">
+          <CardHeader className="space-y-4">
+            <div className="flex flex-wrap items-center justify-between gap-2">
+              <CardTitle>任务详情</CardTitle>
+              <div className="flex flex-wrap gap-2">
+                <Button
+                  size="sm"
+                  variant="outline"
+                  aria-label="取消选中导入任务"
+                  onClick={() => void cancelSelectedImportTask()}
+                  disabled={!selectedImportTaskId}
+                >
+                  取消任务
+                </Button>
+                <Button
+                  size="sm"
+                  aria-label="重试选中导入任务"
+                  onClick={() => void retrySelectedImportTask()}
+                  disabled={!selectedImportTaskId}
+                >
+                  重试失败项
+                </Button>
+              </div>
+            </div>
+            <CardDescription>支持文件级和分块级状态观察，可直接在当前页面定位失败原因</CardDescription>
+          </CardHeader>
+          <CardContent className="space-y-6">
+            {selectedImportTaskLoading ? (
+              <div className="flex items-center gap-2 text-sm text-muted-foreground">
+                <Loader2 className="h-4 w-4 animate-spin" />
+                正在加载任务详情...
+              </div>
+            ) : null}
+
+            {!selectedImportTaskResolved ? (
+              <div className="flex flex-col items-center justify-center gap-3 rounded-xl border border-dashed bg-muted/15 px-6 py-10 text-center">
+                <div className="rounded-full bg-muted/40 p-3">
+                  <Loader2 className="h-5 w-5 text-muted-foreground" />
+                </div>
+                <div className="space-y-1">
+                  <div className="text-sm font-medium">还没选中任务</div>
+                  <div className="text-xs leading-relaxed text-muted-foreground">
+                    在左侧/上方的导入队列里点击任意任务卡片<br />
+                    即可在这里查看进度、文件状态和分块详情
+                  </div>
+                </div>
+              </div>
+            ) : (
+              <>
+                <div className="space-y-2">
+                  <div className="text-sm font-medium">任务摘要</div>
+                  <div className="overflow-auto rounded-xl border bg-muted/10">
+                    <Table className="min-w-[680px]">
+                      <TableBody>
+                        <TableRow>
+                          <TableCell className="w-[140px] text-muted-foreground">任务 ID</TableCell>
+                          <TableCell className="break-all font-mono text-xs leading-relaxed">
+                            {selectedImportTaskResolved.task_id}
+                          </TableCell>
+                        </TableRow>
+                        <TableRow>
+                          <TableCell className="text-muted-foreground">任务类型</TableCell>
+                          <TableCell>{String(selectedImportTaskResolved.task_kind ?? selectedImportTaskResolved.mode ?? '-')}</TableCell>
+                        </TableRow>
+                        <TableRow>
+                          <TableCell className="text-muted-foreground">状态 / 步骤</TableCell>
+                          <TableCell>
+                            <div className="flex flex-wrap items-center gap-2">
+                              <Badge variant={getImportStatusVariant(String(selectedImportTaskResolved.status ?? ''))}>
+                                {getImportStatusLabel(String(selectedImportTaskResolved.status ?? ''))}
+                              </Badge>
+                              <span className="text-xs text-muted-foreground">
+                                {getImportStepLabel(String(selectedImportTaskResolved.current_step ?? ''))}
+                              </span>
+                            </div>
+                          </TableCell>
+                        </TableRow>
+                        <TableRow>
+                          <TableCell className="text-muted-foreground">进度</TableCell>
+                          <TableCell>
+                            <MemoryProgressIndicator
+                              value={normalizeProgress(selectedImportTaskResolved.progress)}
+                              statusLabel={getImportStatusLabel(String(selectedImportTaskResolved.status ?? ''))}
+                              stepLabel={getImportStepLabel(String(selectedImportTaskResolved.current_step ?? ''))}
+                              tone={
+                                String(selectedImportTaskResolved.status ?? '') === 'completed'
+                                  ? 'success'
+                                  : String(selectedImportTaskResolved.status ?? '') === 'failed'
+                                    ? 'destructive'
+                                    : String(selectedImportTaskResolved.status ?? '') === 'cancelled'
+                                      ? 'muted'
+                                      : 'default'
+                              }
+                              busy={RUNNING_IMPORT_STATUS.has(String(selectedImportTaskResolved.status ?? ''))}
+                              detail={`已完成 ${Number(selectedImportTaskResolved.done_chunks ?? 0)} / ${Number(selectedImportTaskResolved.total_chunks ?? 0)} 分块`}
+                            />
+                          </TableCell>
+                        </TableRow>
+                        <TableRow>
+                          <TableCell className="text-muted-foreground">创建时间</TableCell>
+                          <TableCell>{formatImportTime(selectedImportTaskResolved.created_at)}</TableCell>
+                        </TableRow>
+                        <TableRow>
+                          <TableCell className="text-muted-foreground">更新时间</TableCell>
+                          <TableCell>{formatImportTime(selectedImportTaskResolved.updated_at)}</TableCell>
+                        </TableRow>
+                      </TableBody>
+                    </Table>
+                  </div>
+                </div>
+
+                {selectedImportRetrySummary ? (
+                  <div className="space-y-2">
+                    <div className="text-sm font-medium">重试摘要</div>
+                    <div className="overflow-auto rounded-xl border bg-muted/10">
+                      <Table>
+                        <TableBody>
+                          <TableRow>
+                            <TableCell className="w-[220px] text-muted-foreground">按分块重试的文件数</TableCell>
+                            <TableCell>{Number(selectedImportRetrySummary.chunk_retry_files ?? 0)}</TableCell>
+                          </TableRow>
+                          <TableRow>
+                            <TableCell className="text-muted-foreground">按分块重试的分块数</TableCell>
+                            <TableCell>{Number(selectedImportRetrySummary.chunk_retry_chunks ?? 0)}</TableCell>
+                          </TableRow>
+                          <TableRow>
+                            <TableCell className="text-muted-foreground">回退整文件重试数</TableCell>
+                            <TableCell>{Number(selectedImportRetrySummary.file_fallback_files ?? 0)}</TableCell>
+                          </TableRow>
+                          <TableRow>
+                            <TableCell className="text-muted-foreground">跳过文件数</TableCell>
+                            <TableCell>{Number(selectedImportRetrySummary.skipped_files ?? 0)}</TableCell>
+                          </TableRow>
+                        </TableBody>
+                      </Table>
+                    </div>
+                  </div>
+                ) : null}
+
+                {selectedImportTaskErrorText ? (
+                  <Alert variant="destructive">
+                    <AlertDescription>{selectedImportTaskErrorText}</AlertDescription>
+                  </Alert>
+                ) : null}
+
+                <div className="space-y-2.5">
+                  <div className="text-sm font-medium">文件状态</div>
+                  {selectedImportFiles.length > 0 ? (
+                    <ScrollArea className="h-[260px] rounded-xl border bg-muted/10">
+                      <div className="space-y-2.5 p-2.5">
+                        {selectedImportFiles.map((file) => {
+                          const isSelected = file.file_id === selectedImportFileId
+                          return (
+                            <button
+                              key={file.file_id}
+                              type="button"
+                              onClick={() => void selectImportFile(file.file_id)}
+                              className={cn(
+                                'w-full rounded-xl border p-4 text-left transition-all',
+                                isSelected
+                                  ? 'border-primary/70 bg-primary/5 shadow-sm'
+                                  : 'bg-background/80 hover:border-muted-foreground/40 hover:bg-muted/20',
+                              )}
+                            >
+                              <div className="flex flex-wrap items-center justify-between gap-2">
+                                <span className="truncate text-sm font-medium">{file.name || file.file_id}</span>
+                                <Badge variant={getImportStatusVariant(String(file.status ?? ''))}>
+                                  {getImportStatusLabel(String(file.status ?? ''))}
+                                </Badge>
+                              </div>
+                              <div className="mt-2 flex items-center justify-between gap-2 text-xs text-muted-foreground">
+                                <span>{getImportStepLabel(String(file.current_step ?? ''))}</span>
+                                <span>{Number(file.progress ?? 0).toFixed(1)}%</span>
+                              </div>
+                              <Progress value={normalizeProgress(file.progress)} className="mt-2 h-1.5" />
+                              <div className="mt-2 text-xs text-muted-foreground">
+                                {Number(file.progress ?? 0).toFixed(1)}% · {Number(file.done_chunks ?? 0)} / {Number(file.total_chunks ?? 0)}
+                              </div>
+                              {file.error ? (
+                                <div className="mt-2 truncate text-xs text-destructive">{file.error}</div>
+                              ) : null}
+                            </button>
+                          )
+                        })}
+                      </div>
+                    </ScrollArea>
+                  ) : (
+                    <div className="rounded-xl border bg-muted/20 p-4 text-sm text-muted-foreground">当前任务没有文件明细</div>
+                  )}
+                </div>
+
+                <div className="space-y-2.5">
+                  <div className="flex items-center justify-between gap-2">
+                    <div className="text-sm font-medium">分块状态</div>
+                    <div className="flex items-center gap-2 text-xs text-muted-foreground">
+                      <Button
+                        size="icon"
+                        variant="outline"
+                        aria-label="上一页分块"
+                        onClick={() => void moveImportChunkPage(-1)}
+                        disabled={!canImportChunkPrev}
+                      >
+                        <ChevronLeft className="h-4 w-4" />
+                      </Button>
+                      <span>
+                        {importChunkTotal > 0
+                          ? `${importChunkOffset + 1}-${Math.min(importChunkOffset + IMPORT_CHUNK_PAGE_SIZE, importChunkTotal)}`
+                          : '0-0'}
+                        {' / '}
+                        {importChunkTotal}
+                      </span>
+                      <Button
+                        size="icon"
+                        variant="outline"
+                        aria-label="下一页分块"
+                        onClick={() => void moveImportChunkPage(1)}
+                        disabled={!canImportChunkNext}
+                      >
+                        <ChevronRight className="h-4 w-4" />
+                      </Button>
+                    </div>
+                  </div>
+
+                  <div className="overflow-auto rounded-xl border bg-background/80">
+                    <Table className="min-w-[700px]">
+                      <TableHeader>
+                        <TableRow>
+                          <TableHead className="w-[72px]">序号</TableHead>
+                          <TableHead className="w-[108px]">状态</TableHead>
+                          <TableHead className="w-[108px]">步骤</TableHead>
+                          <TableHead className="w-[84px]">进度</TableHead>
+                          <TableHead>错误 / 预览</TableHead>
+                        </TableRow>
+                      </TableHeader>
+                      <TableBody>
+                        {importChunksLoading ? (
+                          <TableRow>
+                            <TableCell colSpan={5} className="text-center text-muted-foreground">
+                              正在加载分块详情...
+                            </TableCell>
+                          </TableRow>
+                        ) : selectedImportChunks.length > 0 ? (
+                          selectedImportChunks.map((chunk) => (
+                            <TableRow key={chunk.chunk_id}>
+                              <TableCell>{chunk.index}</TableCell>
+                              <TableCell>{getImportStatusLabel(String(chunk.status ?? ''))}</TableCell>
+                              <TableCell>{getImportStepLabel(String(chunk.step ?? ''))}</TableCell>
+                              <TableCell>{Number(chunk.progress ?? 0).toFixed(1)}%</TableCell>
+                              <TableCell className="max-w-[360px]">
+                                <div className="space-y-2">
+                                  {String(chunk.error ?? '').trim() ? (
+                                    <div className="rounded-md border border-destructive/30 bg-destructive/5 px-2.5 py-2 text-sm leading-relaxed text-destructive">
+                                      {String(chunk.error)}
+                                    </div>
+                                  ) : null}
+                                  <details className="rounded-md border bg-muted/20 px-2.5 py-2 text-xs text-muted-foreground">
+                                    <summary className="cursor-pointer font-medium text-foreground">
+                                      {String(chunk.error ?? '').trim() ? '查看分块预览' : '查看内容详情'}
+                                    </summary>
+                                    <div className="mt-2 whitespace-pre-wrap break-words leading-relaxed">
+                                      {String(chunk.content_preview ?? '-') || '-'}
+                                    </div>
+                                  </details>
+                                </div>
+                              </TableCell>
+                            </TableRow>
+                          ))
+                        ) : (
+                          <TableRow>
+                            <TableCell colSpan={5} className="text-center text-muted-foreground">
+                              当前页没有分块数据
+                            </TableCell>
+                          </TableRow>
+                        )}
+                      </TableBody>
+                    </Table>
+                  </div>
+                </div>
+              </>
+            )}
+          </CardContent>
+        </Card>
+    </TabsContent>
+  )
+}
diff --git a/dashboard/src/routes/resource/knowledge-base/tabs/TuningTab.tsx b/dashboard/src/routes/resource/knowledge-base/tabs/TuningTab.tsx
new file mode 100644
index 0000000000..31fd297431
--- /dev/null
+++ b/dashboard/src/routes/resource/knowledge-base/tabs/TuningTab.tsx
@@ -0,0 +1,193 @@
+import type { Dispatch, SetStateAction } from 'react'
+
+import { Sparkles } from 'lucide-react'
+
+import { Badge } from '@/components/ui/badge'
+import { Button } from '@/components/ui/button'
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+import { CodeEditor } from '@/components/CodeEditor'
+import { Input } from '@/components/ui/input'
+import { Label } from '@/components/ui/label'
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/components/ui/select'
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@/components/ui/table'
+import { TabsContent } from '@/components/ui/tabs'
+import type { MemoryTaskPayload } from '@/lib/memory-api'
+
+import { getImportStatusVariant } from '../utils'
+
+export interface TuningTabProps {
+  tuningObjective: string
+  setTuningObjective: Dispatch<SetStateAction<string>>
+  tuningIntensity: string
+  setTuningIntensity: Dispatch<SetStateAction<string>>
+  tuningSampleSize: string
+  setTuningSampleSize: Dispatch<SetStateAction<string>>
+  tuningTopKEval: string
+  setTuningTopKEval: Dispatch<SetStateAction<string>>
+  submitTuningTask: () => Promise<void>
+  creatingTuning: boolean
+  tuningProfile: Record<string, unknown>
+  tuningProfileToml: string
+  tuningTasks: MemoryTaskPayload[]
+  applyBestTask: (taskId: string) => Promise<void>
+}
+
+export function TuningTab(props: TuningTabProps) {
+  const {
+    tuningObjective,
+    setTuningObjective,
+    tuningIntensity,
+    setTuningIntensity,
+    tuningSampleSize,
+    setTuningSampleSize,
+    tuningTopKEval,
+    setTuningTopKEval,
+    submitTuningTask,
+    creatingTuning,
+    tuningProfile,
+    tuningProfileToml,
+    tuningTasks,
+    applyBestTask,
+  } = props
+
+  return (
+    <TabsContent value="tuning" className="space-y-4">
+      <div className="grid gap-4 xl:grid-cols-[0.95fr_1.05fr]">
+        <Card>
+          <CardHeader>
+            <CardTitle className="flex items-center gap-2">
+              <Sparkles className="h-4 w-4" />
+              调优任务
+            </CardTitle>
+            <CardDescription>创建一次检索参数评估任务，完成后可在右侧列表中查看并应用最佳结果。</CardDescription>
+          </CardHeader>
+          <CardContent className="space-y-4">
+            <div className="space-y-3 rounded-lg border bg-muted/20 p-4">
+              <div className="space-y-1">
+                <div className="text-sm font-medium">调优策略</div>
+                <div className="text-xs text-muted-foreground">先选择优化方向和搜索强度。默认的 balanced / standard 适合大多数情况。</div>
+              </div>
+              <div className="grid gap-4 md:grid-cols-2">
+                <div className="space-y-2">
+                  <Label>优化目标</Label>
+                  <div className="text-xs text-muted-foreground">决定本次调优更偏向准确率、召回率，还是两者平衡。</div>
+                  <Select value={tuningObjective} onValueChange={setTuningObjective}>
+                    <SelectTrigger><SelectValue /></SelectTrigger>
+                    <SelectContent>
+                      <SelectItem value="precision_priority">precision_priority</SelectItem>
+                      <SelectItem value="balanced">balanced</SelectItem>
+                      <SelectItem value="recall_priority">recall_priority</SelectItem>
+                    </SelectContent>
+                  </Select>
+                </div>
+                <div className="space-y-2">
+                  <Label>评估强度</Label>
+                  <div className="text-xs text-muted-foreground">强度越高，评估更充分，但任务耗时也更长。</div>
+                  <Select value={tuningIntensity} onValueChange={setTuningIntensity}>
+                    <SelectTrigger><SelectValue /></SelectTrigger>
+                    <SelectContent>
+                      <SelectItem value="quick">quick</SelectItem>
+                      <SelectItem value="standard">standard</SelectItem>
+                      <SelectItem value="deep">deep</SelectItem>
+                    </SelectContent>
+                  </Select>
+                </div>
+              </div>
+            </div>
+            <div className="space-y-3 rounded-lg border bg-muted/20 p-4">
+              <div className="space-y-1">
+                <div className="text-sm font-medium">评估范围</div>
+                <div className="text-xs text-muted-foreground">控制本次任务使用多少样本，以及每次检索评估多少候选结果。</div>
+              </div>
+              <div className="grid gap-4 md:grid-cols-2">
+                <div className="space-y-2">
+                  <Label>样本量</Label>
+                  <div className="text-xs text-muted-foreground">用于评估的样本数量。数量越大，结果越稳定。</div>
+                  <Input type="number" value={tuningSampleSize} onChange={(event) => setTuningSampleSize(event.target.value)} />
+                </div>
+                <div className="space-y-2">
+                  <Label>评估 Top-K</Label>
+                  <div className="text-xs text-muted-foreground">每次检索时用于评估的候选结果数量。</div>
+                  <Input type="number" value={tuningTopKEval} onChange={(event) => setTuningTopKEval(event.target.value)} />
+                </div>
+              </div>
+            </div>
+            <Button onClick={() => void submitTuningTask()} disabled={creatingTuning}>
+              <Sparkles className="mr-2 h-4 w-4" />
+              创建调优任务
+            </Button>
+          </CardContent>
+        </Card>
+
+        <div className="space-y-4">
+          <Card>
+            <CardHeader>
+              <CardTitle>当前调优配置快照</CardTitle>
+              <CardDescription>展示当前生效的检索调优参数，便于在应用新结果前做对照。</CardDescription>
+            </CardHeader>
+            <CardContent className="space-y-3">
+              <CodeEditor
+                value={JSON.stringify(tuningProfile, null, 2)}
+                language="json"
+                readOnly
+                height="220px"
+              />
+              <CodeEditor
+                value={tuningProfileToml}
+                language="toml"
+                readOnly
+                height="180px"
+              />
+            </CardContent>
+          </Card>
+
+          <Card>
+            <CardHeader>
+              <CardTitle>最近调优任务</CardTitle>
+              <CardDescription>任务完成后，可以把最佳结果应用到当前调优配置。</CardDescription>
+            </CardHeader>
+            <CardContent className="space-y-3">
+              <Table>
+                <TableHeader>
+                  <TableRow>
+                    <TableHead>任务</TableHead>
+                    <TableHead>状态</TableHead>
+                    <TableHead>动作</TableHead>
+                  </TableRow>
+                </TableHeader>
+                <TableBody>
+                  {tuningTasks.length > 0 ? tuningTasks.map((task) => (
+                    <TableRow key={String(task.task_id ?? Math.random())}>
+                      <TableCell className="font-mono text-xs">{String(task.task_id ?? '-')}</TableCell>
+                      <TableCell>
+                        <Badge variant={getImportStatusVariant(String(task.status ?? ''))}>
+                          {String(task.status ?? '-')}
+                        </Badge>
+                      </TableCell>
+                      <TableCell>
+                        <Button
+                          size="sm"
+                          variant="outline"
+                          onClick={() => void applyBestTask(String(task.task_id ?? ''))}
+                          disabled={!task.task_id}
+                        >
+                          应用最佳
+                        </Button>
+                      </TableCell>
+                    </TableRow>
+                  )) : (
+                    <TableRow>
+                      <TableCell colSpan={3} className="text-center text-muted-foreground">
+                        还没有调优任务。可以先使用默认参数创建一次评估任务。
+                      </TableCell>
+                    </TableRow>
+                  )}
+                </TableBody>
+              </Table>
+            </CardContent>
+          </Card>
+        </div>
+      </div>
+    </TabsContent>
+  )
+}
diff --git a/dashboard/src/routes/resource/knowledge-base/utils.ts b/dashboard/src/routes/resource/knowledge-base/utils.ts
new file mode 100644
index 0000000000..397e0164aa
--- /dev/null
+++ b/dashboard/src/routes/resource/knowledge-base/utils.ts
@@ -0,0 +1,498 @@
+import type {
+  MemoryDeleteOperationPayload,
+  MemoryFeedbackActionLogPayload,
+  MemoryFeedbackCorrectionDetailTaskPayload,
+  MemoryFeedbackCorrectionSummaryPayload,
+  MemoryImportInputMode,
+} from '@/lib/memory-api'
+
+import {
+  IMPORT_STATUS_TEXT,
+  IMPORT_STEP_TEXT,
+  QUEUED_IMPORT_STATUS,
+  RUNNING_IMPORT_STATUS,
+} from './constants'
+
+export type DeleteOperationItem = NonNullable<MemoryDeleteOperationPayload['items']>[number]
+
+export function normalizeProgress(value: number | string | null | undefined): number {
+  const numeric = Number(value ?? 0)
+  if (!Number.isFinite(numeric)) {
+    return 0
+  }
+  if (numeric < 0) {
+    return 0
+  }
+  if (numeric > 100) {
+    return 100
+  }
+  return numeric
+}
+
+export function parseOptionalPositiveInt(input: string): number | undefined {
+  const value = input.trim()
+  if (!value) {
+    return undefined
+  }
+  const parsed = Number(value)
+  if (!Number.isInteger(parsed) || parsed <= 0) {
+    return undefined
+  }
+  return parsed
+}
+
+export function parseCommaSeparatedList(input: string): string[] {
+  return input
+    .split(',')
+    .map((item) => item.trim())
+    .filter(Boolean)
+}
+
+export function normalizeImportInputMode(value: string): MemoryImportInputMode {
+  return value === 'json' ? 'json' : 'text'
+}
+
+export function getImportStatusLabel(status: string): string {
+  const normalized = String(status ?? '').trim()
+  if (!normalized) {
+    return '-'
+  }
+  return IMPORT_STATUS_TEXT[normalized] ?? normalized
+}
+
+export function getImportStepLabel(step: string): string {
+  const normalized = String(step ?? '').trim()
+  if (!normalized) {
+    return '-'
+  }
+  return IMPORT_STEP_TEXT[normalized] ?? normalized
+}
+
+export function getImportStatusVariant(status: string): 'default' | 'secondary' | 'destructive' | 'outline' {
+  if (status === 'failed') {
+    return 'destructive'
+  }
+  if (status === 'completed') {
+    return 'default'
+  }
+  if (status === 'completed_with_errors' || status === 'cancelled') {
+    return 'secondary'
+  }
+  if (RUNNING_IMPORT_STATUS.has(status) || QUEUED_IMPORT_STATUS.has(status)) {
+    return 'outline'
+  }
+  return 'secondary'
+}
+
+export function formatImportTime(timestamp?: number | null): string {
+  if (!timestamp) {
+    return '-'
+  }
+  const normalized = timestamp > 1_000_000_000_000 ? timestamp : timestamp * 1000
+  const value = new Date(normalized)
+  if (Number.isNaN(value.getTime())) {
+    return '-'
+  }
+  return value.toLocaleString('zh-CN', {
+    hour12: false,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+  })
+}
+
+export function formatDeleteOperationMode(mode: string): string {
+  switch (mode) {
+    case 'entity':
+      return '实体'
+    case 'relation':
+      return '关系'
+    case 'paragraph':
+      return '段落'
+    case 'source':
+      return '来源'
+    case 'mixed':
+      return '混合'
+    default:
+      return mode || '未知'
+  }
+}
+
+export function formatDeleteOperationStatus(status: string): string {
+  switch (status) {
+    case 'executed':
+      return '已执行'
+    case 'restored':
+      return '已恢复'
+    default:
+      return status || '未知'
+  }
+}
+
+export function formatDeleteOperationTime(timestamp?: number | null): string {
+  if (!timestamp) {
+    return '未知时间'
+  }
+  const normalized = timestamp > 1_000_000_000_000 ? timestamp : timestamp * 1000
+  const value = new Date(normalized)
+  if (Number.isNaN(value.getTime())) {
+    return '未知时间'
+  }
+  return value.toLocaleString('zh-CN', {
+    hour12: false,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+  })
+}
+
+export function trimDeleteItemText(value: string, maxLength: number = 140): string {
+  const normalized = String(value ?? '').trim().replace(/\s+/g, ' ')
+  if (!normalized) {
+    return ''
+  }
+  if (normalized.length <= maxLength) {
+    return normalized
+  }
+  return `${normalized.slice(0, maxLength)}...`
+}
+
+export function formatDeleteRelationText(subject: string, predicate: string, object: string): string {
+  const left = String(subject ?? '').trim()
+  const middle = String(predicate ?? '').trim()
+  const right = String(object ?? '').trim()
+  return [left, middle, right].filter(Boolean).join(' -> ')
+}
+
+export function getDeleteOperationItemLabel(item: DeleteOperationItem): string {
+  const payload = item.payload ?? {}
+  if (item.item_type === 'entity') {
+    const entity = (payload.entity ?? {}) as Record<string, unknown>
+    return String(entity.name ?? item.item_key ?? item.item_hash ?? '未命名实体')
+  }
+  if (item.item_type === 'relation') {
+    const relation = (payload.relation ?? {}) as Record<string, unknown>
+    return (
+      formatDeleteRelationText(
+        String(relation.subject ?? ''),
+        String(relation.predicate ?? ''),
+        String(relation.object ?? ''),
+      ) || String(item.item_key ?? item.item_hash ?? '未命名关系')
+    )
+  }
+  if (item.item_type === 'paragraph') {
+    const paragraph = (payload.paragraph ?? {}) as Record<string, unknown>
+    const source = String(paragraph.source ?? '').trim()
+    return source || String(item.item_key ?? item.item_hash ?? '未命名段落')
+  }
+  return String(item.item_key ?? item.item_hash ?? '未命名对象')
+}
+
+export function getDeleteOperationItemPreview(item: DeleteOperationItem): string {
+  const payload = item.payload ?? {}
+  if (item.item_type === 'entity') {
+    const paragraphLinks = Array.isArray(payload.paragraph_links) ? payload.paragraph_links : []
+    if (paragraphLinks.length > 0) {
+      return `关联段落 ${paragraphLinks.length} 个`
+    }
+    return '实体快照'
+  }
+  if (item.item_type === 'relation') {
+    const relation = (payload.relation ?? {}) as Record<string, unknown>
+    const paragraphHashes = Array.isArray(payload.paragraph_hashes) ? payload.paragraph_hashes : []
+    const { confidence } = relation
+    const parts = []
+    if (paragraphHashes.length > 0) {
+      parts.push(`证据段落 ${paragraphHashes.length} 个`)
+    }
+    if (typeof confidence === 'number') {
+      parts.push(`置信度 ${confidence.toFixed(2)}`)
+    }
+    return parts.join('，') || '关系快照'
+  }
+  if (item.item_type === 'paragraph') {
+    const paragraph = (payload.paragraph ?? {}) as Record<string, unknown>
+    return trimDeleteItemText(String(paragraph.content ?? ''))
+  }
+  return ''
+}
+
+export function getDeleteOperationItemSource(item: DeleteOperationItem): string {
+  const payload = item.payload ?? {}
+  if (item.item_type === 'paragraph') {
+    const paragraph = (payload.paragraph ?? {}) as Record<string, unknown>
+    return String(paragraph.source ?? '').trim()
+  }
+  return String(payload.source ?? '').trim()
+}
+
+export function formatFeedbackDecision(decision: string): string {
+  switch (decision) {
+    case 'correct':
+      return '纠正'
+    case 'reject':
+      return '否定'
+    case 'confirm':
+      return '确认'
+    case 'supplement':
+      return '补充'
+    case 'none':
+      return '无动作'
+    default:
+      return decision || '未知'
+  }
+}
+
+export function formatFeedbackTaskStatus(status: string): string {
+  switch (status) {
+    case 'pending':
+      return '待处理'
+    case 'running':
+      return '处理中'
+    case 'applied':
+      return '已应用'
+    case 'skipped':
+      return '已跳过'
+    case 'error':
+      return '失败'
+    default:
+      return status || '未知'
+  }
+}
+
+export function formatFeedbackRollbackStatus(status: string): string {
+  switch (status) {
+    case 'none':
+      return '未回退'
+    case 'running':
+      return '回退中'
+    case 'rolled_back':
+      return '已回退'
+    case 'error':
+      return '回退失败'
+    default:
+      return status || '未知'
+  }
+}
+
+export function getFeedbackStatusVariant(
+  status: string,
+): 'default' | 'secondary' | 'destructive' | 'outline' {
+  if (status === 'applied' || status === 'rolled_back') {
+    return 'default'
+  }
+  if (status === 'error') {
+    return 'destructive'
+  }
+  if (status === 'running' || status === 'pending') {
+    return 'outline'
+  }
+  return 'secondary'
+}
+
+export function summarizeFeedbackActionPayload(value: Record<string, unknown> | undefined): string {
+  if (!value) {
+    return ''
+  }
+  const hash = String(value.hash ?? '').trim()
+  const subject = String(value.subject ?? '').trim()
+  const predicate = String(value.predicate ?? '').trim()
+  const object = String(value.object ?? '').trim()
+  if (subject && predicate && object) {
+    return formatDeleteRelationText(subject, predicate, object)
+  }
+  if (hash) {
+    return hash
+  }
+  if (Array.isArray(value.target_hashes) && value.target_hashes.length > 0) {
+    return `targets ${value.target_hashes.length}`
+  }
+  return trimDeleteItemText(JSON.stringify(value, null, 2), 120)
+}
+
+export function pickFeedbackRelationTriplet(value: unknown): Record<string, unknown> | null {
+  if (!value || typeof value !== 'object') {
+    return null
+  }
+  const record = value as Record<string, unknown>
+  const subject = String(record.subject ?? '').trim()
+  const predicate = String(record.predicate ?? '').trim()
+  const object = String(record.object ?? '').trim()
+  if (!subject || !predicate || !object) {
+    return null
+  }
+  return record
+}
+
+export function formatFeedbackRelationTriplet(value: unknown): string {
+  const triplet = pickFeedbackRelationTriplet(value)
+  if (!triplet) {
+    return ''
+  }
+  return formatDeleteRelationText(
+    String(triplet.subject ?? ''),
+    String(triplet.predicate ?? ''),
+    String(triplet.object ?? ''),
+  )
+}
+
+export function getFeedbackCorrectionPreview(
+  task: MemoryFeedbackCorrectionDetailTaskPayload | MemoryFeedbackCorrectionSummaryPayload | null,
+): {
+  headline: string
+  oldRelation: string
+  newRelation: string
+} {
+  if (!task) {
+    return {
+      headline: '当前没有纠错摘要',
+      oldRelation: '',
+      newRelation: '',
+    }
+  }
+
+  const detailTask = task as MemoryFeedbackCorrectionDetailTaskPayload
+  const rollbackPlanSummary = detailTask.rollback_plan_summary ?? {}
+  const forgottenRelations = Array.isArray(rollbackPlanSummary.forgotten_relations)
+    ? rollbackPlanSummary.forgotten_relations
+    : []
+  const correctedWrite = rollbackPlanSummary.corrected_write && typeof rollbackPlanSummary.corrected_write === 'object'
+    ? rollbackPlanSummary.corrected_write
+    : {}
+  const correctedRelations = Array.isArray((correctedWrite as Record<string, unknown>).corrected_relations)
+    ? ((correctedWrite as Record<string, unknown>).corrected_relations as unknown[])
+    : []
+
+  const oldRelation = formatFeedbackRelationTriplet(forgottenRelations[0])
+  const newRelation = formatFeedbackRelationTriplet(correctedRelations[0])
+
+  if (oldRelation && newRelation) {
+    return {
+      headline: `将“${oldRelation}”纠正为“${newRelation}”`,
+      oldRelation,
+      newRelation,
+    }
+  }
+  if (newRelation) {
+    return {
+      headline: `补充了新的纠错结论：“${newRelation}”`,
+      oldRelation: '',
+      newRelation,
+    }
+  }
+  if (oldRelation) {
+    return {
+      headline: `撤销了旧记忆关系：“${oldRelation}”`,
+      oldRelation,
+      newRelation: '',
+    }
+  }
+  return {
+    headline: task.query_text || '当前纠错没有可读摘要',
+    oldRelation: '',
+    newRelation: '',
+  }
+}
+
+export function buildFeedbackImpactSummary(
+  task: MemoryFeedbackCorrectionDetailTaskPayload | MemoryFeedbackCorrectionSummaryPayload | null,
+): string[] {
+  if (!task) {
+    return []
+  }
+
+  const counts = task.affected_counts ?? {}
+  const items: string[] = []
+  if (Number(counts.relations ?? 0) > 0) {
+    items.push(`影响关系 ${Number(counts.relations ?? 0)} 条`)
+  }
+  if (Number(counts.corrected_relations ?? 0) > 0) {
+    items.push(`新增纠正关系 ${Number(counts.corrected_relations ?? 0)} 条`)
+  }
+  if (Number(counts.correction_paragraphs ?? 0) > 0) {
+    items.push(`写入纠错段落 ${Number(counts.correction_paragraphs ?? 0)} 条`)
+  }
+  if (Number(counts.stale_paragraphs ?? 0) > 0) {
+    items.push(`标记旧段落 ${Number(counts.stale_paragraphs ?? 0)} 条`)
+  }
+  if (Number(counts.episode_sources ?? 0) > 0) {
+    items.push(`触发 Episode 修复 ${Number(counts.episode_sources ?? 0)} 个来源`)
+  }
+  if (Number(counts.profile_person_ids ?? 0) > 0) {
+    items.push(`触发 Profile 刷新 ${Number(counts.profile_person_ids ?? 0)} 个对象`)
+  }
+  return items
+}
+
+export function formatFeedbackActionType(actionType: string): string {
+  switch (actionType) {
+    case 'classification':
+      return '判定纠错'
+    case 'forget_relation':
+      return '撤销旧关系'
+    case 'mark_stale_paragraph':
+      return '标记旧段落'
+    case 'write_correction':
+      return '写入纠错'
+    case 'rollback_restore_relation':
+      return '恢复旧关系'
+    case 'rollback_delete_correction_paragraph':
+      return '隐藏纠错段落'
+    case 'rollback_revert_corrected_relation':
+      return '撤销纠正关系'
+    case 'rollback_clear_stale_mark':
+      return '清除脏段落标记'
+    case 'rollback_enqueue_episode_rebuild':
+      return '加入 Episode 修复队列'
+    case 'rollback_enqueue_profile_refresh':
+      return '加入 Profile 刷新队列'
+    case 'rollback_error':
+      return '回退失败'
+    case 'error':
+      return '处理失败'
+    case 'skip':
+      return '跳过处理'
+    default:
+      return actionType || '未知动作'
+  }
+}
+
+export function describeFeedbackActionLog(item: MemoryFeedbackActionLogPayload): string {
+  const beforeSummary = summarizeFeedbackActionPayload(item.before_payload)
+  const afterSummary = summarizeFeedbackActionPayload(item.after_payload)
+
+  switch (item.action_type) {
+    case 'classification':
+      return afterSummary ? `系统完成判定：${afterSummary}` : '系统完成纠错判定'
+    case 'forget_relation':
+      return beforeSummary ? `旧关系已失效：${beforeSummary}` : '旧关系已被标记为失效'
+    case 'mark_stale_paragraph':
+      return '旧段落已标记为待复核，后续检索会更谨慎地使用它'
+    case 'write_correction':
+      return afterSummary ? `已写入新的纠错结果：${afterSummary}` : '已写入新的纠错段落和关系'
+    case 'rollback_restore_relation':
+      return afterSummary ? `已恢复旧关系状态：${afterSummary}` : '已恢复旧关系状态'
+    case 'rollback_delete_correction_paragraph':
+      return '已隐藏这次纠错写入的段落'
+    case 'rollback_revert_corrected_relation':
+      return '已撤销纠错阶段新增的关系'
+    case 'rollback_clear_stale_mark':
+      return '已清除旧段落的待复核标记'
+    case 'rollback_enqueue_episode_rebuild':
+      return '已重新加入 Episode 修复队列'
+    case 'rollback_enqueue_profile_refresh':
+      return '已重新加入 Profile 刷新队列'
+    case 'rollback_error':
+      return item.reason || '这次回退执行失败'
+    case 'error':
+      return item.reason || '这次纠错处理失败'
+    case 'skip':
+      return item.reason || '这次纠错被跳过'
+    default:
+      return afterSummary || beforeSummary || item.reason || '记录了一条动作日志'
+  }
+}

From b132a64de60d2a0fb8a1fb47b8826971c3e37553 Mon Sep 17 00:00:00 2001
From: DrSmoothl <1787882683@qq.com>
Date: Sat, 2 May 2026 00:08:12 +0800
Subject: [PATCH 5/9] =?UTF-8?q?feat:=20=E6=9B=B4=E6=96=B0=E6=A8=A1?=
 =?UTF-8?q?=E5=9E=8B=E8=8E=B7=E5=8F=96=E9=80=BB=E8=BE=91=EF=BC=8C=E5=A4=84?=
 =?UTF-8?q?=E7=90=86=E8=BF=94=E5=9B=9E=E7=9A=84=E6=A8=A1=E5=9E=8B=E6=95=B0?=
 =?UTF-8?q?=E7=BB=84=E5=B9=B6=E6=B7=BB=E5=8A=A0=E9=89=B4=E6=9D=83=E5=A4=B4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 dashboard/src/lib/config-api.ts                          | 9 ++++++++-
 .../src/routes/config/modelProvider/ProviderForm.tsx     | 6 +++++-
 src/webui/routers/model.py                               | 5 +++++
 3 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/dashboard/src/lib/config-api.ts b/dashboard/src/lib/config-api.ts
index cfb511084e..fa4ac5dae2 100644
--- a/dashboard/src/lib/config-api.ts
+++ b/dashboard/src/lib/config-api.ts
@@ -158,7 +158,14 @@ export async function fetchProviderModels(
     endpoint,
   })
   const response = await fetchWithAuth(`/api/webui/models/list?${params}`)
-  return parseResponse<ModelListItem[]>(response)
+  // 后端返回 { success, models, provider, count }，需要展开取出 models 数组
+  const parsed = await parseResponse<{ models?: ModelListItem[] } | ModelListItem[]>(response)
+  if (!parsed.success) {
+    return parsed
+  }
+  const body = parsed.data
+  const models = Array.isArray(body) ? body : Array.isArray(body?.models) ? body.models : []
+  return { success: true, data: models }
 }
 
 /**
diff --git a/dashboard/src/routes/config/modelProvider/ProviderForm.tsx b/dashboard/src/routes/config/modelProvider/ProviderForm.tsx
index 8095caa35b..d7094ffafe 100644
--- a/dashboard/src/routes/config/modelProvider/ProviderForm.tsx
+++ b/dashboard/src/routes/config/modelProvider/ProviderForm.tsx
@@ -138,7 +138,11 @@ export function ProviderForm({
           </DialogDescription>
         </DialogHeader>
 
-        <form onSubmit={(e) => { e.preventDefault(); handleSaveEdit(); }} autoComplete="off">
+        <form
+          onSubmit={(e) => { e.preventDefault(); handleSaveEdit(); }}
+          autoComplete="off"
+          className="contents"
+        >
           <DialogBody>
           <div className="grid gap-4 py-4">
             <div className="grid gap-2" data-tour="provider-template-select">
diff --git a/src/webui/routers/model.py b/src/webui/routers/model.py
index fad701bada..2732383574 100644
--- a/src/webui/routers/model.py
+++ b/src/webui/routers/model.py
@@ -146,6 +146,11 @@ async def _fetch_models_from_provider(
         client_config = build_openai_compatible_client_config(provider)
         headers.update(client_config.default_headers)
         params.update(client_config.default_query)
+        # build_openai_compatible_client_config 在“默认 Bearer”场景下，
+        # 会把 api_key 留在 client_config.api_key 中交给 OpenAI SDK 自行注入 Authorization 头，
+        # 而不会写入 default_headers。这里我们用 httpx 直接发请求，需要手动补上鉴权头/参数。
+        if client_config.api_key and "Authorization" not in headers:
+            headers["Authorization"] = f"Bearer {client_config.api_key}"
 
     try:
         async with httpx.AsyncClient(timeout=30.0) as client:

From be79d09a07d29426dfbb7c75acd9c9b7ef6e7405 Mon Sep 17 00:00:00 2001
From: DrSmoothl <1787882683@qq.com>
Date: Sat, 2 May 2026 11:42:34 +0800
Subject: [PATCH 6/9] =?UTF-8?q?feat:=20=E6=9B=B4=E6=96=B0Sidebar=E5=92=8CD?=
 =?UTF-8?q?ialog=E7=BB=84=E4=BB=B6=EF=BC=8C=E4=BC=98=E5=8C=96=E6=A0=B7?=
 =?UTF-8?q?=E5=BC=8F=E5=92=8C=E5=B8=83=E5=B1=80=EF=BC=8C=E5=A2=9E=E5=BC=BA?=
 =?UTF-8?q?ScrollArea=E5=8A=9F=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Copilot <copilot@github.com>
---
 dashboard/src/components/layout/Sidebar.tsx |  8 +++++---
 dashboard/src/components/ui/dialog.tsx      | 12 ++++++++----
 dashboard/src/components/ui/scroll-area.tsx |  5 ++++-
 3 files changed, 17 insertions(+), 8 deletions(-)

diff --git a/dashboard/src/components/layout/Sidebar.tsx b/dashboard/src/components/layout/Sidebar.tsx
index 55392b1360..df28de669c 100644
--- a/dashboard/src/components/layout/Sidebar.tsx
+++ b/dashboard/src/components/layout/Sidebar.tsx
@@ -29,7 +29,7 @@ export function Sidebar({
   return (
     <aside
       className={cn(
-        'fixed inset-y-0 left-0 z-50 isolate flex flex-col border-r transition-all duration-300 lg:relative lg:z-0',
+        'fixed inset-y-0 left-0 z-50 isolate flex flex-col border-r transition-all duration-300 lg:relative lg:z-0 lg:h-full',
         inheritsPageBackground ? 'bg-transparent' : 'bg-card',
         // 移动端始终显示完整宽度，桌面端根据 sidebarOpen 切换
         'w-64 lg:w-auto',
@@ -46,9 +46,11 @@ export function Sidebar({
 
       <ScrollArea className={cn(
         'relative z-10',
-        "flex-1 overflow-x-hidden",
+        "min-h-0 flex-1 overflow-x-hidden",
         !sidebarOpen && "lg:w-16"
-      )}>
+      )}
+      viewportClassName="[&>div]:!block"
+      >
         <nav
           aria-label={t('a11y.sidebarNav')}
           className={cn(
diff --git a/dashboard/src/components/ui/dialog.tsx b/dashboard/src/components/ui/dialog.tsx
index 8509d08521..c140e12fd5 100644
--- a/dashboard/src/components/ui/dialog.tsx
+++ b/dashboard/src/components/ui/dialog.tsx
@@ -54,7 +54,7 @@ const DialogContent = React.forwardRef<
     <DialogPrimitive.Content
       ref={ref}
       className={cn(
-        "fixed left-[50%] top-[50%] z-50 grid w-[min(calc(100vw-2rem),var(--dialog-width,32rem))] max-h-[calc(100vh-2rem)] translate-x-[-50%] translate-y-[-50%] gap-4 overflow-hidden border bg-background p-6 shadow-lg duration-200 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[state=closed]:slide-out-to-left-1/2 data-[state=closed]:slide-out-to-top-[48%] data-[state=open]:slide-in-from-left-1/2 data-[state=open]:slide-in-from-top-[48%] sm:rounded-lg",
+        "fixed left-[50%] top-[50%] z-50 flex w-[min(calc(100vw-2rem),var(--dialog-width,32rem))] max-h-[calc(100vh-2rem)] translate-x-[-50%] translate-y-[-50%] flex-col gap-4 overflow-hidden border bg-background p-6 shadow-lg duration-200 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[state=closed]:slide-out-to-left-1/2 data-[state=closed]:slide-out-to-top-[48%] data-[state=open]:slide-in-from-left-1/2 data-[state=open]:slide-in-from-top-[48%] sm:rounded-lg",
         className
       )}
       onPointerDownOutside={preventOutsideClose ? (e) => e.preventDefault() : undefined}
@@ -94,13 +94,17 @@ const DialogContent = React.forwardRef<
 DialogContent.displayName = DialogPrimitive.Content.displayName
 
 const DialogBody = React.forwardRef<HTMLDivElement, DialogBodyProps>(
-  ({ className, children, allowHorizontalScroll = false, contentClassName, scrollbars, viewportClassName, ...props }, ref) => (
+  ({ className, children, allowHorizontalScroll = false, contentClassName, scrollbars, viewportClassName, type, ...props }, ref) => (
+    // 关键：在 flex-col 的 DialogContent 中，DialogBody 既要在内容多时撑到 max-h 上限并滚动，
+    // 又要在内容少时让 dialog 自然收缩。直接在 ScrollArea Root 上 flex-1 + min-h-0 即可：
+    // Radix Viewport 内部 wrapper 默认 display:table 会撑开自然高度，所以需要强制 block。
     <ScrollArea
       ref={ref as never}
-      className={cn("min-h-0 flex-1", className)}
+      className={cn("min-h-0 flex-1 flex flex-col", className)}
       contentClassName={cn(allowHorizontalScroll && "min-w-full w-max", contentClassName)}
       scrollbars={scrollbars ?? (allowHorizontalScroll ? "both" : "vertical")}
-      viewportClassName={cn("pr-4", viewportClassName)}
+      viewportClassName={cn("min-h-0 flex-1 pr-4 [&>div]:!block", viewportClassName)}
+      type={type ?? "always"}
       {...props}
     >
       {children}
diff --git a/dashboard/src/components/ui/scroll-area.tsx b/dashboard/src/components/ui/scroll-area.tsx
index 34f463eb94..056cccaef3 100644
--- a/dashboard/src/components/ui/scroll-area.tsx
+++ b/dashboard/src/components/ui/scroll-area.tsx
@@ -19,7 +19,10 @@ const ScrollArea = React.forwardRef<
     className={cn("relative overflow-hidden", className)}
     {...props}
   >
-    <ScrollAreaPrimitive.Viewport ref={viewportRef} className={cn("h-full w-full rounded-[inherit]", viewportClassName)}>
+    <ScrollAreaPrimitive.Viewport
+      ref={viewportRef}
+      className={cn("h-full w-full rounded-[inherit]", viewportClassName)}
+    >
       <div className={contentClassName}>{children}</div>
     </ScrollAreaPrimitive.Viewport>
     {scrollbars !== "horizontal" && <ScrollBar />}

From 91b0620b76dde3604792132e04868360c1c96fab Mon Sep 17 00:00:00 2001
From: SengokuCola <1026294844@qq.com>
Date: Sat, 2 May 2026 13:24:31 +0800
Subject: [PATCH 7/9] =?UTF-8?q?docker=EF=BC=9A=E4=B8=8D=E5=86=8D=E7=BC=96?=
 =?UTF-8?q?=E8=AF=91lpmm=EF=BC=8C=E9=80=82=E9=85=8D=E5=99=A8=E6=94=B9?=
 =?UTF-8?q?=E4=B8=BA=E6=8F=92=E4=BB=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/docker-image-dev.yml  |  6 -----
 .github/workflows/docker-image-main.yml |  6 -----
 Dockerfile                              | 35 +++++++------------------
 docker-compose.yml                      | 19 --------------
 docker-entrypoint.sh                    | 13 +++++++++
 5 files changed, 22 insertions(+), 57 deletions(-)
 create mode 100644 docker-entrypoint.sh

diff --git a/.github/workflows/docker-image-dev.yml b/.github/workflows/docker-image-dev.yml
index 63fdafee05..186a2539f5 100644
--- a/.github/workflows/docker-image-dev.yml
+++ b/.github/workflows/docker-image-dev.yml
@@ -30,9 +30,6 @@ jobs:
       # - name: Clone maim_message
       #   run: git clone https://github.com/MaiM-with-u/maim_message maim_message
 
-      - name: Clone lpmm
-        run: git clone https://github.com/Mai-with-u/MaiMBot-LPMM.git MaiMBot-LPMM
-
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
         with:
@@ -84,9 +81,6 @@ jobs:
       # - name: Clone maim_message
       #   run: git clone https://github.com/MaiM-with-u/maim_message maim_message
 
-      - name: Clone lpmm
-        run: git clone https://github.com/Mai-with-u/MaiMBot-LPMM.git MaiMBot-LPMM
-
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
         with:
diff --git a/.github/workflows/docker-image-main.yml b/.github/workflows/docker-image-main.yml
index 3d9b14abf0..498c89ac3a 100644
--- a/.github/workflows/docker-image-main.yml
+++ b/.github/workflows/docker-image-main.yml
@@ -34,9 +34,6 @@ jobs:
       # - name: Clone maim_message
       #   run: git clone https://github.com/MaiM-with-u/maim_message maim_message
 
-      - name: Clone lpmm
-        run: git clone https://github.com/Mai-with-u/MaiMBot-LPMM.git MaiMBot-LPMM
-
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
         with:
@@ -87,9 +84,6 @@ jobs:
       # - name: Clone maim_message
       #   run: git clone https://github.com/MaiM-with-u/maim_message maim_message
 
-      - name: Clone lpmm
-        run: git clone https://github.com/Mai-with-u/MaiMBot-LPMM.git MaiMBot-LPMM
-
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
         with:
diff --git a/Dockerfile b/Dockerfile
index 6061ad4409..91ad6b9940 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,44 +1,27 @@
-# 编译 LPMM
-FROM python:3.13-slim AS lpmm-builder
-COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
-
-WORKDIR /MaiMBot-LPMM
-
-# 同级目录下需要有 MaiMBot-LPMM
-COPY MaiMBot-LPMM /MaiMBot-LPMM
-
-# 安装编译器和编译依赖
-RUN apt-get update && apt-get install -y build-essential
-RUN uv pip install --system --upgrade pip
-RUN cd /MaiMBot-LPMM && uv pip install --system -r requirements.txt
-
-# 编译 LPMM
-RUN cd /MaiMBot-LPMM/lib/quick_algo && python build_lib.py --cleanup --cythonize --install
-
-# 运行环境
+# Runtime image
 FROM python:3.13-slim
 COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 
-# 工作目录
+# Working directory
 WORKDIR /MaiMBot
 
 ENV MAIBOT_LEGACY_0X_UPGRADE_CONFIRMED=1
 
-# 复制依赖列表
+# Copy dependency list
 COPY requirements.txt .
 
 RUN apt-get update && apt-get install -y git
 
-# 从编译阶段复制 LPMM 编译结果
-COPY --from=lpmm-builder /usr/local/lib/python3.13/site-packages/ /usr/local/lib/python3.13/site-packages/
-
-# 安装运行时依赖
+# Install runtime dependencies
 RUN uv pip install --system --upgrade pip
 RUN uv pip install --system -r requirements.txt
 
-# 复制项目代码
+# Copy project source
 COPY . .
 
+RUN git clone --depth 1 --branch plugin https://github.com/Mai-with-u/MaiBot-Napcat-Adapter.git plugin-templates/MaiBot-Napcat-Adapter
+RUN chmod +x docker-entrypoint.sh
+
 EXPOSE 8000
 
-ENTRYPOINT [ "python","bot.py" ]
+ENTRYPOINT [ "./docker-entrypoint.sh" ]
diff --git a/docker-compose.yml b/docker-compose.yml
index 5602ae65e2..111d81293d 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,22 +1,4 @@
 services:
-  adapters:
-    container_name: maim-bot-adapters
-    #### prod ####
-    image: unclas/maimbot-adapter:latest
-    # image: infinitycat/maimbot-adapter:latest
-    #### dev ####
-    # image: unclas/maimbot-adapter:dev
-    # image: infinitycat/maimbot-adapter:dev
-    environment:
-      - TZ=Asia/Shanghai
-#    ports:
-#      - "8095:8095"
-    volumes:
-      - ./docker-config/adapters/config.toml:/adapters/config.toml # 持久化adapters配置文件
-      - ./data/adapters:/adapters/data # adapters 数据持久化
-    restart: always
-    networks:
-      - maim_bot
   core:
     container_name: maim-bot-core
     #### prod ####
@@ -36,7 +18,6 @@ services:
     volumes:
       # 监听地址和端口已迁移到 ./docker-config/mmc/bot_config.toml 的 maim_message 与 webui 配置段
       - ./docker-config/mmc:/MaiMBot/config # 持久化bot配置文件
-      - ./docker-config/adapters:/MaiMBot/adapters-config # adapter配置文件夹映射
       - ./data/MaiMBot/maibot_statistics.html:/MaiMBot/maibot_statistics.html #统计数据输出
       - ./data/MaiMBot:/MaiMBot/data # 共享目录
       - ./data/MaiMBot/plugins:/MaiMBot/plugins # 插件目录
diff --git a/docker-entrypoint.sh b/docker-entrypoint.sh
new file mode 100644
index 0000000000..c439e9a868
--- /dev/null
+++ b/docker-entrypoint.sh
@@ -0,0 +1,13 @@
+#!/bin/sh
+set -eu
+
+ADAPTER_TEMPLATE="/MaiMBot/plugin-templates/MaiBot-Napcat-Adapter"
+ADAPTER_TARGET="/MaiMBot/plugins/MaiBot-Napcat-Adapter"
+
+mkdir -p /MaiMBot/plugins
+
+if [ ! -e "$ADAPTER_TARGET" ] && [ -d "$ADAPTER_TEMPLATE" ]; then
+    cp -a "$ADAPTER_TEMPLATE" "$ADAPTER_TARGET"
+fi
+
+exec python bot.py "$@"

From 8d3c58da7a121b354885948dd8d3f1350e54a579 Mon Sep 17 00:00:00 2001
From: DrSmoothl <1787882683@qq.com>
Date: Sat, 2 May 2026 13:48:04 +0800
Subject: [PATCH 8/9] =?UTF-8?q?feat:=20=E6=9B=B4=E6=96=B0maibot-dashboard?=
 =?UTF-8?q?=E7=89=88=E6=9C=AC=E8=87=B31.0.1.dev2026050251?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 3ebfed3fa0..dd389eef94 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -19,7 +19,7 @@ dependencies = [
     "jieba>=0.42.1",
     "json-repair>=0.47.6",
     "maim-message>=0.6.2",
-    "maibot-dashboard==1.0.0.dev2026040439",
+    "maibot-dashboard==1.0.1.dev2026050251",
     "maibot-plugin-sdk>=2.3.0",
     "matplotlib>=3.10.5",
     "mcp",

From fe231af19e60a39cc2fb3ae5b08ea71685602386 Mon Sep 17 00:00:00 2001
From: SengokuCola <1026294844@qq.com>
Date: Sat, 2 May 2026 14:17:53 +0800
Subject: [PATCH 9/9] Update docker-compose.yml

---
 docker-compose.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docker-compose.yml b/docker-compose.yml
index 111d81293d..9e71c76f80 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -9,6 +9,8 @@ services:
     # image: infinitycat/maibot:dev
     environment:
       - TZ=Asia/Shanghai
+      - EULA_AGREE=1b662741904d7155d1ce1c00b3530d0d
+      - PRIVACY_AGREE=9943b855e72199d0f5016ea39052f1b6
       - MAIBOT_LEGACY_0X_UPGRADE_CONFIRMED=1 # Docker 无法交互确认旧版升级迁移，默认跳过确认提示
 #      - EULA_AGREE=1b662741904d7155d1ce1c00b3530d0d # 同意EULA
 #      - PRIVACY_AGREE=9943b855e72199d0f5016ea39052f1b6 # 同意EULA