Merge pull request #1813 from Mai-with-u/dev

1.0.3 发布准备

Author: SengokuCola

changelogs/changelog.md

@@ -2,6 +2,32 @@
 
 测试版更新日志见 [changelog_dev.md](changelog_dev.md)。
 
+# [1.0.3] - 2026-6-14
+
+## 用户感知功能侧
+
+### Maisaka
+
+- 新增聊天配置“自身消息特殊标注”，会在上下文中更明确标出麦麦自己发送的消息，减少模型把自己说过的话认成其他用户发言的情况。
+- 优化中期记忆与 Maisaka 上下文处理，减少无关历史消息进入回复链路，让长对话中的上下文引用更稳定。
+- 优化行为学习的场景匹配、反馈沉淀与行为参考表达，让麦麦更容易复用有效经验，并降低行为参考对回复风格的干扰。
+
+### WebUI / Dashboard
+
+- 聊天页新增头像缓存与展示支持，聊天列表、顶部栏和消息流会更稳定地显示用户与聊天对象头像。
+- 推理过程页面增强记录筛选、动作筛选、结构化 prompt 展示、工具调用折叠和消息头像映射，排查回复过程时更容易定位关键上下文。
+- 插件详情页 README 加载体验优化，切换插件时内容刷新更稳定；复古主题底纹显示效果也做了微调。
+
+## 开发侧 / 修复
+
+### WebUI 架构
+
+- WebUI 多个页面继续下沉页面状态与数据请求逻辑，统一 API 抛错契约，并补充关键页面的特征化测试；这部分主要是内部架构整理，对用户功能入口影响较小。
+
+### 调试与实验
+
+- 新增行为学习相关离线 abtest 脚本，用于对比场景 embedding 匹配、学习合并与摘要字段效果，方便后续继续调优行为系统。
+
 # [1.0.2] - 2026-6-13
 
 ## 用户感知功能侧

dashboard/CONTEXT.md

@@ -43,6 +43,26 @@ _Avoid_: ApiResponse（迁移期遗留的判别联合，最终淘汰）
 对服务端集合的「分页 + 搜索 + 筛选 + 多选」视图，由 `useDataList` hook 统一承载。hook 内部包一个列表 **查询**（queryKey 从分页/搜索/筛选状态派生），对外给出 items/total 与全部控件状态；筛选/搜索/翻页变化时自动重置页码并清空选中集。对话框与具体渲染（表格/卡片）留在各页面，不进 hook。
 _Avoid_: 列表容器、表格组件（DataList 是状态/数据 hook，不是 UI 组件）
 
+### 页面逻辑下沉
+
+**领域 hook（Domain Hook）**：
+从巨型页面抽出的、承载某一 tab/领域完整状态机（state + 副作用 + API）的 hook；抽出后页面/tab 退化为消费 hook 的展示层。读多的服务端态走 TanStack Query，本地草稿态留在 hook 内。
+
+**导入队列（useImportQueue）**：
+知识库导入任务的服务端态领域 hook——任务列表、详情、取消/重试。列表用 useQuery；进度更新以 WebSocket 推送（`memoryProgressClient`）为主，轮询仅在 WS 断线时兜底。
+
+**导入表单（useImportForm）**：
+知识库导入创建的本地草稿领域 hook——7 种导入模式的参数 + 提交。参数默认值在 `importSettings` 首次到达时 seed 一次，之后用户编辑始终生效。
+
+**待定操作（usePendingOperation）**：
+「submit 待定 → 对话框确认 → 执行」同构流程的通用模块（embedding 换模型、向量重建预览、删除预览均属此类）；提供 submit/confirm/cancel/pending，替代散落的 `pendingXxxRef + dialogOpen` 双 state。
+
+**配置表单编排（useConfigForm）**：
+「并行加载配置 + schema → seed 可编辑草稿 → 脏跟踪」这条配置编辑脊梁的通用模块。内部自持两个**查询**——config（必需，驱动草稿）与 schema（可选，仅供渲染字段，失败不阻塞）；以 config 查询的 `dataUpdatedAt` 作版本标记在**渲染期**重置草稿（规避 effect 内 setState），是本模块的核心 leverage。对外给出 `draft/schema/setDraft/isDirty/reset/reload/isLoading/error`；`isDirty` 用 `JSON.stringify(draft) !== seededSnapshot`。**保存、自动保存、源码(raw)模式、级联删除留在各页面**，不进 hook。
+
+**当前仅 mcp-settings 接入**（单节草稿 + 手动保存，干净全适配）。落地时发现其余配置页均非干净适配，暂不强接：config/bot 是 24 个分节草稿 + 按节 autosave + 手动 `hasUnsavedChanges`（单快照 isDirty 无法表达"已 autosave 的节"，且并节为单 TDraft 是无测试页上的大改）；plugin-config 是 visual config + source raw 双草稿、mode-dependent dirty（useConfigForm 只能覆盖 config+schema，raw 仍要重复 seed 模式）；config/model 多草稿 + 按草稿快照，由 `useModelConfig` 承载。按"两个适配器才算真 seam"，本模块暂为单适配器（假设性 seam），待下一个"单节草稿 + 手动保存"配置页出现再坐实。
+_Avoid_: 把保存/autosave/raw/第二草稿塞进来变成开关汤（那会让它退化为浅壳，删除测试不通过）；为凑适配器把 bot/plugin 强接成部分适配
+
 ### 配置与设置
 
 **配置（Config）**：

dashboard/package.json

@@ -1,7 +1,7 @@
 {
   "name": "maibot-dashboard",
   "private": true,
-  "version": "1.4.2",
+  "version": "1.4.3",
   "type": "module",
   "main": "./out/main/index.js",
   "scripts": {

dashboard/src/components/expression-reviewer.tsx

@@ -136,19 +136,11 @@ export function ExpressionReviewer({
   const loadStats = useCallback(async () => {
     try {
       const result = await getReviewStats()
-      if (result.success) {
-        setStats(result.data)
-      } else {
-        toast({
-          title: '错误',
-          description: result.error,
-          variant: 'destructive',
-        })
-      }
+      setStats(result)
     } catch (error) {
       console.error('加载统计失败:', error)
     }
-  }, [toast])
+  }, [])
 
   // 加载列表
   const loadList = useCallback(async () => {
@@ -160,16 +152,8 @@ export function ExpressionReviewer({
         filter_type: filterType,
         search: search || undefined,
       })
-      if (result.success) {
-        setExpressions(result.data.data)
-        setTotal(result.data.total)
-      } else {
-        toast({
-          title: '加载失败',
-          description: result.error,
-          variant: 'destructive',
-        })
-      }
+      setExpressions(result.data)
+      setTotal(result.total)
     } catch (error) {
       toast({
         title: '加载失败',
@@ -185,13 +169,11 @@ export function ExpressionReviewer({
   const loadChatNames = useCallback(async () => {
     try {
       const result = await getChatList()
-      if (result.success) {
-        const nameMap = new Map<string, string>()
-        result.data.forEach((chat: ChatInfo) => {
-          nameMap.set(chat.chat_id, chat.chat_name)
-        })
-        setChatNameMap(nameMap)
-      }
+      const nameMap = new Map<string, string>()
+      result.forEach((chat: ChatInfo) => {
+        nameMap.set(chat.chat_id, chat.chat_name)
+      })
+      setChatNameMap(nameMap)
     } catch (error) {
       console.error('加载聚天名称失败:', error)
     }
@@ -214,34 +196,26 @@ export function ExpressionReviewer({
           exclude_ids: excludedIds.length > 0 ? excludedIds : undefined,
         })
 
-        if (result.success) {
-          if (append) {
-            const loadedCount = quickExpressionsRef.current.length
-            const existingIds = new Set(quickExpressionsRef.current.map((e) => e.id))
-            const newItems = result.data.data.filter((e: Expression) => !existingIds.has(e.id))
-            newItems.forEach((expr: Expression) => quickExcludedIdsRef.current.add(expr.id))
-
-            setQuickExpressions((prev) => [...prev, ...newItems])
-            setQuickTotal(loadedCount + result.data.total)
-            setQuickHasMore(newItems.length > 0 && result.data.total > newItems.length)
-          } else {
-            quickExcludedIdsRef.current = new Set(
-              result.data.data.map((expr: Expression) => expr.id)
-            )
-            setQuickExpressions(result.data.data)
-            setQuickTotal(result.data.total)
-            setQuickHasMore(result.data.total > result.data.data.length)
-          }
-
-          if (resetIndex) {
-            setQuickCurrentIndex(0)
-          }
+        if (append) {
+          const loadedCount = quickExpressionsRef.current.length
+          const existingIds = new Set(quickExpressionsRef.current.map((e) => e.id))
+          const newItems = result.data.filter((e: Expression) => !existingIds.has(e.id))
+          newItems.forEach((expr: Expression) => quickExcludedIdsRef.current.add(expr.id))
+
+          setQuickExpressions((prev) => [...prev, ...newItems])
+          setQuickTotal(loadedCount + result.total)
+          setQuickHasMore(newItems.length > 0 && result.total > newItems.length)
         } else {
-          toast({
-            title: '加载失败',
-            description: result.error,
-            variant: 'destructive',
-          })
+          quickExcludedIdsRef.current = new Set(
+            result.data.map((expr: Expression) => expr.id)
+          )
+          setQuickExpressions(result.data)
+          setQuickTotal(result.total)
+          setQuickHasMore(result.total > result.data.length)
+        }
+
+        if (resetIndex) {
+          setQuickCurrentIndex(0)
         }
       } catch (error) {
         toast({
@@ -324,16 +298,7 @@ export function ExpressionReviewer({
           },
         ])
 
-        if (!result.success) {
-          toast({
-            title: '操作失败',
-            description: result.error,
-            variant: 'destructive',
-          })
-          return
-        }
-
-        if (result.data.results[0]?.success) {
+        if (result.results[0]?.success) {
           toast({
             title: approved ? '已通过' : '已删除',
             description: `表达方式 #${currentExpr.id} ${approved ? '已通过' : '已删除'}`,
@@ -676,16 +641,7 @@ export function ExpressionReviewer({
         { id, approved, require_unchecked: filterType === 'unchecked' },
       ])
 
-      if (!result.success) {
-        toast({
-          title: '操作失败',
-          description: result.error,
-          variant: 'destructive',
-        })
-        return
-      }
-
-      if (result.data.results[0]?.success) {
+      if (result.results[0]?.success) {
         toast({
           title: approved ? '已通过' : '已删除',
           description: `表达方式 #${id} ${approved ? '已通过' : '已删除'}`,
@@ -697,7 +653,7 @@ export function ExpressionReviewer({
       } else {
         toast({
           title: '操作失败',
-          description: result.data.results[0]?.message || '未知错误',
+          description: result.results[0]?.message || '未知错误',
           variant: 'destructive',
         })
       }
@@ -738,19 +694,10 @@ export function ExpressionReviewer({
 
       const result = await batchReviewExpressions(items)
 
-      if (!result.success) {
-        toast({
-          title: '批量审核失败',
-          description: result.error,
-          variant: 'destructive',
-        })
-        return
-      }
-
       toast({
         title: '批量审核完成',
-        description: `成功 ${result.data.succeeded} 条，失败 ${result.data.failed} 条`,
-        variant: result.data.failed > 0 ? 'destructive' : 'default',
+        description: `成功 ${result.succeeded} 条，失败 ${result.failed} 条`,
+        variant: result.failed > 0 ? 'destructive' : 'default',
       })
 
       // 清空选择并刷新

dashboard/src/components/layout/use-menu-sections.ts

@@ -42,8 +42,8 @@ export function useMenuSections(): MenuSection[] {
     const refreshFeatureFlags = () => {
       getBotConfigCached()
         .then((result) => {
-          if (!cancelled && result.success) {
-            setFeatureFlags(resolveMenuFeatureFlags(result.data ?? null))
+          if (!cancelled) {
+            setFeatureFlags(resolveMenuFeatureFlags(result ?? null))
           }
         })
         .catch(() => {

dashboard/src/components/search-dialog.tsx

@@ -157,7 +157,8 @@ export function SearchDialog({ open, onOpenChange }: SearchDialogProps) {
     let cancelled = false
 
     const loadConfigSearchItems = async () => {
-      const [botSchemaResult, modelSchemaResult] = await Promise.all([
+      // 用 allSettled：任一 schema 失败仍以另一 schema 建立搜索索引（保留原 best-effort 行为）
+      const [botSchemaResult, modelSchemaResult] = await Promise.allSettled([
         getBotConfigSchema(),
         getModelConfigSchema(),
       ])
@@ -167,8 +168,8 @@ export function SearchDialog({ open, onOpenChange }: SearchDialogProps) {
       }
 
       const nextItems: SearchItem[] = []
-      if (botSchemaResult.success) {
-        const botSchema = unwrapConfigSchema(botSchemaResult.data)
+      if (botSchemaResult.status === 'fulfilled') {
+        const botSchema = unwrapConfigSchema(botSchemaResult.value)
         if (botSchema) {
           nextItems.push(...collectConfigFields(
             botSchema,
@@ -179,8 +180,8 @@ export function SearchDialog({ open, onOpenChange }: SearchDialogProps) {
           ))
         }
       }
-      if (modelSchemaResult.success) {
-        const modelSchema = unwrapConfigSchema(modelSchemaResult.data)
+      if (modelSchemaResult.status === 'fulfilled') {
+        const modelSchema = unwrapConfigSchema(modelSchemaResult.value)
         if (modelSchema) {
           nextItems.push(...collectConfigFields(
             modelSchema,

dashboard/src/components/theme-provider.tsx

@@ -106,11 +106,7 @@ export function ThemeProvider({
 
     try {
       const result = await getBotConfig()
-      if (!result.success) {
-        return
-      }
-
-      const webuiConfig = result.data.webui as Record<string, unknown> | undefined
+      const webuiConfig = result.webui as Record<string, unknown> | undefined
       if (!webuiConfig || !('webui_style' in webuiConfig)) {
         return
       }
@@ -130,10 +126,7 @@ export function ThemeProvider({
     pendingWebUIStyleRef.current = webuiStyle
 
     try {
-      const result = await updateBotConfigSection('webui', { webui_style: webuiStyle })
-      if (!result.success) {
-        console.warn('保存 WebUI 风格配置失败:', result.error)
-      }
+      await updateBotConfigSection('webui', { webui_style: webuiStyle })
     } catch (error) {
       console.warn('保存 WebUI 风格配置失败:', error)
     } finally {