feat: preserve bounded model requests and complete task history

This commit is contained in:
Agent Workbench Dev
2026-10-29 21:09:50 +08:00
parent 19b738b468
commit 8f32dec6cc
58 changed files with 1269 additions and 108 deletions
+2 -2
View File
@@ -13,7 +13,7 @@ const defaultConfig: Config = { mode: 'demo', baseUrl: 'http://127.0.0.1:11434/v
export default function App() {
const [token, setAccess] = useState('');
const [version, setVersion] = useState('1.4.0');
const [version, setVersion] = useState('1.5.0');
const [diagnosticsOpen, setDiagnosticsOpen] = useState(false);
const [diagnostics, setDiagnostics] = useState<RuntimeDiagnostics | null>(null);
const [diagnosticsBusy, setDiagnosticsBusy] = useState(false);
@@ -414,7 +414,7 @@ export default function App() {
useEffect(() => {
const handler = (event: KeyboardEvent) => {
if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 'k') { event.preventDefault(); setSidebarOpen(true); setWide(false); requestAnimationFrame(() => filterRef.current?.focus()); }
if (event.key === 'Escape') { if (window.innerWidth <= 940) setWide(false); if (window.innerWidth <= 620) setSidebarOpen(false); }
if (event.key === 'Escape' && !event.defaultPrevented && !document.querySelector('[role="dialog"][aria-modal="true"]')) { if (window.innerWidth <= 940) setWide(false); if (window.innerWidth <= 620) setSidebarOpen(false); }
};
window.addEventListener('keydown', handler); return () => window.removeEventListener('keydown', handler);
}, []);
+83
View File
@@ -0,0 +1,83 @@
import { useEffect, useState } from 'react';
import { Archive, BrainCircuit, FileText, LoaderCircle } from 'lucide-react';
import { api } from './api';
import { Modal } from './components';
import type { ContextHistory, ContextHistoryGroup, ContextPlan, Session } from './types';
const number = (value: number | undefined) => (value ?? 0).toLocaleString('zh-CN');
const states: Record<string, string> = { prepared: '已准备', requesting: '正在请求', completed: '已收到响应', failed: '请求失败', interrupted: '请求已中断' };
const toolNames: Record<string, string> = { read_file: '读取文件', read_artifact: '读取保存工件', inspect_project: '识别工程', inspect_session: '核对运行记录',
index_project: '建立符号索引', query_code: '定位代码', propose_patch: '精确补丁提案', propose_file: '文件提案', run_command: '终端命令', run_checks: '工程检查',
plan_checks: '检查计划', prepare_change_set: '封存变更集', plan_delivery: 'Git交付预览', delivery_report: '交付报告', list_files: '查看文件', search_files: '搜索文件' };
export function RequestContextPanel({ session, runId, openArtifact, onError }: {
session: Session; runId: string; openArtifact: (id: string) => void; onError: (error: unknown) => void;
}) {
const [historical, setHistorical] = useState<ContextPlan[]>([]);
const [selected, setSelected] = useState('');
const [historyId, setHistoryId] = useState('');
useEffect(() => {
let alive = true; setHistorical([]); setSelected(''); setHistoryId('');
if (runId && runId !== session.execution?.run?.id) {
api<ContextPlan[]>('/sessions/' + session.id + '/context-plans?run=' + runId).then(value => { if (alive) setHistorical(value); })
.catch(error => { if (alive) onError(error); });
}
return () => { alive = false; };
}, [session.id, runId, session.execution?.run?.id]);
const plans = runId === session.execution?.run?.id ? session.execution?.contextPlans?.filter(plan => plan.runId === runId) ?? []
: historical.filter(plan => plan.runId === runId && plan.sessionId === session.id);
const plan = plans.find(plan => plan.id === selected) ?? plans.at(-1);
if (!plan) return null;
const total = plan.estimatedInputTokens + plan.budget.outputReservation + plan.budget.safetyTokens;
return <section className="task-record-section request-context" aria-label="请求上下文">
<div className="record-heading"><BrainCircuit size={15} /><h3>请求上下文</h3><span>{states[plan.status] ?? plan.status}</span></div>
{plans.length > 1 && <label className="run-picker">查看一次模型请求<select aria-label="选择模型请求" value={plan.id} onChange={event => setSelected(event.target.value)}>
{plans.map((value, index) => <option key={value.id} value={value.id}>第 {value.requestIndex ?? index + 1} 次 · {states[value.status] ?? value.status}</option>)}
</select></label>}
<div className="context-meter" aria-label="估算上下文占用"><i style={{ width: Math.min(100, total / plan.budget.contextLimit * 100) + '%' }} /></div>
<dl className="record-fields"><dt>请求输入估算</dt><dd>{number(plan.estimatedInputTokens)} tokens</dd><dt>输出 / 安全余量</dt><dd>{number(plan.budget.outputReservation)} / {number(plan.budget.safetyTokens)} tokens</dd>
<dt>模型上下文窗口</dt><dd>{number(plan.budget.contextLimit)} tokens</dd><dt>已报告输入</dt><dd>{plan.actualUsage?.prompt_tokens === undefined ? '服务未返回' : number(plan.actualUsage.prompt_tokens) + ' tokens'}</dd>
<dt>历史记录</dt><dd>保留 {plan.retainedMessages} 条 · 保存 {plan.archivedGroups} 组原记录</dd><dt>发送内容</dt><dd>{number(plan.requestBytes)} B<code className="context-sha" title={plan.requestSha256}>{plan.requestSha256.slice(0, 16)}</code></dd>
</dl>
<p className="record-footnote">估算包含系统提示、工具定义和历史。任务要求完整保留;省略的原记录可从本机工件检索。实际用量以模型服务为准。</p>
{plan.error && <p className="run-stop">{plan.error}</p>}
<div className="context-actions"><button type="button" className="text-button" onClick={() => openArtifact(plan.requestArtifactId)}><FileText size={13} />查看发送内容</button>
<button type="button" className="text-button" onClick={() => openArtifact(plan.artifactId)}><FileText size={13} />查看请求计划</button>
{!!plan.archivedGroups && <button type="button" className="text-button" onClick={() => setHistoryId(plan.id)}><Archive size={13} />检索完整历史</button>}</div>
{historyId && <HistoryModal key={session.id + ':' + historyId} sessionId={session.id} planId={historyId} onError={onError}
onClose={() => setHistoryId('')} openArtifact={id => { setHistoryId(''); openArtifact(id); }} />}
</section>;
}
function groupTitle(group: ContextHistoryGroup) {
if (group.tools?.length) return group.tools.map(tool => toolNames[tool.name] ?? tool.name).join(' · ');
return group.roles[0] === 'user' ? '用户要求' : '助手记录';
}
function HistoryModal({ sessionId, planId, onClose, openArtifact, onError }: {
sessionId: string; planId: string; onClose: () => void; openArtifact: (id: string) => void; onError: (error: unknown) => void;
}) {
const [history, setHistory] = useState<ContextHistory | null>(null), [offset, setOffset] = useState(0), [loading, setLoading] = useState(false);
useEffect(() => {
let alive = true; setLoading(true);
api<ContextHistory>('/sessions/' + sessionId + '/context-plans/' + planId + '/history?offset=' + offset + '&limit=12')
.then(value => { if (alive) setHistory(value); }).catch(error => { if (alive) onError(error); }).finally(() => { if (alive) setLoading(false); });
return () => { alive = false; };
}, [sessionId, planId, offset]);
return <Modal title="完整历史记录" description="这些记录已从本次请求中省略,原始参数和实际结果仍保存在本机。读取记录不会执行工具。" wide onClose={onClose}>
<div className="context-history-list" aria-busy={loading}>{loading ? <p className="record-empty"><LoaderCircle size={15} className="spin" />正在核对历史工件</p>
: history?.groups.map(group => <article className="context-history-group" key={group.index}>
<div><strong>{groupTitle(group)}</strong><small>原消息 {group.startMessage + 1}–{group.endMessage + 1}</small></div>
<code className="context-sha" title={group.sha256}>SHA256 {group.sha256.slice(0, 20)}</code>
{!!group.archive.chunks && <p>原记录较大,已保存 {group.archive.chunks} 份可核验分片。</p>}
{group.tools?.map(tool => <div className="context-history-tool" key={tool.call_id}><span>{toolNames[tool.name] ?? tool.name}</span><code>{tool.call_id}</code>
{(tool.requires_verification || tool.result.requires_verification || tool.result.status === 'unknown') && <span className="context-unknown">结果需核对</span>}
{tool.result.path && <small>{tool.result.path}</small>}{tool.result_artifact_id && <button type="button" className="text-button" onClick={() => openArtifact(tool.result_artifact_id!)}>读取工具结果</button>}
</div>)}
<button type="button" className="text-button" onClick={() => openArtifact(group.archive.artifact_id)}><FileText size={13} />读取原记录</button>
</article>)}</div>
<div className="artifact-pagination"><span>记录 {history ? Math.min(history.totalGroups, history.offset + 1) + '–' + Math.min(history.totalGroups, history.offset + history.groups.length) + ' / ' + history.totalGroups : '正在读取'}</span>
<button type="button" className="button secondary" disabled={loading || offset === 0} onClick={() => setOffset(Math.max(0, offset - 12))}>上一页</button>
<button type="button" className="button secondary" disabled={loading || !history?.truncated} onClick={() => setOffset(offset + 12)}>下一页</button></div>
</Modal>;
}
+15
View File
@@ -57,5 +57,20 @@
.status-passed { color: #277958; background: #edf7ef; }
.status-queued, .status-validating, .status-not_configured, .status-cancelled { color: #626c7c; background: #eef0f4; }
.tool-unknown .tool-symbol { color: #805d22; background: #faf4e8; }
.context-meter { height: 5px; margin: 15px 0; border-radius: 9px; overflow: hidden; background: #e8eeeb; }
.context-meter i { display: block; height: 100%; background: #56877b; border-radius: inherit; }
.context-sha { display: block; font-size: 10px; color: var(--muted); margin-top: 4px; overflow-wrap: anywhere; }
.context-actions { display: flex; flex-wrap: wrap; gap: 4px 12px; }
.context-actions .text-button { padding-left: 0; }
.context-history-list { flex: 1; min-height: 0; overflow: auto; padding: 1px; }
.context-history-group { padding: 13px; margin-bottom: 10px; border: 1px solid var(--line); border-radius: 6px; font-size: 11px; line-height: 1.8; }
.context-history-group > div:first-child { display: flex; flex-wrap: wrap; justify-content: space-between; gap: 4px 14px; }
.context-history-group strong { font-weight: 600; overflow-wrap: anywhere; }
.context-history-group small { color: var(--muted); font-size: 10px; }
.context-history-group > .text-button { padding-left: 0; margin-top: 6px; }
.context-history-tool { display: flex; flex-wrap: wrap; align-items: center; gap: 3px 10px; padding: 6px 0; }
.context-history-tool code { font-size: 10px; color: var(--muted); overflow-wrap: anywhere; }
.context-history-tool small { flex-basis: 100%; overflow-wrap: anywhere; }
.context-unknown { padding: 1px 6px; border-radius: 4px; color: #805d22; background: #faf4e8; font-size: 10px; }
@media (max-width: 1120px) { .inspector-tabs > button:not(.icon-button) { padding-left: 7px; padding-right: 7px; gap: 4px; } .task-record { padding-left: 13px; padding-right: 13px; } }
@media (max-width: 620px) { .toolbar-actions { gap: 1px; } .toolbar-actions .icon-button { width: 24px; } .task-record { padding: 4px 16px 20px; } .record-fields { grid-template-columns: 83px minmax(0, 1fr); } .artifact-pagination .button { height: 32px; } }
+7 -3
View File
@@ -4,9 +4,10 @@ import type { ArtifactPreview, CheckPlan, Run, Session } from './types';
import { api } from './api';
import { Modal, Status } from './components';
import { DeliveryPanel } from './DeliveryPanel';
import { RequestContextPanel } from './RequestContextPanel';
import './TaskPanel.css';
const stopReasons: Record<string, string> = { time_limit: '到达运行时间预算', token_limit: '到达本次 token 预算', task_token_limit: '到达任务累计预算', step_limit: '到达工具轮次上限', cancelled: '用户停止', model_error: '模型请求失败', interrupted: '进程中断' };
const stopReasons: Record<string, string> = { context_limit: '完整任务要求超过请求上下文预算', time_limit: '到达运行时间预算', token_limit: '到达本次 token 预算', task_token_limit: '到达任务累计预算', step_limit: '到达工具轮次上限', cancelled: '用户停止', model_error: '模型请求失败', interrupted: '进程中断' };
const number = (value: number | undefined) => (value ?? 0).toLocaleString('zh-CN');
const time = (value: string | null | undefined) => value ? new Date(value).toLocaleString('zh-CN', { month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit', second: '2-digit' }) : '执行中';
@@ -27,7 +28,9 @@ export function TaskPanel({ session, onSession, onError, busy }: { session: Sess
const jobs = execution?.checks ?? [];
const checkRunning = jobs.some(job => ['queued', 'running'].includes(job.status));
useEffect(() => { setRunId(''); setHistoricalRun(null); setPreview(null); setConfirmPlan(null); artifactRequest.current++; }, [session.id, task?.id]);
useEffect(() => { setRunId(''); setHistoricalRun(null); setPreview(null); setPreviewBusy(false); setConfirmPlan(null); artifactRequest.current++;
return () => { artifactRequest.current++; };
}, [session.id, task?.id]);
useEffect(() => {
if (!id || id === execution?.run?.id) return;
let alive = true; setHistoricalRun(null);
@@ -73,6 +76,7 @@ export function TaskPanel({ session, onSession, onError, busy }: { session: Sess
<p className="record-footnote">用量以服务返回为准;未报告的请求单独估算。</p>
</> : <p className="record-empty"><LoaderCircle size={14} className="spin" />正在读取运行记录</p>}
</section>}
{run && <RequestContextPanel session={session} runId={run.id} onError={onError} openArtifact={openArtifact} />}
<section className="task-record-section project-checks">
<div className="record-heading"><GitBranch size={15} /><h3>工程检查</h3><Status value={task?.verification.status || 'not_configured'} /></div>
<p className="record-footnote">检查对应当时的工程快照。先识别项目脚本,再执行检查;项目变化后重新检查。</p>
@@ -83,7 +87,7 @@ export function TaskPanel({ session, onSession, onError, busy }: { session: Sess
{jobs.slice().reverse().map(job => <div key={job.id} className="check-job"><div className="record-heading"><Status value={job.stale ? 'stale' : job.status} /><code title={job.id}>{job.id.slice(0, 8)}</code>{['queued', 'running'].includes(job.status) && <button type="button" className="text-button" onClick={() => api<Session>('/sessions/' + session.id + '/check-jobs/' + job.id + '/stop', {}).then(onSession).catch(onError)}>停止检查</button>}</div><time>{time(job.startedAt)}</time>{job.currentCheck && <p className="check-current"><LoaderCircle size={12} className="spin" />正在执行 <code>{job.currentCheck.command}</code></p>}{job.summary && <p>{job.summary}</p>}{job.results.map(result => <div key={result.id} className="check-result"><div><strong>{result.name}</strong><Status value={result.status} /></div><p>退出码 {result.exitCode === null ? '未返回' : result.exitCode} · {(result.durationMs / 1000).toFixed(1)} 秒{result.tests && ` · 测试 ${result.tests.passed}/${result.tests.total} 通过`}</p>{result.reason && <p>{result.reason}</p>}{result.logArtifactId && <button type="button" className="text-button" disabled={previewBusy} onClick={() => openArtifact(result.logArtifactId!)}><FileText size={13} />查看检查日志</button>}</div>)}</div>)}
</section>
{task && <DeliveryPanel session={session} busy={busy} onSession={onSession} onError={onError} openArtifact={openArtifact} />}
{!!execution?.artifacts.length && <section className="task-record-section"><div className="record-heading"><FileText size={15} /><h3>结果工件</h3><span>最近 {execution.artifacts.length} 项</span></div><div className="artifact-list">{execution.artifacts.slice().reverse().map(artifact => <button type="button" key={artifact.id} disabled={previewBusy} onClick={() => openArtifact(artifact.id)}><span>{artifact.kind === 'check-log' ? '检查日志' : artifact.kind === 'project-inspection' ? '工程识别' : artifact.kind === 'delivery-report' ? '交付报告 · JSON' : artifact.kind === 'delivery-report-markdown' ? '交付报告 · Markdown' : artifact.kind === 'delivery-diff' ? '提交差异' : '工具结果'}<code>{artifact.sha256.slice(0, 10)}</code></span><small>{number(artifact.bytes)} B</small></button>)}</div></section>}
{!!execution?.artifacts.length && <section className="task-record-section"><div className="record-heading"><FileText size={15} /><h3>结果工件</h3><span>最近 {execution.artifacts.length} 项</span></div><div className="artifact-list">{execution.artifacts.slice().reverse().map(artifact => <button type="button" key={artifact.id} disabled={previewBusy} onClick={() => openArtifact(artifact.id)}><span>{artifact.kind === 'check-log' ? '检查日志' : artifact.kind === 'project-inspection' ? '工程识别' : artifact.kind === 'delivery-report' ? '交付报告 · JSON' : artifact.kind === 'delivery-report-markdown' ? '交付报告 · Markdown' : artifact.kind === 'delivery-diff' ? '提交差异' : artifact.kind === 'model-request' ? '模型请求正文' : artifact.kind === 'context-plan' ? '请求计划' : artifact.kind === 'context-history-index' ? '完整历史索引' : artifact.kind.startsWith('context-group') ? '完整历史记录' : '工具结果'}<code>{artifact.sha256.slice(0, 10)}</code></span><small>{number(artifact.bytes)} B</small></button>)}</div></section>}
{confirmPlan && <Modal title="执行工程检查" description="以下项目脚本在当前工程目录执行;检查记录保存退出码和日志。" onClose={() => setConfirmPlan(null)}><div className="check-confirm">{confirmPlan.checks.map(check => <div key={check.id}><strong>{check.command}</strong><pre>{check.script}{check.lifecycle?.length ? '\n\n' + check.lifecycle.map(item => item.name + ': ' + item.script).join('\n') : ''}</pre></div>)}<p>{confirmPlan.project.name} · {confirmPlan.project.packageManager}</p></div><div className="modal-actions"><button type="button" className="button secondary" disabled={starting} onClick={() => setConfirmPlan(null)}>取消</button><button type="button" className="button primary" disabled={starting} onClick={runChecks}><Check size={14} />确认执行检查</button></div></Modal>}
{preview && <Modal title="执行结果工件" description={`SHA256 ${preview.sha256}`} wide onClose={() => { artifactRequest.current++; setPreview(null); setPreviewBusy(false); }}><pre className="artifact-preview">{preview.content}</pre><div className="artifact-pagination"><span>字符 {number(preview.offset)}–{number(preview.offset + preview.content.length)} / {number(preview.totalCharacters)}</span><button type="button" className="button secondary" disabled={previewBusy || preview.offset === 0} onClick={() => openArtifact(preview.id, Math.max(0, preview.offset - 16000))}>上一段</button><button type="button" className="button secondary" disabled={previewBusy || !preview.truncated} onClick={() => openArtifact(preview.id, preview.offset + preview.content.length)}>下一段</button></div></Modal>}
</div>;
+1 -1
View File
@@ -29,7 +29,7 @@ export function Modal({ title, description, children, onClose, wide = false }: {
const previous = document.activeElement as HTMLElement | null;
panel.current?.querySelector<HTMLElement>('input, select, textarea, button')?.focus();
const handle = (event: KeyboardEvent) => {
if (event.key === 'Escape') { event.preventDefault(); close.current(); }
if (event.key === 'Escape') { event.preventDefault(); event.stopPropagation(); close.current(); }
if (event.key === 'Tab') {
const elements = Array.from(panel.current?.querySelectorAll<HTMLElement>('button, input, select, textarea, a[href]') || [])
.filter(element => !element.hasAttribute('disabled') && element.offsetParent !== null);
+16 -2
View File
@@ -70,7 +70,21 @@ export interface ModelSnapshot { mode: string; model: string; baseUrl: string; v
export interface Usage { requests: number; inputTokens: number; outputTokens: number; totalTokens: number; unknownRequests: number; estimatedUnknownTokens: number }
export interface RunBudget { maxSteps: number; maxDurationMs: number; maxTokens: number; maxTaskTokens: number }
export interface RunBrief { id: string; taskId: string; status: string; startedAt: string; finishedAt: string | null; steps: number; toolCalls: number; usage: Usage; stopReason: string | null; model: ModelSnapshot; budget: RunBudget; resumeOf: string | null }
export interface Run extends RunBrief { engine: string; checkpoint: { completedToolIds: string[]; pendingToolIds: string[]; requiresVerification: string[] } }
export interface Run extends RunBrief { engine: string; currentContextPlanId?: string; checkpoint: { completedToolIds: string[]; pendingToolIds: string[]; requiresVerification: string[] } }
export interface ContextPlan {
id: string; sessionId: string; projectId: string; taskId: string; runId: string; stepId: string; requestIndex?: number; status: string;
createdAt: string; finishedAt: string | null; requestSha256: string; requestBytes: number; requestArtifactId: string; artifactId: string;
estimatedInputTokens: number; beforeInputTokens: number; beforeBytes: number; estimateMethod: string;
originalMessages: number; retainedMessages: number; archivedGroups: number; historyIndexArtifactId: string | null; historyIndexSha256: string | null;
actualUsage: { prompt_tokens?: number; completion_tokens?: number; total_tokens?: number } | null; requestAttempts: number; error?: string;
budget: { contextLimit: number; outputReservation: number; safetyTokens: number; inputBudget: number; targetInputTokens: number; runRemainingTokens: number | null; taskRemainingTokens: number | null };
}
export interface ContextHistoryGroup {
index: number; startMessage: number; endMessage: number; sha256: string; roles: string[];
tools?: { call_id: string; name: string; result: { status?: string; path?: string; requires_verification?: boolean }; recorded_state?: string; requires_verification?: boolean; result_artifact_id?: string }[];
archive: { artifact_id: string; sha256: string; bytes: number; chunks?: number };
}
export interface ContextHistory { planId: string; groups: ContextHistoryGroup[]; offset: number; totalGroups: number; truncated: boolean }
export interface Task { id: string; goal: string; status: string; instructions: { id: string; content: string; createdAt: string; source?: string }[]; usage: Usage; budget: { maxTokens: number }; verification: { status: string; checkJobId: string | null }; origin: string }
export interface Artifact { id: string; taskId: string | null; runId: string | null; kind: string; mediaType: string; sha256: string; bytes: number; createdAt: string; status: string }
export interface ArtifactPreview extends Artifact { content: string; offset: number; totalCharacters: number; truncated: boolean }
@@ -98,4 +112,4 @@ export interface ChangeSet {
snapshotArtifactId: string; sourceRunId: string; restoreError?: string }[];
observations?: { path: string; state: string; exists: boolean | null; actualSha256: string | null; problem?: string }[];
}
export interface ExecutionSnapshot { schemaVersion: number; task: Task | null; run: Run | null; runs: RunBrief[]; progress: { totalTools: number; completedTools: number; requiresVerification: { id: string; tool: string; state: string; callId: string }[] }; artifacts: Artifact[]; checks: CheckJob[]; plans?: CheckPlan[]; deliveries?: DeliveryJob[]; deliveryPlans?: DeliveryPlan[]; changeSets?: ChangeSet[]; accountedTaskTokens: number }
export interface ExecutionSnapshot { schemaVersion: number; task: Task | null; run: Run | null; runs: RunBrief[]; progress: { totalTools: number; completedTools: number; requiresVerification: { id: string; tool: string; state: string; callId: string }[] }; artifacts: Artifact[]; checks: CheckJob[]; plans?: CheckPlan[]; deliveries?: DeliveryJob[]; deliveryPlans?: DeliveryPlan[]; changeSets?: ChangeSet[]; contextPlans?: ContextPlan[]; accountedTaskTokens: number }