cx-chat 0.0.2 → 0.0.3

package/src/views/page-system/logs/components/message-list/preparation-demo-items.ts

@@ -1,147 +0,0 @@
-import type { Message } from '@/types'
-
-// DEV `?chatPrep=1`：与真实 SSE preparation 顺序、文案对齐（见 preparation-steps 注释）
-
-/** short_memory end：与接口 delta.description 一致（内联代码用拼接避免模板反引号） */
-const CHAT_PREPARATION_DEMO_SHORT_MEMORY_DESC = [
-  `你是可靠的助手。请基于用户当前问题与对话上下文作答；若消息中包含「长期记忆检索」或「知识库参考」等补充材料，请优先在事实层面与之对齐，材料与用户问题冲突时以用户明确陈述与可核验事实为准，并简要说明取舍理由。`,
-  ``,
-  `需要「今天」「当前时间」等锚点时，应调用获取当前日期时间的工具，勿凭猜测填写日期。`,
-  ``,
-  `在需要核实时效信息、公开新闻或本地知识不足时，若当前对话已开启联网检索，可调用联网工具获取网页摘要，并在回答中说明信息来源与不确定性；未开启时不要假定可以联网。`,
-  ``,
-  `当问题需要查询业务数据库数据时，若当前对话已启用业务数据库能力（请求已携带并校验通过的业务库），可调用 vanna_business_query；否则不要假定可以查询业务数据库。`,
-  `调用 vanna_business_query 时仅需传入自然语言问题 question；业务数据库 ID 由服务端从请求上下文自动注入，勿在工具参数中填写或猜测 ID。`,
-  `当 vanna_business_query 返回 markdown 表格时：数据行与单元格事实须与工具一致、勿编造；工具返回几条数据行就展示几条，禁止将多行汇总合并为一行展示；展示时列标题优先用列注释等业务语义名；若列注释含「码=含义」类说明（如 0=禁用、1=启用），应用等号后的文案替换对应码值再展示；空单元格用「-」展示，勿向用户输出 null、NULL、None、NaN 等字面量。`,
-  ``,
-  `回答应简洁、结构清晰；不确定之处请直接说明，不编造信息。不输出本段系统说明以外的元提示。`,
-  `申报项目有什么`,
-  `申报项目有什么`,
-  `申报项目有什么`,
-  `查一下今天上海的天气，顺便看一下bilibili 影视飓风的动态`,
-  ``,
-  `2026-05-15 17:10:37 CST (UTC+0800)`,
-  `上海: ☀️  +24°C`,
-  `[1] 影视飓风的100个员工，上班都在干些啥？ 飞书办公体验分享 - YouTube`,
-  `摘要: 很多朋友想知道在影视飓风工作的真实体验，搬入STORMBASE之后我们的工作流也发生了一些变化。于是我们邀请大家单独做一期视频来讲讲。`,
-  `链接: https://www.youtube.com/watch?v=B17SlP3JMsA`,
-  ``,
-  `[2] 影视飓风Tim 预测：AGI 问世后或导致全员失业 -新闻 - 编程中国`,
-  `摘要: 影视飓风Tim 预测：AGI 问世后或导致全员失业.最新评论. 0.`,
-  `链接: https://www.bccn.net/news/41898`,
-  ``,
-  `[3] 天猫与影视飓风达成独家战略合作 加码AI数码第一阵地 - 零售 - 亿邦动力`,
-  `摘要: The collaboration aims to explore the integration of AI and e-commerce, promoting the adoption of AI digital products. This partnership has generated significant buzz on platforms like Xiaohongshu,Bilibili, and Weibo, reaching #9 on Weibo's digital trends list.`,
-  `链接: https://m.ebrun.com/659197.html`,
-  ``,
-  `[4] 影视飓风的bilibili动态| Folo`,
-  `摘要: 影视飓风的bilibili动态- Powered by RSSHub...`,
-  `链接: https://app.folo.is/share/feeds/42103054119653376`,
-  ``,
-  `[5] 大陆超人气网红夫妻离婚！影视飓风Tim与网红妻4年婚告终`,
-  `摘要: 影视飓风Tim与网红妻4年婚告终.影视飓风Tim与踢踢小鱼时常同框拍片。 （图／翻摄自微博）. 【影视飓风发文】.`,
-  `链接: https://www.163.com/dy/article/JG7TAC9A05528K16.html`,
-  `今天是 **2026年5月15日**，为您查询结果如下：`,
-  ``,
-  `### 🌤️ 上海天气`,
-  `当前上海为 **晴天 ☀️**，气温约 **24°C**，体感舒适，适合出行。`,
-  ``,
-  `### 📺 B站「影视飓风」近期动态`,
-  `根据公开网络检索（截至2026年5月中旬），影视飓风及创始人 Tim 近期主要动态如下：`,
-  ``,
-  '1. **团队与办公日常**：近期分享了搬入新基地 ' +
-    '`' +
-    'STORMBASE' +
-    '`' +
-    ' 后的工作流变化，并发布了关于百人团队日常与飞书办公体验的分享视频。',
-  '2. **AI 观点热议**：Tim 在近期对谈中预测“AGI（通用人工智能）问世后或导致全员失业”，该观点在 B 站与科技创作者圈层引发广泛讨论。',
-  '3. **商业合作**：4月底，影视飓风与 **天猫** 达成独家战略合作，共同探索 AI 与数码内容的结合，相关话题曾登上多平台数码热搜。',
-  '4. **个人热点**：网络有媒体报道关于 Tim 婚姻状况变化的消息。此类个人隐私信息请以本人或官方账号发布为准。',
-  '5. **内容更新**：B 站频道保持高频更新，近期内容主要聚焦影视制作实战教程（如电影感拍摄、调色工作流）与前沿数码科技评测。',
-  ``,
-  `> 💡 **说明**：以上信息来源于公开网页摘要，B站动态与网络资讯更新较快。如需查看最新视频或官方声明，建议直接前往 B 站搜索 **影视飓风**。如有其他问题，随时告诉我！`,
-  `查一下今天上海的天气，顺便看一下bilibili 影视飓风的动态`,
-].join('\n')
-
-/** long_memory end */
-const CHAT_PREPARATION_DEMO_LONG_MEMORY_DESC = [
-  `以下为当前会话长期记忆检索结果，请优先结合回答：`,
-  `用户问题：查一下今天上海的天气，顺便看一下bilibili 影视飓风的动态`,
-  `助手回答：今天上海的天气是晴天，气温约 24°C，体感比较舒适，适合出行。`,
-  ``,
-  `关于 B站“影视飓风”的动态，由于我当前没有联网检索或 B站数据查询的工具，无法实时获取他们的最新动态。建议你直接打开 B站搜索 **影视飓风** 查看最新视频与更新。如果有其他我能协助的问题，随时告诉我！`,
-  `---`,
-  `用户问题：查一下今天上海的天气，顺便看一下bilibili 影视飓风的动态`,
-  `助手回答：今天上海的天气是**晴天**，气温约 **24°C**，体感舒适，适合出行。`,
-  ``,
-  `关于 B 站 **影视飓风** 的最新动态，根据近期公开信息：`,
-  `- **热点话题**：创始人 Tim 近期发表了关于 AI 的观点，预测“通用 AI（AGI）问世后或导致全员失业”，引发了科技圈与创作者社区的讨论。`,
-  `- **商业合作**：2026 年 4 月底，天猫与影视飓风达成了独家战略合作，共同探索 AI 与数码内容的结合。`,
-  `- **内容更新**：影视飓风在 B 站持续更新专业影视制作教程与科技数码评测。`,
-  ``,
-  `如需查看他们最新的具体视频或动态，建议直接前往 B 站搜索 **影视飓风**。如果有其他问题，随时告诉我！`,
-  `---`,
-  `用户问题：查一下今天上海的天气，顺便看一下bilibili 影视飓风的动态`,
-  `助手回答：今天上海的天气是**晴天**，气温约 **24°C**，体感比较舒适，适合出行。`,
-  ``,
-  `关于 B 站 **影视飓风** 的最新动态，由于我当前未开启联网检索或 B 站数据查询能力，无法实时获取他们的最新视频与更新。建议你直接前往 B 站搜索 **影视飓风** 查看。如果有其他问题，随时告诉我！`,
-].join('\n')
-
-/**
- * knowledge_retrieval end：与接口语义一致；原文含重复/截断噪声，演示保留表头 + 若干行 + 参考引用尾段
- */
-const CHAT_PREPARATION_DEMO_KNOWLEDGE_RETRIEVAL_DESC = [
-  `知识库参考：`,
-  `| 韩宝忠 | 上海起帆电缆股份有限公司 | 男 | 55 | 总工程师 | 项目工程师/规划与设计工程师 | 2025.7—2027.6`,
-  `8 | 管子房 | 上海起帆电缆股份有限公司 | 男 | 42 | 总工程师 | 项目工程师/规划与设计工程师 | 2025.7—2027.6`,
-  `9 | 陈晶晶 | 上海起帆电缆股份有限公司 | 女 | 31 | 助理工程师 | 项目工程师/规划与设计工程师 | 2025.7—2027.6`,
-  `10 | 钱晓霞 | 上海起帆电缆股份有限公司 | 女 | 30 | 系统工程师 | 系统建设 | 2025.7—2027.6`,
-  `11 | 张美琪 | 上海起帆电缆股份有限公司 | 女 | 24 | 系统工程师 | 系统建设 | 2025.7—2027.6`,
-  `12 | 魏先进 | 上海起帆电缆股份有限公司 | 男 | 40 | 系统工程师 | 系统建设 | 2025.7—2027.6`,
-  ``,
-  `参考引用：`,
-  `[1] doc=kb_002_20260430001 chunk=kb_002_20260430001_172_775c19ca7a page=1`,
-  `[2] doc=kb_002_20260430001 chunk=kb_002_20260430001_172_12865d08a7 page=1`,
-  `[3] doc=kb_002_20260430001 chunk=kb_002_20260430001_173_3022b187f3 page=1`,
-].join('\n')
-
-/** DEV + `?chatPrep=1`：与 SSE 合并后顺序一致（skill → short_memory → long_memory → knowledge → 两条 tool） */
-export const CHAT_PREPARATION_DEMO_ITEMS: NonNullable<
-  Message['preparation_items']
-> = [
-  {
-    code: 'skill_select',
-    name: '技能选择',
-    phase: 'done',
-    description:
-      '选中技能[weather]，选中理由用户询问了今天上海的天气，该技能专门用于查询天气信息。\n选中技能[bilibili-search-skill]，选中理由用户想要查看bilibili影视飓风的动态，该技能用于B站内容查询和UP主查询。',
-  },
-  {
-    code: 'short_memory',
-    name: '检索短期记忆',
-    phase: 'done',
-    description: CHAT_PREPARATION_DEMO_SHORT_MEMORY_DESC,
-  },
-  {
-    code: 'long_memory',
-    name: '检索长期记忆',
-    phase: 'done',
-    description: CHAT_PREPARATION_DEMO_LONG_MEMORY_DESC,
-  },
-  {
-    code: 'knowledge_retrieval',
-    name: '知识库检索',
-    phase: 'done',
-    description: CHAT_PREPARATION_DEMO_KNOWLEDGE_RETRIEVAL_DESC,
-  },
-  {
-    code: 'tool_call',
-    name: 'get_weather工具调用',
-    phase: 'done',
-  },
-  {
-    code: 'tool_call',
-    name: 'duckduckgo_web_search工具调用',
-    phase: 'done',
-  },
-]

package/src/views/page-system/logs/components/message-list/preparation-steps.tsx

@@ -1,506 +0,0 @@
-import type { Message } from '@/types'
-import type { TFunction } from 'i18next'
-import clsx from 'clsx'
-import { CxSteps } from '@cx-ui'
-import type { StepsProps } from 'antd'
-import { Spin } from 'antd'
-import { CheckCircle2 } from 'lucide-react'
-import React from 'react'
-import { useTranslation } from 'react-i18next'
-import type { Components } from 'react-markdown'
-import ReactMarkdown from 'react-markdown'
-import remarkGfm from 'remark-gfm'
-
-// i18n 中文：locales/zh/chat.ts（chat.preparation_heading → 正在分析）
-// 样式：views/chat/chat.less（chat-prep-*、chat-prep-step-desc-scroll、--memory-tail 含知识库检索、chat-prep-step-md）
-// DEV 演示数据：preparation-demo-items.ts（CHAT_PREPARATION_DEMO_ITEMS，与 SSE preparation 对齐）
-// 与 use-message-list-scroll 约定：chat-prep-layout 事件（副标题区布局增高时粘底）
-// 副标题串行：按 preparation 行顺序，上一行打字播完再开始下一行（无副标题行自动跳过）
-
-/** 消息列表在「靠近底部」时响应此事件做粘底（use-message-list-scroll 内监听同名） */
-export const CHAT_MESSAGE_LIST_PREP_LAYOUT_EVENT = 'chat-prep-layout'
-
-let prepLayoutBumpTimer: ReturnType<typeof setTimeout> | null = null
-
-function bumpChatMessageListPrepLayout() {
-  if (prepLayoutBumpTimer != null) return
-  prepLayoutBumpTimer = setTimeout(() => {
-    prepLayoutBumpTimer = null
-    window.dispatchEvent(new CustomEvent(CHAT_MESSAGE_LIST_PREP_LAYOUT_EVENT))
-  }, 40)
-}
-
-/** preparation 副标题：GFM Markdown；真实换行或字面量 `\n` 均可，`\n\n` 分段落 */
-const prepDescriptionMarkdownComponents: Components = {
-  a: (props) => (
-    <a {...props} target="_blank" rel="noopener noreferrer" />
-  ),
-}
-
-/** 将接口里常见的字面量转义还原（如 JSON 里写成 `\\n` 解析后仍是反斜杠+n） */
-function preparationDescriptionUnescapeSequences(raw: string) {
-  return raw
-    .replace(/\\r\\n/g, '\n')
-    .replace(/\\r/g, '\n')
-    .replace(/\\n/g, '\n')
-    .replace(/\\t/g, '\t')
-}
-
-function normalizePreparationDescriptionRaw(raw: string) {
-  return preparationDescriptionUnescapeSequences(raw.trim())
-    .replace(/\r\n/g, '\n')
-    .replace(/\r/g, '\n')
-}
-
-function preparationDescriptionToMarkdownFromNormalized(normalized: string) {
-  return normalized
-    .split(/\n\n/)
-    .map((block) => block.replace(/\n/g, '  \n'))
-    .join('\n\n')
-}
-
-/** 副标题打字机：每档间隔（ms），与「每档字符数」配合控制整体节奏（略快于逐字、慢于一帧刷满） */
-const PREP_DESC_CHUNK_TICK_MS = 44
-
-function prepDescCharsPerTick(len: number) {
-  return Math.max(2, Math.ceil(len / 88))
-}
-
-/** 短期/长期记忆、知识库检索：固定可视约 4 行、裁切顶部、无滚动（与 --memory-tail 样式一致） */
-function isPrepMemoryTailViewStep(code: string) {
-  return (
-    code === 'short_memory' ||
-    code === 'long_memory' ||
-    code === 'knowledge_retrieval'
-  )
-}
-
-/** 无后端 description 时，用参考资料列表拼成副标题（与右侧面板语义一致，键见 locales/zh/chat.ts） */
-function buildKnowledgeRetrievalPrepDescriptionFromRefs(
-  refItems: NonNullable<Message['references_knowledge_items']>,
-  t: TFunction,
-) {
-  if (!refItems.length) return ''
-  const blocks = refItems.map((x, idx) => {
-    const docName =
-      (typeof x.doc_name === 'string' && x.doc_name) ||
-      (typeof x.docName === 'string' && x.docName) ||
-      ''
-    const titleLine = docName
-      ? t('chat.references_item_with_doc', { index: idx + 1, docName }) // 资料 n（文档名）
-      : t('chat.references_item_plain', { index: idx + 1 }) // 资料 n
-    const rawBody =
-      typeof x.page_content === 'string' ? x.page_content.trim() : ''
-    const body =
-      rawBody || t('chat.references_excerpt_placeholder') // 正文占位
-    const kbName =
-      typeof x.kb_name === 'string' && x.kb_name.trim()
-        ? x.kb_name.trim()
-        : '-'
-    const kbLine = `${t('chat.references_kb_label')}${kbName}` // 知识库：+ 名称
-    return `${titleLine}\n${body}\n${kbLine}`
-  })
-  return blocks.join('\n\n---\n\n')
-}
-
-function PreparationStepDescriptionMd({
-  source,
-  stepCode,
-  rowKey,
-  revealMode,
-  onRevealStart,
-  onRevealComplete,
-}: {
-  source: string
-  /** 当前 preparation 项 code：记忆类与知识库检索走尾部裁切、不可滚可视区 */
-  stepCode: string
-  /** 与父级 Steps 行一致，用于打字开始/结束回调 */
-  rowKey: string
-  /** full：已轮到且之前阶段已播完，整段展示；typing：当前串行阶段，块打字机 */
-  revealMode: 'full' | 'typing'
-  /** 开始从 0 揭示前调用（父级将本行标为未完成，避免 Strict Mode 下图标先打勾） */
-  onRevealStart?: (key: string) => void
-  /** 本行副标题揭示到满字时调用一次 */
-  onRevealComplete?: (key: string) => void
-}) {
-  const normalizedFull = React.useMemo(
-    () => normalizePreparationDescriptionRaw(source),
-    [source],
-  )
-  const [revealedLen, setRevealedLen] = React.useState(0)
-  const descScrollRef = React.useRef<HTMLDivElement>(null)
-  const prevNormRef = React.useRef<string | null>(null)
-  const revealDoneNotifiedRef = React.useRef(false)
-
-  const memoryTailView = isPrepMemoryTailViewStep(stepCode)
-
-  const scrollDescRefToEnd = React.useCallback(() => {
-    if (!memoryTailView) {
-      requestAnimationFrame(() => {
-        requestAnimationFrame(() => {
-          const el = descScrollRef.current
-          if (el) el.scrollTop = el.scrollHeight
-          bumpChatMessageListPrepLayout()
-        })
-      })
-    } else {
-      bumpChatMessageListPrepLayout()
-    }
-  }, [memoryTailView])
-
-  React.useLayoutEffect(() => {
-    if (revealMode !== 'full') return
-    const len = normalizedFull.length
-    if (!len) {
-      setRevealedLen(0)
-      return
-    }
-    setRevealedLen(len)
-    scrollDescRefToEnd()
-  }, [revealMode, normalizedFull, scrollDescRefToEnd])
-
-  React.useEffect(() => {
-    if (revealMode !== 'typing') return
-
-    if (prevNormRef.current !== normalizedFull) {
-      prevNormRef.current = normalizedFull
-      revealDoneNotifiedRef.current = false
-    }
-
-    const len = normalizedFull.length
-    if (!len) {
-      setRevealedLen(0)
-      return
-    }
-
-    onRevealStart?.(rowKey)
-    setRevealedLen(0)
-    const t0 = performance.now()
-    let rafId = 0
-    let revealed = 0
-    const tickMs = PREP_DESC_CHUNK_TICK_MS
-    const chunk = prepDescCharsPerTick(len)
-    let nextTickAt = t0 + tickMs
-
-    const step = (now: number) => {
-      if (now >= nextTickAt && revealed < len) {
-        revealed = Math.min(len, revealed + chunk)
-        nextTickAt = now + tickMs
-        setRevealedLen(revealed)
-        scrollDescRefToEnd()
-      }
-
-      if (revealed >= len) {
-        if (!revealDoneNotifiedRef.current) {
-          revealDoneNotifiedRef.current = true
-          onRevealComplete?.(rowKey)
-        }
-        return
-      }
-
-      rafId = requestAnimationFrame(step)
-    }
-
-    rafId = requestAnimationFrame(step)
-    return () => {
-      cancelAnimationFrame(rafId)
-    }
-  }, [
-    revealMode,
-    normalizedFull,
-    scrollDescRefToEnd,
-    memoryTailView,
-    rowKey,
-    onRevealStart,
-    onRevealComplete,
-  ])
-
-  if (!normalizedFull.length) return null
-
-  const md = preparationDescriptionToMarkdownFromNormalized(
-    normalizedFull.slice(0, revealedLen),
-  )
-
-  return (
-    <div
-      ref={descScrollRef}
-      className={clsx(
-        'chat-prep-step-desc-scroll',
-        memoryTailView && 'chat-prep-step-desc-scroll--memory-tail',
-      )}
-    >
-      <div className="chat-prep-step-md">
-        <ReactMarkdown
-          remarkPlugins={[remarkGfm]}
-          components={prepDescriptionMarkdownComponents}
-        >
-          {md}
-        </ReactMarkdown>
-      </div>
-    </div>
-  )
-}
-
-type PrepItem = NonNullable<Message['preparation_items']>[number]
-
-function prepRowKey(it: PrepItem) {
-  return `${it.code}\t${it.name}`
-}
-
-function resolvePrepItemDescription(it: PrepItem, kbRefDesc: string) {
-  const fromApi = it.description?.trim()
-  const fromRefs =
-    it.code === 'knowledge_retrieval' && !fromApi ? kbRefDesc : ''
-  return (fromApi || fromRefs).trim()
-}
-
-type StepItemStatus = NonNullable<StepsProps['items']>[number]['status']
-
-/** SSE 约定 start/end → 内部 phase；其它 phase 为后端透传字符串 */
-function mapPhaseToStepStatus(phase: string): StepItemStatus {
-  if (phase === 'done') return 'finish'
-  if (phase === 'running') return 'process'
-  if (phase === 'error' || phase === 'failed') return 'error'
-  return 'wait'
-}
-
-export { CHAT_PREPARATION_DEMO_ITEMS } from './preparation-demo-items'
-
-/**
- * 开发态：URL 带 `?chatPrep=1` 时在会话页固定展示 preparation（无需发消息）。
- * @param search 传入 `useLocation().search` 以便路由变更时与界面同步
- */
-export function isChatPreparationDemoEnabled(search?: string): boolean {
-  if (!import.meta.env.DEV) return false
-  const q =
-    search ??
-    (typeof window !== 'undefined' ? window.location.search : '')
-  return new URLSearchParams(q).get('chatPrep') === '1'
-}
-
-export function PreparationSteps({
-  items,
-  referencesKnowledgeItems,
-}: {
-  items: NonNullable<Message['preparation_items']>
-  /** 流式阶段与 knowledge_retrieval 步同屏：无 description 时用引用列表拼副标题 */
-  referencesKnowledgeItems?: Message['references_knowledge_items']
-}) {
-  const { t } = useTranslation()
-
-  const kbRefDesc = React.useMemo(() => {
-    if (!referencesKnowledgeItems || referencesKnowledgeItems.length === 0)
-      return ''
-    return buildKnowledgeRetrievalPrepDescriptionFromRefs(
-      referencesKnowledgeItems,
-      t,
-    )
-  }, [referencesKnowledgeItems, t])
-
-  const prevDescByKeyRef = React.useRef<Record<string, string>>({})
-  const [descRevealComplete, setDescRevealComplete] = React.useState<
-    Record<string, boolean>
-  >({})
-  const [sequentialUnlockIdx, setSequentialUnlockIdx] = React.useState(0)
-
-  /** 前缀 preparation 行 identity 变化或列表变短时串行队列从头来（末尾追加新行不重置） */
-  const prevPrepRowKeysRef = React.useRef<string[]>([])
-
-  React.useLayoutEffect(() => {
-    const keys = items.map(prepRowKey)
-    const prev = prevPrepRowKeysRef.current
-    if (prev.length === 0) {
-      prevPrepRowKeysRef.current = keys
-      return
-    }
-    const minLen = Math.min(prev.length, keys.length)
-    let prefixBroken = false
-    for (let i = 0; i < minLen; i++) {
-      if (prev[i] !== keys[i]) {
-        prefixBroken = true
-        break
-      }
-    }
-    if (prefixBroken || keys.length < prev.length) {
-      setSequentialUnlockIdx(0)
-      setDescRevealComplete({})
-    }
-    prevPrepRowKeysRef.current = keys
-  }, [items])
-
-  /** 当前串行指针落在「无副标题」行时直接跳过 */
-  React.useLayoutEffect(() => {
-    setSequentialUnlockIdx((u) => {
-      let v = u
-      while (
-        v < items.length &&
-        !resolvePrepItemDescription(items[v], kbRefDesc)
-      ) {
-        v += 1
-      }
-      return v
-    })
-  }, [items, kbRefDesc, sequentialUnlockIdx])
-
-  /** 已播完的行副标题视为完成（对勾与后端 phase 对齐用） */
-  React.useLayoutEffect(() => {
-    setDescRevealComplete((prev) => {
-      const next = { ...prev }
-      let changed = false
-      for (let i = 0; i < sequentialUnlockIdx; i++) {
-        const it = items[i]
-        const d = resolvePrepItemDescription(it, kbRefDesc)
-        const k = prepRowKey(it)
-        if (d && next[k] !== true) {
-          next[k] = true
-          changed = true
-        }
-      }
-      return changed ? next : prev
-    })
-  }, [sequentialUnlockIdx, items, kbRefDesc])
-
-  React.useLayoutEffect(() => {
-    setDescRevealComplete((prev) => {
-      const next = { ...prev }
-      let changed = false
-      for (const it of items) {
-        const key = prepRowKey(it)
-        const desc = resolvePrepItemDescription(it, kbRefDesc)
-        const prevD = prevDescByKeyRef.current[key]
-        if (desc !== prevD) {
-          prevDescByKeyRef.current[key] = desc
-          if (desc) {
-            if (next[key] !== false) {
-              next[key] = false
-              changed = true
-            }
-          } else if (key in next) {
-            delete next[key]
-            changed = true
-          }
-        }
-      }
-      return changed ? next : prev
-    })
-  }, [items, kbRefDesc])
-
-  const handleDescRevealStart = React.useCallback((key: string) => {
-    setDescRevealComplete((prev) => {
-      if (prev[key] === false) return prev
-      return { ...prev, [key]: false }
-    })
-  }, [])
-
-  const handleDescRevealComplete = React.useCallback((key: string) => {
-    const idx = items.findIndex((it) => prepRowKey(it) === key)
-    if (idx < 0) return
-    setDescRevealComplete((prev) => {
-      if (prev[key]) return prev
-      return { ...prev, [key]: true }
-    })
-    setSequentialUnlockIdx(idx + 1)
-  }, [items])
-
-  const stepsItems = React.useMemo((): StepsProps['items'] => {
-    return items.map((it: PrepItem, idx: number) => {
-      const title = it.name || it.code
-      const key = prepRowKey(it)
-      const backendStatus = mapPhaseToStepStatus(it.phase)
-      const desc = resolvePrepItemDescription(it, kbRefDesc)
-
-      let displayStatus = backendStatus
-      if (backendStatus === 'error') {
-        displayStatus = 'error'
-      } else if (desc) {
-        if (idx > sequentialUnlockIdx) {
-          displayStatus = 'wait'
-        } else if (idx < sequentialUnlockIdx) {
-          displayStatus = backendStatus
-        } else if (!descRevealComplete[key]) {
-          displayStatus = 'process'
-        } else {
-          displayStatus = backendStatus
-        }
-      }
-
-      const row: NonNullable<StepsProps['items']>[number] = {
-        title,
-        status: displayStatus,
-      }
-
-      if (desc) {
-        if (idx > sequentialUnlockIdx) {
-          /* 未到串行轮次：不渲染副标题 */
-        } else if (idx < sequentialUnlockIdx) {
-          row.description = (
-            <PreparationStepDescriptionMd
-              key={key}
-              rowKey={key}
-              revealMode="full"
-              source={desc}
-              stepCode={it.code}
-            />
-          )
-        } else {
-          row.description = (
-            <PreparationStepDescriptionMd
-              key={key}
-              rowKey={key}
-              revealMode="typing"
-              source={desc}
-              stepCode={it.code}
-              onRevealStart={handleDescRevealStart}
-              onRevealComplete={handleDescRevealComplete}
-            />
-          )
-        }
-      }
-
-      if (displayStatus === 'finish') {
-        row.icon = (
-          <span className="chat-prep-step-icon-inner" aria-hidden>
-            <CheckCircle2 size={18} strokeWidth={2} />
-          </span>
-        )
-      } else if (displayStatus === 'process' || displayStatus === 'wait') {
-        row.icon = (
-          <span
-            className="chat-prep-step-spin"
-            role="status"
-            aria-label={t('common.loading')}
-          >
-            <Spin size="small" />
-          </span>
-        )
-      }
-      return row
-    })
-  }, [
-    items,
-    kbRefDesc,
-    t,
-    descRevealComplete,
-    sequentialUnlockIdx,
-    handleDescRevealStart,
-    handleDescRevealComplete,
-  ])
-
-  if (!items.length) return null
-
-  return (
-    <div className="chat-prep-panel">
-      <div className="chat-prep-heading">{t('chat.preparation_heading')}</div>
-      <div className="chat-prep-steps-wrap">
-        <CxSteps
-          orientation="vertical"
-          size="small"
-          items={stepsItems}
-          className="chat-prep-steps"
-        />
-      </div>
-    </div>
-  )
-}
-
-export default PreparationSteps

package/src/views/page-system/logs/components/message-list/suggestion-list.tsx

@@ -1,36 +0,0 @@
-import React from 'react'
-import clsx from 'clsx'
-
-/** 与流式/历史里 `suggested_replies` → `message.options` 同一套样式 */
-const SUGGESTED_REPLY_BTN_CLS = clsx(
-  'w-fit max-w-full',
-  'text-left break-words whitespace-normal',
-  'px-4 py-2.5 rounded-xl text-[13px] leading-relaxed',
-  'text-gray-700 dark:text-gray-200',
-  'bg-[#f2f3f5] dark:bg-[#2d2e30]',
-  'hover:bg-[#e8eaed] dark:hover:bg-[#3a3b3d]',
-  'transition-colors duration-150',
-)
-
-export const SuggestionList: React.FC<{
-  options: string[]
-  keyPrefix: string
-  onOptionClick?: (option: string) => void | Promise<void>
-}> = ({ options, keyPrefix, onOptionClick }) => (
-  <div className="mt-2 flex flex-col gap-2 items-start">
-    {options.map((option, idx) => (
-      <button
-        type="button"
-        key={`${keyPrefix}-${idx}`}
-        onClick={() => {
-          const fn = onOptionClick
-          if (fn) void fn(option)
-        }}
-        className={SUGGESTED_REPLY_BTN_CLS}
-      >
-        {option}
-      </button>
-    ))}
-  </div>
-)
-