@yanglaofish/fishtools 0.4.0 → 0.5.0

package/manual/packages/fst-cli/src/development.js

@@ -0,0 +1,53 @@
+import {randomBytes} from 'node:crypto';
+import {createDevelopmentSupervisor,bindDevelopmentChild} from '@mytools/core/development';
+
+export async function startDevelopment({projectDir,entry,args,configFile,mode,port}){
+  console.error('开发模式：源码变化后等待当前业务结束并重启；终端未保存的编辑草稿不会保留。');
+  const supervisor=await createDevelopmentSupervisor({projectDir,entry,args,configFile,
+    env:{FISHTOOLS_DEV_PROJECT:projectDir,FISHTOOLS_DEV_MODE:mode,FISHTOOLS_DEV_TOKEN:randomBytes(24).toString('hex'),FISHTOOLS_DEV_PORT:String(port)},
+    onEvent(event){
+      if(event.type==='ready')console.error(event.recovered?'开发应用已恢复，源码监听继续。':`开发应用已就绪（第 ${event.generation} 代）。`);
+      else if(event.type==='waiting')console.error('开发源码已修改，等待当前运行及管理操作结束。');
+      else if(event.type==='restarting')console.error('开发应用准备重启。');
+      else if(event.type==='failed')console.error(`开发应用启动失败：${event.message}；修复源码后自动重试。`);
+      else if(['forced','blocked','watchError'].includes(event.type))console.error(`开发模式：${event.message}`);
+      if(event.type==='exited'&&mode==='terminal'&&process.stdout.isTTY){
+        process.stdin.setRawMode?.(false);process.stdout.write('\x1b[?1006l\x1b[?1000l\x1b[?25h\x1b[?1049l');
+      }
+    }});
+  const stop=()=>{void supervisor.close().catch(error=>{console.error(error.message);process.exitCode=2;}).finally(()=>{
+    process.removeListener('SIGINT',stop);process.removeListener('SIGTERM',stop);
+    // 子进程被强制回收时，监督器恢复终端的常用状态。
+    if(mode==='terminal'&&process.stdout.isTTY)process.stdout.write('\x1b[?1006l\x1b[?1000l\x1b[?25h\x1b[?1049l');
+  });};
+  process.once('SIGINT',stop);process.once('SIGTERM',stop);
+  return supervisor;
+}
+
+export async function runDevelopmentChild(app,{mode,webOptions}){
+  const web={...webOptions,port:Number(process.env.FISHTOOLS_DEV_PORT??webOptions.port),token:process.env.FISHTOOLS_DEV_TOKEN};
+  let binding;
+  const stop=()=>{void binding?.close();};
+  if(mode==='web'){
+    const server=await app.startWeb(web);console.log(`Fishtools：${server.url}`);
+    binding=bindDevelopmentChild(app,{details:{port:server.port},closePresentation:()=>{
+      process.removeListener('SIGINT',stop);process.removeListener('SIGTERM',stop);
+    }});
+    process.on('SIGINT',stop);process.on('SIGTERM',stop);return;
+  }
+  const [{TerminalView},{TerminalSession}]=await Promise.all([import('./terminal/view.js'),import('./terminal/session.js')]);
+  const ui=new TerminalView({baseDir:process.cwd()}),session=new TerminalSession(app,ui,{webOptions:web});
+  let presentation;
+  try{
+    ui.start();presentation=session.run();
+    binding=bindDevelopmentChild(app,{closePresentation:async()=>{
+      // 监督器已经确认业务空闲；开发重启直接结束草稿和 pending 提示。
+      session.exiting=true;session.dirty=false;
+      ui.pending?.reject(Object.assign(new Error('开发应用重启'),{code:'PROMPT_CANCELLED'}));
+      await presentation;
+      await ui.close();process.removeListener('SIGINT',stop);process.removeListener('SIGTERM',stop);
+    }});
+    process.on('SIGINT',stop);process.on('SIGTERM',stop);
+    await presentation;
+  }finally{await ui.close();await binding?.close();}
+}

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

@@ -3,7 +3,7 @@ import { homedir } from 'node:os';
 import { readFile } from 'node:fs/promises';
 import { randomUUID } from 'node:crypto';
 
-export {builtinCommands as commands} from '../contracts.js';
+export {builtinCommands as commands} from '@mytools/fst-plugin/contracts';
 
 export function parseCommand(text){
   const args=[];let token='',quote='',started=false;

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

@@ -1,4 +1,4 @@
-import {builtinCommands} from '../contracts.js';
+import {builtinCommands} from '@mytools/fst-plugin/contracts';
 
 const visible=['workflows','run','pack','logs','plugin','config','tools','help','exit'];
 // 入口由插件 ID 推导；冲突时加前缀，不能覆盖内置或作者注册的命令。

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

@@ -23,15 +23,23 @@ function fields(schema){
   return entries.length?entries.map(([key,s])=>`${s.title??key} (${key}, ${s.type??'任意类型'}${schema.required?.includes(key)?', 必填':''})${s.description?`：${s.description}`:''}`).join('；'):'无';
 }
 
+function privilege(item,plugin){
+  const declaration=item.requirements?.privilege?.[process.platform]??plugin.requirements?.privilege?.[process.platform];
+  if(!declaration)return '未声明';
+  const names={user:'普通用户',root:'root',administrator:'管理员',resource:'特定资源权限'};
+  return `${names[declaration.level]??declaration.level}${declaration.reason?`；原因：${declaration.reason}`:''}${declaration.remediation?`；处理：${declaration.remediation}`:''}`;
+}
+
 export function pluginDetails(plugin,actions,commands){
   return [
     `# ${plugin.title??plugin.id}`,
     plugin.description??'作者尚未提供用途说明。',
     `标识：${plugin.id}\n\n版本：${plugin.version}\n\n来源：${plugin.removable?'自行安装（可移除）':'发行包内置 / 项目预置'}\n\n状态：${pluginStatus(plugin)}`,
     ...(plugin.runtime?.missing?.length?[`缺少服务：${plugin.runtime.missing.join(', ')}`]:[]),
+    `更新方式：${!plugin.runtime?.updatePolicy?'无运行时服务':plugin.runtime.updatePolicy==='automatic'?'可自动短暂停止并重启':'需要本次维护确认'}\n\n插件权限：${privilege(plugin,plugin)}`,
     `声明平台：${plugin.platforms?.join(', ')??'作者未声明'}\n\n声明架构：${plugin.architectures?.join(', ')??'作者未声明'}`,
     '## 可用于编排的能力',
-    ...(actions.length?actions.map(a=>`### ${a.title??a.id}\n\n${a.description??''}\n\n能力 ID：${a.id}\n\n输入：${fields(a.input)}\n\n输出：${fields(a.output)}`):['此插件没有提供编排动作，可能提供 Web、共享服务或交互命令。']),
+    ...(actions.length?actions.map(a=>`### ${a.title??a.id}\n\n${a.description??''}\n\n能力 ID：${a.id}\n\n输入：${fields(a.input)}\n\n输出：${fields(a.output)}\n\n权限：${privilege(a,plugin)}`):['此插件没有提供编排动作，可能提供 Web、共享服务或交互命令。']),
     '## 斜杠命令',commands.length?commands.map(c=>`- /${c.name}：${c.description??'未提供说明'}`).join('\n'):'没有注册斜杠命令。',
     '## 插件配置',plugin.config?fields(plugin.config):'无需配置。',
     '## 环境声明',

package/{node_modules/@mytools/core → manual/packages/fst-cli}/src/terminal/run-feed.js

@@ -3,7 +3,7 @@ import {runStatuses} from './run-viewer.js';
 
 // 主面板按事件到达顺序追加；运行快照另存，配置菜单不会清掉执行记录。
 export class RunFeed{
-  constructor(refresh){this.refresh=refresh;this.runs=new Map();this.entries=[];this.subscriptions=new Map();this.expanded=false;}
+  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]))};
@@ -26,12 +26,15 @@ export class RunFeed{
     this.refresh();
   }
   update(item,event){
-    if(event?.type&&!['run.succeeded','run.failed','run.cancelled','run.stopped'].includes(event.type))item.record.events.push(event);
+    let events;
+    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??[])]};
+      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,events=record.events.slice(item.count);item.count=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});
     if(events.length){
       const last=this.entries.at(-1);
@@ -39,12 +42,34 @@ export class RunFeed{
       else this.entries.push({type:'events',item,events});
     }
     if(record.status!=='running'&&!item.ended){item.ended=true;this.entries.push({type:'result',item});}
+    this.trim();
+  }
+  trim(){
+    let count=0,bytes=0;
+    for(let index=this.entries.length-1;index>=0;index--){
+      const entry=this.entries[index];if(!entry.events)continue;
+      let keep=entry.events.length;
+      for(let i=entry.events.length-1;i>=0;i--){
+        const size=Buffer.byteLength(JSON.stringify(entry.events[i]));
+        if(count>=this.maxEvents||bytes+size>this.maxBytes){keep=entry.events.length-i-1;this.dropped+=i+1;break;}
+        count++;bytes+=size;
+      }
+      if(keep!==entry.events.length)entry.events=keep?entry.events.slice(-keep):[];
+    }
+    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++;}
+    const messages=this.entries.filter(e=>e.type==='message');for(const entry of messages.slice(0,Math.max(0,messages.length-100)))this.entries.splice(this.entries.indexOf(entry),1);
   }
   release(app){
     if([...this.runs.values()].some(item=>item.app===app&&!item.ended))return;
     this.subscriptions.get(app)?.();this.subscriptions.delete(app);
   }
-  message(text){this.entries.push({type:'message',text});this.refresh();}
+  message(text){this.entries.push({type:'message',text:String(text).slice(-65536)});this.trim();this.refresh();}
   compactEvents(entry,seen){
     const {item}=entry,rows=[];
     for(const event of entry.events){
@@ -61,7 +86,7 @@ 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.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 [
@@ -71,6 +96,7 @@ export class RunFeed{
     ].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??'',
     ].filter(Boolean).join('\n');
   }).filter(Boolean).join('\n\n');}

package/{node_modules/@mytools/core → manual/packages/fst-cli}/src/terminal/run-viewer.js

@@ -3,15 +3,15 @@ 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:'待执行',running:'运行中',succeeded:'成功',failed:'失败',cancelled:'已取消',skipped:'已跳过',stopped:'已停止'};
+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,requestRender}){
-    Object.assign(this,{terminal,onClose,onCancel,requestRender,catalog});this.view=0;this.selected=0;this.offset=0;this.follow=true;this.allLogs=true;this.raw=false;this.confirmCancel=false;
+  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??[]){
@@ -27,8 +27,8 @@ export class RunViewer{
   invalidate(){}
   update(record){
     if(!record)return;
-    this.record=record;const nodes=new Map(this.planned.map(node=>[node.callPath,{...node}]));
-    for(const event of record.events??[]){
+    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)});
@@ -42,6 +42,7 @@ export class RunViewer{
     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:''}`),
@@ -55,7 +56,7 @@ export class RunViewer{
         !error&&(node?.reason||node?.message)?'\n说明：'+(node.reason??node.message):'',this.raw?'\n原始 JSON · 包含完整错误详情与调用栈':'\nj 查看原始 JSON 与完整诊断',
       ].filter(Boolean).join('\n');
     }
-    return readableTimeline(this.record.events,{callPath:this.allLogs?undefined:node?.callPath});
+    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);
@@ -69,7 +70,7 @@ export class RunViewer{
     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 取消 · 1/2/3 切换';
+    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));
@@ -77,6 +78,7 @@ export class RunViewer{
     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;}

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

@@ -1,4 +1,4 @@
-import { validate } from '../validation.js';
+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);

package/manual/packages/{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/manual/packages/{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/core → manual/packages/fst-cli}/src/terminal/workflow-menu.js

@@ -4,6 +4,7 @@ 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:'返回主面板'},
@@ -11,7 +12,11 @@ export async function workflowMenu(session){
     if(choice==='back')return;
     try{
       const id=choice.startsWith('workflow:')?choice.slice(9):null;
-      if(choice==='new'){if(await session.execute('/new')===false)continue;}
+      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;
@@ -30,6 +35,7 @@ async function editWorkflow(session){
       ...(!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:'返回工作流列表（保留草稿）'},
@@ -44,7 +50,16 @@ async function editWorkflow(session){
       }
       if(choice==='run'){
         if(await session.startRun([],{draft:true}))return 'running';
-      }else await session.execute('/'+choice);
+      }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/manual/packages/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.