fix: Windows 兼容性改进 (storage-analyzer skill)

Author: Yxuan18Created Jun 2, 2026Updated Jun 2, 2026

问题描述

storage-analyzer skill 在 Windows 上运行时有以下问题:

  1. SKILL.md 中命令使用 /tmp/ 路径,Windows 不支持
  2. SKILL.md 中使用 python3,Windows 默认使用 py -3
  3. server.py 白名单检查硬编码了 /Applications(macOS 专用)
  4. build_report.py 默认路径 ~/Desktop 在 Windows 上可能不工作
  5. 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() 函数跨平台获取桌面路径
  • 默认输出路径根据系统自动适配
  • 打开命令根据系统适配(start vs open

5. references/windows.md

  • 添加了 Windows 常见可清理项表格
  • 包含 pip、Yarn、uv、Gradle、Chrome 缓存等清理命令

测试结果

在 Windows 10 上测试通过:

  • 扫描功能:正常
  • 报告生成:正常
  • 服务模式:正常(端口动态分配)
  • 回收站删除:代码已就绪(待实际测试)

SKILL.md windows.md build_report.py scan.py server.py