关掉国产安卓手机系统里的广告、热搜、资讯推荐和营销推送。不 root，可还原，支持 AI 智能体一键执行。

Android 広告クリーナー — このプロジェクトの機能

中国製Androidスマートフォン（OPPO、Xiaomi、Honor、vivo、OnePlusなど）に組み込まれた広告、トレンド検索、ニュースフィード、マーケティング通知をオフにするツールです。

基本アプローチ

root不要、ブートローダーアンロック不要、フラッシュ不要 — システムアップデートは通常通り機能します。
システムとアプリが自身の設定で既に公開しているスイッチのみを切り替えます。
広告パッケージの一時停止（com.opos.ads や com.miui.systemAdSolution など）には明示的な確認が必要で、1つのコマンドで元に戻せます。
便利な機能は維持：検索、ホーム画面カード、アプリストアのインストール/更新、天気アラート、配達リマインダー。

対象となるもの

カテゴリ	例	処理方法
システム広告	パーソナライズ広告、広告追跡（OAID）、スマートレコメンドサービス	システム設定のスイッチ
ホット検索とニュース	検索ページのトレンドリスト、ネガティブスクリーンニュース、ブラウザフィード	各アプリの設定のスイッチ；ブラウザはシンプルなホームページに切り替え
プロモーション枠	ストアのカルーセル、スプラッシュ画面、フローティングアクティビティ、チェックイン報酬	ストアの「サービス管理」のスイッチ
マーケティング通知	「コンテンツとマーケティング」、「プロモーション」通知	チャネルごとにオフ — 同じアプリの注文、配達、更新通知はオンのまま
広告コンポーネント	`com.opos.ads`、`com.miui.systemAdSolution`	`pm suspend` で一時停止（同意が必要）
クイックアプリ	広告をタップすると起動するミニアプリ	`quickapp off` で検出して無効化

拒否する操作

システムアプリのアンインストールや無効化は行いません（pm uninstall や pm disable-user は使用しません）。
システムパーティションの変更やモジュールのインストールは行いません。
ユーザーに代わってアプリの利用規約を受け入れません — 同意ページが表示された場合は、キャンセルまたは延期します。
アカウントページや電話番号ページのスクリーンショットは撮りません。

4つの使用方法

AIエージェントが実行 — コンピューター、USBケーブル、コマンドを実行できるAIツールが必要です。
チャットAIがガイド — スマホのみ；DeepSeek、Doubao、ChatGPTで動作します。
手動チェックリスト — スマホのみ；ブランドごとのステップバイステップリストに従います。
デスクトップクライアント — Mac（AppleまたはIntelチップ）またはWindows 10/11；スマホを接続してボタンをクリックします。PythonやAIツールは不要です。

デスクトップクライアント（v0.2.3）

Mac（Apple SiliconとIntelの両方）用の署名・公証済みDMG、Windows用のインストーラーまたはポータブルZIPとして提供。
ワークフロー：スマホを接続 → 検出（モデル、OSバージョン、スクリプト、クイックアプリ、広告コンポーネント） → オフにするものを選択（チャネルごとのマーケティング通知；サービス通知はデフォルトでオフ） → 進行状況バーとライブログで実行 → 結果を確認し、開発者モードを無効にするようリマインダー。
フィードバックボタンは診断情報（クライアントバージョン、スマホモデル、OSバージョン、最近のログ — シリアル番号は置換済み、アプリリストや通知内容は含まれません）を自動添付し、GitHub issueを開きます。
既知の制限：adbで接続されたAndroidデバイスのみサポート；HarmonyOS NEXT（HDC）はサポートしません。

テスト済みデバイス

プロジェクトはデバイススクリプトを維持しています — 特定のスマホモデル向けの自動化ステップバイステップ手順で、開くアプリ、タップするメニュー項目、切り替えるスイッチ、そのままにするスイッチを記録します。設定ページはモデルやOSバージョンによって異なるため、これらが必要です。

これまでにテスト済み：Honor PNM-AN10（MagicOS 10）、OnePlus Ace 2 Pro（ColorOS 14）、OPPO Find N6 / Find X10 Pro Max / Find X9 Ultra / Find N3（ColorOS 16/17）、Xiaomi 18 Pro Max（HyperOS 4.0）、vivo X300 Ultra（OriginOS 6）。完全に検証されたものもあれば、部分的に検証されたものもあります — READMEに各ステータスが記載されています。

スマホがリストにない場合は、ガイドに従ってスクリプトを作成し、プルリクエストを送信できます。

コマンドラインの流れ

ターミナルに慣れているユーザー向けの完全なパイプラインは次のとおりです：

pip3 install -r requirements.txt
python3 tool/run.py devices                 # 接続されたスマホを一覧表示、スクリプトを確認
python3 tool/run.py -s <serial> check        # 読み取り専用チェック
python3 tool/run.py -s <serial> backup       # 変更前のスナップショット
python3 tool/run.py -s <serial> recipe       # デバイススクリプトを実行
python3 tool/run.py -s <serial> chan-scan    # マーケティング通知チャネルを一覧表示
python3 tool/run.py -s <serial> chan-off backups/<model>-<time>/channels.tsv
python3 tool/run.py -s <serial> quickapp     # クイックアプリを検出；`quickapp off` で無効化
python3 tool/run.py -s <serial> finish       # 終了処理、開発者モード無効化をリマインド
python3 tool/run.py -s <serial> dev-off --yes  # PCから開発者モードを無効化（最後のステップ）

安全性と復元

変更前にバックアップスナップショットが作成されます。
一時停止したパッケージと通知チャネルは、それぞれ1つのコマンドで復元できます。
アプリ内のスイッチは、チェックリストのパスに従って手動で復元します。
ツールは見つからないステップをスキップし、盲目的にクリックしません。
スクリーンリーダーサービスが競合する場合（例：GKDや自動会計アプリ）、ツールはそれを検出し、1回再試行し、それでもブロックされる場合は復元手順を提供してスキップします。

ライセンス

MIT。プロジェクトは、Androidおよびベンダーアプリが公開している設定のみを使用すると述べています。ユーザーは使用前にバックアップし、結果に対する責任を受け入れる必要があります。

プロジェクト構造（主要部分）

tool/run.py — メインエントリーポイント
tool/fast.py — 画面の読み取り、メニュー項目の検索、スイッチの切り替えを行うエンジン（uiautomator2を使用）
recipes/<brand>-<model>/recipe.py — デバイスごとの自動化スクリプト
gui/ — デスクトップクライアント（pywebview + PyInstaller）
docs/ — チュートリアル、トラブルシューティング、復元ガイド、クイックアプリの説明
prompts/ — チャットAI用の既製プロンプト
AGENTS.md — AIエージェントの運用ルール

rddmwmddr/android-ad-cleaner