org.noear.solon.ai.skills.file

类 FileReadWriteSkill

java.lang.Object

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

org.noear.solon.ai.skills.file.FileReadWriteSkill

所有已实现的接口:

Skill

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

文件管理技能：为 AI 提供受限的本地文件系统访问能力。

该技能通过“工作空间（WorkDir）”机制实现沙箱隔离，确保 AI 仅能在指定目录下进行活动。 支持文本读写、目录遍历及文件生命周期管理。针对大文件提供了自动截断保护，防止超出大模型上下文限制。

从以下版本开始:

3.9.1

字段概要

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

tools

构造器概要

构造器

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

方法概要

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

从类继承的方法 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

构造器详细资料

FileReadWriteSkill

public FileReadWriteSkill(java.lang.String workDir)

FileReadWriteSkill

public FileReadWriteSkill(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 表示激活并挂载该技能

write

@ToolMapping(name="file_write",
             description="\u5199\u5165\u6587\u672c\u5230\u6587\u4ef6\u3002\u4f1a\u81ea\u52a8\u521b\u5efa\u4e0d\u5b58\u5728\u7684\u76ee\u5f55\u3002")
public java.lang.String write(@Param(value="fileName")
                                                                                                                                                                                                                   java.lang.String fileName,
                                                                                                                                                                                                                   @Param(value="content")
                                                                                                                                                                                                                   java.lang.String content)

read

@ToolMapping(name="file_read",
             description="\u8bfb\u53d6\u6587\u672c\u6587\u4ef6\u5185\u5bb9\u3002")
public java.lang.String read(@Param(value="fileName")
                                                                                                                                               java.lang.String fileName)

list

@ToolMapping(name="file_list",
             description="\u5217\u51fa\u6307\u5b9a\u76ee\u5f55\u4e0b\u7684\u6587\u4ef6\u548c\u5b50\u76ee\u5f55\u3002\u5982\u679c\u4e0d\u6307\u5b9a\u76ee\u5f55\uff0c\u5219\u5217\u51fa\u6839\u76ee\u5f55\u3002")
public java.lang.String list(@Param(value="dirName",required=false)
                                                                                                                                                                                                                                                                             java.lang.String dirName)

delete

@ToolMapping(name="file_delete",
             description="\u5220\u9664\u6307\u5b9a\u6587\u4ef6\u6216\u7a7a\u76ee\u5f55\u3002")
public java.lang.String delete(@Param(value="fileName")
                                                                                                                                                               java.lang.String fileName)