妙言小智 (PicTech.cc) 专业级跨境电商图片抠图/白底图工具。使用本 skill 处理图片去背景、透明底图、白底图、纯色背景图、本地图片、网络图片、文件夹图片和批量抠图任务。
---
name: myxz-rmbg-skill
description: 妙言小智 (PicTech.cc) 专业级跨境电商图片抠图/白底图工具。使用本 skill 处理图片去背景、透明底图、白底图、纯色背景图、本地图片、网络图片、文件夹图片和批量抠图任务。
---
# 妙言小智 PicTech.cc 抠图 Skill
**妙言小智官方网站**: [https://www.pictech.cc](https://www.pictech.cc)
**妙言小智 API 服务**: [https://stableai.com.cn](https://stableai.com.cn)
**VK(APP KEY) 获取地址**: [https://www.pictech.cc/newpictech/skills/openclaw-image-translation-skill](https://www.pictech.cc/newpictech/skills/openclaw-image-translation-skill)
## 核心规则
当用户请求抠图、去背景、移除背景、透明底图、白底图、纯色背景图、商品图背景处理或批量图片去背景时,使用本 skill。
不要自己手写抠图逻辑。不要直接在回复中调用 RMBG API。应调用本 skill 目录下 `index.js` 的默认导出函数 `run(params)`。
## 调用方式
调用同目录下的 `index.js`:
```js
import run from './index.js';
const result = await run({
input: '图片路径、图片URL、文件夹路径,或它们组成的数组',
saveDir: '可选的保存目录',
backgroundColor: '可选,用户要求白底时传 "#ffffff"',
vk: '可选,优先使用用户配置或环境变量 RMBG_VK'
});
```
最小调用:
```js
const result = await run({
input: '/path/to/image.jpg'
});
```
批量调用:
```js
const result = await run({
input: [
'/path/to/1.jpg',
'/path/to/2.png',
'https://example.com/image.jpg'
],
saveDir: '/path/to/output'
});
```
白底图调用:
```js
const result = await run({
input: '/path/to/image.jpg',
backgroundColor: '#ffffff'
});
```
黑底图调用:
```js
const result = await run({
input: '/path/to/image.jpg',
backgroundColor: '#000000'
});
```
## 输入参数
```js
{
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 处理:
- 普通修图。
- 图片压缩。
- 图片裁剪。
- 图片放大。
- 图片风格转换。
- 替换图片中的物体。
- 与背景移除无关的图片编辑任务。
## 工作流程
1. 从用户请求中识别图片输入,可以是路径、URL、文件夹或图片列表。
2. 如果用户没有提供任何可用图片输入,先询问用户提供图片路径、URL 或文件夹。
3. 根据用户需求决定是否设置 `backgroundColor`。
4. 调用本 skill 目录下 `index.js` 的默认导出函数 `run(params)`。
5. 不要自行实现 API 请求、轮询、下载或缓存逻辑,这些由执行器处理。
6. 根据返回对象向用户说明处理结果、保存目录、成功文件和失败原因。
## 返回值结构
执行器返回:
```
{
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 文件。
- 如果同一图片的哈希已有成功记录且本地文件存在,执行器可能直接复用缓存结果。
don't have the plugin yet? install it then click "run inline in claude" again.