84 lines
12 KiB
TypeScript
84 lines
12 KiB
TypeScript
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>;
|
||
}
|