fix(采集数据): 终态卡片把关键词缺口写出来,而不是把进度条画满

task 31253 的「已完成 + 总进度 25%」被当成显示 bug 报上来,实际那根条是卡片上
唯一说真话的一格:8 个关键词只处理了 2 个。强制 SUCCESS 显示 100% 会把提前结束
抹平,所以这里反过来——终态却没跑完时在卡片上补一行关键词缺口。

判据单独放 src/shared/utils/task-progress-readout.ts:.vue 在本套件挂不起来,
留在组件里就没法真测。终态词表复用 task-terminal 那份,不自建第二套
(tests/task-terminal-set-single-source.test.ts 抓到过一次)。
This commit is contained in:
2026-10-18 16:56:41 +08:00
parent d58546d314
commit d22a9e2164
3 changed files with 91 additions and 0 deletions
@@ -0,0 +1,39 @@
/**
* 终态任务卡片的进度读数。
*
* 为什么单独放一个文件:这条判据只能从 .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} 个关键词未采集`
}