← 返回 Skills 市场
ziniao-open

linkfoxai-image-tool

作者 ziniao-open · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
115
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install linkfoxai-image-tool
功能描述
这是紫鸟开放平台Skill,面向普通用户直接执行任务,无需关心内部调用细节;当用户要求直接完成图片上传、场景裂变、商品替换等当前 Skill 覆盖能力,并希望直接拿到最终结果时,优先通过当前 skill 的本地脚本执行;仅在脚本不存在或执行失败时,才回退到开放平台调用。
使用说明 (SKILL.md)

\r \r

linkfoxai-image-tool\r

\r

Trigger Conditions\r

\r

  • 当用户目标属于当前 Skill 覆盖的能力分组,且希望直接拿到最终结果时,可使用本 Skill。\r
  • 当前 Skill 覆盖的能力分组:\r
  • linkfox-image-upload: 图片上传\r
  • linkfox-scene-fission: 场景裂变\r
  • linkfox-shop-replace: 商品替换\r
  • linkfox-auto-image-matting: 自动抠图\r
  • 若用户目标是查询当前 Skill 覆盖任务的状态、处理进度或最终结果,也属于可直接执行的适用场景。\r \r

When Not To Use\r

\r

  • 当用户只需要开放平台接入说明、参数解释、代码开发建议或集成设计时,不要使用本 Skill。\r
  • 当请求不属于当前 Skill 覆盖的能力范围时,不要强行复用本 Skill。\r
  • 当需要你猜测未在契约中声明的参数、字段或调用行为时,不要继续执行,应以现有契约为准。\r \r

Execution Flow\r

\r

  • Step 1: 先真实读取 scripts/脚本使用指导.md,确认脚本的 payload、成功/失败语义与退出码规则。\r
  • Step 2: 再真实读取当前 skill 的 scripts/ 目录,确认候选脚本是否实际存在。\r
  • Step 3: 根据当前执行环境属于 WinmacOS 还是 Linux,按 tool分组名_平台 规则组合目标脚本名;Win 对应 .ps1macOSLinux 对应 .sh。\r
  • Step 4: 若脚本存在且执行成功,直接使用脚本标准输出作为最终结果。\r
  • Step 5: 若脚本不存在,或脚本执行失败并返回非 0 退出码,则回退到对应的执行型 tool / 开放平台调用链路,继续使用 requestUrlRaw Request ContractRaw Response Contract。\r \r

Execution Prerequisites\r

\r

  • callDomain: https://sbappstoreapi.ziniao.com/openapi-router\r
  • apiKey: 先确认 ZNOPEN_API_KEY 已可用;默认从 ~/.znopen/config.json 读取,缺失时先提示用户提供,提供后回填文件,完成配置。\r
  • Runtime Evidence: 以下内容只描述本地脚本查找、执行与 fallback 规则,不代表当前 skill 已经存在哪些脚本文件;执行时必须真实读取 scripts/ 目录与 scripts/脚本使用指导.md 再做判断。\r
  • Authorization: 无需让用户手工拼接请求头,tool 在调用开放平台时会基于可用的 apiKey 自动注入该头。\r
  • requestUrl: 统一由 callDomain + sourceOpenPath 组成,调用前应直接使用已生成结果,不建议手工改写。\r \r

Capability Groups\r

\r

linkfox-image-upload\r

  • 适用请求:图片上传\r
  • 脚本不可用时可兜底使用的 tool:postImageV2UploadByBase64\r \r

linkfox-scene-fission\r

  • 适用请求:场景裂变\r
  • 脚本不可用时可兜底使用的 tool:postImageV2MakeSceneFissionpostImageV2MakeInfo\r \r

linkfox-shop-replace\r

  • 适用请求:商品替换\r
  • 脚本不可用时可兜底使用的 tool:postImageV2MakeShopReplacepostImageV2MakeInfo\r \r

linkfox-auto-image-matting\r

  • 适用请求:自动抠图\r
  • 脚本不可用时可兜底使用的 tool:postImageV2MakeCutoutpostImageV2MakeInfo\r \r

Call Limits\r

\r

  • tool 发起开放平台请求时,必须自动带上请求头:Authorization: Bearer {ApiKey}。\r
  • BearerApiKey 之间必须有一个空格,不能省略、不能连写、也不能替换为其他前缀。\r
  • 请求方法必须与对应 tool 的 sourceMethod 保持一致,不允许自行切换调用方式。\r
  • 请求参数必须严格遵循 Raw Request Contract,响应解析与错误处理必须严格遵循 Raw Response Contract。\r
  • 当前置条件未满足、凭证缺失或开放平台返回错误时,不应继续盲目重试或猜测字段含义。\r \r

Tool Group Definitions\r

\r

linkfox-image-upload\r

\r

postImageV2UploadByBase64\r

\r

  • Capability Group: linkfox-image-upload\r
  • Use This Tool When: 当用户当前目标属于“图片上传”场景,且对应本地脚本不存在或执行失败时使用;将它作为开放平台兜底入口完成“图片上传”。\r
  • Required Inputs: fileName、base64\r
  • Returns: 重点查看返回字段:msg、traceId、code、viewUrl\r
  • Tool Goal: 图片上传\r \r
Definition\r

\r

tool: postImageV2UploadByBase64\r
sourceApiName: 图片上传\r
sourceMethod: POST\r
sourceOpenPath: /linkfox-ai/image/v2/uploadByBase64\r
requestUrl: https://sbappstoreapi.ziniao.com/openapi-router/linkfox-ai/image/v2/uploadByBase64\r
```\r
\r
##### Raw Request Contract\r
\r
```text\r
{"headers":[{"isRoot":false,"name":"Content-Type","id":"w8pqf70e","type":"","value":"application/json","required":1,"desc":""}],"query":[],"body":[{"isRoot":true,"children":[{"isRoot":false,"name":"fileName","id":"bzxlv5tv","type":"string","required":1,"desc":"文件名(带扩展名)支持格式:jpeg、jpg、png、webp","value":"1.png"},{"isRoot":false,"name":"base64","id":"6bzgux9i","type":"string","required":1,"desc":"图片数据base64编码 文件大小:不超过20MB","value":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"UploadByBase64ReqVo"}]}\r
```\r
\r
##### Raw Response Contract\r
\r
```text\r
[{"isRoot":true,"children":[{"isRoot":false,"name":"msg","id":"474ze4ft","type":"string","required":0,"desc":"结果描述"},{"isRoot":false,"name":"traceId","id":"gcq4vu8w","type":"string","required":0,"desc":"链路追踪id"},{"isRoot":false,"name":"code","id":"6r3j5kog","type":"integer","required":0,"desc":"结果编码 200成功 非200报错"},{"isRoot":false,"children":[{"isRoot":false,"name":"viewUrl","id":"ohy4rmpb","type":"string","required":0,"desc":"上传成功后的图片访问地址"}],"name":"data","id":"k0lmm7mt","type":"object","required":0},{"isRoot":false,"name":"msgKey","id":"46vvp4b4","type":"string","required":0,"desc":"错误编码"}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"ResponseDto«ApiImageUploadResVo»"}]\r
```\r
\r
### linkfox-scene-fission\r
\r
#### `postImageV2MakeSceneFission`\r
\r
- Capability Group: `linkfox-scene-fission`\r
- Use This Tool When: 当用户当前目标属于“场景裂变”场景,且对应本地脚本不存在或执行失败时使用;将它作为开放平台兜底入口完成“场景裂变”。\r
- Required Inputs: imageUrl、segImageUrl、strength、prompt\r
- Returns: 重点查看返回字段:msg、traceId、code、id\r
- Tool Goal: 场景裂变\r
\r
##### Definition\r
\r
```yaml\r
tool: postImageV2MakeSceneFission\r
sourceApiName: 场景裂变\r
sourceMethod: POST\r
sourceOpenPath: /linkfox-ai/image/v2/make/sceneFission\r
requestUrl: https://sbappstoreapi.ziniao.com/openapi-router/linkfox-ai/image/v2/make/sceneFission\r
```\r
\r
##### Input Rules\r
\r
- Image Input Rule: 当前契约只看到 URL 类图片字段,请按契约中的 `https` 图片地址字段传参。\r
- 不要自行追加 `base64` 字段,除非它已经明确出现在 `Raw Request Contract` 中。\r
\r
##### Raw Request Contract\r
\r
```text\r
{"headers":[{"isRoot":false,"name":"Content-Type","id":"w8pqf70e","type":"","value":"application/json","required":1,"desc":""}],"query":[],"body":[{"isRoot":true,"children":[{"isRoot":false,"name":"imageUrl","id":"bzxlv5tv","type":"string","required":1,"desc":"原图","value":"https://test-file-ai.linkfox.com/UPLOAD/MANAGE/CASE/SCENE_FISSION/1744309376725860352/image.jpg"},{"isRoot":false,"name":"segImageUrl","id":"6bzgux9i","type":"string","required":0,"desc":"保留区域图,不传会自动调用智能抠图"},{"id":"r8mecvca","name":"strength","type":"number","desc":"生成图与原图相似度 默认值:0.5 值越大相似度度越高 浮点数 小数点后只有一位 可选范围 [0.1,1]","isInit":true,"required":0},{"id":"grl5efmb","name":"prompt","type":"string","desc":"强化内容描述,不传会自动根据参数图提取 最长600字符,超出会截断","isInit":true,"required":0},{"id":"87njvdrs","name":"imageOutputWidth","type":"integer","desc":"输出尺寸 宽度 最长不能超过2048,最短不能低于32","isInit":true,"required":0},{"id":"ukpogp3d","name":"imageOutputHeight","type":"integer","desc":"输出尺寸 高度 最长不能超过2048,最短不能低于32","isInit":true,"required":0},{"id":"ob2j7568","name":"provider","type":"string","desc":"场景裂变模式 SCENE_FISSION_REALISTIC:写实(默认值) SCENE_FISSION_SIMPLE:简约   SCENE_FISSION_INTELLIGENT:智能","isInit":true,"value":"SCENE_FISSION_REALISTIC"},{"id":"g017pou2","name":"outputNum","type":"integer","desc":"输出张数 取值范围:[1,4] 默认值:1","isInit":true,"required":0}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"SceneFissionParamsVo"}]}\r
```\r
\r
##### Raw Response Contract\r
\r
```text\r
[{"isRoot":true,"children":[{"isRoot":false,"name":"msg","id":"474ze4ft","type":"string","required":0,"desc":"结果描述"},{"isRoot":false,"name":"traceId","id":"gcq4vu8w","type":"string","required":0,"desc":"链路追踪id"},{"isRoot":false,"name":"code","id":"6r3j5kog","type":"integer","required":0,"desc":"结果编码 200成功 非200报错"},{"isRoot":false,"children":[{"isRoot":false,"name":"id","id":"ohy4rmpb","type":"integer","required":0,"desc":"作图任务ID"}],"name":"data","id":"k0lmm7mt","type":"object","required":0},{"isRoot":false,"name":"msgKey","id":"46vvp4b4","type":"string","required":0,"desc":"错误编码"}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"ResponseDto«OnlyIdVo»"}]\r
```\r
\r
#### `postImageV2MakeInfo`\r
\r
- Capability Group: `linkfox-scene-fission`\r
- Use This Tool When: 当用户当前目标属于“场景裂变”场景,且对应本地脚本不存在或执行失败时使用;将它作为开放平台兜底入口完成“获取AI作图结果”。\r
- Required Inputs: id\r
- Returns: 重点查看返回字段:msg、traceId、code、id\r
- Reuse Note: 该 tool 名称在多个能力分组中复用;当前块表示它在 `linkfox-scene-fission` 场景下的使用入口,按当前分组目标理解即可。\r
- Tool Goal: 获取AI作图结果\r
\r
##### Definition\r
\r
```yaml\r
tool: postImageV2MakeInfo\r
sourceApiName: 获取AI作图结果\r
sourceMethod: POST\r
sourceOpenPath: /linkfox-ai/image/v2/make/info\r
requestUrl: https://sbappstoreapi.ziniao.com/openapi-router/linkfox-ai/image/v2/make/info\r
```\r
\r
##### Raw Request Contract\r
\r
```text\r
{"headers":[{"isRoot":false,"name":"Content-Type","id":"w8pqf70e","type":"","value":"application/json","required":1,"desc":""}],"query":[],"body":[{"isRoot":true,"children":[{"isRoot":false,"name":"id","id":"bzxlv5tv","type":"string","required":1,"desc":"作图任务ID","value":"111"}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"OnlyIdVo"}]}\r
```\r
\r
##### Raw Response Contract\r
\r
```text\r
[{"isRoot":true,"children":[{"isRoot":false,"name":"msg","id":"474ze4ft","type":"string","required":0,"desc":"结果描述"},{"isRoot":false,"name":"traceId","id":"gcq4vu8w","type":"string","required":0,"desc":"链路追踪id"},{"isRoot":false,"name":"code","id":"6r3j5kog","type":"integer","required":0,"desc":"结果编码 200成功 非200报错"},{"isRoot":false,"children":[{"isRoot":false,"name":"id","id":"ohy4rmpb","type":"integer","required":0,"desc":"作图任务ID"},{"isRoot":false,"name":"status","id":"gcq4vu8w","type":"integer","required":0,"desc":"状态 1.排队中 2.生成中 3.成功 4.失败"},{"isRoot":false,"name":"errorCode","id":"6r3j5kog","type":"string","required":0,"desc":"错误码"},{"isRoot":false,"name":"errorMsg","id":"46vvp4b4","type":"string","required":0,"desc":"错误文字描述"},{"isRoot":false,"name":"resultList","id":"k0lmm7mt","type":"array","required":0,"desc":"输出结果图片数组","children":[{"isRoot":false,"name":"id","id":"item1","type":"integer","required":0,"desc":"图片ID"},{"isRoot":false,"name":"status","id":"item2","type":"integer","required":0,"desc":"状态 0.生成中 1.成功 2.失败"},{"isRoot":false,"name":"url","id":"item3","type":"string","required":0,"desc":"高清图"},{"isRoot":false,"name":"width","id":"item4","type":"integer","required":0,"desc":"宽"},{"isRoot":false,"name":"height","id":"item5","type":"integer","required":0,"desc":"高"},{"isRoot":false,"name":"format","id":"item6","type":"string","required":0,"desc":"格式"}]}],"name":"data","id":"k0lmm7mt","type":"object","required":0},{"isRoot":false,"name":"msgKey","id":"46vvp4b4","type":"string","required":0,"desc":"错误编码"}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"ResponseDto«ApiImageMakeResVo»"}]\r
```\r
\r
### linkfox-shop-replace\r
\r
#### `postImageV2MakeShopReplace`\r
\r
- Capability Group: `linkfox-shop-replace`\r
- Use This Tool When: 当用户当前目标属于“商品替换”场景,且对应本地脚本不存在或执行失败时使用;将它作为开放平台兜底入口完成“商品替换”。\r
- Required Inputs: imageUrl、sourceImageUrl、targetOriginUrl、targetImageUrl\r
- Returns: 重点查看返回字段:msg、traceId、code、id\r
- Tool Goal: 商品替换\r
\r
##### Definition\r
\r
```yaml\r
tool: postImageV2MakeShopReplace\r
sourceApiName: 商品替换\r
sourceMethod: POST\r
sourceOpenPath: /linkfox-ai/image/v2/make/shopReplace\r
requestUrl: https://sbappstoreapi.ziniao.com/openapi-router/linkfox-ai/image/v2/make/shopReplace\r
```\r
\r
##### Input Rules\r
\r
- Image Input Rule: 当前契约只看到 URL 类图片字段,请按契约中的 `https` 图片地址字段传参。\r
- 不要自行追加 `base64` 字段,除非它已经明确出现在 `Raw Request Contract` 中。\r
\r
##### Raw Request Contract\r
\r
```text\r
{"headers":[{"isRoot":false,"name":"Content-Type","id":"w8pqf70e","type":"","value":"application/json","required":1,"desc":""}],"query":[],"body":[{"isRoot":true,"children":[{"isRoot":false,"name":"imageUrl","id":"bzxlv5tv","type":"string","required":1,"desc":"商品原图","value":"https://linkfoxai-ailab.oss-cn-shenzhen.aliyuncs.com/UPLOAD/1701144666432344064/2024/11/18/96a7a42fc965491dbc625d2db09f2478.png"},{"isRoot":false,"name":"sourceImageUrl","id":"6bzgux9i","type":"string","required":0,"desc":"原图抠出来的商品图"},{"id":"r8mecvca","name":"targetOriginUrl","type":"string","desc":"替换的目标原图","isInit":true,"required":1,"value":"https://linkfoxai-ailab.oss-cn-shenzhen.aliyuncs.com/UPLOAD/1701144666432344064/2024/11/18/9778678b4724467485346248032387ec.png"},{"id":"grl5efmb","name":"targetImageUrl","type":"string","desc":"替换的目标原图抠图结果","isInit":true,"required":0},{"id":"87njvdrs","name":"denoiseStrength","type":"string","desc":"生成图变化程度 默认值:0.5 越大越高 浮点数 可选范围 [0,1]","isInit":true,"required":0},{"id":"ukpogp3d","name":"imageOutputWidth","type":"integer","desc":"输出尺寸 宽度 最长边不能超过4096,最短边不能低于32","isInit":true,"required":0},{"id":"g017pou2","name":"imageOutputHeight","type":"integer","desc":"输出尺寸 高度 最长边不能超过4096,最短边不能低于32","isInit":true,"required":0},{"id":"vtarf9ph","name":"outputNum","type":"integer","desc":"输出张数 取值范围:[1,4] 默认值:1","isInit":true,"required":0}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"ShopReplaceParamsVo"}]}\r
```\r
\r
##### Raw Response Contract\r
\r
```text\r
[{"isRoot":true,"children":[{"isRoot":false,"name":"msg","id":"474ze4ft","type":"string","required":0,"desc":"结果描述"},{"isRoot":false,"name":"traceId","id":"gcq4vu8w","type":"string","required":0,"desc":"链路追踪id"},{"isRoot":false,"name":"code","id":"6r3j5kog","type":"integer","required":0,"desc":"结果编码 200成功 非200报错"},{"isRoot":false,"children":[{"isRoot":false,"name":"id","id":"ohy4rmpb","type":"integer","required":0,"desc":"作图任务ID"}],"name":"data","id":"k0lmm7mt","type":"object","required":0},{"isRoot":false,"name":"msgKey","id":"46vvp4b4","type":"string","required":0,"desc":"错误编码"}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"ResponseDto«OnlyIdVo»"}]\r
```\r
\r
#### `postImageV2MakeInfo`\r
\r
- Capability Group: `linkfox-shop-replace`\r
- Use This Tool When: 当用户当前目标属于“商品替换”场景,且对应本地脚本不存在或执行失败时使用;将它作为开放平台兜底入口完成“获取AI作图结果”。\r
- Required Inputs: id\r
- Returns: 重点查看返回字段:msg、traceId、code、id\r
- Reuse Note: 该 tool 名称在多个能力分组中复用;当前块表示它在 `linkfox-shop-replace` 场景下的使用入口,按当前分组目标理解即可。\r
- Tool Goal: 获取AI作图结果\r
\r
##### Definition\r
\r
```yaml\r
tool: postImageV2MakeInfo\r
sourceApiName: 获取AI作图结果\r
sourceMethod: POST\r
sourceOpenPath: /linkfox-ai/image/v2/make/info\r
requestUrl: https://sbappstoreapi.ziniao.com/openapi-router/linkfox-ai/image/v2/make/info\r
```\r
\r
##### Raw Request Contract\r
\r
```text\r
{"headers":[{"isRoot":false,"name":"Content-Type","id":"w8pqf70e","type":"","value":"application/json","required":1,"desc":""}],"query":[],"body":[{"isRoot":true,"children":[{"isRoot":false,"name":"id","id":"bzxlv5tv","type":"string","required":1,"desc":"作图任务ID","value":"111"}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"OnlyIdVo"}]}\r
```\r
\r
##### Raw Response Contract\r
\r
```text\r
[{"isRoot":true,"children":[{"isRoot":false,"name":"msg","id":"474ze4ft","type":"string","required":0,"desc":"结果描述"},{"isRoot":false,"name":"traceId","id":"gcq4vu8w","type":"string","required":0,"desc":"链路追踪id"},{"isRoot":false,"name":"code","id":"6r3j5kog","type":"integer","required":0,"desc":"结果编码 200成功 非200报错"},{"isRoot":false,"children":[{"isRoot":false,"name":"id","id":"ohy4rmpb","type":"integer","required":0,"desc":"作图任务ID"},{"isRoot":false,"name":"status","id":"gcq4vu8w","type":"integer","required":0,"desc":"状态 1.排队中 2.生成中 3.成功 4.失败"},{"isRoot":false,"name":"errorCode","id":"6r3j5kog","type":"string","required":0,"desc":"错误码"},{"isRoot":false,"name":"errorMsg","id":"46vvp4b4","type":"string","required":0,"desc":"错误文字描述"},{"isRoot":false,"name":"resultList","id":"k0lmm7mt","type":"array","required":0,"desc":"输出结果图片数组","children":[{"isRoot":false,"name":"id","id":"item1","type":"integer","required":0,"desc":"图片ID"},{"isRoot":false,"name":"status","id":"item2","type":"integer","required":0,"desc":"状态 0.生成中 1.成功 2.失败"},{"isRoot":false,"name":"url","id":"item3","type":"string","required":0,"desc":"高清图"},{"isRoot":false,"name":"width","id":"item4","type":"integer","required":0,"desc":"宽"},{"isRoot":false,"name":"height","id":"item5","type":"integer","required":0,"desc":"高"},{"isRoot":false,"name":"format","id":"item6","type":"string","required":0,"desc":"格式"}]}],"name":"data","id":"k0lmm7mt","type":"object","required":0},{"isRoot":false,"name":"msgKey","id":"46vvp4b4","type":"string","required":0,"desc":"错误编码"}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"ResponseDto«ApiImageMakeResVo»"}]\r
```\r
\r
### linkfox-auto-image-matting\r
\r
#### `postImageV2MakeCutout`\r
\r
- Capability Group: `linkfox-auto-image-matting`\r
- Use This Tool When: 当用户当前目标属于“自动抠图”场景,且对应本地脚本不存在或执行失败时使用;将它作为开放平台兜底入口完成“自动抠图”。\r
- Required Inputs: imageUrl、subType、clothClass\r
- Returns: 重点查看返回字段:msg、traceId、code、id\r
- Tool Goal: 自动抠图\r
\r
##### Definition\r
\r
```yaml\r
tool: postImageV2MakeCutout\r
sourceApiName: 自动抠图\r
sourceMethod: POST\r
sourceOpenPath: /linkfox-ai/image/v2/make/cutout\r
requestUrl: https://sbappstoreapi.ziniao.com/openapi-router/linkfox-ai/image/v2/make/cutout\r
```\r
\r
##### Input Rules\r
\r
- Image Input Rule: 当前契约只看到 URL 类图片字段,请按契约中的 `https` 图片地址字段传参。\r
- 不要自行追加 `base64` 字段,除非它已经明确出现在 `Raw Request Contract` 中。\r
\r
##### Raw Request Contract\r
\r
```text\r
{"headers":[{"isRoot":false,"name":"Content-Type","id":"w8pqf70e","type":"","value":"application/json","required":1,"desc":""}],"query":[],"body":[{"isRoot":true,"children":[{"isRoot":false,"name":"imageUrl","id":"bzxlv5tv","type":"string","required":1,"desc":"原图","value":"https://linkfoxai-ailab.oss-cn-shenzhen.aliyuncs.com/UPLOAD/1701144666432344064/2024/11/13/bec32c4461644befb202f86b23502583.png"},{"isRoot":false,"name":"subType","id":"6bzgux9i","type":"integer","required":1,"desc":"抠图类型 1: 通用 2: 人像 3: 商品 9: 服饰 12: 头发 13:人脸","value":"1"},{"id":"r8mecvca","name":"clothClass","type":"string","desc":"服饰分类,只有抠图类型=9(服饰抠图)时才会生效, 可多选,以','号分割","isInit":true,"required":0}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"CutoutParamsVo"}]}\r
```\r
\r
##### Raw Response Contract\r
\r
```text\r
[{"isRoot":true,"children":[{"isRoot":false,"name":"msg","id":"474ze4ft","type":"string","required":0,"desc":"结果描述"},{"isRoot":false,"name":"traceId","id":"gcq4vu8w","type":"string","required":0,"desc":"链路追踪id"},{"isRoot":false,"name":"code","id":"6r3j5kog","type":"integer","required":0,"desc":"结果编码 200成功 非200报错"},{"isRoot":false,"children":[{"isRoot":false,"name":"id","id":"ohy4rmpb","type":"integer","required":0,"desc":"作图任务ID"}],"name":"data","id":"k0lmm7mt","type":"object","required":0},{"isRoot":false,"name":"msgKey","id":"46vvp4b4","type":"string","required":0,"desc":"错误编码"}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"ResponseDto«OnlyIdVo»"}]\r
```\r
\r
#### `postImageV2MakeInfo`\r
\r
- Capability Group: `linkfox-auto-image-matting`\r
- Use This Tool When: 当用户当前目标属于“自动抠图”场景,且对应本地脚本不存在或执行失败时使用;将它作为开放平台兜底入口完成“获取AI作图结果”。\r
- Required Inputs: id\r
- Returns: 重点查看返回字段:msg、traceId、code、id\r
- Reuse Note: 该 tool 名称在多个能力分组中复用;当前块表示它在 `linkfox-auto-image-matting` 场景下的使用入口,按当前分组目标理解即可。\r
- Tool Goal: 获取AI作图结果\r
\r
##### Definition\r
\r
```yaml\r
tool: postImageV2MakeInfo\r
sourceApiName: 获取AI作图结果\r
sourceMethod: POST\r
sourceOpenPath: /linkfox-ai/image/v2/make/info\r
requestUrl: https://sbappstoreapi.ziniao.com/openapi-router/linkfox-ai/image/v2/make/info\r
```\r
\r
##### Raw Request Contract\r
\r
```text\r
{"headers":[{"isRoot":false,"name":"Content-Type","id":"w8pqf70e","type":"","value":"application/json","required":1,"desc":""}],"query":[],"body":[{"isRoot":true,"children":[{"isRoot":false,"name":"id","id":"bzxlv5tv","type":"string","required":1,"desc":"作图任务ID","value":"111"}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"OnlyIdVo"}]}\r
```\r
\r
##### Raw Response Contract\r
\r
```text\r
[{"isRoot":true,"children":[{"isRoot":false,"name":"msg","id":"474ze4ft","type":"string","required":0,"desc":"结果描述"},{"isRoot":false,"name":"traceId","id":"gcq4vu8w","type":"string","required":0,"desc":"链路追踪id"},{"isRoot":false,"name":"code","id":"6r3j5kog","type":"integer","required":0,"desc":"结果编码 200成功 非200报错"},{"isRoot":false,"children":[{"isRoot":false,"name":"id","id":"ohy4rmpb","type":"integer","required":0,"desc":"作图任务ID"},{"isRoot":false,"name":"status","id":"gcq4vu8w","type":"integer","required":0,"desc":"状态 1.排队中 2.生成中 3.成功 4.失败"},{"isRoot":false,"name":"errorCode","id":"6r3j5kog","type":"string","required":0,"desc":"错误码"},{"isRoot":false,"name":"errorMsg","id":"46vvp4b4","type":"string","required":0,"desc":"错误文字描述"},{"isRoot":false,"name":"resultList","id":"k0lmm7mt","type":"array","required":0,"desc":"输出结果图片数组","children":[{"isRoot":false,"name":"id","id":"item1","type":"integer","required":0,"desc":"图片ID"},{"isRoot":false,"name":"status","id":"item2","type":"integer","required":0,"desc":"状态 0.生成中 1.成功 2.失败"},{"isRoot":false,"name":"url","id":"item3","type":"string","required":0,"desc":"高清图"},{"isRoot":false,"name":"width","id":"item4","type":"integer","required":0,"desc":"宽"},{"isRoot":false,"name":"height","id":"item5","type":"integer","required":0,"desc":"高"},{"isRoot":false,"name":"format","id":"item6","type":"string","required":0,"desc":"格式"}]}],"name":"data","id":"k0lmm7mt","type":"object","required":0},{"isRoot":false,"name":"msgKey","id":"46vvp4b4","type":"string","required":0,"desc":"错误编码"}],"name":"","id":0,"type":"object","value":"","required":0,"desc":"ResponseDto«ApiImageMakeResVo»"}]\r
```\r
安全使用建议
This skill will enumerate and execute scripts from a local scripts/ directory and will read/write an API key at ~/.znopen/config.json, but the manifest does not declare these requirements. Before installing or enabling it: (1) inspect any scripts in the skill's scripts/ folder — do not allow execution of unknown scripts; (2) do not provide your ZNOPEN_API_KEY unless you trust the skill and understand it will be written to ~/.znopen/config.json; (3) prefer running in a sandboxed environment or with a throwaway API key; (4) ask the author to update the skill metadata to declare required env vars (ZNOPEN_API_KEY) and config paths, and to document exactly what scripts it will run and what it will write to disk.
能力评估
Purpose & Capability
The SKILL.md describes executing local scripts in scripts/ to perform image tasks and falling back to an external API that requires a ZNOPEN_API_KEY. However the manifest declares no required env vars, no primary credential, and no required config paths. The need to access ~/.znopen/config.json and use ZNOPEN_API_KEY is not reflected in the skill metadata — an incoherence between declared requirements and actual runtime needs.
Instruction Scope
Instructions explicitly tell the agent to: (1) read scripts/脚本使用指导.md, (2) enumerate/read the scripts/ directory, (3) execute platform-specific scripts (PowerShell/.ps1 or shell/.sh) and treat stdout as final result, and (4) on missing/failed scripts, call an external API. Reading arbitrary files and executing arbitrary local scripts gives this skill broad access to local data and execution ability beyond a simple API wrapper.
Install Mechanism
There is no install spec and no code files — lowest-risk in terms of code being written to disk by an installer. However, because the skill's runtime explicitly executes local scripts, the lack of an installer does not eliminate execution risk: it will run whatever scripts exist under scripts/.
Credentials
SKILL.md requires an apiKey (ZNOPEN_API_KEY) and states the skill will read ~/.znopen/config.json and will prompt and backfill that file when missing. Yet the registry metadata declares no required environment variables and no required config paths. Requesting/storing an API key and automatically writing to a home config file is disproportionate unless the skill clearly declares and justifies that need.
Persistence & Privilege
The skill will persist an API key into ~/.znopen/config.json (writing to a user home config) per the instructions. The skill is not marked always:true, but it does request the ability to modify a user file and to execute local scripts — this persistent modification behavior is not declared in metadata and increases the blast radius if the API key or scripts are sensitive.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install linkfoxai-image-tool
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /linkfoxai-image-tool 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of linkfoxai-image-tool. - Provides direct execution for image upload, scene fission, product replacement, and auto image matting, prioritizing local scripts. - Includes automatic fallback to Linkfox OpenAPI platform tools if local scripts are unavailable or fail. - Automatically manages API key retrieval, storage, and request authorization for OpenAPI calls. - Ensures strict contract-based request/response processing and platform-specific script invocation. - Covers tool call scenarios such as status and result queries for supported tasks.
元数据
Slug linkfoxai-image-tool
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

linkfoxai-image-tool 是什么?

这是紫鸟开放平台Skill,面向普通用户直接执行任务,无需关心内部调用细节;当用户要求直接完成图片上传、场景裂变、商品替换等当前 Skill 覆盖能力,并希望直接拿到最终结果时,优先通过当前 skill 的本地脚本执行;仅在脚本不存在或执行失败时,才回退到开放平台调用。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 115 次。

如何安装 linkfoxai-image-tool?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install linkfoxai-image-tool」即可一键安装,无需额外配置。

linkfoxai-image-tool 是免费的吗?

是的,linkfoxai-image-tool 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

linkfoxai-image-tool 支持哪些平台?

linkfoxai-image-tool 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 linkfoxai-image-tool?

由 ziniao-open(@ziniao-open)开发并维护,当前版本 v1.0.0。

💬 留言讨论