@yanglaofish/fishtools 0.5.1 → 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/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-platform/README.md

@@ -18,6 +18,7 @@
 | `@mytools/fst-platform/npm` | `./src/npm.js` |
 | `@mytools/fst-platform/network` | `./src/network.js` |
 | `@mytools/fst-platform/fs` | `./src/file-probe.js` |
+| `@mytools/fst-platform/shell` | `./src/shell.js` |
 | `@mytools/fst-platform/package.json` | `./package.json` |
 
 仅依赖 exports 声明的入口，禁止消费者跨包读取 src/bin 私有文件。入口路径由本模块维护，修改协议时同步消费方回归。
@@ -32,11 +33,21 @@
 node --test tests/modules.test.js tests/process.test.js tests/environments.test.js
 ```
 
+进程停止专项：`node --test tests/process.test.js tests/process-stream.test.js tests/process-tree-stop.test.js`。
+
 ## 子进程环境
 
+`/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` 保留构造简短命令参数的兼容接口。
+
 `runProcess(file,args,{env,extendEnv=true})` 默认把 `env` 覆盖到宿主环境上。
 当调用方已按动作代理规则构造完整环境时，传 `extendEnv:false`，防止已移除的代理变量被重新继承。
 
+缓冲模式由平台按每条输出流的原始字节计算 `maxBuffer`，默认每条流 4 MiB；超限返回 `OUTPUT_LIMIT`。
+`maxBuffer` 必须为非负数，`0` 仅允许空输出，`Infinity` 表示调用方显式取消缓冲上限；对象、`NaN` 和负数会在启动前被拒绝。
+流式模式通过 `onOutput` 消费输出，仅保留 `summaryBytes` 指定的尾部摘要。
+超限、取消、超时或输出回调失败时，平台终止整棵进程树，等待回收结束后返回错误。
+停止过程中继续排空并丢弃管道输出，避免提前关闭管道使父进程因 `EPIPE` 退出，导致 Windows `taskkill /T` 无法找到后代进程。
+
 ## 隔离文件探测
 
 `createFileProbe({timeout=2000,maxConcurrent=2,maxPending=16,allowRemote=false})` 创建只读探测器。

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

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

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

@@ -4,11 +4,11 @@ import which from 'which';
 import { FlowError } from '@mytools/sdk';
 import path from 'node:path';
 
-const outputText=bytes=>bytes??new Uint8Array();
 const stripFinalNewline=text=>text.endsWith('\r\n')?text.slice(0,-2):text.endsWith('\n')?text.slice(0,-1):text;
 
 export async function runProcess(file,args=[],{cwd,env,extendEnv=true,signal,timeout=30000,maxBuffer=4*1024*1024,encoding='utf8',onOutput,outputMode='buffer',summaryBytes=65536}={}) {
   if(!['buffer','stream'].includes(outputMode))throw new TypeError('outputMode 必须为 buffer 或 stream');
+  if(typeof maxBuffer!=='number'||Number.isNaN(maxBuffer)||maxBuffer<0)throw new TypeError('maxBuffer 必须为非负数，可用 Infinity 表示不限制缓冲');
   const streaming=outputMode==='stream';
   if(streaming&&typeof onOutput!=='function')throw new TypeError('stream 模式必须提供 onOutput 消费输出');
   if(!Number.isSafeInteger(summaryBytes)||summaryBytes<0||summaryBytes>1024*1024)throw new TypeError('summaryBytes 必须为 0 到 1048576 的整数');
@@ -33,11 +33,12 @@ export async function runProcess(file,args=[],{cwd,env,extendEnv=true,signal,tim
     if(!executable)throw Object.assign(new Error(`not found: ${file}`),{code:'ENOENT'});
   }
   catch(cause){throw new FlowError(`未找到程序：${file}`,{code:'ENOENT',details:{executable:file},cause});}
-  // Execa 收集原始字节；文本只在这里按同一编码解码，避免返回值被默认 UTF-8 解码。
-  const child=execa(executable,args,{cwd,env,extendEnv,reject:false,windowsHide:true,maxBuffer,buffer:!streaming,timeout:0,shell:false,encoding:'buffer',stripFinalNewline:false});
+  // 平台统一收集原始字节和执行上限；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 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:''};let outputTruncated=false;
+  const outputBytes={stdout:0,stderr:0},tails={stdout:'',stderr:''},buffers={stdout:[],stderr:[]};let outputTruncated=false;
   const remember=(name,message)=>{
     const bytes=Buffer.from(tails[name]+message);let start=Math.max(0,bytes.length-summaryBytes);
     if(start){outputTruncated=true;while(start<bytes.length&&(bytes[start]&0xc0)===0x80)start++;}
@@ -67,7 +68,8 @@ export async function runProcess(file,args=[],{cwd,env,extendEnv=true,signal,tim
         const decoder=new TextDecoder(decoderEncoding);
         try{
           for await(const chunk of stream){
-            if(reason)break;outputBytes[name]+=chunk.byteLength;
+            // 停止后继续排空并丢弃输出，避免迭代器 break 提前关闭管道触发 EPIPE。
+            if(reason)continue;outputBytes[name]+=chunk.byteLength;
             const message=decoder.decode(chunk,{stream:true});remember(name,message);
             await Promise.race([emit(name,message),stopped]);
           }
@@ -81,9 +83,11 @@ export async function runProcess(file,args=[],{cwd,env,extendEnv=true,signal,tim
     const finish=()=>{if(!ended){ended=true;emit(name,decoder.decode());}};
     flush.push(finish);stream?.once('end',finish);
     stream?.on('data',chunk=>{
+      if(reason)return;
       bytes+=Buffer.byteLength(chunk);
       // 流量超限时立即回收整棵进程树，不继续扩张待落盘的日志队列。
       if(bytes>maxBuffer){stop('output-limit');return;}
+      buffers[name].push(chunk);
       if(onOutput)emit(name,decoder.decode(chunk,{stream:true}));
     });
   }
@@ -104,7 +108,7 @@ export async function runProcess(file,args=[],{cwd,env,extendEnv=true,signal,tim
   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'});
-  const decode=bytes=>stripFinalNewline(new TextDecoder(decoderEncoding).decode(outputText(bytes)));
+  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(result.stdout),stderr:decode(result.stderr)};
+  return {exitCode:result.exitCode,stdout:decode(buffers.stdout),stderr:decode(buffers.stderr)};
 }

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

@@ -0,0 +1,58 @@
+import {FlowError} from '@mytools/sdk';
+import {randomUUID} from 'node:crypto';
+import {mkdir,open,rm} from 'node:fs/promises';
+import {tmpdir} from 'node:os';
+import path from 'node:path';
+import {runProcess as executeProcess} from './process.js';
+
+const shells=new Set(['auto','powershell','pwsh','sh','bash']);
+const powerShellArgs=['-NoLogo','-NoProfile','-NonInteractive','-OutputFormat','Text'];
+
+function selectShell(script,shell,platform){
+  if(typeof script!=='string'||!script.trim()||script.includes('\u0000'))throw new FlowError('命令文本必须是非空字符串，且不能包含 NUL 字符',{code:'VALIDATION'});
+  if(!shells.has(shell))throw new FlowError(`不支持的 Shell：${String(shell)}`,{code:'VALIDATION'});
+  return shell==='auto'?(platform==='win32'?'powershell':'sh'):shell;
+}
+
+function powerShellSource(script){
+  // $? 在脚本最后一条命令后立即读取，避免沿用更早的外部命令退出码。
+  return `[Console]::OutputEncoding = New-Object System.Text.UTF8Encoding($false)
+$OutputEncoding = [Console]::OutputEncoding
+& {
+${script}
+if (-not $?) {
+  if ($LASTEXITCODE) { exit $LASTEXITCODE }
+  exit 1
+}
+exit 0
+}`;
+}
+
+export function shellInvocation(script,{shell='auto',platform=process.platform}={}){
+  const file=selectShell(script,shell,platform);
+  if(file==='sh'||file==='bash')return {file,args:['-c',script]};
+  // 编码只改变传输形式；保留用户的引号、管道、换行及尾部注释。
+  const source=powerShellSource(script);
+  const encoded=Buffer.from(source,'utf16le').toString('base64');
+  // 普通 -Command 避免 Windows PowerShell 在 -EncodedCommand 下把 stderr 序列化为 CLIXML。
+  const command=`& ([ScriptBlock]::Create([Text.Encoding]::Unicode.GetString([Convert]::FromBase64String('${encoded}'))))`;
+  return {file,args:[...powerShellArgs,'-Command',command]};
+}
+
+export async function runShell(script,{shell='auto',runProcess:execute=executeProcess,temporaryDir=tmpdir(),...processOptions}={}){
+  const file=selectShell(script,shell,process.platform),powershell=file==='powershell'||file==='pwsh';
+  if(processOptions.signal?.aborted)throw new FlowError('操作已取消',{code:'CANCELLED'});
+  const directory=path.resolve(temporaryDir);
+  await mkdir(directory,{recursive:true});
+  const scriptFile=path.join(directory,`fst-shell-${randomUUID()}.${powershell?'ps1':'sh'}`);
+  // 独占创建后才承担清理责任；不覆盖已有文件，也不清空调用者的输出目录。
+  const handle=await open(scriptFile,'wx',0o600);
+  try{
+    try{
+      // Windows PowerShell 5.1 读取 UTF-8 文件需要 BOM；POSIX Shell 使用无 BOM 原文。
+      await handle.writeFile(powershell?'\uFEFF'+powerShellSource(script):script,'utf8');
+    }finally{await handle.close();}
+    const args=powershell?[...powerShellArgs,'-ExecutionPolicy','Bypass','-File',scriptFile]:[scriptFile];
+    return await execute(file,args,processOptions);
+  }finally{await rm(scriptFile,{force:true});}
+}

package/node_modules/@mytools/fst-plugin/src/contracts.js

@@ -7,7 +7,7 @@ import path from 'node:path';
 export const builtinCommands=[
   ['workflows','选择已有工作流'],['new','新建工作流'],['add','添加插件能力或子工作流'],
   ['steps','设置步骤参数、排序或删除'],['outputs','设置最终输出'],['save','保存工作流'],
-  ['run','运行工作流，可附带 @参数.json'],['runs','运行记录：选择任意一次执行，查看进度、结果和日志'],['logs','查看运行日志'],['plugin','管理插件'],['plugins','管理插件（兼容旧入口）'],['config','配置 Fishtools'],['tools','Web 与离线文档'],
+  ['run','运行工作流，可附带 @参数.json'],['runs','运行记录：选择任意一次执行，查看进度、结果和日志'],['logs','查看运行日志'],['plugin','管理插件'],['plugins','管理插件（兼容旧入口）'],['commands','管理常用命令'],['shortcuts','管理自定义快捷名称'],['config','配置 Fishtools'],['tools','Web 与离线文档'],
   ['pack','选择工作流打包'],['web','启动 Web 工作台'],['docs','阅读离线开发与使用文档'],['help','查看操作说明'],['exit','退出终端工作台'],
 ].map(([name,description])=>({name,description}));
 
@@ -76,9 +76,13 @@ export function validateDeclarations(plugin){
   }
 }
 
+export function isCommandName(name){
+  return typeof name==='string'&&name===name.normalize('NFC')&&/^\p{L}[\p{L}\p{N}_.-]*$/u.test(name);
+}
+
 export function validateCommands(plugin,registered){
   for(const [name,c] of Object.entries(plugin.commands??{})){
-    if(!/^[a-zA-Z][\w.-]*$/.test(name)||builtinCommands.some(x=>x.name===name)||registered.has(name))throw new FlowError(`命令名称无效或冲突：/${name}`);
+    if(!isCommandName(name)||builtinCommands.some(x=>x.name===name)||registered.has(name))throw new FlowError(`命令名称无效或冲突：/${name}`);
     if(!c||Boolean(c.action)===Boolean(c.run)||c.run&&typeof c.run!=='function')throw new FlowError(`命令 /${name} 必须声明 action 或 run`);
     if(c.action&&!plugin.actions?.[c.action])throw new FlowError(`命令 /${name} 指向不存在的动作：${c.action}`);
     registered.add(name);