数据目录闭环(前端)复核修正(表助手):保存撞上 409 后只按预览重算交去保存的那几项,保存、重算期间回答里又到的提案原样留着、不再被当成不合法悄悄去掉,提案到了也不把正在进行的保存翻回可以点;交给助手的待保存的修改最多 200 项(服务端同一个上限,多了整个请求 422),超出时只交最近的 200 项;开场的留空列取那次起草记下的列名(从那次起草任务里这张表的 blank_sample 取),没写出来的列不再当成留空的列举例,「补上留空的 N 列」点名的正是这 N 列,记全了时只算还没补上的;拿不到(最近一次停止了、任务不在了、老服务端没有列名)时改说「目录里还有 M 列没有中文名和含义」,按钮上的数字就是点名的列数;只读查询后面还有行时写「取回前 50 行,后面还有」,不说成结果一共 50 行;check-catalog-loop 的假事件流照服务端夹 SSE 注释行(「: keep-alive」),提案带 source、table_label,出错码用 assistant_*,假服务端照服务端的上限回 422,补回答进行中保存撞上 409、留空列的三种出处、待保存超过 200 项接着问的检查

This commit is contained in:
ThearchyHelios
2026-10-14 10:10:38 +08:00
parent 299224acaf
commit 1d59ba23dc
6 changed files with 372 additions and 54 deletions
+36 -10
View File
@@ -3002,13 +3002,36 @@ export const CATALOG_ASSISTANT_TEXT = {
profileOn: '这个数据源开了数据剖析:助手可以发少量只读查询核对数据,遮罩列不取值',
notStored: '对话不保存在服务端,关闭表助手或离开页面后就没有了',
greeting: '说出你知道的业务事实(某一列的含义、码值、有效记录条件……),助手整理成修改提案,你确认后才写进数据目录。助手只记数据事实,不写计算公式。',
/** 上次起草有留空的列:开场引导先问这几列 */
blankLead: (n: number, cols: string[]) =>
`上次起草有 ${formatNumber(n)} 列模型拿不准、留空了${cols.length ? `,例如 ${cols.join('、')}` : ''}。可以先从这几列开始。`,
/**
* 上次起草有留空的列:开场引导先问这几列(assistant.ts 的 blankLeadOf)。例子只举起草时记下的留空列里还没补上的;
* 拿不到起草时记下的列名时,改说目录里还没有中文名和含义的列——那里面还有没写出来的列,不能说成留空的列
*/
blankLead: (b: { from: 'draft' | 'catalog'; n: number; examples: string[]; remaining: number | null; unnamed: number }) => {
const head = `上次起草有 ${formatNumber(b.n)} 列模型拿不准、留空了`
const cols = b.examples.join('、')
if (b.from === 'catalog') {
return b.unnamed > 0
? `${head}。目录里还有 ${formatNumber(b.unnamed)} 列没有中文名和含义${cols ? `,例如 ${cols}` : ''},可以先从这些列开始。`
: `${head},现在目录里的列都已有中文名或含义。`
}
if (b.remaining === 0) return `${head},现在都已补上中文名或含义。`
if (!cols) return `${head}。`
if (b.remaining == null) return `${head},例如 ${cols}。可以先从这几列开始。`
return b.remaining < b.n
? `${head},还有 ${formatNumber(b.remaining)} 列没补上:${cols}。可以先从这几列开始。`
: `${head}:${cols}。可以先从这几列开始。`
},
suggestLabel: '可以这样开始',
suggestBlank: (n: number) => `补上留空的 ${formatNumber(n)} 列`,
suggestBlankText: (cols: string[], total: number) =>
`请帮我补上这几列的中文名和含义:${cols.join('、')}${total > cols.length ? ` 等 ${formatNumber(total)} 列` : ''}。拿不准的地方先问我。`,
/** 「补上……」按钮:上面的数字就是点名的列数(不知道一共几列时不写数字) */
suggestBlank: (from: 'draft' | 'catalog', total: number | null) => (from === 'catalog'
? `补上没有中文名和含义的 ${formatNumber(total ?? 0)} 列`
: total == null ? '补上留空的列' : `补上留空的 ${formatNumber(total)} 列`),
suggestBlankText: (from: 'draft' | 'catalog', cols: string[], total: number | null) => {
const named = cols.join('、')
if (from === 'draft' && total == null) return `请帮我补上上次起草时模型留空的列的中文名和含义,例如 ${named}。拿不准的地方先问我。`
const more = total != null && total > cols.length ? ` 等 ${formatNumber(total)} 列` : ''
return `请帮我补上这几列的中文名和含义:${named}${more}。拿不准的地方先问我。`
},
suggestFacts: '核对有效记录条件和去重规则',
suggestFactsText: '这张表的有效记录条件和去重规则应该怎么写?拿不准的地方先问我。',
suggestPending: '看看哪些推断可以确认',
@@ -3031,11 +3054,14 @@ export const CATALOG_ASSISTANT_TEXT = {
usage: (input: number, output: number) =>
`输入 ${formatTokens(input, { compact: true })}、输出 ${formatTokens(output, { compact: true })}`,
queries: (n: number) => `查询 ${formatNumber(n)} 次`,
// ---- 只读查询
query: (rows: number) => `查询了数据(${formatNumber(rows)} 行)`,
// ---- 只读查询(rows 是取回的行数;truncated:后面还有行,取回的只是前一截,不是结果的总行数)
query: (rows: number, truncated = false) => (truncated
? `查询了数据(取回前 ${formatNumber(rows)} 行,后面还有)` : `查询了数据(${formatNumber(rows)} 行)`),
queryFailed: '查询没有成功',
queryRows: (shown: number, total: number) => (total > shown
? `共 ${formatNumber(total)} 行,显示前 ${formatNumber(shown)} 行` : `共 ${formatNumber(total)} 行`),
queryRows: (shown: number, total: number, truncated = false) => {
const head = truncated ? `取回前 ${formatNumber(total)} 行(后面还有)` : `共 ${formatNumber(total)} 行`
return total > shown ? `${head},显示前 ${formatNumber(shown)} 行` : head
},
queryEmpty: '没有返回行',
// ---- 修改提案
proposal: (n: number) => `修改提案(${formatNumber(n)} 项)`,
+42 -18
View File
@@ -11,8 +11,8 @@ import { CATALOG_ASSISTANT_TEXT as T, CATALOG_STATUS_LABEL } from '../../lib/ter
import { Markdown } from '../../run/Markdown'
import { patchValueText } from '../../run/catalogPatch'
import {
ASSISTANT_MAX_CHARS, ASSISTANT_MAX_SAVE, QUERY_ROWS_SHOWN, applyEvent, applyPreview, assistantChangesOf, blankColumnsOf, changeStateOf,
changeWhere, dropPending, historyOf, mergeProposal, pendingSubmit, pendingVersion, savedKey,
ASSISTANT_MAX_CHARS, ASSISTANT_MAX_SAVE, QUERY_ROWS_SHOWN, applyEvent, applyPreview, assistantChangesOf, blankColumnsOf, blankLeadOf,
changeStateOf, changeWhere, dropPending, historyOf, mergeProposal, pendingForAssistant, pendingSubmit, pendingVersion, savedKey,
} from './assistant'
import type { AssistantTurn, ChangeState, PendingChange, Turn, TurnPart } from './assistant'
@@ -22,7 +22,10 @@ import type { AssistantTurn, ChangeState, PendingChange, Turn, TurnPart } from '
// 回答流式显示,能停止;助手跑过的只读查询(只有开了数据剖析的源才有)写 SQL 和前几行,默认收起;修改提案逐项写改前、
// 改后、依据,可以逐项去掉、加回。提案并进「待保存的修改」:跨多轮累积,同一项以最后一次提案为准,一键保存(最多 200 项)。
// 保存带待保存的修改里最早那条提案对照的版本:别人在那之后改过就 409,按最新内容重算(预览接口,只读)后停下来让人再看
// 一眼。对话不存服务端:每一轮把前面的对话和待保存的修改一起交上去;关闭、换表、离开页面就没有了,有待保存的修改时先问。
// 一眼;只重算交去保存的那几项,保存期间回答里又到的提案原样留着。对话不存服务端:每一轮把前面的对话和待保存的修改
// (最多 200 项)一起交上去;关闭、换表、离开页面就没有了,有待保存的修改时先问。
// 开场:上次起草有留空的列时,引导先问这几列——列名取那次起草记下的(任务里这张表的 blank_sample),拿不到时改说目录里
// 还没有中文名和含义的列。
// ===========================================================================
type SaveState =
@@ -42,8 +45,11 @@ export function TableAssistant({ sourceId, table, tableLabel, detail, profileEna
detail: CatalogDetail
/** 数据源开了数据剖析:助手才能发只读查询 */
profileEnabled: boolean
/** 上次起草模型拿不准、留空的列数:开场引导先问这几列 */
lastBlank: number
/**
* 上次起草模型拿不准、留空的列数(n)和出处:开场引导先问这几列。jobId 是那次起草的任务(从中取起草时记下的列名);
* earlier:最近一次停止了,n 是再之前那次起草记下的(不知道是哪一次,取不到列名)
*/
lastBlank: { n: number; earlier: boolean; jobId: string | null }
/** 正在编辑这张表:先不让保存(同一张表两处同时改,保存会撞上版本冲突) */
editing: boolean
/** 保存成功:页面换上返回的目录 */
@@ -88,7 +94,23 @@ export function TableAssistant({ sourceId, table, tableLabel, detail, profileEna
lastLen.current = size
}, [turns])
const blankCols = useMemo(() => (lastBlank > 0 ? blankColumnsOf(detail) : []), [lastBlank, detail])
// 上次起草记下的留空列名:从那次起草的任务里取(null 是还没取回来;取不到是空数组,改说目录里还没有中文名和含义的列)
const blankN = lastBlank.n
const blankJob = blankN > 0 && !lastBlank.earlier ? lastBlank.jobId : null
const [blankSample, setBlankSample] = useState<string[] | null>(null)
useEffect(() => {
if (!blankJob) return
let live = true
setBlankSample(null)
api.dataCatalog.draftJob(sourceId, blankJob)
.then(({ job }) => job.tasks.find((t) => t.table_name === table)?.blank_sample?.filter(Boolean) ?? [])
.catch(() => [] as string[])
.then((cols) => { if (live) setBlankSample(cols) })
return () => { live = false }
}, [sourceId, table, blankJob])
// 没有留空的列、还在取那次起草记下的列名时不写
const blankLead = useMemo(() => (blankN <= 0 || (blankJob && blankSample == null)
? null : blankLeadOf(blankN, blankJob ? blankSample : null, blankColumnsOf(detail))), [blankN, blankJob, blankSample, detail])
const hasProposed = useMemo(() => {
const n = detail.notes
const items = [n.label, n.description, n.grain, n.keys, n.kind, n.business_date, n.valid_filter, n.dedup,
@@ -113,7 +135,7 @@ export function TableAssistant({ sourceId, table, tableLabel, detail, profileEna
let proposals = 0
// 这一轮已经收尾(done、error):之后再来的事件不认
let ended = false
stopRef.current = streamCatalogAssistant(sourceId, table, { messages, pending: pendingSubmit(pendingRef.current) }, (ev) => {
stopRef.current = streamCatalogAssistant(sourceId, table, { messages, pending: pendingForAssistant(pendingRef.current) }, (ev) => {
if (ended) return
if (ev.type === 'done' || ev.type === 'error') ended = true
if (ev.type === 'proposal') {
@@ -123,8 +145,8 @@ export function TableAssistant({ sourceId, table, tableLabel, detail, profileEna
if (changes.length) {
const version = typeof ev.version === 'number' && Number.isFinite(ev.version) ? ev.version : detail.version
setPending((cur) => mergeProposal(cur, changes, pid, version))
// 待保存的修改变了:上一次保存的结果、冲突的说明都不再对
setSave({ phase: 'idle' })
// 待保存的修改变了:上一次保存的结果、冲突的说明都不再对。正在保存、重算的不动(按钮照旧不能点,结果出来再说)
setSave((s) => (s.phase === 'saving' || s.phase === 'reloading' ? s : { phase: 'idle' }))
}
return
}
@@ -179,7 +201,8 @@ export function TableAssistant({ sourceId, table, tableLabel, detail, profileEna
setSave({ phase: 'reloading' })
try {
const p = await api.dataCatalog.patchPreview(sourceId, table, pendingSubmit(list))
setPending((cur) => applyPreview(cur, p))
// 只重算交去保存的那几项:保存、重算期间回答里又到的提案不在预览里,原样留着
setPending((cur) => applyPreview(cur, p, list))
setSave({ phase: 'conflict', problems: p.problems })
} catch {
setSave({ phase: 'idle', error: T.conflictFailed })
@@ -210,7 +233,6 @@ export function TableAssistant({ sourceId, table, tableLabel, detail, profileEna
const over = len > ASSISTANT_MAX_CHARS
const lastAssistant = [...turns].reverse().find((t): t is AssistantTurn => t.role === 'assistant')
const status = streaming ? T.answering : lastAssistant?.state === 'stopped' ? T.stopped : lastAssistant ? T.answered : ''
const sampleCols = blankCols.slice(0, Math.min(Math.max(lastBlank, 1), 5))
return (
<aside
@@ -252,15 +274,15 @@ export function TableAssistant({ sourceId, table, tableLabel, detail, profileEna
aria-busy={streaming} aria-label={T.logLabel} data-assistant-log="">
<div className="space-y-2 rounded-lg border bg-bg px-3 py-2.5 text-xs leading-relaxed" data-assistant-msg="intro">
<p className="text-dim" data-assistant-greeting="">{T.greeting}</p>
{lastBlank > 0 && <p className="text-dim" data-assistant-blank="">{T.blankLead(lastBlank, sampleCols)}</p>}
{blankLead && <p className="text-dim" data-assistant-blank={blankLead.from}>{T.blankLead(blankLead)}</p>}
<p className="text-2xs text-faint">{T.notStored}</p>
{fresh && (
<div className="space-y-1 pt-0.5">
<p className="text-2xs text-faint">{T.suggestLabel}</p>
<div className="flex flex-wrap gap-1.5">
{lastBlank > 0 && blankCols.length > 0 && (
<SuggestButton kind="blank" label={T.suggestBlank(lastBlank)}
onClick={() => send(T.suggestBlankText(blankCols.slice(0, 20), blankCols.length))} />
{blankLead?.ask && (
<SuggestButton kind="blank" label={T.suggestBlank(blankLead.from, blankLead.ask.total)}
onClick={() => send(T.suggestBlankText(blankLead.from, blankLead.ask!.columns, blankLead.ask!.total))} />
)}
<SuggestButton kind="facts" label={T.suggestFacts} onClick={() => send(T.suggestFactsText)} />
{hasProposed && <SuggestButton kind="pending" label={T.suggestPending} onClick={() => send(T.suggestPendingText)} />}
@@ -383,7 +405,7 @@ function QueryBlock({ part }: { part: Extract<TurnPart, { kind: 'query' }> }) {
<details className="group rounded-lg border bg-bg text-2xs" data-assistant-part="query" data-assistant-query={failed ? 'error' : 'ok'}>
<summary className="flex cursor-pointer select-none items-start gap-1.5 px-2.5 py-1.5 text-dim outline-none hover:text-fg focus-visible:ring-2 focus-visible:ring-[var(--accent)]">
<Database size={11} className="mt-0.5 shrink-0" style={{ color: failed ? 'var(--err)' : 'var(--accent)' }} aria-hidden />
<span className="min-w-0 break-words">{failed ? `${T.queryFailed}:${part.error}` : T.query(part.rowCount)}</span>
<span className="min-w-0 break-words">{failed ? `${T.queryFailed}:${part.error}` : T.query(part.rowCount, part.truncated)}</span>
</summary>
<div className="space-y-1.5 border-t px-2.5 py-2">
<pre className="mono max-h-40 overflow-auto whitespace-pre-wrap break-words rounded bg-panel px-2 py-1.5 text-2xs" data-assistant-query-sql="">{part.sql}</pre>
@@ -391,7 +413,9 @@ function QueryBlock({ part }: { part: Extract<TurnPart, { kind: 'query' }> }) {
? (
<div className="overflow-x-auto">
<table className="w-full border-collapse text-2xs" data-assistant-query-rows="">
<caption className="pb-1 text-left text-faint">{T.queryRows(Math.min(part.rows.length, QUERY_ROWS_SHOWN), part.rowCount)}</caption>
<caption className="pb-1 text-left text-faint">
{T.queryRows(Math.min(part.rows.length, QUERY_ROWS_SHOWN), part.rowCount, part.truncated)}
</caption>
<thead>
<tr className="border-b text-left text-faint">
{part.columns.map((c) => <th key={c} scope="col" className="mono px-1.5 py-1 font-medium">{c}</th>)}
@@ -407,7 +431,7 @@ function QueryBlock({ part }: { part: Extract<TurnPart, { kind: 'query' }> }) {
</table>
</div>
)
: <p className="text-faint">{part.rowCount > 0 ? T.queryRows(0, part.rowCount) : T.queryEmpty}</p>)}
: <p className="text-faint">{part.rowCount > 0 ? T.queryRows(0, part.rowCount, part.truncated) : T.queryEmpty}</p>)}
</div>
</details>
)
+2 -1
View File
@@ -661,7 +661,8 @@ export function TableDetail({
)}
{assistantOpen && detail.in_schema && (
<TableAssistant key={`${sourceId}\u0000${table}`} sourceId={sourceId} table={table} tableLabel={label ?? detail.table_name} detail={detail}
profileEnabled={profileEnabled} lastBlank={lastBlank} editing={!!edit}
profileEnabled={profileEnabled} lastBlank={{ n: lastBlank, earlier: blankInfo.earlier, jobId: lastDraft?.job_id ?? null }}
editing={!!edit}
onSaved={(d) => {
setDetail(d)
setConflict(null)
+65 -4
View File
@@ -18,13 +18,16 @@ export const ASSISTANT_MAX_MESSAGES = 40
export const ASSISTANT_MAX_CHARS = 4000
/** 一次最多保存几项(服务端 PATCH_MAX_CHANGES) */
export const ASSISTANT_MAX_SAVE = 200
/** 每一轮最多交几项待保存的修改(服务端同一个上限,多了整个请求 422):多出来的只交最近的这么多项 */
export const ASSISTANT_MAX_PENDING = 200
/** 查询结果在界面上显示前几行(服务端最多给 10 行) */
export const QUERY_ROWS_SHOWN = 10
/** 一轮回答里按先后到来的几块:正文、它跑的只读查询、修改提案 */
export type TurnPart =
| { kind: 'text'; text: string }
| { kind: 'query'; sql: string; columns: string[]; rows: unknown[][]; rowCount: number; error: string | null }
/** rowCount 是取回的行数;truncated 为真时后面还有行(取回的只是前一截) */
| { kind: 'query'; sql: string; columns: string[]; rows: unknown[][]; rowCount: number; truncated: boolean; error: string | null }
| { kind: 'proposal'; id: string; version: number; changes: CatalogAssistantChange[] }
export interface UserTurn { id: string; role: 'user'; text: string }
@@ -77,7 +80,7 @@ export function applyEvent(turn: AssistantTurn, ev: CatalogAssistantEvent, propo
const rows = Array.isArray(ev.rows) ? ev.rows.filter(Array.isArray).slice(0, QUERY_ROWS_SHOWN) as unknown[][] : []
parts.push({
kind: 'query', sql: typeof ev.sql === 'string' ? ev.sql : '', columns, rows, rowCount: num(ev.row_count, rows.length),
error: typeof ev.error === 'string' && ev.error.trim() ? ev.error : null,
truncated: ev.truncated === true, error: typeof ev.error === 'string' && ev.error.trim() ? ev.error : null,
})
return { ...turn, parts }
}
@@ -166,6 +169,13 @@ export function pendingSubmit(pending: PendingChange[]): CatalogPatchSubmit[] {
return pending.map((p) => ({ path: p.path, value: p.value, ...(p.reason ? { reason: p.reason } : {}) }))
}
/**
* 交给助手的待保存的修改:最多 ASSISTANT_MAX_PENDING 项(服务端同一个上限,多了整个请求 422)。超出时交最近的那些
* (列表按头一次提出的先后排,后面的是新近提出的);没交上去的模型不知道,再提同一项时以新的提案为准,不会丢
*/
export const pendingForAssistant = (pending: PendingChange[]): CatalogPatchSubmit[] =>
pendingSubmit(pending.length > ASSISTANT_MAX_PENDING ? pending.slice(-ASSISTANT_MAX_PENDING) : pending)
/** 保存时带的版本:待保存的修改里最早的那条提案对照的版本 */
export const pendingVersion = (pending: PendingChange[]): number =>
(pending.length ? Math.min(...pending.map((p) => p.version)) : 0)
@@ -184,12 +194,20 @@ export const savedKey = (origin: string, path: string) => `${origin}\u0000${path
/**
* 保存遇到 409(别人刚改过这张表)后按预览重算:预览里有的项换上最新的改前、改后和状态,版本记成预览的;
* 预览里没有的(已经不合法了,原因在 problems 里)去掉;已经是这个值且已确认的(same)也去掉,不用再存
* 预览里没有的(已经不合法了,原因在 problems 里)去掉;已经是这个值且已确认的(same)也去掉,不用再存。
*
* submitted:交去保存、预览的那几项(同一个对象)。只重算它们:保存、重算期间又到的提案(新的项、同一项换成的新
* 提案)不在预览里,原样留着,不能当成「已经不合法」悄悄去掉。不给时重算全部
*/
export function applyPreview(pending: PendingChange[], preview: CatalogPatchPreview): PendingChange[] {
export function applyPreview(pending: PendingChange[], preview: CatalogPatchPreview, submitted?: readonly PendingChange[]): PendingChange[] {
const byPath = new Map(preview.changes.map((c) => [c.path, c]))
const mine = submitted ? new Set(submitted) : null
const out: PendingChange[] = []
for (const p of pending) {
if (mine && !mine.has(p)) {
out.push(p)
continue
}
const c: CatalogPatchChange | undefined = byPath.get(p.path)
if (!c || c.state === 'same') continue
out.push({ ...p, before: c.before, before_status: c.before_status, after: c.after, value: c.value, state: c.state,
@@ -202,6 +220,49 @@ export function applyPreview(pending: PendingChange[], preview: CatalogPatchPrev
// 开场:上次起草有留空的列时,引导先问这几列
// ---------------------------------------------------------------------------
/** 「补上……」按钮一次最多点名几列(再多的写「等 N 列」) */
export const BLANK_ASK_MAX = 20
/** 开场里最多举几列做例子 */
export const BLANK_EXAMPLES = 5
/**
* 开场引导的写法。留空的列(模型列出了、中文名和含义却都没给)只有起草时记下的那几个列名(blank_sample,最多 5 个)
* 靠得住:目录里还没有中文名和含义的列里,还有没写出来的列(部分完成的宽表)、库注释已经说清的列,不能当成留空的列举例。
* - draft:拿到了起草时记下的列名。例子是其中还没补上的。记全了(列名数不少于留空的列数)时 remaining 是还没补上的
* 几列,按钮写这个数、点名的正是这几列;没记全时 remaining 为 null,按钮不写数字、只点名这几列(模型那边另有背景)。
* - catalog:拿不到(最近一次停止了、用的是再之前那次的留空列数;取任务失败;老服务端没有列名)。例子和按钮都改说
* 「目录里还没有中文名和含义的列」,按钮上的数字就是这些列的总数,点名其中前 BLANK_ASK_MAX 列、再写「等 N 列」。
* ask 为 null:没有可以点名的列,不给按钮
*/
export interface BlankLead {
from: 'draft' | 'catalog'
/** 上次起草留空的列数 */
n: number
examples: string[]
/** 记全了时,留空的列里还没补上的几列;没记全、拿不到列名时为 null */
remaining: number | null
/** 目录里还没有中文名和含义的列数 */
unnamed: number
ask: { columns: string[]; total: number | null } | null
}
export function blankLeadOf(n: number, sample: readonly string[] | null, unnamed: readonly string[]): BlankLead {
const named = sample?.filter((c) => !!c) ?? []
if (named.length) {
const open = new Set(unnamed)
const still = named.filter((c) => open.has(c))
const remaining = named.length >= n ? still.length : null
return {
from: 'draft', n, examples: still.slice(0, BLANK_EXAMPLES), remaining, unnamed: unnamed.length,
ask: still.length ? { columns: still, total: remaining } : null,
}
}
return {
from: 'catalog', n, examples: unnamed.slice(0, BLANK_EXAMPLES), remaining: null, unnamed: unnamed.length,
ask: unnamed.length ? { columns: unnamed.slice(0, BLANK_ASK_MAX), total: unnamed.length } : null,
}
}
/** 还没有中文名和含义的列(表结构里的顺序;被驳回的不算有) */
export function blankColumnsOf(detail: CatalogDetail): string[] {
const live = (it: { status: string } | undefined) => !!it && it.status !== 'rejected'
+6 -2
View File
@@ -3225,9 +3225,13 @@ export interface CatalogAssistantChange extends CatalogPatchChange {
label?: string
}
/**
* 事件流里的一个事件。服务端等模型时另发 SSE 注释行(「: keep-alive」,不是事件),读流时跳过。
* query 的 row_count 是取回的行数;truncated(接口约定里没有写明,服务端给了才用)为真时后面还有行,取回的只是前一截
*/
export type CatalogAssistantEvent =
| { type: 'text'; delta: string }
| { type: 'query'; sql: string; columns: string[]; rows: unknown[][]; row_count: number; error: string | null }
| { type: 'query'; sql: string; columns: string[]; rows: unknown[][]; row_count: number; truncated?: boolean; error: string | null }
| { type: 'proposal'; source_id: string; table: string; version: number; changes: CatalogAssistantChange[] }
| { type: 'done'; usage: { input_tokens: number; output_tokens: number }; queries: number }
| { type: 'error'; message: string; code?: string | null }
@@ -3235,7 +3239,7 @@ export type CatalogAssistantEvent =
/** 交给表助手的一轮请求 */
export interface CatalogAssistantRequest {
messages: { role: 'user' | 'assistant'; content: string }[]
/** 界面上还没保存的修改 */
/** 界面上还没保存的修改:最多 200 项(服务端同一个上限,多了整个请求 422),多出来的只交最近的 200 项 */
pending: CatalogPatchSubmit[]
}