/** * 终态任务卡片的进度读数。 * * 为什么单独放一个文件:这条判据只能从 .vue 里挂出来测(本套件没有 @vue/test-utils, * 见 tests/task-terminal-completed-behavior.test.ts 的说明),而它恰好是线上事故 * (task 31253:已完成 + 总进度 25% + 下载空白)里唯一说真话的那一格。 * * 铁律:**不许**因为状态是 SUCCESS 就把没跑完的关键词抹成 100%。 * processedRows < totalRows 是「任务提前结束」的表征,把它显示出来是这条读数的用途, * 不是它的 bug。 */ import { isTerminalTaskStatus } from './task-terminal.ts' export interface TerminalProgressItem { taskStatus?: string | null success?: boolean | null processedRows?: number | null totalRows?: number | null } function isTerminal(item: TerminalProgressItem): boolean { return item.success === true || isTerminalTaskStatus(item.taskStatus || undefined) } /** * 终态且关键词没跑完时返回一句缺口说明,否则返回空串。 * 行数缺失(totalRows 非正数)时不猜,返回空串——没有分母就没有缺口可言。 */ export function terminalKeywordShortfall(item: TerminalProgressItem): string { if (!isTerminal(item)) return '' const total = Number(item.totalRows) const processed = Number(item.processedRows ?? 0) if (!Number.isFinite(total) || total <= 0) return '' if (!Number.isFinite(processed) || processed >= total) return '' const status = (item.taskStatus || '').toUpperCase() const label = status === 'FAILED' ? '任务失败于' : '任务提前结束于' return `关键词缺口:${label} ${processed}/${total},还有 ${total - processed} 个关键词未采集` }