Files
Agent-Workbench/src/client/EnvironmentPanel.tsx
T

84 lines
12 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { useEffect, useRef, useState } from 'react';
import { Check, FileText, LoaderCircle, PackageCheck, RefreshCw, Square } from 'lucide-react';
import { api, downloadArtifact } from './api';
import { Modal } from './components';
import type { EnvironmentPlan, Project, Session } from './types';
import './EnvironmentPanel.css';
const labels: Record<string,string> = {ready:'依赖已就绪',needs_preparation:'需要准备依赖',unsupported:'暂不支持自动准备',planned:'计划待确认',consumed:'计划已使用',queued:'排队中',running:'正在准备',stopping:'正在停止',prepared:'依赖准备完成',failed:'准备失败',cancelled:'已停止',unknown:'结果待核对',stale:'输入已变化',unverified:'未能完整核验',missing:'未找到',available:'已识别',deferred:'等待检查审批'};
const activeStates=['queued','running','stopping'];
export function EnvironmentPanel({project,session,busy,onSession,onError,openArtifact}:{project:Project;session:Session;busy:boolean;onSession:(value:Session)=>void;onError:(error:unknown)=>void;openArtifact:(id:string)=>void}) {
const [working,setWorking]=useState(''),[registry,setRegistry]=useState('https://registry.npmjs.org/'),[allowScripts,setAllowScripts]=useState(false),[offline,setOffline]=useState(false);
const [failure,setFailure]=useState('');
const [confirm,setConfirm]=useState<EnvironmentPlan|null>(null),[reconcile,setReconcile]=useState<string|null>(null),scope=useRef(0);
const execution=session.execution,diagnostic=execution?.environmentDiagnostics?.at(-1),node=diagnostic?.node,python=diagnostic?.python;
const plans=execution?.environmentPlans??[],plan=plans.at(-1),jobs=execution?.environmentJobs??[],active=jobs.some(job=>activeStates.includes(job.status));
const unresolved=jobs.some(job=>job.requiresVerification&&!job.reconciliation);
useEffect(()=>{scope.current++;setWorking('');setFailure('');setConfirm(null);setReconcile(null);setRegistry('https://registry.npmjs.org/');setAllowScripts(false);setOffline(false);return()=>{scope.current++;};},[session.id,execution?.task?.id]);
async function perform(action:string,input:unknown={},after?:()=>void) {
const current=scope.current;setWorking(action);setFailure('');
try{const value=await api<Session>('/sessions/'+session.id+'/'+action,input);if(current===scope.current){onSession(value);after?.();}}
catch(error){if(current===scope.current){setFailure(error instanceof Error?error.message:String(error));onError(error);}}
finally{if(current===scope.current)setWorking('');}
}
const disabled=busy||active||!!working;
return <section className="task-record-section environment-panel" aria-label="工程环境与依赖">
<div className="record-heading"><PackageCheck size={15}/><h3>工程环境与依赖</h3></div>
<p className="record-footnote">先核对环境,再准备依赖、执行工程检查。诊断只读取声明与实际文件。</p>
{failure&&!confirm&&!reconcile&&<p className="environment-error" role="alert">{failure}</p>}
<button type="button" className="button secondary" disabled={disabled||!execution?.task} onClick={()=>perform('environment-diagnostics')}>
{working==='environment-diagnostics'?<LoaderCircle size={14} className="spin"/>:<RefreshCw size={14}/>}{diagnostic?'重新诊断工程环境':'诊断工程环境'}</button>
{diagnostic&&<div className="environment-diagnostic" role="status">
{node&&<><div className="environment-result-heading"><strong>Node / npm</strong><span className={'environment-state '+node.status}>{labels[node.status]??node.status}</span></div>
<dl className="environment-fields"><dt>实际运行时</dt><dd>Node {node.runtime.node.version} · npm {node.runtime.npm?.version??'未找到'}<code title={node.runtime.node.path}>{node.runtime.node.path}</code></dd>
<dt>声明与锁文件</dt><dd>{node.declarations.map(file=><code key={file.path} title={file.sha256}>{file.path.split(/[\\/]/).at(-1)} · {file.sha256.slice(0,12)}</code>)}{node.lockVersion&&<span>package-lock v{node.lockVersion} · {node.packageCount} 个锁定包</span>}</dd>
<dt>实际依赖文件</dt><dd>{node.installed.status==='verified'?`${node.installed.files} 项 · ${(node.installed.bytes/1024/1024).toFixed(1)} MB` : node.installed.status==='missing'?'没有 node_modules':node.installed.message}
{node.installed.sha256&&<code title={node.installed.sha256}>SHA-256 {node.installed.sha256.slice(0,16)}</code>}</dd>
{!!node.missing.length&&<><dt>缺少依赖</dt><dd>{node.missing.join('、')}</dd></>}{!!node.mismatched.length&&<><dt>版本需核对</dt><dd>{node.mismatched.join('、')}</dd></>}
{!!node.sources.length&&<><dt>锁定下载来源</dt><dd>{node.sources.map(source=><code key={source}>{source}</code>)}</dd></>}
</dl>{!!node.issues.length&&<ul className="environment-issues">{node.issues.map(issue=><li key={issue}>{issue}</li>)}</ul>}
</>}
{python&&<><div className="environment-result-heading"><strong>Python / {python.framework??'检查器'}</strong><span className="environment-state">{labels[python.status]??python.status}</span></div>
<p>{python.runtime.version??'版本等待审批后核对'} · pytest {python.pytest.version??'未找到元数据'}</p><code className="environment-path">{python.runtime.logicalExecutable??'没有可用解释器'}</code><p className="record-footnote">{python.message}</p></>}
{!node&&!python&&<p>尚未识别可支持的 Node 或 Python 工程声明。</p>}
<button type="button" className="text-button" onClick={()=>openArtifact(diagnostic.artifactId)}><FileText size={13}/>查看原诊断</button>
</div>}
{node&&<div className="environment-prepare">
<h4>准备所属工作区</h4>
{!project.workspace&&<p className="record-footnote">先在上方创建并打开独立开发工作区;依赖准备在该工作区执行。</p>}
<details><summary>下载与脚本选项</summary><label>注册源<input aria-label="依赖注册源" value={registry} disabled={disabled} onChange={event=>setRegistry(event.target.value)}/></label>
<label className="environment-choice"><input type="checkbox" checked={offline} disabled={disabled} onChange={event=>setOffline(event.target.checked)}/>只使用本工作区的下载缓存(离线)</label>
<label className="environment-choice"><input type="checkbox" checked={allowScripts} disabled={disabled} onChange={event=>setAllowScripts(event.target.checked)}/>允许依赖生命周期脚本</label>
<p className="record-footnote">默认跳过脚本。部分原生依赖需要脚本才能使用;允许后,根工程和下载包的安装脚本会以本机账户执行。具体执行范围会在确认页显示。</p>
</details>
<button type="button" className="button secondary" disabled={disabled||unresolved||!project.workspace||!node.preparable} onClick={()=>perform('environment-plans',{registry,scripts:allowScripts?'allow':'skip',offline})}>{working==='environment-plans'?<LoaderCircle size={14} className="spin"/>:<PackageCheck size={14}/>}创建依赖准备计划</button>
</div>}
{plan&&<div className="environment-plan"><div className="environment-result-heading"><strong>npm ci</strong><span className="environment-state">{labels[plan.status]??plan.status}</span></div>
<p>{plan.packageCount} 个锁定包 · {plan.offline?'离线缓存':'下载自 '+plan.registry} · {plan.scripts==='skip'?'跳过安装脚本':'允许安装脚本'}</p><code className="environment-path">{plan.root}</code>
<details><summary>查看固定命令与计划身份</summary><pre>{plan.invocation.executable+'\n'+plan.invocation.args.map(arg=>JSON.stringify(arg)).join('\n')}</pre><code className="environment-path">SHA-256 {plan.fingerprint}</code></details>
{plan.status==='planned'&&<button type="button" className="button primary" disabled={disabled||unresolved} onClick={()=>setConfirm(plan)}>核对并批准依赖准备</button>}
</div>}
{jobs.slice().reverse().map(job=><div className="environment-job" key={job.id}>
<div className="environment-result-heading"><strong>{labels[job.status]??job.status}</strong><code title={job.id}>{job.id.slice(0,8)}</code>
{activeStates.includes(job.status)&&<button type="button" className="text-button" disabled={!!working} onClick={()=>perform('environment-jobs/'+job.id+'/stop')}><Square size={12}/>停止依赖准备</button>}</div>
<p>{job.summary??'按封存计划准备依赖,原进程与日志正在记录。'}</p>{job.result&&<p className="record-footnote">退出码 {job.result.exitCode??'未返回'} · {(job.result.durationMs/1000).toFixed(1)} 秒{job.result.truncated?' · 日志超出上限,保留首尾':''}</p>}
{job.logExcerpt&&<details open={activeStates.includes(job.status)}><summary>原执行日志预览</summary><pre>{job.logExcerpt}</pre></details>}
{job.logArtifactId&&<div className="environment-actions"><button type="button" className="text-button" onClick={()=>openArtifact(job.logArtifactId!)}><FileText size={13}/>查看依赖日志</button><button type="button" className="text-button" onClick={()=>{void downloadArtifact(session.id,job.logArtifactId!,'dependency-'+job.id+'.log').catch(onError);}}>下载原日志</button></div>}
{job.after&&<details><summary>准备后的环境身份</summary><code className="environment-path">SHA-256 {job.after.identity}</code><p className="record-footnote">依赖准备完成后,还需要实际测试与构建。</p></details>}
{job.requiresVerification&&!job.reconciliation&&<button type="button" className="button secondary" disabled={disabled} onClick={()=>setReconcile(job.id)}>核对中断现场</button>}
{job.reconciliation&&<p className="record-footnote">已核对原进程结束并保留现场,原未知结果保持。再次执行需要新计划。</p>}
</div>)}
{confirm&&<Modal title="确认依赖准备" description="核对目标、实际命令、下载来源和脚本范围后执行。" onClose={()=>{if(!working)setConfirm(null);}}>
<div className="environment-confirm"><dl className="environment-fields"><dt>独立工作区</dt><dd><code>{confirm.root}</code></dd><dt>注册源</dt><dd>{confirm.registry}{confirm.offline?'(只使用缓存)':''}</dd>
<dt>执行时限</dt><dd>{Math.round(confirm.timeoutMs/1000)} 秒,可随时停止</dd><dt>生命周期脚本</dt><dd><strong>{confirm.scripts==='skip'?'全部跳过(--ignore-scripts=true)':'允许执行根工程和依赖包安装脚本'}</strong></dd></dl>
<pre>{confirm.invocation.executable+'\n'+confirm.invocation.args.map(arg=>JSON.stringify(arg)).join('\n')}</pre>
{!!confirm.lifecycle.length&&<details open><summary>根工程的安装脚本</summary>{confirm.lifecycle.map(script=><div key={script.name}><strong>{script.name}</strong><pre>{script.script}</pre></div>)}</details>}
{!!confirm.installScriptPackages.length&&<p>锁文件标记了 {confirm.installScriptPackages.length} 个带安装脚本的包:{confirm.installScriptPackages.join('、')}。脚本正文需下载后才能读取。</p>}
<p className="record-footnote">会更新该工作区的 node_modules。失败或停止后保留现场与日志;原计划只执行一次。安装完成后继续核对工程检查结果。</p>
{failure&&<p className="environment-error" role="alert">{failure}</p>}
</div><div className="modal-actions"><button type="button" className="button secondary" disabled={!!working} onClick={()=>setConfirm(null)}>取消</button><button type="button" className="button primary" disabled={disabled} onClick={()=>perform('environment-jobs',{planId:confirm.id,fingerprint:confirm.fingerprint,approved:true},()=>setConfirm(null))}><Check size={14}/>确认执行依赖准备</button></div>
</Modal>}
{reconcile&&<Modal title="核对中断的依赖准备" onClose={()=>setReconcile(null)}><p>将只读核对原所属进程和当前工程环境。原进程仍存在时保留阻塞状态;确认结束后保留原未知结果,并允许重新创建计划。</p><div className="modal-actions"><button type="button" className="button secondary" onClick={()=>setReconcile(null)}>取消</button><button type="button" className="button primary" disabled={!!working} onClick={()=>perform('environment-jobs/'+reconcile+'/reconcile',{fingerprint:jobs.find(job=>job.id===reconcile)?.planFingerprint},()=>setReconcile(null))}>确认只读核对</button></div></Modal>}
</section>;
}