cx-chat 0.0.1

package/src/views/page-menus/model-metadata/role/modal/role-permission-modal.tsx

@@ -0,0 +1,237 @@
+import { getModelMetadataListAPI } from '@api/menus/model-metadata/manage'
+import {
+  getModelMetadataRoleDetailAPI,
+  updateModelMetadataRoleFullAPI,
+} from '@api/menus/model-metadata/role'
+import { useToast } from '@/contexts/ToastContext'
+import { roleModalShellStyles } from '@/views/page-system/role/modal/role-modal-shell-styles'
+import { CxModal, useCxModal } from '@cx-ui'
+import { forwardRef, useCallback, useImperativeHandle, useState } from 'react'
+import { useTranslation } from 'react-i18next'
+
+import RolePermissionAssignPanel, { colKey } from './role-permission-assign-panel'
+
+export type RolePermissionModalOpenPayload = {
+  record: { id: string | number; name?: string }
+}
+
+/** 与 role-permission-assign-panel 勾选 key 一致：表/列 id 优先取 id，与列表 schema 对齐 */
+function tableIdFromGrant(tb: any) {
+  return String(tb?.id ?? tb?.tableId ?? '').trim()
+}
+
+function columnIdFromGrant(col: any) {
+  return String(col?.id ?? col?.columnId ?? '').trim()
+}
+
+function initSelectedFromLibraries(libraries: any[]): Record<string, boolean> {
+  const next: Record<string, boolean> = {}
+  for (const lib of libraries || []) {
+    const mid = String(lib?.metadataId ?? lib?.id ?? '').trim()
+    if (!mid) continue
+    for (const tb of lib.tables || []) {
+      const tid = tableIdFromGrant(tb)
+      if (!tid) continue
+      for (const col of tb.columns || []) {
+        const cid = columnIdFromGrant(col)
+        if (!cid) continue
+        next[colKey(mid, tid, cid)] = true
+      }
+    }
+  }
+  return next
+}
+
+function buildLibrariesFromSelected(selected: Record<string, boolean>) {
+  const byMeta = new Map<string, Map<string, string[]>>()
+  for (const [k, on] of Object.entries(selected)) {
+    if (!on) continue
+    const i1 = k.indexOf('::')
+    if (i1 < 0) continue
+    const i2 = k.indexOf('::', i1 + 2)
+    if (i2 < 0) continue
+    const metadataId = k.slice(0, i1).trim()
+    const tableId = k.slice(i1 + 2, i2).trim()
+    const columnId = k.slice(i2 + 2).trim()
+    if (!metadataId || !tableId || !columnId) continue
+    if (!byMeta.has(metadataId)) byMeta.set(metadataId, new Map())
+    const tm = byMeta.get(metadataId)!
+    if (!tm.has(tableId)) tm.set(tableId, [])
+    tm.get(tableId)!.push(columnId)
+  }
+  const libraries: { metadataId: string; tables: { tableId: string; columnIds: string[] }[] }[] = []
+  for (const [metadataId, tableMap] of byMeta) {
+    const tables = Array.from(tableMap.entries())
+      .map(([tableId, columnIds]) => ({
+        tableId,
+        columnIds: [...new Set(columnIds)],
+      }))
+      .filter((tb) => tb.tableId && tb.columnIds.length > 0)
+    if (!tables.length) continue
+    libraries.push({ metadataId, tables })
+  }
+  return libraries
+}
+
+/** 正式 list 接口：data 为数组，每项含 metadataId、tables（含 columns） */
+function buildMetadataIndexFromListResponse(listRes: any) {
+  const raw = listRes?.data
+  const arr = Array.isArray(raw) ? raw : []
+  const byId: Record<string, any> = {}
+  const order: string[] = []
+  for (const it of arr) {
+    const mid = String(it?.metadataId ?? '').trim()
+    if (!mid) continue
+    byId[mid] = it
+    order.push(mid)
+  }
+  return { metadataById: byId, metadataOrder: order }
+}
+
+const RolePermissionModal = forwardRef<
+  { open: (p: RolePermissionModalOpenPayload) => void; close: () => void },
+  { onSaved?: () => void | Promise<void> }
+>(function RolePermissionModal({ onSaved }, ref) {
+  const { t } = useTranslation()
+  const { showToast } = useToast()
+  const [loading, setLoading] = useState(false)
+  const [saving, setSaving] = useState(false)
+  const [roleId, setRoleId] = useState<string | number | null>(null)
+  const [detail, setDetail] = useState<any>(null)
+  const [metadataById, setMetadataById] = useState<Record<string, any>>({})
+  const [metadataOrder, setMetadataOrder] = useState<string[]>([])
+  const [selected, setSelected] = useState<Record<string, boolean>>({})
+  const [assignBootstrapKey, setAssignBootstrapKey] = useState(0)
+  /** 列表行传入的名称，接口返回前用于标题，减轻「点了没反应」感 */
+  const [titleHintFromList, setTitleHintFromList] = useState<string | undefined>(undefined)
+
+  const modal = useCxModal({
+    onOpen: async (payload) => {
+      const id = payload?.data?.record?.id ?? payload?.opeId
+      setRoleId(id ?? null)
+      setDetail(null)
+      setMetadataById({})
+      setMetadataOrder([])
+      setSelected({})
+      setAssignBootstrapKey((k) => k + 1)
+      if (id == null || `${id}`.trim() === '') {
+        setTitleHintFromList(undefined)
+        return
+      }
+      const hint = payload?.data?.record?.name
+      setTitleHintFromList(typeof hint === 'string' && hint.trim() ? hint.trim() : undefined)
+      setLoading(true)
+      try {
+        const [roleRes, listRes] = await Promise.all([
+          getModelMetadataRoleDetailAPI(id),
+          getModelMetadataListAPI(),
+        ])
+        const data = (roleRes as any)?.data
+        setDetail(data ?? null)
+        setSelected(initSelectedFromLibraries(data?.libraries ?? []))
+        const idx = buildMetadataIndexFromListResponse(listRes)
+        setMetadataById(idx.metadataById)
+        setMetadataOrder(idx.metadataOrder)
+      } finally {
+        setLoading(false)
+      }
+    },
+    onClose: () => {
+      setRoleId(null)
+      setDetail(null)
+      setMetadataById({})
+      setMetadataOrder([])
+      setSelected({})
+      setTitleHintFromList(undefined)
+    },
+  })
+
+  const { isOpen, close } = modal
+
+  const handleSave = useCallback(async () => {
+    if (!roleId || !detail) return
+    setSaving(true)
+    try {
+      const libraries = buildLibrariesFromSelected(selected)
+      await updateModelMetadataRoleFullAPI({
+        id: String(roleId),
+        libraries,
+      })
+      showToast(t('common.operation_success'), 'success')
+      await onSaved?.()
+      close()
+    } catch {
+      // 失败由 axios 拦截器等统一提示
+    } finally {
+      setSaving(false)
+    }
+  }, [roleId, detail, selected, showToast, t, onSaved, close])
+
+  useImperativeHandle(
+    ref,
+    () => ({
+      open: (payload: RolePermissionModalOpenPayload) => {
+        modal.open({
+          opeType: 'edit',
+          opeId: payload.record.id,
+          data: { record: payload.record },
+        })
+      },
+      close,
+    }),
+    [modal.open, close],
+  )
+
+  const titleBase = t('menus.model_metadata.role.role_permission_title')
+  const titleName = detail?.name ?? titleHintFromList
+  const modalTitle = titleName ? `${titleBase} — ${titleName}` : titleBase
+
+  return (
+    <CxModal
+      isOpen={isOpen}
+      title={modalTitle}
+      onClose={close}
+      opeType="edit"
+      onSubmit={() => void handleSave()}
+      submitting={saving}
+      modalConfig={{
+        width: 1104,
+        styles: roleModalShellStyles,
+        rootClassName: 'cx-modal-role-assign',
+      }}
+    >
+      <div className="flex h-full min-h-0 w-full flex-1 flex-col overflow-hidden">
+        {loading ? (
+          <RolePermissionAssignPanel
+            key={`${String(roleId)}-${assignBootstrapKey}`}
+            active={isOpen}
+            bootstrapKey={assignBootstrapKey}
+            maxHeightClass="h-full min-h-0 w-full flex-1 overflow-hidden"
+            metadataById={{}}
+            metadataOrder={[]}
+            listLoading
+            selected={{}}
+            onSelectedChange={() => {}}
+          />
+        ) : !detail ? (
+          <div className="py-10 text-center text-sm text-gray-500">{t('common.no_data')}</div>
+        ) : (
+          <RolePermissionAssignPanel
+            key={`${String(roleId)}-${assignBootstrapKey}`}
+            active={isOpen}
+            bootstrapKey={assignBootstrapKey}
+            maxHeightClass="h-full min-h-0 w-full flex-1 overflow-hidden"
+            metadataById={metadataById}
+            metadataOrder={metadataOrder}
+            listLoading={false}
+            selected={selected}
+            onSelectedChange={setSelected}
+          />
+        )}
+      </div>
+    </CxModal>
+  )
+})
+
+RolePermissionModal.displayName = 'RolePermissionModal'
+export default RolePermissionModal

package/src/views/page-menus/model-metadata/role/modal/submit-modal.tsx

@@ -0,0 +1,135 @@
+import {
+  addModelMetadataRoleAPI,
+  getModelMetadataRoleDetailAPI,
+  updateModelMetadataRoleBasicAPI,
+} from '@api/menus/model-metadata/role'
+import { useModalSubmit } from '@/hooks/useModalSubmit'
+import { forwardRef, useImperativeHandle, useMemo } from 'react'
+import { useTranslation } from 'react-i18next'
+
+import { CxForm, CxFormItem, CxInput, CxModal, useCxModal } from '@cx-ui'
+
+type OpenPayload = {
+  opeType?: string
+  opeId?: string | number
+  data?: any
+}
+
+type Props = {
+  onCancel?: () => void
+  onOk?: (values: any) => void | Promise<void>
+}
+
+const MODAL_WIDTH = 520
+
+const SubmitModal = forwardRef<
+  { close: () => void; open: (payload?: OpenPayload) => void },
+  Props
+>(function SubmitModal(props, ref) {
+  const { onCancel, onOk } = props
+  const { t } = useTranslation()
+
+  const modal = useCxModal({
+    onOpen: async (payload) => {
+      form.resetFields()
+      const type = payload?.opeType ?? 'add'
+      if (type === 'edit' && payload?.opeId != null && `${payload.opeId}`.trim() !== '') {
+        try {
+          const res = await getModelMetadataRoleDetailAPI(payload.opeId)
+          const data = (res as any)?.data
+          if (data) {
+            form.setFieldsValue({
+              name: data.name ?? '',
+              code: data.code ?? '',
+              description: data.description ?? '',
+            })
+          }
+        } catch (e) {
+          console.error(e)
+        }
+      } else {
+        form.setFieldsValue({
+          name: '',
+          code: '',
+          description: '',
+        })
+      }
+    },
+    onClose: () => {
+      onCancel?.()
+    },
+  })
+
+  const { isOpen, close, form, opeType, opeId } = modal
+  const { submitting, handleSubmit } = useModalSubmit()
+
+  const title = useMemo(
+    () =>
+      opeType === 'edit'
+        ? t('menus.model_metadata.role.edit')
+        : t('menus.model_metadata.role.add'),
+    [opeType, t],
+  )
+
+  const handleModalSubmit = async () => {
+    const result = await handleSubmit({
+      opeType,
+      validate: () => form.validateFields(),
+      addAPI: addModelMetadataRoleAPI,
+      editAPI: (payload: any) =>
+        updateModelMetadataRoleBasicAPI({ ...payload, id: opeId }),
+      transform: (values: any) => ({
+        name: values.name,
+        code: values.code ?? '',
+        description: values.description ?? '',
+      }),
+      successMessage: {
+        add: t('common.add_success'),
+        edit: t('common.edit_success'),
+      },
+      onSuccess: async ({ payload }) => {
+        await onOk?.(payload)
+      },
+    })
+    if (result) close()
+  }
+
+  useImperativeHandle(
+    ref,
+    () => ({
+      open: modal.open,
+      close,
+    }),
+    [modal.open, close],
+  )
+
+  return (
+    <CxModal
+      title={title}
+      isOpen={isOpen}
+      onClose={close}
+      opeType={opeType === 'edit' ? 'edit' : 'add'}
+      onSubmit={() => void handleModalSubmit()}
+      submitting={submitting}
+      modalConfig={{ width: MODAL_WIDTH }}
+    >
+      <CxForm form={form} layout="vertical" className="pt-1">
+        <CxFormItem
+          name="name"
+          label={t('menus.model_metadata.role.fields.name')}
+          rules={[{ required: true, message: t('common.required') }]}
+        >
+          <CxInput maxLength={128} />
+        </CxFormItem>
+        <CxFormItem name="code" label={t('menus.model_metadata.role.fields.code')}>
+          <CxInput maxLength={64} />
+        </CxFormItem>
+        <CxFormItem name="description" label={t('menus.model_metadata.role.fields.description')}>
+          <CxInput.Textarea rows={3} maxLength={500} />
+        </CxFormItem>
+      </CxForm>
+    </CxModal>
+  )
+})
+
+export default SubmitModal

package/src/views/page-menus/model-metadata/training/components/detail-records/index.ts

@@ -0,0 +1,4 @@
+export { default } from './timeline'
+export type { RecordsTimelineProps } from './timeline'
+export type { TrainingDetailItem, TrainingChangeFlatRow, TrainingChangeCategory, TrainingChangeOp } from './types'
+export { parseTrainingRowContent } from './types'

package/src/views/page-menus/model-metadata/training/components/detail-records/node-card.tsx

@@ -0,0 +1,72 @@
+import type { CxModalRef } from '@cx-ui/modal/useCxModal'
+import { CxButton } from '@cx-ui'
+import { useMemo, useRef } from 'react'
+import { useTranslation } from 'react-i18next'
+import UpdateDetailModal from '../../modal/update-detail-modal'
+import SummaryList from './summary-list'
+import { flattenOneCategory, parseTrainingRowContent, type TrainingDetailItem } from './types'
+
+type Props = {
+  row: TrainingDetailItem
+  summaryPreviewLimit?: number
+}
+
+export default function RecordNodeCard({ row, summaryPreviewLimit }: Props) {
+  const { t } = useTranslation()
+  const updateDetailModalRef = useRef<CxModalRef>(null)
+  const c = useMemo(() => parseTrainingRowContent(row), [row])
+  const meta = useMemo(
+    () => ({
+      schemaVersion: row.schemaVersion,
+      updateTime: row.updateTime,
+      updateBy: row.updateBy,
+      detailId: row.id,
+    }),
+    [row],
+  )
+
+  const tableRows = useMemo(() => flattenOneCategory(c, 'tables', meta), [c, meta])
+  const documentRows = useMemo(() => flattenOneCategory(c, 'documents', meta), [c, meta])
+  const exampleSqlRows = useMemo(() => flattenOneCategory(c, 'exampleSql', meta), [c, meta])
+
+  const merged = useMemo(() => [...tableRows, ...documentRows, ...exampleSqlRows], [tableRows, documentRows, exampleSqlRows])
+
+  const hasLimit = summaryPreviewLimit != null && summaryPreviewLimit >= 0
+  const previewRows = useMemo(
+    () => (hasLimit ? merged.slice(0, summaryPreviewLimit!) : merged),
+    [hasLimit, merged, summaryPreviewLimit],
+  )
+
+  const showMore = hasLimit ? merged.length > summaryPreviewLimit! : merged.length > 0
+
+  const empty = (
+    <div className="rounded border border-dashed border-gray-200 py-4 text-center text-xs text-gray-400 dark:border-gray-600">
+      {t('menus.model_metadata.training.detail_empty_section')}
+    </div>
+  )
+
+  const listKey = String(row.id ?? `${row.schemaVersion ?? ''}-${row.updateTime ?? ''}`)
+
+  return (
+    <div className="flex w-full min-w-0 max-w-full flex-col">
+      <div key={listKey} className="w-full min-w-0">
+        {merged.length ? (
+          <>
+            <SummaryList rows={previewRows} showScope />
+            {showMore ? (
+              <div className="mt-2 flex justify-start">
+                <CxButton type="link" className="h-auto p-0" onClick={() => updateDetailModalRef.current?.open({ data: { row } })}>
+                  {t('menus.model_metadata.training.detail_view_full')}
+                </CxButton>
+              </div>
+            ) : null}
+          </>
+        ) : (
+          empty
+        )}
+      </div>
+
+      <UpdateDetailModal ref={updateDetailModalRef} />
+    </div>
+  )
+}

package/src/views/page-menus/model-metadata/training/components/detail-records/summary-lines.ts

@@ -0,0 +1,196 @@
+import type { TrainingChangeCategory, TrainingChangeOp } from './types'
+
+/** 变更前值（摘要内强调块） */
+export type SummaryChangeBeforeSeg = { role: 'changeBefore'; text: string }
+/** 变更后值（摘要内强调块） */
+export type SummaryChangeAfterSeg = { role: 'changeAfter'; text: string }
+/** 单段 SQL 展示（用 code-view） */
+export type SummarySqlSnippetSeg = { role: 'sqlSnippet'; text: string }
+/** SQL 字段变更：上下对比（变更前 / 变更后） */
+export type SummarySqlPairSeg = { role: 'changeSqlPair'; fieldLabel: string; before: string; after: string }
+
+export type SummarySeg =
+  | string
+  | SummaryChangeBeforeSeg
+  | SummaryChangeAfterSeg
+  | SummarySqlSnippetSeg
+  | SummarySqlPairSeg
+
+/** 一行摘要：多段横向或纵向拼接 */
+export type SummaryLine = SummarySeg[]
+
+function skipChangedKey(k: string) {
+  return /Sha256$/i.test(k) || /Len$/i.test(k)
+}
+
+function manageFieldLabel(t: (k: string) => string, fieldKey: string): string {
+  const alias: Record<string, string> = {
+    exampleSqlPreview: 'menus.model_metadata.manage.fields.exampleSql',
+    name: 'menus.model_metadata.manage.fields.docName',
+    code: 'menus.model_metadata.manage.fields.docCode',
+  }
+  const ik = alias[fieldKey] ?? `menus.model_metadata.manage.fields.${fieldKey}`
+  const v = t(ik)
+  return v === ik ? fieldKey : v
+}
+
+function pushDiffLine(lines: SummaryLine[], fieldLabel: string, before: string, after: string) {
+  lines.push([
+    `${fieldLabel}：`,
+    { role: 'changeBefore', text: before },
+    ' 变更为 ',
+    { role: 'changeAfter', text: after },
+  ])
+}
+
+function pushSqlPairLine(lines: SummaryLine[], fieldLabel: string, before: string, after: string) {
+  lines.push([{ role: 'changeSqlPair', fieldLabel, before, after }])
+}
+
+function collectChangedLines(
+  changed: any,
+  t: (k: string) => string,
+  resolveLabelKey: (rawKey: string) => string = (k) => k,
+  sqlDiffKeys?: readonly string[],
+): SummaryLine[] {
+  const out: SummaryLine[] = []
+  if (changed == null || typeof changed !== 'object') return out
+  for (const [k, v] of Object.entries(changed)) {
+    if (skipChangedKey(k) || k === 'columns') continue
+    if (v != null && typeof v === 'object') {
+      const o = v as any
+      if ('before' in o || 'after' in o || 'beforePreview' in o || 'afterPreview' in o) {
+        const b = o.before ?? o.beforePreview ?? '—'
+        const a = o.after ?? o.afterPreview ?? '—'
+        const label = manageFieldLabel(t, resolveLabelKey(k))
+        if (sqlDiffKeys && sqlDiffKeys.includes(k)) {
+          pushSqlPairLine(out, label, String(b), String(a))
+        } else {
+          pushDiffLine(out, label, String(b), String(a))
+        }
+      }
+    }
+  }
+  return out
+}
+
+function tablePath(it: any) {
+  return [it.tableSchema, it.tableName].filter(Boolean).join('.') || '—'
+}
+
+function appendColumnGroupLines(
+  lines: SummaryLine[],
+  cols: any,
+  op: 'added' | 'modified' | 'removed',
+  t: (k: string) => string,
+) {
+  const list = cols?.[op]
+  if (!Array.isArray(list)) return
+  const opLabel =
+    op === 'added'
+      ? t('menus.model_metadata.training.change_col_group_added')
+      : op === 'modified'
+        ? t('menus.model_metadata.training.change_col_group_modified')
+        : t('menus.model_metadata.training.change_col_group_removed')
+  for (const col of list) {
+    const name = col.columnName ?? col.name ?? '—'
+    if (op === 'added') {
+      const dt = col.dataType ?? col.dataTypeName ?? ''
+      const cmt = col.commentText ?? col.columnComment ?? ''
+      lines.push([
+        `${opLabel}：${name}${dt ? `（${dt}）` : ''}${cmt ? ` ${t('menus.model_metadata.manage.fields.commentText')}：${cmt}` : ''}`,
+      ])
+    } else if (op === 'removed') {
+      lines.push([`${opLabel}：${name}`])
+    } else {
+      const colDiffs = collectChangedLines(col.changed, t)
+      const row: SummarySeg[] = [`${opLabel}「${name}」`]
+      for (let i = 0; i < colDiffs.length; i++) {
+        if (i === 0) row.push('：')
+        else row.push('；')
+        for (const seg of colDiffs[i]) row.push(seg)
+      }
+      lines.push(row)
+    }
+  }
+}
+
+const EXAMPLE_SQL_DIFF_KEYS = ['exampleSql', 'exampleSqlPreview'] as const
+
+/** 摘要按行返回，每行内可含变更前/后、SQL 片段或 SQL 上下对比 */
+export function buildOperationDetailLines(
+  t: (k: string) => string,
+  category: TrainingChangeCategory,
+  op: TrainingChangeOp,
+  item: any,
+): SummaryLine[] {
+  const lines: SummaryLine[] = []
+  if (category === 'tables') {
+    if (op === 'added') {
+      lines.push([`${t('menus.model_metadata.training.change_line_table')}：${tablePath(item)}`])
+      if (item.tableComment) lines.push([`${manageFieldLabel(t, 'tableComment')}：${item.tableComment}`])
+      if (item.tableType) lines.push([`${manageFieldLabel(t, 'tableType')}：${item.tableType}`])
+      if (item.columnCount != null) lines.push([`${manageFieldLabel(t, 'columnCount')}：${item.columnCount}`])
+    } else if (op === 'removed') {
+      lines.push([`${t('menus.model_metadata.training.change_line_table')}：${tablePath(item)}`])
+      if (item.tableComment) lines.push([`${manageFieldLabel(t, 'tableComment')}：${item.tableComment}`])
+    } else {
+      lines.push([`${t('menus.model_metadata.training.change_line_table')}：${tablePath(item)}`])
+      lines.push(...collectChangedLines(item.changed, t))
+      let cols = item.changed?.columns
+      if (
+        (!cols || typeof cols !== 'object') &&
+        (item.columnsModified != null || item.columnsAdded != null || item.columnsRemoved != null)
+      ) {
+        const removed = Array.isArray(item.columnsRemoved) ? item.columnsRemoved : []
+        cols = {
+          added: Array.isArray(item.columnsAdded) ? item.columnsAdded : [],
+          modified: Array.isArray(item.columnsModified) ? item.columnsModified : [],
+          removed: removed.map((x: any) => (typeof x === 'string' ? { columnName: x } : x)),
+        }
+      }
+      if (cols && typeof cols === 'object') {
+        appendColumnGroupLines(lines, cols, 'added', t)
+        appendColumnGroupLines(lines, cols, 'modified', t)
+        appendColumnGroupLines(lines, cols, 'removed', t)
+      }
+    }
+    return lines
+  }
+  if (category === 'documents') {
+    if (op === 'added') {
+      if (item.name) lines.push([`${manageFieldLabel(t, 'docName')}：${item.name}`])
+      if (item.code) lines.push([`${manageFieldLabel(t, 'docCode')}：${item.code}`])
+      if (item.description) lines.push([`${manageFieldLabel(t, 'docDescription')}：${item.description}`])
+    } else if (op === 'removed') {
+      if (item.name) lines.push([`${manageFieldLabel(t, 'docName')}：${item.name}`])
+      if (item.code) lines.push([`${manageFieldLabel(t, 'docCode')}：${item.code}`])
+    } else {
+      lines.push(...collectChangedLines(item.changed, t, (k) => (k === 'description' ? 'docDescription' : k)))
+    }
+    return lines
+  }
+  if (op === 'added') {
+    const sql = item.exampleSqlPreview ?? item.exampleSql
+    if (sql) {
+      lines.push([`${manageFieldLabel(t, 'exampleSql')}：`, { role: 'sqlSnippet', text: String(sql) }])
+    }
+    if (item.description) lines.push([`${manageFieldLabel(t, 'exampleSqlDescription')}：${item.description}`])
+  } else if (op === 'removed') {
+    const sql = item.exampleSqlPreview ?? item.exampleSql
+    if (sql) {
+      lines.push([`${manageFieldLabel(t, 'exampleSql')}：`, { role: 'sqlSnippet', text: String(sql) }])
+    }
+    if (item.description) lines.push([`${manageFieldLabel(t, 'exampleSqlDescription')}：${item.description}`])
+  } else {
+    lines.push(
+      ...collectChangedLines(
+        item.changed,
+        t,
+        (k) => (k === 'description' ? 'exampleSqlDescription' : k),
+        EXAMPLE_SQL_DIFF_KEYS,
+      ),
+    )
+  }
+  return lines
+}