物理删除工作空间目录 (removeWorkspaceDirPhysically)

功能描述

此 API 端点 POST /api/system/removeWorkspaceDirPhysically 用于从磁盘上物理删除一个指定的目录及其全部内容。

与 /api/system/removeWorkspaceDir 不同，后者仅从列表中移除工作空间引用，而此 API 会彻底删除文件系统中的数据。

警告：这是一个不可逆的操作。强烈建议在执行前进行完整的数据备份。

请求参数

请求体必须是 JSON 格式，包含以下参数：

• path (string): 必填。要从磁盘上彻底删除的工作空间目录的绝对路径。

请求示例:

{
  "path": "/path/to/permanently/delete/workspace"
}
            

响应结果

如果删除的目标不是当前工作空间，且删除成功（或目标路径不存在/不是目录），将返回一个 JSON 对象，code 为 0，data 为 null。

{
  "code": 0,
  "msg": "",
  "data": null
}
            

如果删除的目标是当前工作空间，并且删除成功，API 不会返回响应，因为程序会立即退出。

如果删除过程中发生错误（例如权限不足），将返回非 0 的 code 和具体的错误信息 msg。

{
  "code": -1,
  "msg": "remove /path/to/delete/workspace: permission denied", // 示例错误信息
  "data": null
}
            

在线测试