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 字段，除非它已经明确出现在原始请求契约中。

linkfoxai-image-tool 紫鸟图像工具