nx-mcp-server 1.0.0

package/src/providers/tongyi.js

@@ -0,0 +1,153 @@
+import axios from 'axios';
+import {readFileSync,existsSync} from 'fs';
+import {dirname,join} from 'path';
+import {fileURLToPath} from 'url';
+
+// 通义万相 API Provider
+// API Key 四种传入方式，按优先级排序：
+//   1. apiKey 工具参数（每次调用动态传入）
+//   2. DASHSCOPE_API_KEY 环境变量（shell 或 MCP settings.json env）
+//   3. config.json 配置文件（项目根目录，适合本地开发）
+//   4. 无 Key → 报错提示
+// 参考文档: https://help.aliyun.com/zh/model-studio/
+
+const BASE_URL='https://dashscope.aliyuncs.com/api/v1';
+const __dirname=dirname(fileURLToPath(import.meta.url));
+const CONFIG_PATH=join(__dirname,'..','..','config.json');
+
+function getApiKey(){
+  // 优先级 2: 环境变量
+  const envKey=process.env.DASHSCOPE_API_KEY||'';
+  if(envKey) return envKey;
+
+  // 优先级 3: config.json
+  try{
+    if(existsSync(CONFIG_PATH)){
+      const cfg=JSON.parse(readFileSync(CONFIG_PATH,'utf-8'));
+      const cfgKey=cfg.dashscope_api_key||cfg.DASHSCOPE_API_KEY||'';
+      if(cfgKey) return cfgKey;
+    }
+  }catch(e){/* 配置文件不存在或格式错误，忽略 */}
+
+  return '';
+}
+
+// 风格预设映射到通义万相参数
+const styleMap={
+  'photorealistic':'<photorealistic>',
+  'anime':'<anime>',
+  'oil-painting':'<oil painting>',
+  'watercolor':'<watercolor>',
+  '3d-render':'<3d render>',
+  'sketch':'<sketch>',
+  'flat-illustration':'<flat illustration>',
+};
+
+// 智能生图：调用通义万相文本生成图像 API
+export async function tongyiText2Image({
+  apiKey='',
+  prompt,
+  negativePrompt='',
+  width=1024,
+  height=1024,
+  style='',
+  model='wanx-v1',
+  numImages=1,
+}){
+  const key=apiKey||getApiKey();
+  if(!key){
+    throw new Error('缺少通义千问 API Key。四种传入方式（按优先级）：\n  1. 调用 generate_smart 时传入 apiKey 参数（动态）\n  2. 设置环境变量 DASHSCOPE_API_KEY\n  3. 项目根目录 config.json 中配置 dashscope_api_key\n  4. MCP settings.json 的 env 中注入 DASHSCOPE_API_KEY');
+  }
+
+  // 拼接风格提示词
+  const styleTag=styleMap[style]||'';
+  const fullPrompt=styleTag?`${styleTag} ${prompt}`:prompt;
+
+  // 通义万相 v1 支持的尺寸
+  const validSizes=['1024*1024','720*1280','1280*720'];
+  let size='1024*1024';
+  if(width===720&&height===1280) size='720*1280';
+  else if(width===1280&&height===720) size='1280*720';
+  else if(width===1024&&height===1024) size='1024*1024';
+  else{
+    // 选择最接近的尺寸
+    const ratios=validSizes.map(s=>{
+      const [w,h]=s.split('*').map(Number);
+      return {size:s,diff:Math.abs(w-width)+Math.abs(h-height)};
+    });
+    size=ratios.sort((a,b)=>a.diff-b.diff)[0].size;
+  }
+
+  const tasks=[];
+  for(let i=0;i<numImages;i++){
+    tasks.push(submitTask(fullPrompt,negativePrompt,size,model,key));
+  }
+
+  const results=await Promise.all(tasks);
+  return {
+    model,
+    prompt:fullPrompt,
+    images:results.filter(Boolean),
+    count:results.filter(Boolean).length,
+    provider:'tongyi-wanxiang',
+  };
+}
+
+async function submitTask(prompt,negativePrompt,size,model,apiKey){
+  try{
+    // 提交任务
+    const submitRes=await axios.post(
+      `${BASE_URL}/services/aigc/text2image/image-synthesis`,
+      {
+        model,
+        input:{prompt,negative_prompt:negativePrompt},
+        parameters:{size,n:1,watermark:false},
+      },
+      {headers:{'Authorization':`Bearer ${apiKey}`,'Content-Type':'application/json','X-DashScope-Async':'enable'},timeout:30000},
+    );
+
+    const taskId=submitRes.data?.output?.task_id;
+    if(!taskId) throw new Error(`任务提交失败: ${JSON.stringify(submitRes.data)}`);
+
+    // 轮询等待结果
+    const imageUrl=await pollTask(taskId,apiKey);
+    return imageUrl;
+  }catch(err){
+    if(err.response){
+      const msg=err.response.data?.message||err.message;
+      throw new Error(`通义万相 API 错误: ${msg}`);
+    }
+    throw err;
+  }
+}
+
+async function pollTask(taskId,apiKey,maxRetries=30,interval=2000){
+  for(let i=0;i<maxRetries;i++){
+    await sleep(interval);
+    try{
+      const res=await axios.get(
+        `${BASE_URL}/tasks/${taskId}`,
+        {headers:{'Authorization':`Bearer ${apiKey}`}},
+      );
+
+      const status=res.data?.output?.task_status;
+      if(status==='SUCCEEDED'){
+        const results=res.data?.output?.results;
+        if(results&&results.length>0) return results[0].url;
+        throw new Error('任务完成但无结果');
+      }
+      if(status==='FAILED'){
+        throw new Error(`任务失败: ${res.data?.output?.message||'未知错误'}`);
+      }
+      // PENDING / RUNNING → 继续等待
+    }catch(err){
+      if(err.message.includes('任务失败')) throw err;
+      // 网络错误继续重试
+    }
+  }
+  throw new Error(`任务超时: ${taskId}`);
+}
+
+function sleep(ms){
+  return new Promise(r=>setTimeout(r,ms));
+}

package/src/tools/barcode.js

@@ -0,0 +1,176 @@
+import sharp from 'sharp';
+import {saveOutput} from '../utils/output.js';
+
+// 纯 SVG 条形码生成，无需 canvas/jsBarcode
+
+const ENCODINGS={
+  CODE128:encodeCode128,
+  CODE39:encodeCode39,
+  EAN13:encodeEAN,
+  EAN8:encodeEAN,
+  UPC:encodeEAN,
+};
+
+export async function generateBarcode(args){
+  const {content,format='CODE128',width=400,height=100,displayValue=true,fontSize=16,outputDir}=args;
+
+  const encode=ENCODINGS[format]||encodeCode128;
+  const bars=encode(content);
+
+  if(!bars||bars.length===0){
+    throw new Error(`无法编码内容 "${content}" 为 ${format}`);
+  }
+
+  // 计算条码区域
+  const textHeight=displayValue?fontSize+10:0;
+  const barHeight=height-textHeight-10;
+  const totalBars=bars.reduce((s,b)=>s+(b.width||1),0);
+  const barUnitWidth=Math.max(1,Math.floor((width-20)/totalBars));
+
+  // 生成 SVG
+  let svg=`<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}">`;
+  svg+=`<rect width="${width}" height="${height}" fill="#ffffff"/>`;
+
+  let x=10;
+  for(const bar of bars){
+    const bw=bar.width*barUnitWidth;
+    if(bar.color==='black'){
+      svg+=`<rect x="${x}" y="5" width="${bw}" height="${barHeight}" fill="#000000"/>`;
+    }
+    x+=bw;
+  }
+
+  if(displayValue){
+    const textY=height-5;
+    svg+=`<text x="${width/2}" y="${textY}" font-size="${fontSize}" fill="#000000" text-anchor="middle" font-family="monospace">${content}</text>`;
+  }
+
+  svg+='</svg>';
+
+  const buf=await sharp(Buffer.from(svg)).png().toBuffer();
+  const saved=await saveOutput(buf,'barcode.png',outputDir,'url');
+
+  return {
+    success:true,
+    ...saved,
+    content,
+    format,
+  };
+}
+
+// ===== 编码实现 =====
+
+// Code128 基础编码
+function encodeCode128(text){
+  // 简化为 Code128B 子集（支持 ASCII 32-126）
+  const chars=[];
+  for(let i=0;i<text.length;i++){
+    const code=text.charCodeAt(i);
+    if(code<32||code>126){
+      throw new Error(`Code128B 不支持字符: ${text[i]}`);
+    }
+    chars.push(code-32);
+  }
+
+  let checksum=104;// Start B
+  for(let i=0;i<chars.length;i++){
+    checksum+=chars[i]*(i+1);
+  }
+  checksum%=103;
+
+  // 生成条码图案 (简化版: 每字符=11单元，条形=黑，空=白)
+  const bars=[];
+  // 起始符 (Start B)
+  bars.push(...code128Pattern(104));
+  for(const c of chars){
+    bars.push(...code128Pattern(c));
+  }
+  // 校验符
+  bars.push(...code128Pattern(checksum));
+  // 终止符
+  bars.push(...code128Pattern(106));
+
+  // 转换为 {color, width} 格式
+  const result=[];
+  for(let i=0;i<bars.length;i++){
+    const color=i%2===0?'black':'white';
+    result.push({color,width:bars[i]});
+  }
+  return result;
+}
+
+function code128Pattern(code){
+  // 简化版 Code128 条码图案 (0-106)
+  const patterns=[
+    [2,1,2,2,2,2],[2,2,2,1,2,2],[2,2,2,2,2,1],[1,2,1,2,2,3],[1,2,1,3,2,2],
+    [1,3,1,2,2,2],[1,2,2,2,1,3],[1,2,2,3,1,2],[1,3,2,2,1,2],[2,2,1,2,1,3],
+    [2,2,1,3,1,2],[2,3,1,2,1,2],[1,1,2,2,3,2],[1,2,2,1,3,2],[1,2,2,2,3,1],
+    [1,1,3,2,2,2],[1,2,3,1,2,2],[1,2,3,2,2,1],[2,2,3,2,1,1],[2,2,1,1,3,2],
+    [2,2,1,2,3,1],[2,1,3,2,1,2],[2,2,3,1,1,2],[3,1,2,1,3,1],[3,1,1,2,2,2],
+    [3,2,1,1,2,2],[3,2,1,2,2,1],[3,1,2,2,1,2],[3,2,2,1,1,2],[3,2,2,2,1,1],
+    [2,1,2,1,2,3],[2,1,2,3,2,1],[2,3,2,1,2,1],[1,1,1,3,2,3],[1,3,1,1,2,3],
+    [1,3,1,3,2,1],[1,1,2,3,1,3],[1,3,2,1,1,3],[1,3,2,3,1,1],[2,1,1,3,1,3],
+    [2,3,1,1,1,3],[2,3,1,3,1,1],[1,1,2,1,3,3],[1,1,2,3,3,1],[1,3,2,1,3,1],
+    [1,1,3,1,2,3],[1,1,3,3,2,1],[1,3,3,1,2,1],[3,1,3,1,2,1],[2,1,1,3,3,1],
+    [2,3,1,1,3,1],[2,1,3,1,1,3],[2,1,3,3,1,1],[2,1,3,1,3,1],[3,1,1,1,2,3],
+    [3,1,1,3,2,1],[3,3,1,1,2,1],[3,1,2,1,1,3],[3,1,2,3,1,1],[3,3,2,1,1,1],
+    [3,1,4,1,1,1],[2,2,1,4,1,2],[2,2,1,2,1,4],[2,4,1,2,1,2],[2,2,1,2,3,2],
+    [2,2,3,2,1,2],[2,4,3,2,1,1],[2,2,1,1,2,4],[2,4,1,1,2,2],[2,2,1,2,2,4],
+    [2,4,1,2,2,2],[2,2,1,4,1,2],[2,2,1,4,2,1],[2,1,1,4,2,2],[2,4,1,1,2,2],
+    [2,1,4,2,1,2],[2,2,4,1,1,2],[2,2,4,2,1,1],[1,4,1,2,1,2],[1,4,1,2,2,1],
+    [1,4,1,2,1,2],[1,2,4,1,1,2],[1,2,4,2,1,1],[1,1,4,2,1,2],[1,2,1,4,2,1],
+    [2,1,1,2,1,4],[2,1,1,4,1,2],[2,1,1,2,3,2],[2,3,3,1,1,1,2],[1,2,4,1,1,1,2],
+    [4,1,1,1,1,2],[4,1,1,1,1,1,1],[4,3,1,1,1,1],[1,1,4,1,1,1,2],[1,1,4,1,1,1,1,1],
+    [4,1,1,1,3,1],[4,1,1,3,1,1],[1,1,4,1,3,1],[1,1,4,3,1,1],[4,1,1,1,1,3],
+    [4,1,1,3,1,1],[1,1,1,1,4,3],[1,1,1,3,4,1],[1,3,1,1,4,1],[1,1,4,1,1,3],
+    [1,1,4,3,1,1],[3,1,1,1,4,1],[4,1,1,1,1,3],[2,1,1,4,1,2],[2,1,1,2,1,4],
+    [2,1,1,2,3,2],[2,3,3,1,1,1,2],[2,3,3,1,1,1,2],[2,3,3,1,1,1,2],
+  ];
+  return patterns[code%patterns.length]||patterns[0];
+}
+
+// Code39 编码
+function encodeCode39(text){
+  const map={'0':'101001101101','1':'110100101011','2':'101100101011','3':'110110010101','4':'101001101011','5':'110100110101','6':'101100110101','7':'101001011011','8':'110100101101','9':'101100101101','A':'110101001011','B':'101101001011','C':'110110100101','D':'101011001011','E':'110101100101','F':'101101100101','G':'101010011011','H':'110101001101','I':'101101001101','J':'101011001101','K':'110101010011','L':'101101010011','M':'110110101001','N':'101011010011','O':'110101101001','P':'101101101001','Q':'101010110011','R':'110101011001','S':'101101011001','T':'101011011001','U':'110010101011','V':'100110101011','W':'110011010101','X':'100101101011','Y':'110010110101','Z':'100110110101','-':'100101011011','.':'110010101101',' ':'100110101101','$':'100100100101','/':'100100101001','+':'100101001001','%':'101001001001','*':'100101101101'};
+
+  const s=`*${text.toUpperCase()}*`;
+  const result=[];
+  for(let i=0;i<s.length;i++){
+    const pattern=map[s[i]];
+    if(!pattern) throw new Error(`Code39 不支持字符: ${s[i]}`);
+    for(let j=0;j<pattern.length;j++){
+      result.push({color:j%2===0?'black':'white',width:pattern[j]==='1'?2:1});
+    }
+    // 字符间间隔
+    if(i<s.length-1) result.push({color:'white',width:1});
+  }
+  return result;
+}
+
+// EAN-13 / EAN-8 编码
+function encodeEAN(text){
+  const digits=text.replace(/[^0-9]/g,'');
+  // 简化实现：直接生成条码图案
+  const L=['0001101','0011001','0010011','0111101','0100011','0110001','0101111','0111011','0110111','0001011'];
+  const R=['1110010','1100110','1101100','1000010','1011100','1001110','1010000','1000100','1001000','1110100'];
+
+  const bars=[];
+  // 起始符
+  const start='101';
+  for(const c of start) bars.push({color:c==='1'?'black':'white',width:1});
+
+  for(let i=0;i<digits.length;i++){
+    const d=parseInt(digits[i]);
+    const pattern=i<7?L[d]:R[d];
+    for(const c of pattern) bars.push({color:c==='1'?'black':'white',width:1});
+    if(i===6){
+      // 中间分隔
+      for(const c of '01010') bars.push({color:c==='1'?'black':'white',width:1});
+    }
+  }
+
+  // 终止符
+  for(const c of start) bars.push({color:c==='1'?'black':'white',width:1});
+
+  return bars;
+}

package/src/tools/basic.js

@@ -0,0 +1,121 @@
+import sharp from 'sharp';
+import {saveOutput,loadImage,parseColor} from '../utils/output.js';
+import {gradientSvg,solidBgSvg} from '../utils/gradient.js';
+
+export async function generateBasic(args){
+  const {width=800,height=600,background,shapes=[],texts=[],images=[],border,format='png',quality=90,outputDir}=args;
+  const layers=[];
+
+  // 1. 构建背景
+  if(typeof background==='string'&&background.startsWith('{')) return {};  // No content yet
+  let bgBuffer;
+  if(!background||background==='transparent'){
+    bgBuffer=Buffer.from(`<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}"><rect width="100%" height="100%" fill="transparent"/></svg>`);
+  }else if(typeof background==='string'){
+    bgBuffer=solidBgSvg(width,height,background);
+  }else if(typeof background==='object'){
+    bgBuffer=gradientSvg(width,height,background)||solidBgSvg(width,height,'#ffffff');
+  }else{
+    bgBuffer=solidBgSvg(width,height,'#ffffff');
+  }
+  layers.push({input:bgBuffer});
+
+  // 2. 合成图形和文字为 SVG 叠加层
+  if(shapes.length>0||texts.length>0){
+    let svg=`<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}">`;
+    for(const s of shapes){
+      svg+=renderShape(s);
+    }
+    for(const t of texts){
+      svg+=renderText(t);
+    }
+    svg+='</svg>';
+    layers.push({input:Buffer.from(svg)});
+  }
+
+  // 3. 叠加外部图片
+  for(const img of images||[]){
+    const overlay=await loadImage(img.src);
+    let processed=overlay;
+    if(img.width||img.height){
+      processed=overlay.resize(img.width||null,img.height||null,{fit:'inside'});
+    }
+    const buf=await processed.png().toBuffer();
+    layers.push({
+      input:buf,
+      top:img.y||0,
+      left:img.x||0,
+    });
+  }
+
+  // 4. 合并图层
+  let composite=sharp({create:{width,height,channels:4,background:parseColor(background==='transparent'?'transparent':'#ffffff')}});
+  if(layers.length>0){
+    composite=composite.composite(layers.map(l=>({...l,blend:'over'})));
+  }
+
+  let pipeline=composite;
+
+  // 5. 边框
+  if(border){
+    const bw=border.width||2;
+    const bc=border.color||'#000000';
+    const br=border.radius||0;
+    if(br>0){
+      const svg=Buffer.from(`<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}"><rect x="${bw/2}" y="${bw/2}" width="${width-bw}" height="${height-bw}" rx="${br}" ry="${br}" fill="none" stroke="${bc}" stroke-width="${bw}"/></svg>`);
+      pipeline=pipeline.composite([{input:svg,blend:'over'}]);
+    }
+  }
+
+  // 6. 输出
+  if(format==='jpeg'){
+    pipeline=pipeline.jpeg({quality});
+  }else if(format==='webp'){
+    pipeline=pipeline.webp({quality});
+  }else{
+    pipeline=pipeline.png();
+  }
+
+  const buffer=await pipeline.toBuffer();
+  const filename=`basic.${format}`;
+  const saved=await saveOutput(buffer,filename,outputDir,'url');
+
+  return {
+    success:true,
+    ...saved,
+    width,
+    height,
+    format,
+    shapesCount:shapes.length,
+    textsCount:texts.length,
+    imagesCount:(images||[]).length,
+  };
+}
+
+function renderShape(s){
+  const attrs=[];
+  if(s.fill) attrs.push(`fill="${s.fill}"`);
+  if(s.stroke) attrs.push(`stroke="${s.stroke}" stroke-width="${s.strokeWidth||1}"`);
+  switch(s.type){
+    case'rect':
+      return `<rect x="${s.x||0}" y="${s.y||0}" width="${s.w||100}" height="${s.h||100}" rx="${s.r||0}" ${attrs.join(' ')}/>`;
+    case'circle':
+      return `<circle cx="${s.x||0}" cy="${s.y||0}" r="${s.r||50}" ${attrs.join(' ')}/>`;
+    case'ellipse':
+      return `<ellipse cx="${s.x||0}" cy="${s.y||0}" rx="${s.r||50}" ry="${s.ry||30}" ${attrs.join(' ')}/>`;
+    case'line':
+      return `<line x1="${s.x||0}" y1="${s.y||0}" x2="${s.x2||100}" y2="${s.y2||100}" stroke="${s.stroke||'#000'}" stroke-width="${s.strokeWidth||1}"/>`;
+    case'polygon':
+      return `<polygon points="${(s.points||[]).map(p=>`${p.x},${p.y}`).join(' ')}" ${attrs.join(' ')}/>`;
+    default:
+      return '';
+  }
+}
+
+function renderText(t){
+  return `<text x="${t.x}" y="${t.y}" font-size="${t.fontSize||24}" fill="${t.color||'#000'}" font-family="${t.fontFamily||'sans-serif'}" text-anchor="${t.align||'start'}" ${t.maxWidth?`textLength="${t.maxWidth}" lengthAdjust="spacing"`:''}>${escapeXml(t.content)}</text>`;
+}
+
+function escapeXml(s){
+  return s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
+}

package/src/tools/colors.js

@@ -0,0 +1,83 @@
+import sharp from 'sharp';
+import {loadImage} from '../utils/output.js';
+
+export async function extractColors(args){
+  const {src,count=5,format='hex'}={...args};
+
+  // 缩小图片提高取色速度
+  const img=await loadImage(src);
+  const meta=await img.metadata();
+  const smallBuf=await img.resize(200,200,{fit:'inside'}).raw().toBuffer({resolveWithObject:true});
+  const {data,info}=smallBuf;
+
+  // 简单颜色量化：使用 K-means 启发式
+  const pixels=[];
+  const step=Math.max(1,Math.floor((info.width*info.height)/(10000)));
+  for(let i=0;i<data.length;i+=info.channels*step){
+    const r=data[i],g=data[i+1],b=data[i+2],a=data[i+3]||255;
+    if(a<128) continue;// 跳过透明像素
+    pixels.push([r,g,b]);
+  }
+
+  const palette=quantize(pixels,count);
+
+  const colors=palette.map(([r,g,b])=>{
+    if(format==='hsl'){
+      return rgbToHsl(r,g,b);
+    }
+    if(format==='rgb'){
+      return `rgb(${r},${g},${b})`;
+    }
+    // hex
+    return `#${r.toString(16).padStart(2,'0')}${g.toString(16).padStart(2,'0')}${b.toString(16).padStart(2,'0')}`;
+  });
+
+  return {
+    success:true,
+    colors,
+    count:colors.length,
+    format,
+  };
+}
+
+// 简易中位切分量化算法提取主色调
+function quantize(pixels,k){
+  if(pixels.length<=k) return pixels;
+
+  // 用颜色频次直方图简化
+  const bins=new Map();
+  for(const p of pixels){
+    // 量化到 32 级减少 bin 数
+    const key=`${Math.floor(p[0]/32)},${Math.floor(p[1]/32)},${Math.floor(p[2]/32)}`;
+    if(!bins.has(key)){
+      bins.set(key,{sum:[0,0,0],count:0});
+    }
+    const b=bins.get(key);
+    b.sum=[b.sum[0]+p[0],b.sum[1]+p[1],b.sum[2]+p[2]];
+    b.count++;
+  }
+
+  // 按像素数排序取前 k 个
+  const sorted=[...bins.values()].sort((a,b)=>b.count-a.count).slice(0,k);
+  return sorted.map(b=>[
+    Math.round(b.sum[0]/b.count),
+    Math.round(b.sum[1]/b.count),
+    Math.round(b.sum[2]/b.count),
+  ]);
+}
+
+function rgbToHsl(r,g,b){
+  const rf=r/255,gf=g/255,bf=b/255;
+  const max=Math.max(rf,gf,bf),min=Math.min(rf,gf,bf);
+  let h=0,s=0,l=(max+min)/2;
+  if(max!==min){
+    const d=max-min;
+    s=l>0.5?d/(2-max-min):d/(max+min);
+    switch(max){
+      case rf:h=((gf-bf)/d+(gf<bf?6:0))/6;break;
+      case gf:h=((bf-rf)/d+2)/6;break;
+      case bf:h=((rf-gf)/d+4)/6;break;
+    }
+  }
+  return `hsl(${Math.round(h*360)},${Math.round(s*100)}%,${Math.round(l*100)}%)`;
+}

package/src/tools/compress.js

@@ -0,0 +1,31 @@
+import {saveOutput,loadImage} from '../utils/output.js';
+
+export async function compressImage(args){
+  const {src,quality=80,maxWidth,maxHeight,format='jpeg',outputDir}=args;
+
+  let pipeline=await loadImage(src);
+  const meta=await pipeline.metadata();
+
+  // 等比缩放
+  if(maxWidth||maxHeight){
+    pipeline=pipeline.resize(maxWidth||null,maxHeight||null,{fit:'inside',withoutEnlargement:true});
+  }
+
+  // 格式与质量
+  if(format==='jpeg') pipeline=pipeline.jpeg({quality});
+  else if(format==='webp') pipeline=pipeline.webp({quality});
+  else pipeline=pipeline.png({quality});
+
+  const buffer=await pipeline.toBuffer();
+  const filename=`compressed.${format}`;
+  const saved=await saveOutput(buffer,filename,outputDir,'url');
+
+  return {
+    success:true,
+    ...saved,
+    compressedSize:buffer.length,
+    width:meta.width,
+    height:meta.height,
+    quality,
+  };
+}

package/src/tools/convert.js

@@ -0,0 +1,48 @@
+import sharp from 'sharp';
+import {saveOutput,loadImage} from '../utils/output.js';
+
+const FORMATS=['png','jpeg','webp','bmp','tiff','avif'];
+
+export async function convertFormat(args){
+  const {src,format,quality=90,background='#ffffff',outputDir}=args;
+
+  if(!FORMATS.includes(format)){
+    throw new Error(`不支持的格式: ${format}。支持: ${FORMATS.join(', ')}`);
+  }
+
+  let pipeline=await loadImage(src);
+  const meta=await pipeline.metadata();
+
+  // 格式转换
+  if(format==='jpeg'){
+    // 处理透明背景
+    const hasAlpha=meta.hasAlpha||meta.channels===4;
+    if(hasAlpha){
+      pipeline=pipeline.flatten({background});
+    }
+    pipeline=pipeline.jpeg({quality});
+  }else if(format==='webp'){
+    pipeline=pipeline.webp({quality});
+  }else if(format==='png'){
+    pipeline=pipeline.png();
+  }else if(format==='bmp'){
+    pipeline=pipeline.bmp();
+  }else if(format==='tiff'){
+    pipeline=pipeline.tiff();
+  }else if(format==='avif'){
+    pipeline=pipeline.avif({quality});
+  }
+
+  const buffer=await pipeline.toBuffer();
+  const filename=`converted.${format}`;
+  const saved=await saveOutput(buffer,filename,outputDir,'url');
+
+  return {
+    success:true,
+    ...saved,
+    originalFormat:meta.format,
+    targetFormat:format,
+    width:meta.width,
+    height:meta.height,
+  };
+}