feat(models): preserve complete incremental request ledger and exports

This commit is contained in:
Agent Workbench Dev
2026-11-07 12:38:44 +08:00
parent a93bfd6885
commit da2e631381
16 changed files with 888 additions and 28 deletions
+4 -9
View File
@@ -1,13 +1,9 @@
import { useEffect, useRef, useState } from 'react';
import { Activity, Check, CircleHelp, KeyRound, Layers3, Plus, Power, RefreshCw, Route, Server, Settings2 } from 'lucide-react';
import { api, downloadArtifact } from './api';
import { api } from './api';
import type { Config, ModelSelection, ModelSnapshot, RuntimeFailure } from './types';
import './ModelCenter.css';
import { ModelUsageDetails } from './ModelUsageDetails';
import type { TokenUsage } from '../shared/contracts/model-usage.mjs';
import { ModelIdentityDetails } from './ModelIdentityDetails';
import { ModelRoutingDetails, type RoutingDecision } from './ModelRoutingDetails';
import type { ModelIdentity } from '../shared/contracts/model-identity.mjs';
import { ModelRequestLedger, type ModelAttempt } from './ModelRequestLedger';
import { ModelWaitSettings, type WaitSettings } from './ModelWaitSettings';
import { NativeParameters } from './NativeParameters';
import { ModelErrorDetails } from './ModelErrorDetails';
@@ -27,9 +23,8 @@ const upstreamCapacity = (value: { model: string; upstreamModel?: CatalogModel }
type Connection = { id: string; name: string; brand: string; protocol: string; parameterProfile?: string; messagesAuth?: string; baseUrl: string; model: string; enabled: boolean; revision: number; hasKey: boolean; credentialSource?: { connectionId: string }; upstreamModel?: CatalogModel;
requiresKey: boolean; modelIdentityPolicy?: string; modelIdentityAliases?: string[]; modelIdentityAliasSource?: string; nativeParameters?: Record<string, unknown>; outputTokenField?: string; streaming?: boolean; capabilityDeclarations?: Record<string, string>; capabilities?: Record<string, string>; capabilityEvidence?: { checkedAt: string }; contextLimit: number; maxOutputTokens: number; concurrency: number; status: string; activeRequests: number; savedCredential?: { status: string }; health: { state: string; reason?: string; cooldownUntil?: number } };
type Pool = { id?: string; name: string; members: { connectionId: string; weight: number }[]; strategy: string; sticky: boolean; maxAttempts: number; revision?: number; queueTimeoutMs: number };
type Attempt = { routingDecision?: RoutingDecision; modelIdentity?: ModelIdentity; diagnostic?: RuntimeFailure; requestUrl?: string; upstreamResponse?: { requestId?: string | null; requestUrl?: string; responseUrl?: string | null; redirectMode?: string }; id: string; connectionId: string; poolId: string | null; 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 ImportRecord = { id: string; source: string; path: string; enabled: boolean; lastCheckedAt?: string; lastSyncedAt?: string; lastError?: string; lastResult?: { imported?: number; conflicts?: string[] } };
type Center = { revision: number; selected: { type: string; id: string }; waitSettings: WaitSettings; connections: Connection[]; pools: Pool[]; imports: ImportRecord[]; attempts: Attempt[]; waiting: number };
type Center = { revision: number; selected: { type: string; id: string }; waitSettings: WaitSettings; connections: Connection[]; pools: Pool[]; imports: ImportRecord[]; attempts: ModelAttempt[]; waiting: number };
type Operations = { checkedAt: string; version: string; scope: string; activeTasks: number; queue: number; checks: { id: string; title: string; status: string; detail: string }[];
artifacts?: { offset: number; checked: number; total: number; remaining: number; olderOffset: number | null; newerOffset: number | null; results: { id: string; passed: boolean; error?: string }[] } };
type SavedCredential = { id: string; name: string; revision: number; status: string; enabled?: boolean; savedAt?: string; message: string };
@@ -207,7 +202,7 @@ export function ModelCenter({ onConfig, busy, runModel }: { onConfig: (value: Co
<fieldset><legend>模型池成员与权重</legend>{connections.map(connection => { const member = pool.members.find(value => value.connectionId === connection.id); return <label key={connection.id} className="mc-member-choice"><input type="checkbox" checked={!!member} onChange={event => setPool({ ...pool, members: event.target.checked ? [...pool.members, { connectionId: connection.id, weight: 1 }] : pool.members.filter(value => value.connectionId !== connection.id) })} /><span>{connection.name}<small>{connection.model || '尚未选择模型'} · {states[connection.status]}</small></span><input type="number" aria-label={connection.name + '权重'} disabled={!member} min="1" max="10" value={member?.weight ?? 1} onChange={event => setPool({ ...pool, members: pool.members.map(value => value.connectionId === connection.id ? { ...value, weight: Number(event.target.value) } : value) })} /></label>; })}</fieldset>
<div className="mc-actions"><button className="button secondary" type="button" onClick={() => setPoolEditing(false)}>取消</button><button className="button primary" disabled={locked || !pool.members.length}>保存模型池</button></div></form>}
</>}
{tab === 'attempts' && <><div className="mc-section-title"><div><h3>请求账本</h3><p>最近100次物理请求;最多保存1000次。未知用量保持未知。</p></div><span>{view.attempts.length} 条记录</span></div>{!view.attempts.length && <p className="mc-empty">当前没有模型中心请求。选择连接或模型池执行任务后,实际尝试会保存在这里。</p>}<div className="mc-attempts">{view.attempts.map(value => <article key={value.id}><div><span className={'mc-state mc-state-' + value.status}>{states[value.status]}</span><strong>{value.model}</strong><time>{new Date(value.startedAt).toLocaleString()}</time></div><p>{connections.find(connection => connection.id === value.connectionId)?.name || '未派发'} · {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>{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>{value.responseSha256 && <code>工件 SHA256 {value.responseSha256}{value.responseRedacted ? "(已脱敏)" : ""}</code>}{value.sessionId && value.responseArtifactId && <button className="button secondary" disabled={working} onClick={() => void act(async () => { await downloadArtifact(value.sessionId!, value.responseArtifactId!, "model-stream-" + value.id + ".sse"); })}>下载已保存的响应</button>}</div>}{value.requestUrl && <p className="mc-request-url">请求地址:{value.requestUrl}{value.upstreamResponse?.responseUrl && <><br />响应地址:{value.upstreamResponse.responseUrl}</>}</p>}{value.reason && <p className="mc-card-warning">{value.reason}</p>}<ModelRoutingDetails decision={value.routingDecision} /><ModelIdentityDetails identity={value.modelIdentity} requestedModel={value.model} />{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={working} onClick={() => void act(async () => { await 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 + ':' + (capabilityLabels[item.capability] ?? item.capability) + ' · ' + item.reason).join(';')}</p>}</article>)}</div></>}
{tab === 'attempts' && <ModelRequestLedger connections={view.connections} refreshVersion={view} />}
{tab === 'imports' && <><div className="mc-section-title"><div><h3>已有配置导入</h3><p>先预览来源和模型,再导入。原客户端配置保持原样。</p></div><button className="button secondary" disabled={working} onClick={() => void act(async () => { const value = await api<{ sources: typeof discovery }>('/model-center/imports'); if (alive.current) setDiscovery(value.sources); })}>识别本机来源</button></div>
{view.imports.length > 0 && <><h4>已登记来源</h4>{view.imports.map(value => <article className="mc-import-source" key={value.id}><strong>{value.source}</strong><code>{value.path}</code><span>{value.enabled ? '每分钟检查' : '自动同步已关闭'}</span>{value.lastCheckedAt && <p>最近检查 {new Date(value.lastCheckedAt).toLocaleString()}</p>}{value.lastError && <p className="mc-card-warning">{value.lastError}</p>}{!!value.lastResult?.conflicts?.length && <p className="mc-card-warning">有 {value.lastResult.conflicts.length} 项与手动修改冲突,已保留工作台中的修改。</p>}<button className="button secondary" disabled={locked} onClick={() => void act(async () => { await api('/model-center/import-toggle', { id: value.id, enabled: !value.enabled }); })}>{value.enabled ? '关闭自动同步' : '启用自动同步'}</button></article>)}<button className="button secondary" disabled={locked || !view.imports.some(value => value.enabled)} onClick={() => void act(async () => { const result = await api<{ results: { imported?: string[]; conflicts?: string[]; error?: string }[] }>('/model-center/import-sync', {}); const imported = result.results.reduce((sum, value) => sum + (value.imported?.length ?? 0), 0); const conflicts = result.results.reduce((sum, value) => sum + (value.conflicts?.length ?? 0), 0); if (alive.current) setNotice(`已检查启用来源:更新 ${imported} 项,冲突 ${conflicts} 项。`); })}>立即同步已启用来源</button></>}
{discovery.map(value => <article className="mc-import-source" key={value.source}><strong>{value.source}</strong><code>{value.path || '当前版本尚无可发现的配置路径'}</code><span>{value.available ? value.supported ? '可预览' : '当前不支持' : '未发现'}</span>{value.detail && <p>{value.detail}</p>}<button className="button secondary" disabled={!value.available || !value.supported || locked} onClick={() => { setImportSource(value.source); setImportPath(value.path); }}>选择来源</button></article>)}
+13
View File
@@ -0,0 +1,13 @@
.mc-ledger { min-width: 0; }
.mc-ledger-filter { display: grid; grid-template-columns: minmax(160px, 2fr) minmax(130px, 1fr) minmax(110px, 1fr) auto; align-items: end; gap: 12px; margin: 12px 0; }
.mc-ledger-filter label { display: grid; gap: 6px; min-width: 0; font-size: 12px; color: var(--muted); }
.mc-ledger-filter input, .mc-ledger-filter select { width: 100%; min-width: 0; min-height: 40px; border: 1px solid var(--line, #c6d5d1); border-radius: 6px; background: var(--paper, white); color: var(--ink); padding: 8px; font: inherit; }
.mc-ledger-actions, .mc-ledger-pages { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; margin: 12px 0; }
.mc-ledger-actions > span, .mc-ledger-pages > span { color: var(--muted); font-size: 12px; line-height: 1.7; }
.mc-ledger-pages > span { flex: 1; }
.mc-ledger-source { margin: 8px 0; font-size: 12px; line-height: 1.6; overflow-wrap: anywhere; }
.mc-ledger-source > summary { cursor: pointer; }
.mc-ledger-source dl { display: grid; grid-template-columns: 70px minmax(0, 1fr); gap: 6px; }
.mc-ledger-source dd { margin: 0; }
.mc-ledger input:focus-visible, .mc-ledger select:focus-visible, .mc-ledger summary:focus-visible { outline: 2px solid var(--accent, #237a68); outline-offset: 2px; }
@media (max-width: 620px) { .mc-ledger-filter { grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px; } .mc-ledger-filter > label:first-child { grid-column: 1 / -1; } .mc-ledger-filter > button { grid-column: 1 / -1; } .mc-ledger-actions > span { flex-basis: 100%; } }
+80
View File
@@ -0,0 +1,80 @@
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';
export type ModelAttempt = { routingDecision?: RoutingDecision; modelIdentity?: ModelIdentity; diagnostic?: RuntimeFailure; requestUrl?: string;
upstreamResponse?: { requestId?: string | null; responseUrl?: string | null }; 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.reason && <p className="mc-card-warning">{value.reason}</p>}
<ModelRoutingDetails decision={value.routingDecision} /><ModelIdentityDetails identity={value.modelIdentity} requestedModel={value.model ?? '原记录未保存'} />
{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>;
}
+6
View File
@@ -36,6 +36,12 @@ export async function downloadArtifact(sessionId: string, artifactId: string, na
}
downloadBlob(await response.blob(), name);
}
export async function downloadModelLedger(filters: Record<string, string>) {
const params = new URLSearchParams(filters);
const response = await fetch('/api/model-center/attempts/export' + (params.size ? '?' + params.toString() : ''), { headers: { 'X-Workbench-Token': accessToken } });
if (!response.ok) { const value = await response.json().catch(() => ({})); throw new Error(value.error || '请求账本导出失败,请保留原记录并刷新核对。'); }
downloadBlob(await response.blob(), 'orven-model-requests.ndjson');
}
export async function downloadResearchDocument(sessionId: string, jobId: string, kind: 'bundle' | 'raw' = 'bundle') {
const response = await fetch('/api/sessions/' + sessionId + '/research/jobs/' + jobId + '/download?kind=' + kind, { headers: { 'X-Workbench-Token': accessToken } });
if (!response.ok) { const value = await response.json().catch(() => ({})); throw new Error(value.error || '研究证据下载失败。'); }