@yanglaofish/fishtools 0.5.3 → 0.6.0

package/manual/packages/fst-cli/src/terminal/run-viewer.js

@@ -1,10 +1,9 @@
-import { stripVTControlCharacters } from 'node:util';
 import { Text, matchesKey, truncateToWidth } from '@mariozechner/pi-tui';
-import {palette} from './theme.js';
+import {palette,cleanText as safe} from './theme.js';
 import {readableValue,readableError,readableTimeline,elapsedTime} from './run-presentation.js';
+import {outputReport} from './report-presentation.js';
 
 export const runStatuses={pending:'待执行',unknown:'摘要已省略',running:'运行中',succeeded:'成功',failed:'失败',cancelled:'已取消',skipped:'已跳过',stopped:'已停止'};
-const safe=value=>stripVTControlCharacters(String(value)).replace(/[\x00-\x08\x0b-\x1f\x7f]/g,'');
 export const mouseWheel=data=>{const match=/^\x1b\[<(\d+);\d+;\d+[Mm]$/.exec(data);return match&&(Number(match[1])&64)?(Number(match[1])&1?1:-1):0;};
 export const mouseOn='\x1b[?1000h\x1b[?1006h';
 export const mouseOff='\x1b[?1006l\x1b[?1000l';
@@ -39,15 +38,18 @@ export class RunViewer{
     this.requestRender();
   }
   outputSchema(node){return this.catalog.find(action=>action.id===(node?.action??this.record.action??this.record.workflowId))?.output;}
-  getRenderedOutput(){
+  getRenderedOutput(width=this.terminal.columns,{markdown=false}={}){
     const node=this.view===0?undefined:this.nodes[this.selected],output=node?node.output:this.record.output,schema=this.outputSchema(node);
-    if(output&&typeof output==='object'){
+    if(output&&typeof output==='object'&&!outputReport(output)){
       if(typeof output.markdown==='string')return output.markdown;
       for(const [key,value] of Object.entries(output))if(typeof value==='string'&&(schema?.properties?.[key]?.format==='markdown'||schema?.properties?.[key]?.contentMediaType==='text/markdown'))return value;
     }
-    return readableValue(output,'',schema);
+    const text=readableValue(output,'',schema,{compact:true,width:markdown?Math.max(1,width-2):width,truncated:node?node.eventTruncated:this.record.outputTruncated});
+    if(!markdown)return text;
+    const fence='`'.repeat(Math.max(3,...[...text.matchAll(/`+/g)].map(match=>match[0].length+1)));
+    return `${fence}text\n${text}\n${fence}`;
   }
-  content(){
+  content(width=this.terminal.columns){
     const node=this.nodes[this.selected],status=runStatuses[this.record.status]??this.record.status;
     const elapsed=elapsedTime(this.record,this.now());
     if(this.view===0)return [
@@ -55,7 +57,7 @@ export class RunViewer{
       elapsed!==undefined?`耗时：${elapsed}`:'',
       this.record.error?readableError(this.record.error):'',
       ...(this.record.warnings??[]).map(warning=>`警告：${warning.message}`),
-      this.record.output!==undefined?'\n最终输出\n'+readableValue(this.record.output,'',this.outputSchema()):'',
+      this.record.output!==undefined?'\n最终输出（紧凑显示）\n'+readableValue(this.record.output,'',this.outputSchema(),{compact:true,width,truncated:this.record.outputTruncated}):'',
       this.record.resultDir?'\n生成文件：'+this.record.resultDir:'',
       '\n步骤 · Enter 查看详情',
       ...this.nodes.map((n,i)=>`${i===this.selected?'›':' '} ${runStatuses[n.status]??n.status} · ${n.title??n.callPath}${n.durationMs!==undefined?` · ${n.durationMs} ms`:''}${n.reason?' · '+n.reason:''}`),
@@ -63,19 +65,20 @@ export class RunViewer{
     ].filter(Boolean).join('\n');
     if(this.view===1){
       const action=this.catalog.find(action=>action.id===(node?.action??this.record.action??this.record.workflowId));
-      const format=(value,schema)=>this.raw?JSON.stringify(value??null,null,2):readableValue(value,'',schema);
+      const format=(value,schema,{compact=false,decodeStrings=true}={})=>this.raw?JSON.stringify(value??null,null,2):readableValue(value,'',schema,{compact,decodeStrings,width,truncated:node?node.eventTruncated:compact?this.record.outputTruncated:this.record.inputTruncated});
       const error=node?node.error:this.record.error;
+      const input=node?node.input:this.record.input!==undefined?this.record.input:this.record.events?.find(event=>event.type==='run.input')?.input;
       return [`步骤：${node?.title??node?.callPath??'整个运行'}`,node?.title&&node.callPath?'调用路径：'+node.callPath:'',node?.action?'能力：'+node.action:'',error?'\n错误\n'+(this.raw?format(error):readableError(error)):'',
-        '\n输入\n'+format(node?node.input:this.record.input??this.record.events?.find(event=>event.type==='run.input')?.input,action?.input), '\n输出\n'+format(node?node.output:this.record.output,action?.output),
+        '\n输入\n'+format(input,action?.input,{decodeStrings:false}), '\n输出\n'+format(node?node.output:this.record.output,action?.output,{compact:true}),
         !error&&(node?.reason||node?.message)?'\n说明：'+(node.reason??node.message):'',this.raw?'\n原始 JSON · 包含完整错误详情与调用栈':'\nj 查看原始 JSON 与完整诊断',
         this.onReadOutput?'m 格式化阅读输出':'',
       ].filter(Boolean).join('\n');
     }
-    return (this.record.eventsTruncated?'当前为近期日志摘要，按 p 分页查看完整落盘日志。\n\n':'')+readableTimeline(this.record.events,{callPath:this.allLogs?undefined:node?.callPath,catalog:this.catalog});
+    return (this.record.eventsTruncated?'当前为近期日志摘要，按 p 分页查看完整落盘日志。\n\n':'')+readableTimeline(this.record.events,{callPath:this.allLogs?undefined:node?.callPath,catalog:this.catalog,width});
   }
   layout(width){
     const height=Math.max(1,this.terminal.rows),pageSize=Math.max(1,height-4);
-    const lines=new Text(safe(this.content()),0,0).render(Math.max(1,width));
+    const lines=new Text(safe(this.content(width)),0,0).render(Math.max(1,width));
     const maxOffset=Math.max(0,lines.length-pageSize);
     this.offset=this.follow&&this.view===2?maxOffset:Math.max(0,Math.min(this.offset,maxOffset));
     return {height,pageSize,lines,maxOffset};

package/manual/packages/fst-cli/src/terminal/schema.js

@@ -1,18 +1,128 @@
-import { validate } from '@mytools/sdk/schema';
+import { validate, assertSchema } from '@mytools/sdk/schema';
+import {isDeepStrictEqual} from 'node:util';
 import { fileReference } from './model.js';
+import {readableValue} from './run-presentation.js';
+import {cleanText,fitLine} from './theme.js';
+import {visibleWidth} from '@mariozechner/pi-tui';
+import {hasInputRules,resolveInput} from '@mytools/sdk/inputs';
 
 export const needsJsonEditor=schema=>['oneOf','anyOf','allOf','if','$ref','patternProperties'].some(key=>schema?.[key]!==undefined);
 
+// 与执行时共用校验器；即使尚缺必填字段，也保留已能确定的默认值供编辑。
+function editableDefaults(schema,value){
+  const copy=structuredClone(value);
+  if(schema!=null)assertSchema(schema,'参数')(copy);
+  return copy;
+}
+
+export function inputEntries(schema,value,fields={}){
+  if(schema?.type!=='object'||!schema.properties||needsJsonEditor(schema))return [readableValue(value,'',schema,{decodeStrings:false})];
+  const names=new Set([...Object.keys(schema.properties),...Object.keys(value??{})]);
+  return [...names].map(name=>{
+    const field=fields[name],title=schema.properties[name]?.title??name;
+    if(value?.[name]===undefined)return `${title}：${schema.required?.includes(name)?'未填写（必填）':field?.unsetLabel??'未提供（插件未声明缺省行为）'}`;
+    const text=readableValue({[name]:value[name]},'',schema,{decodeStrings:false});
+    if(!field)return text;
+    const source=field?.source==='config'?'继承插件配置：':field?.source==='default'?'默认值：':field?.source==='input'?'本次输入：':'';
+    return `${title}：${source}${readableValue(value[name],'',schema.properties[name],{decodeStrings:false})}${field?.unit?' '+field.unit:''}${field?.path?'（'+field.path+'）':''}`;
+  });
+}
+
+function parameterPreview(entries,label,screenWidth=80,screenHeight=24){
+  const limit=Math.max(1,Math.min(4,screenHeight-10)),width=Math.max(8,screenWidth-6);
+  const values=entries.map(entry=>cleanText(entry).replace(/[\r\n\t]/g,' '));
+  let columns=width>=110?3:width>=60?2:1;
+  // 来源说明较长时减少列数，优先显示完整含义，仍保持预览行数有界。
+  while(columns>1&&values.some(value=>visibleWidth(value)>Math.floor((width-(columns-1)*3)/columns)))columns--;
+  const cellWidth=Math.floor((width-(columns-1)*3)/columns);
+  const cells=values.slice(0,limit*columns).map(entry=>fitLine(entry,cellWidth));
+  const rows=[];
+  for(let index=0;index<cells.length;index+=columns){
+    rows.push(cells.slice(index,index+columns).map((cell,i)=>i<columns-1?cell+' '.repeat(cellWidth-visibleWidth(cell)):cell).join('   '));
+  }
+  const preview=rows.join('\n')||'无需参数';
+  return {text:`${fitLine(cleanText(label??'插件能力').replace(/\s+/g,' '),width)}\n当前参数（含默认值）：\n${preview}`,truncated:values.length>cells.length||values.some(value=>visibleWidth(value)>cellWidth)||entries.some(entry=>/[\r\n\t]/.test(entry))};
+}
+
+export async function commandInput(ui,schema,value,{baseDir,label,preview}={}){
+  const rules=hasInputRules(schema),project=preview??(value=>resolveInput(schema,value,{}, {check:false}));
+  let current=rules?structuredClone(value):editableDefaults(schema,value);
+  while(true){
+    const resolved=rules?project(current):{value:current};
+    const entries=inputEntries(schema,resolved.value,resolved.fields),summary=entries.join('\n')||'无需参数';
+    const layout=()=>parameterPreview(entries,label,ui.terminal?.columns,ui.terminal?.rows);
+    const message=(width,height)=>parameterPreview(entries,label,width,height).text;
+    const choice=await ui.select(ui.terminal?message:message(),[
+      {value:'run',label:'执行'},
+      {value:'edit',label:'配置参数'},
+      ...(ui.viewMarkdown?[{value:'view',label:'展开未显示完整的参数',description:`共 ${entries.length} 项`,hidden:()=>!layout().truncated}]:[]),
+      {value:'cancel',label:'返回'},
+    ]);
+    if(choice==='cancel')return {cancelled:true};
+    if(choice==='view'){
+      // 保留换行和引号，参数里的 Markdown 符号不能改变显示含义。
+      let fenceLength=3;for(const match of summary.matchAll(/`+/g))fenceLength=Math.max(fenceLength,match[0].length+1);
+      const fence='`'.repeat(fenceLength);
+      await ui.viewMarkdown('当前参数（含默认值）',`${fence}text\n${summary}\n${fence}`);continue;
+    }
+    if(choice==='edit')current=await editInput(ui,schema,current,{baseDir,label,preview:project,required:true});
+    else if(choice==='run'){
+      try{
+        if(rules){validate(schema,project(current).value,label??'插件参数',{useDefaults:false});return {value:structuredClone(current)};}
+        return {value:validate(schema,current,label??'插件参数')};
+      }
+      catch(error){if(error.code!=='VALIDATION')throw error;ui.show(`暂不能执行，请配置参数：${error.message}`);}
+    }
+  }
+}
+
+// 能力调用和快捷名称保存使用同一编辑入口，省略值不因打开表单而固化。
+export async function editInput(ui,schema,value,options={}){
+  if(!hasInputRules(schema))return editValue(ui,schema,value,options);
+  return editInputRules(ui,schema,value,{...options,preview:options.preview??(value=>resolveInput(schema,value,{}, {check:false}))});
+}
+
+async function editInputRules(ui,schema,value,{baseDir,label,preview}){
+  const current=structuredClone(value);
+  while(true){
+    const resolved=preview(current),entries=inputEntries(schema,resolved.value,resolved.fields);
+    const names=Object.keys(schema.properties);
+    const choice=await ui.select(`${label??'参数'} · 选择字段`,[
+      ...names.map((name,index)=>({value:`field:${name}`,label:schema.properties[name].title??name,description:entries[index]})),
+      {value:'__done',label:'完成填写'},
+    ]);
+    if(choice==='__done'){
+      try{validate(schema,preview(current).value,label??'参数',{useDefaults:false});return current;}
+      catch(error){ui.show(error.message);continue;}
+    }
+    const name=choice.slice(6),field=schema.properties[name],rule=field['x-fst'];
+    if(rule){
+      const action=await ui.select(field.title??name,[{value:'set',label:'设置本次输入'},{value:'inherit',label:rule.fromConfig?'恢复继承插件配置':'恢复省略参数'},{value:'back',label:'返回'}]);
+      if(action==='back')continue;
+      if(action==='inherit'){delete current[name];continue;}
+    }
+    const next=await editValue(ui,field,resolved.value[name],{baseDir,label:field.title??name,required:schema.required?.includes(name)});
+    if(next===undefined)delete current[name];else Object.defineProperty(current,name,{value:next,enumerable:true,writable:true,configurable:true});
+  }
+}
+
 // 值只在整个编辑过程完成后返回，Escape 不会留下半个修改。
 export async function editValue(ui,schema={},value,{baseDir,required=false,label=schema.title??'值'}={}){
   if(value===undefined&&schema.default!==undefined)value=structuredClone(schema.default);
   if(schema.enum&&!needsJsonEditor(schema)){
-    const index=await ui.select(label,schema.enum.map((v,i)=>({value:String(i),label:JSON.stringify(v)})));
+    const choices=schema.enum.map((v,i)=>({value:String(i),label:JSON.stringify(v)}));
+    const selected=schema.enum.findIndex(item=>isDeepStrictEqual(item,value));
+    if(selected>0)choices.unshift(...choices.splice(selected,1));
+    const index=await ui.select(label,choices);
     return schema.enum[Number(index)];
   }
-  if(schema.type==='boolean'&&!needsJsonEditor(schema))return (await ui.select(label,[{value:'true',label:'是 / true'},{value:'false',label:'否 / false'}]))==='true';
+  if(schema.type==='boolean'&&!needsJsonEditor(schema)){
+    const choices=[{value:'true',label:'是 / true'},{value:'false',label:'否 / false'}];
+    if(value===false)choices.reverse();
+    return (await ui.select(label,choices))==='true';
+  }
   if(schema.type==='object'&&schema.properties&&!needsJsonEditor(schema)){
-    const result=structuredClone(value??{}),props=Object.entries(schema.properties);
+    const result=editableDefaults(schema,value??{}),props=Object.entries(schema.properties);
     while(true){
       const key=await ui.select(`${label} · 选择字段`,[
         ...props.map(([key,s])=>({value:`field:${key}`,label:`${s.title??key}${schema.required?.includes(key)?' *':''}`,description:JSON.stringify(result[key])??'未填写'})),

package/manual/packages/fst-cli/src/terminal/session-history.js

@@ -1,7 +1,7 @@
 import path from 'node:path';
 import {randomUUID} from 'node:crypto';
 import {createSessionHistory} from '@mytools/fst-logs/sessions';
-import {readableValue,readableError,runCategory,runCategoryNames} from './run-presentation.js';
+import {readableValue,readableError,runCategory,runCategoryNames,presentationCatalog} from './run-presentation.js';
 
 // 完整交互追加落盘，快照只保存可立即恢复的近期窗口，不重复保存运行日志全文。
 export class TerminalHistory{
@@ -59,7 +59,7 @@ export class TerminalHistory{
     if(this.app.listRuns().some(run=>run.status==='running'))throw new Error('当前有运行中的任务，完成后再恢复历史会话。');
     await this.flush();this.resumedFrom=record.id;
     this.ui.commandHistory=[...record.commandHistory];this.ui.commandHistoryIndex=null;
-    this.ui.feed.restoreState(record.feed,{catalog:this.app.catalog?.()??[]});
+    this.ui.feed.restoreState(record.feed,{catalog:presentationCatalog(this.app)});
     this.append({type:'restored',sessionId:record.id});await this.flush();
   }
   async close(){await this.flush();this.closed=true;this.ui.feed.onEntry=null;this.ui.onHistoryChange=null;}

package/manual/packages/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/manual/packages/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/manual/packages/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;