fix(ui): 已释放窗口不再渲染 held 文案,版本页不再把 500 说成未接线
build / build (push) Failing after 18s

发布管理:maintenanceSummary 只看 job.state === 'failed' 就给 held 处置文案;
窗口已 released 的旧作业(libsync-internal-1793399248431728863)因此自相矛盾。
改为仅 held 时给 recoveryError,已释放时给 releasedFailure(如实记录失败,不提供强制成功)。

版本记录:LoadVersionHistorySyncState 把可空的 finished_at 扫进 time.Time;
部署重启触发的同步在"进行中"时该列为 NULL,扫描失败使整页 500
(nginx access log:GET /api/v1/version-history?limit=30 → 500,74 字节错误体)。
改为指针接值再判空。前端同时区分"未配置/加载失败"并显示服务端 code。

RED/GREEN:新增 Go 集成用例(NULL finished_at)、两条前端用例;
make verify 16/16 通过(local 档案)。
This commit is contained in:
姚章浩
2026-11-01 19:34:31 +08:00
parent 943b617b1f
commit e34306b2db
76 changed files with 12038 additions and 2505 deletions
+185 -35
View File
@@ -1,39 +1,189 @@
export type MonitorStatus='completed'|'pending'|'processing'|'finalizing'|'failed'|'cancelled'
export interface MonitorHost{cpu_percent:number;memory_used_bytes:number;memory_total_bytes:number;disk_used_bytes:number;disk_total_bytes:number;gpu_state:string;gpu_detail:string;simulated:boolean}
export interface MonitorService{key:string;name:string;state:string;detail:string;latency_ms:number;observed_at:string;simulated:boolean}
export interface KnowledgeProgress{id:string;name:string;visibility:string;imported:number;completed:number;pending:number;processing:number;finalizing:number;failed:number;cancelled:number;planned:number;needs_removal:number;stale_planned:number;internal_imported:number;internal_completed:number;external_imported:number;external_completed:number}
export interface ServiceHealth{key:string;name:string;liveness:string;readiness:string;reason:string;latency_ms:number;observed_at:string;last_success_at:string|null;consecutive_failures:number;configured:boolean;applicable:boolean}
export interface IngestionPipeline{fetch_pending:number;fetch_failed:number;fetch_missing:number;concurrency:number}
export interface MonitorOverview{mode:string;simulated:boolean;observed_at:string;host:MonitorHost;services:MonitorService[];knowledge_bases:KnowledgeProgress[];pipeline?:IngestionPipeline;health:ServiceHealth[]}
export interface MonitorFile{name:string;directory:string;visibility:string;status:MonitorStatus;stage_detail:string;elapsed_seconds:number;error_code:string}
export interface MonitorFilePage{items:MonitorFile[];total:number;limit:number;offset:number;sample_only:boolean}
const record=(value:unknown):value is Record<string,unknown>=>typeof value==='object'&&value!==null
export async function fetchMonitorOverview(signal?:AbortSignal):Promise<MonitorOverview>{
const response=await fetch('/api/v1/monitor/overview',{headers:{Accept:'application/json'},signal});if(!response.ok)throw new Error(`加载解析监控失败(HTTP ${response.status})`)
const value=await response.json() as unknown;if(!record(value)||typeof value.mode!=='string'||typeof value.simulated!=='boolean'||!record(value.host)||!Array.isArray(value.services)||!Array.isArray(value.knowledge_bases))throw new Error('解析监控响应无效')
const health=Array.isArray(value.health)?(value.health as unknown[]).filter(record):[]
return {...value,health} as unknown as MonitorOverview
export type MonitorStatus = 'completed' | 'pending' | 'processing' | 'finalizing' | 'failed' | 'cancelled'
export interface MonitorHost {
cpu_percent: number
memory_used_bytes: number
memory_total_bytes: number
disk_used_bytes: number
disk_total_bytes: number
gpu_state: string
gpu_detail: string
simulated: boolean
}
export async function fetchMonitorFiles(knowledgeBaseID:string,status:MonitorStatus|'',limit=20,offset=0,signal?:AbortSignal):Promise<MonitorFilePage>{
const query=new URLSearchParams();if(status)query.set('status',status);query.set('limit',String(limit));query.set('offset',String(offset))
const response=await fetch(`/api/v1/monitor/knowledge-bases/${encodeURIComponent(knowledgeBaseID)}/files?${query}`,{headers:{Accept:'application/json'},signal});if(!response.ok)throw new Error(`加载文档阶段失败(HTTP ${response.status})`)
const value=await response.json() as unknown;if(!record(value)||!Array.isArray(value.items)||typeof value.total!=='number'||typeof value.sample_only!=='boolean')throw new Error('文档阶段响应无效')
return value as unknown as MonitorFilePage
export interface MonitorService {
key: string
name: string
state: string
detail: string
latency_ms: number
observed_at: string
simulated: boolean
}
export interface KnowledgeProgress {
id: string
name: string
visibility: string
imported: number
completed: number
pending: number
processing: number
finalizing: number
failed: number
cancelled: number
planned: number
needs_removal: number
stale_planned: number
internal_imported: number
internal_completed: number
external_imported: number
external_completed: number
}
export interface ServiceHealth {
key: string
name: string
liveness: string
readiness: string
reason: string
latency_ms: number
observed_at: string
last_success_at: string | null
consecutive_failures: number
configured: boolean
applicable: boolean
}
export interface IngestionPipeline {
fetch_pending: number
fetch_failed: number
fetch_missing: number
concurrency: number
}
export interface MonitorOverview {
mode: string
simulated: boolean
observed_at: string
host: MonitorHost
services: MonitorService[]
knowledge_bases: KnowledgeProgress[]
pipeline?: IngestionPipeline
health: ServiceHealth[]
}
export interface MonitorFile {
name: string
directory: string
visibility: string
status: MonitorStatus
stage_detail: string
elapsed_seconds: number
error_code: string
}
export interface MonitorFilePage {
items: MonitorFile[]
total: number
limit: number
offset: number
sample_only: boolean
}
const record = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null
export async function fetchMonitorOverview(signal?: AbortSignal): Promise<MonitorOverview> {
const response = await fetch('/api/v1/monitor/overview', { headers: { Accept: 'application/json' }, signal })
if (!response.ok) throw new Error(`加载解析监控失败(HTTP ${response.status})`)
const value = (await response.json()) as unknown
if (
!record(value) ||
typeof value.mode !== 'string' ||
typeof value.simulated !== 'boolean' ||
!record(value.host) ||
!Array.isArray(value.services) ||
!Array.isArray(value.knowledge_bases)
)
throw new Error('解析监控响应无效')
const health = Array.isArray(value.health) ? (value.health as unknown[]).filter(record) : []
return { ...value, health } as unknown as MonitorOverview
}
export async function fetchMonitorFiles(
knowledgeBaseID: string,
status: MonitorStatus | '',
limit = 20,
offset = 0,
signal?: AbortSignal
): Promise<MonitorFilePage> {
const query = new URLSearchParams()
if (status) query.set('status', status)
query.set('limit', String(limit))
query.set('offset', String(offset))
const response = await fetch(
`/api/v1/monitor/knowledge-bases/${encodeURIComponent(knowledgeBaseID)}/files?${query}`,
{ headers: { Accept: 'application/json' }, signal }
)
if (!response.ok) throw new Error(`加载文档阶段失败(HTTP ${response.status})`)
const value = (await response.json()) as unknown
if (
!record(value) ||
!Array.isArray(value.items) ||
typeof value.total !== 'number' ||
typeof value.sample_only !== 'boolean'
)
throw new Error('文档阶段响应无效')
return value as unknown as MonitorFilePage
}
export interface JobWindowMetrics{window_seconds:number;jobs_started:number;jobs_completed:number;jobs_failed:number;success_rate:number|null;failure_rate:number|null;duration_avg_seconds:number|null;duration_p50_seconds:number|null;duration_p95_seconds:number|null}
export interface RunMetrics{observed_at:string;active_workers:number;worker_source:'pg_lease'|'simulation';queue:{pending:number;running:number;retry:number;failed:number;oldest_pending_age_seconds:number|null};short_window:JobWindowMetrics;long_window:JobWindowMetrics}
const finiteOrNull=(value:unknown)=>typeof value==='number'&&Number.isFinite(value)?value:null
const numberOr=(value:unknown,fallback=0)=>typeof value==='number'&&Number.isFinite(value)?value:fallback
const windowMetrics=(value:unknown):JobWindowMetrics=>{if(!record(value))throw new Error('运行指标窗口响应无效')
return{window_seconds:numberOr(value.window_seconds),jobs_started:numberOr(value.jobs_started),jobs_completed:numberOr(value.jobs_completed),jobs_failed:numberOr(value.jobs_failed),success_rate:finiteOrNull(value.success_rate),failure_rate:finiteOrNull(value.failure_rate),duration_avg_seconds:finiteOrNull(value.duration_avg_seconds),duration_p50_seconds:finiteOrNull(value.duration_p50_seconds),duration_p95_seconds:finiteOrNull(value.duration_p95_seconds)}}
export async function fetchRunMetrics(signal?:AbortSignal):Promise<RunMetrics>{
const response=await fetch('/api/v1/monitor/metrics',{headers:{Accept:'application/json'},signal});if(!response.ok)throw new Error(`加载运行指标失败(HTTP ${response.status})`)
const value=await response.json() as unknown;if(!record(value)||!record(value.data))throw new Error('运行指标响应无效')
const data=value.data as Record<string,unknown>
if(data.worker_source!=='pg_lease'&&data.worker_source!=='simulation')throw new Error('运行指标缺少数据来源标记')
if(!record(data.queue)||!record(data.short_window)||!record(data.long_window))throw new Error('运行指标字段不完整')
return{observed_at:typeof data.observed_at==='string'?data.observed_at:'',active_workers:numberOr(data.active_workers),worker_source:data.worker_source as RunMetrics['worker_source'],
queue:{pending:numberOr(data.queue.pending),running:numberOr(data.queue.running),retry:numberOr(data.queue.retry),failed:numberOr(data.queue.failed),oldest_pending_age_seconds:finiteOrNull(data.queue.oldest_pending_age_seconds)},
short_window:windowMetrics(data.short_window),long_window:windowMetrics(data.long_window)}
export interface JobWindowMetrics {
window_seconds: number
jobs_started: number
jobs_completed: number
jobs_failed: number
success_rate: number | null
failure_rate: number | null
duration_avg_seconds: number | null
duration_p50_seconds: number | null
duration_p95_seconds: number | null
}
export interface RunMetrics {
observed_at: string
active_workers: number
worker_source: 'pg_lease' | 'simulation'
queue: { pending: number; running: number; retry: number; failed: number; oldest_pending_age_seconds: number | null }
short_window: JobWindowMetrics
long_window: JobWindowMetrics
}
const finiteOrNull = (value: unknown) => (typeof value === 'number' && Number.isFinite(value) ? value : null)
const numberOr = (value: unknown, fallback = 0) =>
typeof value === 'number' && Number.isFinite(value) ? value : fallback
const windowMetrics = (value: unknown): JobWindowMetrics => {
if (!record(value)) throw new Error('运行指标窗口响应无效')
return {
window_seconds: numberOr(value.window_seconds),
jobs_started: numberOr(value.jobs_started),
jobs_completed: numberOr(value.jobs_completed),
jobs_failed: numberOr(value.jobs_failed),
success_rate: finiteOrNull(value.success_rate),
failure_rate: finiteOrNull(value.failure_rate),
duration_avg_seconds: finiteOrNull(value.duration_avg_seconds),
duration_p50_seconds: finiteOrNull(value.duration_p50_seconds),
duration_p95_seconds: finiteOrNull(value.duration_p95_seconds),
}
}
export async function fetchRunMetrics(signal?: AbortSignal): Promise<RunMetrics> {
const response = await fetch('/api/v1/monitor/metrics', { headers: { Accept: 'application/json' }, signal })
if (!response.ok) throw new Error(`加载运行指标失败(HTTP ${response.status})`)
const value = (await response.json()) as unknown
if (!record(value) || !record(value.data)) throw new Error('运行指标响应无效')
const data = value.data as Record<string, unknown>
if (data.worker_source !== 'pg_lease' && data.worker_source !== 'simulation')
throw new Error('运行指标缺少数据来源标记')
if (!record(data.queue) || !record(data.short_window) || !record(data.long_window))
throw new Error('运行指标字段不完整')
return {
observed_at: typeof data.observed_at === 'string' ? data.observed_at : '',
active_workers: numberOr(data.active_workers),
worker_source: data.worker_source as RunMetrics['worker_source'],
queue: {
pending: numberOr(data.queue.pending),
running: numberOr(data.queue.running),
retry: numberOr(data.queue.retry),
failed: numberOr(data.queue.failed),
oldest_pending_age_seconds: finiteOrNull(data.queue.oldest_pending_age_seconds),
},
short_window: windowMetrics(data.short_window),
long_window: windowMetrics(data.long_window),
}
}