xiaohj233/ghostlock-x200-rootGhostLock-X200 v1.0 - vivo X200（PD2415 / b57カーネル）向け一時ルートツールチェーン。CVE-2026-43499に基づく。許可されたセキュリティ研究のみを対象としています。
⚠️ 法的・安全に関する声明（必ず最初にお読みください）
本リポジトリはセキュリティ研究および教育目的のみに使用され、ご自身が所有する、または明確な 書面による許可を得たデバイス上でのみ使用が許可されています。許可なく他人のデバイスに本ツールを使用することは、現地の法令に違反する可能性があります。 本ツールの使用により、デバイスの異常再起動、データ破損、システム異常、保証の無効化などの結果が生じる可能性があります。リスクはご自身で 評価してください。作者は直接的または間接的な損害について一切の責任を負わず、いかなる濫用行為についても責任を負いません。 本リポジトリを読み続ける、または使用することにより、あなたはすべてのリスクと責任を自ら負うことを理解し同意したものとみなされます。
vivo X200（PD2415 / Dimensity 9400 / b57 カーネル） 向け、 CVE-2026-43499（GhostLock）カーネル脆弱性に基づいて実装された一時 root ツールチェーン：Bootloader の アンロック不要、ファームウェアの書き換え不要、データは消去されません。実行後に一時的な root を取得でき、再起動すると無効になります。
機能特性 • 対応デバイス • 他のプロジェクトとの違い • クイックスタート • 動作原理 • ディレクトリ構造 • ライセンス
root.ps1：デバイスとカーネルを自動検出、不足依存関係を自動インストール、オフセットを自動生成log\ に保存、panic/watchdog 時に自動で
pstore などの診断情報を収集してパッケージ化（AI 可読）、案内に従って送信すれば分析可能devices/<機種名>/
に集約された共有可能なモジュール、未収録機種はオフセットを自動抽出してモジュールを生成可能；ただしX200 b57 以外の
機種で root 可能かどうかは自身で実機検証・適応が必要（ko はターゲットカーネルに合わせて vermagic/modversions を再ビルドする必要あり）、
ツールは自動抽出と実現可能性の事前チェックのみ提供（init_boot の誤選択、MTK 未知ファミリなどの場合は非推奨の警告）未入力、の四段階自動補完チェーン
permissive_restore カーネルモジュールを同梱、このデバイスの enforcing
モードにおける KernelSU のネットワーク/テザリング異常を修正（後述の「同源プロジェクトとの差異」参照）| デバイス | システム / カーネル | 状態 |
|---|---|---|
| vivo X200 (PD2415) | 16.1.12.2.W10（実機検証済み） | ✅ 使用可能 |
| vivo X200s | 16.1.12.12.W10（b57 同一カーネル：カーネル SHA256 が X200 と完全一致、オフセットのクロス検証が第三者検証済みの target.h と一致；実機未検証） | ⚠️ 試用可能（同一カーネルで x200_b57 モジュールに正確に一致、ご自身での検証が必要） |
| vivo X200 (PD2415) | 16.1.12.12.W10（同一カーネルビルド b57） | ⚠️ 未検証 |
| vivo X200 (PD2415) | その他の 16.1.x、カーネル b57af212129c | ⚠️ 未検証、試用可能 |
| vivo X200 (PD2415) | カーネル >= 6.6.140 | ❌ 修正済み、使用不可 |
| iQOO Neo11 など（同一 6.6.89 MTK カーネル） | 同一カーネル | ⚠️ 未検証、ご自身での二次開発が必要 |
前提：カーネル < 6.6.140（CVE-2026-43499 未修正）かつビルドが
6.6.89-android15-8-gb57af212129c。未実測の機種/ビルドは自身で検証が必要。詳細な説明は
使用説明を参照。
適合範囲：本プロジェクトは表中で ✅ が付いた vivo X200（PD2415 / 16.1.12.2.W10 / b57 カーネル）のみ完全な実機適合を実施済み。その他のすべての機種（同一カーネルの X200s を含む）は 未実測 / 自身での適合が必要：オフセットは自動再構築可能、ko vermagic は自動再付与可能だが、 root できるかは保証されず、対象機種/カーネルに応じて自身で二次開発が必要（modversions ABI は同一ビルドのカーネル ソースで ko を再コンパイルする必要がある）。
その他の機種：公式サポートリストにない機種は強行試行が可能で、ツールは実行を阻止しない。オフセットは 素材から自動再構築され、実行中の異常再起動時には診断ログが自動でパッケージされる。最終的に root できるかは対象 機種/カーネルの二次開発適合（モジュール vermagic は対象カーネルに合わせて再コンパイルが必要）に依存し、自身での適合が必要で、 そのまま使用できることは保証されない。
MTK 機種の実現可能性に関する注意：実測済みの b57 系を除き、MTK（Dimensity/helio）の未知の カーネル系は取り組みを推奨しない——コミュニティの公開記録（vivo PD2241/Dimensity 9200）では KernelSnitch のタイミングが MTK 上では信頼できないことが示されている（KASAN_HW_TAGS/MTE の干渉、PANIC_ON_OOPS により試行錯誤の余地なし、 vivo RSC スケジューラが pselect/pi チェーンを破壊）。本ツールで素材を選択する際には自動で事前チェックと警告が行われる。
permissive_restore モジュールを補完して
enforcing 下での KernelSU のネットワーク/テザリング異常を修正し、ワンクリックスクリプト、動的オフセット再構築、
異常再起動時の自動診断を提供する。本リポジトリは PC 版ツールチェーンである；スマートフォン側で直接ワンクリック root を行いたい場合（[Shizuku]
(https://github.com/RikkaApps/Shizuku) による認可で、PC の adb 不要）は、付属の
ghostlock-x200-app を使用すること。両者は
同一の権限昇格チェーンと機種モジュールを共有する（PC 版 devices/<id> → App 版 payload/<id>）。
Release アセット ghostlock-x200-root-v1.3.4.zip をダウンロードして解凍する（zip には
prebuilt/ バイナリと modules/*.ko が含まれており、どちらも欠かせない）；
唯一のエントリ：run_root.bat をダブルクリック（実行終了後もウィンドウは留まり、エラー時も一瞬で消えない）；またはコマンドライン：
powershell -ExecutionPolicy Bypass -File root.ps1
実行ログと異常再起動診断パッケージは統一してパッケージ内の log\ フォルダに保存されます
（log\ghostlock_root_<タイムスタンプ>.log / log\ghostlock_diag_<タイムスタンプ>.zip、
コンソールに完全なパスが表示されます）。診断パッケージは案内に従ってメンテナー/Agent に送信し分析してもらってください。
複数機種への適応、オフラインでのオフセット生成、機種モジュールの共有、新機種のコンパイルなどの高度な使い方については、 使用説明 docs/USAGE.zh-CN.md を参照してください。
七段階のチェーン：permissive（SELinux）→ kptr → KASLR base → 動的オフセット → ko 再配置 → cred リーク + CAPSROOT → permissive_restore/kernelsu のロード → 25s 後に permissive を復元。 アーキテクチャとコンポーネントの説明については docs/ARCHITECTURE.zh-CN.md を参照してください。
├── root.ps1 # 一键脚本（自动装依赖/生成偏移）
├── run_root.bat # 唯一双击入口（结束后窗口停留，不自动关闭）
├── log/ # 运行日志 + 异常重启诊断包（自动生成）
├── docs/ # ARCHITECTURE（架构）/ FILE_MAP（逐文件映射）/ USAGE（使用说明）
├── exploit/ # 设备端利用（glt / w2host；含 IonStack 逐字与衍生源码）
├── modules/
│ ├── permissive_restore/ # 本仓库原创内核模块（GPL-2.0-only）
│ └── kernelsu/ # KernelSU 官方 v3.2.5 内核模块（GPL-2.0-only）
├── tools/ # scripts（主链脚本 + find_adb.ps1）+ offset_tools（动态偏移工具）
│ └── offset_tools/profiles/ # 机型 profile（x200_b57.json 默认；新机型复制改名）
├── devices/ # 可分享机型模块（x200_b57/ 随仓库示例；package 生成新模块）
├── refs/ # 上游参考表（版本固定）
├── LICENSES/ # SPDX 许可证文本（REUSE）
├── LICENSE / NOTICE / THIRD_PARTY_NOTICES.md / SOURCE-URLS.md
└── REUSE.toml
各ファイルの用途、出典（COPIED / DERIVED / LOCAL）およびライセンスについては docs/FILE_MAP.zh-CN.md を参照してください。
modules/permissive_restore/ は GPL-2.0-only；exploit/ には NebuSec/CyberMeowfia IonStack の逐語的および派生コード（Apache-2.0、
commit は固定済み）、ならびに boxiaolanya2008/Neo11Plus、YuKongA/ghostlock-app の
適応参考（Apache-2.0）が含まれる；modules/kernelsu/kernelsu.ko は公式 KernelSU v3.2.5 リリース資産
android15-6.6_kernelsu.ko（GPL-2.0-only）を vermagic 適応した成果物：
X200 b57 カーネルに一致させるため .modinfo の vermagic 文字列のみを書き換え、コードは一切変更していない
（再現スクリプト modules/kernelsu/patch_vermagic.py、SHA256 と出典は
THIRD_PARTY_NOTICES.md / SOURCE-URLS.md を参照）；prebuilt/ksud（Release 資産）は公式 APK 内の未改変の libksud.so
（GPL-3.0-or-later）。完全なリストについては NOTICE、THIRD_PARTY_NOTICES.md、 SOURCE-URLS.md を参照してください。