fix: Windows 兼容性改进 (storage-analyzer skill)
Author: Yxuan18Created Jun 2, 2026Updated Jun 2, 2026
问题描述
storage-analyzer skill 在 Windows 上运行时有以下问题:
- SKILL.md 中命令使用
/tmp/路径,Windows 不支持 - SKILL.md 中使用
python3,Windows 默认使用py -3 - server.py 白名单检查硬编码了
/Applications(macOS 专用) - build_report.py 默认路径
~/Desktop在 Windows 上可能不工作 - scan.py 无深度限制,极深目录可能导致扫描卡死
改动内容
1. SKILL.md
- 添加了 Windows/macOS 命令前缀提示
- 所有命令示例区分两系统(
%TEMP%vs/tmp/) - 描述中"废纸篓"改为"回收站"(Windows 术语)
- 更新了平台状态为"Windows 已实测"
- 长期优化建议增加了 Windows 工具 (TreeSize, WinDirStat, cleanmgr)
2. server.py
- 修复了 Windows 白名单检查,移除 macOS 专用的
/Applications - Windows 只允许用户目录内操作
- 更新了提示信息为跨平台友好
3. scan.py
- 添加了 Windows 目录深度限制 MAX_DEPTH_WINDOWS=6
- 防止扫描极深目录(如 node_modules)导致卡死
- 扩充了 Windows 开发缓存路径列表
4. build_report.py
- 添加了
get_desktop_path()函数跨平台获取桌面路径 - 默认输出路径根据系统自动适配
- 打开命令根据系统适配(
startvsopen)
5. references/windows.md
- 添加了 Windows 常见可清理项表格
- 包含 pip、Yarn、uv、Gradle、Chrome 缓存等清理命令
测试结果
在 Windows 10 上测试通过:
- 扫描功能:正常
- 报告生成:正常
- 服务模式:正常(端口动态分配)
- 回收站删除:代码已就绪(待实际测试)
Source: KKKKhazix/khazix-skills