delete_file

删除工作区中的文件或目录。本工具为rm命令提供安全替代方案，支持全平台运行。

参数说明

path（必选）：待删除文件/目录的相对路径

功能描述

本工具支持带用户确认的安全删除操作，删除目录时会先校验所有内含文件，并展示统计信息后再执行删除。

安全特性

仅删除工作区内的文件/目录
删除操作需经过用户确认
禁止删除写保护文件
依据.vjspignore规则校验所有待删文件
目录删除场景：递归扫描目录，删除前展示文件数量、目录数量、总大小等统计信息
若目录内包含受保护/被忽略文件，将阻断整个目录的删除操作

使用方法

删除单个文件

xml

<delete_file>
<path>temp/old_file.txt</path>
</delete_file>

删除目录

xml

<delete_file>
<path>old_project/</path>
</delete_file>

删除目录时，工具将按以下流程执行：

对目标目录进行递归扫描
校验所有文件是否满足删除条件
展示文件数、子目录数及总大小的汇总信息
等待用户确认后执行删除操作

异常处理

工具针对以下场景返回明确的错误信息：

待删文件/目录不存在
文件开启写保护
文件被.vjspignore规则拦截
目录内包含受保护/被忽略文件
目标路径超出工作区范围