@yanglaofish/fishtools 0.3.0 → 0.5.0

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.

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

@@ -0,0 +1,28 @@
+# 开发工具模块
+
+包名：`@mytools/fst-devtools`。内部 workspace 包，随 `@yanglaofish/fishtools` 统一交付。
+
+## 职责与边界
+
+插件脚手架、validate、lint、离线文档发现与导出。不管理常驻宿主或用户运行状态。
+
+内部依赖：`@mytools/sdk`、`@mytools/fst-platform`、`@mytools/fst-plugin`。
+## 公开入口
+
+| 导入路径 | 实现位置 |
+| --- | --- |
+| `@mytools/fst-devtools` | `./src/plugin-tools.js` |
+| `@mytools/fst-devtools/documentation` | `./src/documentation.js` |
+| `@mytools/fst-devtools/package.json` | `./package.json` |
+
+仅依赖 exports 声明的入口，禁止消费者跨包读取 src/bin 私有文件。入口路径由本模块维护，修改协议时同步消费方回归。
+
+## 维护与验证
+
+本模块负责上述职责的实现、文档与回归；跨模块接口调整需要同时检查生产者与消费者。具体维护人员尚未指定。
+
+在仓库根目录执行：
+
+```sh
+node --test tests/modules.test.js tests/plugin-tools.test.js tests/plugin-lint.test.js tests/documentation.test.js
+```

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

@@ -0,0 +1,29 @@
+{
+  "name": "@mytools/fst-devtools",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "src/plugin-tools.js",
+  "exports": {
+    ".": "./src/plugin-tools.js",
+    "./documentation": "./src/documentation.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.15.0"
+  },
+  "dependencies": {
+    "@mytools/sdk": "0.1.0",
+    "@mytools/fst-platform": "0.1.0",
+    "@mytools/fst-plugin": "0.1.0",
+    "semver": "7.7.4",
+    "validate-npm-package-name": "8.0.0",
+    "acorn": "8.19.0"
+  }
+}

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

@@ -0,0 +1,67 @@
+import path from 'node:path';
+import {fileURLToPath} from 'node:url';
+import {access,readFile,readdir,lstat,mkdir,copyFile,realpath} from 'node:fs/promises';
+
+const topics=[
+  ['plugins','插件开发规范','docs/plugin-development.md'],
+  ['deployment','安装与部署','docs/deployment.md'],
+  ['control','控制流与运行观察规范','docs/superpowers/specs/2026-10-11-control-observation.md'],
+  ['services','服务插件示例','examples/service-plugins/README.md'],
+  ['example','可安装的零依赖动作插件','docs/examples/action-plugin/README.md'],
+  ['roadmap','路线图','docs/roadmap.md'],
+  ['modules','模块架构与维护','docs/modules.md'],
+  ['generation','大日志、开发重载与隔离文件探测','docs/kernel-generation.md'],
+  ['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 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));};
+
+export async function findDocumentationRoot(){
+  let directory=path.dirname(fileURLToPath(import.meta.url));
+  for(;;){
+    for(const candidate of [directory,path.join(directory,'manual')]){
+      try{await access(path.join(candidate,'docs/plugin-development.md'));await access(path.join(candidate,'LICENSE'));return candidate;}
+      catch(error){if(error.code!=='ENOENT'&&error.code!=='ENOTDIR')throw error;}
+    }
+    const parent=path.dirname(directory);if(parent===directory)break;directory=parent;
+  }
+  throw new Error('当前安装缺少离线文档，请重新安装完整的 Fishtools 发行包');
+}
+
+export async function listDocumentation(){
+  const root=await findDocumentationRoot();
+  return topics.map(([id,title,file])=>({id,title,path:path.join(root,file)}));
+}
+
+export async function readDocumentation(topic='plugins'){
+  const entry=(await listDocumentation()).find(item=>item.id===topic);
+  if(!entry)throw new Error(`未知文档主题：${topic}。运行 fst docs 查看可用主题`);
+  return {...entry,text:await readFile(entry.path,'utf8')};
+}
+
+export async function copyDocumentation(destination,{sourceRoot}={}){
+  const source=await realpath(sourceRoot??await findDocumentationRoot());
+  const target=path.resolve(destination);
+  try{await lstat(target);throw new Error(`文档导出目标已存在：${target}`);}catch(error){if(error.code!=='ENOENT')throw error;}
+  // 目标可位于仓库 dist 下，但不能嵌入即将复制的资料目录。
+  await mkdir(path.dirname(target),{recursive:true});
+  const canonicalTarget=path.join(await realpath(path.dirname(target)),path.basename(target));
+  for(const asset of assets)if(inside(path.join(source,asset),canonicalTarget))throw new Error('文档导出目标不能位于原资料目录内');
+  await mkdir(target);
+  const copy=async(from,to)=>{
+    const info=await lstat(from);
+    if(info.isSymbolicLink())throw new Error(`离线文档不允许符号链接：${from}`);
+    if(info.isDirectory()){
+      await mkdir(to,{recursive:true});
+      for(const entry of await readdir(from))if(!excluded.has(entry))await copy(path.join(from,entry),path.join(to,entry));
+    }else if(info.isFile()){
+      await mkdir(path.dirname(to),{recursive:true});await copyFile(from,to);
+    }else throw new Error(`离线文档包含不支持的文件：${from}`);
+  };
+  for(const asset of assets)await copy(path.join(source,asset),path.join(target,asset));
+  return target;
+}
+
+export async function exportDocumentation(destination){return copyDocumentation(destination);}