返回顶部
l

linkfoxai-image-tool 紫鸟图像工具

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

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.0
安全检测
已通过
97
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

linkfoxai-image-tool

linkfoxai-image-tool

触发条件

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

不适用场景

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

执行流程

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

执行前置条件

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

能力分组

linkfox-image-upload

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

linkfox-scene-fission

  • - 适用请求:场景裂变
  • 脚本不可用时可兜底使用的 tool:postImageV2MakeSceneFission、postImageV2MakeInfo

linkfox-shop-replace

  • - 适用请求:商品替换
  • 脚本不可用时可兜底使用的 tool:postImageV2MakeShopReplace、postImageV2MakeInfo

linkfox-auto-image-matting

  • - 适用请求:自动抠图
  • 脚本不可用时可兜底使用的 tool:postImageV2MakeCutout、postImageV2MakeInfo

调用限制

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

工具分组定义

linkfox-image-upload

postImageV2UploadByBase64

  • - 能力分组: linkfox-image-upload
  • 使用此工具的场景: 当用户当前目标属于图片上传场景,且对应本地脚本不存在或执行失败时使用;将它作为开放平台兜底入口完成图片上传。
  • 必填输入: fileName、base64
  • 返回: 重点查看返回字段:msg、traceId、code、viewUrl
  • 工具目标: 图片上传
定义

yaml
tool: postImageV2UploadByBase64
sourceApiName: 图片上传
sourceMethod: POST
sourceOpenPath: /linkfox-ai/image/v2/uploadByBase64
requestUrl: https://sbappstoreapi.ziniao.com/openapi-router/linkfox-ai/image/v2/uploadByBase64

原始请求契约

text
{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}]}

原始响应契约

text
[{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»}]

linkfox-scene-fission

postImageV2MakeSceneFission

  • - 能力分组: linkfox-scene-fission
  • 使用此工具的场景: 当用户当前目标属于场景裂变场景,且对应本地脚本不存在或执行失败时使用;将它作为开放平台兜底入口完成场景裂变。
  • 必填输入: imageUrl、segImageUrl、strength、prompt
  • 返回: 重点查看返回字段:msg、traceId、code、id
  • 工具目标: 场景裂变
定义

yaml
tool: postImageV2MakeSceneFission
sourceApiName: 场景裂变
sourceMethod: POST
sourceOpenPath: /linkfox-ai/image/v2/make/sceneFission
requestUrl: https://sbappstoreapi.ziniao.com/openapi-router/linkfox-ai/image/v2/make/sceneFission

输入规则
  • - 图片输入规则: 当前契约只看到 URL 类图片字段,请按契约中的 https 图片地址字段传参。
  • 不要自行追加 base64 字段,除非它已经明确出现在 原始请求契约 中。
原始请求契约

text
{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

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 linkfoxai-image-tool-1776015625 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 linkfoxai-image-tool-1776015625 技能

通过命令行安装

skillhub install linkfoxai-image-tool-1776015625

下载

⬇ 下载 linkfoxai-image-tool v1.0.0(免费)

文件大小: 5.33 KB | 发布时间: 2026-4-13 10:51

v1.0.0 最新 2026-4-13 10:51
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.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部