@yanglaofish/fishtools 0.5.0 → 0.5.2

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

@@ -0,0 +1,186 @@
+import {randomUUID} from 'node:crypto';
+import {isCommandName} from '@mytools/fst-plugin/contracts';
+import {editValue} from './schema.js';
+
+export async function runShortcut(session,entry,args=[]){
+  if(!entry.available)throw new Error(`快捷名称 /${entry.name} 已失效：${entry.reason??'目标不存在'}`);
+  const {app}=session,target=entry.target;
+  if(target.command){
+    const command=app.listCommands().find(command=>command.name===target.command&&command.plugin===target.plugin);
+    if(!command)throw new Error(`快捷名称 /${entry.name} 的目标命令不存在`);
+    return session.pluginCommand({...command,name:entry.name,targetName:command.name,shortcutInput:entry.input??{}},args);
+  }
+  const action=app.catalog().find(action=>action.id===target.action);
+  if(!action)throw new Error(`快捷名称 /${entry.name} 的目标动作不存在`);
+  const plugin=action.plugin??action.id.slice(0,action.id.lastIndexOf(':'));
+  return session.pluginCommand({...action,name:entry.name,plugin,action:action.id.slice(plugin.length+1),actionId:action.id,shortcutInput:entry.input??{}},args);
+}
+
+async function parameters(session,value={}){
+  const result=structuredClone(value),{ui}=session;
+  for(;;){
+    const choice=await ui.select('命令参数（脚本通过 FST_INPUT_参数名 环境变量读取）',[
+      ...Object.entries(result).map(([name,field])=>({value:`field:${name}`,label:field.title??name,description:`${name} · ${field.type}`})),
+      {value:'new',label:'添加参数'},{value:'back',label:'完成参数设置'},
+    ]);
+    if(choice==='back')return result;
+    const existing=choice.startsWith('field:')?choice.slice(6):undefined;
+    if(existing){
+      const operation=await ui.select(`参数 ${existing}`,[{value:'edit',label:'编辑'},{value:'remove',label:'删除'},{value:'back',label:'返回'}]);
+      if(operation==='back')continue;
+      if(operation==='remove'){delete result[existing];continue;}
+    }
+    const name=existing??(await ui.input('参数名（英文字母、数字、下划线，不能以数字开头）',{files:false})).trim();
+    if(!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name)||['__proto__','constructor','prototype'].includes(name)){ui.show('参数名无效，请重新填写。');continue;}
+    if(!existing&&Object.hasOwn(result,name)){ui.show('参数名已经存在。');continue;}
+    const title=await ui.input('参数显示名称',{value:result[name]?.title??name,files:false});
+    const type=await ui.select('参数类型',[{value:'string',label:'文本'},{value:'number',label:'数字'},{value:'boolean',label:'是 / 否'}]);
+    const field={title,type,required:await ui.confirm('这个参数必须填写吗？')};
+    if(await ui.confirm('设置默认值吗？'))field.default=await editValue(ui,{type},result[name]?.default,{baseDir:session.baseDir,required:true,label:'默认值'});
+    result[name]=field;
+  }
+}
+
+async function editPreset(session,id,current){
+  const {ui,app}=session,preset=structuredClone(current??{shell:'auto'});
+  preset.title=(await ui.input('常用命令名称',{value:preset.title??'',files:false})).trim();
+  preset.script=await ui.input('命令文本 · Shift+Enter 换行，Enter 提交（Alt+Enter 备用）',{value:preset.script??'',files:false,multiline:true});
+  const action=`@mytools/commands:${id}`;
+  const oldName=Object.keys(app.project.shortcuts??{}).find(name=>app.project.shortcuts[name].action===action);
+  let shortcut=oldName??(isCommandName(preset.title)?preset.title:'');
+  for(;;){
+    const choice=await ui.select('常用命令设置',[
+      {value:'save',label:'保存',description:shortcut?`快捷执行 /${shortcut}`:'只注册工作流动作'},
+      {value:'title',label:'修改名称'},{value:'script',label:'编辑多行命令'},
+      {value:'shortcut',label:'快捷名称',description:shortcut||'未设置'},
+      {value:'shell',label:'命令解释器',description:preset.shell??'auto'},
+      {value:'timeout',label:'超时时间',description:preset.timeout===0?'不限时':`${(preset.timeout??30000)/1000} 秒`},
+      {value:'parameters',label:'参数',description:`${Object.keys(preset.parameters??{}).length} 项，可不设置`},
+      {value:'root',label:'Linux root 权限要求',description:preset.requireRoot?'需要 root':'按当前用户权限执行'},
+      {value:'back',label:'取消，返回'},
+    ]);
+    if(choice==='back')return;
+    if(choice==='title')preset.title=(await ui.input('常用命令名称',{value:preset.title,files:false})).trim();
+    else if(choice==='script')preset.script=await ui.input('命令文本 · Shift+Enter 换行，Enter 提交（Alt+Enter 备用）',{value:preset.script,files:false,multiline:true});
+    else if(choice==='shortcut')shortcut=(await ui.input('快捷名称（支持中文，不含空格或 /；留空不设置）',{value:shortcut,files:false})).trim();
+    else if(choice==='shell')preset.shell=await ui.select('命令解释器',[
+      {value:'auto',label:'按系统选择（Windows PowerShell / Linux sh）'},
+      {value:'powershell',label:'Windows PowerShell'},{value:'pwsh',label:'PowerShell 7（pwsh）'},
+      {value:'sh',label:'sh'},{value:'bash',label:'bash'},
+    ]);
+    else if(choice==='timeout'){
+      const seconds=Number(await ui.input('超时时间（秒，0 表示不限时）',{value:String((preset.timeout??30000)/1000),files:false}));
+      if(!Number.isFinite(seconds)||!Number.isSafeInteger(seconds*1000)||seconds<0||seconds*1000>2147483647){ui.show('超时时间无效。');continue;}
+      preset.timeout=seconds*1000;
+    }else if(choice==='parameters')preset.parameters=await parameters(session,preset.parameters);
+    else if(choice==='root')preset.requireRoot=await ui.confirm('这个命令在 Linux 上必须使用 root 吗？执行前会检查，不会自动提权。');
+    else if(choice==='save'){
+      const next={...app.project.commandPresets,[id]:preset},shortcuts=structuredClone(app.project.shortcuts??{});
+      if(oldName)delete shortcuts[oldName];
+      if(shortcut){
+        if(Object.hasOwn(shortcuts,shortcut)){ui.show(`快捷名称 /${shortcut} 已存在，请选择其他名称。`);continue;}
+        shortcuts[shortcut]={...(oldName?app.project.shortcuts[oldName]:{}),action};
+      }
+      try{
+        const result=await session.withMaintenance(options=>app.configureCommandPresets(next,{...options,shortcuts}));
+        if(result===null){ui.show('已取消保存。');continue;}
+        ui.show(`常用命令已保存，修改前配置已备份。${shortcut?`输入 /${shortcut} 可直接运行。`:''}也可在工作流中添加此动作。`);
+        return;
+      }catch(error){ui.show(`保存失败：${error.message}`);}
+    }
+  }
+}
+
+export async function commandPresetsMenu(session){
+  const {app,ui}=session;
+  for(;;){
+    const choice=await ui.select('常用命令',[
+      ...(!app.project.readOnly?[{value:'new',label:'注册常用命令'}]:[]),
+      ...Object.entries(app.project.commandPresets??{}).map(([id,preset])=>({value:`preset:${id}`,label:preset.title,description:id})),
+      {value:'back',label:'返回主面板'},
+    ]);
+    if(choice==='back')return;
+    if(choice==='new'){session.writable();await editPreset(session,`command-${randomUUID().slice(0,8)}`);continue;}
+    const id=choice.slice(7),preset=app.project.commandPresets?.[id];if(!preset)continue;
+    const operation=await ui.select(preset.title,[{value:'run',label:'运行'},
+      ...(!app.project.readOnly?[{value:'edit',label:'编辑'},{value:'remove',label:'删除注册项'}]:[]),{value:'back',label:'返回'}]);
+    if(operation==='run')await runShortcut(session,{name:preset.title,target:{action:`@mytools/commands:${id}`},input:{},available:true});
+    else if(operation==='edit'){session.writable();await editPreset(session,id,preset);}
+    else if(operation==='remove'){
+      session.writable();if(!await ui.confirm(`删除 ${preset.title}？指向它的快捷名称会显示失效；引用中的工作流需先调整。`))continue;
+      const next=structuredClone(app.project.commandPresets);delete next[id];
+      try{const result=await session.withMaintenance(options=>app.configureCommandPresets(next,options));if(result!==null)ui.show('注册项已删除，修改前配置已备份。');}
+      catch(error){ui.show(`删除失败：${error.message}`);}
+    }
+  }
+}
+
+function targets(app){
+  return [...app.catalog().map(action=>({value:`action:${action.id}`,label:`动作：${action.title??action.id}`,description:action.id})),
+    ...app.listCommands().map(command=>({value:`command:${command.name}`,label:`命令：/${command.name}`,description:command.description}))];
+}
+function shortcutTarget(app,selected){
+  if(selected.startsWith('action:'))return {action:selected.slice(7)};
+  const name=selected.slice(8),command=app.listCommands().find(command=>command.name===name);
+  if(!command)throw new Error('目标命令已失效，请重新选择');
+  return {command:name,plugin:command.plugin};
+}
+async function editShortcut(session,oldName){
+  const {app,ui}=session,old=app.project.shortcuts?.[oldName];
+  let name=(await ui.input('快捷名称（支持中文，不含空格或 /）',{value:oldName??'',files:false})).trim();
+  let target=old?structuredClone(old):{};
+  if(!old){
+    const choices=targets(app);if(!choices.length){ui.show('当前没有可选择的插件动作或命令。');return;}
+    const selected=await ui.select('选择快捷名称指向的能力',choices);
+    target=shortcutTarget(app,selected);
+  }
+  for(;;){
+    const choice=await ui.select(`快捷名称 /${name}`,[
+      {value:'save',label:'保存'},{value:'name',label:'修改快捷名称'},
+      {value:'target',label:'选择目标',description:target.action??target.command},
+      {value:'input',label:'设置默认参数',description:'可留空，运行时按需要填写'},
+      {value:'back',label:'取消，返回'},
+    ]);
+    if(choice==='back')return;
+    if(choice==='name')name=(await ui.input('快捷名称',{value:name,files:false})).trim();
+    else if(choice==='target'){
+      const selected=await ui.select('选择目标',targets(app));
+      target=shortcutTarget(app,selected);
+    }else if(choice==='input'){
+      const metadata=target.action?app.catalog().find(action=>action.id===target.action):app.listCommands().find(command=>command.name===target.command&&command.plugin===target.plugin);
+      if(!metadata){ui.show('目标已失效，请先重新选择目标。');continue;}
+      target.input=await editValue(ui,metadata.input??{type:'object',properties:{},additionalProperties:false},target.input??{},{baseDir:session.baseDir,required:true,label:'快捷名称默认参数'});
+    }else if(choice==='save'){
+      const next=structuredClone(app.project.shortcuts??{});if(oldName)delete next[oldName];
+      if(Object.hasOwn(next,name)){ui.show('快捷名称已经存在，请选择其他名称。');continue;}
+      next[name]=target;
+      try{await app.configureShortcuts(next);ui.show('快捷名称已保存，修改前配置已备份。');return;}
+      catch(error){ui.show(`保存失败：${error.message}`);}
+    }
+  }
+}
+
+export async function shortcutsMenu(session){
+  const {app,ui}=session;
+  for(;;){
+    const entries=app.listShortcuts(),choice=await ui.select('自定义快捷名称',[
+      ...(!app.project.readOnly?[{value:'new',label:'添加快捷名称'}]:[]),
+      ...entries.map(entry=>({value:`shortcut:${entry.name}`,label:`/${entry.name}${entry.available?'':' [失效]'}`,description:entry.available?entry.description:entry.reason})),
+      {value:'back',label:'返回主面板'},
+    ]);
+    if(choice==='back')return;
+    if(choice==='new'){session.writable();await editShortcut(session);continue;}
+    const name=choice.slice(9),entry=entries.find(entry=>entry.name===name);if(!entry)continue;
+    const operation=await ui.select(`/${name}`,[
+      ...(entry.available?[{value:'run',label:'运行'}]:[]),
+      ...(!app.project.readOnly?[{value:'edit',label:'编辑'},{value:'remove',label:'删除快捷名称'}]:[]),{value:'back',label:'返回'},
+    ]);
+    if(operation==='run')await runShortcut(session,entry);
+    else if(operation==='edit'){session.writable();await editShortcut(session,name);}
+    else if(operation==='remove'){
+      session.writable();if(!await ui.confirm(`删除快捷名称 /${name}？`))continue;
+      const next=structuredClone(app.project.shortcuts??{});delete next[name];
+      await app.configureShortcuts(next);ui.show('快捷名称已删除，插件能力仍可使用。');
+    }
+  }
+}

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

@@ -1,10 +1,11 @@
 import {builtinCommands} from '@mytools/fst-plugin/contracts';
 
-const visible=['workflows','run','pack','logs','plugin','config','tools','help','exit'];
+const visible=['workflows','run','pack','logs','plugin','commands','shortcuts','config','tools','help','exit'];
 // 入口由插件 ID 推导；冲突时加前缀，不能覆盖内置或作者注册的命令。
-export function commandMenu(plugins,commands){
+export function commandMenu(plugins,commands,shortcuts=[]){
   const entries=builtinCommands.filter(command=>visible.includes(command.name)).map(command=>({...command,description:`[内置] ${command.description}`}));
-  const used=new Set([...builtinCommands.map(c=>c.name),...commands.map(c=>c.name)]);
+  const used=new Set([...builtinCommands.map(c=>c.name),...commands.map(c=>c.name),...shortcuts.map(entry=>entry.name)]);
+  entries.push(...shortcuts.map(entry=>({name:entry.name,shortcut:true,description:`[快捷] ${entry.available?entry.description:`已失效：${entry.reason}`}`})));
   const groups=plugins.filter(plugin=>commands.some(c=>c.plugin===plugin.id)).sort((a,b)=>a.id.localeCompare(b.id));
   for(const plugin of groups){
     const leaf=plugin.id.split('/').at(-1).replace(/[^\w.-]/g,'-');

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

@@ -1,12 +1,21 @@
 import {readableValue,readableError,readableTimeline} from './run-presentation.js';
 import {runStatuses} from './run-viewer.js';
+import {createStepSummaries} from '@mytools/fst-logs/steps';
+import {previewRun} from '@mytools/fst-logs/preview';
+
+const feedRecord=(record,maxBytes)=>{
+  const {stepSummaries,stepSummaryBytes,stepsTruncated,...state}=record;
+  return previewRun({...state,events:[...(state.events??[])]},{maxValueBytes:Math.min(maxBytes,65536)});
+};
 
 // 主面板按事件到达顺序追加；运行快照另存，配置菜单不会清掉执行记录。
 export class RunFeed{
   constructor(refresh,{maxEvents=1000,maxBytes=1048576,maxRuns=50}={}){Object.assign(this,{refresh,maxEvents,maxBytes,maxRuns});this.runs=new Map();this.entries=[];this.subscriptions=new Map();this.expanded=false;this.dropped=0;}
   track({app,runId,title,input}){
     if(this.runs.has(runId))return;
-    const record=app.getRun(runId),item={app,record,title,input,count:0,ended:false,steps:new Map(),catalog:new Map((app.catalog?.()??[]).map(action=>[action.id,action]))};
+    const raw=app.getRun(runId),record=feedRecord(raw,this.maxBytes),bounded=previewRun({input},{maxValueBytes:Math.min(this.maxBytes,65536)});
+    const item={app,record,title,input:bounded.input,inputTruncated:bounded.inputTruncated,count:0,ended:false,steps:createStepSummaries({maxEvents:this.maxEvents,maxMemoryBytes:this.maxBytes}),catalog:new Map((app.catalog?.()??[]).map(action=>[action.id,action]))};
+    for(const summary of raw.stepSummaries??[])item.steps.append(summary);
     this.runs.set(runId,item);
     this.entries.push({type:'start',item});
     if(!this.subscriptions.has(app))this.subscriptions.set(app,app.subscribe(event=>{
@@ -30,12 +39,13 @@ export class RunFeed{
     if(event?.type&&!['run.succeeded','run.failed','run.cancelled','run.stopped'].includes(event.type)){item.record.events.push(event);events=[event];item.count++;}
     else{
       const record=item.app.getRun(item.record.id);if(!record)return;
-      item.record={...record,events:[...(record.events??[])]};
+      item.record=feedRecord(record,this.maxBytes);
+      for(const summary of record.stepSummaries??[])item.steps.append(summary);
       events=record.events.filter((e,index)=>e.seq!==undefined?e.seq>item.count:index>=item.count);
       item.count=record.eventCount??record.events.length;
     }
     const {record}=item;
-    for(const event of events)if(event.type.startsWith('step.'))item.steps.set(event.callPath,{...item.steps.get(event.callPath),...event});
+    for(const event of events)item.steps.append(event);
     if(events.length){
       const last=this.entries.at(-1);
       if(last?.type==='events'&&last.item===item)last.events.push(...events);
@@ -59,7 +69,6 @@ export class RunFeed{
     this.entries=this.entries.filter(entry=>!entry.events||entry.events.length);
     for(const item of this.runs.values()){
       item.record.events=this.entries.filter(e=>e.item===item&&e.events).flatMap(e=>e.events);
-      while(item.steps.size>this.maxEvents)item.steps.delete(item.steps.keys().next().value);
     }
     const ended=[...this.runs.values()].filter(item=>item.ended);
     for(const item of ended.slice(0,Math.max(0,ended.length-this.maxRuns))){this.runs.delete(item.record.id);this.entries=this.entries.filter(e=>e.item!==item);this.dropped++;}
@@ -75,10 +84,14 @@ export class RunFeed{
     for(const event of entry.events){
       const key=`${item.record.id}\0${event.callPath}`;
       if(event.type.startsWith('step.')&&!seen.has(key)){
-        seen.add(key);const latest=item.steps.get(event.callPath),action=item.catalog.get(latest.action);
-        const status=latest.type.slice(5),symbols={started:'●',succeeded:'✓',failed:'✗',cancelled:'×',skipped:'–',stopped:'■'};
-        const name=action?.title??latest.action??latest.stepId??latest.callPath;
-        rows.push(`${symbols[status]??'·'} ${name} · ${status==='started'?'执行中':runStatuses[status]??status}${latest.durationMs!==undefined?' · '+latest.durationMs+' ms':''}${action?.plugin?' · '+action.plugin:''} · ${latest.callPath}`);
+        seen.add(key);const latest=item.steps.get(event.callPath);
+        if(!latest)rows.push(`· ${event.action??event.stepId??event.callPath} · 摘要已省略 · ${event.callPath}`);
+        else{
+          const action=item.catalog.get(latest.action);
+          const status=latest.type.slice(5),symbols={started:'●',succeeded:'✓',failed:'✗',cancelled:'×',skipped:'–',stopped:'■'};
+          const name=action?.title??latest.action??latest.stepId??latest.callPath;
+          rows.push(`${symbols[status]??'·'} ${name} · ${status==='started'?'执行中':runStatuses[status]??status}${latest.durationMs!==undefined?' · '+latest.durationMs+' ms':''}${action?.plugin?' · '+action.plugin:''} · ${latest.callPath}`);
+        }
       }
       if(event.type==='log'&&event.audience==='user')rows.push(`[${event.callPath??item.record.workflowId}] ${event.message??''}${event.data!==undefined?'\n'+readableValue(event.data):''}`);
       if(event.type==='step.failed'&&![...item.steps.values()].some(step=>step.type==='step.failed'&&step.callPath?.startsWith(event.callPath+'/')))rows.push(`✗ ${event.callPath}\n${readableError(event.error??{message:event.message})}`);
@@ -86,18 +99,20 @@ export class RunFeed{
     }
     return rows.length?`${item.title??item.record.workflowId} · ${item.record.id.slice(0,8)}\n${rows.join('\n')}`:'';
   }
-  text(){const seen=new Set();return (this.dropped?'主面板仅保留近期摘要；完整日志可在 /logs 中按 p 分页阅读。\n\n':'')+this.entries.map(entry=>{
+  text(){const seen=new Set();return (this.dropped?'主面板仅保留近期摘要；超出预算的事件和步骤摘要已省略。完整日志可在 /logs 中按 p 分页阅读。\n\n':'')+this.entries.map(entry=>{
     if(entry.type==='message')return entry.text;
     const {record,title,input}=entry.item,label=`${title??record.workflowId} · ${record.id.slice(0,8)}`;
     if(entry.type==='start')return [
       `› ${record.workflowId.startsWith('/')?record.workflowId:'/run '+record.workflowId} · ${label}`,
       `状态：${runStatuses[record.status]??record.status}`,
       this.expanded&&input&&Object.keys(input).length?'输入\n'+readableValue(input):'',
+      this.expanded&&entry.item.inputTruncated?'输入较大，主面板仅显示摘要。':'',
     ].filter(Boolean).join('\n');
     if(entry.type==='events')return this.expanded?`${label}\n${readableTimeline(entry.events,{values:true})}`:this.compactEvents(entry,seen);
     return [`结果 · ${label} · ${runStatuses[record.status]??record.status}`,
       ...(record.warnings??[]).map(warning=>`警告：${warning.message}`),
       this.expanded&&record.output!==undefined?readableValue(record.output):'',record.error&&(this.expanded||![...entry.item.steps.values()].some(step=>step.type==='step.failed'))?readableError(record.error,{details:this.expanded}):'',record.reason??'',
+      this.expanded&&record.outputTruncated?'结果较大，主面板仅显示摘要；完整结果请在 /logs 中按 p 分页阅读。':'',
     ].filter(Boolean).join('\n');
   }).filter(Boolean).join('\n\n');}
   close(){if(this.refreshTimer)clearTimeout(this.refreshTimer);this.refreshTimer=null;for(const unsubscribe of this.subscriptions.values())unsubscribe();this.subscriptions.clear();}

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

@@ -9,6 +9,8 @@ import {gettingStarted,pluginStatus,pluginDetails} from './presentation.js';
 import {readableValue,readableError} from './run-presentation.js';
 import {commandMenu} from './navigation.js';
 import {workflowMenu} from './workflow-menu.js';
+import {commandPresetsMenu,shortcutsMenu,runShortcut} from './command-menu.js';
+import {validate} from '@mytools/sdk/schema';
 import {resolvePrivilegeRequirement,checkStaticPrivilege} from '@mytools/fst-plugin/privileges';
 
 export class TerminalSession{
@@ -24,7 +26,7 @@ export class TerminalSession{
     }
   }
   current(){if(!this.flow)throw new Error('先用 /workflows 打开或新建工作流');return this.flow;}
-  commands(){return commandMenu(this.app.listPlugins?.()??[],this.app.listCommands());}
+  commands(){return commandMenu(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;
@@ -41,7 +43,7 @@ export class TerminalSession{
       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 > 输入 / 选择操作，@ 引用文件',{commands:this.commands(),workflows:await this.app.listWorkflows()});}
+        try{text=await this.ui.input('fst > / 操作 · ! 系统命令 · Shift+Enter 换行 · Enter 提交',{commands:this.commands(),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}`);}
@@ -57,19 +59,25 @@ export class TerminalSession{
     finally{this.commandDepth--;if(outer&&!this.exiting)this.ui.endCommand?.();}
   }
   async executeCommand(text){
+    if(text.trimStart().startsWith('!'))return this.shellCommand(text.trimStart().slice(1));
     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);
     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);
     if(command!=='run'&&args.length)throw new Error(`/${command} 使用交互选择，请不要附加参数`);
     switch(command){
+      case 'commands':return commandPresetsMenu(this);
+      case 'shortcuts':return shortcutsMenu(this);
       case 'help':await this.ui.viewMarkdown('Fishtools 使用指南',[
         '# Fishtools',
         '将插件能力组合为工作流，在终端内编辑、运行并查看结果。',
         `当前工作区：${this.app.projectDir}`,
         `文件路径起点：${this.baseDir}`,
         '## 常用操作',gettingStarted(await this.app.listWorkflows(),this.app.project),
+        '## 系统命令与快捷名称','输入 ! 后接系统命令可直接执行，输出和状态保留在主面板；/commands 注册常用命令供快捷执行与工作流编排，/shortcuts 给任意插件动作或命令设置中文快捷名称。主输入框和命令编辑框使用 Shift+Enter 换行、Enter 提交，Alt+Enter 为备用换行；支持多行粘贴。系统命令按当前 Shell 语法执行，目标机器需要已安装相应外部程序。',
         '## 编排工作流','/workflows 浏览、新建、打开工作流，进入后添加步骤、编辑参数、设置输出、保存或删除。删除会保留备份，仍被其他流程引用时不能删除。/run 选择已保存的工作流，或补全工作流 ID/中文标题后执行已保存版本，不会要求保存编辑草稿。要执行未保存修改，在工作流编辑菜单选择运行，再选择保存并运行；返回编辑会保留草稿。',
         '## 主面板','运行期间可以继续输入命令，打开配置、管理插件或执行其他工作流。↑/↓ 回看本次启动已提交的命令，回到底部恢复草稿；补全菜单打开时仍用于选择候选。Ctrl+O 展开或收起执行详情，PgUp/PgDn 或滚轮浏览执行过程；/logs 回看各次执行的步骤、输入输出和日志。关闭菜单不会清空运行内容。',
         '## 命令分层','/config 配置 Fishtools，/plugin 管理插件及各插件配置。输入 /插件入口名 后进入该插件的能力菜单；补全列表标明 [内置] 或 [插件]。/tools 包含 Web 与离线文档。旧 /new、/add、/steps、/outputs、/save、/plugins 以及插件的原始命令仍可直接输入。',
@@ -118,14 +126,26 @@ export class TerminalSession{
   }
   async pluginCommand(command,args){
     if(args.length>1)throw new Error(`用法：/${command.name} [@参数.json]`);
-    const input=args.length?await readRunInput(args[0],this.baseDir):command.input?await editValue(this.ui,command.input,{}, {baseDir:this.baseDir,required:true,label:command.description}):{};
+    let input;
+    if(args.length)input=await readRunInput(args[0],this.baseDir);
+    else{
+      const initial=structuredClone(command.shortcutInput??{});
+      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;
+    }
     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);
+    if(!definition)throw new Error('目标插件已移除，请重新选择目标后执行');
     const requirement=resolvePrivilegeRequirement(definition,command.action);
     const unknown=requirement.declared&&checkStaticPrivilege(requirement).status==='unknown';
     const allowUnknownPrivileges=unknown?await this.ui.confirm(`/${command.name} 的权限需要运行时核查。若检查结果仍无法确认，是否允许本次继续？\n${requirement.reason??''}\n${requirement.remediation??''}`):false;
     if(unknown&&!allowUnknownPrivileges)return;
-    const run=await this.app.startCommand(command.name,input,{ui,allowUnknownPrivileges});
+    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(this.ui.trackRun){
       this.ui.clearMessages?.();this.ui.trackRun({app:this.app,runId:run.id,title:command.description??command.name,input});
       if(command.action){void run.done.catch(error=>{if(!this.ui.closed)this.ui.show(`运行记录保存失败：${error.message}`);});return;}
@@ -135,6 +155,17 @@ export class TerminalSession{
     try{const result=await run.done;if(!this.ui.trackRun)this.ui.show(`插件执行${runStatuses[result.status]??result.status}\n${result.error?readableError(result.error):readableValue(result.output)}\n/logs 查看执行详情与历史日志`);}
     finally{unsubscribe();done();}
   }
+  async shellCommand(script){
+    const run=await this.app.startShell(script);
+    if(this.ui.trackRun){
+      this.ui.clearMessages?.();this.ui.trackRun({app:this.app,runId:run.id,title:'系统命令'});
+      void run.done.catch(error=>{if(!this.ui.closed)this.ui.show(`运行记录保存失败：${error.message}`);});return;
+    }
+    const unsubscribe=this.app.subscribe(event=>{if(event.runId===run.id&&event.type==='log')this.ui.show(event.message);});
+    const done=this.ui.busy('正在执行系统命令 · Ctrl+C 取消',()=>this.app.cancelRun(run.id));
+    try{const result=await run.done;this.ui.show(`命令${runStatuses[result.status]??result.status}\n${result.error?readableError(result.error):readableValue(result.output)}\n/logs 查看完整日志`);}
+    finally{unsubscribe();done();}
+  }
   async configure(selectedId){
     this.writable();
     const plugins=this.app.listPlugins().filter(p=>p.config);

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

@@ -76,7 +76,20 @@ export class TerminalView{
       input(data);
     },resize);
     this.header=new Text('',1,0);this.transcript=new Text('',1,0);this.prompt=new Container();this.hint=new Text('',1,0);
-    this.hint.render=width=>['',fitLine(' '+palette.muted(this.homeInput?(width<45?`/ 操作 · Ctrl+O ${this.feed.expanded?'收起':'展开'}`:`/ 操作 · Ctrl+O ${this.feed.expanded?'收起':'展开'}详情 · /logs 回看 · Ctrl+C 退出`):(width<45?'↑↓ 选择  Enter 确认  Esc 返回':'↑↓ 选择   Enter 确认   Tab 补全   Esc 返回   Ctrl+C 退出')),width)];
+    this.hint.render=width=>{
+      const lines=[''];
+      if(this.editor&&(this.homeInput||this.multilineInput)){
+        // 按完整按键分组换行，窄屏也能看清主键和备用键。
+        let line='';
+        for(const hint of ['Shift+Enter 换行','Enter 提交','Alt+Enter 备用换行']){
+          const next=line?line+' · '+hint:hint;
+          if(line&&visibleWidth(next)>width-1){lines.push(line);line=hint;}else line=next;
+        }
+        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 退出'));
+      return lines.map(line=>line?fitLine(' '+palette.muted(line),width):'');
+    };
     const renderTranscript=this.transcript.render.bind(this.transcript);
     this.headingLines=(width,mark='FISHtools')=>{
       const room=Math.max(1,width-2),lines=[''];
@@ -127,7 +140,7 @@ export class TerminalView{
   browseCommands(data){
     const direction=matchesKey(data,'up')?-1:matchesKey(data,'down')?1:0;
     // 补全菜单保留方向键；多行编辑保留光标移动，不把配置值放进命令历史。
-    if(!direction||!this.editor||this.editor.isShowingAutocomplete()||this.editor.getText().includes('\n')||!this.commandHistory.length)return false;
+    if(!direction||!this.editor||this.editor.isShowingAutocomplete()||this.editor.getExpandedText().includes('\n')||!this.commandHistory.length)return false;
     const current=this.commandHistoryIndex??this.commandHistory.length;
     const next=Math.max(0,Math.min(this.commandHistory.length,current+direction));
     if(next===current)return true;
@@ -235,19 +248,40 @@ export class TerminalView{
     if(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=>{
-      if(this.homeInput&&text.trim()&&this.commandHistory.at(-1)!==text.trim()){
-        this.commandHistory.push(text.trim());if(this.commandHistory.length>100)this.commandHistory.shift();
+      // 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();
       }
       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.prompt.clear();this.tui.requestRender();}
+    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();}
   }
-  input(message,{value='',commands=[],files=true,workflows=[]}={}){
+  input(message,{value='',commands=[],files=true,workflows=[],multiline=false}={}){
     const editor=new Editor(this.tui,{borderColor:palette.border,selectList:theme},{paddingX:1});
+    const handleInput=editor.handleInput.bind(editor);
+    editor.handleInput=data=>{
+      // ProcessTerminal 已把分段粘贴合并为完整事件；公开插入接口保留脚本制表符和换行。
+      if(data.startsWith('\x1b[200~')&&data.endsWith('\x1b[201~')){
+        const text=safe(data.slice(6,-6).replace(/\r\n?/g,'\n'));
+        if(this.homeInput||multiline||text.includes('\n')){editor.insertTextAtCursor(text);return;}
+      }
+      if(matchesKey(data,'shift+enter')||matchesKey(data,'alt+enter')||data==='\x1b[13;2~'){
+        editor.insertTextAtCursor('\n');return;
+      }
+      // 反斜杠属于命令原文，不能触发上游的“反斜杠后 Enter 换行”兼容键位。
+      if(data==='\\'){editor.insertTextAtCursor(data);return;}
+      if(matchesKey(data,'enter')&&!editor.isShowingAutocomplete()){
+        if(!editor.disableSubmit){const text=editor.getExpandedText();editor.setText('');editor.onSubmit?.(text);}
+        return;
+      }
+      handleInput(data);
+    };
     const renderEditor=editor.render.bind(editor);
     editor.render=width=>{
-      if(width<8)return renderEditor(width);
-      const inner=width-4,lines=renderEditor(inner);let closed=false;
+      // 上游 visibleWidth 按三个空格计算 Tab；只扩展显示，提交仍保留原始 Tab。
+      if(width<8)return renderEditor(width).map(line=>line.replaceAll('\t','   '));
+      const inner=width-4,lines=renderEditor(inner).map(line=>line.replaceAll('\t','   '));let closed=false;
       return lines.map((line,i)=>{
         if(i===0)return ' '+palette.border('╭'+'─'.repeat(inner)+'╮');
         if(!closed&&/^─+$/.test(safe(line))){closed=true;return ' '+palette.border('╰'+'─'.repeat(inner)+'╯');}
@@ -256,6 +290,7 @@ export class TerminalView{
       });
     };
     this.homeInput=message.startsWith('fst >');
+    this.multilineInput=multiline;
     this.commandHistoryIndex=null;
     if(this.homeInput)editor.onChange=text=>{
       if(this.commandHistoryIndex!==null&&text!==this.commandHistory[this.commandHistoryIndex])this.commandHistoryIndex=null;

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

@@ -4,7 +4,6 @@ export async function workflowMenu(session){
     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} 步`})),
-      ...(!app.project.readOnly?workflows.map(flow=>({value:`duplicate:${flow.id}`,label:`复制 ${flow.title??flow.id} 为新工作流`,description:`从已保存版本 ${flow.id} 创建副本` })):[]),
       ...(!app.project.readOnly?[{value:'new',label:'＋ 新建工作流'}]:[]),
       ...(session.dirty?[{value:'draft',label:`继续编辑草稿：${session.flow.title}`}]:[]),
       {value:'back',label:'返回主面板'},
@@ -12,11 +11,7 @@ export async function workflowMenu(session){
     if(choice==='back')return;
     try{
       const id=choice.startsWith('workflow:')?choice.slice(9):null;
-      if(choice.startsWith('duplicate:')){
-        if(!await session.discard())continue;
-        await duplicateIntoSession(session,workflows.find(flow=>flow.id===choice.slice(10)));
-      }
-      else if(choice==='new'){if(await session.execute('/new')===false)continue;}
+      if(choice==='new'){if(await session.execute('/new')===false)continue;}
       else if(choice!=='draft'&&session.flow?.id!==id){
         if(!await session.discard())continue;
         session.flow=structuredClone(workflows.find(flow=>flow.id===id));session.dirty=false;

package/node_modules/@mytools/fst-devtools/src/documentation.js

@@ -3,6 +3,7 @@ import {fileURLToPath} from 'node:url';
 import {access,readFile,readdir,lstat,mkdir,copyFile,realpath} from 'node:fs/promises';
 
 const topics=[
+  ['commands','系统命令与快捷名称','docs/terminal-commands.md'],
   ['plugins','插件开发规范','docs/plugin-development.md'],
   ['deployment','安装与部署','docs/deployment.md'],
   ['control','控制流与运行观察规范','docs/superpowers/specs/2026-10-11-control-observation.md'],
@@ -14,7 +15,7 @@ const topics=[
   ['readme','Fishtools 使用说明','README.md'],
 ];
 // 保留文档链接所需的目录布局；参考代码仅供阅读，不是第二份运行时。
-const assets=['README.md','LICENSE','THIRD_PARTY_NOTICES.md','docs','examples/service-plugins','plugins/examples','plugins/environment','plugins/web/README.md','packages/sdk','packages/core','packages/pack','packages/fst-logs','packages/fst-platform','packages/fst-workflow','packages/fst-plugin','packages/fst-workspace','packages/fst-devtools','packages/fst-cli','tests/application.test.js'];
+const assets=['README.md','LICENSE','THIRD_PARTY_NOTICES.md','docs','examples/service-plugins','plugins/examples','plugins/environment','plugins/commands','plugins/web/README.md','packages/sdk','packages/core','packages/pack','packages/fst-logs','packages/fst-platform','packages/fst-workflow','packages/fst-plugin','packages/fst-workspace','packages/fst-devtools','packages/fst-cli','tests/application.test.js'];
 const excluded=new Set(['node_modules','dist','.git','.cache','__pycache__','.pytest_cache','coverage','public']);
 const inside=(parent,child)=>{const relative=path.relative(parent,child);return relative===''||(!relative.startsWith(`..${path.sep}`)&&relative!=='..'&&!path.isAbsolute(relative));};
 

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

@@ -13,6 +13,8 @@
 | --- | --- |
 | `@mytools/fst-logs` | `./src/run-logs.js` |
 | `@mytools/fst-logs/markdown` | `./src/markdown-log.js` |
+| `@mytools/fst-logs/steps` | `./src/step-summaries.js` |
+| `@mytools/fst-logs/preview` | `./src/run-preview.js` |
 | `@mytools/fst-logs/package.json` | `./package.json` |
 
 仅依赖 exports 声明的入口，禁止消费者跨包读取 src/bin 私有文件。入口路径由本模块维护，修改协议时同步消费方回归。
@@ -35,6 +37,15 @@
 
 快照与历史元数据另有 `stepSummaries`、`stepSummaryBytes`、`stepsTruncated`。步骤摘要按 callPath（缺少时按 stepId）保留最新状态，仅包含类型、定位、动作、时间、序号、耗时及有界原因/错误，不缓存 input/output。步骤摘要使用独立的 maxEvents/maxMemoryBytes 预算，因此两份缓存合计最多为两倍 maxMemoryBytes；单条步骤摘要仍受 maxEventBytes 限制。普通日志淘汰不影响步骤状态；步骤本身超预算淘汰时 stepsTruncated 为 true，展示端应把无法确认的步骤显示为未知状态。
 
+`createStepSummaries(policy)` 从 `/steps` 入口提供同一套摘要缓存，日志写入器与 TUI 共用。
+`append(event)` 更新状态并刷新淘汰顺序；`get(callPath)`、`values()` 和 `snapshot()` 返回副本。
+`snapshot()` 包含上述三个步骤摘要字段，`size` 为保留条数。
+
+`previewRun(record,{maxValueBytes=65536})` 从 `/preview` 入口提供展示与历史元数据共用的结果投影。
+input/output、error、reason 等字段转为有界 JSON 预览，过大时标记 `<字段>Truncated:true`；业务数据对象不变。
+定位字段与 events/stepSummaries 保留，后两者由各自缓存预算负责；展示端应裁去不使用的缓存副本。
+maxValueBytes 至少为 2，连预览本身也容不下时省略字段值并保留截断标记。
+
 队列预算在追加时检查。未等待 append 的插件同样受到预算约束；超限返回 `LOG_QUEUE_LIMIT` 拒绝，并使 finish 失败。拒绝已安装内部处理，调用方仍可 await 观察失败，不会产生未处理拒绝。`LOG_DISK_LIMIT` 表示可选磁盘预算不足，拒绝完整追加而不静默截断。磁盘预算与队列预算都计算 JSONL 和 Markdown。建议插件等待 append，以便磁盘写入形成背压。
 
 `read`/`list` 仅读取受限的 result.json 元数据，运行中的 read 回退到归属元数据；不加载 JSONL 或 Markdown 正文。巨大旧 result.json 超过读取预算时，read 明确返回 `LOG_METADATA_LIMIT`，list 跳过该记录。旧版本缺少归属信息时仅在 `allowLegacy:true` 下可读。

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

@@ -6,6 +6,8 @@
   "main": "src/run-logs.js",
   "exports": {
     ".": "./src/run-logs.js",
+    "./steps": "./src/step-summaries.js",
+    "./preview": "./src/run-preview.js",
     "./markdown": "./src/markdown-log.js",
     "./package.json": "./package.json"
   },