org.noear.solon.ai.skills.file

类 ZipSkill

java.lang.Object

org.noear.solon.ai.chat.skill.AbsSkill

org.noear.solon.ai.skills.file.ZipSkill

所有已实现的接口:

Skill

@Preview(value="3.9.1")
public class ZipSkill
extends AbsSkill

压缩归档技能：支持文件与目录的混合打包。

该技能基于 NIO FileSystem 提供 ZIP 归档能力，支持递归处理深层目录。 核心特性包括：

• 沙箱安全：严格限制在 WorkDir 根路径下操作，防止路径穿越攻击。
• 递归映射：自动保留原始目录结构，逻辑严密地映射到压缩包内部。
• 防自锁机制：智能检测并排除正在生成的 ZIP 文件本身，避免递归嵌套异常。

从以下版本开始:

3.9.1

字段概要

从类继承的字段 org.noear.solon.ai.chat.skill.AbsSkill

tools

构造器概要

构造器

构造器和说明
ZipSkill(java.lang.String workDir)
ZipSkill(java.lang.String workDir, java.nio.charset.Charset charset)

方法概要

限定符和类型	方法和说明
java.lang.String	description() 获取技能描述
boolean	isSupported(Prompt prompt) 准入检查：决定该技能在当前对话上下文中是否被激活
java.lang.String	name() 获取技能名称（默认类名）
java.lang.String	zip(java.lang.String zipFileName, java.lang.String[] paths)

从类继承的方法 org.noear.solon.ai.chat.skill.AbsSkill

getTools, metadata

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 org.noear.solon.ai.chat.skill.Skill

getInstruction, onAttach

构造器详细资料

ZipSkill

public ZipSkill(java.lang.String workDir)

ZipSkill

public ZipSkill(java.lang.String workDir,
                java.nio.charset.Charset charset)

方法详细资料

name

public java.lang.String name()

从接口复制的说明: Skill

获取技能名称（默认类名）

description

public java.lang.String description()

从接口复制的说明: Skill

获取技能描述

isSupported

public boolean isSupported(Prompt prompt)

从接口复制的说明: Skill

准入检查：决定该技能在当前对话上下文中是否被激活

参数:

prompt - 当前提示词上下文

返回:

true 表示激活并挂载该技能

zip

@ToolMapping(name="zip",
             description="\u5c06\u6307\u5b9a\u7684\u8def\u5f84\u5217\u8868\uff08\u652f\u6301\u6587\u4ef6\u548c\u76ee\u5f55\u6df7\u5408\uff09\u6253\u5305\u5230 ZIP \u6587\u4ef6\u4e2d\u3002")
public java.lang.String zip(@Param(value="zipFileName")
                                                                                                                                                                                                                                                   java.lang.String zipFileName,
                                                                                                                                                                                                                                                   @Param(value="paths")
                                                                                                                                                                                                                                                   java.lang.String[] paths)