小紫磁盘清理插件

v1.0.0 · 运维协作 · 官方

磁盘清理大文件空间运维小紫

简介

小紫磁盘清理插件 v1.0，跨平台磁盘分析工具，支持 Windows、macOS、Ubuntu/Linux（run.bat / run.sh），AI 帮你分析占用、定位大文件：

usage 查看磁盘总容量、已用、剩余、使用率
large_files 在目录中查找超过阈值的大文件（Top N）
tree 统计子目录/文件占用，按大小排序
无需 pip，Python 标准库即可

平台说明：

Windows：--path C: 或 D:\logs
macOS / Linux：--path / 或 /home/user、/var/log
三端能力一致，路径格式按各自系统填写即可

重要：v1.0 只分析、不自动删除（任何系统均如此）。不会执行 Windows 磁盘清理、Linux apt clean、macOS 存储优化等系统级清理；定位大文件/大目录后，需配合系统基础插件或手动操作删除，避免误删。

典型流程：usage 看哪块盘满了 → tree 找最大目录 → large_files 找具体大文件 → 手动清理

操作说明

action	功能
`usage`	查看 path 所在磁盘空间
`large_files`	扫描目录，列出大于 min_size 的文件
`tree`	统计 path 下各项占用，返回最大的前 N 个

usage 参数要点：

path 盘符如 C: 或任意目录路径（默认当前目录所在盘）

large_files 参数要点：

path 必填，要扫描的目录
min_size 最小 MB，默认 100
max_results 最多返回条数，默认 20
depth 扫描深度，默认 8
extensions 扩展名过滤，如 .log,.zip,.bak

tree 参数要点：

path 必填
depth 子目录递归深度，默认 3
top 返回前 N 项，默认 15
exclude 排除目录名，如 node_modules,.git

默认跳过：回收站、系统卷信息、隐藏目录（. 开头）等。

安装

解压到 D:\xiaozi-plugins\运维协作\磁盘清理插件\
复制 python/ 到本目录
测试：run.bat --action usage --path C:

文件	说明
`disk_plugin.py`	主程序
`run.bat` / `run.sh`	启动脚本
`磁盘清理插件.md`	用户文档
`config/disk_config.example.json`	配置示例
`上架文案/`	商店详情（本文件，不打 zip）

无需 pip，标准库即可。

命令行

REM C 盘空间
run.bat --action usage --path C:

REM 找 D:\logs 下大于 50MB 的文件
run.bat --action large_files --path D:\logs --min_size 50 --max_results 20

REM 只找 log 大文件
run.bat --action large_files --path D:\logs --min_size 10 --extensions .log

REM 项目目录占用排行
run.bat --action tree --path D:\projects --top 15

REM 深层统计
run.bat --action tree --path D:\data --depth 5 --top 20

注册技能 disk_tool

名称： disk_tool

描述： 磁盘分析 v1.0，跨平台Win/macOS/Linux。usage/large_files/tree查空间、找大文件、目录占用排序。用户磁盘满了、清理前排查时使用。Win传C:或D:\路径，Linux/mac传/或/home等。只分析不自动删除，不执行系统级清理。

脚本： D:\xiaozi-plugins\运维协作\磁盘清理插件\run.bat

参数 JSON：

{
  "type": "object",
  "properties": {
    "action": {"type": "string", "enum": ["usage", "large_files", "tree"], "description": "操作类型"},
    "path": {"type": "string", "description": "目标路径，usage可用C:，large_files/tree需目录"},
    "min_size": {"type": "string", "description": "large_files最小MB默认100"},
    "max_results": {"type": "string", "description": "large_files最多返回条数"},
    "depth": {"type": "string", "description": "扫描深度"},
    "top": {"type": "string", "description": "tree返回前N项"},
    "extensions": {"type": "string", "description": "扩展名过滤 .log,.zip"},
    "exclude": {"type": "string", "description": "排除目录逗号分隔"}
  },
  "required": ["action"]
}

对话示例

场景	说法
看空间	C 盘还剩多少空间？
找大文件	在 D:\logs 找大于 100MB 的文件
目录分析	D:\projects 哪个文件夹占用最大？
查日志	D:\logs 里有哪些超大的 .log 文件？
排查	分析一下 D 盘使用情况

小紫 AI 会根据描述选 action 并传 path、min_size 等参数。

常见错误

现象	处理
路径不存在	检查 path
缺 path	large_files/tree 必须传目录
扫描慢	缩小目录或降低 depth
权限不足	换有权限的路径，系统目录会自动跳过
python folder missing	复制 python 到插件目录

能力边界

支持	不支持
Windows / macOS / Linux 磁盘空间查询	自动删除文件（任何系统）
大文件 Top N	Windows 磁盘清理 / Linux apt clean 等系统级清理
目录占用排行	全盘无限深度扫描
扩展名过滤	重复文件检测、可视化图表

与其他插件配合

系统基础插件：定位大文件后 exec_cmd 删除或移动
压缩解压插件：归档旧日志后释放空间
日志分析插件：确认日志可删后再清理

推荐顺序：usage → tree 定位目录 → large_files 找具体文件 → 手动清理

详见包内 磁盘清理插件.md。

小紫 磁盘清理插件

简介