File Cleaner

システムファイルクリーナーは、ユーザーが大きなファイルや不要なファイルをスキャン、識別、およびクリーンアップするのに役立ちます。

核心功能

1. 大文件扫描

指定されたディレクトリをスキャンし、容量を占有している大きなファイル（デフォルトでは >10MB）を見つけます。

python3 scripts/find_large_files.py <directory> [options]

オプション：

• --min-size <MB> - 最小ファイルサイズ（デフォルト: 10）
• --max-results <N> - 最大結果数（デフォルト: 100）
• --show <N> - 表示するファイル数（デフォルト: 20）
• --export <path> - 結果を JSON にエクスポート

例：

# home ディレクトリの大きなファイルをスキャン
python3 scripts/find_large_files.py ~

# 50MB より大きいファイルをスキャン
python3 scripts/find_large_files.py ~ --min-size 50

# 結果をエクスポート
python3 scripts/find_large_files.py ~ --export large_files.json

2. 垃圾文件扫描

さまざまな種類の不要なファイル（一時ファイル、キャッシュ、ログ、バックアップなど）をスキャンして識別します。

python3 scripts/find_garbage.py <directory> [options]

垃圾文件类别：

• temp_files - 一時ファイル（.tmp, .temp, .bak, .swp, .DS_Store）
• cache_files - キャッシュファイル（pycache, *.pyc, .cache）
• log_files - ログファイル（*.log）
• backup_files - バックアップファイル（.backup, .old）
• build_artifacts - ビルド成果物（dist, build, .next, out）
• editor_temp - エディター一時ファイル（.swo, .swn）
• download_temp - ダウンロード一時ファイル（.crdownload, .part）

オプション：

• --categories <cat1> <cat2> - スキャンするカテゴリを指定（デフォルト: 全部）
• --show <N> - 各カテゴリで表示するファイル数（デフォルト: 10）
• --export <path> - 結果を JSON にエクスポート
• --script <path> - クリーンアップスクリプトを生成

例：

# すべての不要なファイルをスキャン
python3 scripts/find_garbage.py ~

# キャッシュファイルと一時ファイルのみをスキャン
python3 scripts/find_garbage.py ~ --categories cache_files temp_files

# 結果をエクスポート
python3 scripts/find_garbage.py ~ --export garbage_scan.json

# クリーンアップスクリプトを生成
python3 scripts/find_garbage.py ~ --script cleanup.sh

3. 交互式清理

スキャン結果に基づいて、ユーザーがクリーンアップするファイルを選択できるインタラクティブなインターフェースを提供します。

python3 scripts/clean_interactive.py <scan_result.json> [options]

オプション：

• --type <garbage|large> - スキャン結果のタイプ（デフォルト: garbage）
• --dry-run - プレビューモード、ファイルを実際に削除しません

例：

# 不要なファイルをクリーンアップ
python3 scripts/clean_interactive.py garbage_scan.json

# 大きなファイルをクリーンアップ
python3 scripts/clean_interactive.py large_files.json --type large

# プレビューモード（テスト）
python3 scripts/clean_interactive.py garbage_scan.json --dry-run

工作流程

标准流程：扫描 → 导出 → 清理

# ステップ 1: 不要なファイルをスキャン
python3 scripts/find_garbage.py ~ --export /tmp/garbage_scan.json

# ステップ 2: インタラクティブにクリーンアップ
python3 scripts/clean_interactive.py /tmp/garbage_scan.json

快速流程：直接清理（推荐）

不要なファイルについては、クリーンアップスクリプトを直接生成できます。

# クリーンアップスクリプトを生成
python3 scripts/find_garbage.py ~ --script cleanup.sh

# スクリプトを確認（削除するファイルを確認）
cat cleanup.sh

# クリーンアップを実行
bash cleanup.sh

大文件流程：分析 → 选择性清理

大きなファイルについては、インタラクティブなクリーンアップを使用することをお勧めします。

# 大きなファイルをスキャン
python3 scripts/find_large_files.py ~ --export /tmp/large_files.json

# インタラクティブに削除を選択
python3 scripts/clean_interactive.py /tmp/large_files.json --type large

安全特性

自动排除

以下のディレクトリとファイルは自動的に除外され、誤削除を防ぎます。

• システムディレクトリ：/proc, /sys, /dev, /usr, /bin など
• バージョン管理：.git, .svn, .hg
• Python 環境：venv, .venv, env

垃圾文件分类

不要なファイルは 2 つのカテゴリに分類されます。

🟢 安全删除（自动标记）：

• 一時ファイル
• キャッシュファイル
• バックアップファイル
• ビルド成果物
• エディター一時ファイル

🟡 需要确认（需手动检查）：

• ログファイル（デバッグに使用される可能性があります）
• ダウンロード一時ファイル（完了していない可能性があります）

预演模式

--dry-run を使用してクリーンアップ操作をテストし、実際には削除しません。

python3 scripts/clean_interactive.py scan.json --dry-run

使用建议

定期清理

月に一度、ファイルクリーンアップを実行することをお勧めします。

# 毎月のクリーンアップスクリプト
python3 scripts/find_garbage.py ~ --export /tmp/monthly_scan.json
python3 scripts/clean_interactive.py /tmp/monthly_scan.json

磁盘空间不足

ディスク容量が不足している場合：

# 1. 最大のファイルを見つける
python3 scripts/find_large_files.py ~ --min-size 100 --show 20

# 2. 不要なファイルをクリーンアップ
python3 scripts/find_garbage.py ~ --script cleanup.sh
bash cleanup.sh

项目清理

開発プロジェクトディレクトリをクリーンアップします。

# ビルド成果物とキャッシュをクリーンアップ
python3 scripts/find_garbage.py ~/projects \
  --categories build_artifacts cache_files \
  --script project_cleanup.sh

注意事项

⚠️ 使用前必读：

1. 先预览再删除

   • --dry-run を使用してテスト
   • スキャン結果を確認してから確認

2. 重要文件备份

   • 削除する前に重要なデータをバックアップ
   • ログファイルには重要な情報が含まれている可能性があります

3. 权限问题

   • 一部のファイルには sudo 権限が必要な場合があります
   • 権限のないファイルは自動的にスキップされます

4. 不可恢复

   • 削除操作は取り消せません
   • 直接削除するのではなく、trash コマンドを使用することをお勧めします

脚本说明

find_large_files.py

大きなファイルをスキャンし、ファイルリストと合計サイズを出力します。システムディレクトリとバージョン管理ディレクトリを自動的に除外します。

find_garbage.py

7 種類の不要なファイルタイプを識別し、カテゴリ別に統計し、安全な削除ステータスをマークします。自動クリーンアップスクリプトを生成できます。

clean_interactive.py

インタラクティブなクリーンアップインターフェース。カテゴリ別の選択、バッチ操作、プレビューモードをサポートします。ファイルの詳細と合計サイズを表示します。

示例场景

场景 1：磁盘空间告急

# 大きなファイルをすばやく見つける
python3 scripts/find_large_files.py ~ --min-size 500 --show 10

场景 2：开发环境清理

# すべてのビルド成果物をクリーンアップ
python3 scripts/find_garbage.py ~/projects \
  --categories build_artifacts cache_files \
  --export dev_cleanup.json

python3 scripts/clean_interactive.py dev_cleanup.json

场景 3：定期维护

# 完整扫描
python3 scripts/find_garbage.py ~ --export monthly_scan.json
python3 scripts/find_large_files.py ~ --export large_files.json

# 分别处理
python3 scripts/clean_interactive.py monthly_scan.json
python3 scripts/clean_interactive.py large_files.json --type large

故障排除

权限错误

# sudo を使用（慎重に）
sudo python3 scripts/find_large_files.py /

扫描太慢

# スキャン深度を制限（指定されたディレクトリのみをスキャン）
python3 scripts/find_large_files.py ~/Downloads --max-results 50

JSON 导出失败

# ディレクトリが存在することを確認
mkdir -p /tmp
python3 scripts/find_garbage.py ~ --export /tmp/scan.json