diff --git a/frontend/src/lib/terms.ts b/frontend/src/lib/terms.ts index 6b325b3b..663b6329 100644 --- a/frontend/src/lib/terms.ts +++ b/frontend/src/lib/terms.ts @@ -2390,8 +2390,13 @@ export const CATALOG_TEXT = { // - 「起草要求」:使用者补充给模型的业务背景和用词约定,存在数据源上,以后每次用模型起草都带上; // 「本次补充说明」只用于这一次(重试时沿用)。两者都只交给模型,不改起草规则:冲突时以规则为准。 // - 「起草模型」:设置里单独的一项(偏好设置 → 起草模型),留空跟随助手的模型。 -// - 宽表的「段」:超过 40 列的表拆成表级一段和若干列分段,逐段起草;写的是「已完成 3 / 9 段」。 +// - 宽表的「段」:超过 40 列的表拆成表级一段和若干列分段,逐段起草;写的是「已完成 3 / 9 段」。模型多次用完额度或 +// 超时后,之后的段缩小(每段最多 20 列、10 列)。 // - 「只重试失败的表」:重新起草失败、部分完成和已停止的表;已经写进目录的内容不回滚、不受影响。 +// - 「没写出来」:一次调用没有写出内容(额度用完、只给空壳、超时、出错)。接连没写出来时服务端给一句「提醒」, +// 好转后收起;提醒是提醒的样式,不是错误。超时的调用不计用量。 +// - 「留空」:模型列出了一列(或这一段请它写了),中文名和含义却都没给,写「N 列模型拿不准、留空了」。表的状态不因此 +// 变,不算没写全;办法是在起草要求里补充缩写和术语的含义,再重新起草,已有的内容不会丢。 // =========================================================================== /** 起草要求、本次补充说明的字数上限(服务端同一个数:超长 422) */ @@ -2421,9 +2426,21 @@ export const CATALOG_DRAFT_TEXT = { tooMany: (max: number) => `一次最多起草 ${formatNumber(max)} 张表,请缩小范围`, saveGuidanceFailed: (reason: string) => `起草要求未能保存,未开始起草:${reason}`, startFailed: (reason: string) => `未能开始起草:${reason}`, - // ---- 上一次起草(设置阶段,没写全的才提) + // ---- 上一次起草(设置阶段,没写全、有留空列的才提) last: (state: string, at: string) => `上一次起草(${at}):${state}`, + /** 上一次的结果:状态,有留空的列时接着写几列 */ + lastState: (title: string, blank: number) => (blank ? `${title},${formatNumber(blank)} 列模型拿不准、留空了` : title), lastOpen: '查看', + // ---- 从结果、表详情回到设置:范围就是那几张表 + scopeBlank: (n: number) => `有留空列的 ${formatNumber(n)} 张表`, + scopeTable: (name: string) => `这张表:${name}`, + /** + * 预先选好的范围里有表已经不在表结构里(打开表详情以后别处重新探查了结构):写在那一项下面。一张都不剩时那一项 + * 照旧选着、不能开始,不退回别的范围 + */ + presetMissing: (gone: number, total: number) => (gone < total + ? `其中 ${formatNumber(gone)} 张在表结构中已没有,不会起草` + : total === 1 ? '表结构中已没有这张表,不能起草' : `表结构中已没有这 ${formatNumber(total)} 张表,不能起草`), // ---- 进行中 queued: '排队中,等待开始…', running: '正在起草…', @@ -2441,6 +2458,28 @@ export const CATALOG_DRAFT_TEXT = { modelUsed: (model: string) => `模型:${model}`, usage: (calls: number, input: number, output: number) => `调用模型 ${formatNumber(calls)} 次,输入 ${formatTokens(input, { compact: true })}、输出 ${formatTokens(output, { compact: true })}`, + /** + * 用量那一行接着写的:没写出来、超时的调用各几次(没有的不写)。没写出来的次数里含超时的,写成「其中」,免得 + * 读成两个数相加 + */ + usageFailures: (timeouts: number, failed: number) => { + if (failed && timeouts && timeouts <= failed) return `没写出来 ${formatNumber(failed)} 次(其中超时 ${formatNumber(timeouts)} 次)` + return [failed ? `没写出来 ${formatNumber(failed)} 次` : '', timeouts ? `超时 ${formatNumber(timeouts)} 次` : ''].filter(Boolean).join('、') + }, + usageFailuresHint: '没写出来:调用没有写出内容,包括额度用完、只给空壳、超时和出错', + // 超时的调用服务端照实记 0 个 token,服务方却可能已经生成了内容 + timeoutNote: '超时的调用不计用量,实际用量可能更多', + /** 额度用完、超时多了,服务端把之后的段缩小了 */ + partColumns: (n: number) => `模型多次用完额度或超时,之后的段每段最多 ${formatNumber(n)} 列`, + // ---- 留空的列:模型列出了、中文名和含义却都没给。表的状态不因此变 + blank: (n: number) => `${formatNumber(n)} 列模型拿不准、留空了`, + /** 留空的列名(服务端最多给 5 个);没列全时写一共几列 */ + blankSample: (sample: string[], n: number) => + `留空的列:${sample.join('、')}${n > sample.length ? ` 等 ${formatNumber(n)} 列` : ''}`, + blankTotal: (columns: number, tables: number) => `共 ${formatNumber(columns)} 列模型拿不准、留空了(${formatNumber(tables)} 张表)`, + blankAdvice: '可以在起草要求里补充缩写和术语的含义,再重新起草这几张表,已有的内容不会丢', + blankRedraft: (n: number) => `重新起草这 ${formatNumber(n)} 张表`, + blankRedraftHint: '回到起草设置,范围是这几张表:先在起草要求里补充缩写和术语的含义,再开始起草', // ---- 结束 title: { queued: '排队中,等待开始…', @@ -2470,6 +2509,7 @@ export const CATALOG_DRAFT_TEXT = { retryHint: '重新起草失败、部分完成和已停止的表;已写进目录的内容不受影响', showAll: (n: number) => `显示全部 ${formatNumber(n)} 张表`, showProblems: '只看未写全的表', + showProblemsBlank: '只看未写全、有留空列的表', tasks: '逐表进度', taskStatus: { pending: '等待', running: '起草中', ok: '已完成', partial: '部分完成', failed: '失败', skipped: '已跳过', cancelled: '已停止', @@ -2485,6 +2525,8 @@ export const CATALOG_DRAFT_TEXT = { toast: { succeeded: (summary: string) => `数据目录起草完成:${summary}`, partial: (n: number) => `数据目录起草完成,${formatNumber(n)} 张表未写全`, + /** 完成、部分完成的提示后面接着写留空的列(没有就不写) */ + withBlank: (text: string, blank: number) => (blank ? `${text};${formatNumber(blank)} 列模型拿不准、留空了` : text), failed: (reason: string) => (reason ? `数据目录起草失败:${reason}` : '数据目录起草失败'), cancelled: '数据目录起草已停止', interrupted: '服务重启,数据目录起草中断', @@ -2494,10 +2536,17 @@ export const CATALOG_DRAFT_TEXT = { lastFailed: '上次起草失败', lastPartial: '上次起草部分完成', lastWith: (label: string, reason: string) => `${label}:${reason}`, + /** 上次起草有留空的列:清单上是轻提示(不是失败标记),表详情顶部同一句 */ + lastBlank: (n: number) => `上次起草有 ${formatNumber(n)} 列模型拿不准、留空了`, + lastBlankAdvice: '可以在起草要求里补充缩写和术语的含义,再重新起草这张表,已有的内容不会丢', + draftGuidance: '补充起草要求', + draftGuidanceHint: '打开起草设置,范围是这张表:先在起草要求里补充缩写和术语的含义,再开始起草', redraft: '重新起草这张表', redraftHint: '用模型重新起草这张表(不带补充说明,带上数据源的起草要求);人工确认、驳回过的项不会被改动', redraftBusy: '已有起草任务在进行,结束后再重新起草这张表', redraftEditing: '正在编辑这张表,保存或取消后再重新起草', + /** 表结构里已经没有的表(只剩目录):上次起草的结果照写,不给重新起草(服务端只会把它记成已跳过) */ + redraftMissing: '表结构中已没有这张表,不能重新起草', } /** 设置页「偏好设置」里「起草模型」一节(服务端 api/settings.py 的 catalog_draft 一组) */ diff --git a/frontend/src/pages/catalog/CatalogPage.tsx b/frontend/src/pages/catalog/CatalogPage.tsx index 15f8e24e..3257ec32 100644 --- a/frontend/src/pages/catalog/CatalogPage.tsx +++ b/frontend/src/pages/catalog/CatalogPage.tsx @@ -1,7 +1,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react' import type { ReactNode } from 'react' import { useNavigate, useParams, useSearchParams } from 'react-router-dom' -import { ArrowLeft, BookMarked, Database, ListFilter as ListFilterIcon, ScanSearch, Sparkles } from 'lucide-react' +import { ArrowLeft, BookMarked, Database, ListFilter as ListFilterIcon, ScanSearch, Sparkles, TriangleAlert } from 'lucide-react' import clsx from 'clsx' import { ApiError, api } from '../../api/client' import type { CatalogDetail, CatalogList, CatalogTableRow } from '../../types' @@ -12,8 +12,8 @@ import { } from '../../lib/terms' import { StatusLegend, SystemNotesNotice } from './parts' import { DraftDialog } from './DraftDialog' -import { isJobActive, retryableCount, useDraftJob } from './draftJob' -import type { DraftStartBody } from './draftJob' +import { isJobActive, jobBlank, retryableCount, useDraftJob } from './draftJob' +import type { DraftPreset, DraftStartBody } from './draftJob' import { ProfileDialog } from './ProfileDialog' import type { ProfileJob } from './ProfileDialog' import { ProfileSettingsDialog } from './ProfileSettings' @@ -105,9 +105,9 @@ export function CatalogPage() { const [selected, setSelected] = useState>(() => new Set()) /** * 起草对话框开着没有、打开时显示什么:setup 选范围开始;job 显示页面跟着的任务(进行中的进度、刚结束的结果)。 - * busy:是撞上已有任务(409)转过去显示的 + * busy:是撞上已有任务(409)转过去显示的;preset:设置阶段预先选好的范围(表详情里「补充起草要求」) */ - const [draftOpen, setDraftOpen] = useState<{ view: 'setup' | 'job'; busy?: boolean } | null>(null) + const [draftOpen, setDraftOpen] = useState<{ view: 'setup' | 'job'; busy?: boolean; preset?: DraftPreset } | null>(null) /** 起草写进了这些表:详情据此重新载入(编辑中的不动,保存时服务端会用版本号拦下) */ const [drafted, setDrafted] = useState<{ seq: number; tables: Set }>({ seq: 0, tables: new Set() }) const [profiling, setProfiling] = useState(false) @@ -169,8 +169,10 @@ export function CatalogPage() { key: `catalog-draft:${src}`, duration: 10000, action: { label: DT.viewResult, onClick: () => { if (sourceRef.current === src) setDraftOpen({ view: 'job' }) } }, } - if (job.status === 'succeeded') toast.ok(DT.toast.succeeded(CT.draftSummary(job.added, job.updated, job.removed)), opts) - else if (job.status === 'partial') toast.warn(DT.toast.partial(retryableCount(job)), opts) + // 留空的列不算没写全,提示里接着写一句,点「查看结果」看是哪几张表、怎么办 + const blank = jobBlank(job) + if (job.status === 'succeeded') toast.ok(DT.toast.withBlank(DT.toast.succeeded(CT.draftSummary(job.added, job.updated, job.removed)), blank), opts) + else if (job.status === 'partial') toast.warn(DT.toast.withBlank(DT.toast.partial(retryableCount(job)), blank), opts) else if (job.status === 'failed') toast.error(DT.toast.failed(job.error ?? ''), opts) else if (job.status === 'interrupted') toast.warn(DT.toast.interrupted, opts) else toast.warn(DT.toast.cancelled, opts) @@ -195,6 +197,10 @@ export function CatalogPage() { toast.error(e) } }, [draft.start]) + /** 详情里「补充起草要求」(上次起草有留空的列):打开起草设置,范围只有这张表,先补起草要求再开始 */ + const draftWithGuidance = useCallback((t: string) => { + setDraftOpen({ view: 'setup', preset: { tables: [t], label: DT.scopeTable(t) } }) + }, []) const onGuidanceSaved = useCallback((g: string | null) => { setData((cur) => cur && ({ ...cur, guidance: g })) }, []) @@ -203,6 +209,8 @@ export function CatalogPage() { const stripJob: { done: number; total: number; status: string } | null = draftJob && (draftActive || draftJob.id === listActive?.id) ? (draftActive ? draftJob : null) : listActive + // 调用接连没写出来的提醒:关着对话框时也要看得到(上方的进度带着它) + const stripNotice = draftActive ? draftJob?.notice?.trim() || null : null const options = savedOptions?.sourceId === sourceId ? savedOptions.options : source?.options const profileSettings = useMemo(() => profileSettingsOf(options), [options]) @@ -400,7 +408,7 @@ export function CatalogPage() { ? ( + draftBusy={!!stripJob} onRedraft={redraftTable} onDraftGuidance={draftWithGuidance} /> ) : } @@ -430,7 +438,7 @@ export function CatalogPage() { onGoSource={() => navigate(back)} /> )} {hasTables && usage.used > 0 && !empty && } - {hasTables && stripJob && !draftOpen && } + {hasTables && stripJob && !draftOpen && } {body} {draftOpen && data && ( void }) { +function DraftStrip({ job, notice, onOpen }: { + job: { done: number; total: number; status: string } + notice: string | null + onOpen: () => void +}) { const text = job.status === 'queued' ? DT.stripQueued(job.total) : DT.strip(job.done, job.total) return (

{text}

+ {notice && ( +

+ + {notice} +

+ )}
[...s.trim()].length +/** 起草要求输入框的 id:预先选好范围回到设置时焦点放在这里 */ +const GUIDANCE_ID = 'catalog-draft-guidance' + /** * 建任务(开始、只重试失败的表)没建成怎么说。起草模型用不了(409,建任务和重试都会回):服务端那句话已经写了原因和 * 去处,照原样,长句也不拆成「标题:原因」;别的错误前面写明没有开始 @@ -35,8 +45,8 @@ const startErrorText = (e: unknown) => (e instanceof ApiError && e.code === DRAFT_MODEL_UNAVAILABLE ? e.message : DT.startFailed(errorMessage(e))) export function DraftDialog({ - sourceId, sourceDescription, guidance, rows, visible, selected, filtered, job, initial, initialBusy = false, stopping, - onStart, onCancel, onRetry, onTrack, onGuidanceSaved, onClose, + sourceId, sourceDescription, guidance, rows, visible, selected, filtered, job, initial, initialBusy = false, preset: initialPreset = null, + stopping, onStart, onCancel, onRetry, onTrack, onGuidanceSaved, onClose, }: { sourceId: string /** 数据源说明:用模型起草时连同起草要求一起交给模型 */ @@ -56,6 +66,12 @@ export function DraftDialog({ initial: 'setup' | 'job' /** 打开时显示的任务是撞上已有任务(409)转过来的:写明 */ initialBusy?: boolean + /** + * 打开设置时预先选好的范围(表详情里「补充起草要求」:只有那张表)。给了就选它;里面有可起草的表时勾上用模型、 + * 焦点放在起草要求上(打开它就是为了先补起草要求再起草)。一张可起草的都没有(已不在表结构里)时照旧选着它、 + * 写明原因、不能开始,也不勾用模型——不退回别的范围 + */ + preset?: DraftPreset | null /** 点了停止、服务端还没停下来 */ stopping: boolean /** 建任务;409 已有任务时页面改取进行中的那一个(busy 为真) */ @@ -71,8 +87,16 @@ export function DraftDialog({ // 表结构里已经没有的表起草不了(服务端会记「已跳过」),不算进范围 const live = useMemo(() => rows.filter((r) => r.in_schema).map((r) => r.table_name), [rows]) const liveSet = useMemo(() => new Set(live), [live]) + /** 预先选好的范围:打开时给的,或者结果里点了「重新起草这几张表」 */ + const [preset, setPreset] = useState(initialPreset) const scopes = useMemo(() => { - const out: { key: Scope; label: string; tables: string[] }[] = [] + const out: { key: Scope; label: string; tables: string[]; gone?: number }[] = [] + // 预先选好的范围总在第一项:里面的表已经不在表结构里的(打开表详情以后别处重新探查了结构)不起草、写明有几张; + // 一张都不剩也留着这一项,不退回别的范围——以为只起草那一张,实际按别的范围用模型起草了 + if (preset) { + const pre = preset.tables.filter((t) => liveSet.has(t)) + out.push({ key: 'preset', label: preset.label, tables: pre, gone: preset.tables.length - pre.length }) + } const sel = selected.filter((t) => liveSet.has(t)) if (sel.length) out.push({ key: 'selected', label: CT.scopeSelected(sel.length), tables: sel }) const vis = visible.filter((r) => r.in_schema).map((r) => r.table_name) @@ -80,11 +104,17 @@ export function DraftDialog({ if (live.length > DRAFT_TOP_N) out.push({ key: 'top', label: CT.scopeTop(DRAFT_TOP_N), tables: live.slice(0, DRAFT_TOP_N) }) out.push({ key: 'all', label: CT.scopeAll(live.length), tables: live }) return out - }, [selected, visible, filtered, live, liveSet]) + }, [preset, selected, visible, filtered, live, liveSet]) const [scope, setScope] = useState(() => scopes[0].key) - const tables = scopes.find((s) => s.key === scope)?.tables ?? scopes[0].tables + /** 起草的就是这一项:选的那一项不在了(所选、筛选变了)就是第一项,单选框也照它勾,看得见起草的是哪些 */ + const current = scopes.find((s) => s.key === scope) ?? scopes[0] + const tables = current.tables const tooMany = tables.length > DRAFT_MAX_TABLES - const [useModel, setUseModel] = useState(false) + /** 打开时给的范围里有可起草的表:勾上用模型、焦点放进起草要求(打开它就是为了先补起草要求);一张都没有就都不做 */ + const presetLive = !!initialPreset && initialPreset.tables.some((t) => liveSet.has(t)) + const [useModel, setUseModel] = useState(presetLive) + /** 回到设置以后把焦点放进起草要求(预先选好范围的两种入口都是为了先补起草要求) */ + const [focusGuidance, setFocusGuidance] = useState(presetLive) const [guidanceText, setGuidanceText] = useState(guidance) const [note, setNote] = useState('') const guidanceLen = charCount(guidanceText) @@ -100,7 +130,7 @@ export function DraftDialog({ const [busy, setBusy] = useState(initialBusy) const [acting, setActing] = useState(false) const [actionError, setActionError] = useState(null) - /** 上一次起草(没写全的才提),设置阶段写一行、可以点开 */ + /** 上一次起草(没写全、有留空列的才提),设置阶段写一行、可以点开 */ const [last, setLast] = useState(null) /** 起草模型的说法:设置里的起草模型,没配就是跟随助手的模型 */ const [modelLine, setModelLine] = useState<{ text: string; warn: string | null } | null>(null) @@ -118,13 +148,22 @@ export function DraftDialog({ onTrackRef.current(latest) setBusy(true) setMode('job') - } else if (latest.status !== 'succeeded') { + } else if (latest.status !== 'succeeded' || jobBlank(latest) > 0) { setLast(latest) } }, () => {}) return () => { alive = false } }, [inSetup, sourceId]) + // 预先选好范围回到设置(打开时给的、结果里点的):焦点放进起草要求 + useEffect(() => { + if (!focusGuidance || mode !== 'setup' || !useModel) return + const el = document.getElementById(GUIDANCE_ID) + if (!el) return + el.focus() + setFocusGuidance(false) + }, [focusGuidance, mode, useModel]) + // 起草模型:设置里的 catalog_draft 填了就是它;没填跟随助手的模型(写出当前是哪个,用不了时写原因) useEffect(() => { let alive = true @@ -192,6 +231,26 @@ export function DraftDialog({ setBusy(false) setMode('job') } + /** + * 结果里「重新起草这几张表」(有留空列的表):回到设置,范围就是这几张,勾上用模型,焦点放进起草要求——先补上 + * 缩写和术语的含义再开始。任务本身不动(页面照旧跟着它,开始新的起草才换) + */ + const redraftBlank = (names: string[]) => { + setPreset({ tables: names, label: DT.scopeBlank(names.length) }) + setScope('preset') + setUseModel(true) + setFocusGuidance(true) + setStartError(null) + setActionError(null) + setBusy(false) + setLast(null) + setMode('setup') + } + /** 结果里有留空列、还在表结构里的表(「重新起草这几张表」的范围) */ + const blankTables = useMemo( + () => (job ? job.tasks.filter((t) => blankOf(t) > 0 && liveSet.has(t.table_name)).map((t) => t.table_name) : []), + [job, liveSet], + ) const phase: 'setup' | 'running' | 'done' = inSetup ? 'setup' : isJobActive(job) ? 'running' : 'done' const canStart = !!tables.length && !tooMany && !(useModel && (guidanceOver || noteOver)) && !starting @@ -235,9 +294,16 @@ export function DraftDialog({
{scopes.map((s) => ( ))}
@@ -261,7 +327,7 @@ export function DraftDialog({ {modelLine?.warn && {modelLine.warn}}
- {(p) => (