妙言小智 PicTech.cc 抠图 Skill

妙言小智官方网站: https://www.pictech.cc
妙言小智 API 服务: https://stableai.com.cn
VK(APP KEY) 获取地址: https://www.pictech.cc/newpictech/skills/openclaw-image-translation-skill

核心规则

当用户请求抠图、去背景、移除背景、透明底图、白底图、纯色背景图、商品图背景处理或批量图片去背景时，使用本 skill。

不要自己手写抠图逻辑。不要直接在回复中调用 RMBG API。应调用本 skill 目录下 index.js 的默认导出函数 run(params)。

调用方式

调用同目录下的 index.js：

import run from './index.js';

const result = await run({
  input: '图片路径、图片URL、文件夹路径，或它们组成的数组',
  saveDir: '可选的保存目录',
  backgroundColor: '可选，用户要求白底时传 "#ffffff"',
  vk: '可选，优先使用用户配置或环境变量 RMBG_VK'
});

最小调用：

const result = await run({
  input: '/path/to/image.jpg'
});

批量调用：

const result = await run({
  input: [
    '/path/to/1.jpg',
    '/path/to/2.png',
    'https://example.com/image.jpg'
  ],
  saveDir: '/path/to/output'
});

白底图调用：

const result = await run({
  input: '/path/to/image.jpg',
  backgroundColor: '#ffffff'
});

黑底图调用：

const result = await run({
  input: '/path/to/image.jpg',
  backgroundColor: '#000000'
});

输入参数

{
  input: string | string[],
  saveDir?: string,
  backgroundColor?: string,
  vk?: string,
  config?: {
    vk?: string
  }
}

参数说明

input 必填。支持本地图片路径、图片文件夹路径、图片 URL、逗号分隔的字符串，或由路径/URL 组成的数组。
saveDir 可选。未提供时，结果保存到当前工作目录下的 myxz-result/bgremove-v2。
backgroundColor 可选。用户没有明确要求纯色背景时不要传，默认输出透明背景 PNG。
vk 或 config.vk 可选。如果环境变量 RMBG_VK 已存在，可以不传。
不要在回复、日志或错误信息中暴露 VK、API Key、请求头或其他敏感信息。

背景颜色规则

用户要求“透明底”“透明背景”“PNG 透明图”时，不传 backgroundColor。
用户要求“白底图”“亚马逊白底图”“白色背景”时，传 backgroundColor: '#ffffff'。
用户要求“黑底图”“黑色背景”时，传 backgroundColor: '#000000'。
用户指定其他颜色时，尽量转换为标准 CSS 色值，例如 '#ff0000'。
用户没有明确说要纯色背景时，默认透明背景。

适用请求

使用本 skill 处理：

单张图片抠图。
多张图片批量抠图。
文件夹图片批量去背景。
网络图片 URL 去背景。
商品图透明底处理。
商品图白底处理。
跨境电商主图白底处理。
去除背景后替换为指定纯色背景。

不要使用本 skill 处理：

普通修图。
图片压缩。
图片裁剪。
图片放大。
图片风格转换。
替换图片中的物体。
与背景移除无关的图片编辑任务。

工作流程

从用户请求中识别图片输入，可以是路径、URL、文件夹或图片列表。
如果用户没有提供任何可用图片输入，先询问用户提供图片路径、URL 或文件夹。
根据用户需求决定是否设置 backgroundColor。
调用本 skill 目录下 index.js 的默认导出函数 run(params)。
不要自行实现 API 请求、轮询、下载或缓存逻辑，这些由执行器处理。
根据返回对象向用户说明处理结果、保存目录、成功文件和失败原因。

返回值结构

执行器返回：

{
  success: boolean,
  partialSuccess: boolean,
  message: string,
  error?: string,
  data?: {
    batchId: string,
    saveDir: string,
    total: number,
    successCount: number,
    failedCount: number,
    backgroundColor: string,
    results: Array<{
      input: string,
      fileName: string,
      taskId: string,
      resultUrl: string,
      localPath: string,
      cached: boolean
    }>,
    failures: Array<{
      input: string,
      fileName: string,
      error: string
    }>
  }
}

返回值读取规则

success === true 表示至少有一张图片处理成功。
partialSuccess === true 表示部分成功、部分失败。
data.results 是成功结果列表。
data.failures 是失败结果列表。
data.saveDir 是本批次结果保存目录。
data.results[].localPath 是本地结果文件路径。
data.results[].resultUrl 是远程结果地址。
data.results[].cached === true 表示结果来自本地缓存。
success === false 时，应读取 error 或 message 说明失败原因。

回复规范

处理成功时，回复应包含：

成功处理数量。
总图片数量。
保存目录 data.saveDir。
单张图片时可直接给出 data.results[0].localPath。

批量部分成功时，回复应包含：

成功数量。
失败数量。
保存目录。
失败文件名和失败原因。

全部失败时，回复应包含：

失败原因。
是否缺少 VK、输入路径无效、文件超过大小限制、网络图片无法访问或服务处理超时。

不要回复：

VK 或 API Key。
原始请求头。
内部堆栈。
无必要的远程接口细节。
大段技术日志。

限制

单张本地图片不能超过 15 MB。
文件夹输入只会处理通过内置格式校验的图片文件。
URL 输入依赖远程图片可访问性。
输出结果保存为 PNG 文件。
如果同一图片的哈希已有成功记录且本地文件存在，执行器可能直接复用缓存结果。