disk-cleaner

Disk Cleaner - Mac スマートディスククリーンアップアシスタント

Mole (https://github.com/tw93/Mole) をベースにしたユーザーフレンドリーなラッパーで、「インストール + 実行 + 説明 + チェック + 案内 + 統計 + 共有」を担当します。

Description

Disk Cleaner は、tw93 が開発した Mole クリーンアップツールの拡張ラッパーです。よりフレンドリーな中国語インターフェース、分類レポート、3 段階のクリーンアップ戦略（Air/Pro/Max）、CSV 完全リスト、ホワイトリスト設定、そしてクリーンアップ完了後の精美な実績ページ（節約額の計算と楽しい統計を含む）を提供します。

When to Use

以下のような場合にこのスキルを使用します:

• ハードディスクの空き容量が足りない、ディスクがいっぱい、ストレージ不足と言っている
• Mac のキャッシュや一時ファイルをクリーンアップしたい
• ディスク容量を解放する方法を尋ねている
• Mole ツールに言及している

Features

• 🔍 環境検出: Homebrew と Mole のインストール状態を自動検出
• 📦 自動インストール: 不足している依存関係のワンクリックインストールに対応
• 📊 分類レポート: クリーンアップ可能な項目をカテゴリ別に表示し、安全/注意を区別
• 🧭 3 段階戦略: Air（最も安全）/ Pro（推奨）/ Max（最大化）
• 📋 CSV リスト: 完全なファイルリストを生成し、デスクトップに保存
• ⚙️ ホワイトリスト設定: プリセットテンプレート + カスタムパスの保護
• 🎉 実績ページ: クリーンアップ後に節約額の計算、楽しい統計を表示し、共有可能
• 🔒 安全保護: 保護済み項目を表示し、確認メカニズムに対応

Usage

環境チェック

python scripts/mole_cleaner.py --check

クリーンアップ内容のプレビュー

python scripts/mole_cleaner.py --preview          # 终端文本报告
python scripts/mole_cleaner.py --preview --html   # HTML 报告（自动打开浏览器）
python scripts/mole_cleaner.py --preview --csv    # CSV 完整清单（保存到桌面）
python scripts/mole_cleaner.py --preview --json   # JSON 格式输出

クリーンアップの実行（3 段階の選択）

python scripts/mole_cleaner.py --clean --tier air --confirm   # Air: 最安全
python scripts/mole_cleaner.py --clean --tier pro --confirm   # Pro: 推荐
python scripts/mole_cleaner.py --clean --tier max --confirm   # Max: 最大化
python scripts/mole_cleaner.py --clean --confirm              # 默认全量清理

ホワイトリスト設定

python scripts/mole_cleaner.py --whitelist --show                    # 查看当前白名单
python scripts/mole_cleaner.py --whitelist --preset office           # 添加白领办公预设
python scripts/mole_cleaner.py --whitelist --preset developer        # 添加开发者预设
python scripts/mole_cleaner.py --whitelist --add ~/Documents/重要项目  # 添加自定义路径

ディスク状態の確認

python scripts/mole_cleaner.py --status

実績ページの表示（テスト）

python scripts/mole_cleaner.py --show-achievement

Workflow (Claude インタラクションフロー)

1. 環境検出とインストール

まず Mole がインストールされているか確認します:

python scripts/mole_cleaner.py --check

インストールされていない場合は、ユーザーにインストールを案内するか、--auto-install を使用します。

2. プレビュースキャン

プレビューを実行して分析レポートを取得します:

python scripts/mole_cleaner.py --preview

3. ユーザーに選択肢を提示

プレビュー結果に基づいて、ユーザーにクリーンアップ案を提示します:

请选择你想执行的方案：

1. 🌬️ Air - 最安全，只清浏览器和日志     → X.XX GB
2. ⚡ Pro - 推荐，平衡安全与空间          → X.XX GB
3. 🚀 Max - 最大化释放硬盘空间            → X.XX GB
4. 📋 先看完整清单 - 生成 CSV 详细列表
5. ⚙️ 配置白名单 - 保护特定路径

4. ユーザーの選択を処理

1〜3 を選択 (Air/Pro/Max):

# 确认后执行
python scripts/mole_cleaner.py --clean --tier air --confirm   # 或 pro/max

4 を選択 (CSV リスト):

python scripts/mole_cleaner.py --preview --csv

ファイルがデスクトップに保存され、自動的に開かれたことをユーザーに伝えます。

5 を選択 (ホワイトリスト設定): プリセットオプションを表示します:

• office: オフィスワーク - .doc, .docx, .xls, .xlsx, .ppt, .pptx, .pdf などを保護
• developer: 開発者 - コードと設定ファイルを保護
• media: メディア制作 - 動画、音声、画像プロジェクトを保護

python scripts/mole_cleaner.py --whitelist --preset office
# 或添加自定义路径
python scripts/mole_cleaner.py --whitelist --add ~/Documents/重要项目

5. クリーンアップ完了

クリーンアップ完了後に実績ページが自動生成され、以下を含みます:

• 解放された容量
• 節約額の計算（SSD 価格に基づく）
• 楽しい換算（写真何枚分/曲何曲分に相当するか）
• ランダムな tw93 の褒め言葉
• Star しやすい GitHub リンク

Safety Features

• プレビュー優先: デフォルトではプレビューのみで、クリーンアップを実行するには --confirm が必要
• 段階別戦略: Air/Pro/Max により、ユーザーがリスク許容度に応じて選択可能
• ホワイトリスト保護: プリセットテンプレートとカスタムパスに対応
• 保護リスト: Mole の whitelist 保護項目を表示
• ログ記録: すべての操作のログを ~/.config/mole-cleaner/logs/ に保存

Tier Definitions

段階	クリーンアップ範囲	リスクレベル
🌬️ Air	ブラウザキャッシュ、システムログ	低リスク
⚡ Pro	Air + ユーザーアプリのキャッシュ、パッケージマネージャーのキャッシュ、ゴミ箱	中リスク
🚀 Max	すべてのクリーンアップ可能な項目	やや高リスク

Whitelist Presets

プリセット	保護内容
office	オフィス文書 (.doc, .docx, .xls, .xlsx, .ppt, .pptx, .pdf, .pages, .numbers, .key)
developer	コードと設定 (.py, .js, .ts, .go, .rs, .java, .swift, .json, .yaml, .toml)
media	メディアプロジェクト (.psd, .ai, .sketch, .fig, .aep, .prproj, .fcpx, .mov, .mp4)

Dependencies

• macOS
• Homebrew
• Mole (brew install tw93/tap/mole)
• Python: pip install jinja2

Output Structure

~/.config/mole-cleaner/
├── logs/                    # 操作日志
├── reports/                 # HTML 报告
└── achievements/            # 成就页面

~/Desktop/
└── mole-clean-list-YYYYMMDD-HHMMSS.csv  # CSV 完整清单

Credits

• Mole: https://github.com/tw93/Mole
• 作者: tw93 (https://tw93.fun)