@yanglaofish/fishtools 0.5.3 → 0.6.0

package/node_modules/@mytools/fst-cli/src/terminal/session.js

@@ -1,13 +1,15 @@
 import { randomUUID } from 'node:crypto';
+import {FlowError} from '@mytools/sdk';
 import { isDeepStrictEqual } from 'node:util';
 import path from 'node:path';
 import { parseCommand, fileReference, readRunInput, newWorkflow, setBinding, stepMetadata, outputSources, stepAt, sequenceAt, pruneRuntimeInputs } from './model.js';
 import { editCondition } from './conditions.js';
 import { runStatuses } from './run-viewer.js';
-import { editValue, needsJsonEditor } from './schema.js';
+import { editValue, needsJsonEditor, commandInput, inputEntries } from './schema.js';
+import {hasInputRules} from '@mytools/sdk/inputs';
 import {gettingStarted,pluginStatus,pluginDetails} from './presentation.js';
 import {readableValue,readableError,runCategory,runCategoryNames} from './run-presentation.js';
-import {commandMenu} from './navigation.js';
+import {commandMenu,commandCompletions} from './navigation.js';
 import {workflowMenu} from './workflow-menu.js';
 import {commandPresetsMenu,shortcutsMenu,runShortcut} from './command-menu.js';
 import {validate} from '@mytools/sdk/schema';
@@ -30,6 +32,7 @@ export class TerminalSession{
   loadWorkflow(flow){this.flow=structuredClone(flow);this.savedFlow=structuredClone(flow);this.dirty=false;}
   updateWorkflow(flow){this.flow=flow;this.dirty=!isDeepStrictEqual(flow,this.savedFlow);}
   commands(){return commandMenu(this.app.listPlugins?.()??[],this.app.listCommands(),this.app.listShortcuts?.()??[]);}
+  completions(){return commandCompletions(this.app.listPlugins?.()??[],this.app.listCommands(),this.app.listShortcuts?.()??[]);}
   async discard(){return !this.dirty||await this.ui.confirm('当前修改未保存，是否放弃修改？');}
   async mayExit(){
     if(!await this.discard())return false;
@@ -42,13 +45,15 @@ export class TerminalSession{
   }
   async run(){
     await this.startHistory();
-    this.ui.show(gettingStarted(await this.app.listWorkflows(),this.app.project),{kind:'welcome'});
+    const workflows=await this.app.listWorkflows();
+    this.ui.show(gettingStarted(workflows.filter(flow=>flow.status!=='invalid'),this.app.project),{kind:'welcome'});
+    for(const flow of workflows.filter(flow=>flow.status==='invalid'))this.ui.show(`工作流不可用：${flow.diagnostic.message}`);
     for(const warning of this.app.host?.warnings??[])this.ui.show(`声明提示：${warning.message}`);
     try{
       while(!this.exiting){
         this.ui.summary(`欢迎使用 Fishtools · 插件编排工作台\n当前工作区：${this.app.projectDir}\n${this.app.listPlugins().length} 个插件 · ${(await this.app.listWorkflows()).length} 个工作流${this.flow?` · ${this.flow.title??this.flow.id} · ${this.dirty?'未保存':'已保存'}`:''}`);
         let text;
-        try{text=await this.ui.input('fst > / 操作 · ! 系统命令 · Shift+Enter 换行 · Enter 提交',{commands:this.commands(),workflows:await this.app.listWorkflows(),multiline:true});}
+        try{text=await this.ui.input('fst > / 操作 · ! 系统命令 · Shift+Enter 换行 · Enter 提交',{commands:this.completions(),workflows:await this.app.listWorkflows(),multiline:true});}
         catch(e){if(e.code!=='PROMPT_CANCELLED')throw e;try{if(await this.mayExit())break;}catch{}continue;}
         if(!text.trim())continue;
         try{await this.execute(text);}catch(e){if(e.code!=='PROMPT_CANCELLED'||!this.ui.endCommand)this.ui.show(e.code==='PROMPT_CANCELLED'?'已返回主面板。':`${e.code==='COMMAND_INPUT'?'输入提示':'操作失败'}：${e.message}`);}
@@ -100,7 +105,7 @@ export class TerminalSession{
     const [command,...args]=parseCommand(text);
     const shortcut=this.app.listShortcuts?.().find(entry=>entry.name===command);
     if(shortcut)return runShortcut(this,shortcut,args);
-    const entry=this.commands().find(c=>c.name===command&&c.plugin);
+    const entry=this.completions().find(c=>c.name===command&&c.plugin);
     if(entry){if(args.length)throw new Error(`/${command} 请从二级菜单选择能力`);return this.pluginSkills(entry.plugin);}
     const pluginCommand=this.app.listCommands().find(c=>c.name===command);
     if(pluginCommand)return this.pluginCommand(pluginCommand,args);
@@ -166,17 +171,31 @@ export class TerminalSession{
       default:throw new Error(`未知操作 /${command}，输入 /help 查看可用操作`);
     }
   }
-  async pluginCommand(command,args){
+  async pluginCommand(command,args,{fromMenu=false}={}){
     if(args.length>1)throw new Error(`用法：/${command.name} [@参数.json]`);
     let input;
     if(args.length)input=await readRunInput(args[0],this.baseDir);
     else{
       const initial=structuredClone(command.shortcutInput??{});
+      const target=command.actionId??`/${command.targetName??command.name}`;
+      const preview=this.app.previewInput?value=>this.app.previewInput(target,value):undefined;
       const empty=command.input?.type==='object'&&command.input.properties&&Object.keys(command.input.properties).length===0;
-      if(command.shortcutInput!==undefined||empty){
-        try{input=validate(command.input,initial,command.description??command.name);}
-        catch{input=await editValue(this.ui,command.input,initial,{baseDir:this.baseDir,required:true,label:command.description});}
-      }else input=command.input?await editValue(this.ui,command.input,initial,{baseDir:this.baseDir,required:true,label:command.description}):initial;
+      if(command.shortcutInput!==undefined||empty||!command.input){
+        try{
+          if(hasInputRules(command.input)&&preview){validate(command.input,preview(initial).value,command.description??command.name,{useDefaults:false});input=initial;}
+          else input=validate(command.input,initial,command.description??command.name);
+        }
+        catch{
+          if(hasInputRules(command.input)){
+            const result=await commandInput(this.ui,command.input,initial,{baseDir:this.baseDir,label:command.description,preview});
+            if(result.cancelled)return;input=result.value;
+          }else input=await editValue(this.ui,command.input,initial,{baseDir:this.baseDir,required:true,label:command.description});
+        }
+      }else{
+        const result=await commandInput(this.ui,command.input,initial,{baseDir:this.baseDir,label:command.description??command.name,preview});
+        if(result.cancelled)return;
+        input=result.value;
+      }
     }
     const ui=Object.fromEntries(['input','select','show','confirm'].map(name=>[name,this.ui[name].bind(this.ui)]));
     const definition=this.app.host.definitions.get(command.plugin);
@@ -188,6 +207,7 @@ export class TerminalSession{
     const targetName=command.targetName??command.name;
     if(!command.actionId&&!this.app.listCommands().some(current=>current.name===targetName&&current.plugin===command.plugin))throw new Error('命令目标插件已变更，请重新选择目标后执行');
     const run=command.actionId?await this.app.startAction(command.actionId,input,{ui,allowUnknownPrivileges}):await this.app.startCommand(targetName,input,{ui,allowUnknownPrivileges,expectedPlugin:command.plugin});
+    if(fromMenu)this.ui.recordCommand?.(`/${targetName}`,{display:true});
     if(this.ui.trackRun){
       this.ui.clearMessages?.();this.ui.trackRun({app:this.app,runId:run.id,title:command.description??command.name,input,done:run.done});
       if(command.action){void run.done.catch(error=>{if(!this.ui.closed)this.ui.show(`运行记录保存失败：${error.message}`);});return;}
@@ -330,8 +350,10 @@ export class TerminalSession{
     }
     const props=Object.entries(meta.input?.properties??{});if(!props.length)return;
     while(true){
+      const effective=step.action&&hasInputRules(meta.input)&&this.app.previewInput?this.app.previewInput(step.action,step.with??{}):undefined;
+      const descriptions=effective?inputEntries(meta.input,effective.value,effective.fields):undefined;
       const selection=await this.ui.select(`${meta.title} · 选择要设置的参数`,[
-        ...props.map(([key,s])=>({value:`field:${key}`,label:`${s.title??key}${meta.input.required?.includes(key)?' *':''}`,description:JSON.stringify(step.with?.[key]??s.default)??'未填写'})),
+        ...props.map(([key,s],index)=>({value:`field:${key}`,label:`${s.title??key}${meta.input.required?.includes(key)?' *':''}`,description:step.with?.[key]?.$ref?`运行时绑定：${step.with[key].$ref}`:descriptions?.[index]??JSON.stringify(step.with?.[key]??s.default)??'未填写'})),
         {value:'done',label:'完成参数设置'},
       ]);
       if(selection==='done')return;
@@ -340,7 +362,7 @@ export class TerminalSession{
       const choices=outputSources(flow,index,catalog,workflows).filter(s=>!schema.type||!s.schema?.type||schema.type===s.schema.type);
       const mode=await this.ui.select(`${schema.title??key} · 输入来源`,[
         {value:'fixed',label:'填写固定值 / @本地文件路径'},{value:'runtime',label:'每次运行时填写'},
-        ...choices.map(({value,label})=>({value,label})),...(!required?[{value:'unset',label:`不传此参数${schema.default!==undefined?'，使用已声明的默认值':''}`}]:[]),
+        ...choices.map(({value,label})=>({value,label})),...(!required||schema.default!==undefined||schema['x-fst']?.fromConfig?[{value:'unset',label:schema['x-fst']?.fromConfig?'恢复继承插件配置':`不传此参数${schema.default!==undefined?'，使用已声明的默认值':''}`}]:[]),
       ]);
       if(mode==='unset')setBinding(flow,index,key,'fixed',schema,undefined);
       else if(mode==='fixed'){
@@ -429,7 +451,7 @@ export class TerminalSession{
     const choice=await this.ui.select(`[插件] ${plugin?.title??id} · 选择能力`,[
       ...commands.map(c=>({value:`command:${c.name}`,label:c.description??c.name,description:`/${c.name}`})),{value:'back',label:'返回主面板'},
     ]);
-    if(choice!=='back')await this.pluginCommand(commands.find(c=>`command:${c.name}`===choice),[]);
+    if(choice!=='back')await this.pluginCommand(commands.find(c=>`command:${c.name}`===choice),[],{fromMenu:true});
   }
   async toolConfig(){
     while(true){
@@ -599,7 +621,7 @@ export class TerminalSession{
       if(choice==='back')return;
       if(choice==='details')await this.ui.viewMarkdown(plugin.title??id,pluginDetails(plugin,actions,declaredCommands));
       else if(choice==='configure')await this.configure(id);
-      else if(choice.startsWith('command:'))await this.pluginCommand(commands.find(c=>c.name===choice.slice(8)),[]);
+      else if(choice.startsWith('command:'))await this.pluginCommand(commands.find(c=>c.name===choice.slice(8)),[],{fromMenu:true});
       else if(choice==='remove'){
         this.writable();if(await this.ui.confirm(`${plugin.scope==='global'?'全局卸载（影响所有工作区）':'移除'} ${id}？`)){
           let removed;
@@ -672,5 +694,8 @@ export async function startTerminal(app,options={}){
   const ui=new TerminalView({baseDir:options.baseDir??process.cwd(),previewLabel:options.previewLabel}),session=new TerminalSession(app,ui,options);
   const terminate=()=>{session.exiting=true;ui.pending?.reject(Object.assign(new Error('退出'),{code:'PROMPT_CANCELLED'}));for(const r of app.listRuns())if(r.status==='running')app.cancelRun(r.id);};
   process.once('SIGTERM',terminate);
-  try{ui.start();await session.run();}finally{process.removeListener('SIGTERM',terminate);await ui.close();}
+  try{ui.start();await session.run();}finally{
+    process.removeListener('SIGTERM',terminate);const cleanup=await ui.close();
+    if(cleanup?.incomplete)throw new FlowError(`终端已关闭，但仍有 ${cleanup.unreaped} 个文件探测进程未回收`,{code:'FS_CLEANUP_INCOMPLETE',details:cleanup});
+  }
 }

package/node_modules/@mytools/fst-cli/src/terminal/view.js

@@ -1,10 +1,10 @@
-import { readdirSync, statSync } from 'node:fs';
-import path from 'node:path';
-import { homedir } from 'node:os';
-import { TUI, Text, Container, Editor, SelectList, ProcessTerminal, CombinedAutocompleteProvider, matchesKey, truncateToWidth, visibleWidth } from '@mariozechner/pi-tui';
+import {FileAutocomplete,createAutocompleteProbe} from './file-autocomplete.js';
+export {FileAutocomplete} from './file-autocomplete.js';
+import { TUI, Text, Container, Editor, SelectList, ProcessTerminal, matchesKey, truncateToWidth, visibleWidth } from '@mariozechner/pi-tui';
 import { MarkdownLogViewer } from './log-viewer.js';
 import { RunViewer, mouseOn, mouseOff, mouseWheel } from './run-viewer.js';
 import {RunFeed} from './run-feed.js';
+import {presentationCatalog} from './run-presentation.js';
 import { logo } from './presentation.js';
 import { VERSION } from '@mytools/core/version';
 import {cleanText as safe,palette,menuTheme as theme,fitLine,shortenPath} from './theme.js';
@@ -13,44 +13,9 @@ export const cancelled=()=>Object.assign(new Error('已返回主菜单'),{code:'
 // 上游菜单按字符数分配描述宽度，中文双宽字符需要再按终端列宽收口。
 function fit(component){const render=component.render.bind(component);component.render=width=>render(width).map(line=>truncateToWidth(line,width));return component;}
 
-// Pi 的 @ 模糊搜索依赖额外的 fd 程序。这里按目录补全，离线目标机无需安装 fd。
-export class FileAutocomplete extends CombinedAutocompleteProvider{
-  constructor(commands,baseDir,workflows=[]){super(commands,baseDir);this.baseDir=baseDir;this.workflows=workflows;}
-  getSuggestions(lines,line,col){
-    const run=lines[line].slice(0,col).match(/^\/run\s+([^@"\s]*)$/);
-    if(run){
-      const query=run[1].toLowerCase(),items=this.workflows.filter(flow=>`${flow.id} ${flow.title??''}`.toLowerCase().includes(query)).map(flow=>({value:flow.id,label:flow.title??flow.id,description:flow.id,workflow:true}));
-      return items.length?{prefix:run[1],items}:null;
-    }
-    const prefix=lines[line].slice(0,col).match(/(?:^|\s)(@"[^"\n]*|@[^\s]*)$/)?.[1];
-    if(!prefix)return super.getSuggestions(lines,line,col);
-    const raw=prefix.slice(1).replace(/^"/,'').replaceAll('\\','/');
-    const expanded=raw.startsWith('~/')?path.join(homedir(),raw.slice(2)):raw;
-    const absolute=path.resolve(this.baseDir,expanded||'.');
-    const directory=!raw||raw.endsWith('/')?absolute:path.dirname(absolute);
-    const query=!raw||raw.endsWith('/')?'':path.basename(absolute).toLowerCase();
-    try{
-      const items=readdirSync(directory,{withFileTypes:true}).filter(e=>e.name.toLowerCase().startsWith(query)).map(e=>{
-        let dir=e.isDirectory();if(e.isSymbolicLink()){try{dir=statSync(path.join(directory,e.name)).isDirectory();}catch{}}
-        const head=raw.slice(0,raw.lastIndexOf('/')+1),file=head+e.name+(dir?'/':'');
-        return {value:`@${/[\s"]/.test(file)?JSON.stringify(file):file}`,label:safe(e.name)+(dir?'/':''),description:dir?'目录':'文件',directory:dir};
-      }).sort((a,b)=>(b.description==='目录')-(a.description==='目录')||a.label.localeCompare(b.label)).slice(0,100);
-      return items.length?{prefix,items}:null;
-    }catch{return null;}
-  }
-  getForceFileSuggestions(lines,line,col){return this.getSuggestions(lines,line,col);}
-  applyCompletion(lines,line,col,item,prefix){
-    if(item.workflow){const next=[...lines],before=lines[line].slice(0,col-prefix.length),text=item.value+' ';next[line]=before+text+lines[line].slice(col);return {lines:next,cursorLine:line,cursorCol:before.length+text.length};}
-    if(!prefix.startsWith('@'))return super.applyCompletion(lines,line,col,item,prefix);
-    const before=lines[line].slice(0,col-prefix.length);
-    let after=lines[line].slice(col);if(after.startsWith('"'))after=after.slice(1);
-    const completed=item.value+(item.directory?'':' '),next=[...lines];next[line]=before+completed+after;
-    return {lines:next,cursorLine:line,cursorCol:before.length+completed.length-(item.directory&&item.value.endsWith('"')?1:0)};
-  }
-}
-
 export class TerminalView{
-  constructor({baseDir,previewLabel,terminal=new ProcessTerminal()}={}){
+  constructor({baseDir,previewLabel,terminal=new ProcessTerminal(),fileAutocompleteOptions={}}={}){
+    this.fileAutocompleteOptions=fileAutocompleteOptions;this.fileProviders=new Set();
     this.baseDir=baseDir;this.terminal=terminal;this.tui=new TUI(terminal);this.logs=[];this.runViews=new Map();
     this.historyOffset=0;this.commandHistory=[];this.commandHistoryIndex=null;this.feed=new RunFeed(()=>this.refreshTranscript());
     const originalStart=terminal.start.bind(terminal);
@@ -69,6 +34,7 @@ export class TerminalView{
       }
       if(matchesKey(data,'ctrl+c')){if(this.runViewer){this.runViewer.onClose();return;}if(this.cancelRun)this.cancelRun();this.pending?.reject(cancelled());return;}
       if(matchesKey(data,'escape')&&this.pending&&!this.logViewer&&!this.runViewer){
+        this.editor?.autocompleteProvider?.cancelPending?.();
         // 编辑器自己处理补全菜单 Escape，第二次 Escape 返回上一级。
         if(this.editor?.isShowingAutocomplete?.()){input(data);return;}
         this.pending.reject(cancelled());return;
@@ -87,10 +53,11 @@ export class TerminalView{
         }
         lines.push(line);
       }
-      lines.push(this.homeInput?(width<45?`/ 操作 · ! 命令 · Ctrl+O ${this.feed.expanded?'收起':'展开'}`:`/ 操作 · ! 命令 · Ctrl+O ${this.feed.expanded?'收起':'展开'}详情 · /logs 回看 · Ctrl+C 退出`):this.editor&&this.multilineInput?'↑↓ 移动 · Tab 补全 · Esc 返回 · Ctrl+C 退出':(width<45?'↑↓ 选择  Enter 确认  Esc 返回':'↑↓ 选择   Enter 确认   Tab 补全   Esc 返回   Ctrl+C 退出'));
+      lines.push(this.homeInput?(width<45?`/ 操作 · ! 命令 · Ctrl+O ${this.feed.expanded?'收起':'展开'}`:`/ 操作 · ! 命令 · Ctrl+O ${this.feed.expanded?'收起':'展开'}原始输出 · /logs 回看 · Ctrl+C 退出`):this.editor&&this.multilineInput?'↑↓ 移动 · Tab 补全 · Esc 返回 · Ctrl+C 退出':(width<45?'↑↓ 选择  Enter 确认  Esc 返回':'↑↓ 选择   Enter 确认   Tab 补全   Esc 返回   Ctrl+C 退出'));
       return lines.map(line=>line?fitLine(' '+palette.muted(line),width):'');
     };
-    const renderTranscript=this.transcript.render.bind(this.transcript);
+    const renderText=this.transcript.render.bind(this.transcript);
+    const renderTranscript=width=>{if(this.transcriptWidth!==width)this.updateTranscript(width);return renderText(width);};
     this.headingLines=(width,mark='FISHtools')=>{
       const room=Math.max(1,width-2),lines=[''];
       const summary=(this.summaryText??'').split('\n');
@@ -151,14 +118,31 @@ export class TerminalView{
     this.tui.requestRender();return true;
   }
   async close(){
-    if(this.closed)return;this.closed=true;
-    this.feed.close();
-    // Pi 的渲染排在 nextTick；先排空最后一帧，再恢复终端，避免退出后隐藏光标。
-    await new Promise(resolve=>process.nextTick(resolve));this.tui.stop();
-    if(this.started)this.terminal.write(mouseOff+'\x1b[?1049l');
-    if(this.terminal instanceof ProcessTerminal)process.stdin.pause();
+    if(this.closing)return this.closing;this.closed=true;
+    return this.closing=(async()=>{
+      try{
+        await Promise.all([...this.fileProviders].map(provider=>provider.close()));this.fileProviders.clear();
+        return await this.fileProbe?.close();
+      }finally{
+        this.feed.close();
+        // Pi 的渲染排在 nextTick；先排空最后一帧，再恢复终端，避免退出后隐藏光标。
+        await new Promise(resolve=>process.nextTick(resolve));this.tui.stop();
+        if(this.started)this.terminal.write(mouseOff+'\x1b[?1049l');
+        if(this.terminal instanceof ProcessTerminal)process.stdin.pause();
+      }
+    })();
   }
   summary(text){this.summaryText=safe(text);this.tui.requestRender();}
+  recordCommand(text,{display=false}={}){
+    // 表单参数不写入可召回命令；Shell 原文仍保留末尾换行。
+    const command=text.trimStart().startsWith('!')?text:text.trim();
+    if(!command)return;
+    if(this.commandHistory.at(-1)!==command){
+      this.commandHistory.push(command);if(this.commandHistory.length>100)this.commandHistory.shift();
+      this.commandHistoryIndex=null;this.onHistoryChange?.();
+    }
+    if(display)this.feed.message('› '+safe(command));
+  }
   beginCommand(text){
     const name=text.trim().split(/\s+/)[0].replace(/^\//,'');
     const labels={workflows:'工作流',run:'运行工作流',plugin:'插件管理',plugins:'插件管理',config:'工具配置',pack:'打包',logs:'执行记录',runs:'执行记录',tools:'工具',help:'帮助',exit:'退出'};
@@ -168,12 +152,15 @@ export class TerminalView{
   endCommand(){
     this.commandLocation=null;this.tui.requestRender();
   }
-  transcriptText(){return [...this.logs,this.feed.text()].filter(Boolean).join('\n\n');}
+  transcriptText(width=this.terminal.columns){return [...this.logs,this.feed.text(Math.max(1,width-2))].filter(Boolean).join('\n\n');}
   refreshTranscript(){
     const width=this.terminal.columns,previous=this.transcript.render===undefined?0:new Text(safe(this.lastTranscript??''),1,0).render(width).length;
-    const text=safe(this.transcriptText());
+    const text=safe(this.transcriptText(width));
     if(this.historyOffset>0)this.historyOffset=Math.max(0,this.historyOffset+new Text(text,1,0).render(width).length-previous);
-    this.lastTranscript=text;this.transcript.setText(text.split('\n').map(line=>line.startsWith('✗ ')?palette.error(line):/^[›✓●] /.test(line)?palette.brand(line):line.startsWith('↩ ')?palette.muted(line):line).join('\n'));this.tui.requestRender();this.onHistoryChange?.();
+    this.updateTranscript(width,text);this.tui.requestRender();this.onHistoryChange?.();
+  }
+  updateTranscript(width,text=safe(this.transcriptText(width))){
+    this.transcriptWidth=width;this.lastTranscript=text;this.transcript.setText(text.split('\n').map(line=>line.startsWith('✗ ')?palette.error(line):/^[›✓●] /.test(line)?palette.brand(line):line.startsWith('↩ ')?palette.muted(line):line).join('\n'));
   }
   trackRun(options){this.feed.track(options);}
   clearMessages(){this.logs=[];this.refreshTranscript();}
@@ -190,7 +177,7 @@ export class TerminalView{
     try{
       await new Promise((resolve,reject)=>{
         this.pending={resolve,reject};
-        this.logViewer=new MarkdownLogViewer({title:safe(title),text:safe(text),terminal:this.terminal,onClose:resolve,requestRender:()=>this.tui.requestRender()});
+        this.logViewer=new MarkdownLogViewer({title:safe(title),text,terminal:this.terminal,onClose:resolve,requestRender:()=>this.tui.requestRender()});
         this.terminal.write(mouseOn);
         // Overlay 的基底为空，旧 transcript 不再撑高滚动区域；关闭后原样恢复。
         this.tui.children=[];
@@ -217,7 +204,7 @@ export class TerminalView{
     try{
       await new Promise((resolve,reject)=>{
         this.pending={resolve,reject};
-        const viewer=new RunViewer({record:initial,flow:initial.status==='running'?flow:undefined,workflows,catalog:app.catalog?.()??[],terminal:this.terminal,onClose:resolve,onCancel:()=>app.cancelRun(runId),onReadLogs:app.readLogPage?()=>{readPages=true;resolve();}:undefined,onReadOutput:()=>{renderedOutput=viewer.getRenderedOutput();resolve();},requestRender:()=>this.tui.requestRender()});
+        const viewer=new RunViewer({record:initial,flow:initial.status==='running'?flow:undefined,workflows,catalog:presentationCatalog(app),terminal:this.terminal,onClose:resolve,onCancel:()=>app.cancelRun(runId),onReadLogs:app.readLogPage?()=>{readPages=true;resolve();}:undefined,onReadOutput:()=>{renderedOutput=width=>viewer.getRenderedOutput(width,{markdown:true});resolve();},requestRender:()=>this.tui.requestRender()});
         this.runViewer=viewer;Object.assign(viewer,this.runViews.get(runId)??{});
         if(initialView!==undefined){viewer.view=initialView;viewer.offset=0;}
         const stopElapsed=()=>{if(elapsedTimer){clearInterval(elapsedTimer);elapsedTimer=null;}};
@@ -264,18 +251,16 @@ export class TerminalView{
   }
   async ask(message,component){
     fit(component);
-    const title=new Text(palette.brand('› ')+palette.text(safe(message)),1,0);
-    const renderTitle=title.render.bind(title);
-    title.render=width=>[fitLine(' '+palette.border('─'.repeat(Math.max(1,width-2))),width),...renderTitle(width)];
-    if(message.startsWith('fst >'))title.render=()=>[];
+    const title=new Text('',1,0);
+    // 参数预览可随窗口尺寸重新排版；普通字符串标题保持原有行为。
+    title.render=width=>{
+      const text=typeof message==='function'?message(width,this.terminal.rows):message;
+      return [fitLine(' '+palette.border('─'.repeat(Math.max(1,width-2))),width),...new Text(palette.brand('› ')+palette.text(safe(text)),1,0).render(width)];
+    };
+    if(typeof message==='string'&&message.startsWith('fst >'))title.render=()=>[];
     this.prompt.clear();this.prompt.addChild(title);this.prompt.addChild(component);this.tui.setFocus(component);this.tui.requestRender();
     try{return await new Promise((resolve,reject)=>{this.pending={resolve,reject};component.onSubmit=text=>{
-      // Shell 历史保留末尾换行，避免再次执行时改变反斜杠续行等语义。
-      const historyText=text.trimStart().startsWith('!')?text:text.trim();
-      if(this.homeInput&&historyText&&this.commandHistory.at(-1)!==historyText){
-        this.commandHistory.push(historyText);if(this.commandHistory.length>100)this.commandHistory.shift();
-        this.onHistoryChange?.();
-      }
+      if(this.homeInput)this.recordCommand(text);
       resolve(text);
     };component.onSelect=item=>resolve(item.value);component.onCancel=()=>reject(cancelled());});}
     finally{if(this.homeInput)this.terminal.write(mouseOff);this.pending=null;this.editor=null;this.homeInput=false;this.multilineInput=false;this.prompt.clear();this.tui.requestRender();}
@@ -321,14 +306,41 @@ export class TerminalView{
     if(this.homeInput)this.terminal.write(mouseOn);
     this.editor=editor;editor.setText(this.homeInput?(this.homeDraft??value):value);
     if(this.homeInput)this.homeDraft=undefined;
-    if(files||commands.length)editor.setAutocompleteProvider(new FileAutocomplete(commands,this.baseDir,workflows));
-    return this.ask(message,editor);
+    let provider;
+    if(files||commands.length){
+      // 预算属于整个终端；未退出的 worker 不能因切换输入框而被遗忘。
+      this.fileProbe??=createAutocompleteProbe(this.fileAutocompleteOptions);
+      provider=new FileAutocomplete(commands,this.baseDir,workflows,{...this.fileAutocompleteOptions,probe:this.fileProbe,ownsProbe:false,files,onUpdate:snapshot=>{
+        const cursor=editor.getCursor();
+        if(this.closed||this.editor!==editor||!this.pending||this.logViewer||this.runViewer||editor.getText()!==snapshot.lines.join('\n')||cursor.line!==snapshot.line||cursor.col!==snapshot.col)return;
+        // pi-tui 的 updateAutocomplete 只更新已打开的菜单；冷缓存要用此入口重新建立候选。
+        // 此调用只更新菜单，绝不调用 applyCompletion 或合成 Tab 按键。
+        editor.tryTriggerAutocomplete();this.tui.requestRender();
+      }});
+      this.fileProviders.add(provider);editor.setAutocompleteProvider(provider);
+      const input=editor.handleInput.bind(editor);
+      editor.handleInput=data=>{
+        const before=editor.getText();provider.cancelPending();input(data);
+        const cursor=editor.getCursor(),text=editor.getLines()[cursor.line].slice(0,cursor.col);
+        // 冷缓存时上游已收起菜单，继续输入不会走 updateAutocomplete，需再次触发查询。
+        if(editor.getText()!==before&&text&&!/\s$/.test(text)&&!editor.isShowingAutocomplete())editor.tryTriggerAutocomplete();
+      };
+    }
+    return this.ask(message,editor).finally(async()=>{if(provider){await provider.close();this.fileProviders.delete(provider);}});
   }
   async select(message,items){
     if(!items.length)throw new Error('当前没有可选择的项目');
-    const list=new SelectList(items.map(i=>({...i,label:safe(i.label).replace(/\s+/g,' '),description:i.description?safe(i.description).replace(/\s+/g,' '):undefined})),8,theme);
+    const visibleItems=()=>items.filter(item=>!item.hidden?.()).map(i=>({...i,label:safe(i.label).replace(/\s+/g,' '),description:i.description?safe(i.description).replace(/\s+/g,' '):undefined}));
+    const list=new SelectList(visibleItems(),8,theme);
     list.render=width=>{
-      const reserved=this.headingLines(width).length+new Text(palette.text(safe(message)),1,0).render(width).length+this.hint.render(width).length+2;
+      // 缩放窗口后保留当前选项；只显示此刻确实需要的展开入口。
+      const selected=list.getSelectedItem()?.value;
+      const previousIndex=list.selectedIndex;
+      list.filteredItems=visibleItems();
+      const selectedIndex=list.filteredItems.findIndex(item=>item.value===selected);
+      list.selectedIndex=selectedIndex>=0?selectedIndex:Math.min(previousIndex,list.filteredItems.length-1);
+      const text=typeof message==='function'?message(width,this.terminal.rows):message;
+      const reserved=this.headingLines(width).length+new Text(palette.text(safe(text)),1,0).render(width).length+this.hint.render(width).length+2;
       list.maxVisible=Math.max(1,Math.min(8,this.terminal.rows-reserved));
       const start=Math.max(0,Math.min(list.selectedIndex-Math.floor(list.maxVisible/2),list.filteredItems.length-list.maxVisible));
       const end=Math.min(start+list.maxVisible,list.filteredItems.length),lines=[];

package/node_modules/@mytools/fst-cli/src/terminal/workflow-menu.js

@@ -3,7 +3,7 @@ export async function workflowMenu(session){
   while(true){
     const workflows=await app.listWorkflows();
     const choice=await ui.select('工作流 · 选择后编辑或执行',[
-      ...workflows.map(flow=>({value:`workflow:${flow.id}`,label:flow.title??flow.id,description:`${flow.id} · ${flow.steps.length} 步`})),
+      ...workflows.map(flow=>({value:`workflow:${flow.id}`,label:flow.title??flow.id,description:flow.status==='invalid'?flow.diagnostic.message:`${flow.id} · ${flow.steps.length} 步`})),
       ...(!app.project.readOnly?[{value:'new',label:'＋ 新建工作流'}]:[]),
       ...(session.dirty?[{value:'draft',label:`继续编辑草稿：${session.flow.title}`}]:[]),
       {value:'back',label:'返回主面板'},
@@ -11,6 +11,8 @@ export async function workflowMenu(session){
     if(choice==='back')return;
     try{
       const id=choice.startsWith('workflow:')?choice.slice(9):null;
+      const selected=workflows.find(flow=>flow.id===id);
+      if(selected?.status==='invalid'){ui.show(`工作流不可用：${selected.diagnostic.message}`);continue;}
       if(choice==='new'){if(await session.execute('/new')===false)continue;}
       else if(choice!=='draft'&&session.flow?.id!==id){
         if(!await session.discard())continue;

package/node_modules/@mytools/fst-devtools/README.md

@@ -19,6 +19,8 @@
 
 ## 维护与验证
 
+`plugin lint` 的 `UNMANAGED_PROCESS` 迁移警告识别可追溯的 child_process、execa、cross-spawn、shelljs.exec 及平台底层 runProcess 调用，指向文件行列并建议上下文 ctx.runProcess。只导入未调用、注释、字符串及无法确认的局部重名不据此告警。诊断保持 warning，不拒绝旧插件；复杂动态代码、依赖内部和解释器内部不保证覆盖，不构成安全隔离。
+
 本模块负责上述职责的实现、文档与回归；跨模块接口调整需要同时检查生产者与消费者。具体维护人员尚未指定。
 
 在仓库根目录执行：

package/node_modules/@mytools/fst-devtools/src/plugin-quality.js

@@ -3,6 +3,7 @@ import {readFile,realpath} from 'node:fs/promises';
 import {isBuiltin,createRequire} from 'node:module';
 import {fileURLToPath,pathToFileURL} from 'node:url';
 import {parse} from 'acorn';
+import {inspectProcessUsage} from './process-usage.js';
 
 const nonempty=value=>typeof value==='string'&&value.trim().length>0;
 function inspectSchema(schema,location,warning,seen=new WeakSet()){
@@ -84,6 +85,8 @@ function sourceReferences(ast,commonjs,warning,location){
       base?.type==='MemberExpression'&&!base.computed&&base.property.name==='url'&&base.object.type==='MetaProperty'&&base.object.meta.name==='import')loaders.add(node.id.name);
   });
   // 保守跳过文件内重名绑定；不把局部对象当作 Node 全局对象。
+  const isRequire=node=>node.callee?.type==='Identifier'&&((commonjs&&!bindings.has('require')&&node.callee.name==='require')||loaders.has(node.callee.name));
+  inspectProcessUsage(ast,{bindings,isRequire,walk},warning,location);
   walk(ast,node=>{
     const at=`${location}:${node.loc.start.line}:${node.loc.start.column+1}`;
     if(['ImportDeclaration','ExportNamedDeclaration','ExportAllDeclaration','ImportExpression'].includes(node.type)&&typeof node.source?.value==='string'){
@@ -91,7 +94,7 @@ function sourceReferences(ast,commonjs,warning,location){
     }
     if(node.type!=='CallExpression')return;
     const callee=node.callee;
-    if(callee.type==='Identifier'&&((commonjs&&!bindings.has('require')&&callee.name==='require')||loaders.has(callee.name))&&typeof node.arguments[0]?.value==='string'){
+    if(isRequire(node)&&typeof node.arguments[0]?.value==='string'){
       references.push({specifier:node.arguments[0].value,at,commonjs:true});
     }
     if(!bindings.has('console')&&callee.type==='MemberExpression'&&callee.object.type==='Identifier'&&callee.object.name==='console'&&

package/node_modules/@mytools/fst-devtools/src/plugin-tools.js

@@ -38,6 +38,7 @@ export async function lintPluginDirectory(directory){
   const quality=await import('./plugin-quality.js');
   return {...await inspectPluginDirectory(directory,quality),notes:[...validationNotes(),
     {code:'STATIC_SCAN_LIMITS',message:'源码检查仅覆盖入口可达的本地 JavaScript 和字面量依赖；动态加载、别名调用和局部重名可能无法识别。质量警告不会修改文件，也不代表运行结果或安全保证。'},
+    {code:'UNMANAGED_PROCESS_LIMITS',message:'进程检查只定位可识别的直接调用；动态计算、复杂别名、依赖包及 Python/Shell 内部执行不保证覆盖。迁移警告不阻止旧插件加载，不构成安全隔离或自动提权。'},
   ]};
 }
 

package/node_modules/@mytools/fst-devtools/src/process-usage.js

@@ -0,0 +1,62 @@
+const processMembers=new Set(['spawn','spawnSync','exec','execSync','execFile','execFileSync','fork']);
+const sources=new Set(['node:child_process','child_process','execa','cross-spawn','shelljs','@mytools/fst-platform']);
+const property=node=>node.computed?node.property?.value:node.property?.name;
+
+function launches({source,members}){
+  const names=members[0]==='default'?members.slice(1):members;
+  if(['node:child_process','child_process'].includes(source))return names.length===1&&processMembers.has(names[0]);
+  if(source==='execa')return names.length===0||names.length===1&&['execa','execaSync','execaCommand','execaCommandSync','execaNode','$'].includes(names[0]);
+  if(source==='cross-spawn')return names.length===0||names.length===1&&['spawn','sync'].includes(names[0]);
+  if(source==='shelljs')return names.length===1&&names[0]==='exec';
+  return source==='@mytools/fst-platform'&&names.length===1&&names[0]==='runProcess';
+}
+
+// 仅诊断能追溯到已知模块的调用，不以模块导入本身判定违规，也不执行源码。
+export function inspectProcessUsage(ast,{bindings,isRequire,walk},warning,location){
+  const imported=new Map(),variables=new Map(),mutated=new Set();
+  const rootName=node=>node?.type==='Identifier'?node.name:node?.type==='MemberExpression'?rootName(node.object):undefined;
+  walk(ast,node=>{
+    if(node.type==='ImportDeclaration'&&sources.has(node.source.value))for(const spec of node.specifiers){
+      imported.set(spec.local.name,{source:node.source.value,members:spec.type==='ImportNamespaceSpecifier'?[]:[spec.type==='ImportDefaultSpecifier'?'default':spec.imported.name??spec.imported.value]});
+    }
+    if(node.type==='VariableDeclarator'){
+      if(node.id.type==='Identifier')variables.set(node.id.name,{value:node.init,members:[]});
+      else if(node.id.type==='ObjectPattern')for(const spec of node.id.properties){
+        if(spec.type==='Property'&&spec.value.type==='Identifier'&&(!spec.computed||typeof spec.key.value==='string'))variables.set(spec.value.name,{value:node.init,members:[spec.computed?spec.key.value:spec.key.name??spec.key.value]});
+      }
+    }
+    if(['AssignmentExpression','UpdateExpression','UnaryExpression'].includes(node.type)){
+      const target=node.left??node.argument;
+      if(target?.type==='MemberExpression'&&(node.type!=='UnaryExpression'||node.operator==='delete'))mutated.add(rootName(target));
+      if(node.type==='UpdateExpression'&&target?.type==='Identifier')mutated.add(target.name);
+    }
+  });
+  function resolve(node,seen=new Set()){
+    if(!node)return;
+    if(node.type==='AwaitExpression'||node.type==='ChainExpression')return resolve(node.argument??node.expression,seen);
+    if(node.type==='Identifier'){
+      if(bindings.get(node.name)!==1||mutated.has(node.name)||seen.has(node.name))return;
+      if(imported.has(node.name))return imported.get(node.name);
+      const variable=variables.get(node.name);if(!variable)return;
+      const result=resolve(variable.value,new Set([...seen,node.name]));
+      return result&&{source:result.source,members:[...result.members,...variable.members]};
+    }
+    if(node.type==='MemberExpression'){
+      const name=property(node);if(typeof name!=='string')return;
+      const result=resolve(node.object,seen);return result&&{source:result.source,members:[...result.members,name]};
+    }
+    // Execa 的对象参数只绑定选项，返回的函数被调用时才启动程序。
+    if(node.type==='CallExpression'&&node.arguments[0]?.type==='ObjectExpression'){
+      const target=resolve(node.callee,seen);
+      if(target?.source==='execa'&&launches(target))return target;
+    }
+    const source=node.type==='ImportExpression'?node.source?.value:node.type==='CallExpression'&&isRequire(node)?node.arguments[0]?.value:undefined;
+    if(sources.has(source))return {source,members:[]};
+  }
+  walk(ast,node=>{
+    if(!['CallExpression','TaggedTemplateExpression'].includes(node.type))return;
+    const target=resolve(node.callee??node.tag);if(!target||!launches(target))return;
+    if(target.source==='execa'&&node.type==='CallExpression'&&node.arguments[0]?.type==='ObjectExpression')return;
+    warning('UNMANAGED_PROCESS',`直接调用 ${target.source}${target.members.length?'.'+target.members.join('.'):''} 可能绕过统一执行记录、取消与代理规则；执行外部程序请改用 ctx.runProcess(file, args, options)。此提示不代表该调用已执行`,`${location}:${node.loc.start.line}:${node.loc.start.column+1}`);
+  });
+}

package/node_modules/@mytools/fst-platform/README.md

@@ -12,6 +12,7 @@
 | 导入路径 | 实现位置 |
 | --- | --- |
 | `@mytools/fst-platform` | `./src/process.js` |
+| `@mytools/fst-platform/managed-process` | `./src/managed-process.js` |
 | `@mytools/fst-platform/environments` | `./src/environments.js` |
 | `@mytools/fst-platform/bundle` | `./src/bundle.js` |
 | `@mytools/fst-platform/json` | `./src/json.js` |
@@ -37,6 +38,10 @@ node --test tests/modules.test.js tests/process.test.js tests/environments.test.
 
 ## 子进程环境
 
+`createProcessRunner({execute=runProcess,signal,log,audience})` 是内核调用方共用的受管包装，返回签名兼容 `runProcess(file,args,options)` 的函数。每次调用独立生成 `processId`，先写指令日志再执行自定义 onStart，先写输出日志再执行自定义 onOutput；合并调用级与上下文取消信号，不改变底层并发。插件经宿主 `ctx.runProcess` 使用，不能直接导入本入口代替上下文。权限检查由 plugin 负责，本包装不授予权限、不进行命令黑名单拦截。
+
+受管调用可指定 `logPolicy:false` 隐藏自动记录的参数与脚本，或 `{redactArgs:[零起算下标],omitArgs:true,omitScript:true}` 按需选择；实际参数和调用方 onStart 保留原值。有参数被隐藏时脚本也隐藏。无效策略执行前拒绝。该策略不自动识别密钥、不处理插件主动输出及已有日志；平台自动生成的进程启动失败信息也不再拼接 Execa 的完整命令行。
+
 `/shell` 的 `runShell(script,{shell='auto',runProcess,temporaryDir,...processOptions})` 使用唯一临时脚本文件，避免长脚本超过系统命令行长度上限，运行结束后删除本次文件。默认 Windows PowerShell / Linux sh，可选 powershell、pwsh、sh、bash；PowerShell 使用 UTF-8 BOM，其他 Shell 使用无 BOM UTF-8。插件传入 `ctx.runProcess` 与 `temporaryDir:ctx.outputDir`，保留当前代理、取消与日志规则，并兼容只读包目录。`shellInvocation` 保留构造简短命令参数的兼容接口。
 
 Windows 的 `shell:'auto'` 对单行 `ipconfig` / `ipconfig.exe` 及其字面量参数（如 `ipconfig /all`）直接执行系统目录中的 `ipconfig.exe`，读取当前系统 OEM 代码页后统一解码结果和实时输出。自动适配限于 TextDecoder 支持的 OEM 866、874、932、936、949、950、65001；中文 Windows 的 OEM 936 使用 GBK。代码页探测失败或代码页不受支持（如 437、850）时保留原 Shell 路径。变量、管道、多行、重定向等脚本继续按原 PowerShell 语义执行；复杂脚本中的旧编码与 UTF-8 混合输出没有自动转码。`onStart` 的 `script` 字段保留用户原始指令，直接执行的简单命令同时记录实际程序路径和参数。

package/node_modules/@mytools/fst-platform/package.json

@@ -6,6 +6,7 @@
   "main": "src/process.js",
   "exports": {
     ".": "./src/process.js",
+    "./managed-process": "./src/managed-process.js",
     "./shell": "./src/shell.js",
     "./environments": "./src/environments.js",
     "./bundle": "./src/bundle.js",

package/node_modules/@mytools/fst-platform/src/managed-process.js

@@ -0,0 +1,36 @@
+import {randomUUID} from 'node:crypto';
+import {runProcess} from './process.js';
+import {FlowError} from '@mytools/sdk';
+
+function invocationFilter(policy,args){
+  if(policy===undefined)return value=>value;
+  const invalid=()=>{throw new FlowError('logPolicy 必须为 false 或含 redactArgs、omitArgs、omitScript 的有效对象；参数下标从 0 开始且不能越界',{code:'VALIDATION'});};
+  if(policy!==false&&(!policy||typeof policy!=='object'||Array.isArray(policy)))invalid();
+  if(policy!==false){
+    if(Object.keys(policy).some(key=>!['redactArgs','omitArgs','omitScript'].includes(key)))invalid();
+    for(const key of ['omitArgs','omitScript'])if(policy[key]!==undefined&&typeof policy[key]!=='boolean')invalid();
+    if(policy.redactArgs!==undefined&&(!Array.isArray(policy.redactArgs)||policy.redactArgs.some(index=>!Number.isSafeInteger(index)||index<0||index>=(args?.length??0))))invalid();
+  }
+  const omitted=policy===false||policy.omitArgs===true,indices=new Set(policy.redactArgs??[]);
+  const omitScript=omitted||indices.size>0||policy.omitScript===true;
+  return value=>({...value,
+    ...(Array.isArray(value.args)?{args:omitted?(value.args.length?['[参数已隐藏]']:[]):value.args.map((arg,index)=>indices.has(index)?'[已隐藏]':arg)}:{}),
+    ...(value.script!==undefined&&omitScript?{script:'[原始脚本已隐藏]'}:{}),
+  });
+}
+
+// 每次调用独立绑定日志和取消信号；共享入口不串行化进程，也不授予额外权限。
+export function createProcessRunner({execute=runProcess,signal,log,audience}={}){
+  return (file,args,options={})=>{
+    const {logPolicy,...executionOptions}=options,displayInvocation=invocationFilter(logPolicy,args);
+    const processId=randomUUID();
+    const combined=signal&&options.signal?AbortSignal.any([signal,options.signal]):signal??options.signal;
+    return execute(file,args,{...executionOptions,signal:combined,onStart:async invocation=>{
+      await log?.('执行程序',displayInvocation(invocation),{kind:'process',processId});
+      await options.onStart?.(invocation);
+    },onOutput:async({stream,message})=>{
+      await log?.(message,undefined,{stream,processId,...(audience?{audience}:{})});
+      await options.onOutput?.({stream,message});
+    }});
+  };
+}

package/node_modules/@mytools/fst-platform/src/process.js

@@ -5,6 +5,8 @@ import { FlowError } from '@mytools/sdk';
 import path from 'node:path';
 
 const stripFinalNewline=text=>text.endsWith('\r\n')?text.slice(0,-2):text.endsWith('\n')?text.slice(0,-1):text;
+// 执行库的校验错误和启动错误都可能包含完整 argv，仅保留安全的错误代码。
+const spawnFailure=(file,code='SPAWN_FAILED')=>new FlowError(`无法启动程序 ${file}：${code}；请检查参数格式、执行目录、文件权限及程序依赖`,{code});
 
 export async function runProcess(file,args=[],{cwd,env,extendEnv=true,signal,timeout=30000,maxBuffer=4*1024*1024,encoding='utf8',onOutput,onStart,commandText,outputMode='buffer',summaryBytes=65536}={}) {
   if(!['buffer','stream'].includes(outputMode))throw new TypeError('outputMode 必须为 buffer 或 stream');
@@ -38,7 +40,9 @@ export async function runProcess(file,args=[],{cwd,env,extendEnv=true,signal,tim
   if(signal?.aborted)throw new FlowError('操作已取消',{code:'CANCELLED'});
   // 平台统一收集原始字节和执行上限；Execa 的超限收集器会提前关闭管道，
   // 导致持续输出的父进程因 EPIPE 退出，taskkill 尚未遍历就失去父 PID。
-  const child=execa(executable,args,{cwd,env,extendEnv,reject:false,windowsHide:true,maxBuffer,buffer:false,timeout:0,shell:false,encoding:'buffer',stripFinalNewline:false});
+  let child;
+  try{child=execa(executable,args,{cwd,env,extendEnv,reject:false,windowsHide:true,maxBuffer,buffer:false,timeout:0,shell:false,encoding:'buffer',stripFinalNewline:false});}
+  catch(error){throw spawnFailure(file,error.code);}
   let reason,killing,outputError,outputFailed=false,outputWrites=Promise.resolve();
   let markStopped;const stopped=new Promise(resolve=>{markStopped=resolve;});
   const outputBytes={stdout:0,stderr:0},tails={stdout:'',stderr:''},buffers={stdout:[],stderr:[]};let outputTruncated=false;
@@ -110,7 +114,8 @@ export async function runProcess(file,args=[],{cwd,env,extendEnv=true,signal,tim
   if(reason==='output-limit')throw new FlowError('程序输出超过上限',{code:'OUTPUT_LIMIT'});
   if(reason)throw new FlowError(reason==='cancelled'?'操作已取消':'程序运行超时',{code:reason==='cancelled'?'CANCELLED':'TIMEOUT'});
   if(result.isMaxBuffer)throw new FlowError('程序输出超过上限',{code:'OUTPUT_LIMIT'});
-  if(result.exitCode===undefined&&result.failed)throw new FlowError(`无法启动程序 ${file}：${result.shortMessage??result.message}`,{code:result.code??'SPAWN_FAILED'});
+  // Execa 的短错误包含完整 argv，不能重新写回已由受管入口隐藏的敏感参数。
+  if(result.exitCode===undefined&&result.failed)throw spawnFailure(file,result.code);
   const decode=chunks=>stripFinalNewline(new TextDecoder(decoderEncoding).decode(Buffer.concat(chunks)));
   if(streaming)return {exitCode:result.exitCode,stdout:stripFinalNewline(tails.stdout),stderr:stripFinalNewline(tails.stderr),outputMode,outputTruncated,outputBytes};
   return {exitCode:result.exitCode,stdout:decode(buffers.stdout),stderr:decode(buffers.stderr)};