@yanglaofish/fishtools 0.4.0 → 0.5.0

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

@@ -0,0 +1,60 @@
+// 阅读层只处理展示；原始事件、输入输出与错误仍保留在运行记录中。
+export function readableValue(value,indent=''){
+  if(value===undefined)return '暂无记录';
+  if(value===null)return 'null';
+  if(typeof value!=='object')return String(value);
+  const entries=Array.isArray(value)?value.map((v,i)=>[`[${i+1}]`,v]):Object.entries(value);
+  if(!entries.length)return Array.isArray(value)?'（空列表）':'（空对象）';
+  return entries.map(([key,item])=>{
+    const nested=item!==null&&typeof item==='object';
+    return `${indent}${key}：${nested?'\n'+readableValue(item,indent+'  '):String(item).replaceAll('\n','\n'+indent+'  ')}`;
+  }).join('\n');
+}
+export function readableError(error,{details=false}={}){
+  if(!error)return '';
+  const chain=[];for(let current=error;current;current=current.cause)chain.push(current);
+  const program=chain.find(e=>e.details?.executable)?.details.executable;
+  const code=chain.find(e=>e.code==='ENOENT')?.code??error.code;
+  const summary=[`原因：${code==='ENOENT'&&program?'未找到所需程序':error.message??'未知错误'}`,error.plugin&&`插件：${error.plugin}`,code&&`错误码：${code}`,program&&`程序：${program}`,code==='ENOENT'&&'请检查程序是否安装、路径是否正确以及 PATH 配置。'].filter(Boolean).join('\n');
+  if(!details)return summary;
+  const diagnostic=chain.flatMap((item,index)=>[
+    `${index===0?'错误':'上游原因 '+index}：${item.message??'未知错误'}`,
+    item.code&&`错误码：${item.code}`,
+    item.details!==undefined&&`细节：\n${readableValue(item.details)}`,
+    item.stack&&`调用栈：\n${item.stack}`,
+  ].filter(Boolean));
+  return `${summary}\n\n${diagnostic.join('\n')}`;
+}
+const eventNames={'step.started':'步骤开始','step.succeeded':'步骤成功','step.failed':'步骤失败','step.cancelled':'步骤取消','step.skipped':'步骤跳过','step.stopped':'步骤停止','run.started':'运行开始','run.succeeded':'运行成功','run.failed':'运行失败','run.cancelled':'运行取消','run.stopped':'提前结束'};
+const time=value=>{const date=new Date(value);return Number.isFinite(+date)?date.toLocaleTimeString('zh-CN',{hour12:false}):'--:--:--';};
+export function readableTimeline(events,{callPath,values=false}={}){
+  const rows=[];let pending;
+  const push=(event,message)=>{
+    const prefix=`${time(event.time)}  [${event.callPath??'运行'}${event.stream?' · '+event.stream:''}]`;
+    const lines=String(message).replaceAll('\r\n','\n').replaceAll('\r','\n').split('\n');
+    if(lines.at(-1)==='')lines.pop();
+    for(const line of lines)rows.push(`${prefix}  ${line}`);
+  };
+  const flush=()=>{if(pending){if(pending.text)push(pending.event,pending.text);pending=null;}};
+  for(const event of events??[]){
+    if(callPath&&event.callPath!==callPath)continue;
+    if(event.type==='log'&&event.stream){
+      const key=`${event.callPath}\0${event.stream}`;
+      if(pending?.key!==key){flush();pending={key,event,text:''};}
+      pending.text+=event.message??'';
+      const end=pending.text.lastIndexOf('\n');
+      if(end>=0){push(pending.event,pending.text.slice(0,end+1));pending.text=pending.text.slice(end+1);pending.event=event;}
+      continue;
+    }
+    if(event.type==='log'){flush();push(event,`${event.message??''}${event.data!==undefined?'\n'+readableValue(event.data):''}`);continue;}
+    if(eventNames[event.type]){
+      const detail=event.error?readableError(event.error,{details:values}):event.reason??event.message;
+      flush();push(event,`${eventNames[event.type]}${event.action?' · '+event.action:''}${event.durationMs!==undefined?` · ${event.durationMs} ms`:''}${detail?'\n'+detail:''}`);
+      if(values&&event.type.startsWith('step.')){
+        if(event.input!==undefined&&Object.keys(event.input??{}).length)push(event,'输入\n'+readableValue(event.input));
+        if(event.output!==undefined)push(event,'输出\n'+readableValue(event.output));
+      }
+    }
+  }
+  flush();return rows.join('\n')||'等待执行记录。插件通过 log 或 runProcess 输出的内容会显示在这里。';
+}

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

@@ -0,0 +1,106 @@
+import { stripVTControlCharacters } from 'node:util';
+import { Text, matchesKey, truncateToWidth } from '@mariozechner/pi-tui';
+import {palette} from './theme.js';
+import {readableValue,readableError,readableTimeline} from './run-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';
+
+export class RunViewer{
+  constructor({record,flow,workflows=[],catalog=[],terminal,onClose,onCancel,onReadLogs,requestRender}){
+    Object.assign(this,{terminal,onClose,onCancel,onReadLogs,requestRender,catalog});this.view=0;this.selected=0;this.offset=0;this.follow=true;this.allLogs=true;this.raw=false;this.confirmCancel=false;
+    this.planned=[];
+    const walk=(steps,prefix,ancestors)=>{
+      for(const step of steps??[]){
+        const callPath=`${prefix}/${step.id}`;this.planned.push({callPath,stepId:step.id,action:step.action,title:step.title,status:'pending'});
+        if(step.branch){walk(step.branch.then,callPath,ancestors);walk(step.branch.else,callPath,ancestors);}
+        if(step.parallel)walk(step.parallel.steps,callPath,ancestors);
+        if(step.workflow){const child=workflows.find(w=>`${w.id}.yaml`===step.workflow.replace(/^\.\//,''));if(child&&!ancestors.has(child.id))walk(child.steps,callPath,new Set([...ancestors,child.id]));}
+      }
+    };
+    if(flow)walk(flow.steps,flow.id,new Set([flow.id]));
+    this.update(record);
+  }
+  invalidate(){}
+  update(record){
+    if(!record)return;
+    this.record=record;const nodes=new Map(this.planned.map(node=>[node.callPath,{...node,...(record.stepsTruncated&&record.status!=='running'?{status:'unknown'}:{})}]));
+    for(const event of [...(record.events??[]),...(record.stepSummaries??[])].sort((a,b)=>(a.seq??0)-(b.seq??0))){
+      if(!event.type.startsWith('step.')||!event.callPath)continue;
+      const node=nodes.get(event.callPath)??{callPath:event.callPath,stepId:event.stepId};
+      Object.assign(node,event,{status:event.type==='step.started'?'running':event.type.slice(5)});
+      node.title??=this.catalog.find(action=>action.id===node.action)?.title;nodes.set(event.callPath,node);
+    }
+    this.nodes=[...nodes.values()];this.selected=Math.max(0,Math.min(this.selected,this.nodes.length-1));
+    this.requestRender();
+  }
+  content(){
+    const node=this.nodes[this.selected],status=runStatuses[this.record.status]??this.record.status;
+    if(this.view===0)return [
+      `运行：${status}${this.record.reason?` · ${this.record.reason}`:''}`,
+      this.record.error?readableError(this.record.error):'',
+      ...(this.record.warnings??[]).map(warning=>`警告：${warning.message}`),
+      this.record.output!==undefined?'\n最终输出\n'+readableValue(this.record.output):'',
+      '\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:''}`),
+      !this.nodes.length?'此运行没有工作流步骤，可在日志页查看插件输出。':'',
+    ].filter(Boolean).join('\n');
+    if(this.view===1){
+      const format=value=>this.raw?JSON.stringify(value??null,null,2):readableValue(value);
+      const error=node?node.error:this.record.error;
+      return [`步骤：${node?.callPath??'整个运行'}`,node?.action?'能力：'+node.action:'',error?'\n错误\n'+(this.raw?format(error):readableError(error)):'',
+        node?'\n输入\n'+format(node.input):'', '\n输出\n'+format(node?node.output:this.record.output),
+        !error&&(node?.reason||node?.message)?'\n说明：'+(node.reason??node.message):'',this.raw?'\n原始 JSON · 包含完整错误详情与调用栈':'\nj 查看原始 JSON 与完整诊断',
+      ].filter(Boolean).join('\n');
+    }
+    return (this.record.eventsTruncated?'当前为近期日志摘要，按 p 分页查看完整落盘日志。\n\n':'')+readableTimeline(this.record.events,{callPath:this.allLogs?undefined:node?.callPath});
+  }
+  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 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};
+  }
+  render(width){
+    const {height,pageSize,lines}=this.layout(width),node=this.nodes[this.selected];
+    const body=lines.slice(this.offset,this.offset+pageSize);while(body.length<pageSize)body.push('');
+    const tabs=`${['1 总览','2 输入输出','3 日志'].map((s,i)=>this.view===i?palette.brand(`[${s}]`):palette.muted(s)).join('  ')} ${palette.muted('·')} ${palette.text(safe(runStatuses[this.record.status]??this.record.status))} ${palette.muted('· '+safe(this.record.workflowId??'运行'))}`;
+    const selection=`[ / ] 切换步骤：${node?.callPath??'暂无步骤'}${this.view===2?` · ${this.allLogs?'全部日志':'本步骤日志'} · ${this.follow?'跟随尾部':'暂停跟随'}`:''}`;
+    const footer=this.confirmCancel?'取消整个运行？y 确认 · 任意其他键返回':'q/Esc 返回 · x 取消 · p 完整日志 · 1/2/3 切换';
+    const shortcuts=width<60?'↑↓/滚轮 · [ ] 步骤 · j 原始数据':`↑↓/滚轮 翻页 · [ ] 步骤 · j 原始数据 · a 全部/本步骤 · End 跟随 · ${this.offset+1}–${Math.min(this.offset+pageSize,lines.length)}/${lines.length}`;
+    const styledBody=body.map(line=>line.startsWith('›')?palette.brand(line):line);
+    const styledFooter=palette.muted(safe(footer));
+    const screen=height===1?styledBody:height===2?[styledBody[0],styledFooter]:height===3?[tabs,styledBody[0],styledFooter]:height===4?[tabs,styledBody[0],styledFooter,palette.muted(shortcuts)]:[tabs,palette.muted(safe(selection)),...styledBody,styledFooter,palette.muted(shortcuts)];
+    return screen.map(line=>truncateToWidth(line,width));
+  }
+  handleInput(data){
+    if(data==='p'&&this.onReadLogs){this.onReadLogs();return;}
+    if(this.confirmCancel){this.confirmCancel=false;if(data==='y')this.onCancel();this.requestRender();return;}
+    if(['escape','q'].some(key=>matchesKey(data,key))){this.onClose();return;}
+    if(matchesKey(data,'enter')){if(this.view===0){this.view=1;this.offset=0;this.requestRender();}return;}
+    if(data==='j'){this.raw=!this.raw;this.view=1;this.offset=0;this.requestRender();return;}
+    if(data==='x'&&this.record.status==='running'){this.confirmCancel=true;this.requestRender();return;}
+    if(['1','2','3'].includes(data)){this.view=Number(data)-1;this.offset=0;this.follow=true;this.requestRender();return;}
+    if(data==='['||data===']'){
+      this.selected=Math.max(0,Math.min(this.nodes.length-1,this.selected+(data===']'?1:-1)));this.offset=0;
+      if(this.view===0){const {lines,pageSize,maxOffset}=this.layout(this.terminal.columns);const row=lines.findIndex(line=>line.startsWith('›'));this.offset=Math.min(maxOffset,Math.max(0,row-Math.floor(pageSize/2)));}
+      this.requestRender();return;
+    }
+    if(data==='a'){this.allLogs=!this.allLogs;this.offset=0;this.requestRender();return;}
+    if(data==='f'){this.follow=!this.follow;this.requestRender();return;}
+    const {pageSize,maxOffset}=this.layout(this.terminal.columns),wheel=mouseWheel(data);
+    if(wheel)this.offset+=wheel*3;
+    else if(matchesKey(data,'up'))this.offset--;
+    else if(matchesKey(data,'down'))this.offset++;
+    else if(matchesKey(data,'pageUp'))this.offset-=pageSize;
+    else if(matchesKey(data,'pageDown'))this.offset+=pageSize;
+    else if(matchesKey(data,'home'))this.offset=0;
+    else if(matchesKey(data,'end')){this.offset=maxOffset;this.follow=true;this.requestRender();return;}
+    else return;
+    this.follow=false;this.offset=Math.max(0,Math.min(maxOffset,this.offset));this.requestRender();
+  }
+}

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

@@ -0,0 +1,52 @@
+import { validate } from '@mytools/sdk/schema';
+import { fileReference } from './model.js';
+
+export const needsJsonEditor=schema=>['oneOf','anyOf','allOf','if','$ref','patternProperties'].some(key=>schema?.[key]!==undefined);
+
+// 值只在整个编辑过程完成后返回，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)})));
+    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==='object'&&schema.properties&&!needsJsonEditor(schema)){
+    const result=structuredClone(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])??'未填写'})),
+        {value:'__done',label:'完成填写'},
+      ]);
+      if(key==='__done'){
+        try{return validate(schema,result,label);}catch(e){ui.show(e.message);continue;}
+      }
+      const field=key.slice(6);
+      const next=await editValue(ui,schema.properties[field],result[field],{baseDir,required:schema.required?.includes(field),label:schema.properties[field].title??field});
+      if(next===undefined)delete result[field];else result[field]=next;
+    }
+  }
+  if(schema.type==='array'&&schema.items&&!Array.isArray(schema.items)&&!needsJsonEditor(schema)){
+    const result=structuredClone(value??[]);
+    while(true){
+      const choice=await ui.select(label,[...result.map((v,i)=>({value:String(i),label:`${i+1}. ${JSON.stringify(v)}`})),{value:'add',label:'添加一项'},{value:'done',label:'完成列表'}]);
+      if(choice==='done'){try{return validate(schema,result,label);}catch(e){ui.show(e.message);continue;}}
+      if(choice==='add'){const item=await editValue(ui,schema.items,undefined,{baseDir,required:true,label:'新项'});result.push(item);}
+      else{
+        const index=Number(choice),action=await ui.select('修改列表项',[{value:'edit',label:'编辑'},{value:'remove',label:'移除'}]);
+        if(action==='remove')result.splice(index,1);else result[index]=await editValue(ui,schema.items,result[index],{baseDir,required:true,label:`第 ${index+1} 项`});
+      }
+    }
+  }
+  while(true){
+    const string=schema.type==='string';
+    const initial=value===undefined?'':string?String(value):JSON.stringify(value);
+    const raw=await ui.input(`${label}${required?'（必填）':''}${string?' · @文件引用路径，@@表示字面量@':' · 输入 JSON 值'}${schema.description?'\n'+schema.description:''}`,{value:string&&initial.startsWith('@')?'@'+initial:initial,files:string});
+    try{
+      if(!raw&&!required&&schema.type!=='string')return undefined;
+      if(!raw&&required&&schema.type!=='string')throw new Error('请填写必填值');
+      const result=string?fileReference(raw,baseDir):JSON.parse(raw);
+      return validate(schema,result,label);
+    }catch(e){ui.show(`输入无效：${e.message}`);}
+  }
+}

package/node_modules/@mytools/{core → fst-cli}/src/terminal/session.js

@@ -9,10 +9,20 @@ 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 {resolvePrivilegeRequirement,checkStaticPrivilege} from '@mytools/fst-plugin/privileges';
 
 export class TerminalSession{
   constructor(app,ui,{baseDir=process.cwd(),webOptions={}}={}){this.app=app;this.ui=ui;this.baseDir=baseDir;this.webOptions=webOptions;this.flow=null;this.dirty=false;this.exiting=false;this.web=null;ui.activeRuns=()=>app.listRuns().filter(run=>run.status==='running').length;}
   writable(){if(this.app.project.readOnly)throw new Error('这是只读运行包，请在完整工作区中编排、安装或打包');}
+  async withMaintenance(operation,options={}){
+    try{return await operation(options);}
+    catch(error){
+      if(error.code!=='MAINTENANCE_REQUIRED')throw error;
+      const names=error.details?.plugins?.join('、')??'相关插件';
+      if(!await this.ui.confirm(`本次修改会短暂停止并重启 ${names}。现在继续吗？`))return null;
+      return operation({...options,allowMaintenance:true});
+    }
+  }
   current(){if(!this.flow)throw new Error('先用 /workflows 打开或新建工作流');return this.flow;}
   commands(){return commandMenu(this.app.listPlugins?.()??[],this.app.listCommands());}
   async discard(){return !this.dirty||await this.ui.confirm('当前修改未保存，是否放弃修改？');}
@@ -71,7 +81,7 @@ export class TerminalSession{
         '## 全部操作',this.commands().map(c=>`- /${c.name}：${c.description}`).join('\n'),
       ].join('\n\n'));return;
       case 'docs':{
-        const {listDocumentation,readDocumentation}=await import('../documentation.js');
+        const {listDocumentation,readDocumentation}=await import('@mytools/fst-devtools/documentation');
         const topics=await listDocumentation();
         const topic=await this.ui.select('离线文档', [...topics.map(item=>({value:item.id,label:item.title})),{value:'back',label:'返回工作台'}]);
         if(topic!=='back'){const document=await readDocumentation(topic);await this.ui.viewMarkdown(document.title,document.text);}
@@ -110,7 +120,12 @@ export class TerminalSession{
     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}):{};
     const ui=Object.fromEntries(['input','select','show','confirm'].map(name=>[name,this.ui[name].bind(this.ui)]));
-    const run=await this.app.startCommand(command.name,input,{ui});
+    const definition=this.app.host.definitions.get(command.plugin);
+    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});
     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;}
@@ -127,19 +142,22 @@ export class TerminalSession{
     const id=selectedId??await this.ui.select('选择要配置的插件',plugins.map(p=>({value:p.id,label:p.title??p.id})));
     const plugin=plugins.find(p=>p.id===id);
     const value=await editValue(this.ui,plugin.config,this.app.project.config?.[id]??{}, {baseDir:this.baseDir,required:true,label:plugin.title??id});
-    await this.app.configurePlugin(id,value);this.ui.show('插件配置已保存到当前工作区。');
+    const result=await this.withMaintenance(options=>this.app.configurePlugin(id,value,options));
+    this.ui.show(result===null?'已取消修改。':`插件配置已保存到当前工作区。原项目配置备份：${result.backup}`);
   }
   async logs(){
     const statuses=runStatuses;
     while(true){
       const history=(await this.app.listRunHistory()).sort((a,b)=>(b.status==='running')-(a.status==='running'));
-      if(!history.length){this.ui.show('还没有执行记录。运行工作流后，可在 /logs 回看。');return;}
+      if(!history.length)this.ui.show('还没有执行记录。运行工作流后，可在 /logs 回看。');
       const titles=new Map((await this.app.listWorkflows()).map(flow=>[flow.id,flow.title??flow.id]));
       const choice=await this.ui.select('执行记录 · 选择一次执行，查看步骤、输入输出与日志',[
         ...history.map(r=>({value:`run:${r.id}`,label:`${statuses[r.status]??r.status} · ${titles.get(r.workflowId)??r.workflowId}`,description:`${new Date(r.startedAt).toLocaleString()} · ${r.id.slice(0,8)}`})),
+        {value:'usage',label:'查看日志体积',description:'按需统计，不清理文件'},
         {value:'back',label:'返回'},
       ]);
       if(choice==='back')return;
+      if(choice==='usage'){await this.logUsage();continue;}
       const id=choice.slice(4),record=history.find(r=>r.id===id);
       try{
         if(this.ui.observeRun)await this.openRun(record,{initialView:2});
@@ -285,9 +303,12 @@ export class TerminalSession{
       if(choice==='saved')flow=saved;
       else await this.execute('/save');
     }
-    await this.app.checkWorkflow(flow.id);
+    const report=await this.app.checkWorkflow(flow.id);
+    const unknown=report.privileges.filter(item=>item.requirement.declared&&item.static.status==='unknown');
+    const allowUnknownPrivileges=unknown.length?await this.ui.confirm(`这些动作需要在运行时核查权限：${unknown.map(item=>item.action).join('、')}。若仍无法确认，是否允许本次继续？`):false;
+    if(unknown.length&&!allowUnknownPrivileges)return false;
     const input=reference?await readRunInput(reference,this.baseDir):(needsJsonEditor(flow.inputs)||Object.keys(flow.inputs?.properties??{}).length)?await editValue(this.ui,flow.inputs,{}, {baseDir:this.baseDir,label:'本次运行参数',required:true}):{};
-    const run=await this.app.startRun(flow.id,input);
+    const run=await this.app.startRun(flow.id,input,{allowUnknownPrivileges});
     if(this.ui.trackRun){
       this.ui.clearMessages?.();this.ui.trackRun({app:this.app,runId:run.id,title:flow.title??flow.id,input});
       void run.done.catch(error=>{if(!this.ui.closed)this.ui.show(`运行记录保存失败：${error.message}`);});return true;
@@ -319,20 +340,116 @@ export class TerminalSession{
       const keep=this.app.logSettings().keepRuns;
       const choice=await this.ui.select('Fishtools 配置',[
         {value:'info',label:'查看工作区信息'},
+        {value:'network',label:'代理设置',description:'分别设置整个工作区、插件或某个动作'},
+        {value:'usage',label:'查看日志体积'},
         ...(!this.app.project.readOnly?[{value:'logs',label:'日志保留次数',description:keep===null?'不自动清理':`最近 ${keep} 次`}]:[]),
         {value:'back',label:'返回主面板'},
       ]);
       if(choice==='back')return;
       if(choice==='info')this.ui.show(`工作区：${this.app.projectDir}\n日志目录：${this.app.outputDir}\n模式：${this.app.project.readOnly?'只读运行包':'可编辑工作区'}`);
+      else if(choice==='network')await this.networkSettings();
+      else if(choice==='usage')await this.logUsage();
       else await this.logSettings();
     }
   }
+  async chooseNetworkRule(label){
+    const profiles=Object.keys(this.app.networkPolicy().profiles??{});
+    const value=await this.ui.select(label,[
+      {value:'inherit',label:'沿用系统代理环境'},
+      {value:'direct',label:'直连，不使用代理'},
+      ...profiles.map(name=>({value:`profile:${name}`,label:`使用代理配置：${name}`})),
+      {value:'back',label:'返回'},
+    ]);
+    if(value==='back')return null;
+    return value.startsWith('profile:')?{mode:'profile',profile:value.slice(8)}:{mode:value};
+  }
+  async networkProfiles(){
+    while(true){
+      const policy=this.app.networkPolicy(),profiles=policy.profiles??{};
+      const choice=await this.ui.select('代理配置（地址可用环境变量引用，凭据请勿写入项目）',[
+        ...Object.keys(profiles).map(name=>({value:`edit:${name}`,label:`修改 ${name}`})),
+        ...(!this.app.project.readOnly?[{value:'create',label:'＋ 新建代理配置'},...Object.keys(profiles).map(name=>({value:`delete:${name}`,label:`删除 ${name}`}))]:[]),
+        {value:'back',label:'返回'},
+      ]);
+      if(choice==='back')return;
+      this.writable();
+      if(choice.startsWith('delete:')){
+        const name=choice.slice(7);
+        if(await this.ui.confirm(`删除代理配置 ${name}？引用它的规则需要先改为其他模式。`)){
+          delete profiles[name];const saved=await this.app.configureNetworkPolicy({...policy,profiles});
+          this.ui.show(`代理配置 ${name} 已删除。原项目配置备份：${saved.backup}`);
+        }
+        continue;
+      }
+      const name=choice==='create'?(await this.ui.input('代理配置名称（字母开头）',{files:false})).trim():choice.slice(5);
+      if(!name)throw new Error('代理配置名称不能为空');
+      const current=profiles[name]??{},next={};
+      for(const [field,label] of [['http','HTTP 请求'],['https','HTTPS 请求'],['noProxy','不走代理的目标（例如 localhost,127.0.0.1）']]){
+        const direct=field==='noProxy'?'noProxy':`${field}Url`,reference=`${field}Env`;
+        const source=await this.ui.select(`${name} · ${label}`,[{value:'none',label:'不单独设置'},{value:'url',label:field==='noProxy'?'直接填写目标列表':'直接填写代理地址（不能带凭据）'},{value:'env',label:'读取环境变量（可用于有凭据的代理）'}]);
+        if(source!=='none'){
+          const key=source==='env'?reference:direct;
+          next[key]=(await this.ui.input(source==='env'?'环境变量名称':label,{value:current[key]??'',files:false})).trim();
+        }
+      }
+      const saved=await this.app.configureNetworkPolicy({...policy,profiles:{...profiles,[name]:next}});
+      this.ui.show(`代理配置 ${name} 已保存。原项目配置备份：${saved.backup}`);
+    }
+  }
+  async networkSettings(){
+    while(true){
+      const policy=this.app.networkPolicy(),summary=JSON.stringify(policy,null,2);
+      const choice=await this.ui.select('代理设置 · 动作规则优先于插件，插件优先于工作区',[
+        {value:'view',label:'查看当前规则'},
+        ...(!this.app.project.readOnly?[{value:'default',label:'设置工作区默认模式'},{value:'plugin',label:'设置某个插件的默认模式'},{value:'action',label:'设置某个动作的模式'}]:[]),
+        {value:'profiles',label:'管理代理配置'},
+        {value:'back',label:'返回'},
+      ]);
+      if(choice==='back')return;
+      if(choice==='view'){
+        const report=this.app.networkReport();
+        const mode=item=>item.mode==='profile'?`代理配置 ${item.profile}`:item.mode==='direct'?'直连':'继承系统环境';
+        const effective=report.entries.map(item=>`${item.id}：${mode(item)}（来源：${{action:'动作',plugin:'插件',workspace:'工作区',system:'系统默认'}[item.source]}）`);
+        const stale=[...report.stalePlugins.map(id=>`插件 ${id}`),...report.staleActions.map(id=>`动作 ${id}`)];
+        this.ui.show(`已保存规则：\n${summary}\n\n最终生效模式：\n${effective.join('\n')||'暂无已安装插件'}\n\n失效引用：\n${stale.join('\n')||'无'}`);
+        continue;
+      }
+      if(choice==='profiles'){await this.networkProfiles();continue;}
+      const next=structuredClone(policy);
+      if(choice==='default'){
+        const rule=await this.chooseNetworkRule('工作区默认模式');if(!rule)continue;
+        next.default=rule;
+      }else{
+        const installed=this.app.listPlugins();
+        if(!installed.length){this.ui.show('当前没有已安装插件。');continue;}
+        const id=await this.ui.select('选择插件',installed.map(p=>({value:p.id,label:p.title??p.id})));
+        next.plugins??={};next.plugins[id]??={};
+        if(choice==='plugin'){
+          const rule=await this.chooseNetworkRule(`${id} 默认模式`);if(!rule)continue;
+          next.plugins[id].default=rule;
+        }else{
+          const actions=this.app.catalog().filter(a=>a.plugin===id);
+          if(!actions.length){this.ui.show('此插件没有可编排动作。');continue;}
+          const action=await this.ui.select('选择动作',actions.map(a=>({value:a.id.slice(id.length+1),label:a.title??a.id})));
+          const rule=await this.chooseNetworkRule(`${id}:${action} 模式`);if(!rule)continue;
+          next.plugins[id].actions??={};next.plugins[id].actions[action]=rule;
+        }
+      }
+      const saved=await this.app.configureNetworkPolicy(next);this.ui.show(`代理规则已保存。原项目配置备份：${saved.backup}`);
+    }
+  }
+  async logUsage(){
+    const usage=await this.app.logUsage(),keep=this.app.logSettings().keepRuns;
+    const units=['B','KiB','MiB','GiB','TiB'];let size=usage.bytes,index=0;
+    while(size>=1024&&index<units.length-1){size/=1024;index++;}
+    this.ui.show(`日志目录：${usage.directory}\n日志文件体积：${index?size.toFixed(2):size} ${units[index]}（${usage.bytes} 字节，${usage.files} 个文件）${usage.incomplete?'，部分路径无法读取，统计不完整':''}\n统计该目录中所有运行的 run.md / events.jsonl / result.json，包含进行中的运行；不含业务文件，不跟随链接。共享目录可能包含其他项目。\n这是文件长度快照，运行中可能继续增长；并非磁盘实际分配空间。\n本项目保留策略：${keep===null?'不自动清理':`最近 ${keep} 次已结束运行`}；没有单次运行体积上限。`);
+  }
   async logSettings(){
     const keep=this.app.logSettings().keepRuns;
     const mode=await this.ui.select('保留策略（整个项目合计，仅清理日志，保留业务文件）',[{value:'count',label:'仅保留最近 N 次已结束运行'},{value:'all',label:'不自动清理'},{value:'back',label:'返回'}]);
     if(mode==='back')return;
     const count=mode==='all'?null:Number(await this.ui.input('保留次数（例如 10）',{value:String(keep??10),files:false}));
-    await this.app.configureLogs(count);this.ui.show('日志保留设置已保存。');
+    const saved=await this.app.configureLogs(count);this.ui.show(`日志保留设置已保存。原项目配置备份：${saved.backup}${saved.warning?`\n${saved.warning.message}`:''}`);
   }
   async openRun(entry,{initialView}={}){
     const record=this.app.getRun(entry.id)??await this.app.readRun(entry.id),workflows=await this.app.listWorkflows();
@@ -358,7 +475,8 @@ export class TerminalSession{
       const text=await this.ui.input(action==='npm'?'npm 包名（支持 @scope/name）':'输入 @ 并选择插件目录或 .tgz',{files:action==='local'});
       const source=action==='local'?fileReference(text,this.baseDir):text.trim();if(!source)throw new Error('插件来源不能为空');
       if(!await this.ui.confirm(`安装并加载可信插件：${source}？`))return;
-      const done=this.ui.busy('正在安装插件…');try{await this.app.installPlugin(source);}finally{done();}
+      const done=this.ui.busy('正在安装插件…');let result;try{result=await this.withMaintenance(options=>this.app.installPlugin(source,options));}finally{done();}
+      if(result===null){this.ui.show('已取消安装。');continue;}
     }
     this.ui.show('插件列表已更新。');
     }
@@ -383,7 +501,17 @@ export class TerminalSession{
       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==='remove'){
-        this.writable();if(await this.ui.confirm(`移除 ${id}？已有工作流可能依赖它。`)){await this.app.removePlugin(id);this.ui.show('插件已移除。');return;}
+        this.writable();if(await this.ui.confirm(`移除 ${id}？`)){
+          let removed;
+          try{removed=await this.withMaintenance(options=>this.app.removePlugin(id,options));}
+          catch(error){
+            if(error.code!=='PLUGIN_IN_USE'||!error.details?.workflows?.length)throw error;
+            const names=error.details.workflows.map(w=>w.title??w.id).join('、');
+            if(!await this.ui.confirm(`以下工作流仍使用 ${id}：${names}。移除后这些工作流将无法运行，仍要移除吗？`))continue;
+            removed=await this.withMaintenance(options=>this.app.removePlugin(id,options),{force:true});
+          }
+          if(removed){this.ui.show('插件已移除。');return;}
+        }
       }
     }
   }

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

@@ -0,0 +1,29 @@
+import {stripVTControlCharacters} from 'node:util';
+import {truncateToWidth,visibleWidth} from '@mariozechner/pi-tui';
+
+// 先清理外部文本，再由受控主题函数添加颜色；不接受插件传入的 ANSI。
+export const cleanText=value=>stripVTControlCharacters(String(value)).replace(/[\x00-\x08\x0b-\x1f\x7f]/g,'');
+const color=(rgb,text)=>Object.hasOwn(process.env,'NO_COLOR')?text:`\x1b[38;2;${rgb}m${text}\x1b[39m`;
+export const palette={
+  brand:text=>color('78;201;176',text),
+  error:text=>color('244;117;117',text),
+  text:text=>color('229;233;237',text),
+  muted:text=>color('139;149;158',text),
+  border:text=>color('74;101;99',text),
+};
+export const menuTheme={selectedPrefix:palette.brand,selectedText:palette.brand,description:palette.muted,scrollInfo:palette.muted,noMatch:palette.muted};
+export const fitLine=(text,width)=>truncateToWidth(text,Math.max(1,width),'…');
+
+export function shortenPath(value,width){
+  if(visibleWidth(value)<=width)return value;
+  // 中间省略保留盘符与项目名；完整目录仍在帮助页中展示。
+  const chars=[...value],head=chars.splice(0,Math.min(3,Math.max(0,width-2))).join('');
+  while(chars.length&&visibleWidth(head+'…'+chars.join(''))>width)chars.shift();
+  return fitLine(head+'…'+chars.join(''),width);
+}
+
+export function markdownTheme(){
+  const plain=text=>text;
+  return {heading:palette.brand,link:palette.brand,linkUrl:palette.muted,code:palette.brand,codeBlock:plain,codeBlockBorder:palette.border,quote:plain,quoteBorder:palette.border,hr:palette.border,listBullet:palette.brand,
+    bold:palette.text,italic:plain,strikethrough:plain,underline:plain};
+}

package/node_modules/@mytools/{core → fst-cli}/src/terminal/view.js

@@ -6,7 +6,7 @@ import { MarkdownLogViewer } from './log-viewer.js';
 import { RunViewer, mouseOn, mouseOff, mouseWheel } from './run-viewer.js';
 import {RunFeed} from './run-feed.js';
 import { logo } from './presentation.js';
-import { VERSION } from '../version.js';
+import { VERSION } from '@mytools/core/version';
 import {cleanText as safe,palette,menuTheme as theme,fitLine,shortenPath} from './theme.js';
 
 export const cancelled=()=>Object.assign(new Error('已返回主菜单'),{code:'PROMPT_CANCELLED'});
@@ -191,13 +191,13 @@ export class TerminalView{
     }
   }
   async observeRun({app,runId,record,flow,workflows=[],initialView}){
-    const previousPending=this.pending??null,children=this.tui.children;let overlay,unsubscribe;
+    const previousPending=this.pending??null,children=this.tui.children;let overlay,unsubscribe,readPages=false;
     const initial=app.getRun(runId)??record??await app.readRun(runId);
     if(!initial)throw new Error('这次运行记录已不存在');
     try{
       await new Promise((resolve,reject)=>{
         this.pending={resolve,reject};
-        this.runViewer=new RunViewer({record:initial,flow:initial.status==='running'?flow:undefined,workflows,catalog:app.catalog?.()??[],terminal:this.terminal,onClose:resolve,onCancel:()=>app.cancelRun(runId),requestRender:()=>this.tui.requestRender()});
+        this.runViewer=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,requestRender:()=>this.tui.requestRender()});
         Object.assign(this.runViewer,this.runViews.get(runId)??{});
         if(initialView!==undefined){this.runViewer.view=initialView;this.runViewer.offset=0;}
         unsubscribe=app.subscribe(event=>{if(event.runId===runId)this.runViewer?.update(app.getRun(runId));});
@@ -209,6 +209,23 @@ export class TerminalView{
       if(this.runViews.size>30)this.runViews.delete(this.runViews.keys().next().value);
       unsubscribe?.();this.runViewer=null;this.tui.children=children;this.pending=previousPending;overlay?.hide();this.terminal.write(mouseOff);this.tui.requestRender(true);
     }
+    if(readPages)await this.viewLogPages(app,runId);
+  }
+  async viewLogPages(app,id){
+    let cursor=0;const previous=[];
+    for(;;){
+      const page=await app.readLogPage(id,{cursor,limit:65536});
+      await this.viewMarkdown(`完整日志 · ${cursor}–${page.nextCursor} / ${page.totalBytes} 字节`,page.text||'本页暂无内容');
+      const choice=await this.select('完整日志分页',[
+        ...(page.hasMore?[{value:'next',label:'下一页'}]:[]),
+        ...(previous.length?[{value:'previous',label:'上一页'}]:[]),
+        {value:'refresh',label:'刷新本页'},{value:'first',label:'回到首页'},{value:'back',label:'返回'},
+      ]);
+      if(choice==='back')return;
+      if(choice==='next'){previous.push(cursor);if(previous.length>1000)previous.shift();cursor=page.nextCursor;}
+      if(choice==='previous')cursor=previous.pop()??0;
+      if(choice==='first'){cursor=0;previous.length=0;}
+    }
   }
   async ask(message,component){
     fit(component);

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

@@ -0,0 +1,65 @@
+export async function workflowMenu(session){
+  const {app,ui}=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} 步`})),
+      ...(!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:'返回主面板'},
+    ]);
+    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;}
+      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;
+      }
+      if(await editWorkflow(session)==='running')return;
+    }catch(error){if(error.code!=='PROMPT_CANCELLED')throw error;}
+  }
+}
+
+async function editWorkflow(session){
+  const {app,ui}=session;
+  while(true){
+    const flow=session.current();
+    const choice=await ui.select(`${flow.title??flow.id} · ${flow.steps.length} 步 · ${session.dirty?'未保存':'已保存'}`, [
+      {value:'run',label:'运行工作流'},
+      ...(!app.project.readOnly?[
+        {value:'add',label:'添加步骤 / 控制流'}, {value:'steps',label:'编辑步骤、参数与顺序'},
+        {value:'outputs',label:'设置最终输出'},{value:'save',label:'保存工作流'},
+        {value:'duplicate',label:'复制为新工作流（包含当前未保存修改）'},
+        {value:'delete',label:'删除工作流（保留可恢复备份）'},
+      ]:[{value:'steps',label:'查看步骤'}]),
+      {value:'back',label:'返回工作流列表（保留草稿）'},
+    ]);
+    if(choice==='back')return;
+    try{
+      if(choice==='delete'){
+        if(!await ui.confirm(`删除 ${flow.title??flow.id}？已保存文件会移入备份，未保存修改将放弃。`))continue;
+        const exists=(await app.listWorkflows()).some(w=>w.id===flow.id);
+        const backup=exists?await app.removeWorkflow(flow.id):null;
+        session.flow=null;session.dirty=false;ui.show(backup?`工作流已移入备份：${backup}`:'未保存的草稿已删除。');return;
+      }
+      if(choice==='run'){
+        if(await session.startRun([],{draft:true}))return 'running';
+      }else if(choice==='duplicate')await duplicateIntoSession(session,flow);
+      else await session.execute('/'+choice);
+    }catch(error){if(error.code!=='PROMPT_CANCELLED')throw error;}
+  }
+}
+
+async function duplicateIntoSession(session,source){
+  const title=(await session.ui.input('新工作流名称',{value:`${source.title??source.id} 副本`,files:false})).trim();
+  if(!title)throw new Error('名称不能为空');
+  const {definition}=await session.app.duplicateWorkflow(source,{title});
+  session.flow=structuredClone(definition);session.dirty=false;
+  session.ui.show(`已创建副本：${definition.title}（${definition.id}）。原工作流 ${source.id} 未修改。可在父工作流中依次加入原版和副本两个子流程步骤，比较输出和耗时。`);
+}

package/node_modules/@mytools/fst-devtools/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mytools contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.