88 lines
12 KiB
TypeScript
88 lines
12 KiB
TypeScript
import { useEffect, useState } from 'react';
|
||
import { api, downloadArtifact, downloadBlob, downloadModelLedger } from './api';
|
||
import { ModelUsageDetails } from './ModelUsageDetails';
|
||
import { ModelRoutingDetails, type RoutingDecision } from './ModelRoutingDetails';
|
||
import { ModelIdentityDetails } from './ModelIdentityDetails';
|
||
import { ModelErrorDetails } from './ModelErrorDetails';
|
||
import { protocolLabel } from '../shared/contracts/model-endpoint.mjs';
|
||
import type { ModelIdentity } from '../shared/contracts/model-identity.mjs';
|
||
import type { TokenUsage } from '../shared/contracts/model-usage.mjs';
|
||
import type { RuntimeFailure } from './types';
|
||
import './ModelRequestLedger.css';
|
||
import { ModelRequestDetails } from './ModelRequestDetails';
|
||
import { ModelProviderStateDetails, type ProviderStateAuditView } from './ModelProviderStateDetails';
|
||
import type { PreparedRequestMetadata } from './types';
|
||
|
||
export type ModelAttempt = { routingDecision?: RoutingDecision; modelIdentity?: ModelIdentity; diagnostic?: RuntimeFailure; requestUrl?: string; requestMetadata?: PreparedRequestMetadata;
|
||
nativeStateAudit?: ProviderStateAuditView; affinityPersistence?: { status: string; reason?: string };
|
||
upstreamResponse?: { requestId?: string | null; responseUrl?: string | null; headers?: Record<string, string> }; id: string; connectionId?: string; model?: string; protocol?: string; streaming?: boolean;
|
||
rejections?: { connectionName: string; capability: string; reason: string }[]; status: string; startedAt: string; ordinal?: number; usageStatus: string; reason?: string;
|
||
taskId?: string; sessionId?: string; runId?: string; requestArtifactId?: string; responseArtifactId?: string; responseSha256?: string; responseRedacted?: boolean;
|
||
stream?: { bytes: number; capturedBytes?: number; frames: number; sha256: string; terminal: boolean }; usage?: TokenUsage | null };
|
||
type ReceiptReference = { sequence: number; payloadSha256: string; initialSha256: string; origin: string; legacyIndex?: number };
|
||
type LedgerPage = { items: ModelAttempt[]; references: ReceiptReference[]; total: number; retainedTotal: number; nextCursor: string | null; hasMore: boolean; snapshotSequence: number; connectionIds: string[] };
|
||
const states: Record<string, string> = { completed: '收到响应', failed: '请求失败', unknown: '结果未知', interrupted: '已中断', running: '请求中', rejected: '未派发' };
|
||
const address = (filters: Record<string, string>, cursor: string | null = null) => {
|
||
const params = new URLSearchParams({ ...filters, limit: '50', ...(cursor ? { cursor } : {}) }); return '/model-center/attempts?' + params.toString();
|
||
};
|
||
|
||
export function ModelRequestLedger({ connections, refreshVersion }: { connections: { id: string; name: string }[]; refreshVersion: unknown }) {
|
||
const [page, setPage] = useState<LedgerPage | null>(null), [cursor, setCursor] = useState<string | null>(null), [previous, setPrevious] = useState<(string | null)[]>([]);
|
||
const [filters, setFilters] = useState<Record<string, string>>({}), [query, setQuery] = useState(''), [status, setStatus] = useState(''), [connection, setConnection] = useState('');
|
||
const [historyConnections, setHistoryConnections] = useState<string[]>([]);
|
||
const [loading, setLoading] = useState(false), [working, setWorking] = useState(false), [error, setError] = useState(''), [revision, setRevision] = useState(0);
|
||
useEffect(() => {
|
||
let alive = true; setLoading(true); setError(''); setPage(null);
|
||
api<LedgerPage>(address(filters, cursor)).then(value => { if (alive) { setPage(value); setHistoryConnections(value.connectionIds); } }).catch(cause => { if (alive) setError(cause.message); }).finally(() => { if (alive) setLoading(false); });
|
||
return () => { alive = false; };
|
||
}, [filters, cursor, revision, refreshVersion]);
|
||
async function act(action: () => Promise<void>) { setWorking(true); setError(''); try { await action(); } catch (cause) { setError(cause instanceof Error ? cause.message : '记录未能读取,请刷新核对。'); } finally { setWorking(false); } }
|
||
const disabled = working || loading;
|
||
function reset() { setCursor(null); setPrevious([]); setRevision(value => value + 1); }
|
||
const ledgerConnections = [...connections, ...historyConnections.filter(id => !connections.some(value => value.id === id)).map(id => ({ id, name: id + '(历史连接)' }))];
|
||
function pager(location: string) { return page && <nav className="mc-ledger-pages" aria-label={'请求账本分页 · ' + location}><span>本页 {page.items.length} 条 · 当前范围 {page.total.toLocaleString('zh-CN')} 条</span>
|
||
<button className="button secondary" disabled={disabled || previous.length === 0} onClick={() => { setCursor(previous.at(-1) ?? null); setPrevious(value => value.slice(0, -1)); }}>上一页</button>
|
||
<button className="button secondary" disabled={disabled || !page.hasMore} onClick={() => { setPrevious(value => [...value, cursor]); setCursor(page.nextCursor); }}>下一页</button></nav>; }
|
||
return <section className="mc-ledger" aria-label="完整请求账本" aria-busy={loading || working}>
|
||
<div className="mc-section-title"><div><h3>请求账本</h3><p>完整保存历史请求;每页展示 50 条,可筛选和导出全部记录。未知用量保持未知。</p></div>
|
||
<span>{page ? page.retainedTotal.toLocaleString('zh-CN') + ' 条已保存' : loading ? '正在读取' : '尚未取得记录'}</span></div>
|
||
<form className="mc-ledger-filter" aria-label="筛选请求账本" onSubmit={event => { event.preventDefault(); setFilters({ ...(query ? { query } : {}), ...(status ? { status } : {}), ...(connection ? { connectionId: connection } : {}) }); reset(); }}>
|
||
<label>搜索原记录<input aria-label="搜索请求账本" value={query} onChange={event => setQuery(event.target.value)} placeholder="型号、请求 ID、Run 或错误原文" /></label>
|
||
<label>连接<select aria-label="筛选账本连接" value={connection} onChange={event => setConnection(event.target.value)}><option value="">全部连接</option>{ledgerConnections.map(value => <option key={value.id} value={value.id}>{value.name}</option>)}</select></label>
|
||
<label>结果<select aria-label="筛选账本结果" value={status} onChange={event => setStatus(event.target.value)}><option value="">全部结果</option>{Object.entries(states).map(([value, name]) => <option key={value} value={value}>{name}</option>)}</select></label>
|
||
<button className="button secondary" disabled={disabled}>筛选记录</button>
|
||
</form>
|
||
<div className="mc-ledger-actions"><button className="button secondary" disabled={disabled} onClick={reset}>刷新记录</button>
|
||
<button className="button secondary" disabled={disabled || !page} onClick={() => void act(() => downloadModelLedger(filters))}>导出当前范围全部记录</button>
|
||
{page && <span>{Object.keys(filters).length ? '本次筛选 ' : '当前范围 '}{page.total.toLocaleString('zh-CN')} 条 · 记录按序号分页,进行中的字段仍会更新</span>}</div>
|
||
{error && <p className="mc-card-warning" role="alert">{error}</p>}
|
||
{!loading && page?.items.length === 0 && <p className="mc-empty">当前范围没有请求记录。调整筛选不会发送模型请求。</p>}
|
||
{pager('列表上方')}
|
||
<div className="mc-attempts">{page?.items.map((value, index) => {
|
||
const source = page.references[index];
|
||
return <article key={source.sequence} data-ledger-sequence={source.sequence}>
|
||
<div><span className={'mc-state mc-state-' + value.status}>{states[value.status] ?? value.status}</span><strong>{value.model ?? '未派发'}</strong><time>{value.startedAt ? new Date(value.startedAt).toLocaleString() : '原记录未保存时间'}</time></div>
|
||
<p>{connections.find(connection => connection.id === value.connectionId)?.name || value.connectionId || '未派发'} · {value.protocol ? protocolLabel(value.protocol) : '原记录未保存协议'}{value.streaming ? ' · 流式' : ''} · {value.ordinal ? '尝试 ' + value.ordinal : '未发送'} · {value.usageStatus === 'reported' ? `${value.usage?.prompt_tokens ?? '?'} 输入 / ${value.usage?.completion_tokens ?? '?'} 输出 tokens` : value.usageStatus === 'not_dispatched' ? '未产生请求用量' : '用量未知'}</p>
|
||
<ModelUsageDetails usage={value.usage} /><code>Run {value.runId ?? '原记录未保存'}</code>
|
||
<details className="mc-ledger-source"><summary>记录来源与 SHA256</summary><p>序号 {source.sequence} · {source.origin === 'legacy-metadata' ? '原账本完整迁移,原 metadata 保留' : '本次尝试独立保存'}</p>
|
||
<dl><dt>本条记录</dt><dd><code>{source.payloadSha256}</code></dd><dt>初始记录</dt><dd><code>{source.initialSha256}</code></dd></dl>
|
||
<button className="button secondary" disabled={disabled} onClick={() => void act(async () => { const record = await api('/model-center/attempts/' + source.sequence); downloadBlob(new Blob([JSON.stringify(record, null, 2)], { type: 'application/json' }), 'orven-model-request-' + source.sequence + '.json'); })}>下载本条与初始记录</button>
|
||
</details>
|
||
{value.stream && <div className="mc-stream-receipt"><p>{value.stream.terminal ? '响应完整终结' : '响应未完整,片段保留待核对'} · 已接收 {value.stream.bytes.toLocaleString()} bytes · {value.stream.frames} 个事件{value.stream.capturedBytes !== undefined && value.stream.capturedBytes < value.stream.bytes ? ' · 仅保存上限内片段' : ''}</p><code>原流 SHA256 {value.stream.sha256}</code></div>}
|
||
{value.responseSha256 && <code>工件 SHA256 {value.responseSha256}{value.responseRedacted ? '(已脱敏)' : ''}</code>}
|
||
{value.sessionId && value.responseArtifactId && <button className="button secondary" disabled={disabled} onClick={() => void act(() => downloadArtifact(value.sessionId!, value.responseArtifactId!, 'model-response-' + value.id + (value.streaming ? '.sse' : '.json')))}>下载已保存的响应</button>}
|
||
{value.requestUrl && <p className="mc-request-url">请求地址:{value.requestUrl}{value.upstreamResponse?.responseUrl && <><br />响应地址:{value.upstreamResponse.responseUrl}</>}</p>}
|
||
{value.requestMetadata && <ModelRequestDetails request={value.requestMetadata} responseHeaders={value.upstreamResponse?.headers} />}
|
||
{value.reason && <p className="mc-card-warning">{value.reason}</p>}
|
||
<ModelRoutingDetails decision={value.routingDecision} /><ModelIdentityDetails identity={value.modelIdentity} requestedModel={value.model ?? '原记录未保存'} />
|
||
<ModelProviderStateDetails audit={value.nativeStateAudit} />
|
||
{value.affinityPersistence && ['unknown', 'retained-unknown'].includes(value.affinityPersistence.status) && <p className="mc-card-warning">连接保持记录{value.affinityPersistence.status === 'unknown' ? '保存结果未知' : '暂不能解释,原件保留'};本次模型响应仍按原结果处理。{value.affinityPersistence.reason}</p>}
|
||
{value.diagnostic && <ModelErrorDetails failure={value.diagnostic} />}{!value.diagnostic && value.upstreamResponse?.requestId && <p className="mc-help">上游请求 ID:{value.upstreamResponse.requestId}</p>}
|
||
{value.requestArtifactId && value.sessionId && <button className="button secondary" disabled={disabled} onClick={() => void act(() => downloadArtifact(value.sessionId!, value.requestArtifactId!, 'model-request-' + value.id + '.json'))}>下载实际请求</button>}
|
||
{!!value.rejections?.length && <p className="mc-route-rejections">{value.rejections.map(item => item.connectionName + ':' + item.capability + ' · ' + item.reason).join(';')}</p>}
|
||
</article>;
|
||
})}</div>
|
||
{pager('列表下方')}
|
||
</section>;
|
||
}
|