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 = {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(null),[reconcile,setReconcile]=useState(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('/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

工程环境与依赖

先核对环境,再准备依赖、执行工程检查。诊断只读取声明与实际文件。

{failure&&!confirm&&!reconcile&&

{failure}

} {diagnostic&&
{node&&<>
Node / npm{labels[node.status]??node.status}
实际运行时
Node {node.runtime.node.version} · npm {node.runtime.npm?.version??'未找到'}{node.runtime.node.path}
声明与锁文件
{node.declarations.map(file=>{file.path.split(/[\\/]/).at(-1)} · {file.sha256.slice(0,12)})}{node.lockVersion&&package-lock v{node.lockVersion} · {node.packageCount} 个锁定包}
实际依赖文件
{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&&SHA-256 {node.installed.sha256.slice(0,16)}}
{!!node.missing.length&&<>
缺少依赖
{node.missing.join('、')}
}{!!node.mismatched.length&&<>
版本需核对
{node.mismatched.join('、')}
} {!!node.sources.length&&<>
锁定下载来源
{node.sources.map(source=>{source})}
}
{!!node.issues.length&&
    {node.issues.map(issue=>
  • {issue}
  • )}
} } {python&&<>
Python / {python.framework??'检查器'}{labels[python.status]??python.status}

{python.runtime.version??'版本等待审批后核对'} · pytest {python.pytest.version??'未找到元数据'}

{python.runtime.logicalExecutable??'没有可用解释器'}

{python.message}

} {!node&&!python&&

尚未识别可支持的 Node 或 Python 工程声明。

}
} {node&&

准备所属工作区

{!project.workspace&&

先在上方创建并打开独立开发工作区;依赖准备在该工作区执行。

}
下载与脚本选项

默认跳过脚本。部分原生依赖需要脚本才能使用;允许后,根工程和下载包的安装脚本会以本机账户执行。具体执行范围会在确认页显示。

} {plan&&
npm ci{labels[plan.status]??plan.status}

{plan.packageCount} 个锁定包 · {plan.offline?'离线缓存':'下载自 '+plan.registry} · {plan.scripts==='skip'?'跳过安装脚本':'允许安装脚本'}

{plan.root}
查看固定命令与计划身份
{plan.invocation.executable+'\n'+plan.invocation.args.map(arg=>JSON.stringify(arg)).join('\n')}
SHA-256 {plan.fingerprint}
{plan.status==='planned'&&}
} {jobs.slice().reverse().map(job=>
{labels[job.status]??job.status}{job.id.slice(0,8)} {activeStates.includes(job.status)&&}

{job.summary??'按封存计划准备依赖,原进程与日志正在记录。'}

{job.result&&

退出码 {job.result.exitCode??'未返回'} · {(job.result.durationMs/1000).toFixed(1)} 秒{job.result.truncated?' · 日志超出上限,保留首尾':''}

} {job.logExcerpt&&
原执行日志预览
{job.logExcerpt}
} {job.logArtifactId&&
} {job.after&&
准备后的环境身份SHA-256 {job.after.identity}

依赖准备完成后,还需要实际测试与构建。

} {job.requiresVerification&&!job.reconciliation&&} {job.reconciliation&&

已核对原进程结束并保留现场,原未知结果保持。再次执行需要新计划。

}
)} {confirm&&{if(!working)setConfirm(null);}}>
独立工作区
{confirm.root}
注册源
{confirm.registry}{confirm.offline?'(只使用缓存)':''}
执行时限
{Math.round(confirm.timeoutMs/1000)} 秒,可随时停止
生命周期脚本
{confirm.scripts==='skip'?'全部跳过(--ignore-scripts=true)':'允许执行根工程和依赖包安装脚本'}
{confirm.invocation.executable+'\n'+confirm.invocation.args.map(arg=>JSON.stringify(arg)).join('\n')}
{!!confirm.lifecycle.length&&
根工程的安装脚本{confirm.lifecycle.map(script=>
{script.name}
{script.script}
)}
} {!!confirm.installScriptPackages.length&&

锁文件标记了 {confirm.installScriptPackages.length} 个带安装脚本的包:{confirm.installScriptPackages.join('、')}。脚本正文需下载后才能读取。

}

会更新该工作区的 node_modules。失败或停止后保留现场与日志;原计划只执行一次。安装完成后继续核对工程检查结果。

{failure&&

{failure}

}
} {reconcile&&setReconcile(null)}>

将只读核对原所属进程和当前工程环境。原进程仍存在时保留阻塞状态;确认结束后保留原未知结果,并允许重新创建计划。

}
; }