@yanglaofish/fishtools 0.2.0 → 0.4.0

package/node_modules/@mytools/core/src/terminal/view.js

@@ -3,7 +3,8 @@ import path from 'node:path';
 import { homedir } from 'node:os';
 import { TUI, Text, Container, Editor, SelectList, ProcessTerminal, CombinedAutocompleteProvider, matchesKey, truncateToWidth, visibleWidth } from '@mariozechner/pi-tui';
 import { MarkdownLogViewer } from './log-viewer.js';
-import { RunViewer, mouseOn, mouseOff } from './run-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 {cleanText as safe,palette,menuTheme as theme,fitLine,shortenPath} from './theme.js';
@@ -14,8 +15,13 @@ function fit(component){const render=component.render.bind(component);component.
 
 // Pi 的 @ 模糊搜索依赖额外的 fd 程序。这里按目录补全，离线目标机无需安装 fd。
 export class FileAutocomplete extends CombinedAutocompleteProvider{
-  constructor(commands,baseDir){super(commands,baseDir);this.baseDir=baseDir;}
+  constructor(commands,baseDir,workflows=[]){super(commands,baseDir);this.baseDir=baseDir;this.workflows=workflows;}
   getSuggestions(lines,line,col){
+    const run=lines[line].slice(0,col).match(/^\/run\s+([^@"\s]*)$/);
+    if(run){
+      const query=run[1].toLowerCase(),items=this.workflows.filter(flow=>`${flow.id} ${flow.title??''}`.toLowerCase().includes(query)).map(flow=>({value:flow.id,label:flow.title??flow.id,description:flow.id,workflow:true}));
+      return items.length?{prefix:run[1],items}:null;
+    }
     const prefix=lines[line].slice(0,col).match(/(?:^|\s)(@"[^"\n]*|@[^\s]*)$/)?.[1];
     if(!prefix)return super.getSuggestions(lines,line,col);
     const raw=prefix.slice(1).replace(/^"/,'').replaceAll('\\','/');
@@ -34,6 +40,7 @@ export class FileAutocomplete extends CombinedAutocompleteProvider{
   }
   getForceFileSuggestions(lines,line,col){return this.getSuggestions(lines,line,col);}
   applyCompletion(lines,line,col,item,prefix){
+    if(item.workflow){const next=[...lines],before=lines[line].slice(0,col-prefix.length),text=item.value+' ';next[line]=before+text+lines[line].slice(col);return {lines:next,cursorLine:line,cursorCol:before.length+text.length};}
     if(!prefix.startsWith('@'))return super.applyCompletion(lines,line,col,item,prefix);
     const before=lines[line].slice(0,col-prefix.length);
     let after=lines[line].slice(col);if(after.startsWith('"'))after=after.slice(1);
@@ -43,10 +50,23 @@ export class FileAutocomplete extends CombinedAutocompleteProvider{
 }
 
 export class TerminalView{
-  constructor({baseDir,terminal=new ProcessTerminal()}={}){
-    this.baseDir=baseDir;this.terminal=terminal;this.tui=new TUI(terminal);this.logs=[];
+  constructor({baseDir,previewLabel,terminal=new ProcessTerminal()}={}){
+    this.baseDir=baseDir;this.terminal=terminal;this.tui=new TUI(terminal);this.logs=[];this.runViews=new Map();
+    this.historyOffset=0;this.commandHistory=[];this.commandHistoryIndex=null;this.feed=new RunFeed(()=>this.refreshTranscript());
     const originalStart=terminal.start.bind(terminal);
     terminal.start=(input,resize)=>originalStart(data=>{
+      if(this.homeInput&&!this.runViewer&&!this.logViewer){
+        if(this.browseCommands(data))return;
+        if(matchesKey(data,'ctrl+o')){this.feed.expanded=!this.feed.expanded;this.historyOffset=0;this.refreshTranscript();return;}
+        const wheel=mouseWheel(data),page=Math.max(1,Math.floor(this.terminal.rows/2));
+        if(wheel||matchesKey(data,'pageUp')||matchesKey(data,'pageDown')){
+          this.historyOffset=Math.max(0,this.historyOffset+(wheel?-wheel*3:matchesKey(data,'pageUp')?page:-page));this.tui.requestRender();return;
+        }
+      }
+      if(matchesKey(data,'f4')&&this.homeInput&&this.pending&&!this.runViewer&&!this.logViewer){
+        // 快捷入口不提交或丢弃当前草稿，返回首页时继续编辑。
+        this.homeDraft=this.editor.getText();this.pending.resolve('/logs');return;
+      }
       if(matchesKey(data,'ctrl+c')){if(this.runViewer){this.runViewer.onClose();return;}if(this.cancelRun)this.cancelRun();this.pending?.reject(cancelled());return;}
       if(matchesKey(data,'escape')&&this.pending&&!this.logViewer&&!this.runViewer){
         // 编辑器自己处理补全菜单 Escape，第二次 Escape 返回上一级。
@@ -56,47 +76,99 @@ export class TerminalView{
       input(data);
     },resize);
     this.header=new Text('',1,0);this.transcript=new Text('',1,0);this.prompt=new Container();this.hint=new Text('',1,0);
-    this.hint.render=width=>['',fitLine(' '+palette.muted(width<45?'↑↓ 选择  Enter 确认  Esc 返回':'↑↓ 选择   Enter 确认   Tab 补全   Esc 返回   Ctrl+C 退出'),width)];
+    this.hint.render=width=>['',fitLine(' '+palette.muted(this.homeInput?(width<45?`/ 操作 · Ctrl+O ${this.feed.expanded?'收起':'展开'}`:`/ 操作 · Ctrl+O ${this.feed.expanded?'收起':'展开'}详情 · /logs 回看 · Ctrl+C 退出`):(width<45?'↑↓ 选择  Enter 确认  Esc 返回':'↑↓ 选择   Enter 确认   Tab 补全   Esc 返回   Ctrl+C 退出')),width)];
     const renderTranscript=this.transcript.render.bind(this.transcript);
     this.headingLines=(width,mark='FISHtools')=>{
       const room=Math.max(1,width-2),lines=[''];
+      const summary=(this.summaryText??'').split('\n');
+      const workspace=summary.find(line=>line.startsWith('当前工作区：'));
+      const details=summary.filter(line=>line!==workspace&&!line.startsWith('[F4')&&!line.startsWith('欢迎使用'));
       if(mark===logo){
-        lines.push(...logo.split('\n').map((line,i)=>' '+palette.brand(line)+(i===2?' '+palette.text('tools')+'  '+palette.muted(`v${VERSION}`):'')));
+        const side=[palette.text('FISHtools')+'  '+palette.muted(`v${VERSION}`),palette.text('欢迎使用 · 插件编排工作台'),palette.muted(details[0]??'')];
+        lines.push(...logo.split('\n').map((line,i)=>' '+palette.brand(line)+'   '+side[i]));
       }else lines.push(' '+palette.brand('FISH')+palette.text('tools')+'  '+palette.muted(`v${VERSION}`));
-      for(const [i,line] of (this.summaryText??'').split('\n').entries()){
-        if(line.startsWith('当前工作区：')){
-          const label='当前工作区：',folder=shortenPath(line.slice(label.length),Math.max(1,room-visibleWidth(label)));
-          lines.push(' '+palette.muted(label)+palette.text(folder));
-        }else lines.push(' '+(i===0?palette.text:palette.muted)(fitLine(line,room)));
+      if(previewLabel)lines.push(' '+palette.brand(safe(previewLabel)));
+      if(workspace){
+        const label='当前工作区：',folder=shortenPath(workspace.slice(label.length),Math.max(1,room-visibleWidth(label)));
+        lines.push(' '+palette.muted(label)+palette.text(folder));
       }
+      lines.push(' '+palette.muted('位置：')+palette.brand('主面板')+(this.commandLocation?palette.muted(' › ')+palette.text(this.commandLocation):''));
+      if(this.activeRuns?.())lines.push(' '+palette.muted(`${this.activeRuns()} 个运行中 · /logs 查看详情`));
       lines.push('');return lines.map(line=>fitLine(line,width));
     };
     // 先保证输入与菜单可见，空间充足才展示三行字标。
     this.header.render=width=>{
       const full=this.headingLines(width,logo),other=renderTranscript(width).length+this.prompt.render(width).length+this.hint.render(width).length;
-      return width>=34&&this.terminal.rows>=18&&full.length+other<=this.terminal.rows?full:this.headingLines(width);
+      let lines=width>=55&&this.terminal.rows>=18&&full.length+other<=this.terminal.rows&&!this.feed.entries.length?full:this.headingLines(width);
+      const budget=Math.max(0,this.terminal.rows-this.prompt.render(width).length-this.hint.render(width).length-1);
+      if(lines.length>budget)lines=lines.filter(line=>safe(line).trim());
+      if(lines.length>budget)lines=lines.slice(0,budget);
+      return lines;
     };
     this.transcript.render=width=>{
       const lines=renderTranscript(width),budget=Math.max(0,this.terminal.rows-this.header.render(width).length-this.prompt.render(width).length-this.hint.render(width).length);
-      if(lines.length<=budget)return lines;
+      if(lines.length<=budget){this.historyOffset=0;return lines;}
       if(!budget)return [];
+      if(this.feed.entries.length){
+        const count=Math.max(0,budget-1),max=Math.max(0,lines.length-count);this.historyOffset=Math.min(this.historyOffset,max);
+        const end=lines.length-this.historyOffset,start=Math.max(0,end-count);
+        return [...lines.slice(start,end),fitLine(' '+palette.muted(`PgUp/PgDn/滚轮 查看过程 · ${this.historyOffset?'历史位置':'跟随最新'}`),width)];
+      }
       const excerpt=this.logs.length<=1?lines.slice(0,budget-1):lines.slice(-(budget-1)||lines.length);
       return [...excerpt,fitLine(' '+palette.muted('… /help 完整帮助 · /logs 运行日志'),width)];
     };
     this.tui.addChild(this.header);this.tui.addChild(this.transcript);this.tui.addChild(this.prompt);this.tui.addChild(this.hint);
   }
-  start(){this.tui.start();}
+  start(){
+    if(this.started)return;this.started=true;
+    // 独立屏幕避免全屏阅读与主终端的滚动历史混在一起。
+    this.terminal.write('\x1b[?1049h\x1b[2J\x1b[H');this.tui.start();
+  }
+  browseCommands(data){
+    const direction=matchesKey(data,'up')?-1:matchesKey(data,'down')?1:0;
+    // 补全菜单保留方向键；多行编辑保留光标移动，不把配置值放进命令历史。
+    if(!direction||!this.editor||this.editor.isShowingAutocomplete()||this.editor.getText().includes('\n')||!this.commandHistory.length)return false;
+    const current=this.commandHistoryIndex??this.commandHistory.length;
+    const next=Math.max(0,Math.min(this.commandHistory.length,current+direction));
+    if(next===current)return true;
+    if(this.commandHistoryIndex===null)this.commandHistoryDraft=this.editor.getText();
+    this.commandHistoryIndex=next;
+    this.editor.setText(next===this.commandHistory.length?this.commandHistoryDraft:this.commandHistory[next]);
+    if(next===this.commandHistory.length)this.commandHistoryIndex=null;
+    this.tui.requestRender();return true;
+  }
   async close(){
+    if(this.closed)return;this.closed=true;
+    this.feed.close();
     // Pi 的渲染排在 nextTick；先排空最后一帧，再恢复终端，避免退出后隐藏光标。
     await new Promise(resolve=>process.nextTick(resolve));this.tui.stop();
+    if(this.started)this.terminal.write(mouseOff+'\x1b[?1049l');
     if(this.terminal instanceof ProcessTerminal)process.stdin.pause();
   }
   summary(text){this.summaryText=safe(text);this.tui.requestRender();}
-  clearMessages(){this.logs=[];this.transcript.setText('');this.tui.requestRender();}
+  beginCommand(text){
+    const name=text.trim().split(/\s+/)[0].replace(/^\//,'');
+    const labels={workflows:'工作流',run:'运行工作流',plugin:'插件管理',plugins:'插件管理',config:'工具配置',pack:'打包',logs:'执行记录',runs:'执行记录',tools:'工具',help:'帮助',exit:'退出'};
+    this.commandLocation=labels[name]??'/'+name;this.historyOffset=0;
+    this.clearMessages();this.feed.message('› '+safe(text));
+  }
+  endCommand(){
+    this.commandLocation=null;this.tui.requestRender();
+  }
+  transcriptText(){return [...this.logs,this.feed.text()].filter(Boolean).join('\n\n');}
+  refreshTranscript(){
+    const width=this.terminal.columns,previous=this.transcript.render===undefined?0:new Text(safe(this.lastTranscript??''),1,0).render(width).length;
+    const text=safe(this.transcriptText());
+    if(this.historyOffset>0)this.historyOffset=Math.max(0,this.historyOffset+new Text(text,1,0).render(width).length-previous);
+    this.lastTranscript=text;this.transcript.setText(text.split('\n').map(line=>line.startsWith('✗ ')?palette.error(line):/^[›✓●] /.test(line)?palette.brand(line):line.startsWith('↩ ')?palette.muted(line):line).join('\n'));this.tui.requestRender();
+  }
+  trackRun(options){this.feed.track(options);}
+  clearMessages(){this.logs=[];this.refreshTranscript();}
   show(message,{kind='message'}={}){
     const text=safe(message).slice(0,6000);
     const formatted=kind==='welcome'?text.split('\n').map((line,i)=>i===0?palette.text(line):palette.muted(line)).join('\n'):text;
-    this.logs.push(formatted);this.logs=this.logs.slice(-6);this.transcript.setText(this.logs.join('\n\n'));this.tui.requestRender();
+    if(kind!=='welcome'){this.feed.message(formatted);return;}
+    this.logs.push(formatted);this.logs=this.logs.slice(-6);this.refreshTranscript();
   }
   async viewMarkdown(title,text){
     const previousPending=this.pending??null,previousViewer=this.logViewer;
@@ -118,29 +190,42 @@ export class TerminalView{
       this.terminal.write(mouseOff);
     }
   }
-  async observeRun({app,runId,flow,workflows=[]}){
+  async observeRun({app,runId,record,flow,workflows=[],initialView}){
     const previousPending=this.pending??null,children=this.tui.children;let overlay,unsubscribe;
+    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:app.getRun(runId),flow,workflows,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),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));});
         this.tui.children=[];this.terminal.write(mouseOn);
         overlay=this.tui.showOverlay(this.runViewer,{width:'100%',maxHeight:'100%',anchor:'top-left',margin:0});this.tui.requestRender(true);
       });
     }finally{
+      if(this.runViewer){const {view,selected,offset,follow,allLogs,raw}=this.runViewer;this.runViews.set(runId,{view,selected,offset,follow,allLogs,raw});}
+      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);
     }
   }
   async ask(message,component){
     fit(component);
-    const title=new Text(palette.text(safe(message)),1,0);
-    if(message.startsWith('fst >'))title.render=width=>[fitLine(' '+palette.text(width<45?'fst > / 选择操作 · @ 文件':safe(message)),width)];
+    const title=new Text(palette.brand('› ')+palette.text(safe(message)),1,0);
+    const renderTitle=title.render.bind(title);
+    title.render=width=>[fitLine(' '+palette.border('─'.repeat(Math.max(1,width-2))),width),...renderTitle(width)];
+    if(message.startsWith('fst >'))title.render=()=>[];
     this.prompt.clear();this.prompt.addChild(title);this.prompt.addChild(component);this.tui.setFocus(component);this.tui.requestRender();
-    try{return await new Promise((resolve,reject)=>{this.pending={resolve,reject};component.onSubmit=resolve;component.onSelect=item=>resolve(item.value);component.onCancel=()=>reject(cancelled());});}
-    finally{this.pending=null;this.editor=null;this.prompt.clear();this.tui.requestRender();}
+    try{return await new Promise((resolve,reject)=>{this.pending={resolve,reject};component.onSubmit=text=>{
+      if(this.homeInput&&text.trim()&&this.commandHistory.at(-1)!==text.trim()){
+        this.commandHistory.push(text.trim());if(this.commandHistory.length>100)this.commandHistory.shift();
+      }
+      resolve(text);
+    };component.onSelect=item=>resolve(item.value);component.onCancel=()=>reject(cancelled());});}
+    finally{if(this.homeInput)this.terminal.write(mouseOff);this.pending=null;this.editor=null;this.homeInput=false;this.prompt.clear();this.tui.requestRender();}
   }
-  input(message,{value='',commands=[],files=true}={}){
+  input(message,{value='',commands=[],files=true,workflows=[]}={}){
     const editor=new Editor(this.tui,{borderColor:palette.border,selectList:theme},{paddingX:1});
     const renderEditor=editor.render.bind(editor);
     editor.render=width=>{
@@ -153,15 +238,22 @@ export class TerminalView{
         return ' '+palette.border('│')+line+' '.repeat(Math.max(0,inner-visibleWidth(line)))+palette.border('│');
       });
     };
-    this.editor=editor;editor.setText(value);
-    if(files||commands.length)editor.setAutocompleteProvider(new FileAutocomplete(commands,this.baseDir));
+    this.homeInput=message.startsWith('fst >');
+    this.commandHistoryIndex=null;
+    if(this.homeInput)editor.onChange=text=>{
+      if(this.commandHistoryIndex!==null&&text!==this.commandHistory[this.commandHistoryIndex])this.commandHistoryIndex=null;
+    };
+    if(this.homeInput)this.terminal.write(mouseOn);
+    this.editor=editor;editor.setText(this.homeInput?(this.homeDraft??value):value);
+    if(this.homeInput)this.homeDraft=undefined;
+    if(files||commands.length)editor.setAutocompleteProvider(new FileAutocomplete(commands,this.baseDir,workflows));
     return this.ask(message,editor);
   }
-  select(message,items){
+  async select(message,items){
     if(!items.length)throw new Error('当前没有可选择的项目');
     const list=new SelectList(items.map(i=>({...i,label:safe(i.label).replace(/\s+/g,' '),description:i.description?safe(i.description).replace(/\s+/g,' '):undefined})),8,theme);
     list.render=width=>{
-      const reserved=this.headingLines(width).length+new Text(palette.text(safe(message)),1,0).render(width).length+this.hint.render(width).length+1;
+      const reserved=this.headingLines(width).length+new Text(palette.text(safe(message)),1,0).render(width).length+this.hint.render(width).length+2;
       list.maxVisible=Math.max(1,Math.min(8,this.terminal.rows-reserved));
       const start=Math.max(0,Math.min(list.selectedIndex-Math.floor(list.maxVisible/2),list.filteredItems.length-list.maxVisible));
       const end=Math.min(start+list.maxVisible,list.filteredItems.length),lines=[];
@@ -176,7 +268,12 @@ export class TerminalView{
       if(start>0||end<list.filteredItems.length)lines.push(palette.muted(`   ${list.selectedIndex+1} / ${list.filteredItems.length}`));
       return lines.length?lines:[palette.muted('  没有匹配项')];
     };
-    return this.ask(message,list);
+    const value=await this.ask(message,list);
+    if(this.commandLocation){
+      const item=items.find(item=>item.value===value);
+      if(item&&value!=='back'&&value!=='cancel')this.feed.message(`· ${safe(item.label??item.value)}`);
+    }
+    return value;
   }
   async confirm(message){return await this.select(message,[{value:'no',label:'否，返回'},{value:'yes',label:'是，继续'}])==='yes';}
   busy(message,cancel){

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

@@ -0,0 +1,50 @@
+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?[{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==='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:'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 await session.execute('/'+choice);
+    }catch(error){if(error.code!=='PROMPT_CANCELLED')throw error;}
+  }
+}

package/node_modules/@mytools/core/src/validation.js

@@ -1,27 +1,42 @@
 import Ajv from 'ajv';
 import { FlowError } from '@mytools/sdk';
 
-const ajv = new Ajv({ allErrors: true, strict: false, useDefaults: true });
-const validators = new WeakMap();
-const booleanValidators = new Map();
+const ajv = new Ajv({ allErrors: true, strict: false });
+const validators = {true:new WeakMap(),false:new WeakMap()};
+const booleanValidators = {true:new Map(),false:new Map()};
 export const emptyObject = { type: 'object', properties: {}, additionalProperties: false };
 
-export function assertSchema(schema,label) {
+export function assertSchema(schema,label,{useDefaults=true}={}) {
   if (!(typeof schema==='boolean'||schema&&typeof schema==='object'&&!Array.isArray(schema))) throw new FlowError(`${label} 必须声明有效的 JSON Schema`,{code:'VALIDATION'});
-  const cache=typeof schema==='boolean'?booleanValidators:validators;
+  const cache=(typeof schema==='boolean'?booleanValidators:validators)[Boolean(useDefaults)];
   let check=cache.get(schema);
   if(!check){
-    try{check=ajv.compile(schema);cache.set(schema,check);}
+    // 每份定义独立解析 $id/$ref，避免插件重载或不同插件共用 ID 时串用约束。
+    // 编译结果仍按对象缓存；注册表随校验器释放，不污染后续安装批次。
+    try{check=new Ajv({allErrors:true,strict:false,useDefaults:Boolean(useDefaults)}).compile(schema);cache.set(schema,check);}
     catch(cause){throw new FlowError(`${label} JSON Schema 无效：${cause.message}`,{code:'VALIDATION',cause});}
   }
   return check;
 }
 
-export function validate(schema, value, label) {
+const pointerToken=value=>String(value).replaceAll('~','~0').replaceAll('/','~1');
+function diagnostic(error){
+  let instancePath=error.instancePath;
+  if(error.keyword==='required')instancePath+=`/${pointerToken(error.params.missingProperty)}`;
+  if(error.keyword==='additionalProperties')instancePath+=`/${pointerToken(error.params.additionalProperty)}`;
+  // 保留 Ajv 原有 instancePath 语义，新字段提供指向缺失/额外属性的完整位置。
+  return {...error,jsonPointer:instancePath};
+}
+
+export function validate(schema, value, label,{useDefaults=true}={}) {
   if (schema==null) return structuredClone(value);
-  const check = assertSchema(schema,label);
+  const check = assertSchema(schema,label,{useDefaults});
   const copy = structuredClone(value);
-  if (!check(copy)) throw new FlowError(`${label}: ${ajv.errorsText(check.errors, { separator: '；' })}`, { code: 'VALIDATION', details: check.errors });
+  if (!check(copy)) {
+    const details=check.errors.map(diagnostic);
+    const locations=details.map(error=>`${error.jsonPointer||'/'} (${error.schemaPath})`).join('；');
+    throw new FlowError(`${label}: ${ajv.errorsText(check.errors, { separator: '；' })}；位置 ${locations}`, { code: 'VALIDATION', details });
+  }
   return copy;
 }
 

package/node_modules/@mytools/core/src/version.js

@@ -1,2 +1,2 @@
 // 由 npm version 的生命周期脚本同步，内部插件 API 版本独立维护。
-export const VERSION="0.2.0";
+export const VERSION="0.4.0";

package/node_modules/@mytools/core/src/workflows.js

@@ -4,22 +4,9 @@ import { randomUUID } from 'node:crypto';
 import YAML from 'yaml';
 import { FlowError } from '@mytools/sdk';
 import { assertId, assertSchema, references, referenceParts, emptyObject } from './validation.js';
+import {resolveSchemaPath} from './schema-path.js';
 import {validateCondition,validateStepList} from './control.js';
 
-function fieldSchema(schema,fields,ref){
-  let current=schema;
-  for(const field of fields){
-    if(!current||current===true)return {};
-    if(current.properties&&Object.hasOwn(current.properties,field)){current=current.properties[field];continue;}
-    if(current.type==='array'&&/^\d+$/.test(field)){current=current.items;continue;}
-    if(current.additionalProperties===false||current===false||(current.type&&!['object','array'].includes(current.type))){
-      throw new FlowError(`引用字段不存在：${ref}`,{code:'VALIDATION'});
-    }
-    return {};
-  }
-  return current??{};
-}
-
 export class WorkflowStore {
   constructor(root) { this.root = path.resolve(root); }
   file(id) { assertId(id); return path.join(this.root,`${id}.yaml`); }
@@ -51,6 +38,17 @@ export class WorkflowStore {
     const files=await readdir(this.root);
     return Promise.all(files.filter(f=>f.endsWith('.yaml')).sort().map(f=>this.get(f.slice(0,-5))));
   }
+  async remove(id){
+    await this.get(id);
+    const refers=steps=>steps.some(step=>step.workflow&&this.childId(step.workflow)===id||step.branch&&(refers(step.branch.then)||refers(step.branch.else??[]))||step.parallel&&refers(step.parallel.steps));
+    const dependents=(await this.list()).filter(flow=>flow.id!==id&&refers(flow.steps));
+    if(dependents.length)throw new FlowError(`工作流仍被引用：${dependents.map(flow=>flow.title??flow.id).join('、')}`);
+    const directory=path.join(path.dirname(this.root),'.flow','deleted-workflows');
+    await mkdir(directory,{recursive:true});
+    const backup=path.join(directory,`${id}-${randomUUID()}.yaml`);
+    // 同项目内原子移动，备份保留完整原文；复制回原文件名即可恢复。
+    await rename(this.file(id),backup);return backup;
+  }
   childId(reference) {
     if(typeof reference!=='string' || !/^(\.\/)?[A-Za-z0-9][A-Za-z0-9_-]*\.yaml$/.test(reference)) throw new FlowError(`子流程必须位于工作流目录内：${reference}`,{code:'VALIDATION'});
     return reference.replace(/^\.\//,'').slice(0,-5);
@@ -65,7 +63,7 @@ export class WorkflowStore {
       const checker=previous=>ref=>{
         const p=referenceParts(ref);
         if(p[0]==='steps' && !previous.has(p[1])) throw new FlowError(`${id} 引用必须指向前序步骤：${ref}`,{code:'VALIDATION'});
-        return fieldSchema(p[0]==='inputs'?(w.inputs??emptyObject):previous.get(p[1]),p.slice(p[0]==='inputs'?1:3),ref);
+        return resolveSchemaPath(p[0]==='inputs'?(w.inputs??emptyObject):previous.get(p[1]),p.slice(p[0]==='inputs'?1:3),ref);
       };
       const resolveList=async(steps,inherited=new Map(),parallel=false)=>{
         const previous=new Map(inherited),own={};

package/node_modules/@mytools/pack/dependencies.js

@@ -24,7 +24,12 @@ export async function collectPackages(roots) {
     }
     if(!trees.has(base))trees.set(base,await new Arborist({path:base}).loadActual());
     const tree=trees.get(base);
-    const found=[...tree.inventory.values()].find(n=>n.realpath===root && !n.isLink);
+    let found=[...tree.inventory.values()].find(n=>path.relative(n.realpath,root)==='' && !n.isLink);
+    // 开发引用可能嵌套在无关项目下，其上层 lock 不代表当前插件属于该依赖树。
+    if(!found&&base!==root){
+      if(!trees.has(root))trees.set(root,await new Arborist({path:root}).loadActual());
+      found=[...trees.get(root).inventory.values()].find(n=>path.relative(n.realpath,root)===''&&!n.isLink);
+    }
     if(!found)throw new FlowError(`无法解析包的生产依赖：${root}`);
     return found;
   }
@@ -66,6 +71,8 @@ export async function copyPackages(nodes,destination,target,{filters=new Map()}=
     const filter=filters.get(packageRoot);
     const files=[...new Set([...await packlist(await new Arborist({path:packageRoot}).loadActual()),...(filter?.extraFiles??[])])];
     for(const file of files){
+      // 项目可以与开发插件共用根目录；宿主私有状态和安装批次永远不进入插件快照。
+      if(file.split(/[\\/]/)[0]==='.flow')continue;
       if(filter&&!filter.include(file))continue;
       const source=path.resolve(packageRoot,file),physical=await realpath(source);
       // 两端先解析实际路径，再按系统规则比较，兼容 Windows 大小写、短路径和目录联接。

package/node_modules/@mytools/pack/index.js

@@ -26,10 +26,12 @@ async function prepare(app,{entries,target,includeWeb=false,portable=false,envir
   if(!portable&&!entries?.length)throw new FlowError('请至少选择一个工作流');
   if(!['win32-x64','linux-x64-glibc'].includes(target))throw new FlowError('请选择支持的目标平台');
   const closure=await app.store.resolve(entries,app.host);
-  const ids=new Set(portable?[...app.host.definitions.keys()].filter(id=>id!=='@mytools/web'||includeWeb):closure.plugins);
+  const webProvider=[...app.host.definitions.values()].find(plugin=>typeof plugin.services?.web==='function');
+  const ids=new Set(portable?[...app.host.definitions.keys()].filter(id=>id!==webProvider?.id||includeWeb):closure.plugins);
   for(const id of closure.plugins)ids.add(id);
+  if(includeWeb){if(!webProvider)throw new FlowError('未安装提供 Web 服务的插件');ids.add(webProvider.id);}
+  // Web 与其他入口使用相同的依赖闭包，包含提供者自身的传递依赖。
   for(const id of ids)for(const dependency of Object.keys(app.host.definitions.get(id)?.dependencies??{}))ids.add(dependency);
-  if(includeWeb){if(!app.host.definitions.has('@mytools/web'))throw new FlowError('未安装官方 Web 插件');ids.add('@mytools/web');}
   const plugins=[...ids].map(id=>app.host.definitions.get(id));
   if(plugins.some(p=>!p.root))throw new FlowError('内存中临时定义的插件不能打包，请先安装为标准包');
   const overrides=structuredClone(app.project.environments??{});