Creator Cleaner

Creator Cleaner は、クリエイターの制作データと制作環境を守るための「制作環境保護システム」です。

このプロジェクトは、不要ファイルをすぐ削除するためのクリーナーではありません。現在は、Photoshop一時ファイル候補やAdobe/Photoshop関連の容量変化候補を検出し、人間が安全に確認するための検出専用MVPです。

現在のバージョンは Creator Cleaner Ver.0.1.4 です。

OpenAI Build Week提出用MVP

OpenAI Build Week向けには、Creator Cleanerを「削除ツール」ではなく、クリエイター向けの安全第一ファイルDoctor MVPとして提示します。

Build Week提出用の追加表示として、通常スキャン結果画面と保存Reportに Build Week Safety Summary を表示します。

このSummaryでは、次を短く確認できます。

• Safety Status: Detection Only
• 検出候補件数
• Safe Cleanup候補件数
• 要確認候補件数
• 削除件数: 0
• 移動件数: 0
• ゴミ箱移動件数: 0
• Sent to Trash: 0
• 自動処理件数: 0

Build Week期間中の最小改善は、既存の検出専用MVPを壊さず、提出・デモ時に安全状態が一目で分かる表示を追加したことです。検出ロジックの大幅変更、削除機能、ゴミ箱移動、バックアップ機能、React化、package化は行っていません。

提出用のデモ手順、スクリーンショット候補、既知の制限、Codex / GPT-5.6使用記録欄、/feedback Session ID記入欄は BUILD_WEEK_DEMO.md にまとめています。

Build Week Screenshot

実Macで取得した Build Week Safety Summary / 提出用安全診断サマリー のスクリーンショットは、公開時に次のパスへ配置します。

docs/images/creator-cleaner-safety-summary.png

この画像では、次の内容を示します。

• Build Week Safety Summary
• Safety Status: Detection Only
• Delete / Move / Trash / Auto Process がすべて0
• 実ファイル操作なし
• 実Mac例として、検出候補80件、合計3.5GBを検出

画像ファイル配置後、次のコメントを有効化してください。

![Creator Cleaner Build Week Safety Summary](docs/images/creator-cleaner-safety-summary.png)

最重要方針

このツールは現在、削除しません。

• ファイル削除はしません
• 自動削除はしません
• 一括削除はしません
• ゴミ箱移動はしません
• 候補ファイルの移動や編集はしません
• Photoshop起動中の実ファイル操作は行いません

Finderで開く導線は、ログやレポートの保存先フォルダを開くためのものです。候補ファイルを操作する機能ではありません。

現在実装されている機能

• Photoshop一時ファイル候補の検出
• Camera Raw Cache候補の検出
• 作業前後の容量差分観測
• 新規作成・容量増加・更新日時の観測
• Adobe / Photoshop関連パスの判定
• 安全度A / B / C / 除外の表示
• 候補一覧
• 候補詳細
• 判定理由
• 人間への判断コメント
• 容量変化上位候補
• 場所別容量まとめ
• ログ保存
• Doctor Report相当のレポート保存
• Finderで保存先を開く導線
• Build Week Safety Summaryの表示とReport保存

現在実装されていない機能

• 削除
• 自動削除
• 一括削除
• ゴミ箱移動
• 復元
• 削除前確認UI
• 完成版Doctor機能
• DaVinci Resolveの正式対応
• Adobeアプリ全般の正式対応
• React化
• package化

未実装機能は、画面や文書で利用可能であるように扱いません。

安全方針

• A判定でも現在は削除しない
• B / C / 除外は削除対象にしない
• 設定、プラグイン、UXP、PluginsStorage、Internalを保護する
• 制作データ拡張子を保護する
• 用途不明は安全側へ倒す
• 観測候補と削除安全性を混同しない
• 容量が大きいだけでは削除推奨にしない
• 更新日時が古いだけでは安全と断定しない
• Photoshop起動中の実ファイル操作を行わない
• 将来削除機能を追加する場合も、確認、ログ、ゴミ箱、復元手順、実ソフト起動確認を必須とする

保護対象の例:

.psd .psb .jpg .jpeg .png .gif .tif .tiff .webp .heic
.mov .mp4 .m4v .avi
.wav .mp3 .aiff .flac
.raw .cr2 .cr3 .nef .arw .dng

基本的な使用方法

現行の配布用フォルダから起動する場合:

cd ~/Desktop/CreatorCleaner_Ver011_Desktop
python3 CreatorCleaner_GUI_Ver011.py

このリポジトリの outputs 配下から起動する場合:

cd outputs
python3 CreatorCleaner_GUI_Ver011.py

必要環境:

• Mac
• Python 3
• ターミナル

このMVPはPython / TkinterのローカルMacアプリです。package.json、src/、tests/ を前提にしたWebアプリ構成ではありません。

テスト方法

提出前の基本確認は、プロジェクトルートから次を実行します。

python3 -m py_compile outputs/CreatorCleaner_GUI_Ver011.py outputs/PhotoshopTempCleaner_Ver1_DetectOnly.py
python3 outputs/PhotoshopTempCleaner_Ver1_DetectOnly.py

確認する内容:

• Safety Status: Detection Only
• Build Week Safety Summary
• 削除件数: 0件
• 移動件数: 0件
• ゴミ箱移動件数: 0件
• Sent to Trash: 0
• 自動処理件数: 0件
• Reportが保存されること
• 実ファイル操作が行われないこと

GUI目視確認はMac実機で行います。

対応環境

• macOS
• Python 3
• Tkinterが利用できるローカル環境
• Photoshop / Adobe関連候補の検出は、ユーザー環境の権限、保存場所、Photoshop起動状態により結果が変わります。

現在の制限

• 現在はDetection Onlyです。
• 削除、移動、ゴミ箱移動、自動処理は実装していません。
• Codex環境ではmacOSのプロセス確認やGUI表示が制限される場合があります。
• スクリーンショットや最終GUI目視は、実Mac側で確認してください。

今後の展開

• 手動選択のみの安全なゴミ箱移動
• 実行前確認
• 移動前ログ
• 復元案内
• Photoshop実機起動確認
• Doctor Reportの完成

これらは今後の候補であり、現在のBuild Week提出版では実装していません。

デモ動画URL

未確定です。提出前に以下へ記入してください。

• YouTube URL: TBD

主な操作

通常スキャン

実際のMac内にあるPhotoshop一時ファイル候補、Camera Raw Cache候補、Adobe/Photoshop関連候補を探します。

通常スキャンでも削除は行いません。

ダミー表示テスト

表示確認用の仮データで、安全度A/B/C/除外の見え方を確認します。

実ファイルは作成しません。削除もしません。

観測開始

Photoshop作業前の状態を記録します。

記録対象の例:

• 観測開始日時
• 対象パス
• パスごとの容量
• パスごとの更新日時
• Photoshop起動状態
• ディスク空き容量

観測開始は記録だけを行います。

観測結果を見る

観測開始後に新規作成、容量増加、更新された候補を表示します。

候補が0件でも異常ではありません。

再起動後チェック

観測開始時と現在状態を比較します。

この操作はMacを再起動しません。再起動後にユーザーが手動でアプリを開き、差分を見るための機能です。

レポート・ログ確認

結果画面から、ログ保存先とレポート保存先を確認できます。

Finderで開く場合も、保存先フォルダを開くだけです。候補ファイルの削除、移動、編集は行いません。

安全度の意味

A

削除してよい可能性が高い候補です。

ただし、Ver.0.1.4 ではA判定でも削除しません。

B

確認が必要な候補です。

Adobe/Photoshop関連キャッシュ、Camera Raw Cache、容量変化候補などが含まれます。Photoshopだけが原因とは断定できないため、削除対象にしません。

C

削除非推奨の候補です。

設定ファイル、プラグイン、内部保存領域、用途不明のApplication Support配下、制作データ付随の可能性がある候補などが含まれます。

除外

制作データや保護対象です。

候補一覧に表示される場合でも、削除対象候補として扱いません。

現行の主要ファイル

• outputs/CreatorCleaner_GUI_Ver011.py: GUI起動用
• outputs/PhotoshopTempCleaner_Ver1_DetectOnly.py: 検出ロジック本体
• outputs/README_PhotoshopTempCleaner_Ver1.md: Ver.1系の詳細README相当文書
• outputs/CREATOR_CLEANER_VER01_STABLE_RECORD.md: Ver.0.1系の安定記録
• outputs/CREATOR_CLEANER_ROADMAP.md: 既存ロードマップ
• outputs/CreatorCleaner_Ver011_Desktop/: デスクトップ実行用の配布フォルダ
• outputs/CreatorCleaner_Ver011_Desktop.zip: デスクトップ実行用ZIP

開発者向け文書

• AGENTS.md: Codex用プロジェクト憲法
• DESIGN.md: UI/UX判断基準
• TEST_PLAN.md: テスト方針・完了条件
• IMPLEMENTATION_PLAN.md: 実装前計画
• DECISIONS.md: 判断理由
• PROJECT_HISTORY.md: 変更履歴

既存README相当文書との関係

outputs/README_PhotoshopTempCleaner_Ver1.md は、過去および現行Ver.1系の詳細資料として保持します。

今後の正式な入口は、このルート README.md です。

詳細な操作説明やVer.0.1.4時点の細かい画面説明が必要な場合は、outputs/README_PhotoshopTempCleaner_Ver1.md を参照してください。

変更履歴

今後の正式な履歴追記先は PROJECT_HISTORY.md です。

Ver.0.1系の安定記録は、outputs/CREATOR_CLEANER_VER01_STABLE_RECORD.md として保持します。